elanous 0.2.25 → 0.2.27

package/src/harness/harness-cli-command.ts

@@ -25,6 +25,8 @@ import { classifyPodExitStop, recordRunStop, runStopRecorded, RUN_STOP_EVENT } f
 import { ensureOpenRouterChildModelLive, resolveChildLlmEffort, resolveImplementationChildModel } from '../self-dev/dev-cli.js';
 import { resolveHarnessTarget } from '../self-implement/harness-target-options.js';
 import { buildRunProgressRows, isPartialRunningRuns, queryRunningRuns, renderRunProgressTable } from '../self-implement/running-runs.js';
+import { launchBindingRunIds, readLaunchBinding } from './launch-registry.js';
+import { psProcessStartMs } from './harness-stop.js';
 import { DevPipelineError } from '../self-dev/dev-pipeline.js';
 import { collectDraftMetrics, collectOverlapMetrics, DRAFT_SWEEP_CONCURRENCY, mapBounded, resolveDraftSweepCloseCap, runDraftSweep, sweepFailureReason, type DraftSweepAdapters, type DraftSweepResult, type OverlapMetricAdapters, type SweepDraft, type SweepMergedPr, type SweepReviewGate } from '../self-dev/draft-sweep.js';
 import { readAskPreflightRowsSince, readSalvagedRowsSince } from '../self-dev/ask-launch-io.js';
