@ai-coders/context 0.6.1 → 0.7.0

package/dist/services/mcp/gateway/context.js

@@ -0,0 +1,249 @@
+"use strict";
+/**
+ * Context Gateway Handler
+ *
+ * Handles context scaffolding and semantic context operations.
+ * Replaces: checkScaffolding, initializeContext, fillScaffolding, listFilesToFill,
+ *           fillSingleFile, getCodebaseMap, buildSemanticContext, scaffoldPlan
+ *
+ * New actions: searchQA, generateQA, getFlow, detectPatterns
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleContext = handleContext;
+const tools_1 = require("../../ai/tools");
+const contextBuilder_1 = require("../../semantic/contextBuilder");
+const codebaseAnalyzer_1 = require("../../semantic/codebaseAnalyzer");
+const qa_1 = require("../../qa");
+const response_1 = require("./response");
+const shared_1 = require("./shared");
+/**
+ * Handles context gateway actions for scaffolding and semantic context.
+ */
+async function handleContext(params, options) {
+    const repoPath = params.repoPath || options.repoPath;
+    try {
+        switch (params.action) {
+            case 'check': {
+                const result = await tools_1.checkScaffoldingTool.execute({ repoPath }, shared_1.toolContext);
+                return (0, response_1.createJsonResponse)(result);
+            }
+            case 'init': {
+                const result = await tools_1.initializeContextTool.execute({
+                    repoPath,
+                    type: params.type,
+                    outputDir: params.outputDir,
+                    semantic: params.semantic,
+                    include: params.include,
+                    exclude: params.exclude,
+                    autoFill: params.autoFill,
+                    skipContentGeneration: params.skipContentGeneration
+                }, shared_1.toolContext);
+                // Extract pending files from result for scaffold response
+                const pendingWrites = result.pendingWrites;
+                if (pendingWrites && pendingWrites.length > 0) {
+                    const enhancementPrompt = `SCAFFOLDING CREATED - CONTENT REQUIRED
+
+NEXT ACTIONS REQUIRED:
+1. Fill scaffold files with content using fillSingle for each pending file
+2. Initialize a PREVC workflow to enable structured development
+
+WORKFLOW:
+Step 1: Use context with action "fillSingle" for each file in pendingFiles array
+Step 2: Use workflow-init with name parameter to create workflow (creates .context/workflow/)
+
+Skip workflow-init ONLY if making trivial changes (typos, single-line edits).`;
+                    return (0, response_1.createScaffoldResponse)(result, {
+                        filesGenerated: pendingWrites.length,
+                        pendingFiles: pendingWrites.map(p => p.filePath),
+                        enhancementPrompt,
+                        nextSteps: [
+                            'REQUIRED: Call context with action "fillSingle" for each file in pendingFiles',
+                            'RECOMMENDED: Call workflow-init with name parameter after filling files',
+                            'OPTIONAL: Skip workflow-init only for trivial changes (typos, single edits)'
+                        ],
+                        repoPath,
+                    });
+                }
+                // If no pending files, still suggest workflow initialization
+                const responseData = result;
+                const enhancementPrompt = `✓ SCAFFOLDING READY
+
+RECOMMENDED NEXT ACTION:
+Initialize a PREVC workflow to enable structured development.
+
+Use workflow-init with name parameter to create workflow structure.
+This creates .context/workflow/ and enables phase-gated execution (Plan → Review → Execute → Verify → Complete).
+
+Skip ONLY for trivial changes (typos, single-line edits).`;
+                return (0, response_1.createScaffoldResponse)(responseData, {
+                    enhancementPrompt,
+                    nextSteps: [
+                        'RECOMMENDED: Call workflow-init with name parameter to enable PREVC phases',
+                        'OPTIONAL: Skip workflow-init only for trivial changes'
+                    ],
+                });
+            }
+            case 'fill': {
+                const result = await tools_1.fillScaffoldingTool.execute({
+                    repoPath,
+                    outputDir: params.outputDir,
+                    target: params.target,
+                    offset: params.offset,
+                    limit: params.limit
+                }, shared_1.toolContext);
+                return (0, response_1.createJsonResponse)(result);
+            }
+            case 'fillSingle': {
+                const result = await tools_1.fillSingleFileTool.execute({ repoPath, filePath: params.filePath }, shared_1.toolContext);
+                return (0, response_1.createJsonResponse)(result);
+            }
+            case 'listToFill': {
+                const result = await tools_1.listFilesToFillTool.execute({ repoPath, outputDir: params.outputDir, target: params.target }, shared_1.toolContext);
+                return (0, response_1.createJsonResponse)(result);
+            }
+            case 'getMap': {
+                const result = await tools_1.getCodebaseMapTool.execute({ repoPath, section: params.section }, shared_1.toolContext);
+                return (0, response_1.createJsonResponse)(result);
+            }
+            case 'buildSemantic': {
+                const isLocalBuilder = !!params.options;
+                const builder = isLocalBuilder
+                    ? new contextBuilder_1.SemanticContextBuilder(params.options)
+                    : options.contextBuilder;
+                try {
+                    let context;
+                    const contextType = (params.contextType || 'compact');
+                    switch (contextType) {
+                        case 'documentation':
+                            context = await builder.buildDocumentationContext(repoPath, params.targetFile);
+                            break;
+                        case 'playbook':
+                            context = await builder.buildPlaybookContext(repoPath, params.targetFile || 'generic');
+                            break;
+                        case 'plan':
+                            context = await builder.buildPlanContext(repoPath, params.targetFile);
+                            break;
+                        case 'compact':
+                        default:
+                            context = await builder.buildCompactContext(repoPath);
+                            break;
+                    }
+                    return (0, response_1.createTextResponse)(context);
+                }
+                finally {
+                    if (isLocalBuilder) {
+                        await builder.shutdown();
+                    }
+                }
+            }
+            case 'scaffoldPlan': {
+                const result = await tools_1.scaffoldPlanTool.execute({
+                    planName: params.planName,
+                    repoPath,
+                    outputDir: params.outputDir,
+                    title: params.title,
+                    summary: params.summary,
+                    semantic: params.semantic,
+                    autoFill: params.autoFill
+                }, shared_1.toolContext);
+                // Plan scaffold always needs enhancement
+                const typedResult = result;
+                const planPath = typedResult.planPath;
+                if (typedResult.success && planPath) {
+                    return (0, response_1.createScaffoldResponse)(typedResult, {
+                        filesGenerated: 1,
+                        pendingFiles: [planPath],
+                        repoPath,
+                    });
+                }
+                return (0, response_1.createJsonResponse)(result);
+            }
+            case 'searchQA': {
+                if (!params.query) {
+                    return (0, response_1.createErrorResponse)('Query is required for searchQA action');
+                }
+                const qaService = new qa_1.QAService(params.options);
+                try {
+                    const results = await qaService.search(repoPath, params.query);
+                    return (0, response_1.createJsonResponse)({
+                        query: params.query,
+                        results,
+                        count: results.length,
+                    });
+                }
+                finally {
+                    await qaService.shutdown();
+                }
+            }
+            case 'generateQA': {
+                const qaService = new qa_1.QAService(params.options);
+                try {
+                    const result = await qaService.generateFromCodebase(repoPath);
+                    return (0, response_1.createJsonResponse)({
+                        generated: result.generated.length,
+                        skipped: result.skipped,
+                        projectType: result.topicDetection.projectType,
+                        topics: result.topicDetection.topics.map((t) => t.slug),
+                        files: result.generated.map((e) => `${e.slug}.md`),
+                    });
+                }
+                finally {
+                    await qaService.shutdown();
+                }
+            }
+            case 'getFlow': {
+                if (!params.entryFile) {
+                    return (0, response_1.createErrorResponse)('entryFile is required for getFlow action');
+                }
+                const analyzer = new codebaseAnalyzer_1.CodebaseAnalyzer(params.options);
+                try {
+                    const flow = await analyzer.traceFlow(repoPath, params.entryFile, params.entryFunction);
+                    return (0, response_1.createJsonResponse)({
+                        entryPoint: flow.entryPoint,
+                        nodeCount: flow.nodes.length,
+                        edgeCount: flow.edges.length,
+                        mermaid: flow.mermaidDiagram,
+                        nodes: flow.nodes.slice(0, 20),
+                        edges: flow.edges.slice(0, 30),
+                    });
+                }
+                finally {
+                    await analyzer.shutdown();
+                }
+            }
+            case 'detectPatterns': {
+                const analyzer = new codebaseAnalyzer_1.CodebaseAnalyzer(params.options);
+                try {
+                    const patterns = await analyzer.detectFunctionalPatterns(repoPath);
+                    return (0, response_1.createJsonResponse)({
+                        hasAuthPattern: patterns.hasAuthPattern,
+                        hasDatabasePattern: patterns.hasDatabasePattern,
+                        hasApiPattern: patterns.hasApiPattern,
+                        hasCachePattern: patterns.hasCachePattern,
+                        hasQueuePattern: patterns.hasQueuePattern,
+                        hasWebSocketPattern: patterns.hasWebSocketPattern,
+                        hasLoggingPattern: patterns.hasLoggingPattern,
+                        hasValidationPattern: patterns.hasValidationPattern,
+                        hasErrorHandlingPattern: patterns.hasErrorHandlingPattern,
+                        hasTestingPattern: patterns.hasTestingPattern,
+                        patterns: patterns.patterns.map((p) => ({
+                            type: p.type,
+                            confidence: p.confidence,
+                            description: p.description,
+                            indicatorCount: p.indicators.length,
+                        })),
+                    });
+                }
+                finally {
+                    await analyzer.shutdown();
+                }
+            }
+            default:
+                return (0, response_1.createErrorResponse)(`Unknown context action: ${params.action}`);
+        }
+    }
+    catch (error) {
+        return (0, response_1.createErrorResponse)(error);
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/services/mcp/gateway/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/context.ts"],"names":[],"mappings":"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"}

package/dist/services/mcp/gateway/explore.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Explore Gateway Handler
+ *
+ * Handles file and code exploration operations.
+ * Replaces: readFile, listFiles, analyzeSymbols, searchCode, getFileStructure
+ */
+import type { ExploreParams } from './types';
+import type { MCPToolResponse } from './response';
+export interface ExploreOptions {
+    repoPath: string;
+}
+/**
+ * Handles explore gateway actions for file and code exploration.
+ */
+export declare function handleExplore(params: ExploreParams, options: ExploreOptions): Promise<MCPToolResponse>;
+//# sourceMappingURL=explore.d.ts.map

package/dist/services/mcp/gateway/explore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore.d.ts","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/explore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CA8D1B"}

package/dist/services/mcp/gateway/explore.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Explore Gateway Handler
+ *
+ * Handles file and code exploration operations.
+ * Replaces: readFile, listFiles, analyzeSymbols, searchCode, getFileStructure
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleExplore = handleExplore;
+const tools_1 = require("../../ai/tools");
+const response_1 = require("./response");
+const shared_1 = require("./shared");
+/**
+ * Handles explore gateway actions for file and code exploration.
+ */
+async function handleExplore(params, options) {
+    try {
+        switch (params.action) {
+            case 'read': {
+                const result = await tools_1.readFileTool.execute({ filePath: params.filePath, encoding: params.encoding }, shared_1.toolContext);
+                return (0, response_1.createJsonResponse)(result);
+            }
+            case 'list': {
+                const result = await tools_1.listFilesTool.execute({
+                    pattern: params.pattern,
+                    cwd: params.cwd || options.repoPath,
+                    ignore: params.ignore
+                }, shared_1.toolContext);
+                return (0, response_1.createJsonResponse)(result);
+            }
+            case 'analyze': {
+                const result = await tools_1.analyzeSymbolsTool.execute({ filePath: params.filePath, symbolTypes: params.symbolTypes }, shared_1.toolContext);
+                return (0, response_1.createJsonResponse)(result);
+            }
+            case 'search': {
+                const result = await tools_1.searchCodeTool.execute({
+                    pattern: params.pattern,
+                    fileGlob: params.fileGlob,
+                    maxResults: params.maxResults || 50,
+                    cwd: params.cwd || options.repoPath
+                }, shared_1.toolContext);
+                return (0, response_1.createJsonResponse)(result);
+            }
+            case 'getStructure': {
+                const result = await tools_1.getFileStructureTool.execute({
+                    rootPath: params.rootPath || options.repoPath || '.',
+                    maxDepth: params.maxDepth ?? 3,
+                    includePatterns: params.includePatterns
+                }, shared_1.toolContext);
+                return (0, response_1.createJsonResponse)(result);
+            }
+            default:
+                return (0, response_1.createErrorResponse)(`Unknown explore action: ${params.action}`);
+        }
+    }
+    catch (error) {
+        return (0, response_1.createErrorResponse)(error);
+    }
+}
+//# sourceMappingURL=explore.js.map

package/dist/services/mcp/gateway/explore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore.js","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/explore.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAsBH,sCAiEC;AArFD,0CAMwB;AAIxB,yCAAqE;AACrE,qCAAuC;AAMvC;;GAEG;AACI,KAAK,UAAU,aAAa,CACjC,MAAqB,EACrB,OAAuB;IAEvB,IAAI,CAAC;QACH,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,MAAM,GAAG,MAAM,oBAAY,CAAC,OAAQ,CACxC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,EACzD,oBAAW,CACZ,CAAC;gBACF,OAAO,IAAA,6BAAkB,EAAC,MAAM,CAAC,CAAC;YACpC,CAAC;YAED,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,MAAM,GAAG,MAAM,qBAAa,CAAC,OAAQ,CACzC;oBACE,OAAO,EAAE,MAAM,CAAC,OAAQ;oBACxB,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,QAAQ;oBACnC,MAAM,EAAE,MAAM,CAAC,MAAM;iBACtB,EACD,oBAAW,CACZ,CAAC;gBACF,OAAO,IAAA,6BAAkB,EAAC,MAAM,CAAC,CAAC;YACpC,CAAC;YAED,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,MAAM,GAAG,MAAM,0BAAkB,CAAC,OAAQ,CAC9C,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAS,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,EAC/D,oBAAW,CACZ,CAAC;gBACF,OAAO,IAAA,6BAAkB,EAAC,MAAM,CAAC,CAAC;YACpC,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,MAAM,GAAG,MAAM,sBAAc,CAAC,OAAQ,CAC1C;oBACE,OAAO,EAAE,MAAM,CAAC,OAAQ;oBACxB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE;oBACnC,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,QAAQ;iBAC7B,EACR,oBAAW,CACZ,CAAC;gBACF,OAAO,IAAA,6BAAkB,EAAC,MAAM,CAAC,CAAC;YACpC,CAAC;YAED,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,MAAM,MAAM,GAAG,MAAM,4BAAoB,CAAC,OAAQ,CAChD;oBACE,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,IAAI,GAAG;oBACpD,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;oBAC9B,eAAe,EAAE,MAAM,CAAC,eAAe;iBACxC,EACD,oBAAW,CACZ,CAAC;gBACF,OAAO,IAAA,6BAAkB,EAAC,MAAM,CAAC,CAAC;YACpC,CAAC;YAED;gBACE,OAAO,IAAA,8BAAmB,EAAC,2BAA2B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAA,8BAAmB,EAAC,KAAK,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/services/mcp/gateway/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Gateway Tools Module
+ *
+ * Exports all gateway handlers, types, and response utilities.
+ * This module consolidates tools into 9 MCP tools (5 gateways + 4 dedicated workflow tools).
+ *
+ * Note: Project tools (project-setup, project-report) have been removed.
+ * Use context({ action: "init" }) for scaffolding and workflow-init for workflows instead.
+ */
+export { type MCPToolResponse, createJsonResponse, createErrorResponse, createTextResponse, } from './response';
+export { minimalUI, mockTranslate, toolContext } from './shared';
+export type { ExploreAction, ContextAction, SyncAction, PlanAction, AgentAction, SkillAction, ExploreParams, ContextParams, SyncParams, PlanParams, AgentParams, SkillParams, } from './types';
+export { handleExplore, type ExploreOptions } from './explore';
+export { handleContext, type ContextOptions } from './context';
+export { handleWorkflowInit, type WorkflowInitParams, type WorkflowInitOptions } from './workflowInit';
+export { handleWorkflowStatus, type WorkflowStatusParams, type WorkflowStatusOptions } from './workflowStatus';
+export { handleWorkflowAdvance, type WorkflowAdvanceParams, type WorkflowAdvanceOptions } from './workflowAdvance';
+export { handleWorkflowManage, type WorkflowManageParams, type WorkflowManageOptions } from './workflowManage';
+export { handleSync, type SyncOptions } from './sync';
+export { handlePlan, type PlanOptions } from './plan';
+export { handleAgent, type AgentOptions } from './agent';
+export { handleSkill, type SkillOptions } from './skill';
+export { handleMetricsAction, recordContextQuery, recordFileRead, getMetrics, getMetricsSummary, resetMetrics, type SessionMetrics, type MetricsSummary, } from './metrics';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/mcp/gateway/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,KAAK,eAAe,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGjE,YAAY,EACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAG/D,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC/G,OAAO,EAAE,qBAAqB,EAAE,KAAK,qBAAqB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACnH,OAAO,EAAE,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE/G,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAGzD,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC"}

package/dist/services/mcp/gateway/index.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Gateway Tools Module
+ *
+ * Exports all gateway handlers, types, and response utilities.
+ * This module consolidates tools into 9 MCP tools (5 gateways + 4 dedicated workflow tools).
+ *
+ * Note: Project tools (project-setup, project-report) have been removed.
+ * Use context({ action: "init" }) for scaffolding and workflow-init for workflows instead.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetMetrics = exports.getMetricsSummary = exports.getMetrics = exports.recordFileRead = exports.recordContextQuery = exports.handleMetricsAction = exports.handleSkill = exports.handleAgent = exports.handlePlan = exports.handleSync = exports.handleWorkflowManage = exports.handleWorkflowAdvance = exports.handleWorkflowStatus = exports.handleWorkflowInit = exports.handleContext = exports.handleExplore = exports.toolContext = exports.mockTranslate = exports.minimalUI = exports.createTextResponse = exports.createErrorResponse = exports.createJsonResponse = void 0;
+// Response types and helpers
+var response_1 = require("./response");
+Object.defineProperty(exports, "createJsonResponse", { enumerable: true, get: function () { return response_1.createJsonResponse; } });
+Object.defineProperty(exports, "createErrorResponse", { enumerable: true, get: function () { return response_1.createErrorResponse; } });
+Object.defineProperty(exports, "createTextResponse", { enumerable: true, get: function () { return response_1.createTextResponse; } });
+// Shared utilities
+var shared_1 = require("./shared");
+Object.defineProperty(exports, "minimalUI", { enumerable: true, get: function () { return shared_1.minimalUI; } });
+Object.defineProperty(exports, "mockTranslate", { enumerable: true, get: function () { return shared_1.mockTranslate; } });
+Object.defineProperty(exports, "toolContext", { enumerable: true, get: function () { return shared_1.toolContext; } });
+// Consolidated gateway handlers
+var explore_1 = require("./explore");
+Object.defineProperty(exports, "handleExplore", { enumerable: true, get: function () { return explore_1.handleExplore; } });
+var context_1 = require("./context");
+Object.defineProperty(exports, "handleContext", { enumerable: true, get: function () { return context_1.handleContext; } });
+// Dedicated workflow handlers (split from consolidated gateway)
+var workflowInit_1 = require("./workflowInit");
+Object.defineProperty(exports, "handleWorkflowInit", { enumerable: true, get: function () { return workflowInit_1.handleWorkflowInit; } });
+var workflowStatus_1 = require("./workflowStatus");
+Object.defineProperty(exports, "handleWorkflowStatus", { enumerable: true, get: function () { return workflowStatus_1.handleWorkflowStatus; } });
+var workflowAdvance_1 = require("./workflowAdvance");
+Object.defineProperty(exports, "handleWorkflowAdvance", { enumerable: true, get: function () { return workflowAdvance_1.handleWorkflowAdvance; } });
+var workflowManage_1 = require("./workflowManage");
+Object.defineProperty(exports, "handleWorkflowManage", { enumerable: true, get: function () { return workflowManage_1.handleWorkflowManage; } });
+var sync_1 = require("./sync");
+Object.defineProperty(exports, "handleSync", { enumerable: true, get: function () { return sync_1.handleSync; } });
+var plan_1 = require("./plan");
+Object.defineProperty(exports, "handlePlan", { enumerable: true, get: function () { return plan_1.handlePlan; } });
+var agent_1 = require("./agent");
+Object.defineProperty(exports, "handleAgent", { enumerable: true, get: function () { return agent_1.handleAgent; } });
+var skill_1 = require("./skill");
+Object.defineProperty(exports, "handleSkill", { enumerable: true, get: function () { return skill_1.handleSkill; } });
+// Metrics
+var metrics_1 = require("./metrics");
+Object.defineProperty(exports, "handleMetricsAction", { enumerable: true, get: function () { return metrics_1.handleMetricsAction; } });
+Object.defineProperty(exports, "recordContextQuery", { enumerable: true, get: function () { return metrics_1.recordContextQuery; } });
+Object.defineProperty(exports, "recordFileRead", { enumerable: true, get: function () { return metrics_1.recordFileRead; } });
+Object.defineProperty(exports, "getMetrics", { enumerable: true, get: function () { return metrics_1.getMetrics; } });
+Object.defineProperty(exports, "getMetricsSummary", { enumerable: true, get: function () { return metrics_1.getMetricsSummary; } });
+Object.defineProperty(exports, "resetMetrics", { enumerable: true, get: function () { return metrics_1.resetMetrics; } });
+//# sourceMappingURL=index.js.map

package/dist/services/mcp/gateway/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,6BAA6B;AAC7B,uCAKoB;AAHlB,8GAAA,kBAAkB,OAAA;AAClB,+GAAA,mBAAmB,OAAA;AACnB,8GAAA,kBAAkB,OAAA;AAGpB,mBAAmB;AACnB,mCAAiE;AAAxD,mGAAA,SAAS,OAAA;AAAE,uGAAA,aAAa,OAAA;AAAE,qGAAA,WAAW,OAAA;AAkB9C,gCAAgC;AAChC,qCAA+D;AAAtD,wGAAA,aAAa,OAAA;AACtB,qCAA+D;AAAtD,wGAAA,aAAa,OAAA;AAEtB,gEAAgE;AAChE,+CAAuG;AAA9F,kHAAA,kBAAkB,OAAA;AAC3B,mDAA+G;AAAtG,sHAAA,oBAAoB,OAAA;AAC7B,qDAAmH;AAA1G,wHAAA,qBAAqB,OAAA;AAC9B,mDAA+G;AAAtG,sHAAA,oBAAoB,OAAA;AAE7B,+BAAsD;AAA7C,kGAAA,UAAU,OAAA;AACnB,+BAAsD;AAA7C,kGAAA,UAAU,OAAA;AACnB,iCAAyD;AAAhD,oGAAA,WAAW,OAAA;AACpB,iCAAyD;AAAhD,oGAAA,WAAW,OAAA;AAEpB,UAAU;AACV,qCASmB;AARjB,8GAAA,mBAAmB,OAAA;AACnB,6GAAA,kBAAkB,OAAA;AAClB,yGAAA,cAAc,OAAA;AACd,qGAAA,UAAU,OAAA;AACV,4GAAA,iBAAiB,OAAA;AACjB,uGAAA,YAAY,OAAA"}

package/dist/services/mcp/gateway/metrics.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Metrics Service
+ *
+ * Tracks context tool usage vs file reads to measure improvement.
+ * Helps evaluate the effectiveness of pre-computed context.
+ */
+/**
+ * Session metrics structure
+ */
+export interface SessionMetrics {
+    sessionId: string;
+    startTime: string;
+    contextQueries: number;
+    qaSearches: number;
+    flowQueries: number;
+    patternDetections: number;
+    fileReads: number;
+    tokensEstimate: number;
+    lastUpdated: string;
+}
+/**
+ * Metrics summary
+ */
+export interface MetricsSummary {
+    contextQueries: number;
+    fileReads: number;
+    ratio: number;
+    efficiency: 'high' | 'medium' | 'low';
+    tokensSaved: number;
+    recommendations: string[];
+}
+/**
+ * Record a context query (Q&A search, flow query, pattern detection)
+ */
+export declare function recordContextQuery(type: 'qa' | 'flow' | 'pattern' | 'other'): void;
+/**
+ * Record a file read operation
+ */
+export declare function recordFileRead(estimatedTokens?: number): void;
+/**
+ * Get current session metrics
+ */
+export declare function getMetrics(): SessionMetrics;
+/**
+ * Get metrics summary with recommendations
+ */
+export declare function getMetricsSummary(): MetricsSummary;
+/**
+ * Reset metrics for a new session
+ */
+export declare function resetMetrics(): void;
+/**
+ * Handle metrics gateway action
+ */
+export declare function handleMetricsAction(action: 'get' | 'summary' | 'reset'): object;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/services/mcp/gateway/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../src/services/mcp/gateway/metrics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAiHD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAElF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAE3C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAY/E"}

package/dist/services/mcp/gateway/metrics.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Metrics Service
+ *
+ * Tracks context tool usage vs file reads to measure improvement.
+ * Helps evaluate the effectiveness of pre-computed context.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordContextQuery = recordContextQuery;
+exports.recordFileRead = recordFileRead;
+exports.getMetrics = getMetrics;
+exports.getMetricsSummary = getMetricsSummary;
+exports.resetMetrics = resetMetrics;
+exports.handleMetricsAction = handleMetricsAction;
+/**
+ * In-memory metrics storage for the current session
+ */
+class MetricsStore {
+    constructor() {
+        this.metrics = this.createNewSession();
+    }
+    createNewSession() {
+        return {
+            sessionId: `session_${Date.now()}`,
+            startTime: new Date().toISOString(),
+            contextQueries: 0,
+            qaSearches: 0,
+            flowQueries: 0,
+            patternDetections: 0,
+            fileReads: 0,
+            tokensEstimate: 0,
+            lastUpdated: new Date().toISOString(),
+        };
+    }
+    recordContextQuery(type) {
+        this.metrics.contextQueries++;
+        this.metrics.lastUpdated = new Date().toISOString();
+        switch (type) {
+            case 'qa':
+                this.metrics.qaSearches++;
+                break;
+            case 'flow':
+                this.metrics.flowQueries++;
+                break;
+            case 'pattern':
+                this.metrics.patternDetections++;
+                break;
+        }
+    }
+    recordFileRead(estimatedTokens = 1000) {
+        this.metrics.fileReads++;
+        this.metrics.tokensEstimate += estimatedTokens;
+        this.metrics.lastUpdated = new Date().toISOString();
+    }
+    getMetrics() {
+        return { ...this.metrics };
+    }
+    getSummary() {
+        const { contextQueries, fileReads, tokensEstimate } = this.metrics;
+        // Calculate ratio (higher is better - more context queries, fewer file reads)
+        const ratio = fileReads > 0 ? contextQueries / fileReads : contextQueries > 0 ? Infinity : 0;
+        // Estimate tokens saved (average Q&A response ~500 tokens vs file read ~1000 tokens)
+        const tokensSaved = contextQueries * 500;
+        // Determine efficiency level
+        let efficiency;
+        if (ratio >= 2 || (contextQueries > 5 && fileReads < 10)) {
+            efficiency = 'high';
+        }
+        else if (ratio >= 0.5 || contextQueries > 0) {
+            efficiency = 'medium';
+        }
+        else {
+            efficiency = 'low';
+        }
+        // Generate recommendations
+        const recommendations = [];
+        if (this.metrics.qaSearches === 0) {
+            recommendations.push('Try using searchQA to find pre-computed answers before reading files');
+        }
+        if (this.metrics.flowQueries === 0 && fileReads > 5) {
+            recommendations.push('Use getFlow to understand execution paths instead of tracing through files');
+        }
+        if (this.metrics.patternDetections === 0 && fileReads > 10) {
+            recommendations.push('Use detectPatterns to understand codebase capabilities');
+        }
+        if (fileReads > 20 && contextQueries < 5) {
+            recommendations.push('Consider generating Q&A content with generateQA to reduce file reads');
+        }
+        if (efficiency === 'low') {
+            recommendations.push('Run context.generateQA to pre-compute answers for common questions');
+        }
+        return {
+            contextQueries,
+            fileReads,
+            ratio: Number.isFinite(ratio) ? Math.round(ratio * 100) / 100 : -1,
+            efficiency,
+            tokensSaved,
+            recommendations: recommendations.slice(0, 3),
+        };
+    }
+    reset() {
+        this.metrics = this.createNewSession();
+    }
+}
+// Singleton instance
+const metricsStore = new MetricsStore();
+/**
+ * Record a context query (Q&A search, flow query, pattern detection)
+ */
+function recordContextQuery(type) {
+    metricsStore.recordContextQuery(type);
+}
+/**
+ * Record a file read operation
+ */
+function recordFileRead(estimatedTokens) {
+    metricsStore.recordFileRead(estimatedTokens);
+}
+/**
+ * Get current session metrics
+ */
+function getMetrics() {
+    return metricsStore.getMetrics();
+}
+/**
+ * Get metrics summary with recommendations
+ */
+function getMetricsSummary() {
+    return metricsStore.getSummary();
+}
+/**
+ * Reset metrics for a new session
+ */
+function resetMetrics() {
+    metricsStore.reset();
+}
+/**
+ * Handle metrics gateway action
+ */
+function handleMetricsAction(action) {
+    switch (action) {
+        case 'get':
+            return getMetrics();
+        case 'summary':
+            return getMetricsSummary();
+        case 'reset':
+            resetMetrics();
+            return { success: true, message: 'Metrics reset' };
+        default:
+            return { error: `Unknown metrics action: ${action}` };
+    }
+}
+//# sourceMappingURL=metrics.js.map