@reticlehq/test 2.1.0 → 2.2.1

package/README.md

@@ -0,0 +1,73 @@
+# @reticlehq/test
+
+Reticle's spec runner for CI: write behavioral specs against your running app with `reticleTest`, drive them through Reticle's verification tools (DOM + network + console + app state) **without MCP/stdio**, and get a summary + JUnit XML your pipeline can gate on.
+
+Part of [Reticle](https://github.com/reticlehq/reticle) — the in-app verification layer for AI agents. Use this package when you want the same inside-the-app assertions (signals, store state, network counts — the things a DOM-only tool can't see) as a plain CI test suite.
+
+## Install
+
+```bash
+npm i -D @reticlehq/test
+```
+
+`vitest` is a peer dependency for the matcher integration; the standalone runner below needs only Node.
+
+## Write a spec
+
+```ts
+import { reticleTest } from '@reticlehq/test';
+
+reticleTest('add a task', async (t) => {
+  await t.act('add-task', 'click');
+  await t.expectElement({ testid: 'task-list' }, 'visible');
+});
+
+reticleTest('ai chat edit', async (t) => {
+  await t.fill('chat-input', 'Make the hook punchier');
+  await t.act('chat-send', 'click');
+  await t.expectNet('POST', '/chat-script', 200);
+  await t.expectSignal('chat:edit-applied', { sections: ['hook'] });
+});
+```
+
+The context `t` is a thin, typed façade over Reticle's tools — it resolves `data-testid`s to live elements for you, so specs never touch refs, selectors, or the DOM directly, and assertions run against the app's real network buffer, console, signals, and registered stores.
+
+## Run in CI
+
+```ts
+import { bootSession, runSpecs, createTestContext, writeJUnit } from '@reticlehq/test';
+
+// … reticleTest(...) registrations above …
+
+const booted = await bootSession({ driveUrl: 'http://localhost:4310', headless: true });
+const { summary } = await runSpecs({
+  invoke: booted.invoke,
+  now: () => Date.now(),
+  buildContext: (invoke) => createTestContext(invoke, { sessionId: 'my-app' }),
+  print: (line) => process.stdout.write(line + '\n'),
+});
+await booted.close();
+process.exit(summary.failed === 0 ? 0 : 1);
+```
+
+`bootSession` launches a headless browser against your dev server via the Reticle daemon; `runSpecs` executes every registered spec and returns a machine-readable summary. `writeJUnit(...)` emits JUnit XML for CI dashboards.
+
+## Main exports
+
+| Export | Purpose |
+| --- | --- |
+| `reticleTest`, `register`, `getRegistered`, `clearRegistry` | spec registration |
+| `runSpecs`, `runOne`, `summarize`, `printSummary` | execution + reporting |
+| `toJUnitXml`, `writeJUnit` | CI artifact output |
+| `bootSession` | boot a driven browser session without MCP |
+| `createTestContext` | the `t` façade (act / expectElement / expectNet / expectSignal / expectState …) |
+| `ReticleSkip`, `ReticleAssertionError`, `isSkip` | control-flow + failure types |
+
+## Docs
+
+- [Testing guide](https://github.com/reticlehq/reticle/blob/main/docs/testing.md)
+- [Getting started with Reticle](https://github.com/reticlehq/reticle/blob/main/docs/getting-started.md)
+
+## License
+
+FSL-1.1-ALv2 — free for any use except reselling Reticle itself; converts to Apache-2.0 after two years. See [LICENSE](./LICENSE).

package/dist/constants.d.ts

@@ -29,12 +29,12 @@ export declare const JUnit: {
 /** Default JUnit <testsuite name=...> when the caller does not supply one. */
 export declare const DEFAULT_JUNIT_SUITE_NAME = "reticle";
 /**
- * Skip reason `t.expectInputModeReal()` raises when the active input mode is 'synthetic'.
+ * Skip reason `t.expectInputModeReal` raises when the active input mode is 'synthetic'.
  * The runner turns the ReticleSkip carrying this into status:'skip' (never a silent pass).
  */
 export declare const SKIP_REASON_REAL_INPUT = "real input not active \u2014 run via reticle drive";
-/** Default wait window for assertion matchers (reticle_assert timeout_ms). */
-export declare const DEFAULT_ASSERT_TIMEOUT_MS = 4000;
+/** Default wait window for assertion matchers — re-exported from core so it matches the server default. */
+export { DEFAULT_ASSERT_TIMEOUT_MS } from '@reticlehq/core';
 /** Predicate `kind` discriminants the matchers build. Mirrors @reticlehq/server's Predicate union. */
 export declare const PredicateKind: {
     readonly SIGNAL: "signal";
@@ -50,7 +50,7 @@ export declare const CONSOLE_LEVEL_ERROR = "error";
 export declare const NO_ELEMENT_FOR_TESTID = "no element for testid";
 /**
  * Default testid the input-mode probe resolves to when no act has run yet. Apps that opt into
- * `expectInputModeReal()` before any act should tag a stable benign element with this testid;
+ * `expectInputModeReal` before any act should tag a stable benign element with this testid;
  * the probe runs a non-mutating SCROLL_INTO_VIEW against it purely to read the reported inputMode.
  */
 export declare const PROBE_TESTID = "reticle-root";

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,eAAO,MAAM,UAAU;;;;CAAwD,CAAC;AAChF,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEtE,iEAAiE;AACjE,eAAO,MAAM,YAAY;;;;CAIsB,CAAC;AAEhD,mGAAmG;AACnG,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AAErD,wEAAwE;AACxE,eAAO,MAAM,KAAK;;;;;;;;;;;CAWR,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,YAAY,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,uDAAkD,CAAC;AAEtF,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,sGAAsG;AACtG,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAE3C,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;CAAoD,CAAC;AAC1E,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE,uEAAuE;AACvE,eAAO,MAAM,WAAW;;;CAA0C,CAAC;AACnE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEzE,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB,6BAA6B,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,eAAO,MAAM,UAAU;;;;CAAwD,CAAC;AAChF,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEtE,iEAAiE;AACjE,eAAO,MAAM,YAAY;;;;CAIsB,CAAC;AAEhD,mGAAmG;AACnG,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AAErD,wEAAwE;AACxE,eAAO,MAAM,KAAK;;;;;;;;;;;CAWR,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,YAAY,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,uDAAkD,CAAC;AAEtF,2GAA2G;AAC3G,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,sGAAsG;AACtG,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAE3C,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;CAAoD,CAAC;AAC1E,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE,uEAAuE;AACvE,eAAO,MAAM,WAAW;;;CAA0C,CAAC;AACnE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEzE,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB,6BAA6B,CAAC"}

package/dist/constants.js

@@ -24,12 +24,12 @@ export const JUnit = {
 /** Default JUnit <testsuite name=...> when the caller does not supply one. */
 export const DEFAULT_JUNIT_SUITE_NAME = 'reticle';
 /**
- * Skip reason `t.expectInputModeReal()` raises when the active input mode is 'synthetic'.
+ * Skip reason `t.expectInputModeReal` raises when the active input mode is 'synthetic'.
  * The runner turns the ReticleSkip carrying this into status:'skip' (never a silent pass).
  */
 export const SKIP_REASON_REAL_INPUT = 'real input not active — run via reticle drive';
-/** Default wait window for assertion matchers (reticle_assert timeout_ms). */
-export const DEFAULT_ASSERT_TIMEOUT_MS = 4000;
+/** Default wait window for assertion matchers — re-exported from core so it matches the server default. */
+export { DEFAULT_ASSERT_TIMEOUT_MS } from '@reticlehq/core';
 /** Predicate `kind` discriminants the matchers build. Mirrors @reticlehq/server's Predicate union. */
 export const PredicateKind = {
     SIGNAL: 'signal',
@@ -44,7 +44,7 @@ export const CONSOLE_LEVEL_ERROR = 'error';
 export const NO_ELEMENT_FOR_TESTID = 'no element for testid';
 /**
  * Default testid the input-mode probe resolves to when no act has run yet. Apps that opt into
- * `expectInputModeReal()` before any act should tag a stable benign element with this testid;
+ * `expectInputModeReal` before any act should tag a stable benign element with this testid;
  * the probe runs a non-mutating SCROLL_INTO_VIEW against it purely to read the reported inputMode.
  */
 export const PROBE_TESTID = 'reticle-root';

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAW,CAAC;AAGhF,iEAAiE;AACjE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;CACiC,CAAC;AAEhD,mGAAmG;AACnG,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAErD,wEAAwE;AACxE,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,WAAW;IAClB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,MAAM;IACjB,UAAU,EAAE,OAAO;IACnB,aAAa,EAAE,UAAU;IACzB,YAAY,EAAE,SAAS;IACvB,SAAS,EAAE,MAAM;IACjB,YAAY,EAAE,SAAS;CACf,CAAC;AAEX,8EAA8E;AAC9E,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAElD;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,+CAA+C,CAAC;AAEtF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAE9C,sGAAsG;AACtG,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;CACV,CAAC;AAGX,yEAAyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAE3C,sFAAsF;AACtF,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAW,CAAC;AAG1E,uEAAuE;AACvE,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAW,CAAC;AAGnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,eAAe,EAAE,kDAAkD;IACnE,UAAU,EAAE,kDAAkD;IAC9D,SAAS,EAAE,uDAAuD;CAC1D,CAAC;AAGX,8FAA8F;AAC9F,MAAM,CAAC,MAAM,sBAAsB,GAAG,0BAA0B,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAW,CAAC;AAGhF,iEAAiE;AACjE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;CACiC,CAAC;AAEhD,mGAAmG;AACnG,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAErD,wEAAwE;AACxE,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,WAAW;IAClB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,MAAM;IACjB,UAAU,EAAE,OAAO;IACnB,aAAa,EAAE,UAAU;IACzB,YAAY,EAAE,SAAS;IACvB,SAAS,EAAE,MAAM;IACjB,YAAY,EAAE,SAAS;CACf,CAAC;AAEX,8EAA8E;AAC9E,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAElD;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,+CAA+C,CAAC;AAEtF,2GAA2G;AAC3G,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,sGAAsG;AACtG,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;CACV,CAAC;AAGX,yEAAyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAE3C,sFAAsF;AACtF,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAW,CAAC;AAG1E,uEAAuE;AACvE,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAW,CAAC;AAGnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,eAAe,EAAE,kDAAkD;IACnE,UAAU,EAAE,kDAAkD;IAC9D,SAAS,EAAE,uDAAuD;CAC1D,CAAC;AAGX,8FAA8F;AAC9F,MAAM,CAAC,MAAM,sBAAsB,GAAG,0BAA0B,CAAC"}

package/dist/flow-spec.js

@@ -39,7 +39,7 @@ export function flowToSpec(flow, opts) {
         },
     };
 }
-/** An ERROR spec for a flow file that failed to load. Its run() returns a FAIL with no steps. */
+/** An ERROR spec for a flow file that failed to load. Its run returns a FAIL with no steps. */
 function errorSpec(name, code) {
     const result = {
         outcome: SpecOutcome.FAIL,

package/dist/flow-spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"flow-spec.js","sourceRoot":"","sources":["../src/flow-spec.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"flow-spec.js","sourceRoot":"","sources":["../src/flow-spec.ts"],"names":[],"mappings":"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"}

package/dist/input-mode.d.ts

@@ -3,7 +3,7 @@ import { InputMode } from '@reticlehq/core';
 /** The act envelope's inputMode field, narrowed from the raw tool result. */
 export declare function readInputMode(actResult: unknown): InputMode | undefined;
 /**
- * Tracks the most recent act's inputMode across a spec so `expectInputModeReal()` can read it
+ * Tracks the most recent act's inputMode across a spec so `expectInputModeReal` can read it
  * without re-touching the page. The context records every act through `record`.
  */
 export declare class InputModeTracker {

package/dist/input-mode.js

@@ -15,7 +15,7 @@ export function readInputMode(actResult) {
     return undefined;
 }
 /**
- * Tracks the most recent act's inputMode across a spec so `expectInputModeReal()` can read it
+ * Tracks the most recent act's inputMode across a spec so `expectInputModeReal` can read it
  * without re-touching the page. The context records every act through `record`.
  */
 export class InputModeTracker {

package/dist/skip.d.ts

@@ -1,5 +1,5 @@
 /**
- * The skip sentinel. MATCHERS' `t.expectInputModeReal()` throws this when the active input mode
+ * The skip sentinel. MATCHERS' `t.expectInputModeReal` throws this when the active input mode
  * is not 'real', so the runner reports `status:'skip'` (with the reason) instead of a silent pass.
  */
 export declare class ReticleSkip extends Error {

package/dist/skip.js

@@ -1,5 +1,5 @@
 /**
- * The skip sentinel. MATCHERS' `t.expectInputModeReal()` throws this when the active input mode
+ * The skip sentinel. MATCHERS' `t.expectInputModeReal` throws this when the active input mode
  * is not 'real', so the runner reports `status:'skip'` (with the reason) instead of a silent pass.
  */
 export class ReticleSkip extends Error {

package/dist/spec.d.ts

@@ -1,4 +1,4 @@
 import type { SpecFn } from './types.js';
-/** Public registration entry: `reticleTest('does X', async (t) => { ... })`. */
+/** Public registration entry: `reticleTest('does X', async (t) => {... })`. */
 export declare function reticleTest(name: string, fn: SpecFn): void;
 //# sourceMappingURL=spec.d.ts.map

package/dist/spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../src/spec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAE1D"}
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../src/spec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAE1D"}

package/dist/spec.js

@@ -1,5 +1,5 @@
 import { register } from './registry.js';
-/** Public registration entry: `reticleTest('does X', async (t) => { ... })`. */
+/** Public registration entry: `reticleTest('does X', async (t) => {... })`. */
 export function reticleTest(name, fn) {
     register({ name, fn });
 }

package/dist/spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec.js","sourceRoot":"","sources":["../src/spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,EAAU;IAClD,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC"}
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../src/spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,EAAU;IAClD,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reticlehq/test",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "Reticle test runner: reticleTest spec registry + a runner that drives Reticle tools without MCP/stdio.",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,8 +12,8 @@
     }
   },
   "dependencies": {
-    "@reticlehq/core": "2.1.0",
-    "@reticlehq/server": "2.1.0"
+    "@reticlehq/core": "2.2.1",
+    "@reticlehq/server": "2.2.1"
   },
   "peerDependencies": {
     "vitest": "^3.2.6"
@@ -45,6 +45,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "scripts": {
     "build": "tsc -b",
     "typecheck": "tsc -b",