Skip to content

docs: fix stale line counts, version, endpoint name, and architecture narrative (#872)#886

Draft
vivekchand wants to merge 1 commit intomainfrom
bot-fix/issue-872-docs-drift-2026-05-05
Draft

docs: fix stale line counts, version, endpoint name, and architecture narrative (#872)#886
vivekchand wants to merge 1 commit intomainfrom
bot-fix/issue-872-docs-drift-2026-05-05

Conversation

@vivekchand
Copy link
Copy Markdown
Owner

Summary

Fixes all items flagged in the weekly docs-drift sweep (#872). All three doc files still described the old single-file monolith; this PR brings them in sync with the current per-feature Blueprint layout and actual file sizes.

Changes

CLAUDE.md

  • Update five stale line-count figures: dashboard.py 25,400→15,013; routes/sessions.py 1,190→1,556; routes/brain.py 800→1,027; clawmetry/sync.py 3,000→3,876; clawmetry/config.py 58→79
  • Replace /api/brain endpoint entry with the two actual routes: /api/brain-history + /api/brain-stream
  • Bump __version__ reference from 0.12.990.12.162

ARCHITECTURE.md

  • Rewrite the "Single-File Architecture" section to describe the per-feature Blueprint layout (the single-file claim has been architecturally false since routes/ was introduced)
  • Fix history.py snapshot cadence: "5 minutes" → "60 seconds" (matches POLL_INTERVAL = 60 in the code)

CONTRIBUTING.md

  • Update "Make Changes & Test" step to mention routes/<feature>.py alongside dashboard.py
  • Expand project-structure tree to include routes/ and clawmetry/ directories
  • Replace the "Breaking the single-file architecture" avoid-bullet with the accurate equivalent
  • Update Philosophy paragraph to match the current layout

Test plan

  • make lint — no Python files changed, syntax check passes unchanged
  • Read each updated section and confirm numbers match wc -l output on the actual files
  • Confirm routes/brain.py has no /api/brain route (only /api/brain-history and /api/brain-stream)
  • Confirm dashboard.py __version__ is 0.12.162

Bot meta

Draft PR opened autonomously based on the plan in #872. Marked draft for human review — mark Ready for Review once happy.

Closes #872


Generated by Claude Code

… narrative (#872)

CLAUDE.md: update five line-count figures (dashboard.py 25400→15013,
sessions.py 1190→1556, brain.py 800→1027, sync.py 3000→3876,
config.py 58→79); rename /api/brain endpoint to /api/brain-history +
/api/brain-stream; bump __version__ reference 0.12.99→0.12.162.

ARCHITECTURE.md: rewrite stale "Single-File Architecture" section to
describe the per-feature Blueprint layout; fix history.py snapshot
cadence claim (5 minutes → 60 seconds).

CONTRIBUTING.md: update "Make Changes & Test" step, project-structure
tree (add routes/ and clawmetry/ dirs), "What to Avoid" bullet, and
the Philosophy paragraph — all four still referenced the old monolithic
single-file model that was replaced by routes/ modules.

Closes #872

Co-Authored-By: ClawMetry Autofix Bot <bot-autofix@clawmetry.dev>
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.

Docs drift -- 2026-05-05

1 participant