looply-cli 0.5.10 → 0.5.12

package/dist/maintenance-tick.d.ts

@@ -0,0 +1,51 @@
+import { type MaintenancePlan, type MaintenanceSettings, type PackageRootFacts } from '@looply/core';
+/**
+ * THE WEEKLY MAINTENANCE PLAN, MADE BY THE DAEMON THAT DRIVES THE REPOSITORY.
+ *
+ * On the daemon's five-minute settings cadence: pull the project's maintenance
+ * setting (set in AutoRyn or the console) into `maintenance-settings.json`, and
+ * when the weekly slot has passed and no plan was made since, read the repository
+ * (`maintenance-facts.ts`), plan (`planMaintenance`), and propose the plan to the
+ * server. AutoRyn turns proposals into tickets and goals; this machine never
+ * creates a goal by itself.
+ *
+ * ⚠️ ONE PLAN PER SLOT. `maintenance-state.json` records when the last plan was
+ * proposed; a failure to reach the server leaves it unrecorded, so the next
+ * cadence tries again — but reading the repository again costs a few `npm`
+ * calls, so a failed plan waits 30 minutes before the next try.
+ *
+ * ⚠️ NEVER TWO AT ONCE, AND NEVER BLOCKING. The plan runs in the background of
+ * the cadence; a second cadence that finds one going does nothing.
+ */
+export declare const MAINTENANCE_SETTINGS_FILE = "maintenance-settings.json";
+export declare const MAINTENANCE_STATE_FILE = "maintenance-state.json";
+export interface MaintenanceState {
+    /** When the last plan reached the server (ms). */
+    lastPlannedAt: number | null;
+    week: string | null;
+    proposed: number;
+    skipped: string[];
+    /** The last failure and when, for a retry delay and a person reading the file. */
+    lastFailureAt: number | null;
+    lastFailure: string | null;
+}
+/** The project's maintenance setting as this machine last heard it; null when off or never heard. */
+export declare function readMaintenanceSettings(stateDir: string): MaintenanceSettings | null;
+export declare function readMaintenanceState(stateDir: string): MaintenanceState;
+export interface MaintenanceTickDeps {
+    stateDir: string;
+    fetchSettings(): Promise<unknown>;
+    propose(body: {
+        week: string;
+        items: MaintenancePlan['items'];
+    }): Promise<unknown>;
+    gather(opts: {
+        deadCode: boolean;
+    }): Promise<PackageRootFacts[]>;
+    log(line: string): void;
+    now(): number;
+}
+export type MaintenanceTickOutcome = 'off' | 'not-due' | 'busy' | 'waiting-retry' | 'proposed' | 'failed';
+/** One cadence: refresh the setting, plan when due. Never throws. Returns what happened (tests). */
+export declare function makeMaintenanceTick(deps: MaintenanceTickDeps): () => Promise<MaintenanceTickOutcome>;
+//# sourceMappingURL=maintenance-tick.d.ts.map

package/dist/maintenance-tick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance-tick.d.ts","sourceRoot":"","sources":["../src/maintenance-tick.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AAGtB;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AACrE,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAG/D,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kFAAkF;IAClF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAkBD,qGAAqG;AACrG,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAKpF;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAWvE;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnF,MAAM,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACjE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,IAAI,MAAM,CAAC;CACf;AAED,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,eAAe,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE1G,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,OAAO,CAAC,sBAAsB,CAAC,CA+EpG"}

