@wtf/release-docs 9.0.2 → 10.0.0

package/api/@wtf/release-go/stamp/functions/stampModules.md

@@ -6,20 +6,20 @@
 
 # Function: stampModules()
 
-> **stampModules**(`context`, `modules`, `versions`): `Promise`\<[`StampedModules`](../interfaces/StampedModules.md)\>
+> **stampModules**(`root`, `modules`, `versions`, `options?`): `Promise`\<[`StampedModules`](../interfaces/StampedModules.md)\>
 
-Defined in: [packages/release-go/src/stamp.ts:117](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/stamp.ts#L117)
+Defined in: [packages/release-go/src/stamp.ts:127](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/stamp.ts#L127)
 
 Writes `versions` into the go.mod of each of `modules`, as the module says. A file of no change
-is not written.
+is not written, and of `dryRun` none is.
 
 ## Parameters
 
-### context
+### root
 
-[`GitContext`](../../../release-system/git/interfaces/GitContext.md)
+`FileSystemDirectoryHandle`
 
-The folder of the repo and the system the files are read and written by.
+The folder of the repo, whose files are read and written.
 
 ### modules
 
@@ -31,12 +31,18 @@ Every module of the repo, as `readModules` of `./modules` gives them.
 
 `ReadonlyMap`\<`string`, `string`\>
 
-The version each module takes, by its path: of the modules of the train of the
-release, the release's, and of each other train's, its last release (`releasedVersions` of
-`@wtf/release-trains/packages`).
+The version each module takes, by its path, as `versions` of the plan of the
+release gives it: of the modules of the release, the release's, and of each other, the last
+release of its own.
+
+### options?
+
+[`StampOptions`](../interfaces/StampOptions.md) = `{}`
+
+Whether it writes nothing.
 
 ## Returns
 
 `Promise`\<[`StampedModules`](../interfaces/StampedModules.md)\>
 
-The go.mod files written, and how many values.
+The go.mod files written, or that would be, how many values, and the modules stamped.

package/api/@wtf/release-go/stamp/interfaces/StampOptions.md

@@ -0,0 +1,21 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-go/stamp](../README.md) / StampOptions
+
+# Interface: StampOptions
+
+Defined in: [packages/release-go/src/stamp.ts:110](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/stamp.ts#L110)
+
+How [stampModules](../functions/stampModules.md) stamps.
+
+## Properties
+
+### dryRun?
+
+> `readonly` `optional` **dryRun?**: `boolean`
+
+Defined in: [packages/release-go/src/stamp.ts:112](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/stamp.ts#L112)
+
+Whether it writes nothing, and only says what it would write: `false` by default.

package/api/@wtf/release-go/stamp/interfaces/Stamped.md

@@ -6,7 +6,7 @@
 
 # Interface: Stamped
 
-Defined in: [packages/release-go/src/stamp.ts:39](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/stamp.ts#L39)
+Defined in: [packages/release-go/src/stamp.ts:40](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/stamp.ts#L40)
 
 A go.mod stamped, and how many values it wrote.
 
@@ -16,7 +16,7 @@ A go.mod stamped, and how many values it wrote.
 
 > `readonly` **changes**: `number`
 
-Defined in: [packages/release-go/src/stamp.ts:43](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/stamp.ts#L43)
+Defined in: [packages/release-go/src/stamp.ts:44](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/stamp.ts#L44)
 
 The values that were another, and are of the versions now.
 
@@ -26,6 +26,6 @@ The values that were another, and are of the versions now.
 
 > `readonly` **text**: `string`
 
-Defined in: [packages/release-go/src/stamp.ts:41](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/stamp.ts#L41)
+Defined in: [packages/release-go/src/stamp.ts:42](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/stamp.ts#L42)
 
 The go.mod, the versions written.

package/api/@wtf/release-go/stamp/interfaces/StampedModules.md

@@ -6,7 +6,7 @@
 
 # Interface: StampedModules
 
-Defined in: [packages/release-go/src/stamp.ts:99](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/stamp.ts#L99)
+Defined in: [packages/release-go/src/stamp.ts:100](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/stamp.ts#L100)
 
 The result of stamping the modules of a repo: the go.mod files written, and the values.
 
@@ -16,7 +16,7 @@ The result of stamping the modules of a repo: the go.mod files written, and the
 
 > `readonly` **changes**: `number`
 
-Defined in: [packages/release-go/src/stamp.ts:103](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/stamp.ts#L103)
+Defined in: [packages/release-go/src/stamp.ts:104](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/stamp.ts#L104)
 
 The values written.
 
@@ -26,6 +26,16 @@ The values written.
 
 > `readonly` **files**: readonly `string`[]
 
-Defined in: [packages/release-go/src/stamp.ts:101](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/stamp.ts#L101)
+Defined in: [packages/release-go/src/stamp.ts:102](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/stamp.ts#L102)
 
 The go.mod files whose text changed, from the root of the repo.
+
+***
+
+### modules
+
+> `readonly` **modules**: readonly [`GoModule`](../../interfaces/GoModule.md)[]
+
+Defined in: [packages/release-go/src/stamp.ts:106](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/stamp.ts#L106)
+
+Every module of `modules`, as its go.mod reads stamped, written or not.

package/api/@wtf/release-go/tags/README.md

@@ -20,23 +20,20 @@ once and listed.
 ```ts
 import { tagOfModule } from '@wtf/release-go/tags'
 
-const module = { path: 'example.com/repo/lib/v2', dir: 'lib/v2', manifest: 'lib/v2/go.mod' }
-console.log(tagOfModule({ ...module, requires: [], replaces: [] }, '2.1.0')) // lib/v2.1.0
+console.log(tagOfModule({ path: 'example.com/repo/lib/v2', dir: 'lib/v2' }, '2.1.0')) // lib/v2.1.0
 ```
 
 ## Interfaces
 
+- [CommitIdentity](interfaces/CommitIdentity.md)
 - [TaggedModule](interfaces/TaggedModule.md)
 - [TagModulesOptions](interfaces/TagModulesOptions.md)
+- [TagsContext](interfaces/TagsContext.md)
 
 ## Type Aliases
 
 - [ModuleStatus](type-aliases/ModuleStatus.md)
 
-## Variables
-
-- [RELEASE\_AUTHOR](variables/RELEASE_AUTHOR.md)
-
 ## Functions
 
 - [askProxy](functions/askProxy.md)

package/api/@wtf/release-go/tags/functions/askProxy.md

@@ -8,20 +8,20 @@
 
 > **askProxy**(`context`, `modules`, `version`): `Promise`\<`void`\>
 
-Defined in: [packages/release-go/src/tags.ts:293](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L293)
+Defined in: [packages/release-go/src/tags.ts:317](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L317)
 
 Asks the Go proxy for each of `modules` at `version`, by `go list -m -json <path>@v<version>`
-in the system's temporary folder, of no workspace (`GOWORK=off`, `GOFLAGS=-mod=mod`), and
-`GOPROXY` of the environment, Go's own by default: the proxy fetches it once, and lists it. Each
-that fails is an error, together.
+in the platform's temporary folder, `dirs.temp`, of no workspace (`GOWORK=off`,
+`GOFLAGS=-mod=mod`), and `GOPROXY` of the environment, Go's own by default: the proxy fetches it
+once, and lists it. Each that fails is an error, together.
 
 ## Parameters
 
 ### context
 
-[`GitContext`](../../../release-system/git/interfaces/GitContext.md)
+[`TagsContext`](../interfaces/TagsContext.md)
 
-The environment, and the system `go` runs by.
+The platform `go` runs by, of its environment and its temporary folder.
 
 ### modules
 

package/api/@wtf/release-go/tags/functions/maskCredentials.md

@@ -8,7 +8,7 @@
 
 > **maskCredentials**(`text`): `string`
 
-Defined in: [packages/release-go/src/tags.ts:73](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L73)
+Defined in: [packages/release-go/src/tags.ts:69](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L69)
 
 A text of no credentials of a URL: `https://user:token@host` as `https://[secure]@host`, as a
 remote of a CI holds its token.

package/api/@wtf/release-go/tags/functions/releaseCommit.md

@@ -6,24 +6,25 @@
 
 # Function: releaseCommit()
 
-> **releaseCommit**(`context`, `files`, `message`): `Promise`\<`string`\>
+> **releaseCommit**(`context`, `files`, `message`, `identity`): `Promise`\<`string`\>
 
-Defined in: [packages/release-go/src/tags.ts:114](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L114)
+Defined in: [packages/release-go/src/tags.ts:126](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L126)
 
 A commit of `files`, the go.mod files stamped in the working tree, on top of `HEAD`, on no branch,
-as `git commit` would make it but by a temporary index of the system's temporary files: `HEAD`,
-the index and the working tree are left as they are. Its author and committer are those of
-`GIT_AUTHOR_*` and `GIT_COMMITTER_*` of the environment, else [RELEASE\_AUTHOR](../variables/RELEASE_AUTHOR.md). A tree the
-same as `HEAD`'s, as of go.mod files that require no module of the repo, is no commit: it gives
-`HEAD` itself.
+as `git commit` would make it but by a temporary index, in a temporary folder of the platform:
+`HEAD`, the index and the working tree are left as they are. Its author and committer are those
+of `identity`, in place of any of the environment, as `GIT_AUTHOR_NAME`. A tree the same as
+`HEAD`'s, as of go.mod files that require no module of the repo, is no commit: it gives `HEAD`
+itself.
 
 ## Parameters
 
 ### context
 
-[`GitContext`](../../../release-system/git/interfaces/GitContext.md)
+[`TagsContext`](../interfaces/TagsContext.md)
 
-The folder of the repo, its environment, and the system git runs by.
+The platform git runs by, of the folder of the repo, which makes the temporary
+folder.
 
 ### files
 
@@ -37,6 +38,12 @@ The go.mod files, from the root of the repo.
 
 The message of the commit.
 
+### identity
+
+[`CommitIdentity`](../interfaces/CommitIdentity.md)
+
+Its author, and its committer.
+
 ## Returns
 
 `Promise`\<`string`\>

package/api/@wtf/release-go/tags/functions/remoteTags.md

@@ -8,7 +8,7 @@
 
 > **remoteTags**(`context`, `remote`, `tags`): `Promise`\<`Set`\<`string`\>\>
 
-Defined in: [packages/release-go/src/tags.ts:173](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L173)
+Defined in: [packages/release-go/src/tags.ts:197](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L197)
 
 The tags of `tags` the remote has, of one `git ls-remote`.
 
@@ -16,9 +16,9 @@ The tags of `tags` the remote has, of one `git ls-remote`.
 
 ### context
 
-[`GitContext`](../../../release-system/git/interfaces/GitContext.md)
+[`GitContext`](../../../release/git/interfaces/GitContext.md)
 
-The folder of the repo, its environment, and the system git runs by.
+The platform git runs by, of the folder of the repo.
 
 ### remote
 

package/api/@wtf/release-go/tags/functions/tagModules.md

@@ -8,7 +8,7 @@
 
 > **tagModules**(`options`): `Promise`\<[`TaggedModule`](../interfaces/TaggedModule.md)[]\>
 
-Defined in: [packages/release-go/src/tags.ts:247](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L247)
+Defined in: [packages/release-go/src/tags.ts:271](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L271)
 
 Tags the modules of a release and pushes the tags: asks the remote which tags it has first, so a
 remote that cannot be asked stops before anything is made; skips each it has; makes the commit of
@@ -22,8 +22,8 @@ none.
 
 [`TagModulesOptions`](../interfaces/TagModulesOptions.md)
 
-The repo, the remote, the modules and the version, the files of the commit and
-its message, and the log.
+The repo, the remote, the modules and the version, the files of the commit, its
+message, its author and its committer, and the log.
 
 ## Returns
 

package/api/@wtf/release-go/tags/functions/tagOfModule.md

@@ -8,7 +8,7 @@
 
 > **tagOfModule**(`module`, `version`): `string`
 
-Defined in: [packages/release-go/src/tags.ts:61](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L61)
+Defined in: [packages/release-go/src/tags.ts:57](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L57)
 
 The tag of `module` at `version`, as Go looks it up: `<prefix>/v<version>`, `v<version>` of a
 module whose prefix is the root ([tagPrefix](tagPrefix.md)).

package/api/@wtf/release-go/tags/functions/tagPrefix.md

@@ -8,7 +8,7 @@
 
 > **tagPrefix**(`module`): `string`
 
-Defined in: [packages/release-go/src/tags.ts:45](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L45)
+Defined in: [packages/release-go/src/tags.ts:41](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L41)
 
 The prefix of the tags of `module`, as Go looks them up: its folder, `.` at the root; of a module
 in a folder of its major (a path that ends in `/vN`, in the folder `vN` or one that ends in

package/api/@wtf/release-go/tags/interfaces/CommitIdentity.md

@@ -0,0 +1,35 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-go/tags](../README.md) / CommitIdentity
+
+# Interface: CommitIdentity
+
+Defined in: [packages/release-go/src/tags.ts:103](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L103)
+
+Who makes a release commit: its author, and its committer, the author by default.
+
+## Extended by
+
+- [`TagModulesOptions`](TagModulesOptions.md)
+
+## Properties
+
+### author
+
+> `readonly` **author**: [`GoIdentity`](../../interfaces/GoIdentity.md)
+
+Defined in: [packages/release-go/src/tags.ts:105](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L105)
+
+The author of the commit.
+
+***
+
+### committer?
+
+> `readonly` `optional` **committer?**: [`GoIdentity`](../../interfaces/GoIdentity.md)
+
+Defined in: [packages/release-go/src/tags.ts:107](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L107)
+
+The committer of the commit: the author by default.

package/api/@wtf/release-go/tags/interfaces/TagModulesOptions.md

@@ -6,19 +6,51 @@
 
 # Interface: TagModulesOptions
 
-Defined in: [packages/release-go/src/tags.ts:214](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L214)
+Defined in: [packages/release-go/src/tags.ts:238](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L238)
 
 What a release of tags needs.
 
+## Extends
+
+- [`CommitIdentity`](CommitIdentity.md)
+
 ## Properties
 
+### author
+
+> `readonly` **author**: [`GoIdentity`](../../interfaces/GoIdentity.md)
+
+Defined in: [packages/release-go/src/tags.ts:105](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L105)
+
+The author of the commit.
+
+#### Inherited from
+
+[`CommitIdentity`](CommitIdentity.md).[`author`](CommitIdentity.md#author)
+
+***
+
+### committer?
+
+> `readonly` `optional` **committer?**: [`GoIdentity`](../../interfaces/GoIdentity.md)
+
+Defined in: [packages/release-go/src/tags.ts:107](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L107)
+
+The committer of the commit: the author by default.
+
+#### Inherited from
+
+[`CommitIdentity`](CommitIdentity.md).[`committer`](CommitIdentity.md#committer)
+
+***
+
 ### context
 
-> `readonly` **context**: [`GitContext`](../../../release-system/git/interfaces/GitContext.md)
+> `readonly` **context**: [`TagsContext`](TagsContext.md)
 
-Defined in: [packages/release-go/src/tags.ts:216](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L216)
+Defined in: [packages/release-go/src/tags.ts:240](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L240)
 
-The folder of the repo, its environment, and the system git runs by.
+The platform git runs by, of the folder of the repo, which makes the temporary folder.
 
 ***
 
@@ -26,7 +58,7 @@ The folder of the repo, its environment, and the system git runs by.
 
 > `readonly` **files**: readonly `string`[]
 
-Defined in: [packages/release-go/src/tags.ts:224](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L224)
+Defined in: [packages/release-go/src/tags.ts:248](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L248)
 
 The go.mod files the stamp wrote, from the root of the repo, which the commit holds.
 
@@ -36,7 +68,7 @@ The go.mod files the stamp wrote, from the root of the repo, which the commit ho
 
 > `readonly` **log**: (`line`) => `void`
 
-Defined in: [packages/release-go/src/tags.ts:232](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L232)
+Defined in: [packages/release-go/src/tags.ts:256](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L256)
 
 Says a line of what is done.
 
@@ -58,7 +90,7 @@ The line.
 
 > `readonly` **message**: `string`
 
-Defined in: [packages/release-go/src/tags.ts:226](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L226)
+Defined in: [packages/release-go/src/tags.ts:250](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L250)
 
 The message of the commit the tags name.
 
@@ -68,7 +100,7 @@ The message of the commit the tags name.
 
 > `readonly` **modules**: readonly [`GoModule`](../../interfaces/GoModule.md)[]
 
-Defined in: [packages/release-go/src/tags.ts:220](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L220)
+Defined in: [packages/release-go/src/tags.ts:244](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L244)
 
 The modules of the release.
 
@@ -78,7 +110,7 @@ The modules of the release.
 
 > `readonly` **remote**: `string`
 
-Defined in: [packages/release-go/src/tags.ts:218](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L218)
+Defined in: [packages/release-go/src/tags.ts:242](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L242)
 
 The remote the tags are pushed to, by its name or its URL, of its credentials.
 
@@ -88,6 +120,6 @@ The remote the tags are pushed to, by its name or its URL, of its credentials.
 
 > `readonly` **version**: `string`
 
-Defined in: [packages/release-go/src/tags.ts:222](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L222)
+Defined in: [packages/release-go/src/tags.ts:246](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L246)
 
 The version of the release, as `1.2.3`.

package/api/@wtf/release-go/tags/interfaces/TaggedModule.md

@@ -6,7 +6,7 @@
 
 # Interface: TaggedModule
 
-Defined in: [packages/release-go/src/tags.ts:202](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L202)
+Defined in: [packages/release-go/src/tags.ts:226](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L226)
 
 A module of the release, its tag, and what became of it.
 
@@ -16,7 +16,7 @@ A module of the release, its tag, and what became of it.
 
 > `readonly` **path**: `string`
 
-Defined in: [packages/release-go/src/tags.ts:204](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L204)
+Defined in: [packages/release-go/src/tags.ts:228](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L228)
 
 The path of the module.
 
@@ -26,7 +26,7 @@ The path of the module.
 
 > `readonly` **status**: [`ModuleStatus`](../type-aliases/ModuleStatus.md)
 
-Defined in: [packages/release-go/src/tags.ts:210](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L210)
+Defined in: [packages/release-go/src/tags.ts:234](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L234)
 
 Whether it was tagged and pushed, or skipped as the remote has its tag.
 
@@ -36,7 +36,7 @@ Whether it was tagged and pushed, or skipped as the remote has its tag.
 
 > `readonly` **tag**: `string`
 
-Defined in: [packages/release-go/src/tags.ts:208](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L208)
+Defined in: [packages/release-go/src/tags.ts:232](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L232)
 
 Its tag, as `lib/v1.2.3`.
 
@@ -46,6 +46,6 @@ Its tag, as `lib/v1.2.3`.
 
 > `readonly` **version**: `string`
 
-Defined in: [packages/release-go/src/tags.ts:206](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L206)
+Defined in: [packages/release-go/src/tags.ts:230](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L230)
 
 The version of the release, of the module.

package/api/@wtf/release-go/tags/interfaces/TagsContext.md

@@ -0,0 +1,22 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-go/tags](../README.md) / TagsContext
+
+# Interface: TagsContext
+
+Defined in: [packages/release-go/src/tags.ts:97](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L97)
+
+Where a release of tags runs git: the platform, whose working folder, `dirs.cwd`, is the folder of
+the repo, and which makes the temporary folder of the index of a release commit.
+
+## Properties
+
+### platform
+
+> `readonly` **platform**: [`ReleasePlatform`](../../../release/type-aliases/ReleasePlatform.md)
+
+Defined in: [packages/release-go/src/tags.ts:99](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L99)
+
+The platform git runs by, a release's.

package/api/@wtf/release-go/tags/type-aliases/ModuleStatus.md

@@ -8,6 +8,6 @@
 
 > **ModuleStatus** = `"tagged"` \| `"skipped"`
 
-Defined in: [packages/release-go/src/tags.ts:199](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-go/src/tags.ts#L199)
+Defined in: [packages/release-go/src/tags.ts:223](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-go/src/tags.ts#L223)
 
 What happened to a module of the release.

package/api/@wtf/release-maven/README.md

@@ -6,14 +6,17 @@
 
 # @wtf/release-maven
 
-The modules of a Maven repo released in trains, of no release tool. Its default export is the
-ecosystem of Maven, `mavenEcosystem` of `./ecosystem`, which a config of the trains names in
-`ecosystems` as `'@wtf/release-maven'`, so the trains read the modules of the repo by it; and this
-module holds the types of the modules, which the modules of this package do with: each pom.xml
-read by a small reader of XML (`./pom`), the modules of a train in the order they deploy in
-(`./artifacts`), the versions of the trains written into the poms (`./stamp`), where a repository
-serves a pom (`./repository`), and each module it lacks deployed (`./publish`). Each function
-takes the `System` it runs by, and runs `git` and `mvn` through it.
+The modules of a Maven repo released, of no release tool and of no train. Its default export is
+the ecosystem of Maven, `mavenEcosystem` of `./ecosystem`, which a config names in `ecosystems` as
+`'@wtf/release-maven'`, and a `ReleasingEcosystem` of `@wtf/release/contract`: it reads the
+modules of the repo, and releases the modules of the plan its caller gives it, in the steps
+`verify`, `prepare` and `publish`. This module holds the types of the modules, which the modules
+of this package do with: each pom.xml read by a small reader of XML (`./pom`), the modules of a
+release in the order they deploy in (`./artifacts`), the versions of a release written into the
+poms (`./stamp`), where a repository serves a pom (`./repository`), and each module it lacks
+deployed (`./publish`). Each function takes what it runs by of the folder of the repo, a handle of
+the File System standard, whose poms it reads and writes, and of the platform, of that folder as
+its working folder, by which it runs `git` and `mvn`, and asks a repository.
 
 ```ts
 import type { MavenModule } from '@wtf/release-maven'

package/api/@wtf/release-maven/artifacts/README.md

@@ -9,16 +9,21 @@
 The modules of a Maven repo: [readPoms](functions/readPoms.md) reads each pom.xml git tracks, of the working tree
 or of a commit; [modulesOf](functions/modulesOf.md) makes the modules of them, each of what it inherits of its
 parents in the repo and of its dependencies on the other modules; [selectArtifacts](functions/selectArtifacts.md) takes
-those a release of a train deploys; and [publishOrder](functions/publishOrder.md) puts them in the order of their
-dependencies, each after the modules it depends on, as a repository needs them deployed.
+those a release deploys, of the modules it is of, as a train's; [installsOf](functions/installsOf.md) those it
+installs; and [publishOrder](functions/publishOrder.md) puts them in the order of their dependencies, each after the
+modules it depends on, as a repository needs them deployed. A caller makes the `own` of the plan
+of a release of them.
 
 ```ts
+import type { EcosystemContext } from '@wtf/release/ecosystem'
 import { publishOrder, readModules, selectArtifacts } from '@wtf/release-maven/artifacts'
-import type { System } from '@wtf/release-system'
 
-// The names of the modules a release of the train of `train` deploys, in order.
-export async function names(system: System, train: ReadonlySet<string>): Promise<string[]> {
-  const modules = await readModules({ system })
+// The names of the modules a release of the modules of `train` deploys, in order.
+export async function names(
+  repo: EcosystemContext,
+  train: ReadonlySet<string>
+): Promise<string[]> {
+  const modules = await readModules(repo)
   return publishOrder(selectArtifacts(modules, { train })).map(({ name }) => name)
 }
 ```

package/api/@wtf/release-maven/artifacts/functions/groupIdOf.md

@@ -8,7 +8,7 @@
 
 > **groupIdOf**(`groupId`, `own`): `string` \| `undefined`
 
-Defined in: [packages/release-maven/src/artifacts.ts:85](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-maven/src/artifacts.ts#L85)
+Defined in: [packages/release-maven/src/artifacts.ts:88](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/artifacts.ts#L88)
 
 A groupId as a pom writes it, of `${project.groupId}` read as the groupId of the module.
 

package/api/@wtf/release-maven/artifacts/functions/installsOf.md

@@ -8,7 +8,7 @@
 
 > **installsOf**(`modules`, `release`, `served`): [`MavenModule`](../../interfaces/MavenModule.md)[]
 
-Defined in: [packages/release-maven/src/artifacts.ts:373](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-maven/src/artifacts.ts#L373)
+Defined in: [packages/release-maven/src/artifacts.ts:376](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/artifacts.ts#L376)
 
 The modules of the repo a release installs before it deploys, as `mvn` of one module finds the
 modules it depends on in the local repository, or in the remote one: each module the modules of

package/api/@wtf/release-maven/artifacts/functions/isPomFile.md

@@ -8,7 +8,7 @@
 
 > **isPomFile**(`file`): `boolean`
 
-Defined in: [packages/release-maven/src/artifacts.ts:41](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/release-maven/src/artifacts.ts#L41)
+Defined in: [packages/release-maven/src/artifacts.ts:47](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-maven/src/artifacts.ts#L47)
 
 Whether `file` is the pom of a module: a `pom.xml` in no `src` or `target` folder, as the fixtures
 of the tests of a plugin and the output of a build are.