dino-spec 17.4.3 → 17.6.0

package/dist/core/spec-analyzer/ambiguity-detector.js

@@ -0,0 +1,250 @@
+/**
+ * Ambiguity Detector - v17.5.0
+ *
+ * Enhanced ambiguity detection for spec analysis.
+ * Detects vague terms, missing specifics, and incomplete requirement markers.
+ *
+ * Features:
+ * - Pattern-based ambiguity detection
+ * - 0-25 scale ambiguity scoring
+ * - Automatic clarification question generation
+ * - Integration with confidence gate
+ *
+ * @module ambiguity-detector
+ */
+import { calculateConfidencePenalty, generateClarificationQuestions, getBlockingQuestions, hasBlockingQuestions, } from './clarification-generator.js';
+import { ALL_PATTERNS, calculateTotalWeight, findPatternMatches, groupMatchesByCategory, } from './patterns.js';
+const DEFAULT_OPTIONS = {
+    maxScore: 25,
+    incompleteMarkerMultiplier: 1.5,
+    missingSpecificMultiplier: 1.2,
+    minMatchesForAnalysis: 1,
+};
+// =============================================================================
+// Main Detection Function
+// =============================================================================
+/**
+ * Analyze text for ambiguity
+ *
+ * @param text - Text to analyze (prompt or requirement)
+ * @param options - Detection options
+ * @returns Ambiguity analysis result
+ */
+export function detectAmbiguity(text, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    // Find all pattern matches
+    const matches = findPatternMatches(text);
+    // Group matches by category
+    const grouped = groupMatchesByCategory(matches);
+    // Calculate category scores with multipliers
+    const vagueTermScore = calculateCategoryScore(grouped.vague_term);
+    const missingSpecificScore = calculateCategoryScore(grouped.missing_specific) * opts.missingSpecificMultiplier;
+    const incompleteMarkerScore = calculateCategoryScore(grouped.incomplete_marker) * opts.incompleteMarkerMultiplier;
+    const vagueVerbScore = calculateCategoryScore(grouped.vague_verb);
+    // Calculate total raw score
+    const rawScore = vagueTermScore + missingSpecificScore + incompleteMarkerScore + vagueVerbScore;
+    // Normalize to 0-25 scale
+    const score = Math.min(opts.maxScore, Math.round(rawScore));
+    // Generate clarification questions
+    const clarification = generateClarificationQuestions(matches);
+    // Calculate confidence penalty
+    const confidencePenalty = calculateConfidencePenalty(clarification);
+    // Check for blocking issues
+    const hasBlockingIssues = hasBlockingQuestions(clarification);
+    // Generate summary
+    const summary = generateSummary(score, matches, grouped, hasBlockingIssues);
+    return {
+        score,
+        matches,
+        clarification,
+        breakdown: {
+            vagueTerms: grouped.vague_term.length,
+            missingSpecifics: grouped.missing_specific.length,
+            incompleteMarkers: grouped.incomplete_marker.length,
+            vagueVerbs: grouped.vague_verb.length,
+        },
+        confidencePenalty,
+        hasBlockingIssues,
+        summary,
+    };
+}
+/**
+ * Calculate score for a category of matches
+ */
+function calculateCategoryScore(matches) {
+    return calculateTotalWeight(matches);
+}
+/**
+ * Generate summary text
+ */
+function generateSummary(score, matches, grouped, hasBlockingIssues) {
+    if (matches.length === 0) {
+        return 'No ambiguity detected. Requirements appear clear.';
+    }
+    const parts = [];
+    // Score level
+    if (score >= 20) {
+        parts.push('High ambiguity detected');
+    }
+    else if (score >= 10) {
+        parts.push('Moderate ambiguity detected');
+    }
+    else {
+        parts.push('Low ambiguity detected');
+    }
+    // Blocking status
+    if (hasBlockingIssues) {
+        parts.push('with blocking issues that must be resolved');
+    }
+    // Category breakdown
+    const categories = [];
+    if (grouped.incomplete_marker.length > 0) {
+        categories.push(`${grouped.incomplete_marker.length} incomplete marker(s)`);
+    }
+    if (grouped.missing_specific.length > 0) {
+        categories.push(`${grouped.missing_specific.length} missing specific(s)`);
+    }
+    if (grouped.vague_verb.length > 0) {
+        categories.push(`${grouped.vague_verb.length} vague verb(s)`);
+    }
+    if (grouped.vague_term.length > 0) {
+        categories.push(`${grouped.vague_term.length} vague term(s)`);
+    }
+    if (categories.length > 0) {
+        parts.push(`Found: ${categories.join(', ')}`);
+    }
+    return `${parts.join('. ')}.`;
+}
+// =============================================================================
+// Convenience Functions
+// =============================================================================
+/**
+ * Quick check if text has significant ambiguity
+ *
+ * @param text - Text to check
+ * @param threshold - Score threshold (default: 10)
+ * @returns True if ambiguity score exceeds threshold
+ */
+export function hasSignificantAmbiguity(text, threshold = 10) {
+    const analysis = detectAmbiguity(text);
+    return analysis.score >= threshold;
+}
+/**
+ * Get only blocking clarification questions
+ *
+ * @param text - Text to analyze
+ * @returns Array of blocking questions
+ */
+export function getBlockingClarifications(text) {
+    const analysis = detectAmbiguity(text);
+    return getBlockingQuestions(analysis.clarification);
+}
+/**
+ * Calculate ambiguity-adjusted confidence
+ *
+ * @param baseConfidence - Base confidence score (0-100)
+ * @param text - Text to analyze for ambiguity
+ * @returns Adjusted confidence score
+ */
+export function calculateAdjustedConfidence(baseConfidence, text) {
+    const analysis = detectAmbiguity(text);
+    return Math.max(0, baseConfidence - analysis.confidencePenalty);
+}
+// =============================================================================
+// Formatting Functions
+// =============================================================================
+/**
+ * Format ambiguity analysis as markdown
+ */
+export function formatAmbiguityMarkdown(analysis) {
+    const lines = ['## Ambiguity Analysis', ''];
+    // Score meter
+    const level = analysis.score >= 20 ? 'High' : analysis.score >= 10 ? 'Moderate' : 'Low';
+    const indicator = analysis.score >= 20 ? '🔴' : analysis.score >= 10 ? '🟡' : '🟢';
+    lines.push(`**Score:** ${analysis.score}/25 ${indicator} ${level}`);
+    lines.push(`**Confidence Penalty:** -${analysis.confidencePenalty}%`);
+    if (analysis.hasBlockingIssues) {
+        lines.push('**Status:** ⛔ Has blocking issues');
+    }
+    lines.push('');
+    // Breakdown
+    lines.push('### Breakdown');
+    lines.push(`| Category | Count |`);
+    lines.push(`|----------|-------|`);
+    lines.push(`| Incomplete Markers | ${analysis.breakdown.incompleteMarkers} |`);
+    lines.push(`| Missing Specifics | ${analysis.breakdown.missingSpecifics} |`);
+    lines.push(`| Vague Verbs | ${analysis.breakdown.vagueVerbs} |`);
+    lines.push(`| Vague Terms | ${analysis.breakdown.vagueTerms} |`);
+    lines.push('');
+    // Matches
+    if (analysis.matches.length > 0) {
+        lines.push('### Detected Issues');
+        for (const match of analysis.matches.slice(0, 10)) {
+            lines.push(`- **"${match.matched}"** (${match.pattern.category})`);
+            lines.push(`  - ${match.pattern.description}`);
+            lines.push(`  - Context: *${match.context}*`);
+        }
+        if (analysis.matches.length > 10) {
+            lines.push(`- *...and ${analysis.matches.length - 10} more*`);
+        }
+        lines.push('');
+    }
+    // Summary
+    lines.push(`### Summary`);
+    lines.push(analysis.summary);
+    return lines.join('\n');
+}
+/**
+ * Format ambiguity analysis as JSON
+ */
+export function formatAmbiguityJSON(analysis) {
+    return JSON.stringify({
+        score: analysis.score,
+        maxScore: 25,
+        level: analysis.score >= 20 ? 'high' : analysis.score >= 10 ? 'moderate' : 'low',
+        confidencePenalty: analysis.confidencePenalty,
+        hasBlockingIssues: analysis.hasBlockingIssues,
+        breakdown: analysis.breakdown,
+        matchCount: analysis.matches.length,
+        matches: analysis.matches.slice(0, 20).map((m) => ({
+            matched: m.matched,
+            category: m.pattern.category,
+            weight: m.pattern.weight,
+            context: m.context,
+        })),
+        clarification: {
+            questionCount: analysis.clarification.questions.length,
+            blocking: analysis.clarification.summary.blocking,
+            important: analysis.clarification.summary.important,
+            niceToKnow: analysis.clarification.summary.niceToKnow,
+            totalConfidenceImpact: analysis.clarification.totalConfidenceImpact,
+        },
+        summary: analysis.summary,
+    }, null, 2);
+}
+// =============================================================================
+// Pattern Information Exports
+// =============================================================================
+/**
+ * Get all available pattern categories
+ */
+export function getPatternCategories() {
+    return ['vague_term', 'missing_specific', 'incomplete_marker', 'vague_verb'];
+}
+/**
+ * Get pattern count by category
+ */
+export function getPatternCounts() {
+    const counts = {};
+    for (const pattern of ALL_PATTERNS) {
+        counts[pattern.category] = (counts[pattern.category] || 0) + 1;
+    }
+    return counts;
+}
+/**
+ * Get total pattern count
+ */
+export function getTotalPatternCount() {
+    return ALL_PATTERNS.length;
+}
+//# sourceMappingURL=ambiguity-detector.js.map

