@tienne/gestalt 0.15.1 → 0.16.0

package/dist/src/execute/orchestrators/execution.js

@@ -0,0 +1,328 @@
+import { ExecuteError, ExecuteSessionNotFoundError, TaskExecutionError, } from '../../core/errors.js';
+import { ok, err } from '../../core/result.js';
+import { EXECUTION_PRINCIPLE_STRATEGY } from '../../core/constants.js';
+import { GestaltPrinciple } from '../../core/types.js';
+import { EventType } from '../../events/types.js';
+import { EXECUTE_EXECUTION_SYSTEM_PROMPT, buildTaskExecutionPrompt, buildDriftRetrospectivePrompt, } from '../prompts.js';
+import { measureDrift } from '../drift-detector.js';
+import { DRIFT_THRESHOLD } from '../../core/constants.js';
+import { mergeSystemPrompt } from '../../agent/prompt-resolver.js';
+import { codeGraphEngine } from '../../code-graph/index.js';
+import { RoleMatchEngine } from '../../agent/role-match-engine.js';
+import { RolePromptGenerator } from '../../agent/role-prompt-generator.js';
+import { RoleConsensusEngine } from '../../agent/role-consensus-engine.js';
+// ─── Helpers ─────────────────────────────────────────────────────
+function extractKeywords(text) {
+    const stopWords = new Set([
+        'the',
+        'a',
+        'an',
+        'and',
+        'or',
+        'but',
+        'in',
+        'on',
+        'at',
+        'to',
+        'for',
+        'of',
+        'with',
+        'by',
+        '—',
+        '+',
+    ]);
+    return text
+        .replace(/[^\w\s가-힣]/g, ' ')
+        .split(/\s+/)
+        .filter((w) => w.length > 2 && !stopWords.has(w.toLowerCase()))
+        .slice(0, 5);
+}
+export class ExecutionOrchestrator {
+    sessionManager;
+    eventStore;
+    agentRegistry;
+    roleAgentRegistry;
+    constructor(sessionManager, eventStore, agentRegistry, roleAgentRegistry) {
+        this.sessionManager = sessionManager;
+        this.eventStore = eventStore;
+        this.agentRegistry = agentRegistry;
+        this.roleAgentRegistry = roleAgentRegistry;
+    }
+    startExecution(sessionId) {
+        try {
+            const session = this.sessionManager.get(sessionId);
+            if (session.status !== 'plan_complete') {
+                return err(new TaskExecutionError(`Cannot start execution: session status is "${session.status}", expected "plan_complete"`));
+            }
+            if (!session.executionPlan) {
+                return err(new TaskExecutionError('No execution plan found'));
+            }
+            this.sessionManager.startExecution(sessionId);
+            const taskContext = this.buildNextTaskContext(this.sessionManager.get(sessionId));
+            return ok({
+                session: this.sessionManager.get(sessionId),
+                taskContext,
+                allTasksCompleted: taskContext === null,
+            });
+        }
+        catch (e) {
+            if (e instanceof ExecuteSessionNotFoundError)
+                return err(e);
+            return err(new TaskExecutionError(`Failed to start execution: ${e instanceof Error ? e.message : String(e)}`));
+        }
+    }
+    submitTaskResult(sessionId, taskResult, driftThreshold) {
+        try {
+            const session = this.sessionManager.get(sessionId);
+            if (session.status !== 'executing') {
+                return err(new TaskExecutionError(`Cannot submit task result: session status is "${session.status}", expected "executing"`));
+            }
+            if (!session.executionPlan) {
+                return err(new TaskExecutionError('No execution plan found'));
+            }
+            // Validate taskId exists in plan
+            const task = session.executionPlan.atomicTasks.find((t) => t.taskId === taskResult.taskId);
+            if (!task) {
+                return err(new TaskExecutionError(`Task "${taskResult.taskId}" not found in execution plan`));
+            }
+            this.sessionManager.addTaskResult(sessionId, taskResult);
+            // Clear role state from previous role_match/role_consensus cycle
+            this.sessionManager.clearRoleState(sessionId);
+            // Drift Detection (only for completed tasks)
+            let driftScore;
+            let retrospectiveContext;
+            if (taskResult.status === 'completed') {
+                const threshold = driftThreshold ?? DRIFT_THRESHOLD;
+                driftScore = measureDrift(session.spec, task, taskResult, threshold);
+                this.sessionManager.addDriftScore(sessionId, driftScore);
+                if (driftScore.thresholdExceeded) {
+                    this.eventStore.append('execute', sessionId, EventType.EXECUTE_DRIFT_RETROSPECTIVE, {
+                        taskId: taskResult.taskId,
+                        driftScore,
+                    });
+                    retrospectiveContext = {
+                        systemPrompt: mergeSystemPrompt(EXECUTE_EXECUTION_SYSTEM_PROMPT, this.agentRegistry, 'execute'),
+                        retrospectivePrompt: buildDriftRetrospectivePrompt(session.spec, task, taskResult, driftScore),
+                        driftScore,
+                    };
+                }
+            }
+            const updatedSession = this.sessionManager.get(sessionId);
+            const taskContext = this.buildNextTaskContext(updatedSession);
+            const allTasksCompleted = taskContext === null;
+            return ok({
+                session: updatedSession,
+                taskContext,
+                allTasksCompleted,
+                driftScore,
+                retrospectiveContext,
+            });
+        }
+        catch (e) {
+            if (e instanceof ExecuteSessionNotFoundError)
+                return err(e);
+            return err(new TaskExecutionError(`Failed to submit task result: ${e instanceof Error ? e.message : String(e)}`));
+        }
+    }
+    // ─── Role Agent System ──────────────────────────────────────
+    /**
+     * role_match: 2-call passthrough pattern.
+     * - Call 1 (no matchResult): Returns matchContext for current task
+     * - Call 2 (with matchResult): Stores matches, returns perspectivePrompts
+     */
+    roleMatch(sessionId, matchResult) {
+        try {
+            const session = this.sessionManager.get(sessionId);
+            if (session.status !== 'executing') {
+                return err(new TaskExecutionError(`Cannot perform role match: session status is "${session.status}", expected "executing"`));
+            }
+            const currentTask = this.getCurrentTask(session);
+            if (!currentTask) {
+                return err(new TaskExecutionError('No pending task found for role matching'));
+            }
+            // Call 1: Return match context
+            if (!matchResult) {
+                if (!this.roleAgentRegistry) {
+                    return err(new ExecuteError('RoleAgentRegistry not configured'));
+                }
+                this.eventStore.append('execute', sessionId, EventType.ROLE_MATCH_STARTED, {
+                    taskId: currentTask.taskId,
+                });
+                const engine = new RoleMatchEngine();
+                const matchContext = engine.generateMatchContext(currentTask.taskId, currentTask.title, currentTask.description, this.roleAgentRegistry.getAll());
+                return ok({ session, matchContext });
+            }
+            // Call 2: Submit match results, return perspective prompts
+            this.sessionManager.setRoleMatches(sessionId, currentTask.taskId, matchResult);
+            if (matchResult.length === 0) {
+                return ok({
+                    session: this.sessionManager.get(sessionId),
+                    perspectivePrompts: [],
+                });
+            }
+            if (!this.roleAgentRegistry) {
+                return err(new ExecuteError('RoleAgentRegistry not configured'));
+            }
+            const matchedAgents = matchResult
+                .map((m) => this.roleAgentRegistry.getByName(m.agentName))
+                .filter((a) => a !== undefined);
+            const generator = new RolePromptGenerator();
+            const perspectivePrompts = generator.generatePerspectivePrompts(currentTask.title, currentTask.description, matchedAgents);
+            return ok({
+                session: this.sessionManager.get(sessionId),
+                perspectivePrompts,
+            });
+        }
+        catch (e) {
+            if (e instanceof ExecuteSessionNotFoundError)
+                return err(e);
+            return err(new ExecuteError(`Failed role match: ${e instanceof Error ? e.message : String(e)}`));
+        }
+    }
+    /**
+     * role_consensus: 2-call passthrough pattern.
+     * - Call 1 (perspectives, no consensus): Returns synthesisContext
+     * - Call 2 (consensus): Stores consensus, returns roleGuidance
+     */
+    roleConsensus(sessionId, perspectives, consensus) {
+        try {
+            const session = this.sessionManager.get(sessionId);
+            if (session.status !== 'executing') {
+                return err(new TaskExecutionError(`Cannot perform role consensus: session status is "${session.status}", expected "executing"`));
+            }
+            const currentTask = this.getCurrentTask(session);
+            if (!currentTask) {
+                return err(new TaskExecutionError('No pending task found for role consensus'));
+            }
+            // Call 1: Submit perspectives, return synthesis context
+            if (perspectives && !consensus) {
+                this.eventStore.append('execute', sessionId, EventType.ROLE_CONSENSUS_STARTED, {
+                    taskId: currentTask.taskId,
+                    perspectiveCount: perspectives.length,
+                });
+                const engine = new RoleConsensusEngine();
+                const synthesisContext = engine.generateSynthesisContext(currentTask.title, currentTask.description, perspectives);
+                return ok({ session, synthesisContext });
+            }
+            // Call 2: Submit consensus, store in session
+            if (consensus) {
+                this.sessionManager.setRoleConsensus(sessionId, currentTask.taskId, consensus);
+                const roleGuidance = {
+                    agents: consensus.perspectives,
+                    consensus: consensus.consensus,
+                    conflictResolutions: consensus.conflictResolutions,
+                };
+                return ok({
+                    session: this.sessionManager.get(sessionId),
+                    roleGuidance,
+                });
+            }
+            return err(new ExecuteError('Either perspectives or consensus must be provided'));
+        }
+        catch (e) {
+            if (e instanceof ExecuteSessionNotFoundError)
+                return err(e);
+            return err(new ExecuteError(`Failed role consensus: ${e instanceof Error ? e.message : String(e)}`));
+        }
+    }
+    // ─── Semantic Hydration ───────────────────────────────────────────
+    /**
+     * suggestedFiles를 searchByHybrid(키워드+의미론)로 업그레이드.
+     * buildNextTaskContext()는 동기 유지, 호출측에서 필요 시 이 메서드로 보강한다.
+     */
+    async hydrateSuggestedFiles(context, repoRoot) {
+        if (!codeGraphEngine.dbExists(repoRoot))
+            return context;
+        try {
+            const query = extractKeywords(context.currentTask.title + ' ' + context.currentTask.description).join(' ');
+            const files = await codeGraphEngine.searchByHybrid(repoRoot, query, 10);
+            return { ...context, suggestedFiles: files };
+        }
+        catch {
+            // semantic 실패 시 기존 keyword-based suggestedFiles 유지
+            return context;
+        }
+    }
+    // ─── Execution context builders ────────────────────────────────
+    getCurrentTask(session) {
+        if (!session.executionPlan)
+            return null;
+        const plan = session.executionPlan;
+        const completedIds = new Set(session.taskResults
+            .filter((r) => r.status === 'completed' || r.status === 'skipped')
+            .map((r) => r.taskId));
+        const failedIds = new Set(session.taskResults.filter((r) => r.status === 'failed').map((r) => r.taskId));
+        const topoOrder = plan.dagValidation.topologicalOrder;
+        for (const taskId of topoOrder) {
+            if (completedIds.has(taskId) || failedIds.has(taskId))
+                continue;
+            const task = plan.atomicTasks.find((t) => t.taskId === taskId);
+            if (!task)
+                continue;
+            const depsResolved = task.dependsOn.every((dep) => completedIds.has(dep) || failedIds.has(dep));
+            if (depsResolved)
+                return task;
+        }
+        return null;
+    }
+    buildNextTaskContext(session) {
+        const nextTask = this.getCurrentTask(session);
+        if (!nextTask)
+            return null;
+        const plan = session.executionPlan;
+        const completedIds = new Set(session.taskResults
+            .filter((r) => r.status === 'completed' || r.status === 'skipped')
+            .map((r) => r.taskId));
+        const failedIds = new Set(session.taskResults.filter((r) => r.status === 'failed').map((r) => r.taskId));
+        // Find similar completed tasks (Similarity principle)
+        const similarTasks = this.findSimilarTasks(nextTask, plan.atomicTasks, completedIds);
+        const completedResults = session.taskResults.filter((r) => r.status === 'completed');
+        const pendingTasks = plan.atomicTasks.filter((t) => !completedIds.has(t.taskId) && !failedIds.has(t.taskId) && t.taskId !== nextTask.taskId);
+        // suggestedFiles 계산 (code-graph searchByKeywords 기반 — 동기 fallback)
+        // Semantic/hybrid upgrade는 호출측(MCP handler 등)에서 hydrateTaskContextSuggestedFiles()로 수행
+        let suggestedFiles;
+        if (session.codeGraphRepoRoot && codeGraphEngine.dbExists(session.codeGraphRepoRoot)) {
+            try {
+                const keywords = extractKeywords(nextTask.title + ' ' + nextTask.description);
+                const files = codeGraphEngine.searchByKeywords(session.codeGraphRepoRoot, keywords);
+                suggestedFiles = files.slice(0, 10);
+            }
+            catch {
+                // graceful fallback — suggestedFiles remains undefined
+            }
+        }
+        const taskPrompt = buildTaskExecutionPrompt(nextTask, session.spec, completedResults, similarTasks, suggestedFiles);
+        // Include roleGuidance if available from a previous role_match/role_consensus cycle
+        const roleGuidance = session.roleConsensus
+            ? {
+                agents: session.roleConsensus.perspectives,
+                consensus: session.roleConsensus.consensus,
+                conflictResolutions: session.roleConsensus.conflictResolutions,
+            }
+            : undefined;
+        return {
+            systemPrompt: mergeSystemPrompt(EXECUTE_EXECUTION_SYSTEM_PROMPT, this.agentRegistry, 'execute'),
+            taskPrompt,
+            phase: 'executing',
+            currentTask: nextTask,
+            similarityStrategy: EXECUTION_PRINCIPLE_STRATEGY[GestaltPrinciple.SIMILARITY],
+            pendingTasks,
+            completedTaskIds: Array.from(completedIds),
+            roleGuidance,
+            suggestedFiles,
+        };
+    }
+    findSimilarTasks(target, allTasks, completedIds) {
+        return allTasks.filter((t) => {
+            if (!completedIds.has(t.taskId))
+                return false;
+            if (t.taskId === target.taskId)
+                return false;
+            // Same complexity or overlapping sourceAC = similar
+            const sharedAC = t.sourceAC.some((ac) => target.sourceAC.includes(ac));
+            const sameComplexity = t.estimatedComplexity === target.estimatedComplexity;
+            return sharedAC || sameComplexity;
+        });
+    }
+}
+//# sourceMappingURL=execution.js.map

