Skip to content

docs(architecture): refresh current-system architecture to main@d3462a5 - #176

Merged
coreytshaffer merged 1 commit into
mainfrom
claude/architecture-refresh-d3462a5
Aug 13, 2026
Merged

docs(architecture): refresh current-system architecture to main@d3462a5#176
coreytshaffer merged 1 commit into
mainfrom
claude/architecture-refresh-d3462a5

Conversation

@coreytshaffer

Copy link
Copy Markdown
Owner

Summary

Bounded one-file refresh of docs/architecture/current_system_architecture.md, from exact base d3462a578b8bdf15d012a8aa1d4e1962520e7c3f, applying five frozen section replacements derived from a read-only repository census. The page's own stated rule is to re-verify when its pin changes; it had been pinned to 1c2d6242 (2026-08-01) while main advanced 86 commits.

The five sections:

  1. Status and Verification Basis — re-pinned to d3462a5 (2026-08-12). Records the 86-commit advance, notes most of it was governance/documentation work not bearing on topology, and names the architecture-relevant runtime/config changes: CR-DD-014 explicit local route-to-model binding (incl. the [capability] block now in triagecore.toml), CR-DD-017 blocked-route evidence parity, CR-DD-018 specialist-offload evidence. CR-DD-016 is explicitly recorded as documentation/CLI-help only — verified against its commit, whose sole runtime-file change is argparse help text.
  2. tc run Integration Status row — adds explicit local model binding, the ProjectSteward sensitive-context boundary, and route/worker evidence persistence. Kept architectural; event-type and schema detail stays in Authoritative Sources and lower-level docs rather than the table.
  3. Key Separation Rule 2 — capability resolution now also resolves an explicit route-to-model binding. Deliberately scoped to the governed tc run path: client.py:135-139 still selects route_decision["model"] when a direct TriageClient caller passes capability=None, and the fail-closed gate at client.py:307 is guarded by capability is not None.
  4. Authoritative Sources Verified — adds routers.py, routing/route_events.py, project_steward.py + policies/cybernetic_ecology_boundary.yaml, run_plan.py, CapabilityResolution.model_for_route, and six focused test files including test_tc_run_cli.py (asserts capability_route_binding_issues on runner_selected) and test_tc_run_plan_cli.py (asserts the run_plan model-binding forecast).
  5. Limitations and Drift — records SVG drift and governed_run_flow.md's older 6d585268 pin as descriptive facts only.

Deliberately out of scope: regenerating current_system_architecture.svg, re-verifying governed_run_flow.md, and any Progressive Zoom addition. None of those files are touched.

Test plan

  • Diff touches exactly one file: docs/architecture/current_system_architecture.md.
  • Every removed line audited — all 14 belong to one of the five authorized "Remove" blocks; no stray deletions. (Renders as 6 hunks, not 5: the Authoritative Sources edit necessarily splits into two because unchanged list entries sit between its two modified regions.)
  • Byte-compared against base: ## Progressive Zoom and ## Non-Claims sections IDENTICAL.
  • Excluded paths confirmed untouched: the SVG, governed_run_flow.md, README.md, AGENTS.md, triagecore.toml, triage_core/client.py, docs/current_backlog.md, docs/change/change_log.md.
  • Evidence pin present as d3462a5 in both the header and Limitations; the sole remaining 1c2d6242 mention is the intentional "replacing the prior pin" historical reference.
  • git diff --check clean (exit 0) — no whitespace or formatting churn.
  • Every cited symbol, file, and test independently verified present at the base.
  • Branch created fresh from the authorized base, verified unchanged immediately before creation.

No test-suite run — documentation-only change; no runtime, config, or test file touched.

🤖 Generated with Claude Code

Bounded one-file refresh under explicit implementation authority, from
exact base d3462a5. Five frozen
section replacements, derived from a read-only repository census:

- Status and Verification Basis: re-pin from 1c2d624 (2026-08-01) to
  d3462a5 (2026-08-12). Records that main advanced 86 commits, most of
  it governance/documentation work, and names the architecture-relevant
  runtime/config changes as CR-DD-014 model binding (including the
  [capability] block now in triagecore.toml), CR-DD-017 blocked-route
  evidence parity, and CR-DD-018 specialist-offload evidence. CR-DD-016
  is recorded as documentation/CLI-help only, not a topology change.
- tc run Integration Status row: adds explicit local model binding, the
  ProjectSteward sensitive-context boundary, and route/worker evidence
  persistence to the stated sequence. Kept architectural; event-schema
  detail stays in lower-level docs and tests.
- Key Separation Rule 2: capability resolution now also resolves an
  explicit route-to-model binding. Scoped to the governed tc run path,
  since a direct TriageClient caller passing capability=None still
  selects route_decision["model"].
- Authoritative Sources Verified: adds routers.py, routing/route_events.py,
  project_steward.py + the policy YAML, run_plan.py, model_for_route, and
  six focused test files.
- Limitations and Drift: records SVG drift and governed_run_flow.md's
  older 6d58526 pin as descriptive facts.

Regenerating the SVG, re-verifying governed_run_flow.md, and any
Progressive Zoom addition remain separate, unauthorized work; neither
file is touched here. Claim Supported, other Integration Status rows,
Authority and Persistence, Key Separation Rules 1/3/4/5/6, Progressive
Zoom, and Non-Claims are byte-identical to the base.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@netlify

netlify Bot commented Aug 13, 2026

Copy link
Copy Markdown

Deploy Preview for poetic-quokka-0fd859 ready!

Name Link
🔨 Latest commit 9c378ed
🔍 Latest deploy log https://app.netlify.com/projects/poetic-quokka-0fd859/deploys/6a7d63297416d00008e93605
😎 Deploy Preview https://deploy-preview-176--poetic-quokka-0fd859.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coreytshaffer
coreytshaffer merged commit 770d9f2 into main Aug 13, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant