@intentius/sql-yodeler 0.0.0-stage → 0.2.0

package/dist/commands/init.js

@@ -0,0 +1,139 @@
+import { parseArgs } from "node:util";
+import { guarded } from "../env-args.js";
+import { loadProject, resolveEnvironment, YodelError } from "../project.js";
+import { migrationId } from "../migrations/index.js";
+import { adopt, BASELINE_NAME } from "../init/index.js";
+const usage = "usage: yodel init --from <env> [--json] [--dir <project>] [--force] [--name <name>]";
+const help = `${usage}
+
+Adopts an existing database. Reads the live database sql.profiles.<env>
+binds, with chant's import (what chant import --from <env> runs), writes
+its declarations to the source directory (sourceDir, else src/), builds
+them and plans them against the same database, which must show no change.
+Then writes the baseline migration, migrations/<YYYYMMDDTHHMM>-baseline/,
+the first migration (no parent), whose statements create everything, and
+records it applied in the history table (yodel.config.ts history.database,
+else YODEL_HISTORY_DATABASE, default yodeler) without running any of them.
+From there, yodel plan <env> shows no change, yodel status <env> lists the
+baseline applied with nothing pending, and yodel new writes the next
+migration after the baseline.
+
+The live database is only read. The one write to the server is the
+baseline's history row (and the history's database and table, when they
+are not there yet). If any step fails, every file init wrote is taken back.
+
+What must exist first: a project directory with a chant.config.ts that has
+lexicons: ["sql"], sql.dialect and sql.profiles.<env> (credentials by env
+var), and a package.json from which chant and @intentius/chant-lexicon-sql
+resolve, since chant builds the declarations. For ClickHouse the profile
+must list the project's databases (sql.profiles.<env>.databases), for
+Postgres its schemas (sql.profiles.<env>.schemas), and the history's
+database (schema) must not be one of them. init does not write
+chant.config.ts.
+
+Postgres: the same, the history being <history database>.history in a
+schema of that name (default yodeler.history), and the profile listing the
+project's schemas (sql.profiles.<env>.schemas), the history's not among them.
+
+Ownership: chant's import strips chant's ownership marker from comments,
+and the plan compares declared definitions without it, so objects made by
+hand (no marker) plan clean. init does not stamp the marker on them: they
+stay unmarked, so chant never prunes them, until a declarative apply
+restamps their comments.
+
+Options:
+  --from <env>     the environment to adopt (required)
+  --name <name>    the baseline migration's name (default ${BASELINE_NAME})
+  --force          overwrite declaration files the source directory already has
+  --json           print what was done as JSON
+  -C, --dir <dir>  the project directory (default: the working directory)
+
+Exit codes:
+  0  adopted: declarations and the baseline written, the baseline recorded applied
+  4  refused, nothing written: the source directory already declares a
+     schema (without --force), the project already has migrations, the
+     history already records migrations, the environment holds nothing, or
+     a ClickHouse profile with no databases or with the history's database
+  5  another apply holds the lock; nothing recorded, nothing kept
+  1  anything else failed, and nothing was kept: a bad config, a server it
+     cannot read, a build or a plan that is not clean after the import
+`;
+function parseInitArgs(args) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args,
+            allowPositionals: false,
+            strict: true,
+            options: {
+                from: { type: "string" },
+                json: { type: "boolean" },
+                dir: { type: "string", short: "C" },
+                force: { type: "boolean" },
+                name: { type: "string" },
+            },
+        });
+    }
+    catch (e) {
+        throw new YodelError(`${e instanceof Error ? e.message : String(e)}\n${usage}`);
+    }
+    const { values } = parsed;
+    if (typeof values.from !== "string" || values.from === "")
+        throw new YodelError(`--from <env> is required\n${usage}`);
+    const name = typeof values.name === "string" ? values.name : BASELINE_NAME;
+    migrationId(name, new Date()); // a bad name fails before anything is read
+    return {
+        from: values.from,
+        json: values.json === true,
+        dir: typeof values.dir === "string" ? values.dir : process.cwd(),
+        force: values.force === true,
+        name,
+    };
+}
+/** `yodel init --json` (schemas/init.schema.json). */
+export function initJson(a) {
+    return {
+        environment: a.environment,
+        dialect: a.dialect,
+        status: "adopted",
+        objects: a.objects,
+        schemaFiles: a.schemaFiles,
+        migration: { path: a.migrationPath, ...a.baseline },
+        recorded: { history: a.recorded.database, seq: a.recorded.row.seq, note: a.recorded.row.note, appliedBy: a.recorded.row.applied_by },
+        warnings: a.warnings,
+    };
+}
+function report(io, json, a) {
+    if (json) {
+        io.out(`${JSON.stringify(initJson(a), null, 2)}\n`);
+        return;
+    }
+    const lines = [
+        `Adopted ${a.environment} (${a.dialect}): ${String(a.objects.length)} object${a.objects.length === 1 ? "" : "s"}`,
+        ...a.objects.map((o) => `  ${o}`),
+        "",
+        `Declarations: ${a.schemaFiles.join(", ")}`,
+        `Baseline:     ${a.migrationPath}/ (${String(a.baseline.statements)} statement${a.baseline.statements === 1 ? "" : "s"}, ${a.baseline.checksum})`,
+        `Recorded:     applied in ${a.recorded.database}.history as a baseline; none of its statements was run`,
+        "",
+        `yodel plan ${a.environment} shows no change, and yodel status ${a.environment} lists the baseline applied.`,
+    ];
+    for (const w of a.warnings)
+        lines.push(`warning: ${w}`);
+    io.out(`${lines.join("\n")}\n`);
+}
+/** `yodel init --from <env>`; the exit codes are in `help`. */
+export const init = {
+    name: "init",
+    summary: "adopt a live database: declarations and a baseline recorded applied",
+    implemented: true,
+    run: (args, io) => guarded("init", io, args, help, async () => {
+        const a = parseInitArgs(args);
+        const project = await loadProject(a.dir);
+        const env = resolveEnvironment(project, a.from);
+        const adopted = await adopt(project, env, { force: a.force, name: a.name, log: (l) => { io.err(`${l}\n`); } });
+        report(io, a.json, adopted);
+        return 0;
+    }),
+};
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/lint.d.ts

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

