Skip to content

docs(change): propose CR-132 triagecore CLI architecture accounting - #166

Open
coreytshaffer wants to merge 2 commits into
mainfrom
cr-132-triagecore-cli-architecture-accounting
Open

docs(change): propose CR-132 triagecore CLI architecture accounting#166
coreytshaffer wants to merge 2 commits into
mainfrom
cr-132-triagecore-cli-architecture-accounting

Conversation

@coreytshaffer

@coreytshaffer coreytshaffer commented Aug 12, 2026

Copy link
Copy Markdown
Owner

Summary

  • Proposal-only CR. docs/architecture/current_system_architecture.md claims repository-level current architecture but its verified-source list and integration table omit the packaged triagecore CLI surface (triage_core/cli.py) entirely, even though pyproject.toml packages it as a second console script alongside tc.
  • triagecore is a large surface — a read-only census found 19 top-level commands (desk, audit, codex-task, antigravity-task, init-agents, install-desktop, push-task, benchmark, benchmark-report, propose-lessons, review-lesson, import-learning-seeds, record-supervisor-review, import-supervisor-usage, scan-supervisor-usage, run-pipeline, stability-pass, stats, lab with report/export/train subcommands). Supervisor review and the TriageDesk "Worker Council" path are the two motivating findings that surfaced the gap, not an exhaustive description of the binary — the eventual documentation scope must account for the full command surface, not stop at those two rows.
  • Supervisor review (record-supervisor-review/scan-supervisor-usage/import-supervisor-usage) is real, working, tested, and already documented operationally (docs/verification_guide.md §6, docs/evidence_schema.md) — just missing from the architecture map.
  • The Worker Council path is present and wired but currently non-operational for its configured roles, through two distinct mechanisms depending on input size: a WorkerRegistry exact-key lookup miss for non-chunked inputs (UI requests repo_mapper/code_repair/validator; registry only exposes context_planner/test_stubber/review_worker/implementer), versus zero work orders ever being queued at all for chunked inputs (the chunking branch only recognizes context_planner/implementer role names, so the registry lookup is never reached). Both are established by direct code-path reading, not by an existing regression test — tests/test_orchestration.py and tests/test_ui_smoke.py do not reproduce either failure mode.
  • Grants no implementation, design, or merge authority. Deliberately excludes fixing the runtime role-mapping defect — that is scoped out as a separate, later runtime-defect CR.

Test plan

  • Human review of the CR-132 proposal scope, exclusions, CLI census, and corrected two-mechanism problem statement.
  • Confirm the CR namespace census (CR-132 non-colliding) still holds at review time.
  • No code/test/schema changes to verify — documentation-only, proposal-only commits.

🤖 Generated with Claude Code

Proposal-only. Records that current_system_architecture.md claims
repository-level current architecture but its verified-source set and
integration table omit the packaged triagecore CLI surface entirely,
hiding a working supervisor-review subsystem and a currently
non-operational Worker Council path (UI requests repo_mapper/
code_repair/validator; WorkerRegistry exposes only context_planner/
test_stubber/review_worker/implementer). Grants no implementation,
design, or merge authority, and deliberately excludes the runtime
role-mapping defect from this documentation-accounting scope.

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

netlify Bot commented Aug 12, 2026

Copy link
Copy Markdown

Deploy Preview for poetic-quokka-0fd859 ready!

Name Link
🔨 Latest commit 18efe3c
🔍 Latest deploy log https://app.netlify.com/projects/poetic-quokka-0fd859/deploys/6a7c53d548022f00084851f4
😎 Deploy Preview https://deploy-preview-166--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.

…dence labels

Corrective proposal-only commit, per bounded corrective authority from
PR head ce13627. Three substantive fixes:

- Add a read-only census of all top-level triagecore commands (desk,
  audit, codex-task, antigravity-task, init-agents, install-desktop,
  push-task, benchmark, benchmark-report, propose-lessons,
  review-lesson, import-learning-seeds, record-supervisor-review,
  import-supervisor-usage, scan-supervisor-usage, run-pipeline,
  stability-pass, stats, lab). Supervisor review and Worker Council
  are the two motivating findings, not an exhaustive account of the
  binary; the eventual documentation scope now requires grouping the
  full command set rather than stopping at those two rows.
- Replace the single "lookup always misses" Worker Council mechanism
  with the two mechanisms orchestration.py actually has: a registry
  lookup miss for non-chunked inputs, versus zero work orders ever
  queued (lookup never reached) for chunked inputs, since the chunked
  branch only recognizes context_planner/implementer role names.
- Relabel tests/test_ui_smoke.py and tests/test_orchestration.py
  accurately: neither reproduces the GUI's mismatched
  repo_mapper/code_repair/validator dispatch, so the defect is
  code-path evidence, not a regression-test result.

Also rephrases the namespace-census note so the 6f5970d
architecture-mapping commit is cited as prior comparable work, not as
plain-numeric-lineage precedent (it was never a CR).

No runtime, test, schema, CLI, worker-registry, orchestration, UI, or
skill-file change. No edit to current_system_architecture.md. Two-lane
separation and all prior exclusions preserved.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
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