@akagilnc/pi-workflow-roles 0.1.2521 → 0.1.2653-next.71811ca

package/dist/host-contracts.js

@@ -0,0 +1,22 @@
+import { Type } from "typebox";
+/**
+ * Thrown activation failure with a production-owned typed cause.
+ * Prefer this over ad-hoc Error property tags so settlement retains typed identity.
+ * Final owner = host contract (#526); public-cli/pi/role-runtime all import here.
+ */
+export class ExplicitInternalActivationError extends Error {
+    knownCause;
+    failureCode;
+    constructor(message, options) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = options.name ?? "ExplicitInternalActivationError";
+        this.knownCause = options.knownCause;
+        if (options.code !== undefined) {
+            this.failureCode = options.code;
+        }
+    }
+}
+/** Local replacement for Pi AI's convenience constructor. */
+export function stringEnum(values, options = {}) {
+    return Type.Union(values.map((value) => Type.Literal(value)), options);
+}

package/dist/institutional-resolution.js

@@ -0,0 +1,88 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { seatModelOnly } from "./public-cli/config.js";
+export const INSTITUTIONAL_RESOLUTION_FILE = "institutional-resolution.json";
+export class InstitutionalResolutionError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "InstitutionalResolutionError";
+    }
+}
+function cleanSelection(model) {
+    if (model === undefined)
+        return undefined;
+    if (typeof model.provider !== "string" || typeof model.model !== "string")
+        return undefined;
+    return {
+        provider: model.provider,
+        model: model.model,
+        ...(model.thinking === undefined ? {} : { thinking: model.thinking }),
+    };
+}
+/**
+ * Resolve effective per-seat institutional selections (#518 §2 Hop 1):
+ * - gatekeeper / inspector / notary: seat override > gatekeeper override > parent effective
+ * - auditor / evidenceChild: parent effective
+ */
+export function resolveInstitutionalSeatSelections(config, parentEffectiveModel) {
+    const parentSelection = cleanSelection(parentEffectiveModel);
+    const ownInspector = cleanSelection(seatModelOnly(config.seats?.inspector));
+    const ownNotary = cleanSelection(seatModelOnly(config.seats?.notary));
+    const ownGatekeeper = cleanSelection(seatModelOnly(config.seats?.gatekeeper));
+    const gatekeeper = ownGatekeeper ?? parentSelection;
+    const inspector = ownInspector ?? ownGatekeeper ?? parentSelection;
+    const notary = ownNotary ?? ownGatekeeper ?? parentSelection;
+    const auditor = parentSelection;
+    const evidenceChild = parentSelection;
+    return {
+        version: 1,
+        seats: {
+            ...(gatekeeper === undefined ? {} : { gatekeeper }),
+            ...(inspector === undefined ? {} : { inspector }),
+            ...(notary === undefined ? {} : { notary }),
+            ...(auditor === undefined ? {} : { auditor }),
+            ...(evidenceChild === undefined ? {} : { evidenceChild }),
+        },
+    };
+}
+/**
+ * Persist institutional resolution page to run directory (#518 §2 Hop 2).
+ * Rewritten on each dispatch and resume. Zero secrets inside page.
+ */
+export async function writeInstitutionalResolutionPage(runDirectory, page) {
+    const filePath = join(runDirectory, INSTITUTIONAL_RESOLUTION_FILE);
+    await writeFile(filePath, `${JSON.stringify(page, null, 2)}\n`, "utf8");
+}
+/**
+ * Read institutional seat selection from run directory (#518 §2 Hop 3).
+ * Fails loud if page is missing, corrupted, or does not contain a resolution for the seat.
+ */
+export async function readInstitutionalSeatSelection(runDirectory, seat) {
+    const filePath = join(runDirectory, INSTITUTIONAL_RESOLUTION_FILE);
+    let raw;
+    try {
+        raw = await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        throw new InstitutionalResolutionError(`institutional resolution page is missing at ${filePath}`, { cause: error });
+    }
+    let page;
+    try {
+        page = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new InstitutionalResolutionError(`institutional resolution page is corrupted at ${filePath}`, { cause: error });
+    }
+    if (typeof page !== "object" || page === null || page.version !== 1) {
+        throw new InstitutionalResolutionError(`institutional resolution page format is invalid at ${filePath}`);
+    }
+    const seats = page.seats;
+    if (typeof seats !== "object" || seats === null) {
+        throw new InstitutionalResolutionError(`institutional resolution page missing seats object at ${filePath}`);
+    }
+    const selection = cleanSelection(seats[seat]);
+    if (selection === undefined) {
+        throw new InstitutionalResolutionError(`institutional resolution page has no resolution for seat "${seat}" at ${filePath}`);
+    }
+    return selection;
+}

