@wtf/release-docs 9.0.2 → 10.0.0

package/api/@wtf/release-cargo/auth/interfaces/HttpResponse.md

@@ -6,7 +6,7 @@
 
 # Interface: HttpResponse
 
-Defined in: [packages/release-cargo/src/auth.ts:40](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L40)
+Defined in: [packages/release-cargo/src/auth.ts:40](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L40)
 
 What a registry answers: the part of a `Response` this package reads.
 
@@ -16,7 +16,7 @@ What a registry answers: the part of a `Response` this package reads.
 
 > `readonly` **ok**: `boolean`
 
-Defined in: [packages/release-cargo/src/auth.ts:42](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L42)
+Defined in: [packages/release-cargo/src/auth.ts:42](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L42)
 
 Whether the status is of a success, 2xx.
 
@@ -26,7 +26,7 @@ Whether the status is of a success, 2xx.
 
 > `readonly` **status**: `number`
 
-Defined in: [packages/release-cargo/src/auth.ts:44](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L44)
+Defined in: [packages/release-cargo/src/auth.ts:44](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L44)
 
 The status of the answer.
 
@@ -36,7 +36,7 @@ The status of the answer.
 
 > **json**(): `Promise`\<`unknown`\>
 
-Defined in: [packages/release-cargo/src/auth.ts:50](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L50)
+Defined in: [packages/release-cargo/src/auth.ts:50](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L50)
 
 The body, read as JSON.
 
@@ -52,7 +52,7 @@ The parsed body.
 
 > **text**(): `Promise`\<`string`\>
 
-Defined in: [packages/release-cargo/src/auth.ts:56](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L56)
+Defined in: [packages/release-cargo/src/auth.ts:56](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L56)
 
 The body, read as text.
 

package/api/@wtf/release-cargo/auth/interfaces/TrustedPublishing.md

@@ -6,7 +6,7 @@
 
 # Interface: TrustedPublishing
 
-Defined in: [packages/release-cargo/src/auth.ts:72](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L72)
+Defined in: [packages/release-cargo/src/auth.ts:72](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L72)
 
 What a release does of trusted publishing: it exchanges a token when it needs one, and revokes it.
 
@@ -16,7 +16,7 @@ What a release does of trusted publishing: it exchanges a token when it needs on
 
 > `readonly` **hidden**: readonly `string`[]
 
-Defined in: [packages/release-cargo/src/auth.ts:76](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L76)
+Defined in: [packages/release-cargo/src/auth.ts:76](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L76)
 
 The variables of the environment `cargo` is not given: the ID token.
 
@@ -26,7 +26,7 @@ The variables of the environment `cargo` is not given: the ID token.
 
 > `readonly` **tokenVariable**: `string`
 
-Defined in: [packages/release-cargo/src/auth.ts:74](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L74)
+Defined in: [packages/release-cargo/src/auth.ts:74](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L74)
 
 The variable the publish token is given to `cargo` in.
 
@@ -36,7 +36,7 @@ The variable the publish token is given to `cargo` in.
 
 > **exchange**(): `Promise`\<`string`\>
 
-Defined in: [packages/release-cargo/src/auth.ts:83](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L83)
+Defined in: [packages/release-cargo/src/auth.ts:83](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L83)
 
 Exchanges the ID token for a publish token.
 
@@ -56,7 +56,7 @@ The publish token, a secret.
 
 > **revoke**(`token`): `Promise`\<`void`\>
 
-Defined in: [packages/release-cargo/src/auth.ts:90](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L90)
+Defined in: [packages/release-cargo/src/auth.ts:90](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L90)
 
 Revokes a publish token, so it is of no use once the release is done.
 

package/api/@wtf/release-cargo/auth/interfaces/TrustedPublishingOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: TrustedPublishingOptions
 
-Defined in: [packages/release-cargo/src/auth.ts:119](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L119)
+Defined in: [packages/release-cargo/src/auth.ts:119](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L119)
 
 How [trustedPublishing](../functions/trustedPublishing.md) is made.
 
@@ -16,7 +16,7 @@ How [trustedPublishing](../functions/trustedPublishing.md) is made.
 
 > `readonly` `optional` **api?**: `string`
 
-Defined in: [packages/release-cargo/src/auth.ts:127](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L127)
+Defined in: [packages/release-cargo/src/auth.ts:127](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L127)
 
 The base URL of the registry's API: [CRATES\_IO\_API](../variables/CRATES_IO_API.md) by default.
 
