🏗️ Architecture Diagram:Architecture Diagram: Incremental Update — 2026-03-11

[github-actions]

Summary

Incremental update — analysed changes since last run (0ce8adde → 9f0be697). All 18 packages under pkg/ and both cmd/ entry points had Go file changes (large merge commit), but the package structure and inter-package dependency graph are unchanged. The architecture diagram remains current.

Packages re-analysed: cli, workflow, parser, console, constants, types, fileutil, gitutil, logger, stringutil, sliceutil, repoutil, tty, envutil, timeutil, mathutil, testutil, styles

---

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

Packages with Go file changes since last run

All packages were touched in commit 9f0be697 (Phase 4: Add AuthDefinition and RequestShape for provider-owned auth and request shaping, #20473) — a large merge. No structural changes were detected:

Package	Changed	New?	Removed?	Dependencies changed?
pkg/cli	✅	No	No	No
pkg/workflow	✅	No	No	No
pkg/parser	✅	No	No	No
pkg/console	✅	No	No	No
pkg/constants	✅	No	No	No
pkg/types	✅	No	No	No
pkg/fileutil	✅	No	No	No
pkg/gitutil	✅	No	No	No
pkg/logger	✅	No	No	No
pkg/stringutil	✅	No	No	No
pkg/sliceutil	✅	No	No	No
pkg/repoutil	✅	No	No	No
pkg/tty	✅	No	No	No
pkg/envutil	✅	No	No	No
pkg/timeutil	✅	No	No	No
pkg/mathutil	✅	No	No	No
pkg/testutil	✅	No	No	No
pkg/styles	✅	No	No	No

New dependencies detected: None
Structural shifts: None — diagram is unchanged from previous run (Issue #20166)

---

Package Reference

Package	Layer	Description
cmd/gh-aw	Entry	Main CLI binary and all commands
cmd/gh-aw-wasm	Entry	WebAssembly compilation target
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: §22944553850

Generated by Architecture Diagram Generator · ◷

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

[github-actions]

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

View newer issue

---

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