@fiale-plus/repo-arch 0.1.0

package/dist/embedder.js

@@ -0,0 +1,84 @@
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { resolveRepoRoot, getHeadSha } from './git-history.js';
+export const DEFAULT_MODEL = 'Xenova/all-MiniLM-L6-v2';
+export const EMBEDDING_DIM = 384;
+let extractor = null;
+function ensureCacheDir(repoRoot) {
+    const dir = path.join(repoRoot, '.repo-arch', 'index');
+    fs.mkdirSync(dir, { recursive: true });
+    return dir;
+}
+function indexFilePath(repoRoot) {
+    return path.join(ensureCacheDir(repoRoot), 'vectors.json');
+}
+function cacheKey(repoRoot, headSha) {
+    return crypto.createHash('sha256').update(JSON.stringify({ repoRoot, headSha, model: DEFAULT_MODEL })).digest('hex');
+}
+export async function loadExtractor(config = {}) {
+    if (extractor)
+        return extractor;
+    try {
+        const { pipeline } = await import('@huggingface/transformers');
+        extractor = await pipeline('feature-extraction', config.model ?? DEFAULT_MODEL);
+        return extractor;
+    }
+    catch (error) {
+        throw new Error(`Failed to load embedding model. Install with: npm install @huggingface/transformers\n  ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export async function embed(text, config = {}) {
+    const pipe = await loadExtractor(config);
+    const result = await pipe(text, { pooling: 'mean', normalize: true });
+    return Array.from(result.data);
+}
+export function cosineSimilarity(a, b) {
+    let dot = 0;
+    for (let i = 0; i < a.length; i++)
+        dot += a[i] * b[i];
+    return dot;
+}
+export function loadIndex(repoRoot) {
+    const filePath = indexFilePath(repoRoot);
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function saveIndex(repoRoot, index) {
+    fs.writeFileSync(indexFilePath(repoRoot), JSON.stringify(index, null, 2), 'utf8');
+}
+export async function buildIndex(entries, options = {}) {
+    const repoRoot = resolveRepoRoot(options.repoPath);
+    const headSha = getHeadSha(repoRoot);
+    const pipe = await loadExtractor(options);
+    const vectorEntries = [];
+    for (const entry of entries) {
+        const embedding = await embed(entry.text, options);
+        vectorEntries.push({ ...entry, embedding });
+    }
+    const index = {
+        model: options.model ?? DEFAULT_MODEL,
+        dim: EMBEDDING_DIM,
+        headSha,
+        entries: vectorEntries,
+        createdAt: new Date().toISOString(),
+    };
+    saveIndex(repoRoot, index);
+    return index;
+}
+export function searchIndex(index, queryEmbedding, topK = 5) {
+    const scored = index.entries.map(entry => ({
+        entry,
+        score: cosineSimilarity(queryEmbedding, entry.embedding),
+    }));
+    return scored
+        .sort((a, b) => b.score - a.score)
+        .slice(0, topK);
+}
+//# sourceMappingURL=embedder.js.map

package/dist/embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.js","sourceRoot":"","sources":["../src/embedder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,CAAC,MAAM,aAAa,GAAG,yBAAyB,CAAC;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAsBjC,IAAI,SAAS,GAAQ,IAAI,CAAC;AAE1B,SAAS,cAAc,CAAC,QAAgB;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IACvD,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB,EAAE,OAAe;IACjD,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAyB,EAAE;IAC7D,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QAC/D,SAAS,GAAG,MAAM,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC;QAChF,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,0FAA0F,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACnJ,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAY,EAAE,SAAyB,EAAE;IACnE,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAa,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAgB,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,KAAkB;IAC5D,EAAE,CAAC,aAAa,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAoG,EACpG,UAAiD,EAAE;IAEnD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAE1C,MAAM,aAAa,GAAkB,EAAE,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnD,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,KAAK,GAAgB;QACzB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,aAAa;QACrC,GAAG,EAAE,aAAa;QAClB,OAAO;QACP,OAAO,EAAE,aAAa;QACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,KAAkB,EAClB,cAAwB,EACxB,OAAe,CAAC;IAEhB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzC,KAAK;QACL,KAAK,EAAE,gBAAgB,CAAC,cAAc,EAAE,KAAK,CAAC,SAAS,CAAC;KACzD,CAAC,CAAC,CAAC;IAEJ,OAAO,MAAM;SACV,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACpB,CAAC"}

package/dist/eval.d.ts

@@ -0,0 +1,36 @@
+import { type InsightCard } from './cards.js';
+export type EvalQuery = {
+    id: string;
+    query: string;
+    expectedCardId: string;
+    expectedTitle: string;
+};
+export type StrategyResult = {
+    strategy: string;
+    hits: number;
+    total: number;
+    hitRate: number;
+    results: {
+        queryId: string;
+        query: string;
+        expectedTitle: string;
+        found: boolean;
+        rank: number | null;
+        score: number | null;
+    }[];
+};
+export type EvalReport = {
+    repoRoot: string;
+    headSha: string;
+    cardsTotal: number;
+    acceptedCards: number;
+    queries: number;
+    strategies: StrategyResult[];
+    bestStrategy: string;
+    timestamp: string;
+};
+export declare function generateQueries(cards: InsightCard[]): EvalQuery[];
+export declare function runEval(options?: {
+    repoPath?: string;
+}): Promise<EvalReport>;
+export declare function formatEval(report: EvalReport): string;

package/dist/eval.js

@@ -0,0 +1,175 @@
+import { resolveRepoRoot, getHeadSha } from './git-history.js';
+import { mineHistory } from './git-history.js';
+import { classifyHistory } from './signals.js';
+import { generateCards } from './cards.js';
+import { getStatusOverrideMap } from './review.js';
+import { cachedOrGenerate } from './cache.js';
+import { loadIndex, buildIndex, searchIndex, embed } from './embedder.js';
+export function generateQueries(cards) {
+    const queries = [];
+    for (const card of cards) {
+        if (card.status !== 'accepted')
+            continue;
+        // Query from title
+        queries.push({
+            id: `${card.id}-title`,
+            query: card.title,
+            expectedCardId: card.id,
+            expectedTitle: card.title,
+        });
+        // Query from suggestion (truncated to key phrase)
+        const short = card.suggestion.replace(/\.(?:\s|$).*/, '').trim();
+        if (short && short !== card.title) {
+            queries.push({
+                id: `${card.id}-suggestion`,
+                query: short,
+                expectedCardId: card.id,
+                expectedTitle: card.title,
+            });
+        }
+    }
+    return queries;
+}
+function keywordSearch(query, cards, topK = 5) {
+    const terms = query.toLowerCase().split(/\s+/).filter(t => t.length > 2);
+    const scored = cards.map(card => {
+        const haystack = `${card.title} ${card.suggestion} ${card.affectedFiles.join(' ')}`.toLowerCase();
+        let score = 0;
+        for (const term of terms) {
+            if (haystack.includes(term))
+                score += 1;
+        }
+        return { card, score: score / terms.length };
+    });
+    return scored.sort((a, b) => b.score - a.score).slice(0, topK);
+}
+export async function runEval(options = {}) {
+    const repoRoot = resolveRepoRoot(options.repoPath);
+    const headSha = getHeadSha(repoRoot);
+    // Get cards with review state
+    const generateFn = () => {
+        const history = mineHistory({ repoPath: options.repoPath });
+        const classified = classifyHistory(history.records);
+        return generateCards(classified, {}, getStatusOverrideMap(repoRoot));
+    };
+    const { cards } = cachedOrGenerate(repoRoot, generateFn);
+    const acceptedCards = cards.filter(c => c.status === 'accepted');
+    const queries = generateQueries(cards);
+    if (acceptedCards.length === 0) {
+        return {
+            repoRoot,
+            headSha: headSha.slice(0, 12),
+            cardsTotal: cards.length,
+            acceptedCards: 0,
+            queries: 0,
+            strategies: [],
+            bestStrategy: 'none',
+            timestamp: new Date().toISOString(),
+        };
+    }
+    const strategyResults = [];
+    // Strategy 1: Keyword search
+    {
+        const results = [];
+        for (const q of queries) {
+            const topResults = keywordSearch(q.query, cards, 5);
+            const foundIdx = topResults.findIndex(r => r.card.id === q.expectedCardId);
+            results.push({
+                queryId: q.id,
+                query: q.query,
+                expectedTitle: q.expectedTitle,
+                found: foundIdx >= 0,
+                rank: foundIdx >= 0 ? foundIdx + 1 : null,
+                score: foundIdx >= 0 ? topResults[foundIdx].score : null,
+            });
+        }
+        const hits = results.filter(r => r.found).length;
+        strategyResults.push({
+            strategy: 'keyword',
+            hits,
+            total: results.length,
+            hitRate: parseFloat((hits / results.length).toFixed(3)),
+            results,
+        });
+    }
+    // Strategy 2: Embedding search
+    {
+        // Build or load embedding index
+        let index = loadIndex(repoRoot);
+        if (!index || index.headSha !== headSha) {
+            const entries = cards.map(card => ({
+                id: card.id,
+                text: `${card.title}. ${card.suggestion} ${card.supportingCommits.map(c => c.subject).join('. ')}`,
+                source: 'card',
+                metadata: { type: card.type, confidence: String(card.confidence), status: card.status },
+            }));
+            index = await buildIndex(entries, { repoPath: options.repoPath });
+        }
+        const results = [];
+        for (const q of queries) {
+            const queryEmbedding = await embed(q.query);
+            const topResults = searchIndex(index, queryEmbedding, 5);
+            const foundIdx = topResults.findIndex(r => r.entry.id === q.expectedCardId);
+            results.push({
+                queryId: q.id,
+                query: q.query,
+                expectedTitle: q.expectedTitle,
+                found: foundIdx >= 0,
+                rank: foundIdx >= 0 ? foundIdx + 1 : null,
+                score: foundIdx >= 0 ? topResults[foundIdx].score : null,
+            });
+        }
+        const hits = results.filter(r => r.found).length;
+        strategyResults.push({
+            strategy: 'embedding',
+            hits,
+            total: results.length,
+            hitRate: parseFloat((hits / results.length).toFixed(3)),
+            results,
+        });
+    }
+    // Determine best strategy
+    const sorted = [...strategyResults].sort((a, b) => b.hitRate - a.hitRate);
+    const bestStrategy = sorted.length > 0 ? sorted[0].strategy : 'none';
+    return {
+        repoRoot,
+        headSha: headSha.slice(0, 12),
+        cardsTotal: cards.length,
+        acceptedCards: acceptedCards.length,
+        queries: queries.length,
+        strategies: strategyResults,
+        bestStrategy,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function formatEval(report) {
+    const lines = [];
+    if (report.acceptedCards === 0) {
+        lines.push(`\n  No accepted cards to evaluate.`);
+        lines.push(`  Use "repo-arch accept <card-id>" on some cards first.\n`);
+        return lines.join('\n');
+    }
+    lines.push(`\n  Eval benchmark for ${report.repoRoot}`);
+    lines.push(`  ${report.headSha} | ${report.cardsTotal} cards (${report.acceptedCards} accepted, ${report.queries} queries)\n`);
+    for (const strategy of report.strategies) {
+        const rate = (strategy.hitRate * 100).toFixed(1);
+        const bar = '█'.repeat(Math.round(strategy.hitRate * 20));
+        const empty = '░'.repeat(20 - Math.round(strategy.hitRate * 20));
+        lines.push(`  ${strategy.strategy.padEnd(12)} ${bar}${empty} ${rate}% (${strategy.hits}/${strategy.total})`);
+    }
+    lines.push(`\n  Best strategy: ${report.bestStrategy}\n`);
+    // Show misses for worst strategy
+    const worst = [...report.strategies].sort((a, b) => a.hitRate - b.hitRate)[0];
+    if (worst) {
+        const misses = worst.results.filter(r => !r.found).slice(0, 5);
+        if (misses.length > 0) {
+            lines.push(`  Missed queries (${worst.strategy}):`);
+            for (const m of misses) {
+                lines.push(`    · "${m.query}" — expected "${m.expectedTitle.slice(0, 60)}"`);
+            }
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=eval.js.map

package/dist/eval.js.map

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

package/dist/git-history.d.ts

@@ -0,0 +1,41 @@
+export type GitFileChange = {
+    status: string;
+    path: string;
+    oldPath?: string;
+};
+export type GitHistoryRecord = {
+    sha: string;
+    parents: string[];
+    author: {
+        name: string;
+        email: string;
+    };
+    authoredAt: string;
+    subject: string;
+    files: GitFileChange[];
+    paths: string[];
+};
+export type MineHistoryOptions = {
+    repoPath?: string;
+    outPath?: string;
+};
+export type MineHistoryResult = {
+    repoRoot: string;
+    headSha: string;
+    cacheHit: boolean;
+    cacheFile: string;
+    count: number;
+    records: GitHistoryRecord[];
+    jsonl: string;
+};
+export declare function runGit(repoPath: string, args: string[]): string;
+export declare function resolveRepoRoot(repoPath?: string): string;
+export declare function getHeadSha(repoRoot: string): string;
+export declare function cacheKeyFor({ repoRoot, headSha, version }: {
+    repoRoot: string;
+    headSha: string;
+    version?: number;
+}): string;
+export declare function cacheFileFor(repoRoot: string, cacheKey: string): string;
+export declare function parseGitHistory(logOutput: string): GitHistoryRecord[];
+export declare function mineHistory({ repoPath, outPath }?: MineHistoryOptions): MineHistoryResult;

package/dist/git-history.js

@@ -0,0 +1,115 @@
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execFileSync } from 'node:child_process';
+export function runGit(repoPath, args) {
+    return execFileSync('git', ['-C', repoPath, ...args], { encoding: 'utf8', maxBuffer: 50 * 1024 * 1024 });
+}
+export function resolveRepoRoot(repoPath = process.cwd()) {
+    const resolved = path.resolve(repoPath);
+    const root = runGit(resolved, ['rev-parse', '--show-toplevel']).trim();
+    if (!root)
+        throw new Error(`Unable to resolve git repo root from ${resolved}`);
+    return root;
+}
+export function getHeadSha(repoRoot) {
+    return runGit(repoRoot, ['rev-parse', 'HEAD']).trim();
+}
+export function cacheKeyFor({ repoRoot, headSha, version = 1 }) {
+    return crypto
+        .createHash('sha256')
+        .update(JSON.stringify({ repoRoot, headSha, version }))
+        .digest('hex');
+}
+export function cacheFileFor(repoRoot, cacheKey) {
+    return path.join(repoRoot, '.repo-arch', 'cache', `history-${cacheKey}.jsonl`);
+}
+function ensureDir(filePath) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+}
+export function parseGitHistory(logOutput) {
+    const records = [];
+    let current = null;
+    const pushCurrent = () => {
+        if (!current)
+            return;
+        current.paths = current.files.map(file => file.path);
+        records.push(current);
+        current = null;
+    };
+    for (const rawLine of logOutput.split(/\r?\n/)) {
+        if (!rawLine)
+            continue;
+        if (rawLine.startsWith('@@@')) {
+            pushCurrent();
+            const meta = rawLine.slice(3).split('\x1f');
+            const [sha, parentsStr = '', authorName = '', authorEmail = '', authoredAt = '', subject = ''] = meta;
+            current = {
+                sha,
+                parents: parentsStr ? parentsStr.split(' ').filter(Boolean) : [],
+                author: { name: authorName, email: authorEmail },
+                authoredAt,
+                subject,
+                files: [],
+                paths: []
+            };
+            continue;
+        }
+        if (!current)
+            continue;
+        const parts = rawLine.split('\t');
+        const status = parts[0] || '';
+        if (!status)
+            continue;
+        if ((status.startsWith('R') || status.startsWith('C')) && parts.length >= 3) {
+            current.files.push({ status, path: parts[2], oldPath: parts[1] });
+        }
+        else {
+            current.files.push({ status, path: parts[1] || '' });
+        }
+    }
+    pushCurrent();
+    return records;
+}
+export function mineHistory({ repoPath, outPath } = {}) {
+    const repoRoot = resolveRepoRoot(repoPath);
+    const headSha = getHeadSha(repoRoot);
+    const cacheKey = cacheKeyFor({ repoRoot, headSha, version: 1 });
+    const cacheFile = cacheFileFor(repoRoot, cacheKey);
+    let cacheHit = false;
+    let records;
+    if (fs.existsSync(cacheFile)) {
+        cacheHit = true;
+        const cached = fs.readFileSync(cacheFile, 'utf8');
+        records = cached.trim() ? cached.trim().split(/\r?\n/).map(line => JSON.parse(line)) : [];
+    }
+    else {
+        const logOutput = runGit(repoRoot, [
+            'log',
+            '--reverse',
+            '--date=iso-strict',
+            '--format=@@@%H%x1f%P%x1f%an%x1f%ae%x1f%ad%x1f%s',
+            '--name-status',
+            '--find-renames=50%'
+        ]);
+        records = parseGitHistory(logOutput);
+        const jsonl = records.map(record => JSON.stringify(record)).join('\n') + (records.length ? '\n' : '');
+        ensureDir(cacheFile);
+        fs.writeFileSync(cacheFile, jsonl, 'utf8');
+    }
+    const jsonl = records.map(record => JSON.stringify(record)).join('\n') + (records.length ? '\n' : '');
+    if (outPath) {
+        fs.mkdirSync(path.dirname(path.resolve(outPath)), { recursive: true });
+        fs.writeFileSync(outPath, jsonl, 'utf8');
+    }
+    return {
+        repoRoot,
+        headSha,
+        cacheHit,
+        cacheFile,
+        count: records.length,
+        records,
+        jsonl
+    };
+}
+//# sourceMappingURL=git-history.js.map

package/dist/git-history.js.map

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

package/dist/review.d.ts

@@ -0,0 +1,12 @@
+import type { CardStatus } from './cards.js';
+export type ReviewEntry = {
+    status: CardStatus;
+    updatedAt: string;
+};
+export type ReviewMap = Record<string, ReviewEntry>;
+export declare function loadReviewState(repoRoot: string): ReviewMap;
+export declare function saveReviewState(repoRoot: string, state: ReviewMap): void;
+export declare function setCardStatus(repoRoot: string, cardId: string, status: CardStatus): ReviewEntry | null;
+export declare function getCardStatus(repoRoot: string, cardId: string): ReviewEntry | null;
+export declare function listReviewState(repoRoot: string): ReviewMap;
+export declare function getStatusOverrideMap(repoRoot: string): Record<string, CardStatus>;

package/dist/review.js

@@ -0,0 +1,46 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const REVIEW_FILE = '.repo-arch/review-state.json';
+function reviewFilePath(repoRoot) {
+    return path.join(repoRoot, REVIEW_FILE);
+}
+export function loadReviewState(repoRoot) {
+    const filePath = reviewFilePath(repoRoot);
+    if (!fs.existsSync(filePath))
+        return {};
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function saveReviewState(repoRoot, state) {
+    const filePath = reviewFilePath(repoRoot);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(state, null, 2) + '\n', 'utf8');
+}
+export function setCardStatus(repoRoot, cardId, status) {
+    const state = loadReviewState(repoRoot);
+    state[cardId] = { status, updatedAt: new Date().toISOString() };
+    saveReviewState(repoRoot, state);
+    return state[cardId];
+}
+export function getCardStatus(repoRoot, cardId) {
+    const state = loadReviewState(repoRoot);
+    return state[cardId] ?? null;
+}
+export function listReviewState(repoRoot) {
+    return loadReviewState(repoRoot);
+}
+export function getStatusOverrideMap(repoRoot) {
+    const state = loadReviewState(repoRoot);
+    const overrides = {};
+    for (const [id, entry] of Object.entries(state)) {
+        if (entry.status === 'accepted' || entry.status === 'rejected') {
+            overrides[id] = entry.status;
+        }
+    }
+    return overrides;
+}
+//# sourceMappingURL=review.js.map

package/dist/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../src/review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAUlC,MAAM,WAAW,GAAG,8BAA8B,CAAC;AAEnD,SAAS,cAAc,CAAC,QAAgB;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAc,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,KAAgB;IAChE,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC1C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,MAAc,EAAE,MAAkB;IAChF,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACxC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;IAChE,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,MAAc;IAC5D,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,SAAS,GAA+B,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC/D,SAAS,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/signals.d.ts

@@ -0,0 +1,23 @@
+import { type GitHistoryRecord } from './git-history.js';
+export type SignalDef = {
+    type: string;
+    label: string;
+    /** Regex patterns matched against commit subject */
+    subjectPatterns: RegExp[];
+    /** File-path patterns checked when subject match is weak */
+    filePatterns?: RegExp[];
+    /** Base confidence (0-1). Higher = stronger signal */
+    baseConfidence: number;
+};
+export type CommitSignal = {
+    type: string;
+    label: string;
+    confidence: number;
+    matchedOn: 'subject' | 'file';
+};
+export type ClassifiedCommit = GitHistoryRecord & {
+    signals: CommitSignal[];
+};
+export declare const SIGNAL_DEFS: SignalDef[];
+export declare function classifyCommit(record: GitHistoryRecord, defs?: SignalDef[]): ClassifiedCommit;
+export declare function classifyHistory(records: GitHistoryRecord[], defs?: SignalDef[]): ClassifiedCommit[];