@codeledger/selector 0.2.0 → 0.5.0

package/dist/intent/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/intent/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,OAAO,CAAC;SACL,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,+DAA+D;SACnF,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,gDAAgD;SACxE,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,0DAA0D;SACrF,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,oBAAoB;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,EAAY;IAClC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/intent/types.d.ts

@@ -0,0 +1,37 @@
+import type { AddressedFile, BundleInvalidationReport } from '@codeledger/types';
+/** Structured, normalized representation of the session's objective */
+export interface TaskContractV1 {
+    version: 1;
+    objective: string;
+    deliverable: string | null;
+    scope_in: string[];
+    scope_out: string[];
+    constraints: string[];
+    acceptance_criteria: string[];
+    risk_flags: string[];
+    repo_paths_in_scope: string[];
+    timestamp: string;
+}
+export type DriftLevel = 'NONE' | 'MINOR' | 'MAJOR' | 'CRITICAL';
+export interface DriftReason {
+    field: keyof Omit<TaskContractV1, 'version' | 'timestamp'>;
+    distance: number;
+}
+export interface DriftResult {
+    drift_score: number;
+    drift_level: DriftLevel;
+    reasons: DriftReason[];
+}
+/** Event record written to intent_drift.jsonl */
+export interface IntentDriftEvent {
+    ts: string;
+    type: 'INTENT_DRIFT';
+    baseline_hash: string;
+    current_hash: string;
+    drift_score: number;
+    drift_level: DriftLevel;
+    reasons: DriftReason[];
+    recommended_action: 'NONE' | 'LOG_ONLY' | 'REFRESH_BUNDLE' | 'REQUIRE_ACK';
+}
+export type { AddressedFile, BundleInvalidationReport, };
+//# sourceMappingURL=types.d.ts.map

package/dist/intent/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/intent/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAIjF,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,WAAW,CAAC,CAAC;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,kBAAkB,EAAE,MAAM,GAAG,UAAU,GAAG,gBAAgB,GAAG,aAAa,CAAC;CAC5E;AAGD,YAAY,EACV,aAAa,EACb,wBAAwB,GACzB,CAAC"}

package/dist/intent/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/intent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/intent/types.ts"],"names":[],"mappings":""}

package/dist/knowledge-bundle.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Knowledge-mode bundle builder.
+ *
+ * Produces a CoworkBundle (context-bundle.json schema) using:
+ *   - Knowledge-mode candidate generation
+ *   - Knowledge-mode scoring (7 signals)
+ *   - Existing stop-rule logic (reused)
+ *   - Knowledge-mode excerpt extraction (head+headers)
+ */
+import type { CoworkBundle, KnowledgeScoredFile, KnowledgeWeights, WorkspaceIndex } from '@codeledger/types';
+export interface KnowledgeBundleOptions {
+    intentText: string;
+    workspaceIndex: WorkspaceIndex;
+    weights?: KnowledgeWeights;
+    maxFiles?: number;
+    maxTokensEst?: number;
+    maxBytesEst?: number;
+    sufficiencyThreshold?: number;
+    excerptMaxLines?: number;
+    excerptMaxBytes?: number;
+}
+export declare function buildKnowledgeBundle(opts: KnowledgeBundleOptions): CoworkBundle;
+/**
+ * Build trace artifact from scored results.
+ */
+export declare function buildKnowledgeTrace(scored: KnowledgeScoredFile[], weights: KnowledgeWeights, sufficiencyThreshold: number, terminatedAtRank: number, runId: string): {
+    run_id: string;
+    timestamp: string;
+    scoring_profile: 'knowledge';
+    signals: KnowledgeWeights;
+    stop_rule: {
+        sufficiency_threshold: number;
+        reached_at_rank: number;
+    };
+    ranked_top: Array<{
+        path: string;
+        score: number;
+        evidence: string[];
+    }>;
+};
+//# sourceMappingURL=knowledge-bundle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-bundle.d.ts","sourceRoot":"","sources":["../src/knowledge-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,YAAY,EAMZ,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAa3B,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,sBAAsB,GAAG,YAAY,CAyN/E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,EAAE,EAC7B,OAAO,EAAE,gBAAgB,EACzB,oBAAoB,EAAE,MAAM,EAC5B,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,MAAM,GACZ;IACD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,WAAW,CAAC;IAC7B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE;QAAE,qBAAqB,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACxE,CAgBA"}

package/dist/knowledge-bundle.js

