@junejuly-lockstep/reconciler 0.1.0

package/dist/reconcile.js

@@ -0,0 +1,316 @@
+import { execFileSync } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { createIngestClient, LockstepApiError } from '@junejuly-lockstep/sdk';
+import { API_KEY_ENV, checkContract, assertContract, loadConfig, } from './config.js';
+import { snapshotContract } from './contract.js';
+import { compareHashMaps, formatDeterminismReport, hashPngs } from './determinism.js';
+import { ContractViolation, InfrastructureError } from './errors.js';
+import { EXIT, exitCodeForResult } from './exitCodes.js';
+import { extractGraph } from './extract.js';
+import { loadJourneys, loadScenarios } from './journeys.js';
+import { assembleRunPayload, summarize } from './report.js';
+import { collectArtifacts, uploadArtifacts } from './upload.js';
+import { ensureDir, reconcilerVersion } from './util.js';
+import { compareWalk, downloadBaselines } from './visual.js';
+import { walk } from './walk.js';
+const SHA_RE = /^[0-9a-f]{7,40}$/;
+export function resolveCommitSha(ref, cwd, env = process.env) {
+    const candidate = ref ?? env['GITHUB_SHA'] ?? gitExec(cwd, ['rev-parse', 'HEAD']);
+    if (!candidate)
+        throw new InfrastructureError('could not determine the commit SHA; pass --ref <sha>');
+    const sha = candidate.trim().toLowerCase();
+    if (!SHA_RE.test(sha))
+        throw new InfrastructureError(`--ref must be a commit SHA (7-40 hex chars), got "${candidate}"`);
+    return sha;
+}
+export const API_BASE_URL_ENV = 'LOCKSTEP_API_BASE_URL';
+/** `--api-base-url`, then `LOCKSTEP_API_BASE_URL`, then the config; must be an http(s) URL. */
+export function resolveApiBaseUrl(override, fromConfig, env = process.env) {
+    const candidate = (override ?? env[API_BASE_URL_ENV] ?? '').trim();
+    if (!candidate)
+        return fromConfig;
+    let url;
+    try {
+        url = new URL(candidate);
+    }
+    catch {
+        throw new InfrastructureError(`--api-base-url must be an absolute http(s) URL, got "${candidate}"`);
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:')
+        throw new InfrastructureError(`--api-base-url must be an http(s) URL, got "${candidate}"`);
+    return candidate.replace(/\/+$/, '');
+}
+/** Run git and return trimmed stdout, or null when git or the ref is unavailable. */
+export function gitExec(cwd, args) {
+    try {
+        return execFileSync('git', args, {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** `git show <ref>:<path>`, or null when the ref or file does not exist. */
+export function gitShowFile(cwd, ref, file) {
+    // `./` makes the path relative to cwd (the config dir) rather than the repository root.
+    return gitExec(cwd, ['show', `${ref}:./${file.replace(/\\/g, '/')}`]);
+}
+/** The whole pipeline, in SPEC order. Throws ContractViolation or InfrastructureError. */
+export async function reconcile(opts) {
+    const log = opts.log ?? ((line) => console.log(line));
+    const now = opts.deps?.now ?? (() => new Date());
+    const cwd = opts.cwd ?? process.cwd();
+    const dryRun = opts.dryRun ?? false;
+    const startedAt = now();
+    // 1. Contract.
+    const loaded = await loadConfig(opts.configPath, cwd);
+    const { config, rootDir } = loaded;
+    const report = await checkContract(loaded, { requireApiKey: !dryRun });
+    for (const w of report.warnings)
+        log(`warning: ${w}`);
+    assertContract(report);
+    const outDir = path.resolve(rootDir, opts.outDir ?? '.lockstep');
+    const artifactsDir = path.join(outDir, 'artifacts');
+    rmSync(artifactsDir, { recursive: true, force: true });
+    ensureDir(artifactsDir);
+    // Every file below describes this run only; a previous run's leftovers must not survive it.
+    for (const stale of [
+        'artifacts-determinism',
+        'determinism.txt',
+        'ingest-response.json',
+        'run-payload.json',
+        'walk.json',
+    ])
+        rmSync(path.join(outDir, stale), { recursive: true, force: true });
+    const commitSha = resolveCommitSha(opts.ref, rootDir);
+    const prNumber = opts.kind === 'pr' ? (opts.pr ?? prFromEnv()) : null;
+    if (opts.kind === 'pr' && prNumber === null) {
+        throw new ContractViolation('run:pr', 'PR runs need --pr <number> (or GITHUB_REF of the form refs/pull/<n>/merge)');
+    }
+    log(`lockstep reconcile ${reconcilerVersion()}  ${config.projectKey}  ${opts.kind}  ${commitSha.slice(0, 12)}  ${opts.env}${dryRun ? '  (dry run)' : ''}`);
+    const apiBaseUrl = resolveApiBaseUrl(opts.apiBaseUrl, config.apiBaseUrl);
+    if (apiBaseUrl !== config.apiBaseUrl)
+        log(`api: ${apiBaseUrl} (overriding ${config.apiBaseUrl} from the config)`);
+    const client = dryRun
+        ? (opts.deps?.client ?? null)
+        : (opts.deps?.client ??
+            createIngestClient({
+                baseUrl: apiBaseUrl,
+                apiKey: process.env[API_KEY_ENV],
+                fetch: opts.deps?.fetch,
+            }));
+    // 2. Journeys and scenarios.
+    const journeys = (await loadJourneys(rootDir, config.journeysGlob)).map((j) => j.model);
+    const scenarios = await loadScenarios(rootDir, config.scenariosPath);
+    log(`journeys: ${journeys.map((j) => j.key).join(', ')}; scenarios: ${scenarios.map((s) => s.name).join(', ')}`);
+    // 3. Extract.
+    const extractedGraph = await extractGraph({ rootDir });
+    writeJson(path.join(outDir, 'extracted-graph.json'), extractedGraph);
+    log(`extracted ${extractedGraph.routes.length} routes, ${extractedGraph.navigations.length} navigations (${extractedGraph.unresolvedCount} unresolved)`);
+    // 4. Contract snapshot.
+    const previousSdl = config.schema
+        ? gitShowFile(rootDir, opts.baseRef ?? 'HEAD~1', config.schema.sdlPath)
+        : null;
+    const contract = await snapshotContract({ rootDir, schema: config.schema, outDir, previousSdl });
+    writeJson(path.join(outDir, 'contract-snapshot.json'), contract.snapshot);
+    if (contract.changes)
+        log(`contract: ${contract.changes.length} schema changes vs ${opts.baseRef ?? 'HEAD~1'} (see contract-changes.md)`);
+    // 5. Baselines (before the walk).
+    let manifest = null;
+    let baselines = new Map();
+    if (client) {
+        manifest = await fetchManifest(client, config.projectKey, log);
+        if (manifest) {
+            baselines = await downloadBaselines(manifest, path.join(outDir, 'baselines'), opts.deps?.fetch ?? fetch, log);
+            log(`baselines: ${manifest.entries.length}`);
+        }
+    }
+    // 6. Walk.
+    const walkArgs = {
+        journeys,
+        scenarios,
+        config,
+        rootDir,
+        log,
+        deps: opts.deps?.walk,
+        noBoot: opts.deps?.noBoot,
+    };
+    const walkResult = await walk({ ...walkArgs, artifactsDir });
+    writeJson(path.join(outDir, 'walk.json'), walkResult);
+    if (opts.determinismCheck) {
+        const secondDir = path.join(outDir, 'artifacts-determinism');
+        rmSync(secondDir, { recursive: true, force: true });
+        ensureDir(secondDir);
+        log('determinism check: walking a second time');
+        await walk({ ...walkArgs, artifactsDir: secondDir });
+        const comparison = compareHashMaps(await hashPngs(path.join(artifactsDir, 'shots')), await hashPngs(path.join(secondDir, 'shots')));
+        const text = formatDeterminismReport(comparison);
+        writeFileSync(path.join(outDir, 'determinism.txt'), text + '\n');
+        log(text);
+        if (!comparison.deterministic) {
+            throw new InfrastructureError(`determinism check failed: ${comparison.different.length + comparison.onlyInFirst.length + comparison.onlyInSecond.length} screenshots differ between two walks of the same commit and seed`);
+        }
+    }
+    // 7. Visual diff.
+    const visual = compareWalk({ walk: walkResult, manifest, artifactsDir, baselines });
+    // 8. Upload.
+    let runId;
+    let keyFor;
+    if (client && !dryRun) {
+        const files = await collectArtifacts(artifactsDir);
+        const upload = await uploadArtifacts({ client, files, fetchImpl: opts.deps?.fetch, log });
+        runId = upload.runId;
+        keyFor = (rel) => upload.keys.get(rel) ?? `${upload.prefix}${rel}`;
+        log(`uploaded ${upload.uploaded} artifacts under ${upload.prefix}`);
+    }
+    else {
+        runId = randomUUID();
+        keyFor = (rel) => `runs/${runId}/${rel}`;
+    }
+    // 9. Payload.
+    const payload = assembleRunPayload({
+        projectKey: config.projectKey,
+        kind: opts.kind,
+        commitSha,
+        prNumber,
+        deployLabel: opts.deployLabel ?? null,
+        env: opts.env,
+        startedAt,
+        finishedAt: now(),
+        journeys,
+        scenarios,
+        extractedGraph,
+        contract: contract.snapshot,
+        walk: walkResult,
+        visual,
+        declaredSeams: opts.declaredSeams ?? [],
+        runId,
+        keyFor,
+    });
+    writeJson(path.join(outDir, 'run-payload.json'), payload);
+    // 10. Post.
+    let response = null;
+    if (client && !dryRun) {
+        try {
+            response = await client.postRun(payload);
+        }
+        catch (err) {
+            throw new InfrastructureError('posting the run to /api/ingest/runs failed', err);
+        }
+        writeJson(path.join(outDir, 'ingest-response.json'), response);
+    }
+    log(summarize(payload, {
+        visualDiffThreshold: config.visualDiffThreshold,
+        response,
+        dryRun,
+        outDir,
+    }));
+    const exitCode = response
+        ? exitCodeForResult({
+            judgmentCount: response.judgmentCount,
+            kind: opts.kind,
+            failOnVerdicts: opts.failOnVerdicts,
+        })
+        : EXIT.CLEAN;
+    return { payload, response, exitCode, outDir };
+}
+async function fetchManifest(client, projectKey, log) {
+    try {
+        return await client.getBaselines(projectKey);
+    }
+    catch (err) {
+        if (err instanceof LockstepApiError && err.status === 404) {
+            log('baselines: none yet (404)');
+            return null;
+        }
+        throw new InfrastructureError('fetching the baseline manifest failed', err);
+    }
+}
+function prFromEnv(env = process.env) {
+    const m = /^refs\/pull\/(\d+)\//.exec(env['GITHUB_REF'] ?? '');
+    return m ? Number(m[1]) : null;
+}
+function writeJson(file, data) {
+    ensureDir(path.dirname(file));
+    writeFileSync(file, JSON.stringify(data, null, 2) + '\n');
+}
+/** `lockstep validate`: contract only, no walk. Returns a printable checklist and whether it passed. */
+export async function validate(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const lines = [];
+    const mark = (ok, text) => lines.push(`${ok ? '  ok  ' : '  FAIL'} ${text}`);
+    let ok = true;
+    let loaded;
+    try {
+        loaded = await loadConfig(opts.configPath, cwd);
+        mark(true, `lockstep.config.ts valid (project ${loaded.config.projectKey}, ${loaded.config.seams.length} seams)`);
+    }
+    catch (err) {
+        if (err instanceof ContractViolation)
+            for (const i of err.items)
+                mark(false, `[${i.item}] ${i.message}`);
+        else
+            mark(false, String(err));
+        return { ok: false, lines };
+    }
+    const report = await checkContract(loaded, { requireApiKey: !opts.offline });
+    for (const v of report.violations)
+        mark(false, `[${v.item}] ${v.message}`);
+    for (const w of report.warnings)
+        lines.push(`  warn  ${w}`);
+    if (report.journeyFiles.length)
+        mark(true, `${report.journeyFiles.length} journey file(s): ${report.journeyFiles.join(', ')}`);
+    if (!report.violations.some((v) => v.item === 'scenarios'))
+        mark(true, `scenarios file ${loaded.config.scenariosPath}`);
+    if (!report.violations.some((v) => v.item === 'workflow'))
+        mark(true, '.github/workflows/lockstep-reconcile.yml present');
+    if (!opts.offline && !report.violations.some((v) => v.item === 'apiKey'))
+        mark(true, `${API_KEY_ENV} set`);
+    ok = report.violations.length === 0;
+    try {
+        const journeys = await loadJourneys(loaded.rootDir, loaded.config.journeysGlob);
+        for (const j of journeys) {
+            mark(true, `journey ${j.model.key}: ${Object.keys(j.model.machine.states).length} states, ${j.model.meta.bindings.length} bindings (${j.file})`);
+        }
+    }
+    catch (err) {
+        ok = false;
+        if (err instanceof ContractViolation)
+            for (const i of err.items)
+                mark(false, `[${i.item}] ${i.message}`);
+        else
+            mark(false, String(err));
+    }
+    try {
+        const scenarios = await loadScenarios(loaded.rootDir, loaded.config.scenariosPath);
+        mark(true, `scenarios: ${scenarios.map((s) => `${s.name} (seed ${s.seed})`).join(', ')}`);
+    }
+    catch (err) {
+        ok = false;
+        if (err instanceof ContractViolation)
+            for (const i of err.items)
+                mark(false, `[${i.item}] ${i.message}`);
+        else
+            mark(false, String(err));
+    }
+    if (loaded.config.schema) {
+        const sdl = path.resolve(loaded.rootDir, loaded.config.schema.sdlPath);
+        const codegen = path.resolve(loaded.rootDir, loaded.config.schema.codegenOutput);
+        mark(existsSync(sdl), `schema SDL ${loaded.config.schema.sdlPath}`);
+        mark(existsSync(codegen), `codegen output ${loaded.config.schema.codegenOutput}`);
+        ok = ok && existsSync(sdl) && existsSync(codegen);
+    }
+    else {
+        lines.push('  warn  no schema configured; contract snapshot will be empty');
+    }
+    const lock = ['pnpm-lock.yaml', 'package-lock.json', 'yarn.lock'].find((f) => existsSync(path.join(loaded.rootDir, f)));
+    lines.push(lock ? `  ok   lockfile ${lock}` : '  warn  no lockfile found; lockfile hash will be "none"');
+    return { ok, lines };
+}
+export { readFileSync as _readFileSync };
+//# sourceMappingURL=reconcile.js.map

package/dist/reconcile.js.map

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

package/dist/report.d.ts

@@ -0,0 +1,33 @@
+import { RunPayload, type ContractSnapshot, type Env, type ExtractedGraph, type IngestRunResponse, type JourneyModel, type RunKind, type Scenario, type VisualComparison, type WalkResult } from '@junejuly-lockstep/model';
+export interface RunParts {
+    projectKey: string;
+    kind: RunKind;
+    commitSha: string;
+    prNumber: number | null;
+    deployLabel: string | null;
+    env: Env;
+    startedAt: Date;
+    finishedAt: Date;
+    journeys: JourneyModel[];
+    scenarios: Scenario[];
+    extractedGraph: ExtractedGraph;
+    contract: ContractSnapshot;
+    walk: WalkResult;
+    visual: VisualComparison[];
+    declaredSeams?: string[];
+    runId: string;
+    /** Map an artifact-relative path (shots/..., traces/..., diffs/...) to its S3 key. */
+    keyFor: (relPath: string) => string;
+    reconcilerVersion?: string;
+}
+/** Assemble and validate the payload posted to POST /api/ingest/runs. */
+export declare function assembleRunPayload(parts: RunParts): RunPayload;
+export interface SummaryOptions {
+    visualDiffThreshold: number;
+    response: IngestRunResponse | null;
+    dryRun: boolean;
+    outDir: string;
+}
+/** Plain-text summary table for CI logs. */
+export declare function summarize(payload: RunPayload, opts: SummaryOptions): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,GAAG,EACR,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;IACjB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,CAsC9D;AAED,MAAM,WAAW,cAAc;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CA8D3E"}

package/dist/report.js

@@ -0,0 +1,97 @@
+import { RunPayload, } from '@junejuly-lockstep/model';
+import { reconcilerVersion } from './util.js';
+/** Assemble and validate the payload posted to POST /api/ingest/runs. */
+export function assembleRunPayload(parts) {
+    const walk = {
+        ...parts.walk,
+        paths: parts.walk.paths.map((p) => ({
+            ...p,
+            steps: p.steps.map((s) => ({
+                ...s,
+                screenshotKey: s.screenshotKey ? parts.keyFor(s.screenshotKey) : null,
+                traceKey: s.traceKey ? parts.keyFor(s.traceKey) : null,
+            })),
+        })),
+    };
+    const visual = parts.visual.map((v) => ({
+        ...v,
+        screenshotKey: parts.keyFor(v.screenshotKey),
+        diffKey: v.diffKey ? parts.keyFor(v.diffKey) : null,
+    }));
+    return RunPayload.parse({
+        schemaVersion: 1,
+        projectKey: parts.projectKey,
+        kind: parts.kind,
+        ref: parts.kind === 'pr' && parts.prNumber !== null ? String(parts.prNumber) : parts.commitSha,
+        commitSha: parts.commitSha,
+        prNumber: parts.prNumber,
+        deployLabel: parts.deployLabel,
+        env: parts.env,
+        reconcilerVersion: parts.reconcilerVersion ?? reconcilerVersion(),
+        startedAt: parts.startedAt.toISOString(),
+        finishedAt: parts.finishedAt.toISOString(),
+        journeys: parts.journeys,
+        scenarios: parts.scenarios,
+        extractedGraph: parts.extractedGraph,
+        contract: parts.contract,
+        walk,
+        visual,
+        declaredSeams: parts.declaredSeams ?? [],
+        runId: parts.runId,
+    });
+}
+function row(label, value) {
+    return `  ${label.padEnd(22)} ${value}`;
+}
+/** Plain-text summary table for CI logs. */
+export function summarize(payload, opts) {
+    const steps = payload.walk.paths.flatMap((p) => p.steps);
+    const count = (status) => steps.filter((s) => s.status === status).length;
+    const changed = payload.visual.filter((v) => v.baselineKey && v.score > opts.visualDiffThreshold);
+    const noBaseline = payload.visual.filter((v) => !v.baselineKey).length;
+    const lines = [
+        '',
+        `Lockstep reconcile  ${payload.projectKey}  ${payload.kind}  ${payload.commitSha.slice(0, 12)}${payload.prNumber ? `  PR #${payload.prNumber}` : ''}  ${payload.env}${payload.deployLabel ? `  ${payload.deployLabel}` : ''}`,
+        row('run id', payload.runId + (opts.dryRun ? '  (dry run, not posted)' : '')),
+        row('journeys', payload.journeys.map((j) => j.key).join(', ') || '-'),
+        row('scenarios', payload.scenarios.map((s) => s.name).join(', ') || '-'),
+        row('routes extracted', payload.extractedGraph.routes.length),
+        row('navigations', `${payload.extractedGraph.navigations.length} (${payload.extractedGraph.unresolvedCount} unresolved)`),
+        row('contract', `sdl ${short(payload.contract.sdlHash)}  ops ${Object.keys(payload.contract.operations).length}  lock ${short(payload.contract.lockfileHash)}`),
+        row('paths walked', payload.walk.paths.length),
+        row('steps', `${count('pass')} pass, ${count('fail')} fail, ${count('skipped')} skipped`),
+        row('screenshots', `${payload.visual.length} compared, ${changed.length} changed (> ${opts.visualDiffThreshold}), ${noBaseline} without baseline`),
+    ];
+    const failures = steps.filter((s) => s.status === 'fail');
+    if (failures.length) {
+        lines.push('', '  failed steps:');
+        for (const p of payload.walk.paths) {
+            for (const s of p.steps) {
+                if (s.status !== 'fail')
+                    continue;
+                const t = s.transition
+                    ? `${s.transition.from} --${s.transition.event}--> ${s.transition.to}`
+                    : `initial ${s.stateKey}`;
+                lines.push(`    ${p.journeyKey}/${p.scenario}: ${t}${s.error ? ` (${s.error})` : ''}`);
+            }
+        }
+    }
+    if (changed.length) {
+        lines.push('', '  visual changes:');
+        for (const v of changed)
+            lines.push(`    ${v.journeyKey}/${v.stateKey}/${v.scenario}: ${(v.score * 100).toFixed(3)}% pixels`);
+    }
+    if (opts.response) {
+        const vc = Object.entries(opts.response.verdictCounts)
+            .sort()
+            .map(([k, v]) => `${k} ${v}`)
+            .join(', ');
+        lines.push('', row('ingest status', opts.response.status), row('verdicts', vc || '-'), row('needs judgment', opts.response.judgmentCount), row('cards created', opts.response.cardsCreated.join(', ') || '-'));
+    }
+    lines.push(row('local output', opts.outDir), '');
+    return lines.join('\n');
+}
+function short(hash) {
+    return hash.length > 12 ? hash.slice(0, 12) : hash;
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

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

package/dist/sync.d.ts

@@ -0,0 +1,46 @@
+import { ModelSyncPayload, type ModelSyncResponse } from '@junejuly-lockstep/model';
+import { type IngestClient } from '@junejuly-lockstep/sdk';
+import { type ExitCode } from './exitCodes.js';
+/**
+ * `lockstep sync-models` (M3).
+ *
+ * Design decision (locked): the platform never executes client code, and journey files are
+ * TypeScript, so the API cannot evaluate them from a GitHub webhook. Model sync therefore runs
+ * here, in the client's CI on every push to the default branch: load the config, journeys and
+ * scenarios with the same loaders `reconcile` uses (same ordering, same validation), build a
+ * `ModelSyncPayload`, and post it to `POST /api/ingest/models`. The webhook only tells the
+ * platform that a newer commit exists; this command is what delivers the models.
+ */
+export interface SyncModelsOptions {
+    /** Commit SHA; defaults to GITHUB_SHA, then `git rev-parse HEAD`. */
+    ref?: string;
+    /** Branch name; defaults to GITHUB_REF_NAME (branch pushes only), then the checked-out branch. */
+    branch?: string;
+    /** Commit time (ISO 8601); defaults to the commit's committer date, then now. */
+    pushedAt?: string;
+    configPath?: string;
+    outDir?: string;
+    /** Load, validate and write the payload locally; no API call. */
+    dryRun?: boolean;
+    cwd?: string;
+    log?: (line: string) => void;
+    env?: NodeJS.ProcessEnv;
+    /** Test seams. */
+    deps?: {
+        client?: IngestClient;
+        fetch?: typeof fetch;
+        now?: () => Date;
+    };
+}
+export interface SyncModelsResult {
+    payload: ModelSyncPayload;
+    response: ModelSyncResponse | null;
+    exitCode: ExitCode;
+    outDir: string;
+}
+/** Branch under sync: explicit, then GitHub's `GITHUB_REF_NAME` for branch refs, then git HEAD. */
+export declare function resolveBranch(branch: string | undefined, cwd: string, env?: NodeJS.ProcessEnv): string;
+/** Commit time as ISO 8601 UTC: explicit, then the committer date from git, then `now`. */
+export declare function resolvePushedAt(pushedAt: string | undefined, cwd: string, sha: string, now?: () => Date): string;
+export declare function syncModels(opts: SyncModelsOptions): Promise<SyncModelsResult>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACpF,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AASjG,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAKrD;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,kBAAkB;IAClB,IAAI,CAAC,EAAE;QACL,MAAM,CAAC,EAAE,YAAY,CAAC;QACtB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;QACrB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mGAAmG;AACnG,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAWR;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,IAAuB,GACjC,MAAM,CAWR;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmFnF"}

package/dist/sync.js

@@ -0,0 +1,110 @@
+import { writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { ModelSyncPayload } from '@junejuly-lockstep/model';
+import { createIngestClient, LockstepApiError } from '@junejuly-lockstep/sdk';
+import { API_KEY_ENV, assertContract, checkContract, loadConfig, } from './config.js';
+import { ContractViolation, InfrastructureError } from './errors.js';
+import { EXIT } from './exitCodes.js';
+import { loadJourneys, loadScenarios } from './journeys.js';
+import { gitExec, resolveCommitSha } from './reconcile.js';
+import { ensureDir, reconcilerVersion } from './util.js';
+/** Branch under sync: explicit, then GitHub's `GITHUB_REF_NAME` for branch refs, then git HEAD. */
+export function resolveBranch(branch, cwd, env = process.env) {
+    const explicit = branch?.trim();
+    if (explicit)
+        return explicit.replace(/^refs\/heads\//, '');
+    const ref = env['GITHUB_REF'];
+    if (ref?.startsWith('refs/heads/'))
+        return ref.slice('refs/heads/'.length);
+    if (env['GITHUB_REF_TYPE'] === 'branch' && env['GITHUB_REF_NAME'])
+        return env['GITHUB_REF_NAME'];
+    const head = gitExec(cwd, ['rev-parse', '--abbrev-ref', 'HEAD']);
+    if (head && head !== 'HEAD')
+        return head;
+    throw new InfrastructureError('could not determine the branch (detached HEAD or not a git checkout); pass --branch <name>');
+}
+/** Commit time as ISO 8601 UTC: explicit, then the committer date from git, then `now`. */
+export function resolvePushedAt(pushedAt, cwd, sha, now = () => new Date()) {
+    const candidate = pushedAt ?? gitExec(cwd, ['show', '-s', '--format=%cI', sha]) ?? undefined;
+    if (candidate !== undefined) {
+        const d = new Date(candidate);
+        if (Number.isNaN(d.getTime()))
+            throw new InfrastructureError(`--pushed-at must be an ISO 8601 timestamp, got "${candidate}"`);
+        return d.toISOString();
+    }
+    return now().toISOString();
+}
+export async function syncModels(opts) {
+    const log = opts.log ?? ((line) => console.log(line));
+    const now = opts.deps?.now ?? (() => new Date());
+    const env = opts.env ?? process.env;
+    const cwd = opts.cwd ?? process.cwd();
+    const dryRun = opts.dryRun ?? false;
+    // 1. Contract: same checks as reconcile, so a repo that cannot reconcile cannot sync either.
+    const loaded = await loadConfig(opts.configPath, cwd);
+    const { config, rootDir } = loaded;
+    const report = await checkContract(loaded, { env, requireApiKey: !dryRun });
+    for (const w of report.warnings)
+        log(`warning: ${w}`);
+    assertContract(report);
+    const outDir = path.resolve(rootDir, opts.outDir ?? '.lockstep');
+    const commitSha = resolveCommitSha(opts.ref, rootDir, env);
+    const branch = resolveBranch(opts.branch, rootDir, env);
+    const pushedAt = resolvePushedAt(opts.pushedAt, rootDir, commitSha, now);
+    log(`lockstep sync-models ${reconcilerVersion()}  ${config.projectKey}  ${branch}  ${commitSha.slice(0, 12)}${dryRun ? '  (dry run)' : ''}`);
+    // 2. Journeys and scenarios, deterministically ordered by the loaders (files by path, scenarios by name).
+    const journeys = (await loadJourneys(rootDir, config.journeysGlob)).map((j) => j.model);
+    const scenarios = await loadScenarios(rootDir, config.scenariosPath);
+    log(`journeys: ${journeys.map((j) => j.key).join(', ') || '(none)'}; scenarios: ${scenarios.map((s) => s.name).join(', ')}`);
+    // 3. Payload, validated locally before anything leaves the machine.
+    const payload = ModelSyncPayload.parse({
+        schemaVersion: 1,
+        projectKey: config.projectKey,
+        commitSha,
+        ref: branch,
+        pushedAt,
+        journeys,
+        scenarios,
+        reconcilerVersion: reconcilerVersion(),
+    });
+    ensureDir(outDir);
+    writeFileSync(path.join(outDir, 'model-sync-payload.json'), JSON.stringify(payload, null, 2) + '\n');
+    // 4. Post.
+    let response = null;
+    const client = dryRun
+        ? (opts.deps?.client ?? null)
+        : (opts.deps?.client ??
+            createIngestClient({
+                baseUrl: config.apiBaseUrl,
+                apiKey: env[API_KEY_ENV],
+                fetch: opts.deps?.fetch,
+            }));
+    if (client && !dryRun) {
+        try {
+            response = await client.syncModels(payload);
+        }
+        catch (err) {
+            // 422 means the platform refused the models themselves: that is the repo's problem (exit 1).
+            if (err instanceof LockstepApiError && err.status === 422) {
+                const details = detailsOf(err.body);
+                throw ContractViolation.fromList(details.length
+                    ? details.map((message) => ({ item: 'models', message }))
+                    : [{ item: 'models', message: err.message }]);
+            }
+            throw new InfrastructureError('posting the models to /api/ingest/models failed', err);
+        }
+        writeFileSync(path.join(outDir, 'model-sync-response.json'), JSON.stringify(response, null, 2) + '\n');
+        log(`synced: ${response.journeysUpserted} journey(s) upserted, ${response.versionsCreated} version(s) created, ${response.archived} archived`);
+    }
+    else {
+        log(`dry run: ${journeys.length} journey(s), ${scenarios.length} scenario(s) written to ${path.relative(rootDir, path.join(outDir, 'model-sync-payload.json')) || '.'}; nothing posted`);
+    }
+    return { payload, response, exitCode: EXIT.CLEAN, outDir };
+}
+function detailsOf(body) {
+    if (!body || typeof body !== 'object')
+        return [];
+    const details = body.details;
+    return Array.isArray(details) ? details.filter((d) => typeof d === 'string') : [];
+}
+//# sourceMappingURL=sync.js.map