@intentius/sql-yodeler 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/dist/apply-steps/index.d.ts +73 -21
  2. package/dist/apply-steps/index.js +171 -49
  3. package/dist/apply-steps/index.js.map +1 -1
  4. package/dist/ci/render.d.ts +7 -2
  5. package/dist/ci/render.js +12 -2
  6. package/dist/ci/render.js.map +1 -1
  7. package/dist/commands/apply.js +173 -64
  8. package/dist/commands/apply.js.map +1 -1
  9. package/dist/commands/drift.js +8 -8
  10. package/dist/commands/drift.js.map +1 -1
  11. package/dist/commands/override.js +46 -22
  12. package/dist/commands/override.js.map +1 -1
  13. package/dist/commands/plan.js +19 -19
  14. package/dist/commands/plan.js.map +1 -1
  15. package/dist/commands/revert.js +3 -2
  16. package/dist/commands/revert.js.map +1 -1
  17. package/dist/config/define.d.ts +5 -5
  18. package/dist/mcp/tools.d.ts +1 -1
  19. package/dist/mcp/tools.js +6 -4
  20. package/dist/mcp/tools.js.map +1 -1
  21. package/dist/notify/index.d.ts +30 -97
  22. package/dist/notify/index.js +50 -154
  23. package/dist/notify/index.js.map +1 -1
  24. package/dist/notify/verify.d.ts +17 -31
  25. package/dist/notify/verify.js +16 -47
  26. package/dist/notify/verify.js.map +1 -1
  27. package/dist/pr/forge.d.ts +33 -38
  28. package/dist/pr/forge.js +74 -97
  29. package/dist/pr/forge.js.map +1 -1
  30. package/dist/pr/issue.d.ts +16 -33
  31. package/dist/pr/issue.js +17 -88
  32. package/dist/pr/issue.js.map +1 -1
  33. package/dist/pr/model.js +7 -2
  34. package/dist/pr/model.js.map +1 -1
  35. package/dist/pr/render.js +2 -2
  36. package/dist/pr/render.js.map +1 -1
  37. package/dist/release/index.d.ts +63 -0
  38. package/dist/release/index.js +122 -0
  39. package/dist/release/index.js.map +1 -0
  40. package/dist/report/audit.d.ts +18 -19
  41. package/dist/report/audit.js +57 -27
  42. package/dist/report/audit.js.map +1 -1
  43. package/dist/report/model.js +18 -5
  44. package/dist/report/model.js.map +1 -1
  45. package/dist/tenants/wave.d.ts +6 -2
  46. package/dist/tenants/wave.js +1 -3
  47. package/dist/tenants/wave.js.map +1 -1
  48. package/dist/versioned/policy.d.ts +44 -24
  49. package/dist/versioned/policy.js +70 -37
  50. package/dist/versioned/policy.js.map +1 -1
  51. package/dist/waves/index.d.ts +4 -10
  52. package/dist/waves/index.js +8 -33
  53. package/dist/waves/index.js.map +1 -1
  54. package/package.json +7 -7
  55. package/schemas/event.schema.json +218 -26
  56. package/dist/pr/comment.d.ts +0 -32
  57. package/dist/pr/comment.js +0 -99
  58. package/dist/pr/comment.js.map +0 -1
