@akagilnc/pi-workflow-roles 0.1.3356 → 0.1.3377

package/README.md

@@ -47,7 +47,7 @@ Seat and Gate-officer configuration:
 ```bash
 ak-role config set judge <provider/model[:thinking]>
 ak-role config set navigator <provider/model[:thinking]>
-# Gate officers (automatic on submission; direct commands available)
+# Gate officers (direct summons on DONE submissions; province remains independently callable)
 ak-role config set gatekeeper <provider/model[:thinking]>
 ak-role config set inspector <provider/model[:thinking]>
 ak-role config set notary <provider/model[:thinking]>
@@ -67,7 +67,7 @@ For Gate officers (`gatekeeper` / `inspector` / `notary`) resolution is officer
 
 Receipts are typed, so callers compose roles without parsing prose; ordering and stopping stay caller-owned ([ADR 0010](docs/adr/0010-callers-own-role-composition-and-repetition.md)). Programmatic consumers derive contracts from the exported schemas in `src/package-contracts/`, not from this guide.
 
-Gate submission gate: on completing-side submissions the package may spawn the Gate province before the run settles (`gatekeeper` dispatching `inspector` or `notary`); bounce means rewrite-and-resubmit in that same session, not role failure; `planned` / `refused` / `unfinished` skip the province; read gate history from the typed gate section of the receipt, never from session prose. Pointers: [ADR 0067](docs/adr/0067-menxia-province-founding-jishizhong-fubaolang.md), [ADR 0072](docs/adr/0072-menxia-pre-pr-submission-hooks.md). A labor-engine detour that fails to spawn, exits nonzero, or produces no usable output stops the run through the existing infrastructure-failure path with the original cause visible ([ADR 0071](docs/adr/0071-engine-detour-failure-seat-fallback-declaration.md)).
+Gate submission gate: on DONE-side submissions (`completed` / `partially_completed`) the package summons the subject officer directly (`inspector` for worker completion; `notary` for judge draft / countersign verdict) — it does not spawn a Gatekeeper child to choose the seat; bounce means rewrite-and-resubmit in that same session, not role failure; `planned` / `refused` / `unfinished` skip the officer summons and settle; `ak-role gatekeeper` remains available for independent province dispatch/pass; read gate history from the typed gate section of the receipt, never from session prose. Pointers: [ADR 0067](docs/adr/0067-menxia-province-founding-jishizhong-fubaolang.md), [ADR 0072](docs/adr/0072-menxia-pre-pr-submission-hooks.md), [ADR 0079](docs/adr/0079-direct-officer-summons-ticket-memory-pointer-input.md). A labor-engine detour that fails to spawn, exits nonzero, or produces no usable output stops the run through the existing infrastructure-failure path with the original cause visible ([ADR 0071](docs/adr/0071-engine-detour-failure-seat-fallback-declaration.md)).
 
 ## Call the roles
 

package/README.zh-CN.md

@@ -47,7 +47,7 @@ ak-role judge --attach ./plan.md "Review this plan." > result.txt
 ```bash
 ak-role config set judge <provider/model[:thinking]>
 ak-role config set navigator <provider/model[:thinking]>
-# 门下省交卷闸官席（察院/符宝郎交卷自动出席，亦可直调；给事中票庭由调用者直召，见「调用百官」）
+# 门下省官席（DONE 交卷直接传召察院/符宝郎；门下省仍可独立直调；给事中票庭由调用者直召，见「调用百官」）
 ak-role config set gatekeeper <provider/model[:thinking]>
 ak-role config set inspector <provider/model[:thinking]>
 ak-role config set notary <provider/model[:thinking]>
@@ -67,7 +67,7 @@ ak-role config set-auto-resume-limit 3
 
 回执是 typed 的，调用者不必解析散文即可组合角色；顺序与停止归调用者（[ADR 0010](docs/adr/0010-callers-own-role-composition-and-repetition.md)）。编程消费者从 `src/package-contracts/` 导出推导契约，不从本文。
 
