@codeledger/selector 0.1.1 → 0.2.1

package/dist/knowledge-candidates.js

@@ -0,0 +1,123 @@
+/**
+ * Knowledge-mode candidate generation.
+ *
+ * Simpler than code-mode: no dependency graph, no test mapping, no fan-out.
+ * Instead: keyword IDF, folder proximity, recency, type filters.
+ */
+const STOP_WORDS = new Set([
+    'the', 'a', 'an', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+    'of', 'with', 'by', 'from', 'is', 'it', 'that', 'this', 'be', 'as',
+    'are', 'was', 'were', 'been', 'being', 'have', 'has', 'had', 'do',
+    'does', 'did', 'will', 'would', 'could', 'should', 'may', 'might',
+    'shall', 'can', 'need', 'must', 'not', 'no', 'if', 'then', 'else',
+    'when', 'up', 'out', 'so', 'than', 'too', 'very', 'just', 'about',
+    'into', 'over', 'after', 'before', 'between', 'under', 'above',
+    'all', 'each', 'every', 'both', 'few', 'more', 'most', 'some', 'any',
+    'help', 'me', 'draft', 'write', 'create', 'make', 'give', 'tell',
+    'what', 'how', 'why', 'where', 'which',
+]);
+/** Supported file extensions for full content processing */
+const SUPPORTED_EXTENSIONS = new Set(['.md', '.txt', '.json', '.yaml', '.yml']);
+/**
+ * Tokenize intent text into keywords (stop-word filtered).
+ */
+export function tokenizeIntent(text) {
+    const lower = text.toLowerCase();
+    const words = lower
+        .split(/[^\p{L}\p{N}]+/u)
+        .filter((w) => w.length > 1 && !STOP_WORDS.has(w));
+    return [...new Set(words)];
+}
+/**
+ * Compute IDF-like token weights based on file match frequency.
+ */
+export function computeKnowledgeTokenWeights(tokens, files) {
+    const weights = new Map();
+    for (const token of tokens) {
+        let matchCount = 0;
+        for (const file of files) {
+            const pathLower = file.path.toLowerCase();
+            if (pathLower.includes(token)) {
+                matchCount++;
+                continue;
+            }
+            if (file.content_keywords?.some((ck) => ck === token || ck === token + 's' || token === ck + 's')) {
+                matchCount++;
+            }
+        }
+        if (matchCount === 0) {
+            weights.set(token, 0);
+            continue;
+        }
+        let idf = 1 / Math.sqrt(Math.max(1, matchCount));
+        if (token.length <= 2)
+            idf = Math.min(idf, 0.35);
+        if (matchCount > 20)
+            idf = Math.min(idf, 0.35);
+        idf = Math.max(0.35, Math.min(1.0, idf));
+        weights.set(token, idf);
+    }
+    return weights;
+}
+/**
+ * Infer "anchor" folders from intent tokens.
+ * If a token matches a top-level folder name, that folder is an anchor.
+ */
+export function inferAnchorFolders(tokens, files) {
+    // Collect all unique folder paths
+    const folders = new Set();
+    for (const file of files) {
+        const parts = file.path.split('/');
+        for (let i = 1; i < parts.length; i++) {
+            folders.add(parts.slice(0, i).join('/'));
+        }
+    }
+    const anchors = [];
+    for (const folder of folders) {
+        const folderLower = folder.toLowerCase();
+        const folderName = folderLower.split('/').pop() ?? '';
+        for (const token of tokens) {
+            if (folderName === token || folderName === token + 's' || token === folderName + 's') {
+                anchors.push(folder);
+                break;
+            }
+        }
+    }
+    return anchors;
+}
+/**
+ * Generate knowledge-mode candidates.
+ * All files are candidates (scored by the knowledge scorer), but only
+ * supported file types get full content analysis.
+ */
+export function generateKnowledgeCandidates(files, intentTokens, tokenWeights) {
+    // All files are candidates — the scorer handles ranking.
+    // Filter out zero-relevance files: if a file has no keyword match, no
+    // path match, and is an unsupported type, skip it to save scoring time.
+    const candidates = [];
+    for (const file of files) {
+        const pathLower = file.path.toLowerCase();
+        const isSupported = SUPPORTED_EXTENSIONS.has(file.extension.toLowerCase());
+        // Always include supported file types
+        if (isSupported) {
+            candidates.push(file);
+            continue;
+        }
+        // For unsupported types, only include if filename/path matches a keyword
+        let hasPathMatch = false;
+        for (const token of intentTokens) {
+            const w = tokenWeights.get(token) ?? 0;
+            if (w === 0)
+                continue;
+            if (pathLower.includes(token)) {
+                hasPathMatch = true;
+                break;
+            }
+        }
+        if (hasPathMatch) {
+            candidates.push(file);
+        }
+    }
+    return candidates;
+}
+//# sourceMappingURL=knowledge-candidates.js.map