package/dist/src/execute/orchestrators/execution.js.map

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

package/dist/src/execute/orchestrators/planning.d.ts

@@ -0,0 +1,26 @@
+import type { Spec, PlanningStepResult } from '../../core/types.js';
+import { ExecuteError } from '../../core/errors.js';
+import { type Result } from '../../core/result.js';
+import { EventStore } from '../../events/store.js';
+import { ExecuteSessionManager } from '../session.js';
+import type { AgentRegistry } from '../../agent/registry.js';
+import type { RoleAgentRegistry } from '../../agent/role-agent-registry.js';
+import type { PassthroughStartResult, PassthroughPlanStepResult, PassthroughPlanCompleteResult } from './types.js';
+export declare class PlanningOrchestrator {
+    private sessionManager;
+    private eventStore;
+    private agentRegistry?;
+    constructor(sessionManager: ExecuteSessionManager, eventStore: EventStore, agentRegistry?: AgentRegistry | undefined, _roleAgentRegistry?: RoleAgentRegistry);
+    start(spec: Spec, opts?: {
+        codeGraphRepoRoot?: string;
+    }): Result<PassthroughStartResult, ExecuteError>;
+    planStep(sessionId: string, stepResult: PlanningStepResult): Result<PassthroughPlanStepResult, ExecuteError>;
+    planComplete(sessionId: string): Result<PassthroughPlanCompleteResult, ExecuteError>;
+    private validateStepResult;
+    private validateFigureGround;
+    private validateClosure;
+    private validateProximity;
+    private crossValidateDAG;
+    private buildExecuteContext;
+}
+//# sourceMappingURL=planning.d.ts.map

