🏗️ Architecture Diagram:Architecture Diagram - Stable Structure with Internal Refactoring

[github-actions]

Summary

Status: ✅ Architecture diagram remains stable and current
Analysis type: Incremental update
Changes analyzed: 1,469 Go files modified since last run
Structural changes: None - package architecture unchanged

Despite significant internal refactoring across the codebase (1,469 Go files modified), the high-level package architecture remains stable with all existing packages intact and no new packages added.

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  │                             │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘  └─────────┘                            │
└──────────────────────────────────────────────────────────────────────────────────────────────┘

Key Findings

The analysis shows the codebase underwent significant internal development with 1,469 Go files modified, but the package structure remains stable:

No Changes To:

• Entry points (cmd/gh-aw, cmd/gh-aw-wasm)
• Core packages (cli, workflow, parser, console)
• Shared definitions (constants, types)
• Utility packages (fileutil, gitutil, logger, stringutil, sliceutil, repoutil, tty, envutil, timeutil, mathutil, testutil, styles)

This indicates the recent work focused on internal refactoring and feature development within existing packages rather than architectural changes.

Package Reference

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

Generated by Architecture Diagram Generator · ◷

• expires on Mar 16, 2026, 9:02 AM UTC

[github-actions]

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

View newer issue

---

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