@indigoai-us/hq-cli 5.272.0 → 5.273.0

package/dist/commands/lanes.js

@@ -21,7 +21,6 @@ import { registerOutpostPrunerCommand } from "./outpost-pruner.js";
 import { registerLaneKpisCommand } from "./lanes-kpis.js";
 import { registerLaneChecksCommand } from "./lanes-checks.js";
 import { registerLaneReportCommands } from "./lanes-report.js";
-import { registerLaneTrackerImportCommand } from "./lanes-import.js";
 import { registerLaneRepoMergeHoldCommand } from "./lanes-hold.js";
 import { registerLaneReviewCommand } from "./lanes-review.js";
 import { ensureCognitoToken } from "../utils/cognito-session.js";
@@ -29,7 +28,6 @@ import { resolveLanesHqRoot } from "../lib/lanes/hq-root.js";
 import { isSsmRunCommandProcess } from "../lib/lanes/ssm-command-context.js";
 import { readLanesRegistryFlag } from "../lib/lanes/registry-flag.js";
 import { resolveProcessFlagCompanyContext } from "../lib/flag-registry.js";
-import { defaultTrackerActor, LANES_TRACKER_FLAG, registerLaneTrackerCommands, } from "./lanes-tracker.js";
 import { createOutpostHireGrantContext, parseOutpostHireGrantContext, sameHireGrantSenior, } from "../lib/lanes/hire-grant-dispatch.js";
 import { createOutpostProfileRepinContext, parseOutpostProfileRepinContext, } from "../lib/lanes/outpost-profile-repin.js";
 import { createOutpostRegistryWorkerApprovalContext, parseOutpostRegistryWorkerApprovalContext, } from "../lib/lanes/outpost-registry-worker-approval.js";
@@ -109,9 +107,6 @@ async function readLanePlacementEnabled(ctx, company) {
         return false;
     }
 }
