@intentius/chant 0.124.100 → 0.124.101

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 (223) hide show
  1. package/dist/action-pins.d.ts +2 -0
  2. package/dist/action-pins.js +3 -0
  3. package/dist/ci-detect.d.ts +13 -0
  4. package/dist/ci-detect.js +12 -0
  5. package/dist/ci-system.d.ts +66 -0
  6. package/dist/ci-system.js +61 -0
  7. package/dist/cli/handlers/build.js +27 -0
  8. package/dist/cli/handlers/release-doctor.d.ts +12 -0
  9. package/dist/cli/handlers/release-doctor.js +118 -0
  10. package/dist/cli/handlers/release-init.d.ts +10 -0
  11. package/dist/cli/handlers/release-init.js +342 -0
  12. package/dist/cli/handlers/release.d.ts +42 -1
  13. package/dist/cli/handlers/release.js +656 -31
  14. package/dist/cli/handlers/run-generate.js +11 -0
  15. package/dist/cli/main.d.ts +2 -0
  16. package/dist/cli/main.js +44 -101
  17. package/dist/cli/parse-args.js +48 -0
  18. package/dist/cli/registry.d.ts +16 -0
  19. package/dist/cli/release-commands/artifacts.d.ts +3 -0
  20. package/dist/cli/release-commands/artifacts.js +14 -0
  21. package/dist/cli/release-commands/candidates.d.ts +3 -0
  22. package/dist/cli/release-commands/candidates.js +16 -0
  23. package/dist/cli/release-commands/changed.d.ts +3 -0
  24. package/dist/cli/release-commands/changed.js +14 -0
  25. package/dist/cli/release-commands/compose.d.ts +3 -0
  26. package/dist/cli/release-commands/compose.js +16 -0
  27. package/dist/cli/release-commands/cut.d.ts +3 -0
  28. package/dist/cli/release-commands/cut.js +49 -0
  29. package/dist/cli/release-commands/doctor.d.ts +3 -0
  30. package/dist/cli/release-commands/doctor.js +14 -0
  31. package/dist/cli/release-commands/export.d.ts +3 -0
  32. package/dist/cli/release-commands/export.js +12 -0
  33. package/dist/cli/release-commands/images.d.ts +3 -0
  34. package/dist/cli/release-commands/images.js +13 -0
  35. package/dist/cli/release-commands/index.d.ts +8 -0
  36. package/dist/cli/release-commands/index.js +52 -0
  37. package/dist/cli/release-commands/init.d.ts +3 -0
  38. package/dist/cli/release-commands/init.js +16 -0
  39. package/dist/cli/release-commands/list.d.ts +3 -0
  40. package/dist/cli/release-commands/list.js +10 -0
  41. package/dist/cli/release-commands/next.d.ts +3 -0
  42. package/dist/cli/release-commands/next.js +13 -0
  43. package/dist/cli/release-commands/publish.d.ts +3 -0
  44. package/dist/cli/release-commands/publish.js +22 -0
  45. package/dist/cli/release-commands/stamp.d.ts +3 -0
  46. package/dist/cli/release-commands/stamp.js +15 -0
  47. package/dist/cli/release-commands/status.d.ts +3 -0
  48. package/dist/cli/release-commands/status.js +17 -0
  49. package/dist/cli/release-commands/tag.d.ts +3 -0
  50. package/dist/cli/release-commands/tag.js +12 -0
  51. package/dist/cli/release-commands/types.d.ts +20 -0
  52. package/dist/cli/release-commands/types.js +1 -0
  53. package/dist/cli/release-commands/verify.d.ts +3 -0
  54. package/dist/cli/release-commands/verify.js +15 -0
  55. package/dist/cli/release-commands/workflow.d.ts +3 -0
  56. package/dist/cli/release-commands/workflow.js +13 -0
  57. package/dist/components/cli-support.d.ts +1 -1
  58. package/dist/components/cli-support.js +1 -1
  59. package/dist/config-environments.d.ts +8 -1
  60. package/dist/config-environments.js +2 -0
  61. package/dist/config.d.ts +294 -9
  62. package/dist/config.js +100 -5
  63. package/dist/floor-table.data.js +15 -1
  64. package/dist/forge-remote.d.ts +13 -0
  65. package/dist/forge-remote.js +15 -0
  66. package/dist/lexicon.d.ts +41 -2
  67. package/dist/lifecycle/__fixtures__/publish-fakes.d.ts +62 -0
  68. package/dist/lifecycle/__fixtures__/publish-fakes.js +270 -3
  69. package/dist/lifecycle/publish-attachments.d.ts +2 -1
  70. package/dist/lifecycle/publish-attachments.js +19 -2
  71. package/dist/lifecycle/publish-cargo.d.ts +99 -0
  72. package/dist/lifecycle/publish-cargo.js +412 -0
  73. package/dist/lifecycle/publish-credentials.d.ts +1 -1
  74. package/dist/lifecycle/publish-credentials.js +8 -0
  75. package/dist/lifecycle/publish-declaration.d.ts +199 -4
  76. package/dist/lifecycle/publish-declaration.js +200 -9
  77. package/dist/lifecycle/publish-forge.d.ts +45 -2
  78. package/dist/lifecycle/publish-forge.js +434 -34
  79. package/dist/lifecycle/publish-git-ssh.d.ts +15 -0
  80. package/dist/lifecycle/publish-git-ssh.js +30 -4
  81. package/dist/lifecycle/publish-github.d.ts +40 -2
  82. package/dist/lifecycle/publish-github.js +100 -3
  83. package/dist/lifecycle/publish-homebrew.d.ts +7 -9
  84. package/dist/lifecycle/publish-homebrew.js +34 -197
  85. package/dist/lifecycle/publish-index.d.ts +141 -0
  86. package/dist/lifecycle/publish-index.js +719 -0
  87. package/dist/lifecycle/publish-marketplace.js +77 -0
  88. package/dist/lifecycle/publish-mcp-registry.d.ts +66 -0
  89. package/dist/lifecycle/publish-mcp-registry.js +306 -0
  90. package/dist/lifecycle/publish-npm.js +165 -2
  91. package/dist/lifecycle/publish-oci.d.ts +34 -1
  92. package/dist/lifecycle/publish-oci.js +246 -7
  93. package/dist/lifecycle/publish-pypi.d.ts +136 -0
  94. package/dist/lifecycle/publish-pypi.js +657 -0
  95. package/dist/lifecycle/publish-record.d.ts +6 -3
  96. package/dist/lifecycle/publish-record.js +6 -3
  97. package/dist/lifecycle/publish-signing.d.ts +147 -0
  98. package/dist/lifecycle/publish-signing.js +257 -0
  99. package/dist/lifecycle/publish-targets.d.ts +27 -1
  100. package/dist/lifecycle/publish-targets.js +80 -0
  101. package/dist/lifecycle/publish-tauri.js +43 -0
  102. package/dist/lifecycle/publish-train-names.d.ts +54 -0
  103. package/dist/lifecycle/publish-train-names.js +118 -0
  104. package/dist/lifecycle/publish-verify.d.ts +121 -0
  105. package/dist/lifecycle/publish-verify.js +130 -0
  106. package/dist/lifecycle/query.js +8 -0
  107. package/dist/lifecycle/release-artifacts.d.ts +212 -0
  108. package/dist/lifecycle/release-artifacts.js +571 -0
  109. package/dist/lifecycle/release-changelog.d.ts +13 -1
  110. package/dist/lifecycle/release-changelog.js +35 -2
  111. package/dist/lifecycle/release-cut.d.ts +58 -3
  112. package/dist/lifecycle/release-cut.js +132 -34
  113. package/dist/lifecycle/release-doctor.d.ts +113 -0
  114. package/dist/lifecycle/release-doctor.js +996 -0
  115. package/dist/lifecycle/release-green.d.ts +86 -0
  116. package/dist/lifecycle/release-green.js +286 -0
  117. package/dist/lifecycle/release-init.d.ts +255 -0
  118. package/dist/lifecycle/release-init.js +859 -0
  119. package/dist/lifecycle/release-intents.d.ts +73 -0
  120. package/dist/lifecycle/release-intents.js +128 -0
  121. package/dist/lifecycle/release-next.d.ts +111 -0
  122. package/dist/lifecycle/release-next.js +252 -0
  123. package/dist/lifecycle/release-prerelease.d.ts +19 -0
  124. package/dist/lifecycle/release-prerelease.js +30 -0
  125. package/dist/lifecycle/release-publish.d.ts +256 -10
  126. package/dist/lifecycle/release-publish.js +246 -34
  127. package/dist/lifecycle/release-status-change.d.ts +226 -0
  128. package/dist/lifecycle/release-status-change.js +478 -0
  129. package/dist/lifecycle/release-status.d.ts +11 -0
  130. package/dist/lifecycle/release-status.js +1 -1
  131. package/dist/lifecycle/release-store.d.ts +73 -2
  132. package/dist/lifecycle/release-store.js +32 -1
  133. package/dist/lifecycle/release-tag.d.ts +142 -0
  134. package/dist/lifecycle/release-tag.js +323 -0
  135. package/dist/lifecycle/release-verify.d.ts +73 -1
  136. package/dist/lifecycle/release-verify.js +117 -2
  137. package/dist/lifecycle/release-version-formats.d.ts +73 -0
  138. package/dist/lifecycle/release-version-formats.js +570 -0
  139. package/dist/lifecycle/release-version.d.ts +58 -10
  140. package/dist/lifecycle/release-version.js +164 -36
  141. package/dist/lifecycle/release-workstation.d.ts +3 -2
  142. package/dist/lifecycle/release-workstation.js +3 -2
  143. package/dist/op/generate-pipeline.js +1 -1
  144. package/dist/pr-forge-base.js +4 -2
  145. package/dist/pr-forge.d.ts +20 -2
  146. package/dist/pr-forge.js +46 -10
  147. package/dist/release-floors.d.ts +8 -1
  148. package/dist/release-floors.js +9 -2
  149. package/dist/tool-pins.d.ts +38 -0
  150. package/dist/tool-pins.js +54 -0
  151. package/dist/wave-runtime.mjs +337 -334
  152. package/dist/workspace/ci-forge.d.ts +17 -0
  153. package/dist/workspace/ci-forge.js +17 -0
  154. package/dist/workspace/ci-init.js +1 -1
  155. package/dist/workspace/composites.schema.json +1 -0
  156. package/dist/workspace/declaration.d.ts +8 -0
  157. package/dist/workspace/declaration.js +12 -0
  158. package/dist/workspace/declaration.schema.json +8 -0
  159. package/dist/workspace/environments.d.ts +2 -0
  160. package/dist/workspace/environments.js +1 -1
  161. package/dist/workspace/identity-gate-rule.d.ts +61 -5
  162. package/dist/workspace/identity-gate-rule.js +81 -12
  163. package/dist/workspace/member-pipeline.d.ts +2 -1
  164. package/dist/workspace/member-pipeline.js +5 -2
  165. package/dist/workspace/reason-codes.d.ts +2 -0
  166. package/dist/workspace/reason-codes.js +3 -1
  167. package/dist/workspace/release-changed.d.ts +75 -4
  168. package/dist/workspace/release-changed.js +205 -34
  169. package/dist/workspace/release-changed.schema.json +20 -2
  170. package/dist/workspace/release-steps/artifacts.d.ts +7 -0
  171. package/dist/workspace/release-steps/artifacts.js +45 -0
  172. package/dist/workspace/release-steps/builds.d.ts +12 -0
  173. package/dist/workspace/release-steps/builds.js +38 -0
  174. package/dist/workspace/release-steps/doctor.d.ts +8 -0
  175. package/dist/workspace/release-steps/doctor.js +14 -0
  176. package/dist/workspace/release-steps/goreleaser.d.ts +16 -0
  177. package/dist/workspace/release-steps/goreleaser.js +36 -0
  178. package/dist/workspace/release-steps/green.d.ts +3 -0
  179. package/dist/workspace/release-steps/green.js +6 -0
  180. package/dist/workspace/release-steps/images.d.ts +22 -0
  181. package/dist/workspace/release-steps/images.js +59 -0
  182. package/dist/workspace/release-steps/index.d.ts +9 -0
  183. package/dist/workspace/release-steps/index.js +46 -0
  184. package/dist/workspace/release-steps/pypi.d.ts +15 -0
  185. package/dist/workspace/release-steps/pypi.js +21 -0
  186. package/dist/workspace/release-steps/qemu.d.ts +21 -0
  187. package/dist/workspace/release-steps/qemu.js +35 -0
  188. package/dist/workspace/release-steps/signing.d.ts +18 -0
  189. package/dist/workspace/release-steps/signing.js +30 -0
  190. package/dist/workspace/release-steps/stamp.d.ts +3 -0
  191. package/dist/workspace/release-steps/stamp.js +4 -0
  192. package/dist/workspace/release-steps/targets.d.ts +31 -0
  193. package/dist/workspace/release-steps/targets.js +40 -0
  194. package/dist/workspace/release-steps/types.d.ts +104 -0
  195. package/dist/workspace/release-steps/types.js +2 -0
  196. package/dist/workspace/release-steps/verify.d.ts +3 -0
  197. package/dist/workspace/release-steps/verify.js +4 -0
  198. package/dist/workspace/release-toolchains.d.ts +59 -0
  199. package/dist/workspace/release-toolchains.js +133 -0
  200. package/dist/workspace/release-train-workflow.d.ts +29 -0
  201. package/dist/workspace/release-train-workflow.js +85 -0
  202. package/dist/workspace/release-train.d.ts +3 -1
  203. package/dist/workspace/release-train.js +20 -3
  204. package/dist/workspace/release-workflow.d.ts +160 -61
  205. package/dist/workspace/release-workflow.js +539 -193
  206. package/dist/workspace/releases.schema.json +70 -1
  207. package/dist/workspace/search-contract.d.ts +1 -1
  208. package/dist/workspace/security.js +9 -2
  209. package/dist/workspace/train-cut.d.ts +182 -0
  210. package/dist/workspace/train-cut.js +482 -0
  211. package/dist/workspace/train-prepare.d.ts +61 -0
  212. package/dist/workspace/train-prepare.js +267 -0
  213. package/dist/workspace/train-publish.d.ts +177 -0
  214. package/dist/workspace/train-publish.js +575 -0
  215. package/dist/workspace/train-range-labels.d.ts +33 -0
  216. package/dist/workspace/train-range-labels.js +109 -0
  217. package/dist/workspace/trust/seal.d.ts +13 -3
  218. package/dist/workspace/trust/seal.js +14 -4
  219. package/dist/workspace/work-cli.d.ts +3 -2
  220. package/dist/workspace/work-cli.js +3 -2
  221. package/dist/workspace/workspace-ledger.d.ts +14 -1
  222. package/dist/workspace/workspace-ledger.js +33 -7
  223. package/package.json +1 -1
