@riddledc/riddle-proof 0.8.77 → 0.8.79

package/dist/change-proof.d.cts

@@ -1,10 +1,13 @@
 import { RiddleProofProfileResult, RiddleProofProfileStatus, RiddleProofProfileCheckResult } from './profile.cjs';
+import { RiddleProofObservationReceipt, RiddleProofSourceIdentity, RiddleProofObservationArtifact } from './receipts.cjs';
 import { JsonValue } from './types.cjs';
 import './public-state.cjs';
 
 declare const RIDDLE_PROOF_CHANGE_CONTRACT_VERSION: "riddle-proof.change-contract.v1";
 declare const RIDDLE_PROOF_CHANGE_RESULT_VERSION: "riddle-proof.change-result.v1";
-declare const RIDDLE_PROOF_CHANGE_RECEIPT_VERSION: "riddle-proof.change-receipt.v1";
+declare const RIDDLE_PROOF_CHANGE_RECEIPT_V1_VERSION: "riddle-proof.change-receipt.v1";
+declare const RIDDLE_PROOF_CHANGE_RECEIPT_VERSION: "riddle-proof.change-receipt.v2";
+declare const RIDDLE_PROOF_HANDOFF_RECEIPT_VERSION: "riddle-proof.handoff-receipt.v1";
 type RiddleProofChangeSide = "before" | "after";
 type RiddleProofChangeStatus = RiddleProofProfileStatus;
 type RiddleProofChangeDeltaStatus = "passed" | "failed" | "proof_insufficient" | "configuration_error";
@@ -13,6 +16,16 @@ interface RiddleProofChangeGroupContract {
     label?: string;
     required_status?: RiddleProofProfileStatus | RiddleProofProfileStatus[];
 }
