@riddledc/riddle-proof 0.8.54 → 0.8.56

package/dist/state.cjs

@@ -47,6 +47,9 @@ module.exports = __toCommonJS(state_exports);
 function isTerminalStatus(status) {
   return status === "blocked" || status === "failed" || status === "ready_to_ship" || status === "shipped" || status === "completed";
 }
+function isProtectedFinalStatus(status) {
+  return status === "ready_to_ship" || status === "shipped" || status === "completed";
+}
 function compactRecord(input) {
   return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0 && value !== null && value !== ""));
 }
@@ -56,6 +59,45 @@ function nonEmptyString(value) {
 function recordValue(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
+function firstBoolean(...values) {
+  for (const value of values) {
+    if (typeof value === "boolean") return value;
+  }
+  return void 0;
+}
+function shipControlStateFor(input) {
+  const state = input.state;
+  const status = input.status || state.status;
+  const raw = recordValue(input.raw) || {};
+  const shipReport = recordValue(state.ship_report) || {};
+  const prState = recordValue(state.pr_state) || {};
+  const shippingDisabled = firstBoolean(
+    raw.shipping_disabled,
+    raw.shippingDisabled,
+    state.shipping_disabled,
+    shipReport.shipping_disabled,
+    shipReport.shippingDisabled
+  ) ?? state.request?.ship_mode === "none";
+  const explicitAuthorized = firstBoolean(
+    raw.ship_authorized,
+    raw.shipAuthorized,
+    state.ship_authorized,
+    shipReport.ship_authorized,
+    shipReport.shipAuthorized
+  );
+  const authorizationEvidence = Boolean(
+    status === "shipped" || state.marked_ready === true || shipReport.marked_ready === true || prState.status === "merged" || state.merge_commit || state.merged_at
+  );
+  const inferredAuthorized = explicitAuthorized ?? authorizationEvidence;
+  const rawHeld = firstBoolean(raw.ship_held, raw.shipHeld);
+  const inferredHeld = status === "ready_to_ship" && shippingDisabled && !inferredAuthorized;
+  const shipHeld = rawHeld ?? (state.ship_held === true || inferredHeld);
+  return {
+    ship_held: shipHeld,
+    shipping_disabled: shippingDisabled,
+    ship_authorized: shipHeld ? false : inferredAuthorized
+  };
+}
 
 // src/checkpoint.ts
 var import_node_crypto = __toESM(require("crypto"), 1);
@@ -226,6 +268,7 @@ function createRiddleProofRunCard(state, input = {}) {
   const visualDelta = visualDeltaFrom({ fullRiddleState: fullState, runState: state });
   const artifacts = artifactsFrom({ fullRiddleState: fullState, runState: state });
   const viewportMatrix = viewportMatrixFrom({ fullRiddleState: fullState, runState: state });
+  const shipControl = shipControlStateFor({ state });
   return {
     version: RIDDLE_PROOF_RUN_CARD_VERSION,
     run_id: state.run_id || "unknown",
@@ -279,6 +322,9 @@ function createRiddleProofRunCard(state, input = {}) {
     stop_condition: compactRecord({
       status: state.status,
       terminal: isTerminalStatus(state.status),
+      ship_held: shipControl.ship_held,
+      shipping_disabled: shipControl.shipping_disabled,
+      ship_authorized: shipControl.ship_authorized,
       blocker_code: state.blocker?.code || null,
       blocker_message: state.blocker?.message || null,
       proof_decision: state.proof_decision,
@@ -469,7 +515,8 @@ function appendStageHeartbeat(state, input) {
 function createRunStatusSnapshot(state, at = timestamp()) {
   const latestEvent = state.events[state.events.length - 1];
   const runId = state.run_id || "unknown";
-  const existingRunCardCurrent = state.run_card?.status === state.status && state.run_card.stop_condition?.status === state.status && state.run_card.stop_condition?.terminal === isTerminalStatus(state.status) && state.run_card.stop_condition?.monitor_should_continue === !isTerminalStatus(state.status);
+  const shipControl = shipControlStateFor({ state });
+  const existingRunCardCurrent = state.run_card?.status === state.status && state.run_card.stop_condition?.status === state.status && state.run_card.stop_condition?.terminal === isTerminalStatus(state.status) && state.run_card.stop_condition?.monitor_should_continue === !isTerminalStatus(state.status) && state.run_card.stop_condition?.ship_held === shipControl.ship_held && state.run_card.stop_condition?.shipping_disabled === shipControl.shipping_disabled && state.run_card.stop_condition?.ship_authorized === shipControl.ship_authorized;
   const runCard = existingRunCardCurrent ? state.run_card : createRiddleProofRunCard(state, { at });
   return compactRecord({
     run_id: runId,
@@ -483,6 +530,9 @@ function createRunStatusSnapshot(state, at = timestamp()) {
     pr_url: state.pr_url ?? null,
     pr_branch: state.pr_branch ?? null,
     pr_state: state.pr_state,
+    ship_held: shipControl.ship_held,
+    shipping_disabled: shipControl.shipping_disabled,
+    ship_authorized: shipControl.ship_authorized,
     ci_status: state.ci_status,
     ship_commit: state.ship_commit,
     ship_remote_head: state.ship_remote_head,
@@ -508,6 +558,7 @@ function createRunStatusSnapshot(state, at = timestamp()) {
 function setRunStatus(state, status, at = timestamp()) {
   state.status = status;
   state.ok = status !== "blocked" && status !== "failed";
+  if (isProtectedFinalStatus(status)) state.finalized = true;
   state.updated_at = at;
   return state;
 }

package/dist/state.js

@@ -9,10 +9,10 @@ import {
   normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-WDIKPIMB.js";
-import "./chunk-JJ4IWRMJ.js";
-import "./chunk-BLM5EIBA.js";
-import "./chunk-VY4Y5U57.js";
+} from "./chunk-UZIX7M7D.js";
+import "./chunk-KNPCWWF3.js";
+import "./chunk-MOTQNIZX.js";
+import "./chunk-CUBYSWZT.js";
 import "./chunk-MLKGABMK.js";
 export {
   RIDDLE_PROOF_RUN_STATE_VERSION,

package/dist/types.d.cts

@@ -136,6 +136,8 @@ interface RiddleProofCheckpointSummary {
     packet_count: number;
     response_count: number;
     duplicate_response_count?: number;
+    rejected_response_count?: number;
+    ignored_response_count?: number;
     latest_checkpoint?: string | null;
     latest_stage?: RiddleProofStage | null;
     latest_kind?: string | null;
@@ -239,6 +241,9 @@ interface RiddleProofRunCard {
     stop_condition: {
         status: RiddleProofStatus;
         terminal?: boolean;
+        ship_held?: boolean;
+        shipping_disabled?: boolean;
+        ship_authorized?: boolean;
         blocker_code?: string | null;
         blocker_message?: string | null;
         proof_decision?: RiddleProofDecision;
@@ -289,6 +294,9 @@ interface RiddleProofRunState {
     pr_state?: RiddleProofPrLifecycleState;
     marked_ready?: boolean;
     left_draft?: boolean;
+    ship_held?: boolean;
+    shipping_disabled?: boolean;
+    ship_authorized?: boolean;
     ci_status?: string;
     ship_commit?: string;
     ship_remote_head?: string;
@@ -338,6 +346,9 @@ interface RiddleProofRunResult {
     pr_state?: RiddleProofPrLifecycleState;
     marked_ready?: boolean;
     left_draft?: boolean;
+    ship_held?: boolean;
+    shipping_disabled?: boolean;
+    ship_authorized?: boolean;
     ci_status?: string;
     ship_commit?: string;
     ship_remote_head?: string;
@@ -376,6 +387,9 @@ interface RiddleProofRunStatusSnapshot {
     pr_url?: string | null;
     pr_branch?: string | null;
     pr_state?: RiddleProofPrLifecycleState;
+    ship_held?: boolean;
+    shipping_disabled?: boolean;
+    ship_authorized?: boolean;
     ci_status?: string;
     ship_commit?: string;
     ship_remote_head?: string;
@@ -528,6 +542,9 @@ interface RiddleProofTerminalMetadata {
     pr_state?: RiddleProofPrLifecycleState;
     marked_ready?: boolean;
     left_draft?: boolean;
+    ship_held?: boolean;
+    shipping_disabled?: boolean;
+    ship_authorized?: boolean;
     ci_status?: string;
     ship_commit?: string;
     ship_remote_head?: string;

package/dist/types.d.ts

@@ -136,6 +136,8 @@ interface RiddleProofCheckpointSummary {
     packet_count: number;
     response_count: number;
     duplicate_response_count?: number;
+    rejected_response_count?: number;
+    ignored_response_count?: number;
     latest_checkpoint?: string | null;
     latest_stage?: RiddleProofStage | null;
     latest_kind?: string | null;
@@ -239,6 +241,9 @@ interface RiddleProofRunCard {
     stop_condition: {
         status: RiddleProofStatus;
         terminal?: boolean;
+        ship_held?: boolean;
+        shipping_disabled?: boolean;
+        ship_authorized?: boolean;
         blocker_code?: string | null;
         blocker_message?: string | null;
         proof_decision?: RiddleProofDecision;
@@ -289,6 +294,9 @@ interface RiddleProofRunState {
     pr_state?: RiddleProofPrLifecycleState;
     marked_ready?: boolean;
     left_draft?: boolean;
+    ship_held?: boolean;
+    shipping_disabled?: boolean;
+    ship_authorized?: boolean;
     ci_status?: string;
     ship_commit?: string;
     ship_remote_head?: string;
@@ -338,6 +346,9 @@ interface RiddleProofRunResult {
     pr_state?: RiddleProofPrLifecycleState;
     marked_ready?: boolean;
     left_draft?: boolean;
+    ship_held?: boolean;
+    shipping_disabled?: boolean;
+    ship_authorized?: boolean;
     ci_status?: string;
     ship_commit?: string;
     ship_remote_head?: string;
@@ -376,6 +387,9 @@ interface RiddleProofRunStatusSnapshot {
     pr_url?: string | null;
     pr_branch?: string | null;
     pr_state?: RiddleProofPrLifecycleState;
+    ship_held?: boolean;
+    shipping_disabled?: boolean;
+    ship_authorized?: boolean;
     ci_status?: string;
     ship_commit?: string;
     ship_remote_head?: string;
@@ -528,6 +542,9 @@ interface RiddleProofTerminalMetadata {
     pr_state?: RiddleProofPrLifecycleState;
     marked_ready?: boolean;
     left_draft?: boolean;
+    ship_held?: boolean;
+    shipping_disabled?: boolean;
+    ship_authorized?: boolean;
     ci_status?: string;
     ship_commit?: string;
     ship_remote_head?: string;

package/package.json

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