@akagilnc/pi-workflow-roles 0.1.3412 → 0.1.3439

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

@@ -1,120 +1,104 @@
-/** Package-owned Reviewer intent and runtime-receipt leaves — no role registration surface. */
-export const REVIEWER_OUTPUT_TOOL_NAME = "ak_reviewer_output";
-export const REVIEWER_ACCEPTED_TEXT = "御史台回执已接受";
+const REVIEWER_OUTPUT_TOOL_NAME = "ak_reviewer_output";
+const REVIEWER_ACCEPTED_TEXT = "\u5FA1\u53F2\u53F0\u56DE\u6267\u5DF2\u63A5\u53D7";
 function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
+  return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function read(value, key) {
-    if (!isRecord(value))
-        return undefined;
-    try {
-        return value[key];
-    }
-    catch {
-        return undefined;
-    }
+  if (!isRecord(value)) return void 0;
+  try {
+    return value[key];
+  } catch {
+    return void 0;
+  }
 }
-/** Canonical per-axis string slots only — no shape reject, no prose parse (ADR 0057). */
 function readAmendments(output) {
-    const amendments = read(output, "amendments");
-    if (!isRecord(amendments))
-        return undefined;
-    const slots = {};
-    for (const axis of ["standards", "spec"]) {
-        const value = read(amendments, axis);
-        if (typeof value === "string")
-            slots[axis] = value;
-    }
-    if (slots.standards === undefined && slots.spec === undefined)
-        return undefined;
-    return Object.freeze(slots);
+  const amendments = read(output, "amendments");
+  if (!isRecord(amendments)) return void 0;
+  const slots = {};
+  for (const axis of ["standards", "spec"]) {
+    const value = read(amendments, axis);
+    if (typeof value === "string") slots[axis] = value;
+  }
+  if (slots.standards === void 0 && slots.spec === void 0) return void 0;
+  return Object.freeze(slots);
 }
