@akagilnc/pi-workflow-roles 0.1.5406 → 0.1.5475

package/dist/public-cli/process-cancel.js

@@ -55,3 +55,11 @@ export function processCancelSignalName(signal) {
 export function processCancelDiagnostic(signalName) {
     return `ak-role terminated by ${signalName}`;
 }
+/**
+ * Diagnostic line for a child the host lost to a signal. The child reported
+ * code=null, which is a non-normal exit and never a successful run
+ * (ADR 0052: 真失败退非零).
+ */
+export function childSignalDeathDiagnostic(signal) {
+    return `role run was killed by ${signal}`;
+}

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

@@ -11,18 +11,12 @@ import { activationBookDirectory, resolveActivationLedgerHome, } from "../activa
 import { listBookRunDirectories } from "../role-run-placement.js";
 import { isSafePositiveTicketNumber } from "../run-ticket-number.js";
 import { CliUsageError } from "./cli-errors.js";
-import { readLatestTypedProviderHttpObservation, } from "../typed-provider-http.js";
-export { clearTypedProviderHttpObservation, recordTypedProviderHttpStatus, readLatestTypedProviderHttpObservation, } from "../typed-provider-http.js";
 import { parseCollectorRepository } from "../collector-config.js";
 import { rewriteAdmittedRoleRunPage, rewriteRunDirectoryPathValue, } from "../role-run-relocation.js";
 import { appendEngineSessionMaterial, engineSessionMaterialFromOptions, pickEngineAxis, } from "../package-resources/engine-material.js";
 import { packagedResumeSourcePath, packagedRoleMetadata, } from "../packaged-role-registry.js";
 import { admittedReviewerBaseFault, recordEffectiveInvocationModel, requireAuthorityRef, isReviewerLens, } from "./invocation.js";
 import { isRecord, errorText, isEnoent } from "../unknown-value.js";
-/** Providers eligible for v1 typed-429 resume (Codex / xAI only).
- * @deprecated v1 429-only gate removed by #416 (owner 2026-08-22: "根本不要有限制"). Kept for compatibility; do not use for new branching.
- */
-export const V1_RESUMABLE_PROVIDERS = ["openai-codex", "xai"];
 /** Default for the #422 configurable single-call auto-resume ceiling
  * (public-cli.json top-level `autoResumeLimit`). No longer the runtime truth
  * source: runWithAutoResumeLoop receives the effective value once per call.
@@ -49,25 +43,6 @@ export function buildAutoResumeContinuationPrompt(options) {
 }
 const RUN_STATE_FILE = "run-state.json";
 const WRITER_LOCK_FILE = "writer.lock";
-/** @deprecated #416: 429-only classification removed; kept for compatibility. */
-export function isV1ResumableProvider(provider) {
-    return V1_RESUMABLE_PROVIDERS.includes(provider);
-}
-/** @deprecated #416: 429-only observation no longer gates resume; kept for historical runs. */
-export async function readTypedHttp429Observation(runDirectory) {
-    const observation = await readLatestTypedProviderHttpObservation(runDirectory);
-    if (observation === undefined)
-        return undefined;
-    if (observation.httpStatus !== 429)
-        return undefined;
-    if (!isV1ResumableProvider(observation.provider))
-        return undefined;
-    return { httpStatus: 429, provider: observation.provider };
-}
-/** Complete public resume command. Run ID is revealed only through this command text. */
-export function renderResumeCommand(runId) {
-    return `ak-role resume ${runId}`;
-}
 export async function writeRoleRunState(runDirectory, record) {
     const payload = { ...record, runDirectory };
     await writeFile(join(runDirectory, RUN_STATE_FILE), `${JSON.stringify(payload, null, 2)}\n`, "utf8");
@@ -140,7 +115,7 @@ async function readRoleRunStateRaw(runDirectory) {
         // failure (EISDIR, EACCES, ...) or a JSON.parse SyntaxError on a present
         // file is genuine infrastructure/data damage and must keep its own
         // identity — callers route it through the controlled-failure seam
-        // (markRunRunning/markRunResumable/markRunTerminal/recordCurrentCourt)
+        // (markRunRunning/markRunTerminal/recordCurrentCourt)
         // instead of it being relabeled "run state missing" (#836).
         if (errorCodeOf(error) === "ENOENT")
             return undefined;
@@ -199,17 +174,6 @@ async function readRoleRunStateDisk(runDirectory) {
             ? { sessionFile: rewriteRunDirectoryPathValue(record.sessionFile, storedRunDirectory, runDirectory) }
             : {}),
     };
-    let resumable;
-    if (record.resumable !== undefined && record.resumable !== null) {
-        if (isRecord(record.resumable)) {
-            const r = record.resumable;
-            if (r.httpStatus === 429 &&
-                typeof r.provider === "string" &&
-                isV1ResumableProvider(r.provider)) {
-                resumable = { httpStatus: 429, provider: r.provider };
-            }
-        }
-    }
     const phase = record.phase === "plan" || record.phase === "apply"
         ? record.phase
         : undefined;
@@ -224,7 +188,6 @@ async function readRoleRunStateDisk(runDirectory) {
         admittedRequestPath: rewriteRunDirectoryPathValue(record.admittedRequestPath, storedRunDirectory, runDirectory),
         principalWire,
         ...(phase === undefined ? {} : { phase }),
-        ...(resumable === undefined ? {} : { resumable }),
         ...(currentCourt === undefined ? {} : { currentCourt }),
     };
 }
@@ -242,7 +205,6 @@ async function writeRoleRunStateDisk(runDirectory, disk) {
             : { sessionFile: disk.principalWire.sessionFile }),
         admittedRequestPath: disk.admittedRequestPath,
         ...(disk.phase === undefined ? {} : { phase: disk.phase }),
-        ...(disk.resumable === undefined ? {} : { resumable: disk.resumable }),
         ...(disk.currentCourt === undefined ? {} : { currentCourt: disk.currentCourt }),
     };
     await writeFile(join(runDirectory, RUN_STATE_FILE), `${JSON.stringify(payload, null, 2)}\n`, "utf8");
