elanous 0.2.5 → 0.2.7

package/scripts/field-feed/lib.ts

@@ -0,0 +1,162 @@
+// Field feed — shared helpers for the graph nodes (graphs/field/field-feed.yaml · EV10c/EV10d).
+// The draft file `<folder>/feed/feed-draft.json` is the single source of truth: the feed node writes it, the PWA
+// «게시 대기» card overwrites it when a person edits, and the deliver node reads it «after» approval.
+import { existsSync, readFileSync, readdirSync, writeFileSync, renameSync, mkdirSync } from 'node:fs';
+import { basename, dirname, extname, join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { spawn, spawnSync } from 'node:child_process';
+
+export type FeedSlide = { image: string; source: string; caption: string; include: boolean; renderedCaption?: string /* `N/M:caption` as last drawn */ };
+export type FeedDraft = {
+  kind: 'feed-draft'; version: 1; revision: number; updatedAt: string; updatedBy: 'graph' | 'human';
+  graphId: 'field-feed'; runId: string | null; folder: string;
+  brand: { name: string; handle: string; avatar: string | null };
+  event: { title: string; date: string };
+  cover: { text: string; sub: string; image: string; renderedText?: string; renderedSub?: string; renderedSource?: string };
+  slides: FeedSlide[];
+  caption: { hook: string; body: string };
+  hashtags: string[];
+  location: string | null;
+  reel: string | null;
+};
+
+export const ENGINE = resolve(import.meta.dir, '../../skills/explainer-video/engine');
+export const CACHE = process.env.EXPLAINER_CACHE ?? join(homedir(), '.cache', 'elanous-explainer');
+const IMG = ['.jpg', '.jpeg', '.png', '.heic', '.webp'];
+
+/** Graph context: `ELANOUS_GRAPH_CONTEXT` is a JSON string or a path to one. CLI `--folder` wins for manual runs. */
+export function readContext(): { folder: string; runId: string | null } {
+  const at = process.argv.indexOf('--folder');
+  let folder = at >= 0 ? process.argv[at + 1] : undefined;
+  let runId: string | null = null;
+  const raw = process.env.ELANOUS_GRAPH_CONTEXT;
+  if (raw) {
+    const ctx = JSON.parse(raw.trim().startsWith('{') ? raw : readFileSync(raw, 'utf8')) as { input?: { folder?: unknown }; runId?: unknown };
+    if (!folder && typeof ctx.input?.folder === 'string') folder = ctx.input.folder;
+    if (typeof ctx.runId === 'string') runId = ctx.runId;
+  }
+  if (!folder) throw new Error('input.folder 필요(현장 폴더 절대 경로)');
+  folder = resolve(folder.replace(/^~(?=\/)/, homedir()));
+  if (!existsSync(folder)) throw new Error(`현장 폴더 없음: ${folder}`);
+  return { folder, runId: runId ?? process.env.ELANOUS_GRAPH_RUN_ID ?? null };
+}
+
+export const draftPath = (folder: string) => join(folder, 'feed', 'feed-draft.json');
+
+export function readDraft(folder: string): FeedDraft | null {
+  try { return JSON.parse(readFileSync(draftPath(folder), 'utf8')) as FeedDraft; } catch { return null; }
+}
+
+export function writeDraft(folder: string, draft: FeedDraft): void {
+  const path = draftPath(folder);
+  mkdirSync(dirname(path), { recursive: true });
+  const tmp = `${path}.${process.pid}.tmp`;
+  writeFileSync(tmp, JSON.stringify(draft, null, 2) + '\n');
+  renameSync(tmp, path);
+}
+
+/** Field uploads are named `20261002T193012Z-<device>-<name>` (capture time, UTC) — same order as the reel. */
+export function listPhotos(folder: string): string[] {
+  const stamp = (f: string) => { const m = /^(\d{8}T\d{6}Z)-/.exec(f); return m ? m[1]! : `~${f}`; };
+  return readdirSync(folder).filter((f) => IMG.includes(extname(f).toLowerCase()))
+    .sort((a, b) => (stamp(a) < stamp(b) ? -1 : stamp(a) > stamp(b) ? 1 : a < b ? -1 : a > b ? 1 : 0));
+}
+
+export function kstDate(photos: string[]): string {
+  const m = /^(\d{4})(\d{2})(\d{2})T(\d{2})/.exec(photos[0] ?? '');
+  if (!m) return '';
+  const d = new Date(Date.UTC(+m[1]!, +m[2]! - 1, +m[3]!, +m[4]!) + 9 * 3600e3);
+  return `${d.getUTCFullYear()}.${String(d.getUTCMonth() + 1).padStart(2, '0')}.${String(d.getUTCDate()).padStart(2, '0')}`;
+}
+
+/** One codex vision/text call — the same CLI the reel and card-followup use. Empty string on any failure. */
+export function ask(prompt: string, images: string[], ms = 45000): Promise<string> {
+  const bin = process.env.FIELD_REEL_CODEX_BIN || 'codex';
+  const args = ['exec', '--skip-git-repo-check', '-c', 'model_reasoning_effort=low', prompt, ...images.flatMap((im) => ['-i', im])];
+  return new Promise((done) => {
+    let buf = ''; let settled = false;
+    const finish = (v: string) => { if (!settled) { settled = true; done(v); } };
+    let child;
+    try { child = spawn(bin, args, { stdio: ['ignore', 'pipe', 'ignore'] }); } catch { finish(''); return; }
+    const timer = setTimeout(() => { child.kill('SIGKILL'); finish(''); }, ms);
+    child.stdout.on('data', (d) => { buf += d; });
+    child.on('error', () => { clearTimeout(timer); finish(''); });
+    child.on('close', (code) => { clearTimeout(timer); finish(code === 0 ? buf : ''); });
+  });
+}
+
+const CHROME = process.env.FIELD_FEED_CHROME
+  ?? ['/Applications/Google Chrome.app/Contents/MacOS/Google Chrome', '/Applications/Chromium.app/Contents/MacOS/Chromium', '/usr/bin/chromium', '/usr/bin/google-chrome']
+    .find((p) => existsSync(p));
+
+/** HTML page → PNG at 1080×1350 with headless Chrome. */
+export function screenshot(html: string, out: string): void {
+  if (!CHROME) throw new Error('Chrome 없음 — FIELD_FEED_CHROME 로 지정');
+  const page = out.replace(/\.png$/, '.html');
+  writeFileSync(page, html);
+  const r = spawnSync(CHROME, ['--headless=new', '--disable-gpu', '--hide-scrollbars', '--force-device-scale-factor=1',
+    '--window-size=1080,1350', '--virtual-time-budget=3000', '--allow-file-access-from-files', `--screenshot=${out}`, `file://${page}`],
+  { encoding: 'utf8', timeout: 60000 });
+  if (r.status !== 0 || !existsSync(out)) throw new Error(`screenshot ${basename(out)}: ${(r.stderr || '').slice(0, 200)}`);
+}
+
+export function markSvg(size: number): string {
+  const paths = [...readFileSync(join(ENGINE, 'brand', 'elanous-mark-on-dark.svg'), 'utf8').matchAll(/<path d="([^"]*)"/g)].map((m) => m[1]);
+  return `<svg width="${size}" height="${size}" viewBox="150 150 724 724">${paths.map((d) => `<path d="${d}" fill="#F2F1EE"/>`).join('')}<circle cx="512" cy="512" r="76" fill="#E95047"/></svg>`;
+}
+
+const esc = (s: string) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/"/g, '&quot;');
+const fonts = () => ['Bold:700', 'ExtraBold:800', 'Black:900'].map((w) => {
+  const [name, weight] = w.split(':');
+  return `@font-face{font-family:"Pretendard";src:url("file://${join(CACHE, 'fonts', `Pretendard-${name}.woff2`)}") format("woff2");font-weight:${weight}}`;
+}).join('');
+const base = `*{margin:0;padding:0;box-sizing:border-box}html,body{width:1080px;height:1350px;overflow:hidden;background:#000}
+body{position:relative;font-family:"Pretendard",sans-serif;color:#F2F1EE;word-break:keep-all}
+.ph{position:absolute;inset:0;width:100%;height:100%;object-fit:cover}
+.top{position:absolute;left:56px;top:52px;display:flex;align-items:center;gap:16px;font-weight:800;font-size:30px;text-shadow:0 2px 10px rgba(0,0,0,.6)}
+.top b{color:#E95047}
+.url{position:absolute;right:56px;bottom:48px;font-weight:700;font-size:26px;color:rgba(242,241,238,.7)}`;
+
+export function coverHtml(photo: string, title: string, sub: string): string {
+  return `<!doctype html><html lang="ko"><head><meta charset="utf-8"><style>${fonts()}${base}
+.shade{position:absolute;inset:0;background:linear-gradient(to top,rgba(0,0,0,.92) 0%,rgba(0,0,0,.55) 45%,rgba(0,0,0,.25) 100%)}
+.box{position:absolute;left:72px;right:72px;bottom:150px}
+.kick{font-weight:800;font-size:30px;letter-spacing:.26em;color:#E95047}
+h1{margin-top:22px;font-weight:900;font-size:104px;line-height:1.1;letter-spacing:-.03em}
+.rule{margin-top:34px;width:150px;height:9px;background:#E95047}
+p{margin-top:26px;font-weight:700;font-size:40px;color:rgba(242,241,238,.75)}
+</style></head><body><img class="ph" src="file://${esc(photo)}"/><div class="shade"></div>
+<div class="top">${markSvg(54)}<span>Elanous <b>·</b> 현장 스케치</span></div>
+<div class="box"><div class="kick">현장 스케치</div><h1>${esc(title)}</h1><div class="rule"></div><p>${esc(sub)}</p></div>
+<div class="url">elanous.ai</div></body></html>`;
+}
+
+export function slideHtml(photo: string, caption: string, no: number, total: number): string {
+  return `<!doctype html><html lang="ko"><head><meta charset="utf-8"><style>${fonts()}${base}
+.shade{position:absolute;left:0;right:0;bottom:0;height:46%;background:linear-gradient(to top,rgba(0,0,0,.86),rgba(0,0,0,0))}
+.box{position:absolute;left:72px;right:72px;bottom:120px}
+.no{font-weight:800;font-size:32px;letter-spacing:.12em;color:#E95047}.no i{font-style:normal;color:rgba(242,241,238,.6)}
+.cap{margin-top:16px;font-weight:900;font-size:68px;line-height:1.2;letter-spacing:-.03em;text-shadow:0 3px 16px rgba(0,0,0,.6)}
+.rule{margin-top:26px;width:110px;height:8px;background:#E95047}
+</style></head><body><img class="ph" src="file://${esc(photo)}"/><div class="shade"></div>
+<div class="top">${markSvg(48)}<span>Elanous</span></div>
+<div class="box"><div class="no">${String(no).padStart(2, '0')} <i>/ ${String(total).padStart(2, '0')}</i></div><div class="cap">${esc(caption)}</div><div class="rule"></div></div>
+<div class="url">elanous.ai</div></body></html>`;
+}
+
+/** Last JSON object in a model reply, or null. */
+export function lastJson(text: string): Record<string, unknown> | null {
+  // Try objects from the last «{» backwards; for each, the shortest closing «}» that parses.
+  for (let start = text.lastIndexOf('{'); start >= 0; start = text.lastIndexOf('{', start - 1)) {
+    for (let end = text.indexOf('}', start); end >= 0; end = text.indexOf('}', end + 1)) {
+      try {
+        const value = JSON.parse(text.slice(start, end + 1)) as unknown;
+        if (value && typeof value === 'object' && !Array.isArray(value)) return value as Record<string, unknown>;
+      } catch { /* longer */ }
+    }
+    if (start === 0) break;
+  }
+  return null;
+}
+
+export const result = (data: Record<string, unknown>) => console.log(JSON.stringify({ outcome: 'ok', ...data }));

package/scripts/field-feed/reel-node.ts

@@ -0,0 +1,24 @@
+#!/usr/bin/env bun
+// reel node — 데몬이 업로드 뒤 이미 렌더했으면(.reel-status.json done ⊕ 파일 있음) 그대로 쓰고, 아니면 같은 엔진(reel.sh)으로 한 번.
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { ENGINE, readContext, result } from './lib.js';
+
+try {
+  const { folder } = readContext();
+  const file = join(folder, 'reel', 'reel-9x16.mp4');
+  let state = '';
+  try { state = (JSON.parse(readFileSync(join(folder, '.reel-status.json'), 'utf8')) as { state?: string }).state ?? ''; } catch { /* 없음 */ }
+  if (state === 'rendering') throw new Error('데몬이 아직 렌더 중이다 — 끝난 뒤 다시');
+  if (state === 'done' && existsSync(file) && existsSync(join(folder, 'reel', 'timeline.json'))) {
+    result({ reel: file, reused: true });
+  } else {
+    const started = Date.now();
+    const r = spawnSync('zsh', [join(ENGINE, 'reel.sh'), folder], { encoding: 'utf8', timeout: 540000 });
+    if (r.status !== 0 || !existsSync(file)) throw new Error(`reel.sh 실패: ${(r.stderr || r.stdout || '').slice(-300)}`);
+    result({ reel: file, reused: false, ms: Date.now() - started });
+  }
+} catch (error) {
+  console.log(JSON.stringify({ outcome: 'fail', reason: error instanceof Error ? error.message : String(error) }));
+}

package/scripts/field-feed/start.ts

@@ -0,0 +1,62 @@
+#!/usr/bin/env bun
+// 현장 피드 시작 — `bun scripts/field-feed/start.ts <현장폴더>`
+// ① graphs/field/field-feed.yaml 런을 띄운다(reel → feed → post 에서 «게시 대기»로 멈춘다)
+// ② 멈췄으면 «결정 대기자»를 떼어 띄운다: 15초마다 `graph run --resume <runId>` — 결정이 기록되기 전엔 같은 자리에 다시 멈추고,
+//    «최종 게시»(approved)가 기록되면 deliver 까지, 거절이면 failed 로 끝난다. 48시간 뒤 스스로 그만둔다.
+// `--wait <runId>` 는 그 대기자 자신(직접 부르지 않는다).
+import { spawn, spawnSync } from 'node:child_process';
+import { existsSync, mkdirSync, openSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { debug } from '../../src/debug/log.js';
+
+const ROOT = resolve(import.meta.dir, '../..');
+const GRAPH = join(ROOT, 'graphs', 'field', 'field-feed.yaml');
+const CLI = join(ROOT, 'bin', 'elanous.mjs');
+type State = { runId?: string; status?: string; pending?: { decision?: string } };
+
+function graphRun(args: string[]): State {
+  const r = spawnSync(process.execPath, [CLI, 'graph', 'run', GRAPH, '--json', ...args], { cwd: ROOT, encoding: 'utf8', maxBuffer: 20 * 1024 * 1024 });
+  const line = r.stdout.trim().split('\n').reverse().find((l) => l.startsWith('{'));
+  if (!line) throw new Error(`graph run: 결과 없음 rc=${r.status} ${r.stderr.slice(-300)}`);
+  return JSON.parse(line) as State;
+}
+
+const argv = process.argv.slice(2);
+const waitAt = argv.indexOf('--wait');
+if (waitAt >= 0) {
+  const runId = argv[waitAt + 1]!;
+  const deadline = Date.now() + 48 * 3600e3;
+  let state: State = { status: 'awaiting-approval' };
+  while (Date.now() < deadline) {
+    await Bun.sleep(15000);
+    try { state = graphRun(['--resume', runId]); } catch (error) {
+      debug.log('field.feed', 'resume-error', { runId, error: error instanceof Error ? error.message : String(error) });
+      continue;
+    }
+    if (state.status !== 'awaiting-approval') break;
+  }
+  debug.log('field.feed', 'wait-ended', { runId, status: state.status ?? 'unknown', timedOut: state.status === 'awaiting-approval' });
+  console.log(`field-feed ${runId}: ${state.status}`);
+  process.exit(0);
+}
+
+const folderArg = argv.find((a) => !a.startsWith('--'));
+if (!folderArg) { console.error('usage: bun scripts/field-feed/start.ts <현장폴더>'); process.exit(2); }
+const folder = resolve(folderArg.replace(/^~(?=\/)/, homedir()));
+if (!existsSync(folder)) { console.error(`현장 폴더 없음: ${folder}`); process.exit(2); }
+const started = Date.now();
+const state = graphRun(['--input', JSON.stringify({ folder })]);
+const seconds = Math.round((Date.now() - started) / 1000);
+debug.log('field.feed', 'started', { runId: state.runId, status: state.status, seconds });
+if (state.status === 'awaiting-approval' && state.runId) {
+  const logDir = join(folder, 'feed');
+  mkdirSync(logDir, { recursive: true });
+  const out = openSync(join(logDir, 'wait.log'), 'a');
+  const child = spawn(process.execPath, [import.meta.path, '--wait', state.runId], { cwd: ROOT, detached: true, stdio: ['ignore', out, out] });
+  child.unref();
+  console.log(`field-feed ${state.runId}: 게시 대기 (${seconds}s) · 초안 ${join(folder, 'feed', 'feed-draft.json')} · 결정 대기자 pid ${child.pid}`);
+} else {
+  console.log(`field-feed ${state.runId}: ${state.status} (${seconds}s)`);
+  if (state.status !== 'done') process.exitCode = 1;
+}

package/scripts/fixtures/vflow-sample.ndjson

@@ -0,0 +1,6 @@
+{"url":"https://example.test/shot-a","model":"seedance-2-0","category":"camera","name":"Crash Zoom Macro","description":"A toy car approaches the lens","prompt":"Crash zoom into a miniature car, then hold a macro detail on the painted door.","keywords":["crash zoom","macro"],"author":"Aster","authorUrl":"https://example.test/aster"}
+{"url":"https://example.test/shot-b","model":"seedance-2-0","category":"camera","name":"Quiet Crash Zoom","description":"A bell at a crossing","prompt":"A crash zoom toward a distant bell in the rain.","keywords":["crash zoom"],"author":"Beryl","authorUrl":"https://example.test/beryl"}
+{"url":"https://example.test/shot-c","model":"seedance-2-0","category":"motion","name":"Wide Speed Ramp","description":"A paper kite travels across the sky","prompt":"A paper kite turns slowly before a speed ramp across the horizon.","keywords":["speed ramp"],"author":"Cedar","authorUrl":"https://example.test/cedar"}
+{"url":"https://example.test/shot-d","model":"grok-imagine","category":"camera","name":"Crash Zoom Macro","description":"A tiny clock on the desk","prompt":"Crash zoom onto a tiny clock, revealing macro gears.","keywords":["crash zoom","macro"],"author":"Dara","authorUrl":"https://example.test/dara"}
+{"url":"https://example.test/shot-e","model":"grok-imagine","category":"motion","name":"Whip Pan","description":"A painted room","prompt":"Whip pan past the window to reveal a blue wall. The illustrated cardboard room is full of handmade clocks, chalk drawings, paper boats, folded maps, model trees, painted stones, colorful blocks, and strings of origami stars. The camera circles the toy table slowly while the paper figures stand still. ENDING_SENTINEL","keywords":["whip pan"],"author":"Eden","authorUrl":"https://example.test/eden"}
+{broken json

package/scripts/install.sh

@@ -11,7 +11,7 @@ set -euo pipefail
 
 usage() {
   cat <<'EOF'
-Usage: bash scripts/install.sh [--prefix PATH] [--source PATH.tgz|URL] [--no-modify-path] [--no-bootstrap-bun] [--help]
+Usage: bash scripts/install.sh [--prefix PATH] [--source PATH.tgz|URL] [--no-modify-path] [--no-bootstrap-bun] [--no-setup] [--yes] [--allow-downgrade] [--help]
        curl -fsSL https://github.com/ElanvitalAI/elanous/releases/latest/download/install.sh | bash
 
 Install elanous without contacting a package registry.
@@ -23,6 +23,9 @@ Install elanous without contacting a package registry.
                       (or set $ELANOUS_INSTALL_SOURCE; without either, fetch the verified latest release)
   --no-modify-path    do not append the elanous PATH block to a shell startup file
   --no-bootstrap-bun  fail instead of installing bun with its official installer when bun is missing
+  --no-setup          do not start first-time setup in this window after installing (interactive terminals only)
+  --yes               do not ask before updating an existing installation
+  --allow-downgrade   allow installing a version older than the one already installed
   --help, -h          show this help
 EOF
 }
@@ -35,6 +38,9 @@ PREFIX="${ELANOUS_INSTALL_PREFIX:-${XDG_DATA_HOME:-${HOME:?HOME is required}/.lo
 SOURCE="${ELANOUS_INSTALL_SOURCE:-}"
 MODIFY_PATH=1
 BOOTSTRAP_BUN=1
+RUN_SETUP=1
+ASSUME_YES=0
+ALLOW_DOWNGRADE=0
 
 while [ "$#" -gt 0 ]; do
   case "$1" in
@@ -47,10 +53,30 @@ while [ "$#" -gt 0 ]; do
       SOURCE="$2"; shift 2 ;;
     --no-modify-path) MODIFY_PATH=0; shift ;;
     --no-bootstrap-bun) BOOTSTRAP_BUN=0; shift ;;
+    --no-setup) RUN_SETUP=0; shift ;;
+    --yes|-y) ASSUME_YES=1; shift ;;
+    --allow-downgrade) ALLOW_DOWNGRADE=1; shift ;;
     *) echo "⛔ unknown argument: $1" >&2; usage >&2; exit 2 ;;
   esac
 done
 
