Skip to content

Correct stale docs and comments - #35

Merged
kurtseifried merged 2 commits into
mainfrom
docs/fix-drift
Sep 25, 2026
Merged

kurtseifried merged 2 commits into
mainfrom
docs/fix-drift

Conversation

@kurtseifried

Copy link
Copy Markdown
Contributor

Summary

Documentation and comment drift found in the review, plus items the coordinator raised.

  • CLAUDE.md
    • src/registry.ts is described correctly: a gitignored, test-only snapshot. It is not a runtime "fallback".
    • The config file is wrangler.toml, not wrangler.jsonc.
    • SecID-Server-API is listed as "Python; TypeScript and Docker planned".
    • The ~1,150 keys count is replaced with a description of what the keys are.
    • The deploy chain now names SecID's registry-ci.yml and the validated-SHA client_payload.ref, from SecID #198.
  • README
    • Counts now read "more than 2,100", not 1,150+. Current count is 2,138 across 10 types. The wording is a floor so it ages better than an exact number.
    • The edge-throttling line no longer claims controls this repo can't show. It points to ADR-012 and says the WAF configuration lives in the Cloudflare dashboard.
    • The body-limit line no longer ties the 64 KiB cap to Content-Length.
  • OPERATIONAL-RESOURCES.md
    • Stage 1 is now registry-ci.yml, which replaced update-registry.yml.
    • Status changes from "broken since 2026-04-30" to working, backed by the successful repository_dispatch runs on 2026-09-25.
  • Website and MCP secid://registry description: 700+ is gone. The MCP resource description now points to the resource's own live counts instead of hardcoding one.
  • Code comments: all 8 types, seven and (×7) are reworded so they don't depend on the type count.
  • Deleted repos: I searched every tracked file for SecID-Client (other than -SDK) and SecID-Website. There are no mentions, so nothing to change.

Handled elsewhere:

Historical records (FRICTION-001, docs/superpowers/plans) are left as written.

Test plan

  • No behaviour change. tsc is clean in src/, and only comment and description strings changed in code.

- CLAUDE.md: src/registry.ts is a gitignored test-only snapshot, not a runtime
  fallback; wrangler.toml, not wrangler.jsonc; SecID-Server-API is Python only
  (TypeScript/Docker planned); KV key count described instead of a stale
  number; deploy chain names registry-ci.yml and the validated-SHA payload.
- README: counts updated (more than 2,100 namespaces); the edge-throttling
  line no longer claims controls this repo cannot show; body-limit line no
  longer ties the cap to Content-Length.
- OPERATIONAL-RESOURCES: registry-ci.yml replaces update-registry.yml; the
  deploy chain is working again, not broken.
- Website and MCP resource description: drop 700+; the registry resource
  now points to its own live counts.
- Comments: 'all 8 types', 'seven', '(x7)' become type-count-neutral.
@kurtseifried
kurtseifried merged commit 48e90e7 into main Sep 25, 2026
1 check passed
@kurtseifried
kurtseifried deleted the docs/fix-drift branch September 25, 2026 03:39
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