@akagilnc/pi-workflow-roles 0.1.3412 → 0.1.3439

package/dist/engine-detour.js

@@ -1,202 +1,167 @@
-/**
- * Engine-generic one-shot subprocess detour (#357 T2 / ADR 0069).
- * Spawn once; no retry, hang surface, or per-engine branch.
- * Material body is LLM data — this module only executes argv the model assembled.
- * Large prompt bodies stage through a seam-owned temp file (never argv) so
- * collectors avoid spawn E2BIG / ENAMETOOLONG (engine-dispatch / #582).
- */
 import { spawn } from "node:child_process";
 import { mkdtemp, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-/** Package-owned detour tool name (settlement whitelist + session principal). */
-export const ENGINE_DETOUR_TOOL_NAME = "ak_engine_detour";
-/** Env presence/name signal injected by public role runs (registration gate only). */
-export const AK_ROLE_ENGINE_ENV = "AK_ROLE_ENGINE";
-/**
- * Argv placeholder replaced by a seam-owned temp prompt file path when
- * `stagedPrompt` is set. Exactly one argv entry must equal this token.
- */
-export const ENGINE_DETOUR_STAGED_PROMPT_TOKEN = "<<ak-engine-staged-prompt>>";
-/**
- * Sole AK_ROLE_ENGINE write seam for public role child env (#391 E2).
- * Delete ambient inheritance first; own-key undefined mask survives process.env re-merge.
- */
-export function applyEngineChildEnv(childEnv, engine) {
-    delete childEnv[AK_ROLE_ENGINE_ENV];
-    if (engine !== undefined && engine.trim() !== "") {
-        childEnv[AK_ROLE_ENGINE_ENV] = engine.trim();
-    }
-    else {
-        childEnv[AK_ROLE_ENGINE_ENV] = undefined;
-    }
+const ENGINE_DETOUR_TOOL_NAME = "ak_engine_detour";
+const AK_ROLE_ENGINE_ENV = "AK_ROLE_ENGINE";
+const ENGINE_DETOUR_STAGED_PROMPT_TOKEN = "<<ak-engine-staged-prompt>>";
+function applyEngineChildEnv(childEnv, engine) {
+  delete childEnv[AK_ROLE_ENGINE_ENV];
+  if (engine !== void 0 && engine.trim() !== "") {
+    childEnv[AK_ROLE_ENGINE_ENV] = engine.trim();
+  } else {
+    childEnv[AK_ROLE_ENGINE_ENV] = void 0;
+  }
 }
-export const ENGINE_DETOUR_EMPTY_STDOUT_DIAGNOSTIC = "劳务引擎 stdout 为空";
+const ENGINE_DETOUR_EMPTY_STDOUT_DIAGNOSTIC = "\u52B3\u52A1\u5F15\u64CE stdout \u4E3A\u7A7A";
 function abortReasonError(signal) {
-    const reason = signal.reason;
-    if (reason instanceof Error)
-        return reason;
-    if (typeof reason === "string" && reason.trim() !== "") {
-        return new Error(reason);
-    }
-    const error = new Error("aborted");
-    error.name = "AbortError";
-    return error;
+  const reason = signal.reason;
+  if (reason instanceof Error) return reason;
+  if (typeof reason === "string" && reason.trim() !== "") {
+    return new Error(reason);
+  }
+  const error = new Error("aborted");
+  error.name = "AbortError";
+  return error;
 }
 function resolveArgvWithStagedPrompt(argv, stagedPath) {
-    let replaced = 0;
-    const out = argv.map((part) => {
-        if (part !== ENGINE_DETOUR_STAGED_PROMPT_TOKEN)
-            return part;
-        replaced += 1;
-        return stagedPath;
-    });
-    if (replaced !== 1) {
-        throw new Error(`劳务引擎 stagedPrompt 需要 argv 中恰好一个 ${ENGINE_DETOUR_STAGED_PROMPT_TOKEN}（实际 ${replaced}）`);
-    }
-    return out;
+  let replaced = 0;
+  const out = argv.map((part) => {
+    if (part !== ENGINE_DETOUR_STAGED_PROMPT_TOKEN) return part;
+    replaced += 1;
+    return stagedPath;
+  });
+  if (replaced !== 1) {
+    throw new Error(
+      `\u52B3\u52A1\u5F15\u64CE stagedPrompt \u9700\u8981 argv \u4E2D\u6070\u597D\u4E00\u4E2A ${ENGINE_DETOUR_STAGED_PROMPT_TOKEN}\uFF08\u5B9E\u9645 ${replaced}\uFF09`
+    );
+  }
+  return out;
 }
 async function spawnEngineDetourOnce(input) {
-    if (input.argv.length === 0) {
-        throw new Error("劳务引擎 argv 不得为空");
+  if (input.argv.length === 0) {
+    throw new Error("\u52B3\u52A1\u5F15\u64CE argv \u4E0D\u5F97\u4E3A\u7A7A");
+  }
+  const command = input.argv[0];
+  const args = input.argv.slice(1);
+  return await new Promise((resolve, reject) => {
+    let settled = false;
+    const signal = input.signal;
+    const child = spawn(command, args, {
+      cwd: input.cwd,
+      env: input.env ?? process.env,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.setEncoding("utf8").on("data", (chunk) => {
+      stdout += chunk;
+    });
+    child.stderr.setEncoding("utf8").on("data", (chunk) => {
+      stderr += chunk;
+    });
+    const fail = (error) => {
+      if (settled) return;
+      settled = true;
+      if (signal !== void 0) {
+        signal.removeEventListener("abort", onAbort);
+      }
+      reject(error instanceof Error ? error : new Error(String(error)));
+    };
+    const succeed = (result) => {
+      if (settled) return;
+      settled = true;
+      if (signal !== void 0) {
+        signal.removeEventListener("abort", onAbort);
+      }
+      resolve(result);
+    };
+    const onAbort = () => {
+      fail(signal !== void 0 ? abortReasonError(signal) : new Error("aborted"));
+      try {
+        child.kill("SIGTERM");
+      } catch {
+      }
+    };
+    if (signal !== void 0) {
+      if (signal.aborted) {
+        onAbort();
+      } else {
+        signal.addEventListener("abort", onAbort, { once: true });
+      }
     }
-    const command = input.argv[0];
-    const args = input.argv.slice(1);
-    return await new Promise((resolve, reject) => {
-        let settled = false;
-        const signal = input.signal;
-        // Own abort→kill explicitly so rejection preserves signal.reason (caller cancel).
-        // Do not pass `signal` to spawn (Node replaces reason).
-        const child = spawn(command, args, {
-            cwd: input.cwd,
-            env: input.env ?? process.env,
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        let stdout = "";
-        let stderr = "";
-        child.stdout.setEncoding("utf8").on("data", (chunk) => {
-            stdout += chunk;
-        });
-        child.stderr.setEncoding("utf8").on("data", (chunk) => {
-            stderr += chunk;
-        });
-        const fail = (error) => {
-            if (settled)
-                return;
-            settled = true;
-            if (signal !== undefined) {
-                signal.removeEventListener("abort", onAbort);
-            }
-            reject(error instanceof Error ? error : new Error(String(error)));
-        };
-        const succeed = (result) => {
-            if (settled)
-                return;
-            settled = true;
-            if (signal !== undefined) {
-                signal.removeEventListener("abort", onAbort);
-            }
-            resolve(result);
-        };
-        const onAbort = () => {
-            // Fail synchronously so caller-cancel soft-settle preserves signal.reason.
-            fail(signal !== undefined ? abortReasonError(signal) : new Error("aborted"));
-            try {
-                child.kill("SIGTERM");
-            }
-            catch {
-                // already exited
-            }
-        };
-        if (signal !== undefined) {
-            if (signal.aborted) {
-                onAbort();
-            }
-            else {
-                signal.addEventListener("abort", onAbort, { once: true });
-            }
-        }
-        child.on("error", (error) => fail(error));
-        child.on("close", (code) => {
-            succeed({ code: code ?? 1, stdout, stderr });
-        });
+    child.on("error", (error) => fail(error));
+    child.on("close", (code) => {
+      succeed({ code: code ?? 1, stdout, stderr });
     });
+  });
 }
-/**
- * Run one engine subprocess. First argv element is the executable (PATH lookup).
- * stdio: ignore stdin, pipe stdout+stderr. No shell, no retry, no hang timer.
- * AbortSignal cancels the child immediately via an explicit listener (reason preserved).
- * Optional stagedPrompt: seam owns temp-file lifecycle for large bodies (ADR 0069).
- */
-export async function runEngineDetourOnce(input) {
-    if (input.stagedPrompt === undefined) {
-        return spawnEngineDetourOnce(input);
-    }
-    const stagingDir = await mkdtemp(join(tmpdir(), "ak-engine-detour-"));
-    const stagedPath = join(stagingDir, "prompt.txt");
-    let result;
-    let runError;
-    try {
-        await writeFile(stagedPath, input.stagedPrompt, "utf8");
-        const argv = resolveArgvWithStagedPrompt(input.argv, stagedPath);
-        result = await spawnEngineDetourOnce({
-            argv,
-            cwd: input.cwd,
-            ...(input.env === undefined ? {} : { env: input.env }),
-            ...(input.signal === undefined ? {} : { signal: input.signal }),
-        });
-    }
-    catch (error) {
-        runError = error;
-    }
-    // Cleanup is seam-owned and fail-closed: never wash rm failure into success
-    // (失败诚实). force only covers already-absent nodes, not permission/IO faults.
-    try {
-        await rm(stagingDir, { recursive: true, force: true });
-    }
-    catch (cleanupError) {
-        if (runError !== undefined) {
-            throw new Error(`劳务引擎 stagedPrompt 清理失败（原运行错误保留为 cause）: ${cleanupError instanceof Error ? cleanupError.message : String(cleanupError)}`, { cause: runError });
-        }
-        throw cleanupError instanceof Error
-            ? cleanupError
-            : new Error(String(cleanupError));
-    }
-    if (runError !== undefined) {
-        throw runError instanceof Error ? runError : new Error(String(runError));
+async function runEngineDetourOnce(input) {
+  if (input.stagedPrompt === void 0) {
+    return spawnEngineDetourOnce(input);
+  }
+  const stagingDir = await mkdtemp(join(tmpdir(), "ak-engine-detour-"));
+  const stagedPath = join(stagingDir, "prompt.txt");
+  let result;
+  let runError;
+  try {
+    await writeFile(stagedPath, input.stagedPrompt, "utf8");
+    const argv = resolveArgvWithStagedPrompt(input.argv, stagedPath);
+    result = await spawnEngineDetourOnce({
+      argv,
+      cwd: input.cwd,
+      ...input.env === void 0 ? {} : { env: input.env },
+      ...input.signal === void 0 ? {} : { signal: input.signal }
+    });
+  } catch (error) {
+    runError = error;
+  }
+  try {
+    await rm(stagingDir, { recursive: true, force: true });
+  } catch (cleanupError) {
+    if (runError !== void 0) {
+      throw new Error(
+        `\u52B3\u52A1\u5F15\u64CE stagedPrompt \u6E05\u7406\u5931\u8D25\uFF08\u539F\u8FD0\u884C\u9519\u8BEF\u4FDD\u7559\u4E3A cause\uFF09: ${cleanupError instanceof Error ? cleanupError.message : String(cleanupError)}`,
+        { cause: runError }
+      );
     }
-    return result;
+    throw cleanupError instanceof Error ? cleanupError : new Error(String(cleanupError));
+  }
+  if (runError !== void 0) {
+    throw runError instanceof Error ? runError : new Error(String(runError));
+  }
+  return result;
 }
-/** Failure predicate: nonzero exit OR stdout trim-empty (including whitespace-only). */
-export function isEngineDetourFailure(result) {
-    return result.code !== 0 || result.stdout.trim() === "";
+function isEngineDetourFailure(result) {
+  return result.code !== 0 || result.stdout.trim() === "";
 }
-/**
- * Diagnostic string for shared settlement / Terminal Error Artifact (#395).
- * Prefer engine stderr 原样; whitespace-only/empty stderr with stdout body must
- * carry the child's last result/error row verbatim (e.g. a 529 API Error row) —
- * never swallow the cause behind an exit code. Fully-empty output → stable fallback.
- */
-export function engineDetourFailureDiagnostic(result) {
-    if (result.stderr.trim().length > 0)
-        return result.stderr;
-    if (result.stdout.trim() === "")
-        return ENGINE_DETOUR_EMPTY_STDOUT_DIAGNOSTIC;
-    const rows = result.stdout.split("\n");
-    let lastRow = "";
-    for (let index = rows.length - 1; index >= 0; index -= 1) {
-        if (rows[index].trim() !== "") {
-            lastRow = rows[index];
-            break;
-        }
+function engineDetourFailureDiagnostic(result) {
+  if (result.stderr.trim().length > 0) return result.stderr;
+  if (result.stdout.trim() === "") return ENGINE_DETOUR_EMPTY_STDOUT_DIAGNOSTIC;
+  const rows = result.stdout.split("\n");
+  let lastRow = "";
+  for (let index = rows.length - 1; index >= 0; index -= 1) {
+    if (rows[index].trim() !== "") {
+      lastRow = rows[index];
+      break;
     }
-    return `劳务引擎以 code ${result.code} 退出：${lastRow}`;
+  }
+  return `\u52B3\u52A1\u5F15\u64CE\u4EE5 code ${result.code} \u9000\u51FA\uFF1A${lastRow}`;
 }
-/** Non-empty trimmed engine name from process.env, else undefined. */
-export function engineNameFromEnv() {
-    const raw = process.env[AK_ROLE_ENGINE_ENV];
-    if (typeof raw !== "string")
-        return undefined;
-    const trimmed = raw.trim();
-    return trimmed === "" ? undefined : trimmed;
+function engineNameFromEnv() {
+  const raw = process.env[AK_ROLE_ENGINE_ENV];
+  if (typeof raw !== "string") return void 0;
+  const trimmed = raw.trim();
+  return trimmed === "" ? void 0 : trimmed;
 }
+export {
+  AK_ROLE_ENGINE_ENV,
+  ENGINE_DETOUR_EMPTY_STDOUT_DIAGNOSTIC,
+  ENGINE_DETOUR_STAGED_PROMPT_TOKEN,
+  ENGINE_DETOUR_TOOL_NAME,
+  applyEngineChildEnv,
+  engineDetourFailureDiagnostic,
+  engineNameFromEnv,
+  isEngineDetourFailure,
+  runEngineDetourOnce
+};

package/dist/evidence-child-executor.js

@@ -9,6 +9,12 @@ import {
 } from "./compliance-transport.js";
 import { auditorRunDirectory } from "./auditor-dossier-tool.js";
 import { sitianReport } from "./sitian-facade.js";
+import {
+  isTicketSeatMemorySeat,
+  readRunTicketNumber,
+  ticketSeatMemorySubject,
+  TICKET_SEAT_MEMORY_KIND
+} from "./ticket-seat-memory.js";
 import { createEngineDetourToolDefinition } from "./engine-detour-tool.js";
 import { engineNameFromEnv } from "./engine-detour.js";
 import {
@@ -362,9 +368,12 @@ async function executeAuditorChild(options) {
     const parentHeader = parentSessionManager?.getHeader?.();
     const parentSessionFile = parentSessionManager?.getSessionFile?.();
     const parentAttemptEntryId = parentSessionManager?.getLeafId?.();
+    const ticketNumber = await readRunTicketNumber(runDirectory);
+    const memorySubject = ticketNumber !== void 0 && isTicketSeatMemorySeat(seat) ? ticketSeatMemorySubject(ticketNumber, seat) : void 0;
     const auditorSessionManager = createRecordSession({
       cwd,
-      kind: "auditor-roles",
+      kind: TICKET_SEAT_MEMORY_KIND,
+      ...memorySubject === void 0 ? {} : { subject: memorySubject },
       ...parentSessionManager === void 0 ? {} : { parent: parentSessionManager }
     });
     const { openPiInstitutionalSession } = await import("./pi/in-process-session.js");

package/dist/exact-utf8.js

@@ -1,12 +1,13 @@
 const decoder = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
-/** Decode only byte sequences whose decoded text reproduces the exact input bytes. */
-export function exactUtf8(bytes, label) {
-    let text;
-    try {
-        text = decoder.decode(bytes);
-    }
-    catch (error) {
-        throw new Error(`${label} is not valid UTF-8`, { cause: error });
-    }
-    return text;
+function exactUtf8(bytes, label) {
+  let text;
+  try {
+    text = decoder.decode(bytes);
+  } catch (error) {
+    throw new Error(`${label} is not valid UTF-8`, { cause: error });
+  }
+  return text;
 }
+export {
+  exactUtf8
+};

package/dist/git-object-id.js

@@ -1,7 +1,12 @@
-export const FULL_GIT_OBJECT_ID_RE = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
-export function isFullGitObjectId(value) {
-    return typeof value === "string" && FULL_GIT_OBJECT_ID_RE.test(value);
+const FULL_GIT_OBJECT_ID_RE = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
+function isFullGitObjectId(value) {
+  return typeof value === "string" && FULL_GIT_OBJECT_ID_RE.test(value);
 }
-export function gitObjectIdWidth(format) {
-    return format === "sha1" ? 40 : 64;
+function gitObjectIdWidth(format) {
+  return format === "sha1" ? 40 : 64;
 }
+export {
+  FULL_GIT_OBJECT_ID_RE,
+  gitObjectIdWidth,
+  isFullGitObjectId
+};

package/dist/gleaner-left-contracts.js

@@ -1,39 +1,37 @@
-/**
- * Public Gleaner-Left (左拾遗) terminating receipt contracts.
- * Lawful explicit release: completed, with empty or nonempty 弹章.
- * No bounce / verdict channel (言不为狱). 原卷保真 (ADR 0055).
- */
-export const GLEANER_LEFT_OUTPUT_TOOL_NAME = "ak_gleaner_left_output";
-export const GLEANER_LEFT_ACCEPTED_TEXT = "左拾遗回执已接受";
-/** Internal transport: comparison-base revision for the unanchored merge-candidate diff. */
-export const GLEANER_LEFT_BASE_FLAG = {
-    name: "ak-gleaner-left-base",
-    definition: {
-        description: "Fixed comparison-base revision for the unanchored merge-candidate diff",
-        type: "string",
-    },
+const GLEANER_LEFT_OUTPUT_TOOL_NAME = "ak_gleaner_left_output";
+const GLEANER_LEFT_ACCEPTED_TEXT = "\u5DE6\u62FE\u9057\u56DE\u6267\u5DF2\u63A5\u53D7";
+const GLEANER_LEFT_BASE_FLAG = {
+  name: "ak-gleaner-left-base",
+  definition: {
+    description: "Fixed comparison-base revision for the unanchored merge-candidate diff",
+    type: "string"
+  }
 };
-export function validateRecordedGleanerLeftOutput(value) {
-    if (value === null || typeof value !== "object" || Array.isArray(value)) {
-        throw new Error("Gleaner-left output has no execution discriminator");
-    }
-    let status;
-    try {
-        status = value.status;
-    }
-    catch {
-        throw new Error("Gleaner-left output has no execution discriminator");
-    }
-    if (status === "completed") {
-        return value;
-    }
+function validateRecordedGleanerLeftOutput(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
     throw new Error("Gleaner-left output has no execution discriminator");
+  }
+  let status;
+  try {
+    status = value.status;
+  } catch {
+    throw new Error("Gleaner-left output has no execution discriminator");
+  }
+  if (status === "completed") {
+    return value;
+  }
+  throw new Error("Gleaner-left output has no execution discriminator");
 }
-/** Machine-facing facts from an accepted 弹章. Findings retained as submitted. */
-export function gleanerLeftDecisiveFacts(output) {
-    const facts = { status: output.status };
-    const findings = output.findings;
-    if (Array.isArray(findings))
-        facts.findings = findings;
-    return facts;
+function gleanerLeftDecisiveFacts(output) {
+  const facts = { status: output.status };
+  const findings = output.findings;
+  if (Array.isArray(findings)) facts.findings = findings;
+  return facts;
 }
+export {
+  GLEANER_LEFT_ACCEPTED_TEXT,
+  GLEANER_LEFT_BASE_FLAG,
+  GLEANER_LEFT_OUTPUT_TOOL_NAME,
+  gleanerLeftDecisiveFacts,
+  validateRecordedGleanerLeftOutput
+};