@wtf/release-docs 9.1.0 → 10.0.0

package/api/@wtf/release-trains/packages/README.md

@@ -12,38 +12,35 @@ packages of a train that depend on packages of other trains, which makes a train
 another; [trainDependencies](functions/trainDependencies.md), the trains a train depends on, of those edges and of its
 `dependsOn`; [trainOrder](functions/trainOrder.md), the trains in the order of their dependencies;
 [dependsOnErrors](functions/dependsOnErrors.md), the trains a `dependsOn` names that depend on the train back;
-[publishOrder](functions/publishOrder.md), the packages of a train in the order to publish them in, with what is wrong
-with it; [releasedVersions](functions/releasedVersions.md), the last release of each other train, which a release stamps
+[releasedVersions](functions/releasedVersions.md), the last release of each other train, which a release stamps
 into the ranges it publishes, and the dependencies no release gives a version; and
 [unsatisfiedErrors](functions/unsatisfiedErrors.md), the ranges no release satisfies. Each reads the packages an ecosystem
-of `./ecosystem` gives, and no manifest.
+of `@wtf/release/ecosystem` gives, and no manifest.
 
 ```ts
-import type { System } from '@wtf/release-system/system'
-import { type Ecosystem, readPackages } from '@wtf/release-trains/ecosystem'
+import type { ReleasePlatform, RepoContext } from '@wtf/release'
+import { type Ecosystem, readPackages } from '@wtf/release/ecosystem'
 import { dependencyEdges, packagesOf, trainOrder } from '@wtf/release-trains/packages'
 
-// The system of the caller, Node's of a plugin, its own of a CLI; and an ecosystem of the repo.
-declare const system: System
+// The folder of the repo and the platform of the caller, Node's of a plugin, its own of a CLI;
+// and an ecosystem of the repo.
+declare const repo: RepoContext<ReleasePlatform>
 declare const npm: Ecosystem
 const trains = {
   trains: { paths: ['packages/release-trains', 'packages/semantic-release-trains'] },
   replace: { paths: ['packages/release-replace', 'packages/semantic-release-replace'] }
 }
-const repo = await readPackages([npm], { system })
+const packages = await readPackages([npm], repo)
 
-packagesOf(trains, 'replace', repo[0]?.packages ?? []) // the packages of its two folders
-dependencyEdges(trains, 'replace', repo)
+packagesOf(trains, 'replace', packages[0]?.packages ?? []) // the packages of its two folders
+dependencyEdges(trains, 'replace', packages)
 // Map { 'trains' => [{ ecosystem: 'npm', from: '@wtf/release-replace', … }] }
-trainOrder(trains, repo) // ['trains', 'replace']
+trainOrder(trains, packages) // ['trains', 'replace']
 ```
 
 ## Interfaces
 
 - [DependencyEdge](interfaces/DependencyEdge.md)
-- [OrderFault](interfaces/OrderFault.md)
-- [OrderPins](interfaces/OrderPins.md)
-- [PublishOrder](interfaces/PublishOrder.md)
 - [TrainDependency](interfaces/TrainDependency.md)
 - [VersionsRelease](interfaces/VersionsRelease.md)
 
@@ -52,10 +49,8 @@ trainOrder(trains, repo) // ['trains', 'replace']
 - [dependencyEdges](functions/dependencyEdges.md)
 - [dependencyText](functions/dependencyText.md)
 - [dependsOnErrors](functions/dependsOnErrors.md)
-- [normalizeDir](functions/normalizeDir.md)
 - [ownersOf](functions/ownersOf.md)
 - [packagesOf](functions/packagesOf.md)
-- [publishOrder](functions/publishOrder.md)
 - [releasedVersions](functions/releasedVersions.md)
 - [trainDependencies](functions/trainDependencies.md)
 - [trainOrder](functions/trainOrder.md)

package/api/@wtf/release-trains/packages/functions/dependencyEdges.md

@@ -8,7 +8,7 @@
 
 > **dependencyEdges**(`trains`, `name`, `repo`): `Map`\<`string`, [`DependencyEdge`](../interfaces/DependencyEdge.md)[]\>
 