@@ -12,7 +12,11 @@
12
12
  * { type: "forge", forge: "github", repo: "acme/api", assets: ["dist/api-linux-amd64.tar.gz"] },
13
13
  * { type: "marketplace", marketplace: "openvsx", vsix: "dist/acme.vsix" },
14
14
  * { type: "tauri-updater", repo: "acme/app", tag: "app-latest", platforms: { "darwin-aarch64": "dist/Acme_aarch64.app.tar.gz" } },
15
+ * { type: "mcp-registry", server: "server.json" },
15
16
  * { type: "homebrew", tap: "acme/homebrew-tap", formula: "Formula/api.rb", template: "packaging/api.rb", assets: ["dist/api-linux-amd64.tar.gz"], url: "https://github.com/acme/api/releases/download/{tag}/{name}" },
17
+ * { type: "pypi", files: ["dist"] },
18
+ * { type: "cargo", crates: ["acme-core", "acme-cli"] },
19
+ * { type: "index", preset: "krew", name: "api", template: "packaging/krew.yaml", assets: ["artifact:api"], url: "https://github.com/acme/api/releases/download/{tag}/{name}" },
16
20
  * ],
17
21
  * },
18
22
  * };
@@ -63,9 +67,14 @@ export declare const ForgePublishSchema: z.ZodObject<{
63
67
  api: z.ZodOptional<z.ZodString>;
64
68
  assets: z.ZodArray<z.ZodString>;
65
69
  notes: z.ZodOptional<z.ZodObject<{
66
- file: z.ZodString;
67
- heading: z.ZodString;
70
+ file: z.ZodOptional<z.ZodString>;
71
+ heading: z.ZodOptional<z.ZodString>;
68
72
  linkBase: z.ZodOptional<z.ZodString>;
73
+ generate: z.ZodOptional<z.ZodEnum<{
74
+ commits: "commits";
75
+ forge: "forge";
76
+ }>>;
77
+ types: z.ZodOptional<z.ZodArray<z.ZodString>>;
69
78
  before: z.ZodOptional<z.ZodString>;
70
79
  after: z.ZodOptional<z.ZodString>;
71
80
  }, z.core.$strict>>;
@@ -132,6 +141,110 @@ export declare const TauriUpdaterPublishSchema: z.ZodObject<{
132
141
  api: z.ZodOptional<z.ZodString>;
133
142
  tokenEnv: z.ZodOptional<z.ZodString>;
134
143
  }, z.core.$strict>;
144
+ /**
145
+ * Python distributions on PyPI, TestPyPI or another index that takes PyPI's
146
+ * upload API (./publish-pypi.ts). The wheels and sdists are uploaded at the
147
+ * reveal, since an index has no draft.
148
+ */
149
+ export declare const PypiPublishSchema: z.ZodObject<{
150
+ type: z.ZodLiteral<"pypi">;
151
+ files: z.ZodArray<z.ZodString>;
152
+ index: z.ZodOptional<z.ZodEnum<{
153
+ pypi: "pypi";
154
+ testpypi: "testpypi";
155
+ }>>;
156
+ uploadUrl: z.ZodOptional<z.ZodString>;
157
+ simpleUrl: z.ZodOptional<z.ZodString>;
158
+ auth: z.ZodOptional<z.ZodEnum<{
159
+ token: "token";
160
+ "trusted-publishing": "trusted-publishing";
161
+ }>>;
162
+ tokenEnv: z.ZodOptional<z.ZodString>;
163
+ usernameEnv: z.ZodOptional<z.ZodString>;
164
+ sbom: z.ZodOptional<z.ZodLiteral<false>>;
165
+ attestations: z.ZodOptional<z.ZodBoolean>;
166
+ }, z.core.$strict>;
167
+ /**
168
+ * Rust crates on crates.io or another Cargo registry, published with
169
+ * `cargo publish` one crate at a time in dependency order
170
+ * (./publish-cargo.ts). A crate is visible as soon as it is published, so
171
+ * the reveal publishes.
172
+ */
173
+ export declare const CargoPublishSchema: z.ZodObject<{
174
+ type: z.ZodLiteral<"cargo">;
175
+ manifest: z.ZodOptional<z.ZodString>;
176
+ crates: z.ZodOptional<z.ZodArray<z.ZodString>>;
177
+ registry: z.ZodOptional<z.ZodString>;
178
+ index: z.ZodOptional<z.ZodString>;
179
+ api: z.ZodOptional<z.ZodString>;
180
+ auth: z.ZodOptional<z.ZodEnum<{
181
+ token: "token";
182
+ "trusted-publishing": "trusted-publishing";
183
+ }>>;
184
+ tokenEnv: z.ZodOptional<z.ZodString>;
185
+ sbom: z.ZodOptional<z.ZodLiteral<false>>;
186
+ }, z.core.$strict>;
187
+ /**
188
+ * A `server.json` on the official MCP Registry (#5162), published after the
189
+ * npm packages or images it names have been revealed
190
+ * (./publish-mcp-registry.ts).
191
+ */
192
+ export declare const McpRegistryPublishSchema: z.ZodObject<{
193
+ type: z.ZodLiteral<"mcp-registry">;
194
+ server: z.ZodOptional<z.ZodString>;
195
+ registry: z.ZodOptional<z.ZodString>;
196
+ auth: z.ZodOptional<z.ZodEnum<{
197
+ "github-oidc": "github-oidc";
198
+ "github-token": "github-token";
199
+ "registry-token": "registry-token";
200
+ }>>;
201
+ tokenEnv: z.ZodOptional<z.ZodString>;
202
+ }, z.core.$strict>;
203
+ /** The index repositories `index` has a preset for (#5158). */
204
+ export declare const INDEX_PRESETS: readonly ["krew", "winget", "scoop", "homebrew-core", "homebrew-tap", "zed", "artifacthub"];
205
+ /**
206
+ * A manifest in an index repository on GitHub (#5158), such as krew-index,
207
+ * winget-pkgs, a Scoop bucket, homebrew-core, a Homebrew tap, Zed's
208
+ * extensions or an Artifact Hub repository, rendered from templates in the
209
+ * member and either committed to a repository the publisher may push to
210
+ * (`mode: "commit"`) or proposed in a pull request from a fork
211
+ * (`mode: "pull-request"`). It reveals after every other target
212
+ * (./publish-index.ts).
213
+ */
214
+ export declare const IndexPublishSchema: z.ZodObject<{
215
+ type: z.ZodLiteral<"index">;
216
+ preset: z.ZodOptional<z.ZodEnum<{
217
+ artifacthub: "artifacthub";
218
+ "homebrew-core": "homebrew-core";
219
+ "homebrew-tap": "homebrew-tap";
220
+ krew: "krew";
221
+ scoop: "scoop";
222
+ winget: "winget";
223
+ zed: "zed";
224
+ }>>;
225
+ repo: z.ZodOptional<z.ZodString>;
226
+ name: z.ZodString;
227
+ mode: z.ZodOptional<z.ZodEnum<{
228
+ commit: "commit";
229
+ "pull-request": "pull-request";
230
+ }>>;
231
+ template: z.ZodOptional<z.ZodString>;
232
+ path: z.ZodOptional<z.ZodString>;
233
+ files: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
234
+ assets: z.ZodOptional<z.ZodArray<z.ZodString>>;
235
+ url: z.ZodOptional<z.ZodString>;
236
+ branch: z.ZodOptional<z.ZodString>;
237
+ fork: z.ZodOptional<z.ZodString>;
238
+ title: z.ZodOptional<z.ZodString>;
239
+ body: z.ZodOptional<z.ZodString>;
240
+ api: z.ZodOptional<z.ZodString>;
241
+ tokenEnv: z.ZodOptional<z.ZodString>;
242
+ sshKeyEnv: z.ZodOptional<z.ZodString>;
243
+ onRefusal: z.ZodOptional<z.ZodEnum<{
244
+ fail: "fail";
245
+ warn: "warn";
246
+ }>>;
247
+ }, z.core.$strict>;
135
248
  export declare const PublishDeclarationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
136
249
  type: z.ZodLiteral<"npm">;
137
250
  packages: z.ZodArray<z.ZodString>;
@@ -164,9 +277,14 @@ export declare const PublishDeclarationSchema: z.ZodDiscriminatedUnion<[z.ZodObj
164
277
  api: z.ZodOptional<z.ZodString>;
165
278
  assets: z.ZodArray<z.ZodString>;
166
279
  notes: z.ZodOptional<z.ZodObject<{
167
- file: z.ZodString;
168
- heading: z.ZodString;
280
+ file: z.ZodOptional<z.ZodString>;
281
+ heading: z.ZodOptional<z.ZodString>;
169
282
  linkBase: z.ZodOptional<z.ZodString>;
283
+ generate: z.ZodOptional<z.ZodEnum<{
284
+ commits: "commits";
285
+ forge: "forge";
286
+ }>>;
287
+ types: z.ZodOptional<z.ZodArray<z.ZodString>>;
170
288
  before: z.ZodOptional<z.ZodString>;
171
289
  after: z.ZodOptional<z.ZodString>;
172
290
  }, z.core.$strict>>;
@@ -215,6 +333,79 @@ export declare const PublishDeclarationSchema: z.ZodDiscriminatedUnion<[z.ZodObj
215
333
  latest: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"legacy">]>>;
216
334
  api: z.ZodOptional<z.ZodString>;
217
335
  tokenEnv: z.ZodOptional<z.ZodString>;
336
+ }, z.core.$strict>, z.ZodObject<{
337
+ type: z.ZodLiteral<"pypi">;
338
+ files: z.ZodArray<z.ZodString>;
339
+ index: z.ZodOptional<z.ZodEnum<{
340
+ pypi: "pypi";
341
+ testpypi: "testpypi";
342
+ }>>;
343
+ uploadUrl: z.ZodOptional<z.ZodString>;
344
+ simpleUrl: z.ZodOptional<z.ZodString>;
345
+ auth: z.ZodOptional<z.ZodEnum<{
346
+ token: "token";
347
+ "trusted-publishing": "trusted-publishing";
348
+ }>>;
349
+ tokenEnv: z.ZodOptional<z.ZodString>;
350
+ usernameEnv: z.ZodOptional<z.ZodString>;
351
+ sbom: z.ZodOptional<z.ZodLiteral<false>>;
352
+ attestations: z.ZodOptional<z.ZodBoolean>;
353
+ }, z.core.$strict>, z.ZodObject<{
354
+ type: z.ZodLiteral<"cargo">;
355
+ manifest: z.ZodOptional<z.ZodString>;
356
+ crates: z.ZodOptional<z.ZodArray<z.ZodString>>;
357
+ registry: z.ZodOptional<z.ZodString>;
358
+ index: z.ZodOptional<z.ZodString>;
359
+ api: z.ZodOptional<z.ZodString>;
360
+ auth: z.ZodOptional<z.ZodEnum<{
361
+ token: "token";
362
+ "trusted-publishing": "trusted-publishing";
363
+ }>>;
364
+ tokenEnv: z.ZodOptional<z.ZodString>;
365
+ sbom: z.ZodOptional<z.ZodLiteral<false>>;
366
+ }, z.core.$strict>, z.ZodObject<{
367
+ type: z.ZodLiteral<"mcp-registry">;
368
+ server: z.ZodOptional<z.ZodString>;
369
+ registry: z.ZodOptional<z.ZodString>;
370
+ auth: z.ZodOptional<z.ZodEnum<{
371
+ "github-oidc": "github-oidc";
372
+ "github-token": "github-token";
373
+ "registry-token": "registry-token";
374
+ }>>;
375
+ tokenEnv: z.ZodOptional<z.ZodString>;
376
+ }, z.core.$strict>, z.ZodObject<{
377
+ type: z.ZodLiteral<"index">;
378
+ preset: z.ZodOptional<z.ZodEnum<{
379
+ artifacthub: "artifacthub";
380
+ "homebrew-core": "homebrew-core";
381
+ "homebrew-tap": "homebrew-tap";
382
+ krew: "krew";
383
+ scoop: "scoop";
384
+ winget: "winget";
385
+ zed: "zed";
386
+ }>>;
387
+ repo: z.ZodOptional<z.ZodString>;
388
+ name: z.ZodString;
389
+ mode: z.ZodOptional<z.ZodEnum<{
390
+ commit: "commit";
391
+ "pull-request": "pull-request";
392
+ }>>;
393
+ template: z.ZodOptional<z.ZodString>;
394
+ path: z.ZodOptional<z.ZodString>;
395
+ files: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
396
+ assets: z.ZodOptional<z.ZodArray<z.ZodString>>;
397
+ url: z.ZodOptional<z.ZodString>;
398
+ branch: z.ZodOptional<z.ZodString>;
399
+ fork: z.ZodOptional<z.ZodString>;
400
+ title: z.ZodOptional<z.ZodString>;
401
+ body: z.ZodOptional<z.ZodString>;
402
+ api: z.ZodOptional<z.ZodString>;
403
+ tokenEnv: z.ZodOptional<z.ZodString>;
404
+ sshKeyEnv: z.ZodOptional<z.ZodString>;
405
+ onRefusal: z.ZodOptional<z.ZodEnum<{
406
+ fail: "fail";
407
+ warn: "warn";
408
+ }>>;
218
409
  }, z.core.$strict>], "type">;
