🏗️ Architecture Diagram:gh-aw package architecture diagram — 2026-04-06

[github-actions]

Summary

Incremental update — Go source files changed across all packages since the previous run (874aaf5→13ac7de), but no structural changes were detected: the set of packages is unchanged and all inter-package dependency relationships are identical to the previous analysis. The diagram below remains current.

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/agentdrain    │                                                                          │
│  │  Log template mining │                                                                          │
│  └──────────────────────┘                                                                          │
│                                                                                                     │
│                 ┌──────────────────────────────────────────────────────────────────────────────┐   │
│                 │           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/testutil │  (test support only)                                                            │
│  └──────────────┘                                                                                  │
└─────────────────────────────────────────────────────────────────────────────────────────────────────┘

Change Log

Incremental update — no structural changes detected.

• Packages modified (Go source files touched): all 19 packages (pkg/agentdrain, pkg/cli, pkg/console, pkg/constants, pkg/envutil, pkg/fileutil, pkg/gitutil, pkg/logger, pkg/parser, pkg/repoutil, pkg/semverutil, pkg/sliceutil, pkg/stringutil, pkg/styles, pkg/testutil, pkg/timeutil, pkg/tty, pkg/types, pkg/workflow)
• New packages: none
• Removed packages: none
• Dependency changes: none — all inter-package import relationships are identical to the previous analysis

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/agentdrain	Core	Drain3 log template mining and anomaly detection
pkg/constants	Shared	Shared constants and semantic type aliases
pkg/types	Shared	Shared type definitions across packages
pkg/logger	Utility	Namespace-based debug logging with 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/testutil	Utility	Test support utilities (test-only)

References:

• §24025792210

Generated by Architecture Diagram Generator · ● 645K · ◷

• expires on Apr 13, 2026, 9:07 AM UTC