docdex 0.2.46 → 0.2.48

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.2.48
+- Exclude paid or expensive mcoda agents from automatic local delegation target selection.
+- Document the zero-cost local delegation rule in the packaged agent guidance.
+
+## 0.2.47
+- Bump release metadata to 0.2.47.
+
 ## 0.2.46
 - Bump release metadata to 0.2.46.
 

package/assets/agents.md

@@ -1,4 +1,4 @@
----- START OF DOCDEX INFO V0.2.46 ----
+---- START OF DOCDEX INFO V0.2.48 ----
 Docdex URL: http://127.0.0.1:28491
 Use this base URL for Docdex HTTP endpoints.
 Health check endpoint: `GET /healthz` (not `/v1/health`).
@@ -109,6 +109,7 @@ For mcoda agents, also consider:
 - `max_complexity`: do not assign tasks above this ceiling.
 - `rating`: prefer higher-rated agents for reliability.
 - `cost_per_million`: USD per 1M tokens; prefer lower cost when ratings/complexity match.
+- Automatic local target selection must exclude mcoda agents that are paid (`cost_per_million > 0`) or otherwise matched by `docs/expensive_models.json`, unless the user explicitly overrides the target.
 - `usage`: best-fit role (for example `code_writer` or `code_reviewer`); use this for quick matching.
 - `reasoning_rating`: reasoning score out of 10; prefer higher for complex reasoning tasks.
 - `health_status`: only use agents marked `healthy` (treat `-` as unknown).
@@ -388,7 +389,7 @@ Delegation is mandatory for eligible tasks. If you are expensive and delegation
 - Enforces the product's cost-control policy; skipping delegation is a regression.
 
 1. Determine if you are expensive: load `docs/expensive_models.json` and match your `agent_id`, `agent_slug`, `model`, or adapter type. If you match, continue; if not and you are clearly local/cheap, skip delegation. If unsure, default to expensive.
-2. Check config: Only delegate when `[llm.delegation].enabled` is true or `auto_enable` is true with an eligible local model/agent (and `task_type` is allowed). If uncertain, attempt delegation and handle the error.
+2. Check config: Only delegate when `[llm.delegation].enabled` is true or `auto_enable` is true with an eligible local model/agent (and `task_type` is allowed). For automatic mcoda selection, eligible means healthy and not paid/expensive unless the user explicitly overrides the target. If uncertain, attempt delegation and handle the error.
 3. Choose task type: Use one of `GENERATE_TESTS`, `WRITE_DOCSTRING`, `SCAFFOLD_BOILERPLATE`, `REFACTOR_SIMPLE`, `FORMAT_CODE`.
 4. Call the tool: `docdex_local_completion` with `task_type`, `instruction`, and minimal `context` (smallest necessary snippet).
 5. Validate output: If the local output is invalid or empty, fall back to the primary agent or handle with the paid model.

package/lib/postinstall_setup.js

@@ -2475,8 +2475,27 @@ function registerStartup({ binaryPath, port, repoRoot, logger, distBaseDir, star
   return { ok: false, reason: "unsupported_platform" };
 }
 
-async function startDaemonWithHealthCheck({ binaryPath, port, host, logger, distBaseDir, startNow = true }) {
-  const startup = registerStartup({
+async function startDaemonWithHealthCheck({
+  binaryPath,
+  port,
+  host,
+  logger,
+  distBaseDir,
+  startNow = true,
+  deps
+}) {
+  const helpers = {
+    registerStartup,
+    waitForDaemonHealthy,
+    stopDaemonService,
+    stopDaemonFromLock,
+    stopDaemonByName,
+    clearDaemonLocks
+  };
+  if (deps && typeof deps === "object") {
+    Object.assign(helpers, deps);
+  }
+  const startup = helpers.registerStartup({
     binaryPath,
     port,
     repoRoot: daemonRootPath(),
@@ -2491,16 +2510,18 @@ async function startDaemonWithHealthCheck({ binaryPath, port, host, logger, dist
   if (!startNow) {
     return { ok: true, reason: "registered" };
   }
-  startDaemonService({ logger });
-  const healthy = await waitForDaemonHealthy({ host, port });
+  // `registerStartup(..., startNow: true)` already starts the service on all
+  // supported platforms. Starting it again here can interrupt the first boot
+  // and leave the daemon stuck behind its own lock file.
+  const healthy = await helpers.waitForDaemonHealthy({ host, port });
   if (healthy) {
     return { ok: true, reason: "healthy" };
   }
   logger?.warn?.(`[docdex] daemon failed health check on ${host}:${port}`);
-  stopDaemonService({ logger });
-  stopDaemonFromLock({ logger });
-  stopDaemonByName({ logger });
-  clearDaemonLocks();
+  helpers.stopDaemonService({ logger });
+  helpers.stopDaemonFromLock({ logger });
+  helpers.stopDaemonByName({ logger });
+  helpers.clearDaemonLocks();
   return { ok: false, reason: "health_failed" };
 }
 
@@ -2858,6 +2879,7 @@ module.exports = {
   applyAgentInstructions,
   buildDaemonEnv,
   buildLaunchAgentPlist,
+  startDaemonWithHealthCheck,
   resolveDaemonPortState,
   normalizeVersion
 };

package/package.json

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