@akagilnc/pi-workflow-roles 0.1.4977 → 0.1.4980

package/dist/acp-host/production-host.js

@@ -13493,7 +13493,8 @@ __export(audit_escalation_exports, {
   disposeComplianceDecision: () => disposeComplianceDecision,
   isAuditEscalationProjection: () => isAuditEscalationProjection,
   isAuditEscalationResult: () => isAuditEscalationResult,
-  projectAuditEscalation: () => projectAuditEscalation
+  projectAuditEscalation: () => projectAuditEscalation,
+  projectGatekeeperEscalation: () => projectGatekeeperEscalation
 });
 function buildAuditEscalationResult(decision, deliveredOutput) {
   const auditOwned = {
@@ -13538,6 +13539,16 @@ function projectAuditEscalation(decision, deliveredOutput) {
     ...decision.usage === void 0 ? {} : { usage: decision.usage }
   };
 }
+function projectGatekeeperEscalation(result, deliveredOutput) {
+  const receipt = result.receipt;
+  const record4 = receipt !== null && typeof receipt === "object" && !Array.isArray(receipt) ? receipt : void 0;
+  return projectAuditEscalation({
+    status: "escalate",
+    officer: result.officer,
+    conflicts: receipt,
+    ...record4 !== void 0 && Object.hasOwn(record4, "decisionGate") ? { decisionGate: record4.decisionGate } : {}
+  }, deliveredOutput);
+}
 function isAuditEscalationResult(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
     return false;
@@ -13701,6 +13712,7 @@ function rowFromPayload(kind, payload, accepted, roleFallback) {
     kind,
     accepted,
     ...Object.hasOwn(payload, "auditReceipt") ? { auditReceipt: payload.auditReceipt } : {},
+    ...Object.hasOwn(payload, "auditOfficer") ? { auditOfficer: payload.auditOfficer } : {},
     ...typeof payload.toolCallId === "string" && payload.toolCallId.length > 0 ? { toolCallId: payload.toolCallId } : {}
   };
 }
@@ -13978,7 +13990,8 @@ function createSubmissionLedgerHost(host, outputTools, failInfrastructure2 = (er
               outcome: "audit-escalation",
               role,
               accepted: params,
-              ...audit !== void 0 && (Object.hasOwn(audit, "receipt") || Object.hasOwn(audit, "conflicts")) ? { auditReceipt: Object.hasOwn(audit, "receipt") ? audit.receipt : audit.conflicts } : {}
+              ...audit !== void 0 && (Object.hasOwn(audit, "receipt") || Object.hasOwn(audit, "conflicts")) ? { auditReceipt: Object.hasOwn(audit, "receipt") ? audit.receipt : audit.conflicts } : {},
+              ...audit !== void 0 && Object.hasOwn(audit, "officer") ? { auditOfficer: audit.officer } : {}
             });
             await projectClosure(closed2, context);
             return result;
@@ -15100,7 +15113,10 @@ function roleOutcomeFromRows(role, rows) {
       role,
       status: "audit_escalation",
       payloads,
-      ...audited === void 0 ? {} : { decisiveFacts: { auditEscalationReceipt: audited.auditReceipt } }
+      ...audited === void 0 ? {} : { decisiveFacts: {
+        auditEscalationReceipt: audited.auditReceipt,
+        ...Object.hasOwn(audited, "auditOfficer") ? { auditEscalationOfficer: audited.auditOfficer } : {}
+      } }
     };
   }
   return { kind: "accepted", role, payloads };
@@ -26100,7 +26116,7 @@ function createJudgeRoleRuntime(pi, dependencies, hostActions) {
               };
             } catch (error) {
               if (error instanceof GatekeeperDecisionError && error.result.status === "escalate") {
-                return projectAuditEscalation({ status: "escalate", conflicts: error.result.receipt }, verdict);
+                return projectGatekeeperEscalation(error.result, verdict);
               }
               throw error;
             }
@@ -26624,7 +26640,7 @@ function createFixerRoleRuntime(pi, dependencies, hostActions) {
               }) : void 0;
             } catch (error) {
               if (error instanceof GatekeeperDecisionError && error.result.status === "escalate") {
-                return projectAuditEscalation({ status: "escalate", conflicts: error.result.receipt }, output);
+                return projectGatekeeperEscalation(error.result, output);
               }
               throw error;
             }
