token-pilot 0.34.1 → 0.34.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -6,14 +6,14 @@
6
6
  },
7
7
  "metadata": {
8
8
  "description": "Token Pilot \u2014 save 60-90% tokens when AI reads code",
9
- "version": "0.34.1"
9
+ "version": "0.34.2"
10
10
  },
11
11
  "plugins": [
12
12
  {
13
13
  "name": "token-pilot",
14
14
  "source": "./",
15
15
  "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.",
16
- "version": "0.34.1",
16
+ "version": "0.34.2",
17
17
  "author": {
18
18
  "name": "Digital-Threads"
19
19
  },
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "token-pilot",
3
- "version": "0.34.1",
3
+ "version": "0.34.2",
4
4
  "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.",
5
5
  "author": {
6
6
  "name": "Digital-Threads",
@@ -23,6 +23,5 @@
23
23
  "command": "sh",
24
24
  "args": ["${CLAUDE_PLUGIN_ROOT}/start.sh"]
25
25
  }
26
- },
27
- "skills": "./skills/"
26
+ }
28
27
  }
package/README.md CHANGED
@@ -122,6 +122,38 @@ npx token-pilot install-hook
122
122
  npx token-pilot install-agents --scope=user --force
123
123
  ```
124
124
 
125
+ ## Tips for Claude Code 2.1.139+
126
+
127
+ The May 2026 Claude Code update changed a few things that affect how
128
+ token-pilot is invoked. Nothing breaks on older versions — these are
129
+ quality-of-life notes for the newer ones.
130
+
131
+ - **Run a tp-\* agent directly without the `plugin:` prefix.**
132
+ `claude --agent tp-debugger "fix the stack trace"` now works the same
133
+ as `--agent token-pilot:tp-debugger`. The Task tool dispatcher
134
+ resolves the short name automatically.
135
+
136
+ - **Cold ast-index calls — raise `MCP_TOOL_TIMEOUT`.**
137
+ The first `find_usages` / `outline` / `read_symbol` on a large repo
138
+ triggers an index build. Default per-MCP-tool timeout (60 s) is
139
+ enough for ~50k-file repos; bigger ones benefit from
140
+ `MCP_TOOL_TIMEOUT=120000` in `~/.claude/settings.json`. Subsequent
141
+ calls hit the cache and return in ~50 ms.
142
+
143
+ - **Background sessions with `--mcp-config`.**
144
+ Dispatching a worker via `claude agents` or `--bg` with
145
+ `--mcp-config /path/to/other.json` swaps the MCP set for that
146
+ session. If `token-pilot` is not in the override config, MCP tools
147
+ (`smart_read`, `find_usages`, …) are unavailable in that worker
148
+ even though the hooks (Read / Edit / Bash / Grep / Task) still
149
+ fire — hooks are project-level, MCP tools are session-level. Add
150
+ `token-pilot` to the override config or skip `--mcp-config`.
151
+
152
+ - **`claude plugin details token-pilot`.**
153
+ Shows the projected per-turn token cost, the hook event names, and
154
+ the MCP server entry. The skill list, the agent list, and the LSP
155
+ list are all auto-discovered from the canonical sub-folders.
156
+
125
157
  ## Troubleshooting
126
158
 
127
159
  ```bash
@@ -9,7 +9,7 @@ tools:
9
9
  - mcp__token-pilot__read_symbol
10
10
  - Bash
11
11
  model: haiku
12
- token_pilot_version: "0.34.1"
12
+ token_pilot_version: "0.34.2"
13
13
  token_pilot_body_hash: dd184501203fa7f3c73f419c4ffbe33c4be75400cb64a7a51733a3fe23f6e085
14
14
  ---
15
15
 
@@ -11,7 +11,7 @@ tools:
11
11
  - Grep
12
12
  - Read
13
13
  model: sonnet
