elanous 0.2.9 → 0.2.10

package/scripts/publish-internal-dist.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 import { createHash } from 'node:crypto';
 import { spawnSync } from 'node:child_process';
-import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, rmSync, statSync, symlinkSync, writeFileSync } from 'node:fs';
+import { existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, rmSync, statSync, symlinkSync, writeFileSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { spawnSyncText } from '../src/util/spawn-sync-output.js';
 
@@ -74,11 +74,21 @@ export function publishInternalDist(checkout: string, out: string, keep = 3): {
     } else {
       renameSync(staging, target);
     }
+    const alias = join(download, `v${pkg.version}`);
+    try {
+      if (!lstatSync(alias).isSymbolicLink()) throw new Error(`version alias is not a symlink: ${alias}`);
+    } catch (error) {
+      if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;
+    }
     mkdirSync(join(out, 'latest'), { recursive: true });
     link = join(out, 'latest', `.download-${process.pid}-${Date.now()}`);
     symlinkSync(`../download/${name}`, link, 'dir');
     renameSync(link, join(out, 'latest', 'download'));
     link = undefined;
+    link = join(download, `.alias-${process.pid}-${Date.now()}`);
+    symlinkSync(name, link, 'dir');
+    renameSync(link, alias);
+    link = undefined;
     const versions = readdirSync(download, { withFileTypes: true })
       .filter((entry) => entry.isDirectory() && /^v[0-9A-Za-z][0-9A-Za-z._-]*-[0-9a-f]{12}$/.test(entry.name))
       .map((entry) => ({ name: entry.name, mtime: statSync(join(download, entry.name)).mtimeMs }))

package/scripts/release-loop/cutoff.ts

@@ -62,20 +62,30 @@ function landingAt(sha: string, title: string): ReleaseLanding {
   };
 }
 
