@llm-dev-ops/agentics-cli 1.4.59 → 1.4.69

package/dist/bundled-agents/copilot-agents/functions/dist/services/agents/objective-clarifier/objective-clarifier-agent.js

@@ -1,780 +0,0 @@
-"use strict";
-/**
- * Objective Clarifier Agent
- *
- * Purpose: Clarify ambiguous or incomplete objectives
- * Classification: INTENT_ANALYSIS, DECOMPOSITION
- * decision_type: objective_clarification
- *
- * Scope:
- * - Resolve ambiguity
- * - Normalize goals
- * - Identify missing constraints
- *
- * CONSTITUTION COMPLIANCE:
- * ✓ Stateless at runtime
- * ✓ Emits exactly ONE DecisionEvent per invocation
- * ✓ Persists ONLY via ruvector-service
- * ✓ NEVER connects directly to databases
- * ✓ NEVER executes SQL
- * ✓ NEVER modifies runtime behavior
- * ✓ NEVER orchestrates other agents
- * ✓ NEVER enforces policy
- * ✓ NEVER intercepts execution paths
- *
- * Must Never:
- * - Generate plans
- * - Define solutions
- * - Execute logic
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ObjectiveClarifierAgent = void 0;
-const uuid_1 = require("uuid");
-const contracts_1 = require("../contracts");
-const objective_clarifier_schemas_1 = require("../contracts/objective-clarifier-schemas");
-const AGENT_ID = 'objective-clarifier-agent';
-const AGENT_VERSION = '1.0.0';
-const DECISION_TYPE = 'objective_clarification';
-/**
- * Objective Clarifier Agent Implementation
- *
- * This agent analyzes objectives and identifies ambiguities, missing constraints,
- * and normalizes goals. It is purely analytical - it NEVER generates plans,
- * defines solutions, or executes any logic.
- */
-class ObjectiveClarifierAgent {
-    metadata = {
-        id: AGENT_ID,
-        name: 'Objective Clarifier Agent',
-        version: AGENT_VERSION,
-        classifications: [
-            contracts_1.AgentClassification.INTENT_ANALYSIS,
-            contracts_1.AgentClassification.DECOMPOSITION,
-        ],
-        decision_type: DECISION_TYPE,
-        description: 'Clarifies ambiguous or incomplete objectives by identifying ambiguities, missing constraints, and normalizing goals.',
-    };
-    persistence;
-    telemetry;
-    constructor(persistence, telemetry) {
-        this.persistence = persistence;
-        this.telemetry = telemetry;
-    }
-    /**
-     * Validate input against ObjectiveClarifierInputSchema
-     */
-    validateInput(input) {
-        return objective_clarifier_schemas_1.ObjectiveClarifierInputSchema.parse(input);
-    }
-    /**
-     * Invoke the objective clarifier agent
-     *
-     * DETERMINISTIC: Same input always produces same output structure
-     * STATELESS: No internal state modified
-     * NON-BLOCKING: Fully async
-     */
-    async invoke(input, executionRef) {
-        const startTime = Date.now();
-        try {
-            // Emit telemetry start
-            this.telemetry.recordStart(AGENT_ID, executionRef, input);
-            // Perform clarification analysis (pure analysis, no side effects)
-            const output = this.clarifyObjective(input);
-            // Validate output
-            const validatedOutput = objective_clarifier_schemas_1.ObjectiveClarifierOutputSchema.parse(output);
-            // Calculate confidence based on analysis quality
-            const confidence = this.calculateConfidence(validatedOutput);
-            // Constraints applied during clarification
-            const constraintsApplied = this.getAppliedConstraints(input);
-            // Create the DecisionEvent
-            const event = (0, contracts_1.createDecisionEvent)(AGENT_ID, AGENT_VERSION, DECISION_TYPE, input, validatedOutput, confidence, constraintsApplied, executionRef);
-            // Persist via ruvector-service (best-effort, non-blocking)
-            let persistence_status;
-            try {
-                await this.persistence.store(event);
-                persistence_status = { status: 'persisted' };
-            }
-            catch (persistError) {
-                const persistMessage = persistError instanceof Error ? persistError.message : 'Unknown persistence error';
-                console.error(`[${AGENT_ID}] RuVector persistence failed (non-blocking): ${persistMessage}`);
-                persistence_status = { status: 'skipped', error: persistMessage };
-            }
-            // Emit telemetry success
-            this.telemetry.recordSuccess(AGENT_ID, executionRef, Date.now() - startTime);
-            return {
-                status: 'success',
-                event,
-                persistence_status,
-            };
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-            const errorCode = this.classifyError(error);
-            // Emit telemetry failure
-            this.telemetry.recordFailure(AGENT_ID, executionRef, errorCode, errorMessage);
-            return (0, contracts_1.createErrorResult)(errorCode, errorMessage, executionRef);
-        }
-    }
-    /**
-     * Clarify the objective - Core analysis logic
-     *
-     * This is purely analytical. It NEVER:
-     * - Generates plans
-     * - Defines solutions
-     * - Executes logic
-     */
-    clarifyObjective(input) {
-        const clarificationId = (0, uuid_1.v4)();
-        const objective = input.objective;
-        // Detect ambiguities
-        const ambiguities = this.detectAmbiguities(objective, input.context);
-        // Identify missing constraints
-        const missingConstraints = this.identifyMissingConstraints(objective, input.context);
-        // Normalize goals
-        const normalizedGoals = this.normalizeGoals(objective);
-        // Determine status
-        const status = this.determineStatus(ambiguities, missingConstraints, normalizedGoals, objective);
-        // Generate clarified objective
-        const clarifiedObjective = this.generateClarifiedObjective(objective, ambiguities, missingConstraints, normalizedGoals, input.config?.auto_resolve_low_severity);
-        // Generate prioritized clarification questions
-        const clarificationQuestions = this.generateClarificationQuestions(ambiguities, missingConstraints, input.config?.max_questions ?? 10);
-        // Compute analysis metrics
-        const analysis = this.computeAnalysisMetrics(objective, ambiguities, missingConstraints, normalizedGoals);
-        return {
-            clarification_id: clarificationId,
-            original_objective: objective,
-            status,
-            ambiguities,
-            missing_constraints: missingConstraints,
-            normalized_goals: normalizedGoals,
-            clarified_objective: clarifiedObjective,
-            clarification_questions: clarificationQuestions,
-            analysis,
-            version: '1.0.0',
-        };
-    }
-    /**
-     * Detect ambiguities in the objective
-     */
-    detectAmbiguities(objective, context) {
-        const ambiguities = [];
-        const words = objective.toLowerCase().split(/\s+/);
-        // Pattern-based ambiguity detection (deterministic)
-        // 1. Vague quantifiers
-        const vagueQuantifiers = ['some', 'many', 'few', 'several', 'various', 'multiple', 'numerous'];
-        for (const quantifier of vagueQuantifiers) {
-            if (objective.toLowerCase().includes(quantifier)) {
-                ambiguities.push({
-                    id: `amb-quant-${quantifier}`,
-                    type: 'quantitative',
-                    source_text: this.findContextForWord(objective, quantifier),
-                    description: `The quantifier "${quantifier}" is vague and does not specify an exact amount.`,
-                    interpretations: [
-                        { interpretation: '2-5 items', likelihood: 0.4, assumptions: ['Small scale'] },
-                        { interpretation: '5-10 items', likelihood: 0.3, assumptions: ['Medium scale'] },
-                        { interpretation: '10+ items', likelihood: 0.3, assumptions: ['Larger scale'] },
-                    ],
-                    severity: 'medium',
-                    clarification_prompt: `How many specifically is meant by "${quantifier}"?`,
-                });
-            }
-        }
-        // 2. Temporal ambiguity
-        const vagueTemporals = ['soon', 'quickly', 'fast', 'later', 'eventually', 'asap'];
-        for (const temporal of vagueTemporals) {
-            if (objective.toLowerCase().includes(temporal)) {
-                ambiguities.push({
-                    id: `amb-temp-${temporal}`,
-                    type: 'temporal',
-                    source_text: this.findContextForWord(objective, temporal),
-                    description: `The temporal term "${temporal}" does not specify a concrete timeframe.`,
-                    interpretations: [
-                        { interpretation: 'Within hours', likelihood: 0.2, assumptions: ['Urgent'] },
-                        { interpretation: 'Within days', likelihood: 0.4, assumptions: ['Standard priority'] },
-                        { interpretation: 'Within weeks', likelihood: 0.4, assumptions: ['Lower priority'] },
-                    ],
-                    severity: 'medium',
-                    clarification_prompt: `What is the specific timeframe for "${temporal}"?`,
-                });
-            }
-        }
-        // 3. Scope ambiguity
-        const scopeIndicators = ['all', 'everything', 'entire', 'whole', 'complete'];
-        for (const indicator of scopeIndicators) {
-            if (objective.toLowerCase().includes(indicator)) {
-                ambiguities.push({
-                    id: `amb-scope-${indicator}`,
-                    type: 'scope',
-                    source_text: this.findContextForWord(objective, indicator),
-                    description: `The scope indicator "${indicator}" may have different interpretations of boundaries.`,
-                    interpretations: [
-                        { interpretation: 'Full system scope', likelihood: 0.5, assumptions: ['No exclusions'] },
-                        { interpretation: 'Primary components only', likelihood: 0.3, assumptions: ['Standard interpretation'] },
-                        { interpretation: 'Core functionality', likelihood: 0.2, assumptions: ['Minimal scope'] },
-                    ],
-                    severity: 'low',
-                    clarification_prompt: `What specifically is included in "${indicator}"? Are there any exclusions?`,
-                });
-            }
-        }
-        // 4. Referential ambiguity (pronouns without clear antecedents)
-        const pronouns = ['it', 'they', 'them', 'this', 'that', 'these', 'those'];
-        for (const pronoun of pronouns) {
-            const regex = new RegExp(`\\b${pronoun}\\b`, 'gi');
-            if (regex.test(objective) && !context?.existing_context) {
-                ambiguities.push({
-                    id: `amb-ref-${pronoun}`,
-                    type: 'referential',
-                    source_text: this.findContextForWord(objective, pronoun),
-                    description: `The pronoun "${pronoun}" has no clear antecedent in the provided context.`,
-                    interpretations: [
-                        { interpretation: 'Refers to the main subject', likelihood: 0.6, assumptions: ['Most recent noun'] },
-                        { interpretation: 'Refers to the system/project', likelihood: 0.4, assumptions: ['Contextual inference'] },
-                    ],
-                    severity: 'high',
-                    clarification_prompt: `What does "${pronoun}" refer to specifically?`,
-                });
-                break; // Only flag once
-            }
-        }
-        // 5. Conditional ambiguity
-        const conditionalIndicators = ['if', 'when', 'unless', 'depending'];
-        for (const indicator of conditionalIndicators) {
-            if (objective.toLowerCase().includes(indicator)) {
-                // Check if condition is fully specified
-                const conditionalContext = this.findContextForWord(objective, indicator);
-                if (!conditionalContext.includes('then') && !conditionalContext.includes(',')) {
-                    ambiguities.push({
-                        id: `amb-cond-${indicator}`,
-                        type: 'conditional',
-                        source_text: conditionalContext,
-                        description: `The conditional "${indicator}" may have an incomplete or ambiguous outcome.`,
-                        interpretations: [
-                            { interpretation: 'Proceed with action', likelihood: 0.5, assumptions: ['Positive case'] },
-                            { interpretation: 'Skip/alternative action', likelihood: 0.5, assumptions: ['Negative case'] },
-                        ],
-                        severity: 'medium',
-                        clarification_prompt: `What should happen ${indicator.toLowerCase()} the condition is not met?`,
-                    });
-                }
-            }
-        }
-        // 6. Semantic ambiguity (words with multiple meanings)
-        const polysemousWords = {
-            'run': ['execute', 'manage', 'operate'],
-            'handle': ['process', 'manage', 'grip'],
-            'service': ['API service', 'customer service', 'maintenance'],
-            'table': ['database table', 'UI table', 'data structure'],
-            'model': ['data model', 'ML model', 'business model'],
-        };
-        for (const [word, meanings] of Object.entries(polysemousWords)) {
-            if (words.includes(word)) {
-                ambiguities.push({
-                    id: `amb-sem-${word}`,
-                    type: 'semantic',
-                    source_text: this.findContextForWord(objective, word),
-                    description: `The word "${word}" has multiple possible meanings in this context.`,
-                    interpretations: meanings.map((meaning, i) => ({
-                        interpretation: meaning,
-                        likelihood: 1 / meanings.length,
-                        assumptions: [`Interpretation ${i + 1}`],
-                    })),
-                    severity: 'medium',
-                    clarification_prompt: `Which meaning of "${word}" is intended: ${meanings.join(', ')}?`,
-                });
-            }
-        }
-        return ambiguities;
-    }
-    /**
-     * Identify missing constraints
-     */
-    identifyMissingConstraints(objective, context) {
-        const constraints = [];
-        const objectiveLower = objective.toLowerCase();
-        const knownConstraints = context?.known_constraints || [];
-        // 1. Temporal constraints
-        const hasTemporalConstraint = knownConstraints.some(c => c.toLowerCase().includes('deadline') ||
-            c.toLowerCase().includes('by ') ||
-            c.toLowerCase().includes('within')) || /\b(by|within|before|after|deadline|due)\b/i.test(objective);
-        if (!hasTemporalConstraint) {
-            constraints.push({
-                id: 'missing-temporal',
-                category: 'temporal',
-                description: 'No timeline or deadline specified for completion.',
-                impact: 'Cannot prioritize or schedule work without knowing time constraints.',
-                severity: 'high',
-                clarification_prompt: 'What is the expected timeline or deadline for this objective?',
-                default_assumption: 'Standard project timeline will be applied.',
-            });
-        }
-        // 2. Resource constraints (budget, team, tools)
-        if (!objectiveLower.includes('budget') && !objectiveLower.includes('cost') &&
-            !knownConstraints.some(c => c.toLowerCase().includes('budget'))) {
-            constraints.push({
-                id: 'missing-budget',
-                category: 'resource',
-                description: 'No budget or cost constraints specified.',
-                impact: 'Cannot determine feasibility or scope without budget information.',
-                severity: 'medium',
-                clarification_prompt: 'Are there any budget or cost constraints for this objective?',
-                default_assumption: 'Standard budget allocation will be assumed.',
-            });
-        }
-        // 3. Quality constraints
-        if (!objectiveLower.includes('quality') && !objectiveLower.includes('standard') &&
-            !objectiveLower.includes('requirement') && !objectiveLower.includes('criteria')) {
-            constraints.push({
-                id: 'missing-quality',
-                category: 'quality',
-                description: 'No quality standards or acceptance criteria specified.',
-                impact: 'Cannot determine when the objective is satisfactorily achieved.',
-                severity: 'high',
-                clarification_prompt: 'What are the quality standards or acceptance criteria for this objective?',
-                default_assumption: 'Industry-standard quality practices will be followed.',
-            });
-        }
-        // 4. Scope boundaries
-        if (!objectiveLower.includes('scope') && !objectiveLower.includes('exclude') &&
-            !objectiveLower.includes('only') && !objectiveLower.includes('limit')) {
-            constraints.push({
-                id: 'missing-scope',
-                category: 'scope',
-                description: 'No explicit scope boundaries or exclusions defined.',
-                impact: 'Risk of scope creep without clear boundaries.',
-                severity: 'medium',
-                clarification_prompt: 'What is explicitly out of scope for this objective?',
-                default_assumption: 'Scope will be interpreted conservatively.',
-            });
-        }
-        // 5. Dependencies
-        if (!objectiveLower.includes('depend') && !objectiveLower.includes('prerequisite') &&
-            !objectiveLower.includes('require') && !objectiveLower.includes('after')) {
-            constraints.push({
-                id: 'missing-dependency',
-                category: 'dependency',
-                description: 'No dependencies or prerequisites mentioned.',
-                impact: 'Unknown blockers may delay or prevent completion.',
-                severity: 'low',
-                clarification_prompt: 'Are there any dependencies or prerequisites for this objective?',
-                default_assumption: 'No external dependencies assumed.',
-            });
-        }
-        // 6. Technical constraints
-        const technicalKeywords = ['api', 'database', 'system', 'application', 'service', 'platform'];
-        const hasTechnicalContext = technicalKeywords.some(kw => objectiveLower.includes(kw));
-        if (hasTechnicalContext && !objectiveLower.includes('technology') &&
-            !objectiveLower.includes('stack') && !objectiveLower.includes('language') &&
-            !knownConstraints.some(c => c.toLowerCase().includes('tech'))) {
-            constraints.push({
-                id: 'missing-technical',
-                category: 'technical',
-                description: 'Technical objective without specified technology constraints.',
-                impact: 'Technology choices may conflict with existing systems or preferences.',
-                severity: 'medium',
-                clarification_prompt: 'Are there any technology preferences or constraints (languages, frameworks, platforms)?',
-                default_assumption: 'Appropriate technologies will be selected based on requirements.',
-            });
-        }
-        // 7. Performance constraints
-        if (hasTechnicalContext && !objectiveLower.includes('performance') &&
-            !objectiveLower.includes('latency') && !objectiveLower.includes('throughput') &&
-            !objectiveLower.includes('scale')) {
-            constraints.push({
-                id: 'missing-performance',
-                category: 'performance',
-                description: 'No performance requirements specified.',
-                impact: 'Cannot optimize or test for specific performance targets.',
-                severity: 'low',
-                clarification_prompt: 'Are there any performance requirements (response time, throughput, scale)?',
-                default_assumption: 'Standard performance levels will be targeted.',
-            });
-        }
-        // 8. Compliance constraints
-        const complianceKeywords = ['user', 'data', 'personal', 'customer', 'financial', 'health'];
-        const mayNeedCompliance = complianceKeywords.some(kw => objectiveLower.includes(kw));
-        if (mayNeedCompliance && !objectiveLower.includes('compliance') &&
-            !objectiveLower.includes('regulation') && !objectiveLower.includes('gdpr') &&
-            !objectiveLower.includes('hipaa')) {
-            constraints.push({
-                id: 'missing-compliance',
-                category: 'compliance',
-                description: 'Potential compliance requirements not addressed.',
-                impact: 'May face legal or regulatory issues if compliance requirements exist.',
-                severity: 'high',
-                clarification_prompt: 'Are there any compliance or regulatory requirements (GDPR, HIPAA, SOC2, etc.)?',
-                default_assumption: 'Standard data protection practices will be followed.',
-            });
-        }
-        return constraints;
-    }
-    /**
-     * Normalize goals from the objective
-     */
-    normalizeGoals(objective) {
-        const goals = [];
-        // Split objective into potential goal statements
-        const statements = this.splitIntoStatements(objective);
-        for (let i = 0; i < statements.length; i++) {
-            const statement = statements[i].trim();
-            if (statement.length < 5)
-                continue;
-            const analysis = this.analyzeStatement(statement);
-            if (analysis.action) {
-                goals.push({
-                    goal_id: `goal-${i + 1}`,
-                    statement: this.normalizeStatement(statement),
-                    type: this.classifyGoalType(statement, analysis),
-                    action: analysis.action,
-                    subject: analysis.subject || 'system',
-                    object: analysis.object,
-                    qualifiers: analysis.qualifiers,
-                    confidence: analysis.confidence,
-                    source_text: statement,
-                });
-            }
-        }
-        return goals;
-    }
-    /**
-     * Split objective into individual statements
-     */
-    splitIntoStatements(objective) {
-        // Split by common delimiters
-        return objective
-            .split(/[.;]\s*/)
-            .flatMap(s => s.split(/\s*(?:and|,)\s+(?=[A-Z])/))
-            .filter(s => s.length > 0);
-    }
-    /**
-     * Analyze a statement to extract components
-     */
-    analyzeStatement(statement) {
-        const words = statement.toLowerCase().split(/\s+/);
-        // Action verbs to look for
-        const actionVerbs = [
-            'create', 'build', 'develop', 'implement', 'design', 'deploy',
-            'update', 'modify', 'change', 'improve', 'enhance', 'optimize',
-            'remove', 'delete', 'deprecate', 'migrate', 'refactor',
-            'integrate', 'connect', 'link', 'sync',
-            'test', 'validate', 'verify', 'check', 'audit',
-            'document', 'describe', 'explain', 'define',
-            'configure', 'setup', 'initialize', 'enable', 'disable',
-            'monitor', 'track', 'log', 'measure', 'analyze',
-        ];
-        let action = null;
-        let actionIndex = -1;
-        for (let i = 0; i < words.length; i++) {
-            if (actionVerbs.includes(words[i])) {
-                action = words[i];
-                actionIndex = i;
-                break;
-            }
-        }
-        if (!action) {
-            // Try to find verb-like words at start
-            if (words.length > 0 && words[0].endsWith('e')) {
-                action = words[0];
-                actionIndex = 0;
-            }
-        }
-        // Extract subject (usually before action or after "for")
-        let subject = null;
-        const forIndex = words.indexOf('for');
-        if (forIndex !== -1 && forIndex < words.length - 1) {
-            subject = words.slice(forIndex + 1, Math.min(forIndex + 4, words.length)).join(' ');
-        }
-        else if (actionIndex > 0) {
-            subject = words.slice(0, actionIndex).join(' ');
-        }
-        // Extract object (usually after action)
-        let object = null;
-        if (actionIndex !== -1 && actionIndex < words.length - 1) {
-            const afterAction = words.slice(actionIndex + 1);
-            const stopWords = ['for', 'to', 'with', 'using', 'by', 'that', 'which'];
-            const stopIndex = afterAction.findIndex(w => stopWords.includes(w));
-            if (stopIndex !== -1) {
-                object = afterAction.slice(0, stopIndex).join(' ');
-            }
-            else {
-                object = afterAction.slice(0, 4).join(' ');
-            }
-        }
-        // Extract qualifiers
-        const qualifiers = [];
-        const qualifierPatterns = [
-            /\bwith\s+(.+?)(?:\s+and|\s+for|$)/i,
-            /\busing\s+(.+?)(?:\s+and|\s+for|$)/i,
-            /\bthat\s+(.+?)(?:\s+and|\s+for|$)/i,
-        ];
-        for (const pattern of qualifierPatterns) {
-            const match = statement.match(pattern);
-            if (match) {
-                qualifiers.push(match[1].trim());
-            }
-        }
-        // Calculate confidence
-        let confidence = 0.5;
-        if (action)
-            confidence += 0.2;
-        if (subject || object)
-            confidence += 0.15;
-        if (qualifiers.length > 0)
-            confidence += 0.1;
-        confidence = Math.min(1.0, confidence);
-        return { action, subject, object, qualifiers, confidence };
-    }
-    /**
-     * Classify goal type
-     */
-    classifyGoalType(statement, analysis) {
-        const lower = statement.toLowerCase();
-        // Non-functional indicators
-        const nfIndicators = [
-            'performance', 'scalab', 'secur', 'reliab', 'availab', 'maintain',
-            'usab', 'access', 'portab', 'fast', 'quick', 'efficient',
-        ];
-        if (nfIndicators.some(ind => lower.includes(ind))) {
-            return 'non_functional';
-        }
-        // Constraint indicators
-        const constraintIndicators = ['must', 'shall', 'require', 'limit', 'restrict', 'only', 'cannot', 'never'];
-        if (constraintIndicators.some(ind => lower.includes(ind))) {
-            return 'constraint';
-        }
-        // Assumption indicators
-        const assumptionIndicators = ['assume', 'expect', 'given', 'provided that', 'if '];
-        if (assumptionIndicators.some(ind => lower.includes(ind))) {
-            return 'assumption';
-        }
-        // Default to functional
-        return 'functional';
-    }
-    /**
-     * Normalize a statement to standard form
-     */
-    normalizeStatement(statement) {
-        return statement
-            .trim()
-            .replace(/\s+/g, ' ')
-            .replace(/^(the|a|an)\s+/i, '')
-            .replace(/[.;,]$/, '');
-    }
-    /**
-     * Determine the overall status
-     */
-    determineStatus(ambiguities, missingConstraints, normalizedGoals, objective) {
-        // Check for insufficient input
-        if (objective.split(/\s+/).length < 3) {
-            return 'insufficient';
-        }
-        // Check if too complex (needs decomposition)
-        if (normalizedGoals.length > 7 || objective.length > 2000) {
-            return 'requires_decomposition';
-        }
-        // Check for critical issues
-        const hasCriticalAmbiguity = ambiguities.some(a => a.severity === 'critical');
-        const hasCriticalConstraint = missingConstraints.some(c => c.severity === 'critical');
-        const hasHighSeverityIssues = ambiguities.filter(a => a.severity === 'high').length > 2 ||
-            missingConstraints.filter(c => c.severity === 'high').length > 2;
-        if (hasCriticalAmbiguity || hasCriticalConstraint || hasHighSeverityIssues) {
-            return 'needs_clarification';
-        }
-        // Check for moderate issues
-        const totalIssues = ambiguities.length + missingConstraints.length;
-        if (totalIssues > 5) {
-            return 'needs_clarification';
-        }
-        // Seems clear
-        return 'clear';
-    }
-    /**
-     * Generate clarified objective
-     */
-    generateClarifiedObjective(originalObjective, ambiguities, missingConstraints, normalizedGoals, autoResolveLowSeverity) {
-        const assumptions = [];
-        const unresolved = [];
-        // Process ambiguities
-        for (const ambiguity of ambiguities) {
-            if (autoResolveLowSeverity && ambiguity.severity === 'low') {
-                // Auto-resolve with highest likelihood interpretation
-                const bestInterpretation = ambiguity.interpretations.reduce((a, b) => a.likelihood > b.likelihood ? a : b);
-                assumptions.push(`Assumed "${ambiguity.source_text}" means: ${bestInterpretation.interpretation}`);
-            }
-            else if (ambiguity.severity === 'high' || ambiguity.severity === 'critical') {
-                unresolved.push(`Ambiguous: ${ambiguity.description}`);
-            }
-        }
-        // Process missing constraints
-        for (const constraint of missingConstraints) {
-            if (constraint.default_assumption) {
-                assumptions.push(constraint.default_assumption);
-            }
-            if (constraint.severity === 'high' || constraint.severity === 'critical') {
-                unresolved.push(`Missing: ${constraint.description}`);
-            }
-        }
-        // Build clarified statement from normalized goals
-        let statement = originalObjective;
-        if (normalizedGoals.length > 0 && normalizedGoals.length <= 5) {
-            const goalStatements = normalizedGoals.map(g => g.statement);
-            statement = goalStatements.join('; ');
-        }
-        // Calculate confidence
-        let confidence = 1.0;
-        confidence -= ambiguities.filter(a => a.severity === 'critical').length * 0.2;
-        confidence -= ambiguities.filter(a => a.severity === 'high').length * 0.1;
-        confidence -= missingConstraints.filter(c => c.severity === 'critical').length * 0.15;
-        confidence -= missingConstraints.filter(c => c.severity === 'high').length * 0.08;
-        confidence = Math.max(0.1, confidence);
-        return {
-            statement,
-            assumptions,
-            unresolved,
-            confidence,
-        };
-    }
-    /**
-     * Generate prioritized clarification questions
-     */
-    generateClarificationQuestions(ambiguities, missingConstraints, maxQuestions) {
-        const questions = [];
-        // Add questions from ambiguities
-        for (const ambiguity of ambiguities) {
-            questions.push({
-                question: ambiguity.clarification_prompt,
-                priority: ambiguity.severity,
-                related_ambiguity_id: ambiguity.id,
-            });
-        }
-        // Add questions from missing constraints
-        for (const constraint of missingConstraints) {
-            questions.push({
-                question: constraint.clarification_prompt,
-                priority: constraint.severity,
-                related_constraint_id: constraint.id,
-            });
-        }
-        // Sort by priority and limit
-        const priorityOrder = { critical: 0, high: 1, medium: 2, low: 3 };
-        return questions
-            .sort((a, b) => priorityOrder[a.priority] - priorityOrder[b.priority])
-            .slice(0, maxQuestions);
-    }
-    /**
-     * Compute analysis metrics
-     */
-    computeAnalysisMetrics(objective, ambiguities, missingConstraints, normalizedGoals) {
-        const wordCount = objective.split(/\s+/).length;
-        // Clarity score (inverse of ambiguity severity)
-        let clarityScore = 1.0;
-        clarityScore -= ambiguities.filter(a => a.severity === 'critical').length * 0.25;
-        clarityScore -= ambiguities.filter(a => a.severity === 'high').length * 0.15;
-        clarityScore -= ambiguities.filter(a => a.severity === 'medium').length * 0.08;
-        clarityScore -= ambiguities.filter(a => a.severity === 'low').length * 0.03;
-        clarityScore = Math.max(0, clarityScore);
-        // Completeness score (inverse of missing constraints severity)
-        let completenessScore = 1.0;
-        completenessScore -= missingConstraints.filter(c => c.severity === 'critical').length * 0.2;
-        completenessScore -= missingConstraints.filter(c => c.severity === 'high').length * 0.12;
-        completenessScore -= missingConstraints.filter(c => c.severity === 'medium').length * 0.06;
-        completenessScore -= missingConstraints.filter(c => c.severity === 'low').length * 0.02;
-        completenessScore = Math.max(0, completenessScore);
-        // Complexity assessment
-        let complexity;
-        if (normalizedGoals.length <= 2 && wordCount < 50) {
-            complexity = 'simple';
-        }
-        else if (normalizedGoals.length <= 4 && wordCount < 150) {
-            complexity = 'moderate';
-        }
-        else if (normalizedGoals.length <= 7 && wordCount < 500) {
-            complexity = 'complex';
-        }
-        else {
-            complexity = 'very_complex';
-        }
-        return {
-            total_ambiguities: ambiguities.length,
-            total_missing_constraints: missingConstraints.length,
-            total_goals: normalizedGoals.length,
-            clarity_score: clarityScore,
-            completeness_score: completenessScore,
-            word_count: wordCount,
-            complexity,
-        };
-    }
-    /**
-     * Find context around a word in the objective
-     */
-    findContextForWord(objective, word) {
-        const regex = new RegExp(`(?:\\S+\\s+){0,3}\\b${word}\\b(?:\\s+\\S+){0,3}`, 'i');
-        const match = objective.match(regex);
-        return match ? match[0] : word;
-    }
-    /**
-     * Calculate overall confidence
-     */
-    calculateConfidence(output) {
-        let confidence = 0.6; // Base confidence
-        // Boost for clear status
-        if (output.status === 'clear') {
-            confidence += 0.2;
-        }
-        // Boost for normalized goals extracted
-        if (output.normalized_goals.length > 0 && output.normalized_goals.length <= 5) {
-            confidence += 0.1;
-        }
-        // Reduce for many ambiguities
-        if (output.ambiguities.length > 5) {
-            confidence -= 0.15;
-        }
-        // Reduce for critical issues
-        if (output.ambiguities.some(a => a.severity === 'critical')) {
-            confidence -= 0.1;
-        }
-        // Adjust based on clarity score
-        confidence = confidence * 0.7 + output.analysis.clarity_score * 0.3;
-        return Math.min(1.0, Math.max(0.0, confidence));
-    }
-    /**
-     * Get constraints applied during clarification
-     */
-    getAppliedConstraints(input) {
-        const constraints = [
-            'read_only_analysis',
-            'no_plan_generation',
-            'no_solution_definition',
-            'no_logic_execution',
-            'deterministic_output',
-            'semantic_normalization',
-            'intent_clarification',
-        ];
-        if (input.context?.known_constraints) {
-            constraints.push(...input.context.known_constraints.map(c => `user_constraint:${c}`));
-        }
-        if (input.config?.min_severity) {
-            constraints.push(`min_severity:${input.config.min_severity}`);
-        }
-        if (input.config?.auto_resolve_low_severity) {
-            constraints.push('auto_resolve_low_severity');
-        }
-        return constraints;
-    }
-    /**
-     * Classify error for proper error code
-     */
-    classifyError(error) {
-        if (error instanceof Error) {
-            if (error.name === 'ZodError') {
-                return contracts_1.AgentErrorCodes.VALIDATION_FAILED;
-            }
-            if (error.message.includes('persistence') || error.message.includes('ruvector')) {
-                return contracts_1.AgentErrorCodes.PERSISTENCE_ERROR;
-            }
-        }
-        return contracts_1.AgentErrorCodes.PROCESSING_ERROR;
-    }
-}
-exports.ObjectiveClarifierAgent = ObjectiveClarifierAgent;
-//# sourceMappingURL=objective-clarifier-agent.js.map