prismatica 0.2.0 → 0.3.1

package/dist/guide.js

@@ -1466,7 +1466,12 @@ longer matches — \`flow list\` shows it as tampered, immediately. Nothing abou
 truth changes silently. Status and evidence are excluded from that fingerprint
 on purpose: flipping "planned" to "works now" or marking a step verified
 should never need a ceremony — the honesty comes from what evidence you can
-actually see next to each step, not from a lock on the whole record.`,
+actually see next to each step, not from a lock on the whole record.
+
+While building a change, \`prismatica flow report\` is your honest account of
+which Flows the diff actually touched — filed before \`check\`, so the reviewer
+never reads a green check that quietly skipped over an affected Flow. See
+"prismatica guide check" for the exact command sequence.`,
     },
     {
         id: 'deltas',
@@ -1624,7 +1629,48 @@ change was probably two changes.`,
     {
         id: 'check',
         title: 'Check — proving the work',
-        body: `    prismatica check
+        body: `The real sequence is: inspect the complete working-tree impact on your Flows
+-> resolve any required Flow Report entries -> commit everything check needs,
+together -> run one full check -> review. The Flow Report belongs BEFORE
+check — filing it afterward just buys a second check.
+
+**First, if the change touches a mapped Flow:**
+
+    prismatica flow report --auto
+      # writes one entry per Flow your diff provably touched, naming the
+      # touchpoints that matched and the files that matched them
+
+\`--auto\` records only what a file diff can establish. It never says a test
+passed — it runs before check, so nothing has run yet — and it never says
+behaviour is unchanged, because no list of filenames can establish that. It
+leaves two things for you, and prints the exact command for each, last, where
+you cannot miss them: a Flow that merely SHARES a mechanic with one you
+touched, and a Flow with no mapped touchpoints at all, which no diff can rule
+in or out. It never overwrites an entry you wrote.
+
+Answer the rest in your own words:
+
+    prismatica flow report --flow log-a-session \\
+      --status unchanged --reason "only the internal helper moved; the user
+      sees exactly the same screens in the same order"
+
+\`unchanged\` on a Flow your diff touched is a real, accepted answer — that is
+what it is FOR. Prismatica cannot decide whether behaviour changed and does
+not pretend to; it only decides who has to answer. If that Flow's own mapped
+test files also changed in your diff, the report records that fact beside
+your reason so the reviewer weighs both — context, never a veto.
+
+File it BEFORE check and commit it WITH your other check inputs — a report
+sitting uncommitted proves nothing, and check refuses to run while it is
+uncommitted, exactly as it refuses uncommitted code.
+\`prismatica next\` already knows this order: on a change whose diff touches a
+mapped Flow, it recommends \`flow report --auto\` before it ever recommends
+check, and names the report file alongside your code in the one checkpoint
+commit it prints.
+
+**Then, once every check input is committed:**
+
+    prismatica check
 
 runs everything, identically to how the gate will run it later. It never asks
 the agent whether the work is done — it runs your tools and reads the results:
@@ -1642,7 +1688,7 @@ agents need retries in this repo.
 
 Failing is normal and cheap here. The whole point is that a change fails at
 check, on your machine, in minutes — not at the gate, or worse, in front of
-users.`,
+users. See "prismatica guide review" for what happens once check passes.`,
     },
     {
         id: 'review',
@@ -1742,35 +1788,15 @@ change's own records — committing the ledger line and evidence \`check\` just
 produced is expected and changes nothing. Commit code, contract terms, the
 pack, a flow report, a delta, a proposal or a canonical record afterwards and
 the check no longer describes this commit, so \`review\` refuses and \`next\`
-sends you back to \`check\`. File your flow report BEFORE the check, not after.
-A check recorded before this binding existed, or a ledger line written after it
-that cannot be read, both fail closed the same way: run \`check\` again.
-
-**Filing that flow report is one command, and it will not lie for you.**
-
-    prismatica flow report --auto
-      # writes one entry per Flow your diff provably touched, naming the
-      # touchpoints that matched and the files that matched them
-
-\`--auto\` records only what a file diff can establish. It never says a test
-passed — it runs before \`check\`, so nothing has run yet — and it never says
-behaviour is unchanged, because no list of filenames can establish that. It
-leaves two things for you, and prints the exact command for each, last, where
-you cannot miss them: a Flow that merely SHARES a mechanic with one you
-touched, and a Flow with no mapped touchpoints at all, which no diff can rule
-in or out. It never overwrites an entry you wrote.
+sends you back to \`check\`. A check recorded before this binding existed, or a
+ledger line written after it that cannot be read, both fail closed the same
+way: run \`check\` again.
 
-Then answer the rest in your own words:
-
-    prismatica flow report --flow log-a-session \\
-      --status unchanged --reason "only the internal helper moved; the user
-      sees exactly the same screens in the same order"
-
-\`unchanged\` on a Flow your diff touched is a real, accepted answer — that is
-what it is FOR. Prismatica cannot decide whether behaviour changed and does not
-pretend to; it only decides who has to answer. If that Flow's own mapped test
-files also changed in your diff, the report records that fact beside your
-reason so the reviewer weighs both. It is context, never a veto.
+**Filing the flow report is check's own job, not review's** — see "prismatica
+guide check" for the full command sequence (\`flow report --auto\`, then
+answering what it leaves for you). By the time you are reviewing, it should
+already be committed alongside the code it explains; if it is not, \`check\`
+will have refused to run in the first place.
 
 For heavy changes, your signed decision follows the seal:
 
@@ -1905,6 +1931,94 @@ fills the boundary in once, from the moment you re-run it — never earlier,
 and never moved again on any later run. Nothing is ever backfilled, waived,
 deleted or overwritten: this only decides who gets ASKED for verification, and
 a real passport, once written, is never touched by any of this.`,
+    },
+    {
+        id: 'release',
+        title: 'Release — an owner-only, deterministic npm release',
+        body: `Releasing already-governed code is its own small, deterministic transaction —
+never another AI-planned "version bump change". Release cadence is independent
+of change cadence: prepare a release whenever you decide the code on main is
+ready to go out, on your own schedule.
+
+    prismatica release prepare minor
+    prismatica release prepare patch
+    prismatica release prepare major
+    prismatica release prepare --version 1.4.0
+      # frames a light-tier contract, runs the real npm version transformation,
+      # writes a Flow report only if the diff genuinely touches a mapped flow,
+      # checkpoints, checks, records the check's own outputs, then ships the
+      # PR through the ordinary gate — exactly like any other change
+
+Every step re-derives whether it already happened from Git, the registry and
+records — never a stored counter — so running the same command again after an
+interruption resumes it rather than repeating or duplicating anything: no
+second commit, no double-counted check, no second PR.
+
+Prepare fails closed before it starts unless: main is clean and current, the
+registry is reachable, the target version is free — absent from BOTH the
+public version listing AND npm's staged candidates, since a staged version can
+still be approved public later — no published version is newer than main, and
+no \`v<target>\` tag already exists. A registry \`latest\` that sits behind main
+is reported, never refused — that is a deliberate rollback, and a corrective
+release must never be dead-ended by it.
+
+An unfinished release — merged, but never published — is closed without
+publishing it:
+
+    prismatica release prepare --supersede
+      # writes a write-once record, outcome "superseded", once the version is
+      # confirmed absent from both the public and staged registry listings
+
+If the version is still staged, supersede refuses and names the exact stage id
+and your two honest choices: continue that release with \`release publish\`, or
+\`npm stage reject <stage-id>\` (owner-interactive, npm's own 2FA) and rerun.
+
+After merge, gate, and close — \`next\` tells you exactly this:
+
+    prismatica release publish
+      # a resumable state machine: verifies the merged diff is semantically
+      # the pure version bump, creates and pushes the immutable tag, dispatches
+      # the release workflow on main, downloads and re-proves the staged
+      # tarball offline, shows you the evidence, then hands the one
+      # consequential step to npm's own interactive 2FA prompt
+
+Rerun \`release publish\` at any point and it re-derives exactly where things
+stand — tagged but not dispatched, or dispatched: it identifies the release
+workflow's own run (matched by its \`run-name\`, never "whichever ran most
+recently") and observes it rather than firing a duplicate — continuing once a
+staged candidate appears, or refusing with that run's own recovery if it
+genuinely failed or a bounded wait finds nothing. Staged but the wrong
+dist-tag (refused, with the same reject-and-rerun recovery), staged and
+awaiting your approval, or approved with the record not yet written — and
+either continues the one release in flight or refuses with the exact recovery.
+Once published and recorded, it refuses again: "already live and recorded".
+
+A release tag is immutable — never moved, repointed, or reused. A deterministic
+defect discovered in the release workflow AFTER the tag exists is fixed by an
+ordinary gated change on main and re-dispatched against the SAME untouched tag,
+never by touching the tag itself.
+
+**One-time owner setup — after this feature merges, before your first
+\`release publish\`:** on the package's npmjs.com access page, add a GitHub
+Actions trusted publisher naming this exact repo and
+\`.github/workflows/prismatica-release.yml\`, restricted to \`npm stage publish\`
+only — never anything broader — and set the package's publishing access to
+require 2FA and disallow tokens. \`release publish\` fails closed with these
+exact steps if staging never appears.
+
+**What Prismatica can actually guarantee, stated precisely:** no long-lived
+CI/automation publish credential is required or stored by Prismatica or this
+repository. CI staging authenticates with short-lived OIDC, restricted to a
+stage-only trusted publisher. \`npm stage approve\`/\`npm stage reject\` remain
+owner-interactive npm actions behind your own 2FA — Prismatica never sees,
+stores or approves anything on your behalf. Your local npm authentication
+exists outside the repository and is never inspected, copied or managed.
+
+A release record (\`.prismatica/releases/<version>.md\`) is write-once, exactly
+like a passport — never edited, never deleted; \`superseded\` is always a new,
+honest record, never a rewrite of an earlier one. What is left for you to do
+from a given release, if anything, is recorded as recovery ROUTES — plain
+descriptions of an available path, never a decision Prismatica makes for you.`,
     },
     {
         id: 'board',
@@ -1929,6 +2043,9 @@ Four areas, in the order they deserve your attention:
   eligible for \`ship --verify\`. Legacy (release proof not tracked) is a
   contract created before this repo adopted release tracking — never queued,
   never called shipped or verified (see "prismatica guide releasetracking").
+  Alongside these, npm release records (\`prismatica release prepare\`/
+  \`release publish\` — see "prismatica guide release") each show their
+  outcome — published or superseded — and any recovery routes left open.
   Below that, the plans you confirmed: an Intent is the plan \`prismatica start\`
   recorded when you confirmed it, its success checks listed as the outcomes it
   set out to achieve, never as a progress bar. Nothing in Prismatica advances
@@ -1989,8 +2106,28 @@ is governed, hash-only if it is map-only).`,
 export function guideTopicIds() {
     return GUIDE_TOPICS.map((topic) => topic.id);
 }
+/**
+ * Natural alternate spellings that resolve to a canonical topic id — the id
+ * itself, and every `prismatica guide <id>` a reader may already have
+ * bookmarked or typed in a script, never changes. This is the ONE place a new
+ * alias is added; `resolveGuideTopicId`, the CLI's `[topic]` help text and the
+ * unknown-topic recovery all derive from it and from `GUIDE_TOPICS` alone, so
+ * none of the three can drift from the other two the way three independently
+ * maintained lists once did.
+ */
+export const GUIDE_TOPIC_ALIASES = {
+    flow: 'flows',
+    delta: 'deltas',
+    releases: 'release',
+};
+/** The canonical topic id `id` resolves to (through an alias, or as itself), or `null` if it names no real topic. */
+export function resolveGuideTopicId(id) {
+    const canonical = GUIDE_TOPIC_ALIASES[id] ?? id;
+    return guideTopicIds().includes(canonical) ? canonical : null;
+}
 export function renderGuideTopic(id) {
-    const topic = GUIDE_TOPICS.find((entry) => entry.id === id);
+    const canonical = resolveGuideTopicId(id);
+    const topic = canonical ? GUIDE_TOPICS.find((entry) => entry.id === canonical) : undefined;
     if (!topic) {
         return null;
     }
@@ -2016,9 +2153,13 @@ export const SCENARIO_TOPIC_IDS = [
 function tocLine(topic) {
     return `- ${topic.title.toLowerCase().split(' — ')[0]}: prismatica guide ${topic.id}`;
 }
-export function renderFullGuide() {
+function tocSections() {
     const scenarios = GUIDE_TOPICS.filter((topic) => SCENARIO_TOPIC_IDS.includes(topic.id));
     const reference = GUIDE_TOPICS.filter((topic) => !SCENARIO_TOPIC_IDS.includes(topic.id));
+    return { scenarios, reference };
+}
+export function renderFullGuide() {
+    const { scenarios, reference } = tocSections();
     return `# The Prismatica guide
 
 The agent builds. Prismatica inspects. Nothing ships until the intent, the
@@ -2035,4 +2176,36 @@ ${reference.map(tocLine).join('\n')}
 ${GUIDE_TOPICS.map((topic) => `## ${topic.title}\n\n${topic.body}`).join('\n\n')}
 `;
 }
+/**
+ * The CONCISE entry point: bare `prismatica guide`. Scenario and reference
+ * navigation only, no topic bodies — `prismatica guide all` is the complete
+ * manual, byte-for-byte `renderFullGuide()`, which stays what
+ * `docs/USER_GUIDE.md` is generated from.
+ */
+export function renderGuideIndex() {
+    const { scenarios, reference } = tocSections();
+    return `# The Prismatica guide
+
+The agent builds. Prismatica inspects. Nothing ships until the intent, the
+proof, and the owner agree.
+
+Start from what you are trying to do:
+
+${scenarios.map(tocLine).join('\n')}
+
+Then the reference, when you want the detail behind a step:
+
+${reference.map(tocLine).join('\n')}
+
+Run \`prismatica guide <topic>\` to read one of those, or
+\`prismatica guide all\` for the complete manual on one page.
+`;
+}
+/** The CLI's `[topic]` help text — every real topic id, `all`, and every alias, derived from the one model. */
+export function guideTopicHelpText() {
+    const ids = ['all', ...guideTopicIds()];
+    const aliases = Object.keys(GUIDE_TOPIC_ALIASES);
+    const aliasNote = aliases.length > 0 ? ` (aliases: ${aliases.join(', ')})` : '';
+    return `${ids.join(' | ')}${aliasNote}`;
+}
 //# sourceMappingURL=guide.js.map

package/dist/guide.js.map

@@ -1 +1 @@
-{"version":3,"file":"guide.js","sourceRoot":"","sources":["../src/guide.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"guide.js","sourceRoot":"","sources":["../src/guide.ts"],"names":[],"mappings":"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"}

package/dist/paths.js

@@ -13,6 +13,7 @@ export const RECORD_SUBDIRS = [
     'reports',
     // `abandon` writes here, on the change's own retained branch — never main.
     'abandonments',
+    'releases',
 ];
 export function prismaticaDir(repoRoot) {
     return path.join(repoRoot, PRISMATICA_DIR);
@@ -93,6 +94,12 @@ export const ATLAS_CANONICAL_GLOBS = [`${PRISMATICA_DIR}/flows/*.md`, `${PRISMAT
 export function gateWorkflowPath(repoRoot) {
     return path.join(repoRoot, '.github', 'workflows', 'prismatica-gate.yml');
 }
+export function releaseWorkflowPath(repoRoot) {
+    return path.join(repoRoot, '.github', 'workflows', 'prismatica-release.yml');
+}
+export function releasesDir(repoRoot) {
+    return path.join(prismaticaDir(repoRoot), 'releases');
+}
 /**
  * Per-user home for Prismatica itself (signing key, repo registry).
  * Never a source of truth for any repo's records.

package/dist/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"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"}

package/dist/planning/pack.js

@@ -102,10 +102,15 @@ ${snapshotSection(snapshot)}
 2. **Agree who will build it, and put that in \`builder\`** (\`claude\`,
    \`codex\`, or whatever the owner names). Do not assume it is you — planning
    and building are different jobs, and a fresh session usually builds.
-3. Read the real code — routes, handlers, components, tests — before deciding
+3. **\`summary\` is the change's short, owner-facing title — not a summary of
+   the plan.** It becomes the GitHub issue title and the change's identity
+   everywhere it is shown, so put the detailed explanation in \`request\`,
+   \`rationale\`, \`currentBehaviour\` and \`desiredBehaviour\` instead; the
+   answer schema states its exact shape.
+4. Read the real code — routes, handlers, components, tests — before deciding
    anything. Do not reason from the Flow text above alone; it describes intent,
    the code is what actually happens.
-4. Decide which of three kinds this is, and be honest about it:
+5. Decide which of three kinds this is, and be honest about it:
    - \`existing-flow\` — it changes how a Flow listed above behaves. Name that
      Flow's exact id and return a complete Delta.
    - \`new-flow\` — it is a genuinely new user journey that no Flow above
@@ -113,18 +118,18 @@ ${snapshotSection(snapshot)}
    - \`technical\` — refactors, build, tooling, tests, dependencies. Return
      neither a Delta nor a Planned Flow. **Do not invent a product Flow to make
      technical work look like a feature.**
-5. Propose the narrowest scope that can actually do the job. Every glob must be
+6. Propose the narrowest scope that can actually do the job. Every glob must be
    relative to the repository root. Absolute paths, \`..\`, and anything
    matching a secret file will be rejected.
-6. Answer the risk questions honestly. Your answers can RAISE the risk tier;
+7. Answer the risk questions honestly. Your answers can RAISE the risk tier;
    they can never lower it. Deterministic path rules are applied on top and win.
-7. Give at least two acceptance checks. Each needs a real test file path
+8. Give at least two acceptance checks. Each needs a real test file path
    (\`src/thing.test.ts\`) or \`manual:OWNER\` — a description with no way to
    prove it is not a check.
-8. List in \`docsDelta\` every documentation file this change must update. The
+9. List in \`docsDelta\` every documentation file this change must update. The
    check engine requires each of them to have actually changed, so name the
    ones that genuinely go stale — not every file in \`docs/\`.
-9. Label honestly: \`assumptions\` and \`possibleConflicts\` are your reading of
+10. Label honestly: \`assumptions\` and \`possibleConflicts\` are your reading of
    the situation. They are shown to the owner as **advisory**, and no
    deterministic decision is made from them.
 

package/dist/planning/pack.js.map

@@ -1 +1 @@
-{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../src/planning/pack.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../src/planning/pack.ts"],"names":[],"mappings":"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"}

package/dist/planning/schema.js

@@ -27,6 +27,7 @@
 import { z } from 'zod';
 import { RECORD_ID_PATTERN } from '../ids.js';
 import { BUILDER_NAME_PATTERN, FlowMechanicsSchema, FlowPresentationSchema, FlowStatusSchema, FlowTruthSchema, } from '../records/types.js';
+import { CHANGE_TITLE_MAX, TITLE_PATTERN } from '../title.js';
 import { PlanningSnapshotSchema } from './snapshot.js';
 /**
  * An id proposed by an AGENT. Every record id becomes a filename under
@@ -149,7 +150,22 @@ export const StartProposalSchema = z.strictObject({
      * parameter and never touches this field.
      */
     snapshot: PlanningSnapshotSchema,
-    summary: z.string().min(1),
+    /**
+     * The change's concise, single-line, owner-facing IDENTITY — never a
+     * summary of the plan. It becomes `contract.title`, the GitHub issue
+     * title, and the Intent title verbatim, so its shape is enforced HERE, on
+     * the authoritative schema `startAnswerJsonSchema()` is derived from — see
+     * `src/title.ts` for the shared invariant every other title-consuming
+     * surface clamps against instead of refusing.
+     */
+    summary: z
+        .string()
+        .min(1)
+        .max(CHANGE_TITLE_MAX)
+        .regex(TITLE_PATTERN)
+        .describe('A concise, single-line, owner-facing change title (at most ' +
+        CHANGE_TITLE_MAX +
+        " characters) — the change's identity, NOT a summary of the plan. Put the detailed explanation in `request`, `rationale`, `currentBehaviour` and `desiredBehaviour` instead."),
     rationale: z.string().min(1),
     kind: ProposalKindSchema,
     /** Required for `existing-flow`; forbidden otherwise (checked in validate.ts). */

package/dist/planning/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/planning/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/planning/schema.ts"],"names":[],"mappings":"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"}

package/dist/prepush.js

@@ -52,6 +52,7 @@ import { resolveChangeHome } from './change.js';
 import { runCheckEngine } from './checkengine.js';
 import * as git from './git.js';
 import { contractExists, readContract } from './records/store.js';
+import { parseSemver } from './releases.js';
 const ZERO_SHA = '0'.repeat(40);
 const REFS_HEADS = 'refs/heads/';
 /** Parses git's real pre-push stdin protocol: one ref update per line, NUL/whitespace separated. */
@@ -121,6 +122,53 @@ async function verifyMainBranchUpdate(mainRoot, config, update) {
 function branchFromRef(ref) {
     return ref.startsWith(REFS_HEADS) ? ref.slice(REFS_HEADS.length) : null;
 }
+const REFS_TAGS_V = 'refs/tags/v';
+/** The version a `v<semver>` tag ref names, or null for any other ref (including a non-semver tag). */
+function releaseTagVersion(ref) {
+    if (!ref.startsWith(REFS_TAGS_V)) {
+        return null;
+    }
+    const version = ref.slice(REFS_TAGS_V.length);
+    return parseSemver(version) ? version : null;
+}
+/**
+ * A release tag is immutable — never moved, repointed, deleted or reused —
+ * and must bind to a commit that is genuinely on main with a matching
+ * committed manifest version, or `release publish`'s exact-artifact binding
+ * is broken before it starts.
+ */
+async function verifyReleaseTagUpdate(mainRoot, update, version) {
+    if (update.localSha === ZERO_SHA) {
+        return {
+            ok: false,
+            reason: `refusing: deleting release tag "v${version}" — release tags are immutable and never deleted`,
+        };
+    }
+    const mainHead = await git.revParse(mainRoot, 'HEAD');
+    if (!(await git.isAncestor(mainRoot, update.localSha, mainHead))) {
+        return {
+            ok: false,
+            reason: `refusing: v${version}'s commit (${update.localSha.slice(0, 12)}) is not on main`,
+        };
+    }
+    const manifestText = await git.showFile(mainRoot, update.localSha, 'package.json');
+    let manifestVersion;
+    try {
+        manifestVersion = manifestText
+            ? JSON.parse(manifestText).version
+            : undefined;
+    }
+    catch {
+        manifestVersion = undefined;
+    }
+    if (manifestVersion !== version) {
+        return {
+            ok: false,
+            reason: `refusing: v${version}'s tagged commit has package.json version "${manifestVersion ?? '(unreadable)'}", not "${version}"`,
+        };
+    }
+    return { ok: true, reason: `release tag v${version} verified against its own commit's package.json` };
+}
 /**
  * Branch identity is always read from `remoteRef`, never `localRef`:
  * `localRef` is the literal string `(delete)` for a deletion, and `ship`'s
@@ -150,6 +198,10 @@ async function verifyRefUpdate(cwd, mainRoot, config, update) {
         }
         return verifyChangeBranchUpdate(cwd, config, update, branch.slice('change/'.length));
     }
+    const releaseVersion = releaseTagVersion(update.remoteRef);
+    if (releaseVersion) {
+        return verifyReleaseTagUpdate(mainRoot, update, releaseVersion);
+    }
     return { ok: true, reason: `not a Prismatica-managed branch (${update.localRef}) — nothing to verify` };
 }
 /**

package/dist/prepush.js.map

@@ -1 +1 @@
-{"version":3,"file":"prepush.js","sourceRoot":"","sources":["../src/prepush.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prepush.js","sourceRoot":"","sources":["../src/prepush.ts"],"names":[],"mappings":"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"}

package/dist/records/store.js

@@ -11,7 +11,7 @@ import matter from 'gray-matter';
 import * as YAML from 'yaml';
 import { UserError } from '../errors.js';
 import { PRISMATICA_DIR, prismaticaDir } from '../paths.js';
-import { AbandonmentSchema, ContractSchema, DecisionSchema, FlowReportSchema, IntentSchema, PackSchema, PassportSchema, ReviewSchema, } from './types.js';
+import { AbandonmentSchema, ContractSchema, DecisionSchema, FlowReportSchema, IntentSchema, PackSchema, PassportSchema, ReleaseSchema, ReviewSchema, } from './types.js';
 const grayMatterOptions = {
     engines: {
         yaml: {
@@ -186,6 +186,22 @@ export function writePassport(repoRoot, passport, body) {
 export function readPassport(repoRoot, id) {
     return readMarkdownRecord(passportPath(repoRoot, id), PassportSchema);
 }
+// ── Releases (releases/<version>.md) ──────────────────────────────────────
+export function releasePath(repoRoot, version) {
+    return path.join(recordDir(repoRoot, 'releases'), `${version}.md`);
+}
+export function releaseExists(repoRoot, version) {
+    return fs.existsSync(releasePath(repoRoot, version));
+}
+export function writeRelease(repoRoot, release, body) {
+    writeMarkdownRecord(releasePath(repoRoot, release.version), ReleaseSchema.parse(release), body);
+}
+export function readRelease(repoRoot, version) {
+    return readMarkdownRecord(releasePath(repoRoot, version), ReleaseSchema);
+}
+export function listReleaseVersions(repoRoot) {
+    return listIds(repoRoot, 'releases', '.md');
+}
 // ── Flow Report (reports/<contractId>.md) — rides the lane, Model B ──────────
 export function abandonmentPath(repoRoot, id) {
     return path.join(recordDir(repoRoot, 'abandonments'), `${id}.md`);