🏗️ Architecture Diagram:Full rebuild — gh-aw package architecture (2026-04-28)

[github-actions]

Summary

Full rebuild — no cache file existed. Analyzed all 23 packages across cmd/ and pkg/.

Architecture Diagram

┌──────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                         ENTRY POINTS                                                 │
│                                                                                                      │
│               ┌────────────────────────────┐          ┌──────────────────┐                          │
│               │        cmd/gh-aw           │          │  cmd/gh-aw-wasm  │                          │
│               │  Main CLI binary / cobra   │          │  WebAssembly target                         │
│               └──────┬─────────────────────┘          └──────────────────┘                          │
│                      │ imports: cli, workflow, parser, console, constants                            │
└──────────────────────┼───────────────────────────────────────────────────────────────────────────────┘
                       │
┌──────────────────────▼───────────────────────────────────────────────────────────────────────────────┐
│                                        CORE PACKAGES                                                 │
│                                                                                                      │
│  ┌──────────────────────────────┐    ┌────────────────────────────────┐                             │
│  │           pkg/cli            │    │         pkg/workflow            │                             │
│  │  Command implementations     │───▶│  Markdown → GH Actions YAML   │                             │
│  │  compile, run, audit, mcp,   │    │  compiler, engine config,      │                             │
│  │  logs, stats                 │    │  MCP, tools, expressions       │                             │
│  └──────────────┬───────────────┘    └────────────────┬───────────────┘                             │
│                 │                                      │                                             │
│                 │         ┌───────────────────────────▼───────────────────────┐                     │
│                 │         │                  pkg/parser                        │                     │
│                 └────────▶│  Markdown frontmatter parsing, YAML schema valid. │                     │
│                           └───────────────────────────┬───────────────────────┘                     │
│                                                       │                                              │
│                 ┌─────────────────────────────────────▼──────────────┐                              │
│                 │                 pkg/console                          │                              │
│                 │  Terminal UI formatting: success/error/info/warning │                              │
│                 └────────────────────────────────────────────────────┘                              │
│                                                                                                      │
└──────────────────────────────────────────────────────────────────────────────────────────────────────┘
                       │ (all core packages import utilities below)
┌──────────────────────▼───────────────────────────────────────────────────────────────────────────────┐
│                                      UTILITY PACKAGES                                                │
│                                                                                                      │
│  ┌─────────┐ ┌──────────┐ ┌────────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐ ┌──────────┐      │
│  │ logger  │ │constants │ │ stringutil │ │ sliceutil│ │  gitutil │ │fileutil │ │  types   │      │
│  │ (debug) │ │(typed K) │ │  (string)  │ │ (slices) │ │  (git)   │ │ (files) │ │ (shared) │      │
│  └─────────┘ └──────────┘ └────────────┘ └──────────┘ └──────────┘ └─────────┘ └──────────┘      │
│                                                                                                      │
│  ┌─────────┐ ┌──────────┐ ┌────────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐ ┌──────────┐      │
│  │ styles  │ │ typeutil │ │   timeutil │ │   tty    │ │semverutil│ │  stats  │ │ repoutil │      │
│  │(colors) │ │ (cast)   │ │  (timing)  │ │ (detect) │ │ (semver) │ │(metrics)│ │ (repos)  │      │
│  └─────────┘ └──────────┘ └────────────┘ └──────────┘ └──────────┘ └─────────┘ └──────────┘      │
│                                                                                                      │
│  ┌───────────────┐  ┌─────────────┐  ┌──────────┐  ┌──────────┐                                   │
│  │  actionpins   │  │  agentdrain │  │  envutil │  │ testutil │                                   │
│  │ (pin resolve) │  │ (agent I/O) │  │  (env)   │  │ (testing)│                                   │
│  └───────────────┘  └─────────────┘  └──────────┘  └──────────┘                                   │
└──────────────────────────────────────────────────────────────────────────────────────────────────────┘

Package Reference

Package	Layer	Description
cmd/gh-aw	Entry	Main CLI binary (cobra root command)
cmd/gh-aw-wasm	Entry	WebAssembly compilation target
pkg/cli	Core	Command implementations: compile, run, audit, mcp, logs, stats
pkg/workflow	Core	Markdown → GitHub Actions YAML compilation engine
pkg/parser	Core	Markdown frontmatter parsing and YAML schema validation
pkg/console	Core	Terminal UI formatting (success/error/info/warning/progress)
pkg/logger	Utility	Namespace-based debug logging with zero overhead
pkg/constants	Utility	Shared typed constants: engines, versions, feature flags
pkg/stringutil	Utility	String manipulation utilities
pkg/sliceutil	Utility	Slice manipulation utilities
pkg/gitutil	Utility	Git operation utilities
pkg/fileutil	Utility	File path and file operation utilities
pkg/types	Utility	Shared type definitions
pkg/styles	Utility	Centralized style and color definitions
pkg/timeutil	Utility	Time utilities
pkg/typeutil	Utility	General-purpose type conversion utilities
pkg/tty	Utility	TTY terminal detection utilities
pkg/semverutil	Utility	Semantic versioning primitives
pkg/stats	Utility	Numerical statistics utilities
pkg/repoutil	Utility	GitHub repository slug and URL utilities
pkg/agentdrain	Utility	Agent drain I/O utilities
pkg/actionpins	Utility	GitHub Actions pin resolution
pkg/envutil	Utility	Environment variable reading and validation
pkg/testutil	Utility	Test helper utilities (test-only)

References:

• §25045056160
  ___BEGIN___COMMAND_DONE_MARKER___0

Generated by Architecture Diagram Generator · ● 1.1M · ◷

• expires on May 5, 2026, 9:36 AM UTC