-Defined in: [packages/release-trains/src/packages.ts:111](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L111)
+Defined in: [packages/release-trains/src/packages.ts:111](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L111)
 
 The trains the train `name` depends on, each with the edges that make it: a train depends on
 another when a package of its depends on a package of the other's, by any kind but `dev`.
@@ -29,7 +29,7 @@ The name of the train.
 
 ### repo
 
-readonly [`EcosystemPackages`](../../ecosystem/interfaces/EcosystemPackages.md)[]
+readonly [`EcosystemPackages`](../../../release/ecosystem/interfaces/EcosystemPackages.md)\<[`Package`](../../../release/ecosystem/interfaces/Package.md)\>[]
 
 The packages of each ecosystem of the repo.
 

package/api/@wtf/release-trains/packages/functions/dependencyText.md

@@ -8,7 +8,7 @@
 
 > **dependencyText**(`dependency`): `string`
 
-Defined in: [packages/release-trains/src/packages.ts:177](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L177)
+Defined in: [packages/release-trains/src/packages.ts:177](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L177)
 
 Why a train depends on another, as a message says it: each package that depends on a package of
 the other, as `@wtf/release-replace → @wtf/release-trains`, and `declared by dependsOn` of a

package/api/@wtf/release-trains/packages/functions/dependsOnErrors.md

@@ -8,7 +8,7 @@
 
 > **dependsOnErrors**(`trains`, `repo`): [`TrainsError`](../../errors/classes/TrainsError.md)[]
 
-Defined in: [packages/release-trains/src/packages.ts:226](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L226)
+Defined in: [packages/release-trains/src/packages.ts:226](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L226)
 
 The errors of each train a `dependsOn` names that depends on the train back, by its packages or
 by a `dependsOn` of its own, through other trains or none: `ETRAINDEPENDSON`, once of each
@@ -25,7 +25,7 @@ Every train of the repo.
 
 ### repo
 
-readonly [`EcosystemPackages`](../../ecosystem/interfaces/EcosystemPackages.md)[]
+readonly [`EcosystemPackages`](../../../release/ecosystem/interfaces/EcosystemPackages.md)\<[`Package`](../../../release/ecosystem/interfaces/Package.md)\>[]
 
 The packages of each ecosystem of the repo.
 

package/api/@wtf/release-trains/packages/functions/ownersOf.md

@@ -8,7 +8,7 @@
 
 > **ownersOf**(`trains`, `packages`): `Map`\<`string`, `string`\>
 
-Defined in: [packages/release-trains/src/packages.ts:76](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L76)
+Defined in: [packages/release-trains/src/packages.ts:76](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L76)
 
 The train of each package, by its name: the train whose paths hold its folder. Throws
 `ETRAINOVERLAP` of each package the paths of two trains hold, together.
@@ -23,7 +23,7 @@ Every train of the repo.
 
 ### packages
 
-readonly [`Package`](../../ecosystem/interfaces/Package.md)[]
+readonly [`Package`](../../../release/ecosystem/interfaces/Package.md)[]
 
 The packages of an ecosystem of the repo.
 

package/api/@wtf/release-trains/packages/functions/packagesOf.md

@@ -8,7 +8,7 @@
 
 > **packagesOf**\<`P`\>(`trains`, `name`, `packages`): `P`[]
 
-Defined in: [packages/release-trains/src/packages.ts:57](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L57)
+Defined in: [packages/release-trains/src/packages.ts:57](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L57)
 
 The packages of the train `name`: each package whose folder its paths hold.
 
@@ -16,7 +16,7 @@ The packages of the train `name`: each package whose folder its paths hold.
 
 ### P
 
-`P` *extends* [`Package`](../../ecosystem/interfaces/Package.md)
+`P` *extends* [`Package`](../../../release/ecosystem/interfaces/Package.md)
 
 A package, as an ecosystem gives it, or one of more of its own.
 

package/api/@wtf/release-trains/packages/functions/releasedVersions.md

@@ -8,7 +8,7 @@
 
 > **releasedVersions**(`release`): `Promise`\<`Map`\<`string`, `string`\>\>
 