@@ -26,7 +26,7 @@ The base URL of the registry's API: [CRATES\_IO\_API](../variables/CRATES_IO_API
 
 > `readonly` **fetch**: [`HttpFetch`](../type-aliases/HttpFetch.md)
 
-Defined in: [packages/release-cargo/src/auth.ts:121](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L121)
+Defined in: [packages/release-cargo/src/auth.ts:121](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L121)
 
 The `fetch` the requests are made by.
 
@@ -36,7 +36,7 @@ The `fetch` the requests are made by.
 
 > `readonly` **idToken**: `string`
 
-Defined in: [packages/release-cargo/src/auth.ts:123](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L123)
+Defined in: [packages/release-cargo/src/auth.ts:123](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L123)
 
 The ID token of the job, a secret.
 
@@ -46,7 +46,7 @@ The ID token of the job, a secret.
 
 > `readonly` `optional` **idTokenVariable?**: `string`
 
-Defined in: [packages/release-cargo/src/auth.ts:129](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L129)
+Defined in: [packages/release-cargo/src/auth.ts:129](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L129)
 
 The variable the ID token was read from, which `cargo` is not given.
 
@@ -56,6 +56,6 @@ The variable the ID token was read from, which `cargo` is not given.
 
 > `readonly` **tokenVariable**: `string`
 
-Defined in: [packages/release-cargo/src/auth.ts:125](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L125)
+Defined in: [packages/release-cargo/src/auth.ts:125](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L125)
 
 The variable `cargo` is given the publish token in: [tokenVariableOf](../functions/tokenVariableOf.md) of the registry.

package/api/@wtf/release-cargo/auth/type-aliases/HttpFetch.md

@@ -8,7 +8,7 @@
 
 > **HttpFetch** = (`url`, `init`) => `Promise`\<[`HttpResponse`](../interfaces/HttpResponse.md)\>
 
-Defined in: [packages/release-cargo/src/auth.ts:66](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L66)
+Defined in: [packages/release-cargo/src/auth.ts:66](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L66)
 
 The `fetch` a caller gives, of the part of it this package uses.
 

package/api/@wtf/release-cargo/auth/variables/CRATES_IO_API.md

@@ -8,6 +8,6 @@
 
 > `const` **CRATES\_IO\_API**: `"https://crates.io"` = `'https://crates.io'`
 
-Defined in: [packages/release-cargo/src/auth.ts:31](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L31)
+Defined in: [packages/release-cargo/src/auth.ts:31](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L31)
 
 The registry whose API trusted publishing is asked of by default.

package/api/@wtf/release-cargo/auth/variables/ID_TOKEN_VARIABLE.md

@@ -8,6 +8,6 @@
 
 > `const` **ID\_TOKEN\_VARIABLE**: `"CRATES_IO_ID_TOKEN"` = `'CRATES_IO_ID_TOKEN'`
 
-Defined in: [packages/release-cargo/src/auth.ts:34](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L34)
+Defined in: [packages/release-cargo/src/auth.ts:34](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L34)
 
 The variable of the environment that holds the ID token of the job, by default.

package/api/@wtf/release-cargo/auth/variables/USER_AGENT.md

@@ -6,8 +6,8 @@
 
 # Variable: USER\_AGENT
 
-> `const` **USER\_AGENT**: `"@wtf/semantic-release-cargo"` = `'@wtf/semantic-release-cargo'`
+> `const` **USER\_AGENT**: `"@wtf/release-cargo"` = `'@wtf/release-cargo'`
 
