@indigoai-us/hq-cli 5.345.107 → 5.345.109

package/dist/lib/lanes/store.js

@@ -742,15 +742,15 @@ export function parseLaneRecord(raw, filePath) {
     if (!isLaneProvider(raw.provider)) {
         throw new LaneSchemaError(`Unknown provider ${JSON.stringify(raw.provider)}`, { path: filePath, value: raw.provider });
     }
-    if (raw.provider_source !== undefined && !["cli", "profile", "default"].includes(String(raw.provider_source))) {
-        throw new LaneSchemaError("provider_source must be cli, profile, or default", {
+    if (raw.provider_source !== undefined && !["cli", "profile", "default", "auto"].includes(String(raw.provider_source))) {
+        throw new LaneSchemaError("provider_source must be cli, profile, default, or auto", {
             path: filePath,
             field: "provider_source",
             value: raw.provider_source,
         });
     }
-    if (raw.account_source !== undefined && !["cli", "profile", "balanced"].includes(String(raw.account_source))) {
-        throw new LaneSchemaError("account_source must be cli, profile, or balanced", {
+    if (raw.account_source !== undefined && !["cli", "profile", "balanced", "auto"].includes(String(raw.account_source))) {
+        throw new LaneSchemaError("account_source must be cli, profile, balanced, or auto", {
             path: filePath,
             field: "account_source",
             value: raw.account_source,

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

@@ -614,15 +614,31 @@ export interface LaneRecord {
     provider: LaneProvider;
     /** Open each Claude turn as a named Remote Control session using account a's login. */
     remote_control?: boolean;
-    /** Whether provider came from an explicit create override or the worker profile/default. */
-    provider_source?: "cli" | "profile" | "default";
+    /** Whether provider came from an explicit create override, the router (`--account auto`), or the worker profile/default. */
+    provider_source?: "cli" | "profile" | "default" | "auto";
     account?: string;
-    /** Explicit create account choices remain pinned during profile refreshes. */
-    account_source?: "cli" | "profile" | "balanced";
+    /** Explicit create account choices remain pinned during profile refreshes. `auto` means the router picked the account. */
+    account_source?: "cli" | "profile" | "balanced" | "auto";
     /** Reuse snapshots the worker profile's resolved settings for the new story. */
     profile_settings_pinned?: boolean;
     /** Recent Claude account-selection evidence for a create or automatic resume move. */
     account_selection?: LaneAccountSelection;
+    /**
+     * Router evidence recorded when `--account auto` picked this lane's account
+     * via `pickAccount` (src/lib/capacity/route.ts). Written once at creation.
+     */
+    account_pick?: {
+        /**
+         * Semicolon-joined reason parts from pickAccount, e.g.
+         * `"82% left on claude weekly; 1 live lane already on it"`
+         * or `"nothing used yet on any limit"`.
+         */
+        why: string;
+        /** Headroom percent of the binding limit at pick time (0-100). */
+        headroom: number;
+        /** Composite score at pick time: headroom - live*penalty + resetSoonBonus - oldReadingPenalty. */
+        score: number;
+    };
     /** Eligible accounts for a queue entry created without an explicit account. */
     admission_accounts?: string[];
     /**

package/dist/lib/lanes/types.js

@@ -235,7 +235,7 @@ export const LANE_FIELD_WRITERS = {
     pickup_validation_pending_since: ["creator", "command", "spawn", "reconcile"],
     priority: ["command"], worker: ["creator", "command"], worker_path: ["creator", "command"], worker_pack: ["creator", "command"], worker_profile: ["creator", "command"], worker_profile_hash: ["creator", "command", "spawn"], registry_worker: ["creator", "command", "spawn"], registry_worker_approval_history: ["command", "watcher", "reconcile"], worker_profile_repin_history: ["command"], worker_profile_ignored: ["creator", "command", "spawn"], worker_policy_delivery: ["command", "spawn"],
     keep_alive: ["creator", "command"], keep_alive_standing: ["command"], keep_alive_opted_in_at: ["creator", "command"], keep_alive_blocked_reason: ["command", "reconcile"], keep_alive_resume_count: ["command", "reconcile", "spawn"], keep_alive_history: ["reconcile"], keep_alive_blocked_resume_streak: ["reconcile", "spawn", "watcher"], keep_alive_last_resume_at: ["command", "reconcile", "spawn"], keep_alive_next_eligible_at: ["command", "reconcile", "spawn"], keep_alive_exhausted_at: ["command", "reconcile", "spawn"], loop_mode: ["creator"],
-    provider: ["creator", "command"], remote_control: ["creator"], provider_source: ["creator", "command"], account: ["creator", "spawn", "command", "watcher", "reconcile"], account_source: ["creator", "command"], profile_settings_pinned: ["command"], account_selection: ["creator", "command"], admission_accounts: ["creator", "command"], account_history: ["command", "spawn", "watcher", "reconcile"], failed_resume_history: ["command"], fallback_question_cancellation_failures: ["command"], pending_resume: ["command", "spawn", "watcher", "reconcile"], placement_default: ["creator"], host: ["creator", "command"], origin_host: ["creator"], origin_host_source: ["creator"],
+    provider: ["creator", "command"], remote_control: ["creator"], provider_source: ["creator", "command"], account: ["creator", "spawn", "command", "watcher", "reconcile"], account_source: ["creator", "command"], profile_settings_pinned: ["command"], account_selection: ["creator", "command"], account_pick: ["creator"], admission_accounts: ["creator", "command"], account_history: ["command", "spawn", "watcher", "reconcile"], failed_resume_history: ["command"], fallback_question_cancellation_failures: ["command"], pending_resume: ["command", "spawn", "watcher", "reconcile"], placement_default: ["creator"], host: ["creator", "command"], origin_host: ["creator"], origin_host_source: ["creator"],
     version: ["creator"], created_at: ["creator"], updated_at: ["creator"], ended_at: ["reconcile"], envelope_summary: ["reconcile"], attribution_history: ["command", "watcher", "reconcile"], story_switch_pending: ["command", "watcher", "reconcile"], story_switch_unacknowledged: ["command", "watcher", "reconcile"],
     last_envelope: ["watcher", "reconcile"], model: ["creator", "spawn", "command"], model_source: ["creator", "spawn", "command"], effort: ["creator", "spawn", "command"], effort_source: ["creator", "spawn", "command"], fast_mode: ["spawn"],
     last_message_at: ["creator", "command"], status_gate: ["spawn", "watcher"], status_gate_history: ["watcher", "reconcile"], blocker_freshness_state: ["watcher"], kr_freshness_state: ["watcher"], last_compaction: ["spawn"], story_complete: ["watcher", "reconcile"], story_complete_reason: ["watcher", "reconcile"], story_status: ["watcher", "reconcile"],

package/dist/utils/package-use-lease.d.ts

@@ -1,4 +1,12 @@
 export declare const PACKAGE_USE_LEASE_HANDOFF_ENV = "HQ_CLI_PACKAGE_USE_LEASE_HANDOFF";
+/**
+ * How long a command waits for a live updater before giving up. A desktop
+ * `npm install -g` after a reboot routinely runs for minutes (seen ~3 min on
+ * 2026-10-13), so a 30s bound made ordinary commands fail mid-session.
+ * Override with HQ_CLI_UPDATE_WAIT_MS (0 disables waiting).
+ */
+export declare const DEFAULT_UPDATE_WAIT_MS = 240000;
+export declare function updateWaitTimeoutMs(env?: NodeJS.ProcessEnv): number;
 export declare const PACKAGE_USE_LEASE_PURPOSES: readonly ["command", "resident-preload", "mcp-serve", "hook", "daemon"];
 export type PackageUseLeasePurpose = (typeof PACKAGE_USE_LEASE_PURPOSES)[number];
 export declare class PackageUseUpdatePendingError extends Error {
@@ -17,7 +25,7 @@ export interface PackageUseLeaseHandoff {
 }
 export declare function npmPrefix(root: string, platform?: NodeJS.Platform): string | null;
 export declare function packageUseLeaseDirectory(prefix: string, stateDirectory?: string): string;
-declare function waitForUpdateRequest(requestPath: string, timeoutMs: number): void;
+declare function waitForUpdateRequest(requestPath: string, timeoutMs: number, notify?: (() => void) | null): void;
 export declare function acquirePackageUseLease(prefix: string, hqVersion: string, stateDirectory?: string, purpose?: PackageUseLeasePurpose): PackageUseLease;
 /**
  * Create a bounded, per-reexec rendezvous in the current lease directory.
@@ -42,6 +50,12 @@ export declare function releasePackageUseLeaseAfterCommandLoad(_argv?: readonly
 export declare function releasePackageUseLeaseAfterResidentPreload(preload: () => Promise<void>, reportFailure: (error: unknown) => void, release?: () => void): Promise<void>;
 /** True only when a valid update request belongs to a live updater process. */
 export declare function packageUseUpdatePending(prefix: string, stateDirectory?: string): boolean;
+/**
+ * Block (bounded) until a live updater's request for this install clears.
+ * Returns true when no update is pending any more, false on timeout or when
+ * this is not a lease-managed install.
+ */
+export declare function waitForCurrentPackageUseUpdate(timeoutMs?: number): boolean;
 /** True while the desktop updater owns the per-prefix update request. */
 export declare function currentPackageUseUpdatePending(): boolean;
 /** True while the desktop updater owns the per-prefix update request. */

package/dist/utils/package-use-lease.js

@@ -9,6 +9,19 @@ const CLI_NAME = "@indigoai-us/hq-cli";
 const UPDATE_REQUEST = "update.pending.json";
 export const PACKAGE_USE_LEASE_HANDOFF_ENV = "HQ_CLI_PACKAGE_USE_LEASE_HANDOFF";
 const HANDOFF_TIMEOUT_MS = 2_000;
+/**
+ * How long a command waits for a live updater before giving up. A desktop
+ * `npm install -g` after a reboot routinely runs for minutes (seen ~3 min on
+ * 2026-10-13), so a 30s bound made ordinary commands fail mid-session.
+ * Override with HQ_CLI_UPDATE_WAIT_MS (0 disables waiting).
+ */
+export const DEFAULT_UPDATE_WAIT_MS = 240_000;
+export function updateWaitTimeoutMs(env = process.env) {
+    const raw = env.HQ_CLI_UPDATE_WAIT_MS?.trim();
+    if (!raw || !/^\d+$/.test(raw))
+        return DEFAULT_UPDATE_WAIT_MS;
+    return Math.min(Number(raw), 30 * 60 * 1000);
+}
 const PACKAGE_USE_LEASE_HEARTBEAT_INTERVAL_MS = 5 * 60 * 1000;
 let packageUseLeaseHeartbeatIntervalMs = PACKAGE_USE_LEASE_HEARTBEAT_INTERVAL_MS;
 export const PACKAGE_USE_LEASE_PURPOSES = [
@@ -139,8 +152,9 @@ export function packageUseLeaseDirectory(prefix, stateDirectory = packageUseStat
 function packageUseUpdateRequestPath(prefix, stateDirectory) {
     return path.join(packageUseLeaseDirectory(prefix, stateDirectory), UPDATE_REQUEST);
 }
-function waitForUpdateRequest(requestPath, timeoutMs) {
+function waitForUpdateRequest(requestPath, timeoutMs, notify = null) {
     const started = Date.now();
+    let notified = false;
     const sleeper = new Int32Array(new SharedArrayBuffer(4));
     while (true) {
         try {
@@ -167,9 +181,16 @@ function waitForUpdateRequest(requestPath, timeoutMs) {
         if (Date.now() - started >= timeoutMs) {
             throw new PackageUseUpdatePendingError("The HQ CLI package is being updated; retry after the update finishes");
         }
+        if (!notified && notify) {
+            notified = true;
+            notify();
+        }
         Atomics.wait(sleeper, 0, 0, 100);
     }
 }
+function notifyWaitingForUpdate() {
+    process.stderr.write("hq-cli: waiting for the HQ CLI update to finish...\n");
+}
 export function acquirePackageUseLease(prefix, hqVersion, stateDirectory, purpose = "command") {
     const directory = packageUseLeaseDirectory(prefix, stateDirectory);
     mkdirSync(directory, { recursive: true, mode: 0o700 });
@@ -219,7 +240,7 @@ export function acquirePackageUseLease(prefix, hqVersion, stateDirectory, purpos
     };
     const releaseOnExit = () => release();
     for (let attempt = 0; attempt < 2; attempt += 1) {
-        waitForUpdateRequest(requestPath, 30_000);
+        waitForUpdateRequest(requestPath, updateWaitTimeoutMs(), notifyWaitingForUpdate);
         try {
             writeFileSync(tempPath, `${JSON.stringify(record)}\n`, { flag: "wx", mode: 0o600 });
             renameSync(tempPath, leasePath);
@@ -407,6 +428,28 @@ export function packageUseUpdatePending(prefix, stateDirectory) {
         throw error;
     }
 }
+/**
+ * Block (bounded) until a live updater's request for this install clears.
+ * Returns true when no update is pending any more, false on timeout or when
+ * this is not a lease-managed install.
+ */
+export function waitForCurrentPackageUseUpdate(timeoutMs = updateWaitTimeoutMs()) {
+    const pkg = findCliPackage(path.dirname(fileURLToPath(import.meta.url)));
+    if (!pkg || isPnpmGlobal(pkg.root) || isBunGlobal(pkg.root))
+        return false;
+    const prefix = npmPrefix(pkg.root);
+    if (!prefix)
+        return false;
+    try {
+        waitForUpdateRequest(packageUseUpdateRequestPath(prefix), timeoutMs, notifyWaitingForUpdate);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof PackageUseUpdatePendingError)
+            return false;
+        throw error;
+    }
+}
 /** True while the desktop updater owns the per-prefix update request. */
 export function currentPackageUseUpdatePending() {
     const pkg = findCliPackage(path.dirname(fileURLToPath(import.meta.url)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.345.107",
+  "version": "5.345.109",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {
@@ -48,7 +48,7 @@
     "@aws-sdk/client-iot-data-plane": "^3.1096.0",
     "@aws-sdk/client-s3": "^3.1049.0",
     "@aws-sdk/dsql-signer": "^3.1146.0",
-    "@indigoai-us/hq-cloud": "~6.18.66",
+    "@indigoai-us/hq-cloud": "~6.18.67",
     "@indigoai-us/hq-flags-client": "^0.1.2",
     "@modelcontextprotocol/sdk": "1.29.0",
     "@sentry/node": "^10.49.0",