@akagilnc/pi-workflow-roles 0.1.3565 → 0.1.3572

package/dist/diarist-contracts.js

@@ -0,0 +1,72 @@
+/**
+ * Public 起居郎 (diarist) terminating receipt contracts — ADR 0075 `diarist-is-role`.
+ * Lawful explicit release: completed, with empty or nonempty selections.
+ * Machine facts about the volume come from the mechanical sitian seam, never
+ * from model self-report (锚定宪法); this module owns the receipt shape only.
+ */
+export const DIARIST_OUTPUT_TOOL_NAME = "ak_diarist_output";
+export const DIARIST_ACCEPTED_TEXT = "起居郎回执已接受";
+/** Internal transport: frozen candidate-catalog path for this turn's ticket. */
+export const DIARIST_SOURCES_FLAG = {
+    name: "ak-diarist-sources",
+    definition: {
+        description: "Frozen per-ticket source catalog the diarist selects from",
+        type: "string",
+    },
+};
+export function validateRecordedDiaristOutput(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("Diarist output has no execution discriminator");
+    }
+    let status;
+    try {
+        status = value.status;
+    }
+    catch {
+        throw new Error("Diarist output has no execution discriminator");
+    }
+    if (status === "completed") {
+        return value;
+    }
+    throw new Error("Diarist output has no execution discriminator");
+}
+/**
+ * Lenient projection of submitted selections (第 0 条: shape is not an admission
+ * gate). Rows that carry no usable candidateIndex are dropped from the commit,
+ * never bounced back at the role.
+ */
+export function projectDiaristSelections(value) {
+    const rows = value?.selections;
+    if (!Array.isArray(rows))
+        return [];
+    const out = [];
+    for (const row of rows) {
+        if (row === null || typeof row !== "object" || Array.isArray(row))
+            continue;
+        const record = row;
+        const index = record.candidateIndex;
+        if (typeof index !== "number" || !Number.isInteger(index) || index < 0)
+            continue;
+        const quotes = Array.isArray(record.quotes)
+            ? record.quotes.filter((q) => typeof q === "string" && q.length > 0)
+            : [];
+        out.push({
+            candidateIndex: index,
+            quotes,
+            ...(typeof record.note === "string" ? { note: record.note } : {}),
+        });
+    }
+    return out;
+}
+/** Machine-facing facts from an accepted receipt. Submitted rows retained as-is. */
+export function diaristDecisiveFacts(output) {
+    const facts = { status: output.status };
+    const selections = output.selections;
+    if (Array.isArray(selections))
+        facts.selections = selections;
+    // Mechanical sitian facts recorded by the envelope at accept time.
+    const sitian = output.sitian;
+    if (sitian !== undefined)
+        facts.sitian = sitian;
+    return facts;
+}

package/dist/package-contracts/terminating-tools.js

