docdex 0.2.35 → 0.2.37

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.2.37
+- Bump release metadata to 0.2.37.
+
+## 0.2.36
+- Bump release metadata to 0.2.36.
+
 ## 0.2.35
 - Route legacy MCP JSON-RPC method names (docdex_* / docdex.*) through tools/call so older clients keep working.
 

package/assets/agents.md

@@ -1,4 +1,4 @@
----- START OF DOCDEX INFO V0.2.35 ----
+---- START OF DOCDEX INFO V0.2.37 ----
 Docdex URL: http://127.0.0.1:28491
 Use this base URL for Docdex HTTP endpoints.
 Health check endpoint: `GET /healthz` (not `/v1/health`).
@@ -6,6 +6,7 @@ Health check endpoint: `GET /healthz` (not `/v1/health`).
 ## Priority Directives (Mandatory)
 
 - Always use both memory lobes early: docdex_get_profile + docdex_memory_recall; save new facts via docdex_memory_save and new preferences via docdex_save_preference.
+- Profile memory is always-on and global; never gate on DOCDEX_ENABLE_MEMORY or repo state. docdex_save_preference must persist (fallback if embeddings/LLM unavailable). If profile calls fail, treat it as a bug.
 - Maintain agent-specific profile memory: use your agent_id with docdex_get_profile/docdex_save_preference; store generic self-knowledge (role, tooling, preferences).
 - Use impact analysis for every code change: prefer MCP tools `docdex_impact_graph` / `docdex_dag_export` (IPC/HTTP). If shell networking is blocked, do not use curl; use MCP/IPC instead. If unavailable, state it and proceed cautiously.
 - Apply DAG reasoning for planning: prefer dependency graph facts (impact results and /v1/dag/export) to choose the right change order and scope.
@@ -250,7 +251,7 @@ Query params:
 
 - SSE: `/v1/mcp/sse` + `/v1/mcp/message`. When multiple repos are mounted, initialize with `rootUri` first.
 - HTTP: `/v1/mcp` accepts repo context in the payload or via prior initialize.
-- If HTTP/SSE is unreachable (sandboxed clients), fall back to local IPC: configure `transport = "ipc"` with `socket_path` (Unix) or `pipe_name` (Windows) and send MCP JSON-RPC to `/v1/mcp` over IPC.
+- If HTTP/SSE is unreachable or fails (e.g., connection refused or sandboxed clients), fall back to local IPC: configure `transport = "ipc"` with `socket_path` (Unix) or `pipe_name` (Windows) and send MCP JSON-RPC to `/v1/mcp` over IPC.
 - For stdio-only clients (e.g., Smithery), use the `docdex-mcp-stdio` entrypoint to bridge stdio JSON-RPC to Docdex MCP.
 - For impact/DAG in sandboxed shells, prefer MCP/IPC tools over `curl` to `/v1/graph/impact` or `/v1/dag/export`.
 - MCP tools: `docdex_impact_graph` (impact traversal) and `docdex_dag_export` (DAG export).

package/lib/install.js

