🏗️ Architecture Diagram:Full rebuild – gh-aw package architecture

[github-actions]

This is a full rebuild — no prior cache existed. All packages were analyzed from scratch at commit e4729b3d90afe948d7294dd6365efa8c01547137.

Architecture Diagram

┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                       ENTRY POINTS                                               │
│                                                                                                  │
│  ┌──────────────────────────┐                         ┌─────────────────────────────┐            │
│  │       cmd/gh-aw          │                         │       cmd/gh-aw-wasm        │            │
│  │    (main CLI binary)     │                         │      (WebAssembly target)   │            │
│  └───┬────────┬─────────────┘                         └──────────┬─────────┬────────┘            │
│      │        │                                                   │         │                    │
├──────────────────────────────────────────────────────────────────────────────────────────────────┤
│      ▼        ▼                    CORE PACKAGES                 ▼         ▼                     │
│                                                                                                  │
│  ┌──────────────────┐   ┌───────────────────────┐   ┌────────────────────────────┐               │
│  │    pkg/cli       │──▶│    pkg/workflow        │──▶│      pkg/parser            │              │
│  │  CLI commands &  │   │  workflow compilation  │   │  markdown/YAML frontmatter │              │
│  │  dispatch layer  │   │  & Actions generation  │   │  parsing & validation      │              │
│  └──────┬───────────┘   └──────┬─────────────────┘   └────────────────────────────┘              │
│         │                      │                                                                 │
│         └─────────────┐  ┌─────┘                                                                 │
│                       ▼  ▼                                                                       │
│             ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐                     │
│             │   pkg/console    │  │  pkg/agentdrain  │  │  pkg/actionpins  │                     │
│             │  terminal UI &   │  │  log streaming & │  │  action pin      │                     │
│             │  spinner/render  │  │  drain mgmt      │  │  resolution      │                     │
│             └──────────────────┘  └──────────────────┘  └──────────────────┘                     │
│                          also shared: pkg/stats · pkg/types · pkg/constants                      │
├──────────────────────────────────────────────────────────────────────────────────────────────────┤
│                                  UTILITY PACKAGES                                                │
│                                                                                                  │
│  ┌────────┐ ┌────────┐ ┌─────┐ ┌──────────┐ ┌─────────┐ ┌──────────┐ ┌──────────┐            │
│  │ logger │ │ styles │ │ tty │ │ fileutil │ │ gitutil │ │ repoutil │ │ sliceutil│            │
│  └────────┘ └────────┘ └─────┘ └──────────┘ └─────────┘ └──────────┘ └──────────┘            │
│                                                                                                  │
│  ┌──────────┐ ┌─────────┐ ┌───────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐              │
│  │ typeutil │ │ envutil │ │ semverutil│ │stringutil│ │ timeutil │ │ testutil │              │
│  └──────────┘ └─────────┘ └───────────┘ └──────────┘ └──────────┘ └──────────┘              │
│                                                                                                  │
└──────────────────────────────────────────────────────────────────────────────────────────────────┘

Package Reference

Package	Layer	Description
cli	Core	CLI command implementations and dispatch layer
workflow	Core	Workflow compilation and GitHub Actions YAML generation
parser	Core	Markdown/YAML frontmatter parsing and validation
console	Core	Terminal UI rendering, spinners, and formatted output
agentdrain	Core	Agent log streaming and drain management
actionpins	Core	GitHub Actions pin resolution
stats	Shared	Numerical statistics utilities for metric collection
types	Shared	Shared type definitions used across packages
constants	Shared	Shared constants across the codebase
logger	Utility	Namespace-based debug logging with zero overhead
styles	Utility	Terminal style definitions (no-op for Wasm)
tty	Utility	TTY terminal detection utilities
fileutil	Utility	File path and file operation utilities
gitutil	Utility	Git operation utilities
repoutil	Utility	GitHub repository slug and URL utilities
sliceutil	Utility	Generic slice utilities
typeutil	Utility	General-purpose type conversion utilities
envutil	Utility	Environment variable reading and validation
semverutil	Utility	Shared semantic versioning primitives
stringutil	Utility	String manipulation utilities
timeutil	Utility	Time-related utilities
testutil	Utility	Test helper utilities

References: §24658621102

Generated by Architecture Diagram Generator · ● 1.1M · ◷

• expires on Apr 27, 2026, 9:28 AM UTC

[github-actions]

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

View newer issue

---

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