@@ -264,7 +226,6 @@ function materializeRoleRunFromDisk(disk, authority) {
                 runDirectory: disk.runDirectory,
                 admittedRequestPath: disk.admittedRequestPath,
                 ...(disk.phase === undefined ? {} : { phase: disk.phase }),
-                ...(disk.resumable === undefined ? {} : { resumable: disk.resumable }),
             },
         };
     }
@@ -328,20 +289,10 @@ export async function markRunRunning(runDirectory, effectiveModel, effectiveEngi
     if (current === undefined) {
         throw new Error("cannot mark running: run state missing");
     }
-    // Omit resumable while a writer is active. Principal wire is passed through uninterpreted.
+    // Principal wire is passed through uninterpreted.
     // Preserve open currentCourt across running transitions (#637).
-    await writeRoleRunStateDisk(runDirectory, {
-        runId: current.runId,
-        role: current.role,
-        state: "running",
-        bookKey: current.bookKey,
-        projectRoot: current.projectRoot,
-        runDirectory: current.runDirectory,
-        admittedRequestPath: current.admittedRequestPath,
-        principalWire: current.principalWire,
-        ...(current.phase === undefined ? {} : { phase: current.phase }),
-        ...(current.currentCourt === undefined ? {} : { currentCourt: current.currentCourt }),
-    });
+    // A historical resumable payload on disk is not copied: the parser never kept it.
+    await writeRoleRunStateDisk(runDirectory, { ...current, state: "running" });
     await recordEffectiveInvocationModel(runDirectory, effectiveModel, 
     // Authoritative seat projection: absent engine ⇒ null (delete).
     effectiveEngine === undefined ? null : effectiveEngine, effectiveHost, 
@@ -352,36 +303,13 @@ export async function markRunRunning(runDirectory, effectiveModel, effectiveEngi
             ? null
             : effectiveEngineModel);
 }
-/** @deprecated #416: 429-only resumable marker; kept for historical runs. */
-export async function markRunResumable(runDirectory, observation) {
-    const current = await readRoleRunStateDisk(runDirectory);
-    if (current === undefined) {
-        throw new Error("cannot mark resumable: run state missing");
-    }
-    await writeRoleRunStateDisk(runDirectory, {
-        ...current,
-        state: "resumable",
-        resumable: observation,
-    });
-}
 export async function markRunTerminal(runDirectory) {
     const current = await readRoleRunStateDisk(runDirectory);
     if (current === undefined) {
         throw new Error("cannot mark terminal: run state missing");
     }
     // Preserve the open court's settlement identity after a failed/incomplete turn (#637).
-    await writeRoleRunStateDisk(runDirectory, {
-        runId: current.runId,
-        role: current.role,
-        state: "terminal",
-        bookKey: current.bookKey,
-        projectRoot: current.projectRoot,
-        runDirectory: current.runDirectory,
-        admittedRequestPath: current.admittedRequestPath,
-        principalWire: current.principalWire,
-        ...(current.phase === undefined ? {} : { phase: current.phase }),
-        ...(current.currentCourt === undefined ? {} : { currentCourt: current.currentCourt }),
-    });
+    await writeRoleRunStateDisk(runDirectory, { ...current, state: "terminal" });
 }
 /** Read the open court turn on a retained run, if any (#637). */
 export async function readCurrentCourt(runDirectory) {
@@ -413,26 +341,30 @@ export async function clearCurrentCourt(runDirectory, expectedCourtAttemptId) {
         current.currentCourt.courtAttemptId !== expectedCourtAttemptId) {
         return;
     }
-    await writeRoleRunStateDisk(runDirectory, {
-        runId: current.runId,
-        role: current.role,
-        state: current.state,
-        bookKey: current.bookKey,
-        projectRoot: current.projectRoot,
-        runDirectory: current.runDirectory,
-        admittedRequestPath: current.admittedRequestPath,
-        principalWire: current.principalWire,
-        ...(current.phase === undefined ? {} : { phase: current.phase }),
-        ...(current.resumable === undefined ? {} : { resumable: current.resumable }),
-    });
+    const { currentCourt: _currentCourt, ...rest } = current;
+    await writeRoleRunStateDisk(runDirectory, rest);
 }
 export class RunWriterLeaseHeldError extends Error {
     code = "AK_RUN_WRITER_LEASE_HELD";
-    constructor(message = "role run writer lease is already held") {
+    /**
+     * Why the lease could not be taken, as structured data: the OS errno of the
+     * underlying reclaim failure when there was one. Carried so a consumer
+     * asserts the real cause instead of recognising it in the message text
+     * (质量法: 机器只咬契约，不咬呈现).
+     */
+    causeCode;
+    constructor(message = "role run writer lease is already held", causeCode) {
         super(message);
         this.name = "RunWriterLeaseHeldError";
+        if (causeCode !== undefined)
+            this.causeCode = causeCode;
     }
 }
+/** The OS errno of a thrown value, when it carries one. */
+function errnoOf(error) {
+    const code = error?.code;
+    return typeof code === "string" || typeof code === "number" ? code : undefined;
+}
 /**
  * True error identity for diagnostics — name/code/message as-is, never a
  * guessed label (failure-honesty constitution).
@@ -681,7 +613,7 @@ export async function acquireRunWriterLease(runDirectory, onCleanupFailure) {
             }
         }
         catch (reclaimError) {
-            throw new RunWriterLeaseHeldError(`stale writer lease reclaim failed at ${lockPath} (autopsy: ${describeAutopsy(lastAutopsy)}): ${describeErrorIdentity(reclaimError)}`);
+            throw new RunWriterLeaseHeldError(`stale writer lease reclaim failed at ${lockPath} (autopsy: ${describeAutopsy(lastAutopsy)}): ${describeErrorIdentity(reclaimError)}`, errnoOf(reclaimError));
         }
         if (reclaimed) {
             reportDiagnostic(`stale writer lease reclaimed at ${lockPath} (holder pid ${lastAutopsy.pid} verified dead): the killed holder may have left an orphaned pi child still writing this run — check for a surviving pi process on this run before continuing`, "stale-reclaimed");
@@ -689,7 +621,7 @@ export async function acquireRunWriterLease(runDirectory, onCleanupFailure) {
     }
     throw new RunWriterLeaseHeldError(lastReclaimFailure !== undefined
         ? `role run writer lease stayed contested at ${lockPath} after ${WRITER_LEASE_RECLAIM_ROUNDS} reclaims (last autopsy: ${describeAutopsy(lastAutopsy)}; last reclaim failure: ${describeErrorIdentity(lastReclaimFailure)})`
-        : `role run writer lease stayed contested at ${lockPath} after ${WRITER_LEASE_RECLAIM_ROUNDS} reclaims (last autopsy: ${describeAutopsy(lastAutopsy)})`);
+        : `role run writer lease stayed contested at ${lockPath} after ${WRITER_LEASE_RECLAIM_ROUNDS} reclaims (last autopsy: ${describeAutopsy(lastAutopsy)})`, lastReclaimFailure === undefined ? undefined : errnoOf(lastReclaimFailure));
 }
 /**
  * Locate a Role run directory by run ID under the ledger books home.
@@ -1096,7 +1028,6 @@ async function loadResumableRunRecord(home, runId, authority) {
     return {
         run,
         principal,
-        ...(run.resumable === undefined ? {} : { observation: run.resumable }),
         admittedFields: {
             instruction,
             instructionEmpty,
@@ -1152,7 +1083,6 @@ function seatLoadedResult(loaded, admitted) {
     return {
         admitted,
         run: loaded.run,
-        ...(loaded.observation === undefined ? {} : { observation: loaded.observation }),
     };
 }
 export async function peekRoleRunRole(home, runId) {