@inixiative/foundry-core 0.5.3 → 0.5.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inixiative/foundry-core",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",

package/src/feedback/experiment-gate.ts

@@ -3,7 +3,10 @@
  * Oracle's replay runner: a wide run (more than TINY_MOMENTS moments, or whatever else the caller
  * counts as wide) needs `--experiment <design.md>` whose pre-registration sections are filled and
  * whose `<design>.review.md` says `verdict: go` for this exact design (`design-sha256:` of its
- * bytes). A tiny test runs without one.
+ * bytes). A tiny test runs without one. When a `<design>.decisions.md` companion sits beside the
+ * design (run pins and answers that are filled after review, so the design's hash stays fixed), the
+ * run is refused while it still holds a TBD value outside its `## Log`, and its path and hash are
+ * recorded too.
  */
 import { createHash } from 'node:crypto';
 import { existsSync, readFileSync } from 'node:fs';
@@ -24,12 +27,32 @@ export const DESIGN_SECTIONS = [
   'What would make the result wrong',
 ] as const;
 
-export type ExperimentRecord = { design: string; designSha256: string; review: string };
+export type ExperimentRecord = {
+  design: string;
+  designSha256: string;
+  review: string;
+  decisions?: string;
+  decisionsSha256?: string;
+};
 
 export const reviewPathOf = (design: string) => design.replace(/\.md$/, '.review.md');
+export const decisionsPathOf = (design: string) => design.replace(/\.md$/, '.decisions.md');
 
 const sha256 = (path: string) => createHash('sha256').update(readFileSync(path)).digest('hex');
 
+/**
+ * Line numbers of a decisions companion that still hold a `TBD` value. The `## Log` section is
+ * history and is skipped, and the token quoted alone in backticks is a mention of it, not a value.
+ */
+export const openDecisionLines = (text: string): number[] => {
+  let inLog = false;
+  return text.split('\n').flatMap((line, i) => {
+    const heading = /^(#{1,6})\s+(.+?)\s*$/.exec(line);
+    if (heading) inLog = heading[1] === '##' ? /^log$/i.test(heading[2] ?? '') : inLog;
+    return !inLog && /\bTBD\b/.test(line.replaceAll('`TBD`', '')) ? [i + 1] : [];
+  });
+};
+
 /** Why the design may not run wide; empty when it may. */
 export const experimentProblems = (designPath: string): string[] => {
   const design = resolve(designPath);
@@ -54,6 +77,14 @@ export const experimentProblems = (designPath: string): string[] => {
       problems.push(`section "## ${name}" is empty`);
   }
   if (text.includes('<fill')) problems.push('unfilled <fill: …> placeholders remain');
+  const decisions = decisionsPathOf(design);
+  if (existsSync(decisions)) {
+    const open = openDecisionLines(readFileSync(decisions, 'utf8'));
+    if (open.length)
+      problems.push(
+        `${decisions} still says TBD (line${open.length > 1 ? 's' : ''} ${open.join(', ')})`,
+      );
+  }
   const review = reviewPathOf(design);
   if (!existsSync(review)) return [...problems, `no adversarial review at ${review}`];
   const reviewText = readFileSync(review, 'utf8');
@@ -85,5 +116,15 @@ export const requireExperiment = (
         'see .claude/skills/experiment/SKILL.md',
     );
   const design = resolve(experiment);
-  return { design, designSha256: sha256(design), review: reviewPathOf(design) };
+  const record: ExperimentRecord = {
+    design,
+    designSha256: sha256(design),
+    review: reviewPathOf(design),
+  };
+  const decisions = decisionsPathOf(design);
+  if (existsSync(decisions)) {
+    record.decisions = decisions;
+    record.decisionsSha256 = sha256(decisions);
+  }
+  return record;
 };

package/src/index.ts

@@ -192,8 +192,10 @@ export {
 } from './feedback/correction';
 export {
   DESIGN_SECTIONS,
+  decisionsPathOf,
   type ExperimentRecord,
   experimentProblems,
+  openDecisionLines,
   requireExperiment,
   reviewPathOf,
   TINY_MOMENTS,