@intentius/chant 0.124.63 → 0.124.65

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 (185) hide show
  1. package/dist/cli/handlers/approve.d.ts +8 -0
  2. package/dist/cli/handlers/approve.d.ts.map +1 -1
  3. package/dist/cli/handlers/approve.js +27 -4
  4. package/dist/cli/handlers/pr.d.ts.map +1 -1
  5. package/dist/cli/handlers/pr.js +2 -1
  6. package/dist/cli/handlers/release.d.ts +6 -4
  7. package/dist/cli/handlers/release.d.ts.map +1 -1
  8. package/dist/cli/handlers/release.js +101 -16
  9. package/dist/cli/handlers/run.d.ts +30 -1
  10. package/dist/cli/handlers/run.d.ts.map +1 -1
  11. package/dist/cli/handlers/run.js +108 -7
  12. package/dist/cli/main.d.ts.map +1 -1
  13. package/dist/cli/main.js +34 -7
  14. package/dist/cli/parse-args.d.ts.map +1 -1
  15. package/dist/cli/parse-args.js +19 -0
  16. package/dist/cli/registry.d.ts +10 -2
  17. package/dist/cli/registry.d.ts.map +1 -1
  18. package/dist/components/cli-support.d.ts +19 -1
  19. package/dist/components/cli-support.d.ts.map +1 -1
  20. package/dist/components/cli-support.js +11 -3
  21. package/dist/components/component.d.ts +19 -0
  22. package/dist/components/component.d.ts.map +1 -1
  23. package/dist/components/component.schema.json +17 -0
  24. package/dist/components/index.d.ts +1 -1
  25. package/dist/components/index.d.ts.map +1 -1
  26. package/dist/components/release-run.d.ts +48 -0
  27. package/dist/components/release-run.d.ts.map +1 -0
  28. package/dist/components/release-run.js +166 -0
  29. package/dist/components/starter-plugin.d.ts +1 -0
  30. package/dist/components/starter-plugin.d.ts.map +1 -1
  31. package/dist/components/starter-plugin.js +5 -1
  32. package/dist/components/unchanged-inputs.d.ts +81 -0
  33. package/dist/components/unchanged-inputs.d.ts.map +1 -0
  34. package/dist/components/unchanged-inputs.js +122 -0
  35. package/dist/components/verbs/index.d.ts +1 -0
  36. package/dist/components/verbs/index.d.ts.map +1 -1
  37. package/dist/components/verbs/index.js +1 -0
  38. package/dist/components/verbs/release-image.d.ts +36 -0
  39. package/dist/components/verbs/release-image.d.ts.map +1 -0
  40. package/dist/components/verbs/release-image.js +33 -0
  41. package/dist/config.d.ts +18 -0
  42. package/dist/config.d.ts.map +1 -1
  43. package/dist/config.js +1 -0
  44. package/dist/gate-statement.schema.json +4 -2
  45. package/dist/lifecycle/delivery-metrics.d.ts.map +1 -1
  46. package/dist/lifecycle/delivery-metrics.js +4 -2
  47. package/dist/lifecycle/gate-ledger.d.ts +11 -2
  48. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  49. package/dist/lifecycle/gate-ledger.js +6 -0
  50. package/dist/lifecycle/gate-seal.d.ts +20 -4
  51. package/dist/lifecycle/gate-seal.d.ts.map +1 -1
  52. package/dist/lifecycle/gate-seal.js +18 -5
  53. package/dist/lifecycle/gate-statement.d.ts +27 -2
  54. package/dist/lifecycle/gate-statement.d.ts.map +1 -1
  55. package/dist/lifecycle/gate-statement.js +37 -2
  56. package/dist/lifecycle/git.d.ts.map +1 -1
  57. package/dist/lifecycle/git.js +6 -1
  58. package/dist/lifecycle/ledger-read.js +1 -1
  59. package/dist/lifecycle/plan-stale.d.ts.map +1 -1
  60. package/dist/lifecycle/plan-stale.js +1 -2
  61. package/dist/lifecycle/publish-declaration.d.ts +20 -0
  62. package/dist/lifecycle/publish-declaration.d.ts.map +1 -1
  63. package/dist/lifecycle/publish-declaration.js +24 -1
  64. package/dist/lifecycle/publish-forge.d.ts.map +1 -1
  65. package/dist/lifecycle/publish-forge.js +1 -2
  66. package/dist/lifecycle/publish-git-ssh.d.ts +82 -0
  67. package/dist/lifecycle/publish-git-ssh.d.ts.map +1 -0
  68. package/dist/lifecycle/publish-git-ssh.js +180 -0
  69. package/dist/lifecycle/publish-homebrew.d.ts +11 -0
  70. package/dist/lifecycle/publish-homebrew.d.ts.map +1 -1
  71. package/dist/lifecycle/publish-homebrew.js +96 -5
  72. package/dist/lifecycle/publish-marketplace.d.ts +36 -2
  73. package/dist/lifecycle/publish-marketplace.d.ts.map +1 -1
  74. package/dist/lifecycle/publish-marketplace.js +173 -30
  75. package/dist/lifecycle/publish-tauri.d.ts.map +1 -1
  76. package/dist/lifecycle/publish-tauri.js +1 -2
  77. package/dist/lifecycle/query.d.ts +2 -2
  78. package/dist/lifecycle/query.d.ts.map +1 -1
  79. package/dist/lifecycle/query.js +3 -3
  80. package/dist/lifecycle/release-cut.d.ts +82 -6
  81. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  82. package/dist/lifecycle/release-cut.js +209 -20
  83. package/dist/lifecycle/release-ledger.d.ts +11 -0
  84. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  85. package/dist/lifecycle/release-publish.d.ts +13 -0
  86. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  87. package/dist/lifecycle/release-publish.js +5 -0
  88. package/dist/lifecycle/release-revocation.d.ts +4 -3
  89. package/dist/lifecycle/release-revocation.d.ts.map +1 -1
  90. package/dist/lifecycle/release-revocation.js +5 -4
  91. package/dist/lifecycle/release-store.d.ts +49 -3
  92. package/dist/lifecycle/release-store.d.ts.map +1 -1
  93. package/dist/lifecycle/release-store.js +22 -3
  94. package/dist/op/gate.d.ts +1 -1
  95. package/dist/op/gate.d.ts.map +1 -1
  96. package/dist/op/gate.js +2 -1
  97. package/dist/op/op-waves-run.js +5 -3
  98. package/dist/pr-forge.d.ts.map +1 -1
  99. package/dist/pr-forge.js +26 -6
  100. package/dist/release-floors.d.ts +1 -1
  101. package/dist/release-floors.js +1 -1
  102. package/dist/wave-runtime.mjs +284 -283
  103. package/dist/workspace/ci-green.d.ts.map +1 -1
  104. package/dist/workspace/ci-green.js +1 -2
  105. package/dist/workspace/ci-quarantine-report.d.ts.map +1 -1
  106. package/dist/workspace/ci-quarantine-report.js +1 -2
  107. package/dist/workspace/ci-quarantine.d.ts.map +1 -1
  108. package/dist/workspace/ci-quarantine.js +1 -2
  109. package/dist/workspace/delivery-metrics.schema.json +1 -1
  110. package/dist/workspace/intent.d.ts.map +1 -1
  111. package/dist/workspace/intent.js +1 -2
  112. package/dist/workspace/release-candidates.d.ts +9 -1
  113. package/dist/workspace/release-candidates.d.ts.map +1 -1
  114. package/dist/workspace/release-candidates.js +16 -5
  115. package/dist/workspace/release-candidates.schema.json +7 -0
  116. package/dist/workspace/releases.schema.json +54 -2
  117. package/package.json +1 -1
  118. package/src/cli/handlers/approve-external-signature.test.ts +105 -3
  119. package/src/cli/handlers/approve.ts +34 -4
  120. package/src/cli/handlers/pr.ts +2 -1
  121. package/src/cli/handlers/release.ts +91 -16
  122. package/src/cli/handlers/run-unchanged.e2e.test.ts +112 -0
  123. package/src/cli/handlers/run.ts +117 -7
  124. package/src/cli/main.ts +34 -7
  125. package/src/cli/parse-args.ts +15 -0
  126. package/src/cli/registry.ts +10 -2
  127. package/src/components/cli-support.test.ts +53 -0
  128. package/src/components/cli-support.ts +26 -4
  129. package/src/components/component.schema.json +17 -0
  130. package/src/components/component.ts +20 -0
  131. package/src/components/index.ts +1 -0
  132. package/src/components/registry.test.ts +1 -1
  133. package/src/components/release-run.test.ts +127 -0
  134. package/src/components/release-run.ts +188 -0
  135. package/src/components/starter-plugin.ts +5 -0
  136. package/src/components/unchanged-inputs.test.ts +98 -0
  137. package/src/components/unchanged-inputs.ts +151 -0
  138. package/src/components/verbs/index.ts +1 -0
  139. package/src/components/verbs/release-image.ts +52 -0
  140. package/src/config.ts +8 -0
  141. package/src/gate-statement.schema.json +4 -2
  142. package/src/lifecycle/delivery-metrics.ts +4 -2
  143. package/src/lifecycle/gate-ledger.ts +17 -2
  144. package/src/lifecycle/gate-seal.ts +24 -6
  145. package/src/lifecycle/gate-statement.ts +40 -4
  146. package/src/lifecycle/git.test.ts +15 -0
  147. package/src/lifecycle/git.ts +5 -1
  148. package/src/lifecycle/ledger-read.ts +1 -1
  149. package/src/lifecycle/plan-stale.test.ts +3 -4
  150. package/src/lifecycle/plan-stale.ts +1 -2
  151. package/src/lifecycle/publish-declaration.ts +24 -1
  152. package/src/lifecycle/publish-forge.ts +1 -2
  153. package/src/lifecycle/publish-git-ssh.ts +202 -0
  154. package/src/lifecycle/publish-homebrew.test.ts +181 -2
  155. package/src/lifecycle/publish-homebrew.ts +101 -6
  156. package/src/lifecycle/publish-marketplace.test.ts +158 -6
  157. package/src/lifecycle/publish-marketplace.ts +192 -31
  158. package/src/lifecycle/publish-resume.test.ts +40 -0
  159. package/src/lifecycle/publish-tauri.ts +1 -2
  160. package/src/lifecycle/query.ts +3 -3
  161. package/src/lifecycle/release-cut-lane.test.ts +195 -0
  162. package/src/lifecycle/release-cut-override.test.ts +225 -0
  163. package/src/lifecycle/release-cut.test.ts +45 -0
  164. package/src/lifecycle/release-cut.ts +262 -21
  165. package/src/lifecycle/release-ledger.ts +11 -0
  166. package/src/lifecycle/release-publish.ts +18 -0
  167. package/src/lifecycle/release-revocation.ts +5 -4
  168. package/src/lifecycle/release-store.ts +73 -5
  169. package/src/op/gate.ts +2 -1
  170. package/src/op/op-waves-run.ts +4 -2
  171. package/src/pr-forge.ts +25 -6
  172. package/src/pr-requires.test.ts +9 -0
  173. package/src/release-floors.ts +1 -1
  174. package/src/workspace/ci-green.ts +1 -2
  175. package/src/workspace/ci-quarantine-report.test.ts +2 -3
  176. package/src/workspace/ci-quarantine-report.ts +1 -2
  177. package/src/workspace/ci-quarantine.test.ts +2 -3
  178. package/src/workspace/ci-quarantine.ts +1 -2
  179. package/src/workspace/delivery-metrics.schema.json +1 -1
  180. package/src/workspace/delivery-metrics.test.ts +8 -0
  181. package/src/workspace/intent.ts +1 -2
  182. package/src/workspace/release-candidates.schema.json +7 -0
  183. package/src/workspace/release-candidates.ts +19 -5
  184. package/src/workspace/releases.schema.json +54 -2
  185. package/src/workspace/trust/gate-seal.test.ts +44 -0