-Defined in: [packages/release-trains/src/packages.ts:478](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L478)
+Defined in: [packages/release-trains/src/packages.ts:346](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L346)
 
 The last release of each other train, by its name, by the tags of each that `HEAD` holds: the
 version a release of the train resolves each range of a package of that train to, as it stamps
@@ -26,7 +26,7 @@ two trains hold, `ETRAINOVERLAP`.
 [`VersionsRelease`](../interfaces/VersionsRelease.md)
 
 The trains and the train of the release, and the packages of each ecosystem of
-the repo; and the folder of the repo, the environment git runs in, and the system it runs by.
+the repo; and the folder of the repo and the platform git runs by.
 
 ## Returns
 

package/api/@wtf/release-trains/packages/functions/trainDependencies.md

@@ -8,7 +8,7 @@
 
 > **trainDependencies**(`trains`, `name`, `repo`): `Map`\<`string`, [`TrainDependency`](../interfaces/TrainDependency.md)\>
 
-Defined in: [packages/release-trains/src/packages.ts:151](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L151)
+Defined in: [packages/release-trains/src/packages.ts:151](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L151)
 
 The trains the train `name` depends on, each with why: the trains a package of its depends on a
 package of ([dependencyEdges](dependencyEdges.md)), then the trains its `dependsOn` names, each once. A name
@@ -30,7 +30,7 @@ The name of the train.
 
 ### repo
 
-readonly [`EcosystemPackages`](../../ecosystem/interfaces/EcosystemPackages.md)[]
+readonly [`EcosystemPackages`](../../../release/ecosystem/interfaces/EcosystemPackages.md)\<[`Package`](../../../release/ecosystem/interfaces/Package.md)\>[]
 
 The packages of each ecosystem of the repo.
 

package/api/@wtf/release-trains/packages/functions/trainOrder.md

@@ -8,7 +8,7 @@
 
 > **trainOrder**(`trains`, `repo`): `string`[]
 
-Defined in: [packages/release-trains/src/packages.ts:210](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L210)
+Defined in: [packages/release-trains/src/packages.ts:210](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L210)
 
 The trains of `trains` in the order to release them in: each after the trains it depends on, by
 its packages or its `dependsOn` ([trainDependencies](trainDependencies.md)), in the order they are declared
@@ -24,7 +24,7 @@ Every train of the repo, in the order declared.
 
 ### repo
 
-readonly [`EcosystemPackages`](../../ecosystem/interfaces/EcosystemPackages.md)[]
+readonly [`EcosystemPackages`](../../../release/ecosystem/interfaces/EcosystemPackages.md)\<[`Package`](../../../release/ecosystem/interfaces/Package.md)\>[]
 
 The packages of each ecosystem of the repo.
 

package/api/@wtf/release-trains/packages/functions/unsatisfiedErrors.md

@@ -8,7 +8,7 @@
 
 > **unsatisfiedErrors**(`trains`, `name`, `repo`, `git`): `Promise`\<[`TrainsError`](../../errors/classes/TrainsError.md)[]\>
 
-Defined in: [packages/release-trains/src/packages.ts:533](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L533)
+Defined in: [packages/release-trains/src/packages.ts:402](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L402)
 
 The errors of the ranges the train `name` requires of the trains it depends on that no release of
 theirs satisfies, by the tags of each in the repo of `git`: `EDEPENDENCYUNSATISFIED`. A release
@@ -32,15 +32,16 @@ The name of the train.
 
 ### repo
 
-readonly [`EcosystemPackages`](../../ecosystem/interfaces/EcosystemPackages.md)[]
+readonly [`EcosystemPackages`](../../../release/ecosystem/interfaces/EcosystemPackages.md)\<[`Package`](../../../release/ecosystem/interfaces/Package.md)\>[]
 
 The packages of each ecosystem of the repo.
 
 ### git
 
-[`GitContext`](../../../release-system/git/interfaces/GitContext.md)
+[`RepoContext`](../../../release/interfaces/RepoContext.md)
 
-Where git runs: the folder of the repo, its environment, and the system it runs by.
+Where git runs: the folder of the repo and the platform, of that folder as its
+working folder.
 
 ## Returns
 