@@ -2391,6 +2393,7 @@ const defaultDraftSweepStopRun: DraftSweepStopRun = async (runId) => {
 export function githubDraftSweepAdapters(execute: GhExecute = executeGh, git: DraftSweepGitExecute = runGitCommand, cwd = process.cwd(),
   executeAsync: (args: string[]) => Promise<string> = execute === executeGh ? executeGhAsync : async (args) => execute(args),
   stopRun: DraftSweepStopRun = defaultDraftSweepStopRun): GithubDraftSweepAdapters {
+  const ensuredSweepLabels = new Set<string>();
   const inventory = async (repository: string, state: 'open' | 'closed'): Promise<GithubPull[]> => {
     // ⛔ A large repository has tens of thousands of closed PRs (2026-09-28: 21k → «exceeded pagination limit», no sweep at all).
     //    Merged twins only matter after the oldest open draft was opened, so the closed listing stops at that time.
@@ -2642,11 +2645,19 @@ export function githubDraftSweepAdapters(execute: GhExecute = executeGh, git: Dr
         .map((line) => line.slice('branch refs/heads/'.length).trim()));
     },
     setLabels: async (repository, number, change) => {
+      if (change.add.startsWith('elanous:swept:')) {
+        const key = `${repository}:${change.add}`;
+        if (!ensuredSweepLabels.has(key)) {
+          execute(['label', 'create', change.add, '--repo', repository, '--color', '6A737D',
+            '--description', 'Draft sweep close reason; reopen this PR to restore it', '--force']);
+          ensuredSweepLabels.add(key);
+        }
+      }
       execute(['pr', 'edit', String(number), '--repo', repository, '--add-label', change.add,
         ...change.remove.flatMap((name) => ['--remove-label', name])]);
     },
-    closeDraft: async (repository, number, comment) => {
-      execute(['pr', 'close', String(number), '--repo', repository, '--comment', comment]);
+    closeDraft: async (repository, number) => {
+      execute(['pr', 'close', String(number), '--repo', repository]);
     },
     getClaimOwner: async (repository, number) => claimCommentOwner(repository, number, execute),
     getActiveClaimOwner: async (repository, number) => activeClaimOwnerFromBodies(await claimCommentsFor(repository, number)),
@@ -3137,7 +3148,13 @@ export interface HarnessCliCommandDeps {
   mission?: HarnessMissionHandler;
   missionLoop?: HarnessMissionLoopHandler;
   /** `harness progress` 가 도는 런 관측을 읽는 자리(시험 주입). 기본은 queryRunningRuns. */
-  progress?: { query?: typeof queryRunningRuns; nowMs?: () => number };
+  progress?: {
+    query?: typeof queryRunningRuns;
+    nowMs?: () => number;
+    bindingRunIds?: typeof launchBindingRunIds;
+    readBinding?: typeof readLaunchBinding;
+    processStartMs?: typeof psProcessStartMs;
+  };
 }
 
 export function installHarnessCliCommand(program: Command, deps: HarnessCliCommandDeps): Command {
@@ -3198,8 +3215,33 @@ export function installHarnessCliCommand(program: Command, deps: HarnessCliComma
     });
   harnessCmd.command('progress').description('도는 골마다 진도를 한 표로 읽는다 — 단계 · 진입 시각 · 마지막 진전 · pty (읽기 전용)')
     .option('--json', '같은 행 배열을 JSON 으로 출력')
-    .action((opts: { json?: boolean }) => {
+    .option('--pid <number>', '기록된 로컬 PID 에 연결된 런 한 건만 조회')
+    .action((opts: { json?: boolean; pid?: string }) => {
       try {
+        if (opts.pid !== undefined) {
+          const pid = Number(opts.pid);
+          if (!Number.isSafeInteger(pid) || pid <= 1) {
+            console.error('❌ --pid 는 2 이상의 정수여야 합니다');
+            process.exitCode = 2;
+            return;
+          }
+          const bindings = (deps.progress?.bindingRunIds ?? launchBindingRunIds)()
+            .map((runId) => ({ runId, binding: (deps.progress?.readBinding ?? readLaunchBinding)(runId) }))
+            .filter(({ binding }) => binding?.pid === pid);
+          const binding = bindings.length === 1 && !bindings[0]!.binding?.podName ? bindings[0] : undefined;
+          const startedAt = binding ? (deps.progress?.processStartMs ?? psProcessStartMs)(pid) : null;
+          // ps lstart has second precision. A wider stop-oriented tolerance would attribute a reused PID to this run.
+          const observed = binding && startedAt !== null
+            && startedAt === Math.floor(binding.binding!.startedAt / 1_000) * 1_000;
+          const result = observed
+            ? (deps.progress?.query ?? queryRunningRuns)({ runIds: [binding.runId], caller: 'harness.progress.pid' })
+            : null;
+          const row = result ? buildRunProgressRows(result, (deps.progress?.nowMs ?? Date.now)())
+            .find((item) => item.runId === binding!.runId && item.status !== 'ended-unclosed' && item.status !== 'unknown') : undefined;
+          if (opts.json) console.log(JSON.stringify({ pid, observation: row ? 'observed' : 'unobserved', runId: row?.runId ?? null, progress: row ?? null }));
+          else console.log(row ? `pid ${pid} · ${renderRunProgressTable({ ...result!, entries: result!.entries.filter((item) => item.runId === row.runId) }, (deps.progress?.nowMs ?? Date.now)()).split('\n').slice(1).join('\n')}` : `pid ${pid} · 미관측`);
+          return;
+        }
         const result = (deps.progress?.query ?? queryRunningRuns)({ caller: 'harness.progress' });
         const nowMs = (deps.progress?.nowMs ?? Date.now)();
         if (opts.json) {

package/src/harness/harness-stop.ts

@@ -81,7 +81,7 @@ export function discoverStopProcesses(runId: string, goalPath: string | null, ta
     const match = /^\s*(\d+)\s+((?:Mon|Tue|Wed|Thu|Fri|Sat|Sun)\s+\w+\s+\d+\s+\d\d:\d\d:\d\d\s+\d{4})\s+(.+)$/.exec(line);
     if (!match) return { status: 'failed', reason: 'unparseable process table row' };
     const pid = Number(match[1]);
-    const startedAt = Date.parse(match[2]!);
+    const startedAt = Date.parse(`${match[2]!} GMT`);
     if (!Number.isSafeInteger(pid) || !Number.isFinite(startedAt)) return { status: 'failed', reason: 'invalid process table row' };
     if (pid <= 1) continue;
     const args = match[3]!.match(/"[^"]*"|'[^']*'|\S+/g)?.map((part) => part.replace(/^(['"])(.*)\1$/, '$2')) ?? [];
@@ -132,7 +132,9 @@ function stopProcessCwd(pid: number): string | null {
 
 function scanStopProcessTable(runId: string, goalPath: string | null): StopProcessScan {
   let r: ReturnType<typeof spawnSync>;
-  try { r = spawnSync('ps', ['-eo', 'pid=,lstart=,args='], { encoding: 'utf8', timeout: 5_000, maxBuffer: 16 * 1024 * 1024 }); }
+  try { r = spawnSync('ps', ['-eo', 'pid=,lstart=,args='], {
+    encoding: 'utf8', timeout: 5_000, maxBuffer: 16 * 1024 * 1024, env: { ...process.env, TZ: 'UTC' },
+  }); }
   catch (error) { return { status: 'failed', reason: String(error) }; }
   if (r.error || r.status !== 0 || typeof r.stdout !== 'string') return { status: 'failed', reason: String(r.error ?? r.stderr ?? `ps status ${r.status}`) };
   return discoverStopProcesses(runId, goalPath, r.stdout, stopProcessCwd);
@@ -201,13 +203,15 @@ export function pidRecordFromLaunchBinding(runId: string, registryDir = launchRe
   return { pid: binding.pid, startedAt: binding.startedAt, ...(binding.argv0 ? { argv0: binding.argv0 } : {}) };
 }
 
-/** macOS·Linux 공통 — `ps -o lstart=` 는 로컬 시각 문자열(초 단위)이다. */
+/** macOS·Linux 공통 — UTC 시작 시각과 상태를 같은 ps 관측에서 읽는다. */
 export function psProcessStartMs(pid: number): number | null {
-  const r = spawnSync('ps', ['-o', 'lstart=', '-p', String(pid)], { encoding: 'utf8', timeout: 5_000 });
+  const r = spawnSync('ps', ['-o', 'lstart=,stat=', '-p', String(pid)], {
+    encoding: 'utf8', timeout: 5_000, env: { ...process.env, TZ: 'UTC' },
+  });
   if (r.status !== 0) return null;
-  const text = r.stdout.trim();
-  if (!text) return null;
-  const ms = Date.parse(text);
+  const match = /^\s*((?:Mon|Tue|Wed|Thu|Fri|Sat|Sun)\s+\w+\s+\d+\s+\d\d:\d\d:\d\d\s+\d{4})\s+(\S+)\s*$/.exec(r.stdout);
+  if (!match || match[2]!.startsWith('Z')) return null;
+  const ms = Date.parse(`${match[1]!} GMT`);
   return Number.isFinite(ms) ? ms : null;
 }
 

package/src/index.ts

@@ -38,6 +38,7 @@ import { DEV_PIPELINE_SINK_SURFACE } from './self-implement/self-cli-sink-surfac
 import { registerPrivateLedgerCommands } from './cli/private-ledger-commands.js';
 import { registerKnowCommand } from './cli/know-cli.js';
 import { registerSeatRequestsCommands } from './cli/seat-requests-cli.js';
+import { registerSeatBootCommands } from './cli/seat-cli.js';
 import { applyTestStateDirFlagFromArgv } from './cli/test-state-dir-flag.js';
 import { applyTestFlagFromArgv, observeTestFlagOwnership, uncoveredTestFlagPaths, staleTestFlagPaths } from './cli/test-flag.js';
 import { registerPtyTakeoverCommands } from './cli/pty-takeover-cli.js';
@@ -1118,6 +1119,7 @@ hqCmd.command('fence').description('이 호스트가 임대를 쥐었을 때만
     process.exitCode = hqFenceRun(opts.role as 'cron', command);
   });
 const seatCmd = program.command('seat').description('분배된 자리의 하루 루프와 보고');
+registerSeatBootCommands(seatCmd);
 registerSeatRequestsCommands(seatCmd);
 seatCmd.command('asks').description('최근 CTO 되묻기 왕복과 10분 판정')
   .option('--since <duration>', '조회 창 (예: 24h)', '24h')
@@ -3352,6 +3354,7 @@ coordCmd.command('events')
   });
 
 const selfCmd = program.command('self').description('Self-awareness memory — 외부 도구(Claude Code/Codex)가 구현/변경 이력을 elanous 기억에 주입·회상');
+{ const { registerSelfUtterancesCommand } = await import('./cli/self-utterances-cli.js'); registerSelfUtterancesCommand(selfCmd); }
 
 // M12 Claude Code 의존도 계기판 — `elanous self dependence [--since] [--until] [--json]`(읽기만).
 { const { registerDependenceCommand } = await import('./cli/dependence-gauge.js'); registerDependenceCommand(selfCmd); }
@@ -5744,6 +5747,19 @@ selfCmd
       envModel: () => process.env.ELANOUS_PR_REVIEW_MODEL,
     });
     if (opts.json) await writeStdoutJson(selfReviewJsonLine(results));
+    // Detached TA review: stdout is now complete in its result file. Resume only the bound card.
+    try {
+      const { rejudgeCompletedTaskReview, TA_REVIEW_COMPLETION_CARD_ENV, TA_REVIEW_COMPLETION_STATE_ENV, TA_REVIEW_COMPLETION_RESULT_ENV } = await import('./task-agent/review-result-capture.js');
+      const completionEnv: Record<string, string | undefined> = {};
+      for (const key of [TA_REVIEW_COMPLETION_CARD_ENV, TA_REVIEW_COMPLETION_STATE_ENV, TA_REVIEW_COMPLETION_RESULT_ENV]) {
+        const value = process.env[key];
+        if (value) completionEnv[key] = value;
+        delete process.env[key];
+      }
+      await rejudgeCompletedTaskReview(completionEnv);
+    } catch (error) {
+      try { debug.log('task-agent', 'review-completion-rejudge-failed', { reason: String(error).slice(-300) }, { level: 'warn' }); } catch { /* fail-soft */ }
+    }
     if (failed >= 1) process.exitCode = 1;
   });
 
@@ -5822,22 +5838,25 @@ selfCmd
   .description('외부 도구 발화를 elanous 기억에 주입 — origin/git/branch/cwd/시간 태그(회상이 "누가 언제 어디서" 구분). text=--text 또는 stdin')
   .option('-s, --text <text>', '발화 원문(생략 시 stdin)')
   .option('--source <origin>', 'claude-code|codex|gemini|…', 'claude-code')
+  .option('--origin <origin>', '발화 주체: human|agent (기본 agent)')
   .option('--session <id>', '세션 id')
   .option('--git-hash <hash>', '발화 시점 git HEAD(short)')
   .option('--branch <name>', 'git 브랜치')
   .option('--cwd <dir>', '작업 디렉토리')
   .option('--ts <iso>', 'ISO 시간(기본 now)')
   .option('-i, --importance <n>', '0-10 현저성', '5')
-  .action(async (opts: { text?: string; source: string; session?: string; gitHash?: string; branch?: string; cwd?: string; ts?: string; importance: string }) => {
+  .action(async (opts: { text?: string; source: string; origin?: string; session?: string; gitHash?: string; branch?: string; cwd?: string; ts?: string; importance: string }) => {
+    if (opts.origin !== undefined && opts.origin !== 'human' && opts.origin !== 'agent') { ui.error('utterance: --origin must be human or agent'); process.exitCode = 1; return; }
     let text = opts.text;
     if (!text) text = await readPipedStdin();   // ★ OBS-T3
     if (!text || !text.trim()) { ui.error('utterance: --text 또는 stdin 필요'); process.exit(1); }
     // 독립 CLI 프로세스 — 데몬 StoreSink 를 상속 안 하므로 logs.db 싱크를 붙여야
     // injectUtterance 의 `debug.log('memory.utterance','ingress')` 가 logs.db 에 닿음(제1원칙 관측).
-    const { injectUtterance } = await import('./domains/self-awareness.js');
-    const r = injectUtterance({
+    const { recordSelfUtterance } = await import('./cli/self-utterances-cli.js');
+    const r = recordSelfUtterance({
       text: text.trim(),
       origin: opts.source,
+      utteranceOrigin: opts.origin === 'human' ? 'human' : 'agent',
       ...(opts.session ? { sessionId: opts.session } : {}),
       ...(opts.gitHash ? { gitHash: opts.gitHash } : {}),
       ...(opts.branch ? { branch: opts.branch } : {}),
@@ -11722,7 +11741,10 @@ async function main(): Promise<void> {
   // 한다. 인터랙티브 TUI 는 데몬 sink 를 상속 안 하므로 안 붙이면 debug.log 가 no-op
   // (제1원칙 관측 갭 · tui-sim 드라이브에서 agent.source 0건으로 실측 2026-07-19).
   // PR#4622(self utterance CLI)·session-cli 미러. fail-open·비블로킹.
+  const bootTimer = (await import('./dashboard/boot-timing.js')).createBootTimer();
+  bootTimer.begin();
   try { await (await import('./domains/standalone-log-sink.js')).registerStandaloneLogSink('tui'); } catch { /* fail-open */ }
+  bootTimer.phase('log-sink');
   // P3(대표 2026-07-26) — footgun 관측을 logs.db 에 도달시킨다. 초반(arg 파싱 前) warnProdSpawnFootgun 은
   //   StoreSink 등록 前이라 debug.log 가 logs.db 미도달이었다(순서 갭). sink 등록 직후 관측만 재발행(stderr 중복 X).
   try { (await import('./instance-root-coherence.js')).warnProdSpawnFootgun({ emit: 'log' }); } catch { /* fail-open */ }
@@ -11732,7 +11754,9 @@ async function main(): Promise<void> {
   // so `elanous self screen` / `/v1/terminals` / (P2) PWA can see the
   // dashboard the user is actually looking at. Off unless this boots
   // (no producer in headless/daemon paths). fail-soft·비블로킹.
+  bootTimer.begin();
   try { (await import('./capture/tui-self-report.js')).startTuiSelfReport(); } catch { /* fail-soft */ }
+  bootTimer.phase('self-report');
 
   // Dashboard handles sync inline — only returns on quit
   // ⛔ stdin 이 TTY 가 아니면 «뜨지 않는다» — 뜨면 readKey 가 엔터를 지어내 초당 수백 프레임을
@@ -11745,7 +11769,14 @@ async function main(): Promise<void> {
       return;
     }
   }
-  await showDashboard(dashboardOpts);
+  bootTimer.begin();
+  await showDashboard({
+    ...dashboardOpts,
+    onFirstFrameRendered: () => {
+      bootTimer.phase('show-dashboard');
+      bootTimer.done();
+    },
+  });
   closeTui();
   // Force exit: the dashboard starts background timers (clipboard
   // poller, shimmer/blink animations) that keep the Bun event loop

package/src/instance/current.ts

@@ -1,9 +1,8 @@
-import { join } from 'node:path';
 import { debug } from '../debug/log.js';
 import { getElanousConfigDirOverride } from '../elanous-config-dir.js';
 import { getTestStateRoot } from '../nexus/paths.js';
-import { findTreeRoot, getAppliedGlobalTestRoot } from '../cli/test-flag.js';
-import { isInstalledCopyScript, treeFromScriptPath } from './leader.js';
+import { getAppliedGlobalTestRoot } from '../cli/test-flag.js';
+import { isInstalledCopyScript } from './leader.js';
 import { prodInstanceRoot, resolveInstance, type InstanceResolution } from './resolve.js';
 
 interface ResolveCurrentInstanceDeps {
@@ -16,15 +15,12 @@ interface ResolveCurrentInstanceDeps {
 
 /** 현재 프로세스의 4층 판정 입력을 모아 순수 리졸버에 전달한다. */
 export function resolveCurrentInstance(deps: ResolveCurrentInstanceDeps = {}): InstanceResolution {
-  const cwd = (deps.cwd ?? (() => process.cwd()))();
   const explicitFlagRoot = (deps.explicitFlagRoot ?? (() =>
     getAppliedGlobalTestRoot() ?? getTestStateRoot() ?? getElanousConfigDirOverride()))();
-  const treeRoot = (process.argv[1] ? treeFromScriptPath(process.argv[1]) : null) ?? findTreeRoot(cwd);
   const resolution = resolveInstance({
     explicitFlagRoot,
     stampedStateDir: (deps.stampedStateDir ?? (() => process.env.ELANOUS_STATE_DIR))(),
     installedCopy: isInstalledCopyScript(),
-    treeTestRoot: treeRoot ? join(treeRoot, '.elanous-test') : null,
     prodRoot: prodInstanceRoot(),
   });
   debug.log('instance.current', 'resolved', { layer: resolution.layer, kind: resolution.kind });

package/src/instance/resolve.ts

@@ -1,9 +1,9 @@
-// 인스턴스 우주: 명시 루트 → 부모 스탬프 → 설치본 → 소스 트리 격리.
+// 인스턴스 우주: 명시 루트 → 부모 스탬프 → 운영 집. 트리 위치는 우주를 고르지 않는다.
 import { homedir } from 'node:os';
 import { join, resolve } from 'node:path';
 
 export type InstanceKind = 'prod' | 'test';
-export type ResolutionLayer = 'explicit-flag' | 'parent-stamp' | 'installed' | 'tree-derived' | 'default';
+export type ResolutionLayer = 'explicit-flag' | 'parent-stamp' | 'installed' | 'default';
 
 export interface InstanceResolution {
   kind: InstanceKind;
@@ -50,10 +50,9 @@ export function resolveInstance(deps: ResolveDeps = {}): InstanceResolution {
   }
   const installed = deps.installedCopy ?? isInstalledExecution();
   if (installed) return { kind: 'prod', root: prodRoot, layer: 'installed', why: '설치본으로 실행' };
-  const treeTestRoot = deps.treeTestRoot === undefined ? treeDerivedRootFor(process.cwd()) : deps.treeTestRoot;
-  if (treeTestRoot) return { kind: 'test', root: normRoot(treeTestRoot), layer: 'tree-derived', why: '소스 트리(격리)' };
-  // 레포 밖의 비설치 실행은 운영 권위를 얻지 않는다. 격리 루트를 cwd 에 둔다.
-  return { kind: 'test', root: normRoot(join(process.cwd(), '.elanous-test')), layer: 'default', why: '소스 트리 밖 실행(격리)' };
+  // Explicit --test selects a test root before this resolver runs. A checkout,
+  // worktree, or arbitrary cwd alone never changes the operating house.
+  return { kind: 'prod', root: prodRoot, layer: 'default', why: '명시 시험 우주가 없는 운영 집' };
 }
 
 /** 부모가 도장으로 물려준 우주와 자식이 실제로 쓰는 우주가 다른가. 비어 있는 쪽은 비교하지 않는다. */

package/src/llm/openai-sampling-fields.ts

@@ -0,0 +1,89 @@
+/**
+ * ⛔⭐ OpenAI Chat Completions 의 «출력 상한» 칸 이름은 모델 세대로 갈린다.
+ *
+ * `gpt-5` 이후 계열은 `max_tokens` 를 ***거부한다*** — 400 `unsupported_parameter` 를 내고
+ * *"Use 'max_completion_tokens' instead"* 라고 말한다. `gpt-4o` 계열은 반대로 옛 이름만 받는다.
+ *
+ * 📏 2026-08-22 실측: `provider auto` 의 티어 사다리가 `gpt-5.6-*` 로 바뀐 뒤(`#11161`)
+ * 3시간 만에 이 400 이 **93건** 났고 «가속»했다(20h:2 → 21h:16 → 22h:30 → 23h:45).
+ * 7일 창에서 그 이전 발생은 ***0***이다. ⇒ 칸 이름을 모델로 갈라야 한다.
+ *
+ * ⚠️ 값을 «안 보내는» 선택은 하지 않는다 — 상한이 사라지면 비용이 조용히 는다.
+ */
+/**
+ * ⛔⭐⭐ **브랜드마다 «칸 이름」이 다르다**(2026-09-12). `makeOpenAICompatProvider` 는 `grok` 과
+ * `openai` 를 «한 경로»로 태우는데, 종전엔 둘 다 옛 칸(`max_tokens`·`temperature`)을 «생으로» 박았다.
+ * ⇒ `openai` 브랜드의 새 세대(`gpt-5`+)는 그 둘을 «거부»한다 — 400 `unsupported_parameter`.
+ *
+ * 📏 실측 2026-09-12: `gpt-6-astra · maxTokens=2048 · api.openai.com/v1/chat/completions` 가 400 을 받았고,
+ *   그 400 이 `review.done` 미실행 57건 중 ***30건***의 사유였다(무인 리뷰가 그만큼 «안 돌았다»).
+ *
+ * ⭐ 자는 «이미» 있었다 — `openAiOutputTokenField`·`openAiTemperatureField`. ***이 호출부가 안 물었을 뿐이다.***
+ * 🪞 같은 파일의 `stripLocalLlmSpec` 이 「두 builder 중 하나만 정규화했다」로 난 사고의 처방이었다.
+ *   ***같은 모양이 다시 났다*** — 그래서 이번에도 «순수 함수로 뽑아» 양쪽이 같은 자를 쓰게 한다.
+ *
+ * ⛔ grok 은 옛 칸을 그대로 받는다 — 바꾸지 않는다.
+ */
+export function openAiCompatSamplingFields(
+  brand: string,
+  model: string,
+  temperature: number,
+  maxTokens: number,
+): Record<string, number> {
+  return brand === 'openai'
+    ? { ...openAiTemperatureField(model, temperature), ...openAiOutputTokenField(model, maxTokens) }
+    : { temperature, max_tokens: maxTokens };
+}
+
+export function openAiOutputTokenField(model: string, maxTokens: number): Record<string, number> {
+  return isNewGenerationOpenAiModel(model)
+    ? { max_completion_tokens: maxTokens }
+    : { max_tokens: maxTokens };
+}
+
+/** `gpt-5` 이후 계열 판정 — 옛 Chat Completions 파라미터를 거부하는 세대.
+ *
+ *  🩸⭐⭐ **2026-09-12 — 이 자가 «늙어서» 400 이 돌아왔다.** 종전 문면은 `/^(?:gpt-5|o[1-9])/` 라
+ *  ***`gpt-6` 계열을 «못 봤다»***. 그래서 `gpt-6-astra` 가 `max_tokens` 로 나갔고 400 을 받았다:
+ *    `Unsupported parameter: 'max_tokens' is not supported with this model. Use 'max_completion_tokens'`
+ *  📏 실측(2026-09-12 · 12시간 창): `review.done` 200행 중 `reviewed=false` 57, 그중 ***30***이 이 400 이다.
+ *    ⊕ 요청 로그가 그것을 한 줄로 말한다 — `gpt-6-astra · maxTokens=2048 · api.openai.com/v1/chat/completions`.
+ *
+ *  ⇒ ⭐ **세대를 「이름 목록」으로 세지 않는다.** 번호를 «범위»로 읽어 다음 세대가 와도 안 늙게 한다.
+ *    `gpt-5` 이상(두 자리 포함) ⊕ `o1`~`o9`. ⛔ `gpt-4` 이하와 로컬 모델은 종전대로 옛 칸을 쓴다.
+ *
+ *  🌐 **외부 그라운딩**(2026-09-12 · omni-crawl `fc-dev`) — 같은 사고가 «업스트림에도» 있었다:
+ *    · `quantumnous/new-api#7211` — *"GPT-6 Astra 未命中原来的 GPT-5 前缀判断"* (똑같은 접두 판정 누락)
+ *    · `genkit-ai/genkit#6320`   — *"max_tokens is sent verbatim and rejected by reasoning models"*
+ *    · Azure AI docs            — `gpt-6-astra`(2026-09-03) Chat Completions ⊕ Reasoning
+ *    · overchat.ai              — *"Astra does not support `temperature`, `top_p`, `top_logprobs`"*
+ *      ⇒ ✅ 우리가 `temperature` 를 «생략»하는 것이 외부 사실과 «맞는다».
+ *      ⚠️ `top_p`·`logprobs` 는 이 경로가 «안 보낸다»(local 프리셋 경로만 보낸다) — 그래서 조치 없음.
+ *
+ *  ⚖️ ⛔ **알려진 트레이드오프 — new-api 는 «반대» 결론을 냈다.** 그들은
+ *    *"모든 미래 GPT 메이저를 GPT-5 로 묶으면 서로 다른 모델의 파라미터 규칙이 엮인다"* 며
+ *    ***미지의 미래 메이저는 추론하지 않는다***로 갔다(명시 목록 + 날짜 스냅샷).
+ *    ⇒ 우리는 «반대»를 택했다. 이유: ***목록이 늙어서 이 사고가 났기 때문***이다
+ *      (이 저장소에서 실제로 리뷰 미실행 30건을 냈다). 새 규칙은 «새 관례 쪽으로» 실패한다.
+ *    📌 그러므로 ***`gpt-N` 중 옛 칸을 «되찾는» 모델이 나오면 이 자가 틀린다.*** 그때는
+ *      여기서 갈지 말고 «모델별 능력 선언»으로 옮긴다(new-api 가 간 길). 지금은 그 표본이 0이다. */
+export function isNewGenerationOpenAiModel(model: string): boolean {
+  const match = /^gpt-(\d+)/i.exec(model);
+  if (match) return Number.parseInt(match[1]!, 10) >= 5;
+  return /^o[1-9]/i.test(model);
+}
+
+/**
+ * ⛔⭐ 같은 세대가 `temperature` 도 거부한다 — 400 `unsupported_value`,
+ * *"Only the default (1) value is supported"*.
+ *
+ * 📏 2026-08-22 실측: `max_tokens` 를 고친 «2분 뒤»(00:13:03Z)부터 이 400 이 났고
+ * 90분에 **41건**이었다. ⇒ ***한 파라미터만 고치면 다음 파라미터에서 막힌다.***
+ * ⚠️ 그때 나는 「수리 뒤 400 이 0건」이라 보고했는데, 그 자가 `grep max_completion_tokens`
+ * 라서 «새 400»을 못 봤다 — ***좁은 자로 「나았다」를 읽었다.***
+ *
+ * ⇒ 값을 «1로 보내지» 않고 ***칸을 생략***한다. 서버 기본이 1이고, 보내면 또 다른 거부를 부른다.
+ */
+export function openAiTemperatureField(model: string, temperature: number): Record<string, number> {
+  return isNewGenerationOpenAiModel(model) ? {} : { temperature };
+}

package/src/llm/runtime-model-family.ts

@@ -0,0 +1,61 @@
+import type { LLMProviderName } from '../user-config.js';
+
+/** Lightweight model-id family — prefix/substring only. No catalog, no
+ *  `src/llm/model-defaults.ts` (that module imports this file). */
+export type RuntimeLlmModelFamily =
+  | 'grok' | 'anthropic' | 'openai' | 'openai-codex' | 'gemini' | 'local'
+  | 'kimi' | 'qwen' | 'glm' | 'openrouter' | 'bedrock' | 'unknown';
+
+export function inferRuntimeLlmModelFamily(model: string | undefined): RuntimeLlmModelFamily {
+  if (!model) return 'unknown';
+  const m = model.trim().toLowerCase();
+  if (!m) return 'unknown';
+  // ⛔ 2026-09-23 — 게이트웨이 접두가 «먼저»다. 안 그러면 `openrouter/anthropic/claude-…` 가 `anthropic` 으로
+  //   읽혀 openrouter 와 «비호환»이 되고, `openrouter/z-ai/…` 는 `unknown` 이라 아무 provider 와도 «호환»이 됐다.
+  if (m.startsWith('openrouter/')) return 'openrouter';
+  // ⭐ BEDROCK-PROVIDER — Bedrock 전용 꼴(`anthropic.claude-…`·지역 접두·`bedrock/…`)이 `includes('claude')` 보다 «먼저».
+  //   1st-party id(`claude-…`)는 그대로 anthropic 이다(불변).
+  if (m.startsWith('bedrock/') || /^(?:[a-z]{2,6}\.)?anthropic\.claude-/.test(m)) return 'bedrock';
+  if (m.includes('grok')) return 'grok';
+  if (m.includes('claude')) return 'anthropic';
+  if (m.startsWith('gemini-') || m.includes('gemini')) return 'gemini';
+  if (m.startsWith('local:')) return 'local';
+  if (m.startsWith('kimi')) return 'kimi';
+  if (m.startsWith('qwen')) return 'qwen';
+  if (m.startsWith('glm')) return 'glm';
+  // openai-codex 구독 모델만 여기 — gpt-5.5 등 Chat Completions 모델은 openai.
+  // ⛔ openai 와 openai-codex 를 한 계열로 접지 마라. 서로 다른 엔드포인트다.
+  // ✅ 2026-09-23 (대표 ⒜ 결정) — ***`gpt-6` 를 여기 «더했다».***
+  //   종전엔 `gpt-6-*` 가 아래 `startsWith('gpt-')` 로 떨어져 `openai` 가 됐고, 그래서
+  //   ***사다리가 «자기 가드가 거부하는 모델»을 가리켰다*** (`CODEX.loaded = gpt-6-astra`).
+  //   📏 구독 경로 실호출로 확인(codex-cli 0.155.1): gpt-6-sol · luna · astra 전부 응답.
+  //   ⚠️ 이 셋은 API 로도 불린다(`/v1/models` 에 있다). 「계열」이 재는 것은 «가용성»이 아니라
+  //      ***「우리가 어느 문으로 보내나」***다 — 5.6 계열도 API 에 있지만 여기로 온다.
+  if (m.includes('codex') || m.startsWith('gpt-5.6') || m.startsWith('gpt-6')) return 'openai-codex';
+  // Exact o1/o3/o4 ids are standard OpenAI models; prefix-only (`o1-`) misses them.
+  if (
+    m.startsWith('gpt-')
+    || m === 'o1' || m.startsWith('o1-')
+    || m === 'o3' || m.startsWith('o3-')
+    || m === 'o4' || m.startsWith('o4-')
+  ) return 'openai';
+  return 'unknown';
+}
+
+/** Cycle-safe compatibility: same-provider model overrides pass;
+ *  cross-family ids fail. Unknown prefixes and `auto` stay silent.
+ *  ⛔ `openai` 와 `openai-codex` 는 별개 provider — 양방향 호환으로 접지 않는다. */
+export function isRuntimeLlmModelCompatibleWithProvider(
+  provider: LLMProviderName,
+  model: string | undefined,
+): boolean {
+  if (!model) return true;
+  if (provider === 'auto') return true;
+  const family = inferRuntimeLlmModelFamily(model);
+  if (family === 'unknown') return true;
+  if (provider === 'local') return family === 'local';
+  // bedrock 은 1st-party claude id 도 받는다(공급자가 `anthropic.` 접두로 바꿔 보낸다).
+  if (provider === 'bedrock') return family === 'bedrock' || family === 'anthropic';
+  return provider === family;
+}
+

package/src/llm/zai-coding-plan.ts

@@ -122,6 +122,26 @@ export interface ZaiErrorClass {
   resetRaw: string | null;
 }
 
+/** Provider-neutral signal shape for supervisors coordinating plan-limit recovery. */
+export interface ProviderPlanLimitSignal {
+  provider: string;
+  kind: 'plan-limit';
+  resetAt: number | null;
+  overage: string;
+}
+
+/** Extract the structured recovery signal from a Z.ai 1308 response; unrelated errors return null. */
+export function extractZaiPlanLimitSignal(
+  status: number,
+  bodyText: string,
+  overage: string,
+): ProviderPlanLimitSignal | null {
+  const classified = classifyZaiError(status, bodyText);
+  if (!classified || classified.code !== 1308 || classified.kind !== 'plan-limit') return null;
+  return { provider: 'glm', kind: 'plan-limit', resetAt: classified.resetAt, overage };
+}
+
+
 const PLAN_LIMIT = new Set([1308, 1310]);
 const BALANCE_LIMIT = new Set([1113, 1316, 1317, 1318, 1319, 1320, 1321]);
 const PLAN_UNAVAILABLE = new Set([1309, 1311, 1313, 1314, 1315]);
@@ -433,13 +453,15 @@ export class ZaiCodingPlanLimitError extends Error {
   readonly code: number;
   readonly limitKind: ZaiLimitKind;
   readonly resetAt: number | null;
-  constructor(opts: { code: number; limitKind: ZaiLimitKind; resetAt: number | null; policy: ZaiOveragePolicy; reason: string }) {
+  readonly planLimitSignal?: ProviderPlanLimitSignal;
+  constructor(opts: { code: number; limitKind: ZaiLimitKind; resetAt: number | null; policy: ZaiOveragePolicy; reason: string; planLimitSignal?: ProviderPlanLimitSignal }) {
     const when = opts.resetAt ? ` · 리셋 ${new Date(opts.resetAt).toISOString()}` : '';
     super(`GLM Coding Plan 한도(code ${opts.code} · ${opts.limitKind}${when}) — 정책 llm.zaiCodingPlan.overage=${opts.policy}: ${opts.reason}`);
     this.name = 'ZaiCodingPlanLimitError';
     this.code = opts.code;
     this.limitKind = opts.limitKind;
     this.resetAt = opts.resetAt;
+    if (opts.planLimitSignal) this.planLimitSignal = opts.planLimitSignal;
   }
 }
 
@@ -575,6 +597,9 @@ export function makeZaiCodingPlanProvider(cfg: UCLLMConfig, deps: ZaiProviderDep
           const status = (error as { status?: unknown })?.status;
           const bodyText = (error as { bodyText?: unknown })?.bodyText;
           const cls = typeof status === 'number' && typeof bodyText === 'string' ? classifyZaiError(status, bodyText) : null;
+          const planLimitSignal = typeof status === 'number' && typeof bodyText === 'string'
+            ? extractZaiPlanLimitSignal(status, bodyText, settings.overage)
+            : null;
           if (!cls || cls.kind === 'rate' || cls.kind === 'other') {
             if (cls) debug.log('zai.coding-plan', 'error', { code: cls.code, kind: cls.kind, model: wireModel }, { level: 'warn' });
             throw error;
@@ -588,6 +613,7 @@ export function makeZaiCodingPlanProvider(cfg: UCLLMConfig, deps: ZaiProviderDep
           if (action === 'stop' || emitted) {
             throw new ZaiCodingPlanLimitError({
               code: cls.code, limitKind: cls.kind, resetAt: cls.resetAt, policy: settings.overage,
+              ...(planLimitSignal ? { planLimitSignal } : {}),
               reason: emitted ? '출력이 이미 나간 뒤라 폴백하지 않는다' : '리셋까지 멈춘다',
             });
           }

package/src/llm.ts

@@ -11699,92 +11699,16 @@ export function getProviderForConfig(
 import { getModelFamily } from './models/prompts.js';
 import type { ModelFamily } from './models/prompts.js';
 
-/**
- * ⛔⭐ OpenAI Chat Completions 의 «출력 상한» 칸 이름은 모델 세대로 갈린다.
- *
- * `gpt-5` 이후 계열은 `max_tokens` 를 ***거부한다*** — 400 `unsupported_parameter` 를 내고
- * *"Use 'max_completion_tokens' instead"* 라고 말한다. `gpt-4o` 계열은 반대로 옛 이름만 받는다.
- *
- * 📏 2026-08-22 실측: `provider auto` 의 티어 사다리가 `gpt-5.6-*` 로 바뀐 뒤(`#11161`)
- * 3시간 만에 이 400 이 **93건** 났고 «가속»했다(20h:2 → 21h:16 → 22h:30 → 23h:45).
- * 7일 창에서 그 이전 발생은 ***0***이다. ⇒ 칸 이름을 모델로 갈라야 한다.
- *
- * ⚠️ 값을 «안 보내는» 선택은 하지 않는다 — 상한이 사라지면 비용이 조용히 는다.
- */
-/**
- * ⛔⭐⭐ **브랜드마다 «칸 이름」이 다르다**(2026-09-12). `makeOpenAICompatProvider` 는 `grok` 과
- * `openai` 를 «한 경로»로 태우는데, 종전엔 둘 다 옛 칸(`max_tokens`·`temperature`)을 «생으로» 박았다.
- * ⇒ `openai` 브랜드의 새 세대(`gpt-5`+)는 그 둘을 «거부»한다 — 400 `unsupported_parameter`.
- *
- * 📏 실측 2026-09-12: `gpt-6-astra · maxTokens=2048 · api.openai.com/v1/chat/completions` 가 400 을 받았고,
- *   그 400 이 `review.done` 미실행 57건 중 ***30건***의 사유였다(무인 리뷰가 그만큼 «안 돌았다»).
- *
- * ⭐ 자는 «이미» 있었다 — `openAiOutputTokenField`·`openAiTemperatureField`. ***이 호출부가 안 물었을 뿐이다.***
- * 🪞 같은 파일의 `stripLocalLlmSpec` 이 「두 builder 중 하나만 정규화했다」로 난 사고의 처방이었다.
- *   ***같은 모양이 다시 났다*** — 그래서 이번에도 «순수 함수로 뽑아» 양쪽이 같은 자를 쓰게 한다.
- *
- * ⛔ grok 은 옛 칸을 그대로 받는다 — 바꾸지 않는다.
- */
-export function openAiCompatSamplingFields(
-  brand: string,
-  model: string,
-  temperature: number,
-  maxTokens: number,
-): Record<string, number> {
-  return brand === 'openai'
-    ? { ...openAiTemperatureField(model, temperature), ...openAiOutputTokenField(model, maxTokens) }
-    : { temperature, max_tokens: maxTokens };
-}
-
-export function openAiOutputTokenField(model: string, maxTokens: number): Record<string, number> {
-  return isNewGenerationOpenAiModel(model)
-    ? { max_completion_tokens: maxTokens }
-    : { max_tokens: maxTokens };
-}
-
-/** `gpt-5` 이후 계열 판정 — 옛 Chat Completions 파라미터를 거부하는 세대.
- *
- *  🩸⭐⭐ **2026-09-12 — 이 자가 «늙어서» 400 이 돌아왔다.** 종전 문면은 `/^(?:gpt-5|o[1-9])/` 라
- *  ***`gpt-6` 계열을 «못 봤다»***. 그래서 `gpt-6-astra` 가 `max_tokens` 로 나갔고 400 을 받았다:
- *    `Unsupported parameter: 'max_tokens' is not supported with this model. Use 'max_completion_tokens'`
- *  📏 실측(2026-09-12 · 12시간 창): `review.done` 200행 중 `reviewed=false` 57, 그중 ***30***이 이 400 이다.
- *    ⊕ 요청 로그가 그것을 한 줄로 말한다 — `gpt-6-astra · maxTokens=2048 · api.openai.com/v1/chat/completions`.
- *
- *  ⇒ ⭐ **세대를 「이름 목록」으로 세지 않는다.** 번호를 «범위»로 읽어 다음 세대가 와도 안 늙게 한다.
- *    `gpt-5` 이상(두 자리 포함) ⊕ `o1`~`o9`. ⛔ `gpt-4` 이하와 로컬 모델은 종전대로 옛 칸을 쓴다.
- *
- *  🌐 **외부 그라운딩**(2026-09-12 · omni-crawl `fc-dev`) — 같은 사고가 «업스트림에도» 있었다:
- *    · `quantumnous/new-api#7211` — *"GPT-6 Astra 未命中原来的 GPT-5 前缀判断"* (똑같은 접두 판정 누락)
- *    · `genkit-ai/genkit#6320`   — *"max_tokens is sent verbatim and rejected by reasoning models"*
- *    · Azure AI docs            — `gpt-6-astra`(2026-09-03) Chat Completions ⊕ Reasoning
- *    · overchat.ai              — *"Astra does not support `temperature`, `top_p`, `top_logprobs`"*
- *      ⇒ ✅ 우리가 `temperature` 를 «생략»하는 것이 외부 사실과 «맞는다».
- *      ⚠️ `top_p`·`logprobs` 는 이 경로가 «안 보낸다»(local 프리셋 경로만 보낸다) — 그래서 조치 없음.
- *
- *  ⚖️ ⛔ **알려진 트레이드오프 — new-api 는 «반대» 결론을 냈다.** 그들은
- *    *"모든 미래 GPT 메이저를 GPT-5 로 묶으면 서로 다른 모델의 파라미터 규칙이 엮인다"* 며
- *    ***미지의 미래 메이저는 추론하지 않는다***로 갔다(명시 목록 + 날짜 스냅샷).
- *    ⇒ 우리는 «반대»를 택했다. 이유: ***목록이 늙어서 이 사고가 났기 때문***이다
- *      (이 저장소에서 실제로 리뷰 미실행 30건을 냈다). 새 규칙은 «새 관례 쪽으로» 실패한다.
- *    📌 그러므로 ***`gpt-N` 중 옛 칸을 «되찾는» 모델이 나오면 이 자가 틀린다.*** 그때는
- *      여기서 갈지 말고 «모델별 능력 선언»으로 옮긴다(new-api 가 간 길). 지금은 그 표본이 0이다. */
-export function isNewGenerationOpenAiModel(model: string): boolean {
-  const match = /^gpt-(\d+)/i.exec(model);
-  if (match) return Number.parseInt(match[1]!, 10) >= 5;
-  return /^o[1-9]/i.test(model);
-}
-
-/**
- * ⛔⭐ 같은 세대가 `temperature` 도 거부한다 — 400 `unsupported_value`,
- * *"Only the default (1) value is supported"*.
- *
- * 📏 2026-08-22 실측: `max_tokens` 를 고친 «2분 뒤»(00:13:03Z)부터 이 400 이 났고
- * 90분에 **41건**이었다. ⇒ ***한 파라미터만 고치면 다음 파라미터에서 막힌다.***
- * ⚠️ 그때 나는 「수리 뒤 400 이 0건」이라 보고했는데, 그 자가 `grep max_completion_tokens`
- * 라서 «새 400»을 못 봤다 — ***좁은 자로 「나았다」를 읽었다.***
- *
- * ⇒ 값을 «1로 보내지» 않고 ***칸을 생략***한다. 서버 기본이 1이고, 보내면 또 다른 거부를 부른다.
- */
-export function openAiTemperatureField(model: string, temperature: number): Record<string, number> {
-  return isNewGenerationOpenAiModel(model) ? {} : { temperature };
-}
+// COMPAT(llm-facade-openai-sampling-fields) · 기존 llm.ts 공개 API 유지.
+import {
+  openAiCompatSamplingFields,
+  openAiOutputTokenField,
+  isNewGenerationOpenAiModel,
+  openAiTemperatureField,
+} from './llm/openai-sampling-fields.js';
+export {
+  openAiCompatSamplingFields,
+  openAiOutputTokenField,
+  isNewGenerationOpenAiModel,
+  openAiTemperatureField,
+};