@@ -26768,7 +26784,7 @@ function createCoderRoleRuntime(pi, dependencies, hostActions) {
               }) : void 0;
             } catch (error) {
               if (error instanceof GatekeeperDecisionError && error.result.status === "escalate") {
-                return projectAuditEscalation({ status: "escalate", conflicts: error.result.receipt }, output);
+                return projectGatekeeperEscalation(error.result, output);
               }
               throw error;
             }

package/dist/audit-escalation.js

@@ -58,6 +58,21 @@ export function projectAuditEscalation(decision, deliveredOutput) {
         ...(decision.usage === undefined ? {} : { usage: decision.usage }),
     };
 }
+/** Preserve the escalating officer's own gate alongside the raw receipt. */
+export function projectGatekeeperEscalation(result, deliveredOutput) {
+    const receipt = result.receipt;
+    const record = receipt !== null && typeof receipt === "object" && !Array.isArray(receipt)
+        ? receipt
+        : undefined;
+    return projectAuditEscalation({
+        status: "escalate",
+        officer: result.officer,
+        conflicts: receipt,
+        ...(record !== undefined && Object.hasOwn(record, "decisionGate")
+            ? { decisionGate: record.decisionGate }
+            : {}),
+    }, deliveredOutput);
+}
 /**
  * Discriminator-only recognition (ADR 0040). Shape of conflicts/options/gate
  * is not a reject gate — element types and cardinality are delivery content.

package/dist/gatekeeper-role.js

@@ -221,8 +221,8 @@ function projectOfficerTerminal(officer, summoned) {
     }
     if (outcome.kind === "accepted") {
         // outcome.status is the fixture/compat leaf: production settlement leaves
-        // it undefined once payloads are recorded, so this only matters when a
-        // caller still supplies status without any recorded payload (#836 hang).
+        // it undefined once payloads are recorded. It may interpret a receipt
+        // lacking its own status, never substitute for a missing receipt.
         return withOfficerRunId(projectOfficerPayloads(officer, thisCourt, outcome.status), summoned);
     }
     return withOfficerRunId({

package/dist/headless-host/production-host.js

@@ -12955,7 +12955,8 @@ __export(audit_escalation_exports, {
   disposeComplianceDecision: () => disposeComplianceDecision,
   isAuditEscalationProjection: () => isAuditEscalationProjection,
   isAuditEscalationResult: () => isAuditEscalationResult,
-  projectAuditEscalation: () => projectAuditEscalation
+  projectAuditEscalation: () => projectAuditEscalation,
+  projectGatekeeperEscalation: () => projectGatekeeperEscalation
 });
 function buildAuditEscalationResult(decision, deliveredOutput) {
   const auditOwned = {
@@ -13000,6 +13001,16 @@ function projectAuditEscalation(decision, deliveredOutput) {
     ...decision.usage === void 0 ? {} : { usage: decision.usage }
   };
 }
+function projectGatekeeperEscalation(result, deliveredOutput) {
+  const receipt = result.receipt;
+  const record4 = receipt !== null && typeof receipt === "object" && !Array.isArray(receipt) ? receipt : void 0;
+  return projectAuditEscalation({
+    status: "escalate",
+    officer: result.officer,
+    conflicts: receipt,
+    ...record4 !== void 0 && Object.hasOwn(record4, "decisionGate") ? { decisionGate: record4.decisionGate } : {}
+  }, deliveredOutput);
+}
 function isAuditEscalationResult(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
     return false;
@@ -13163,6 +13174,7 @@ function rowFromPayload(kind, payload, accepted, roleFallback) {
     kind,
     accepted,
     ...Object.hasOwn(payload, "auditReceipt") ? { auditReceipt: payload.auditReceipt } : {},
+    ...Object.hasOwn(payload, "auditOfficer") ? { auditOfficer: payload.auditOfficer } : {},
     ...typeof payload.toolCallId === "string" && payload.toolCallId.length > 0 ? { toolCallId: payload.toolCallId } : {}
   };
 }
@@ -13440,7 +13452,8 @@ function createSubmissionLedgerHost(host, outputTools, failInfrastructure2 = (er
               outcome: "audit-escalation",
               role,
               accepted: params,
-              ...audit !== void 0 && (Object.hasOwn(audit, "receipt") || Object.hasOwn(audit, "conflicts")) ? { auditReceipt: Object.hasOwn(audit, "receipt") ? audit.receipt : audit.conflicts } : {}
+              ...audit !== void 0 && (Object.hasOwn(audit, "receipt") || Object.hasOwn(audit, "conflicts")) ? { auditReceipt: Object.hasOwn(audit, "receipt") ? audit.receipt : audit.conflicts } : {},
+              ...audit !== void 0 && Object.hasOwn(audit, "officer") ? { auditOfficer: audit.officer } : {}
             });
             await projectClosure(closed2, context);
             return result;
@@ -14562,7 +14575,10 @@ function roleOutcomeFromRows(role, rows) {
       role,
       status: "audit_escalation",
       payloads,
-      ...audited === void 0 ? {} : { decisiveFacts: { auditEscalationReceipt: audited.auditReceipt } }
+      ...audited === void 0 ? {} : { decisiveFacts: {
+        auditEscalationReceipt: audited.auditReceipt,
+        ...Object.hasOwn(audited, "auditOfficer") ? { auditEscalationOfficer: audited.auditOfficer } : {}
+      } }
     };
   }
   return { kind: "accepted", role, payloads };
@@ -26058,7 +26074,7 @@ function createJudgeRoleRuntime(pi, dependencies, hostActions) {
               };
             } catch (error) {
               if (error instanceof GatekeeperDecisionError && error.result.status === "escalate") {
-                return projectAuditEscalation({ status: "escalate", conflicts: error.result.receipt }, verdict);
+                return projectGatekeeperEscalation(error.result, verdict);
               }
               throw error;
             }
@@ -26582,7 +26598,7 @@ function createFixerRoleRuntime(pi, dependencies, hostActions) {
               }) : void 0;
             } catch (error) {
               if (error instanceof GatekeeperDecisionError && error.result.status === "escalate") {
-                return projectAuditEscalation({ status: "escalate", conflicts: error.result.receipt }, output);
+                return projectGatekeeperEscalation(error.result, output);
               }
               throw error;
             }
@@ -26726,7 +26742,7 @@ function createCoderRoleRuntime(pi, dependencies, hostActions) {
               }) : void 0;
             } catch (error) {
               if (error instanceof GatekeeperDecisionError && error.result.status === "escalate") {
-                return projectAuditEscalation({ status: "escalate", conflicts: error.result.receipt }, output);
+                return projectGatekeeperEscalation(error.result, output);
               }
               throw error;
             }

package/dist/public-cli/main.js

@@ -23611,6 +23611,7 @@ function rowFromPayload(kind, payload, accepted, roleFallback) {
     kind,
     accepted,
     ...Object.hasOwn(payload, "auditReceipt") ? { auditReceipt: payload.auditReceipt } : {},
+    ...Object.hasOwn(payload, "auditOfficer") ? { auditOfficer: payload.auditOfficer } : {},
     ...typeof payload.toolCallId === "string" && payload.toolCallId.length > 0 ? { toolCallId: payload.toolCallId } : {}
   };
 }
@@ -24689,7 +24690,10 @@ function roleOutcomeFromRows(role, rows) {
       role,
       status: "audit_escalation",
       payloads,
-      ...audited === void 0 ? {} : { decisiveFacts: { auditEscalationReceipt: audited.auditReceipt } }
+      ...audited === void 0 ? {} : { decisiveFacts: {
+        auditEscalationReceipt: audited.auditReceipt,
+        ...Object.hasOwn(audited, "auditOfficer") ? { auditEscalationOfficer: audited.auditOfficer } : {}
+      } }
     };
   }
   return { kind: "accepted", role, payloads };

package/dist/public-cli/settlement.js

@@ -60,7 +60,10 @@ function roleOutcomeFromRows(role, rows) {
         const audited = terminal.slice().reverse().find((row) => row.kind === "audit-escalation" && Object.hasOwn(row, "auditReceipt"));
         return {
             kind: "audit_escalation", role, status: "audit_escalation", payloads,
-            ...(audited === undefined ? {} : { decisiveFacts: { auditEscalationReceipt: audited.auditReceipt } }),
+            ...(audited === undefined ? {} : { decisiveFacts: {
+                    auditEscalationReceipt: audited.auditReceipt,
+                    ...(Object.hasOwn(audited, "auditOfficer") ? { auditEscalationOfficer: audited.auditOfficer } : {}),
+                } }),
         };
     }
     return { kind: "accepted", role, payloads };

package/dist/submission-ledger.js

@@ -161,6 +161,7 @@ function rowFromPayload(kind, payload, accepted, roleFallback) {
         kind,
         accepted,
         ...(Object.hasOwn(payload, "auditReceipt") ? { auditReceipt: payload.auditReceipt } : {}),
+        ...(Object.hasOwn(payload, "auditOfficer") ? { auditOfficer: payload.auditOfficer } : {}),
         ...(typeof payload.toolCallId === "string" && payload.toolCallId.length > 0
             ? { toolCallId: payload.toolCallId }
             : {}),
@@ -526,6 +527,7 @@ export function createSubmissionLedgerHost(host, outputTools, failInfrastructure
                             ...(audit !== undefined && (Object.hasOwn(audit, "receipt") || Object.hasOwn(audit, "conflicts"))
                                 ? { auditReceipt: Object.hasOwn(audit, "receipt") ? audit.receipt : audit.conflicts }
                                 : {}),
+                            ...(audit !== undefined && Object.hasOwn(audit, "officer") ? { auditOfficer: audit.officer } : {}),
                         });
                         await projectClosure(closed, context);
                         return result;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akagilnc/pi-workflow-roles",
-  "version": "0.1.4977",
+  "version": "0.1.4980",
   "description": "Soul-bound workflow roles for Pi",
   "type": "module",
   "license": "Apache-2.0",

package/src/audit-escalation.ts

@@ -4,6 +4,7 @@ import type {
   ComplianceDecision,
 } from "./compliance-transport.ts";
 import { GatekeeperDecisionError } from "./submission-errors.ts";
+import type { GatekeeperNonPassResult } from "./gatekeeper-role.ts";
 
 export const AUDIT_ESCALATION_KIND = "audit_escalation" as const;
 
@@ -37,7 +38,7 @@ export type AuditEscalationToolResult = {
 
 export type OfficerAuditEscalationDecision = {
   readonly status: "escalate";
-  readonly officer?: "inspector" | "notary" | "countersign";
+  readonly officer?: "inspector" | "notary" | "auditor" | "countersign";
   readonly reason?: unknown;
   readonly findings?: unknown;
   readonly conflicts?: unknown;
@@ -113,6 +114,25 @@ export function projectAuditEscalation(
   };
 }
 
+/** Preserve the escalating officer's own gate alongside the raw receipt. */
+export function projectGatekeeperEscalation(
+  result: Extract<GatekeeperNonPassResult, { status: "escalate" }>,
+  deliveredOutput?: unknown,
+): AuditEscalationToolResult {
+  const receipt = result.receipt;
+  const record = receipt !== null && typeof receipt === "object" && !Array.isArray(receipt)
+    ? receipt as Record<string, unknown>
+    : undefined;
+  return projectAuditEscalation({
+    status: "escalate",
+    officer: result.officer,
+    conflicts: receipt,
+    ...(record !== undefined && Object.hasOwn(record, "decisionGate")
+      ? { decisionGate: record.decisionGate }
+      : {}),
+  }, deliveredOutput);
+}
+
 /**
  * Discriminator-only recognition (ADR 0040). Shape of conflicts/options/gate
  * is not a reject gate — element types and cardinality are delivery content.

package/src/gatekeeper-role.ts

@@ -382,8 +382,8 @@ function projectOfficerTerminal(
   }
   if (outcome.kind === "accepted") {
     // outcome.status is the fixture/compat leaf: production settlement leaves
-    // it undefined once payloads are recorded, so this only matters when a
-    // caller still supplies status without any recorded payload (#836 hang).
+    // it undefined once payloads are recorded. It may interpret a receipt
+    // lacking its own status, never substitute for a missing receipt.
     return withOfficerRunId(
       projectOfficerPayloads(officer, thisCourt, outcome.status),
       summoned,

package/src/judge-role.ts

@@ -3,7 +3,7 @@ import { Type, type Static } from "typebox";
 
 import { withTerminatingOutputDeclarations } from "./package-contracts/terminating-infrastructure.ts";
 import { GatekeeperDecisionError, ParentQueueReaskError } from "./submission-errors.ts";
-import { projectAuditEscalation } from "./audit-escalation.ts";
+import { projectGatekeeperEscalation } from "./audit-escalation.ts";
 
 import { readableGateItem } from "./readable-gate-item.ts";
 import {
@@ -152,7 +152,7 @@ export function createJudgeRoleRuntime(
               };
             } catch (error) {
               if (error instanceof GatekeeperDecisionError && error.result.status === "escalate") {
-                return projectAuditEscalation({ status: "escalate", conflicts: error.result.receipt }, verdict);
+                return projectGatekeeperEscalation(error.result, verdict);
               }
               throw error;
             }

package/src/public-cli/settlement.ts

@@ -170,6 +170,7 @@ function roleOutcomeFromRows(
     readonly kind: "accepted" | "audit-escalation" | "correctable-rejection" | "infrastructure" | "candidate";
     readonly accepted: unknown;
     readonly auditReceipt?: unknown;
+    readonly auditOfficer?: unknown;
   }[],
 ): Extract<TerminalRoleOutcome, { kind: "accepted" | "audit_escalation" }> | undefined {
   const mine = rows.filter((row) => row.role === role);
@@ -185,7 +186,10 @@ function roleOutcomeFromRows(
     const audited = terminal.slice().reverse().find((row) => row.kind === "audit-escalation" && Object.hasOwn(row, "auditReceipt"));
     return {
       kind: "audit_escalation", role, status: "audit_escalation", payloads,
-      ...(audited === undefined ? {} : { decisiveFacts: { auditEscalationReceipt: audited.auditReceipt } }),
+      ...(audited === undefined ? {} : { decisiveFacts: {
+        auditEscalationReceipt: audited.auditReceipt,
+        ...(Object.hasOwn(audited, "auditOfficer") ? { auditEscalationOfficer: audited.auditOfficer } : {}),
+      } }),
     };
   }
   return { kind: "accepted", role, payloads };

package/src/submission-ledger.ts

@@ -52,6 +52,7 @@ export type SubmissionLedgerEvent =
       readonly accepted?: unknown;
       /** Audit-owned escalation verdict, separate from the original role submission. */
       readonly auditReceipt?: unknown;
