docdex 0.2.31 → 0.2.33

package/CHANGELOG.md

@@ -1,10 +1,9 @@
 # Changelog
 
-## Unreleased
-- Remove legacy stdio MCP (`docdexd mcp` / `docdex-mcp-server`); MCP is served only over HTTP/SSE.
-- Ensure npm tarballs include CLI wrapper entrypoints and restore missing wrappers during postinstall.
-- Retry Windows file operations during install to reduce EPERM/EACCES failures.
-- Nightly HTTP soak waits for index readiness before load testing.
+## 0.2.33
+- Warn Windows users to install the VC++ 2015-2022 runtime in the npm README.
+- Ensure `docdex setup` detects the default Ollama install path on Windows.
+- Document the Windows default Chromium auto-install location.
 
 ## 0.2.23
 - Add Smithery session config schema metadata (titles/descriptions, defaults, example config) for local MCP sessions.

package/README.md

@@ -51,6 +51,12 @@ npm i -g docdex
 
 ```
 
+> [!WARNING]
+> **Windows requirement:** Docdex uses the MSVC runtime. Install the **Microsoft Visual C++ Redistributable 2015-2022 (x64)** before running `docdex`/`docdexd`.
+> - Winget: `winget install --id Microsoft.VCRedist.2015+.x64`
+> - Manual: download `vc_redist.x64.exe` from Microsoft: https://aka.ms/vs/17/release/vc_redist.x64.exe
+> - If `docdexd` exits with `0xC0000135`, the runtime is missing.
+
 ### 2. Auto-Configuration
 
 If you have any of the following clients installed, Docdex automatically configures them to use the local MCP endpoint (daemon HTTP/SSE):

package/assets/agents.md

@@ -1,4 +1,4 @@
----- START OF DOCDEX INFO V0.2.31 ----
+---- START OF DOCDEX INFO V0.2.33 ----
 Docdex URL: http://127.0.0.1:28491
 Use this base URL for Docdex HTTP endpoints.
 Health check endpoint: `GET /healthz` (not `/v1/health`).

package/bin/docdex.js

@@ -22,6 +22,10 @@ function isDoctorCommand(argv) {
   return sub === "doctor" || sub === "diagnostics";
 }
 
+function isVersionCommand(argv) {
+  return argv.includes("--version") || argv.includes("-V");
+}
+
 function printLines(lines, { stderr } = {}) {
   for (const line of lines) {
     if (!line) continue;
@@ -207,7 +211,7 @@ async function run() {
     return;
   }
 
-  const { binaryPath } = resolveInstallPaths(platformKey);
+  const { binaryPath, basePath } = resolveInstallPaths(platformKey);
 
   if (!fs.existsSync(binaryPath)) {
     console.error(`[docdex] Missing binary for ${platformKey}. Try reinstalling or set DOCDEX_DOWNLOAD_REPO to a repo with release assets.`);
@@ -219,6 +223,14 @@ async function run() {
     return;
   }
 
+  if (isVersionCommand(argv)) {
+    const installMeta = readInstallMetadata({ fsModule: fs, pathModule: path, basePath });
+    const version = installMeta?.version || pkg.version;
+    console.log(`docdexd ${version}`);
+    process.exit(0);
+    return;
+  }
+
   await checkForUpdateOnce({
     currentVersion: pkg.version,
     env: process.env,

package/lib/cli_entry.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 "use strict";
 
 const fs = require("node:fs");
@@ -21,6 +22,10 @@ function isDoctorCommand(argv) {
   return sub === "doctor" || sub === "diagnostics";
 }
 
+function isVersionCommand(argv) {
+  return argv.includes("--version") || argv.includes("-V");
+}
+
 function printLines(lines, { stderr } = {}) {
   for (const line of lines) {
     if (!line) continue;
@@ -206,7 +211,7 @@ async function run() {
     return;
   }
 
-  const { binaryPath } = resolveInstallPaths(platformKey);
+  const { binaryPath, basePath } = resolveInstallPaths(platformKey);
 
   if (!fs.existsSync(binaryPath)) {
     console.error(`[docdex] Missing binary for ${platformKey}. Try reinstalling or set DOCDEX_DOWNLOAD_REPO to a repo with release assets.`);
@@ -218,6 +223,14 @@ async function run() {
     return;
   }
 
+  if (isVersionCommand(argv)) {
+    const installMeta = readInstallMetadata({ fsModule: fs, pathModule: path, basePath });
+    const version = installMeta?.version || pkg.version;
+    console.log(`docdexd ${version}`);
+    process.exit(0);
+    return;
+  }
+
   await checkForUpdateOnce({
     currentVersion: pkg.version,
     env: process.env,

package/lib/install.js

@@ -57,7 +57,7 @@ const MCP_STDIO_WRAPPER_SCRIPT = [
   "",
   "async function main() {",
   "  try {",
-  "    await runBridge({ stdin: process.stdin, stdout: process.stdout, stderr: process.stderr });",
+    "    await runBridge({ stdin: process.stdin, stdout: process.stdout, stderr: process.stderr });",
   "  } catch (err) {",
   "    process.stderr.write(`[docdex-mcp-stdio] fatal: ${err}\\n`);",
   "    process.exit(1);",

package/lib/mcp_stdio_cli.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+"use strict";
+
+const { runBridge } = require("./mcp_stdio_bridge");
+
+async function main() {
+  try {
+    await runBridge({ stdin: process.stdin, stdout: process.stdout, stderr: process.stderr });
+  } catch (err) {
+    process.stderr.write(`[docdex-mcp-stdio] fatal: ${err}\n`);
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "docdex",
-  "version": "0.2.31",
+  "version": "0.2.33",
   "mcpName": "io.github.bekirdag/docdex",
   "description": "Local-first documentation and code indexer with HTTP/MCP search, AST, and agent memory.",
   "bin": {
-    "docdex": "bin/docdex.js",
-    "docdexd": "bin/docdex.js",
-    "docdex-mcp-stdio": "bin/docdex-mcp-stdio.js"
+    "docdex": "lib/cli_entry.js",
+    "docdexd": "lib/cli_entry.js",
+    "docdex-mcp-stdio": "lib/mcp_stdio_cli.js"
   },
   "files": [
     "bin",