elanous 0.2.0 → 0.2.4

package/src/nexus/onboarding/pwa-share-prompt.ts

@@ -18,6 +18,7 @@
 
 import type { TailscaleProbe } from './tailscale-probe.js';
 import type { WizardIO } from '../../onboarding.js';
+import { debug } from '../../debug/log.js';
 import {
   chooseFrom,
   showStepOr,
@@ -42,8 +43,8 @@ export interface PwaSharePromptDeps {
   io: WizardIO;
   /** Whether `apps/pwa/out` exists (skip build when true). */
   pwaBuilt: boolean;
-  /** HTTP port for the tailscale serve forward. Default 31415. */
-  port?: number;
+  /** Actual bound HTTP port for the tailscale serve forward. */
+  port: number;
   /** Force the prompt path even when stdin is non-TTY (tests). */
   forceTty?: boolean;
   /** Output sink (default = console). */
@@ -66,7 +67,7 @@ export async function runPwaSharePrompt(
   deps: PwaSharePromptDeps,
 ): Promise<PwaSharePromptResult> {
   const out = deps.out ?? console;
-  const port = deps.port ?? 31415;
+  const port = deps.port;
   const io = deps.io;
 
   const current = deps.readSwitch();
@@ -124,6 +125,7 @@ export async function runPwaSharePrompt(
   }
 
   out.log(`  → tailscale serve --bg --tls-terminated-tcp ${port} tcp://localhost:${port}`);
+  debug.log('nexus.pwa-share', 'port-resolved', { port, source: 'bound' });
   const serveResult = await deps.serveFn(probe.binary ?? 'tailscale', port);
   if (serveResult.exitCode !== 0) {
     out.error(`  ✗ tailscale serve failed (exit ${serveResult.exitCode}); switch left at 'ask'.`);
@@ -147,7 +149,7 @@ export async function runPwaSharePrompt(
  *  which strips WebSocket Upgrade — voice + Showroom multi-LLM WS
  *  bridge both 502 in production. Mode unification (single tls-tcp
  *  mode for both `pwa share enable` and `pwa test --https`) makes
- *  voice/WS work in daily-driver mode at the cost of `:31415` in the
+ *  voice/WS work in daily-driver mode at the cost of a port in the
  *  surfaced URL. The trade was decided 2026-05-10 (P1-P6 redesign).
  *
  *  `useSudo: true` because tls-tcp on macOS requires a privileged
@@ -156,17 +158,26 @@ export async function runPwaSharePrompt(
  *  responsible for prompting the user / running `sudo -v` ahead.
  *  The external signature is kept so existing callers in
  *  `pwa-start` / `pwa-share` and their tests do not move. */
-export async function defaultServe(binary: string, port: number): Promise<{ exitCode: number }> {
+export type ServeMountResult = { exitCode: number; ladderExhausted?: boolean };
+
+async function serveViaMount(
+  binary: string,
+  port: number,
+  useSudo: true | undefined,
+): Promise<ServeMountResult> {
   const { mountTailscaleServe } = await import('../../cli/tailscale-serve.js');
   // The unified helper expects to discover the binary via probe; we
   // already have the binary path from the caller (pwa-start /
   // pwa-share probe earlier). Inject the binary as a no-op probe so
   // the helper doesn't repeat the discovery — keeps the contract
   // exactly the same as the legacy execFile call.
+  // `useSudo` is omitted when undefined so mountTailscaleServe's own
+  // ladder runs: no sudo first, then `sudo -n` once on permission failure.
+  // `false` is never passed — that would drop the sudo retry.
   const res = await mountTailscaleServe({
     mode: { kind: 'tls-tcp', port },
     upstreamPort: port,
-    useSudo: true,
+    ...(useSudo === undefined ? {} : { useSudo }),
     probeFn: async () => ({
       installed: true,
       alive: true,
@@ -175,12 +186,24 @@ export async function defaultServe(binary: string, port: number): Promise<{ exit
       binary,
     }),
   });
-  if (res.ok) return { exitCode: 0 };
+  if (res.ok) return { exitCode: 0, ladderExhausted: false };
+  if (res.reason === 'sudo-required') return { exitCode: 1, ladderExhausted: true };
   if (res.reason === 'serve-cmd-failed') {
     // Best-effort exit-code recovery from `detail` (which carries
     // stderr in the legacy contract callers consume).
     const m = /exit (\d+)/.exec(res.detail ?? '');
-    return { exitCode: m ? Number.parseInt(m[1]!, 10) : 1 };
+    return { exitCode: m ? Number.parseInt(m[1]!, 10) : 1, ladderExhausted: false };
   }
   return { exitCode: 1 };
 }
+
+export async function defaultServe(binary: string, port: number): Promise<ServeMountResult> {
+  return serveViaMount(binary, port, true);
+}
+
+/** Daemon auto-mount. Leaves `useSudo` undefined so the existing
+ *  ladder tries without sudo first and `sudo -n` only once on a
+ *  permission failure. Manual paths stay on `defaultServe`. */
+export async function autoServe(binary: string, port: number): Promise<ServeMountResult> {
+  return serveViaMount(binary, port, undefined);
+}

package/src/nexus/onboarding/tailscale-probe.ts

@@ -51,10 +51,18 @@ const DEFAULT_CANDIDATES = [
   'tailscale',
 ];
 
+/** macOS 앱 번들의 `Tailscale` 바이너리는 환경이 비어 있으면(launchd 로 뜬 넥서스 — `TERM` 없음) CLI 가 아니라
+ *  GUI 로 뜨려다 «The Tailscale GUI failed to start» 를 rc 0 으로 낸다 ⇒ JSON 파싱 실패 ⇒ `alive:false` ⇒
+ *  공유 자동 마운트가 1분마다 «tailscale-down» 으로 건너뛰었다(📏 2026-09-27 운영 · 재시작 뒤 tailnet PWA 가 빠짐).
+ *  `TAILSCALE_BE_CLI=1` 이 CLI 로 고정한다(다른 플랫폼·래퍼에는 무해). tailscale 을 부르는 모든 자리가 이 환경을 쓴다. */
+export function tailscaleExecEnv(base: NodeJS.ProcessEnv = process.env): NodeJS.ProcessEnv {
+  return { ...base, TAILSCALE_BE_CLI: '1' };
+}
+
 function defaultExec(timeoutMs: number) {
   return (binary: string, args: string[]): Promise<{ stdout: string; code: number }> =>
     new Promise((resolve) => {
-      execFile(binary, args, { timeout: timeoutMs, encoding: 'utf-8' }, (err, stdout) => {
+      execFile(binary, args, { timeout: timeoutMs, encoding: 'utf-8', env: tailscaleExecEnv() }, (err, stdout) => {
         // An execFile error with code !== 0 still surfaces stdout; capture both.
         if (err && typeof err === 'object' && 'code' in err && typeof err.code === 'number') {
           resolve({ stdout: stdout ?? '', code: err.code });

package/src/nexus/setup-status.ts

@@ -1,5 +1,6 @@
 import { existsSync } from 'node:fs';
 
+import { debug } from '../debug/log.js';
 import { buildUserConfig, type UserConfig as MainUserConfig } from '../user-config.js';
 import { decideProviderForConfig } from '../llm.js';
 import { resolveGrokCredential } from '../grok/credential.js';
@@ -29,6 +30,63 @@ export interface SetupCheckResult {
   ok: boolean;
 }
 
+export type SetupBootMode = 'normal' | 'setup' | 'refuse';
+
+export interface SetupBootDecision {
+  mode: SetupBootMode;
+  missing: string[];
+}
+
+/** LLM 만 빠졌으면 PWA `/setup` 으로 채울 수 있다. PWA 빌드가 없으면 셋업 화면 자체가 없다. */
+export function setupBootMode(result: SetupCheckResult): SetupBootDecision {
+  const missing = result.required.filter((item) => !item.passed).map((item) => item.label);
+  const pwaMissing = result.required.some((item) => item.id === 'pwa-build' && !item.passed);
+  const onlyLlmMissing = missing.length > 0
+    && result.required.every((item) => item.passed || item.id === 'llm');
+  const mode: SetupBootMode = missing.length === 0
+    ? 'normal'
+    : (pwaMissing ? 'refuse' : (onlyLlmMissing ? 'setup' : 'refuse'));
+  debug.log('nexus.boot', 'setup-mode', { mode, missing });
+  return { mode, missing };
+}
+
+export interface SetupModeBootPlan {
+  skipTabKinds: string[];
+  skipCrons: string[];
+}
+
+/** 셋업 모드면 채널 봇·데몬 탭과 탐색·기기 크론을 띄우지 않는다. pwa-host 는 셋업 화면이라 남긴다. */
+export function setupModeBootPlan(setupMode: boolean): SetupModeBootPlan {
+  if (!setupMode) return { skipTabKinds: [], skipCrons: [] };
+  return {
+    skipTabKinds: ['daemon', 'channel-bot'],
+    skipCrons: ['discovery', 'devices'],
+  };
+}
+
+export interface NexusSetupModeRead {
+  setupMode: boolean;
+  setupMissing: string[];
+}
+
+/**
+ * 기동 때 한 번. `ELANOUS_NEXUS_SETUP_MODE === '1'` 이면
+ * `setupBootMode(checkSetupStatus()).missing` 을 읽는다.
+ * `check` 는 테스트가 LLM 만 빠진 설정을 주입할 때 쓴다. 기동 경로는 넘기지 않는다.
+ */
+export function readNexusSetupMode(
+  env: NodeJS.ProcessEnv,
+  check: () => SetupCheckResult = () => checkSetupStatus(),
+): NexusSetupModeRead {
+  if (env.ELANOUS_NEXUS_SETUP_MODE !== '1') {
+    return { setupMode: false, setupMissing: [] };
+  }
+  return {
+    setupMode: true,
+    setupMissing: setupBootMode(check()).missing,
+  };
+}
+
 export interface SetupCheckOpts {
   cfg?: MainUserConfig;
   nexusCfg?: NexusUserConfig;

package/src/nexus/supervisor/lock.ts

@@ -48,6 +48,14 @@ export function isAliveNexusLock(meta: NexusLockMeta): boolean {
   return isAliveLock(meta);
 }
 
+/** Read the live daemon lifecycle at an explicit nexus root (e.g. the production
+ *  universe's `~/.elanous/nexus`), independent of this process's own universe. */
+export function findNexusLifecycleStateAt(root: string): NexusLifecycleState | null {
+  const lock = safeReadLock(joinPath(root, '.lock'));
+  if (!lock || !isAliveNexusLock(lock)) return null;
+  return { root, lock, runtime: readNexusRuntimeAt(joinPath(root, 'runtime.json')) };
+}
+
 export interface NexusLifecycleState {
   root: string;
   lock: NexusLockMeta;

package/src/nexus/webterm/pty.ts

@@ -228,6 +228,21 @@ export function createRegistryBackend(
   };
 }
 
+/** 웹 터미널 셸이 열릴 작업 디렉토리를 정한다(실행 맥락 SSOT: 맥락은 «한 번» 정해지고 인자로 내려간다).
+ *  순서: 탭이 명시한 cwd → 데몬이 정한 tool cwd → (격리 우주면) 우주 뿌리 → 데몬 프로세스 cwd.
+ *  ⛔ 격리(test) 우주에서 `process.cwd()` 로 떨어지면 셸이 «사람 작업 트리»에서 열린다(🅕 실측 2026-09-26). */
+export function resolveWebtermCwd(input: {
+  tabCwd?: string;
+  toolCwd?: string;
+  instance: { kind: 'prod' | 'test'; root: string };
+  processCwd: string;
+}): { cwd: string; source: 'tab' | 'tool-cwd' | 'isolated-root' | 'process-cwd' } {
+  if (input.tabCwd) return { cwd: input.tabCwd, source: 'tab' };
+  if (input.toolCwd) return { cwd: input.toolCwd, source: 'tool-cwd' };
+  if (input.instance.kind === 'test') return { cwd: input.instance.root, source: 'isolated-root' };
+  return { cwd: input.processCwd, source: 'process-cwd' };
+}
+
 /** Build the per-tab spawn factory used by `runNexus({webtermSpawn})`.
  *  The runtime calls this once per webterm tab with `{id, cwd}` so the
  *  factory can apply per-tab overrides (e.g. tab-specific cwd). P0b:

package/src/oauth/codex-account-rotation.ts

@@ -13,6 +13,7 @@
 // ⭐ 이 파일의 판정은 «순수»다. 스토어·신호·설정을 «인자»로 받아서, 테스트가 실물 없이 전수로 문다.
 //   (전역을 읽는 순간 「무엇을 보고 정했나」가 안 보이게 된다 — 이 트랙이 오늘 네 번 밟은 형태다.)
 
+import { emitDecision } from '../live/detail-switch.js';
 import { debug } from '../debug/log.js';
 import type { CodexAccountResolution } from './codex-account.js';
 
@@ -25,6 +26,9 @@ export interface RotationCandidate {
   readonly reached: boolean | undefined;
   /** 브랜드 총량 사용률. 신호가 없거나 옛 형식이면 undefined다. */
   readonly usedPercent?: number;
+  /** 선불 크레딧 잔액·보유(모르면 없다). 크레딧 정책에서 «어느 계정 크레딧으로» 갈지 고른다. */
+  readonly creditBalance?: number;
+  readonly hasCredits?: boolean;
 }
 
 /** ⛔ 비공개 — 밖에서 이름으로 부를 소비처가 없다(리뷰 must-fix: dead export 금지). */
@@ -41,6 +45,8 @@ type RotationReason =
   | 'reset-credit-unknown'
   /** 찼는데 갈 곳이 없다 — 홈을 아는 다른 계정이 없거나 그들도 찼다. */
   | 'no-candidate'
+  /** 찼고 구독 잔량이 남은 계정도 없지만 대표 가 크레딧 사용을 허가했다 — 지금 계정에 머물러 선불 크레딧으로 계속(grok 폴백 안 함). */
+  | 'credits-allowed'
   /** 넘겼다. */
   | 'rotated';
 
@@ -51,6 +57,14 @@ interface RotationDecision {
   readonly disabledProvenance?: CodexAccountRotationConfigState;
   /** 판정 시점에 받은 원본 후보 수. 후보를 만들기 전 조기 관측이면 없다. */
   readonly candidateCount?: number;
+  /** 실제 판정에 적용한 계정별 임계와 그 출처. */
+  readonly accountThresholds?: readonly {
+    readonly name: string;
+    readonly thresholdPercent: number;
+    readonly source: 'account-override' | 'account-default' | 'global';
+    readonly status: 'reached' | 'threshold-reached' | 'below-threshold' | 'unknown';
+    readonly usedPercent: number | undefined;
+  }[];
   /** 넘겼을 때만 있다. */
   readonly to?: RotationCandidate;
 }
@@ -75,13 +89,18 @@ interface RotationInput {
   readonly resetCreditAvailability: ResetCreditAvailability;
   /** 회전을 시작·후보를 제외하는 전역 임계. 유효하지 않으면 기본 95를 쓴다. */
   readonly thresholdPercent?: unknown;
-  /** 계정별 임계 오버라이드. 유효하지 않은 값은 정규화된 전역 임계로 되돌린다. */
+  /** 계정별 임계 오버라이드. 유효하지 않은 값은 계정 기본값 또는 전역 임계로 되돌린다. */
   readonly thresholdPercentByAccount?: Readonly<Record<string, unknown>>;
   /** 지금 계정을 «뺀» 후보들. */
   readonly candidates: readonly RotationCandidate[];
   /** «먼저 쓸» 계정 순서(설정 `llm.codexAccountOrder`). 없으면 이름 코드포인트 순.
    *  ⛔ 여기 없는 계정은 버리지 않는다 — 뒤로 가서 이름순으로 붙는다. */
   readonly accountOrder?: readonly string[];
+  /** `llm.codexCreditsAllowed` — 참이면 갈 곳이 없을 때 «no-candidate» 대신 «credits-allowed» 로 머문다. */
+  readonly creditsAllowed?: boolean;
+  /** 지금 계정의 크레딧 잔액·보유(모르면 없다). */
+  readonly currentCreditBalance?: number;
+  readonly currentHasCredits?: boolean;
 }
 
 /**
@@ -92,6 +111,10 @@ interface RotationInput {
  */
 const DEFAULT_ROTATION_THRESHOLD_PERCENT = 95;
 
+// 대표 "첫 번째 계정의 경우 멀티 계정이 있을 때 50% 이상은 소모하지 않도록 해 주세요. 외부에서 코딩 용도가 아니라 다른 용도로도 많이 사용하고 있습니다."
+// 공유 default 계정에 여유를 남기기 위한 기본 임계 60%; 명시적 계정별 설정이 우선한다.
+export const DEFAULT_ROTATION_THRESHOLD_PERCENT_BY_ACCOUNT = { default: 60 } as const;
+
 /** ⛔⭐⭐ 표면이 «판정기가 실제로 쓴» 임계를 보여야 한다(리뷰 must-fix) — raw config 를 그대로
  *  찍으면 `0`·`101`·`NaN` 같은 값에서 ***판정은 95 를 쓰는데 화면은 다른 수를 말한다.***
  *  이 축이 고쳐 온 「판정층이 피판정층과 다른 자를 쓴다」의 또 한 판본이다. ⇒ 같은 함수를 쓴다. */
@@ -113,18 +136,59 @@ export function codexAccountRotationThresholdOverridePercent(value: unknown, fal
     : fallback;
 }
 
+/** 명시적 계정별 임계 → 계정 기본 임계 → 정규화된 전역 임계. 판정과 핀에서 같은 자를 쓴다. */
+export function codexAccountThresholdPercent(
+  accountName: string,
+  { thresholdPercent, thresholdPercentByAccount }: {
+    readonly thresholdPercent?: unknown;
+    readonly thresholdPercentByAccount?: Readonly<Record<string, unknown>>;
+  },
+): number {
+  const globalThreshold = normalizedRotationThresholdPercent(thresholdPercent);
+  // 대표 «default 는 60% 까지만» = 상한이다 — 전역을 더 엄하게(예 42) 주면 그것을 따른다(min). 계정별 명시가 이긴다.
+  const accountDefault = Object.prototype.hasOwnProperty.call(DEFAULT_ROTATION_THRESHOLD_PERCENT_BY_ACCOUNT, accountName)
+    ? Math.min(DEFAULT_ROTATION_THRESHOLD_PERCENT_BY_ACCOUNT[accountName as keyof typeof DEFAULT_ROTATION_THRESHOLD_PERCENT_BY_ACCOUNT], globalThreshold)
+    : globalThreshold;
+  return codexAccountRotationThresholdOverridePercent(thresholdPercentByAccount?.[accountName], accountDefault);
+}
+
+function accountThreshold(
+  name: string,
+  input: Pick<RotationInput, 'thresholdPercent' | 'thresholdPercentByAccount'>,
+): { thresholdPercent: number; source: 'account-override' | 'account-default' | 'global' } {
+  const thresholdPercent = codexAccountThresholdPercent(name, input);
+  const override = input.thresholdPercentByAccount?.[name];
+  const hasDefault = Object.prototype.hasOwnProperty.call(DEFAULT_ROTATION_THRESHOLD_PERCENT_BY_ACCOUNT, name);
+  return {
+    thresholdPercent,
+    source: thresholdPercent === override ? 'account-override' : hasDefault ? 'account-default' : 'global',
+  };
+}
+
 export function decideCodexRotation(input: RotationInput): RotationDecision {
   const candidateCount = input.candidates.length;
-  if (input.explicit) return { reason: 'explicit', candidateCount };
-  if (!input.enabled) return { reason: 'disabled', candidateCount, ...(input.disabledProvenance ? { disabledProvenance: input.disabledProvenance } : {}) };
-  const thresholdPercent = codexAccountRotationThresholdPercent(input.thresholdPercent);
-  const thresholdFor = (accountName: string): number =>
-    codexAccountRotationThresholdOverridePercent(input.thresholdPercentByAccount?.[accountName], thresholdPercent);
-  const reachedThreshold = (usedPercent: number | undefined, accountName: string): boolean =>
-    typeof usedPercent === 'number' && Number.isFinite(usedPercent) && usedPercent >= thresholdFor(accountName);
+  const otherCandidates = input.candidates.filter((candidate) => candidate.name !== input.current.name);
+  const accounts = [
+    { name: input.current.name, reached: input.currentReached, usedPercent: input.currentUsedPercent },
+    ...otherCandidates,
+  ];
+  const accountThresholds = accounts.map((account) => {
+    const threshold = accountThreshold(account.name, input);
+    const usedPercent = account.usedPercent;
+    const status = account.reached === true ? 'reached'
+      : typeof usedPercent !== 'number' || !Number.isFinite(usedPercent) ? 'unknown'
+      : usedPercent >= threshold.thresholdPercent ? 'threshold-reached' : 'below-threshold';
+    return { name: account.name, ...threshold, usedPercent, status } as const;
+  });
+  if (input.explicit) return { reason: 'explicit', candidateCount, accountThresholds };
+  if (!input.enabled) return { reason: 'disabled', candidateCount, accountThresholds, ...(input.disabledProvenance ? { disabledProvenance: input.disabledProvenance } : {}) };
   const currentUsageUnknown = input.currentReached === undefined && input.currentUsedPercent == null;
-  if (input.currentReached !== true && !currentUsageUnknown && !reachedThreshold(input.currentUsedPercent, input.current.name)) return { reason: 'not-reached', candidateCount };
+  if (input.currentReached !== true && !currentUsageUnknown && accountThresholds[0]?.status !== 'threshold-reached') {
+    return { reason: 'not-reached', candidateCount, accountThresholds };
+  }
   const resetCreditUnknown = input.resetCreditAvailability === 'unknown';
+  const candidateStatuses = otherCandidates
+    .map((candidate, index) => ({ candidate, status: accountThresholds[index + 1]?.status }));
 
     // ⛔⭐ 순서는 ***설정이 이기고, 없으면 이름 코드포인트***다.
     //   🩸 2026-09-24(대표 지시): 「third 부터 소진하고 그다음 team」 — 이름순(default<new<third)으로는
@@ -136,9 +200,10 @@ export function decideCodexRotation(input: RotationInput): RotationDecision {
       const i = order.indexOf(name);
       return i >= 0 ? i : order.length;
     };
-  const usable = input.candidates
-    .filter((c) => c.name !== input.current.name && c.home.length > 0 && c.reached !== true && !reachedThreshold(c.usedPercent, c.name))
-    .slice()
+  const usable = candidateStatuses
+    .filter(({ candidate, status }) => candidate.home.length > 0
+      && status !== 'reached' && status !== 'threshold-reached')
+    .map(({ candidate }) => candidate)
     .sort((a, b) => {
       const ra = rank(a.name); const rb = rank(b.name);
       if (ra !== rb) return ra - rb;
@@ -146,11 +211,30 @@ export function decideCodexRotation(input: RotationInput): RotationDecision {
     });
   const to = usable[0];
   if (!to) {
-    if (input.resetCreditAvailability === 'available') return { reason: 'reset-credit-available', candidateCount };
-    return { reason: 'no-candidate', candidateCount };
+    if (input.resetCreditAvailability === 'available') return { reason: 'reset-credit-available', candidateCount, accountThresholds };
+    // 대표 크레딧 허가: 구독 잔량이 남은 계정이 없으면 크레딧으로 계속 — 한도가 찬 요청은 서버가 선불 크레딧으로 넘긴다.
+    // 🩸 09-28 실측: default 크레딧만 시간당 ~5,200 씩 줄고 team·third(합 ~5.5만)는 0 — «지금 계정에 머문다»만으로는
+    //   한 계정 크레딧이 바닥나면 남은 크레딧을 두고 폴백(grok)으로 갔다. ⇒ 크레딧이 «더 많이» 남은 계정으로 옮긴다.
+    //   흔들림 방지: 지금 계정 크레딧이 없거나(보유 false · 잔액 ≤0) 다른 계정이 20% 넘게 많을 때만.
+    if (input.creditsAllowed === true) {
+      const richest = otherCandidates
+        .filter((c) => c.home.length > 0 && c.hasCredits !== false && typeof c.creditBalance === 'number' && c.creditBalance > 0)
+        .sort((a, b) => (b.creditBalance! - a.creditBalance!) || (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))[0];
+      // 지금 계정 신호를 귀속할 수 없을 때(기본 계정 `source=default`)는 후보 목록의 같은 이름 줄을 쓴다 —
+      //   후보는 같은 홈 해석으로 신호를 읽었다(09-28 운영: default 가 «사용=? · 찼나=모름»이라 잔액을 못 봐 머물렀다).
+      const self = input.candidates.find((c) => c.name === input.current.name);
+      const cur = input.currentCreditBalance ?? self?.creditBalance;
+      const curHas = input.currentHasCredits ?? self?.hasCredits;
+      const currentDry = curHas === false || (typeof cur === 'number' && cur <= 0);
+      if (richest && (currentDry || (typeof cur === 'number' && richest.creditBalance! > cur * 1.2))) {
+        return { reason: 'rotated', candidateCount, accountThresholds, to: richest };
+      }
+      return { reason: 'credits-allowed', candidateCount, accountThresholds };
+    }
+    return { reason: 'no-candidate', candidateCount, accountThresholds };
   }
-  if (resetCreditUnknown) return { reason: 'reset-credit-unknown', candidateCount, to };
-  return { reason: 'rotated', candidateCount, to };
+  if (resetCreditUnknown) return { reason: 'reset-credit-unknown', candidateCount, accountThresholds, to };
+  return { reason: 'rotated', candidateCount, accountThresholds, to };
 }
 
 /**
@@ -188,6 +272,28 @@ export function observeRotation(decision: RotationDecision, from: string): void
       ? { disabledProvenance: decision.disabledProvenance }
       : {}),
   }, { level: decision.reason === 'rotated' || decision.reason === 'reset-credit-unknown' ? 'warn' : 'debug' });
+  for (const account of decision.accountThresholds ?? []) {
+    debug.log('oauth.codex-account', 'rotation-account-threshold', account);
+  }
+  // Live 탭 MAX 모드에서만(부하 0 기본) — «무엇을 · 왜 · 목적 · 어디로».
+  if (decision.reason !== 'explicit' && decision.reason !== 'disabled') {
+    const fromRow = decision.accountThresholds?.find((a) => a.name === from);
+    const toCredit = decision.to?.creditBalance;
+    const why = typeof toCredit === 'number'
+      // 금액은 문장에 넣지 않는다 — 판단 사유는 Live·Trace 카드에 글자로 뜨고 공개 캡처가 문장 속 숫자를 못 가린다(09-28 🅣).
+      ? `구독 한도 전부 참 · ${decision.to!.name} 크레딧이 가장 많다`
+      : fromRow ? `${from} ${fromRow.usedPercent ?? '?'}% · 임계 ${fromRow.thresholdPercent}%` : `판정 ${decision.reason}`;
+    emitDecision({
+      kind: 'ROUTE',
+      what: decision.to ? `codex 계정 ${from} → ${decision.to.name}` : `codex 계정 ${from} 유지 (${decision.reason})`,
+      reason: why,
+      purpose: decision.reason === 'credits-allowed' ? '한도가 찼다 — 정책상 크레딧으로 계속'
+        : typeof toCredit === 'number' ? '크레딧을 세 계정에 고르게 · 한 계정이 먼저 마르지 않게' : '구독 한도 보존 · 끊김 없이 계속',
+      target: decision.to?.name ?? from,
+      refs: { account: decision.to?.name ?? from },
+      ...(decision.candidateCount !== undefined ? { paths: decision.candidateCount } : {}),
+    });
+  }
 }
 
 /** 회전 결과를 계정 해석으로 접는다. ⛔ 안 넘겼으면 «그대로» 돌려준다. */