mandrel 2.26.0 → 2.27.0

package/.agents/scripts/lib/baselines/reader.js

@@ -182,6 +182,56 @@ function validate(kind, parsed, sourceHint) {
   }
 }
 
+/**
+ * Internal: the ONE narrowing projection every loaded envelope passes through.
+ *
+ * `load` and `loadFile` reach a validated `parsed` envelope by different routes
+ * — one resolves the path from config, the other infers the kind from
+ * `$schema` — but the shape they hand back is the same narrow contract, so it
+ * is built here rather than written out at each exit.
+ *
+ * **That single-sourcing is the point, not tidiness.** The projection is an
+ * ALLOW-LIST: a field absent from it is silently dropped, and the envelope
+ * stamps below are read off the LOADED object by compat axes that fail closed
+ * when a stamp reads `undefined`. While the list was duplicated at the two
+ * exits, adding a stamp to one and not the other produced a gate that rejected
+ * every baseline in the repo for a stamp that was present on disk — which is
+ * exactly what happened to `provenanceStamped` between Story #4901 and this
+ * fix. One list means a new stamp cannot be half-added.
+ *
+ * @param {string} kind
+ * @param {object} parsed A validated baseline envelope.
+ * @returns {{ rollup: object, rows: Array<object>, kernelVersion: string, generatedAt: string }}
+ */
+function shapeEnvelope(kind, parsed) {
+  const rows = Array.isArray(parsed.rows)
+    ? parsed.rows.map((row) => canonicaliseRow(kind, row))
+    : [];
+  return {
+    rollup: parsed.rollup ?? { '*': {} },
+    rows,
+    kernelVersion: parsed.kernelVersion,
+    generatedAt: parsed.generatedAt,
+    // Story #4775 — carry the per-kind scoring-semantics stamp through the
+    // narrowing. The gate's compat check reads it off the LOADED envelope, so
+    // dropping it here would make every baseline look unstamped and fail the
+    // whole repo closed on a stamp that is actually present on disk.
+    scoringSemantics: parsed.scoringSemantics,
+    // Story #4866 — same contract for the transpiler stamp. Dropping it here
+    // would leave the ts-transpiler compat axis reachable but blind: it would
+    // read `undefined` off every loaded envelope and pass vacuously, which is
+    // the exact deadness this Story exists to end.
+    tsTranspilerVersion: parsed.tsTranspilerVersion,
+    // Story #4901 — the coordinate-provenance marker, and the stamp that proved
+    // the warnings above were not hypothetical. Its `provenance-unstamped` axis
+    // keys on `!== true`, so while this line was missing the axis read
+    // `undefined` off every envelope and rejected each one with "baseline
+    // predates coordinate-provenance stamping" — un-satisfiable, because
+    // re-deriving the baseline writes the marker the reader then drops.
+    provenanceStamped: parsed.provenanceStamped,
+  };
+}
+
 /**
  * Internal: parse + validate + canonicalise. Used by both `load` and
  * `loadFile`.
@@ -208,25 +258,7 @@ function readAndShape(kind, absolutePath) {
     );
   }
   validate(kind, parsed, absolutePath);
-  const rows = Array.isArray(parsed.rows)
-    ? parsed.rows.map((row) => canonicaliseRow(kind, row))
-    : [];
-  return {
-    rollup: parsed.rollup ?? { '*': {} },
-    rows,
-    kernelVersion: parsed.kernelVersion,
-    generatedAt: parsed.generatedAt,
-    // Story #4775 — carry the per-kind scoring-semantics stamp through the
-    // narrowing. The gate's compat check reads it off the LOADED envelope, so
-    // dropping it here would make every baseline look unstamped and fail the
-    // whole repo closed on a stamp that is actually present on disk.
-    scoringSemantics: parsed.scoringSemantics,
-    // Story #4866 — same contract for the transpiler stamp. Dropping it here
-    // would leave the ts-transpiler compat axis reachable but blind: it would
-    // read `undefined` off every loaded envelope and pass vacuously, which is
-    // the exact deadness this Story exists to end.
-    tsTranspilerVersion: parsed.tsTranspilerVersion,
-  };
+  return shapeEnvelope(kind, parsed);
 }
 
 /**
@@ -306,25 +338,7 @@ export function loadFile(absolutePath, opts = {}) {
     );
   }
   validate(kind, parsed, absolutePath);
-  const rows = Array.isArray(parsed.rows)
-    ? parsed.rows.map((row) => canonicaliseRow(kind, row))
-    : [];
-  return {
-    rollup: parsed.rollup ?? { '*': {} },
-    rows,
-    kernelVersion: parsed.kernelVersion,
-    generatedAt: parsed.generatedAt,
-    // Story #4775 — carry the per-kind scoring-semantics stamp through the
-    // narrowing. The gate's compat check reads it off the LOADED envelope, so
-    // dropping it here would make every baseline look unstamped and fail the
-    // whole repo closed on a stamp that is actually present on disk.
-    scoringSemantics: parsed.scoringSemantics,
-    // Story #4866 — same contract for the transpiler stamp. Dropping it here
-    // would leave the ts-transpiler compat axis reachable but blind: it would
-    // read `undefined` off every loaded envelope and pass vacuously, which is
-    // the exact deadness this Story exists to end.
-    tsTranspilerVersion: parsed.tsTranspilerVersion,
-  };
+  return shapeEnvelope(kind, parsed);
 }
 
 export const _internals = Object.freeze({

package/docs/CHANGELOG.md

@@ -15,6 +15,13 @@ All notable changes to this project will be documented in this file.
 -->
 <!-- markdownlint-disable-file MD004 MD012 MD037 -->
 
+## [2.27.0](https://github.com/dsj1984/mandrel/compare/mandrel-v2.26.0...mandrel-v2.27.0) (2026-08-03)
+
+
+### Fixed
+
+* **baselines:** carry provenanceStamped through the reader's narrowing (refs [#4973](https://github.com/dsj1984/mandrel/issues/4973)) ([#4974](https://github.com/dsj1984/mandrel/issues/4974)) ([4a3795a](https://github.com/dsj1984/mandrel/commit/4a3795a2e3d60748d5b40b0288521af5a7a885ab))
+
 ## [2.26.0](https://github.com/dsj1984/mandrel/compare/mandrel-v2.25.0...mandrel-v2.26.0) (2026-08-03)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mandrel",
-  "version": "2.26.0",
+  "version": "2.27.0",
   "description": "Claude Code-first opinionated workflow framework: instructions, skills, rules, and SDLC workflows that govern AI coding assistants.",
   "files": [
     ".agents/",