elanous 0.2.9 → 0.2.11

package/src/cli/release-cli.ts

@@ -5,7 +5,8 @@
 //   elanous release tag --version <x.y.z> --source <commit> [--yes]
 //   elanous release verify  [--version <x.y.z>]
 //   elanous release notes   --from <ref> [--to <ref>]
-//   elanous release run     --version <x.y.z> [--dry-run] [--json] [--if-ready]
+//   elanous release run     --version <x.y.z> [--cut-commit <sha>] [--dry-run] [--json] [--if-ready]
+//   elanous release cut-branch --version <x.y.z> --base <sha> --pick <sha>... [--dry-run]
 //
 // 🩸 계기(2026-09-25 v0.1.0 첫 공개): 손으로 밟은 절차에서 둘을 빠뜨릴 뻔했다 — 공개본 git 커밋(판 커밋이 공개본 커밋이 된다) ·
 //    PWA 빌드(빌드 산출은 공개본에 안 실린다 → 빠뜨리면 «웹 화면 없는 판»). 절차를 명령으로 굳힌다.
@@ -23,10 +24,13 @@ import { effectiveInstanceRoot, releaseLedgerRoot } from '../instance/resolve.js
 import { getElanousConfigDirOverride } from '../elanous-config-dir.js';
 import { envLiteral } from '../platform/env-literal.js';
 import { userConfigPath } from '../user-config.js';
-import { addItem, devVersion, listChecklist, removeItem, seedFromRoadmap, setItem, summarizeChecklist, type ChecklistStatus, type ChecklistDisposition, type ChecklistKind } from '../release-loop/checklist.js';
+import { addItem, claimItem, decodeClaimHistoryEntry, devVersion, listChecklist, ownerMatches, parseOwner, parityGap, removeItem, seedFromRoadmap, setItem, summarizeChecklist, type ChecklistStatus, type ChecklistDisposition, type ChecklistKind } from '../release-loop/checklist.js';
 import * as features from '../release-loop/feature-store.js';
+import { formatSchedule, getSchedule, listSchedules, setSchedule } from '../release-loop/release-schedule.js';
 import { writeStdoutJson } from './stdout-json.js';
+import { CliUserError } from './cli-user-error.js';
 import { runUnattendedRelease, type UnattendedReleaseDeps } from '../../scripts/release-loop/unattended-release.js';
+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';
 
