@gfdelarue/testkit 0.5.0 → 0.6.0

package/README.md

@@ -43,8 +43,9 @@ npm run testkit
 
 The command exits zero only when at least one test file completed and every
 required file passed. Test failures, infrastructure failures, interrupted or
-not-run files, an all-skipped selection, and an empty selection all fail the
-gate. `npm run testkit -- --allow-empty` is an explicit escape hatch for a job
+not-run files, a skipped file, and an empty selection all fail the gate. A file
+that a `skip` rule or its own `skip` metadata skips fails the gate even when
+every other file passes, and `--allow-empty` doesn't change that. `npm run testkit -- --allow-empty` is an explicit escape hatch for a job
 whose empty selection is intentional; it should not be the default CI command.
 
 Testkit writes the immutable, verifiable run bundle under
@@ -264,8 +265,7 @@ the report to the chosen platform.
 
 Testkit has two built-in engines:
 
-- `node-vitest` runs plain Vitest test files and purpose-built `data` and
-  `contract` files with Node and Vitest.
+- `node-vitest` runs plain Vitest test files with Node and Vitest.
 - `playwright` runs `ui` files with Playwright and managed Chromium.
 
 A plain Vitest test file needs no Testkit suffix, directory, metadata, or
@@ -301,9 +301,8 @@ versions and `tsconfig.playwright.json`.
 Testkit bounds the output it captures from each command it runs, and asks the
 command and its descendants to stop on cancellation or timeout.
 
-Managed task environment is engine input. Node/Vitest data and contract callbacks
-read immutable, enumerable `context.env`; and Playwright suites can read the
-same contract from `readPlaywrightContext()?.env`. Managed Node processes also
+Managed task environment is engine input. Playwright suites read it from
+`readPlaywrightContext()?.env`. Managed Node processes also
 expose each value as an immutable, non-enumerable `process.env.KEY` property so
 libraries that read `process.env` directly see it, but non-Node child processes
 do not receive consumer values unless the suite explicitly passes them.