@@ -1,25 +1,34 @@
1
1
  /**
2
2
  * Steps around apply (#64): per environment, `yodel.config.ts`
3
3
  * `environments.<env>.steps.before` and `.after`, SQL checks or commands
4
- * run around the versioned apply.
4
+ * run around the versioned apply, as chant's Op waves stage hooks (#206).
5
5
  *
6
- * - Read at the base commit (`../config/base.ts`), as the plan policy is:
7
- * a pull request that adds, removes or loosens a step is run under the
8
- * steps the branch had. A checkout with no base to read runs none.
9
- * - `before` steps run under the lock before the first migration. SQL
10
- * checks also run when the run is planned (the wave plan, or `yodel apply`
11
- * before the gate), since they only read; a command, which may have side
12
- * effects, runs once per apply, under the lock, and the plan only shows
13
- * that it will (#107). One that fails refuses the run (exit 4) unless its
14
- * `onFailure` is `approve`: then the wave is held for a person, whatever
15
- * its gate, and the plan they approve says which steps failed.
16
- * - `after` steps run under the lock once the last migration's statements
17
- * succeeded. One that fails fails the run (exit 1); the migrations stay
6
+ * - Each step is a hook ({@link stepHooks}). A SQL check runs `yodel apply
7
+ * <env> --step-sql`, which yodel runs in process ({@link runStepHooks}); a
8
+ * command runs `sh -c`. `yodel ci` writes them into yodel-waves.json,
9
+ * with `hooks.apply.runBy: "apply"`, and chant reads them there at the
10
+ * base commit, as it reads the gate policy.
11
+ * - `before` SQL checks are `before.plan` hooks: chant runs them when it
12
+ * plans the wave, and one that fails with `onFailure: "approve"` holds the
13
+ * wave for a person, whatever its gate, before the apply is called. Every
14
+ * `before` step is also a `before.apply` hook, and every `after` step an
15
+ * `after.apply` hook: the apply runs those under its lock, through
16
+ * chant's runner, before the first migration and once the last one
17
+ * succeeded. A command, which may have side effects, runs once per apply,
18
+ * under the lock, never when the wave is planned (#107).
19
+ * - In order: a step that fails stops the ones after it, unless its
20
+ * `onFailure` is `approve`. A `before` step that fails refuses the run
21
+ * (exit 4); an `after` step that fails fails it (exit 1), the migrations
18
22
  * applied.
23
+ * - Outside the waves (`yodel apply <env>`) the same hooks are made from
24
+ * yodel.config.ts at the base commit ({@link stepsAtBase}, {@link
25
+ * stepsHooksFile}): the SQL checks run before the gate, and every step
26
+ * under the lock, where the Op's approval lets a held one through.
19
27
  * - Every outcome is in the history: the `before` steps' on each
20
28
  * migration's `started` row, the `after` steps' on the last migration's
21
29
  * `succeeded` row (`note.steps`), and `yodel report` lists them.
22
30
  */
31
+ import type { OpWaveApplyHooksRun, OpWaveHookMoment, OpWaveHooks, OpWaveHooksFile } from "@intentius/chant/op";
23
32
  import type { ApplyStep, ApplySteps } from "../config/define.js";
24
33
  import { YodelError, type Project } from "../project.js";
25
34
  import type { VersionedDriver } from "../versioned/driver.js";
@@ -44,22 +53,65 @@ export interface StepsAtBase {
44
53
  }
45
54
  /** `env`'s steps from yodel.config.ts at the base commit. */
46
55
  export declare function stepsAtBase(project: Pick<Project, "dir" | "yodel">, env: string, processEnv?: NodeJS.ProcessEnv): Promise<StepsAtBase>;
56
+ /** The flag a SQL step's hook runs `yodel apply <env>` with; {@link runStepHooks} runs it in process. */
57
+ export declare const STEP_SQL_FLAG = "--step-sql";
47
58
  /**
48
- * Runs `list` in order and returns each outcome; a failing step does not
49
- * stop the ones after it. With `commands: "plan"` (a run being planned, not
50
- * applied) a command is not run: its outcome says it runs under the lock.
59
+ * `steps` as stage hooks: the `before` SQL checks before the plan, every
60
+ * `before` step before the apply and every `after` step after it, the
61
+ * apply-stage ones run by the apply. Undefined for no steps.
51
62
  */
