@pellux/goodvibes-agent 0.1.0

package/src/input/commands.ts

@@ -0,0 +1,131 @@
+import type { CommandRegistry } from './command-registry.ts';
+import { policyCommand } from './commands/policy.ts';
+import { providerCommand } from './commands/provider.ts';
+import { evalCommand } from './commands/eval.ts';
+import { sessionCommand } from './commands/session.ts';
+import { recallCommand } from './commands/memory.ts';
+import { knowledgeCommand } from './commands/knowledge.ts';
+import { registerShellCoreCommands } from './commands/shell-core.ts';
+import { registerConfigCommand } from './commands/config.ts';
+import { registerSessionWorkflowCommands } from './commands/session-workflow.ts';
+import { registerDiscoveryRuntimeCommands } from './commands/discovery-runtime.ts';
+import { registerPlanningRuntimeCommands } from './commands/planning-runtime.ts';
+import { registerScheduleRuntimeCommands } from './commands/schedule-runtime.ts';
+import { registerBranchRuntimeCommands } from './commands/branch-runtime.ts';
+import { registerOperatorRuntimeCommands } from './commands/operator-runtime.ts';
+import { registerIntegrationRuntimeCommands } from './commands/integration-runtime.ts';
+import { registerNotifyRuntimeCommands } from './commands/notify-runtime.ts';
+import { registerReplayRuntimeCommands } from './commands/replay-runtime.ts';
+import { registerShareRuntimeCommands } from './commands/share-runtime.ts';
+import { registerLocalSetupCommands } from './commands/local-setup.ts';
+import { registerProductRuntimeCommands } from './commands/product-runtime.ts';
+import { registerProfileSyncRuntimeCommands } from './commands/profile-sync-runtime.ts';
+import { registerManagedRuntimeCommands } from './commands/managed-runtime.ts';
+import { registerPlatformAccessRuntimeCommands } from './commands/platform-access-runtime.ts';
+import { registerPlatformServicesRuntimeCommands } from './commands/platform-services-runtime.ts';
+import { registerTeamworkRuntimeCommands } from './commands/teamwork-runtime.ts';
+import { registerMarketplaceRuntimeCommands } from './commands/marketplace-runtime.ts';
+import { registerGuidanceRuntimeCommands } from './commands/guidance-runtime.ts';
+import { registerRemoteRuntimeCommands } from './commands/remote-runtime.ts';
+import { registerTeleportRuntimeCommands } from './commands/teleport-runtime.ts';
+import { registerSubscriptionRuntimeCommands } from './commands/subscription-runtime.ts';
+import { registerHooksRuntimeCommands } from './commands/hooks-runtime.ts';
+import { registerControlRoomRuntimeCommands } from './commands/control-room-runtime.ts';
+import { registerMcpRuntimeCommands } from './commands/mcp-runtime.ts';
+import { registerSessionContentCommands } from './commands/session-content.ts';
+import { registerLocalRuntimeCommands } from './commands/local-runtime.ts';
+import { registerExperienceRuntimeCommands } from './commands/experience-runtime.ts';
+import { registerIncidentRuntimeCommands } from './commands/incident-runtime.ts';
+import { registerMemoryProductRuntimeCommands } from './commands/memory-product-runtime.ts';
+import { registerSkillsRuntimeCommands } from './commands/skills-runtime.ts';
+import { registerServicesRuntimeCommands } from './commands/services-runtime.ts';
+import { registerTasksRuntimeCommands } from './commands/tasks-runtime.ts';
+import { registerLocalProviderRuntimeCommands } from './commands/local-provider-runtime.ts';
+import { registerHealthRuntimeCommands } from './commands/health-runtime.ts';
+import { registerSettingsSyncRuntimeCommands } from './commands/settings-sync-runtime.ts';
+import { registerProviderAccountsRuntimeCommands } from './commands/provider-accounts-runtime.ts';
+import { registerLocalAuthRuntimeCommands } from './commands/local-auth-runtime.ts';
+import { registerIntelligenceRuntimeCommands } from './commands/intelligence-runtime.ts';
+import { registerConversationRuntimeCommands } from './commands/conversation-runtime.ts';
+import { registerQrcodeRuntimeCommands } from './commands/qrcode-runtime.ts';
+import { registerOnboardingRuntimeCommands } from './commands/onboarding-runtime.ts';
+import { registerTtsRuntimeCommands } from './commands/tts-runtime.ts';
+import { registerCloudflareRuntimeCommands } from './commands/cloudflare-runtime.ts';
+import { registerWorkPlanRuntimeCommands } from './commands/work-plan-runtime.ts';
+import { registerAgentWorkspaceRuntimeCommands } from './commands/agent-workspace-runtime.ts';
+import { registerAgentExternalizedTuiCommands } from './commands/agent-externalized-tui.ts';
+
+/**
+ * registerBuiltinCommands - Register all built-in slash commands into the registry.
+ * Call once during application startup.
+ */
+export function registerBuiltinCommands(registry: CommandRegistry): void {
+  registerShellCoreCommands(registry);
+  registerAgentWorkspaceRuntimeCommands(registry);
+  registerConfigCommand(registry);
+  registerOperatorRuntimeCommands(registry);
+  registerIntegrationRuntimeCommands(registry);
+  registerAgentExternalizedTuiCommands(registry);
+  registerNotifyRuntimeCommands(registry);
+  registerReplayRuntimeCommands(registry);
+  registerShareRuntimeCommands(registry);
+  registerLocalSetupCommands(registry);
+  registerProductRuntimeCommands(registry);
+  registerProfileSyncRuntimeCommands(registry);
+  registerManagedRuntimeCommands(registry);
+  registerPlatformAccessRuntimeCommands(registry);
+  registerPlatformServicesRuntimeCommands(registry);
+  registerTeamworkRuntimeCommands(registry);
+  registerMarketplaceRuntimeCommands(registry);
+  registerGuidanceRuntimeCommands(registry);
+  registerRemoteRuntimeCommands(registry);
+  registerTeleportRuntimeCommands(registry);
+  registerSubscriptionRuntimeCommands(registry);
+  registerHooksRuntimeCommands(registry);
+  registerControlRoomRuntimeCommands(registry);
+  registerMcpRuntimeCommands(registry);
+  registerIncidentRuntimeCommands(registry);
+  registerMemoryProductRuntimeCommands(registry);
+  registerSkillsRuntimeCommands(registry);
+  registerExperienceRuntimeCommands(registry);
+  registerServicesRuntimeCommands(registry);
+  registerTasksRuntimeCommands(registry);
+  registerLocalProviderRuntimeCommands(registry);
+  registerHealthRuntimeCommands(registry);
+  registerSettingsSyncRuntimeCommands(registry);
+  registerProviderAccountsRuntimeCommands(registry);
+  registerLocalAuthRuntimeCommands(registry);
+  registerIntelligenceRuntimeCommands(registry);
+  registerConversationRuntimeCommands(registry);
+  registerQrcodeRuntimeCommands(registry);
+  registerOnboardingRuntimeCommands(registry);
+  registerTtsRuntimeCommands(registry);
+  registerCloudflareRuntimeCommands(registry);
+  registerWorkPlanRuntimeCommands(registry);
+  registerLocalRuntimeCommands(registry);
+  registerSessionWorkflowCommands(registry);
+  registerDiscoveryRuntimeCommands(registry);
+  registerPlanningRuntimeCommands(registry);
+  registerScheduleRuntimeCommands(registry);
+  registerBranchRuntimeCommands(registry);
+  registerSessionContentCommands(registry);
+
+  // ── /policy ───────────────────────────────────────────────────────────────
+  registry.register(policyCommand);
+
+  // ── /provider ─────────────────────────────────────────────────────────────
+  registry.register(providerCommand);
+
+  // ── /eval ─────────────────────────────────────────────────────────────────
+  registry.register(evalCommand);
+
+  // ── /session ─────────────────────────────────────────────────────────────
+  registry.register(sessionCommand);
+
+  // ── /recall ──────────────────────────────────────────────────────────────
+  registry.register(recallCommand);
+
+  // ── /knowledge ───────────────────────────────────────────────────────────
+  registry.register(knowledgeCommand);
+
+}