package/api/@wtf/release-trains/packages/interfaces/DependencyEdge.md

@@ -6,7 +6,7 @@
 
 # Interface: DependencyEdge
 
-Defined in: [packages/release-trains/src/packages.ts:89](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L89)
+Defined in: [packages/release-trains/src/packages.ts:89](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L89)
 
 A package of a train that depends on a package of another train.
 
@@ -16,7 +16,7 @@ A package of a train that depends on a package of another train.
 
 > `readonly` **ecosystem**: `string`
 
-Defined in: [packages/release-trains/src/packages.ts:91](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L91)
+Defined in: [packages/release-trains/src/packages.ts:91](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L91)
 
 The name of the ecosystem of both.
 
@@ -26,7 +26,7 @@ The name of the ecosystem of both.
 
 > `readonly` **from**: `string`
 
-Defined in: [packages/release-trains/src/packages.ts:93](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L93)
+Defined in: [packages/release-trains/src/packages.ts:93](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L93)
 
 The package that depends on the other.
 
@@ -36,7 +36,7 @@ The package that depends on the other.
 
 > `readonly` **kind**: `"runtime"` \| `"peer"` \| `"build"`
 
-Defined in: [packages/release-trains/src/packages.ts:97](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L97)
+Defined in: [packages/release-trains/src/packages.ts:97](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L97)
 
 How it depends on it: any kind but `dev`, which orders no train.
 
@@ -46,7 +46,7 @@ How it depends on it: any kind but `dev`, which orders no train.
 
 > `readonly` **range**: `string` \| `undefined`
 
-Defined in: [packages/release-trains/src/packages.ts:99](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L99)
+Defined in: [packages/release-trains/src/packages.ts:99](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L99)
 
 The range, as its manifest writes it: `undefined` of none that reaches the registry.
 
@@ -56,6 +56,6 @@ The range, as its manifest writes it: `undefined` of none that reaches the regis
 
 > `readonly` **to**: `string`
 
-Defined in: [packages/release-trains/src/packages.ts:95](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L95)
+Defined in: [packages/release-trains/src/packages.ts:95](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L95)
 
 The package it depends on.

package/api/@wtf/release-trains/packages/interfaces/TrainDependency.md

@@ -6,7 +6,7 @@
 
 # Interface: TrainDependency
 
-Defined in: [packages/release-trains/src/packages.ts:134](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L134)
+Defined in: [packages/release-trains/src/packages.ts:134](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L134)
 
 Why a train depends on another: the packages of its that depend on packages of the other, and
 whether it names the other in its `dependsOn`. A train it names alone is of no edge.
@@ -17,7 +17,7 @@ whether it names the other in its `dependsOn`. A train it names alone is of no e
 
 > `readonly` **declared**: `boolean`
 
-Defined in: [packages/release-trains/src/packages.ts:138](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L138)
+Defined in: [packages/release-trains/src/packages.ts:138](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L138)
 
 Whether the train names the other in its `dependsOn`.
 
@@ -27,6 +27,6 @@ Whether the train names the other in its `dependsOn`.
 
 > `readonly` **edges**: readonly [`DependencyEdge`](DependencyEdge.md)[]
 
-Defined in: [packages/release-trains/src/packages.ts:136](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L136)
+Defined in: [packages/release-trains/src/packages.ts:136](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L136)
 
 The packages of the train that depend on the other's, as [dependencyEdges](../functions/dependencyEdges.md) gives.

package/api/@wtf/release-trains/packages/interfaces/VersionsRelease.md

@@ -6,49 +6,52 @@
 
 # Interface: VersionsRelease
 
-Defined in: [packages/release-trains/src/packages.ts:444](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L444)
+Defined in: [packages/release-trains/src/packages.ts:318](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L318)
 
-A release of a train whose versions of the other trains [releasedVersions](../functions/releasedVersions.md) reads.
+A release of a train whose versions of the other trains [releasedVersions](../functions/releasedVersions.md) reads, in the
+repo of its folder, `root`, by its platform, which git runs by.
 
-## Properties
-
-### cwd?
+## Extends
 
-> `readonly` `optional` **cwd?**: `string`
+- [`RepoContext`](../../../release/interfaces/RepoContext.md)
 
