@aliceshimada/mica 1.0.2 → 1.0.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.0.3 - 2026-06-06
+
+- Deprecate `mica start`, `mica stop`, and `mica restart` commands.
+- `mica start` and bare `mica` (no args) are now aliases for `mica mcp`.
+- `mica mcp` starts an MCP stdio server, proxying to an existing bridge or starting a new one.
+
 ## 1.0.2 - 2026-06-06
 
 - Add `mica mcp` command: starts an MCP stdio server that proxies to an existing bridge or starts a new one.

package/README.md

@@ -77,34 +77,32 @@ mica install
 Then fully quit and restart Wolfram Desktop. Open a notebook, start the MCP server, and connect your MCP client:
 
 ```bash
-mica start
+mica mcp
 ```
 
-Or from a release checkout:
+Or from a release checkout:
 
 ```bash
 git clone https://github.com/Alice-Shimada/mica.git
 cd mica
-npm ci
-npm run build
-node dist/src/cli/index.js install
-```
-
-Then fully quit and restart Wolfram Desktop. Open a notebook, start the MCP server, and connect your MCP client:
-
-```bash
-node dist/src/cli/index.js start
-```
-
-If MICA is installed on your `PATH`, the same release commands are:
-
-```bash
-mica install
-mica start
-mica doctor
-mica status
-mica stop
-mica restart
+npm ci
+npm run build
+node dist/src/cli/index.js install
+```
+
+Then fully quit and restart Wolfram Desktop. Open a notebook, start the MCP server, and connect your MCP client:
+
+```bash
+node dist/src/cli/index.js mcp
+```
+
+If MICA is installed on your `PATH`, the same release commands are:
+
+```bash
+mica install
+mica mcp
+mica doctor
+mica status
 ```
 
 Dashboard:
@@ -124,7 +122,7 @@ node dist/src/cli/index.js install --dry-run
 node dist/src/cli/index.js uninstall
 ```
 
-`mica status` prints the current session file, server URL, version, PID, live agent/notebook counts, and the token-bearing dashboard URL. If a server is already running, `mica start` prints that same status instead of failing with a port-in-use error, so you can recover the dashboard token at any time.
+`mica status` prints the current session file, server URL, version, PID, live agent/notebook counts, and the token-bearing dashboard URL. If a server is already running, `mica mcp` proxies to it instead of failing with a port-in-use error, so you can recover the dashboard token at any time.
 
 The legacy installer entry remains available for compatibility: `node scripts/install.js --dry-run`.
 
@@ -302,9 +300,9 @@ The doctor checks Node version, package build, session file, auth token, server
 
 | Doctor output | Likely cause | Action |
 | --- | --- | --- |
-| `FAIL Session file` | Server never started | `mica start` |
+| `FAIL Session file` | Server never started | `mica mcp` |
 | `FAIL Auth token` | Token mismatch or expired | Restart the server |
-| `FAIL Server /status reachable` | Server not running | `mica start` |
+| `FAIL Server /status reachable` | Server not running | `mica mcp` |
 | `FAIL Live agent count: 0` | Wolfram not running or bridge not loaded | Restart Wolfram Desktop after install |
 | `FAIL Live notebook count: 0` | No notebook open or registered | Open a notebook in Wolfram Desktop |
 | `FAIL Kernel/init.m` | Installer not run | `mica install` |

package/README.zh-CN.md

@@ -77,7 +77,7 @@ mica install
 然后完全退出并重启 Wolfram Desktop。打开一个 Notebook，启动 MCP server，并连接你的 MCP client：
 
 ```bash
-mica start
+mica mcp
 ```
 
 或者从发布版 checkout 开始：
@@ -93,18 +93,16 @@ node dist/src/cli/index.js install
 然后完全退出并重启 Wolfram Desktop。打开一个 Notebook，启动 MCP server，并连接你的 MCP client：
 
 ```bash
-node dist/src/cli/index.js start
+node dist/src/cli/index.js mcp
 ```
 
 如果 MICA 已经安装在你的 `PATH` 中，也可以使用等价的发布版命令：
 
 ```bash
 mica install
-mica start
+mica mcp
 mica doctor
 mica status
-mica stop
-mica restart
 ```
 
 Dashboard：
@@ -124,7 +122,7 @@ node dist/src/cli/index.js install --dry-run
 node dist/src/cli/index.js uninstall
 ```
 
