@intentius/sql-yodeler 0.0.0-stage → 0.2.0

package/dist/commands/plan.js.map

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

package/dist/commands/rebase.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "../command.js";
+/** `yodel rebase`; the exit codes are in `help`. */
+export declare const rebase: Command;

package/dist/commands/rebase.js

@@ -0,0 +1,167 @@
+import { parseArgs } from "node:util";
+import { guarded } from "../env-args.js";
+import { loadProject, resolveEnvironment, YodelError } from "../project.js";
+import { MigrationDirectoryError, refusedSteps, scanMigrations } from "../migrations/index.js";
+import { closeVersioned, migrationsDir, openVersioned } from "../versioned/index.js";
+import { planRebase, REBASE_REFUSED, writeRebase } from "../rebase/index.js";
+const usage = "usage: yodel rebase [<id>] [--onto <parent-id>] [--env <env>]... [--force] [--json] [--dir <project>]";
+const help = `${usage}
+
+Moves a migration onto another parent and rewrites it, so two branches that
+each added a migration can both merge. With no <id>, the directory's one
+fork (two migrations that follow the same parent) is resolved: the newer of
+the two (by the timestamp in its id) moves onto the end of the other's
+branch. Name <id> to move another one, and --onto to choose its new parent.
+Migrations that follow the moved one move with it.
+
+Each moved migration's change (its recorded schema against its old
+parent's) is applied to its new parent's recorded schema, giving its new
+recorded schema; its statements are diffed again from the new parent's, and
+its migration.sql, migration.json and checksum are written again. When both
+branches change the same object, differently, nothing is written and the
+object is named: resolve it by hand (delete the migration, then yodel new).
+Each -- yodel:allow line is carried over to the same statement in the new
+migration.sql; when that statement is gone or changed, nothing is written
+and the line is named.
+Offline: no database is read, except the histories --env names.
+
+Ids do not change. The order is the chain of parent ids, not the ids'
+timestamps, so a rebased migration runs after its new parent whatever its
+timestamp says, and anything that names it still does.
+
+Options:
+  --onto <id>      the new parent (default: the end of the other branch)
+  --env <env>      refuse if this environment's history records a migration
+                   the rebase would rewrite; repeat for more environments.
+                   Without it, no history is checked: never rebase a
+                   migration that ran somewhere
+  --force          rewrite migrations whose files were edited by hand (the
+                   edits are dropped; well-formed -- yodel:allow lines are
+                   still carried over)
+  --json           print what was rewritten as JSON
+  -C, --dir <dir>  the project directory (default: the working directory)
+
+Exit codes:
+  0  rebased, or no fork to rebase
+  4  refused, nothing written: both branches change the same object, a
+     migration to rewrite was edited by hand (without --force), a
+     yodel:allow line's statement is gone or changed, a history records one
+     of them, or the moved migration adds nothing on its new parent
+  1  the rebase could not be worked out: no such migration, a fork the
+     defaults cannot settle, a bad config, a server that does not answer
+`;
+function parseRebaseArgs(args) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args,
+            allowPositionals: true,
+            strict: true,
+            options: {
+                onto: { type: "string" },
+                env: { type: "string", multiple: true },
+                force: { type: "boolean" },
+                json: { type: "boolean" },
+                dir: { type: "string", short: "C" },
+            },
+        });
+    }
+    catch (e) {
+        throw new YodelError(`${e instanceof Error ? e.message : String(e)}\n${usage}`);
+    }
+    const { values, positionals } = parsed;
+    if (positionals.length > 1)
+        throw new YodelError(usage);
+    const envs = Array.isArray(values.env) ? values.env.filter((e) => typeof e === "string") : [];
+    return {
+        id: positionals[0],
+        onto: typeof values.onto === "string" ? values.onto : undefined,
+        envs,
+        force: values.force === true,
+        json: values.json === true,
+        dir: typeof values.dir === "string" ? values.dir : process.cwd(),
+    };
+}
+/** Refuses when an environment's history names a migration the rebase would rewrite. */
+async function checkHistories(project, envs, plan) {
+    for (const name of envs) {
+        const env = resolveEnvironment(project, name);
+        const venv = await openVersioned(project, env);
+        const state = await venv.store.state().finally(() => closeVersioned(venv));
+        const ran = plan.rewritten.flatMap((m) => {
+            const rec = state.byId.get(m.id);
+            return rec ? [`${m.id} (${rec.status === "succeeded" ? "applied" : `ran part way, ${rec.status}`})`] : [];
+        });
+        if (ran.length > 0) {
+            throw new YodelError(`refused: ${name}'s history records ${ran.join(", ")}. Nothing was written. A migration that ran is never rebased: ` +
+                `its statements already ran in that order. Rebase the other branch onto it instead (yodel rebase <the other> --onto <the end of this one>).`, REBASE_REFUSED);
+        }
+    }
+}
+function report(io, json, plan, envs) {
+    if (json) {
+        io.out(`${JSON.stringify({
+            rebased: true,
+            moved: plan.moved,
+            from: plan.from,
+            onto: plan.onto,
+            historiesChecked: envs,
+            rewritten: plan.rewritten.map((m) => ({
+                id: m.id,
+                path: m.dir,
+                oldParent: m.oldParent,
+                parent: m.parent,
+                oldChecksum: m.oldChecksum,
+                checksum: m.checksum,
+                statements: m.statements.steps.length - refusedSteps(m.statements.steps).length,
+                refused: m.statements.refused,
+                silences: m.silences.map((x) => ({ step: x.step, rule: x.rule, reason: x.reason, line: x.line })),
+                handEdited: m.handEdited,
+            })),
+        }, null, 2)}\n`);
+        return;
+    }
+    const lines = [`Rebased ${plan.moved} onto ${plan.onto} (it followed ${plan.from ?? "nothing"}).`];
+    for (const m of plan.rewritten) {
+        const n = m.statements.steps.length - refusedSteps(m.statements.steps).length;
+        lines.push(`  ${m.id}: follows ${m.parent}; ${String(n)} statement${n === 1 ? "" : "s"}${m.statements.refused ? " and an Op or manual step" : ""}${m.silences.length > 0 ? `; ${String(m.silences.length)} yodel:allow line${m.silences.length === 1 ? "" : "s"} carried over` : ""}; checksum ${m.oldChecksum} -> ${m.checksum}`);
+        for (const h of m.statements.hints)
+            lines.push(`    hint: ${h}`);
+    }
+    lines.push(envs.length > 0
+        ? `Checked against the history of ${envs.join(", ")}: none of them had run.`
+        : "No history was checked (--env): make sure none of these ran anywhere before merging.");
+    io.out(`${lines.join("\n")}\n`);
+}
+/** `yodel rebase`; the exit codes are in `help`. */
+export const rebase = {
+    name: "rebase",
+    summary: "move a migration onto a new parent and recompute its schema",
+    implemented: true,
+    run: (args, io) => guarded("rebase", io, args, help, async () => {
+        const options = parseRebaseArgs(args);
+        const project = await loadProject(options.dir);
+        const scan = scanMigrations(migrationsDir(project));
+        const structural = scan.problems.filter((p) => p.kind === "unreadable" || p.kind === "id-mismatch" || p.kind === "missing-parent");
+        if (structural.length > 0)
+            throw new MigrationDirectoryError(scan.dir, structural);
+        const plan = planRebase(scan.migrations, { id: options.id, onto: options.onto });
+        if (plan.moved === undefined) {
+            if (options.json)
+                io.out(`${JSON.stringify({ rebased: false }, null, 2)}\n`);
+            else
+                io.out("No fork: every migration follows a different parent. Nothing to rebase.\n");
+            return 0;
+        }
+        const edited = plan.rewritten.filter((m) => m.handEdited);
+        if (edited.length > 0 && !options.force) {
+            throw new YodelError(`refused: ${edited.map((m) => m.id).join(", ")} ${edited.length === 1 ? "has" : "have"} files that differ from what yodel wrote (an edit by hand, or a checksum that no longer matches). ` +
+                `Rebasing writes them again from their recorded schema and drops that edit. Nothing was written; pass --force to rebase anyway, then make the edit again.`, REBASE_REFUSED);
+        }
+        await checkHistories(project, options.envs, plan);
+        writeRebase(plan);
+        report(io, options.json, plan, options.envs);
+        return 0;
+    }),
+};
+//# sourceMappingURL=rebase.js.map

