vdelta 0.1.0

package/dist/canonical.js

@@ -0,0 +1,45 @@
+/**
+ * Canonical JSON serialization (spec §3.5): lexicographically sorted keys,
+ * UTF-8, no insignificant whitespace, numbers restricted to integers.
+ * Used for run_id derivation and every digest input.
+ */
+export class NonCanonicalValueError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NonCanonicalValueError';
+    }
+}
+export function canonicalJson(value) {
+    return serialize(value, '$');
+}
+function serialize(value, path) {
+    if (value === null)
+        return 'null';
+    switch (typeof value) {
+        case 'boolean':
+            return value ? 'true' : 'false';
+        case 'number':
+            if (!Number.isInteger(value)) {
+                throw new NonCanonicalValueError(`non-integer number at ${path}: ${value}`);
+            }
+            if (!Number.isSafeInteger(value)) {
+                throw new NonCanonicalValueError(`unsafe integer at ${path}: ${value}`);
+            }
+            return String(value);
+        case 'string':
+            return JSON.stringify(value);
+        case 'object': {
+            if (Array.isArray(value)) {
+                return `[${value.map((v, i) => serialize(v === undefined ? null : v, `${path}[${i}]`)).join(',')}]`;
+            }
+            const record = value;
+            const keys = Object.keys(record)
+                .filter((k) => record[k] !== undefined)
+                .sort();
+            return `{${keys.map((k) => `${JSON.stringify(k)}:${serialize(record[k], `${path}.${k}`)}`).join(',')}}`;
+        }
+        default:
+            throw new NonCanonicalValueError(`unserializable ${typeof value} at ${path}`);
+    }
+}
+//# sourceMappingURL=canonical.js.map

