token-pilot 0.9.0 → 0.12.0

package/dist/server.js

@@ -28,9 +28,13 @@ 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 { handleSmartDiff } from './handlers/smart-diff.js';
+import { handleExploreArea } from './handlers/explore-area.js';
+import { handleSmartLog } from './handlers/smart-log.js';
+import { handleTestSummary } from './handlers/test-summary.js';
 import { detectContextMode } from './integration/context-mode-detector.js';
 import { estimateTokens } from './core/token-estimator.js';
-import { resolveSafePath, validateSmartReadArgs, validateReadSymbolArgs, validateReadRangeArgs, validateReadDiffArgs, validateFindUsagesArgs, validateSmartReadManyArgs, validateReadForEditArgs, validateRelatedFilesArgs, validateOutlineArgs, validateFindUnusedArgs, validateCodeAuditArgs, validateProjectOverviewArgs, validateModuleInfoArgs, } from './core/validation.js';
+import { resolveSafePath, validateSmartReadArgs, validateReadSymbolArgs, validateReadRangeArgs, validateReadDiffArgs, validateFindUsagesArgs, validateSmartReadManyArgs, validateReadForEditArgs, validateRelatedFilesArgs, validateOutlineArgs, validateFindUnusedArgs, validateCodeAuditArgs, validateProjectOverviewArgs, validateModuleInfoArgs, validateSmartDiffArgs, validateExploreAreaArgs, validateSmartLogArgs, validateTestSummaryArgs, } from './core/validation.js';
 export async function createServer(projectRoot, options) {
     const config = await loadConfig(projectRoot);
     const astIndex = new AstIndexClient(projectRoot, config.astIndex.timeout, {
@@ -183,6 +187,10 @@ export async function createServer(projectRoot, options) {
             '• Reading file again → smart_read (returns compact reminder, not full content)',
             '• Multiple files → smart_read_many (batch, max 20)',
             '• Code quality audit → code_audit (TODOs, deprecated, structural code patterns)',
+            '• Reviewing git changes → smart_diff (structural diff with symbol mapping, not raw patch)',
+            '• Starting work on an area → explore_area (outline + imports + tests + git log in one call)',
+            '• Understanding commit history → smart_log (structured git log with categories, not raw output)',
+            '• Running tests → test_summary (structured pass/fail summary, not 200 lines of raw output)',
             '',
             'WHEN TO USE DEFAULT TOOLS (Token Pilot adds no value):',
             '• Small files (≤200 lines) → smart_read returns full content anyway, same as Read',
@@ -201,7 +209,7 @@ export async function createServer(projectRoot, options) {
             '• Deep dive into specific code → read_symbol (after finding issues)',
             '• Module architecture → module_info (deps, dependents, public API, unused deps)',
             '',
-            'WORKFLOW: project_overview → smart_read → read_symbol → read_for_edit → edit → read_diff',
+            'WORKFLOW: project_overview → explore_area → smart_read → read_symbol → read_for_edit → edit → smart_diff',
         ].join('\n'),
     });
     server.setRequestHandler(ListToolsRequestSchema, () => ({
@@ -401,6 +409,60 @@ export async function createServer(projectRoot, options) {
                     required: ['module'],
                 },
             },
+            // --- Diff & exploration ---
+            {
+                name: 'smart_diff',
+                description: 'Use INSTEAD OF raw git diff. Shows changed files with AST symbol mapping — which functions/classes were modified/added/removed. Small diffs include hunks, large diffs show summary.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        scope: { type: 'string', enum: ['unstaged', 'staged', 'commit', 'branch'], description: 'Diff scope (default: "unstaged")' },
+                        path: { type: 'string', description: 'Filter to specific file or directory' },
+                        ref: { type: 'string', description: 'Git ref — required for scope="commit" (commit hash) or scope="branch" (branch name)' },
+                    },
+                },
+            },
+            {
+                name: 'explore_area',
+                description: 'One-call exploration of a directory: outline (all symbols), imports (external deps + who imports this area), tests (matching test files), recent git changes. Use INSTEAD OF separate outline + related_files + git log calls.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        path: { type: 'string', description: 'Directory path (or file path — will use its parent directory)' },
+                        include: {
+                            type: 'array',
+                            items: { type: 'string', enum: ['outline', 'imports', 'tests', 'changes'] },
+                            description: 'Sections to include (default: all)',
+                        },
+                    },
+                    required: ['path'],
+                },
+            },
+            {
+                name: 'smart_log',
+                description: 'Use INSTEAD OF raw git log. Structured commit history with category detection (feat/fix/refactor/docs), file stats, author breakdown. Filters by path and ref.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        path: { type: 'string', description: 'Filter to specific file or directory' },
+                        count: { type: 'number', description: 'Number of commits (default: 10, max: 50)' },
+                        ref: { type: 'string', description: 'Git ref — branch, tag, or commit (default: HEAD)' },
+                    },
+                },
+            },
+            {
+                name: 'test_summary',
+                description: 'Run tests and return structured summary: total/passed/failed/skipped + failure details. 200 lines of raw output → 10-15 lines. Supports vitest, jest, pytest, phpunit, go test, cargo test.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        command: { type: 'string', description: 'Test command to run (e.g., "npm test", "pytest", "go test ./...")' },
+                        runner: { type: 'string', enum: ['vitest', 'jest', 'pytest', 'phpunit', 'go', 'cargo', 'rspec', 'mocha'], description: 'Force specific parser (auto-detected if omitted)' },
+                        timeout: { type: 'number', description: 'Timeout in ms (default: 60000, max: 300000)' },
+                    },
+                    required: ['command'],
+                },
+            },
         ],
     }));
     // Helper: get real full-file token count for honest analytics
