@intentius/sql-yodeler 0.0.0-stage → 0.1.0

package/dist/pr/render.js

@@ -0,0 +1,246 @@
+/**
+ * The versioned plan as text (`yodel plan <env>`), as the pull request
+ * comment's markdown (`--format markdown`, `--comment`) and as JSON.
+ *
+ * The comment starts with a hidden marker, `<!-- yodel:plan env=<env> -->`,
+ * by which `--comment` finds the comment it posted before and updates it,
+ * and ends with the digest's subject, hidden, so the next comment can say
+ * what moved. Neither holds a secret: migration ids, checksums, a hash of
+ * the live catalog. Server addresses and tokens are never rendered.
+ */
+import { askedAgainLine, describeMove, encodeSubject } from "../versioned/explain.js";
+import { asBackfill } from "../steps/kinds.js";
+/** The marker that identifies one environment's plan comment. */
+export const commentMarker = (env) => `<!-- yodel:plan env=${env} -->`;
+const SUBJECT = /<!-- yodel:subject ([A-Za-z0-9_-]+) -->/;
+/** The subject a comment body carries, encoded. */
+export const subjectIn = (body) => SUBJECT.exec(body)?.[1];
+/** GitHub refuses a comment over 65536 characters; GitLab and Forgejo allow more. */
+export const COMMENT_LIMIT = 65_000;
+/** Values a statement may quote that do not belong in a comment, though the file is in the repo. */
+export function redact(sql) {
+    return sql.replace(/\b(PASSWORD|SECRET|SECRET_ACCESS_KEY|ACCESS_KEY_ID|TOKEN)(\s*=?\s*)'(?:[^'\\]|\\.)*'/gi, "$1$2'[redacted]'");
+}
+const changes = (cs) => cs.map((c) => `${c.rule} ${c.class}${c.destructive ? " (destructive)" : ""} ${c.field}`).join(", ");
+const stepRule = (s) => s.kind === "statement"
+    ? { rule: s.rule, cls: `${s.class}${s.destructive ? ", destructive" : ""}` }
+    : { rule: [...new Set(s.changes.map((c) => c.rule))].join(", "), cls: [...new Set(s.changes.map((c) => `${c.class}${c.destructive ? ", destructive" : ""}`))].join("; ") };
+const stepKind = (s) => (s.kind === "statement" ? "statement" : s.kind === "op" ? `Op ${s.op}` : "manual");
+function pendingMarks(p) {
+    const marks = [];
+    if (p.outOfOrder)
+        marks.push("out of order");
+    if (p.resumeAt !== undefined)
+        marks.push(`ran part way; resumes at step ${String(p.resumeAt)}`);
+    return marks;
+}
+function approvalLines(a, digest, md) {
+    const code = (s) => (md ? `\`${s}\`` : s);
+    if (!a)
+        return [];
+    if (a.kind === "no-op")
+        return [md ? `No migrations Op: ${a.message.split("\n")[0] ?? ""}` : a.message];
+    const out = [];
+    if (a.latest) {
+        const l = a.latest;
+        if (l.holds)
+            out.push(`Approved by ${l.by} at ${l.at}: the apply after merge runs this plan.`);
+        else if (digest && l.sameDigest)
+            out.push(`The newest approval of ${code(a.gate)}, by ${l.by} at ${l.at}, ${askedAgainLine(l, code)}.`);
+        else if (digest && l.digest) {
+            out.push(`The newest approval of ${code(a.gate)}, by ${l.by} at ${l.at}, is for ${code(l.digest)}, not this plan; it does not hold.`);
+            if (l.moved)
+                out.push(`What moved${l.moved.confirmed ? "" : " (as far as yodel can tell)"}: ${describeMove(l.moved)}.`);
+        }
+        else if (!digest)
+            out.push(`The newest approval of ${code(a.gate)} is by ${l.by} at ${l.at}${l.digest ? ` for ${code(l.digest)}` : ""}.`);
+    }
+    else if (digest)
+        out.push(`Not approved yet. Approving binds exactly this digest; if anything it covers changes before the apply runs, the gate asks again and nothing is applied.`);
+    if (a.ledgerNote)
+        out.push(a.ledgerNote);
+    return out;
+}
+/** `yodel plan <env>` for a project with migrations. */
+export function renderPlanText(plan) {
+    const lines = [`Plan for ${plan.environment} (${plan.dialect}${plan.history ? `, history ${plan.history}` : ""}): ${String(plan.appliedCount)} applied, ${String(plan.pending.length)} pending`];
+    for (const n of plan.notes)
+        lines.push("", n);
+    for (const p of plan.pending) {
+        const marks = pendingMarks(p);
+        lines.push("", `${p.id}${marks.length > 0 ? `  (${marks.join("; ")})` : ""}`);
+        for (const { index, step, done, refused: why } of p.steps) {
+            const { rule, cls } = stepRule(step);
+            lines.push(`  ${String(index)}  ${stepKind(step)}  ${rule} ${cls}  ${step.name}${done ? "  (done in an earlier run)" : ""}`);
+            if (step.kind === "statement")
+                lines.push(...redact(step.sql).split("\n").map((l) => `       ${l}`));
+            else
+                lines.push(...step.detail.split("\n").map((l) => `       ${l}`));
+            if (step.kind !== "statement")
+                lines.push(`       ${why ? `yodel apply refuses it: ${why}` : "yodel apply runs it as this step"}`);
+        }
+    }
+    if (plan.pending.length === 0 && !plan.refusal)
+        lines.push("", "Nothing pending: every migration is applied.");
+    if (plan.problems.length > 0)
+        lines.push("", `Integrity problems (${String(plan.problems.length)}):`, ...plan.problems.map((p) => `  ${p}`));
+    if (plan.refusal)
+        lines.push("", `yodel apply would refuse (exit ${String(plan.refusal.exitCode)}): ${plan.refusal.message}`);
+    if (plan.sinceLast)
+        lines.push("", `Since the last comment's plan (${plan.sinceLast.approved}): ${describeMove(plan.sinceLast)}`);
+    if (plan.digest) {
+        lines.push("", `Plan digest: ${plan.digest}`);
+        if (plan.approval?.kind === "op" && plan.approval.command)
+            lines.push(`Approve it with:`, `  ${plan.approval.command}`);
+    }
+    const a = approvalLines(plan.approval, plan.digest, false);
+    if (a.length > 0)
+        lines.push("", ...a);
+    return `${lines.join("\n")}\n`;
+}
+const cell = (s) => s.replace(/\|/g, "\\|").replace(/\s*\n\s*/g, " ");
+const fence = (text, lang) => {
+    const ticks = "`".repeat(Math.max(3, ...[...text.matchAll(/`+/g)].map((m) => m[0].length + 1)));
+    return `${ticks}${lang}\n${text}\n${ticks}`;
+};
+function pendingMarkdown(p, withSql) {
+    const marks = pendingMarks(p);
+    const out = [`#### \`${p.id}\`${marks.length > 0 ? ` (${marks.join("; ")})` : ""}`, "", "| # | Step | Rule | Class | Object |", "|---|---|---|---|---|"];
+    for (const { index, step, done } of p.steps) {
+        const { rule, cls } = stepRule(step);
+        out.push(`| ${String(index)} | ${step.kind === "statement" ? "statement" : `**${cell(stepKind(step))}**`}${done ? " (done)" : ""} | ${cell(rule)} | ${cell(cls)} | \`${cell(step.name)}\` |`);
+    }
+    const statements = p.steps.filter((s) => s.step.kind === "statement");
+    if (withSql && statements.length > 0) {
+        const sql = statements.map(({ index, step }) => (step.kind === "statement" ? `-- ${String(index)}: ${step.rule} ${step.class}, ${step.name}\n${redact(step.sql)};` : "")).join("\n\n");
+        out.push("", `<details><summary>Statements (${String(statements.length)})</summary>`, "", fence(sql, "sql"), "", "</details>");
+    }
+    const nonStatements = p.steps.filter((s) => s.step.kind !== "statement");
+    const runs = nonStatements.filter((s) => s.refused === undefined && s.step.kind === "op");
+    const refused = nonStatements.filter((s) => !runs.includes(s));
+    if (runs.length > 0) {
+        out.push("", "Op steps:");
+        for (const s of runs)
+            out.push(...opStepMarkdown(s, " yodel apply runs it as this step."));
+    }
+    if (refused.length > 0) {
+        out.push("", "Refused changes:");
+        for (const s of refused) {
+            const { index, step, refused: why } = s;
+            if (step.kind === "op")
+                out.push(...opStepMarkdown(s, why ? ` **yodel apply refuses it:** ${cell(why)}` : ""));
+            else if (step.kind === "manual") {
+                out.push(`- step ${String(index)}, \`${step.name}\`: manual, no Op makes it (${cell(changes(step.changes))}).${why ? " yodel apply refuses it." : ""}`);
+                out.push("", indent(fence(step.detail, "text")));
+            }
+        }
+    }
+    return out;
+}
+/** An Op step: what makes it (the changes, or a backfill's module), then its detail and declaration (a backfill's module as written). */
+function opStepMarkdown({ index, step, source }, runs) {
+    if (step.kind !== "op")
+        return [];
+    const made = step.changes.length > 0 ? changes(step.changes) : (source?.file ?? asBackfill(step)?.options.file ?? "");
+    const what = made ? ` (${cell(made)})` : "";
+    const declaration = source ? fence(redact(source.text).replace(/\n+$/, ""), "ts") : fence(step.declaration, "ts");
+    return [
+        `- step ${String(index)}, \`${step.name}\`: made by Op \`${step.op}\`${what}.${runs}`,
+        "",
+        `  <details><summary>${source ? `${cell(step.op)}: ${cell(source.file)}` : `${cell(step.op)} for ${cell(step.object)}`}</summary>`,
+        "",
+        indent(fence(step.detail, "text")),
+        "",
+        indent(declaration),
+        "",
+        "  </details>",
+    ];
+}
+const indent = (s) => s.split("\n").map((l) => (l ? `  ${l}` : l)).join("\n");
+/** The pull request comment body. */
+export function renderPlanMarkdown(plan, options = {}) {
+    const withSql = options.sql !== false;
+    const out = [
+        commentMarker(plan.environment),
+        `### yodel plan: \`${plan.environment}\``,
+        "",
+        `${plan.dialect === "clickhouse" ? "ClickHouse" : "Postgres"}${plan.history ? `, history \`${plan.history}\`` : ""}: ${String(plan.appliedCount)} applied, **${String(plan.pending.length)} pending**.`,
+    ];
+    for (const n of plan.notes)
+        out.push("", `> ${n}`);
+    if (plan.pending.length > 0) {
+        for (const p of plan.pending)
+            out.push("", ...pendingMarkdown(p, withSql));
+    }
+    else if (!plan.refusal)
+        out.push("", "Nothing pending: every migration is applied.");
+    if (plan.problems.length > 0)
+        out.push("", `#### Integrity problems (${String(plan.problems.length)})`, "", ...plan.problems.map((p) => `- ${cell(p)}`));
+    if (plan.refusal)
+        out.push("", `**\`yodel apply\` would refuse (exit ${String(plan.refusal.exitCode)})**, and applies nothing:`, "", fence(plan.refusal.message, "text"));
+    if (plan.sinceLast)
+        out.push("", `Since the previous version of this comment (\`${plan.sinceLast.approved}\`): ${describeMove(plan.sinceLast)}.`);
+    if (plan.digest) {
+        out.push("", "#### Approval", "", `Plan digest the apply gate binds: \`${plan.digest}\``);
+        if (plan.approval?.kind === "op" && plan.approval.command)
+            out.push("", "Approve it with:", "", fence(plan.approval.command, "sh"));
+    }
+    const a = approvalLines(plan.approval, plan.digest, true);
+    if (a.length > 0)
+        out.push("", ...a);
+    if (plan.approval?.kind === "no-op" && plan.digest) {
+        out.push("", "<details><summary>Declare one</summary>", "", fence(plan.approval.message.split("\n\n").slice(1).join("\n\n"), "ts"), "", "</details>");
+    }
+    if (!withSql)
+        out.push("", "_The statements are left out: the comment would be too long. `yodel plan` prints them._");
+    if (plan.subject)
+        out.push("", `<!-- yodel:subject ${encodeSubject(plan.subject)} -->`);
+    const body = `${out.join("\n")}\n`;
+    if (withSql && body.length > COMMENT_LIMIT)
+        return renderPlanMarkdown(plan, { sql: false });
+    return body;
+}
+/** `yodel plan <env> --json` for a project with migrations. */
+export function planJsonVersioned(plan) {
+    const a = plan.approval;
+    return {
+        environment: plan.environment,
+        dialect: plan.dialect,
+        mode: "versioned",
+        ...(plan.history ? { history: plan.history } : {}),
+        applied: plan.appliedCount,
+        pending: plan.pending.map((p) => ({
+            id: p.id,
+            outOfOrder: p.outOfOrder,
+            ...(p.resumeAt !== undefined ? { resumeAt: p.resumeAt } : {}),
+            steps: p.steps.map(({ index, step, done, refused }) => ({
+                index,
+                kind: step.kind,
+                object: step.object,
+                name: step.name,
+                ...stepRuleJson(step),
+                ...(step.kind === "statement" ? { sql: redact(step.sql) } : { detail: step.detail }),
+                ...(step.kind === "op" ? { op: step.op } : {}),
+                ...(step.kind !== "statement" ? { applyRuns: refused === undefined, ...(refused ? { refused } : {}) } : {}),
+                done,
+            })),
+        })),
+        problems: plan.problems,
+        ...(plan.refusal ? { refusal: plan.refusal } : {}),
+        ...(plan.digest ? { planDigest: plan.digest } : {}),
+        ...(a?.kind === "op"
+            ? {
+                op: a.op,
+                gate: a.gate,
+                ...(a.command ? { approve: a.command } : {}),
+                ...(a.latest ? { approval: { ...a.latest, moved: a.latest.moved ? { confirmed: a.latest.moved.confirmed, changes: a.latest.moved.changes } : undefined } } : {}),
+            }
+            : a
+                ? { opMissing: a.message.split("\n")[0] }
+                : {}),
+        ...(plan.sinceLast ? { sinceLast: { digest: plan.sinceLast.approved, confirmed: plan.sinceLast.confirmed, changes: plan.sinceLast.changes } } : {}),
+        notes: plan.notes,
+    };
+}
+const stepRuleJson = (s) => s.kind === "statement" ? { rule: s.rule, class: s.class, ...(s.destructive ? { destructive: true } : {}) } : { changes: s.changes.map((c) => ({ rule: c.rule, class: c.class, field: c.field, ...(c.destructive ? { destructive: true } : {}) })) };
+//# sourceMappingURL=render.js.map

package/dist/pr/render.js.map

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

package/dist/project.d.ts

@@ -0,0 +1,62 @@
+/**
+ * A SQL Yodeler project: the directory that holds `chant.config.ts`, its
+ * dialect, and the server each environment names in `sql.profiles.<env>`.
+ *
+ * Every verb starts here: `loadProject()` finds and evaluates the config,
+ * `resolveEnvironment()` picks one profile. Calling chant is in `./chant/`.
+ */
+import type { SqlConfig, SqlProfile } from "@intentius/chant-lexicon-sql/config";
+import type { SqlDialect } from "@intentius/chant-lexicon-sql/dialects";
+import type { YodelConfig } from "./config/define.js";
+export type { SqlDialect, SqlProfile };
+/** An error a verb reports as one line on stderr, with the exit code it ends with. */
+export declare class YodelError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+/** The parts of a loaded `chant.config.ts` yodel reads. */
+export interface ProjectConfig {
+    lexicons?: string[];
+    sourceDir?: string;
+    sql?: SqlConfig;
+    [key: string]: unknown;
+}
+export interface Project {
+    /** The absolute directory holding `chant.config.ts`. */
+    dir: string;
+    configPath: string;
+    /** The config as chant loaded and validated it. */
+    config: ProjectConfig;
+    /** `sql.dialect`, `clickhouse` when the config names none (chant's default). */
+    dialect: SqlDialect;
+    /** Where the declared schema lives, relative to `dir`: `sourceDir`, else `src` when it exists, else `.`. */
+    sourceDir: string;
+    /** `yodel.config.ts`, checked, when the project has one (`./config/`). */
+    yodel?: {
+        path: string;
+        config: YodelConfig;
+    } | undefined;
+}
+export interface Environment {
+    name: string;
+    /** `sql.profiles.<name>`. */
+    profile: SqlProfile;
+}
+/** The nearest directory at or above `start` that holds `chant.config.ts`. */
+export declare function findProjectDir(start: string): string | undefined;
+/**
+ * The dialect a config declares. A list is refused: yodel manages one
+ * database per project, and one chant build holds one dialect.
+ */
+export declare function projectDialect(config: ProjectConfig, configPath: string): SqlDialect;
+/** Builds a {@link Project} from a config already loaded. Pure, for tests and callers that load the config themselves. */
+export declare function projectFromConfig(dir: string, configPath: string, config: ProjectConfig, yodel?: Project["yodel"]): Project;
+/**
+ * Finds the project at or above `start` (default: the working directory) and
+ * loads its `chant.config.ts` through chant's own loader, so it is validated
+ * the same way `chant build` validates it, and its `yodel.config.ts` when
+ * there is one.
+ */
+export declare function loadProject(start?: string): Promise<Project>;
+/** `sql.profiles.<name>`, or an error naming the environments the project declares. */
+export declare function resolveEnvironment(project: Project, name: string): Environment;

package/dist/project.js

@@ -0,0 +1,92 @@
+/**
+ * A SQL Yodeler project: the directory that holds `chant.config.ts`, its
+ * dialect, and the server each environment names in `sql.profiles.<env>`.
+ *
+ * Every verb starts here: `loadProject()` finds and evaluates the config,
+ * `resolveEnvironment()` picks one profile. Calling chant is in `./chant/`.
+ */
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+/** An error a verb reports as one line on stderr, with the exit code it ends with. */
+export class YodelError extends Error {
+    exitCode;
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = "YodelError";
+    }
+}
+/** The nearest directory at or above `start` that holds `chant.config.ts`. */
+export function findProjectDir(start) {
+    let dir = resolve(start);
+    for (;;) {
+        if (existsSync(join(dir, "chant.config.ts")))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+/**
+ * The dialect a config declares. A list is refused: yodel manages one
+ * database per project, and one chant build holds one dialect.
+ */
+export function projectDialect(config, configPath) {
+    const dialect = config.sql?.dialect;
+    if (dialect === undefined)
+        return "clickhouse";
+    if (Array.isArray(dialect)) {
+        if (dialect.length === 1 && dialect[0])
+            return dialect[0];
+        throw new YodelError(`${configPath}: sql.dialect lists ${dialect.join(", ")}; a yodel project is one database, so name one dialect`);
+    }
+    return dialect;
+}
+/** Builds a {@link Project} from a config already loaded. Pure, for tests and callers that load the config themselves. */
+export function projectFromConfig(dir, configPath, config, yodel) {
+    if (!(config.lexicons ?? []).includes("sql")) {
+        throw new YodelError(`${configPath}: lexicons does not include "sql"; add lexicons: ["sql"] and import "@intentius/chant-lexicon-sql"`);
+    }
+    const sourceDir = config.sourceDir ?? (existsSync(join(dir, "src")) ? "src" : ".");
+    return { dir, configPath, config, dialect: projectDialect(config, configPath), sourceDir, ...(yodel ? { yodel } : {}) };
+}
+/**
+ * Finds the project at or above `start` (default: the working directory) and
+ * loads its `chant.config.ts` through chant's own loader, so it is validated
+ * the same way `chant build` validates it, and its `yodel.config.ts` when
+ * there is one.
+ */
+export async function loadProject(start = process.cwd()) {
+    const dir = findProjectDir(start);
+    if (!dir)
+        throw new YodelError(`no chant.config.ts in ${resolve(start)} or any directory above it`);
+    const { loadChantConfig } = await import("@intentius/chant/config");
+    let loaded;
+    try {
+        loaded = await loadChantConfig(dir);
+    }
+    catch (e) {
+        throw new YodelError(e instanceof Error ? e.message : String(e));
+    }
+    const config = loaded.config;
+    const { loadYodelConfig } = await import("./config/load.js");
+    const yodel = await loadYodelConfig(dir, Object.keys(config.sql?.profiles ?? {}));
+    return projectFromConfig(dir, loaded.configPath ?? join(dir, "chant.config.ts"), config, yodel);
+}
+/** `sql.profiles.<name>`, or an error naming the environments the project declares. */
+export function resolveEnvironment(project, name) {
+    const profiles = project.config.sql?.profiles ?? {};
+    const profile = profiles[name];
+    if (!profile) {
+        const declared = Object.keys(profiles);
+        throw new YodelError(`no environment "${name}": ${project.configPath} declares no sql.profiles.${name}` +
+            (declared.length > 0 ? ` (declared: ${declared.join(", ")})` : " (it declares no sql.profiles)"));
+    }
+    const postgres = /^postgres(ql)?:\/\//.test(profile.url);
+    if (postgres !== (project.dialect === "postgres")) {
+        throw new YodelError(`sql.profiles.${name}.url is a ${postgres ? "Postgres" : "ClickHouse"} server, but the project's dialect is ${project.dialect}`);
+    }
+    return { name, profile };
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

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

package/dist/rebase/index.d.ts

@@ -0,0 +1,121 @@
+/**
+ * `yodel rebase` (#15): move a migration onto another parent, so two
+ * branches that each added one can both merge.
+ *
+ * Two pull requests that each ran `yodel new` from the same newest
+ * migration give it two children: a fork, which `readMigrations` refuses.
+ * Rebasing moves one of them (the newer, unless named) and every migration
+ * that follows it onto the end of the other branch, and rewrites each one's
+ * `migration.json` and `migration.sql`:
+ *
+ * - its change is its recorded schema minus its old parent's recorded
+ *   schema, object by object (keyed by export name, as chant's diff keys
+ *   them);
+ * - its new recorded schema is the new parent's recorded schema with that
+ *   change applied: a three-way merge, base the old parent, ours the
+ *   migration, theirs the new parent. For the usual case, two branches that
+ *   change different objects, that is the schema the declared build has
+ *   once both are merged;
+ * - its statements are diffed again, from the new parent's recorded schema
+ *   to the new recorded schema, and its checksum recomputed; a backfill
+ *   step (#12) is kept at the end, and its module (one of the migration's
+ *   own files, unchanged) counts in the new checksum;
+ * - each `-- yodel:allow <rule> <reason>` line (#14) is carried over to the
+ *   same step in the new file: the step `migration.json` records exactly as
+ *   before, found in order. When the step a line silenced is gone from the
+ *   rebased migration, or is not the same step any more, the rebase refuses
+ *   and names the line: a reason given for one statement is not moved onto
+ *   another.
+ *
+ * When both sides change the same object (by export name, or by the name it
+ * has on the server) and do not make the same change, the rebase refuses
+ * and names the object: no merge of two changes to one table is safe to
+ * guess. The author resolves it by hand: delete the migration and run
+ * `yodel new` again on top of the other branch.
+ *
+ * Ids are kept. The order is the chain of parent ids, never the ids'
+ * timestamps, so a rebased migration whose timestamp is older than its new
+ * parent's is in order; renaming it would change nothing about when it
+ * runs and would break whatever already names it (a review, a branch,
+ * another migration's parent).
+ *
+ * Pure apart from {@link writeRebase}: migrations in, the rewritten ones
+ * out.
+ */
+import { type SchemaStatements } from "@intentius/chant-lexicon-sql/migration-statements";
+import { YodelError } from "../project.js";
+import type { BuildOutput } from "../chant/build.js";
+import { type Migration, type MigrationDocument, type MigrationFiles } from "../migrations/index.js";
+import { type Silence } from "../lint/index.js";
+/** Exit code: the rebase is refused (a conflict, hand edits, a silence it cannot carry over, or a migration a history records). Nothing was written. */
+export declare const REBASE_REFUSED = 4;
+export interface RebaseOptions {
+    /** The migration to move. Default: the newer child of the directory's one fork. */
+    id?: string | undefined;
+    /** Its new parent. Default: the end of the other branch of its fork. */
+    onto?: string | undefined;
+}
+/** One migration as the rebase rewrites it. */
+export interface RebasedMigration {
+    id: string;
+    dir: string;
+    oldParent: string | null;
+    parent: string;
+    oldChecksum: string;
+    checksum: string;
+    document: MigrationDocument;
+    files: MigrationFiles;
+    statements: SchemaStatements;
+    /** Its `-- yodel:allow` lines, carried over: each with its step and line in the rewritten files. */
+    silences: Silence[];
+    /** Its files differed from what yodel writes for it (an edit by hand, or a checksum that no longer matches): the rewrite drops that edit. */
+    handEdited: boolean;
+}
+export interface RebasePlan {
+    /** The migration moved; the ones after it in {@link rewritten} follow it, and move with it. */
+    moved: string;
+    from: string | null;
+    onto: string;
+    /** In chain order, the moved migration first. */
+    rewritten: RebasedMigration[];
+}
+/** Nothing to rebase: the directory has no fork and no migration was named. */
+export interface NothingToRebase {
+    moved: undefined;
+}
+/** Two sides change one object differently. */
+export declare class RebaseConflict extends YodelError {
+    readonly migration: string;
+    readonly objects: string[];
+    constructor(migration: string, objects: string[], message: string);
+}
+/**
+ * The three-way merge of one migration's change onto a new base: `base1`
+ * with every object `ours` changed from `base0` changed the same way.
+ * Throws a {@link RebaseConflict} when `base1` (theirs) changed one of
+ * those objects too, differently.
+ */
+export declare function mergeChange(base0: BuildOutput, ours: BuildOutput, base1: BuildOutput, label: {
+    migration: string;
+    theirs: string;
+}): BuildOutput;
+/** A migration document's steps as chant's `SchemaStatements`, to render them again. */
+export declare function statementsOf(doc: MigrationDocument): SchemaStatements;
+/**
+ * Whether a migration's files are what yodel writes for its document: its
+ * SQL rendered from its steps, and its checksum matching. Its well-formed
+ * `-- yodel:allow` lines do not count as an edit: a rebase carries them
+ * over.
+ */
+export declare function asWritten(m: Migration): boolean;
+/**
+ * What a rebase would write. `migrations` is every migration in the
+ * directory (`scanMigrations(dir).migrations`: a fork is what this is for,
+ * so `readMigrations` would refuse it). Throws a YodelError when the
+ * migration or its new parent cannot be chosen, and a
+ * {@link RebaseConflict} when one rewritten migration's change meets a
+ * different change to the same object.
+ */
+export declare function planRebase(migrations: readonly Migration[], options?: RebaseOptions): RebasePlan | NothingToRebase;
+/** Writes each rewritten migration over its files, each file through a temporary one renamed into place. */
+export declare function writeRebase(plan: RebasePlan): void;