dino-spec 17.4.3 → 17.6.0

package/dist/core/agents/research-phase.js

@@ -0,0 +1,355 @@
+/**
+ * Research Phase - v17.5.0
+ *
+ * Handles the research phase of the progressive confidence gate.
+ * Triggers codebase and web search to gather context and improve confidence.
+ *
+ * Features:
+ * - Codebase search (Grep, Glob, Read)
+ * - Web search for external documentation
+ * - Confidence improvement calculation (10-30%)
+ * - Research result caching
+ * - Integration with ambiguity detector
+ *
+ * @module research-phase
+ */
+import { detectAmbiguity } from '../spec-analyzer/ambiguity-detector.js';
+// =============================================================================
+// Constants
+// =============================================================================
+export const DEFAULT_RESEARCH_CONFIG = {
+    enableCodebaseSearch: true,
+    enableWebSearch: true,
+    maxResearchTokens: 5000,
+    cacheDirectory: '.dino/research/',
+    minConfidenceImprovement: 0.1, // 10%
+    maxConfidenceImprovement: 0.3, // 30%
+};
+// Confidence improvement factors
+const IMPROVEMENT_FACTORS = {
+    patternFound: 0.08, // Found relevant pattern
+    fileIdentified: 0.05, // Identified target file
+    documentationFound: 0.06, // Found relevant docs
+    exampleFound: 0.07, // Found working example
+    decisionFound: 0.04, // Found past decision
+    multipleFindings: 0.02, // Bonus per additional finding (up to 5)
+};
+// =============================================================================
+// Main Functions
+// =============================================================================
+/**
+ * Identify what research is needed based on analysis
+ */
+export function identifyResearchTargets(analysis, ambiguity) {
+    const targets = [];
+    // Missing target - need to find files/components
+    if (analysis.signals.missingTarget) {
+        targets.push({
+            type: 'codebase',
+            priority: 10,
+            areas: [
+                {
+                    query: 'find target files or components',
+                    reason: 'No specific target mentioned in requirement',
+                    expectedType: 'file',
+                    globPatterns: ['src/**/*.ts', 'src/**/*.tsx'],
+                },
+            ],
+        });
+    }
+    // Vague verbs - need to find patterns/examples
+    if (analysis.signals.vagueVerbs.length > 0) {
+        for (const verb of analysis.signals.vagueVerbs.slice(0, 2)) {
+            targets.push({
+                type: 'both',
+                priority: 8,
+                areas: [
+                    {
+                        query: `find examples of "${verb}" in codebase`,
+                        reason: `Vague verb "${verb}" needs concrete examples`,
+                        expectedType: 'example',
+                        globPatterns: ['src/**/*.ts'],
+                    },
+                    {
+                        query: `best practices for "${verb}"`,
+                        reason: `Need guidance for "${verb}" operation`,
+                        expectedType: 'documentation',
+                        webKeywords: [verb, 'best practices', 'typescript'],
+                    },
+                ],
+            });
+        }
+    }
+    // Unclear success - need test patterns
+    if (analysis.signals.unclearSuccess) {
+        targets.push({
+            type: 'codebase',
+            priority: 7,
+            areas: [
+                {
+                    query: 'find test patterns for similar features',
+                    reason: 'Success criteria not defined',
+                    expectedType: 'pattern',
+                    globPatterns: ['test/**/*.test.ts', 'src/**/*.test.ts'],
+                },
+            ],
+        });
+    }
+    // Security related - need security patterns
+    if (analysis.signals.securityRelated) {
+        targets.push({
+            type: 'both',
+            priority: 9,
+            areas: [
+                {
+                    query: 'find existing security patterns',
+                    reason: 'Security-related requirement needs patterns',
+                    expectedType: 'pattern',
+                    globPatterns: ['src/**/auth*.ts', 'src/**/security*.ts'],
+                },
+                {
+                    query: 'security best practices',
+                    reason: 'Need security guidance',
+                    expectedType: 'documentation',
+                    webKeywords: ['security', 'authentication', 'authorization', 'best practices'],
+                },
+            ],
+        });
+    }
+    // Data related - need data patterns
+    if (analysis.signals.dataRelated) {
+        targets.push({
+            type: 'codebase',
+            priority: 8,
+            areas: [
+                {
+                    query: 'find data handling patterns',
+                    reason: 'Data-related requirement needs patterns',
+                    expectedType: 'pattern',
+                    globPatterns: ['src/**/db*.ts', 'src/**/storage*.ts', 'src/**/migration*.ts'],
+                },
+            ],
+        });
+    }
+    // Breaking change - need affected consumers
+    if (analysis.signals.breakingChange) {
+        targets.push({
+            type: 'codebase',
+            priority: 9,
+            areas: [
+                {
+                    query: 'find consumers of affected code',
+                    reason: 'Breaking change needs impact analysis',
+                    expectedType: 'file',
+                    globPatterns: ['src/**/*.ts'],
+                },
+            ],
+        });
+    }
+    // Add research for incomplete markers from MAC-4 ambiguity analysis
+    if (ambiguity.breakdown.incompleteMarkers > 0) {
+        targets.push({
+            type: 'codebase',
+            priority: 6,
+            areas: [
+                {
+                    query: 'find related documentation or decisions',
+                    reason: 'Incomplete markers (TBD/TODO) need resolution',
+                    expectedType: 'decision',
+                    globPatterns: ['.dino/**/*.md', 'docs/**/*.md'],
+                },
+            ],
+        });
+    }
+    // Sort by priority
+    return targets.sort((a, b) => b.priority - a.priority);
+}
+/**
+ * Build research prompt for subagent
+ */
+export function buildResearchPrompt(prompt, targets, config = DEFAULT_RESEARCH_CONFIG) {
+    const sections = [];
+    sections.push('# Research Phase');
+    sections.push('');
+    sections.push('## Objective');
+    sections.push(`Gather context to improve confidence for: "${prompt}"`);
+    sections.push('');
+    sections.push('## Research Targets');
+    sections.push('');
+    for (const target of targets) {
+        sections.push(`### Priority ${target.priority} (${target.type})`);
+        for (const area of target.areas) {
+            sections.push(`- **${area.query}**`);
+            sections.push(`  - Reason: ${area.reason}`);
+            sections.push(`  - Expected: ${area.expectedType}`);
+            if (area.globPatterns && config.enableCodebaseSearch) {
+                sections.push(`  - Search: ${area.globPatterns.join(', ')}`);
+            }
+            if (area.webKeywords && config.enableWebSearch) {
+                sections.push(`  - Keywords: ${area.webKeywords.join(', ')}`);
+            }
+        }
+        sections.push('');
+    }
+    sections.push('## Instructions');
+    sections.push('');
+    if (config.enableCodebaseSearch) {
+        sections.push('### Codebase Search');
+        sections.push('1. Use Glob to find relevant files');
+        sections.push('2. Use Grep to search for patterns');
+        sections.push('3. Read key files to understand context');
+        sections.push('');
+    }
+    if (config.enableWebSearch) {
+        sections.push('### Web Research');
+        sections.push('1. Use WebSearch for best practices');
+        sections.push('2. Use WebFetch for documentation');
+        sections.push('');
+    }
+    sections.push('## Output');
+    sections.push('Return findings as structured list with:');
+    sections.push('- type: pattern|file|documentation|example|decision');
+    sections.push('- source: file path or URL');
+    sections.push('- summary: what was found');
+    sections.push('- relevance: 0-1 how relevant');
+    return sections.join('\n');
+}
+/**
+ * Calculate confidence improvement from findings
+ */
+export function calculateConfidenceImprovement(findings, config = DEFAULT_RESEARCH_CONFIG) {
+    if (findings.length === 0)
+        return 0;
+    let improvement = 0;
+    // Count findings by type
+    const byType = new Map();
+    for (const finding of findings) {
+        const count = byType.get(finding.type) || 0;
+        byType.set(finding.type, count + 1);
+    }
+    // Add improvement for each type found
+    if (byType.has('pattern')) {
+        improvement += IMPROVEMENT_FACTORS.patternFound;
+    }
+    if (byType.has('file')) {
+        improvement += IMPROVEMENT_FACTORS.fileIdentified;
+    }
+    if (byType.has('documentation')) {
+        improvement += IMPROVEMENT_FACTORS.documentationFound;
+    }
+    if (byType.has('example')) {
+        improvement += IMPROVEMENT_FACTORS.exampleFound;
+    }
+    if (byType.has('decision')) {
+        improvement += IMPROVEMENT_FACTORS.decisionFound;
+    }
+    // Bonus for multiple findings (up to 5)
+    const extraFindings = Math.min(5, findings.length - 1);
+    improvement += extraFindings * IMPROVEMENT_FACTORS.multipleFindings;
+    // Weight by average relevance
+    const avgRelevance = findings.reduce((sum, f) => sum + f.relevance, 0) / findings.length;
+    improvement *= avgRelevance;
+    // Clamp to configured range
+    return Math.max(config.minConfidenceImprovement, Math.min(config.maxConfidenceImprovement, improvement));
+}
+/**
+ * Execute research phase
+ */
+export async function executeResearchPhase(prompt, currentConfidence, analysis, config = DEFAULT_RESEARCH_CONFIG) {
+    // Get ambiguity analysis from MAC-4
+    const ambiguity = detectAmbiguity(prompt);
+    // Identify research targets
+    const targets = identifyResearchTargets(analysis, ambiguity);
+    if (targets.length === 0) {
+        return {
+            executed: false,
+            targets: [],
+            findings: [],
+            confidenceImprovement: 0,
+            newConfidence: currentConfidence,
+            summary: 'No research targets identified',
+            tokensUsed: 0,
+            canImproveMore: false,
+        };
+    }
+    // Build research prompt (to be executed by subagent)
+    const researchPrompt = buildResearchPrompt(prompt, targets, config);
+    // This would be populated by actual subagent execution
+    // For now, return structure for subagent to fill
+    const findings = [];
+    const confidenceImprovement = calculateConfidenceImprovement(findings, config);
+    const newConfidence = Math.min(1, currentConfidence + confidenceImprovement);
+    return {
+        executed: true,
+        targets,
+        findings,
+        confidenceImprovement,
+        newConfidence,
+        summary: generateResearchSummary(targets, findings),
+        tokensUsed: estimateTokens(researchPrompt),
+        canImproveMore: targets.length > findings.length,
+    };
+}
+/**
+ * Generate summary of research
+ */
+function generateResearchSummary(targets, findings) {
+    if (findings.length === 0) {
+        return `Research identified ${targets.length} target(s) to investigate. Awaiting subagent execution.`;
+    }
+    const parts = [];
+    parts.push(`Found ${findings.length} relevant finding(s)`);
+    const types = new Set(findings.map((f) => f.type));
+    parts.push(`across ${types.size} categor${types.size === 1 ? 'y' : 'ies'}`);
+    const avgRelevance = findings.reduce((sum, f) => sum + f.relevance, 0) / findings.length;
+    parts.push(`with ${Math.round(avgRelevance * 100)}% average relevance`);
+    return `${parts.join(' ')}.`;
+}
+/**
+ * Estimate tokens from text
+ */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+// =============================================================================
+// Task Tool Integration
+// =============================================================================
+/**
+ * Build Task tool parameters for research subagent
+ */
+export function buildResearchTaskParams(prompt, targets, config = DEFAULT_RESEARCH_CONFIG) {
+    return {
+        description: 'Research: gather context',
+        prompt: buildResearchPrompt(prompt, targets, config),
+        subagent_type: 'Explore',
+        model: 'sonnet',
+    };
+}
+// =============================================================================
+// Formatting
+// =============================================================================
+/**
+ * Format research result for session.md
+ */
+export function formatResearchForSession(result) {
+    const lines = [];
+    lines.push('### Research Phase');
+    lines.push('');
+    lines.push(`**Targets:** ${result.targets.length}`);
+    lines.push(`**Findings:** ${result.findings.length}`);
+    lines.push(`**Confidence Improvement:** +${Math.round(result.confidenceImprovement * 100)}%`);
+    lines.push('');
+    if (result.findings.length > 0) {
+        lines.push('**Key Findings:**');
+        for (const finding of result.findings.slice(0, 5)) {
+            lines.push(`- [${finding.type}] ${finding.summary} (${Math.round(finding.relevance * 100)}%)`);
+        }
+        if (result.findings.length > 5) {
+            lines.push(`- ... and ${result.findings.length - 5} more`);
+        }
+    }
+    lines.push('');
+    lines.push(`**Summary:** ${result.summary}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=research-phase.js.map

package/dist/core/agents/research-phase.js.map

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

package/dist/core/agents/research-validator.d.ts

@@ -1,5 +1,5 @@
 /**
- * Research Validator Agent
+ * Research Validator Agent - v17.5.0
  *
  * Orchestrates package validation by integrating registry-client and security-scanner.
  * Provides comprehensive package analysis including metadata, size, and security.
@@ -8,6 +8,9 @@
  * - Single package validation
  * - Batch validation for multiple packages
  * - Caching of validation results (1-hour TTL)
+ * - Rate limiting per API source
+ * - Version comparison (latest vs requested)
+ * - Deprecation detection with alternatives
  * - Structured validation results
  *
  * @module research-validator
@@ -24,6 +27,11 @@ export interface PackageValidation {
     isValid: boolean;
     warnings: string[];
     errors: string[];
+    latestVersion: string | null;
+    isLatest: boolean;
+    isDeprecated: boolean;
+    deprecationMessage: string | null;
+    alternatives: string[];
 }
 export interface ValidationOptions {
     severityThreshold?: VulnerabilitySeverity;
@@ -55,6 +63,9 @@ export declare function clearValidationCache(): void;
  */
 export declare function getValidationCacheStats(): {
     size: number;
-    entries: string[];
+    maxSize: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
 };
 //# sourceMappingURL=research-validator.d.ts.map

package/dist/core/agents/research-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"research-validator.d.ts","sourceRoot":"","sources":["../../../src/core/agents/research-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,KAAK,kBAAkB,EAEvB,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAA;AAE9B,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,eAAe,CAAA;IACzB,IAAI,EAAE,WAAW,CAAA;IACjB,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,CAAC,EAAE,qBAAqB,CAAA;IACzC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAsBD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,iBAAiB,CAAC,CAoE5B;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAc9B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,uBAAuB;;;EAKtC"}
+{"version":3,"file":"research-validator.d.ts","sourceRoot":"","sources":["../../../src/core/agents/research-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,KAAK,kBAAkB,EAEvB,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAA;AAG9B,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,eAAe,CAAA;IACzB,IAAI,EAAE,WAAW,CAAA;IACjB,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,EAAE,MAAM,EAAE,CAAA;IAEhB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,EAAE,OAAO,CAAA;IACrB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,CAAC,EAAE,qBAAqB,CAAA;IACzC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAQD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,iBAAiB,CAAC,CAsH5B;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAc9B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,uBAAuB;;;;;;EAEtC"}

package/dist/core/agents/research-validator.js

@@ -1,5 +1,5 @@
 /**
- * Research Validator Agent
+ * Research Validator Agent - v17.5.0
  *
  * Orchestrates package validation by integrating registry-client and security-scanner.
  * Provides comprehensive package analysis including metadata, size, and security.
@@ -8,25 +8,20 @@
  * - Single package validation
  * - Batch validation for multiple packages
  * - Caching of validation results (1-hour TTL)
+ * - Rate limiting per API source
+ * - Version comparison (latest vs requested)
+ * - Deprecation detection with alternatives
  * - Structured validation results
  *
  * @module research-validator
  */
 import { fetchPackageMetadata, getPackageSize, } from './registry-client.js';
 import { scanPackage, } from './security-scanner.js';
-// Cache with 1-hour TTL
-const CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
-const validationCache = new Map();
+import { ValidationCache, withRateLimit } from './validation-cache.js';
+// Cache with 1-hour TTL using ValidationCache
+const validationCache = new ValidationCache();
 // Default size threshold: 100KB gzipped
 const DEFAULT_MAX_SIZE_KB = 100;
-/**
- * Check if cache entry is still valid
- */
-function isCacheValid(entry) {
-    if (!entry)
-        return false;
-    return Date.now() - entry.timestamp < CACHE_TTL_MS;
-}
 /**
  * Validate a single package
  *
@@ -41,18 +36,44 @@ export async function validatePackage(packageName, version, options = {}) {
     // Check cache first
     const cacheKey = version ? `${packageName}@${version}` : packageName;
     const cached = validationCache.get(cacheKey);
-    if (cached && isCacheValid(cached)) {
-        return cached.data;
+    if (cached) {
+        return cached;
     }
-    // Fetch metadata (includes version resolution)
-    const metadata = await fetchPackageMetadata(packageName, version);
+    // Fetch metadata with rate limiting (includes version resolution)
+    const metadata = await withRateLimit('npm', () => fetchPackageMetadata(packageName, version));
     const resolvedVersion = metadata.version;
-    // Fetch size info
-    const sizeInfo = await getPackageSize(packageName, resolvedVersion);
-    // Scan for security vulnerabilities
-    const securityResult = await scanPackage(packageName, resolvedVersion, {
-        severityThreshold,
-    });
+    // Fetch latest version for comparison
+    let latestVersion = null;
+    let isLatest = true;
+    if (version) {
+        try {
+            const latestMetadata = await withRateLimit('npm', () => fetchPackageMetadata(packageName));
+            latestVersion = latestMetadata.version;
+            isLatest = resolvedVersion === latestVersion;
+            if (!isLatest) {
+                // Version comparison will be added to warnings
+            }
+        }
+        catch {
+            // Could not fetch latest version
+        }
+    }
+    // Check for deprecation
+    const isDeprecated = metadata.deprecated !== undefined && metadata.deprecated !== null;
+    const deprecationMessage = metadata.deprecated ?? null;
+    const alternatives = [];
+    // Extract alternatives from deprecation message if present
+    if (isDeprecated && deprecationMessage) {
+        // Common patterns: "use X instead", "replaced by Y", "see Z"
+        const altMatch = deprecationMessage.match(/(?:use|replaced by|see|try|switch to)\s+['"`]?([a-z0-9@/-]+)['"`]?/i);
+        if (altMatch) {
+            alternatives.push(altMatch[1]);
+        }
+    }
+    // Fetch size info with rate limiting
+    const sizeInfo = await withRateLimit('bundlephobia', () => getPackageSize(packageName, resolvedVersion));
+    // Scan for security vulnerabilities with rate limiting
+    const securityResult = await withRateLimit('audit', () => scanPackage(packageName, resolvedVersion, { severityThreshold }));
     // Analyze results
     const warnings = [];
     const errors = [];
@@ -61,6 +82,17 @@ export async function validatePackage(packageName, version, options = {}) {
     if (sizeKB > maxSizeKB) {
         warnings.push(`Package size (${sizeKB.toFixed(2)}KB) exceeds threshold (${maxSizeKB}KB)`);
     }
+    // Check version
+    if (!isLatest && latestVersion) {
+        warnings.push(`Newer version available: ${latestVersion} (requested: ${resolvedVersion})`);
+    }
+    // Check deprecation
+    if (isDeprecated) {
+        warnings.push(`DEPRECATED: ${deprecationMessage ?? 'No reason provided'}`);
+        if (alternatives.length > 0) {
+            warnings.push(`Suggested alternatives: ${alternatives.join(', ')}`);
+        }
+    }
     // Check security
     if (securityResult.hasBlockingIssues) {
         for (const vuln of securityResult.vulnerabilities) {
@@ -82,15 +114,18 @@ export async function validatePackage(packageName, version, options = {}) {
         size: sizeInfo,
         security: securityResult,
         validatedAt: Date.now(),
-        isValid: errors.length === 0,
+        isValid: errors.length === 0 && !isDeprecated,
         warnings,
         errors,
+        // v17.5.0: Enhanced fields
+        latestVersion,
+        isLatest,
+        isDeprecated,
+        deprecationMessage,
+        alternatives,
     };
     // Cache result
-    validationCache.set(cacheKey, {
-        data: validation,
-        timestamp: Date.now(),
-    });
+    validationCache.set(cacheKey, validation);
     return validation;
 }
 /**
@@ -119,9 +154,6 @@ export function clearValidationCache() {
  * Get validation cache statistics (useful for debugging)
  */
 export function getValidationCacheStats() {
-    return {
-        size: validationCache.size,
-        entries: Array.from(validationCache.keys()),
-    };
+    return validationCache.getStats();
 }
 //# sourceMappingURL=research-validator.js.map

package/dist/core/agents/research-validator.js.map

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