-门下省交卷闸：完成侧交卷时包可在本局结算前起省（`gatekeeper` 派 `inspector`／`notary`），封驳＝当场重写重交，不是角色失败；`planned`／`refused`／`unfinished` 不调省；闸史读回执 typed gate 段，勿刮 session 散文。指针：[ADR 0067](docs/adr/0067-menxia-province-founding-jishizhong-fubaolang.md)、[ADR 0072](docs/adr/0072-menxia-pre-pr-submission-hooks.md)。劳务引擎绕行失败沿既有基础设施故障路径停止、真因可见（[ADR 0071](docs/adr/0071-engine-detour-failure-seat-fallback-declaration.md)）。
+门下省交卷闸：DONE 侧交卷（`completed`／`partially_completed`）时包按受审物直接传召官（将作监/修内司→`inspector`；大理寺判牒/给事中署章→`notary`），不再起门下省子 session 选席；封驳＝当场重写重交，不是角色失败；`planned`／`refused`／`unfinished` 不传召官、直接结算；`ak-role gatekeeper` 仍可独立 dispatch/pass；闸史读回执 typed gate 段，勿刮 session 散文。指针：[ADR 0067](docs/adr/0067-menxia-province-founding-jishizhong-fubaolang.md)、[ADR 0072](docs/adr/0072-menxia-pre-pr-submission-hooks.md)、[ADR 0079](docs/adr/0079-direct-officer-summons-ticket-memory-pointer-input.md)。劳务引擎绕行失败沿既有基础设施故障路径停止、真因可见（[ADR 0071](docs/adr/0071-engine-detour-failure-seat-fallback-declaration.md)）。
 
 ## 调用百官
 
@@ -135,7 +135,7 @@ ak-role resume <runId> "<裁定>"
 | **御史台** | reviewer | **察举百弊，风闻奏事。** 置身事外审视成果；Standards／Spec 两条取证腿由 runtime 代跑，本席收腿报告出薄回执与 amendment。弹章须指明所劾之处，言不为狱——不负坐实义务，坐实归大理寺。 |
 | **大理寺** | judge | **审理定谳。** 承接各方意见与材料，依照既定规则逐项判断，辨明是非曲直。可以准行、退回或请示更高决定，但自身不参与建设与修改。 |
 | **审刑院** | judge-auditor／doctor-auditor（无 CLI，共享内部接缝；御史台侧闸已退役） | **复核成案。** 不重新争论事情本身，而是检查整个办理过程是否合乎规矩。关注是否有人越过职责、是否遗漏必要步骤、是否以错误方式得出正确结果。直属陛下，不入门下省编制。 |