package/dist/commands/rebase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebase.js","sourceRoot":"","sources":["../../src/commands/rebase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,UAAU,EAAgB,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AAE9F,MAAM,KAAK,GAAG,uGAAuG,CAAC;AAEtH,MAAM,IAAI,GAAG,GAAG,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CpB,CAAC;AAWF,SAAS,eAAe,CAAC,IAAc;IACrC,IAAI,MAAoC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC;YACjB,IAAI;YACJ,gBAAgB,EAAE,IAAI;YACtB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;gBACvC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;gBAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;gBACzB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;aACpC;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,UAAU,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IACvC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3G,OAAO;QACL,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;QAClB,IAAI,EAAE,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAC/D,IAAI;QACJ,KAAK,EAAE,MAAM,CAAC,KAAK,KAAK,IAAI;QAC5B,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI;QAC1B,GAAG,EAAE,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;KACjE,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,KAAK,UAAU,cAAc,CAAC,OAAgB,EAAE,IAAuB,EAAE,IAAgB;IACvF,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACvC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5G,CAAC,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,UAAU,CAClB,YAAY,IAAI,sBAAsB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,gEAAgE;gBAClH,4IAA4I,EAC9I,cAAc,CACf,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,EAAM,EAAE,IAAa,EAAE,IAAgB,EAAE,IAAuB;IAC9E,IAAI,IAAI,EAAE,CAAC;QACT,EAAE,CAAC,GAAG,CACJ,GAAG,IAAI,CAAC,SAAS,CACf;YACE,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,gBAAgB,EAAE,IAAI;YACtB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpC,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,GAAG;gBACX,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM;gBAC/E,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,OAAO;gBAC7B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACjG,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB,CAAC,CAAC;SACJ,EACD,IAAI,EACJ,CAAC,CACF,IAAI,CACN,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,WAAW,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,IAAI,iBAAiB,IAAI,CAAC,IAAI,IAAI,SAAS,IAAI,CAAC,CAAC;IACnG,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,WAAW,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnU,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,MAAM,GAAG,CAAC;QACb,CAAC,CAAC,kCAAkC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB;QAC5E,CAAC,CAAC,sFAAsF,CAC3F,CAAC;IACF,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,MAAM,MAAM,GAAY;IAC7B,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,6DAA6D;IACtE,WAAW,EAAE,IAAI;IACjB,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAChB,OAAO,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC;QACnI,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,uBAAuB,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAEnF,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACjF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,OAAO,CAAC,IAAI;gBAAE,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;;gBACxE,EAAE,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAC;YACzF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACxC,MAAM,IAAI,UAAU,CAClB,YAAY,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,oGAAoG;gBACxL,0JAA0J,EAC5J,cAAc,CACf,CAAC;QACJ,CAAC;QACD,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClD,WAAW,CAAC,IAAI,CAAC,CAAC;QAClB,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7C,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;CACL,CAAC"}

