elanous 0.2.28 → 0.2.31

package/src/cli/release-cli.ts

@@ -8,7 +8,7 @@
 //   elanous release run     --version <x.y.z> [--prerelease rc] [--main-cut | --cut-commit <sha>] [--publish-at <iso>] [--gate-executor <pod|host> [--gate-host <ssh-host>]] [--dry-run] [--json] [--if-ready]
 //   elanous release resume  --run <runId> --from <node> [--waive <node> --reason <text>] [--accepted-regressions <json>] [--gate-executor <pod|host> [--gate-host <ssh-host>]] [--json]
 //   elanous release auto-start [--window-minutes <n>] [--apply] [--json]
-//   elanous release rehearsal tick [--apply] [--checkout <dir>] [--json]
+//   elanous release rehearsal tick [--apply] [--checkout <dir>] [--shards <n>] [--remote <host>] [--json]
 //   elanous release preflight --version <x.y.z> [--publish-at <iso>] [--json]   (컷 30분 전 사전 점검 · 읽기 전용 · ⛔ 있으면 exit 1)
 //   elanous release cut-branch --version <x.y.z> --base <sha> --pick <sha>... [--dry-run]
 //
@@ -21,7 +21,7 @@ import { spawnSync } from 'node:child_process';
 import { createHash } from 'node:crypto';
 import { chmodSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, symlinkSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
-import { dirname, join, resolve } from 'node:path';
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
 import type { Command } from 'commander';
 import { debug } from '../debug/log.js';
 import { effectiveInstanceRoot, releaseLedgerRoot } from '../instance/resolve.js';
@@ -32,7 +32,8 @@ import { addItem, cellsReferencingDoc, claimItem, decodeClaimHistoryEntry, devVe
 import * as features from '../release-loop/feature-store.js';
 import { evidencePlan, landedButYellow, type MergedChecklistPr } from '../release-loop/landed-but-yellow.js';
 import { formatSchedule, getSchedule, listSchedules, setSchedule } from '../release-loop/release-schedule.js';
-import { placeCell, rebalance, seatMove, type PlacementPriority } from '../release-loop/placement.js';
+import { mergedPrsLast24h, placeCell, planPullForward, pullForwardPlacementConfig, rebalance, seatMove, type PlacementPriority } from '../release-loop/placement.js';
+import { readTrafficSignal } from '../seat-loop/traffic-signal.js';
 import { parseRubric, readRubricItems, rubricGrade, rubricScore } from '../release-loop/rubric.js';
 import { writeStdoutJson } from './stdout-json.js';
 import { CliUserError } from './cli-user-error.js';
@@ -53,6 +54,7 @@ import { autoStartScheduledRelease, type AutoStartDeferral } from '../release-lo
 import { runRehearsalTick, type RehearsalDeps } from '../release-loop/rehearsal.js';
 import { landingFreezeMessage, LandingFrozenError, readLandingFreeze } from '../release-loop/landing-freeze.js';
 import { formatLightRc, runLightRc, type LightRcDeps } from '../release-loop/light-rc.js';
+import { applyWatchList, formatGateHistory, gateHistory, ghMergedPrs } from '../../scripts/release-loop/gate-history.js';
 import { registerRfcCommands } from './rfc-cli.js';
 
 export const DEFAULT_PUBLIC_REPO = 'ElanvitalAI/elanous';
@@ -699,6 +701,63 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
       for (const row of blocked) console.log(`⛔ ${row.id} ${row.from} → ${row.to} 이월 거부 · ${row.reason}`);
       if (!decisions.length && !blocked.length) console.log('이월할 미시작 칸 없음');
     });
