docs: sync docs with actual stack - #890
Merged
Merged
Conversation
Truth-sweep of the living docs against repo ground truth (pnpm 11.25.0, Node 24, Vitest, zod 4, TS 6, Next 16/React 19, self-hosted Supabase with file-based migrations applied on deploy): - npm/npx commands -> pnpm / pnpm exec / pnpm dlx; `run X -- --flag` loses the `--`; package-lock.json -> pnpm-lock.yaml - jest -> Vitest (config names, vi.fn/vi.spyOn, reporter examples, debug commands, framework mentions) - retired mcp_supabase_* examples -> current mechanisms: PostgREST reads, migrations as supabase/migrations/*.sql applied on deploy, box psql for DDL - version claims: TypeScript 5.x -> 6.x, Node 20 -> 24, Next.js 15 -> 16, React 18 -> 19; CI described as Node 24 + pnpm - nonexistent scripts replaced with real ones (test:comprehensive:* -> test:*, diag:supabase -> scripts/diagnostics/*, db:migrate/test: migration -> deploy-applied migrations / migration-replay.yml) - infrastructure.md deploy claim fixed: cd.yml deploys main after green CI (doc said pushes to main do NOT deploy) - zod 4 API: z.record now takes key+value schemas Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WqKqMnHQHSmkGFfc5t7Rxn
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Truth-sweep of the living docs against repo ground truth. Every edit verified against package.json / workflows / installed config before changing.
Drift fixed (claim → ground truth):
pnpm exec(declared deps) /pnpm dlx(one-offs);npm run X -- --flag→pnpm run X --flag; package-lock.json → pnpm-lock.yaml (packageManager pnpm@11.25.0)vitest.config.ts/vitest.setup.ts),vi.fn/vi.spyOn, reporter example, debug commands, framework mentionsmcp_supabase_*examples (marked legacy by .claude/CLAUDE.md itself) → current mechanisms: PostgREST reads, migrations assupabase/migrations/*.sqlapplied on deploy byscripts/apply-migrations.sh, box psql for DDLdocs/operations/devops/infrastructure.mdclaimed pushes to main do NOT deploy — cd.yml deploys after green CI; fixedtest:comprehensive:*→test:*,diag:supabase*→scripts/diagnostics/*,db:migrate/test:migration→ deploy-applied migrations +migration-replay.yml,test:env→pnpm test tests/env.test.ts, jest-only flags (--testNamePattern) → vitest-tz.record(z.unknown())→z.record(z.string(), z.unknown())(matches src usage)Skipped as historical record: docs/archive/**, dated audits/sprint summaries/business plans, session logs.
Note:
.ai-guides/*.mdsymlinks on main dangle (targetdocs/guides/ai/doesn't exist; real path isdocs/development/guides/ai/) — left untouched, flagging for a follow-up.🤖 Generated with Claude Code