+interface RiddleProofChangeSourceBindingRequirement {
+    preview_receipt_required?: boolean;
+    expected_git_revision?: string;
+    require_clean_source?: boolean;
+    require_content_digest?: boolean;
+}
+interface RiddleProofChangeSourceBindingContract {
+    before?: RiddleProofChangeSourceBindingRequirement;
+    after?: RiddleProofChangeSourceBindingRequirement;
+}
 interface RiddleProofProfileStatusTransitionDelta {
     type: "profile_status_transition";
     label?: string;
@@ -33,6 +46,7 @@ interface RiddleProofChangeContract {
     name: string;
     before?: RiddleProofChangeGroupContract;
     after?: RiddleProofChangeGroupContract;
+    source_binding?: RiddleProofChangeSourceBindingContract;
     deltas: RiddleProofChangeDelta[];
     metadata?: Record<string, JsonValue>;
 }
@@ -54,6 +68,21 @@ interface RiddleProofChangeDeltaResult {
     after_observed?: JsonValue;
     message?: string;
 }
+type RiddleProofChangeSourceBindingStatus = "not_required" | "matched" | "missing" | "mismatched" | "stale";
+interface RiddleProofChangeSourceBindingResult {
+    side: RiddleProofChangeSide;
+    required: boolean;
+    ok: boolean;
+    status: RiddleProofChangeSourceBindingStatus;
+    expected_git_revision?: string;
+    observed_git_revision?: string;
+    content_digest?: string;
+    preview_id?: string;
+    preview_url?: string;
+    target_url?: string;
+    expires_at?: string;
+    message?: string;
+}
 interface RiddleProofChangeResult {
     version: typeof RIDDLE_PROOF_CHANGE_RESULT_VERSION;
     contract_name: string;
@@ -63,12 +92,20 @@ interface RiddleProofChangeResult {
         after: RiddleProofChangeGroupResult;
     };
     deltas: RiddleProofChangeDeltaResult[];
+    source_bindings: {
+        before: RiddleProofChangeSourceBindingResult;
+        after: RiddleProofChangeSourceBindingResult;
+    };
     summary: string;
     metadata?: Record<string, JsonValue>;
 }
 interface AssessRiddleProofChangeInput {
     before_result?: RiddleProofProfileResult;
     after_result?: RiddleProofProfileResult;
+    before_observation?: RiddleProofObservationReceipt;
+    after_observation?: RiddleProofObservationReceipt;
+    expected_source_revisions?: Partial<Record<RiddleProofChangeSide, string>>;
+    evaluated_at?: string;
 }
 type RiddleProofChangeReceiptVerdict = "mergeable" | "not_mergeable" | "environment_blocked" | "needs_human_review" | "configuration_error" | "proof_insufficient";
 type RiddleProofChangeReceiptArtifactKind = "image" | "data" | "artifact";
@@ -107,8 +144,8 @@ interface RiddleProofChangeReceiptDelta {
     after_observed?: JsonValue;
     message?: string;
 }
-interface RiddleProofChangeReceipt {
-    version: typeof RIDDLE_PROOF_CHANGE_RECEIPT_VERSION;
+interface RiddleProofLegacyChangeReceipt {
+    version: typeof RIDDLE_PROOF_CHANGE_RECEIPT_V1_VERSION;
     contract_name: string;
     profile_name?: string;
     status: RiddleProofChangeStatus;
@@ -121,18 +158,73 @@ interface RiddleProofChangeReceipt {
     does_not_prove: string[];
     metadata?: Record<string, JsonValue>;
 }
+interface RiddleProofChangeRecommendation {
+    merge_recommended: boolean;
+    verdict: RiddleProofChangeReceiptVerdict;
+    label: string;
+    reason: string;
+}
+interface RiddleProofShippingAuthorization {
+    status: "not_granted" | "granted";
+    authorized: boolean;
+    source: "none" | "human" | "automation";
+    actor?: string;
+    at?: string;
+}
+interface RiddleProofChangeReceipt {
+    version: typeof RIDDLE_PROOF_CHANGE_RECEIPT_VERSION;
+    contract_name: string;
+    profile_name?: string;
+    status: RiddleProofChangeStatus;
+    verdict: RiddleProofChangeReceiptVerdict;
+    summary: string;
+    before: RiddleProofObservationReceipt;
+    after: RiddleProofObservationReceipt;
+    groups: RiddleProofChangeResult["groups"];
+    source_bindings: RiddleProofChangeResult["source_bindings"];
+    deltas: RiddleProofChangeReceiptDelta[];
+    recommendation: RiddleProofChangeRecommendation;
+    shipping_authorization: RiddleProofShippingAuthorization;
+    proves: string[];
+    does_not_prove: string[];
+    metadata?: Record<string, JsonValue>;
+}
+interface RiddleProofHandoffReceipt {
+    version: typeof RIDDLE_PROOF_HANDOFF_RECEIPT_VERSION;
+    change: RiddleProofChangeReceipt;
+    verdict: RiddleProofChangeReceiptVerdict;
+    recommendation: RiddleProofChangeRecommendation;
+    shipping_authorization: RiddleProofShippingAuthorization;
+    canonical_pair: {
+        before?: RiddleProofObservationArtifact;
+        after?: RiddleProofObservationArtifact;
+    };
+    created_at: string;
+}
 interface CreateRiddleProofChangeReceiptInput {
     contract: RiddleProofChangeContract;
     result: RiddleProofChangeResult;
-    before_result: RiddleProofProfileResult;
-    after_result: RiddleProofProfileResult;
-    before_source: string;
-    after_source: string;
+    before_result?: RiddleProofProfileResult;
+    after_result?: RiddleProofProfileResult;
+    before_source?: string;
+    after_source?: string;
+    before_observation?: RiddleProofObservationReceipt;
+    after_observation?: RiddleProofObservationReceipt;
+    before_source_identity?: RiddleProofSourceIdentity;
+    after_source_identity?: RiddleProofSourceIdentity;
+    shipping_authorization?: RiddleProofShippingAuthorization;
     profile_name?: string;
 }
 declare function assessRiddleProofChange(contract: RiddleProofChangeContract, input: AssessRiddleProofChangeInput): RiddleProofChangeResult;
 declare function createRiddleProofChangeReceipt(input: CreateRiddleProofChangeReceiptInput): RiddleProofChangeReceipt;
+declare function migrateRiddleProofChangeReceipt(legacy: RiddleProofLegacyChangeReceipt): RiddleProofChangeReceipt;
+declare function parseRiddleProofChangeReceipt(value: unknown): RiddleProofChangeReceipt;
+declare function createRiddleProofHandoffReceipt(changeReceipt: RiddleProofChangeReceipt, options?: {
+    created_at?: string;
+    shipping_authorization?: RiddleProofShippingAuthorization;
+}): RiddleProofHandoffReceipt;
+declare function parseRiddleProofHandoffReceipt(value: unknown): RiddleProofHandoffReceipt;
 declare function riddleProofChangeReceiptMarkdown(receipt: RiddleProofChangeReceipt): string;
 declare function riddleProofChangeReceiptHtml(receipt: RiddleProofChangeReceipt): string;
 
-export { type AssessRiddleProofChangeInput, type CreateRiddleProofChangeReceiptInput, RIDDLE_PROOF_CHANGE_CONTRACT_VERSION, RIDDLE_PROOF_CHANGE_RECEIPT_VERSION, RIDDLE_PROOF_CHANGE_RESULT_VERSION, type RiddleProofChangeContract, type RiddleProofChangeDelta, type RiddleProofChangeDeltaResult, type RiddleProofChangeDeltaStatus, type RiddleProofChangeGroupContract, type RiddleProofChangeGroupResult, type RiddleProofChangeProfileCheckStatus, type RiddleProofChangeReceipt, type RiddleProofChangeReceiptArtifact, type RiddleProofChangeReceiptArtifactKind, type RiddleProofChangeReceiptCheckCounts, type RiddleProofChangeReceiptDelta, type RiddleProofChangeReceiptSide, type RiddleProofChangeReceiptVerdict, type RiddleProofChangeResult, type RiddleProofChangeSide, type RiddleProofChangeStatus, type RiddleProofCheckStatusTransitionDelta, type RiddleProofProfileStatusTransitionDelta, assessRiddleProofChange, createRiddleProofChangeReceipt, riddleProofChangeReceiptHtml, riddleProofChangeReceiptMarkdown };
+export { type AssessRiddleProofChangeInput, type CreateRiddleProofChangeReceiptInput, RIDDLE_PROOF_CHANGE_CONTRACT_VERSION, RIDDLE_PROOF_CHANGE_RECEIPT_V1_VERSION, RIDDLE_PROOF_CHANGE_RECEIPT_VERSION, RIDDLE_PROOF_CHANGE_RESULT_VERSION, RIDDLE_PROOF_HANDOFF_RECEIPT_VERSION, type RiddleProofChangeContract, type RiddleProofChangeDelta, type RiddleProofChangeDeltaResult, type RiddleProofChangeDeltaStatus, type RiddleProofChangeGroupContract, type RiddleProofChangeGroupResult, type RiddleProofChangeProfileCheckStatus, type RiddleProofChangeReceipt, type RiddleProofChangeReceiptArtifact, type RiddleProofChangeReceiptArtifactKind, type RiddleProofChangeReceiptCheckCounts, type RiddleProofChangeReceiptDelta, type RiddleProofChangeReceiptSide, type RiddleProofChangeReceiptVerdict, type RiddleProofChangeRecommendation, type RiddleProofChangeResult, type RiddleProofChangeSide, type RiddleProofChangeSourceBindingContract, type RiddleProofChangeSourceBindingRequirement, type RiddleProofChangeSourceBindingResult, type RiddleProofChangeSourceBindingStatus, type RiddleProofChangeStatus, type RiddleProofCheckStatusTransitionDelta, type RiddleProofHandoffReceipt, type RiddleProofLegacyChangeReceipt, type RiddleProofProfileStatusTransitionDelta, type RiddleProofShippingAuthorization, assessRiddleProofChange, createRiddleProofChangeReceipt, createRiddleProofHandoffReceipt, migrateRiddleProofChangeReceipt, parseRiddleProofChangeReceipt, parseRiddleProofHandoffReceipt, riddleProofChangeReceiptHtml, riddleProofChangeReceiptMarkdown };

package/dist/change-proof.d.ts

@@ -1,10 +1,13 @@
 import { RiddleProofProfileResult, RiddleProofProfileStatus, RiddleProofProfileCheckResult } from './profile.js';
+import { RiddleProofObservationReceipt, RiddleProofSourceIdentity, RiddleProofObservationArtifact } from './receipts.js';
 import { JsonValue } from './types.js';
 import './public-state.js';
 
 declare const RIDDLE_PROOF_CHANGE_CONTRACT_VERSION: "riddle-proof.change-contract.v1";
 declare const RIDDLE_PROOF_CHANGE_RESULT_VERSION: "riddle-proof.change-result.v1";
-declare const RIDDLE_PROOF_CHANGE_RECEIPT_VERSION: "riddle-proof.change-receipt.v1";
+declare const RIDDLE_PROOF_CHANGE_RECEIPT_V1_VERSION: "riddle-proof.change-receipt.v1";
+declare const RIDDLE_PROOF_CHANGE_RECEIPT_VERSION: "riddle-proof.change-receipt.v2";
+declare const RIDDLE_PROOF_HANDOFF_RECEIPT_VERSION: "riddle-proof.handoff-receipt.v1";
 type RiddleProofChangeSide = "before" | "after";
 type RiddleProofChangeStatus = RiddleProofProfileStatus;
 type RiddleProofChangeDeltaStatus = "passed" | "failed" | "proof_insufficient" | "configuration_error";
@@ -13,6 +16,16 @@ interface RiddleProofChangeGroupContract {
     label?: string;
     required_status?: RiddleProofProfileStatus | RiddleProofProfileStatus[];
 }
+interface RiddleProofChangeSourceBindingRequirement {
+    preview_receipt_required?: boolean;
+    expected_git_revision?: string;
+    require_clean_source?: boolean;
+    require_content_digest?: boolean;
+}
+interface RiddleProofChangeSourceBindingContract {
+    before?: RiddleProofChangeSourceBindingRequirement;
+    after?: RiddleProofChangeSourceBindingRequirement;
+}
 interface RiddleProofProfileStatusTransitionDelta {
     type: "profile_status_transition";
     label?: string;
@@ -33,6 +46,7 @@ interface RiddleProofChangeContract {
     name: string;
     before?: RiddleProofChangeGroupContract;
     after?: RiddleProofChangeGroupContract;
+    source_binding?: RiddleProofChangeSourceBindingContract;
     deltas: RiddleProofChangeDelta[];
     metadata?: Record<string, JsonValue>;
 }
@@ -54,6 +68,21 @@ interface RiddleProofChangeDeltaResult {
     after_observed?: JsonValue;
     message?: string;
 }
+type RiddleProofChangeSourceBindingStatus = "not_required" | "matched" | "missing" | "mismatched" | "stale";
+interface RiddleProofChangeSourceBindingResult {
+    side: RiddleProofChangeSide;
+    required: boolean;
+    ok: boolean;
+    status: RiddleProofChangeSourceBindingStatus;
+    expected_git_revision?: string;
+    observed_git_revision?: string;
+    content_digest?: string;
+    preview_id?: string;
+    preview_url?: string;
+    target_url?: string;
+    expires_at?: string;
+    message?: string;
+}
 interface RiddleProofChangeResult {
     version: typeof RIDDLE_PROOF_CHANGE_RESULT_VERSION;
     contract_name: string;
@@ -63,12 +92,20 @@ interface RiddleProofChangeResult {
         after: RiddleProofChangeGroupResult;
     };
     deltas: RiddleProofChangeDeltaResult[];
+    source_bindings: {
+        before: RiddleProofChangeSourceBindingResult;
+        after: RiddleProofChangeSourceBindingResult;
+    };
     summary: string;
     metadata?: Record<string, JsonValue>;
 }
 interface AssessRiddleProofChangeInput {
     before_result?: RiddleProofProfileResult;
     after_result?: RiddleProofProfileResult;
+    before_observation?: RiddleProofObservationReceipt;
+    after_observation?: RiddleProofObservationReceipt;
+    expected_source_revisions?: Partial<Record<RiddleProofChangeSide, string>>;
+    evaluated_at?: string;
 }
 type RiddleProofChangeReceiptVerdict = "mergeable" | "not_mergeable" | "environment_blocked" | "needs_human_review" | "configuration_error" | "proof_insufficient";
 type RiddleProofChangeReceiptArtifactKind = "image" | "data" | "artifact";
@@ -107,8 +144,8 @@ interface RiddleProofChangeReceiptDelta {
     after_observed?: JsonValue;
     message?: string;
 }
-interface RiddleProofChangeReceipt {
-    version: typeof RIDDLE_PROOF_CHANGE_RECEIPT_VERSION;
+interface RiddleProofLegacyChangeReceipt {
+    version: typeof RIDDLE_PROOF_CHANGE_RECEIPT_V1_VERSION;
     contract_name: string;
     profile_name?: string;
     status: RiddleProofChangeStatus;
@@ -121,18 +158,73 @@ interface RiddleProofChangeReceipt {
     does_not_prove: string[];
     metadata?: Record<string, JsonValue>;
 }
+interface RiddleProofChangeRecommendation {
+    merge_recommended: boolean;
+    verdict: RiddleProofChangeReceiptVerdict;
+    label: string;
+    reason: string;
+}
+interface RiddleProofShippingAuthorization {
+    status: "not_granted" | "granted";
+    authorized: boolean;
+    source: "none" | "human" | "automation";
+    actor?: string;
+    at?: string;
+}
+interface RiddleProofChangeReceipt {
+    version: typeof RIDDLE_PROOF_CHANGE_RECEIPT_VERSION;
+    contract_name: string;
+    profile_name?: string;
+    status: RiddleProofChangeStatus;
+    verdict: RiddleProofChangeReceiptVerdict;
+    summary: string;
+    before: RiddleProofObservationReceipt;
+    after: RiddleProofObservationReceipt;
+    groups: RiddleProofChangeResult["groups"];
+    source_bindings: RiddleProofChangeResult["source_bindings"];
+    deltas: RiddleProofChangeReceiptDelta[];
+    recommendation: RiddleProofChangeRecommendation;
+    shipping_authorization: RiddleProofShippingAuthorization;
+    proves: string[];
+    does_not_prove: string[];
+    metadata?: Record<string, JsonValue>;
+}
+interface RiddleProofHandoffReceipt {
+    version: typeof RIDDLE_PROOF_HANDOFF_RECEIPT_VERSION;
+    change: RiddleProofChangeReceipt;
+    verdict: RiddleProofChangeReceiptVerdict;
+    recommendation: RiddleProofChangeRecommendation;
+    shipping_authorization: RiddleProofShippingAuthorization;
+    canonical_pair: {
+        before?: RiddleProofObservationArtifact;
+        after?: RiddleProofObservationArtifact;
+    };
+    created_at: string;
+}
 interface CreateRiddleProofChangeReceiptInput {
     contract: RiddleProofChangeContract;
     result: RiddleProofChangeResult;
-    before_result: RiddleProofProfileResult;
-    after_result: RiddleProofProfileResult;
-    before_source: string;
-    after_source: string;
+    before_result?: RiddleProofProfileResult;
+    after_result?: RiddleProofProfileResult;
+    before_source?: string;
+    after_source?: string;
+    before_observation?: RiddleProofObservationReceipt;
+    after_observation?: RiddleProofObservationReceipt;
+    before_source_identity?: RiddleProofSourceIdentity;
+    after_source_identity?: RiddleProofSourceIdentity;
+    shipping_authorization?: RiddleProofShippingAuthorization;
     profile_name?: string;
 }
 declare function assessRiddleProofChange(contract: RiddleProofChangeContract, input: AssessRiddleProofChangeInput): RiddleProofChangeResult;
 declare function createRiddleProofChangeReceipt(input: CreateRiddleProofChangeReceiptInput): RiddleProofChangeReceipt;
+declare function migrateRiddleProofChangeReceipt(legacy: RiddleProofLegacyChangeReceipt): RiddleProofChangeReceipt;
+declare function parseRiddleProofChangeReceipt(value: unknown): RiddleProofChangeReceipt;
+declare function createRiddleProofHandoffReceipt(changeReceipt: RiddleProofChangeReceipt, options?: {
+    created_at?: string;
+    shipping_authorization?: RiddleProofShippingAuthorization;
+}): RiddleProofHandoffReceipt;
+declare function parseRiddleProofHandoffReceipt(value: unknown): RiddleProofHandoffReceipt;
 declare function riddleProofChangeReceiptMarkdown(receipt: RiddleProofChangeReceipt): string;
 declare function riddleProofChangeReceiptHtml(receipt: RiddleProofChangeReceipt): string;
 
-export { type AssessRiddleProofChangeInput, type CreateRiddleProofChangeReceiptInput, RIDDLE_PROOF_CHANGE_CONTRACT_VERSION, RIDDLE_PROOF_CHANGE_RECEIPT_VERSION, RIDDLE_PROOF_CHANGE_RESULT_VERSION, type RiddleProofChangeContract, type RiddleProofChangeDelta, type RiddleProofChangeDeltaResult, type RiddleProofChangeDeltaStatus, type RiddleProofChangeGroupContract, type RiddleProofChangeGroupResult, type RiddleProofChangeProfileCheckStatus, type RiddleProofChangeReceipt, type RiddleProofChangeReceiptArtifact, type RiddleProofChangeReceiptArtifactKind, type RiddleProofChangeReceiptCheckCounts, type RiddleProofChangeReceiptDelta, type RiddleProofChangeReceiptSide, type RiddleProofChangeReceiptVerdict, type RiddleProofChangeResult, type RiddleProofChangeSide, type RiddleProofChangeStatus, type RiddleProofCheckStatusTransitionDelta, type RiddleProofProfileStatusTransitionDelta, assessRiddleProofChange, createRiddleProofChangeReceipt, riddleProofChangeReceiptHtml, riddleProofChangeReceiptMarkdown };
+export { type AssessRiddleProofChangeInput, type CreateRiddleProofChangeReceiptInput, RIDDLE_PROOF_CHANGE_CONTRACT_VERSION, RIDDLE_PROOF_CHANGE_RECEIPT_V1_VERSION, RIDDLE_PROOF_CHANGE_RECEIPT_VERSION, RIDDLE_PROOF_CHANGE_RESULT_VERSION, RIDDLE_PROOF_HANDOFF_RECEIPT_VERSION, type RiddleProofChangeContract, type RiddleProofChangeDelta, type RiddleProofChangeDeltaResult, type RiddleProofChangeDeltaStatus, type RiddleProofChangeGroupContract, type RiddleProofChangeGroupResult, type RiddleProofChangeProfileCheckStatus, type RiddleProofChangeReceipt, type RiddleProofChangeReceiptArtifact, type RiddleProofChangeReceiptArtifactKind, type RiddleProofChangeReceiptCheckCounts, type RiddleProofChangeReceiptDelta, type RiddleProofChangeReceiptSide, type RiddleProofChangeReceiptVerdict, type RiddleProofChangeRecommendation, type RiddleProofChangeResult, type RiddleProofChangeSide, type RiddleProofChangeSourceBindingContract, type RiddleProofChangeSourceBindingRequirement, type RiddleProofChangeSourceBindingResult, type RiddleProofChangeSourceBindingStatus, type RiddleProofChangeStatus, type RiddleProofCheckStatusTransitionDelta, type RiddleProofHandoffReceipt, type RiddleProofLegacyChangeReceipt, type RiddleProofProfileStatusTransitionDelta, type RiddleProofShippingAuthorization, assessRiddleProofChange, createRiddleProofChangeReceipt, createRiddleProofHandoffReceipt, migrateRiddleProofChangeReceipt, parseRiddleProofChangeReceipt, parseRiddleProofHandoffReceipt, riddleProofChangeReceiptHtml, riddleProofChangeReceiptMarkdown };

package/dist/change-proof.js

@@ -1,19 +1,33 @@
 import {
   RIDDLE_PROOF_CHANGE_CONTRACT_VERSION,
+  RIDDLE_PROOF_CHANGE_RECEIPT_V1_VERSION,
   RIDDLE_PROOF_CHANGE_RECEIPT_VERSION,
   RIDDLE_PROOF_CHANGE_RESULT_VERSION,
+  RIDDLE_PROOF_HANDOFF_RECEIPT_VERSION,
   assessRiddleProofChange,
   createRiddleProofChangeReceipt,
+  createRiddleProofHandoffReceipt,
+  migrateRiddleProofChangeReceipt,
+  parseRiddleProofChangeReceipt,
+  parseRiddleProofHandoffReceipt,
   riddleProofChangeReceiptHtml,
   riddleProofChangeReceiptMarkdown
-} from "./chunk-BILL3UC2.js";
+} from "./chunk-6VFS2JFR.js";
+import "./chunk-MEVVL4TI.js";
+import "./chunk-FCSJZBC5.js";
 import "./chunk-MLKGABMK.js";
 export {
   RIDDLE_PROOF_CHANGE_CONTRACT_VERSION,
+  RIDDLE_PROOF_CHANGE_RECEIPT_V1_VERSION,
   RIDDLE_PROOF_CHANGE_RECEIPT_VERSION,
   RIDDLE_PROOF_CHANGE_RESULT_VERSION,
+  RIDDLE_PROOF_HANDOFF_RECEIPT_VERSION,
   assessRiddleProofChange,
   createRiddleProofChangeReceipt,
+  createRiddleProofHandoffReceipt,
+  migrateRiddleProofChangeReceipt,
+  parseRiddleProofChangeReceipt,
+  parseRiddleProofHandoffReceipt,
   riddleProofChangeReceiptHtml,
   riddleProofChangeReceiptMarkdown
 };

package/dist/{chunk-B2DP2LET.js → chunk-5IFZSUPF.js}

@@ -1,3 +1,7 @@
+import {
+  parseRiddlePreviewReceipt
+} from "./chunk-MEVVL4TI.js";
+
 // src/riddle-client.ts
 import { execFileSync } from "child_process";
 import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync } from "fs";
@@ -64,6 +68,7 @@ async function getRiddleBalance(config = {}) {
 }
 function previewDeployResultFromRecord(input) {
   const { record, id, label, framework, expiresAt, publishRecovered, publishError } = input;
+  const receipt = record.receipt && typeof record.receipt === "object" ? parseRiddlePreviewReceipt(record.receipt) : void 0;
   return {
     ok: true,
     id: String(record.id || record.preview_id || id),
@@ -72,13 +77,32 @@ function previewDeployResultFromRecord(input) {
     preview_url: String(record.preview_url || ""),
     file_count: typeof record.file_count === "number" ? record.file_count : void 0,
     total_bytes: typeof record.total_bytes === "number" ? record.total_bytes : void 0,
-    expires_at: expiresAt,
+    expires_at: receipt?.expires_at || expiresAt,
+    receipt,
     publish_recovered: publishRecovered || void 0,
     publish_error: publishError,
     warnings: input.warnings?.length ? input.warnings : void 0,
     raw: record
   };
 }
+function gitOutput(directory, args) {
+  try {
+    return execFileSync("git", ["-C", directory, ...args], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+  } catch {
+    return "";
+  }
+}
+function detectRiddlePreviewSource(directory) {
+  const gitRevision = gitOutput(directory, ["rev-parse", "HEAD"]);
+  if (!gitRevision) return {};
+  const repository = gitOutput(directory, ["config", "--get", "remote.origin.url"]);
+  const status = gitOutput(directory, ["status", "--porcelain", "--untracked-files=normal"]);
+  return {
+    git_revision: gitRevision,
+    repository: repository || void 0,
+    dirty: Boolean(status)
+  };
+}
 function canRecoverPreviewPublish(error) {
   return error instanceof RiddleApiError && PREVIEW_PUBLISH_RECOVERY_STATUSES.has(error.status);
 }
@@ -161,12 +185,13 @@ async function waitForPublishedPreview(config, input) {
   }
   throw input.publishError;
 }
-async function deployRiddlePreview(config, directory, label, framework = "static") {
+async function deployRiddlePreview(config, directory, label, framework = "static", options = {}) {
   if (!directory?.trim()) throw new Error("directory is required");
   if (!label?.trim()) throw new Error("label is required");
   if (framework !== "spa" && framework !== "static") throw new Error("framework must be spa or static");
   const startedAt = Date.now();
   const warnings = collectRiddlePreviewDeployWarnings(directory, framework);
+  const source = options.source || detectRiddlePreviewSource(directory);
   const emitProgress = previewProgressEmitter(config, { label, framework, directory, startedAt, warnings });
   await emitProgress({ stage: "validating", message: "checking preview input directory" });
   const localSummary = summarizePreviewDirectory(directory);
@@ -178,7 +203,7 @@ async function deployRiddlePreview(config, directory, label, framework = "static
   });
   const created = await riddleRequestJson(config, "/v1/preview", {
     method: "POST",
-    body: JSON.stringify({ framework, label })
+    body: JSON.stringify({ framework, label, source })
   });
   const id = String(created.id || "");
   const uploadUrl = String(created.upload_url || "");
@@ -320,8 +345,8 @@ function collectRiddlePreviewDeployWarnings(directory, framework = "static") {
     return [];
   }
 }
-async function deployRiddleStaticPreview(config, directory, label) {
-  return deployRiddlePreview(config, directory, label, "static");
+async function deployRiddleStaticPreview(config, directory, label, options = {}) {
+  return deployRiddlePreview(config, directory, label, "static", options);
 }
 function createTarball(directory, label, exclude = []) {
   const scratch = mkdtempSync(path.join(tmpdir(), "riddle-upload-"));
@@ -443,21 +468,31 @@ function parseTimestampMs(value) {
 }
 function buildPollSnapshot(jobId, job, input) {
   const status = job?.status ? String(job.status) : null;
+  const phase = job?.phase ? String(job.phase) : null;
   const terminal = isTerminalRiddleJobStatus(status);
   const createdAt = stringField(job, "created_at");
   const submittedAt = stringField(job, "submitted_at");
   const completedAt = stringField(job, "completed_at");
   const createdMs = parseTimestampMs(createdAt);
   const submittedMs = parseTimestampMs(submittedAt);
+  const rawExecution = job?.execution && typeof job.execution === "object" && !Array.isArray(job.execution) ? job.execution : null;
+  const enqueuedAt = rawExecution ? stringField(rawExecution, "enqueued_at") : null;
+  const enqueuedMs = parseTimestampMs(enqueuedAt);
+  const queueStartedMs = enqueuedMs ?? createdMs;
+  const claimedAt = rawExecution ? stringField(rawExecution, "claimed_at") : null;
+  const claimedMs = parseTimestampMs(claimedAt);
   let queueElapsedMs = null;
-  if (createdMs !== null && submittedMs !== null) {
-    queueElapsedMs = Math.max(0, submittedMs - createdMs);
-  } else if (createdMs !== null && !submittedAt && !terminal) {
-    queueElapsedMs = Math.max(0, input.observedAt - createdMs);
+  if (queueStartedMs !== null && claimedMs !== null) {
+    queueElapsedMs = Math.max(0, claimedMs - queueStartedMs);
+  } else if (queueStartedMs !== null && submittedMs !== null) {
+    queueElapsedMs = Math.max(0, submittedMs - queueStartedMs);
+  } else if (queueStartedMs !== null && !submittedAt && !terminal) {
+    queueElapsedMs = Math.max(0, input.observedAt - queueStartedMs);
   }
   return {
     job_id: jobId,
     status,
+    phase,
     terminal,
     attempt: input.attempt,
     attempts: input.attempts,
@@ -467,7 +502,9 @@ function buildPollSnapshot(jobId, job, input) {
     completed_at: completedAt,
     queue_elapsed_ms: queueElapsedMs,
     pre_submission_elapsed_ms: Math.max(0, Math.floor(input.preSubmissionElapsedMs ?? 0)),
-    running_without_submission: Boolean(status && !terminal && !submittedAt)
+    running_without_submission: Boolean(status && !terminal && !submittedAt),
+    active_execution: Boolean(status === "running" && phase && phase !== "queued"),
+    execution: rawExecution ? rawExecution : void 0
   };
 }
 function pollMessage(snapshot, timedOut) {
@@ -476,7 +513,7 @@ function pollMessage(snapshot, timedOut) {
   const wakeHint = snapshot.running_without_submission && !snapshot.created_at && !snapshot.submitted_at ? ` ${RIDDLE_UNSUBMITTED_WAKE_HINT}.` : "";
   const queue = snapshot.queue_elapsed_ms !== null ? ` queue_elapsed_ms=${snapshot.queue_elapsed_ms}` : "";
   const preSubmit = snapshot.pre_submission_elapsed_ms > 0 ? ` pre_submission_elapsed_ms=${snapshot.pre_submission_elapsed_ms}` : "";
-  return `Riddle job ${snapshot.job_id} did not reach a terminal status after ${snapshot.attempt} poll attempts; status=${snapshot.status || "unknown"} submitted_at=${submitted}.${wakeHint}${queue}${preSubmit}`;
+  return `Riddle job ${snapshot.job_id} did not reach a terminal status after ${snapshot.attempt} poll attempts; status=${snapshot.status || "unknown"} phase=${snapshot.phase || "unknown"} submitted_at=${submitted}.${wakeHint}${queue}${preSubmit}`;
 }
 async function pollRiddleJob(config, jobId, options = {}) {
   if (!jobId?.trim()) throw new Error("jobId is required");
@@ -510,6 +547,7 @@ async function pollRiddleJob(config, jobId, options = {}) {
     };
     const progressKey = [
       lastSnapshot.status || "unknown",
+      lastSnapshot.phase || "unknown",
       lastSnapshot.terminal ? "terminal" : "nonterminal",
       lastSnapshot.submitted_at ? "submitted" : "unsubmitted"
     ].join(":");
@@ -576,8 +614,8 @@ function createRiddleApiClient(config = {}) {
     apiKeySource: () => resolveRiddleApiKeySource(config),
     requestJson: (pathname, init) => riddleRequestJson(config, pathname, init),
     getBalance: () => getRiddleBalance(config),
-    deployPreview: (directory, label, framework = "static") => deployRiddlePreview(config, directory, label, framework),
-    deployStaticPreview: (directory, label) => deployRiddleStaticPreview(config, directory, label),
+    deployPreview: (directory, label, framework = "static", options) => deployRiddlePreview(config, directory, label, framework, options),
+    deployStaticPreview: (directory, label, options) => deployRiddleStaticPreview(config, directory, label, options),
     runScript: (input) => runRiddleScript(config, input),
     runServerPreview: (input) => runRiddleServerPreview(config, input),
     pollJob: (jobId, options) => pollRiddleJob(config, jobId, options)
@@ -593,6 +631,7 @@ export {
   resolveRiddleApiKey,
   riddleRequestJson,
   getRiddleBalance,
+  detectRiddlePreviewSource,
   deployRiddlePreview,
   collectRiddlePreviewDeployWarnings,
   deployRiddleStaticPreview,