@grafema/util 0.3.0-beta

package/dist/knowledge/git-ingest.d.ts

@@ -0,0 +1,58 @@
+export interface RawCommit {
+    hash: string;
+    message: string;
+    authorName: string;
+    authorEmail: string;
+    date: string;
+    files: FileChange[];
+}
+export interface FileChange {
+    path: string;
+    added: number;
+    removed: number;
+}
+export interface AuthorEntry {
+    id: string;
+    type: 'AUTHOR';
+    name: string;
+    emails: string[];
+    aliases: string[];
+    projections: string[];
+}
+export interface CommitEntry {
+    type: 'COMMIT';
+    hash: string;
+    message: string;
+    author_ref: string;
+    date: string;
+    files: FileChange[];
+    projections: string[];
+}
+export interface IngestResult {
+    commits: number;
+    authors: number;
+    filesChanged: number;
+}
+export interface Meta {
+    last_commit: string;
+    last_ingest: string;
+    branch: string;
+}
+export declare function parseGitLog(rawOutput: string): RawCommit[];
+export declare function normalizeAuthors(commits: RawCommit[]): Map<string, AuthorEntry>;
+export declare class GitIngest {
+    private knowledgeDir;
+    constructor(knowledgeDir: string);
+    ingestFull(repoPath: string, branch?: string, since?: string): Promise<IngestResult>;
+    ingestIncremental(repoPath: string, branch?: string): Promise<IngestResult>;
+    private runGitLog;
+    private writeAuthors;
+    private writeCommits;
+    private writeMeta;
+    private readMeta;
+    private readExistingAuthors;
+    private mergeAuthors;
+    private mergeCommits;
+    private toCommitEntry;
+}
+//# sourceMappingURL=git-ingest.d.ts.map

package/dist/knowledge/git-ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-ingest.d.ts","sourceRoot":"","sources":["../../src/knowledge/git-ingest.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,IAAI;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAcD,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,CAqC1D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAgD/E;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,EAAE,MAAM;IAI1B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA+BpF,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAsCjF,OAAO,CAAC,SAAS;IAoBjB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,YAAY;IAuCpB,OAAO,CAAC,aAAa;CAmBtB"}

package/dist/knowledge/git-ingest.js

