@geminilight/mindos 0.6.50 → 0.6.52

package/app/components/settings/AiTab.tsx

@@ -179,6 +179,7 @@ export function AiTab({ data, updateAi, updateAgent, t }: AiTabProps) {
               <ApiKeyInput
                 value={currentConfig.apiKey}
                 onChange={v => patchProvider(provider, { apiKey: v })}
+                labels={{ change: t.settings.ai.keyChange, cancel: t.settings.ai.keyCancel }}
               />
               {preset.signupUrl && !currentConfig.apiKey && !activeEnvKey && (
                 <a

package/app/components/settings/Primitives.tsx

@@ -195,22 +195,103 @@ export function Toggle({ checked, onChange, size = 'md', disabled, title, onClic
   );
 }
 
-export function ApiKeyInput({ value, onChange, placeholder, disabled }: {
+export function ApiKeyInput({ value, onChange, placeholder, disabled, labels }: {
   value: string;
   onChange: (v: string) => void;
   placeholder?: string;
   disabled?: boolean;
+  labels?: { change?: string; cancel?: string };
 }) {
   const isMasked = value === '***set***';
+  const [editing, setEditing] = useState(false);
+  const [draft, setDraft] = useState('');
+  const inputRef = useRef<HTMLInputElement>(null);
+  const prevValueRef = useRef(value);
+
+  // Reset editing when the masked value identity changes (e.g. provider switch)
+  useEffect(() => {
+    if (prevValueRef.current !== value) {
+      prevValueRef.current = value;
+      setEditing(false);
+      setDraft('');
+    }
+  }, [value]);
+
+  const commitDraft = useCallback(() => {
+    if (draft.trim()) {
+      onChange(draft);
+    }
+    setEditing(false);
+    setDraft('');
+  }, [draft, onChange]);
+
+  const cancelEdit = useCallback(() => {
+    setEditing(false);
+    setDraft('');
+  }, []);
+
+  const changeLabel = labels?.change ?? 'Change';
+  const cancelLabel = labels?.cancel ?? 'Cancel';
+
+  // Masked state: show dots + "Change" button. No clearing on click.
+  if (isMasked && !editing) {
+    return (
+      <div className="flex items-center gap-2">
+        <div className="flex-1 px-3 py-2 text-sm bg-muted/50 border border-border rounded-lg text-muted-foreground select-none tracking-widest">
+          ••••••••••••
+        </div>
+        <button
+          type="button"
+          onClick={() => {
+            setDraft('');
+            setEditing(true);
+            requestAnimationFrame(() => inputRef.current?.focus());
+          }}
+          disabled={disabled}
+          className="shrink-0 px-3 py-2 text-xs font-medium rounded-lg border border-border text-muted-foreground hover:text-foreground hover:bg-muted transition-colors disabled:opacity-50"
+        >
+          {changeLabel}
+        </button>
+      </div>
+    );
+  }
+
+  // Edit mode (replacing masked key) — uses local draft, commits on Enter/blur
+  if (editing) {
+    return (
+      <div className="flex items-center gap-2">
+        <input
+          ref={inputRef}
+          type="password"
+          value={draft}
+          onChange={e => setDraft(e.target.value)}
+          onKeyDown={e => { if (e.key === 'Enter') commitDraft(); }}
+          onBlur={commitDraft}
+          placeholder={placeholder ?? 'sk-...'}
+          disabled={disabled}
+          className="flex-1 px-3 py-2 text-sm bg-background border border-border rounded-lg text-foreground placeholder:text-muted-foreground outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:opacity-50"
+        />
+        <button
+          type="button"
+          onMouseDown={e => e.preventDefault()}
+          onClick={cancelEdit}
+          className="shrink-0 px-3 py-2 text-xs font-medium rounded-lg border border-border text-muted-foreground hover:text-foreground hover:bg-muted transition-colors"
+        >
+          {cancelLabel}
+        </button>
+      </div>
+    );
+  }
+
+  // Normal (no masked key) — direct editing
   return (
     <input
       type="password"
-      value={isMasked ? '••••••••••••••••' : value}
+      value={value}
       onChange={e => onChange(e.target.value)}
       placeholder={placeholder ?? 'sk-...'}
       disabled={disabled}
       className="w-full px-3 py-2 text-sm bg-background border border-border rounded-lg text-foreground placeholder:text-muted-foreground outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:opacity-50"
-      onFocus={() => { if (isMasked) onChange(''); }}
     />
   );
 }

package/app/components/ui/Toaster.tsx

@@ -16,7 +16,7 @@ export default function Toaster() {
   if (toasts.length === 0) return null;
 
   return (
-    <div className="fixed bottom-4 right-4 z-50 flex flex-col-reverse gap-2 pointer-events-none" aria-live="polite">
+    <div className="fixed bottom-4 right-4 z-50 flex flex-col-reverse gap-2 pointer-events-none" role="status" aria-live="polite" aria-atomic="false">
       {toasts.map((t) => (
         <div
           key={t.id}

package/app/instrumentation.ts

@@ -40,7 +40,9 @@ export async function register() {
       try {
         const projRoot = process.env.MINDOS_PROJECT_ROOT || resolve(process.cwd(), '..');
         const skillCheckModule = resolve(projRoot, 'bin', 'lib', 'skill-check.js');
-        const { checkSkillVersions, updateSkill } = await import(skillCheckModule);
+        // eslint-disable-next-line @typescript-eslint/no-implied-eval
+        const dynamicRequireSkill = new Function('id', 'return require(id)') as (id: string) => any;
+        const { checkSkillVersions, updateSkill } = dynamicRequireSkill(skillCheckModule);
         const mismatches = checkSkillVersions(projRoot);
         for (const m of mismatches) {
           try {

package/app/lib/config/animation.ts

@@ -0,0 +1,76 @@
+/**
+ * Centralized animation configuration.
+ * Three-tier system for consistent animation timings across the app.
+ * All durations in milliseconds, <= 300ms per WCAG/a11y standards.
+ */
+
+/** Animation duration tiers */
+export const ANIMATION = {
+  // Micro: Quick feedback, hover/focus states
+  MICRO: 100,    // Button hover, icon transitions, quick visual feedback
+
+  // Short: Interactive transitions, small content changes
+  SHORT: 200,    // Slide/fade modals, popovers, panel opens, dropdowns, quick state changes
+
+  // Medium: Larger content transitions, drawing attention
+  MEDIUM: 300,   // Long panel slides, collapse/expand grids, significant layout changes
+
+  // Fast-exit: When closing/dismissing (slightly faster)
+  FAST_EXIT: 150,
+} as const;
+
+/** Easing functions (using Tailwind defaults) */
+export const EASING = {
+  // Use for enter/appear animations (slow start, fast end)
+  EASE_OUT: 'cubic-bezier(0, 0, 0.2, 1)',
+
+  // Use for exit/disappear animations (fast start, slow end)
+  EASE_IN: 'cubic-bezier(0.4, 0, 1, 1)',
+
+  // Use for continuous/reversible animations (uniform acceleration/deceleration)
+  EASE_IN_OUT: 'cubic-bezier(0.4, 0, 0.2, 1)',
+} as const;
+
+/**
+ * Helper to build transition string
+ * @example
+ * buildTransition('all') // 'all 200ms cubic-bezier(...)'
+ * buildTransition('opacity', { duration: ANIMATION.MICRO, easing: EASING.EASE_IN_OUT })
+ */
+export function buildTransition(
+  property: string = 'all',
+  options?: {
+    duration?: number;
+    easing?: string;
+    delay?: number;
+  }
+) {
+  const duration = options?.duration ?? ANIMATION.SHORT;
+  const easing = options?.easing ?? EASING.EASE_IN_OUT;
+  const delay = options?.delay ?? 0;
+
+  const delayStr = delay > 0 ? ` ${delay}ms` : '';
+  return `${property} ${duration}ms ${easing}${delayStr}`;
+}
+
+/**
+ * Usage guide:
+ *
+ * ### Hover/Focus (MICRO)
+ * className="transition duration-100 ease-out hover:bg-muted"
+ *
+ * ### Modal/Panel Open (SHORT with EASE_OUT)
+ * className="animate-in fade-in-0 zoom-in-95 duration-200 ease-out"
+ *
+ * ### Collapse/Expand Grid (MEDIUM with EASE_IN_OUT)
+ * style={{
+ *   transition: buildTransition('grid-template-rows', {
+ *     duration: ANIMATION.MEDIUM,
+ *     easing: EASING.EASE_IN_OUT
+ *   })
+ * }}
+ *
+ * ### Sidebar Slide (SHORT with EASE_OUT for enter, EASE_IN for exit)
+ * // Sidebar appears: transition duration-200 ease-out
+ * // Sidebar closes: transition duration-150 ease-in
+ */

package/app/lib/config/icon-scale.ts

@@ -0,0 +1,35 @@
+/**
+ * Centralized icon size scale.
+ * Replaces arbitrary sizes (10/12/13/14/15/16/18/20px) with a named scale.
+ * Usage: import { ICON_SIZES } from '@/lib/config/icon-scale'
+ */
+
+export const ICON_SIZES = {
+  xs: 10,    // Tiny: breadcrumb items, status dots, inline badges
+  sm: 12,    // Small: form field icons, list item decorators
+  md: 14,    // Medium: button icons, sidebar items, file tree (DEFAULT)
+  lg: 16,    // Large: main action buttons, panel headers
+  xl: 18,    // XL: hero icons, large buttons, empty states
+  xxl: 20,   // XXL: large empty state icons, prominent UI
+  xxxl: 24,  // XXXL: section headers, splash screens
+} as const;
+
+export type IconSize = keyof typeof ICON_SIZES;
+
+/**
+ * Helper: Get pixel value by size name
+ * @param size - Size key, e.g., 'md', 'lg'
+ * @returns Pixel value, e.g., 14
+ */
+export function getIconSize(size: IconSize): number {
+  return ICON_SIZES[size];
+}
+
+/**
+ * Most common sizes in the codebase:
+ * - md (14px): 60% of icons → FileTree, buttons, lists, sidebars
+ * - lg (16px): 20% of icons → Headers, main actions
+ * - sm (12px): 10% of icons → Inline, compact
+ * - xs (10px): 8% of icons → Badges, tiny status
+ * - xl+ (18-24px): 2% of icons → Empty states, highlights
+ */

package/app/lib/config/panel-sizes.ts

@@ -0,0 +1,58 @@
+/**
+ * Centralized panel width configuration.
+ * All panel sizing constants in one place for easy maintenance.
+ */
+
+import type { PanelId } from '@/components/ActivityBar';
+
+// ── Left Panel (Files/Search/Agents/Echo/Discover) ──
+
+export const DEFAULT_LEFT_PANEL_WIDTH: Record<PanelId, number> = {
+  files: 280,
+  search: 320,
+  echo: 340,
+  agents: 300,
+  discover: 300,
+  workflows: 320,
+};
+
+export const LEFT_PANEL: { DEFAULT: number; MIN: number; MAX_RATIO: number; MAX_ABS: number } = {
+  DEFAULT: 280,
+  MIN: 240,
+  MAX_RATIO: 0.45, // 45% of screen width
+  MAX_ABS: 600, // Absolute pixel max
+};
+
+// ── Right Ask Panel ──
+
+export const RIGHT_ASK_PANEL: { DEFAULT: number; MIN: number; MAX_ABS: number; MIN_CONTENT: number } = {
+  DEFAULT: 420,
+  MIN: 400,
+  MAX_ABS: 4000, // Unlikely but safe upper bound
+  MIN_CONTENT: 360, // Minimum content width when panel is resized
+};
+
+// ── Right Agent Detail Panel ──
+
+export const RIGHT_AGENT_DETAIL_PANEL: { DEFAULT: number; MIN: number; MAX_ABS: number; MAX_RATIO: number } = {
+  DEFAULT: 400,
+  MIN: 300,
+  MAX_ABS: 640,
+  MAX_RATIO: 0.42, // 42% of screen width
+};
+
+// ── Mobile/Responsive Breakpoints ──
+
+export const RESPONSIVE_BREAKPOINTS = {
+  mobile: 375,
+  tablet: 768,
+  desktop: 1024,
+  wide: 1440,
+};
+
+// ── Activity Bar ──
+
+export const ACTIVITY_BAR = {
+  WIDTH_COLLAPSED: 48,
+  WIDTH_EXPANDED: 180,
+};

package/app/lib/hooks/useFocusTrap.ts

@@ -0,0 +1,65 @@
+'use client';
+
+import { useEffect, useRef } from 'react';
+
+/**
+ * Focus trap hook: keeps Tab navigation within a dialog/modal.
+ * Wraps focus from last focusable element back to first, and vice versa.
+ */
+export function useFocusTrap(ref: React.RefObject<HTMLElement | null>, enabled = true) {
+  useEffect(() => {
+    if (!enabled || !ref.current) return;
+
+    const handleKeyDown = (e: KeyboardEvent) => {
+      if (e.key !== 'Tab') return;
+
+      const focusableElements = ref.current?.querySelectorAll(
+        'button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])'
+      ) as NodeListOf<HTMLElement>;
+
+      if (!focusableElements || focusableElements.length === 0) return;
+
+      const firstElement = focusableElements[0];
+      const lastElement = focusableElements[focusableElements.length - 1];
+      const activeElement = document.activeElement;
+
+      if (e.shiftKey) {
+        // Shift+Tab on first element -> focus last
+        if (activeElement === firstElement) {
+          e.preventDefault();
+          lastElement.focus();
+        }
+      } else {
+        // Tab on last element -> focus first
+        if (activeElement === lastElement) {
+          e.preventDefault();
+          firstElement.focus();
+        }
+      }
+    };
+
+    const container = ref.current;
+    container.addEventListener('keydown', handleKeyDown);
+    return () => container.removeEventListener('keydown', handleKeyDown);
+  }, [ref, enabled]);
+}
+
+/**
+ * Return focus hook: saves reference to trigger element and restores focus on unmount
+ */
+export function useReturnFocus() {
+  const triggerRef = useRef<HTMLElement | null>(null);
+
+  const saveTrigger = (el: HTMLElement | null) => {
+    triggerRef.current = el;
+  };
+
+  useEffect(() => {
+    return () => {
+      // Return focus on unmount
+      triggerRef.current?.focus();
+    };
+  }, []);
+
+  return saveTrigger;
+}

package/app/lib/i18n/modules/knowledge.ts

@@ -110,8 +110,8 @@ export const knowledgeEn = {
     dropOverlay: 'Drop to save to Capture',
     dropOverlayFormats: 'md · txt · pdf · csv · json',
     noMindRoot: 'Please configure your knowledge base first',
-    saveFailed: 'Failed to save files',
-    organizeFailed: 'Could not read files for organizing',
+    saveFailed: 'Failed to save files. Check disk space and permissions.',
+    organizeFailed: 'Could not read files for organizing. Check file permissions.',
   },
   pulse: {
     title: 'Your Agents',
@@ -162,7 +162,8 @@ export const knowledgeEn = {
     title: 'Pinned Files',
     addedToast: 'Added to Favorites',
     removedToast: 'Removed from Favorites',
-    empty: 'Pin files for quick access',
+    empty: 'No pinned files',
+    emptyHint: 'Click the star icon on any file to pin it here',
   },
   trash: {
     title: 'Trash',
@@ -182,6 +183,9 @@ export const knowledgeEn = {
     movedToTrash: 'Deleted',
     undo: 'Undo',
     undoFailed: 'Undo failed',
+    restoreFailed: 'Could not restore file. Check disk space and try again.',
+    deleteFailed: 'Could not permanently delete. Please try again.',
+    emptyFailed: 'Could not empty trash. Please try again.',
     emptied: (count: number) => `Emptied ${count} item${count !== 1 ? 's' : ''} from Trash`,
     restoreConflict: 'A file with this name already exists at the original location.',
     overwrite: 'Overwrite',
@@ -218,7 +222,7 @@ export const knowledgeEn = {
     downloadAgain: 'Download Again',
     fileCount: (n: number) => `${n} file${n !== 1 ? 's' : ''}`,
     downloaded: 'Downloaded',
-    error: 'Export failed',
+    error: 'Export failed. Please check disk space and try again.',
     retry: 'Retry',
   },
   fileImport: {
@@ -469,8 +473,8 @@ export const knowledgeZh = {
     dropOverlay: '拖放到暂存台快速保存',
     dropOverlayFormats: 'md · txt · pdf · csv · json',
     noMindRoot: '请先配置知识库路径',
-    saveFailed: '保存文件失败',
-    organizeFailed: '无法读取文件进行整理',
+    saveFailed: '保存文件失败，请检查磁盘空间和权限。',
+    organizeFailed: '无法读取文件进行整理，请检查文件权限。',
   },
   pulse: {
     title: '你的 Agent',
@@ -521,7 +525,8 @@ export const knowledgeZh = {
     title: '收藏文件',
     addedToast: '已添加到收藏',
     removedToast: '已取消收藏',
-    empty: '固定文件以快速访问',
+    empty: '还没有收藏文件',
+    emptyHint: '点击任何文件上的星标图标即可收藏',
   },
   trash: {
     title: '回收站',
@@ -541,6 +546,9 @@ export const knowledgeZh = {
     movedToTrash: '已删除',
     undo: '撤销',
     undoFailed: '撤销失败',
+    restoreFailed: '无法恢复文件，请检查磁盘空间后重试。',
+    deleteFailed: '无法彻底删除，请重试。',
+    emptyFailed: '无法清空回收站，请重试。',
     emptied: (count: number) => `已清空 ${count} 个项目`,
     restoreConflict: '原位置已有同名文件。',
     overwrite: '覆盖',
@@ -577,7 +585,7 @@ export const knowledgeZh = {
     downloadAgain: '再次下载',
     fileCount: (n: number) => `${n} 个文件`,
     downloaded: '已下载',
-    error: '导出失败',
+    error: '导出失败，请检查磁盘空间后重试。',
     retry: '重试',
   },
   fileImport: {

package/app/lib/i18n/modules/onboarding.ts

@@ -11,7 +11,7 @@ export const onboardingEn = {
     importHint: 'Already have notes? Set MIND_ROOT to your existing directory in Settings.',
     syncHint: 'Want cross-device sync? Run',
     syncHintSuffix: 'in the terminal after setup.',
-    initError: 'Initialization failed. Please try again.',
+    initError: 'Initialization failed. Please refresh the page or try a different template.',
     dismiss: 'Dismiss',
   },
   setup: {
@@ -233,7 +233,7 @@ export const onboardingZh = {
     importHint: '已有笔记？在设置中将 MIND_ROOT 指向已有目录即可。',
     syncHint: '需要跨设备同步？完成初始化后在终端运行',
     syncHintSuffix: '即可。',
-    initError: '初始化失败，请重试。',
+    initError: '初始化失败。请刷新页面或尝试其他模板。',
     dismiss: '关闭',
   },
   setup: {

package/app/lib/i18n/modules/settings.ts

@@ -12,6 +12,8 @@ export const settingsEn = {
       baseUrlHint: 'Optional. Use for proxies or custom API endpoints.',
       keyHint: 'Stored locally in ~/.mindos/config.json',
       keyOptionalHint: 'Optional for local providers. Stored in ~/.mindos/config.json',
+      keyChange: 'Change',
+      keyCancel: 'Cancel',
       envHint: 'Fields marked env have a value from environment variables. You can override them here, or restore all to env defaults.',
       envFieldNote: (key: string) => `Env var ${key} is set. Clear this field to fall back to it.`,
       resetToEnv: 'Reset to env value',
@@ -458,6 +460,8 @@ export const settingsZh = {
       envFieldNote: (key: string) => `环境变量 ${key} 已设置。清空此字段将回退到环境变量值。`,
       resetToEnv: '恢复为环境变量',
       restoreFromEnv: '从环境变量恢复',
+      keyChange: '更改',
+      keyCancel: '取消',
       noApiKey: 'API 密钥未设置，AI 功能暂不可用，请在此填写。',
       testKey: '测试',
       testKeyTesting: '测试中...',

package/bin/commands/dev.js

@@ -36,6 +36,16 @@ export const run = async (args, flags) => {
   if (!process.env.MINDOS_MCP_PORT) process.env.MINDOS_MCP_PORT = '8781';
   process.env.MINDOS_CLI_PATH = resolve(ROOT, 'bin', 'cli.js');
   process.env.MINDOS_NODE_BIN = process.execPath;
+
+  // Inject ~/.mindos/bin into PATH so dev server child processes can find `mindos` CLI
+  const { homedir } = await import('node:os');
+  const mindosBinDir = resolve(homedir(), '.mindos', 'bin');
+  const pathSep = process.platform === 'win32' ? ';' : ':';
+  const pathDirs = (process.env.PATH || '').split(pathSep);
+  if (!pathDirs.includes(mindosBinDir)) {
+    process.env.PATH = `${mindosBinDir}${pathSep}${process.env.PATH || ''}`;
+  }
+
   const webPort = process.env.MINDOS_WEB_PORT;
   const mcpPort = process.env.MINDOS_MCP_PORT;
   await assertPortFree(Number(webPort), 'web');

package/bin/commands/doctor.js

@@ -105,16 +105,28 @@ export const run = async (_args, flags) => {
     hasError = true;
   }
 
-  // 4c. ~/.mindos/bin in PATH (Desktop CLI shim)
+  // 4c. ~/.mindos/bin in PATH (CLI shim)
   const mindosBin = resolve(homedir(), '.mindos', 'bin');
   const pathDirs = (process.env.PATH || '').split(':');
   if (pathDirs.some(d => d === mindosBin || d === '$HOME/.mindos/bin' || d === '~/.mindos/bin')) {
     ok(`~/.mindos/bin is in PATH`);
-  } else if (existsSync(resolve(mindosBin, 'mindos'))) {
-    warn(`~/.mindos/bin/mindos exists but is NOT in PATH — AI Agents cannot find the mindos command`);
-    if (!jsonMode) {
-      console.log(dim('     Fix: Relaunch MindOS Desktop, or add to your shell config:'));
-      console.log(dim('       export PATH="$HOME/.mindos/bin:$PATH"'));
+  } else {
+    try {
+      const { ensureCliShim, isShimInPath } = await import('../lib/cli-shim.js');
+      ensureCliShim();
+      if (isShimInPath()) {
+        ok(`~/.mindos/bin is in PATH`);
+      } else {
+        warn(`~/.mindos/bin PATH injected into shell rc files — open a new terminal to activate`);
+      }
+    } catch {
+      if (existsSync(resolve(mindosBin, 'mindos'))) {
+        warn(`~/.mindos/bin/mindos exists but is NOT in PATH — AI Agents cannot find the mindos command`);
+        if (!jsonMode) {
+          console.log(dim('     Fix: add to your shell config:'));
+          console.log(dim('       export PATH="$HOME/.mindos/bin:$PATH"'));
+        }
+      }
     }
   }
 

package/bin/commands/start.js

@@ -63,14 +63,23 @@ export const run = async (args, flags) => {
   const isVerbose = Boolean(flags.verbose);
   const extra = args.join(' ');
 
-  // Ensure `mindos` CLI is in PATH (silent, best-effort, dev installs only)
-  try {
-    execSync('command -v mindos', { stdio: 'ignore' });
-  } catch {
-    const isDesktop = !!(process.env.ELECTRON_RUN_AS_NODE || process.env.MINDOS_DESKTOP);
-    if (!isDesktop && existsSync(resolve(ROOT, '.git'))) {
-      try { execSync('npm link', { cwd: ROOT, stdio: 'ignore' }); } catch { /* best effort */ }
-    }
+  // Ensure `mindos` CLI shim + PATH injection (silent, best-effort)
+  const isDesktop = !!(process.env.ELECTRON_RUN_AS_NODE || process.env.MINDOS_DESKTOP);
+  if (!isDesktop) {
+    try {
+      const { ensureCliShim } = await import('../lib/cli-shim.js');
+      ensureCliShim();
+    } catch { /* best effort */ }
+  }
+
+  // Inject ~/.mindos/bin into current process PATH so child processes
+  // (Next.js server, MCP) can find the `mindos` command.
+  const { homedir } = await import('node:os');
+  const mindosBinDir = resolve(homedir(), '.mindos', 'bin');
+  const pathSep = process.platform === 'win32' ? ';' : ':';
+  const pathDirs = (process.env.PATH || '').split(pathSep);
+  if (!pathDirs.includes(mindosBinDir)) {
+    process.env.PATH = `${mindosBinDir}${pathSep}${process.env.PATH || ''}`;
   }
 
   // Check for incomplete setup