feat(db): migration runner and core schema

[thewrz]

Summary

• Installs node-pg-migrate@8.0.4 as dev dependency
• Implements pnpm migrate and pnpm migrate:down (previously stubs that echoed and exited)
• Creates 4 reversible TypeScript migrations: csi_sections, specs, paragraphs, paragraph_versions with FK constraints, CASCADE deletes, and indexes
• Fixes pre-existing bug in src/db/index.test.ts: static import of ./index.js triggered env validation → process.exit(1) during unit tests; fixed by mocking ../lib/env.js via vi.mock (hoisted before static imports)

Deviations from plan

node-pg-migrate v8 changed the CLI API. The plan specified --ts-runner tsx --migration-file-language ts but v8 uses --tsx (boolean flag). Updated scripts accordingly.

Test plan

• DATABASE_URL=postgres://specr:specr@localhost:5432/specr pnpm migrate — expect "Migrations complete!" after running all 4
• DATABASE_URL=postgres://specr:specr@localhost:5432/specr pnpm migrate:down — rolls back 004_create_paragraph_versions only
• Re-run pnpm migrate — re-applies 004 cleanly
• pnpm lint — ESLint + tsc + prettier all pass
• pnpm test — 5 test files, 15 tests, all pass
• CI green

Summary by CodeRabbit

• New Features

  • Added database migrations to create tables for sections, specs, paragraphs, and paragraph versioning.

• Tests

  • Made database connection tests deterministic with improved mocking and consistent error handling.

• Chores

  • Replaced placeholder migration commands with real migration CLI invocations and added the migration tool to dev dependencies; expanded pnpm config formatting.

[coderabbitai]

Warning

Rate limit exceeded

@thewrz has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 2 minutes and 32 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Free

Run ID: 394e0bd5-bc0f-43df-b00b-04c2cd94b5f3

📥 Commits

Reviewing files that changed from the base of the PR and between c03391c and 1bfb8cb.

📒 Files selected for processing (1)

• vitest.config.ts

📝 Walkthrough

Walkthrough

Adds node-pg-migrate CLI scripts, four reversible DB migrations (csi_sections, specs, paragraphs, paragraph_versions), and refactors DB test mocks to use a hoisted pg.Pool mock and shared mocked pool for pingDatabase tests.

Changes

Database Schema Migrations & Setup

Layer / File(s)	Summary
Migration Tooling Configuration package.json	Adds node-pg-migrate ^8.0.4 to devDependencies; replaces placeholder migration scripts with node-pg-migrate CLI invocations targeting --migrations-dir src/db/migrations; reformats pnpm.onlyBuiltDependencies.
Base Table Definitions src/db/migrations/001_create_csi_sections.ts, src/db/migrations/002_create_specs.ts	Creates csi_sections (UUID id, unique section_number, title, division, created_at, index on division) and specs (UUID id, section, source, title, created_at, updated_at) with down migrations.
Paragraph Hierarchy src/db/migrations/003_create_paragraphs.ts	Creates paragraphs table with UUID id, spec_id FK (CASCADE), optional parent_id self-FK, metadata/content fields (node_type, text, position, vanish, revit_param, base_version), timestamps, and indexes; includes down migration.
Paragraph Version Tracking src/db/migrations/004_create_paragraph_versions.ts	Creates paragraph_versions table with UUID id, paragraph_id FK (CASCADE), version, text, node_type, snapshot_at, and unique index on (paragraph_id, version); includes down migration.
Test Mocking & Verification src/db/index.test.ts	Mocks environment variables before module evaluation; adds a top-level vi.mock('pg') returning a shared mocked Pool with query/end/on spies; introduces getPool() helper and updates tests to reuse the shared mock and assert SELECT 1, error mapping to DatabaseError, and cause preservation.

Estimated Code Review Effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Poem

A rabbit hops through migrations neat,
Four tables set in tidy rows,
Tools in paw to make them meet,
Tests that mock where river flows.
Hooray — the schema softly grows! 🐰✨

---

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}