package/dist/commands/repair.d.ts

@@ -0,0 +1,14 @@
+import type { Command } from "../command.js";
+/** `yodel repair <id> --reason ... <env>`; the exit codes are in `help`. */
+export declare const repair: Command;
+/** `yodel repair --json` (schemas/repair.schema.json). */
+export declare function repairJson(r: {
+    id: string;
+    environment: string;
+    oldChecksum: string;
+    newChecksum: string;
+    reason: string;
+    seq: number;
+    runId: string;
+    migrationJsonUpdated: boolean;
+}): Record<string, unknown>;

package/dist/commands/repair.js

@@ -0,0 +1,125 @@
+import { renameSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { parseArgs } from "node:util";
+import { guarded } from "../env-args.js";
+import { loadProject, resolveEnvironment, YodelError } from "../project.js";
+import { MIGRATION_JSON, scanMigrations, serializeDocument, verifyChecksum } from "../migrations/index.js";
+import { appliedBy, newRunContext, withLock } from "../history/index.js";
+import { closeVersioned, migrationsDir, openVersioned } from "../versioned/index.js";
+import { checkRepair, repairRow } from "../rebase/repair.js";
+/** A migration directory's name: `<YYYYMMDDTHHMM>-<name>`. */
+const MIGRATION_ID = /^\d{8}T\d{4}-/;
+const usage = 'usage: yodel repair <env> <id> --reason "<text>" [--json] [--dir <project>]\n       (or yodel repair <id> --reason "<text>" <env>)';
+const help = `${usage}
+
+Records an intended edit to a migration that is already applied in <env>:
+appends a row to the environment's history table (yodel.config.ts
+history.database, else YODEL_HISTORY_DATABASE, default yodeler; on
+Postgres the schema of that name) with the checksum the migration's files
+have now and the reason, under the apply lock. After it, yodel status and
+yodel apply compare the files with the new checksum. Nothing is run on the server: the edit is
+recorded, not applied. Repair each environment the migration ran in.
+
+When migration.json's own checksum field is stale too (it is not part of
+what the checksum covers), it is written again to match.
+
+Options:
+  --reason <text>  why the files changed; required, and kept in the history
+  --json           print the repair as JSON
+  -C, --dir <dir>  the project directory (default: the working directory)
+
+Exit codes:
+  0  the new checksum is recorded
+  4  refused, nothing written: the migration is not applied in <env> (not
+     run, or part way), its files already match the history, or it is gone
+     from the directory
+  5  another apply holds the lock
+  1  anything else: no --reason, a bad config, a server that does not answer
+`;
+function parseRepairArgs(args) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args,
+            allowPositionals: true,
+            strict: true,
+            options: { reason: { type: "string" }, json: { type: "boolean" }, dir: { type: "string", short: "C" } },
+        });
+    }
+    catch (e) {
+        throw new YodelError(`${e instanceof Error ? e.message : String(e)}\n${usage}`);
+    }
+    const { values, positionals } = parsed;
+    if (positionals.length !== 2)
+        throw new YodelError(usage);
+    // <env> <id>, as every other command takes the environment first, or <id> ... <env> (#19): the id is the one shaped like one.
+    const [first = "", second = ""] = positionals;
+    const [id, env] = MIGRATION_ID.test(first) && !MIGRATION_ID.test(second) ? [first, second] : [second, first];
+    const reason = typeof values.reason === "string" ? values.reason.trim() : "";
+    if (reason === "")
+        throw new YodelError(`a repair needs a reason: --reason "<why the files changed>"\n${usage}`);
+    return { id, env, reason, json: values.json === true, dir: typeof values.dir === "string" ? values.dir : process.cwd() };
+}
+/** Writes migration.json again with its checksum field matching its files, when it does not. Returns whether it wrote. */
+function syncRecordedChecksum(m) {
+    const check = verifyChecksum(m);
+    if (check.ok)
+        return false;
+    const path = join(m.dir, MIGRATION_JSON);
+    const tmp = join(m.dir, `.${MIGRATION_JSON}.repairing`);
+    writeFileSync(tmp, serializeDocument({ ...JSON.parse(m.files.json), checksum: check.actual }));
+    renameSync(tmp, path);
+    return true;
+}
+/** `yodel repair <id> --reason ... <env>`; the exit codes are in `help`. */
+export const repair = {
+    name: "repair",
+    summary: "record a new checksum for an applied migration, with a reason",
+    implemented: true,
+    run: (args, io) => guarded("repair", io, args, help, async () => {
+        const { id, env: name, reason, json, dir } = parseRepairArgs(args);
+        const project = await loadProject(dir);
+        const env = resolveEnvironment(project, name);
+        const m = scanMigrations(migrationsDir(project)).migrations.find((x) => x.id === id);
+        const venv = await openVersioned(project, env);
+        try {
+            return await repairWith(venv, m, { id, envName: env.name, reason, json, io });
+        }
+        finally {
+            await closeVersioned(venv);
+        }
+    }),
+};
+/** `yodel repair --json` (schemas/repair.schema.json). */
+export function repairJson(r) {
+    return { repaired: true, ...r };
+}
+async function repairWith(venv, m, { id, envName, reason, json, io }) {
+    checkRepair(m, id, await venv.store.state(), envName); // refuse before taking the lock
+    const lock = await venv.driver.acquireLock(appliedBy());
+    if (lock.notice && !json)
+        io.err(`lock: ${lock.notice}\n`);
+    const row = await withLock(lock, venv.lockTtlMs, async () => {
+        const state = await venv.store.state();
+        const check = checkRepair(m, id, state, envName);
+        const r = repairRow({ migration: m, check, reason, run: newRunContext(check.record.planDigest), seq: state.maxSeq + 1 });
+        await venv.store.append([r]);
+        return { r, check };
+    });
+    const synced = syncRecordedChecksum(m);
+    if (json) {
+        io.out(`${JSON.stringify(repairJson({ id, environment: envName, oldChecksum: row.check.oldChecksum, newChecksum: row.check.newChecksum, reason, seq: row.r.seq, runId: row.r.run_id, migrationJsonUpdated: synced }), null, 2)}\n`);
+    }
+    else {
+        io.out([
+            `Repaired ${id} in ${envName}'s history (${venv.location.database}).`,
+            `  old checksum: ${row.check.oldChecksum}`,
+            `  new checksum: ${row.check.newChecksum}`,
+            `  reason: ${reason}`,
+            ...(synced ? [`  ${MIGRATION_JSON}'s checksum field updated to match`] : []),
+            "",
+        ].join("\n"));
+    }
+    return 0;
+}
+//# sourceMappingURL=repair.js.map