package/dist/src/execute/orchestrators/planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../../../src/execute/orchestrators/planning.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,IAAI,EAGJ,kBAAkB,EAKnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,YAAY,EAGb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,sBAAsB,CAAC;AAQ5D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAItD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAEV,sBAAsB,EACtB,yBAAyB,EACzB,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AAEpB,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,aAAa,CAAC;gBAFd,cAAc,EAAE,qBAAqB,EACrC,UAAU,EAAE,UAAU,EACtB,aAAa,CAAC,EAAE,aAAa,YAAA,EACrC,kBAAkB,CAAC,EAAE,iBAAiB;IAGxC,KAAK,CACH,IAAI,EAAE,IAAI,EACV,IAAI,GAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAO,GACxC,MAAM,CAAC,sBAAsB,EAAE,YAAY,CAAC;IAkB/C,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CAAC,yBAAyB,EAAE,YAAY,CAAC;IAoElD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,6BAA6B,EAAE,YAAY,CAAC;IAwEpF,OAAO,CAAC,kBAAkB;IAkB1B,OAAO,CAAC,oBAAoB;IA0B5B,OAAO,CAAC,eAAe;IAgDvB,OAAO,CAAC,iBAAiB;IAkDzB,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,mBAAmB;CAoB5B"}

package/dist/src/execute/orchestrators/planning.js