package/src/input/feed-context-factory.ts

@@ -0,0 +1,254 @@
+/**
+ * feed-context-factory.ts — Construction and mutable-field sync for InputFeedContext.
+ *
+ * Extracted from handler.ts (Wave 4α review, 0.18.23) to keep handler.ts under the
+ * 800-line architecture cap.
+ *
+ * Two exported functions:
+ *   - `buildInitialFeedContext` — assembles the long-lived InputFeedContext from
+ *     pre-built field groups. Called once at InputHandler construction time.
+ *   - `syncFeedContextMutableFields` — copies mutable scalar fields into the
+ *     already-allocated context before each feed() dispatch.
+ */
+import type { InputFeedContext } from './handler-feed.ts';
+import type { SelectionManager } from './selection.ts';
+import type { InfiniteBuffer } from '../core/history.ts';
+import type { CommandRegistry, CommandContext } from './command-registry.ts';
+import type { AutocompleteEngine } from './autocomplete.ts';
+import type { FilePickerModal } from './file-picker.ts';
+import type { ModelPickerModal } from './model-picker.ts';
+import type { SelectionModal } from './selection-modal.ts';
+import type { SelectionResult } from './selection-modal.ts';
+import type { SearchManager } from './search.ts';
+import type { InputHistory, HistorySearch } from './input-history.ts';
+import type { ConversationManager } from '../core/conversation';
+import type { ProcessModal } from '../renderer/process-modal.ts';
+import type { LiveTailModal } from '../renderer/live-tail-modal.ts';
+import type { BlockActionsMenu } from '../renderer/block-actions.ts';
+import type { AgentDetailModal } from '../renderer/agent-detail-modal.ts';
+import type { ContextInspectorModal } from '../renderer/context-inspector.ts';
+import type { BookmarkModal } from './bookmark-modal.ts';
+import type { SettingsModal } from './settings-modal.ts';
+import type { McpWorkspace } from './mcp-workspace.ts';
+import type { AgentWorkspace } from './agent-workspace.ts';
+import type { SessionPickerModal } from './session-picker-modal.ts';
+import type { ProfilePickerModal } from './profile-picker-modal.ts';
+import type { OnboardingWizardController } from './onboarding/onboarding-wizard.ts';
+import type { WrappedPromptInfo } from './handler-prompt-buffer.ts';
+import type { Panel } from '../panels/types.ts';
+import type { PanelManager } from '../panels/panel-manager.ts';
+import type { KeybindingsManager } from './keybindings.ts';
+import type { ModelPickerTarget } from './model-picker.ts';
+import type { PanelMouseLayout } from './handler-feed-routes.ts';
+
+/**
+ * Initial mutable scalar values for InputFeedContext.
+ *
+ * **Mutable fields** (synced per-feed via syncFeedContextMutableFields or inside
+ * action closures that call syncFeedContextMutableFields):
+ *   - `prompt`, `cursorPos` — current text buffer state
+ *   - `commandMode`, `panelFocused`, `indicatorFocused` — focus-mode flags
+ *   - `helpOverlayActive`, `helpScrollOffset` — help overlay state
+ *   - `shortcutsOverlayActive`, `shortcutsScrollOffset` — shortcuts overlay state
+ *   - `nextPasteId`, `nextImageId` — monotonically increasing ID counters
+ *   - `mouseDownRow`, `mouseDownCol` — drag-tracking coordinates
+ *   - `contentWidth` — reflow width, updated by setContentWidth()
+ *   - `selectionCallback` — current selection modal callback (nullable)
+ */
+export interface FeedContextMutableInit {
+  prompt: string;
+  cursorPos: number;
+  inputScrollTop: number;
+  commandMode: boolean;
+  panelFocused: boolean;
+  indicatorFocused: boolean;
+  helpOverlayActive: boolean;
+  helpScrollOffset: number;
+  shortcutsOverlayActive: boolean;
+  shortcutsScrollOffset: number;
+  nextPasteId: number;
+  nextImageId: number;
+  mouseDownRow: number;
+  mouseDownCol: number;
+  contentWidth: number;
+  panelMouseLayout: PanelMouseLayout | null;
+  selectionCallback: ((result: SelectionResult | null) => void) | null;
+}
+
+/**
+ * Stable (readonly) service references for InputFeedContext.
+ *
+ * **Stable references** (set once at construction, never reallocated):
+ *   - `pasteRegistry`, `imageRegistry` — owned Maps, never replaced
+ *   - `selectionModal`, `bookmarkModal`, `settingsModal`, `sessionPickerModal`,
+ *     `profilePickerModal` — modal objects constructed once
+ *   - `filePicker`, `modelPicker`, `processModal`, `liveTailModal`,
+ *     `agentDetailModal`, `contextInspectorModal`, `blockActionsMenu`,
+ *     `searchManager`, `historySearch`, `onboardingWizard` — service objects constructed once
+ *   - `panelManager`, `keybindingsManager` — from uiServices, stable
+ *   - `modalStack` — reference to the handler's shared array
+ *   - `getHistory`, `getViewportHeight`, `getScrollTop`, `scroll`, `exitApp` — callbacks
+ *   - `commandRegistry`, `commandContext`, `autocomplete`, `inputHistory`,
+ *     `conversationManager` — wired after construction; synced at feed() entry only
+ *     (not per-action) since no in-feed action changes them
+ *
+ * **Rationale:** per-feed mutation on a single object avoids per-keystroke GC pressure
+ * from ~80-field object allocation. Stable references are service handles that never
+ * need to change after construction.
+ */
+export interface FeedContextStableRefs {
+  selection: SelectionManager;
+  pasteRegistry: Map<string, string>;
+  imageRegistry: Map<string, { data: string; mediaType: string }>;
+  projectRoot: string;
+  selectionModal: SelectionModal;
+  bookmarkModal: BookmarkModal;
+  settingsModal: SettingsModal;
+  mcpWorkspace: McpWorkspace;
+  agentWorkspace: AgentWorkspace;
+  sessionPickerModal: SessionPickerModal;
+  profilePickerModal: ProfilePickerModal;
+  historySearch: HistorySearch;
+  commandRegistry: CommandRegistry | null;
+  commandContext: CommandContext | undefined;
+  autocomplete: AutocompleteEngine | null;
+  filePicker: FilePickerModal;
+  modelPicker: ModelPickerModal;
+  onboardingWizard: OnboardingWizardController;
+  processModal: ProcessModal;
+  liveTailModal: LiveTailModal;
+  agentDetailModal: AgentDetailModal;
+  contextInspectorModal: ContextInspectorModal;
+  blockActionsMenu: BlockActionsMenu;
+  searchManager: SearchManager;
+  modalStack: string[];
+  inputHistory: InputHistory | null;
+  conversationManager: ConversationManager | null;
+  panelManager: PanelManager;
+  keybindingsManager: KeybindingsManager;
+  getHistory: () => InfiniteBuffer;
+  getViewportHeight: () => number;
+  getScrollTop: () => number;
+  scroll: (delta: number) => void;
+  exitApp: () => void;
+}
+
+/** Bound method closures for InputFeedContext. Built in handler.ts where private members are accessible. */
+export interface FeedContextClosures {
+  modalOpened: (name: string) => void;
+  handleEscape: () => void;
+  handleCopy: () => void;
+  handleCtrlC: () => void;
+  handleBlockCopy: () => void;
+  handleBookmark: () => void;
+  handleBlockSave: () => void;
+  handleDiffApply: () => boolean;
+  handleUndo: () => void;
+  handleRedo: () => void;
+  handlePaste: () => void;
+  saveUndoState: () => void;
+  ensureInputCursorVisible: (contentWidth?: number) => void;
+  registerPaste: (content: string) => string;
+  executeBlockAction: (id: string) => void;
+  cyclePanelTab: (direction: 'next' | 'prev') => void;
+  onPanelInputConsumed: (activePanel: Panel | null, key: string) => void;
+  getWrappedPromptInfo: (contentWidth: number) => WrappedPromptInfo;
+  moveCursorVertical: (direction: -1 | 1) => boolean;
+  handlePathCompletion: () => boolean;
+  handleBlockToggle: () => void;
+  findMarkerAtPos: (pos: number) => { start: number; end: number } | null;
+  cleanupMarkerRegistry: (text: string) => void;
+  expandPrompt: (text: string) => string | import('@pellux/goodvibes-sdk/platform/providers').ContentPart[];
+  openModelPickerWithTarget: (target: ModelPickerTarget, source?: 'settings' | 'onboarding') => boolean;
+  openProviderModelPickerWithTarget: (target: ModelPickerTarget, source?: 'settings' | 'onboarding') => boolean;
+  onModelPickerCommit: () => boolean;
+  onOnboardingAction: (action: import('./onboarding/onboarding-wizard.ts').OnboardingWizardAction) => void;
+}
+
+/**
+ * buildInitialFeedContext — Allocate the single InputFeedContext that lives for the
+ * lifetime of the InputHandler.
+ *
+ * Accepts pre-built field groups from handler.ts where private access is available.
+ * The resulting context object is mutated in place on every feed() call via
+ * syncFeedContextMutableFields — no re-allocation occurs per keystroke.
+ *
+ * @param mutable  Initial mutable scalar values (synced per-feed).
+ * @param stable   Stable service references (set once, never replaced).
+ * @param closures Pre-built bound method closures (built in handler.ts).
+ */
+export function buildInitialFeedContext(
+  mutable: FeedContextMutableInit,
+  stable: FeedContextStableRefs,
+  closures: FeedContextClosures,
+): InputFeedContext {
+  const noop = (): void => {};
+  return {
+    // --- mutable scalars ---
+    ...mutable,
+    // --- requestRender: placeholder, swapped per-feed to buffered version ---
+    requestRender: noop,
+    // --- stable refs ---
+    ...stable,
+    // --- closures ---
+    ...closures,
+  };
+}
+
+/**
+ * syncFeedContextMutableFields — Copy mutable scalar fields into the reused
+ * InputFeedContext object.
+ *
+ * **Fields synced (updated on every call):**
+ *   - `prompt` — current prompt text buffer
+ *   - `cursorPos` — caret position within prompt
+ *   - `commandMode` — whether command-mode prefix is active
+ *   - `panelFocused` — whether the active panel owns keyboard focus
+ *   - `indicatorFocused` — whether the status indicator owns focus
+ *   - `helpOverlayActive` / `helpScrollOffset` — help overlay visibility and scroll
+ *   - `shortcutsOverlayActive` / `shortcutsScrollOffset` — shortcuts overlay state
+ *   - `selectionCallback` — the current in-flight selection modal callback
+ *   - `nextPasteId` / `nextImageId` — monotonically increasing allocation counters
+ *   - `mouseDownRow` / `mouseDownCol` — drag-start coordinates
+ *
+ * **Fields intentionally excluded (synced only at feed() entry, not here):**
+ *   - `contentWidth` — semi-stable; only changes on terminal resize via setContentWidth().
+ *     Synced at feed() entry because it is only relevant for layout, not action-reaction
+ *     sequences within a single feed.
+ *   - `commandRegistry`, `commandContext` — wired after construction via
+ *     setCommandRegistry(); synced at feed() entry since no in-feed action changes them.
+ *   - `autocomplete` — wired after construction; synced at feed() entry.
+ *   - `inputHistory`, `conversationManager` — late-wired service handles; stable within
+ *     a feed. Synced at feed() entry only.
+ *   - `requestRender` — swapped to a buffered version at feed() entry and restored in
+ *     the finally block; not managed by this function.
+ *
+ * Called from within action closures (`handleEscape`, `handleCtrlC`, `handleUndo`,
+ * `handleRedo`, `handlePaste`) that mutate handler state mid-feed, so subsequent
+ * route handlers see updated values without re-reading handler fields.
+ *
+ * @param fields  Current mutable field values from the handler.
+ * @param ctx     The InputFeedContext to update in place.
+ */
+export function syncFeedContextMutableFields(
+  fields: FeedContextMutableInit,
+  ctx: InputFeedContext,
+): void {
+  ctx.prompt = fields.prompt;
+  ctx.cursorPos = fields.cursorPos;
+  ctx.inputScrollTop = fields.inputScrollTop;
+  ctx.commandMode = fields.commandMode;
+  ctx.panelFocused = fields.panelFocused;
+  ctx.indicatorFocused = fields.indicatorFocused;
+  ctx.helpOverlayActive = fields.helpOverlayActive;
+  ctx.helpScrollOffset = fields.helpScrollOffset;
+  ctx.shortcutsOverlayActive = fields.shortcutsOverlayActive;
+  ctx.shortcutsScrollOffset = fields.shortcutsScrollOffset;
+  ctx.selectionCallback = fields.selectionCallback;
+  ctx.nextPasteId = fields.nextPasteId;
+  ctx.nextImageId = fields.nextImageId;
+  ctx.mouseDownRow = fields.mouseDownRow;
+  ctx.mouseDownCol = fields.mouseDownCol;
+  ctx.contentWidth = fields.contentWidth;
+  ctx.panelMouseLayout = fields.panelMouseLayout;
+}