@@ -468,15 +472,23 @@ function checklistCodenames(): Record<string, string> {
 function checklistVersion(input: string | undefined, codenames: Record<string, string>): string {
   const v = input ?? devVersion().replace(/-dev\.\d+$/, '');
   const resolved = isReleaseVersion(v) ? v : Object.entries(codenames).find(([, name]) => name === v)?.[0] ?? v;
-  if (!isReleaseVersion(resolved)) throw new Error(`체크리스트 판 또는 별칭이 아니다: ${v}`);
+  if (!isReleaseVersion(resolved)) throw new CliUserError(`체크리스트 판 또는 별칭이 아니다: ${v}`);
   return resolved;
 }
 
-async function checklistOutput(v: string, codenames: Record<string, string>, mode: 'list' | 'status', json?: boolean): Promise<void> {
-  const data = listChecklist(v);
+async function checklistOutput(v: string, codenames: Record<string, string>, mode: 'list' | 'status', json?: boolean, owner?: string): Promise<void> {
+  if (owner !== undefined) parseOwner(owner);
+  const snapshot = listChecklist(v);
+  const data = owner === undefined ? snapshot : { ...snapshot, items: snapshot.items.filter((item) => ownerMatches(item.owner, owner)) };
   const summary = summarizeChecklist(data);
-  const result = { ...data, codename: codenames[v] ?? '', ...summary };
+  const parity = data.items.flatMap((item) => {
+    const why = item.kind === 'screen' ? parityGap(item.evidence) : null;
+    return why ? [{ id: item.id, why }] : [];
+  });
+  const result = { ...data, codename: codenames[v] ?? '', ...summary, parity };
+  for (const { id, why } of parity) debug.log('release.checklist', 'parity-warning', { version: v, id, why });
   if (json) { await writeStdoutJson(`${JSON.stringify(result)}\n`); return; }
+  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}` : ''}`);
@@ -489,6 +501,26 @@ async function checklistOutput(v: string, codenames: Record<string, string>, mod
 
 export function registerReleaseCommands(program: Command, releaseRunDeps: UnattendedReleaseDeps = {}): void {
   const release = program.command('release').description('공개 배포 한 판 — prepare(로컬) → publish(--yes) → verify (docs/manual/MANUAL-versioning-and-release-2026-09-25.md)');
+  const schedule = release.command('schedule').description('판별 컷·착지 마감 조회·갱신');
+  const scheduleLedgerRoot = () => releaseRunDeps.ledgerRoot ?? releaseLedgerRoot();
+  schedule.command('list').option('--json', '결과 JSON').action((o: { json?: boolean }) => {
+    const rows = listSchedules(scheduleLedgerRoot());
+    if (o.json) console.log(JSON.stringify(rows));
+    else for (const row of rows) console.log(formatSchedule(row));
+  });
+  schedule.command('show').requiredOption('--version <v>', '조회할 판').option('--json', '결과 JSON')
+    .action((o: { version: string; json?: boolean }) => {
+      const row = getSchedule(o.version, scheduleLedgerRoot());
+      if (!row) throw new CliUserError(`없는 판 일정: ${o.version}`, '판 일정 등록: elanous release schedule set --version <v> --cut-at <iso> --land-by <iso>');
+      if (o.json) console.log(JSON.stringify(row)); else console.log(formatSchedule(row));
+    });
+  schedule.command('set').requiredOption('--version <v>', '갱신할 판')
+    .option('--cut-at <iso>', '오프셋 포함 컷 시각').option('--land-by <iso>', '오프셋 포함 착지 마감').option('--json', '결과 JSON')
+    .action((o: { version: string; cutAt?: string; landBy?: string; json?: boolean }) => {
+      if (o.cutAt === undefined && o.landBy === undefined) throw new CliUserError('갱신할 시각을 지정하라', '--cut-at <iso> 또는 --land-by <iso>');
+      const row = setSchedule(o.version, { cutAt: o.cutAt, landBy: o.landBy }, process.env.ELANOUS_TRACK || 'cli', scheduleLedgerRoot());
+      if (o.json) console.log(JSON.stringify(row)); else console.log(formatSchedule(row));
+    });
   const checklist = release.command('checklist').description('판별 확인표 조회·갱신')
     .option('--version <v>', '판 또는 별칭(기본: package.json 의 개발판에서 -dev.N 제거)')
     .option('--json', '결과 JSON');
@@ -498,15 +530,15 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
     return { version: checklistVersion(opts.version, codenames), codenames, json: opts.json };
   };
   const withContext = (cmd: Command) => cmd.option('--version <v>', '판 또는 별칭').option('--json', '결과 JSON');
-  withContext(checklist.command('list').description('모든 칸')).action(async (_opts: unknown, cmd: Command) => {
+  withContext(checklist.command('list').description('모든 칸')).option('--owner <owner>', '자리 또는 하위 자리로 거르기').action(async (opts: { owner?: string }, cmd: Command) => {
     const { version, codenames, json } = context(cmd);
-    await checklistOutput(version, codenames, 'list', json);
+    await checklistOutput(version, codenames, 'list', json, opts.owner);
   });
-  withContext(checklist.command('status').description('상태 요약')).action(async (_opts: unknown, cmd: Command) => {
+  withContext(checklist.command('status').description('상태 요약')).option('--owner <owner>', '자리 또는 하위 자리로 거르기').action(async (opts: { owner?: string }, cmd: Command) => {
     const { version, codenames, json } = context(cmd);
-    await checklistOutput(version, codenames, 'status', json);
+    await checklistOutput(version, codenames, 'status', json, opts.owner);
   });
-  withContext(checklist.command('add <id> <title>').description('칸 추가')).option('--owner <owner>', '담당').option('--kind <kind>', 'screen = 다섯 화면 짝 칸')
+  withContext(checklist.command('add <id> <title>').description('칸 추가')).option('--owner <owner>', '담당').option('--kind <kind>', 'screen = 다섯 화면 짝 칸 · 근거에 짝: PWA … · 데스크톱 … · 폴드 … · 아이폰 … · 아이패드 … 한 줄')
     .action((id: string, title: string, opts: { owner?: string; kind?: string }, cmd: Command) => {
     const { version, json } = context(cmd);
     const data = addItem(version, { id, title, ...(opts.owner !== undefined ? { owner: opts.owner } : {}), ...(opts.kind !== undefined ? { kind: opts.kind as ChecklistKind } : {}) });
@@ -514,15 +546,28 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
   });
   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 = 다섯 화면 짝 칸')
+    .option('--disposition <disposition>', 'move|known-issue|block').option('--kind <kind>', 'screen = 다섯 화면 짝 칸 · 근거에 짝: PWA … · 데스크톱 … · 폴드 … · 아이폰 … · 아이패드 … 한 줄')
     .action((id: string, opts: { status?: string; evidence?: string; owner?: string; disposition?: string; kind?: string }, cmd: Command) => {
       const { version, json } = context(cmd);
-      if (opts.status !== undefined && !['green', 'yellow', 'red', 'done'].includes(opts.status)) throw new Error(`잘못된 상태: ${opts.status}`);
-      if (opts.disposition !== undefined && !['move', 'known-issue', 'block'].includes(opts.disposition)) throw new Error(`잘못된 처분: ${opts.disposition}`);
-      if (opts.status === undefined && opts.evidence === undefined && opts.owner === undefined && opts.disposition === undefined && opts.kind === undefined) throw new Error('갱신할 칸을 지정하라');
+      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) throw new CliUserError('갱신할 칸을 지정하라', '--status · --evidence · --owner · --disposition · --kind 중 하나');
       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 } : {}) }, 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) {
+        console.error(`⚠ 짝: ${why} — 근거에 «짝: PWA … · 데스크톱 … · 폴드 … · 아이폰 … · 아이패드 …» 한 줄`);
+        debug.log('release.checklist', 'parity-warning', { version, id, why });
+      }
       if (json) console.log(JSON.stringify(data)); else console.log(`✅ ${id} 갱신`);
     });
+  withContext(checklist.command('claim <id>').description('칸의 단일 주인을 잡는다'))
+    .requiredOption('--by <owner>', '잡을 자리 또는 하위 자리').option('--force', '기존 주인에서 강제로 바꾼다')
+    .action((id: string, opts: { by: string; force?: boolean }, cmd: Command) => {
+      const { version, json } = context(cmd);
+      const data = claimItem(version, id, opts.by, { force: opts.force });
+      if (json) console.log(JSON.stringify(data)); else console.log(`✅ ${id} 주인 ${opts.by}`);
+    });
   withContext(checklist.command('rm <id>').description('칸 삭제')).action((id: string, _opts: unknown, cmd: Command) => {
     const { version, json } = context(cmd);
     const data = removeItem(version, id, process.env.ELANOUS_TRACK || 'cli');
@@ -540,8 +585,8 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
     .action((id: string, opts: { from: string; to: string }, cmd: Command) => {
       const { codenames, json } = context(cmd);
       const from = checklistVersion(opts.from, codenames), to = checklistVersion(opts.to, codenames);
-      const data = features.move(id, from, to, actor());
-      if (json) console.log(JSON.stringify(data)); else console.log(`✅ ${id} ${from} → ${to}`);
+      features.move(id, from, to, actor());
+      if (json) console.log(JSON.stringify(listChecklist(to))); else console.log(`✅ ${id} ${from} → ${to}`);
     });
   withContext(checklist.command('retitle <id> <title>').description('칸 제목 수정')).action((id: string, title: string, _opts: unknown, cmd: Command) => {
     const { version, json } = context(cmd);
@@ -554,11 +599,11 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
     const { version, json } = context(cmd);
     const snapshot = listChecklist(version);
     features.evidenceAdd(id, version, ref, actor(), snapshot.released, snapshot.dev);
-    if (json) console.log(JSON.stringify(features.history(id))); else console.log(`✅ ${id} 근거 ${ref}`);
+    if (json) console.log(JSON.stringify(features.history(id).map(decodeClaimHistoryEntry))); else console.log(`✅ ${id} 근거 ${ref}`);
   });
   withContext(checklist.command('history <id>').description('칸의 판 이동·변경 이력')).action((id: string, _opts: unknown, cmd: Command) => {
     const { json } = context(cmd);
-    const rows = features.history(id);
+    const rows = features.history(id).map(decodeClaimHistoryEntry);
     if (json) { console.log(JSON.stringify(rows)); return; }
     const info = features.details(id);
     if (info) {
@@ -570,8 +615,8 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
   withContext(checklist.command('export').description('SQLite 에서 checklist.json 스냅샷 생성')).action((_opts: unknown, cmd: Command) => {
     const { version, json } = context(cmd);
     const snapshot = listChecklist(version);
-    const data = features.exportJson(version, snapshot.released, snapshot.dev);
-    if (json) console.log(JSON.stringify(data)); else console.log(`✅ ${version} checklist.json 내보냄`);
+    features.exportJson(version, snapshot.released, snapshot.dev);
+    if (json) console.log(JSON.stringify(listChecklist(version))); else console.log(`✅ ${version} checklist.json 내보냄`);
   });
   release.command('prepare')
     .description('깨끗한 원본 → 공개본 → 공개 저장소 이력 위 커밋 → PWA → 묶음·체크섬 → 로컬 끝까지 (네트워크 쓰기 없음)')
@@ -632,19 +677,30 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
       const { draftReleaseNotes, readLandedCommits, renderReleaseNotes } = await import('../../scripts/release-notes.js');
       console.log(renderReleaseNotes(draftReleaseNotes(readLandedCommits(o.from, o.to), o.from, o.to)));
     });
+  release.command('cut-branch')
+    .description('원래 컷에 main 의 수리 커밋만 얹은 release/<v> 가지를 만들고 push')
+    .requiredOption('--version <v>', '릴리스 판(x.y.z)')
+    .requiredOption('--base <sha>', '원래 컷 SHA')
+    .requiredOption('--pick <sha...>', '차례로 얹을 main 커밋 SHA')
+    .option('--dry-run', '가지·worktree·push 없이 계획만 출력')
+    .option('--json', '결과 한 줄 JSON(stdout)')
+    .action(async (o: { version: string; base: string; pick: string[]; 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('--json', '결과 한 줄 JSON(stdout) · 사람 줄은 stderr')
-    .action(async (o: { version: string; dryRun?: boolean; ifReady?: boolean; json?: boolean }) => {
+    .action(async (o: { version: string; cutCommit?: string; dryRun?: boolean; ifReady?: boolean; json?: boolean }) => {
       if (o.ifReady && !o.dryRun) {
         try {
           const outcome = await runReleaseIfReady(o.version, {
             ledgerRoot: releaseRunDeps.ledgerRoot,
             readiness: (version, options) => releaseReadiness(version, { ledgerRoot: releaseRunDeps.ledgerRoot, checklist: releaseRunDeps.checklist, ...options }),
-            run: () => runUnattendedRelease({ version: o.version }, releaseRunDeps),
+            run: () => runUnattendedRelease({ version: o.version, cutCommit: o.cutCommit }, releaseRunDeps),
           });
           if (outcome.skipped) {
             if (o.json) await writeStdoutJson(`${JSON.stringify(outcome)}\n`);
@@ -664,7 +720,7 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
         return;
       }
       await jsonAction(o.json, async (log) => {
-        const result = await runUnattendedRelease({ version: o.version, dryRun: o.dryRun }, releaseRunDeps);
+        const result = await runUnattendedRelease({ version: o.version, dryRun: o.dryRun, cutCommit: o.cutCommit }, 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');

package/src/cli/self-update.ts

@@ -343,6 +343,14 @@ function pruneReleaseVersions(plan: { current: string; previous: string; keep: n
   return { removed, kept };
 }
 
+/** The build identity of an install.json — version, version folder and commit; empty when it cannot be read. */
+function installedBuild(metadata: unknown): string {
+  if (typeof metadata !== 'object' || metadata === null) return '';
+  const { version, versionDir, commit } = metadata as { version?: unknown; versionDir?: unknown; commit?: unknown };
+  if (typeof version !== 'string' || !version || typeof versionDir !== 'string' || !versionDir) return '';
+  return JSON.stringify([version, versionDir, typeof commit === 'string' ? commit : '']);
+}
+
 /** A release update never packs the checkout: the downloaded installer verifies its own release tarball. */
 export async function runReleaseUpdate(options: ReleaseUpdateOptions = {}, deps: ReleaseUpdateDeps = {}): Promise<SelfUpdateResult> {
   const out = deps.out ?? console;
@@ -390,8 +398,10 @@ export async function runReleaseUpdate(options: ReleaseUpdateOptions = {}, deps:
     return fail(1, `설치기 다운로드 실패 (${url}): ${String(error)}`);
   }
   let previous = '';
+  let previousBuild = '';
   try {
     const metadata: unknown = JSON.parse(readFileSync(join(prefix, 'install.json'), 'utf8'));
+    previousBuild = installedBuild(metadata);
     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);
@@ -421,6 +431,10 @@ export async function runReleaseUpdate(options: ReleaseUpdateOptions = {}, deps:
       prune = { removed: [], kept: [], skipped: `정리 실패: ${String(error)}` };
     }
     if (!options.restart) return finish({ exitCode: 0, installedVersion, decision: null, restarted: false, prune, reason: '--restart 없음: 재시작하지 않음' });
+    // REL6: the same build again (version · folder · commit unchanged) leaves the running daemon as it is.
+    if (previousBuild && previousBuild === installedBuild(metadata)) {
+      return finish({ exitCode: 0, installedVersion, decision: null, restarted: false, prune, reason: `already at ${installedVersion} · restart skipped` });
+    }
     const os = deps.os ?? platform();
     const command = os === 'darwin' ? 'launchctl' : os === 'linux' ? 'systemctl' : null;
     if (!command) return finish({ exitCode: 1, installedVersion, decision: null, restarted: false, prune, reason: `지원하지 않는 플랫폼: ${os}` });

package/src/cli/setup-cli.ts

@@ -5,6 +5,7 @@ import { Command } from 'commander';
 import { formatDoctorReport, registerDoctorCommand, runDoctor, type DoctorOptions, type DoctorReport } from './doctor-cli.js';
 import { applyClaudePluginSetup, planClaudePluginSetup } from './claude-plugin-setup.js';
 import { recommendedSetup } from './setup-recommend.js';
+import { detectSkillCliAuth, type CliAuthStatus } from '../onboarding/cli-auth-status.js';
 import { debug } from '../debug/log.js';
 import { getUserConfig, saveUserConfig, type UserConfig } from '../user-config.js';
 
@@ -22,6 +23,7 @@ type SetupStep = {
 export interface SetupCliDeps extends DoctorOptions {
   runDoctor?: (options: DoctorOptions) => DoctorReport;
   runDoctorFix?: (args: readonly string[]) => Promise<number>;
+  detectSkillCliAuth?: typeof detectSkillCliAuth;
   readFile?: (path: string) => string;
   exists?: (path: string) => boolean;
   homeDir?: () => string;
@@ -142,10 +144,46 @@ export function formatSetupReport(doctor: DoctorReport, steps: SetupStep[], nonI
   ].join('\n');
 }
 
+const CLI_SKILLS = {
+  gh: 'github', gws: 'google-workspace', op: '1password', himalaya: 'himalaya',
+} as const;
+
+function formatCliSkillStatus(status: CliAuthStatus, enabled: boolean, reason?: string): string {
+  return `${status.cli}: found=${status.found ? 'yes' : 'no'} / enabled=${enabled ? 'yes' : 'no'} / ${enabled ? 'enabled' : `skipped (${reason ?? status.skippedReason ?? 'not authenticated'})`}`;
+}
+
+function reportCliSkills(deps: SetupCliDeps, apply: boolean): string[] {
+  const statuses = (deps.detectSkillCliAuth ?? detectSkillCliAuth)();
+  const config = (deps.getUserConfig ?? getUserConfig)();
+  const deny = new Set(config.skills.deny ?? []);
+  const allow = config.skills.allow ?? [];
+  let changed = false;
+  const lines = statuses.map((status) => {
+    const skill = CLI_SKILLS[status.cli];
+    const allowed = allow.length === 0 || allow.some((name) => name.toLowerCase() === skill);
+    if (apply) {
+      if (status.authenticated && allowed && deny.has(skill)) { deny.delete(skill); changed = true; }
+      if (!status.authenticated && !deny.has(skill)) { deny.add(skill); changed = true; }
+    }
+    const enabled = status.authenticated && allowed && !deny.has(skill);
+    return formatCliSkillStatus(status, enabled,
+      status.authenticated && !allowed ? 'excluded by skills.allow' :
+        status.authenticated && !apply && deny.has(skill) ? 'not enabled; run setup to apply' : undefined);
+  });
+  if (apply && changed) (deps.saveUserConfig ?? saveUserConfig)({
+    ...config, skills: { ...config.skills, deny: [...deny] },
+  });
+  return lines;
+}
+
 export function registerSetupCommand(program: Command, deps: SetupCliDeps = {}): void {
   const out = deps.out ?? { log: (value: string) => console.log(value), error: (value: string) => console.error(value) };
   const setExitCode = deps.setExitCode ?? ((code: number) => { process.exitCode = code; });
   const doctorRunner = deps.runDoctor ?? runDoctor;
+  const showCliSkills = (apply: boolean) => {
+    out.log('Setup: CLI skills (public GitHub repository reads remain available without login)');
+    for (const line of reportCliSkills(deps, apply)) out.log(line);
+  };
   const isStdinTty = deps.isStdinTty ?? (() => process.stdin.isTTY === true);
   const prompt = deps.prompt ?? (async (message: string) => {
     const { createInterface } = await import('node:readline/promises');
@@ -161,6 +199,7 @@ export function registerSetupCommand(program: Command, deps: SetupCliDeps = {}):
       const doctor = doctorRunner(deps);
       if (opts.nonInteractive) {
         out.log(formatSetupReport(doctor, setupSteps(deps), true));
+        showCliSkills(false);
         for (const line of recommendedSetup((deps.getUserConfig ?? getUserConfig)())) out.log(line);
         setExitCode(0);
         return;
@@ -183,6 +222,7 @@ export function registerSetupCommand(program: Command, deps: SetupCliDeps = {}):
         }
       }
       out.log(formatSetupReport(doctor, steps, false));
+      showCliSkills(false);
       for (const line of recommendedSetup((deps.getUserConfig ?? getUserConfig)())) out.log(line);
       const accepted = opts.yes || (isStdinTty() && /^(?:y|yes)?$/i.test((await prompt('추천대로 켤까요? [Y/n] '))?.trim() ?? 'n'));
       if (accepted) {
@@ -197,7 +237,9 @@ export function registerSetupCommand(program: Command, deps: SetupCliDeps = {}):
           await doctorProgram.parseAsync([...args], { from: 'user' });
           return exitCode;
         });
-        setExitCode(await runDoctorFix(['doctor', '--fix', '--yes']));
+        const fixCode = await runDoctorFix(['doctor', '--fix', '--yes']);
+        showCliSkills(true);
+        setExitCode(fixCode);
         return;
       }
       setExitCode(0);

package/src/cli/skills-cli.ts

@@ -73,7 +73,23 @@ export function registerConnectCommand(program: Command): void {
 }
 
 export function registerSkillsCommands(program: Command): void {
-  const skills = program.command('skills').description('Check and repair installed skills');
+  const skills = program.command('skills').description('Check, install and repair skills');
+  skills.command('install <pack>')
+    .description('Install a gift skill pack from a code')
+    .option('--code <code>', 'Gift code')
+    .option('--email <address>', 'Email for gift delivery')
+    .option('--agree', 'Agree to email collection and retention')
+    .option('--endpoint <url>', 'Gift API origin (overrides skills.giftEndpoint)')
+    .option('--json', 'Print the install result as JSON')
+    .action(async (pack: string, opts: { code?: string; email?: string; agree?: boolean; endpoint?: string; json?: boolean }) => {
+      const { getUserConfig } = await import('../user-config.js');
+      const { installGiftPack } = await import('../skills/gift-install.js');
+      const result = await installGiftPack({ pack, code: opts.code, email: opts.email, agree: opts.agree,
+        endpoint: opts.endpoint ?? getUserConfig().skills.giftEndpoint });
+      if (opts.json) console.log(JSON.stringify(result));
+      else console.log(result.message);
+      if (!result.ok) process.exitCode = 1;
+    });
   skills.command('sources')
     .description('List every skill folder elanous reads, in order (preset · shared · connected · package)')
     .option('--json', 'JSON output')

package/src/cli/storyboard-cli.ts

@@ -0,0 +1,37 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { parse } from 'yaml';
+import { debug } from '../debug/log.js';
+import { files, lint, render, STORYBOARD_ROOT, type Storyboard } from '../storyboard/storyboard.js';
+
+export function runStoryboard(cmd: 'lint' | 'render', args: string[], json = false): number {
+  const reports: Array<{ file: string; errors: string[]; warnings: string[] }> = [];
+  let errorCount = 0, warningCount = 0;
+  for (const f of files(args)) {
+    const file = relative(STORYBOARD_ROOT, f);
+    let sb: Storyboard | undefined;
+    let errors: string[], warnings: string[];
+    try {
+      sb = parse(readFileSync(f, 'utf8')) as Storyboard;
+      ({ errors, warnings } = lint(sb, file));
+    } catch (cause) {
+      errors = [cause instanceof Error ? cause.message : String(cause)];
+      warnings = [];
+    }
+    reports.push({ file, errors, warnings });
+    errorCount += errors.length;
+    warningCount += warnings.length;
+    if (json) continue;
+    for (const e of errors) console.log(`✗ ${file}: ${e}`);
+    for (const w of warnings) console.log(`⚠ ${file}: ${w}`);
+    if (errors.length || !sb) continue;
+    if (cmd === 'render') {
+      const out = join(STORYBOARD_ROOT, 'docs', 'marketing', `STORYBOARD-${sb.id}-v${sb.version}.md`);
+      writeFileSync(out, render(sb, file) + '\n');
+      console.log(`✓ ${file} → ${relative(STORYBOARD_ROOT, out)}`);
+    } else console.log(`✓ ${file} · v${sb.version} · ${sb.status} · ${sb.kind === 'site' ? `사이트 ${sb.sites?.length ?? 0}` : `샷 ${sb.shots.length}`}`);
+  }
+  if (cmd === 'lint') debug.log('storyboard.lint', 'checked', { files: reports.length, errorCount, warningCount });
+  if (json) console.log(JSON.stringify({ files: reports, errorCount, warningCount }));
+  return errorCount ? 1 : 0;
+}

package/src/cli/test-state-dir-flag.ts

@@ -71,7 +71,8 @@ export function applyTestStateDirFlagFromArgv(): string | undefined {
  *  뒤에만 있어 사람이 부를 입구가 없었고, 그래서 문서 174곳에 수동 주문이 화석으로 남았다.
  *
  *  하는 일: nexus state root ⊕ ELANOUS_STATE_DIR ⊕ config-dir 을 **한 뿌리로** 세우고,
- *  config 사본이 없으면 물질화하며, config 경로가 test 루트 밖이면 **기동을 거부**한다. */
+ *  운영 config 가 있으면 test-safe 사본을 물질화하고, 없으면 격리 기본값을 사용하며,
+ *  config 경로가 test 루트 밖이면 **기동을 거부**한다. */
 export function applyIsolatedRoot(dir: string): void {
   const { setTestStateRoot } = require('../nexus/paths.js') as typeof import('../nexus/paths.js');
   setTestStateRoot(dir);
@@ -98,7 +99,7 @@ export function applyIsolatedRoot(dir: string): void {
       }
       cfgDir.setElanousConfigDir(dir);
     }
-    // config 사본 보장 — 없으면 운영에서 물질화(최초 무마찰), 있으면 drift 경고만
+    // config 사본이 없고 운영 원본이 있으면 물질화하고, 있으면 drift 경고만
     // (자동 덮어쓰기 금지 — 명시적 sync 원칙). 유닛 테스트(NODE_ENV=test)는
     // 실 운영 config/secrets 를 temp 로 복사하지 않도록 sync 스킵.
     if (process.env.NODE_ENV !== 'test') {
@@ -106,8 +107,14 @@ export function applyIsolatedRoot(dir: string): void {
       const { existsSync } = require('node:fs') as typeof import('node:fs');
       const { join } = require('node:path') as typeof import('node:path');
       if (!existsSync(join(dir, 'config.json'))) {
-        const r = sync.syncTestConfig(dir);
-        console.error(`[test-isolation] 운영 config 물질화 → ${r.testConfigPath} (telegram=${r.telegramMode})`);
+        // A fresh build/test environment may have no operating config to copy.
+        // Keep the isolated config root and use the ordinary safe defaults there.
+        if (existsSync(join(sync.prodConfigDir(), 'config.json'))) {
+          const r = sync.syncTestConfig(dir);
+          console.error(`[test-isolation] 운영 config 물질화 → ${r.testConfigPath} (telegram=${r.telegramMode})`);
+        } else {
+          console.error(`[test-isolation] 운영 config 없음 — ${dir} 의 기본 설정 사용`);
+        }
       } else if (sync.isTestConfigStale(dir)) {
         console.error(`[test-isolation] ⚠️ 운영 config 가 테스트 사본보다 최신 — 'elanous config sync-test' 로 갱신 권장`);
       }

package/src/connectors/linear.ts

@@ -122,6 +122,152 @@ export async function fetchLinearIssues({ apiKey, teamKey, labelOrPrefix, since,
   return events.sort((a, b) => PRIORITY_RANK[a.priority ?? 'none'] - PRIORITY_RANK[b.priority ?? 'none']);
 }
 
+export interface LinearProjectIssue {
+  identifier: string;
+  title: string;
+  url: string;
+  state: { name: string; type: string };
+  dueDate: string | null;
+  priority: number;
+  assignee: { name: string } | null;
+  updatedAt: string;
+}
+
+type LinearRequestOptions = { apiKey: string; fetch?: typeof fetch };
+
+async function linearRequest<T>({ apiKey, fetch: fetchFn = fetch }: LinearRequestOptions, query: string, variables: Record<string, unknown>): Promise<T> {
+    let response: Response;
+    try {
+      response = await fetchFn('https://api.linear.app/graphql', {
+        method: 'POST', headers: { Authorization: apiKey, 'Content-Type': 'application/json' },
+        body: JSON.stringify({ query, variables }),
+      });
+    } catch (error) {
+      throw new Error(`Linear GraphQL request failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!response.ok) throw new Error(`Linear GraphQL HTTP ${response.status}`);
+    let body: { data?: T; errors?: Array<{ message?: string }> };
+    try { body = await response.json() as typeof body; }
+    catch { throw new Error('Linear GraphQL invalid JSON response'); }
+    if (body.errors?.length) throw new Error(`Linear GraphQL: ${body.errors.map(e => e.message ?? 'unknown error').join('; ')}`);
+    if (!body.data) throw new Error('Linear GraphQL missing data');
+    return body.data;
+}
+
+/** Shared unique name → project id lookup for COO reads and decision writes. */
+export async function resolveLinearProjectId({ apiKey, project, fetch: fetchFn = fetch }: LinearRequestOptions & { project: string }): Promise<string> {
+  const cursors = new Set<string>();
+  let projectId = project;
+  if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(project)) {
+    const matches: string[] = [];
+    let after: string | null = null;
+    do {
+      const data: { projects?: { nodes?: Array<{ id: string; name: string }>; pageInfo?: { hasNextPage: boolean; endCursor: string | null } } } = await linearRequest({ apiKey, fetch: fetchFn },
+        `query CooProjects($after: String) { projects(first: 100, after: $after) { nodes { id name } pageInfo { hasNextPage endCursor } } }`, { after });
+      if (!Array.isArray(data.projects?.nodes)) throw new Error('Linear GraphQL missing projects');
+      for (const candidate of data.projects.nodes) if (candidate.name === project) matches.push(candidate.id);
+      const page = data.projects.pageInfo;
+      if (page?.hasNextPage && (!page.endCursor || cursors.has(page.endCursor))) throw new Error('Linear GraphQL pagination cursor missing or repeated');
+      after = page?.hasNextPage ? page.endCursor : null;
+      if (after) cursors.add(after);
+    } while (after);
+    if (matches.length > 1) throw new Error('프로젝트 이름이 여럿과 맞습니다');
+    if (!matches.length) throw new Error('프로젝트 이름과 맞는 항목이 없습니다');
+    projectId = matches[0]!;
+  }
+  return projectId;
+}
+
+/** Read-only project lookup. A name is resolved uniquely before querying its issues. */
+export async function fetchLinearProjectIssues({ apiKey, project, includeDone = false, fetch: fetchFn = fetch }: {
+  apiKey: string; project: string; includeDone?: boolean; fetch?: typeof fetch;
+}): Promise<LinearProjectIssue[] & { truncated: boolean }> {
+  const projectId = await resolveLinearProjectId({ apiKey, project, fetch: fetchFn });
+  const issues: LinearProjectIssue[] = [];
+  const cursors = new Set<string>();
+  let after: string | null = null;
+  do {
+    const stateFilter = includeDone ? '' : ', state: { type: { nin: ["completed", "canceled"] } }';
+    const data: { issues?: { nodes?: LinearProjectIssue[]; pageInfo?: { hasNextPage: boolean; endCursor: string | null } } } = await linearRequest({ apiKey, fetch: fetchFn },
+      `query CooProjectIssues($projectId: ID!, $after: String, $first: Int!) {
+        issues(filter: { project: { id: { eq: $projectId } }${stateFilter} }, first: $first, after: $after) {
+          nodes { identifier title url state { name type } dueDate priority assignee { name } updatedAt }
+          pageInfo { hasNextPage endCursor }
+        }
+      }`, { projectId, after, first: Math.min(100, 250 - issues.length) });
+    if (!Array.isArray(data.issues?.nodes)) throw new Error('Linear GraphQL missing issues');
+    for (const node of data.issues.nodes) {
+      if (!includeDone && (node.state?.type === 'completed' || node.state?.type === 'canceled')) continue;
+      if (issues.length < 250) issues.push(node);
+    }
+    const page = data.issues.pageInfo;
+    if (page?.hasNextPage && (!page.endCursor || cursors.has(page.endCursor))) throw new Error('Linear GraphQL pagination cursor missing or repeated');
+    after = page?.hasNextPage ? page.endCursor : null;
+    if (after) cursors.add(after);
+  } while (after && issues.length < 250);
+  Object.defineProperty(issues, 'truncated', { value: after !== null, enumerable: false });
+  return issues as LinearProjectIssue[] & { truncated: boolean };
+}
+
+/** Find a previously created decision issue after a crash between Linear creation and the local rename. */
+export async function findLinearDecisionIssue({ apiKey, projectId, decisionId, fetch: fetchFn = fetch }: LinearRequestOptions & { projectId: string; decisionId: string }): Promise<string | null> {
+  const cursors = new Set<string>();
+  let after: string | null = null;
+  let match: string | null = null;
+  do {
+    const data: { issues?: { nodes?: Array<{ id: string; description: string | null }>; pageInfo?: { hasNextPage: boolean; endCursor: string | null } } } = await linearRequest({ apiKey, fetch: fetchFn },
+      'query DecisionIssue($projectId: ID!, $decisionId: String!, $after: String) { issues(filter: { project: { id: { eq: $projectId } }, description: { contains: $decisionId } }, first: 100, after: $after) { nodes { id description } pageInfo { hasNextPage endCursor } } }',
+      { projectId, decisionId, after });
+    if (!Array.isArray(data.issues?.nodes)) throw new Error('Linear GraphQL missing issues');
+    for (const node of data.issues.nodes) {
+      if (!node.description?.split('\n').includes(`결정 id: ${decisionId}`)) continue;
+      if (match) throw new Error('Linear decision issue duplicated');
+      match = node.id;
+    }
+    const page = data.issues.pageInfo;
+    if (page?.hasNextPage && (!page.endCursor || cursors.has(page.endCursor))) throw new Error('Linear GraphQL pagination cursor missing or repeated');
+    after = page?.hasNextPage ? page.endCursor : null;
+    if (after) cursors.add(after);
+  } while (after);
+  return match;
+}
+
+/** Create in the COO project; Linear requires a team from that project for issueCreate. */
+export async function createLinearIssue({ apiKey, projectId, title, description, dueDate, fetch: fetchFn = fetch }: LinearRequestOptions & {
+  projectId: string; title: string; description: string; dueDate?: string;
+}): Promise<string> {
+  const data = await linearRequest<{ project?: { teams?: { nodes?: Array<{ id: string }> } } }>({ apiKey, fetch: fetchFn },
+    'query DecisionProjectTeam($id: String!) { project(id: $id) { teams { nodes { id } } } }', { id: projectId });
+  const teams = data.project?.teams?.nodes;
+  if (!teams?.[0]?.id) throw new Error('Linear project has no team');
+  const created = await linearRequest<{ issueCreate?: { success?: boolean; issue?: { id?: string } } }>({ apiKey, fetch: fetchFn },
+    'mutation DecisionIssueCreate($input: IssueCreateInput!) { issueCreate(input: $input) { success issue { id } } }',
+    { input: { teamId: teams[0].id, projectId, title, description, ...(dueDate ? { dueDate } : {}) } });
+  const id = created.issueCreate?.issue?.id;
+  if (!created.issueCreate?.success || !id) throw new Error('Linear issueCreate did not return an issue id');
+  return id;
+}
+
+export async function commentLinearIssue({ apiKey, issueId, body, fetch: fetchFn = fetch }: LinearRequestOptions & { issueId: string; body: string }): Promise<void> {
+  const data = await linearRequest<{ commentCreate?: { success?: boolean; comment?: { id?: string } } }>({ apiKey, fetch: fetchFn },
+    'mutation DecisionComment($input: CommentCreateInput!) { commentCreate(input: $input) { success comment { id } } }',
+    { input: { issueId, body } });
+  if (!data.commentCreate?.success || !data.commentCreate.comment?.id) throw new Error('Linear commentCreate failed');
+}
+
+export async function moveLinearIssueToStateType({ apiKey, issueId, type, fetch: fetchFn = fetch }: LinearRequestOptions & {
+  issueId: string; type: 'completed' | 'canceled';
+}): Promise<void> {
+  const data = await linearRequest<{ issue?: { team?: { states?: { nodes?: Array<{ id: string; type: string }> } } } }>({ apiKey, fetch: fetchFn },
+    'query DecisionIssueStates($id: String!) { issue(id: $id) { team { states { nodes { id type } } } } }', { id: issueId });
+  const state = data.issue?.team?.states?.nodes?.find(node => node.type === type);
+  if (!state?.id) throw new Error(`Linear team workflow state not found: ${type}`);
+  const updated = await linearRequest<{ issueUpdate?: { success?: boolean } }>({ apiKey, fetch: fetchFn },
+    'mutation DecisionIssueClose($id: String!, $input: IssueUpdateInput!) { issueUpdate(id: $id, input: $input) { success } }',
+    { id: issueId, input: { stateId: state.id } });
+  if (!updated.issueUpdate?.success) throw new Error('Linear issueUpdate failed');
+}
+
 export function toTaskRequest(event: ExternalTaskEvent): {
   title: string; description: string; priority: 'high' | 'medium' | 'low';
   external: { provider: 'linear'; ref: string; url?: string; team?: string };

package/src/context-bus/claude-hooks-install.ts

@@ -0,0 +1,10 @@
+import { resolve } from 'node:path';
+
+/** Render a Claude Code settings fragment; never touch the user's settings file. */
+export function claudeHooksSettings(repoRoot: string): string {
+  const command = (file: string) => `bash '${resolve(repoRoot, 'scripts/context-hooks', file).replaceAll("'", "'\\''")}'`;
+  return JSON.stringify({ hooks: {
+    Stop: [{ hooks: [{ type: 'command', command: command('claude-stop.sh') }] }],
+    PostToolUse: [{ hooks: [{ type: 'command', command: command('post-tool-use.sh') }] }],
+  } }, null, 2);
+}