@fiale-plus/repo-arch 0.1.0

package/dist/signals.js

@@ -0,0 +1,216 @@
+export const SIGNAL_DEFS = [
+    {
+        type: 'fix',
+        label: 'Bug fix',
+        subjectPatterns: [
+            /^(fix|bugfix|hotfix)[\s(:]/i,
+            /\bfix(e[sd])?\b/i,
+            /\bbug\b/i,
+            /\bhotfix\b/i,
+            /\bpatch\b/i,
+            /\bresolve[ds]?\b/i,
+            /\bregression\b/i,
+        ],
+        baseConfidence: 1.0,
+    },
+    {
+        type: 'revert',
+        label: 'Revert',
+        subjectPatterns: [
+            /^revert[\s(:]/i,
+            /this reverts/i,
+            /back out/i,
+            /undo\b/i,
+        ],
+        baseConfidence: 1.0,
+    },
+    {
+        type: 'rationale',
+        label: 'Contains rationale',
+        subjectPatterns: [
+            /\bbecause\b/i,
+            /\bsince\b/i,
+            /\bto avoid\b/i,
+            /\bin order to\b/i,
+            /\breason\b/i,
+            /\bavoid\b/i,
+            /\bprevent\b/i,
+            /\btrade[ -]off\b/i,
+            /\bwe choose?\b/i,
+            /\bthe reason\b/i,
+            /\bnecessitates?\b/i,
+        ],
+        baseConfidence: 0.7,
+    },
+    {
+        type: 'migration',
+        label: 'Migration / structural change',
+        subjectPatterns: [
+            /^migrate[\s(:]/i,
+            /\bmigrat(e|ion)\b/i,
+            /\brename\b/i,
+            /\bwrap\b/i,
+            /\brestructure\b/i,
+            /\breplace\b/i,
+            /\bconsolidate\b/i,
+            /\bsplit\b/i,
+        ],
+        filePatterns: [/^R\d*\t/],
+        baseConfidence: 0.8,
+    },
+    {
+        type: 'deprecate',
+        label: 'Deprecation',
+        subjectPatterns: [
+            /^deprecat/i,
+            /\bdeprecat\w+\b/i,
+            /\bwill be removed\b/i,
+            /\bno longer supported\b/i,
+        ],
+        baseConfidence: 0.9,
+    },
+    {
+        type: 'refactor',
+        label: 'Refactor',
+        subjectPatterns: [
+            /^refactor/i,
+            /\brefactor(or|ing)?\b/i,
+            /\brewrite\b/i,
+            /\bcleanup\b/i,
+            /\bsimplif(y|ies|ied|ying)\b/i,
+        ],
+        baseConfidence: 0.8,
+    },
+    {
+        type: 'test',
+        label: 'Test change',
+        subjectPatterns: [
+            /^test[\s(:]/i,
+            /\badd.*test/i,
+            /\bupdate.*test/i,
+            /\bfix.*test/i,
+            /\btest.*case/i,
+            /\bspec\b/i,
+        ],
+        filePatterns: [/\.test\./, /\.spec\./, /__tests__\//, /\/test\//],
+        baseConfidence: 0.7,
+    },
+    {
+        type: 'docs',
+        label: 'Documentation',
+        subjectPatterns: [
+            /^docs?[\s(:]/i,
+            /\bdocument/i,
+            /\bREADME\b/i,
+        ],
+        filePatterns: [/\.md$/, /\.mdx$/, /\/docs\//, /\/wiki\//],
+        baseConfidence: 0.8,
+    },
+    {
+        type: 'perf',
+        label: 'Performance',
+        subjectPatterns: [
+            /^perf[\s(:]/i,
+            /\bperformanc/i,
+            /\bspeed\b/i,
+            /\boptimize?\b/i,
+            /\blatency\b/i,
+            /\bthroughput\b/i,
+        ],
+        baseConfidence: 0.8,
+    },
+    {
+        type: 'security',
+        label: 'Security',
+        subjectPatterns: [
+            /^security/i,
+            /\bsecurity\b/i,
+            /\bCVE-/i,
+            /\bexploit\b/i,
+            /\bXSS\b/i,
+            /\bSQL injection\b/i,
+        ],
+        baseConfidence: 0.9,
+    },
+    {
+        type: 'experimental',
+        label: 'Experimental',
+        subjectPatterns: [
+            /^experimental/i,
+            /\bexperiment\b/i,
+            /\bprototype?\b/i,
+            /\bPoC\b/i,
+            /\bproof of concept\b/i,
+        ],
+        baseConfidence: 0.7,
+    },
+    {
+        type: 'config',
+        label: 'Config / dependency change',
+        subjectPatterns: [
+            /^chore[\s(:]/i,
+            /\bdependenc/i,
+            /^bump\b/i,
+            /\bconfig\b/i,
+            /\bversion\b/i,
+        ],
+        filePatterns: [/package\.json$/, /\.config\./, /Dockerfile/, /docker-compose/, /\.ya?ml$/, /^\./, /Makefile/],
+        baseConfidence: 0.6,
+    },
+];
+export function classifyCommit(record, defs = SIGNAL_DEFS) {
+    const signals = [];
+    const subject = record.subject;
+    for (const def of defs) {
+        // Check subject first
+        let matched = false;
+        for (const pattern of def.subjectPatterns) {
+            if (pattern.test(subject)) {
+                signals.push({
+                    type: def.type,
+                    label: def.label,
+                    confidence: def.baseConfidence,
+                    matchedOn: 'subject',
+                });
+                matched = true;
+                break;
+            }
+        }
+        // If subject didn't match, try file patterns as fallback
+        if (!matched && def.filePatterns) {
+            for (const file of record.files) {
+                for (const pattern of def.filePatterns) {
+                    if (pattern.test(file.path) || (file.oldPath && pattern.test(file.oldPath))) {
+                        signals.push({
+                            type: def.type,
+                            label: def.label,
+                            confidence: Math.round(def.baseConfidence * 0.8 * 100) / 100, // lower confidence for file-only match
+                            matchedOn: 'file',
+                        });
+                        matched = true;
+                        break;
+                    }
+                }
+                if (matched)
+                    break;
+            }
+        }
+    }
+    // Deduplicate by type (keep the first/highest confidence match)
+    const seen = new Set();
+    const uniqueSignals = [];
+    for (const s of signals) {
+        if (!seen.has(s.type)) {
+            seen.add(s.type);
+            uniqueSignals.push(s);
+        }
+    }
+    return {
+        ...record,
+        signals: uniqueSignals,
+    };
+}
+export function classifyHistory(records, defs = SIGNAL_DEFS) {
+    return records.map(record => classifyCommit(record, defs));
+}
+//# sourceMappingURL=signals.js.map

package/dist/signals.js.map

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

package/dist/similar.d.ts

@@ -0,0 +1,20 @@
+export type SimilarResult = {
+    query: string;
+    results: {
+        id: string;
+        text: string;
+        source: string;
+        score: number;
+        metadata: Record<string, string>;
+    }[];
+    indexStats: {
+        model: string;
+        dim: number;
+        entries: number;
+        headSha: string;
+    };
+};
+export declare function similar(query: string, options?: {
+    repoPath?: string;
+    topK?: number;
+}): Promise<SimilarResult>;

package/dist/similar.js

@@ -0,0 +1,51 @@
+import { mineHistory } from './git-history.js';
+import { classifyHistory } from './signals.js';
+import { generateCards } from './cards.js';
+import { getStatusOverrideMap } from './review.js';
+import { loadIndex, buildIndex, searchIndex, embed } from './embedder.js';
+import { resolveRepoRoot, getHeadSha } from './git-history.js';
+import { cachedOrGenerate } from './cache.js';
+export async function similar(query, options = {}) {
+    const repoRoot = resolveRepoRoot(options.repoPath);
+    const headSha = getHeadSha(repoRoot);
+    const topK = options.topK ?? 5;
+    // Load or build index
+    let index = loadIndex(repoRoot);
+    if (!index || index.headSha !== headSha) {
+        // Build index from cards
+        const generateFn = () => {
+            const history = mineHistory({ repoPath: options.repoPath });
+            const classified = classifyHistory(history.records);
+            return generateCards(classified, {}, getStatusOverrideMap(repoRoot));
+        };
+        const { cards } = cachedOrGenerate(repoRoot, generateFn);
+        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 });
+    }
+    // Embed query
+    const queryEmbedding = await embed(query);
+    // Search
+    const results = searchIndex(index, queryEmbedding, topK);
+    return {
+        query,
+        results: results.map(r => ({
+            id: r.entry.id,
+            text: r.entry.text,
+            source: r.entry.source,
+            score: parseFloat(r.score.toFixed(4)),
+            metadata: r.entry.metadata,
+        })),
+        indexStats: {
+            model: index.model,
+            dim: index.dim,
+            entries: index.entries.length,
+            headSha: index.headSha.slice(0, 12),
+        },
+    };
+}
+//# sourceMappingURL=similar.js.map

package/dist/similar.js.map

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

package/dist/staleness.d.ts

@@ -0,0 +1,28 @@
+import type { InsightCard, CardType } from './cards.js';
+export type StaleStatus = 'fresh' | 'partial' | 'stale';
+export type StalenessResult = {
+    cardId: string;
+    type: CardType;
+    title: string;
+    status: StaleStatus;
+    missingFiles: string[];
+    existingFiles: string[];
+    /** Whether referenced commits are still reachable in history */
+    commitsReachable: boolean;
+    /** HEAD at time of check */
+    checkedAtHead: string;
+};
+export type StalenessOptions = {
+    repoPath?: string;
+};
+export type StalenessSummary = {
+    repoRoot: string;
+    checkedAtHead: string;
+    total: number;
+    fresh: number;
+    partial: number;
+    stale: number;
+    results: StalenessResult[];
+};
+export declare function checkStaleness(cards: InsightCard[], options?: StalenessOptions): StalenessSummary;
+export declare function formatStaleness(summary: StalenessSummary): string;

package/dist/staleness.js

@@ -0,0 +1,110 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { runGit, resolveRepoRoot } from './git-history.js';
+function fileExists(repoRoot, filePath) {
+    return fs.existsSync(path.join(repoRoot, filePath));
+}
+function commitsReachable(repoRoot, shas) {
+    if (shas.length === 0)
+        return true;
+    try {
+        runGit(repoRoot, ['cat-file', '--batch-check']);
+        // Check each sha individually
+        for (const sha of shas) {
+            try {
+                runGit(repoRoot, ['cat-file', '-e', sha]);
+            }
+            catch {
+                return false;
+            }
+        }
+        return true;
+    }
+    catch {
+        // fallback: try a single merge-base check
+        try {
+            runGit(repoRoot, ['merge-base', '--is-ancestor', shas[0], 'HEAD']);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+export function checkStaleness(cards, options = {}) {
+    const repoRoot = resolveRepoRoot(options.repoPath);
+    const headSha = runGit(repoRoot, ['rev-parse', 'HEAD']).trim();
+    const results = cards.map(card => {
+        const existing = [];
+        const missing = [];
+        for (const file of card.affectedFiles) {
+            if (fileExists(repoRoot, file)) {
+                existing.push(file);
+            }
+            else {
+                missing.push(file);
+            }
+        }
+        let status = 'fresh';
+        if (missing.length > 0 && existing.length > 0) {
+            status = 'partial';
+        }
+        else if (missing.length > 0 && existing.length === 0) {
+            status = 'stale';
+        }
+        const commitShas = card.supportingCommits.map(c => c.sha);
+        return {
+            cardId: card.id,
+            type: card.type,
+            title: card.title,
+            status,
+            missingFiles: missing,
+            existingFiles: existing,
+            commitsReachable: commitsReachable(repoRoot, commitShas),
+            checkedAtHead: headSha,
+        };
+    });
+    const fresh = results.filter(r => r.status === 'fresh').length;
+    const partial = results.filter(r => r.status === 'partial').length;
+    const stale = results.filter(r => r.status === 'stale').length;
+    return {
+        repoRoot,
+        checkedAtHead: headSha,
+        total: results.length,
+        fresh,
+        partial,
+        stale,
+        results,
+    };
+}
+export function formatStaleness(summary) {
+    const lines = [];
+    if (summary.total === 0) {
+        lines.push('\n  No cards to check.\n');
+        return lines.join('\n');
+    }
+    const statusIcon = (s) => s === 'fresh' ? '✅' : s === 'partial' ? '🟡' : '🔴';
+    lines.push(`\n  Staleness check for ${summary.repoRoot}`);
+    lines.push(`  ${summary.checkedAtHead.slice(0, 12)} | ${summary.total} cards`);
+    lines.push(`  ${summary.fresh} fresh · ${summary.partial} partial · ${summary.stale} stale\n`);
+    for (const result of summary.results) {
+        if (result.status !== 'stale' && result.status !== 'partial')
+            continue;
+        lines.push(`  ${statusIcon(result.status)} [${result.status.toUpperCase()}] ${result.title}`);
+        if (result.missingFiles.length > 0) {
+            lines.push(`     Missing files:`);
+            for (const f of result.missingFiles) {
+                lines.push(`       · ${f}`);
+            }
+        }
+        if (!result.commitsReachable) {
+            lines.push(`     ⚠ Referenced commits no longer reachable in history`);
+        }
+        lines.push('');
+    }
+    if (summary.stale === 0 && summary.partial === 0) {
+        lines.push(`  All cards reference files that still exist.\n`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=staleness.js.map

package/dist/staleness.js.map

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

package/dist/training.d.ts

@@ -0,0 +1,53 @@
+import { type InsightCard } from './cards.js';
+export type DatasetExample = {
+    messages: {
+        role: 'user' | 'assistant';
+        content: string;
+    }[];
+    sourceCardId: string;
+    taskType: 'qa' | 'review-warning' | 'risk-classification' | 'negative';
+};
+export type DatasetOptions = {
+    repoPath?: string;
+    outPath?: string;
+    includeRejected?: boolean;
+};
+export type DatasetResult = {
+    repoRoot: string;
+    headSha: string;
+    totalCards: number;
+    acceptedCards: number;
+    examples: DatasetExample[];
+    counts: {
+        qa: number;
+        'review-warning': number;
+        'risk-classification': number;
+        negative: number;
+    };
+};
+export declare function generateQa(card: InsightCard): DatasetExample[];
+export declare function generateReviewWarning(card: InsightCard): DatasetExample[];
+export declare function generateRiskClassification(card: InsightCard): DatasetExample[];
+export declare function generateDataset(options?: DatasetOptions): DatasetResult;
+export declare function formatDataset(result: DatasetResult): string;
+export type TrainOptions = {
+    repoPath?: string;
+    outPath?: string;
+    model?: string;
+    iters?: number;
+    adapterName?: string;
+    learningRate?: number;
+    /** Whether to actually run training (vs just printing the command) */
+    run?: boolean;
+};
+export type TrainPlan = {
+    dataDir: string;
+    trainFile: string;
+    validFile: string;
+    model: string;
+    adapterPath: string;
+    command: string;
+    examples: number;
+};
+export declare function prepareTrain(options?: TrainOptions): TrainPlan;
+export declare function formatTrain(plan: TrainPlan): string;