codehere 0.1.1

package/dist/application/agents/multi-agent-orchestrator.js

@@ -0,0 +1,296 @@
+/**
+ * Application: Multi-Agent Orchestrator
+ * Coordinates Planning, Execution, and Validation agents
+ *
+ * Based on enterprise architecture: Coordinator Pattern with specialized agents
+ * Uses Command R+ as orchestrator (when available) or current AI service
+ */
+import { PlanningAgent } from './planning-agent.js';
+import { ExecutionAgent } from './execution-agent.js';
+import { ValidationAgent } from './validation-agent.js';
+import { executionTracer } from '../../infrastructure/observability/execution-tracer.js';
+import { agentFeedbackManager } from '../../infrastructure/validation/agent-feedback.js';
+import { summaryAggregator } from '../../infrastructure/validation/summary-aggregator.js';
+import { findCodebaseRoot } from '../../domain/services/codebase-detector.js';
+export class MultiAgentOrchestrator {
+    aiService;
+    memoryStream;
+    memoryRepository;
+    toolExecutor;
+    verificationService;
+    sastScanner;
+    cwd;
+    planningAgent;
+    executionAgent;
+    validationAgent;
+    constructor(aiService, memoryStream, memoryRepository, toolExecutor, verificationService, sastScanner, cwd = process.cwd()) {
+        this.aiService = aiService;
+        this.memoryStream = memoryStream;
+        this.memoryRepository = memoryRepository;
+        this.toolExecutor = toolExecutor;
+        this.verificationService = verificationService;
+        this.sastScanner = sastScanner;
+        this.cwd = cwd;
+        // Initialize specialized agents
+        this.planningAgent = new PlanningAgent(aiService, memoryStream, memoryRepository, cwd);
+        this.executionAgent = new ExecutionAgent(aiService, toolExecutor, cwd);
+        this.validationAgent = new ValidationAgent(aiService, verificationService);
+    }
+    /**
+     * Orchestrate multi-agent workflow
+     * Coordinator Pattern: Plan → Execute → Validate → Feedback Loop
+     */
+    // TODO: Update task status during orchestration
+    // Update task.currentStep, task.totalSteps
+    // Update task.steps[].status
+    // Update task.status: RUNNING → COMPLETED/FAILED
+    // See: .internal/ARCHITECTURE.md (internal docs)
+    async orchestrate(request) {
+        const mode = request.mode || 'full';
+        // Create unified run context for entire orchestration
+        const codebaseInfo = findCodebaseRoot(this.cwd);
+        const unifiedRunId = executionTracer.startRun('multi-agent-orchestration', {
+            query: request.goal,
+            codebaseId: codebaseInfo?.codebaseId || codebaseInfo?.rootPath,
+        });
+        // Track summaries from each agent
+        const agentSummaries = [];
+        try {
+            // Phase 1: Planning (if needed)
+            let plan;
+            if (mode === 'full' || mode === 'plan-only') {
+                // Input validation
+                if (!request.goal || request.goal.trim().length === 0) {
+                    return {
+                        success: false,
+                        message: 'Goal cannot be empty',
+                    };
+                }
+                let planningResponse;
+                try {
+                    planningResponse = await this.planningAgent.createPlan({
+                        goal: request.goal,
+                        context: request.context,
+                        feedback: request.feedback, // Pass feedback from previous attempt for reflexion
+                    });
+                    plan = planningResponse.plan;
+                    // Capture planning summary
+                    if (planningResponse.validationSummary) {
+                        agentSummaries.push({
+                            agent: 'planning-agent',
+                            summary: planningResponse.validationSummary,
+                            runId: planningResponse.runId,
+                        });
+                    }
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    console.error('Orchestrator: Planning failed:', errorMessage);
+                    return {
+                        success: false,
+                        message: `Planning failed: ${errorMessage}`,
+                        plan: undefined,
+                    };
+                }
+                // Validate plan was generated
+                if (!plan) {
+                    return {
+                        success: false,
+                        message: 'Planning agent returned no plan',
+                        plan: undefined,
+                    };
+                }
+                if (!plan.subPlans || plan.subPlans.length === 0) {
+                    return {
+                        success: false,
+                        message: 'Planning agent returned plan with no sub-plans',
+                        plan,
+                    };
+                }
+                // If plan-only mode, return here
+                if (mode === 'plan-only') {
+                    // Aggregate summaries if available (filter out any undefined summaries)
+                    const validSummaries = agentSummaries.filter(s => s.summary !== undefined);
+                    const compositeSummary = validSummaries.length > 0
+                        ? summaryAggregator.mergeSummaries(validSummaries, unifiedRunId, 'multi-agent-orchestration')
+                        : undefined;
+                    executionTracer.endRun();
+                    return {
+                        plan,
+                        success: true,
+                        message: `Plan created with ${plan.subPlans.length} sub-plans (confidence: ${(planningResponse.confidence * 100).toFixed(0)}%)`,
+                        compositeSummary,
+                        unifiedRunId,
+                    };
+                }
+            }
+            if (!plan) {
+                return {
+                    success: false,
+                    message: 'No plan available for execution',
+                };
+            }
+            // Phase 2: Execution (if needed)
+            let execution;
+            if (mode === 'full' || mode === 'execute-only') {
+                execution = await this.executionAgent.execute({
+                    plan,
+                    context: request.context,
+                });
+                // Capture execution summary
+                if (execution.validationSummary) {
+                    agentSummaries.push({
+                        agent: 'execution-agent',
+                        summary: execution.validationSummary,
+                        runId: execution.runId,
+                    });
+                }
+                // If execute-only mode, return here
+                if (mode === 'execute-only') {
+                    // Aggregate summaries if available (filter out any undefined summaries)
+                    const validSummaries = agentSummaries.filter(s => s.summary !== undefined);
+                    const compositeSummary = validSummaries.length > 0
+                        ? summaryAggregator.mergeSummaries(validSummaries, unifiedRunId, 'multi-agent-orchestration')
+                        : undefined;
+                    executionTracer.endRun();
+                    return {
+                        plan,
+                        execution,
+                        success: execution.overallSuccess,
+                        message: `Execution completed: ${execution.completedSubPlans}/${execution.totalSubPlans} sub-plans`,
+                        compositeSummary,
+                        unifiedRunId,
+                    };
+                }
+            }
+            if (!execution) {
+                return {
+                    plan,
+                    success: false,
+                    message: 'Execution not performed',
+                };
+            }
+            // Phase 3: Validation
+            const filesModified = this.extractModifiedFiles(execution);
+            const validation = await this.validationAgent.validate({
+                plan,
+                executionResults: execution.results,
+                filesModified,
+            });
+            // Capture validation summary
+            if (validation.validationSummary) {
+                agentSummaries.push({
+                    agent: 'validation-agent',
+                    summary: validation.validationSummary,
+                    runId: validation.runId,
+                });
+            }
+            // Phase 4: Feedback Loop
+            // If validation fails, provide feedback for next iteration
+            let feedback;
+            if (!validation.success) {
+                feedback = this.generateFeedback(validation, execution);
+            }
+            // Aggregate all summaries into composite summary (filter out any undefined summaries)
+            const validSummaries = agentSummaries.filter(s => s.summary !== undefined);
+            const compositeSummary = validSummaries.length > 0
+                ? summaryAggregator.mergeSummaries(validSummaries, unifiedRunId, 'multi-agent-orchestration')
+                : undefined;
+            // Record in memory stream
+            await this.memoryStream.recordObservation(`Multi-agent orchestration completed for: "${request.goal}"`, {
+                goal: request.goal,
+                planId: plan.id,
+                executionSuccess: execution.overallSuccess,
+                validationSuccess: validation.success,
+                qualityScore: validation.qualityScore,
+            });
+            // End unified run context
+            executionTracer.endRun();
+            // Note: Feedback recording is handled by CLI commands with proper userAction
+            // This allows CLI to record feedback after review decision
+            return {
+                plan,
+                execution,
+                validation,
+                success: validation.success && execution.overallSuccess,
+                message: this.generateSuccessMessage(execution, validation),
+                feedback,
+                compositeSummary,
+                unifiedRunId,
+            };
+        }
+        catch (error) {
+            // End run context even on error
+            executionTracer.endRun();
+            // Record failure feedback
+            try {
+                agentFeedbackManager.recordFeedback({
+                    runId: unifiedRunId,
+                    agentName: 'multi-agent-orchestrator',
+                    operation: 'orchestrate',
+                    query: request.goal,
+                    outcome: 'failure',
+                    userAction: 'not_required', // Error case - no review flow
+                    errors: [error instanceof Error ? error.message : String(error)],
+                });
+            }
+            catch {
+                // Non-blocking
+            }
+            return {
+                success: false,
+                message: error instanceof Error ? error.message : String(error),
+                unifiedRunId,
+            };
+        }
+    }
+    /**
+     * Extract modified files from execution results
+     */
+    extractModifiedFiles(execution) {
+        const files = [];
+        for (const result of execution.results) {
+            if (result.result && typeof result.result === 'object') {
+                if ('filepath' in result.result) {
+                    files.push(result.result.filepath);
+                }
+            }
+        }
+        return [...new Set(files)]; // Deduplicate
+    }
+    /**
+     * Generate feedback for next iteration
+     */
+    generateFeedback(validation, execution) {
+        const feedback = [];
+        if (!validation.compilationSuccess) {
+            feedback.push(`Compilation errors: ${validation.compilationErrors?.slice(0, 2).join(', ')}`);
+        }
+        if (!validation.testsPassed) {
+            feedback.push('Tests are failing - review test results');
+        }
+        const failedSubPlans = execution.results.filter(r => !r.success);
+        if (failedSubPlans.length > 0) {
+            feedback.push(`${failedSubPlans.length} sub-plans failed: ${failedSubPlans.map(r => r.subPlanId).join(', ')}`);
+        }
+        if (validation.recommendations.length > 0) {
+            feedback.push(...validation.recommendations.slice(0, 3));
+        }
+        return feedback.join('. ');
+    }
+    /**
+     * Generate success message
+     */
+    generateSuccessMessage(execution, validation) {
+        if (validation.success && execution.overallSuccess) {
+            return `✅ Successfully completed: ${execution.completedSubPlans}/${execution.totalSubPlans} sub-plans executed, all tests passing (quality score: ${validation.qualityScore}/100)`;
+        }
+        else if (execution.overallSuccess) {
+            return `⚠️ Execution completed but validation issues: ${validation.recommendations.join(', ')}`;
+        }
+        else {
+            return `❌ Execution incomplete: ${execution.completedSubPlans}/${execution.totalSubPlans} sub-plans completed`;
+        }
+    }
+}
+//# sourceMappingURL=multi-agent-orchestrator.js.map

