🏗️ Architecture Diagram:gh-aw architecture diagram — incremental update (2026-03-14)

[github-actions]

Summary

Incremental update — all 18 packages under pkg/ were touched by a single squashed commit (af0b91f) but no structural changes were detected. Package set, layers, and dependency arrows are identical to the previous diagram (Issue #20166).

• Previous analysis commit: d64fc1d (not an ancestor of HEAD in this shallow clone)
• Current HEAD: af0b91f · fix: disable HTTP server timeouts in safe-outputs MCP server
• Packages changed: all 18 (squashed commit)
• New packages: none
• Removed packages: none
• New dependencies: none

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

All 18 packages were included in a single squashed squash-merge commit. Analysis confirmed no structural changes:

• Packages added: none
• Packages removed: none
• New dependencies detected: none
• Structural shifts: none — layers (core / shared / utility) unchanged

Packages touched in af0b91f

All packages were touched (squashed commit):

Package	Layer	Change
pkg/cli	Core	Files modified, structure unchanged
pkg/workflow	Core	Files modified, structure unchanged
pkg/parser	Core	Files modified, structure unchanged
pkg/console	Core	Files modified, structure unchanged
pkg/constants	Shared	Files modified, structure unchanged
pkg/types	Shared	Files modified, structure unchanged
pkg/fileutil	Utility	Files modified, structure unchanged
pkg/gitutil	Utility	Files modified, structure unchanged
pkg/logger	Utility	Files modified, structure unchanged
pkg/stringutil	Utility	Files modified, structure unchanged
pkg/sliceutil	Utility	Files modified, structure unchanged
pkg/repoutil	Utility	Files modified, structure unchanged
pkg/tty	Utility	Files modified, structure unchanged
pkg/envutil	Utility	Files modified, structure unchanged
pkg/timeutil	Utility	Files modified, structure unchanged
pkg/mathutil	Utility	Files modified, structure unchanged
pkg/testutil	Utility	Files modified, structure unchanged
pkg/styles	Utility	Files modified, structure unchanged

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

Generated by Architecture Diagram Generator · ◷

• expires on Mar 21, 2026, 8:58 AM UTC