@fiale-plus/repo-arch 0.1.0

package/dist/training.js

@@ -0,0 +1,221 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+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';
+export function generateQa(card) {
+    const examples = [];
+    const fileStr = card.affectedFiles.join(', ');
+    // General "why" question
+    if (card.type === 'rationale-cluster' || card.type === 'repeated-fix') {
+        examples.push({
+            messages: [
+                { role: 'user', content: `Why should I be careful when changing ${fileStr}?` },
+                { role: 'assistant', content: `${card.title}. ${card.suggestion} Evidence: ${card.supportingCommits.map(c => c.subject).join('; ')}.` },
+            ],
+            sourceCardId: card.id,
+            taskType: 'qa',
+        });
+    }
+    // Direct question from card title
+    const titleQuestion = card.title.replace(/^High-churn file:/, 'Why does').replace(/^Repeated fixes in:/, 'What keeps breaking in').replace(/^Possible test gap:/, 'Is there test coverage for').replace(/^Reversion pattern:?/, 'Has this been reverted before');
+    if (titleQuestion !== card.title) {
+        examples.push({
+            messages: [
+                { role: 'user', content: `${titleQuestion} ${fileStr}?` },
+                { role: 'assistant', content: `${card.title}. ${card.suggestion}` },
+            ],
+            sourceCardId: card.id,
+            taskType: 'qa',
+        });
+    }
+    return examples;
+}
+export function generateReviewWarning(card) {
+    const examples = [];
+    if (card.type === 'repeated-fix' || card.type === 'revert-pattern') {
+        examples.push({
+            messages: [
+                { role: 'user', content: `Review this change touching ${card.affectedFiles.join(', ')}.\nWhat risks should I check?` },
+                { role: 'assistant', content: `Warning: ${card.title}. ${card.suggestion} This area has ${card.supportingCommits.length} relevant commits in history.` },
+            ],
+            sourceCardId: card.id,
+            taskType: 'review-warning',
+        });
+    }
+    return examples;
+}
+export function generateRiskClassification(card) {
+    const examples = [];
+    const riskLevel = card.confidence >= 0.7 ? 'high' : card.confidence >= 0.5 ? 'medium' : 'low';
+    examples.push({
+        messages: [
+            { role: 'user', content: `Classify risk for changing ${card.affectedFiles.join(', ')}.` },
+            { role: 'assistant', content: JSON.stringify({
+                    risk: card.type === 'revert-pattern' ? 'revert_instability' : card.type === 'repeated-fix' ? 'regression_risk' : card.type === 'test-gap' ? 'test_coverage_concern' : 'informational',
+                    severity: riskLevel,
+                    confidence: card.confidence,
+                    reason: card.suggestion,
+                }) },
+        ],
+        sourceCardId: card.id,
+        taskType: 'risk-classification',
+    });
+    return examples;
+}
+function generateNegative(cards) {
+    // Generate negative examples from low-confidence or churn-hotspot cards
+    const negatives = [];
+    for (const card of cards) {
+        if (card.type === 'churn-hotspot' && card.confidence < 0.6) {
+            negatives.push({
+                messages: [
+                    { role: 'user', content: `Review this change touching ${card.affectedFiles.join(', ')}.\nWhat risks should I check?` },
+                    { role: 'assistant', content: `No specific historical warnings for this file. It changes frequently but has no repeated fix or revert patterns. Standard review applies.` },
+                ],
+                sourceCardId: card.id,
+                taskType: 'negative',
+            });
+        }
+    }
+    // Add a generic negative if few exist
+    if (negatives.length === 0) {
+        negatives.push({
+            messages: [
+                { role: 'user', content: 'Review this change touching src/new-feature.ts.\nWhat risks should I check?' },
+                { role: 'assistant', content: 'No historical warnings found for this file. Standard review applies.' },
+            ],
+            sourceCardId: 'generic',
+            taskType: 'negative',
+        });
+    }
+    return negatives;
+}
+export function generateDataset(options = {}) {
+    const repoRoot = resolveRepoRoot(options.repoPath);
+    const headSha = getHeadSha(repoRoot);
+    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 = options.includeRejected
+        ? cards.filter(c => c.status === 'accepted' || c.status === 'pending')
+        : cards.filter(c => c.status === 'accepted');
+    const examples = [];
+    for (const card of acceptedCards) {
+        examples.push(...generateQa(card));
+        examples.push(...generateReviewWarning(card));
+        examples.push(...generateRiskClassification(card));
+    }
+    examples.push(...generateNegative(cards));
+    const counts = { qa: 0, 'review-warning': 0, 'risk-classification': 0, negative: 0 };
+    for (const ex of examples) {
+        counts[ex.taskType]++;
+    }
+    const result = {
+        repoRoot,
+        headSha: headSha.slice(0, 12),
+        totalCards: cards.length,
+        acceptedCards: acceptedCards.length,
+        examples,
+        counts,
+    };
+    if (options.outPath) {
+        const jsonl = examples.map(ex => JSON.stringify(ex)).join('\n') + '\n';
+        fs.mkdirSync(path.dirname(path.resolve(options.outPath)), { recursive: true });
+        fs.writeFileSync(options.outPath, jsonl, 'utf8');
+    }
+    return result;
+}
+export function formatDataset(result) {
+    const lines = [];
+    lines.push(`\n  Training dataset for ${result.repoRoot}`);
+    lines.push(`  ${result.headSha} | ${result.totalCards} cards (${result.acceptedCards} training-relevant)`);
+    lines.push(`  ${result.examples.length} total examples\n`);
+    for (const [type, count] of Object.entries(result.counts)) {
+        if (count > 0) {
+            lines.push(`  ${type.padEnd(22)} ${count}`);
+        }
+    }
+    lines.push('');
+    // Show a sample
+    const first = result.examples[0];
+    if (first) {
+        lines.push(`  Sample (${first.taskType}):`);
+        lines.push(`    User: ${first.messages[0].content.slice(0, 80)}...`);
+        lines.push(`    Assistant: ${first.messages[1].content.slice(0, 80)}...`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function prepareTrain(options = {}) {
+    const repoRoot = resolveRepoRoot(options.repoPath);
+    const headSha = getHeadSha(repoRoot);
+    // Default output dir inside repo
+    const outDir = options.outPath
+        ? path.resolve(options.outPath)
+        : path.join(repoRoot, '.repo-arch', 'training-data');
+    // Generate dataset
+    const dataset = generateDataset({ repoPath: options.repoPath });
+    const examples = dataset.examples;
+    if (examples.length === 0) {
+        throw new Error('No training examples generated. Use repo-arch accept on some cards first.');
+    }
+    // Shuffle and split 90/10
+    const shuffled = [...examples].sort(() => Math.random() - 0.5);
+    const splitIdx = Math.max(1, Math.floor(shuffled.length * 0.9));
+    const train = shuffled.slice(0, splitIdx);
+    const valid = shuffled.slice(splitIdx);
+    // Write train.jsonl and valid.jsonl (OpenAI chat format)
+    fs.mkdirSync(outDir, { recursive: true });
+    const trainFile = path.join(outDir, 'train.jsonl');
+    const validFile = path.join(outDir, 'valid.jsonl');
+    fs.writeFileSync(trainFile, train.map(ex => JSON.stringify({ messages: ex.messages })).join('\n') + '\n');
+    fs.writeFileSync(validFile, valid.map(ex => JSON.stringify({ messages: ex.messages })).join('\n') + '\n');
+    // Build mlx_lm.lora command
+    const model = options.model ?? 'Qwen/Qwen2.5-Coder-1.5B-Instruct';
+    const adapterName = options.adapterName ?? `repo-arch-${headSha.slice(0, 7)}`;
+    const adapterPath = path.join(repoRoot, '.repo-arch', 'adapters', adapterName);
+    const iters = options.iters ?? 100;
+    const learningRate = options.learningRate ?? 1e-5;
+    const command = [
+        'mlx_lm.lora',
+        '--train',
+        `--model ${model}`,
+        `--data ${outDir}`,
+        `--adapter-path ${adapterPath}`,
+        `--num-layers 4`,
+        `--batch-size 4`,
+        `--iters ${iters}`,
+        `--val-batches 10`,
+        `--learning-rate ${learningRate}`,
+        `--steps-per-report 10`,
+        `--steps-per-eval 10`,
+    ].join(' \\\n  ');
+    return {
+        dataDir: outDir,
+        trainFile,
+        validFile,
+        model,
+        adapterPath,
+        command,
+        examples: examples.length,
+    };
+}
+export function formatTrain(plan) {
+    const lines = [];
+    lines.push(`\n  Training data prepared at ${plan.dataDir}`);
+    lines.push(`  ${plan.examples} examples (train + valid)`);
+    lines.push(`  Model: ${plan.model}`);
+    lines.push(`  Adapter: ${plan.adapterPath}\n`);
+    lines.push(`  To train, run:\n`);
+    lines.push(`  ${plan.command.replace(/\\n/g, '\n')}`);
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=training.js.map

package/dist/training.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"training.js","sourceRoot":"","sources":["../src/training.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAmC,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAuB9C,MAAM,UAAU,UAAU,CAAC,IAAiB;IAC1C,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE9C,yBAAyB;IACzB,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACtE,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,yCAAyC,OAAO,GAAG,EAAE;gBAC9E,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,UAAU,cAAc,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;aACxI;YACD,YAAY,EAAE,IAAI,CAAC,EAAE;YACrB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;IACL,CAAC;IAED,kCAAkC;IAClC,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,wBAAwB,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,4BAA4B,CAAC,CAAC,OAAO,CAAC,sBAAsB,EAAE,+BAA+B,CAAC,CAAC;IACjQ,IAAI,aAAa,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,IAAI,OAAO,GAAG,EAAE;gBACzD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,UAAU,EAAE,EAAE;aACpE;YACD,YAAY,EAAE,IAAI,CAAC,EAAE;YACrB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAiB;IACrD,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACnE,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,+BAA+B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,+BAA+B,EAAE;gBACtH,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,UAAU,kBAAkB,IAAI,CAAC,iBAAiB,CAAC,MAAM,+BAA+B,EAAE;aACzJ;YACD,YAAY,EAAE,IAAI,CAAC,EAAE;YACrB,QAAQ,EAAE,gBAAgB;SAC3B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAiB;IAC1D,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;IAE9F,QAAQ,CAAC,IAAI,CAAC;QACZ,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,8BAA8B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;YACzF,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;oBAC3C,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,eAAe;oBACrL,QAAQ,EAAE,SAAS;oBACnB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,MAAM,EAAE,IAAI,CAAC,UAAU;iBACxB,CAAC,EAAE;SACL;QACD,YAAY,EAAE,IAAI,CAAC,EAAE;QACrB,QAAQ,EAAE,qBAAqB;KAChC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAoB;IAC5C,wEAAwE;IACxE,MAAM,SAAS,GAAqB,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;YAC3D,SAAS,CAAC,IAAI,CAAC;gBACb,QAAQ,EAAE;oBACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,+BAA+B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,+BAA+B,EAAE;oBACtH,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,2IAA2I,EAAE;iBAC5K;gBACD,YAAY,EAAE,IAAI,CAAC,EAAE;gBACrB,QAAQ,EAAE,UAAU;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,IAAI,CAAC;YACb,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,6EAA6E,EAAE;gBACxG,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,sEAAsE,EAAE;aACvG;YACD,YAAY,EAAE,SAAS;YACvB,QAAQ,EAAE,UAAU;SACrB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAA0B,EAAE;IAC1D,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAErC,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,MAAM,OAAO,GAAG,WAAW,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpD,OAAO,aAAa,CAAC,UAAU,EAAE,EAAE,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC;IACF,MAAM,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAEzD,MAAM,aAAa,GAAG,OAAO,CAAC,eAAe;QAC3C,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC;QACtE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;IAE/C,MAAM,QAAQ,GAAqB,EAAE,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACnC,QAAQ,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,qBAAqB,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACrF,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;IACxB,CAAC;IAED,MAAM,MAAM,GAAkB;QAC5B,QAAQ;QACR,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7B,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,aAAa,EAAE,aAAa,CAAC,MAAM;QACnC,QAAQ;QACR,MAAM;KACP,CAAC;IAEF,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACvE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/E,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,4BAA4B,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,OAAO,MAAM,MAAM,CAAC,UAAU,WAAW,MAAM,CAAC,aAAa,qBAAqB,CAAC,CAAC;IAC3G,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,mBAAmB,CAAC,CAAC;IAE3D,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,gBAAgB;IAChB,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QACtE,KAAK,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAuBD,MAAM,UAAU,YAAY,CAAC,UAAwB,EAAE;IACrD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAErC,iCAAiC;IACjC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO;QAC5B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QAC/B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;IAEvD,mBAAmB;IACnB,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAElC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC/F,CAAC;IAED,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEvC,yDAAyD;IACzD,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAEnD,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1G,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAE1G,4BAA4B;IAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,kCAAkC,CAAC;IAClE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,aAAa,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC9E,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC;IACnC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;IAElD,MAAM,OAAO,GAAG;QACd,aAAa;QACb,SAAS;QACT,WAAW,KAAK,EAAE;QAClB,UAAU,MAAM,EAAE;QAClB,kBAAkB,WAAW,EAAE;QAC/B,gBAAgB;QAChB,gBAAgB;QAChB,WAAW,KAAK,EAAE;QAClB,kBAAkB;QAClB,mBAAmB,YAAY,EAAE;QACjC,uBAAuB;QACvB,qBAAqB;KACtB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAElB,OAAO;QACL,OAAO,EAAE,MAAM;QACf,SAAS;QACT,SAAS;QACT,KAAK;QACL,WAAW;QACX,OAAO;QACP,QAAQ,EAAE,QAAQ,CAAC,MAAM;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAe;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,iCAAiC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,2BAA2B,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/why.d.ts

@@ -0,0 +1,38 @@
+import { type ClassifiedCommit } from './signals.js';
+import { type InsightCard } from './cards.js';
+export type CoChangePartner = {
+    path: string;
+    count: number;
+};
+export type WhyResult = {
+    filePath: string;
+    repoRoot: string;
+    headSha: string;
+    commitCount: number;
+    /** Commits that touched this file */
+    touchingCommits: ClassifiedCommit[];
+    /** Signal counts scoped to this file */
+    signalSummary: {
+        type: string;
+        label: string;
+        count: number;
+    }[];
+    fixCommits: {
+        sha: string;
+        subject: string;
+    }[];
+    rationaleCommits: {
+        sha: string;
+        subject: string;
+    }[];
+    revertCommits: {
+        sha: string;
+        subject: string;
+    }[];
+    coChangePartners: CoChangePartner[];
+    relatedCards: InsightCard[];
+};
+export declare function why(filePath: string, options?: {
+    repoPath?: string;
+}): WhyResult;
+export declare function formatWhy(result: WhyResult): string;

package/dist/why.js

@@ -0,0 +1,131 @@
+import { generateCards } from './cards.js';
+import { mineHistory } from './git-history.js';
+import { classifyHistory } from './signals.js';
+import { getStatusOverrideMap } from './review.js';
+export function why(filePath, options = {}) {
+    const repoRoot = mineHistory({ repoPath: options.repoPath }).repoRoot;
+    const history = mineHistory({ repoPath: options.repoPath });
+    const classified = classifyHistory(history.records);
+    const cards = generateCards(classified, { minConfidence: 0.3 }, getStatusOverrideMap(repoRoot));
+    // Filter commits that touch the specified file
+    const touchingCommits = classified.filter(record => record.files.some(f => f.path === filePath || f.oldPath === filePath));
+    // Signal summary (deduplicate by type within each commit)
+    const signalCount = new Map();
+    for (const commit of touchingCommits) {
+        const seen = new Set();
+        for (const signal of commit.signals) {
+            if (!seen.has(signal.type)) {
+                seen.add(signal.type);
+                const existing = signalCount.get(signal.type);
+                if (existing) {
+                    existing.count += 1;
+                }
+                else {
+                    signalCount.set(signal.type, { label: signal.label, count: 1 });
+                }
+            }
+        }
+    }
+    const signalSummary = [...signalCount.entries()]
+        .map(([type, info]) => ({ type, label: info.label, count: info.count }))
+        .sort((a, b) => b.count - a.count);
+    // Categorize commits
+    const fixCommits = touchingCommits
+        .filter(c => c.signals.some(s => s.type === 'fix'))
+        .map(c => ({ sha: c.sha.slice(0, 7), subject: c.subject }));
+    const rationaleCommits = touchingCommits
+        .filter(c => c.signals.some(s => s.type === 'rationale'))
+        .map(c => ({ sha: c.sha.slice(0, 7), subject: c.subject }));
+    const revertCommits = touchingCommits
+        .filter(c => c.signals.some(s => s.type === 'revert'))
+        .map(c => ({ sha: c.sha.slice(0, 7), subject: c.subject }));
+    // Co-change partners
+    const partnerMap = new Map();
+    for (const commit of touchingCommits) {
+        for (const file of commit.files) {
+            if (file.path !== filePath && file.path) {
+                partnerMap.set(file.path, (partnerMap.get(file.path) ?? 0) + 1);
+            }
+        }
+    }
+    const coChangePartners = [...partnerMap.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 8)
+        .map(([path, count]) => ({ path, count }));
+    // Related cards
+    const relatedCards = cards.filter(card => card.affectedFiles.some(f => f === filePath));
+    return {
+        filePath,
+        repoRoot,
+        headSha: history.headSha,
+        commitCount: touchingCommits.length,
+        touchingCommits,
+        signalSummary,
+        fixCommits,
+        rationaleCommits,
+        revertCommits,
+        coChangePartners,
+        relatedCards,
+    };
+}
+export function formatWhy(result) {
+    const lines = [];
+    lines.push('');
+    lines.push(`  📜 ${result.filePath}`);
+    lines.push(`  ${result.repoRoot} @ ${result.headSha.slice(0, 12)}`);
+    lines.push('');
+    // Summary line
+    const parts = [`${result.commitCount} commit${result.commitCount !== 1 ? 's' : ''}`];
+    for (const sig of result.signalSummary) {
+        parts.push(`${sig.count} ${sig.type}`);
+    }
+    lines.push(`  ${parts.join(' · ')}`);
+    lines.push('');
+    // Fix commits
+    if (result.fixCommits.length > 0) {
+        lines.push(`  ❌ Repeated fixes (${result.fixCommits.length}):`);
+        for (const c of result.fixCommits) {
+            lines.push(`    · ${c.subject} (${c.sha})`);
+        }
+        lines.push('');
+    }
+    // Rationale commits
+    if (result.rationaleCommits.length > 0) {
+        lines.push(`  💡 Rationale:`);
+        for (const c of result.rationaleCommits) {
+            lines.push(`    · ${c.subject} (${c.sha})`);
+        }
+        lines.push('');
+    }
+    // Revert commits
+    if (result.revertCommits.length > 0) {
+        lines.push(`  ↩ Reverted:`);
+        for (const c of result.revertCommits) {
+            lines.push(`    · ${c.subject} (${c.sha})`);
+        }
+        lines.push('');
+    }
+    // Co-change partners
+    if (result.coChangePartners.length > 0) {
+        lines.push(`  🔗 Co-changes:`);
+        for (const p of result.coChangePartners.slice(0, 5)) {
+            lines.push(`    · ${p.path} (${p.count} time${p.count !== 1 ? 's' : ''})`);
+        }
+        lines.push('');
+    }
+    // Related cards
+    if (result.relatedCards.length > 0) {
+        lines.push(`  ⚠️  Related cards:`);
+        for (const card of result.relatedCards) {
+            lines.push(`    · ${card.title} (confidence ${card.confidence})`);
+        }
+        lines.push('');
+    }
+    // Fallback
+    if (result.commitCount === 0) {
+        lines.push(`  No commits found touching this file. It may be untracked or new.`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=why.js.map

package/dist/why.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@fiale-plus/repo-arch",
+  "version": "0.1.0",
+  "description": "Project archaeology and repo memory tooling — CLI-first project-memory engine",
+  "type": "module",
+  "bin": {
+    "repo-arch": "./dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "test": "tsx --test",
+    "typecheck": "tsc --noEmit",
+    "mine-history": "tsx ./src/cli.ts mine-history",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fiale-plus/repo-arch.git"
+  },
+  "author": "fiale-plus",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3"
+  },
+  "dependencies": {
+    "@huggingface/transformers": "4.2.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}