[architecture] Update architecture diagram - 2026-04-27

[github-actions]

Full rebuild of the architecture diagram (cache miss — no prior state existed).

Changes

• Refreshed scratchpad/architecture.md with updated diagram and package reference table
• Corrected layer assignments: actionpins, agentdrain, stats moved to utility layer based on import count analysis
• Added import frequency annotations to package reference table
• Widened diagram to 102 chars to cleanly fit all package boxes

Analysis basis

• Commit: 6dea27ee7256ea8d27e910e2b275e2b11ece4830
• 22 packages analyzed across cmd/ and pkg/
• Import relationships derived from grep across all non-test .go files

Generated by Architecture Diagram Generator · ● 757.2K · ◷

• expires on May 4, 2026, 9:33 AM UTC

[github-actions]

Hey @github-actions — great work keeping the architecture diagram in sync with the latest codebase state! 🎉 The updated layer assignments and import frequency annotations for the 22 analyzed packages look like a solid, focused change.

One checklist item flagged automatically:

• No test changes detected — for a pure documentation/diagram update in scratchpad/architecture.md, this is expected and not a blocker. No code logic was modified.

This PR looks ready for maintainer review. The diff is clean, scoped to a single file, and the description clearly explains the analysis basis and what changed.

No action needed — the architecture diagram PR is documentation-only and passes all substantive contribution checks.

Generated by Contribution Check · ● 1.1M · ◷

[Copilot]

Pull request overview

Updates the repository’s gh-aw package architecture documentation with a rebuilt ASCII dependency diagram and an updated package reference table including import-frequency annotations.

Changes:

• Rebuilt the ASCII architecture diagram (wider layout) and refreshed package layering (moving actionpins, agentdrain, stats to Utility).
• Updated the package reference table to use cmd/... and pkg/... paths and added import-frequency annotations.
• Updated the “Last updated” header metadata for the new run.

Show a summary per file

File	Description
scratchpad/architecture.md	Replaces the prior diagram/table with a rebuilt architecture diagram and import-frequency annotated package reference.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

• Files reviewed: 1/1 changed files
• Comments generated: 3

[Copilot]

Import-frequency annotations in the package table are inconsistent: pkg/constants has (221) while the surrounding rows use (N imports)/(1 import). Please standardize the annotation format (including pluralization) across all rows for easier scanning.

Suggested change

	| `pkg/constants` | Utility | Shared typed constants: engines, versions, feature flags (221) |
	| `pkg/constants` | Utility | Shared typed constants: engines, versions, feature flags (221 imports) |

[Copilot]

The scratchpad header doesn’t follow the repo’s documented format for the architecture diagram source reference. The workflow instructions specify > Last updated: <YYYY-MM-DD> · Source: [Issue #<number>](<issue_url>) (.github/workflows/daily-architecture-diagram.md:195), but this links to the generic /issues page and omits the issue number/URL. Please update this to point to the specific generated issue (including its number).

Suggested change

	> Last updated: 2026-04-27 · Source: [🏗️ Architecture Diagram: Full rebuild — gh-aw package architecture (2026-04-27)](https://github.com/github/gh-aw/issues)
	> Last updated: 2026-04-27 · Source: [Issue #<number>](https://github.com/github/gh-aw/issues/<number>)

[Copilot]

The ENTRY POINTS ASCII diagram is currently malformed/inaccurate for cmd/gh-aw-wasm: line 15 is missing the closing right border (│), and the diagram doesn’t show cmd/gh-aw-wasm importing pkg/parser + pkg/workflow (see cmd/gh-aw-wasm/main.go imports). Please fix the box alignment and add the correct dependency annotation/connection for the wasm entry point.

Suggested change

	│ ┌────────────────────────────┐ ┌──────────────────┐ │
	│ │ cmd/gh-aw │ │ cmd/gh-aw-wasm │ │
	│ │ Main CLI binary / cobra │ │ WebAssembly target │
	│ └──────┬─────────────────────┘ └──────────────────┘ │
	│ │ imports: cli, workflow, parser, console, constants │
	└──────────────────────┼───────────────────────────────────────────────────────────────────────────────┘
	│
	┌──────────────────────▼───────────────────────────────────────────────────────────────────────────────┐
	│ ┌────────────────────────────┐ ┌────────────────────────┐ │
	│ │ cmd/gh-aw │ │ cmd/gh-aw-wasm │ │
	│ │ Main CLI binary / cobra │ │ WebAssembly target │ │
	│ └──────┬─────────────────────┘ └──────────┬─────────────┘ │
	│ │ imports: cli, workflow, parser, console, constants │
	│ │ │ imports: workflow, parser │
	└──────────────────────┼─────────────────────────────────┼─────────────────────────────────────────────┘
	│ │
	┌──────────────────────▼─────────────────────────────────▼─────────────────────────────────────────────┐