@@ -0,0 +1,301 @@
+import { execSync } from 'child_process';
+import { readFileSync, writeFileSync, existsSync, mkdirSync, rmSync } from 'fs';
+import { join } from 'path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+function slugify(name) {
+    return name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+}
+function resolveRenamedPath(rawPath) {
+    const match = rawPath.match(/\{[^}]* => ([^}]*)\}/);
+    if (match) {
+        return rawPath.replace(/\{[^}]* => [^}]*\}/, match[1]);
+    }
+    return rawPath;
+}
+export function parseGitLog(rawOutput) {
+    const commits = [];
+    const blocks = rawOutput.split('COMMIT_START\n').filter(b => b.trim());
+    for (const block of blocks) {
+        const lines = block.split('\n');
+        if (lines.length < 5)
+            continue;
+        const hash = lines[0].trim();
+        const message = lines[1].trim();
+        const authorName = lines[2].trim();
+        const authorEmail = lines[3].trim();
+        const date = lines[4].trim();
+        const files = [];
+        for (let i = 5; i < lines.length; i++) {
+            const line = lines[i].trim();
+            if (!line)
+                continue;
+            const parts = line.split('\t');
+            if (parts.length < 3)
+                continue;
+            const addedRaw = parts[0];
+            const removedRaw = parts[1];
+            const rawPath = parts.slice(2).join('\t');
+            const path = resolveRenamedPath(rawPath);
+            const added = addedRaw === '-' ? 0 : parseInt(addedRaw, 10) || 0;
+            const removed = removedRaw === '-' ? 0 : parseInt(removedRaw, 10) || 0;
+            files.push({ path, added, removed });
+        }
+        commits.push({ hash, message, authorName, authorEmail, date, files });
+    }
+    return commits;
+}
+export function normalizeAuthors(commits) {
+    const emailGroups = new Map();
+    for (const commit of commits) {
+        const emailKey = commit.authorEmail.toLowerCase();
+        let group = emailGroups.get(emailKey);
+        if (!group) {
+            group = { names: new Map(), emails: new Set() };
+            emailGroups.set(emailKey, group);
+        }
+        group.emails.add(commit.authorEmail);
+        const count = group.names.get(commit.authorName) || 0;
+        group.names.set(commit.authorName, count + 1);
+    }
+    const authors = new Map();
+    for (const [, group] of emailGroups) {
+        let primaryName = '';
+        let maxCount = 0;
+        for (const [name, count] of group.names) {
+            if (count > maxCount) {
+                maxCount = count;
+                primaryName = name;
+            }
+        }
+        const aliases = [];
+        for (const [name] of group.names) {
+            if (name !== primaryName) {
+                aliases.push(name);
+            }
+        }
+        const id = slugify(primaryName);
+        const emails = Array.from(group.emails);
+        authors.set(id, {
+            id,
+            type: 'AUTHOR',
+            name: primaryName,
+            emails,
+            aliases,
+            projections: ['temporal', 'organizational'],
+        });
+    }
+    return authors;
+}
+export class GitIngest {
+    knowledgeDir;
+    constructor(knowledgeDir) {
+        this.knowledgeDir = knowledgeDir;
+    }
+    async ingestFull(repoPath, branch, since) {
+        const derivedDir = join(this.knowledgeDir, 'derived');
+        if (existsSync(derivedDir)) {
+            rmSync(derivedDir, { recursive: true, force: true });
+        }
+        const raw = this.runGitLog(repoPath, undefined, branch, since);
+        const rawCommits = parseGitLog(raw);
+        const authors = normalizeAuthors(rawCommits);
+        const commitEntries = rawCommits.map(rc => this.toCommitEntry(rc, authors));
+        this.writeAuthors(authors);
+        this.writeCommits(commitEntries);
+        const meta = {
+            last_commit: rawCommits.length > 0 ? rawCommits[0].hash : '',
+            last_ingest: new Date().toISOString(),
+            branch: branch || 'HEAD',
+        };
+        this.writeMeta(meta);
+        const filesChanged = new Set(rawCommits.flatMap(c => c.files.map(f => f.path))).size;
+        return {
+            commits: rawCommits.length,
+            authors: authors.size,
+            filesChanged,
+        };
+    }
+    async ingestIncremental(repoPath, branch) {
+        const meta = this.readMeta();
+        if (!meta) {
+            return this.ingestFull(repoPath, branch);
+        }
+        const lastCommitHash = meta.last_commit;
+        const raw = this.runGitLog(repoPath, lastCommitHash, branch);
+        const rawCommits = parseGitLog(raw);
+        if (rawCommits.length === 0) {
+            return { commits: 0, authors: 0, filesChanged: 0 };
+        }
+        const newAuthors = normalizeAuthors(rawCommits);
+        const existingAuthors = this.readExistingAuthors();
+        const mergedAuthors = this.mergeAuthors(existingAuthors, newAuthors);
+        const newCommitEntries = rawCommits.map(rc => this.toCommitEntry(rc, mergedAuthors));
+        this.mergeCommits(newCommitEntries);
+        this.writeAuthors(mergedAuthors);
+        const updatedMeta = {
+            last_commit: rawCommits[0].hash,
+            last_ingest: new Date().toISOString(),
+            branch: branch || meta.branch,
+        };
+        this.writeMeta(updatedMeta);
+        const filesChanged = new Set(rawCommits.flatMap(c => c.files.map(f => f.path))).size;
+        return {
+            commits: rawCommits.length,
+            authors: newAuthors.size,
+            filesChanged,
+        };
+    }
+    runGitLog(repoPath, afterCommit, branch, sinceDate) {
+        const ref = branch || 'HEAD';
+        const range = afterCommit ? `${afterCommit}..${ref}` : ref;
+        const sinceFlag = sinceDate ? ` --since="${sinceDate}"` : '';
+        const cmd = `git log --numstat --format="COMMIT_START%n%H%n%s%n%an%n%ae%n%aI"${sinceFlag} ${range}`;
+        try {
+            return execSync(cmd, { cwd: repoPath, encoding: 'utf-8', maxBuffer: 100 * 1024 * 1024 });
+        }
+        catch (error) {
+            // Git exits with 128 for "fatal" errors (empty repo, bad revision, etc.)
+            // These are expected cases, not failures worth surfacing.
+            const exitCode = error.status;
+            if (exitCode === 128) {
+                return '';
+            }
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new Error(`git log failed: ${msg}`);
+        }
+    }
+    writeAuthors(authors) {
+        const derivedDir = join(this.knowledgeDir, 'derived');
+        mkdirSync(derivedDir, { recursive: true });
+        const entries = Array.from(authors.values());
+        const filePath = join(derivedDir, 'authors.yaml');
+        writeFileSync(filePath, stringifyYaml(entries), 'utf-8');
+    }
+    writeCommits(commits) {
+        const commitsDir = join(this.knowledgeDir, 'derived', 'commits');
+        mkdirSync(commitsDir, { recursive: true });
+        const monthGroups = new Map();
+        for (const commit of commits) {
+            const month = commit.date.slice(0, 7); // YYYY-MM
+            let group = monthGroups.get(month);
+            if (!group) {
+                group = [];
+                monthGroups.set(month, group);
+            }
+            group.push(commit);
+        }
+        for (const [month, group] of monthGroups) {
+            const filePath = join(commitsDir, `${month}.yaml`);
+            writeFileSync(filePath, stringifyYaml(group), 'utf-8');
+        }
+    }
+    writeMeta(meta) {
+        const derivedDir = join(this.knowledgeDir, 'derived');
+        mkdirSync(derivedDir, { recursive: true });
+        const filePath = join(derivedDir, 'meta.yaml');
+        writeFileSync(filePath, stringifyYaml(meta), 'utf-8');
+    }
+    readMeta() {
+        const filePath = join(this.knowledgeDir, 'derived', 'meta.yaml');
+        if (!existsSync(filePath))
+            return null;
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            return parseYaml(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    readExistingAuthors() {
+        const filePath = join(this.knowledgeDir, 'derived', 'authors.yaml');
+        const authors = new Map();
+        if (!existsSync(filePath))
+            return authors;
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            const entries = parseYaml(content);
+            if (Array.isArray(entries)) {
+                for (const entry of entries) {
+                    authors.set(entry.id, entry);
+                }
+            }
+        }
+        catch {
+            // ignore parse errors
+        }
+        return authors;
+    }
+    mergeAuthors(existing, incoming) {
+        const merged = new Map(existing);
+        for (const [id, entry] of incoming) {
+            const existingEntry = merged.get(id);
+            if (existingEntry) {
+                const allEmails = new Set([...existingEntry.emails, ...entry.emails]);
+                const allAliases = new Set([...existingEntry.aliases, ...entry.aliases]);
+                merged.set(id, {
+                    ...existingEntry,
+                    emails: Array.from(allEmails),
+                    aliases: Array.from(allAliases),
+                });
+            }
+            else {
+                merged.set(id, entry);
+            }
+        }
+        return merged;
+    }
+    mergeCommits(newCommits) {
+        const commitsDir = join(this.knowledgeDir, 'derived', 'commits');
+        mkdirSync(commitsDir, { recursive: true });
+        const monthGroups = new Map();
+        for (const commit of newCommits) {
+            const month = commit.date.slice(0, 7);
+            let group = monthGroups.get(month);
+            if (!group) {
+                group = [];
+                monthGroups.set(month, group);
+            }
+            group.push(commit);
+        }
+        for (const [month, group] of monthGroups) {
+            const filePath = join(commitsDir, `${month}.yaml`);
+            let existing = [];
+            if (existsSync(filePath)) {
+                try {
+                    const content = readFileSync(filePath, 'utf-8');
+                    const parsed = parseYaml(content);
+                    if (Array.isArray(parsed)) {
+                        existing = parsed;
+                    }
+                }
+                catch {
+                    // ignore parse errors, start fresh
+                }
+            }
+            const existingHashes = new Set(existing.map(c => c.hash));
+            const dedupedNew = group.filter(c => !existingHashes.has(c.hash));
+            const merged = [...existing, ...dedupedNew];
+            writeFileSync(filePath, stringifyYaml(merged), 'utf-8');
+        }
+    }
+    toCommitEntry(rc, authors) {
+        let authorRef = '';
+        for (const [id, author] of authors) {
+            if (author.emails.some(e => e.toLowerCase() === rc.authorEmail.toLowerCase())) {
+                authorRef = `kb:author:${id}`;
+                break;
+            }
+        }
+        return {
+            type: 'COMMIT',
+            hash: rc.hash,
+            message: rc.message,
+            author_ref: authorRef,
+            date: rc.date,
+            files: rc.files,
+            projections: ['temporal', 'organizational'],
+        };
+    }
+}
+//# sourceMappingURL=git-ingest.js.map

package/dist/knowledge/git-ingest.js.map

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

package/dist/knowledge/git-queries.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Git Query Functions for KnowledgeBase
+ *
+ * Provides analytical queries over git data (COMMIT, AUTHOR nodes)
+ * stored in the KnowledgeBase. Operates on KBNode arrays loaded from
+ * YAML files into the KB index.
+ *
+ * COMMIT nodes carry raw YAML fields: hash, message, author_ref, date, files.
+ * AUTHOR nodes carry: name, emails, aliases.
+ * These are accessed via type assertion since they're extra properties
+ * on KBNode objects loaded from YAML frontmatter.
+ */
+import type { KnowledgeBase } from './KnowledgeBase.js';
+export interface ChurnEntry {
+    path: string;
+    changeCount: number;
+    totalAdded: number;
+    totalRemoved: number;
+}
+export interface CoChangeEntry {
+    path: string;
+    coChangeCount: number;
+    support: number;
+}
+export interface OwnershipEntry {
+    authorId: string;
+    authorName: string;
+    commits: number;
+    linesAdded: number;
+    linesRemoved: number;
+}
+export interface ArchaeologyEntry {
+    path: string;
+    lastCommitHash: string;
+    lastCommitDate: string;
+    lastAuthor: string;
+    firstCommitDate: string;
+    firstAuthor: string;
+}
+/**
+ * Compute file churn: how many commits touch each file and total lines added/removed.
+ *
+ * @param kb - KnowledgeBase instance (must be loaded)
+ * @param opts.limit - Return only the top N entries
+ * @param opts.since - ISO date string; only consider commits on or after this date
+ * @returns Churn entries sorted by changeCount descending
+ */
+export declare function getChurn(kb: KnowledgeBase, opts?: {
+    limit?: number;
+    since?: string;
+}): Promise<ChurnEntry[]>;
+/**
+ * Find files that frequently change together with the given file.
+ *
+ * For every commit that touches `filePath`, counts how many of those commits
+ * also touch each other file. `support` is the ratio of co-change count to
+ * the total number of commits touching `filePath`.
+ *
+ * @param kb - KnowledgeBase instance (must be loaded)
+ * @param filePath - The file to find co-changes for
+ * @param opts.minSupport - Minimum support threshold (default 0.1 = 10%)
+ * @returns Co-change entries sorted by coChangeCount descending
+ */
+export declare function getCoChanges(kb: KnowledgeBase, filePath: string, opts?: {
+    minSupport?: number;
+}): Promise<CoChangeEntry[]>;
+/**
+ * Compute ownership of a file: who committed changes and how much.
+ *
+ * Groups commits touching `filePath` by author_ref, sums commit count and
+ * lines added/removed. Looks up author names from AUTHOR nodes in the KB.
+ *
+ * @param kb - KnowledgeBase instance (must be loaded)
+ * @param filePath - The file to compute ownership for
+ * @returns Ownership entries sorted by commits descending
+ */
+export declare function getOwnership(kb: KnowledgeBase, filePath: string): Promise<OwnershipEntry[]>;
+/**
+ * Dig into the history of a file: when it was first created, last modified, and by whom.
+ *
+ * @param kb - KnowledgeBase instance (must be loaded)
+ * @param filePath - The file to investigate
+ * @returns Archaeology entry with first/last commit info, or empty strings if no commits found
+ */
+export declare function getArchaeology(kb: KnowledgeBase, filePath: string): Promise<ArchaeologyEntry>;
+//# sourceMappingURL=git-queries.d.ts.map

package/dist/knowledge/git-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-queries.d.ts","sourceRoot":"","sources":["../../src/knowledge/git-queries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAgCD;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,aAAa,EACjB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,UAAU,EAAE,CAAC,CAyBvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,aAAa,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC,aAAa,EAAE,CAAC,CAgC1B;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,aAAa,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC,CA0C3B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,aAAa,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CAmC3B"}

package/dist/knowledge/git-queries.js

@@ -0,0 +1,177 @@
+/**
+ * Git Query Functions for KnowledgeBase
+ *
+ * Provides analytical queries over git data (COMMIT, AUTHOR nodes)
+ * stored in the KnowledgeBase. Operates on KBNode arrays loaded from
+ * YAML files into the KB index.
+ *
+ * COMMIT nodes carry raw YAML fields: hash, message, author_ref, date, files.
+ * AUTHOR nodes carry: name, emails, aliases.
+ * These are accessed via type assertion since they're extra properties
+ * on KBNode objects loaded from YAML frontmatter.
+ */
+function getCommitHash(node) {
+    return node.hash ?? '';
+}
+function getCommitDate(node) {
+    return node.date ?? '';
+}
+function getCommitFiles(node) {
+    return node.files ?? [];
+}
+function getCommitAuthorRef(node) {
+    return node.author_ref ?? '';
+}
+function getAuthorName(node) {
+    return node.name ?? '';
+}
+// -- Query functions --
+/**
+ * Compute file churn: how many commits touch each file and total lines added/removed.
+ *
+ * @param kb - KnowledgeBase instance (must be loaded)
+ * @param opts.limit - Return only the top N entries
+ * @param opts.since - ISO date string; only consider commits on or after this date
+ * @returns Churn entries sorted by changeCount descending
+ */
+export async function getChurn(kb, opts) {
+    const commits = await kb.queryNodes({ type: 'COMMIT' });
+    const filtered = opts?.since
+        ? commits.filter(c => getCommitDate(c) >= opts.since)
+        : commits;
+    const map = new Map();
+    for (const commit of filtered) {
+        for (const file of getCommitFiles(commit)) {
+            let entry = map.get(file.path);
+            if (!entry) {
+                entry = { path: file.path, changeCount: 0, totalAdded: 0, totalRemoved: 0 };
+                map.set(file.path, entry);
+            }
+            entry.changeCount += 1;
+            entry.totalAdded += file.added;
+            entry.totalRemoved += file.removed;
+        }
+    }
+    const sorted = Array.from(map.values()).sort((a, b) => b.changeCount - a.changeCount);
+    return opts?.limit ? sorted.slice(0, opts.limit) : sorted;
+}
+/**
+ * Find files that frequently change together with the given file.
+ *
+ * For every commit that touches `filePath`, counts how many of those commits
+ * also touch each other file. `support` is the ratio of co-change count to
+ * the total number of commits touching `filePath`.
+ *
+ * @param kb - KnowledgeBase instance (must be loaded)
+ * @param filePath - The file to find co-changes for
+ * @param opts.minSupport - Minimum support threshold (default 0.1 = 10%)
+ * @returns Co-change entries sorted by coChangeCount descending
+ */
+export async function getCoChanges(kb, filePath, opts) {
+    const commits = await kb.queryNodes({ type: 'COMMIT' });
+    const minSupport = opts?.minSupport ?? 0.1;
+    // Find commits that touch the target file
+    const touchingCommits = commits.filter(c => getCommitFiles(c).some(f => f.path === filePath));
+    const totalTouching = touchingCommits.length;
+    if (totalTouching === 0)
+        return [];
+    // Count co-occurrences of other files
+    const coMap = new Map();
+    for (const commit of touchingCommits) {
+        for (const file of getCommitFiles(commit)) {
+            if (file.path === filePath)
+                continue;
+            coMap.set(file.path, (coMap.get(file.path) ?? 0) + 1);
+        }
+    }
+    const entries = [];
+    for (const [path, count] of coMap) {
+        const support = count / totalTouching;
+        if (support >= minSupport) {
+            entries.push({ path, coChangeCount: count, support });
+        }
+    }
+    return entries.sort((a, b) => b.coChangeCount - a.coChangeCount);
+}
+/**
+ * Compute ownership of a file: who committed changes and how much.
+ *
+ * Groups commits touching `filePath` by author_ref, sums commit count and
+ * lines added/removed. Looks up author names from AUTHOR nodes in the KB.
+ *
+ * @param kb - KnowledgeBase instance (must be loaded)
+ * @param filePath - The file to compute ownership for
+ * @returns Ownership entries sorted by commits descending
+ */
+export async function getOwnership(kb, filePath) {
+    const commits = await kb.queryNodes({ type: 'COMMIT' });
+    const authors = await kb.queryNodes({ type: 'AUTHOR' });
+    // Build author name lookup: id -> name
+    const authorNameById = new Map();
+    for (const author of authors) {
+        authorNameById.set(author.id, getAuthorName(author));
+    }
+    // Accumulate per-author stats
+    const map = new Map();
+    for (const commit of commits) {
+        const files = getCommitFiles(commit);
+        const fileEntry = files.find(f => f.path === filePath);
+        if (!fileEntry)
+            continue;
+        const authorRef = getCommitAuthorRef(commit);
+        let stats = map.get(authorRef);
+        if (!stats) {
+            stats = { commits: 0, linesAdded: 0, linesRemoved: 0 };
+            map.set(authorRef, stats);
+        }
+        stats.commits += 1;
+        stats.linesAdded += fileEntry.added;
+        stats.linesRemoved += fileEntry.removed;
+    }
+    const entries = [];
+    for (const [authorId, stats] of map) {
+        entries.push({
+            authorId,
+            authorName: authorNameById.get(authorId) ?? authorId,
+            commits: stats.commits,
+            linesAdded: stats.linesAdded,
+            linesRemoved: stats.linesRemoved,
+        });
+    }
+    return entries.sort((a, b) => b.commits - a.commits);
+}
+/**
+ * Dig into the history of a file: when it was first created, last modified, and by whom.
+ *
+ * @param kb - KnowledgeBase instance (must be loaded)
+ * @param filePath - The file to investigate
+ * @returns Archaeology entry with first/last commit info, or empty strings if no commits found
+ */
+export async function getArchaeology(kb, filePath) {
+    const commits = await kb.queryNodes({ type: 'COMMIT' });
+    // Filter to commits touching this file
+    const touching = commits.filter(c => getCommitFiles(c).some(f => f.path === filePath));
+    if (touching.length === 0) {
+        return {
+            path: filePath,
+            lastCommitHash: '',
+            lastCommitDate: '',
+            lastAuthor: '',
+            firstCommitDate: '',
+            firstAuthor: '',
+        };
+    }
+    // Sort by date ascending
+    const sorted = touching.sort((a, b) => getCommitDate(a).localeCompare(getCommitDate(b)));
+    const first = sorted[0];
+    const last = sorted[sorted.length - 1];
+    return {
+        path: filePath,
+        lastCommitHash: getCommitHash(last),
+        lastCommitDate: getCommitDate(last),
+        lastAuthor: getCommitAuthorRef(last),
+        firstCommitDate: getCommitDate(first),
+        firstAuthor: getCommitAuthorRef(first),
+    };
+}
+//# sourceMappingURL=git-queries.js.map

package/dist/knowledge/git-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-queries.js","sourceRoot":"","sources":["../../src/knowledge/git-queries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA6CH,SAAS,aAAa,CAAC,IAAY;IACjC,OAAQ,IAAY,CAAC,IAAI,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAQ,IAAY,CAAC,IAAI,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,OAAQ,IAAY,CAAC,KAAK,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAQ,IAAY,CAAC,UAAU,IAAI,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAQ,IAAY,CAAC,IAAI,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,wBAAwB;AAExB;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,EAAiB,EACjB,IAAyC;IAEzC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAExD,MAAM,QAAQ,GAAG,IAAI,EAAE,KAAK;QAC1B,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAM,CAAC;QACtD,CAAC,CAAC,OAAO,CAAC;IAEZ,MAAM,GAAG,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE1C,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,KAAK,MAAM,IAAI,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,IAAI,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,KAAK,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;gBAC5E,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC5B,CAAC;YACD,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;YACvB,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC;YAC/B,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,CAAC;QACrC,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;IAEtF,OAAO,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,EAAiB,EACjB,QAAgB,EAChB,IAA8B;IAE9B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,GAAG,CAAC;IAE3C,0CAA0C;IAC1C,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACzC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CACjD,CAAC;IAEF,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,CAAC;IAC7C,IAAI,aAAa,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,sCAAsC;IACtC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS;YACrC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,KAAK,GAAG,aAAa,CAAC;QACtC,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,EAAiB,EACjB,QAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAExD,uCAAuC;IACvC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,8BAA8B;IAC9B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAyE,CAAC;IAE7F,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QACvD,IAAI,CAAC,SAAS;YAAE,SAAS;QAEzB,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QACnB,KAAK,CAAC,UAAU,IAAI,SAAS,CAAC,KAAK,CAAC;QACpC,KAAK,CAAC,YAAY,IAAI,SAAS,CAAC,OAAO,CAAC;IAC1C,CAAC;IAED,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC;YACX,QAAQ;YACR,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,QAAQ;YACpD,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,YAAY,EAAE,KAAK,CAAC,YAAY;SACjC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAiB,EACjB,QAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAExD,uCAAuC;IACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAClC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CACjD,CAAC;IAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,cAAc,EAAE,EAAE;YAClB,cAAc,EAAE,EAAE;YAClB,UAAU,EAAE,EAAE;YACd,eAAe,EAAE,EAAE;YACnB,WAAW,EAAE,EAAE;SAChB,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACpC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CACjD,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEvC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,cAAc,EAAE,aAAa,CAAC,IAAI,CAAC;QACnC,cAAc,EAAE,aAAa,CAAC,IAAI,CAAC;QACnC,UAAU,EAAE,kBAAkB,CAAC,IAAI,CAAC;QACpC,eAAe,EAAE,aAAa,CAAC,KAAK,CAAC;QACrC,WAAW,EAAE,kBAAkB,CAAC,KAAK,CAAC;KACvC,CAAC;AACJ,CAAC"}