memorix 1.4.3 → 1.4.5

package/src/cli/tui/use-mouse.ts

@@ -1,157 +1,157 @@
-/**
- * useMouse — Ink hook for terminal mouse events via SGR protocol (1006).
- *
- * Enables mouse tracking on mount and parses SGR escape sequences from stdin.
- * Supports left/middle/right click, wheel scroll, and drag.
- * Automatically disables mouse tracking on unmount.
- *
- * Compatible terminals: Windows Terminal, iTerm2, WezTerm, GNOME Terminal,
- * Konsole, MinTTY. NOT compatible with CMD.exe.
- */
-
-import { useEffect, useCallback, useRef } from 'react';
-import { useStdin } from 'ink';
-
-export interface MouseEvent {
-  /** 0-based column position */
-  x: number;
-  /** 0-based row position */
-  y: number;
-  button: 'left' | 'middle' | 'right' | 'wheelUp' | 'wheelDown';
-  action: 'press' | 'release' | 'drag';
-  shift: boolean;
-  alt: boolean;
-  ctrl: boolean;
-}
-
-// SGR mouse protocol regex: ESC[<code;col;rowM or ESC[<code;col;rowm
-const SGR_RE = /\x1b\[<(\d+);(\d+);(\d+)([Mm])/g;
-
-function toMouseEvent(m: RegExpExecArray): MouseEvent {
-  const code = parseInt(m[1], 10);
-  const col = parseInt(m[2], 10);
-  const row = parseInt(m[3], 10);
-  const suffix = m[4];
-
-  const wheel = code & 0b11000000;
-  const btnId = code & 0b11;
-
-  const button =
-    wheel === 64 ? 'wheelUp' :
-    wheel === 65 ? 'wheelDown' :
-    btnId === 0 ? 'left' :
-    btnId === 1 ? 'middle' :
-    'right';
-
-  const action: MouseEvent['action'] =
-    wheel !== 0 ? 'press' :
-    suffix === 'M' ? 'press' :
-    'release';
-
-  const isMotion = !!(code & 0x20);
-  const finalAction = isMotion && suffix === 'M' ? 'drag' : action;
-
-  return {
-    x: col - 1,
-    y: row - 1,
-    button,
-    action: finalAction,
-    shift: !!(code & 4),
-    alt: !!(code & 8),
-    ctrl: !!(code & 16),
-  };
-}
-
-export function parseSGRSequence(buf: string): MouseEvent[] {
-  const events: MouseEvent[] = [];
-  SGR_RE.lastIndex = 0;
-  let match: RegExpExecArray | null;
-  while ((match = SGR_RE.exec(buf)) !== null) {
-    events.push(toMouseEvent(match));
-  }
-  return events;
-}
-
-export function parseSGRBuffer(buf: string): { events: MouseEvent[]; remainder: string } {
-  const events: MouseEvent[] = [];
-  SGR_RE.lastIndex = 0;
-  let match: RegExpExecArray | null;
-  let lastConsumed = 0;
-  while ((match = SGR_RE.exec(buf)) !== null) {
-    events.push(toMouseEvent(match));
-    lastConsumed = SGR_RE.lastIndex;
-  }
-
-  const tail = lastConsumed > 0 ? buf.slice(lastConsumed) : buf;
-  const remainderStart = tail.lastIndexOf('\x1b[<');
-  return {
-    events,
-    remainder: remainderStart >= 0 ? tail.slice(remainderStart) : '',
-  };
-}
-
-// ANSI sequences to enable/disable SGR mouse mode
-const ENABLE_SGR = '\x1b[?1006h\x1b[?1000h';
-const DISABLE_SGR = '\x1b[?1000l\x1b[?1006l';
-
-export type MouseHandler = (event: MouseEvent) => void;
-
-export interface UseMouseOptions {
-  /** Whether mouse tracking is active (default: true) */
-  isActive?: boolean;
-  /** Whether to manage SGR terminal mode (enable/disable). Set to false when
-   *  a parent component centrally manages SGR mode. (default: true) */
-  manageMode?: boolean;
-}
-
-/**
- * Hook that listens for terminal mouse events using the SGR protocol.
- *
- * Usage:
- * ```tsx
- * useMouse((e) => {
- *   if (e.button === 'left' && e.action === 'press') {
- *     console.log(`Clicked at (${e.x}, ${e.y})`);
- *   }
- * });
- * ```
- */
-export function useMouse(handler: MouseHandler, options: UseMouseOptions = {}): void {
-  const { isActive = true, manageMode = true } = options;
-  const handlerRef = useRef(handler);
-  handlerRef.current = handler;
-  const bufferRef = useRef('');
-
-  const { stdin } = useStdin();
-
-  const onData = useCallback((data: Buffer | string) => {
-    const str = typeof data === 'string' ? data : data.toString('utf8');
-    const { events, remainder } = parseSGRBuffer(bufferRef.current + str);
-    bufferRef.current = remainder;
-    for (const event of events) {
-      handlerRef.current(event);
-    }
-  }, []);
-
-  useEffect(() => {
-    if (!isActive || !stdin) return;
-    bufferRef.current = '';
-
-    // Enable SGR mouse mode (unless parent manages it centrally)
-    if (manageMode && process.stdout && typeof process.stdout.write === 'function') {
-      process.stdout.write(ENABLE_SGR);
-    }
-
-    // Attach listener
-    stdin.on('data', onData);
-
-    return () => {
-      bufferRef.current = '';
-      // Disable mouse mode (unless parent manages it centrally)
-      if (manageMode && process.stdout && typeof process.stdout.write === 'function') {
-        process.stdout.write(DISABLE_SGR);
-      }
-      stdin.off('data', onData);
-    };
-  }, [isActive, stdin, onData, manageMode]);
-}
+/**
+ * useMouse — Ink hook for terminal mouse events via SGR protocol (1006).
+ *
+ * Enables mouse tracking on mount and parses SGR escape sequences from stdin.
+ * Supports left/middle/right click, wheel scroll, and drag.
+ * Automatically disables mouse tracking on unmount.
+ *
+ * Compatible terminals: Windows Terminal, iTerm2, WezTerm, GNOME Terminal,
+ * Konsole, MinTTY. NOT compatible with CMD.exe.
+ */
+
+import { useEffect, useCallback, useRef } from 'react';
+import { useStdin } from 'ink';
+
+export interface MouseEvent {
+  /** 0-based column position */
+  x: number;
+  /** 0-based row position */
+  y: number;
+  button: 'left' | 'middle' | 'right' | 'wheelUp' | 'wheelDown';
+  action: 'press' | 'release' | 'drag';
+  shift: boolean;
+  alt: boolean;
+  ctrl: boolean;
+}
+
+// SGR mouse protocol regex: ESC[<code;col;rowM or ESC[<code;col;rowm
+const SGR_RE = /\x1b\[<(\d+);(\d+);(\d+)([Mm])/g;
+
+function toMouseEvent(m: RegExpExecArray): MouseEvent {
+  const code = parseInt(m[1], 10);
+  const col = parseInt(m[2], 10);
+  const row = parseInt(m[3], 10);
+  const suffix = m[4];
+
+  const wheel = code & 0b11000000;
+  const btnId = code & 0b11;
+
+  const button =
+    wheel === 64 ? 'wheelUp' :
+    wheel === 65 ? 'wheelDown' :
+    btnId === 0 ? 'left' :
+    btnId === 1 ? 'middle' :
+    'right';
+
+  const action: MouseEvent['action'] =
+    wheel !== 0 ? 'press' :
+    suffix === 'M' ? 'press' :
+    'release';
+
+  const isMotion = !!(code & 0x20);
+  const finalAction = isMotion && suffix === 'M' ? 'drag' : action;
+
+  return {
+    x: col - 1,
+    y: row - 1,
+    button,
+    action: finalAction,
+    shift: !!(code & 4),
+    alt: !!(code & 8),
+    ctrl: !!(code & 16),
+  };
+}
+
+export function parseSGRSequence(buf: string): MouseEvent[] {
+  const events: MouseEvent[] = [];
+  SGR_RE.lastIndex = 0;
+  let match: RegExpExecArray | null;
+  while ((match = SGR_RE.exec(buf)) !== null) {
+    events.push(toMouseEvent(match));
+  }
+  return events;
+}
+
+export function parseSGRBuffer(buf: string): { events: MouseEvent[]; remainder: string } {
+  const events: MouseEvent[] = [];
+  SGR_RE.lastIndex = 0;
+  let match: RegExpExecArray | null;
+  let lastConsumed = 0;
+  while ((match = SGR_RE.exec(buf)) !== null) {
+    events.push(toMouseEvent(match));
+    lastConsumed = SGR_RE.lastIndex;
+  }
+
+  const tail = lastConsumed > 0 ? buf.slice(lastConsumed) : buf;
+  const remainderStart = tail.lastIndexOf('\x1b[<');
+  return {
+    events,
+    remainder: remainderStart >= 0 ? tail.slice(remainderStart) : '',
+  };
+}
+
+// ANSI sequences to enable/disable SGR mouse mode
+const ENABLE_SGR = '\x1b[?1006h\x1b[?1000h';
+const DISABLE_SGR = '\x1b[?1000l\x1b[?1006l';
+
+export type MouseHandler = (event: MouseEvent) => void;
+
+export interface UseMouseOptions {
+  /** Whether mouse tracking is active (default: true) */
+  isActive?: boolean;
+  /** Whether to manage SGR terminal mode (enable/disable). Set to false when
+   *  a parent component centrally manages SGR mode. (default: true) */
+  manageMode?: boolean;
+}
+
+/**
+ * Hook that listens for terminal mouse events using the SGR protocol.
+ *
+ * Usage:
+ * ```tsx
+ * useMouse((e) => {
+ *   if (e.button === 'left' && e.action === 'press') {
+ *     console.log(`Clicked at (${e.x}, ${e.y})`);
+ *   }
+ * });
+ * ```
+ */
+export function useMouse(handler: MouseHandler, options: UseMouseOptions = {}): void {
+  const { isActive = true, manageMode = true } = options;
+  const handlerRef = useRef(handler);
+  handlerRef.current = handler;
+  const bufferRef = useRef('');
+
+  const { stdin } = useStdin();
+
+  const onData = useCallback((data: Buffer | string) => {
+    const str = typeof data === 'string' ? data : data.toString('utf8');
+    const { events, remainder } = parseSGRBuffer(bufferRef.current + str);
+    bufferRef.current = remainder;
+    for (const event of events) {
+      handlerRef.current(event);
+    }
+  }, []);
+
+  useEffect(() => {
+    if (!isActive || !stdin) return;
+    bufferRef.current = '';
+
+    // Enable SGR mouse mode (unless parent manages it centrally)
+    if (manageMode && process.stdout && typeof process.stdout.write === 'function') {
+      process.stdout.write(ENABLE_SGR);
+    }
+
+    // Attach listener
+    stdin.on('data', onData);
+
+    return () => {
+      bufferRef.current = '';
+      // Disable mouse mode (unless parent manages it centrally)
+      if (manageMode && process.stdout && typeof process.stdout.write === 'function') {
+        process.stdout.write(DISABLE_SGR);
+      }
+      stdin.off('data', onData);
+    };
+  }, [isActive, stdin, onData, manageMode]);
+}

package/src/cli/tui/useNavigation.ts

@@ -1,56 +1,56 @@
-/**
- * Centralized keyboard navigation for the Memorix TUI.
- *
- * Three-layer priority model:
- * 1. Action view local keys (1-9, h, w, Esc) — highest
- * 2. CommandBar input mode — captures all printable chars when focused
- * 3. Global nav keys (s, r, v, d, b, w, p, c, i, h) — lowest, only when idle
- */
-
-import type { ViewType } from './theme.js';
-
-/** Maps single-char shortcut keys to view navigation commands */
-export const NAV_KEY_MAP: Record<string, string> = {
-  s: '/search',
-  r: '/remember',
-  v: '/recent',
-  d: '/doctor',
-  b: '/background',
-  w: '/dashboard',
-  p: '/project',
-  c: '/configure',
-  i: '/integrate',
-  h: '/home',
-};
-
-/** Views that handle their own number/letter keys (action views) */
-export const ACTION_VIEWS: Set<ViewType> = new Set([
-  'cleanup', 'ingest', 'background', 'dashboard', 'integrate', 'configure',
-]);
-
-/** Views where Esc returns to home */
-export const ESC_RETURNABLE_VIEWS: Set<ViewType> = new Set([
-  'chat', 'recent', 'doctor', 'project', 'cleanup', 'ingest',
-  'background', 'dashboard', 'integrate', 'configure', 'search', 'wiki',
-]);
-
-/**
- * Determine if a key press should be handled as global navigation.
- *
- * Returns the command string (e.g. '/recent') if the key is a nav key
- * and the current context allows it, or null otherwise.
- */
-export function resolveGlobalNav(
-  ch: string,
-  currentView: ViewType,
-  isInputFocused: boolean,
-): string | null {
-  // Never intercept during input
-  if (isInputFocused) return null;
-
-  // Action views handle their own keys — only allow 'h' for home
-  if (ACTION_VIEWS.has(currentView)) return null;
-
-  const cmd = NAV_KEY_MAP[ch];
-  return cmd ?? null;
-}
+/**
+ * Centralized keyboard navigation for the Memorix TUI.
+ *
+ * Three-layer priority model:
+ * 1. Action view local keys (1-9, h, w, Esc) — highest
+ * 2. CommandBar input mode — captures all printable chars when focused
+ * 3. Global nav keys (s, r, v, d, b, w, p, c, i, h) — lowest, only when idle
+ */
+
+import type { ViewType } from './theme.js';
+
+/** Maps single-char shortcut keys to view navigation commands */
+export const NAV_KEY_MAP: Record<string, string> = {
+  s: '/search',
+  r: '/remember',
+  v: '/recent',
+  d: '/doctor',
+  b: '/background',
+  w: '/dashboard',
+  p: '/project',
+  c: '/configure',
+  i: '/integrate',
+  h: '/home',
+};
+
+/** Views that handle their own number/letter keys (action views) */
+export const ACTION_VIEWS: Set<ViewType> = new Set([
+  'cleanup', 'ingest', 'background', 'dashboard', 'integrate', 'configure',
+]);
+
+/** Views where Esc returns to home */
+export const ESC_RETURNABLE_VIEWS: Set<ViewType> = new Set([
+  'chat', 'recent', 'doctor', 'project', 'cleanup', 'ingest',
+  'background', 'dashboard', 'integrate', 'configure', 'search', 'wiki',
+]);
+
+/**
+ * Determine if a key press should be handled as global navigation.
+ *
+ * Returns the command string (e.g. '/recent') if the key is a nav key
+ * and the current context allows it, or null otherwise.
+ */
+export function resolveGlobalNav(
+  ch: string,
+  currentView: ViewType,
+  isInputFocused: boolean,
+): string | null {
+  // Never intercept during input
+  if (isInputFocused) return null;
+
+  // Action views handle their own keys — only allow 'h' for home
+  if (ACTION_VIEWS.has(currentView)) return null;
+
+  const cmd = NAV_KEY_MAP[ch];
+  return cmd ?? null;
+}

package/src/cli/version.ts

@@ -1,7 +1,7 @@
-import pkg from '../../package.json';
-
-export function getCliVersion(): string {
-  return typeof __MEMORIX_VERSION__ !== 'undefined'
-    ? __MEMORIX_VERSION__
-    : pkg.version;
-}
+import pkg from '../../package.json';
+
+export function getCliVersion(): string {
+  return typeof __MEMORIX_VERSION__ !== 'undefined'
+    ? __MEMORIX_VERSION__
+    : pkg.version;
+}

package/src/cli/workbench.ts

@@ -5,4 +5,4 @@
  * Kept for backward-compat: `import { startWorkbench } from './workbench.js'`
  */
 
-export { startWorkbench } from './tui/index.js';
+export { startWorkbench } from './tui/index.js';

package/src/dashboard/project-classification.ts

@@ -1,64 +1,64 @@
-/**
- * Project classification helpers — shared by /api/projects and /api/identity.
- *
- * Three kinds:
- *   - 'real':        genuine user projects (e.g. AVIDS2/memorix, github.com/org/repo)
- *   - 'temporary':   test/demo/smoke/e2e scratch projects (local/task-*, local/smoke-*, etc.)
- *   - 'placeholder': unresolved / obviously broken IDs (placeholder/*, __unresolved__, System32)
- *
- * A 'dirty' project is one with a clearly broken canonical ID (System32 etc.).
- * 'dirty' and 'temporary' are orthogonal axes:
- *   - local/task-abc        → temporary, NOT dirty
- *   - placeholder/xxx       → placeholder, dirty
- *   - System32\something    → real-looking location but dirty (broken ID)
- */
-
-export type ProjectKind = 'real' | 'temporary' | 'placeholder';
-
-/** Regex list — anything matching is temporary (scratch projects) */
-const TEMPORARY_PATTERNS: RegExp[] = [
-  /^local\/task-/i,
-  /^local\/smoke-/i,
-  /^local\/release-smoke-/i,
-  /^local\/memorix-e2e-/i,
-  /^local\/orchestrate-/i,
-  /^local\/scratch-/i,
-  /^local\/tmp-/i,
-];
-
-/** Regex list — anything matching is placeholder/unresolved */
-const PLACEHOLDER_PATTERNS: RegExp[] = [
-  /^__unresolved__$/,
-  /^placeholder\//i,
-];
-
-/** Regex list — IDs that indicate a broken canonical ID (dirty). */
-const DIRTY_PATTERNS: RegExp[] = [
-  /^placeholder\//i,
-  /System32/i,
-  /Microsoft VS Code/i,
-  /node_modules/i,
-  /\.vscode/i,
-  /^local\/[A-Z]:\\/i,
-];
-
-export function classifyProjectId(id: string): ProjectKind {
-  if (!id) return 'placeholder';
-  if (PLACEHOLDER_PATTERNS.some(p => p.test(id))) return 'placeholder';
-  if (TEMPORARY_PATTERNS.some(p => p.test(id))) return 'temporary';
-  return 'real';
-}
-
-export function isDirtyProjectId(id: string): boolean {
-  if (!id) return false;
-  return DIRTY_PATTERNS.some(p => p.test(id));
-}
-
-/** Friendly label for UI badges */
-export function projectKindLabel(kind: ProjectKind): string {
-  switch (kind) {
-    case 'real': return 'real';
-    case 'temporary': return 'temporary';
-    case 'placeholder': return 'placeholder';
-  }
-}
+/**
+ * Project classification helpers — shared by /api/projects and /api/identity.
+ *
+ * Three kinds:
+ *   - 'real':        genuine user projects (e.g. AVIDS2/memorix, github.com/org/repo)
+ *   - 'temporary':   test/demo/smoke/e2e scratch projects (local/task-*, local/smoke-*, etc.)
+ *   - 'placeholder': unresolved / obviously broken IDs (placeholder/*, __unresolved__, System32)
+ *
+ * A 'dirty' project is one with a clearly broken canonical ID (System32 etc.).
+ * 'dirty' and 'temporary' are orthogonal axes:
+ *   - local/task-abc        → temporary, NOT dirty
+ *   - placeholder/xxx       → placeholder, dirty
+ *   - System32\something    → real-looking location but dirty (broken ID)
+ */
+
+export type ProjectKind = 'real' | 'temporary' | 'placeholder';
+
+/** Regex list — anything matching is temporary (scratch projects) */
+const TEMPORARY_PATTERNS: RegExp[] = [
+  /^local\/task-/i,
+  /^local\/smoke-/i,
+  /^local\/release-smoke-/i,
+  /^local\/memorix-e2e-/i,
+  /^local\/orchestrate-/i,
+  /^local\/scratch-/i,
+  /^local\/tmp-/i,
+];
+
+/** Regex list — anything matching is placeholder/unresolved */
+const PLACEHOLDER_PATTERNS: RegExp[] = [
+  /^__unresolved__$/,
+  /^placeholder\//i,
+];
+
+/** Regex list — IDs that indicate a broken canonical ID (dirty). */
+const DIRTY_PATTERNS: RegExp[] = [
+  /^placeholder\//i,
+  /System32/i,
+  /Microsoft VS Code/i,
+  /node_modules/i,
+  /\.vscode/i,
+  /^local\/[A-Z]:\\/i,
+];
+
+export function classifyProjectId(id: string): ProjectKind {
+  if (!id) return 'placeholder';
+  if (PLACEHOLDER_PATTERNS.some(p => p.test(id))) return 'placeholder';
+  if (TEMPORARY_PATTERNS.some(p => p.test(id))) return 'temporary';
+  return 'real';
+}
+
+export function isDirtyProjectId(id: string): boolean {
+  if (!id) return false;
+  return DIRTY_PATTERNS.some(p => p.test(id));
+}
+
+/** Friendly label for UI badges */
+export function projectKindLabel(kind: ProjectKind): string {
+  switch (kind) {
+    case 'real': return 'real';
+    case 'temporary': return 'temporary';
+    case 'placeholder': return 'placeholder';
+  }
+}