feat: expose account selection reasons

Author: ndycode

lib/codex-manager/commands/report.ts

@@ -481,7 +481,13 @@ export async function runReportCommand(
 		activeIndex: accountCount > 0 ? activeIndex + 1 : null,
 		forecast: {
 			summary: forecastSummary,
-			recommendation,
+			recommendation: {
+				...recommendation,
+				selectedReason:
+					recommendation.recommendedIndex !== null
+						? forecastResults[recommendation.recommendedIndex]?.reasons[0] ?? recommendation.reason
+						: recommendation.reason,
+			},
 			probeErrors,
 			accounts: serializeForecastResults(
 				forecastResults,
@@ -491,6 +497,13 @@ export async function runReportCommand(
 			),
 		},
 	};
+	if (report.forecast.recommendation.recommendedIndex !== null) {
+		const selectedIndex = report.forecast.recommendation.recommendedIndex;
+		const selected = report.forecast.accounts[selectedIndex];
+		if (selected) {
+			selected.selected = true;
+		}
+	}
 
 	const cwd = deps.getCwd?.() ?? process.cwd();
 	if (options.outPath) {

lib/codex-manager/commands/status.ts

@@ -3,6 +3,10 @@ import {
 	formatCooldown,
 	formatWaitTime,
 } from "../../accounts.js";
+import {
+	evaluateForecastAccounts,
+	recommendForecastAccount,
+} from "../../forecast.js";
 import type { ModelFamily } from "../../prompts/codex.js";
 import type { AccountStorageV3 } from "../../storage.js";
 
@@ -40,8 +44,22 @@ export async function runStatusCommand(
 
 	const now = deps.getNow?.() ?? Date.now();
 	const activeIndex = deps.resolveActiveIndex(storage, "codex");
+	const forecastResults = evaluateForecastAccounts(
+		storage.accounts.map((account, index) => ({
+			index,
+			account,
+			isCurrent: index === activeIndex,
+			now,
+		})),
+	);
+	const recommendation = recommendForecastAccount(forecastResults);
 	logInfo(`Accounts (${storage.accounts.length})`);
 	logInfo(`Storage: ${path}`);
+	if (recommendation.recommendedIndex !== null) {
+		logInfo(
+			`Selection reason: account ${recommendation.recommendedIndex + 1} (${recommendation.reason})`,
+		);
+	}
 	logInfo("");
 
 	for (let i = 0; i < storage.accounts.length; i += 1) {
@@ -61,6 +79,10 @@ export async function runStatusCommand(
 				? `used ${formatWaitTime(now - account.lastUsed)} ago`
 				: "never used";
 		logInfo(`${i + 1}. ${label}${markerLabel} ${lastUsed}`);
+		const primaryReason = forecastResults[i]?.reasons[0];
+		if (primaryReason) {
+			logInfo(`   reason: ${primaryReason}`);
+		}
 	}
 
 	return 0;

test/codex-manager-report-command.test.ts

@@ -257,6 +257,9 @@ describe("runReportCommand", () => {
 			"token expired",
 		);
 		expect(jsonOutput.forecast.accounts[3]?.liveQuota?.planType).toBe("pro");
+		expect(jsonOutput.forecast.recommendation.selectedReason).toEqual(
+		expect.any(String),
+		);
 	});
 
 	it("reuses usable access tokens for live probes without forcing refresh", async () => {

test/codex-manager-status-command.test.ts

@@ -68,11 +68,17 @@ describe("runStatusCommand", () => {
 		expect(deps.getStoragePath).toHaveBeenCalledTimes(1);
 		expect(deps.logInfo).toHaveBeenCalledWith("Accounts (2)");
 		expect(deps.logInfo).toHaveBeenCalledWith("Storage: /tmp/codex.json");
+		expect(deps.logInfo).toHaveBeenCalledWith(
+			expect.stringContaining("Selection reason: account 1"),
+		);
 		expect(deps.logInfo).toHaveBeenCalledWith(
 			expect.stringContaining(
 				"1. Account 1 (one@example.com) [current, rate-limited]",
 			),
 		);
+		expect(deps.logInfo).toHaveBeenCalledWith(
+			expect.stringContaining("reason:"),
+		);
 		expect(deps.logInfo).toHaveBeenCalledWith(
 			expect.stringContaining(
 				"2. Account 2 (two@example.com) [disabled, rate-limited]",