elanous 0.2.9 → 0.2.11

package/scripts/release-loop/version-node.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 import { spawnSync } from 'node:child_process';
-import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join, resolve } from 'node:path';
 import { emitNodeResult } from './node-verdict.js';
@@ -49,19 +49,64 @@ function fetchMain(repo: string): void {
   }
 }
 
-function versionAt(repo: string): string {
-  const pkg = JSON.parse(git(repo, 'show', 'origin/main:package.json')) as { version?: unknown };
-  if (typeof pkg.version !== 'string') throw new Error('origin/main package.json has no version');
+function versionAt(repo: string, ref = 'origin/main'): string {
+  const pkg = JSON.parse(git(repo, 'show', `${ref}:package.json`)) as { version?: unknown };
+  if (typeof pkg.version !== 'string') throw new Error(`${ref} package.json has no version`);
   return pkg.version;
 }
 
-function landing(repo: string, kind: Kind, releaseVersion: string): Output {
+/** next.md list lines (trimmed) present at the cut commit, or null when the cut or its next.md cannot be read. */
+function shippedNextMdLines(repo: string, cut: string | undefined): { lines: Set<string> } | { reason: string } {
+  if (!cut) return { reason: 'cut-unknown' };
+  // git-spawn-allow: reads the cut commit's next.md to learn which lines that release already carried.
+  const shown = spawnSync('git', ['show', `${cut}:release/next.md`], { cwd: repo, encoding: 'utf8', maxBuffer: 16 * 1024 * 1024 });
+  if (shown.status !== 0 || shown.error) return { reason: 'cut-next-md-unreadable' };
+  return { lines: new Set(shown.stdout.split('\n').map((line) => line.trim()).filter((line) => line.startsWith('- '))) };
+}
+
+function landing(repo: string, kind: Kind, releaseVersion: string, cut?: string, cutCommit?: string): Output {
   const target = kind === 'release' ? releaseVersion : nextDevVersion(releaseVersion);
   const source = kind === 'release' ? `${releaseVersion}-dev.N` : releaseVersion;
   fetchMain(repo);
+  if (kind === 'release' && cutCommit !== undefined) {
+    if (!/^[0-9a-f]{7,40}$/i.test(cutCommit)) throw new Error(`invalid cut commit SHA: ${cutCommit}`);
+    const local = spawnSync('git', ['rev-parse', '--verify', `${cutCommit}^{commit}`], { cwd: repo, encoding: 'utf8' });
+    let chosen = local.status === 0 ? local.stdout.trim() : '';
+    const onMain = chosen ? spawnSync('git', ['merge-base', '--is-ancestor', chosen, 'origin/main'], { cwd: repo }) : null;
+    if (onMain && onMain.status !== 0 && onMain.status !== 1) throw new Error(`git merge-base failed: ${onMain.error || onMain.stderr || 'unknown'}`);
+    if (onMain?.status !== 0) {
+      const remote = git(repo, 'ls-remote', '--heads', 'origin', `refs/heads/release/${releaseVersion}`);
+      const branchTip = remote.split(/\s+/)[0];
+      if (!chosen && branchTip?.toLowerCase().startsWith(cutCommit.toLowerCase())) {
+        git(repo, 'fetch', 'origin', `refs/heads/release/${releaseVersion}`);
+        chosen = git(repo, 'rev-parse', '--verify', `${cutCommit}^{commit}`);
+      }
+      if (!chosen) chosen = git(repo, 'rev-parse', '--verify', `${cutCommit}^{commit}`);
+      if (branchTip !== chosen) {
+        throw new Error(`cut commit ${chosen} is neither an ancestor of origin/main nor the tip of release/${releaseVersion}`);
+      }
+    }
+    const current = versionAt(repo, chosen);
+    if (current !== target) throw new Error(`cut commit ${chosen} package.json version ${current} is not ${target}`);
+    debug.log('release-loop.cut', 'chosen', { version: releaseVersion, source: 'cut-commit', commit: chosen });
+    return { outcome: 'ok', kind, version: target, commit: chosen, pr: null };
+  }
   const current = versionAt(repo);
   const before = git(repo, 'rev-parse', 'origin/main');
-  if (current === target) return { outcome: 'ok', kind, version: target, commit: before, pr: null };
+  if (current === target) {
+    if (kind === 'release') debug.log('release-loop.cut', 'chosen', { version: releaseVersion, source: 'main', commit: before });
+    return { outcome: 'ok', kind, version: target, commit: before, pr: null };
+  }
+  // An older chosen cut may finish after main has already advanced to the next stable release.
+  // Keep that newer main untouched; a -dev.N mismatch is not evidence of a later release.
+  if (kind === 'dev-bump' && /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/.test(current)) {
+    const mainParts = current.split('.').map(BigInt);
+    const nextParts = target.slice(0, -'-dev.0'.length).split('.').map(BigInt);
+    const firstDifference = mainParts.findIndex((part, index) => part !== nextParts[index]);
+    if (firstDifference === -1 || mainParts[firstDifference]! > nextParts[firstDifference]!) {
+      return { outcome: 'ok', kind, version: current, commit: before, pr: null };
+    }
+  }
   if (kind === 'release' ? !new RegExp(`^${releaseVersion.replaceAll('.', '\\.')}\\-dev\\.(0|[1-9][0-9]*)$`).test(current) : current !== source) {
     throw new Error(`origin/main version ${current} is not ${source} (target ${target})`);
   }
@@ -75,6 +120,13 @@ function landing(repo: string, kind: Kind, releaseVersion: string): Output {
     const old = `"version": "${current}"`;
     if (!text.includes(old)) throw new Error(`package.json version field not found: ${current}`);
     writeFileSync(path, text.replace(old, `"version": "${target}"`));
+    const serverPath = join(worktree, 'server.json');
+    if (existsSync(serverPath)) {
+      const server = JSON.parse(readFileSync(serverPath, 'utf8')) as { version: string; packages: Array<{ version: string }> };
+      server.version = target;
+      server.packages[0]!.version = target;
+      writeFileSync(serverPath, `${JSON.stringify(server, null, 2)}\n`);
+    }
     const lockPath = join(worktree, 'bun.lock');
     const lock = readFileSync(lockPath, 'utf8');
     const root = /"workspaces"\s*:\s*\{\s*""\s*:\s*\{([\s\S]*?)(?=\s*"(?:dependencies|devDependencies|optionalDependencies)"\s*:)/.exec(lock);
@@ -85,6 +137,41 @@ function landing(repo: string, kind: Kind, releaseVersion: string): Output {
       writeFileSync(lockPath, lock.replace(root[0], root[0].replace(lockedVersion[0], `"version": "${target}"`)));
     }
     run('bun', ['install', '--frozen-lockfile'], worktree);
+    if (kind === 'dev-bump') {
+      const nextPath = join(worktree, 'release', 'next.md');
+      if (existsSync(nextPath)) {
+        const original = readFileSync(nextPath, 'utf8');
+        // OP 10-02: dev-bump runs on the then-current main, not the cut. Lines landed after the cut are not in this
+        // release and #22745 carries only lines added by the next cut range — so remove only lines the cut carried.
+        const shipped = shippedNextMdLines(repo, cut);
+        if ('reason' in shipped) {
+          console.error(`⚠ next.md 비우기 건너뜀(${shipped.reason}) — 컷 커밋의 next.md 를 못 읽어 «나간 줄»을 증명할 수 없다`);
+          debug.log('release-loop.notes', 'next-md-reset-skipped', { reason: shipped.reason }, { level: 'warn' });
+        }
+        const shippedLines = 'lines' in shipped ? shipped.lines : new Set<string>();
+        let keptAfterCut = 0;
+        let removed = 0;
+        let keptLater = 0;
+        let inSection = false;
+        let droppingItem = false;
+        // Only shipped list items (and their indented continuation lines) go; headings, prose, `###` subheadings and
+        // `Target: later` items stay — the reviewer's «preserve everything but the released lines».
+        const reset = original.split(/(?<=\n)/).filter((line) => {
+          if (/^## /.test(line)) { inSection = true; droppingItem = false; return true; }
+          if (!inSection) return true;
+          if (/^- /.test(line)) {
+            if (/\bTarget:\s*later(?:\.|\s|$)/i.test(line)) { keptLater++; droppingItem = false; return true; }
+            if (!shippedLines.has(line.trim())) { keptAfterCut++; droppingItem = false; return true; }
+            removed++; droppingItem = true; return false;
+          }
+          if (droppingItem && /^[ \t]+\S/.test(line)) return false;
+          droppingItem = false;
+          return true;
+        }).join('');
+        if (reset !== original) writeFileSync(nextPath, reset);
+        debug.log('release-loop.notes', 'next-md-reset', { removed, keptLater, keptAfterCut });
+      }
+    }
     const title = kind === 'release' ? `release: ${target}` : `version: ${target}`;
     const land = spawnSync('bun', ['bin/elanous.mjs', 'pr', 'land', '--commit-message', title, '--title', title, '--body', `Set package.json version to ${target}.`], {
       cwd: worktree, encoding: 'utf8', maxBuffer: 16 * 1024 * 1024,
@@ -99,6 +186,7 @@ function landing(repo: string, kind: Kind, releaseVersion: string): Output {
     const commit = git(repo, 'rev-parse', 'origin/main');
     if (versionAt(repo) !== target || commit === before) throw new Error(`origin/main did not advance to ${target} after merge`);
     const output: Output = { outcome: 'ok', kind, version: target, commit, pr: pr ? Number(pr[1]) : null };
+    if (kind === 'release') debug.log('release-loop.cut', 'chosen', { version: releaseVersion, source: 'main', commit });
     git(repo, 'worktree', 'remove', '--force', worktree);
     rmSync(temp, { recursive: true, force: true });
     return output;
@@ -111,24 +199,35 @@ function landing(repo: string, kind: Kind, releaseVersion: string): Output {
 function main(args: string[] = process.argv.slice(2), repo = process.cwd()): Output {
   let kind: Kind | null = null;
   let version: string | null = null;
+  let cut: string | undefined;
+  let cutCommit: string | undefined;
   try {
-    if (args[0] !== 'release' && args[0] !== 'dev-bump') throw new Error('usage: version-node.ts <release|dev-bump> [--version <v>] --json');
+    if (args[0] !== 'release' && args[0] !== 'dev-bump') throw new Error('usage: version-node.ts <release|dev-bump> [--version <v>] [--cut <sha>] [--cut-commit <sha>] --json');
     kind = args[0];
     for (let i = 1; i < args.length; i++) {
       if (args[i] === '--json') continue;
       if (args[i] === '--version' && args[i + 1]) { version = args[++i]!; continue; }
+      if (args[i] === '--cut' && args[i + 1]) { cut = args[++i]!; continue; }
+      if (args[i] === '--cut-commit' && args[i + 1]) { cutCommit = args[++i]!; continue; }
       throw new Error(`unknown or incomplete argument: ${args[i]}`);
     }
-    if (!version) {
-      if (process.env.ELANOUS_GRAPH_CONTEXT) {
-        const location = process.env.ELANOUS_GRAPH_CONTEXT;
-        const context = JSON.parse(location.trimStart().startsWith('{') ? location : readFileSync(location, 'utf8')) as { input?: { version?: unknown } };
-        if (typeof context.input?.version === 'string') version = context.input.version;
+    if (process.env.ELANOUS_GRAPH_CONTEXT) {
+      const location = process.env.ELANOUS_GRAPH_CONTEXT;
+      const context = JSON.parse(location.trimStart().startsWith('{') ? location : readFileSync(location, 'utf8')) as {
+        input?: { version?: unknown; cutCommit?: unknown }; outputs?: Record<string, { commit?: unknown } | undefined> };
+      if (!version && typeof context.input?.version === 'string') version = context.input.version;
+      if (kind === 'release' && cutCommit === undefined && context.input?.cutCommit !== undefined) {
+        if (typeof context.input.cutCommit !== 'string') throw new Error('cutCommit must be a commit SHA');
+        cutCommit = context.input.cutCommit;
       }
+      // The cut = the commit version-release landed (what cutoff and the gate measured).
+      const releasedCommit = context.outputs?.['version-release']?.commit;
+      if (!cut && typeof releasedCommit === 'string' && releasedCommit) cut = releasedCommit;
     }
     if (!version) throw new Error('version required (--version or ELANOUS_GRAPH_CONTEXT.input.version)');
     nextDevVersion(version);
-    return landing(resolve(repo), kind, version);
+    if (kind === 'dev-bump' && cutCommit !== undefined) throw new Error('--cut-commit is only valid for release');
+    return landing(resolve(repo), kind, version, cut, cutCommit);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     const worktree = /\[worktree: ([^\]]+)\]$/.exec(message)?.[1];

package/scripts/repo-watch-cycle.ts

@@ -25,7 +25,7 @@ function log(s: string): void {
 
 const results = runRepoWatchCycle({
   // 흡수 제안 리포트 발송(report 채널 · 야간무음 게이트 · fail-soft).
-  notify: (report) => { try { log(`발송 ${sendOutbound(report, 'report') ? 'OK' : '실패'}`); } catch (e) { log(`발송 오류: ${e instanceof Error ? e.message : String(e)}`); } },
+  notify: (report) => { try { log(`발송 ${sendOutbound(report, 'ops-report') ? 'OK' : '실패'}`); } catch (e) { log(`발송 오류: ${e instanceof Error ? e.message : String(e)}`); } },
   // 자율행동 회상 기록(loop=autopilot).
   record: (input) => { recordAutonomousActionSafe({ loop: 'autopilot', ...input }); },
 });

package/scripts/retro-cycle.ts

@@ -120,11 +120,11 @@ const report = await runRetroCycle({
     const p = join(REPORT_DIR, filename); writeFileSync(p, md);
     // ★ B5: --collect-only 면 발송 억제(회고 리포트 영속·resolution/발굴 입력·발송만 skip).
     if (process.argv.includes('--collect-only')) log(`collect-only — 회고 리포트 영속·발송 skip`);
-    else try { log(`회고 리포트 발송 ${sendOutbound(md, 'report') ? 'OK' : '실패'}`); } catch (e) { log(`발송 오류: ${e instanceof Error ? e.message : String(e)}`); }
+    else try { log(`회고 리포트 발송 ${sendOutbound(md, 'ops-report') ? 'OK' : '실패'}`); } catch (e) { log(`발송 오류: ${e instanceof Error ? e.message : String(e)}`); }
     return p;
   },
   // HITL 승인 요청 — 텔레그램 alert(collect-only 면 로그만).
-  notify: (t) => { log(`[HITL] ${t.replace(/\n/g, ' ')}`); if (!process.argv.includes('--collect-only')) try { sendOutbound(t, 'alert'); } catch { /* fail-soft */ } },
+  notify: (t) => { log(`[HITL] ${t.replace(/\n/g, ' ')}`); if (!process.argv.includes('--collect-only')) try { sendOutbound(t, 'ops-alert'); } catch { /* fail-soft */ } },
 }, period);
 
 log(`retro ${period}: report=${report.reportPath} · 제안=${report.hasProposal ? report.proposalId : '없음'}`);

package/scripts/schedule-health-report.ts

@@ -96,7 +96,7 @@ function main(): void {
       console.log(msg);
       return;
     }
-    const ok = sendOutbound(msg, 'alert');
+    const ok = sendOutbound(msg, 'ops-alert');
     console.log(`[schedule-health] ${mode}: ${ok ? '발송' : '발송 실패'} — 밀림 ${health.stale.length}·실패 ${health.errored.length}`);
   } finally {
     db.close();

package/scripts/signal-digest-cycle.ts

@@ -13,8 +13,7 @@ import { appendFileSync } from 'node:fs';
 import { SignalPool } from '../src/domains/signal-pool.js';
 import { runDigest, runCommunityBuzzDigest } from '../src/domains/signal-router.js';
 import { sendOutbound } from '../src/domains/outbound-alert.js';
-import { sendReportPhotoBuffer } from '../src/telegram-report.js';
-import { getUserConfig } from '../src/user-config.js';
+import { createDigestPhotoSender } from './signal-digest-photo.js';
 import { ensureCronNodePath } from '../src/domains/cron-path.js';
 import { unknownCronFlag } from '../src/domains/cron-flag-contract.js';
 
@@ -35,14 +34,10 @@ function log(msg: string): void {
   try { appendFileSync(LOG, line + '\n'); } catch { /* fail-soft */ }
 }
 
-async function sendDigestPhoto(png: Buffer, opts?: { caption?: string }): Promise<boolean> {
-  return sendReportPhotoBuffer(getUserConfig(), png, opts);
-}
-
 async function main(): Promise<void> {
   const pool = new SignalPool();
   try {
-    const d = await runDigest(pool, LIVE ? { send: sendOutbound, sendPhoto: sendDigestPhoto } : {});
+    const d = await runDigest(pool, LIVE ? { send: sendOutbound, sendPhoto: createDigestPhotoSender() } : {});
     log(`[${d.mode}] 다이제스트 대기 ${d.count} · 발송 ${d.sent}`);
     if (!LIVE && d.count > 0) {
       log(`  ▶ [digest shadow]\n${d.preview}`);

package/scripts/signal-digest-photo.ts

@@ -0,0 +1,11 @@
+import type { UserConfig } from '../src/user-config.js';
+import { getUserConfig } from '../src/user-config.js';
+import { sendReportPhotoBuffer } from '../src/telegram-report.js';
+
+/** The callback passed to runDigest for trading signal images. */
+export function createDigestPhotoSender(
+  config: () => UserConfig = getUserConfig,
+  sendPhoto: typeof sendReportPhotoBuffer = sendReportPhotoBuffer,
+): (png: Buffer, opts?: { caption?: string }) => Promise<boolean> {
+  return (png, opts) => sendPhoto(config(), png, { ...opts, kind: 'digest' });
+}

package/scripts/storyboard/storyboard.ts

@@ -1,167 +1,11 @@
 #!/usr/bin/env bun
-// 스토리보드 정본(storyboards/<kind>/<id>.yaml) — 검사 ⊕ MD 뽑기 (대표 10-01 23:0x · OP 형식 결정 = YAML 정본 ⊕ 스키마 ⊕ 생성 MD).
-//   bun scripts/storyboard/storyboard.ts lint [파일…]     스키마 필수 칸 · 시간 겹침 · 화면 문구 출처 · 승인본 규칙
-//   bun scripts/storyboard/storyboard.ts render [파일…]   내부 문서 `STORYBOARD-<id>-v<version>` 를 다시 쓴다(손으로 안 고친다)
-// 인자가 없으면 storyboards/ 아래 전부. lint 는 오류가 있으면 rc 1, 경고만이면 rc 0.
-import { readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs';
-import { join, relative, resolve } from 'node:path';
-import { parse } from 'yaml';
-
-const ROOT = resolve(import.meta.dir, '../..');
-const DIR = join(ROOT, 'storyboards');
-
-type Text = { text: string; source: string; ref?: string };
-type Shot = {
-  id: string; t: [number, number]; stage: string; layer?: string; persona?: string; purpose: string; subject?: string; action?: string;
-  camera?: { move?: string; lens_mm?: number; angle?: string; framing?: string }; lighting?: string; color?: string;
-  transition_in?: { type: string; intent: string }; on_screen_text?: Text[]; audio?: { vo?: string; sfx?: string; bgm?: string };
-  generation?: { tool: string; model?: string; prompt?: string; asset?: string }; real_or_staged: string; state: string; notes?: string;
-};
-/** kind: site — a site's page structure, menu and copy draft, planned like a storyboard (SITE2 · 10-02). */
-type Section = { id: string; title: string; purpose: string; change: string; copy?: Text[]; notes?: string };
-type Site = { domain: string; role: string; preview?: string; branch?: string; nav: Array<{ label: string; href: string }>; pages: Array<{ path: string; sections: Section[] }> };
-export type Storyboard = {
-  id: string; kind: string; title: string; version: number; status: string; approved?: { by: string; at: string; note?: string } | null;
-  supersedes?: string; owner: string; directive?: string; format: { aspects: string[]; duration_s: number; fps?: number; loop?: boolean; surface?: string };
-  scqa?: { s?: string; c?: string; q?: string; a?: string }; principles?: string[]; layers?: Record<string, string>; shots: Shot[]; sites?: Site[];
-  references?: string[]; open_questions?: string[];
-};
-
-const KINDS = ['teaser', 'site-hero', 'event-demo', 'persona-scene', 'explainer', 'ad', 'site'];
-const CHANGES = ['keep', 'move', 'new', 'replace', 'remove'];
-const STAGES = ['hook', 'buildup', 'climax', 'transition', 'end', 'loop'];
-const SOURCES = ['real-ui', 'real-cli', 'real-output', 'copy', 'example'];
-
-export function lint(sb: Storyboard, file = ''): { errors: string[]; warnings: string[] } {
-  const errors: string[] = [], warnings: string[] = [];
-  const need = (cond: unknown, msg: string) => { if (!cond) errors.push(msg); };
-  need(/^[a-z0-9][a-z0-9-]{2,80}$/.test(sb.id ?? ''), 'id: 소문자·숫자·하이픈 3~80자');
-  need(KINDS.includes(sb.kind), `kind: ${KINDS.join('|')}`);
-  need(Number.isInteger(sb.version) && sb.version >= 1, 'version: 1 이상 정수');
-  need(['draft', 'approved', 'superseded'].includes(sb.status), 'status: draft|approved|superseded');
-  need(sb.owner, 'owner 필요');
-  if (sb.status === 'approved') need(sb.approved?.by && sb.approved?.at, '승인본은 approved.by·at 필요');
-  if (file && sb.kind && !file.includes(`/${sb.kind}/`)) errors.push(`파일 위치가 kind(${sb.kind}) 폴더가 아니다`);
-  if (sb.kind === 'site') return lintSite(sb, errors, warnings);
-  need(sb.format?.aspects?.length && sb.format.duration_s > 0, 'format.aspects ⊕ duration_s 필요');
-  if (!Array.isArray(sb.shots) || !sb.shots.length) { errors.push('shots 가 비었다'); return { errors, warnings }; }
-  const ids = new Set<string>();
-  sb.shots.forEach((s, i) => {
-    const at = `shots[${i}](${s.id ?? '?'})`;
-    need(s.id && !ids.has(s.id), `${at}: id 없음·중복`); ids.add(s.id);
-    need(Array.isArray(s.t) && s.t.length === 2 && s.t[0] < s.t[1], `${at}: t = [시작, 끝] 이고 시작 < 끝`);
-    need(STAGES.includes(s.stage), `${at}: stage ${STAGES.join('|')}`);
-    need(s.purpose, `${at}: purpose(이 비트의 한 가지) 필요`);
-    need(['real', 'staged', 'composite'].includes(s.real_or_staged), `${at}: real_or_staged 필요`);
-    need(['planned', 'shot', 'approved'].includes(s.state), `${at}: state planned|shot|approved`);
-    if (s.transition_in && !s.transition_in.intent) errors.push(`${at}: 전환에는 의도 한 줄(«그냥 컷»은 설계가 아니다)`);
-    for (const txt of s.on_screen_text ?? []) {
-      need(SOURCES.includes(txt.source), `${at}: 화면 문구 «${txt.text}» 의 source 가 ${SOURCES.join('|')} 가 아니다`);
-      if (txt.source?.startsWith('real-') && !txt.ref) warnings.push(`${at}: 실제 문면 «${txt.text}» 에 ref(출처) 가 없다`);
-      if (/\d/.test(txt.text) && txt.source === 'copy') warnings.push(`${at}: 마케팅 문구에 숫자 «${txt.text}» — 실측 근거나 «example» 로`);
-    }
-    if (s.generation?.tool === 'higgsfield' && !s.generation.prompt) warnings.push(`${at}: 힉스필드 샷에 prompt 가 없다`);
-    if (s.real_or_staged !== 'real' && !/연출/.test(JSON.stringify(sb))) warnings.push(`${at}: 연출 샷이 있는데 문서 어디에도 «연출 장면» 표기가 없다`);
-  });
-  const end = Math.max(...sb.shots.map((s) => s.t?.[1] ?? 0));
-  if (sb.format?.duration_s && Math.abs(end - sb.format.duration_s) > 0.5) warnings.push(`마지막 샷 끝(${end}s) ≠ format.duration_s(${sb.format.duration_s}s)`);
-  return { errors, warnings };
-}
-
-/** A site plan has pages instead of shots: every section says why it is there and what changes; copy names its source. */
-function lintSite(sb: Storyboard, errors: string[], warnings: string[]): { errors: string[]; warnings: string[] } {
-  if (!Array.isArray(sb.sites) || !sb.sites.length) { errors.push('site 종류는 sites 가 필요하다'); return { errors, warnings }; }
-  for (const site of sb.sites) {
-    const at = `sites(${site.domain ?? '?'})`;
-    if (!site.domain || !site.role) errors.push(`${at}: domain ⊕ role(이 사이트가 맡는 것) 필요`);
-    if (!site.nav?.length) errors.push(`${at}: nav(메뉴) 필요`);
-    if (!site.pages?.length) errors.push(`${at}: pages 필요`);
-    if (!site.preview) warnings.push(`${at}: preview(미리보기 주소) 없음`);
-    const ids = new Set<string>();
-    for (const page of site.pages ?? []) for (const sec of page.sections ?? []) {
-      const where = `${at}${page.path} #${sec.id ?? '?'}`;
-      if (!sec.id || ids.has(`${page.path}#${sec.id}`)) errors.push(`${where}: id 없음·중복`);
-      ids.add(`${page.path}#${sec.id}`);
-      if (!sec.purpose) errors.push(`${where}: purpose(이 칸이 하는 한 가지) 필요`);
-      if (!CHANGES.includes(sec.change)) errors.push(`${where}: change ${CHANGES.join('|')}`);
-      for (const txt of sec.copy ?? []) {
-        if (!SOURCES.includes(txt.source)) errors.push(`${where}: 문구 «${txt.text}» 의 source 가 ${SOURCES.join('|')} 가 아니다`);
-        if (/\d/.test(txt.text) && txt.source === 'copy' && !txt.ref) warnings.push(`${where}: 마케팅 문구에 숫자 «${txt.text}» — ref(실측 근거) 를 단다`);
-      }
-    }
-  }
-  return { errors, warnings };
-}
-
-function renderSites(sb: Storyboard): string[] {
-  return (sb.sites ?? []).flatMap((site) => [
-    `## ${site.domain} — ${site.role}`, '',
-    ...(site.preview ? [`- 미리보기: ${site.preview}${site.branch ? ` (가지 \`${site.branch}\`)` : ''}`] : []),
-    `- 메뉴: ${site.nav.map((n) => `${n.label}(${n.href})`).join(' · ')}`, '',
-    ...site.pages.flatMap((page) => [
-      `### ${page.path}`, '', '| # | 칸 | 제목 | 목적 | 바뀜 | 문구(출처) | 메모 |', '|---|---|---|---|---|---|---|',
-      ...page.sections.map((sec, i) => `| ${i + 1} | ${md(sec.id)} | ${md(sec.title)} | ${md(sec.purpose)} | ${sec.change} | ${md((sec.copy ?? []).map((x) => `«${x.text}»(${x.source}${x.ref ? ` · ${x.ref}` : ''})`).join(' / '))} | ${md(sec.notes)} |`),
-      '',
-    ]),
-  ]);
-}
-
-const md = (v: unknown) => String(v ?? '').replace(/\|/g, '\\|').replace(/\n+/g, ' ');
-export function render(sb: Storyboard, file: string): string {
-  const head = [
-    `# STORYBOARD — ${sb.title} (v${sb.version} · ${sb.status}${sb.approved ? ` · 승인 ${sb.approved.by} ${sb.approved.at}` : ''})`,
-    '',
-    `> ⛔ 자동 생성 — 손으로 고치지 않는다. 정본 = \`${file}\` · 다시 뽑기 = \`bun scripts/storyboard/storyboard.ts render ${file}\`.`,
-    `> 종류 ${sb.kind} · 소유 ${sb.owner}${sb.format ? ` · ${sb.format.aspects.join(' · ')} · ${sb.format.duration_s}초${sb.format.loop ? ' · 반복' : ''}${sb.format.surface ? ` · ${sb.format.surface}` : ''}` : ''}${sb.supersedes ? ` · 앞 판 ${sb.supersedes}` : ''}`,
-    ...(sb.directive ? [`> 지시: ${sb.directive}`] : []),
-    '',
-  ];
-  const scqa = sb.scqa ? ['## SCQA', ...(['s', 'c', 'q', 'a'] as const).filter((k) => sb.scqa?.[k]).map((k) => `- **${k.toUpperCase()}** — ${sb.scqa![k]}`), ''] : [];
-  const pr = sb.principles?.length ? ['## 원칙', ...sb.principles.map((p, i) => `${i + 1}. ${p}`), ''] : [];
-  const layers = sb.layers ? ['## 층', ...Object.entries(sb.layers).map(([k, v]) => `- **${k}** — ${v}`), ''] : [];
-  const table = sb.kind === 'site' ? renderSites(sb) : [
-    '## 샷 구조표',
-    '| # | 초 | 단계 | 층·인물 | 목적 | 화면(피사체·행동) | 카메라 | 빛·색 | 전환(의도) | 화면 문구(출처) | 소리 | 만들기 | 실물/연출 · 상태 |',
-    '|---|---|---|---|---|---|---|---|---|---|---|---|---|',
-    ...sb.shots.map((s) => `| ${md(s.id)} | ${s.t[0]}–${s.t[1]} | ${s.stage} | ${md([s.layer, s.persona].filter(Boolean).join(' · '))} | ${md(s.purpose)} | ${md([s.subject, s.action].filter(Boolean).join(' — '))} | ${md(s.camera ? [s.camera.move, s.camera.lens_mm ? `${s.camera.lens_mm}mm` : '', s.camera.angle, s.camera.framing].filter(Boolean).join(' · ') : '')} | ${md([s.lighting, s.color].filter(Boolean).join(' · '))} | ${md(s.transition_in ? `${s.transition_in.type} — ${s.transition_in.intent}` : '')} | ${md((s.on_screen_text ?? []).map((x) => `«${x.text}»(${x.source}${x.ref ? ` · ${x.ref}` : ''})`).join(' / '))} | ${md(s.audio ? [s.audio.vo && `VO ${s.audio.vo}`, s.audio.sfx && `SFX ${s.audio.sfx}`, s.audio.bgm && `BGM ${s.audio.bgm}`].filter(Boolean).join(' · ') : '')} | ${md(s.generation ? [s.generation.tool, s.generation.model].filter(Boolean).join(' · ') : '')} | ${s.real_or_staged} · ${s.state} |`),
-    '',
-  ];
-  const shots = sb.shots ?? [];
-  const prompts = shots.filter((s) => s.generation?.prompt);
-  const pblock = prompts.length ? ['## 생성 프롬프트', ...prompts.flatMap((s) => [`### ${s.id} · ${s.generation!.tool}${s.generation!.model ? ` · ${s.generation!.model}` : ''}`, '```', s.generation!.prompt!.trim(), '```', ...(s.generation!.asset ? [`결과: \`${s.generation!.asset}\``] : []), ''])] : [];
-  const notes = shots.filter((s) => s.notes).map((s) => `- ${s.id}: ${s.notes}`);
-  const tail = [
-    ...(notes.length ? ['## 샷 메모', ...notes, ''] : []),
-    ...(sb.open_questions?.length ? ['## 열린 물음', ...sb.open_questions.map((q) => `- ${q}`), ''] : []),
-    ...(sb.references?.length ? ['## 참고', ...sb.references.map((r) => `- ${r}`), ''] : []),
-  ];
-  return [...head, ...scqa, ...pr, ...layers, ...table, ...pblock, ...tail].join('\n');
-}
-
-function files(args: string[]): string[] {
-  if (args.length) return args.map((a) => resolve(a));
-  const out: string[] = [];
-  const walk = (d: string) => { for (const f of readdirSync(d)) { const p = join(d, f); if (statSync(p).isDirectory()) walk(p); else if (/\.ya?ml$/.test(f) && !f.startsWith('_')) out.push(p); } };
-  walk(DIR);
-  return out.sort();
-}
+// 스토리보드 정본 검사 ⊕ MD 생성. 기존 bun scripts/storyboard/storyboard.ts lint|render 지원.
+import { runStoryboard } from '../../src/cli/storyboard-cli.js';
+export { lint, render } from '../../src/storyboard/storyboard.js';
+export type { Storyboard } from '../../src/storyboard/storyboard.js';
 
 if (import.meta.main) {
   const [cmd, ...rest] = process.argv.slice(2);
   if (cmd !== 'lint' && cmd !== 'render') { console.error('usage: storyboard.ts lint|render [files…]'); process.exit(2); }
-  let bad = 0;
-  for (const f of files(rest)) {
-    const rel = relative(ROOT, f);
-    const sb = parse(readFileSync(f, 'utf8')) as Storyboard;
-    const { errors, warnings } = lint(sb, rel);
-    for (const e of errors) console.log(`✗ ${rel}: ${e}`);
-    for (const w of warnings) console.log(`⚠ ${rel}: ${w}`);
-    if (errors.length) { bad++; continue; }
-    if (cmd === 'render') {
-      const out = join(ROOT, 'docs', 'marketing', `STORYBOARD-${sb.id}-v${sb.version}.md`);
-      writeFileSync(out, render(sb, rel) + '\n');
-      console.log(`✓ ${rel} → ${relative(ROOT, out)}`);
-    } else console.log(`✓ ${rel} · v${sb.version} · ${sb.status} · ${sb.kind === 'site' ? `사이트 ${sb.sites?.length ?? 0}` : `샷 ${sb.shots.length}`}`);
-  }
-  process.exit(bad ? 1 : 0);
+  process.exitCode = runStoryboard(cmd, rest);
 }

package/scripts/tech1-public-measure.ts

@@ -0,0 +1,94 @@
+import { readFileSync } from 'node:fs';
+import { loadGraphTemplatesFrom, defaultGraphsDir } from '../src/self-implement/graph-templates.js';
+
+// Public metrics for release/public/tech/tech1.json. Log metrics read the installed `elanous`
+// (operational universe) over --since/--until; `--all` adds every registered instance incl. test.
+const key = process.argv[2];
+const flag = (name: string): string | undefined => {
+  const at = process.argv.indexOf(name);
+  return at < 0 ? undefined : process.argv[at + 1];
+};
+const PAGE = 100000;
+
+type Row = { id?: number; category: string; event: string; data?: unknown };
+
+function logRows(args: string[]): { rows: Row[]; limitReached: boolean } {
+  const proc = Bun.spawnSync(['elanous', 'logs', ...args, '--json', '--json-data'], { stdout: 'pipe', stderr: 'pipe', maxBuffer: 2 ** 31 } as Parameters<typeof Bun.spawnSync>[1]);
+  if (proc.exitCode !== 0) throw new Error(`elanous logs failed: ${new TextDecoder().decode(proc.stderr).slice(0, 300)}`);
+  const rows: Row[] = [];
+  let limitReached = false;
+  for (const line of new TextDecoder().decode(proc.stdout).split('\n')) {
+    if (!line) continue;
+    const row = JSON.parse(line) as Row & { _meta?: { type?: string; limitReached?: boolean } };
+    if (row._meta) { if (row._meta.type === 'log-query-limit' && row._meta.limitReached) limitReached = true; continue; }
+    rows.push(row);
+  }
+  return { rows, limitReached };
+}
+
+function window(): string[] {
+  const since = flag('--since');
+  const until = flag('--until');
+  if (!since || !until) throw new Error('--since <ISO> --until <ISO> required');
+  return ['--since', since, '--until', until];
+}
+
+/** One page across all instances; refuses a truncated page instead of reporting a short count. */
+function unionCount(categories: string, events?: string): Map<string, number> {
+  const args = [...window(), '--all', '--include-test', '--limit', String(PAGE), '--category', categories, ...(events ? ['--event', events] : [])];
+  const { rows, limitReached } = logRows(args);
+  if (limitReached) throw new Error(`truncated at ${PAGE} rows — narrow --event`);
+  const counts = new Map<string, number>();
+  for (const row of rows) counts.set(`${row.category} ${row.event}`, (counts.get(`${row.category} ${row.event}`) ?? 0) + 1);
+  return counts;
+}
+
+const at = (counts: Map<string, number>, k: string): number => counts.get(k) ?? 0;
+
+if (key === 'graph.templates') {
+  const result = loadGraphTemplatesFrom(defaultGraphsDir());
+  console.log(Object.keys(result.templates).length);
+} else if (key === 'loop-agents.loops') {
+  const proc = Bun.spawnSync(['bun', 'bin/elanous.mjs', '--test', 'loop', 'list', '--json'], { stdout: 'pipe', stderr: 'pipe' });
+  if (proc.exitCode !== 0) throw new Error('loop catalog unavailable');
+  console.log(JSON.parse(new TextDecoder().decode(proc.stdout)).length);
+} else if (key === 'harness.author-tags') {
+  const tags = [...readFileSync('src/self-implement/goal-author.ts', 'utf8').matchAll(/tag: '([a-z-]+)'/g)].map(match => match[1]);
+  console.log(new Set(tags).size);
+} else if (key === 'observability.events') {
+  // Operational instance only; pages with --before so the 100k page cap does not cut the count.
+  let before: number | undefined;
+  let total = 0;
+  for (;;) {
+    const { rows } = logRows([...window(), '--limit', String(PAGE), ...(before === undefined ? [] : ['--before', String(before)])]);
+    total += rows.length;
+    if (rows.length < PAGE) break;
+    before = Math.min(...rows.map((row) => row.id ?? Number.POSITIVE_INFINITY));
+  }
+  console.log(total);
+} else if (key === 'stages.author') {
+  const c = unionCount('harness.author', 'goal-id-assigned');
+  console.log(JSON.stringify({ auto: at(c, 'harness.author goal-id-assigned') }));
+} else if (key === 'stages.clarify') {
+  const c = unionCount('hitl.execution,harness.author.clarify', 'auto-recommended,assumed,asked,self-answered,unresolved');
+  console.log(JSON.stringify({
+    auto: at(c, 'hitl.execution auto-recommended') + at(c, 'hitl.execution assumed') + at(c, 'harness.author.clarify self-answered'),
+    human: at(c, 'hitl.execution asked'),
+    unknown: at(c, 'harness.author.clarify unresolved'),
+  }));
+} else if (key === 'stages.ledger') {
+  const { rows, limitReached } = logRows([...window(), '--all', '--include-test', '--limit', String(PAGE), '--category', 'self-implement.pod', '--event', 'ledger-live-appended']);
+  if (limitReached) throw new Error(`truncated at ${PAGE} rows`);
+  const runs = new Set(rows.map((row) => (row.data as { runId?: string } | undefined)?.runId).filter(Boolean));
+  console.log(JSON.stringify({ auto: runs.size, appends: rows.length }));
+} else if (key === 'stages.heal') {
+  const c = unionCount('self-dev.rework,self-dev.hitl', 'repeat-count,escalation');
+  console.log(JSON.stringify({ auto: at(c, 'self-dev.rework repeat-count'), human: at(c, 'self-dev.hitl escalation') }));
+} else if (key === 'pty.missions') {
+  // External coding agents driven through an inner PTY (agent-mission) — distinct missions with any row in the window.
+  const { rows, limitReached } = logRows([...window(), '--all', '--include-test', '--limit', String(PAGE), '--category', 'agent-mission']);
+  if (limitReached) throw new Error(`truncated at ${PAGE} rows`);
+  console.log(new Set(rows.map((row) => (row.data as { missionId?: string } | undefined)?.missionId).filter(Boolean)).size);
+} else {
+  throw new Error(`Unknown public metric: ${key ?? '(missing)'}`);
+}

package/scripts/test-diet/lib.ts

@@ -9,7 +9,9 @@ export const HEAVY_MB = 2048;
 
 export interface Measurement { file: string; secs: number; rssMb: number | null; rc: number | null; pass: number | null; fail: number | null; reason?: string }
 export type Verdict = 'keep' | 'failing' | 'review';
-export interface Judged extends Measurement { caught90: number; flags: string[]; verdict: Verdict }
+export type Proposal = 'delete' | 'shrink' | 'rewrite-cheap' | 'move-out-of-gate' | 'investigate';
+export interface Td1Disposition { disposition: string; alternative: string; guards: string; why_slow: string }
+export interface Judged extends Measurement { caught90: number; flags: string[]; verdict: Verdict; proposal?: Proposal | null; basis?: string | null }
 export interface LedgerLine { at: string; range: string; start: number; end: number; next: number; total: number; commit: string; budgetSecs: number; results: Judged[] }
 
 /** `file\tsecs\t…` (TD1 whole-gate TSV) → seconds per file. */
@@ -23,6 +25,33 @@ export function costTable(tsv: string): Map<string, number> {
   return costs;
 }
 
+/** TD1's human-reviewed dispositions, resolved by column name rather than TSV position. */
+export function td1Dispositions(tsv: string): Map<string, Td1Disposition> {
+  const [header, ...rows] = tsv.trimEnd().split('\n');
+  const columns = header?.replace(/\r$/, '').split('\t') ?? [];
+  const index = (name: string) => columns.indexOf(name);
+  const result = new Map<string, Td1Disposition>();
+  for (const row of rows) {
+    const cells = row.replace(/\r$/, '').split('\t');
+    const get = (name: string) => cells[index(name)] ?? '';
+    if (get('file') && get('disposition')) result.set(get('file'), {
+      disposition: get('disposition'), alternative: get('alternative'), guards: get('guards'), why_slow: get('why_slow'),
+    });
+  }
+  return result;
+}
+
+export function propose(judged: Judged, td1: ReadonlyMap<string, Td1Disposition>): Judged {
+  const reviewed = td1.get(judged.file);
+  if (reviewed) {
+    const proposal = reviewed.disposition === 'keep' ? null : reviewed.disposition as Proposal;
+    return { ...judged, proposal, basis: proposal ? [reviewed.alternative, reviewed.why_slow, reviewed.guards && `guards: ${reviewed.guards}`].filter(Boolean).join(' · ') : null };
+  }
+  if (judged.verdict === 'failing') return { ...judged, proposal: 'investigate', basis: `failing (rc=${judged.rc}) · caught90=${judged.caught90}` };
+  if (judged.verdict === 'review') return { ...judged, proposal: 'shrink', basis: `${judged.flags.join(', ')} · caught90=${judged.caught90}` };
+  return { ...judged, proposal: null, basis: null };
+}
+
 /** Next slice from the cursor until the known cost reaches the budget (at least one file; wraps at the end). */
 export function pickRange(files: readonly string[], start: number, costs: ReadonlyMap<string, number>, budgetSecs: number): { start: number; end: number; next: number; files: string[]; estimatedSecs: number } {
   if (files.length === 0) return { start: 0, end: -1, next: 0, files: [], estimatedSecs: 0 };