@akagilnc/pi-workflow-roles 0.1.3558 → 0.1.3572

package/dist/public-cli/registry.js

@@ -65,7 +65,10 @@ const STARTUP_CANDIDATES = {
   navigator: [
     { provider: "openai-codex", model: "gpt-5.6-luna", thinking: "medium" },
     { provider: "xai", model: "grok-4.5", thinking: "high" }
-  ]
+  ],
+  // #708 `diarist-seat-default`: owner-set initial value; changed in the seat
+  // table like any other seat. No engine axis, package-default host.
+  diarist: [{ provider: "xai", model: "grok-4.5", thinking: "medium" }]
 };
 function publicStartupCandidates(seat) {
   return STARTUP_CANDIDATES[seat];

package/extensions/role-runtime.ts

@@ -127,6 +127,7 @@ export default function roleRuntime(pi: ExtensionAPI): void {
     loadNotarySoul: () => loadMainRoleSessionMaterials("notary"),
     loadCountersignSoul: () => loadMainRoleSessionMaterials("countersign"),
     loadGleanerLeftSoul: () => loadMainRoleSessionMaterials("gleaner-left"),
+    loadDiaristSoul: () => loadMainRoleSessionMaterials("diarist"),
     loadInspectorSoul: () => loadMainRoleSessionMaterials("inspector"),
     loadGatekeeperSoul: () => loadGatekeeperSessionMaterials("gatekeeper"),
     loadNavigatorSoul: () => loadMainRoleSessionMaterials("navigator"),

package/package.json

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

package/resources/diarist-collect.md

@@ -1,10 +1,10 @@
 # 起居郎收集方法（owner-domain）
 
-本文件是起居郎 LLM 收集器的语义方法真源（ADR 0075 `diarist-llm-collector` / `transcribe-whole-blocks`）。机器经共享 engine 接缝 staged prompt 递送本文件字节与冻结候选目录（不入 argv）；判断以本方法为准。
+本文件是起居郎语义收集的方法真源（ADR 0075 `diarist-llm-collector` / `transcribe-whole-blocks`）。
 
 ## 任务
 
-从已冻结的来源对话块目录中，选出**与本票决策相关**的整块。相关性由你裁决；不得因缺票号、缺引语或关键词未命中而排除。
+从本票已冻结的来源块文件中，选出**与本票决策相关**的整块。文件路径见本轮材料中的路径指针，自行读取；不要等别人把正文贴进对话。
 
 ## 何谓决策相关
 
@@ -14,16 +14,12 @@
 - 命名、工序先后、调用面、闸位、存量是否补档等裁决
 - 对既有 ADR / 法源的采纳、修正或明确不适用
 - 陛下（owner）原话、确认、否决、收口条件
-- 为上述裁决提供必要上下文的紧邻块（可标 `triage: context`）
+- 为上述裁决提供必要上下文的紧邻块
 
-无关闲聊、纯工具噪声、与本票决策无涉的他票材料，标 `irrelevant` 或不选。
+无关闲聊、纯工具噪声、与本票决策无涉的他票材料不选。
 
 ## 誊录整块
 
-- 入选即整块保留：以 `candidateIndex` 指向目录中的完整 transcript，不指针化、不摘要替代正文。
-- `quotes` 必须是该块 transcript 内的**连续原文子串**（可空数组）。拼接、改写、跨段拼贴会在机械反验中失败并拒入录。
+- 入选即整块保留：指向文件中的完整 transcript，不指针化、不摘要替代正文。
+- 引语必须是该块 transcript 内的**连续原文子串**。拼接、改写、跨段拼贴会在机械反验中失败并拒入录。
 - 宁多勿漏：拿不准是否决策相关时入选，由下游反验与人读面承接。
-
-## 输出
-
-只输出一个 JSON 对象，形状由机器 prompt 给出的 `selections` 约定。不要输出 JSON 以外的文字。

package/scripts/build-package.mjs

@@ -88,16 +88,16 @@ export async function buildPublicAkRoleBin(
 }
 
 /**
- * Deferred grok-build production host artifact. Loaded only when the composition
- * root selects grok-build — keeps role-runtime / peer edges out of the public bin.
- * packages:"external" so optional peers resolve from the install tree at selection.
+ * Deferred generic ACP production host artifact. Loaded only when the composition
+ * root selects an external host row — keeps role-runtime / peer edges out of the
+ * public bin. packages:"external" so optional peers resolve at selection.
  */
-export async function buildGrokProductionHost(
-  outfile = "dist/grok/production-host.js",
+export async function buildAcpProductionHost(
+  outfile = "dist/acp-host/production-host.js",
 ) {
   await mkdir(dirname(outfile), { recursive: true });
   await build({
-    entryPoints: ["src/grok/production-host.ts"],
+    entryPoints: ["src/acp-host/production-host.ts"],
     outfile,
     format: "esm",
     platform: "node",
@@ -108,7 +108,7 @@ export async function buildGrokProductionHost(
   });
   // role-envelope resolves ./mcp-relay.mjs from import.meta.url — keep it beside the bundle.
   await copyFile(
-    resolve("src/grok/mcp-relay.mjs"),
+    resolve("src/acp-host/mcp-relay.mjs"),
     join(dirname(outfile), "mcp-relay.mjs"),
   );
 }
@@ -137,7 +137,7 @@ export async function buildPackageArtifacts() {
     );
   }
   await buildPublicAkRoleBin();
-  await buildGrokProductionHost();
+  await buildAcpProductionHost();
 }
 
 const isMain =

package/souls/diarist.md

@@ -0,0 +1,9 @@
+# Diarist Soul（起居郎）
+
+你为本案找齐并整理决策依据，收进本票已有的起居录。你只记录已经作出的决定，不立法、不批准设计、不指挥施工。
+
+- 相关性由你裁决：不把票面已列出的材料当完整候选集合，也不以票号、引语或关键词未命中作为排除依据。
+- 分清身份：陛下（owner）的决定、助手的提议、正式裁决、你自己的整理解释，四者不得混同；建议不得写成授权。
+- 导航而非重写：已有设计与法源以原件指针加简短关系说明引用，不复制成第二份规范。
+- 分清现行与历史：被修订替代的决定保留出处，但不与当前方向并列。
+- 缺录、不可读、引用无法核实时如实说明，不猜成事实，不以缺失充当"没有问题"。

package/src/acp-host/description.ts

@@ -0,0 +1,43 @@
+/**
+ * One ACP host description. Every host-specific value the generic ACP adapter
+ * needs — binary location, argv shape, resume verb, binding filename, child env
+ * — is data here; the lifecycle in role-turn-host.ts stays one copy (#732).
+ */
+import { join } from "node:path";
+
+export type AcpHostDescription = Readonly<{
+  /** Binary path segments relative to the operator home. */
+  binaryFromHome: readonly string[];
+  argv: Readonly<{
+    prefix: readonly string[];
+    suffix: readonly string[];
+    modelFlag?: string;
+    thinkingFlag?: string;
+  }>;
+  /** Which verb a bound resume uses; "session/new" hosts always mint + bind. */
+  boundResume: "session/load" | "session/new";
+  /** Durable ACP binding filename written beside the session principal. */
+  sessionBindingFile: string;
+  childEnv: Readonly<Record<string, string>>;
+}>;
+
+/** Absolute agent binary for one operator home. */
+export function resolveAcpBinary(description: AcpHostDescription, operatorHome: string): string {
+  return join(operatorHome, ...description.binaryFromHome);
+}
+
+/** Stdio argv: prefix, optional model/thinking flag pairs, suffix. */
+export function acpStdioArgs(
+  description: AcpHostDescription,
+  model?: { readonly model?: string; readonly thinking?: string },
+): string[] {
+  const { prefix, suffix, modelFlag, thinkingFlag } = description.argv;
+  const pair = (flag: string | undefined, value: string | undefined): string[] =>
+    flag === undefined || value === undefined ? [] : [flag, value];
+  return [
+    ...prefix,
+    ...pair(modelFlag, model?.model),
+    ...pair(thinkingFlag, model?.thinking),
+    ...suffix,
+  ];
+}

package/src/{grok → acp-host}/mcp-relay.mjs

@@ -2,9 +2,9 @@
 import { connect } from "node:net";
 import { createInterface } from "node:readline";
 
-const socketPath = process.env.AK_GROK_MCP_SOCKET;
-const token = process.env.AK_GROK_MCP_TOKEN;
-if (!socketPath || !token) throw new Error("AK Grok MCP relay identity is missing");
+const socketPath = process.env.AK_ACP_MCP_SOCKET;
+const token = process.env.AK_ACP_MCP_TOKEN;
+if (!socketPath || !token) throw new Error("AK ACP MCP relay identity is missing");
 
 const upstream = connect(socketPath);
 const waiters = new Map();
@@ -45,7 +45,7 @@ upstream.on("error", (error) => settle(error));
 upstream.on("close", () => {
   // Shutdown may already be requested (stdin EOF) while an RPC is still
   // in flight. Outstanding waiters must still settle, or drain never ends.
-  if (!exiting) settle(new Error("AK Grok MCP upstream closed"));
+  if (!exiting) settle(new Error("AK ACP MCP upstream closed"));
   maybeExit();
 });
 createInterface({ input: upstream }).on("line", (line) => {
@@ -56,7 +56,7 @@ createInterface({ input: upstream }).on("line", (line) => {
   if (waiter === undefined) return;
   waiters.delete(message.id);
   if (message.error !== undefined) {
-    const error = new Error(typeof message.error.message === "string" ? message.error.message : "AK Grok MCP relay failure");
+    const error = new Error(typeof message.error.message === "string" ? message.error.message : "AK ACP MCP relay failure");
     error.code = message.error.code;
     error.cause = message.error;
     waiter.reject(error);

package/src/{grok → acp-host}/production-host.ts

@@ -1,13 +1,12 @@
 /**
- * Production composition for the grok-build RoleTurnHost adapter (#580 / #522 / #717).
- * Owns injectables around the S6 true adapter; does not alter S6 adapter behavior.
+ * Production composition for the generic ACP RoleTurnHost adapter (#732).
+ * Owns injectables around the S6 true adapter; does not alter adapter behavior.
  *
- * Grok CLI uses the operator home (`~/.grok`) and credentials in place. The
- * factory does not create a run-scoped grok home, does not rewrite HOME, and
- * does not copy or scrub auth.json. Sititian records on the run are the dossier.
+ * The agent runs against the operator home and its credentials in place. The
+ * factory does not create a run-scoped agent home, does not rewrite HOME, and
+ * does not copy or scrub credentials. Sitian records on the run are the dossier.
  */
 import { readFile } from "node:fs/promises";
-import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 
 import { loadCanonicalSkillBinding as loadHomeCanonicalSkillBinding } from "../canonical-skill-binding.ts";
@@ -25,35 +24,23 @@ import { createPerDispatchReviewerAgent } from "../reviewer-agent.ts";
 import { formatNavigatorRoleHelp, type RoleRuntimeDependencies } from "../role-runtime.ts";
 import { createReviewerPinnedGitReader } from "../reviewer-pinned-git.ts";
 import { loadGatekeeperSessionMaterials, loadMainRoleSessionMaterials } from "../session-opening-materials.ts";
-import { createComposedGrokRoleTurnHost } from "./role-envelope.ts";
-import {
-  connectGrokAcpStdio,
-  controlledGrokChildEnv,
-} from "./role-turn-host.ts";
-import { createGrokSessionIdentityAuthority } from "./session-identity.ts";
+import { acpStdioArgs, resolveAcpBinary, type AcpHostDescription } from "./description.ts";
+import { createComposedAcpRoleTurnHost } from "./role-envelope.ts";
+import { connectAcpStdio } from "./role-turn-host.ts";
+import { createAcpSessionIdentityAuthority } from "./session-identity.ts";
 
-export type ProductionGrokHostOptions = Readonly<{
+export type ProductionAcpHostOptions = Readonly<{
   packageRoot: string;
   principalAuthority: DurablePrincipalAuthority;
+  description: AcpHostDescription;
 }>;
 
-function resolveGrokBinary(operatorHome: string): string {
-  return join(operatorHome, ".grok", "bin", "grok");
-}
-
-function childEnv(packageRoot: string): NodeJS.ProcessEnv {
-  return {
-    ...controlledGrokChildEnv(process.env),
-    AK_PACKAGE_ROOT: packageRoot,
-  };
-}
-
 const navigatorRoutePlaybookPath = fileURLToPath(
   new URL("../../resources/navigator-route-playbook.md", import.meta.url),
 );
 
-/** Host-neutral packaged role runtime deps for the Grok parent-process envelope. */
-export function createGrokRoleRuntimeDependencies(packageRoot: string): RoleRuntimeDependencies {
+/** Host-neutral packaged role runtime deps for the ACP parent-process envelope. */
+export function createAcpRoleRuntimeDependencies(packageRoot: string): RoleRuntimeDependencies {
   const judgeAuditor = createPiJudgeAuditor();
   const doctorAuditor = createPiDoctorAuditor();
   const reviewerAgent = createPerDispatchReviewerAgent({ packageRoot });
@@ -77,6 +64,7 @@ export function createGrokRoleRuntimeDependencies(packageRoot: string): RoleRunt
     loadNotarySoul: () => loadMainRoleSessionMaterials("notary"),
     loadCountersignSoul: () => loadMainRoleSessionMaterials("countersign"),
     loadGleanerLeftSoul: () => loadMainRoleSessionMaterials("gleaner-left"),
+    loadDiaristSoul: () => loadMainRoleSessionMaterials("diarist"),
     loadNotarySourceRun: loadNotarySourceRunLocator,
     loadMergerSoul: () => loadMainRoleSessionMaterials("merger"),
     loadMergerInput: async (path) => JSON.parse(await readFile(path, "utf8")),
@@ -119,22 +107,28 @@ export function createGrokRoleRuntimeDependencies(packageRoot: string): RoleRunt
 }
 
 /**
- * Assemble the production grok-build RoleTurnHost from the S6 true adapter.
- * Grok subprocesses inherit the operator home; the run directory is sitian-only.
+ * Assemble a production ACP RoleTurnHost from the S6 true adapter for one host
+ * description. Agent subprocesses inherit the operator home; the run directory
+ * is sitian-only.
  */
-export function createProductionGrokRoleTurnHost(options: ProductionGrokHostOptions): RoleTurnHost {
-  const { packageRoot, principalAuthority } = options;
-  const env = childEnv(packageRoot);
+export function createProductionAcpRoleTurnHost(options: ProductionAcpHostOptions): RoleTurnHost {
+  const { packageRoot, principalAuthority, description } = options;
+  const env: NodeJS.ProcessEnv = {
+    ...process.env,
+    ...description.childEnv,
+    AK_PACKAGE_ROOT: packageRoot,
+  };
 
-  return createComposedGrokRoleTurnHost({
-    sessionIdentity: createGrokSessionIdentityAuthority(principalAuthority),
-    roleRuntimeDependencies: createGrokRoleRuntimeDependencies(packageRoot),
+  return createComposedAcpRoleTurnHost({
+    sessionIdentity: createAcpSessionIdentityAuthority(principalAuthority, description.sessionBindingFile),
+    boundResume: description.boundResume,
+    roleRuntimeDependencies: createAcpRoleRuntimeDependencies(packageRoot),
     async connect(request) {
-      return connectGrokAcpStdio({
-        binary: resolveGrokBinary(request.home),
+      return connectAcpStdio({
+        binary: resolveAcpBinary(description, request.home),
+        args: acpStdioArgs(description, request.model),
         cwd: request.cwd,
         env,
-        ...(request.model === undefined ? {} : { model: request.model.model }),
       });
     },
   });

package/src/{grok → acp-host}/role-envelope.ts

@@ -22,9 +22,9 @@ import {
   type RoleRuntimeDependencies,
 } from "../role-runtime.ts";
 import {
-  createGrokRoleTurnHost,
-  type GrokPreparedTurn,
-  type GrokRoleTurnHostConfig,
+  createAcpRoleTurnHost,
+  type AcpPreparedTurn,
+  type AcpRoleTurnHostConfig,
 } from "./role-turn-host.ts";
 import {
   GatekeeperDecisionError,
@@ -51,7 +51,7 @@ export function parseCanonicalSkillInvocation(prompt: string): { readonly name:
 }
 
 /** Build host-side Skill expansion evidence from pre-read RoleTurnRequest.methods. */
-export function buildGrokSkillExpansion(
+export function buildAcpSkillExpansion(
   methodSkills: ReadonlyMap<string, { readonly path: string; readonly body: string }>,
   prompt: string,
 ): HostSkillExpansionEvidence | undefined {
@@ -67,7 +67,7 @@ export function buildGrokSkillExpansion(
   });
 }
 
-export function projectGrokActivationFlags(request: RoleTurnRequest): Map<string, boolean | string> {
+export function projectAcpActivationFlags(request: RoleTurnRequest): Map<string, boolean | string> {
   const activation = request.activation;
   const flags = new Map<string, boolean | string>([["ak-role", activation.role]]);
   const inputFlag = packagedRoleInputFlag(activation.role);
@@ -78,7 +78,8 @@ export function projectGrokActivationFlags(request: RoleTurnRequest): Map<string
       : "packetPath" in activation ? activation.packetPath
         : "casePath" in activation ? activation.casePath
           : "inputPath" in activation ? activation.inputPath
-            : "sourceRun" in activation ? activation.sourceRun : undefined;
+            : "sourceRun" in activation ? activation.sourceRun
+              : "sourcesPath" in activation ? activation.sourcesPath : undefined;
     if (path !== undefined) flags.set(inputFlag, path);
   }
   if (activation.role === "fixer" && activation.prerequisitesPath !== undefined) flags.set("ak-fixer-prerequisites", activation.prerequisitesPath);
@@ -114,25 +115,25 @@ async function listen(server: Server, path: string): Promise<void> {
  * Build one AK-owned MCP projection from the shared eight-seat envelope.
  * The child process is a protocol relay only; all tools execute in this process.
  */
-export function createComposedGrokRoleTurnHost(
-  config: Omit<GrokRoleTurnHostConfig, "prepare"> & {
+export function createComposedAcpRoleTurnHost(
+  config: Omit<AcpRoleTurnHostConfig, "prepare"> & {
     readonly roleRuntimeDependencies: RoleRuntimeDependencies;
     readonly socketPath?: (request: RoleTurnRequest) => string;
   },
 ) {
-  return createGrokRoleTurnHost({
+  return createAcpRoleTurnHost({
     ...config,
-    prepare: (request) => prepareGrokRoleEnvelope({
+    prepare: (request) => prepareAcpRoleEnvelope({
       request,
       dependencies: config.roleRuntimeDependencies,
       // Same durable-principal path settlement uses for isAvailable (#617 DK-4 layout).
       sessionFile: config.sessionIdentity.resolveSessionFile(request.principal),
-      socketPath: config.socketPath?.(request) ?? `/tmp/ak-grok-mcp-${randomUUID()}.sock`,
+      socketPath: config.socketPath?.(request) ?? `/tmp/ak-acp-mcp-${randomUUID()}.sock`,
     }),
   });
 }
 
-export async function prepareGrokRoleEnvelope(options: {
+export async function prepareAcpRoleEnvelope(options: {
   readonly request: RoleTurnRequest;
   readonly dependencies: RoleRuntimeDependencies;
   readonly socketPath: string;
@@ -142,9 +143,9 @@ export async function prepareGrokRoleEnvelope(options: {
    * isAvailable and envelope mint the same file. Tests may omit → runDirectory default.
    */
   readonly sessionFile?: string;
-}): Promise<GrokPreparedTurn> {
+}): Promise<AcpPreparedTurn> {
   const { request } = options;
-  const flags = projectGrokActivationFlags(request);
+  const flags = projectAcpActivationFlags(request);
   const tools = new Map<string, HostToolDefinition>();
   const handlers = new Map<string, Handler[]>();
   const calls: Array<{ toolCallId: string; toolName: string }> = [];
@@ -169,7 +170,7 @@ export async function prepareGrokRoleEnvelope(options: {
   }
 
   // Durable principal file for isAvailable / resumable settlement (public-cli).
-  // #617 DK-4: header layout only — never Grok conversation/tool writeback into Pi JSONL.
+  // #617 DK-4: header layout only — never host conversation/tool writeback into Pi JSONL.
   let sessionFile = options.sessionFile ?? join(request.runDirectory, "session", "session.jsonl");
   await mkdir(dirname(sessionFile), { recursive: true });
   if (request.continuation.kind !== "resume") {
@@ -235,16 +236,16 @@ export async function prepareGrokRoleEnvelope(options: {
     deliverSubmissionRejection(value) { rejection = value; },
     capabilities: {
       skillExpansion(prompt): HostSkillExpansionEvidence | undefined {
-        return buildGrokSkillExpansion(methodSkills, prompt);
+        return buildAcpSkillExpansion(methodSkills, prompt);
       },
     },
     registerFlag(name, definition) { if (!flags.has(name) && definition.default !== undefined) flags.set(name, definition.default); },
     getFlag(name) { return flags.get(name); },
     registerTool(tool) { tools.set(tool.name, tool); },
-    // The real AK-owned surface only; Grok's builtin surface is host-side and
+    // The real AK-owned surface only; the host builtin surface is host-side and
     // observable after session/new, never echoed back into role-requested names.
     getAllTools() { return [...tools.keys()].map((name) => ({ name })); },
-    // Grok receives tool choice as role guidance; every tool registered for the
+    // The host receives tool choice as role guidance; every tool registered for the
     // seat remains reachable through MCP.
     setActiveTools(names) { preferredTools = [...names]; },
     getActiveTools() { return [...preferredTools]; },
@@ -580,13 +581,13 @@ export async function prepareGrokRoleEnvelope(options: {
     }
     if (cleanupFailures.length === 1) throw cleanupFailures[0];
     if (cleanupFailures.length > 1) {
-      throw new AggregateError(cleanupFailures, "Grok envelope dispose cleanup failures", {
+      throw new AggregateError(cleanupFailures, "ACP envelope dispose cleanup failures", {
         cause: cleanupFailures[0],
       });
     }
   };
 
-  const closeRound: GrokPreparedTurn["closeRound"] = async () => {
+  const closeRound: AcpPreparedTurn["closeRound"] = async () => {
     // Typed round boundary: hand the complete call list to the shared ledger once.
     if (calls.length > 0) {
       const roundCalls = [...calls];
@@ -606,7 +607,7 @@ export async function prepareGrokRoleEnvelope(options: {
     }
     if (closure !== undefined) {
       // Pi flushes navigator attendance on agent_settled; session/prompt
-      // resolution is grok-build's equivalent round boundary.
+      // resolution is the ACP host equivalent round boundary.
       await emit("agent_settled", {});
       return { accepted: true as const };
     }
@@ -674,8 +675,8 @@ export async function prepareGrokRoleEnvelope(options: {
         command: process.execPath,
         args: [relay],
         env: [
-          { name: "AK_GROK_MCP_SOCKET", value: options.socketPath },
-          { name: "AK_GROK_MCP_TOKEN", value: token },
+          { name: "AK_ACP_MCP_SOCKET", value: options.socketPath },
+          { name: "AK_ACP_MCP_TOKEN", value: token },
         ],
       }],
       systemPrompt: { body: systemPromptBody, materials: readingMaterials },
@@ -693,7 +694,7 @@ export async function prepareGrokRoleEnvelope(options: {
     } catch (cleanupFailure) {
       throw new AggregateError(
         [error, cleanupFailure],
-        "prepareGrokRoleEnvelope activation failed and its dispose cleanup also failed",
+        "prepareAcpRoleEnvelope activation failed and its dispose cleanup also failed",
         { cause: error },
       );
     }