-`mica status` 会打印当前 session file、server URL、version、PID、live agent/notebook 数量，以及带 token 的 dashboard URL。如果 server 已经在运行，`mica start` 会打印同样的 status，而不是因为端口占用直接失败；因此你随时可以用它找回 dashboard token。
+`mica status` 会打印当前 session file、server URL、version、PID、live agent/notebook 数量，以及带 token 的 dashboard URL。如果 server 已经在运行，`mica mcp` 会代理到已有后端，而不是因为端口占用直接失败；因此你随时可以用它找回 dashboard token。
 
 兼容用的 legacy 安装入口仍然可用：`node scripts/install.js --dry-run`。
 
@@ -302,9 +300,9 @@ Doctor 会检查 Node 版本、package build、session file、auth token、serve
 
 | Doctor output | 可能原因 | 操作 |
 | --- | --- | --- |
-| `FAIL Session file` | Server 尚未启动 | `mica start` |
+| `FAIL Session file` | Server 尚未启动 | `mica mcp` |
 | `FAIL Auth token` | Token 不匹配或已过期 | 重启 server |
-| `FAIL Server /status reachable` | Server 未运行 | `mica start` |
+| `FAIL Server /status reachable` | Server 未运行 | `mica mcp` |
 | `FAIL Live agent count: 0` | Wolfram 未运行或 bridge 未加载 | 安装后重启 Wolfram Desktop |
 | `FAIL Live notebook count: 0` | 没有打开或注册的 Notebook | 在 Wolfram Desktop 中打开 Notebook |
 | `FAIL Kernel/init.m` | 尚未运行安装器 | `mica install` |

package/dist/src/bun/httpServer.js

@@ -3,7 +3,7 @@ import http from "node:http";
 import { executeBackendMcpTool } from "../mcp/backendTools.js";
 import { renderDashboard } from "./dashboard.js";
 const JSON_BODY_LIMIT_BYTES = 1024 * 1024;
