docs(roadmap): error-code consolidation and snapshot store landed

[wmadden-electric]

Linked issue

Progress update to ROADMAP.md/ROADMAP.html — no ticket; reflects merged work from TML-3067, TML-3070, TML-3075, TML-3071, TML-3059, TML-3072.

At a glance

Section 3 flips two items to ✅ Landed: One error-code scheme instead of four (all published errors are dotted structural envelopes; 221-code reference page with a per-PR CI completeness check) and Store each contract snapshot once (content-addressed migrations/snapshots/ store). Header counts move to 3 done / 11 in flight / 20 not started; both items join Recently landed. MD and HTML updated together; HTML render verified.

Testing performed

• Visual check of the rendered HTML (header stats, requirement-3 minibar, pills).

Checklist

• All commits are signed off (git commit -s) per the DCO.
• I read CONTRIBUTING.md and the change is scoped to one logical concern.
• Tests are updated. (docs-only)
• The PR title follows the prevailing convention for untracked docs changes.
• Skill update: none required (docs-only, no examples/ or extensions/ files).

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Updated the v8-RC1 roadmap (both ROADMAP.md and ROADMAP.html) with July 23 progress metrics and refreshed task status counts.
  • Revised the error-code consolidation status to delivered, documenting the unified dotted NAMESPACE.SUBCODE scheme and the included 221-code reference with automated validation.
  • Updated contract snapshot storage to landed, including the content-addressed snapshot store layout and one-shot migrator behavior.
  • Added both items to the Recently landed section.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro Plus

Run ID: 72defe0d-8387-46db-80d5-ed10e88d88d8

📥 Commits

Reviewing files that changed from the base of the PR and between c213f6a and 669b6ba.

📒 Files selected for processing (2)

• ROADMAP.html
• ROADMAP.md

🚧 Files skipped from review as they are similar to previous changes (2)

• ROADMAP.html
• ROADMAP.md

---

📝 Walkthrough

Walkthrough

The roadmap documentation reflects July 23 progress, updates v8-RC1 release status counts, and records the unified error-code scheme and content-addressed migration snapshot store as landed in both HTML and Markdown formats.

Changes

Roadmap status refresh

Layer / File(s)	Summary
Release status and progress updates ROADMAP.md, ROADMAP.html	Progress counts, checklist wording, and release-gating text now identify error-code consolidation as landed.
Requirement 3 landed work ROADMAP.md, ROADMAP.html	Requirement 3 and “Recently landed” sections describe the dotted error-code envelope, 221-code CI reference, content-addressed snapshots, ref-paired folding, and one-shot migration.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

• prisma/prisma-next#1028: Updates the same roadmap sections for error-code consolidation and migration snapshot layout.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly matches the main roadmap updates: error-code consolidation and the snapshot store are both marked landed.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/roadmap-progress-error-codes

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[github-actions]

size-limit report 📦

Path	Size
postgres / no-emit	163.84 KB (0%)
postgres / emit	145.96 KB (0%)
mongo / no-emit	100.14 KB (0%)
mongo / emit	89.85 KB (0%)
cf-worker / no-emit	189.44 KB (0%)
cf-worker / emit	169.57 KB (0%)

[pkg-pr-new]

Open in StackBlitz

@prisma-next/extension-author-tools

npm i https://pkg.pr.new/@prisma-next/extension-author-tools@1031

@prisma-next/mongo-runtime

npm i https://pkg.pr.new/@prisma-next/mongo-runtime@1031

@prisma-next/family-mongo

npm i https://pkg.pr.new/@prisma-next/family-mongo@1031

@prisma-next/sql-runtime

npm i https://pkg.pr.new/@prisma-next/sql-runtime@1031

@prisma-next/family-sql

npm i https://pkg.pr.new/@prisma-next/family-sql@1031

@prisma-next/extension-arktype-json

npm i https://pkg.pr.new/@prisma-next/extension-arktype-json@1031

@prisma-next/middleware-cache

npm i https://pkg.pr.new/@prisma-next/middleware-cache@1031

@prisma-next/mongo

npm i https://pkg.pr.new/@prisma-next/mongo@1031

@prisma-next/extension-paradedb

npm i https://pkg.pr.new/@prisma-next/extension-paradedb@1031

@prisma-next/extension-pgvector

npm i https://pkg.pr.new/@prisma-next/extension-pgvector@1031

@prisma-next/extension-postgis

npm i https://pkg.pr.new/@prisma-next/extension-postgis@1031

@prisma-next/postgres

npm i https://pkg.pr.new/@prisma-next/postgres@1031

@prisma-next/sql-orm-client

npm i https://pkg.pr.new/@prisma-next/sql-orm-client@1031

@prisma-next/sqlite

npm i https://pkg.pr.new/@prisma-next/sqlite@1031

@prisma-next/extension-supabase

npm i https://pkg.pr.new/@prisma-next/extension-supabase@1031

@prisma-next/target-mongo

npm i https://pkg.pr.new/@prisma-next/target-mongo@1031

@prisma-next/adapter-mongo

npm i https://pkg.pr.new/@prisma-next/adapter-mongo@1031

@prisma-next/driver-mongo

npm i https://pkg.pr.new/@prisma-next/driver-mongo@1031

@prisma-next/contract

npm i https://pkg.pr.new/@prisma-next/contract@1031

@prisma-next/utils

npm i https://pkg.pr.new/@prisma-next/utils@1031

@prisma-next/config

npm i https://pkg.pr.new/@prisma-next/config@1031

@prisma-next/errors

npm i https://pkg.pr.new/@prisma-next/errors@1031

@prisma-next/framework-components

npm i https://pkg.pr.new/@prisma-next/framework-components@1031

@prisma-next/operations

