openlore 2.0.8 → 2.0.10

package/dist/cli/commands/mcp.js

@@ -46,6 +46,11 @@ export { handleGetCallGraph, handleGetSubgraph, handleAnalyzeImpact, handleGetLo
 // ============================================================================
 // TOOL DEFINITIONS
 // ============================================================================
+// Spec 28 — the `directory` param is the one input every tool shares (50×). Its
+// description was a verbatim 38-char repeat on each tool; a single short shared
+// constant trims that lossless repeat from the cached tools/list prefix without
+// dropping the one fact that matters (it must be absolute, not relative).
+const DIR_DESC = 'Absolute project path';
 export const TOOL_DEFINITIONS = [
     {
         name: 'orient',
@@ -59,7 +64,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 task: {
                     type: 'string',
@@ -69,6 +74,14 @@ export const TOOL_DEFINITIONS = [
                     type: 'number',
                     description: 'Number of relevant functions to return (default: 5)',
                 },
+                tokenBudget: {
+                    type: 'number',
+                    description: 'Optional: cap relevantFunctions to ~this many tokens (highest-scored kept, exact duplicates collapsed); each item carries an `expand` handle for get_function_body',
+                },
+                lean: {
+                    type: 'boolean',
+                    description: 'Return only the navigation core (relevantFunctions + callPaths + specDomains); drop provenance/change-coupling/insertion-points/specs/decisions enrichment (each reachable via expand handles or dedicated tools). Lower per-call cost for shallow "who/where" lookups.',
+                },
             },
             required: ['directory', 'task'],
         },
@@ -97,8 +110,8 @@ export const TOOL_DEFINITIONS = [
     {
         name: 'get_architecture_overview',
         description: 'USE THIS WHEN: onboarding to an unknown codebase, or before planning a large feature. ' +
-            'Returns domain clusters, cross-cluster dependencies, global entry points, and critical hubs — ' +
-            'faster than reading package.json + directory tree yourself. Run analyze_codebase first.',
+            'Returns domain clusters, cross-cluster dependencies, global entry points, and critical hubs. ' +
+            'Run analyze_codebase first.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -131,14 +144,13 @@ export const TOOL_DEFINITIONS = [
         name: 'get_call_graph',
         description: 'Return the call graph for a project: hub functions (high fan-in), ' +
             'entry points (no internal callers), and architectural layer violations. ' +
-            'Supports TypeScript, JavaScript, Python, Go, Rust, Ruby, Java, C++. ' +
             'Run analyze_codebase first.',
         inputSchema: {
             type: 'object',
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
             },
             required: ['directory'],
@@ -150,7 +162,7 @@ export const TOOL_DEFINITIONS = [
             'Detects Type 1 (exact clones — identical after whitespace/comment normalization), ' +
             'Type 2 (structural clones — same structure with renamed variables), and ' +
             'Type 3 (near-clones with Jaccard similarity ≥ 0.7 on token n-grams). ' +
-            'No LLM calls required. Run analyze_codebase first.',
+            'Run analyze_codebase first.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -172,7 +184,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 filePattern: {
                     type: 'string',
@@ -195,7 +207,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 functionName: {
                     type: 'string',
@@ -233,7 +245,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 entryFunction: {
                     type: 'string',
@@ -266,7 +278,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 domain: {
                     type: 'string',
@@ -331,7 +343,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 symbol: {
                     type: 'string',
@@ -356,7 +368,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 changedSymbols: {
                     type: 'array',
                     items: { type: 'string' },
@@ -382,7 +394,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 ifDeleted: { type: 'string', description: 'Symbol name — returns what becomes dead if it is deleted (delete-impact mode)' },
                 maxResults: { type: 'number', description: 'Max candidate-dead results (default 100)' },
                 filePattern: { type: 'string', description: 'Only report candidates whose file path contains this substring' },
@@ -401,7 +413,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 baseRef: { type: 'string', description: 'Old state to diff against (default "HEAD")' },
                 headRef: { type: 'string', description: 'New state (a git ref). Omit to use the working tree.' },
                 maxResults: { type: 'number', description: 'Cap reported items per category (default 200)' },
@@ -420,7 +432,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 file: { type: 'string', description: 'A file to query its coupling/volatility. Omit for the most-volatile overview.' },
                 limit: { type: 'number', description: 'Cap results (default 20)' },
             },
@@ -439,7 +451,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 from: { type: 'string', description: 'Pre-edit mode: the file that would gain the import (relative or absolute). Requires "to".' },
                 to: { type: 'string', description: 'Pre-edit mode: the target file path or exported symbol being imported. Requires "from".' },
             },
@@ -457,7 +469,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 limit: {
                     type: 'number',
@@ -482,7 +494,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 limit: {
                     type: 'number',
@@ -512,7 +524,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 limit: {
                     type: 'number',
@@ -538,7 +550,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 filePath: {
                     type: 'string',
@@ -559,7 +571,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 filePath: {
                     type: 'string',
@@ -585,7 +597,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 description: {
                     type: 'string',
@@ -616,7 +628,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 query: {
                     type: 'string',
@@ -634,6 +646,10 @@ export const TOOL_DEFINITIONS = [
                     type: 'number',
                     description: 'Only return functions with at least this many callers (hub filter)',
                 },
+                tokenBudget: {
+                    type: 'number',
+                    description: 'Optional: cap results to ~this many tokens (highest-scored kept, exact duplicates collapsed); each hit carries an `expand` handle for get_function_body',
+                },
             },
             required: ['directory', 'query'],
         },
@@ -645,7 +661,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
             },
             required: ['directory'],
         },
@@ -661,7 +677,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 query: {
                     type: 'string',
@@ -696,7 +712,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 query: {
                     type: 'string',
@@ -731,7 +747,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 domain: {
                     type: 'string',
                     description: 'Domain name as returned by list_spec_domains (e.g. "auth", "analyzer")',
@@ -749,7 +765,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 filePath: {
                     type: 'string',
                     description: 'File path relative to the project directory, e.g. "src/auth/jwt.ts"',
@@ -771,7 +787,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 filePath: {
                     type: 'string',
                     description: 'File path relative to the project root, e.g. "src/core/analyzer/vector-index.ts"',
@@ -798,7 +814,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 description: {
                     type: 'string',
@@ -832,7 +848,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 storyFilePath: {
                     type: 'string',
@@ -857,7 +873,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 query: {
                     type: 'string',
                     description: 'Optional text filter — returns only ADRs whose title or content contains this string',
@@ -878,7 +894,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
             },
             required: ['directory'],
         },
@@ -895,7 +911,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
             },
             required: ['directory'],
         },
@@ -911,7 +927,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
             },
             required: ['directory'],
         },
@@ -927,7 +943,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
             },
             required: ['directory'],
         },
@@ -944,7 +960,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
             },
             required: ['directory'],
         },
@@ -959,7 +975,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
             },
             required: ['directory'],
         },
@@ -976,7 +992,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 maxUncovered: {
                     type: 'number',
                     description: 'Maximum uncovered functions to return (default: 50)',
@@ -1004,7 +1020,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 domains: {
                     type: 'array',
@@ -1041,7 +1057,7 @@ export const TOOL_DEFINITIONS = [
             properties: {
                 directory: {
                     type: 'string',
-                    description: 'Absolute path to the project directory',
+                    description: DIR_DESC,
                 },
                 domains: {
                     type: 'array',
@@ -1066,7 +1082,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 functionName: { type: 'string', description: 'Exact function or method name' },
                 filePath: {
                     type: 'string',
@@ -1086,7 +1102,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 functionName: { type: 'string', description: 'Function name to look up the community for' },
             },
             required: ['directory', 'functionName'],
@@ -1103,7 +1119,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 base: {
                     type: 'string',
                     description: 'Git ref to diff against (default: HEAD). Use "HEAD~1" for last commit, "main" for branch diff.',
@@ -1122,7 +1138,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 title: { type: 'string', description: 'Short imperative statement, e.g. "Use UUIDs for decision IDs"' },
                 rationale: { type: 'string', description: 'Why this decision was made' },
                 consequences: { type: 'string', description: 'What changes as a result (optional)' },
@@ -1153,7 +1169,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 status: {
                     type: 'string',
                     enum: ['draft', 'consolidated', 'verified', 'phantom', 'approved', 'rejected', 'synced'],
@@ -1173,7 +1189,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 id: { type: 'string', description: '8-character decision ID from list_decisions' },
                 note: { type: 'string', description: 'Optional review note' },
             },
@@ -1186,7 +1202,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 id: { type: 'string', description: '8-character decision ID from list_decisions' },
                 note: { type: 'string', description: 'Optional reason for rejection' },
             },
@@ -1203,7 +1219,7 @@ export const TOOL_DEFINITIONS = [
         inputSchema: {
             type: 'object',
             properties: {
-                directory: { type: 'string', description: 'Absolute path to the project directory' },
+                directory: { type: 'string', description: DIR_DESC },
                 dryRun: { type: 'boolean', description: 'Preview without writing files (default: false)' },
                 id: { type: 'string', description: 'Sync only this specific decision ID (default: all approved)' },
             },
@@ -1383,8 +1399,8 @@ async function startMcpServer(options = {}) {
             // generous overrides in MCP_TOOL_TIMEOUT_OVERRIDES.
             await withToolTimeout((async () => {
                 if (name === 'orient') {
-                    const { task, limit = 5 } = args;
-                    result = await handleOrient(directory, task, limit);
+                    const { task, limit = 5, tokenBudget, lean } = args;
+                    result = await handleOrient(directory, task, limit, tokenBudget, lean);
                     if (result && typeof result === 'object') {
                         const r = result;
                         emit(directory, 'orient', {
@@ -1482,8 +1498,8 @@ async function startMcpServer(options = {}) {
                     result = await handleCheckSpecDrift(directory, base, files, domains, failOn, maxFiles);
                 }
                 else if (name === 'search_code') {
-                    const { directory, query, limit = 10, language, minFanIn } = args;
-                    result = await handleSearchCode(directory, query, limit, language, minFanIn);
+                    const { directory, query, limit = 10, language, minFanIn, tokenBudget } = args;
+                    result = await handleSearchCode(directory, query, limit, language, minFanIn, tokenBudget);
                 }
                 else if (name === 'suggest_insertion_points') {
                     const { directory, description, limit = 5, language } = args;