219
410
  export type NpmPublishDeclaration = z.infer<typeof NpmPublishSchema>;
220
411
  export type OciPublishDeclaration = z.infer<typeof OciPublishSchema>;
@@ -222,4 +413,8 @@ export type ForgePublishDeclaration = z.infer<typeof ForgePublishSchema>;
222
413
  export type HomebrewPublishDeclaration = z.infer<typeof HomebrewPublishSchema>;
223
414
  export type MarketplacePublishDeclaration = z.infer<typeof MarketplacePublishSchema>;
224
415
  export type TauriUpdaterPublishDeclaration = z.infer<typeof TauriUpdaterPublishSchema>;
416
+ export type PypiPublishDeclaration = z.infer<typeof PypiPublishSchema>;
417
+ export type CargoPublishDeclaration = z.infer<typeof CargoPublishSchema>;
418
+ export type McpRegistryPublishDeclaration = z.infer<typeof McpRegistryPublishSchema>;
419
+ export type IndexPublishDeclaration = z.infer<typeof IndexPublishSchema>;
225
420
  export type PublishDeclaration = z.infer<typeof PublishDeclarationSchema>;
@@ -12,7 +12,11 @@
12
12
  * { type: "forge", forge: "github", repo: "acme/api", assets: ["dist/api-linux-amd64.tar.gz"] },
