@geminilight/mindos 0.6.23 → 0.7.0

package/README.md

@@ -240,7 +240,7 @@ MindOS/
 ├── mcp/              # MCP Server — HTTP adapter that maps tools to App API
 ├── skills/           # MindOS Skills (`mindos`, `mindos-zh`) — Workflow guides for Agents
 ├── templates/        # Preset templates (`en/`, `zh/`, `empty/`) — copied to knowledge base on onboard
-├── bin/              # CLI entry point (`mindos onboard`, `mindos start`, `mindos open`, `mindos sync`, `mindos token`)
+├── bin/              # CLI (`mindos start`, `mindos file`, `mindos ask`, `mindos agent`, ... 22 commands)
 ├── scripts/          # Setup wizard and helper scripts
 └── README.md
 
@@ -256,14 +256,30 @@ MindOS/
 
 | Command | Description |
 | :--- | :--- |
+| **Core** | |
 | `mindos onboard` | Interactive setup (config, template, start mode) |
 | `mindos start` | Start app + MCP server (foreground) |
 | `mindos start --daemon` | Start as background OS service |
+| `mindos stop` / `restart` | Stop or restart running processes |
+| `mindos dev` | Start in dev mode |
+| `mindos build` | Build for production |
+| `mindos status` | Show service status overview |
 | `mindos open` | Open Web UI in browser |
+| **Knowledge** | |
+| `mindos file <sub>` | File operations (list, read, create, delete, search) |
+| `mindos space <sub>` | Space management (list, create, info) |
+| `mindos search "<query>"` | Search knowledge base |
+| `mindos ask "<question>"` | Ask AI using your knowledge base |
+| `mindos agent <sub>` | AI Agent management (list, info) |
+| `mindos api <METHOD> <path>` | Raw API passthrough for developers/agents |
+| **MCP & Config** | |
 | `mindos mcp install` | Auto-install MCP config into your Agent |
-| `mindos sync init` | Setup Git remote sync |
-| `mindos update` | Update to latest version |
+| `mindos token` | Show auth token and MCP config |
+| `mindos config <sub>` | View/update config (show, set, validate) |
+| `mindos sync` | Show sync status (init, now, conflicts, on/off) |
+| `mindos gateway <sub>` | Manage background service (install, start, stop) |
 | `mindos doctor` | Health check |
+| `mindos update` | Update to latest version |
 
 **Keyboard shortcuts:** `⌘K` Search · `⌘/` AI Assistant · `E` Edit · `⌘S` Save · `Esc` Close
 

package/README_zh.md

@@ -240,7 +240,7 @@ MindOS/
 ├── mcp/              # MCP Server — 将工具映射到 App API 的 HTTP 适配器
 ├── skills/           # MindOS Skills（`mindos`、`mindos-zh`）— Agent 工作流指南
 ├── templates/        # 预设模板（`en/`、`zh/`、`empty/`）— onboard 时复制到知识库目录
-├── bin/              # CLI 入口（`mindos onboard`、`mindos start`、`mindos open`、`mindos sync`、`mindos token`）
+├── bin/              # CLI（`mindos start`、`mindos file`、`mindos ask`、`mindos agent` 等 22 个命令）
 ├── scripts/          # 配置向导与辅助脚本
 └── README.md
 
@@ -256,14 +256,30 @@ MindOS/
 
 | 命令 | 说明 |
 | :--- | :--- |
+| **核心** | |
 | `mindos onboard` | 交互式初始化（生成配置、选择模板） |
 | `mindos start` | 前台启动 app + MCP 服务 |
 | `mindos start --daemon` | 以后台 OS 服务方式启动 |
+| `mindos stop` / `restart` | 停止或重启服务 |
+| `mindos dev` | 开发模式启动 |
+| `mindos build` | 构建生产版本 |
+| `mindos status` | 查看服务状态概览 |
 | `mindos open` | 在浏览器中打开 Web UI |
+| **知识库** | |
+| `mindos file <sub>` | 文件操作（list, read, create, delete, search） |
+| `mindos space <sub>` | 空间管理（list, create, info） |
+| `mindos search "<query>"` | 搜索知识库 |
+| `mindos ask "<question>"` | 基于知识库向 AI 提问 |
+| `mindos agent <sub>` | AI Agent 管理（list, info） |
+| `mindos api <METHOD> <path>` | API 透传（开发者/Agent 用） |
+| **MCP 与配置** | |
 | `mindos mcp install` | 自动将 MCP 配置写入 Agent |
