@indigoai-us/hq-cli 5.245.0 → 5.247.0

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

@@ -1,6 +1,9 @@
 import type { LaneRecord, QuestionRecord } from "./types.js";
 export declare const LEAD_LANE_KEEP_ALIVE_FLAG = "lanes.lead-keep-alive";
 export declare const LEAD_LANE_KEEP_ALIVE_DEFAULT_ENABLED = false;
+/** Missing or unreadable registry values retain the legacy supersession behavior. */
+export declare const LANE_SUPERSESSION_LINEAGE_AWARE_FLAG = "lanes.supersession-lineage-aware";
+export declare const LANE_SUPERSESSION_LINEAGE_AWARE_DEFAULT_ENABLED = false;
 export declare const LEAD_LANE_KEEP_ALIVE_MAX_RESUMES = 24;
 export declare const LEAD_LANE_KEEP_ALIVE_BASE_BACKOFF_MS: number;
 export declare const LEAD_LANE_KEEP_ALIVE_MAX_BACKOFF_MS: number;
@@ -27,7 +30,7 @@ export declare function retiredLaneRegistryPath(hqRoot: string): string;
 export declare function loadRetiredLaneIds(hqRoot: string): ReadonlySet<string>;
 /** IDs may be stored bare or with an owner-host suffix after an underscore. */
 export declare function isRetiredLaneId(laneId: string, retiredLaneIds: ReadonlySet<string>): boolean;
-export declare function keepAliveSupersededBy(lane: LaneRecord, lanes: readonly LaneRecord[]): LaneRecord | undefined;
-export declare function keepAliveExclusion(lane: LaneRecord, lanes: readonly LaneRecord[], retiredLaneIds: ReadonlySet<string>): "retired" | "superseded" | undefined;
+export declare function keepAliveSupersededBy(lane: LaneRecord, lanes: readonly LaneRecord[], lineageAware?: boolean): LaneRecord | undefined;
+export declare function keepAliveExclusion(lane: LaneRecord, lanes: readonly LaneRecord[], retiredLaneIds: ReadonlySet<string>, lineageAware?: boolean): "retired" | "superseded" | undefined;
 export declare function leadLaneKeepAliveBackoffMs(attempt: number): number;
 //# sourceMappingURL=keep-alive.d.ts.map

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

@@ -5,6 +5,9 @@ import { dropboxInboxHasMessages } from "./dropbox.js";
 import { listQuestionIds, readQuestion } from "./store.js";
 export const LEAD_LANE_KEEP_ALIVE_FLAG = "lanes.lead-keep-alive";
 export const LEAD_LANE_KEEP_ALIVE_DEFAULT_ENABLED = false;
+/** Missing or unreadable registry values retain the legacy supersession behavior. */
+export const LANE_SUPERSESSION_LINEAGE_AWARE_FLAG = "lanes.supersession-lineage-aware";
+export const LANE_SUPERSESSION_LINEAGE_AWARE_DEFAULT_ENABLED = false;
 export const LEAD_LANE_KEEP_ALIVE_MAX_RESUMES = 24;
 export const LEAD_LANE_KEEP_ALIVE_BASE_BACKOFF_MS = 5 * 60 * 1000;
 export const LEAD_LANE_KEEP_ALIVE_MAX_BACKOFF_MS = 60 * 60 * 1000;
@@ -119,11 +122,22 @@ export function isRetiredLaneId(laneId, retiredLaneIds) {
     }
     return false;
 }
