@indigoai-us/hq-cli 5.228.3 → 5.228.4

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [5.228.4] — 2026-09-27
+
+### Fixed
+
+- Account history now distinguishes automatic moves caused by a quota hold, an
+  unavailable or logged-out account, or uneven load.
+
 ## [5.228.3] — 2026-09-27
 
 ### Fixed

package/dist/commands/lanes.js

@@ -5635,9 +5635,20 @@ async function selectAutomaticClaudeResumeAccount(ctx, lane, workerProfile, opti
         ...(model !== undefined ? { model } : {}),
         unavailableHosts: balanceHosts.unavailableHosts,
     });
+    const historyReason = lane.account === undefined
+        ? "load_balance"
+        : currentConfig?.enabled !== true
+            ? "account_unavailable"
+            : currentLogin === false
+                ? "recorded_account_logged_out"
+                : currentLogin !== true
+                    ? "account_unavailable"
+                    : quotaBlockFor(loadQuotaState(hqRoot), "claude", lane.account, model, ctx.now()).blocked
+                        ? "usage_limit"
+                        : "load_balance";
     return {
         selection: { ...selected, selected_at: ctx.now().toISOString() },
-        ...(repairUnavailableAccount ? { historyReason: "recorded_account_logged_out" } : {}),
+        historyReason,
         ...(preservedModel !== undefined ? { preservedModel } : {}),
     };
 }
@@ -6269,6 +6280,7 @@ async function applyClaudeBalanceMove(ctx, suggestion) {
     const moved = await prepareAccountMove(ctx, lane, {
         account: suggestion.to,
         cliModel: undefined,
+        accountHistoryReason: automaticBalanceMoveHistoryReason(ctx, lane),
         deferTurnStart: true,
     });
     return { lane_id: moved.lane.lane_id, host: moved.lane.host, from: moved.from ?? suggestion.from, to: moved.to, state: moved.lane.state };
@@ -6324,6 +6336,7 @@ async function runClaudeBalanceMoveTarget(ctx, laneId, opts) {
     const moved = await prepareAccountMove(ctx, lane, {
         account,
         cliModel: undefined,
+        accountHistoryReason: automaticBalanceMoveHistoryReason(ctx, lane),
         deferTurnStart: true,
     });
     printJson({
@@ -6335,6 +6348,32 @@ async function runClaudeBalanceMoveTarget(ctx, laneId, opts) {
         account: moved.lane.account,
     });
 }
+function automaticBalanceMoveHistoryReason(ctx, lane) {
+    const hqRoot = ctx.hqRoot();
+    const config = loadLanesConfig(hqRoot);
+    const accountId = lane.account;
+    if (accountId === undefined)
+        return "load_balance";
+    const source = config.providers[lane.provider].accounts[accountId];
+    if (source?.enabled !== true)
+        return "account_unavailable";
+    const login = accountStatus(lane.provider, accountId, config, {
+        existsSync: ctx.existsSync,
+        hostname: ctx.hostname(),
+        probe: ctx.probeProvider,
+        env: ctx.env,
+    }).logged_in;
+    if (login === false)
+        return "recorded_account_logged_out";
+    if (login !== true)
+        return "account_unavailable";
+    const provider = config.providers[lane.provider];
+    const model = lane.model ?? source.model ?? provider.model;
+    if (quotaBlockFor(loadQuotaState(hqRoot), lane.provider, accountId, model, ctx.now()).blocked) {
+        return "usage_limit";
+    }
+    return "load_balance";
+}
 function laneWithRecoveredProviderSession(hqRoot, lane) {
     const manifest = readSpawnManifest(laneRunDir(hqRoot, lane.lane_id));
     const sessionId = (typeof lane.provider_session_id === "string" && lane.provider_session_id.trim()

package/dist/lib/lanes/spawn.js

@@ -189,7 +189,7 @@ function selectSpawnAccount(input) {
     const operatorMovePending = lane.pending_resume !== undefined &&
         lane.account_history?.at(-1)?.reason === "operator_move";
     if (current === undefined || !current.enabled) {
-        reason = repairRecordedAccount ? "recorded_account_logged_out" : "account_unavailable";
+        reason = "account_unavailable";
         refusal = new AccountResolutionError(current === undefined ? "unknown_account" : "account_disabled", `Account ${JSON.stringify(lane.account)} is unavailable for ${lane.provider}`, { provider: lane.provider, account: lane.account });
     }
     else {
@@ -244,7 +244,11 @@ function selectSpawnAccount(input) {
             account: lane.account,
         });
     }
-    if (reason === "recorded_account_logged_out" && lane.provider === "claude") {
+    const recoverRecordedClaudeModel = lane.provider === "claude" &&
+        reason !== undefined &&
+        (reason === "recorded_account_logged_out" ||
+            (reason === "account_unavailable" && repairRecordedAccount && recordedModel !== undefined));
+    if (recoverRecordedClaudeModel) {
         const lanes = listLaneIds(hqRoot)
             .map((laneId) => readLane(hqRoot, laneId))
             .filter((record) => record.host.kind === lane.host.kind && record.host.id === lane.host.id);
@@ -268,7 +272,8 @@ function selectSpawnAccount(input) {
         });
         return {
             account: resolveAccount(lane.provider, selection.account, config, context),
-            changeReason: "recorded_account_logged_out",
+            changeReason: reason,
+            ...(recordedModel !== undefined ? { preservedModel: recordedModel } : {}),
         };
     }
     const allowedAccounts = Object.entries(config.providers[lane.provider].accounts)
@@ -1726,7 +1731,7 @@ export function spawnLaneWorker(hqRoot, lane, deps = {}, launch = {}) {
         process.stderr.write(`hq lanes: account bind failed for ${lane.lane_id}: ${err instanceof Error ? err.message : String(err)}\n`);
         throw err;
     }
-    const preservedAccountModel = selection.changeReason === "recorded_account_logged_out" ? recordedModel : undefined;
+    const preservedAccountModel = selection.preservedModel;
     if (preservedAccountModel !== undefined)
         pinnedModel = preservedAccountModel;
     const resolved = selection.account;

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

@@ -523,7 +523,7 @@ export interface AccountHistoryEntry {
     from: string | null;
     to: string;
     at: string;
-    reason: "first_assignment" | "model_change" | "usage_limit" | "account_unavailable" | "recorded_account_logged_out" | "operator_move";
+    reason: "first_assignment" | "model_change" | "usage_limit" | "account_unavailable" | "recorded_account_logged_out" | "load_balance" | "operator_move";
 }
 export interface PendingResume {
     /** Fresh answered-question launches need no previous session id. */

package/package.json

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