-| `mindos sync init` | 配置 Git 远程同步 |
-| `mindos update` | 更新到最新版本 |
+| `mindos token` | 查看认证令牌和 MCP 配置 |
+| `mindos config <sub>` | 查看/修改配置（show, set, validate） |
+| `mindos sync` | 同步状态（init, now, conflicts, on/off） |
+| `mindos gateway <sub>` | 管理后台服务（install, start, stop） |
 | `mindos doctor` | 健康检查 |
+| `mindos update` | 更新到最新版本 |
 
 **快捷键：** `⌘K` 搜索 · `⌘/` AI 助手 · `E` 编辑 · `⌘S` 保存 · `Esc` 关闭
 

package/app/app/.well-known/agent-card.json/route.ts

@@ -0,0 +1,34 @@
+export const dynamic = 'force-dynamic';
+
+import { NextRequest, NextResponse } from 'next/server';
+import { buildAgentCard } from '@/lib/a2a/agent-card';
+
+const CORS_HEADERS: Record<string, string> = {
+  'Access-Control-Allow-Origin': '*',
+  'Access-Control-Allow-Methods': 'GET, OPTIONS',
+  'Access-Control-Allow-Headers': 'Content-Type, Authorization',
+  'Cache-Control': 'public, max-age=300',
+};
+
+export async function GET(req: NextRequest) {
+  // Prefer explicit config; fall back to request headers
+  const configuredUrl = process.env.MINDOS_BASE_URL;
+  let baseUrl: string;
+  if (configuredUrl) {
+    baseUrl = configuredUrl.replace(/\/+$/, '');
+  } else {
+    const proto = req.headers.get('x-forwarded-proto') ?? 'http';
+    const host = req.headers.get('host') ?? `localhost:${process.env.PORT || 3456}`;
+    baseUrl = `${proto}://${host}`;
+  }
+
+  const card = buildAgentCard(baseUrl);
+
+  const res = NextResponse.json(card);
+  for (const [k, v] of Object.entries(CORS_HEADERS)) res.headers.set(k, v);
+  return res;
+}
+
+export async function OPTIONS() {
+  return new Response(null, { status: 204, headers: CORS_HEADERS });
+}

package/app/app/api/a2a/discover/route.ts

@@ -0,0 +1,23 @@
+import { NextResponse } from 'next/server';
+import { discoverAgent } from '@/lib/a2a/client';
+
+export async function POST(req: Request) {
+  try {
+    const { url } = await req.json();
+    if (!url || typeof url !== 'string') {
+      return NextResponse.json({ error: 'URL is required' }, { status: 400 });
+    }
+
+    const agent = await discoverAgent(url);
+    if (!agent) {
+      return NextResponse.json({ error: 'No A2A agent found', agent: null });
+    }
+
+    return NextResponse.json({ agent });
+  } catch (err) {
+    return NextResponse.json(
+      { error: (err as Error).message, agent: null },
+      { status: 500 },
+    );
+  }
+}

package/app/app/api/a2a/route.ts

