token-pilot 0.42.2 → 0.42.3

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Token Pilot \u2014 save 60-90% tokens when AI reads code",
-    "version": "0.42.2"
+    "version": "0.42.3"
   },
   "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.2",
+      "version": "0.42.3",
       "author": {
         "name": "Digital-Threads"
       },

package/.claude-plugin/plugin.json

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

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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 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.2"
+token_pilot_version: "0.42.3"
 token_pilot_body_hash: 269f2fe22ff4517c277d3f56ca67d8a5527b93290ab21079a83ba7af22c1b5a9
 requiredMcpServers:
   - "token-pilot"

package/dist/cli/install-statusline.d.ts

@@ -22,18 +22,37 @@
  * want to replace a custom statusLine.
  */
 import type { StatuslineStatus } from "./ecosystem-check.js";
-/** The version-agnostic chain command (auto-picks the newest plugin dir). */
+/** TP-only badge command (DEFAULT — just token-pilot's [TP] badge). */
+export declare const TP_ONLY_COMMAND = "bash \"$(ls -t ~/.claude/plugins/cache/token-pilot/token-pilot/*/hooks/tp-statusline.sh 2>/dev/null | head -1)\"";
+/**
+ * Chain command — renders token-pilot's badge AND any other ecosystem
+ * badge (caveman) side by side. Opt-in via `--chain`.
+ */
 export declare const CHAIN_COMMAND = "bash \"$(ls -t ~/.claude/plugins/cache/token-pilot/token-pilot/*/hooks/statusline-chain.sh 2>/dev/null | head -1)\"";
 export interface InstallStatuslineResult {
     action: "installed" | "upgraded" | "noop" | "skipped";
     message: string;
 }
+export interface DecideStatuslineOpts {
+    force: boolean;
+    /** `--chain`: render caveman + [TP] together. Default false → [TP] only. */
+    chain: boolean;
+}
 /**
- * Pure decision: given the current statusline status, what should the
- * installer do? Separated from I/O for unit tests.
+ * Pure decision: given the current statusline status + options, what
+ * should the installer do and which command should it write?
+ *
+ * v0.42.3 — DEFAULT is now the TP-only badge. The previous default
+ * silently installed the chain wrapper, which also rendered caveman's
+ * badge — presumptuous (we install OUR badge, we don't decide that a
+ * third-party tool's badge belongs in your status bar). `--chain`
+ * opts into the combined view. token-pilot's own previous choices
+ * (tp-only ↔ chain) are switched freely; a non-token-pilot statusLine
+ * (caveman-only, custom) is never clobbered without `--force`.
  */
