Skip to content

[architecture] Update architecture diagram - 2026-06-22 #40769

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pelikhan merged 1 commit into from
Jun 22, 2026
+9 −5
Merged

[architecture] Update architecture diagram - 2026-06-22 #40769

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 9 additions & 5 deletions scratchpad/architecture.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Architecture Diagram

> Last updated: 2026-06-15 · Source: [Workflow run §27540847547](https://github.com/github/gh-aw/actions/runs/27540847547)
> Last updated: 2026-06-22 · Source: [Workflow run §27946410822](https://github.com/github/gh-aw/actions/runs/27946410822)

## Overview

Expand Down Expand Up @@ -52,6 +52,9 @@ CLI entry points → core packages (cli, workflow, parser, console) → domain h
│ ┌──────────────────────────────────────────────────────────────────────────────────┐ │
│ │ github — GitHub label ↔ objective-value mapping (configurable audit scoring) │ │
│ └──────────────────────────────────────────────────────────────────────────────────┘ │
│ ┌──────────────────────────────────────────────────────────────────────────────────┐ │
│ │ intent — PR intent attribution resolver (maps PRs to issues/objectives) │ │
│ └──────────────────────────────────────────────────────────────────────────────────┘ │
├──────────────────────────────────── UTILITY PACKAGES ────────────────────────────────────┤
│ │
│ ┌──────────┐ ┌─────────┐ ┌────────────┐ ┌────────┐ ┌─────────┐ ┌──────────┐ │
Expand All @@ -62,10 +65,9 @@ CLI entry points → core packages (cli, workflow, parser, console) → domain h
│ │ jsonutil │ │ repoutil │ │semverutil│ │ sliceutil│ │syncutil│ │ timeutil │ │ tty │ │
│ └──────────┘ └──────────┘ └──────────┘ └─────────┘ └────────┘ └──────────┘ └─────┘ │
│ │
│ ┌──────────┐ ┌──────────┐ ┌───────────────────────────────┐ ┌──────────────────┐ │
│ │ typeutil │ │ styles │ │ importinpututil │ │ testutil │ │
│ └──────────┘ └──────────┘ │ import path/sub-key resolver │ │ (test-only) │ │
│ └───────────────────────────────┘ └──────────────────┘ │
│ ┌──────────┐ ┌──────────┐ ┌─────────┐ ┌────────────────────────────┐ ┌──────────────┐ │
│ │ typeutil │ │ styles │ │ setutil │ │ importinpututil │ │ testutil │ │
│ └──────────┘ └──────────┘ └─────────┘ └────────────────────────────┘ └──────────────┘ │
Comment on lines +68 to +70
└──────────────────────────────────────────────────────────────────────────────────────────┘
```

Expand All @@ -81,6 +83,7 @@ CLI entry points → core packages (cli, workflow, parser, console) → domain h
| `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) |
Expand All @@ -95,6 +98,7 @@ CLI entry points → core packages (cli, workflow, parser, console) → domain h
| `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 |
Expand Down