🏗️ Architecture Diagram:Incremental Update: Architecture Diagram (2026-04-03) #24263
Closed as not planned
Description
Summary
This is an incremental update to the architecture diagram. Since the last run (f5a2c2a), Go files changed across all packages, and a new internal/tools/ directory was added with two build tools.
Changed packages: pkg/cli, pkg/workflow, pkg/parser, pkg/console, pkg/constants, pkg/types, and all utility packages received code changes. The structural addition is internal/tools/ (2 new entry points).
Architecture Diagram
┌────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ ENTRY POINTS │
│ ┌────────────────────────────┐ ┌────────────────────────┐ ┌────────────────────────────────┐ │
│ │ cmd/gh-aw │ │ cmd/gh-aw-wasm │ │ internal/tools/ (×2) │ │
│ │ GitHub CLI extension bin │ │ WebAssembly target │ │ actions-build, gen-metadata │ │
│ └────────────┬───────────────┘ └────────────┬───────────┘ └──────────────┬─────────────────┘ │
│ │ │ │ │
├───────────────┼─────────────────────────────────┼──────────────────────────────┼───────────────────┤
│ ▼ CORE PACKAGES ▼ ▼ │
│ ┌──────────────────┐ ┌──────────────────────┐ ┌────────────────────┐ ┌───────────────────┐ │
│ │ pkg/cli │──▶│ pkg/workflow │──▶│ pkg/parser │ │ pkg/console │ │
│ │ Command impls │ │ Workflow compilation │ │ MD/YAML parsing │◀──│ Terminal UI │ │
│ └──────────────────┘ └──────────────────────┘ └────────────────────┘ └───────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────────────────────────────┐ │
│ │ pkg/constants · pkg/types (shared primitives, no deps) │ │
│ └──────────────────────────────────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────────────────────────────────────────────────┤
│ UTILITIES │
│ ┌──────────┐ ┌──────────────┐ ┌────────────┐ ┌───────────┐ ┌──────────┐ ┌──────────┐ │
│ │pkg/logger│ │pkg/stringutil│ │pkg/fileutil│ │pkg/gitutil│ │pkg/styles│ │ pkg/tty │ │
│ └──────────┘ └──────────────┘ └────────────┘ └───────────┘ └──────────┘ └──────────┘ │
│ ┌───────────┐ ┌─────────────┐ ┌─────────────┐ ┌──────────────┐ ┌────────────┐ ┌────────────┐ │
│ │pkg/envutil│ │pkg/repoutil │ │pkg/sliceutil│ │pkg/semverutil│ │pkg/timeutil│ │pkg/mathutil│ │
│ └───────────┘ └─────────────┘ └─────────────┘ └──────────────┘ └────────────┘ └────────────┘ │
│ ┌──────────────┐ │
│ │ pkg/testutil │ (test support only) │
│ └──────────────┘ │
└─────────────────────────────────────────────────────────────────────────────────────────────────────┘
Change Log
Packages added since last run:
internal/tools/actions-build— build/validate custom GitHub Actions (importspkg/cli)internal/tools/generate-action-metadata— generateaction.ymlandREADME.mdfor JS modules (importspkg/cli)
New dependencies detected:
- Both internal tools depend on
pkg/cli, extending its role beyond the main CLI binary
Structural shifts:
- A new
internal/tools/tier appears as build-time entry points alongsidecmd/binaries. These tools reusepkg/clifunctions directly for their build pipelines.
Package Reference
| Package | Layer | Description |
|---|---|---|
| cmd/gh-aw | Entry | GitHub CLI extension binary entry point |
| cmd/gh-aw-wasm | Entry | WebAssembly target entry point |
| internal/tools/actions-build | Internal | Build/validate custom GitHub Actions |
| internal/tools/generate-action-metadata | Internal | Generate action.yml and README.md for JS modules |
| pkg/cli | Core | Command implementations (cobra commands) |
| pkg/workflow | Core | Workflow compilation engine (MD → GitHub Actions YAML) |
| pkg/parser | Core | Markdown frontmatter and YAML parsing |
| pkg/console | Core | Terminal UI rendering and formatting |
| pkg/constants | Shared | Shared constants and semantic type aliases |
| pkg/types | Shared | Shared type definitions across packages |
| pkg/logger | Utility | Namespace-based debug logging, zero overhead when disabled |
| pkg/stringutil | Utility | String manipulation utilities |
| pkg/fileutil | Utility | File path and file operation utilities |
| pkg/gitutil | Utility | Git repository utilities |
| pkg/styles | Utility | Centralized terminal color and style definitions |
| pkg/tty | Utility | TTY (terminal) detection utilities |
| pkg/envutil | Utility | Environment variable reading and validation |
| pkg/repoutil | Utility | GitHub repository slug and URL utilities |
| pkg/sliceutil | Utility | Generic slice utility functions |
| pkg/semverutil | Utility | Semantic versioning primitives |
| pkg/timeutil | Utility | Time formatting utilities |
| pkg/mathutil | Utility | Basic mathematical utility functions |
| pkg/testutil | Utility | Test support utilities (test-only) |
References: §23940712069
Generated by Architecture Diagram Generator · ● 1.1M · ◷
- expires on Apr 10, 2026, 9:07 AM UTC