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

[github-actions]

Summary

This is an incremental update from commit 780f3f0 → 1b847e3. Go files changed across virtually all packages (due to multiple accumulated commits), but no structural changes were detected — the package set and inter-package dependency graph are identical to the previous diagram.

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

Go files changed in the following packages since the previous run, but no new packages, no removed packages, and no new inter-package dependencies were found:

Packages with Go file changes

• cmd/gh-aw — entry point (multiple commits)
• cmd/gh-aw-wasm — WASM entry point
• pkg/cli — largest surface area; new commands and refinements
• pkg/console — output rendering
• pkg/constants — version bumps and new constants
• pkg/envutil, pkg/fileutil, pkg/gitutil — utility updates
• pkg/logger, pkg/mathutil, pkg/repoutil, pkg/sliceutil — minor updates
• pkg/stringutil, pkg/styles, pkg/testutil, pkg/timeutil, pkg/tty — minor updates
• pkg/types — shared type additions
• pkg/parser, pkg/workflow — core engine updates

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: §23135663919

Generated by Architecture Diagram Generator · ◷

• expires on Mar 23, 2026, 9:06 AM UTC