@mobrienv/autoloop-harness 0.8.0 → 0.9.2

package/dist/stop.js

@@ -48,6 +48,31 @@ export function stopBackendFailed(loop, iteration, output) {
     registryStop(loop, iteration, "backend_failed");
     return { iterations: iteration, stopReason: "backend_failed" };
 }
+/**
+ * Stop with a typed backend-error reason (rate_limited / quota_exhausted /
+ * auth_failed / transient_error) instead of a generic backend_failed, so the
+ * disposition reflects an availability/auth/quota issue rather than an agent
+ * failure — and downstream (retry ladder, quarantine) can key off it.
+ */
+export function stopBackendErrorClass(loop, iteration, reason, output) {
+    log(loop, "error", `loop stop reason=${reason} iteration=${iteration}`);
+    loop.onEvent?.({
+        type: "progress",
+        runId: loop.runtime.runId,
+        iteration,
+        recentEvent: "loop.stop",
+        allowedRoles: [],
+        outcome: `stop:${reason}`,
+    });
+    loop.onEvent?.({ type: "failure.diagnostic", output, stopReason: reason });
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iteration), "loop.stop", jsonField("reason", reason) +
+        ", " +
+        jsonField("iteration", String(iteration)) +
+        ", " +
+        jsonField("output_tail", lastNChars(output, 500)));
+    registryStop(loop, iteration, reason);
+    return { iterations: iteration, stopReason: reason };
+}
 export function stopBackendTimeout(loop, iteration, output) {
     log(loop, "error", `loop stop reason=backend_timeout iteration=${iteration}`);
     loop.onEvent?.({
@@ -135,6 +160,87 @@ export function stopMaxRuntime(loop, completed, elapsedMs, maxRuntimeMs, outputT
     registryStop(loop, completed, "max_runtime");
     return { iterations: completed, stopReason: "max_runtime" };
 }
+/**
+ * Fail-closed stop for an UNKNOWN metareview verdict under `on_error = hold`.
+ * The reviewer gave no trustworthy signal, so the loop halts and raises
+ * attention (failure.diagnostic + notify-class "failed") instead of silently
+ * advancing — a human decides whether to resume.
+ */
+export function stopReviewUnknown(loop, iteration, reasoning) {
+    log(loop, "warn", `loop stop reason=review_unknown iteration=${iteration} detail=${reasoning}`);
+    loop.onEvent?.({
+        type: "progress",
+        runId: loop.runtime.runId,
+        iteration,
+        recentEvent: "loop.stop",
+        allowedRoles: [],
+        outcome: "stop:review_unknown",
+    });
+    loop.onEvent?.({
+        type: "failure.diagnostic",
+        output: `Metareview returned UNKNOWN and held the loop: ${reasoning}`,
+        stopReason: "review_unknown",
+    });
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iteration), "loop.stop", jsonField("reason", "review_unknown") +
+        ", " +
+        jsonField("iteration", String(iteration)) +
+        ", " +
+        jsonField("detail", reasoning));
+    registryStop(loop, iteration, "review_unknown");
+    return { iterations: iteration, stopReason: "review_unknown" };
+}
+/**
+ * Escalate a premature quit that exhausted its re-arm budget: stop with a
+ * distinct reason and raise attention rather than silently accepting a
+ * false-finish that left authorized work undone.
+ */
+export function stopPrematureQuit(loop, completed, reasons) {
+    log(loop, "warn", `loop stop reason=premature_quit completed_iterations=${completed} remaining=${reasons.join("; ")}`);
+    loop.onEvent?.({
+        type: "progress",
+        runId: loop.runtime.runId,
+        iteration: completed,
+        recentEvent: "loop.stop",
+        allowedRoles: [],
+        outcome: "stop:premature_quit",
+    });
+    loop.onEvent?.({
+        type: "failure.diagnostic",
+        output: `Premature quit: authorized work remained with no blocker and the re-arm budget was exhausted.\nRemaining:\n- ${reasons.join("\n- ")}`,
+        stopReason: "premature_quit",
+    });
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, "", "loop.stop", jsonField("reason", "premature_quit") +
+        ", " +
+        jsonField("completed_iterations", String(completed)) +
+        ", " +
+        jsonField("remaining", reasons.join("; ")));
+    registryStop(loop, completed, "premature_quit");
+    return { iterations: completed, stopReason: "premature_quit" };
+}
+/**
+ * Stop for a `suspend`-policy hook that fired and could not (or was not
+ * configured to) block in-process. Durable suspend state has already been
+ * written by the hooks engine (`writeSuspendState`); this only journals the
+ * typed stop reason and registry status so `autoloop resume` can pick it up.
+ */
+export function stopSuspended(loop, iteration, reason) {
+    log(loop, "warn", `loop stop reason=suspended iteration=${iteration} detail=${reason}`);
+    loop.onEvent?.({
+        type: "progress",
+        runId: loop.runtime.runId,
+        iteration,
+        recentEvent: "loop.stop",
+        allowedRoles: [],
+        outcome: "stop:suspended",
+    });
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iteration), "loop.stop", jsonField("reason", "suspended") +
+        ", " +
+        jsonField("iteration", String(iteration)) +
+        ", " +
+        jsonField("detail", reason));
+    registryStop(loop, iteration, "suspended");
+    return { iterations: iteration, stopReason: "suspended" };
+}
 export function completeLoop(loop, iteration, reason) {
     log(loop, "info", `loop complete reason=${reason}`);
     appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iteration), "loop.complete", jsonField("reason", reason));

