@riddledc/riddle-proof 0.5.51 → 0.5.52

package/README.md

@@ -83,6 +83,10 @@ full `--response-json` or the shorter `--decision` / `--summary` /
 `--payload-json` flags. No local executor or OpenClaw surface is required for
 that base workflow.
 
+Flag-based `respond` refuses to submit generated placeholder payloads. If the
+checkpoint template includes `TODO` fields, provide a real `--payload-json`
+file/object before resuming the run.
+
 `--agent local` is the generic CLI executor slot. The current implementation
 uses the local Codex CLI adapter underneath, but the loop contract and CLI
 surface are intentionally not Codex-specific.

package/dist/checkpoint.cjs

@@ -614,21 +614,21 @@ function defaultContinueStage(packet, decision) {
   return void 0;
 }
 function templatePayloadFor(packet, decision) {
-  if (packet.kind === "author_proof" || decision === "author_packet") {
+  if (decision === "author_packet") {
     return {
       proof_plan: "TODO: describe the exact proof plan and stop condition.",
       capture_script: "TODO: provide the capture script that collects required artifacts/evidence.",
       summary: "TODO: summarize why this proof packet targets the requested change."
     };
   }
-  if (packet.kind === "implement_change" || decision === "implementation_complete") {
+  if (decision === "implementation_complete") {
     return {
       changed_files: [],
       tests_run: [],
       implementation_notes: "TODO: summarize the direct edits made in the after worktree."
     };
   }
-  if (packet.kind === "assess_recon" || packet.stage === "recon") {
+  if (decision === "ready_for_author") {
     return {
       baseline_understanding: {
         reference: "TODO",

package/dist/checkpoint.js

@@ -13,7 +13,7 @@ import {
   normalizeCheckpointResponse,
   proofContractFromAuthorCheckpointResponse,
   statePathsForRunState
-} from "./chunk-36CBRVAK.js";
+} from "./chunk-T5RHGGQ2.js";
 import "./chunk-DUFDZJOF.js";
 export {
   RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION,

package/dist/{chunk-T7YFCZND.js → chunk-53UPEUVU.js}

@@ -1,6 +1,6 @@
 import {
   statePathsForRunState
-} from "./chunk-36CBRVAK.js";
+} from "./chunk-T5RHGGQ2.js";
 import {
   compactRecord,
   isTerminalStatus,

package/dist/{chunk-LBZWFSTU.js → chunk-KYGWIA7A.js}

@@ -10,10 +10,10 @@ import {
   createRunStatusSnapshot,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-KLOSE27H.js";
+} from "./chunk-PVUZZ2P6.js";
 import {
   createRiddleProofRunCard
-} from "./chunk-T7YFCZND.js";
+} from "./chunk-53UPEUVU.js";
 import {
   authorPacketPayloadFromCheckpointResponse,
   buildCheckpointPacketForEngineResult,
@@ -23,7 +23,7 @@ import {
   normalizeCheckpointResponse,
   proofContractFromAuthorCheckpointResponse,
   statePathsForRunState
-} from "./chunk-36CBRVAK.js";
+} from "./chunk-T5RHGGQ2.js";
 import {
   applyTerminalMetadata,
   compactRecord,

package/dist/{chunk-KLOSE27H.js → chunk-PVUZZ2P6.js}

@@ -1,6 +1,6 @@
 import {
   createRiddleProofRunCard
-} from "./chunk-T7YFCZND.js";
+} from "./chunk-53UPEUVU.js";
 import {
   compactRecord,
   isTerminalStatus,

package/dist/{chunk-WKKMBN5S.js → chunk-QBOKV3ES.js}

@@ -3,7 +3,7 @@ import {
   appendStageHeartbeat,
   createRunState,
   setRunStatus
-} from "./chunk-KLOSE27H.js";
+} from "./chunk-PVUZZ2P6.js";
 import {
   createRunResult
 } from "./chunk-DUFDZJOF.js";

package/dist/{chunk-36CBRVAK.js → chunk-T5RHGGQ2.js}

@@ -560,21 +560,21 @@ function defaultContinueStage(packet, decision) {
   return void 0;
 }
 function templatePayloadFor(packet, decision) {
-  if (packet.kind === "author_proof" || decision === "author_packet") {
+  if (decision === "author_packet") {
     return {
       proof_plan: "TODO: describe the exact proof plan and stop condition.",
       capture_script: "TODO: provide the capture script that collects required artifacts/evidence.",
       summary: "TODO: summarize why this proof packet targets the requested change."
     };
   }
-  if (packet.kind === "implement_change" || decision === "implementation_complete") {
+  if (decision === "implementation_complete") {
     return {
       changed_files: [],
       tests_run: [],
       implementation_notes: "TODO: summarize the direct edits made in the after worktree."
     };
   }
-  if (packet.kind === "assess_recon" || packet.stage === "recon") {
+  if (decision === "ready_for_author") {
     return {
       baseline_understanding: {
         reference: "TODO",

package/dist/cli.cjs

@@ -3549,21 +3549,21 @@ function defaultContinueStage(packet, decision) {
   return void 0;
 }
 function templatePayloadFor(packet, decision) {
-  if (packet.kind === "author_proof" || decision === "author_packet") {
+  if (decision === "author_packet") {
     return {
       proof_plan: "TODO: describe the exact proof plan and stop condition.",
       capture_script: "TODO: provide the capture script that collects required artifacts/evidence.",
       summary: "TODO: summarize why this proof packet targets the requested change."
     };
   }
-  if (packet.kind === "implement_change" || decision === "implementation_complete") {
+  if (decision === "implementation_complete") {
     return {
       changed_files: [],
       tests_run: [],
       implementation_notes: "TODO: summarize the direct edits made in the after worktree."
     };
   }
-  if (packet.kind === "assess_recon" || packet.stage === "recon") {
+  if (decision === "ready_for_author") {
     return {
       baseline_understanding: {
         reference: "TODO",
@@ -6466,6 +6466,14 @@ function readRunState(statePath) {
   }
   return parsed;
 }
+function hasPlaceholderValue(value) {
+  if (typeof value === "string") return /\bTODO\b/.test(value);
+  if (Array.isArray(value)) return value.some(hasPlaceholderValue);
+  if (value && typeof value === "object") {
+    return Object.values(value).some(hasPlaceholderValue);
+  }
+  return false;
+}
 function checkpointResponseForFlags(statePath, options) {
   const state = readRunState(statePath);
   if (!state.checkpoint_packet) {
@@ -6479,15 +6487,24 @@ function checkpointResponseForFlags(statePath, options) {
   if (!state.checkpoint_packet.allowed_decisions.includes(decision)) {
     throw new Error(`--decision ${decision} is not allowed for ${state.checkpoint_packet.checkpoint}. Allowed decisions: ${state.checkpoint_packet.allowed_decisions.join(", ")}`);
   }
-  return createCheckpointResponseTemplate(state.checkpoint_packet, {
+  const payload = readOptionalJsonRecord(optionString(options, "payloadJson"), "--payload-json");
+  const reasons = readOptionalJsonStringArray(optionString(options, "reasonsJson"), "--reasons-json");
+  const response = createCheckpointResponseTemplate(state.checkpoint_packet, {
     decision,
     summary,
-    payload: readOptionalJsonRecord(optionString(options, "payloadJson"), "--payload-json"),
-    reasons: readOptionalJsonStringArray(optionString(options, "reasonsJson"), "--reasons-json"),
+    payload,
+    reasons,
     continue_with_stage: optionString(options, "continueWithStage"),
     source_kind: optionString(options, "sourceKind") || "codex",
     created_at: optionString(options, "createdAt")
   });
+  if (!payload && hasPlaceholderValue(response.payload)) {
+    throw new Error(`--payload-json is required for ${decision} at ${state.checkpoint_packet.checkpoint}; the generated template contains placeholders.`);
+  }
+  if (!reasons && hasPlaceholderValue(response.reasons)) {
+    delete response.reasons;
+  }
+  return response;
 }
 function codexConfig(options) {
   const codexFullAuto = optionString(options, "codexFullAuto");

package/dist/cli.js

@@ -3,18 +3,18 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-LBZWFSTU.js";
+} from "./chunk-KYGWIA7A.js";
 import "./chunk-4ASMX4R6.js";
 import "./chunk-JFQXAJH2.js";
 import {
   createCodexExecAgentAdapter,
   runCodexExecAgentDoctor
 } from "./chunk-3266V3MO.js";
-import "./chunk-KLOSE27H.js";
-import "./chunk-T7YFCZND.js";
+import "./chunk-PVUZZ2P6.js";
+import "./chunk-53UPEUVU.js";
 import {
   createCheckpointResponseTemplate
-} from "./chunk-36CBRVAK.js";
+} from "./chunk-T5RHGGQ2.js";
 import "./chunk-DUFDZJOF.js";
 
 // src/cli.ts
@@ -88,6 +88,14 @@ function readRunState(statePath) {
   }
   return parsed;
 }
+function hasPlaceholderValue(value) {
+  if (typeof value === "string") return /\bTODO\b/.test(value);
+  if (Array.isArray(value)) return value.some(hasPlaceholderValue);
+  if (value && typeof value === "object") {
+    return Object.values(value).some(hasPlaceholderValue);
+  }
+  return false;
+}
 function checkpointResponseForFlags(statePath, options) {
   const state = readRunState(statePath);
   if (!state.checkpoint_packet) {
@@ -101,15 +109,24 @@ function checkpointResponseForFlags(statePath, options) {
   if (!state.checkpoint_packet.allowed_decisions.includes(decision)) {
     throw new Error(`--decision ${decision} is not allowed for ${state.checkpoint_packet.checkpoint}. Allowed decisions: ${state.checkpoint_packet.allowed_decisions.join(", ")}`);
   }
-  return createCheckpointResponseTemplate(state.checkpoint_packet, {
+  const payload = readOptionalJsonRecord(optionString(options, "payloadJson"), "--payload-json");
+  const reasons = readOptionalJsonStringArray(optionString(options, "reasonsJson"), "--reasons-json");
+  const response = createCheckpointResponseTemplate(state.checkpoint_packet, {
     decision,
     summary,
-    payload: readOptionalJsonRecord(optionString(options, "payloadJson"), "--payload-json"),
-    reasons: readOptionalJsonStringArray(optionString(options, "reasonsJson"), "--reasons-json"),
+    payload,
+    reasons,
     continue_with_stage: optionString(options, "continueWithStage"),
     source_kind: optionString(options, "sourceKind") || "codex",
     created_at: optionString(options, "createdAt")
   });
+  if (!payload && hasPlaceholderValue(response.payload)) {
+    throw new Error(`--payload-json is required for ${decision} at ${state.checkpoint_packet.checkpoint}; the generated template contains placeholders.`);
+  }
+  if (!reasons && hasPlaceholderValue(response.reasons)) {
+    delete response.reasons;
+  }
+  return response;
 }
 function codexConfig(options) {
   const codexFullAuto = optionString(options, "codexFullAuto");

package/dist/engine-harness.js

@@ -2,11 +2,11 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-LBZWFSTU.js";
+} from "./chunk-KYGWIA7A.js";
 import "./chunk-4ASMX4R6.js";
-import "./chunk-KLOSE27H.js";
-import "./chunk-T7YFCZND.js";
-import "./chunk-36CBRVAK.js";
+import "./chunk-PVUZZ2P6.js";
+import "./chunk-53UPEUVU.js";
+import "./chunk-T5RHGGQ2.js";
 import "./chunk-DUFDZJOF.js";
 export {
   createDisabledRiddleProofAgentAdapter,

package/dist/index.cjs

@@ -3610,21 +3610,21 @@ function defaultContinueStage(packet, decision) {
   return void 0;
 }
 function templatePayloadFor(packet, decision) {
-  if (packet.kind === "author_proof" || decision === "author_packet") {
+  if (decision === "author_packet") {
     return {
       proof_plan: "TODO: describe the exact proof plan and stop condition.",
       capture_script: "TODO: provide the capture script that collects required artifacts/evidence.",
       summary: "TODO: summarize why this proof packet targets the requested change."
     };
   }
-  if (packet.kind === "implement_change" || decision === "implementation_complete") {
+  if (decision === "implementation_complete") {
     return {
       changed_files: [],
       tests_run: [],
       implementation_notes: "TODO: summarize the direct edits made in the after worktree."
     };
   }
-  if (packet.kind === "assess_recon" || packet.stage === "recon") {
+  if (decision === "ready_for_author") {
     return {
       baseline_understanding: {
         reference: "TODO",

package/dist/index.js

@@ -17,7 +17,7 @@ import {
 } from "./chunk-ODORKNSO.js";
 import {
   runRiddleProof
-} from "./chunk-WKKMBN5S.js";
+} from "./chunk-QBOKV3ES.js";
 import {
   DEFAULT_DIAGNOSTIC_ARRAY_LIMIT,
   DEFAULT_DIAGNOSTIC_HISTORY_LIMIT,
@@ -32,7 +32,7 @@ import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
   runRiddleProofEngineHarness
-} from "./chunk-LBZWFSTU.js";
+} from "./chunk-KYGWIA7A.js";
 import "./chunk-4ASMX4R6.js";
 import "./chunk-JFQXAJH2.js";
 import {
@@ -51,11 +51,11 @@ import {
   normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-KLOSE27H.js";
+} from "./chunk-PVUZZ2P6.js";
 import {
   RIDDLE_PROOF_RUN_CARD_VERSION,
   createRiddleProofRunCard
-} from "./chunk-T7YFCZND.js";
+} from "./chunk-53UPEUVU.js";
 import {
   RIDDLE_PROOF_CHECKPOINT_PACKET_VERSION,
   RIDDLE_PROOF_CHECKPOINT_RESPONSE_VERSION,
@@ -71,7 +71,7 @@ import {
   normalizeCheckpointResponse,
   proofContractFromAuthorCheckpointResponse,
   statePathsForRunState
-} from "./chunk-36CBRVAK.js";
+} from "./chunk-T5RHGGQ2.js";
 import {
   applyTerminalMetadata,
   compactRecord,

package/dist/openclaw.js

@@ -1,9 +1,9 @@
 import {
   normalizeIntegrationContext,
   normalizeRunParams
-} from "./chunk-KLOSE27H.js";
-import "./chunk-T7YFCZND.js";
-import "./chunk-36CBRVAK.js";
+} from "./chunk-PVUZZ2P6.js";
+import "./chunk-53UPEUVU.js";
+import "./chunk-T5RHGGQ2.js";
 import {
   compactRecord
 } from "./chunk-DUFDZJOF.js";

package/dist/run-card.js

@@ -1,8 +1,8 @@
 import {
   RIDDLE_PROOF_RUN_CARD_VERSION,
   createRiddleProofRunCard
-} from "./chunk-T7YFCZND.js";
-import "./chunk-36CBRVAK.js";
+} from "./chunk-53UPEUVU.js";
+import "./chunk-T5RHGGQ2.js";
 import "./chunk-DUFDZJOF.js";
 export {
   RIDDLE_PROOF_RUN_CARD_VERSION,

package/dist/runner.js

@@ -1,9 +1,9 @@
 import {
   runRiddleProof
-} from "./chunk-WKKMBN5S.js";
-import "./chunk-KLOSE27H.js";
-import "./chunk-T7YFCZND.js";
-import "./chunk-36CBRVAK.js";
+} from "./chunk-QBOKV3ES.js";
+import "./chunk-PVUZZ2P6.js";
+import "./chunk-53UPEUVU.js";
+import "./chunk-T5RHGGQ2.js";
 import "./chunk-DUFDZJOF.js";
 export {
   runRiddleProof

package/dist/state.js

@@ -9,9 +9,9 @@ import {
   normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-KLOSE27H.js";
-import "./chunk-T7YFCZND.js";
-import "./chunk-36CBRVAK.js";
+} from "./chunk-PVUZZ2P6.js";
+import "./chunk-53UPEUVU.js";
+import "./chunk-T5RHGGQ2.js";
 import "./chunk-DUFDZJOF.js";
 export {
   RIDDLE_PROOF_RUN_STATE_VERSION,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.5.51",
+  "version": "0.5.52",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",