@akagilnc/pi-workflow-roles 0.1.5577 → 0.1.5593

package/dist/migrate-book-topology.js

@@ -1392,23 +1392,10 @@ var init_cli_errors = __esm({
   }
 });
 
-// src/sha256.ts
-import { createHash } from "node:crypto";
-function sha256Hex(bytes) {
-  return createHash("sha256").update(bytes).digest("hex");
-}
-var init_sha256 = __esm({
-  "src/sha256.ts"() {
-    "use strict";
-  }
-});
-
 // src/collector-config.ts
 var init_collector_config = __esm({
   "src/collector-config.ts"() {
     "use strict";
-    init_sha256();
-    init_unknown_value();
     init_run_ticket_number();
   }
 });
@@ -15608,22 +15595,10 @@ function rewriteSummonsMaterials(value2, rewrites) {
     rewrites
   );
   rewriteSourceRunLocator(value2.sourceRun, rewrites);
-  if (Array.isArray(value2.attachmentPaths)) {
-    value2.attachmentPaths = value2.attachmentPaths.map(
-      (path8) => rewriteRunDirectoryPathValueAgainstRewrites(path8, rewrites)
-    );
-  }
 }
 function rewriteAdmittedRoleRunPage(page, rewrites) {
   rewriteRunDirectoryPathFieldsAgainstRewrites(page, ADMITTED_PAGE_FIELDS, rewrites);
   rewriteSourceRunLocator(page.sourceRun, rewrites);
-  if (Array.isArray(page.attachments)) {
-    for (const attachment of page.attachments) {
-      if (isRecord(attachment)) {
-        rewriteRunDirectoryPathFieldsAgainstRewrites(attachment, ["frozenPath"], rewrites);
-      }
-    }
-  }
   if (isRecord(page.principal)) {
     rewriteRunDirectoryPathFieldsAgainstRewrites(
       page.principal,
@@ -15859,7 +15834,7 @@ var init_role_run_relocation = __esm({
       "taskPath",
       "packetPath",
       "prerequisitesPath",
-      "requestManifestPath",
+      // #1165: requestManifestPath is a caller path — never rewrite.
       "mergerInputPath",
       "sourceRunPath"
     ];
@@ -15884,6 +15859,17 @@ var init_role_run_relocation = __esm({
   }
 });
 
+// src/sha256.ts
+import { createHash } from "node:crypto";
+function sha256Hex(bytes) {
+  return createHash("sha256").update(bytes).digest("hex");
+}
+var init_sha256 = __esm({
+  "src/sha256.ts"() {
+    "use strict";
+  }
+});
+
 // src/submission-correctable-error.ts
 var correctableSubmissionErrorBrand, CorrectableSubmissionError;
 var init_submission_correctable_error = __esm({
@@ -16149,8 +16135,8 @@ var init_option_definitions = __esm({
       repeatable: true,
       form: "option",
       description: {
-        en: "Attach a regular file; frozen at admission (repeatable).",
-        zh: "\u9644\u52A0\u666E\u901A\u6587\u4EF6\uFF1B\u53D7\u7406\u5373\u51BB\u7ED3\uFF08\u53EF\u91CD\u590D\uFF09\u3002"
+        en: "Caller file path passed as-is to the role (repeatable). Package does not read, copy, or validate; use an absolute path when cwd differs from --project.",
+        zh: "\u8C03\u7528\u65B9\u6587\u4EF6\u8DEF\u5F84\u539F\u6837\u9012\u7ED9\u8859\u95E8\uFF08\u53EF\u91CD\u590D\uFF09\u3002\u5305\u4E0D\u8BFB\u3001\u4E0D\u590D\u5236\u3001\u4E0D\u6821\u9A8C\uFF1B\u8C03\u7528\u65B9\u5F53\u524D\u76EE\u5F55\u4E0E --project \u4E0D\u540C\u65F6\u8BF7\u7ED9\u7EDD\u5BF9\u8DEF\u5F84\u3002"
       }
     };
     SHARED_PHASE_SEMANTICS = {
@@ -16325,8 +16311,8 @@ var init_option_definitions = __esm({
         repeatable: false,
         form: "option",
         description: {
-          en: "Optional request manifest JSON path ({requests:[{id,body}]}). Parsed for semantics and passed to the Collector as materials \u2014 not a machine collection directive.",
-          zh: "\u53EF\u9009 request manifest JSON \u8DEF\u5F84\uFF08{requests:[{id,body}]}\uFF09\u3002\u6309\u8BED\u4E49\u89E3\u6790\u540E\u4F5C\u4E3A\u6750\u6599\u9012\u7ED9\u901A\u8FDB\u53F8\uFF0C\u4E0D\u662F\u673A\u5668\u4EE3\u6536 finding \u7684\u6307\u4EE4\u3002"
+          en: "Caller path to a request manifest JSON file, passed as-is. Package does not read, copy, or validate; use an absolute path when cwd differs from --project.",
+          zh: "\u8C03\u7528\u65B9 request manifest JSON \u8DEF\u5F84\uFF0C\u539F\u6837\u4F20\u9012\u3002\u5305\u4E0D\u8BFB\u3001\u4E0D\u590D\u5236\u3001\u4E0D\u6821\u9A8C\uFF1B\u8C03\u7528\u65B9\u5F53\u524D\u76EE\u5F55\u4E0E --project \u4E0D\u540C\u65F6\u8BF7\u7ED9\u7EDD\u5BF9\u8DEF\u5F84\u3002"
         }
       }
     ];
@@ -16802,7 +16788,6 @@ var init_invocation = __esm({
     init_uuidv7();
     init_notary_contracts();
     init_notary_source_run();
-    init_engine_material();
     init_cli_errors();
     init_option_definitions();
     init_unknown_value();
@@ -16856,7 +16841,6 @@ var init_run_lifecycle = __esm({
     init_cli_errors();
     init_collector_config();
     init_role_run_relocation();
-    init_engine_material();
     init_packaged_role_registry();
     init_invocation();
     init_run_dossier();

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

@@ -1,6 +1,7 @@
-import { existsSync, readdirSync } from "node:fs";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 const ENGINE_MATERIAL_RELATIVE_ROOT = "resources/engines";
+const ENGINE_DISPATCH_RELATIVE_PATH = "resources/engine-dispatch.md";
 function pickEngineAxis(source) {
   return {
     ...source.engine === void 0 ? {} : { engine: source.engine },
@@ -26,6 +27,9 @@ function engineMaterialRelativeDirectory() {
 function resolveEngineMaterialDirectory(packageRoot) {
   return join(packageRoot, ENGINE_MATERIAL_RELATIVE_ROOT);
 }
+function resolveEngineDispatchMaterialPath(packageRoot) {
+  return join(packageRoot, ENGINE_DISPATCH_RELATIVE_PATH);
+}
 function listEngineMaterialNames(packageRoot) {
   const dir = resolveEngineMaterialDirectory(packageRoot);
   if (!existsSync(dir)) return Object.freeze([]);
@@ -51,41 +55,34 @@ function engineSessionMaterialFromOptions(options) {
   const model = options.engineModel === void 0 ? void 0 : assertLegalEngineModel(options.engineModel);
   const materialPath = resolveEngineMaterialPath(options.packageRoot, name);
   const modelField = model === void 0 ? {} : { model };
-  if (existsSync(materialPath)) {
-    return Object.freeze({ name, materialPath, ...modelField });
+  if (!existsSync(materialPath)) {
+    return Object.freeze({ name, ...modelField });
   }
-  return Object.freeze({ name, ...modelField });
+  const handbook = readFileSync(materialPath, "utf8");
+  const dispatchPath = resolveEngineDispatchMaterialPath(options.packageRoot);
+  const dispatchField = existsSync(dispatchPath) ? { dispatchHandbook: readFileSync(dispatchPath, "utf8") } : {};
+  return Object.freeze({ name, handbook, ...dispatchField, ...modelField });
 }
-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}`);
-    if (engineMaterial.model !== void 0) {
-      out.push(`- engineModel: ${engineMaterial.model}`);
-    }
-    out.push(`- ${engineMaterial.materialPath}`);
-  } else {
-    out.push(`- engine: ${engineMaterial.name}`);
-    if (engineMaterial.model !== void 0) {
-      out.push(`- engineModel: ${engineMaterial.model}`);
-    }
-  }
-  return out;
+function engineSessionReadingMaterial(engineMaterial) {
+  if (engineMaterial === void 0) return void 0;
+  return {
+    kind: "engine-session-material",
+    name: engineMaterial.name,
+    ...engineMaterial.model === void 0 ? {} : { model: engineMaterial.model },
+    ...engineMaterial.handbook === void 0 ? {} : { handbook: engineMaterial.handbook },
+    ...engineMaterial.dispatchHandbook === void 0 ? {} : { dispatchHandbook: engineMaterial.dispatchHandbook }
+  };
 }
 export {
-  appendEngineSessionMaterial,
   assertLegalEngineModel,
   assertLegalEngineName,
   engineMaterialRelativeDirectory,
   engineSessionMaterialFromOptions,
+  engineSessionReadingMaterial,
   isEngineNameSyntax,
   listEngineMaterialNames,
   pickEngineAxis,
+  resolveEngineDispatchMaterialPath,
   resolveEngineMaterialDirectory,
   resolveEngineMaterialPath
 };

package/dist/public-cli/instruction-seat-run.js

@@ -24,11 +24,10 @@ import { sessionFileFromPublicSummon } from "../session-assistant-usage.js";
 import { latestQueuePayload, latestQueueStatus, } from "../submission-gate.js";
 import { isSafePositiveTicketNumber, readBoardTicketNumber } from "../run-ticket-number.js";
 import { NotarySourceRunError, resolveNotarySourceRunLocator } from "../notary-source-run.js";
-import { engineSessionMaterialFromOptions, pickEngineAxis } from "../package-resources/engine-material.js";
 import { packagedAdmitsCountersign, packagedBindsBoardTicket, packagedRebindSourceOnResume, packagedRoleMetadata, } from "../packaged-role-registry.js";
 import { readAuditorResumeBinding } from "../auditor-soul.js";
 import { CliUsageError } from "./cli-errors.js";
-import { admitPublicRole, bindAdmittedTicketNumber, buildInstructionTransportPrompt, materializeCountersignInvocation, persistAdmittedSourceRunPath, recordAdmittedCorrelation, recordChildDiaristRun, relocateAdmittedRunToTicket, withPreparedAttachments, } from "./invocation.js";
+import { admitPublicRole, bindAdmittedTicketNumber, buildInstructionTransportPrompt, materializeCountersignInvocation, persistAdmittedSourceRunPath, recordAdmittedCorrelation, recordChildDiaristRun, relocateAdmittedRunToTicket, } from "./invocation.js";
 import { bindDiaristAssertedTicketNumber, presentControlledFailure, packageFaultNoteFor, prepareSummonsResumeMaterials, roleTurnOptions, runPostAdmissionOneShot, runPostAdmissionResumable, runPostAdmissionSeatResume, showResumeErrorPointer, resumeTurnRequestProjectionOptions, } from "./post-admission.js";
 import { presentTerminal } from "./auto-resume.js";
 import { buildAutoResumeContinuationPrompt, loadResumablePublicRole, markRunAdmitted, parentRunPathFromGatePointerInstruction, readCurrentCourt, } from "./run-lifecycle.js";
@@ -175,10 +174,7 @@ function initialPrompt(admitted, env) {
     if (reask !== undefined && "reaskPrompt" in record && record.reaskPrompt === true) {
         return reask;
     }
-    return buildInstructionTransportPrompt(admitted, engineSessionMaterialFromOptions({
-        ...pickEngineAxis(env),
-        packageRoot: env.packageRoot,
-    }));
+    return buildInstructionTransportPrompt(admitted);
 }
 function isBoardTicketSeat(seat) {
     return packagedBindsBoardTicket(seat.role);
@@ -284,10 +280,7 @@ async function dispatchAdmitted(admitted, env, io) {
                 buildInitialRequest: () => buildInstructionSeatTurnRequest(admitted, roleTurnOptions(activeEnv, admitted, { kind: "initial", prompt: initialPrompt(admitted, activeEnv) })),
                 buildResumeRequest: () => buildInstructionSeatTurnRequest(admitted, roleTurnOptions(activeEnv, admitted, {
                     kind: "resume",
-                    prompt: buildAutoResumeContinuationPrompt({
-                        packageRoot: activeEnv.packageRoot,
-                        ...pickEngineAxis(activeEnv),
-                    }),
+                    prompt: buildAutoResumeContinuationPrompt(),
                 })),
                 adapters,
                 ...(activeEnv.engine === undefined ? {} : { effectiveEngine: activeEnv.engine }),
@@ -436,7 +429,7 @@ async function runCountersignBody(parsed, env, io) {
             summons: {
                 sourceRunPath: gateParentRunPath,
                 instruction: resumeInstruction,
-                instructionEmpty: resumeInstruction.trim() === "",
+                instructionEmpty: resumeInstruction.length === 0,
             },
         });
         if (resumed != null)
@@ -453,12 +446,12 @@ async function runCountersignBody(parsed, env, io) {
         throw error;
     }
     try {
-        return await withPreparedAttachments(parsed.attachmentPaths ?? [], async (preparedAttachments) => {
+        {
             const materializeAdmission = async (ticketNumber) => {
                 await materializeCountersignInvocation(admitted, {
                     home: env.home,
                     principalAuthority: env.principalAuthority,
-                    preparedAttachments,
+                    attachmentPaths: parsed.attachmentPaths ?? [],
                     ...(env.model === undefined ? {} : { model: env.model }),
                     ...(ticketNumber === undefined ? {} : { ticketNumber }),
                 });
@@ -472,10 +465,7 @@ async function runCountersignBody(parsed, env, io) {
             const turnProjection = roleTurnOptions(env, admitted, {
                 kind: "initial",
                 prompt: (env.reviewReask ?? env.gateReviewInstruction)
-                    ?? buildInstructionTransportPrompt(admitted, engineSessionMaterialFromOptions({
-                        ...pickEngineAxis(env),
-                        packageRoot: env.packageRoot,
-                    })),
+                    ?? buildInstructionTransportPrompt(admitted),
             });
             const turnRequest = buildInstructionSeatTurnRequest(admitted, turnProjection);
             const result = await runPostAdmissionOneShot({
@@ -496,7 +486,7 @@ async function runCountersignBody(parsed, env, io) {
             });
             await relocateAdmittedRunToTicket(admitted, env.principalAuthority);
             return result;
-        });
+        }
     }
     catch (error) {
         const rejected = usageExit(error, io);
@@ -567,7 +557,7 @@ export async function runPublicInstructionSeat(argv, env, io, role, parseArgv) {
         const summons = {
             ...sameParentInstruction(env, {
                 instruction: parsed.instruction ?? "",
-                instructionEmpty: (parsed.instruction ?? "").trim() === "",
+                instructionEmpty: (parsed.instruction ?? "").length === 0,
             }),
             attachmentPaths: parsed.attachmentPaths ?? [],
         };
@@ -593,7 +583,7 @@ export async function runPublicInstructionSeat(argv, env, io, role, parseArgv) {
                 sourceRunPath: parentRunPath,
                 ...sameParentInstruction(env, {
                     instruction: parsed.instruction ?? "",
-                    instructionEmpty: (parsed.instruction ?? "").trim() === "",
+                    instructionEmpty: (parsed.instruction ?? "").length === 0,
                 }),
                 attachmentPaths: parsed.attachmentPaths ?? [],
             };
@@ -679,7 +669,7 @@ export async function runPublicInstructionSeat(argv, env, io, role, parseArgv) {
                     instruction: parsed.instruction ?? "",
                     projectRoot: admitted.projectRoot,
                     failureLabel: "secretariat unbound summons",
-                    attachmentPaths: admitted.attachments.map((attachment) => attachment.frozenPath),
+                    attachmentPaths: admitted.attachments.map((attachment) => attachment.path),
                     correlationId: admitted.runId,
                 }, env, io);
             }