52
- export declare function runApplySteps(driver: Pick<VersionedDriver, "readCheck">, list: readonly ApplyStep[], when: StepWhen, ctx: {
63
+ export declare function stepHooks(steps: ApplySteps | undefined): OpWaveHooks | undefined;
64
+ /**
65
+ * The hooks file for an apply outside the waves: `env`'s steps as {@link
66
+ * stepHooks} has them, by moment. `approved`: an approval of the plan stands
67
+ * (the Op's gate passed), so a held step does not stop the apply.
68
+ */
69
+ export declare function stepsHooksFile(steps: ApplySteps | undefined, env: string, options: {
70
+ approved: boolean;
71
+ base?: string;
72
+ }): OpWaveHooksFile;
73
+ /** A SQL step's hook argv, read back: the step it runs, or undefined for any other argv. */
74
+ export declare function sqlStepOfArgv(argv: readonly string[]): (ApplyStep & {
75
+ sql: string;
76
+ when: StepWhen;
77
+ }) | undefined;
78
+ /** Runs one SQL step on `driver`, judged like a pre-migration check. */
79
+ export declare function runSqlStep(driver: Pick<VersionedDriver, "readCheck">, step: ApplyStep & {
80
+ sql: string;
81
+ }): Promise<{
82
+ passed: boolean;
83
+ detail: string;
84
+ }>;
85
+ /** What {@link runStepHooks} ran: chant's verdict, and each step's outcome as the history records it. */
86
+ export interface StepHooksRun {
87
+ run: OpWaveApplyHooksRun;
88
+ outcomes: StepOutcome[];
89
+ }
90
+ /**
91
+ * Runs one moment's hooks of `file` through chant's runner, under the
92
+ * apply's lock (or before the gate, for `before-plan`): a SQL step in
93
+ * process on `driver`, a command with `YODEL_ENV` and `YODEL_STEP` set and
94
+ * its last line kept for the history. With `skip`, runs none and tells
95
+ * chant why (an apply that changes nothing).
96
+ */
97
+ export declare function runStepHooks(file: OpWaveHooksFile, moment: OpWaveHookMoment, ctx: {
98
+ driver: Pick<VersionedDriver, "readCheck">;
53
99
  dir: string;
54
100
  env: string;
55
101
  processEnv?: NodeJS.ProcessEnv;
56
- commands?: "run" | "plan";
57
- }): Promise<StepOutcome[]>;
102
+ log?: (line: string) => void;
103
+ skip?: string;
104
+ }): Promise<StepHooksRun>;
58
105
  /** One line for an outcome. */
59
106
  export declare const describeStep: (o: StepOutcome) => string;
60
107
  /** The `before` steps that failed with `onFailure: "approve"`: the run waits for a person. */
61
108
  export declare const heldSteps: (outcomes: readonly StepOutcome[]) => string[];
62
- /** The refusal for a step that failed with `onFailure: "fail"`, or undefined. */
63
- export declare function stepsRefusal(env: string, outcomes: readonly StepOutcome[], when: string): YodelError | undefined;
109
+ /**
110
+ * The refusal for a moment's hooks that did not let the apply go on, or
111
+ * undefined: a `before` step that failed (exit 4, nothing applied), a held
112
+ * one with no approval standing (exit 3), an `after` step that failed (exit
113
+ * 1, the migrations applied).
114
+ */
115
+ export declare function stepsRefusal(env: string, ran: StepHooksRun, when: string, approve?: string): YodelError | undefined;
64
116
  /** The steps a history row's note records, if any. */
65
117
  export declare function stepsOfNote(note: string): StepOutcome[];