package/dist/commands/lint.js

@@ -0,0 +1,202 @@
+import { parseArgs } from "node:util";
+import { guarded } from "../env-args.js";
+import { loadProject, resolveEnvironment, YodelError } from "../project.js";
+import { scanMigrations } from "../migrations/index.js";
+import { inspect, migrationsDir, openVersioned } from "../versioned/index.js";
+import { LINT_RULES, lintExitCode, lintJson, lintMigrations, lintSettings, renderLint, updateChecksum } from "../lint/index.js";
+import { projectRules, REPLAY_RULE, replayRule } from "../lint/project-rules.js";
+import { renderReplay, replayHistory, replayJson } from "../replay/index.js";
+const usage = "usage: yodel lint [--env <env>] [--replay <env> [--reset] [--reset-shared <profile>]... [--keep]] [--json] [--dir <project>] [--update-checksum <id>]... [--rules]";
+const help = `${usage}
+
+Checks the migrations directory against every lint rule, offline: no server
+and no dev database. Every rule is free and runs in CI on every pull request.
+
+Rules (yodel lint --rules lists them with their levels):
+  fork               two migrations follow the same parent (yodel rebase)
+  directory          not one readable chain: a bad name or file, a missing
+                     parent, a cycle, a migration of another dialect
+  checksum           a migration's files no longer hash to its checksum
+  unreadable-object  an object in a recorded schema, or a step, the sql
+                     lexicon cannot read or classify; an error, never skipped
+  destructive        a drop that removes data for good
+  pg-rewrite         Postgres: a rewrite or full scan under ACCESS EXCLUSIVE
+  pg-lock            Postgres: writes blocked for a whole index build or scan
+  ch-mutation        ClickHouse: a mutation rewriting parts, no rollback
+  ch-rebuild         ClickHouse: a rebuild (ClickHouseRebuildOp)
+  refused-step       a step yodel apply refuses (a manual step, an Op it
+                     does not run)
+  migration-sql      migration.sql does not hold a statement migration.json
+                     records (apply runs migration.json's)
+  silence            a yodel:allow line that is wrong or silences nothing
+  replay             with --replay <env>: the history, replayed into a fresh
+                     database on <env>'s server, does not give a migration's
+                     recorded schema (names the first that differs)
+
+Silencing: a line above a statement in its migration.sql,
+  -- yodel:allow <rule> <reason>
+silences that statement rule (destructive, pg-rewrite, pg-lock,
+ch-mutation, ch-rebuild) for that one statement. The reason is required,
+and yodel apply records the rule, the statement and the reason in every
+history row the migration writes (the silences column). Adding the line
+changes the migration's checksum: for a migration not yet applied anywhere,
+record the new one with --update-checksum <id>.
+
+Levels: yodel.config.ts lint.rules sets a rule to "error", "warning" or
+"off", e.g. lint: { rules: { "ch-mutation": "warning" } }. fork, directory,
+checksum and unreadable-object are always errors.
+
+Options:
+  --env <env>             also compare with <env>'s history: a
+                          checksum error is then an applied migration whose
+                          files changed since it ran; a pending migration's
+                          edit is a warning
+  --update-checksum <id>  first write <id>'s migration.json checksum to match
+                          its files (repeatable); refused with --env when <id>
+                          is applied there
+  --replay <env>          also replay every migration in order into <env>'s
+                          server (a throwaway emulator: chant emulator up
+                          --lexicon sql) and compare each with its recorded
+                          schema; the databases or schemas the history names
+                          must not exist there yet
+  --reset                 with --replay: drop those databases or schemas
+                          first when they exist. Destructive: never against a
+                          server whose data matters
+  --reset-shared <profile>
+                          with --replay: replay even though <profile> binds
+                          the same server and names one of those databases or
+                          schemas, which the replay then empties (repeatable).
+                          Refused without it, --reset or not
+  --keep                  with --replay: leave the replayed database in place
+  --rules                 list the rules and their levels, and exit
+  --json                  print the findings as JSON
+  -C, --dir <dir>         the project directory (default: the working directory)
+
+Exit codes:
+  0  no errors (warnings and silenced findings do not fail)
+  3  at least one error (a replay that differs counts)
+  4  --replay: the target already holds what the history names, and --reset
+     was not given, or another profile binds the same server and names one
+     of them and --reset-shared does not name it; nothing was run
+  1  lint could not run: a bad config, an unknown migration for
+     --update-checksum, a server that does not answer (--env)
+`;
+function parseLintArgs(args) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args,
+            allowPositionals: false,
+            strict: true,
+            options: {
+                env: { type: "string" },
+                replay: { type: "string" },
+                reset: { type: "boolean" },
+                "reset-shared": { type: "string", multiple: true },
+                keep: { type: "boolean" },
+                json: { type: "boolean" },
+                dir: { type: "string", short: "C" },
+                "update-checksum": { type: "string", multiple: true },
+                rules: { type: "boolean" },
+            },
+        });
+    }
+    catch (e) {
+        throw new YodelError(`${e instanceof Error ? e.message : String(e)}\n${usage}`);
+    }
+    const v = parsed.values;
+    const update = v["update-checksum"];
+    const replay = typeof v.replay === "string" ? v.replay : undefined;
+    const resetShared = Array.isArray(v["reset-shared"]) ? v["reset-shared"].filter((r) => typeof r === "string") : [];
+    if (replay === undefined && (v.reset === true || v.keep === true || resetShared.length > 0))
+        throw new YodelError(`--reset, --reset-shared and --keep go with --replay <env>\n${usage}`);
+    return {
+        env: typeof v.env === "string" ? v.env : undefined,
+        replay,
+        reset: v.reset === true,
+        resetShared,
+        keep: v.keep === true,
+        json: v.json === true,
+        dir: typeof v.dir === "string" ? v.dir : process.cwd(),
+        update: Array.isArray(update) ? update.filter((u) => typeof u === "string") : [],
+        rules: v.rules === true,
+    };
+}
+function allRules() {
+    return { ...LINT_RULES, ...Object.fromEntries(projectRules.map((r) => [r.rule.id, r.rule])), [REPLAY_RULE.id]: REPLAY_RULE };
+}
+function listRules(io, json, project) {
+    const rules = allRules();
+    const settings = lintSettings(project.yodel?.config.lint, rules, project.yodel?.path);
+    const rows = Object.values(rules).map((r) => ({ ...r, configured: settings.levels[r.id] ?? r.level }));
+    if (json) {
+        io.out(`${JSON.stringify(rows, null, 2)}\n`);
+        return 0;
+    }
+    const width = Math.max(...rows.map((r) => r.id.length));
+    for (const r of rows) {
+        const marks = [r.configured, r.silenceable ? "silenceable" : "", r.dialect ?? ""].filter(Boolean).join(", ");
+        io.out(`${r.id.padEnd(width)}  ${marks}\n${" ".repeat(width + 2)}${r.summary}\n`);
+    }
+    return 0;
+}
+/** `yodel lint`; the exit codes are in `help`. */
+export const lint = {
+    name: "lint",
+    summary: "check the migrations against the lint rules",
+    implemented: true,
+    run: (args, io) => guarded("lint", io, args, help, async () => {
+        const a = parseLintArgs(args);
+        const project = await loadProject(a.dir);
+        if (a.rules)
+            return listRules(io, a.json, project);
+        const settings = lintSettings(project.yodel?.config.lint, allRules(), project.yodel?.path);
+        const dir = migrationsDir(project);
+        const options = { dialect: project.dialect, project, settings, rules: projectRules };
+        if (a.env !== undefined) {
+            const env = resolveEnvironment(project, a.env);
+            const ordered = scanMigrations(dir).ordered;
+            if (ordered) {
+                const venv = await openVersioned(project, env);
+                const { status } = await inspect(venv, ordered, { sync: false });
+                options.history = { environment: env.name, status };
+            }
+            else if (!a.json) {
+                io.err(`yodel lint: the migrations directory is not one chain, so it is not compared with ${env.name}'s history; fix the findings below first\n`);
+            }
+        }
+        if (a.update.length > 0) {
+            const byId = new Map(scanMigrations(dir).migrations.map((m) => [m.id, m]));
+            for (const id of a.update) {
+                const m = byId.get(id);
+                if (!m)
+                    throw new YodelError(`--update-checksum ${id}: no such migration in ${dir}`);
+                const applied = options.history?.status.applied.some((x) => x.id === id);
+                if (applied)
+                    throw new YodelError(`--update-checksum ${id}: it is applied in ${String(options.history?.environment)}; record an intended edit there with yodel repair ${id} --reason ... ${String(options.history?.environment)}`);
+                const changed = updateChecksum(m);
+                if (!a.json)
+                    io.err(changed ? `${id}: checksum ${changed.from} is now ${changed.to}\n` : `${id}: its checksum already matches its files\n`);
+            }
+        }
+        let replay;
+        if (a.replay !== undefined) {
+            const env = resolveEnvironment(project, a.replay);
+            if (scanMigrations(dir).ordered) {
+                // A target that is not fresh throws here, exit 4, before anything is linted or run.
+                replay = await replayHistory(project, env, { reset: a.reset, resetShared: a.resetShared, keep: a.keep, log: (l) => { io.err(`replay: ${l}\n`); } });
+                options.rules = [...projectRules, replayRule(replay)];
+            }
+            else {
+                io.err(`yodel lint: the migrations directory is not one chain, so it is not replayed; fix the findings below first\n`);
+            }
+        }
+        const report = await lintMigrations(dir, options);
+        if (a.json)
+            io.out(`${JSON.stringify({ ...lintJson(report), ...(replay ? { replay: replayJson(replay) } : {}) }, null, 2)}\n`);
+        else
+            io.out(`${replay ? `${renderReplay(replay)}\n` : ""}${renderLint(report)}`);
+        return lintExitCode(report);
+    }),
+};
+//# sourceMappingURL=lint.js.map