package/dist/knowledge-candidates.js.map

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

package/dist/knowledge-excerpt.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Knowledge-mode excerpt extraction.
+ *
+ * Strategies:
+ *   - head: First N lines (for text, JSON, YAML)
+ *   - head+headers: First N lines + all markdown headers (for .md files)
+ *   - head+keyword_windows: First N lines + keyword context windows
+ */
+import type { CoworkExcerptStrategy } from '@codeledger/types';
+export interface KnowledgeExcerptResult {
+    content: string;
+    lines_est: number;
+    bytes_est: number;
+    strategy: CoworkExcerptStrategy;
+}
+/**
+ * Extract excerpt from a knowledge-mode file.
+ *
+ * @param root       Workspace root
+ * @param filePath   Relative file path
+ * @param keywords   Intent keywords for window extraction
+ * @param maxLines   Maximum excerpt lines (default 450)
+ * @param maxBytes   Maximum excerpt bytes (default 24000)
+ */
+export declare function extractKnowledgeExcerpt(root: string, filePath: string, keywords: string[], maxLines?: number, maxBytes?: number): KnowledgeExcerptResult;
+//# sourceMappingURL=knowledge-excerpt.d.ts.map

package/dist/knowledge-excerpt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-excerpt.d.ts","sourceRoot":"","sources":["../src/knowledge-excerpt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAI/D,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,GAAE,MAAY,EACtB,QAAQ,GAAE,MAAc,GACvB,sBAAsB,CAoDxB"}

package/dist/knowledge-excerpt.js