package/dist/core/spec-analyzer/ambiguity-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambiguity-detector.js","sourceRoot":"","sources":["../../../src/core/spec-analyzer/ambiguity-detector.ts"],"names":[],"mappings":"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"}

package/dist/core/spec-analyzer/clarification-generator.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Clarification Generator - v17.5.0
+ *
+ * Generates targeted clarification questions based on ambiguity signals.
+ * Integrates with the ambiguity detector and confidence gate.
+ *
+ * Features:
+ * - Automatic question generation from pattern matches
+ * - Priority levels: blocking, important, nice-to-know
+ * - Deduplication and grouping
+ * - Integration with confidence scoring
+ *
+ * @module clarification-generator
+ */
+import type { AmbiguityPattern, PatternMatch } from './patterns.js';
+import type { QuestionPriority, TriggerSignal } from './question-types.js';
+export interface ClarificationQuestion {
+    /** Unique question ID */
+    id: string;
+    /** The question text */
+    question: string;
+    /** Priority level */
+    priority: QuestionPriority;
+    /** Category of ambiguity this addresses */
+    category: AmbiguityPattern['category'];
+    /** Trigger signal for integration with existing question system */
+    triggerSignal: TriggerSignal;
+    /** The matched text that triggered this question */
+    matchedText: string;
+    /** Context around the match */
+    context: string;
+    /** Pattern that generated this question */
+    patternId: string;
+    /** Impact on confidence if resolved (percentage points) */
+    confidenceImpact: number;
+}
+export interface ClarificationResult {
+    /** Generated questions sorted by priority */
+    questions: ClarificationQuestion[];
+    /** Total confidence impact if all questions resolved */
+    totalConfidenceImpact: number;
+    /** Summary by priority */
+    summary: {
+        blocking: number;
+        important: number;
+        niceToKnow: number;
+    };
+    /** Summary by category */
+    byCategory: Record<AmbiguityPattern['category'], number>;
+}
+/**
+ * Generate clarification questions from pattern matches
+ */
+export declare function generateClarificationQuestions(matches: PatternMatch[]): ClarificationResult;
+/**
+ * Format clarification questions as markdown
+ */
+export declare function formatClarificationMarkdown(result: ClarificationResult): string;
+/**
+ * Format clarification questions as JSON
+ */
+export declare function formatClarificationJSON(result: ClarificationResult): string;
+/**
+ * Get blocking questions only
+ */
+export declare function getBlockingQuestions(result: ClarificationResult): ClarificationQuestion[];
+/**
+ * Check if there are any blocking questions
+ */
+export declare function hasBlockingQuestions(result: ClarificationResult): boolean;
+/**
+ * Calculate confidence penalty from ambiguity
+ * Used to integrate with confidence gate
+ */
+export declare function calculateConfidencePenalty(result: ClarificationResult): number;
+//# sourceMappingURL=clarification-generator.d.ts.map