14
- token_pilot_version: "0.34.1"
14
+ token_pilot_version: "0.34.2"
15
15
  token_pilot_body_hash: d172f600bf32277ea6eb4cbbee4542ddd698a986dcd96997d33930561964569b
16
16
  ---
17
17
 
@@ -8,7 +8,7 @@ tools:
8
8
  - mcp__token-pilot__test_summary
9
9
  - mcp__token-pilot__outline
10
10
  - Bash
11
- token_pilot_version: "0.34.1"
11
+ token_pilot_version: "0.34.2"
12
12
  token_pilot_body_hash: de64a406b5176de19f7422619c7de7949b1f28865f225402c9cea9255f377428
13
13
  ---
14
14
 
@@ -13,7 +13,7 @@ tools:
13
13
  - Edit
14
14
  - Glob
15
15
  model: sonnet
16
- token_pilot_version: "0.34.1"
16
+ token_pilot_version: "0.34.2"
17
17
  token_pilot_body_hash: 68b32af2dacd82ebe52c4eec93edb903d452688274c3065218270627c564d8b0
18
18
  ---
19
19
 
@@ -11,7 +11,7 @@ tools:
11
11
  - Grep
12
12
  - Read
13
13
  model: sonnet
14
- token_pilot_version: "0.34.1"
14
+ token_pilot_version: "0.34.2"
15
15
  token_pilot_body_hash: d9b7f5b7ae6f4ae21305c775361bcab097cc774370a6d976c093571d46d55021
16
16
  ---
17
17
 
@@ -12,7 +12,7 @@ tools:
12
12
  - Read
13
13
  - Bash
14
14
  model: sonnet
15
- token_pilot_version: "0.34.1"
15
+ token_pilot_version: "0.34.2"
16
16
  token_pilot_body_hash: 052413de8d92377edcde6ae5c823f5378db304baccfa29e8866467f42553a500
17
17
  ---
18
18
 
@@ -9,7 +9,7 @@ tools:
9
9
  - Bash
10
10
  - Read
11
11
  model: haiku
12
- token_pilot_version: "0.34.1"
12
+ token_pilot_version: "0.34.2"
13
13
  token_pilot_body_hash: e14dc57493d816f8c2e017963e2ef5f66bea50fd0b805a80e8a0d97c968427e7
14
14
  ---
15
15
 
@@ -13,7 +13,7 @@ tools:
13
13
  - Edit
14
14
  - Glob
15
15
  model: haiku
16
- token_pilot_version: "0.34.1"
16
+ token_pilot_version: "0.34.2"
17
17
  token_pilot_body_hash: 57d741794ab40e31a7ac49c68ea39a9088f5827cdef866ce81bfca1b7c9180cf
18
18
  ---
19
19
 
@@ -10,7 +10,7 @@ tools:
10
10
  - Bash
11
11
  - Read
12
12
  model: haiku
13
- token_pilot_version: "0.34.1"
13
+ token_pilot_version: "0.34.2"
14
14
  token_pilot_body_hash: 7b70fa76a60e3c58a1de4f56c32c0f166424137e203a0cf1c8654e7c9235d904
15
15
  ---
16
16
 
@@ -12,7 +12,7 @@ tools:
12
12
  - mcp__token-pilot__read_symbols
13
13
  - Read
14
14
  model: sonnet
15
- token_pilot_version: "0.34.1"
15
+ token_pilot_version: "0.34.2"
16
16
  token_pilot_body_hash: 351a987e11eba63852f5431a16d8eb53104f4f689f82fdcc5a2bf4db948ba92f
17
17
  ---
18
18
 
@@ -8,7 +8,7 @@ tools:
8
8
  - mcp__token-pilot__read_symbol
9
9
  - Bash
10
10
  model: inherit
11
- token_pilot_version: "0.34.1"
11
+ token_pilot_version: "0.34.2"
12
12
  token_pilot_body_hash: de5722bfea374eaab096c1ae635c37879e7a91370ee3cd0532f4240be03c91eb
