mcp-adr-analysis-server 2.1.20 → 2.1.27

package/dist/src/tools/ce-mcp-tools.d.ts

@@ -0,0 +1,291 @@
+/**
+ * CE-MCP Tool Wrappers
+ *
+ * This module provides CE-MCP directive-based versions of high-token-cost tools.
+ * Instead of executing prompts directly with OpenRouter, these tools return
+ * orchestration directives that the host LLM can execute with minimal context.
+ *
+ * @see ADR-014: CE-MCP Architecture
+ * @see docs/IMPLEMENTATION-PLAN.md Phase 2
+ */
+import { OrchestrationDirective, StateMachineDirective } from '../types/ce-mcp.js';
+/**
+ * Arguments for CE-MCP analyze project ecosystem
+ */
+export interface CEMCPAnalyzeProjectEcosystemArgs {
+    projectPath: string;
+    analysisDepth?: 'basic' | 'standard' | 'comprehensive';
+    includeEnvironment?: boolean;
+    knowledgeEnhancement?: boolean;
+    learningEnabled?: boolean;
+    technologyFocus?: string[];
+    analysisScope?: string[];
+}
+/**
+ * CE-MCP version of analyzeProjectEcosystem
+ *
+ * Returns an orchestration directive instead of executing the analysis directly.
+ * This reduces token usage from ~12K to ~4K by:
+ * - Deferring context assembly to sandbox operations
+ * - Using lazy prompt loading
+ * - Eliminating intermediate LLM calls
+ *
+ * Token Savings Breakdown:
+ * - Knowledge generation: 3K → on-demand
+ * - Memory retrieval: 2K → on-demand
+ * - Environment analysis: 2.5K → on-demand
+ * - Project structure: 2K → on-demand
+ * - Reflexion context: 2K → on-demand
+ */
+export declare function createAnalyzeProjectEcosystemDirective(args: CEMCPAnalyzeProjectEcosystemArgs): OrchestrationDirective;
+/**
+ * Arguments for CE-MCP ADR suggestion
+ */
+export interface CEMCPSuggestAdrsArgs {
+    projectPath: string;
+    codeChanges?: string;
+    focusAreas?: string[];
+    maxSuggestions?: number;
+}
+/**
+ * CE-MCP version of suggest_adrs
+ *
+ * Returns a state machine directive for multi-step ADR generation.
+ * Reduces token usage from ~3.5K to ~1.5K by:
+ * - Lazy loading ADR templates
+ * - Deferring code analysis to sandbox
+ * - Using state machine for sequential steps
+ */
+export declare function createSuggestAdrsDirective(args: CEMCPSuggestAdrsArgs): StateMachineDirective;
+/**
+ * Arguments for CE-MCP rule generation
+ */
+export interface CEMCPGenerateRulesArgs {
+    projectPath: string;
+    ruleType: 'code-quality' | 'security' | 'architecture' | 'testing';
+    targetFramework?: string;
+    severity?: 'error' | 'warning' | 'info';
+}
+/**
+ * CE-MCP version of generate_rules
+ *
+ * Returns an orchestration directive for rule generation.
+ * Reduces token usage from ~4K to ~1.5K by:
+ * - Lazy loading rule templates
+ * - Deferring validation to sandbox
+ * - Caching generated rules
+ */
+export declare function createGenerateRulesDirective(args: CEMCPGenerateRulesArgs): OrchestrationDirective;
+/**
+ * Arguments for CE-MCP environment analysis
+ */
+export interface CEMCPAnalyzeEnvironmentArgs {
+    projectPath: string;
+    analysisType?: 'quick' | 'standard' | 'comprehensive';
+    includeInfrastructure?: boolean;
+}
+/**
+ * CE-MCP version of analyze_environment
+ *
+ * Returns an orchestration directive for environment analysis.
+ * Reduces token usage from ~2.5K to ~1K by:
+ * - Deferring file scanning to sandbox
+ * - Using cached environment patterns
+ * - Lazy loading environment prompts
+ */
+export declare function createAnalyzeEnvironmentDirective(args: CEMCPAnalyzeEnvironmentArgs): OrchestrationDirective;
+/**
+ * Arguments for CE-MCP deployment readiness
+ */
+export interface CEMCPDeploymentReadinessArgs {
+    projectPath: string;
+    targetEnvironment: 'development' | 'staging' | 'production';
+    checkTypes?: string[];
+}
+/**
+ * CE-MCP version of deployment_readiness
+ *
+ * Returns a state machine directive for deployment checks.
+ * Reduces token usage from ~2K to ~800 tokens by:
+ * - Sequential check execution in state machine
+ * - Lazy loading of deployment patterns
+ * - Early termination on critical failures
+ */
+export declare function createDeploymentReadinessDirective(args: CEMCPDeploymentReadinessArgs): StateMachineDirective;
+/**
+ * Arguments for CE-MCP smart score
+ */
+export interface CEMCPSmartScoreArgs {
+    projectPath: string;
+    includeDetails?: boolean;
+    scoringAreas?: string[];
+}
+/**
+ * CE-MCP version of smart_score
+ *
+ * Returns an orchestration directive for code quality scoring.
+ * Reduces token usage from ~6K to ~2K by:
+ * - Lazy loading scoring templates
+ * - Deferring file analysis to sandbox
+ * - Caching scoring results
+ */
+export declare function createSmartScoreDirective(args: CEMCPSmartScoreArgs): OrchestrationDirective;
+/**
+ * Arguments for CE-MCP perform research
+ */
+export interface CEMCPPerformResearchArgs {
+    topic: string;
+    depth?: 'quick' | 'standard' | 'deep';
+    outputFormat?: 'summary' | 'detailed' | 'structured';
+    sources?: string[];
+}
+/**
+ * CE-MCP version of perform_research
+ *
+ * Returns a state machine directive for research workflows.
+ * Reduces token usage from ~10K to ~3K by:
+ * - Lazy loading research templates
+ * - Sequential research phases in state machine
+ * - Caching intermediate results
+ */
+export declare function createPerformResearchDirective(args: CEMCPPerformResearchArgs): StateMachineDirective;
+/**
+ * Arguments for CE-MCP generate ADRs from PRD
+ */
+export interface CEMCPGenerateAdrsFromPrdArgs {
+    prdPath: string;
+    outputDirectory?: string;
+    maxAdrs?: number;
+    focusAreas?: string[];
+}
+/**
+ * CE-MCP version of generate_adrs_from_prd
+ *
+ * Returns a state machine directive for PRD-to-ADR generation.
+ * Reduces token usage from ~8K to ~3K by:
+ * - Lazy loading ADR templates
+ * - Sequential PRD analysis phases
+ * - Caching parsed PRD content
+ */
+export declare function createGenerateAdrsFromPrdDirective(args: CEMCPGenerateAdrsFromPrdArgs): StateMachineDirective;
+/**
+ * Arguments for CE-MCP interactive ADR planning
+ */
+export interface CEMCPInteractiveAdrPlanningArgs {
+    projectPath: string;
+    sessionMode?: 'guided' | 'free-form';
+    existingAdrs?: string[];
+}
+/**
+ * CE-MCP version of interactive_adr_planning
+ *
+ * Returns a state machine directive for interactive ADR sessions.
+ * Reduces token usage from ~6K to ~2K by:
+ * - Lazy loading planning templates
+ * - Sequential planning phases
+ * - Context-aware suggestions
+ */
+export declare function createInteractiveAdrPlanningDirective(args: CEMCPInteractiveAdrPlanningArgs): StateMachineDirective;
+/**
+ * Arguments for CE-MCP MCP planning
+ */
+export interface CEMCPMcpPlanningArgs {
+    goal: string;
+    constraints?: string[];
+    existingTools?: string[];
+}
+/**
+ * CE-MCP version of mcp_planning
+ *
+ * Returns an orchestration directive for MCP server planning.
+ * Reduces token usage from ~6K to ~2K by:
+ * - Lazy loading MCP patterns
+ * - Deferring analysis to sandbox
+ * - Caching planning results
+ */
+export declare function createMcpPlanningDirective(args: CEMCPMcpPlanningArgs): OrchestrationDirective;
+/**
+ * Arguments for CE-MCP troubleshoot guided workflow
+ */
+export interface CEMCPTroubleshootGuidedWorkflowArgs {
+    issue: string;
+    context?: string;
+    previousSteps?: string[];
+}
+/**
+ * CE-MCP version of troubleshoot_guided_workflow
+ *
+ * Returns a state machine directive for troubleshooting workflows.
+ * Reduces token usage from ~7K to ~2.5K by:
+ * - Lazy loading troubleshooting guides
+ * - Sequential diagnostic phases
+ * - Context-aware remediation
+ */
+export declare function createTroubleshootGuidedWorkflowDirective(args: CEMCPTroubleshootGuidedWorkflowArgs): StateMachineDirective;
+/**
+ * Arguments for CE-MCP tool chain orchestrator
+ */
+export interface CEMCPToolChainOrchestratorArgs {
+    operation: 'generate_plan' | 'analyze_intent' | 'suggest_tools' | 'validate_plan' | 'reality_check' | 'session_guidance';
+    userRequest: string;
+    projectContext: {
+        projectPath: string;
+        adrDirectory?: string;
+        todoPath?: string;
+        hasADRs?: boolean;
+        hasTODO?: boolean;
+        projectType?: string;
+    };
+    constraints?: {
+        maxSteps?: number;
+        timeLimit?: string;
+        excludeTools?: string[];
+        prioritizeSpeed?: boolean;
+    };
+    customInstructions?: string;
+    sessionContext?: {
+        conversationLength?: number;
+        previousActions?: string[];
+        confusionIndicators?: string[];
+        lastSuccessfulAction?: string;
+        stuckOnTask?: string;
+    };
+}
+/**
+ * CE-MCP version of tool_chain_orchestrator
+ *
+ * Returns an orchestration directive for tool chain planning.
+ * This eliminates the OpenRouter dependency by having the host LLM
+ * (which already has full context) generate the tool execution plan directly.
+ *
+ * Key insight: The host LLM is better positioned to create plans because:
+ * 1. It has the full conversation context
+ * 2. It knows what tools it has already tried
+ * 3. It can directly execute the plan without roundtrips
+ *
+ * Reduces token usage from ~8K to ~2K by:
+ * - Eliminating OpenRouter API call overhead
+ * - Providing structured directive format
+ * - Enabling direct host LLM execution
+ */
+export declare function createToolChainOrchestratorDirective(args: CEMCPToolChainOrchestratorArgs): OrchestrationDirective;
+/**
+ * Check if a tool should use CE-MCP directive mode
+ */
+export declare function shouldUseCEMCPDirective(toolName: string, config: {
+    mode: string;
+}): boolean;
+/**
+ * Get CE-MCP directive for a tool
+ */
+export declare function getCEMCPDirective(toolName: string, args: Record<string, unknown>): OrchestrationDirective | StateMachineDirective | null;
+/**
+ * Format CE-MCP directive as MCP response
+ */
+export declare function formatDirectiveResponse(directive: OrchestrationDirective | StateMachineDirective): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+//# sourceMappingURL=ce-mcp-tools.d.ts.map

package/dist/src/tools/ce-mcp-tools.d.ts.map

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