package/dist/core/spec-analyzer/clarification-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarification-generator.d.ts","sourceRoot":"","sources":["../../../src/core/spec-analyzer/clarification-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAM1E,MAAM,WAAW,qBAAqB;IACpC,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,qBAAqB;IACrB,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,2CAA2C;IAC3C,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAA;IACtC,mEAAmE;IACnE,aAAa,EAAE,aAAa,CAAA;IAC5B,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAA;IACnB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,SAAS,EAAE,qBAAqB,EAAE,CAAA;IAClC,wDAAwD;IACxD,qBAAqB,EAAE,MAAM,CAAA;IAC7B,0BAA0B;IAC1B,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;QACjB,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAA;CACzD;AAyGD;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,mBAAmB,CAiC3F;AAwCD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAiD/E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAkB3E;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,qBAAqB,EAAE,CAEzF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAEzE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAO9E"}

package/dist/core/spec-analyzer/clarification-generator.js

@@ -0,0 +1,257 @@
+/**
+ * Clarification Generator - v17.5.0
+ *
+ * Generates targeted clarification questions based on ambiguity signals.
+ * Integrates with the ambiguity detector and confidence gate.
+ *
+ * Features:
+ * - Automatic question generation from pattern matches
+ * - Priority levels: blocking, important, nice-to-know
+ * - Deduplication and grouping
+ * - Integration with confidence scoring
+ *
+ * @module clarification-generator
+ */
+import { groupMatchesByCategory } from './patterns.js';
+// =============================================================================
+// Priority Mapping
+// =============================================================================
+/**
+ * Map pattern categories and weights to question priority
+ */
+function determinePriority(pattern) {
+    // High weight patterns are blocking
+    if (pattern.weight >= 4) {
+        return 'blocking';
+    }
+    // Incomplete markers are always at least important
+    if (pattern.category === 'incomplete_marker') {
+        return pattern.weight >= 3 ? 'blocking' : 'important';
+    }
+    // Missing specifics that affect outcomes are blocking
+    if (pattern.category === 'missing_specific' && pattern.weight >= 3) {
+        return 'blocking';
+    }
+    // Medium weight is important
+    if (pattern.weight >= 2) {
+        return 'important';
+    }
+    // Low weight is nice-to-know
+    return 'nice-to-know';
+}
+/**
+ * Map pattern category to trigger signal
+ */
+function categoryToTriggerSignal(category) {
+    switch (category) {
+        case 'vague_term':
+            return 'vague_verb';
+        case 'missing_specific':
+            return 'missing_target';
+        case 'incomplete_marker':
+            return 'unclear_success';
+        case 'vague_verb':
+            return 'vague_verb';
+        default:
+            return 'unclear_success';
+    }
+}
+/**
+ * Calculate confidence impact based on pattern weight and priority
+ */
+function calculateConfidenceImpact(pattern, priority) {
+    const baseImpact = pattern.weight * 2;
+    // Priority multiplier
+    switch (priority) {
+        case 'blocking':
+            return Math.min(15, baseImpact * 1.5);
+        case 'important':
+            return Math.min(10, baseImpact * 1.0);
+        case 'nice-to-know':
+            return Math.min(5, baseImpact * 0.5);
+    }
+}
+// =============================================================================
+// Question Generation
+// =============================================================================
+/**
+ * Generate a clarification question from a pattern match
+ */
+function generateQuestion(match, index) {
+    const priority = determinePriority(match.pattern);
+    const confidenceImpact = calculateConfidenceImpact(match.pattern, priority);
+    // Create contextual question
+    let question = match.pattern.clarificationPrompt;
+    // Enhance question with specific match context
+    if (match.matched && match.matched.length > 0) {
+        const matchedLower = match.matched.toLowerCase();
+        // Add specific reference if it makes sense
+        if (!question.toLowerCase().includes(matchedLower)) {
+            question = `Regarding "${match.matched}": ${question}`;
+        }
+    }
+    return {
+        id: `cq-${match.pattern.id}-${index}`,
+        question,
+        priority,
+        category: match.pattern.category,
+        triggerSignal: categoryToTriggerSignal(match.pattern.category),
+        matchedText: match.matched,
+        context: match.context,
+        patternId: match.pattern.id,
+        confidenceImpact,
+    };
+}
+/**
+ * Generate clarification questions from pattern matches
+ */
+export function generateClarificationQuestions(matches) {
+    // Generate questions from matches
+    const questions = matches.map((match, index) => generateQuestion(match, index));
+    // Deduplicate questions with same pattern ID (keep highest impact)
+    const deduped = deduplicateQuestions(questions);
+    // Sort by priority (blocking first, then important, then nice-to-know)
+    const sorted = sortByPriority(deduped);
+    // Calculate totals
+    const totalConfidenceImpact = sorted.reduce((sum, q) => sum + q.confidenceImpact, 0);
+    const summary = {
+        blocking: sorted.filter((q) => q.priority === 'blocking').length,
+        important: sorted.filter((q) => q.priority === 'important').length,
+        niceToKnow: sorted.filter((q) => q.priority === 'nice-to-know').length,
+    };
+    const grouped = groupMatchesByCategory(matches);
+    const byCategory = {
+        vague_term: grouped.vague_term.length,
+        missing_specific: grouped.missing_specific.length,
+        incomplete_marker: grouped.incomplete_marker.length,
+        vague_verb: grouped.vague_verb.length,
+    };
+    return {
+        questions: sorted,
+        totalConfidenceImpact,
+        summary,
+        byCategory,
+    };
+}
+/**
+ * Deduplicate questions with same pattern ID
+ */
+function deduplicateQuestions(questions) {
+    const byPatternId = new Map();
+    for (const question of questions) {
+        const existing = byPatternId.get(question.patternId);
+        if (!existing || question.confidenceImpact > existing.confidenceImpact) {
+            byPatternId.set(question.patternId, question);
+        }
+    }
+    return Array.from(byPatternId.values());
+}
+/**
+ * Sort questions by priority
+ */
+function sortByPriority(questions) {
+    const priorityOrder = {
+        blocking: 0,
+        important: 1,
+        'nice-to-know': 2,
+    };
+    return [...questions].sort((a, b) => {
+        const priorityDiff = priorityOrder[a.priority] - priorityOrder[b.priority];
+        if (priorityDiff !== 0)
+            return priorityDiff;
+        // Within same priority, sort by confidence impact (higher first)
+        return b.confidenceImpact - a.confidenceImpact;
+    });
+}
+// =============================================================================
+// Formatting Functions
+// =============================================================================
+/**
+ * Format clarification questions as markdown
+ */
+export function formatClarificationMarkdown(result) {
+    const lines = ['## Clarification Questions', ''];
+    if (result.questions.length === 0) {
+        lines.push('No clarification questions - requirements appear clear.');
+        return lines.join('\n');
+    }
+    // Stats
+    lines.push(`**Total:** ${result.questions.length} questions | **Potential Confidence Gain:** +${result.totalConfidenceImpact}%`);
+    lines.push('');
+    // Group by priority
+    const blocking = result.questions.filter((q) => q.priority === 'blocking');
+    const important = result.questions.filter((q) => q.priority === 'important');
+    const niceToKnow = result.questions.filter((q) => q.priority === 'nice-to-know');
+    if (blocking.length > 0) {
+        lines.push('### Blocking (must answer)');
+        for (const q of blocking) {
+            lines.push(`- **${q.question}**`);
+            lines.push(`  - *Matched:* "${q.matchedText}"`);
+            lines.push(`  - *Impact:* +${q.confidenceImpact}% confidence`);
+        }
+        lines.push('');
+    }
+    if (important.length > 0) {
+        lines.push('### Important (should answer)');
+        for (const q of important) {
+            lines.push(`- **${q.question}**`);
+            lines.push(`  - *Matched:* "${q.matchedText}"`);
+            lines.push(`  - *Impact:* +${q.confidenceImpact}% confidence`);
+        }
+        lines.push('');
+    }
+    if (niceToKnow.length > 0) {
+        lines.push('### Nice-to-Know (optional)');
+        for (const q of niceToKnow) {
+            lines.push(`- ${q.question}`);
+            lines.push(`  - *Matched:* "${q.matchedText}"`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Format clarification questions as JSON
+ */
+export function formatClarificationJSON(result) {
+    return JSON.stringify({
+        questions: result.questions.map((q) => ({
+            id: q.id,
+            question: q.question,
+            priority: q.priority,
+            category: q.category,
+            matchedText: q.matchedText,
+            confidenceImpact: q.confidenceImpact,
+        })),
+        totalConfidenceImpact: result.totalConfidenceImpact,
+        summary: result.summary,
+        byCategory: result.byCategory,
+    }, null, 2);
+}
+// =============================================================================
+// Integration Helpers
+// =============================================================================
+/**
+ * Get blocking questions only
+ */
+export function getBlockingQuestions(result) {
+    return result.questions.filter((q) => q.priority === 'blocking');
+}
+/**
+ * Check if there are any blocking questions
+ */
+export function hasBlockingQuestions(result) {
+    return result.summary.blocking > 0;
+}
+/**
+ * Calculate confidence penalty from ambiguity
+ * Used to integrate with confidence gate
+ */
+export function calculateConfidencePenalty(result) {
+    // Blocking questions have higher penalty
+    const blockingPenalty = result.summary.blocking * 10;
+    const importantPenalty = result.summary.important * 5;
+    const niceToKnowPenalty = result.summary.niceToKnow * 2;
+    return Math.min(50, blockingPenalty + importantPenalty + niceToKnowPenalty);
+}
+//# sourceMappingURL=clarification-generator.js.map

package/dist/core/spec-analyzer/clarification-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarification-generator.js","sourceRoot":"","sources":["../../../src/core/spec-analyzer/clarification-generator.ts"],"names":[],"mappings":"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"}

package/dist/core/spec-analyzer/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Spec Analyzer - v11.0.0
+ * Spec Analyzer - v17.5.0
  *
  * Analyzes prompts for complexity, ambiguity, and requirements clarity.
  * Used by /dino.spec skill and dino_spec_analyze MCP tool.
@@ -17,7 +17,16 @@
  * Includes Ralph Loop eligibility (v11.0.0):
  * - Detects tasks qualifying for iterative fresh-context loop
  * - 90% confidence gate for Ralph-eligible tasks
+ *
+ * Enhanced ambiguity detection (v17.5.0):
+ * - Pattern-based vague term detection
+ * - Missing specifics detection
+ * - Incomplete requirement markers
+ * - Automatic clarification question generation
  */
+export { type AmbiguityAnalysis, type AmbiguityDetectorOptions, calculateAdjustedConfidence, detectAmbiguity, formatAmbiguityJSON, formatAmbiguityMarkdown, getBlockingClarifications, getPatternCategories, getPatternCounts, getTotalPatternCount, hasSignificantAmbiguity, } from './ambiguity-detector.js';
+export { type ClarificationQuestion, type ClarificationResult, calculateConfidencePenalty, formatClarificationJSON, formatClarificationMarkdown, generateClarificationQuestions, getBlockingQuestions, hasBlockingQuestions, } from './clarification-generator.js';
+export { ALL_PATTERNS, type AmbiguityPattern, calculateTotalWeight, findPatternMatches, getPatternsByCategory, groupMatchesByCategory, INCOMPLETE_MARKER_PATTERNS, MISSING_SPECIFIC_PATTERNS, type PatternMatch, VAGUE_TERM_PATTERNS, VAGUE_VERB_PATTERNS, } from './patterns.js';
 export { createMinimalContext, enhanceContextForQuery, gatherCodebaseContext, hasContext, } from './question-context.js';
 export { formatQuestionsJSON, formatQuestionsMarkdown, generateQuestions, } from './question-generator.js';
 export type { CodebaseContext, GeneratedQuestion, QuestionGenerationResult, QuestionPriority, QuestionType, TriggerSignal, } from './question-types.js';
@@ -87,10 +96,21 @@ export interface RalphEligibility {
  * to ensure thorough understanding before large-scale implementation.
  */
 export declare function isRalphEligible(analysis: SpecAnalysis): RalphEligibility;
+/**
+ * Options for prompt analysis
+ * v17.6.0: Added session context support
+ */
+export interface AnalyzePromptOptions {
+    /** Focus area from session.md (e.g., "src/core/ralph/") */
+    focusArea?: string;
+    /** Current phase from session.md (e.g., "implementation") */
+    phase?: string;
+}
 /**
  * Analyze a prompt for complexity and ambiguity
+ * v17.6.0: Enhanced with optional session context for better analysis
  */
-export declare function analyzePrompt(prompt: string): SpecAnalysis;
+export declare function analyzePrompt(prompt: string, options?: AnalyzePromptOptions): SpecAnalysis;
 /**
  * Format analysis as markdown
  */