@@ -0,0 +1,179 @@
+/**
+ * Knowledge-mode excerpt extraction.
+ *
+ * Strategies:
+ *   - head: First N lines (for text, JSON, YAML)
+ *   - head+headers: First N lines + all markdown headers (for .md files)
+ *   - head+keyword_windows: First N lines + keyword context windows
+ */
+import { readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+const MAX_FILE_SIZE = 10 * 1024 * 1024; // 10 MB
+/**
+ * Extract excerpt from a knowledge-mode file.
+ *
+ * @param root       Workspace root
+ * @param filePath   Relative file path
+ * @param keywords   Intent keywords for window extraction
+ * @param maxLines   Maximum excerpt lines (default 450)
+ * @param maxBytes   Maximum excerpt bytes (default 24000)
+ */
+export function extractKnowledgeExcerpt(root, filePath, keywords, maxLines = 450, maxBytes = 24000) {
+    const absPath = join(root, filePath);
+    const ext = filePath.split('.').pop()?.toLowerCase() ?? '';
+    let rawContent;
+    try {
+        const size = statSync(absPath).size;
+        if (size > MAX_FILE_SIZE) {
+            return {
+                content: `[File too large: ${Math.round(size / 1024)}KB]`,
+                lines_est: 1,
+                bytes_est: 0,
+                strategy: 'head',
+            };
+        }
+        rawContent = readFileSync(absPath, 'utf-8');
+    }
+    catch {
+        return { content: '', lines_est: 0, bytes_est: 0, strategy: 'head' };
+    }
+    // Check if file is binary
+    if (rawContent.length > 0 && rawContent.slice(0, 8192).includes('\0')) {
+        return {
+            content: '[Binary file — metadata only]',
+            lines_est: 0,
+            bytes_est: 0,
+            strategy: 'head',
+        };
+    }
+    const lines = rawContent.split('\n');
+    // If file fits within limits, return full content
+    if (lines.length <= maxLines && rawContent.length <= maxBytes) {
+        return {
+            content: rawContent,
+            lines_est: lines.length,
+            bytes_est: rawContent.length,
+            strategy: 'head',
+        };
+    }
+    // Choose strategy based on extension
+    if (ext === 'md' || ext === 'mdx') {
+        return extractHeadPlusHeaders(lines, keywords, maxLines, maxBytes);
+    }
+    if (keywords.length > 0) {
+        return extractHeadPlusKeywordWindows(lines, keywords, maxLines, maxBytes);
+    }
+    return extractHead(lines, maxLines, maxBytes);
+}
+function extractHead(lines, maxLines, maxBytes) {
+    const selected = [];
+    let bytes = 0;
+    for (let i = 0; i < lines.length && selected.length < maxLines; i++) {
+        const line = lines[i];
+        if (bytes + line.length + 1 > maxBytes)
+            break;
+        selected.push(line);
+        bytes += line.length + 1;
+    }
+    if (selected.length < lines.length) {
+        selected.push(`\n[... ${lines.length - selected.length} more lines omitted ...]`);
+    }
+    return {
+        content: selected.join('\n'),
+        lines_est: selected.length,
+        bytes_est: bytes,
+        strategy: 'head',
+    };
+}
+function extractHeadPlusHeaders(lines, keywords, maxLines, maxBytes) {
+    const includedLineNums = new Set();
+    // Pass 1: Include first 100 lines (head section)
+    const headSize = Math.min(100, lines.length);
+    for (let i = 0; i < headSize; i++) {
+        includedLineNums.add(i);
+    }
+    // Pass 2: Include all markdown header lines (^# ...)
+    for (let i = headSize; i < lines.length; i++) {
+        if (lines[i].match(/^#{1,6}\s/)) {
+            // Include header + next 2 lines for context
+            includedLineNums.add(i);
+            if (i + 1 < lines.length)
+                includedLineNums.add(i + 1);
+            if (i + 2 < lines.length)
+                includedLineNums.add(i + 2);
+        }
+    }
+    // Pass 3: Include keyword windows (if keywords provided)
+    if (keywords.length > 0) {
+        const windowSize = 5;
+        for (let i = headSize; i < lines.length; i++) {
+            const lineLower = lines[i].toLowerCase();
+            for (const kw of keywords) {
+                if (lineLower.includes(kw)) {
+                    const start = Math.max(0, i - windowSize);
+                    const end = Math.min(lines.length - 1, i + windowSize);
+                    for (let j = start; j <= end; j++) {
+                        includedLineNums.add(j);
+                    }
+                    break;
+                }
+            }
+        }
+    }
+    return assembleExcerpt(lines, includedLineNums, maxLines, maxBytes, 'head+headers');
+}
+function extractHeadPlusKeywordWindows(lines, keywords, maxLines, maxBytes) {
+    const includedLineNums = new Set();
+    // Pass 1: Head section
+    const headSize = Math.min(100, lines.length);
+    for (let i = 0; i < headSize; i++) {
+        includedLineNums.add(i);
+    }
+    // Pass 2: Keyword windows
+    const windowSize = 8;
+    for (let i = headSize; i < lines.length; i++) {
+        const lineLower = lines[i].toLowerCase();
+        for (const kw of keywords) {
+            if (lineLower.includes(kw)) {
+                const start = Math.max(0, i - windowSize);
+                const end = Math.min(lines.length - 1, i + windowSize);
+                for (let j = start; j <= end; j++) {
+                    includedLineNums.add(j);
+                }
+                break;
+            }
+        }
+    }
+    return assembleExcerpt(lines, includedLineNums, maxLines, maxBytes, 'head+keyword_windows');
+}
+function assembleExcerpt(lines, includedLineNums, maxLines, maxBytes, strategy) {
+    const sorted = [...includedLineNums].sort((a, b) => a - b);
+    const parts = [];
+    let lastLine = -2;
+    let bytes = 0;
+    let lineCount = 0;
+    for (const lineNum of sorted) {
+        if (lineCount >= maxLines || bytes >= maxBytes)
+            break;
+        if (lineNum > lastLine + 1 && lastLine >= 0) {
+            const gap = `\n[... lines ${lastLine + 2}–${lineNum} omitted ...]\n`;
+            parts.push(gap);
+            bytes += gap.length;
+        }
+        const line = lines[lineNum];
+        parts.push(line);
+        bytes += line.length + 1;
+        lineCount++;
+        lastLine = lineNum;
+    }
+    if (sorted.length > 0 && sorted[sorted.length - 1] < lines.length - 1) {
+        parts.push(`\n[... ${lines.length - (sorted[sorted.length - 1] + 1)} more lines omitted ...]`);
+    }
+    return {
+        content: parts.join('\n'),
+        lines_est: lineCount,
+        bytes_est: bytes,
+        strategy,
+    };
+}
+//# sourceMappingURL=knowledge-excerpt.js.map

package/dist/knowledge-excerpt.js.map

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

package/dist/knowledge-scorer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Knowledge-mode scorer — deterministic scoring for non-code workspace files.
+ *
+ * 7 weighted signals:
+ *   keyword_match      — IDF-weighted keyword match in content
+ *   filename_match     — Keyword match against filename stems
+ *   path_match         — Keyword match against folder path segments
+ *   recency            — mtime exponential decay
+ *   size_penalty       — Penalize large files
+ *   doc_type_prior     — Extension weighting (.md > .txt > .json > others)
+ *   folder_proximity   — Shared path segment scoring with intent-inferred anchors
+ *   markdown_header_boost — Regex ^# headers matching keywords in first N lines
+ */
+import type { KnowledgeFeatures, KnowledgeScoredFile, KnowledgeWeights, WorkspaceFileInfo } from '@codeledger/types';
+/** Default knowledge-mode weights (match spec signal_weights) */
+export declare const DEFAULT_KNOWLEDGE_WEIGHTS: KnowledgeWeights;
+/**
+ * Compute knowledge-mode features for a single file.
+ */
+export declare function computeKnowledgeFeatures(file: WorkspaceFileInfo, intentTokens: string[], tokenWeights: Map<string, number>, anchorFolders: string[], nowMs: number): KnowledgeFeatures;
+/**
+ * Score a file using weighted sum of knowledge features.
+ */
+export declare function scoreKnowledgeFile(features: KnowledgeFeatures, weights: KnowledgeWeights): number;
+/**
+ * Derive human-readable reason codes from features.
+ */
+export declare function deriveKnowledgeReasons(features: KnowledgeFeatures, _intentTokens: string[]): string[];
+/**
+ * Score all candidates and return sorted results.
+ */
+export declare function scoreAllKnowledgeCandidates(candidates: WorkspaceFileInfo[], intentTokens: string[], tokenWeights: Map<string, number>, anchorFolders: string[], weights: KnowledgeWeights, nowMs: number): KnowledgeScoredFile[];
+//# sourceMappingURL=knowledge-scorer.d.ts.map

package/dist/knowledge-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-scorer.d.ts","sourceRoot":"","sources":["../src/knowledge-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAE3B,iEAAiE;AACjE,eAAO,MAAM,yBAAyB,EAAE,gBASvC,CAAC;AAiCF;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,iBAAiB,EACvB,YAAY,EAAE,MAAM,EAAE,EACtB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,aAAa,EAAE,MAAM,EAAE,EACvB,KAAK,EAAE,MAAM,GACZ,iBAAiB,CA4HnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAWR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,MAAM,EAAE,GACtB,MAAM,EAAE,CA8BV;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,YAAY,EAAE,MAAM,EAAE,EACtB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,aAAa,EAAE,MAAM,EAAE,EACvB,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,MAAM,GACZ,mBAAmB,EAAE,CAoBvB"}

package/dist/knowledge-scorer.js

@@ -0,0 +1,234 @@
+/**
+ * Knowledge-mode scorer — deterministic scoring for non-code workspace files.
+ *
+ * 7 weighted signals:
+ *   keyword_match      — IDF-weighted keyword match in content
+ *   filename_match     — Keyword match against filename stems
+ *   path_match         — Keyword match against folder path segments
+ *   recency            — mtime exponential decay
+ *   size_penalty       — Penalize large files
+ *   doc_type_prior     — Extension weighting (.md > .txt > .json > others)
+ *   folder_proximity   — Shared path segment scoring with intent-inferred anchors
+ *   markdown_header_boost — Regex ^# headers matching keywords in first N lines
+ */
+/** Default knowledge-mode weights (match spec signal_weights) */
+export const DEFAULT_KNOWLEDGE_WEIGHTS = {
+    keyword_match: 0.22,
+    filename_match: 0.14,
+    path_match: 0.10,
+    recency: 0.16,
+    size_penalty: 0.06,
+    doc_type_prior: 0.10,
+    folder_proximity: 0.14,
+    markdown_header_boost: 0.08,
+};
+/** Document type priors: higher = more likely to be useful knowledge content */
+const DOC_TYPE_PRIORS = {
+    '.md': 1.0,
+    '.txt': 0.7,
+    '.json': 0.5,
+    '.yaml': 0.5,
+    '.yml': 0.5,
+    // Unsupported but present — metadata only
+    '.csv': 0.2,
+    '.xlsx': 0.1,
+    '.pdf': 0.1,
+    '.docx': 0.1,
+};
+/** Folder names that indicate high-value knowledge content */
+const KNOWLEDGE_FOLDER_PRIORS = {
+    docs: 0.9,
+    spec: 0.9,
+    specifications: 0.9,
+    proposals: 0.8,
+    design: 0.8,
+    meetings: 0.7,
+    notes: 0.6,
+    product: 0.8,
+    reports: 0.7,
+    plans: 0.8,
+    planning: 0.8,
+    research: 0.7,
+    analysis: 0.7,
+};
+/**
+ * Compute knowledge-mode features for a single file.
+ */
+export function computeKnowledgeFeatures(file, intentTokens, tokenWeights, anchorFolders, nowMs) {
+    const pathLower = file.path.toLowerCase();
+    const pathSegments = pathLower.split('/');
+    const basename = pathSegments[pathSegments.length - 1]?.replace(/\.\w+$/, '') ?? '';
+    const filenameStems = basename.split(/[-_]/);
+    const contentKws = file.content_keywords ?? [];
+    // 1. keyword_match — IDF-weighted match against content keywords
+    let kwScore = 0;
+    let maxPossible = 0;
+    for (const token of intentTokens) {
+        const w = tokenWeights.get(token) ?? 1;
+        if (w === 0)
+            continue;
+        maxPossible += w;
+        if (contentKws.some((ck) => ck === token || ck === token + 's' || token === ck + 's')) {
+            kwScore += w;
+        }
+    }
+    const keyword_match = maxPossible > 0 ? Math.min(1, kwScore / maxPossible) : 0;
+    // 2. filename_match — keyword match against filename stems
+    let fnScore = 0;
+    let fnMax = 0;
+    for (const token of intentTokens) {
+        const w = tokenWeights.get(token) ?? 1;
+        if (w === 0)
+            continue;
+        fnMax += w;
+        const isStemMatch = filenameStems.some((stem) => stem === token || stem === token + 's' || token === stem + 's');
+        if (isStemMatch) {
+            fnScore += w * 2.0; // 2x for filename stem exact match
+        }
+    }
+    const filename_match = fnMax > 0 ? Math.min(1, fnScore / fnMax) : 0;
+    // 3. path_match — keyword match against folder path segments
+    let pathScore = 0;
+    let pathMax = 0;
+    for (const token of intentTokens) {
+        const w = tokenWeights.get(token) ?? 1;
+        if (w === 0)
+            continue;
+        pathMax += w;
+        if (pathLower.includes(token)) {
+            pathScore += w;
+        }
+    }
+    const path_match = pathMax > 0 ? Math.min(1, pathScore / pathMax) : 0;
+    // 4. recency — exponential decay based on mtime
+    const mtimeMs = new Date(file.mtime).getTime();
+    const daysSince = Math.max(0, (nowMs - mtimeMs) / (1000 * 60 * 60 * 24));
+    const recency = daysSince <= 1 ? 1.0
+        : daysSince <= 3 ? 0.9
+            : daysSince <= 7 ? 0.8
+                : daysSince <= 14 ? 0.6
+                    : daysSince <= 30 ? 0.4
+                        : daysSince <= 60 ? 0.2
+                            : 0.1;
+    // 5. size_penalty — penalize very large files
+    const size_penalty = Math.max(0, Math.min(1, file.size_bytes / (500 * 1024)));
+    // 6. doc_type_prior — extension-based document type weighting
+    const doc_type_prior = DOC_TYPE_PRIORS[file.extension.toLowerCase()] ?? 0.05;
+    // 7. folder_proximity — shared path segments with anchor folders
+    let folder_proximity = 0;
+    if (anchorFolders.length > 0) {
+        const fileDir = pathSegments.slice(0, -1).join('/');
+        for (const anchor of anchorFolders) {
+            if (fileDir === anchor || fileDir.startsWith(anchor + '/')) {
+                folder_proximity = 1.0;
+                break;
+            }
+            // Partial match: count shared segments
+            const anchorParts = anchor.split('/');
+            const fileDirParts = fileDir.split('/');
+            let shared = 0;
+            for (let i = 0; i < Math.min(anchorParts.length, fileDirParts.length); i++) {
+                if (anchorParts[i] === fileDirParts[i])
+                    shared++;
+                else
+                    break;
+            }
+            const proximity = anchorParts.length > 0 ? shared / anchorParts.length : 0;
+            folder_proximity = Math.max(folder_proximity, proximity);
+        }
+    }
+    else {
+        // No anchors: use knowledge folder priors
+        for (const seg of pathSegments.slice(0, -1)) {
+            const prior = KNOWLEDGE_FOLDER_PRIORS[seg];
+            if (prior !== undefined) {
+                folder_proximity = Math.max(folder_proximity, prior);
+            }
+        }
+    }
+    // 8. markdown_header_boost — boost for markdown files with keyword-matching headers
+    let markdown_header_boost = 0;
+    if (file.type === 'markdown' && file.markdown_headers) {
+        const headersLower = file.markdown_headers.map((h) => h.toLowerCase());
+        let headerHits = 0;
+        for (const token of intentTokens) {
+            if (headersLower.some((h) => h.includes(token))) {
+                headerHits++;
+            }
+        }
+        markdown_header_boost = intentTokens.length > 0
+            ? Math.min(1, headerHits / intentTokens.length)
+            : 0;
+    }
+    return {
+        keyword_match,
+        filename_match,
+        path_match,
+        recency,
+        size_penalty,
+        doc_type_prior,
+        folder_proximity,
+        markdown_header_boost,
+    };
+}
+/**
+ * Score a file using weighted sum of knowledge features.
+ */
+export function scoreKnowledgeFile(features, weights) {
+    return (features.keyword_match * weights.keyword_match +
+        features.filename_match * weights.filename_match +
+        features.path_match * weights.path_match +
+        features.recency * weights.recency -
+        features.size_penalty * weights.size_penalty +
+        features.doc_type_prior * weights.doc_type_prior +
+        features.folder_proximity * weights.folder_proximity +
+        features.markdown_header_boost * weights.markdown_header_boost);
+}
+/**
+ * Derive human-readable reason codes from features.
+ */
+export function deriveKnowledgeReasons(features, _intentTokens) {
+    const reasons = [];
+    if (features.keyword_match > 0) {
+        // Find which tokens matched for specificity
+        reasons.push('keyword_match');
+    }
+    if (features.filename_match > 0) {
+        reasons.push('filename_match');
+    }
+    if (features.path_match > 0 && features.filename_match === 0) {
+        reasons.push('path_match');
+    }
+    if (features.recency >= 0.8) {
+        reasons.push('recency_high');
+    }
+    if (features.doc_type_prior >= 0.5) {
+        reasons.push(`doc_type_prior:${features.doc_type_prior >= 1.0 ? 'md' : 'text'}`);
+    }
+    if (features.folder_proximity >= 0.5) {
+        reasons.push('folder_proximity');
+    }
+    if (features.markdown_header_boost > 0) {
+        reasons.push('markdown_header_boost');
+    }
+    if (features.size_penalty > 0.5) {
+        reasons.push('size_penalty');
+    }
+    return reasons;
+}
+/**
+ * Score all candidates and return sorted results.
+ */
+export function scoreAllKnowledgeCandidates(candidates, intentTokens, tokenWeights, anchorFolders, weights, nowMs) {
+    const results = [];
+    for (const file of candidates) {
+        const features = computeKnowledgeFeatures(file, intentTokens, tokenWeights, anchorFolders, nowMs);
+        const score = scoreKnowledgeFile(features, weights);
+        const reasons = deriveKnowledgeReasons(features, intentTokens);
+        results.push({ path: file.path, score, features, reasons });
+    }
+    // Sort descending by score (deterministic: stable sort by path as tiebreaker)
+    results.sort((a, b) => b.score - a.score || a.path.localeCompare(b.path));
+    return results;
+}
+//# sourceMappingURL=knowledge-scorer.js.map

package/dist/knowledge-scorer.js.map

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