package/dist/merger-contracts.js

@@ -3,7 +3,6 @@ import { isFullGitObjectId } from "./git-object-id.js";
 import { exactUtf8 } from "./exact-utf8.js";
 import { sha256Hex } from "./sha256.js";
 import { openToolObjectFromUnion } from "./open-tool-schema.js";
-import { withInfrastructureFailureDeclaration } from "./package-contracts/terminating-infrastructure.js";
 const oidPattern = "^(?:[0-9a-f]{40}|[0-9a-f]{64})$";
 const materialSchema = Type.Object({ bytesBase64: Type.String(), sha256: Type.String() }, { additionalProperties: false });
 const checkSchema = Type.Object({ name: Type.String({ minLength: 1 }), argv: Type.Array(Type.String({ minLength: 1 }), { minItems: 1 }) }, { additionalProperties: false });
@@ -19,7 +18,7 @@ const mergerOutputVariants = Type.Union([
     Type.Object({ status: Type.Literal("completed", { description: "completed — 形状指引，非 schema 闸" }), attemptId: Type.String({ minLength: 1, description: "已受理合并 attempt 身份" }), report: Type.String({ minLength: 1, description: "如实结果报告" }), mergeCommitId: Type.String({ pattern: oidPattern, description: "已核验的完成合并 commit object ID" }) }, { additionalProperties: false }),
     Type.Object({ status: Type.Literal("escalate", { description: "escalate — 形状指引，非 schema 闸" }), attemptId: Type.String({ minLength: 1, description: "已受理合并 attempt 身份" }), diagnosis: Type.String({ minLength: 1, description: "合并完成需升级的原因" }), report: Type.String({ minLength: 1, description: "如实结果报告" }) }, { additionalProperties: false }),
 ]);
-export const mergerOutputSchema = withInfrastructureFailureDeclaration(openToolObjectFromUnion(mergerOutputVariants));
+export const mergerOutputSchema = openToolObjectFromUnion(mergerOutputVariants);
 export const MERGER_OUTPUT_TOOL_NAME = "ak_merger_output";
 export const MERGER_ACCEPTED_TEXT = "合并回执已接受";
 const record = (v) => typeof v === "object" && v !== null && !Array.isArray(v);

package/dist/navigator-attendance.js

@@ -11,6 +11,11 @@ import {
   mintNavigatorInvocationId
 } from "./navigator-invocation-identity.js";
 import { PACKAGED_ROLE_REGISTRY, packagedRoleMetadata } from "./packaged-role-registry.js";
+import {
+  activationBookDirectory,
+  resolveActivationLedgerHome
+} from "./activation-ledger-topology.js";
+import { sitianReport } from "./sitian-facade.js";
 import { openInProcessAgentSession } from "./in-process-session.js";
 import { renderPublicAkRoleCommand } from "./public-command-renderer.js";
 import { issueRoot, subjectPath } from "./work-subject-identity.js";
