Repository navigation
🏗️ Architecture Diagram:gh-aw package architecture diagram — incremental update 2026-04-16 #26590
Closed as not planned
Description
Summary
Incremental update — 2 new packages detected since last run (commit e44f4e7). All other package layers remain unchanged.
Packages added:
pkg/actionpins— Action pin resolution (maps repo refs to pinned commit SHAs). Imported by bothpkg/workflowandpkg/cli.pkg/stats— Numerical statistics utilities for metric collection. Imported bypkg/cli.
Architecture Diagram
┌────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ ENTRY POINTS │
│ ┌────────────────────────────┐ ┌────────────────────────┐ ┌────────────────────────────────┐ │
│ │ cmd/gh-aw │ │ cmd/gh-aw-wasm │ │ internal/tools/ (×2) │ │
│ │ GitHub CLI extension bin │ │ WebAssembly target │ │ actions-build, gen-metadata │ │
│ └────────────┬───────────────┘ └────────────┬───────────┘ └──────────────┬─────────────────┘ │
│ │ │ │ │
├───────────────┼─────────────────────────────────┼──────────────────────────────┼───────────────────┤
│ ▼ CORE PACKAGES ▼ ▼ │
│ ┌──────────────────┐ ┌──────────────────────┐ ┌────────────────────┐ ┌───────────────────┐ │
│ │ pkg/cli │──▶│ pkg/workflow │──▶│ pkg/parser │ │ pkg/console │ │
│ │ Command impls │ │ Workflow compilation │ │ MD/YAML parsing │◀──│ Terminal UI │ │
│ └──────┬───────────┘ └─────────┬────────────┘ └────────────────────┘ └───────────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌──────────────────────┐ ┌────────────────────────┐ │
│ │ pkg/agentdrain │ │ pkg/actionpins │ │
│ │ Log template mining │ │ Action pin resolution │ │
│ └──────────────────────┘ └────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────────────────────────────┐ │
│ │ pkg/constants · pkg/types (shared primitives, no deps) │ │
│ └──────────────────────────────────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────────────────────────────────────────────────┤
│ UTILITIES │
│ ┌──────────┐ ┌──────────────┐ ┌────────────┐ ┌───────────┐ ┌──────────┐ ┌──────────┐ │
│ │pkg/logger│ │pkg/stringutil│ │pkg/fileutil│ │pkg/gitutil│ │pkg/styles│ │ pkg/tty │ │
│ └──────────┘ └──────────────┘ └────────────┘ └───────────┘ └──────────┘ └──────────┘ │
│ ┌───────────┐ ┌─────────────┐ ┌─────────────┐ ┌──────────────┐ ┌────────────┐ ┌─────────────┐ │
│ │pkg/envutil│ │pkg/repoutil │ │pkg/sliceutil│ │pkg/semverutil│ │pkg/timeutil│ │pkg/typeutil │ │
│ └───────────┘ └─────────────┘ └─────────────┘ └──────────────┘ └────────────┘ └─────────────┘ │
│ ┌──────────┐ ┌──────────────┐ │
│ │pkg/stats │ │ pkg/testutil │ (test support only) │
│ └──────────┘ └──────────────┘ │
└─────────────────────────────────────────────────────────────────────────────────────────────────────┘
Change Log
Packages Added
pkg/actionpins(Core) — Maps GitHub Actions repository references (e.g.actions/checkout@v4) to their pinned commit SHAs. Intentionally dependency-free ofpkg/workflowto avoid import cycles. Imported bypkg/workflow(action_pins.go,compiler_types.go) andpkg/cli(audit_cross_run.go).pkg/stats(Utility) — Numerical statistics helpers for metric collection. Importspkg/console,pkg/logger,pkg/semverutil. Used bypkg/cli(health_metrics.go,copilot_events_jsonl.go).
Dependencies Detected
pkg/workflow→pkg/actionpins(new)pkg/cli→pkg/actionpins(new)pkg/cli→pkg/stats(new)
View Previous Diagram (2026-04-13)
Based on commit e44f4e7 — the same structure without pkg/actionpins and pkg/stats.
Package Reference
| Package | Layer | Description |
|---|---|---|
| cmd/gh-aw | Entry | GitHub CLI extension binary entry point |
| cmd/gh-aw-wasm | Entry | WebAssembly target entry point |
| internal/tools/actions-build | Internal | Build/validate custom GitHub Actions |
| internal/tools/generate-action-metadata | Internal | Generate action.yml and README.md for JS modules |
| pkg/cli | Core | Command implementations (cobra commands) |
| pkg/workflow | Core | Workflow compilation engine (MD → GitHub Actions YAML) |
| pkg/parser | Core | Markdown frontmatter and YAML parsing |
| pkg/console | Core | Terminal UI rendering and formatting |
| pkg/agentdrain | Core | Drain3 log template mining and anomaly detection |
| pkg/actionpins | Core | Action pin resolution — maps repo refs to pinned commit SHAs (new) |
| pkg/constants | Shared | Shared constants and semantic type aliases |
| pkg/types | Shared | Shared type definitions across packages |
| pkg/logger | Utility | Namespace-based debug logging with zero overhead when disabled |
| pkg/stringutil | Utility | String manipulation utilities |
| pkg/fileutil | Utility | File path and file operation utilities |
| pkg/gitutil | Utility | Git repository utilities |
| pkg/styles | Utility | Centralized terminal color and style definitions |
| pkg/tty | Utility | TTY (terminal) detection utilities |
| pkg/envutil | Utility | Environment variable reading and validation |
| pkg/repoutil | Utility | GitHub repository slug and URL utilities |
| pkg/sliceutil | Utility | Generic slice utility functions |
| pkg/semverutil | Utility | Semantic versioning primitives |
| pkg/timeutil | Utility | Time formatting utilities |
| pkg/typeutil | Utility | Safe type conversion utilities for any/JSON/YAML values |
| pkg/stats | Utility | Numerical statistics utilities for metric collection (new) |
| pkg/testutil | Utility | Test support utilities (test-only) |
References: §24501777868
Note
🔒 Integrity filter blocked 3 items
The following items were blocked because they don't meet the GitHub integrity level.
create_issue.cjs: issue body bypasses@mentionneutralization — asymmetric sanitization relative to title path #26588list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".- cache-memory: default
integrity: nonerestores unvalidated prior-run content to agent filesystem before any detection gate #26586list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved". - Safeoutputs write-sink reachable from bash in github-readonly profile — shared MCP bearer token bypasses declared read-only perm
[Content truncated due to length] #26584
list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
To allow these resources, lower min-integrity in your GitHub frontmatter:
tools:
github:
min-integrity: approved # merged | approved | unapproved | noneGenerated by Architecture Diagram Generator · ● 1.9M · ◷
- expires on Apr 23, 2026, 9:16 AM UTC
Activity
github-actions commentedon Apr 17, 2026
This issue is being closed as outdated. A newer issue has been created: #26830
View newer issue
This action was performed automatically by the
Architecture Diagram Generatorworkflow.