Skip to content

docs: sync maintainer docs, README, and reserved-code comments with code#22

Merged
BillDuke13 merged 1 commit into
memenow:mainfrom
BillDuke13:docs/sync-with-code
May 29, 2026
Merged

docs: sync maintainer docs, README, and reserved-code comments with code#22
BillDuke13 merged 1 commit into
memenow:mainfrom
BillDuke13:docs/sync-with-code

Conversation

@BillDuke13

Copy link
Copy Markdown
Member

Summary

Sync the maintainer documentation, README, and reserved-code comments with the current code at HEAD 529e6c6, and add the new docs/ tree.

Related

  • Not applicable

Updates

Item From To Notes
docs/ tree (none) architecture, configuration, deployment, security + index New maintainer-facing docs, verified against source
CLAUDE.md drifted src/config.ts line refs (:97/:66/:107) stable symbol references Line numbers rot on every upstream sync
README.md no HTTP auth vars; base64 image note auth env vars + image v2 note + docs links Match code and the v2 response schema
src/{utils,constants,helpers}.ts unannotated dead code "Reserved: not wired up" comments checkRateLimit, RATE_LIMIT, registerSigIntHandler

Details

Sync docs and comments with code

  • Design/Spec: docs/README.md records the source-of-truth policy (code wins; re-derive from src/config.ts)
  • Implementation notes: removed all file.ts:N line refs from CLAUDE.md in favor of symbol references; precision fixes in docs/architecture.md (all three Brave request headers, /mcp is app.all, the real Brave Search API request failed: throw prefix) and docs/security.md
  • Reviewer focus: docs/ accuracy vs src/{config,worker,worker-auth,protocols,BraveAPI}; the three reserved-code comments

Testing

  • npm run format:check -- pass
  • npm run lint -- 0 errors (8 pre-existing upstream warnings)
  • npm run build -- pass
  • Manual steps: Not run (no test framework; comments/docs only, behavior unchanged)

Screenshots / Notes

  • Not applicable

Breaking changes

  • Not applicable

Risks and rollout

  • Docs/comment-only change, no runtime behavior change -- low risk

Checklist

  • Tests added/updated if needed (N/A — no framework; format/lint/build pass)
  • Docs updated if needed
  • Backward compatibility considered (no behavior change)
  • Rollout/monitoring considerations noted

- docs/: add the maintainer docs tree (architecture, configuration,
  deployment, security + index), verified against the code at HEAD 529e6c6
- CLAUDE.md: replace drifted src/config.ts line refs (:97/:66/:107) with
  stable symbol references; add docs/ pointers and the HTTP auth env vars
- README.md: document BRAVE_MCP_AUTH_TOKEN / ALLOWED_HOSTS / ALLOWED_ORIGINS,
  the image_search v2 response change, and link the docs/ tree
- src/{utils,constants,helpers}.ts: mark checkRateLimit, RATE_LIMIT, and
  registerSigIntHandler as reserved / not wired up
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@BillDuke13 BillDuke13 merged commit f82df72 into memenow:main May 29, 2026
12 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