+      readonly auditOfficer?: unknown;
     }
   | {
       readonly type: "sealed";
@@ -105,6 +106,7 @@ export type RecordedSubmissionRow = {
   readonly kind: "accepted" | "audit-escalation" | "correctable-rejection" | "infrastructure" | "candidate";
   readonly accepted: unknown;
   readonly auditReceipt?: unknown;
+  readonly auditOfficer?: unknown;
   /** Present when the ledger row names the tool call — used to dedupe candidate+outcome. */
   readonly toolCallId?: string;
 };
@@ -285,6 +287,7 @@ function rowFromPayload(
     params?: unknown;
     toolCallId?: unknown;
     auditReceipt?: unknown;
+    auditOfficer?: unknown;
   },
   accepted: unknown,
   roleFallback?: TerminalRoleName,
@@ -295,6 +298,7 @@ function rowFromPayload(
     kind,
     accepted,
     ...(Object.hasOwn(payload, "auditReceipt") ? { auditReceipt: payload.auditReceipt } : {}),
+    ...(Object.hasOwn(payload, "auditOfficer") ? { auditOfficer: payload.auditOfficer } : {}),
     ...(typeof payload.toolCallId === "string" && payload.toolCallId.length > 0
       ? { toolCallId: payload.toolCallId }
       : {}),
@@ -726,6 +730,7 @@ export function createSubmissionLedgerHost(
               ...(audit !== undefined && (Object.hasOwn(audit, "receipt") || Object.hasOwn(audit, "conflicts"))
                 ? { auditReceipt: Object.hasOwn(audit, "receipt") ? audit.receipt : audit.conflicts }
                 : {}),
+              ...(audit !== undefined && Object.hasOwn(audit, "officer") ? { auditOfficer: audit.officer } : {}),
             });
             await projectClosure(closed, context);
             return result;

package/src/worker-role.ts

@@ -9,7 +9,7 @@ import type {
   CanonicalSkillBinding,
 } from "./canonical-skill-binding.ts";
 import { readableGateItem } from "./readable-gate-item.ts";
-import { projectAuditEscalation } from "./audit-escalation.ts";
+import { projectGatekeeperEscalation } from "./audit-escalation.ts";
 import { GatekeeperDecisionError } from "./submission-errors.ts";
 import {
   CODER_OUTPUT_TOOL_NAME,
@@ -299,7 +299,7 @@ export function createFixerRoleRuntime(
                 : undefined;
             } catch (error) {
               if (error instanceof GatekeeperDecisionError && error.result.status === "escalate") {
-                return projectAuditEscalation({ status: "escalate", conflicts: error.result.receipt }, output);
+                return projectGatekeeperEscalation(error.result, output);
               }
               throw error;
             }
@@ -447,7 +447,7 @@ export function createCoderRoleRuntime(
                 : undefined;
             } catch (error) {
               if (error instanceof GatekeeperDecisionError && error.result.status === "escalate") {
-                return projectAuditEscalation({ status: "escalate", conflicts: error.result.receipt }, output);
+                return projectGatekeeperEscalation(error.result, output);
               }
               throw error;
             }