@intentius/sql-yodeler 0.0.0-stage → 0.2.0

package/dist/versioned/report.js

@@ -0,0 +1,84 @@
+/** The versioned status as text and as JSON, for `yodel status` and `yodel apply --plan`. */
+import { describeTopology } from "../history/index.js";
+import { describeStep } from "../steps/index.js";
+import { describeServer } from "../server.js";
+import { outOfOrder, partWay } from "./state.js";
+export function statusJson(r) {
+    const { status } = r;
+    return {
+        environment: r.environment,
+        ...(r.server ? { server: r.server } : {}),
+        ...(r.dialect === "postgres"
+            ? { history: { database: r.location.database } }
+            : { history: { database: r.location.database, topology: describeTopology(r.location.topology) }, topology: r.topology ?? describeTopology(r.location.topology) }),
+        applied: status.applied.map((a) => ({
+            id: a.id,
+            checksum: a.checksum,
+            appliedBy: a.appliedBy,
+            recordedAt: a.recordedAt,
+            planDigest: a.planDigest,
+            inDirectory: a.index !== undefined,
+            ...(a.repairs ? { repairs: a.repairs.map((r) => ({ checksum: r.checksum, by: r.by, at: r.at, reason: r.reason })) } : {}),
+        })),
+        pending: status.pending.map((p) => ({
+            id: p.id,
+            checksum: p.checksum,
+            outOfOrder: p.outOfOrder,
+            partWay: p.partWay ?? null,
+            opSteps: p.opSteps.map(({ index, step }) => ({ index, kind: step.kind, object: step.object, name: step.name, ...(step.kind === "op" ? { op: step.op } : {}) })),
+            refusedSteps: p.refusedSteps.map(({ index, step, reason }) => ({ index, kind: step.kind, object: step.object, name: step.name, ...(step.kind === "op" ? { op: step.op } : {}), reason })),
+        })),
+        outOfOrder: outOfOrder(status).map((p) => p.id),
+        partWay: partWay(status).map((p) => ({ id: p.id, resumeAt: p.partWay?.resumeAt, failedStatement: p.partWay?.failedStatement ?? null })),
+        mismatches: status.mismatches,
+        ...(r.digest ? { planDigest: r.digest } : {}),
+        ...(r.refusal ? { refusal: r.refusal } : {}),
+    };
+}
+export function renderStatus(r) {
+    const { status } = r;
+    const topology = r.dialect === "postgres" ? "" : `, topology ${r.topology ?? describeTopology(r.location.topology)}`;
+    const server = r.server ? `${describeServer(r.server)}, ` : "";
+    const lines = [`Migrations in ${r.environment} (${server}history ${r.location.database}.history${topology})`, ""];
+    lines.push(status.applied.length === 0 ? "Applied: none" : `Applied (${String(status.applied.length)}):`);
+    for (const a of status.applied) {
+        lines.push(`  ${a.id}${a.index === undefined ? "  (not in the directory)" : ""}  ${a.recordedAt} by ${a.appliedBy}`);
+        for (const r of a.repairs ?? [])
+            lines.push(`      repaired ${r.at} by ${r.by}: ${r.reason}`);
+    }
+    lines.push("", status.pending.length === 0 ? "Pending: none" : `Pending (${String(status.pending.length)}):`);
+    for (const p of status.pending) {
+        const marks = [];
+        if (p.outOfOrder)
+            marks.push("out of order");
+        if (p.partWay) {
+            const pw = p.partWay;
+            marks.push(pw.status === "failed"
+                ? `failed part way at statement ${String(pw.failedStatement ?? pw.resumeAt)}; resumes at statement ${String(pw.resumeAt)}`
+                : `stopped part way; resumes at statement ${String(pw.resumeAt)}`);
+            if (pw.edited)
+                marks.push("edited since; the statements that ran are unchanged");
+        }
+        if (p.opSteps.length > 0)
+            marks.push(p.opSteps.map(({ index, step }) => `step ${String(index)}: ${describeStep(step)}`).join(", "));
+        if (p.refusedSteps.length > 0)
+            marks.push(`${String(p.refusedSteps.length)} step(s) yodel apply does not run`);
+        lines.push(`  ${p.id}${marks.length > 0 ? `  (${marks.join("; ")})` : ""}`);
+        if (p.partWay?.error)
+            lines.push(`      error: ${p.partWay.error.split("\n")[0] ?? ""}`);
+    }
+    const late = outOfOrder(status);
+    if (late.length > 0)
+        lines.push("", `Out of order (${String(late.length)}): ${late.map((p) => p.id).join(", ")}; apply with --allow-out-of-order`);
+    if (status.mismatches.length > 0) {
+        lines.push("", `Checksum mismatches (${String(status.mismatches.length)}):`);
+        for (const m of status.mismatches)
+            lines.push(`  ${m.message}`);
+    }
+    if (r.digest)
+        lines.push("", `Plan digest: ${r.digest}`);
+    if (r.refusal)
+        lines.push("", r.refusal.message);
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=report.js.map

package/dist/versioned/report.js.map

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

package/dist/versioned/stand-down.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `yodel apply --stand-down` (`YODEL_STAND_DOWN=1`): an apply that a newer
+ * commit will make anyway steps aside instead of queueing for the lock.
+ *
+ * The branch is the one the run is for: `GITHUB_REF_NAME` (GitHub and
+ * Forgejo Actions), `CI_COMMIT_BRANCH` (GitLab CI), else the checked-out
+ * branch. Its tip is fetched from `origin`; when that tip is a different
+ * commit that contains this one, a newer commit is on the branch, and its
+ * own apply job applies the same environment, this run included. Anything
+ * that cannot be told (no branch, no origin, a fetch that fails, a tip that
+ * does not contain this commit, as after a force-push) is not a newer
+ * commit: the apply goes ahead.
+ */
+export declare const STAND_DOWN_ENV = "YODEL_STAND_DOWN";
+/** Whether the environment asks for stand-down: `YODEL_STAND_DOWN=1` (or `true`). */
+export declare const standDownFromEnv: (env: NodeJS.ProcessEnv) => boolean;
+/** A newer commit on the run's branch, which will apply the environment itself. */
+export interface NewerCommit {
+    branch: string;
+    /** This run's commit. */
+    head: string;
+    /** The branch's tip on origin. */
+    tip: string;
+}
+/** The branch a run is for; see the module comment. */
+export declare function runBranch(dir: string, env: NodeJS.ProcessEnv): Promise<string | undefined>;
+/** The newer commit on the run's branch, or `undefined` when there is none or it cannot be told. */
+export declare function newerCommit(dir: string, env?: NodeJS.ProcessEnv): Promise<NewerCommit | undefined>;
+/** What a run that stands down says. */
+export declare const standDownLine: (env: string, n: NewerCommit) => string;

package/dist/versioned/stand-down.js

@@ -0,0 +1,56 @@
+/**
+ * `yodel apply --stand-down` (`YODEL_STAND_DOWN=1`): an apply that a newer
+ * commit will make anyway steps aside instead of queueing for the lock.
+ *
+ * The branch is the one the run is for: `GITHUB_REF_NAME` (GitHub and
+ * Forgejo Actions), `CI_COMMIT_BRANCH` (GitLab CI), else the checked-out
+ * branch. Its tip is fetched from `origin`; when that tip is a different
+ * commit that contains this one, a newer commit is on the branch, and its
+ * own apply job applies the same environment, this run included. Anything
+ * that cannot be told (no branch, no origin, a fetch that fails, a tip that
+ * does not contain this commit, as after a force-push) is not a newer
+ * commit: the apply goes ahead.
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const exec = promisify(execFile);
+export const STAND_DOWN_ENV = "YODEL_STAND_DOWN";
+/** Whether the environment asks for stand-down: `YODEL_STAND_DOWN=1` (or `true`). */
+export const standDownFromEnv = (env) => env[STAND_DOWN_ENV] === "1" || env[STAND_DOWN_ENV] === "true";
+async function git(dir, args) {
+    try {
+        const { stdout } = await exec("git", args, { cwd: dir, timeout: 60_000 });
+        return stdout.trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The branch a run is for; see the module comment. */
+export async function runBranch(dir, env) {
+    const named = env.GITHUB_REF_NAME || env.CI_COMMIT_BRANCH;
+    if (named)
+        return named;
+    return (await git(dir, ["symbolic-ref", "--quiet", "--short", "HEAD"])) || undefined;
+}
+/** The newer commit on the run's branch, or `undefined` when there is none or it cannot be told. */
+export async function newerCommit(dir, env = process.env) {
+    const branch = await runBranch(dir, env);
+    if (!branch)
+        return undefined;
+    const head = await git(dir, ["rev-parse", "HEAD"]);
+    if (!head)
+        return undefined;
+    if ((await git(dir, ["fetch", "--quiet", "--no-tags", "origin", `refs/heads/${branch}`])) === undefined)
+        return undefined;
+    const tip = await git(dir, ["rev-parse", "FETCH_HEAD"]);
+    if (!tip || tip === head)
+        return undefined;
+    // A tip that contains this commit is newer; one that does not (a force-push, another line) is not.
+    if ((await git(dir, ["merge-base", "--is-ancestor", head, tip])) === undefined)
+        return undefined;
+    return { branch, head, tip };
+}
+/** What a run that stands down says. */
+export const standDownLine = (env, n) => `standing down: ${n.branch} on origin is at ${n.tip.slice(0, 12)}, newer than this run's ${n.head.slice(0, 12)}, and its own apply applies ${env}. Nothing was applied by this run.`;
+//# sourceMappingURL=stand-down.js.map

package/dist/versioned/stand-down.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stand-down.js","sourceRoot":"","sources":["../../src/versioned/stand-down.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAEjC,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAEjD,qFAAqF;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAsB,EAAW,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,KAAK,MAAM,CAAC;AAWnI,KAAK,UAAU,GAAG,CAAC,GAAW,EAAE,IAAc;IAC5C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,GAAsB;IACjE,MAAM,KAAK,GAAG,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,gBAAgB,CAAC;IAC1D,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AACvF,CAAC;AAED,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,MAAyB,OAAO,CAAC,GAAG;IACjF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1H,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IACxD,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC3C,mGAAmG;IACnG,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjG,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AAC/B,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAW,EAAE,CAAc,EAAU,EAAE,CACnE,kBAAkB,CAAC,CAAC,MAAM,oBAAoB,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,+BAA+B,GAAG,oCAAoC,CAAC"}

package/dist/versioned/state.d.ts

@@ -0,0 +1,108 @@
+/**
+ * The migrations directory against the history: what is applied, pending,
+ * out of order, part way, or changed since it ran. Pure.
+ *
+ * ## Order, and "out of order"
+ *
+ * The order is the chain `readMigrations` returns: parent links from the
+ * first migration to the newest, never the ids' timestamps. A pending
+ * migration is out of order when the chain puts it before a migration the
+ * history records applied: it was merged (or rebased into place) after a
+ * migration that follows it had already run here. It is reported, refused
+ * unless the run passes `--allow-out-of-order`, and never skipped: with the
+ * flag it runs, in chain order with the other pending ones.
+ *
+ * ## Checksums
+ *
+ * Every applied migration's checksum in the history is compared with its
+ * files' checksum, recomputed, on every run; a mismatch refuses (`yodel
+ * repair`, #15, records an intended edit). A migration the history records
+ * applied that is gone from the directory refuses the same way. A
+ * migration that failed part way may be edited before it resumes (to fix
+ * the statement that failed), as long as every statement that already
+ * succeeded is unchanged: those are compared statement by statement.
+ */
+import type { MigrationStep } from "@intentius/chant-lexicon-sql/migration-statements";
+import { type Migration } from "../migrations/index.js";
+import { type HistoryState, type Repair } from "../history/index.js";
+export interface AppliedMigration {
+    id: string;
+    checksum: string;
+    appliedBy: string;
+    /** When it was applied; a later repair does not change it. */
+    recordedAt: string;
+    planDigest: string;
+    /** Its position in the chain; `undefined` when the directory no longer has it. */
+    index: number | undefined;
+    /** `yodel repair` records since it was applied, oldest first. */
+    repairs?: Repair[] | undefined;
+}
+export interface PartWay {
+    /** The latest migration row's status: `failed` (a statement failed) or `started` (the runner stopped). */
+    status: "failed" | "started";
+    /** The index (in `steps`) of the first statement that has not succeeded: where it resumes. */
+    resumeAt: number;
+    /** The statement that failed, when one did. */
+    failedStatement: number | undefined;
+    error: string;
+    /** The indexes of the statements that succeeded and are never sent again. */
+    done: number[];
+    /** Its files changed since it ran part way (only statements not yet run). */
+    edited: boolean;
+}
+export interface PendingMigration {
+    id: string;
+    /** Its position in the chain. */
+    index: number;
+    /** The checksum of its files, recomputed. */
+    checksum: string;
+    /** Before a migration the history records applied. */
+    outOfOrder: boolean;
+    partWay: PartWay | undefined;
+    /** Its Op steps `apply` runs: a ClickHouse rebuild, a backfill (#12). */
+    opSteps: Array<{
+        index: number;
+        step: Exclude<MigrationStep, {
+            kind: "statement";
+        }>;
+    }>;
+    /** Its steps `apply` does not run (a manual step, an Op it does not run), each with why. Any of them refuses the run. */
+    refusedSteps: Array<{
+        index: number;
+        step: Exclude<MigrationStep, {
+            kind: "statement";
+        }>;
+        reason: string;
+    }>;
+    migration: Migration;
+}
+export type Mismatch = {
+    kind: "applied";
+    id: string;
+    recorded: string;
+    actual: string;
+    message: string;
+} | {
+    kind: "part-way";
+    id: string;
+    statement: number;
+    message: string;
+} | {
+    kind: "missing";
+    id: string;
+    recorded: string;
+    message: string;
+};
+export interface VersionedStatus {
+    /** In chain order; then any the directory no longer has, in the order they were applied. */
+    applied: AppliedMigration[];
+    /** In chain order. */
+    pending: PendingMigration[];
+    mismatches: Mismatch[];
+}
+export declare const outOfOrder: (s: VersionedStatus) => PendingMigration[];
+export declare const partWay: (s: VersionedStatus) => PendingMigration[];
+/** A migration's Op steps, split into the ones apply runs and the ones it refuses. A backfill step whose module is not among the migration's files is refused. */
+export declare function classifySteps(m: Migration): Pick<PendingMigration, "opSteps" | "refusedSteps">;
+/** Compares the chain with the history. */
+export declare function compareHistory(ordered: readonly Migration[], state: HistoryState): VersionedStatus;

package/dist/versioned/state.js

@@ -0,0 +1,153 @@
+/**
+ * The migrations directory against the history: what is applied, pending,
+ * out of order, part way, or changed since it ran. Pure.
+ *
+ * ## Order, and "out of order"
+ *
+ * The order is the chain `readMigrations` returns: parent links from the
+ * first migration to the newest, never the ids' timestamps. A pending
+ * migration is out of order when the chain puts it before a migration the
+ * history records applied: it was merged (or rebased into place) after a
+ * migration that follows it had already run here. It is reported, refused
+ * unless the run passes `--allow-out-of-order`, and never skipped: with the
+ * flag it runs, in chain order with the other pending ones.
+ *
+ * ## Checksums
+ *
+ * Every applied migration's checksum in the history is compared with its
+ * files' checksum, recomputed, on every run; a mismatch refuses (`yodel
+ * repair`, #15, records an intended edit). A migration the history records
+ * applied that is gone from the directory refuses the same way. A
+ * migration that failed part way may be edited before it resumes (to fix
+ * the statement that failed), as long as every statement that already
+ * succeeded is unchanged: those are compared statement by statement.
+ */
+import { computeChecksum } from "../migrations/index.js";
+import { isApplied, statementDone } from "../history/index.js";
+import { planStep, stepSha } from "../steps/index.js";
+export const outOfOrder = (s) => s.pending.filter((p) => p.outOfOrder);
+export const partWay = (s) => s.pending.filter((p) => p.partWay !== undefined);
+/** How to record an intended edit of migration `id`. */
+const repair = (id) => `if the edit is intended, record it with yodel repair ${id} --reason ... <env>`;
+function partWayOf(m, rec, actual) {
+    const done = [];
+    let resumeAt = m.document.steps.length;
+    let mismatch;
+    m.document.steps.forEach((step, i) => {
+        if (statementDone(rec, i)) {
+            done.push(i);
+            const sha = stepSha(step, m.files);
+            if (!mismatch && rec.statements.get(i)?.sha !== sha) {
+                mismatch = {
+                    kind: "part-way",
+                    id: m.id,
+                    statement: i,
+                    message: `${m.id} ran part way, and statement ${String(i)}, which succeeded, has changed in its files since; ${repair(m.id)}`,
+                };
+            }
+        }
+        else if (resumeAt === m.document.steps.length) {
+            resumeAt = i;
+        }
+    });
+    const failed = [...rec.statements.values()].filter((s) => s.status === "failed").sort((a, b) => b.seq - a.seq)[0];
+    return {
+        partWay: {
+            status: rec.status === "failed" ? "failed" : "started",
+            resumeAt,
+            failedStatement: failed && !statementDone(rec, failed.index) ? failed.index : undefined,
+            error: rec.error || failed?.error || "",
+            done,
+            edited: rec.checksum !== actual,
+        },
+        ...(mismatch ? { mismatch } : {}),
+    };
+}
+/** Why a step apply runs on one dialect is refused in a migration of the other, or `undefined`. */
+function dialectRefusal(run, dialect) {
+    if (run === "rebuild" && dialect !== "clickhouse")
+        return `a ClickHouseRebuildOp step in a ${dialect} migration`;
+    if (run === "pgMigration" && dialect !== "postgres")
+        return `a PostgresMigrationOp step in a ${dialect} migration`;
+    return undefined;
+}
+/** A migration's Op steps, split into the ones apply runs and the ones it refuses. A backfill step whose module is not among the migration's files is refused. */
+export function classifySteps(m) {
+    const opSteps = [];
+    const refusedSteps = [];
+    m.document.steps.forEach((step, index) => {
+        if (step.kind === "statement")
+            return;
+        const plan = planStep(step);
+        const wrongDialect = dialectRefusal(plan.run, m.document.dialect);
+        if (plan.run === "refused")
+            refusedSteps.push({ index, step, reason: plan.reason });
+        else if (wrongDialect)
+            refusedSteps.push({ index, step, reason: wrongDialect });
+        else if (plan.run === "backfill" && m.files.extra?.[plan.file] === undefined) {
+            refusedSteps.push({ index, step, reason: `a backfill step whose module ${plan.file} is not in ${m.id}'s directory` });
+        }
+        else
+            opSteps.push({ index, step });
+    });
+    return { opSteps, refusedSteps };
+}
+/** Compares the chain with the history. */
+export function compareHistory(ordered, state) {
+    const position = new Map(ordered.map((m, i) => [m.id, i]));
+    const mismatches = [];
+    const applied = [];
+    let lastApplied = -1;
+    for (const [i, m] of ordered.entries()) {
+        const rec = state.byId.get(m.id);
+        if (!rec || !isApplied(rec))
+            continue;
+        lastApplied = i;
+        const actual = computeChecksum(m.files);
+        applied.push({ id: m.id, checksum: rec.checksum, appliedBy: rec.appliedBy, recordedAt: rec.recordedAt, planDigest: rec.planDigest, index: i, ...(rec.repairs.length > 0 ? { repairs: rec.repairs } : {}) });
+        if (rec.checksum !== actual) {
+            mismatches.push({
+                kind: "applied",
+                id: m.id,
+                recorded: rec.checksum,
+                actual,
+                message: `${m.id} was applied with checksum ${rec.checksum}, but its files now hash to ${actual}; ${repair(m.id)}`,
+            });
+        }
+    }
+    const gone = state.migrations.filter((r) => isApplied(r) && !position.has(r.id)).sort((a, b) => (a.appliedSeq ?? 0) - (b.appliedSeq ?? 0));
+    for (const r of gone) {
+        applied.push({ id: r.id, checksum: r.checksum, appliedBy: r.appliedBy, recordedAt: r.recordedAt, planDigest: r.planDigest, index: undefined, ...(r.repairs.length > 0 ? { repairs: r.repairs } : {}) });
+        mismatches.push({
+            kind: "missing",
+            id: r.id,
+            recorded: r.checksum,
+            message: `${r.id} is recorded applied, but the migrations directory no longer has it; restore it, or ${repair(r.id)}`,
+        });
+    }
+    const pending = [];
+    for (const [i, m] of ordered.entries()) {
+        const rec = state.byId.get(m.id);
+        if (isApplied(rec))
+            continue;
+        const actual = computeChecksum(m.files);
+        let pw;
+        if (rec) {
+            const r = partWayOf(m, rec, actual);
+            pw = r.partWay;
+            if (r.mismatch)
+                mismatches.push(r.mismatch);
+        }
+        pending.push({
+            id: m.id,
+            index: i,
+            checksum: actual,
+            outOfOrder: i < lastApplied,
+            partWay: pw,
+            ...classifySteps(m),
+            migration: m,
+        });
+    }
+    return { applied, pending, mismatches };
+}
+//# sourceMappingURL=state.js.map

package/dist/versioned/state.js.map

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

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "@intentius/sql-yodeler",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Schema management and migrations for ClickHouse and Postgres, on chant's sql lexicon",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/INTENTIUS/sql-yodeler.git"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "yodel": "dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "schemas"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && chmod +x dist/bin.js",
+    "prepare": "npm run build",
+    "test": "vitest run",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "check": "npm run typecheck && npm run lint && npm run test",
+    "claims": "npm run build && tsx scenarios/run.ts",
+    "release": "bash scripts/release.sh",
+    "workflows": "tsx .github/src/render.ts",
+    "claims:page": "tsx scenarios/status-page.ts",
+    "bench": "npm run build && tsx bench/run.ts"
+  },
+  "dependencies": {
+    "@intentius/chant": "^0.115.0",
+    "@intentius/chant-lexicon-sql": "^0.115.0",
+    "tsx": "^4.23.15"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@intentius/chant-lexicon-docker": "^0.115.0",
+    "@intentius/chant-lexicon-forgejo": "^0.115.0",
+    "@intentius/chant-lexicon-github": "^0.115.0",
+    "@intentius/chant-lexicon-gitlab": "^0.115.0",
+    "@types/node": "^22.20.5",
+    "@types/pg": "^8.23.1",
+    "ajv": "^8.20.0",
+    "eslint": "^10.12.0",
+    "pg": "^8.23.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.71.1",
+    "vitest": "^5.0.3"
+  }
+}