package/dist/stop.js.map

@@ -1 +1 @@
-{"version":3,"file":"stop.js","sourceRoot":"","sources":["../src/stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGtE,MAAM,UAAU,iBAAiB,CAC/B,IAAiB,EACjB,SAAiB;IAEjB,MAAM,SAAS,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;IACrD,GAAG,CACD,IAAI,EACJ,MAAM,EACN,wDAAwD,SAAS,mBAAmB,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAChH,CAAC;IACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;QACzB,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,WAAW;QACxB,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,qBAAqB;KAC/B,CAAC,CAAC;IACH,GAAG,CACD,IAAI,EACJ,MAAM,EACN,4BAA4B,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,wBAAwB,CAC3F,CAAC;IACF,WAAW,CACT,IAAI,CAAC,KAAK,CAAC,WAAW,EACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAClB,EAAE,EACF,WAAW,EACX,SAAS,CAAC,QAAQ,EAAE,gBAAgB,CAAC;QACnC,IAAI;QACJ,SAAS,CAAC,sBAAsB,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI;QACJ,SAAS,CAAC,0BAA0B,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI;QACJ,SAAS,CAAC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CACjE,CAAC;IACF,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAChD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAiB,EACjB,SAAiB,EACjB,MAAc;IAEd,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,6CAA6C,SAAS,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;QACzB,SAAS;QACT,WAAW,EAAE,WAAW;QACxB,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,qBAAqB;KAC/B,CAAC,CAAC;IACH,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,EAAE,oBAAoB;QAC1B,MAAM;QACN,UAAU,EAAE,gBAAgB;KAC7B,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,WAAW,CACT,IAAI,CAAC,KAAK,CAAC,WAAW,EACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAClB,MAAM,CAAC,SAAS,CAAC,EACjB,WAAW,EACX,SAAS,CAAC,QAAQ,EAAE,gBAAgB,CAAC;QACnC,IAAI;QACJ,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI;QACJ,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,CACjC,CAAC;IACF,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAChD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAAiB,EACjB,SAAiB,EACjB,MAAc;IAEd,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,8CAA8C,SAAS,EAAE,CAAC,CAAC;IAC9E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;QACzB,SAAS;QACT,WAAW,EAAE,WAAW;QACxB,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,sBAAsB;KAChC,CAAC,CAAC;IACH,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,EAAE,oBAAoB;QAC1B,MAAM;QACN,UAAU,EAAE,iBAAiB;KAC9B,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,WAAW,CACT,IAAI,CAAC,KAAK,CAAC,WAAW,EACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAClB,MAAM,CAAC,SAAS,CAAC,EACjB,WAAW,EACX,SAAS,CAAC,QAAQ,EAAE,iBAAiB,CAAC;QACpC,IAAI;QACJ,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI;QACJ,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,CACjC,CAAC;IACF,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACjD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,IAAiB,EACjB,SAAiB,EACjB,OAAe;IAEf,GAAG,CACD,IAAI,EACJ,MAAM,EACN,8CAA8C,OAAO,cAAc,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,EAAE,CACtG,CAAC;IACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;QACzB,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,WAAW;QACxB,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IACH,WAAW,CACT,IAAI,CAAC,KAAK,CAAC,WAAW,EACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAClB,EAAE,EACF,WAAW,EACX,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC5B,IAAI;QACJ,SAAS,CAAC,sBAAsB,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI;QACJ,SAAS,CAAC,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI;QACJ,SAAS,CAAC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC,CAC1E,CAAC;IACF,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,IAAiB,EACjB,SAAiB,EACjB,OAAe,EACf,UAAkB;IAElB,GAAG,CACD,IAAI,EACJ,MAAM,EACN,yCAAyC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,UAAU,EAAE,CACzF,CAAC;IACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;QACzB,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,WAAW;QACxB,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,kBAAkB;KAC5B,CAAC,CAAC;IACH,WAAW,CACT,IAAI,CAAC,KAAK,CAAC,WAAW,EACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAClB,EAAE,EACF,WAAW,EACX,SAAS,CAAC,QAAQ,EAAE,aAAa,CAAC;QAChC,IAAI;QACJ,SAAS,CAAC,sBAAsB,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI;QACJ,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI;QACJ,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAChD,CAAC;IACF,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAC7C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,IAAiB,EACjB,SAAiB,EACjB,SAAiB,EACjB,YAAoB,EACpB,UAAmB;IAEnB,GAAG,CACD,IAAI,EACJ,MAAM,EACN,2CAA2C,SAAS,mBAAmB,YAAY,EAAE,CACtF,CAAC;IACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;QACzB,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,WAAW;QACxB,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,kBAAkB;KAC5B,CAAC,CAAC;IACH,WAAW,CACT,IAAI,CAAC,KAAK,CAAC,WAAW,EACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAClB,EAAE,EACF,WAAW,EACX,SAAS,CAAC,QAAQ,EAAE,aAAa,CAAC;QAChC,IAAI;QACJ,SAAS,CAAC,sBAAsB,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI;QACJ,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI;QACJ,SAAS,CAAC,gBAAgB,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QACjD,CAAC,UAAU,KAAK,SAAS;YACvB,CAAC,CAAC,IAAI,GAAG,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC9D,CAAC,CAAC,EAAE,CAAC,CACV,CAAC;IACF,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAC7C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,IAAiB,EACjB,SAAiB,EACjB,MAAc;IAEd,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,wBAAwB,MAAM,EAAE,CAAC,CAAC;IACpD,WAAW,CACT,IAAI,CAAC,KAAK,CAAC,WAAW,EACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAClB,MAAM,CAAC,SAAS,CAAC,EACjB,eAAe,EACf,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAC5B,CAAC;IACF,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AACvD,CAAC"}
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../src/stop.ts"],"names":[],"mappings":"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"}

package/dist/suspend-state.d.ts

@@ -0,0 +1,32 @@
+import { SUSPEND_STATE_SCHEMA_VERSION, type SuspendState } from "@mobrienv/autoloop-core/hooks-schema";
+export type { SuspendState };
+export { SUSPEND_STATE_SCHEMA_VERSION };
+export declare function suspendStatePath(stateDir: string): string;
+export declare function resumeRequestPath(stateDir: string): string;
+/**
+ * Write the suspend state atomically (tmp file + rename) so a reader never
+ * observes a torn write, and journal `hook.suspend` for observability.
+ */
+export declare function writeSuspendState(stateDir: string, state: Omit<SuspendState, "schemaVersion">, journalFile?: string): SuspendState;
+/** Read the durable suspend state, or null when absent/unreadable/invalid. */
+export declare function readSuspendState(stateDir: string): SuspendState | null;
+/** Remove the suspend-state file. No-op if absent. */
+export declare function clearSuspendState(stateDir: string): boolean;
+/** Drop the resume-requested signal file (operator says "go"). */
+export declare function requestResume(stateDir: string): void;
+export declare function resumeRequested(stateDir: string): boolean;
+/** Remove the resume-requested signal file. No-op if absent. */
+export declare function clearResumeRequest(stateDir: string): boolean;
+export interface WaitForResumeOptions {
+    pollMs?: number;
+    /** Abort signal, honoured the same way `ask.ts:awaitHumanResponse` does. */
+    signal?: AbortSignal;
+    /** Optional wall-clock cap in ms; 0/undefined = wait indefinitely. */
+    timeoutMs?: number;
+}
+/**
+ * Block until `resume-requested` appears, the run is aborted, or (if set)
+ * `timeoutMs` elapses. Returns `true` when resumed, `false` on abort/timeout.
+ * Mirrors `ask.ts:awaitHumanResponse`'s signal-aware poll loop.
+ */
+export declare function waitForResume(stateDir: string, opts?: WaitForResumeOptions): Promise<boolean>;

package/dist/suspend-state.js

@@ -0,0 +1,104 @@
+// Durable suspend/resume signalling for the lifecycle hooks engine.
+//
+// `on_error = "suspend"` writes a versioned `.autoloop/suspend-state.json`
+// and (for in-process phases) blocks the harness until an operator drops
+// `.autoloop/resume-requested` (or `autoloop hooks clear-suspend` / `resume`
+// clears it). This lets a hook halt the loop for out-of-band remediation
+// (e.g. a human approval gate) without losing the run's position.
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import { jsonField } from "@mobrienv/autoloop-core";
+import { isSuspendState, SUSPEND_STATE_SCHEMA_VERSION, } from "@mobrienv/autoloop-core/hooks-schema";
+import { appendEvent } from "@mobrienv/autoloop-core/journal";
+export { SUSPEND_STATE_SCHEMA_VERSION };
+export function suspendStatePath(stateDir) {
+    return join(stateDir, "suspend-state.json");
+}
+export function resumeRequestPath(stateDir) {
+    return join(stateDir, "resume-requested");
+}
+/**
+ * Write the suspend state atomically (tmp file + rename) so a reader never
+ * observes a torn write, and journal `hook.suspend` for observability.
+ */
+export function writeSuspendState(stateDir, state, journalFile) {
+    mkdirSync(stateDir, { recursive: true });
+    const full = {
+        schemaVersion: SUSPEND_STATE_SCHEMA_VERSION,
+        ...state,
+    };
+    const path = suspendStatePath(stateDir);
+    const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
+    writeFileSync(tmp, `${JSON.stringify(full, null, 2)}\n`, "utf-8");
+    renameSync(tmp, path);
+    if (journalFile) {
+        appendEvent(journalFile, state.runId, state.iteration ? String(state.iteration) : "", "hook.suspend", jsonField("phase", state.phase) +
+            ", " +
+            jsonField("reason", state.reason) +
+            ", " +
+            jsonField("hook_command", state.hookCommand) +
+            ", " +
+            jsonField("resume_iteration", String(state.resumeIteration)));
+    }
+    return full;
+}
+/** Read the durable suspend state, or null when absent/unreadable/invalid. */
+export function readSuspendState(stateDir) {
+    const path = suspendStatePath(stateDir);
+    if (!existsSync(path))
+        return null;
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf-8"));
+        return isSuspendState(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Remove the suspend-state file. No-op if absent. */
+export function clearSuspendState(stateDir) {
+    const path = suspendStatePath(stateDir);
+    if (!existsSync(path))
+        return false;
+    rmSync(path, { force: true });
+    return true;
+}
+/** Drop the resume-requested signal file (operator says "go"). */
+export function requestResume(stateDir) {
+    mkdirSync(dirname(resumeRequestPath(stateDir)), { recursive: true });
+    writeFileSync(resumeRequestPath(stateDir), `${new Date().toISOString()}\n`);
+}
+export function resumeRequested(stateDir) {
+    return existsSync(resumeRequestPath(stateDir));
+}
+/** Remove the resume-requested signal file. No-op if absent. */
+export function clearResumeRequest(stateDir) {
+    const path = resumeRequestPath(stateDir);
+    if (!existsSync(path))
+        return false;
+    rmSync(path, { force: true });
+    return true;
+}
+/**
+ * Block until `resume-requested` appears, the run is aborted, or (if set)
+ * `timeoutMs` elapses. Returns `true` when resumed, `false` on abort/timeout.
+ * Mirrors `ask.ts:awaitHumanResponse`'s signal-aware poll loop.
+ */
+export async function waitForResume(stateDir, opts = {}) {
+    const pollMs = opts.pollMs && opts.pollMs > 0 ? opts.pollMs : 1000;
+    const deadline = opts.timeoutMs && opts.timeoutMs > 0 ? Date.now() + opts.timeoutMs : null;
+    for (;;) {
+        if (opts.signal?.aborted)
+            return false;
+        if (resumeRequested(stateDir))
+            return true;
+        if (deadline !== null && Date.now() >= deadline)
+            return false;
+        const wait = deadline !== null ? Math.min(pollMs, deadline - Date.now()) : pollMs;
+        await sleep(Math.max(0, wait));
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=suspend-state.js.map

package/dist/suspend-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suspend-state.js","sourceRoot":"","sources":["../src/suspend-state.ts"],"names":[],"mappings":"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"}

package/dist/tamper.d.ts

@@ -0,0 +1,21 @@
+import type { LoopContext } from "./types.js";
+export interface TamperViolation {
+    id: string;
+    detail: string;
+}
+export interface TamperResult {
+    ran: boolean;
+    passed: boolean;
+    violations: TamperViolation[];
+}
+/** Heuristic test-file detector across common ecosystems. */
+export declare function isTestFile(path: string): boolean;
+/**
+ * Anti-reward-hack tamper screen. With `screen_test_tamper` on, a test-backed
+ * done-claim is blocked when the run touched gating tests or inserted
+ * tamper patterns on test paths — harness-side and maker-uninfluenceable.
+ * Returns `{ ran: false, passed: true }` when disabled or outside a git tree.
+ */
+export declare function runTamperScreen(loop: LoopContext, iteration: number): TamperResult;
+/** Re-inject a tamper-screen failure as operator guidance. */
+export declare function reinjectTamperFailure(loop: LoopContext, iteration: number, result: TamperResult): void;

package/dist/tamper.js

@@ -0,0 +1,88 @@
+import { jsonBool, jsonField, jsonFieldRaw } from "@mobrienv/autoloop-core";
+import { appendEvent, appendOperatorEvent, } from "@mobrienv/autoloop-core/journal";
+import { changedFiles, collectAddedLines, isGitRepo, } from "./git-diff.js";
+const MAX_SAMPLE = 10;
+/** Heuristic test-file detector across common ecosystems. */
+export function isTestFile(path) {
+    return (/\.(test|spec)\.[cm]?[jt]sx?$/.test(path) ||
+        /(^|\/)test_[^/]*\.py$/.test(path) ||
+        /_test\.(py|go|rb)$/.test(path) ||
+        /(^|\/)(tests?|__tests__|spec)\//.test(path) ||
+        /Test\.(java|kt|cs)$/.test(path) ||
+        /_spec\.rb$/.test(path));
+}
+// Patterns that, when introduced on a test path, weaken or short-circuit the
+// gating tests. Each is scoped to added lines inside test files.
+const TAMPER_PATTERNS = [
+    [
+        "test_skip_or_only",
+        /(\b(it|describe|test)\.(only|skip)\b|\bx(it|describe)\b|\bf(it|describe)\b|@pytest\.mark\.(skip|xfail)|\bunittest\.skip\b|#\[ignore\])/,
+    ],
+    [
+        "test_early_exit",
+        /\b(process\.exit|os\._?exit|sys\.exit|System\.exit)\s*\(/,
+    ],
+    [
+        "tautological_assert",
+        /(expect\(\s*(true|1|"")\s*\)\s*\.\s*toBe(Truthy)?\(|assert\s+true\b|assertTrue\(\s*true\s*\)|assert\s+1\s*==\s*1\b|expect\(\s*true\s*\)\.toBeTruthy\()/i,
+    ],
+];
+function sample(items) {
+    return items.slice(0, MAX_SAMPLE).join("\n");
+}
+/**
+ * Anti-reward-hack tamper screen. With `screen_test_tamper` on, a test-backed
+ * done-claim is blocked when the run touched gating tests or inserted
+ * tamper patterns on test paths — harness-side and maker-uninfluenceable.
+ * Returns `{ ran: false, passed: true }` when disabled or outside a git tree.
+ */
+export function runTamperScreen(loop, iteration) {
+    if (!loop.acceptance.screenTestTamper) {
+        return { ran: false, passed: true, violations: [] };
+    }
+    const workDir = loop.paths.workDir;
+    const iter = String(iteration);
+    if (!isGitRepo(workDir)) {
+        // No baseline to diff against — cannot screen deterministically.
+        appendEvent(loop.paths.journalFile, loop.runtime.runId, iter, "tamper.result", jsonFieldRaw("passed", jsonBool(true)) +
+            ", " +
+            jsonField("skipped", "no_git"));
+        return { ran: true, passed: true, violations: [] };
+    }
+    const violations = [];
+    // 1. Deterministic: did the gating test files change this run?
+    const touchedTests = changedFiles(workDir).filter(isTestFile);
+    if (touchedTests.length) {
+        violations.push({
+            id: "test_files_changed",
+            detail: `Test files were modified during the run that claims completion:\n${sample(touchedTests)}`,
+        });
+    }
+    // 2. Tamper patterns inserted on test paths.
+    const addedInTests = collectAddedLines(workDir).filter((l) => isTestFile(l.file));
+    for (const [id, re] of TAMPER_PATTERNS) {
+        const hits = addedInTests.filter((l) => re.test(l.text));
+        if (hits.length)
+            violations.push({
+                id,
+                detail: `${id} in test files:\n${sample(hits.map((l) => `  ${l.file}: ${l.text.trim()}`))}`,
+            });
+    }
+    const passed = violations.length === 0;
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, iter, "tamper.result", jsonFieldRaw("passed", jsonBool(passed)) +
+        ", " +
+        jsonField("violations", violations.map((v) => v.id).join(",")));
+    return { ran: true, passed, violations };
+}
+/** Re-inject a tamper-screen failure as operator guidance. */
+export function reinjectTamperFailure(loop, iteration, result) {
+    const detail = result.violations
+        .map((v) => `- [${v.id}] ${v.detail}`)
+        .join("\n\n");
+    const message = "Completion was blocked: the test-tamper screen detected that gating " +
+        "tests were changed or weakened this run. Do not modify the tests that " +
+        "verify the work; make the implementation pass the existing tests.\n\n" +
+        detail;
+    appendOperatorEvent(loop.paths.journalFile, loop.runtime.runId, String(iteration), "operator.guidance", message);
+}
+//# sourceMappingURL=tamper.js.map

package/dist/tamper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tamper.js","sourceRoot":"","sources":["../src/tamper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EACL,WAAW,EACX,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,YAAY,EACZ,iBAAiB,EACjB,SAAS,GACV,MAAM,eAAe,CAAC;AAcvB,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,6DAA6D;AAC7D,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,CACL,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC;QACzC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;QAClC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/B,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5C,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;QAChC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CACxB,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,iEAAiE;AACjE,MAAM,eAAe,GAA4B;IAC/C;QACE,mBAAmB;QACnB,wIAAwI;KACzI;IACD;QACE,iBAAiB;QACjB,0DAA0D;KAC3D;IACD;QACE,qBAAqB;QACrB,yJAAyJ;KAC1J;CACF,CAAC;AAEF,SAAS,MAAM,CAAC,KAAe;IAC7B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAiB,EACjB,SAAiB;IAEjB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC;QACtC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACtD,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,iEAAiE;QACjE,WAAW,CACT,IAAI,CAAC,KAAK,CAAC,WAAW,EACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAClB,IAAI,EACJ,eAAe,EACf,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI;YACJ,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,CACjC,CAAC;QACF,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,UAAU,GAAsB,EAAE,CAAC;IAEzC,+DAA+D;IAC/D,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9D,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;QACxB,UAAU,CAAC,IAAI,CAAC;YACd,EAAE,EAAE,oBAAoB;YACxB,MAAM,EAAE,oEAAoE,MAAM,CAAC,YAAY,CAAC,EAAE;SACnG,CAAC,CAAC;IACL,CAAC;IAED,6CAA6C;IAC7C,MAAM,YAAY,GAAgB,iBAAiB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACxE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CACnB,CAAC;IACF,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,IAAI,IAAI,CAAC,MAAM;YACb,UAAU,CAAC,IAAI,CAAC;gBACd,EAAE;gBACF,MAAM,EAAE,GAAG,EAAE,oBAAoB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE;aAC5F,CAAC,CAAC;IACP,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC;IACvC,WAAW,CACT,IAAI,CAAC,KAAK,CAAC,WAAW,EACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAClB,IAAI,EACJ,eAAe,EACf,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI;QACJ,SAAS,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CACjE,CAAC;IACF,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAC3C,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,qBAAqB,CACnC,IAAiB,EACjB,SAAiB,EACjB,MAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU;SAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;SACrC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChB,MAAM,OAAO,GACX,sEAAsE;QACtE,wEAAwE;QACxE,uEAAuE;QACvE,MAAM,CAAC;IACT,mBAAmB,CACjB,IAAI,CAAC,KAAK,CAAC,WAAW,EACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAClB,MAAM,CAAC,SAAS,CAAC,EACjB,mBAAmB,EACnB,OAAO,CACR,CAAC;AACJ,CAAC"}