@@ -996,6 +1001,17 @@ function createNativeNavigatorSessionFactory(defaultModelSettingPath = navigator
       providerFailure: () => providerFailure,
       appendEntry: (customType, data) => {
         opened.session.sessionManager.appendCustomEntry(customType, data);
+        try {
+          sitianReport({
+            level: "event",
+            kind: "attendance",
+            cwd: context.cwd,
+            sessionParent: opened.session.sessionManager.getSessionFile(),
+            payload: { customType, data },
+            source: "navigator-attendance"
+          });
+        } catch {
+        }
       },
       entries: () => opened.session.sessionManager.getEntries(),
       setModel: async (next, thinkingLevel) => {

package/dist/notary-contracts.js

@@ -5,7 +5,6 @@
  */
 import { Type } from "typebox";
 import { openToolObject } from "./open-tool-schema.js";
-import { withInfrastructureFailureDeclaration } from "./package-contracts/terminating-infrastructure.js";
 export const NOTARY_OUTPUT_TOOL_NAME = "ak_notary_output";
 export const NOTARY_ACCEPTED_TEXT = "符宝郎回执已接受";
 export const NOTARY_SOURCE_RUN_FLAG = {
@@ -17,14 +16,14 @@ export const NOTARY_SOURCE_RUN_FLAG = {
 };
 /** Package-owned kickoff only — callers supply zero prompt bytes (ADR 0067 / #448). */
 export const NOTARY_FIXED_KICKOFF = "符宝郎案卷已受理；来源 run 定位见会话材料。";
-export const notaryOutputSchema = withInfrastructureFailureDeclaration(openToolObject(Type.Object({
+export const notaryOutputSchema = openToolObject(Type.Object({
     status: Type.Unknown({
         description: "pass | bounce — 形状指引，非 schema 闸",
     }),
     findings: Type.Unknown({
         description: "string[] findings，随 pass 或 bounce 留存",
     }),
-})));
+}));
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }

package/dist/package-contracts/fixer-output.js

@@ -1,7 +1,6 @@
 import { Type } from "typebox";
 import { FIXER_PREREQUISITE_ID_PATTERN } from "./fixer-packet.js";
 import { openToolObjectFromUnion } from "../open-tool-schema.js";
-import { withInfrastructureFailureDeclaration } from "./terminating-infrastructure.js";
 export const FIXER_OUTPUT_TOOL_NAME = "ak_fixer_output";
 export const FIXER_ACCEPTED_TEXT = "修内司回执已接受";
 const nonblankTransportString = Type.String({ minLength: 1 });
@@ -38,7 +37,7 @@ const fixerOutputVariants = Type.Union([
     Type.Object({ status: Type.Literal("refused", { description: "refused — 形状指引，非 schema 闸" }), report: Type.String({ minLength: 1, description: "如实结果报告" }), classResults: Type.Array(classResultSchema, { minItems: 1, description: "各类拒绝结算" }) }),
     Type.Object({ status: Type.Literal("partially_completed", { description: "partially_completed — 形状指引，非 schema 闸" }), report: Type.String({ minLength: 1, description: "如实结果报告" }), classResults: Type.Array(classResultSchema, { minItems: 1, description: "各类完成或拒绝结算" }), testEvidence: Type.Optional(testEvidenceSchema) }),
 ]);
-export const fixerOutputSchema = withInfrastructureFailureDeclaration(openToolObjectFromUnion(fixerOutputVariants));
+export const fixerOutputSchema = openToolObjectFromUnion(fixerOutputVariants);
 export function validateFixerOutput(value, _phase) {
     return value;
 }

package/dist/packaged-role-registry.js

@@ -5,17 +5,108 @@ import { CODER_OUTPUT_TOOL_NAME, FIXER_OUTPUT_TOOL_NAME } from "./package-contra
 import { DOCTOR_OUTPUT_TOOL_NAME } from "./doctor-contracts.js";
 import { MERGER_OUTPUT_TOOL_NAME } from "./merger-contracts.js";
 import { NOTARY_OUTPUT_TOOL_NAME } from "./notary-contracts.js";
-const PACKAGED_ROLE_REGISTRY = [
-  { role: "judge", phases: [null], outputTool: JUDGE_OUTPUT_TOOL_NAME, inputFlag: void 0, phaseFlag: void 0, activationStage: "load-and-install" },
-  { role: "fixer", phases: ["plan", "apply"], outputTool: FIXER_OUTPUT_TOOL_NAME, inputFlag: "ak-fix-packet", phaseFlag: "ak-fixer-phase", activationStage: "load-and-install" },
-  { role: "coder", phases: ["plan", "apply"], outputTool: CODER_OUTPUT_TOOL_NAME, inputFlag: "ak-coder-task", phaseFlag: "ak-coder-phase", activationStage: "load-and-install" },
-  { role: "reviewer", phases: [null], outputTool: REVIEWER_OUTPUT_TOOL_NAME, inputFlag: void 0, phaseFlag: void 0, activationStage: "load-and-install" },
+const NOTARY_SESSION_MATERIALS = [
+  "CLAUDE.md",
+  "souls/notary.md",
+  "souls/gate-output-guide.md"
+];
+const PUBLIC_ROLE_RECORDS = [
+  {
+    role: "judge",
+    phases: [null],
+    outputTool: JUDGE_OUTPUT_TOOL_NAME,
+    inputFlag: void 0,
+    phaseFlag: void 0,
+    activationStage: "load-and-install",
+    sessionMaterials: [
+      "CLAUDE.md",
+      "souls/judge.md",
+      "souls/audit-law.md",
+      "souls/quality-law.md",
+      "souls/judge-output-guide.md"
+    ]
+  },
+  {
+    role: "fixer",
+    phases: ["plan", "apply"],
+    outputTool: FIXER_OUTPUT_TOOL_NAME,
+    inputFlag: "ak-fix-packet",
+    phaseFlag: "ak-fixer-phase",
+    activationStage: "load-and-install",
+    sessionMaterials: [
+      "CLAUDE.md",
+      "souls/fixer.md",
+      "souls/quality-law.md",
+      "souls/fixer-output-guide.md"
+    ]
+  },
+  {
+    role: "coder",
+    phases: ["plan", "apply"],
+    outputTool: CODER_OUTPUT_TOOL_NAME,
+    inputFlag: "ak-coder-task",
+    phaseFlag: "ak-coder-phase",
+    activationStage: "load-and-install",
+    sessionMaterials: [
+      "CLAUDE.md",
+      "souls/coder.md",
+      "souls/quality-law.md",
+      "souls/coder-output-guide.md"
+    ]
+  },
+  {
+    role: "reviewer",
+    phases: [null],
+    outputTool: REVIEWER_OUTPUT_TOOL_NAME,
+    inputFlag: void 0,
+    phaseFlag: void 0,
+    activationStage: "load-and-install",
+    sessionMaterials: [
+      "CLAUDE.md",
+      "souls/reviewer.md",
+      "souls/audit-law.md",
+      "souls/quality-law.md"
+    ]
+  },
   // ak-collector-repo is GitHub owner/repo identity, not a local material path (#438).
-  { role: "collector", phases: [null], outputTool: COLLECTOR_OUTPUT_TOOL, inputFlag: void 0, phaseFlag: void 0, activationStage: "load-and-install" },
-  { role: "doctor", phases: [null], outputTool: DOCTOR_OUTPUT_TOOL_NAME, inputFlag: "ak-doctor-case", phaseFlag: void 0, activationStage: "load-and-install" },
-  { role: "merger", phases: [null], outputTool: MERGER_OUTPUT_TOOL_NAME, inputFlag: "ak-merger-input", phaseFlag: void 0, activationStage: "prepare-git-and-install" },
-  { role: "notary", phases: [null], outputTool: NOTARY_OUTPUT_TOOL_NAME, inputFlag: "ak-notary-source-run", phaseFlag: void 0, activationStage: "load-and-install" }
+  {
+    role: "collector",
+    phases: [null],
+    outputTool: COLLECTOR_OUTPUT_TOOL,
+    inputFlag: void 0,
+    phaseFlag: void 0,
+    activationStage: "load-and-install",
+    sessionMaterials: ["CLAUDE.md", "souls/collector.md"]
+  },
+  {
+    role: "doctor",
+    phases: [null],
+    outputTool: DOCTOR_OUTPUT_TOOL_NAME,
+    inputFlag: "ak-doctor-case",
+    phaseFlag: void 0,
+    activationStage: "load-and-install",
+    sessionMaterials: ["CLAUDE.md", "souls/doctor.md"]
+  },
+  {
+    role: "merger",
+    phases: [null],
+    outputTool: MERGER_OUTPUT_TOOL_NAME,
+    inputFlag: "ak-merger-input",
+    phaseFlag: void 0,
+    activationStage: "prepare-git-and-install",
+    sessionMaterials: ["CLAUDE.md", "souls/merger.md"]
+  },
+  {
+    role: "notary",
+    phases: [null],
+    outputTool: NOTARY_OUTPUT_TOOL_NAME,
+    inputFlag: "ak-notary-source-run",
+    phaseFlag: void 0,
+    activationStage: "load-and-install",
+    sessionMaterials: NOTARY_SESSION_MATERIALS
+  }
 ];
+const PACKAGED_ROLE_REGISTRY = PUBLIC_ROLE_RECORDS.map(({ sessionMaterials: _omit, ...metadata }) => metadata);
 function packagedRoleMetadata(role) {
   return PACKAGED_ROLE_REGISTRY.find((entry) => entry.role === role);
 }
@@ -29,7 +120,9 @@ function packagedRoleOutputTool(role) {
   return packagedRoleMetadata(role)?.outputTool;
 }
 export {
+  NOTARY_SESSION_MATERIALS,
   PACKAGED_ROLE_REGISTRY,
+  PUBLIC_ROLE_RECORDS,
   packagedRoleInputFlag,
   packagedRoleMetadata,
   packagedRoleOutputTool,