@@ -2258,7 +2258,7 @@ async function main() {
   }
   const result = await runInstaller({ env, distBaseDir });
   try {
-    const skipDaemon = Boolean(env?.npm_lifecycle_event);
+    const skipDaemon = parseEnvBool(env?.DOCDEX_DAEMON_SKIP_SETUP);
     await runPostInstallSetup({ binaryPath: result?.binaryPath, env, skipDaemon, distBaseDir });
   } catch (err) {
     console.warn(`[docdex] postinstall setup failed: ${err?.message || err}`);

package/lib/postinstall_setup.js

@@ -313,6 +313,73 @@ function stopDaemonService({ logger } = {}) {
   return false;
 }
 
+function removeDaemonService({ logger, distBaseDir, env } = {}) {
+  if (process.platform === "darwin") {
+    const uid = typeof process.getuid === "function" ? process.getuid() : null;
+    const domain = uid != null ? `gui/${uid}` : null;
+    const plistPath = path.join(os.homedir(), "Library", "LaunchAgents", "com.docdex.daemon.plist");
+    const systemPlistPath = "/Library/LaunchDaemons/com.docdex.daemon.plist";
+    if (domain) {
+      spawnSync("launchctl", ["bootout", domain, "com.docdex.daemon"]);
+      spawnSync("launchctl", ["bootout", domain, plistPath]);
+    } else {
+      spawnSync("launchctl", ["bootout", "com.docdex.daemon"]);
+      spawnSync("launchctl", ["bootout", plistPath]);
+    }
+    spawnSync("launchctl", ["remove", "com.docdex.daemon"]);
+    spawnSync("launchctl", ["unload", "-w", plistPath]);
+    if (fs.existsSync(plistPath)) {
+      try {
+        fs.unlinkSync(plistPath);
+      } catch (err) {
+        logger?.warn?.(`[docdex] failed to remove LaunchAgent plist: ${err?.message || err}`);
+      }
+    }
+    if (fs.existsSync(systemPlistPath)) {
+      spawnSync("launchctl", ["bootout", "system", systemPlistPath]);
+      spawnSync("launchctl", ["remove", "com.docdex.daemon"]);
+      try {
+        fs.unlinkSync(systemPlistPath);
+      } catch (err) {
+        logger?.warn?.(`[docdex] failed to remove LaunchDaemon plist: ${err?.message || err}`);
+      }
+    }
+    return true;
+  }
+  if (process.platform === "linux") {
+    const systemdDir = path.join(os.homedir(), ".config", "systemd", "user");
+    const unitPath = path.join(systemdDir, "docdexd.service");
+    spawnSync("systemctl", ["--user", "stop", "docdexd.service"]);
+    spawnSync("systemctl", ["--user", "disable", "--now", "docdexd.service"]);
+    spawnSync("systemctl", ["--user", "reset-failed", "docdexd.service"]);
+    if (fs.existsSync(unitPath)) {
+      try {
+        fs.unlinkSync(unitPath);
+      } catch (err) {
+        logger?.warn?.(`[docdex] failed to remove systemd unit: ${err?.message || err}`);
+      }
+      spawnSync("systemctl", ["--user", "daemon-reload"]);
+    }
+    return true;
+  }
+  if (process.platform === "win32") {
+    const taskName = "Docdex Daemon";
+    spawnSync("schtasks", ["/End", "/TN", taskName]);
+    spawnSync("schtasks", ["/Delete", "/TN", taskName, "/F"]);
+    const resolvedDistBaseDir = distBaseDir || resolveDistBaseDir({ env, fsModule: fs });
+    const runnerPath = resolveWindowsRunnerPath({ distBaseDir: resolvedDistBaseDir, pathModule: path });
+    if (runnerPath && fs.existsSync(runnerPath)) {
+      try {
+        fs.unlinkSync(runnerPath);
+      } catch (err) {
+        logger?.warn?.(`[docdex] failed to remove Windows runner: ${err?.message || err}`);
+      }
+    }
+    return true;
+  }
+  return false;
+}
+
 function startDaemonService({ logger } = {}) {
   if (process.platform === "darwin") {
     const uid = typeof process.getuid === "function" ? process.getuid() : null;
@@ -356,6 +423,21 @@ function stopDaemonByName({ logger } = {}) {
   return true;
 }
 
+async function cleanupExistingDaemon({ logger, env, distBaseDir, host, port } = {}) {
+  const log = logger || console;
+  stopDaemonService({ logger: log });
+  stopDaemonFromLock({ logger: log });
+  stopDaemonByName({ logger: log });
+  removeDaemonService({ logger: log, distBaseDir, env });
+  clearDaemonLocks();
+  if (!host || !port) return true;
+  const released = await waitForPortAvailable({ host, port });
+  if (!released) {
+    log.warn?.(`[docdex] ${host}:${port} still in use after daemon cleanup.`);
+  }
+  return released;
+}
+
 function clearDaemonLocks() {
   let removed = false;
   for (const lockPath of daemonLockPaths()) {
@@ -2360,7 +2442,6 @@ function isNpmLifecycle(env = process.env) {
 
 function shouldSkipDaemonSideEffects({ env = process.env, skipDaemon } = {}) {
   if (skipDaemon) return true;
-  if (isNpmLifecycle(env)) return true;
   if (parseEnvBool(env?.DOCDEX_DAEMON_SKIP_SETUP)) return true;
   return false;
 }
@@ -2478,6 +2559,22 @@ async function runPostInstallSetup({ binaryPath, logger, env, skipDaemon, distBa
   }
   const port = DEFAULT_DAEMON_PORT;
   let portState = { available: true, reuseExisting: false };
+  if (allowDaemon) {
+    const cleaned = await cleanupExistingDaemon({
+      logger: log,
+      env: effectiveEnv,
+      distBaseDir: resolvedDistBaseDir,
+      host: DEFAULT_HOST,
+      port
+    });
+    if (!cleaned) {
+      log.warn?.(
+        `[docdex] ${DEFAULT_HOST}:${port} is still in use after removing the daemon service; skipping daemon startup.`
+      );
+      recordStartupFailure({ reason: "port_in_use", host: DEFAULT_HOST, port });
+      allowDaemon = false;
+    }
+  }
   if (allowDaemon) {
     portState = await resolveDaemonPortState({
       host: DEFAULT_HOST,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docdex",
-  "version": "0.2.35",
+  "version": "0.2.37",
   "mcpName": "io.github.bekirdag/docdex",
   "description": "Local-first documentation and code indexer with HTTP/MCP search, AST, and agent memory.",
   "bin": {
@@ -44,7 +44,7 @@
   },
   "homepage": "https://docdex.org",
   "license": "MIT",
-  "author": "bekir da\u011f",
+  "author": "bekir dağ",
   "keywords": [
     "docdex",
     "documentation",