@geminilight/mindos 0.5.1 → 0.5.3

package/app/lib/i18n.ts

@@ -225,6 +225,7 @@ export const messages = {
       save: 'Save',
       saved: 'Saved',
       saveFailed: 'Save failed',
+      reconfigure: 'Reconfigure',
     },
     onboarding: {
       subtitle: 'Your knowledge base is empty. Pick a starter template to get going.',
@@ -275,7 +276,8 @@ export const messages = {
       // Step 1
       kbPath: 'Knowledge base path',
       kbPathHint: 'Absolute path to your notes directory.',
-      kbPathDefault: '~/MindOS',
+      kbPathDefault: '~/MindOS/mind',
+      kbPathExists: (n: number) => `Directory already has ${n} file(s) — template will not be applied.`,
       template: 'Starter template',
       templateSkip: 'Skip (directory already has files)',
       // Step 2
@@ -294,11 +296,14 @@ export const messages = {
       portInUse: (p: number) => `Port ${p} is already in use.`,
       portSuggest: (p: number) => `Use ${p}`,
       portChecking: 'Checking…',
+      portSelf: 'Current port',
       portConflict: 'Web UI and MCP ports must be different.',
       portVerifyHint: 'Click outside each field to verify, or wait for auto-check.',
       // Step 4
       authToken: 'Auth Token',
       authTokenHint: 'Bearer token for MCP / API clients. Auto-generated.',
+      authTokenUsage: 'Used for MCP connections and API clients. When configuring an Agent, this token is written automatically — no manual steps needed.',
+      authTokenUsageWhat: 'What is this?',
       authTokenSeed: 'Custom seed (optional)',
       authTokenSeedHint: 'Enter a passphrase to derive a deterministic token.',
       generateToken: 'Generate',
@@ -314,6 +319,7 @@ export const messages = {
       agentToolsLoading: 'Loading agents…',
       agentToolsEmpty: 'No supported agents detected.',
       agentNoneSelected: 'No agents selected — you can configure later in Settings → MCP.',
+      agentSkipLater: 'Skip — configure later',
       agentNotInstalled: 'not installed',
       agentStatusOk: 'configured',
       agentStatusError: 'failed',
@@ -324,8 +330,15 @@ export const messages = {
       // Step 6 — Review
       reviewHint: 'Verify your settings before completing setup.',
       reviewInstallResults: 'Agent configuration results:',
+      retryAgent: 'Retry',
+      agentFailureNote: 'Agent failures are non-blocking — you can enter MindOS and retry from Settings → MCP.',
       portAvailable: 'Available',
       portChanged: 'Port changed — please restart the server for it to take effect.',
+      restartRequired: 'Server restart required for these changes to take effect.',
+      restartNow: 'Restart now',
+      restarting: 'Restarting…',
+      restartDone: 'Server is restarting. Redirecting shortly…',
+      restartManual: 'Restart manually:',
       // Buttons
       back: 'Back',
       next: 'Next',
@@ -334,6 +347,12 @@ export const messages = {
       completing: 'Saving...',
       completeDone: 'Setup complete!',
       completeFailed: 'Setup failed. Please try again.',
+      // Welcome banner (shown after first onboard)
+      welcomeTitle: 'Welcome to MindOS!',
+      welcomeDesc: 'Setup is complete. Start by asking AI a question, browsing your knowledge base, or configuring MCP agents.',
+      welcomeLinkReconfigure: 'Reconfigure',
+      welcomeLinkAskAI: 'Ask AI',
+      welcomeLinkMCP: 'MCP Settings',
     },
   },
   zh: {
@@ -560,6 +579,7 @@ export const messages = {
       save: '保存',
       saved: '已保存',
       saveFailed: '保存失败',
+      reconfigure: '重新配置',
     },
     onboarding: {
       subtitle: '知识库为空，选择一个模板快速开始。',
@@ -610,7 +630,8 @@ export const messages = {
       // Step 1
       kbPath: '知识库路径',
       kbPathHint: '笔记目录的绝对路径。',
-      kbPathDefault: '~/MindOS',
+      kbPathDefault: '~/MindOS/mind',
+      kbPathExists: (n: number) => `目录已有 ${n} 个文件 — 将不会应用模板。`,
       template: '初始模板',
       templateSkip: '跳过（目录已有文件）',
       // Step 2
@@ -629,11 +650,14 @@ export const messages = {
       portInUse: (p: number) => `端口 ${p} 已被占用。`,
       portSuggest: (p: number) => `使用 ${p}`,
       portChecking: '检测中…',
+      portSelf: '当前端口',
       portConflict: 'Web UI 端口和 MCP 端口不能相同。',
       portVerifyHint: '点击输入框外部验证，或等待自动检测。',
       // Step 4
       authToken: 'Auth Token',
       authTokenHint: 'MCP / API 客户端使用的 Bearer Token，自动生成。',
+      authTokenUsage: '用于 MCP 连接和 API 客户端身份验证。配置 Agent 时会自动写入，无需手动填写。',
+      authTokenUsageWhat: '这是什么？',
       authTokenSeed: '自定义种子（可选）',
       authTokenSeedHint: '输入口令短语生成确定性 Token。',
       generateToken: '生成',
@@ -649,6 +673,7 @@ export const messages = {
       agentToolsLoading: '正在加载 Agent…',
       agentToolsEmpty: '未检测到受支持的 Agent。',
       agentNoneSelected: '未选择 agent — 可稍后在 设置 → MCP 中配置。',
+      agentSkipLater: '跳过 — 稍后配置',
       agentNotInstalled: '未安装',
       agentStatusOk: '已配置',
       agentStatusError: '失败',
@@ -659,8 +684,15 @@ export const messages = {
       // Step 6 — Review
       reviewHint: '完成设置前请确认以下信息。',
       reviewInstallResults: 'Agent 配置结果：',
+      retryAgent: '重试',
+      agentFailureNote: 'Agent 安装失败不影响进入 MindOS — 可稍后在 设置 → MCP 中重试。',
       portAvailable: '可用',
       portChanged: '端口已变更 — 请重启服务以使其生效。',
+      restartRequired: '以下变更需要重启服务后生效。',
+      restartNow: '立即重启',
+      restarting: '重启中…',
+      restartDone: '服务正在重启，稍后自动跳转…',
+      restartManual: '手动重启命令：',
       // Buttons
       back: '上一步',
       next: '下一步',
@@ -670,6 +702,12 @@ export const messages = {
       completing: '保存中...',
       completeDone: '设置完成！',
       completeFailed: '设置失败，请重试。',
+      // Welcome banner
+      welcomeTitle: '欢迎使用 MindOS！',
+      welcomeDesc: '初始化完成。可以开始向 AI 提问、浏览知识库，或配置 MCP Agent。',
+      welcomeLinkReconfigure: '重新配置',
+      welcomeLinkAskAI: '问 AI',
+      welcomeLinkMCP: 'MCP 设置',
     },
   },
 } as const;

package/app/lib/mcp-agents.ts

@@ -0,0 +1,48 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+export function expandHome(p: string): string {
+  return p.startsWith('~/') ? path.resolve(os.homedir(), p.slice(2)) : p;
+}
+
+export interface AgentDef {
+  name: string;
+  project: string | null;
+  global: string;
+  key: string;
+}
+
+export const MCP_AGENTS: Record<string, AgentDef> = {
+  'claude-code':    { name: 'Claude Code',    project: '.mcp.json',                       global: '~/.claude.json',    key: 'mcpServers' },
+  'claude-desktop': { name: 'Claude Desktop', project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Claude/claude_desktop_config.json' : '~/.config/Claude/claude_desktop_config.json', key: 'mcpServers' },
+  'cursor':         { name: 'Cursor',          project: '.cursor/mcp.json',                global: '~/.cursor/mcp.json', key: 'mcpServers' },
+  'windsurf':       { name: 'Windsurf',        project: null,                               global: '~/.codeium/windsurf/mcp_config.json', key: 'mcpServers' },
+  'cline':          { name: 'Cline',           project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json' : '~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json', key: 'mcpServers' },
+  'trae':           { name: 'Trae',            project: '.trae/mcp.json',                  global: '~/.trae/mcp.json', key: 'mcpServers' },
+  'gemini-cli':     { name: 'Gemini CLI',      project: '.gemini/settings.json',           global: '~/.gemini/settings.json', key: 'mcpServers' },
+  'openclaw':       { name: 'OpenClaw',        project: null,                               global: '~/.openclaw/mcp.json', key: 'mcpServers' },
+  'codebuddy':      { name: 'CodeBuddy',       project: null,                               global: '~/.claude-internal/.claude.json', key: 'mcpServers' },
+};
+
+export function detectInstalled(agentKey: string): { installed: boolean; scope?: string; transport?: string; configPath?: string } {
+  const agent = MCP_AGENTS[agentKey];
+  if (!agent) return { installed: false };
+
+  for (const [scope, cfgPath] of [['global', agent.global], ['project', agent.project]] as const) {
+    if (!cfgPath) continue;
+    const absPath = expandHome(cfgPath);
+    if (!fs.existsSync(absPath)) continue;
+    try {
+      const config = JSON.parse(fs.readFileSync(absPath, 'utf-8'));
+      const servers = config[agent.key];
+      if (servers?.mindos) {
+        const entry = servers.mindos;
+        const transport = entry.type === 'stdio' ? 'stdio' : entry.url ? 'http' : 'unknown';
+        return { installed: true, scope, transport, configPath: cfgPath };
+      }
+    } catch { /* ignore parse errors */ }
+  }
+
+  return { installed: false };
+}

package/app/lib/settings.ts

@@ -160,5 +160,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');
+  return s.mindRoot || process.env.MIND_ROOT || path.join(os.homedir(), 'MindOS', 'mind');
 }

package/bin/cli.js

@@ -550,7 +550,9 @@ ${dim('Shortcut: mindos start --daemon  →  install + start in one step')}
       await runGatewayCommand('stop');
       await runGatewayCommand('install');
       await runGatewayCommand('start');
-      const webPort = process.env.MINDOS_WEB_PORT || '3000';
+      const webPort = (() => {
+        try { return JSON.parse(readFileSync(CONFIG_PATH, 'utf-8')).port ?? 3000; } catch { return 3000; }
+      })();
       console.log(dim('  (Waiting for Web UI to come back up...)'));
       const ready = await waitForHttp(Number(webPort), { retries: 120, intervalMs: 2000, label: 'Web UI' });
       if (ready) {

package/bin/lib/gateway.js

@@ -31,7 +31,7 @@ export async function waitForHttp(port, { retries = 120, intervalMs = 2000, labe
     try {
       const { request } = await import('node:http');
       const ok = await new Promise((resolve) => {
-        const req = request({ hostname: '127.0.0.1', port, path: '/', method: 'HEAD', timeout: 1500 },
+        const req = request({ hostname: '127.0.0.1', port, path: '/api/health', method: 'GET', timeout: 1500 },
           (res) => { res.resume(); resolve(res.statusCode < 500); });
         req.on('error', () => resolve(false));
         req.on('timeout', () => { req.destroy(); resolve(false); });

package/bin/lib/mcp-agents.js

@@ -0,0 +1,16 @@
+/**
+ * Shared MCP agent definitions for CLI tools.
+ * Mirrors app/lib/mcp-agents.ts — keep in sync manually.
+ */
+
+export const MCP_AGENTS = {
+  'claude-code':    { name: 'Claude Code',    project: '.mcp.json',                       global: '~/.claude.json',                                                                         key: 'mcpServers' },
+  'claude-desktop': { name: 'Claude Desktop', project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Claude/claude_desktop_config.json' : '~/.config/Claude/claude_desktop_config.json', key: 'mcpServers' },
+  'cursor':         { name: 'Cursor',          project: '.cursor/mcp.json',                global: '~/.cursor/mcp.json',                                                                     key: 'mcpServers' },
+  'windsurf':       { name: 'Windsurf',        project: null,                               global: '~/.codeium/windsurf/mcp_config.json',                                                   key: 'mcpServers' },
+  'cline':          { name: 'Cline',           project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json' : '~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json', key: 'mcpServers' },
+  'trae':           { name: 'Trae',            project: '.trae/mcp.json',                  global: '~/.trae/mcp.json',                                                                       key: 'mcpServers' },
+  'gemini-cli':     { name: 'Gemini CLI',      project: '.gemini/settings.json',           global: '~/.gemini/settings.json',                                                                key: 'mcpServers' },
+  'openclaw':       { name: 'OpenClaw',        project: null,                               global: '~/.openclaw/mcp.json',                                                                   key: 'mcpServers' },
+  'codebuddy':      { name: 'CodeBuddy',       project: null,                               global: '~/.claude-internal/.claude.json',                                                        key: 'mcpServers' },
+};

package/bin/lib/mcp-install.js

@@ -3,18 +3,9 @@ import { resolve } from 'node:path';
 import { CONFIG_PATH } from './constants.js';
 import { bold, dim, cyan, green, red, yellow } from './colors.js';
 import { expandHome } from './utils.js';
+import { MCP_AGENTS } from './mcp-agents.js';
 
-export const MCP_AGENTS = {
-  'claude-code':     { name: 'Claude Code',     project: '.mcp.json',                       global: '~/.claude.json',                                                                         key: 'mcpServers' },
-  'claude-desktop':  { name: 'Claude Desktop',  project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Claude/claude_desktop_config.json' : '~/.config/Claude/claude_desktop_config.json', key: 'mcpServers' },
-  'cursor':          { name: 'Cursor',           project: '.cursor/mcp.json',                global: '~/.cursor/mcp.json',                                                                     key: 'mcpServers' },
-  'windsurf':        { name: 'Windsurf',         project: null,                               global: '~/.codeium/windsurf/mcp_config.json',                                                   key: 'mcpServers' },
-  'cline':           { name: 'Cline',            project: null,                               global: process.platform === 'darwin' ? '~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json' : '~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json', key: 'mcpServers' },
-  'trae':            { name: 'Trae',             project: '.trae/mcp.json',                  global: '~/.trae/mcp.json',                                                                       key: 'mcpServers' },
-  'gemini-cli':      { name: 'Gemini CLI',       project: '.gemini/settings.json',           global: '~/.gemini/settings.json',                                                                key: 'mcpServers' },
-  'openclaw':        { name: 'OpenClaw',         project: null,                               global: '~/.openclaw/mcp.json',                                                                   key: 'mcpServers' },
-  'codebuddy':       { name: 'CodeBuddy',        project: null,                               global: '~/.claude-internal/.claude.json',                                                        key: 'mcpServers' },
-};
+export { MCP_AGENTS };
 
 // ─── Interactive select (arrow keys) ──────────────────────────────────────────
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geminilight/mindos",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "MindOS — Human-Agent Collaborative Mind System. Local-first knowledge base that syncs your mind to all AI Agents via MCP.",
   "keywords": [
     "mindos",