package/dist/commands/repair.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from "../command.js";
+/** Exit code: migrations are pending, and nothing is wrong. */
+export declare const STATUS_PENDING = 3;
+/** Exit code: a checksum mismatch, an applied migration gone from the directory, or an out-of-order migration. */
+export declare const STATUS_REFUSED = 4;
+/** `yodel status <env>`; the exit codes are in `help`. */
+export declare const status: Command;

package/dist/commands/status.js

@@ -0,0 +1,54 @@
+import { guarded, parseEnvArgs, usage } from "../env-args.js";
+import { loadProject, resolveEnvironment } from "../project.js";
+import { closeVersioned, openVersioned, readChain, renderStatus, statusJson, statusReport } from "../versioned/index.js";
+/** Exit code: migrations are pending, and nothing is wrong. */
+export const STATUS_PENDING = 3;
+/** Exit code: a checksum mismatch, an applied migration gone from the directory, or an out-of-order migration. */
+export const STATUS_REFUSED = 4;
+const help = `${usage("status")}
+
+Lists the environment's migrations against its history table
+(yodel.config.ts history.database, else YODEL_HISTORY_DATABASE, default
+yodeler) and its topology: applied, pending, out of order (pending, but
+before an applied migration in the chain), failed part way (with the
+statement it resumes at), and checksum mismatches (an applied migration
+whose files changed, or that is gone from the directory). When yodel apply
+would run, prints the plan digest it would ask approval for. Reads only;
+takes no lock.
+
+Options:
+  --json           print the status as JSON
+  -C, --dir <dir>  the project directory (default: the working directory)
+
+Exit codes:
+  0  every migration is applied
+  3  migrations are pending (failed part way included), and nothing is wrong
+  4  a checksum mismatch, an applied migration gone from the directory, an
+     out-of-order migration (apply refuses it without --allow-out-of-order),
+     or a fork or another problem in the migrations directory
+  2  a pending migration has a manual step or an Op step yodel apply does not run
+  1  the status could not be read: a bad config, a server that does not answer
+`;
+/** `yodel status <env>`; the exit codes are in `help`. */
+export const status = {
+    name: "status",
+    summary: "list applied, pending and out-of-order migrations",
+    implemented: true,
+    run: (args, io) => guarded("status", io, args, help, async () => {
+        const { env: name, json, dir } = parseEnvArgs("status", args);
+        const project = await loadProject(dir);
+        const env = resolveEnvironment(project, name);
+        const ordered = readChain(project);
+        const venv = await openVersioned(project, env);
+        const report = await statusReport(venv, ordered, { sync: false }).finally(() => closeVersioned(venv));
+        if (json)
+            io.out(`${JSON.stringify(statusJson(report), null, 2)}\n`);
+        // The sections already say what is wrong; the refusal's wording is apply's.
+        else
+            io.out(renderStatus({ ...report, refusal: undefined }));
+        if (report.refusal)
+            return report.refusal.exitCode;
+        return report.status.pending.length > 0 ? STATUS_PENDING : 0;
+    }),
+};
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEzH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,kHAAkH;AAClH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;CAuB9B,CAAC;AAEF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,MAAM,GAAY;IAC7B,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,mDAAmD;IAC5D,WAAW,EAAE,IAAI;IACjB,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAChB,OAAO,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QACtG,IAAI,IAAI;YAAE,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACrE,4EAA4E;;YACvE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;QACnD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC;CACL,CAAC"}

