@akagilnc/pi-workflow-roles 0.1.5845 → 0.1.5853

package/dist/navigator-public-session.js

@@ -1,205 +0,0 @@
-import { basename } from "node:path";
-import { sitianReportSafe } from "./host-session-record.js";
-import {
-  NavigatorUnavailableError,
-  navigatorProviderFailureFromPublicTerminal,
-  navigatorProviderFailureFromError,
-  navigatorUnavailableError,
-  parseNavigatorModelSetting
-} from "./navigator-session-contracts.js";
-import { runDirectoryFromHostContext } from "./host-contracts.js";
-import { parseRunLeaf } from "./role-run-placement.js";
-import { CliUsageError } from "./public-cli/cli-errors.js";
-import { isNavigatorSeat } from "./packaged-role-registry.js";
-async function resolveNavigatorLedgerHome(context) {
-  const { tryHomeFromAkRolesPath } = await import("./activation-ledger-topology.js");
-  const runDirectory = runDirectoryFromHostContext(context);
-  if (runDirectory !== void 0) {
-    const fromRun = tryHomeFromAkRolesPath(runDirectory);
-    if (fromRun !== void 0 && fromRun.length > 0) return fromRun;
-  }
-  const parentFile = context.sessionManager?.getSessionFile?.();
-  if (typeof parentFile === "string" && parentFile.trim() !== "") {
-    const fromParent = tryHomeFromAkRolesPath(parentFile);
-    if (fromParent !== void 0 && fromParent.length > 0) return fromParent;
-  }
-  return void 0;
-}
-function runIdFromNavigatorDirectory(runDirectory) {
-  const parsed = parseRunLeaf(basename(runDirectory));
-  if (parsed === void 0 || parsed.role !== "navigator") return void 0;
-  return parsed.runId;
-}
-async function navigatorHostRunResumable(home, runId, runDirectory) {
-  const { piDurablePrincipalAuthority } = await import("./pi/durable-principal.js");
-  const { loadResumablePublicRole } = await import("./public-cli/run-lifecycle.js");
-  try {
-    const loaded = await loadResumablePublicRole(
-      home,
-      runId,
-      piDurablePrincipalAuthority,
-      runDirectory === void 0 ? void 0 : { runDirectory }
-    );
-    return isNavigatorSeat(loaded.admitted.role);
-  } catch (error) {
-    if (error instanceof CliUsageError) return false;
-    throw error;
-  }
-}
-function createNativeNavigatorSessionFactory(deps) {
-  return async ({ context, tool }) => {
-    const entries = [];
-    let providerFailure;
-    let noReceipt;
-    let routePlaybookReadFailure;
-    let disposed = false;
-    let hostRun;
-    const summon = deps?.summonPublicRole ?? (async (options) => {
-      const { summonPublicRole } = await import("./public-role-summons.js");
-      return summonPublicRole(options);
-    });
-    const parentSessionFile = () => context.sessionManager?.getSessionFile?.();
-    return {
-      prompt: async (text) => {
-        if (disposed) {
-          throw navigatorUnavailableError("session", new Error("Navigator attendance was disposed"));
-        }
-        providerFailure = void 0;
-        noReceipt = void 0;
-        routePlaybookReadFailure = void 0;
-        try {
-          const summonHome = await resolveNavigatorLedgerHome(context);
-          if (disposed) return;
-          const resumeRunId = hostRun?.runId;
-          const baseSummon = {
-            role: "navigator",
-            argv: [text],
-            cwd: context.cwd,
-            // Attendance prepare always asks for structured byStatus (#1160).
-            // Direct `ak-role navigator` never sets this flag.
-            navigatorByStatusPrepare: true,
-            ...summonHome === void 0 ? {} : { home: summonHome },
-            ...context.signal === void 0 ? {} : { signal: context.signal }
-          };
-          const resumable = deps?.hostRunResumable ?? navigatorHostRunResumable;
-          let summoned;
-          if (resumeRunId === void 0 || summonHome === void 0) {
-            if (disposed) return;
-            summoned = await summon(baseSummon);
-          } else {
-            const canResume = await resumable(summonHome, resumeRunId, hostRun?.runDirectory);
-            if (disposed) return;
-            if (canResume) {
-              summoned = await summon({
-                ...baseSummon,
-                resumeRunId,
-                ...hostRun === void 0 ? {} : { resumeRunDirectory: hostRun.runDirectory }
-              });
-            } else {
-              hostRun = void 0;
-              summoned = await summon(baseSummon);
-            }
-          }
-          if (disposed) return;
-          const playbookFailure = summoned.terminal?.navigator?.advisoryDiagnostic;
-          routePlaybookReadFailure = typeof playbookFailure === "string" && playbookFailure.trim() !== "" ? playbookFailure : void 0;
-          const outcome = summoned.terminal?.roleOutcome;
-          if (outcome === void 0) {
-            const detail = summoned.stderr?.trim() || `exit ${summoned.exitCode}`;
-            providerFailure = { source: "transport", cause: "unknown" };
-            throw navigatorUnavailableError(
-              providerFailure.source,
-              new Error(`Navigator public summon produced no terminal (${detail})`),
-              providerFailure.cause
-            );
-          }
-          if (outcome.kind === "failure") {
-            providerFailure = navigatorProviderFailureFromPublicTerminal(outcome);
-            const failedAttempts = outcome.decisiveFacts.failedAttempts;
-            const attemptReasons = Array.isArray(failedAttempts) ? failedAttempts.map((entry, index) => {
-              const fact = entry !== null && typeof entry === "object" ? entry : void 0;
-              return `${typeof fact?.attempt === "number" ? fact.attempt + 1 : index + 1}: ${typeof fact?.diagnostic === "string" ? fact.diagnostic : outcome.diagnostic}`;
-            }) : [];
-            throw navigatorUnavailableError(
-              providerFailure.source,
-              new Error(attemptReasons.length > 0 ? attemptReasons.join("\n") : outcome.diagnostic),
-              providerFailure.cause
-            );
-          }
-          if (outcome.kind === "no_receipt") {
-            noReceipt = outcome;
-            return;
-          }
-          const runDirectory = summoned.runDirectory ?? (typeof summoned.admitted?.runDirectory === "string" ? summoned.admitted.runDirectory : void 0);
-          if (typeof runDirectory === "string" && runDirectory.trim() !== "") {
-            const nextRunId = runIdFromNavigatorDirectory(runDirectory);
-            if (nextRunId !== void 0) {
-              hostRun = { runId: nextRunId, runDirectory };
-            }
-          }
-          if (outcome.kind !== "accepted") {
-            return;
-          }
-          const {
-            byStatusToPlainObject,
-            mergePreparedAdvice,
-            preparedAdviceFromUnknown
-          } = await import("./package-contracts/navigator-output.js");
-          let prepared = void 0;
-          for (const payload of outcome.payloads ?? []) {
-            prepared = mergePreparedAdvice(prepared, preparedAdviceFromUnknown(payload));
-          }
-          if (prepared === void 0) return;
-          if (disposed) return;
-          await tool.execute(
-            "navigator-public-prepare",
-            {
-              ...prepared.prose === void 0 ? {} : { prose: prepared.prose },
-              ...prepared.byStatus.size === 0 ? {} : { byStatus: byStatusToPlainObject(prepared.byStatus) }
-            },
-            void 0,
-            void 0,
-            context
-          );
-        } catch (error) {
-          if (disposed) return;
-          if (error instanceof NavigatorUnavailableError) throw error;
-          const fact = navigatorProviderFailureFromError(error);
-          providerFailure = fact ?? { source: "transport", cause: "unknown" };
-          throw navigatorUnavailableError(providerFailure.source, error, providerFailure.cause);
-        }
-      },
-      providerFailure: () => providerFailure,
-      noReceipt: () => noReceipt,
-      routePlaybookReadFailure: () => routePlaybookReadFailure,
-      appendEntry: (customType, data) => {
-        entries.push({ type: "custom", customType, data });
-        const parent = parentSessionFile();
-        sitianReportSafe({
-          level: "event",
-          kind: "attendance",
-          cwd: context.cwd,
-          ...parent === void 0 ? {} : { sessionParent: parent },
-          payload: { customType, data },
-          source: "navigator-public-session"
-        });
-      },
-      entries: () => entries,
-      setModel: async (next) => {
-        try {
-          parseNavigatorModelSetting(next);
-        } catch (error) {
-          throw navigatorUnavailableError("model", error);
-        }
-      },
-      dispose: async () => {
-        disposed = true;
-      }
-    };
-  };
-}
-export {
-  createNativeNavigatorSessionFactory,
-  navigatorHostRunResumable,
-  runIdFromNavigatorDirectory
-};

