@egentica/codemap 0.1.5

package/dist/assist/AssistScorer.d.ts

@@ -0,0 +1,91 @@
+/**
+ * AssistScorer - Multi-phase scoring engine for file discovery.
+ *
+ * Implements the 4-phase scoring algorithm:
+ * - Phase A: Static scoring (keyword/symbol matching)
+ * - Phase B: Stack bias (language-specific patterns)
+ * - Phase C: Experience weighting (query history, usage, anti-results)
+ * - Phase D: Confidence + warnings
+ *
+ * @example
+ * ```typescript
+ * const scorer = new AssistScorer(patternAggregator, config);
+ *
+ * const candidates = await scorer.score(
+ *   'make cards draggable',
+ *   [file1, file2, file3]
+ * );
+ * // → Returns ranked candidates with confidence scores
+ * ```
+ */
+import type { AssistCandidate, StackPackBias } from '../types';
+import type { FileEntry } from '../types';
+import { PatternAggregator } from './PatternAggregator';
+/**
+ * Scorer configuration.
+ */
+export interface AssistScorerConfig {
+    /** Stack pack bias rules (optional) */
+    stackBias?: StackPackBias;
+    /** Enable experience weighting */
+    useExperience?: boolean;
+}
+export declare class AssistScorer {
+    private aggregator;
+    private config;
+    constructor(aggregator: PatternAggregator | null, config?: AssistScorerConfig);
+    /**
+     * Score file candidates using multi-phase algorithm.
+     *
+     * @param goal - Goal query
+     * @param candidates - File candidates to score
+     * @returns Ranked candidates with scores
+     */
+    score(goal: string, candidates: FileEntry[]): Promise<AssistCandidate[]>;
+    /**
+     * Phase A: Score candidates based on keyword and symbol matching.
+     *
+     * @param goal - Goal query
+     * @param candidates - File candidates
+     * @returns Raw candidates with static scores
+     */
+    private phaseA_StaticScoring;
+    /**
+     * Phase B: Apply stack-specific bias rules.
+     *
+     * @param goal - Goal query
+     * @param candidates - Raw candidates
+     * @returns Candidates with bias applied
+     */
+    private phaseB_StackBias;
+    /**
+     * Phase C: Apply experience-based scoring adjustments.
+     *
+     * This is where the self-improving magic happens:
+     * - Query history matching (+points for similar past queries)
+     * - Usage metadata matching (+points for curated usage phrases)
+     * - Anti-result penalties (-points for past failures)
+     * - File experience multiplier (success rate, recency, heat)
+     *
+     * @param goal - Goal query
+     * @param candidates - Raw candidates
+     * @returns Candidates with experience weighting
+     */
+    private phaseC_ExperienceWeighting;
+    /**
+     * Phase D: Calculate final confidence scores and generate warnings.
+     *
+     * @param candidates - Raw candidates with total scores
+     * @returns Final candidates with confidence and warnings
+     */
+    private phaseD_ConfidenceAndWarnings;
+    /**
+     * Extract keywords from text.
+     */
+    private extractKeywords;
+    /**
+     * Calculate keyword overlap.
+     */
+    private calculateOverlap;
+}
+//# sourceMappingURL=AssistScorer.d.ts.map

package/dist/assist/AssistScorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistScorer.d.ts","sourceRoot":"","sources":["../../src/assist/AssistScorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACd,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAWxD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,SAAS,CAAC,EAAE,aAAa,CAAC;IAE1B,kCAAkC;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,qBAAa,YAAY;IAGrB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;gBADN,UAAU,EAAE,iBAAiB,GAAG,IAAI,EACpC,MAAM,GAAE,kBAAuB;IAGzC;;;;;;OAMG;IACG,KAAK,CACT,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,SAAS,EAAE,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC;IAwB7B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IA2C5B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IA8BxB;;;;;;;;;;;;OAYG;YACW,0BAA0B;IAoExC;;;;;OAKG;IACH,OAAO,CAAC,4BAA4B;IA2CpC;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAazB"}