package/dist/maintenance-tick.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAINTENANCE_STATE_FILE = exports.MAINTENANCE_SETTINGS_FILE = void 0;
+exports.readMaintenanceSettings = readMaintenanceSettings;
+exports.readMaintenanceState = readMaintenanceState;
+exports.makeMaintenanceTick = makeMaintenanceTick;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const core_1 = require("@looply/core");
+const server_client_1 = require("./server-client");
+/**
+ * THE WEEKLY MAINTENANCE PLAN, MADE BY THE DAEMON THAT DRIVES THE REPOSITORY.
+ *
+ * On the daemon's five-minute settings cadence: pull the project's maintenance
+ * setting (set in AutoRyn or the console) into `maintenance-settings.json`, and
+ * when the weekly slot has passed and no plan was made since, read the repository
+ * (`maintenance-facts.ts`), plan (`planMaintenance`), and propose the plan to the
+ * server. AutoRyn turns proposals into tickets and goals; this machine never
+ * creates a goal by itself.
+ *
+ * ⚠️ ONE PLAN PER SLOT. `maintenance-state.json` records when the last plan was
+ * proposed; a failure to reach the server leaves it unrecorded, so the next
+ * cadence tries again — but reading the repository again costs a few `npm`
+ * calls, so a failed plan waits 30 minutes before the next try.
+ *
+ * ⚠️ NEVER TWO AT ONCE, AND NEVER BLOCKING. The plan runs in the background of
+ * the cadence; a second cadence that finds one going does nothing.
+ */
+exports.MAINTENANCE_SETTINGS_FILE = 'maintenance-settings.json';
+exports.MAINTENANCE_STATE_FILE = 'maintenance-state.json';
+const RETRY_AFTER_MS = 30 * 60_000;
+function readJson(path) {
+    try {
+        const v = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+        return typeof v === 'object' && v !== null && !Array.isArray(v) ? v : null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeJson(path, dir, value) {
+    (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    const tmp = `${path}.${process.pid}.tmp`;
+    (0, node_fs_1.writeFileSync)(tmp, JSON.stringify(value, null, 2) + '\n', 'utf8');
+    (0, node_fs_1.renameSync)(tmp, path);
+}
+/** The project's maintenance setting as this machine last heard it; null when off or never heard. */
+function readMaintenanceSettings(stateDir) {
+    const raw = readJson((0, node_path_1.join)(stateDir, exports.MAINTENANCE_SETTINGS_FILE));
+    if (raw === null || raw['settings'] === null || raw['settings'] === undefined)
+        return null;
+    const v = (0, core_1.validateMaintenanceSettings)(raw['settings']);
+    return v.ok ? v.settings : null;
+}
+function readMaintenanceState(stateDir) {
+    const raw = readJson((0, node_path_1.join)(stateDir, exports.MAINTENANCE_STATE_FILE)) ?? {};
+    const num = (k) => (typeof raw[k] === 'number' && Number.isFinite(raw[k]) ? raw[k] : null);
+    return {
+        lastPlannedAt: num('lastPlannedAt'),
+        week: typeof raw['week'] === 'string' ? raw['week'] : null,
+        proposed: num('proposed') ?? 0,
+        skipped: Array.isArray(raw['skipped']) ? raw['skipped'].filter((s) => typeof s === 'string') : [],
+        lastFailureAt: num('lastFailureAt'),
+        lastFailure: typeof raw['lastFailure'] === 'string' ? raw['lastFailure'] : null,
+    };
+}
+/** One cadence: refresh the setting, plan when due. Never throws. Returns what happened (tests). */
+function makeMaintenanceTick(deps) {
+    let running = false;
+    let reportedPullFailure = false;
+    const pull = async () => {
+        let body;
+        try {
+            body = await deps.fetchSettings();
+        }
+        catch (e) {
+            if (!(e instanceof server_client_1.ServerError && (e.isOffline || e.isAuth)) && !reportedPullFailure) {
+                reportedPullFailure = true;
+                deps.log(`maint   : could not refresh the maintenance setting — ${e.message}`);
+            }
+            return;
+        }
+        reportedPullFailure = false;
+        const b = body;
+        if (typeof b !== 'object' || b === null || !('settings' in b))
+            return;
+        let settings = null;
+        if (b.settings !== null) {
+            const v = (0, core_1.validateMaintenanceSettings)(b.settings);
+            if (!v.ok) {
+                deps.log(`maint   : the server sent a maintenance setting this build refuses (${v.key}: ${v.because})`);
+                return;
+            }
+            settings = v.settings;
+        }
+        const path = (0, node_path_1.join)(deps.stateDir, exports.MAINTENANCE_SETTINGS_FILE);
+        const before = readJson(path);
+        if (before !== null && JSON.stringify(before['settings'] ?? null) === JSON.stringify(settings))
+            return;
+        try {
+            writeJson(path, deps.stateDir, { settings, updatedAt: typeof b.updatedAt === 'string' ? b.updatedAt : null, fetchedAt: new Date(deps.now()).toISOString() });
+            deps.log(`maint   : maintenance is ${settings?.enabled ? 'on' : 'off'} for this project`);
+        }
+        catch (e) {
+            deps.log(`maint   : could not write the maintenance setting (${e.message})`);
+        }
+    };
+    const plan = async (settings, week) => {
+        const state = readMaintenanceState(deps.stateDir);
+        const save = (patch) => {
+            try {
+                writeJson((0, node_path_1.join)(deps.stateDir, exports.MAINTENANCE_STATE_FILE), deps.stateDir, { ...state, ...patch });
+            }
+            catch {
+                /* the next cadence plans again; a duplicate plan is upserted, not doubled */
+            }
+        };
+        try {
+            deps.log(`maint   : making this week's maintenance plan (${week})`);
+            const facts = await deps.gather({ deadCode: settings.deadCode.enabled });
+            const result = (0, core_1.planMaintenance)({ settings, week, roots: facts });
+            await deps.propose({ week, items: result.items });
+            save({ lastPlannedAt: deps.now(), week, proposed: result.items.length, skipped: result.skipped.slice(0, 50), lastFailure: null, lastFailureAt: null });
+            deps.log(`maint   : proposed ${result.items.length} maintenance goal(s) for ${week}${result.skipped.length ? `; ${result.skipped.length} thing(s) left for later (${exports.MAINTENANCE_STATE_FILE})` : ''}`);
+            return 'proposed';
+        }
+        catch (e) {
+            const why = e.message.slice(0, 300);
+            save({ lastFailureAt: deps.now(), lastFailure: why });
+            deps.log(`maint   : the maintenance plan failed — ${why}; trying again in 30 minutes`);
+            return 'failed';
+        }
+    };
+    return async () => {
+        await pull();
+        const settings = readMaintenanceSettings(deps.stateDir);
+        const state = readMaintenanceState(deps.stateDir);
+        const due = (0, core_1.maintenanceDue)(settings, state.lastPlannedAt, deps.now());
+        if (settings === null || !settings.enabled)
+            return 'off';
+        if (!due.due)
+            return 'not-due';
+        if (running)
+            return 'busy';
+        if (state.lastFailureAt !== null && deps.now() - state.lastFailureAt < RETRY_AFTER_MS)
+            return 'waiting-retry';
+        running = true;
+        try {
+            return await plan(settings, due.week);
+        }
+        finally {
+            running = false;
+        }
+    };
+}
+//# sourceMappingURL=maintenance-tick.js.map

package/dist/maintenance-tick.js.map

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

package/dist/planner-timeouts.d.ts

@@ -0,0 +1,14 @@
+/**
+ * HOW MANY TIMES ONE PLANNING HAS TIMED OUT ON THIS MACHINE — the count `goal-compile.ts`'s
+ * `compileTierFor` turns into a longer limit and a smaller plan (TAB-B-57, 2026-10-16: two Starts
+ * lost to a ten-minute planner timeout before the third compiled).
+ *
+ * Keyed by whatever the caller names one planning by (`<id>@<version>`), in the PROJECT's state
+ * directory, so a later Start placed in another checkout still knows. Separate from the compiler
+ * on purpose: the compiler writes nothing.
+ */
+export declare const PLANNER_TIMEOUTS_FILE = "planner-timeouts.json";
+export declare function plannerTimeoutsFor(stateDir: string, key: string): number;
+/** Count one more timeout for `key`; returns the new count. Never throws: the count only lengthens a limit. */
+export declare function notePlannerTimeout(stateDir: string, key: string): number;
+//# sourceMappingURL=planner-timeouts.d.ts.map

package/dist/planner-timeouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner-timeouts.d.ts","sourceRoot":"","sources":["../src/planner-timeouts.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQxE;AAED,+GAA+G;AAC/G,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAmBxE"}

package/dist/planner-timeouts.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLANNER_TIMEOUTS_FILE = void 0;
+exports.plannerTimeoutsFor = plannerTimeoutsFor;
+exports.notePlannerTimeout = notePlannerTimeout;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * HOW MANY TIMES ONE PLANNING HAS TIMED OUT ON THIS MACHINE — the count `goal-compile.ts`'s
+ * `compileTierFor` turns into a longer limit and a smaller plan (TAB-B-57, 2026-10-16: two Starts
+ * lost to a ten-minute planner timeout before the third compiled).
+ *
+ * Keyed by whatever the caller names one planning by (`<id>@<version>`), in the PROJECT's state
+ * directory, so a later Start placed in another checkout still knows. Separate from the compiler
+ * on purpose: the compiler writes nothing.
+ */
+exports.PLANNER_TIMEOUTS_FILE = 'planner-timeouts.json';
+function plannerTimeoutsFor(stateDir, key) {
+    try {
+        const raw = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(stateDir, exports.PLANNER_TIMEOUTS_FILE), 'utf8'));
+        const n = raw[key];
+        return typeof n === 'number' && Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+/** Count one more timeout for `key`; returns the new count. Never throws: the count only lengthens a limit. */
+function notePlannerTimeout(stateDir, key) {
+    const path = (0, node_path_1.join)(stateDir, exports.PLANNER_TIMEOUTS_FILE);
+    try {
+        let raw = {};
+        try {
+            raw = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+        }
+        catch {
+            raw = {};
+        }
+        const next = (typeof raw[key] === 'number' ? raw[key] : 0) + 1;
+        raw[key] = next;
+        (0, node_fs_1.mkdirSync)(stateDir, { recursive: true });
+        const tmp = `${path}.${process.pid}.tmp`;
+        (0, node_fs_1.writeFileSync)(tmp, `${JSON.stringify(raw)}\n`, 'utf8');
+        (0, node_fs_1.renameSync)(tmp, path);
+        return next;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=planner-timeouts.js.map

package/dist/planner-timeouts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner-timeouts.js","sourceRoot":"","sources":["../src/planner-timeouts.ts"],"names":[],"mappings":";;;AAeA,gDAQC;AAGD,gDAmBC;AA7CD,qCAA6E;AAC7E,yCAAiC;AAEjC;;;;;;;;GAQG;AAEU,QAAA,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D,SAAgB,kBAAkB,CAAC,QAAgB,EAAE,GAAW;IAC9D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,IAAA,gBAAI,EAAC,QAAQ,EAAE,6BAAqB,CAAC,EAAE,MAAM,CAAC,CAA4B,CAAC;QAC/G,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,+GAA+G;AAC/G,SAAgB,kBAAkB,CAAC,QAAgB,EAAE,GAAW;IAC9D,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,QAAQ,EAAE,6BAAqB,CAAC,CAAC;IACnD,IAAI,CAAC;QACH,IAAI,GAAG,GAA2B,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAA2B,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,GAAG,EAAE,CAAC;QACX,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/D,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QAChB,IAAA,mBAAS,EAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;QACzC,IAAA,uBAAa,EAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvD,IAAA,oBAAU,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/run-cmd.d.ts

@@ -6,6 +6,7 @@ import { type RepairContext, type RunSummary } from './round-runner';
 import type { AnsweredQuestionView, PartialQuestionBody } from '@looply/core';
 import { type ApprovalResolutionContext } from './approval-resolution';
 import { type RepositorySpan } from '@looply/core';
+import type { EnvironmentCode } from '@looply/core';
 import { type GovernedActionResultContext } from './governed-run';
 /**
  * The composition root for `looply run`.
@@ -154,6 +155,11 @@ export declare class RunRefused extends Error {
      * the mark so the daemon can settle the pursuit with facts, not a sentence.
      */
     readonly delivery?: RunDelivery | undefined;
+    /**
+     * Which machine fault, on an `environment` refusal only — carried to the mark so the
+     * controller's hold names it (`environment-hold.ts`).
+     */
+    readonly environment?: EnvironmentCode | undefined;
     /**
      * The same refusal, for a machine.
      *
@@ -178,7 +184,12 @@ export declare class RunRefused extends Error {
      * delivering run, the commit, and each required step's outcome. Carried to
      * the mark so the daemon can settle the pursuit with facts, not a sentence.
      */
-    delivery?: RunDelivery | undefined);
+    delivery?: RunDelivery | undefined, 
+    /**
+     * Which machine fault, on an `environment` refusal only — carried to the mark so the
+     * controller's hold names it (`environment-hold.ts`).
+     */
+    environment?: EnvironmentCode | undefined);
 }
 /** What `looply run` exits with when it refuses for good. */
 export declare const EXIT_REFUSED = 3;

package/dist/run-cmd.d.ts.map

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

package/dist/run-cmd.js

@@ -63,9 +63,13 @@ const programme_mode_1 = require("./programme-mode");
 const partial_asker_1 = require("./partial-asker");
 const goal_ownership_1 = require("./goal-ownership");
 const goal_compile_1 = require("./goal-compile");
+const planner_timeouts_1 = require("./planner-timeouts");
 const plan_recovery_1 = require("./plan-recovery");
 const goal_execution_evidence_1 = require("./goal-execution-evidence");
 const goal_reproof_1 = require("./goal-reproof");
+const goal_replay_1 = require("./goal-replay");
+const branch_replay_1 = require("./branch-replay");
+const run_base_2 = require("./run-base");
 const round_records_1 = require("./round-records");
 const goal_gap_1 = require("./goal-gap");
 const goal_adaptive_1 = require("./goal-adaptive");
@@ -128,6 +132,7 @@ class RunRefused extends Error {
     code;
     branch;
     delivery;
+    environment;
     /**
      * The same refusal, for a machine.
      *
@@ -152,11 +157,17 @@ class RunRefused extends Error {
      * delivering run, the commit, and each required step's outcome. Carried to
      * the mark so the daemon can settle the pursuit with facts, not a sentence.
      */
-    delivery) {
+    delivery, 
+    /**
+     * Which machine fault, on an `environment` refusal only — carried to the mark so the
+     * controller's hold names it (`environment-hold.ts`).
+     */
+    environment) {
         super(message);
         this.code = code;
         this.branch = branch;
         this.delivery = delivery;
+        this.environment = environment;
     }
 }
 exports.RunRefused = RunRefused;
@@ -1024,6 +1035,9 @@ async function runLoop(opts) {
      * ⚠️ AN ARROW, for the same flow-analysis reason as `recordDelivery` below.
      */
     const deliveringBranch = async () => {
+        // The branch this goal's work was REBUILT onto, when it was: that is the tree that was proved.
+        if (rebuiltAs !== null)
+            return rebuiltAs.branch;
         if (deliveringRunId === null)
             return branch;
         const cut = (0, run_delivery_1.deliveringBranchOf)((0, lane_claims_1.readLaneClaims)(cwd), deliveringRunId);
@@ -2802,7 +2816,31 @@ async function runLoop(opts) {
      * would put sixty minutes of verifier inside a sixty-minute window. They draw
      * from one budget instead.
      */
-    let verifyBudget = verify_cmd_2.VERIFY_MAX_PER_RUN;
+    /**
+     * THE PLANNING TIER (`goal-compile.ts`, COMPILE_TIERS): after a timed-out planning of this goal
+     * version, a longer limit and a smaller plan, so the worst case stays inside the window. The
+     * verify budget shrinks with the plan — that is what pays for the longer compile.
+     */
+    // PROJECT-scoped: a goal's next Start may be placed in another checkout, and must still know.
+    const plannedTimeouts = binding.kind === 'bound' ? (0, planner_timeouts_1.plannerTimeoutsFor)(projectStateDirPath, `${binding.goal.id}@${binding.goal.version}`) : 0;
+    const compileTier = (0, goal_compile_1.compileTierFor)(plannedTimeouts);
+    const adaptiveTier = (0, goal_compile_1.compileTierFor)(plannedTimeouts, goal_compile_1.ADAPTIVE_COMPILE_TIERS);
+    let compileTimedOut = false;
+    /**
+     * A PLANNER THAT RAN OUT OF TIME IS THE MACHINE'S LIMIT, NOT THE GOAL'S FAULT: the run leaves
+     * with `environment` / `planner_timeout`, so the controller voids this Start (it costs no try),
+     * and the timeout is counted so the next Start plans with the next tier. Null when no planning
+     * timed out in this run — the exit is then whatever it was.
+     */
+    const plannerTimedOut = (message) => {
+        if (!compileTimedOut || binding.kind !== 'bound')
+            return null;
+        const n = (0, planner_timeouts_1.notePlannerTimeout)(projectStateDirPath, `${binding.goal.id}@${binding.goal.version}`);
+        const next = (0, goal_compile_1.compileTierFor)(n);
+        return new RunRefused(`${message} — planning took longer than its limit; the next Start plans with ${Math.round(next.timeoutMs / 60000)} minutes ` +
+            `for at most ${next.maxSteps} steps, and this Start does not count`, 'environment', undefined, undefined, 'planner_timeout');
+    };
+    let verifyBudget = Math.min(verify_cmd_2.VERIFY_MAX_PER_RUN, compileTier.maxSteps);
     /**
      * EVERYTHING A START DOES BEFORE THE RUN, under one guard.
      *
@@ -2882,6 +2920,10 @@ async function runLoop(opts) {
     let deliveringRunId = null;
     // L4b: the commit key 2 confirmed HEAD on, beside the run that delivered it.
     let deliveringSha = null;
+    /** This goal's work, rebuilt onto the base for the goal check (`goal-replay.ts`), when it was. */
+    let rebuiltAs = null;
+    /** Why it could not be rebuilt, when that was tried and failed: what the next revision plans around. */
+    let replayTrouble = null;
     /** F27: the tree this Start's evaluator judged, when a programme moved HEAD to the tree the lane holds. */
     let judged = { kind: 'as-is', because: 'no goal-met check ran' };
     /** The first compile's authority answer, kept so its reason is the acted-on one. */
@@ -2927,11 +2969,16 @@ async function runLoop(opts) {
                         checks: config.gates.map((g) => g.name),
                     }),
             }, {
-                compile: (i) => (0, goal_compile_1.compileGoal)(i, { invoke: planAgent }),
+                compile: async (i) => {
+                    const out = await (0, goal_compile_1.compileGoal)(i, { invoke: planAgent, timeoutMs: compileTier.timeoutMs, maxSteps: compileTier.maxSteps });
+                    if (!out.ok && out.failure === 'timed-out')
+                        compileTimedOut = true;
+                    return out;
+                },
                 // M3-2: checked at the committed tree before any step becomes an item; the compile recorded either way.
                 check: (steps) => (0, compile_check_1.checkCompiledPlan)(steps, compileReaders, compiledAt),
                 log: (line) => log(`compile : ${line}`),
-            }, goal_compile_1.COMPILE_MAX_STEPS);
+            }, compileTier.maxSteps);
             // A step whose citation did not hold is re-planned, an empty plan is asked again as an instruction,
             // and only then does a ticket get one direct step (`plan-recovery.ts`) — never a hand-back.
             const compiled = recovered.compiled;
