@ai-agent-context/core 0.1.0

package/dist/core/scanner/scanner.js

@@ -0,0 +1,304 @@
+import { PatternSet } from "../../util/glob.js";
+import { compareStrings, sha256 } from "../../model/canonical.js";
+import { basename, extname } from "../../util/paths.js";
+import { mapWithConcurrency, defaultConcurrency } from "../../util/concurrency.js";
+import { FileSystemAdapter } from "../../adapters/filesystem/fs-adapter.js";
+import { SensitivePathFilter } from "../../adapters/filesystem/sensitive.js";
+import { LanguageRegistry, createDefaultRegistry } from "../../adapters/language/registry.js";
+import { fromSnapshot, toSnapshot } from "./types.js";
+const TEST_PATTERNS = [
+    /(^|\/)(tests?|__tests__|__mocks__|e2e)\//,
+    /\.(test|spec)\.[cm]?[jt]sx?$/,
+    /\.(test|spec)\.(md|json)$/,
+];
+const CONFIG_BASENAMES = new Set([
+    'tsconfig.json',
+    'jsconfig.json',
+    'package.json',
+    'pnpm-workspace.yaml',
+    'bunfig.toml',
+    'Dockerfile',
+    'Makefile',
+    '.editorconfig',
+    '.gitignore',
+    '.npmrc',
+]);
+const CONFIG_EXTENSIONS = new Set(['.json', '.yaml', '.yml', '.toml', '.ini', '.cfg', '.properties']);
+const DOC_EXTENSIONS = new Set(['.md', '.mdx', '.markdown', '.txt', '.rst']);
+const ASSET_EXTENSIONS = new Set([
+    '.css',
+    '.scss',
+    '.sass',
+    '.less',
+    '.svg',
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.gif',
+    '.webp',
+    '.ico',
+    '.woff',
+    '.woff2',
+    '.ttf',
+    '.eot',
+    '.mp4',
+    '.pdf',
+]);
+const SOURCE_EXTENSIONS = new Set(['.ts', '.tsx', '.mts', '.cts', '.js', '.jsx', '.mjs', '.cjs', '.vue', '.svelte']);
+/** Classifies a file, language agnostically. */
+export function classifyFile(path, signals = []) {
+    const normalized = path.replace(/\\/g, '/');
+    const name = basename(normalized);
+    const extension = extname(normalized).toLowerCase();
+    if (TEST_PATTERNS.some((pattern) => pattern.test(normalized)) || signals.includes('test:suite'))
+        return 'test';
+    if (DOC_EXTENSIONS.has(extension))
+        return 'docs';
+    if (CONFIG_BASENAMES.has(name) ||
+        CONFIG_EXTENSIONS.has(extension) ||
+        /\.config\.[cm]?[jt]s$/.test(name) ||
+        normalized.startsWith('.github/') ||
+        (name.startsWith('.') && name.length > 1)) {
+        return 'config';
+    }
+    if (ASSET_EXTENSIONS.has(extension))
+        return 'asset';
+    if (SOURCE_EXTENSIONS.has(extension))
+        return 'source';
+    return 'other';
+}
+function emptyChanges(incremental) {
+    return { added: [], modified: [], deleted: [], unchanged: [], incremental };
+}
+/** Builds the include/exclude/ignore pattern sets, merging the root .gitignore. */
+async function buildPatterns(config, fsAdapter) {
+    const include = new PatternSet(config.include.map((pattern) => (pattern.endsWith('/') ? `${pattern}**` : pattern)));
+    const exclude = new PatternSet(config.exclude);
+    const ignorePatterns = [...config.ignore];
+    const gitignore = await fsAdapter.tryReadText('.gitignore');
+    if (gitignore !== null) {
+        for (const line of gitignore.split('\n')) {
+            const trimmed = line.trim();
+            if (trimmed.length === 0 || trimmed.startsWith('#'))
+                continue;
+            if (!ignorePatterns.includes(trimmed))
+                ignorePatterns.push(trimmed);
+        }
+    }
+    return { include, exclude, ignore: new PatternSet(ignorePatterns) };
+}
+/**
+ * Scans a repository and returns file level facts plus the change set relative to
+ * the previous local state.
+ */
+export async function scanRepository(options) {
+    const { config, diagnostics } = options;
+    const registry = options.registry ?? createDefaultRegistry();
+    const fsAdapter = options.fsAdapter ?? new FileSystemAdapter(options.root);
+    const concurrency = config.analysis.concurrency > 0 ? config.analysis.concurrency : defaultConcurrency();
+    const sensitiveFilter = new SensitivePathFilter({
+        allowSensitiveFiles: config.security.allowSensitiveFiles,
+        extraSensitivePatterns: config.security.extraSensitivePatterns,
+    });
+    const patterns = await buildPatterns(config, fsAdapter);
+    options.progress?.({ phase: 'walk', message: 'Scanning repository...' });
+    const walked = await fsAdapter.walk({
+        include: patterns.include,
+        exclude: patterns.exclude,
+        ignore: patterns.ignore,
+        followSymlinks: config.analysis.followSymlinks,
+        onDirectory: (directory) => options.logger.verbose(`walk ${directory}/`),
+    });
+    const presentFiles = new Set(walked.map((file) => file.path));
+    const previous = options.state?.files ?? {};
+    const incremental = options.state !== null && options.state.configHash === options.configHash;
+    const changes = emptyChanges(incremental);
+    const entries = walked.map((file) => {
+        const record = previous[file.path];
+        const sensitive = sensitiveFilter.isBlocked(file.path);
+        const tooLarge = file.size > config.analysis.maxFileSizeBytes;
+        const fastUnchanged = record !== undefined && record.hash.length > 0 && record.size === file.size && record.mtimeMs === file.mtimeMs;
+        return {
+            walked: file,
+            previousHash: record?.hash ?? null,
+            fastUnchanged,
+            sensitive,
+            tooLarge,
+            hash: '',
+            parse: null,
+        };
+    });
+    const skippedSensitive = entries.filter((entry) => entry.sensitive).map((entry) => entry.walked.path);
+    const skippedLarge = entries.filter((entry) => !entry.sensitive && entry.tooLarge).map((entry) => entry.walked.path);
+    for (const path of skippedLarge) {
+        diagnostics.warn('WARN_FILE_TOO_LARGE', `skipped large file ${path}`, {
+            source: path,
+            hint: `size exceeds analysis.maxFileSizeBytes (${config.analysis.maxFileSizeBytes})`,
+        });
+    }
+    const work = entries.filter((entry) => !entry.sensitive && !entry.tooLarge);
+    const toRead = work.filter((entry) => !entry.fastUnchanged);
+    const toReuse = work.filter((entry) => entry.fastUnchanged);
+    let reused = 0;
+    let parsedNow = 0;
+    const cacheWrites = [];
+    options.progress?.({
+        phase: 'parse',
+        message: `Analyzing ${toRead.length} changed file(s)...`,
+        completed: 0,
+        total: toRead.length,
+    });
+    const parseWithCache = async (entry, contents, hash) => {
+        const snapshot = await options.cache.get(hash);
+        if (snapshot !== null) {
+            entry.parse = fromSnapshot(snapshot);
+            reused += 1;
+            return;
+        }
+        const parsed = registry.parseFile(entry.walked.path, contents, config.languages);
+        entry.parse = parsed;
+        parsedNow += 1;
+        for (const diagnostic of parsed.diagnostics) {
+            diagnostics.add(diagnostic.source === undefined ? { ...diagnostic, source: entry.walked.path } : diagnostic);
+        }
+        cacheWrites.push(() => options.cache.put(hash, toSnapshot(parsed)));
+    };
+    let processed = 0;
+    await mapWithConcurrency(toRead, concurrency, async (entry) => {
+        try {
+            const contents = await fsAdapter.readText(entry.walked.path);
+            entry.hash = sha256(contents);
+            await parseWithCache(entry, contents, entry.hash);
+        }
+        catch (error) {
+            diagnostics.warn('WARN_FILE_UNREADABLE', `failed to read ${entry.walked.path}`, {
+                source: entry.walked.path,
+                hint: error instanceof Error ? error.message : String(error),
+            });
+        }
+        processed += 1;
+        options.progress?.({
+            phase: 'parse',
+            message: `Analyzing ${toRead.length} changed file(s)...`,
+            completed: processed,
+            total: toRead.length,
+        });
+    });
+    await mapWithConcurrency(toReuse, concurrency, async (entry) => {
+        entry.hash = entry.previousHash ?? '';
+        const snapshot = entry.hash.length > 0 ? await options.cache.get(entry.hash) : null;
+        if (snapshot !== null) {
+            entry.parse = fromSnapshot(snapshot);
+            reused += 1;
+            return;
+        }
+        // Cache miss (fresh checkout or cleared cache): fall back to reading the file.
+        try {
+            const contents = await fsAdapter.readText(entry.walked.path);
+            if (entry.hash.length === 0)
+                entry.hash = sha256(contents);
+            await parseWithCache(entry, contents, entry.hash);
+        }
+        catch (error) {
+            diagnostics.warn('WARN_FILE_UNREADABLE', `failed to read ${entry.walked.path}`, {
+                source: entry.walked.path,
+                hint: error instanceof Error ? error.message : String(error),
+            });
+        }
+    });
+    for (const write of cacheWrites) {
+        try {
+            await write();
+        }
+        catch (error) {
+            diagnostics.warn('WARN_CACHE_WRITE', error instanceof Error ? error.message : String(error));
+        }
+    }
+    // Change classification happens after hashing, so an mtime-only touch of an
+    // unchanged file is still reported as "unchanged".
+    for (const entry of entries) {
+        const path = entry.walked.path;
+        if (entry.previousHash === null) {
+            changes.added.push(path);
+            continue;
+        }
+        const hashMatches = entry.hash.length > 0 && entry.hash === entry.previousHash;
+        if (hashMatches || entry.sensitive || entry.tooLarge || entry.fastUnchanged)
+            changes.unchanged.push(path);
+        else
+            changes.modified.push(path);
+    }
+    for (const path of Object.keys(previous)) {
+        if (!presentFiles.has(path))
+            changes.deleted.push(path);
+    }
+    changes.added.sort(compareStrings);
+    changes.modified.sort(compareStrings);
+    changes.deleted.sort(compareStrings);
+    changes.unchanged.sort(compareStrings);
+    const parsedMap = new Map();
+    const failed = [];
+    const partial = [];
+    const files = [];
+    for (const entry of entries) {
+        const path = entry.walked.path;
+        if (entry.sensitive) {
+            files.push({
+                path,
+                hash: '',
+                size: entry.walked.size,
+                mtimeMs: entry.walked.mtimeMs,
+                language: 'unknown',
+                kind: 'other',
+                moduleId: null,
+                packageName: null,
+                symbolIds: [],
+                importSpecifiers: [],
+                signals: ['skipped:sensitive'],
+                sensitive: true,
+                parseStatus: 'skipped',
+            });
+            continue;
+        }
+        if (entry.parse !== null)
+            parsedMap.set(path, entry.parse);
+        const parseStatus = entry.parse?.parseStatus ?? 'skipped';
+        if (parseStatus === 'failed')
+            failed.push(path);
+        if (parseStatus === 'partial')
+            partial.push(path);
+        files.push({
+            path,
+            hash: entry.hash,
+            size: entry.walked.size,
+            mtimeMs: entry.walked.mtimeMs,
+            language: entry.parse?.language ?? 'unknown',
+            kind: classifyFile(path, entry.parse?.signals ?? []),
+            moduleId: null,
+            packageName: null,
+            symbolIds: [],
+            importSpecifiers: entry.parse === null
+                ? []
+                : [...new Set(entry.parse.imports.map((record) => record.specifier))].sort(compareStrings),
+            signals: entry.parse?.signals ?? [],
+            sensitive: false,
+            parseStatus,
+        });
+    }
+    files.sort((a, b) => compareStrings(a.path, b.path));
+    options.progress?.({ phase: 'done', message: `Analyzed ${files.length} file(s)` });
+    return {
+        files,
+        parsed: parsedMap,
+        changes,
+        parsedNow,
+        reused,
+        skippedSensitive: skippedSensitive.sort(compareStrings),
+        skippedLarge: skippedLarge.sort(compareStrings),
+        failed: failed.sort(compareStrings),
+        partial: partial.sort(compareStrings),
+        presentFiles,
+        pnpmWorkspaceYaml: await fsAdapter.tryReadText('pnpm-workspace.yaml'),
+    };
+}
+//# sourceMappingURL=scanner.js.map