13
13
  * { type: "marketplace", marketplace: "openvsx", vsix: "dist/acme.vsix" },
14
14
  * { type: "tauri-updater", repo: "acme/app", tag: "app-latest", platforms: { "darwin-aarch64": "dist/Acme_aarch64.app.tar.gz" } },
15
+ * { type: "mcp-registry", server: "server.json" },
15
16
  * { type: "homebrew", tap: "acme/homebrew-tap", formula: "Formula/api.rb", template: "packaging/api.rb", assets: ["dist/api-linux-amd64.tar.gz"], url: "https://github.com/acme/api/releases/download/{tag}/{name}" },
17
+ * { type: "pypi", files: ["dist"] },
18
+ * { type: "cargo", crates: ["acme-core", "acme-cli"] },
19
+ * { type: "index", preset: "krew", name: "api", template: "packaging/krew.yaml", assets: ["artifact:api"], url: "https://github.com/acme/api/releases/download/{tag}/{name}" },
16
20
  * ],
17
21
  * },
18
22
  * };
@@ -106,29 +110,43 @@ export const ForgePublishSchema = z
106
110
  /** Files to attach, relative to the member. May be empty when `notes` gives the release its body. */
107
111
  assets: z.array(z.string().min(1)),
108
112
  /**
109
- * The release's notes (#4658): a section of a file in the member, sent as
110
- * the release's body on GitHub and Forgejo and its description on GitLab.
113
+ * The release's notes (#4658), sent as the release's body on GitHub and
114
+ * Forgejo and its description on GitLab: a section of a file in the
115
+ * member, notes generated for the release (#5153), or both, between
116
+ * `before` and `after`. They are decided when the target stages, so the
117
+ * draft release carries them before the reveal.
111
118
  */
