@jterrazz/test 18.2.0 → 18.3.0

package/dist/oxlint.cjs

@@ -172,7 +172,6 @@ function testPackageOf(specifier) {
 const SPECIFICATIONS = /* @__PURE__ */ new Set([
 	"api",
 	"cli",
-	"deployment",
 	"integration",
 	"job",
 	"lint",
@@ -213,10 +212,10 @@ var manifest_default = {
 		{
 			"audience": "consumer",
 			"channel": "static",
-			"sentence": "Eight constructors and only eight: `specification.api()`, `specification.job()`, `specification.cli(bin)`, `specification.integration()`, `specification.website()`, `specification.deployment()`, `specification.mobile()`, `specification.lint()`. Any other member (`.app`, `.http`, `.stack`...) is an error. A rendered component starts nothing: it is a chain, not a member of this record.",
+			"sentence": "Seven constructors and only seven: `specification.api()`, `specification.job()`, `specification.cli(bin)`, `specification.integration()`, `specification.website()`, `specification.mobile()`, `specification.lint()`. Any other member (`.app`, `.http`, `.stack`...) is an error. A rendered component starts nothing: it is a chain, not a member of this record.",
 			"specification": "model",
 			"family": "setup",
-			"fix": "Name one of the eight, or reach for the `component` chain: a ninth subject is a decision before it is a constructor.",
+			"fix": "Name one of the seven, or reach for the `component` chain: an eighth subject is a decision before it is a constructor.",
 			"name": "no-unknown-constructor",
 			"rationale": "A closed surface stops parallel constructors being invented and keeps the API memorable.",
 			"reach": "all"
@@ -954,7 +953,7 @@ var manifest_default = {
 		{
 			"audience": "consumer",
 			"channel": "checker",
-			"sentence": "A first-level folder named for one of the eight specifications holds a `*.specification.ts(x)` calling `specification.<specification>(`. Positive-only: any other first-level name is a repository suite, judged by `specs-at-declared-depth`'s declared depth alone.",
+			"sentence": "A first-level folder named for one of the seven specifications holds a `*.specification.ts(x)` calling `specification.<specification>(`. Positive-only: any other first-level name is a repository suite, judged by `specs-at-declared-depth`'s declared depth alone.",
 			"specification": "model",
 			"family": "layout",
 			"fix": "Create the specification the folder promises, or rename the folder.",
@@ -1053,7 +1052,7 @@ var manifest_default = {
 		{
 			"audience": "consumer",
 			"channel": "checker",
-			"sentence": "The first line of a depth-1 `.http` follows its grammar: a request line (`METHOD /path`, or `METHOD https://host/path` for a deployment) under `__requests__/`, a status line (`HTTP/1.1 <status>`, or `unreachable: <reason>` for an exchange that never answered) under `__expected__/`.",
+			"sentence": "The first line of a depth-1 `.http` follows its grammar: a request line (`METHOD /path`, or `METHOD https://host/path` for a deployed api) under `__requests__/`, a status line (`HTTP/1.1 <status>`, or `unreachable: <reason>` for an exchange that never answered) under `__expected__/`.",
 			"specification": "api",
 			"family": "expectations",
 			"fix": "Write the opening line the folder calls for, or move the file to the other one.",
@@ -2252,7 +2251,6 @@ function subjectsOf(source, readRequest, reading = NO_READING) {
 const SETTINGS = {
 	api: ["clock", "headers"],
 	cli: ["env"],
-	deployment: ["headers"],
 	integration: ["clock"],
 	job: ["clock"],
 	website: ["clock", "headers"]
@@ -5999,7 +5997,6 @@ const noSimulatedDom = (0, _jterrazz_typescript_rules.defineRule)({
 const KNOWN_CONSTRUCTORS = /* @__PURE__ */ new Set([
 	"api",
 	"cli",
-	"deployment",
 	"integration",
 	"job",
 	"lint",
@@ -6011,7 +6008,7 @@ const noUnknownConstructor = (0, _jterrazz_typescript_rules.defineRule)({
 	docs: row$7,
 	messages: { unknownConstructor: {
 		found: "`specification.{{member}}` is no constructor",
-		fix: "call `specification.api()`, `.job()`, `.cli(bin)`, `.integration()`, `.website()`, `.deployment()`, `.mobile()` or `.lint()`; a rendered unit is the `component` chain"
+		fix: "call `specification.api()`, `.job()`, `.cli(bin)`, `.integration()`, `.website()`, `.mobile()` or `.lint()`; a rendered unit is the `component` chain"
 	} },
 	read: (0, _jterrazz_typescript_rules.readAt)(row$7, CATALOGUE_CHAPTER),
 	type: "problem"

package/dist/oxlint.d.cts

@@ -12,7 +12,7 @@ type RowDocs<Family extends string = string> = Omit<RuleDocs, 'family' | 'name'>
   /** One per row: a convention enforced two ways is two rows, so a reader knows which pass a finding comes from. */
   channel: 'checker' | 'meta' | 'process' | 'runtime' | 'static' | 'toolchain' | 'type' | 'upstream';
   /** Required: `model` is a statement (this reaches every specification), never a default. */
-  specification: 'api' | 'cli' | 'component' | 'deployment' | 'integration' | 'job' | 'lint' | 'mobile' | 'model' | 'website';
+  specification: 'api' | 'cli' | 'component' | 'integration' | 'job' | 'lint' | 'mobile' | 'model' | 'website';
   family: Family;
   rationale: string;
   /** An `upstream` row names the rule whose option carries it; the completeness meta-test reads it. */

package/dist/oxlint.d.ts

@@ -12,7 +12,7 @@ type RowDocs<Family extends string = string> = Omit<RuleDocs, 'family' | 'name'>
   /** One per row: a convention enforced two ways is two rows, so a reader knows which pass a finding comes from. */
   channel: 'checker' | 'meta' | 'process' | 'runtime' | 'static' | 'toolchain' | 'type' | 'upstream';
   /** Required: `model` is a statement (this reaches every specification), never a default. */
-  specification: 'api' | 'cli' | 'component' | 'deployment' | 'integration' | 'job' | 'lint' | 'mobile' | 'model' | 'website';
+  specification: 'api' | 'cli' | 'component' | 'integration' | 'job' | 'lint' | 'mobile' | 'model' | 'website';
   family: Family;
   rationale: string;
   /** An `upstream` row names the rule whose option carries it; the completeness meta-test reads it. */

package/dist/oxlint.js

@@ -368,7 +368,6 @@ const noRedundantServiceUrl = defineRule({
 const SETTINGS = {
 	api: ["clock", "headers"],
 	cli: ["env"],
-	deployment: ["headers"],
 	integration: ["clock"],
 	job: ["clock"],
 	website: ["clock", "headers"]
@@ -3739,7 +3738,6 @@ const noSimulatedDom = defineRule({
 const KNOWN_CONSTRUCTORS = /* @__PURE__ */ new Set([
 	"api",
 	"cli",
-	"deployment",
 	"integration",
 	"job",
 	"lint",
@@ -3751,7 +3749,7 @@ const noUnknownConstructor = defineRule({
 	docs: row$7,
 	messages: { unknownConstructor: {
 		found: "`specification.{{member}}` is no constructor",
-		fix: "call `specification.api()`, `.job()`, `.cli(bin)`, `.integration()`, `.website()`, `.deployment()`, `.mobile()` or `.lint()`; a rendered unit is the `component` chain"
+		fix: "call `specification.api()`, `.job()`, `.cli(bin)`, `.integration()`, `.website()`, `.mobile()` or `.lint()`; a rendered unit is the `component` chain"
 	} },
 	read: readAt(row$7, CATALOGUE_CHAPTER),
 	type: "problem"

package/dist/shared-exchange.js

@@ -1,5 +1,5 @@
-import { t as isRecord } from "./shared-json-shape.js";
 import { n as refusal } from "./shared-refusal.js";
+import { t as isRecord } from "./shared-json-shape.js";
 import { t as TOKEN_KINDS } from "./shared-tokens.js";
 //#region src/expectations/tokens/capture-scope.ts
 /** Named captures of `match.ref()` / `{{type#ref}}`, one scope per spec result. */

package/dist/shared-in-place.js

@@ -1,6 +1,6 @@
 import { i as safeRealpath } from "./shared-resolve.js";
-import { t as isRecord } from "./shared-json-shape.js";
 import { n as refusal } from "./shared-refusal.js";
+import { t as isRecord } from "./shared-json-shape.js";
 import { r as closingOf, t as argumentSpans } from "./shared-source-scan.js";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";

package/dist/shared-manifest.js

@@ -33,10 +33,10 @@ var manifest_default = {
 		{
 			"audience": "consumer",
 			"channel": "static",
-			"sentence": "Eight constructors and only eight: `specification.api()`, `specification.job()`, `specification.cli(bin)`, `specification.integration()`, `specification.website()`, `specification.deployment()`, `specification.mobile()`, `specification.lint()`. Any other member (`.app`, `.http`, `.stack`...) is an error. A rendered component starts nothing: it is a chain, not a member of this record.",
+			"sentence": "Seven constructors and only seven: `specification.api()`, `specification.job()`, `specification.cli(bin)`, `specification.integration()`, `specification.website()`, `specification.mobile()`, `specification.lint()`. Any other member (`.app`, `.http`, `.stack`...) is an error. A rendered component starts nothing: it is a chain, not a member of this record.",
 			"specification": "model",
 			"family": "setup",
-			"fix": "Name one of the eight, or reach for the `component` chain: a ninth subject is a decision before it is a constructor.",
+			"fix": "Name one of the seven, or reach for the `component` chain: an eighth subject is a decision before it is a constructor.",
 			"name": "no-unknown-constructor",
 			"rationale": "A closed surface stops parallel constructors being invented and keeps the API memorable.",
 			"reach": "all"
@@ -774,7 +774,7 @@ var manifest_default = {
 		{
 			"audience": "consumer",
 			"channel": "checker",
-			"sentence": "A first-level folder named for one of the eight specifications holds a `*.specification.ts(x)` calling `specification.<specification>(`. Positive-only: any other first-level name is a repository suite, judged by `specs-at-declared-depth`'s declared depth alone.",
+			"sentence": "A first-level folder named for one of the seven specifications holds a `*.specification.ts(x)` calling `specification.<specification>(`. Positive-only: any other first-level name is a repository suite, judged by `specs-at-declared-depth`'s declared depth alone.",
 			"specification": "model",
 			"family": "layout",
 			"fix": "Create the specification the folder promises, or rename the folder.",
@@ -873,7 +873,7 @@ var manifest_default = {
 		{
 			"audience": "consumer",
 			"channel": "checker",
-			"sentence": "The first line of a depth-1 `.http` follows its grammar: a request line (`METHOD /path`, or `METHOD https://host/path` for a deployment) under `__requests__/`, a status line (`HTTP/1.1 <status>`, or `unreachable: <reason>` for an exchange that never answered) under `__expected__/`.",
+			"sentence": "The first line of a depth-1 `.http` follows its grammar: a request line (`METHOD /path`, or `METHOD https://host/path` for a deployed api) under `__requests__/`, a status line (`HTTP/1.1 <status>`, or `unreachable: <reason>` for an exchange that never answered) under `__expected__/`.",
 			"specification": "api",
 			"family": "expectations",
 			"fix": "Write the opening line the folder calls for, or move the file to the other one.",

package/dist/shared-route-coverage.global-setup.js

@@ -1,5 +1,5 @@
-import { t as isRecord } from "./shared-json-shape.js";
 import { n as refusal } from "./shared-refusal.js";
+import { t as isRecord } from "./shared-json-shape.js";
 import { a as readLedgers, i as measure, n as clearLedgers, r as markPartial, s as shardLedgersDir, t as ROUTES_DIR, u as shouldUpdateSnapshots } from "./shared-ledger.js";
 import { u as parseYamlSource } from "./shared-yaml-document.js";
 import { r as testSettingsAt } from "./shared-test-section.js";

package/dist/shared-session-ledger.js

@@ -1,6 +1,6 @@
 import { t as ServedProcess } from "./shared-serve.js";
-import { t as isRecord } from "./shared-json-shape.js";
 import { n as refusal } from "./shared-refusal.js";
+import { t as isRecord } from "./shared-json-shape.js";
 import { d as VITEST_ARTIFACTS_DIR } from "./shared-artifacts.js";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";

package/dist/shared-specifications.js

@@ -3,7 +3,6 @@ import { basename } from "node:path";
 const SPECIFICATIONS = /* @__PURE__ */ new Set([
 	"api",
 	"cli",
-	"deployment",
 	"integration",
 	"job",
 	"lint",

package/dist/shared-stub-server.js

@@ -97,6 +97,7 @@ async function loadMsw() {
 	};
 }
 let serverInstance = null;
+let registrations = 0;
 let refuseOffTheWire = null;
 function offTheWireError(request) {
 	return new Error(refusal("network-strict-after-first-stub", {
@@ -128,14 +129,26 @@ async function registerStubs(stubs) {
 	const { handlers, refuse, violation } = buildStubHandlers(msw, stubs);
 	server.use(...handlers);
 	refuseOffTheWire = (request) => refuse(offTheWireError(request), `unreadable request ${request.method} ${request.url}`);
+	registrations += 1;
+	let released = false;
 	return {
 		cleanup: () => {
+			if (released) return;
+			released = true;
 			refuseOffTheWire = null;
 			server.resetHandlers();
+			registrations -= 1;
+			if (registrations === 0) closeServer();
 		},
 		violation
 	};
 }
+function closeServer() {
+	if (serverInstance !== null) {
+		serverInstance.close();
+		serverInstance = null;
+	}
+}
 //#endregion
 export { registerStubs };
 

package/dist/shared-testcontainers.adapter.js

@@ -1,5 +1,5 @@
-import { t as isRecord } from "./shared-json-shape.js";
 import { n as refusal, t as invariant } from "./shared-refusal.js";
+import { t as isRecord } from "./shared-json-shape.js";
 import { t as listenedPort } from "./shared-listened-port.js";
 import { t as loadPeer } from "./shared-peer.js";
 import { execSync } from "node:child_process";

package/dist/stubs.js

@@ -1,5 +1,5 @@
-import { t as isRecord } from "./shared-json-shape.js";
 import { n as refusal } from "./shared-refusal.js";
+import { t as isRecord } from "./shared-json-shape.js";
 import { a as defineStubs, d as structuralEquals, f as structuralSubset, i as defineStub, o as describeRoute, r as declared, t as STREAM_BODY, y as CaptureScope } from "./shared-exchange.js";
 //#region src/stubs/kinds/http-filter.ts
 function rawOf(body) {

package/dist/vitest.d.ts

@@ -86,11 +86,6 @@ type ComponentProjectOptions = ComponentOptions & SpecificationProjectOptions;
 /** A component project: renders in a real Chromium; the default `exclude` keeps it out of `specs/`. */
 export declare function component(options: ComponentProjectOptions): Promise<TestProjectInlineConfiguration>;
 //#endregion
-//#region src/specifications/deployment/deployment.project.d.ts
-/** `deployment()`: a running deployment, met over the network through complete HTTP exchanges. */
-type DeploymentProjectOptions = SpecificationProjectOptions;
-export declare function deployment(options?: DeploymentProjectOptions): TestProjectInlineConfiguration;
-//#endregion
 //#region src/specifications/integration/integration.project.d.ts
 /** `integration()`: a module against real services, or against a golden. */
 type IntegrationProjectOptions = InProcessProjectOptions;
@@ -140,5 +135,5 @@ export declare function unit(options?: UnitProjectOptions): TestProjectInlineCon
 //#region src/index.vitest.d.ts
 export declare const vitestConfig: (configUrl: string) => Promise<ViteUserConfig>;
 //#endregion
-export type { ApiProjectOptions, CliProjectOptions, ComponentProjectOptions, DeploymentProjectOptions, InProcessProjectOptions, IntegrationProjectOptions, JobProjectOptions, LintProjectOptions, LiterateDoor, LiterateOptions, LiteratePlugin, MobileProjectOptions, SpecificationProjectOptions, UnitProjectOptions, WebsiteProjectOptions };
+export type { ApiProjectOptions, CliProjectOptions, ComponentProjectOptions, InProcessProjectOptions, IntegrationProjectOptions, JobProjectOptions, LintProjectOptions, LiterateDoor, LiterateOptions, LiteratePlugin, MobileProjectOptions, SpecificationProjectOptions, UnitProjectOptions, WebsiteProjectOptions };
 //# sourceMappingURL=vitest.d.ts.map

package/dist/vitest.js

@@ -1,6 +1,6 @@
 import { r as writeInPlace } from "./shared-in-place.js";
-import { t as isRecord } from "./shared-json-shape.js";
 import { n as refusal$1, t as invariant } from "./shared-refusal.js";
+import { t as isRecord } from "./shared-json-shape.js";
 import { i as renderText, n as literate, o as resolveSpecPath } from "./shared-literate-plugin.js";
 import { u as shouldUpdateSnapshots } from "./shared-ledger.js";
 import { c as REPORTER_OUTPUT_FILES, d as VITEST_ARTIFACTS_DIR, i as COVERAGE_DIR, l as SCREENSHOTS_DIR, n as ATTACHMENTS_DIR, o as MODULE_CACHE_DIR, r as BLOB_DIR, s as NODE_COMPILE_CACHE_DIR, t as ARTIFACTS_DIR } from "./shared-artifacts.js";
@@ -366,11 +366,6 @@ async function component(options) {
 	});
 }
 //#endregion
-//#region src/specifications/deployment/deployment.project.ts
-function deployment(options = {}) {
-	return specificationProject("deployment", options);
-}
-//#endregion
 //#region src/specifications/integration/integration.project.ts
 function integration(options = {}) {
 	return mergeConfig(runnerProject("integration", options), { test: { globalSetup: [servicesSetup()] } });
@@ -509,7 +504,6 @@ const BUILDERS = /* @__PURE__ */ new Map([
 	["job", job],
 	["integration", integration],
 	["website", website],
-	["deployment", deployment],
 	["mobile", mobile],
 	["component", component]
 ]);
@@ -593,6 +587,6 @@ async function derivedFrom(root) {
 }
 const vitestConfig = async (configUrl) => await derivedFrom(dirname(fileURLToPath(configUrl)));
 //#endregion
-export { api, cli, component, deployment, integration, job, lint, literate, mobile, unit, vitestConfig, website };
+export { api, cli, component, integration, job, lint, literate, mobile, unit, vitestConfig, website };
 
 //# sourceMappingURL=vitest.js.map

package/docs/README.md

@@ -22,8 +22,7 @@ The pages follow the package's four export families (what is tested, what surrou
 | [Component specs](guides/component-specs.md)     | A rendered unit in a real Chromium, in its folder's `__tests__/`: the `component` chain |
 | [Website specs](guides/website-specs.md)         | A served page, fetched or driven in a browser: `specification.website()`                |
 | [Mobile specs](guides/mobile-specs.md)           | A native app on an iOS simulator: `specification.mobile()`                              |
-| [Deployment specs](guides/deployment-specs.md)   | A running deployment, one HTTP exchange over the network: `specification.deployment()`  |
-| [API specs](guides/api-specs.md)                 | An HTTP app, in-process, through complete requests: `specification.api()`               |
+| [API specs](guides/api-specs.md)                 | An HTTP app, in-process or deployed at a `url`, through requests: `specification.api()` |
 | [Job specs](guides/job-specs.md)                 | A pipeline triggered by name: `specification.job()`                                     |
 | [CLI specs](guides/cli-specs.md)                 | A binary in a fresh working directory: `specification.cli()`                            |
 | [Spec documents](guides/spec-documents.md)       | A CLI session written as data: the `<case>.spec.yaml` format                            |

package/docs/concepts/architecture.md

@@ -8,20 +8,19 @@ The rules themselves (what they say and why) are [Conventions](conventions.md);
 
 Every specification (the code behind one kind of test) is the same four steps. A **constructor** takes options and returns a **handle**; the handle opens a **chain** of zero or more setups closed by exactly one terminal action; the action executes and resolves to a **typed result**; the result is asserted through vitest's `expect()`. Nothing else is public: there is no imperative escape hatch, because a spec that can do anything proves nothing in particular.
 
-Eight constructors exist and the list is closed (`src/specifications/specification.ts`):
+Seven constructors exist and the list is closed (`src/specifications/specification.ts`):
 
-| Constructor                   | Handle destructures to      | Subject under test                             |
-| ----------------------------- | --------------------------- | ---------------------------------------------- |
-| `specification.api()`         | `{ api, cleanup, docker }`  | An HTTP API, built and served in this process  |
-| `specification.job()`         | `{ job, cleanup }`          | A background pipeline, triggered by name       |
-| `specification.cli()`         | `{ cli, cleanup, docker }`  | A command binary in a fresh temp directory     |
-| `specification.integration()` | `{ integration, cleanup }`  | A module against real services, or a golden    |
-| `specification.website()`     | `{ website, cleanup, url }` | A rendered page, fetched or driven in chromium |
-| `specification.deployment()`  | `{ deployment, cleanup }`   | A running deployment, over the network         |
-| `specification.mobile()`      | `{ mobile, cleanup, udid }` | A native screen on an iOS simulator            |
-| `specification.lint()`        | `{ lint, cleanup }`         | The rules a project ships, over a fixture tree |
+| Constructor                   | Handle destructures to      | Subject under test                                 |
+| ----------------------------- | --------------------------- | -------------------------------------------------- |
+| `specification.api()`         | `{ api, cleanup, docker }`  | An HTTP API, served in this process, or at a `url` |
+| `specification.job()`         | `{ job, cleanup }`          | A background pipeline, triggered by name           |
+| `specification.cli()`         | `{ cli, cleanup, docker }`  | A command binary in a fresh temp directory         |
+| `specification.integration()` | `{ integration, cleanup }`  | A module against real services, or a golden        |
+| `specification.website()`     | `{ website, cleanup, url }` | A rendered page, fetched or driven in chromium     |
+| `specification.mobile()`      | `{ mobile, cleanup, udid }` | A native screen on an iOS simulator                |
+| `specification.lint()`        | `{ lint, cleanup }`         | The rules a project ships, over a fixture tree     |
 
-The asymmetry in that column is the model, not an oversight: `docker` reads a container the subject itself started, and neither a pipeline triggered by name nor a module called in-process is specified by the containers it starts, so `job` and `integration` are handed none; `website` and `mobile` drive a browser and a simulator rather than an orchestrated stack, so they carry neither; and `lint` and `deployment` start nothing at all, their `cleanup` releasing nothing: a deployment is running before the suite and after it, and its exchanges hold a socket for their own length only.
+The asymmetry in that column is the model, not an oversight: `docker` reads a container the subject itself started, and neither a pipeline triggered by name nor a module called in-process is specified by the containers it starts, so `job` and `integration` are handed none; `website` and `mobile` drive a browser and a simulator rather than an orchestrated stack, so they carry neither; and `lint` starts nothing at all, its `cleanup` releasing nothing. An `api` met at a `url` is the same subject on another target ([ADR-022](../decisions/022-a-deployed-api-is-an-api-spec-with-a-url.md)): it starts nothing either, so its handle is `{ api, cleanup }`, and its chain is a second composition of the api specification, `apiDeployedDefinition` in `specifications/api/deployed/deployed.composition.ts`, which offers only what a request over the network can do.
 
 **One specification has no constructor**, and the same reason explains it: a rendered component starts nothing. `component` ([Component specs](../guides/component-specs.md)) is a chain the package exports directly (`component.intercept(...).render(<X />)`), so there is no handle to destructure and no `cleanup` to pass to `afterAll`. What every render of a project shares (the providers, the Vite pipeline, the viewport) is the PROJECT's, stated once by `component()` in `vitest.config.ts`.
 
@@ -29,7 +28,7 @@ A runner is created **once per suite**, in a `*.specification.ts` file, and impo
 
 ### The seam under the chain
 
-A specification's chain is COMPOSED: `src/specifications/<specification>/<specification>.composition.ts` lists the setups (each a `*.capability.ts`) and the terminal actions (each a `*.action.ts`) it is made of and the adapter each one is armed through, `defineSpecification` opens the chain, and every action runs through the one pipeline of `src/chain/perform.ts`. Every specification (`job`, `api`, `website`, `deployment`, `integration`, `cli`, `mobile`, `lint` and `component`) is composed, and there is no other chain. The infrastructure a chain needs is reached through **ports**, each a `*.port.ts` beside the area or the specification that owns it (`database`, `service`, `container`, `isolation` under `src/services/`; `fixture`, `link` under `src/disk/`; `server`, `cli`, `browser`, `device` in their specification), and an adapter implements one. So the chain knows "a database exists"; it never knows Postgres.
+A specification's chain is COMPOSED: `src/specifications/<specification>/<specification>.composition.ts` lists the setups (each a `*.capability.ts`) and the terminal actions (each a `*.action.ts`) it is made of and the adapter each one is armed through, `defineSpecification` opens the chain, and every action runs through the one pipeline of `src/chain/perform.ts`. Every specification (`job`, `api`, `website`, `integration`, `cli`, `mobile` and `component`) is composed, and there is no other chain. The infrastructure a chain needs is reached through **ports**, each a `*.port.ts` beside the area or the specification that owns it (`database`, `service`, `container`, `isolation` under `src/services/`; `fixture`, `link` under `src/disk/`; `server`, `cli`, `browser`, `device` in their specification), and an adapter implements one. So the chain knows "a database exists"; it never knows Postgres.
 
 Every seam is opened lazily rather than imported, and each one is an optional peer loaded by the one module that owns it, so a project that tests no page, no component and no database installs none of them. Which peer each specification and each service needs, and what its refusal says, is [Set up a project § What to install](../start/set-up-a-project.md#what-to-install)'s list; a service's refusal is built by `src/services/peer.ts`, and a specification's by the adapter that loads its peer.
 
@@ -49,7 +48,7 @@ The root reads the sentence of a test. A test opens a **specification** on its s
 | `disk/`           | `chain/`, `lint/kit/`, itself                                                                                                                                                                            | How a test names the disk and what a chain lays on it before its action: `file()` and `directory()` (`spec-path.ts`) and their resolution from the spec file (`resolved-spec-path.ts`), `.fixture()` and `.link()`, their ports and the file-system adapters behind them                                                                                                                                                                                                                                                                                                                 |
 | `clock/`          | `chain/`, `lint/kit/`, itself, `vitest`                                                                                                                                                                  | The pinned clock and `.clock()`, the instant grammar, the process clock adapter                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 | `mocks/`          | `chain/`, `lint/kit/`, itself, `vitest`, `vitest-mock-extended`                                                                                                                                          | `mockOf()`, the one double of a port                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
-| `specifications/` | `chain/`, every notion above, `lint/kit/`, each specification its own library; a specification's project reaches the runner config (`vitest/project`)                                                    | What is tested, one slice per constructor: `<specification>.face.ts` (the names it publishes), `<specification>.composition.ts` (the composition), `<specification>.handle.ts` (the constructor), `<specification>.project.ts` (its Vitest project), and its concept folders (`request/`, `server/`, `routes/`, `documents/`, `render/`, `device/`, `exchange/` ...); the lint specification holds `rule-tester.ts` beside them, `ruleTester()`, the other half of the kit to test a rule; at its root, `specification.ts`, the eight as one record                                      |
+| `specifications/` | `chain/`, every notion above, `lint/kit/`, each specification its own library; a specification's project reaches the runner config (`vitest/project`)                                                    | What is tested, one slice per constructor: `<specification>.face.ts` (the names it publishes), `<specification>.composition.ts` (the composition), `<specification>.handle.ts` (the constructor), `<specification>.project.ts` (its Vitest project), and its concept folders (`request/`, `server/`, `routes/`, `deployed/`, `documents/`, `render/`, `device/` ...); the lint specification holds `rule-tester.ts` beside them, `ruleTester()`, the other half of the kit to test a rule; at its root, `specification.ts`, the seven as one record                                      |
 | `vitest/`         | itself, `chain/`, `lint/kit/`, update mode's setup, `vitest`, never a specification                                                                                                                      | What every Vitest project receives, knowing no specification: `preset.ts` (the root config), `project.ts` (the defaults every project is built on, `specificationProject`) and `unit.project.ts` (`unit()`), which wire the global setups their owners provide and resolve (`expectations/in-place/`, `chain/paths/temp-root`); a specification's own setups (`services/containers/`, `specifications/mobile/session/`) ride on its project                                                                                                                                              |
 | `standard/`       | `@jterrazz/typescript/config`, nothing of the tree                                                                                                                                                       | The defaults of the `test` section, data only: `standard.ts`, which the `test()` preset hands on as written ([`@jterrazz/typescript`'s Configuration § The standard](https://github.com/jterrazz/package-typescript/blob/main/docs/reference/configuration.md#the-standard))                                                                                                                                                                                                                                                                                                             |
 | `lint/`           | itself and `src/standard/`, never the rest of `src/`: `self/` alone reads the product it holds to account                                                                                                | At the root, not under `src/`: the tool-facing channel, laid out below. The layer map names its files `lint/**`, and cruises it beside `src/`                                                                                                                                                                                                                                                                                                                                                                                                                                            |
@@ -102,7 +101,7 @@ The bundle is built by `typescript build`, from the manifest and the names of th
 
 **There are SEVEN entries and no more**: `@jterrazz/test` for what writes a spec (the constructors and their faces, `ruleTester()`, the targets, `match` and the tokens, `clock`, `mockOf()`, `packed()`), `@jterrazz/test/services` for the services a specification starts, `@jterrazz/test/stubs` for what the network replies, `@jterrazz/test/vitest` for the project helpers and the `vitestConfig` the derived `vitest.config.ts` awaits, `@jterrazz/test/oxlint` for the lint plugin, `@jterrazz/test/config` for the `test()` preset a `jterrazz.config.ts` lists, `@jterrazz/test/schema` for an editor validating a `<case>.spec.yaml`. That is rule `no-unpublished-subpath` rather than a convention of taste, and the exemption is derived from the manifest's own `exports` map (the kit's `declaredSubpaths`), so a subpath is exempt the moment it is published and stops being exempt the moment it is withdrawn. A service or a stub imported from the root is rule `service-or-stub-from-its-subpath`, whose fix moves the import: the root then loads no service constructor and no stub builder, though it still carries the startup a specification runs over the services it is handed.
 
-**Each spec entry has two runtimes.** A component test renders in a real browser, and the node entry cannot load there: it imports node builtins at load (`node:fs` and `node:child_process` among them), while the native seams (`pg`, `better-sqlite3`, `testcontainers`) are lazy peers, opened on first use. So `exports["."]`, `exports["./services"]` and `exports["./stubs"]` each carry a `browser` condition, resolving to `dist/browser/index.js`, `dist/browser/services.js` and `dist/browser/stubs.js`: the same public surface, built for a page, where every node-only name (the eight constructors, `ruleTester()`, the services, the docker accessors, the results that walk a disk) is a stub that throws where it was called, naming the specification and saying it runs under node. The split is the RUNTIME's and never the specifications': one specifier per entry, so no spec has to remember which build it may import.
+**Each spec entry has two runtimes.** A component test renders in a real browser, and the node entry cannot load there: it imports node builtins at load (`node:fs` and `node:child_process` among them), while the native seams (`pg`, `better-sqlite3`, `testcontainers`) are lazy peers, opened on first use. So `exports["."]`, `exports["./services"]` and `exports["./stubs"]` each carry a `browser` condition, resolving to `dist/browser/index.js`, `dist/browser/services.js` and `dist/browser/stubs.js`: the same public surface, built for a page, where every node-only name (the seven constructors, `ruleTester()`, the services, the docker accessors, the results that walk a disk) is a stub that throws where it was called, naming the specification and saying it runs under node. The split is the RUNTIME's and never the specifications': one specifier per entry, so no spec has to remember which build it may import.
 
 `types` is stated once, and it is the node build's, so the two runtimes are ONE type surface. Each page entry takes its types from its node entry (`export type *`), so they cannot drift, and `specs/cli/node/names.spec.ts`, over the packed tarball, records every build's names and fails a value a page build lacks. The check runs that one way: a page build may carry a value its node build does not export, and the names it records show which.
 
@@ -111,7 +110,7 @@ The API is the types the package publishes, and nothing re-states it. What the c
 ## Pitfalls
 
 - **Reaching for a dependency from `chain/`.** A new external package belongs to the ONE slice that needs it (a notion (`stubs/`, `services/` ...) or a specification) and nowhere else. Only a library every layer truly shares sits behind the chain, in the one folder `FRAMEWORK_LAYERS` grants it to: vitest's test hooks in `paths/`; the `yaml` library and the toolchain's config types sit in `lint/kit/project/`, which the chain reaches. Anything else the chain imports is the boundary this package cannot afford to blur, and the layer map and the library-ownership rules refuse it.
-- **Adding a ninth constructor.** The eight are the closed vocabulary the conventions, the linter and the documentation are all shaped around. A new SUBJECT to specify is a design decision, and it earns a record in [`decisions/`](../decisions/) before it earns a constructor, as `integration` did in [ADR-004](../decisions/004-a-module-against-real-services-or-a-golden-is-the-integration-specification.md), `lint` in [ADR-015](../decisions/015-a-rule-a-project-ships-is-the-lint-specification.md) and `deployment` in [ADR-022](../decisions/022-a-running-deployment-is-the-deployment-specification.md).
+- **Adding an eighth constructor.** The seven are the closed vocabulary the conventions, the linter and the documentation are all shaped around. A new SUBJECT to specify is a design decision, and it earns a record in [`decisions/`](../decisions/) before it earns a constructor, as `integration` did in [ADR-004](../decisions/004-a-module-against-real-services-or-a-golden-is-the-integration-specification.md) and `lint` in [ADR-015](../decisions/015-a-rule-a-project-ships-is-the-lint-specification.md).
 - **Writing a rule's normative sentence into a chapter.** It belongs in `lint/consumer/catalogue/manifest.json` beside the implementation; a chapter that restates it is the second copy the whole design exists to prevent.
 
 ## Related

package/docs/concepts/conventions.md

@@ -166,9 +166,9 @@ Two more hold what each path says. **The verb and the folder agree**: `seed()` r
 
 | Thing           | Rule                                                                                                                                                                                                                                                                                                                                                                                                                                               |
 | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Specs root      | `specs/` (`api/`, `job/`, `cli/`, `integration/`, `website/`, `deployment/`, `mobile/`, `lint/`): one folder per constructor, beside the special folders of what the specifications share: `__setup__/`, `__fixtures__/`, `__seeds__/`, `__requests__/`, `__expected__/`, and any repository suite ([the third door](#the-third-door-a-repository-suite))                                                                                          |
+| Specs root      | `specs/` (`api/`, `job/`, `cli/`, `integration/`, `website/`, `mobile/`, `lint/`): one folder per constructor, beside the special folders of what the specifications share: `__setup__/`, `__fixtures__/`, `__seeds__/`, `__requests__/`, `__expected__/`, and any repository suite ([the third door](#the-third-door-a-repository-suite))                                                                                                         |
 | Specification   | `specs/<specification>/<name>.specification.ts` (at the specification root)                                                                                                                                                                                                                                                                                                                                                                        |
-| Instances       | `api`, `job`, `cli`, `integration`, `website`, `deployment`, `mobile`, `lint`, enforced by the destructuring (`no-runner-alias`)                                                                                                                                                                                                                                                                                                                   |
+| Instances       | `api`, `job`, `cli`, `integration`, `website`, `mobile`, `lint`, enforced by the destructuring (`no-runner-alias`)                                                                                                                                                                                                                                                                                                                                 |
 | Spec file       | `specs/<specification>/<subject>/<aspect>.spec.ts`, the assembled product's word (`file-suffix-matches-place`); the subject's folder derived where the specification has one ([One file, one subject](#one-file-one-subject))                                                                                                                                                                                                                      |
 | Spec document   | `<case>.spec.yaml`, beside the spec it belongs to, never under `__expected__/` ([Spec documents](../guides/spec-documents.md))                                                                                                                                                                                                                                                                                                                     |
 | Module test     | `__tests__/<file>.test.ts`, in the folder of `<file>.ts` (under `src/`)                                                                                                                                                                                                                                                                                                                                                                            |