@@ -0,0 +1,269 @@
+import { randomUUID } from 'node:crypto';
+import { ExecuteError, ExecuteSessionNotFoundError, InvalidPlanningStepError, } from '../../core/errors.js';
+import { ok, err } from '../../core/result.js';
+import { PLANNING_PRINCIPLE_SEQUENCE, PLANNING_TOTAL_STEPS, PLANNING_PRINCIPLE_STRATEGIES, MAX_ATOMIC_TASKS, MAX_TASK_GROUPS, } from '../../core/constants.js';
+import { EventType } from '../../events/types.js';
+import { EXECUTE_SYSTEM_PROMPT, buildPlanningStepPrompt } from '../prompts.js';
+import { validateDAG } from '../dag-validator.js';
+import { computeParallelGroups } from '../parallel-groups.js';
+import { mergeSystemPrompt } from '../../agent/prompt-resolver.js';
+export class PlanningOrchestrator {
+    sessionManager;
+    eventStore;
+    agentRegistry;
+    constructor(sessionManager, eventStore, agentRegistry, _roleAgentRegistry) {
+        this.sessionManager = sessionManager;
+        this.eventStore = eventStore;
+        this.agentRegistry = agentRegistry;
+    }
+    start(spec, opts = {}) {
+        try {
+            const session = this.sessionManager.create(spec, {
+                codeGraphRepoRoot: opts.codeGraphRepoRoot,
+            });
+            const executeContext = this.buildExecuteContext(spec, 1, []);
+            return ok({ session, executeContext });
+        }
+        catch (e) {
+            return err(new ExecuteError(`Failed to start execute session: ${e instanceof Error ? e.message : String(e)}`));
+        }
+    }
+    planStep(sessionId, stepResult) {
+        try {
+            const session = this.sessionManager.get(sessionId);
+            if (session.status !== 'planning') {
+                return err(new ExecuteError(`Session is not in planning state: ${session.status}`));
+            }
+            // Validate step order
+            const expectedStep = session.planningSteps.length + 1;
+            const expectedPrinciple = PLANNING_PRINCIPLE_SEQUENCE[expectedStep - 1];
+            if (stepResult.principle !== expectedPrinciple) {
+                return err(new InvalidPlanningStepError(`Expected principle "${expectedPrinciple}" for step ${expectedStep}, got "${stepResult.principle}"`));
+            }
+            // Validate step result content
+            const validationError = this.validateStepResult(session, stepResult);
+            if (validationError) {
+                return err(new InvalidPlanningStepError(validationError));
+            }
+            // For Continuity step: server-side cross-validation
+            if (stepResult.principle === 'continuity') {
+                const crossValidation = this.crossValidateDAG(session, stepResult);
+                if (crossValidation) {
+                    return err(new InvalidPlanningStepError(crossValidation));
+                }
+            }
+            this.sessionManager.addPlanningStep(sessionId, stepResult);
+            const isLastStep = session.planningSteps.length >= PLANNING_TOTAL_STEPS;
+            if (isLastStep) {
+                return ok({
+                    session: this.sessionManager.get(sessionId),
+                    isLastStep: true,
+                });
+            }
+            const nextStep = session.planningSteps.length + 1;
+            const executeContext = this.buildExecuteContext(session.spec, nextStep, session.planningSteps);
+            return ok({
+                session: this.sessionManager.get(sessionId),
+                executeContext,
+                isLastStep: false,
+            });
+        }
+        catch (e) {
+            if (e instanceof ExecuteSessionNotFoundError || e instanceof InvalidPlanningStepError) {
+                return err(e);
+            }
+            return err(new ExecuteError(`Failed to process planning step: ${e instanceof Error ? e.message : String(e)}`));
+        }
+    }
+    planComplete(sessionId) {
+        try {
+            const session = this.sessionManager.get(sessionId);
+            if (session.planningSteps.length < PLANNING_TOTAL_STEPS) {
+                return err(new ExecuteError(`Planning is not complete: ${session.planningSteps.length}/${PLANNING_TOTAL_STEPS} steps done`));
+            }
+            // Assemble ExecutionPlan from all steps
+            const fgStep = session.planningSteps.find((s) => s.principle === 'figure_ground');
+            const closureStep = session.planningSteps.find((s) => s.principle === 'closure');
+            const proximityStep = session.planningSteps.find((s) => s.principle === 'proximity');
+            const continuityStep = session.planningSteps.find((s) => s.principle === 'continuity');
+            if (!fgStep || !closureStep || !proximityStep || !continuityStep) {
+                return err(new ExecuteError('Missing planning step results'));
+            }
+            // Final DAG validation on server side
+            const serverDAG = validateDAG(closureStep.atomicTasks, proximityStep.taskGroups);
+            this.eventStore.append('execute', sessionId, EventType.EXECUTE_PLAN_VALIDATED, {
+                callerValid: continuityStep.dagValidation.isValid,
+                serverValid: serverDAG.isValid,
+            });
+            const parallelGroups = computeParallelGroups(closureStep.atomicTasks, serverDAG.topologicalOrder);
+            const plan = {
+                planId: randomUUID(),
+                specId: session.specId,
+                classifiedACs: fgStep.classifiedACs,
+                atomicTasks: closureStep.atomicTasks,
+                taskGroups: proximityStep.taskGroups,
+                dagValidation: serverDAG,
+                parallelGroups,
+                createdAt: new Date().toISOString(),
+            };
+            this.sessionManager.completePlan(sessionId, plan);
+            return ok({
+                session: this.sessionManager.get(sessionId),
+                executionPlan: plan,
+            });
+        }
+        catch (e) {
+            if (e instanceof ExecuteSessionNotFoundError) {
+                return err(e);
+            }
+            return err(new ExecuteError(`Failed to complete plan: ${e instanceof Error ? e.message : String(e)}`));
+        }
+    }
+    // ─── Validation helpers ───────────────────────────────────────
+    validateStepResult(session, stepResult) {
+        switch (stepResult.principle) {
+            case 'figure_ground':
+                return this.validateFigureGround(session.spec, stepResult);
+            case 'closure':
+                return this.validateClosure(session, stepResult);
+            case 'proximity':
+                return this.validateProximity(session, stepResult);
+            case 'continuity':
+                return null; // Cross-validated separately
+            default:
+                return `Unknown principle: ${stepResult.principle}`;
+        }
+    }
+    validateFigureGround(spec, result) {
+        const { classifiedACs } = result;
+        if (!classifiedACs || classifiedACs.length === 0) {
+            return 'classifiedACs is required and must not be empty';
+        }
+        const acCount = spec.acceptanceCriteria.length;
+        const indices = new Set(classifiedACs.map((ac) => ac.acIndex));
+        // Check all ACs are classified
+        for (let i = 0; i < acCount; i++) {
+            if (!indices.has(i)) {
+                return `AC index ${i} is not classified`;
+            }
+        }
+        // Check for out-of-range indices
+        for (const ac of classifiedACs) {
+            if (ac.acIndex < 0 || ac.acIndex >= acCount) {
+                return `AC index ${ac.acIndex} is out of range (0-${acCount - 1})`;
+            }
+        }
+        return null;
+    }
+    validateClosure(session, result) {
+        const { atomicTasks } = result;
+        if (!atomicTasks || atomicTasks.length === 0) {
+            return 'atomicTasks is required and must not be empty';
+        }
+        if (atomicTasks.length > MAX_ATOMIC_TASKS) {
+            return `Too many atomic tasks: ${atomicTasks.length} (max ${MAX_ATOMIC_TASKS})`;
+        }
+        // Check taskId uniqueness
+        const taskIds = new Set();
+        for (const task of atomicTasks) {
+            if (taskIds.has(task.taskId)) {
+                return `Duplicate taskId: ${task.taskId}`;
+            }
+            taskIds.add(task.taskId);
+        }
+        // Check sourceAC references
+        const fgStep = session.planningSteps.find((s) => s.principle === 'figure_ground');
+        if (fgStep) {
+            const validIndices = new Set(fgStep.classifiedACs.map((ac) => ac.acIndex));
+            for (const task of atomicTasks) {
+                if (!task.isImplicit) {
+                    for (const acIdx of task.sourceAC) {
+                        if (!validIndices.has(acIdx)) {
+                            return `Task "${task.taskId}" references invalid AC index ${acIdx}`;
+                        }
+                    }
+                }
+            }
+        }
+        // Check dependsOn references
+        for (const task of atomicTasks) {
+            for (const dep of task.dependsOn) {
+                if (!taskIds.has(dep)) {
+                    return `Task "${task.taskId}" depends on non-existent task "${dep}"`;
+                }
+            }
+        }
+        return null;
+    }
+    validateProximity(session, result) {
+        const { taskGroups } = result;
+        if (!taskGroups || taskGroups.length === 0) {
+            return 'taskGroups is required and must not be empty';
+        }
+        if (taskGroups.length > MAX_TASK_GROUPS) {
+            return `Too many task groups: ${taskGroups.length} (max ${MAX_TASK_GROUPS})`;
+        }
+        // Get valid task IDs from Closure step
+        const closureStep = session.planningSteps.find((s) => s.principle === 'closure');
+        if (!closureStep) {
+            return 'Closure step must be completed before Proximity';
+        }
+        const validTaskIds = new Set(closureStep.atomicTasks.map((t) => t.taskId));
+        const assignedTaskIds = new Set();
+        // Check groupId uniqueness
+        const groupIds = new Set();
+        for (const group of taskGroups) {
+            if (groupIds.has(group.groupId)) {
+                return `Duplicate groupId: ${group.groupId}`;
+            }
+            groupIds.add(group.groupId);
+            for (const tid of group.taskIds) {
+                if (!validTaskIds.has(tid)) {
+                    return `Group "${group.groupId}" references invalid task "${tid}"`;
+                }
+                if (assignedTaskIds.has(tid)) {
+                    return `Task "${tid}" is assigned to multiple groups`;
+                }
+                assignedTaskIds.add(tid);
+            }
+        }
+        // Check all tasks are grouped
+        for (const tid of validTaskIds) {
+            if (!assignedTaskIds.has(tid)) {
+                return `Task "${tid}" is not assigned to any group`;
+            }
+        }
+        return null;
+    }
+    crossValidateDAG(session, continuityResult) {
+        const closureStep = session.planningSteps.find((s) => s.principle === 'closure');
+        const proximityStep = session.planningSteps.find((s) => s.principle === 'proximity');
+        if (!closureStep || !proximityStep) {
+            return 'Closure and Proximity steps must be completed before Continuity';
+        }
+        const serverDAG = validateDAG(closureStep.atomicTasks, proximityStep.taskGroups);
+        // If caller says valid but server finds issues, flag it
+        if (continuityResult.dagValidation.isValid && !serverDAG.isValid) {
+            const issues = [...(serverDAG.cycleDetails ?? []), ...(serverDAG.conflictDetails ?? [])].join('; ');
+            return `Server-side DAG validation disagrees: ${issues}`;
+        }
+        return null;
+    }
+    // ─── Context builder ──────────────────────────────────────────
+    buildExecuteContext(spec, stepNumber, previousSteps) {
+        const principle = PLANNING_PRINCIPLE_SEQUENCE[stepNumber - 1];
+        const planningPrompt = buildPlanningStepPrompt(spec, stepNumber, previousSteps);
+        return {
+            systemPrompt: mergeSystemPrompt(EXECUTE_SYSTEM_PROMPT, this.agentRegistry, 'execute'),
+            planningPrompt,
+            currentPrinciple: principle,
+            principleStrategy: PLANNING_PRINCIPLE_STRATEGIES[principle],
+            phase: 'planning',
+            stepNumber,
+            totalSteps: PLANNING_TOTAL_STEPS,
+            spec,
+            previousSteps,
+        };
+    }
+}
+//# sourceMappingURL=planning.js.map