@dotcontext/mcp 0.9.0

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

@@ -0,0 +1,337 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleHarness = handleHarness;
+const harness_1 = require("../../harness");
+const response_1 = require("./response");
+function normalizePolicyEffect(effect) {
+    if (effect === 'allow' || effect === 'deny' || effect === 'require_approval') {
+        return effect;
+    }
+    if (effect === 'warn' || effect === 'review') {
+        return 'require_approval';
+    }
+    return 'allow';
+}
+function normalizePolicyTarget(target, pathPattern, risk) {
+    if (target === 'tool' || target === 'action' || target === 'path' || target === 'risk') {
+        return target;
+    }
+    if (pathPattern) {
+        return 'path';
+    }
+    if (risk) {
+        return 'risk';
+    }
+    return 'action';
+}
+async function handleHarness(params, options) {
+    const service = new harness_1.HarnessExecutionService({ repoPath: options.repoPath });
+    const replayService = new harness_1.HarnessReplayService({ repoPath: options.repoPath });
+    const datasetService = new harness_1.HarnessDatasetService({ repoPath: options.repoPath });
+    try {
+        const inferPolicyAction = () => {
+            switch (params.scope) {
+                case 'artifact':
+                    return 'addArtifact';
+                case 'sensor':
+                    return 'runSensor';
+                case 'handoff':
+                    return 'createHandoff';
+                case 'task':
+                    return 'createTask';
+                case 'workflow':
+                default:
+                    return 'workflow';
+            }
+        };
+        switch (params.action) {
+            case 'createSession':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    session: await service.createSession({
+                        name: params.name,
+                        metadata: params.metadata,
+                    }),
+                });
+            case 'listSessions':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    sessions: await service.listSessions(),
+                });
+            case 'getSession':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    session: await service.getSession(params.sessionId),
+                });
+            case 'appendTrace':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    trace: await service.appendTrace(params.sessionId, {
+                        level: params.level,
+                        event: params.event,
+                        message: params.message,
+                        data: params.data,
+                    }),
+                });
+            case 'listTraces':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    traces: await service.listTraces(params.sessionId),
+                });
+            case 'addArtifact':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    artifact: await service.addArtifact(params.sessionId, {
+                        name: params.name,
+                        kind: params.kind,
+                        content: params.content,
+                        path: params.path,
+                        metadata: params.metadata,
+                    }),
+                });
+            case 'listArtifacts':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    artifacts: await service.listArtifacts(params.sessionId),
+                });
+            case 'checkpoint':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    session: await service.checkpointSession(params.sessionId, {
+                        note: params.note,
+                        data: params.data,
+                        artifactIds: params.artifactIds,
+                        pause: params.pause,
+                    }),
+                });
+            case 'resumeSession':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    session: await service.resumeSession(params.sessionId),
+                });
+            case 'completeSession':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    session: await service.completeSession(params.sessionId, params.note),
+                });
+            case 'failSession':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    session: await service.failSession(params.sessionId, params.message),
+                });
+            case 'recordSensor':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    sensorRun: await service.runSensor({
+                        id: params.sensorId,
+                        name: params.sensorName || params.sensorId,
+                        description: params.description,
+                        severity: params.sensorSeverity,
+                        blocking: params.sensorBlocking,
+                        execute: async () => ({
+                            status: params.sensorStatus,
+                            summary: params.summary,
+                            evidence: params.evidence,
+                            output: params.output,
+                            details: params.details,
+                        }),
+                    }, {
+                        sessionId: params.sessionId,
+                        contractId: params.taskId,
+                        context: params.data,
+                        metadata: params.metadata,
+                    }),
+                });
+            case 'getSessionQuality':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    quality: await service.getSessionQuality(params.sessionId, {
+                        taskId: params.taskId,
+                        policy: {
+                            blockOnWarnings: params.blockOnWarnings,
+                            requireEvidence: params.requireEvidence,
+                        },
+                    }),
+                });
+            case 'createTask':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    task: await service.createTaskContract({
+                        title: params.title,
+                        description: params.description,
+                        sessionId: params.sessionId,
+                        owner: params.owner,
+                        inputs: params.inputs,
+                        expectedOutputs: params.expectedOutputs,
+                        acceptanceCriteria: params.acceptanceCriteria,
+                        requiredSensors: params.requiredSensors,
+                        requiredArtifacts: params.requiredArtifacts,
+                        status: params.status,
+                        metadata: params.metadata,
+                    }),
+                });
+            case 'listTasks':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    tasks: await service.listTaskContracts(),
+                });
+            case 'evaluateTask':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    evaluation: await service.evaluateTaskCompletion(params.taskId, params.sessionId),
+                });
+            case 'createHandoff':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    handoff: await service.createHandoffContract({
+                        from: params.from,
+                        to: params.to,
+                        sessionId: params.sessionId,
+                        taskId: params.taskId,
+                        artifacts: params.artifacts,
+                        evidence: params.evidence,
+                        metadata: params.metadata,
+                    }),
+                });
+            case 'listHandoffs':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    handoffs: await service.listHandoffContracts(),
+                });
+            case 'replaySession':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    replay: await replayService.replaySession(params.sessionId, {
+                        includePayloads: params.includePayloads,
+                        maxEvents: params.maxEvents,
+                    }),
+                });
+            case 'listReplays':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    replays: await replayService.listReplays(params.sessionId ? { sessionId: params.sessionId } : undefined),
+                });
+            case 'getReplay':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    replay: await replayService.getReplay(params.replayId),
+                });
+            case 'buildDataset':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    dataset: await datasetService.buildFailureDataset({
+                        sessionIds: params.sessionIds,
+                        includeSuccessfulSessions: params.includeSuccessfulSessions,
+                    }),
+                });
+            case 'listDatasets':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    datasets: await datasetService.listDatasets(),
+                });
+            case 'getDataset':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    dataset: await datasetService.getDataset(params.datasetId),
+                });
+            case 'getFailureClusters':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    clusters: await datasetService.getFailureClusters(params.datasetId),
+                });
+            case 'registerPolicy':
+                if (!params.effect) {
+                    return (0, response_1.createErrorResponse)('registerPolicy requires effect');
+                }
+                const effect = params.effect === 'allow' || params.effect === 'deny'
+                    ? params.effect
+                    : 'require_approval';
+                const target = params.target === 'tool'
+                    || params.target === 'action'
+                    || params.target === 'path'
+                    || params.target === 'risk'
+                    ? params.target
+                    : params.pathPattern
+                        ? 'path'
+                        : params.risk
+                            ? 'risk'
+                            : 'action';
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    rule: await service.registerPolicy({
+                        id: params.name || `policy-${Date.now()}`,
+                        effect,
+                        target,
+                        pattern: params.pattern || params.pathPattern || params.risk || inferPolicyAction(),
+                        approvalRole: params.owner,
+                        reason: params.description,
+                    }),
+                });
+            case 'listPolicies':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    rules: await service.listPolicies(),
+                });
+            case 'getPolicy':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    policy: await service.getPolicy(),
+                });
+            case 'setPolicy':
+                if (!params.policy) {
+                    return (0, response_1.createErrorResponse)('setPolicy requires policy');
+                }
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    policy: await service.setPolicy({
+                        defaultEffect: params.policy.defaultEffect,
+                        rules: (params.policy.rules ?? []).map((rule, index) => ({
+                            id: rule.id ?? `policy-${Date.now()}-${index}`,
+                            effect: normalizePolicyEffect(rule.effect),
+                            target: normalizePolicyTarget(rule.target, rule.pathPattern, rule.scope === 'risk' ? 'high' : undefined),
+                            pattern: rule.pattern ?? rule.pathPattern ?? rule.scope ?? 'harness',
+                            approvalRole: rule.approvalRole,
+                            reason: rule.reason ?? rule.description,
+                        })),
+                    }),
+                });
+            case 'resetPolicy':
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    policy: await service.resetPolicy(),
+                });
+            case 'evaluatePolicy':
+                const evaluationTarget = normalizePolicyTarget(params.target, params.pathPattern, params.risk);
+                const evaluationPath = params.pathPattern || params.path || (evaluationTarget === 'path' ? params.pattern : undefined);
+                const evaluationApproval = params.approvedBy || params.approvalRole || params.approvalNote
+                    ? {
+                        approvedBy: params.approvedBy,
+                        note: params.approvalNote,
+                    }
+                    : undefined;
+                return (0, response_1.createJsonResponse)({
+                    success: true,
+                    evaluation: await service.evaluatePolicy({
+                        tool: params.scope === 'workflow' ? 'workflow' : 'harness',
+                        action: evaluationTarget === 'action'
+                            ? (params.pattern || inferPolicyAction())
+                            : inferPolicyAction(),
+                        paths: evaluationPath ? [evaluationPath] : undefined,
+                        risk: evaluationTarget === 'risk'
+                            && (params.pattern === 'low' || params.pattern === 'medium' || params.pattern === 'high' || params.pattern === 'critical')
+                            ? params.pattern
+                            : params.risk,
+                        metadata: params.metadata,
+                        approval: evaluationApproval,
+                        approvalRole: params.approvalRole,
+                    }),
+                });
+            default:
+                return (0, response_1.createErrorResponse)(`Unknown harness action: ${params.action}`);
+        }
+    }
+    catch (error) {
+        return (0, response_1.createErrorResponse)(error);
+    }
+}
+//# sourceMappingURL=harness.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * Gateway Tools Module
+ *
+ * Exports all gateway handlers, types, and response utilities.
+ * This module consolidates MCP tools into gateway and dedicated workflow entry points.
+ *
+ * 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, HarnessAction, ExploreParams, ContextParams, SyncParams, PlanParams, AgentParams, SkillParams, HarnessParams, } 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 { handleHarness, type HarnessOptions } from './harness';
+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,aAAa,EACb,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,aAAa,GACd,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;AACzD,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAG/D,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,55 @@
+"use strict";
+/**
+ * Gateway Tools Module
+ *
+ * Exports all gateway handlers, types, and response utilities.
+ * This module consolidates MCP tools into gateway and dedicated workflow entry points.
+ *
+ * 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.handleHarness = 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; } });
+var harness_1 = require("./harness");
+Object.defineProperty(exports, "handleHarness", { enumerable: true, get: function () { return harness_1.handleHarness; } });
+// 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;AAoB9C,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;AACpB,qCAA+D;AAAtD,wGAAA,aAAa,OAAA;AAEtB,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;AA+GD;;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 (fileReads > 20 && contextQueries < 5) {
+            recommendations.push('Use buildSemantic or getMap to reduce broad file reads');
+        }
+        else if (this.metrics.qaSearches === 0 && fileReads > 8) {
+            recommendations.push('Use getMap or buildSemantic to inspect the codebase before reading many files');
+        }
+        if (efficiency === 'low') {
+            recommendations.push('Treat generateQA/searchQA as optional helpers; start with semantic context and snapshots');
+        }
+        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');
+        }
+        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