@@ -0,0 +1,100 @@
+export const dynamic = 'force-dynamic';
+
+import { NextRequest, NextResponse } from 'next/server';
+import type { JsonRpcRequest, JsonRpcResponse, SendMessageParams, GetTaskParams, CancelTaskParams } from '@/lib/a2a/types';
+import { A2A_ERRORS } from '@/lib/a2a/types';
+import { handleSendMessage, handleGetTask, handleCancelTask } from '@/lib/a2a/task-handler';
+
+const CORS_HEADERS: Record<string, string> = {
+  'Access-Control-Allow-Origin': '*',
+  'Access-Control-Allow-Methods': 'POST, OPTIONS',
+  'Access-Control-Allow-Headers': 'Content-Type, Authorization, A2A-Version',
+};
+
+function jsonRpcOk(id: string | number | null, result: unknown): JsonRpcResponse {
+  return { jsonrpc: '2.0', id, result };
+}
+
+function jsonRpcError(id: string | number | null, error: { code: number; message: string; data?: unknown }): JsonRpcResponse {
+  return { jsonrpc: '2.0', id, error };
+}
+
+function respond(body: JsonRpcResponse, status = 200) {
+  const res = NextResponse.json(body, { status });
+  for (const [k, v] of Object.entries(CORS_HEADERS)) res.headers.set(k, v);
+  return res;
+}
+
+const MAX_REQUEST_BYTES = 100_000; // 100KB max request body
+
+export async function POST(req: NextRequest) {
+  // Check content length to prevent OOM from oversized payloads
+  const contentLength = Number(req.headers.get('content-length') || 0);
+  if (contentLength > MAX_REQUEST_BYTES) {
+    return respond(jsonRpcError(null, { code: -32600, message: `Request too large (max ${MAX_REQUEST_BYTES} bytes)` }), 413);
+  }
+
+  // Parse JSON-RPC request
+  let rpc: JsonRpcRequest;
+  try {
+    rpc = await req.json();
+  } catch {
+    return respond(jsonRpcError(null, A2A_ERRORS.PARSE_ERROR), 400);
+  }
+
+  if (rpc.jsonrpc !== '2.0' || typeof rpc.method !== 'string') {
+    return respond(jsonRpcError(rpc.id ?? null, A2A_ERRORS.INVALID_REQUEST), 400);
+  }
+
+  try {
+    switch (rpc.method) {
+      case 'SendMessage': {
+        const params = rpc.params as unknown as SendMessageParams;
+        if (!params?.message?.parts?.length) {
+          return respond(jsonRpcError(rpc.id, A2A_ERRORS.INVALID_PARAMS));
+        }
+        const task = await handleSendMessage(params);
+        return respond(jsonRpcOk(rpc.id, task));
+      }
+
+      case 'GetTask': {
+        const params = rpc.params as unknown as GetTaskParams;
+        if (!params?.id) {
+          return respond(jsonRpcError(rpc.id, A2A_ERRORS.INVALID_PARAMS));
+        }
+        const task = handleGetTask(params);
+        if (!task) {
+          return respond(jsonRpcError(rpc.id, A2A_ERRORS.TASK_NOT_FOUND));
+        }
+        return respond(jsonRpcOk(rpc.id, task));
+      }
+
+      case 'CancelTask': {
+        const params = rpc.params as unknown as CancelTaskParams;
+        if (!params?.id) {
+          return respond(jsonRpcError(rpc.id, A2A_ERRORS.INVALID_PARAMS));
+        }
+        const task = handleCancelTask(params);
+        if (!task) {
+          return respond(jsonRpcError(rpc.id, {
+            ...A2A_ERRORS.TASK_NOT_FOUND,
+            message: 'Task not found or not cancelable',
+          }));
+        }
+        return respond(jsonRpcOk(rpc.id, task));
+      }
+
+      default:
+        return respond(jsonRpcError(rpc.id, A2A_ERRORS.METHOD_NOT_FOUND));
+    }
+  } catch (err) {
+    return respond(jsonRpcError(rpc.id, {
+      ...A2A_ERRORS.INTERNAL_ERROR,
+      data: (err as Error).message,
+    }), 500);
+  }
+}
+
+export async function OPTIONS() {
+  return new Response(null, { status: 204, headers: CORS_HEADERS });
+}

package/app/components/Backlinks.tsx

@@ -58,10 +58,10 @@ export default function Backlinks({ filePath }: { filePath: string }) {
                   <FileText size={14} className="text-muted-foreground group-hover:text-[var(--amber)]" />
                 </div>
                 <div className="min-w-0 flex-1">
-                  <div className="font-medium text-sm text-foreground group-hover:text-[var(--amber)] transition-colors truncate mb-1">
+                  <div className="font-medium text-sm text-foreground group-hover:text-[var(--amber)] transition-colors truncate mb-1" title={link.filePath}>
                     {link.filePath}
                   </div>
-                  <div className="text-xs text-muted-foreground line-clamp-2 leading-relaxed italic opacity-80 group-hover:opacity-100 transition-opacity">
+                  <div className="text-xs text-muted-foreground line-clamp-2 leading-relaxed italic opacity-80 group-hover:opacity-100 transition-opacity" title={link.snippets[0] || ''}>
                     {link.snippets[0] || ''}
                   </div>
                 </div>

package/app/components/Breadcrumb.tsx

@@ -29,7 +29,7 @@ export default function Breadcrumb({ filePath }: { filePath: string }) {
                 <span suppressHydrationWarning>{part}</span>
               </span>
             ) : (
-              <Link href={href} className="px-2 py-0.5 rounded-md hover:bg-muted/50 transition-colors truncate max-w-[200px]">
+              <Link href={href} className="px-2 py-0.5 rounded-md hover:bg-muted/50 transition-colors truncate max-w-[200px]" title={part}>
                 <span suppressHydrationWarning>{part}</span>
               </Link>
             )}