-export declare function decideStatuslineAction(status: StatuslineStatus, force: boolean): {
+export declare function decideStatuslineAction(status: StatuslineStatus, opts: DecideStatuslineOpts): {
     write: boolean;
+    command: string;
     result: InstallStatuslineResult;
 };
 /**

package/dist/cli/install-statusline.js

@@ -24,70 +24,73 @@
 import { readFile, writeFile, mkdir, access } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
-/** The version-agnostic chain command (auto-picks the newest plugin dir). */
+/** TP-only badge command (DEFAULT — just token-pilot's [TP] badge). */
+export const TP_ONLY_COMMAND = 'bash "$(ls -t ~/.claude/plugins/cache/token-pilot/token-pilot/*/hooks/tp-statusline.sh 2>/dev/null | head -1)"';
+/**
+ * Chain command — renders token-pilot's badge AND any other ecosystem
+ * badge (caveman) side by side. Opt-in via `--chain`.
+ */
 export const CHAIN_COMMAND = 'bash "$(ls -t ~/.claude/plugins/cache/token-pilot/token-pilot/*/hooks/statusline-chain.sh 2>/dev/null | head -1)"';
 /**
- * Pure decision: given the current statusline status, what should the
- * installer do? Separated from I/O for unit tests.
+ * Pure decision: given the current statusline status + options, what
+ * should the installer do and which command should it write?
+ *
+ * v0.42.3 — DEFAULT is now the TP-only badge. The previous default
+ * silently installed the chain wrapper, which also rendered caveman's
+ * badge — presumptuous (we install OUR badge, we don't decide that a
+ * third-party tool's badge belongs in your status bar). `--chain`
+ * opts into the combined view. token-pilot's own previous choices
+ * (tp-only ↔ chain) are switched freely; a non-token-pilot statusLine
+ * (caveman-only, custom) is never clobbered without `--force`.
  */
-export function decideStatuslineAction(status, force) {
+export function decideStatuslineAction(status, opts) {
+    const command = opts.chain ? CHAIN_COMMAND : TP_ONLY_COMMAND;
+    const badgeDesc = opts.chain ? "caveman + [TP] badges" : "[TP] badge";
+    const noWrite = (action, message) => ({
+        write: false,
+        command,
+        result: { action, message },
+    });
+    const doWrite = (action, message) => ({
+        write: true,
+        command,
+        result: { action, message },
+    });
     switch (status) {
         case "not-configured":
-            return {
-                write: true,
-                result: {
-                    action: "installed",
-                    message: "statusLine configured — the [TP] badge will show in your status bar (restart Claude Code).",
-                },
-            };
-        case "configured-caveman-only":
+            return doWrite("installed", `statusLine configured — the ${badgeDesc} will show in your status bar (restart Claude Code).`);
         case "configured-tp-only":
-            return {
-                write: true,
-                result: {
-                    action: "upgraded",
-                    message: "statusLine upgraded to the chain wrapper — both caveman and [TP] badges now render side by side.",
-                },
-            };
+            // Already ours. Switch only if the user asked for the chain.
+            return opts.chain
+                ? doWrite("upgraded", "statusLine upgraded to the chain wrapper — caveman + [TP] now render side by side.")
+                : noWrite("noop", "statusLine already shows the [TP] badge. Nothing to do.");
         case "configured-chain":
-            return {
-                write: false,
-                result: {
-                    action: "noop",
-                    message: "statusLine already uses the token-pilot chain wrapper. Nothing to do.",
-                },
-            };
+            // Also ours. Switch to tp-only unless the user wants the chain.
+            return opts.chain
+                ? noWrite("noop", "statusLine already uses the chain wrapper. Nothing to do.")
+                : doWrite("installed", "statusLine switched to the [TP]-only badge (caveman badge removed from the status bar).");
+        case "configured-caveman-only":
+            // Caveman's own statusline — NOT ours. Don't replace it silently.
+            if (opts.chain) {
+                return doWrite("upgraded", "statusLine upgraded to the chain wrapper — keeps caveman and adds [TP].");
+            }
+            if (opts.force) {
+                return doWrite("installed", "Replaced caveman's statusLine with the [TP]-only badge (--force).");
+            }
+            return noWrite("skipped", "Your statusLine is caveman's. Left untouched. Run with --chain to show " +
+                "both badges, or --force to replace it with [TP] only.");
         case "configured-other":
-            if (force) {
-                return {
-                    write: true,
-                    result: {
-                        action: "installed",
-                        message: "Replaced your custom statusLine with the token-pilot chain wrapper (--force).",
-                    },
-                };
+            if (opts.force) {
+                return doWrite("installed", `Replaced your custom statusLine with the ${badgeDesc} (--force).`);
             }
-            return {
-                write: false,
-                result: {
-                    action: "skipped",
-                    message: "You already have a custom statusLine — left untouched. " +
-                        "To show the [TP] badge too, set statusLine.command to:\n  " +
-                        CHAIN_COMMAND +
-                        "\nor re-run with --force to replace it.",
-                },
-            };
+            return noWrite("skipped", "You already have a custom statusLine — left untouched. To use the " +
+                `${badgeDesc}, re-run with --force, or set statusLine.command to:\n  ` +
+                command);
         case "unknown":
         default:
-            return {
-                write: false,
-                result: {
-                    action: "skipped",
-                    message: "Could not read ~/.claude/settings.json as JSON — not modifying it. " +
-                        "Add this manually under \"statusLine\":\n  " +
-                        CHAIN_COMMAND,
-                },
-            };
+            return noWrite("skipped", 'Could not read ~/.claude/settings.json as JSON — not modifying it. ' +
+                'Add this manually under "statusLine":\n  ' +
+                command);
     }
 }
 /**
@@ -126,9 +129,13 @@ export async function classifyStatuslineAt(settingsPath) {
  */
 export async function handleInstallStatusline(argv, opts) {
     const force = argv.includes("--force");
+    const chain = argv.includes("--chain");
     const settingsPath = opts?.settingsPath ?? join(homedir(), ".claude", "settings.json");
     const status = await classifyStatuslineAt(settingsPath);
-    const { write, result } = decideStatuslineAction(status, force);
+    const { write, command, result } = decideStatuslineAction(status, {
+        force,
+        chain,
+    });
     if (!write) {
         process.stdout.write(`[token-pilot] ${result.message}\n`);
         return 0;
@@ -145,7 +152,7 @@ export async function handleInstallStatusline(argv, opts) {
     catch {
         /* fresh file — start clean (only reached when status was safe) */
     }
-    settings.statusLine = { type: "command", command: CHAIN_COMMAND };
+    settings.statusLine = { type: "command", command };
     try {
         await mkdir(dirname(settingsPath), { recursive: true });
         await writeFile(settingsPath, JSON.stringify(settings, null, 2) + "\n");

package/package.json

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