@@ -318,7 +317,9 @@ reserves `APPDATA`, `ComSpec`, `HOME`, `LANG`, `LC_ALL`, `LOCALAPPDATA`, `PATH`,
   keys it sets itself, listed in
   [Environment](docs/engines.md#environment);
   other `TESTKIT_` and `VITEST_` keys, such as
-  `TESTKIT_REQUIRE_COMPLETE_SUITE`, pass through;
+  `TESTKIT_REQUIRE_COMPLETE_SUITE`, pass through, though Vitest's own `TEST`,
+  `VITEST`, `VITEST_MODE`, `FORCE_TTY`, `MODE`, `DEV`, `PROD`, and `SSR`
+  replace a group's values;
 - Playwright reserves the `TESTKIT_`, `PLAYWRIGHT_`, `PWTEST_`, and `PW_TEST_`
   prefixes plus `BASE_URL`, `FORCE_COLOR`, `NODE_OPTIONS`, and `NO_COLOR`.
 
@@ -344,12 +345,10 @@ npx @gfdelarue/testkit discover --json > .testkit/discovery.json
 npx @gfdelarue/testkit discover --output .testkit/discovery.json
 
 # Filter by type
-npx @gfdelarue/testkit --type contract
-npx @gfdelarue/testkit --type data
-npx @gfdelarue/testkit --type contract,data
 npx @gfdelarue/testkit --type ui
+npx @gfdelarue/testkit --type plain
 
-# Parallel file execution
+# Run up to 8 test tasks at once
 npx @gfdelarue/testkit --task-concurrency 8
 
 # One file-level wall clock budget for every suite file
@@ -357,15 +356,16 @@ npx @gfdelarue/testkit --file-timeout-seconds 60
 
 # Specific group / suite
 npx @gfdelarue/testkit --group frontend --type ui -s navigation
-npx @gfdelarue/testkit --group api --type contract -s health
-npx @gfdelarue/testkit --type contract,data -s contract:queries
+npx @gfdelarue/testkit --group api -s health
+npx @gfdelarue/testkit --group api --type plain
+npx @gfdelarue/testkit --type ui -s ui:checkout
 
 # Exact file
-npx @gfdelarue/testkit --type contract --file __testkit__/health.contract.testkit.ts
+npx @gfdelarue/testkit --type ui --file __testkit__/checkout.ui.testkit.ts
 npx @gfdelarue/testkit run --file src/sum.test.ts
 
 # Temporarily ignore repo-declared skip rules
-npx @gfdelarue/testkit --ignore-skip-rules --file __testkit__/billing.contract.testkit.ts
+npx @gfdelarue/testkit --ignore-skip-rules --file src/billing.test.ts
 
 # Lifecycle
 npx @gfdelarue/testkit status
@@ -380,15 +380,15 @@ npx @gfdelarue/testkit db schema refresh --service api
 npx @gfdelarue/testkit db schema verify --service api
 ```
 
-A `--type` that names test types, such as `--type contract,ui`, and typed suite
-selectors such as `contract:health` select typed files only. A run without them, or
-with `--type all`, also runs plain Vitest test files. To run every typed file
-and no plain one, name all three types: `--type ui,contract,data`.
+`--type ui` and typed suite selectors such as `ui:checkout` select typed files
+only. `--type plain` selects plain Vitest test files only. A run without
+`--type`, or with `--type all`, runs both. `--type` narrows the other filters,
+so `--group api --type plain` runs the `api` group's plain files and none of its
+UI files.
 
-`run`, `discover`, `artifacts`, and `workspace` select test groups with
-`--group`. On those commands `--service` is a deprecated alias for `--group`
-and prints a notice on stderr. `status`, `destroy`, `cleanup`, and `db schema`
-take `--service` to name a service.
+`run`, `discover`, `artifacts`, `workspace`, and `typecheck` select test groups
+with `--group`. `status`, `destroy`, `cleanup`, and `db schema` take `--service`
+to name a service.
 
 Database cleanup is scoped to the selected product. `cleanup --resources --global`
 is retired; use `--dir <product> cleanup --resources` for each product. After
@@ -396,8 +396,11 @@ deleting a product directory, remove its orphaned containers and volumes
 explicitly through Docker.
 
 Use `execution.taskConcurrency` in config and `--task-concurrency` on the CLI.
-`execution.workers`, `presets.nodeNext({ workers })` and `--workers` remain
-deprecated aliases through 0.2.x and will be removed in 0.3.0. When both names are
+A task is a typed file, a batch of typed files, or one Vitest invocation of
+plain files. Plain files in one invocation run with Vitest's file parallelism,
+which `taskConcurrency` doesn't limit.
+`execution.workers`, `presets.nodeNext({ workers })` and `--workers` are
+deprecated aliases. When both names are
 provided in config or on the CLI, their values must match. The CLI value overrides
 config after those checks. See the [execution settings](testkit-config-schema.md#execution).
 
@@ -682,15 +685,10 @@ A file can also name `locks`.
 one.
 
 In a typed file, the engine value is a required literal. The supported public
-authoring paths
-are `@gfdelarue/testkit/node-vitest/data`,
-`@gfdelarue/testkit/node-vitest/contract`, and `@gfdelarue/testkit/playwright`.
-Node/Vitest and Playwright suites may also import exact public APIs directly
-from Testkit's managed `vitest`, `@playwright/test`, `playwright`, and
-`playwright-core` packages.
-There are no legacy aliases or implicit-runner compatibility paths. A typed
-Node/Vitest file resolves `paths` from its nearest `tsconfig.json`, through
-Vite's `resolve.tsconfigPaths`.
+authoring path is `@gfdelarue/testkit/playwright`. Playwright suites may also
+import exact public APIs directly from Testkit's managed `@playwright/test`,
+`playwright`, and `playwright-core` packages.
+There are no legacy aliases or implicit-runner compatibility paths.
 
 `testkit.config.ts` is optional. Without it, Testkit runs every test file with
 zero setup: it starts no server, provisions no database, and loads no `.env`
@@ -727,7 +725,8 @@ setup processes, so set it deliberately.
 Testkit-owned Docker resources are labelled at creation time so they can be
 found again even if product-local `.testkit` state is deleted. `testkit destroy`
 removes labelled resources for the current product after service state is
-destroyed. `testkit cleanup --resources` cleans stale resources for the current
+destroyed. It leaves run results under `.testkit/results` and other files
+under `.testkit`, such as the compiled config and timings, in place. `testkit cleanup --resources` cleans stale resources for the current
 product. Both commands remove only the current product's resources and leave
 other products' alone, including their idle caches. Host-local Postgres data
 lives in a Testkit-labelled named Docker volume, so cleanup can find and remove
@@ -1016,14 +1015,14 @@ something its environment prepared. Today that is an HTTP capture, which a
 The handle is named after the capture's `id`:
 
 ```js
-// tests/webhook.contract.testkit.setup.mjs
+// tests/webhook.test.setup.mjs
 export async function setup({ sidecars }) {
   await sidecars.httpCapture({ id: "webhook", path: "/webhook" });
 }
 ```
 
 ```ts
-// tests/webhook.contract.testkit.ts
+// tests/webhook.test.ts
 import { handle } from "@gfdelarue/testkit/environment";
 
 const webhook = handle("webhook");
@@ -1077,19 +1076,20 @@ test, in any order.
 
 ```ts
 import { randomUUID } from "node:crypto";
-import { defineFile } from "@gfdelarue/testkit";
-import { contractScenario } from "@gfdelarue/testkit/node-vitest/contract";
-import { expect, onTestFinished } from "vitest";
+import { endpoint } from "@gfdelarue/testkit/environment";
+import { expect, onTestFinished, test } from "vitest";
 
 import { sandbox } from "../payments-sandbox.js";
 
-export const testkit = defineFile({ engine: "node-vitest" });
-
-contractScenario("a refund reaches the sandbox customer", async ({ http }) => {
+test("a refund reaches the sandbox customer", async () => {
   const customer = await sandbox.createCustomer({ email: `refund-${randomUUID()}@example.test` });
   onTestFinished(() => sandbox.deleteCustomer(customer.id));
 
-  const response = await http().post("/api/refunds", { customerId: customer.id, amountCents: 500 });
+  const response = await fetch(new URL("/api/refunds", endpoint("api")), {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ customerId: customer.id, amountCents: 500 }),
+  });
   expect(response.status).toBe(201);
 });
 ```
@@ -1131,12 +1131,12 @@ export const testkit = defineFile({ engine: "node-vitest", locks: ["payments-san
 
 ### Node setup beside a test
 
-A test such as `tests/webhook.contract.testkit.ts` can have a sibling
-`tests/webhook.contract.testkit.setup.mjs`. Testkit runs its named `setup` export,
-or its default export, before starting the test engine:
+A test such as `tests/webhook.test.ts` can have a sibling
+`tests/webhook.test.setup.mjs`. Testkit runs its named `setup` export, or its
+default export, before starting the test engine:
 
 ```js
-// tests/webhook.contract.testkit.setup.mjs
+// tests/webhook.test.setup.mjs
 export async function setup({ sidecars }) {
   const capture = await sidecars.httpCapture({ path: "/webhook" });
   return {
@@ -1148,7 +1148,8 @@ export async function setup({ sidecars }) {
 Setup is part of preparing the file's environment. Testkit runs it once, after
 it acquires the services the file's group uses and before the test engine
 starts. Testkit never batches a Playwright file that has setup with other
-Playwright files. Files without setup still batch.
+Playwright files, and a plain Vitest file that has setup runs in its own Vitest
+invocation. Files without setup still batch.
 
 Setup runs with its own JavaScript state. It can use Node APIs, prepare
 external resources, and start HTTP capture listeners. Tests
@@ -1165,7 +1166,9 @@ setup modules. Its tests receive the environment file's `setupData` instead.
 
 Return plain JSON, or `{ data, cleanup }` with an optional cleanup function.
 Testkit passes the data to the engine as `setupData` and records it with the
-setup module path and sidecar handles. Bare `null` or `undefined`, and a
+setup module path and sidecar handles. Tests read it with `setupData()` from
+`@gfdelarue/testkit/environment`, which returns `{}` when the file has no setup
+module and throws outside a Testkit run. Bare `null` or `undefined`, and a
 cleanup-only result, give empty data. `{ data: null }` preserves `null`.
 Data must encode to at most 1 MiB of JSON. Invalid data reports its JSON path,
 such as `$.items[1]`.
@@ -1189,15 +1192,55 @@ most 256 connections.
 
 Discovery tries sibling `.setup.mjs`, sibling `.setup.js`, then the matching
 `.mjs` and `.js` files in `__setup__`, in that order. For the example above,
-the fallback is `tests/__setup__/webhook.contract.testkit.mjs`.
+the fallback is `tests/__setup__/webhook.test.mjs`.
 
 ### HTTP and persistence checks
 
 Use plain Vitest files for ordinary HTTP, service, and database checks. Read
 configured URLs with `endpoint(name)` and `database(name)` from
 `@gfdelarue/testkit/environment`, then use `fetch` or your application's
-database client. Use `contractScenario` when a typed contract file needs the
-managed contract context. Use `dataScenario` for structured data-flow evidence.
+database client.
+
+### Record data-flow evidence
+
+`dataFlow(context)` from `@gfdelarue/testkit/node-vitest/data` records what a
+plain Vitest test sees data do: metrics, counts, bytes, durations, money,
+ratios, sequences, records, actors, systems, transitions, events, findings,
+external calls, and cache, LLM, and RPC usage. Budgets check the recorded
+values, for example that a metric stays under a limit or that a sequence was
+recorded.
+
+```ts
+import { endpoint } from "@gfdelarue/testkit/environment";
+import { dataFlow } from "@gfdelarue/testkit/node-vitest/data";
+import { test } from "vitest";
+
+test("lists one page of orders", async (context) => {
+  const flow = dataFlow(context);
+  const response = await fetch(`${endpoint("api")}/orders?page=1`);
+  const body = await response.text();
+  flow.recordHttpRequest({
+    method: "GET",
+    path: "/orders",
+    status: response.status,
+    responseBytes: Buffer.byteLength(body),
+  });
+  flow.expectMetric("http.response.bytes").atMost(64_000);
+});
+```
+
+- `dataFlow` needs the context of a running test. Every call in one attempt
+  returns the same recorder, and a call without that context throws.
+- The library reads no URL, environment value, fixture file, or Testkit config.
+  Read named URLs from `@gfdelarue/testkit/environment`, log in from test code,
+  and read files with `fs`.
+- A failed budget fails its test when the test finishes. The failure detail has
+  the kind `data-flow-budget` and a key made of the test's full title and the
+  budget.
+- Testkit writes `data-flow.json` and `data-flow.md` for a file whose tests
+  recorded something. Each such test is one scenario, from its final attempt. A
+  test that records nothing adds nothing, and a file whose tests record
+  nothing gets no data-flow artifacts.
 
 ## Discovery
 
@@ -1228,24 +1271,26 @@ Testkit supports Vitest 4.x. Another major, a broken installation, a root
 Vitest config that fails to load, or a Vitest that `package.json` declares but
 that is not installed fails before any test runs, naming the version and path.
 `--vitest-runner managed` avoids the repository's Vitest. A run that selects
-only typed files, with `--type` or with typed `--file` paths, `bug record` or
+only typed files, with `--type ui` or with typed `--file` paths, `bug record` or
 `bug file` for a typed test, and the commands that select no tests (`status`,
 `run status`, `doctor`, `destroy`, `cleanup`, and `db schema`) don't load the
 repository's Vitest, so they still work. A product that neither installs nor
 declares Vitest has no plain test files.
 
-All plain files in a run go to one Vitest invocation, so root global setup,
-teardown, and the repository's reporters run as often as they do under
-`vitest run`, and Testkit's reporter runs beside them. The invocation's deadline
-is the sum of its files' timeouts; Vitest's own test and hook timeouts apply
-inside it. A file that two projects select runs in both, its result combines
-both runs, and its evidence names each run's project. Files from different
-groups run together when their groups give them the same services, values, and
-locks; none may have a setup module or isolation other than `shared`.
-Otherwise the run stops before any file runs and names the groups and what
-differs. Services, locks, isolation, or a setup module stop it before Testkit
-provisions anything; values stop it before Vitest starts. Select one group with
-`--group`.
+Plain files run in one Vitest invocation per environment their groups give them.
+Groups that give their files the same values share one, such as `root` and the
+other groups that use no services. A group that uses a service Testkit starts
+gets an invocation of its own.
+Inside each invocation, root global setup, teardown, and the repository's
+reporters run as they do under `vitest run`, and Testkit's reporter runs beside
+them, so a run calls them once for each invocation. An invocation's deadline is
+the sum of its files' timeouts; Vitest's own test and hook timeouts apply inside
+it. A file that two projects select runs in both, its result combines both
+runs, and its evidence names each run's project. A file with a setup module,
+locks, or isolation other than `shared` runs in its own Vitest invocation with
+its own environment. Invocations run one after another unless
+`--task-concurrency` or `execution.taskConcurrency` is above 1. To run one group's
+files alone, select it with `--group`.
 
 Plain files see the host environment Testkit started with: `HOME`, `PATH`,
 temporary and XDG directories, locale, `CI`, `FORCE_COLOR`, `NO_COLOR`, and any
@@ -1259,14 +1304,21 @@ shell's environment and the group's values; as under `vitest run`, Vitest sets
 `TEST`, `VITEST`, and `NODE_ENV` after them. `--vitest-runner managed` leaves the
 shell's `NODE_OPTIONS` out.
 
+When Vitest detects a coding agent from the environment, such as `CLAUDECODE`,
+`AI_AGENT`, or `CURSOR_AGENT`, and the repository's Vitest config names no
+reporter, Vitest uses its agent reporter. That reporter prints no console output
+from a passing test, so the output is missing from the file's
+`node-vitest-stdout` artifact. A failing test's output still appears. Name a
+reporter in the Vitest config, such as `reporters: ["default"]`, to keep it.
+
 Two settings narrow the files Vitest selects: `discovery.exclude` in `testkit.config.ts`, and
 a declared group's `exclude`. Testkit's built-in exclusions for typed files,
-such as `dist`, `build`, and `coverage`, `discovery.roots`, and a legacy
-service's exclusions do not apply to plain files.
+such as `dist`, `build`, and `coverage`, and `discovery.roots` do not apply to
+plain files.
 
 A plain file belongs to the group whose roots contain it, or to the implicit
-`root` group, which uses no service. Legacy service ownership never claims a
-plain file. Testkit starts no service for a plain file in `root`.
+`root` group, which uses no service. Testkit starts no service for a plain
+file in `root`.
 
 The plain files in one directory form a suite named after that directory,
 relative to the group's root. In `root`, `--suite src` selects
@@ -1275,7 +1327,10 @@ its own suite, so `sum.test.ts` in a group rooted at `src` is in suite `sum`.
 When two suites in a group would share a name, Testkit lengthens the later
 ones with parent directories, such as `api-src`, and numbers them if that is
 not enough. `testkit typecheck` checks plain TypeScript test files and skips
-plain JavaScript ones, as `tsc` does without `allowJs`.
+plain JavaScript ones, as `tsc` does without `allowJs`. It adds the TypeScript
+files in each Vitest project's `setupFiles` to the program, so a test can use
+the matchers a setup file declares, such as those from
+`@testing-library/jest-dom/vitest`.
 
 ### Typed suites
 
@@ -1308,16 +1363,9 @@ production owner when a narrower owner exists.
 
 Concrete layouts:
 
-- `src/api/routes/__testkit__/auth-me.contract.testkit.ts`
-- `src/db/__testkit__/sessions-count-type.contract.testkit.ts`
 - `frontend/src/components/layout/__testkit__/navigation.ui.testkit.ts`
-- `src/internal/handler/repos/__testkit__/crud.contract.testkit.ts`
-
-`testkit` uses these suffixes automatically:
 
-- `*.contract.testkit.ts`
-- `*.data.testkit.ts`
-- `*.ui.testkit.ts`
+`testkit` uses the `*.ui.testkit.ts` suffix automatically.
 
 The suffix never chooses an engine. Each discovered typed file must also
 contain one root-package `defineFile(...)` declaration with a supported literal
@@ -1326,29 +1374,6 @@ Unsupported pairs fail discovery; for example, a `*.ui.testkit.ts` file cannot
 declare `engine: "node-vitest"`.
 
 See [docs/test-types.md](docs/test-types.md) for the canonical type model.
-`*.contract.testkit.ts` files are Node-backed service/runtime contract suites.
-They use `contractScenario(...)` from
-`@gfdelarue/testkit/node-vitest/contract`, declare `engine: "node-vitest"`, and run
-through the `node-vitest-contract` profile for checks that need Node APIs but
-are not data-flow evidence suites. They are native Vitest suites:
-`contractScenario(...)` is the managed-context convenience, while direct public
-Vitest runner APIs remain valid for behavior such as `test.skip(...)` and
-`test.todo(...)`.
-
-`*.data.testkit.ts` files are Testkit data-flow/data-contract suites, not raw
-Vitest files with a Testkit suffix. They must use `dataScenario(...)` from
-`@gfdelarue/testkit/node-vitest/data`, declare `engine: "node-vitest"`, and record
-structured data-flow evidence through the data context. Supporting
-`count(...)`/`event(...)` calls are not enough by themselves; model actors,
-systems, records, transitions, external calls, payloads, budgets, cache/LLM/RPC
-usage, or reconciliation evidence. Data suites run through the
-`node-vitest-data` profile. Use a plain Vitest test file for plain Node
-assertions and HTTP or database integration, `contract` for typed service or
-protocol contracts, and `ui` when a browser is part of the assertion.
-Data suites use Vitest directly for assertions, hooks, and mocking.
-`dataScenario(...)` owns case registration: `testkit lint` reports native
-registration imports in data suites, and the data runner rejects any case that
-was not registered through the DSL.
 
 Test groups own test files by directory. Declare them under `groups` in
 `testkit.config.ts`. Each group lists its repo-relative `roots` and the services
@@ -1380,16 +1405,17 @@ export default defineConfig({
 - `skip`, `requirements`, and `runtimeIsolation` are group fields. See the
   [config reference](testkit-config-schema.md#groups).
 
-A config with `services` and no `groups` key uses legacy ownership. Each
-service owns the typed test files under its `local.cwd` and
-`discovery.roots`, as a group of the same name that uses that service. Testkit
-prints a notice on stderr when legacy ownership gives a file to a service.
-Legacy ownership will be removed; declare `groups` instead.
+Services own no test files. A config with `services` and no `groups` key
+fails to load when a service's `local.cwd` or `discovery.roots` holds a typed
+test file, which that service owned before 0.6.0. The error lists the `groups`
+entries that keep those files with their services. `status`, `destroy`,
+`cleanup`, and `db schema` still run on it. Otherwise every file belongs to
+`root`.
 
 Suite names are inferred from the colocated path:
 
-- `auth/__testkit__/*.contract.testkit.ts` => `auth`
-- `routes/__testkit__/auth-me.contract.testkit.ts` => `routes`
+- `auth/__testkit__/*.ui.testkit.ts` => `auth`
+- `routes/__testkit__/checkout.ui.testkit.ts` => `routes`
 
 Discovery is also a first-class CLI/API surface:
 

package/dist/app/bugs/draft.js

@@ -1,4 +1,4 @@
 import G from"node:crypto";import A from"node:path";import{isPublicTestType as j}from"../../domain/identifiers.js";import{isUnknownRecord as g}from"../../kernel/unknown-values.js";import{BUG_CATCHERS as O,BUG_CAUSES as P,BUG_CONFIDENCES as C,BUG_ESCAPES as U,BUG_IMPACTS as F,BUG_SEVERITIES as R,categoryIds as _,isOneOf as E}from"./categories.js";import{BUG_FACTS_TEST_TYPES as z,decodeFaultLines as D,isCommitId as $}from"./facts.js";import{redactBugText as B}from"../../tracker/redaction.js";import{isTimestamp as w}from"../campaigns/campaign.js";export const BUG_DRAFT_SCHEMA_VERSION=1,BUG_TITLE_MAX_LENGTH=200,BUG_SECTION_MAX_LENGTH=12e3;const V=48,L=/^[a-z0-9]+(?:-[a-z0-9]+)*$/u;export const CAMPAIGN_ID_MAX_LENGTH=60;export class BugRecordError extends Error{problems;constructor(e,n){super(`${e}:
 ${n.map(s=>`- ${s}`).join(`
-`)}`),this.name="BugRecordError",this.problems=n}}export function isCampaignId(t){return typeof t=="string"&&t.length<=CAMPAIGN_ID_MAX_LENGTH&&L.test(t)}export function testTypeOfFile(t){const e=/\.([a-z0-9]+)\.testkit\.ts$/u.exec(t)?.[1];return j(e)?e:null}function M(t){const e=/\.([a-z0-9]+)\.testkit\.ts$/u.exec(t)?.[1];return z.find(n=>n===e)??null}export function toRepositoryPath(t,e){const n=e.replaceAll("\\","/");if(n.startsWith("/")||/^[a-z]:/iu.test(n))return null;const s=A.posix.normalize(A.posix.join(t,n));return s==="."||s===".."||s.startsWith("../")?null:s}export function toProductPath(t,e){return t===""?e:A.posix.relative(t,e)}export function readBugReport(t,e){if(!g(t))throw new BugRecordError("The bug record is invalid",["it must be a JSON object"]);const n=[],s=[],u=I(t,n,{path:r=>toRepositoryPath(e,r),text:(r,d)=>{const a=B(r);return a!==r&&s.push(d),a}});if(n.length>0)throw new BugRecordError("The bug record is invalid",n);return{redactedFields:s,report:u}}export function createBugDraft(t,e){const n=testTypeOfFile(t.test.file);return{schemaVersion:BUG_DRAFT_SCHEMA_VERSION,id:bugDraftId(t),recordedAt:e.recordedAt.toISOString(),recordedCommit:e.recordedCommit,productPath:e.productPath,caughtBy:e.campaign===null?"manual":"campaign",...e.campaign===null?{}:{campaign:e.campaign},...n===null?{}:{testType:n},...e.vitest===void 0?{}:{vitest:e.vitest},...t}}export function requireOneVitestProject(t,e,n){if(e.length<2||n.project!==null)return;const s=e.map(({project:u})=>JSON.stringify(u)).join(", ");throw new Error(`test.file ${t} runs in the Vitest projects ${s}. Name the one whose run fails with --vitest-project.`)}export function readBugDraft(t){const e="The bug draft is unreadable";if(!g(t))throw new BugRecordError(e,["it must be a JSON object"]);if(t.schemaVersion!==BUG_DRAFT_SCHEMA_VERSION)throw new BugRecordError(e,[`unknown schemaVersion ${JSON.stringify(t.schemaVersion)}`]);const n=[],s=(p,b,y,x)=>b(p)?p:(n.push(x),y),u=I(t,n,{path:p=>toRepositoryPath("",p),text:p=>p}),r=M(u.test.file);t.testType!==(r??void 0)&&n.push(r===null?"testType must be absent for a test file without a type":"testType does not match test.file");const d=s(t.caughtBy,J,"manual","caughtBy must be campaign or manual"),a=s(t.campaign,k,void 0,"campaign must be a campaign id");d==="campaign"!=(a!==void 0)&&n.push("campaign must be present when caughtBy is campaign and absent otherwise");const T={schemaVersion:BUG_DRAFT_SCHEMA_VERSION,id:s(t.id,isBugDraftId,"","id is not a draft id"),recordedAt:s(t.recordedAt,w,"","recordedAt must be a timestamp"),recordedCommit:s(t.recordedCommit,$,"","recordedCommit must be a full commit id"),productPath:s(t.productPath,N,"","productPath must be a string"),caughtBy:d,...a===void 0?{}:{campaign:a},...r===null?{}:{testType:r},...t.vitest===void 0?{}:{vitest:s(t.vitest,X,{},"vitest must hold runner, config and project text")},...u,...t.filed===void 0?{}:{filed:H(t.filed,n)}};if(n.length>0)throw new BugRecordError(e,n);return T}export function bugDraftId(t){const e=t.title.normalize("NFKD").replace(/\p{M}+/gu,"").toLowerCase().replace(/[^a-z0-9]+/gu,"-").slice(0,V).replace(/^-+|-+$/gu,""),n=G.createHash("sha256").update(`${t.test.file}
-${t.test.title}`).digest("hex");return`${e||"bug"}-${n.slice(0,8)}`}export function isBugDraftId(t){return typeof t=="string"&&/^[a-z0-9]+(?:-[a-z0-9]+)*-[0-9a-f]{8}$/u.test(t)}export function namesSameTest(t,e){return t.test.file===e.test.file&&t.test.title===e.test.title}function I(t,e,n){const s=(i,o,c,f)=>{const m=i[o];if(typeof m!="string"||m.trim().length===0)return e.push(`${c} must be a non-empty string`),"";const h=m.trim(),l=h.length>f?h:n.text(h,c);return l.length>f&&e.push(`${c} must be at most ${String(f)} characters`),l},u=(i,o,c)=>{const f=i[o],m=typeof f=="string"?f.trim():"",h=m.length>0?n.path(m):null;return h===null?e.push(`${c} must be a path inside the repository`):[m,h].some(l=>B(l)!==l)&&e.push(`${c} is a path that holds text Testkit redacts as a secret`),h??""},r=(i,o,c)=>E(i,o)?o:(e.push(`${c} must be one of ${i.join(", ")}`),i[0]),d=i=>{const o=t[i];return g(o)?o:(e.push(`${i} must be an object`),{})},a=(i,o,c)=>{const f=s(i,o,c,BUG_TITLE_MAX_LENGTH);return/[\r\n]/u.test(f)&&e.push(`${c} must be one line`),f},T=a(t,"title","title"),p=d("test"),b=d("fault"),y=d("confidence"),x=u(p,"file","test.file");let S=[1,1];try{S=D(b.lines)}catch(i){e.push(i instanceof Error?i.message:"fault.lines is invalid")}return{title:T,severity:r(R,t.severity,"severity"),expected:s(t,"expected","expected",BUG_SECTION_MAX_LENGTH),authority:s(t,"authority","authority",BUG_SECTION_MAX_LENGTH),observed:s(t,"observed","observed",BUG_SECTION_MAX_LENGTH),rootCause:s(t,"rootCause","rootCause",BUG_SECTION_MAX_LENGTH),test:{file:x,title:a(p,"title","test.title")},fault:{lines:S,path:u(b,"path","fault.path")},cause:r(_(P),t.cause,"cause"),impact:r(_(F),t.impact,"impact"),confidence:{cause:r(C,y.cause,"confidence.cause"),impact:r(C,y.impact,"confidence.impact")},escape:r(_(U),t.escape,"escape")}}function H(t,e){return g(t)&&w(t.filedAt)&&$(t.foundAt)&&typeof t.number=="number"&&Number.isSafeInteger(t.number)&&t.number>=1&&typeof t.url=="string"?{filedAt:t.filedAt,foundAt:t.foundAt,number:t.number,url:t.url}:(e.push("filed must hold filedAt, foundAt, number, and url"),{filedAt:"",foundAt:"",number:0,url:""})}function k(t){return t===void 0||isCampaignId(t)}function J(t){return E(O,t)}function X(t){return g(t)&&Object.values(t).every(N)}function N(t){return typeof t=="string"}
+`)}`),this.name="BugRecordError",this.problems=n}}export function isCampaignId(t){return typeof t=="string"&&t.length<=CAMPAIGN_ID_MAX_LENGTH&&L.test(t)}export function testTypeOfFile(t){const e=/\.([a-z0-9]+)\.testkit\.ts$/u.exec(t)?.[1];return j(e)?e:null}function M(t){const e=/\.([a-z0-9]+)\.testkit\.ts$/u.exec(t)?.[1];return z.find(n=>n===e)??null}export function toRepositoryPath(t,e){const n=e.replaceAll("\\","/");if(n.startsWith("/")||/^[a-z]:/iu.test(n))return null;const s=A.posix.normalize(A.posix.join(t,n));return s==="."||s===".."||s.startsWith("../")?null:s}export function toProductPath(t,e){return t===""?e:A.posix.relative(t,e)}export function readBugReport(t,e){if(!g(t))throw new BugRecordError("The bug record is invalid",["it must be a JSON object"]);const n=[],s=[],u=I(t,n,{path:r=>toRepositoryPath(e,r),text:(r,d)=>{const a=B(r);return a!==r&&s.push(d),a}});if(n.length>0)throw new BugRecordError("The bug record is invalid",n);return{redactedFields:s,report:u}}export function createBugDraft(t,e){const n=testTypeOfFile(t.test.file);return{schemaVersion:BUG_DRAFT_SCHEMA_VERSION,id:bugDraftId(t),recordedAt:e.recordedAt.toISOString(),recordedCommit:e.recordedCommit,productPath:e.productPath,caughtBy:e.campaign===null?"manual":"campaign",...e.campaign===null?{}:{campaign:e.campaign},...n===null?{}:{testType:n},...e.vitest===void 0?{}:{vitest:e.vitest},...t}}export function requireOneVitestProject(t,e,n){if(e.length<2||n.project!==null)return;const s=e.map(({project:u})=>JSON.stringify(u)).join(", ");throw new Error(`test.file ${t} runs in the Vitest projects ${s}. Name the one whose run fails with --vitest-project.`)}export function readBugDraft(t){const e="The bug draft is unreadable";if(!g(t))throw new BugRecordError(e,["it must be a JSON object"]);if(t.schemaVersion!==BUG_DRAFT_SCHEMA_VERSION)throw new BugRecordError(e,[`unknown schemaVersion ${JSON.stringify(t.schemaVersion)}`]);const n=[],s=(p,y,b,x)=>y(p)?p:(n.push(x),b),u=I(t,n,{path:p=>toRepositoryPath("",p),text:p=>p}),r=t.testType===void 0&&testTypeOfFile(u.test.file)===null?null:M(u.test.file);t.testType!==(r??void 0)&&n.push(r===null?"testType must be absent for a test file without a type":"testType does not match test.file");const d=s(t.caughtBy,J,"manual","caughtBy must be campaign or manual"),a=s(t.campaign,k,void 0,"campaign must be a campaign id");d==="campaign"!=(a!==void 0)&&n.push("campaign must be present when caughtBy is campaign and absent otherwise");const T={schemaVersion:BUG_DRAFT_SCHEMA_VERSION,id:s(t.id,isBugDraftId,"","id is not a draft id"),recordedAt:s(t.recordedAt,w,"","recordedAt must be a timestamp"),recordedCommit:s(t.recordedCommit,$,"","recordedCommit must be a full commit id"),productPath:s(t.productPath,N,"","productPath must be a string"),caughtBy:d,...a===void 0?{}:{campaign:a},...r===null?{}:{testType:r},...t.vitest===void 0?{}:{vitest:s(t.vitest,X,{},"vitest must hold runner, config and project text")},...u,...t.filed===void 0?{}:{filed:H(t.filed,n)}};if(n.length>0)throw new BugRecordError(e,n);return T}export function bugDraftId(t){const e=t.title.normalize("NFKD").replace(/\p{M}+/gu,"").toLowerCase().replace(/[^a-z0-9]+/gu,"-").slice(0,V).replace(/^-+|-+$/gu,""),n=G.createHash("sha256").update(`${t.test.file}
+${t.test.title}`).digest("hex");return`${e||"bug"}-${n.slice(0,8)}`}export function isBugDraftId(t){return typeof t=="string"&&/^[a-z0-9]+(?:-[a-z0-9]+)*-[0-9a-f]{8}$/u.test(t)}export function namesSameTest(t,e){return t.test.file===e.test.file&&t.test.title===e.test.title}function I(t,e,n){const s=(i,o,c,f)=>{const m=i[o];if(typeof m!="string"||m.trim().length===0)return e.push(`${c} must be a non-empty string`),"";const h=m.trim(),l=h.length>f?h:n.text(h,c);return l.length>f&&e.push(`${c} must be at most ${String(f)} characters`),l},u=(i,o,c)=>{const f=i[o],m=typeof f=="string"?f.trim():"",h=m.length>0?n.path(m):null;return h===null?e.push(`${c} must be a path inside the repository`):[m,h].some(l=>B(l)!==l)&&e.push(`${c} is a path that holds text Testkit redacts as a secret`),h??""},r=(i,o,c)=>E(i,o)?o:(e.push(`${c} must be one of ${i.join(", ")}`),i[0]),d=i=>{const o=t[i];return g(o)?o:(e.push(`${i} must be an object`),{})},a=(i,o,c)=>{const f=s(i,o,c,BUG_TITLE_MAX_LENGTH);return/[\r\n]/u.test(f)&&e.push(`${c} must be one line`),f},T=a(t,"title","title"),p=d("test"),y=d("fault"),b=d("confidence"),x=u(p,"file","test.file");let S=[1,1];try{S=D(y.lines)}catch(i){e.push(i instanceof Error?i.message:"fault.lines is invalid")}return{title:T,severity:r(R,t.severity,"severity"),expected:s(t,"expected","expected",BUG_SECTION_MAX_LENGTH),authority:s(t,"authority","authority",BUG_SECTION_MAX_LENGTH),observed:s(t,"observed","observed",BUG_SECTION_MAX_LENGTH),rootCause:s(t,"rootCause","rootCause",BUG_SECTION_MAX_LENGTH),test:{file:x,title:a(p,"title","test.title")},fault:{lines:S,path:u(y,"path","fault.path")},cause:r(_(P),t.cause,"cause"),impact:r(_(F),t.impact,"impact"),confidence:{cause:r(C,b.cause,"confidence.cause"),impact:r(C,b.impact,"confidence.impact")},escape:r(_(U),t.escape,"escape")}}function H(t,e){return g(t)&&w(t.filedAt)&&$(t.foundAt)&&typeof t.number=="number"&&Number.isSafeInteger(t.number)&&t.number>=1&&typeof t.url=="string"?{filedAt:t.filedAt,foundAt:t.foundAt,number:t.number,url:t.url}:(e.push("filed must hold filedAt, foundAt, number, and url"),{filedAt:"",foundAt:"",number:0,url:""})}function k(t){return t===void 0||isCampaignId(t)}function J(t){return E(O,t)}function X(t){return g(t)&&Object.values(t).every(N)}function N(t){return typeof t=="string"}

package/dist/app/bugs/guide.js

@@ -1,4 +1,4 @@
-import{BUG_CAUSES as i,BUG_CONFIDENCES as u,BUG_ESCAPES as a,BUG_IMPACTS as s,BUG_SEVERITIES as o}from"./categories.js";import{BUG_TITLE_MAX_LENGTH as r}from"./draft.js";import{SEVERITY_LABELS as h}from"./issue.js";export const BUG_RECORD_EXAMPLE={title:"A refund pays out twice when two requests overlap",severity:"high",expected:"A refund pays out once.",authority:'`docs/refunds.md`, "Refunds are idempotent on the order id".',observed:"Two overlapping refund requests for one order both pay out.",rootCause:"`refund()` reads the order's refund state and writes the payout without a lock.",test:{file:"src/checkout/__testkit__/refund.contract.testkit.ts",title:"a refund pays out once"},fault:{path:"src/checkout/refunds.ts",lines:[41,58]},cause:"race-condition",impact:"financial-error",confidence:{cause:"high",impact:"high"},escape:"no-test"};const c=e=>e.map(t=>`\`${t}\``).join(", "),d=e=>`One of ${c(u)}. How sure you are of the ${e}.`,n=e=>({meaning:`One id from the ${e.field} list below.`,name:e.field});export const BUG_GUIDE={fields:[{name:"title",meaning:`One line of at most ${String(r)} characters that names the broken behaviour. It becomes the issue title.`},{name:"severity",meaning:`One of ${c(o)}. The severities are defined below.`},{name:"expected",meaning:"What the product should do."},{name:"authority",meaning:"The source that says so: documentation, a specification, an API contract, or the code's own stated intent. Name it and quote the part that applies."},{name:"observed",meaning:"What the product does instead."},{name:"rootCause",meaning:"Why the code behaves this way."},{name:"test.file",meaning:"The Testkit test file that fails because of the bug."},{name:"test.title",meaning:`The failure's title. It is one line of at most ${String(r)} characters.`},{name:"fault.path",meaning:"The source file that holds the mistake."},{name:"fault.lines",meaning:"The first and last faulty line as `[start, end]`, counted from 1. One faulty line is `[41, 41]`."},n(i),n(s),{name:"confidence.cause",meaning:d("cause")},{name:"confidence.impact",meaning:d("impact")},n(a)],rules:["Write `test.file` and `fault.path` relative to the product directory, the directory that holds `testkit.config.ts`.","`test.title` must be the failure's title exactly as Testkit reports it. In a Vitest or Playwright file, that is the names of the `describe` blocks around the test and the test's own name, joined by single spaces. When `testkit bug file` rejects the title, its message lists the titles a bug record can use.","Keep credentials, tokens, and passwords out of the record. Testkit redacts the secrets it recognises before it stores the record and again before it files the issue. It files no bug under a failure's title that holds text it redacts, so rename such a test or label such an assertion first."],example:BUG_RECORD_EXAMPLE,severities:o.map(e=>({definition:h[e].description,id:e})),categoryLists:[i,s,a]};export function renderBugGuide(e){return["## Bug record","Write one JSON object for each confirmed bug. Every field is required.",e.fields.map(t=>`- \`${t.name}\`: ${t.meaning}`).join(`
+import{BUG_CAUSES as i,BUG_CONFIDENCES as u,BUG_ESCAPES as a,BUG_IMPACTS as s,BUG_SEVERITIES as o}from"./categories.js";import{BUG_TITLE_MAX_LENGTH as r}from"./draft.js";import{SEVERITY_LABELS as h}from"./issue.js";export const BUG_RECORD_EXAMPLE={title:"A refund pays out twice when two requests overlap",severity:"high",expected:"A refund pays out once.",authority:'`docs/refunds.md`, "Refunds are idempotent on the order id".',observed:"Two overlapping refund requests for one order both pay out.",rootCause:"`refund()` reads the order's refund state and writes the payout without a lock.",test:{file:"src/checkout/refund.test.ts",title:"a refund pays out once"},fault:{path:"src/checkout/refunds.ts",lines:[41,58]},cause:"race-condition",impact:"financial-error",confidence:{cause:"high",impact:"high"},escape:"no-test"};const c=e=>e.map(t=>`\`${t}\``).join(", "),d=e=>`One of ${c(u)}. How sure you are of the ${e}.`,n=e=>({meaning:`One id from the ${e.field} list below.`,name:e.field});export const BUG_GUIDE={fields:[{name:"title",meaning:`One line of at most ${String(r)} characters that names the broken behaviour. It becomes the issue title.`},{name:"severity",meaning:`One of ${c(o)}. The severities are defined below.`},{name:"expected",meaning:"What the product should do."},{name:"authority",meaning:"The source that says so: documentation, a specification, an API contract, or the code's own stated intent. Name it and quote the part that applies."},{name:"observed",meaning:"What the product does instead."},{name:"rootCause",meaning:"Why the code behaves this way."},{name:"test.file",meaning:"The Testkit test file that fails because of the bug."},{name:"test.title",meaning:`The failure's title. It is one line of at most ${String(r)} characters.`},{name:"fault.path",meaning:"The source file that holds the mistake."},{name:"fault.lines",meaning:"The first and last faulty line as `[start, end]`, counted from 1. One faulty line is `[41, 41]`."},n(i),n(s),{name:"confidence.cause",meaning:d("cause")},{name:"confidence.impact",meaning:d("impact")},n(a)],rules:["Write `test.file` and `fault.path` relative to the product directory, the directory that holds `testkit.config.ts`.","`test.title` must be the failure's title exactly as Testkit reports it. In a Vitest or Playwright file, that is the names of the `describe` blocks around the test and the test's own name, joined by single spaces. When `testkit bug file` rejects the title, its message lists the titles a bug record can use.","Keep credentials, tokens, and passwords out of the record. Testkit redacts the secrets it recognises before it stores the record and again before it files the issue. It files no bug under a failure's title that holds text it redacts, so rename such a test or label such an assertion first."],example:BUG_RECORD_EXAMPLE,severities:o.map(e=>({definition:h[e].description,id:e})),categoryLists:[i,s,a]};export function renderBugGuide(e){return["## Bug record","Write one JSON object for each confirmed bug. Every field is required.",e.fields.map(t=>`- \`${t.name}\`: ${t.meaning}`).join(`
 `),...e.rules,"Example:",["```json",JSON.stringify(e.example,null,2),"```"].join(`
 `),"## Severities",e.severities.map(t=>`- \`${t.id}\`: ${t.definition}`).join(`
 `),...e.categoryLists.flatMap(l)].join(`

package/dist/app/bugs/record.js

@@ -1,2 +1,2 @@
-import d from"node:fs";import h from"node:path";import{text as b}from"node:stream/consumers";import{loadTestkitConfig as D}from"../../config/loader/index.js";import{discoverOwnedTests as k}from"../../config/loader/owned-discovery.js";import{isTypedTestFile as T}from"../../domain/identifiers.js";import{resolveVitestSelection as E}from"../../engines/catalog.js";import{posixPath as P}from"../../process/files/paths.js";import{findActiveCampaign as S,readCampaigns as F}from"../campaigns/store.js";import{BugRecordError as $,createBugDraft as x,namesSameTest as C,readBugReport as R,requireOneVitestProject as j,toProductPath as B}from"./draft.js";import{bugDraftFile as O,displayPath as y,displayUnreadableDrafts as J,readStoredDrafts as N,resolveBugCheckout as A,writeJsonFile as I}from"./store.js";export async function recordBug(o){const e=await A(o),{redactedFields:i,report:t}=U(await q(e.cwd,o.file),e.productPath);for(const[r,g]of[["test.file",t.test.file],["fault.path",t.fault.path]])if(d.statSync(h.join(e.repoRoot,g),{throwIfNoEntry:!1})?.isFile()!==!0)throw new Error(`${r} resolves to ${g} from the repository root, and no file is there. Write the path relative to the product directory.`);const{config:a}=await D(e.productDir),c=E(o.vitest??{},e.productDir),f=B(e.productPath,t.test.file),l=await k(e.productDir,a,{plain:!T(f),selection:c}),m=l.problems.at(0);if(m!==void 0)throw new Error(m);if(!l.project.files.some(r=>r.filePath===f))throw new Error(`test.file resolves to ${t.test.file}, and Testkit does not discover a test there. Run \`testkit discover\` to list the tests it runs.`);j(t.test.file,l.plainFiles.filter(({file:r})=>r===f),c);const n=x(t,{campaign:S(F(e.productDir))?.id??null,productPath:e.productPath,recordedAt:o.at??new Date,recordedCommit:e.headCommit,vitest:V(o.vitest??{},e.productDir,c)}),u=N(e.productDir),p=u.drafts.filter(r=>C(r.draft,n)),w=p.find(r=>r.draft.filed!==void 0)?.draft.filed;if(w!==void 0)throw new Error(`This test already has a filed bug: ${w.url}. Testkit keeps one bug for each test.`);const s=O(e.productDir,n.id),v=u.unreadable.find(r=>r.file===s);if(v!==void 0)throw new Error(`${y(e,s)} exists and Testkit cannot read it: ${v.problem}. Fix or delete the file, then run this again.`);I(s,n);for(const r of p)r.file!==s&&d.rmSync(r.file,{force:!0});return{draft:n,path:y(e,s),redactedFields:i,replaced:p.length>0,unreadableDrafts:J(e,u.unreadable)}}function V({"vitest-project":o,"vitest-runner":e},i,{config:t}){const a={...e===void 0?{}:{"vitest-runner":e},...t===null?{}:{"vitest-config":P(h.relative(d.realpathSync(i),t))},...o===void 0?{}:{"vitest-project":o}};return Object.keys(a).length===0?void 0:a}async function q(o,e){if(e==="-")return{source:"standard input",text:await b(process.stdin)};try{return{source:e,text:d.readFileSync(h.resolve(o,e),"utf8")}}catch(i){throw new Error(`Testkit cannot read the bug record file ${e}.`,{cause:i})}}function U(o,e){let i;try{i=JSON.parse(o.text)}catch(t){throw new Error(`The bug record in ${o.source} is not valid JSON.`,{cause:t})}try{return R(i,e)}catch(t){throw t instanceof $?new Error(`${t.message}
-Run \`testkit bug guide\` to see the record format.`,{cause:t}):t}}
+import c from"node:fs";import h from"node:path";import{text as b}from"node:stream/consumers";import{loadTestkitConfig as D}from"../../config/loader/index.js";import{discoverOwnedTests as k}from"../../config/loader/owned-discovery.js";import{isTypedTestFile as T}from"../../domain/identifiers.js";import{resolveVitestSelection as E}from"../../engines/catalog.js";import{posixPath as P}from"../../process/files/paths.js";import{findActiveCampaign as S,readCampaigns as F}from"../campaigns/store.js";import{BugRecordError as $,createBugDraft as x,namesSameTest as C,readBugReport as R,requireOneVitestProject as j,toProductPath as B}from"./draft.js";import{bugDraftFile as O,displayPath as y,displayUnreadableDrafts as J,readStoredDrafts as N,resolveBugCheckout as A,writeJsonFile as I}from"./store.js";export async function recordBug(o){const t=await A(o),{redactedFields:i,report:e}=U(await q(t.cwd,o.file),t.productPath);for(const[r,g]of[["test.file",e.test.file],["fault.path",e.fault.path]])if(c.statSync(h.join(t.repoRoot,g),{throwIfNoEntry:!1})?.isFile()!==!0)throw new Error(`${r} resolves to ${g} from the repository root, and no file is there. Write the path relative to the product directory.`);const{config:a}=await D(t.productDir),f=E(o.vitest??{},t.productDir),l=B(t.productPath,e.test.file),n=await k(t.productDir,a,{plain:!T(l),selection:f}),m=n.problems.at(0)??n.migration;if(m!==null)throw new Error(m);if(!n.project.files.some(r=>r.filePath===l))throw new Error(`test.file resolves to ${e.test.file}, and Testkit does not discover a test there. Run \`testkit discover\` to list the tests it runs.`);j(e.test.file,n.plainFiles.filter(({file:r})=>r===l),f);const d=x(e,{campaign:S(F(t.productDir))?.id??null,productPath:t.productPath,recordedAt:o.at??new Date,recordedCommit:t.headCommit,vitest:V(o.vitest??{},t.productDir,f)}),u=N(t.productDir),p=u.drafts.filter(r=>C(r.draft,d)),w=p.find(r=>r.draft.filed!==void 0)?.draft.filed;if(w!==void 0)throw new Error(`This test already has a filed bug: ${w.url}. Testkit keeps one bug for each test.`);const s=O(t.productDir,d.id),v=u.unreadable.find(r=>r.file===s);if(v!==void 0)throw new Error(`${y(t,s)} exists and Testkit cannot read it: ${v.problem}. Fix or delete the file, then run this again.`);I(s,d);for(const r of p)r.file!==s&&c.rmSync(r.file,{force:!0});return{draft:d,path:y(t,s),redactedFields:i,replaced:p.length>0,unreadableDrafts:J(t,u.unreadable)}}function V({"vitest-project":o,"vitest-runner":t},i,{config:e}){const a={...t===void 0?{}:{"vitest-runner":t},...e===null?{}:{"vitest-config":P(h.relative(c.realpathSync(i),e))},...o===void 0?{}:{"vitest-project":o}};return Object.keys(a).length===0?void 0:a}async function q(o,t){if(t==="-")return{source:"standard input",text:await b(process.stdin)};try{return{source:t,text:c.readFileSync(h.resolve(o,t),"utf8")}}catch(i){throw new Error(`Testkit cannot read the bug record file ${t}.`,{cause:i})}}function U(o,t){let i;try{i=JSON.parse(o.text)}catch(e){throw new Error(`The bug record in ${o.source} is not valid JSON.`,{cause:e})}try{return R(i,t)}catch(e){throw e instanceof $?new Error(`${e.message}
+Run \`testkit bug guide\` to see the record format.`,{cause:e}):e}}

package/dist/app/campaigns/index.js

@@ -1,2 +1,2 @@
-import x from"node:fs";import c from"node:path";import{readAreaMap as A,readBugPolicy as j}from"../../config/loader/bugs.js";import{loadTestkitConfig as w}from"../../config/loader/index.js";import{listFilesChangedSince as P}from"../../repo/history.js";import{listCommitFiles as I}from"../../repo/tree-listing.js";import{measureAreaMap as R}from"../bugs/areas.js";import{displayPath as D,displayUnreadableDrafts as y,readStoredDrafts as S,resolveBugCheckout as u,writeJsonFile as k,writeTextFile as B}from"../bugs/store.js";import{renderCampaignBrief as E}from"./brief.js";import{defaultCampaignId as T,readCampaignId as $,readCampaignTarget as M}from"./campaign.js";import{campaignDir as F,findActiveCampaign as f,findLastFinishedCampaign as O,readCampaigns as p}from"./store.js";import{renderCampaignSummary as J}from"./summary.js";export async function startCampaign(a){const t=a.at??new Date,r=M(a.target),i=a.id===void 0?T(r,t):$(a.id),e=await u(a),n=f(p(e.productDir));if(n!==null)throw new Error(`Campaign ${n.id} is active in this checkout. Run \`testkit campaign finish\` before you start another.`);const s=F(e.productDir,i);if(x.existsSync(s))throw new Error(`${D(e,s)} already exists. Pass --id to give this campaign another id.`);const m=await v(e),d={schemaVersion:1,id:i,target:r,startedAt:t.toISOString(),startCommit:e.headCommit};return k(c.join(s,"campaign.json"),d),{areas:m,brief:E(d,m,e.productPath),campaign:d}}export async function readCampaignStatus(a){const t=await u(a),r=p(t.productDir),i=f(r),e=S(t.productDir),n=await v(t);return{active:i,areas:{areaCount:n.areas.length,doubleClaimCount:n.doubleClaims.length,unclaimedShare:n.unclaimedShare},drafts:i===null?[]:b(e.drafts,i.id),lastFinished:O(r),unreadableDrafts:y(t,e.unreadable)}}export async function finishCampaign(a){const t=await u(a),r=f(p(t.productDir));if(r===null)throw new Error("No campaign is active in this checkout. Run `testkit campaign start --target <text>` to start one.");const i={...r,finishedAt:(a.at??new Date).toISOString()},e=S(t.productDir),n=b(e.drafts,i.id),s=n.filter(o=>o.filed!==void 0),m=n.filter(o=>o.filed===void 0),{config:d}=await w(t.productDir),l=await P(t.repoRoot,i.startCommit),g=J({campaign:i,filed:s,headCommit:t.headCommit,knownFailures:j(d).knownFailures,testFiles:l===null?null:l.filter(o=>o.endsWith(".testkit.ts")),unfiled:m,unreadableDrafts:y(t,e.unreadable).map(o=>o.file)}),h=F(t.productDir,i.id),C=c.join(h,"summary.md");return B(C,`${g}
-`),k(c.join(h,"campaign.json"),i),{campaign:i,filed:s,headCommit:t.headCommit,summary:g,summaryPath:D(t,C),unfiled:m}}function b(a,t){return a.map(r=>r.draft).filter(r=>r.campaign===t)}async function v(a){const{config:t}=await w(a.productDir);return R(A(t),await I(a.repoRoot,a.headCommit))}
+import A from"node:fs";import c from"node:path";import{readAreaMap as x,readBugPolicy as I}from"../../config/loader/bugs.js";import{PLAIN_TEST_SUFFIX as P}from"../../config/loader/discovery.js";import{loadTestkitConfig as w}from"../../config/loader/index.js";import{listFilesChangedSince as j}from"../../repo/history.js";import{listCommitFiles as T}from"../../repo/tree-listing.js";import{measureAreaMap as E}from"../bugs/areas.js";import{displayPath as D,displayUnreadableDrafts as y,readStoredDrafts as S,resolveBugCheckout as u,writeJsonFile as F,writeTextFile as R}from"../bugs/store.js";import{renderCampaignBrief as B}from"./brief.js";import{defaultCampaignId as $,readCampaignId as L,readCampaignTarget as M}from"./campaign.js";import{campaignDir as k,findActiveCampaign as f,findLastFinishedCampaign as N,readCampaigns as p}from"./store.js";import{renderCampaignSummary as O}from"./summary.js";export async function startCampaign(a){const t=a.at??new Date,r=M(a.target),i=a.id===void 0?$(r,t):L(a.id),e=await u(a),n=f(p(e.productDir));if(n!==null)throw new Error(`Campaign ${n.id} is active in this checkout. Run \`testkit campaign finish\` before you start another.`);const s=k(e.productDir,i);if(A.existsSync(s))throw new Error(`${D(e,s)} already exists. Pass --id to give this campaign another id.`);const m=await v(e),d={schemaVersion:1,id:i,target:r,startedAt:t.toISOString(),startCommit:e.headCommit};return F(c.join(s,"campaign.json"),d),{areas:m,brief:B(d,m,e.productPath),campaign:d}}export async function readCampaignStatus(a){const t=await u(a),r=p(t.productDir),i=f(r),e=S(t.productDir),n=await v(t);return{active:i,areas:{areaCount:n.areas.length,doubleClaimCount:n.doubleClaims.length,unclaimedShare:n.unclaimedShare},drafts:i===null?[]:b(e.drafts,i.id),lastFinished:N(r),unreadableDrafts:y(t,e.unreadable)}}export async function finishCampaign(a){const t=await u(a),r=f(p(t.productDir));if(r===null)throw new Error("No campaign is active in this checkout. Run `testkit campaign start --target <text>` to start one.");const i={...r,finishedAt:(a.at??new Date).toISOString()},e=S(t.productDir),n=b(e.drafts,i.id),s=n.filter(o=>o.filed!==void 0),m=n.filter(o=>o.filed===void 0),{config:d}=await w(t.productDir),l=await j(t.repoRoot,i.startCommit),g=O({campaign:i,filed:s,headCommit:t.headCommit,knownFailures:I(d).knownFailures,testFiles:l===null?null:l.filter(o=>o.endsWith(".testkit.ts")||P.test(o)),unfiled:m,unreadableDrafts:y(t,e.unreadable).map(o=>o.file)}),h=k(t.productDir,i.id),C=c.join(h,"summary.md");return R(C,`${g}
+`),F(c.join(h,"campaign.json"),i),{campaign:i,filed:s,headCommit:t.headCommit,summary:g,summaryPath:D(t,C),unfiled:m}}function b(a,t){return a.map(r=>r.draft).filter(r=>r.campaign===t)}async function v(a){const{config:t}=await w(a.productDir);return E(x(t),await T(a.repoRoot,a.headCommit))}

package/dist/app/destroy/index.js

@@ -1 +1 @@
-import{filterConfigsByService as a}from"../../config/loader/managed-configs.js";import{loadConfigContext as n}from"../../config/loader/index.js";import{createEnvironmentMaintenance as i}from"../../environment/maintenance.js";import{hasLocalDatabaseState as d}from"../../database/lifecycle-cleanup.js";export async function destroy(t,e,r={}){await i(t).maintain({kind:"destroy",configs:e,destroyOwnedResources:r.destroyOwnedResources})}export async function destroyEnvironment(t){const e=await n({dir:t.dir,plain:!1,retired:[]}),r=a(e.services,t.service||null),s=e.services.some(o=>o.testkit.database!==void 0||o.testkit.databaseFrom!==void 0);return await destroy(e.productDir,r,{destroyOwnedResources:!t.service&&(s||d(e.productDir))}),{ok:!0,productDir:e.productDir,results:r.map(o=>({name:o.name,destroyed:!0}))}}
+import{filterConfigsByService as s}from"../../config/loader/managed-configs.js";import{loadConfigContext as n}from"../../config/loader/index.js";import{createEnvironmentMaintenance as i}from"../../environment/maintenance.js";import{hasLocalDatabaseState as d}from"../../database/lifecycle-cleanup.js";export async function destroy(t,e,r={}){await i(t).maintain({kind:"destroy",configs:e,destroyOwnedResources:r.destroyOwnedResources})}export async function destroyEnvironment(t){const e=await n({dir:t.dir,allowUnmigratedServices:!0,plain:!1,retired:[]}),r=s(e.services,t.service||null),o=e.services.some(a=>a.testkit.database!==void 0||a.testkit.databaseFrom!==void 0);return await destroy(e.productDir,r,{destroyOwnedResources:!t.service&&(o||d(e.productDir))}),{ok:!0,productDir:e.productDir,results:r.map(a=>({name:a.name,destroyed:!0}))}}

package/dist/app/discover/index.js

@@ -1,2 +1,2 @@
-import{resolveRequestedFiles as p}from"../file-selection.js";import{resolveVitestSelection as v}from"../../engines/catalog.js";import u from"fs";import t from"path";import{loadDiscoveryContext as d,resolveProductDir as y}from"../../config/loader/index.js";export async function executeDiscoverOperation({notice:a,output:o,vitest:m,...i},l=process.cwd()){const e=y(l,i.dir),f=p(i.file||[],e,l),{discovery:s,notice:c}=await d({...i,dir:e,file:f,vitest:v(m??{},e)});c!==null&&a?.(c);let n=null;if(o){const r=t.resolve(e,o);u.mkdirSync(t.dirname(r),{recursive:!0}),u.writeFileSync(r,`${JSON.stringify(s,null,2)}
-`),n=(t.relative(e,r)||t.basename(r)).replaceAll("\\","/")}return{...s,outputLabel:n}}
+import{resolveRequestedFiles as u}from"../file-selection.js";import{resolveVitestSelection as f}from"../../engines/catalog.js";import n from"fs";import t from"path";import{loadDiscoveryContext as p,resolveProductDir as v}from"../../config/loader/index.js";export async function executeDiscoverOperation({output:o,vitest:a,...i},l=process.cwd()){const e=v(l,i.dir),m=u(i.file||[],e,l),{discovery:s}=await p({...i,dir:e,file:m,vitest:f(a??{},e)});let c=null;if(o){const r=t.resolve(e,o);n.mkdirSync(t.dirname(r),{recursive:!0}),n.writeFileSync(r,`${JSON.stringify(s,null,2)}
+`),c=(t.relative(e,r)||t.basename(r)).replaceAll("\\","/")}return{...s,outputLabel:c}}

package/dist/app/environments/static-values.js

@@ -1 +1 @@
-import{environmentTaskIdentities as p,renderSharedEnvironment as h}from"../run/environment.js";import{withEnvFileValues as g}from"../../config/loader/env.js";import{sensitiveKeyMatcher as w}from"../../kernel/redaction-targets.js";import{renderEnvironment as y}from"./config-driven.js";import{prepareFileSetup as v}from"./file-setup.js";import{resetBeforeRefusal as E}from"./task-databases.js";const K=new Set(["bin","lease","leaseDir","pathList","productDir","service","stateDir"]);export function createStaticValueEnvironments(e,c,n=null){const o=new Map,f=r=>{const i=o.get(r.name);if(i!==void 0)return i;const t=g(r);return S(t),o.set(r.name,t),t};return{canAcquire:()=>!0,getGraph:()=>null,getGraphFailure:()=>null,markGraphFailed:()=>{},acquire(r,i){const t=n?.acquisition({source:"static",graphKey:r.graphKey,leaseId:i.id,tasks:p(r)});return Promise.resolve().then(()=>{const s=h(r,a=>{const m=e.get(a);if(m===void 0)throw new Error(`No services are declared for group "${a}"`);const l={graphKey:r.graphKey,leaseId:i.id,runtimeId:r.graphKey,targetNames:[a],services:new Map(m.map(u=>[u.name,{baseUrl:null,database:null,config:f(u)}]))};return y(l,{name:a,uses:m.map(({name:u})=>u)},i,u=>n?.addRedactionTarget(u),w(n?.redactKeys))});return t?.acquired({runtimeId:null,services:[]}),t?.rendered(s),{environment:s,prepare:async(a,m)=>{if(a.runtimeIsolation==="resetBefore")throw E(a,!1);return v(a,m,{environment:s,lease:i,productDir:c,record:t,redact:l=>n?.addRedactionTarget(l)})},release:()=>(t?.released(),Promise.resolve())}}).catch(s=>{throw t?.failed(s),s})}}}function S(e){const c=[...Object.entries(e.testkit.serviceEnv).map(([n,o])=>[`env.${n}`,o]),["ui",e.testkit.ui]];for(const[n,o]of c)for(const f of d(o))if(!K.has(f))throw new Error(`Service "${e.name}" uses {${f}} in ${n}, which needs a running service, and "${e.name}" starts none`)}function d(e){return typeof e=="string"?[...e.matchAll(/\{([a-zA-Z]+)(?::[^}]+)?\}/gu)].map(c=>c[1]):Array.isArray(e)?e.flatMap(d):e!==null&&typeof e=="object"?Object.values(e).flatMap(d):[]}
+import{environmentTaskIdentities as p,PREVIEW_LEASE as h,renderSharedEnvironment as w}from"../run/environment.js";import{withEnvFileValues as g}from"../../config/loader/env.js";import{sensitiveKeyMatcher as y}from"../../kernel/redaction-targets.js";import{renderEnvironment as E}from"./config-driven.js";import{prepareFileSetup as v}from"./file-setup.js";import{resetBeforeRefusal as S}from"./task-databases.js";const I=new Set(["bin","lease","leaseDir","pathList","productDir","service","stateDir"]);export function createStaticValueEnvironments(r,c,a=null){const s=new Map,d=e=>{const t=s.get(e.name);if(t!==void 0)return t;const n=g(e);return T(n),s.set(e.name,n),n},l=(e,t,n,o)=>{const i=r.get(e);if(i===void 0)throw new Error(`No services are declared for group "${e}"`);const m={graphKey:t,leaseId:n.id,runtimeId:t,targetNames:[e],services:new Map(i.map(u=>[u.name,{baseUrl:null,database:null,config:d(u)}]))};return E(m,{name:e,uses:i.map(({name:u})=>u)},n,o,y(a?.redactKeys))};return{canAcquire:()=>!0,getGraph:()=>null,getGraphFailure:()=>null,markGraphFailed:()=>{},preview(e){try{return l(e,"",h,()=>{})}catch{return null}},acquire(e,t){const n=a?.acquisition({source:"static",graphKey:e.graphKey,leaseId:t.id,tasks:p(e)});return Promise.resolve().then(()=>{const o=w(e,i=>l(i,e.graphKey,t,m=>a?.addRedactionTarget(m)));return n?.acquired({runtimeId:null,services:[]}),n?.rendered(o),{environment:o,prepare:async(i,m)=>{if(i.runtimeIsolation==="resetBefore")throw S(i,!1);return v(i,m,{environment:o,lease:t,productDir:c,record:n,redact:u=>a?.addRedactionTarget(u)})},release:()=>(n?.released(),Promise.resolve())}}).catch(o=>{throw n?.failed(o),o})}}}function T(r){const c=[...Object.entries(r.testkit.serviceEnv).map(([a,s])=>[`env.${a}`,s]),["ui",r.testkit.ui]];for(const[a,s]of c)for(const d of f(s))if(!I.has(d))throw new Error(`Service "${r.name}" uses {${d}} in ${a}, which needs a running service, and "${r.name}" starts none`)}function f(r){return typeof r=="string"?[...r.matchAll(/\{([a-zA-Z]+)(?::[^}]+)?\}/gu)].map(c=>c[1]):Array.isArray(r)?r.flatMap(f):r!==null&&typeof r=="object"?Object.values(r).flatMap(f):[]}

package/dist/app/environments/supplied.js

@@ -1 +1 @@
-import{createEnvironment as y,environmentTaskIdentities as g,renderSharedEnvironment as R}from"../run/environment.js";import{httpCaptureRedactionTargets as T}from"../run/setup/runtime-node-setup-protocol.js";import{checkPostgresConnection as E,parsePostgresUrl as M}from"../../database/postgres/connection-check.js";import{errorMessage as l}from"../../kernel/error-serialization.js";import{envRedactionTargets as O,jsonRedactionTargets as f,sensitiveKeyMatcher as j,urlRedactionTargets as q}from"../../kernel/redaction-targets.js";import{parseHttpUrl as D,requireHttpResponse as I}from"../../process/readiness.js";import{prepareFileSetup as P}from"./file-setup.js";import{resetBeforeRefusal as S}from"./task-databases.js";const m=3e4;export function createSuppliedEnvironments(t,{productDir:e,record:r=null,signal:o}){const i=j(r?.redactKeys);return{canAcquire:()=>!0,getGraph:()=>null,getGraphFailure:()=>null,markGraphFailed:()=>{},async acquire(a,s){const p=Object.hasOwn(t,a.targetName),c=r?.acquisition({source:p?"supplied":"none",graphKey:a.graphKey,leaseId:s.id,tasks:g(a)}),h=p?t[a.targetName]:{};for(const n of $(h,i))r?.addRedactionTarget(n);let d;try{d=R(a,n=>suppliedEnvironment(n,Object.hasOwn(t,n)?t[n]:{})),await C(a.targetName,d,o)}catch(n){throw o?.aborted&&n===o.reason?c?.cancelled(n):c?.failed(n),n}return c?.acquired({runtimeId:null,services:[]}),c?.rendered(d),{environment:d,prepare:async(n,U)=>{if(n.runtimeIsolation==="resetBefore")throw S(n,p);return p?null:P(n,U,{environment:d,lease:s,productDir:e,record:c,redact:w=>r?.addRedactionTarget(w)})},release:()=>(c?.released(),Promise.resolve())}}}}function $(t,e){return[...O(t.env??{},e),...[t.baseUrl,t.databaseUrl,...Object.values(t.databases??{}),...Object.values(t.endpoints??{})].flatMap(r=>r?q(r):[]),...f("handles",t.handles??{},e),...Object.values(t.handles??{}).filter(r=>r.kind==="http-capture").flatMap(T),...f("setupData",t.setupData??{},e),...f("ui",t.ui??{},e)]}async function C(t,e,r){const o=b(e.endpoints),i=b(e.databases);for(const[a,s]of o)await u(t,"endpoint",s,()=>D(a),r);for(const[a,s]of i)await u(t,"database",s,()=>{_(a)},r);for(const[a,s]of o)await u(t,"endpoint",s,()=>I(a,{signal:r,timeoutMs:m}),r);for(const[a,s]of i)await u(t,"database",s,()=>E(a,{signal:r,timeoutMs:m}),r)}function b(t){const e=new Map;for(const[r,o]of Object.entries(t))e.has(o)||e.set(o,r);return e}function _(t){try{M(t)}catch(e){throw new Error(`its URL ${l(e)}`,{cause:e})}}async function u(t,e,r,o,i){try{await o()}catch(a){throw i?.aborted?i.reason:new Error(`Supplied ${e} "${r}" for group "${t}" is not usable: ${l(a)}`,{cause:a})}}export function suppliedEnvironment(t,e){return{...y({baseUrl:e.baseUrl??null,databaseUrl:e.databaseUrl||null,databases:e.databases??{},endpoints:e.endpoints??{},env:e.env??{},group:t,...e.setupData===void 0?{}:{setupData:e.setupData},ui:e.ui??null}),...e.handles===void 0?{}:{handles:{...e.handles}}}}
+import{createEnvironment as y,environmentTaskIdentities as O,renderSharedEnvironment as R}from"../run/environment.js";import{httpCaptureRedactionTargets as T}from"../run/setup/runtime-node-setup-protocol.js";import{checkPostgresConnection as E,parsePostgresUrl as M}from"../../database/postgres/connection-check.js";import{errorMessage as l}from"../../kernel/error-serialization.js";import{envRedactionTargets as g,jsonRedactionTargets as f,sensitiveKeyMatcher as j,urlRedactionTargets as q}from"../../kernel/redaction-targets.js";import{parseHttpUrl as D,requireHttpResponse as I}from"../../process/readiness.js";import{prepareFileSetup as P}from"./file-setup.js";import{resetBeforeRefusal as S}from"./task-databases.js";const m=3e4;export function createSuppliedEnvironments(e,{productDir:t,record:a=null,signal:o}){const i=j(a?.redactKeys);return{canAcquire:()=>!0,getGraph:()=>null,getGraphFailure:()=>null,markGraphFailed:()=>{},preview(r){try{return suppliedEnvironment(r,Object.hasOwn(e,r)?e[r]:{})}catch{return null}},async acquire(r,s){const u=Object.hasOwn(e,r.targetName),c=a?.acquisition({source:u?"supplied":"none",graphKey:r.graphKey,leaseId:s.id,tasks:O(r)}),b=u?e[r.targetName]:{};for(const n of $(b,i))a?.addRedactionTarget(n);let d;try{d=R(r,n=>suppliedEnvironment(n,Object.hasOwn(e,n)?e[n]:{})),await C(r.targetName,d,o)}catch(n){throw o?.aborted&&n===o.reason?c?.cancelled(n):c?.failed(n),n}return c?.acquired({runtimeId:null,services:[]}),c?.rendered(d),{environment:d,prepare:async(n,w)=>{if(n.runtimeIsolation==="resetBefore")throw S(n,u);return u?null:P(n,w,{environment:d,lease:s,productDir:t,record:c,redact:U=>a?.addRedactionTarget(U)})},release:()=>(c?.released(),Promise.resolve())}}}}function $(e,t){return[...g(e.env??{},t),...[e.baseUrl,e.databaseUrl,...Object.values(e.databases??{}),...Object.values(e.endpoints??{})].flatMap(a=>a?q(a):[]),...f("handles",e.handles??{},t),...Object.values(e.handles??{}).filter(a=>a.kind==="http-capture").flatMap(T),...f("setupData",e.setupData??{},t),...f("ui",e.ui??{},t)]}async function C(e,t,a){const o=h(t.endpoints),i=h(t.databases);for(const[r,s]of o)await p(e,"endpoint",s,()=>D(r),a);for(const[r,s]of i)await p(e,"database",s,()=>{_(r)},a);for(const[r,s]of o)await p(e,"endpoint",s,()=>I(r,{signal:a,timeoutMs:m}),a);for(const[r,s]of i)await p(e,"database",s,()=>E(r,{signal:a,timeoutMs:m}),a)}function h(e){const t=new Map;for(const[a,o]of Object.entries(e))t.has(o)||t.set(o,a);return t}function _(e){try{M(e)}catch(t){throw new Error(`its URL ${l(t)}`,{cause:t})}}async function p(e,t,a,o,i){try{await o()}catch(r){throw i?.aborted?i.reason:new Error(`Supplied ${t} "${a}" for group "${e}" is not usable: ${l(r)}`,{cause:r})}}export function suppliedEnvironment(e,t){return{...y({baseUrl:t.baseUrl??null,databaseUrl:t.databaseUrl||null,databases:t.databases??{},endpoints:t.endpoints??{},env:t.env??{},group:e,...t.setupData===void 0?{}:{setupData:t.setupData},ui:t.ui??null}),...t.handles===void 0?{}:{handles:{...t.handles}}}}