package/app/components/CreateSpaceModal.tsx

@@ -224,6 +224,7 @@ export default function CreateSpaceModal({ t, dirPaths }: { t: ReturnType<typeof
               role="switch"
               aria-checked={useAi}
               disabled={!aiAvailable}
+              title={!aiAvailable ? t.hints.configureAiKey : undefined}
               onClick={() => setUseAi(v => !v)}
               className={`relative mt-0.5 inline-flex shrink-0 h-4 w-7 cursor-pointer rounded-full border-2 border-transparent transition-colors focus-visible:ring-2 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50 ${
                 useAi ? 'bg-[var(--amber)]' : 'bg-muted'

package/app/components/CsvView.tsx

@@ -2,7 +2,7 @@
 
 import { useMemo, useState, useRef, useCallback, useEffect } from 'react';
 import Papa from 'papaparse';
-import { ChevronUp, ChevronDown, ChevronsUpDown, Plus, Trash2 } from 'lucide-react';
+import { ChevronUp, ChevronDown, ChevronsUpDown, Plus, Trash2, Loader2 } from 'lucide-react';
 
 interface CsvViewProps {
   content: string;
@@ -135,6 +135,7 @@ export default function CsvView({ content: initialContent, appendAction, saveAct
   const [sortCol, setSortCol] = useState<number | null>(null);
   const [sortDir, setSortDir] = useState<SortDir>(null);
   const [showAdd, setShowAdd] = useState(false);
+  const [saving, setSaving] = useState(false);
 
   const parsed = useMemo(() => {
     const result = Papa.parse<string[]>(content, { skipEmptyLines: true });
@@ -163,38 +164,57 @@ export default function CsvView({ content: initialContent, appendAction, saveAct
   // Update a single cell and persist
   const handleCellCommit = useCallback(async (rowIdx: number, colIdx: number, newVal: string) => {
     if (!saveAction) return;
-    // rowIdx here is index into sortedRows — need to map back to original rows
-    const updatedRows = rows.map((r, i) => {
-      // find which original row matches this sorted row
+    const updatedRows = rows.map((r) => {
       const sorted = sortedRows[rowIdx];
       if (r === sorted) return r.map((cell, ci) => ci === colIdx ? newVal : cell);
       return r;
     });
     const newContent = serializeRows(headers, updatedRows);
     setContent(newContent);
-    await saveAction(newContent);
+    setSaving(true);
+    try {
+      await saveAction(newContent);
+    } catch (err) {
+      console.error('[CsvView] Cell save failed:', err);
+    } finally {
+      setSaving(false);
+    }
   }, [saveAction, rows, sortedRows, headers]);
 
   // Delete a row and persist
   const handleDeleteRow = useCallback(async (rowIdx: number) => {
-    if (!saveAction) return;
+    if (!saveAction || saving) return;
     const sorted = sortedRows[rowIdx];
     const updatedRows = rows.filter(r => r !== sorted);
     const newContent = serializeRows(headers, updatedRows);
     setContent(newContent);
-    await saveAction(newContent);
-  }, [saveAction, rows, sortedRows, headers]);
+    setSaving(true);
+    try {
+      await saveAction(newContent);
+    } catch (err) {
+      console.error('[CsvView] Row delete failed:', err);
+    } finally {
+      setSaving(false);
+    }
+  }, [saveAction, rows, sortedRows, headers, saving]);
 
   // Append a new row
   const handleAddRow = useCallback(async (newRow: string[]) => {
-    setShowAdd(false);
-    if (appendAction) {
-      const result = await appendAction(newRow);
-      setContent(result.newContent);
-    } else if (saveAction) {
-      const newContent = serializeRows(headers, [...rows, newRow]);
-      setContent(newContent);
-      await saveAction(newContent);
+    setSaving(true);
+    try {
+      if (appendAction) {
+        const result = await appendAction(newRow);
+        setContent(result.newContent);
+      } else if (saveAction) {
+        const newContent = serializeRows(headers, [...rows, newRow]);
+        setContent(newContent);
+        await saveAction(newContent);
+      }
+      setShowAdd(false);
+    } catch (err) {
+      console.error('[CsvView] Add row failed:', err);
+    } finally {
+      setSaving(false);
     }
   }, [appendAction, saveAction, headers, rows]);
 
@@ -266,9 +286,10 @@ export default function CsvView({ content: initialContent, appendAction, saveAct
                     {saveAction && (
                       <button
                         onClick={() => handleDeleteRow(rowIdx)}
-                        className="opacity-0 group-hover:opacity-100 transition-opacity p-1 rounded hover:bg-destructive/10"
+                        disabled={saving}
+                        className="opacity-0 group-hover:opacity-100 transition-opacity p-1 rounded hover:bg-destructive/10 disabled:opacity-30"
                         style={{ color: 'var(--muted-foreground)' }}
-                        title="Delete row"
+                        title={saving ? 'Saving...' : 'Delete row'}
                       >
                         <Trash2 size={12} />
                       </button>
@@ -295,8 +316,9 @@ export default function CsvView({ content: initialContent, appendAction, saveAct
         className="px-4 py-2 flex items-center justify-between"
         style={{ background: 'var(--muted)', borderTop: '1px solid var(--border)' }}
       >
-        <span className="text-xs font-display" style={{ color: 'var(--muted-foreground)' }}>
+        <span className="text-xs font-display flex items-center gap-1.5" style={{ color: 'var(--muted-foreground)' }}>
           {rows.length} rows · {headers.length} cols
+          {saving && <Loader2 size={10} className="animate-spin" style={{ color: 'var(--amber)' }} />}
         </span>
 
         {canEdit && !showAdd && (

package/app/components/DirView.tsx

@@ -207,7 +207,7 @@ export default function DirView({ dirPath, entries, spacePreview }: DirViewProps
                   {entry.type === 'directory'
                     ? <FolderOpen size={22} className="text-yellow-400" />
                     : <FileIconLarge node={entry} />}
-                  <span className="text-xs text-foreground leading-snug line-clamp-2 w-full" suppressHydrationWarning>
+                  <span className="text-xs text-foreground leading-snug line-clamp-2 w-full" title={entry.name} suppressHydrationWarning>
                     {entry.name}
                   </span>
                   {entry.type === 'directory' && (
@@ -230,7 +230,7 @@ export default function DirView({ dirPath, entries, spacePreview }: DirViewProps
                   className="flex items-center gap-3 px-4 py-3 bg-card hover:bg-accent transition-colors duration-100"
                 >
                   <FileIcon node={entry} />
-                  <span className="flex-1 text-sm text-foreground truncate" suppressHydrationWarning>
+                  <span className="flex-1 text-sm text-foreground truncate" title={entry.name} suppressHydrationWarning>
                     {entry.name}
                   </span>
                   {entry.type === 'directory' ? (

package/app/components/GuideCard.tsx

@@ -29,7 +29,9 @@ export default function GuideCard() {
           setGuideState(null);
         }
       })
-      .catch(() => {});
+      .catch((err) => {
+        console.warn('[GuideCard] Fetch guide state failed:', err);
+      });
   }, []);
 
   useEffect(() => {
@@ -54,7 +56,9 @@ export default function GuideCard() {
       method: 'PATCH',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({ guideState: patch }),
-    }).catch(() => {});
+    }).catch((err) => {
+      console.warn('[GuideCard] PATCH guide state failed:', err);
+    });
   }, []);
 
   const handleDismiss = useCallback(() => {

package/app/components/HomeContent.tsx

@@ -618,7 +618,7 @@ function ExampleCleanupBanner() {
   useEffect(() => {
     scanExampleFilesAction().then(r => {
       if (r.files.length > 0) setCount(r.files.length);
-    }).catch(() => {});
+    }).catch((err) => { console.warn("[HomeContent] scanExampleFilesAction failed:", err); });
   }, []);
 
   const handleCleanup = useCallback(async () => {

package/app/components/ImportModal.tsx

@@ -387,6 +387,7 @@ export default function ImportModal({ open, onClose, defaultSpace, initialFiles,
                   onClick={() => handleIntentSelect('archive')}
                   className="flex flex-col items-center gap-2 p-4 border rounded-lg cursor-pointer transition-all duration-150 border-[var(--amber)]/30 bg-card hover:border-[var(--amber)]/60 hover:shadow-sm active:scale-[0.98] text-left"
                   disabled={im.validFiles.length === 0}
+                  title={im.validFiles.length === 0 ? t.hints.noValidFiles : undefined}
                 >
                   <FolderInput size={24} className="text-[var(--amber)]" />
                   <span className="text-sm font-medium text-foreground">{t.fileImport.archiveTitle}</span>
@@ -396,6 +397,7 @@ export default function ImportModal({ open, onClose, defaultSpace, initialFiles,
                   onClick={() => handleIntentSelect('digest')}
                   className="flex flex-col items-center gap-2 p-4 border border-border rounded-lg cursor-pointer transition-all duration-150 bg-card hover:border-[var(--amber)]/50 hover:shadow-sm active:scale-[0.98] text-left"
                   disabled={im.validFiles.length === 0 || aiOrganize.phase === 'organizing'}
+                  title={im.validFiles.length === 0 ? t.hints.noValidFiles : aiOrganize.phase === 'organizing' ? t.hints.aiOrganizing : undefined}
                 >
                   <Sparkles size={24} className="text-[var(--amber)]" />
                   <span className="text-sm font-medium text-foreground">{t.fileImport.digestTitle}</span>
@@ -482,6 +484,7 @@ export default function ImportModal({ open, onClose, defaultSpace, initialFiles,
                   <button
                     onClick={handleArchiveSubmit}
                     disabled={isImporting || im.validFiles.length === 0}
+                    title={isImporting ? t.hints.importInProgress : im.validFiles.length === 0 ? t.hints.noValidFiles : undefined}
                     className={`flex items-center gap-2 px-4 py-2 rounded-lg text-sm font-medium transition-all duration-200 ${
                       showSuccess
                         ? 'bg-success text-success-foreground'

package/app/components/OnboardingView.tsx

@@ -99,6 +99,7 @@ export default function OnboardingView() {
             <button
               key={tpl.id}
               disabled={isDisabled}
+              title={isDisabled ? t.hints.templateInitializing : undefined}
               onClick={() => handleSelect(tpl.id)}
               className="group relative flex flex-col items-start gap-3 p-5 rounded-xl border border-border bg-card text-left transition-all duration-150 hover:border-[var(--amber)]/50 hover:bg-[var(--amber)]/5 disabled:opacity-60 disabled:cursor-not-allowed"
             >

package/app/components/RightAskPanel.tsx

@@ -23,12 +23,14 @@ interface RightAskPanelProps {
   onModeSwitch?: () => void;
   maximized?: boolean;
   onMaximize?: () => void;
+  /** Left offset (px) to avoid covering Rail + Sidebar when maximized */
+  sidebarOffset?: number;
 }
 
 export default function RightAskPanel({
   open, onClose, currentFile, initialMessage, onFirstMessage,
   width, onWidthChange, onWidthCommit, askMode, onModeSwitch,
-  maximized = false, onMaximize,
+  maximized = false, onMaximize, sidebarOffset = 0,
 }: RightAskPanelProps) {
   const handleMouseDown = useResizeDrag({
     width,
@@ -49,7 +51,7 @@ export default function RightAskPanel({
         ${open ? 'translate-x-0' : 'translate-x-full pointer-events-none'}
         ${maximized ? 'border-l-0' : ''}
       `}
-      style={{ width: maximized ? '100vw' : `${width}px` }}
+      style={maximized ? { left: `${sidebarOffset}px` } : { width: `${width}px` }}
       role="complementary"
       aria-label="MindOS Agent panel"
     >

package/app/components/SearchModal.tsx

@@ -171,13 +171,13 @@ export default function SearchModal({ open, onClose }: SearchModalProps) {
                 }
                 <div className="min-w-0 flex-1">
                   <div className="flex items-baseline gap-2 flex-wrap">
-                    <span className="text-sm text-foreground font-medium truncate">{fileName}</span>
+                    <span className="text-sm text-foreground font-medium truncate" title={fileName}>{fileName}</span>
                     {dirPath && (
-                      <span className="text-xs text-muted-foreground truncate">{dirPath}</span>
+                      <span className="text-xs text-muted-foreground truncate" title={dirPath}>{dirPath}</span>
                     )}
                   </div>
                   {result.snippet && (
-                    <p className="text-xs text-muted-foreground mt-0.5 line-clamp-2 leading-relaxed">
+                    <p className="text-xs text-muted-foreground mt-0.5 line-clamp-2 leading-relaxed" title={result.snippet}>
                       {highlightSnippet(result.snippet, query)}
                     </p>
                   )}

package/app/components/SidebarLayout.tsx

@@ -150,6 +150,14 @@ export default function SidebarLayout({ fileTree, children }: SidebarLayoutProps
   const currentFile = pathname.startsWith('/view/')
     ? pathname.slice('/view/'.length).split('/').map(decodeURIComponent).join('/')
     : undefined;
+
+  // Auto-exit Ask panel maximize when navigating to a different page
+  useEffect(() => {
+    if (ap.askMaximized) ap.toggleAskMaximized();
+  // Only react to pathname changes, not askMaximized changes
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [pathname]);
+
   const agentsContentActive = pathname?.startsWith('/agents');
   const railActivePanel = lp.activePanel ?? (agentsContentActive ? 'agents' : null);
 
@@ -415,6 +423,7 @@ export default function SidebarLayout({ fileTree, children }: SidebarLayoutProps
         onModeSwitch={ap.handleAskModeSwitch}
         maximized={ap.askMaximized}
         onMaximize={ap.toggleAskMaximized}
+        sidebarOffset={lp.panelOpen ? lp.railWidth + lp.effectivePanelWidth : lp.railWidth}
       />
 
       <RightAgentDetailPanel
@@ -495,7 +504,7 @@ export default function SidebarLayout({ fileTree, children }: SidebarLayoutProps
 
       <main
         id="main-content"
-        className={`min-h-screen transition-all duration-200 pt-[52px] md:pt-0 ${ap.askMaximized ? 'hidden' : ''}`}
+        className={`min-h-screen transition-all duration-200 pt-[52px] md:pt-0`}
         onDragEnter={(e) => {
           if (!e.dataTransfer.types.includes('Files')) return;
           e.preventDefault();
@@ -562,7 +571,7 @@ export default function SidebarLayout({ fileTree, children }: SidebarLayoutProps
       <style>{`
         @media (min-width: 768px) {
           :root {
-            --right-panel-width: ${ap.askMaximized ? '100vw' : `${ap.askPanelOpen ? ap.askPanelWidth : 0}px`};
+            --right-panel-width: ${ap.askMaximized ? `calc(100vw - ${lp.panelOpen ? lp.railWidth + lp.effectivePanelWidth : lp.railWidth}px)` : `${ap.askPanelOpen ? ap.askPanelWidth : 0}px`};
             --right-agent-detail-width: ${agentDockOpen ? agentDetailWidth : 0}px;
           }
           #main-content {

package/app/components/SyncStatusBar.tsx

@@ -168,7 +168,7 @@ export default function SyncStatusBar({ collapsed, onOpenSyncSettings }: SyncSta
   const prevLevelRef = useRef<StatusLevel>('off');
   const [hintDismissed, setHintDismissed] = useState(() => {
     if (typeof window !== 'undefined') {
-      try { return !!localStorage.getItem('sync-hint-dismissed'); } catch {}
+      try { return !!localStorage.getItem('sync-hint-dismissed'); } catch (err) { console.warn("[SyncStatusBar] localStorage read failed:", err); }
     }
     return false;
   });
@@ -219,7 +219,7 @@ export default function SyncStatusBar({ collapsed, onOpenSyncSettings }: SyncSta
         <button
           onClick={(e) => {
             e.stopPropagation();
-            try { localStorage.setItem('sync-hint-dismissed', '1'); } catch {}
+            try { localStorage.setItem('sync-hint-dismissed', '1'); } catch (err) { console.warn("[SyncStatusBar] localStorage write dismissed:", err); }
             setHintDismissed(true);
           }}
           className="p-1 rounded hover:bg-muted hover:text-foreground transition-colors shrink-0 ml-2 text-muted-foreground/50 hover:text-muted-foreground"