elanous 0.2.25 → 0.2.27

package/src/machines/machine-ledger.ts

@@ -10,6 +10,16 @@ export interface MachineRow {
   locationStatus: string;
   role: string;
   duties: string;
+  /** Fleet intent only. Live membership comes from Nexus machine resources. */
+  fleet?: MachineFleetIntent;
+}
+
+export interface MachineFleetIntent {
+  sshName: string;
+  role: 'worker' | 'hq';
+  platform: 'darwin' | 'linux' | 'wsl';
+  podPool: string;
+  cap: number;
 }
 
 export interface DeviceRow {
@@ -59,18 +69,36 @@ export function validateMachineLedger(value: unknown): MachineLedger {
   keys(data, ['title', 'policy', 'machines', 'devices', 'rules', 'changes'], 'ledger');
   if (!Array.isArray(data.machines) || !Array.isArray(data.devices)) throw new Error('invalid machines or devices');
   const ids = new Set<string>();
-  const rows = <T extends { id: string }>(entries: unknown[], fields: string[], label: string): T[] => entries.map((entry, index) => {
+  const rows = <T extends { id: string }>(entries: unknown[], fields: string[], label: string, extraFields: string[] = []): T[] => entries.map((entry, index) => {
     const row = record(entry, `${label}[${index}]`);
-    keys(row, fields, label);
+    keys(row, [...fields, ...extraFields], label);
     const result = Object.fromEntries(fields.map((field) => [field, text(row[field], `${label}.${field}`)])) as T;
     if (!idPattern.test(result.id) || ids.has(result.id)) throw new Error(`empty, duplicate or invalid id: ${result.id}`);
     ids.add(result.id);
     return result;
   });
+  const machines = rows<MachineRow>(data.machines, ['id', 'name', 'specs', 'locationStatus', 'role', 'duties'], 'machines', ['fleet']);
+  const sshNames = new Set<string>();
+  for (let index = 0; index < machines.length; index++) {
+    const raw = record(data.machines[index], `machines[${index}]`);
+    if (raw.fleet === undefined) continue;
+    const fleet = record(raw.fleet, `machines[${index}].fleet`);
+    keys(fleet, ['sshName', 'role', 'platform', 'podPool', 'cap'], 'fleet');
+    const sshName = text(fleet.sshName, 'fleet.sshName');
+    const role = text(fleet.role, 'fleet.role');
+    const platform = text(fleet.platform, 'fleet.platform');
+    const podPool = text(fleet.podPool, 'fleet.podPool');
+    if (!idPattern.test(sshName) || sshNames.has(sshName)) throw new Error(`duplicate or invalid fleet.sshName: ${sshName}`);
+    if (role !== 'worker' && role !== 'hq') throw new Error(`invalid fleet.role: ${role}`);
+    if (platform !== 'darwin' && platform !== 'linux' && platform !== 'wsl') throw new Error(`invalid fleet.platform: ${platform}`);
+    if (!Number.isSafeInteger(fleet.cap) || (fleet.cap as number) < 0) throw new Error('invalid fleet.cap');
+    sshNames.add(sshName);
+    machines[index]!.fleet = { sshName, role, platform, podPool, cap: fleet.cap as number };
+  }
   return {
     title: text(data.title, 'title'),
     policy: list(data.policy, 'policy'),
-    machines: rows<MachineRow>(data.machines, ['id', 'name', 'specs', 'locationStatus', 'role', 'duties'], 'machines'),
+    machines,
     devices: rows<DeviceRow>(data.devices, ['id', 'name', 'status', 'purpose'], 'devices'),
     rules: list(data.rules, 'rules'),
     changes: list(data.changes, 'changes'),

package/src/maturity/cli-maturity.ts

@@ -18,14 +18,24 @@ export function cliRootVisibleFor(name: string, role: Role, { showAll }: { showA
   return grade === 'stable' || (role === 'contributor' && (grade === 'beta' || grade === 'tool'));
 }
 
-/** Only help is filtered: Commander still dispatches explicitly typed commands. */
-export function filterCliRootHelp(commands: readonly Command[], role: Role, showAll: boolean): { shown: number; hidden: number } {
+/** Root --help first screen (SETUP-HELP-SLIM): the three stable onboarding commands. */
+export const FIRST_SCREEN_COMMANDS: readonly string[] = ['start', 'setup', 'ask'];
+
+/**
+ * Only help is filtered: Commander still dispatches explicitly typed commands.
+ * firstScreen narrows the visible set to FIRST_SCREEN_COMMANDS and showAll wins over it;
+ * the caller opts in per role — the wired default (deferred slice) enables it for the
+ * general role only, so owner/contributor keep today's list.
+ */
+export function filterCliRootHelp(commands: readonly Command[], role: Role, showAll: boolean, firstScreen: boolean = false): { shown: number; hidden: number } {
+  const firstScreenActive = firstScreen && !showAll;
   let shown = 0;
   let hidden = 0;
   for (const command of commands) {
     const grade = cliRootMaturity(command.name(), commands);
     if (!grade) throw new Error(`cliRoot 에 등급 없는 명령: ${command.name()}`);
-    const visible = cliRootVisibleFor(command.name(), role, { showAll }, commands);
+    const visible = cliRootVisibleFor(command.name(), role, { showAll }, commands)
+      && (!firstScreenActive || FIRST_SCREEN_COMMANDS.includes(command.name()));
     (command as Command & { _hidden: boolean })._hidden = !visible;
     if (visible) shown++;
     else hidden++;

package/src/msg/msg-store.ts

@@ -1,5 +1,5 @@
 import { Database } from 'bun:sqlite';
-import { mkdirSync } from 'node:fs';
+import { existsSync, mkdirSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { elanousStateRoot } from '../autopilot/state-paths.js';
 
@@ -20,7 +20,7 @@ export interface UnreadRecipient {
   count: number;
 }
 
-const SEAT_ALIASES: Readonly<Record<string, string>> = {
+export const SEAT_ALIASES: Readonly<Record<string, string>> = {
   S: 'OP', OP: 'OP', COO: 'OP',
   T: 'MK', MK: 'MK', CMO: 'MK',
   O: 'TC', TC: 'TC', CTO: 'TC',
@@ -41,6 +41,7 @@ export function validateMessageEnvelope(input: unknown): MessageEnvelope {
   const record = input as Record<string, unknown>;
   const from = canonicalSeatId(record.from as string);
   const to = canonicalSeatId(record.to as string);
+  if (from === 'ALL') throw new Error('ALL cannot send messages');
   if (typeof record.body !== 'string' || !record.body.trim()) throw new Error('message body must be nonempty');
   if (record.kind !== undefined && (typeof record.kind !== 'string' || !/^[a-z][a-z0-9_-]{0,63}$/.test(record.kind))) {
     throw new Error('invalid message kind');
@@ -54,6 +55,13 @@ function validCursor(cursor: number): number {
   return cursor;
 }
 
+function unreadCountOn(db: Database, to: string): number {
+  return (db.query(`SELECT COUNT(*) AS count FROM msg_messages m
+    WHERE m.id > COALESCE((SELECT last_id FROM msg_cursors WHERE recipient = ?), 0)
+      AND (m.recipient = ? OR (m.recipient = 'ALL' AND m.sender <> ?))`)
+    .get(to, to, to) as { count: number }).count;
+}
+
 interface MessageRow {
   id: number;
   sender: string;
@@ -88,10 +96,37 @@ export class MsgStore {
     CREATE TABLE IF NOT EXISTS msg_cursors (
       recipient TEXT PRIMARY KEY,
       last_id INTEGER NOT NULL DEFAULT 0 CHECK(last_id >= 0)
+    );
+    CREATE TABLE IF NOT EXISTS msg_provenance (
+      provenance_key TEXT PRIMARY KEY,
+      message_id INTEGER NOT NULL REFERENCES msg_messages(id)
     );`);
   }
 
   append(input: MessageEnvelope): Message {
+    return this.insertMessage(input);
+  }
+
+  /** Append once for a provenance key such as coord:<commentId>:<recipient>. */
+  appendWithProvenance(input: MessageEnvelope, provenanceKey: string): Message {
+    if (typeof provenanceKey !== 'string' || !/^coord:[^:]+:[^:]+$/.test(provenanceKey)) {
+      throw new Error('invalid message provenance key');
+    }
+    const msg = validateMessageEnvelope(input);
+    if (provenanceKey.split(':')[2] !== msg.to) throw new Error('provenance recipient does not match message recipient');
+    return this.db.transaction(() => {
+      const existing = this.db.query(`SELECT m.id, m.sender, m.recipient, m.body, m.kind, m.created_at
+        FROM msg_provenance p JOIN msg_messages m ON m.id = p.message_id WHERE p.provenance_key = ?`)
+        .get(provenanceKey) as MessageRow | null;
+      if (existing) return fromRow(existing);
+      const message = this.insertMessage(msg);
+      this.db.query('INSERT INTO msg_provenance(provenance_key, message_id) VALUES (?, ?)')
+        .run(provenanceKey, message.id);
+      return message;
+    }).immediate();
+  }
+
+  private insertMessage(input: MessageEnvelope): Message {
     const msg = validateMessageEnvelope(input);
     const createdAt = new Date().toISOString();
     const result = this.db.query(`INSERT INTO msg_messages(sender, recipient, body, kind, created_at)
@@ -104,10 +139,12 @@ export class MsgStore {
   /** Messages strictly after the supplied cursor, ordered by durable insertion ID. */
   listByRecipient(recipient: string, after: number = 0, limit: number = 100): Message[] {
     const to = canonicalSeatId(recipient);
+    if (to === 'ALL') throw new Error('ALL is a topic, not a recipient');
     validCursor(after);
     if (!Number.isSafeInteger(limit) || limit < 1 || limit > 1000) throw new Error('limit must be between 1 and 1000');
     return (this.db.query(`SELECT id, sender, recipient, body, kind, created_at FROM msg_messages
-      WHERE recipient = ? AND id > ? ORDER BY id ASC LIMIT ?`).all(to, after, limit) as MessageRow[]).map(fromRow);
+      WHERE id > ? AND (recipient = ? OR (recipient = 'ALL' AND sender <> ?))
+      ORDER BY id ASC LIMIT ?`).all(after, to, to, limit) as MessageRow[]).map(fromRow);
   }
 
   list(recipient: string, after: number = 0, limit: number = 100): Message[] {
@@ -116,12 +153,14 @@ export class MsgStore {
 
   getCursor(recipient: string): number {
     const to = canonicalSeatId(recipient);
+    if (to === 'ALL') throw new Error('ALL is a topic, not a recipient');
     return (this.db.query('SELECT last_id FROM msg_cursors WHERE recipient = ?').get(to) as { last_id: number } | null)?.last_id ?? 0;
   }
 
   /** Atomically reject future IDs and keep concurrent or stale acknowledgements from rewinding. */
   advanceCursor(recipient: string, cursor: number): number {
     const to = canonicalSeatId(recipient);
+    if (to === 'ALL') throw new Error('ALL is a topic, not a recipient');
     validCursor(cursor);
     const result = this.db.query(`INSERT INTO msg_cursors(recipient, last_id)
       SELECT ?, ? WHERE ? <= (SELECT COALESCE(MAX(id), 0) FROM msg_messages)
@@ -133,11 +172,24 @@ export class MsgStore {
 
   ack(recipient: string, cursor: number): number { return this.advanceCursor(recipient, cursor); }
 
+  unreadCount(recipient: string): number {
+    const to = canonicalSeatId(recipient);
+    if (to === 'ALL') throw new Error('ALL is a topic, not a recipient');
+    return unreadCountOn(this.db, to);
+  }
+
   unreadRecipients(): UnreadRecipient[] {
-    return this.db.query(`SELECT m.recipient AS recipient, COUNT(*) AS count
-      FROM msg_messages m LEFT JOIN msg_cursors c ON c.recipient = m.recipient
-      WHERE m.id > COALESCE(c.last_id, 0)
-      GROUP BY m.recipient ORDER BY m.recipient ASC`).all() as UnreadRecipient[];
+    return this.db.query(`WITH recipients(recipient) AS (
+        SELECT 'OP' UNION SELECT 'MK' UNION SELECT 'TC' UNION SELECT 'UX'
+        UNION SELECT recipient FROM msg_messages WHERE recipient <> 'ALL'
+        UNION SELECT recipient FROM msg_cursors WHERE recipient <> 'ALL'
+      )
+      SELECT r.recipient AS recipient, COUNT(m.id) AS count
+      FROM recipients r
+      LEFT JOIN msg_cursors c ON c.recipient = r.recipient
+      JOIN msg_messages m ON m.id > COALESCE(c.last_id, 0)
+        AND (m.recipient = r.recipient OR (m.recipient = 'ALL' AND m.sender <> r.recipient))
+      GROUP BY r.recipient ORDER BY r.recipient ASC`).all() as UnreadRecipient[];
   }
 
   unread(): UnreadRecipient[] { return this.unreadRecipients(); }
@@ -147,3 +199,13 @@ export class MsgStore {
 
 export function defaultMsgStorePath(): string { return join(elanousStateRoot(), 'msg', 'messages.db'); }
 export function openMsgStore(path?: string): MsgStore { return new MsgStore(path); }
+
+/** Observe one recipient without creating a store or advancing its acknowledgement. */
+export function readUnreadCount(recipient: string, path: string = defaultMsgStorePath()): number | null {
+  const to = canonicalSeatId(recipient);
+  if (to === 'ALL') throw new Error('ALL is a topic, not a recipient');
+  if (!existsSync(path)) return null;
+  const db = new Database(path, { readonly: true });
+  try { return unreadCountOn(db, to); }
+  finally { db.close(); }
+}

package/src/ops/overview-collect.ts

@@ -16,6 +16,7 @@ import {
   type OverviewSnapshot, type OwnerTaskRow, type ParentsInfo, type PodMemberRow, type ReleaseRunInfo, type ScheduleInfo,
 } from './overview.js';
 import { SEAT_ERA_SOURCE, readDispatcherBeats, readDispatcherCapacity, readSeatEraHanded, seatEraFeederDir } from './overview-seat-era.js';
+import { matchesOverviewOwner, normalizeOverviewOwner } from './overview-owner.js';
 
 const GB = 1024 ** 3;
 /** 하트비트 주기 30 s × 2 (RFC §A2 «낡음»). */
@@ -77,8 +78,8 @@ export function ownerRows(cards: readonly TaskCard[], sinceIso: string, ownerFil
   const rows: Record<string, OwnerTaskRow> = {};
   for (const card of cards) {
     if (!card || typeof card.createdAt !== 'string' || card.createdAt < sinceIso) continue;
-    const owner = card.seat ? `seat:${card.seat}` : 'unassigned';
-    if (ownerFilter && ownerFilter !== 'all' && owner !== ownerFilter && owner !== `seat:${ownerFilter}`) continue;
+    const owner = normalizeOverviewOwner(card.seat);
+    if (ownerFilter !== undefined && !matchesOverviewOwner(owner, ownerFilter)) continue;
     const row = rows[owner] ??= { handed: 0, launched: 0, prBound: 0, failed: 0, launchFailed: 0 };
     if (card.status === 'handed') row.handed++;
     else if (card.status === 'launched') row.launched++;

package/src/ops/overview-owner.ts

@@ -0,0 +1,29 @@
+/** Owner labels used by ops overview task rows and the --owner filter. */
+type OverviewOwnerKind = 'seat' | 'steward' | 'orchestrator' | 'external';
+type OverviewOwner = `${OverviewOwnerKind}:${string}` | 'unassigned';
+
+const OWNER_KINDS = new Set<OverviewOwnerKind>(['seat', 'steward', 'orchestrator', 'external']);
+
+/** Normalize a task-card owner into a stable kind-prefixed overview key. */
+export function normalizeOverviewOwner(value: unknown): OverviewOwner {
+  if (typeof value !== 'string' || value.trim() === '') return 'unassigned';
+  const normalized = value.trim();
+  const separator = normalized.indexOf(':');
+  if (separator >= 0) {
+    const kind = normalized.slice(0, separator).toLowerCase() as OverviewOwnerKind;
+    const name = normalized.slice(separator + 1).trim();
+    if (OWNER_KINDS.has(kind) && name) return `${kind}:${name}`;
+  }
+  const kind = normalized.toLowerCase();
+  if (kind === 'steward' || kind === 'orchestrator' || kind === 'external') return `${kind}:default`;
+  return `seat:${normalized}`;
+}
+
+/** Whether a normalized owner key matches a CLI filter, accepting either the full key or its kind. */
+export function matchesOverviewOwner(owner: OverviewOwner, filter?: string): boolean {
+  if (!filter || filter === 'all') return true;
+  const normalizedFilter = filter.trim();
+  if (!normalizedFilter) return true;
+  if (normalizedFilter.toLowerCase() === 'unassigned') return owner === 'unassigned';
+  return owner === normalizeOverviewOwner(normalizedFilter) || owner.startsWith(`${normalizedFilter.toLowerCase()}:`);
+}

package/src/plugin-hooks/shell-hook.ts

@@ -118,6 +118,7 @@ function runShell(opts: RunShellOpts): Promise<RunShellResult> {
     let stdout = '';
     let stderrBuffer = '';
     let killed = false;
+    let stdinError: string | undefined;
     const onAbort = () => {
       if (!killed) {
         killed = true;
@@ -132,6 +133,14 @@ function runShell(opts: RunShellOpts): Promise<RunShellResult> {
     opts.abortSignal.addEventListener('abort', onAbort, { once: true });
 
     child.stdout?.on('data', (chunk) => { stdout += String(chunk); });
+    // A short-lived command can close its read end before end() finishes.
+    // EPIPE says only that stdin was unread; stdout and exit status still
+    // determine the hook result. Other pipe errors are real I/O failures.
+    child.stdin?.on('error', (err: NodeJS.ErrnoException) => {
+      if (err.code === 'EPIPE') return;
+      stdinError = `stdin error: ${err.message}`;
+      opts.onStderr(stdinError);
+    });
     child.stderr?.on('data', (chunk) => {
       stderrBuffer += String(chunk);
       let idx;
@@ -145,13 +154,19 @@ function runShell(opts: RunShellOpts): Promise<RunShellResult> {
       clearTimeout(timer);
       if (stderrBuffer.trim()) opts.onStderr(stderrBuffer.trim());
       // killed => treat as a non-zero exit so dispatcher abort.
-      resolve({ stdout, exitCode: killed ? 124 : (code ?? 1) });
+      resolve({ stdout, exitCode: killed ? 124 : stdinError ? 127 : (code ?? 1), error: stdinError });
     });
     child.on('error', (err) => {
       clearTimeout(timer);
       opts.onStderr(`spawn error: ${err.message}`);
       resolve({ stdout, exitCode: 127 });
     });
-    try { child.stdin?.end(opts.stdin); } catch { /* pipe may have closed */ }
+    try { child.stdin?.end(opts.stdin); }
+    catch (err) {
+      if ((err as NodeJS.ErrnoException).code !== 'EPIPE') {
+        stdinError = `stdin error: ${(err as Error).message}`;
+        opts.onStderr(stdinError);
+      }
+    }
   });
 }

package/src/plugin-missions/evaluator-runner.ts

@@ -137,6 +137,7 @@ function runShell(opts: RunShellOpts): Promise<RunShellResult> {
     let stderrBuf = '';
     let killed = false;
     let timedOut = false;
+    let stdinError: string | undefined;
     const kill = (timeout: boolean) => {
       if (killed) return;
       killed = true;
@@ -150,6 +151,14 @@ function runShell(opts: RunShellOpts): Promise<RunShellResult> {
     opts.abortSignal.addEventListener('abort', () => kill(false), { once: true });
 
     child.stdout?.on('data', (chunk) => { stdout += String(chunk); });
+    // Early exit may close stdin before end() finishes. A broken pipe must
+    // not replace the child's stdout/exit result; other write errors must
+    // surface as evaluator errors.
+    child.stdin?.on('error', (err: NodeJS.ErrnoException) => {
+      if (err.code === 'EPIPE') return;
+      stdinError = `stdin error: ${err.message}`;
+      opts.onStderr(stdinError);
+    });
     child.stderr?.on('data', (chunk) => {
       stderrBuf += String(chunk);
       let idx;
@@ -164,8 +173,9 @@ function runShell(opts: RunShellOpts): Promise<RunShellResult> {
       if (stderrBuf.trim()) opts.onStderr(stderrBuf.trim());
       resolve({
         stdout,
-        exitCode: timedOut ? 124 : (code ?? 1),
+        exitCode: timedOut ? 124 : stdinError ? 127 : (code ?? 1),
         timedOut,
+        error: stdinError,
       });
     });
     child.on('error', (err) => {
@@ -173,6 +183,12 @@ function runShell(opts: RunShellOpts): Promise<RunShellResult> {
       opts.onStderr(`spawn error: ${err.message}`);
       resolve({ stdout, exitCode: 127, timedOut: false });
     });
-    try { child.stdin?.end(opts.stdin); } catch { /* pipe may have closed */ }
+    try { child.stdin?.end(opts.stdin); }
+    catch (err) {
+      if ((err as NodeJS.ErrnoException).code !== 'EPIPE') {
+        stdinError = `stdin error: ${(err as Error).message}`;
+        opts.onStderr(stdinError);
+      }
+    }
   });
 }

package/src/plugins/install/plugin-install.ts

@@ -438,6 +438,13 @@ function declaresMain(packageRoot: string): boolean {
   return !existsSync(join(packageRoot, 'plugin.json')) && !existsSync(join(packageRoot, '.codex-plugin', 'plugin.json'));
 }
 
+/** [wiring] Caller: installPlugin. The PluginManifest normalized by
+ * loadPluginManifestFromDir is handed into the install path here — the install
+ * destination follows the manifest identity, never the source spec/dir name. */
+export function pluginInstallPath(root: string, market: string, manifest: PluginManifest): string {
+  return join(root, 'plugins', market, manifest.id, manifest.version);
+}
+
 export async function installPlugin(spec: string, opts: InstallOptions = {}): Promise<InstalledPlugin> {
   const root = resolve(opts.root ?? elanousStateRoot());
   const stageRoot = join(root, 'plugins', '.staging');
@@ -466,6 +473,10 @@ export async function installPlugin(spec: string, opts: InstallOptions = {}): Pr
     const manifest: PluginManifest = loadPluginManifestFromDir(join(stage, 'package'), { id: source.expectedName ?? basename(spec) }).manifest;
     if (!NAME.test(manifest.id) || !VERSION.test(manifest.version)) fail('io', 'invalid plugin name or version');
     if (source.expectedName && (manifest.id !== source.expectedName || manifest.version !== source.expectedVersion)) fail('conflict', 'market name or version differs from manifest');
+    // [wiring] installPlugin is the caller: the PluginManifest normalized above by
+    // loadPluginManifestFromDir (present manifest or the loader's manifest-absent
+    // fallback) is handed into the install path here, past the NAME/VERSION gates.
+    const destination = pluginInstallPath(root, source.market, manifest);
     const packageRoot = join(stage, 'package');
     const mainPath = inside(packageRoot, manifest.main);
     // A skills/graphs-only pack (official `elanous-basics`) declares no `main` — the default `./plugin.ts` is not a promise.
@@ -480,7 +491,6 @@ export async function installPlugin(spec: string, opts: InstallOptions = {}): Pr
       const path = inside(packageRoot, asset);
       if (!existsSync(path) || !realpathSync(path).startsWith(`${realpathSync(packageRoot)}${sep}`)) fail('io', `plugin asset not found or unsafe: ${asset}`);
     }
-    const destination = join(root, 'plugins', source.market, name, version);
     const emit = (event: InstallEvent) => opts.onEvent?.(event);
     emit({ event: 'resolve', plugin: name, version, sha256: source.sha256 });
     let security: ReturnType<typeof inspectPluginSecurity>;

package/src/prompt-enhance/enhance.ts

@@ -393,6 +393,8 @@ export async function enhancePrompt(raw: string, opts: EnhanceOpts = {}): Promis
   let complication: string | undefined;
   let decisionSignal: EnhanceResult['decisionSignal'];
   let enhancedBy: 'llm' | 'fallback' = 'llm';
+  let fallbackReason: 'llm-error' | 'empty-reply' | 'unparsed' | 'none' = 'none';
+  let replyChars = 0;
   const groundedFacts = opts.groundedFacts ?? [];
   const wantsScqa = groundedFacts.length > 0;
 
@@ -439,6 +441,10 @@ export async function enhancePrompt(raw: string, opts: EnhanceOpts = {}): Promis
         try { opts.onUsage?.(usage); } catch { /* usage observation must not change enhancement */ }
       },
     });
+    replyChars = rawOut.length;
+    if (rawOut.trim().length === 0) {
+      fallbackReason = 'empty-reply';
+    }
     const parsed = parseEnhanceJson(rawOut);
     if (parsed) {
       goal = parsed.goal;
@@ -449,9 +455,11 @@ export async function enhancePrompt(raw: string, opts: EnhanceOpts = {}): Promis
       complication = parsed.complication;
       decisionSignal = parsed.decisionSignal;
     } else {
+      fallbackReason = fallbackReason === 'empty-reply' ? 'empty-reply' : 'unparsed';
       enhancedBy = 'fallback';
     }
   } catch (e) {
+    fallbackReason = 'llm-error';
     debug.log('prompt-enhance', 'llm-error', { error: String((e as { message?: string })?.message ?? e).slice(0, 160) }, { level: 'error' });
     enhancedBy = 'fallback';
   }
@@ -461,6 +469,7 @@ export async function enhancePrompt(raw: string, opts: EnhanceOpts = {}): Promis
     checklist = extractChecklistFallback(original);
     checklistProvenance = checklist.map(() => 'unknown');
     enhancedBy = 'fallback';
+    if (fallbackReason === 'none') fallbackReason = 'unparsed';
   }
   if (!constraints.length) {
     constraints = [
@@ -515,6 +524,8 @@ export async function enhancePrompt(raw: string, opts: EnhanceOpts = {}): Promis
     enhancedChars: enhanced.length,
     checklist: checklist.length,
     enhancedBy,
+    fallbackReason,
+    replyChars,
     model,
     verbatimPreserved,
     // ⭐ 관측 — 「요약을 요구했나 / 받았나 / 옮겨 적어 버렸나」를 «다른 값»으로 남긴다.

package/src/release-loop/checklist.ts

@@ -10,6 +10,8 @@ export type ChecklistDisposition = 'move' | 'known-issue' | 'block';
 /** `screen` = a five-surface feature cell — its evidence carries a `짝:` line (MANUAL-five-surface-parity §A). `postpub` = measured after publication, outside the pre-publication gate. */
 export type ChecklistKind = 'screen' | 'postpub';
 const CHECKLIST_KINDS: readonly ChecklistKind[] = ['screen', 'postpub'];
+export type ChecklistDispatchKind = 'code' | 'ops' | 'measure' | 'decision' | 'umbrella';
+const CHECKLIST_DISPATCH_KINDS: readonly ChecklistDispatchKind[] = ['code', 'ops', 'measure', 'decision', 'umbrella'];
 export interface ChecklistItem {
   id: string;
   title: string;
@@ -27,6 +29,8 @@ export interface ChecklistItem {
   evidence?: string;
   disposition?: ChecklistDisposition;
   kind?: ChecklistKind;
+  /** Whether the seat dispatcher should launch a coding task. Missing in old rows means code. */
+  dispatchKind?: ChecklistDispatchKind;
   updatedAt: string;
   updatedBy: string;
 }
@@ -122,6 +126,37 @@ function change(data: Checklist, id: string, field: string, from: unknown, to: u
 
 const REPO_ROOT = join(import.meta.dir, '..', '..');
 
+const PATH_TOKEN = /(?:^|[^A-Za-z0-9_.\/-])((?:(?:[A-Za-z0-9_.-]+\/)+)?[A-Za-z0-9_.-]+\.(?:ts|tsx|js|jsx|mjs|cjs|json|md|yaml|yml|sh|py|css|html|toml|sql|rs|swift))(?![A-Za-z0-9_.\/-])/g;
+function mentionedPaths(text: string): string[] {
+  return [...text.matchAll(PATH_TOKEN)].map((match) => match[1]!).filter((path) => !path.split('/').includes('..'));
+}
+
+/** Shadow check at checklist authorship. Callers supply the origin/main file probe and merged-PR file reader. */
+export function inspectChecklistTargetPaths(input: {
+  title: string; evidence?: string; refs?: readonly string[]; dispatchKind?: ChecklistDispatchKind;
+}, deps: { existsAtMain: (path: string) => boolean; mergedPrFiles?: (number: number) => readonly string[] }): {
+  targets: string[]; warnings: string[]; candidates: string[];
+} {
+  const lines = input.title.split(/\r?\n/);
+  const first = /^대상 경로:\s*(.*)$/.exec(lines[0] ?? '');
+  const targets = first ? [...new Set(mentionedPaths(first[1]!))] : [];
+  const newFileDeclared = /^신설:\s*/.test(lines[1] ?? '');
+  const warnings: string[] = [];
+  if ((input.dispatchKind ?? 'code') === 'code') {
+    if (!first || !first[1]!.trim() || targets.length === 0) warnings.push('첫 줄 대상 경로가 없다');
+    for (const path of targets) if (!deps.existsAtMain(path) && !newFileDeclared) warnings.push(`${path}: origin/main에 없는 파일 · 신설: 둘째 줄 선언 필요`);
+  }
+  if (!warnings.length) return { targets, warnings, candidates: [] };
+  const sources = [input.title, input.evidence ?? '', ...(input.refs ?? [])].join('\n');
+  const candidates = [...new Set(mentionedPaths(sources).filter(deps.existsAtMain))];
+  for (const match of sources.matchAll(/(?:^|[^\d])#(\d{2,8})\b/g)) {
+    for (const path of deps.mergedPrFiles?.(Number(match[1])) ?? []) {
+      if (deps.existsAtMain(path) && !candidates.includes(path)) candidates.push(path);
+    }
+  }
+  return { targets, warnings, candidates };
+}
+
 /** `--ref` 문서를 찾는 뿌리들 — 이 코드의 트리 ⊕ 지금 작업 디렉토리의 git 뿌리.
  *  ⭐ 설치본(`~/.local/share/elanous/current`)에는 `docs/` 가 없다 — 저장소 안에서 부른 설치본도 저장소 문서를 인용할 수 있게. */
 export function refRoots(cwd = process.cwd()): string[] {
@@ -233,10 +268,11 @@ export function validateCeoLoad(input: { ceoMinutes?: number; ceoDate?: string }
   if (input.ceoDate !== undefined && (!/^\d{4}-\d{2}-\d{2}$/.test(input.ceoDate) || !Number.isFinite(Date.parse(`${input.ceoDate}T00:00:00Z`)) || new Date(`${input.ceoDate}T00:00:00Z`).toISOString().slice(0, 10) !== input.ceoDate)) throw new CliUserError('대표 손 날짜는 YYYY-MM-DD 이어야 한다');
 }
 
-export function addItem(v: string, input: { id: string; title: string; refs?: string[]; owner?: string; kind?: ChecklistKind; priority?: ChecklistItem['priority']; predecessors?: string[]; deadlineVersion?: string; ceoMinutes?: number; ceoDate?: string; accelerator?: boolean }, options: { allowDuplicateId?: boolean } = {}): Checklist {
+export function addItem(v: string, input: { id: string; title: string; refs?: string[]; owner?: string; kind?: ChecklistKind; dispatchKind?: ChecklistDispatchKind; priority?: ChecklistItem['priority']; predecessors?: string[]; deadlineVersion?: string; ceoMinutes?: number; ceoDate?: string; accelerator?: boolean }, options: { allowDuplicateId?: boolean } = {}): Checklist {
   if (!input.id.trim()) throw new CliUserError('칸 id 가 비었다');
   if (!input.title.trim()) throw new CliUserError('칸 제목이 비었다');
   if (input.kind !== undefined && !CHECKLIST_KINDS.includes(input.kind)) throw new CliUserError(`잘못된 종류: ${input.kind}`, 'screen|postpub');
+  if (input.dispatchKind !== undefined && !CHECKLIST_DISPATCH_KINDS.includes(input.dispatchKind)) throw new CliUserError(`잘못된 발사 종류: ${input.dispatchKind}`, 'code|ops|measure|decision|umbrella');
   if (input.owner !== undefined) parseOwner(input.owner);
   if (input.priority !== undefined && !['P0', 'P1', 'P2'].includes(input.priority)) throw new CliUserError(`잘못된 우선순위: ${input.priority}`);
   if (input.predecessors !== undefined && (!Array.isArray(input.predecessors) || input.predecessors.some((p) => typeof p !== 'string' || !p.trim() || p === input.id))) throw new CliUserError('잘못된 선행 칸');
@@ -255,20 +291,21 @@ export function addItem(v: string, input: { id: string; title: string; refs?: st
     assertPredecessorsExist(input.predecessors, data, otherItems);
     const by = process.env.ELANOUS_TRACK || 'cli';
     const at = new Date().toISOString();
-    const item: ChecklistItem = { id: input.id, title: input.title, status: 'yellow', ...(input.owner !== undefined ? { owner: input.owner } : {}), ...(input.kind !== undefined ? { kind: input.kind } : {}), ...(input.priority !== undefined ? { priority: input.priority } : {}), ...(input.predecessors !== undefined ? { predecessors: input.predecessors } : {}), ...(input.deadlineVersion !== undefined ? { deadlineVersion: input.deadlineVersion } : {}), ...(input.ceoMinutes !== undefined ? { ceoMinutes: input.ceoMinutes } : {}), ...(input.ceoDate !== undefined ? { ceoDate: input.ceoDate } : {}), ...(input.accelerator === true ? { accelerator: true as const } : {}), ...(refs ? { refs } : {}), updatedAt: at, updatedBy: by };
+    const item: ChecklistItem = { id: input.id, title: input.title, status: 'yellow', ...(input.owner !== undefined ? { owner: input.owner } : {}), ...(input.kind !== undefined ? { kind: input.kind } : {}), ...(input.dispatchKind !== undefined ? { dispatchKind: input.dispatchKind } : {}), ...(input.priority !== undefined ? { priority: input.priority } : {}), ...(input.predecessors !== undefined ? { predecessors: input.predecessors } : {}), ...(input.deadlineVersion !== undefined ? { deadlineVersion: input.deadlineVersion } : {}), ...(input.ceoMinutes !== undefined ? { ceoMinutes: input.ceoMinutes } : {}), ...(input.ceoDate !== undefined ? { ceoDate: input.ceoDate } : {}), ...(input.accelerator === true ? { accelerator: true as const } : {}), ...(refs ? { refs } : {}), updatedAt: at, updatedBy: by };
     data.items.push(item);
     change(data, item.id, 'add', null, item, by, at);
     return true;
   });
 }
 
-export function setItem(v: string, id: string, patch: { status?: ChecklistStatus; evidence?: string; refs?: string[]; owner?: string; disposition?: ChecklistDisposition; kind?: ChecklistKind; priority?: ChecklistItem['priority']; predecessors?: string[]; deadlineVersion?: string; ceoMinutes?: number; ceoDate?: string; accelerator?: boolean | null }, by: string): Checklist {
+export function setItem(v: string, id: string, patch: { status?: ChecklistStatus; evidence?: string; refs?: string[]; owner?: string; disposition?: ChecklistDisposition; kind?: ChecklistKind; dispatchKind?: ChecklistDispatchKind; priority?: ChecklistItem['priority']; predecessors?: string[]; deadlineVersion?: string; ceoMinutes?: number; ceoDate?: string; accelerator?: boolean | null }, by: string): Checklist {
   return mutate(v, (data, otherItems) => {
     const item = data.items.find((i) => i.id === id);
     if (!item) throw new CliUserError(`없는 칸: ${id}`, 'list 로 칸 목록을 본다');
     if (patch.status !== undefined && !['green', 'yellow', 'red', 'done'].includes(patch.status)) throw new CliUserError(`잘못된 상태: ${patch.status}`);
     if (patch.disposition !== undefined && !['move', 'known-issue', 'block'].includes(patch.disposition)) throw new CliUserError(`잘못된 처분: ${patch.disposition}`);
     if (patch.kind !== undefined && !CHECKLIST_KINDS.includes(patch.kind)) throw new CliUserError(`잘못된 종류: ${patch.kind}`, 'screen|postpub');
+    if (patch.dispatchKind !== undefined && !CHECKLIST_DISPATCH_KINDS.includes(patch.dispatchKind)) throw new CliUserError(`잘못된 발사 종류: ${patch.dispatchKind}`, 'code|ops|measure|decision|umbrella');
     if (patch.priority !== undefined && !['P0', 'P1', 'P2'].includes(patch.priority)) throw new CliUserError(`잘못된 우선순위: ${patch.priority}`);
     if (patch.predecessors !== undefined && (!Array.isArray(patch.predecessors) || patch.predecessors.some((p) => typeof p !== 'string' || !p.trim() || p === id))) throw new CliUserError('잘못된 선행 칸');
     assertPredecessorsExist(patch.predecessors, data, otherItems);
@@ -283,7 +320,7 @@ export function setItem(v: string, id: string, patch: { status?: ChecklistStatus
         throw new CliUserError(`지금 주인: ${item.owner} — --force 로만 바꾼다`, 'release checklist claim <id> --by <자리> --force');
       }
     }
-    const fields = (['evidence', 'owner', 'status', 'disposition', 'kind', 'priority', 'predecessors', 'deadlineVersion', 'ceoMinutes', 'ceoDate', 'accelerator', 'refs'] as const).filter((field) => patch[field] !== undefined && JSON.stringify(patch[field]) !== JSON.stringify(item[field] ?? null));
+    const fields = (['evidence', 'owner', 'status', 'disposition', 'kind', 'dispatchKind', 'priority', 'predecessors', 'deadlineVersion', 'ceoMinutes', 'ceoDate', 'accelerator', 'refs'] as const).filter((field) => patch[field] !== undefined && JSON.stringify(patch[field]) !== JSON.stringify(item[field] ?? null));
     if (fields.length === 0) return false;
     const at = new Date().toISOString();
     for (const field of fields) {