docdex 0.2.22 → 0.2.24

package/CHANGELOG.md

@@ -1,17 +1,18 @@
 # Changelog
 
-## 0.2.22
+## Unreleased
+- Remove legacy stdio MCP (`docdexd mcp` / `docdex-mcp-server`); MCP is served only over HTTP/SSE.
+
+## 0.2.23
 - Add Smithery session config schema metadata (titles/descriptions, defaults, example config) for local MCP sessions.
 - Enrich MCP tools with titles, descriptions, parameter descriptions, and annotations to improve Smithery scoring.
 - Expose MCP prompts and resources (with titles/mime types/annotations) for onboarding, incident triage, and refactor planning.
+- Switch web scraping to Chromium-only installs under `~/.docdex/state/bin/chromium/` and remove legacy browser tooling.
 
 ## 0.2.21
 - Prompt for npm updates at CLI start (TTY-only, opt-out via `DOCDEX_UPDATE_CHECK=0`).
-- Export bundled Playwright fetcher for daemon startup (launchd/systemd/schtasks + immediate spawn).
-- Pass `DOCDEX_PLAYWRIGHT_FETCHER` in the npm wrapper when launching the daemon.
 
 ## 0.2.19
-- Playwright issue fix
 - Agents md adding command manually
 - Agents md append repeat fix
 
@@ -38,7 +39,7 @@
 - Publish npm wrapper with the latest MCP-compliant binary.
 
 ## 0.1.5
-- Publish the MCP-enabled CLI wrapper (use `docdex mcp` for MCP clients) and align docs with the new stdio mode.
+- Publish the MCP-enabled CLI wrapper and align docs with MCP mode.
 - Keep npm version in sync with the MCP release for binary downloads.
 
 ## 0.1.4

package/README.md