@@ -0,0 +1,225 @@
1
+ /**
2
+ * #4693: a release cut of a commit that is not green, under a person's
3
+ * override on the override gate's ledger. The cut records the request, a
4
+ * person the overriders file at base lists answers it with a reason, and the
5
+ * next cut spends it and records who and why on the cut line.
6
+ */
7
+
8
+ import { describe, test, expect } from "vitest";
9
+ import { withTestDir } from "@intentius/chant-test-utils";
10
+ import { spawnSync } from "node:child_process";
11
+ import { mkdirSync, writeFileSync } from "node:fs";
12
+ import { join } from "node:path";
13
+ import { cutRelease, greenOverrideSubject, planRelease, ReleaseCutError } from "./release-cut";
14
+ import { readCuts, type ReleaseArtifact } from "./release-store";
15
+ import { appendGateResolution } from "./gate-ledger";
16
+ import { readOverrideLedger } from "./override-ledger";
17
+ import { overrideDigest, OVERRIDE_OP } from "../override-gate";
18
+ import type { CompiledTarget, TargetCompiler } from "../components/release-compile";
19
+ import { releasesDocument } from "../workspace/releases";
20
+ import { contract } from "../workspace/__fixtures__/contract-repo";
21
+ import releasesSchema from "../workspace/releases.schema.json";
22
+
23
+ function git(dir: string, ...args: string[]): string {
24
+ const r = spawnSync("git", args, { cwd: dir, encoding: "utf-8" });
25
+ if (r.status !== 0) throw new Error(`git ${args.join(" ")}: ${r.stderr}`);
26
+ return r.stdout.trim();
27
+ }
28
+
29
+ /** A project on main with two environments, and `.chant/overriders` listing `overriders` when given. */
30
+ function project(dir: string, overriders: string[] | null = ["github:alice"]): string {
31
+ git(dir, "init", "-q", "-b", "main");
32
+ git(dir, "config", "user.email", "test@chant.dev");
33
+ git(dir, "config", "user.name", "Test");
34
+ writeFileSync(join(dir, "chant.config.ts"), `export default { environments: ["dev", "prod"] };\n`);
35
+ mkdirSync(join(dir, "api"), { recursive: true });
36
+ writeFileSync(join(dir, "api", "Dockerfile"), "FROM scratch\n");
37
+ writeFileSync(join(dir, "api.component.ts"), "export const api = {};\n");
38
+ if (overriders) {
39
+ mkdirSync(join(dir, ".chant"), { recursive: true });
40
+ writeFileSync(join(dir, ".chant", "overriders"), `# who may override\n${overriders.join("\n")}\n`);
41
+ }
42
+ git(dir, "add", ".");
43
+ git(dir, "commit", "-q", "-m", "init");
44
+ return git(dir, "rev-parse", "HEAD");
45
+ }
46
+
47
+ function compiler(): TargetCompiler {
48
+ return {
49
+ async compile(env): Promise<CompiledTarget> {
50
+ return {
51
+ env,
52
+ params: [],
53
+ components: ["api"],
54
+ buildSteps: { api: [{ kind: "docker-build", context: "api", into: "api.tar" }] },
55
+ buildInputs: { api: ["api"] },
56
+ componentFiles: { api: "api.component.ts" },
57
+ templates: [{ component: "api", path: "dist/api.json", content: `{"env":"${env}"}\n` }],
58
+ };
59
+ },
60
+ async buildArtifacts(_env, components): Promise<ReleaseArtifact[]> {
61
+ return components.map((c) => ({ component: c, kind: "image" as const, path: `${c}.tar`, digest: `sha256:${"b".repeat(64)}` }));
62
+ },
63
+ };
64
+ }
65
+
66
+ const T0 = "2026-11-01T10:00:00.000Z";
67
+ const T1 = "2026-11-01T10:05:00.000Z";
68
+ const T2 = "2026-11-01T10:10:00.000Z";
69
+ const request = (dir: string, at: string, opts: { label?: string | null; overrideGreen?: boolean } = {}) => ({
70
+ cwd: dir,
71
+ compiler: compiler(),
72
+ label: opts.label === undefined ? "v1.0.1" : opts.label,
73
+ actor: "ci-bot",
74
+ env: {},
75
+ now: () => new Date(at),
76
+ ...(opts.overrideGreen === false ? {} : { overrideGreen: true }),
77
+ });
78
+ const refusal = async (p: Promise<unknown>): Promise<ReleaseCutError> => {
79
+ const err = await p.catch((e: unknown) => e);
80
+ expect(err).toBeInstanceOf(ReleaseCutError);
81
+ return err as ReleaseCutError;
82
+ };
83
+
84
+ /** Write an override of the cut of `sha`, as `chant approve policy-override` would. */
85
+ async function override(dir: string, sha: string, by: string, opts: { reason?: string; agent?: boolean; rule?: string } = {}): Promise<void> {
86
+ const subject = greenOverrideSubject(sha);
87
+ await appendGateResolution(
88
+ {
89
+ op: OVERRIDE_OP,
90
+ gate: subject,
91
+ resolvedBy: by,
92
+ timestamp: T1,
93
+ planDigest: overrideDigest(subject, sha, [opts.rule ?? "ci-green"]),
94
+ ...(opts.reason !== "" ? { note: opts.reason ?? "windows runners are down; server phases passed" } : {}),
95
+ approver: { kind: opts.agent ? "agent" : "human" },
96
+ },
97
+ { cwd: dir },
98
+ );
99
+ }
100
+
101
+ describe("a cut of a commit that is not green, under an override (#4693)", () => {
102
+ test("the cut records the request, a listed person overrides it, and the next cut spends it and records who and why", async () => {
103
+ await withTestDir(async (dir) => {
104
+ const sha = project(dir);
105
+ const subject = greenOverrideSubject(sha);
106
+
107
+ // A dry run decides and writes nothing.
108
+ const dry = await refusal(planRelease(request(dir, T0)));
109
+ expect(dry.code).toBe("release-commit-not-green");
110
+ expect(dry.recorded).toBe(false);
111
+ expect(dry.message).toContain(`a cut with --yes records the request for an override of ${subject}`);
112
+ expect((await readOverrideLedger({ cwd: dir })).pending).toEqual([]);
113
+
114
+ // The cut records the request and names the command that answers it.
115
+ const first = await refusal(cutRelease(request(dir, T0)));
116
+ expect(first.code).toBe("release-commit-not-green");
117
+ expect(first.recorded).toBe(true);
118
+ expect(first.message).toContain(`has no ci/green tag, so no release is cut from it; the request for an override of ${subject} is recorded`);
119
+ expect(first.fix).toContain(`github:alice may override it with: chant approve policy-override ${subject} --rule ci-green --reason "<why>"`);
120
+ const { pending } = await readOverrideLedger({ cwd: dir });
121
+ expect(pending).toHaveLength(1);
122
+ expect(pending[0]).toMatchObject({ op: OVERRIDE_OP, gate: subject, plan: sha, rules: ["ci-green"] });
123
+ // A second refused cut finds the request standing and records no other.
124
+ const again = await refusal(cutRelease(request(dir, T0)));
125
+ expect(again.recorded).toBe(false);
126
+ expect(again.message).toContain(`the request for an override of ${subject} has stood since ${T0}`);
127
+
128
+ await override(dir, sha, "github:alice");
129
+ const plan = await planRelease(request(dir, T2));
130
+ expect(plan.override).toMatchObject({ green: false, tag: `ci/green/${sha}`, by: "github:alice", reason: "windows runners are down; server phases passed", sealed: false });
131
+
132
+ const result = await cutRelease(request(dir, T2));
133
+ expect(result.cut?.override).toEqual({
134
+ green: false,
135
+ tag: `ci/green/${sha}`,
136
+ by: "github:alice",
137
+ at: T1,
138
+ reason: "windows runners are down; server phases passed",
139
+ digest: overrideDigest(subject, sha, ["ci-green"]),
140
+ sealed: false,
141
+ });
142
+ expect(result.cut?.actor).toBe("ci-bot");
143
+ const { applied } = await readOverrideLedger({ cwd: dir });
144
+ expect(applied).toMatchObject([{ gate: subject, approvedBy: "github:alice", approvedAt: T1, timestamp: T2, commit: sha }]);
145
+
146
+ const doc = await releasesDocument({ cwd: dir });
147
+ if ("error" in doc) throw new Error(doc.error.message);
148
+ expect(doc.releases[0].cuts[0].override?.by).toBe("github:alice");
149
+ contract(releasesSchema).expectValid(doc);
150
+
151
+ // The override is spent: another label needs its own.
152
+ const spent = await refusal(cutRelease(request(dir, T2, { label: "v1.0.2" })));
153
+ expect(spent.code).toBe("release-commit-not-green");
154
+ expect(spent.message).toContain("is spent");
155
+ });
156
+ });
157
+
158
+ test("an image handed to the cut is recorded under an override, and nothing is built (#4694)", async () => {
159
+ await withTestDir(async (dir) => {
160
+ const sha = project(dir);
161
+ await refusal(cutRelease(request(dir, T0)));
162
+ await override(dir, sha, "github:alice");
163
+ const result = await cutRelease({ ...request(dir, T2), images: { api: `registry.fly.io/api@sha256:${"c".repeat(64)}` } });
164
+ expect(result.cut?.override?.by).toBe("github:alice");
165
+ expect(result.handed).toEqual([{ component: "api", ref: `registry.fly.io/api@sha256:${"c".repeat(64)}`, digest: `sha256:${"c".repeat(64)}` }]);
166
+ expect(result.release.artifactDigests).toEqual([{ component: "api", kind: "image", path: "", digest: `sha256:${"c".repeat(64)}`, ref: `registry.fly.io/api@sha256:${"c".repeat(64)}` }]);
167
+ });
168
+ });
169
+
170
+ test("an override counts only from a listed person, with a reason, and not from an agent", async () => {
171
+ await withTestDir(async (dir) => {
172
+ const sha = project(dir);
173
+ await refusal(cutRelease(request(dir, T0)));
174
+ await override(dir, sha, "github:mallory");
175
+ expect((await refusal(cutRelease(request(dir, T2)))).message).toContain("github:mallory is not listed in .chant/overriders at base (github:alice)");
176
+ });
177
+ await withTestDir(async (dir) => {
178
+ const sha = project(dir);
179
+ await refusal(cutRelease(request(dir, T0)));
180
+ await override(dir, sha, "github:alice", { agent: true });
181
+ expect((await refusal(cutRelease(request(dir, T2)))).message).toContain("was recorded by an agent, and an override is a person's");
182
+ });
183
+ await withTestDir(async (dir) => {
184
+ const sha = project(dir);
185
+ await refusal(cutRelease(request(dir, T0)));
186
+ await override(dir, sha, "github:alice", { reason: "" });
187
+ expect((await refusal(cutRelease(request(dir, T2)))).message).toContain("gives no reason");
188
+ });
189
+ });
190
+
191
+ test("with no overriders file nobody may override, and the refusal says so", async () => {
192
+ await withTestDir(async (dir) => {
193
+ project(dir, null);
194
+ const err = await refusal(cutRelease(request(dir, T0)));
195
+ expect(err.fix).toContain(".chant/overriders at base does not exist, so nobody may override it yet");
196
+ });
197
+ });
198
+
199
+ test("without --override-green a standing override is not used, and a revoked commit is never cut", async () => {
200
+ await withTestDir(async (dir) => {
201
+ const sha = project(dir);
202
+ await refusal(cutRelease(request(dir, T0)));
203
+ await override(dir, sha, "github:alice");
204
+ const plain = await refusal(cutRelease(request(dir, T2, { overrideGreen: false })));
205
+ expect(plain.code).toBe("release-commit-not-green");
206
+ expect(plain.message).not.toContain("override");
207
+
208
+ git(dir, "tag", `ci/revoked/${sha}`, sha);
209
+ const revoked = await refusal(cutRelease(request(dir, T2)));
210
+ expect(revoked.code).toBe("release-commit-revoked");
211
+ expect(revoked.message).toContain("an override does not cut a revoked commit");
212
+ expect((await readCuts({ cwd: dir })).cuts).toEqual([]);
213
+ });
214
+ });
215
+
216
+ test("a green commit cuts as before and writes no override", async () => {
217
+ await withTestDir(async (dir) => {
218
+ const sha = project(dir);
219
+ git(dir, "tag", `ci/green/${sha}`, sha);
220
+ const result = await cutRelease(request(dir, T0));
221
+ expect(result.cut).not.toHaveProperty("override");
222
+ expect((await readOverrideLedger({ cwd: dir })).pending).toEqual([]);
223
+ });
224
+ });
225
+ });
@@ -123,6 +123,14 @@ describe("the release digest", () => {
123
123
  expect(computeReleaseDigest({ ...subject, targets: [{ ...t, templates: [{ ...t.templates[0], encoding: "base64" as const }] }] })).not.toBe(digest);
124
124
  });