-function defaultLaneTrackerEnabled(company) {
-    return readLanesRegistryFlag(LANES_TRACKER_FLAG, { company });
-}
 function processLanePlacementCompany(ctx) {
     const context = resolveProcessFlagCompanyContext(ctx.env);
     if (!context.companySlug)
@@ -328,9 +323,8 @@ function resolveDeps(deps = {}) {
         storyLedgerEnabled: deps.storyLedgerEnabled ?? laneStoryLedgerEnabled,
         isSsmOwnerDispatch: deps.isSsmOwnerDispatch ?? (() => isSsmRunCommandProcess()),
         withGrantHireLocks: deps.withGrantHireLocks ?? withLaneHireLocks,
-        laneTrackerEnabled: deps.laneTrackerEnabled ?? defaultLaneTrackerEnabled,
         mergeReviewEnabled: deps.mergeReviewEnabled,
-        trackerActor: deps.trackerActor ?? defaultTrackerActor,
+        mergeHoldEnabled: deps.mergeHoldEnabled,
     };
 }
 function livenessDepsFromCtx(ctx) {
@@ -3497,7 +3491,7 @@ async function dispatchOutpostLaneCommand(ctx, lane, action, options, behavior =
     }
     else if ((action === "resume" || action === "message") &&
         lane.senior.kind === "lane") {
-        grantContext = createOutpostHireGrantContext(lane, loadAllLanes(ctx.hqRoot()));
+        grantContext = createOutpostHireGrantContext(lane, loadAllLanes(ctx.hqRoot()), action === "message" ? options.supersededMessageCallerId : undefined);
     }
     let dispatched;
     let grantContextRejected = false;
@@ -7083,23 +7077,9 @@ export function registerLanesCommand(parent, deps = {}) {
     const lanes = parent
         .command("lanes", { hidden: true })
         .description("Create, supervise, and steer worker lanes; routed decision queue");
-    registerLaneTrackerCommands(lanes, {
-        hqRoot: ctx.hqRoot,
-        resolveCompany: ctx.resolveCompany,
-        trackerEnabled: ctx.laneTrackerEnabled,
-        now: ctx.now,
-        actor: ctx.trackerActor,
-    }, wrap);
-    registerLaneTrackerImportCommand(lanes, {
-        hqRoot: ctx.hqRoot,
-        resolveCompany: ctx.resolveCompany,
-        trackerEnabled: ctx.laneTrackerEnabled,
-        now: ctx.now,
-    }, wrap);
     registerLaneChecksCommand(lanes, {
         hqRoot: ctx.hqRoot,
         resolveCompany: ctx.resolveCompany,
-        trackerEnabled: ctx.laneTrackerEnabled,
         now: ctx.now,
         stopLane: (laneId, reason) => runStop(ctx, laneId, reason, true),
         sessionState: (root, sessionId, now) => sessionLiveness(root, sessionId, {
@@ -7111,7 +7091,6 @@ export function registerLanesCommand(parent, deps = {}) {
     registerLaneReportCommands(lanes, {
         hqRoot: ctx.hqRoot,
         resolveCompany: ctx.resolveCompany,
-        trackerEnabled: ctx.laneTrackerEnabled,
         now: ctx.now,
         readQuestionBody: (root, question) => {
             const body = questionHandlers.requireQuestionBody(root, question);
@@ -7124,6 +7103,7 @@ export function registerLanesCommand(parent, deps = {}) {
         resolveCompany: ctx.resolveCompany,
         now: ctx.now,
         env: ctx.env,
+        mergeHoldEnabled: ctx.mergeHoldEnabled,
         mergeReviewEnabled: ctx.mergeReviewEnabled,
     }, wrap);
     registerLaneReviewCommand(lanes, {

package/dist/lib/doctor/checks/scaffold-cli-floor.d.ts

@@ -0,0 +1,7 @@
+import type { CheckContext, CheckFamily, CheckResult } from "../types.js";
+export declare const SCAFFOLD_CLI_FLOOR_FAMILY_ID = "scaffold-cli-floor";
+export declare const SCAFFOLD_CLI_FLOOR_FAMILY_TITLE = "Scaffold CLI compatibility";
+export declare const SCAFFOLD_CLI_FLOOR_CHECK_ID = "scaffold-cli-floor.requires-hq-cli";
+export declare const scaffoldCliFloorFamily: CheckFamily;
+export declare function checkScaffoldCliFloor(context: CheckContext): CheckResult[];
+//# sourceMappingURL=scaffold-cli-floor.d.ts.map

package/dist/lib/doctor/checks/scaffold-cli-floor.js

@@ -0,0 +1,73 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as yaml from "js-yaml";
+import { CLI_VERSION } from "../../../cli-version.js";
+import { compareScaffoldCliFloor } from "../../scaffold-cli-floor.js";
+export const SCAFFOLD_CLI_FLOOR_FAMILY_ID = "scaffold-cli-floor";
+export const SCAFFOLD_CLI_FLOOR_FAMILY_TITLE = "Scaffold CLI compatibility";
+export const SCAFFOLD_CLI_FLOOR_CHECK_ID = "scaffold-cli-floor.requires-hq-cli";
+export const scaffoldCliFloorFamily = {
+    id: SCAFFOLD_CLI_FLOOR_FAMILY_ID,
+    title: SCAFFOLD_CLI_FLOOR_FAMILY_TITLE,
+    run: (context) => Promise.resolve(checkScaffoldCliFloor(context)),
+};
+export function checkScaffoldCliFloor(context) {
+    const coreYamlPath = path.join(context.hqRoot, "core", "core.yaml");
+    if (!fs.existsSync(coreYamlPath)) {
+        return [skipped(coreYamlPath, "core/core.yaml is missing")];
+    }
+    let document;
+    try {
+        document = yaml.load(fs.readFileSync(coreYamlPath, "utf8"));
+    }
+    catch {
+        return [
+            {
+                status: "WARN",
+                checkId: SCAFFOLD_CLI_FLOOR_CHECK_ID,
+                target: coreYamlPath,
+                message: "core/core.yaml could not be parsed, so the hq-cli floor was not checked.",
+            },
+        ];
+    }
+    if (!document || typeof document !== "object" || Array.isArray(document)) {
+        if (document === undefined || document === null) {
+            return [skipped(coreYamlPath, "core/core.yaml does not declare requiresHqCli")];
+        }
+        return [
+            {
+                status: "WARN",
+                checkId: SCAFFOLD_CLI_FLOOR_CHECK_ID,
+                target: coreYamlPath,
+                message: "core/core.yaml is not a mapping, so the hq-cli floor was not checked.",
+            },
+        ];
+    }
+    const required = document.requiresHqCli;
+    const comparison = compareScaffoldCliFloor(required, CLI_VERSION);
+    if (comparison.status === "skip") {
+        return [skipped(coreYamlPath, "core/core.yaml does not declare requiresHqCli")];
+    }
+    return [
+        {
+            status: comparison.status === "pass"
+                ? "PASS"
+                : comparison.status === "fail"
+                    ? "FAIL"
+                    : "WARN",
+            checkId: SCAFFOLD_CLI_FLOOR_CHECK_ID,
+            target: coreYamlPath,
+            message: comparison.message,
+            ...(comparison.remediation ? { remediation: comparison.remediation } : {}),
+        },
+    ];
+}
+function skipped(target, reason) {
+    return {
+        status: "NA",
+        checkId: SCAFFOLD_CLI_FLOOR_CHECK_ID,
+        target,
+        message: `Skipped: ${reason}; no hq-cli floor was checked.`,
+    };
+}
+//# sourceMappingURL=scaffold-cli-floor.js.map

package/dist/lib/doctor/registry.js

@@ -23,6 +23,7 @@ import { integrationsFamily } from "./checks/integrations.js";
 import { syncHealthFamily } from "./checks/sync-health.js";
 import { workContextFamily } from "./checks/work-context.js";
 import { botsFamily } from "./checks/bots.js";
+import { scaffoldCliFloorFamily } from "./checks/scaffold-cli-floor.js";
 import { fixtureCoverageFamily } from "./fixtures/discover.js";
 import { checkClaudeWiring } from "./checks/claude-wiring.js";
 /**
@@ -236,6 +237,7 @@ function hasCommandHook(settings, event) {
 export function createDefaultRegistry() {
     const registry = new DoctorRegistry();
     registry.register(hooksFamily);
+    registry.register(scaffoldCliFloorFamily);
     // Fixture coverage (US-007): reports UNTESTED for every registered hook with
     // no fixture and prints the tested/total coverage line. A separate family so
     // it needs no change to the hooks tier, per the registry's extensibility

package/dist/lib/lanes/hire-grant-dispatch.d.ts

@@ -5,15 +5,20 @@ export interface HireGrantLaneSnapshot {
     state: LaneState;
     senior: SeniorRef;
     hire_grant?: number;
+    created_at?: string;
+    company?: LaneRecord["company"];
+    project_id?: string;
+    worker_profile?: string;
 }
 export interface OutpostHireGrantContext {
     schema_version: typeof HIRE_GRANT_CONTEXT_SCHEMA;
     enforcement_enabled: boolean;
     expected_senior: SeniorRef;
     hierarchy: HireGrantLaneSnapshot[];
+    superseded_message_caller_id?: string;
 }
 /** Encode only the owner-relevant hierarchy from the primary's complete store. */
-export declare function createOutpostHireGrantContext(target: LaneRecord, lanes: readonly LaneRecord[]): string;
+export declare function createOutpostHireGrantContext(target: LaneRecord, lanes: readonly LaneRecord[], supersededMessageCallerId?: string): string;
 /** Decode and validate an owner grant context, binding it to the target lane. */
 export declare function parseOutpostHireGrantContext(encoded: string, targetLaneId: string): OutpostHireGrantContext;
 export declare function sameHireGrantSenior(a: SeniorRef, b: SeniorRef): boolean;

package/dist/lib/lanes/hire-grant-dispatch.js

@@ -20,11 +20,17 @@ function snapshot(lane) {
         lane_id: lane.lane_id,
         state: lane.state,
         senior: copySenior(lane.senior),
+        created_at: lane.created_at,
+        ...(lane.company === undefined
+            ? {}
+            : { company: lane.company === null ? null : { ...lane.company } }),
+        ...(lane.project_id === undefined ? {} : { project_id: lane.project_id }),
+        ...(lane.worker_profile === undefined ? {} : { worker_profile: lane.worker_profile }),
         ...(lane.hire_grant === undefined ? {} : { hire_grant: lane.hire_grant }),
     };
 }
 /** Encode only the owner-relevant hierarchy from the primary's complete store. */
-export function createOutpostHireGrantContext(target, lanes) {
+export function createOutpostHireGrantContext(target, lanes, supersededMessageCallerId) {
     const current = lanes.find((lane) => lane.lane_id === target.lane_id);
     if (!current || !sameSenior(current.senior, target.senior)) {
         throw new LanesError("hire_grant_hierarchy_unavailable", `Cannot build an authoritative hire-grant hierarchy for lane ${target.lane_id}`, { lane_id: target.lane_id });
@@ -45,6 +51,20 @@ export function createOutpostHireGrantContext(target, lanes) {
     for (const child of aliveDirectChildren(lanes, current.lane_id)) {
         relevant.set(child.lane_id, child);
     }
+    if (supersededMessageCallerId !== undefined) {
+        const messageCaller = lanes.find((lane) => lane.lane_id === supersededMessageCallerId);
+        const companyUid = current.company?.uid;
+        const projectId = current.project_id;
+        if (!messageCaller || !companyUid || !projectId ||
+            messageCaller.company?.uid !== companyUid || messageCaller.project_id !== projectId) {
+            throw new LanesError("hire_grant_message_caller_invalid", `Cannot include an unverified message caller ${supersededMessageCallerId} in lane ${target.lane_id}'s Outpost context`, { lane_id: target.lane_id, caller_lane_id: supersededMessageCallerId });
+        }
+        for (const candidate of lanes) {
+            if (candidate.company?.uid === companyUid && candidate.project_id === projectId) {
+                relevant.set(candidate.lane_id, candidate);
+            }
+        }
+    }
     const hierarchy = [...relevant.values()]
         .map(snapshot)
         .sort((a, b) => a.lane_id.localeCompare(b.lane_id));
@@ -56,6 +76,9 @@ export function createOutpostHireGrantContext(target, lanes) {
         enforcement_enabled: true,
         expected_senior: copySenior(current.senior),
         hierarchy,
+        ...(supersededMessageCallerId === undefined
+            ? {}
+            : { superseded_message_caller_id: supersededMessageCallerId }),
     };
     const encoded = Buffer.from(JSON.stringify(context), "utf8").toString("base64url");
     if (Buffer.byteLength(encoded, "utf8") > MAX_CONTEXT_BYTES) {
@@ -86,7 +109,9 @@ function parseLaneSnapshot(value) {
     if (value === null || typeof value !== "object" || Array.isArray(value))
         return null;
     const record = value;
-    if (Object.keys(record).some((key) => !["lane_id", "state", "senior", "hire_grant"].includes(key)))
+    if (Object.keys(record).some((key) => ![
+        "lane_id", "state", "senior", "hire_grant", "created_at", "company", "project_id", "worker_profile",
+    ].includes(key)))
         return null;
     if (typeof record.lane_id !== "string" || !record.lane_id.trim())
         return null;
@@ -99,11 +124,44 @@ function parseLaneSnapshot(value) {
         (typeof record.hire_grant !== "number" || !Number.isSafeInteger(record.hire_grant) || record.hire_grant < 0)) {
         return null;
     }
+    if (record.created_at !== undefined &&
+        (typeof record.created_at !== "string" || !record.created_at.trim() || !Number.isFinite(Date.parse(record.created_at)))) {
+        return null;
+    }
+    if (record.project_id !== undefined &&
+        (typeof record.project_id !== "string" || !record.project_id.trim() || record.project_id.trim() !== record.project_id)) {
+        return null;
+    }
+    if (record.worker_profile !== undefined &&
+        (typeof record.worker_profile !== "string" || !record.worker_profile.trim())) {
+        return null;
+    }
+    let company;
+    if (Object.hasOwn(record, "company")) {
+        if (record.company === null) {
+            company = null;
+        }
+        else if (record.company !== null && typeof record.company === "object" && !Array.isArray(record.company)) {
+            const companyRecord = record.company;
+            if (Object.keys(companyRecord).some((key) => key !== "slug" && key !== "uid") ||
+                typeof companyRecord.slug !== "string" || !companyRecord.slug.trim() ||
+                typeof companyRecord.uid !== "string" || !companyRecord.uid.trim())
+                return null;
+            company = { slug: companyRecord.slug, uid: companyRecord.uid };
+        }
+        else {
+            return null;
+        }
+    }
     return {
         lane_id: record.lane_id,
         state: record.state,
         senior,
         ...(record.hire_grant === undefined ? {} : { hire_grant: record.hire_grant }),
+        ...(record.created_at === undefined ? {} : { created_at: record.created_at }),
+        ...(company === undefined ? {} : { company }),
+        ...(record.project_id === undefined ? {} : { project_id: record.project_id }),
+        ...(record.worker_profile === undefined ? {} : { worker_profile: record.worker_profile }),
     };
 }
 /** Decode and validate an owner grant context, binding it to the target lane. */
@@ -125,7 +183,7 @@ export function parseOutpostHireGrantContext(encoded, targetLaneId) {
         throw contextError("Outpost grant context must be an object");
     }
     const record = raw;
-    if (Object.keys(record).some((key) => !["schema_version", "enforcement_enabled", "expected_senior", "hierarchy"].includes(key))) {
+    if (Object.keys(record).some((key) => !["schema_version", "enforcement_enabled", "expected_senior", "hierarchy", "superseded_message_caller_id"].includes(key))) {
         throw contextError("Outpost grant context contains unknown fields");
     }
     if (record.schema_version !== HIRE_GRANT_CONTEXT_SCHEMA ||
@@ -135,6 +193,11 @@ export function parseOutpostHireGrantContext(encoded, targetLaneId) {
         throw contextError("Outpost grant context has an unsupported or incomplete shape");
     }
     const expectedSenior = parseSenior(record.expected_senior);
+    const messageCallerId = record.superseded_message_caller_id;
+    if (messageCallerId !== undefined &&
+        (typeof messageCallerId !== "string" || !messageCallerId.trim() || messageCallerId.trim() !== messageCallerId)) {
+        throw contextError("Outpost grant context contains an invalid superseded-message caller");
+    }
     const hierarchy = record.hierarchy.map(parseLaneSnapshot);
     if (!expectedSenior || hierarchy.some((lane) => lane === null)) {
         throw contextError("Outpost grant context contains an invalid senior or lane snapshot");
@@ -152,11 +215,23 @@ export function parseOutpostHireGrantContext(encoded, targetLaneId) {
         (!expectedSenior.id || !byId.has(expectedSenior.id))) {
         throw contextError("Outpost grant context is missing the target's senior lane");
     }
+    if (messageCallerId !== undefined && !byId.has(messageCallerId)) {
+        throw contextError("Outpost grant context is missing its superseded-message caller lane");
+    }
+    if (messageCallerId !== undefined) {
+        const caller = byId.get(messageCallerId);
+        if (snapshots.some((lane) => lane.created_at === undefined || !Object.hasOwn(lane, "company")) ||
+            !target.company?.uid || !target.project_id ||
+            caller?.company?.uid !== target.company.uid || caller.project_id !== target.project_id) {
+            throw contextError("Outpost grant context is missing its superseded-message hierarchy metadata");
+        }
+    }
     return {
         schema_version: HIRE_GRANT_CONTEXT_SCHEMA,
         enforcement_enabled: record.enforcement_enabled,
         expected_senior: expectedSenior,
         hierarchy: snapshots,
+        ...(messageCallerId === undefined ? {} : { superseded_message_caller_id: messageCallerId }),
     };
 }
 export function sameHireGrantSenior(a, b) {

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

@@ -7,6 +7,7 @@ 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;
+export type KeepAliveLane = Pick<LaneRecord, "lane_id" | "created_at" | "senior" | "company" | "project_id"> & Partial<Pick<LaneRecord, "mesh_company" | "worker_profile" | "hire_grant" | "provider_session_id" | "last_resume" | "state">>;
 export interface LaneTerminalResumeResult {
     lane: LaneRecord;
     resumeQueued: boolean;
@@ -40,7 +41,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[], lineageAware?: boolean, companyForLane?: (lane: LaneRecord) => LaneRecord["company"]): LaneRecord | undefined;
-export declare function keepAliveExclusion(lane: LaneRecord, lanes: readonly LaneRecord[], retiredLaneIds: ReadonlySet<string>, lineageAware?: boolean, companyForLane?: (lane: LaneRecord) => LaneRecord["company"]): "retired" | "superseded" | undefined;
+export declare function keepAliveSupersededBy<T extends KeepAliveLane>(lane: T, lanes: readonly T[], lineageAware?: boolean, companyForLane?: (lane: T) => T["company"]): T | undefined;
+export declare function keepAliveExclusion<T extends KeepAliveLane>(lane: T, lanes: readonly T[], retiredLaneIds: ReadonlySet<string>, lineageAware?: boolean, companyForLane?: (lane: T) => T["company"]): "retired" | "superseded" | undefined;
 export declare function leadLaneKeepAliveBackoffMs(attempt: number): number;
 //# sourceMappingURL=keep-alive.d.ts.map

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

@@ -204,7 +204,7 @@ export function keepAliveSupersededBy(lane, lanes, lineageAware = LANE_SUPERSESS
     if (!Number.isFinite(createdAt))
         return undefined;
     const companyOf = companyForLane ?? ((candidate) => candidate.company);
-    const laneCompany = companyOf(lane);
+    const laneCompany = companyOf(lane) ?? null;
     const lanesById = new Map(lanes.map((candidate) => [candidate.lane_id, candidate]));
     lanesById.set(lane.lane_id, lane);
     const sessionOwners = new Map();
@@ -223,7 +223,7 @@ export function keepAliveSupersededBy(lane, lanes, lineageAware = LANE_SUPERSESS
             return false;
         if (candidate.state === "cancelled" || candidate.state === "killed" || candidate.state === "failed")
             return false;
-        const candidateCompany = companyOf(candidate);
+        const candidateCompany = companyOf(candidate) ?? null;
         const sameCompany = laneCompany === null
             ? candidateCompany === null
             : candidateCompany?.uid === laneCompany.uid;

package/dist/lib/lanes/merge-command.d.ts

@@ -8,6 +8,7 @@ export interface MergeCommandTarget {
 export interface MergeCommandParseResult {
     targets: MergeCommandTarget[];
     unresolved: boolean;
+    unparseableMerge: boolean;
 }
 export declare function canonicalRepo(raw: string): string;
 export declare function parseMergeCommands(command: string): MergeCommandParseResult;