@@ -0,0 +1,200 @@
+/**
+ * Knowledge-mode bundle builder.
+ *
+ * Produces a CoworkBundle (context-bundle.json schema) using:
+ *   - Knowledge-mode candidate generation
+ *   - Knowledge-mode scoring (7 signals)
+ *   - Existing stop-rule logic (reused)
+ *   - Knowledge-mode excerpt extraction (head+headers)
+ */
+import { createHash, randomUUID } from 'node:crypto';
+import { tokenizeIntent, computeKnowledgeTokenWeights, inferAnchorFolders, generateKnowledgeCandidates, } from './knowledge-candidates.js';
+import { scoreAllKnowledgeCandidates, DEFAULT_KNOWLEDGE_WEIGHTS, } from './knowledge-scorer.js';
+import { extractKnowledgeExcerpt } from './knowledge-excerpt.js';
+export function buildKnowledgeBundle(opts) {
+    const { intentText, workspaceIndex, weights = DEFAULT_KNOWLEDGE_WEIGHTS, maxFiles = 20, maxTokensEst = 12000, maxBytesEst = 350000, sufficiencyThreshold = 0.78, excerptMaxLines = 450, excerptMaxBytes = 24000, } = opts;
+    const nowMs = Date.now();
+    const runId = `run_${new Date().toISOString().replace(/[:.]/g, '-')}_${randomUUID().slice(0, 8)}`;
+    // Step 1: Tokenize intent
+    const intentTokens = tokenizeIntent(intentText);
+    const normalizedIntent = intentText.toLowerCase().trim();
+    // Step 2: Compute token weights
+    const tokenWeights = computeKnowledgeTokenWeights(intentTokens, workspaceIndex.files);
+    // Step 3: Infer anchor folders
+    const anchorFolders = inferAnchorFolders(intentTokens, workspaceIndex.files);
+    // Step 4: Generate candidates
+    const candidates = generateKnowledgeCandidates(workspaceIndex.files, intentTokens, tokenWeights);
+    // Step 5: Score all candidates
+    const scored = scoreAllKnowledgeCandidates(candidates, intentTokens, tokenWeights, anchorFolders, weights, nowMs);
+    // Step 6: Select with stop rule
+    const maxCumulative = scored.reduce((sum, f) => sum + Math.max(0, f.score), 0);
+    const selected = [];
+    let totalTokens = 0;
+    let totalBytes = 0;
+    let cumulativeScore = 0;
+    let terminationReason = 'threshold_reached';
+    let terminatedAtRank = 0;
+    let excludedDueToBudget = 0;
+    let excludedLowScore = 0;
+    // Build file info map for quick lookup
+    const fileMap = new Map(workspaceIndex.files.map((f) => [f.path, f]));
+    for (let rank = 0; rank < scored.length; rank++) {
+        const scoredFile = scored[rank];
+        const fileInfo = fileMap.get(scoredFile.path);
+        if (!fileInfo)
+            continue;
+        // Check stop conditions
+        if (selected.length >= maxFiles) {
+            terminationReason = 'max_files';
+            terminatedAtRank = rank;
+            excludedDueToBudget += scored.length - rank;
+            break;
+        }
+        if (totalTokens >= maxTokensEst) {
+            terminationReason = 'max_tokens';
+            terminatedAtRank = rank;
+            excludedDueToBudget += scored.length - rank;
+            break;
+        }
+        if (totalBytes >= maxBytesEst) {
+            terminationReason = 'max_bytes';
+            terminatedAtRank = rank;
+            excludedDueToBudget += scored.length - rank;
+            break;
+        }
+        // Sufficiency threshold check
+        if (maxCumulative > 0 && selected.length > 0) {
+            const ratio = cumulativeScore / maxCumulative;
+            if (ratio >= sufficiencyThreshold) {
+                terminationReason = 'threshold_reached';
+                terminatedAtRank = rank;
+                excludedDueToBudget += scored.length - rank;
+                break;
+            }
+        }
+        // Extract excerpt
+        const excerpt = extractKnowledgeExcerpt(workspaceIndex.root, scoredFile.path, intentTokens, excerptMaxLines, excerptMaxBytes);
+        // Estimate tokens (5 tokens/line for natural language)
+        const tokenEst = Math.ceil(excerpt.lines_est * 5);
+        // Check if adding would blow budget (with 10% overshoot allowance)
+        if (totalTokens + tokenEst > maxTokensEst * 1.1 && selected.length > 0) {
+            excludedDueToBudget++;
+            continue;
+        }
+        // Build excerpt ref path
+        const excerptRef = `.codeledger/excerpts/${scoredFile.path.replace(/\//g, '__').replace(/\./g, '__')}.txt`;
+        const contentHash = createHash('md5')
+            .update(excerpt.content)
+            .digest('hex')
+            .slice(0, 12);
+        const selectedFile = {
+            path: scoredFile.path,
+            type: fileInfo.type,
+            score: Math.round(scoredFile.score * 1000) / 1000,
+            reasons: scoredFile.reasons,
+            signals: scoredFile.features,
+            size_bytes: fileInfo.size_bytes,
+            mtime: fileInfo.mtime,
+            hash: `h_${contentHash}`,
+            excerpt: {
+                ref: excerptRef,
+                bytes_est: excerpt.bytes_est,
+                lines_est: excerpt.lines_est,
+            },
+        };
+        selected.push(selectedFile);
+        totalTokens += tokenEst;
+        totalBytes += excerpt.bytes_est;
+        cumulativeScore += Math.max(0, scoredFile.score);
+        terminatedAtRank = rank + 1;
+    }
+    // Count low-score excluded files (score <= 0)
+    excludedLowScore = scored.filter((f) => f.score <= 0).length;
+    // Determine excerpt strategy used
+    const hasMarkdown = selected.some((f) => f.type === 'markdown');
+    const excerptStrategy = hasMarkdown
+        ? 'head+headers'
+        : intentTokens.length > 0
+            ? 'head+keyword_windows'
+            : 'head';
+    const budgets = {
+        max_files: maxFiles,
+        max_tokens_est: maxTokensEst,
+        max_bytes_est: maxBytesEst,
+    };
+    const stopRule = {
+        sufficiency_threshold: sufficiencyThreshold,
+        termination_reason: terminationReason,
+        terminated_at_rank: terminatedAtRank,
+        cumulative_score: Math.round(cumulativeScore * 1000) / 1000,
+    };
+    const SIGNALS = [
+        'keyword_match',
+        'filename_match',
+        'path_match',
+        'recency',
+        'size_penalty',
+        'doc_type_prior',
+        'folder_proximity',
+        'markdown_header_boost',
+    ];
+    return {
+        bundle_version: '1.0',
+        run_id: runId,
+        created_at: new Date().toISOString(),
+        mode: 'knowledge',
+        workspace: {
+            root: workspaceIndex.root,
+            fingerprint: workspaceIndex.fingerprint,
+            file_count: workspaceIndex.file_count,
+        },
+        intent: {
+            text: intentText,
+            normalized: normalizedIntent,
+            tokens: intentTokens,
+        },
+        budgets,
+        stop_rule: stopRule,
+        selection: {
+            signals: [...SIGNALS],
+            signal_weights: weights,
+            excerpt_policy: {
+                max_excerpt_bytes: excerptMaxBytes,
+                max_lines: excerptMaxLines,
+                strategy: excerptStrategy,
+            },
+        },
+        selected,
+        excluded_summary: {
+            total_seen: workspaceIndex.file_count,
+            excluded_low_score: excludedLowScore,
+            excluded_due_to_budget: excludedDueToBudget,
+        },
+        links: {
+            trace_path: '.codeledger/trace.json',
+            excerpts_dir: '.codeledger/excerpts/',
+            progress_snapshot_path: '.codeledger/progress-snapshot.json',
+        },
+    };
+}
+/**
+ * Build trace artifact from scored results.
+ */
+export function buildKnowledgeTrace(scored, weights, sufficiencyThreshold, terminatedAtRank, runId) {
+    return {
+        run_id: runId,
+        timestamp: new Date().toISOString(),
+        scoring_profile: 'knowledge',
+        signals: weights,
+        stop_rule: {
+            sufficiency_threshold: sufficiencyThreshold,
+            reached_at_rank: terminatedAtRank,
+        },
+        ranked_top: scored.slice(0, 30).map((f) => ({
+            path: f.path,
+            score: Math.round(f.score * 1000) / 1000,
+            evidence: f.reasons,
+        })),
+    };
+}
+//# sourceMappingURL=knowledge-bundle.js.map

