@gfdelarue/testkit 0.6.0 → 0.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gfdelarue/testkit",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Test orchestration platform for product acceptance and QA workflows",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
@@ -136,7 +136,19 @@
     "yauzl": "3.4.0"
   },
   "overrides": {
-    "postcss": "8.5.24"
+    "@verdaccio/config": {
+      "js-yaml": "5.4.1"
+    },
+    "@verdaccio/hooks": {
+      "handlebars": "4.7.10"
+    },
+    "express": {
+      "qs": "6.16.0"
+    },
+    "postcss": "8.5.24",
+    "verdaccio": {
+      "compression": "1.8.2"
+    }
   },
   "engines": {
     "node": ">=22.15.0 <23.0.0 || >=24.14.1 <25.0.0",

package/testkit-config-schema.md

@@ -75,7 +75,7 @@ file-local metadata of a typed file may also declare skip and lock intent:
 import { defineFile } from "@gfdelarue/testkit";
 
 export const testkit = defineFile({
-  engine: "node-vitest",
+  engine: "playwright",
   skip: "Billing is currently unavailable locally",
   locks: ["payments-sandbox-webhook"],
 });
@@ -148,8 +148,7 @@ Run documents keep the configured `run.workers` field. Observed
 `workerCount`, Playwright's own `workers`, `runtime.instances` and
 `runtime.maxConcurrentTasks` keep their existing meanings.
 
-`fileTimeoutSeconds` is the single per-file wall clock budget for the repo. Runtime
-helpers like `waitFor()` consume this budget automatically.
+`fileTimeoutSeconds` is the single per-file wall clock budget for the repo.
 
 ### `lint`
 
@@ -196,7 +195,11 @@ areas: {
 
 - The key is the area id: lowercase letters, digits, and single hyphens, at
   most 40 characters.
-- `name`: one line of 1 to 60 characters. It becomes the label's description.
+- `name`: one line of 1 to 60 characters. It becomes the label's description,
+  and the issue carries it. Testkit doesn't rewrite it, so it must hold no
+  text that Testkit redacts as a secret. `testkit bug file` stops when the
+  fault's area has such a name. [Issue body](docs/bug-records.md#issue-body)
+  lists what Testkit redacts.
 - `paths`: at least one glob. Globs are relative to the repository root and
   written with `/`. A leading `!` or `/` and a `..` segment are rejected.
 
@@ -592,10 +595,10 @@ Environment names are validated case-insensitively. All engines reserve
 `XDG_CONFIG_HOME`, and `XDG_DATA_HOME`. Engine-specific reservations and limits
 are:
 
-| Engine        | Additional reservations                                                                                                                                    | Consumer environment limit                 |
-| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
-| `node-vitest` | exact keys `BASE_URL`, `FORCE_COLOR`, `NODE_OPTIONS`, `NO_COLOR`, `UPDATE_SNAPSHOT`, `VITEST_POOL_ID`, `VITEST_WORKER_ID`, and the `TESTKIT_` keys it sets | 512 entries; 4 MiB of UTF-8 key/value data |
-| `playwright`  | prefixes `TESTKIT_`, `PLAYWRIGHT_`, `PWTEST_`, `PW_TEST_`; exact keys `BASE_URL`, `FORCE_COLOR`, `NODE_OPTIONS`, `NO_COLOR`                                | 512 entries; 2 MiB of UTF-8 key/value data |
+| Engine        | Additional reservations                                                                                                                                                  | Consumer environment limit                 |
+| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------ |
+| `node-vitest` | exact keys `BASE_URL`, `FORCE_COLOR`, `NODE_OPTIONS`, `NO_COLOR`, `UPDATE_SNAPSHOT`, `VITEST_POOL_ID`, `VITEST_WORKER_ID`, and the `TESTKIT_` keys it sets               | 512 entries; 4 MiB of UTF-8 key/value data |
+| `playwright`  | prefixes `TESTKIT_`, `PLAYWRIGHT_`, `PWTEST_`, `PW_TEST_`; exact keys `BASE_URL`, `DBUS_SESSION_BUS_ADDRESS`, `FC_FONTATIONS`, `FORCE_COLOR`, `NODE_OPTIONS`, `NO_COLOR` | 512 entries; 2 MiB of UTF-8 key/value data |
 
 Empty names, names containing `=` or NUL, values containing NUL, and
 case-variant duplicates are rejected. The limits apply after env files and
@@ -709,13 +712,37 @@ service provisioned in the same runtime instance, as `DATABASE_URL` and in
 
 ### `runtime`
 
-Shared runtime topology and preparation behavior.
+Service-local runtime instances and their preparation.
+
+```ts
+runtime: {
+  instances: 1,
+  maxConcurrentTasks: 4,
+  prepare: {
+    inputs: ["frontend/src", "frontend/public", "frontend/package.json"],
+    steps: [{ kind: "command", run: "npm run build", cwd: "frontend" }],
+  },
+}
+```
 
 - `instances`
+  - number of reusable local runtime instances for that service graph
 - `maxConcurrentTasks`
+  - maximum number of concurrent file tasks admitted to each runtime instance
+  - omit it to leave concurrency bounded only by the outer `taskConcurrency` setting
 - `toolchain`
+- `prepare`
+  - optional runtime-generation preparation hook
+  - runs once per runtime instance before local services start
+  - fingerprints declared `inputs` plus referenced step files/module inputs
+  - use this for build-once/start-many shared runtimes such as `next build` +
+    `next start`
 - `prepare.inputs`
+  - extra repo-relative inputs that should invalidate prepared artifacts when
+    they change
 - `prepare.steps`
+  - ordered lifecycle steps using the same step DSL as `database.template`
+  - each step supports `cwd` and `inputs`
 
 `runtime.toolchain` may be either:
 
@@ -771,39 +798,6 @@ A run that skips a selected file fails, even when every other file passes, and
 `--allow-empty` doesn't change that. Use `--ignore-skip-rules` on the CLI to run
 skipped files anyway.
 
-### `runtime`
-
-Service-local runtime instance settings.
-
-```ts
-runtime: {
-  instances: 1,
-  maxConcurrentTasks: 4,
-  prepare: {
-    inputs: ["frontend/src", "frontend/public", "frontend/package.json"],
-    steps: [{ kind: "command", run: "npm run build", cwd: "frontend" }],
-  },
-}
-```
-
-- `instances`
-  - number of reusable local runtime instances for that service graph
-- `maxConcurrentTasks`
-  - maximum number of concurrent file tasks admitted to each runtime instance
-  - omit it to leave concurrency bounded only by the outer `taskConcurrency` setting
-- `prepare`
-  - optional runtime-generation preparation hook
-  - runs once per runtime instance before local services start
-  - fingerprints declared `inputs` plus referenced step files/module inputs
-  - use this for build-once/start-many shared runtimes such as `next build` +
-    `next start`
-- `prepare.inputs`
-  - extra repo-relative inputs that should invalidate prepared artifacts when
-    they change
-- `prepare.steps`
-  - ordered lifecycle steps using the same step DSL as `database.template`
-  - each step supports `cwd` and `inputs`
-
 ### `requirements`
 
 Task lock rules for a group's files, set as `groups.<name>.requirements`.

package/dist/config/loader/task-policy.js

@@ -1 +0,0 @@
-import{matchesSuiteSelectors as a}from"../../domain/suite-selection.js";import{normalizePath as l}from"./paths.js";import{resolveRuntimeIsolationPolicy as i}from"./runtime-isolation.js";export function resolveTaskPolicy(o,t,r){return{locks:m(o,t,r),runtimeIsolation:i({testkit:o},t,r)}}function m(o,t,r){const n=l(r),s=new Set;for(const e of o.requirements.suites)if(a(t.testType,t.name,[e.selector]))for(const c of e.locks)s.add(c);for(const e of o.requirements.fileLocksByPath.get(n)??[])s.add(e);for(const e of o.fileMetadataByPath.get(n)?.locks??[])s.add(e);return[...s].sort()}

package/dist/environment/lifecycle-artifacts.js

@@ -1 +0,0 @@
-import o from"fs";import a from"path";import{finalizeLiveRunArtifact as e}from"../evidence/index.js";import{isUnknownRecord as u}from"../kernel/unknown-values.js";export function reconcileInactiveRunArtifact(n,t){typeof t.runId=="string"&&e(n,{runId:t.runId,reason:"stale run process not active",status:"interrupted"})}export function reconcileOrphanedLiveRunArtifact(n,{activeRunIds:t=new Set}={}){const r=f(n),i=r?.run.id||null;return!i||r?.run.status!=="running"||t.has(i)?!1:e(n,{runId:i,reason:"stale live artifact has no active run manifest",status:"interrupted"})}function f(n){try{const t=JSON.parse(o.readFileSync(a.join(n,".testkit","results","live.json"),"utf8"));return c(t)}catch{return null}}function c(n){if(!u(n)||!u(n.run))return null;const t=n.run.id,r=n.run.status;return!s(t)||!s(r)?null:{run:{id:t,status:r}}}function s(n){return n===void 0||typeof n=="string"}