Skip to content

docs: archive finished plans, verified open points; Tutor free fallback on GitHub outage - #239

Merged
ttbombadil merged 3 commits into
mainfrom
docs/cleanup-plans
Oct 11, 2026
Merged

ttbombadil merged 3 commits into
mainfrom
docs/cleanup-plans

Conversation

@ttbombadil

Copy link
Copy Markdown
Collaborator

Summary

Documentation cleanup

  • Delete the implemented docs/superpowers/ plans/specs and docs/audits/ (kept in git history).
  • Archive all Tutor-Quality plans and reports (incl. the historical Stage-2B SSOT) under docs/archive/tutor-quality/.
  • Archive the completed refactoring series (health review + full OPL) under docs/archive/refactoring/.
  • New docs/OPEN_POINTS.md: only open points, each re-verified against main @ 4dcc1ae9 with code references. No open point is rated high. R10-PIN (already fixed in fff4be669) and T5/D3 are closed.
  • Naming: capacity docs share the CAPACITY_ prefix (CAPACITY_MODEL.md, CAPACITY_MIXED_LOAD_TESTING.md, CAPACITY_HISTORICAL_PHASE_3_4.md); README_UbuntuServer.md → docs/INSTALL_UBUNTU_VBOX.md. docs/README.md documents the convention and indexes capacity, open points and archive.
  • calibrate-capacity-cli.test.ts only follows the renamed path docs/CAPACITY_MODEL.md (approved by the owner).

T5 – Tutor during a GitHub outage

  • When the Course Content source cannot be refreshed (SOURCE_UNAVAILABLE, RATE_LIMITED, LOAD_CAPACITY_EXCEEDED), Tutor question/dialog requests now answer as the free Tutor without a Course Content session instead of failing with 400 INVALID_REQUEST. This implements Course Content SSOT §11, case G.
  • New route test (RED without the change, GREEN with it) for all three codes; no existing test changed.

Test plan

  • ./run-tests.sh – all 11 stages green (unit, toolchain, Docker, E2E 27/27, build, audit, Sonar gate)
  • npm run check:docs
  • Pre-push hook incl. fresh Sonar scan (first attempt flagged S3776, fixed in 296bc406)

🤖 Generated with Claude Code

ttbombadil and others added 3 commits October 11, 2026 20:06
Delete the implemented superpowers plans and audit, archive the tutor-quality
plans and reports and the completed refactoring series, and replace the OPL
with OPEN_POINTS.md. Group capacity documents under the CAPACITY_ prefix and
move the Ubuntu VirtualBox guide to docs/INSTALL_UBUNTU_VBOX.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ilable

Course Content SSOT section 11 case G: when GitHub cannot refresh the
current revision, Tutor requests answer without a Course Content session
instead of failing with INVALID_REQUEST.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Keeps resolveTutorContent within the cognitive complexity limit (Sonar S3776).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ttbombadil
ttbombadil merged commit 010c16d into main Oct 11, 2026
6 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