-const DEFAULT_VERSION = "1.0.2";
+const DEFAULT_VERSION = "1.0.3";
 export async function createBunHttpApp({ state, host = "127.0.0.1", port, authToken, version = DEFAULT_VERSION }) {
     const runtimeInfo = {
         host,

package/dist/src/bun/index.js

@@ -8,7 +8,7 @@ import { loadRuntimeConfig } from "../runtime/config.js";
 import { writeSessionFile } from "../runtime/session.js";
 import { createBunHttpApp } from "./httpServer.js";
 const MCP_SERVER_NAME = "mica-bun";
-const MICA_PACKAGE_VERSION = "1.0.2";
+const MICA_PACKAGE_VERSION = "1.0.3";
 export async function startBunRuntime(deps = {}) {
     const config = deps.runtimeConfig ?? loadRuntimeConfig();
     const bridgeOnly = deps.bridgeOnly ?? config.bridgeOnly;

package/dist/src/cli/index.js

@@ -10,7 +10,6 @@ import { defaultSessionFile } from "../runtime/config.js";
 import { runConfigCommand } from "./configSnippets.js";
 import { runDoctor } from "./doctor.js";
 import { runStatusCommand } from "./status.js";
-import { runStopCommand } from "./stop.js";
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -82,10 +81,7 @@ export function helpText() {
     return `Usage: mica <command> [options]
 
 Commands:
-  start                   Start the MICA bridge runtime (default)
-  stop                    Stop the running MICA bridge runtime
-  restart                 Stop then start the MICA bridge runtime
-  mcp                     Start MCP stdio server; proxy to an existing bridge if possible
+  mcp                     Run MCP stdio server (proxy to existing bridge or launch new)
   install [options]       Install MICA bridge into Wolfram
   uninstall [options]     Uninstall MICA bridge from Wolfram
   doctor                  Diagnose MICA bridge configuration
@@ -108,7 +104,6 @@ export async function runCli(argv, deps) {
     const _runDoctor = deps?.runDoctor;
     const _runStatus = deps?.runStatus;
     const _runConfig = deps?.runConfig;
-    const _runStop = deps?.runStop;
     const _readLiveSession = deps?.readLiveSession ?? (() => readLiveSession(argv.slice(1)));
     const _startProxyRuntime = deps?.startProxyRuntime ?? ((session) => startProxyMcpRuntime(session));
     const _sleep = deps?.sleep ?? sleep;
@@ -138,25 +133,8 @@ export async function runCli(argv, deps) {
         stdout.write(output);
         return 0;
     }
-    // start or no args
-    if (command === "start" || command === undefined) {
-        if (_runStatus) {
-            const status = await _runStatus();
-            if (status.running) {
-                stdout.write(status.output);
-                return status.exitCode;
-            }
-        }
-        if (!startRuntime) {
-            stderr.write("Error: startRuntime not available\n");
-            return 1;
-        }
-        const runtime = await startRuntime();
-        await runtime.keepAlive;
-        return 0;
-    }
-    // mcp
-    if (command === "mcp") {
+    // mcp (also start, or no args)
+    if (command === "mcp" || command === "start" || command === undefined) {
         const existingSession = await _readLiveSession();
         if (existingSession) {
             const proxyRuntime = await _startProxyRuntime(existingSession);
@@ -219,33 +197,6 @@ export async function runCli(argv, deps) {
         stdout.write(output);
         return exitCode;
     }
-    // stop
-    if (command === "stop") {
-        if (!_runStop) {
-            stderr.write("Error: runStop not available\n");
-            return 1;
-        }
-        const { exitCode, output } = await _runStop();
-        stdout.write(output);
-        return exitCode;
-    }
-    // restart
-    if (command === "restart") {
-        if (!_runStop) {
-            stderr.write("Error: runStop not available\n");
-            return 1;
-        }
-        if (!startRuntime) {
-            stderr.write("Error: startRuntime not available\n");
-            return 1;
-        }
-        const stopResult = await _runStop();
-        if (stopResult.output)
-            stdout.write(stopResult.output);
-        const runtime = await startRuntime();
-        await runtime.keepAlive;
-        return 0;
-    }
     // Unknown command
     stderr.write(`Unknown command: ${command}\n`);
     return 1;
@@ -264,7 +215,6 @@ async function main() {
         runInstaller,
         runStatus: async () => runStatusCommand(),
         runConfig: runConfigCommand,
-        runStop: async () => runStopCommand(),
         runDoctor: async () => runDoctor({
             projectRoot,
             detectWolframUserBase: () => detectWolframUserBase(),

package/dist/src/cli/status.js

@@ -14,7 +14,7 @@ export async function runStatusCommand(deps = {}) {
     const ok = (label, detail) => lines.push(`OK   ${label}: ${detail}`);
     if (!_exists(sessionFile)) {
         fail("Session file", `${sessionFile} (not found)`);
-        lines.push("FIX  Run: mica start");
+        lines.push("FIX  Run: mica mcp");
         return result(1, lines, false);
     }
     let session;
@@ -23,7 +23,7 @@ export async function runStatusCommand(deps = {}) {
     }
     catch (error) {
         fail("Session file", error instanceof Error ? error.message : String(error));
-        lines.push("FIX  Run: mica start");
+        lines.push("FIX  Run: mica mcp");
         return result(1, lines, false);
     }
     const baseUrl = session.baseUrl ?? `http://${session.host ?? "127.0.0.1"}:${session.port ?? 19791}`;
@@ -31,7 +31,7 @@ export async function runStatusCommand(deps = {}) {
     ok("Session target", baseUrl);
     if (!session.authToken) {
         fail("Auth token", "missing in session file");
-        lines.push("FIX  Restart MICA with: mica start");
+        lines.push("FIX  Restart MICA with: mica mcp");
         return result(1, lines, false);
     }
     if (!_fetch) {
@@ -44,12 +44,12 @@ export async function runStatusCommand(deps = {}) {
         });
         if (response.status === 401) {
             fail("Auth token", "401 Unauthorized");
-            lines.push("FIX  Restart MICA with: mica start");
+            lines.push("FIX  Restart MICA with: mica mcp");
             return result(1, lines, false);
         }
         if (response.status !== 200) {
             fail("Server /status reachable", `HTTP ${response.status}`);
-            lines.push("FIX  Run: mica start");
+            lines.push("FIX  Run: mica mcp");
             return result(1, lines, false);
         }
         const body = (await response.json());
@@ -67,7 +67,7 @@ export async function runStatusCommand(deps = {}) {
     }
     catch (error) {
         fail("Server /status reachable", error instanceof Error ? error.message : String(error));
-        lines.push("FIX  Run: mica start");
+        lines.push("FIX  Run: mica mcp");
         return result(1, lines, false);
     }
 }

package/dist/src/mcp/prompts.js

@@ -33,7 +33,7 @@ export const MICA_AGENT_INSTRUCTIONS = [
     "Tools:",
     ...TOOL_GUIDE.map(([name, description]) => `- ${name}: ${description}`),
 ].join("\n");
-export function createMicaMcpServer(name, version = "1.0.2") {
+export function createMicaMcpServer(name, version = "1.0.3") {
     return new McpServer({ name, version }, { instructions: MICA_AGENT_INSTRUCTIONS });
 }
 export function registerMicaPrompts(server) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliceshimada/mica",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Local MCP bridge for controlling live Wolfram Desktop / Mathematica notebooks.",
   "type": "module",
   "repository": {
@@ -23,7 +23,6 @@
   },
   "files": [
     "dist/src",
-    "src/bun/index.ts",
     "paclet",
     "README.md",
     "README.zh-CN.md",

package/src/bun/index.ts

@@ -1,120 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { randomUUID } from "node:crypto";
-import { pathToFileURL } from "node:url";
-import { BackendState } from "../backend/backendState.js";
-import { registerBackendMcpTools } from "../mcp/backendTools.js";
-import { createMicaMcpServer, registerMicaPrompts } from "../mcp/prompts.js";
-import type { MicaRuntimeConfig } from "../runtime/config.js";
-import { loadRuntimeConfig } from "../runtime/config.js";
-import { writeSessionFile } from "../runtime/session.js";
-import { createBunHttpApp } from "./httpServer.js";
-
-const MCP_SERVER_NAME = "mica-bun";
-const MICA_PACKAGE_VERSION = "1.0.2";
-
-export type BunRuntimeDeps = {
-  bridgeOnly?: boolean;
-  createHttpApp?: typeof createBunHttpApp;
-  createMcpServer?: () => Pick<McpServer, "connect" | "prompt" | "tool">;
-  createTransport?: () => StdioServerTransport;
-  installSignalHandlers?: (onSignal: (signal: NodeJS.Signals) => void) => () => void;
-  runtimeConfig?: MicaRuntimeConfig;
-  state?: BackendState;
-  version?: string;
-  writeSessionFile?: typeof writeSessionFile;
-};
-
-export type BunRuntime = {
-  state: BackendState;
-  httpApp: Awaited<ReturnType<typeof createBunHttpApp>>;
-  stop: () => Promise<void>;
-  keepAlive: Promise<void>;
-};
-
-export async function startBunRuntime(deps: BunRuntimeDeps = {}): Promise<BunRuntime> {
-  const config = deps.runtimeConfig ?? loadRuntimeConfig();
-  const bridgeOnly = deps.bridgeOnly ?? config.bridgeOnly;
-  const state = deps.state ?? new BackendState(() => `notebook-${randomUUID()}`);
-  const createHttpApp = deps.createHttpApp ?? createBunHttpApp;
-  const createMcpServer = deps.createMcpServer ?? (() => createMicaMcpServer(MCP_SERVER_NAME));
-  const createTransport = deps.createTransport ?? (() => new StdioServerTransport());
-  const writeSession = deps.writeSessionFile ?? writeSessionFile;
-  const version = deps.version ?? MICA_PACKAGE_VERSION;
-  const installSignalHandlers =
-    deps.installSignalHandlers ??
-    ((onSignal: (signal: NodeJS.Signals) => void) => {
-      process.once("SIGINT", onSignal);
-      process.once("SIGTERM", onSignal);
-      return () => {
-        process.off("SIGINT", onSignal);
-        process.off("SIGTERM", onSignal);
-      };
-    });
-  const httpApp = await createHttpApp({ state, host: config.host, port: config.preferredPort, authToken: config.authToken, version });
-  let cleanupSignals = () => {};
-  let stopped = false;
-  let stopPromise: Promise<void> | undefined;
-
-  const stop = async (): Promise<void> => {
-    if (stopPromise) return stopPromise;
-    stopPromise = (async () => {
-      if (stopped) return;
-      stopped = true;
-      cleanupSignals();
-      await httpApp.stop();
-    })();
-    return stopPromise;
-  };
-
-  const onSignal = (signal: NodeJS.Signals) => {
-    void stop().finally(() => process.exit(0));
-  };
-
-  try {
-    cleanupSignals = installSignalHandlers(onSignal);
-    await writeSession(config.sessionFile, {
-      host: config.host,
-      port: httpApp.port,
-      authToken: config.authToken,
-      pid: process.pid,
-      version,
-      status: "running",
-    });
-    const server = createMcpServer();
-    registerBackendMcpTools(server as McpServer, state);
-    registerMicaPrompts(server);
-
-    console.error(`Bun HTTP server listening on http://${config.host}:${httpApp.port}`);
-    console.error(`Dashboard: http://${config.host}:${httpApp.port}/#token=${config.authToken}`);
-    if (!bridgeOnly) {
-      console.error("Bun MCP mode enabled; connecting stdio transport.");
-      await server.connect(createTransport());
-    }
-  } catch (error) {
-    await stop();
-    throw error;
-  }
-
-  return {
-    state,
-    httpApp,
-    stop,
-    keepAlive: new Promise<void>(() => {})
-  };
-}
-
-async function main(): Promise<void> {
-  const runtime = await startBunRuntime();
-  await runtime.keepAlive;
-}
-
-if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
-  main().catch((error) => {
-    const message = error instanceof Error ? error.stack ?? error.message : String(error);
-    console.error(message);
-    process.exitCode = 1;
-  });
-}
-
-export { MCP_SERVER_NAME };