🏗️ Architecture Diagram:[architecture] Architecture diagram — incremental update 2026-07-27

[github-actions]

Architecture Diagram

Incremental update — 2026-07-27
Adds pkg/githubapi discovered since last run (commit 602fe96).

┌──────────────────────────────────────────────────────────────────────────────────────────┐
│                                    ENTRY POINTS                                          │
│                                                                                          │
│   ┌──────────────────┐      ┌──────────────────────┐      ┌─────────────────────┐        │
│   │   cmd/gh-aw      │      │   cmd/gh-aw-wasm      │      │    cmd/linters      │       │
│   │   (main binary)  │      │   (WebAssembly target)│      │    (linter runner)  │       │
│   └────────┬─────────┘      └──────────┬────────────┘      └──────────┬──────────┘       │
│            │                            │                               │                │
├──────────────────────────────────────────────────────────────────────────────────────────┤
│            ▼           CORE PACKAGES    ▼                               ▼                │
│                                                                    pkg/linters/*         │
│                                                                                          │
│   ┌──────────────────────────┐   ┌──────────────────────────────────────────────────┐    │
│   │          cli             │   │                  workflow                         │   │
│   │  Command implementations │──▶│  Compilation engine (MD → GH Actions YAML)       │    │
│   │  compile, run, audit,    │   │  Frontmatter eval, engine dispatch,              │    │
│   │  mcp, logs, campaigns    │   │  lock file generation                            │    │
│   └──────────┬───────────────┘   └──────────────────┬───────────────────────────────┘    │
│              │             ┌────────────────────────┘                                    │
│              ▼             ▼                                                             │
│   ┌──────────────────────┐   ┌────────────────────────────────────────────────────┐      │
│   │       console        │   │                      parser                         │     │
│   │  Terminal UI         │   │  Markdown frontmatter & YAML parsing, schema        │     │
│   │  rendering and msg   │   │  validation, expression extraction                  │     │
│   └──────────────────────┘   └────────────────────────────────────────────────────┘      │
│                                                                                          │
│   ┌──────────────────┐  ┌────────────────────────────────┐  ┌────────────────────────┐   │
│   │      types       │  │           constants             │  │  workflow/compilerenv  │  │
│   │  Shared domain   │  │  Semantic type aliases,         │  │  Compiler env          │  │
│   │  type definitions│  │  engine/job names, flags        │  │  management            │  │
│   └──────────────────┘  └────────────────────────────────┘  │  (used by cli+workflow)│   │
│                                                              └────────────────────────┘  │
├──────────────────────────────────── DOMAIN PACKAGES ─────────────────────────────────────┤
│                                                                                          │
│  ┌─────────────────┐  ┌─────────────────┐  ┌───────────────────────┐  ┌────────────┐     │
│  │   actionpins    │  │   agentdrain    │  │        linters         │  │   stats    │    │
│  │  Action pin     │  │  Agent lifecycle│  │  Custom Go vet-style   │  │ Numerical  │    │
│  │  resolution &   │  │  & drain helpers│  │  code analyzers        │  │ statistics │    │
│  │  version mgmt   │  └─────────────────┘  └───────────────────────┘  └────────────┘     │
│  └─────────────────┘                                                                     │
│  ┌──────────────────────────────────────────────────────────────────────────────────┐    │
│  │  github  —  GitHub label ↔ objective-value mapping (configurable audit scoring)  │    │
│  └──────────────────────────────────────────────────────────────────────────────────┘    │
│  ┌──────────────────────────────────────────────────────────────────────────────────┐    │
│  │  intent  —  PR intent attribution resolver (maps PRs to issues/objectives)       │    │
│  └──────────────────────────────────────────────────────────────────────────────────┘    │
│  ┌──────────────────────────────────────────────────────────────────────────────────┐    │
│  │  modelsdev  —  models.dev catalog fetcher; LLM model pricing lookup (used by cli)│    │
│  └──────────────────────────────────────────────────────────────────────────────────┘    │
├──────────────────────────────────── UTILITY PACKAGES ────────────────────────────────────┤
│                                                                                          │
│  ┌──────────┐ ┌─────────┐ ┌────────────┐ ┌────────┐ ┌─────────┐ ┌──────────┐ ┌───────────┐  │
│  │ fileutil │ │ gitutil │ │ stringutil │ │ logger │ │ envutil │ │ errorutil│ │colorwriter│  │
│  └──────────┘ └─────────┘ └────────────┘ └────────┘ └─────────┘ └──────────┘ └───────────┘  │
│                                                                                          │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌─────────┐ ┌────────┐ ┌──────────┐ ┌─────┐      │
│  │ jsonutil │ │ repoutil │ │semverutil│ │ sliceutil│ │syncutil│ │ timeutil │ │ tty │     │
│  └──────────┘ └──────────┘ └──────────┘ └─────────┘ └────────┘ └──────────┘ └─────┘      │
│                                                                                          │
│  ┌──────────┐ ┌──────────┐ ┌─────────┐ ┌────────────────────────────┐ ┌──────────────┐   │
│  │ typeutil │ │  styles  │ │ setutil │ │  importinpututil           │ │  testutil    │   │
│  └──────────┘ └──────────┘ └─────────┘ └────────────────────────────┘ └──────────────┘   │
│                                                                                          │
│  ┌─────────────────────────────────────────────────────────────────────────────────┐    │
│  │  githubapi  —  GitHub REST client options factory (host, auth, timeout wiring)  │    │
│  └─────────────────────────────────────────────────────────────────────────────────┘    │
└──────────────────────────────────────────────────────────────────────────────────────────┘

Summary

Incremental update since commit 602fe96 (2026-07-06). Most Go files across existing packages changed, and one new package was added.

Change Log

• Added: pkg/githubapi — GitHub REST client options factory (host, auth token, timeout wiring). Classified as Util layer as it provides a low-level API client configuration helper used by other packages.

Package Reference

View Full Package Table

Package	Layer	Description
cli	Core	Command implementations (compile, run, audit, mcp, logs, campaigns)
workflow	Core	Workflow compilation engine — markdown → GitHub Actions YAML
parser	Core	Markdown frontmatter & YAML parsing, schema validation, expression extraction
console	Core	Terminal UI rendering and message formatting
types	Core	Shared domain type definitions
constants	Core	Semantic type aliases, engine/job names, feature flags
workflow/compilerenv	Core	Compiler environment management (used by cli + workflow)
github	Domain	GitHub label ↔ objective-value mapping for audit/outcomes scoring
intent	Domain	PR intent attribution resolver (maps PRs to closing issues/objectives)
actionpins	Domain	GitHub Actions pin resolution and version management
agentdrain	Domain	Agent drain/lifecycle utilities
linters	Domain	Custom Go analysis linters (vet-style checks)
stats	Domain	Numerical statistics for metric collection
modelsdev	Domain	models.dev catalog fetcher; LLM model pricing lookup
fileutil	Util	File path and file operation helpers
gitutil	Util	Git repository helpers
stringutil	Util	String utilities (ANSI stripping, transforms)
logger	Util	Namespace-based debug logging with zero overhead
envutil	Util	Environment variable reading and validation
errorutil	Util	Error classification and inspection helpers
jsonutil	Util	JSON serialization helpers
repoutil	Util	GitHub repository slug and URL utilities
semverutil	Util	Semantic versioning primitives
sliceutil	Util	Generic slice operation helpers
setutil	Util	Generic set operation helpers (map[K]struct{})
syncutil	Util	Concurrency synchronization helpers
timeutil	Util	Time formatting helpers
tty	Util	TTY detection utilities
typeutil	Util	General-purpose type conversion utilities
styles	Util	Centralized terminal color/style definitions
importinpututil	Util	Import path / sub-key resolver
colorwriter	Util	Color-profile-aware io.Writer (NO_COLOR/COLORTERM/TERM aware)
githubapi	Util	GitHub REST client options factory (host, auth, timeout wiring)
testutil	Util	Test helpers (test-only, not used in production)

References: §30256060827

Generated by 🏗️ 1. List all Go packages with their doc comments · sonnet46 · 51 AIC · ⌖ 11.2 AIC · ⊞ 6.2K · ◷

• expires on Aug 3, 2026, 2:05 AM UTC-08:00