openlore 2.0.1 → 2.0.3

package/dist/cli/manifest/schema-validator.js

@@ -0,0 +1,77 @@
+/**
+ * A deliberately tiny JSON Schema validator — just the subset used by
+ * schemas/openlore-manifest-v1.json. Avoids pulling in Ajv (a large dep) for a
+ * single internal schema, per spec-05's acceptance criteria.
+ *
+ * Supported keywords: type (string or array incl. "null"), const, enum,
+ * required, properties, additionalProperties (false only), items. The
+ * `integer` type is distinguished from `number`.
+ */
+function typeOf(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'array';
+    if (Number.isInteger(value))
+        return 'integer';
+    return typeof value; // 'number' | 'string' | 'boolean' | 'object'
+}
+/** Returns true if `value` satisfies a single JSON Schema `type` token. */
+function matchesType(value, type) {
+    const actual = typeOf(value);
+    if (type === 'number')
+        return actual === 'number' || actual === 'integer';
+    return actual === type;
+}
+function validateNode(value, schema, path, errors) {
+    // const
+    if ('const' in schema && value !== schema.const) {
+        errors.push({ path, message: `expected const ${JSON.stringify(schema.const)}, got ${JSON.stringify(value)}` });
+        return;
+    }
+    // type
+    if ('type' in schema) {
+        const types = Array.isArray(schema.type) ? schema.type : [schema.type];
+        if (!types.some(t => matchesType(value, t))) {
+            errors.push({ path, message: `expected type ${types.join('|')}, got ${typeOf(value)}` });
+            return;
+        }
+    }
+    // null short-circuits remaining checks
+    if (value === null)
+        return;
+    // enum
+    if (Array.isArray(schema.enum) && !schema.enum.includes(value)) {
+        errors.push({ path, message: `value ${JSON.stringify(value)} not in enum ${JSON.stringify(schema.enum)}` });
+    }
+    // object
+    if (typeOf(value) === 'object') {
+        const obj = value;
+        const props = schema.properties ?? {};
+        for (const req of schema.required ?? []) {
+            if (!(req in obj))
+                errors.push({ path: `${path}/${req}`, message: 'missing required property' });
+        }
+        if (schema.additionalProperties === false) {
+            for (const key of Object.keys(obj)) {
+                if (!(key in props))
+                    errors.push({ path: `${path}/${key}`, message: 'additional property not allowed' });
+            }
+        }
+        for (const [key, subSchema] of Object.entries(props)) {
+            if (key in obj)
+                validateNode(obj[key], subSchema, `${path}/${key}`, errors);
+        }
+    }
+    // array
+    if (typeOf(value) === 'array' && schema.items) {
+        value.forEach((item, i) => validateNode(item, schema.items, `${path}/${i}`, errors));
+    }
+}
+/** Validate a parsed JSON value against a parsed JSON Schema. */
+export function validateAgainstSchema(value, schema) {
+    const errors = [];
+    validateNode(value, schema, '', errors);
+    return errors;
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/cli/manifest/schema-validator.js.map

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

package/dist/cli/manifest/validate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `openlore manifest validate <path>` — schema-check an existing manifest.
+ *
+ * Validates against the canonical JSON Schema shipped with OpenLore
+ * (schemas/openlore-manifest-v1.json), using the small in-repo validator
+ * rather than a heavyweight dependency.
+ */
+import { type ValidationError } from './schema-validator.js';
+/** Absolute path to the vendored manifest JSON Schema (ships in the package). */
+export declare function manifestSchemaPath(): string;
+export declare function loadManifestSchema(): Record<string, unknown>;
+/** Validate a parsed manifest object; returns the (possibly empty) error list. */
+export declare function validateManifest(manifest: unknown): ValidationError[];
+export declare function runManifestValidate(path: string): number;
+//# sourceMappingURL=validate.d.ts.map

package/dist/cli/manifest/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/manifest/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEpF,iFAAiF;AACjF,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE5D;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,eAAe,EAAE,CAErE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA0BxD"}

package/dist/cli/manifest/validate.js

@@ -0,0 +1,51 @@
+/**
+ * `openlore manifest validate <path>` — schema-check an existing manifest.
+ *
+ * Validates against the canonical JSON Schema shipped with OpenLore
+ * (schemas/openlore-manifest-v1.json), using the small in-repo validator
+ * rather than a heavyweight dependency.
+ */
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { logger } from '../../utils/logger.js';
+import { validateAgainstSchema } from './schema-validator.js';
+/** Absolute path to the vendored manifest JSON Schema (ships in the package). */
+export function manifestSchemaPath() {
+    // src/cli/manifest/validate.ts → repo root → schemas/ (same depth in dist/).
+    return fileURLToPath(new URL('../../../schemas/openlore-manifest-v1.json', import.meta.url));
+}
+export function loadManifestSchema() {
+    return JSON.parse(readFileSync(manifestSchemaPath(), 'utf-8'));
+}
+/** Validate a parsed manifest object; returns the (possibly empty) error list. */
+export function validateManifest(manifest) {
+    return validateAgainstSchema(manifest, loadManifestSchema());
+}
+export function runManifestValidate(path) {
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf-8');
+    }
+    catch {
+        logger.error(`Cannot read manifest: ${path}`);
+        return 2;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        logger.error(`Invalid JSON in ${path}: ${err instanceof Error ? err.message : String(err)}`);
+        return 1;
+    }
+    const errors = validateManifest(parsed);
+    if (errors.length === 0) {
+        logger.success(`${path} is a valid OpenLore manifest (v1).`);
+        return 0;
+    }
+    logger.error(`${path} failed schema validation (${errors.length} error(s)):`);
+    for (const e of errors)
+        logger.error(`  ${e.path || '/'}: ${e.message}`);
+    return 1;
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/manifest/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/cli/manifest/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAwB,MAAM,uBAAuB,CAAC;AAEpF,iFAAiF;AACjF,MAAM,UAAU,kBAAkB;IAChC,6EAA6E;IAC7E,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,4CAA4C,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,kBAAkB,EAAE,EAAE,OAAO,CAAC,CAA4B,CAAC;AAC5F,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,gBAAgB,CAAC,QAAiB;IAChD,OAAO,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,mBAAmB,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7F,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,qCAAqC,CAAC,CAAC;QAC7D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,8BAA8B,MAAM,CAAC,MAAM,aAAa,CAAC,CAAC;IAC9E,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,OAAO,CAAC,CAAC;AACX,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * 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.
+ */
+export interface DiffResult {
+    /** Repo-relative paths of files that may have changed since graph build. */
+    changed: string[];
+    /** Which mechanism produced the list. */
+    mechanism: 'git' | 'mtime';
+    /** Any non-fatal warnings (e.g. "no .git found, used mtime"). */
+    warnings: string[];
+    /** The short commit hash of HEAD at the moment of the check, if available. */
+    workingCommit: string | null;
+}
+export interface DiffOptions {
+    repoRoot: string;
+    /** Iso8601 timestamp the graph was built — used by mtime fallback. */
+    graphBuiltAt: string | null;
+    /** Optional git ref to diff against (e.g. "origin/main"). */
+    since?: string;
+}
+export declare function hasGitDirectory(repoRoot: string): Promise<boolean>;
+export declare function refExists(repoRoot: string, ref: string): Promise<boolean>;
+export declare function computeDiff(opts: DiffOptions): Promise<DiffResult>;
+/** Read `fingerprint.json` if present. */
+export declare function readGraphFingerprint(repoRoot: string): Promise<{
+    computedAt: string | null;
+    fileCount: number | null;
+} | null>;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/cli/preflight/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,MAAM,WAAW,UAAU;IACzB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yCAAyC;IACzC,SAAS,EAAE,KAAK,GAAG,OAAO,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8EAA8E;IAC9E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOxE;AAOD,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/E;AAsED,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAwCxE;AAED,0CAA0C;AAC1C,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACpE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,IAAI,CAAC,CAYR"}

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"}