+# INST1 — one language per run: English by default, Korean when the locale is Korean (override: ELANOUS_INSTALL_LANG=en|ko).
+case "${ELANOUS_INSTALL_LANG:-${LC_ALL:-${LC_MESSAGES:-${LANG:-}}}}" in
+  ko*) INSTALL_LANG=ko ;;
+  *) INSTALL_LANG=en ;;
+esac
+t() { if [ "$INSTALL_LANG" = ko ]; then printf '%s' "$2"; else printf '%s' "$1"; fi; }
+
+# Interactive = a person is at a terminal. `curl … | bash` gives us the script on stdin, so look at
+# stdout and /dev/tty, not stdin (rustup does the same). CI never counts as interactive.
+# ELANOUS_INSTALL_INTERACTIVE=0|1 overrides the probe (tests, wrappers).
+INTERACTIVE=0
+if [ -n "${ELANOUS_INSTALL_INTERACTIVE:-}" ]; then
+  [ "$ELANOUS_INSTALL_INTERACTIVE" = 1 ] && INTERACTIVE=1
+elif [ -z "${CI:-}" ] && [ -t 1 ] && { : </dev/tty; } 2>/dev/null; then
+  INTERACTIVE=1
+fi
+
 # bun 이 없으면 공식 설치기로 먼저 깐다 — «sh 한 번이면 알아서» (claude·grok 설치기와 같은 기대).
 # ⛔ 끄면(--no-bootstrap-bun) 공식 설치 명령을 안내하고 rc 127 로 멈춘다.
 # 🩸 2026-09-24 빈 VM 실측: 비대화 셸(ssh 명령·크론)은 ~/.bun/bin 이 PATH 에 없어 «이미 깐» bun 을 못 보고 또 설치했다.
