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

[github-actions]

Summary

This is an incremental update. Since the last run (commit 10a1f333), Go files changed across all packages — predominantly pkg/workflow (850 file-events), pkg/cli (452), and pkg/parser (95) — but no new packages were added and the layer structure is unchanged. The diagram remains current.

Changed packages: pkg/cli, pkg/workflow, pkg/parser, pkg/console, pkg/stringutil, pkg/logger, pkg/styles, pkg/fileutil, pkg/types, pkg/tty, pkg/timeutil, pkg/testutil, pkg/sliceutil, pkg/repoutil, pkg/mathutil, pkg/envutil, pkg/constants

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 10a1f333

Package	File events	Notable additions
pkg/workflow	850	Incremental compilation updates, new engine/tool support
pkg/cli	452	add_interactive_*, codemod_*, actions_build_command, audit improvements
pkg/parser	95	Frontmatter/schema updates
pkg/console	39	Rendering updates
Others	≤11 each	Minor utility updates

Structural shifts

• None — package count, layer assignments, and inter-package dependency direction are all unchanged.

Package Reference

Package	Layer	Description
cmd/gh-aw	Entry	Main CLI binary and command registration
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: §22568588978

Generated by Architecture Diagram Generator

• expires on Mar 9, 2026, 9:01 AM UTC

[pelikhan]

/q update workflow to maintains file in scratchpad folder

[github-actions]

Issue created: #19205

🎩 Equipped by Q