loopforge 2.11.0 → 3.0.0

package/dist/policy.js

@@ -2,14 +2,32 @@
 import { randomUUID } from "node:crypto";
 import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync, } from "node:fs";
 import { isAbsolute, relative, resolve, sep } from "node:path";
+const REMOVED_POLICY_KEYS = new Set([
+    "engine.backtrack_auto_restore",
+]);
+const DEPRECATED_POLICY_KEYS = new Set([
+    "constraints.retire_window",
+    "engine.round_event_flush_interval",
+    "evolution.progress_stall_threshold",
+    "evolution.progress_stall_rounds",
+    "evolution.progress_mismatch_threshold",
+    "evolution.subgoal_auto_in_progress_threshold",
+    "evolution.subgoal_stale_rounds",
+    "state_file.max_checkpoints",
+    "state_file.max_summary_rounds",
+]);
 export const DEFAULT_POLICY = {
-    version: "2",
-    constraints: { retire_window: 3 },
+    version: "stable",
+    constraints: {},
     summary: { window: 5, health_check_interval: 1, milestone_interval: 20, max_milestones: 10, enable_loop_synthesis: true },
-    engine: { feedback_flush_interval: 5, max_circuit_breaker: 3, max_rounds: 20, enforcement_escalation_enabled: true, backtrack_enabled: true, backtrack_max_depth: 3, backtrack_preserve_discoveries: true, drift_clarification_max_streak: 3, backtrack_auto_restore: false },
+    engine: { max_circuit_breaker: 3, max_rounds: 100, enforcement_escalation_enabled: true, backtrack_enabled: true, backtrack_max_depth: 3, backtrack_preserve_discoveries: true, drift_clarification_max_streak: 3, max_rejections: 3 },
     prompt: {
         injection_mode: "adaptive",
         full_refresh_interval: 0,
+        adaptive_refresh: true,
+        max_l1_streak: 6,
+        stale_round_threshold: 3,
+        min_meaningful_sections: 4,
         l0_max_chars: 3000,
         l1_max_chars: 7000,
         l2_max_chars: 18000,
@@ -23,25 +41,21 @@ export const DEFAULT_POLICY = {
         max_emphasize_l1: 3,
         max_expand_l1: 1,
         max_confusion_points: 3,
-        base_prompt_version: "2.0.0",
+        base_prompt_version: "stable",
     },
     backend: { root_dir: ".loopforge" },
     evolution: {
         max_discovered_constraints_per_round: 5,
         max_active_constraints: 15,
         max_objective_versions: 10,
-        progress_stall_threshold: 0.05,
-        progress_stall_rounds: 2,
-        progress_mismatch_threshold: 0.3,
+        failed_pattern_match_threshold: 0.6,
         intent_drift_threshold: 0.15,
         criteria_dedup_threshold: 0.45,
         subgoal_dedup_threshold: 0.6,
         subgoal_match_threshold: 0.5,
-        subgoal_auto_in_progress_threshold: 0.4,
         subgoal_auto_complete_threshold: 0.4,
         constraint_match_threshold: 0.5,
         subgoal_drift_alignment_threshold: 0.3,
-        subgoal_stale_rounds: 10,
         max_subgoals_in_prompt: 10,
         max_done_subgoals_in_prompt: 5,
         constraint_inactive_rounds: 15,
@@ -51,8 +65,6 @@ export const DEFAULT_POLICY = {
     state_file: {
         enabled: true,
         directory: ".loopforge/state",
-        max_checkpoints: 5,
-        max_summary_rounds: 5,
     },
     evidence: { providers: ["git"], timeout_ms: 120_000, commands: [] },
     mcp: {
@@ -60,6 +72,85 @@ export const DEFAULT_POLICY = {
         session_lease_renew_interval_ms: 10_000,
     },
 };
+let lastPolicyDiagnostics = [];
+function policyKind(value) {
+    if (Array.isArray(value))
+        return "array";
+    if (value === null)
+        return "null";
+    return typeof value;
+}
+function collectPolicyDiagnostics(value, defaults, path, diagnostics) {
+    if (value === null || value === undefined)
+        return;
+    if (typeof defaults !== "object" || defaults === null || Array.isArray(defaults)) {
+        if (policyKind(value) !== policyKind(defaults)) {
+            diagnostics.push({
+                severity: "error",
+                kind: "type",
+                path,
+                message: `Expected ${policyKind(defaults)}, received ${policyKind(value)}.`,
+            });
+        }
+        return;
+    }
+    if (typeof value !== "object" || Array.isArray(value)) {
+        diagnostics.push({
+            severity: "error",
+            kind: "type",
+            path,
+            message: `Expected object, received ${policyKind(value)}.`,
+        });
+        return;
+    }
+    const defaultRecord = defaults;
+    const valueRecord = value;
+    for (const key of Object.keys(valueRecord)) {
+        const childPath = path ? `${path}.${key}` : key;
+        if (REMOVED_POLICY_KEYS.has(childPath)) {
+            diagnostics.push({
+                severity: "error",
+                kind: "removed",
+                path: childPath,
+                message: "This policy key is removed and has never performed automatic workspace changes.",
+            });
+            continue;
+        }
+        if (DEPRECATED_POLICY_KEYS.has(childPath)) {
+            diagnostics.push({
+                severity: "warning",
+                kind: "deprecated",
+                path: childPath,
+                message: "This policy key is deprecated and has no effect in the stable runtime.",
+            });
+        }
+        if (!(key in defaultRecord)) {
+            const kind = REMOVED_POLICY_KEYS.has(childPath)
+                ? "removed"
+                : DEPRECATED_POLICY_KEYS.has(childPath) ? "deprecated" : "unknown";
+            diagnostics.push({
+                severity: kind === "removed" ? "error" : "warning",
+                kind,
+                path: childPath,
+                message: kind === "removed"
+                    ? "This policy key is removed and has never performed automatic workspace changes."
+                    : kind === "deprecated"
+                        ? "This policy key is deprecated and has no effect in the stable runtime."
+                        : "Unknown policy key; it will be ignored.",
+            });
+            continue;
+        }
+        collectPolicyDiagnostics(valueRecord[key], defaultRecord[key], childPath, diagnostics);
+    }
+}
+export function diagnosePolicyDocument(value) {
+    const diagnostics = [];
+    collectPolicyDiagnostics(value, DEFAULT_POLICY, "", diagnostics);
+    return diagnostics;
+}
+export function getPolicyDiagnostics() {
+    return lastPolicyDiagnostics.map((diagnostic) => ({ ...diagnostic }));
+}
 /** Write a full default `loop_policy.json` to the target directory.
  *
  *  The written file contains every configurable key and its default value
@@ -86,28 +177,32 @@ function deepMerge(defaults, overrides) {
             typeof incoming === "object" && !Array.isArray(incoming)) {
             result[key] = deepMerge(current, incoming);
         }
-        else if (key in result) {
+        else if (key in result && policyKind(current) === policyKind(incoming)) {
             result[key] = incoming;
         }
-        else {
-            // Warn on unknown keys — a typo like "max_round" instead of
-            // "max_rounds" would otherwise be silently ignored.
-            console.warn(`loopforge: ignoring unknown policy key "${key}". Check loop_policy.json for typos.`);
-        }
     }
     return result;
 }
 export function loadPolicy(path) {
+    lastPolicyDiagnostics = [];
     const candidates = [path, "loop_policy.json"].filter(Boolean);
     for (const candidate of candidates) {
         try {
             const raw = JSON.parse(readFileSync(resolve(candidate), "utf8"));
             if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+                lastPolicyDiagnostics = diagnosePolicyDocument(raw);
                 return deepMerge(DEFAULT_POLICY, raw);
             }
         }
         catch {
-            // Try the next candidate.
+            if (existsSync(resolve(candidate))) {
+                lastPolicyDiagnostics = [{
+                        severity: "error",
+                        kind: "parse",
+                        path: candidate,
+                        message: "Policy file is not valid JSON; defaults are active.",
+                    }];
+            }
         }
     }
     return structuredClone(DEFAULT_POLICY);

package/dist/policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"policy.js","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,MAAM,EACN,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAyN/D,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,+BAA+B;CAChC,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,2BAA2B;IAC3B,mCAAmC;IACnC,oCAAoC;IACpC,iCAAiC;IACjC,uCAAuC;IACvC,8CAA8C;IAC9C,gCAAgC;IAChC,4BAA4B;IAC5B,+BAA+B;CAChC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,OAAO,EAAE,QAAQ;IACjB,WAAW,EAAE,EAAE;IACf,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,qBAAqB,EAAE,CAAC,EAAE,kBAAkB,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE;IACzH,MAAM,EAAE,EAAE,mBAAmB,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,8BAA8B,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,EAAE,8BAA8B,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE;IACtO,MAAM,EAAE;QACN,cAAc,EAAE,UAAU;QAC1B,qBAAqB,EAAE,CAAC;QACxB,gBAAgB,EAAE,IAAI;QACtB,aAAa,EAAE,CAAC;QAChB,qBAAqB,EAAE,CAAC;QACxB,uBAAuB,EAAE,CAAC;QAC1B,YAAY,EAAE,IAAI;QAClB,YAAY,EAAE,IAAI;QAClB,YAAY,EAAE,KAAK;QACnB,mBAAmB,EAAE,IAAI;QACzB,wBAAwB,EAAE,GAAG;QAC7B,4BAA4B,EAAE,IAAI;QAClC,qBAAqB,EAAE,KAAK;QAC5B,0BAA0B,EAAE,GAAG;QAC/B,kBAAkB,EAAE,IAAI;QACxB,gBAAgB,EAAE,CAAC;QACnB,gBAAgB,EAAE,CAAC;QACnB,aAAa,EAAE,CAAC;QAChB,oBAAoB,EAAE,CAAC;QACvB,mBAAmB,EAAE,QAAQ;KAC9B;IACD,OAAO,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE;IACnC,SAAS,EAAE;QACT,oCAAoC,EAAE,CAAC;QACvC,sBAAsB,EAAE,EAAE;QAC1B,sBAAsB,EAAE,EAAE;QAC1B,8BAA8B,EAAE,GAAG;QACnC,sBAAsB,EAAE,IAAI;QAC5B,wBAAwB,EAAE,IAAI;QAC9B,uBAAuB,EAAE,GAAG;QAC5B,uBAAuB,EAAE,GAAG;QAC5B,+BAA+B,EAAE,GAAG;QACpC,0BAA0B,EAAE,GAAG;QAC/B,iCAAiC,EAAE,GAAG;QACtC,sBAAsB,EAAE,EAAE;QAC1B,2BAA2B,EAAE,CAAC;QAC9B,0BAA0B,EAAE,EAAE;QAC9B,qBAAqB,EAAE,IAAI;KAC5B;IACD,UAAU,EAAE,EAAE,uBAAuB,EAAE,EAAE,EAAE,iBAAiB,EAAE,GAAG,EAAE;IACnE,UAAU,EAAE;QACV,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,kBAAkB;KAC9B;IACD,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;IACnE,GAAG,EAAE;QACH,gBAAgB,EAAE,MAAM;QACxB,+BAA+B,EAAE,MAAM;KACxC;CACF,CAAC;AAEF,IAAI,qBAAqB,GAAuB,EAAE,CAAC;AAEnD,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,OAAO,OAAO,KAAK,CAAC;AACtB,CAAC;AAED,SAAS,wBAAwB,CAC/B,KAAc,EACd,QAAiB,EACjB,IAAY,EACZ,WAA+B;IAE/B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO;IAClD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjF,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,WAAW,CAAC,IAAI,CAAC;gBACf,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,MAAM;gBACZ,IAAI;gBACJ,OAAO,EAAE,YAAY,UAAU,CAAC,QAAQ,CAAC,cAAc,UAAU,CAAC,KAAK,CAAC,GAAG;aAC5E,CAAC,CAAC;QACL,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,WAAW,CAAC,IAAI,CAAC;YACf,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,MAAM;YACZ,IAAI;YACJ,OAAO,EAAE,6BAA6B,UAAU,CAAC,KAAK,CAAC,GAAG;SAC3D,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,MAAM,aAAa,GAAG,QAAmC,CAAC;IAC1D,MAAM,WAAW,GAAG,KAAgC,CAAC;IACrD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAChD,IAAI,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACvC,WAAW,CAAC,IAAI,CAAC;gBACf,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,iFAAiF;aAC3F,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,sBAAsB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1C,WAAW,CAAC,IAAI,CAAC;gBACf,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,wEAAwE;aAClF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,CAAC,GAAG,IAAI,aAAa,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC;gBAC7C,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;YACrE,WAAW,CAAC,IAAI,CAAC;gBACf,QAAQ,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBAClD,IAAI;gBACJ,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI,KAAK,SAAS;oBACzB,CAAC,CAAC,iFAAiF;oBACnF,CAAC,CAAC,IAAI,KAAK,YAAY;wBACrB,CAAC,CAAC,wEAAwE;wBAC1E,CAAC,CAAC,yCAAyC;aAChD,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,wBAAwB,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,wBAAwB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;IACjE,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,qBAAqB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAiB,EACjB,KAAK,GAAG,KAAK;IAEb,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IACtD,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC1C,CAAC;IACD,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACzC,CAAC;AAED,SAAS,SAAS,CAAI,QAAW,EAAE,SAAkC;IACnE,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAA6B,CAAC;IAC1D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAChC,IACE,GAAG,IAAI,MAAM,IAAI,OAAO,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI;YACtD,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YACtD,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EACxD,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CACrB,OAAkC,EAClC,QAAmC,CACpC,CAAC;QACJ,CAAC;aAAM,IAAI,GAAG,IAAI,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzE,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,MAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,qBAAqB,GAAG,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC;IAC1E,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YACjE,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1D,qBAAqB,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;gBACpD,OAAO,SAAS,CAAC,cAAc,EAAE,GAA8B,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;gBACnC,qBAAqB,GAAG,CAAC;wBACvB,QAAQ,EAAE,OAAO;wBACjB,IAAI,EAAE,OAAO;wBACb,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,qDAAqD;qBAC/D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,eAAe,CAAC,cAAc,CAAC,CAAC;AACzC,CAAC;AAED,IAAI,MAAM,GAAsB,IAAI,CAAC;AAErC,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,iDAAiD;IACjD,kEAAkE;IAClE,IAAI,IAAI;QAAE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,UAAU,EAAE,CAAC;IACxB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,GAAG,qCAAqC,CAAC;AAEzD,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAClF,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,aAAqB,EACrB,mBAA2B;IAE3B,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;IAChE,MAAM,eAAe,GAAG,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC7D,IACE,eAAe,KAAK,IAAI,IAAI,eAAe,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC;QAClE,UAAU,CAAC,eAAe,CAAC,EAC3B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,QAAQ,GAAG,aAAa,CAAC;IAC7B,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,QAAQ;YAAE,MAAM;QAC/B,QAAQ,GAAG,MAAM,CAAC;IACpB,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IACrF,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACnD,IACE,YAAY,KAAK,IAAI,IAAI,YAAY,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC;QAC5D,UAAU,CAAC,YAAY,CAAC,EACxB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,OAA2B;IACxE,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,cAAc,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC,UAAU,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO;IAC5B,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACzE,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,GAAG,MAAM,WAAW,CAAC,CAAC;IAChE,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CACvB,iBAAiB,EACjB,IAAI,MAAM,UAAU,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,MAAM,CACtD,CAAC;IACF,IAAI,CAAC;QACH,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1C,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChC,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YAAC,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}

package/dist/prompt-assembler.d.ts

@@ -7,8 +7,8 @@
 import type { CanonicalLoopState } from "./canonical-state.js";
 import type { PromptArtifact, PromptRequests } from "./protocol.js";
 import type { PromptLevel, PromptLevelReason } from "./prompt-policy.js";
-export declare const PROMPT_ARTIFACT_SCHEMA_VERSION: 1;
-export declare const BASE_PROMPT_VERSION = "2.0.0";
+export declare const PROMPT_ARTIFACT_FORMAT: "loopforge.prompt";
+export declare const BASE_PROMPT_VERSION = "stable";
 export type InjectionMode = "adaptive" | "full" | "pointer";
 export interface PromptBudgets {
     l0: number;
@@ -23,8 +23,10 @@ export interface PromptAssemblyInput {
     mode?: InjectionMode;
     budgets?: Partial<PromptBudgets>;
     attempt?: number;
-    selfEvaluationBlock: string;
+    roundReportBlock?: string;
     fullStateMarkdown?: string;
+    /** Previous Agent suggestion. Display-only; never part of canonical state. */
+    agentIntent?: string;
     /** v2.9: Model's information needs for this prompt. L0: ignored. */
     promptRequests?: PromptRequests;
 }

package/dist/prompt-assembler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-assembler.d.ts","sourceRoot":"","sources":["../src/prompt-assembler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAI5B,eAAO,MAAM,8BAA8B,EAAG,CAAU,CAAC;AACzD,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAmpBD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAqKjF"}
+{"version":3,"file":"prompt-assembler.d.ts","sourceRoot":"","sources":["../src/prompt-assembler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAI5B,eAAO,MAAM,sBAAsB,EAAG,kBAA2B,CAAC;AAClE,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAE5C,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AA4sBD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CA2KjF"}

package/dist/prompt-assembler.js

@@ -5,11 +5,12 @@
  * are never truncated; budgets are soft and overflow is recorded.
  */
 import { createHash } from "node:crypto";
+import { deriveItemId } from "./derive-id.js";
 import { hashCanonicalState } from "./canonical-state.js";
 import { jaccardSimilarity } from "./token-utils.js";
 import { getPolicy } from "./policy.js";
-export const PROMPT_ARTIFACT_SCHEMA_VERSION = 1;
-export const BASE_PROMPT_VERSION = "2.0.0";
+export const PROMPT_ARTIFACT_FORMAT = "loopforge.prompt";
+export const BASE_PROMPT_VERSION = "stable";
 export const DEFAULT_PROMPT_BUDGETS = {
     l0: 3000,
     l1: 7000,
@@ -23,10 +24,6 @@ function bullets(values, prefix = "- ") {
 }
 /** v2.11: Derive a stable item ID from text content.
  *  Same hash strategy as computeGoalTextHash in loop-compiler.ts. */
-function deriveItemId(text) {
-    const normalized = text.trim().replace(/\s+/g, " ").toLowerCase();
-    return createHash("sha256").update(normalized).digest("hex").slice(0, 8);
-}
 /** v2.11: Render a bullet list with ID prefixes for constraints/criteria.
  *  Each item gets a [prefix-XXXXXXXX] tag. Items that already look like IDs
  *  are rendered as-is. When constraint_id_enabled is false, renders plain bullets. */
@@ -69,12 +66,41 @@ level) {
             text: section("Objective", state.objective),
             mandatory: true,
         },
-        {
-            id: "current_task",
-            text: section("Current Task", state.currentTask),
-            mandatory: true,
-        },
     ];
+    const phase = state.phaseHistory.at(-1);
+    if (phase) {
+        sections.push({
+            id: "current_phase",
+            text: section("Current Phase", `${phase.label} (${phase.status})\n${phase.outcome}`),
+            mandatory: false,
+        });
+    }
+    const focus = state.currentFocus || state.objective;
+    if (focus.trim()) {
+        sections.push({
+            id: "current_focus",
+            text: section("Current Focus", focus),
+            mandatory: true,
+        });
+    }
+    if (state.todoProjection) {
+        sections.push({
+            id: "todo_projection",
+            text: section("Active Todo Projection", `${state.todoProjection.action}\nCompletion: ${state.todoProjection.completionSignal}`),
+            mandatory: false,
+        });
+    }
+    sections.push({
+        id: "verification",
+        text: section("Verification Gate", verificationText(state) || "No verification contradiction is currently open."),
+        mandatory: true,
+    });
+    if (state.activeGate) {
+        const body = state.activeGate.kind === "user"
+            ? [`Owner: user`, `Question: ${state.activeGate.question}`, `Blocked scope: ${state.activeGate.blockedScope.join("; ")}`, `Safe work: ${state.activeGate.allowedWork.join("; ")}`].join("\n")
+            : [`Owner: agent`, `Problem: ${state.activeGate.problem}`, `Required evidence: ${state.activeGate.requiredEvidence.join("; ")}`, `Resolution: ${state.activeGate.suggestedResolution}`].join("\n");
+        sections.push({ id: "active_gate", text: section("Active Gate", body), mandatory: true });
+    }
     if (state.hardConstraints.length > 0) {
         // v2.11: L0 uses plain bullets (tight budget); L1/L2 show constraint IDs
         const body = level === "l0"
@@ -86,13 +112,6 @@ level) {
             mandatory: true,
         });
     }
-    if (state.verificationFlags.length > 0) {
-        sections.push({
-            id: "verification",
-            text: section("Verification Gate", verificationText(state)),
-            mandatory: true,
-        });
-    }
     return sections;
 }
 function l0Sections(state) {
@@ -119,6 +138,14 @@ function l0Sections(state) {
 }
 function l1Sections(state) {
     const sections = commonMandatorySections(state, "l1");
+    const openRegression = state.regressionObligations.filter((obligation) => obligation.status !== "satisfied");
+    if (openRegression.length > 0) {
+        sections.push({
+            id: "regression_obligations",
+            text: section("Regression Obligations", bullets(openRegression.map((item) => `[${item.status}] ${item.description}`))),
+            mandatory: true,
+        });
+    }
     const active = activeNonHardConstraints(state);
     if (state.changesSinceLastRound.length > 0) {
         sections.push({
@@ -145,7 +172,14 @@ function l1Sections(state) {
         sections.push({
             id: "blockers",
             text: section("Blockers", bullets(state.blockers)),
-            mandatory: false,
+            mandatory: true,
+        });
+    }
+    if (state.handoff.verifiedFacts.length > 0) {
+        sections.push({
+            id: "verified_facts",
+            text: section("Latest Verified Facts", bulletsWithIds(state.handoff.verifiedFacts, "cr")),
+            mandatory: true,
         });
     }
     // v2.2: Sub-Goal Dashboard (compact — L1)
@@ -186,10 +220,10 @@ function l1Sections(state) {
             mandatory: false,
         });
     }
-    if (state.nextAction) {
+    if (state.suggestedNextAction) {
         sections.push({
-            id: "next_action",
-            text: section("Next Action", state.nextAction),
+            id: "agent_intent",
+            text: section("Suggested Next Action", state.suggestedNextAction),
             mandatory: false,
         });
     }
@@ -197,6 +231,14 @@ function l1Sections(state) {
 }
 function l2Sections(state, fullStateMarkdown) {
     const sections = commonMandatorySections(state, "l2");
+    const openRegression = state.regressionObligations.filter((obligation) => obligation.status !== "satisfied");
+    if (openRegression.length > 0) {
+        sections.push({
+            id: "regression_obligations",
+            text: section("Regression Obligations", bullets(openRegression.map((item) => `[${item.status}] ${item.description}`))),
+            mandatory: true,
+        });
+    }
     const fullState = fullStateMarkdown?.trim();
     if (fullState) {
         sections.push({
@@ -213,6 +255,7 @@ function l2Sections(state, fullStateMarkdown) {
         ["changes", "Changes Since Last Round", state.changesSinceLastRound, null],
         ["remaining", "Remaining", state.remainingCriteria, "cr"],
         ["blockers", "Blockers", state.blockers, null],
+        ["verified_facts", "Latest Verified Facts", state.handoff.verifiedFacts, "cr"],
         ["discoveries", "Discoveries", state.discoveries, null],
         ["rolling_outcomes", "Cross-Round Outcomes", state.rollingOutcomes, null],
         ["recurring_issues", "Recurring Issues", state.recurringIssues, null],
@@ -223,28 +266,25 @@ function l2Sections(state, fullStateMarkdown) {
             const body = idPrefix
                 ? bulletsWithIds(values, idPrefix)
                 : bullets(values);
-            sections.push({ id, text: section(title, body), mandatory: false });
+            sections.push({
+                id,
+                text: section(title, body),
+                mandatory: id === "blockers" || id === "verified_facts",
+            });
         }
     }
-    if (state.milestones.length > 0) {
-        const milestoneText = state.milestones
-            .map((m) => {
-            const kindIcon = m.kind === "agent_declared"
-                ? "🏁"
-                : m.kind === "criteria_milestone" ? "✅" : "📍";
-            const lines = [
-                `**${kindIcon} ${m.label}** (Rounds ${m.round_range.start}–${m.round_range.end}, ${(m.progress_at_boundary * 100).toFixed(0)}%)`,
-                `  Outcome: ${m.outcome}`,
-            ];
-            if (m.resolved_constraints.length > 0) {
-                lines.push(`  Resolved: ${m.resolved_constraints.slice(0, 3).join("; ")}`);
-            }
-            return lines.join("\n");
+    if (state.phaseHistory.length > 0) {
+        const phaseText = state.phaseHistory
+            .map((phase) => {
+            const range = phase.closedAtRound
+                ? `R${phase.enteredAtRound}-R${phase.closedAtRound}`
+                : `R${phase.enteredAtRound}-current`;
+            return `**${phase.label}** (${range}, ${phase.status})\n  Outcome: ${phase.outcome}`;
         })
             .join("\n\n");
         sections.push({
-            id: "milestones",
-            text: section("Phase History", milestoneText),
+            id: "phase_history",
+            text: section("Phase History", phaseText),
             mandatory: false,
         });
     }
@@ -299,10 +339,10 @@ function l2Sections(state, fullStateMarkdown) {
             mandatory: false,
         });
     }
-    if (state.nextAction) {
+    if (state.suggestedNextAction) {
         sections.push({
-            id: "next_action",
-            text: section("Next Action", state.nextAction),
+            id: "agent_intent",
+            text: section("Suggested Next Action", state.suggestedNextAction),
             mandatory: false,
         });
     }
@@ -400,20 +440,26 @@ function l2Sections(state, fullStateMarkdown) {
     return sections;
 }
 function selectSections(input) {
-    if (input.mode === "full") {
-        return l2Sections(input.state, input.fullStateMarkdown);
-    }
-    if (input.level === "l0")
-        return l0Sections(input.state);
-    if (input.level === "l1")
-        return l1Sections(input.state);
-    return l2Sections(input.state, input.fullStateMarkdown);
+    const sections = input.mode === "full"
+        ? l2Sections(input.state, input.fullStateMarkdown)
+        : input.level === "l0" ? l0Sections(input.state)
+            : input.level === "l1" ? l1Sections(input.state)
+                : l2Sections(input.state, input.fullStateMarkdown);
+    if (input.agentIntent?.trim()) {
+        sections.push({
+            id: "agent_intent",
+            text: section("Agent Intent (non-authoritative)", `${input.agentIntent.trim()}\nRuntime-derived Focus, Todo and Suggested Next Action take precedence.`),
+            mandatory: false,
+        });
+    }
+    return sections;
 }
 function renderWithinBudget(sections, fixedText, budget) {
     const mandatory = sections.filter((item) => item.mandatory);
     const optional = sections.filter((item) => !item.mandatory);
     let rendered = fixedText + mandatory.map((item) => item.text).join("");
     const included = mandatory.filter((item) => item.text).map((item) => item.id);
+    const omitted = [];
     for (const item of optional) {
         if (!item.text)
             continue;
@@ -421,8 +467,11 @@ function renderWithinBudget(sections, fixedText, budget) {
             rendered += item.text;
             included.push(item.id);
         }
+        else {
+            omitted.push(item.id);
+        }
     }
-    return { rendered, included };
+    return { rendered, included, omitted };
 }
 // ═══════════════════════════════════════════════════════════════════════════
 // v2.9: Prompt Requests — model-expressed information needs
@@ -532,20 +581,14 @@ function renderCriticalContext(emphasized, state) {
 function renderExpandedSection(sectionName, state) {
     switch (sectionName) {
         case "milestones": {
-            if (state.milestones.length === 0)
+            if (state.phaseHistory.length === 0)
                 return "";
-            const text = state.milestones
-                .map((m) => {
-                const icon = m.kind === "agent_declared" ? "🏁" : m.kind === "criteria_milestone" ? "✅" : "📍";
-                const lines = [
-                    `**${icon} ${m.label}** (R${m.round_range.start}–R${m.round_range.end}, ${(m.progress_at_boundary * 100).toFixed(0)}%)`,
-                    `  Outcome: ${m.outcome}`,
-                ];
-                if (m.carried_constraints.length > 0)
-                    lines.push(`  Carried: ${m.carried_constraints.slice(0, 3).join("; ")}`);
-                if (m.resolved_constraints.length > 0)
-                    lines.push(`  Resolved: ${m.resolved_constraints.slice(0, 3).join("; ")}`);
-                return lines.join("\n");
+            const text = state.phaseHistory
+                .map((phase) => {
+                const range = phase.closedAtRound
+                    ? `R${phase.enteredAtRound}-R${phase.closedAtRound}`
+                    : `R${phase.enteredAtRound}-current`;
+                return `**${phase.label}** (${range}, ${phase.status})\n  Outcome: ${phase.outcome}`;
             })
                 .join("\n\n");
             return section("Expanded Phase History", text);
@@ -643,6 +686,7 @@ export function assemblePromptArtifact(input) {
     // than relying on potentially-compacted conversation history.
     const fullContextReasons = new Set([
         "first_round", "plan_boundary", "checkpoint_boundary", "goal_changed",
+        "constraint_changed",
         "missing_previous_state", "verification_contradicted",
         "rejection_rehydrate", "recovery_boundary", "state_drift",
         "periodic_refresh",
@@ -676,8 +720,9 @@ export function assemblePromptArtifact(input) {
     const pointer = stateFilePath
         ? section("Full State", stateFilePath)
         : "";
-    const evaluation = input.selfEvaluationBlock.trim()
-        ? `${input.selfEvaluationBlock.trim()}\n`
+    const reportBlock = input.roundReportBlock ?? "";
+    const evaluation = reportBlock.trim()
+        ? `${reportBlock.trim()}\n`
         : "";
     const howToRespond = [
         "## How to Complete This Round",
@@ -685,24 +730,20 @@ export function assemblePromptArtifact(input) {
         "1. Execute the task described above. Do NOT generate another prompt or plan — act.",
         "2. When finished, call the MCP tool **`loopforge_next`** with these parameters:",
         "   - `sessionId`: the session ID from `loopforge_start`.",
-        "   - `evaluation`: a structured self-assessment object (see schema below).",
+        "   - `report`: a canonical `RoundReport` object (see schema below).",
         "",
         "### Evaluation Rules",
         "",
-        "- `success`: Set to **`true` ONLY** when ALL hard constraints are met AND",
-        "  the task goal is fully achieved. If anything remains incomplete, set `false`.",
-        "- `should_continue`: Set to **`false` ONLY** when the ENTIRE loop task is done.",
-        "  Partial progress or completed subtasks → `true`.",
-        "- `constraint_violations`: Be honest. List every constraint you actually violated.",
-        "- `execution_evidence.files_changed`: List files you modified — used for verification.",
-        "- `execution_evidence.test_results`: Report actual test runner output.",
-        "- `progress_estimate`: A number 0.0–1.0 reflecting overall task completion.",
+        "- Use `outcome=success` only when all criteria have runtime-verified evidence; use `continuation=stop` only when you are requesting no further round.",
+        "- `violations`: list every constraint actually violated.",
+        "- Put claims in `evidence.claims` and reference configured providers or commands through `evidenceRefs`; provenance is runtime-owned.",
+        "- Do not estimate progress. LoopForge derives it from verified claims and remaining criteria.",
         "",
         "### If the Prompt Says \"REJECTED\"",
         "",
         "- Re-execute the **same round**. Do NOT advance the round counter.",
         "- Read the Required Fix section, address every issue, then submit again.",
-        "- Use `loopforge_next` with a corrected evaluation.",
+        "- Use `loopforge_next` with a corrected report.",
         "",
         evaluation,
     ].join("\n");
@@ -761,7 +802,7 @@ export function assemblePromptArtifact(input) {
     ];
     const promptHash = createHash("sha256").update(renderedPrompt).digest("hex");
     return {
-        schemaVersion: PROMPT_ARTIFACT_SCHEMA_VERSION,
+        format: PROMPT_ARTIFACT_FORMAT,
         roundId: `loop:${input.state.loopId}:round:${input.state.round}`,
         attempt,
         level: input.level,
@@ -771,9 +812,17 @@ export function assemblePromptArtifact(input) {
         stateHash,
         basePromptVersion: BASE_PROMPT_VERSION,
         includedSections,
+        omittedSections: selected.omitted,
         budgetChars: budget,
         charCount: renderedPrompt.length,
         budgetExceeded: renderedPrompt.length > budget,
+        // lastL2Round / lastMeaningfulProgressRound / stateAgeRounds are NOT
+        // assembled here: the assembler has no vault history and can only guess,
+        // so the values were always immediately overwritten by the compiler's
+        // vault-derived backfill. They stay undefined at this layer.
+        phaseId: input.state.phaseHistory.at(-1)?.id,
+        focusId: input.state.todoProjection?.sourceId,
+        todoId: input.state.todoProjection?.id,
         generatedAt: Date.now(),
     };
 }