@geminilight/mindos 0.5.11 → 0.5.12

package/bin/cli.js

@@ -50,7 +50,7 @@ import { needsBuild, writeBuildStamp, clearBuildLock, cleanNextDir, ensureAppDep
 import { isPortInUse, assertPortFree } from './lib/port.js';
 import { savePids, clearPids } from './lib/pid.js';
 import { stopMindos } from './lib/stop.js';
-import { getPlatform, ensureMindosDir, waitForHttp, runGatewayCommand } from './lib/gateway.js';
+import { getPlatform, ensureMindosDir, waitForHttp, waitForPortFree, runGatewayCommand } from './lib/gateway.js';
 import { printStartupInfo, getLocalIP } from './lib/startup.js';
 import { spawnMcp } from './lib/mcp-spawn.js';
 import { mcpInstall } from './lib/mcp-install.js';
@@ -84,7 +84,7 @@ const commands = {
   // ── open ───────────────────────────────────────────────────────────────────
   open: () => {
     loadConfig();
-    const webPort = process.env.MINDOS_WEB_PORT || '3000';
+    const webPort = process.env.MINDOS_WEB_PORT || '3456';
     const url = `http://localhost:${webPort}`;
     let cmd;
     if (process.platform === 'darwin') {
@@ -121,7 +121,7 @@ const commands = {
       console.log(dim('No auth token set. Run `mindos onboard` to configure one.'));
       process.exit(0);
     }
-    const mcpPort = config.mcpPort || 8787;
+    const mcpPort = config.mcpPort || 8781;
     const localIP = getLocalIP();
 
     const localUrl = `http://localhost:${mcpPort}/mcp`;
@@ -197,8 +197,8 @@ const commands = {
   // ── dev ────────────────────────────────────────────────────────────────────
   dev: async () => {
     loadConfig();
-    const webPort = process.env.MINDOS_WEB_PORT || '3000';
-    const mcpPort = process.env.MINDOS_MCP_PORT || '8787';
+    const webPort = process.env.MINDOS_WEB_PORT || '3456';
+    const mcpPort = process.env.MINDOS_MCP_PORT || '8781';
     await assertPortFree(Number(webPort), 'web');
     await assertPortFree(Number(mcpPort), 'mcp');
     ensureAppDeps();
@@ -231,11 +231,13 @@ const commands = {
         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';
+        const webPort = process.env.MINDOS_WEB_PORT || '3456';
+        const mcpPort = process.env.MINDOS_MCP_PORT || '8781';
         console.log(cyan(`Installing MindOS as a background service (${platform})...`));
         await runGatewayCommand('install');
-        await runGatewayCommand('start');
+        // install() already starts the service via launchctl bootstrap + RunAtLoad=true.
+        // Do NOT call start() here — kickstart -k would kill the just-started process,
+        // causing a port-conflict race condition with KeepAlive restart loops.
         console.log(dim('  (First run may take a few minutes to install dependencies and build the app.)'));
         console.log(dim('  Follow live progress with:  mindos logs\n'));
         const ready = await waitForHttp(Number(webPort), { retries: 120, intervalMs: 2000, label: 'Web UI' });
@@ -261,10 +263,26 @@ const commands = {
       }
     }
     loadConfig();
-    const webPort = process.env.MINDOS_WEB_PORT || '3000';
-    const mcpPort = process.env.MINDOS_MCP_PORT || '8787';
-    await assertPortFree(Number(webPort), 'web');
-    await assertPortFree(Number(mcpPort), 'mcp');
+    const webPort = process.env.MINDOS_WEB_PORT || '3456';
+    const mcpPort = process.env.MINDOS_MCP_PORT || '8781';
+
+    // When launched by a daemon manager (launchd/systemd), wait for ports to
+    // free instead of exiting immediately — the previous instance may still be
+    // shutting down after a restart/update.
+    const launchedByDaemon = process.env.LAUNCHED_BY_LAUNCHD === '1'
+      || !!process.env.INVOCATION_ID; /* systemd sets INVOCATION_ID */
+
+    if (launchedByDaemon) {
+      const webOk = await waitForPortFree(Number(webPort), { retries: 60, intervalMs: 500 });
+      const mcpOk = await waitForPortFree(Number(mcpPort), { retries: 60, intervalMs: 500 });
+      if (!webOk || !mcpOk) {
+        console.error('Ports still in use after 30s, exiting.');
+        process.exit(1);  // KeepAlive will retry after ThrottleInterval
+      }
+    } else {
+      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'));
@@ -306,8 +324,8 @@ const commands = {
       run('npm install --prefer-offline --no-workspaces', resolve(ROOT, 'mcp'));
     }
     // Map config env vars to what the MCP server expects
-    const mcpPort = process.env.MINDOS_MCP_PORT || '8787';
-    const webPort = process.env.MINDOS_WEB_PORT || '3000';
+    const mcpPort = process.env.MINDOS_MCP_PORT || '8781';
+    const webPort = process.env.MINDOS_WEB_PORT || '3456';
     process.env.MCP_PORT   = mcpPort;
     process.env.MINDOS_URL = `http://localhost:${webPort}`;
     run(`npx tsx src/index.ts`, resolve(ROOT, 'mcp'));
@@ -328,8 +346,8 @@ const commands = {
     loadConfig();
 
     // After loadConfig, env vars reflect the NEW config (or old if unchanged).
-    const newWebPort = Number(process.env.MINDOS_WEB_PORT || '3000');
-    const newMcpPort = Number(process.env.MINDOS_MCP_PORT || '8787');
+    const newWebPort = Number(process.env.MINDOS_WEB_PORT || '3456');
+    const newMcpPort = Number(process.env.MINDOS_MCP_PORT || '8781');
 
     // Collect old ports that differ from new ones — processes may still be
     // listening there even though config already points to the new ports.
@@ -465,8 +483,8 @@ ${dim('Shortcut: mindos start --daemon  →  install + start in one step')}
     }
 
     // 6. Ports
-    const webPort = Number(config?.port || process.env.MINDOS_WEB_PORT || 3000);
-    const mcpPort = Number(config?.mcpPort || process.env.MINDOS_MCP_PORT || 8787);
+    const webPort = Number(config?.port || process.env.MINDOS_WEB_PORT || 3456);
+    const mcpPort = Number(config?.mcpPort || process.env.MINDOS_MCP_PORT || 8781);
     const webInUse = await isPortInUse(webPort);
     const mcpInUse = await isPortInUse(mcpPort);
     if (webInUse) {
@@ -582,11 +600,13 @@ ${dim('Shortcut: mindos start --daemon  →  install + start in one step')}
       console.log(cyan('\n  Daemon is running — restarting to apply the new version...'));
       await runGatewayCommand('stop');
       await runGatewayCommand('install');
-      await runGatewayCommand('start');
+      // Note: install() already starts the service via launchctl bootstrap + RunAtLoad=true.
+      // Do NOT call start() here — kickstart -k would kill the just-started process,
+      // causing a port-conflict race condition with KeepAlive restart loops.
       const webPort = (() => {
-        try { return JSON.parse(readFileSync(CONFIG_PATH, 'utf-8')).port ?? 3000; } catch { return 3000; }
+        try { return JSON.parse(readFileSync(CONFIG_PATH, 'utf-8')).port ?? 3456; } catch { return 3456; }
       })();
-      console.log(dim('  (Waiting for Web UI to come back up...)'));
+      console.log(dim('  (Waiting for Web UI to come back up — first run after update includes a rebuild...)'));
       const ready = await waitForHttp(Number(webPort), { retries: 120, intervalMs: 2000, label: 'Web UI' });
       if (ready) {
         console.log(green('✔ MindOS restarted and ready.\n'));

package/bin/lib/gateway.js

@@ -1,5 +1,5 @@
 import { execSync } from 'node:child_process';
-import { existsSync, readFileSync, writeFileSync, rmSync, mkdirSync } from 'node:fs';
+import { existsSync, readFileSync, writeFileSync, rmSync, mkdirSync, statSync, renameSync, unlinkSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { homedir } from 'node:os';
 import { MINDOS_DIR, LOG_PATH, CLI_PATH, NODE_BIN, CONFIG_PATH } from './constants.js';
@@ -8,6 +8,18 @@ import { isPortInUse } from './port.js';
 
 // ── Helpers ──────────────────────────────────────────────────────────────────
 
+/** Rotate log file when it exceeds 2 MB. Keeps at most one .old backup. */
+function rotateLogs() {
+  try {
+    const stat = statSync(LOG_PATH);
+    if (stat.size > 2 * 1024 * 1024) {
+      const old = LOG_PATH + '.old';
+      try { unlinkSync(old); } catch {}
+      renameSync(LOG_PATH, old);
+    }
+  } catch { /* file doesn't exist yet, nothing to rotate */ }
+}
+
 export function getPlatform() {
   if (process.platform === 'darwin') return 'launchd';
   if (process.platform === 'linux')  return 'systemd';
@@ -72,6 +84,7 @@ const systemd = {
   install() {
     if (!existsSync(SYSTEMD_DIR)) mkdirSync(SYSTEMD_DIR, { recursive: true });
     ensureMindosDir();
+    rotateLogs();
     const currentPath = process.env.PATH ?? '/usr/local/bin:/usr/bin:/bin';
     const unit = [
       '[Unit]',
@@ -100,6 +113,7 @@ const systemd = {
   },
 
   async start() {
+    rotateLogs();
     execSync('systemctl --user start mindos', { stdio: 'inherit' });
     const ok = await waitForService(() => {
       try {
@@ -153,6 +167,7 @@ const launchd = {
   install() {
     if (!existsSync(LAUNCHD_DIR)) mkdirSync(LAUNCHD_DIR, { recursive: true });
     ensureMindosDir();
+    rotateLogs();
     const currentPath = process.env.PATH ?? '/usr/local/bin:/usr/bin:/bin';
     const plist = `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
@@ -166,13 +181,18 @@ const launchd = {
     <string>start</string>
   </array>
   <key>RunAtLoad</key><true/>
-  <key>KeepAlive</key><true/>
+  <key>KeepAlive</key>
+  <dict>
+    <key>SuccessfulExit</key><false/>
+  </dict>
+  <key>ThrottleInterval</key><integer>5</integer>
   <key>StandardOutPath</key><string>${LOG_PATH}</string>
   <key>StandardErrorPath</key><string>${LOG_PATH}</string>
   <key>EnvironmentVariables</key>
   <dict>
     <key>HOME</key><string>${homedir()}</string>
     <key>PATH</key><string>${currentPath}</string>
+    <key>LAUNCHED_BY_LAUNCHD</key><string>1</string>
   </dict>
 </dict>
 </plist>
@@ -192,6 +212,7 @@ const launchd = {
   },
 
   async start() {
+    rotateLogs();
     execSync(`launchctl kickstart -k gui/${launchctlUid()}/${LAUNCHD_LABEL}`, { stdio: 'inherit' });
     const ok = await waitForService(() => {
       try {
@@ -209,7 +230,7 @@ const launchd = {
 
   async stop() {
     // Read ports before bootout so we can wait for them to be freed
-    let webPort = 3000, mcpPort = 8787;
+    let webPort = 3456, mcpPort = 8781;
     try {
       const config = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8'));
       if (config.port) webPort = Number(config.port);

package/bin/lib/mcp-install.js

@@ -253,8 +253,8 @@ export async function mcpInstall() {
     const ask2 = (q) => new Promise(r => rl2.question(q, r));
 
     if (!url) {
-      let mcpPort = 8787;
-      try { mcpPort = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8')).mcpPort || 8787; } catch {}
+      let mcpPort = 8781;
+      try { mcpPort = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8')).mcpPort || 8781; } catch {}
       const defaultUrl = `http://localhost:${mcpPort}/mcp`;
       url = hasYesFlag ? defaultUrl : (await ask2(`${bold('MCP URL')} ${dim(`[${defaultUrl}]:`)} `)).trim() || defaultUrl;
     }

package/bin/lib/mcp-spawn.js

@@ -5,8 +5,8 @@ import { ROOT } from './constants.js';
 import { bold, red, yellow } from './colors.js';
 
 export function spawnMcp(verbose = false) {
-  const mcpPort = process.env.MINDOS_MCP_PORT || '8787';
-  const webPort = process.env.MINDOS_WEB_PORT || '3000';
+  const mcpPort = process.env.MINDOS_MCP_PORT || '8781';
+  const webPort = process.env.MINDOS_WEB_PORT || '3456';
   // Ensure mcp/node_modules exists (auto-install on first run)
   const mcpSdk = resolve(ROOT, 'mcp', 'node_modules', '@modelcontextprotocol', 'sdk', 'package.json');
   if (!existsSync(mcpSdk)) {
@@ -16,7 +16,7 @@ export function spawnMcp(verbose = false) {
   const env = {
     ...process.env,
     MCP_PORT: mcpPort,
-    MINDOS_URL: `http://localhost:${webPort}`,
+    MINDOS_URL: process.env.MINDOS_URL || `http://127.0.0.1:${webPort}`,
     ...(verbose ? { MCP_VERBOSE: '1' } : {}),
   };
   const child = spawn('npx', ['tsx', 'src/index.ts'], {

package/bin/lib/stop.js

@@ -75,7 +75,7 @@ function killTree(pid) {
  */
 export function stopMindos(opts = {}) {
   // Read ports from config for port-based cleanup
-  let webPort = '3000', mcpPort = '8787';
+  let webPort = '3456', mcpPort = '8781';
   try {
     const config = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8'));
     if (config.port) webPort = String(config.port);

package/mcp/README.md

@@ -26,7 +26,7 @@ mindos start   # starts app + MCP server together
 Or run MCP server only:
 
 ```bash
-mindos mcp     # HTTP mode (default, port 8787)
+mindos mcp     # HTTP mode (default, port 8781)
 MCP_TRANSPORT=stdio mindos mcp   # stdio mode
 ```
 
@@ -34,11 +34,11 @@ MCP_TRANSPORT=stdio mindos mcp   # stdio mode
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `MINDOS_URL` | `http://localhost:3000` | App server base URL |
+| `MINDOS_URL` | `http://localhost:3456` | App server base URL |
 | `AUTH_TOKEN` | — | Optional: bearer token (must match App's `AUTH_TOKEN`) |
 | `MCP_TRANSPORT` | `http` | Transport mode: `http` or `stdio` |
 | `MCP_HOST` | `127.0.0.1` | HTTP bind address (`0.0.0.0` for remote access) |
-| `MCP_PORT` | `8787` | HTTP listen port (configurable via `mindos onboard`) |
+| `MCP_PORT` | `8781` | HTTP listen port (configurable via `mindos onboard`) |
 | `MCP_ENDPOINT` | `/mcp` | HTTP endpoint path |
 
 ## MCP Tools (20)
@@ -75,7 +75,7 @@ Add to your Agent's MCP config (field names vary by client):
 {
   "mcpServers": {
     "mindos": {
-      "url": "http://localhost:8787/mcp",
+      "url": "http://localhost:8781/mcp",
       "headers": { "Authorization": "Bearer your-token" }
     }
   }
@@ -101,7 +101,7 @@ Add to your Agent's MCP config (field names vary by client):
 {
   "mcpServers": {
     "mindos": {
-      "url": "http://<server-ip>:8787/mcp",
+      "url": "http://<server-ip>:8781/mcp",
       "headers": { "Authorization": "Bearer your-token" }
     }
   }

package/mcp/src/index.ts

@@ -22,11 +22,11 @@ import { z } from "zod";
 
 // ─── Config ──────────────────────────────────────────────────────────────────
 
-const BASE_URL       = process.env.MINDOS_URL      ?? "http://localhost:3000";
+const BASE_URL       = process.env.MINDOS_URL      ?? "http://localhost:3456";
 const AUTH_TOKEN     = process.env.AUTH_TOKEN;
 const MCP_TRANSPORT  = process.env.MCP_TRANSPORT   ?? "http";    // "http" | "stdio"
 const MCP_HOST       = process.env.MCP_HOST        ?? "127.0.0.1";
-const MCP_PORT       = parseInt(process.env.MCP_PORT ?? "8787", 10);
+const MCP_PORT       = parseInt(process.env.MCP_PORT ?? "8781", 10);
 const MCP_ENDPOINT   = process.env.MCP_ENDPOINT    ?? "/mcp";
 const CHARACTER_LIMIT = 25_000;
 

package/package.json

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

package/scripts/setup.js

@@ -844,11 +844,11 @@ async function startGuiSetup() {
   if (isFirstTime) {
     // First-time onboard: use a temporary port (scan from 9100) so the user's
     // chosen port in Step 3 can differ without a mid-setup restart.
-    // 9100 is chosen to avoid conflicts with common services (5000=AirPlay, 3000/8080=dev).
+    // 9100 is chosen to avoid conflicts with common services (5000=AirPlay, 3456/8080=dev).
     usePort = await findFreePort(9100);
   } else {
     // Re-onboard: service is already running on config.port — reuse it.
-    const existingPort = config.port || 3000;
+    const existingPort = config.port || 3456;
     if (await isSelfPort(existingPort)) {
       // Service already running — just open the setup page, no need to spawn.
       const url = `http://localhost:${existingPort}/setup`;
@@ -866,7 +866,7 @@ async function startGuiSetup() {
         // stopMindos() sends SIGTERM synchronously — wait for both web and mcp
         // ports to free, since `start` will assertPortFree on both.
         const { waitForPortFree } = await import('../bin/lib/gateway.js');
-        const mcpPort = config.mcpPort || 8787;
+        const mcpPort = config.mcpPort || 8781;
         const [webFreed, mcpFreed] = await Promise.all([
           waitForPortFree(existingPort),
           waitForPortFree(mcpPort),
@@ -941,8 +941,8 @@ async function main() {
 
     console.log(c.bold('\nExisting config:'));
     console.log(row('Knowledge base:', c.cyan(existing.mindRoot || '(not set)')));
-    console.log(row('Web port:',       c.cyan(String(existing.port || '3000'))));
-    console.log(row('MCP port:',       c.cyan(String(existing.mcpPort || '8787'))));
+    console.log(row('Web port:',       c.cyan(String(existing.port || '3456'))));
+    console.log(row('MCP port:',       c.cyan(String(existing.mcpPort || '8781'))));
     console.log(row('Auth token:',     existing.authToken ? mask(existing.authToken) : c.dim('(not set)')));
     console.log(row('Web password:',   existing.webPassword ? '••••••••' : c.dim('(none)')));
     console.log(row('AI provider:',    c.cyan(existing.ai?.provider || '(not set)')));
@@ -953,7 +953,7 @@ async function main() {
     const overwrite = await askYesNo('cfgExists', CONFIG_PATH);
     if (!overwrite) {
       const existingMode     = existing.startMode || 'start';
-      const existingMcpPort  = existing.mcpPort   || 8787;
+      const existingMcpPort  = existing.mcpPort   || 8781;
       const existingAuth     = existing.authToken || '';
       const existingMindRoot = existing.mindRoot  || resolve(homedir(), 'MindOS', 'mind');
       console.log(`\n${c.green(t('cfgKept'))}  ${c.dim(CONFIG_PATH)}`);
@@ -1072,8 +1072,8 @@ async function main() {
   write('\n');
   stepHeader(3);
   const existingCfg = resumeCfg;
-  const defaultWebPort = typeof existingCfg.port === 'number' ? existingCfg.port : 3000;
-  const defaultMcpPort = typeof existingCfg.mcpPort === 'number' ? existingCfg.mcpPort : (defaultWebPort === 8787 ? 8788 : 8787);
+  const defaultWebPort = typeof existingCfg.port === 'number' ? existingCfg.port : 3456;
+  const defaultMcpPort = typeof existingCfg.mcpPort === 'number' ? existingCfg.mcpPort : (defaultWebPort === 8781 ? 8782 : 8781);
   let webPort, mcpPort;
   while (true) {
     webPort = await askPort('webPortPrompt', defaultWebPort);
@@ -1178,8 +1178,8 @@ async function main() {
 
   const isResuming = Object.keys(resumeCfg).length > 0;
   const needsRestart = isResuming && (
-    config.port        !== (resumeCfg.port        ?? 3000) ||
-    config.mcpPort     !== (resumeCfg.mcpPort     ?? 8787) ||
+    config.port        !== (resumeCfg.port        ?? 3456) ||
+    config.mcpPort     !== (resumeCfg.mcpPort     ?? 8781) ||
     config.mindRoot    !== (resumeCfg.mindRoot     ?? '')   ||
     config.authToken   !== (resumeCfg.authToken   ?? '')   ||
     config.webPassword !== (resumeCfg.webPassword ?? '')
@@ -1212,7 +1212,7 @@ async function main() {
   }
 
   const installDaemon = startMode === 'daemon' || process.argv.includes('--install-daemon');
-  finish(mindDir, config.startMode, config.mcpPort, config.authToken, installDaemon, needsRestart, resumeCfg.port ?? 3000);
+  finish(mindDir, config.startMode, config.mcpPort, config.authToken, installDaemon, needsRestart, resumeCfg.port ?? 3456);
 }
 
 function getLocalIP() {
@@ -1224,7 +1224,7 @@ function getLocalIP() {
   return null;
 }
 
-async function finish(mindDir, startMode = 'start', mcpPort = 8787, authToken = '', installDaemon = false, needsRestart = false, oldPort = 3000) {
+async function finish(mindDir, startMode = 'start', mcpPort = 8781, authToken = '', installDaemon = false, needsRestart = false, oldPort = 3456) {
   if (needsRestart) {
     const isRunning = await isSelfPort(oldPort);
     if (isRunning) {

package/scripts/upgrade-prompt.md

@@ -37,8 +37,8 @@ Help me upgrade my MindOS installation from the old source-based setup to the ne
    ```json
    {
      "mindRoot": "<value of MIND_ROOT>",
-     "port": 3000,
-     "mcpPort": 8787,
+     "port": 3456,
+     "mcpPort": 8781,
      "authToken": "<value of AUTH_TOKEN or empty string>",
      "webPassword": "",
      "ai": {
@@ -69,7 +69,7 @@ Help me upgrade my MindOS installation from the old source-based setup to the ne
    ```
    (First run will build automatically — this may take a minute.)
 
-7. **Confirm** the app is accessible at http://localhost:3000 and MCP is running at http://localhost:8787/mcp.
+7. **Confirm** the app is accessible at http://localhost:3456 and MCP is running at http://localhost:8781/mcp.
 
 Do not delete the old cloned repository — keep it as a backup. The `app/.env.local` file can also be kept as reference.
 ```
@@ -109,8 +109,8 @@ Do not delete the old cloned repository — keep it as a backup. The `app/.env.l
    ```json
    {
      "mindRoot": "<MIND_ROOT 的值>",
-     "port": 3000,
-     "mcpPort": 8787,
+     "port": 3456,
+     "mcpPort": 8781,
      "authToken": "<AUTH_TOKEN 的值，没有则留空字符串>",
      "webPassword": "",
      "ai": {
@@ -141,7 +141,7 @@ Do not delete the old cloned repository — keep it as a backup. The `app/.env.l
    ```
    （首次运行会自动构建，可能需要一两分钟。）
 
-7. **确认** http://localhost:3000 可以访问，http://localhost:8787/mcp 的 MCP 服务也在运行。
+7. **确认** http://localhost:3456 可以访问，http://localhost:8781/mcp 的 MCP 服务也在运行。
 
 不要删除旧的克隆仓库，保留作为备份。`app/.env.local` 也可以保留作参考。
 ```