elanous 0.2.28 → 0.2.29

package/src/chat/index.ts

@@ -211,6 +211,8 @@ export interface TextInputHost {
      *  exactly as if the user had typed Enter. Reset to undefined on
      *  textInput return. */
     submit?: (request?: string | TextInputExternalSubmitRequest) => void;
+    /** Live buffer text while textInput is mounted; undefined after it returns. */
+    getBufferText?: () => string;
   };
   onLinesChange?: (visibleLines: number) => void;
   /** Preferred host seam for input-global shortcuts. textInput emits a
@@ -230,6 +232,7 @@ export interface ResolvedTextInputHost {
     repaint: () => void;
     insertAtCursor?: (text: string) => void;
     submit?: (request?: string | TextInputExternalSubmitRequest) => void;
+    getBufferText?: () => string;
   };
   onLinesChange?: (visibleLines: number) => void;
   dispatchGlobalAction?: (action: TextInputGlobalAction) => void | Promise<void>;
@@ -473,7 +476,7 @@ export const SLASH_COMMANDS: SlashCommand[] = [
   { name: 'sync',  aliases: ['s'],         description: 'Enter sync mode' },
   { name: 'plugin', aliases: ['plugins'], description: 'Manage plugins', subcommands: ['list', 'activate', 'deactivate', 'reload'] },
   { name: 'widget', aliases: ['widgets'], description: 'Manage widgets', subcommands: ['list', 'reload', 'instances'] },
-  { name: 'log',   aliases: [],             description: 'Chat Log controls — size / clear / filter / search / freeze / solo / turn / fold / help', subcommands: ['size', 'clear', 'filter', 'search', 'freeze', 'solo', 'turn', 'fold', 'help'] },
+  { name: 'log',   aliases: [],             description: 'Chat Log controls — size / clear / filter / search / freeze / solo / turn / fold / unfold / help', subcommands: ['size', 'clear', 'filter', 'search', 'freeze', 'solo', 'turn', 'fold', 'unfold', 'help'] },
   { name: 'loops', aliases: [], description: '루프와 크론 상태 표 — /loops [owner]' },
   { name: 'board', aliases: [], description: '판 체크리스트 — /board [판]' },
   { name: 'memory', aliases: ['mem'], description: 'Memory ops — list / show / search / add / delete (see `elanous memory --help`)', subcommands: ['list', 'show', 'search', 'add', 'delete', 'index'] },
@@ -496,7 +499,7 @@ export const SLASH_COMMANDS: SlashCommand[] = [
   { name: 'telegram',  aliases: ['tg'],    description: 'Telegram bot — status / pair / send / pause / stop / attach / detach / sessions', subcommands: ['status', 'pair', 'setup', 'send', 'pause', 'stop', 'attach', 'detach', 'sessions'] },
   { name: 'tablet',    aliases: [],        description: 'Tablet mode — collapse layout to log + input', subcommands: ['on', 'off', 'toggle', 'auto', 'status', 'browser-preview', 'bp'] },
   { name: 'surface',   aliases: [], description: 'Surface control — open a pane/catalog launcher (/surface catalog · browser · preview · log · scratch · obsidian · skill) OR set a preferred LLM surface (/surface coding-agent · research-agent · control-agent · ops-agent · … · clear · status)', subcommands: ['catalog', 'browser', 'preview', 'browser-preview', 'log', 'scratch', 'obsidian', 'skill', 'skill-file', 'agents', 'coding-agent', 'coding-chat', 'research-agent', 'research-chat', 'control-agent', 'ops-ui-agent', 'ops-fleet-agent', 'ops-agent', 'clear', 'status'] },
-  { name: 'term',  aliases: ['terminal'], description: 'Interactive terminal modal — spawn / list / attach / detach / switch / kill / snapshot / resume', subcommands: ['spawn', 'list', 'attach', 'detach', 'switch', 'kill', 'snapshot', 'resume'] },
+  { name: 'term',  aliases: ['terminal'], description: 'Interactive terminal modal — new / list / attach / detach / switch / kill / snapshot / resume', subcommands: ['new', 'list', 'attach', 'detach', 'switch', 'kill', 'snapshot', 'resume'] },
   { name: 'claude', aliases: [], description: 'Spawn claude-code CLI in a terminal modal' },
   { name: 'codex',  aliases: [], description: 'Spawn codex CLI in a terminal modal' },
   { name: 'gemini', aliases: [], description: 'Spawn gemini CLI in a terminal modal' },
@@ -693,6 +696,7 @@ export async function textInput(opts: {
   getRow?: () => number;
   col: number;
   width: number;
+  getWidth?: () => number;
   maxLines?: number;
   prompt?: string;
   placeholder?: string;
@@ -893,6 +897,7 @@ export async function textInput(opts: {
   host?: TextInputHost;
 }): Promise<InputResult> {
   const { row: initialRow, col, width, maxLines = 5, prompt = '\u276f ', placeholder = '' } = opts;
+  const getWidth = (): number => opts.getWidth?.() ?? width;
   const getRow = (): number => opts.getRow?.() ?? initialRow;
   const row = getRow();
   // P2.1: report the input's top row so writeTerminal scopes its
@@ -985,7 +990,7 @@ export async function textInput(opts: {
     picker,
     getBufferView: bufView,
     writeTerminal,
-    getBounds: () => ({ row: getRow(), col, width, height: 1 }),
+    getBounds: () => ({ row: getRow(), col, width: getWidth(), height: 1 }),
     getInputZoneHeight: () => Math.min(lines.length, maxLines),
     onDispatchResult: async (dispatched) => processPickerDispatch(dispatched),
   });
@@ -1129,7 +1134,7 @@ export async function textInput(opts: {
     setInputPromptStartRow(row);
     const promptStr = C.accent(prompt);
     const promptW = visibleWidth(prompt);
-    const textW = width - promptW - 1;
+    const textW = Math.max(0, getWidth() - promptW - 1);
     const numLines = lines.length;
     // Visible window: at most `maxLines` rows on screen, but the buffer
     // (`lines`) may exceed that. `firstVisibleIdx` keeps the cursor's
@@ -1194,7 +1199,7 @@ export async function textInput(opts: {
     prevDrawnLines = visibleLines;
 
     if (ctrlCHint) {
-      writeTerminal(ansi.moveTo(row + 2, col) + '\x1b[2K' + C.muted(truncate(ctrlCHint, width)));
+      writeTerminal(ansi.moveTo(row + 2, col) + '\x1b[2K' + C.muted(truncate(ctrlCHint, getWidth())));
       ctrlCHintPainted = true;
     } else if (ctrlCHintPainted) {
       writeTerminal(ansi.moveTo(row + 2, col) + '\x1b[2K');
@@ -1248,7 +1253,7 @@ export async function textInput(opts: {
   };
 
   const pickerModalFamily = pickerModalRuntime.createFamily({
-    bounds: { row: getRow(), col, width, height: 1 },
+    bounds: { row: getRow(), col, width: getWidth(), height: 1 },
     sources: createChatPickerFamilySources({
       // 명시 K — createChatPickerFamilySource<K> 의 K 를 pin. getItems 반환이
       // conditional 타입 ChatPickerItems<K> 라 역추론이 K 를 union(ChatPickerKind)
@@ -1282,7 +1287,7 @@ export async function textInput(opts: {
     pickerModalRuntime.syncFamily({
       activeKind: activePickerKind(),
       clearRows: MAX_PICKER + 3,
-      debugLayout: { row, col, width },
+      debugLayout: { row: getRow(), col, width: getWidth() },
       family: pickerModalFamily,
     });
   };
@@ -1295,7 +1300,7 @@ export async function textInput(opts: {
     const searchRow = row;
     const promptStr = C.accent(prompt);
     const promptW = visibleWidth(prompt);
-    const textW = width - promptW - 1;
+    const textW = Math.max(0, getWidth() - promptW - 1);
     const match = currentReverseSearchResult();
     const status = match ? 'reverse-i-search' : 'failed reverse-i-search';
     const prefixRaw = `(${status})\`${reverseSearch.query}': `;
@@ -1375,6 +1380,8 @@ export async function textInput(opts: {
   const drawAll = renderActions.repaintUserMutation;
   let pendingExternalSubmitSource: InputSourceRef | undefined;
   const finalizeInput = (result: InputResult): InputResult => {
+    // 외부 주입 라우터가 «composer 가 안 떠 있다»를 알 수 있게 내린다.
+    if (hostControl) hostControl.getBufferText = undefined;
     clearPicker();
     writeTerminal(endTextInputCursor(opts.cursorSink));
     return result;
@@ -1420,17 +1427,30 @@ export async function textInput(opts: {
     // Enter into the readKey queue so the main loop returns the
     // submit outcome exactly like a typed Enter. Reset to
     // undefined on textInput return.
+    hostControl.getBufferText = () => lines.join('\n');
     hostControl.submit = (request?: string | TextInputExternalSubmitRequest) => {
       const nextText = typeof request === 'string' ? request : request?.text;
+      // 합성 Enter 가 못 들어가면 버퍼·커서·출처를 «통째로» 되돌린다 — 외부 글이 composer 에 남아
+      // 사용자 입력과 섞이거나 대기열이 다시 보내 중복되지 않게(원자적 제출).
+      const before = { lines: [...lines], lineIdx, colIdx, source: pendingExternalSubmitSource };
       pendingExternalSubmitSource = typeof request === 'string' ? undefined : request?.source;
       if (nextText !== undefined) {
         const next = nextText.split('\n');
         lines = next.length > 0 ? next : [''];
         lineIdx = lines.length - 1;
         colIdx = lines[lineIdx]!.length;
-        drawAll();
       }
-      injectKey({ name: 'enter', ctrl: false, shift: false });
+      // 반환값 = 합성 Enter 가 키 큐에 들어갔나(raw 모드가 아니면 false) — 외부 입력 대기열이 유실을 막는 데 쓴다.
+      const accepted = injectKey({ name: 'enter', ctrl: false, shift: false });
+      if (!accepted) {
+        lines = before.lines; lineIdx = before.lineIdx; colIdx = before.colIdx;
+        pendingExternalSubmitSource = before.source;
+      }
+      // 렌더 실패가 수락 결과를 뒤집으면 이미 큐에 든 Enter 와 대기열이 같은 글을 두 번 보낸다 — 삼킨다.
+      if (nextText !== undefined) {
+        try { drawAll(); } catch (error) { debug.log('chat.input', 'external-submit-draw-failed', { accepted, error: String(error) }); }
+      }
+      return accepted;
     };
   }
 
@@ -1650,6 +1670,7 @@ export async function textInput(opts: {
         // Host owns the focus swap; we return gotoPane:true so the
         // input loop exits cleanly and the dashboard's pane dispatcher
         // picks up the keys.
+        if (hostControl) hostControl.getBufferText = undefined;
         return { text: '', submitted: false, gotoPane: true };
       }
       drawAll();

package/src/chat/pickers/modal-runtime.ts

@@ -145,6 +145,7 @@ export function createChatPickerModalRuntime(deps: ChatPickerModalRuntimeDeps):
     maxVisible: spec.maxVisible,
     getInputZoneHeight: deps.getInputZoneHeight,
     width: deps.getBounds().width,
+    getWidth: () => deps.getBounds().width,
     onKey: makePickerOnKey(kind),
     onRowClick: makePickerOnRowClick(kind),
   });

package/src/chat/pickers/modals.ts

@@ -107,6 +107,7 @@ export interface ChatPickerModalBindings {
   maxVisible: number;
   getInputZoneHeight: () => number;
   width: number;
+  getWidth?: () => number;
   onKey?: PickerOnKey;
   onRowClick?: PickerOnRowClick;
 }
@@ -122,6 +123,7 @@ type FramedPickerSpec<T> = {
   maxVisible: number;
   getInputZoneHeight: () => number;
   width: number;
+  getWidth?: () => number;
   onKey?: PickerOnKey;
   onRowClick?: PickerOnRowClick;
 };
@@ -140,7 +142,7 @@ function createFramedPickerModal<T>(spec: FramedPickerSpec<T>): ModalSurface {
     if (visibleCount <= 0) return null;
     const height = visibleCount + 3;
     const row = bottomRow - height + 1;
-    return { row, col: spec.bounds.col, width: spec.width, height, startIdx, visibleCount };
+    return { row, col: spec.bounds.col, width: spec.getWidth?.() ?? spec.width, height, startIdx, visibleCount };
   };
 
   /** Phase 4.5a (substrate Occam · §4-pre.7 · 2026-05-03) — update

package/src/chat/turn-typeahead.ts

@@ -13,6 +13,55 @@ export interface TurnTypeaheadState {
   buffer: string;
   /** Enter 한 입력들. 턴 종료 뒤 입력 순서대로 자동 제출한다. */
   queuedSubmissions: string[];
