@xqli02/mneme 0.1.4 → 0.1.6

package/bin/mneme.mjs

@@ -4,7 +4,7 @@
  * mneme CLI — Three-layer memory architecture for AI coding agents.
  *
  * Unified entry point that routes to:
- *   1. mneme's own commands (init, doctor, status, compact, facts, propose, review, auto)
+ *   1. mneme's own commands (init, doctor, status, compact, facts, propose, review, auto, server)
  *   2. opencode commands (run, web, serve, etc.) — default fallback
  *   3. bd/beads commands (ready, list, create, close, etc.)
  *
@@ -56,6 +56,7 @@ const MNEME_COMMANDS = new Set([
   "propose",
   "review",
   "auto",
+  "server",
   "version",
   "--version",
   "-v",
@@ -118,6 +119,11 @@ switch (command) {
     await auto(args.slice(1));
     break;
   }
+  case "server": {
+    const { server } = await import("../src/commands/server.mjs");
+    await server(args.slice(1));
+    break;
+  }
   case "version":
   case "--version":
   case "-v":
@@ -146,6 +152,12 @@ Usage:
   mneme status                  Show three-layer memory dashboard
   mneme compact                 Pre-compaction persistence check
 
+  ${bold("Dolt server:")}
+  mneme server start            Start the dolt server
+  mneme server stop             Stop the dolt server
+  mneme server status           Show server status (port, PID, data-dir)
+  mneme server restart          Restart the dolt server
+
   ${bold("Task management (beads):")}
   mneme ready                   Show tasks with no blockers
   mneme list [--status=STATUS]  List tasks

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xqli02/mneme",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Three-layer memory architecture for AI coding agents (Ledger + Beads + OpenCode)",
   "type": "module",
   "bin": {

package/src/commands/init.mjs

@@ -236,47 +236,37 @@ function installBd() {
 
 // ── Dolt server + bd init ───────────────────────────────────────────────────
 
-/**
- * Shared dolt data directory. All projects store their databases here,
- * isolated by database name (e.g. beads_projectA, beads_projectB).
- * One dolt server on port 3307 serves all projects on this machine.
- */
-const DOLT_DATA_DIR = process.env.MNEME_DOLT_DATA_DIR
-  || join(process.env.HOME, ".dolt", "databases");
-
-const DOLT_PORT = parseInt(process.env.MNEME_DOLT_PORT || "3307", 10);
+import { DOLT_DATA_DIR, DOLT_PORT, isPortOpen, findDoltProcess, startDoltServer, killDoltProcess } from "../dolt.mjs";
 
 function ensureDoltServer() {
-  if (!existsSync(DOLT_DATA_DIR)) {
-    mkdirSync(DOLT_DATA_DIR, { recursive: true });
-  }
+  // Check if port is already in use
+  if (isPortOpen()) {
+    const info = findDoltProcess();
 
-  // Check if a dolt server is already running and reachable
-  const test = run("bd list --status=open 2>&1");
-  if (test !== null && !test.includes("unreachable") && !test.includes("connection refused")) {
-    log.ok(`dolt server already running ${color.dim(`(port ${DOLT_PORT})`)}`);
-    return true;
+    if (info && info.dataDir === DOLT_DATA_DIR) {
+      // Same data-dir, already running — nothing to do
+      log.ok(`dolt server already running ${color.dim(`(port ${DOLT_PORT}, data-dir ${DOLT_DATA_DIR})`)}`);
+      return true;
+    }
+
+    if (info) {
+      // Dolt running but with a different data-dir — kill and restart
+      log.warn(`dolt server on port ${DOLT_PORT} uses a different data-dir, restarting...`);
+      killDoltProcess();
+    } else {
+      // Port occupied by something else entirely
+      log.fail(`Port ${DOLT_PORT} is in use by a non-dolt process. Set MNEME_DOLT_PORT to use a different port.`);
+      return false;
+    }
   }
 
   log.info(`Starting dolt server (port ${DOLT_PORT}, data-dir ${DOLT_DATA_DIR})...`);
-  const logFile = join(DOLT_DATA_DIR, "server.log");
-
-  // Start in background — shared data dir, all project databases coexist
-  run(
-    `nohup dolt sql-server --host 127.0.0.1 --port ${DOLT_PORT} --data-dir "${DOLT_DATA_DIR}" > "${logFile}" 2>&1 &`,
-  );
-
-  // Wait for server to be ready (up to 10s)
-  for (let i = 0; i < 10; i++) {
-    run("sleep 1");
-    const check = run("bd list --status=open 2>&1");
-    if (check !== null && !check.includes("unreachable") && !check.includes("connection refused")) {
-      log.ok(`dolt server started ${color.dim(`(port ${DOLT_PORT})`)}`);
-      return true;
-    }
+  if (startDoltServer()) {
+    log.ok(`dolt server started ${color.dim(`(port ${DOLT_PORT})`)}`);
+    return true;
   }
 
-  log.fail(`dolt server failed to start. Check ${logFile}`);
+  log.fail(`dolt server failed to start. Check ${DOLT_DATA_DIR}/server.log`);
   return false;
 }
 

package/src/commands/server.mjs

@@ -0,0 +1,144 @@
+/**
+ * mneme server — Manage the dolt SQL server.
+ *
+ * Subcommands:
+ *   mneme server start    Start the dolt server
+ *   mneme server stop     Stop the dolt server
+ *   mneme server status   Show server status
+ *   mneme server restart  Restart the dolt server
+ */
+
+import { DOLT_DATA_DIR, DOLT_PORT, isPortOpen, findDoltProcess, startDoltServer, killDoltProcess } from "../dolt.mjs";
+import { has, log, color } from "../utils.mjs";
+
+function showStatus() {
+  if (!has("dolt")) {
+    log.fail("dolt is not installed");
+    return false;
+  }
+
+  const open = isPortOpen();
+  if (!open) {
+    log.info(`dolt server is ${color.red("stopped")} ${color.dim(`(port ${DOLT_PORT})`)}`);
+    return false;
+  }
+
+  const info = findDoltProcess();
+  if (info) {
+    const dirMatch = info.dataDir === DOLT_DATA_DIR;
+    const dirStatus = dirMatch
+      ? color.green(info.dataDir)
+      : `${color.red(info.dataDir)} (expected: ${DOLT_DATA_DIR})`;
+
+    console.log(`
+${color.bold("dolt server")} — ${color.green("running")}
+  Port:      ${DOLT_PORT}
+  PID:       ${info.pid}
+  Data dir:  ${dirStatus}
+`);
+
+    if (!dirMatch) {
+      log.warn("Data dir mismatch. Run 'mneme server restart' to fix.");
+    }
+  } else {
+    log.info(`Port ${DOLT_PORT} is open but no dolt process found — may be a different service.`);
+  }
+
+  return true;
+}
+
+function doStart() {
+  if (!has("dolt")) {
+    log.fail("dolt is not installed. Run 'mneme init' or install manually.");
+    process.exit(1);
+  }
+
+  if (isPortOpen()) {
+    const info = findDoltProcess();
+    if (info && info.dataDir === DOLT_DATA_DIR) {
+      log.ok(`dolt server already running ${color.dim(`(port ${DOLT_PORT}, PID ${info.pid})`)}`);
+      return;
+    }
+    if (info) {
+      log.warn(`dolt server on port ${DOLT_PORT} uses different data-dir (${info.dataDir}), restarting...`);
+      killDoltProcess();
+    } else {
+      log.fail(`Port ${DOLT_PORT} is in use by a non-dolt process. Set MNEME_DOLT_PORT to use a different port.`);
+      process.exit(1);
+    }
+  }
+
+  log.info(`Starting dolt server (port ${DOLT_PORT}, data-dir ${DOLT_DATA_DIR})...`);
+  if (startDoltServer()) {
+    log.ok(`dolt server started ${color.dim(`(port ${DOLT_PORT})`)}`);
+  } else {
+    log.fail(`Failed to start dolt server. Check ${DOLT_DATA_DIR}/server.log`);
+    process.exit(1);
+  }
+}
+
+function doStop() {
+  if (!isPortOpen()) {
+    log.info("dolt server is not running.");
+    return;
+  }
+
+  const info = findDoltProcess();
+  if (!info) {
+    log.warn(`Port ${DOLT_PORT} is open but no dolt process found. Cannot stop.`);
+    return;
+  }
+
+  log.info(`Stopping dolt server (PID ${info.pid})...`);
+  if (killDoltProcess()) {
+    log.ok("dolt server stopped.");
+  } else {
+    log.fail("Failed to stop dolt server. Try: kill " + info.pid);
+  }
+}
+
+function doRestart() {
+  if (isPortOpen()) {
+    const info = findDoltProcess();
+    if (info) {
+      log.info(`Stopping dolt server (PID ${info.pid})...`);
+      killDoltProcess();
+    }
+  }
+
+  doStart();
+}
+
+export async function server(args = []) {
+  const sub = args[0];
+
+  switch (sub) {
+    case "start":
+      doStart();
+      break;
+    case "stop":
+      doStop();
+      break;
+    case "status":
+      showStatus();
+      break;
+    case "restart":
+      doRestart();
+      break;
+    default:
+      console.log(`
+${color.bold("mneme server")} — Manage the dolt SQL server
+
+Usage:
+  mneme server start     Start the dolt server
+  mneme server stop      Stop the dolt server
+  mneme server status    Show server status
+  mneme server restart   Restart the dolt server
+
+Environment:
+  MNEME_DOLT_DATA_DIR    Data directory (default: ~/.dolt/databases)
+  MNEME_DOLT_PORT        Port (default: 3307)
+`);
+      break;
+  }
+}

package/src/dolt.mjs

@@ -0,0 +1,108 @@
+/**
+ * Shared dolt server utilities.
+ *
+ * Used by both `mneme init` and `mneme server`.
+ */
+
+import { existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { run } from "./utils.mjs";
+
+/**
+ * Shared dolt data directory. All projects store their databases here,
+ * isolated by database name (e.g. beads_projectA, beads_projectB).
+ * One dolt server on port 3307 serves all projects on this machine.
+ */
+export const DOLT_DATA_DIR = process.env.MNEME_DOLT_DATA_DIR
+  || join(process.env.HOME, ".dolt", "databases");
+
+export const DOLT_PORT = parseInt(process.env.MNEME_DOLT_PORT || "3307", 10);
+
+/**
+ * Check if a TCP port is accepting connections.
+ */
+export function isPortOpen(port = DOLT_PORT) {
+  return run(`bash -c 'echo > /dev/tcp/127.0.0.1/${port}' 2>&1`) !== null;
+}
+
+/**
+ * Find dolt sql-server process(es) on the given port.
+ * Returns { proc, pid, dataDir } or null if not found.
+ *
+ * Prefers the actual dolt binary process over bash wrappers.
+ */
+export function findDoltProcess(port = DOLT_PORT) {
+  const psOutput = run(`ps aux 2>/dev/null`) ?? "";
+  const doltLines = psOutput.split("\n").filter((line) =>
+    line.includes("dolt") && line.includes("sql-server") && line.includes(`${port}`)
+    && !line.includes("grep")
+  );
+
+  if (doltLines.length === 0) return null;
+
+  // Prefer the actual dolt binary process over a bash wrapper
+  const proc = doltLines.find((l) => !l.includes("bash -c") && /\bdolt\s+sql-server\b/.test(l))
+    || doltLines[0];
+
+  const pid = proc.trim().split(/\s+/)[1];
+
+  // Extract --data-dir value from the process command line
+  const dataDirMatch = proc.match(/--data-dir\s+(\S+)/);
+  const dataDir = dataDirMatch ? dataDirMatch[1] : null;
+
+  return { proc, pid, dataDir, allLines: doltLines };
+}
+
+/**
+ * Ensure the dolt data directory exists.
+ */
+export function ensureDataDir() {
+  if (!existsSync(DOLT_DATA_DIR)) {
+    mkdirSync(DOLT_DATA_DIR, { recursive: true });
+  }
+}
+
+/**
+ * Start the dolt server in the background. Returns true if started successfully.
+ * Does NOT check if already running — caller should check first.
+ */
+export function startDoltServer() {
+  ensureDataDir();
+
+  const logFile = join(DOLT_DATA_DIR, "server.log");
+
+  run(
+    `nohup dolt sql-server --host 127.0.0.1 --port ${DOLT_PORT} --data-dir "${DOLT_DATA_DIR}" > "${logFile}" 2>&1 &`,
+  );
+
+  // Wait for server to be ready (up to 10s)
+  for (let i = 0; i < 10; i++) {
+    run("sleep 1");
+    if (isPortOpen()) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
+/**
+ * Kill a dolt process by PID. Also attempts to kill related wrapper processes.
+ */
+export function killDoltProcess(port = DOLT_PORT) {
+  const info = findDoltProcess(port);
+  if (!info) return false;
+
+  // Kill all matching dolt lines (binary + wrapper)
+  const pids = info.allLines
+    .map((l) => l.trim().split(/\s+/)[1])
+    .filter(Boolean);
+
+  for (const pid of pids) {
+    run(`kill ${pid} 2>/dev/null`);
+  }
+
+  // Wait briefly for process to exit
+  run("sleep 1");
+  return !isPortOpen(port);
+}