npm i https://pkg.pr.new/@prisma-next/operations@1031

@prisma-next/ts-render

npm i https://pkg.pr.new/@prisma-next/ts-render@1031

@prisma-next/contract-authoring

npm i https://pkg.pr.new/@prisma-next/contract-authoring@1031

@prisma-next/ids

npm i https://pkg.pr.new/@prisma-next/ids@1031

@prisma-next/psl-parser

npm i https://pkg.pr.new/@prisma-next/psl-parser@1031

@prisma-next/psl-printer

npm i https://pkg.pr.new/@prisma-next/psl-printer@1031

@prisma-next/cli

npm i https://pkg.pr.new/@prisma-next/cli@1031

@prisma-next/cli-telemetry

npm i https://pkg.pr.new/@prisma-next/cli-telemetry@1031

@prisma-next/config-loader

npm i https://pkg.pr.new/@prisma-next/config-loader@1031

@prisma-next/emitter

npm i https://pkg.pr.new/@prisma-next/emitter@1031

@prisma-next/language-server

npm i https://pkg.pr.new/@prisma-next/language-server@1031

@prisma-next/migration-tools

npm i https://pkg.pr.new/@prisma-next/migration-tools@1031

prisma-next

npm i https://pkg.pr.new/prisma-next@1031

@prisma-next/vite-plugin-contract-emit

npm i https://pkg.pr.new/@prisma-next/vite-plugin-contract-emit@1031

@prisma-next/mongo-codec

npm i https://pkg.pr.new/@prisma-next/mongo-codec@1031

@prisma-next/mongo-contract

npm i https://pkg.pr.new/@prisma-next/mongo-contract@1031

@prisma-next/mongo-value

npm i https://pkg.pr.new/@prisma-next/mongo-value@1031

@prisma-next/mongo-contract-psl

npm i https://pkg.pr.new/@prisma-next/mongo-contract-psl@1031

@prisma-next/mongo-contract-ts

npm i https://pkg.pr.new/@prisma-next/mongo-contract-ts@1031

@prisma-next/mongo-emitter

npm i https://pkg.pr.new/@prisma-next/mongo-emitter@1031

@prisma-next/mongo-schema-ir

npm i https://pkg.pr.new/@prisma-next/mongo-schema-ir@1031

@prisma-next/mongo-query-ast

npm i https://pkg.pr.new/@prisma-next/mongo-query-ast@1031

@prisma-next/mongo-orm

npm i https://pkg.pr.new/@prisma-next/mongo-orm@1031

@prisma-next/mongo-query-builder

npm i https://pkg.pr.new/@prisma-next/mongo-query-builder@1031

@prisma-next/mongo-lowering

npm i https://pkg.pr.new/@prisma-next/mongo-lowering@1031

@prisma-next/mongo-wire

npm i https://pkg.pr.new/@prisma-next/mongo-wire@1031

@prisma-next/sql-contract

npm i https://pkg.pr.new/@prisma-next/sql-contract@1031

@prisma-next/sql-errors

npm i https://pkg.pr.new/@prisma-next/sql-errors@1031

@prisma-next/sql-operations

npm i https://pkg.pr.new/@prisma-next/sql-operations@1031

@prisma-next/sql-schema-ir

npm i https://pkg.pr.new/@prisma-next/sql-schema-ir@1031

@prisma-next/sql-contract-psl

npm i https://pkg.pr.new/@prisma-next/sql-contract-psl@1031

@prisma-next/sql-contract-ts

npm i https://pkg.pr.new/@prisma-next/sql-contract-ts@1031

@prisma-next/sql-contract-emitter

npm i https://pkg.pr.new/@prisma-next/sql-contract-emitter@1031

@prisma-next/sql-lane-query-builder

npm i https://pkg.pr.new/@prisma-next/sql-lane-query-builder@1031

@prisma-next/sql-relational-core

npm i https://pkg.pr.new/@prisma-next/sql-relational-core@1031

@prisma-next/sql-builder

npm i https://pkg.pr.new/@prisma-next/sql-builder@1031

@prisma-next/target-postgres

npm i https://pkg.pr.new/@prisma-next/target-postgres@1031

@prisma-next/target-sqlite

npm i https://pkg.pr.new/@prisma-next/target-sqlite@1031

@prisma-next/adapter-postgres

npm i https://pkg.pr.new/@prisma-next/adapter-postgres@1031

@prisma-next/adapter-sqlite

npm i https://pkg.pr.new/@prisma-next/adapter-sqlite@1031

@prisma-next/driver-postgres

npm i https://pkg.pr.new/@prisma-next/driver-postgres@1031

@prisma-next/driver-sqlite

npm i https://pkg.pr.new/@prisma-next/driver-sqlite@1031

commit: 669b6ba

[coderabbitai]

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@ROADMAP.html`:
- Around line 416-418: Update the snapshot-store wording in ROADMAP.html lines
416-418 and ROADMAP.md lines 130-132 to describe one content-addressed snapshot
entry per distinct contract, replacing “one file per distinct contract.” Keep
the surrounding migration and hashing details unchanged.
- Line 276: Reconcile the July 22 minimum-supported-Postgres gate in the
release-gating content: update ROADMAP.html lines 276-276 and ROADMAP.md lines
18-18 consistently by either removing the gate if resolved or explicitly marking
it overdue/currently blocking; preserve the July 24 polymorphism and
scoreboard-freeze details.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: CHILL

Plan: Pro Plus

Run ID: af8ae74f-ca0a-4621-9b7e-0dfd92853363

📥 Commits

Reviewing files that changed from the base of the PR and between ab6b60f and c213f6a.

📒 Files selected for processing (2)

• ROADMAP.html
• ROADMAP.md