@@ -15,8 +15,9 @@ import { NOTARY_ACCEPTED_TEXT, NOTARY_OUTPUT_TOOL_NAME, validateRecordedNotaryOu
 import { COUNTERSIGN_ACCEPTED_TEXT, COUNTERSIGN_OUTPUT_TOOL_NAME, validateRecordedCountersignOutput } from "../countersign-contracts.js";
 import { GLEANER_LEFT_ACCEPTED_TEXT, GLEANER_LEFT_OUTPUT_TOOL_NAME, validateRecordedGleanerLeftOutput } from "../gleaner-left-contracts.js";
 import { INSPECTOR_ACCEPTED_TEXT, INSPECTOR_OUTPUT_TOOL_NAME, validateRecordedInspectorOutput } from "../inspector-contracts.js";
+import { DIARIST_ACCEPTED_TEXT, DIARIST_OUTPUT_TOOL_NAME, validateRecordedDiaristOutput } from "../diarist-contracts.js";
 import { CODER_ACCEPTED_TEXT, CODER_OUTPUT_TOOL_NAME, FIXER_ACCEPTED_TEXT, FIXER_OUTPUT_TOOL_NAME, validateAcceptedWorkerDetails, } from "./worker-output.js";
-export { CODER_ACCEPTED_TEXT, CODER_OUTPUT_TOOL_NAME, COLLECTOR_ACCEPTED_TEXT, COLLECTOR_OUTPUT_TOOL, FIXER_ACCEPTED_TEXT, FIXER_OUTPUT_TOOL_NAME, JUDGE_ACCEPTED_TEXT, JUDGE_OUTPUT_TOOL_NAME, REVIEWER_ACCEPTED_TEXT, REVIEWER_OUTPUT_TOOL_NAME, MERGER_ACCEPTED_TEXT, MERGER_OUTPUT_TOOL_NAME, validateAcceptedCollectorReceipt, validateAcceptedJudgeDetails, projectReviewerIntentToReceipt, validateReviewerIntent, validateRuntimeReviewerReceipt, validateAcceptedWorkerDetails, validateDoctorSubmissionShape, validateRecordedDoctorOutput, validateMergerOutput, validateRecordedNotaryOutput, validateRecordedCountersignOutput, validateRecordedGleanerLeftOutput, validateRecordedInspectorOutput, validateRecordedGatekeeperOutput, validateRecordedNavigatorOutput, };
+export { CODER_ACCEPTED_TEXT, CODER_OUTPUT_TOOL_NAME, COLLECTOR_ACCEPTED_TEXT, COLLECTOR_OUTPUT_TOOL, FIXER_ACCEPTED_TEXT, FIXER_OUTPUT_TOOL_NAME, JUDGE_ACCEPTED_TEXT, JUDGE_OUTPUT_TOOL_NAME, REVIEWER_ACCEPTED_TEXT, REVIEWER_OUTPUT_TOOL_NAME, MERGER_ACCEPTED_TEXT, MERGER_OUTPUT_TOOL_NAME, validateAcceptedCollectorReceipt, validateAcceptedJudgeDetails, projectReviewerIntentToReceipt, validateReviewerIntent, validateRuntimeReviewerReceipt, validateAcceptedWorkerDetails, validateDoctorSubmissionShape, validateRecordedDoctorOutput, validateMergerOutput, validateRecordedNotaryOutput, validateRecordedCountersignOutput, validateRecordedGleanerLeftOutput, validateRecordedInspectorOutput, validateRecordedGatekeeperOutput, validateRecordedNavigatorOutput, validateRecordedDiaristOutput, };
 export const TERMINATING_TOOL_NAMES = [
     CODER_OUTPUT_TOOL_NAME,
     FIXER_OUTPUT_TOOL_NAME,
@@ -31,6 +32,7 @@ export const TERMINATING_TOOL_NAMES = [
     INSPECTOR_OUTPUT_TOOL_NAME,
     GATEKEEPER_OUTPUT_TOOL_NAME,
     NAVIGATOR_OUTPUT_TOOL_NAME,
+    DIARIST_OUTPUT_TOOL_NAME,
 ];
 export function isTerminatingToolName(name) {
     return TERMINATING_TOOL_NAMES.includes(name);
@@ -63,6 +65,8 @@ export function acceptedTextFor(toolName) {
             return GATEKEEPER_ACCEPTED_TEXT;
         case NAVIGATOR_OUTPUT_TOOL_NAME:
             return NAVIGATOR_ACCEPTED_TEXT;
+        case DIARIST_OUTPUT_TOOL_NAME:
+            return DIARIST_ACCEPTED_TEXT;
     }
 }
 export class AcceptedDetailsContractError extends CorrectableSubmissionError {
@@ -114,6 +118,7 @@ export function validateAcceptedDetails(toolName, details) {
         [INSPECTOR_OUTPUT_TOOL_NAME]: ["pass", "bounce"],
         [GATEKEEPER_OUTPUT_TOOL_NAME]: ["dispatch", "pass"],
         [NAVIGATOR_OUTPUT_TOOL_NAME]: ["advice"],
+        [DIARIST_OUTPUT_TOOL_NAME]: ["completed"],
     };
     const collectorDiscriminator = toolName === COLLECTOR_OUTPUT_TOOL && Array.isArray(candidate?.groups);
     const baseDiscriminator = discriminator;
@@ -151,6 +156,8 @@ export function validateAcceptedDetails(toolName, details) {
                 return validateRecordedGatekeeperOutput(details);
             case NAVIGATOR_OUTPUT_TOOL_NAME:
                 return validateRecordedNavigatorOutput(details);
+            case DIARIST_OUTPUT_TOOL_NAME:
+                return validateRecordedDiaristOutput(details);
         }
     }
     catch (error) {
@@ -177,6 +184,16 @@ export function validateAcceptedLifecycle(toolName, argumentsValue, detailsValue
             throw new Error("accepted tool lifecycle details mismatch");
         return details;
     }
+    if (toolName === DIARIST_OUTPUT_TOOL_NAME) {
+        // Envelope-owned mechanical sitian facts are runtime-bound on details only
+        // (same shape as the Doctor runtime cost); the submitted arguments carry the
+        // role's own selections. Machine facts never come from model self-report.
+        const { sitian: _mechanical, ...submitted } = details;
+        const testimony = validateAcceptedDetails(toolName, argumentsValue);
+        if (!deepEqual(testimony, submitted))
+            throw new Error("accepted tool lifecycle details mismatch");
+        return details;
+    }
     const argumentsDetails = validateAcceptedDetails(toolName, argumentsValue);
     if (!deepEqual(argumentsDetails, details))
         throw new Error("accepted tool lifecycle details mismatch");
@@ -192,7 +209,8 @@ export function acceptedFacts(toolName, details) {
         case GLEANER_LEFT_OUTPUT_TOOL_NAME:
         case INSPECTOR_OUTPUT_TOOL_NAME:
         case GATEKEEPER_OUTPUT_TOOL_NAME:
-        case NAVIGATOR_OUTPUT_TOOL_NAME: return { status: details.status };
+        case NAVIGATOR_OUTPUT_TOOL_NAME:
+        case DIARIST_OUTPUT_TOOL_NAME: return { status: details.status };
         case JUDGE_OUTPUT_TOOL_NAME: return { status: details.judgeStatus };
         case COUNTERSIGN_OUTPUT_TOOL_NAME: return { status: details.countersignStatus };
         case MERGER_OUTPUT_TOOL_NAME: {

package/dist/packaged-role-registry.js

@@ -10,6 +10,10 @@ import { NOTARY_OUTPUT_TOOL_NAME } from "./notary-contracts.js";
 import { COUNTERSIGN_OUTPUT_TOOL_NAME } from "./countersign-contracts.js";
 import { GLEANER_LEFT_OUTPUT_TOOL_NAME } from "./gleaner-left-contracts.js";
 import { INSPECTOR_OUTPUT_TOOL_NAME } from "./inspector-contracts.js";
+import {
+  DIARIST_OUTPUT_TOOL_NAME,
+  DIARIST_SOURCES_FLAG
+} from "./diarist-contracts.js";
 const NOTARY_SESSION_MATERIALS = [
   "CLAUDE.md",
   "souls/notary.md",
@@ -175,6 +179,22 @@ const PUBLIC_ROLE_RECORDS = [
     phaseFlag: void 0,
     activationStage: "load-and-install",
     sessionMaterials: ["CLAUDE.md", "souls/navigator.md"]
+  },
+  // #708 / ADR 0075 `diarist-is-role`: 起居郎 is a seat like any other. The
+  // frozen source catalog rides the shared input-flag seam; it is absent for a
+  // true-unbound summons (no ticket → no diary).
+  {
+    role: "diarist",
+    phases: [null],
+    outputTool: DIARIST_OUTPUT_TOOL_NAME,
+    inputFlag: DIARIST_SOURCES_FLAG.name,
+    phaseFlag: void 0,
+    activationStage: "load-and-install",
+    sessionMaterials: [
+      "CLAUDE.md",
+      "souls/diarist.md",
+      "resources/diarist-collect.md"
+    ]
   }
 ];
 const PACKAGED_ROLE_REGISTRY = PUBLIC_ROLE_RECORDS.map(({ sessionMaterials: _omit, ...metadata }) => metadata);