@indigoai-us/hq-cli 5.260.0 → 5.261.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## [Unreleased]
 
+## [5.261.0] — 2026-09-28
+
+### Fixed
+
+- Standing keep-alive leads now resume stories that remain open. Completed
+  stories resume only on standing leads with queued work, and reconcile reports
+  why other completed lanes stay idle.
+
 ## [5.260.0] — 2026-09-28
 
 ### Added

package/dist/commands/lanes.js

@@ -50,7 +50,7 @@ import { effectiveAccountHome } from "../lib/lanes/account-home.js";
 import { AccountResolutionError, compareLaneQueueOrder, LANE_PROVIDERS, LANE_STATES, QUESTION_STATUSES, SENIOR_KINDS, accountStatus, appendCappedHistory, canonicalizeHome, createLane, decideAdmission, defaultLivenessDeps, defaultSystemdUserDir, defaultThrottleDeps, installReconcileTimer, providerPathEnv, probeDrainHookRegistration, isLanesError, isLaneVersionConflict, isTerminalLaneState, aliveDirectChildren, assignedChildHireGrants, hireGrantCapacityError, planHireGrantBackfill, terminalChildResumeHireGrantError, withHireGrantAdmission, laneStoryLedgerEnabled, validateProjectStories, buildLaneStatusSnapshot, formatLaneStatusHuman, listLaneIds, listQuestionIds, loadLanesConfig, laneRunsHere, MAX_LANE_DEPTH, MONITOR_ERROR_EXIT_CODE, readLiveMonitorEvidence, resolveMachineIdentity as lookupMachineIdentity, loadLivenessIndex, parseLaneProvider, parseLaneRecord, parseLaneState, parseQuestionRecord, parseSeniorKind, readLane, retryUpdateLane, syncLaneRecordFromOwner, readQuestion, resolveAccount, resolveLaneWorker, ignoredWorkerProfileFields, loadWorkerProfile, loadWorkerProfileWithRegistry, registryWorkerRecord, runReconcilePass, sessionLiveness, tryReadLane, uninstallReconcileTimer, updateLane, updateQuestion, dropboxDir, laneDeliveryMechanism, hasActiveAdmissionReservation, hasActivePendingResume, hasRecordedSessionId, hasEarlierEligibleQueuedLane, laneAdmissionCapReason, providerSupportsSessionResume, providerSessionPortable, sessionNotPortableMessage, withLaneAdmissionLock, withAllLaneAdmissionLocks, withLaneHireLocks, raiseLaneQuestion, sha256Text, } from "../lib/lanes/index.js";
 import { activeLaneStories, laneStories, laneStory, storyWarning, } from "../lib/lanes/stories.js";
 import { resolveLaneKeepAlive } from "../lib/lanes/profile.js";
-import { keepAliveExclusion, LANE_SUPERSESSION_LINEAGE_AWARE_FLAG, loadRetiredLaneIds, } from "../lib/lanes/keep-alive.js";
+import { doneKeepAliveVerdict, hasPendingKeepAliveWork, keepAliveExclusion, LANE_SUPERSESSION_LINEAGE_AWARE_FLAG, loadRetiredLaneIds, } from "../lib/lanes/keep-alive.js";
 import { questionBodyAbsPath, resolveQuestionCompanyWithFallback, resolveProjectQuestionCompany, } from "../lib/lanes/questions.js";
 import { assertQuestionBodySecretSafe } from "../lib/lanes/questions.js";
 import { compactionAfterUsage, } from "../lib/lanes/compaction.js";