-/** next.md lines at the cutoff, each tied to the last landing in range whose diff added that exact line. */
-function nextMdNotes(cutoff: string, landings: ReleaseLanding[]): NextMdNote[] {
+/**
+ * next.md lines added between the baseline and the cutoff, each tied to the last landing in range whose diff added that
+ * exact line. Lines already in the file at the baseline shipped with an earlier release and are left out (REL7b).
+ */
+function nextMdNotes(baseline: string, cutoff: string, landings: ReleaseLanding[]): { notes: NextMdNote[]; carried: number } {
   const text = git(['show', `${cutoff}:${NEXT_MD}`], true);
-  if (!text) return [];
+  if (!text) return { notes: [], carried: 0 };
+  const inRange = new Set(addedLines(requiredGit(['diff', '-U0', baseline, cutoff, '--', NEXT_MD])));
   const addedBy = new Map<string, string>();
   for (const landing of landings) {
     if (!landing.changedFiles.includes(NEXT_MD)) continue;
     const diff = requiredGit(['show', '-m', '--first-parent', '--format=', '-U0', landing.sha, '--', NEXT_MD]);
-    for (const line of diff.split('\n')) if (line.startsWith('+') && !line.startsWith('+++')) addedBy.set(line.slice(1).trim(), landing.sha);
+    for (const line of addedLines(diff)) addedBy.set(line, landing.sha);
   }
-  return parseNextMdNotes(text).map((note) => {
-    const sha = note.raw ? addedBy.get(note.raw) : undefined;
+  const all = parseNextMdNotes(text);
+  const notes = all.filter((note) => note.raw !== undefined && inRange.has(note.raw)).map((note) => {
+    const sha = addedBy.get(note.raw!);
     return { kind: note.kind, line: note.line, ...(sha ? { sha } : {}) };
   });
+  return { notes, carried: all.length - notes.length };
+}
+
+function addedLines(diff: string): string[] {
+  return diff.split('\n').filter((line) => line.startsWith('+') && !line.startsWith('+++')).map((line) => line.slice(1).trim());
 }
 
 function runningGoalPaths(): string[] {
@@ -135,12 +145,13 @@ export function main(args: string[] = process.argv.slice(2)): void {
   const instanceRoot = effectiveInstanceRoot();
   const notes = readReleaseNotes(releaseNotesDir(instanceRoot));
   debug.log('release.notes', 'read', { fragments: notes.size, problems: notes.problems });
+  const nextMd = nextMdNotes(baselineSha, cutoff, landings);
   const manifest = buildReleaseManifest({
-    version, baseline: { ref: baseline.ref, sha: baselineSha }, cutoff: { sha: cutoff }, landings, notes, nextMd: nextMdNotes(cutoff, landings),
+    version, baseline: { ref: baseline.ref, sha: baselineSha }, cutoff: { sha: cutoff }, landings, notes, nextMd: nextMd.notes,
     runningGoalPaths: runningGoalPaths(), publicCommandsBefore: commandsAt(baselineSha), publicCommandsAfter: commandsAt(cutoff),
   });
   const output = { ...manifest, baselineSource: baseline.source };
-  debug.log('release-loop.notes', 'fragments', { version, ...manifest.fragments });
+  debug.log('release-loop.notes', 'fragments', { version, ...manifest.fragments, carriedFromEarlier: nextMd.carried });
   const directory = join(instanceRoot, 'release', version);
   mkdirSync(directory, { recursive: true });
   writeFileSync(join(directory, 'manifest.json'), JSON.stringify(output, null, 2) + '\n');

package/scripts/release-loop/ops-upgrade-node.ts

@@ -1,8 +1,29 @@
 #!/usr/bin/env bun
+import { existsSync, readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
+import { join, isAbsolute } from 'node:path';
+import { debug } from '../../src/debug/log.js';
 import { errorResult, finishNode, lastResult, nodeOutput, readGraphContext, runCommand, type CommandResult, type CommandRunner } from './node-verdict.js';
 
-interface HostResult { host: string; ok: boolean; before: string; after: string; error?: string; skipped?: string; hooks?: string }
+interface HostResult { host: string; ok: boolean; before: string; after: string; error?: string; skipped?: string; hooks?: string; restart?: 'no-service' }
+interface OpsUpgradeDeps { exists?: (path: string) => boolean; installSource?: () => string | null }
+
+function localInstallSource(): string | null {
+  try {
+    const data: unknown = JSON.parse(readFileSync(join(homedir(), '.local/share/elanous/install.json'), 'utf8'));
+    return data && typeof data === 'object' && 'source' in data && typeof data.source === 'string' ? data.source : null;
+  } catch { return null; }
+}
+
+function installedMatches(installed: unknown, version: string, checkout: boolean): boolean {
+  return installed === version || checkout && typeof installed === 'string'
+    && installed.startsWith(`${version}-`) && /^[0-9a-f]{12}$/.test(installed.slice(version.length + 1));
+}
+
+function missingService(data: Record<string, unknown> | undefined): boolean {
+  return typeof data?.reason === 'string'
+    && /^재시작 실패:\s*(?:Could not find service\s+"?com\.elanous\.nexus\b|(?:Failed to restart elanous-nexus\.service:\s*)?Unit elanous-nexus(?:\.service)? not found\b)/i.test(data.reason);
+}
 
 function firstLine(text: string): string { return text.trim().split(/\r?\n/)[0]?.trim() ?? ''; }
 
@@ -15,7 +36,7 @@ function reason(result: CommandResult): string {
 
 function quote(value: string): string { return `'${value.replaceAll("'", "'\\''")}'`; }
 
-export function runOpsUpgrade(run: CommandRunner = runCommand) {
+export function runOpsUpgrade(run: CommandRunner = runCommand, deps: OpsUpgradeDeps = {}) {
   const context = readGraphContext();
   const hosts = context.input.opsHosts;
   if (hosts === undefined || (Array.isArray(hosts) && hosts.length === 0)) {
@@ -27,9 +48,12 @@ export function runOpsUpgrade(run: CommandRunner = runCommand) {
   if (nodeOutput(context, 'publish', 'tag') !== `v${version}`) throw new Error('published tag/version mismatch');
   const internalDist = context.input.internalDist;
   if (internalDist !== undefined && (typeof internalDist !== 'string' || !internalDist.trim())) throw new Error('input.internalDist must be a path string');
-  const feedPath = typeof internalDist === 'string' && internalDist.startsWith('~/') ? `${homedir()}/${internalDist.slice(2)}` : internalDist;
+  const defaultFeed = join(homedir(), '.local/share/elanous-ops/internal-dist');
+  const feedPath = typeof internalDist === 'string'
+    ? internalDist.startsWith('~/') ? `${homedir()}/${internalDist.slice(2)}` : internalDist
+    : (deps.exists ?? existsSync)(defaultFeed) ? defaultFeed : undefined;
   let feedError = '';
-  if (typeof feedPath === 'string') {
+  if (feedPath !== undefined) {
     try {
       const feed = run('bun', ['scripts/publish-internal-dist.ts', '--checkout', process.cwd(), '--out', feedPath]);
       const data = lastResult(feed);
@@ -38,8 +62,15 @@ export function runOpsUpgrade(run: CommandRunner = runCommand) {
   }
   const results: HostResult[] = [];
   for (const host of hosts as string[]) {
+    const source = host === 'local' ? (deps.installSource ?? localInstallSource)() : null;
+    const checkout = host === 'local' && source !== null && isAbsolute(source);
+    const path = checkout ? 'checkout' as const : 'release' as const;
+    const record = (result: HostResult) => {
+      results.push(result);
+      debug.log('release-loop.ops-upgrade', 'host', { host, path, restart: result.restart ?? (context.input.opsRestart === true ? result.ok ? 'ok' : 'failed' : 'skipped'), ok: result.ok });
+    };
     if (host !== 'local' && feedError) {
-      results.push({ host, ok: false, before: '', after: '', skipped: '내부 피드 발행 실패', error: feedError });
+      record({ host, ok: false, before: '', after: '', skipped: '내부 피드 발행 실패', error: feedError });
       continue;
     }
     const command = (args: string[]): CommandResult => host === 'local'
@@ -51,22 +82,46 @@ export function runOpsUpgrade(run: CommandRunner = runCommand) {
     try {
       const previous = command(['--version']);
       if (previous.status === 0) before = firstLine(previous.stdout);
-      const updated = command(['update', '--version', version, '--json', ...(context.input.opsRestart === true ? ['--restart'] : [])]);
+      if (checkout) {
+        const git = (args: string[]) => run('git', args, source!);
+        const dirty = git(['status', '--porcelain', '--untracked-files=all']);
+        if (dirty.status !== 0 || dirty.stdout.trim()) {
+          record({ host, ok: false, before, after, error: dirty.status === 0 ? '체크아웃 변경 있음' : `체크아웃 상태 확인 실패: ${reason(dirty)}` });
+          continue;
+        }
+        const fetched = git(['fetch', '--tags']);
+        if (fetched.status !== 0) {
+          record({ host, ok: false, before, after, error: `태그 가져오기 실패: ${reason(fetched)}` });
+          continue;
+        }
+        const tag = git(['rev-parse', '--verify', `refs/tags/v${version}^{commit}`]);
+        if (tag.status !== 0 || !tag.stdout.trim()) {
+          record({ host, ok: false, before, after, error: `태그 없음: v${version}` });
+          continue;
+        }
+        const moved = git(['checkout', '--detach', `v${version}`]);
+        if (moved.status !== 0) {
+          record({ host, ok: false, before, after, error: `체크아웃 전환 실패: ${reason(moved)}` });
+          continue;
+        }
+      }
+      const updated = command(['update', ...(checkout || host !== 'local' && feedPath !== undefined ? [] : ['--version', version]), '--json', ...(context.input.opsRestart === true ? ['--restart'] : [])]);
       const updateResult = lastResult(updated);
-      if (updated.status !== 0 || updateResult?.exitCode !== 0 || updateResult.installedVersion !== version) {
-        const error = updated.status === 0 && updateResult?.exitCode === 0
-          ? `설치판 불일치 (기대 ${version}, 실제 ${String(updateResult.installedVersion)})` : reason(updated);
-        results.push({ host, ok: false, before, after, error });
+      const noService = host !== 'local' && context.input.opsRestart === true && updateResult?.exitCode === 1 && missingService(updateResult);
+      if ((!noService && (updated.status !== 0 || updateResult?.exitCode !== 0)) || !installedMatches(updateResult?.installedVersion, version, checkout)) {
+        const error = (updated.status === 0 && updateResult?.exitCode === 0 || noService)
+          ? `설치판 불일치 (기대 ${version}, 실제 ${String(updateResult?.installedVersion)})` : reason(updated);
+        record({ host, ok: false, before, after, error });
         continue;
       }
       const current = command(['--version']);
       if (current.status !== 0) {
-        results.push({ host, ok: false, before, after, error: reason(current) });
+        record({ host, ok: false, before, after, error: reason(current) });
         continue;
       }
       after = firstLine(current.stdout);
-      if (after.split(/\s+/)[0] !== version) {
-        results.push({ host, ok: false, before, after, error: `올렸는데 판이 그대로 (기대 ${version}, 실제 ${after || '없음'})` });
+      if (!installedMatches(after.split(/\s+/)[0], version, checkout)) {
+        record({ host, ok: false, before, after, error: `올렸는데 판이 그대로 (기대 ${version}, 실제 ${after || '없음'})` });
         continue;
       }
       // The webhook receiver (`elanous hooks serve`, a user systemd unit on the bot VM) keeps the old code until it
@@ -76,16 +131,17 @@ export function runOpsUpgrade(run: CommandRunner = runCommand) {
         const restarted = run('ssh', [host, 'systemctl --user try-restart elanous-hooks.service 2>/dev/null && systemctl --user is-active elanous-hooks.service 2>/dev/null || echo absent']);
         hooks = firstLine(restarted.stdout) || 'absent';
       }
-      results.push({ host, ok: true, before, after, ...(hooks ? { hooks } : {}) });
+      record({ host, ok: true, before, after, ...(hooks ? { hooks } : {}), ...(noService ? { restart: 'no-service' as const } : {}) });
     } catch (error) {
-      results.push({ host, ok: false, before, after, error: firstLine(String(error)) });
+      record({ host, ok: false, before, after, error: firstLine(String(error)) });
     }
   }
   const failures = results.filter((result) => !result.ok);
   return { outcome: failures.length || feedError ? 'fail' as const : 'ok' as const,
     verdict: failures.length || feedError ? 'fail' as const : 'pass' as const,
     summary: failures.length ? `운영 판올림 실패: ${failures.map(({ host, error }) => `${host}: ${error}`).join('; ')}${feedError && !failures.some((item) => item.skipped) ? `; ${feedError}` : ''}`
-      : feedError || `운영 판올림 ${version} · ${results.length}대 확인`, hosts: results };
+      : feedError || `운영 판올림 ${version} · ${results.length}대 확인`,
+    feed: feedError ? 'failed' as const : feedPath === undefined ? 'skipped-no-path' as const : 'published' as const, hosts: results };
 }
 
 if (import.meta.main) {

package/scripts/release-loop/release-readiness.ts

@@ -2,10 +2,13 @@ import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { releaseLedgerRoot } from '../../src/instance/resolve.js';
 import { checklistGate, type ChecklistGate } from '../../src/release-loop/checklist.js';
+import { getSchedule, formatKst } from '../../src/release-loop/release-schedule.js';
+import { debug } from '../../src/debug/log.js';
 
 export type ReleaseReadiness =
   | { ready: false; reason: 'already-published'; details: string }
   | { ready: false; reason: 'already-running'; details: string }
+  | { ready: false; reason: 'before-cut'; details: string }
   | { ready: false; reason: 'checklist-blocked'; details: ChecklistGate }
   | { ready: true; reason: 'ready'; details: ChecklistGate };
 
@@ -13,6 +16,7 @@ export interface ReleaseReadinessDeps {
   ledgerRoot?: string;
   checklist?: typeof checklistGate;
   isPidAlive?: (pid: number) => boolean;
+  now?: () => Date;
 }
 
 function readIfPresent(path: string): string | undefined {
@@ -52,6 +56,11 @@ export function releaseReadiness(version: string, deps: ReleaseReadinessDeps = {
       return { ready: false, reason: 'already-running', details: String(pid) };
     }
   }
+  const schedule = getSchedule(version, deps.ledgerRoot);
+  if (schedule && (deps.now ?? (() => new Date()))().getTime() < Date.parse(schedule.cutAt)) {
+    debug.log('release.schedule', 'before-cut', { version, cutAt: schedule.cutAt, landBy: schedule.landBy });
+    return { ready: false, reason: 'before-cut', details: `before-cut (${formatKst(schedule.cutAt)})` };
+  }
   const gate = (deps.checklist ?? checklistGate)(version);
   if (!gate.ok) return { ready: false, reason: 'checklist-blocked', details: gate };
   return { ready: true, reason: 'ready', details: gate };

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';
@@ -55,7 +55,16 @@ function versionAt(repo: string): string {
   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): Output {
   const target = kind === 'release' ? releaseVersion : nextDevVersion(releaseVersion);
   const source = kind === 'release' ? `${releaseVersion}-dev.N` : releaseVersion;
   fetchMain(repo);
@@ -85,6 +94,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,
@@ -111,24 +155,28 @@ 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;
   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>] --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; }
       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 }; outputs?: Record<string, { commit?: unknown } | undefined> };
+      if (!version && typeof context.input?.version === 'string') version = context.input.version;
+      // The cut = the commit version-release landed (what cutoff and the gate measured).
+      const cutCommit = context.outputs?.['version-release']?.commit;
+      if (!cut && typeof cutCommit === 'string' && cutCommit) cut = cutCommit;
     }
     if (!version) throw new Error('version required (--version or ELANOUS_GRAPH_CONTEXT.input.version)');
     nextDevVersion(version);
-    return landing(resolve(repo), kind, version);
+    return landing(resolve(repo), kind, version, cut);
   } 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/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);
 }