@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.
- package/dist/action-pins.d.ts +2 -0
- package/dist/action-pins.js +3 -0
- package/dist/ci-detect.d.ts +13 -0
- package/dist/ci-detect.js +12 -0
- package/dist/ci-system.d.ts +66 -0
- package/dist/ci-system.js +61 -0
- package/dist/cli/handlers/build.js +27 -0
- package/dist/cli/handlers/release-doctor.d.ts +12 -0
- package/dist/cli/handlers/release-doctor.js +118 -0
- package/dist/cli/handlers/release-init.d.ts +10 -0
- package/dist/cli/handlers/release-init.js +342 -0
- package/dist/cli/handlers/release.d.ts +42 -1
- package/dist/cli/handlers/release.js +656 -31
- package/dist/cli/handlers/run-generate.js +11 -0
- package/dist/cli/main.d.ts +2 -0
- package/dist/cli/main.js +44 -101
- package/dist/cli/parse-args.js +48 -0
- package/dist/cli/registry.d.ts +16 -0
- package/dist/cli/release-commands/artifacts.d.ts +3 -0
- package/dist/cli/release-commands/artifacts.js +14 -0
- package/dist/cli/release-commands/candidates.d.ts +3 -0
- package/dist/cli/release-commands/candidates.js +16 -0
- package/dist/cli/release-commands/changed.d.ts +3 -0
- package/dist/cli/release-commands/changed.js +14 -0
- package/dist/cli/release-commands/compose.d.ts +3 -0
- package/dist/cli/release-commands/compose.js +16 -0
- package/dist/cli/release-commands/cut.d.ts +3 -0
- package/dist/cli/release-commands/cut.js +49 -0
- package/dist/cli/release-commands/doctor.d.ts +3 -0
- package/dist/cli/release-commands/doctor.js +14 -0
- package/dist/cli/release-commands/export.d.ts +3 -0
- package/dist/cli/release-commands/export.js +12 -0
- package/dist/cli/release-commands/images.d.ts +3 -0
- package/dist/cli/release-commands/images.js +13 -0
- package/dist/cli/release-commands/index.d.ts +8 -0
- package/dist/cli/release-commands/index.js +52 -0
- package/dist/cli/release-commands/init.d.ts +3 -0
- package/dist/cli/release-commands/init.js +16 -0
- package/dist/cli/release-commands/list.d.ts +3 -0
- package/dist/cli/release-commands/list.js +10 -0
- package/dist/cli/release-commands/next.d.ts +3 -0
- package/dist/cli/release-commands/next.js +13 -0
- package/dist/cli/release-commands/publish.d.ts +3 -0
- package/dist/cli/release-commands/publish.js +22 -0
- package/dist/cli/release-commands/stamp.d.ts +3 -0
- package/dist/cli/release-commands/stamp.js +15 -0
- package/dist/cli/release-commands/status.d.ts +3 -0
- package/dist/cli/release-commands/status.js +17 -0
- package/dist/cli/release-commands/tag.d.ts +3 -0
- package/dist/cli/release-commands/tag.js +12 -0
- package/dist/cli/release-commands/types.d.ts +20 -0
- package/dist/cli/release-commands/types.js +1 -0
- package/dist/cli/release-commands/verify.d.ts +3 -0
- package/dist/cli/release-commands/verify.js +15 -0
- package/dist/cli/release-commands/workflow.d.ts +3 -0
- package/dist/cli/release-commands/workflow.js +13 -0
- package/dist/components/cli-support.d.ts +1 -1
- package/dist/components/cli-support.js +1 -1
- package/dist/config-environments.d.ts +8 -1
- package/dist/config-environments.js +2 -0
- package/dist/config.d.ts +294 -9
- package/dist/config.js +100 -5
- package/dist/floor-table.data.js +15 -1
- package/dist/forge-remote.d.ts +13 -0
- package/dist/forge-remote.js +15 -0
- package/dist/lexicon.d.ts +41 -2
- package/dist/lifecycle/__fixtures__/publish-fakes.d.ts +62 -0
- package/dist/lifecycle/__fixtures__/publish-fakes.js +270 -3
- package/dist/lifecycle/publish-attachments.d.ts +2 -1
- package/dist/lifecycle/publish-attachments.js +19 -2
- package/dist/lifecycle/publish-cargo.d.ts +99 -0
- package/dist/lifecycle/publish-cargo.js +412 -0
- package/dist/lifecycle/publish-credentials.d.ts +1 -1
- package/dist/lifecycle/publish-credentials.js +8 -0
- package/dist/lifecycle/publish-declaration.d.ts +199 -4
- package/dist/lifecycle/publish-declaration.js +200 -9
- package/dist/lifecycle/publish-forge.d.ts +45 -2
- package/dist/lifecycle/publish-forge.js +434 -34
- package/dist/lifecycle/publish-git-ssh.d.ts +15 -0
- package/dist/lifecycle/publish-git-ssh.js +30 -4
- package/dist/lifecycle/publish-github.d.ts +40 -2
- package/dist/lifecycle/publish-github.js +100 -3
- package/dist/lifecycle/publish-homebrew.d.ts +7 -9
- package/dist/lifecycle/publish-homebrew.js +34 -197
- package/dist/lifecycle/publish-index.d.ts +141 -0
- package/dist/lifecycle/publish-index.js +719 -0
- package/dist/lifecycle/publish-marketplace.js +77 -0
- package/dist/lifecycle/publish-mcp-registry.d.ts +66 -0
- package/dist/lifecycle/publish-mcp-registry.js +306 -0
- package/dist/lifecycle/publish-npm.js +165 -2
- package/dist/lifecycle/publish-oci.d.ts +34 -1
- package/dist/lifecycle/publish-oci.js +246 -7
- package/dist/lifecycle/publish-pypi.d.ts +136 -0
- package/dist/lifecycle/publish-pypi.js +657 -0
- package/dist/lifecycle/publish-record.d.ts +6 -3
- package/dist/lifecycle/publish-record.js +6 -3
- package/dist/lifecycle/publish-signing.d.ts +147 -0
- package/dist/lifecycle/publish-signing.js +257 -0
- package/dist/lifecycle/publish-targets.d.ts +27 -1
- package/dist/lifecycle/publish-targets.js +80 -0
- package/dist/lifecycle/publish-tauri.js +43 -0
- package/dist/lifecycle/publish-train-names.d.ts +54 -0
- package/dist/lifecycle/publish-train-names.js +118 -0
- package/dist/lifecycle/publish-verify.d.ts +121 -0
- package/dist/lifecycle/publish-verify.js +130 -0
- package/dist/lifecycle/query.js +8 -0
- package/dist/lifecycle/release-artifacts.d.ts +212 -0
- package/dist/lifecycle/release-artifacts.js +571 -0
- package/dist/lifecycle/release-changelog.d.ts +13 -1
- package/dist/lifecycle/release-changelog.js +35 -2
- package/dist/lifecycle/release-cut.d.ts +58 -3
- package/dist/lifecycle/release-cut.js +132 -34
- package/dist/lifecycle/release-doctor.d.ts +113 -0
- package/dist/lifecycle/release-doctor.js +996 -0
- package/dist/lifecycle/release-green.d.ts +86 -0
- package/dist/lifecycle/release-green.js +286 -0
- package/dist/lifecycle/release-init.d.ts +255 -0
- package/dist/lifecycle/release-init.js +859 -0
- package/dist/lifecycle/release-intents.d.ts +73 -0
- package/dist/lifecycle/release-intents.js +128 -0
- package/dist/lifecycle/release-next.d.ts +111 -0
- package/dist/lifecycle/release-next.js +252 -0
- package/dist/lifecycle/release-prerelease.d.ts +19 -0
- package/dist/lifecycle/release-prerelease.js +30 -0
- package/dist/lifecycle/release-publish.d.ts +256 -10
- package/dist/lifecycle/release-publish.js +246 -34
- package/dist/lifecycle/release-status-change.d.ts +226 -0
- package/dist/lifecycle/release-status-change.js +478 -0
- package/dist/lifecycle/release-status.d.ts +11 -0
- package/dist/lifecycle/release-status.js +1 -1
- package/dist/lifecycle/release-store.d.ts +73 -2
- package/dist/lifecycle/release-store.js +32 -1
- package/dist/lifecycle/release-tag.d.ts +142 -0
- package/dist/lifecycle/release-tag.js +323 -0
- package/dist/lifecycle/release-verify.d.ts +73 -1
- package/dist/lifecycle/release-verify.js +117 -2
- package/dist/lifecycle/release-version-formats.d.ts +73 -0
- package/dist/lifecycle/release-version-formats.js +570 -0
- package/dist/lifecycle/release-version.d.ts +58 -10
- package/dist/lifecycle/release-version.js +164 -36
- package/dist/lifecycle/release-workstation.d.ts +3 -2
- package/dist/lifecycle/release-workstation.js +3 -2
- package/dist/op/generate-pipeline.js +1 -1
- package/dist/pr-forge-base.js +4 -2
- package/dist/pr-forge.d.ts +20 -2
- package/dist/pr-forge.js +46 -10
- package/dist/release-floors.d.ts +8 -1
- package/dist/release-floors.js +9 -2
- package/dist/tool-pins.d.ts +38 -0
- package/dist/tool-pins.js +54 -0
- package/dist/wave-runtime.mjs +337 -334
- package/dist/workspace/ci-forge.d.ts +17 -0
- package/dist/workspace/ci-forge.js +17 -0
- package/dist/workspace/ci-init.js +1 -1
- package/dist/workspace/composites.schema.json +1 -0
- package/dist/workspace/declaration.d.ts +8 -0
- package/dist/workspace/declaration.js +12 -0
- package/dist/workspace/declaration.schema.json +8 -0
- package/dist/workspace/environments.d.ts +2 -0
- package/dist/workspace/environments.js +1 -1
- package/dist/workspace/identity-gate-rule.d.ts +61 -5
- package/dist/workspace/identity-gate-rule.js +81 -12
- package/dist/workspace/member-pipeline.d.ts +2 -1
- package/dist/workspace/member-pipeline.js +5 -2
- package/dist/workspace/reason-codes.d.ts +2 -0
- package/dist/workspace/reason-codes.js +3 -1
- package/dist/workspace/release-changed.d.ts +75 -4
- package/dist/workspace/release-changed.js +205 -34
- package/dist/workspace/release-changed.schema.json +20 -2
- package/dist/workspace/release-steps/artifacts.d.ts +7 -0
- package/dist/workspace/release-steps/artifacts.js +45 -0
- package/dist/workspace/release-steps/builds.d.ts +12 -0
- package/dist/workspace/release-steps/builds.js +38 -0
- package/dist/workspace/release-steps/doctor.d.ts +8 -0
- package/dist/workspace/release-steps/doctor.js +14 -0
- package/dist/workspace/release-steps/goreleaser.d.ts +16 -0
- package/dist/workspace/release-steps/goreleaser.js +36 -0
- package/dist/workspace/release-steps/green.d.ts +3 -0
- package/dist/workspace/release-steps/green.js +6 -0
- package/dist/workspace/release-steps/images.d.ts +22 -0
- package/dist/workspace/release-steps/images.js +59 -0
- package/dist/workspace/release-steps/index.d.ts +9 -0
- package/dist/workspace/release-steps/index.js +46 -0
- package/dist/workspace/release-steps/pypi.d.ts +15 -0
- package/dist/workspace/release-steps/pypi.js +21 -0
- package/dist/workspace/release-steps/qemu.d.ts +21 -0
- package/dist/workspace/release-steps/qemu.js +35 -0
- package/dist/workspace/release-steps/signing.d.ts +18 -0
- package/dist/workspace/release-steps/signing.js +30 -0
- package/dist/workspace/release-steps/stamp.d.ts +3 -0
- package/dist/workspace/release-steps/stamp.js +4 -0
- package/dist/workspace/release-steps/targets.d.ts +31 -0
- package/dist/workspace/release-steps/targets.js +40 -0
- package/dist/workspace/release-steps/types.d.ts +104 -0
- package/dist/workspace/release-steps/types.js +2 -0
- package/dist/workspace/release-steps/verify.d.ts +3 -0
- package/dist/workspace/release-steps/verify.js +4 -0
- package/dist/workspace/release-toolchains.d.ts +59 -0
- package/dist/workspace/release-toolchains.js +133 -0
- package/dist/workspace/release-train-workflow.d.ts +29 -0
- package/dist/workspace/release-train-workflow.js +85 -0
- package/dist/workspace/release-train.d.ts +3 -1
- package/dist/workspace/release-train.js +20 -3
- package/dist/workspace/release-workflow.d.ts +160 -61
- package/dist/workspace/release-workflow.js +539 -193
- package/dist/workspace/releases.schema.json +70 -1
- package/dist/workspace/search-contract.d.ts +1 -1
- package/dist/workspace/security.js +9 -2
- package/dist/workspace/train-cut.d.ts +182 -0
- package/dist/workspace/train-cut.js +482 -0
- package/dist/workspace/train-prepare.d.ts +61 -0
- package/dist/workspace/train-prepare.js +267 -0
- package/dist/workspace/train-publish.d.ts +177 -0
- package/dist/workspace/train-publish.js +575 -0
- package/dist/workspace/train-range-labels.d.ts +33 -0
- package/dist/workspace/train-range-labels.js +109 -0
- package/dist/workspace/trust/seal.d.ts +13 -3
- package/dist/workspace/trust/seal.js +14 -4
- package/dist/workspace/work-cli.d.ts +3 -2
- package/dist/workspace/work-cli.js +3 -2
- package/dist/workspace/workspace-ledger.d.ts +14 -1
- package/dist/workspace/workspace-ledger.js +33 -7
- 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)
|
|
110
|
-
*
|
|
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
|
-
/**
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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;
|