@akagilnc/pi-workflow-roles 0.1.3625 → 0.1.3629

package/dist/public-cli/notary-run.js

@@ -1,3 +1,11 @@
+/**
+ * Public Notary Role run: admit source-run locator → shared post-admission coordinator
+ * → settle Terminal result (#448 / #517). Zero caller prompt/attachment. Lifecycle is
+ * the shared post-admission seam; this module keeps only Notary adapters.
+ * #637: same-ticket re-summons resume the seat's previous run (no new run).
+ */
+import { existsSync } from "node:fs";
+import { gateSubmissionCandidatePath } from "../auditor-dossier-tool.js";
 import { NotarySourceRunError, resolveNotarySourceRunLocator, } from "../notary-source-run.js";
 import { engineSessionMaterialFromOptions } from "../package-resources/engine-material.js";
 import { readRunTicketNumber } from "../run-ticket-number.js";
@@ -5,7 +13,7 @@ import { CliUsageError } from "./cli-errors.js";
 import { admitNotaryInvocation, buildNotaryTransportPrompt, } from "./invocation.js";
 import { tryResumeSameTicketSeatRun } from "./seat-ticket-binding.js";
 import { runPostAdmissionOneShot, runPostAdmissionSeatResume, resumeTurnRequestProjectionOptions, } from "./post-admission.js";
-import { loadResumableNotaryRun, markRunAdmitted, } from "./run-lifecycle.js";
+import { appendResumeMaterialReread, loadResumableNotaryRun, markRunAdmitted, } from "./run-lifecycle.js";
 import { presentStructuralRejection, trySettleNotaryTerminalResult, } from "./settlement.js";
 import { projectRoleTurnRequest, } from "./turn-request.js";
 /** Project admitted invocation onto the host-neutral turn request. */
@@ -154,7 +162,17 @@ export async function runPublicNotaryResume(request, env, io) {
             }
             return loaded;
         },
-        buildTurnRequest: (admitted, effective) => buildNotaryTurnRequest(admitted, resumeTurnRequestProjectionOptions(admitted, effective, env)),
+        buildTurnRequest: (admitted, effective) => {
+            const projection = resumeTurnRequestProjectionOptions(admitted, effective, env);
+            const candidatePath = gateSubmissionCandidatePath(admitted.sourceRunPath);
+            const prompt = existsSync(candidatePath)
+                ? appendResumeMaterialReread(projection.continuation.prompt, candidatePath)
+                : projection.continuation.prompt;
+            return buildNotaryTurnRequest(admitted, {
+                ...projection,
+                continuation: { kind: "resume", prompt },
+            });
+        },
         adapters: notaryAdapters(),
         ...(env.engine === undefined ? {} : { effectiveEngine: env.engine }),
     });

package/dist/public-cli/post-admission.js

@@ -8,7 +8,7 @@
 import { randomUUID } from "node:crypto";
 import { readFile, writeFile } from "node:fs/promises";
 import { isAbsolute, join, resolve } from "node:path";
-import { buildResumeContinuationPrompt, } from "./run-lifecycle.js";
+import { buildResumeContinuationPrompt, instructResumeHandbookRead, } from "./run-lifecycle.js";
 import { CliUsageError } from "./cli-errors.js";
 import { buildInstructionTransportPrompt, freezeAttachmentsIntoRun, } from "./invocation.js";
 import { pathContainedIn } from "../activation-ledger-topology.js";
