@illli-studio/mory 0.1.2 → 0.1.4

package/README.md

@@ -5,7 +5,9 @@ Local-first memory runtime with a web console and a generic MCP server.
 ```bash
 npm install -g @illli-studio/mory
 mory init
+mory --version
 mory start
+mory start --background
 mory status
 mory stop
 mory export ./mory-export.json
@@ -13,6 +15,7 @@ mory import ./mory-export.json
 ```
 
 For MCP clients, use `mory mcp` as a stdio server. Set `MORY_API_URL` and `MORY_API_TOKEN` when the API is managed separately.
+Use `mory mcp --check` to diagnose the local API connection without starting the stdio protocol.
 
 The same package also exports the TypeScript client:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@illli-studio/mory",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Local-first memory runtime with a web console and MCP server.",
   "license": "AGPL-3.0-or-later",
   "publishConfig": { "access": "public" },

package/src/cli.mjs

@@ -8,6 +8,7 @@ import { fileURLToPath } from "node:url";
 import { runMcp } from "./mcp.mjs";
 
 const packageRoot = resolve(fileURLToPath(new URL("..", import.meta.url)));
+const runtimeVersion = "0.1.4";
 const repoRoot = resolve(packageRoot, "../..");
 const dataDir = process.env.MORY_HOME || join(homedir(), ".mory");
 const configPath = join(dataDir, "config.json");
@@ -32,22 +33,34 @@ async function waitForHealth(base, token, timeout = 8000) {
   return false;
 }
 
-async function start() {
+async function start(background = false) {
   const current = config();
   const base = `http://127.0.0.1:${current.port}`;
   if (await waitForHealth(base, current.token, 500)) { console.log(`Mory is already running at ${base}`); return; }
   const env = { ...process.env, MORY_PORT: String(current.port), MORY_API_TOKEN: current.token, MORY_DATABASE: current.database, MORY_WEB_DIST: webDist() };
-  const child = spawn(process.execPath, [apiEntry()], { env, stdio: "inherit", detached: false });
+  const child = spawn(process.execPath, [apiEntry()], { env, stdio: background ? "ignore" : "inherit", detached: background });
   if (!await waitForHealth(base, current.token)) { child.kill(); throw new Error("Mory failed to start. Run `mory doctor` for diagnostics."); }
   writeFileSync(pidPath, String(child.pid));
   child.once("exit", () => { if (existsSync(pidPath) && readFileSync(pidPath, "utf8").trim() === String(child.pid)) unlinkSync(pidPath); });
+  if (background) child.unref();
   console.log(`Mory is running at ${base}`);
   console.log(`Data: ${current.database}`);
   console.log("MCP: run `mory mcp` from your agent configuration");
+  if (background) console.log("Running in background. Use `mory status` or `mory stop`.");
+  if (background) return;
   process.on("SIGINT", () => child.kill("SIGINT"));
   process.on("SIGTERM", () => child.kill("SIGTERM"));
 }
 
+async function mcpCheck() {
+  const current = config();
+  const base = process.env.MORY_API_URL || `http://127.0.0.1:${current.port}`;
+  const token = process.env.MORY_API_TOKEN || current.token;
+  const response = await fetch(base.replace(/\/$/, "") + "/health", { headers: { authorization: `Bearer ${token}` } });
+  console.log(JSON.stringify({ api: base, reachable: response.ok, mcp: "ready", protocol: "2025-06-18" }, null, 2));
+  if (!response.ok) process.exitCode = 1;
+}
+
 async function stop() {
   const current = config();
   if (!await waitForHealth(`http://127.0.0.1:${current.port}`, current.token, 500)) { if (existsSync(pidPath)) unlinkSync(pidPath); console.log("Mory is not running."); return; }
@@ -91,11 +104,13 @@ async function importMemories(inputPath) {
 
 const [command = "start", ...args] = process.argv.slice(2);
 try {
-  if (command === "init") { config(); console.log(`Initialized Mory at ${dataDir}`); }
-  else if (command === "start") await start();
+  if (command === "--version" || command === "-v" || command === "version") console.log(runtimeVersion);
+  else if (command === "init") { config(); console.log(`Initialized Mory at ${dataDir}`); }
+  else if (command === "start") await start(args.includes("--background") || args.includes("-d"));
   else if (command === "stop") await stop();
   else if (command === "export") await exportMemories(args[0]);
   else if (command === "import") await importMemories(args[0]);
+  else if (command === "mcp" && args.includes("--check")) await mcpCheck();
   else if (command === "mcp") await runMcp({ baseUrl: process.env.MORY_API_URL || `http://127.0.0.1:${config().port}`, token: process.env.MORY_API_TOKEN || config().token });
   else if (command === "doctor") await doctor();
   else if (command === "status") { const c = config(); console.log(JSON.stringify({ url: `http://127.0.0.1:${c.port}`, dataDir, running: await waitForHealth(`http://127.0.0.1:${c.port}`, c.token, 500) }, null, 2)); }

package/src/mcp.mjs

@@ -1,4 +1,5 @@
 const protocolVersion = "2025-06-18";
+const runtimeVersion = "0.1.4";
 
 async function callApi(baseUrl, token, path, method = "POST", body) {
   const response = await fetch(baseUrl.replace(/\/$/, "") + path, { method, headers: { authorization: `Bearer ${token}`, "content-type": "application/json" }, body: body === undefined ? undefined : JSON.stringify(body) });
@@ -17,7 +18,7 @@ const tools = [
 ];
 
 async function handle(message, options) {
-  if (message.method === "initialize") return { protocolVersion, capabilities: { tools: {} }, serverInfo: { name: "mory", version: "0.1.0" } };
+  if (message.method === "initialize") return { protocolVersion, capabilities: { tools: {} }, serverInfo: { name: "mory", version: runtimeVersion } };
   if (message.method === "notifications/initialized") return null;
   if (message.method === "tools/list") return { tools };
   if (message.method !== "tools/call") return {};