package/dist/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;IACtC,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;AAC9B,CAAC;AAED,SAAS,SAAS,CAAC,KAAc,EAAE,IAAY;IAC7C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAA;IACjC,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAA;QACjC,KAAK,QAAQ;YACX,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,sBAAsB,CAAC,yBAAyB,IAAI,KAAK,KAAK,EAAE,CAAC,CAAA;YAC7E,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,sBAAsB,CAAC,qBAAqB,IAAI,KAAK,KAAK,EAAE,CAAC,CAAA;YACzE,CAAC;YACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;QACtB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QAC9B,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;YACrG,CAAC;YACD,MAAM,MAAM,GAAG,KAAgC,CAAA;YAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;iBAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;iBACtC,IAAI,EAAE,CAAA;YACT,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;QACzG,CAAC;QACD;YACE,MAAM,IAAI,sBAAsB,CAAC,kBAAkB,OAAO,KAAK,OAAO,IAAI,EAAE,CAAC,CAAA;IACjF,CAAC;AACH,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,264 @@
+#!/usr/bin/env node
+/**
+ * vdelta CLI (spec §10). Exit-code contract:
+ *   run     — transparent child exit; INV-5 degrades to raw passthrough
+ *   compare — 0 when the comparison operation succeeds (inconclusive/none
+ *             results included), 1 on operation failure
+ *   show    — retrieval success (0) / not found (1)
+ *   gate    — report-only: 0 whenever a report is produced, 2 otherwise
+ * The report goes to stdout; vdelta diagnostics go to stderr only.
+ */
+import { buildComparisonReport, CompareOperationError } from './compare.js';
+import { buildGateReport, GateOperationError } from './gate.js';
+import { renderReport } from './render.js';
+import { runAndRecord, VDELTA_VERSION } from './run.js';
+import { RunStore, StoreCorruptError } from './store.js';
+import { gitRepoRoot, resolveRef } from './tree-digest.js';
+function emit(report, format) {
+    if (format === 'json') {
+        process.stdout.write(`${JSON.stringify(report, null, 1)}\n`);
+    }
+    else {
+        process.stdout.write(renderReport(report));
+    }
+}
+function parseReportFlag(args) {
+    let format = 'text';
+    const rest = [];
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === '--report') {
+            const v = args[++i];
+            if (v !== 'json' && v !== 'text')
+                die(`--report expects json|text, got ${v ?? '(none)'}`);
+            format = v;
+        }
+        else if (a.startsWith('--report=')) {
+            const v = a.slice('--report='.length);
+            if (v !== 'json' && v !== 'text')
+                die(`--report expects json|text, got ${v}`);
+            format = v;
+        }
+        else {
+            rest.push(a);
+        }
+    }
+    return { format, rest };
+}
+function die(message, code = 1) {
+    process.stderr.write(`vdelta: ${message}\n`);
+    process.exit(code);
+}
+async function requireStore() {
+    const worktree = await gitRepoRoot(process.cwd());
+    if (worktree === null)
+        die('not inside a git worktree');
+    return { store: new RunStore(worktree), worktree };
+}
+async function cmdRun(argv) {
+    const sep = argv.indexOf('--');
+    if (sep === -1)
+        die('usage: vdelta run [--report json|text] -- <command...>');
+    const { format } = parseReportFlag(argv.slice(0, sep));
+    const child = argv.slice(sep + 1);
+    if (child.length === 0)
+        die('no child command given');
+    const result = await runAndRecord(child, process.cwd());
+    for (const d of result.diagnostics)
+        process.stderr.write(`${d}\n`);
+    if (result.degraded || result.report === null) {
+        // INV-5 degraded path: verbatim raw passthrough, no report.
+        process.stdout.write(result.rawStdout);
+        process.stderr.write(result.rawStderr);
+    }
+    else {
+        emit(result.report, format);
+    }
+    process.exit(result.exitCode);
+}
+async function cmdCompare(argv) {
+    const { format, rest } = parseReportFlag(argv);
+    let ref;
+    const positional = [];
+    for (let i = 0; i < rest.length; i++) {
+        const a = rest[i];
+        if (a === '--ref') {
+            ref = rest[++i];
+            if (ref === undefined)
+                die('--ref expects a git ref');
+        }
+        else if (a.startsWith('--ref=')) {
+            ref = a.slice('--ref='.length);
+        }
+        else if (a.startsWith('-')) {
+            die(`unknown option: ${a}`);
+        }
+        else {
+            positional.push(a);
+        }
+    }
+    const { store, worktree } = await requireStore();
+    try {
+        let currentId;
+        let spec;
+        if (ref !== undefined) {
+            const resolved = await resolveRef(worktree, ref);
+            if (resolved === null)
+                die(`cannot resolve ref: ${ref}`);
+            spec = { mode: 'git-ref', ref, commit: resolved.commit, tree: resolved.tree };
+            currentId = positional[0] !== undefined ? store.resolveRunId(positional[0]) : store.lastRunId();
+        }
+        else if (positional.length === 2) {
+            spec = { mode: 'explicit-run-id', runId: positional[0] };
+            currentId = store.resolveRunId(positional[1]);
+        }
+        else if (positional.length === 0) {
+            spec = { mode: 'previous-comparable' };
+            currentId = store.lastRunId();
+        }
+        else {
+            die('usage: vdelta compare [<baseline-run> <current-run>] [--ref <git-ref>] [--report json|text]');
+        }
+        if (currentId === null)
+            die('cannot resolve the current run');
+        emit(buildComparisonReport(store, currentId, spec), format);
+        process.exit(0);
+    }
+    catch (err) {
+        if (err instanceof CompareOperationError)
+            die(err.message);
+        if (err instanceof StoreCorruptError)
+            die(`store corrupt: ${err.message}`);
+        throw err;
+    }
+}
+async function cmdShow(argv) {
+    let testId;
+    let raw = false;
+    const positional = [];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--test') {
+            testId = argv[++i];
+            if (testId === undefined)
+                die('--test expects a test id');
+        }
+        else if (a.startsWith('--test=')) {
+            testId = a.slice('--test='.length);
+        }
+        else if (a === '--raw') {
+            raw = true;
+        }
+        else if (a.startsWith('-')) {
+            die(`unknown option: ${a}`);
+        }
+        else {
+            positional.push(a);
+        }
+    }
+    if (positional.length !== 1)
+        die('usage: vdelta show <run-id> [--test <test-id> | --raw]');
+    const { store } = await requireStore();
+    const runId = store.resolveRunId(positional[0]);
+    if (runId === null)
+        die(`unknown run id: ${positional[0]}`);
+    let record;
+    try {
+        record = store.readRun(runId);
+    }
+    catch (err) {
+        if (err instanceof StoreCorruptError)
+            die(`store corrupt: ${err.message}`);
+        throw err;
+    }
+    if (raw) {
+        process.stdout.write(record.recording.raw_stdout);
+        process.stderr.write(record.recording.raw_stderr);
+        process.exit(0);
+    }
+    if (testId !== undefined) {
+        const obs = record.observations.find((o) => o.test_id === testId);
+        if (obs === undefined)
+            die(`no observation for test id: ${testId}`);
+        process.stdout.write(`${JSON.stringify(obs, null, 1)}\n`);
+        process.exit(0);
+    }
+    process.stdout.write(`${JSON.stringify(record, null, 1)}\n`);
+    process.exit(0);
+}
+async function cmdGate(argv) {
+    const { format, rest } = parseReportFlag(argv);
+    let ref;
+    let runId;
+    let policy = 'report-only';
+    for (let i = 0; i < rest.length; i++) {
+        const a = rest[i];
+        if (a === '--ref')
+            ref = rest[++i];
+        else if (a.startsWith('--ref='))
+            ref = a.slice('--ref='.length);
+        else if (a === '--run')
+            runId = rest[++i];
+        else if (a.startsWith('--run='))
+            runId = a.slice('--run='.length);
+        else if (a === '--policy')
+            policy = rest[++i] ?? '';
+        else if (a.startsWith('--policy='))
+            policy = a.slice('--policy='.length);
+        else
+            die(`unknown option: ${a}`, 2);
+    }
+    if (policy !== 'report-only') {
+        die(`policy "${policy}" is not implemented in this MVP (report-only only, §11.1)`, 2);
+    }
+    if (ref === undefined)
+        die('usage: vdelta gate --ref <git-ref> [--run <run-id>] [--policy report-only]', 2);
+    const worktree = await gitRepoRoot(process.cwd());
+    if (worktree === null)
+        die('not inside a git worktree', 2);
+    const store = new RunStore(worktree);
+    try {
+        const report = await buildGateReport(store, {
+            worktree,
+            ref,
+            ...(runId !== undefined ? { runId } : {}),
+        });
+        emit(report, format);
+        process.exit(0);
+    }
+    catch (err) {
+        if (err instanceof GateOperationError)
+            die(err.message, 2);
+        if (err instanceof StoreCorruptError)
+            die(`store corrupt: ${err.message}`, 2);
+        throw err;
+    }
+}
+async function main() {
+    const [, , command, ...argv] = process.argv;
+    switch (command) {
+        case 'run':
+            return cmdRun(argv);
+        case 'compare':
+            return cmdCompare(argv);
+        case 'show':
+            return cmdShow(argv);
+        case 'gate':
+            return cmdGate(argv);
+        case '--version':
+        case 'version':
+            process.stdout.write(`vdelta ${VDELTA_VERSION} (veridelta/1)\n`);
+            return process.exit(0);
+        default:
+            die(`usage: vdelta <run|compare|show|gate> ...\n` +
+                `  run [--report json|text] -- <command...>\n` +
+                `  compare [<baseline-run> <current-run>] [--ref <git-ref>] [--report json|text]\n` +
+                `  show <run-id> [--test <test-id> | --raw]\n` +
+                `  gate --ref <git-ref> [--run <run-id>] [--policy report-only] [--report json|text]`);
+    }
+}
+main().catch((err) => {
+    process.stderr.write(`vdelta: internal error: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/compare.d.ts

@@ -0,0 +1,37 @@
+import { RunStore } from './store.js';
+import { type BaselineMode, type ComparabilityDetail, type ComparisonReport, type RunRecord } from './schema.js';
+export type BaselineSpec = {
+    mode: 'previous-comparable';
+} | {
+    mode: 'explicit-run-id';
+    runId: string;
+} | {
+    mode: 'git-ref';
+    ref: string;
+    commit: string;
+    tree: string;
+};
+export declare class CompareOperationError extends Error {
+    constructor(message: string);
+}
+/** Stream key (§5.1): repo + worktree + branch + cwd + command + selector + instrument. */
+export declare function streamKey(r: RunRecord): string;
+export interface BaselineResolution {
+    record: RunRecord | null;
+    runId: string | null;
+    mode: BaselineMode;
+    selectionReason: string;
+    failure?: ComparabilityDetail;
+}
+/**
+ * Resolve the baseline per §5.2. Selection is content-addressed and
+ * explainable; recency is index insertion order, never timestamps (§7.8).
+ */
+export declare function resolveBaseline(store: RunStore, current: RunRecord, currentId: string, spec: BaselineSpec): BaselineResolution;
+/**
+ * Build the full comparison report for a current run against a baseline spec.
+ * Store-level corruption during baseline resolution degrades to a
+ * `store-corrupt`/`failed` abstention (fail-closed comparison, §6.3) — the
+ * report is still produced.
+ */
+export declare function buildComparisonReport(store: RunStore, currentId: string, spec: BaselineSpec): ComparisonReport;