112
119
  notes: z
113
120
  .object({
114
- /** The file, relative to the member, such as `CHANGELOG.md` or a docs site's changes page. */
115
- file: z.string().min(1),
121
+ /** The file, relative to the member, such as `CHANGELOG.md` or a docs site's changes page. Needs `heading`. */
122
+ file: z.string().min(1).optional(),
116
123
  /**
117
124
  * The heading that starts the section, such as `## In {version}` or `## [{version}]`. `{label}`, `{version}`
118
125
  * (the label from its first digit) and `{tag}` are filled in. The section runs to the next heading of the same
119
126
  * level or higher.
120
127
  */
121
- heading: z.string().regex(/^#{1,6} \S/, "a markdown heading, such as ## {version}"),
128
+ heading: z.string().regex(/^#{1,6} \S/, "a markdown heading, such as ## {version}").optional(),
122
129
  /** Links that start with `/` are made absolute against this, such as `https://docs.example.com`. */
123
130
  linkBase: z.string().url().optional(),
124
- /** A paragraph before the section, with the same placeholders. */
131
+ /**
132
+ * Notes generated for the release, after the file's section (#5153). `forge`: the forge's own, GitHub's
133
+ * generate-notes or GitLab's changelog from `Changelog:` commit trailers; Forgejo has none and is refused.
134
+ * `commits`: chant's own, from the conventional commits in the member since its previous release.
135
+ */
136
+ generate: z.enum(["forge", "commits"]).optional(),
137
+ /** With `generate: "commits"`: the commit types listed. Default `feat`, `fix` and `perf`. A breaking change is listed whatever its type; `*` lists every commit. */
138
+ types: z.array(z.string().min(1)).min(1).optional(),
139
+ /** A paragraph before the notes, with the same placeholders. */
125
140
  before: z.string().min(1).optional(),
126
- /** A paragraph after the section, with the same placeholders. */
141
+ /** A paragraph after the notes, with the same placeholders. */
127
142
  after: z.string().min(1).optional(),
128
143
  })
129
144
  .strict()
145
+ .refine((n) => (n.file === undefined) === (n.heading === undefined), { message: "notes.file and notes.heading go together", path: ["heading"] })
146
+ .refine((n) => n.file !== undefined || n.generate !== undefined, { message: "notes need a file section, generate, or both", path: ["generate"] })
147
+ .refine((n) => n.types === undefined || n.generate === "commits", { message: 'notes.types applies to generate: "commits"', path: ["types"] })
130
148
  .optional(),
131
- /** The forge release's tag. Default: the tag the cut made, `release/<label>` or `release/<member>/<label>`. */
149
+ /** The forge release's tag. Default: the tag the cut made, from `release.tag` (#5150; `release/<label>` or `release/<member>/<label>` when unset). */
132
150
  tag: z.string().min(1).optional(),
133
151
  /** The variable holding the token. Default `GITHUB_TOKEN`, `GITLAB_TOKEN` (then `CI_JOB_TOKEN`), or `FORGEJO_TOKEN`. */
134
152
  tokenEnv: envName.optional(),
@@ -243,4 +261,177 @@ export const TauriUpdaterPublishSchema = z
243
261
  tokenEnv: envName.optional(),
244
262
  })