13
13
  ---
14
14
 
@@ -13,7 +13,7 @@ tools:
13
13
  - Edit
14
14
  - Bash
15
15
  model: sonnet
16
- token_pilot_version: "0.34.1"
16
+ token_pilot_version: "0.34.2"
17
17
  token_pilot_body_hash: 375a824d0d847bb5453ec594c7a62ad566ee7e4d92717b0473f771f1a0477c60
18
18
  ---
19
19
 
@@ -11,7 +11,7 @@ tools:
11
11
  - Grep
12
12
  - Glob
13
13
  model: sonnet
14
- token_pilot_version: "0.34.1"
14
+ token_pilot_version: "0.34.2"
15
15
  token_pilot_body_hash: 0334de1bf99b431b65359637d125cda7c44c6f780eb92c57cc538715b1939536
16
16
  ---
17
17
 
@@ -10,7 +10,7 @@ tools:
10
10
  - mcp__token-pilot__smart_read
11
11
  - mcp__token-pilot__smart_read_many
12
12
  - mcp__token-pilot__read_section
13
- token_pilot_version: "0.34.1"
13
+ token_pilot_version: "0.34.2"
14
14
  token_pilot_body_hash: 832e95633fbc8e9b0c10f3e540a327d4be062fb4b3f17a6cce6be13f414e2927
15
15
  ---
16
16
 
@@ -11,7 +11,7 @@ tools:
11
11
  - Bash
12
12
  - Read
13
13
  model: sonnet
14
- token_pilot_version: "0.34.1"
14
+ token_pilot_version: "0.34.2"
15
15
  token_pilot_body_hash: b61f06380d80798fa2e49d37bcba0653495bee04dd6bdbc1feff9a75607b0508
16
16
  ---
17
17
 
@@ -11,7 +11,7 @@ tools:
11
11
  - mcp__token-pilot__read_for_edit
12
12
  - Read
13
13
  model: sonnet
14
- token_pilot_version: "0.34.1"
14
+ token_pilot_version: "0.34.2"
15
15
  token_pilot_body_hash: f83f50d05b4f70285ae7afed2b1a406fc436df56e61a0aedbfb31edc7f2b6e66
16
16
  ---
17
17
 
@@ -8,7 +8,7 @@ tools:
8
8
  - mcp__token-pilot__outline
9
9
  - mcp__token-pilot__read_symbol
10
10
  model: sonnet
11
- token_pilot_version: "0.34.1"
11
+ token_pilot_version: "0.34.2"
12
12
  token_pilot_body_hash: c5f6fc122c89e16e5cf774045f92169ee3468555320b898171ba13eca5323550
13
13
  ---
14
14
 
@@ -9,7 +9,7 @@ tools:
9
9
  - mcp__token-pilot__module_info
10
10
  - Bash
11
11
  model: sonnet
12
- token_pilot_version: "0.34.1"
12
+ token_pilot_version: "0.34.2"
13
13
  token_pilot_body_hash: 8ef3c3341cbfed4eb8dd130126a9683edc57e378c92ff0ca764d584fd941c55c
14
14
  ---
15
15
 
package/agents/tp-run.md CHANGED
@@ -16,7 +16,7 @@ tools:
16
16
  - Glob
17
17
  - Bash
18
18
  model: haiku
19
- token_pilot_version: "0.34.1"
19
+ token_pilot_version: "0.34.2"
20
20
  token_pilot_body_hash: 2b08618d34a61f00aafccbda9fed6d83243296dedb83440edbd2d5c28bb6dbc4
21
21
  ---
22
22
 
@@ -9,7 +9,7 @@ tools:
9
9
  - mcp__token-pilot__session_budget
10
10
  - Bash
11
11
  - Read
12
- token_pilot_version: "0.34.1"
12
+ token_pilot_version: "0.34.2"
13
13
  token_pilot_body_hash: 529374ed728f5eed5b758b3be3da65624783c0bf0c1a253d7d661a843eb5f767