package/dist/core/scanner/scanner.js.map

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

package/dist/core/scanner/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Scanner level types.
+ *
+ * `ParsedFileSnapshot` is a serializable subset of the adapter output: only the
+ * facts that survive a cache round-trip are kept, which keeps the local cache
+ * small even for repositories with 100k+ files.
+ */
+import type { FileKind, ParseStatus } from '../../model/types.ts';
+import type { CallRecord, ExportRecord, ImportRecord, ParsedFile, RouteRecord, SymbolRecord } from '../../adapters/language/types.ts';
+export type { FileKind };
+/** Serializable parse result stored in the content-addressed cache. */
+export interface ParsedFileSnapshot {
+    path: string;
+    language: string;
+    parseStatus: ParseStatus;
+    imports: ImportRecord[];
+    exports: ExportRecord[];
+    symbols: SymbolRecord[];
+    calls: CallRecord[];
+    routes: RouteRecord[];
+    signals: string[];
+    metadata: Record<string, unknown>;
+}
+export declare function toSnapshot(parsed: ParsedFile): ParsedFileSnapshot;
+export declare function fromSnapshot(snapshot: ParsedFileSnapshot): ParsedFile;
+export interface ScannerFileResult {
+    path: string;
+    hash: string;
+    size: number;
+    mtimeMs: number;
+    language: string;
+    kind: FileKind;
+    /** `true` when the file matched a sensitive pattern and was never read. */
+    sensitive: boolean;
+    /** `true` when contents were parsed during this scan. */
+    parsedNow: boolean;
+    skippedReason: string | null;
+}
+export interface ScannerDiagnosticList {
+    path: string;
+    messages: Array<{
+        code: string;
+        message: string;
+        hint?: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/scanner/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/scanner/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACb,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,kBAAkB,CAajE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,kBAAkB,GAAG,UAAU,CAErE;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,2EAA2E;IAC3E,SAAS,EAAE,OAAO,CAAC;IACnB,yDAAyD;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE"}

package/dist/core/scanner/types.js

@@ -0,0 +1,18 @@
+export function toSnapshot(parsed) {
+    return {
+        path: parsed.path,
+        language: parsed.language,
+        parseStatus: parsed.parseStatus,
+        imports: parsed.imports,
+        exports: parsed.exports,
+        symbols: parsed.symbols,
+        calls: parsed.calls,
+        routes: parsed.routes,
+        signals: parsed.signals,
+        metadata: parsed.metadata,
+    };
+}
+export function fromSnapshot(snapshot) {
+    return { ...snapshot, diagnostics: [] };
+}
+//# sourceMappingURL=types.js.map

package/dist/core/scanner/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/scanner/types.ts"],"names":[],"mappings":"AAiCA,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAA4B;IACvD,OAAO,EAAE,GAAG,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;AAC1C,CAAC"}

package/dist/core/search/analyzer.d.ts

@@ -0,0 +1,16 @@
+/** Domain synonyms: query term → additional index terms. */
+export declare const SYNONYMS: Record<string, string[]>;
+/**
+ * Light stemmer: handles the plural/gerund/past forms that dominate code
+ * identifiers and prose, and leaves anything else untouched.
+ */
+export declare function stem(term: string): string;
+/** Extracts normalized, deduplicated terms from arbitrary text. */
+export declare function analyze(text: string, options?: {
+    keepStopWords?: boolean;
+}): string[];
+/** Expands query terms with synonyms, keeping the original terms. */
+export declare function expandQueryTerms(terms: readonly string[]): Map<string, number>;
+/** Path segments of a repository-relative path, for identifier boosting. */
+export declare function pathSegments(path: string): string[];
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/core/search/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../../src/core/search/analyzer.ts"],"names":[],"mappings":"AAmDA,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CA0C7C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkBzC;AAED,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,EAAE,CAezF;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAc9E;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKnD"}

package/dist/core/search/analyzer.js

@@ -0,0 +1,165 @@
+/**
+ * Text analysis for search.
+ *
+ * Deterministic and language-agnostic-but-identifier-aware: code identifiers are
+ * split (`refundPayment` → `refund payment`), light English stemming is applied to
+ * both the index and the query, and a small synonym map lets an agent ask
+ * "payment idempotency" and still find `PaymentMustBeIdempotentError`.
+ */
+import { splitIdentifier } from "../../util/text.js";
+const STOP_WORDS = new Set([
+    'a',
+    'an',
+    'and',
+    'are',
+    'as',
+    'at',
+    'be',
+    'but',
+    'by',
+    'for',
+    'from',
+    'how',
+    'in',
+    'into',
+    'is',
+    'it',
+    'its',
+    'of',
+    'on',
+    'or',
+    'that',
+    'the',
+    'their',
+    'then',
+    'there',
+    'these',
+    'this',
+    'to',
+    'was',
+    'were',
+    'what',
+    'when',
+    'where',
+    'which',
+    'who',
+    'why',
+    'will',
+    'with',
+]);
+/** Domain synonyms: query term → additional index terms. */
+export const SYNONYMS = {
+    auth: ['authentication', 'authorization', 'login', 'token'],
+    authentication: ['auth', 'login', 'token'],
+    authorization: ['auth', 'permission', 'policy', 'acl'],
+    payment: ['payments', 'billing', 'charge', 'invoice', 'stripe', 'checkout'],
+    payments: ['payment', 'billing', 'charge', 'invoice', 'stripe'],
+    billing: ['payment', 'invoice', 'subscription'],
+    user: ['users', 'account', 'profile', 'identity'],
+    users: ['user', 'account', 'identity'],
+    db: ['database', 'repository', 'persistence', 'sql', 'query'],
+    database: ['db', 'repository', 'persistence', 'sql', 'migration'],
+    repository: ['db', 'database', 'persistence', 'store'],
+    api: ['endpoint', 'route', 'controller', 'http', 'rest'],
+    endpoint: ['api', 'route', 'controller'],
+    route: ['api', 'endpoint', 'router', 'controller'],
+    event: ['events', 'bus', 'publisher', 'subscriber', 'message', 'domain-event'],
+    events: ['event', 'bus', 'messaging', 'publisher'],
+    queue: ['job', 'worker', 'consumer', 'producer', 'broker'],
+    job: ['queue', 'worker', 'cron', 'scheduler'],
+    worker: ['job', 'queue', 'background'],
+    cache: ['caching', 'redis', 'memo'],
+    config: ['configuration', 'settings', 'env', 'environment'],
+    configuration: ['config', 'settings', 'env'],
+    error: ['errors', 'exception', 'failure'],
+    test: ['tests', 'spec', 'testing'],
+    tests: ['test', 'spec', 'suite'],
+    build: ['compile', 'bundler', 'toolchain'],
+    cli: ['command', 'bin', 'argument'],
+    log: ['logging', 'logger', 'telemetry'],
+    logging: ['log', 'logger'],
+    security: ['auth', 'secret', 'credential', 'permission'],
+    idempotent: ['idempotency', 'retry', 'duplicate'],
+    idempotency: ['idempotent', 'retry', 'duplicate'],
+    invariant: ['invariants', 'constraint', 'must', 'never'],
+    invariant_s: ['invariants', 'constraint'],
+    style: ['convention', 'format', 'lint'],
+    convention: ['conventions', 'style', 'rule', 'pattern'],
+    architecture: ['structure', 'layer', 'module', 'design'],
+    module: ['package', 'component', 'service'],
+    dependency: ['dependencies', 'import', 'requires'],
+    contract: ['interface', 'port', 'boundary'],
+    boundary: ['contract', 'interface', 'port'],
+};
+/**
+ * Light stemmer: handles the plural/gerund/past forms that dominate code
+ * identifiers and prose, and leaves anything else untouched.
+ */
+export function stem(term) {
+    if (term.length <= 3)
+        return term;
+    const rules = [
+        [/ies$/, 'y'],
+        [/(ss|us|is)es$/, '$1'],
+        [/([^s])s$/, '$1'],
+        [/ing$/, ''],
+        [/edly$/, ''],
+        [/ed$/, ''],
+        [/ally$/, 'al'],
+    ];
+    for (const [pattern, replacement] of rules) {
+        if (pattern.test(term)) {
+            const candidate = term.replace(pattern, replacement);
+            if (candidate.length >= 3)
+                return candidate;
+        }
+    }
+    return term;
+}
+/** Extracts normalized, deduplicated terms from arbitrary text. */
+export function analyze(text, options = {}) {
+    const terms = [];
+    const seen = new Set();
+    for (const word of splitIdentifier(text)) {
+        if (word.length < 2)
+            continue;
+        if (!options.keepStopWords && STOP_WORDS.has(word))
+            continue;
+        if (/^\d+$/.test(word))
+            continue;
+        const stemmed = stem(word);
+        for (const candidate of new Set([word, stemmed])) {
+            if (seen.has(candidate))
+                continue;
+            seen.add(candidate);
+            terms.push(candidate);
+        }
+    }
+    return terms;
+}
+/** Expands query terms with synonyms, keeping the original terms. */
+export function expandQueryTerms(terms) {
+    const weights = new Map();
+    const add = (term, weight) => {
+        weights.set(term, Math.max(weights.get(term) ?? 0, weight));
+    };
+    for (const term of terms) {
+        add(term, 1);
+        const synonyms = SYNONYMS[term] ?? SYNONYMS[stem(term)];
+        if (synonyms === undefined)
+            continue;
+        for (const synonym of synonyms) {
+            for (const expanded of analyze(synonym, { keepStopWords: true }))
+                add(expanded, 0.45);
+        }
+    }
+    return weights;
+}
+/** Path segments of a repository-relative path, for identifier boosting. */
+export function pathSegments(path) {
+    return path
+        .split('/')
+        .flatMap((segment) => splitIdentifier(segment))
+        .filter((segment) => segment.length > 1);
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/core/search/analyzer.js.map

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

package/dist/core/search/bm25.d.ts

@@ -0,0 +1,21 @@
+import type { RankedDocument, SearchBackend, SearchDocument, SearchQuery } from './types.ts';
+export interface Bm25Options {
+    k1?: number;
+    b?: number;
+    titleBoost?: number;
+    identifierBoost?: number;
+}
+export declare class Bm25Index implements SearchBackend {
+    readonly name = "bm25";
+    private readonly documents;
+    private readonly documentFrequency;
+    private readonly k1;
+    private readonly b;
+    private readonly titleBoost;
+    private readonly identifierBoost;
+    private averageLength;
+    constructor(documents: readonly SearchDocument[], options?: Bm25Options);
+    get size(): number;
+    query(query: SearchQuery): RankedDocument[];
+}
+//# sourceMappingURL=bm25.d.ts.map

package/dist/core/search/bm25.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25.d.ts","sourceRoot":"","sources":["../../../src/core/search/bm25.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAY7F,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,SAAU,YAAW,aAAa;IAC7C,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;IAC/D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,aAAa,CAAK;gBAEd,SAAS,EAAE,SAAS,cAAc,EAAE,EAAE,OAAO,GAAE,WAAgB;IAiC3E,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,EAAE;CAmD5C"}