@@ -295,6 +321,30 @@ fi
 PACKAGE_VERSION="$(tar -xzOf "$INSTALL_TARBALL" package/package.json 2>/dev/null | bun -e 'const t=await Bun.stdin.text(); try { process.stdout.write(String(JSON.parse(t).version ?? "")) } catch {}' || true)"
 [ -n "$PACKAGE_VERSION" ] || { echo "⛔ package version missing in tarball: $INSTALL_TARBALL" >&2; exit 1; }
 case "$PACKAGE_VERSION" in */*|*..*) echo "⛔ unsafe package version: $PACKAGE_VERSION" >&2; exit 1 ;; esac
+
+# INST1 — an existing installation is never moved silently: no downgrade without --allow-downgrade
+# (10-01: a running mbp went 0.2.7 → 0.2.6 unnoticed), and an interactive re-run asks before updating.
+INSTALLED_VERSION=""
+if [ -f "$PREFIX/install.json" ]; then
+  INSTALLED_VERSION="$(bun -e 'try { const j=JSON.parse(await Bun.file(process.argv.at(-1)).text()); process.stdout.write(String(j.version ?? "")) } catch {}' "$PREFIX/install.json" || true)"
+fi
+if [ -n "$INSTALLED_VERSION" ]; then
+  ORDER="$(bun -e 'const [a,b]=process.argv.slice(-2); try { process.stdout.write(String(Bun.semver.order(a,b))) } catch { process.stdout.write("0") }' "$PACKAGE_VERSION" "$INSTALLED_VERSION" || echo 0)"
+  if [ "$ORDER" = "-1" ] && [ "$ALLOW_DOWNGRADE" -eq 0 ]; then
+    echo "⛔ $(t "elanous $INSTALLED_VERSION is installed; $PACKAGE_VERSION is older, so nothing was changed. To go back on purpose, rerun with --allow-downgrade." "elanous $INSTALLED_VERSION 이(가) 설치돼 있고 $PACKAGE_VERSION 은(는) 더 낮은 판이라 아무것도 바꾸지 않았습니다. 일부러 내리려면 --allow-downgrade 를 붙여 다시 실행하세요.")" >&2
+    exit 3
+  fi
+  if [ "$INTERACTIVE" -eq 1 ] && [ "$ASSUME_YES" -eq 0 ]; then
+    printf '%s ' "$(t "elanous $INSTALLED_VERSION is already installed. Update to $PACKAGE_VERSION? [Y/n]" "elanous $INSTALLED_VERSION 이(가) 이미 설치돼 있습니다. $PACKAGE_VERSION 로 업데이트할까요? [Y/n]")"
+    if [ -n "${ELANOUS_INSTALL_ANSWER+x}" ]; then ANSWER="$ELANOUS_INSTALL_ANSWER"; else ANSWER=""; read -r ANSWER </dev/tty || ANSWER=""; fi
+    echo ""
+    case "$ANSWER" in
+      n|N|no|NO|No|아니오|아니요)
+        echo "$(t "Left elanous $INSTALLED_VERSION as it is." "elanous $INSTALLED_VERSION 을(를) 그대로 두었습니다.")"
+        exit 0 ;;
+    esac
+  fi
+fi
 VERSION_NAME="$PACKAGE_VERSION${VERSION_SUFFIX:-}"
 VERSION_DIR="$PREFIX/versions/$VERSION_NAME"
 mkdir -p "$VERSION_DIR"
@@ -312,15 +362,25 @@ printf '#!/bin/sh\nexec "%s" x node-gyp@latest "$@"\n' "$BUN_EXEC" > "$NATIVE_SH
 chmod +x "$NATIVE_SHIM/node-gyp"
 if ! (cd "$VERSION_DIR" && PATH="$NATIVE_SHIM:$PATH" bun add --no-save --offline "$INSTALL_TARBALL" >/dev/null 2>&1); then
   echo "dependencies not in the local bun cache — fetching them from the npm registry" >&2
-  (cd "$VERSION_DIR" && PATH="$NATIVE_SHIM:$PATH" bun add --no-save "$INSTALL_TARBALL")
+  # bun prints «Blocked N postinstalls» and progress noise here — keep it out of the screen unless this step fails.
+  ADD_LOG="$(mktemp "${TMPDIR:-/tmp}/elanous-bun-add.XXXXXX")"
+  ADD_RC=0
+  (cd "$VERSION_DIR" && PATH="$NATIVE_SHIM:$PATH" bun add --no-save "$INSTALL_TARBALL") >"$ADD_LOG" 2>&1 || ADD_RC=$?
+  if [ "$ADD_RC" -ne 0 ]; then
+    tail -n 20 "$ADD_LOG" >&2
+    rm -f "$ADD_LOG"; rm -rf "$NATIVE_SHIM"
+    exit "$ADD_RC"
+  fi
+  rm -f "$ADD_LOG"
 fi
 rm -rf "$NATIVE_SHIM"
 ln -sfn "versions/$VERSION_NAME" "$PREFIX/current"
 mkdir -p "$PREFIX/bin"
 # 절대 bun 경로를 설치 때 박고 엔트리는 current 를 거친다 — cron/systemd 의 짧은 PATH 와 판 전환 모두 지원.
 WRAPPER="$PREFIX/bin/.elanous-$$"
-printf '#!/bin/sh\n# elanous-wrapper\nif [ ! -x %s ]; then\n  printf '\''bun 을 찾을 수 없습니다: %%s — 설치기를 다시 실행하세요\\n'\'' %s >&2\n  exit 127\nfi\nexec %s %s "$@"\n' \
-  "$(shell_quote "$BUN_EXEC")" "$(shell_quote "$BUN_EXEC")" "$(shell_quote "$BUN_EXEC")" \
+BUN_MISSING_MSG="$(t 'bun not found: %s — run the installer again' 'bun 을 찾을 수 없습니다: %s — 설치기를 다시 실행하세요')"
+printf '#!/bin/sh\n# elanous-wrapper\nif [ ! -x %s ]; then\n  printf '\''%s\\n'\'' %s >&2\n  exit 127\nfi\nexec %s %s "$@"\n' \
+  "$(shell_quote "$BUN_EXEC")" "$BUN_MISSING_MSG" "$(shell_quote "$BUN_EXEC")" "$(shell_quote "$BUN_EXEC")" \
   "$(shell_quote "$PREFIX/current/node_modules/elanous/bin/elanous.mjs")" > "$WRAPPER"
 chmod +x "$WRAPPER"
 mv -f "$WRAPPER" "$PREFIX/bin/elanous"
@@ -329,7 +389,7 @@ ELN_ON_PATH="$(command -v eln 2>/dev/null || true)"
 if { [ -n "$ELN_ON_PATH" ] && [ "$ELN_ON_PATH" != "$ELN" ]; } ||
    { { [ -e "$ELN" ] || [ -L "$ELN" ]; } &&
      { [ -L "$ELN" ] || [ ! -f "$ELN" ] || [ "$(sed -n '2p' "$ELN")" != '# elanous-wrapper' ]; }; }; then
-  echo '⚠ eln: 이미 다른 명령이 있어 만들지 않았다 — elanous 로 쓰십시오'
+  echo "⚠ eln: $(t 'already used by another program, so it was not created — run elanous instead.' '이미 다른 프로그램이 eln 을 써서 만들지 않았습니다 — elanous 로 실행하세요.')"
   ELN_AVAILABLE=0
 else
   cp "$PREFIX/bin/elanous" "$ELN"
@@ -368,21 +428,26 @@ if [ "$MODIFY_PATH" -eq 1 ] && [ -n "${LOGIN_STARTUP:-}" ] && ! grep -Fqx "$MARK
   printf '\n%s\n%s\n%s\n' "$MARKER_START" "$PATH_LINE" "$MARKER_END" >> "$LOGIN_STARTUP"
 fi
 
-echo "Installed elanous $VERSION at $PREFIX/bin/elanous"
+echo "$(t "Installed elanous $VERSION at $PREFIX/bin/elanous" "elanous $VERSION 을(를) 설치했습니다: $PREFIX/bin/elanous")"
 
 # ── 다음 걸음 (2026-09-23 · Phase 3 「사람 손」) ─────────────────────────
 # ⛔ 설치가 끝나도 «무엇을 더 쳐야 하나»를 안 말하면, 빠뜨린 손이 나중에 «다른 원인의 얼굴»로 나타난다
 #   (예: 로그인 누락이 quota-exhausted 로 분류됐다 — 09-21 실측). 그래서 «지금 상태»로 계산해 말한다.
 #   provider 설정은 «안» 적는다 — 빈 config(auto)는 로그인만 있으면 런타임이 codex 로 고른다(#19950).
+# --no-setup keeps the prompt above but never starts setup.
+START_SETUP=$INTERACTIVE
+[ "$RUN_SETUP" -eq 1 ] || START_SETUP=0
+
 echo ""
-echo "Next:"
+echo "$(t 'Next:' '다음:')"
 STEP=1
+# INST1 order: new shell → elanous (first-time setup, which also signs in) → missing tools → harness say.
 case ":$PATH:" in
   *":$PREFIX/bin:"*) ;;
-  *) if [ "$MODIFY_PATH" -eq 1 ]; then echo "  $STEP) open a new shell (or: source $STARTUP)"; else echo "  $STEP) add $PREFIX/bin to PATH"; fi; STEP=$((STEP + 1)) ;;
+  *) if [ "$MODIFY_PATH" -eq 1 ]; then echo "  $STEP) $(t "open a new shell (or: source $STARTUP)" "새 셸을 여세요(또는: source $STARTUP)")"; else echo "  $STEP) $(t "add $PREFIX/bin to PATH" "$PREFIX/bin 을 PATH 에 넣으세요")"; fi; STEP=$((STEP + 1)) ;;
 esac
-if ! grep -q '"openai-codex"' "$HOME/.elanous/auth.json" 2>/dev/null; then
-  echo "  $STEP) elanous login openai-codex        # ChatGPT subscription (device code, no API key)"; STEP=$((STEP + 1))
+if [ "$START_SETUP" -eq 0 ]; then
+  echo "  $STEP) $(t "Run: $PREFIX/bin/elanous   # first-time setup (in a new shell: elanous)" "실행: $PREFIX/bin/elanous   # 첫 설정(새 셸에서는: elanous)")"; STEP=$((STEP + 1))
 fi
 # 🆕 2026-09-24 빈 VM 실측: 하니스(codex 백엔드)는 Codex CLI 를 자식으로 띄우는데 빈 기계엔 codex·node 가 «둘 다» 없었다.
 #    ⚠️ 아래 설치 줄은 빈 기계에서 아직 «안 쟀다» — `elanous doctor` 의 codex 줄이 판정한다.
@@ -440,8 +505,22 @@ elif ! gh auth status >/dev/null 2>&1; then
   echo "  $STEP) gh auth login                     # the harness opens pull requests with it"; STEP=$((STEP + 1))
 fi
 if [ "$ELN_AVAILABLE" -eq 1 ]; then
-  echo "  $STEP) eln harness say \"<one line of what you want>\" (or: elanous harness say)"
+  echo "  $STEP) $(t 'eln harness say "<one line of what you want>" (or: elanous harness say)' 'eln harness say "<하고 싶은 일 한 줄>" (또는: elanous harness say)')"
 else
-  echo "  $STEP) elanous harness say \"<one line of what you want>\""
+  echo "  $STEP) $(t 'elanous harness say "<one line of what you want>"' 'elanous harness say "<하고 싶은 일 한 줄>"')"
+fi
+echo "  $(t 'check anytime: elanous setup --non-interactive' '언제든 점검: elanous setup --non-interactive')"
+
+# INST2 — finish in the same window: start first-time setup with the absolute wrapper (no source, no new shell).
+if [ "$START_SETUP" -eq 1 ]; then
+  echo ""
+  echo "$(t 'Starting first-time setup… (skip it next time with --no-setup)' '첫 설정을 시작합니다… (다음에 건너뛰려면 --no-setup)')"
+  case ":$PATH:" in
+    *":$PREFIX/bin:"*) ;;
+    *) echo "  $(t "(new shells will find elanous on PATH; this window uses $PREFIX/bin/elanous)" "(새 셸에서는 PATH 로 elanous 를 찾습니다 · 이 창은 $PREFIX/bin/elanous 를 씁니다)")" ;;
+  esac
+  if [ -n "${ELANOUS_INSTALL_SETUP_EXEC:-}" ]; then
+    exec "$ELANOUS_INSTALL_SETUP_EXEC" "$PREFIX/bin/elanous"
+  fi
+  exec "$PREFIX/bin/elanous" </dev/tty
 fi
-echo "  check anytime: elanous setup --non-interactive"

package/scripts/landing-heal/clean-checkout.ts

@@ -0,0 +1,114 @@
+import { execFileSync, spawnSync } from 'node:child_process';
+import { existsSync, mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { repoRoot } from '../../src/domains/schedule-registry.js';
+
+export interface CheckoutStep { name: string; ok: boolean; seconds: number; tail: string }
+export interface CheckoutResult { pr: number; mergeSha: string; ok: boolean; steps: CheckoutStep[] }
+export interface CheckoutDeps {
+  git: (args: string[], options: { cwd: string; timeout: number }) => string;
+  run: (args: string[], options: { cwd: string; timeout: number; env?: NodeJS.ProcessEnv }) => string;
+  now: () => number;
+}
+
+const LIMIT_MS = 600_000;
+const tail = (text: string): string => text.trimEnd().split('\n').slice(-20).join('\n');
+const validPath = (file: string): boolean => file.length > 0 && !file.startsWith('/') && !file.startsWith('-') && !file.split('/').includes('..');
+const errorOutput = (error: unknown): string => {
+  if (!error || typeof error !== 'object') return String(error);
+  const e = error as { stdout?: string | Buffer; stderr?: string | Buffer; message?: string };
+  return [e.stdout, e.stderr, e.message].filter(Boolean).map(String).join('\n') || String(error);
+};
+const defaultDeps: CheckoutDeps = {
+  git: (args, options) => execFileSync('git', args, { ...options, encoding: 'utf8', maxBuffer: 4 * 1024 * 1024 }),
+  run: (args, options) => {
+    const result = spawnSync('bun', args, { ...options, encoding: 'utf8', maxBuffer: 4 * 1024 * 1024, stdio: ['ignore', 'pipe', 'pipe'] });
+    if (result.error || result.status !== 0) throw { stdout: result.stdout, stderr: result.stderr, message: result.error?.message ?? `bun exit ${result.status}` };
+    return `${result.stdout}${result.stderr}`;
+  },
+  now: Date.now,
+};
+
+/** A single merge commit, with installed dependencies owned by its detached worktree. */
+export function verifyCleanCheckout({ pr, mergeSha, files, deps = defaultDeps }: {
+  pr: number; mergeSha: string; files: string[]; deps?: CheckoutDeps;
+}): CheckoutResult {
+  const steps: CheckoutStep[] = [];
+  const root = repoRoot();
+  const start = deps.now();
+  const deadline = start + LIMIT_MS;
+  const workspace = mkdtempSync(join(tmpdir(), 'landing-heal-clean-'));
+  const checkout = join(workspace, 'checkout');
+  let ok = true;
+  const step = (name: string, command: (timeout: number) => string): boolean => {
+    const began = deps.now();
+    try {
+      const remaining = deadline - began;
+      if (remaining <= 0) throw new Error('clean checkout 600s timeout');
+      const out = command(remaining);
+      steps.push({ name, ok: true, seconds: (deps.now() - began) / 1000, tail: tail(out) });
+      return true;
+    } catch (error) {
+      steps.push({ name, ok: false, seconds: (deps.now() - began) / 1000, tail: tail(errorOutput(error)) });
+      ok = false;
+      return false;
+    }
+  };
+  try {
+    if (step('worktree add', (timeout) => {
+      const commit = `${mergeSha}^{commit}`;
+      const git = (args: string[]) => {
+        const remaining = Math.min(timeout, deadline - deps.now());
+        if (remaining <= 0) throw new Error('clean checkout 600s timeout');
+        return deps.git(args, { cwd: root, timeout: remaining });
+      };
+      try {
+        git(['cat-file', '-e', commit]);
+      } catch (error) {
+        if (deadline - deps.now() <= 0) throw error;
+        git(['fetch', '--no-tags', 'origin', mergeSha]);
+        git(['cat-file', '-e', commit]);
+      }
+      return git(['worktree', 'add', '--detach', checkout, mergeSha]);
+    })) {
+      if (step('bun install --frozen-lockfile', (timeout) => deps.run(['install', '--frozen-lockfile'], { cwd: checkout, timeout }))) {
+        const changedTests = files.filter((file) => /\.(?:test|spec)\.[^/]+$/.test(file));
+        const unsupported = changedTests.filter((file) => !validPath(file) || !/\.(?:test|spec)\.[cm]?[jt]sx?$/.test(file));
+        const tests = [...new Set(changedTests.filter((file) => validPath(file)))];
+        if (unsupported.length) {
+          step('select changed tests', () => { throw new Error(`unsupported changed test files: ${unsupported.join(', ')}`); });
+        } else if (tests.length) {
+          step('bun test', (timeout) => {
+            const out = deps.run(['test', ...tests], { cwd: checkout, timeout });
+            const count = /Ran (\d+) tests? across (\d+) files?/.exec(out);
+            if (!count || Number(count[1]) === 0) throw new Error(`bun test did not run any tests: ${tail(out)}`);
+            if (Number(count[2]) !== tests.length) throw new Error(`bun test ran ${count[2]} of ${tests.length} changed test files: ${tail(out)}`);
+            return out;
+          });
+        } else if (files.some((file) => validPath(file) && /\.tsx?$/.test(file))) {
+          // ci-typecheck-changed.ts rejects --base: its supported base selector is TSC_BASE_REF.
+          step('typecheck changed', (timeout) => deps.run(['run', 'scripts/ci-typecheck-changed.ts'], {
+            cwd: checkout, timeout, env: { ...process.env, TSC_BASE_REF: `${mergeSha}^`, GITHUB_BASE_REF: '' },
+          }));
+        } else {
+          step('select changed TypeScript', () => { throw new Error('no existing changed .ts files to verify'); });
+        }
+      }
+    }
+  } finally {
+    // Cleanup has its own budget: exhausting the PR deadline must not skip removal.
+    const cleanupStart = deps.now();
+    try {
+      const out = deps.git(['worktree', 'remove', '--force', checkout], { cwd: root, timeout: 30_000 });
+      steps.push({ name: 'worktree remove', ok: true, seconds: (deps.now() - cleanupStart) / 1000, tail: tail(out) });
+    } catch (error) {
+      steps.push({ name: 'worktree remove', ok: false, seconds: (deps.now() - cleanupStart) / 1000, tail: tail(errorOutput(error)) });
+      ok = false;
+    }
+    try { rmSync(workspace, { recursive: true, force: true }); }
+    catch (error) { steps.push({ name: 'remove temporary folder', ok: false, seconds: 0, tail: tail(errorOutput(error)) }); ok = false; }
+    if (existsSync(workspace)) { steps.push({ name: 'remove temporary folder', ok: false, seconds: 0, tail: 'temporary folder still exists' }); ok = false; }
+  }
+  return { pr, mergeSha, ok, steps };
+}