14
14
  ---
15
15
 
@@ -11,7 +11,7 @@ tools:
11
11
  - Read
12
12
  - Grep
13
13
  model: sonnet
14
- token_pilot_version: "0.34.1"
14
+ token_pilot_version: "0.34.2"
15
15
  token_pilot_body_hash: a60f6ae110eb3138064bce074e8ba26fa0ce5f4659df1624a9d9d3646803391b
16
16
  ---
17
17
 
@@ -9,7 +9,7 @@ tools:
9
9
  - Read
10
10
  - Write
11
11
  model: sonnet
12
- token_pilot_version: "0.34.1"
12
+ token_pilot_version: "0.34.2"
13
13
  token_pilot_body_hash: c7a4e8b39228fd5158528f389c924c5ff2d98c4b9b05ee0106d54a26c5dc1350
14
14
  ---
15
15
 
@@ -10,7 +10,7 @@ tools:
10
10
  - mcp__token-pilot__test_summary
11
11
  - Glob
12
12
  - Grep
13
- token_pilot_version: "0.34.1"
13
+ token_pilot_version: "0.34.2"
14
14
  token_pilot_body_hash: be81eed53a3720d146cf89e4a14a7a56577633f7c84c234c412ab70d64c05b11
15
15
  ---
16
16
 
@@ -8,7 +8,7 @@ tools:
8
8
  - mcp__token-pilot__find_usages
9
9
  - mcp__token-pilot__read_symbol
10
10
  model: sonnet
11
- token_pilot_version: "0.34.1"
11
+ token_pilot_version: "0.34.2"
12
12
  token_pilot_body_hash: 362ecf4cb03b059421ea26933473700900073dc38b3a7fe271208dfb1ae14f90
13
13
  ---
14
14
 
@@ -13,7 +13,7 @@ tools:
13
13
  - Edit
14
14
  - Bash
15
15
  model: sonnet
16
- token_pilot_version: "0.34.1"
16
+ token_pilot_version: "0.34.2"
17
17
  token_pilot_body_hash: 269f2fe22ff4517c277d3f56ca67d8a5527b93290ab21079a83ba7af22c1b5a9
18
18
  ---
19
19
 
package/dist/index.js CHANGED
@@ -207,6 +207,28 @@ export async function main(cliArgs = process.argv.slice(2)) {
207
207
  agentIndex,
208
208
  force,
209
209
  });
210
+ // v0.34.2 — emit a diagnostic for every non-allow Task decision
211
+ // so we can count miss-rate and pair-popularity without waiting
212
+ // for PostToolUse:Task to land. If the post-task hook ever fails
213
+ // again (see typo-guard bug from v0.33.1), pre-task diagnostics
214
+ // are still recoverable from hook-events.jsonl. Best-effort —
215
+ // never blocks the dispatch decision.
216
+ if (decision.kind !== "allow") {
217
+ const subagentType = input?.tool_input?.subagent_type ?? "";
218
+ appendDiagnostic(process.cwd(), {
219
+ code: "task_pre_intercept",
220
+ level: decision.kind === "deny" ? "warn" : "info",
221
+ detail: {
222
+ decision: decision.kind,
223
+ subagent_type: typeof subagentType === "string" ? subagentType : "",
224
+ index_size: agentIndex.agents.length,
225
+ force,
226
+ mode: parseEnforcementMode(process.env.TOKEN_PILOT_MODE),
227
+ },
228
+ }).catch(() => {
229
+ /* never block dispatch on telemetry */
230
+ });
231
+ }
210
232
  const rendered = renderPreTaskOutput(decision);
211
233
  if (rendered)
212
234
  process.stdout.write(rendered);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "token-pilot",
3
- "version": "0.34.1",
3
+ "version": "0.34.2",
4
4
  "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",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",