@@ -4524,6 +4524,9 @@ async function runShow(ctx, laneId) {
         : storedLane;
     const askDeliveryFailed = readJsonFile(askDeliveryFailedPath(hqRoot, laneId));
     const keepAliveState = resolveLaneKeepAlive(hqRoot, storedLane);
+    const doneStateVerdict = storedLane.state === "done" && storedLane.keep_alive === true
+        ? doneKeepAliveVerdict(storedLane, { decision: storedLane.last_envelope?.decision, story_complete: storedLane.story_complete }, storedLane.keep_alive_standing === true && hasPendingKeepAliveWork(hqRoot, storedLane))
+        : null;
     const managerStatusGate = await resolveManagerStatusGateForLane(hqRoot, storedLane, { env: ctx.env });
     const managerStatusTarget = managerStatusGate.target;
     const blockerFreshness = await resolveBlockerFreshnessForLane(hqRoot, storedLane, {
@@ -4560,6 +4563,7 @@ async function runShow(ctx, laneId) {
             enabled: keepAliveState.enabled,
             source: keepAliveState.source,
             standing: storedLane.keep_alive_standing === true,
+            done_state_verdict: doneStateVerdict,
             opted_in_at: storedLane.keep_alive_opted_in_at ?? null,
             blocked_reason: storedLane.keep_alive_blocked_reason ??
                 (storedLane.keep_alive === true ? null : "not_opted_in"),

package/dist/lib/lanes/keep-alive.d.ts

@@ -27,11 +27,9 @@ export interface KeepAliveDoneEnvelope {
     decision?: string;
     story_complete?: boolean;
 }
-/**
- * Shared done-state policy: ordinary opted-in lanes resume open stories;
- * standing leads wait for queued work, even when each turn marks the story
- * complete. Watch and reconcile both use this decision.
- */
+export type DoneKeepAliveVerdict = "eligible" | "standing_idle" | "story_complete";
+/** Shared done-state policy used by watch, reconcile, and the show command. */
+export declare function doneKeepAliveVerdict(lane: Pick<LaneRecord, "keep_alive_standing">, envelope: KeepAliveDoneEnvelope, hasQueuedWork: boolean): DoneKeepAliveVerdict | null;
 export declare function canResumeDoneKeepAliveLane(lane: Pick<LaneRecord, "keep_alive_standing">, envelope: KeepAliveDoneEnvelope, hasQueuedWork: boolean): boolean;
 /** Work signals already persisted for a lane that ended its turn. */
 export declare function hasPendingKeepAliveWork(hqRoot: string, lane: Pick<LaneRecord, "lane_id" | "company" | "pending_resume">, questionRecords?: readonly QuestionRecord[]): boolean;

package/dist/lib/lanes/keep-alive.js

@@ -89,17 +89,18 @@ export function queueManagerStatusGateResume(hqRoot, laneId, entry, resumeText)
 }
 export const LEAD_LANE_KEEP_ALIVE_RESUME_TEXT = "Automatic keep-alive resume: your last turn ended with decision done and story_complete false. Continue the open work from where you stopped. End with done only when story_complete is true; if you are waiting, use hq lanes ask or stay in the loop.";
 export const LEAD_LANE_KEEP_ALIVE_INTERRUPTED_RESUME_TEXT = "Automatic keep-alive resume: your previous turn was interrupted by a provider process exit. Check your last state before continuing. Continue the open work from where you stopped. End with done only when story_complete is true; if you are waiting, use hq lanes ask or stay in the loop.";
-/**
- * Shared done-state policy: ordinary opted-in lanes resume open stories;
- * standing leads wait for queued work, even when each turn marks the story
- * complete. Watch and reconcile both use this decision.
- */
-export function canResumeDoneKeepAliveLane(lane, envelope, hasQueuedWork) {
+/** Shared done-state policy used by watch, reconcile, and the show command. */
+export function doneKeepAliveVerdict(lane, envelope, hasQueuedWork) {
     if (envelope.decision !== "done")
-        return false;
-    return lane.keep_alive_standing === true
-        ? hasQueuedWork
-        : envelope.story_complete !== true;
+        return null;
+    if (envelope.story_complete !== true)
+        return "eligible";
+    if (lane.keep_alive_standing !== true)
+        return "story_complete";
+    return hasQueuedWork ? "eligible" : "standing_idle";
+}
+export function canResumeDoneKeepAliveLane(lane, envelope, hasQueuedWork) {
+    return doneKeepAliveVerdict(lane, envelope, hasQueuedWork) === "eligible";
 }
 /** Work signals already persisted for a lane that ended its turn. */
 export function hasPendingKeepAliveWork(hqRoot, lane, questionRecords) {

package/dist/lib/lanes/reconcile.js

@@ -22,7 +22,7 @@ import { ANSWERED_QUESTIONS_FILE, armLaneWatcher, envelopeRepairMode, isPidRecor
 import { appendCappedHistory, lanesStoreRoot, parseLaneRecord, parseQuestionRecord, readLane, readQuestion, updateLane, updateQuestion, } from "./store.js";
 import { applyThrottleDecision, decideAdmission, defaultThrottleDeps, emptyThrottleState, evaluateThrottle, isCpuCheckEnabled, readAvailableMemMb, readThrottleState, resolveCpuBusyFraction, throttleStatePath, writeThrottleState, } from "./throttle.js";
 import { readLanesRegistryFlag } from "./registry-flag.js";
-import { LEAD_LANE_KEEP_ALIVE_FLAG, LEAD_LANE_KEEP_ALIVE_INTERRUPTED_RESUME_TEXT, LEAD_LANE_KEEP_ALIVE_MAX_RESUMES, LEAD_LANE_KEEP_ALIVE_RESUME_TEXT, LANE_SUPERSESSION_LINEAGE_AWARE_FLAG, canResumeDoneKeepAliveLane, hasPendingKeepAliveWork, keepAliveExclusion, loadRetiredLaneIds, leadLaneKeepAliveBackoffMs, undeliveredAnsweredQuestions, } from "./keep-alive.js";
+import { LEAD_LANE_KEEP_ALIVE_FLAG, LEAD_LANE_KEEP_ALIVE_INTERRUPTED_RESUME_TEXT, LEAD_LANE_KEEP_ALIVE_MAX_RESUMES, LEAD_LANE_KEEP_ALIVE_RESUME_TEXT, LANE_SUPERSESSION_LINEAGE_AWARE_FLAG, doneKeepAliveVerdict, hasPendingKeepAliveWork, keepAliveExclusion, loadRetiredLaneIds, leadLaneKeepAliveBackoffMs, undeliveredAnsweredQuestions, } from "./keep-alive.js";
 import { providerSupportsSessionResume } from "./delivery.js";
 import { applyDefaultQuotaHold, readQuotaSignal, recordAccountQuota } from "./quota.js";
 import { answeredQuestionEntries, questionRecordRefusalCode, raiseEnvelopeQuestions, resolveQuestionCompanyWithFallback, } from "./questions.js";
@@ -848,7 +848,7 @@ export async function runPassBody(hqRoot, deps) {
             if (!envelope || envelope.decision !== "done")
                 continue;
             const hasQueuedWork = lane.keep_alive_standing === true && hasPendingKeepAliveWork(hqRoot, lane, questions);
-            if (!canResumeDoneKeepAliveLane(lane, envelope, hasQueuedWork))
+            if (doneKeepAliveVerdict(lane, envelope, hasQueuedWork) !== "eligible")
                 continue;
         }
         const key = keepAliveCompanyKey(lane.company);
@@ -1137,10 +1137,8 @@ async function heartbeatAndDeadHosts(hqRoot, lanes, summary, deps, now) {
                     if (terminalEnvelope && latest) {
                         const envelope = terminalEnvelope;
                         next.story_status = envelope.story_status;
-                        if (envelope.story_complete !== undefined) {
-                            next.story_complete = envelope.story_complete;
-                            next.story_complete_reason = envelope.story_complete_reason;
-                        }
+                        next.story_complete = envelope.story_complete;
+                        next.story_complete_reason = envelope.story_complete_reason;
                         const storyStatus = envelope.decision === "blocked"
                             ? "blocked"
                             : envelope.decision === "done"
@@ -1550,6 +1548,13 @@ function recordKeepAliveSkip(hqRoot, lane, reason, summary, deps, detail) {
         });
     }
 }
+function recordDoneKeepAlivePolicySkip(summary, lane, verdict) {
+    summary.skipped.push({
+        kind: "lane",
+        id: lane.lane_id,
+        why: `keep_alive_${verdict}`,
+    });
+}
 function readLatestInterruptedClassificationAt(hqRoot, lane) {
     const logPath = watcherOutLogPath(hqRoot, lane.lane_id);
     let body;
@@ -1624,7 +1629,10 @@ function resumeKeepAlive(hqRoot, lanes, questions, summary, deps, now, flagByCom
             if (!envelope || envelope.decision !== "done")
                 continue;
             const hasQueuedWork = lane.keep_alive_standing === true && hasPendingKeepAliveWork(hqRoot, lane, questions);
-            if (!canResumeDoneKeepAliveLane(lane, envelope, hasQueuedWork)) {
+            const verdict = doneKeepAliveVerdict(lane, envelope, hasQueuedWork);
+            if (verdict !== "eligible") {
+                if (verdict !== null)
+                    recordDoneKeepAlivePolicySkip(summary, lane, verdict);
                 if (envelope.story_complete === true && lane.keep_alive_standing !== true && hasKeepAliveProgress(lane)) {
                     casLaneIf(hqRoot, lane.lane_id, (current) => current.version === lane.version &&
                         current.state === "done" &&
@@ -1713,8 +1721,15 @@ function resumeKeepAlive(hqRoot, lanes, questions, summary, deps, now, flagByCom
             if (!latest || latest.envelope.decision !== "done")
                 continue;
             const hasQueuedWork = lane.keep_alive_standing === true && hasPendingKeepAliveWork(hqRoot, lane, questions);
-            if (!canResumeDoneKeepAliveLane(lane, latest.envelope, hasQueuedWork))
+            const verdict = doneKeepAliveVerdict(lane, latest.envelope, hasQueuedWork);
+            if (verdict !== "eligible") {
+                if (verdict !== null)
+                    recordDoneKeepAlivePolicySkip(summary, lane, verdict);
+                if (latest.envelope.story_complete === true && lane.keep_alive_standing !== true && hasKeepAliveProgress(lane)) {
+                    casLaneIf(hqRoot, lane.lane_id, (current) => current.version === lane.version && current.state === "done", (current) => ({ ...clearedKeepAliveProgress(current), keep_alive_blocked_reason: undefined }), deps.dryRun);
+                }
                 continue;
+            }
             try {
                 eligibilityAtMs = latestEnvelopeMtimeMs(hqRoot, lane, latest.ref);
             }
@@ -1788,7 +1803,10 @@ function resumeKeepAlive(hqRoot, lanes, questions, summary, deps, now, flagByCom
             if (!currentEnvelope || currentEnvelope.envelope.decision !== "done")
                 continue;
             const hasQueuedWork = current.keep_alive_standing === true && hasPendingKeepAliveWork(hqRoot, current, questions);
-            if (!canResumeDoneKeepAliveLane(current, currentEnvelope.envelope, hasQueuedWork)) {
+            const verdict = doneKeepAliveVerdict(current, currentEnvelope.envelope, hasQueuedWork);
+            if (verdict !== "eligible") {
+                if (verdict !== null)
+                    recordDoneKeepAlivePolicySkip(summary, current, verdict);
                 if (currentEnvelope.envelope.story_complete === true && current.keep_alive_standing !== true && hasKeepAliveProgress(current)) {
                     casLaneIf(hqRoot, current.lane_id, (latestLane) => latestLane.version === current.version &&
                         latestLane.state === "done" &&

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

@@ -434,7 +434,7 @@ export interface LaneRecord {
     worker_profile?: string;
     /** Whether this lead lane should resume completed turns while its story is open. */
     keep_alive?: boolean;
-    /** Whether a keep-alive lead waits for queued work after every done turn. */
+    /** Whether completed keep-alive stories wait for queued work after a done turn. */
     keep_alive_standing?: boolean;
     /** Time this lane most recently explicitly opted into keep-alive. */
     keep_alive_opted_in_at?: string;

package/dist/lib/lanes/watcher.js

@@ -405,10 +405,8 @@ export function applyTerminalToLaneWithResult(hqRoot, laneId, classification, op
                 ...(envelope.blocked_reason !== undefined ? { blocked_reason: envelope.blocked_reason } : {}),
             };
             next.story_status = envelope.story_status;
-            if (envelope.story_complete !== undefined) {
-                next.story_complete = envelope.story_complete;
-                next.story_complete_reason = envelope.story_complete_reason;
-            }
+            next.story_complete = envelope.story_complete;
+            next.story_complete_reason = envelope.story_complete_reason;
             const currentProject = current.project_id;
             const currentStory = current.story_id;
             const storyStatus = envelope.decision === "blocked"

package/package.json

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