mcp-adr-analysis-server 2.1.20 → 2.1.22

package/dist/src/utils/sandbox-executor.d.ts

@@ -0,0 +1,145 @@
+/**
+ * CE-MCP Sandbox Executor
+ *
+ * Executes orchestration directives in an isolated sandbox environment.
+ * Replaces direct OpenRouter calls with local execution of LLM-generated code.
+ *
+ * Performance Optimizations (Phase 4.4):
+ * - Parallel operation execution for independent operations
+ * - Batched file system operations
+ * - LRU cache with automatic eviction
+ * - Lazy dependency resolution
+ *
+ * @see ADR-014: CE-MCP Architecture
+ */
+import { OrchestrationDirective, StateMachineDirective, SandboxExecutionResult, CEMCPConfig } from '../types/ce-mcp.js';
+/**
+ * Default CE-MCP configuration
+ */
+export declare const DEFAULT_CEMCP_CONFIG: CEMCPConfig;
+/**
+ * Sandbox Executor Class
+ *
+ * Executes CE-MCP directives in an isolated environment with:
+ * - Process isolation (operation-level sandboxing)
+ * - Filesystem restrictions (project path only)
+ * - Resource limits (timeout, memory, operations)
+ * - State management (results persist across operations)
+ * - LRU cache eviction for memory efficiency (Phase 4.4)
+ */
+export declare class SandboxExecutor {
+    private config;
+    private operationCache;
+    private promptCache;
+    private cacheHits;
+    private cacheMisses;
+    constructor(config?: Partial<CEMCPConfig>);
+    /**
+     * Evict oldest entries when cache exceeds max size (LRU strategy)
+     */
+    private evictOldestEntries;
+    /**
+     * Execute an orchestration directive
+     */
+    executeDirective(directive: OrchestrationDirective | StateMachineDirective, projectPath: string): Promise<SandboxExecutionResult>;
+    /**
+     * Execute an orchestration directive
+     */
+    private executeOrchestrationDirective;
+    /**
+     * Execute a state machine directive
+     */
+    private executeStateMachineDirective;
+    /**
+     * Execute a single sandbox operation
+     */
+    private executeOperation;
+    /**
+     * Operation: Load domain-specific knowledge
+     */
+    private opLoadKnowledge;
+    /**
+     * Operation: Load prompt template (lazy loading)
+     */
+    private opLoadPrompt;
+    /**
+     * Operation: Analyze project files
+     */
+    private opAnalyzeFiles;
+    /**
+     * Operation: Scan environment configuration
+     * Optimized with parallel file checks (Phase 4.4)
+     */
+    private opScanEnvironment;
+    /**
+     * Operation: Generate context from multiple inputs
+     */
+    private opGenerateContext;
+    /**
+     * Operation: Compose final result
+     */
+    private opComposeResult;
+    /**
+     * Operation: Validate output against schema
+     */
+    private opValidateOutput;
+    /**
+     * Operation: Cache a result
+     */
+    private opCacheResult;
+    /**
+     * Operation: Retrieve cached result
+     */
+    private opRetrieveCache;
+    /**
+     * Create sandbox context for execution
+     */
+    private createContext;
+    /**
+     * Evaluate a condition
+     */
+    private evaluateCondition;
+    /**
+     * Generate cache key for an operation
+     */
+    private generateOperationCacheKey;
+    /**
+     * Get cached operation result (with LRU tracking)
+     */
+    private getCachedOperation;
+    /**
+     * Set cached operation result (with LRU eviction)
+     */
+    private setCachedOperation;
+    /**
+     * Compose result from composition directive
+     */
+    private composeResult;
+    /**
+     * Clear all caches
+     */
+    clearCaches(): void;
+    /**
+     * Get cache statistics (Phase 4.4 enhanced metrics)
+     */
+    getCacheStats(): {
+        operations: number;
+        prompts: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+    /**
+     * Reset cache statistics (useful for testing)
+     */
+    resetCacheStats(): void;
+}
+/**
+ * Get or create the global sandbox executor
+ */
+export declare function getSandboxExecutor(config?: Partial<CEMCPConfig>): SandboxExecutor;
+/**
+ * Reset the global sandbox executor
+ */
+export declare function resetSandboxExecutor(): void;
+//# sourceMappingURL=sandbox-executor.d.ts.map

package/dist/src/utils/sandbox-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-executor.d.ts","sourceRoot":"","sources":["../../../src/utils/sandbox-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EAGrB,sBAAsB,EACtB,WAAW,EAGZ,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAkBlC,CAAC;AAiBF;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAK;gBAEZ,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAIzC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACG,gBAAgB,CACpB,SAAS,EAAE,sBAAsB,GAAG,qBAAqB,EACzD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,sBAAsB,CAAC;IA0BlC;;OAEG;YACW,6BAA6B;IA+E3C;;OAEG;YACW,4BAA4B;IA8D1C;;OAEG;YACW,gBAAgB;IAyC9B;;OAEG;YACW,eAAe;IAuB7B;;OAEG;YACW,YAAY;IAgD1B;;OAEG;YACW,cAAc;IA+D5B;;;OAGG;YACW,iBAAiB;IAqD/B;;OAEG;YACW,iBAAiB;IAe/B;;OAEG;YACW,eAAe;IAwB7B;;OAEG;YACW,gBAAgB;IAa9B;;OAEG;YACW,aAAa;IAiB3B;;OAEG;YACW,eAAe;IAc7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAIjC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACH,WAAW,IAAI,IAAI;IAKnB;;OAEG;IACH,aAAa,IAAI;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB;IAWD;;OAEG;IACH,eAAe,IAAI,IAAI;CAIxB;AAOD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,eAAe,CAKjF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}