🏗️ Architecture Diagram:Architecture Diagram - 2026-03-20 (Incremental Update)

[github-actions]

Summary

This is an incremental update. Analysis of commit 6ab2e0ba (previous: 4204106c) found that no structural changes occurred — the same 18 packages exist under pkg/, and the dependency graph is unchanged.

Changed packages (Go files modified, but no architectural shift):
cmd/gh-aw, cmd/gh-aw-wasm, pkg/cli, pkg/workflow, pkg/parser, pkg/console, pkg/constants, pkg/types, pkg/fileutil, pkg/gitutil, pkg/stringutil, pkg/sliceutil, pkg/logger, pkg/styles, pkg/tty, pkg/envutil, pkg/timeutil, pkg/mathutil, pkg/repoutil, pkg/testutil

No new packages added. No packages removed. No new inter-package dependencies detected.

---

Architecture Diagram

┌─────────────────────────────────────────────────────────────────────────────────────────────┐
│                                       ENTRY POINTS                                           │
│  ┌──────────────────────────────────────┐    ┌──────────────────────────────────────────┐  │
│  │            cmd/gh-aw                 │    │           cmd/gh-aw-wasm                 │  │
│  │   Main CLI binary & all commands     │    │         WebAssembly target               │  │
│  └──────────────────┬───────────────────┘    └──────────────────────────┬───────────────┘  │
├─────────────────────┼──────────────────────────────────────────────────┼──────────────────┤
│                     ▼           CORE PACKAGES                          ▼                   │
│  ┌────────────────────────────┐            ┌───────────────────────────────────────────┐   │
│  │        pkg/cli             │            │            pkg/workflow                   │   │
│  │  Command implementations   ├───────────▶│  Workflow compilation engine &            │   │
│  │  and all CLI subcommands   │            │  orchestration                            │   │
│  └──────────────┬─────────────┘            └──────────────────┬────────────────────────┘   │
│                 │                                              │                             │
│                 └────────────────────┬─────────────────────────┘                            │
│                                      ▼                                                       │
│                          ┌──────────────────────────────┐                                   │
│                          │        pkg/parser            │                                   │
│                          │  Markdown frontmatter &      │                                   │
│                          │  YAML parsing                │                                   │
│                          └──────────────┬───────────────┘                                   │
│                                         │                                                    │
│                          ┌──────────────▼───────────────┐                                   │
│                          │        pkg/console           │                                   │
│                          │  Terminal UI & styled output │                                   │
│                          └──────────────────────────────┘                                   │
│                                                                                              │
│           ↕ all core packages also depend on constants, types, and utilities ↕              │
├──────────────────────────────────────────────────────────────────────────────────────────────┤
│                                   SHARED DEFINITIONS                                         │
│  ┌─────────────────────────────────────────┐  ┌──────────────────────────────────────────┐  │
│  │             pkg/constants               │  │              pkg/types                   │  │
│  │  Versions, flags, URLs, engine names    │  │  Shared type definitions across packages │  │
│  └─────────────────────────────────────────┘  └──────────────────────────────────────────┘  │
├──────────────────────────────────────────────────────────────────────────────────────────────┤
│                                       UTILITIES                                              │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐ ┌─────────┐   │
│  │fileutil │ │ gitutil │ │ logger  │ │stringutil│ │ sliceutil│ │repoutil │ │   tty   │   │
│  └─────────┘ └─────────┘ └─────────┘ └──────────┘ └──────────┘ └─────────┘ └─────────┘   │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐  ┌─────────┐                            │
│  │ envutil │ │timeutil │ │mathutil │ │testutil │  │ styles  │                             │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘  └─────────┘                            │
└──────────────────────────────────────────────────────────────────────────────────────────────┘

---

Change Log

Packages modified (implementation changes only, no new inter-package dependencies):

• pkg/cli — Various CLI command updates
• pkg/workflow — Workflow compilation engine updates
• pkg/parser — Parser updates
• All utility packages updated in the same commit

New packages: None
Removed packages: None
New dependencies: None
Structural shifts: None

---

Package Reference

Package	Layer	Description
pkg/cli	Core	CLI command implementations and subcommands
pkg/workflow	Core	Workflow compilation engine and orchestration
pkg/parser	Core	Markdown frontmatter and YAML parsing
pkg/console	Core	Terminal UI and styled output rendering
pkg/constants	Shared	Application-wide constants (versions, flags, URLs, engine names)
pkg/types	Shared	Shared type definitions across packages
pkg/fileutil	Utility	File path and operation utilities
pkg/gitutil	Utility	Git repository utilities
pkg/logger	Utility	Namespace-based debug logging with zero overhead
pkg/stringutil	Utility	String manipulation utilities
pkg/sliceutil	Utility	Slice manipulation utilities
pkg/repoutil	Utility	GitHub repository slug and URL utilities
pkg/tty	Utility	TTY detection utilities
pkg/envutil	Utility	Environment variable reading and validation
pkg/timeutil	Utility	Time utilities
pkg/mathutil	Utility	Basic mathematical utility functions
pkg/testutil	Utility	Testing helper utilities
pkg/styles	Utility	Centralized terminal style and color definitions