@@ -3193,6 +3240,53 @@ async function runLoop(opts) {
                     }
                     log(`goal    : judging ${(0, goal_met_target_1.describeTarget)(judged)}`);
                 }
+                /**
+                 * THE CODE MOVED AWAY FROM THIS GOAL'S WORK: REBUILD IT ONTO THE BASE, THEN JUDGE THAT TREE
+                 * (`goal-replay.ts`, owner ruling 2026-10-16). In a checkout Looply made, when HEAD holds none
+                 * of this plan's commits, they are replayed onto the base as a fresh run branch BEFORE the
+                 * evaluator looks — so the verdict and the gates are about the same tree, and the branch holds
+                 * only this goal's work. A replay that does not apply puts HEAD back; KEY 2 then plans what is
+                 * missing instead of refusing (`replan`).
+                 */
+                if (judged.kind === 'as-is' && (0, reaper_1.hasProvisionedMarker)(cwd)) {
+                    const rounds = await (0, round_records_1.readRoundRecords)(stateDir, ledger_store_1.nodeLedgerFs);
+                    if (rounds.ok) {
+                        const committed = (0, goal_execution_evidence_1.committedShasOf)({ scope: askedScope, items: owned, rounds: rounds.rounds });
+                        const aligned = await (0, goal_replay_1.alignWithOwnWork)({
+                            headSha: () => git.headSha(),
+                            changedPaths: () => git.changedPaths(),
+                            isAncestor: (a, of) => git.isAncestor(a, of),
+                            baseRef: async () => (await (0, run_base_2.resolveBaseBranch)(git, config.run.baseBranch).catch(() => null))?.ref ?? null,
+                            commitOf: (ref) => git.commitOf(ref),
+                            // The same patch replay the delivery rebuild uses: never a 3-way merge (`branch-replay.ts`).
+                            replay: (base, shas) => (0, branch_replay_1.replayOnto)((0, git_driver_1.nodeGitExec)(cwd), (dir) => (0, git_driver_1.nodeGitExec)(dir), base, shas),
+                            commitsBetween: async (base, sha) => (await (0, git_driver_1.nodeGitExec)(cwd)(['rev-list', '--reverse', `${base}..${sha}`])).stdout.split(/\r?\n/).filter((l) => l.trim() !== ''),
+                            createBranch: (name, from) => git.createBranch(name, from),
+                        }, { committed, branch: `${branch}-rebuilt`, aliases: (0, goal_replay_1.replayedAs)(projectStateDirPath, goalId) });
+                        if (aligned.kind === 'rebuilt') {
+                            (0, goal_replay_1.recordReplay)(projectStateDirPath, goalId, aligned.picked);
+                            (0, run_base_1.writeCheckoutGoal)(stateDir, { goalId, branch: aligned.branch, at: new Date().toISOString() });
+                            (0, lane_claims_1.recordLaneClaim)(cwd, {
+                                schema: lane_claims_1.LANE_CLAIMS_SCHEMA,
+                                kind: 'claims',
+                                at: new Date().toISOString(),
+                                branch: aligned.branch,
+                                runId,
+                                goalId,
+                                goalVersion: bound.version,
+                                planRevision: revision,
+                                servings: [],
+                                workspace: cwd,
+                            });
+                            rebuiltAs = { branch: aligned.branch, head: aligned.head };
+                            log(`goal    : this goal's ${committed.length} commit(s) were not in the tree here — rebuilt onto ${aligned.base} as ${aligned.branch}; judging that`);
+                        }
+                        else if (aligned.kind === 'failed') {
+                            replayTrouble = aligned.because;
+                            log(`goal    : ${aligned.because}`);
+                        }
+                    }
+                }
                 adaptive = await (0, goal_adaptive_1.decideAdaptive)({
                     goalId: scope.goalId,
                     goalVersion: bound.version,
@@ -3233,10 +3327,19 @@ async function runLoop(opts) {
                     compile: async (i, maxSteps) => {
                         const at = await git.headTreeSha().catch(() => null);
                         const recovered = await (0, plan_recovery_1.compileWithRecovery)(i, {
-                            compile: (j) => (0, goal_compile_1.compileGoal)(j, { invoke: planAgent, maxSteps }),
+                            compile: async (j) => {
+                                const out = await (0, goal_compile_1.compileGoal)(j, {
+                                    invoke: planAgent,
+                                    maxSteps: Math.min(maxSteps, adaptiveTier.maxSteps),
+                                    timeoutMs: adaptiveTier.timeoutMs,
+                                });
+                                if (!out.ok && out.failure === 'timed-out')
+                                    compileTimedOut = true;
+                                return out;
+                            },
                             check: (steps) => (0, compile_check_1.checkCompiledPlan)(steps, compileReaders, at),
                             log: (line) => log(`goal    : ${line}`),
-                        }, maxSteps);
+                        }, Math.min(maxSteps, adaptiveTier.maxSteps));
                         return recovered.compiled;
                     },
                     changedPaths: () => git.changedPaths(),
@@ -3272,16 +3375,47 @@ async function runLoop(opts) {
                          */
                         if (!confirmed.ok && confirmed.moved === true && judged.kind !== 'carried') {
                             log('goal    : the code moved on since this plan was delivered — running the gates again at the current tree');
+                            let reproofVerdict = null;
                             const again = await (0, goal_reproof_1.reproveAtHead)(head, (0, goal_execution_evidence_1.committedShasOf)(key2Input), {
                                 changedPaths: () => git.changedPaths(),
                                 isAncestor: (a, of) => git.isAncestor(a, of),
                                 changedPathsBetween: (from, to) => git.changedPathsBetween(from, to),
-                                runGates: async (paths) => (await (0, gate_1.runGate)({ steps: config.gates, changedPaths: paths, runner: (0, untrusted_gate_1.makeUntrustedGateRunner)(cwd) })).steps,
+                                runGates: async (paths) => {
+                                    const gate = await (0, gate_1.runGate)({ steps: config.gates, changedPaths: paths, runner: (0, untrusted_gate_1.makeUntrustedGateRunner)(cwd) });
+                                    reproofVerdict = gate.verdict;
+                                    return gate.steps;
+                                },
+                                aliases: (0, goal_replay_1.replayedAs)(projectStateDirPath, goalId),
                             });
                             confirmed = again.ok
                                 ? (0, goal_execution_evidence_1.confirmGoalExecutionEvidence)({ ...key2Input, rechecked: { contains: again.contains, steps: again.steps } })
                                 : { ok: false, because: `${goal_execution_evidence_1.CODE_MOVED_ON}, and it could not be checked again: ${again.because}` };
                             log(`goal    : ${confirmed.ok ? 'the gates pass at the current tree, and this plan’s work is in it' : confirmed.because}`);
+                            if (!confirmed.ok) {
+                                /**
+                                 * NEVER A HAND-BACK FOR THIS (owner ruling 2026-10-16). Three answers, none of them a
+                                 * person's question:
+                                 *   - the gate could not RUN here (sandbox, tool): the machine's fault — retryable, and
+                                 *     the run's words name it, so the Start is voided (`environment`);
+                                 *   - the tree has uncommitted changes: not this run's to judge — retryable;
+                                 *   - the gates are red here, or the work is not in this tree (and could not be
+                                 *     rebuilt onto the base): a gap the work can close — the next revision plans it.
+                                 */
+                                if (reproofVerdict === 'blocked') {
+                                    return {
+                                        ok: false,
+                                        reason: `gate blocked: step could not run — the environment is unavailable, not the change (${confirmed.because})`,
+                                        unknown: true,
+                                    };
+                                }
+                                if (!again.ok && /uncommitted change/.test(again.because))
+                                    return { ok: false, reason: again.because, unknown: true };
+                                return {
+                                    ok: false,
+                                    reason: replayTrouble === null ? confirmed.because : `${confirmed.because} (${replayTrouble})`,
+                                    replan: true,
+                                };
+                            }
                         }
                         /**
                          * 🔴 WHAT KEY 2 SAW, KEPT FOR THE FOURTH KEY.
@@ -3295,7 +3429,8 @@ async function runLoop(opts) {
                          */
                         if (confirmed.ok) {
                             deliveringRunId = confirmed.round.runId;
-                            deliveringSha = confirmed.round.sha ?? null;
+                            // A REBUILT tree delivers its own tip: the original round's commit is not in it.
+                            deliveringSha = rebuiltAs !== null ? rebuiltAs.head : (confirmed.round.sha ?? null);
                             key2Saw = {
                                 delivered: new Set(confirmed.delivered),
                                 checks: new Map((confirmed.reproved ?? confirmed.round.gate?.steps ?? []).map((st) => [
@@ -3575,7 +3710,7 @@ async function runLoop(opts) {
                 await releaseHold();
                 // The branch the controller will ask the lane about: the one that delivered (F20).
                 const refusedOn = deliveredOn;
-                throw said.terminal ? new RunRefused(said.message, said.code, refusedOn, delivery) : new Error(said.message);
+                throw said.terminal ? new RunRefused(said.message, said.code, refusedOn, delivery) : (plannerTimedOut(said.message) ?? new Error(said.message));
             }
         }
         const left = scope === null ? null : (0, core_1.workLeft)(runQueue.list());
@@ -3603,7 +3738,8 @@ async function runLoop(opts) {
             throw new RunRefused(`nothing here can move without you — ${(0, queue_summary_1.describeNoReady)(runQueue.list())}`, 'human_required');
         }
         await releaseHold();
-        throw new Error(`nothing to do — ${(0, queue_summary_1.describeNoReady)(runQueue.list())}`);
+        const nothing = `nothing to do — ${(0, queue_summary_1.describeNoReady)(runQueue.list())}`;
+        throw plannerTimedOut(compileNote === null ? nothing : `${nothing} (${compileNote})`) ?? new Error(nothing);
     }
     /**
      * THE APPROVAL BOUNDARY, AND THE ONLY PLACE IT COULD LIVE.