@akagilnc/pi-workflow-roles 0.1.3377 → 0.1.3391

package/README.md

@@ -11,6 +11,8 @@ pi install npm:@akagilnc/pi-workflow-roles
 export PATH="$HOME/.pi/agent/npm/node_modules/.bin:$PATH"
 ```
 
+Four court seats (`coder` / `fixer` / `judge` / `countersign`) resolve an unbound ticket from the instruction via a Hermes labor-engine detour before the turn runs. Keep a working `hermes` executable on `PATH` for those seats; spawn failure, nonzero exit, or unusable 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)). Pi-only installs that never dispatch those seats do not need Hermes.
+
 Update with `pi update npm:@akagilnc/pi-workflow-roles`—never a second global `npm install -g`. Inspect with `ak-role roles` and `ak-role help <role>`; seat and Gate-officer configuration lives under Reading results below.
 
 ### Test channel (`next`)
@@ -75,7 +77,7 @@ The examples below are usage sketches; option identity, aliases, requiredness, a
 
 ```bash
 # countersign — ticket-court review before work starts; resume continues the exact session
-ak-role countersign --attach ./ticket.md "裁：本票是否足以开工。"
+ak-role countersign --attach ./ticket.md "裁：本票 #582 是否足以开工。"
 
 # gleaner-left — unanchored pre-merge memorials; resume continues the exact session; --base required; instruction may be empty; callers must not pass directional instruction
 ak-role gleaner-left --base main
@@ -102,9 +104,8 @@ ak-role doctor --issue 115 "Diagnose this retained case."
 # merger — resolve one merge already in conflict (start it with Git's ort first)
 ak-role merger --project /path/to/worktree "Reconcile the active merge."
 
-# notary — document-fidelity check on one retained source run; optional --ticket for court diary
+# notary — document-fidelity check on one retained source run; ticket key inherited from source-run admitted form
 ak-role notary --source-run <runId@role|path>
-ak-role notary --source-run <runId@role|path> --ticket 582
 
 # inspector — direct complexity and test-quality check
 ak-role inspector --attach ./change.patch "Review this material."
@@ -115,8 +116,8 @@ ak-role gatekeeper --attach ./submission.json "审：这批材料该谁审？"
 # navigator — direct route advice (ordered next-role candidates); automatic attendance unchanged
 ak-role navigator "刚完成 coder apply 收敛，下一步？"
 
-# countersign — ticket-court five questions; optional --ticket (diarist pipeline refreshes court diary first)
-ak-role countersign --ticket 582 --attach ./ticket.md "裁：本票是否足以开工。"
+# countersign — ticket-court five questions; ticket recognition via instruction
+ak-role countersign --attach ./ticket.md "裁：本票 #582 是否足以开工。"
 
 # analyst — deterministic metrics; bare call = whole book
 ak-role analyst

package/README.zh-CN.md

@@ -96,9 +96,8 @@ ak-role doctor --issue 115 "Diagnose this retained case."
 # 校书郎——调和已在冲突的 merge（先用 Git ort 起动）
 ak-role merger --project /path/to/worktree "Reconcile the active merge."
 
-# 符宝郎——文书核验一份留存 source run；可选 --ticket 调起居录
+# 符宝郎——文书核验一份留存 source run；票号从 source-run admitted form 继承
 ak-role notary --source-run <runId@role|path>
-ak-role notary --source-run <runId@role|path> --ticket 582
 
 # 察院——直调复杂度与测试质量两轴
 ak-role inspector --attach ./change.patch "Review this material."
@@ -109,8 +108,8 @@ ak-role gatekeeper --attach ./submission.json "审：这批材料该谁审？"
 # 游奕使——直调路线建议（有序的下一步角色候选）；自动出席不变
 ak-role navigator "刚完成 coder apply 收敛，下一步？"
 
-# 给事中——票庭五问；可选 --ticket（起居郎流水线前序工序按票刷新起居录）
-ak-role countersign --ticket 582 --attach ./ticket.md "裁：本票是否足以开工。"
+# 给事中——票庭五问；票号经由 instruction 识别
+ak-role countersign --attach ./ticket.md "裁：本票 #582 是否足以开工。"
 
 # 左拾遗——合并前无锚定风闻；可 resume 续同一 session；--base 必填；instruction 可空；调用者不得传方向性 instruction
 ak-role gleaner-left --base main

package/dist/auditor-dossier-tool.js