@@ -1,5 +1,4 @@
 [![Website](https://img.shields.io/badge/website-docdex.org-blue)](https://docdex.org)
-[![smithery badge](https://smithery.ai/badge/bekirdag/docdex)](https://smithery.ai/server/bekirdag/docdex)
 ![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/bekirdag/docdex/release.yml?branch=main)
 ![GitHub License](https://img.shields.io/github/license/bekirdag/docdex)
 ![GitHub Release](https://img.shields.io/github/v/release/bekirdag/docdex)
@@ -55,7 +54,7 @@ npm i -g docdex
 
 ### 2. Auto-Configuration
 
-If you have any of the following clients installed, Docdex automatically configures them to use the local MCP server:
+If you have any of the following clients installed, Docdex automatically configures them to use the local MCP endpoint (daemon HTTP/SSE):
 
 > **Claude Desktop, Cursor, Windsurf, Cline, Roo Code, Continue, VS Code, PearAI, Void, Zed, Codex.**
 
@@ -79,7 +78,7 @@ docdexd index --repo /path/to/my-project
 Start the shared server. This handles HTTP requests and MCP connections.
 
 ```bash
-docdexd daemon --repo /path/to/my-project --host 127.0.0.1 --port 3210
+docdexd daemon --host 127.0.0.1 --port 28491
 
 ```
 
@@ -109,6 +108,8 @@ flowchart LR
 
 ```
 
+Use the daemon HTTP/SSE endpoint.
+
 ### Manual Configuration
 
 If you need to configure your client manually:
@@ -119,7 +120,7 @@ If you need to configure your client manually:
 {
   "mcpServers": {
     "docdex": {
-      "url": "http://localhost:3210/sse"
+      "url": "http://localhost:28491/v1/mcp/sse"
     }
   }
 }
@@ -130,7 +131,7 @@ If you need to configure your client manually:
 
 ```toml
 [mcp_servers]
-docdex = { url = "http://localhost:3210/v1/mcp" }
+docdex = { url = "http://localhost:28491/v1/mcp" }
 
 ```
 
@@ -144,10 +145,10 @@ Don't just find the string "addressGenerator"; find the **definition** and what
 
 ```bash
 # Find definition
-curl "http://127.0.0.1:3210/v1/ast?name=addressGenerator&pathPrefix=src"
+curl "http://127.0.0.1:28491/v1/ast?name=addressGenerator&pathPrefix=src"
 
 # Track downstream impact (what breaks if I change this?)
-curl "http://127.0.0.1:3210/v1/graph/impact?file=src/app.ts&maxDepth=3"
+curl "http://127.0.0.1:28491/v1/graph/impact?file=src/app.ts&maxDepth=3"
 
 ```
 
@@ -182,7 +183,7 @@ Docdex uses Ollama for embeddings and optional local chat.
 * **Manual:** Ensure `nomic-embed-text` is pulled in Ollama (`ollama pull nomic-embed-text`).
 * **Custom URL:**
 ```bash
-DOCDEX_OLLAMA_BASE_URL=http://127.0.0.1:11434 docdexd daemon ...
+DOCDEX_OLLAMA_BASE_URL=http://127.0.0.1:11434 docdexd daemon --host 127.0.0.1 --port 28491
 
 ```
 
@@ -196,23 +197,27 @@ Docdex runs as a local daemon serving:
 
 * **CLI Commands:** `docdexd chat`
 * **HTTP API:** `/search`, `/v1/ast`, `/v1/graph/impact`
-* **MCP Endpoints:** `/v1/mcp` and `/sse`
+* **MCP Endpoints:** `/v1/mcp` and `/v1/mcp/sse`
 
 ### Multi-Repo Setup
 
 Run a single daemon and mount additional repos on demand.
 
 ```bash
-docdexd daemon --repo /path/to/repo-a --port 3210
+docdexd daemon --port 28491
+
+# Mount repos and capture repo_id values
+curl -X POST "http://127.0.0.1:28491/v1/initialize" \
+  -H "Content-Type: application/json" \
+  -d '{"rootUri":"file:///path/to/repo-a"}'
 
-# Mount another repo and capture its repo_id
-curl -X POST "http://127.0.0.1:3210/v1/initialize" \
+curl -X POST "http://127.0.0.1:28491/v1/initialize" \
   -H "Content-Type: application/json" \
   -d '{"rootUri":"file:///path/to/repo-b"}'
 ```
 
 Notes:
-- When more than one repo is mounted, include `x-docdex-repo-id: <sha256>` on HTTP requests.
+- When more than one repo is mounted (or the daemon starts without a default repo), include `x-docdex-repo-id: <sha256>` on HTTP requests.
 - MCP sessions bind to the repo provided in `initialize.rootUri` and reuse that repo automatically.
 
 ### Security
@@ -225,7 +230,6 @@ Notes:
 
 ## 📚 Learn More
 
-* **Smithery:** [View on Smithery.ai](https://smithery.ai/server/@bekirdag/docdex)
 * **Detailed Usage:** `docs/usage.md`
 * **API Reference:** `docs/http_api.md`
 * **MCP Specs:** `docs/mcp/errors.md`

package/assets/agents.md

@@ -1,3 +1,12 @@
+## 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.
+- 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: call HTTP /v1/graph/impact?file=... and account for inbound/outbound deps; 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.
+- Use Docdex tools intentionally: docdex_search/symbols/ast for repo truth; docdex_stats/files/repo_inspect/index for index health.
+- When you do not know something, run docdex_web_research (force_web=true). Web research is encouraged by default for non-repo facts and external APIs.
+
 # Docdex Agent Usage Instructions
 
 > Context for AI Agents: Docdex is your local-first Dual-Lobe Memory and Code Intelligence daemon. Unlike simple vector stores, it provides structural understanding of code (AST/Graph), persistent behavioral profiles (Agent Memory), and gated web enrichment, all strictly scoped to the local machine.
@@ -33,6 +42,7 @@ Docdex v2.1 introduces a strict separation between "facts" and "preferences." Us
 - Content: Your persona, user preferences, coding style, tooling constraints.
 - Example: "Always use Zod for validation," or "User prefers strict TypeScript types."
 - Tools: docdex_save_preference, docdex_get_profile
+- Agent-specific: Each agent should use its own agent_id and store generic self-knowledge (role, tooling, preferences).
 - Usage: Use this to "learn" from corrections. If a user corrects your style, save it here so you do not repeat the mistake in a different repo.
 
 ## Tool Capabilities (MCP & HTTP)
@@ -66,6 +76,17 @@ Precision tools for structural analysis. Do not rely on text search for definiti
 | docdex_save_preference | Store a global user preference (Style, Tooling, Constraint). |
 | docdex_get_profile | Retrieve global preferences. |
 
+## Quick Tool Map (Often Missed)
+
+- docdex_files: List indexed docs with rel_path/doc_id/token_estimate; use to verify indexing coverage.
+- docdex_stats: Show index size, state dir, and last update time.
+- docdex_repo_inspect: Confirm normalized repo root and repo identity mapping.
+- docdex_index: Reindex the full repo or ingest specific files when stale.
+- docdex_search diff: Limit search to working tree, staged, or ref ranges; filter by paths.
+- docdex_web_research knobs: force_web, skip_local_search, repo_only, no_cache, web_limit, llm_filter_local_results, llm_model.
+- HTTP /v1/initialize: Bind a default repo root for MCP when clients omit project_root.
+- HTTP /v1/dag/export: Export the dependency graph for external analysis.
+
 ## Interaction Patterns
 
 ### 1. Reasoning Workflow
@@ -93,6 +114,21 @@ If the user asks: "Safe to delete getUser?"
 - Action: Call GET /v1/graph/impact?file=src/user.ts
 - Output: Analyze the inbound edges. If the list is not empty, it is unsafe.
 
+### 4. Non-Repo Real-World Queries (Web First)
+
+If the user asks a non-repo, real-world question (weather, news, general facts), immediately call docdex_web_research with force_web=true.
+- Resolve relative dates ("yesterday", "last week") using system time by default.
+- Do not run docdex_search unless the user explicitly wants repo-local context.
+- Assume web access is allowed unless the user forbids it; if the web call fails, report the failure and ask for a source or permission.
+
+### 5. Failure Handling (Missing Results or Errors)
+
+- Ensure project_root or repo_path is set, or call /v1/initialize to bind a default root.
+- Use docdex_repo_inspect to confirm repo identity and normalized root.
+- Use docdex_stats and docdex_files to check whether the index exists and contains files.
+- Reindex with docdex_index (or docdexd index) if the index is stale or empty.
+- Add a repo-local .docdexignore for large generated artifacts or local caches when indexing is slow.
+
 ## Operational Context
 
 ### Repository Identification

package/bin/docdex.js

@@ -29,6 +29,12 @@ function printLines(lines, { stderr } = {}) {
   }
 }
 
+function envBool(value) {
+  if (!value) return false;
+  const normalized = String(value).trim().toLowerCase();
+  return ["1", "true", "t", "yes", "y", "on"].includes(normalized);
+}
+
 function readInstallMetadata({ fsModule, pathModule, basePath }) {
   if (!fsModule || typeof fsModule.readFileSync !== "function") return null;
   const metadataPath = pathModule.join(basePath, "docdexd-install.json");
@@ -178,10 +184,6 @@ async function run() {
     basePath,
     process.platform === "win32" ? "docdexd.exe" : "docdexd"
   );
-  const mcpBinaryPath = path.join(
-    basePath,
-    process.platform === "win32" ? "docdex-mcp-server.exe" : "docdex-mcp-server"
-  );
 
   if (!fs.existsSync(binaryPath)) {
     console.error(`[docdex] Missing binary for ${platformKey}. Try reinstalling or set DOCDEX_DOWNLOAD_REPO to a repo with release assets.`);
@@ -202,13 +204,6 @@ async function run() {
   });
 
   const env = { ...process.env };
-  if (!env.DOCDEX_MCP_SERVER_BIN && fs.existsSync(mcpBinaryPath)) {
-    env.DOCDEX_MCP_SERVER_BIN = mcpBinaryPath;
-  }
-  const fetcherPath = path.join(__dirname, "..", "lib", "playwright_fetch.js");
-  if (!env.DOCDEX_PLAYWRIGHT_FETCHER && fs.existsSync(fetcherPath)) {
-    env.DOCDEX_PLAYWRIGHT_FETCHER = fetcherPath;
-  }
   const child = spawn(binaryPath, process.argv.slice(2), { stdio: "inherit", env });
   child.on("exit", (code) => process.exit(code ?? 1));
   child.on("error", (err) => {

package/lib/install.js

@@ -8,7 +8,7 @@ const os = require("node:os");
 const path = require("node:path");
 const { pipeline } = require("node:stream/promises");
 const crypto = require("node:crypto");
-const { spawn, spawnSync } = require("node:child_process");
+const { spawn } = require("node:child_process");
 
 const pkg = require("../package.json");
 const {
@@ -41,8 +41,6 @@ const DEFAULT_INTEGRITY_CONFIG = Object.freeze({
 const LOCAL_FALLBACK_ENV = "DOCDEX_LOCAL_FALLBACK";
 const LOCAL_BINARY_ENV = "DOCDEX_LOCAL_BINARY";
 const AGENTS_DOC_FILENAME = "agents.md";
-const PLAYWRIGHT_INSTALL_GUARD = "DOCDEX_INTERNAL_PLAYWRIGHT_INSTALL";
-const PLAYWRIGHT_SKIP_ENV = "DOCDEX_SKIP_PLAYWRIGHT_DEP_INSTALL";
 
 const EXIT_CODE_BY_ERROR_CODE = Object.freeze({
   DOCDEX_INSTALLER_CONFIG: 2,
@@ -232,60 +230,6 @@ function writeAgentInstructions() {
   }
 }
 
-function resolvePlaywrightPackage() {
-  const baseDir = path.join(__dirname, "..");
-  try {
-    return require.resolve("playwright/package.json", { paths: [baseDir] });
-  } catch {}
-  try {
-    return require.resolve("playwright/package.json");
-  } catch {}
-  return null;
-}
-
-function resolveNpmCommand() {
-  const npmExec = process.env.npm_execpath;
-  if (npmExec) {
-    return { cmd: process.execPath, args: [npmExec] };
-  }
-  const npmCmd = process.platform === "win32" ? "npm.cmd" : "npm";
-  return { cmd: npmCmd, args: [] };
-}
-
-function ensurePlaywrightDependency({ logger = console } = {}) {
-  if (process.env[PLAYWRIGHT_SKIP_ENV]) return;
-  if (process.env[PLAYWRIGHT_INSTALL_GUARD]) return;
-  if (resolvePlaywrightPackage()) return;
-
-  const rootDir = path.join(__dirname, "..");
-  const { cmd, args } = resolveNpmCommand();
-  const installArgs = args.concat([
-    "install",
-    "--no-save",
-    "--ignore-scripts",
-    "--no-package-lock",
-    "--no-audit",
-    "--no-fund",
-    "playwright"
-  ]);
-  const result = spawnSync(cmd, installArgs, {
-    cwd: rootDir,
-    stdio: "inherit",
-    env: {
-      ...process.env,
-      [PLAYWRIGHT_INSTALL_GUARD]: "1"
-    }
-  });
-  if (result.error || (typeof result.status === "number" && result.status !== 0)) {
-    const message = result.error?.message || `npm exit status ${result.status}`;
-    logger.warn?.(`[docdex] Playwright dependency install failed: ${message}`);
-    return;
-  }
-  if (!resolvePlaywrightPackage()) {
-    logger.warn?.("[docdex] Playwright dependency still missing after install attempt");
-  }
-}
-
 function selectHttpClient(url) {
   try {
     const protocol = new URL(url).protocol;
@@ -577,13 +521,16 @@ function isLocalInstallRequest({ env, pathModule }) {
   return argv.some((arg) => isLikelyLocalInstallArg(arg, pathModule));
 }
 
-function shouldPreferLocalInstall({ env, localBinaryPath, pathModule }) {
+function shouldPreferLocalInstall({ env, localBinaryPath, pathModule, localRepoRoot }) {
   if (!localBinaryPath) return false;
   if (parseEnvBool(env?.[LOCAL_FALLBACK_ENV]) === false) return false;
   if (env?.[LOCAL_BINARY_ENV]) return true;
-  if (!env?.INIT_CWD) return false;
   if (env?.npm_lifecycle_event !== "postinstall") return false;
-  return isLocalInstallRequest({ env, pathModule });
+  if (isLocalInstallRequest({ env, pathModule })) return true;
+  if (!env?.INIT_CWD || !localRepoRoot) return false;
+  const initCwd = pathModule.resolve(env.INIT_CWD);
+  const repoRoot = pathModule.resolve(localRepoRoot);
+  return initCwd === repoRoot || initCwd.startsWith(`${repoRoot}${pathModule.sep}`);
 }
 
 function resolveLocalBinaryCandidate({
@@ -599,35 +546,16 @@ function resolveLocalBinaryCandidate({
     if (fsModule.existsSync(resolved)) return resolved;
   }
   const isWin32 = platform === "win32";
-  const mcpName = isWin32 ? "docdex-mcp-server.exe" : "docdex-mcp-server";
   const root = repoRoot || detectLocalRepoRoot({ pathModule, fsModule });
   if (!root) return null;
   const binaryName = platform === "win32" ? "docdexd.exe" : "docdexd";
   const releasePath = pathModule.join(root, "target", "release", binaryName);
-  if (fsModule.existsSync(releasePath)) {
-    if (localMcpPresent({ fsModule, pathModule, binaryPath: releasePath, mcpName })) {
-      return releasePath;
-    }
-  }
+  if (fsModule.existsSync(releasePath)) return releasePath;
   const debugPath = pathModule.join(root, "target", "debug", binaryName);
-  if (fsModule.existsSync(debugPath)) {
-    if (localMcpPresent({ fsModule, pathModule, binaryPath: debugPath, mcpName })) {
-      return debugPath;
-    }
-  }
+  if (fsModule.existsSync(debugPath)) return debugPath;
   return null;
 }
 
-function localMcpPresent({ fsModule, pathModule, binaryPath, mcpName }) {
-  const dir = pathModule.dirname(binaryPath);
-  const candidates = [
-    pathModule.join(dir, mcpName),
-    pathModule.join(pathModule.dirname(dir), "release", mcpName),
-    pathModule.join(pathModule.dirname(dir), "debug", mcpName)
-  ];
-  return candidates.some((candidate) => fsModule.existsSync(candidate));
-}
-
 async function installFromLocalBinary({
   fsModule,
   pathModule,
@@ -650,22 +578,6 @@ async function installFromLocalBinary({
   if (!isWin32) {
     await fsModule.promises.chmod(destPath, 0o755).catch(() => {});
   }
-  const mcpName = isWin32 ? "docdex-mcp-server.exe" : "docdex-mcp-server";
-  const mcpCandidates = [
-    pathModule.join(pathModule.dirname(binaryPath), mcpName),
-    pathModule.join(pathModule.dirname(pathModule.dirname(binaryPath)), "release", mcpName),
-    pathModule.join(pathModule.dirname(pathModule.dirname(binaryPath)), "debug", mcpName)
-  ];
-  const mcpSource = mcpCandidates.find((candidate) => fsModule.existsSync(candidate));
-  if (mcpSource) {
-    const mcpDest = pathModule.join(distDir, mcpName);
-    await fsModule.promises.copyFile(mcpSource, mcpDest);
-    if (!isWin32) {
-      await fsModule.promises.chmod(mcpDest, 0o755).catch(() => {});
-    }
-  } else {
-    logger?.warn?.(`[docdex] local MCP binary not found; expected near ${binaryPath}`);
-  }
   const binarySha256 = await sha256FileFn(destPath);
   const metadata = {
     schemaVersion: INSTALL_METADATA_SCHEMA_VERSION,
@@ -718,7 +630,13 @@ async function maybeInstallLocalFallback({
 
   const candidate =
     localBinaryPath ||
-    resolveLocalBinaryCandidate({ env, platform: process.platform, pathModule, fsModule, repoRoot: localRepoRoot });
+    resolveLocalBinaryCandidate({
+      env,
+      platform: process.platform,
+      pathModule,
+      fsModule,
+      repoRoot: localRepoRoot
+    });
   if (!candidate) return null;
 
   return installFromLocalBinary({
@@ -1074,9 +992,6 @@ function decideInstallAction({
   integrityResult
 }) {
   if (!discoveredInstalledState?.binaryPresent) return { outcome: "update", reason: "binary_missing" };
-  if (discoveredInstalledState.mcpBinaryPresent === false) {
-    return { outcome: "update", reason: "mcp_binary_missing" };
-  }
 
   if (discoveredInstalledState.metadataStatus !== "valid") {
     return {
@@ -1111,10 +1026,6 @@ function decideInstallAction({
 
 async function discoverInstalledState({ fsModule, pathModule, distDir, platformKey, isWin32 }) {
   const binaryPath = pathModule.join(distDir, isWin32 ? "docdexd.exe" : "docdexd");
-  const mcpBinaryPath = pathModule.join(
-    distDir,
-    isWin32 ? "docdex-mcp-server.exe" : "docdex-mcp-server"
-  );
   const metadataPath = installMetadataPath(distDir, pathModule);
 
   const existsSync = typeof fsModule?.existsSync === "function" ? fsModule.existsSync.bind(fsModule) : null;
@@ -1123,7 +1034,6 @@ async function discoverInstalledState({ fsModule, pathModule, distDir, platformK
       binaryPath,
       metadataPath,
       binaryPresent: false,
-      mcpBinaryPresent: false,
       installedVersion: null,
       metadata: null,
       metadataStatus: "unavailable",
@@ -1137,7 +1047,6 @@ async function discoverInstalledState({ fsModule, pathModule, distDir, platformK
       binaryPath,
       metadataPath,
       binaryPresent: false,
-      mcpBinaryPresent: false,
       installedVersion: null,
       metadata: null,
       metadataStatus: "missing",
@@ -1146,13 +1055,11 @@ async function discoverInstalledState({ fsModule, pathModule, distDir, platformK
     };
   }
 
-  const mcpBinaryPresent = existsSync(mcpBinaryPath);
   const metaResult = await readJsonFileIfPossible({ fsModule, filePath: metadataPath });
   const meta = metaResult.value;
   if (!isValidInstallMetadata(meta)) {
     return {
       binaryPath,
-      mcpBinaryPresent,
       metadataPath,
       binaryPresent: true,
       installedVersion: typeof meta?.version === "string" ? meta.version : null,
@@ -1175,7 +1082,6 @@ async function discoverInstalledState({ fsModule, pathModule, distDir, platformK
 
   return {
     binaryPath,
-    mcpBinaryPresent,
     metadataPath,
     binaryPresent: true,
     installedVersion: meta.version,
@@ -1249,7 +1155,6 @@ async function determineLocalInstallerOutcome({
 
   const shouldVerifyIntegrity =
     discoveredInstalledState.binaryPresent &&
-    discoveredInstalledState.mcpBinaryPresent !== false &&
     !discoveredInstalledState.platformMismatch &&
     discoveredInstalledState.installedVersion === expectedVersion &&
     (normalizeSha256Hex(expectedBinarySha256) || discoveredInstalledState.metadataStatus === "valid");
@@ -1805,6 +1710,7 @@ async function runInstaller(options) {
   });
 
   const priorRunnable = existsSync ? existsSync(local.binaryPath) : false;
+  const preferLocal = shouldPreferLocalInstall({ env, localBinaryPath, pathModule, localRepoRoot });
 
   const forceLocalBinary = Boolean(env?.[LOCAL_BINARY_ENV]);
   if (forceLocalBinary && localBinaryPath) {
@@ -1825,6 +1731,24 @@ async function runInstaller(options) {
     return localInstall;
   }
 
+  if (preferLocal) {
+    const localInstall = await installFromLocalBinary({
+      fsModule,
+      pathModule,
+      distDir,
+      binaryPath: localBinaryPath,
+      isWin32,
+      version,
+      platformKey,
+      targetTriple,
+      repoSlug: null,
+      sha256FileFn,
+      writeJsonFileAtomicFn,
+      logger
+    });
+    return localInstall;
+  }
+
   if (local.outcome === "no-op") {
     logger.log("[docdex] Install outcome: no-op");
     await cleanupInstallArtifacts({
@@ -1853,24 +1777,6 @@ async function runInstaller(options) {
     };
   }
 
-  if (shouldPreferLocalInstall({ env, localBinaryPath, pathModule })) {
-    const localInstall = await installFromLocalBinary({
-      fsModule,
-      pathModule,
-      distDir,
-      binaryPath: localBinaryPath,
-      isWin32,
-      version,
-      platformKey,
-      targetTriple,
-      repoSlug: null,
-      sha256FileFn,
-      writeJsonFileAtomicFn,
-      logger
-    });
-    return localInstall;
-  }
-
   let repoSlug = null;
   let archive;
   let expectedSha256;
@@ -2189,18 +2095,14 @@ async function main() {
   try {
     await runPostInstallSetup({ binaryPath: result?.binaryPath });
   } catch (err) {
-    console.warn(`[docdex] postinstall setup skipped: ${err?.message || err}`);
+    console.warn(`[docdex] postinstall setup failed: ${err?.message || err}`);
+    throw err;
   }
   try {
     writeAgentInstructions();
   } catch (err) {
     console.warn(`[docdex] agent instructions skipped: ${err?.message || err}`);
   }
-  try {
-    ensurePlaywrightDependency();
-  } catch (err) {
-    console.warn(`[docdex] playwright dependency check skipped: ${err?.message || err}`);
-  }
   printPostInstallBanner();
 }
 
@@ -2230,7 +2132,7 @@ function printPostInstallBanner() {
     "\x1b[32mDocdex installed successfully!\x1b[0m",
     "\x1b[41m\x1b[97m IMPORTANT \x1b[0m \x1b[33mNext step:\x1b[0m run \x1b[32m`docdex setup`\x1b[0m to complete the installation.",
     "\x1b[33mSetup:\x1b[0m configures Ollama/models + browser.",
-    "\x1b[34mTip:\x1b[0m after setup, start the daemon with \x1b[36m`docdexd serve --repo <path>`\x1b[0m"
+    "\x1b[34mTip:\x1b[0m after setup, the daemon should auto-start; if not, run \x1b[36m`docdexd daemon`\x1b[0m"
   ];
   width = Math.max(72, content.reduce((max, line) => Math.max(max, stripAnsi(line).length), 0));
   const padLine = (text) => {