@akagilnc/pi-workflow-roles 0.1.3565 → 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.3565",
+  "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/souls/diarist.md

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

package/src/acp-host/production-host.ts

@@ -64,6 +64,7 @@ export function createAcpRoleRuntimeDependencies(packageRoot: string): RoleRunti
     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")),

package/src/acp-host/role-envelope.ts

@@ -78,7 +78,8 @@ export function projectAcpActivationFlags(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);

package/src/diarist-contracts.ts

@@ -0,0 +1,88 @@
+/**
+ * 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" as const,
+  },
+} as const;
+
+/** One selected block reference into the frozen candidate catalog. */
+export type DiaristSelection = {
+  /** Index into the catalog the diarist received. */
+  readonly candidateIndex: number;
+  /** Quotes claimed verbatim from that block (reverse-verified mechanically). */
+  readonly quotes: readonly string[];
+  /** Human-facing note (relation to this case). Not a machine gate. */
+  readonly note?: string;
+};
+
+export type DiaristOutput = {
+  readonly status: "completed";
+  readonly selections: readonly DiaristSelection[];
+};
+
+export function validateRecordedDiaristOutput(value: unknown): DiaristOutput {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("Diarist output has no execution discriminator");
+  }
+  let status: unknown;
+  try {
+    status = (value as Record<string, unknown>).status;
+  } catch {
+    throw new Error("Diarist output has no execution discriminator");
+  }
+  if (status === "completed") {
+    return value as DiaristOutput;
+  }
+  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: unknown): DiaristSelection[] {
+  const rows = (value as { selections?: unknown } | null)?.selections;
+  if (!Array.isArray(rows)) return [];
+  const out: DiaristSelection[] = [];
+  for (const row of rows) {
+    if (row === null || typeof row !== "object" || Array.isArray(row)) continue;
+    const record = row as Record<string, unknown>;
+    const index = record.candidateIndex;
+    if (typeof index !== "number" || !Number.isInteger(index) || index < 0) continue;
+    const quotes = Array.isArray(record.quotes)
+      ? record.quotes.filter((q): q is string => 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: DiaristOutput,
+): Record<string, unknown> {
+  const facts: Record<string, unknown> = { status: output.status };
+  const selections = (output as { selections?: unknown }).selections;
+  if (Array.isArray(selections)) facts.selections = selections;
+  // Mechanical sitian facts recorded by the envelope at accept time.
+  const sitian = (output as { sitian?: unknown }).sitian;
+  if (sitian !== undefined) facts.sitian = sitian;
+  return facts;
+}

package/src/diarist-role.ts

@@ -0,0 +1,60 @@
+import type { Static } from "typebox";
+import { Type } from "typebox";
+
+import { openToolObject } from "./open-tool-schema.ts";
+import { withInfrastructureFailureDeclaration } from "./package-contracts/terminating-infrastructure.ts";
+import {
+  DIARIST_OUTPUT_TOOL_NAME,
+  validateRecordedDiaristOutput,
+  type DiaristOutput,
+} from "./diarist-contracts.ts";
+
+export {
+  DIARIST_ACCEPTED_TEXT,
+  DIARIST_OUTPUT_TOOL_NAME,
+} from "./diarist-contracts.ts";
+export type { DiaristOutput };
+export { validateRecordedDiaristOutput };
+
+/** 起居郎交卷形状；形状指引，非 schema 闸。 */
+export const diaristOutputSchema = withInfrastructureFailureDeclaration(
+  openToolObject(
+    Type.Object({
+      status: Type.Unknown({
+        description: "completed — 形状指引，非 schema 闸",
+      }),
+      selections: Type.Array(
+        Type.Object(
+          {
+            candidateIndex: Type.Number({ description: "候选目录中的整块序号" }),
+            quotes: Type.Array(Type.String(), {
+              description: "该块 transcript 内的连续原文；机械反验",
+            }),
+            note: Type.Optional(
+              Type.String({ description: "该材料与本案的关系（人读）" }),
+            ),
+          },
+          { additionalProperties: true, description: "一条入录选择" },
+        ),
+        { description: "入录选择；空列表合法完局" },
+      ),
+    }),
+  ),
+);
+
+export type DiaristOutputParameters = Static<typeof diaristOutputSchema>;
+
+export type DiaristRuntimeDependencies = {
+  loadSoul(): Promise<string>;
+};
+
+/**
+ * 决定工具规格。生命周期装配归注册信封 owner——src/role-runtime.ts（ADR 0018）。
+ */
+export const DIARIST_TOOL_SPEC = {
+  name: DIARIST_OUTPUT_TOOL_NAME,
+  label: "起居郎输出",
+  description: "起居郎入录选择。",
+  promptSnippet: "起居郎入录选择",
+  parameters: diaristOutputSchema,
+} as const;