@akagilnc/pi-workflow-roles 0.1.4631 → 0.1.4641

package/dist/gatekeeper-role.js

@@ -2,6 +2,7 @@ import { auditorRunDirectory } from "./auditor-dossier-tool.js";
 import { GatekeeperDecisionError } from "./submission-errors.js";
 import { INSPECTOR_OUTPUT_TOOL_NAME } from "./inspector-contracts.js";
 import { GATEKEEPER_OUTPUT_TOOL_NAME, gatekeeperDecisionSchema, gatekeeperOutputSchema, } from "./package-contracts/gatekeeper-output.js";
+import { runIdFromRunDirectory } from "./run-terminal-artifacts.js";
 export const INSPECTOR_OUTPUT_TOOL = INSPECTOR_OUTPUT_TOOL_NAME;
 export const NOTARY_OUTPUT_TOOL = "ak_notary_output";
 function gateSeatLabel(stage) {
@@ -9,14 +10,18 @@ function gateSeatLabel(stage) {
         return "台院";
     if (stage === "auditor")
         return "审刑院";
+    if (stage === "countersign")
+        return "给事中";
     return "符宝郎";
 }
-/** Subject kind → review officer (#753 countersign/notary, #756 judge/auditor + worker/inspector). */
+/** Subject kind → review officer (#753 countersign/notary, #756 judge/auditor + worker/inspector, #969 secretariat/countersign). */
 export function gateOfficerForSubject(subject) {
     if (subject.kind === "worker_completion")
         return "inspector";
     if (subject.kind === "judge_compliance")
         return "auditor";
+    if (subject.kind === "secretariat_verdict")
+        return "countersign";
     return "notary";
 }
 export { GatekeeperDecisionError } from "./submission-errors.js";
@@ -70,9 +75,37 @@ function readRecord(value) {
  * `fallbackStatus` is the terminal outcome.status when the receipt body has no status key
  * (keeps missing-args sentinel intact as the receipt).
  */
+/** Map 给事中 countersignStatus onto the shared gate queue words (#969). */
+function gateStatusFromCountersign(status) {
+    if (status === "converged")
+        return "pass";
+    if (status === "continue")
+        return "bounce";
+    if (status === "escalate")
+        return "escalate";
+    return undefined;
+}
 function projectOfficerDecision(officer, decision, fallbackStatus) {
     const receipt = retainedReceipt(decision);
     const record = readRecord(decision);
+    // 给事中: only countersignStatus, strict three-word map; never generic status,
+    // never unmapped raw word, never fallbackStatus (#969 / ADR 0040/0055).
+    if (officer === "countersign") {
+        const countersignStatus = record !== undefined && typeof record.countersignStatus === "string"
+            ? record.countersignStatus
+            : undefined;
+        const status = typeof countersignStatus === "string"
+            ? gateStatusFromCountersign(countersignStatus)
+            : undefined;
+        if (status === "pass") {
+            return { status: "pass", officer, receipt };
+        }
+        if (status === "bounce" || status === "escalate") {
+            return { status, officer, receipt };
+        }
+        return { status: "needs_reask", officer, receipt };
+    }
+    // inspector / notary / auditor: shared gate words on generic status.
     const status = (record !== undefined && typeof record.status === "string" ? record.status : undefined)
         ?? fallbackStatus;
     if (status === "pass") {
@@ -116,6 +149,35 @@ function projectOfficerPayloads(officer, payloads, fallbackStatus) {
     // Single this-court seal is the common path. Never fold history into an array receipt.
     return projectOfficerDecision(officer, payloads[payloads.length - 1], fallbackStatus);
 }
+/** Nested officer runId from summoned.runDirectory, else terminal.runId (#969). */
+export function officerRunIdFromSummoned(summoned) {
+    if (typeof summoned.runDirectory === "string" && summoned.runDirectory.trim() !== "") {
+        const fromDir = runIdFromRunDirectory(summoned.runDirectory);
+        if (fromDir !== undefined)
+            return fromDir;
+    }
+    const terminal = summoned.terminal;
+    if (terminal !== undefined
+        && typeof terminal.runId === "string"
+        && terminal.runId.trim() !== "") {
+        return terminal.runId;
+    }
+    return undefined;
+}
+function withOfficerRunId(result, summoned) {
+    if (result.status !== "pass"
+        && result.status !== "bounce"
+        && result.status !== "escalate"
+        && result.status !== "needs_reask") {
+        return result;
+    }
+    if (typeof result.runId === "string" && result.runId.trim() !== "")
+        return result;
+    const runId = officerRunIdFromSummoned(summoned);
+    if (runId === undefined)
+        return result;
+    return { ...result, runId };
+}
 function projectOfficerTerminal(officer, summoned) {
     const terminal = summoned.terminal;
     const outcome = terminal?.roleOutcome;
@@ -152,31 +214,39 @@ function projectOfficerTerminal(officer, summoned) {
         };
     }
     if (outcome.kind === "audit_escalation") {
-        return {
+        return withOfficerRunId({
             status: "escalate",
             officer,
             // This-court receipt only (#879) — historical rows remain on terminal.submissions.
             receipt: thisCourt.length > 0 ? thisCourt[thisCourt.length - 1] : retainedReceipt(outcome),
-        };
+        }, 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).
-        return projectOfficerPayloads(officer, thisCourt, outcome.status);
+        return withOfficerRunId(projectOfficerPayloads(officer, thisCourt, outcome.status), summoned);
     }
-    return {
+    return withOfficerRunId({
         status: "needs_reask",
         officer,
         // This-court receipt only (#879).
         receipt: thisCourt.length > 0 ? thisCourt[thisCourt.length - 1] : retainedReceipt(outcome),
-    };
+    }, summoned);
 }
 /**
  * Plain-language re-ask when the officer conclusion is not pass|bounce|escalate.
  * Not a packaged engine handbook line (#755 exception for 读不出三态).
+ * inspector / notary / auditor keep shared gate words; 给事中 uses own three-state
+ * field and words so reask does not invite non-contract values (#969 / ADR 0055).
  */
 export const OFFICER_CONCLUSION_REASK = "上次交卷的结论不是 pass、bounce、escalate 三态之一。请重新输出，结论字段写明其一；打回或上呈的话就是给对方看的原文。";
+/** 给事中 re-ask: countersignStatus converged|continue|escalate only (#969). */
+export const COUNTERSIGN_CONCLUSION_REASK = "上次交卷的 countersignStatus 不是 converged、continue、escalate 三态之一。请重新输出，countersignStatus 写明其一；封驳或上呈的话就是给对方看的原文。";
+/** Pick the re-ask line for the officer under review. */
+export function officerConclusionReask(officer) {
+    return officer === "countersign" ? COUNTERSIGN_CONCLUSION_REASK : OFFICER_CONCLUSION_REASK;
+}
 /**
  * Summon (via injected seam) + project. Default summonGateOfficer drive lives
  * on the shared envelope (`gatekeeper-pass-envelope.ts`, ADR 0018 / #675) —