docdex 0.2.40 → 0.2.42

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.2.42
+- Bump release metadata to 0.2.42.
+
+## 0.2.41
+- Improve Windows npm postinstall UX with a plain setup hint, npm lifecycle non-interactive detection, and no empty cmd window from immediate daemon start.
+- Fix setup TUI menu selection highlighting on Windows terminals.
+- Propagate DAG session IDs in docs so `docdex_dag_export` is called with the `dag_session_id` from search results.
+
 ## 0.2.39
 - Bump release metadata to 0.2.39.
 

package/assets/agents.md

@@ -1,4 +1,4 @@
----- START OF DOCDEX INFO V0.2.40 ----
+---- START OF DOCDEX INFO V0.2.42 ----
 Docdex URL: http://127.0.0.1:28491
 Use this base URL for Docdex HTTP endpoints.
 Health check endpoint: `GET /healthz` (not `/v1/health`).
@@ -246,6 +246,8 @@ Query params:
 - `format` (optional: json/text/dot; default json)
 - `max_nodes` (optional)
 - `repo_id` (required when multiple repos are mounted)
+Notes:
+- Use the `dag_session_id` from `/search` responses (or MCP `docdex_search`/`docdex_web_research`) as the `session_id`. `dag_session_id` is accepted as an alias.
 
 ### 7) MCP over HTTP/SSE
 
@@ -270,7 +272,7 @@ Do not guess fields; use these canonical shapes.
 - `docdex_ast`: `{ project_root, path, max_nodes? }`
 - `docdex_impact_diagnostics`: `{ project_root, file? }`
 - `docdex_impact_graph`: `{ project_root, file, max_edges?, max_depth?, edge_types? }`
-- `docdex_dag_export`: `{ project_root, session_id, format?, max_nodes? }`
+- `docdex_dag_export`: `{ project_root, session_id|dag_session_id, format?, max_nodes? }`
 - `docdex_memory_save`: `{ project_root, text }`
 - `docdex_memory_recall`: `{ project_root, query, top_k? }`
 - `docdex_get_profile`: `{ agent_id }`

package/lib/install.js

@@ -2294,6 +2294,16 @@ function printPostInstallBanner() {
       return false;
     }
   };
+  if (process.platform === "win32") {
+    const plain = [
+      "[docdex] Docdex installed successfully.",
+      "[docdex] Next step: run `docdex setup` to complete the installation.",
+      "[docdex] Setup configures Ollama/models + browser."
+    ].join("\r\n") + "\r\n";
+    if (!writeDirect(plain)) {
+      writeStderr(plain);
+    }
+  }
   let width = 0;
   const content = [
     "\x1b[31m      _               _           \x1b[0m",

package/lib/postinstall_setup.js

@@ -2472,7 +2472,11 @@ function startupFailureReported() {
 }
 
 function isNpmLifecycle(env = process.env) {
-  return Boolean(env?.npm_lifecycle_event);
+  if (env?.npm_lifecycle_event) return true;
+  const userAgent = String(env?.npm_config_user_agent || "");
+  if (userAgent.includes("npm/")) return true;
+  if (env?.npm_execpath) return true;
+  return false;
 }
 
 function shouldSkipDaemonSideEffects({ env = process.env, skipDaemon } = {}) {
@@ -2590,6 +2594,9 @@ function launchSetupWizard({
   }
 
   if (platform === "win32") {
+    if (!canPrompt(stdin, stdout)) {
+      return { ok: false, reason: "non_interactive" };
+    }
     const runnerPath = writeWindowsSetupRunner({
       binaryPath,
       args,
@@ -2616,6 +2623,7 @@ function launchSetupWizard({
 async function runPostInstallSetup({ binaryPath, logger, env, skipDaemon, distBaseDir } = {}) {
   const log = logger || console;
   const effectiveEnv = env || process.env;
+  const isNpm = isNpmLifecycle(effectiveEnv);
   const distCandidates = resolveDistBaseCandidates({ env: effectiveEnv });
   const resolvedDistBaseDir = distBaseDir || resolveDistBaseDir({ env: effectiveEnv, fsModule: fs });
   let allowDaemon = !shouldSkipDaemonSideEffects({ env: effectiveEnv, skipDaemon });
@@ -2699,13 +2707,14 @@ async function runPostInstallSetup({ binaryPath, logger, env, skipDaemon, distBa
   }
   let startupOk = false;
   if (allowDaemon) {
+    const allowStartNow = !(process.platform === "win32" && isNpm);
     const result = await startDaemonWithHealthCheck({
       binaryPath: startupBinaries.binaryPath,
       port,
       host: DEFAULT_HOST,
       logger: log,
       distBaseDir: resolvedDistBaseDir,
-      startNow: !reuseExisting
+      startNow: !reuseExisting && allowStartNow
     });
     if (!result.ok) {
       log.warn?.(`[docdex] daemon failed to start on ${DEFAULT_HOST}:${port}.`);
@@ -2750,7 +2759,7 @@ async function runPostInstallSetup({ binaryPath, logger, env, skipDaemon, distBa
     clearStartupFailure();
   }
   const skipExplicit = shouldSkipSetup(effectiveEnv);
-  const skipWizard = isNpmLifecycle(effectiveEnv) || skipExplicit;
+  const skipWizard = isNpm || skipExplicit;
   const setupLaunch = skipWizard
     ? { ok: false, reason: skipExplicit ? "skipped" : "npm_lifecycle" }
     : launchSetupWizard({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docdex",
-  "version": "0.2.40",
+  "version": "0.2.42",
   "mcpName": "io.github.bekirdag/docdex",
   "description": "Local-first documentation and code indexer with HTTP/MCP search, AST, and agent memory.",
   "bin": {