@geminilight/mindos 0.1.1 → 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)

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）

package/bin/cli.js

@@ -126,6 +126,19 @@ function clearBuildLock() {
   }
 }
 
+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) {
@@ -237,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'));
   },
 
@@ -314,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'));
   },
 
@@ -352,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) {
@@ -396,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'));
@@ -481,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);
@@ -514,6 +564,7 @@ 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();
@@ -529,6 +580,7 @@ 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,6 +1,6 @@
 {
   "name": "@geminilight/mindos",
-  "version": "0.1.1",
+  "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",