dino-spec 13.6.1 → 14.1.0

package/dist/core/agents/ambiguity-resolver.js

@@ -0,0 +1,327 @@
+/**
+ * Ambiguity Resolver - v14.1.0
+ *
+ * Auto-triggers research subagent when ambiguity score exceeds threshold.
+ * Research findings are cached and injected into context before planning.
+ *
+ * @see .claude/rules/dino/confidence-handling.md
+ */
+import { analyzePrompt } from '../spec-analyzer/index.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const DEFAULT_CONFIG = {
+    threshold: 40,
+    maxResearchTokens: 5000,
+    cacheDirectory: '.dino/research/',
+    enableWebSearch: true,
+    enableCodebaseSearch: true,
+};
+const AMBIGUITY_THRESHOLD = Number(process.env.DINO_AMBIGUITY_THRESHOLD) || 40;
+// =============================================================================
+// Core Functions
+// =============================================================================
+/**
+ * Check if a prompt needs research based on ambiguity score
+ */
+export function needsResearch(prompt, config = DEFAULT_CONFIG) {
+    const analysis = analyzePrompt(prompt);
+    return analysis.ambiguityScore > (config.threshold || AMBIGUITY_THRESHOLD);
+}
+/**
+ * Analyze ambiguity and determine if research is needed
+ */
+export function analyzeAmbiguity(prompt, config = DEFAULT_CONFIG) {
+    const analysis = analyzePrompt(prompt);
+    const signals = {
+        vagueVerbs: analysis.signals.vagueVerbs,
+        missingTarget: analysis.signals.missingTarget,
+        unclearSuccess: analysis.signals.unclearSuccess,
+        securityRelated: analysis.signals.securityRelated,
+        dataRelated: analysis.signals.dataRelated,
+    };
+    return {
+        needsResearch: analysis.ambiguityScore > (config.threshold || AMBIGUITY_THRESHOLD),
+        score: analysis.ambiguityScore,
+        signals,
+    };
+}
+/**
+ * Resolve ambiguity by triggering research if needed
+ *
+ * This is the main entry point for ambiguity resolution.
+ * Returns enhanced context with research findings if research was needed.
+ */
+export async function resolveAmbiguity(prompt, config = DEFAULT_CONFIG) {
+    const analysis = analyzePrompt(prompt);
+    const { ambiguityScore, signals } = analysis;
+    // Determine if research is needed
+    const threshold = config.threshold || AMBIGUITY_THRESHOLD;
+    if (ambiguityScore <= threshold) {
+        return {
+            needsResearch: false,
+            ambiguityScore,
+            analysis,
+            action: 'proceed',
+        };
+    }
+    // Build research parameters
+    const researchParams = {
+        prompt,
+        ambiguityScore,
+        signals: {
+            vagueVerbs: signals.vagueVerbs,
+            missingTarget: signals.missingTarget,
+            unclearSuccess: signals.unclearSuccess,
+            securityRelated: signals.securityRelated,
+            dataRelated: signals.dataRelated,
+        },
+        maxTokens: config.maxResearchTokens,
+    };
+    // Execute research
+    const research = await executeResearch(researchParams, config);
+    // Determine action based on research results
+    const action = research.confidence >= 0.8 ? 'proceed' : 'clarify';
+    // Build enhanced context from findings
+    const context = buildEnhancedContext(research.findings);
+    return {
+        needsResearch: true,
+        ambiguityScore,
+        analysis,
+        research,
+        action,
+        context,
+    };
+}
+/**
+ * Execute research by spawning research subagent
+ *
+ * This function builds the research prompt and spawns a subagent.
+ * In practice, this returns spawn parameters for the Task tool.
+ */
+export async function executeResearch(params, config = DEFAULT_CONFIG) {
+    const cacheKey = generateCacheKey(params.prompt);
+    const startTime = Date.now();
+    // Build research prompt
+    const researchPrompt = buildResearchPrompt(params, config);
+    // This would spawn the subagent via Task tool
+    // For now, return stub that will be filled by actual subagent execution
+    const findings = await gatherFindings(params, config);
+    // Calculate confidence based on findings
+    const confidence = calculateResearchConfidence(findings);
+    return {
+        confidence,
+        findings,
+        cacheKey,
+        timestamp: new Date(),
+        tokensUsed: estimateTokens(researchPrompt),
+    };
+}
+/**
+ * Build research prompt for subagent
+ */
+export function buildResearchPrompt(params, config = DEFAULT_CONFIG) {
+    const sections = [];
+    sections.push('# Research Task');
+    sections.push('');
+    sections.push('## Objective');
+    sections.push(`Gather context and resolve ambiguities for: "${params.prompt}"`);
+    sections.push('');
+    // Ambiguity signals to address
+    sections.push('## Ambiguities to Resolve');
+    sections.push(`Ambiguity Score: ${params.ambiguityScore}/25`);
+    sections.push('');
+    if (params.signals.vagueVerbs.length > 0) {
+        sections.push(`### Vague Verbs: ${params.signals.vagueVerbs.join(', ')}`);
+        sections.push('- Find examples of similar work in codebase');
+        sections.push('- Identify specific patterns to follow');
+        sections.push('');
+    }
+    if (params.signals.missingTarget) {
+        sections.push('### Missing Target');
+        sections.push('- Identify which files/components are affected');
+        sections.push('- Find related code locations');
+        sections.push('');
+    }
+    if (params.signals.unclearSuccess) {
+        sections.push('### Unclear Success Criteria');
+        sections.push('- Find existing test patterns');
+        sections.push('- Identify acceptance criteria from similar features');
+        sections.push('');
+    }
+    if (params.signals.securityRelated) {
+        sections.push('### Security Concerns');
+        sections.push('- Find existing security patterns');
+        sections.push('- Review authentication/authorization approaches');
+        sections.push('');
+    }
+    if (params.signals.dataRelated) {
+        sections.push('### Data Handling');
+        sections.push('- Find existing data patterns');
+        sections.push('- Review migration/backup approaches');
+        sections.push('');
+    }
+    // Research instructions
+    sections.push('## Research Instructions');
+    sections.push('');
+    if (config.enableCodebaseSearch) {
+        sections.push('### Codebase Search');
+        sections.push('1. Use Grep to find relevant patterns');
+        sections.push('2. Use Glob to find related files');
+        sections.push('3. Read key files to understand patterns');
+        sections.push('');
+    }
+    if (config.enableWebSearch) {
+        sections.push('### External Research');
+        sections.push('1. Use WebSearch for best practices');
+        sections.push('2. Use WebFetch for documentation');
+        sections.push('');
+    }
+    sections.push('## Output Format');
+    sections.push('Return findings in JSON format:');
+    sections.push('```json');
+    sections.push('{');
+    sections.push('  "findings": [');
+    sections.push('    {');
+    sections.push('      "type": "pattern|file|documentation|external|decision",');
+    sections.push('      "source": "path or URL",');
+    sections.push('      "summary": "brief description",');
+    sections.push('      "relevance": 0.0-1.0,');
+    sections.push('      "content": "optional detailed content"');
+    sections.push('    }');
+    sections.push('  ],');
+    sections.push('  "confidence": 0.0-1.0,');
+    sections.push('  "recommendations": ["list of suggestions"]');
+    sections.push('}');
+    sections.push('```');
+    return sections.join('\n');
+}
+/**
+ * Build Task tool spawn parameters for research subagent
+ */
+export function buildTaskSpawnParams(params, config = DEFAULT_CONFIG) {
+    return {
+        description: 'Research: resolve ambiguity',
+        prompt: buildResearchPrompt(params, config),
+        subagent_type: 'Explore',
+        model: 'sonnet',
+    };
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Generate cache key from prompt
+ */
+function generateCacheKey(prompt) {
+    // Simple hash for cache key
+    const slug = prompt
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .slice(0, 50);
+    const timestamp = Date.now();
+    return `research-${slug}-${timestamp}`;
+}
+/**
+ * Gather findings from codebase and external sources
+ * This is a stub - actual implementation uses Task tool subagent
+ */
+async function gatherFindings(params, _config) {
+    // This would be populated by actual subagent execution
+    // Return empty array - subagent will fill this
+    return [];
+}
+/**
+ * Calculate confidence from research findings
+ */
+function calculateResearchConfidence(findings) {
+    if (findings.length === 0)
+        return 0;
+    // Weight by relevance
+    const totalRelevance = findings.reduce((sum, f) => sum + f.relevance, 0);
+    const avgRelevance = totalRelevance / findings.length;
+    // Bonus for having multiple types of findings
+    const types = new Set(findings.map((f) => f.type));
+    const typeBonus = Math.min(0.2, types.size * 0.05);
+    return Math.min(1, avgRelevance + typeBonus);
+}
+/**
+ * Build enhanced context from research findings
+ */
+function buildEnhancedContext(findings) {
+    if (findings.length === 0)
+        return '';
+    const sections = [];
+    sections.push('## Research Findings');
+    sections.push('');
+    // Group by type
+    const byType = new Map();
+    for (const finding of findings) {
+        const existing = byType.get(finding.type) || [];
+        existing.push(finding);
+        byType.set(finding.type, existing);
+    }
+    // Format each type
+    for (const [type, typeFindings] of byType) {
+        sections.push(`### ${capitalizeFirst(type)} Findings`);
+        for (const finding of typeFindings) {
+            sections.push(`- **${finding.source}**: ${finding.summary}`);
+            if (finding.content) {
+                sections.push(`  ${finding.content.slice(0, 200)}...`);
+            }
+        }
+        sections.push('');
+    }
+    return sections.join('\n');
+}
+/**
+ * Estimate tokens from text
+ */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Capitalize first letter
+ */
+function capitalizeFirst(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+// =============================================================================
+// Cache Functions
+// =============================================================================
+/**
+ * Format for caching to .dino/research/
+ */
+export function formatResearchForCache(result) {
+    const lines = [];
+    lines.push(`# Research: ${result.cacheKey}`);
+    lines.push('');
+    lines.push(`**Date:** ${result.timestamp.toISOString()}`);
+    lines.push(`**Confidence:** ${Math.round(result.confidence * 100)}%`);
+    lines.push(`**Tokens Used:** ${result.tokensUsed}`);
+    lines.push('');
+    lines.push('## Findings');
+    lines.push('');
+    for (const finding of result.findings) {
+        lines.push(`### ${capitalizeFirst(finding.type)}: ${finding.source}`);
+        lines.push(`**Relevance:** ${Math.round(finding.relevance * 100)}%`);
+        lines.push('');
+        lines.push(finding.summary);
+        if (finding.content) {
+            lines.push('');
+            lines.push('```');
+            lines.push(finding.content);
+            lines.push('```');
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Get cache path for research result
+ */
+export function getResearchCachePath(cacheKey, cacheDirectory = '.dino/research/') {
+    const safeName = cacheKey.replace(/[^a-z0-9-]/g, '-');
+    return `${cacheDirectory}${safeName}.md`;
+}
+//# sourceMappingURL=ambiguity-resolver.js.map

package/dist/core/agents/ambiguity-resolver.js.map

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

package/dist/core/agents/confidence-gate.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Confidence Gate - v14.1.0
+ *
+ * Gates tasks based on confidence level, requiring research or clarification
+ * before allowing implementation to proceed.
+ *
+ * @see .claude/rules/dino/confidence-handling.md
+ */
+import { type SpecAnalysis } from '../spec-analyzer/index.js';
+import { type ResearchResult } from './ambiguity-resolver.js';
+/**
+ * Gate decision result
+ */
+export interface GateResult {
+    proceed: boolean;
+    confidence: number;
+    requiredConfidence: number;
+    action: 'proceed' | 'research' | 'clarify';
+    reason: string;
+    analysis?: SpecAnalysis;
+    research?: ResearchResult;
+    questions?: ClarificationQuestion[];
+}
+/**
+ * Clarification question for user
+ */
+export interface ClarificationQuestion {
+    id: string;
+    question: string;
+    priority: 'blocking' | 'important' | 'nice-to-know';
+    type: 'scope' | 'success' | 'pattern' | 'risk';
+    options?: string[];
+}
+/**
+ * Confidence gate configuration
+ */
+export interface ConfidenceGateConfig {
+    threshold: number;
+    ralphThreshold: number;
+    maxResearchRounds: number;
+    maxClarificationRounds: number;
+    enableAutoResearch: boolean;
+}
+/**
+ * Session confidence tracking
+ */
+export interface ConfidenceTracking {
+    currentConfidence: number;
+    targetConfidence: number;
+    rounds: ConfidenceRound[];
+    status: 'pending' | 'researching' | 'clarifying' | 'ready' | 'blocked';
+}
+/**
+ * A round of confidence improvement
+ */
+export interface ConfidenceRound {
+    roundNumber: number;
+    action: 'research' | 'clarification' | 'user-input';
+    confidenceBefore: number;
+    confidenceAfter: number;
+    details: string;
+    timestamp: Date;
+}
+/**
+ * Check if task can proceed based on confidence level
+ *
+ * This is the main entry point for confidence gating.
+ * Returns decision on whether to proceed, research, or clarify.
+ */
+export declare function checkConfidence(prompt: string, config?: ConfidenceGateConfig): Promise<GateResult>;
+/**
+ * Generate clarification questions based on analysis signals
+ */
+export declare function generateClarificationQuestions(analysis: SpecAnalysis): ClarificationQuestion[];
+/**
+ * Update confidence based on user answers
+ */
+export declare function updateConfidenceFromAnswers(currentConfidence: number, questions: ClarificationQuestion[], answeredCount: number): number;
+/**
+ * Create new confidence tracking for a session
+ */
+export declare function createConfidenceTracking(prompt: string, config?: ConfidenceGateConfig): ConfidenceTracking;
+/**
+ * Record a confidence improvement round
+ */
+export declare function recordConfidenceRound(tracking: ConfidenceTracking, action: 'research' | 'clarification' | 'user-input', confidenceAfter: number, details: string): ConfidenceTracking;
+/**
+ * Check if tracking has exceeded max rounds
+ */
+export declare function hasExceededMaxRounds(tracking: ConfidenceTracking, config?: ConfidenceGateConfig): boolean;
+/**
+ * Format confidence tracking for session.md
+ */
+export declare function formatConfidenceForSession(tracking: ConfidenceTracking): string;
+/**
+ * Format gate result for display
+ */
+export declare function formatGateResult(result: GateResult): string;
+//# sourceMappingURL=confidence-gate.d.ts.map

package/dist/core/agents/confidence-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence-gate.d.ts","sourceRoot":"","sources":["../../../src/core/agents/confidence-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9F,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAMhF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,SAAS,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC;IACpD,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,CAAC;CACxE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,GAAG,eAAe,GAAG,YAAY,CAAC;IACpD,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAkBD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,uBAAiB,GACtB,OAAO,CAAC,UAAU,CAAC,CAgFrB;AA6BD;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,YAAY,GACrB,qBAAqB,EAAE,CAgEzB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,qBAAqB,EAAE,EAClC,aAAa,EAAE,MAAM,GACpB,MAAM,CAeR;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,MAAM,uBAAiB,GACtB,kBAAkB,CAYpB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,UAAU,GAAG,eAAe,GAAG,YAAY,EACnD,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,GACd,kBAAkB,CAuBpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,uBAAiB,GACtB,OAAO,CAUT;AAMD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAwB/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CA4B3D"}