-| **门下省** | gatekeeper（交卷自动出席，亦可 `ak-role gatekeeper` 直调） | **审署诏敕与质量保证的省。** 交卷时判断受审物、够不够审、该谁审，派察院或符宝郎；给事中票庭由调用者开工前传召；左拾遗由调用者合并前传召（皆非闸派）；省内政，不是外层编排器。规范见 [ADR 0067](docs/adr/0067-menxia-province-founding-jishizhong-fubaolang.md)、[ADR 0072](docs/adr/0072-menxia-pre-pr-submission-hooks.md)、[ADR 0074](docs/adr/0074-gate-province-reorg-jishizhong-chaiyuan-split.md)。 |
+| **门下省** | gatekeeper（交卷闸不再自动出席；可 `ak-role gatekeeper` 独立直调） | **审署诏敕与质量保证的省。** 交卷闸按受审物直接传召察院/符宝郎，本省不介入选席；调用者仍可独立传召本省作 dispatch/pass；给事中票庭由调用者开工前传召；左拾遗由调用者合并前传召；省内政，不是外层编排器。规范见 [ADR 0067](docs/adr/0067-menxia-province-founding-jishizhong-fubaolang.md)、[ADR 0072](docs/adr/0072-menxia-pre-pr-submission-hooks.md)、[ADR 0074](docs/adr/0074-gate-province-reorg-jishizhong-chaiyuan-split.md)、[ADR 0079](docs/adr/0079-direct-officer-summons-ticket-memory-pointer-input.md)。 |
 | **给事中** | countersign（无交卷闸派发；开工前由调用者传召） | **票庭审读五问。** 制度符合／授权真实（以起居录为据）／文书符意／退回重议／发布资格；读码取证是本职，实现细节不上票面。票庭流水线在本席 turn 前跑起居郎工序（调用者无感）；交卷闸出席符宝郎。署＝放行开工，封驳＝退票重议，上呈＝陛下裁决。规范见 [ADR 0074](docs/adr/0074-gate-province-reorg-jishizhong-chaiyuan-split.md)、[ADR 0075](docs/adr/0075-ticket-provenance-diarist-pipeline.md)。 |
 | **左拾遗** | gleaner-left（无交卷闸派发；合并前由调用者传召） | **合并前无锚定风闻。** 对全幅合并候选作冷眼评审；只上弹章、不封驳不裁决。规范见 [ADR 0067](docs/adr/0067-menxia-province-founding-jishizhong-fubaolang.md) 修正案。 |
 | **察院** | inspector | **事后察举：复杂度与测试质量两轴。** 受审物是将作监／修内司完成侧交卷；封驳＝当场打回重写，不是本局失败。可被门下省派发，也可 `ak-role inspector` 单独调。原给事中，ADR 0074 分立。 |

package/dist/gatekeeper-role.js

@@ -4,19 +4,12 @@ import { openToolObject } from "./open-tool-schema.js";
 import { loadGatekeeperSessionMaterials } from "./session-opening-materials.js";
 import { GatekeeperDecisionError } from "./submission-errors.js";
 import { INSPECTOR_OUTPUT_TOOL_NAME } from "./inspector-contracts.js";
