token-pilot 0.42.3 → 0.43.1

package/.claude-plugin/marketplace.json

@@ -5,15 +5,15 @@
     "email": "shahinyanm@gmail.com"
   },
   "metadata": {
-    "description": "Token Pilot \u2014 save 60-90% tokens when AI reads code",
-    "version": "0.42.3"
+    "description": "Token Pilot — save 60-90% tokens when AI reads code",
+    "version": "0.43.1"
   },
   "plugins": [
     {
       "name": "token-pilot",
       "source": "./",
-      "description": "Reduces token consumption by 60-90% via AST-aware lazy file reading, structural symbol navigation, and cross-session tool-usage analytics. 22 MCP tools + 19 subagents + budget watchdog hooks.",
-      "version": "0.42.3",
+      "description": "Reduces token consumption by 60-90% via AST-aware lazy file reading, structural symbol navigation, and cross-session tool-usage analytics. 23 MCP tools + 25 subagents + budget watchdog hooks.",
+      "version": "0.43.1",
       "author": {
         "name": "Digital-Threads"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "token-pilot",
-  "version": "0.42.3",
+  "version": "0.43.1",
   "description": "Saves 60-90% tokens on AI code reading. AST-aware lazy reads, symbol navigation, find_usages, structural git diff/log, edit-safety guard, Task-routing matcher, cross-session telemetry (errors + diagnostics), 25 tp-* subagents tiered to haiku/sonnet/opus with budget watchdog.",
   "author": {
     "name": "Digital-Threads",
@@ -21,7 +21,9 @@
   "mcpServers": {
     "token-pilot": {
       "command": "sh",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/start.sh"]
+      "args": [
+        "${CLAUDE_PLUGIN_ROOT}/start.sh"
+      ]
     }
   }
 }

package/CHANGELOG.md

@@ -5,6 +5,115 @@ All notable changes to Token Pilot will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.43.1] - 2026-06-06
+
+### Fixed — `@ast-index/cli` floor raised to `^3.44.0`
+
+`module_route` (0.43.0) needs the ast-index `module-route` command, which
+exists only in ast-index 3.44+. The floor was `^3.38.0`, so an install
+resolving ast-index below 3.44 would have `module_route` fail. No API change.
+
+## [0.43.0] - 2026-06-06
+
+Bundled release: everything actionable from **ast-index 3.41→3.45** and
+**Claude Code 2.1.163→2.1.167**, plus a statusline fix.
+
+### Added — `module_route` MCP tool (ast-index 3.44)
+
+New tool wrapping ast-index's `module-route` command: the transitive
+dependency path(s) between two modules. Answers "how does module A reach
+module B through the import graph?", traces coupling, and can emit a
+dependency diagram.
+
+- `from` / `to` (required), plus `all`, `maxPaths` (≤200), `maxDepth`
+  (≤50), `viaKind` (`api`/`implementation`/`all`), `format`
+  (`text`/`json`/`mermaid`/`dot`).
+- Machine formats (json/mermaid/dot) pass through clean — no header that
+  would corrupt a diagram/parse. Text format gets a `MODULE ROUTE: a → b`
+  header.
+- Empty output explains both causes (modules unrelated **or** the
+  module-dependency graph isn't indexed — `ast-index rebuild`).
+- Full-profile only (not in nav/edit/minimal sets) — a specialised
+  analysis tool, like the audit tools.
+- `exec` already sets `AST_INDEX_WALK_UP=1`, so the route resolves from a
+  monorepo subdir without passing `--walk-up`.
+
+### Fixed — statusline now counts MCP-tool savings, not just hook denials
+
+The badge summed only `hook-events.jsonl` (`savedTokens` from intercepted
+raw `Read`/`Grep`). The larger share — savings from the MCP tools
+themselves (`smart_read`, `outline`, `find_usages`, …) — lives in
+`tool-calls.jsonl` and was **invisible** to the badge, so the displayed
+figure undercounted real savings (often by an order of magnitude).
+
+Two changes fix it:
+
+- The MCP server now stamps every `tool-calls.jsonl` row with the real
+  Claude Code session id, read from `CLAUDE_CODE_SESSION_ID` (exported to
+  child processes; verified against the 2.1.167 bundle — the same value
+  the hooks receive and the statusline payload carries). Previously these
+  rows had an empty `session_id`, so they could not be attributed to a
+  session at all.
+- The statusline sums **both** logs: `hook-events.jsonl` `savedTokens`
+  plus `tool-calls.jsonl` (`tokensWouldBe − tokensReturned`), each split
+  into the current session and the project total. Zero/negative deltas
+  (pass-throughs) are ignored.
+
+### Added — statusline Claude.ai rate limits (CC 2.1.80+)
+
+The badge now appends `5h:42% 7d:13%` when the statusline payload carries
+`rate_limits` (subscribers only, after the first API response). Schema
+verified against the 2.1.167 bundle: `rate_limits.five_hour.used_percentage`
+and `rate_limits.seven_day.used_percentage`. Unlike the cumulative token
+total, these numbers move every turn — the badge finally shows something
+live. Parsed with `sed` (no `jq` dependency) and whitelisted to digits.
+
+### Fixed — statusline bare `[TP]` in monorepos / subdirs / worktrees
+
+The badge resolved the events log only at the exact `cwd` from the
+payload. In a monorepo (or worktree, or any session `cd`'d into a
+subpackage) the `.token-pilot/` dir is at the repo root, so the lookup
+failed and rendered a bare `[TP]` with no token count. The script now
+**walks up** to the nearest ancestor with `.token-pilot/` (bounded to 40
+levels), the same way git finds `.git`.
+
+### Changed — statusline shows session + project savings (`s:12.3k · 172.6k`)
+
+The badge now renders **both** the current session's saved tokens (the
+number you watch climb during a run) and the cumulative project total,
+e.g. `[TP s:12.3k · 172.6k]`. A fresh session that hasn't saved anything
+yet falls back to the project total alone (never an empty badge after
+first use). Numbers render with one decimal (`172.6k`, not `172k`) so a
+single turn's ~100-token savings is visible on each render — whole-`k`
+rounding previously made the figure look frozen.
+
+### Added — `effort: low` on the bundled skills (CC 2.1.16x)
+
+`guide` / `install` / `stats` declare `effort: low` — they render static
+output or run one CLI call, so they don't need a high-effort model.
+Faster and cheaper when invoked.
+
+### Notes — Claude Code 2.1.16x integration (no code change required)
+
+- **`additionalContext` no longer dropped on a failed tool call** — our
+  PreToolUse routing guidance now survives a failed call (we benefit
+  automatically).
+- **`SubagentStop` input gained `background_tasks` / `session_crons`** —
+  available to our subagent-stop hook for future budget feedback.
+- **Glob deny rules (`"*"` denies all tools)** — usable as a second
+  enforcement layer on top of our deny hooks for stricter TP adoption.
+
+### Deferred — `MessageDisplay` hook (researched, not shipped)
+
+CC's new `MessageDisplay` hook transforms assistant text *as displayed*.
+Deliberately NOT wired this release: (1) the output contract (the field
+that returns replacement text) is not confirmable from the minified
+2.1.167 bundle — and our rule is never to ship an unverified CC field
+beside working hooks; (2) it is display-only, so it saves no input or
+output tokens (the text is already generated and already in context).
+That is caveman's cosmetic-output domain, not token-pilot's input domain.
+Revisit once a live MessageDisplay payload pins the contract.
+
 ## [0.30.0] - 2026-04-19
 
 ### Added — `minimal` profile (5 tools, near-zero overhead)

package/README.md

@@ -43,7 +43,7 @@ Creates (or merges into) `.mcp.json` with `token-pilot` + [`context-mode`](https
 
 ## What You Get
 
-- **22 MCP tools** — structural reads, symbol search, git analysis, session analytics → [tools reference](docs/tools.md)
+- **23 MCP tools** — structural reads, symbol search, git analysis, module routing, session analytics → [tools reference](docs/tools.md)
 - **PreToolUse hooks** — block heavy `Grep`/`Bash`/`Read` calls; redirect to efficient alternatives → [hooks & modes](docs/hooks.md)
 - **25 `tp-*` subagents** (Claude Code only) — MCP-first delegates with haiku/sonnet model tiers and budget enforcement → [agents reference](docs/agents.md)
 - **Tool profiles** — trim advertised `tools/list` to save ~2 k tokens per session → [profiles & config](docs/configuration.md)

package/agents/tp-api-surface-tracker.md

@@ -9,7 +9,7 @@ tools:
   - mcp__token-pilot__read_symbol
   - Bash
 model: haiku
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: dd184501203fa7f3c73f419c4ffbe33c4be75400cb64a7a51733a3fe23f6e085
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-audit-scanner.md

@@ -11,7 +11,7 @@ tools:
   - Grep
   - Read
 model: sonnet
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: d172f600bf32277ea6eb4cbbee4542ddd698a986dcd96997d33930561964569b
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-commit-writer.md

@@ -8,7 +8,7 @@ tools:
   - mcp__token-pilot__test_summary
   - mcp__token-pilot__outline
   - Bash
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: de64a406b5176de19f7422619c7de7949b1f28865f225402c9cea9255f377428
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-context-engineer.md

@@ -13,7 +13,7 @@ tools:
   - Edit
   - Glob
 model: sonnet
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: 68b32af2dacd82ebe52c4eec93edb903d452688274c3065218270627c564d8b0
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-dead-code-finder.md

@@ -11,7 +11,7 @@ tools:
   - Grep
   - Read
 model: sonnet
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: d9b7f5b7ae6f4ae21305c775361bcab097cc774370a6d976c093571d46d55021
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-debugger.md

@@ -12,7 +12,7 @@ tools:
   - Read
   - Bash
 model: sonnet
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: 052413de8d92377edcde6ae5c823f5378db304baccfa29e8866467f42553a500
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-dep-health.md

@@ -9,7 +9,7 @@ tools:
   - Bash
   - Read
 model: haiku
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: e14dc57493d816f8c2e017963e2ef5f66bea50fd0b805a80e8a0d97c968427e7
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-doc-writer.md

@@ -13,7 +13,7 @@ tools:
   - Edit
   - Glob
 model: haiku
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: 57d741794ab40e31a7ac49c68ea39a9088f5827cdef866ce81bfca1b7c9180cf
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-history-explorer.md

@@ -10,7 +10,7 @@ tools:
   - Bash
   - Read
 model: haiku
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: 7b70fa76a60e3c58a1de4f56c32c0f166424137e203a0cf1c8654e7c9235d904
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-impact-analyzer.md

@@ -12,7 +12,7 @@ tools:
   - mcp__token-pilot__read_symbols
   - Read
 model: sonnet
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: 351a987e11eba63852f5431a16d8eb53104f4f689f82fdcc5a2bf4db948ba92f
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-incident-timeline.md

@@ -8,7 +8,7 @@ tools:
   - mcp__token-pilot__read_symbol
   - Bash
 model: inherit
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: de5722bfea374eaab096c1ae635c37879e7a91370ee3cd0532f4240be03c91eb
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-incremental-builder.md

@@ -13,7 +13,7 @@ tools:
   - Edit
   - Bash
 model: sonnet
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: 375a824d0d847bb5453ec594c7a62ad566ee7e4d92717b0473f771f1a0477c60
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-migration-scout.md

@@ -11,7 +11,7 @@ tools:
   - Grep
   - Glob
 model: sonnet
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: 0334de1bf99b431b65359637d125cda7c44c6f780eb92c57cc538715b1939536
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-onboard.md

@@ -10,7 +10,7 @@ tools:
   - mcp__token-pilot__smart_read
   - mcp__token-pilot__smart_read_many
   - mcp__token-pilot__read_section
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: 832e95633fbc8e9b0c10f3e540a327d4be062fb4b3f17a6cce6be13f414e2927
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-performance-profiler.md

@@ -11,7 +11,7 @@ tools:
   - Bash
   - Read
 model: sonnet
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: b61f06380d80798fa2e49d37bcba0653495bee04dd6bdbc1feff9a75607b0508
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-pr-reviewer.md

@@ -11,7 +11,7 @@ tools:
   - mcp__token-pilot__read_for_edit
   - Read
 model: sonnet
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: f83f50d05b4f70285ae7afed2b1a406fc436df56e61a0aedbfb31edc7f2b6e66
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-refactor-planner.md

@@ -8,7 +8,7 @@ tools:
   - mcp__token-pilot__outline
   - mcp__token-pilot__read_symbol
 model: sonnet
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: c5f6fc122c89e16e5cf774045f92169ee3468555320b898171ba13eca5323550
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-review-impact.md

@@ -9,7 +9,7 @@ tools:
   - mcp__token-pilot__module_info
   - Bash
 model: sonnet
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: 8ef3c3341cbfed4eb8dd130126a9683edc57e378c92ff0ca764d584fd941c55c
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-run.md

@@ -16,7 +16,7 @@ tools:
   - Glob
   - Bash
 model: haiku
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: 2b08618d34a61f00aafccbda9fed6d83243296dedb83440edbd2d5c28bb6dbc4
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-session-restorer.md

@@ -9,7 +9,7 @@ tools:
   - mcp__token-pilot__session_budget
   - Bash
   - Read
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: 529374ed728f5eed5b758b3be3da65624783c0bf0c1a253d7d661a843eb5f767
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-ship-coordinator.md

@@ -11,7 +11,7 @@ tools:
   - Read
   - Grep
 model: sonnet
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: a60f6ae110eb3138064bce074e8ba26fa0ce5f4659df1624a9d9d3646803391b
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-spec-writer.md

@@ -9,7 +9,7 @@ tools:
   - Read
   - Write
 model: sonnet
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: c7a4e8b39228fd5158528f389c924c5ff2d98c4b9b05ee0106d54a26c5dc1350
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-test-coverage-gapper.md

@@ -10,7 +10,7 @@ tools:
   - mcp__token-pilot__test_summary
   - Glob
   - Grep
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: be81eed53a3720d146cf89e4a14a7a56577633f7c84c234c412ab70d64c05b11
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-test-triage.md

@@ -8,7 +8,7 @@ tools:
   - mcp__token-pilot__find_usages
   - mcp__token-pilot__read_symbol
 model: sonnet
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: 362ecf4cb03b059421ea26933473700900073dc38b3a7fe271208dfb1ae14f90
 requiredMcpServers:
   - "token-pilot"

package/agents/tp-test-writer.md

@@ -13,7 +13,7 @@ tools:
   - Edit
   - Bash
 model: sonnet
-token_pilot_version: "0.42.3"
+token_pilot_version: "0.43.1"
 token_pilot_body_hash: 269f2fe22ff4517c277d3f56ca67d8a5527b93290ab21079a83ba7af22c1b5a9
 requiredMcpServers:
   - "token-pilot"

package/dist/ast-index/client.d.ts

@@ -80,6 +80,22 @@ export declare class AstIndexClient {
     stopPeriodicUpdate(): void;
     modules(pattern?: string): Promise<AstIndexModuleEntry[]>;
     moduleDeps(module: string): Promise<AstIndexModuleDep[]>;
+    /**
+     * Transitive dependency path(s) between two modules — ast-index 3.44
+     * `module-route`. Returns the raw CLI output for the requested format
+     * (text/json/mermaid/dot); the handler frames it. Null when the index
+     * is unavailable. `exec` already sets AST_INDEX_WALK_UP=1, so the
+     * `--walk-up` flag is implied and not passed here.
+     */
+    moduleRoute(opts: {
+        from: string;
+        to: string;
+        all?: boolean;
+        maxPaths?: number;
+        maxDepth?: number;
+        viaKind?: string;
+        format?: string;
+    }): Promise<string | null>;
     moduleDependents(module: string): Promise<AstIndexModuleDep[]>;
     unusedDeps(module: string): Promise<AstIndexUnusedDep[]>;
     moduleApi(module: string): Promise<AstIndexModuleApi[]>;

package/dist/ast-index/client.js

@@ -679,6 +679,36 @@ export class AstIndexClient {
             return [];
         }
     }
+    /**
+     * Transitive dependency path(s) between two modules — ast-index 3.44
+     * `module-route`. Returns the raw CLI output for the requested format
+     * (text/json/mermaid/dot); the handler frames it. Null when the index
+     * is unavailable. `exec` already sets AST_INDEX_WALK_UP=1, so the
+     * `--walk-up` flag is implied and not passed here.
+     */
+    async moduleRoute(opts) {
+        if (this.indexDisabled || this.indexOversized)
+            return null;
+        await this.ensureIndex();
+        try {
+            const cmdArgs = ["module-route", "--from", opts.from, "--to", opts.to];
+            if (opts.all)
+                cmdArgs.push("--all");
+            if (opts.maxPaths != null)
+                cmdArgs.push("--max-paths", String(opts.maxPaths));
+            if (opts.maxDepth != null)
+                cmdArgs.push("--max-depth", String(opts.maxDepth));
+            if (opts.viaKind)
+                cmdArgs.push("--via-kind", opts.viaKind);
+            if (opts.format)
+                cmdArgs.push("--format", opts.format);
+            return await this.exec(cmdArgs, 15000);
+        }
+        catch (err) {
+            console.error(`[token-pilot] ast-index module-route failed: ${err instanceof Error ? err.message : err}`);
+            return null;
+        }
+    }
     async moduleDependents(module) {
         if (this.indexDisabled || this.indexOversized)
             return [];

package/dist/core/validation.d.ts

@@ -145,6 +145,23 @@ export interface ModuleInfoArgs {
     check?: "deps" | "dependents" | "api" | "unused-deps" | "all";
 }
 export declare function validateModuleInfoArgs(args: unknown): ModuleInfoArgs;
+/**
+ * Validate module_route arguments.
+ *
+ * Wraps ast-index 3.44 `module-route` — the transitive dependency path
+ * between two modules. `from`/`to` are required; everything else mirrors
+ * the CLI flags with sane caps.
+ */
+export interface ModuleRouteArgs {
+    from: string;
+    to: string;
+    all?: boolean;
+    maxPaths?: number;
+    maxDepth?: number;
+    viaKind?: "api" | "implementation" | "all";
+    format?: "text" | "json" | "mermaid" | "dot";
+}
+export declare function validateModuleRouteArgs(args: unknown): ModuleRouteArgs;
 /**
  * Validate smart_diff arguments.
  */

package/dist/core/validation.js

@@ -428,6 +428,60 @@ export function validateModuleInfoArgs(args) {
         check: check ?? "all",
     };
 }
+export function validateModuleRouteArgs(args) {
+    if (!args || typeof args !== "object") {
+        throw new Error('Arguments must be an object with "from" and "to" parameters.');
+    }
+    const a = args;
+    if (typeof a.from !== "string" || a.from.length === 0) {
+        throw new Error('Required parameter "from" must be a non-empty string.');
+    }
+    if (typeof a.to !== "string" || a.to.length === 0) {
+        throw new Error('Required parameter "to" must be a non-empty string.');
+    }
+    let viaKind;
+    if (a.viaKind !== undefined && a.viaKind !== null) {
+        const valid = ["api", "implementation", "all"];
+        if (typeof a.viaKind !== "string" || !valid.includes(a.viaKind)) {
+            throw new Error(`"viaKind" must be one of: ${valid.join(", ")}`);
+        }
+        viaKind = a.viaKind;
+    }
+    let format;
+    if (a.format !== undefined && a.format !== null) {
+        const valid = ["text", "json", "mermaid", "dot"];
+        if (typeof a.format !== "string" || !valid.includes(a.format)) {
+            throw new Error(`"format" must be one of: ${valid.join(", ")}`);
+        }
+        format = a.format;
+    }
+    // Clamp numeric caps to safe ranges — never trust the caller blindly.
+    let maxPaths;
+    if (a.maxPaths !== undefined && a.maxPaths !== null) {
+        const n = Number(a.maxPaths);
+        if (!Number.isFinite(n) || n < 1) {
+            throw new Error('"maxPaths" must be a positive number.');
+        }
+        maxPaths = Math.min(Math.floor(n), 200);
+    }
+    let maxDepth;
+    if (a.maxDepth !== undefined && a.maxDepth !== null) {
+        const n = Number(a.maxDepth);
+        if (!Number.isFinite(n) || n < 1) {
+            throw new Error('"maxDepth" must be a positive number.');
+        }
+        maxDepth = Math.min(Math.floor(n), 50);
+    }
+    return {
+        from: a.from,
+        to: a.to,
+        all: a.all === true,
+        maxPaths,
+        maxDepth,
+        viaKind,
+        format,
+    };
+}
 export function validateSmartDiffArgs(args) {
     if (!args || typeof args !== "object")
         return { scope: "unstaged" };

package/dist/handlers/module-route.d.ts

@@ -0,0 +1,20 @@
+import type { AstIndexClient } from "../ast-index/client.js";
+import type { ModuleRouteArgs } from "../core/validation.js";
+/**
+ * module_route — transitive dependency path(s) between two modules.
+ *
+ * Thin wrapper over ast-index 3.44 `module-route`. The CLI already
+ * produces compact, purpose-built output (a path listing, or
+ * mermaid/dot/json for diagramming), so the handler only frames it and
+ * handles the empty / degraded cases — it does not re-parse the graph.
+ */
+export declare function handleModuleRoute(args: ModuleRouteArgs, _projectRoot: string, astIndex: AstIndexClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    meta: {
+        files: string[];
+    };
+}>;
+//# sourceMappingURL=module-route.d.ts.map