elanous 0.2.14 → 0.2.16

package/src/cli/release-cli.ts

@@ -6,6 +6,7 @@
 //   elanous release verify  [--version <x.y.z>]
 //   elanous release notes   --from <ref> [--to <ref>]
 //   elanous release run     --version <x.y.z> [--cut-commit <sha>] [--dry-run] [--json] [--if-ready]
+//   elanous release auto-start [--window-minutes <n>] [--apply] [--json]
 //   elanous release cut-branch --version <x.y.z> --base <sha> --pick <sha>... [--dry-run]
 //
 // 🩸 계기(2026-09-25 v0.1.0 첫 공개): 손으로 밟은 절차에서 둘을 빠뜨릴 뻔했다 — 공개본 git 커밋(판 커밋이 공개본 커밋이 된다) ·
@@ -38,6 +39,7 @@ import { runUnattendedRelease, type UnattendedReleaseDeps } from '../../scripts/
 import { cutReleaseBranch } from '../../scripts/release-loop/cut-branch.js';
 import { releaseReadiness } from '../../scripts/release-loop/release-readiness.js';
 import { runReleaseIfReady } from './release-run-if-ready.js';
+import { autoStartScheduledRelease, type AutoStartDeferral } from '../release-loop/auto-start.js';
 import { landingFreezeMessage, LandingFrozenError, readLandingFreeze } from '../release-loop/landing-freeze.js';
 
 export const DEFAULT_PUBLIC_REPO = 'ElanvitalAI/elanous';
@@ -498,7 +500,7 @@ async function checklistOutput(v: string, codenames: Record<string, string>, mod
   console.log(`⚠ 짝 경고 ${parity.length}: ${parity.map(({ id }) => id).join(', ') || '없음'}`);
   console.log(`${v}${result.codename ? ` (${result.codename})` : ''} · 공개 ${data.released || '없음'} · 개발 ${data.dev}`);
   if (mode === 'list') {
-    for (const item of data.items) console.log(`${({ green: '🟢', yellow: '🟡', red: '🔴', done: '✅' } as const)[item.status]} ${item.id} ${item.title}${item.owner ? ` · ${item.owner}` : ''}`);
+    for (const item of data.items) console.log(`${({ green: '🟢', yellow: '🟡', red: '🔴', done: '✅' } as const)[item.status]} ${item.id} ${item.title}${item.owner ? ` · ${item.owner}` : ''}${item.ceoMinutes !== undefined ? ` · 대표 손 ${item.ceoMinutes}분${item.ceoDate ? ` (${item.ceoDate})` : ''}` : ''}`);
   } else {
     console.log(`🟢 ${summary.green} · 🟡 ${summary.yellow} · 🔴 ${summary.red} · ✅ ${summary.done}`);
     console.log(`🔴 칸: ${summary.blocked.join(', ') || '없음'}`);
@@ -629,7 +631,7 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
       if (!opts.dryRun && !mayWriteLedger('release place', false, scheduleLedgerRoot())) return;
       const priority = opts.priority ?? item.priority;
       if (!priority) throw new CliUserError(`우선순위가 없는 칸: ${id} — --priority P0|P1|P2 를 지정하라`);
-      const result = placeCell({ id, title: item.title, owner: item.owner, priority: priority as PlacementPriority, predecessors: item.predecessors ?? [], deadlineVersion: item.deadlineVersion }, { schedules: rows, dryRun: opts.dryRun, by: who ?? 'cli' });
+      const result = placeCell({ id, title: item.title, owner: item.owner, priority: priority as PlacementPriority, predecessors: item.predecessors ?? [], deadlineVersion: item.deadlineVersion, ceoMinutes: item.ceoMinutes, ceoDate: item.ceoDate, ...(item.accelerator === true ? { accelerator: true } : {}) }, { schedules: rows, dryRun: opts.dryRun, by: who ?? 'cli' });
       console.log(`${opts.dryRun ? '· 드라이런' : '✅'} ${id} ${result.from ?? '-'} → ${result.version} · ${result.reason}${result.displaced.length ? ` · P2 이월 ${result.displaced.map((row) => row.id).join(', ')}` : ''}`);
     });
   release.command('rebalance').description('마감 2시간 전 미시작 칸을 다음 판으로')
@@ -637,10 +639,15 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
     .action((opts: { version: string; dryRun?: boolean }) => {
       if (process.env.ELANOUS_TRACK !== 'OP' && !opts.dryRun) throw new CliUserError('판 이월은 COO 에 요청');
       if (!opts.dryRun && !mayWriteLedger('release rebalance', false, scheduleLedgerRoot())) return;
-      const decisions = rebalance(opts.version, { schedules: listSchedules(scheduleLedgerRoot()), dryRun: opts.dryRun });
+      const { decisions, blocked } = rebalance(opts.version, { schedules: listSchedules(scheduleLedgerRoot()), dryRun: opts.dryRun });
       for (const row of decisions) console.log(`${opts.dryRun ? '· 드라이런' : '✅'} ${row.id} ${row.from} → ${row.version} · ${row.reason}`);
-      if (!decisions.length) console.log('이월할 미시작 칸 없음');
+      for (const row of blocked) console.log(`⛔ ${row.id} ${row.from} → ${row.to} 이월 거부 · ${row.reason}`);
+      if (!decisions.length && !blocked.length) console.log('이월할 미시작 칸 없음');
     });
+  const ceoMinutes = (value: string): number => {
+    if (!/^\d+$/.test(value) || !Number.isSafeInteger(Number(value))) throw new CliUserError('대표 손 분량은 0 이상의 정수 분이어야 한다');
+    return Number(value);
+  };
   const checklist = release.command('checklist').description('판별 확인표 조회·갱신')
     .option('--version <v>', '판 또는 별칭(기본: package.json 의 개발판에서 -dev.N 제거)')
     .option('--json', '결과 JSON')
