[architecture] Update architecture diagram 2026-05-02

[github-actions]

Full rebuild of the architecture diagram. Analyzed 22 packages.

Generated by Architecture Diagram Generator · ● 1.9M · ◷

• expires on May 9, 2026, 9:10 AM UTC

[pelikhan]

/q run weekly

[github-actions]

🎩 Mission equipment ready! Q has optimized your workflow. Use wisely, 007! 🔫

[Copilot]

Pull request overview

Updates the generated architecture diagram and package reference to reflect the current gh-aw package set as of 2026-05-02, linking the update to the workflow run that produced it.

Changes:

• Refreshed the architecture ASCII diagram layout/content (entry points, core packages, utility packages).
• Updated “Last updated” metadata and provenance link to the generating workflow run.
• Revised the package reference table (formatting + layer/description updates).

Show a summary per file

File	Description
scratchpad/architecture.md	Regenerates the architecture diagram and updates the package inventory/reference table.

Copilot's findings

Tip

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

Comments suppressed due to low confidence (2)

scratchpad/architecture.md:38

• In the core diagram, pkg/agentdrain is shown as downstream of pkg/console (and described as "Agent output streaming"). In the codebase, pkg/agentdrain does not import pkg/console (it’s used by pkg/cli, e.g. pkg/cli/drain3_integration.go), and the package is a Drain-style log template miner/anomaly detector (see pkg/agentdrain/README.md). Please update the arrow/placement and the label so the diagram matches the actual dependency + purpose.

│                   │                                                                              │
│    ┌──────────────┴────────────┐                                                                │
│    │       pkg/agentdrain      │                                                                │
│    │  Agent output streaming   │                                                                │
│    └───────────────────────────┘                                                                │

scratchpad/architecture.md:55

• In the utility-packages ASCII diagram, several package names are split with hyphens (e.g. pkg/const-/ants, pkg/time-/util, pkg/test-/util). Those aren’t real import paths and can be confusing when readers try to map the diagram to directories. Please reflow the boxes so package paths appear exactly (e.g. pkg/constants, pkg/timeutil, pkg/testutil) without hyphenation.

│  ┌────────────┐ ┌────────────┐ ┌─────────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │
│  │ pkg/logger │ │pkg/fileutil│ │ pkg/gitutil  │ │pkg/types │ │pkg/const-│ │  pkg/stringutil  │ │
│  │Debug logger│ │File ops    │ │Git utilities │ │ Shared   │ │  ants    │ │ String helpers   │ │
│  └────────────┘ └────────────┘ └─────────────┘ │  types   │ │Constants │ └──────────────────┘ │
│                                                 └──────────┘ └──────────┘                      │
│  ┌────────────┐ ┌────────────┐ ┌─────────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │
│  │pkg/sliceutil│ │pkg/typeutil│ │pkg/repoutil │ │pkg/envutil│ │pkg/styles│ │  pkg/actionpins  │ │
│  │Slice helpers│ │Type conv.  │ │Repo URL util│ │Env vars  │ │UI styles │ │Action pin resolver│ │
│  └────────────┘ └────────────┘ └─────────────┘ └──────────┘ └──────────┘ └──────────────────┘ │
│                                                                                                 │
│  ┌────────────┐ ┌────────────┐ ┌─────────────┐ ┌──────────┐ ┌──────────┐                      │
│  │ pkg/tty    │ │  pkg/stats  │ │pkg/semverutil│ │pkg/time- │ │pkg/test- │                      │
│  │TTY detect  │ │Statistics  │ │Semver primit.│ │  util    │ │  util    │                      │
│  └────────────┘ └────────────┘ └─────────────┘ └──────────┘ └──────────┘                      │

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

[github-actions]

Pull request created: #29734

🎩 Equipped by Q

[github-actions]

Q Weekly Analysis — 2026-05-02

Runs analyzed: 20 (last 7 days)

✅ No Missing Tools

✅ No Permission Errors

🐛 Bug Fixed

Smoke Crush (run 25248852737) — EROFS: read-only file system when crush downloads its binary at runtime in AWF chroot mode.

→ Fix: PR opened on branch q/fix-crush-erofs-writable-prefix — installs crush to NPM_CONFIG_PREFIX=/tmp/npm-global instead of the read-only global npm prefix.

i️ Investigated, No Action Needed

• Terminal Stylist — 16 "blocked" firewall events were internal error:transaction-end-before-headers health-check connections from ::1, not real outbound blocks.
• Design Decision Gate — Variable turn count (0–5) is expected behavior depending on PR content.

Powered by Q · Run 25248888940

Warning

Firewall blocked 2 domains

The following domains were blocked by the firewall during workflow execution:

• charm.land
• proxy.golang.org

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "charm.land"
    - "proxy.golang.org"

See Network Configuration for more information.

🎩 Equipped by Q · ● 9.6M · ◷