@geminilight/mindos 0.1.0 → 0.1.2

package/README.md

@@ -122,9 +122,11 @@ npm link   # registers the `mindos` command globally
 ### 2. Interactive Setup
 
 ```bash
-mindos onboard --install-daemon  # setup + install & start as background OS service
+mindos onboard --install-daemon
 ```
 
+> `--install-daemon`: after setup, automatically installs and starts MindOS as a background OS service (survives terminal close, auto-restarts on crash).
+
 The setup wizard will guide you through:
 1. Knowledge base path → default `~/.mindos/my-mind`
 2. Choose template language (en / zh)
@@ -132,14 +134,13 @@ The setup wizard will guide you through:
 4. Configure AI Provider (Anthropic / OpenAI) + API Key — or choose **skip** to configure later via `mindos config set`
 5. Config saved to `~/.mindos/config.json` automatically
 
-> [!TIP]
-> **For Agents:** Before running setup, if the user has not provided LLM configuration, ask them:
-> 1. AI Provider — `anthropic` or `openai` (compatible)?
-> 2. API Key — the key for the chosen provider
-> 3. Custom Base URL? — only needed for proxies or OpenAI-compatible endpoints; skip if using official API
-> 4. Model ID — or use the default
->
-> Or skip the wizard and edit `~/.mindos/config.json` manually (see Config Reference below).
+<!-- For Agents: Before running setup, if the user has not provided LLM configuration, ask them:
+1. AI Provider — `anthropic` or `openai` (compatible)?
+2. API Key — the key for the chosen provider
+3. Custom Base URL? — only needed for proxies or OpenAI-compatible endpoints; skip if using official API
+4. Model ID — or use the default
+Or skip the wizard and edit `~/.mindos/config.json` manually (see Config Reference below).
+-->
 
 <details>
 <summary>Config Reference (~/.mindos/config.json)</summary>
@@ -191,7 +192,7 @@ mindos start    # start app + MCP server (production, auto-rebuilds when a new v
 On startup, MindOS prints your Web UI URL, MCP config snippet, and auth token — ready to copy into your Agent.
 
 > [!TIP]
-> **Upgrading?** Run `mindos update` — it installs the latest version and triggers a rebuild automatically on next start.
+> **Upgrading?** Run `mindos update` to install the latest version.
 
 > [!TIP]
 > If the port is already in use, set a different port during `mindos onboard` or update `~/.mindos/config.json`:
@@ -213,8 +214,9 @@ On startup, MindOS prints your Web UI URL, MCP config snippet, and auth token
 
 #### 5.1 Configure MindOS MCP
 
+<!-- For Agents: Register MindOS MCP as global (user-level) config by default, so all projects share the same knowledge base. -->
+
 > [!TIP]
