@riddledc/riddle-proof 0.4.3 → 0.4.4

package/dist/state.cjs

@@ -23,9 +23,11 @@ __export(state_exports, {
   RIDDLE_PROOF_RUN_STATE_VERSION: () => RIDDLE_PROOF_RUN_STATE_VERSION,
   appendRunEvent: () => appendRunEvent,
   appendStageHeartbeat: () => appendStageHeartbeat,
+  applyPrLifecycleState: () => applyPrLifecycleState,
   createRunState: () => createRunState,
   createRunStatusSnapshot: () => createRunStatusSnapshot,
   normalizeIntegrationContext: () => normalizeIntegrationContext,
+  normalizePrLifecycleState: () => normalizePrLifecycleState,
   normalizeRunParams: () => normalizeRunParams,
   setRunStatus: () => setRunStatus
 });
@@ -58,6 +60,36 @@ function elapsedMs(start, end) {
   if (!Number.isFinite(startMs) || !Number.isFinite(endMs)) return void 0;
   return Math.max(0, endMs - startMs);
 }
+function normalizePrStatus(value) {
+  const status = nonEmptyString(value)?.toLowerCase();
+  if (status === "merged") return "merged";
+  if (status === "open") return "open";
+  if (status === "closed") return "closed";
+  if (status === "not_found" || status === "not-found") return "not_found";
+  if (status === "unavailable") return "unavailable";
+  return status || "unknown";
+}
+function normalizePrLifecycleState(input, checkedAt = timestamp()) {
+  const value = recordValue(input);
+  if (!value) return void 0;
+  const cleanup = recordValue(value.cleanup);
+  const mergeCommit = nonEmptyString(value.merge_commit) || nonEmptyString(value.mergeCommit) || nonEmptyString(recordValue(value.mergeCommit)?.oid);
+  return compactRecord({
+    status: normalizePrStatus(value.status || value.state),
+    pr_url: nonEmptyString(value.pr_url) || nonEmptyString(value.prUrl) || nonEmptyString(value.url),
+    pr_number: nonEmptyString(value.pr_number) || nonEmptyString(value.prNumber) || (typeof value.number === "number" ? String(value.number) : void 0),
+    repo: nonEmptyString(value.repo) || nonEmptyString(value.repository),
+    head_branch: nonEmptyString(value.head_branch) || nonEmptyString(value.headBranch) || nonEmptyString(value.headRefName),
+    base_branch: nonEmptyString(value.base_branch) || nonEmptyString(value.baseBranch) || nonEmptyString(value.baseRefName),
+    merge_commit: mergeCommit,
+    merged_at: nonEmptyString(value.merged_at) || nonEmptyString(value.mergedAt),
+    closed_at: nonEmptyString(value.closed_at) || nonEmptyString(value.closedAt),
+    checked_at: nonEmptyString(value.checked_at) || nonEmptyString(value.checkedAt) || checkedAt,
+    source: nonEmptyString(value.source),
+    next_action: nonEmptyString(value.next_action) || nonEmptyString(value.nextAction),
+    cleanup: cleanup && Object.keys(cleanup).length ? cleanup : void 0
+  });
+}
 function normalizeIntegrationContext(input, fallbackSource) {
   const value = recordValue(input);
   if (!value) {
@@ -181,6 +213,16 @@ function createRunStatusSnapshot(state, at = timestamp()) {
     state_path: state.state_path ?? null,
     worktree_path: state.worktree_path ?? null,
     branch: state.branch ?? null,
+    pr_url: state.pr_url ?? null,
+    pr_branch: state.pr_branch ?? null,
+    pr_state: state.pr_state,
+    ci_status: state.ci_status,
+    ship_commit: state.ship_commit,
+    ship_remote_head: state.ship_remote_head,
+    merge_commit: state.merge_commit,
+    merged_at: state.merged_at,
+    proof_comment_url: state.proof_comment_url,
+    cleanup_report: state.cleanup_report,
     iterations: state.iterations,
     last_checkpoint: state.last_checkpoint ?? null,
     updated_at: state.updated_at,
@@ -196,14 +238,33 @@ function setRunStatus(state, status, at = timestamp()) {
   state.updated_at = at;
   return state;
 }
+function applyPrLifecycleState(state, input, at = timestamp()) {
+  const prState = normalizePrLifecycleState(input, at);
+  if (!prState) return state;
+  state.pr_state = prState;
+  if (prState.pr_url) state.pr_url = prState.pr_url;
+  if (prState.head_branch) state.pr_branch = prState.head_branch;
+  if (prState.merge_commit) state.merge_commit = prState.merge_commit;
+  if (prState.merged_at) state.merged_at = prState.merged_at;
+  if (prState.cleanup) state.cleanup_report = prState.cleanup;
+  if (prState.status === "merged") {
+    state.finalized = true;
+    state.status = "completed";
+    state.ok = true;
+  }
+  state.updated_at = at;
+  return state;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   RIDDLE_PROOF_RUN_STATE_VERSION,
   appendRunEvent,
   appendStageHeartbeat,
+  applyPrLifecycleState,
   createRunState,
   createRunStatusSnapshot,
   normalizeIntegrationContext,
+  normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
 });

package/dist/state.d.cts

@@ -1,4 +1,4 @@
-import { RiddleProofRunParams, RiddleProofStatus, RiddleProofStage, RiddleProofEvent, RiddleProofRunState, RiddleProofRunStatusSnapshot, IntegrationContext } from './types.cjs';
+import { RiddleProofRunParams, RiddleProofStatus, RiddleProofStage, RiddleProofEvent, RiddleProofRunState, RiddleProofPrLifecycleState, RiddleProofRunStatusSnapshot, IntegrationContext } from './types.cjs';
 
 declare const RIDDLE_PROOF_RUN_STATE_VERSION: "riddle-proof.run-state.v1";
 interface CreateRunStateInput {
@@ -19,6 +19,7 @@ interface CreateRunStateInput {
 type RunEventInput = Omit<RiddleProofEvent, "ts"> & {
     ts?: string;
 };
+declare function normalizePrLifecycleState(input?: Partial<RiddleProofPrLifecycleState> | Record<string, unknown> | null, checkedAt?: string): RiddleProofPrLifecycleState | undefined;
 declare function normalizeIntegrationContext(input?: Partial<IntegrationContext> | Record<string, unknown> | null, fallbackSource?: IntegrationContext["source"]): IntegrationContext | undefined;
 declare function normalizeRunParams(input: RiddleProofRunParams): RiddleProofRunParams;
 declare function createRunState(input: CreateRunStateInput): RiddleProofRunState;
@@ -34,5 +35,6 @@ declare function appendStageHeartbeat<T extends RiddleProofRunState>(state: T, i
 }): T;
 declare function createRunStatusSnapshot(state: RiddleProofRunState, at?: string): RiddleProofRunStatusSnapshot;
 declare function setRunStatus<T extends RiddleProofRunState>(state: T, status: RiddleProofStatus, at?: string): T;
+declare function applyPrLifecycleState<T extends RiddleProofRunState>(state: T, input?: Partial<RiddleProofPrLifecycleState> | Record<string, unknown> | null, at?: string): T;
 
-export { type CreateRunStateInput, RIDDLE_PROOF_RUN_STATE_VERSION, type RunEventInput, appendRunEvent, appendStageHeartbeat, createRunState, createRunStatusSnapshot, normalizeIntegrationContext, normalizeRunParams, setRunStatus };
+export { type CreateRunStateInput, RIDDLE_PROOF_RUN_STATE_VERSION, type RunEventInput, appendRunEvent, appendStageHeartbeat, applyPrLifecycleState, createRunState, createRunStatusSnapshot, normalizeIntegrationContext, normalizePrLifecycleState, normalizeRunParams, setRunStatus };

package/dist/state.d.ts

@@ -1,4 +1,4 @@
-import { RiddleProofRunParams, RiddleProofStatus, RiddleProofStage, RiddleProofEvent, RiddleProofRunState, RiddleProofRunStatusSnapshot, IntegrationContext } from './types.js';
+import { RiddleProofRunParams, RiddleProofStatus, RiddleProofStage, RiddleProofEvent, RiddleProofRunState, RiddleProofPrLifecycleState, RiddleProofRunStatusSnapshot, IntegrationContext } from './types.js';
 
 declare const RIDDLE_PROOF_RUN_STATE_VERSION: "riddle-proof.run-state.v1";
 interface CreateRunStateInput {
@@ -19,6 +19,7 @@ interface CreateRunStateInput {
 type RunEventInput = Omit<RiddleProofEvent, "ts"> & {
     ts?: string;
 };
+declare function normalizePrLifecycleState(input?: Partial<RiddleProofPrLifecycleState> | Record<string, unknown> | null, checkedAt?: string): RiddleProofPrLifecycleState | undefined;
 declare function normalizeIntegrationContext(input?: Partial<IntegrationContext> | Record<string, unknown> | null, fallbackSource?: IntegrationContext["source"]): IntegrationContext | undefined;
 declare function normalizeRunParams(input: RiddleProofRunParams): RiddleProofRunParams;
 declare function createRunState(input: CreateRunStateInput): RiddleProofRunState;
@@ -34,5 +35,6 @@ declare function appendStageHeartbeat<T extends RiddleProofRunState>(state: T, i
 }): T;
 declare function createRunStatusSnapshot(state: RiddleProofRunState, at?: string): RiddleProofRunStatusSnapshot;
 declare function setRunStatus<T extends RiddleProofRunState>(state: T, status: RiddleProofStatus, at?: string): T;
+declare function applyPrLifecycleState<T extends RiddleProofRunState>(state: T, input?: Partial<RiddleProofPrLifecycleState> | Record<string, unknown> | null, at?: string): T;
 
-export { type CreateRunStateInput, RIDDLE_PROOF_RUN_STATE_VERSION, type RunEventInput, appendRunEvent, appendStageHeartbeat, createRunState, createRunStatusSnapshot, normalizeIntegrationContext, normalizeRunParams, setRunStatus };
+export { type CreateRunStateInput, RIDDLE_PROOF_RUN_STATE_VERSION, type RunEventInput, appendRunEvent, appendStageHeartbeat, applyPrLifecycleState, createRunState, createRunStatusSnapshot, normalizeIntegrationContext, normalizePrLifecycleState, normalizeRunParams, setRunStatus };

package/dist/state.js

@@ -2,20 +2,24 @@ import {
   RIDDLE_PROOF_RUN_STATE_VERSION,
   appendRunEvent,
   appendStageHeartbeat,
+  applyPrLifecycleState,
   createRunState,
   createRunStatusSnapshot,
   normalizeIntegrationContext,
+  normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
-} from "./chunk-AHQIV5QN.js";
-import "./chunk-VFO5WY5X.js";
+} from "./chunk-SIQG3N6F.js";
+import "./chunk-TMMKRKY5.js";
 export {
   RIDDLE_PROOF_RUN_STATE_VERSION,
   appendRunEvent,
   appendStageHeartbeat,
+  applyPrLifecycleState,
   createRunState,
   createRunStatusSnapshot,
   normalizeIntegrationContext,
+  normalizePrLifecycleState,
   normalizeRunParams,
   setRunStatus
 };

package/dist/types.d.cts

@@ -4,6 +4,7 @@ type JsonObject = {
     [key: string]: JsonValue;
 };
 type RiddleProofStatus = "running" | "blocked" | "failed" | "ready_to_ship" | "shipped" | "completed";
+type RiddleProofPrLifecycleStatus = "unknown" | "open" | "merged" | "closed" | "not_found" | "unavailable" | (string & {});
 type RiddleProofVerificationMode = "proof" | "visual" | "interaction" | "render" | "data" | "json" | "audio" | "log" | "logs" | "metric" | "metrics" | (string & {});
 type RiddleProofDecision = "ready_to_ship" | "needs_richer_proof" | "revise_capture" | "needs_recon" | "needs_implementation" | (string & {});
 type RiddleProofStage = "preflight" | "setup" | "recon" | "author" | "implement" | "prove" | "verify" | "ship" | "notify" | (string & {});
@@ -82,16 +83,20 @@ interface RiddleProofRunState {
     last_checkpoint?: string | null;
     pr_url?: string;
     pr_branch?: string;
+    pr_state?: RiddleProofPrLifecycleState;
     marked_ready?: boolean;
     left_draft?: boolean;
     ci_status?: string;
     ship_commit?: string;
     ship_remote_head?: string;
+    merge_commit?: string;
+    merged_at?: string;
     proof_comment_url?: string;
     before_artifact_url?: string;
     prod_artifact_url?: string;
     after_artifact_url?: string;
     ship_report?: Record<string, unknown>;
+    cleanup_report?: Record<string, unknown>;
     notification?: Record<string, unknown>;
     proof_decision?: RiddleProofDecision;
     merge_recommendation?: string;
@@ -113,16 +118,20 @@ interface RiddleProofRunResult {
     event_count?: number;
     pr_url?: string;
     pr_branch?: string;
+    pr_state?: RiddleProofPrLifecycleState;
     marked_ready?: boolean;
     left_draft?: boolean;
     ci_status?: string;
     ship_commit?: string;
     ship_remote_head?: string;
+    merge_commit?: string;
+    merged_at?: string;
     proof_comment_url?: string;
     before_artifact_url?: string;
     prod_artifact_url?: string;
     after_artifact_url?: string;
     ship_report?: Record<string, unknown>;
+    cleanup_report?: Record<string, unknown>;
     notification?: Record<string, unknown>;
     proof_decision?: RiddleProofDecision;
     merge_recommendation?: string;
@@ -138,6 +147,16 @@ interface RiddleProofRunStatusSnapshot {
     state_path?: string | null;
     worktree_path?: string | null;
     branch?: string | null;
+    pr_url?: string | null;
+    pr_branch?: string | null;
+    pr_state?: RiddleProofPrLifecycleState;
+    ci_status?: string;
+    ship_commit?: string;
+    ship_remote_head?: string;
+    merge_commit?: string;
+    merged_at?: string;
+    proof_comment_url?: string;
+    cleanup_report?: Record<string, unknown>;
     iterations: number;
     last_checkpoint?: string | null;
     updated_at: string;
@@ -269,20 +288,39 @@ interface NotificationAdapter {
 interface RiddleProofTerminalMetadata {
     pr_url?: string;
     pr_branch?: string;
+    pr_state?: RiddleProofPrLifecycleState;
     marked_ready?: boolean;
     left_draft?: boolean;
     ci_status?: string;
     ship_commit?: string;
     ship_remote_head?: string;
+    merge_commit?: string;
+    merged_at?: string;
     proof_comment_url?: string;
     before_artifact_url?: string;
     prod_artifact_url?: string;
     after_artifact_url?: string;
     ship_report?: Record<string, unknown>;
+    cleanup_report?: Record<string, unknown>;
     notification?: Record<string, unknown>;
     proof_decision?: RiddleProofDecision;
     merge_recommendation?: string;
     finalized?: boolean;
 }
+interface RiddleProofPrLifecycleState {
+    status: RiddleProofPrLifecycleStatus;
+    pr_url?: string;
+    pr_number?: string;
+    repo?: string;
+    head_branch?: string;
+    base_branch?: string;
+    merge_commit?: string;
+    merged_at?: string;
+    closed_at?: string;
+    checked_at?: string;
+    source?: string;
+    next_action?: string;
+    cleanup?: Record<string, unknown>;
+}
 
-export type { EvidenceArtifact, EvidenceReference, ImplementationAdapter, ImplementationAdapterInput, ImplementationAdapterResult, IntegrationContext, JsonObject, JsonPrimitive, JsonValue, JudgeAdapter, NotificationAdapter, PreflightAdapter, PreflightAdapterInput, PreflightAdapterResult, ProofAdapter, ProofAdapterInput, ProofAdapterResult, RiddleProofArtifactRole, RiddleProofAssessment, RiddleProofBlocker, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, SetupAdapter, SetupAdapterInput, SetupAdapterResult, ShipAdapter };
+export type { EvidenceArtifact, EvidenceReference, ImplementationAdapter, ImplementationAdapterInput, ImplementationAdapterResult, IntegrationContext, JsonObject, JsonPrimitive, JsonValue, JudgeAdapter, NotificationAdapter, PreflightAdapter, PreflightAdapterInput, PreflightAdapterResult, ProofAdapter, ProofAdapterInput, ProofAdapterResult, RiddleProofArtifactRole, RiddleProofAssessment, RiddleProofBlocker, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, SetupAdapter, SetupAdapterInput, SetupAdapterResult, ShipAdapter };

package/dist/types.d.ts

@@ -4,6 +4,7 @@ type JsonObject = {
     [key: string]: JsonValue;
 };
 type RiddleProofStatus = "running" | "blocked" | "failed" | "ready_to_ship" | "shipped" | "completed";
+type RiddleProofPrLifecycleStatus = "unknown" | "open" | "merged" | "closed" | "not_found" | "unavailable" | (string & {});
 type RiddleProofVerificationMode = "proof" | "visual" | "interaction" | "render" | "data" | "json" | "audio" | "log" | "logs" | "metric" | "metrics" | (string & {});
 type RiddleProofDecision = "ready_to_ship" | "needs_richer_proof" | "revise_capture" | "needs_recon" | "needs_implementation" | (string & {});
 type RiddleProofStage = "preflight" | "setup" | "recon" | "author" | "implement" | "prove" | "verify" | "ship" | "notify" | (string & {});
@@ -82,16 +83,20 @@ interface RiddleProofRunState {
     last_checkpoint?: string | null;
     pr_url?: string;
     pr_branch?: string;
+    pr_state?: RiddleProofPrLifecycleState;
     marked_ready?: boolean;
     left_draft?: boolean;
     ci_status?: string;
     ship_commit?: string;
     ship_remote_head?: string;
+    merge_commit?: string;
+    merged_at?: string;
     proof_comment_url?: string;
     before_artifact_url?: string;
     prod_artifact_url?: string;
     after_artifact_url?: string;
     ship_report?: Record<string, unknown>;
+    cleanup_report?: Record<string, unknown>;
     notification?: Record<string, unknown>;
     proof_decision?: RiddleProofDecision;
     merge_recommendation?: string;
@@ -113,16 +118,20 @@ interface RiddleProofRunResult {
     event_count?: number;
     pr_url?: string;
     pr_branch?: string;
+    pr_state?: RiddleProofPrLifecycleState;
     marked_ready?: boolean;
     left_draft?: boolean;
     ci_status?: string;
     ship_commit?: string;
     ship_remote_head?: string;
+    merge_commit?: string;
+    merged_at?: string;
     proof_comment_url?: string;
     before_artifact_url?: string;
     prod_artifact_url?: string;
     after_artifact_url?: string;
     ship_report?: Record<string, unknown>;
+    cleanup_report?: Record<string, unknown>;
     notification?: Record<string, unknown>;
     proof_decision?: RiddleProofDecision;
     merge_recommendation?: string;
@@ -138,6 +147,16 @@ interface RiddleProofRunStatusSnapshot {
     state_path?: string | null;
     worktree_path?: string | null;
     branch?: string | null;
+    pr_url?: string | null;
+    pr_branch?: string | null;
+    pr_state?: RiddleProofPrLifecycleState;
+    ci_status?: string;
+    ship_commit?: string;
+    ship_remote_head?: string;
+    merge_commit?: string;
+    merged_at?: string;
+    proof_comment_url?: string;
+    cleanup_report?: Record<string, unknown>;
     iterations: number;
     last_checkpoint?: string | null;
     updated_at: string;
@@ -269,20 +288,39 @@ interface NotificationAdapter {
 interface RiddleProofTerminalMetadata {
     pr_url?: string;
     pr_branch?: string;
+    pr_state?: RiddleProofPrLifecycleState;
     marked_ready?: boolean;
     left_draft?: boolean;
     ci_status?: string;
     ship_commit?: string;
     ship_remote_head?: string;
+    merge_commit?: string;
+    merged_at?: string;
     proof_comment_url?: string;
     before_artifact_url?: string;
     prod_artifact_url?: string;
     after_artifact_url?: string;
     ship_report?: Record<string, unknown>;
+    cleanup_report?: Record<string, unknown>;
     notification?: Record<string, unknown>;
     proof_decision?: RiddleProofDecision;
     merge_recommendation?: string;
     finalized?: boolean;
 }
+interface RiddleProofPrLifecycleState {
+    status: RiddleProofPrLifecycleStatus;
+    pr_url?: string;
+    pr_number?: string;
+    repo?: string;
+    head_branch?: string;
+    base_branch?: string;
+    merge_commit?: string;
+    merged_at?: string;
+    closed_at?: string;
+    checked_at?: string;
+    source?: string;
+    next_action?: string;
+    cleanup?: Record<string, unknown>;
+}
 
-export type { EvidenceArtifact, EvidenceReference, ImplementationAdapter, ImplementationAdapterInput, ImplementationAdapterResult, IntegrationContext, JsonObject, JsonPrimitive, JsonValue, JudgeAdapter, NotificationAdapter, PreflightAdapter, PreflightAdapterInput, PreflightAdapterResult, ProofAdapter, ProofAdapterInput, ProofAdapterResult, RiddleProofArtifactRole, RiddleProofAssessment, RiddleProofBlocker, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, SetupAdapter, SetupAdapterInput, SetupAdapterResult, ShipAdapter };
+export type { EvidenceArtifact, EvidenceReference, ImplementationAdapter, ImplementationAdapterInput, ImplementationAdapterResult, IntegrationContext, JsonObject, JsonPrimitive, JsonValue, JudgeAdapter, NotificationAdapter, PreflightAdapter, PreflightAdapterInput, PreflightAdapterResult, ProofAdapter, ProofAdapterInput, ProofAdapterResult, RiddleProofArtifactRole, RiddleProofAssessment, RiddleProofBlocker, RiddleProofDecision, RiddleProofEvent, RiddleProofEvidenceBundle, RiddleProofPrLifecycleState, RiddleProofPrLifecycleStatus, RiddleProofRunParams, RiddleProofRunResult, RiddleProofRunState, RiddleProofRunStatusSnapshot, RiddleProofStage, RiddleProofStatus, RiddleProofTerminalMetadata, RiddleProofVerificationMode, SetupAdapter, SetupAdapterInput, SetupAdapterResult, ShipAdapter };

package/package.json

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