openlore 2.0.0 → 2.0.2

package/dist/cli/preflight/diff.js

@@ -0,0 +1,162 @@
+/**
+ * Compute the set of source files that have changed since the graph was built.
+ *
+ * Two paths:
+ *
+ *  1. `--since <git-ref>` (CI-friendly) — `git diff --name-only <ref>...HEAD`
+ *     plus uncommitted modifications. The merge-base form is intentional:
+ *     it captures every file the PR touched, not just the latest commit.
+ *
+ *  2. No `--since` flag — fall back to comparing file mtimes against
+ *     `fingerprint.json.computedAt`. Slower but works without git history.
+ *
+ * Either path returns paths relative to the repo root. Non-source files
+ * (anything not tracked by the analyzer's language config) are filtered out
+ * by the caller via the node table.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { stat, readdir, readFile, access } from 'node:fs/promises';
+import { join, relative, resolve, sep } from 'node:path';
+import { OPENLORE_DIR } from '../../constants.js';
+const execFileAsync = promisify(execFile);
+export async function hasGitDirectory(repoRoot) {
+    try {
+        await access(join(repoRoot, '.git'));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function runGit(repoRoot, args) {
+    const { stdout } = await execFileAsync('git', args, { cwd: repoRoot });
+    return stdout;
+}
+export async function refExists(repoRoot, ref) {
+    try {
+        await runGit(repoRoot, ['rev-parse', '--verify', '--quiet', ref]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function shortHead(repoRoot) {
+    try {
+        return (await runGit(repoRoot, ['rev-parse', '--short', 'HEAD'])).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** Changed files via git diff against `since`, plus uncommitted modifications. */
+async function diffViaGit(repoRoot, since) {
+    // Use ...HEAD (merge-base) so we capture every file the PR touched relative
+    // to the branch point, not just the latest commit's diff.
+    const tracked = (await runGit(repoRoot, ['diff', '--name-only', `${since}...HEAD`]))
+        .split('\n')
+        .filter(Boolean);
+    // Include uncommitted modifications so a developer running locally before
+    // committing also gets honest feedback.
+    const uncommitted = (await runGit(repoRoot, ['diff', '--name-only', 'HEAD']))
+        .split('\n')
+        .filter(Boolean);
+    const set = new Set([...tracked, ...uncommitted]);
+    return Array.from(set).sort();
+}
+/** Changed files via mtime comparison against graphBuiltAtMs. */
+async function diffViaMtime(repoRoot, graphBuiltAtMs) {
+    const out = [];
+    await walk(repoRoot, repoRoot, graphBuiltAtMs, out);
+    return out.sort();
+}
+const SKIP_DIRECTORIES = new Set([
+    'node_modules',
+    'dist',
+    'build',
+    'out',
+    'coverage',
+    OPENLORE_DIR,
+    '.git',
+]);
+async function walk(repoRoot, dir, cutoffMs, out) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const ent of entries) {
+        if (ent.name.startsWith('.') && ent.name !== '.gitignore')
+            continue;
+        if (SKIP_DIRECTORIES.has(ent.name))
+            continue;
+        const full = join(dir, ent.name);
+        if (ent.isDirectory()) {
+            await walk(repoRoot, full, cutoffMs, out);
+            continue;
+        }
+        if (!ent.isFile())
+            continue;
+        try {
+            const s = await stat(full);
+            if (s.mtimeMs > cutoffMs) {
+                out.push(relative(repoRoot, full).split(sep).join('/'));
+            }
+        }
+        catch {
+            /* unreadable file — skip */
+        }
+    }
+}
+export async function computeDiff(opts) {
+    const root = resolve(opts.repoRoot);
+    const warnings = [];
+    const workingCommit = await shortHead(root);
+    const gitAvailable = await hasGitDirectory(root);
+    if (opts.since) {
+        if (!gitAvailable) {
+            throw Object.assign(new Error(`--since requires a git repository`), { exitCode: 2 });
+        }
+        if (!(await refExists(root, opts.since))) {
+            throw Object.assign(new Error(`git ref not found: ${opts.since}`), { exitCode: 2 });
+        }
+        const changed = await diffViaGit(root, opts.since);
+        return { changed, mechanism: 'git', warnings, workingCommit };
+    }
+    if (!gitAvailable) {
+        warnings.push('no .git found — falling back to mtime comparison');
+    }
+    if (!opts.graphBuiltAt) {
+        warnings.push('graph has no build timestamp — everything will look stale');
+        // Treat as "everything changed since epoch" — caller can decide.
+        const changed = await diffViaMtime(root, 0);
+        return { changed, mechanism: 'mtime', warnings, workingCommit };
+    }
+    const cutoff = Date.parse(opts.graphBuiltAt);
+    if (Number.isNaN(cutoff)) {
+        warnings.push(`graph build timestamp unparseable: ${opts.graphBuiltAt}`);
+        const changed = await diffViaMtime(root, 0);
+        return { changed, mechanism: 'mtime', warnings, workingCommit };
+    }
+    const changed = await diffViaMtime(root, cutoff);
+    return { changed, mechanism: 'mtime', warnings, workingCommit };
+}
+/** Read `fingerprint.json` if present. */
+export async function readGraphFingerprint(repoRoot) {
+    const path = join(repoRoot, OPENLORE_DIR, 'analysis', 'fingerprint.json');
+    try {
+        const raw = await readFile(path, 'utf8');
+        const parsed = JSON.parse(raw);
+        return {
+            computedAt: parsed.computedAt ?? null,
+            fileCount: typeof parsed.fileCount === 'number' ? parsed.fileCount : null,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=diff.js.map

package/dist/cli/preflight/diff.js.map

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

package/dist/cli/preflight/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `openlore preflight` — CI staleness gate.
+ *
+ * Determines whether the persisted analysis graph is current relative to
+ * the working tree. Designed to run on every PR so out-of-date graphs
+ * never reach orient() / agent runtime silently.
+ *
+ * Exit codes: 0 = fresh, 1 = stale, 2 = error.
+ */
+import { Command } from 'commander';
+import { type PreflightSummary } from './report.js';
+export interface PreflightOptions {
+    cwd?: string;
+    fix?: boolean;
+    json?: boolean;
+    since?: string;
+    maxStaleness?: number;
+    /**
+     * Test-only seam: replace the analyzer invocation used by --fix. Returns
+     * the exit code (0 = success). Production code spawns `openlore analyze`;
+     * tests pass a stub that simulates the side-effect (refreshing
+     * fingerprint.json) without needing the full pipeline.
+     */
+    analyzeFn?: (cwd: string) => Promise<number>;
+}
+export declare function runPreflight(opts: PreflightOptions): Promise<{
+    code: number;
+    summary?: PreflightSummary;
+}>;
+export declare const preflightCommand: Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/preflight/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/preflight/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C;AAID,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B,CAAC,CAgGD;AAeD,eAAO,MAAM,gBAAgB,SAczB,CAAC"}

package/dist/cli/preflight/index.js

@@ -0,0 +1,126 @@
+/**
+ * `openlore preflight` — CI staleness gate.
+ *
+ * Determines whether the persisted analysis graph is current relative to
+ * the working tree. Designed to run on every PR so out-of-date graphs
+ * never reach orient() / agent runtime silently.
+ *
+ * Exit codes: 0 = fresh, 1 = stale, 2 = error.
+ */
+import { access } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { spawn } from 'node:child_process';
+import { Command } from 'commander';
+import { logger } from '../../utils/logger.js';
+import { OPENLORE_DIR, OPENLORE_ANALYSIS_SUBDIR, ARTIFACT_CALL_GRAPH_DB, } from '../../constants.js';
+import { computeDiff, readGraphFingerprint } from './diff.js';
+import { scoreChangedFiles } from './score.js';
+import { buildSummary, renderHuman, renderJson, renderGithubAnnotations, } from './report.js';
+const DEFAULT_THRESHOLD = 0;
+export async function runPreflight(opts) {
+    const cwd = resolve(opts.cwd ?? process.cwd());
+    const threshold = typeof opts.maxStaleness === 'number' ? opts.maxStaleness : DEFAULT_THRESHOLD;
+    // 1. Graph must exist.
+    const dbPath = join(cwd, OPENLORE_DIR, OPENLORE_ANALYSIS_SUBDIR, ARTIFACT_CALL_GRAPH_DB);
+    try {
+        await access(dbPath);
+    }
+    catch {
+        if (opts.json) {
+            process.stdout.write(JSON.stringify({
+                status: 'ERROR',
+                error: 'no graph found',
+                hint: 'run `openlore analyze` first',
+            }, null, 2) + '\n');
+        }
+        else {
+            logger.error('No graph found. Run `openlore analyze` first to build the analysis graph.');
+        }
+        return { code: 2 };
+    }
+    // 2. Read graph metadata.
+    const fp = await readGraphFingerprint(cwd);
+    const graphBuiltAt = fp?.computedAt ?? null;
+    // We don't store the build commit today — leave null. Once analyze records
+    // it, this is the single place to surface it. (See TODO in docs/preflight.md.)
+    const graphCommit = null;
+    // 3. Compute changed files.
+    let diff;
+    try {
+        diff = await computeDiff({ repoRoot: cwd, graphBuiltAt, since: opts.since });
+    }
+    catch (err) {
+        const e = err;
+        if (opts.json) {
+            process.stdout.write(JSON.stringify({ status: 'ERROR', error: e.message }, null, 2) + '\n');
+        }
+        else {
+            logger.error(e.message);
+        }
+        return { code: e.exitCode ?? 2 };
+    }
+    // 4. Score.
+    const score = scoreChangedFiles(cwd, diff.changed);
+    // 5. Build summary.
+    const summary = buildSummary({ diff, score, graphBuiltAt, graphCommit, threshold });
+    const stale = summary.stalenessScore > threshold;
+    // 6. --fix path runs `openlore analyze` then re-checks.
+    if (stale && opts.fix) {
+        if (!opts.json)
+            logger.discovery('Stale graph detected — running `openlore analyze --fix`');
+        const code = await (opts.analyzeFn ?? runAnalyzeFix)(cwd);
+        if (code !== 0) {
+            if (opts.json) {
+                process.stdout.write(JSON.stringify({ status: 'ERROR', error: 'openlore analyze --fix failed' }, null, 2) +
+                    '\n');
+            }
+            else {
+                logger.error('openlore analyze failed during --fix; manual intervention required');
+            }
+            return { code: 2 };
+        }
+        // Re-run preflight WITHOUT --fix and WITHOUT --since (now everything
+        // should be current vs. the freshly built graph).
+        return runPreflight({
+            cwd,
+            json: opts.json,
+            maxStaleness: opts.maxStaleness,
+            analyzeFn: opts.analyzeFn,
+        });
+    }
+    // 7. Render.
+    if (opts.json) {
+        process.stdout.write(renderJson(summary) + '\n');
+    }
+    else {
+        process.stdout.write(renderHuman(summary) + '\n');
+    }
+    // 8. GitHub Actions inline annotations (no-op outside GHA).
+    const annotations = renderGithubAnnotations(summary);
+    if (annotations)
+        process.stdout.write(annotations + '\n');
+    return { code: stale ? 1 : 0, summary };
+}
+async function runAnalyzeFix(cwd) {
+    return new Promise((resolveProm) => {
+        // TODO(spec-03-followup): when `openlore analyze --incremental` exists,
+        // prefer that — it should be a fraction of the cost of the full re-run.
+        const child = spawn(process.execPath, [process.argv[1], 'analyze'], {
+            cwd,
+            stdio: 'inherit',
+        });
+        child.on('exit', (code) => resolveProm(code ?? 1));
+        child.on('error', () => resolveProm(1));
+    });
+}
+export const preflightCommand = new Command('preflight')
+    .description('CI staleness gate: check whether the analysis graph is current relative to the working tree.')
+    .option('--fix', 'Run `openlore analyze` if the graph is stale, then re-check', false)
+    .option('--json', 'Emit JSON instead of human-readable output', false)
+    .option('--since <ref>', 'Diff against this git ref (e.g. origin/main) instead of mtimes')
+    .option('--max-staleness <n>', `Maximum allowed staleness score (default ${DEFAULT_THRESHOLD})`, (v) => parseInt(v, 10), DEFAULT_THRESHOLD)
+    .action(async (opts) => {
+    const { code } = await runPreflight(opts);
+    process.exit(code);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/preflight/index.js.map

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

package/dist/cli/preflight/report.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Human-readable + JSON renderers for preflight results.
+ */
+import type { DiffResult } from './diff.js';
+import type { ScoreResult } from './score.js';
+export type PreflightStatus = 'FRESH' | 'STALE' | 'ERROR';
+export interface PerFileEntry {
+    filePath: string;
+    weight: number;
+    hub: boolean;
+    /** Highest fan-in across nodes in the file (for "why is this a hub"). */
+    maxFanIn: number;
+    /** True if the file isn't represented in the graph at all. */
+    unknown: boolean;
+}
+export interface PreflightSummary {
+    status: PreflightStatus;
+    graphBuiltAt: string | null;
+    graphCommit: string | null;
+    workingCommit: string | null;
+    changedFiles: string[];
+    unknownFiles: string[];
+    /** Per-file detail with weight + hub flag. Same order as `changedFiles`. */
+    perFile: PerFileEntry[];
+    hubCount: number;
+    leafCount: number;
+    stalenessScore: number;
+    threshold: number;
+    mechanism: 'git' | 'mtime';
+    warnings: string[];
+    message: string;
+}
+export interface BuildSummaryInput {
+    diff: DiffResult;
+    score: ScoreResult;
+    graphBuiltAt: string | null;
+    graphCommit: string | null;
+    threshold: number;
+}
+export declare function buildSummary(input: BuildSummaryInput): PreflightSummary;
+export declare function renderHuman(s: PreflightSummary): string;
+/**
+ * Emit GitHub Actions workflow-command annotations so that stale files
+ * appear inline in the PR diff UI when this runs in CI. No-op outside of
+ * GHA. Format docs:
+ *   https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions
+ */
+export declare function renderGithubAnnotations(s: PreflightSummary): string;
+export declare function renderJson(s: PreflightSummary): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/cli/preflight/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/cli/preflight/report.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,4EAA4E;IAC5E,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,KAAK,GAAG,OAAO,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,CA8CvE;AAMD,wBAAgB,WAAW,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAmDvD;AAcD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAmBnE;AAMD,wBAAgB,UAAU,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CA4BtD"}

package/dist/cli/preflight/report.js

@@ -0,0 +1,174 @@
+/**
+ * Human-readable + JSON renderers for preflight results.
+ */
+export function buildSummary(input) {
+    const { diff, score, graphBuiltAt, graphCommit, threshold } = input;
+    const totalChanged = diff.changed.length;
+    const stale = score.totalScore > threshold;
+    const status = stale ? 'STALE' : 'FRESH';
+    let message;
+    if (totalChanged === 0) {
+        message = 'nothing to check — no changed files since graph build';
+    }
+    else if (stale) {
+        message = `STALE — run \`openlore analyze\` or re-run with --fix`;
+    }
+    else {
+        message = 'FRESH';
+    }
+    // Build per-file detail in the same order as diff.changed so renderers
+    // can show "why" each file matters without re-querying the graph.
+    const scoreByPath = new Map(score.perFile.map((f) => [f.filePath, f]));
+    const unknownSet = new Set(score.unknownFiles);
+    const perFile = diff.changed.map((p) => {
+        const s = scoreByPath.get(p);
+        return {
+            filePath: p,
+            weight: s?.weight ?? 0,
+            hub: s?.hub ?? false,
+            maxFanIn: s?.maxFanIn ?? 0,
+            unknown: unknownSet.has(p),
+        };
+    });
+    return {
+        status,
+        graphBuiltAt,
+        graphCommit,
+        workingCommit: diff.workingCommit,
+        changedFiles: diff.changed,
+        unknownFiles: score.unknownFiles,
+        perFile,
+        hubCount: score.hubCount,
+        leafCount: score.leafCount,
+        stalenessScore: score.totalScore,
+        threshold,
+        mechanism: diff.mechanism,
+        warnings: diff.warnings,
+        message,
+    };
+}
+function pad(s, n) {
+    return s + ' '.repeat(Math.max(0, n - s.length));
+}
+export function renderHuman(s) {
+    const lines = [];
+    lines.push('OpenLore preflight');
+    lines.push('──────────────────');
+    lines.push(`${pad('Graph built:', 15)}${s.graphBuiltAt ?? '(unknown)'}` +
+        (s.graphCommit ? `   commit ${s.graphCommit}` : ''));
+    lines.push(`${pad('Working tree:', 15)}${new Date().toISOString()}` +
+        (s.workingCommit ? `   commit ${s.workingCommit}` : ''));
+    if (s.changedFiles.length === 0) {
+        lines.push(`${pad('Changed files:', 15)}0`);
+    }
+    else {
+        lines.push(`${pad('Changed files:', 15)}${s.changedFiles.length} (${s.hubCount} hub, ${s.leafCount} leaf` +
+            (s.unknownFiles.length ? `, ${s.unknownFiles.length} new/untracked` : '') +
+            `)`);
+    }
+    lines.push(`${pad('Staleness:', 15)}score ${s.stalenessScore} (threshold ${s.threshold})`);
+    // Status line: STALE message wins; otherwise distinguish "FRESH" from the
+    // genuinely-empty "nothing to check" case so users can tell why CI passed.
+    let statusLine;
+    if (s.status === 'STALE') {
+        statusLine = 'STALE — ' + s.message.replace('STALE — ', '');
+    }
+    else if (s.changedFiles.length === 0) {
+        statusLine = `FRESH — ${s.message}`;
+    }
+    else {
+        statusLine = 'FRESH';
+    }
+    lines.push(`${pad('Status:', 15)}${statusLine}`);
+    if (s.warnings.length) {
+        lines.push('');
+        for (const w of s.warnings)
+            lines.push(`  warning: ${w}`);
+    }
+    // Per-file breakdown — sorted by weight DESC so hubs surface first.
+    const ranked = [...s.perFile].sort((a, b) => b.weight - a.weight);
+    if (ranked.length > 0) {
+        lines.push('');
+        const cap = 20;
+        const header = ranked.length > cap ? `Changed (showing top ${cap} of ${ranked.length}, by weight):` : 'Changed:';
+        lines.push(header);
+        for (const f of ranked.slice(0, cap)) {
+            lines.push(`  - ${formatFileLine(f)}`);
+        }
+    }
+    return lines.join('\n');
+}
+function formatFileLine(f) {
+    if (f.unknown) {
+        return `${f.filePath}  (new/untracked, weight 0)`;
+    }
+    const tags = [];
+    if (f.hub)
+        tags.push('hub');
+    if (f.maxFanIn > 0 && !f.hub)
+        tags.push(`fan-in ${f.maxFanIn}`);
+    else if (f.hub && f.maxFanIn > 0)
+        tags.push(`fan-in ${f.maxFanIn}`);
+    const tagStr = tags.length ? tags.join(', ') + ', ' : '';
+    return `${f.filePath}  (${tagStr}weight ${f.weight})`;
+}
+/**
+ * Emit GitHub Actions workflow-command annotations so that stale files
+ * appear inline in the PR diff UI when this runs in CI. No-op outside of
+ * GHA. Format docs:
+ *   https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions
+ */
+export function renderGithubAnnotations(s) {
+    if (s.status !== 'STALE')
+        return '';
+    if (process.env.GITHUB_ACTIONS !== 'true')
+        return '';
+    const lines = [];
+    // Per-file warnings — point CI users at the exact files that pushed us
+    // over the threshold. Only annotate files that contributed weight (i.e.
+    // appeared in the graph); new/untracked files have weight 0.
+    for (const f of s.changedFiles) {
+        const inGraphContributor = !s.unknownFiles.includes(f);
+        if (!inGraphContributor)
+            continue;
+        // Escape per GHA workflow-command escape rules.
+        const msg = `OpenLore graph is stale for this file — run \`openlore analyze\` to refresh`;
+        lines.push(`::warning file=${escapeAnnotation(f)}::${escapeAnnotation(msg)}`);
+    }
+    // Top-line error so the PR check fails visibly.
+    lines.push(`::error::OpenLore preflight: staleness score ${s.stalenessScore} > threshold ${s.threshold} (${s.hubCount} hub, ${s.leafCount} leaf changes). Run \`openlore analyze\`.`);
+    return lines.join('\n');
+}
+function escapeAnnotation(s) {
+    return s.replace(/%/g, '%25').replace(/\r/g, '%0D').replace(/\n/g, '%0A');
+}
+export function renderJson(s) {
+    // Schema is documented in docs/preflight.md. We deliberately ship more
+    // than the spec's minimum (status / graph_built_at / graph_commit /
+    // working_commit / changed_files / staleness_score / threshold) — the
+    // extras (`unknown_files`, `per_file`, `hub_count`, `leaf_count`,
+    // `mechanism`, `warnings`) are purely additive.
+    const payload = {
+        status: s.status,
+        graph_built_at: s.graphBuiltAt,
+        graph_commit: s.graphCommit,
+        working_commit: s.workingCommit,
+        changed_files: s.changedFiles,
+        unknown_files: s.unknownFiles,
+        per_file: s.perFile.map((f) => ({
+            file: f.filePath,
+            weight: f.weight,
+            hub: f.hub,
+            max_fan_in: f.maxFanIn,
+            unknown: f.unknown,
+        })),
+        hub_count: s.hubCount,
+        leaf_count: s.leafCount,
+        staleness_score: s.stalenessScore,
+        threshold: s.threshold,
+        mechanism: s.mechanism,
+        warnings: s.warnings,
+    };
+    return JSON.stringify(payload, null, 2);
+}
+//# sourceMappingURL=report.js.map

package/dist/cli/preflight/report.js.map

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

package/dist/cli/preflight/score.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Compute the staleness score for a set of changed files.
+ *
+ * Scoring model (deliberately simple, documented in docs/preflight.md):
+ *
+ *   per-file weight =
+ *     1                          base
+ *     + 2 if any node in the file is a hub (is_hub = 1)
+ *     + min(3, ceil(maxFanIn/5)) for the heaviest fan-in in the file
+ *
+ *   staleness_score = sum(per-file weight) over files that map to nodes in
+ *                     the graph; files not in the graph are reported but do
+ *                     not contribute to the score (we cannot reason about
+ *                     them without re-analyzing).
+ *
+ * This is intentionally a heuristic — a hub change matters more than a leaf
+ * change, but we never claim it's a true blast-radius computation. It is the
+ * cheapest signal that distinguishes "noisy editor save" from "ripped out a
+ * central module."
+ */
+export interface FileScore {
+    filePath: string;
+    /** Whether the file appears in the graph at all. */
+    inGraph: boolean;
+    /** Did the file contain at least one hub? */
+    hub: boolean;
+    /** Max fan-in across nodes in the file. */
+    maxFanIn: number;
+    /** Number of nodes in the file. */
+    nodeCount: number;
+    /** Weight contribution. */
+    weight: number;
+}
+export interface ScoreResult {
+    perFile: FileScore[];
+    totalScore: number;
+    hubCount: number;
+    leafCount: number;
+    /** Files not represented in the graph at all (e.g. new files). */
+    unknownFiles: string[];
+}
+export declare function scoreChangedFiles(repoRoot: string, changedFiles: string[]): ScoreResult;
+//# sourceMappingURL=score.d.ts.map

package/dist/cli/preflight/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../../src/cli/preflight/score.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,GAAG,EAAE,OAAO,CAAC;IACb,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAqDD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,WAAW,CA4BvF"}