245
263
  .strict();
246
- export const PublishDeclarationSchema = z.discriminatedUnion("type", [NpmPublishSchema, OciPublishSchema, ForgePublishSchema, HomebrewPublishSchema, MarketplacePublishSchema, TauriUpdaterPublishSchema]);
264
+ /**
265
+ * Python distributions on PyPI, TestPyPI or another index that takes PyPI's
266
+ * upload API (./publish-pypi.ts). The wheels and sdists are uploaded at the
267
+ * reveal, since an index has no draft.
268
+ */
269
+ export const PypiPublishSchema = z
270
+ .object({
271
+ type: z.literal("pypi"),
272
+ /**
273
+ * The wheels and sdists, relative to the member: a file, a directory
274
+ * (every `.whl`, `.tar.gz` and `.zip` in it), or `artifact:<name>` for the
275
+ * files the release records for that `release.artifacts` entry.
276
+ */
277
+ files: z.array(z.string().min(1)).min(1),
278
+ /** `pypi` (the default) or `testpypi`. */
279
+ index: z.enum(["pypi", "testpypi"]).optional(),
280
+ /** Another index's upload URL, such as `https://pypi.example.com/legacy/`. Needs `simpleUrl`. */
281
+ uploadUrl: z.string().url().optional(),
282
+ /** That index's simple API root, such as `https://pypi.example.com/simple/`, which the stage and reveal read. */
283
+ simpleUrl: z.string().url().optional(),
284
+ /**
285
+ * `token` reads an API token from `tokenEnv`. `trusted-publishing`
286
+ * exchanges the run's OIDC ID token for a short-lived upload token, on
287
+ * PyPI and TestPyPI only. Unset: a token when `tokenEnv`'s variable is
288
+ * set, else trusted publishing when the run has an OIDC ID token.
289
+ */
290
+ auth: z.enum(["token", "trusted-publishing"]).optional(),
291
+ /** The variable holding the API token. Default `PYPI_TOKEN`, or `TEST_PYPI_TOKEN` for TestPyPI. */
292
+ tokenEnv: envName.optional(),
293
+ /** The variable holding the user name the token is sent with. Default: `__token__`, as PyPI's API tokens take. */
294
+ usernameEnv: envName.optional(),
295
+ /**
296
+ * `false` publishes wheels without an SBOM under the `supply-chain`
297
+ * group, which otherwise refuses a wheel that carries none in its
298
+ * `.dist-info/sboms/` (PEP 770).
299
+ */
300
+ sbom: z.literal(false).optional(),
301
+ /**
302
+ * Upload the PEP 740 attestations beside each file, `<file>.<name>.attestation`
303
+ * as `pypi-attestations sign` writes them. Default `true`. chant does not
304
+ * write them.
305
+ */
306
+ attestations: z.boolean().optional(),
307
+ })
308
+ .strict()
309
+ .refine((d) => (d.uploadUrl === undefined) === (d.simpleUrl === undefined), { message: "uploadUrl and simpleUrl go together", path: ["simpleUrl"] })
310
+ .refine((d) => d.uploadUrl === undefined || d.index === undefined, { message: "index names PyPI or TestPyPI; uploadUrl names another index, so set one of them", path: ["index"] })
311
+ .refine((d) => d.uploadUrl === undefined || d.auth !== "trusted-publishing", { message: "trusted publishing is PyPI's and TestPyPI's; another index takes a token", path: ["auth"] })
312
+ .refine((d) => d.auth !== "trusted-publishing" || (d.tokenEnv === undefined && d.usernameEnv === undefined), { message: "auth: trusted-publishing reads no token", path: ["tokenEnv"] });
313
+ /**
314
+ * Rust crates on crates.io or another Cargo registry, published with
315
+ * `cargo publish` one crate at a time in dependency order
316
+ * (./publish-cargo.ts). A crate is visible as soon as it is published, so
317
+ * the reveal publishes.
318
+ */
319
+ export const CargoPublishSchema = z
320
+ .object({
321
+ type: z.literal("cargo"),
322
+ /** The `Cargo.toml` of the workspace or the crate, relative to the member. Default `Cargo.toml`. */
323
+ manifest: z.string().min(1).optional(),
324
+ /** The crates to publish, by package name. Default: every workspace member whose `publish` allows the registry. */
325
+ crates: z.array(z.string().min(1)).min(1).optional(),
326
+ /** A registry named in the project's `.cargo/config.toml`, passed as `cargo publish --registry`. Default: crates.io. Needs `index`. */
327
+ registry: z.string().regex(/^[A-Za-z0-9_-]+$/, "a registry name from .cargo/config.toml").optional(),
328
+ /** The registry's sparse index, such as `sparse+https://cargo.example.com/index/`, which the stage and reveal read. Default: crates.io's. */
329
+ index: z.string().regex(/^(sparse\+)?https?:\/\//, "a sparse index URL").optional(),
330
+ /** crates.io's API root, for trusted publishing. Default `https://crates.io`. */
331
+ api: z.string().url().optional(),
332
+ /**
333
+ * `token` reads a registry token from `tokenEnv`. `trusted-publishing`
334
+ * exchanges the run's OIDC ID token for a short-lived crates.io token,
335
+ * revoked after the publish. Unset: a token when `tokenEnv`'s variable is
336
+ * set, else trusted publishing when the run has an OIDC ID token.
337
+ */
338
+ auth: z.enum(["token", "trusted-publishing"]).optional(),
339
+ /** The variable holding the token. Default `CARGO_REGISTRY_TOKEN`, or `CARGO_REGISTRIES_<NAME>_TOKEN` with `registry`, the variables cargo reads. */
340
+ tokenEnv: envName.optional(),
341
+ /** `false` publishes under the `supply-chain` group, which otherwise refuses this target: a registry keeps no SBOM beside a crate. */
342
+ sbom: z.literal(false).optional(),
343
+ })
344
+ .strict()
345
+ .refine((d) => d.registry === undefined || d.index !== undefined, { message: "a registry other than crates.io needs its sparse index", path: ["index"] })
346
+ .refine((d) => d.registry === undefined || d.auth !== "trusted-publishing", { message: "trusted publishing is crates.io's; another registry takes a token", path: ["auth"] })
347
+ .refine((d) => d.auth !== "trusted-publishing" || d.tokenEnv === undefined, { message: "auth: trusted-publishing reads no token", path: ["tokenEnv"] });
348
+ /**
349
+ * A `server.json` on the official MCP Registry (#5162), published after the
350
+ * npm packages or images it names have been revealed
351
+ * (./publish-mcp-registry.ts).
352
+ */
353
+ export const McpRegistryPublishSchema = z
354
+ .object({
355
+ type: z.literal("mcp-registry"),
356
+ /** The `server.json`, relative to the member. Default `server.json`. Its `version` and each package's version must be the release's label. */
357
+ server: z.string().min(1).optional(),
358
+ /** The registry's root. Default `https://registry.modelcontextprotocol.io`. */
359
+ registry: z.string().url().optional(),
360
+ /**
361
+ * How the target gets a registry token. `"github-oidc"` (the default)
362
+ * exchanges the GitHub Actions OIDC token of a job with `id-token: write`.
363
+ * `"github-token"` exchanges a GitHub token read from `tokenEnv`, default
364
+ * `MCP_GITHUB_TOKEN`. `"registry-token"` sends a registry token read from
365
+ * `tokenEnv`, default `MCP_REGISTRY_TOKEN`, such as one `mcp-publisher`
366
+ * got by a DNS or HTTP login.
367
+ */
368
+ auth: z.enum(["github-oidc", "github-token", "registry-token"]).optional(),
369
+ /** The variable holding the token, under `github-token` or `registry-token`. */
370
+ tokenEnv: envName.optional(),
371
+ })
372
+ .strict();
373
+ /** The index repositories `index` has a preset for (#5158). */
374
+ export const INDEX_PRESETS = ["krew", "winget", "scoop", "homebrew-core", "homebrew-tap", "zed", "artifacthub"];
375
+ /**
376
+ * A manifest in an index repository on GitHub (#5158), such as krew-index,
377
+ * winget-pkgs, a Scoop bucket, homebrew-core, a Homebrew tap, Zed's
378
+ * extensions or an Artifact Hub repository, rendered from templates in the
379
+ * member and either committed to a repository the publisher may push to
380
+ * (`mode: "commit"`) or proposed in a pull request from a fork
381
+ * (`mode: "pull-request"`). It reveals after every other target
382
+ * (./publish-index.ts).
383
+ */
384
+ export const IndexPublishSchema = z
385
+ .object({
386
+ type: z.literal("index"),
387
+ /** Defaults for a known index: its repository, mode, manifest path and pull request title. */
388
+ preset: z.enum(INDEX_PRESETS).optional(),
389
+ /** The index repository, `owner/name`. Default: the preset's, where it has one (krew, winget, homebrew-core, zed). */
390
+ repo: z.string().regex(/^[^/\s]+\/[^/\s]+$/, "owner/name").optional(),
391
+ /** The package's name in the index: the krew plugin, the winget `PackageIdentifier`, the Scoop app, the formula, the Zed extension id, the Artifact Hub package. */
392
+ name: z.string().regex(/^[A-Za-z0-9][A-Za-z0-9._+-]*$/, "a name of letters, digits, '.', '_', '+' and '-'"),
393
+ /** `commit` pushes to `branch` of `repo`; `pull-request` opens a pull request on `repo` from a branch of `fork`. Default: the preset's, else `pull-request`. */
394
+ mode: z.enum(["commit", "pull-request"]).optional(),
395
+ /** One manifest template, relative to the member, written to `path`. */
396
+ template: z.string().min(1).optional(),
397
+ /** Where `template` goes in the index. Default: the preset's path. `{name}`, `{version}`, `{label}`, `{letter}` (the name's first letter, lowercased) and `{namePath}` (the name with each `.` a `/`) are filled in. */
398
+ path: z.string().min(1).optional(),
399
+ /** More manifests: each path in the index, with the same placeholders as `path`, and its template relative to the member. */
400
+ files: z.record(z.string().min(1), z.string().min(1)).optional(),
401
+ /** The release's files the manifests download: `artifact:<name>` for an entry of `release.artifacts`, or a path the release records. Each SHA-256 is the one the release records. */
402
+ assets: z.array(z.string().min(1)).optional(),
403
+ /** Where each asset is downloaded from: `{tag}`, `{label}`, `{version}` and `{name}` (its file name) are filled in. Needed with `assets`. */
404
+ url: z.string().min(1).optional(),
405
+ /** The branch of `repo` the index is read from, and the base of a pull request. Default: the repository's default branch. */
406
+ branch: z.string().min(1).optional(),
407
+ /** `pull-request` only: the repository the branch is pushed to, `owner/name`. Default: the token's user's fork of `repo`, made when it has none. `repo` itself opens the pull request from a branch of `repo`. */
408
+ fork: z.string().regex(/^[^/\s]+\/[^/\s]+$/, "owner/name").optional(),
409
+ /** The commit message and pull request title: `{name}`, `{version}`, `{label}` and `{tag}` are filled in. Default: the preset's. */
410
+ title: z.string().min(1).optional(),
411
+ /** The pull request's body, with the same placeholders. */
412
+ body: z.string().min(1).optional(),
413
+ /** The GitHub API root. Default `$GITHUB_API_URL`, else `https://api.github.com`. */
414
+ api: z.string().url().optional(),
415
+ /** The variable holding the token. Default `HOMEBREW_TAP_TOKEN` under the homebrew-tap preset, else `INDEX_TOKEN`. */
416
+ tokenEnv: envName.optional(),
417
+ /** `commit` only: the variable holding an SSH private key that may push to `repo`, such as a deploy key. Set, the target pushes with git over SSH and reads no token. */
418
+ sshKeyEnv: envName.optional(),
419
+ /** What a refusal from the index does: `warn` (the default) prints a warning and leaves the target unrecorded, so a run of the same publish tries again; `fail` fails the publish. */
420
+ onRefusal: z.enum(["fail", "warn"]).optional(),
421
+ })
422
+ .strict()
423
+ .refine((d) => d.sshKeyEnv === undefined || d.tokenEnv === undefined, { message: "keep one of tokenEnv and sshKeyEnv", path: ["sshKeyEnv"] })
424
+ .refine((d) => d.path === undefined || d.template !== undefined, { message: "path is where template goes; name a template", path: ["path"] })
425
+ .refine((d) => (d.assets?.length ?? 0) === 0 || d.url !== undefined, { message: "assets need url, the pattern each is downloaded from", path: ["url"] });
426
+ export const PublishDeclarationSchema = z.discriminatedUnion("type", [
427
+ NpmPublishSchema,
428
+ OciPublishSchema,
429
+ ForgePublishSchema,
430
+ HomebrewPublishSchema,
431
+ MarketplacePublishSchema,
432
+ TauriUpdaterPublishSchema,
433
+ PypiPublishSchema,
434
+ CargoPublishSchema,
435
+ McpRegistryPublishSchema,
436
+ IndexPublishSchema,
437
+ ]);
@@ -4,7 +4,8 @@
4
4
  * each forge's REST API and an injectable `fetch`.
5
5
  *
6
6
  * The tag is the declaration's `tag`, else the one the cut made
7
- * (`release/<label>`, or `release/<member>/<label>`), so a release with no
7
+ * (`release.tag`, #5150; `release/<label>` or `release/<member>/<label>`
8
+ * when unset), so a release with no
8
9
  * label and no declared tag is refused.
9
10
  *
10
11
  * A publish is two steps (#4048), so a consumer never sees a release with
@@ -40,15 +41,32 @@
40
41
  * (./publish-attachments.ts). They go on the draft with the assets, so
41
42
  * nothing is visible before they are attached.
42
43
  *
44
+ * The release's notes (#4658, #5153) are a section of a file in the member,
45
+ * notes generated for the release, or both, between `before` and `after`.
46
+ * Generated notes are the forge's own (GitHub's `generate-notes`, GitLab's
47
+ * changelog API) or chant's, from the conventional commits in the member
48
+ * since its previous release. The stage decides them: the draft is made
49
+ * with them, or edited to them when it already exists, and they are kept in
50
+ * the publish record, so the reveal publishes what the draft showed, and a
51
+ * resumed reveal does not ask the forge again.
52
+ *
53
+ * When the publish signs (#5164, ./publish-signing.ts), the stage also
54
+ * uploads `<file>.sigstore.json` beside each file and
55
+ * `release.slsa.sigstore.json`, SLSA provenance over the declared assets. A
56
+ * bundle already on the draft is kept, since signing again gives other bytes.
57
+ *
43
58
  * The token is read from `tokenEnv`, else `GITHUB_TOKEN`, `GITLAB_TOKEN`
44
59
  * then `CI_JOB_TOKEN`, or `FORGEJO_TOKEN`, and is masked in all output.
45
60
  */
46
61
  import type { ForgePublishDeclaration } from "./publish-declaration.js";
47
- import { type PublishDeps, type PublishTarget } from "./release-publish.js";
62
+ import { type ChangelogCommit } from "./release-changelog.js";
63
+ import { type PublishContext, type PublishDeps, type PublishTarget } from "./release-publish.js";
48
64
  /** The first chant that reads `latest` on a forge target and sends it as GitHub's `make_latest` (#4676). */
49
65
  export declare const PUBLISH_FORGE_LATEST_FLOOR = "0.124.63";
50
66
  /** The first chant whose forge target reads `notes` and may have no assets (#4658). Products feature-detect on it. */
51
67
  export declare const PUBLISH_FORGE_NOTES_FLOOR = "0.124.71";
68
+ /** The first chant whose forge target generates notes, `notes.generate` (#5153). Products feature-detect on it. */
69
+ export declare const PUBLISH_FORGE_GENERATED_NOTES_FLOOR = "0.124.101";
52
70
  /**
53
71
  * The section of `page` that starts at the heading `heading` names (#4658),
54
72
  * up to the next heading of the same level or higher, trimmed. A heading
@@ -63,6 +81,31 @@ export declare function releaseNotesSection(page: string, heading: string, linkB
63
81
  export declare function forgeTokenEnv(decl: Pick<ForgePublishDeclaration, "forge" | "tokenEnv">): string[];
64
82
  /** The API root a forge is reached at. */
65
83
  export declare function forgeApi(decl: Pick<ForgePublishDeclaration, "forge" | "api">, env: NodeJS.ProcessEnv): string | null;
84
+ /**
85
+ * The member's previous release (#5153): the release of it cut from the
86
+ * nearest ancestor of this release's commit, as the cut finds it, with its
87
+ * label. Null for the member's first release. Refuses when the history the
88
+ * notes are generated from is not in the checkout.
89
+ */
90
+ export declare function previousMemberRelease(ctx: Pick<PublishContext, "cwd" | "release">, forge: string): Promise<{
91
+ commit: string;
92
+ label: string | null;
93
+ } | null>;
94
+ /**
95
+ * The tag the member's previous release has (#5150): its label through
96
+ * `release.tag`. A context that does not carry the template reads it off
97
+ * this release's tag, as the label's suffix, or not at all.
98
+ */
99
+ export declare function previousReleaseTag(ctx: Pick<PublishContext, "label" | "releaseTag" | "releaseTagOf">, label: string): string | null;
100
+ /** The commits in the member's directory after `from` (all of them when null) up to the release's commit, newest first, merges left out. */
101
+ export declare function memberCommits(ctx: Pick<PublishContext, "cwd" | "release">, from: string | null, forge: string): ChangelogCommit[];
102
+ /**
103
+ * Notes from the intent files the release's cuts consumed (#5159), read at
104
+ * the release's commit: their summaries, the highest level first. Empty
105
+ * when the cuts consumed none. A file the commit does not hold, or that
106
+ * can't be read, is left out.
107
+ */
108
+ export declare function consumedIntentNotes(ctx: Pick<PublishContext, "cwd" | "release">): Promise<string>;
66
109
  /** A GitLab generic package version: the label with what GitLab refuses replaced. */
67
110
  export declare function gitlabPackageVersion(label: string): string;
68
111
  export declare function forgeTarget(decl: ForgePublishDeclaration, deps: PublishDeps): PublishTarget;