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

[github-actions]

Updates scratchpad/architecture.md with the incremental architecture diagram reflecting changes since f5a2c2a.

What changed

• Added internal/tools/ tier to the Entry Points layer:
  • internal/tools/actions-build — build/validate custom GitHub Actions
  • internal/tools/generate-action-metadata — generate action.yml and README.md for JS modules
• Both tools import pkg/cli, extending its role beyond the main CLI binary
• Refreshed diagram layout with cleaner box widths
• Added internal/tools rows to the Package Reference table

Source

Generated by the architecture diagram workflow run §23940712069.

Generated by Architecture Diagram Generator · ● 1.1M · ◷

• expires on Apr 10, 2026, 9:07 AM UTC

[Copilot]

Pull request overview

Updates the gh-aw architecture documentation to reflect newly added internal tooling entry points and a refreshed diagram layout.

Changes:

• Adds an internal/tools/ tier (actions-build, generate-action-metadata) to the Entry Points layer in the diagram.
• Refreshes diagram formatting/layout for readability.
• Extends the Package Reference table with the two internal tools.

---

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

[Copilot]

The "Source" link text and URL look incorrect: it references "Issue #aw_arch01" but links to the generic issues list (…/gh-aw/issues) rather than a specific issue or the workflow run that generated the diagram (as described in the PR). Please update this to the correct source (e.g., link directly to the generating run or a real issue URL).

[Copilot]

In the diagram, the internal tool is abbreviated as "gen-metadata", but elsewhere (and in the package reference table) it's named "generate-action-metadata". Consider using the full tool name here (or a consistently used abbreviation) to avoid confusion when cross-referencing packages.

Suggested change

	│ ┌────────────────────────────┐ ┌────────────────────────┐ ┌────────────────────────────────┐ │
	│ │ cmd/gh-aw │ │ cmd/gh-aw-wasm │ │ internal/tools/ (×2) │ │
	│ │ GitHub CLI extension bin │ │ WebAssembly target │ │ actions-build, gen-metadata │ │
	│ └────────────┬───────────────┘ └────────────┬───────────┘ └──────────────┬─────────────────┘ │
	│ ┌────────────────────────────┐ ┌────────────────────────┐ ┌──────────────────────────────────────────────┐ │
	│ │ cmd/gh-aw │ │ cmd/gh-aw-wasm │ │ internal/tools/ (×2) │ │
	│ │ GitHub CLI extension bin │ │ WebAssembly target │ │ actions-build, generate-action-metadata │ │
	│ └────────────┬───────────────┘ └────────────┬───────────┘ └─────────────────────┬────────────────────────┘ │