@indigoai-us/hq-cli 5.345.17 → 5.345.18

package/CHANGELOG.md

@@ -2,8 +2,9 @@
 
 ## [Unreleased]
 
-## [5.345.17] — 2026-10-06
+## [5.345.18] — 2026-10-06
 - Git Bash forwarders now keep slash commands intact and convert file path arguments that hq needs on Windows.
+- Lane placement and Claude account-balance refusals now show the requested placement, actual host, balance host when different, and the model values and sources used for an unavailable-account decision.
 
 ## [5.345.16] — 2026-10-06
 - Claude account model settings are defaults, so explicit lane models remain eligible; explicit account selections on create, resume, and message are recorded as CLI choices.

package/dist/commands/lanes-accounts.js

@@ -197,6 +197,7 @@ export function createLaneAccountsHandlers(deps) {
                     target_host: host.capacity.host,
                     error: isLanesError(err) ? err.error : "claude_account_balance_selection_failed",
                     message: dispatchErrorMessage(err),
+                    ...(isLanesError(err) ? { details: err.details } : {}),
                 };
             }
         });

package/dist/commands/lanes.js

@@ -3472,14 +3472,20 @@ async function runCreate(ctx, opts) {
         const targetHost = placementBalanceHostOverride ?? placementHostOverride ?? (outpostId !== undefined
             ? { kind: "outpost", id: outpostId }
             : laneHostFromCtx(ctx));
+        const actualTargetHost = placementHostOverride ?? (outpostId !== undefined
+            ? { kind: "outpost", id: outpostId }
+            : { kind: "local", id: ctx.hostname() });
         balanceTargetHost = targetHost;
         balanceHostLoad = await loadClaudeBalanceHostSnapshots(ctx, hqRoot, config);
         const selected = selectClaudeAccount({
             hosts: balanceHostLoad.snapshots,
             targetHost,
+            actualTargetHost,
+            requestedPlacement: placementToApply ?? null,
             config,
             quotaState: loadQuotaState(hqRoot),
             ...(modelToValidate !== undefined ? { model: modelToValidate } : {}),
+            requestedModelSource: cliModel !== undefined ? "flag" : profileModel !== undefined ? "profile" : "default",
             recentUsageEnabled: await readClaudeAccountBalanceSignalsEnabled(ctx, company ?? undefined),
             now: ctx.now(),
             ...(allowedAccounts !== undefined ? { allowedAccounts } : {}),
@@ -3523,12 +3529,18 @@ async function runCreate(ctx, opts) {
                 const hosts = balanceHostLoad.snapshots.map((host) => host.capacity.host.kind === localHost.kind && host.capacity.host.id === localHost.id
                     ? refreshedLocal
                     : host);
+                const actualTargetHostForPersist = placementHostOverride ?? (outpostId !== undefined
+                    ? { kind: "outpost", id: outpostId }
+                    : { kind: "local", id: ctx.hostname() });
                 const selected = selectClaudeAccount({
                     hosts,
                     targetHost: balanceTargetHost,
+                    actualTargetHost: actualTargetHostForPersist,
+                    requestedPlacement: placementToApply ?? null,
                     config,
                     quotaState: loadQuotaState(hqRoot),
                     ...(modelToValidate !== undefined ? { model: modelToValidate } : {}),
+                    requestedModelSource: cliModel !== undefined ? "flag" : profileModel !== undefined ? "profile" : "default",
                     recentUsageEnabled: await readClaudeAccountBalanceSignalsEnabled(ctx, company ?? undefined),
                     now: ctx.now(),
                     ...(allowedAccounts !== undefined ? { allowedAccounts } : {}),
@@ -6802,6 +6814,11 @@ async function selectAutomaticClaudeResumeAccount(ctx, lane, workerProfile, opti
     // Repair keeps an account-derived model pinned through the move; plain
     // automatic rebalancing resolves each candidate's account default itself.
     const selectionModel = preservedModel ?? pinnedModel ?? profileModel;
+    const selectionModelSource = preservedModel !== undefined || pinnedModel !== undefined
+        ? "lane"
+        : profileModel !== undefined
+            ? "profile"
+            : "default";
     const model = resolveLaneModel({
         cliModel: pinnedModel,
         profileModel,
@@ -6829,11 +6846,14 @@ async function selectAutomaticClaudeResumeAccount(ctx, lane, workerProfile, opti
     const selectionInput = {
         hosts: balanceHosts.snapshots,
         targetHost: lane.host,
+        actualTargetHost: lane.host,
+        requestedPlacement: null,
         config,
         quotaState: loadQuotaState(hqRoot),
         recentUsageEnabled: await readClaudeAccountBalanceSignalsEnabled(ctx, lane.company ?? undefined),
         now: ctx.now(),
         ...(selectionModel !== undefined ? { model: selectionModel } : {}),
+        requestedModelSource: selectionModelSource,
         unavailableHosts: balanceHosts.unavailableHosts,
     };
     let selected;

package/dist/lib/lanes/claude-balance.d.ts

@@ -1,6 +1,6 @@
 import type { AuthState } from "./accounts.js";
 import type { HostCapacityAccount, HostCapacitySnapshot } from "./host-capacity.js";
-import type { LaneHost, LaneRecord, LanesConfig } from "./types.js";
+import type { LaneHost, LanePlacementPolicy, LaneRecord, LanesConfig } from "./types.js";
 import { type QuotaState } from "./quota.js";
 export declare const BALANCE_LIVE_STATES: readonly ["running", "queued", "awaiting_input"];
 export declare const BALANCE_MOVABLE_STATES: readonly ["interrupted", "done", "awaiting_input"];
@@ -81,6 +81,10 @@ export declare function selectClaudeAccount(input: {
     recentUsageEnabled?: boolean;
     now?: Date;
     explicitAccount?: string;
+    requestedModelSource?: "flag" | "profile" | "lane" | "default";
+    requestedPlacement?: LanePlacementPolicy | null;
+    /** Actual host where the lane would run; targetHost may be a distinct balance host. */
+    actualTargetHost?: LaneHost;
     unavailableHosts?: readonly BalanceHostGap[];
 }): ClaudeAccountSelection;
 export declare function accountLoadsForReport(input: {

package/dist/lib/lanes/claude-balance.js

@@ -119,6 +119,9 @@ function targetIneligibilityReason(accountId, globalEnabled, allowedAccounts, ta
         return "login_status_unknown";
     return undefined;
 }
+function configModelForAccount(config, accountId) {
+    return config.providers.claude.accounts[accountId]?.model;
+}
 function buildLoads(input) {
     const configAccounts = input.config.providers.claude.accounts;
     const targetHost = input.target.capacity.host;
@@ -156,10 +159,16 @@ function buildLoads(input) {
     return { loads, skipped };
 }
 export function selectClaudeAccount(input) {
+    const actualTargetHost = input.actualTargetHost ?? input.targetHost;
+    const placementDetails = {
+        requested_placement: input.requestedPlacement ?? null,
+        target_host: actualTargetHost,
+        ...(sameHost(actualTargetHost, input.targetHost) ? {} : { balance_host: input.targetHost }),
+    };
     const target = input.hosts.find((host) => sameHost(host.capacity.host, input.targetHost));
     if (!target) {
         throw new LanesError("claude_account_balance_target_host_unavailable", `Cannot verify Claude accounts on target host ${input.targetHost.kind}:${input.targetHost.id}`, {
-            target_host: input.targetHost,
+            ...placementDetails,
             unavailable_hosts: input.unavailableHosts ?? [],
         });
     }
@@ -170,8 +179,16 @@ export function selectClaudeAccount(input) {
         if (!selected || !selected.eligible) {
             throw new LanesError("claude_account_balance_account_unavailable", `Explicit Claude account ${JSON.stringify(input.explicitAccount)} is unavailable on ${input.targetHost.kind}:${input.targetHost.id}`, {
                 account: input.explicitAccount,
-                target_host: input.targetHost,
                 reason: selected?.ineligible_reason ?? "unknown_account",
+                ...placementDetails,
+                compared: {
+                    requested_model: input.model ?? configModelForAccount(input.config, input.explicitAccount) ?? input.config.providers.claude.model ?? null,
+                    requested_model_source: input.requestedModelSource ?? "default",
+                    account_model: configModelForAccount(input.config, input.explicitAccount) ?? null,
+                    account_model_source: `personal/lanes/config.json#providers.claude.accounts.${input.explicitAccount}.model`,
+                    host: input.targetHost,
+                    reason: selected?.ineligible_reason ?? "unknown_account",
+                },
                 account_reasons: skipped,
                 unavailable_hosts: input.unavailableHosts ?? [],
             });
@@ -196,7 +213,7 @@ export function selectClaudeAccount(input) {
             : "";
         throw new LanesError("claude_account_balance_no_eligible_account", `No enabled, logged-in Claude account is available on ${input.targetHost.kind}:${input.targetHost.id}${unknownLoginDetail}`, {
             provider: "claude",
-            target_host: input.targetHost,
+            ...placementDetails,
             account_reasons: loads.map((load) => ({
                 account: load.account,
                 reason: load.ineligible_reason ?? "unavailable",

package/dist/lib/lanes/spawn.js

@@ -334,11 +334,18 @@ function selectSpawnAccount(input) {
         const selection = selectClaudeAccount({
             hosts: [{ capacity, lanes, laneListAvailable: true }],
             targetHost: lane.host,
+            actualTargetHost: lane.host,
+            requestedPlacement: null,
             config,
             quotaState: loadQuotaState(hqRoot),
             ...((recordedModel ?? pinnedModel ?? profileModel) !== undefined
                 ? { model: recordedModel ?? pinnedModel ?? profileModel }
                 : {}),
+            requestedModelSource: recordedModel !== undefined || pinnedModel !== undefined
+                ? "lane"
+                : profileModel !== undefined
+                    ? "profile"
+                    : "default",
         });
         return {
             account: resolveAccount(lane.provider, selection.account, config, context),

package/package.json

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