125
125
 
126
+ test("an artifact without a ref hashes as before #4694; a handed image's ref is in the digest", () => {
127
+ const digest = computeReleaseDigest(subject);
128
+ expect(computeReleaseDigest({ ...subject, artifactDigests: subject.artifactDigests.map((a) => ({ ...a, ref: undefined })) })).toBe(digest);
129
+ const handed = { ...subject, artifactDigests: [{ component: "api", kind: "image" as const, path: "", digest: "sha256:1", ref: "r.io/api@sha256:1" }] };
130
+ expect(computeReleaseDigest(handed)).not.toBe(computeReleaseDigest({ ...handed, artifactDigests: [{ ...handed.artifactDigests[0], ref: "r.io/other@sha256:1" }] }));
131
+ expect(makeRelease(handed).artifactDigests[0].ref).toBe("r.io/api@sha256:1");
132
+ });
133
+
126
134
  test("verifyReleaseDigest catches a release whose content no longer matches its digest", () => {
127
135
  const release = makeRelease(subject);
128
136
  expect(verifyReleaseDigest(release)).toBe(true);
@@ -307,6 +315,43 @@ describe("cutRelease", () => {
307
315
  });
308
316
  });
309
317
 
318
+ test("an image handed to the cut is recorded by its reference, and the component is not built (#4694)", async () => {
319
+ await withTestDir(async (dir) => {
320
+ const sha = initRepo(dir);
321
+ green(dir, sha);
322
+ const ref = `registry.fly.io/api@sha256:${"b".repeat(64)}`;
323
+ const compiler = fixtureCompiler();
324
+ const plan = await planRelease({ cwd: dir, compiler: fixtureCompiler(), label: "v1", actor: "a", env: {}, images: { api: ref } });
325
+ expect(plan.build).toEqual([]);
326
+ expect(plan.handed).toEqual([{ component: "api", ref, digest: `sha256:${"b".repeat(64)}` }]);
327
+
328
+ const result = await cutRelease({ cwd: dir, compiler, label: "v1", actor: "a", env: {}, images: { api: ref } });
329
+ expect(compiler.built).toEqual([]);
330
+ expect(result.release.artifactDigests).toEqual([{ component: "api", kind: "image", path: "", digest: `sha256:${"b".repeat(64)}`, ref }]);
331
+ expect(plan.releaseDigest).toBe(result.release.releaseDigest);
332
+ expect(await readRelease(result.release.releaseDigest, { cwd: dir })).toEqual(result.release);
333
+
334
+ // The next cut hands another image; nothing is carried from the first.
335
+ const next = commitFile(dir, "flags.json", "{}\n");
336
+ green(dir, next);
337
+ const r2 = await cutRelease({ cwd: dir, compiler, label: "v2", actor: "a", env: {}, images: { api: `registry.fly.io/api@sha256:${"c".repeat(64)}` } });
338
+ expect(r2.reused).toEqual([]);
339
+ expect(r2.release.artifactDigests.map((a) => a.digest)).toEqual([`sha256:${"c".repeat(64)}`]);
340
+ });
341
+ });
342
+
343
+ test("refuses an image handed by tag, or for a component that isn't enabled (#4694)", async () => {
344
+ await withTestDir(async (dir) => {
345
+ const sha = initRepo(dir);
346
+ green(dir, sha);
347
+ const byTag = await planRelease({ cwd: dir, compiler: fixtureCompiler(), label: null, actor: "a", env: {}, images: { api: "registry.fly.io/api:latest" } }).catch((e: unknown) => e);
348
+ expect((byTag as ReleaseCutError).code).toBe("release-image-invalid");
349
+ const unknown = await planRelease({ cwd: dir, compiler: fixtureCompiler(), label: null, actor: "a", env: {}, images: { web: `r.io/web@sha256:${"b".repeat(64)}` } }).catch((e: unknown) => e);
350
+ expect((unknown as ReleaseCutError).code).toBe("release-image-unknown-component");
351
+ expect((unknown as ReleaseCutError).fix).toMatch(/api/);
352
+ });
353
+ });
354
+
310
355
  test("refuses a member that declares no environments", async () => {
311
356
  await withTestDir(async (dir) => {
312
357
  const sha = initRepo(dir);