@@ -553,6 +615,40 @@ export async function createServer(projectRoot, options) {
                     analytics.record({ tool: 'module_info', path: moduleArgs.module, tokensReturned: estimateTokens(moduleText), tokensWouldBe: moduleWouldBe, timestamp: Date.now() });
                     return moduleResult;
                 }
+                case 'smart_diff': {
+                    const sdArgs = validateSmartDiffArgs(args);
+                    const sdResult = await handleSmartDiff(sdArgs, projectRoot, astIndex);
+                    const sdText = sdResult.content[0]?.text ?? '';
+                    const sdTokens = estimateTokens(sdText);
+                    analytics.record({ tool: 'smart_diff', path: sdArgs.path ?? sdArgs.scope ?? 'unstaged', tokensReturned: sdTokens, tokensWouldBe: sdResult.rawTokens || sdTokens, timestamp: Date.now() });
+                    return { content: sdResult.content };
+                }
+                case 'explore_area': {
+                    const eaArgs = validateExploreAreaArgs(args);
+                    const eaResult = await handleExploreArea(eaArgs, projectRoot, astIndex);
+                    const eaText = eaResult.content[0]?.text ?? '';
+                    const eaTokens = estimateTokens(eaText);
+                    // Without explore_area, agent would call: outline + related_files + git log = ~3-5x tokens
+                    const eaWouldBe = eaTokens * 4;
+                    analytics.record({ tool: 'explore_area', path: eaArgs.path, tokensReturned: eaTokens, tokensWouldBe: eaWouldBe, timestamp: Date.now() });
+                    return eaResult;
+                }
+                case 'smart_log': {
+                    const slArgs = validateSmartLogArgs(args);
+                    const slResult = await handleSmartLog(slArgs, projectRoot);
+                    const slText = slResult.content[0]?.text ?? '';
+                    const slTokens = estimateTokens(slText);
+                    analytics.record({ tool: 'smart_log', path: slArgs.path ?? 'all', tokensReturned: slTokens, tokensWouldBe: slResult.rawTokens || slTokens, timestamp: Date.now() });
+                    return { content: slResult.content };
+                }
+                case 'test_summary': {
+                    const tsArgs = validateTestSummaryArgs(args);
+                    const tsResult = await handleTestSummary(tsArgs, projectRoot);
+                    const tsText = tsResult.content[0]?.text ?? '';
+                    const tsTokens = estimateTokens(tsText);
+                    analytics.record({ tool: 'test_summary', path: tsArgs.command, tokensReturned: tsTokens, tokensWouldBe: tsResult.rawTokens || tsTokens, timestamp: Date.now() });
+                    return { content: tsResult.content };
+                }
                 default:
                     return {
                         content: [{ type: 'text', text: `Unknown tool: ${name}` }],

package/dist/types.d.ts

@@ -115,6 +115,10 @@ export interface TokenPilotConfig {
         adviseDelegation: boolean;
         largeNonCodeThreshold: number;
     };
+    updates: {
+        checkOnStartup: boolean;
+        autoUpdate: boolean;
+    };
     ignore: string[];
 }
 //# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "token-pilot",
-  "version": "0.9.0",
+  "version": "0.12.0",
   "description": "Save 60-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",