package/dist/config/define.d.ts

@@ -0,0 +1,148 @@
+/**
+ * `yodel.config.ts`: what yodel needs per environment that chant's
+ * `chant.config.ts` does not say. Optional; a project without one runs on
+ * the defaults below.
+ *
+ * ```ts
+ * // yodel.config.ts
+ * import { defineConfig } from "@intentius/sql-yodeler";
+ *
+ * export default defineConfig({
+ *   environments: {
+ *     dev: { topology: "single" },
+ *     prod: { topology: "cluster:main", history: { database: "yodeler" }, lockTtl: 1800, lockWait: 600 },
+ *   },
+ * });
+ * ```
+ */
+import type { Topology } from "@intentius/chant-lexicon-sql/clickhouse/topology";
+import type { LevelSetting, LintRuleId } from "../lint/rules.js";
+export type { Topology };
+/**
+ * A ClickHouse topology in its string form (`single`, `cluster:<name>`,
+ * `replicated`, `replicated:<cluster>`, `cloud`) or chant's object form,
+ * which also sets a cluster's Keeper path and replica name for the tables
+ * the migrations create.
+ */
+export type TopologySetting = string | Topology;
+export interface EnvironmentConfig {
+    /**
+     * The ClickHouse topology this environment runs. Every statement of every
+     * migration is rendered for it when it is sent (`ON CLUSTER`, the
+     * replicated engine), and the history table's engine follows it.
+     * Default: `sql.profiles.<env>.topology` in chant.config.ts, then
+     * `YODEL_TOPOLOGY`, then `single`.
+     */
+    topology?: TopologySetting;
+    history?: {
+        /** The database the history and lock tables live in. Default: `YODEL_HISTORY_DATABASE`, then `yodeler`. */
+        database?: string;
+    };
+    /** The apply lock's TTL, in seconds. Default: `YODEL_LOCK_TTL`, then 900. */
+    lockTtl?: number;
+    /**
+     * How long, in seconds, an apply waits for the lock another apply holds
+     * before it gives up (exit 5). `yodel apply --lock-wait` overrides it.
+     * Default: `YODEL_LOCK_WAIT`, then 0 (give up at once).
+     */
+    lockWait?: number;
+}
+export interface YodelConfig {
+    /** Keyed by the environment's name in `sql.profiles`. */
+    environments?: Record<string, EnvironmentConfig>;
+    /** `yodel lint`'s rule levels: `{ rules: { destructive: "warning" } }`. A misspelled rule name is a type error. */
+    lint?: LintConfig;
+    /** Rules over the plan (#53) that `yodel plan` reports and `yodel apply` enforces; see {@link PolicyConfig}. */
+    policy?: PolicyConfig;
+}
+/**
+ * Rules over the versioned plan (#53). `yodel plan` shows each rule's
+ * outcome, and `yodel apply` refuses (exit 4) a plan a rule denies, unless
+ * someone {@link PolicyConfig.overriders} lists recorded an override of that
+ * rule for exactly that plan digest (`yodel override <env> --rule <id>
+ * --reason <text>`).
+ *
+ * ```ts
+ * policy: {
+ *   overriders: ["alice", "bob"],
+ *   rules: [
+ *     { id: "no-drops-in-prod", environments: ["prod"], refuse: { classes: ["drop"], destructive: true } },
+ *     { id: "silences-cite-a-ticket", silences: { reason: /\b[A-Z]+-\d+\b/ } },
+ *     { id: "no-rebuilds-in-hours", environments: ["prod"], check: (plan) => {
+ *         const hour = new Date(plan.now).getUTCHours();
+ *         const rebuilds = plan.pending.flatMap((m) => m.steps.filter((s) => s.classes.includes("rebuild")));
+ *         return hour >= 8 && hour < 18 && rebuilds.length > 0 ? "a rebuild between 08:00 and 18:00 UTC" : undefined;
+ *       } },
+ *   ],
+ * }
+ * ```
+ */
+export interface PolicyConfig {
+    rules: PolicyRule[];
+    /** Who may override a rule: an override recorded by anyone else does not count. None listed, no override counts. */
+    overriders?: string[];
+}
+/** One rule. It denies the plan when any of `refuse`, `silences` or `check` does. */
+export interface PolicyRule {
+    /** Names it in output, in the refusal and in `yodel override --rule`: lowercase letters, digits, `-` and `_`. */
+    id: string;
+    description?: string;
+    /** The environments it applies to. Default: every one. */
+    environments?: string[];
+    /** Denies a pending step of one of these classes (`drop`, `rebuild`, `rewrite`, ...), or a destructive one when `destructive` is true. */
+    refuse?: {
+        classes?: string[];
+        destructive?: boolean;
+    };
+    /** Denies a `-- yodel:allow` silence (of one of `rules`, default any) whose reason does not match `reason`. */
+    silences?: {
+        rules?: string[];
+        reason: RegExp;
+    };
+    /** A predicate over the plan: a message (or several) or `false` denies it; `undefined`, `true` or `[]` allows it. */
+    check?: (plan: PolicyPlan) => string | string[] | boolean | undefined;
+}
+/** What a policy rule sees: the plan `yodel apply` would run. Plain JSON. */
+export interface PolicyPlan {
+    environment: string;
+    dialect: "clickhouse" | "postgres";
+    /** When the plan is evaluated, ISO 8601 in UTC. */
+    now: string;
+    /** The migrations the run would apply, in order. */
+    pending: PolicyMigration[];
+}
+export interface PolicyMigration {
+    id: string;
+    checksum: string;
+    outOfOrder: boolean;
+    steps: PolicyStep[];
+    /** Its `-- yodel:allow` silences. */
+    silences: Array<{
+        step: number;
+        rule: string;
+        reason: string;
+    }>;
+}
+export interface PolicyStep {
+    index: number;
+    kind: "statement" | "op" | "manual";
+    object: string;
+    name: string;
+    /** A statement's class, or every class an Op or manual step's changes have. */
+    classes: string[];
+    destructive: boolean;
+    /** The rules that classified it. */
+    rules: string[];
+    /** A statement's SQL. */
+    sql?: string;
+    /** An Op step's Op. */
+    op?: string;
+}
+/** The rules `lint.rules` can set: every lint rule, and the replay check's. */
+export type LintRuleName = LintRuleId | "replay";
+export interface LintConfig {
+    /** Each rule's level. The integrity rules (fork, directory, checksum, unreadable-object) are always errors. */
+    rules?: Partial<Record<LintRuleName, LevelSetting>>;
+}
+/** Returns `config` as is; it types the default export of `yodel.config.ts`. */
+export declare const defineConfig: (config: YodelConfig) => YodelConfig;

