@indigoai-us/hq-cli 5.311.4 → 5.312.0

package/dist/lib/lanes/watcher-main.js

@@ -5,7 +5,7 @@
  * Usage: node watcher-main.js <lane-id>
  * Requires HQ_ROOT in the environment.
  */
-import { spawnSync } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { existsSync, realpathSync } from "node:fs";
 import * as path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -32,6 +32,25 @@ export function watcherMainDeps(hqRoot, laneId, env = process.env, repairDispatc
                 throw new Error(`recovery command exited ${result.status ?? result.signal ?? "without status"}: ${(result.stderr ?? "").trim()}`);
             }
         },
+        scheduleTerminalKeepAlive: async ({ laneId: scheduledLaneId, version, dueAt }) => {
+            await new Promise((resolve, reject) => {
+                const child = spawn(process.execPath, [
+                    cliEntry,
+                    "lanes",
+                    "_keep-alive-terminal-trigger",
+                    scheduledLaneId,
+                    String(version),
+                    dueAt,
+                ], {
+                    env,
+                    detached: true,
+                    stdio: "ignore",
+                });
+                child.once("error", reject);
+                child.once("spawn", resolve);
+                child.unref();
+            });
+        },
     };
 }
 function deliverLaneSeniorMessage(cliEntry, laneId, text) {

package/dist/lib/lanes/watcher.d.ts

@@ -238,6 +238,15 @@ export interface WatcherLoopDeps {
     readKrFreshnessFlag?: typeof readLanesRegistryFlag;
     /** Test seam; production reads the company-scoped hq-flags row. */
     readEnvelopeRepairContinueFlag?: typeof readLanesRegistryFlag;
+    /** Test seam; production reads the company-scoped hq-flags row. */
+    readTerminalKeepAliveFlag?: typeof readLanesRegistryFlag;
+    /** Schedule an immediate reconcile check for the terminal lane version. */
+    scheduleTerminalKeepAlive?: (input: {
+        laneId: string;
+        version: number;
+        terminalAt: string;
+        dueAt: string;
+    }) => Promise<void>;
 }
 /**
  * Wrap one mesh call. A failed emit is logged as `mesh_event_failed` with

package/dist/lib/lanes/watcher.js

@@ -53,7 +53,7 @@ import { laneCompanyUidSource, resolveLaneCompany } from "./lane-company.js";
 import { blockerFreshnessFingerprint, resolveBlockerFreshnessForLane, } from "./blocker-freshness.js";
 import { krFreshnessFingerprint, resolveKrFreshnessForLane, } from "./kr-freshness.js";
 import { managerStatusWasWritten, readStatusSnapshot, resolveManagerStatusTarget, } from "./manager-status-gate.js";
-import { queueLaneTerminalResume, queueManagerStatusGateResume } from "./keep-alive.js";
+import { LEAD_LANE_KEEP_ALIVE_FIRST_RESUME_SETTLE_MS, LEAD_LANE_KEEP_ALIVE_FLAG, LEAD_LANE_KEEP_ALIVE_IMMEDIATE_FIRST_RESUME_FLAG, LEAD_LANE_KEEP_ALIVE_TERMINAL_TRIGGER_FLAG, queueLaneTerminalResume, queueManagerStatusGateResume, } from "./keep-alive.js";
 import { LANE_ENVELOPE_REPAIR_CONTINUE_FLAG } from "./flag-keys.js";
 import { monitorSessionDir } from "../monitor.js";
 import { laneRunDir, missingPidProbe, probePidRecord, readPidRecord, readProcStarttime, readSpawnManifest, envelopeRepairMode, spawnEnvelopeRepair, writePidRecord, retryLaneOnAlternateAccount, } from "./spawn.js";
@@ -1780,6 +1780,52 @@ async function runWatcherLoopOwned(hqRoot, laneId, deps) {
                         });
                     }
                 }
+                const terminalEnvelopeNextCheckMs = effectiveEnvelope?.next_check_at === undefined
+                    ? undefined
+                    : Date.parse(effectiveEnvelope.next_check_at);
+                const hasFutureTerminalNextCheck = terminalEnvelopeNextCheckMs !== undefined &&
+                    Number.isFinite(terminalEnvelopeNextCheckMs) &&
+                    terminalEnvelopeNextCheckMs > Date.parse(tick.emit.at);
+                if (terminalWrite.changed &&
+                    updated.keep_alive === true &&
+                    effectiveEnvelope?.decision === "done" &&
+                    effectiveEnvelope.story_complete === false &&
+                    !hasFutureTerminalNextCheck &&
+                    updated.state === "done" &&
+                    deps.scheduleTerminalKeepAlive) {
+                    try {
+                        const current = readLane(hqRoot, laneId);
+                        if (current.state === "done" && current.version === updated.version && current.keep_alive === true) {
+                            const resolution = resolveLaneCompany(hqRoot, current);
+                            const company = resolution.company;
+                            if (company) {
+                                const readFlag = deps.readTerminalKeepAliveFlag ?? readLanesRegistryFlag;
+                                const flagOptions = { company, companyUidSource: laneCompanyUidSource(resolution.source) };
+                                const [triggerEnabled, keepAliveEnabled, immediateFirstResumeEnabled] = await Promise.all([
+                                    readFlag(LEAD_LANE_KEEP_ALIVE_TERMINAL_TRIGGER_FLAG, flagOptions),
+                                    readFlag(LEAD_LANE_KEEP_ALIVE_FLAG, flagOptions),
+                                    readFlag(LEAD_LANE_KEEP_ALIVE_IMMEDIATE_FIRST_RESUME_FLAG, flagOptions),
+                                ]);
+                                if (triggerEnabled && keepAliveEnabled && immediateFirstResumeEnabled) {
+                                    const terminalAtMs = Date.parse(tick.emit.at);
+                                    const dueAt = new Date(terminalAtMs + LEAD_LANE_KEEP_ALIVE_FIRST_RESUME_SETTLE_MS).toISOString();
+                                    logDecision({ event: "keep_alive_terminal_trigger_scheduled", at: tick.emit.at, due_at: dueAt, version: current.version });
+                                    await deps.scheduleTerminalKeepAlive({
+                                        laneId,
+                                        version: current.version,
+                                        terminalAt: tick.emit.at,
+                                        dueAt,
+                                    });
+                                }
+                            }
+                        }
+                    }
+                    catch (err) {
+                        const message = err instanceof Error ? err.message : String(err);
+                        process.stderr.write(`hq lanes watcher: terminal keep-alive trigger failed for ${laneId}: ${message}\n`);
+                        logDecision({ event: "keep_alive_terminal_trigger_failed", at: tick.emit.at, error: message });
+                    }
+                }
             }
         }
         lastSignalMs = tick.nextLastSignalMs;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.311.4",
+  "version": "5.312.0",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {