elanous 0.2.0 → 0.2.4

package/src/surface/adapters/window-surface-adapter.ts

@@ -1,141 +0,0 @@
-// ── IUL Phase S·a · B-13-α — WindowRegistry ↔ SurfaceRegistry wiring ──
-//
-// Bridges Virtual Window lifecycle (`window:create` / `window:close` /
-// `window:rename` events emitted by `WindowRegistry.subscribe`) into
-// `SurfaceRegistry` as `kind:'window'` surfaces. This closes the Phase
-// P7-B gap where `SaveLayout` / `LoadLayout` / `ApplyLayoutPreset` and
-// `GetUIState({kind:'window'})` / `ObserveSurface({kind:'window'})` all
-// need a first-class address for a VW as a whole (separate from any
-// individual pane it contains).
-//
-// Default visible=true · tier='window' string fallback (Phase Z doesn't
-// yet model a window band; 'window' sorts after 'pane' and before
-// 'modal' in practice because SurfaceRegistry's coerceZTier handles
-// unknowns as 'modal' — acceptable default for now).
-//
-// Ownership: terminal-team turf. Widget-team SYNC #245 confirmed no
-// consumer in widget-team code (`grep switch(addr.kind)` → 0 sites in
-// widget-team tree), so this adapter is additive + safe.
-
-import { debug } from '../../debug/log.js';
-import type { RegistryEvent, WindowRegistry } from '../../virtual-windows/window-registry.js';
-import type { VirtualWindow } from '../../virtual-windows/virtual-window.js';
-import type { SurfaceRegistry } from '../registry.js';
-import { getSurfaceRegistry } from '../registry.js';
-
-export interface WireWindowSurfacesOpts {
-  readonly windowRegistry: WindowRegistry;
-  /** Default `getSurfaceRegistry()` singleton. */
-  readonly surfaceRegistry?: SurfaceRegistry;
-  /** Title formatter. Default `win:<id>` fallback. */
-  readonly titleOf?: (win: VirtualWindow) => string;
-  /** kindTag for the SurfaceRegistry entry. Default `window`. */
-  readonly kindTag?: string;
-}
-
-export interface WireWindowSurfacesHandle {
-  /** Count of currently mirrored windows (tests + diagnostics). */
-  size(): number;
-  /** Unsubscribe + unregister every mirrored entry. Idempotent. */
-  dispose(): void;
-}
-
-/** Subscribe to WindowRegistry lifecycle events and mirror each live
- *  VW into SurfaceRegistry as `{kind:'window', windowId}`. `window:rename`
- *  events update the title in place. `window:close` unregisters. */
-export function wireWindowSurfaces(
-  opts: WireWindowSurfacesOpts,
-): WireWindowSurfacesHandle {
-  const surfReg = opts.surfaceRegistry ?? getSurfaceRegistry();
-  const kindTag = opts.kindTag ?? 'window';
-  const titleOf = opts.titleOf ?? defaultTitleOf;
-  const owned = new Set<number>();
-
-  const register = (windowId: number, title?: string): void => {
-    if (owned.has(windowId)) return;
-    surfReg.register({
-      addr: { kind: 'window', windowId },
-      kindTag,
-      surfaceId: `win:${windowId}`,
-      tier: 'window',
-      visible: true,
-      ...(title !== undefined ? { title } : {}),
-    });
-    owned.add(windowId);
-    if (debug.enabled) {
-      debug.log('window.surface.register', String(windowId), { title, owned: owned.size });
-    }
-  };
-
-  const unregister = (windowId: number): void => {
-    if (!owned.has(windowId)) return;
-    surfReg.unregister({ kind: 'window', windowId });
-    owned.delete(windowId);
-    if (debug.enabled) {
-      debug.log('window.surface.unregister', String(windowId), { owned: owned.size });
-    }
-  };
-
-  // Prime with any windows already in the registry when we wire up
-  // (dashboard boot order: WindowRegistry may spawn one VW before the
-  // surface-wiring block runs, per dashboard.ts ordering).
-  for (const win of opts.windowRegistry.list()) {
-    register(win.id, titleOf(win));
-  }
-
-  const unsub = opts.windowRegistry.subscribe((ev: RegistryEvent) => {
-    switch (ev.type) {
-      case 'window:create': {
-        register(ev.windowId, ev.title);
-        break;
-      }
-      case 'window:close': {
-        unregister(ev.windowId);
-        break;
-      }
-      case 'window:rename': {
-        // Update title in place — register is idempotent by id, so
-        // we re-register after unregistering to refresh the stored
-        // descriptor. Cheaper alternatives (surface registry has an
-        // `update` method) are preferable when available.
-        if (owned.has(ev.windowId)) {
-          try {
-            surfReg.update({ addr: { kind: 'window', windowId: ev.windowId }, title: ev.title });
-          } catch {
-            // Fallback: churn register entry.
-            surfReg.unregister({ kind: 'window', windowId: ev.windowId });
-            surfReg.register({
-              addr: { kind: 'window', windowId: ev.windowId },
-              kindTag,
-              surfaceId: `win:${ev.windowId}`,
-              tier: 'window',
-              visible: true,
-              title: ev.title,
-            });
-          }
-          if (debug.enabled) {
-            debug.log('window.surface.rename', String(ev.windowId), { title: ev.title });
-          }
-        }
-        break;
-      }
-      default:
-        // window:switch / pane:* events don't affect window surface
-        // lifecycle — leave them to other adapters.
-        break;
-    }
-  });
-
-  return {
-    size: () => owned.size,
-    dispose() {
-      unsub();
-      for (const id of owned) surfReg.unregister({ kind: 'window', windowId: id });
-      owned.clear();
-    },
-  };
-}
-
-function defaultTitleOf(win: VirtualWindow): string {
-  return win.title ?? `win:${win.id}`;
-}

package/src/tool-runtime/layout-runtimes.ts

@@ -1,81 +0,0 @@
-// ── Layout* runtimes — VW save/load/preset bridge ──
-//
-// Wraps dispatchSaveLayout / dispatchLoadLayout / dispatchApplyLayoutPreset
-// in the ToolRuntime shape. Registration requires a WindowRegistry
-// (captured at first init), so this module exports a factory
-// registerLayoutRuntimes(registry) instead of a bare side-effectful
-// register() — dashboard boot calls it after the registry is built.
-
-import {
-  buildApplyLayoutPresetTool,
-  buildLoadLayoutTool,
-  buildSaveLayoutTool,
-  dispatchApplyLayoutPreset,
-  dispatchLoadLayout,
-  dispatchSaveLayout,
-} from '../virtual-windows/layout/layout-tools.js';
-import type { WindowRegistry } from '../virtual-windows/window-registry.js';
-import type { ArtifactStore } from '../artifact/index.js';
-import { registerToolRuntime } from './registry.js';
-import type { ToolRuntime } from './types.js';
-
-type Args = Record<string, unknown>;
-type Out = { output: string };
-
-function stringifyOutput(obj: unknown): Out {
-  return { output: JSON.stringify(obj) };
-}
-
-let registered = false;
-
-export interface RegisterLayoutRuntimesOpts {
-  /** Bundle B-5 (P6-4) — when provided, SaveLayout output goes
-   *  through unified `ArtifactStore.put('layout', ...)` under
-   *  `~/.elanous/artifacts/layout/`. Legacy `~/.elanous/layouts/` path is
-   *  the fallback for callers without store DI. */
-  readonly artifactStore?: ArtifactStore;
-}
-
-export function registerLayoutRuntimes(
-  registry: WindowRegistry,
-  opts: RegisterLayoutRuntimesOpts = {},
-): void {
-  if (registered) return;
-  const deps = {
-    registry,
-    ...(opts.artifactStore !== undefined ? { artifactStore: opts.artifactStore } : {}),
-  };
-
-  const saveRuntime: ToolRuntime<Args, Out> = {
-    id: 'layout_save',
-    spec: buildSaveLayoutTool(),
-    async run(req) {
-      return stringifyOutput(await dispatchSaveLayout(deps, req));
-    },
-  };
-
-  const loadRuntime: ToolRuntime<Args, Out> = {
-    id: 'layout_load',
-    spec: buildLoadLayoutTool(),
-    async run(req) {
-      return stringifyOutput(await dispatchLoadLayout(deps, req));
-    },
-  };
-
-  const applyRuntime: ToolRuntime<Args, Out> = {
-    id: 'layout_apply_preset',
-    spec: buildApplyLayoutPresetTool(),
-    async run(req) {
-      return stringifyOutput(dispatchApplyLayoutPreset(deps, req));
-    },
-  };
-
-  registerToolRuntime(saveRuntime);
-  registerToolRuntime(loadRuntime);
-  registerToolRuntime(applyRuntime);
-  registered = true;
-}
-
-export function __resetLayoutRuntimesForTest(): void {
-  registered = false;
-}

package/src/tool-runtime/scenario-window-mount.ts

@@ -1,207 +0,0 @@
-import type { DeclarativeWidgetNode, WidgetSpec } from '../ui/declarative/index.js';
-import type { Axis } from '../virtual-windows/layout-tree.js';
-import type { PaneContent, PaneContentSpec } from '../virtual-windows/pane-content.js';
-import type { WindowRegistry } from '../virtual-windows/window-registry.js';
-import { buildScenarioWidgetSpecs } from './scenario-mount-node.js';
-
-export interface ScenarioWindowMountDeps {
-  readonly registry: WindowRegistry;
-  readonly createPaneContent: (spec: PaneContentSpec) => PaneContent;
-}
-
-export interface ScenarioPaneTarget {
-  readonly windowId: number;
-  readonly paneId: string;
-}
-
-interface PaneConversion {
-  readonly panes: readonly PaneContentSpec[];
-  readonly unsupported: readonly string[];
-}
-
-function titleForWidget(widget: WidgetSpec): string | undefined {
-  const character = widget.character?.trim();
-  if (character) return character;
-  const config = widget.config as Record<string, unknown> | undefined;
-  const configCharacter = typeof config?.['character'] === 'string' ? config['character'].trim() : '';
-  if (configCharacter) return configCharacter;
-  if (widget.id && widget.id.trim()) return widget.id;
-  return undefined;
-}
-
-function markdownTextFromList(config: Record<string, unknown> | undefined): string {
-  const items = Array.isArray(config?.['items'])
-    ? config!['items'].filter((item): item is string => typeof item === 'string')
-    : [];
-  if (items.length === 0) return '(empty list)';
-  return items.map(item => `- ${item}`).join('\n');
-}
-
-function scratchText(config: Record<string, unknown> | undefined): string {
-  const memoLines = Array.isArray(config?.['memoLines'])
-    ? config!['memoLines'].filter((line): line is string => typeof line === 'string')
-    : [];
-  if (memoLines.length > 0) return memoLines.join('\n');
-  const previewLines = Array.isArray(config?.['previewLines'])
-    ? config!['previewLines'].filter((line): line is string => typeof line === 'string')
-    : [];
-  if (previewLines.length > 0) return previewLines.join('\n');
-  return '';
-}
-
-function paneSpecFromWidget(widget: WidgetSpec): PaneContentSpec | null {
-  if (widget.children && widget.children.length > 0) return null;
-  const config = widget.config as Record<string, unknown> | undefined;
-  const title = titleForWidget(widget);
-  switch (widget.type) {
-    case 'markdown':
-      return {
-        kind: 'markdown',
-        ...(title ? { title } : {}),
-        text: typeof config?.['text'] === 'string' ? config['text'] : '',
-      };
-    case 'scratch':
-      return {
-        kind: 'scratch',
-        ...(title ? { title } : {}),
-        initialText: scratchText(config),
-      };
-    case 'log': {
-      const lines = Array.isArray(config?.['lines'])
-        ? config!['lines'].filter((line): line is string => typeof line === 'string')
-        : [];
-      return {
-        kind: 'markdown',
-        ...(title ? { title } : {}),
-        text: lines.join('\n'),
-      };
-    }
-    case 'list':
-      return {
-        kind: 'markdown',
-        ...(title ? { title } : {}),
-        text: markdownTextFromList(config),
-      };
-    case 'hello-text':
-      return {
-        kind: 'markdown',
-        ...(title ? { title } : {}),
-        text: typeof config?.['message'] === 'string' ? config['message'] : 'Hello, world!',
-      };
-    default:
-      return null;
-  }
-}
-
-export function convertScenarioWidgetsToPaneSpecs(
-  widgets: readonly DeclarativeWidgetNode[],
-): PaneConversion {
-  const built = buildScenarioWidgetSpecs(widgets);
-  const panes: PaneContentSpec[] = [];
-  const unsupported: string[] = [];
-  for (const widget of built) {
-    const pane = paneSpecFromWidget(widget);
-    if (!pane) {
-      unsupported.push(widget.type);
-      continue;
-    }
-    panes.push(pane);
-  }
-  return {
-    panes,
-    unsupported: [...new Set(unsupported)].sort(),
-  };
-}
-
-function mountConvertedScenarioAtPane(
-  converted: PaneConversion,
-  target: ScenarioPaneTarget,
-  deps: ScenarioWindowMountDeps,
-): { mounted: boolean; error?: string } {
-  const window = deps.registry.get(target.windowId);
-  if (!window) {
-    return {
-      mounted: false,
-      error: `RunScenario: target window ${target.windowId} was not found`,
-    };
-  }
-  if (!window.getPane(target.paneId)) {
-    return {
-      mounted: false,
-      error: `RunScenario: target pane ${target.paneId} was not found in window ${target.windowId}`,
-    };
-  }
-  try {
-    const replacement = deps.createPaneContent(converted.panes[0]!);
-    window.splitPaneAt(target.paneId, 'h', replacement);
-    window.closePaneAt(target.paneId);
-
-    const splitAxes: readonly Axis[] = ['v', 'h'];
-    for (let i = 1; i < converted.panes.length; i++) {
-      const pane = deps.createPaneContent(converted.panes[i]!);
-      window.splitFocused(splitAxes[(i - 1) % splitAxes.length]!, pane);
-    }
-    return { mounted: true };
-  } catch (err) {
-    return {
-      mounted: false,
-      error: `RunScenario: target pane mount failed: ${(err as Error).message}`,
-    };
-  }
-}
-
-export function mountScenarioIntoWindow(
-  widgets: readonly DeclarativeWidgetNode[],
-  windowId: number,
-  deps: ScenarioWindowMountDeps,
-): { mounted: boolean; error?: string } {
-  const converted = convertScenarioWidgetsToPaneSpecs(widgets);
-  if (converted.unsupported.length > 0) {
-    return {
-      mounted: false,
-      error:
-        'RunScenario: target window mount currently supports only pane-mappable widgets; '
-        + `unsupported: ${converted.unsupported.join(', ')}`,
-    };
-  }
-  if (converted.panes.length === 0) {
-    return {
-      mounted: false,
-      error: 'RunScenario: scenario produced zero pane-mappable widgets',
-    };
-  }
-  const window = deps.registry.get(windowId);
-  if (!window) {
-    return {
-      mounted: false,
-      error: `RunScenario: target window ${windowId} was not found`,
-    };
-  }
-  return mountConvertedScenarioAtPane(converted, {
-    windowId,
-    paneId: window.focused,
-  }, deps);
-}
-
-export function mountScenarioIntoPane(
-  widgets: readonly DeclarativeWidgetNode[],
-  target: ScenarioPaneTarget,
-  deps: ScenarioWindowMountDeps,
-): { mounted: boolean; error?: string } {
-  const converted = convertScenarioWidgetsToPaneSpecs(widgets);
-  if (converted.unsupported.length > 0) {
-    return {
-      mounted: false,
-      error:
-        'RunScenario: target pane mount currently supports only pane-mappable widgets; '
-        + `unsupported: ${converted.unsupported.join(', ')}`,
-    };
-  }
-  if (converted.panes.length === 0) {
-    return {
-      mounted: false,
-      error: 'RunScenario: scenario produced zero pane-mappable widgets',
-    };
-  }
-  return mountConvertedScenarioAtPane(converted, target, deps);
-}

package/src/views/ui-mode.ts

@@ -1,100 +0,0 @@
-// ── Dashboard UI mode — essential(chat-first) vs rich(full dashboard) ──
-//
-// TUI 부활 아크 T0 (PLAN-tui-revival-essentials-2026-07-12 §3a).
-// 단일 config 축 `dashboard.uiMode` 로 두 UI 모드를 스위치한다:
-//
-//   - 'essential' (기본) — codex/claude-code 패리티. chat 전체화면
-//     (기존 chatOnlyMode 레이아웃) + 1줄 status line. HUD pill·dock·
-//     VW 는 후속 phase(T1/T3)에서 이 값으로 게이트된다.
-//   - 'rich'      — 기존 전체 기능(3-pane grid·VW·widget·마우스) 그대로.
-//
-// 우선순위: CLI `--rich` > config `dashboard.uiMode` > 레거시
-// `dashboard.defaultMode` 매핑('chat'→essential · 'dashboard'→rich) >
-// 기본 'essential'. 레거시 defaultMode 는 uiMode 로 흡수 — 명시적으로
-// 'dashboard' 를 설정해 둔 사용자의 의도(그리드 부팅)를 rich 로 보존한다.
-
-export type DashboardUiMode = 'essential' | 'rich';
-
-export interface ResolveDashboardUiModeInput {
-  /** CLI `--rich` — 이번 실행만 rich 강제 (config 무변). */
-  cliRich?: boolean | undefined;
-  /** config `dashboard.uiMode` — 명시 설정 시 그대로. */
-  configUiMode?: DashboardUiMode | undefined;
-  /** 레거시 `dashboard.defaultMode` — uiMode 미설정 시에만 참조. */
-  legacyDefaultMode?: 'chat' | 'dashboard' | undefined;
-}
-
-export function resolveDashboardUiMode(input: ResolveDashboardUiModeInput): DashboardUiMode {
-  if (input.cliRich === true) return 'rich';
-  if (input.configUiMode === 'essential' || input.configUiMode === 'rich') {
-    return input.configUiMode;
-  }
-  if (input.legacyDefaultMode === 'dashboard') return 'rich';
-  // legacyDefaultMode === 'chat' 도 여기로 — essential 이 곧 chat-first.
-  return 'essential';
-}
-
-// ── Heavy-feature gate — 「그 모드에서 무엇을 켜도 되나」 ────────────────
-//
-// `resolveDashboardUiMode` 의 짝. 대시보드 실행 경로에 흩어진
-// `dashboardUiMode === 'rich'` 판단(여덟 자리)과 같은 결론을 순수로 낸다.
-// 배선은 다음 착지 — 이 모듈은 정책 경계만 소유한다.
-//
-// 여덟 자리 대응 (src/dashboard/index.ts, 읽기만):
-//   1901 setScratchImage          → scratch-image
-//   1904 setScratchFile           → scratch-file
-//   2112 setScratchImage          → scratch-image
-//   2124 showPreviewModal         → clipboard-preview-modal
-//   12082 hoverPopupsEnabled      → hover-popups
-//   12468 HUD zone                → hud
-//   12513 dock zone               → dock
-//   12581 foregroundWorkspaceFrame → workspace-frame
-
-export type DashboardHeavyFeature =
-  | 'scratch-image'
-  | 'scratch-file'
-  | 'clipboard-preview-modal'
-  | 'hover-popups'
-  | 'hud'
-  | 'dock'
-  | 'workspace-frame';
-
-const DASHBOARD_HEAVY_FEATURES: readonly DashboardHeavyFeature[] = [
-  'scratch-image',
-  'scratch-file',
-  'clipboard-preview-modal',
-  'hover-popups',
-  'hud',
-  'dock',
-  'workspace-frame',
-];
-
-const DASHBOARD_HEAVY_FEATURE_SET: ReadonlySet<string> = new Set(DASHBOARD_HEAVY_FEATURES);
-
-/** Runtime boundary: unknown names fail closed without widening the typed gate. */
-export function isDashboardHeavyFeature(value: string): value is DashboardHeavyFeature {
-  return DASHBOARD_HEAVY_FEATURE_SET.has(value);
-}
-
-export function isDashboardHeavyFeatureEnabled(
-  mode: DashboardUiMode,
-  feature: DashboardHeavyFeature,
-): boolean {
-  return mode === 'rich' && DASHBOARD_HEAVY_FEATURE_SET.has(feature);
-}
-
-// ── Scratch-image size — 터미널 크기 → 스크래치 영역 크기 ────────────────
-//
-// `setScratchImage` 클로저 안의 순수 두 줄과 같은 계산.
-// 열: 최소 20 · 최대 60 · 비율 1/4. 행: 최소 8 · 최대 28 · 비율 45%.
-// 배선은 다음 착지 — 이 모듈은 크기 정책만 소유한다.
-
-export function scratchImageSize(
-  terminalRows: number,
-  terminalCols: number,
-): { rows: number; cols: number } {
-  return {
-    cols: Math.max(20, Math.min(60, Math.floor(terminalCols * 0.25))),
-    rows: Math.max(8, Math.min(28, Math.floor(terminalRows * 0.45))),
-  };
-}

package/src/virtual-window-context-menu.ts

@@ -1,97 +0,0 @@
-import type {
-  MenuProviderRegistry,
-  MenuProvider,
-  MenuBuildContext,
-} from './ui/context-menu-providers.js';
-import type { Menu } from './ui/context-menu-registry.js';
-import type { HitTarget } from './display/types.js';
-import type { PaneContentKind } from './virtual-windows/pane-content.js';
-
-export interface VirtualWindowTitleMenuPayload {
-  readonly windowId: string;
-  readonly paneId: string;
-}
-
-export interface VirtualWindowTitleMenuProviderDeps {
-  resolvePaneKind?: (payload: VirtualWindowTitleMenuPayload) => PaneContentKind | null;
-  isCompanionOpen?: (
-    payload: VirtualWindowTitleMenuPayload,
-    key: 'clipboard' | 'memo' | 'detail',
-  ) => boolean;
-}
-
-const POPUP_RETURN_CAPABLE_KINDS = new Set<PaneContentKind>([
-  'vw-browser',
-  'vw-preview',
-  'terminal-slot',
-  'scratch',
-]);
-
-export function createVirtualWindowTitleMenuProvider(
-  deps: VirtualWindowTitleMenuProviderDeps = {},
-): MenuProvider {
-  return (hit: HitTarget, _ctx: MenuBuildContext): Menu | null => {
-    if (hit.kind !== 'vw-pane-title') return null;
-    const payload: VirtualWindowTitleMenuPayload = {
-      windowId: String(hit.windowId),
-      paneId: hit.paneId,
-    };
-    const kind = deps.resolvePaneKind?.(payload) ?? null;
-    const clipboardOpen = deps.isCompanionOpen?.(payload, 'clipboard') ?? false;
-    const memoOpen = deps.isCompanionOpen?.(payload, 'memo') ?? false;
-    const detailOpen = deps.isCompanionOpen?.(payload, 'detail') ?? false;
-    const items: Menu['items'] = [
-      {
-        kind: 'command',
-        id: 'vw.selector',
-        label: 'Open pane/window selector…',
-        payload,
-      },
-      { kind: 'separator' },
-      {
-        kind: 'command',
-        id: 'vw.clipboard-companion',
-        label: clipboardOpen ? 'Hide clipboard companion' : 'Show clipboard companion',
-        payload,
-      },
-      {
-        kind: 'command',
-        id: 'vw.memo-companion',
-        label: memoOpen ? 'Hide memo companion' : 'Show memo companion',
-        payload,
-      },
-      {
-        kind: 'command',
-        id: 'vw.detail-companion',
-        label: detailOpen ? 'Hide detail companion' : 'Show detail companion',
-        payload,
-      },
-    ];
-    if (kind && POPUP_RETURN_CAPABLE_KINDS.has(kind)) {
-      items.push({
-        kind: 'command',
-        id: 'vw.return-popup',
-        label: 'Return to popup',
-        payload,
-      });
-    }
-    return {
-      id: `vw-pane-title:${payload.windowId}:${payload.paneId}`,
-      title: 'Pane',
-      items,
-    };
-  };
-}
-
-export function registerVirtualWindowContextMenus(
-  providers: MenuProviderRegistry,
-  deps: VirtualWindowTitleMenuProviderDeps = {},
-): () => void {
-  const unreg = providers.register('vw-pane-title:*', createVirtualWindowTitleMenuProvider(deps));
-  let disposed = false;
-  return () => {
-    if (disposed) return;
-    disposed = true;
-    try { unreg(); } catch { /* swallow */ }
-  };
-}