package/dist/assist/AssistScorer.js

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * AssistScorer - Multi-phase scoring engine for file discovery.
+ *
+ * Implements the 4-phase scoring algorithm:
+ * - Phase A: Static scoring (keyword/symbol matching)
+ * - Phase B: Stack bias (language-specific patterns)
+ * - Phase C: Experience weighting (query history, usage, anti-results)
+ * - Phase D: Confidence + warnings
+ *
+ * @example
+ * ```typescript
+ * const scorer = new AssistScorer(patternAggregator, config);
+ *
+ * const candidates = await scorer.score(
+ *   'make cards draggable',
+ *   [file1, file2, file3]
+ * );
+ * // → Returns ranked candidates with confidence scores
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssistScorer = void 0;
+class AssistScorer {
+    aggregator;
+    config;
+    constructor(aggregator, config = {}) {
+        this.aggregator = aggregator;
+        this.config = config;
+    }
+    /**
+     * Score file candidates using multi-phase algorithm.
+     *
+     * @param goal - Goal query
+     * @param candidates - File candidates to score
+     * @returns Ranked candidates with scores
+     */
+    async score(goal, candidates) {
+        // Phase A: Static scoring
+        let raw = this.phaseA_StaticScoring(goal, candidates);
+        // Phase B: Stack bias (if configured)
+        if (this.config.stackBias) {
+            raw = this.phaseB_StackBias(goal, raw);
+        }
+        // Phase C: Experience weighting (if enabled and aggregator available)
+        if (this.config.useExperience !== false && this.aggregator) {
+            raw = await this.phaseC_ExperienceWeighting(goal, raw);
+        }
+        // Phase D: Confidence + warnings
+        const final = this.phaseD_ConfidenceAndWarnings(raw);
+        // Sort by confidence descending
+        return final.sort((a, b) => b.confidence - a.confidence);
+    }
+    // ── Phase A: Static Scoring ────────────────────────────────────────────────
+    /**
+     * Phase A: Score candidates based on keyword and symbol matching.
+     *
+     * @param goal - Goal query
+     * @param candidates - File candidates
+     * @returns Raw candidates with static scores
+     */
+    phaseA_StaticScoring(goal, candidates) {
+        const keywords = this.extractKeywords(goal);
+        const raw = [];
+        for (const file of candidates) {
+            let score = 0;
+            const reasons = [];
+            // Path matching
+            const pathKeywords = this.extractKeywords(file.relativePath);
+            const pathOverlap = this.calculateOverlap(keywords, pathKeywords);
+            if (pathOverlap > 0) {
+                const pathScore = pathOverlap * 5;
+                score += pathScore;
+                reasons.push(`path match (+${pathScore.toFixed(1)})`);
+            }
+            // Symbol matching
+            if (file.symbols && file.symbols.length > 0) {
+                for (const symbol of file.symbols) {
+                    const symbolKeywords = this.extractKeywords(symbol.name);
+                    const symbolOverlap = this.calculateOverlap(keywords, symbolKeywords);
+                    if (symbolOverlap > 0) {
+                        const symbolScore = symbolOverlap * 3;
+                        score += symbolScore;
+                        reasons.push(`symbol ${symbol.name} (+${symbolScore.toFixed(1)})`);
+                    }
+                }
+            }
+            raw.push({ file, score, reasons });
+        }
+        return raw;
+    }
+    // ── Phase B: Stack Bias ────────────────────────────────────────────────────
+    /**
+     * Phase B: Apply stack-specific bias rules.
+     *
+     * @param goal - Goal query
+     * @param candidates - Raw candidates
+     * @returns Candidates with bias applied
+     */
+    phaseB_StackBias(goal, candidates) {
+        if (!this.config.stackBias)
+            return candidates;
+        for (const rule of this.config.stackBias.rules) {
+            // Check if rule applies to this goal
+            const matches = typeof rule.when === 'string'
+                ? goal.includes(rule.when)
+                : rule.when.test(goal);
+            if (!matches)
+                continue;
+            // Apply boosts to matching paths
+            for (const candidate of candidates) {
+                for (const [pathPattern, boost] of Object.entries(rule.boost)) {
+                    if (candidate.file.relativePath.includes(pathPattern)) {
+                        candidate.score += boost;
+                        candidate.reasons.push(`stack bias: ${pathPattern} (+${boost})`);
+                    }
+                }
+            }
+        }
+        return candidates;
+    }
+    // ── Phase C: Experience Weighting ──────────────────────────────────────────
+    /**
+     * Phase C: Apply experience-based scoring adjustments.
+     *
+     * This is where the self-improving magic happens:
+     * - Query history matching (+points for similar past queries)
+     * - Usage metadata matching (+points for curated usage phrases)
+     * - Anti-result penalties (-points for past failures)
+     * - File experience multiplier (success rate, recency, heat)
+     *
+     * @param goal - Goal query
+     * @param candidates - Raw candidates
+     * @returns Candidates with experience weighting
+     */
+    async phaseC_ExperienceWeighting(goal, candidates) {
+        if (!this.aggregator)
+            return candidates;
+        for (const candidate of candidates) {
+            const filePath = candidate.file.relativePath;
+            // 1. Query history matching (+12 max)
+            const queryMatch = await this.aggregator.getQueryPatternMatches(filePath, goal);
+            if (queryMatch.matchingQueries.length > 0) {
+                const boost = Math.min(queryMatch.matchingQueries.length * 3, 12);
+                candidate.score += boost;
+                candidate.reasons.push(`query history (+${boost}, ${queryMatch.matchingQueries.length} matches)`);
+            }
+            // 2. Usage metadata matching (+16 max)
+            const usageMatches = await this.aggregator.getUsageMatches(goal);
+            const fileUsageMatch = usageMatches.find(m => m.file === filePath);
+            if (fileUsageMatch && fileUsageMatch.matchingUsages.length > 0) {
+                const boost = Math.min(fileUsageMatch.matchingUsages.length * 4, 16);
+                candidate.score += boost;
+                candidate.reasons.push(`usage metadata (+${boost}, ${fileUsageMatch.matchingUsages.length} phrases)`);
+            }
+            // 3. Anti-result penalty (-10 max)
+            const antiPenalty = await this.aggregator.getAntiResultPenalty(filePath, goal);
+            if (antiPenalty.penalty < 0) {
+                candidate.score += antiPenalty.penalty;
+                candidate.reasons.push(`anti-result penalty (${antiPenalty.penalty})`);
+            }
+            // 4. File experience multiplier (0.5–2.0×)
+            const metrics = await this.aggregator.getFileMetrics(filePath);
+            if (metrics.totalOps > 0) {
+                let multiplier = 1.0;
+                // Success rate influence
+                if (metrics.successRate < 0.5) {
+                    multiplier *= 0.5;
+                }
+                else if (metrics.successRate > 0.75) {
+                    multiplier *= 1.5;
+                }
+                // Recency boost
+                if (metrics.daysSinceAccess !== undefined && metrics.daysSinceAccess < 7) {
+                    multiplier += 0.3;
+                }
+                // Heat score boost
+                multiplier += metrics.heatScore * 0.5;
+                // Apply multiplier
+                if (multiplier !== 1.0) {
+                    candidate.score *= multiplier;
+                    candidate.reasons.push(`experience multiplier (×${multiplier.toFixed(2)})`);
+                }
+            }
+        }
+        return candidates;
+    }
+    // ── Phase D: Confidence + Warnings ─────────────────────────────────────────
+    /**
+     * Phase D: Calculate final confidence scores and generate warnings.
+     *
+     * @param candidates - Raw candidates with total scores
+     * @returns Final candidates with confidence and warnings
+     */
+    phaseD_ConfidenceAndWarnings(candidates) {
+        // Find max score for normalization
+        const maxScore = Math.max(...candidates.map(c => c.score), 1);
+        const final = [];
+        for (const candidate of candidates) {
+            // Normalize to 0-1 confidence
+            const confidence = Math.min(candidate.score / maxScore, 1.0);
+            // Generate warnings
+            const warnings = [];
+            if (candidate.score < 3) {
+                warnings.push('Low confidence match');
+            }
+            if (candidate.file.symbols && candidate.file.symbols.length === 0) {
+                warnings.push('No symbols indexed');
+            }
+            final.push({
+                file: candidate.file.relativePath,
+                confidence,
+                rawScore: candidate.score,
+                scoring: {
+                    static: 0, // Not tracked separately in this implementation
+                    bias: 0, // Not tracked separately
+                    experience: 0, // Not tracked separately
+                    total: candidate.score
+                },
+                reasons: candidate.reasons,
+                warnings: warnings.length > 0 ? warnings : undefined
+            });
+        }
+        return final;
+    }
+    // ── Utilities ──────────────────────────────────────────────────────────────
+    /**
+     * Extract keywords from text.
+     */
+    extractKeywords(text) {
+        const words = text.toLowerCase().split(/[^a-z0-9]+/);
+        const stopWords = new Set(['a', 'an', 'the', 'is', 'are', 'was', 'were', 'be', 'to', 'of', 'in', 'on', 'at']);
+        return words
+            .filter(w => w.length > 2 && !stopWords.has(w))
+            .filter((w, i, arr) => arr.indexOf(w) === i);
+    }
+    /**
+     * Calculate keyword overlap.
+     */
+    calculateOverlap(keywords1, keywords2) {
+        if (keywords1.length === 0 || keywords2.length === 0)
+            return 0;
+        const set1 = new Set(keywords1);
+        const set2 = new Set(keywords2);
+        let overlap = 0;
+        for (const keyword of set1) {
+            if (set2.has(keyword))
+                overlap++;
+        }
+        return overlap / Math.max(keywords1.length, keywords2.length);
+    }
+}
+exports.AssistScorer = AssistScorer;
+//# sourceMappingURL=AssistScorer.js.map

package/dist/assist/AssistScorer.js.map

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

package/dist/assist/PatternAggregator.d.ts

@@ -0,0 +1,116 @@
+/**
+ * PatternAggregator - Analyzes experience data to extract scoring patterns.
+ *
+ * Reads from ExperienceStore and provides:
+ * - Query pattern matching (which queries led to which files)
+ * - Usage metadata matching (curated usage phrases)
+ * - Anti-result penalties (learn from mistakes)
+ * - File experience metrics (success rate, recency, heat)
+ * - Symbol experience metrics (edit history, keywords)
+ *
+ * This is the intelligence layer that powers AssistMap's experience scoring.
+ *
+ * @example
+ * ```typescript
+ * const aggregator = new PatternAggregator(experienceStore);
+ *
+ * // Get query pattern matches
+ * const matches = await aggregator.getQueryPatternMatches('file.ts', 'make cards draggable');
+ * // → Returns matching queries + confidence score
+ *
+ * // Get usage metadata matches
+ * const usageMatches = await aggregator.getUsageMatches('make cards draggable');
+ * // → Returns files with matching usage phrases
+ *
+ * // Get anti-result penalty
+ * const penalty = await aggregator.getAntiResultPenalty('file.ts', 'drag drop');
+ * // → Returns negative score if this file was previously rejected
+ * ```
+ */
+import type { QueryPatternMatch, UsageMatch, AntiResultPenalty, FileExperienceMetrics, SymbolExperienceMetrics } from '../types';
+import { ExperienceStore } from '../core/ExperienceStore';
+export declare class PatternAggregator {
+    private store;
+    constructor(store: ExperienceStore);
+    /**
+     * Get query pattern matches for a file.
+     *
+     * Finds successful queries from journey history that led to this file.
+     *
+     * @param filePath - Target file path
+     * @param currentQuery - Current query to compare against
+     * @returns Query pattern match result
+     */
+    getQueryPatternMatches(filePath: string, currentQuery: string): Promise<QueryPatternMatch>;
+    /**
+     * Get usage metadata matches for a query.
+     *
+     * Finds files with usage phrases matching the query.
+     *
+     * @param query - Search query
+     * @returns Array of usage matches
+     */
+    getUsageMatches(query: string): Promise<UsageMatch[]>;
+    /**
+     * Get anti-result penalty for a file.
+     *
+     * Returns negative score if this file was previously shown but rejected
+     * or abandoned for similar queries.
+     *
+     * @param filePath - File path
+     * @param currentQuery - Current query
+     * @returns Anti-result penalty
+     */
+    getAntiResultPenalty(filePath: string, currentQuery: string): Promise<AntiResultPenalty>;
+    /**
+     * Get experience metrics for a file.
+     *
+     * @param filePath - File path
+     * @returns File experience metrics
+     */
+    getFileMetrics(filePath: string): Promise<FileExperienceMetrics>;
+    /**
+     * Get symbol experience metrics for a file.
+     *
+     * @param filePath - File path
+     * @returns Array of symbol metrics
+     */
+    getSymbolMetrics(filePath: string): Promise<SymbolExperienceMetrics[]>;
+    /**
+     * Get all events for a specific file.
+     *
+     * @param filePath - File path
+     * @returns Array of events
+     */
+    private getEventsForFile;
+    /**
+     * Extract keywords from a query string.
+     *
+     * @param text - Query text
+     * @returns Array of keywords
+     */
+    private extractKeywords;
+    /**
+     * Calculate keyword overlap between two keyword sets.
+     *
+     * @param keywords1 - First set
+     * @param keywords2 - Second set
+     * @returns Overlap ratio (0-1)
+     */
+    private calculateKeywordOverlap;
+    /**
+     * Calculate heat score based on recent activity.
+     *
+     * @param events - Events for a file
+     * @returns Heat score (0-1)
+     */
+    private calculateHeatScore;
+    /**
+     * Extract domain keywords from a symbol reference.
+     *
+     * @param symbolRef - Symbol reference (e.g., "src/renderer/components/TaskCard.vue$handleDragStart")
+     * @returns Array of domain keywords
+     */
+    private extractDomainKeywords;
+}
+//# sourceMappingURL=PatternAggregator.d.ts.map

package/dist/assist/PatternAggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PatternAggregator.d.ts","sourceRoot":"","sources":["../../src/assist/PatternAggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,qBAAa,iBAAiB;IAEhB,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAI1C;;;;;;;;OAQG;IACG,sBAAsB,CAC1B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC;IA2C7B;;;;;;;OAOG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA+B3D;;;;;;;;;OASG;IACG,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC;IAoC7B;;;;;OAKG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAyCtE;;;;;OAKG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAsC5E;;;;;OAKG;YACW,gBAAgB;IAQ9B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAYvB;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAkB/B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CAkB9B"}