elanous 0.2.35 → 0.2.37

package/src/onboarding/first-run.ts

@@ -1,6 +1,7 @@
 import * as readline from 'node:readline/promises';
 import { detectProviders, type DetectedProvider } from '../llm/provider-detect.js';
 import { debug } from '../debug/log.js';
+import { detectLocale, type Locale } from '../expression/locale.js';
 import { unattendedNextStepLine } from './entry-hints.js';
 import { resolveProviderCredential } from '../llm/provider-credentials.js';
 import {
@@ -13,6 +14,8 @@ export interface FirstRunDeps {
   path?: string;
   detectProviders?: () => Promise<DetectedProvider[]>;
   isTTY?: boolean;
+  /** Locale for user-facing wording; defaults to the shared ambient decision (detectLocale). */
+  locale?: Locale;
   chooseProvider?: (detected: readonly LLMProviderName[]) => Promise<LLMProviderName | null>;
   print?: (message: string) => void;
   saveConfig?: (config: UserConfig, path: string) => void;
@@ -44,12 +47,21 @@ export function parseMenuAnswer(answer: string, choices: readonly LLMProviderNam
   return provider !== undefined ? { kind: 'chosen', provider } : { kind: 'miss' };
 }
 
+/**
+ * The fixed choice line of the first-run menu (`1 Codex, 2 Grok, 3 Claude`).
+ * Single source of the wording: the prompt below renders it, and the ux-sim
+ * first-run device asserts against it, so a wording change cannot drift apart.
+ */
+export function formatProviderMenu(choices: readonly LLMProviderName[]): string {
+  return choices.map((name, i) => `${i + 1} ${CHOICE_LABEL[name] ?? name}`).join(', ');
+}
+
 export async function promptProviderMenu(
   ask: (prompt: string) => Promise<string>,
   detected: readonly LLMProviderName[] = [],
 ): Promise<LLMProviderName | null> {
   const choices = orderProviderChoices(detected);
-  const menu = choices.map((name, i) => `${i + 1} ${CHOICE_LABEL[name] ?? name}`).join(', ');
+  const menu = formatProviderMenu(choices);
   for (;;) {
     const parsed = parseMenuAnswer(await ask(`Choose LLM (${menu}; Enter to cancel): `), choices);
     if (parsed.kind === 'chosen') return parsed.provider;
@@ -66,7 +78,23 @@ async function chooseProvider(detected: readonly LLMProviderName[] = []): Promis
   }
 }
 
-const detectionLabel = (provider: string) => `${provider === 'openai-codex' ? 'codex' : provider} 구독`;
+/** User-facing first-run fallback wording, routed by the shared locale decision (detectLocale). */
+const FIRST_RUN_TEXT = {
+  ko: {
+    detectedPrefix: '감지: ',
+    subscription: ' 구독',
+    needsLlm: 'eln setup llm 으로 고르세요',
+    claudeNoPath: 'claude-code 구독은 구독으로 쓸 수 있는 경로가 없어 자동 선택하지 않음',
+    multipleDetected: '둘 이상 감지되어 고르세요',
+  },
+  en: {
+    detectedPrefix: 'detected: ',
+    subscription: ' subscription',
+    needsLlm: 'pick a provider via eln setup llm',
+    claudeNoPath: 'claude-code subscription has no usable path in elanous; not auto-selecting',
+    multipleDetected: 'more than one detected; pick one',
+  },
+} as const;
 
 export async function runFirstRun(deps: FirstRunDeps = {}): Promise<{
   outcome: 'ready' | 'needs-llm' | 'cancelled'; provider?: string; inputs: number;
@@ -74,6 +102,9 @@ export async function runFirstRun(deps: FirstRunDeps = {}): Promise<{
   const path = deps.path ?? userConfigPath();
   const cfg = deps.config ?? getUserConfig(path);
   const print = deps.print ?? console.log;
+  const text = FIRST_RUN_TEXT[(deps.locale ?? detectLocale()) === 'en' ? 'en' : 'ko'];
+  const detectionLabel = (provider: string) =>
+    `${provider === 'openai-codex' ? 'codex' : provider}${text.subscription}`;
   let detected: DetectedProvider[] = [];
   try { detected = await (deps.detectProviders ?? detectProviders)(); }
   catch { /* Detection is advisory; a TTY can still choose. */ }
@@ -93,9 +124,9 @@ export async function runFirstRun(deps: FirstRunDeps = {}): Promise<{
   // claude-code is detected but has no subscription path in elanous: mapping it to the 'anthropic'
   // API-key provider would save a provider whose first call fails for a subscription-only user.
   const usable = SUBSCRIPTION_PRIORITY.filter((name) => providers.includes(name));
-  const detectionLine = (outcome: string) => `감지: ${providers.map(detectionLabel).join(' · ')} → ${outcome}`;
+  const detectionLine = (outcome: string) => `${text.detectedPrefix}${providers.map(detectionLabel).join(' · ')} → ${outcome}`;
   const needsLlm = (inputs: number, extra: string[] = []) => {
-    print('eln setup llm 으로 고르세요');
+    print(text.needsLlm);
     for (const line of extra) print(line);
     observe('needs-llm', inputs);
     return { outcome: 'needs-llm' as const, inputs };
@@ -106,8 +137,8 @@ export async function runFirstRun(deps: FirstRunDeps = {}): Promise<{
   if (!provider) {
     if (providers.length > 0) {
       print(detectionLine(usable.length === 0
-        ? 'claude-code 구독은 구독으로 쓸 수 있는 경로가 없어 자동 선택하지 않음'
-        : '둘 이상 감지되어 고르세요'));
+        ? text.claudeNoPath
+        : text.multipleDetected));
     }
     if ((deps.isTTY ?? process.stdin.isTTY) !== true) {
       // FIRST-CHAT-NONTTY — bare `elanous` with no TTY gets the same one-line next step as the other entrances.

package/src/onboarding/web-first.ts

@@ -7,6 +7,7 @@ import { runBgLaunch, type BgLaunchResult } from '../cli/bg-launch.js';
 import { joinRestHealthUrl, runNexusShow, type NexusShowResult } from '../cli/nexus-show.js';
 import { issueSetupLinkToken } from '../auth/setup-link-tokens.js';
 import { debug } from '../debug/log.js';
+import { detectLocale, type Locale } from '../expression/locale.js';
 import { browserUnavailableReason } from '../oauth/browser-availability.js';
 import type { UserConfig } from '../user-config.js';
 
@@ -18,6 +19,8 @@ export interface WebFirstSetupDeps {
   /** Bare first run never starts or waits for a missing daemon; explicit setup retains web launch. */
   startIfMissing?: boolean;
   startedAt?: number;
+  /** Locale for user-facing wording; defaults to the shared ambient decision (detectLocale). */
+  locale?: Locale;
   showNexus?: () => Promise<NexusShowResult>;
   startDaemon?: () => Promise<BgLaunchResult>;
   probeHealth?: (url: string, timeoutMs: number) => Promise<boolean>;
@@ -37,6 +40,34 @@ export interface WebFirstSetupDeps {
 
 const STARTUP_TIMEOUT_MS = 12_000;
 
+/** User-facing web-first fallback wording, routed by the shared locale decision (detectLocale). */
+const WEB_FIRST_TEXT = {
+  ko: {
+    unavailable: (reason: string) => `웹 셋업을 사용할 수 없습니다 (${reason}). 터미널 설정으로 전환합니다.`,
+    offline: '오프라인 모드',
+    startingDaemon: '웹 셋업을 위해 데몬을 시작합니다.',
+    continueInBrowser: '브라우저에서 셋업을 이어가세요',
+    phoneOnSameWifi: (link: string) => `같은 와이파이의 폰이면: ${link}`,
+    linkSingleUse: '이 링크는 10분 안에 한 번만 열 수 있습니다',
+    sameWifiRestart: '같은 와이파이에서 열려면 `elanous nexus run` 을 루프백 없이 다시 띄우세요',
+    scanTailnet: '같은 와이파이·tailnet 의 폰 카메라로 스캔하세요',
+    scanSameWifi: '같은 와이파이의 폰 카메라로 스캔하세요',
+    terminalInstead: '터미널에서 하려면: `elanous setup --terminal`',
+  },
+  en: {
+    unavailable: (reason: string) => `web setup is unavailable (${reason}); switching to terminal setup.`,
+    offline: 'offline mode',
+    startingDaemon: 'starting the daemon for web setup.',
+    continueInBrowser: 'continue setup in your browser',
+    phoneOnSameWifi: (link: string) => `on a phone on the same wifi: ${link}`,
+    linkSingleUse: 'this link can be opened only once within 10 minutes',
+    sameWifiRestart: 'to open it from the same wifi, restart `elanous nexus run` without a loopback-only bind',
+    scanTailnet: 'scan with a phone camera on the same wifi/tailnet',
+    scanSameWifi: 'scan with a phone camera on the same wifi',
+    terminalInstead: 'to use the terminal instead: `elanous setup --terminal`',
+  },
+} as const;
+
 async function probeHealth(url: string, timeoutMs: number): Promise<boolean> {
   try {
     const response = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
@@ -53,12 +84,13 @@ function setupUrl(pwa: string, token: string): string {
 export async function runWebFirstSetup(deps: WebFirstSetupDeps): Promise<'link-shown' | 'fallback'> {
   const startedAt = deps.startedAt ?? Date.now();
   const print = deps.print ?? console.log;
+  const text = WEB_FIRST_TEXT[(deps.locale ?? detectLocale()) === 'en' ? 'en' : 'ko'];
   const observe = (event: 'link-shown' | 'fallback', reason?: string, qr = false, browserOpened = false, remote: 'loopback' | 'tailnet' = 'loopback', ms?: number, lan?: 'shown' | 'loopback-bind' | 'no-address', ssh?: boolean) => {
     try { debug.log('onboarding.web-first', event, { ...(reason ? { reason } : {}), qr, browserOpened, remote, ...(ms !== undefined ? { ms } : {}), ...(lan ? { lan, ssh } : {}) }); }
     catch { /* Observability must not block onboarding. */ }
   };
   const fallback = (reason: string): 'fallback' => {
-    print(`웹 셋업을 사용할 수 없습니다 (${reason}). 터미널 설정으로 전환합니다.`);
+    print(text.unavailable(reason));
     observe('fallback', reason);
     return 'fallback';
   };
@@ -70,7 +102,7 @@ export async function runWebFirstSetup(deps: WebFirstSetupDeps): Promise<'link-s
   try { shown = await show(); } catch { /* A missing daemon may make inspection fail. */ }
   const running = shown?.status === 'unregistered' || (shown?.status === 'registered' && shown.instance?.alive === true);
   if (deps.startIfMissing === false && !running) {
-    print('오프라인 모드');
+    print(text.offline);
     observe('fallback', 'offline');
     return 'fallback';
   }
@@ -85,11 +117,11 @@ export async function runWebFirstSetup(deps: WebFirstSetupDeps): Promise<'link-s
   const deadline = Date.now() + STARTUP_TIMEOUT_MS;
   if (!running || !shown?.urls?.pwa.loopback) {
     if (deps.startIfMissing === false) {
-      print('오프라인 모드');
+      print(text.offline);
       observe('fallback', 'offline');
       return 'fallback';
     }
-    print('웹 셋업을 위해 데몬을 시작합니다.');
+    print(text.startingDaemon);
     let launch: BgLaunchResult;
     try {
       launch = await (deps.startDaemon ?? (() => runBgLaunch({ out: { log: () => {}, error: () => {} } })))();
@@ -115,7 +147,7 @@ export async function runWebFirstSetup(deps: WebFirstSetupDeps): Promise<'link-s
     if (remaining > 0) await Bun.sleep(Math.min(200, remaining));
   }
   if (!healthy && deps.startIfMissing === false) {
-    print('오프라인 모드');
+    print(text.offline);
     observe('fallback', 'offline');
     return 'fallback';
   }
@@ -154,13 +186,13 @@ export async function runWebFirstSetup(deps: WebFirstSetupDeps): Promise<'link-s
   const lan: 'shown' | 'loopback-bind' | 'no-address' = !confirmedBind ? 'no-address' : !reachable ? 'loopback-bind' : lanAddress ? 'shown' : 'no-address';
   const lanLink = lanAddress ? setupUrl(`http://${lanAddress}:${port}/app/`, token) : undefined;
   const phoneLink = shown.urls.pwa.tailnet ? setupUrl(shown.urls.pwa.tailnet, token) : lanLink;
-  print('브라우저에서 셋업을 이어가세요');
+  print(text.continueInBrowser);
   print(link);
   if (lanLink) {
-    print(`같은 와이파이의 폰이면: ${lanLink}`);
-    print('이 링크는 10분 안에 한 번만 열 수 있습니다');
+    print(text.phoneOnSameWifi(lanLink));
+    print(text.linkSingleUse);
   } else if (lan === 'loopback-bind') {
-    print('같은 와이파이에서 열려면 `elanous nexus run` 을 루프백 없이 다시 띄우세요');
+    print(text.sameWifiRestart);
   }
   const linkShownMs = Date.now() - startedAt;
   let qr = false;
@@ -172,12 +204,12 @@ export async function runWebFirstSetup(deps: WebFirstSetupDeps): Promise<'link-s
       }))(phoneLink);
       if (rendered) {
         print(rendered);
-        print(shown.urls.pwa.tailnet ? '같은 와이파이·tailnet 의 폰 카메라로 스캔하세요' : '같은 와이파이의 폰 카메라로 스캔하세요');
+        print(shown.urls.pwa.tailnet ? text.scanTailnet : text.scanSameWifi);
         qr = true;
       }
     } catch { /* QR is optional. */ }
   }
-  print('터미널에서 하려면: `elanous setup --terminal`');
+  print(text.terminalInstead);
   let browserOpened = false;
   const env = deps.browserEnv ?? process.env;
   const ssh = !!(env.SSH_CONNECTION || env.SSH_CLIENT || env.SSH_TTY);

package/src/ops/loops-map.ts

@@ -0,0 +1,46 @@
+import type { LoopRow, OverviewSnapshot } from './overview.js';
+
+/** 루프 지도의 한 칸 — 캐시 스냅숏의 루프 행을 그대로 옮긴다(합성 없음). */
+export interface LoopsMapRow {
+  name: string;
+  era: LoopRow['era'];
+  /** 이 주기 이상 박동이 없으면 정지로 본다. null = 주기 미상(판정에서 뺀다) — 캐시 값 그대로. */
+  staleAfterSeconds: number | null;
+  /** 박동 칸: 못 잼이면 value·observedAt 이 null 이고 reason 이 남는다(캐시 그대로). */
+  beat: LoopRow['beat'];
+}
+
+/**
+ * LOOP-MAP-API 응답 — overviewCache 의 loops 스냅숏만 투영한 것.
+ * edges(loop-edges 결합)는 후속 조각이라 여기에 넣지 않는다.
+ */
+export interface LoopsMap {
+  /** 캐시 스냅숏이 만든 시각. 캐시가 비면 null. */
+  generatedAt: string | null;
+  /** 요청 시각(캐시 시계)과 generatedAt 의 차이. 캐시가 비면 null. */
+  cacheAgeMs: number | null;
+  loops: LoopsMapRow[];
+}
+
+/** 캐시 미스 응답 — 원격 조회를 유발하지 않고 «아직 캐시 없음»을 그대로 말한다. */
+const EMPTY_LOOPS_MAP: LoopsMap = { generatedAt: null, cacheAgeMs: null, loops: [] };
+
+/**
+ * overviewCache.peek() 결과 하나를 루프 지도 응답으로 투영한다.
+ * `at` 은 캐시의 시계로 잰 «읽은 시각»이라 가짜 시계를 주입하면 cacheAgeMs 가 결정적이다.
+ * 여기서 원천을 더 읽지 않는다 — 순수 투영이다.
+ */
+export function loopsMapFromCache(peeked: { snapshot: OverviewSnapshot; at: number } | null): LoopsMap {
+  if (!peeked) return EMPTY_LOOPS_MAP;
+  const generatedAtMs = Date.parse(peeked.snapshot.generatedAt);
+  return {
+    generatedAt: peeked.snapshot.generatedAt,
+    cacheAgeMs: Number.isFinite(generatedAtMs) ? Math.max(0, peeked.at - generatedAtMs) : null,
+    loops: peeked.snapshot.loops.map((loop) => ({
+      name: loop.name,
+      era: loop.era,
+      staleAfterSeconds: loop.staleAfterSeconds,
+      beat: loop.beat,
+    })),
+  };
+}

package/src/ops/overview-cache.ts

@@ -1,7 +1,7 @@
 import { debug } from '../debug/log.js';
 import { parentPort, Worker } from 'node:worker_threads';
 import { collectOverview, type CollectOptions } from './overview-collect.js';
-import { computeVerdict, unmeasured, okCell, type OverviewSnapshot, type PodMemberRow } from './overview.js';
+import { computeVerdict, unmeasured, okCell, type Cell, type GateReservation, type OverviewSnapshot, type PodMemberRow } from './overview.js';
 import { effectiveInstanceRoot } from '../instance/resolve.js';
 import { getElanousConfigDirOverride, setElanousConfigDir } from '../elanous-config-dir.js';
 
@@ -12,7 +12,7 @@ const POD_STALE_MS = 2 * POD_MS;
 const MAX_MEMO = 32;
 const MAX_PENDING = 2;
 
-type PodReading = { context: string; occupied: number | null; reason: string | null; observedAt: number };
+type PodReading = { context: string; occupied: number | null; reason: string | null; observedAt: number; gate?: GateReservation };
 type OverviewData = OverviewSnapshot & ReturnType<typeof computeVerdict> & { cacheAgeMs: number; durationMs: number; sources: string[]; refreshFailed: string | null };
 type WorkerMessage = ({ kind: 'pods' } | { kind: 'snapshot'; options: CollectOptions }) & { configDir?: string };
 
@@ -25,7 +25,7 @@ if (port) {
       if (message.configDir) setElanousConfigDir(message.configDir);
       if (message.kind === 'pods') {
         const { buildGridData } = await import('../nexus/api/grid.js');
-        const rows = buildGridData().members.map((m) => ({ context: m.context, occupied: m.occupied, reason: m.reason, observedAt: Date.now() }));
+        const rows = buildGridData().members.map((m) => ({ context: m.context, occupied: m.occupied, reason: m.reason, observedAt: Date.now(), ...(m.gate ? { gate: m.gate } : {}) }));
         port.postMessage({ rows });
       } else port.postMessage({ snapshot: await collectOverview(message.options) });
     } catch (error) {
@@ -106,6 +106,24 @@ export function createOverviewCache(deps: {
     podTimer = schedule(() => { void refreshPods(); }, POD_MS);
     podTimer.unref();
   };
+  /**
+   * 게이트 예약 축(RES-FLOOR-BINDING 다섯째 축) — 「게이트 안 돎」은 측정된 값('none'), 못 잼은 사유를 남긴다.
+   * 둘 다 구속 조건 후보에서 빠지지만 뜻은 다르다: 하나는 «게이트가 안 돈다», 다른 하나는 «모른다».
+   */
+  const overlayGate = (row: PodReading | undefined, at: number): Cell<GateReservation | 'none'> => {
+    const observedAt = row ? new Date(row.observedAt).toISOString() : null;
+    const stale = row !== undefined && at - row.observedAt >= POD_STALE_MS;
+    if (podFailure || !row || stale) {
+      return unmeasured('pod pool background measure', podFailure ?? (stale ? '낡음(120초)' : '측정 대기'), observedAt);
+    }
+    if (!row.gate) return unmeasured('pod pool background measure', row.reason ?? '게이트 예약 못 잼', observedAt);
+    if (row.gate.jobs === 0) return okCell<GateReservation | 'none'>('none', 'pod pool background measure', observedAt);
+    const gate = row.gate;
+    if (!Number.isFinite(gate.unbound) || !Number.isFinite(gate.reservedMillicores) || !Number.isFinite(gate.schedulableMillicores)) {
+      return unmeasured('pod pool background measure', '게이트 CPU 못 잼', observedAt);
+    }
+    return okCell<GateReservation | 'none'>(gate, 'pod pool background measure', observedAt);
+  };
   /** Response-time Pod occupancy overlay — shared by /v1/ops/overview and /v1/ops/resources. */
   const overlayPods = (snapshot: OverviewSnapshot, at: number): PodMemberRow[] => {
     const byContext = new Map(podRows.map((row) => [row.context, row]));
@@ -115,7 +133,7 @@ export function createOverviewCache(deps: {
       const occupied = !podFailure && row && !stale && row.occupied !== null
         ? okCell(row.occupied, 'pod pool background measure', new Date(row.observedAt).toISOString())
         : unmeasured<number>('pod pool background measure', podFailure ?? (stale ? '낡음(120초)' : row?.reason ?? '측정 대기'), row ? new Date(row.observedAt).toISOString() : null);
-      return { ...pod, occupied };
+      return { ...pod, occupied, gate: overlayGate(row, at) };
     });
   };
   const present = (entry: Entry): OverviewData => {

package/src/ops/overview-collect.ts

@@ -234,6 +234,16 @@ export interface CollectDeps {
   gitLog?: (sinceIso: string) => { lines: string[]; observedAt: string } ;
 }
 
+/** Production schedule.run ledger reader; dbPath is explicit so replays never open the operating ledger. */
+export async function readSchedulerExecutionRows(dbPath: string, sinceMs: number, untilMs: number): Promise<SchedulerExecutionObservation[]> {
+  const { LogStore } = await import('../mss/logging/log-store.js');
+  const store = LogStore.openReadOnly(dbPath);
+  try {
+    return store.queryAll({ exactCategories: ['schedule.run'], sinceMs, untilMs })
+      .map(({ ts_ms, data }) => ({ ts_ms, data }));
+  } finally { store.close(); }
+}
+
 async function defaultDeps(root: string): Promise<Required<CollectDeps>> {
   const [{ listSchedules }, { listChecklist }, { readReleaseRuns }, { readTaskAgentState, taskAgentStatePath }, { ResourceLedger }, { getUserConfig }] = await Promise.all([
     import('../release-loop/release-schedule.js'), import('../release-loop/checklist.js'), import('../nexus/api/ops-api.js'),
@@ -242,12 +252,8 @@ async function defaultDeps(root: string): Promise<Required<CollectDeps>> {
   return {
     listSchedules: () => listSchedules(),
     readSchedulerRuns: async (sinceMs, untilMs) => {
-      const { LogStore, logsDbPath } = await import('../mss/logging/log-store.js');
-      const store = LogStore.openReadOnly(logsDbPath());
-      try {
-        return store.queryAll({ exactCategories: ['schedule.run'], sinceMs, untilMs })
-          .map(({ ts_ms, data }) => ({ ts_ms, data }));
-      } finally { store.close(); }
+      const { logsDbPath } = await import('../mss/logging/log-store.js');
+      return readSchedulerExecutionRows(logsDbPath(), sinceMs, untilMs);
     },
     listChecklist: (v) => listChecklist(v),
     readRuns: (dir) => readReleaseRuns(null, dir),

package/src/ops/overview.ts

@@ -60,7 +60,28 @@ export interface MachineLoad {
   ioPressure?: IoPressure | null;
 }
 export interface MachineRow { name: string; load: Cell<MachineLoad> }
-export interface PodMemberRow { context: string; capacity: number; occupied: Cell<number> }
+/**
+ * GATE-RESERVE-AUTO 가 잰 «게이트 예약 몫» — 발행 게이트 샤드가 쥔 CPU. 자원 지도의 다섯째 축이다.
+ * `harnessCpuSlotsBesideGate` 와 같은 fail-closed 규칙: 샤드가 아직 노드에 안 붙었으면 하니스 Pod 는 들어가지 않는다.
+ */
+export interface GateReservation {
+  /** 종결 전 게이트 샤드 Job 수 — 0 이면 게이트가 안 돈다(축 아님). */
+  jobs: number;
+  /** 그중 아직 노드에 안 붙은 샤드. */
+  unbound: number;
+  /** 샤드가 예약한 CPU(밀리코어). */
+  reservedMillicores: number;
+  /** 스케줄 가능한 노드들의 CPU 합(밀리코어). */
+  schedulableMillicores: number;
+}
+export interface PodMemberRow {
+  context: string; capacity: number; occupied: Cell<number>;
+  /**
+   * 게이트 예약 축 — `'none'` 은 «게이트가 안 돈다»(측정됨), `unmeasured` 는 못 잼(축에서 뺀다), 항목 없음은
+   * 이 칸에 게이트 원천이 없는 스냅숏(로컬 CLI 는 호출 경로 kubectl 0 규율로 늘 여기다).
+   */
+  gate?: Cell<GateReservation | 'none'>;
+}
 export interface ParentsInfo { count: number; staleOver6h: number; oldestHours: number | null }
 export interface SchedulerMetrics {
   scheduleRuns: number | null;
@@ -110,7 +131,7 @@ export interface VerdictResult { verdict: Verdict; reasons: string[]; nextAction
 /** 부하/코어가 이 값을 넘으면 «기계 압박»(흐름 저하의 사유). */
 export const LOAD_PER_CORE_PRESSURE = 3;
 
-/** 자원 지도의 축 어휘(닫힌 집합 · RES-FLOOR-BINDING). 게이트 예약은 이 칸에 원천이 없어 늘 제외다. */
+/** 자원 지도의 축 어휘(닫힌 집합 · RES-FLOOR-BINDING). */
 export type ResourceKind = 'memory' | 'cpu' | 'io' | 'slots' | 'gate';
 
 /** 구속 조건 — 남은 비율이 최소인 축. 남은 비율 = 남은 양/전체 양(CPU 는 압박선 LOAD_PER_CORE_PRESSURE×코어를 전체로 본다). */
@@ -132,26 +153,28 @@ function remainingAmount(n: number): string {
 
 /**
  * 구속 조건 규칙(RES-FLOOR-BINDING) — 메모리·CPU·I/O·슬롯·게이트 예약 중 «남은 비율 최소»인 축이 흐름을 묶는다.
- * 못 잰 축(하트비트 없는 호스트 · 용량 못 잼 · 하트비트에 PSI 가 없는 I/O · 원천이 없는 게이트 예약)은 후보에서 뺀다
+ * 못 잰 축(하트비트 없는 호스트 · 용량 못 잼 · 하트비트에 PSI 가 없는 I/O · 게이트 CPU 못 잼)은 후보에서 뺀다
  * — «넉넉»으로도 «바닥»으로도 읽지 않는다.
- * 측정 축이 하나도 없으면 null. 동율은 정해진 순서(호스트 순 메모리→CPU→I/O, 그 다음 슬롯)의 첫 축이 이긴다.
+ * 게이트 예약의 남은 비율 = (스케줄 가능 CPU − 샤드가 쥔 CPU) / 스케줄 가능 CPU. 샤드가 아직 노드에 안 붙었으면 0
+ * (하니스 Pod 는 들어가지 않는다 · `harnessCpuSlotsBesideGate` 와 같은 규칙).
+ * 측정 축이 하나도 없으면 null. 동율은 정해진 순서(호스트 순 메모리→CPU→I/O, 그 다음 슬롯, 그 다음 게이트 예약)의 첫 축이 이긴다.
  */
 export function bindingResource(s: OverviewSnapshot): ResourceBinding | null {
   const candidates: ResourceBinding[] = [];
   for (const host of s.machines.hosts) {
     const l = host.load.value;
     if (!l) continue;
-    if (l.totalGb > 0) {
+    if (Number.isFinite(l.freeGb) && Number.isFinite(l.totalGb) && l.totalGb > 0) {
       const remaining = Math.max(0, l.freeGb);
       candidates.push({ kind: 'memory', label: `${host.name} 메모리`, remainingRatio: ratio01(remaining / l.totalGb), remainingText: `${remainingAmount(remaining)}/${l.totalGb.toFixed(0)}GB` });
     }
-    if (l.cpuCount > 0) {
+    if (Number.isFinite(l.load5) && Number.isFinite(l.cpuCount) && l.cpuCount > 0) {
       const cpuCap = l.cpuCount * LOAD_PER_CORE_PRESSURE;
       const remaining = Math.max(0, cpuCap - l.load5);
       candidates.push({ kind: 'cpu', label: `${host.name} CPU`, remainingRatio: ratio01(remaining / cpuCap), remainingText: `${remainingAmount(remaining)}/${cpuCap.toFixed(0)}코어(압박선 ${LOAD_PER_CORE_PRESSURE}/코어)` });
     }
     const io = l.ioPressure;
-    if (io) {
+    if (io && Number.isFinite(io.someAvg10) && Number.isFinite(io.fullAvg10)) {
       const remaining = Math.max(0, 100 - io.someAvg10);
       candidates.push({ kind: 'io', label: `${host.name} I/O`, remainingRatio: ratio01(remaining / 100), remainingText: `${remainingAmount(remaining)}/100(압박 ${remainingAmount(io.someAvg10)}% · full ${remainingAmount(io.fullAvg10)}% · 10초 평균)` });
     }
@@ -161,6 +184,16 @@ export function bindingResource(s: OverviewSnapshot): ResourceBinding | null {
     const total = capacity.podTarget + capacity.localMax;
     candidates.push({ kind: 'slots', label: '슬롯', remainingRatio: ratio01(capacity.free / total), remainingText: `${capacity.free}/${total}자리` });
   }
+  for (const pod of s.machines.pods) {
+    const gate = pod.gate?.value;
+    if (!gate || gate === 'none') continue;
+    const total = gate.schedulableMillicores;
+    if (!Number.isFinite(total) || total <= 0 || !Number.isFinite(gate.reservedMillicores)) continue;
+    const remaining = gate.unbound > 0 ? 0 : Math.max(0, total - gate.reservedMillicores);
+    const unbound = gate.unbound > 0 ? ` · 미배치 ${gate.unbound}` : '';
+    candidates.push({ kind: 'gate', label: `${pod.context} 게이트 예약`, remainingRatio: ratio01(remaining / total),
+      remainingText: `${remainingAmount(remaining)}/${total.toFixed(0)}밀리코어(게이트 샤드 ${gate.jobs} · 예약 ${remainingAmount(gate.reservedMillicores)}${unbound})` });
+  }
   let binding: ResourceBinding | null = null;
   for (const c of candidates) if (binding === null || c.remainingRatio < binding.remainingRatio) binding = c;
   return binding;
@@ -255,7 +288,10 @@ export function unmeasuredCells(s: OverviewSnapshot): string[] {
   visit('tasks.byOwner', s.tasks.byOwner); visit('tasks.done', s.tasks.done);
   visit('tasks.launchable', s.tasks.launchable); visit('tasks.capacity', s.tasks.capacity);
   for (const h of s.machines.hosts) visit(`machines.${h.name}`, h.load);
-  for (const p of s.machines.pods) visit(`pods.${p.context}`, p.occupied);
+  for (const p of s.machines.pods) {
+    visit(`pods.${p.context}`, p.occupied);
+    if (p.gate) visit(`pods.${p.context}.gate`, p.gate);
+  }
   visit('machines.parents', s.machines.parents); visit('landings', s.landings);
   if (s.throughput) visit('throughput', s.throughput);
   if (s.schedulerMetrics) visit('schedulerMetrics', s.schedulerMetrics);

package/src/persona/loader.ts

@@ -154,6 +154,16 @@ export function validatePersonaShape(
     todo = obj['todo'];
   }
 
+  // 🗣️ 말투(speech style) — TUI-SPEECH-STYLE-CHARACTER. ⛔ 위 `actionHosts` 주석이
+  //    못 박은 그 이유로 ***여기에 명시로 옮긴다*** — 타입에만 더하면 YAML 의 그 줄은 영영 안 읽힌다.
+  let speechStyle: string | undefined;
+  if (Object.hasOwn(obj, 'speechStyle')) {
+    if (typeof obj['speechStyle'] !== 'string' || !obj['speechStyle'].trim()) {
+      return err(path, 'speechStyle must be a non-empty string');
+    }
+    speechStyle = obj['speechStyle'];
+  }
+
   let mentionPatterns: readonly string[] | undefined;
   if (obj['mentionPatterns'] !== undefined) {
     if (!Array.isArray(obj['mentionPatterns'])
@@ -169,6 +179,7 @@ export function validatePersonaShape(
     ...(todo !== undefined ? { todo } : {}),
     ...(description.value !== undefined ? { description: description.value } : {}),
     ...(systemPrompt.value !== undefined ? { systemPrompt: systemPrompt.value } : {}),
+    ...(speechStyle !== undefined ? { speechStyle } : {}),
     ...(brand !== undefined ? { brand } : {}),
     ...(models !== undefined ? { models } : {}),
     ...(mentionPatterns !== undefined ? { mentionPatterns } : {}),

package/src/persona/types.ts

@@ -30,6 +30,14 @@ export interface PersonaProfile {
    *  v1 = no resolution, raw passthrough). */
   readonly systemPrompt?: string;
 
+  /**
+   * 🗣️ **말투(speech style)** — 이 페르소나가 «어떻게» 말하는가(TUI-SPEECH-STYLE-CHARACTER).
+   *
+   * ⛔ 안 적으면 «없다» — 기본 말투를 조용히 채우지 않는다(`actionHosts`·`capabilities`
+   *    와 같은 규율: 관측이 「선언이 없다」고 말한다).
+   */
+  readonly speechStyle?: string;
+
   /**
    * 🚧 **이 봇이 «손을 쓸 수 있는» 호스트들** — 되돌릴 수 없는 브라우저 조작의 «경계».
    *

package/src/policy/llm-policy.ts

@@ -4,7 +4,7 @@ import { isScalar, parseDocument } from 'yaml';
 import { getElanousConfigDir } from '../elanous-config-dir.js';
 import { DEFAULT_FALLBACK_CHAIN, isFallbackStep, type FallbackStep } from '../oauth/fallback-chain.js';
 import { isCodexQuotaPolicy } from '../oauth/codex-quota-policy.js';
-import { DEFAULT_BUDGET_GATE_MAX_USED_PERCENT, MODEL_ROLES, RUNTIME_LLM_PROVIDER_NAMES, parseRoleLlmEntry, parseSubscriptionReviewerSpec, type RoleLlmConfig, type SubscriptionReviewerSpec } from '../user-config.js';
+import { DEFAULT_BUDGET_GATE_MAX_USED_PERCENT, MODEL_ROLES, RUNTIME_LLM_PROVIDER_NAMES, parseReviewerMixSpec, parseRoleLlmEntry, parseSubscriptionReviewerSpec, type RoleLlmConfig, type SubscriptionReviewerSpec } from '../user-config.js';
 
 export interface LlmPolicy {
   version: 1;
@@ -106,6 +106,7 @@ export function validateLlmPolicy(input: unknown): LlmPolicyValidation {
     && nonempty(g.account) && positive(g.amount) && date(g.expires) && nonempty(g.source));
   const roles = (v: unknown) => object(v) && Object.entries(v).every(([role, spec]) => role === 'reviewer'
     ? !!parseSubscriptionReviewerSpec(spec)
+    : role === 'reviewerMix' ? !!parseReviewerMixSpec(spec)
     : MODEL_ROLES.some(r => r === role) && object(spec)
       && Object.keys(spec).every(k => ['provider', 'tier', 'model'].includes(k)) && parseRoleLlmEntry(spec).ok);
   check(input, 'policy', {
@@ -209,6 +210,7 @@ export function loadLlmPolicy(opts: LoadLlmPolicyOptions = {}): LoadedLlmPolicy
     if (Object.keys(base).length) overlay.default = base;
     add('roleLlm', legacy.roleLlm, overlay, 'roles', v => object(v) && Object.entries(v).every(([r, spec]) => r === 'reviewer'
       ? !!parseSubscriptionReviewerSpec(spec)
+      : r === 'reviewerMix' ? !!parseReviewerMixSpec(spec)
       : MODEL_ROLES.some(k => k === r) && parseRoleLlmEntry(spec).ok));
     add('llm.fallbackChain', llm.fallbackChain, overlay, 'fallback', v => Array.isArray(v) && v.length > 0 && v.every(isFallbackStep) && new Set(v).size === v.length);
     const codex: Obj = {};

package/src/prompt-enhance/enhance.ts

@@ -134,7 +134,7 @@ function askMarkerCount(ask: string): number {
   return (ask.match(/(?:^|\s)(?:불변식|경계|판정\s*신호|invariant|boundary|decision\s+signal)\s*:/gi) ?? []).length;
 }
 
-type EnhanceSelectionSource = 'opts' | 'env' | 'config-role' | 'fallback-child' | 'default';
+type EnhanceSelectionSource = 'opts' | 'env' | 'config-role' | 'child' | 'fallback-child' | 'default';
 const PLANNING_FALLBACK_REASONS = new Set(['quota-exhausted', 'quota-unmeasured', 'quota-unavailable', 'no-credential-source', 'expiring', 'credential-shape', 'credential-error', 'credential-unavailable', 'unavailable']);
 export function normalizePlanningFallbackReason(value: unknown): string {
   return typeof value === 'string' && PLANNING_FALLBACK_REASONS.has(value) ? value : 'unavailable';
@@ -153,7 +153,7 @@ export function selectEnhanceLlm(
   const forwardedModelSource = env.ELANOUS_PROMPT_ENHANCE_MODEL_RELAY === 'pod' ? env.ELANOUS_PROMPT_ENHANCE_MODEL_SOURCE : undefined;
   const modelSource: EnhanceSelectionSource = opts.model !== undefined ? 'opts'
     : env.ELANOUS_PROMPT_ENHANCE_MODEL
-      ? forwardedModelSource === 'config-role' || forwardedModelSource === 'fallback-child' || forwardedModelSource === 'default' ? forwardedModelSource : 'env'
+      ? forwardedModelSource === 'config-role' || forwardedModelSource === 'child' || forwardedModelSource === 'fallback-child' || forwardedModelSource === 'default' ? forwardedModelSource : 'env'
     : configuredModel !== undefined ? 'config-role' : 'default';
   const model = opts.model ?? (env.ELANOUS_PROMPT_ENHANCE_MODEL || configuredModel || env.ELANOUS_PR_REVIEW_MODEL || tierModel('better'));
   const envEffort = env.ELANOUS_PROMPT_ENHANCE_EFFORT;
@@ -176,7 +176,7 @@ export function selectEnhanceLlm(
 export function selectPlanningLlm(
   env: NodeJS.ProcessEnv = process.env,
   config: UserConfig = getUserConfig(),
-): { model: string | undefined; effort: 'low' | 'medium' | 'high'; modelSource: 'env' | 'config-role' | 'fallback-child' | 'default'; fallbackReason?: string; requestedModel?: string; requestedSource?: string } {
+): { model: string | undefined; effort: 'low' | 'medium' | 'high'; modelSource: 'env' | 'config-role' | 'child' | 'fallback-child' | 'default'; fallbackReason?: string; requestedModel?: string; requestedSource?: string } {
   const planning = config.roleLlm?.planning;
   const envModel = env.ELANOUS_PROMPT_ENHANCE_MODEL;
   const roleModel = !envModel && planning && (planning.model || planning.tier || planning.provider)
@@ -186,7 +186,7 @@ export function selectPlanningLlm(
   const relayed = env.ELANOUS_PROMPT_ENHANCE_MODEL_RELAY === 'pod';
   const forwardedSource = relayed ? env.ELANOUS_PROMPT_ENHANCE_MODEL_SOURCE : undefined;
   const modelSource = envModel
-    ? forwardedSource === 'config-role' || forwardedSource === 'fallback-child' || forwardedSource === 'default' ? forwardedSource : 'env'
+    ? forwardedSource === 'config-role' || forwardedSource === 'child' || forwardedSource === 'fallback-child' || forwardedSource === 'default' ? forwardedSource : 'env'
     : roleModel ? 'config-role' : 'default';
   const envEffort = env.ELANOUS_PROMPT_ENHANCE_EFFORT;
   const validEnvEffort = envEffort === 'low' || envEffort === 'medium' || envEffort === 'high' ? envEffort : undefined;

package/src/prompt-library/session-guidance.ts

@@ -33,6 +33,11 @@ function hasTool(enabled: ReadonlySet<string>, ...names: string[]): boolean {
   return false;
 }
 
+/** One working tab per site: each one-shot `aside repl "<js>"` call starts a new REPL
+ *  session, so `page` from the previous call is gone — reattach, don't reopen. */
+export const ASIDE_BROWSER_GUIDANCE =
+  'When you drive a browser with `aside repl "<js>"`: each call is a new REPL session, so reuse ONE working tab instead of opening a new one per step (extra tabs of the same app trigger «open in another tab» locks and lost connections). Start every script by reattaching: `const t1=(await listBrowserTabs()).find(t=>t.url.startsWith(\'<origin+path>\')); if (t1) await attachBrowserTab(t1.targetId); else await openTab(\'<url>\');` then use `page`. Call `openTab()` only when no matching tab exists or the user asks for a new page. Always pass the script as the argument — a bare `aside repl` waits for input until the shell timeout. A REPL call may run up to 120s, so give long browser steps a shell timeout above that (e.g. 150000 ms) and split very long flows into several calls.';
+
 /** Build the session guidance addendum. Returns 0 or 1 system message
  *  containing per-tool one-liner directives, gated on what's active.
  *  When `enabledTools` is undefined or every relevant tool is absent,
@@ -114,6 +119,15 @@ export function buildSessionGuidanceAddendum(
     );
   }
 
+  // Browser via Aside (ASIDE-TAB-REUSE · 10-22). Observed in the n8n lecture
+  // session: every step ran `aside repl "var p=await openTab('<same url>')…"`.
+  // A one-shot `aside repl` is a fresh REPL session, so each call opened another
+  // tab → n8n «Editing in another tab» lock → lost connection → the step repeated.
+  // A bare `aside repl` (no script) also hung until the shell timeout.
+  if (hasTool(active, 'Bash', 'bash', 'RunShell', 'run_shell', 'aside.repl', 'aside_repl')) {
+    items.push(ASIDE_BROWSER_GUIDANCE);
+  }
+
   if (items.length === 0) return [];
   // B4 — 파일 수 규칙. 명령을 실제로 돌릴 도구(Bash·PtyShellStart·WebTerminal*)가 있을 때만 `git ls-files` 로 세라고 하고,
   // Read 만 켜진 세션에선 셀 수 없으니 추측하지 말고 확인 불가라고 답하게 한다(EVAL q09 «959» vs 실측 778 · 리뷰 3라운드 must-fix).

package/src/provider-summary.ts

@@ -17,6 +17,7 @@ import { loadTokens, isExpiringSoon } from './oauth/store.js';
 import { CODEX_REFRESH_BUFFER_MS } from './oauth/codex.js';
 import { findCodexModel } from './codex/models.js';
 import { getLocalLLMUrl } from './config.js';
+import { zaiCodingPlanAvailable } from './llm/zai-coding-plan.js';
 
 export type AuthKind = 'oauth' | 'apikey' | 'local' | 'none';
 
@@ -105,6 +106,13 @@ function authDetailForDecision(
       ? llm.apiKey ? 'API key (config)' : 'API key (~/.cache/openrouter_api_key · env OPENROUTER_API_KEY)'
       : 'not configured — bash scripts/add-api-key.sh OPENROUTER_API_KEY';
   }
+  // GLM-NO-CREDENTIAL-FALLBACK (OP #28375 · 🩸 run-6c85c69f) — 종전엔 glm 칸이 없어 자격이 «있어도» 아래 일반 문면
+  //   「no provider configured」가 찍혔고(자식 PTY 첫 줄), 부검이 그 줄을 «자격 결손» 원인으로 읽었다. 판정은 glm 직결이 서는 조건 그 함수다.
+  if (provider === 'glm') {
+    return zaiCodingPlanAvailable()
+      ? 'GLM Coding Plan 키 (~/.cache/zai_api_key · env ZAI_API_KEY)'
+      : 'not configured — ZAI_API_KEY 없음 (~/.cache/zai_api_key · env ZAI_API_KEY)';
+  }
   if (provider === 'local') {
     const url = llm.baseUrl || getLocalLLMUrl();
     return auth === 'local' && url ? `OpenAI-compat endpoint — ${url}` : 'not configured — set llm.baseUrl';

package/src/pty-shell/availability.ts

@@ -0,0 +1,7 @@
+import { bunNativePtyAvailable } from './bun-native-pty.js';
+
+/** Keep the capability probe independent of PTY runtime initialization. */
+export function ptyAvailable(): boolean {
+  if (bunNativePtyAvailable()) return true;
+  try { require.resolve('node-pty'); return true; } catch { return false; }
+}