-Defined in: [packages/release-cargo/src/auth.ts:37](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/auth.ts#L37)
+Defined in: [packages/release-cargo/src/auth.ts:37](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/auth.ts#L37)
 
-The `User-Agent` of the requests: crates.io asks every client to name itself.
+The `User-Agent` of the requests to a registry: crates.io asks every client to name itself.

package/api/@wtf/release-cargo/crates/README.md

@@ -6,19 +6,19 @@
 
 # @wtf/release-cargo/crates
 
-The crates of a Cargo workspace: [readWorkspace](functions/readWorkspace.md) reads them by `cargo metadata`, run through
-the system, [selectCrates](functions/selectCrates.md) takes those a release of a train publishes, and [publishOrder](functions/publishOrder.md) puts
-them in the order of their dependencies, each after the crates it depends on, as a registry needs
-them published.
+The crates of a Cargo workspace: [readWorkspace](functions/readWorkspace.md) reads them by `cargo metadata`, run by the
+platform, [selectCrates](functions/selectCrates.md) takes those of the plan of a release that it publishes, and
+[publishOrder](functions/publishOrder.md) puts crates in the order of their dependencies, each after the crates it
+depends on, as a registry needs them published, or finds the cycle of crates no order publishes.
 
 ```ts
-import { publishOrder, readWorkspace, selectCrates } from '@wtf/release-cargo/crates'
-import type { System } from '@wtf/release-system'
+import type { RepoPlatform } from '@wtf/release'
+import { readWorkspace, selectCrates } from '@wtf/release-cargo/crates'
 
-// The names of the crates a release of the train of `train` publishes, in order.
-export async function names(system: System, train: ReadonlySet<string>): Promise<string[]> {
-  const { crates } = await readWorkspace(system, system.cwd)
-  return publishOrder(selectCrates(crates, { train })).map(({ name }) => name)
+// The names of the crates a release of the crates `own`, in that order, publishes but `docs`.
+export async function names(platform: RepoPlatform, own: readonly string[]): Promise<string[]> {
+  const { crates } = await readWorkspace(platform)
+  return selectCrates(crates, { own, exclude: ['docs'] }).map(({ name }) => name)
 }
 ```
 
@@ -32,3 +32,4 @@ export async function names(system: System, train: ReadonlySet<string>): Promise
 - [publishOrder](functions/publishOrder.md)
 - [readWorkspace](functions/readWorkspace.md)
 - [selectCrates](functions/selectCrates.md)
+- [selects](functions/selects.md)

package/api/@wtf/release-cargo/crates/functions/publishOrder.md

@@ -8,7 +8,7 @@
 
 > **publishOrder**(`crates`): [`Crate`](../../interfaces/Crate.md)[]
 
-Defined in: [packages/release-cargo/src/crates.ts:246](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/crates.ts#L246)
+Defined in: [packages/release-cargo/src/crates.ts:273](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/crates.ts#L273)
 
 The crates in the order to publish them in: each after the crates of the list that it depends on
 by a normal or a build dependency, those of no order between them by name. A dev-dependency is no

package/api/@wtf/release-cargo/crates/functions/publishable.md

@@ -8,7 +8,7 @@
 
 > **publishable**(`crate`, `registry?`): `boolean`
 
-Defined in: [packages/release-cargo/src/crates.ts:150](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/crates.ts#L150)
+Defined in: [packages/release-cargo/src/crates.ts:155](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/crates.ts#L155)
 
 Whether `crate` may be published to `registry`: not of `publish = false` (an empty list), and of
 a list, only where it names the registry; `crates-io` where none is named.

package/api/@wtf/release-cargo/crates/functions/readWorkspace.md

@@ -6,9 +6,9 @@
 
 # Function: readWorkspace()
 
-> **readWorkspace**(`system`, `cwd`): `Promise`\<[`Workspace`](../../interfaces/Workspace.md)\>
+> **readWorkspace**(`platform`, `cwd?`): `Promise`\<[`Workspace`](../../interfaces/Workspace.md)\>
 
-Defined in: [packages/release-cargo/src/crates.ts:93](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/crates.ts#L93)
+Defined in: [packages/release-cargo/src/crates.ts:96](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/crates.ts#L96)
 
 The workspace `cwd` is of, read by `cargo metadata --no-deps --format-version 1`: each crate of
 it, its version as its manifest says it now (an inherited one resolved), the registries it may be
@@ -17,17 +17,18 @@ requirement and whether it names a version too.
 
 ## Parameters
 
-### system
+### platform
 
-[`System`](../../../release-system/system/interfaces/System.md)
+[`RepoPlatform`](../../../release/type-aliases/RepoPlatform.md)
 
-The system `cargo` runs by.
+The platform `cargo` runs by, of the folder of the repo as its working folder.
 
-### cwd
+### cwd?
 
-`string`
+`string` = `'.'`
 
-The folder of the workspace, or of a crate of it.
+The folder of the workspace, or of a crate of it, from the folder of the repo or
+absolute: the folder of the repo by default.
 
 ## Returns
 

package/api/@wtf/release-cargo/crates/functions/selectCrates.md

@@ -8,16 +8,17 @@
 
 > **selectCrates**(`crates`, `selection`): [`Crate`](../../interfaces/Crate.md)[]
 
-Defined in: [packages/release-cargo/src/crates.ts:187](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/crates.ts#L187)
-
-The crates a release publishes: those of its train that may be published to the registry, of
-`include` where it names some, but those of `exclude`. A crate of an option that the workspace
-has not, or that is of another train, or one that may not be published, is a fault, as a release
-that skips it by a typo publishes less than it says. A crate of the release that depends, by a
-path, on one that is published nowhere fails too, as no registry could install it: by a normal
-or a build dependency, or by a dev-dependency of a version, which cargo keeps as it packages the
-crate, so crates.io refuses it, in the middle of a release. A dev-dependency of no version is
-none, as cargo drops it.
+Defined in: [packages/release-cargo/src/crates.ts:208](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/crates.ts#L208)
+
+The crates a release publishes: those of its plan, `own`, that may be published to the registry,
+of `include` where it names some, but those of `exclude`, in the order of `own`. A name of an
+option that the workspace has not, or of a crate that may be published and is not of the plan,
+or of `include` one that may not be published, is a fault, as a release that skips it by a typo
+publishes less than it says; `exclude` may name a crate published nowhere, which no release
+publishes. A crate of the release that depends, by a path, on one that is published nowhere fails
+too, as no registry could install it: by a normal or a build dependency, or by a dev-dependency of
+a version, which cargo keeps as it packages the crate, so crates.io refuses it, in the middle of a
+release. A dev-dependency of no version is none, as cargo drops it.
 
 ## Parameters
 
@@ -31,18 +32,17 @@ The crates of the workspace, as [readWorkspace](readWorkspace.md) gives them.
 
 [`Selection`](../interfaces/Selection.md)
 
-The crates of the train, the names to include and to exclude, and the
+The crates of the plan, the names to include and to exclude, and the
 registry.
 
 ## Returns
 
 [`Crate`](../../interfaces/Crate.md)[]
 
-The crates of the release, in the order of the workspace: none of a train of no crate
-to publish.
+The crates of the release, in the order of `own`: none of a plan of no crate to publish.
 
 ## Throws
 
-`ECRATES` of a name no crate has, or of a crate of another train or that may not be
-published that `include` names; `ECRATEPRIVATE` of a dependency on a
-crate published nowhere, but a dev-dependency of no version.
+`ECRATES` of a name no crate has, of a crate of no plan, or of a crate `include` names that
+may not be published; `ECRATEPRIVATE` of a dependency on a crate published nowhere, but a
+dev-dependency of no version.

package/api/@wtf/release-cargo/crates/functions/selects.md

@@ -0,0 +1,36 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-cargo/crates](../README.md) / selects
+
+# Function: selects()
+
+> **selects**(`crate`, `selection`): `boolean`
+
+Defined in: [packages/release-cargo/src/crates.ts:183](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/crates.ts#L183)
+
+Whether a release of `selection` publishes `crate`: a crate of its `own` that may be published to
+its registry, of `include` where it names some, but not of `exclude`. It checks nothing, as
+[selectCrates](selectCrates.md) does.
+
+## Parameters
+
+### crate
+
+[`Crate`](../../interfaces/Crate.md)
+
+The crate.
+
+### selection
+
+[`Selection`](../interfaces/Selection.md)
+
+The crates of the plan, the names to include and to exclude, and the
+registry.
+
+## Returns
+
+`boolean`
+
+Whether the release publishes it.

package/api/@wtf/release-cargo/crates/interfaces/Selection.md

@@ -6,9 +6,9 @@
 
 # Interface: Selection
 
-Defined in: [packages/release-cargo/src/crates.ts:154](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/crates.ts#L154)
+Defined in: [packages/release-cargo/src/crates.ts:159](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/crates.ts#L159)
 
-The names a selection of crates is made of.
+What selects the crates a release publishes, of the crates of its plan.
 
 ## Properties
 
@@ -16,9 +16,9 @@ The names a selection of crates is made of.
 
 > `readonly` `optional` **exclude?**: readonly `string`[]
 
-Defined in: [packages/release-cargo/src/crates.ts:163](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/crates.ts#L163)
+Defined in: [packages/release-cargo/src/crates.ts:168](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/crates.ts#L168)
 
-The crates not to publish, by name, of the ones `include` or the train gives.
+The crates not to publish, by name, of the ones `include` or `own` gives.
 
 ***
 
@@ -26,27 +26,27 @@ The crates not to publish, by name, of the ones `include` or the train gives.
 
 > `readonly` `optional` **include?**: readonly `string`[]
 
-Defined in: [packages/release-cargo/src/crates.ts:161](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/crates.ts#L161)
+Defined in: [packages/release-cargo/src/crates.ts:166](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/crates.ts#L166)
 
-The crates to publish, by name: every publishable crate of the train by default.
+The crates to publish, by name: every crate of `own` that may be published by default.
 
 ***
 
-### registry?
+### own
 
-> `readonly` `optional` **registry?**: `string`
+> `readonly` **own**: readonly `string`[]
 
-Defined in: [packages/release-cargo/src/crates.ts:165](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/crates.ts#L165)
+Defined in: [packages/release-cargo/src/crates.ts:164](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/crates.ts#L164)
 
-The registry the crates are published to: crates.io by default.
+The crates of the plan of the release, by name, in the order to publish them in, as `own` of a
+`Plan` of `@wtf/release/contract`: the release publishes of these alone.
 
 ***
 
-### train
+### registry?
 
-> `readonly` **train**: `ReadonlySet`\<`string`\>
+> `readonly` `optional` **registry?**: `string`
 
-Defined in: [packages/release-cargo/src/crates.ts:159](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/crates.ts#L159)
+Defined in: [packages/release-cargo/src/crates.ts:170](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/crates.ts#L170)
 
-The crates of the train of the release, by name, as `ownersOf` of `@wtf/release-trains/packages`
-gives them of the packages of `cargoEcosystem` of `./ecosystem`: the release publishes of these alone.
+The registry the crates are published to: crates.io by default.

package/api/@wtf/release-cargo/ecosystem/README.md

@@ -6,12 +6,15 @@
 
 # @wtf/release-cargo/ecosystem
 
-The ecosystem of cargo ([cargoEcosystem](variables/cargoEcosystem.md)), as the trains read it, and the default export of
-the package, which a config names in `ecosystems` as `'@wtf/release-cargo'`: the crates of the
-Cargo workspace at the root of the repo, by `cargo metadata` ([packagesOfWorkspace](functions/packagesOfWorkspace.md)), of the
-working tree, or of a commit exported to a temporary folder ([packagesAt](functions/packagesAt.md)); a repo of no
-Cargo.toml at its root has none. A requirement of cargo is read by the rules of semver, once it is
-written as npm writes a range ([semverRange](functions/semverRange.md)): a bare `1.2.3` is `^1.2.3`.
+The ecosystem of cargo ([cargoEcosystem](variables/cargoEcosystem.md)), the default export of the package, which a
+config names in `ecosystems` as `'@wtf/release-cargo'`: an ecosystem that releases, of the
+contract of `@wtf/release/contract`. Its read side gives the crates of the Cargo workspace at the
+root of the repo, by `cargo metadata` ([packagesOfWorkspace](functions/packagesOfWorkspace.md)), of the working tree, or of a
+commit exported to a temporary folder ([packagesAt](functions/packagesAt.md)); a repo of no Cargo.toml at its root
+has none. A requirement of cargo is read by the rules of semver, once it is written as npm writes
+a range ([semverRange](functions/semverRange.md)): a bare `1.2.3` is `^1.2.3`. Its steps, `verify`, `prepare` and
+`publish`, are those of `./release`, over the plan its driver gives it; it has no `smoke`, and no
+`move`, as a crate has no moving names.
 
 ```js
 // release.config.mjs

package/api/@wtf/release-cargo/ecosystem/functions/packagesAt.md

@@ -8,12 +8,12 @@
 
 > **packagesAt**(`ref`, `context`): `Promise`\<[`CargoPackage`](../interfaces/CargoPackage.md)[]\>
 
-Defined in: [packages/release-cargo/src/ecosystem.ts:102](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/ecosystem.ts#L102)
+Defined in: [packages/release-cargo/src/ecosystem.ts:101](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/ecosystem.ts#L101)
 
 The crates of the Cargo workspace of the repo of `context` at the commit `ref`, as
 [packagesOfWorkspace](packagesOfWorkspace.md) gives them: none where the commit has no Cargo.toml at its root.
-`cargo metadata` reads files, so the commit is exported, by `git archive`, into a folder of the
-system's temporary files, unpacked there by `tar`, read, and removed, a failure too.
+`cargo metadata` reads files, so the commit is exported, by `git archive`, into a temporary folder
+of the platform, unpacked there by `tar`, read, and removed, a failure too.
 
 ## Parameters
 
@@ -25,10 +25,10 @@ The commit, as `HEAD` or the tag of a release.
 
 ### context
 
-[`EcosystemContext`](../../../release-trains/ecosystem/interfaces/EcosystemContext.md)
+[`EcosystemContext`](../../../release/ecosystem/interfaces/EcosystemContext.md)
 
-The folder of the repo, its environment, and the system git, tar and cargo run
-by.
+The folder of the repo, and the platform git, tar and cargo run by, which makes
+the temporary folder.
 
 ## Returns
 

package/api/@wtf/release-cargo/ecosystem/functions/packagesOfTree.md

@@ -8,7 +8,7 @@
 
 > **packagesOfTree**(`context`): `Promise`\<[`CargoPackage`](../interfaces/CargoPackage.md)[]\>
 
-Defined in: [packages/release-cargo/src/ecosystem.ts:139](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/ecosystem.ts#L139)
+Defined in: [packages/release-cargo/src/ecosystem.ts:136](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/ecosystem.ts#L136)
 
 The crates of the Cargo workspace of the repo of `context`, of its working tree, as
 [packagesOfWorkspace](packagesOfWorkspace.md) gives them: none where it has no Cargo.toml at its root.
@@ -17,9 +17,9 @@ The crates of the Cargo workspace of the repo of `context`, of its working tree,
 
 ### context
 
-[`EcosystemContext`](../../../release-trains/ecosystem/interfaces/EcosystemContext.md)
+[`EcosystemContext`](../../../release/ecosystem/interfaces/EcosystemContext.md)
 
-The folder of the repo, and the system cargo runs by.
+The folder of the repo, and the platform cargo runs by.
 
 ## Returns
 

package/api/@wtf/release-cargo/ecosystem/functions/packagesOfWorkspace.md

@@ -8,9 +8,9 @@
 
 > **packagesOfWorkspace**(`workspace`): [`CargoPackage`](../interfaces/CargoPackage.md)[]
 
-Defined in: [packages/release-cargo/src/ecosystem.ts:70](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/ecosystem.ts#L70)
+Defined in: [packages/release-cargo/src/ecosystem.ts:72](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/ecosystem.ts#L72)
 
-The crates of `workspace` as the trains read them: each a package of its folder and its
+The crates of `workspace` as packages of the ecosystem: each a package of its folder and its
 Cargo.toml, from the root of the workspace; published unless `publish = false`; and each
 dependency on another crate of the workspace by a path, of its kind (a normal one `runtime`, a
 build one `build`, a dev one `dev`) and its requirement, which a release publishes as it stamps

package/api/@wtf/release-cargo/ecosystem/functions/resolveRequirement.md

@@ -8,7 +8,7 @@
 
 > **resolveRequirement**(`_requirement`, `version`): `string`
 
-Defined in: [packages/release-cargo/src/ecosystem.ts:194](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/ecosystem.ts#L194)
+Defined in: [packages/release-cargo/src/ecosystem.ts:190](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/ecosystem.ts#L190)
 
 The requirement a release publishes of a dependency on a crate of `version`, the release of its
 train: the version itself, as `stampWorkspace` of `./stamp` writes it, `version = "1.4.0"`, which

package/api/@wtf/release-cargo/ecosystem/functions/satisfiesRequirement.md

@@ -8,7 +8,7 @@
 
 > **satisfiesRequirement**(`requirement`, `version`): `boolean`
 
-Defined in: [packages/release-cargo/src/ecosystem.ts:181](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/ecosystem.ts#L181)
+Defined in: [packages/release-cargo/src/ecosystem.ts:177](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/ecosystem.ts#L177)
 
 Whether `version` is within `requirement`, by cargo's rules of requirements, as semver reads
 them once [semverRange](semverRange.md) writes them as npm does: a prerelease within its bounds too, as

package/api/@wtf/release-cargo/ecosystem/functions/semverRange.md

@@ -8,7 +8,7 @@
 
 > **semverRange**(`requirement`): `string`
 
-Defined in: [packages/release-cargo/src/ecosystem.ts:157](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-cargo/src/ecosystem.ts#L157)
+Defined in: [packages/release-cargo/src/ecosystem.ts:153](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-cargo/src/ecosystem.ts#L153)
 
 A requirement of cargo as npm writes a range, which semver reads: a comparator of no operator,
 as `1.2.3`, `1.2` or `1`, is cargo's caret, `^1.2.3`; `=`, `>`, `>=`, `<`, `<=`, `~`, `^` and