+  release.command('budget').description('판의 P0/P1 루브릭 S(0~3) 분포·합계·미기입 칸 조회(읽기 전용)')
+    .requiredOption('--version <v>', '조회할 판 또는 별칭')
+    .option('--json', '결과 JSON')
+    .action(async (opts: { version: string; json?: boolean }) => {
+      const version = checklistVersion(opts.version, checklistCodenames());
+      const byPriority = {
+        P0: { s: { 0: 0, 1: 0, 2: 0, 3: 0 }, total: 0, missing: 0 },
+        P1: { s: { 0: 0, 1: 0, 2: 0, 3: 0 }, total: 0, missing: 0 },
+      };
+      for (const item of readRubricItems(version, releaseLedgerRoot())) {
+        if (item.priority !== 'P0' && item.priority !== 'P1') continue;
+        const group = byPriority[item.priority];
+        const rubric = parseRubric(`${item.title}\n${item.evidence ?? ''}`);
+        if (rubric === null) group.missing++;
+        else { group.s[rubric.S as 0 | 1 | 2 | 3]++; group.total += rubric.S; }
+      }
+      const result = { version, byPriority, total: byPriority.P0.total + byPriority.P1.total, missing: byPriority.P0.missing + byPriority.P1.missing };
+      if (opts.json) await writeStdoutJson(`${JSON.stringify(result)}\n`);
+      else {
+        for (const [priority, group] of Object.entries(byPriority)) console.log(`${priority} · S 0:${group.s[0]} 1:${group.s[1]} 2:${group.s[2]} 3:${group.s[3]} · 합계 ${group.total} · S 미기입 ${group.missing}`);
+        console.log(`합계 ${result.total} · S 미기입 ${result.missing}`);
+      }
+    });
+  release.command('pull-forward').description('다음 판 P0/P1 칸을 지금 판으로 당길 계획만 조회')
+    .option('--dry-run', '원장 이동 없이 계획만 보기').option('--traffic <path>', 'OP traffic.json 경로')
+    .option('--checkout <dir>', '대상 저장소 체크아웃(기본 harness.defaultRepo 또는 현재 디렉터리)')
+    .option('--json', '구조화 계획 출력')
+    .action((opts: { dryRun?: boolean; traffic?: string; checkout?: string; json?: boolean }) => {
+      if (!opts.dryRun) throw new CliUserError('pull-forward는 --dry-run 계획만 지원한다');
+      const signal = readTrafficSignal(opts.traffic);
+      if (!signal || 'unreadable' in signal) throw new CliUserError('traffic.json을 읽지 못해 hold·신호 순서를 확인할 수 없다');
+      const checkout = resolve(opts.checkout ?? getUserConfig().harness?.defaultRepo ?? process.cwd());
+      if (!existsSync(checkout) || !statSync(checkout).isDirectory()) throw new CliUserError(`대상 저장소 체크아웃이 없다: ${checkout}`);
+      const root = spawnSync('git', ['-C', checkout, 'rev-parse', '--show-toplevel'], { encoding: 'utf8', timeout: 5_000 });
+      if (root.status !== 0 || !root.stdout?.trim() || realpathSync(root.stdout.trim()) !== realpathSync(checkout))
+        throw new CliUserError(`대상 저장소의 Git 체크아웃 루트가 아니다: ${checkout}`);
+      const checkoutReal = realpathSync(checkout);
+      const now = new Date();
+      const schedules = listSchedules(scheduleLedgerRoot());
+      const versions = [...new Set([...schedules.map((row) => row.version), ...features.assignedVersions()])];
+      const checklists = new Map(versions.map((version) => [version, listChecklist(version).items] as const));
+      const placement = pullForwardPlacementConfig();
+      const result = planPullForward({ now, schedules, checklists, released: features.releasedVersion(),
+        merged24h: mergedPrsLast24h(now), ...placement, signal,
+        targetPathExists: (path) => {
+          try {
+            const targetReal = realpathSync(join(checkout, path));
+            const inside = relative(checkoutReal, targetReal);
+            return inside !== '..' && !inside.startsWith(`..${sep}`)
+              && !isAbsolute(inside) && statSync(targetReal).isFile();
+          } catch { return false; }
+        } });
+      if (opts.json) return writeStdoutJson(`${JSON.stringify(result)}\n`);
+      for (const row of result.decisions) console.log(`· 드라이런 ${row.id} ${row.from} → ${row.version} · ${row.reason}`);
+      for (const row of result.blocked) console.log(`⛔ ${row.id} ${row.from} → ${row.to} 당김 보류 · ${row.reason}`);
+      if (!result.decisions.length && !result.blocked.length) console.log('당겨올 칸 없음');
+    });
   const ceoMinutes = (value: string): number => {
     if (!/^\d+$/.test(value) || !Number.isSafeInteger(Number(value))) throw new CliUserError('대표 손 분량은 0 이상의 정수 분이어야 한다');
     return Number(value);
@@ -782,13 +841,16 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
         if (opts.open && (local.version !== undefined || inherited?.version !== undefined)) throw new CliUserError('--open 과 --version 을 함께 쓸 수 없다');
         const json = local.json ?? inherited?.json;
         if (opts.owner !== undefined) parseOwner(opts.owner);
-        const released = opts.open ? (landedDeps.released ?? features.releasedVersion)() : '';
-        const openSnapshots = opts.open
-          ? (landedDeps.schedules ?? features.readSchedules)()
-            .filter(({ version }) => isReleaseVersion(version) && (!released || compareReleaseVersions(version, released) > 0))
-            .sort((a, b) => compareReleaseVersions(a.version, b.version))
-            .map(({ version }) => (landedDeps.checklist ?? listChecklist)(version)).filter((snapshot) => snapshot.items.length > 0)
+        const includeOpenHistory = opts.open || local.version !== undefined || inherited?.version !== undefined;
+        const released = includeOpenHistory ? (landedDeps.released ?? features.releasedVersion)() : '';
+        // readSchedules() initializes SQLite when the ledger does not exist. This query is read-only.
+        const schedules = includeOpenHistory
+          ? landedDeps.schedules?.() ?? (existsSync(join(releaseLedgerRoot(), 'release', 'features.sqlite')) ? features.readSchedules() : [])
           : [];
+        const openSnapshots = schedules
+          .filter(({ version }) => isReleaseVersion(version) && (!released || compareReleaseVersions(version, released) > 0))
+          .sort((a, b) => compareReleaseVersions(a.version, b.version))
+          .map(({ version }) => (landedDeps.checklist ?? listChecklist)(version)).filter((snapshot) => snapshot.items.length > 0);
         if (opts.open && !openSnapshots.length) {
           if (json) await writeStdoutJson('[]\n'); else console.log('열린 판 없음');
           return;
@@ -796,7 +858,9 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
         if (opts.applyEvidence && !opts.dryRun && !mayWrite(cmd)) return;
         const snapshots = opts.open ? openSnapshots : [(landedDeps.checklist ?? listChecklist)(context(cmd).version)];
         const now = (landedDeps.now ?? (() => new Date()))();
-        const updated = snapshots.flatMap(({ items }) => items
+        // --version 도 --open 과 같은 판 전체 최좌 수정일로 병합 PR 을 찾는다 — 선택 판 칸의 updatedAt 에 묶이면 그보다 오래 전에 병합된 PR 을 놓친다(LBY-VERSION-OPEN-MISMATCH · OPT #4059).
+        const sinceSnapshots = opts.open ? snapshots : [...openSnapshots, ...snapshots];
+        const updated = sinceSnapshots.flatMap(({ items }) => items
           .filter((item) => (item.status === 'yellow' || item.status === 'red') && (opts.owner === undefined || ownerMatches(item.owner, opts.owner)))
           .map((item) => Date.parse(item.updatedAt)).filter((at) => Number.isFinite(at)));
         const since = updated.length ? new Date(updated.reduce((earliest, at) => Math.min(earliest, at))).toISOString().slice(0, 10)
@@ -1140,14 +1204,16 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
     .option('--remote <host>', '게이트 호스트(기본 config gateRemote.host)')
     .option('--local', '원격 대신 이 기계에서 돌린다(원격 자식이 이것으로 다시 불린다)')
     .option('--shards <n>', '시험 분할 수', '4')
+    .option('--fixed-shard-distribution', 'self gate 에 그대로 전달 — RSS 사전 측정 없이 --shards N 조각에 정렬 라운드로빈 고정 배정(opt-in · 원격 자식 전달)')
+    .option('--rehearsal-tui', '리허설 전용 TUI 화면 점검(원격 자식 전달)')
     .option('--json', '결과 한 줄 JSON(stdout) · 사람 줄은 stderr')
-    .action(async (o: { version: string; base?: string; head?: string; remote?: string; local?: boolean; shards: string; json?: boolean }) => {
+    .action(async (o: { version: string; base?: string; head?: string; remote?: string; local?: boolean; shards: string; fixedShardDistribution?: boolean; rehearsalTui?: boolean; json?: boolean }) => {
       // The root strips `--local` from argv (remote-bookmark attach) before Commander sees it — same read as `self gate`.
       const local = !!o.local || process.argv.slice(2).includes('--local');
       await jsonAction(o.json, async (log) => {
         if (o.remote !== undefined && local) throw new Error('release light-rc: --remote and --local cannot be combined');
         const shards = Number(o.shards);
-        const result = await runLightRc(o.version, { base: o.base, head: o.head, remote: o.remote, local, shards, ledgerRoot: releaseRunDeps.ledgerRoot, log: (l) => console.error(l) }, lightRcDeps);
+        const result = await runLightRc(o.version, { base: o.base, head: o.head, remote: o.remote, local, shards, ...(o.fixedShardDistribution ? { fixedShardDistribution: true } : {}), rehearsalTui: o.rehearsalTui, ledgerRoot: releaseRunDeps.ledgerRoot, log: (l) => console.error(l) }, lightRcDeps);
         for (const line of formatLightRc(result)) log(line);
         return result;
       }, (r) => r.ok);
@@ -1191,16 +1257,58 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
           ...(o.gateExecutor !== undefined && result.state.inputOverrides?.length ? { gateExecutor: result.state.inputOverrides.at(-1) } : {}) };
       }, (r) => r.status === 'done' || r.status === 'awaiting-approval');
     });
+  release.command('gate-history')
+    .description('GATE-FAIL-HISTORY (0.2.29) — 판을 넘는 게이트 실패 표 — 모든 release-loop·light-rc 런 원장 ⊕ gate-verdict 에서 시험 파일별 introduced·preexisting·env·flaky 횟수 · 마지막 실패 판 · 원인 PR(수리 PR 본문 «원인 #N»)')
+    .option('--since <판|일>', '이 판(x.y.z)부터 · 또는 그 날(YYYY-MM-DD) 이후 시작된 런부터')
+    .option('--top <n>', '가장 자주 깨지는 순 상위 n 줄', '20')
+    .option('--apply-watchlist', '감시 목록(최근 3판 중 2판 이상 새 실패·흔들림)을 release/light-rc-always.txt 에 자동 추가(없는 줄만)')
+    .option('--json', '결과 한 줄 JSON(stdout) · 사람 줄은 stderr')
+    .action(async (o: { since?: string; top: string; applyWatchlist?: boolean; json?: boolean }) => {
+      const log = o.json ? console.error : console.log;
+      try {
+        const top = Number(o.top);
+        if (!/^\d+$/.test(o.top) || !Number.isSafeInteger(top)) throw new CliUserError(`--top 은 0 이상의 정수다: ${o.top}`);
+        const instanceRoots = [effectiveInstanceRoot()];
+        const ledgerRoots = getElanousConfigDirOverride() ? [effectiveInstanceRoot()] : [releaseRunDeps.ledgerRoot ?? releaseLedgerRoot()];
+        const report = gateHistory({ instanceRoots, ledgerRoots, since: o.since }, { mergedPrs: ghMergedPrs });
+        let applied = { added: [] as string[], file: 'release/light-rc-always.txt' };
+        if (o.applyWatchlist && report.watchList.length) {
+          const file = applied.file;
+          const text = existsSync(file) ? readFileSync(file, 'utf8') : '# LIGHT-RC (0.2.19) — tests `release light-rc` always runs, whatever changed since the previous cut.\n# One repository-relative path per line · `#` starts a comment.\n';
+          const next = applyWatchList(text, report.watchList);
+          if (next.added.length) {
+            writeFileSync(file, next.text, { mode: 0o644 });
+            debug.log('release.gate-history', 'watchlist-applied', { added: next.added, file });
+          }
+          applied = { added: next.added, file };
+        }
+        if (o.json) await writeStdoutJson(`${JSON.stringify({ ...report, rows: report.rows.slice(0, top), top, ...(o.applyWatchlist ? { applied } : {}) })}\n`);
+        else {
+          for (const line of formatGateHistory(report, top)) log(line);
+          if (o.applyWatchlist) {
+            if (!report.watchList.length) log('감시 목록에 추가할 파일이 없다');
+            else if (!applied.added.length) log(`감시 목록은 이미 있다: ${report.watchList.join(' · ')}`);
+            else log(`✅ 감시 목록 ${applied.added.length}줄 추가: ${applied.added.join(' · ')} → ${applied.file}`);
+          }
+        }
+      } 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;
+      }
+    });
   release.command('rehearsal').description('판 일정에서 컷 전 가벼운 RC 두 단계').command('tick')
     .description('15분 틱: 다음 판 컷 −7h · −150m RC 계획(기본 보기만)')
     .option('--apply', '도장 선점 후 해당 단계 실행')
     .option('--checkout <dir>', '깨끗한 git 체크아웃(기본 ELANOUS_REHEARSAL_GIT_CWD)')
+    .option('--shards <n>', '시험 분할 수')
+    .option('--remote <host>', '게이트 호스트')
     .option('--json', '결과 한 줄 JSON(stdout)')
-    .action(async (o: { apply?: boolean; checkout?: string; json?: boolean }) => {
+    .action(async (o: { apply?: boolean; checkout?: string; shards?: string; remote?: string; json?: boolean }) => {
       await jsonAction(o.json, async (log) => {
         const ledgerRoot = scheduleLedgerRoot();
         if (o.apply && !mayWriteLedger('release rehearsal tick', false, ledgerRoot)) throw new Error('release rehearsal tick: ledger write denied');
-        const result = await runRehearsalTick({ apply: o.apply, checkout: o.checkout, ledgerRoot }, rehearsalDeps);
+        const result = await runRehearsalTick({ apply: o.apply, checkout: o.checkout, shards: o.shards === undefined ? undefined : Number(o.shards), remote: o.remote, ledgerRoot }, rehearsalDeps);
         log(`· 리허설 ${result.status}${'version' in result ? ` ${result.version}` : ''}${result.status === 'due' ? ` · 실행 ${result.run ?? '-'} · 건너뜀 ${result.supersede.join(', ') || '-'}` : ''}`);
         return result;
       }, (result) => !result.notificationFailures && !result.stamps?.some((stamp) => !['ok', 'superseded'].includes(stamp.outcome)));

package/src/cli/remote-resolve.ts

@@ -202,7 +202,8 @@ function hasFlag(args: readonly string[], name: string): boolean {
  *  ⚠️ 늙을 수 있는 목록이라 ***시험이 감시한다*** — `src/index.ts` 의 루트 옵션 선언을
  *  읽어 `<값>` 을 받는 것이 전부 여기 있는지 확인한다(`root value-taking flags are enumerated`).
  *  ⇒ 루트에 값 받는 플래그를 더하면 그 시험이 «먼저» 깨진다. */
-export const ROOT_FLAGS_TAKING_VALUE = new Set(['--remote', '--config-dir']);
+// ⭐ `--name <name>` = 대시보드 TUI 별명(dashboard-name-flag.ts) — 값이 다음 토큰이라 `elanous --name op -r` 의 `-r` 이 루트로 남게 센다.
+export const ROOT_FLAGS_TAKING_VALUE = new Set(['--remote', '--config-dir', '--name']);
 
 /** 이 토큰이 루트 «선행 플래그 구간» 안에 있나 — 즉 전역 선처리가 소유하나.
  *  ⛔ 없으면 다른 명령의 `-r` 을 «탈취»한다(`autopilot link … -r friend`).

package/src/cli/seat-cli.ts

@@ -1,12 +1,19 @@
 import type { Command } from 'commander';
-import { existsSync, lstatSync, readFileSync, statSync } from 'node:fs';
+import { existsSync, lstatSync, readFileSync, realpathSync, statSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join, relative, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { redactSecretText } from '../debug/log.js';
 import { defaultMsgStorePath, readUnreadCount } from '../msg/msg-store.js';
+import { parseKnowhowItems, splitKnowhow } from '../seat-loop/seat-knowhow.js';
 
 export const SEAT_ROLES = ['OP', 'TC', 'MK', 'UX'] as const;
 export type SeatRole = typeof SEAT_ROLES[number];
+export const SEAT_AGENTS = ['codex', 'elanous', 'claude'] as const;
+export type SeatAgent = typeof SEAT_AGENTS[number];
+export const SEAT_QUICKSTART_MANUAL = join('docs', 'manual', 'MANUAL-seat-agent-quickstart-2026-10-12.md');
+export const SEAT_TRUST_LADDER = '신뢰 사다리: 지시 > 코드 > 문서 > 기억 — 어긋나면 앞이 이긴다';
+export const SEAT_TACIT_TOP_N = 5;
 
 const MAX_FIELD = 160;
 const MAX_ROWS = 12;
@@ -78,19 +85,168 @@ function contextFacts(snapshot: unknown): string[] {
   return facts.slice(0, MAX_ROWS);
 }
 
-export function renderSeatBootCard(seat: SeatRole, sections: ReadonlyArray<{ title: string; source: string; updated: string; rows: readonly string[]; reason?: string }>, facts: readonly string[], contextUpdated = '미상'): string {
-  const out = [`# ${seat} 자리 부팅 카드`, '', '## 현재 구조화 관측', '출처: elanous://context-now', `갱신: ${clean(contextUpdated)}`, ...(facts.length ? facts.map(row => `- ${clean(row)}`) : ['- 미관측: contextNow 구조화 facts/events 없음'])];
+export type SeatBootSection = { title: string; source: string; updated: string; rows: readonly string[]; reason?: string };
+
+/** `facts === null` 이면 contextNow 절을 «생략»한다(TUI 부트 카드 — 턴 경로에서 버스를 안 읽는다). */
+export function renderSeatBootCard(seat: string, sections: ReadonlyArray<SeatBootSection>, facts: readonly string[] | null, contextUpdated = '미상'): string {
+  const out = facts === null
+    ? [`# ${seat} 자리 부팅 카드`]
+    : [`# ${seat} 자리 부팅 카드`, '', '## 현재 구조화 관측', '출처: elanous://context-now', `갱신: ${clean(contextUpdated)}`, ...(facts.length ? facts.map(row => `- ${clean(row)}`) : ['- 미관측: contextNow 구조화 facts/events 없음'])];
   for (const section of sections) out.push('', `## ${section.title}`, `출처: ${clean(section.source)}`, `갱신: ${clean(section.updated)}`, ...(section.rows.length ? section.rows.map(row => `- ${clean(row)}`) : [`- ${clean(section.reason ?? '미관측')}`]));
   return out.join('\n');
 }
 
-export function registerSeatBootCommands(command: Command, options: { home?: () => string; contextNow?: () => unknown; msgPath?: () => string } = {}): void {
+/** 자리 카드의 파일·우편 절(동기) — `eln seat boot` 와 TUI 세션 부트(`dashboard/seat-boot-preamble.ts`)가 같이 쓴다. */
+export function collectSeatBootSections(seat: string, options: { home: string; msgPath: string }): { sections: SeatBootSection[]; unread: number | null } {
+  const root = join(options.home, 'elanous-hq', 'seat-state');
+  const seatDir = join(root, seat);
+  let unread: number | null = null;
+  try { unread = readUnreadCount(seat, options.msgPath); }
+  catch { /* unavailable is not a measured zero */ }
+  const sections: SeatBootSection[] = [
+    { title: 'msg 원장', source: options.msgPath, updated: unread === null ? '미상' : new Date().toISOString(), rows: [`안 읽은 msg ${unread ?? '미관측'} (${seat})`] },
+    { title: 'HANDOFF', ...metadata(options.home, root, join(seatDir, 'HANDOFF.md'), 'markdown') },
+    { title: 'inbox', ...metadata(options.home, root, join(seatDir, 'inbox.md'), 'markdown') },
+    { title: '수확 주장', ...metadata(options.home, root, join(seatDir, 'harvest-claims.tsv'), 'tsv') },
+    { title: '예약', ...metadata(options.home, root, join(seatDir, 'scheduled.tsv'), 'tsv') },
+    { title: '공통 메모리 색인', ...metadata(options.home, root, join(root, 'memory', 'MEMORY.md'), 'memory') },
+  ];
+  return { sections, unread };
+}
+
+/** 표 줄을 칸으로 — 백틱 안의 `|`(예: `<pass|fail>`)는 칸 경계가 아니다. */
+const cells = (line: string): string[] => (line.replace(/^\s*\|/, '').replace(/\|\s*$/, '').match(/(?:`[^`]*`|[^|`])+|(?<=\|)(?=\|)/g) ?? []).map(cell => cell.trim());
+const backticked = (text: string): string[] => [...text.matchAll(/`([^`]+)`/g)].map(match => match[1]!);
+
+/** L1 — 빠른 길 매뉴얼의 «무엇을 하려면 → 명령» 표를 고른 에이전트용 한 줄씩으로 접는다. ⚠️ 주석은 다른 에이전트만 이름 대면 뺀다. */
+export function assembleSeatQuickPath(manual: string, agent: SeatAgent): string[] {
+  const lines = manual.split(/\r?\n/);
+  const start = lines.findIndex(line => /^##\s.*무엇.*명령/.test(line));
+  if (start < 0) return [];
+  const rows: string[] = [];
+  for (const line of lines.slice(start + 1)) {
+    if (/^#{1,2}\s/.test(line)) break;
+    if (!line.trim().startsWith('|') || /^\s*\|\s*-/.test(line)) continue;
+    const [what = '', command = '', dont = ''] = cells(line);
+    if (!what || what === '하려는 것') continue;
+    const segments = command.split(' · ').filter(segment => {
+      if (!segment.trim().startsWith('⚠️')) return true;
+      const named = SEAT_AGENTS.filter(name => new RegExp(`\\b${name}\\b`, 'i').test(segment));
+      return named.length === 0 || named.includes(agent);
+    });
+    const commands = segments.flatMap(segment => segment.trim().startsWith('⚠️') ? [segment.replace(/[`*]/g, '').trim()] : backticked(segment));
+    rows.push(`${what.replace(/\*\*/g, '')} → ${commands.join(' · ') || '미관측: 명령 없음'}${dont ? ` ⛔ ${dont.replace(/\*\*/g, '')}` : ''}`);
+  }
+  return rows;
+}
+
+export type SeatMemoryEntry = { title: string; hook: string; updated: string };
+type TacitCandidate = { label: string; details?: string[]; updated: string; hits: number; index: number };
+
+const tokens = (text: string): Set<string> => new Set(text.toLowerCase().split(/[^\p{L}\p{N}_]+/u).filter(Boolean));
+const hitsOf = (text: string, query: Set<string>): number => [...tokens(text)].filter(token => query.has(token)).length;
+/** 최근(날짜) 먼저, 같은 날이면 적중(질의 낱말 겹침) 많은 것, 그다음 원래 순서. */
+const recentThenHits = (a: TacitCandidate, b: TacitCandidate): number => b.updated.slice(0, 10).localeCompare(a.updated.slice(0, 10)) || b.hits - a.hits || a.index - b.index;
+
+/** 제목 이외의 운영 지침을 보존한다. 상태·검증은 분류에 이미 반영되어 중복 표시하지 않는다. */
+function knowhowDetails(text: string, prefix: string): string[] {
+  return text.split(/\r?\n/).slice(1)
+    .filter(line => line.trim() && !/^\s*-\s*(?:상태|검증)\s*:/.test(line))
+    .flatMap(line => (line.trim().match(/.{1,140}/gu) ?? []).map(part => `${prefix} ↳ ${part}`));
+}
+
+/** L3 — 최근 문서 상위 5개는 본문까지, 기억은 상위 N을 보인다. 절별 출력 하드 캡은 없다. */
+export function assembleSeatTacitKnowledge(input: { seat: string; agent: SeatAgent; knowhow: string; memories: readonly SeatMemoryEntry[]; now: Date; limit?: number }): string[] {
+  const limit = Math.max(0, input.limit ?? SEAT_TACIT_TOP_N);
+  const query = tokens(`${input.seat} ${input.agent}`);
+  const { facts, refs } = splitKnowhow(parseKnowhowItems(input.knowhow, input.seat), input.now);
+  const knowhow = [...facts, ...refs].map((item, index): TacitCandidate => {
+    const prefix = `[문서${facts.includes(item) ? '' : '·검증 안 됨'}]`;
+    const title = (item.text.split('\n', 1)[0] ?? '').replace(/^##\s*/, '');
+    return {
+      label: `${prefix} ${title}`,
+      details: knowhowDetails(item.text, prefix),
+      updated: item.verifiedAt?.toISOString() ?? '',
+      hits: hitsOf(item.text, query),
+      index,
+    };
+  }).sort(recentThenHits);
+  const memories = input.memories.map((entry, index): TacitCandidate => ({
+    label: `[기억] ${entry.title}${entry.hook ? ` — ${entry.hook}` : ''} (갱신 ${entry.updated.slice(0, 10) || '미상'})`,
+    updated: entry.updated,
+    hits: hitsOf(`${entry.title} ${entry.hook}`, query),
+    index,
+  })).sort(recentThenHits).slice(0, limit);
+  const visibleKnowhow = knowhow.slice(0, SEAT_TACIT_TOP_N);
+  const omittedKnowhow = knowhow.length - visibleKnowhow.length;
+  return [SEAT_TRUST_LADDER,
+    ...visibleKnowhow.flatMap(row => [row.label, ...(row.details ?? [])]),
+    ...(omittedKnowhow ? [`[문서] 나머지 ${omittedKnowhow}항목은 원문 KNOWHOW 참고`] : []),
+    ...memories.map(row => row.label)];
+}
+
+/** 저장소 안 일반 파일만 읽는다 — 링크가 저장소 밖을 가리키면 없는 것으로 친다. */
+function readRepoDoc(repoRoot: string, path: string): { updated: string; text: string } | null {
+  try {
+    const suffix = relative(realpathSync(repoRoot), realpathSync(path));
+    if (!suffix || suffix === '..' || suffix.startsWith(`..${sep}`) || suffix.startsWith(sep)) return null;
+    const stat = statSync(path);
+    if (!stat.isFile()) return null;
+    return { updated: stat.mtime.toISOString(), text: readFileSync(path, 'utf8').slice(0, 256_000) };
+  } catch { return null; }
+}
+
+function memoryEntries(home: string, root: string): { entries: SeatMemoryEntry[]; reason?: string } {
+  const dir = join(root, 'memory');
+  const index = join(dir, 'MEMORY.md');
+  try {
+    if (!existsSync(index)) return { entries: [], reason: '미관측: 기억 색인 파일 없음' };
+    if (!isRegularSeatPath(home, root, index)) return { entries: [], reason: '미관측: 기억 색인이 일반 경로가 아님' };
+    const entries = readFileSync(index, 'utf8').slice(0, 256_000).split(/\r?\n/).flatMap(line => {
+      const match = line.match(/^-\s*\[([^\]]+)\]\(([^)]+)\)\s*(?:[—-]\s*(.*))?$/);
+      if (!match) return [];
+      const file = join(dir, match[2]!);
+      try {
+        if (!existsSync(file) || !isRegularSeatPath(home, root, file)) return [];
+        return [{ title: match[1]!, hook: match[3] ?? '', updated: statSync(file).mtime.toISOString() }];
+      } catch { return []; }
+    });
+    return entries.length ? { entries } : { entries, reason: '미관측: 기억 색인에 읽을 항목 없음' };
+  } catch { return { entries: [], reason: '미관측: 기억 색인 읽기 실패' }; }
+}
+
+/** L1·L3 절 — `--agent` 를 줬을 때만 L0 카드 뒤에 붙는다. */
+export function collectSeatLadderSections(seat: string, agent: SeatAgent, options: { home: string; repoRoot: string; now: Date }): SeatBootSection[] {
+  const manualPath = join(options.repoRoot, SEAT_QUICKSTART_MANUAL);
+  const manual = readRepoDoc(options.repoRoot, manualPath);
+  const quick = manual ? assembleSeatQuickPath(manual.text, agent) : [];
+  const knowhowPath = join(options.repoRoot, 'docs', 'roles', seat, 'KNOWHOW.md');
+  const knowhow = readRepoDoc(options.repoRoot, knowhowPath);
+  const root = join(options.home, 'elanous-hq', 'seat-state');
+  const memories = memoryEntries(options.home, root);
+  const tacit = assembleSeatTacitKnowledge({ seat, agent, knowhow: knowhow?.text ?? '', memories: memories.entries, now: options.now });
+  const docs = tacit.filter(row => row.startsWith('[문서'));
+  const remembered = tacit.filter(row => row.startsWith('[기억]'));
+  const tacitRows = [
+    SEAT_TRUST_LADDER,
+    ...(docs.length ? docs : [knowhow ? '미관측: KNOWHOW 에 읽을 항목 없음' : '미관측: KNOWHOW 파일 없음']),
+    ...(remembered.length ? remembered : [memories.reason ?? '미관측: 기억 없음']),
+  ];
+  return [
+    { title: `L1 빠른 길 (${agent})`, source: manualPath, updated: manual?.updated ?? '미상', rows: quick, ...(quick.length ? {} : { reason: manual ? '미관측: «무엇→명령» 표 없음' : '미관측: 파일 없음' }) },
+    { title: `L3 암묵지 (${agent})`, source: `${knowhowPath} ⊕ ${join(root, 'memory', 'MEMORY.md')}`, updated: knowhow?.updated ?? '미상', rows: tacitRows },
+  ];
+}
+
+export function registerSeatBootCommands(command: Command, options: { home?: () => string; contextNow?: () => unknown; msgPath?: () => string; repoRoot?: () => string; now?: () => Date } = {}): void {
   command.command('boot <seat>').description('현재 자리 카드 — 허용된 메타데이터만 읽기 전용 표시')
-    .action(async (rawSeat: string) => {
+    .option('--agent <agent>', '에이전트(codex|elanous|claude) — 주면 L1 빠른 길 ⊕ L3 암묵지를 붙인다')
+    .action(async (rawSeat: string, flags: { agent?: string }) => {
       const seat = rawSeat.toUpperCase();
       if (!(SEAT_ROLES as readonly string[]).includes(seat)) { console.error(`seat boot: unknown seat ${rawSeat} (OP|TC|MK|UX)`); process.exitCode = 2; return; }
+      const agent = flags.agent?.toLowerCase();
+      if (agent !== undefined && !(SEAT_AGENTS as readonly string[]).includes(agent)) { console.error(`seat boot: unknown agent ${flags.agent} (codex|elanous|claude)`); process.exitCode = 2; return; }
       const home = options.home?.() ?? homedir();
-      const root = join(home, 'elanous-hq', 'seat-state');
       let facts: string[] = [];
       let contextUpdated = '미상';
       try {
@@ -102,19 +258,8 @@ export function registerSeatBootCommands(command: Command, options: { home?: ()
         contextUpdated = typeof context.at === 'string' ? clean(context.at) : '시각 미관측';
         facts = contextFacts(snapshot);
       } catch { facts = []; contextUpdated = '미관측: contextNow 조회 실패'; }
-      const seatDir = join(root, seat);
-      const msgPath = options.msgPath?.() ?? defaultMsgStorePath();
-      let unread: number | null = null;
-      try { unread = readUnreadCount(seat, msgPath); }
-      catch { /* unavailable is not a measured zero */ }
-      const sections = [
-        { title: 'msg 원장', source: msgPath, updated: unread === null ? '미상' : new Date().toISOString(), rows: [`안 읽은 msg ${unread ?? '미관측'} (${seat})`] },
-        { title: 'HANDOFF', ...metadata(home, root, join(seatDir, 'HANDOFF.md'), 'markdown') },
-        { title: 'inbox', ...metadata(home, root, join(seatDir, 'inbox.md'), 'markdown') },
-        { title: '수확 주장', ...metadata(home, root, join(seatDir, 'harvest-claims.tsv'), 'tsv') },
-        { title: '예약', ...metadata(home, root, join(seatDir, 'scheduled.tsv'), 'tsv') },
-        { title: '공통 메모리 색인', ...metadata(home, root, join(root, 'memory', 'MEMORY.md'), 'memory') },
-      ];
+      const sections = collectSeatBootSections(seat, { home, msgPath: options.msgPath?.() ?? defaultMsgStorePath() }).sections;
+      if (agent !== undefined) sections.push(...collectSeatLadderSections(seat, agent as SeatAgent, { home, repoRoot: options.repoRoot?.() ?? fileURLToPath(new URL('../../', import.meta.url)), now: options.now?.() ?? new Date() }));
       console.log(renderSeatBootCard(seat as SeatRole, sections, facts, contextUpdated));
     });
 }

package/src/cli/self-update.ts

@@ -590,8 +590,11 @@ function pruneUnusedVersions(dir: string, outcome: VersionPruneOutcome, listProc
             try { owner = statSync(join('/proc', pid)).uid; stat = readFileSync(join('/proc', pid, 'stat'), 'utf8'); }
             catch (failure) { if (exited(failure) && !existsSync(join('/proc', pid))) continue; throw failure; }
             if (procStatHoldsNothing(stat)) continue;
-            // Our own links must be readable. Another UID's link failure (denied, or ENOENT from a live process) falls back to its argv.
-            if ((code === 'EACCES' || code === 'EPERM' || code === 'ENOENT') && owner !== process.getuid?.()) {
+            // A denied link falls back to argv for any owner: Linux ptrace access also refuses same-UID
+            // processes holding extra capabilities or another user namespace (systemd --user, rootless
+            // containers), so requiring them would disable pruning on every systemd host. ENOENT from a
+            // live process stays fatal for our own UID and falls back to argv only for another UID.
+            if (code === 'EACCES' || code === 'EPERM' || (code === 'ENOENT' && owner !== process.getuid?.())) {
               if (!argvRead.has(pid)) {
                 argvRead.add(pid);
                 let argv: string | undefined;