+  /**
+   * `queuedSubmissions` 와 같은 순서의 짝 — 턴 «안» 주입 레지스트리(`session/pending-input`) 항목 id.
+   * `null`(또는 칸이 모자람) = 레지스트리에 안 넣은 항목. ⭐ 이 id 로 배수·되꺼내기·턴 종료 승격을
+   * «짝지어» 떨어낸다 — 위치·문자열로 짝지으면 같은 발화가 두 번 들어간다(10-14 중복 수리).
+   */
+  queuedPendingIds?: (string | null)[];
+}
+
+/** 큐 길이에 맞춘 id 짝(모자라면 null 로 채운다). 순수. */
+export function turnTypeaheadPendingIds(state: TurnTypeaheadState): (string | null)[] {
+  const ids = state.queuedPendingIds ?? [];
+  return state.queuedSubmissions.map((_, i) => ids[i] ?? null);
+}
+
+function presentIds(ids: readonly (string | null)[]): string[] {
+  return ids.filter((id): id is string => typeof id === 'string');
+}
+
+/** 짝이 하나도 없으면 칸을 아예 안 둔다(`undefined` 키도 없이) — 레지스트리를 안 쓰는 경로의 상태 모양을 옛 그대로 둔다. */
+function idsField(ids: readonly (string | null)[]): { queuedPendingIds?: (string | null)[] } {
+  return ids.some(id => id !== null) ? { queuedPendingIds: [...ids] } : {};
+}
+
+/** 상태에서 id 짝 칸을 뗀다 — `idsField` 와 함께 써서 옛 짝이 스프레드로 살아남지 않게 한다. */
+function withoutIds(state: TurnTypeaheadState): TurnTypeaheadState {
+  if (!('queuedPendingIds' in state)) return state;
+  const { queuedPendingIds: _ids, ...rest } = state;
+  return rest;
+}
+
+/** 큐 index 번째 항목에 레지스트리 id 를 단다. 순수. 범위 밖이면 그대로. */
+export function attachTurnTypeaheadPendingId(
+  state: TurnTypeaheadState,
+  index: number,
+  id: string,
+): TurnTypeaheadState {
+  if (index < 0 || index >= state.queuedSubmissions.length) return state;
+  const ids = turnTypeaheadPendingIds(state);
+  ids[index] = id;
+  return { ...withoutIds(state), ...idsField(ids) };
+}
+
+/**
+ * 턴 «안» 주입(steer) 대상인가. ⛔ 슬래시는 뺀다 — 명령은 턴이 끝난 뒤 FIFO 로만 실행한다
+ * (모델에 `/…` 문면이 발화로 들어가면 명령이 아니라 잡음이다 · Claude Code 도 같은 경계에서 뺀다).
+ */
+export function isTurnTypeaheadSteerable(text: string): boolean {
+  const trimmed = text.trim();
+  return trimmed.length > 0 && !trimmed.startsWith('/');
 }
 
 export function createTurnTypeaheadState(): TurnTypeaheadState {
@@ -38,6 +87,8 @@ export type TurnTypeaheadKeyResult = {
   immediateSubmission?: string;
   /** 비어 있지 않은 Enter 입력의 제출 경로 분류. */
   submissionDisposition?: 'immediate' | 'fifo';
+  /** 큐에서 «다른 길»로 빠진 항목의 레지스트리 id — 호출측이 레지스트리에서도 떨어낸다(되꺼내기). */
+  releasedPendingIds?: string[];
 };
 
 /** 등록소 소유의 관측용 표시 조회. 이름·문법·실행 정책은 이 순수 판정기에 두지 않는다. */
@@ -82,7 +133,11 @@ export function applyTurnTypeaheadKey(
       // A registry lookup failure must preserve the typed input on the existing FIFO path.
     }
     return {
-      state: { buffer: '', queuedSubmissions: [...state.queuedSubmissions, state.buffer] },
+      state: {
+        buffer: '',
+        queuedSubmissions: [...state.queuedSubmissions, state.buffer],
+        ...idsField([...turnTypeaheadPendingIds(state), null]),
+      },
       consumed: true,
       changed: true,
       submissionDisposition: 'fifo',
@@ -94,10 +149,16 @@ export function applyTurnTypeaheadKey(
   if (key.name === 'up' && key.ctrl && !key.alt && !key.shift && !key.meta) {
     const recalled = state.queuedSubmissions.at(-1);
     if (recalled === undefined) return { state, consumed: false, changed: false };
+    const ids = turnTypeaheadPendingIds(state);
     return {
-      state: { buffer: state.buffer + recalled, queuedSubmissions: state.queuedSubmissions.slice(0, -1) },
+      state: {
+        buffer: state.buffer + recalled,
+        queuedSubmissions: state.queuedSubmissions.slice(0, -1),
+        ...idsField(ids.slice(0, -1)),
+      },
       consumed: true,
       changed: true,
+      ...(ids.at(-1) ? { releasedPendingIds: presentIds(ids.slice(-1)) } : {}),
     };
   }
 
@@ -114,13 +175,17 @@ export function restoreTurnTypeaheadSubmission(
   state: TurnTypeaheadState,
   text: string,
 ): TurnTypeaheadState {
-  return { ...state, queuedSubmissions: [...state.queuedSubmissions, text] };
+  return {
+    ...withoutIds(state),
+    queuedSubmissions: [...state.queuedSubmissions, text],
+    ...idsField([...turnTypeaheadPendingIds(state), null]),
+  };
 }
 
 export type TurnTypeaheadHandoff =
   | { kind: 'none' }
   | { kind: 'prefill'; text: string }
-  | { kind: 'submit'; text: string };
+  | { kind: 'submit'; text: string; pendingId?: string };
 
 /** 턴 종료 때 FIFO의 다음 항목 하나를 꺼낸다. 큐가 비면 미제출 buffer는 prefill한다. */
 export function dequeueTurnTypeaheadHandoff(
@@ -128,7 +193,11 @@ export function dequeueTurnTypeaheadHandoff(
 ): { handoff: TurnTypeaheadHandoff; state: TurnTypeaheadState } {
   const [next, ...queuedSubmissions] = state.queuedSubmissions;
   if (next !== undefined) {
-    return { handoff: { kind: 'submit', text: next }, state: { ...state, queuedSubmissions } };
+    const [pendingId, ...queuedPendingIds] = turnTypeaheadPendingIds(state);
+    return {
+      handoff: pendingId ? { kind: 'submit', text: next, pendingId } : { kind: 'submit', text: next },
+      state: { ...withoutIds(state), queuedSubmissions, ...idsField(queuedPendingIds) },
+    };
   }
   if (!state.buffer) return { handoff: { kind: 'none' }, state };
   return { handoff: { kind: 'prefill', text: state.buffer }, state: createTurnTypeaheadState() };
@@ -143,21 +212,35 @@ export function drainTurnTypeaheadOnce(
   state: TurnTypeaheadState,
   carriedInitial: string | null | undefined,
   opts?: { interrupted?: boolean },
-): { state: TurnTypeaheadState; nextInitial: string | undefined; injectEnter: boolean } {
+): {
+  state: TurnTypeaheadState;
+  nextInitial: string | undefined;
+  injectEnter: boolean;
+  /**
+   * ⭐ 이번 걸음에 큐를 «떠난» 항목의 레지스트리 id — 호출측이 레지스트리에서도 떨어낸다.
+   *   안 떨어내면 승격된 발화(새 프롬프트)가 다음 턴 둘째 바퀴에 «또» 들어가고(턴 종료),
+   *   composer 로 돌아간 글이 고치기 전 문면으로 모델에 들어간다(중단 복원).
+   */
+  releasedPendingIds: string[];
+} {
   if (opts?.interrupted && state.queuedSubmissions.length > 0) {
     const restored = [...state.queuedSubmissions, ...(state.buffer ? [state.buffer] : [])].join('\n');
     return {
       state: createTurnTypeaheadState(),
       nextInitial: carriedInitial ? `${carriedInitial}\n${restored}` : restored,
       injectEnter: false,
+      releasedPendingIds: presentIds(turnTypeaheadPendingIds(state)),
     };
   }
   const { handoff, state: remaining } = dequeueTurnTypeaheadHandoff(state);
-  if (handoff.kind === 'none') return { state: remaining, nextInitial: carriedInitial ?? undefined, injectEnter: false };
+  if (handoff.kind === 'none') {
+    return { state: remaining, nextInitial: carriedInitial ?? undefined, injectEnter: false, releasedPendingIds: [] };
+  }
   return {
     state: remaining,
     nextInitial: carriedInitial ? `${carriedInitial}${handoff.text}` : handoff.text,
     injectEnter: handoff.kind === 'submit',
+    releasedPendingIds: handoff.kind === 'submit' && handoff.pendingId ? [handoff.pendingId] : [],
   };
 }
 
@@ -177,7 +260,7 @@ export function drainTurnTypeaheadQueue(
 ): { state: TurnTypeaheadState; drained: string[] } {
   if (state.queuedSubmissions.length === 0) return { state, drained: [] };
   return {
-    state: { ...state, queuedSubmissions: [] },
+    state: { ...withoutIds(state), queuedSubmissions: [] },
     drained: [...state.queuedSubmissions],
   };
 }
@@ -185,8 +268,10 @@ export function drainTurnTypeaheadQueue(
 /**
  * ★ 라이브 턴 안으로 배수된 발화의 상태 전이 + 챗로그 문장. 순수.
  *
- * 대시보드 `enqueuePendingUserInput` onDrained 가 앞에서부터
- * `slice(drained.length)` 로 떨어내는 FIFO 와 같다.
+ * `items`(레지스트리 항목 · id 포함)를 주면 ***id 가 짝지어지는 항목만*** 떨어내고 문장도 그것만 적는다.
+ *   ⛔ 앞에서부터 `slice(drained.length)` 하면 같은 버킷의 남의 항목(goal-loop 제어 메모)이나
+ *   이미 되꺼낸 항목 때문에 엉뚱한 대기 발화가 떨어진다(10-14 중복 수리).
+ * `items` 가 없으면 옛 계약(앞에서부터 떨어내기)을 지킨다.
  * 버퍼는 건드리지 않는다. 배수된 것이 없으면 문장도 없다.
  *
  * 문면은 `renderTurnTypeaheadQueueRow` 와 나란히 읽힌다:
@@ -199,15 +284,37 @@ export function drainTurnTypeaheadQueue(
 export function drainedIntoTurn(
   state: TurnTypeaheadState,
   drained: readonly string[],
-): { state: TurnTypeaheadState; sentence: string | null } {
-  if (drained.length === 0) return { state, sentence: null };
-  const remaining = state.queuedSubmissions.slice(drained.length);
-  const count = drained.length;
+  items?: readonly { id: string; text: string }[],
+): { state: TurnTypeaheadState; sentence: string | null; matched: string[] } {
+  if (drained.length === 0) return { state, sentence: null, matched: [] };
+  let next: TurnTypeaheadState;
+  let matched: string[];
+  if (items) {
+    const drainedIds = new Set(items.map(item => item.id));
+    const ids = turnTypeaheadPendingIds(state);
+    const keep = ids.map(id => id === null || !drainedIds.has(id));
+    matched = state.queuedSubmissions.filter((_, i) => !keep[i]);
+    next = {
+      ...withoutIds(state),
+      queuedSubmissions: state.queuedSubmissions.filter((_, i) => keep[i]),
+      ...idsField(ids.filter((_, i) => keep[i])),
+    };
+  } else {
+    matched = [...drained];
+    next = {
+      ...withoutIds(state),
+      queuedSubmissions: state.queuedSubmissions.slice(drained.length),
+      ...idsField(turnTypeaheadPendingIds(state).slice(drained.length)),
+    };
+  }
+  if (matched.length === 0) return { state: next, sentence: null, matched };
+  const count = matched.length;
   const label = count === 1 ? '⏳ 턴 안 1건' : `⏳ 턴 안 ${count}건`;
-  const quoted = drained.map(text => `"${text}"`).join(' · ');
+  const quoted = matched.map(text => `"${text}"`).join(' · ');
   return {
-    state: { ...state, queuedSubmissions: remaining },
+    state: next,
     sentence: `${label} · ${quoted} · 라이브 턴으로 전송`,
+    matched,
   };
 }
 

package/src/cli/dashboard-name-flag.ts

@@ -0,0 +1,48 @@
+// `elanous --name <name>` — 맨 `elanous`(대시보드 TUI)가 자기 PTY manifest 행(`tui:<pid>`)에
+// 별명을 달고 뜬다. 그러면 `elanous pty list` 에 그 이름이 보이고 `pty snapshot <name>` ·
+// `pty text <name> …` 가 별명으로 해석된다(ref 해석은 이미 nickname 을 받는다).
+//
+// ⭐ 루트 «실행» 플래그다 — `--resume`·`--debug` 와 같은 규칙으로 Commander «전»에 걷어낸다.
+// ⛔ 하위 명령 «뒤»의 `--name`(`elanous pty list --name x` · `elanous --debug session new --name x`)은 건드리지 않는다 — 그 명령이 `--name` 을
+//    자기 옵션으로 가질 수 있다(가로채면 조용히 그 옵션을 먹는다).
+
+import { ROOT_FLAGS_TAKING_VALUE } from './remote-resolve.js';
+
+export interface DashboardNameFlag {
+  /** 걷어낸 뒤의 인자 — Commander·대시보드 필터로 넘긴다. */
+  readonly args: string[];
+  /** 준 이름(앞뒤 공백 제거). 플래그가 없으면 undefined. */
+  readonly name?: string;
+  /** 값이 없거나 빈 이름이면 사람에게 낼 오류 문면. */
+  readonly error?: string;
+}
+
+/** 루트 «선행 플래그 구간»에서 값을 받는 플래그 — 그 값 토큰은 하위 명령이 아니다. */
+const LEADING_VALUE_FLAGS = new Set([...ROOT_FLAGS_TAKING_VALUE, '--resume']);
+
+/** 루트 선행 플래그 구간 안의 `--name` 위치. 하위 명령(맨 위치 인자)이나 `--` 를 만나면 멈춘다 —
+ *  `elanous --debug session new --name x` 의 `--name` 은 그 하위 명령의 것이다(리뷰 must-fix). */
+function leadingNameIndex(rawArgs: readonly string[]): number {
+  for (let i = 0; i < rawArgs.length; i += 1) {
+    const arg = rawArgs[i]!;
+    if (arg === '--' || !arg.startsWith('-')) return -1;
+    if (arg === '--name' || arg.startsWith('--name=')) return i;
+    if (LEADING_VALUE_FLAGS.has(arg)) i += 1;
+  }
+  return -1;
+}
+
+export function readDashboardNameFlag(rawArgs: readonly string[]): DashboardNameFlag {
+  const idx = leadingNameIndex(rawArgs);
+  if (idx < 0) return { args: [...rawArgs] };
+  const flag = rawArgs[idx]!;
+  const inline = flag.startsWith('--name=');
+  const value = inline ? flag.slice('--name='.length) : rawArgs[idx + 1];
+  const args = rawArgs.filter((_, i) => i !== idx && (inline || i !== idx + 1));
+  if (value === undefined || (!inline && value.startsWith('-'))) {
+    return { args: rawArgs.filter((_, i) => i !== idx), error: 'elanous: --name needs a value (e.g. elanous --name op)' };
+  }
+  const name = value.trim();
+  if (!name) return { args, error: 'elanous: --name must not be empty' };
+  return { args, name };
+}

package/src/cli/doctor-cli.ts

@@ -40,6 +40,16 @@ import type { LlmInventory } from '../llm/local-manager/types.js';
 import { buildDoctorBundle } from './doctor-bundle.js';
 import { uploadDoctorBundle } from './doctor-bundle-upload.js';
 import { checkNodeModules, formatNodeModulesCheck, nodeModulesTrees } from './doctor-node-modules.js';
+import {
+  DOCTOR_SYMPTOMS,
+  DOCTOR_VISIT_SOURCES,
+  doctorVisitRunExists,
+  isDoctorSymptom,
+  isDoctorVisitSource,
+  readDoctorVisits,
+  recordDoctorVisit,
+  type DoctorSymptom,
+} from '../self-implement/doctor-visit.js';
 import { formatHostDoctorLines, runHostDoctor, type HostDoctorExpected, type HostDoctorOptions, type HostDoctorRemote } from '../fleet/host-doctor.js';
 import { listMachineResources } from './control-cli.js';
 import type { ResourceView } from '../control-plane/ledger.js';
@@ -210,6 +220,8 @@ export interface DoctorCliDeps extends DoctorOptions, Pick<DoctorFixDeps, 'home'
   hostDoctorMembership?: () => Promise<NonNullable<HostDoctorOptions['membership']>>;
   /** Nexus machine query seam; tests can exercise the default assembly without contacting a live service. */
   hostDoctorMachineResources?: () => Promise<ResourceView[]>;
+  /** `doctor visit`/`doctor status` 원장 디렉터리(시험 seam) — 기본 = `runLedgerDir()`. */
+  doctorVisitLedgerDir?: string;
 }
 
 const repositoryRoot = resolve(dirname(fileURLToPath(import.meta.url)), '../..');
@@ -1336,6 +1348,74 @@ export function registerDoctorCommand(program: Command, deps: DoctorCliDeps = {}
       out.log(json ? JSON.stringify(report, null, 2) : formatHostDoctorLines(report).join('\n'));
       if (!report.ok) setExitCode(1);
     });
+  doctor.command('visit')
+    .description('Record a doctor visit (triage symptom) in the run ledger of that run')
+    .argument('<runId>', 'run id whose ledger receives the visit')
+    .requiredOption('--symptom <symptom>', `closed symptom list: ${DOCTOR_SYMPTOMS.join(', ')}`)
+    .requiredOption('--from <who>', `closed sender list: ${DOCTOR_VISIT_SOURCES.join(', ')}`)
+    .option('--evidence <text>', 'free-text evidence recorded with the visit')
+    .option('--json', 'structured output')
+    .action((runId: string, opts: { symptom: string; from: string; evidence?: string; json?: boolean }, command: Command) => {
+      const json = opts.json === true || command.parent?.opts().json === true;
+      if (!isDoctorSymptom(opts.symptom)) {
+        const reason = `unknown symptom: ${opts.symptom} — closed list: ${DOCTOR_SYMPTOMS.join(', ')}`;
+        if (json) out.log(JSON.stringify({ status: 'rejected', reason }));
+        else err.error(reason);
+        setExitCode(1);
+        return;
+      }
+      if (!isDoctorVisitSource(opts.from)) {
+        const reason = `unknown from: ${opts.from} — closed list: ${DOCTOR_VISIT_SOURCES.join(', ')}`;
+        if (json) out.log(JSON.stringify({ status: 'rejected', reason }));
+        else err.error(reason);
+        setExitCode(1);
+        return;
+      }
+      try {
+        const visit = recordDoctorVisit({
+          runId,
+          from: opts.from,
+          symptom: opts.symptom,
+          ...(opts.evidence !== undefined ? { evidence: opts.evidence } : {}),
+          ...(deps.doctorVisitLedgerDir !== undefined ? { dir: deps.doctorVisitLedgerDir } : {}),
+        });
+        out.log(json ? JSON.stringify(visit) : `doctor visit recorded: runId=${runId} from=${opts.from} symptom=${opts.symptom}${visit.evidence !== undefined ? ` evidence=${visit.evidence}` : ''}`);
+      } catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        if (json) out.log(JSON.stringify({ status: 'rejected', reason }));
+        else err.error(reason);
+        setExitCode(1);
+      }
+    });
+  doctor.command('status')
+    .description('Summarize recorded doctor visits by symptom with recent visit lines')
+    .option('--run <runId>', 'limit the summary to one run ledger')
+    .option('--json', 'structured output')
+    .action((opts: { run?: string; json?: boolean }, command: Command) => {
+      const json = opts.json === true || command.parent?.opts().json === true;
+      const ledgerScope = deps.doctorVisitLedgerDir !== undefined ? { dir: deps.doctorVisitLedgerDir } : {};
+      if (opts.run !== undefined && !doctorVisitRunExists(opts.run, ledgerScope)) {
+        const reason = `없음: 런 원장이 없습니다 (runId=${opts.run})`;
+        if (json) out.log(JSON.stringify({ status: 'rejected', reason }));
+        else err.error(reason);
+        setExitCode(1);
+        return;
+      }
+      const visits = readDoctorVisits(opts.run, ledgerScope);
+      const counts = Object.fromEntries(DOCTOR_SYMPTOMS.map((symptom: DoctorSymptom) => [symptom, 0])) as Record<DoctorSymptom, number>;
+      for (const visit of visits) counts[visit.symptom] += 1;
+      if (json) {
+        out.log(JSON.stringify({ total: visits.length, counts, visits }, null, 2));
+        return;
+      }
+      out.log([
+        `Doctor visits: ${visits.length}`,
+        ...DOCTOR_SYMPTOMS.map((symptom: DoctorSymptom) => `  ${symptom}: ${counts[symptom]}`),
+        'Recent visits:',
+        ...visits.map((visit) => `  ${visit.timestamp ?? 'unknown-time'} runId=${visit.runId} from=${visit.from} symptom=${visit.symptom}${visit.evidence !== undefined ? ` evidence=${visit.evidence}` : ''}`),
+        ...(visits.length === 0 ? ['  none'] : []),
+      ].join('\n'));
+    });
   doctor
     .option('--credentials', 'show per-credential details in human-readable output')
     .option('--bundle', 'write a redacted diagnostics archive for support')

package/src/cli/log-event-names.ts

@@ -189,6 +189,8 @@ export const KNOWN_LOG_EVENT_NAMES: ReadonlySet<string> = new Set([
   "capture.push.skip",
   "capture.start.begin",
   "capture.start.return",
+  "card-injected",
+  "card-skipped",
   "carry",
   "cascade-threshold",
   "catalog-envkey-conflict",
@@ -283,6 +285,7 @@ export const KNOWN_LOG_EVENT_NAMES: ReadonlySet<string> = new Set([
   "control-processing-error",
   "control-result",
   "control-settled",
+  "conversation-start",
   "core-turn",
   "corpus",
   "cost.error",
@@ -290,6 +293,7 @@ export const KNOWN_LOG_EVENT_NAMES: ReadonlySet<string> = new Set([
   "cost.skip-unregistered",
   "coverage",
   "coverage-exhausted",
+  "create-skipped",
   "create.labels-omitted",
   "created",
   "credential",
@@ -444,6 +448,7 @@ export const KNOWN_LOG_EVENT_NAMES: ReadonlySet<string> = new Set([
   "edit.autorecovered",
   "edit.failed",
   "edit.path-resolved",
+  "edited",
   "effort-resolved",
   "emit",
   "emit-fail",
@@ -523,6 +528,7 @@ export const KNOWN_LOG_EVENT_NAMES: ReadonlySet<string> = new Set([
   "fanout.out",
   "feedback",
   "final",
+  "final-supplement-withheld",
   "final.received",
   "finalize",
   "finalize.error",
@@ -663,6 +669,7 @@ export const KNOWN_LOG_EVENT_NAMES: ReadonlySet<string> = new Set([
   "hold-wait-start",
   "hold-wait-timeout",
   "host-owned-passthrough",
+  "human-word-needs-provider",
   "idempotent",
   "identical-success-detected",
   "idle-pane-dispatch-consumed",
@@ -734,6 +741,8 @@ export const KNOWN_LOG_EVENT_NAMES: ReadonlySet<string> = new Set([
   "keyframe-fail",
   "kill.error",
   "kitty.write",
+  "last-session-skipped",
+  "last-session-written",
   "launch",
   "launch-overrides",
   "layered-load",
@@ -760,6 +769,7 @@ export const KNOWN_LOG_EVENT_NAMES: ReadonlySet<string> = new Set([
   "llm.error",
   "llm.input",
   "loaded",
+  "local-over-cap",
   "log-sink-failed",
   "log-zone-click",
   "long-lived-live",
@@ -1239,6 +1249,7 @@ export const KNOWN_LOG_EVENT_NAMES: ReadonlySet<string> = new Set([
   "session-list",
   "session-loaded",
   "session-new",
+  "session-pin-cleared",
   "session-resume",
   "session-runtime-tool-specs.return",
   "session-update.error",
@@ -1395,6 +1406,7 @@ export const KNOWN_LOG_EVENT_NAMES: ReadonlySet<string> = new Set([
   "surface.resolve",
   "sweep",
   "swept",
+  "switch",
   "switch-off",
   "sync",
   "syncLogWidgetState",