@dotcontext/cli 0.8.0

package/dist/services/mcp/mcpServer.d.ts

@@ -0,0 +1,101 @@
+/**
+ * MCP Server - Model Context Protocol server for Claude Code integration
+ *
+ * Exposes 9 tools (5 consolidated gateways + 4 dedicated workflow tools) for
+ * reduced context and simpler tool selection for AI agents.
+ *
+ * Simplified workflow: context init → fillSingle → workflow-init
+ */
+import { SemanticContextBuilder } from '../semantic/contextBuilder';
+export interface MCPServerOptions {
+    /** Default repository path for tools */
+    repoPath?: string;
+    /** Server name */
+    name?: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Optional injected SemanticContextBuilder for testing */
+    contextBuilder?: SemanticContextBuilder;
+}
+export declare class AIContextMCPServer {
+    private server;
+    private contextBuilder;
+    private readonly contextCache;
+    private options;
+    private transport;
+    private initialRepoPath;
+    private cachedRepoPath;
+    constructor(options?: MCPServerOptions);
+    /**
+     * Register tools: 5 consolidated gateways + 4 dedicated workflow tools
+     * Total: 9 tools for clear entry points and reduced AI cognitive load
+     *
+     * Project tools removed - use context({ action: "init" }) + workflow-init instead
+     *
+     * NOTE: repoPath is now determined dynamically via getRepoPath() at runtime,
+     * which uses smart initialization and client path caching.
+     */
+    private registerGatewayTools;
+    /**
+     * Register semantic context resources
+     * Uses initialRepoPath if found, otherwise process.cwd()
+     */
+    private registerResources;
+    /**
+     * Register PREVC workflow resources
+     * Uses initialRepoPath if found, otherwise process.cwd()
+     */
+    private registerWorkflowResources;
+    /**
+     * Initialize repo path with smart detection and caching
+     *
+     * Strategy:
+     * 1. If explicit options.repoPath provided, try to find project root from there
+     * 2. Otherwise search upward from process.cwd() for .context or .git
+     * 3. Set as initialRepoPath if found (for resources)
+     * 4. First valid repoPath from client gets cached for all subsequent tool calls
+     * 5. Fallback to process.cwd() if nothing found (allows flexible MCP usage)
+     */
+    private initializeRepoPath;
+    /**
+     * Find project root by searching upward for .context or .git
+     */
+    private findProjectRoot;
+    /**
+     * Cache a valid repoPath from client
+     * Only cache if it contains .context and we haven't cached yet
+     */
+    private cacheRepoPathIfValid;
+    /**
+     * Get the effective repo path for a tool call
+     * Priority: 1) explicit param, 2) cached path, 3) initial path, 4) process.cwd()
+     */
+    private getRepoPath;
+    private wrapWithActionLogging;
+    /**
+     * Validate path-related parameters against the workspace boundary.
+     * Throws SecurityError if any path escapes the workspace.
+     */
+    private validatePathParams;
+    private logToolResponse;
+    private logToolError;
+    private parseResponsePayload;
+    private buildResultSummary;
+    /**
+     * Start the MCP server with stdio transport
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the MCP server
+     */
+    stop(): Promise<void>;
+    /**
+     * Log message to stderr (not stdout, to avoid polluting MCP messages)
+     */
+    private log;
+}
+/**
+ * Create and start an MCP server
+ */
+export declare function startMCPServer(options?: MCPServerOptions): Promise<AIContextMCPServer>;
+//# sourceMappingURL=mcpServer.d.ts.map

package/dist/services/mcp/mcpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpServer.d.ts","sourceRoot":"","sources":["../../../src/services/mcp/mcpServer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,EAAE,sBAAsB,EAAsB,MAAM,4BAA4B,CAAC;AAoCxF,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,sBAAsB,CAAC;CACzC;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,cAAc,CAAuB;gBAEjC,OAAO,GAAE,gBAAqB;IAuB1C;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IAya5B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAuFzB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IA4DjC;;;;;;;;;OASG;YACW,kBAAkB;IAehC;;OAEG;YACW,eAAe;IAmB7B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,qBAAqB;IAqC7B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;YAYZ,eAAe;YA0Bf,YAAY;IAkB1B,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAIhG"}