package/dist/commands/lint.js.map

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

package/dist/commands/mcp.d.ts

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

package/dist/commands/mcp.js

@@ -0,0 +1,50 @@
+import { parseArgs } from "node:util";
+import { resolve } from "node:path";
+import { guarded } from "../env-args.js";
+import { loadProject, YodelError } from "../project.js";
+import { YodelMcpServer } from "../mcp/server.js";
+import { yodelTools } from "../mcp/tools.js";
+const usage = "usage: yodel mcp [--dir <project>]";
+const help = `${usage}
+
+Serves read-only tools for a coding agent over the Model Context Protocol, on
+stdin and stdout: status, plan, lint, drift, history and explain. Each runs
+the yodel command of the same name with --json, in the project, and returns
+its exit code and output in an envelope (schemas/mcp.schema.json). There is
+no tool that applies, approves, repairs, rebases or writes a migration, and
+the server refuses to start with one. A plan carries the commands that are a
+person's to run: the approve command, and an override for a denied policy rule.
+
+Start it with the reader's credentials in the environment, the ones
+yodel plan uses; the tools read the servers chant.config.ts names.
+
+Options:
+  -C, --dir <dir>  the project directory (default: the working directory)
+
+Exit codes:
+  0  stdin closed
+  1  the server could not start: no project in the directory
+`;
+/** `yodel mcp`; the exit codes are in `help`. */
+export const mcp = {
+    name: "mcp",
+    summary: "serve read-only tools to a coding agent (MCP, stdio)",
+    implemented: true,
+    run: (args, io) => guarded("mcp", io, args, help, async () => {
+        let dir;
+        try {
+            const { values } = parseArgs({ args, strict: true, allowPositionals: false, options: { dir: { type: "string", short: "C" } } });
+            dir = resolve(values.dir ?? process.cwd());
+        }
+        catch (e) {
+            throw new YodelError(`${e instanceof Error ? e.message : String(e)}\n${usage}`);
+        }
+        // Refuse to start outside a project, rather than answer every call with the same error.
+        dir = (await loadProject(dir)).dir;
+        const server = new YodelMcpServer(yodelTools(dir));
+        io.err(`yodel mcp: serving ${server.list().map((t) => t.name).join(", ")} for ${dir} on stdio\n`);
+        await server.serve();
+        return 0;
+    }),
+};
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,KAAK,GAAG,oCAAoC,CAAC;AAEnD,MAAM,IAAI,GAAG,GAAG,KAAK;;;;;;;;;;;;;;;;;;;CAmBpB,CAAC;AAEF,iDAAiD;AACjD,MAAM,CAAC,MAAM,GAAG,GAAY;IAC1B,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,sDAAsD;IAC/D,WAAW,EAAE,IAAI;IACjB,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAChB,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE;QACxC,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;YAChI,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,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;QAClF,CAAC;QACD,wFAAwF;QACxF,GAAG,GAAG,CAAC,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,EAAE,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,aAAa,CAAC,CAAC;QAClG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;CACL,CAAC"}

package/dist/commands/new.d.ts

@@ -0,0 +1,5 @@
+import type { Command } from "../command.js";
+/** `yodel new <name>`; the exit codes are in `help`. */
+export declare const newCommand: Command;
+/** Exit code: --replace refused; nothing written. */
+export declare const REPLACE_REFUSED = 4;