package/dist/config/define.js

@@ -0,0 +1,20 @@
+/**
+ * `yodel.config.ts`: what yodel needs per environment that chant's
+ * `chant.config.ts` does not say. Optional; a project without one runs on
+ * the defaults below.
+ *
+ * ```ts
+ * // yodel.config.ts
+ * import { defineConfig } from "@intentius/sql-yodeler";
+ *
+ * export default defineConfig({
+ *   environments: {
+ *     dev: { topology: "single" },
+ *     prod: { topology: "cluster:main", history: { database: "yodeler" }, lockTtl: 1800, lockWait: 600 },
+ *   },
+ * });
+ * ```
+ */
+/** Returns `config` as is; it types the default export of `yodel.config.ts`. */
+export const defineConfig = (config) => config;
+//# sourceMappingURL=define.js.map

package/dist/config/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/config/define.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAsIH,gFAAgF;AAChF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAmB,EAAe,EAAE,CAAC,MAAM,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `yodel.config.ts` (#9): per-environment settings chant.config.ts does not
+ * hold, the ClickHouse topology first.
+ *
+ *   defineConfig({ environments: { <env>: { topology, history, lockTtl } } })
+ *   loadYodelConfig(dir, profiles)          the file, checked; undefined when there is none
+ *   environmentSettings(project, env)       topology, history database, lock TTL, with their fallbacks
+ */
+export * from "./define.js";
+export * from "./load.js";
+export * from "./settings.js";

package/dist/config/index.js

@@ -0,0 +1,12 @@
+/**
+ * `yodel.config.ts` (#9): per-environment settings chant.config.ts does not
+ * hold, the ClickHouse topology first.
+ *
+ *   defineConfig({ environments: { <env>: { topology, history, lockTtl } } })
+ *   loadYodelConfig(dir, profiles)          the file, checked; undefined when there is none
+ *   environmentSettings(project, env)       topology, history database, lock TTL, with their fallbacks
+ */
+export * from "./define.js";
+export * from "./load.js";
+export * from "./settings.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/dist/config/load.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Finding, loading and checking `yodel.config.ts`. The file is optional; a
+ * project without one gets `undefined` and every setting's default.
+ */
+import type { YodelConfig } from "./define.js";
+export declare const CONFIG_FILE = "yodel.config.ts";
+/**
+ * Checks a loaded config's shape. `environments` names each environment by
+ * its `sql.profiles` name; one that chant.config.ts does not declare is an
+ * error, so a typo does not silently leave an environment on the defaults.
+ */
+export declare function checkYodelConfig(value: unknown, path: string, profiles?: readonly string[]): YodelConfig;
+/** Loads `<dir>/yodel.config.ts`, or `undefined` when there is none. */
+export declare function loadYodelConfig(dir: string, profiles?: readonly string[]): Promise<{
+    path: string;
+    config: YodelConfig;
+} | undefined>;