Skip to content

Refresh standing docs for test DBs, owners, and Feature Map CI - #160

Merged
kody-bot merged 3 commits into
mainfrom
cursor/docs-freshness-kentcdodds-mediarss-e35e
Oct 30, 2026
Merged

kody-bot merged 3 commits into
mainfrom
cursor/docs-freshness-kentcdodds-mediarss-e35e

Conversation

@kentcdodds

@kentcdodds kentcdodds commented Oct 30, 2026 •

Copy link
Copy Markdown
Owner

Intent

Bring standing docs in line with how MediaRSS works now: throwaway test databases need an explicit migrate, primitive owners that were missing, git hook checks (not auto-fix), and the Feature Map’s CI path.

Door: two-way

Cleanup: none

Why

A docs-freshness pass after #155. No product changelog language was left. The remaining drift was accuracy: contributing still implied the shared db was ready to query, primitives omitted crypto.ts / filter.ts / rate-limiter.ts and the analytics SQLite batch env, AGENTS.md read as if hooks auto-fixed format and lint, and the Feature Map banner said CI runs map --check.

Testing

  • npm run validate — format, lint, typecheck, 45 files / 306 tests (including Feature Map check). 3 pre-existing lint warnings, 0 errors.
  • Cross-checked claims against test/global-setup.ts, app/db/test-database.ts, route tests that await migrateDatabase(db), app/helpers/crypto.ts, app/helpers/filter.ts, app/helpers/rate-limiter.ts, app/assets.ts, app/routes/admin/api/media-analytics.$path.ts, .githooks/pre-commit, tools/feature-map.ts, and .github/workflows/publish.yml.

No runtime or UI behavior change. Could not verify in a browser because this is docs-only.

System recap

Risk: low Touches:

  • docs/contributing.md, AGENTS.md
  • docs/primitives.md
  • Feature Map generator and notes (tools/feature-map.ts, tools/feature-notes.ts)

(extends)

  • Contributing names migrateDatabase(db) for shared-db route tests and the remove-accents browser shim.
  • Primitives name id/token minting, directory-feed filters, the rate-limit token bucket, and MEDIA_ANALYTICS_MAX_SQLITE_VARIABLE_NUMBER.
  • AGENTS.md says hooks run format and lint checks.
  • Feature Map banner matches the control skill: CI checks the map through npm test. The /health note names the MCP protocol field.
Open in Web Open in Cursor 

Note

Low Risk
Documentation and generated Feature Map text only; no application code or behavior changes.

Reviewed by Cursor Bugbot for commit 9c4bb94. Bugbot is set up for automated code reviews on this repo. Configure here.

cursoragent and others added 3 commits October 30, 2026 09:06
Hooks run format and lint checks (not auto-fix). Route tests that import
the shared db must migrate the throwaway DATABASE_PATH first. Name the
in-tree remove-accents browser shim.

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>
crypto.ts mints ids and tokens, filter.ts owns directory-feed filterIn
and filterOut, rate-limiter.ts is the token bucket, and
MEDIA_ANALYTICS_MAX_SQLITE_VARIABLE_NUMBER is a process.env read outside
the startup schema.

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>
CI checks the map through npm test, not the control CLI map --check
subcommand. The /health summary now names the MCP protocol field that
the snapshot already returns.

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>
@coderabbitai

coderabbitai Bot commented Oct 30, 2026

Copy link
Copy Markdown

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 59 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: c5de2c49-dfca-46f1-b964-9c1d039786da
Commits

Reviewing files that changed from the base of the PR and between ae948be and 9c4bb94.

Files selected for processing: 6
  • .agents/skills/control-mediarss/references/feature-map.md
  • AGENTS.md
  • docs/contributing.md
  • docs/primitives.md
  • tools/feature-map.ts
  • tools/feature-notes.ts
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@kody-bot
kody-bot merged commit 1c970ce into main Oct 30, 2026
6 checks passed
@kody-bot
kody-bot deleted the cursor/docs-freshness-kentcdodds-mediarss-e35e branch October 30, 2026 09:11
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.

3 participants