@@ -732,24 +739,28 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
     });
   withContext(checklist.command('add <id> <title>').description('칸 추가')).option('--owner <owner>', '담당').option('--kind <kind>', 'screen = 다섯 화면 짝 칸 · 근거에 짝: PWA … · 데스크톱 … · 폴드 … · 아이폰 … · 아이패드 … 한 줄')
     .option('--priority <priority>', 'P0|P1|P2').option('--deadline-version <v>', '마감 판').option('--predecessor <id...>', '선행 칸 id')
+    .option('--ceo-minutes <minutes>', '대표 손 분량(분)').option('--ceo-date <date>', '대표 손 날짜 YYYY-MM-DD (없으면 판 착지일 KST)')
+    .option('--accelerator', '가속 등급 — 다른 칸의 처리량을 올리는 칸(자율성·효율성·동시성). 생략하면 등급 없음')
     .option('--allow-duplicate-id', '다른 판에 같은 id 가 있어도 경고 후 추가')
-    .action((id: string, title: string, opts: { owner?: string; kind?: string; priority?: string; deadlineVersion?: string; predecessor?: string[]; allowDuplicateId?: boolean }, cmd: Command) => {
+    .action((id: string, title: string, opts: { owner?: string; kind?: string; priority?: string; deadlineVersion?: string; predecessor?: string[]; ceoMinutes?: string; ceoDate?: string; accelerator?: boolean; allowDuplicateId?: boolean }, cmd: Command) => {
     const { version, json } = context(cmd);
     if (!mayWrite(cmd)) return;
-    const data = addItem(version, { id, title, ...(opts.owner !== undefined ? { owner: opts.owner } : {}), ...(opts.kind !== undefined ? { kind: opts.kind as ChecklistKind } : {}), ...(opts.priority !== undefined ? { priority: opts.priority as PlacementPriority } : {}), ...(opts.deadlineVersion !== undefined ? { deadlineVersion: opts.deadlineVersion } : {}), ...(opts.predecessor !== undefined ? { predecessors: opts.predecessor } : {}) }, { allowDuplicateId: opts.allowDuplicateId });
+    const data = addItem(version, { id, title, ...(opts.owner !== undefined ? { owner: opts.owner } : {}), ...(opts.kind !== undefined ? { kind: opts.kind as ChecklistKind } : {}), ...(opts.priority !== undefined ? { priority: opts.priority as PlacementPriority } : {}), ...(opts.deadlineVersion !== undefined ? { deadlineVersion: opts.deadlineVersion } : {}), ...(opts.predecessor !== undefined ? { predecessors: opts.predecessor } : {}), ...(opts.ceoMinutes !== undefined ? { ceoMinutes: ceoMinutes(opts.ceoMinutes) } : {}), ...(opts.ceoDate !== undefined ? { ceoDate: opts.ceoDate } : {}), ...(opts.accelerator ? { accelerator: true } : {}) }, { allowDuplicateId: opts.allowDuplicateId });
     if (json) console.log(JSON.stringify(data)); else console.log(`✅ ${id} 추가`);
   });
   withContext(checklist.command('set <id>').description('칸 상태·근거·담당·처분 갱신'))
     .option('--status <status>', 'green|yellow|red|done').option('--evidence <evidence>', '근거').option('--owner <owner>', '담당')
     .option('--disposition <disposition>', 'move|known-issue|block').option('--kind <kind>', 'screen = 다섯 화면 짝 칸 · 근거에 짝: PWA … · 데스크톱 … · 폴드 … · 아이폰 … · 아이패드 … 한 줄')
     .option('--priority <priority>', 'P0|P1|P2').option('--deadline-version <v>', '마감 판').option('--predecessor <id...>', '선행 칸 id')
-    .action((id: string, opts: { status?: string; evidence?: string; owner?: string; disposition?: string; kind?: string; priority?: string; deadlineVersion?: string; predecessor?: string[] }, cmd: Command) => {
+    .option('--ceo-minutes <minutes>', '대표 손 분량(분)').option('--ceo-date <date>', '대표 손 날짜 YYYY-MM-DD')
+    .option('--accelerator', '가속 등급 부여').option('--no-accelerator', '가속 등급 해제(기본은 없음)')
+    .action((id: string, opts: { status?: string; evidence?: string; owner?: string; disposition?: string; kind?: string; priority?: string; deadlineVersion?: string; predecessor?: string[]; ceoMinutes?: string; ceoDate?: string; accelerator?: boolean }, cmd: Command) => {
       const { version, json } = context(cmd);
       if (opts.status !== undefined && !['green', 'yellow', 'red', 'done'].includes(opts.status)) throw new CliUserError(`잘못된 상태: ${opts.status}`, 'green|yellow|red|done');
       if (opts.disposition !== undefined && !['move', 'known-issue', 'block'].includes(opts.disposition)) throw new CliUserError(`잘못된 처분: ${opts.disposition}`, 'move|known-issue|block');
-      if (opts.status === undefined && opts.evidence === undefined && opts.owner === undefined && opts.disposition === undefined && opts.kind === undefined && opts.priority === undefined && opts.deadlineVersion === undefined && opts.predecessor === undefined) throw new CliUserError('갱신할 칸을 지정하라', '--status · --evidence · --owner · --disposition · --kind · --priority · --deadline-version · --predecessor 중 하나');
+      if (opts.status === undefined && opts.evidence === undefined && opts.owner === undefined && opts.disposition === undefined && opts.kind === undefined && opts.priority === undefined && opts.deadlineVersion === undefined && opts.predecessor === undefined && opts.ceoMinutes === undefined && opts.ceoDate === undefined && opts.accelerator === undefined) throw new CliUserError('갱신할 칸을 지정하라', '--status · --evidence · --owner · --disposition · --kind · --priority · --deadline-version · --predecessor · --ceo-minutes · --ceo-date · --accelerator · --no-accelerator 중 하나');
       if (!mayWrite(cmd)) return;
-      const data = setItem(version, id, { ...(opts.status !== undefined ? { status: opts.status as ChecklistStatus } : {}), ...(opts.evidence !== undefined ? { evidence: opts.evidence } : {}), ...(opts.owner !== undefined ? { owner: opts.owner } : {}), ...(opts.disposition !== undefined ? { disposition: opts.disposition as ChecklistDisposition } : {}), ...(opts.kind !== undefined ? { kind: opts.kind as ChecklistKind } : {}), ...(opts.priority !== undefined ? { priority: opts.priority as PlacementPriority } : {}), ...(opts.deadlineVersion !== undefined ? { deadlineVersion: opts.deadlineVersion } : {}), ...(opts.predecessor !== undefined ? { predecessors: opts.predecessor } : {}) }, process.env.ELANOUS_TRACK || 'cli');
+      const data = setItem(version, id, { ...(opts.status !== undefined ? { status: opts.status as ChecklistStatus } : {}), ...(opts.evidence !== undefined ? { evidence: opts.evidence } : {}), ...(opts.owner !== undefined ? { owner: opts.owner } : {}), ...(opts.disposition !== undefined ? { disposition: opts.disposition as ChecklistDisposition } : {}), ...(opts.kind !== undefined ? { kind: opts.kind as ChecklistKind } : {}), ...(opts.priority !== undefined ? { priority: opts.priority as PlacementPriority } : {}), ...(opts.deadlineVersion !== undefined ? { deadlineVersion: opts.deadlineVersion } : {}), ...(opts.predecessor !== undefined ? { predecessors: opts.predecessor } : {}), ...(opts.ceoMinutes !== undefined ? { ceoMinutes: ceoMinutes(opts.ceoMinutes) } : {}), ...(opts.ceoDate !== undefined ? { ceoDate: opts.ceoDate } : {}), ...(opts.accelerator !== undefined ? { accelerator: opts.accelerator ? true : null } : {}) }, process.env.ELANOUS_TRACK || 'cli');
       const item = data.items.find((entry) => entry.id === id);
       const why = item?.kind === 'screen' && item.status === 'green' ? parityGap(item.evidence) : null;
       if (why) {
@@ -888,24 +899,17 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
       console.log(renderReleaseNotes(draftReleaseNotes(readLandedCommits(o.from, o.to), o.from, o.to)));
     });
   release.command('cut-branch')
-    .description('원래 컷에 main 의 수리 커밋만 얹은 release/<v> 가지를 만들고 push')
+    .description('원래 컷에 main 의 수리 커밋만 얹은 release/<v> 가지를 만들고 push. --append 는 이미 있는 가지에 fast-forward 로만 더 얹는다')
     .requiredOption('--version <v>', '릴리스 판(x.y.z)')
     .requiredOption('--base <sha>', '원래 컷 SHA')
     .requiredOption('--pick <sha...>', '차례로 얹을 main 커밋 SHA')
+    .option('--append', '이미 있는 release/<v> 를 출발점으로 fast-forward push(강제 push 없음)')
     .option('--dry-run', '가지·worktree·push 없이 계획만 출력')
     .option('--json', '결과 한 줄 JSON(stdout)')
-    .action(async (o: { version: string; base: string; pick: string[]; dryRun?: boolean; json?: boolean }) => {
+    .action(async (o: { version: string; base: string; pick: string[]; append?: boolean; dryRun?: boolean; json?: boolean }) => {
       await jsonAction(o.json, async (log) => cutReleaseBranch({ ...o, log }), () => true);
     });
-  release.command('run')
-    .description('릴리스 루프 실행 — 원장 직전 판과 release.loop 설정으로 그래프 입력 구성 · --dry-run 은 입력만 출력')
-    .requiredOption('--version <v>', '공개할 판(x.y.z)')
-    .option('--cut-commit <sha>', 'origin/main HEAD 대신 컷으로 쓸 커밋')
-    .option('--dry-run', '체크리스트·그래프 실행 없이 전체 입력 보기')
-    .option('--if-ready', '준비되지 않았으면 사유를 출력하고 성공으로 건너뛴다')
-    .option('--force-freeze', '동결 중 게이트·발행 강행(관측 기록)')
-    .option('--json', '결과 한 줄 JSON(stdout) · 사람 줄은 stderr')
-    .action(async (o: { version: string; cutCommit?: string; dryRun?: boolean; ifReady?: boolean; forceFreeze?: boolean; json?: boolean }) => {
+  const runAction = async (o: { version: string; cutCommit?: string; dryRun?: boolean; ifReady?: boolean; forceFreeze?: boolean; json?: boolean }, logRun = console.log): Promise<boolean | AutoStartDeferral | undefined> => {
       if (!o.dryRun) {
         try {
           const frozen = readLandingFreeze(releaseRunDeps.freezeRoot);
@@ -915,20 +919,20 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
               // `--if-ready` (the scheduled path) defers quietly; a direct run fails — the release run is run again after `freeze off`.
               if (o.ifReady) {
                 if (o.json) await writeStdoutJson(`${JSON.stringify({ ok: true, skipped: true, reason: 'frozen', detail: landingFreezeMessage(frozen) })}\n`);
-                else console.log(`· ${landingFreezeMessage(frozen)} · 릴리스 루프 연기`);
+                else logRun(`· ${landingFreezeMessage(frozen)} · 릴리스 루프 연기`);
               } else {
                 if (o.json) await writeStdoutJson(`${JSON.stringify({ ok: false, reason: 'frozen', error: landingFreezeMessage(frozen) })}\n`);
                 else console.error(`⛔ ${landingFreezeMessage(frozen)} · 릴리스 루프 거부(--force-freeze 로만 강행)`);
                 process.exitCode = 1;
               }
-              return;
+              return o.ifReady ? { deferred: true, reason: 'frozen' } : false;
             }
           }
         } catch (e) {
           if (o.json) await writeStdoutJson(`${JSON.stringify({ ok: false, error: (e as Error).message })}\n`);
           else console.error(`⛔ ${(e as Error).message}`);
           process.exitCode = 1;
-          return;
+          return false;
         }
       }
       if (o.ifReady && !o.dryRun) {
@@ -940,32 +944,65 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
           });
           if (outcome.skipped) {
             if (o.json) await writeStdoutJson(`${JSON.stringify(outcome)}\n`);
-            else console.log(`· 준비 안 됨 ${o.version} · ${outcome.reason} · ${outcome.detail}`);
-            return;
+            else logRun(`· 준비 안 됨 ${o.version} · ${outcome.reason} · ${outcome.detail}`);
+            return { deferred: true, reason: outcome.reason };
           }
           const result = outcome.result;
           const ok = result.dryRun || result.state?.status === 'done' || result.state?.status === 'awaiting-approval';
-          (o.json ? console.error : console.log)(`${result.dryRun ? '· 드라이런' : '▶ 릴리스 루프'} ${result.input.version} · 입력 ${JSON.stringify(result.input)}`);
+          (o.json ? console.error : logRun)(`${result.dryRun ? '· 드라이런' : '▶ 릴리스 루프'} ${result.input.version} · 입력 ${JSON.stringify(result.input)}`);
           if (o.json) await writeStdoutJson(`${JSON.stringify({ ok, ...result })}\n`);
           if (!ok && !process.exitCode) process.exitCode = 1;
+          return ok;
         } catch (e) {
           if (e instanceof LandingFrozenError) {
             // A freeze switched on after the entry check still defers the scheduled run rather than failing it.
             debug.log('release.run', 'frozen', { version: o.version, reason: e.freeze.reason, until: e.freeze.until, at: 'run-boundary' });
             if (o.json) await writeStdoutJson(`${JSON.stringify({ ok: true, skipped: true, reason: 'frozen', detail: e.message })}\n`);
-            else console.log(`· ${e.message} · 릴리스 루프 연기`);
-            return;
+            else logRun(`· ${e.message} · 릴리스 루프 연기`);
+            return { deferred: true, reason: 'frozen' };
           }
           if (o.json) await writeStdoutJson(`${JSON.stringify({ ok: false, error: (e as Error).message })}\n`);
           else console.error(`⛔ ${(e as Error).message}`);
           process.exitCode = 1;
+          return false;
         }
-        return;
       }
       await jsonAction(o.json, async (log) => {
         const result = await runUnattendedRelease({ version: o.version, dryRun: o.dryRun, cutCommit: o.cutCommit, forceFreeze: o.forceFreeze }, releaseRunDeps);
         log(`${result.dryRun ? '· 드라이런' : '▶ 릴리스 루프'} ${result.input.version} · 입력 ${JSON.stringify(result.input)}`);
         return result;
       }, (r) => r.dryRun || r.state?.status === 'done' || r.state?.status === 'awaiting-approval');
+  };
+  release.command('run')
+    .description('릴리스 루프 실행 — 원장 직전 판과 release.loop 설정으로 그래프 입력 구성 · --dry-run 은 입력만 출력')
+    .requiredOption('--version <v>', '공개할 판(x.y.z)')
+    .option('--cut-commit <sha>', 'origin/main HEAD 대신 컷으로 쓸 커밋')
+    .option('--dry-run', '체크리스트·그래프 실행 없이 전체 입력 보기')
+    .option('--if-ready', '준비되지 않았으면 사유를 출력하고 성공으로 건너뛴다')
+    .option('--force-freeze', '동결 중 게이트·발행 강행(관측 기록)')
+    .option('--json', '결과 한 줄 JSON(stdout) · 사람 줄은 stderr')
+    .action(async (o: { version: string; cutCommit?: string; dryRun?: boolean; ifReady?: boolean; forceFreeze?: boolean; json?: boolean }) => { await runAction(o); });
+  release.command('auto-start')
+    .description('판 일정의 컷 창에서 릴리스 시작을 미리 본다 · --apply 로 release run --if-ready 실행')
+    .option('--window-minutes <n>', '컷 뒤 선택 창(분)', '15')
+    .option('--apply', '선택한 판을 release run --if-ready 로 시작')
+    .option('--json', '결과 한 줄 JSON(stdout)')
+    .action(async (o: { windowMinutes: string; apply?: boolean; json?: boolean }) => {
+      await jsonAction(o.json, async (log) => {
+        const result = await autoStartScheduledRelease({
+          windowMinutes: Number(o.windowMinutes), apply: o.apply, ledgerRoot: scheduleLedgerRoot(),
+          readiness: (version, ledgerRoot, now) => releaseReadiness(version, { ledgerRoot, now: () => now, checklist: releaseRunDeps.checklist }),
+          launch: async (version) => {
+            const ran = await runAction({ version, ifReady: true, json: false }, log);
+            if (ran && typeof ran === 'object' && ran.deferred) return ran;
+            if (ran !== true) throw new Error(`release run 미시작 또는 실패: ${version}`);
+          },
+        });
+        if (result.status === 'planned') log(`· 미리 보기 ${result.version} · 컷 ${result.cutAt} · 실행하려면 --apply`);
+        else if (result.status === 'started') log(`▶ 릴리스 시작 ${result.version} · 컷 ${result.cutAt}`);
+        else if (result.status === 'skipped') log(`· 릴리스 연기 ${result.version} · ${result.reason}`);
+        else log('· 선택할 컷 없음');
+        return result;
+      }, () => true);
     });
 }

package/src/cli/seat-requests-cli.ts

@@ -0,0 +1,52 @@
+import type { Command } from 'commander';
+import { effectiveInstanceRoot } from '../instance/resolve.js';
+import { hqCliWriteAllowed, type HqDeps } from '../hq/hq.js';
+import { isIsolatedLedgerWriteRoot } from '../hq/ledger-write-target.js';
+import { closeSeatRequests, listSeatRequests, type SeatRequestStatus } from '../seat-dispatch/seat-request-ledger.js';
+
+function duration(value: string): number {
+  const match = /^(\d+)(ms|s|m|h|d)$/.exec(value);
+  if (!match) throw new Error(`invalid --older-than: ${value} (use e.g. 24h)`);
+  const ms = Number(match[1]) * ({ ms: 1, s: 1_000, m: 60_000, h: 3_600_000, d: 86_400_000 }[match[2]! as 'ms' | 's' | 'm' | 'h' | 'd']);
+  if (!Number.isSafeInteger(ms)) throw new Error(`invalid --older-than: ${value}`);
+  return ms;
+}
+
+export function registerSeatRequestsCommands(seat: Command, deps: { root?: () => string; hq?: HqDeps; now?: () => Date } = {}): void {
+  const requests = seat.command('requests').description('자리 요청 원장 조회·닫기');
+  requests.command('list').description('키별 최신 요청 상태 조회')
+    .option('--seat <seat>', '자리 ID')
+    .option('--status <status>', 'pending|queued|rejected|done')
+    .option('--json', 'JSON 출력')
+    .action((opts: { seat?: string; status?: string; json?: boolean }) => {
+      try {
+        if (opts.status && !['pending', 'queued', 'rejected', 'done'].includes(opts.status)) throw new Error(`invalid status: ${opts.status}`);
+        const rows = listSeatRequests((deps.root ?? effectiveInstanceRoot)(), { seat: opts.seat, status: opts.status as SeatRequestStatus | undefined });
+        if (opts.json) console.log(JSON.stringify(rows));
+        else for (const row of rows) console.log(`${row.key} ${row.seat} ${row.status} ${row.queuedAt} ${row.text}`);
+      } catch (error) { console.error(`seat requests list: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
+    });
+  requests.command('close <keys...>').description('열린 요청을 사유와 함께 종료 (원장에 덧붙임)')
+    .requiredOption('--reason <reason>', '닫는 이유')
+    .option('--status <status>', 'rejected|done', 'rejected')
+    .option('--older-than <duration>', '최소 대기 시간 (예: 24h)')
+    .option('--dry-run', '쓰기 없이 대상만 미리 보기')
+    .action((keys: string[], opts: { reason: string; status: string; olderThan?: string; dryRun?: boolean }) => {
+      try {
+        if (!opts.reason.trim()) throw new Error('reason must not be empty');
+        if (opts.status !== 'rejected' && opts.status !== 'done') throw new Error(`invalid close status: ${opts.status}`);
+        const olderThan = opts.olderThan === undefined ? undefined : duration(opts.olderThan);
+        const root = (deps.root ?? effectiveInstanceRoot)();
+        const known = new Set(listSeatRequests(root).map((row) => row.key));
+        const missing = keys.find((key) => !known.has(key));
+        if (missing) throw new Error(`unknown key: ${missing}`);
+        if (!opts.dryRun && !isIsolatedLedgerWriteRoot(root) && !hqCliWriteAllowed('seat requests close', false, deps.hq)) return;
+        const rows = closeSeatRequests(root, keys, {
+          reason: opts.reason, status: opts.status,
+          ...(olderThan === undefined ? {} : { olderThan }),
+          ...(deps.now ? { now: deps.now() } : {}), dryRun: opts.dryRun,
+        });
+        for (const row of rows) console.log(`${opts.dryRun ? 'would close' : 'closed'} ${row.key} ${row.status}: ${row.reason}`);
+      } catch (error) { console.error(`seat requests close: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
+    });
+}

package/src/cli/self-update.ts

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync, realpathSync, readlinkSync, readdirSync, statSync, rmSync, symlinkSync, renameSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, realpathSync, readlinkSync, readdirSync, statSync, rmSync, symlinkSync, renameSync, writeFileSync, lstatSync } from 'node:fs';
 import { resolve, join, basename, dirname } from 'node:path';
 import { homedir, platform, userInfo } from 'node:os';
 import { spawnSync } from 'node:child_process';
@@ -18,6 +18,10 @@ export interface SelfUpdateOptions {
   skipPwaBuild?: boolean;
   /** 설치된 릴리스에서만 사용한다. 체크아웃 갱신에는 적용하지 않는다. */
   version?: string;
+  /** 판 사이 dev 빌드 설치 — versions/<판>-dev.<sha12> · install.json channel:'dev'. 사람 승인 명령. */
+  dev?: boolean;
+  /** install.json 의 이전 versionDir 로 current 를 되돌린다. 이전이 없으면 거부. */
+  rollback?: boolean;
 }
 
 export interface SelfUpdateDeps {
@@ -45,6 +49,15 @@ export interface SelfUpdateDeps {
   out?: { log: (s: string) => void; error: (s: string) => void };
   /** 판올림 성공 알림(주입 안 하면 sendOutbound 'report' · 시험에선 안 보냄). */
   notice?: (text: string) => void;
+  /**
+   * 설치 루트(versions · current · install.json). 주입하지 않으면 ~/.local/share/elanous.
+   * 시험은 임시 루트만 넘긴다 — 실물 심링크·재시작을 만지지 않는다.
+   */
+  installRoot?: string;
+  /** 패키지 버전(package.json). 주입하지 않으면 체크아웃 package.json. */
+  packageVersion?: (checkout: string) => string;
+  /** 재시작을 실제로 호출해도 되는지. NODE_ENV=test · ELANOUS_TEST_HOME 이면 기본 false. */
+  allowLiveRestart?: boolean;
 }
 
 export interface SelfUpdateResult {
@@ -63,6 +76,12 @@ export interface SelfUpdateResult {
   prune?: VersionPruneOutcome;
   /** 재시작 뒤 건강 — ok · rolled-back(직전 판으로 되돌려 회복) · rollback-failed · no-rollback-target. */
   health?: 'ok' | 'rolled-back' | 'rollback-failed' | 'no-rollback-target' | 'unmeasured';
+  /** --dev 설치 또는 --rollback 이 옮긴 current 대상(versions/<name>). */
+  current?: string;
+  /** install.json channel. dev 설치면 'dev'. */
+  channel?: string;
+  /** --dev 가 남긴 이전 versionDir. */
+  previous?: string;
   rolledBackTo?: string;
   /** relay(`com.elanous.openai-relay`) 판정 — 넥서스와 «따로» 본다(T5 · 2026-09-24). */
   relay?: RelayUpdateOutcome;
@@ -182,6 +201,142 @@ export function rollbackTarget(versions: readonly string[], daemonSha: string, i
 
 const VERSIONS_DIR = () => join(homedir(), '.local/share/elanous/versions');
 
+/** 시험·ELANOUS_TEST_HOME 에서는 실물 재시작을 호출하지 않는다. */
+export function liveRestartBlocked(env: NodeJS.ProcessEnv = process.env): boolean {
+  return env.NODE_ENV === 'test' || Boolean(env.ELANOUS_TEST_HOME?.trim());
+}
+
+export interface InstallRecord {
+  version?: string;
+  versionDir?: string;
+  source?: string;
+  installedAt?: string;
+  commit?: string;
+  channel?: string;
+  previous?: string;
+}
+
+export function defaultInstallRoot(): string {
+  return join(homedir(), '.local/share/elanous');
+}
+
+export function readInstallRecord(root: string): InstallRecord | null {
+  try {
+    const parsed: unknown = JSON.parse(readFileSync(join(root, 'install.json'), 'utf8'));
+    if (typeof parsed !== 'object' || parsed === null) return null;
+    return parsed as InstallRecord;
+  } catch {
+    return null;
+  }
+}
+
+/** install.json 의 version·commit. 못 읽으면 둘 다 «unknown». */
+export function readInstalledIdentity(root: string = defaultInstallRoot()): { installedVersion: string; installedCommit: string } {
+  const record = readInstallRecord(root);
+  const version = typeof record?.version === 'string' && record.version.trim() ? record.version.trim() : '';
+  const commit = typeof record?.commit === 'string' && record.commit.trim() ? record.commit.trim() : '';
+  return { installedVersion: version || 'unknown', installedCommit: commit || 'unknown' };
+}
+
+const VERSION_DIR_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+
+function versionDirName(versionDir: string | undefined): string | null {
+  if (typeof versionDir !== 'string') return null;
+  if (!/^versions\/[A-Za-z0-9][A-Za-z0-9._-]*$/.test(versionDir) || versionDir.includes('..')) return null;
+  return basename(versionDir);
+}
+
+/** 판 디렉터리에 실행 진입 파일이 있나(설치기가 실제로 내용을 깔았나). */
+export function installEntryExists(root: string, versionName: string): boolean {
+  return existsSync(join(root, 'versions', versionName, 'node_modules', 'elanous', 'bin', 'elanous.mjs'));
+}
+
+/** 판 이름 «<판>-<커밋12>» · «<판>-dev.<커밋12>» 에서 판·커밋을 읽는다(되돌림 메타 일치용). */
+export function parseVersionDirName(name: string): { version: string; commit: string } | null {
+  const m = /^(.+?)-(?:dev\.)?([0-9a-f]{12})(?:-dirty)?$/.exec(name);
+  return m ? { version: m[1]!, commit: m[2]! } : null;
+}
+
+/** current 심링크를 versions/<name> 으로 원자적으로 옮긴다. 대상 폴더가 없으면 거부. */
+export function relinkInstallCurrent(root: string, versionName: string): void {
+  if (!VERSION_DIR_NAME.test(versionName) || versionName.includes('..')) throw new Error(`잘못된 판 이름: ${versionName}`);
+  if (!existsSync(join(root, 'versions', versionName))) throw new Error(`판 디렉터리 없음: ${versionName}`);
+  // EDGE-RAIL-VERIFY(10-06 05:30 사고): 진입 파일이 없는 판으로는 current 를 옮기지 않는다(빈 판 → 전역 elanous·크론 전부 실패).
+  if (!installEntryExists(root, versionName)) throw new Error(`빈 판(진입 파일 없음): ${versionName} — current 를 옮기지 않는다`);
+  const tmp = join(root, `.current-dev-${process.pid}`);
+  rmSync(tmp, { force: true });
+  symlinkSync(`versions/${versionName}`, tmp);
+  renameSync(tmp, join(root, 'current'));
+}
+
+function checkoutPackageVersion(checkout: string): string {
+  const parsed = JSON.parse(readFileSync(join(checkout, 'package.json'), 'utf8')) as { version?: unknown };
+  if (typeof parsed.version !== 'string' || !parsed.version.trim()) throw new Error('package.json version 없음');
+  return parsed.version.trim();
+}
+
+/**
+ * 판 사이 dev 빌드 — versions/<판>-dev.<sha12> 를 만들고 current 를 옮긴다.
+ * install.json 에 channel:'dev' 와 이전 versionDir(previous) 를 남긴다. 실제 설치기·재시작은 부르지 않는다.
+ */
+export function installDevBuild(checkout: string, commit: string, deps: Pick<SelfUpdateDeps, 'installRoot' | 'packageVersion'> & { runInstaller?: () => { status: number | null; stderr: string } } = {}): { versionName: string; versionDir: string; previous: string; record: InstallRecord } {
+  const sha12 = commit.trim().toLowerCase().slice(0, 12);
+  if (!/^[0-9a-f]{12}$/.test(sha12)) throw new Error(`dev 설치 커밋이 12자가 아님: ${commit}`);
+  const root = deps.installRoot ?? defaultInstallRoot();
+  const prior = readInstallRecord(root);
+  const previous = versionDirName(prior?.versionDir) ? prior!.versionDir! : (typeof prior?.previous === 'string' ? prior.previous : '');
+  // EDGE-RAIL-VERIFY: 빈 디렉터리를 만들고 current 만 옮기던 길(10-06 05:30 사고)을 버리고, 정식 길과 같은 설치기로 내용을 깐다.
+  if (!deps.runInstaller) throw new Error('dev 설치기 없음 — 빈 판을 깔지 않는다');
+  // install.sh 는 current 를 «먼저» 옮기고 뒤에서 실패할 수 있다 — 실패·빈 판 어느 쪽이든 이전 판·install.json 으로 되돌린다.
+  const restore = (why: string, versionName: string | null): never => {
+    const previousName = versionDirName(previous);
+    if (previousName && installEntryExists(root, previousName)) relinkInstallCurrent(root, previousName);
+    if (prior) writeFileSync(join(root, 'install.json'), `${JSON.stringify(prior, null, 2)}\n`);
+    try { debug.log('self-update', 'dev-install-refused', { why, versionName, kept: previousName ?? null }); } catch { /* 관측 실패가 막지 않는다 */ }
+    throw new Error(`${why}: ${versionName ?? '?'} — current 를 이전 판(${previousName ?? '없음'})으로 유지`);
+  };
+  let result: { status: number | null; stderr: string };
+  try { result = deps.runInstaller(); }
+  catch (error) { return restore(`설치기 예외(${String(error).slice(0, 200)})`, null); }
+  const after = readInstallRecord(root);
+  const versionName = versionDirName(after?.versionDir);
+  if (result.status !== 0) return restore(`설치기 실패(rc=${result.status}: ${result.stderr.slice(0, 200)})`, versionName);
+  if (!versionName || !installEntryExists(root, versionName)) return restore('빈 판(진입 파일 없음)', versionName);
+  const versionDir = `versions/${versionName}`;
+  const record: InstallRecord = {
+    ...(after ?? {}),
+    versionDir,
+    channel: 'dev',
+    ...(previous && previous !== versionDir ? { previous } : {}),
+  };
+  writeFileSync(join(root, 'install.json'), `${JSON.stringify(record, null, 2)}\n`);
+  return { versionName, versionDir, previous, record };
+}
+
+/** install.json.previous 의 판으로 current 를 되돌린다. previous 가 없으면 거부(exit 2). */
+export function rollbackDevInstall(deps: Pick<SelfUpdateDeps, 'installRoot'> = {}): { ok: true; versionName: string; record: InstallRecord } | { ok: false; reason: string } {
+  const root = deps.installRoot ?? defaultInstallRoot();
+  const prior = readInstallRecord(root);
+  const previousName = versionDirName(prior?.previous);
+  if (!prior || !previousName) return { ok: false, reason: '이전 판(install.json previous)이 없다 — rollback 거부' };
+  if (!existsSync(join(root, 'versions', previousName))) return { ok: false, reason: `이전 판 디렉터리 없음: ${previousName}` };
+  const currentName = versionDirName(prior.versionDir);
+  relinkInstallCurrent(root, previousName);
+  const parsed = parseVersionDirName(previousName);
+  const record: InstallRecord = {
+    ...prior,
+    ...(parsed ? { version: parsed.version, commit: parsed.commit } : {}),
+    versionDir: `versions/${previousName}`,
+    channel: prior.channel === 'dev' ? undefined : prior.channel,
+    previous: currentName ? `versions/${currentName}` : undefined,
+    installedAt: new Date().toISOString(),
+  };
+  if (!record.channel) delete record.channel;
+  if (!record.previous) delete record.previous;
+  writeFileSync(join(root, 'install.json'), `${JSON.stringify(record, null, 2)}\n`);
+  return { ok: true, versionName: previousName, record };
+}
+
 /** `unmeasured` = 건강을 «잴 수» 없었다(REST 주소를 한 번도 못 얻음) — 「건강하지 않다」와 다르다. 되돌리지 않는다. */
 export interface VerifyRestartResult { ok: boolean; daemonSha?: string; reason?: string; unmeasured?: boolean }
 
@@ -399,9 +554,14 @@ export async function runReleaseUpdate(options: ReleaseUpdateOptions = {}, deps:
   }
   let previous = '';
   let previousBuild = '';
+  let replacedDev: { from: string; to: string } | null = null;
   try {
     const metadata: unknown = JSON.parse(readFileSync(join(prefix, 'install.json'), 'utf8'));
     previousBuild = installedBuild(metadata);
+    if (typeof metadata === 'object' && metadata !== null && (metadata as { channel?: unknown }).channel === 'dev') {
+      const fromDir = typeof (metadata as { versionDir?: unknown }).versionDir === 'string' ? (metadata as { versionDir: string }).versionDir : '';
+      replacedDev = { from: fromDir, to: '' };
+    }
     if (typeof metadata === 'object' && metadata !== null && 'versionDir' in metadata && typeof metadata.versionDir === 'string') {
       const dir = metadata.versionDir;
       if (/^versions\/[a-zA-Z0-9._-]+$/.test(dir) && !dir.includes('..')) previous = basename(dir);
@@ -418,6 +578,12 @@ export async function runReleaseUpdate(options: ReleaseUpdateOptions = {}, deps:
     const installedVersion = typeof metadata === 'object' && metadata !== null && 'version' in metadata && typeof metadata.version === 'string'
       ? metadata.version : null;
     if (!installedVersion) return fail(1, '설치판 확인 실패: install.json version 없음');
+    if (replacedDev) {
+      const toDir = typeof metadata === 'object' && metadata !== null && typeof (metadata as { versionDir?: unknown }).versionDir === 'string'
+        ? (metadata as { versionDir: string }).versionDir : installedVersion;
+      replacedDev = { from: replacedDev.from, to: toDir };
+      try { debug.log('self-update', 'dev-replaced', replacedDev); } catch { /* 관측 실패가 갱신을 막지 않는다 */ }
+    }
     const internalRevision = isTailnet(source) && version?.match(/^(.*)-([0-9a-f]{12})$/);
     if (version && installedVersion !== version && (!internalRevision || installedVersion !== internalRevision[1])) {
       return fail(1, `설치판 버전 불일치: 요청 ${version}, 설치 ${installedVersion}`);
@@ -491,6 +657,9 @@ export async function runUpdateForInstallation(
     out.log(options.json ? JSON.stringify(result) : `self-update: ${result.reason}`);
     return result;
   }
+  if (options.dev || options.rollback) {
+    return runSelfUpdate(options, { cliRoot, ...deps.checkout });
+  }
   if (options.version !== undefined) {
     const result: SelfUpdateResult = { exitCode: 2, installedVersion: null, decision: null, restarted: false, reason: '--version 은 릴리스 설치본에서만 사용 가능' };
     const out = deps.checkout?.out ?? console;
@@ -537,6 +706,15 @@ export async function runSelfUpdate(options: SelfUpdateOptions = {}, deps: SelfU
     return result;
   };
   const reject = (reason: string): SelfUpdateResult => emit({ exitCode: 2, installedVersion: null, decision: null, restarted: false, reason });
+  if (options.rollback) {
+    const rolled = rollbackDevInstall(deps);
+    if (!rolled.ok) return reject(rolled.reason);
+    return emit({
+      exitCode: 0, installedVersion: rolled.versionName, decision: null, restarted: false,
+      current: `versions/${rolled.versionName}`, previous: rolled.record.previous, channel: rolled.record.channel,
+      reason: `rollback: current → ${rolled.versionName}`,
+    });
+  }
   try {
     if (!existsSync(join(checkout, 'scripts/install.sh'))) return reject(`체크아웃 없음 또는 설치기 없음: ${checkout}`);
     const root = git(checkout, ['rev-parse', '--show-toplevel']);
@@ -546,6 +724,24 @@ export async function runSelfUpdate(options: SelfUpdateOptions = {}, deps: SelfU
     const dirty = git(checkout, ['diff', '--quiet', 'HEAD', '--']);
     if (dirty.status !== 0) return reject(dirty.status === 1 ? '추적 파일 변경: 체크아웃이 더러움' : `git diff 실패: ${dirty.stderr}`);
 
+    if (options.dev) {
+      try {
+        const installed = installDevBuild(checkout, head.stdout.trim(), { ...deps, runInstaller: () => run('bash', [join(checkout, 'scripts/install.sh'), '--no-modify-path'], checkout) });
+        return emit({
+          exitCode: 0,
+          installedVersion: installed.versionName,
+          decision: null,
+          restarted: false,
+          current: installed.versionDir,
+          channel: 'dev',
+          previous: installed.previous || undefined,
+          reason: `dev 설치: current → ${installed.versionName}`,
+        });
+      } catch (error) {
+        return emit({ exitCode: 1, installedVersion: null, decision: null, restarted: false, reason: `dev 설치 실패: ${error instanceof Error ? error.message : String(error)}` });
+      }
+    }
+
     const silence = { log: (_s: string) => {}, error: (_s: string) => {} };
     let decision: RestartNeededResult;
     try {
@@ -628,6 +824,9 @@ export async function runSelfUpdate(options: SelfUpdateOptions = {}, deps: SelfU
     const os = deps.os ?? platform();
     const command = os === 'darwin' ? 'launchctl' : os === 'linux' ? 'systemctl' : null;
     if (!command) return emit({ exitCode: 1, installedVersion, decision, restarted: false, prune, reason: `지원하지 않는 플랫폼: ${os}` });
+    if (deps.allowLiveRestart === false || (deps.allowLiveRestart !== true && liveRestartBlocked())) {
+      return emit({ exitCode: 0, installedVersion, decision, restarted: false, prune, reason: '테스트 가드: 실물 재시작 0' });
+    }
     const args = os === 'darwin' ? ['kickstart', '-k', `gui/${deps.uid ?? process.getuid?.() ?? userInfo().uid}/com.elanous.nexus`] : ['--user', 'restart', 'elanous-nexus'];
     try {
       const restarted = run(command, args, checkout);

package/src/cli/usage-cli.ts

@@ -10,6 +10,7 @@ import type { Command } from 'commander';
 import { collectUnifiedUsage, formatUnifiedUsage } from '../budget/unified-usage.js';
 import { consumeCodexResetCredits, listCodexResetCredits } from '../budget/codex-reset-credits.js';
 import { rollupRunUsage, type RunUsageInput } from '../budget/run-usage-rollup.js';
+import { formatUsageOutcomes, outcomeTableHasCodexGrokUnknown, queryUsageOutcomes, type UsageOutcomesDeps, type UsageOutcomesReport } from '../budget/usage-outcomes.js';
 import { LogStore, logsDbPath, type LogQuery, type LogStoreRow } from '../mss/logging/log-store.js';
 import { LOGS_SINCE_OPTION, parseSince } from './logs-cli.js';
 import { formatCodexCreditPlan, type CodexCreditPlan } from '../budget/codex-credit-plan.js';
@@ -28,6 +29,9 @@ export interface UsageCliDeps {
   /** 계정 이름 → CODEX_HOME. ⛔ 여기 없는 이름은 «거부»한다(모르는 곳에 쓰지 않는다). */
   readonly homes?: Readonly<Record<string, string>>;
   readonly exit?: (code: number) => never;
+  /** 런 원장 결과 표. 시험은 디렉터리를 주입한다. */
+  readonly outcomes?: (sinceDays: number) => UsageOutcomesReport;
+  readonly outcomeDeps?: UsageOutcomesDeps;
 }
 
 /** 계정 이름 → CODEX_HOME 기본 표.
@@ -134,6 +138,28 @@ export function registerUsageCommand(program: Command, deps: UsageCliDeps = {}):
   //   🩸 그래서 ⑴ `--yes` 없이는 «안 쓴다» ⑵ 쓰기 «전»에 남은 수를 보여 준다
   //      ⑶ 쓴 «뒤»에도 다시 조회해 「줄었나」를 값으로 낸다.
   //   📏 2026-09-24 현황 예: default 100%·team 100%·third 46% ⇒ third 에 쓰면 54% 가 버려진다.
+  const outcomes = deps.outcomes ?? ((sinceDays: number) => queryUsageOutcomes(sinceDays, deps.outcomeDeps));
+  usage
+    .command('outcomes')
+    .description('프로바이더별 무인 착지율 · 라운드 수 · 막힘 사유 분포 (런 원장 childProvider · 미기록은 불명)')
+    .option('--days <n>', '최근 N일', '2')
+    .option('--json', 'JSON 출력')
+    .action((opts: { days?: string; json?: boolean }, command: Command) => {
+      const json = opts.json || command.optsWithGlobals<{ json?: boolean }>().json;
+      const days = Number(opts.days);
+      if (!Number.isFinite(days) || days <= 0) {
+        out.log(`⛔ --days 는 양의 수: '${opts.days}'`);
+        exit(2);
+        return;
+      }
+      const report = outcomes(days);
+      if (json) {
+        out.log(JSON.stringify({ ...report, hasCodexGrokUnknown: outcomeTableHasCodexGrokUnknown(report) }, null, 2));
+        return;
+      }
+      out.log(formatUsageOutcomes(report));
+    });
+
   const list = deps.list ?? listCodexResetCredits;
   const consume = deps.consume ?? consumeCodexResetCredits;
   const homes = deps.homes ?? defaultHomes();