@@ -1,28 +1,36 @@
1
1
  /**
2
2
  * Steps around apply (#64): per environment, `yodel.config.ts`
3
3
  * `environments.<env>.steps.before` and `.after`, SQL checks or commands
4
- * run around the versioned apply.
4
+ * run around the versioned apply, as chant's Op waves stage hooks (#206).
5
5
  *
6
- * - Read at the base commit (`../config/base.ts`), as the plan policy is:
7
- * a pull request that adds, removes or loosens a step is run under the
8
- * steps the branch had. A checkout with no base to read runs none.
9
- * - `before` steps run under the lock before the first migration. SQL
10
- * checks also run when the run is planned (the wave plan, or `yodel apply`
11
- * before the gate), since they only read; a command, which may have side
12
- * effects, runs once per apply, under the lock, and the plan only shows
13
- * that it will (#107). One that fails refuses the run (exit 4) unless its
14
- * `onFailure` is `approve`: then the wave is held for a person, whatever
15
- * its gate, and the plan they approve says which steps failed.
16
- * - `after` steps run under the lock once the last migration's statements
17
- * succeeded. One that fails fails the run (exit 1); the migrations stay
6
+ * - Each step is a hook ({@link stepHooks}). A SQL check runs `yodel apply
7
+ * <env> --step-sql`, which yodel runs in process ({@link runStepHooks}); a
8
+ * command runs `sh -c`. `yodel ci` writes them into yodel-waves.json,
9
+ * with `hooks.apply.runBy: "apply"`, and chant reads them there at the
10
+ * base commit, as it reads the gate policy.
11
+ * - `before` SQL checks are `before.plan` hooks: chant runs them when it
12
+ * plans the wave, and one that fails with `onFailure: "approve"` holds the
13
+ * wave for a person, whatever its gate, before the apply is called. Every
14
+ * `before` step is also a `before.apply` hook, and every `after` step an
15
+ * `after.apply` hook: the apply runs those under its lock, through
16
+ * chant's runner, before the first migration and once the last one
17
+ * succeeded. A command, which may have side effects, runs once per apply,
18
+ * under the lock, never when the wave is planned (#107).
19
+ * - In order: a step that fails stops the ones after it, unless its
20
+ * `onFailure` is `approve`. A `before` step that fails refuses the run
21
+ * (exit 4); an `after` step that fails fails it (exit 1), the migrations
18
22
  * applied.
23
+ * - Outside the waves (`yodel apply <env>`) the same hooks are made from
24
+ * yodel.config.ts at the base commit ({@link stepsAtBase}, {@link
25
+ * stepsHooksFile}): the SQL checks run before the gate, and every step
26
+ * under the lock, where the Op's approval lets a held one through.
19
27
  * - Every outcome is in the history: the `before` steps' on each
20
28
  * migration's `started` row, the `after` steps' on the last migration's
21
29
  * `succeeded` row (`note.steps`), and `yodel report` lists them.
22
30
  */
23
31
  import { spawnSync } from "node:child_process";
24
32
  import { loadYodelConfigAtBase } from "../config/base.js";
25
- import { EXIT_REFUSED } from "../exit.js";
33
+ import { EXIT_OUTSTANDING, EXIT_REFUSED } from "../exit.js";
26
34
  import { judgeCheck } from "../migrations/checks.js";
27
35
  import { YodelError } from "../project.js";
28
36
  /** `env`'s steps from yodel.config.ts at the base commit. */
@@ -40,56 +48,170 @@ export async function stepsAtBase(project, env, processEnv = process.env) {
40
48
  const differs = JSON.stringify(tree ?? null) !== JSON.stringify(steps ?? null);
41
49
  return { steps, sha: at.sha, ...(differs ? { note: `steps: ${env}'s steps are read at the base commit ${at.sha.slice(0, 12)}, not from this change` } : {}) };
42
50
  }
51
+ /** The flag a SQL step's hook runs `yodel apply <env>` with; {@link runStepHooks} runs it in process. */
52
+ export const STEP_SQL_FLAG = "--step-sql";
53
+ /** One step as a hook: a SQL check through `yodel apply {target} --step-sql`, a command through `sh -c`. */
54
+ function stepHook(step, when) {
55
+ const command = step.sql !== undefined
56
+ ? ["yodel", "apply", "{target}", STEP_SQL_FLAG, step.sql, "--step", step.name, "--step-when", when, ...(step.expect !== undefined ? ["--step-expect", JSON.stringify(step.expect)] : []), ...(step.onFailure === "approve" ? ["--step-on-failure", "approve"] : [])]
57
+ : ["sh", "-c", step.command ?? ""];
58
+ // chant has no approve after the apply: an after step that fails fails the run, whatever it says.
59
+ return { name: step.name, command, perRun: true, ...(when === "before" && step.onFailure === "approve" ? { onFailure: "approve" } : {}) };
60
+ }
61
+ /**
62
+ * `steps` as stage hooks: the `before` SQL checks before the plan, every
63
+ * `before` step before the apply and every `after` step after it, the
64
+ * apply-stage ones run by the apply. Undefined for no steps.
65
+ */
66
+ export function stepHooks(steps) {
67
+ const before = steps?.before ?? [];
68
+ const after = steps?.after ?? [];
69
+ if (before.length === 0 && after.length === 0)
70
+ return undefined;
71
+ const checks = before.filter((s) => s.sql !== undefined);
72
+ return {
73
+ apply: { runBy: "apply" },
74
+ before: { ...(checks.length > 0 ? { plan: checks.map((s) => stepHook(s, "before")) } : {}), ...(before.length > 0 ? { apply: before.map((s) => stepHook(s, "before")) } : {}) },
75
+ ...(after.length > 0 ? { after: { apply: after.map((s) => stepHook(s, "after")) } } : {}),
76
+ };
77
+ }
78
+ /**
79
+ * The hooks file for an apply outside the waves: `env`'s steps as {@link
80
+ * stepHooks} has them, by moment. `approved`: an approval of the plan stands
81
+ * (the Op's gate passed), so a held step does not stop the apply.
82
+ */
83
+ export function stepsHooksFile(steps, env, options) {
84
+ const hooks = stepHooks(steps);
85
+ const byMoment = {
86
+ ...(hooks?.before?.plan ? { "before-plan": hooks.before.plan } : {}),
87
+ ...(hooks?.before?.apply ? { "before-apply": hooks.before.apply } : {}),
88
+ ...(hooks?.after?.apply ? { "after-apply": hooks.after.apply } : {}),
89
+ };
90
+ return {
91
+ version: 1,
92
+ opWaves: "yodel-apply",
93
+ op: `migrate-${env}`,
94
+ wave: env,
95
+ number: 0,
96
+ ...(options.base ? { base: options.base } : {}),
97
+ approved: options.approved,
98
+ runBy: "apply",
99
+ runs: [{ target: env, op: `migrate-${env}` }],
100
+ runsFile: "",
101
+ hooks: byMoment,
102
+ outcomes: [],
103
+ };
104
+ }
43
105
  const lastLine = (text) => text.trim().split("\n").at(-1)?.slice(0, 200) ?? "";