---

References: §23335768730

Note

🔒 Integrity filtering filtered 19 items

Integrity filtering activated and filtered the following items during workflow execution.
This happens when a tool call accesses a resource that does not meet the required integrity or secrecy level of the workflow.

• issue:#0 (search_issues: Resource 'issue:#0' has lower integrity than agent requires. Agent would need to drop integrity tags [unapproved:all approved:all] to trust this resource.)
• issue:🏗️ Architecture Diagram:gh-aw architecture diagram — incremental update 2026-03-19 #21760 (list_issues: Resource 'issue:🏗️ Architecture Diagram:gh-aw architecture diagram — incremental update 2026-03-19 #21760' has lower integrity than agent requires. Agent would need to drop integrity tags [unapproved:all approved:all] to trust this resource.)
• issue:Workflow Health Dashboard - 2026-03-20 #21926 (list_issues: Resource 'issue:Workflow Health Dashboard - 2026-03-20 #21926' has lower integrity than agent requires. Agent would need to drop integrity tags [unapproved:all approved:all] to trust this resource.)
• issue:Support for github-token in update-discussion safe output #21923 (list_issues: Resource 'issue:Support for github-token in update-discussion safe output #21923' has lower integrity than agent requires. Agent would need to drop integrity tags [unapproved:all approved:all] to trust this resource.)
• issue:[PR Triage Report] PR Triage Report - 2026-03-20 #21921 (list_issues: Resource 'issue:[PR Triage Report] PR Triage Report - 2026-03-20 #21921' has lower integrity than agent requires. Agent would need to drop integrity tags [unapproved:all approved:all] to trust this resource.)
• issue:Smoke Test: Copilot - 23330853729 #21918 (list_issues: Resource 'issue:Smoke Test: Copilot - 23330853729 #21918' has lower integrity than agent requires. Agent would need to drop integrity tags [unapproved:all approved:all] to trust this resource.)
• issue:[Contribution Check Report] Contribution Check — 2026-03-20 #21911 (list_issues: Resource 'issue:[Contribution Check Report] Contribution Check — 2026-03-20 #21911' has lower integrity than agent requires. Agent would need to drop integrity tags [unapproved:all approved:all] to trust this resource.)
• #16899 (search_issues: Resource 'issue:developer identity #16899' has lower integrity than agent requires. Agent would need to drop integrity tags [approved:all] to trust this resource.)
• issue:Workflow Health Dashboard - 2026-03-19 #21757 (list_issues: Resource 'issue:Workflow Health Dashboard - 2026-03-19 #21757' has lower integrity than agent requires. Agent would need to drop integrity tags [unapproved:all approved:all] to trust this resource.)
• issue:[aw] GitHub Remote MCP Authentication Test failed #21910 (list_issues: Resource 'issue:[aw] GitHub Remote MCP Authentication Test failed #21910' has lower integrity than agent requires. Agent would need to drop integrity tags [unapproved:all approved:all] to trust this resource.)
• issue:Duplicate Code: JSON MCP RenderMCPConfig scaffolding across engine modules #21900 (list_issues: Resource 'issue:Duplicate Code: JSON MCP RenderMCPConfig scaffolding across engine modules #21900' has lower integrity than agent requires. Agent would need to drop integrity tags [unapproved:all approved:all] to trust this resource.)
• issue:Smoke Test: Claude - 23326704978 #21897 (list_issues: Resource 'issue:Smoke Test: Claude - 23326704978 #21897' has lower integrity than agent requires. Agent would need to drop integrity tags [unapproved:all approved:all] to trust this resource.)
• issue:🔍 Multi-Device Docs Testing Report - 2026-03-20 #21896 (list_issues: Resource 'issue:🔍 Multi-Device Docs Testing Report - 2026-03-20 #21896' has lower integrity than agent requires. Agent would need to drop integrity tags [approved:all unapproved:all] to trust this resource.)
• issue:Smoke Test: Copilot - 23326705010 #21894 (list_issues: Resource 'issue:Smoke Test: Copilot - 23326705010 #21894' has lower integrity than agent requires. Agent would need to drop integrity tags [unapproved:all approved:all] to trust this resource.)
• issue:Support github-token in update-discussion safe output #21924 (issue_read: Resource 'issue:Support github-token in update-discussion safe output #21924' has lower integrity than agent requires. Agent would need to drop integrity tags [unapproved:all approved:all] to trust this resource.)
• issue:Duplicate Code: JSON MCP RenderMCPConfig scaffolding across engine modules #21900 (issue_read: Resource 'issue:Duplicate Code: JSON MCP RenderMCPConfig scaffolding across engine modules #21900' has lower integrity than agent requires. Agent would need to drop integrity tags [unapproved:all approved:all] to trust this resource.)
• ... and 3 more items

Generated by Architecture Diagram Generator · ◷

• expires on Mar 27, 2026, 9:07 AM UTC

[github-actions]

This issue is being closed as outdated. A newer issue has been created: #22112

View newer issue

---

This action was performed automatically by the Architecture Diagram Generator workflow.