Savvi Studio

Phase 2 Cutover Handoff (2026-03-29)

Status: READY FOR NEXT STAGE Date: 2026-03-29

Scope

This handoff closes the current Phase 2 hard-cutover verification stage and records the minimum evidence required to proceed.

Gate Outcome

  1. Focused gate checks are green.
  2. Post-bundle-refresh revalidation is green.
  3. Broader integration slice is green.

Executed Verification Commands

  1. pnpm vitest run --project integration-tests-node-pglite-memory integration-tests/db-bootstrap.db-contract.test.ts integration-tests/db-migrations.db-contract.test.ts --reporter=dot
  • Result: Test Files 2 passed (2), Tests 10 passed (10), Duration 7.93s.
  1. pnpm vitest run --project integration-tests-node-pglite-memory integration-tests/graph-db-functions.db-contract.test.ts integration-tests/graph.router.test.ts --reporter=dot
  • Result: Test Files 2 passed (2), Tests 19 passed (19), Duration 32.78s.
  1. pnpm vitest run --project integration-tests-node-pglite-memory integration-tests/db-bootstrap.db-contract.test.ts integration-tests/db-migrations.db-contract.test.ts integration-tests/db-error-handling.workflow.test.ts integration-tests/graph-db-functions.db-contract.test.ts integration-tests/graph-access-control.db-contract.test.ts integration-tests/graph.router.test.ts integration-tests/entities-crud.profile.workflow.test.ts --reporter=dot
  • Result: Test Files 7 passed (7), Tests 70 passed (70), Duration 45.09s.

Evidence References

  1. Phase 1 evidence matrix:
  • docs/reference/modules/phase-1-design-freeze-evidence-matrix.md
  1. Phase 2 delta inventory and gate record:
  • docs/reference/modules/phase-2-db-hard-cutover-delta-inventory.md

Closeout Checklist

  • Migration bundle refresh completed and rerun-validated.
  • Fresh bootstrap and migration contract checks green.
  • Graph contract/router checks green after forward fixes.
  • Broader integration slice executed and green.
  • Phase 1 and Phase 2 evidence artifacts updated.
  • Next-stage work package selected and scoped.
  • Next-stage acceptance checks enumerated before implementation.

Next-Stage Work Package (Selected)

Name: Deterministic Constraints and Canonical Graph Contract Alignment.

Bounded scope:

  1. Remove remaining legacy namespace assumptions from high-signal contract tests and assertions.
  2. Align graph access-control contract checks with canonical kind and predicate_path semantics while preserving RLS and policy guarantees.
  3. Keep DB contract surfaces deterministic for IDs and audit patch helpers (no functional regressions).

Primary touchpoints:

  1. integration-tests/graph-access-control.db-contract.test.ts
  2. integration-tests/graph-db-functions.db-contract.test.ts
  3. db forward migration slice for canonical contract cleanup (if required by failing assertions during implementation).

Next-Stage Acceptance Checks (Pre-Edit Baseline)

Acceptance commands to run before and after implementation:

  1. pnpm vitest run --project integration-tests-node-pglite-memory integration-tests/db-ids.db-contract.test.ts integration-tests/db-audit.db-contract.test.ts integration-tests/graph-access-control.db-contract.test.ts --reporter=dot
  2. pnpm vitest run --project integration-tests-node-pglite-memory integration-tests/graph-db-functions.db-contract.test.ts integration-tests/graph.router.test.ts --reporter=dot
  3. pnpm vitest run --project integration-tests-node-pglite-memory integration-tests/db-bootstrap.db-contract.test.ts integration-tests/db-migrations.db-contract.test.ts --reporter=dot

Recorded pre-edit baseline:

  1. Command (1) result: Test Files 3 passed (3), Tests 15 passed (15), Duration 10.43s.

Next Stage Entry Criteria

Proceed when both conditions are true:

  1. A concrete next-stage slice (for example deterministic-model enforcement) is selected and bounded.
  2. The exact verification commands for that slice are written down before edits begin.