@tyroneross/build-loop 0.30.3

package/dist/src/result-aggregator.js

@@ -0,0 +1,315 @@
+"use strict";
+// SPDX-FileCopyrightText: 2025-2026 Tyrone Ross, Jr <46267523+tyroneross@users.noreply.github.com>
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Result Aggregator
+ *
+ * Combines and ranks results from multiple sources:
+ * - Domain assessments from parallel assessors
+ * - Memory retrieval (incidents and patterns)
+ * - Trace correlations
+ *
+ * Uses unified scoring: 0.35*match + 0.25*confidence + 0.15*recency + 0.25*verification
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scoreAssessment = scoreAssessment;
+exports.scoreIncident = scoreIncident;
+exports.scorePattern = scorePattern;
+exports.aggregateResults = aggregateResults;
+exports.formatAggregatedResults = formatAggregatedResults;
+exports.createQuickSummary = createQuickSummary;
+// Scoring weights
+const SCORING_WEIGHTS = {
+    match: 0.35, // Similarity/match score
+    confidence: 0.25, // Assessment confidence
+    recency: 0.15, // How recent the incident/pattern
+    verification: 0.25 // Verification status
+};
+// Verification status scores
+const VERIFICATION_SCORES = {
+    'V': 1.0, // Verified
+    'P': 0.6, // Partial
+    'U': 0.3 // Unverified
+};
+const DEFAULT_CONFIG = {
+    maxResults: 10,
+    minScoreThreshold: 0.3,
+    verificationBoost: 1.2,
+    recencyBoost: 1.1,
+    dedupeThreshold: 0.8
+};
+/**
+ * Calculate recency score (0-1) based on timestamp
+ * Full score for last 24h, decays over 30 days
+ */
+function calculateRecencyScore(timestamp) {
+    const now = Date.now();
+    const ageMs = now - timestamp;
+    const dayMs = 24 * 60 * 60 * 1000;
+    if (ageMs < dayMs) {
+        return 1.0; // Last 24 hours
+    }
+    const ageDays = ageMs / dayMs;
+    if (ageDays > 30) {
+        return 0.1; // Older than 30 days
+    }
+    // Linear decay from 1.0 to 0.1 over 30 days
+    return 1.0 - (ageDays / 30) * 0.9;
+}
+/**
+ * Score a domain assessment
+ */
+function scoreAssessment(assessment, config = {}) {
+    const finalConfig = { ...DEFAULT_CONFIG, ...config };
+    // Assessment-specific scoring
+    // Match score based on probable causes count and specificity
+    const matchScore = Math.min(1, assessment.probable_causes.length * 0.25 +
+        assessment.related_incidents.length * 0.15);
+    // Confidence from assessment
+    const confidenceScore = assessment.confidence;
+    // Recency: assume current (1.0) for live assessments
+    const recencyScore = 1.0;
+    // Verification: based on related incidents
+    let verificationScore = 0.5; // Base score
+    if (assessment.related_incidents.length > 0) {
+        verificationScore = 0.7; // Has evidence
+    }
+    if (assessment.confidence >= 0.8) {
+        verificationScore = 0.9; // High confidence
+    }
+    // Calculate weighted score
+    let score = (SCORING_WEIGHTS.match * matchScore +
+        SCORING_WEIGHTS.confidence * confidenceScore +
+        SCORING_WEIGHTS.recency * recencyScore +
+        SCORING_WEIGHTS.verification * verificationScore);
+    // Apply verification boost if highly confident
+    if (assessment.confidence >= 0.8) {
+        score *= finalConfig.verificationBoost;
+    }
+    return {
+        type: 'assessment',
+        id: `assess_${assessment.domain}_${Date.now()}`,
+        score: Math.min(1, score),
+        domain: assessment.domain,
+        summary: assessment.probable_causes[0] || 'Assessment completed',
+        actions: assessment.recommended_actions,
+        tags: assessment.search_tags,
+        rawData: assessment
+    };
+}
+/**
+ * Score a compact incident from memory
+ */
+function scoreIncident(incident, config = {}) {
+    const finalConfig = { ...DEFAULT_CONFIG, ...config };
+    // Match score from similarity (if available)
+    const matchScore = incident.sim || 0.5;
+    // Confidence from root cause
+    const confidenceScore = incident.rc.conf;
+    // Recency score
+    const recencyScore = calculateRecencyScore(incident.ts);
+    // Verification status
+    const verificationScore = VERIFICATION_SCORES[incident.v] || 0.3;
+    // Calculate weighted score
+    let score = (SCORING_WEIGHTS.match * matchScore +
+        SCORING_WEIGHTS.confidence * confidenceScore +
+        SCORING_WEIGHTS.recency * recencyScore +
+        SCORING_WEIGHTS.verification * verificationScore);
+    // Apply boosts
+    if (incident.v === 'V') {
+        score *= finalConfig.verificationBoost;
+    }
+    const sevenDaysAgo = Date.now() - 7 * 24 * 60 * 60 * 1000;
+    if (incident.ts > sevenDaysAgo) {
+        score *= finalConfig.recencyBoost;
+    }
+    // Quality score bonus
+    score += incident.q * 0.1;
+    return {
+        type: 'incident',
+        id: incident.id,
+        score: Math.min(1, score),
+        domain: incident.rc.cat,
+        summary: incident.sym,
+        actions: [incident.fix.a],
+        tags: incident.t,
+        rawData: incident
+    };
+}
+/**
+ * Score a compact pattern from memory
+ */
+function scorePattern(pattern, matchScore = 0.5, config = {}) {
+    const finalConfig = { ...DEFAULT_CONFIG, ...config };
+    // Confidence from pattern (assume high since it's an extracted pattern)
+    const confidenceScore = 0.8;
+    // Recency from last seen
+    const recencyScore = calculateRecencyScore(pattern.last);
+    // Verification based on occurrence count
+    let verificationScore = 0.5;
+    if (pattern.n >= 3) {
+        verificationScore = 0.8;
+    }
+    else if (pattern.n >= 2) {
+        verificationScore = 0.65;
+    }
+    // Calculate weighted score
+    let score = (SCORING_WEIGHTS.match * matchScore +
+        SCORING_WEIGHTS.confidence * confidenceScore +
+        SCORING_WEIGHTS.recency * recencyScore +
+        SCORING_WEIGHTS.verification * verificationScore);
+    // Frequency boost
+    if (pattern.n >= 3) {
+        score *= 1.15;
+    }
+    const sevenDaysAgo = Date.now() - 7 * 24 * 60 * 60 * 1000;
+    if (pattern.last > sevenDaysAgo) {
+        score *= finalConfig.recencyBoost;
+    }
+    return {
+        type: 'pattern',
+        id: pattern.id,
+        score: Math.min(1, score),
+        domain: pattern.cat,
+        summary: pattern.desc,
+        actions: [pattern.fix],
+        tags: pattern.t,
+        rawData: pattern
+    };
+}
+/**
+ * Calculate similarity between two items for deduplication
+ */
+function calculateSimilarity(item1, item2) {
+    // Quick check: same type and domain?
+    if (item1.type === item2.type && item1.domain === item2.domain) {
+        // Check tag overlap
+        const tags1 = new Set(item1.tags);
+        const tags2 = new Set(item2.tags);
+        const intersection = [...tags1].filter(t => tags2.has(t)).length;
+        const union = new Set([...tags1, ...tags2]).size;
+        const tagSimilarity = union > 0 ? intersection / union : 0;
+        // Check summary similarity (simple word overlap)
+        const words1 = new Set(item1.summary.toLowerCase().split(/\s+/));
+        const words2 = new Set(item2.summary.toLowerCase().split(/\s+/));
+        const wordIntersection = [...words1].filter(w => words2.has(w)).length;
+        const wordUnion = new Set([...words1, ...words2]).size;
+        const wordSimilarity = wordUnion > 0 ? wordIntersection / wordUnion : 0;
+        return (tagSimilarity * 0.4 + wordSimilarity * 0.6);
+    }
+    return 0;
+}
+/**
+ * Deduplicate items by similarity threshold
+ */
+function deduplicateItems(items, threshold) {
+    const result = [];
+    for (const item of items) {
+        const isDuplicate = result.some(existing => calculateSimilarity(existing, item) >= threshold);
+        if (!isDuplicate) {
+            result.push(item);
+        }
+    }
+    return result;
+}
+/**
+ * Aggregate results from multiple sources
+ */
+function aggregateResults(assessments, incidents, patterns, config = {}) {
+    const finalConfig = { ...DEFAULT_CONFIG, ...config };
+    // Score all items
+    const scoredAssessments = assessments.map(a => scoreAssessment(a, config));
+    const scoredIncidents = incidents.map(i => scoreIncident(i, config));
+    const scoredPatterns = patterns.map(p => scorePattern(p, p.sim || 0.5, config));
+    // Combine all scored items
+    let allItems = [
+        ...scoredAssessments,
+        ...scoredIncidents,
+        ...scoredPatterns
+    ];
+    // Filter by minimum score
+    allItems = allItems.filter(item => item.score >= finalConfig.minScoreThreshold);
+    // Sort by score descending
+    allItems.sort((a, b) => b.score - a.score);
+    // Deduplicate
+    allItems = deduplicateItems(allItems, finalConfig.dedupeThreshold);
+    // Limit results
+    const topItems = allItems.slice(0, finalConfig.maxResults);
+    // Build aggregated result
+    const domains = [...new Set(topItems.map(i => i.domain).filter(Boolean))];
+    const allTags = [...new Set(topItems.flatMap(i => i.tags))];
+    // Calculate aggregate confidence
+    const avgConfidence = topItems.length > 0
+        ? topItems.reduce((sum, i) => sum + i.score, 0) / topItems.length
+        : 0;
+    // Compile recommended actions (deduplicated, ordered by source score)
+    const actionSet = new Set();
+    const recommendedActions = [];
+    for (const item of topItems) {
+        for (const action of item.actions) {
+            if (!actionSet.has(action)) {
+                actionSet.add(action);
+                recommendedActions.push(action);
+            }
+        }
+    }
+    return {
+        items: topItems,
+        total_count: allItems.length,
+        domains_involved: domains,
+        aggregate_confidence: avgConfidence,
+        recommended_actions: recommendedActions.slice(0, 5),
+        search_tags: allTags.slice(0, 10)
+    };
+}
+/**
+ * Format aggregated results for display
+ */
+function formatAggregatedResults(result) {
+    const lines = [
+        '## Aggregated Analysis Results',
+        '',
+        `**Domains:** ${result.domains_involved.join(', ') || 'General'}`,
+        `**Confidence:** ${(result.aggregate_confidence * 100).toFixed(0)}%`,
+        `**Total Matches:** ${result.total_count}`,
+        '',
+        '### Top Results',
+        ''
+    ];
+    for (let i = 0; i < result.items.length; i++) {
+        const item = result.items[i];
+        const scoreBar = '█'.repeat(Math.round(item.score * 10)) +
+            '░'.repeat(10 - Math.round(item.score * 10));
+        const typeIcon = item.type === 'assessment' ? '🔍' :
+            item.type === 'incident' ? '📋' : '🔄';
+        lines.push(`${i + 1}. ${typeIcon} **${item.type}** [${scoreBar}] ${(item.score * 100).toFixed(0)}%`);
+        lines.push(`   ${item.summary}`);
+        if (item.domain) {
+            lines.push(`   Domain: ${item.domain}`);
+        }
+        lines.push('');
+    }
+    lines.push('### Recommended Actions');
+    lines.push('');
+    for (let i = 0; i < result.recommended_actions.length; i++) {
+        lines.push(`${i + 1}. ${result.recommended_actions[i]}`);
+    }
+    if (result.search_tags.length > 0) {
+        lines.push('');
+        lines.push(`**Tags:** ${result.search_tags.join(', ')}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Create a quick summary for token-efficient output
+ */
+function createQuickSummary(result) {
+    const topItem = result.items[0];
+    if (!topItem) {
+        return 'No relevant matches found.';
+    }
+    const confidence = (result.aggregate_confidence * 100).toFixed(0);
+    const action = result.recommended_actions[0] || 'Investigate further';
+    return `[${confidence}% confidence] ${topItem.summary}\nRecommended: ${action}`;
+}
+//# sourceMappingURL=result-aggregator.js.map

package/dist/src/result-aggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-aggregator.js","sourceRoot":"","sources":["../../src/result-aggregator.ts"],"names":[],"mappings":";AAAA,mGAAmG;AACnG,sCAAsC;AACtC;;;;;;;;;GASG;;AA0EH,0CAiDC;AAKD,sCAiDC;AAKD,oCAiDC;AAqDD,4CA6DC;AAKD,0DAwCC;AAKD,gDAUC;AA3YD,kBAAkB;AAClB,MAAM,eAAe,GAAG;IACtB,KAAK,EAAE,IAAI,EAAQ,yBAAyB;IAC5C,UAAU,EAAE,IAAI,EAAG,wBAAwB;IAC3C,OAAO,EAAE,IAAI,EAAM,kCAAkC;IACrD,YAAY,EAAE,IAAI,CAAC,sBAAsB;CAC1C,CAAC;AAEF,6BAA6B;AAC7B,MAAM,mBAAmB,GAA2B;IAClD,GAAG,EAAE,GAAG,EAAK,WAAW;IACxB,GAAG,EAAE,GAAG,EAAK,UAAU;IACvB,GAAG,EAAE,GAAG,CAAK,aAAa;CAC3B,CAAC;AAkBF,MAAM,cAAc,GAAgC;IAClD,UAAU,EAAE,EAAE;IACd,iBAAiB,EAAE,GAAG;IACtB,iBAAiB,EAAE,GAAG;IACtB,YAAY,EAAE,GAAG;IACjB,eAAe,EAAE,GAAG;CACrB,CAAC;AAEF;;;GAGG;AACH,SAAS,qBAAqB,CAAC,SAAiB;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,GAAG,GAAG,SAAS,CAAC;IAC9B,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAElC,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;QAClB,OAAO,GAAG,CAAC,CAAC,gBAAgB;IAC9B,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC;IAC9B,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QACjB,OAAO,GAAG,CAAC,CAAC,qBAAqB;IACnC,CAAC;IAED,4CAA4C;IAC5C,OAAO,GAAG,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAC7B,UAA4B,EAC5B,SAA4B,EAAE;IAE9B,MAAM,WAAW,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IAErD,8BAA8B;IAC9B,6DAA6D;IAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,eAAe,CAAC,MAAM,GAAG,IAAI;QACvC,UAAU,CAAC,iBAAiB,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE5E,6BAA6B;IAC7B,MAAM,eAAe,GAAG,UAAU,CAAC,UAAU,CAAC;IAE9C,qDAAqD;IACrD,MAAM,YAAY,GAAG,GAAG,CAAC;IAEzB,2CAA2C;IAC3C,IAAI,iBAAiB,GAAG,GAAG,CAAC,CAAC,aAAa;IAC1C,IAAI,UAAU,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,iBAAiB,GAAG,GAAG,CAAC,CAAC,eAAe;IAC1C,CAAC;IACD,IAAI,UAAU,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;QACjC,iBAAiB,GAAG,GAAG,CAAC,CAAC,kBAAkB;IAC7C,CAAC;IAED,2BAA2B;IAC3B,IAAI,KAAK,GAAG,CACV,eAAe,CAAC,KAAK,GAAG,UAAU;QAClC,eAAe,CAAC,UAAU,GAAG,eAAe;QAC5C,eAAe,CAAC,OAAO,GAAG,YAAY;QACtC,eAAe,CAAC,YAAY,GAAG,iBAAiB,CACjD,CAAC;IAEF,+CAA+C;IAC/C,IAAI,UAAU,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;QACjC,KAAK,IAAI,WAAW,CAAC,iBAAiB,CAAC;IACzC,CAAC;IAED,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,EAAE,EAAE,UAAU,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;QAC/C,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC;QACzB,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,OAAO,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,sBAAsB;QAChE,OAAO,EAAE,UAAU,CAAC,mBAAmB;QACvC,IAAI,EAAE,UAAU,CAAC,WAAW;QAC5B,OAAO,EAAE,UAAU;KACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAC3B,QAAyB,EACzB,SAA4B,EAAE;IAE9B,MAAM,WAAW,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IAErD,6CAA6C;IAC7C,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,IAAI,GAAG,CAAC;IAEvC,6BAA6B;IAC7B,MAAM,eAAe,GAAG,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC;IAEzC,gBAAgB;IAChB,MAAM,YAAY,GAAG,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAExD,sBAAsB;IACtB,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IAEjE,2BAA2B;IAC3B,IAAI,KAAK,GAAG,CACV,eAAe,CAAC,KAAK,GAAG,UAAU;QAClC,eAAe,CAAC,UAAU,GAAG,eAAe;QAC5C,eAAe,CAAC,OAAO,GAAG,YAAY;QACtC,eAAe,CAAC,YAAY,GAAG,iBAAiB,CACjD,CAAC;IAEF,eAAe;IACf,IAAI,QAAQ,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;QACvB,KAAK,IAAI,WAAW,CAAC,iBAAiB,CAAC;IACzC,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC1D,IAAI,QAAQ,CAAC,EAAE,GAAG,YAAY,EAAE,CAAC;QAC/B,KAAK,IAAI,WAAW,CAAC,YAAY,CAAC;IACpC,CAAC;IAED,sBAAsB;IACtB,KAAK,IAAI,QAAQ,CAAC,CAAC,GAAG,GAAG,CAAC;IAE1B,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC;QACzB,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG;QACvB,OAAO,EAAE,QAAQ,CAAC,GAAG;QACrB,OAAO,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,IAAI,EAAE,QAAQ,CAAC,CAAC;QAChB,OAAO,EAAE,QAAQ;KAClB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAC1B,OAAuB,EACvB,aAAqB,GAAG,EACxB,SAA4B,EAAE;IAE9B,MAAM,WAAW,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IAErD,wEAAwE;IACxE,MAAM,eAAe,GAAG,GAAG,CAAC;IAE5B,yBAAyB;IACzB,MAAM,YAAY,GAAG,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD,yCAAyC;IACzC,IAAI,iBAAiB,GAAG,GAAG,CAAC;IAC5B,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACnB,iBAAiB,GAAG,GAAG,CAAC;IAC1B,CAAC;SAAM,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,iBAAiB,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,2BAA2B;IAC3B,IAAI,KAAK,GAAG,CACV,eAAe,CAAC,KAAK,GAAG,UAAU;QAClC,eAAe,CAAC,UAAU,GAAG,eAAe;QAC5C,eAAe,CAAC,OAAO,GAAG,YAAY;QACtC,eAAe,CAAC,YAAY,GAAG,iBAAiB,CACjD,CAAC;IAEF,kBAAkB;IAClB,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACnB,KAAK,IAAI,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC1D,IAAI,OAAO,CAAC,IAAI,GAAG,YAAY,EAAE,CAAC;QAChC,KAAK,IAAI,WAAW,CAAC,YAAY,CAAC;IACpC,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC;QACzB,MAAM,EAAE,OAAO,CAAC,GAAG;QACnB,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;QACtB,IAAI,EAAE,OAAO,CAAC,CAAC;QACf,OAAO,EAAE,OAAO;KACjB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,KAAiB,EAAE,KAAiB;IAC/D,qCAAqC;IACrC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/D,oBAAoB;QACpB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,YAAY,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACjE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACjD,MAAM,aAAa,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAE3D,iDAAiD;QACjD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACjE,MAAM,gBAAgB,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACvE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACvD,MAAM,cAAc,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAExE,OAAO,CAAC,aAAa,GAAG,GAAG,GAAG,cAAc,GAAG,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CACvB,KAAmB,EACnB,SAAiB;IAEjB,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAC7B,QAAQ,CAAC,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,SAAS,CAC7D,CAAC;QAEF,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAC9B,WAA+B,EAC/B,SAA4B,EAC5B,QAA0B,EAC1B,SAA4B,EAAE;IAE9B,MAAM,WAAW,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IAErD,kBAAkB;IAClB,MAAM,iBAAiB,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3E,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAEhF,2BAA2B;IAC3B,IAAI,QAAQ,GAAG;QACb,GAAG,iBAAiB;QACpB,GAAG,eAAe;QAClB,GAAG,cAAc;KAClB,CAAC;IAEF,0BAA0B;IAC1B,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAEhF,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAE3C,cAAc;IACd,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;IAEnE,gBAAgB;IAChB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAE3D,0BAA0B;IAC1B,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC,CAAC,CAAC;IACtF,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE5D,iCAAiC;IACjC,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC;QACvC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM;QACjE,CAAC,CAAC,CAAC,CAAC;IAEN,sEAAsE;IACtE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACtB,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,QAAQ,CAAC,MAAM;QAC5B,gBAAgB,EAAE,OAAO;QACzB,oBAAoB,EAAE,aAAa;QACnC,mBAAmB,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACnD,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CAAC,MAAwB;IAC9D,MAAM,KAAK,GAAa;QACtB,gCAAgC;QAChC,EAAE;QACF,gBAAgB,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE;QACjE,mBAAmB,CAAC,MAAM,CAAC,oBAAoB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QACpE,sBAAsB,MAAM,CAAC,WAAW,EAAE;QAC1C,EAAE;QACF,iBAAiB;QACjB,EAAE;KACH,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;YACvC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAExD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,MAAM,IAAI,CAAC,IAAI,OAAO,QAAQ,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACrG,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,MAAwB;IACzD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,4BAA4B,CAAC;IACtC,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,oBAAoB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,qBAAqB,CAAC;IAEtE,OAAO,IAAI,UAAU,iBAAiB,OAAO,CAAC,OAAO,kBAAkB,MAAM,EAAE,CAAC;AAClF,CAAC"}

package/dist/src/retrieval.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Debugging Memory System - Retrieval Layer
+ *
+ * Finds similar incidents and patterns based on symptom description.
+ * Uses multi-strategy search: exact → tag → fuzzy → semantic (optional).
+ */
+import type { Incident, Pattern, RetrievalConfig, RetrievalResult, MemoryConfig } from './types';
+/**
+ * Enhanced search result with match type and highlights
+ */
+export interface SearchResult {
+    incident: Incident;
+    score: number;
+    matchType: 'exact' | 'tag' | 'fuzzy' | 'category' | 'semantic';
+    highlights: string[];
+}
+/**
+ * Check memory for similar incidents
+ *
+ * This is the main entry point for memory retrieval.
+ */
+export declare function checkMemory(symptom: string, config?: Partial<RetrievalConfig> & {
+    memoryConfig?: MemoryConfig;
+}): Promise<RetrievalResult>;
+/**
+ * Get full incident details (for lazy loading)
+ */
+export declare function getFullIncident(incident_id: string): Promise<Incident | null>;
+/**
+ * Simple search by tags
+ */
+export declare function searchByTags(tags: string[], config?: MemoryConfig): Promise<Incident[]>;
+/**
+ * Get recent incidents
+ */
+export declare function getRecentIncidents(days?: number, config?: MemoryConfig): Promise<Incident[]>;
+/**
+ * Enhanced multi-strategy search
+ *
+ * Strategy order: exact → tag → fuzzy → category
+ * Each strategy adds results with appropriate confidence scores
+ */
+export declare function enhancedSearch(query: string, options?: {
+    threshold?: number;
+    maxResults?: number;
+    memoryConfig?: MemoryConfig;
+}): Promise<SearchResult[]>;
+import type { TieredRetrievalConfig, TieredRetrievalResult, SearchVerdict, VerdictResult, ProgressiveResult } from './types';
+/**
+ * Token-optimized memory check with tiered retrieval
+ *
+ * Tiers:
+ * - 'summary': Minimal representation (~100 tokens/incident) for quick scans
+ * - 'compact': Short keys, truncated fields (~200 tokens/incident) - DEFAULT
+ * - 'full': Complete incident data (~550 tokens/incident) for detailed analysis
+ *
+ * Token budget enforcement ensures context doesn't exceed limits.
+ */
+export declare function checkMemoryTiered(symptom: string, config?: Partial<TieredRetrievalConfig> & {
+    memoryConfig?: MemoryConfig;
+}): Promise<TieredRetrievalResult>;
+/**
+ * Quick memory check with minimal output
+ *
+ * Returns only essential fields for rapid assessment.
+ * Useful when token budget is very tight.
+ */
+export declare function quickMemoryCheck(symptom: string, config?: {
+    memoryConfig?: MemoryConfig;
+    maxResults?: number;
+}): Promise<{
+    hasMatches: boolean;
+    matchCount: number;
+    topMatch?: {
+        id: string;
+        symptom: string;
+        category: string;
+        confidence: number;
+    };
+    tokensUsed: number;
+}>;
+/**
+ * Get incident details on demand (lazy loading)
+ *
+ * Use this when compact/summary tier found a match and full details are needed.
+ */
+export declare function getIncidentDetails(incident_id: string, config?: MemoryConfig): Promise<Incident | null>;
+/**
+ * Get pattern details on demand (lazy loading)
+ */
+export declare function getPatternDetails(pattern_id: string, config?: MemoryConfig): Promise<Pattern | null>;
+/**
+ * Estimate token usage for different retrieval tiers
+ */
+export declare function estimateTokensForTier(incidentCount: number, patternCount: number, tier: 'summary' | 'compact' | 'full'): number;
+/**
+ * Classify search results into an actionable verdict
+ *
+ * Verdicts:
+ * - KNOWN_FIX:    High-confidence match with verified pattern (>0.8, verified)
+ * - LIKELY_MATCH:  Good match with relevant incidents (0.5-0.8)
+ * - WEAK_SIGNAL:   Possible relation, worth reviewing (0.3-0.5)
+ * - NO_MATCH:      Nothing found, debug fresh
+ */
+export declare function classifyVerdict(result: RetrievalResult): SearchVerdict;
+/**
+ * Check memory and return verdict-wrapped results
+ *
+ * This is the recommended entry point for memory-first debugging.
+ * Returns an actionable verdict instead of raw scores.
+ */
+export declare function checkMemoryWithVerdict(symptom: string, config?: Partial<RetrievalConfig> & {
+    memoryConfig?: MemoryConfig;
+}): Promise<VerdictResult>;
+/**
+ * Check memory with progressive depth — returns one-liner matches with drill-down commands
+ *
+ * Total output stays under 500 tokens even with 10 matches.
+ * Use /debugger-detail <ID> to get full incident data on demand.
+ */
+export declare function checkMemoryProgressive(symptom: string, config?: Partial<RetrievalConfig> & {
+    memoryConfig?: MemoryConfig;
+}): Promise<ProgressiveResult>;
+/**
+ * Check memory using keyword index for scalable retrieval
+ *
+ * Instead of loading ALL incidents (O(n) file reads), this:
+ * 1. Extracts query keywords
+ * 2. Loads keyword index (1 file read)
+ * 3. Finds candidate IDs via set intersection
+ * 4. Loads only top candidates (max 20 file reads)
+ * 5. Scores and ranks
+ *
+ * Falls back to checkMemory() if keyword index doesn't exist.
+ */
+export declare function checkMemoryScaled(symptom: string, config?: Partial<RetrievalConfig> & {
+    memoryConfig?: MemoryConfig;
+}): Promise<RetrievalResult>;
+//# sourceMappingURL=retrieval.d.ts.map

package/dist/src/retrieval.d.ts.map

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