@indigoai-us/hq-cli 5.345.127 → 5.345.129

package/dist/lib/lanes/watcher.js

@@ -43,7 +43,7 @@ import { appendCappedHistory, listQuestionIds, readLane, readQuestion, retryUpda
 import { enforceRegistryApprovalGate } from "./approval-gate.js";
 import { readWorkerRunResult } from "./delivery.js";
 import { applyDefaultQuotaHold, clearAccountQuotaAfterSuccessfulTurnBestEffort, quotaSignalFromFields, readQuotaSignal, recordAccountQuota, } from "./quota.js";
-import { deliverQuotaHoldNotice, quotaHoldNotice } from "./quota-notice.js";
+import { deliverQuotaNotice as deliverQuotaNoticeToSenior, quotaLaneNotice } from "./quota-notice.js";
 import { PROVIDER_REJECTED_REASON, QUOTA_STATUS, isProviderLoginFailure, providerRejectionDetails, readProviderRejection, } from "./provider-rejection.js";
 import { appendDropboxMessageAtPath, dropboxInboxHasMessages, readToolActivity, toolActivityPath } from "./dropbox.js";
 import { loadLanesConfig, providerProgressEventMinIntervalMs, providerQuotaDefaultHoldMs } from "./config.js";
@@ -154,14 +154,15 @@ function validFailureOutputTime(value, fallback) {
         : fallback;
 }
 export function routeProviderFailure(failure, readQuota, model, now) {
+    const structured = failure && failure.resets_at !== undefined ? { resets_at: failure.resets_at } : {};
     if (failure && failure.status === QUOTA_STATUS && isAccountQuotaFailure(failure)) {
         return {
-            quota: quotaSignalFromFields({ api_error_status: QUOTA_STATUS, is_error: true, result: failure.message }, model, failure.output_at ? validFailureOutputTime(failure.output_at, now) : now),
+            quota: quotaSignalFromFields({ api_error_status: QUOTA_STATUS, is_error: true, result: failure.message, ...structured }, model, failure.output_at ? validFailureOutputTime(failure.output_at, now) : now),
             rejection: null,
         };
     }
     if (failure && failure.status === null && isAccountQuotaFailure(failure)) {
-        const quota = quotaSignalFromFields({ api_error_status: undefined, is_error: true, result: failure.message }, model, failure.output_at ? validFailureOutputTime(failure.output_at, now) : now);
+        const quota = quotaSignalFromFields({ api_error_status: undefined, is_error: true, result: failure.message, ...structured }, model, failure.output_at ? validFailureOutputTime(failure.output_at, now) : now);
         if (quota)
             return { quota, rejection: null };
     }
@@ -1167,6 +1168,28 @@ async function settleKrFreshness(hqRoot, lane, manifestTurnId, at, deps, logDeci
         };
     });
 }
