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

[github-actions]

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 (imports pkg/cli)
• internal/tools/generate-action-metadata — generate action.yml and README.md for JS modules (imports pkg/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 alongside cmd/ binaries. These tools reuse pkg/cli functions 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

[github-actions]

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

View newer issue

---

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