@geminilight/mindos 0.1.0 → 0.1.1

package/README.md

@@ -132,14 +132,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 +190,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 +212,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

@@ -132,14 +132,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 +190,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 +212,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,13 @@ function writeBuildStamp() {
   writeFileSync(BUILD_STAMP, version, 'utf-8');
 }
 
+function clearBuildLock() {
+  const lockFile = resolve(ROOT, 'app', '.next', 'lock');
+  if (existsSync(lockFile)) {
+    rmSync(lockFile, { force: true });
+  }
+}
+
 // ── Port check ────────────────────────────────────────────────────────────────
 
 function isPortInUse(port) {
@@ -443,21 +450,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')}`),
@@ -501,10 +495,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'));
@@ -518,6 +516,7 @@ const commands = {
     await assertPortFree(Number(mcpPort), 'mcp');
     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 +529,7 @@ const commands = {
 
   // ── build ──────────────────────────────────────────────────────────────────
   build: () => {
+    clearBuildLock();
     run(`npx next build ${extra}`, resolve(ROOT, 'app'));
     writeBuildStamp();
   },

package/package.json

@@ -1,8 +1,15 @@
 {
   "name": "@geminilight/mindos",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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' });
+    }
   }
 }