106
+ /** A SQL step's hook argv, read back: the step it runs, or undefined for any other argv. */
107
+ export function sqlStepOfArgv(argv) {
108
+ if (argv[0] !== "yodel" || argv[1] !== "apply")
109
+ return undefined;
110
+ const at = (flag) => {
111
+ const i = argv.indexOf(flag);
112
+ return i >= 0 ? argv[i + 1] : undefined;
113
+ };
114
+ const sql = at(STEP_SQL_FLAG);
115
+ const name = at("--step");
116
+ if (sql === undefined || name === undefined)
117
+ return undefined;
118
+ const expect = at("--step-expect");
119
+ const parsed = expect !== undefined ? JSON.parse(expect) : undefined;
120
+ return {
121
+ name,
122
+ sql,
123
+ when: at("--step-when") === "after" ? "after" : "before",
124
+ ...(parsed !== undefined ? { expect: parsed } : {}),
125
+ ...(at("--step-on-failure") === "approve" ? { onFailure: "approve" } : {}),
126
+ };
127
+ }
128
+ /** Runs one SQL step on `driver`, judged like a pre-migration check. */
129
+ export async function runSqlStep(driver, step) {
130
+ try {
131
+ const judged = judgeCheck({ name: step.name, sql: step.sql, ...(step.expect !== undefined ? { expect: step.expect } : {}) }, await driver.readCheck(step.sql, {}));
132
+ return { passed: judged.passed, detail: judged.detail };
133
+ }
134
+ catch (e) {
135
+ return { passed: false, detail: `the query failed: ${(e instanceof Error ? e.message : String(e)).split("\n")[0] ?? ""}` };
136
+ }
137
+ }
44
138
  /**
45
- * Runs `list` in order and returns each outcome; a failing step does not
46
- * stop the ones after it. With `commands: "plan"` (a run being planned, not
47
- * applied) a command is not run: its outcome says it runs under the lock.
139
+ * Runs one moment's hooks of `file` through chant's runner, under the
140
+ * apply's lock (or before the gate, for `before-plan`): a SQL step in
141
+ * process on `driver`, a command with `YODEL_ENV` and `YODEL_STEP` set and
142
+ * its last line kept for the history. With `skip`, runs none and tells
143
+ * chant why (an apply that changes nothing).
48
144
  */