package/dist/application/agents/multi-agent-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-agent-orchestrator.js","sourceRoot":"","sources":["../../../src/application/agents/multi-agent-orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/application/agents/planning-agent.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Application Agent: Planning Agent (Architect)
+ * Specialized agent for creating detailed, step-by-step modification plans
+ *
+ * Based on enterprise architecture: Separate Planning Agent from PlanningUseCase
+ * Role: Creates detailed plans before execution
+ */
+import type { IAIService } from '../../domain/interfaces/ai-service.interface.js';
+import type { IMemoryRepository } from '../../domain/interfaces/memory-repository.interface.js';
+import { MemoryStreamService } from '../../infrastructure/storage/memory-stream-service.js';
+import type { Plan } from '../../domain/entities/plan.js';
+import type { Memory } from '../../domain/entities/memory.js';
+import type { DecisionRecorder } from '../../domain/services/decision-recorder.js';
+import type { IPatternRepository } from '../../domain/interfaces/pattern-repository.interface.js';
+import type { KnowledgeAccess } from '../../domain/services/knowledge-access.js';
+export interface PlanningRequest {
+    goal: string;
+    context?: {
+        files?: string[];
+        constraints?: string[];
+        requirements?: string[];
+    };
+    feedback?: string;
+}
+export interface PlanningResponse {
+    plan: Plan;
+    reflections: string[];
+    salientQuestions: string[];
+    memoriesUsed: Memory[];
+    confidence: number;
+    validationSummary?: any;
+    feedbackId?: string;
+    runId?: string;
+}
+export declare class PlanningAgent {
+    private aiService;
+    private memoryStream;
+    private memoryRepository;
+    private cwd;
+    private decisionRecorder?;
+    private patternRepository?;
+    private knowledgeAccess?;
+    private gitTool;
+    constructor(aiService: IAIService, memoryStream: MemoryStreamService, memoryRepository: IMemoryRepository, cwd?: string, decisionRecorder?: DecisionRecorder | undefined, // Optional - only record if provided
+    patternRepository?: IPatternRepository | undefined, // Optional - for pattern suggestions
+    knowledgeAccess?: KnowledgeAccess | undefined);
+    /**
+     * Create detailed modification plan
+     * This is the architect role - plans before execution
+     */
+    createPlan(request: PlanningRequest): Promise<PlanningResponse>;
+    /**
+     * Gather Git context for planning
+     */
+    private gatherGitContext;
+    /**
+     * Generate detailed hierarchical plan
+     */
+    private generateDetailedPlan;
+    /**
+     * Assess confidence in plan quality
+     */
+    private assessPlanConfidence;
+}
+//# sourceMappingURL=planning-agent.d.ts.map