-> **For Agents:** Register MindOS MCP as global (user-level) config by default, so all projects share the same knowledge base.
 > Each Agent stores MCP config in a different file — see the **MCP Config Path** column in the [Supported Agents](#-supported-agents) table below for exact paths.
 
 Register the MindOS MCP Server in your Agent client:

package/README_zh.md

@@ -122,9 +122,11 @@ npm link   # 将 mindos 命令注册为全局命令
 ### 2. 交互式配置
 
 ```bash
-mindos onboard --install-daemon  # 初始化 + 安装并启动后台服务
+mindos onboard --install-daemon
 ```
 
+> `--install-daemon`：配置完成后，自动将 MindOS 安装为后台 OS 服务（关闭终端仍运行，崩溃自动重启）。
+
 配置向导将引导你完成：
 1. 知识库路径 → 默认 `~/.mindos/my-mind`
 2. 选择模板语言（en / zh / empty）
@@ -132,14 +134,13 @@ mindos onboard --install-daemon  # 初始化 + 安装并启动后台服务
 4. 配置 AI Provider（Anthropic / OpenAI）+ API Key — 或选择 **skip**，稍后通过 `mindos config set` 补填
 5. 配置自动保存到 `~/.mindos/config.json`
 
-> [!TIP]
-> **For Agents：** 运行 onboard 前，如果用户未提供 LLM 配置，请询问：
-> 1. AI Provider — `anthropic` 还是 `openai`（兼容）？
-> 2. API Key — 对应 Provider 的密钥
-> 3. 自定义 Base URL？— 仅代理或 OpenAI 兼容端点需要；使用官方 API 则跳过
-> 4. Model ID — 或使用默认值
->
-> 或跳过向导，手动编辑 `~/.mindos/config.json`（参考下方配置参考）。
+<!-- For Agents: 运行 onboard 前，如果用户未提供 LLM 配置，请询问：
+1. AI Provider — `anthropic` 还是 `openai`（兼容）？
+2. API Key — 对应 Provider 的密钥
+3. 自定义 Base URL？— 仅代理或 OpenAI 兼容端点需要；使用官方 API 则跳过
+4. Model ID — 或使用默认值
+或跳过向导，手动编辑 `~/.mindos/config.json`（参考下方配置参考）。
+-->
 
 <details>
 <summary>配置参考（~/.mindos/config.json）</summary>
@@ -191,7 +192,7 @@ mindos start    # 启动 app + MCP 服务（生产模式，检测到新版本时
 启动后，MindOS 会自动打印 Web UI 地址、MCP 配置片段和 Auth token，直接复制到你的 Agent 即可。
 
 > [!TIP]
-> **升级？** 运行 `mindos update` — 自动安装最新版本，下次 start 时触发重建。
+> **升级？** 运行 `mindos update` 安装最新版本。
 
 > [!TIP]
 > 如果端口被占用，在 `mindos onboard` 时指定其他端口，或更新 `~/.mindos/config.json`，也可通过环境变量临时覆盖：
@@ -213,8 +214,9 @@ mindos start    # 启动 app + MCP 服务（生产模式，检测到新版本时
 
 #### 5.1 配置 MindOS MCP
 
+<!-- For Agents: MindOS MCP 默认注册为全局（user-level）配置，使所有项目共享同一知识库。-->
+
 > [!TIP]
-> **For Agents：** MindOS MCP 默认注册为全局（user-level）配置，使所有项目共享同一知识库。
 > 每个 Agent 的 MCP 配置文件路径不同——详见下方 [支持的 Agent](#-支持的-agent) 表格中的 **MCP 配置文件路径** 列。
 
 将 MindOS MCP Server 注册到你的 Agent 客户端：

package/app/next.config.ts

@@ -5,6 +5,9 @@ const nextConfig: NextConfig = {
   transpilePackages: ['github-slugger'],
   serverExternalPackages: ['pdfjs-dist', 'pdf-parse'],
   outputFileTracingRoot: path.join(__dirname),
+  turbopack: {
+    root: path.join(__dirname),
+  },
 };
 
 export default nextConfig;

package/bin/cli.js

@@ -119,6 +119,26 @@ function writeBuildStamp() {
   writeFileSync(BUILD_STAMP, version, 'utf-8');
 }
 
+function clearBuildLock() {
+  const lockFile = resolve(ROOT, 'app', '.next', 'lock');
+  if (existsSync(lockFile)) {
+    rmSync(lockFile, { force: true });
+  }
+}
+
+function ensureAppDeps() {
+  // When installed as a global npm package, app/node_modules may not exist.
+  // next (and other deps) must be resolvable from app/ for Turbopack to work.
+  const appNext = resolve(ROOT, 'app', 'node_modules', 'next', 'package.json');
+  if (!existsSync(appNext)) {
+    console.log(yellow('Installing app dependencies (first run)...\n'));
+    // --no-workspaces: prevent npm from hoisting deps to monorepo root.
+    // When globally installed, deps must live in app/node_modules/ so that
+    // Turbopack can resolve next/package.json from the app/ project directory.
+    run('npm install --prefer-offline --no-workspaces', resolve(ROOT, 'app'));
+  }
+}
+
 // ── Port check ────────────────────────────────────────────────────────────────
 
 function isPortInUse(port) {
@@ -230,8 +250,20 @@ const systemd = {
     console.log(green('✔ Service installed and enabled'));
   },
 
-  start() {
+  async start() {
     execSync('systemctl --user start mindos', { stdio: 'inherit' });
+    // Wait up to 10s for the service to become active
+    const ok = await waitForService(() => {
+      try {
+        const out = execSync('systemctl --user is-active mindos', { encoding: 'utf-8' }).trim();
+        return out === 'active';
+      } catch { return false; }
+    });
+    if (!ok) {
+      console.error(red('\n✘ Service failed to start. Last log output:'));
+      try { execSync(`journalctl --user -u mindos -n 30 --no-pager`, { stdio: 'inherit' }); } catch {}
+      process.exit(1);
+    }
     console.log(green('✔ Service started'));
   },
 
@@ -307,8 +339,20 @@ const launchd = {
     console.log(green('✔ Service installed'));
   },
 
-  start() {
+  async start() {
     execSync(`launchctl kickstart -k gui/${launchctlUid()}/${LAUNCHD_LABEL}`, { stdio: 'inherit' });
+    // Wait up to 10s for the service to become active
+    const ok = await waitForService(() => {
+      try {
+        const out = execSync(`launchctl print gui/${launchctlUid()}/${LAUNCHD_LABEL}`, { encoding: 'utf-8' });
+        return out.includes('state = running');
+      } catch { return false; }
+    });
+    if (!ok) {
+      console.error(red('\n✘ Service failed to start. Last log output:'));
+      try { execSync(`tail -n 30 ${LOG_PATH}`, { stdio: 'inherit' }); } catch {}
+      process.exit(1);
+    }
     console.log(green('✔ Service started'));
   },
 
@@ -345,6 +389,14 @@ const launchd = {
 
 // ── gateway dispatcher ────────────────────────────────────────────────────────
 
+async function waitForService(check, { retries = 10, intervalMs = 1000 } = {}) {
+  for (let i = 0; i < retries; i++) {
+    if (check()) return true;
+    await new Promise(r => setTimeout(r, intervalMs));
+  }
+  return check();
+}
+
 async function runGatewayCommand(sub) {
   const platform = getPlatform();
   if (!platform) {
@@ -389,7 +441,11 @@ function printStartupInfo(webPort, mcpPort) {
   console.log(`\n${'─'.repeat(53)}`);
   console.log(`${bold('🧠 MindOS is starting')}\n`);
   console.log(`  ${green('●')} Web UI   ${cyan(`http://localhost:${webPort}`)}`);
-  console.log(`  ${green('●')} MCP      ${cyan(`http://localhost:${mcpPort}/mcp`)}\n`);
+  if (localIP) console.log(`             ${cyan(`http://${localIP}:${webPort}`)}`);
+  console.log(`  ${green('●')} MCP      ${cyan(`http://localhost:${mcpPort}/mcp`)}`);
+  if (localIP) console.log(`             ${cyan(`http://${localIP}:${mcpPort}/mcp`)}`);
+  if (localIP) console.log(dim(`\n  💡 Running on a remote server? Open the Network URL (${localIP}) in your browser,\n     or use SSH port forwarding: ssh -L ${webPort}:localhost:${webPort} user@${localIP}`));
+  console.log();
   console.log(bold('Configure MCP in your Agent:'));
   console.log(dim('  Local (same machine):'));
   console.log(block('localhost'));
@@ -443,21 +499,8 @@ const extra     = process.argv.slice(3).filter(a => a !== '--daemon' && a !== '-
 const commands = {
   // ── onboard ────────────────────────────────────────────────────────────────
   onboard: async () => {
-    run(`node ${resolve(ROOT, 'scripts/setup.js')}`);
-    if (process.argv.includes('--install-daemon')) {
-      const platform = getPlatform();
-      if (!platform) {
-        console.warn(yellow('Warning: daemon mode not supported on this platform. Skipping service install.'));
-        return;
-      }
-      console.log(cyan(`\nInstalling MindOS as a background service (${platform})...`));
-      await runGatewayCommand('install');
-      await runGatewayCommand('start');
-      console.log(`\n${green('✔ MindOS is running as a background service')}`);
-      console.log(dim('  View logs:    mindos logs'));
-      console.log(dim('  Stop:         mindos gateway stop'));
-      console.log(dim('  Uninstall:    mindos gateway uninstall\n'));
-    }
+    const daemonFlag = process.argv.includes('--install-daemon') ? ' --install-daemon' : '';
+    run(`node ${resolve(ROOT, 'scripts/setup.js')}${daemonFlag}`);
   },
   init:  () => run(`node ${resolve(ROOT, 'scripts/setup.js')}`),
   setup: () => run(`node ${resolve(ROOT, 'scripts/setup.js')}`),
@@ -487,6 +530,7 @@ const commands = {
     const mcpPort = process.env.MINDOS_MCP_PORT || '8787';
     await assertPortFree(Number(webPort), 'web');
     await assertPortFree(Number(mcpPort), 'mcp');
+    ensureAppDeps();
     const mcp = spawnMcp(isVerbose);
     savePids(process.pid, mcp.pid);
     process.on('exit', clearPids);
@@ -501,10 +545,14 @@ const commands = {
       if (!platform) {
         console.warn(yellow('Warning: daemon mode not supported on this platform. Falling back to foreground.'));
       } else {
+        loadConfig();
+        const webPort = process.env.MINDOS_WEB_PORT || '3000';
+        const mcpPort = process.env.MINDOS_MCP_PORT || '8787';
         console.log(cyan(`Installing MindOS as a background service (${platform})...`));
         await runGatewayCommand('install');
         await runGatewayCommand('start');
-        console.log(`\n${green('✔ MindOS is running as a background service')}`);
+        printStartupInfo(webPort, mcpPort);
+        console.log(`${green('✔ MindOS is running as a background service')}`);
         console.log(dim('  View logs:    mindos logs'));
         console.log(dim('  Stop:         mindos gateway stop'));
         console.log(dim('  Uninstall:    mindos gateway uninstall\n'));
@@ -516,8 +564,10 @@ const commands = {
     const mcpPort = process.env.MINDOS_MCP_PORT || '8787';
     await assertPortFree(Number(webPort), 'web');
     await assertPortFree(Number(mcpPort), 'mcp');
+    ensureAppDeps();
     if (needsBuild()) {
       console.log(yellow('Building MindOS (first run or new version detected)...\n'));
+      clearBuildLock();
       run('npx next build', resolve(ROOT, 'app'));
       writeBuildStamp();
     }
@@ -530,6 +580,8 @@ const commands = {
 
   // ── build ──────────────────────────────────────────────────────────────────
   build: () => {
+    ensureAppDeps();
+    clearBuildLock();
     run(`npx next build ${extra}`, resolve(ROOT, 'app'));
     writeBuildStamp();
   },

package/mcp/src/index.ts

@@ -470,7 +470,8 @@ async function main() {
     }
 
     expressApp.all(MCP_ENDPOINT, async (req, res) => {
-      await transport.handleRequest(req, res);
+      // Pass pre-parsed body: express.json() already parsed it, SDK >= 1.7 expects it as 3rd arg
+      await transport.handleRequest(req, res, req.body);
     });
 
     await server.connect(transport);

package/package.json

@@ -1,8 +1,15 @@
 {
   "name": "@geminilight/mindos",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MindOS — Human-Agent Collaborative Mind System. Local-first knowledge base that syncs your mind to all AI Agents via MCP.",
-  "keywords": ["mindos", "mcp", "knowledge-base", "ai-agent", "local-first", "second-brain"],
+  "keywords": [
+    "mindos",
+    "mcp",
+    "knowledge-base",
+    "ai-agent",
+    "local-first",
+    "second-brain"
+  ],
   "type": "module",
   "license": "MIT",
   "author": "GeminiLight",
@@ -13,7 +20,10 @@
   "bin": {
     "mindos": "bin/cli.js"
   },
-  "workspaces": ["app", "mcp"],
+  "workspaces": [
+    "app",
+    "mcp"
+  ],
   "files": [
     "app/",
     "mcp/",

package/scripts/setup.js

@@ -642,7 +642,8 @@ async function main() {
   writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n');
   console.log(`\n${c.green(t('cfgSaved'))}: ${c.dim(CONFIG_PATH)}`);
 
-  finish(mindDir, config.startMode, config.mcpPort, config.authToken);
+  const installDaemon = process.argv.includes('--install-daemon');
+  finish(mindDir, config.startMode, config.mcpPort, config.authToken, installDaemon);
 }
 
 function getLocalIP() {
@@ -654,8 +655,8 @@ function getLocalIP() {
   return null;
 }
 
-async function finish(mindDir, startMode = 'start', mcpPort = 8787, authToken = '') {
-  const startCmd = startMode === 'dev' ? 'mindos dev' : 'mindos start';
+async function finish(mindDir, startMode = 'start', mcpPort = 8787, authToken = '', installDaemon = false) {
+  const startCmd = installDaemon ? 'mindos start --daemon' : (startMode === 'dev' ? 'mindos dev' : 'mindos start');
   const lines = T.nextSteps[uiLang](startCmd);
   console.log('');
   lines.forEach((l) => console.log(l));
@@ -664,7 +665,12 @@ async function finish(mindDir, startMode = 'start', mcpPort = 8787, authToken =
   if (doStart) {
     const { execSync } = await import('node:child_process');
     const cliPath = resolve(__dirname, '../bin/cli.js');
-    execSync(`node "${cliPath}" ${startMode}`, { stdio: 'inherit' });
+    if (installDaemon) {
+      // Install and start as background service — returns immediately
+      execSync(`node "${cliPath}" start --daemon`, { stdio: 'inherit' });
+    } else {
+      execSync(`node "${cliPath}" ${startMode}`, { stdio: 'inherit' });
+    }
   }
 }