@@ -1,6 +1,12 @@
+import { mkdirSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { Type } from "typebox";
 export const AUDITOR_DOSSIER_TOOL_NAME = "ak_get_run_dossier";
+/** Run-relative leaf written before gate officer summons (#632 Grok header-only session). */
+export const GATE_SUBMISSION_CANDIDATE_FILE = "gate-submission-candidate.json";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 /** Resolve the exact run binding already carried by the parent record session. */
 export function auditorRunDirectory(context) {
     const sessionFile = context.sessionManager?.getSessionFile?.();
@@ -9,8 +15,46 @@ export function auditorRunDirectory(context) {
     // Sole layout: <run>/session/session.jsonl → climb two levels to the run directory.
     return resolve(dirname(dirname(sessionFile)));
 }
+/**
+ * Latest assistant toolCall leaf on parent session books (memory or disk-backed).
+ * Grok books the candidate in memory only (#617 DK-4); Pi books the same shape on JSONL.
+ */
+export function readLatestToolCallLeaf(context) {
+    const entries = [...(context.sessionManager?.getEntries?.() ?? [])];
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const entry = entries[i];
+        if (!isRecord(entry) || entry.type !== "message" || !isRecord(entry.message))
+            continue;
+        const message = entry.message;
+        if (message.role !== "assistant" || !Array.isArray(message.content))
+            continue;
+        for (const part of message.content) {
+            if (isRecord(part) && part.type === "toolCall") {
+                return entry;
+            }
+        }
+    }
+    return undefined;
+}
+export function gateSubmissionCandidatePath(runDirectory) {
+    return join(runDirectory, "artifacts", GATE_SUBMISSION_CANDIDATE_FILE);
+}
+/**
+ * Persist the in-flight tool-call leaf as a run-directory artifact so pointer-only
+ * officer summons resolve on hosts whose session.jsonl is header-only (#632 / DK-4).
+ * Returns the written path, or undefined when no toolCall leaf is on the books.
+ */
+export function persistGateSubmissionCandidate(runDirectory, context) {
+    const leaf = readLatestToolCallLeaf(context);
+    if (leaf === undefined)
+        return undefined;
+    const path = gateSubmissionCandidatePath(runDirectory);
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(leaf)}\n`, "utf8");
+    return path;
+}
 /** The one shared, run-bound dossier locator exposed to every auditor seat. */
-export function createAuditorDossierTool(runDirectory) {
+export function createAuditorDossierTool(runDirectory, options) {
     return {
         name: AUDITOR_DOSSIER_TOOL_NAME,
         description: "定位本审计席绑定的 run 卷宗及其证据入口。",
@@ -22,12 +66,17 @@ export function createAuditorDossierTool(runDirectory) {
                     details: undefined,
                 };
             }
+            const sessionPath = join(runDirectory, "session", "session.jsonl");
+            const submissionCandidate = options?.submissionCandidate;
+            // Prefer the persisted gate leaf when present: Grok session.jsonl is header-only
+            // (#617 DK-4) and is not a candidate source after material deletion (#632).
             const details = {
                 runDirectory,
                 admittedRequest: join(runDirectory, "admitted-request.json"),
-                parentSessionCandidate: join(runDirectory, "session", "session.jsonl"),
+                parentSessionCandidate: submissionCandidate ?? sessionPath,
                 attachments: join(runDirectory, "attachments"),
                 artifacts: join(runDirectory, "artifacts"),
+                ...(submissionCandidate === undefined ? {} : { submissionCandidate }),
             };
             return {
                 content: [{ type: "text", text: JSON.stringify(details) }],

package/dist/gatekeeper-role.js

@@ -1,4 +1,5 @@
 import { Type } from "typebox";
+import { auditorRunDirectory, createAuditorDossierTool, persistGateSubmissionCandidate, } from "./auditor-dossier-tool.js";
 import { executeAuditorChild } from "./evidence-child-executor.js";
 import { openToolObject } from "./open-tool-schema.js";
 import { loadGatekeeperSessionMaterials } from "./session-opening-materials.js";
@@ -7,7 +8,6 @@ import { INSPECTOR_OUTPUT_TOOL_NAME } from "./inspector-contracts.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) {
     return stage === "inspector" ? "察院" : "符宝郎";
 }
@@ -42,14 +42,6 @@ export const GATEKEEPER_TOOL_SPEC = {
 function result(content, details) {
     return { content: [{ type: "text", text: content }], details };
 }
-function subjectTool(subject) {
-    return {
-        name: SUBJECT_TOOL,
-        description: "读取已受理卷宗；只供取阅，不评判不改动。",
-        parameters: Type.Object({}, { additionalProperties: false }),
-        async execute() { return result(JSON.stringify(subject), subject); },
-    };
-}
 /** Shared officer decision tool — open transport; projection owns legality. */
 export function createOfficerDecisionTool(name) {
     return {
@@ -147,6 +139,13 @@ function projectOfficerDecision(officer, decision) {
 export async function runGatekeeper(options) {
     const loadSoul = options.loadSoul ?? defaultLoadSoul;
     const officer = options.subject.kind === "worker_completion" ? "inspector" : "notary";
+    // Resolve once so dossier tool and child session share the same run binding (#632).
+    const runDirectory = options.runDirectory ?? auditorRunDirectory(options.context);
+    // Pointer-only summons need a resolvable leaf: Grok session.jsonl is header-only
+    // (#617 DK-4); write the in-memory tool-call candidate as a run artifact first (#632).
+    const submissionCandidate = runDirectory === undefined
+        ? undefined
+        : persistGateSubmissionCandidate(runDirectory, options.context);
     try {
         const officerRun = await executeAuditorChild({
             context: options.context,
@@ -155,9 +154,10 @@ export async function runGatekeeper(options) {
             systemPrompt: await loadSoul(officer),
             prompt: "卷宗已受理。",
             tool: createOfficerDecisionTool(officer === "inspector" ? INSPECTOR_OUTPUT_TOOL : NOTARY_OUTPUT_TOOL),
-            dossierTool: subjectTool(options.subject),
+            // Same locator as 审刑院 — run directory + path identifiers only; no receipt body (#632).
+            dossierTool: createAuditorDossierTool(runDirectory, submissionCandidate === undefined ? undefined : { submissionCandidate }),
             ...(options.signal === undefined ? {} : { signal: options.signal }),
-            ...(options.runDirectory === undefined ? {} : { runDirectory: options.runDirectory }),
+            ...(runDirectory === undefined ? {} : { runDirectory }),
         });
         if (officerRun.noReceiptLifecycle !== undefined) {
             return { status: "no_receipt", stage: officer, reason: `${gateSeatLabel(officer)}未产生已接受回执即散局`, facts: officerRun.noReceiptLifecycle };