-export function keepAliveSupersededBy(lane, lanes) {
+export function keepAliveSupersededBy(lane, lanes, lineageAware = LANE_SUPERSESSION_LINEAGE_AWARE_DEFAULT_ENABLED) {
     const createdAt = Date.parse(lane.created_at);
     if (!Number.isFinite(createdAt))
         return undefined;
     const lanesById = new Map(lanes.map((candidate) => [candidate.lane_id, candidate]));
+    const targetAncestorIds = new Set();
+    if (lineageAware) {
+        let parentLaneId = lane.senior.kind === "lane" ? lane.senior.id : undefined;
+        while (parentLaneId) {
+            if (targetAncestorIds.has(parentLaneId))
+                break;
+            targetAncestorIds.add(parentLaneId);
+            const parent = lanesById.get(parentLaneId);
+            parentLaneId = parent?.senior.kind === "lane" ? parent.senior.id : undefined;
+        }
+    }
     return lanes.find((candidate) => {
         if (candidate.lane_id === lane.lane_id || Date.parse(candidate.created_at) <= createdAt)
             return false;
@@ -132,6 +146,8 @@ export function keepAliveSupersededBy(lane, lanes) {
             : candidate.company?.uid === lane.company.uid;
         if (!sameCompany)
             return false;
+        if (lineageAware && targetAncestorIds.has(candidate.lane_id))
+            return false;
         // Any descendant is part of this lead's work tree, not a replacement lead.
         let parentLaneId = candidate.senior.kind === "lane" ? candidate.senior.id : undefined;
         const visitedLaneIds = new Set();
@@ -144,18 +160,22 @@ export function keepAliveSupersededBy(lane, lanes) {
             const parent = lanesById.get(parentLaneId);
             parentLaneId = parent?.senior.kind === "lane" ? parent.senior.id : undefined;
         }
+        const sameLaneSenior = lane.senior.kind === "lane" &&
+            candidate.senior.kind === "lane" &&
+            candidate.senior.id === lane.senior.id;
         const sameProfile = lane.worker_profile !== undefined &&
-            candidate.worker_profile === lane.worker_profile;
+            candidate.worker_profile === lane.worker_profile &&
+            !(lineageAware && sameLaneSenior);
         const projectLead = lane.project_id !== undefined &&
             candidate.project_id === lane.project_id &&
             (candidate.hire_grant ?? 0) > 0;
         return sameProfile || projectLead;
     });
 }
-export function keepAliveExclusion(lane, lanes, retiredLaneIds) {
+export function keepAliveExclusion(lane, lanes, retiredLaneIds, lineageAware = LANE_SUPERSESSION_LINEAGE_AWARE_DEFAULT_ENABLED) {
     if (isRetiredLaneId(lane.lane_id, retiredLaneIds))
         return "retired";
-    return keepAliveSupersededBy(lane, lanes) === undefined ? undefined : "superseded";
+    return keepAliveSupersededBy(lane, lanes, lineageAware) === undefined ? undefined : "superseded";
 }
 export function leadLaneKeepAliveBackoffMs(attempt) {
     if (!Number.isSafeInteger(attempt) || attempt < 1) {

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, 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, canResumeDoneKeepAliveLane, 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";
@@ -821,17 +821,24 @@ export async function runPassBody(hqRoot, deps) {
         keepAliveFlagCompanies.set(key, lane.company);
     }
     const keepAliveFlagByCompany = new Map();
+    const supersessionLineageAwareByCompany = new Map();
     const env = deps.env ?? process.env;
     await Promise.all([...keepAliveFlagCompanies.entries()].map(async ([key, company]) => {
-        keepAliveFlagByCompany.set(key, await readRegistryFlag(LEAD_LANE_KEEP_ALIVE_FLAG, {
+        const options = {
             company: company ?? undefined,
             env,
-        }));
+        };
+        const [keepAliveEnabled, lineageAware] = await Promise.all([
+            readRegistryFlag(LEAD_LANE_KEEP_ALIVE_FLAG, options),
+            readRegistryFlag(LANE_SUPERSESSION_LINEAGE_AWARE_FLAG, options),
+        ]);
+        keepAliveFlagByCompany.set(key, keepAliveEnabled);
+        supersessionLineageAwareByCompany.set(key, lineageAware);
     }));
     await withAllLaneAdmissionLocks(hqRoot, async () => {
         const freshLanes = loadLaneRecords(hqRoot, summary);
         const freshQuestions = loadQuestionRecords(hqRoot, summary);
-        resumeKeepAlive(hqRoot, freshLanes, freshQuestions, summary, deps, now, keepAliveFlagByCompany);
+        resumeKeepAlive(hqRoot, freshLanes, freshQuestions, summary, deps, now, keepAliveFlagByCompany, supersessionLineageAwareByCompany);
         const drainLanes = loadLaneRecords(hqRoot, summary);
         await admitQueued(hqRoot, drainLanes, summary, deps, now);
         await resumeAwaiting(hqRoot, drainLanes, freshQuestions, summary, deps);
@@ -1546,7 +1553,7 @@ function latestEnvelopeMtimeMs(hqRoot, lane, ref) {
         throw new LanesError("keep_alive_envelope_timestamp_unavailable", `Cannot stat latest envelope for lane ${lane.lane_id}: ${err instanceof Error ? err.message : String(err)}`, { lane_id: lane.lane_id, path: filePath });
     }
 }
-function resumeKeepAlive(hqRoot, lanes, questions, summary, deps, now, flagByCompany) {
+function resumeKeepAlive(hqRoot, lanes, questions, summary, deps, now, flagByCompany, supersessionLineageAwareByCompany) {
     const nowMs = now.getTime();
     const nowIso = now.toISOString();
     const config = loadLanesConfig(hqRoot);
@@ -1702,7 +1709,7 @@ function resumeKeepAlive(hqRoot, lanes, questions, summary, deps, now, flagByCom
             recordKeepAliveSkip(hqRoot, lane, "retired_list_invalid", summary, deps);
             continue;
         }
-        const exclusion = keepAliveExclusion(lane, lanes, retiredLaneIds);
+        const exclusion = keepAliveExclusion(lane, lanes, retiredLaneIds, supersessionLineageAwareByCompany.get(keepAliveCompanyKey(lane.company)) === true);
         if (exclusion !== undefined) {
             recordKeepAliveSkip(hqRoot, lane, exclusion, summary, deps);
             continue;
@@ -1790,7 +1797,7 @@ function resumeKeepAlive(hqRoot, lanes, questions, summary, deps, now, flagByCom
             continue;
         }
         const currentLanes = loadLaneRecords(hqRoot, summary);
-        const currentExclusion = keepAliveExclusion(current, currentLanes, retiredLaneIds);
+        const currentExclusion = keepAliveExclusion(current, currentLanes, retiredLaneIds, supersessionLineageAwareByCompany.get(keepAliveCompanyKey(current.company)) === true);
         if (currentExclusion !== undefined) {
             recordKeepAliveSkip(hqRoot, current, currentExclusion, summary, deps);
             continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.245.0",
+  "version": "5.247.0",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {
@@ -44,7 +44,7 @@
   "dependencies": {
     "@aws-sdk/client-iot-data-plane": "^3.1096.0",
     "@aws-sdk/client-s3": "^3.1049.0",
-    "@indigoai-us/hq-cloud": "~6.18.5",
+    "@indigoai-us/hq-cloud": "~6.18.10",
     "@indigoai-us/hq-flags-client": "^0.1.2",
     "@sentry/node": "^10.49.0",
     "@tobilu/qmd": "2.5.3",