+/**
+ * Tell the lane's senior once that a usage limit ended this lane. Called
+ * only on the terminal write that changed the lane; the message id (lane id
+ * and version) dedupes a retried append.
+ */
+async function deliverQuotaNotice(hqRoot, lane, quota, at, deps, logDecision) {
+    const notice = quotaLaneNotice(lane, quota);
+    try {
+        if (deps.deliverQuotaNotice) {
+            await deps.deliverQuotaNotice(lane, notice.text);
+            logDecision({ event: "quota_notice", at, delivered_to: "test_seam" });
+            return;
+        }
+        const deliveredTo = deliverQuotaNoticeToSenior(hqRoot, lane, notice, at);
+        logDecision({ event: "quota_notice", at, delivered_to: deliveredTo });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`hq lanes watcher: quota notice failed for ${lane.lane_id}: ${message}\n`);
+        logDecision({ event: "quota_notice_failed", at, error: message });
+    }
+}
 function findBlockerFreshnessSessionInbox(hqRoot, sessionId) {
     let candidates;
     try {
@@ -1457,6 +1480,18 @@ async function runWatcherLoopOwned(hqRoot, laneId, deps) {
     }
     const progressIntervalMs = deps.progressEventMinIntervalMs ?? readProgressIntervalMs(hqRoot, readLaneSoft(hqRoot, laneId));
     const spawnRepair = deps.spawnRepair ?? spawnEnvelopeRepair;
+    const defaultAdmitQueued = async (root) => {
+        const { admitQueuedNow } = await import("./reconcile.js");
+        const host = (deps.resolveAdmissionHost ?? resolveProcessAdmissionHost)();
+        const result = await admitQueuedNow(root, {
+            now: () => new Date(now()),
+            host,
+            dryRun: false,
+            spawnLaneDeps: { ...deps.retrySpawnDeps, admissionHost: host },
+            ...(deps.retrySpawnDeps?.env ? { env: deps.retrySpawnDeps.env } : {}),
+        });
+        return result.admitted.map((entry) => entry.id);
+    };
     const retryAccount = deps.retryAccount ?? ((root, lane, reason) => retryLaneOnAlternateAccount(root, lane, reason, "watcher", {
         ...deps.retrySpawnDeps,
         admissionHost: (deps.resolveAdmissionHost ?? resolveProcessAdmissionHost)(),
@@ -1765,28 +1800,17 @@ async function runWatcherLoopOwned(hqRoot, laneId, deps) {
                     (classification.reason === "account_quota_exhausted" ||
                         classification.reason === "account_model_unavailable")) {
                     try {
-                        const observedAt = new Date(now());
-                        const quotaState = recordAccountQuota(hqRoot, quotaLane.provider, quotaLane.account, quota, {
-                            now: observedAt,
-                            unconfirmedHoldMs: providerQuotaDefaultHoldMs(loadLanesConfig(hqRoot).providers[quotaLane.provider]),
-                        });
-                        if (classification.reason === "account_quota_exhausted") {
-                            const notice = quotaHoldNotice(quotaState, quotaLane.provider, quotaLane.account, quotaLane.lane_id);
-                            if (notice) {
-                                const deliveredTo = deliverQuotaHoldNotice(hqRoot, quotaLane, notice, observedAt.toISOString());
-                                logDecision({ event: "quota_hold_notice", at: tick.emit.at, account: quotaLane.account, delivered_to: deliveredTo });
-                            }
-                        }
+                        recordAccountQuota(hqRoot, quotaLane.provider, quotaLane.account, quota, new Date(now()));
                     }
                     catch (err) {
                         process.stderr.write(`hq lanes watcher: quota record failed for ${laneId}: ${err instanceof Error ? err.message : String(err)}\n`);
                     }
                 }
-                const accountRetryReason = quota
-                    ? "usage_limit"
-                    : isProviderLoginFailure(providerRejection)
-                        ? "account_unavailable"
-                        : null;
+                // A usage limit fails only this lane: no automatic move to another
+                // account. The senior is told and decides (owner decision 2026-10-14).
+                const accountRetryReason = !quota && isProviderLoginFailure(providerRejection)
+                    ? "account_unavailable"
+                    : null;
                 if (accountRetryReason && quotaLane?.account) {
                     try {
                         const retry = await retryAccount(hqRoot, quotaLane, accountRetryReason);
@@ -1945,6 +1969,24 @@ async function runWatcherLoopOwned(hqRoot, laneId, deps) {
                         logDecision({ event: "keep_alive_terminal_trigger_failed", at: tick.emit.at, error: message });
                     }
                 }
+                if (terminalWrite.changed &&
+                    (updated.terminal_reason === "account_quota_exhausted" || updated.terminal_reason === "account_model_unavailable")) {
+                    await deliverQuotaNotice(hqRoot, updated, quota ?? null, tick.emit.at, deps, logDecision);
+                }
+                if (terminalWrite.changed && updated.state !== "running" && updated.state !== "queued") {
+                    // The exit freed a running slot: admit queued lanes here rather
+                    // than waiting for a reconcile pass that may never run.
+                    try {
+                        const admitted = await (deps.admitQueued ?? defaultAdmitQueued)(hqRoot);
+                        if (admitted.length > 0)
+                            logDecision({ event: "queue_admitted", at: tick.emit.at, admitted });
+                    }
+                    catch (err) {
+                        const message = err instanceof Error ? err.message : String(err);
+                        process.stderr.write(`hq lanes watcher: queue admission failed after ${laneId}: ${message}\n`);
+                        logDecision({ event: "queue_admission_failed", at: tick.emit.at, error: message });
+                    }
+                }
             }
         }
         lastSignalMs = tick.nextLastSignalMs;

package/dist/lib/mesh/live/daemon/work-subscribe.d.ts

@@ -14,7 +14,7 @@ export interface WorkCacheMqtt extends MeshMqttEventClient {
 export interface WorkCacheSubscriber {
     stop: () => Promise<void>;
 }
-export declare const AGENT_INBOX_PUSH_STATE_BASENAME = "agent-inbox-push.json";
+export { AGENT_INBOX_PUSH_STATE_BASENAME } from "../paths.js";
 export declare function startWorkCacheSubscriber(opts: {
     meshRoot: string;
     fetchCredentials?: PersonalCredentialsFetcher;

package/dist/lib/mesh/live/daemon/work-subscribe.js

@@ -8,7 +8,8 @@ import { createPersonalRealtimeFetcher, } from "./credentials.js";
 import { presignIotWssUrl } from "./presign.js";
 import { applyProjectViewPush, parseProjectViewPush } from "./live-cache.js";
 import { backoffDelayMs, RECONNECT_MIN_DELAY_MS } from "./presence.js";
-export const AGENT_INBOX_PUSH_STATE_BASENAME = "agent-inbox-push.json";
+import { AGENT_INBOX_PUSH_STATE_BASENAME } from "../paths.js";
+export { AGENT_INBOX_PUSH_STATE_BASENAME } from "../paths.js";
 const INBOX_PUSH_HEARTBEAT_MS = 5_000;
 function readInboxWakeSequence(meshRoot, onInfo) {
     const target = path.join(meshRoot, AGENT_INBOX_PUSH_STATE_BASENAME);
@@ -78,6 +79,7 @@ export async function startWorkCacheSubscriber(opts) {
     let heartbeatTimer = null;
     let generation = 0;
     let inboxSubscribed = false;
+    let inboxAgentUid;
     // Carry the sequence forward from the last state marker so a daemon restart
     // cannot reuse a value the watcher has already consumed.
     let wakeSequence = readInboxWakeSequence(opts.meshRoot, opts.onInfo);
@@ -92,6 +94,7 @@ export async function startWorkCacheSubscriber(opts) {
                 connected,
                 heartbeatAtMs: now().getTime(),
                 wakeSequence,
+                ...(connected && inboxAgentUid ? { agentUid: inboxAgentUid } : {}),
             });
         }
         catch (error) {
@@ -115,6 +118,7 @@ export async function startWorkCacheSubscriber(opts) {
         if (stopped)
             return;
         inboxSubscribed = false;
+        inboxAgentUid = undefined;
         clearInboxHeartbeat();
         persistInboxState(false);
         const gen = ++generation;
@@ -133,6 +137,7 @@ export async function startWorkCacheSubscriber(opts) {
             bundle.topics.inbox === `hq/${bundle.actorUid}/inbox`
             ? bundle.topics.inbox
             : undefined;
+        inboxAgentUid = inboxTopic ? bundle.actorUid : undefined;
         if (!topic && !inboxTopic) {
             opts.onInfo?.("work cache subscribe skipped: credentials have no supported topic");
             return;
@@ -175,6 +180,7 @@ export async function startWorkCacheSubscriber(opts) {
                         return;
                     if (err) {
                         inboxSubscribed = false;
+                        inboxAgentUid = undefined;
                         clearInboxHeartbeat();
                         persistInboxState(false);
                         opts.onInfo?.("agent inbox push subscribe failed");
@@ -212,6 +218,7 @@ export async function startWorkCacheSubscriber(opts) {
             if (stopped || gen !== generation)
                 return;
             inboxSubscribed = false;
+            inboxAgentUid = undefined;
             clearInboxHeartbeat();
             persistInboxState(false);
             schedule();

package/dist/lib/mesh/live/paths.d.ts

@@ -2,6 +2,8 @@
  * Local Work Mesh Live paths under ~/.hq/work-mesh/.
  * Injectable root for tests (never touch the real HOME in unit tests).
  */
+/** Content-free sequence file written by the mesh MQTT inbox subscriber. */
+export declare const AGENT_INBOX_PUSH_STATE_BASENAME = "agent-inbox-push.json";
 export declare function workMeshRoot(home?: string, env?: NodeJS.ProcessEnv): string;
 export declare function workMeshSpoolPath(root?: string): string;
 export declare function workMeshHeldPath(root?: string): string;

package/dist/lib/mesh/live/paths.js

@@ -5,6 +5,8 @@
 import * as os from "node:os";
 import * as path from "node:path";
 const WORK_MESH_DIRNAME = "work-mesh";
+/** Content-free sequence file written by the mesh MQTT inbox subscriber. */
+export const AGENT_INBOX_PUSH_STATE_BASENAME = "agent-inbox-push.json";
 export function workMeshRoot(home = os.homedir(), env = process.env) {
     const override = env.HQ_WORK_MESH_ROOT?.trim();
     if (override)

package/dist/lib/mesh/story-status.d.ts

@@ -5,8 +5,8 @@ export type BoardStoryStatus = (typeof BOARD_STORY_STATUSES)[number];
  * need attention, while `dropped` is terminal; the Board has only one terminal
  * column (`done`).
  */
-export declare const LEDGER_STATES: readonly ["todo", "in_progress", "review", "waiting", "blocked", "done", "dropped"];
-export declare const ACCEPTED_LEDGER_STATES: readonly ["todo", "in_progress", "review", "waiting", "blocked", "done", "dropped", "in_review", "verification"];
+export declare const LEDGER_STATES: readonly ["todo", "queued", "in_progress", "review", "waiting", "blocked", "done", "dropped"];
+export declare const ACCEPTED_LEDGER_STATES: readonly ["todo", "queued", "in_progress", "review", "waiting", "blocked", "done", "dropped", "in_review", "verification"];
 export declare class UnknownProjectStoryStateError extends Error {
     readonly source: string;
     readonly storyId: string;

package/dist/lib/mesh/story-status.js

@@ -6,10 +6,11 @@ const boardStoryStatusSet = new Set(BOARD_STORY_STATUSES);
  * column (`done`).
  */
 export const LEDGER_STATES = [
-    "todo", "in_progress", "review", "waiting", "blocked", "done", "dropped",
+    "todo", "queued", "in_progress", "review", "waiting", "blocked", "done", "dropped",
 ];
 const LEDGER_STATE_TO_BOARD_STATUS = {
     todo: "queued",
+    queued: "queued",
     in_progress: "in_progress",
     review: "review",
     // The four-column Board cannot represent waiting separately. Preserve the

package/dist/utils/resident-package-preload.js

@@ -53,21 +53,24 @@ export const RESIDENT_PACKAGE_MODULES = {
         "../lib/plan-limit-nag.js",
         "../utils/plan-gate-error.js",
         "../lib/daemon/mcp-oauth.js",
+        "../commands/lanes.js",
+        "commander",
         "@modelcontextprotocol/sdk/client/index.js",
         "@modelcontextprotocol/sdk/client/streamableHttp.js",
         "../utils/staged-npm-install.js",
         "open",
         "../lib/first-sync-next-step.js",
         "@indigoai-us/hq-cloud",
+        "../lib/lanes/reconcile.js",
     ],
     "daemon-logs-follow": [],
     "mesh-daemon": ["../sentry.js", "../lib/doctor/client-health-reason-codes-flag.js", "@indigoai-us/hq-flags-client", "../lib/plan-limit-nag.js", "../utils/plan-gate-error.js", "open", "../utils/cognito-session.js", "../lib/first-sync-next-step.js", "@indigoai-us/hq-cloud"],
-    "lanes-watch": ["../sentry.js", "../lib/doctor/client-health-reason-codes-flag.js", "@indigoai-us/hq-flags-client", "../lib/plan-limit-nag.js", "../utils/plan-gate-error.js", "open", "../utils/cognito-session.js", "../lib/first-sync-next-step.js", "@indigoai-us/hq-cloud"],
-    "monitor-wait": ["../sentry.js", "../lib/doctor/client-health-reason-codes-flag.js", "@indigoai-us/hq-flags-client", "../lib/plan-limit-nag.js", "../utils/plan-gate-error.js", "open", "../utils/cognito-session.js", "../lib/first-sync-next-step.js", "@indigoai-us/hq-cloud"],
-    "monitor-run": ["../commands/lanes.js", "../lib/plan-limit-nag.js", "../utils/plan-gate-error.js", "../sentry.js", "../lib/doctor/client-health-reason-codes-flag.js", "@indigoai-us/hq-flags-client", "open", "../utils/cognito-session.js", "../lib/first-sync-next-step.js", "@indigoai-us/hq-cloud"],
+    "lanes-watch": ["../sentry.js", "../lib/doctor/client-health-reason-codes-flag.js", "@indigoai-us/hq-flags-client", "../lib/plan-limit-nag.js", "../utils/plan-gate-error.js", "open", "../utils/cognito-session.js", "../lib/first-sync-next-step.js", "@indigoai-us/hq-cloud", "../lib/lanes/reconcile.js"],
+    "monitor-wait": ["../sentry.js", "../lib/doctor/client-health-reason-codes-flag.js", "@indigoai-us/hq-flags-client", "../lib/plan-limit-nag.js", "../utils/plan-gate-error.js", "open", "../utils/cognito-session.js", "../lib/first-sync-next-step.js", "@indigoai-us/hq-cloud", "../lib/lanes/reconcile.js"],
+    "monitor-run": ["../commands/lanes.js", "../lib/plan-limit-nag.js", "../utils/plan-gate-error.js", "../sentry.js", "../lib/doctor/client-health-reason-codes-flag.js", "@indigoai-us/hq-flags-client", "open", "../utils/cognito-session.js", "../lib/first-sync-next-step.js", "@indigoai-us/hq-cloud", "../lib/lanes/reconcile.js"],
     "agents-message-wait": ["../sentry.js", "../lib/doctor/client-health-reason-codes-flag.js", "@indigoai-us/hq-flags-client", "../lib/plan-limit-nag.js", "../utils/plan-gate-error.js", "open", "../utils/cognito-session.js", "../lib/first-sync-next-step.js", "@indigoai-us/hq-cloud"],
     "integrations-oauth-wait": ["../sentry.js", "../lib/doctor/client-health-reason-codes-flag.js", "@indigoai-us/hq-flags-client", "../lib/plan-limit-nag.js", "../utils/plan-gate-error.js", "open", "../utils/cognito-session.js", "../lib/first-sync-next-step.js", "@indigoai-us/hq-cloud"],
-    "outpost-wait": ["../commands/lanes.js", "../lib/plan-limit-nag.js", "../utils/plan-gate-error.js", "../sentry.js", "../lib/doctor/client-health-reason-codes-flag.js", "@indigoai-us/hq-flags-client", "open", "../utils/cognito-session.js", "../lib/first-sync-next-step.js", "@indigoai-us/hq-cloud"],
+    "outpost-wait": ["../commands/lanes.js", "../lib/plan-limit-nag.js", "../utils/plan-gate-error.js", "../sentry.js", "../lib/doctor/client-health-reason-codes-flag.js", "@indigoai-us/hq-flags-client", "open", "../utils/cognito-session.js", "../lib/first-sync-next-step.js", "@indigoai-us/hq-cloud", "../lib/lanes/reconcile.js"],
     "secrets-sandbox": [],
     "pkg-update": ["../sentry.js", "../lib/doctor/client-health-reason-codes-flag.js", "@indigoai-us/hq-flags-client", "../utils/cognito-session.js", "@indigoai-us/hq-cloud"],
     "pack-install": [
@@ -220,12 +223,15 @@ const LOADERS = {
         () => import("../lib/plan-limit-nag.js"),
         () => import("../utils/plan-gate-error.js"),
         () => import("../lib/daemon/mcp-oauth.js"),
+        () => import("../commands/lanes.js"),
+        () => import("commander"),
         () => import("@modelcontextprotocol/sdk/client/index.js"),
         () => import("@modelcontextprotocol/sdk/client/streamableHttp.js"),
         () => import("../utils/staged-npm-install.js"),
         () => import("open"),
         () => import("../lib/first-sync-next-step.js"),
         () => import("@indigoai-us/hq-cloud"),
+        () => import("../lib/lanes/reconcile.js"),
     ],
     "daemon-logs-follow": [],
     "mesh-daemon": [
@@ -255,6 +261,8 @@ const LOADERS = {
         () => import("../utils/cognito-session.js"),
         () => import("../lib/first-sync-next-step.js"),
         () => import("@indigoai-us/hq-cloud"),
+        // The watcher admits queued lanes in-process after a lane exits.
+        () => import("../lib/lanes/reconcile.js"),
     ],
     "monitor-wait": [
         async () => {
@@ -269,6 +277,8 @@ const LOADERS = {
         () => import("../utils/cognito-session.js"),
         () => import("../lib/first-sync-next-step.js"),
         () => import("@indigoai-us/hq-cloud"),
+        // The watcher admits queued lanes in-process after a lane exits.
+        () => import("../lib/lanes/reconcile.js"),
     ],
     "monitor-run": [
         () => import("../commands/lanes.js"),
@@ -284,6 +294,8 @@ const LOADERS = {
         () => import("../utils/cognito-session.js"),
         () => import("../lib/first-sync-next-step.js"),
         () => import("@indigoai-us/hq-cloud"),
+        // The watcher admits queued lanes in-process after a lane exits.
+        () => import("../lib/lanes/reconcile.js"),
     ],
     "agents-message-wait": [
         async () => {
@@ -327,6 +339,8 @@ const LOADERS = {
         () => import("../utils/cognito-session.js"),
         () => import("../lib/first-sync-next-step.js"),
         () => import("@indigoai-us/hq-cloud"),
+        // The watcher admits queued lanes in-process after a lane exits.
+        () => import("../lib/lanes/reconcile.js"),
     ],
     "secrets-sandbox": [],
     "pkg-update": [

package/package.json

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