@jafreck/lore 0.1.0

package/dist/indexer/extractors/zig.js

@@ -0,0 +1,95 @@
+/**
+ * @module indexer/extractors/zig
+ *
+ * Zig language extractor.  Extracts function declarations (fn), struct/enum/union
+ * declarations, and @import() calls.
+ */
+import { emptyResult, nodeSignature, walk, } from './types.js';
+// ─── ZigExtractor ─────────────────────────────────────────────────────────────
+export class ZigExtractor {
+    extract(tree, _source, _filePath) {
+        const result = emptyResult();
+        for (const node of walk(tree.rootNode)) {
+            switch (node.type) {
+                case 'FnProto':
+                    result.symbols.push(extractFn(node));
+                    break;
+                case 'TestDecl':
+                    result.symbols.push(extractTest(node));
+                    break;
+                case 'ContainerDecl':
+                    // struct/enum/union — try to find enclosing VarDecl for the name
+                    break;
+                case 'VarDecl': {
+                    const sym = extractVarDecl(node);
+                    if (sym)
+                        result.symbols.push(sym);
+                    break;
+                }
+                case 'BUILTIN': {
+                    if (node.text === '@import') {
+                        const imp = tryExtractImport(node);
+                        if (imp)
+                            result.imports.push(imp);
+                    }
+                    break;
+                }
+            }
+        }
+        return result;
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function extractFn(node) {
+    const nameNode = node.namedChildren.find(c => c.type === 'IDENTIFIER');
+    return {
+        name: nameNode?.text ?? '',
+        kind: 'function',
+        startLine: node.startPosition.row,
+        endLine: node.endPosition.row,
+        signature: nodeSignature(node),
+    };
+}
+function extractTest(node) {
+    // test "name" { ... }
+    const nameNode = node.namedChildren.find(c => c.type === 'STRINGLITERALSINGLE');
+    return {
+        name: nameNode?.text.replace(/^"|"$/g, '') ?? 'test',
+        kind: 'test',
+        startLine: node.startPosition.row,
+        endLine: node.endPosition.row,
+        signature: nodeSignature(node),
+    };
+}
+/**
+ * `const Foo = struct { ... }` or `pub const bar = ...`
+ * We extract top-level const/var declarations that have container bodies or
+ * are otherwise significant.
+ */
+function extractVarDecl(node) {
+    const nameNode = node.namedChildren.find(c => c.type === 'IDENTIFIER');
+    if (!nameNode)
+        return null;
+    // Check if this is a type definition (assigned a struct/enum/union)
+    const hasContainer = node.namedChildren.some(c => c.type === 'ContainerDecl' || c.type === 'ErrorSetDecl');
+    const kind = hasContainer ? 'type' : 'const';
+    return {
+        name: nameNode.text,
+        kind,
+        startLine: node.startPosition.row,
+        endLine: node.endPosition.row,
+        signature: nodeSignature(node),
+    };
+}
+function tryExtractImport(node) {
+    // @import("std") — the parent is typically a BuiltinCallExpr
+    const parent = node.parent;
+    if (!parent)
+        return null;
+    const argNode = parent.namedChildren.find(c => c.type === 'STRINGLITERALSINGLE');
+    if (!argNode)
+        return null;
+    const source = argNode.text.replace(/^"|"$/g, '');
+    return { source, importedNames: [] };
+}
+//# sourceMappingURL=zig.js.map

package/dist/indexer/extractors/zig.js.map

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

package/dist/indexer/git-history.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @module indexer/git-history
+ *
+ * Ingests git commit history into the `commits` and `commit_files` tables
+ * using simple-git to read commit metadata and per-file diff stats.
+ */
+import { type Database } from './db.js';
+export interface GitHistoryOptions {
+    depth?: number;
+    all?: boolean;
+}
+/**
+ * Reads commit history from the git repository at `repoRoot` and upserts each
+ * commit and its associated file changes into the `commits` and
+ * `commit_files` tables. By default, Lore traverses all refs (`--all`) with
+ * no depth limit; `options.depth` can be used to cap the number of ingested
+ * commits.
+ *
+ * The function is idempotent: rows are inserted with INSERT OR IGNORE so
+ * re-running it on the same repository will not produce duplicates.
+ */
+export declare function ingestGitHistory(db: Database.Database, repoRoot: string, options?: GitHistoryOptions): Promise<void>;
+//# sourceMappingURL=git-history.d.ts.map

package/dist/indexer/git-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-history.d.ts","sourceRoot":"","sources":["../../src/indexer/git-history.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAwB,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAKD;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAoJf"}

package/dist/indexer/git-history.js

@@ -0,0 +1,144 @@
+/**
+ * @module indexer/git-history
+ *
+ * Ingests git commit history into the `commits` and `commit_files` tables
+ * using simple-git to read commit metadata and per-file diff stats.
+ */
+import { simpleGit } from 'simple-git';
+import { getKbMeta, setKbMeta } from './db.js';
+const DEFAULT_ALL = true;
+const GIT_HISTORY_WATERMARK_KEY = 'git_history_last_ingested_sha';
+/**
+ * Reads commit history from the git repository at `repoRoot` and upserts each
+ * commit and its associated file changes into the `commits` and
+ * `commit_files` tables. By default, Lore traverses all refs (`--all`) with
+ * no depth limit; `options.depth` can be used to cap the number of ingested
+ * commits.
+ *
+ * The function is idempotent: rows are inserted with INSERT OR IGNORE so
+ * re-running it on the same repository will not produce duplicates.
+ */
+export async function ingestGitHistory(db, repoRoot, options) {
+    const all = options?.all ?? DEFAULT_ALL;
+    const depth = typeof options?.depth === 'number' && Number.isFinite(options.depth) && options.depth > 0
+        ? Math.floor(options.depth)
+        : undefined;
+    const git = simpleGit(repoRoot);
+    const storedWatermark = getKbMeta(db, GIT_HISTORY_WATERMARK_KEY);
+    let watermark;
+    if (storedWatermark) {
+        try {
+            await git.raw(['cat-file', '-e', `${storedWatermark}^{commit}`]);
+            watermark = storedWatermark;
+        }
+        catch {
+            watermark = undefined;
+        }
+    }
+    const logArgs = [
+        'log',
+        '--numstat',
+        '--format=COMMIT_SEP%n%H%n%an%n%ae%n%at%n%P%n%s',
+    ];
+    if (watermark) {
+        logArgs.push(`${watermark}..`);
+    }
+    if (all) {
+        logArgs.push('--all');
+    }
+    if (depth !== undefined) {
+        logArgs.push(`--max-count=${depth}`);
+    }
+    // Fetch log with numstat for diff stats.
+    // --numstat outputs insertion/deletion counts per file after each commit header.
+    const logResult = await git.raw(logArgs);
+    // Capture heads/tags that currently point to commits so branch/tag metadata
+    // is also available in the KB.
+    let refsRaw = '';
+    try {
+        refsRaw = await git.raw(['show-ref', '--heads', '--tags']);
+    }
+    catch {
+        refsRaw = '';
+    }
+    const insertCommit = db.prepare(`INSERT OR IGNORE INTO commits (sha, author, author_email, timestamp, message, parents)
+     VALUES (?, ?, ?, ?, ?, ?)`);
+    const insertCommitFile = db.prepare(`INSERT OR IGNORE INTO commit_files (commit_sha, file_path, change_type, insertions, deletions)
+     VALUES (?, ?, ?, ?, ?)`);
+    const insertCommitRef = db.prepare(`INSERT OR IGNORE INTO commit_refs (commit_sha, ref_name, ref_type)
+     SELECT ?, ?, ?
+     WHERE EXISTS (SELECT 1 FROM commits WHERE sha = ?)`);
+    const deleteCommitRefs = db.prepare('DELETE FROM commit_refs');
+    // Parse the raw git log output into commit blocks.
+    // Each block starts with "COMMIT_SEP" followed by commit metadata lines,
+    // then an empty line, then numstat lines (insertions<TAB>deletions<TAB>path).
+    const blocks = logResult.split('COMMIT_SEP\n').filter((b) => b.trim().length > 0);
+    const latestShaInRun = blocks[0]?.split('\n')[0]?.trim();
+    db.transaction(() => {
+        for (const block of blocks) {
+            const lines = block.split('\n');
+            const sha = lines[0]?.trim();
+            const author = lines[1]?.trim();
+            const authorEmail = lines[2]?.trim();
+            const timestampStr = lines[3]?.trim();
+            const parentsStr = lines[4]?.trim() ?? '';
+            const message = lines[5]?.trim() ?? '';
+            if (!sha || !author || !authorEmail || !timestampStr)
+                continue;
+            const timestamp = parseInt(timestampStr, 10);
+            const parents = JSON.stringify(parentsStr.length > 0 ? parentsStr.split(' ') : []);
+            insertCommit.run(sha, author, authorEmail, timestamp, message, parents);
+            // Numstat lines start after the blank line (index 6 onward)
+            for (let i = 7; i < lines.length; i++) {
+                const line = lines[i]?.trim();
+                if (!line)
+                    continue;
+                // numstat format: <insertions>\t<deletions>\t<path>
+                // Binary files show "-" for both insertions and deletions.
+                const parts = line.split('\t');
+                if (parts.length < 3)
+                    continue;
+                const [insStr, delStr, ...pathParts] = parts;
+                const filePath = pathParts.join('\t'); // handle tab-in-path edge case
+                const insertions = insStr === '-' ? null : parseInt(insStr, 10);
+                const deletions = delStr === '-' ? null : parseInt(delStr, 10);
+                // Determine change type based on diff stats presence.
+                // Rename detection (e.g. "old => new") is noted as a renamed file.
+                let changeType = 'modified';
+                if (filePath.includes('{') && filePath.includes('=>')) {
+                    changeType = 'renamed';
+                }
+                else if (insertions !== null && deletions === 0 && insertions > 0) {
+                    changeType = 'added';
+                }
+                else if (deletions !== null && insertions === 0 && deletions > 0) {
+                    changeType = 'deleted';
+                }
+                insertCommitFile.run(sha, filePath, changeType, insertions, deletions);
+            }
+        }
+        const refLines = refsRaw
+            .split('\n')
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0);
+        const refs = refLines
+            .map((line) => line.split(/\s+/, 2))
+            .filter((parts) => Boolean(parts[0]) && Boolean(parts[1]))
+            .map(([sha, refName]) => ({ sha, refName }));
+        deleteCommitRefs.run();
+        for (const { sha, refName } of refs) {
+            let refType = 'other';
+            if (refName.startsWith('refs/heads/')) {
+                refType = 'branch';
+            }
+            else if (refName.startsWith('refs/tags/')) {
+                refType = 'tag';
+            }
+            insertCommitRef.run(sha, refName, refType, sha);
+        }
+    })();
+    if (latestShaInRun) {
+        setKbMeta(db, GIT_HISTORY_WATERMARK_KEY, latestShaInRun);
+    }
+}
+//# sourceMappingURL=git-history.js.map

package/dist/indexer/git-history.js.map

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

package/dist/indexer/git-hooks.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @module indexer/git-hooks
+ *
+ * Utilities for installing Git hooks that keep a Lore index up to date.
+ */
+export interface InstallGitHooksOptions {
+    repoRoot: string;
+    rootDir: string;
+    dbPath: string;
+    includeHistory?: boolean;
+}
+/**
+ * Install Lore-refresh git hooks in `.git/hooks` for common lifecycle events.
+ * Existing non-Lore hooks are preserved by prepending a Lore block.
+ */
+export declare function installGitHooks(options: InstallGitHooksOptions): {
+    installed: string[];
+};
+//# sourceMappingURL=git-hooks.d.ts.map

package/dist/indexer/git-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-hooks.d.ts","sourceRoot":"","sources":["../../src/indexer/git-hooks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA4BD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG;IAAE,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CA4CxF"}

package/dist/indexer/git-hooks.js

@@ -0,0 +1,74 @@
+/**
+ * @module indexer/git-hooks
+ *
+ * Utilities for installing Git hooks that keep a Lore index up to date.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execFileSync } from 'node:child_process';
+const HOOK_NAMES = ['post-commit', 'post-merge', 'post-checkout', 'post-rewrite'];
+function shellEscapeSingle(value) {
+    return `'${value.replace(/'/g, `'"'"'`)}'`;
+}
+function makeHookScript(rootDir, dbPath, includeHistory) {
+    const cmd = [
+        'npx',
+        '@jafreck/lore',
+        'refresh',
+        '--root',
+        shellEscapeSingle(rootDir),
+        '--db',
+        shellEscapeSingle(dbPath),
+        ...(includeHistory ? ['--history'] : []),
+    ].join(' ');
+    return [
+        '#!/usr/bin/env sh',
+        'set -e',
+        `${cmd} >/dev/null 2>&1 || true`,
+        '',
+    ].join('\n');
+}
+/**
+ * Install Lore-refresh git hooks in `.git/hooks` for common lifecycle events.
+ * Existing non-Lore hooks are preserved by prepending a Lore block.
+ */
+export function installGitHooks(options) {
+    const repoRoot = options.repoRoot;
+    const hookDir = path.join(repoRoot, '.git', 'hooks');
+    if (!fs.existsSync(path.join(repoRoot, '.git'))) {
+        throw new Error(`Not a git repository: ${repoRoot}`);
+    }
+    fs.mkdirSync(hookDir, { recursive: true });
+    const loreBlock = [
+        '# --- lore auto-refresh (start) ---',
+        makeHookScript(options.rootDir, options.dbPath, options.includeHistory ?? false).trimEnd(),
+        '# --- lore auto-refresh (end) ---',
+        '',
+    ].join('\n');
+    const installed = [];
+    for (const hookName of HOOK_NAMES) {
+        const hookPath = path.join(hookDir, hookName);
+        let existing = '';
+        if (fs.existsSync(hookPath)) {
+            existing = fs.readFileSync(hookPath, 'utf8');
+            existing = existing.replace(/# --- lore auto-refresh \(start\) ---[\s\S]*?# --- lore auto-refresh \(end\) ---\n?/g, '');
+        }
+        let content = '';
+        if (existing.trim().length > 0) {
+            content = `${existing.trimEnd()}\n\n${loreBlock}`;
+        }
+        else {
+            content = loreBlock;
+        }
+        fs.writeFileSync(hookPath, content, 'utf8');
+        try {
+            execFileSync('chmod', ['+x', hookPath]);
+        }
+        catch {
+            fs.chmodSync(hookPath, 0o755);
+        }
+        installed.push(hookName);
+    }
+    return { installed };
+}
+//# sourceMappingURL=git-hooks.js.map

package/dist/indexer/git-hooks.js.map

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

package/dist/indexer/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @module indexer/index
+ *
+ * The `IndexBuilder` class orchestrates the full indexing pipeline:
+ *   walk → parse → extract → resolve → persist
+ *
+ * It also supports incremental updates (`update()`) and a stub for
+ * LLM-summary ingestion (`ingestSummary()`).
+ */
+import type { WalkerConfig } from './walker.js';
+import type { EmbeddingProvider } from './embedder.js';
+import { type CoverageFormat } from './coverage.js';
+/**
+ * Orchestrates the full M1 indexing pipeline.
+ *
+ * @example
+ * ```ts
+ * const builder = new IndexBuilder('/path/to/kb.db', { rootDir: '/path/to/src' });
+ * await builder.build();
+ * ```
+ */
+export declare class IndexBuilder {
+    private readonly dbPath;
+    private readonly walkerConfig;
+    private readonly pool;
+    private readonly resolver;
+    private readonly embedder;
+    private readonly history;
+    private readonly embeddingModel;
+    constructor(dbPath: string, walkerConfig: WalkerConfig, embedder?: EmbeddingProvider, embeddingModelOrOptions?: string | {
+        history?: boolean | {
+            depth?: number;
+            all?: boolean;
+        };
+        embeddingModel?: string;
+    });
+    /**
+     * Performs a full build: walks all files, parses them, extracts
+     * symbols/imports/callRefs, resolves imports, and persists everything to
+     * the database.
+     */
+    build(): Promise<void>;
+    /**
+     * Incrementally re-processes only the listed files and updates the DB.
+     * Symbols and imports for changed files are deleted then re-inserted.
+     *
+     * @param changedFiles  Absolute paths of files that have changed.
+     */
+    update(changedFiles: string[]): Promise<void>;
+    /**
+     * Writes an LLM-generated summary for a symbol to `symbol_summaries`.
+     * If an `EmbeddingProvider` was configured, also embeds the summary text
+     * and persists it to `symbol_semantic_embeddings`.
+     *
+     * @param symbolId  Row ID of the symbol in the `symbols` table.
+     * @param summary   Natural-language summary text.
+     * @param model     Name of the model that produced the summary.
+     */
+    ingestSummary(symbolId: number, summary: string, model?: string): Promise<void>;
+    ingestCoverage(reportPath: string, format: CoverageFormat, commitSha?: string): Promise<void>;
+    /** Parse one file, extract symbols/imports/callRefs, and insert into the DB. */
+    private processFile;
+    /**
+     * Second pass: resolve raw_import strings to file IDs in the
+     * `file_imports.resolved_id` column.  Also populates `external_deps` for
+     * any import that resolves to an external package.
+     */
+    private resolveImports;
+    private resolveBranch;
+    private saveLastKnownHead;
+    private readGitValue;
+    private loadBuildCheckpoint;
+    private saveBuildCheckpoint;
+    /**
+     * Embed structural symbol signatures in batches and persist results to
+     * the `symbol_embeddings` vec0 virtual table.
+     *
+     * Also stores the embedding model name and dims in `kb_meta` and
+     * creates the vec0 tables if they don't exist yet.
+     */
+    private embedStructural;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/indexer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/indexer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA+BhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAoD1E;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IACtE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAGtC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,EAC1B,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,uBAAuB,CAAC,EAAE,MAAM,GAAG;QAAE,OAAO,CAAC,EAAE,OAAO,GAAG;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE;IAyBvH;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC5B;;;;;OAKG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyDnD;;;;;;;;OAQG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBlF,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBnG,gFAAgF;IAChF,OAAO,CAAC,WAAW;IAsHnB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAyCtB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,mBAAmB;IAW3B;;;;;;OAMG;YACW,eAAe;CA6B9B"}