🏗️ Architecture Diagram:gh-aw architecture diagram — incremental update 2026-03-19

[github-actions]

Summary

Incremental update — analyzed commit 4204106c (HEAD). Previous analysis was at 40091c17. Since this is a shallow clone, all packages appeared in the diff, but a structural review confirms no architectural changes: the same 18 packages exist across identical layers, and no new inter-package dependencies were detected.

Cache updated with new HEAD SHA: 4204106cbf3a45331e2c767449ab3a0666f76cd0.

---

Architecture Diagram

┌─────────────────────────────────────────────────────────────────────────────────────────────┐
│                                       ENTRY POINTS                                           │
│  ┌──────────────────────────────────────┐    ┌──────────────────────────────────────────┐  │
│  │            cmd/gh-aw                 │    │           cmd/gh-aw-wasm                 │  │
│  │   Main CLI binary & all commands     │    │         WebAssembly target               │  │
│  └──────────────────┬───────────────────┘    └──────────────────────────┬───────────────┘  │
├─────────────────────┼──────────────────────────────────────────────────┼──────────────────┤
│                     ▼           CORE PACKAGES                          ▼                   │
│  ┌────────────────────────────┐            ┌───────────────────────────────────────────┐   │
│  │        pkg/cli             │            │            pkg/workflow                   │   │
│  │  Command implementations   ├───────────▶│  Workflow compilation engine &            │   │
│  │  and all CLI subcommands   │            │  orchestration                            │   │
│  └──────────────┬─────────────┘            └──────────────────┬────────────────────────┘   │
│                 │                                              │                             │
│                 └────────────────────┬─────────────────────────┘                            │
│                                      ▼                                                       │
│                          ┌──────────────────────────────┐                                   │
│                          │        pkg/parser            │                                   │
│                          │  Markdown frontmatter &      │                                   │
│                          │  YAML parsing                │                                   │
│                          └──────────────┬───────────────┘                                   │
│                                         │                                                    │
│                          ┌──────────────▼───────────────┐                                   │
│                          │        pkg/console           │                                   │
│                          │  Terminal UI & styled output │                                   │
│                          └──────────────────────────────┘                                   │
│                                                                                              │
│           ↕ all core packages also depend on constants, types, and utilities ↕              │
├──────────────────────────────────────────────────────────────────────────────────────────────┤
│                                   SHARED DEFINITIONS                                         │
│  ┌─────────────────────────────────────────┐  ┌──────────────────────────────────────────┐  │
│  │             pkg/constants               │  │              pkg/types                   │  │
│  │  Versions, flags, URLs, engine names    │  │  Shared type definitions across packages │  │
│  └─────────────────────────────────────────┘  └──────────────────────────────────────────┘  │
├──────────────────────────────────────────────────────────────────────────────────────────────┤
│                                       UTILITIES                                              │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐ ┌─────────┐   │
│  │fileutil │ │ gitutil │ │ logger  │ │stringutil│ │ sliceutil│ │repoutil │ │   tty   │   │
│  └─────────┘ └─────────┘ └─────────┘ └──────────┘ └──────────┘ └─────────┘ └─────────┘   │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐  ┌─────────┐                            │
│  │ envutil │ │timeutil │ │mathutil │ │testutil │  │ styles  │                             │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘  └─────────┘                            │
└──────────────────────────────────────────────────────────────────────────────────────────────┘

---

Change Log

This was an incremental update. Analysis compared 40091c17 → 4204106c.

Change Type	Details
Packages added	None
Packages removed	None
Packages modified	All packages (shallow clone — full file set in single commit)
New dependencies	None detected
Structural shifts	None

The diagram is unchanged from the previous run. Architecture remains stable.

---

Package Reference

Package	Layer	Description
pkg/cli	Core	CLI command implementations and subcommands
pkg/workflow	Core	Workflow compilation engine and orchestration
pkg/parser	Core	Markdown frontmatter and YAML parsing
pkg/console	Core	Terminal UI and styled output rendering
pkg/constants	Shared	Application-wide constants (versions, flags, URLs, engine names)
pkg/types	Shared	Shared type definitions across packages
pkg/fileutil	Utility	File path and operation utilities
pkg/gitutil	Utility	Git repository utilities
pkg/logger	Utility	Namespace-based debug logging with zero overhead
pkg/stringutil	Utility	String manipulation utilities
pkg/sliceutil	Utility	Slice manipulation utilities
pkg/repoutil	Utility	GitHub repository slug and URL utilities
pkg/tty	Utility	TTY detection utilities
pkg/envutil	Utility	Environment variable reading and validation
pkg/timeutil	Utility	Time utilities
pkg/mathutil	Utility	Basic mathematical utility functions
pkg/testutil	Utility	Testing helper utilities
pkg/styles	Utility	Centralized terminal style and color definitions

References: §23287236264

Generated by Architecture Diagram Generator · ◷

• expires on Mar 26, 2026, 9:03 AM UTC

[github-actions]

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

View newer issue

---

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