package/dist/knowledge-bundle.js.map

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

package/dist/knowledge-candidates.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ */
+import type { WorkspaceFileInfo } from '@codeledger/types';
+/**
+ * Tokenize intent text into keywords (stop-word filtered).
+ */
+export declare function tokenizeIntent(text: string): string[];
+/**
+ * Compute IDF-like token weights based on file match frequency.
+ */
+export declare function computeKnowledgeTokenWeights(tokens: string[], files: WorkspaceFileInfo[]): Map<string, number>;
+/**
+ * Infer "anchor" folders from intent tokens.
+ * If a token matches a top-level folder name, that folder is an anchor.
+ */
+export declare function inferAnchorFolders(tokens: string[], files: WorkspaceFileInfo[]): string[];
+/**
+ * Generate knowledge-mode candidates.
+ * All files are candidates (scored by the knowledge scorer), but only
+ * supported file types get full content analysis.
+ */
+export declare function generateKnowledgeCandidates(files: WorkspaceFileInfo[], intentTokens: string[], tokenWeights: Map<string, number>): WorkspaceFileInfo[];
+//# sourceMappingURL=knowledge-candidates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-candidates.d.ts","sourceRoot":"","sources":["../src/knowledge-candidates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAkB3D;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMrD;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,iBAAiB,EAAE,GACzB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA6BrB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,iBAAiB,EAAE,GACzB,MAAM,EAAE,CAuBV;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,iBAAiB,EAAE,EAC1B,YAAY,EAAE,MAAM,EAAE,EACtB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,iBAAiB,EAAE,CAgCrB"}

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"}