@@ -256,11 +256,11 @@ export function resumeTurnRequestProjectionOptions(admitted, request, env, summo
         // projection must not re-interpret the caller message as instructionEmpty.
         if (summonsPrepared !== undefined &&
             summonsPrepared.attachments.length > 0) {
-            prompt = buildInstructionTransportPrompt({
+            prompt = instructResumeHandbookRead(buildInstructionTransportPrompt({
                 instruction: request.message,
                 instructionEmpty: false,
                 attachments: summonsPrepared.attachments,
-            }, engineMaterial);
+            }, engineMaterial), engineMaterial);
         }
         else {
             prompt = buildResumeContinuationPrompt({
@@ -271,7 +271,7 @@ export function resumeTurnRequestProjectionOptions(admitted, request, env, summo
         }
     }
     else if (summonsPrepared !== undefined) {
-        prompt = buildInstructionTransportPrompt(summonsPrepared, engineMaterial);
+        prompt = instructResumeHandbookRead(buildInstructionTransportPrompt(summonsPrepared, engineMaterial), engineMaterial);
     }
     else {
         prompt = buildResumeContinuationPrompt({

package/dist/public-cli/run-lifecycle.js

@@ -6,7 +6,7 @@
  * Prose is never regex-classified as quota evidence.
  */
 import { chmod, open, readdir, readFile, unlink, writeFile } from "node:fs/promises";
-import { join } from "node:path";
+import { isAbsolute, join } from "node:path";
 import { activationBookDirectory, resolveActivationLedgerHome, } from "../activation-ledger-topology.js";
 import { readRunTicketNumber } from "../run-ticket-number.js";
 import { CliUsageError } from "./cli-errors.js";
@@ -26,15 +26,54 @@ export const V1_RESUMABLE_PROVIDERS = ["openai-codex", "xai"];
 export const AUTO_RESUME_LIMIT = 2;
 /** Package-owned turn trigger for resume. Not caller instruction and not semantic task content. */
 export const RESUME_TRANSPORT_ENVELOPE = "[ak-role:resume-continue]";
+function resumeRereadInstruction(materialPath, handbook) {
+    return handbook
+        ? `重新读 ${materialPath}，再组装外包 argv`
+        : `重新读 ${materialPath}`;
+}
+/**
+ * Resume-only material lines (#736 ticket exemption to ADR 0073 §3).
+ * Neutral `- <absolute path>` pointers already on the continuation
+ * (handbook from appendEngineSessionMaterial; frozen attachments from
+ * instruction-seat transport) become reread instructions.
+ * Handbook keeps the argv suffix; other materials are path-only.
+ * First-round delivery is unchanged; never pastes material body.
+ */
+export function instructResumeHandbookRead(prompt, engineMaterial) {
+    const handbookPath = engineMaterial?.materialPath;
+    return prompt
+        .split("\n")
+        .map((line) => {
+        if (!line.startsWith("- "))
+            return line;
+        const value = line.slice(2);
+        if (handbookPath !== undefined && value === handbookPath) {
+            return resumeRereadInstruction(handbookPath, true);
+        }
+        if (isAbsolute(value))
+            return resumeRereadInstruction(value, false);
+        return line;
+    })
+        .join("\n");
+}
+/** Append a live-path reread instruction when the pointer is not already on the continuation. */
+export function appendResumeMaterialReread(prompt, materialPath) {
+    const instruction = resumeRereadInstruction(materialPath, false);
+    const lines = prompt.split("\n");
+    if (lines.includes(instruction))
+        return prompt;
+    return prompt.length === 0 ? instruction : `${prompt}\n${instruction}`;
+}
 /**
- * Unique continuation-prompt selector for manual/auto resume (#471 / #600).
+ * Unique continuation-prompt selector for manual/auto resume (#471 / #600 / #736).
  * Message present → base bytes unchanged; absent → package transport envelope.
- * When engine material is present, append structured engine coordinates (same
- * delivery as initial transport prompts). Zero parse, zero classify, zero narrow.
+ * When engine material is present, append structured engine coordinates then
+ * rewrite absolute material pointer lines into 重新读 instructions. Zero parse,
+ * zero classify, zero narrow. Pointer only — never material body.
  */
 export function selectResumeContinuationPrompt(message, engineMaterial) {
     const base = message !== undefined ? message : RESUME_TRANSPORT_ENVELOPE;
-    return appendEngineSessionMaterial([base], engineMaterial).join("\n");
+    return instructResumeHandbookRead(appendEngineSessionMaterial([base], engineMaterial).join("\n"), engineMaterial);
 }
 /**
  * Resume continuation with engine material resolved from the seat env (#600).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akagilnc/pi-workflow-roles",
-  "version": "0.1.3625",
+  "version": "0.1.3629",
   "description": "Soul-bound workflow roles for Pi",
   "type": "module",
   "license": "Apache-2.0",

package/src/public-cli/notary-run.ts

@@ -4,6 +4,9 @@
  * the shared post-admission seam; this module keeps only Notary adapters.
  * #637: same-ticket re-summons resume the seat's previous run (no new run).
  */
+import { existsSync } from "node:fs";
+
+import { gateSubmissionCandidatePath } from "../auditor-dossier-tool.ts";
 import type { DurablePrincipalAuthority, RoleTurnRequest } from "../host-contracts.ts";
 import {
   NotarySourceRunError,
@@ -27,6 +30,7 @@ import {
   resumeTurnRequestProjectionOptions,
 } from "./post-admission.ts";
 import {
+  appendResumeMaterialReread,
   loadResumableNotaryRun,
   markRunAdmitted,
   type PublicResumeRequest,
@@ -235,11 +239,21 @@ export async function runPublicNotaryResume(
       }
       return loaded;
     },
-    buildTurnRequest: (admitted, effective) =>
-      buildNotaryTurnRequest(
+    buildTurnRequest: (admitted, effective) => {
+      const projection = resumeTurnRequestProjectionOptions(
         admitted,
-        resumeTurnRequestProjectionOptions(admitted, effective, env),
-      ),
+        effective,
+        env,
+      );
+      const candidatePath = gateSubmissionCandidatePath(admitted.sourceRunPath);
+      const prompt = existsSync(candidatePath)
+        ? appendResumeMaterialReread(projection.continuation.prompt, candidatePath)
+        : projection.continuation.prompt;
+      return buildNotaryTurnRequest(admitted, {
+        ...projection,
+        continuation: { kind: "resume", prompt },
+      });
+    },
     adapters: notaryAdapters(),
     ...(env.engine === undefined ? {} : { effectiveEngine: env.engine }),
   });

package/src/public-cli/post-admission.ts

@@ -11,6 +11,7 @@ import { isAbsolute, join, resolve } from "node:path";
 
 import {
   buildResumeContinuationPrompt,
+  instructResumeHandbookRead,
   type PublicResumeRequest,
   type SameTicketSummonsMaterials,
 } from "./run-lifecycle.ts";
@@ -492,12 +493,15 @@ export function resumeTurnRequestProjectionOptions(
       summonsPrepared !== undefined &&
       summonsPrepared.attachments.length > 0
     ) {
-      prompt = buildInstructionTransportPrompt(
-        {
-          instruction: request.message,
-          instructionEmpty: false,
-          attachments: summonsPrepared.attachments,
-        },
+      prompt = instructResumeHandbookRead(
+        buildInstructionTransportPrompt(
+          {
+            instruction: request.message,
+            instructionEmpty: false,
+            attachments: summonsPrepared.attachments,
+          },
+          engineMaterial,
+        ),
         engineMaterial,
       );
     } else {
@@ -508,7 +512,10 @@ export function resumeTurnRequestProjectionOptions(
       });
     }
   } else if (summonsPrepared !== undefined) {
-    prompt = buildInstructionTransportPrompt(summonsPrepared, engineMaterial);
+    prompt = instructResumeHandbookRead(
+      buildInstructionTransportPrompt(summonsPrepared, engineMaterial),
+      engineMaterial,
+    );
   } else {
     prompt = buildResumeContinuationPrompt({
       packageRoot: env.packageRoot,

package/src/public-cli/run-lifecycle.ts

@@ -10,7 +10,7 @@ import type {
  * Prose is never regex-classified as quota evidence.
  */
 import { chmod, open, readdir, readFile, unlink, writeFile } from "node:fs/promises";
-import { join } from "node:path";
+import { isAbsolute, join } from "node:path";
 
 import {
   activationBookDirectory,
@@ -157,18 +157,66 @@ export type SameTicketSummonsMaterials = {
   readonly sourceRun?: NotarySourceRunLocator;
 };
 
+function resumeRereadInstruction(materialPath: string, handbook: boolean): string {
+  return handbook
+    ? `重新读 ${materialPath}，再组装外包 argv`
+    : `重新读 ${materialPath}`;
+}
+
 /**
- * Unique continuation-prompt selector for manual/auto resume (#471 / #600).
+ * Resume-only material lines (#736 ticket exemption to ADR 0073 §3).
+ * Neutral `- <absolute path>` pointers already on the continuation
+ * (handbook from appendEngineSessionMaterial; frozen attachments from
+ * instruction-seat transport) become reread instructions.
+ * Handbook keeps the argv suffix; other materials are path-only.
+ * First-round delivery is unchanged; never pastes material body.
+ */
+export function instructResumeHandbookRead(
+  prompt: string,
+  engineMaterial?: EngineSessionMaterial,
+): string {
+  const handbookPath = engineMaterial?.materialPath;
+  return prompt
+    .split("\n")
+    .map((line) => {
+      if (!line.startsWith("- ")) return line;
+      const value = line.slice(2);
+      if (handbookPath !== undefined && value === handbookPath) {
+        return resumeRereadInstruction(handbookPath, true);
+      }
+      if (isAbsolute(value)) return resumeRereadInstruction(value, false);
+      return line;
+    })
+    .join("\n");
+}
+
+/** Append a live-path reread instruction when the pointer is not already on the continuation. */
+export function appendResumeMaterialReread(
+  prompt: string,
+  materialPath: string,
+): string {
+  const instruction = resumeRereadInstruction(materialPath, false);
+  const lines = prompt.split("\n");
+  if (lines.includes(instruction)) return prompt;
+  return prompt.length === 0 ? instruction : `${prompt}\n${instruction}`;
+}
+
+/**
+ * Unique continuation-prompt selector for manual/auto resume (#471 / #600 / #736).
  * Message present → base bytes unchanged; absent → package transport envelope.
- * When engine material is present, append structured engine coordinates (same
- * delivery as initial transport prompts). Zero parse, zero classify, zero narrow.
+ * When engine material is present, append structured engine coordinates then
+ * rewrite absolute material pointer lines into 重新读 instructions. Zero parse,
+ * zero classify, zero narrow. Pointer only — never material body.
  */
 export function selectResumeContinuationPrompt(
   message?: string,
   engineMaterial?: EngineSessionMaterial,
 ): string {
   const base = message !== undefined ? message : RESUME_TRANSPORT_ENVELOPE;
-  return appendEngineSessionMaterial([base], engineMaterial).join("\n");
+  return instructResumeHandbookRead(
+    appendEngineSessionMaterial([base], engineMaterial).join("\n"),
+    engineMaterial,
+  );
 }
 
 /**