package/src/input/file-picker.ts

@@ -0,0 +1,192 @@
+import { readdir } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import type { ShellPathService } from '@/runtime/index.ts';
+
+/**
+ * FilePickerModal - Fuzzy file finder triggered by @ in the input area.
+ * Walks the project directory, fuzzy-matches against the query,
+ * and lets the user select a file to insert its path.
+ */
+export class FilePickerModal {
+  constructor(private readonly shellPaths: Pick<ShellPathService, 'workingDirectory'>) {}
+
+  public active = false;
+  public query = '';
+  public searchFocused = true;
+  public results: string[] = [];
+  public selectedIndex = 0;
+  /** Position in the prompt where @ was typed — used to replace @query with the selected path */
+  public insertPos = 0;
+  /** When true, selected file inserts as !@path (inject mode) instead of @path */
+  public injectMode = false;
+
+  public allFiles: string[] = [];
+  private filesCached = false;
+  
+
+  private onUpdate: (() => void) | null = null;
+
+  /** Set a callback to trigger re-render when file list loads. */
+  setOnUpdate(fn: () => void): void {
+    this.onUpdate = fn;
+  }
+
+  /** Activate the file picker at the given prompt position. */
+  open(insertPos: number, injectMode = false): void {
+    this.active = true;
+    this.query = '';
+    this.searchFocused = true;
+    this.selectedIndex = 0;
+    this.insertPos = insertPos;
+    this.injectMode = injectMode;
+
+    if (this.filesCached) {
+      this.updateResults();
+    } else {
+      // Show "Loading..." immediately, load files in background
+      this.results = [];
+      this.loadFiles().then(() => {
+        if (this.active) {
+          this.updateResults();
+          this.onUpdate?.();
+        }
+      });
+    }
+  }
+
+  /** Close the file picker without selecting. */
+  close(): void {
+    this.active = false;
+    this.query = '';
+    this.searchFocused = true;
+    this.results = [];
+    this.selectedIndex = 0;
+    this.injectMode = false;
+  }
+
+  /** Update the search query and re-filter results. */
+  setQuery(q: string): void {
+    this.query = q;
+    this.selectedIndex = 0;
+    this.updateResults();
+  }
+
+  canFocusSearch(): boolean {
+    return true;
+  }
+
+  focusSearch(): void {
+    this.searchFocused = true;
+  }
+
+  blurSearch(): void {
+    this.searchFocused = false;
+  }
+
+  /** Move selection up. */
+  moveUp(): void {
+    if (this.selectedIndex > 0) this.selectedIndex--;
+  }
+
+  /** Move selection down. */
+  moveDown(): void {
+    if (this.selectedIndex < this.results.length - 1) this.selectedIndex++;
+  }
+
+  /** Get the currently selected file path, or null if none. */
+  getSelected(): string | null {
+    if (this.results.length === 0) return null;
+    return this.results[this.selectedIndex] ?? null;
+  }
+
+  /** Fuzzy match: does the query match the candidate? */
+  private fuzzyMatch(query: string, candidate: string): { match: boolean; score: number } {
+    if (query.length === 0) return { match: true, score: 0 };
+    const lowerQuery = query.toLowerCase();
+    const lowerCandidate = candidate.toLowerCase();
+
+    // Substring match (highest priority)
+    const subIdx = lowerCandidate.indexOf(lowerQuery);
+    if (subIdx !== -1) {
+      // Bonus for matching at start of filename (after last /)
+      const lastSlash = lowerCandidate.lastIndexOf('/');
+      const filenameStart = lastSlash + 1;
+      const isFilenameMatch = subIdx >= filenameStart;
+      return { match: true, score: isFilenameMatch ? 100 - subIdx : 50 - subIdx };
+    }
+
+    // Character-by-character fuzzy match
+    let qi = 0;
+    let score = 0;
+    for (let ci = 0; ci < lowerCandidate.length && qi < lowerQuery.length; ci++) {
+      if (lowerCandidate[ci] === lowerQuery[qi]) {
+        qi++;
+        score += 1;
+      }
+    }
+    if (qi === lowerQuery.length) {
+      return { match: true, score };
+    }
+    return { match: false, score: 0 };
+  }
+
+  private updateResults(): void {
+    if (this.query.length === 0) {
+      this.results = this.allFiles;
+      return;
+    }
+
+    const scored = this.allFiles
+      .map(f => ({ file: f, ...this.fuzzyMatch(this.query, f) }))
+      .filter(r => r.match)
+      .sort((a, b) => b.score - a.score)
+      ;
+
+    this.results = scored.map(r => r.file);
+    if (this.selectedIndex >= this.results.length) {
+      this.selectedIndex = Math.max(0, this.results.length - 1);
+    }
+  }
+
+  private async loadFiles(): Promise<void> {
+    const root = this.shellPaths.workingDirectory;
+    const files: string[] = [];
+    await this.walkDir(root, files, 0);
+    this.allFiles = files.sort();
+    this.filesCached = true;
+  }
+
+  private async walkDir(dir: string, files: string[], depth: number): Promise<void> {
+    if (depth > 8) return; // Limit depth
+    if (files.length > 5000) return; // Limit total files
+
+    let entries: import('node:fs').Dirent[];
+    try {
+      entries = (await readdir(dir, { withFileTypes: true })) as unknown as import('node:fs').Dirent[];
+    } catch {
+      return;
+    }
+
+    for (const entry of entries) {
+      // Skip hidden dirs, node_modules, dist, .git
+      if (entry.name.startsWith('.')) continue;
+      if (entry.name === 'node_modules' || entry.name === 'dist') continue;
+
+      const fullPath = join(dir, entry.name);
+      const relPath = relative(this.shellPaths.workingDirectory, fullPath);
+
+      if (entry.isDirectory()) {
+        files.push(relPath + '/');
+        await this.walkDir(fullPath, files, depth + 1);
+      } else if (entry.isFile()) {
+        files.push(relPath);
+      }
+    }
+  }
+
+  /** Invalidate the file cache (e.g., after file operations). */
+  invalidateCache(): void {
+    this.filesCached = false;
+    this.allFiles = [];
+  }
+}