token-pilot 0.42.3 → 0.43.0

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.0"
   },
   "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",
+      "version": "0.43.0",
       "author": {
         "name": "Digital-Threads"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "token-pilot",
-  "version": "0.42.3",
+  "version": "0.43.0",
   "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,107 @@ 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.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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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.0"
 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

package/dist/handlers/module-route.js

@@ -0,0 +1,73 @@
+/**
+ * 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 async function handleModuleRoute(args, _projectRoot, astIndex) {
+    // Degradation check — same contract as module_info.
+    if (astIndex.isDisabled() || astIndex.isOversized()) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "⚠ ast-index unavailable — module_route requires ast-index.\n" +
+                        "DEGRADED: Use module_info() on each module + related_files() to trace dependencies manually.",
+                },
+            ],
+            meta: { files: [] },
+        };
+    }
+    const output = await astIndex.moduleRoute({
+        from: args.from,
+        to: args.to,
+        all: args.all,
+        maxPaths: args.maxPaths,
+        maxDepth: args.maxDepth,
+        viaKind: args.viaKind,
+        format: args.format,
+    });
+    const header = `MODULE ROUTE: ${args.from} → ${args.to}`;
+    if (output == null) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${header}\n\n` +
+                        "⚠ module-route failed (index unavailable or command error).\n" +
+                        "HINT: run `npx token-pilot doctor` to check ast-index, or fall back to module_info().",
+                },
+            ],
+            meta: { files: [] },
+        };
+    }
+    const body = output.trim();
+    if (body.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${header}\n\n` +
+                        `No dependency path returned from "${args.from}" to "${args.to}" ` +
+                        `(within ${args.maxDepth ?? 20} hops).\n` +
+                        "This means one of:\n" +
+                        "  • the modules are genuinely unrelated, or\n" +
+                        "  • the module-dependency graph isn't indexed yet — run `ast-index rebuild`.\n" +
+                        'HINT: also try a higher "maxDepth" / wider "viaKind", or module_info() to confirm each module resolves.',
+                },
+            ],
+            meta: { files: [] },
+        };
+    }
+    // For machine formats (json/mermaid/dot) pass the payload through clean —
+    // a header would corrupt a diagram/parse. Text format gets the header.
+    const isMachineFormat = args.format === "json" || args.format === "mermaid" || args.format === "dot";
+    const text = isMachineFormat ? body : `${header}\n\n${body}`;
+    return {
+        content: [{ type: "text", text }],
+        meta: { files: [] },
+    };
+}
+//# sourceMappingURL=module-route.js.map

package/dist/index.js

@@ -1625,12 +1625,12 @@ Usage:
 Quick start:
   npx token-pilot init              Setup .mcp.json (token-pilot + context-mode)
 
-MCP Tools (22):
+MCP Tools (23):
   smart_read, read_symbol, read_symbols, read_range, read_section, read_diff,
   read_for_edit, smart_read_many, find_usages, find_unused, related_files,
   outline, project_overview, session_analytics, code_audit, module_info,
-  smart_diff, explore_area, smart_log, test_summary, session_snapshot,
-  session_budget
+  module_route, smart_diff, explore_area, smart_log, test_summary,
+  session_snapshot, session_budget
 `);
     process.exit(0);
 }

package/dist/server/tool-definitions.d.ts

@@ -92,6 +92,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -176,6 +183,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -254,6 +268,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -328,6 +349,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -393,6 +421,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -458,6 +493,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -547,6 +589,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -621,6 +670,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -704,6 +760,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -770,6 +833,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -832,6 +902,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -900,6 +977,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -962,6 +1046,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -1027,6 +1118,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -1095,6 +1193,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -1170,6 +1275,13 @@ export declare const TOOL_DEFINITIONS: ({
             verbose?: undefined;
             module?: undefined;
             export_only?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -1236,6 +1348,102 @@ export declare const TOOL_DEFINITIONS: ({
             export_only?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
+            ref?: undefined;
+            count?: undefined;
+            command?: undefined;
+            runner?: undefined;
+            timeout?: undefined;
+            goal?: undefined;
+            decisions?: undefined;
+            confirmed?: undefined;
+            files?: undefined;
+            blocked?: undefined;
+            next?: undefined;
+            sessionId?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            from: {
+                type: string;
+                description: string;
+            };
+            to: {
+                type: string;
+                description: string;
+            };
+            all: {
+                type: string;
+                description: string;
+            };
+            maxPaths: {
+                type: string;
+                description: string;
+            };
+            maxDepth: {
+                type: string;
+                description: string;
+            };
+            viaKind: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            path?: undefined;
+            show_imports?: undefined;
+            show_docs?: undefined;
+            depth?: undefined;
+            scope?: undefined;
+            max_tokens?: undefined;
+            session_id?: undefined;
+            force?: undefined;
+            symbol?: undefined;
+            context_before?: undefined;
+            context_after?: undefined;
+            show?: undefined;
+            include_edit_context?: undefined;
+            symbols?: undefined;
+            start_line?: undefined;
+            end_line?: undefined;
+            heading?: undefined;
+            context_lines?: undefined;
+            line?: undefined;
+            context?: undefined;
+            include_callers?: undefined;
+            include_tests?: undefined;
+            include_changes?: undefined;
+            section?: undefined;
+            paths?: undefined;
+            kind?: undefined;
+            limit?: undefined;
+            lang?: undefined;
+            mode?: undefined;
+            include?: undefined;
+            recursive?: undefined;
+            max_depth?: undefined;
+            verbose?: undefined;
+            module?: undefined;
+            export_only?: undefined;
+            check?: undefined;
+            pattern?: undefined;
+            name?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -1306,6 +1514,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             count?: undefined;
             command?: undefined;
             runner?: undefined;
@@ -1374,6 +1589,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -1444,6 +1666,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             command?: undefined;
             runner?: undefined;
             timeout?: undefined;
@@ -1514,6 +1743,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             goal?: undefined;
@@ -1603,6 +1839,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;
@@ -1660,6 +1903,13 @@ export declare const TOOL_DEFINITIONS: ({
             check?: undefined;
             pattern?: undefined;
             name?: undefined;
+            from?: undefined;
+            to?: undefined;
+            all?: undefined;
+            maxPaths?: undefined;
+            maxDepth?: undefined;
+            viaKind?: undefined;
+            format?: undefined;
             ref?: undefined;
             count?: undefined;
             command?: undefined;

package/dist/server/tool-definitions.js

@@ -585,6 +585,46 @@ export const TOOL_DEFINITIONS = [
             required: ["module"],
         },
     },
+    {
+        name: "module_route",
+        description: "Show the transitive dependency path(s) between two modules — how module A reaches module B through the import graph. Use to answer 'how does X depend on Y?', trace coupling, or generate a dependency diagram. format='mermaid'/'dot' emits a diagram; default text lists the hops.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                from: {
+                    type: "string",
+                    description: 'Source module — the one whose dependencies are followed (name or path, e.g. "auth", "apps/api")',
+                },
+                to: {
+                    type: "string",
+                    description: "Target module to reach",
+                },
+                all: {
+                    type: "boolean",
+                    description: "Show all simple paths instead of just the shortest (default: false)",
+                },
+                maxPaths: {
+                    type: "number",
+                    description: "Cap on number of paths returned (default: 50, max: 200)",
+                },
+                maxDepth: {
+                    type: "number",
+                    description: "Cap on path length in hops (default: 20, max: 50)",
+                },
+                viaKind: {
+                    type: "string",
+                    enum: ["api", "implementation", "all"],
+                    description: 'Restrict traversal to a dependency kind (default: "all")',
+                },
+                format: {
+                    type: "string",
+                    enum: ["text", "json", "mermaid", "dot"],
+                    description: 'Output format: "text" (default, hop listing), "json", "mermaid" or "dot" (dependency diagram)',
+                },
+            },
+            required: ["from", "to"],
+        },
+    },
     // --- Diff & exploration ---
     {
         name: "smart_diff",

package/dist/server.js

@@ -34,6 +34,7 @@ import { handleRelatedFiles } from "./handlers/related-files.js";
 import { handleOutline } from "./handlers/outline.js";
 import { handleCodeAudit } from "./handlers/code-audit.js";
 import { handleModuleInfo } from "./handlers/module-info.js";
+import { handleModuleRoute } from "./handlers/module-route.js";
 import { handleSmartDiff } from "./handlers/smart-diff.js";
 import { handleExploreArea } from "./handlers/explore-area.js";
 import { handleSmartLog } from "./handlers/smart-log.js";
@@ -50,9 +51,17 @@ import { getMcpInstructions, TOOL_DEFINITIONS, } from "./server/tool-definitions
 import { filterToolsByProfile, parseProfileEnv, } from "./server/tool-profiles.js";
 import { STRICT_SMART_READ_MAX_TOKENS, STRICT_EXPLORE_AREA_INCLUDE, } from "./server/enforcement-mode.js";
 import { createTokenEstimates } from "./server/token-estimates.js";
-import { validateSmartReadArgs, validateReadSymbolArgs, validateReadSymbolsArgs, validateReadRangeArgs, validateReadDiffArgs, validateFindUsagesArgs, validateSmartReadManyArgs, validateReadForEditArgs, validateRelatedFilesArgs, validateOutlineArgs, validateFindUnusedArgs, validateCallTreeArgs, validateCodeAuditArgs, validateProjectOverviewArgs, validateModuleInfoArgs, validateSmartDiffArgs, validateExploreAreaArgs, validateSmartLogArgs, validateTestSummaryArgs, validateReadSectionArgs, } from "./core/validation.js";
+import { validateSmartReadArgs, validateReadSymbolArgs, validateReadSymbolsArgs, validateReadRangeArgs, validateReadDiffArgs, validateFindUsagesArgs, validateSmartReadManyArgs, validateReadForEditArgs, validateRelatedFilesArgs, validateOutlineArgs, validateFindUnusedArgs, validateCallTreeArgs, validateCodeAuditArgs, validateProjectOverviewArgs, validateModuleInfoArgs, validateModuleRouteArgs, validateSmartDiffArgs, validateExploreAreaArgs, validateSmartLogArgs, validateTestSummaryArgs, validateReadSectionArgs, } from "./core/validation.js";
 export async function createServer(projectRoot, options) {
     const mode = options?.enforcementMode ?? "deny";
+    // v0.43.0 — the real Claude Code session id. CC exports it to every
+    // child process (MCP server, hooks, Bash) via CLAUDE_CODE_SESSION_ID —
+    // verified against the 2.1.167 bundle, and it is the exact same value
+    // the PreToolUse hooks receive and the statusline payload carries.
+    // Stamping it on each tool-call row lets the statusline badge attribute
+    // MCP-tool savings to the current session; before this the rows carried
+    // an empty session_id and the badge ignored them, undercounting savings.
+    const ccSessionId = process.env.CLAUDE_CODE_SESSION_ID ?? "";
     const config = await loadConfig(projectRoot);
     const astIndex = new AstIndexClient(projectRoot, config.astIndex.timeout, {
         binaryPath: config.astIndex.binaryPath,
@@ -323,7 +332,7 @@ export async function createServer(projectRoot, options) {
         // future prune/fix decision.
         void appendToolCall(projectRoot, {
             ts: rest.timestamp,
-            session_id: call.sessionId ?? "",
+            session_id: call.sessionId ?? ccSessionId,
             tool: rest.tool,
             path: rest.path,
             tokensReturned: rest.tokensReturned,
@@ -857,6 +866,37 @@ export async function createServer(projectRoot, options) {
                     });
                     return moduleResult;
                 }
+                case "module_route": {
+                    const routeArgs = validateModuleRouteArgs(args);
+                    const cachedRoute = sessionCache?.get("module_route", routeArgs);
+                    if (cachedRoute) {
+                        recordWithTrace({
+                            tool: "module_route",
+                            path: `${routeArgs.from}→${routeArgs.to}`,
+                            tokensReturned: cachedRoute.tokenEstimate,
+                            tokensWouldBe: cachedRoute.tokensWouldBe ?? cachedRoute.tokenEstimate,
+                            timestamp: Date.now(),
+                            sessionCacheHit: true,
+                            savingsCategory: "cache",
+                            args: routeArgs,
+                        });
+                        return cachedRoute.result;
+                    }
+                    const routeResult = await handleModuleRoute(routeArgs, projectRoot, astIndex);
+                    const routeText = routeResult.content[0]?.text ?? "";
+                    const routeTokens = estimateTokens(routeText);
+                    sessionCache?.set("module_route", routeArgs, routeResult, { dependsOnAst: true }, routeTokens, routeTokens);
+                    recordWithTrace({
+                        tool: "module_route",
+                        path: `${routeArgs.from}→${routeArgs.to}`,
+                        tokensReturned: routeTokens,
+                        tokensWouldBe: routeTokens,
+                        timestamp: Date.now(),
+                        savingsCategory: "compression",
+                        args: routeArgs,
+                    });
+                    return routeResult;
+                }
                 case "smart_diff": {
                     const sdArgs = validateSmartDiffArgs(args);
                     const sdResult = await handleSmartDiff(sdArgs, projectRoot, astIndex);

package/docs/tools.md

@@ -1,6 +1,6 @@
 # MCP Tools Reference
 
-Token Pilot exposes 22 MCP tools. All handlers remain active regardless of [tool profile](configuration.md#tool-profiles) — the profile only trims what appears in `tools/list` at session start.
+Token Pilot exposes 23 MCP tools. All handlers remain active regardless of [tool profile](configuration.md#tool-profiles) — the profile only trims what appears in `tools/list` at session start.
 
 ## Reading
 
@@ -26,6 +26,7 @@ Token Pilot exposes 22 MCP tools. All handlers remain active regardless of [tool
 | `find_unused` | manual | Dead code detection — unreferenced exported symbols |
 | `code_audit` | multiple `Grep` | TODOs, deprecated symbols, structural patterns |
 | `module_info` | manual | Deps, dependents, public API, unused deps |
+| `module_route` | manual | Transitive dependency path(s) between two modules; `format=mermaid`/`dot` emits a diagram |
 | `smart_diff` | raw `git diff` | Structural diff with symbol mapping |
 | `explore_area` | 3–5 calls | Structure + imports + tests + recent changes in one call |
 | `smart_log` | raw `git log` | Structured commits with category detection |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "token-pilot",
-  "version": "0.42.3",
+  "version": "0.43.0",
   "description": "Save up to 80% tokens when AI reads code — MCP server for token-efficient code navigation, AST-aware structural reading instead of dumping full files into context window",
   "type": "module",
   "main": "dist/index.js",

package/skills/guide/SKILL.md

@@ -3,6 +3,10 @@ name: guide
 description: Show a quick-reference guide for all Token Pilot tools — when to use each one
 command: guide
 user_invocable: true
+# v0.43.0 — effort (Claude Code 2.1.16x) overrides model effort while
+# this skill runs. The guide just renders a static Markdown reference —
+# it needs no reasoning, so `low` keeps it fast and cheap.
+effort: low
 # v0.36.0 — disallowed-tools is a Claude Code 2.1.152+ field that
 # strips the listed tools from the model's surface while this skill
 # is active. The guide just renders Markdown; it never needs Edit /

package/skills/install/SKILL.md

@@ -3,6 +3,10 @@ name: install
 description: Install or check ast-index binary (auto-downloads if missing)
 command: install
 user_invocable: true
+# v0.43.0 — effort (Claude Code 2.1.16x). install drives one
+# `npx token-pilot install-ast-index` Bash call; no reasoning needed,
+# so `low` keeps it fast and cheap.
+effort: low
 # v0.36.0 — disallowed-tools (Claude Code 2.1.152+). The install
 # skill drives one `npx token-pilot install-ast-index` Bash command;
 # nothing else. Keep Bash, block all write/edit/delegation tools so

package/skills/stats/SKILL.md

@@ -3,6 +3,9 @@ name: stats
 description: Show Token Pilot session analytics — token savings, per-tool breakdown, top files, per-agent grouping
 command: stats
 user_invocable: true
+# v0.43.0 — effort (Claude Code 2.1.16x). stats reads the events log and
+# runs `token-pilot stats` variants — no reasoning, so `low` is enough.
+effort: low
 # v0.36.0 — disallowed-tools (Claude Code 2.1.152+). stats only reads
 # the events log and runs `token-pilot stats` variants. No
 # Edit/Write/Task ever — block them defensively.