@akagilnc/pi-workflow-roles 0.1.3414 → 0.1.3439

package/dist/public-cli/registry.js

@@ -1,124 +1,117 @@
-/**
- * Typed public CLI registry — sole source for discoverable commands, seats,
- * and startup model candidates (ADR 0052 / #105).
- */
-import { PACKAGED_ROLE_REGISTRY, } from "../packaged-role-registry.js";
-/** Package-relative path of the Internal role entrypoint (explicit load only). */
-export const INTERNAL_ROLE_ENTRYPOINT_RELATIVE = "extensions/role-runtime.ts";
-export const PUBLIC_CALLABLE_ROLES = PACKAGED_ROLE_REGISTRY.map((entry) => entry.role);
-export const PUBLIC_CONFIGURABLE_SEATS = [
-    ...PUBLIC_CALLABLE_ROLES,
+import {
+  PACKAGED_ROLE_REGISTRY
+} from "../packaged-role-registry.js";
+const INTERNAL_ROLE_ENTRYPOINT_RELATIVE = "extensions/role-runtime.ts";
+const PUBLIC_CALLABLE_ROLES = PACKAGED_ROLE_REGISTRY.map(
+  (entry) => entry.role
+);
+const PUBLIC_CONFIGURABLE_SEATS = [
+  ...PUBLIC_CALLABLE_ROLES
 ];
-export const PUBLIC_CLI_SUPPORT_COMMANDS = [
-    "roles",
-    "config",
-    "help",
-    "resume",
+const PUBLIC_CLI_SUPPORT_COMMANDS = [
+  "roles",
+  "config",
+  "help",
+  "resume"
 ];
-/**
- * Model-axis projection: incomplete seat row → undefined; else provider/model[/thinking].
- * Single implementation for config, institutional resolution, and display (#620).
- */
-export function seatModelOnly(seat) {
-    if (seat?.provider === undefined || seat.model === undefined)
-        return undefined;
-    return seat.thinking === undefined
-        ? { provider: seat.provider, model: seat.model }
-        : { provider: seat.provider, model: seat.model, thinking: seat.thinking };
+function seatModelOnly(seat) {
+  if (seat?.provider === void 0 || seat.model === void 0) return void 0;
+  return seat.thinking === void 0 ? { provider: seat.provider, model: seat.model } : { provider: seat.provider, model: seat.model, thinking: seat.thinking };
 }
-/**
- * Package startup candidates (#11): Codex family first, then Grok 4.5.
- * Selection among candidates is credential-driven at resolve time.
- */
 const STARTUP_CANDIDATES = {
-    judge: [
-        { provider: "openai-codex", model: "gpt-5.6-sol", thinking: "high" },
-        { provider: "xai", model: "grok-4.5", thinking: "high" },
-    ],
-    countersign: [
-        { provider: "openai-codex", model: "gpt-5.6-sol", thinking: "high" },
-        { provider: "xai", model: "grok-4.5", thinking: "high" },
-    ],
-    "gleaner-left": [
-        { provider: "openai-codex", model: "gpt-5.6-sol", thinking: "medium" },
-        { provider: "xai", model: "grok-4.5", thinking: "high" },
-    ],
-    reviewer: [
-        { provider: "openai-codex", model: "gpt-5.6-sol", thinking: "medium" },
-        { provider: "xai", model: "grok-4.5", thinking: "high" },
-    ],
-    coder: [
-        { provider: "openai-codex", model: "gpt-5.6-luna", thinking: "high" },
-        { provider: "xai", model: "grok-4.5", thinking: "high" },
-    ],
-    fixer: [
-        { provider: "openai-codex", model: "gpt-5.6-luna", thinking: "high" },
-        { provider: "xai", model: "grok-4.5", thinking: "high" },
-    ],
-    collector: [
-        { provider: "openai-codex", model: "gpt-5.6-luna", thinking: "high" },
-        { provider: "xai", model: "grok-4.5", thinking: "high" },
-    ],
-    doctor: [
-        { provider: "openai-codex", model: "gpt-5.6-luna", thinking: "high" },
-        { provider: "xai", model: "grok-4.5", thinking: "high" },
-    ],
-    merger: [
-        { provider: "openai-codex", model: "gpt-5.6-luna", thinking: "high" },
-        { provider: "xai", model: "grok-4.5", thinking: "high" },
-    ],
-    // #620: subordinate officers inherit gatekeeper; no package startup model.
-    notary: [],
-    // #453/#620/#639: gatekeeper callable but no package startup model — caller
-    // configures it or the institutional resolution applies on the province path.
-    gatekeeper: [],
-    inspector: [],
-    navigator: [
-        { provider: "openai-codex", model: "gpt-5.6-luna", thinking: "medium" },
-        { provider: "xai", model: "grok-4.5", thinking: "high" },
-    ],
+  judge: [
+    { provider: "openai-codex", model: "gpt-5.6-sol", thinking: "high" },
+    { provider: "xai", model: "grok-4.5", thinking: "high" }
+  ],
+  countersign: [
+    { provider: "openai-codex", model: "gpt-5.6-sol", thinking: "high" },
+    { provider: "xai", model: "grok-4.5", thinking: "high" }
+  ],
+  "gleaner-left": [
+    { provider: "openai-codex", model: "gpt-5.6-sol", thinking: "medium" },
+    { provider: "xai", model: "grok-4.5", thinking: "high" }
+  ],
+  reviewer: [
+    { provider: "openai-codex", model: "gpt-5.6-sol", thinking: "medium" },
+    { provider: "xai", model: "grok-4.5", thinking: "high" }
+  ],
+  coder: [
+    { provider: "openai-codex", model: "gpt-5.6-luna", thinking: "high" },
+    { provider: "xai", model: "grok-4.5", thinking: "high" }
+  ],
+  fixer: [
+    { provider: "openai-codex", model: "gpt-5.6-luna", thinking: "high" },
+    { provider: "xai", model: "grok-4.5", thinking: "high" }
+  ],
+  collector: [
+    { provider: "openai-codex", model: "gpt-5.6-luna", thinking: "high" },
+    { provider: "xai", model: "grok-4.5", thinking: "high" }
+  ],
+  doctor: [
+    { provider: "openai-codex", model: "gpt-5.6-luna", thinking: "high" },
+    { provider: "xai", model: "grok-4.5", thinking: "high" }
+  ],
+  merger: [
+    { provider: "openai-codex", model: "gpt-5.6-luna", thinking: "high" },
+    { provider: "xai", model: "grok-4.5", thinking: "high" }
+  ],
+  // #620: subordinate officers inherit gatekeeper; no package startup model.
+  notary: [],
+  // #453/#620/#639: gatekeeper callable but no package startup model — caller
+  // configures it or the institutional resolution applies on the province path.
+  gatekeeper: [],
+  inspector: [],
+  navigator: [
+    { provider: "openai-codex", model: "gpt-5.6-luna", thinking: "medium" },
+    { provider: "xai", model: "grok-4.5", thinking: "high" }
+  ]
 };
-export function publicStartupCandidates(seat) {
-    return STARTUP_CANDIDATES[seat];
+function publicStartupCandidates(seat) {
+  return STARTUP_CANDIDATES[seat];
 }
-/** Deterministic public commands — discoverable, never LLM-configurable seats. */
-export const PUBLIC_DETERMINISTIC_COMMANDS = ["analyst"];
-/**
- * Typed help surface. Presentation formats these facts; tests must not assert
- * exact help prose or layout (锚定宪法 / ADR 0016 / #105 AC).
- * analyst is a deterministic analysis command on the public CLI — not an LLM seat.
- */
-export function listHelpCapabilities() {
-    const support = PUBLIC_CLI_SUPPORT_COMMANDS.map((name) => ({
-        kind: "support",
-        name,
-    }));
-    const roles = PACKAGED_ROLE_REGISTRY.map((entry) => {
-        const phases = entry.phases;
-        const defaultPhase = phases.length === 1 && phases[0] === null
-            ? null
-            : phases.includes("apply")
-                ? "apply"
-                : (phases[0] ?? null);
-        return {
-            kind: "role",
-            name: entry.role,
-            phases,
-            defaultPhase,
-        };
-    });
-    const deterministic = PUBLIC_DETERMINISTIC_COMMANDS.map((name) => ({
-        kind: "deterministic",
-        name,
-    }));
-    return [...support, ...roles, ...deterministic];
+const PUBLIC_DETERMINISTIC_COMMANDS = ["analyst"];
+function listHelpCapabilities() {
+  const support = PUBLIC_CLI_SUPPORT_COMMANDS.map((name) => ({
+    kind: "support",
+    name
+  }));
+  const roles = PACKAGED_ROLE_REGISTRY.map((entry) => {
+    const phases = entry.phases;
+    const defaultPhase = phases.length === 1 && phases[0] === null ? null : phases.includes("apply") ? "apply" : phases[0] ?? null;
+    return {
+      kind: "role",
+      name: entry.role,
+      phases,
+      defaultPhase
+    };
+  });
+  const deterministic = PUBLIC_DETERMINISTIC_COMMANDS.map(
+    (name) => ({
+      kind: "deterministic",
+      name
+    })
+  );
+  return [...support, ...roles, ...deterministic];
 }
-export function isPublicCallableRole(value) {
-    return PUBLIC_CALLABLE_ROLES.includes(value);
+function isPublicCallableRole(value) {
+  return PUBLIC_CALLABLE_ROLES.includes(value);
 }
-export function isPublicConfigurableSeat(value) {
-    return PUBLIC_CONFIGURABLE_SEATS.includes(value);
+function isPublicConfigurableSeat(value) {
+  return PUBLIC_CONFIGURABLE_SEATS.includes(value);
 }
-export function isPublicCliSupportCommand(value) {
-    return PUBLIC_CLI_SUPPORT_COMMANDS.includes(value);
+function isPublicCliSupportCommand(value) {
+  return PUBLIC_CLI_SUPPORT_COMMANDS.includes(value);
 }
+export {
+  INTERNAL_ROLE_ENTRYPOINT_RELATIVE,
+  PUBLIC_CALLABLE_ROLES,
+  PUBLIC_CLI_SUPPORT_COMMANDS,
+  PUBLIC_CONFIGURABLE_SEATS,
+  PUBLIC_DETERMINISTIC_COMMANDS,
+  isPublicCallableRole,
+  isPublicCliSupportCommand,
+  isPublicConfigurableSeat,
+  listHelpCapabilities,
+  publicStartupCandidates,
+  seatModelOnly
+};

package/dist/receipt-delivery-policy.js

@@ -1,81 +1,79 @@
-/** Shared accepted-receipt delivery budget for role, auditor, and Navigator sessions (#288). */
-export const RECEIPT_DELIVERY_TURN_LIMIT = 2;
-export const RECEIPT_DELIVERY_PROMPT = "本会话尚无已接受的 typed 回执。";
-export const NO_RECEIPT_LIFECYCLE_ENTRY_TYPE = "ak-no-receipt-lifecycle";
+const RECEIPT_DELIVERY_TURN_LIMIT = 2;
+const RECEIPT_DELIVERY_PROMPT = "\u672C\u4F1A\u8BDD\u5C1A\u65E0\u5DF2\u63A5\u53D7\u7684 typed \u56DE\u6267\u3002";
+const NO_RECEIPT_LIFECYCLE_ENTRY_TYPE = "ak-no-receipt-lifecycle";
 function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
+  return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-/** Read only the facts required by Terminal consumers; persisted extensions are ignored. */
-export function parseNoReceiptLifecycleFacts(input) {
-    if (!isRecord(input)
-        || typeof input.terminalToolCalled !== "boolean"
-        || input.deliveryTurns !== RECEIPT_DELIVERY_TURN_LIMIT
-        || input.sessionCompletion !== "settled-without-accepted-receipt"
-        || input.acceptedReceipt !== false
-        || typeof input.runPointer !== "string" || input.runPointer.trim() === ""
-        || typeof input.attemptPointer !== "string" || input.attemptPointer.trim() === ""
-        || !Array.isArray(input.rejectedReceipts)
-        || !input.rejectedReceipts.every((item) => isRecord(item)
-            && typeof item.reason === "string")) {
-        throw new TypeError("malformed no-receipt lifecycle facts");
-    }
-    return {
-        terminalToolCalled: input.terminalToolCalled,
-        rejectedReceipts: input.rejectedReceipts.map((item) => ({
-            reason: item.reason,
-            diagnosticAvailable: item.reason.trim() !== "",
-        })),
-        deliveryTurns: RECEIPT_DELIVERY_TURN_LIMIT,
-        sessionCompletion: "settled-without-accepted-receipt",
-        runPointer: input.runPointer,
-        attemptPointer: input.attemptPointer,
-        acceptedReceipt: false,
-    };
+function parseNoReceiptLifecycleFacts(input) {
+  if (!isRecord(input) || typeof input.terminalToolCalled !== "boolean" || input.deliveryTurns !== RECEIPT_DELIVERY_TURN_LIMIT || input.sessionCompletion !== "settled-without-accepted-receipt" || input.acceptedReceipt !== false || typeof input.runPointer !== "string" || input.runPointer.trim() === "" || typeof input.attemptPointer !== "string" || input.attemptPointer.trim() === "" || !Array.isArray(input.rejectedReceipts) || !input.rejectedReceipts.every((item) => isRecord(item) && typeof item.reason === "string")) {
+    throw new TypeError("malformed no-receipt lifecycle facts");
+  }
+  return {
+    terminalToolCalled: input.terminalToolCalled,
+    rejectedReceipts: input.rejectedReceipts.map((item) => ({
+      reason: item.reason,
+      diagnosticAvailable: item.reason.trim() !== ""
+    })),
+    deliveryTurns: RECEIPT_DELIVERY_TURN_LIMIT,
+    sessionCompletion: "settled-without-accepted-receipt",
+    runPointer: input.runPointer,
+    attemptPointer: input.attemptPointer,
+    acceptedReceipt: false
+  };
 }
-export function noReceiptLifecycleFacts(input) {
-    if (input.deliveryTurns !== RECEIPT_DELIVERY_TURN_LIMIT) {
-        throw new TypeError("no-receipt lifecycle requires an exhausted delivery budget");
-    }
-    return {
-        terminalToolCalled: input.terminalToolCalled,
-        rejectedReceipts: input.rejectedReceipts.map(({ reason }) => ({
-            reason,
-            diagnosticAvailable: reason.trim() !== "",
-        })),
-        deliveryTurns: RECEIPT_DELIVERY_TURN_LIMIT,
-        sessionCompletion: "settled-without-accepted-receipt",
-        runPointer: input.runPointer,
-        attemptPointer: input.attemptPointer,
-        acceptedReceipt: false,
-    };
+function noReceiptLifecycleFacts(input) {
+  if (input.deliveryTurns !== RECEIPT_DELIVERY_TURN_LIMIT) {
+    throw new TypeError("no-receipt lifecycle requires an exhausted delivery budget");
+  }
+  return {
+    terminalToolCalled: input.terminalToolCalled,
+    rejectedReceipts: input.rejectedReceipts.map(({ reason }) => ({
+      reason,
+      diagnosticAvailable: reason.trim() !== ""
+    })),
+    deliveryTurns: RECEIPT_DELIVERY_TURN_LIMIT,
+    sessionCompletion: "settled-without-accepted-receipt",
+    runPointer: input.runPointer,
+    attemptPointer: input.attemptPointer,
+    acceptedReceipt: false
+  };
 }
-export function createReceiptDeliveryPolicy() {
-    let accepted = false;
-    let terminalToolCalled = false;
-    let deliveryTurns = 0;
-    const rejectedReceipts = [];
-    return {
-        recordAccepted() {
-            accepted = true;
-            terminalToolCalled = true;
-        },
-        /** Infrastructure owns terminality and must never trigger receipt催交. */
-        stopForInfrastructure() { accepted = true; },
-        recordRejected(reason) {
-            terminalToolCalled = true;
-            rejectedReceipts.push({ reason, diagnosticAvailable: reason.trim() !== "" });
-            deliveryTurns = Math.min(RECEIPT_DELIVERY_TURN_LIMIT, deliveryTurns + 1);
-        },
-        recordDeliveryRequest() {
-            deliveryTurns = Math.min(RECEIPT_DELIVERY_TURN_LIMIT, deliveryTurns + 1);
-        },
-        nextAction() {
-            if (accepted)
-                return "accepted";
-            return deliveryTurns < RECEIPT_DELIVERY_TURN_LIMIT ? "request-delivery" : "no-receipt";
-        },
-        facts(binding) {
-            return noReceiptLifecycleFacts({ terminalToolCalled, rejectedReceipts: [...rejectedReceipts], deliveryTurns, ...binding });
-        },
-    };
+function createReceiptDeliveryPolicy() {
+  let accepted = false;
+  let terminalToolCalled = false;
+  let deliveryTurns = 0;
+  const rejectedReceipts = [];
+  return {
+    recordAccepted() {
+      accepted = true;
+      terminalToolCalled = true;
+    },
+    /** Infrastructure owns terminality and must never trigger receipt催交. */
+    stopForInfrastructure() {
+      accepted = true;
+    },
+    recordRejected(reason) {
+      terminalToolCalled = true;
+      rejectedReceipts.push({ reason, diagnosticAvailable: reason.trim() !== "" });
+      deliveryTurns = Math.min(RECEIPT_DELIVERY_TURN_LIMIT, deliveryTurns + 1);
+    },
+    recordDeliveryRequest() {
+      deliveryTurns = Math.min(RECEIPT_DELIVERY_TURN_LIMIT, deliveryTurns + 1);
+    },
+    nextAction() {
+      if (accepted) return "accepted";
+      return deliveryTurns < RECEIPT_DELIVERY_TURN_LIMIT ? "request-delivery" : "no-receipt";
+    },
+    facts(binding) {
+      return noReceiptLifecycleFacts({ terminalToolCalled, rejectedReceipts: [...rejectedReceipts], deliveryTurns, ...binding });
+    }
+  };
 }
+export {
+  NO_RECEIPT_LIFECYCLE_ENTRY_TYPE,
+  RECEIPT_DELIVERY_PROMPT,
+  RECEIPT_DELIVERY_TURN_LIMIT,
+  createReceiptDeliveryPolicy,
+  noReceiptLifecycleFacts,
+  parseNoReceiptLifecycleFacts
+};

package/dist/session-opening-materials.js

@@ -1,61 +1,58 @@
-/**
- * Session opening materials (#443 / #524). Missing files fail as native readFile
- * errors. Main-role materials derive from PUBLIC_ROLE_RECORDS (including
- * gatekeeper and navigator). Province map reuses that public gatekeeper record
- * plus officer material constants (notary shared). Auditor composition stays in
- * loadAuditorSoul; loaders share joinPackageMaterials.
- */
 import { existsSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { INSPECTOR_SESSION_MATERIALS, NOTARY_SESSION_MATERIALS, PUBLIC_ROLE_RECORDS, } from "./packaged-role-registry.js";
-/**
- * Resolve the install package root from this module's location.
- * Works for src/ layout and for bundled artifacts under dist/ (walk up until
- * package.json + souls/ — the shipped material tree).
- */
+import {
+  INSPECTOR_SESSION_MATERIALS,
+  NOTARY_SESSION_MATERIALS,
+  PUBLIC_ROLE_RECORDS
+} from "./packaged-role-registry.js";
 function resolvePackageRootDir(moduleUrl = import.meta.url) {
-    let dir = dirname(fileURLToPath(moduleUrl));
-    for (let i = 0; i < 8; i += 1) {
-        if (existsSync(join(dir, "package.json")) && existsSync(join(dir, "souls"))) {
-            return dir;
-        }
-        const parent = dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
+  let dir = dirname(fileURLToPath(moduleUrl));
+  for (let i = 0; i < 8; i += 1) {
+    if (existsSync(join(dir, "package.json")) && existsSync(join(dir, "souls"))) {
+      return dir;
     }
-    // Legacy fallback: module lived directly under src/.
-    return fileURLToPath(new URL("..", moduleUrl));
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return fileURLToPath(new URL("..", moduleUrl));
 }
 const packageRootUrl = pathToFileURL(resolvePackageRootDir() + "/").href;
-/** Self-locate one package-relative material. Native I/O errors propagate. */
-export async function readPackageMaterial(relativePath) {
-    return readFile(fileURLToPath(new URL(relativePath, packageRootUrl)), "utf8");
+async function readPackageMaterial(relativePath) {
+  return readFile(fileURLToPath(new URL(relativePath, packageRootUrl)), "utf8");
 }
-/** Read materials in order and join with a blank line. */
-export async function joinPackageMaterials(relativePaths) {
-    const chunks = [];
-    for (const relativePath of relativePaths) {
-        chunks.push(await readPackageMaterial(relativePath));
-    }
-    return chunks.join("\n\n");
+async function joinPackageMaterials(relativePaths) {
+  const chunks = [];
+  for (const relativePath of relativePaths) {
+    chunks.push(await readPackageMaterial(relativePath));
+  }
+  return chunks.join("\n\n");
 }
-/** Derived projection: public records (#639 includes navigator/gatekeeper). */
-export const MAIN_ROLE_SESSION_MATERIALS = {
-    ...Object.fromEntries(PUBLIC_ROLE_RECORDS.map((record) => [record.role, record.sessionMaterials])),
+const MAIN_ROLE_SESSION_MATERIALS = {
+  ...Object.fromEntries(
+    PUBLIC_ROLE_RECORDS.map((record) => [record.role, record.sessionMaterials])
+  )
 };
-export function loadMainRoleSessionMaterials(role) {
-    return joinPackageMaterials(MAIN_ROLE_SESSION_MATERIALS[role]);
+function loadMainRoleSessionMaterials(role) {
+  return joinPackageMaterials(MAIN_ROLE_SESSION_MATERIALS[role]);
 }
-/** Gatekeeper province; notary reuses the public notary materials definition. */
-export const GATEKEEPER_SESSION_MATERIALS = {
-    // #639: single authority — the public gatekeeper record owns the province list.
-    gatekeeper: PUBLIC_ROLE_RECORDS.find((entry) => entry.role === "gatekeeper").sessionMaterials,
-    inspector: INSPECTOR_SESSION_MATERIALS,
-    notary: NOTARY_SESSION_MATERIALS,
+const GATEKEEPER_SESSION_MATERIALS = {
+  // #639: single authority — the public gatekeeper record owns the province list.
+  gatekeeper: PUBLIC_ROLE_RECORDS.find((entry) => entry.role === "gatekeeper").sessionMaterials,
+  inspector: INSPECTOR_SESSION_MATERIALS,
+  notary: NOTARY_SESSION_MATERIALS
 };
-export function loadGatekeeperSessionMaterials(role) {
-    return joinPackageMaterials(GATEKEEPER_SESSION_MATERIALS[role]);
+function loadGatekeeperSessionMaterials(role) {
+  return joinPackageMaterials(GATEKEEPER_SESSION_MATERIALS[role]);
 }
+export {
+  GATEKEEPER_SESSION_MATERIALS,
+  MAIN_ROLE_SESSION_MATERIALS,
+  joinPackageMaterials,
+  loadGatekeeperSessionMaterials,
+  loadMainRoleSessionMaterials,
+  readPackageMaterial,
+  resolvePackageRootDir
+};

package/dist/sha256.js

@@ -1,5 +1,7 @@
 import { createHash } from "node:crypto";
-/** Canonical lowercase SHA-256 encoding shared by reviewer identity seams. */
-export function sha256Hex(bytes) {
-    return createHash("sha256").update(bytes).digest("hex");
+function sha256Hex(bytes) {
+  return createHash("sha256").update(bytes).digest("hex");
 }
+export {
+  sha256Hex
+};