package/dist/navigator-role.js

@@ -1,6 +0,0 @@
-import { roleSubmissionDeclaration } from "./role-submission-declarations.js";
-/**
- * 决定工具规格。生命周期装配归注册信封 owner——src/role-runtime.ts（ADR 0018）。
- * #959: navigator speaks free-form prose; tool is a lifecycle vehicle only.
- */
-export const NAVIGATOR_TOOL_SPEC = roleSubmissionDeclaration("navigator");

package/dist/navigator-session-contracts.js

@@ -1,227 +0,0 @@
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import { dirname, join } from "node:path";
-import { Type } from "typebox";
-import { Value } from "typebox/value";
-import { isRecord, errorText, isEnoent } from "./unknown-value.js";
-const NAVIGATOR_PREPARE_TOOL_NAME = "ak_navigator_prepare";
-const NAVIGATOR_UNAVAILABLE_KEYS = /* @__PURE__ */ new Set([
-  "context",
-  "session",
-  "model",
-  "thinking",
-  "auth",
-  "quota",
-  "transport",
-  "unknown"
-]);
-function navigatorUnavailableKey(value) {
-  return typeof value === "string" && NAVIGATOR_UNAVAILABLE_KEYS.has(value) ? value : void 0;
-}
-class NavigatorUnavailableError extends Error {
-  unavailableSource;
-  unavailableCause;
-  originalCause;
-  constructor(source, message, cause = source, originalCause) {
-    super(message);
-    this.name = "NavigatorUnavailableError";
-    this.unavailableSource = source;
-    this.unavailableCause = cause;
-    this.originalCause = originalCause;
-  }
-}
-function navigatorUnavailableError(source, error, cause = source) {
-  const message = errorText(error);
-  return error instanceof NavigatorUnavailableError ? error : new NavigatorUnavailableError(source, message, cause, error);
-}
-function navigatorProviderFailureFromStatus(status) {
-  if (status === 401 || status === 403) return { source: "auth", cause: "auth" };
-  if (status === 429) return { source: "quota", cause: "quota" };
-  return void 0;
-}
-function navigatorProviderFailureFromCode(code) {
-  if (typeof code === "number") return navigatorProviderFailureFromStatus(code);
-  if (typeof code !== "string") return void 0;
-  if (code === "unauthorized" || code === "authentication_failed") return { source: "auth", cause: "auth" };
-  if (code === "insufficient_quota" || code === "quota_exhausted") return { source: "quota", cause: "quota" };
-  if (code === "transport_error") return { source: "transport", cause: "transport" };
-  return void 0;
-}
-function navigatorProviderFailureFromError(error) {
-  let cursor = error;
-  const seen = /* @__PURE__ */ new Set();
-  while (typeof cursor === "object" && cursor !== null && !seen.has(cursor)) {
-    seen.add(cursor);
-    if (cursor instanceof NavigatorUnavailableError) {
-      return { source: cursor.unavailableSource, cause: cursor.unavailableCause };
-    }
-    if (!isRecord(cursor)) {
-      cursor = cursor instanceof Error ? cursor.cause : void 0;
-      continue;
-    }
-    const fromReason = navigatorUnavailableKey(cursor.reason);
-    if (fromReason !== void 0) return { source: fromReason, cause: fromReason };
-    const statusCode = typeof cursor.statusCode === "number" ? cursor.statusCode : typeof cursor.status === "number" ? cursor.status : typeof cursor.httpStatus === "number" ? cursor.httpStatus : void 0;
-    const fromStatus = navigatorProviderFailureFromStatus(statusCode);
-    if (fromStatus !== void 0) return fromStatus;
-    const fromCode = navigatorProviderFailureFromCode(cursor.code);
-    if (fromCode !== void 0) return fromCode;
-    cursor = cursor.cause;
-  }
-  return void 0;
-}
-function navigatorProviderFailureFromDiagnostics(diagnostics) {
-  if (!Array.isArray(diagnostics)) return void 0;
-  for (const diagnostic of diagnostics) {
-    if (!isRecord(diagnostic)) continue;
-    if (diagnostic.type === "provider_transport_failure") return { source: "transport", cause: "transport" };
-    if (isRecord(diagnostic.error)) {
-      const fromCode = navigatorProviderFailureFromCode(diagnostic.error.code);
-      if (fromCode !== void 0) return fromCode;
-    }
-    if (isRecord(diagnostic.details)) {
-      const status = typeof diagnostic.details.status === "number" ? diagnostic.details.status : typeof diagnostic.details.statusCode === "number" ? diagnostic.details.statusCode : void 0;
-      const fromStatus = navigatorProviderFailureFromStatus(status);
-      if (fromStatus !== void 0) return fromStatus;
-      const fromCode = navigatorProviderFailureFromCode(diagnostic.details.code);
-      if (fromCode !== void 0) return fromCode;
-    }
-  }
-  return void 0;
-}
-function navigatorProviderFailureFromPublicTerminal(outcome) {
-  const facts = outcome.decisiveFacts;
-  const secondary = typeof facts.secondaryEvidence === "object" && facts.secondaryEvidence !== null ? facts.secondaryEvidence : void 0;
-  const httpStatus = typeof secondary?.httpStatus === "number" ? secondary.httpStatus : typeof facts.httpStatus === "number" ? facts.httpStatus : typeof facts.errorCode === "number" ? facts.errorCode : void 0;
-  const fromStatus = navigatorProviderFailureFromStatus(httpStatus);
-  if (fromStatus !== void 0) return fromStatus;
-  const diagnostics = secondary?.diagnostics ?? facts.diagnostics;
-  const fromDiagnostics = navigatorProviderFailureFromDiagnostics(diagnostics);
-  if (fromDiagnostics !== void 0) return fromDiagnostics;
-  const fromCode = navigatorProviderFailureFromError({
-    code: secondary?.code ?? facts.errorCode
-  });
-  if (fromCode !== void 0) return fromCode;
-  if (outcome.cause === "provider") return { source: "transport", cause: "unknown" };
-  const typed = navigatorUnavailableKey(outcome.cause);
-  if (typed !== void 0) return { source: typed, cause: typed };
-  return { source: "unknown", cause: "unknown" };
-}
-const navigatorProviderFailureSchema = Type.Object({
-  source: Type.Union([
-    Type.Literal("context"),
-    Type.Literal("session"),
-    Type.Literal("model"),
-    Type.Literal("thinking"),
-    Type.Literal("auth"),
-    Type.Literal("quota"),
-    Type.Literal("transport"),
-    Type.Literal("unknown")
-  ]),
-  cause: Type.Union([
-    Type.Literal("context"),
-    Type.Literal("session"),
-    Type.Literal("model"),
-    Type.Literal("thinking"),
-    Type.Literal("auth"),
-    Type.Literal("quota"),
-    Type.Literal("transport"),
-    Type.Literal("unknown")
-  ])
-}, { additionalProperties: false });
-function navigatorProviderFailure(message, source, cause = source) {
-  const fact = { source, cause };
-  if (!Value.Check(navigatorProviderFailureSchema, fact)) throw new TypeError("Navigator provider failure fact is not typed");
-  return Object.assign(message, { navigatorFailure: fact });
-}
-function navigatorModelSettingPath() {
-  return join(process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent"), "navigator-model.json");
-}
-async function readNavigatorModelSetting(path = navigatorModelSettingPath()) {
-  try {
-    const raw = JSON.parse(await readFile(path, "utf8"));
-    if (!isRecord(raw) || typeof raw.model !== "string" || raw.model.trim() === "") {
-      throw new Error("Navigator model setting is malformed");
-    }
-    return raw.model;
-  } catch (error) {
-    if (isEnoent(error)) {
-      throw new Error("Navigator model setting is missing");
-    }
-    throw error;
-  }
-}
-async function writeNavigatorModelSetting(model, path = navigatorModelSettingPath()) {
-  const normalized = model.trim();
-  parseNavigatorModelSetting(normalized);
-  await mkdir(dirname(path), { recursive: true });
-  await writeFile(path, `${JSON.stringify({ model: normalized })}
-`, "utf8");
-}
-function parseNavigatorModelSetting(value) {
-  const slash = value.indexOf("/");
-  if (slash <= 0 || slash === value.length - 1) {
-    throw new Error("Navigator model setting must be provider/model[:thinking]");
-  }
-  const provider = value.slice(0, slash);
-  const modelWithThinking = value.slice(slash + 1);
-  const colon = modelWithThinking.lastIndexOf(":");
-  const suffix = colon < 0 ? void 0 : modelWithThinking.slice(colon + 1);
-  const model = colon < 0 ? modelWithThinking : modelWithThinking.slice(0, colon);
-  if (model === "") throw new Error("Navigator model setting must include a model");
-  if (suffix !== void 0 && suffix.trim() === "") {
-    throw new Error("Navigator model setting thinking suffix must be non-blank");
-  }
-  return {
-    provider,
-    model,
-    ...suffix === void 0 ? {} : { thinkingLevel: suffix }
-  };
-}
-async function resolveNavigatorSeatSelection(context) {
-  try {
-    const { loadPublicCliConfig } = await import("./public-cli/config.js");
-    const { seatModelOnly } = await import("./public-cli/registry.js");
-    const { packageMachineHome } = await import("./activation-ledger-topology.js");
-    const homeCandidate = context.home;
-    const envHome = process.env.HOME;
-    const home = typeof homeCandidate === "string" ? homeCandidate : typeof envHome === "string" && envHome.trim() !== "" ? envHome : packageMachineHome();
-    const config = await loadPublicCliConfig(home);
-    const modelOnly = seatModelOnly(config.seats.navigator);
-    if (modelOnly === void 0) {
-      const { missingResolvedSeatModelMessage } = await import("./public-cli/config.js");
-      throw navigatorUnavailableError(
-        "model",
-        new Error(missingResolvedSeatModelMessage("navigator"))
-      );
-    }
-    const thinkingRaw = modelOnly.thinking;
-    const configuredLabel = thinkingRaw === void 0 ? `${modelOnly.provider}/${modelOnly.model}` : `${modelOnly.provider}/${modelOnly.model}:${thinkingRaw}`;
-    return {
-      selection: {
-        provider: modelOnly.provider,
-        model: modelOnly.model,
-        ...thinkingRaw === void 0 ? {} : { thinking: thinkingRaw }
-      },
-      configuredLabel,
-      ...thinkingRaw === void 0 ? {} : { thinkingLevel: thinkingRaw }
-    };
-  } catch (error) {
-    throw navigatorUnavailableError("model", error);
-  }
-}
-export {
-  NAVIGATOR_PREPARE_TOOL_NAME,
-  NavigatorUnavailableError,
-  navigatorModelSettingPath,
-  navigatorProviderFailure,
-  navigatorProviderFailureFromDiagnostics,
-  navigatorProviderFailureFromError,
-  navigatorProviderFailureFromPublicTerminal,
-  navigatorProviderFailureFromStatus,
-  navigatorUnavailableError,
-  parseNavigatorModelSetting,
-  readNavigatorModelSetting,
-  resolveNavigatorSeatSelection,
-  writeNavigatorModelSetting
-};

package/dist/navigator-work-context.js

@@ -1,72 +0,0 @@
-/**
- * Host-neutral Navigator work-context loader (#590 / #1187).
- * Auto prepare is identity-only: subjectKey + provenance. No parent dispatch,
- * role-input bytes, or work-root authority files are loaded as materials.
- * Flag/input resolution is supplied by the host; no ExtensionAPI dependency.
- */
-import { resolve } from "node:path";
-import { sessionDirectoryOf } from "./role-run-placement.js";
-import { runDirectoryFromHostContext } from "./host-contracts.js";
-import { navigatorSubjectKeyForInput, navigatorUnavailableError, subjectPath, } from "./navigator-attendance.js";
-import { packagedNavigatorSubject, packagedRoleInputFlag } from "./packaged-role-registry.js";
-import { loadAdmittedJudgeRequest } from "./public-cli/invocation.js";
-function navigatorInputReference(getFlag, role) {
-    if (getFlag === undefined)
-        return undefined;
-    const name = packagedRoleInputFlag(role);
-    const value = name === undefined ? undefined : getFlag(name);
-    return typeof value === "string" && value !== "" ? resolve(value) : undefined;
-}
-/**
- * Resolve typed Navigator work context from host flags and/or the public admitted request.
- * Returns identity (subjectKey + provenance) only — auto prepare does not consume materials.
- */
-export async function loadNavigatorWorkContext(options) {
-    const reference = navigatorInputReference(options.getFlag, options.role);
-    const subjectMode = packagedNavigatorSubject(options.role);
-    const subjectRoot = subjectPath(reference ?? options.context.sessionManager.getSessionDir(), options.context.cwd);
-    const subjectKey = reference === undefined
-        ? subjectRoot
-        : navigatorSubjectKeyForInput(subjectRoot, reference, options.context.cwd);
-    // Public ak-role run: admitted request decides empty vs concrete identity.
-    const publicRunDir = runDirectoryFromHostContext(options.context);
-    const currentSessionDir = options.context.sessionManager.getSessionDir();
-    const isBoundPublicRun = publicRunDir !== undefined
-        && resolve(currentSessionDir) === resolve(sessionDirectoryOf(publicRunDir));
-    if (subjectMode === "public-instruction" && isBoundPublicRun) {
-        // Control-plane read faults keep their real cause inside context-error (#1187 F2).
-        // Only true absence / wrong-shape is undefined → generic missing message.
-        let admitted;
-        try {
-            admitted = await loadAdmittedJudgeRequest(publicRunDir);
-        }
-        catch (error) {
-            throw navigatorUnavailableError("context", error);
-        }
-        if (admitted === undefined) {
-            throw navigatorUnavailableError("context", new Error("public Judge admitted request was missing or malformed"));
-        }
-        if (!admitted.instructionEmpty && admitted.instruction.trim() !== "") {
-            // #1187: non-empty public admission starts parallel prepare by identity.
-            // Parent instruction remains the parent role's own dispatch; auto navigator
-            // does not receive that prose (or a duplicate authority copy) as material.
-            return {
-                subjectKey: subjectRoot,
-                subjectProvenance: "role_input",
-            };
-        }
-        return {
-            subjectKey: subjectRoot,
-            subjectProvenance: "placeholder",
-        };
-    }
-    // Concrete role-input path (file/case/source-run flag) is identity enough to start prepare.
-    // Navigator reads ticket and station records itself when needed — no material copy here.
-    if (reference !== undefined) {
-        return { subjectKey, subjectProvenance: "role_input" };
-    }
-    return {
-        subjectKey: subjectRoot,
-        subjectProvenance: "placeholder",
-    };
-}

package/resources/navigator-route-playbook.md

@@ -1,33 +0,0 @@
-## 备答
-
-父衙门一开始即并行准备。有票时读票卷宗里实际发生的角色运行，必要时看票面；不读过去的建议。按主衙门可能的结局 status 预写建议，经 `byStatus` 提交（键为 status 字面量，值为建议正文）。无状态分叉时可用单条 `prose`。
-
-## 常用交付线
-
-立票
-  ↓
-给事中（票庭审读）
-  ↓
-将作监（开工）
-  ↓
-御史台
-  ↓
-大理寺
-  ├─ 有问题（通常） → 修内司 → 大理寺（修内司收卷不经御史台，直回大理寺）
-  ├─ 需要再审（大理寺点名） → 御史台 → 大理寺
-  └─ 收敛           → 调用者合并、关票
-
-## 线上审查材料
-
-collector（收齐 current-head 材料）
-  ↓
-大理寺（裁决 findings）
-  ├─ 有问题 → 修内司 → 大理寺
-  └─ 收敛   → 调用者合并、关票
-
-## 未完交棒（unfinished）
-
-修内司 / 将作监 apply 以 unfinished 交棒时，工作仍未结清：
-  → 续修（通常仍是同一 worker 的 apply），不要送大理寺
-
-refused / partially_completed 是已结清结算，送大理寺审计仍合法。