package/dist/application/agents/planning-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-agent.d.ts","sourceRoot":"","sources":["../../../src/application/agents/planning-agent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iDAAiD,CAAC;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wDAAwD,CAAC;AAEhG,OAAO,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AAC5F,OAAO,KAAK,EAAE,IAAI,EAAW,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAG9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAEnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yDAAyD,CAAC;AAClG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAGjF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IAEnB,iBAAiB,CAAC,EAAE,GAAG,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,aAAa;IAItB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,gBAAgB,CAAC;IACzB,OAAO,CAAC,iBAAiB,CAAC;IAC1B,OAAO,CAAC,eAAe,CAAC;IAT1B,OAAO,CAAC,OAAO,CAAU;gBAGf,SAAS,EAAE,UAAU,EACrB,YAAY,EAAE,mBAAmB,EACjC,gBAAgB,EAAE,iBAAiB,EACnC,GAAG,GAAE,MAAsB,EAC3B,gBAAgB,CAAC,EAAE,gBAAgB,YAAA,EAAE,qCAAqC;IAC1E,iBAAiB,CAAC,EAAE,kBAAkB,YAAA,EAAE,qCAAqC;IAC7E,eAAe,CAAC,EAAE,eAAe,YAAA;IAK3C;;;OAGG;IACG,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuLrE;;OAEG;YACW,gBAAgB;IA2C9B;;OAEG;YACW,oBAAoB;IAgWlC;;OAEG;YACW,oBAAoB;CAYnC"}