@geminilight/mindos 0.2.0 → 0.2.1

package/app/lib/agent/tools.ts

@@ -5,6 +5,7 @@ import {
   saveFileContent, createFile, appendToFile, insertAfterHeading, updateSection,
 } from '@/lib/fs';
 import { assertNotProtected } from '@/lib/core';
+import { logAgentOp } from './log';
 
 // Max chars per file to avoid token overflow (~100k chars ≈ ~25k tokens)
 const MAX_FILE_CHARS = 20_000;
@@ -19,47 +20,67 @@ export function assertWritable(filePath: string): void {
   assertNotProtected(filePath, 'modified by AI agent');
 }
 
+/** Helper: wrap a tool execute fn with agent-op logging */
+function logged<P extends Record<string, unknown>>(
+  toolName: string,
+  fn: (params: P) => Promise<string>,
+): (params: P) => Promise<string> {
+  return async (params: P) => {
+    const ts = new Date().toISOString();
+    try {
+      const result = await fn(params);
+      const isError = result.startsWith('Error:');
+      logAgentOp({ ts, tool: toolName, params, result: isError ? 'error' : 'ok', message: result.slice(0, 200) });
+      return result;
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      logAgentOp({ ts, tool: toolName, params, result: 'error', message: msg.slice(0, 200) });
+      throw e;
+    }
+  };
+}
+
 // ─── Knowledge base tools ─────────────────────────────────────────────────────
 
 export const knowledgeBaseTools = {
   list_files: tool({
     description: 'List the full file tree of the knowledge base. Use this to browse what files exist.',
     inputSchema: z.object({}),
-    execute: async () => {
+    execute: logged('list_files', async () => {
       const tree = getFileTree();
       return JSON.stringify(tree, null, 2);
-    },
+    }),
   }),
 
   read_file: tool({
     description: 'Read the content of a file by its relative path. Always read a file before modifying it.',
     inputSchema: z.object({ path: z.string().describe('Relative file path, e.g. "Profile/👤 Identity.md"') }),
-    execute: async ({ path }) => {
+    execute: logged('read_file', async ({ path }) => {
       try {
         return truncate(getFileContent(path));
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 
   search: tool({
     description: 'Full-text search across all files in the knowledge base. Returns matching files with context snippets.',
     inputSchema: z.object({ query: z.string().describe('Search query (case-insensitive)') }),
-    execute: async ({ query }) => {
+    execute: logged('search', async ({ query }) => {
       const results = searchFiles(query);
       if (results.length === 0) return 'No results found.';
       return results.map(r => `- **${r.path}**: ${r.snippet}`).join('\n');
-    },
+    }),
   }),
 
   get_recent: tool({
     description: 'Get the most recently modified files in the knowledge base.',
     inputSchema: z.object({ limit: z.number().min(1).max(50).default(10).describe('Number of files to return') }),
-    execute: async ({ limit }) => {
+    execute: logged('get_recent', async ({ limit }) => {
       const files = getRecentlyModified(limit);
       return files.map(f => `- ${f.path} (${new Date(f.mtime).toISOString()})`).join('\n');
-    },
+    }),
   }),
 
   write_file: tool({
@@ -68,7 +89,7 @@ export const knowledgeBaseTools = {
       path: z.string().describe('Relative file path'),
       content: z.string().describe('New full content'),
     }),
-    execute: async ({ path, content }) => {
+    execute: logged('write_file', async ({ path, content }) => {
       try {
         assertWritable(path);
         saveFileContent(path, content);
@@ -76,7 +97,7 @@ export const knowledgeBaseTools = {
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 
   create_file: tool({
@@ -85,7 +106,7 @@ export const knowledgeBaseTools = {
       path: z.string().describe('Relative file path (must end in .md or .csv)'),
       content: z.string().default('').describe('Initial file content'),
     }),
-    execute: async ({ path, content }) => {
+    execute: logged('create_file', async ({ path, content }) => {
       try {
         assertWritable(path);
         createFile(path, content);
@@ -93,7 +114,7 @@ export const knowledgeBaseTools = {
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 
   append_to_file: tool({
@@ -102,7 +123,7 @@ export const knowledgeBaseTools = {
       path: z.string().describe('Relative file path'),
       content: z.string().describe('Content to append'),
     }),
-    execute: async ({ path, content }) => {
+    execute: logged('append_to_file', async ({ path, content }) => {
       try {
         assertWritable(path);
         appendToFile(path, content);
@@ -110,7 +131,7 @@ export const knowledgeBaseTools = {
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 
   insert_after_heading: tool({
@@ -120,7 +141,7 @@ export const knowledgeBaseTools = {
       heading: z.string().describe('Heading text to find (e.g. "## Tasks" or just "Tasks")'),
       content: z.string().describe('Content to insert after the heading'),
     }),
-    execute: async ({ path, heading, content }) => {
+    execute: logged('insert_after_heading', async ({ path, heading, content }) => {
       try {
         assertWritable(path);
         insertAfterHeading(path, heading, content);
@@ -128,7 +149,7 @@ export const knowledgeBaseTools = {
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 
   update_section: tool({
@@ -138,7 +159,7 @@ export const knowledgeBaseTools = {
       heading: z.string().describe('Heading text to find (e.g. "## Status")'),
       content: z.string().describe('New content for the section'),
     }),
-    execute: async ({ path, heading, content }) => {
+    execute: logged('update_section', async ({ path, heading, content }) => {
       try {
         assertWritable(path);
         updateSection(path, heading, content);
@@ -146,6 +167,6 @@ export const knowledgeBaseTools = {
       } catch (e: unknown) {
         return `Error: ${e instanceof Error ? e.message : String(e)}`;
       }
-    },
+    }),
   }),
 };

package/app/lib/i18n.ts

@@ -36,6 +36,22 @@ export const messages = {
       settingsTitle: 'Settings (⌘,)',
       collapseTitle: 'Collapse sidebar',
       expandTitle: 'Expand sidebar',
+      sync: {
+        synced: 'Synced',
+        unpushed: 'awaiting push',
+        unpushedHint: 'commit(s) not yet pushed to remote — will sync automatically',
+        conflicts: 'conflicts',
+        conflictsHint: 'file(s) have merge conflicts — open Settings > Sync to resolve',
+        syncError: 'Sync error',
+        syncOff: 'Sync off',
+        syncing: 'Syncing...',
+        syncNow: 'Sync now',
+        syncDone: 'Sync complete',
+        syncFailed: 'Sync failed',
+        syncRestored: 'Sync restored',
+        enableSync: 'Enable sync',
+        enableHint: 'Set up cross-device sync',
+      },
     },
     search: {
       placeholder: 'Search files...',
@@ -125,6 +141,18 @@ export const messages = {
         authTokenResetConfirm: 'Regenerate token? All existing MCP clients will need to update their config.',
         authTokenMcpPort: 'MCP port',
       },
+      sync: {
+        emptyTitle: 'Cross-device Sync',
+        emptyDesc: 'Automatically sync your knowledge base across devices via Git.',
+        emptyStepsTitle: 'Setup',
+        emptyStep1: 'Create a private Git repo (GitHub, GitLab, etc.) or use an existing one.',
+        emptyStep2: 'Run this command in your terminal:',
+        emptyStep3: 'Follow the prompts to connect your repo. Sync starts automatically.',
+        featureAutoCommit: 'Auto-commit on save',
+        featureAutoPull: 'Auto-pull from remote',
+        featureConflict: 'Conflict detection',
+        featureMultiDevice: 'Works across devices',
+      },
       plugins: {
         title: 'Installed Renderers',
         builtinBadge: 'built-in',
@@ -138,6 +166,17 @@ export const messages = {
       saved: 'Saved',
       saveFailed: 'Save failed',
     },
+    onboarding: {
+      subtitle: 'Your knowledge base is empty. Pick a starter template to get going.',
+      templates: {
+        en: { title: 'English', desc: 'Pre-built structure with Profile, Notes, Projects, and more.' },
+        zh: { title: '中文', desc: '预置画像、笔记、项目等中文目录结构。' },
+        empty: { title: 'Empty', desc: 'Just the essentials — README, CONFIG, and INSTRUCTION.' },
+      },
+      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.',
+    },
     shortcuts: [
       { keys: ['⌘', 'K'], description: 'Search' },
       { keys: ['⌘', '/'], description: 'Ask AI' },
@@ -183,6 +222,22 @@ export const messages = {
       settingsTitle: '设置 (⌘,)',
       collapseTitle: '收起侧栏',
       expandTitle: '展开侧栏',
+      sync: {
+        synced: '已同步',
+        unpushed: '待推送',
+        unpushedHint: '个提交尚未推送到远程 — 将自动同步',
+        conflicts: '冲突',
+        conflictsHint: '个文件存在合并冲突 — 前往 设置 > 同步 解决',
+        syncError: '同步出错',
+        syncOff: '同步关闭',
+        syncing: '同步中...',
+        syncNow: '立即同步',
+        syncDone: '同步完成',
+        syncFailed: '同步失败',
+        syncRestored: '同步已恢复',
+        enableSync: '启用同步',
+        enableHint: '设置跨设备同步',
+      },
     },
     search: {
       placeholder: '搜索文件...',
@@ -272,6 +327,18 @@ export const messages = {
         authTokenResetConfirm: '重新生成令牌？所有 MCP 客户端配置都需要更新。',
         authTokenMcpPort: 'MCP 端口',
       },
+      sync: {
+        emptyTitle: '跨设备同步',
+        emptyDesc: '通过 Git 自动同步知识库到所有设备。',
+        emptyStepsTitle: '配置步骤',
+        emptyStep1: '创建一个私有 Git 仓库（GitHub、GitLab 等），或使用现有仓库。',
+        emptyStep2: '在终端中运行以下命令：',
+        emptyStep3: '按照提示连接仓库，同步将自动开始。',
+        featureAutoCommit: '保存时自动提交',
+        featureAutoPull: '自动拉取远程更新',
+        featureConflict: '冲突检测',
+        featureMultiDevice: '多设备同步',
+      },
       plugins: {
         title: '已安装渲染器',
         builtinBadge: '内置',
@@ -285,6 +352,17 @@ export const messages = {
       saved: '已保存',
       saveFailed: '保存失败',
     },
+    onboarding: {
+      subtitle: '知识库为空，选择一个模板快速开始。',
+      templates: {
+        en: { title: 'English', desc: '预置 Profile、Notes、Projects 等英文目录结构。' },
+        zh: { title: '中文', desc: '预置画像、笔记、项目等中文目录结构。' },
+        empty: { title: '空白', desc: '仅包含 README、CONFIG 和 INSTRUCTION 基础文件。' },
+      },
+      importHint: '已有笔记？在设置中将 MIND_ROOT 指向已有目录即可。',
+      syncHint: '需要跨设备同步？完成初始化后在终端运行',
+      syncHintSuffix: '即可。',
+    },
     shortcuts: [
       { keys: ['⌘', 'K'], description: '搜索' },
       { keys: ['⌘', '/'], description: '问 AI' },

package/app/lib/renderers/index.ts

@@ -5,6 +5,7 @@ import { GraphRenderer } from '@/components/renderers/GraphRenderer';
 import { TimelineRenderer } from '@/components/renderers/TimelineRenderer';
 import { SummaryRenderer } from '@/components/renderers/SummaryRenderer';
 import { ConfigRenderer } from '@/components/renderers/ConfigRenderer';
+import { AgentInspectorRenderer } from '@/components/renderers/AgentInspectorRenderer';
 
 registerRenderer({
   id: 'todo',
@@ -77,3 +78,15 @@ registerRenderer({
   match: ({ filePath }) => /\b(SUMMARY|summary|Summary|BRIEFING|briefing|Briefing|DAILY|daily|Daily)\b.*\.md$/i.test(filePath),
   component: SummaryRenderer,
 });
+
+registerRenderer({
+  id: 'agent-inspector',
+  name: 'Agent Inspector',
+  description: 'Visualizes agent tool-call logs as a filterable timeline. Auto-activates on .agent-log.json (JSON Lines format).',
+  author: 'MindOS',
+  icon: '🔍',
+  tags: ['agent', 'inspector', 'log', 'mcp', 'tools'],
+  builtin: true,
+  match: ({ filePath }) => /\.agent-log\.json$/i.test(filePath),
+  component: AgentInspectorRenderer,
+});

package/app/lib/settings.ts

@@ -146,5 +146,5 @@ export function effectiveAiConfig() {
 /** Effective MIND_ROOT — settings file can override, env var is fallback */
 export function effectiveSopRoot(): string {
   const s = readSettings();
-  return s.mindRoot || process.env.MIND_ROOT || path.join(os.homedir(), '.mindos', 'my-mind');
+  return s.mindRoot || process.env.MIND_ROOT || path.join(os.homedir(), 'MindOS');
 }

package/app/public/manifest.json

@@ -0,0 +1,26 @@
+{
+  "name": "MindOS",
+  "short_name": "MindOS",
+  "description": "Personal knowledge OS — browse, edit, and query your second brain.",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#0a0a0a",
+  "theme_color": "#c8871e",
+  "icons": [
+    {
+      "src": "/icons/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png"
+    },
+    {
+      "src": "/icons/icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png"
+    },
+    {
+      "src": "/logo-square.svg",
+      "sizes": "any",
+      "type": "image/svg+xml"
+    }
+  ]
+}

package/app/public/sw.js

@@ -0,0 +1,66 @@
+// MindOS Service Worker — cache static assets, skip API/dynamic routes
+const CACHE_NAME = 'mindos-v1';
+
+const PRECACHE_URLS = [
+  '/',
+  '/logo-square.svg',
+  '/logo.svg',
+];
+
+self.addEventListener('install', (event) => {
+  event.waitUntil(
+    caches.open(CACHE_NAME).then((cache) => cache.addAll(PRECACHE_URLS))
+  );
+  self.skipWaiting();
+});
+
+self.addEventListener('activate', (event) => {
+  event.waitUntil(
+    caches.keys().then((keys) =>
+      Promise.all(
+        keys.filter((k) => k !== CACHE_NAME).map((k) => caches.delete(k))
+      )
+    )
+  );
+  self.clients.claim();
+});
+
+self.addEventListener('fetch', (event) => {
+  const url = new URL(event.request.url);
+
+  // Never cache API routes or Next.js internals
+  if (
+    url.pathname.startsWith('/api/') ||
+    url.pathname.startsWith('/_next/') ||
+    event.request.method !== 'GET'
+  ) {
+    return;
+  }
+
+  // Cache-first for static assets (images, fonts, SVGs)
+  if (
+    url.pathname.startsWith('/icons/') ||
+    url.pathname.endsWith('.svg') ||
+    url.pathname.endsWith('.png') ||
+    url.pathname.endsWith('.woff2')
+  ) {
+    event.respondWith(
+      caches.match(event.request).then((cached) => {
+        if (cached) return cached;
+        return fetch(event.request).then((response) => {
+          if (response.ok) {
+            const clone = response.clone();
+            caches.open(CACHE_NAME).then((cache) => cache.put(event.request, clone));
+          }
+          return response;
+        });
+      })
+    );
+    return;
+  }
+
+  // Network-first for HTML pages
+  event.respondWith(
+    fetch(event.request).catch(() => caches.match(event.request))
+  );
+});

package/bin/cli.js

@@ -445,6 +445,27 @@ ${dim('Shortcut: mindos start --daemon  →  install + start in one step')}
       }
     }
 
+    // 8. Sync status
+    if (config?.mindRoot) {
+      try {
+        const syncStatus = getSyncStatus(config.mindRoot);
+        if (!syncStatus.enabled) {
+          warn(`Cross-device sync is not configured  ${dim('(run `mindos sync init` to set up)')}`);
+        } else if (syncStatus.lastError) {
+          err(`Sync error: ${syncStatus.lastError}`);
+          hasError = true;
+        } else if (syncStatus.conflicts && syncStatus.conflicts.length > 0) {
+          warn(`Sync has ${syncStatus.conflicts.length} unresolved conflict(s)  ${dim('(run `mindos sync conflicts` to view)')}`);
+        } else {
+          const unpushed = parseInt(syncStatus.unpushed || '0', 10);
+          const extra = unpushed > 0 ? `  ${dim(`(${unpushed} unpushed commit(s))`)}` : '';
+          ok(`Sync enabled  ${dim(syncStatus.remote || 'origin')}${extra}`);
+        }
+      } catch {
+        warn('Could not check sync status');
+      }
+    }
+
     console.log(hasError
       ? `\n${red('Some checks failed.')} Run ${cyan('mindos onboard')} to reconfigure.\n`
       : `\n${green('All checks passed.')}\n`);