-import { GATEKEEPER_OUTPUT_TOOL_NAME, gatekeeperDecisionSchema, gatekeeperOutputSchema, projectLawfulGatekeeperOutput, } from "./package-contracts/gatekeeper-output.js";
+import { GATEKEEPER_OUTPUT_TOOL_NAME, gatekeeperDecisionSchema, gatekeeperOutputSchema, } from "./package-contracts/gatekeeper-output.js";
 export const INSPECTOR_OUTPUT_TOOL = INSPECTOR_OUTPUT_TOOL_NAME;
 export const NOTARY_OUTPUT_TOOL = "ak_notary_output";
 const SUBJECT_TOOL = "ak_gatekeeper_subject";
 function gateSeatLabel(stage) {
-    switch (stage) {
-        case "gatekeeper":
-            return "门下省";
-        case "inspector":
-            return "察院";
-        case "notary":
-            return "符宝郎";
-    }
+    return stage === "inspector" ? "察院" : "符宝郎";
 }
 export { GatekeeperDecisionError } from "./submission-errors.js";
 export class GatekeeperEscalationError extends Error {
@@ -110,7 +103,7 @@ function noUsableReleaseFailure(stage, decision) {
     return {
         status: "transport_failure",
         stage,
-        reason: stage === "gatekeeper" ? "decision 无显式 dispatch" : "decision 无显式 pass/bounce/escalate",
+        reason: "decision 无显式 pass/bounce/escalate",
         submission: retainedSubmission(decision),
     };
 }
@@ -119,19 +112,6 @@ function readRecord(value) {
         return undefined;
     return value;
 }
-function projectProvinceDecision(decision) {
-    // Lawful dispatch/pass discriminant is owned by package-contracts; province
-    // wraps undefined into transport_failure while retaining the submission.
-    const projected = projectLawfulGatekeeperOutput(decision);
-    if (projected === undefined)
-        return noUsableReleaseFailure("gatekeeper", decision);
-    if (projected.status === "dispatch") {
-        return { status: "dispatch", officer: projected.officer };
-    }
-    // Lawful non-dispatch release — province may pass without dispatching an officer
-    // (ADR 0074 gate-non-mandatory; gate-output-guide pass = 正常放行; #597).
-    return { status: "pass", findings: projected.findings ?? [] };
-}
 function projectOfficerDecision(officer, decision) {
     const record = readRecord(decision);
     if (record === undefined)
@@ -163,38 +143,14 @@ function projectOfficerDecision(officer, decision) {
     }
     return noUsableReleaseFailure(officer, decision);
 }
+/** Submission-gate summons: subject kind determines the officer without a province child. */
 export async function runGatekeeper(options) {
     const loadSoul = options.loadSoul ?? defaultLoadSoul;
-    let provinceRun;
-    try {
-        // Seat identity only — shared executor owns model config/registry/auth (#453 / ADR 0018).
-        provinceRun = await executeAuditorChild({
-            context: options.context,
-            roleLabel: "Gatekeeper",
-            gateSeat: "gatekeeper",
-            systemPrompt: await loadSoul("gatekeeper"),
-            prompt: "卷宗已受理。",
-            tool: createGatekeeperOutputTool(),
-            dossierTool: subjectTool(options.subject),
-            ...(options.signal === undefined ? {} : { signal: options.signal }),
-            ...(options.runDirectory === undefined ? {} : { runDirectory: options.runDirectory }),
-        });
-    }
-    catch (error) {
-        return { status: "transport_failure", stage: "gatekeeper", reason: failureReason(error) };
-    }
-    if (provinceRun.noReceiptLifecycle !== undefined) {
-        return { status: "no_receipt", stage: "gatekeeper", reason: `${gateSeatLabel("gatekeeper")}未产生已接受回执即散局`, facts: provinceRun.noReceiptLifecycle };
-    }
-    const province = projectProvinceDecision(provinceRun.decision);
-    if (province.status !== "dispatch")
-        return province;
-    const officer = province.officer;
+    const officer = options.subject.kind === "worker_completion" ? "inspector" : "notary";
     try {
-        const roleLabel = officer === "inspector" ? "Inspector" : "Notary";
         const officerRun = await executeAuditorChild({
             context: options.context,
-            roleLabel,
+            roleLabel: officer === "inspector" ? "Inspector" : "Notary",
             gateSeat: officer,
             systemPrompt: await loadSoul(officer),
             prompt: "卷宗已受理。",
@@ -223,7 +179,7 @@ export async function requireGatekeeperPass(options) {
         return;
     if (gatekeeper.status === "transport_failure") {
         // Typed stage/reason/submission ride failInfrastructure → durable tool_result (#475).
-        const error = new Error(`门下省 transport_failure（${gatekeeper.stage}）：${gatekeeper.reason}`);
+        const error = new Error(`交卷闸 transport_failure（${gatekeeper.stage}）：${gatekeeper.reason}`);
         error.stage = gatekeeper.stage;
         error.reason = gatekeeper.reason;
         if (gatekeeper.submission !== undefined)

package/dist/grok/production-host.js

@@ -8414,14 +8414,7 @@ var INSPECTOR_OUTPUT_TOOL = INSPECTOR_OUTPUT_TOOL_NAME;
 var NOTARY_OUTPUT_TOOL = "ak_notary_output";
 var SUBJECT_TOOL = "ak_gatekeeper_subject";
 function gateSeatLabel(stage) {
-  switch (stage) {
-    case "gatekeeper":
-      return "\u95E8\u4E0B\u7701";
-    case "inspector":
-      return "\u5BDF\u9662";
-    case "notary":
-      return "\u7B26\u5B9D\u90CE";
-  }
+  return stage === "inspector" ? "\u5BDF\u9662" : "\u7B26\u5B9D\u90CE";
 }
 var GatekeeperEscalationError = class extends Error {
   gatekeeper;
@@ -8466,16 +8459,6 @@ function createOfficerDecisionTool(name) {
     }
   };
 }
-function createGatekeeperOutputTool() {
-  return {
-    name: GATEKEEPER_OUTPUT_TOOL_NAME,
-    description: "\u63D0\u4EA4\u95E8\u4E0B\u7701\u6D3E\u5B98\u51B3\u5B9A\u3002",
-    parameters: gatekeeperDecisionSchema,
-    async execute(_id, args) {
-      return result(`\u5DF2\u6536 ${String(args?.status)}`, args);
-    }
-  };
-}
 async function defaultLoadSoul(role) {
   return loadGatekeeperSessionMaterials(role);
 }
@@ -8498,7 +8481,7 @@ function noUsableReleaseFailure(stage, decision) {
   return {
     status: "transport_failure",
     stage,
-    reason: stage === "gatekeeper" ? "decision \u65E0\u663E\u5F0F dispatch" : "decision \u65E0\u663E\u5F0F pass/bounce/escalate",
+    reason: "decision \u65E0\u663E\u5F0F pass/bounce/escalate",
     submission: retainedSubmission(decision)
   };
 }
@@ -8506,14 +8489,6 @@ function readRecord(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
   return value;
 }
-function projectProvinceDecision(decision) {
-  const projected = projectLawfulGatekeeperOutput(decision);
-  if (projected === void 0) return noUsableReleaseFailure("gatekeeper", decision);
-  if (projected.status === "dispatch") {
-    return { status: "dispatch", officer: projected.officer };
-  }
-  return { status: "pass", findings: projected.findings ?? [] };
-}
 function projectOfficerDecision(officer, decision) {
   const record4 = readRecord(decision);
   if (record4 === void 0) return noUsableReleaseFailure(officer, decision);
@@ -8546,33 +8521,11 @@ function projectOfficerDecision(officer, decision) {
 }
 async function runGatekeeper(options) {
   const loadSoul = options.loadSoul ?? defaultLoadSoul;
-  let provinceRun;
-  try {
-    provinceRun = await executeAuditorChild({
-      context: options.context,
-      roleLabel: "Gatekeeper",
-      gateSeat: "gatekeeper",
-      systemPrompt: await loadSoul("gatekeeper"),
-      prompt: "\u5377\u5B97\u5DF2\u53D7\u7406\u3002",
-      tool: createGatekeeperOutputTool(),
-      dossierTool: subjectTool(options.subject),
-      ...options.signal === void 0 ? {} : { signal: options.signal },
-      ...options.runDirectory === void 0 ? {} : { runDirectory: options.runDirectory }
-    });
-  } catch (error) {
-    return { status: "transport_failure", stage: "gatekeeper", reason: failureReason(error) };
-  }
-  if (provinceRun.noReceiptLifecycle !== void 0) {
-    return { status: "no_receipt", stage: "gatekeeper", reason: `${gateSeatLabel("gatekeeper")}\u672A\u4EA7\u751F\u5DF2\u63A5\u53D7\u56DE\u6267\u5373\u6563\u5C40`, facts: provinceRun.noReceiptLifecycle };
-  }
-  const province = projectProvinceDecision(provinceRun.decision);
-  if (province.status !== "dispatch") return province;
-  const officer = province.officer;
+  const officer = options.subject.kind === "worker_completion" ? "inspector" : "notary";
   try {
-    const roleLabel = officer === "inspector" ? "Inspector" : "Notary";
     const officerRun = await executeAuditorChild({
       context: options.context,
-      roleLabel,
+      roleLabel: officer === "inspector" ? "Inspector" : "Notary",
       gateSeat: officer,
       systemPrompt: await loadSoul(officer),
       prompt: "\u5377\u5B97\u5DF2\u53D7\u7406\u3002",
@@ -8597,7 +8550,7 @@ async function requireGatekeeperPass(options) {
   });
   if (gatekeeper.status === "pass") return;
   if (gatekeeper.status === "transport_failure") {
-    const error = new Error(`\u95E8\u4E0B\u7701 transport_failure\uFF08${gatekeeper.stage}\uFF09\uFF1A${gatekeeper.reason}`);
+    const error = new Error(`\u4EA4\u5377\u95F8 transport_failure\uFF08${gatekeeper.stage}\uFF09\uFF1A${gatekeeper.reason}`);
     error.stage = gatekeeper.stage;
     error.reason = gatekeeper.reason;
     if (gatekeeper.submission !== void 0) error.submission = gatekeeper.submission;
@@ -11799,7 +11752,7 @@ var WORKER_SUBMISSION_GATE_RECORD_KIND = WORKER_SUBMISSION_GATE_KIND;
 var WORKER_COMMIT_BASELINE_ENTRY_TYPE = "commit-baseline";
 var WORKER_COMMIT_REMINDER_BOUNCE_ENTRY_TYPE = "commit-reminder-bounce";
 var WORKER_PREFIX_REMINDER_BOUNCE_ENTRY_TYPE = "prefix-reminder-bounce";
-var DONE = /* @__PURE__ */ new Set(["completed", "partially_completed"]);
+var WORKER_DONE_STATUSES = /* @__PURE__ */ new Set(["completed", "partially_completed"]);
 var HOOK_MARKER = "ak-roles: worker-submission-gates reference-transaction";
 var HOOKS_DIR = "ak-roles-hooks";
 var HOOK_FILE = "reference-transaction";
@@ -12005,7 +11958,7 @@ function createWorkerSubmissionGate(options = {}) {
           throw new WorkerUnfinishedReasonReminderError();
         }
       }
-      if (baseline === void 0 || root === void 0 || !DONE.has(status)) return;
+      if (baseline === void 0 || root === void 0 || !WORKER_DONE_STATUSES.has(status)) return;
       const now = head(root);
       const headMoved = now !== null && (baseline === null || now !== baseline);
       if (!headMoved && !reminded) {
@@ -12197,13 +12150,15 @@ function createFixerRoleRuntime(pi, dependencies, hostActions) {
               ctx,
               toolCallId
             );
-            await pi.requireGatekeeperPass({
-              context: ctx,
-              subject: { kind: "worker_completion", material: JSON.stringify(output) },
-              ..._signal === void 0 ? {} : { signal: _signal },
-              hostActions,
-              toolCallId
-            });
+            if (WORKER_DONE_STATUSES.has(output.status)) {
+              await pi.requireGatekeeperPass({
+                context: ctx,
+                subject: { kind: "worker_completion", material: JSON.stringify(output) },
+                ..._signal === void 0 ? {} : { signal: _signal },
+                hostActions,
+                toolCallId
+              });
+            }
             const acceptedDetails = output;
             return {
               content: [{ type: "text", text: FIXER_ACCEPTED_TEXT }],
@@ -12332,13 +12287,15 @@ function createCoderRoleRuntime(pi, dependencies, hostActions) {
               ctx2,
               toolCallId
             );
-            await pi.requireGatekeeperPass({
-              context: ctx2,
-              subject: { kind: "worker_completion", material: JSON.stringify(output) },
-              ..._signal === void 0 ? {} : { signal: _signal },
-              hostActions,
-              toolCallId
-            });
+            if (WORKER_DONE_STATUSES.has(output.status)) {
+              await pi.requireGatekeeperPass({
+                context: ctx2,
+                subject: { kind: "worker_completion", material: JSON.stringify(output) },
+                ..._signal === void 0 ? {} : { signal: _signal },
+                hostActions,
+                toolCallId
+              });
+            }
             const acceptedDetails = output;
             return {
               content: [{ type: "text", text: CODER_ACCEPTED_TEXT }],