@akagilnc/pi-workflow-roles 0.1.4021 → 0.1.4035

package/dist/navigator-public-session.js

@@ -1,30 +1,12 @@
 import { sitianReport } from "./sitian-facade.js";
 import {
   NavigatorUnavailableError,
-  navigatorProviderFailureFromDiagnostics,
+  navigatorProviderFailureFromPublicTerminal,
   navigatorProviderFailureFromError,
-  navigatorProviderFailureFromStatus,
   navigatorUnavailableError,
   parseNavigatorModelSetting,
   resolveNavigatorSeatSelection
 } from "./navigator-session-contracts.js";
-import { lastRolePayloadRecord } from "./public-cli/terminal.js";
-function providerFailureFromPublicTerminal(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: "transport" };
-  return { source: "session", cause: "session" };
-}
 function createNativeNavigatorSessionFactory() {
   return async ({ context, subject, tool }) => {
     const resolved = await resolveNavigatorSeatSelection(context);
@@ -80,14 +62,15 @@ function createNativeNavigatorSessionFactory() {
             const outcome = summoned.terminal?.roleOutcome;
             if (outcome === void 0) {
               const detail = summoned.stderr?.trim() || `exit ${summoned.exitCode}`;
-              providerFailure = { source: "transport", cause: "transport" };
+              providerFailure = { source: "transport", cause: "unknown" };
               throw navigatorUnavailableError(
-                "transport",
-                new Error(`Navigator public summon produced no terminal (${detail})`)
+                providerFailure.source,
+                new Error(`Navigator public summon produced no terminal (${detail})`),
+                providerFailure.cause
               );
             }
             if (outcome.kind === "failure") {
-              providerFailure = providerFailureFromPublicTerminal(outcome);
+              providerFailure = navigatorProviderFailureFromPublicTerminal(outcome);
               throw navigatorUnavailableError(
                 providerFailure.source,
                 new Error(outcome.diagnostic),
@@ -101,21 +84,22 @@ function createNativeNavigatorSessionFactory() {
             if (outcome.kind !== "accepted") {
               return;
             }
-            const candidates = lastRolePayloadRecord(outcome.payloads ?? [])?.candidates;
-            if (!Array.isArray(candidates)) {
-              return;
+            for (const payload of outcome.payloads ?? []) {
+              if (typeof payload !== "object" || payload === null || Array.isArray(payload)) continue;
+              const candidates = payload.candidates;
+              if (!Array.isArray(candidates)) continue;
+              await tool.execute(
+                "navigator-public-prepare",
+                { candidates },
+                void 0,
+                void 0,
+                context
+              );
             }
-            await tool.execute(
-              "navigator-public-prepare",
-              { candidates },
-              void 0,
-              void 0,
-              context
-            );
           } catch (error) {
             if (error instanceof NavigatorUnavailableError) throw error;
             const fact = navigatorProviderFailureFromError(error);
-            providerFailure = fact ?? { source: "transport", cause: "transport" };
+            providerFailure = fact ?? { source: "transport", cause: "unknown" };
             throw navigatorUnavailableError(providerFailure.source, error, providerFailure.cause);
           }
         })();

package/dist/navigator-session-contracts.js

@@ -92,6 +92,24 @@ function navigatorProviderFailureFromDiagnostics(diagnostics) {
   }
   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"),
@@ -208,6 +226,7 @@ export {
   navigatorProviderFailure,
   navigatorProviderFailureFromDiagnostics,
   navigatorProviderFailureFromError,
+  navigatorProviderFailureFromPublicTerminal,
   navigatorProviderFailureFromStatus,
   navigatorUnavailableError,
   parseNavigatorModelSetting,

package/dist/pi/known-failure.js

@@ -35,9 +35,8 @@ function sessionStopDetails(input) {
 /**
  * Project a native session assistant stop onto the existing knownFailure chain.
  * Classification follows two-way testimony: typed HTTP status or SDK structure
- * keeps provider; stopReason, configured provider/model, or errorMessage prose
- * alone is the existing unrecognized value. Present upstream payload is preserved
- * in details without rewriting; missing fields are omitted.
+ * keeps provider; stopReason / errorMessage prose alone never invents a class (#881).
+ * Present upstream payload is preserved in details without rewriting; missing fields are omitted.
  */
 export function knownFailureFromProviderStop(input) {
     if (input.stopReason !== "error" && input.stopReason !== "aborted")
@@ -45,7 +44,7 @@ export function knownFailureFromProviderStop(input) {
     const diagnostic = nonEmptyString(input.errorMessage);
     const details = sessionStopDetails(input);
     return {
-        cause: hasUpstreamErrorTestimony(input) ? "provider" : "unrecognized",
+        ...(hasUpstreamErrorTestimony(input) ? { cause: "provider" } : {}),
         ...(diagnostic === undefined ? {} : { diagnostic }),
         ...(Object.keys(details).length === 0 ? {} : { details }),
     };

package/dist/public-cli/auto-resume.js

@@ -18,7 +18,7 @@ import { join } from "node:path";
 import { AUTO_RESUME_LIMIT, describeErrorIdentity, acquireRunWriterLease, markRunResumable, markRunTerminal, RunWriterLeaseHeldError, } from "./run-lifecycle.js";
 import { parseAutoResumeLimit } from "./config.js";
 import { isLawfulTypedTerminalOutcome, formatTerminalResult } from "./terminal.js";
-import { presentFailureTerminal, presentStructuralRejection, resolveControlledFailureResumeObservation, } from "./settlement.js";
+import { attachRecordedSubmissions, presentFailureTerminal, presentStructuralRejection, resolveControlledFailureResumeObservation, } from "./settlement.js";
 const dummyIo = { stdout: () => { }, stderr: () => { } };
 /**
  * Persist run-state after a host-turn result, outside the retried dispatch try.
@@ -280,6 +280,20 @@ function unwrapTurnDispatchedFailure(error) {
     }
     return current;
 }
+async function attachDispatchExceptionTerminal(admitted, terminal, io) {
+    try {
+        return await attachRecordedSubmissions({
+            projectRoot: admitted.projectRoot,
+            runId: admitted.runId,
+            runDirectory: admitted.runDirectory,
+        }, terminal);
+    }
+    catch (error) {
+        // Existing diagnostic seam: attach true cause on stderr, original Terminal stays.
+        io.stderr(`dispatch exception ledger attach failed (best-effort continue): ${describeErrorIdentity(error)}\n`);
+        return terminal;
+    }
+}
 /**
  * Typed failure terminal for a retry path that ended with only exceptions:
  * loud, non-lawful, carrying the last true cause and the pointers to the
@@ -293,8 +307,8 @@ function dispatchExceptionFailureTerminal(input) {
         ? "dispatch threw an exception on every attempt"
         : "the final dispatch threw an exception";
     const diagnostic = `${history} (${input.endReason}; resumes used ${input.autoResumeAttempts}); last cause: ${describeErrorIdentity(causeError)}`;
+    // #881: no fabricated cause class — original error identity + error-file pointers carry the fact.
     const decisiveFacts = {
-        cause: "unrecognized",
         diagnostic,
         resumesUsed: input.autoResumeAttempts,
         dispatchErrorFiles: [...input.errorFiles],
@@ -316,7 +330,6 @@ function dispatchExceptionFailureTerminal(input) {
         roleOutcome: {
             kind: "failure",
             role: input.role,
-            cause: "unrecognized",
             diagnostic,
             decisiveFacts,
         },
@@ -431,7 +444,7 @@ export async function runWithAutoResumeLoop(options) {
         else {
             // Exception path: continue through the identical budget/session gates.
             if (autoResumeAttempts >= limit) {
-                const terminal = dispatchExceptionFailureTerminal({
+                const terminal = await attachDispatchExceptionTerminal(options.admitted, dispatchExceptionFailureTerminal({
                     role: options.admitted.role,
                     runId: options.admitted.runId,
                     causeError: lastThrownError,
@@ -439,7 +452,7 @@ export async function runWithAutoResumeLoop(options) {
                     autoResumeAttempts,
                     endReason: "auto-resume budget exhausted",
                     everyAttemptThrew,
-                });
+                }), options.io);
                 await finalizeExceptionRunBestEffort(options.admitted.runDirectory, options.io);
                 presentTerminal(terminal, options.io);
                 return {
@@ -448,7 +461,7 @@ export async function runWithAutoResumeLoop(options) {
                 };
             }
             if (!(await isPrincipalAvailable(options.admitted.principal))) {
-                const terminal = dispatchExceptionFailureTerminal({
+                const terminal = await attachDispatchExceptionTerminal(options.admitted, dispatchExceptionFailureTerminal({
                     role: options.admitted.role,
                     runId: options.admitted.runId,
                     causeError: lastThrownError,
@@ -456,7 +469,7 @@ export async function runWithAutoResumeLoop(options) {
                     autoResumeAttempts,
                     endReason: "session principal unavailable before further resume",
                     everyAttemptThrew,
-                });
+                }), options.io);
                 await finalizeExceptionRunBestEffort(options.admitted.runDirectory, options.io);
                 presentTerminal(terminal, options.io);
                 return {

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

@@ -5,8 +5,8 @@ import { prepareSummonsResumeMaterials, runPostAdmissionOneShot, runPostAdmissio
 import { loadResumableDiaristRun, markRunAdmitted, } from "./run-lifecycle.js";
 import { tryResumeSameTicketSeatRun } from "./seat-ticket-binding.js";
 import { presentStructuralRejection, trySettleDiaristTerminalResult, } from "./settlement.js";
-import { lastRolePayloadRecord } from "./terminal.js";
 import { projectRoleTurnRequest, } from "./turn-request.js";
+import { readRunTicketNumber } from "../run-ticket-number.js";
 /** Project admitted invocation onto the host-neutral turn request. */
 export function buildDiaristTurnRequest(admitted, options) {
     return projectRoleTurnRequest(admitted, { activation: { role: "diarist" } }, options);
@@ -110,29 +110,15 @@ export async function runPublicDiarist(argv, env, io, parseDiaristArgv) {
         adapters: diaristAdapters(),
         ...(env.engine === undefined ? {} : { effectiveEngine: env.engine }),
     }).then(async (result) => {
-        // Accept may have bound ticket onto durable pages after LLM assertion.
-        // Mirror only lawful non-escalate accepted terminals — escalate must not
-        // leak an unverified ticketNumber into the caller-visible typed key.
+        // Accept hook binds ticket onto durable pages (#771). Mirror that page fact
+        // onto the caller-visible admitted object — never pick a ticketNumber out of
+        // the payload sequence (#881 sole-collapse ban on ticket/escalate).
         if (admitted.ticketNumber === undefined && result.admitted !== undefined) {
-            const roleOutcome = result.terminal?.roleOutcome;
-            const facts = roleOutcome?.kind === "accepted"
-                ? lastRolePayloadRecord(roleOutcome.payloads ?? [])
-                : undefined;
-            if (roleOutcome !== undefined &&
-                roleOutcome.kind === "accepted" &&
-                facts?.status !== "escalate") {
-                const raw = typeof facts?.ticketNumber === "number"
-                    ? facts.ticketNumber
-                    : typeof facts?.sitian === "object"
-                        && facts.sitian !== null
-                        && typeof facts.sitian.ticketNumber === "number"
-                        ? facts.sitian.ticketNumber
-                        : undefined;
-                if (typeof raw === "number" && Number.isSafeInteger(raw) && raw >= 1) {
-                    admitted.ticketNumber = raw;
-                    if (result.admitted.ticketNumber === undefined) {
-                        result.admitted.ticketNumber = raw;
-                    }
+            const fromPages = await readRunTicketNumber(admitted.runDirectory);
+            if (fromPages !== undefined) {
+                await bindAdmittedTicketNumber(admitted, fromPages);
+                if (result.admitted.ticketNumber === undefined) {
+                    result.admitted.ticketNumber = fromPages;
                 }
             }
         }

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

@@ -36,7 +36,9 @@ function instructionSeatAdapters(options) {
             return infrastructureFailure === undefined
                 ? result.knownFailure
                 : {
-                    cause: infrastructureFailure.cause,
+                    ...(infrastructureFailure.cause === undefined
+                        ? {}
+                        : { cause: infrastructureFailure.cause }),
                     diagnostic: infrastructureFailure.diagnostic,
                     ...(infrastructureFailure.identity === undefined
                         ? {}

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

@@ -18,7 +18,9 @@ function judgeAdapters() {
                 (infrastructureFailure === undefined
                     ? undefined
                     : {
-                        cause: infrastructureFailure.cause,
+                        ...(infrastructureFailure.cause === undefined
+                            ? {}
+                            : { cause: infrastructureFailure.cause }),
                         diagnostic: infrastructureFailure.diagnostic,
                         ...(infrastructureFailure.identity === undefined
                             ? {}