49
- export async function runApplySteps(driver, list, when, ctx) {
50
- const out = [];
51
- for (const step of list) {
52
- const onFailure = step.onFailure ?? "fail";
53
- if (step.sql !== undefined) {
54
- try {
55
- const judged = judgeCheck({ name: step.name, sql: step.sql, ...(step.expect !== undefined ? { expect: step.expect } : {}) }, await driver.readCheck(step.sql, {}));
56
- out.push({ name: step.name, when, kind: "sql", passed: judged.passed, detail: judged.detail, onFailure });
57
- }
58
- catch (e) {
59
- out.push({ name: step.name, when, kind: "sql", passed: false, detail: `the query failed: ${(e instanceof Error ? e.message : String(e)).split("\n")[0] ?? ""}`, onFailure });
60
- }
61
- continue;
145
+ export async function runStepHooks(file, moment, ctx) {
146
+ const { runOpWaveApplyHooks } = await import("@intentius/chant/op");
147
+ const when = moment.startsWith("after") ? "after" : "before";
148
+ const hooks = file.hooks[moment] ?? [];
149
+ // chant's runner is synchronous and a SQL step is not: each SQL step runs here first, in order, and the runner reads its verdict.
150
+ const checked = new Map();
151
+ if (ctx.skip === undefined) {
152
+ for (const hook of hooks) {
153
+ const step = sqlStepOfArgv(hook.command);
154
+ if (step)
155
+ checked.set(hook.name ?? step.name, await runSqlStep(ctx.driver, step));
62
156
  }
63
- if (ctx.commands === "plan") {
64
- out.push({ name: step.name, when, kind: "command", passed: true, detail: "a command: it runs under the lock, not when the run is planned", onFailure, deferred: true });
65
- continue;
157
+ }
158
+ const details = [];
159
+ const exec = (argv, cwd, env) => {
160
+ const step = sqlStepOfArgv(argv);
161
+ if (step) {
162
+ const got = checked.get(step.name) ?? { passed: false, detail: "the check did not run" };
163
+ details.push({ kind: "sql", detail: got.detail });
164
+ return got.passed ? 0 : 1;
66
165
  }
67
- const ran = spawnSync("sh", ["-c", step.command ?? ""], {
68
- cwd: ctx.dir,
166
+ const ran = spawnSync(argv[0] ?? "sh", argv.slice(1), {
167
+ cwd,
69
168
  encoding: "utf8",
70
- env: { ...(ctx.processEnv ?? process.env), YODEL_ENV: ctx.env, YODEL_STEP: when },
169
+ env: { ...(ctx.processEnv ?? process.env), ...env, YODEL_ENV: ctx.env, YODEL_STEP: when },
71
170
  timeout: 10 * 60_000,
72
171
  });
73
172
  const said = lastLine(`${ran.stdout}\n${ran.stderr}`);
74
- const code = ran.status ?? 1;
75
- out.push({ name: step.name, when, kind: "command", passed: code === 0 && !ran.error, detail: `exit ${ran.error ? "(did not run)" : String(code)}${said ? `: ${said}` : ""}`, onFailure });
76
- }
77
- return out;
173
+ const code = ran.error ? 127 : (ran.status ?? 1);
174
+ details.push({ kind: "command", detail: `exit ${ran.error ? "(did not run)" : String(code)}${said ? `: ${said}` : ""}` });
175
+ return code;
176
+ };
177
+ const run = runOpWaveApplyHooks(file, moment, { cwd: ctx.dir, exec, log: ctx.log ?? (() => undefined), ...(ctx.skip !== undefined ? { skip: ctx.skip } : {}) });
178
+ const onFailureOf = new Map(hooks.map((h) => [h.name ?? h.command.join(" "), h.onFailure ?? "fail"]));
179
+ const outcomes = run.outcomes
180
+ .filter((o) => o.outcome !== "skipped")
181
+ .map((o, i) => ({
182
+ name: o.name,
183
+ when,
184
+ kind: details[i]?.kind ?? "command",
185
+ passed: o.outcome === "passed",
186
+ detail: details[i]?.detail ?? `exit ${String(o.exit)}`,
187
+ onFailure: onFailureOf.get(o.name) ?? "fail",
188
+ }));
189
+ return { run, outcomes };
78
190
  }
79
191
  /** One line for an outcome. */
80
192
  export const describeStep = (o) => o.deferred ? `${o.when} step ${o.name} will run under the lock (${o.detail})` : `${o.when} step ${o.name} ${o.passed ? "passed" : o.onFailure === "approve" ? "failed, held for approval" : "failed"} (${o.detail})`;
81
193
  /** The `before` steps that failed with `onFailure: "approve"`: the run waits for a person. */
82
194
  export const heldSteps = (outcomes) => outcomes.filter((o) => !o.passed && o.when === "before" && o.onFailure === "approve").map((o) => o.name);
83
- /** The refusal for a step that failed with `onFailure: "fail"`, or undefined. */
84
- export function stepsRefusal(env, outcomes, when) {
85
- const failed = outcomes.filter((o) => !o.passed && (o.when === "after" || o.onFailure === "fail"));
86
- if (failed.length === 0)
195
+ /**
196
+ * The refusal for a moment's hooks that did not let the apply go on, or
197
+ * undefined: a `before` step that failed (exit 4, nothing applied), a held
198
+ * one with no approval standing (exit 3), an `after` step that failed (exit
199
+ * 1, the migrations applied).
200
+ */
201
+ export function stepsRefusal(env, ran, when, approve) {
202
+ if (ran.run.proceed)
87
203
  return undefined;
88
- const after = failed.every((o) => o.when === "after");
89
- return new YodelError(after
90
- ? `${env}: the migrations are applied, and an after step failed ${when}:\n${failed.map((o) => ` ${describeStep(o)}`).join("\n")}`
91
- : `refused: a before step of ${env} failed ${when}; nothing was applied:\n${failed.map((o) => ` ${describeStep(o)}`).join("\n")}\n` +
92
- `Fix the cause and run again, or, for a check a person may wave through, give the step onFailure: "approve" (at the base commit).`, after ? 1 : EXIT_REFUSED);
204
+ const lines = (os) => os.map((o) => ` ${describeStep(o)}`).join("\n");
205
+ const failed = ran.outcomes.filter((o) => !o.passed && o.onFailure === "fail");
206
+ if (ran.run.moment === "after-apply")
207
+ return new YodelError(`${env}: the migrations are applied, and an after step failed ${when}:\n${lines(failed)}`, 1);
208
+ if (ran.run.failed || failed.length > 0) {
209
+ return new YodelError(`refused: a before step of ${env} failed ${when}; nothing was applied:\n${lines(failed)}\n` +
210
+ `Fix the cause and run again, or, for a check a person may wave through, give the step onFailure: "approve" (at the base commit).`, EXIT_REFUSED);
211
+ }
212
+ const held = ran.outcomes.filter((o) => !o.passed && o.onFailure === "approve");
213
+ const why = held.length > 0 ? lines(held) : ran.run.held.map((h) => ` ${h}`).join("\n");
214
+ return new YodelError(`refused: a before step of ${env} failed with onFailure approve ${when}, and no approval of this plan stands; nothing was applied:\n${why}${approve ? `\nApprove it with: ${approve}` : ""}`, EXIT_OUTSTANDING);
93
215
  }
94
216
  /** The steps a history row's note records, if any. */
95
217
  export function stepsOfNote(note) {
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/apply-steps/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/apply-steps/index.ts"],"names":[],"mappings":"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"}
@@ -72,7 +72,8 @@
72
72
  * in that image instead, which carries node, yodel, chant and the lexicons
73
73
  * on PATH, and no job runs `npm ci` ({@link Toolchain}).
74
74
  */
75
- import { type ApprovalMode, type CiLogin, type WaveGate } from "../config/define.js";
75
+ import { type ApplySteps, type ApprovalMode, type CiLogin, type WaveGate } from "../config/define.js";
76
+ import type { OpWaveHooks } from "@intentius/chant/op";
76
77
  import { type CloudToken, type Role } from "../credentials.js";
77
78
  import type { Declarable } from "@intentius/chant/declarable";
78
79
  export type Forge = "github" | "gitlab" | "forgejo";
@@ -258,6 +259,8 @@ export interface Wave {
258
259
  shares?: number;
259
260
  /** Which approvals of the wave's digest count (yodel.config.ts `waves[].approval`, #48); absent, `ledger`. */
260
261
  approval?: ApprovalMode;
262
+ /** The environment's steps around apply (yodel.config.ts `environments.<env>.steps`, #64): the wave's stage hooks (#206). */
263
+ steps?: ApplySteps;
261
264
  }
262
265
  /** The waves spec: committed, and read by every wave job (its gate policy at the commit before the push). */
263
266
  export declare const WAVES_SPEC = "yodel-waves.json";
@@ -281,6 +284,7 @@ interface WavesSpec {
281
284
  name: string;
282
285
  };
283
286
  variables?: Record<string, string>;
287
+ hooks?: OpWaveHooks;
284
288
  }>;
285
289
  /** The scheduled resume job (yodel.config.ts `ci.resume`); only the pipelines are rendered from it, the spec file leaves it out. */
286
290
  resume?: {
@@ -304,7 +308,8 @@ export declare function readWaves(dir: string, envs: readonly string[]): Promise
304
308
  * `shares` slots (one without) that read the tenants when the wave runs.
305
309
  * The query is not run here, so the pipeline stays the same as tenants come
306
310
  * and go; a list or a file is in the repository, and changing it is
307
- * rendering again.
311
+ * rendering again. Each wave also gets its environment's steps around
312
+ * apply (#64), for its stage hooks.
308
313
  */
309
314
  export declare function withTenants(dir: string, waves: readonly Wave[]): Promise<Wave[]>;
310
315
  /**
package/dist/ci/render.js CHANGED
@@ -76,6 +76,7 @@ import { existsSync } from "node:fs";
76
76
  import { join, resolve } from "node:path";
77
77
  import { pathToFileURL } from "node:url";
78
78
  import { APPROVAL_MODES, WAVE_GATES, waveGateHint } from "../config/define.js";
79
+ import { stepHooks } from "../apply-steps/index.js";
79
80
  import { audience, CLOUD_OF, jobLogins, loginSteps } from "./login.js";
80
81
  import { RECORD_PLANS_ENV } from "../approval-mode/index.js";
81
82
  import { cloudToken, credentialsOf, roleVariables } from "../credentials.js";
@@ -563,10 +564,17 @@ export function wavesSpec(waves, variables, resume) {
563
564
  ...(w.shares !== undefined && w.shares > 1 ? { shares: w.shares } : {}),
564
565
  ...(w.approval !== undefined && w.approval !== "ledger" ? { approval: w.approval } : {}),
565
566
  ...(variables ? { environment: { name: w.env }, variables: variables(w.env) } : {}),
567
+ // The steps around apply (#64) as chant's stage hooks, which the apply runs under its lock (#206).
568
+ ...hooksOf(w.steps),
566
569
  })),
567
570
  ...(resume ? { resume } : {}),
568
571
  };
569
572
  }
573
+ /** A wave's stage hooks from its steps, when it has any. */
574
+ function hooksOf(steps) {
575
+ const hooks = stepHooks(steps);
576
+ return hooks ? { hooks } : {};
577
+ }
570
578
  /** The waves spec file and the apply pipeline on each forge. */
571
579
  export async function applyPipelines(dir, envs) {
572
580
  const { dialect, waves } = envs;
@@ -780,7 +788,8 @@ export async function readWaves(dir, envs) {
780
788
  * `shares` slots (one without) that read the tenants when the wave runs.
781
789
  * The query is not run here, so the pipeline stays the same as tenants come
782
790
  * and go; a list or a file is in the repository, and changing it is
783
- * rendering again.
791
+ * rendering again. Each wave also gets its environment's steps around
792
+ * apply (#64), for its stage hooks.
784
793
  */
785
794
  export async function withTenants(dir, waves) {
786
795
  const { loadProject } = await import("../project.js");
@@ -789,7 +798,8 @@ export async function withTenants(dir, waves) {
789
798
  const out = [];
790
799
  for (const w of waves) {
791
800
  const targets = await waveTargets(project, w.env, w.shares);
792
- out.push(targets === undefined ? w : { ...w, targets });
801
+ const steps = w.steps ?? project.yodel?.config.environments?.[w.env]?.steps;
802
+ out.push({ ...w, ...(targets !== undefined ? { targets } : {}), ...(steps ? { steps } : {}) });
793
803
  }
794
804
  return out;
795
805
  }