-Defined in: [packages/release-trains/src/packages.ts:452](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L452)
+## Properties
 
-The folder of the repo: the system's working folder by default.
+### platform
 
-***
+> `readonly` **platform**: [`RepoPlatform`](../../../release/type-aliases/RepoPlatform.md)
 
-### env?
+Defined in: [packages/release/src/index.ts:80](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release/src/index.ts#L80)
 
-> `readonly` `optional` **env?**: `Readonly`\<`Record`\<`string`, `string` \| `undefined`\>\>
+The platform, of the folder of the repo as its working folder.
 
-Defined in: [packages/release-trains/src/packages.ts:454](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L454)
+#### Inherited from
 
-The environment git runs in: the system's by default.
+[`RepoContext`](../../../release/interfaces/RepoContext.md).[`platform`](../../../release/interfaces/RepoContext.md#platform)
 
 ***
 
 ### repo
 
-> `readonly` **repo**: readonly [`EcosystemPackages`](../../ecosystem/interfaces/EcosystemPackages.md)[]
+> `readonly` **repo**: readonly [`EcosystemPackages`](../../../release/ecosystem/interfaces/EcosystemPackages.md)\<[`Package`](../../../release/ecosystem/interfaces/Package.md)\>[]
 
-Defined in: [packages/release-trains/src/packages.ts:450](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L450)
+Defined in: [packages/release-trains/src/packages.ts:324](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L324)
 
 The packages of each ecosystem of the repo, of the release.
 
 ***
 
-### system
+### root
+
+> `readonly` **root**: `FileSystemDirectoryHandle`
+
+Defined in: [packages/release/src/index.ts:78](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release/src/index.ts#L78)
 
-> `readonly` **system**: [`System`](../../../release-system/system/interfaces/System.md)
+The folder of the repo, a handle of the File System standard.
 
-Defined in: [packages/release-trains/src/packages.ts:456](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L456)
+#### Inherited from
 
-The system git runs by, which it requires.
+[`RepoContext`](../../../release/interfaces/RepoContext.md).[`root`](../../../release/interfaces/RepoContext.md#root)
 
 ***
 
@@ -56,7 +59,7 @@ The system git runs by, which it requires.
 
 > `readonly` **train**: `string`
 
-Defined in: [packages/release-trains/src/packages.ts:448](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L448)
+Defined in: [packages/release-trains/src/packages.ts:322](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L322)
 
 The name of the train of the release.
 
@@ -66,6 +69,6 @@ The name of the train of the release.
 
 > `readonly` **trains**: [`Trains`](../../type-aliases/Trains.md)
 
-Defined in: [packages/release-trains/src/packages.ts:446](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/packages.ts#L446)
+Defined in: [packages/release-trains/src/packages.ts:320](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/packages.ts#L320)
 
 Every train of the repo.

package/api/@wtf/release-trains/paths/README.md

@@ -8,11 +8,11 @@
 
 Which train a file is of, and which commits are of a train: [trainOfPath](functions/trainOfPath.md),
 [trainsOfCommit](functions/trainsOfCommit.md) of the trains a commit counts for, [filterCommits](functions/filterCommits.md) of the commits a
-train counts, and [gitFilesOf](functions/gitFilesOf.md), the files of each commit by git. A file is of the paths of a train as `pathMatcher` of `@wtf/release-system/paths`
+train counts, and [gitFilesOf](functions/gitFilesOf.md), the files of each commit by git. A file is of the paths of a train as `pathMatcher` of `@wtf/release/paths`
 reads them.
 
 ```ts
-import type { System } from '@wtf/release-system/system'
+import type { RepoContext } from '@wtf/release'
 import {
   filterCommits,
   gitFilesOf,
@@ -35,8 +35,9 @@ trainsOfCommit(trains, ['pnpm-lock.yaml']) // ['trains', 'replace']
 
 // The commits of a run, each by its full hash, as semantic-release gives them.
 declare const commits: { hash: string; message: string }[]
-declare const system: System
-const ofTrains = await filterCommits(commits, trains, 'trains', gitFilesOf({ system }))
+// The folder of the repo and the platform of the caller.
+declare const repo: RepoContext
+const ofTrains = await filterCommits(commits, trains, 'trains', gitFilesOf(repo))
 ```
 
 ## Type Aliases

package/api/@wtf/release-trains/paths/functions/filterCommits.md

@@ -8,7 +8,7 @@
 
 > **filterCommits**\<`C`\>(`commits`, `trains`, `train`, `filesOf`): `Promise`\<`C`[]\>
 
-Defined in: [packages/release-trains/src/paths.ts:152](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/paths.ts#L152)
+Defined in: [packages/release-trains/src/paths.ts:154](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/paths.ts#L154)
 
 The commits of `commits` that count for the train `train` of `trains`, in their order, each as
 [trainsOfCommit](trainsOfCommit.md) reads its files: a commit of the files of two trains counts for both, and

package/api/@wtf/release-trains/paths/functions/gitFilesOf.md

@@ -8,7 +8,7 @@
 
 > **gitFilesOf**(`context`): [`FilesOf`](../type-aliases/FilesOf.md)
 
-Defined in: [packages/release-trains/src/paths.ts:103](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/paths.ts#L103)
+Defined in: [packages/release-trains/src/paths.ts:105](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/paths.ts#L105)
 
 The files of each commit, by git, in the repo of `context`, read once for each commit in a run:
 `git diff-tree -r -m --diff-merges=first-parent --root` of them all. A merge commit's files are
@@ -18,10 +18,10 @@ what it changes of its first parent, which is what it brings into its branch.
 
 ### context
 
-[`GitContext`](../../../release-system/git/interfaces/GitContext.md)
+[`RepoContext`](../../../release/interfaces/RepoContext.md)
 
-Where git runs: the folder of the repo, its environment, and the system it runs
-by.
+Where git runs: the folder of the repo and the platform, of that folder as its
+working folder.
 
 ## Returns
 

package/api/@wtf/release-trains/paths/functions/overlapError.md

@@ -8,7 +8,7 @@
 
 > **overlapError**(`file`, `names`): [`TrainsError`](../../errors/classes/TrainsError.md)
 
-Defined in: [packages/release-trains/src/paths.ts:78](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/paths.ts#L78)
+Defined in: [packages/release-trains/src/paths.ts:80](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/paths.ts#L80)
 
 The error of a file that the paths of more than one train hold.
 

package/api/@wtf/release-trains/paths/functions/trainOfPath.md

@@ -8,7 +8,7 @@
 
 > **trainOfPath**(`trains`, `file`): `string` \| `undefined`
 
-Defined in: [packages/release-trains/src/paths.ts:65](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/paths.ts#L65)
+Defined in: [packages/release-trains/src/paths.ts:67](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/paths.ts#L67)
 
 The name of the train whose `paths` hold `file`, or `undefined` when no train's do, as of a file
 of the root. Throws `ETRAINOVERLAP` when two trains' do.

package/api/@wtf/release-trains/paths/functions/trainsOfCommit.md

@@ -8,7 +8,7 @@
 
 > **trainsOfCommit**(`trains`, `files`): `string`[]
 
-Defined in: [packages/release-trains/src/paths.ts:119](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/paths.ts#L119)
+Defined in: [packages/release-trains/src/paths.ts:121](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/paths.ts#L121)
 
 The names of the trains a commit that changes `files` counts for. A file of the `paths` of a
 train is that train's own: the commit counts for each train it changes the own files of, and for

package/api/@wtf/release-trains/paths/functions/trainsOfPath.md

@@ -8,7 +8,7 @@
 
 > **trainsOfPath**(`trains`, `file`): `string`[]
 
-Defined in: [packages/release-trains/src/paths.ts:51](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/paths.ts#L51)
+Defined in: [packages/release-trains/src/paths.ts:53](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/paths.ts#L53)
 
 The names of the trains whose `paths` hold `file`.
 

package/api/@wtf/release-trains/paths/type-aliases/FilesOf.md

@@ -8,7 +8,7 @@
 
 > **FilesOf** = (`hashes`) => `Promise`\<`ReadonlyMap`\<`string`, readonly `string`[]\>\>
 
-Defined in: [packages/release-trains/src/paths.ts:92](https://gitlab.com/wetryfun/release/release/-/blob/838e75e66ef604439e05c0180870e65b00370ea2/packages/release-trains/src/paths.ts#L92)
+Defined in: [packages/release-trains/src/paths.ts:94](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/paths.ts#L94)
 
 The files each commit of `hashes` changes, by its hash, as [filterCommits](../functions/filterCommits.md) reads them.
 

package/api/@wtf/release-trains/plan/README.md

@@ -0,0 +1,38 @@
+[**Release trains**](../../../README.md)
+
+***
+
+[Release trains](../../../README.md) / @wtf/release-trains/plan
+
+# @wtf/release-trains/plan
+
+The plan of a release of a train: [planOf](functions/planOf.md) works out, once for every ecosystem of the repo,
+what the release of the train is of, as `Plan` of `@wtf/release/contract` has it: the packages of
+the train that publish, in the order to publish them in, and the version of each package of the
+repo a range of theirs is written of, the release's of each of the train, the last release of its
+train of each other. It checks the rules of the dependencies between trains on the way: a range of
+a package of no train or of a train of no release fails, and so does one no release satisfies. A
+driver of any release tool gives the plans to `runStep` of `@wtf/release/driver`.
+
+```ts
+import type { RepoContext } from '@wtf/release'
+import type { Ecosystem } from '@wtf/release/ecosystem'
+import { readPackages } from '@wtf/release/ecosystem'
+import { planOf } from '@wtf/release-trains/plan'
+
+declare const context: RepoContext
+declare const npm: Ecosystem
+const trains = { core: { paths: ['packages/core'] } }
+const repo = await readPackages([npm], context)
+const plans = await planOf({ trains, train: 'core', version: '1.2.0', repo, ...context })
+plans.get('npm')?.own // the packages of core that publish, in order
+```
+
+## Interfaces
+
+- [PlanRelease](interfaces/PlanRelease.md)
+- [TrainPlan](interfaces/TrainPlan.md)
+
+## Functions
+
+- [planOf](functions/planOf.md)

package/api/@wtf/release-trains/plan/functions/planOf.md

@@ -0,0 +1,45 @@
+[**Release trains**](../../../../README.md)
+
+***
+
+[Release trains](../../../../README.md) / [@wtf/release-trains/plan](../README.md) / planOf
+
+# Function: planOf()
+
+> **planOf**\<`P`\>(`release`): `Promise`\<`Map`\<`string`, [`TrainPlan`](../interfaces/TrainPlan.md)\<`P`\>\>\>
+
+Defined in: [packages/release-trains/src/plan.ts:92](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/release-trains/src/plan.ts#L92)
+
+The plan of the release of the train of `release`, of each ecosystem of its repo, by the name of
+the ecosystem: the packages of the train that publish, in the order to publish them in; and the
+version of each package of the ecosystem, the release's of each of the train, the last release of
+its train of each other, none of a package of no train or of a train of no release. A package that
+publishes nowhere takes the version of its train too, as an ecosystem stamps it, and the packages
+that name it resolve it; of a release of no version yet, the packages of its train take none, and
+its checks are the same. Throws, together, the
+faults of the selection of the train, `EDEPENDENCYUNSATISFIED` of each range no release
+satisfies, and `EDEPENDENCYNOTRAIN` and `EDEPENDENCYNORELEASE` of each range of no version; of
+versions given by hand, no range is checked.
+
+## Type Parameters
+
+### P
+
+`P` *extends* [`Package`](../../../release/ecosystem/interfaces/Package.md)
+
+The packages of its ecosystems, as they give them, of which each plan is.
+
+## Parameters
+
+### release
+
+[`PlanRelease`](../interfaces/PlanRelease.md)\<`P`\>
+
+The trains, the train and the version of the release, the packages of the repo,
+and the folder and the platform git reads the tags by.
+
+## Returns
+
+`Promise`\<`Map`\<`string`, [`TrainPlan`](../interfaces/TrainPlan.md)\<`P`\>\>\>
+
+The plan of each ecosystem, by its name, in the order of `release.repo`.