-export function validateReviewerIntent(output) {
-    const status = read(output, "status");
-    const amendments = readAmendments(output);
-    if (status === "completed") {
-        return amendments === undefined ? { status } : { status, amendments };
-    }
-    if (status === "refused") {
-        return amendments === undefined
-            ? { status, diagnostic: read(output, "diagnostic") }
-            : { status, diagnostic: read(output, "diagnostic"), amendments };
-    }
-    throw new Error("Reviewer output has no recognized execution intent");
+function validateReviewerIntent(output) {
+  const status = read(output, "status");
+  const amendments = readAmendments(output);
+  if (status === "completed") {
+    return amendments === void 0 ? { status } : { status, amendments };
+  }
+  if (status === "refused") {
+    return amendments === void 0 ? { status, diagnostic: read(output, "diagnostic") } : { status, diagnostic: read(output, "diagnostic"), amendments };
+  }
+  throw new Error("Reviewer output has no recognized execution intent");
 }
-/** Validate runtime-owned facts at their real identity seams (target pins + plain text). */
-export function validateRuntimeReviewerReceipt(output) {
-    const status = read(output, "status");
-    const acceptedBatch = read(output, "acceptedBatch");
-    const identities = read(output, "identities");
-    const construction = read(identities, "construction");
-    const target = read(identities, "target");
-    const reports = read(output, "reports");
-    const outcomes = read(output, "outcomes");
-    const legs = read(acceptedBatch, "legs");
-    // A recognizable accepted batch must remain bound to its exact target pin.
-    if (acceptedBatch !== undefined || construction !== undefined || target !== undefined) {
-        if (!isRecord(acceptedBatch) || !isRecord(construction) || !isRecord(target) || !Array.isArray(legs))
-            throw new Error("Incomplete Reviewer accepted-batch identity");
-        const objectFormat = read(target, "objectFormat");
-        const objectId = (value) => typeof value === "string" && new RegExp(objectFormat === "sha1" ? "^[0-9a-f]{40}$" : "^[0-9a-f]{64}$").test(value);
-        const refs = read(target, "refs");
-        const skillText = read(read(identities, "canonicalSkill"), "text");
-        if (typeof skillText !== "string" ||
-            read(construction, "recipe") !== "reviewer-common-bundle-v1" ||
-            (objectFormat !== "sha1" && objectFormat !== "sha256") || !objectId(read(target, "targetHead")) || !isRecord(refs) ||
-            Object.values(refs).some((ref) => !isRecord(ref) || !objectId(read(ref, "objectId")) || (read(ref, "peeledCommitId") !== null && !objectId(read(ref, "peeledCommitId")))))
-            throw new Error("Invalid Reviewer construction or target identity");
-        const expectedAxes = legs.map((leg) => read(leg, "axis"));
-        if (expectedAxes[0] !== "standards" || (expectedAxes.length === 2 && expectedAxes[1] !== "spec") || expectedAxes.length < 1 || expectedAxes.length > 2)
-            throw new Error("Invalid Reviewer accepted-leg projection");
-        if (!isRecord(outcomes) || !isRecord(reports))
-            throw new Error("Accepted Reviewer batch lacks outcomes or reports");
-        const outcomeAxes = Object.keys(outcomes).filter(axis => axis === "standards" || axis === "spec");
-        if (outcomeAxes.length !== expectedAxes.length || outcomeAxes.some((axis, index) => axis !== expectedAxes[index]))
-            throw new Error("Reviewer outcomes must exactly cover accepted legs in canonical order");
-        for (const [index, axisValue] of expectedAxes.entries()) {
-            const axis = axisValue;
-            const outcome = read(outcomes, axis);
-            if (!isRecord(outcome))
-                throw new Error("Reviewer accepted leg lacks outcome");
-            const expectedPrompt = read(read(legs[index], "prompt"), "text");
-            const actualPrompt = read(read(outcome, "prompt"), "text");
-            if (expectedPrompt !== actualPrompt)
-                throw new Error("Reviewer outcome prompt disagrees with accepted leg");
-            const status = read(outcome, "status");
-            const report = read(reports, axis);
-            if (status === "successful" && report === undefined)
-                throw new Error("Successful Reviewer outcome lacks report");
-            if (status === "failed" && report !== undefined)
-                throw new Error("Failed Reviewer outcome cannot bind a report");
-        }
-        // One read inside the existing accepted-leg consistency cycle — not a second validator.
-        // launched ⇔ Standards+Spec; skipped-missing ⇔ Standards only.
-        const specDisposition = read(output, "specDisposition");
-        if (specDisposition === "launched") {
-            if (expectedAxes.length !== 2 || expectedAxes[0] !== "standards" || expectedAxes[1] !== "spec") {
-                throw new Error("Reviewer specDisposition launched requires Standards+Spec accepted legs");
-            }
-        }
-        else if (specDisposition === "skipped-missing") {
-            if (expectedAxes.length !== 1 || expectedAxes[0] !== "standards") {
-                throw new Error("Reviewer specDisposition skipped-missing requires Standards-only accepted legs");
-            }
-        }
-        else if (specDisposition !== undefined) {
-            throw new Error("Invalid Reviewer specDisposition");
-        }
+function validateRuntimeReviewerReceipt(output) {
+  const status = read(output, "status");
+  const acceptedBatch = read(output, "acceptedBatch");
+  const identities = read(output, "identities");
+  const construction = read(identities, "construction");
+  const target = read(identities, "target");
+  const reports = read(output, "reports");
+  const outcomes = read(output, "outcomes");
+  const legs = read(acceptedBatch, "legs");
+  if (acceptedBatch !== void 0 || construction !== void 0 || target !== void 0) {
+    if (!isRecord(acceptedBatch) || !isRecord(construction) || !isRecord(target) || !Array.isArray(legs))
+      throw new Error("Incomplete Reviewer accepted-batch identity");
+    const objectFormat = read(target, "objectFormat");
+    const objectId = (value) => typeof value === "string" && new RegExp(objectFormat === "sha1" ? "^[0-9a-f]{40}$" : "^[0-9a-f]{64}$").test(value);
+    const refs = read(target, "refs");
+    const skillText = read(read(identities, "canonicalSkill"), "text");
+    if (typeof skillText !== "string" || read(construction, "recipe") !== "reviewer-common-bundle-v1" || objectFormat !== "sha1" && objectFormat !== "sha256" || !objectId(read(target, "targetHead")) || !isRecord(refs) || Object.values(refs).some((ref) => !isRecord(ref) || !objectId(read(ref, "objectId")) || read(ref, "peeledCommitId") !== null && !objectId(read(ref, "peeledCommitId"))))
+      throw new Error("Invalid Reviewer construction or target identity");
+    const expectedAxes = legs.map((leg) => read(leg, "axis"));
+    if (expectedAxes[0] !== "standards" || expectedAxes.length === 2 && expectedAxes[1] !== "spec" || expectedAxes.length < 1 || expectedAxes.length > 2)
+      throw new Error("Invalid Reviewer accepted-leg projection");
+    if (!isRecord(outcomes) || !isRecord(reports)) throw new Error("Accepted Reviewer batch lacks outcomes or reports");
+    const outcomeAxes = Object.keys(outcomes).filter((axis) => axis === "standards" || axis === "spec");
+    if (outcomeAxes.length !== expectedAxes.length || outcomeAxes.some((axis, index) => axis !== expectedAxes[index]))
+      throw new Error("Reviewer outcomes must exactly cover accepted legs in canonical order");
+    for (const [index, axisValue] of expectedAxes.entries()) {
+      const axis = axisValue;
+      const outcome = read(outcomes, axis);
+      if (!isRecord(outcome)) throw new Error("Reviewer accepted leg lacks outcome");
+      const expectedPrompt = read(read(legs[index], "prompt"), "text");
+      const actualPrompt = read(read(outcome, "prompt"), "text");
+      if (expectedPrompt !== actualPrompt) throw new Error("Reviewer outcome prompt disagrees with accepted leg");
+      const status2 = read(outcome, "status");
+      const report = read(reports, axis);
+      if (status2 === "successful" && report === void 0)
+        throw new Error("Successful Reviewer outcome lacks report");
+      if (status2 === "failed" && report !== void 0) throw new Error("Failed Reviewer outcome cannot bind a report");
     }
-    return output;
-}
-/** Project thin submitted intent onto runtime enrichment without comparing runtime-owned fields. */
-export function projectReviewerIntentToReceipt(intentValue, receiptValue) {
-    const intent = validateReviewerIntent(intentValue);
-    const receipt = validateRuntimeReviewerReceipt(receiptValue);
-    const receiptStatus = String(receipt.status);
-    if (receiptStatus !== intent.status || (intent.status === "completed" ? receipt.diagnostic !== undefined : receipt.diagnostic !== intent.diagnostic)) {
-        throw new Error("Reviewer intent and runtime receipt disagree");
+    const specDisposition = read(output, "specDisposition");
+    if (specDisposition === "launched") {
+      if (expectedAxes.length !== 2 || expectedAxes[0] !== "standards" || expectedAxes[1] !== "spec") {
+        throw new Error("Reviewer specDisposition launched requires Standards+Spec accepted legs");
+      }
+    } else if (specDisposition === "skipped-missing") {
+      if (expectedAxes.length !== 1 || expectedAxes[0] !== "standards") {
+        throw new Error("Reviewer specDisposition skipped-missing requires Standards-only accepted legs");
+      }
+    } else if (specDisposition !== void 0) {
+      throw new Error("Invalid Reviewer specDisposition");
     }
-    return receipt;
+  }
+  return output;
+}
+function projectReviewerIntentToReceipt(intentValue, receiptValue) {
+  const intent = validateReviewerIntent(intentValue);
+  const receipt = validateRuntimeReviewerReceipt(receiptValue);
+  const receiptStatus = String(receipt.status);
+  if (receiptStatus !== intent.status || (intent.status === "completed" ? receipt.diagnostic !== void 0 : receipt.diagnostic !== intent.diagnostic)) {
+    throw new Error("Reviewer intent and runtime receipt disagree");
+  }
+  return receipt;
 }
+export {
+  REVIEWER_ACCEPTED_TEXT,
+  REVIEWER_OUTPUT_TOOL_NAME,
+  projectReviewerIntentToReceipt,
+  validateReviewerIntent,
+  validateRuntimeReviewerReceipt
+};

package/dist/package-contracts/terminating-infrastructure.js

@@ -1,101 +1,73 @@
-/**
- * Package-owned shared infrastructure-failure declaration for every primary
- * packaged-role output tool (#541).
- *
- * One module owns what the judge mandates be shared (not reimplemented per
- * seat): the typed `infrastructureFailure.diagnostic` declaration composed into
- * each output tool's schema, and the single early host `failInfrastructure`
- * call each output `execute` makes before any role business validation / gate /
- * audit / ledger / Git work. The accepted status sets are intentionally NOT
- * extended: an infra declaration fails BEFORE accepted validation, never
- * becomes an accepted receipt. The diagnostic is carried verbatim on the thrown
- * Error so settlement keeps the original cause (kind=failure, exit 1).
- */
 import { Type } from "typebox";
-export const INFRASTRUCTURE_FAILURE_DECLARATION_KEY = "infrastructureFailure";
-export const INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY = "diagnostic";
-/** Shared typed declaration fragment: `infrastructureFailure.diagnostic` = non-empty string. */
-const infrastructureFailureDeclarationSchema = Type.Object({
-    [INFRASTRUCTURE_FAILURE_DECLARATION_KEY]: Type.Object({
+const INFRASTRUCTURE_FAILURE_DECLARATION_KEY = "infrastructureFailure";
+const INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY = "diagnostic";
+const infrastructureFailureDeclarationSchema = Type.Object(
+  {
+    [INFRASTRUCTURE_FAILURE_DECLARATION_KEY]: Type.Object(
+      {
         [INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY]: Type.String({
-            minLength: 1,
-            description: "非空基础设施失败诊断",
-        }),
-    }, {
+          minLength: 1,
+          description: "\u975E\u7A7A\u57FA\u7840\u8BBE\u65BD\u5931\u8D25\u8BCA\u65AD"
+        })
+      },
+      {
         additionalProperties: true,
-        description: "基础设施失败声明",
-    }),
-}, { additionalProperties: true });
-/**
- * Compose the shared infrastructure-failure declaration into an open output
- * tool-object schema. Returns an open object (additionalProperties: true,
- * required: []) with the base schema's properties plus the shared declaration.
- * Static typing is preserved on the base (`as S`), so existing
- * `Static<typeof ...>` derived parameter types are unchanged.
- */
-export function withInfrastructureFailureDeclaration(schema) {
-    const baseProperties = schema
-        .properties;
-    const properties = {
-        ...(baseProperties ?? {}),
-        [INFRASTRUCTURE_FAILURE_DECLARATION_KEY]: infrastructureFailureDeclarationSchema.properties[INFRASTRUCTURE_FAILURE_DECLARATION_KEY],
-    };
-    const object = Type.Object(properties, { additionalProperties: true });
-    object.required = [];
-    return object;
+        description: "\u57FA\u7840\u8BBE\u65BD\u5931\u8D25\u58F0\u660E"
+      }
+    )
+  },
+  { additionalProperties: true }
+);
+function withInfrastructureFailureDeclaration(schema) {
+  const baseProperties = schema.properties;
+  const properties = {
+    ...baseProperties ?? {},
+    [INFRASTRUCTURE_FAILURE_DECLARATION_KEY]: infrastructureFailureDeclarationSchema.properties[INFRASTRUCTURE_FAILURE_DECLARATION_KEY]
+  };
+  const object = Type.Object(properties, { additionalProperties: true });
+  object.required = [];
+  return object;
 }
-/** Safe recognition of the typed declaration; non-shapes / hostile input fail closed. */
 function isInfrastructureFailureDeclaration(parameters) {
-    if (parameters === null ||
-        typeof parameters !== "object" ||
-        Array.isArray(parameters)) {
-        return false;
-    }
-    const record = parameters;
-    if (!Object.hasOwn(record, INFRASTRUCTURE_FAILURE_DECLARATION_KEY))
-        return false;
-    const declaration = record[INFRASTRUCTURE_FAILURE_DECLARATION_KEY];
-    if (declaration === null ||
-        typeof declaration !== "object" ||
-        Array.isArray(declaration)) {
-        return false;
-    }
-    const diagnostic = declaration[INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY];
-    return typeof diagnostic === "string" && diagnostic.trim().length > 0;
+  if (parameters === null || typeof parameters !== "object" || Array.isArray(parameters)) {
+    return false;
+  }
+  const record = parameters;
+  if (!Object.hasOwn(record, INFRASTRUCTURE_FAILURE_DECLARATION_KEY)) return false;
+  const declaration = record[INFRASTRUCTURE_FAILURE_DECLARATION_KEY];
+  if (declaration === null || typeof declaration !== "object" || Array.isArray(declaration)) {
+    return false;
+  }
+  const diagnostic = declaration[INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY];
+  return typeof diagnostic === "string" && diagnostic.trim().length > 0;
 }
-/** Non-empty trimmed diagnostic from the declaration, else undefined. */
 function infrastructureFailureDiagnostic(parameters) {
-    if (!isInfrastructureFailureDeclaration(parameters))
-        return undefined;
-    const declaration = parameters[INFRASTRUCTURE_FAILURE_DECLARATION_KEY];
-    const diagnostic = declaration[INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY];
-    return typeof diagnostic === "string" ? diagnostic.trim() : undefined;
+  if (!isInfrastructureFailureDeclaration(parameters)) return void 0;
+  const declaration = parameters[INFRASTRUCTURE_FAILURE_DECLARATION_KEY];
+  const diagnostic = declaration[INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY];
+  return typeof diagnostic === "string" ? diagnostic.trim() : void 0;
 }
-/** diagnostic → Error, name stamped so the host error identity is observable. */
 function infrastructureFailureError(diagnostic) {
-    const error = new Error(diagnostic);
-    error.name = "InfrastructureFailure";
-    return error;
+  const error = new Error(diagnostic);
+  error.name = "InfrastructureFailure";
+  return error;
 }
-/**
- * The one early call for every terminating output `execute`: if the parameters
- * carry the infra declaration, hand the diagnostic error to the shared host
- * `failInfrastructure` seam (which aborts the run). No-op otherwise.
- *
- * #641 chain②: an optional seat-owned bounce hook may intercept the
- * declaration first — when the seat can machine-verify a lawful normal
- * completion, it returns a correctable error and the declaration is treated as
- * model misuse (交件契约封驳) instead of a host failure. Returning undefined
- * keeps the shared failure path.
- */
-export function failOnInfrastructureFailureDeclaration(parameters, hostActions, ctx, toolCallId, bounceInfrastructureDeclaration) {
-    const diagnostic = infrastructureFailureDiagnostic(parameters);
-    if (diagnostic === undefined)
-        return;
-    if (bounceInfrastructureDeclaration !== undefined) {
-        const bounce = bounceInfrastructureDeclaration(parameters, toolCallId, ctx);
-        if (bounce !== undefined)
-            throw bounce;
-    }
-    hostActions.failInfrastructure(infrastructureFailureError(diagnostic), ctx, toolCallId);
+function failOnInfrastructureFailureDeclaration(parameters, hostActions, ctx, toolCallId, bounceInfrastructureDeclaration) {
+  const diagnostic = infrastructureFailureDiagnostic(parameters);
+  if (diagnostic === void 0) return;
+  if (bounceInfrastructureDeclaration !== void 0) {
+    const bounce = bounceInfrastructureDeclaration(parameters, toolCallId, ctx);
+    if (bounce !== void 0) throw bounce;
+  }
+  hostActions.failInfrastructure(
+    infrastructureFailureError(diagnostic),
+    ctx,
+    toolCallId
+  );
 }
+export {
+  INFRASTRUCTURE_FAILURE_DECLARATION_KEY,
+  INFRASTRUCTURE_FAILURE_DIAGNOSTIC_KEY,
+  failOnInfrastructureFailureDeclaration,
+  withInfrastructureFailureDeclaration
+};

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

@@ -1,13 +1,32 @@
-/** Package-owned independent Coder and Fixer output leaves. */
-export { FIXER_ACCEPTED_TEXT, FIXER_OUTPUT_TOOL_NAME, fixerOutputSchema, validateFixerOutput, validateFixerOutputForPacket, } from "./fixer-output.js";
-export { fixerPrerequisiteSchema, fixerPrerequisitesSchema, parseFixerPrerequisites, validateFixerPrerequisites } from "./fixer-packet.js";
-import { validateFixerOutput } from "./fixer-output.js";
-export const CODER_OUTPUT_TOOL_NAME = "ak_coder_output";
-export const CODER_ACCEPTED_TEXT = "将作监回执已接受";
-export function validateAcceptedCoderDetails(output) {
-    return output;
+import {
+  FIXER_ACCEPTED_TEXT,
+  FIXER_OUTPUT_TOOL_NAME,
+  fixerOutputSchema,
+  validateFixerOutput,
+  validateFixerOutputForPacket
+} from "./fixer-output.js";
+import { fixerPrerequisiteSchema, fixerPrerequisitesSchema, parseFixerPrerequisites, validateFixerPrerequisites } from "./fixer-packet.js";
+import { validateFixerOutput as validateFixerOutput2 } from "./fixer-output.js";
+const CODER_OUTPUT_TOOL_NAME = "ak_coder_output";
+const CODER_ACCEPTED_TEXT = "\u5C06\u4F5C\u76D1\u56DE\u6267\u5DF2\u63A5\u53D7";
+function validateAcceptedCoderDetails(output) {
+  return output;
 }
-/** Structural production validator for an accepted current leaf. */
-export function validateAcceptedWorkerDetails(output, roleLabel = "Coder") {
-    return roleLabel === "Fixer" ? validateFixerOutput(output) : validateAcceptedCoderDetails(output);
+function validateAcceptedWorkerDetails(output, roleLabel = "Coder") {
+  return roleLabel === "Fixer" ? validateFixerOutput2(output) : validateAcceptedCoderDetails(output);
 }
+export {
+  CODER_ACCEPTED_TEXT,
+  CODER_OUTPUT_TOOL_NAME,
+  FIXER_ACCEPTED_TEXT,
+  FIXER_OUTPUT_TOOL_NAME,
+  fixerOutputSchema,
+  fixerPrerequisiteSchema,
+  fixerPrerequisitesSchema,
+  parseFixerPrerequisites,
+  validateAcceptedCoderDetails,
+  validateAcceptedWorkerDetails,
+  validateFixerOutput,
+  validateFixerOutputForPacket,
+  validateFixerPrerequisites
+};

package/dist/package-resources/engine-material.js

@@ -1,105 +1,69 @@
-/**
- * Packaged engine method-material seam (#356 T1 / ADR 0069 / #376).
- * Engine names are owner pool-directive labels — not a closed material catalog.
- * Material body is optional data for the LLM, not a code contract.
- * Only path-safety syntax is checked at real I/O seams.
- */
 import { existsSync, readdirSync } from "node:fs";
 import { join } from "node:path";
 const ENGINE_MATERIAL_RELATIVE_ROOT = "resources/engines";
-/** Non-empty, trimmed; reject only real path hazards at the I/O seam. */
-export function isEngineNameSyntax(name) {
-    if (typeof name !== "string")
-        return false;
-    if (name.length === 0 || name.trim() !== name)
-        return false;
-    // Exact "." / ".." are directory aliases; consecutive dots inside a label are not.
-    if (name === "." || name === "..")
-        return false;
-    if (name.includes("/") || name.includes("\\") || name.includes("\0"))
-        return false;
-    return true;
+function isEngineNameSyntax(name) {
+  if (typeof name !== "string") return false;
+  if (name.length === 0 || name.trim() !== name) return false;
+  if (name === "." || name === "..") return false;
+  if (name.includes("/") || name.includes("\\") || name.includes("\0")) return false;
+  return true;
 }
-export function engineMaterialRelativeDirectory() {
-    return ENGINE_MATERIAL_RELATIVE_ROOT;
+function engineMaterialRelativeDirectory() {
+  return ENGINE_MATERIAL_RELATIVE_ROOT;
 }
-export function resolveEngineMaterialDirectory(packageRoot) {
-    return join(packageRoot, ENGINE_MATERIAL_RELATIVE_ROOT);
+function resolveEngineMaterialDirectory(packageRoot) {
+  return join(packageRoot, ENGINE_MATERIAL_RELATIVE_ROOT);
 }
-/**
- * Enumerate packaged engine notes stems (discovery only — not a legal-name gate).
- * Only `*.md` stems that pass name syntax are listed.
- */
-export function listEngineMaterialNames(packageRoot) {
-    const dir = resolveEngineMaterialDirectory(packageRoot);
-    if (!existsSync(dir))
-        return Object.freeze([]);
-    const names = readdirSync(dir)
-        .filter((entry) => entry.endsWith(".md"))
-        .map((entry) => entry.slice(0, -".md".length))
-        .filter((stem) => isEngineNameSyntax(stem))
-        .sort();
-    return Object.freeze([...names]);
+function listEngineMaterialNames(packageRoot) {
+  const dir = resolveEngineMaterialDirectory(packageRoot);
+  if (!existsSync(dir)) return Object.freeze([]);
+  const names = readdirSync(dir).filter((entry) => entry.endsWith(".md")).map((entry) => entry.slice(0, -".md".length)).filter((stem) => isEngineNameSyntax(stem)).sort();
+  return Object.freeze([...names]);
 }
-/**
- * Build the packaged notes path for a syntax-legal engine name.
- * Does not require the file to exist (material is optional data).
- */
-export function resolveEngineMaterialPath(packageRoot, name) {
-    const legal = assertLegalEngineName(name);
-    return join(resolveEngineMaterialDirectory(packageRoot), `${legal}.md`);
+function resolveEngineMaterialPath(packageRoot, name) {
+  const legal = assertLegalEngineName(name);
+  return join(resolveEngineMaterialDirectory(packageRoot), `${legal}.md`);
 }
-/**
- * Path-safety syntax gate for engine labels at real I/O seams.
- * Returns the canonical name on success; throws Error on illegal syntax.
- * Does not consult any material catalog (ADR 0069 pool-directive axis).
- */
-export function assertLegalEngineName(name) {
-    if (!isEngineNameSyntax(name)) {
-        throw new Error(`illegal engine name: ${name}`);
-    }
-    return name;
+function assertLegalEngineName(name) {
+  if (!isEngineNameSyntax(name)) {
+    throw new Error(`illegal engine name: ${name}`);
+  }
+  return name;
 }
-/**
- * Resolve optional engine options into session material coordinates.
- * No engine → undefined (caller keeps default prompt bytes).
- * Engine with packaged notes → name + absolute material path.
- * Engine without notes → name only (pass-through; no warning).
- */
-export function engineSessionMaterialFromOptions(options) {
-    if (options.engine === undefined)
-        return undefined;
-    if (options.packageRoot === undefined || options.packageRoot.trim() === "") {
-        throw new Error("packageRoot is required when engine is configured");
-    }
-    const name = assertLegalEngineName(options.engine);
-    const materialPath = resolveEngineMaterialPath(options.packageRoot, name);
-    if (existsSync(materialPath)) {
-        return Object.freeze({ name, materialPath });
-    }
-    return Object.freeze({ name });
+function engineSessionMaterialFromOptions(options) {
+  if (options.engine === void 0) return void 0;
+  if (options.packageRoot === void 0 || options.packageRoot.trim() === "") {
+    throw new Error("packageRoot is required when engine is configured");
+  }
+  const name = assertLegalEngineName(options.engine);
+  const materialPath = resolveEngineMaterialPath(options.packageRoot, name);
+  if (existsSync(materialPath)) {
+    return Object.freeze({ name, materialPath });
+  }
+  return Object.freeze({ name });
 }
-/**
- * Append engine method-material delivery to session initial material lines.
- * No engine → identity copy (byte-stable when joined the same way).
- * With notes → Chinese neutral handbook header + engine name + absolute material path.
- * Name only → engine name coordinate only (no handbook header, no path, no warning).
- * Never delivers material body.
- */
-export function appendEngineSessionMaterial(lines, engineMaterial) {
-    if (engineMaterial === undefined) {
-        return [...lines];
-    }
-    const out = [...lines];
-    out.push("");
-    if (engineMaterial.materialPath !== undefined) {
-        out.push("本次配置的劳务引擎及其手册：");
-        out.push(`- engine: ${engineMaterial.name}`);
-        out.push(`- ${engineMaterial.materialPath}`);
-    }
-    else {
-        // Name-only pass-through: no packaged bytes to claim as handbook.
-        out.push(`- engine: ${engineMaterial.name}`);
-    }
-    return out;
+function appendEngineSessionMaterial(lines, engineMaterial) {
+  if (engineMaterial === void 0) {
+    return [...lines];
+  }
+  const out = [...lines];
+  out.push("");
+  if (engineMaterial.materialPath !== void 0) {
+    out.push("\u672C\u6B21\u914D\u7F6E\u7684\u52B3\u52A1\u5F15\u64CE\u53CA\u5176\u624B\u518C\uFF1A");
+    out.push(`- engine: ${engineMaterial.name}`);
+    out.push(`- ${engineMaterial.materialPath}`);
+  } else {
+    out.push(`- engine: ${engineMaterial.name}`);
+  }
+  return out;
 }
+export {
+  appendEngineSessionMaterial,
+  assertLegalEngineName,
+  engineMaterialRelativeDirectory,
+  engineSessionMaterialFromOptions,
+  isEngineNameSyntax,
+  listEngineMaterialNames,
+  resolveEngineMaterialDirectory,
+  resolveEngineMaterialPath
+};