@reticlehq/test 2.14.0 → 3.2.0

package/dist/{input-mode.js → context/input-mode.js}

@@ -1,7 +1,7 @@
 import { ReticleTool } from '@reticlehq/server';
 import { InputMode } from '@reticlehq/core';
-import { ReticleSkip } from './skip.js';
-import { SKIP_REASON_REAL_INPUT } from './constants.js';
+import { ReticleSkip } from '../outcome/skip.js';
+import { SKIP_REASON_REAL_INPUT } from '../outcome/constants.js';
 function isRecord(value) {
     return 'object' === typeof value && value !== null;
 }

package/dist/{matchers.js → context/matchers.js}

@@ -1,7 +1,7 @@
 import { ReticleTool } from '@reticlehq/server';
 import { Verified } from '@reticlehq/core';
-import { ReticleAssertionError } from './skip.js';
-import { CONSOLE_LEVEL_ERROR, DEFAULT_ASSERT_TIMEOUT_MS, PredicateKind } from './constants.js';
+import { ReticleAssertionError } from '../outcome/skip.js';
+import { CONSOLE_LEVEL_ERROR, DEFAULT_ASSERT_TIMEOUT_MS, PredicateKind, } from '../outcome/constants.js';
 /**
  * Did this verdict PROVE the thing the spec asserted?
  *

package/dist/{resolve.js → context/resolve.js}

@@ -1,7 +1,7 @@
 import { ReticleTool } from '@reticlehq/server';
 import { QueryBy } from '@reticlehq/core';
-import { ReticleQueryEmptyError } from './skip.js';
-import { NO_ELEMENT_FOR_TESTID } from './constants.js';
+import { ReticleQueryEmptyError } from '../outcome/skip.js';
+import { NO_ELEMENT_FOR_TESTID } from '../outcome/constants.js';
 function asQueryEnvelope(value) {
     if (typeof value !== 'object' || null === value)
         return {};

package/dist/flow-spec.d.ts

@@ -1,8 +1,8 @@
 import { type FlowErrorCode, type FlowFile, type FlowStepResult } from '@reticlehq/core';
 import { FlowStore } from '@reticlehq/server';
 import type { Clock, EvalResult, FileSystemPort, FlowReplaySession, WaitForSignal } from '@reticlehq/server';
-import { SpecKind, SpecMessage, SpecOutcome } from './constants.js';
-/** FLOW2SPEC — the result of running one RUNNABLE flow spec, evidence-bearing on a FAIL. */
+import { SpecKind, SpecMessage, SpecOutcome } from './outcome/constants.js';
+/** The result of running one RUNNABLE flow spec, evidence-bearing on a FAIL. */
 export interface SpecRunResult {
     outcome: SpecOutcome;
     /** Verbatim from replayFlow — carries each step's drift/nearest evidence. */
@@ -13,7 +13,7 @@ export interface SpecRunResult {
     message?: SpecMessage;
 }
 /**
- * FLOW2SPEC — one flow rendered as a runnable spec. Every spec carries `run`. A RUNNABLE spec
+ * One flow rendered as a runnable spec. Every spec carries `run`. A RUNNABLE spec
  * replays + asserts success; an ERROR spec (file missing/malformed/badly-named) carries `loadError`
  * and a `run` whose returned SpecRunResult is FAIL, so a corrupted flow fails loudly in the suite
  * rather than vanishing. The vitest binding (register.ts) turns the load error into a thrown Error.
@@ -45,7 +45,7 @@ export interface FlowsAsSpecsOptions extends FlowSpecOptions {
     clock?: Clock;
 }
 /**
- * FLOW2SPEC — enumerate a flows dir (or a live FlowStore) into FlowSpec[]. The map (.reticle/flows)
+ * Enumerate a flows dir (or a live FlowStore) into FlowSpec[]. The map (.reticle/flows)
  * IS the suite. An empty/absent dir yields [] (no throw). A malformed/badly-named file becomes an
  * ERROR spec; enumeration of its siblings is never aborted.
  */

package/dist/flow-spec.js

@@ -1,7 +1,7 @@
 import { AnchorKind, FLOW_SIGNAL_TIMEOUT_MS, } from '@reticlehq/core';
 import { FlowStore, createNodeFileSystem, replayFlow, waitForPredicate } from '@reticlehq/server';
-import { SpecKind, SpecMessage, SpecOutcome } from './constants.js';
-import { assertSuccess } from './success-assert.js';
+import { SpecKind, SpecMessage, SpecOutcome } from './outcome/constants.js';
+import { assertSuccess } from './outcome/success-assert.js';
 /** Derive the dynamic testid skip-set exactly as replayFlow does (testid anchors only). */
 function toDynamicSet(flow) {
     return new Set((flow.dynamic ?? [])
@@ -55,7 +55,7 @@ function errorSpec(name, code) {
     };
 }
 /**
- * FLOW2SPEC — enumerate a flows dir (or a live FlowStore) into FlowSpec[]. The map (.reticle/flows)
+ * Enumerate a flows dir (or a live FlowStore) into FlowSpec[]. The map (.reticle/flows)
  * IS the suite. An empty/absent dir yields [] (no throw). A malformed/badly-named file becomes an
  * ERROR spec; enumeration of its siblings is never aborted.
  */

package/dist/index.d.ts

@@ -5,18 +5,18 @@ export { summarize, printSummary } from './summary.js';
 export { toJUnitXml, writeJUnit } from './junit.js';
 export { bootSession } from './boot.js';
 export type { BootedRun, BootOptions } from './boot.js';
-export { ReticleSkip, ReticleAssertionError, ReticleQueryEmptyError, isSkip } from './skip.js';
-export type { AssertionDetail } from './skip.js';
+export { ReticleSkip, ReticleAssertionError, ReticleQueryEmptyError, isSkip, } from './outcome/skip.js';
+export type { AssertionDetail } from './outcome/skip.js';
 export { createTestContext } from './test-context.js';
 export type { TestContext, TestContextOptions, Predicate } from './test-context.js';
-export type { TestClock } from './clock.js';
-export { resolveTestid } from './resolve.js';
-export { expectInputModeReal, InputModeTracker, readInputMode } from './input-mode.js';
-export { TestStatus, STATUS_GLYPH, SUMMARY_FOOTER_PREFIX, JUnit, DEFAULT_JUNIT_SUITE_NAME, SKIP_REASON_REAL_INPUT, DEFAULT_ASSERT_TIMEOUT_MS, PredicateKind, PROBE_TESTID, } from './constants.js';
+export type { TestClock } from './context/clock.js';
+export { resolveTestid } from './context/resolve.js';
+export { expectInputModeReal, InputModeTracker, readInputMode } from './context/input-mode.js';
+export { TestStatus, STATUS_GLYPH, SUMMARY_FOOTER_PREFIX, JUnit, DEFAULT_JUNIT_SUITE_NAME, SKIP_REASON_REAL_INPUT, DEFAULT_ASSERT_TIMEOUT_MS, PredicateKind, PROBE_TESTID, } from './outcome/constants.js';
 export type { SpecContext, SpecFn, ReticleSpec, SpecResult, RunSummary, ContextFactory, RunnerOptions, } from './types.js';
 export { flowToSpec, flowsAsSpecs } from './flow-spec.js';
 export type { FlowSpec, FlowSpecOptions, FlowsAsSpecsOptions, SpecRunResult } from './flow-spec.js';
-export { assertSuccess, successToPredicate } from './success-assert.js';
+export { assertSuccess, successToPredicate } from './outcome/success-assert.js';
 export { registerFlowSpecs, FlowMalformedError, SpecFailure } from './register.js';
 export type { RegisterFn, RegisterFlowSpecsOptions } from './register.js';
-export { SpecKind, SpecOutcome, SpecMessage, FLOW_LOAD_ERROR_PREFIX } from './constants.js';
+export { SpecKind, SpecOutcome, SpecMessage, FLOW_LOAD_ERROR_PREFIX } from './outcome/constants.js';

package/dist/index.js

@@ -4,13 +4,13 @@ export { runSpecs, runOne } from './runner.js';
 export { summarize, printSummary } from './summary.js';
 export { toJUnitXml, writeJUnit } from './junit.js';
 export { bootSession } from './boot.js';
-export { ReticleSkip, ReticleAssertionError, ReticleQueryEmptyError, isSkip } from './skip.js';
+export { ReticleSkip, ReticleAssertionError, ReticleQueryEmptyError, isSkip, } from './outcome/skip.js';
 export { createTestContext } from './test-context.js';
-export { resolveTestid } from './resolve.js';
-export { expectInputModeReal, InputModeTracker, readInputMode } from './input-mode.js';
-export { TestStatus, STATUS_GLYPH, SUMMARY_FOOTER_PREFIX, JUnit, DEFAULT_JUNIT_SUITE_NAME, SKIP_REASON_REAL_INPUT, DEFAULT_ASSERT_TIMEOUT_MS, PredicateKind, PROBE_TESTID, } from './constants.js';
+export { resolveTestid } from './context/resolve.js';
+export { expectInputModeReal, InputModeTracker, readInputMode } from './context/input-mode.js';
+export { TestStatus, STATUS_GLYPH, SUMMARY_FOOTER_PREFIX, JUnit, DEFAULT_JUNIT_SUITE_NAME, SKIP_REASON_REAL_INPUT, DEFAULT_ASSERT_TIMEOUT_MS, PredicateKind, PROBE_TESTID, } from './outcome/constants.js';
 // flows under .reticle/flows become the runnable suite.
 export { flowToSpec, flowsAsSpecs } from './flow-spec.js';
-export { assertSuccess, successToPredicate } from './success-assert.js';
+export { assertSuccess, successToPredicate } from './outcome/success-assert.js';
 export { registerFlowSpecs, FlowMalformedError, SpecFailure } from './register.js';
-export { SpecKind, SpecOutcome, SpecMessage, FLOW_LOAD_ERROR_PREFIX } from './constants.js';
+export { SpecKind, SpecOutcome, SpecMessage, FLOW_LOAD_ERROR_PREFIX } from './outcome/constants.js';

package/dist/junit.js

@@ -1,4 +1,4 @@
-import { DEFAULT_JUNIT_SUITE_NAME, JUnit, TestStatus } from './constants.js';
+import { DEFAULT_JUNIT_SUITE_NAME, JUnit, TestStatus } from './outcome/constants.js';
 import { summarize } from './summary.js';
 /**
  * XML 1.0 section 2.2, the whole `Char` production:

package/dist/{constants.d.ts → outcome/constants.d.ts}

@@ -64,14 +64,14 @@ export declare const SpecKind: {
     readonly ERROR: "error";
 };
 export type SpecKind = (typeof SpecKind)[keyof typeof SpecKind];
-/** FLOW2SPEC: the binary outcome of running one RUNNABLE flow spec. */
+/** The binary outcome of running one RUNNABLE flow spec. */
 export declare const SpecOutcome: {
     readonly PASS: "pass";
     readonly FAIL: "fail";
 };
 export type SpecOutcome = (typeof SpecOutcome)[keyof typeof SpecOutcome];
 /**
- * FLOW2SPEC: the named failure/diagnostic messages a flow spec can carry — never a free string.
+ * The named failure/diagnostic messages a flow spec can carry — never a free string.
  * SUCCESS_NOT_MET: replay was clean but flow.success did not hold. STEP_DRIFT: a step anchor
  * drifted or its expect did not hold (replay stopped). EMPTY_DIR: documentation-only note that an
  * empty .reticle/flows yields zero specs.
@@ -82,5 +82,5 @@ export declare const SpecMessage: {
     readonly EMPTY_DIR: "no flows under .reticle/flows — zero specs registered";
 };
 export type SpecMessage = (typeof SpecMessage)[keyof typeof SpecMessage];
-/** FLOW2SPEC: prefix of the Error a malformed/missing flow file raises when its spec runs. */
+/** Prefix of the Error a malformed/missing flow file raises when its spec runs. */
 export declare const FLOW_LOAD_ERROR_PREFIX = "flow could not be loaded";

package/dist/{constants.js → outcome/constants.js}

@@ -54,10 +54,10 @@ export const PROBE_TESTID = 'reticle-root';
  * missing/malformed/badly-named, surfaces as an ERROR spec that fails loudly (never a silent skip).
  */
 export const SpecKind = { RUNNABLE: 'runnable', ERROR: 'error' };
-/** FLOW2SPEC: the binary outcome of running one RUNNABLE flow spec. */
+/** The binary outcome of running one RUNNABLE flow spec. */
 export const SpecOutcome = { PASS: 'pass', FAIL: 'fail' };
 /**
- * FLOW2SPEC: the named failure/diagnostic messages a flow spec can carry — never a free string.
+ * The named failure/diagnostic messages a flow spec can carry — never a free string.
  * SUCCESS_NOT_MET: replay was clean but flow.success did not hold. STEP_DRIFT: a step anchor
  * drifted or its expect did not hold (replay stopped). EMPTY_DIR: documentation-only note that an
  * empty .reticle/flows yields zero specs.
@@ -67,5 +67,5 @@ export const SpecMessage = {
     STEP_DRIFT: 'a step anchor drifted or its expect did not hold',
     EMPTY_DIR: 'no flows under .reticle/flows — zero specs registered',
 };
-/** FLOW2SPEC: prefix of the Error a malformed/missing flow file raises when its spec runs. */
+/** Prefix of the Error a malformed/missing flow file raises when its spec runs. */
 export const FLOW_LOAD_ERROR_PREFIX = 'flow could not be loaded';

package/dist/{success-assert.d.ts → outcome/success-assert.d.ts}

@@ -1,5 +1,5 @@
 /**
- * FLOW2SPEC — the flow success-assertion oracle now lives in @reticlehq/server so the live MCP
+ * The flow success-assertion oracle now lives in @reticlehq/server so the live MCP
  * `reticle_flow_replay` tool and this spec runner share ONE implementation (no divergent oracle).
  * Re-exported here to keep the spec-runner's import surface stable.
  */

package/dist/{success-assert.js → outcome/success-assert.js}

@@ -1,5 +1,5 @@
 /**
- * FLOW2SPEC — the flow success-assertion oracle now lives in @reticlehq/server so the live MCP
+ * The flow success-assertion oracle now lives in @reticlehq/server so the live MCP
  * `reticle_flow_replay` tool and this spec runner share ONE implementation (no divergent oracle).
  * Re-exported here to keep the spec-runner's import surface stable.
  */

package/dist/register.d.ts

@@ -19,7 +19,7 @@ export interface RegisterFlowSpecsOptions extends FlowsAsSpecsOptions {
     register?: RegisterFn;
 }
 /**
- * FLOW2SPEC — register one vitest test per flow under `source`. The agent-readable map (.reticle/flows)
+ * Register one vitest test per flow under `source`. The agent-readable map (.reticle/flows)
  * becomes the executable suite: a passing flow registers a green `it`, a malformed file registers a
  * loudly-failing ERROR `it`, an empty dir registers nothing. `getSession` is the seam — the
  * `reticle drive` launched session in CI, a fake in unit tests. MUST be awaited at module top level so

package/dist/register.js

@@ -1,4 +1,4 @@
-import { FLOW_LOAD_ERROR_PREFIX, SpecKind, SpecOutcome } from './constants.js';
+import { FLOW_LOAD_ERROR_PREFIX, SpecKind, SpecOutcome } from './outcome/constants.js';
 import { flowsAsSpecs } from './flow-spec.js';
 /** A loaded flow file was missing/malformed/badly-named — its spec throws this when run. */
 export class FlowMalformedError extends Error {
@@ -55,7 +55,7 @@ function specToCase(spec, getSession) {
     };
 }
 /**
- * FLOW2SPEC — register one vitest test per flow under `source`. The agent-readable map (.reticle/flows)
+ * Register one vitest test per flow under `source`. The agent-readable map (.reticle/flows)
  * becomes the executable suite: a passing flow registers a green `it`, a malformed file registers a
  * loudly-failing ERROR `it`, an empty dir registers nothing. `getSession` is the seam — the
  * `reticle drive` launched session in CI, a fake in unit tests. MUST be awaited at module top level so

package/dist/runner.js

@@ -1,5 +1,5 @@
-import { TestStatus } from './constants.js';
-import { isSkip } from './skip.js';
+import { TestStatus } from './outcome/constants.js';
+import { isSkip } from './outcome/skip.js';
 import { getRegistered } from './registry.js';
 import { summarize, printSummary } from './summary.js';
 /** Classify a thrown value: skip (sentinel) vs fail (everything else). */

package/dist/summary.js

@@ -1,4 +1,4 @@
-import { STATUS_GLYPH, SUMMARY_FOOTER_PREFIX, TestStatus } from './constants.js';
+import { STATUS_GLYPH, SUMMARY_FOOTER_PREFIX, TestStatus } from './outcome/constants.js';
 export function summarize(results) {
     let passed = 0;
     let failed = 0;

package/dist/test-context.d.ts

@@ -1,6 +1,6 @@
 import { type ToolInvoker } from '@reticlehq/server';
 import { ActionType, type ElementQuery, type ElementState } from '@reticlehq/core';
-import { type TestClock } from './clock.js';
+import { type TestClock } from './context/clock.js';
 /** A declarative predicate (the reticle_assert/until DSL). Kept structural to avoid a server type dep. */
 export type Predicate = Record<string, unknown>;
 export interface TestContextOptions {

package/dist/test-context.js

@@ -1,11 +1,11 @@
 import { ReticleTool } from '@reticlehq/server';
 import { ActionType } from '@reticlehq/core';
-import { resolveTestid } from './resolve.js';
-import { buildClock } from './clock.js';
-import { InputModeTracker, expectInputModeReal } from './input-mode.js';
-import { failFromVerdict, proved } from './matchers.js';
-import { expectAbsent, expectElement, expectNet, expectNoConsoleErrors, expectSignal, expectText, } from './matchers.js';
-import { DEFAULT_ASSERT_TIMEOUT_MS } from './constants.js';
+import { resolveTestid } from './context/resolve.js';
+import { buildClock } from './context/clock.js';
+import { InputModeTracker, expectInputModeReal } from './context/input-mode.js';
+import { failFromVerdict, proved } from './context/matchers.js';
+import { expectAbsent, expectElement, expectNet, expectNoConsoleErrors, expectSignal, expectText, } from './context/matchers.js';
+import { DEFAULT_ASSERT_TIMEOUT_MS } from './outcome/constants.js';
 function asVerdict(value) {
     const record = 'object' === typeof value && value !== null ? value : {};
     const verdict = record['verdict'];

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 import type { ToolInvoker } from '@reticlehq/server';
 import type { TestContext } from './test-context.js';
-import type { TestStatus } from './constants.js';
+import type { TestStatus } from './outcome/constants.js';
 /**
  * The per-spec `t` handed to a spec body.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reticlehq/test",
-  "version": "2.14.0",
+  "version": "3.2.0",
   "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.14.0",
-    "@reticlehq/server": "2.14.0"
+    "@reticlehq/core": "3.2.0",
+    "@reticlehq/server": "3.2.0"
   },
   "peerDependencies": {
     "vitest": "^3.2.6"
@@ -23,12 +23,12 @@
       "optional": true
     }
   },
-  "license": "SEE LICENSE IN LICENSE",
+  "license": "FSL-1.1-ALv2",
   "author": "Reticle contributors",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/reticlehq/reticle.git",
-    "directory": "packages/test"
+    "directory": "spec-runner"
   },
   "homepage": "https://github.com/reticlehq/reticle#readme",
   "bugs": "https://github.com/reticlehq/reticle/issues",
@@ -49,7 +49,7 @@
     "node": ">=20.0.0"
   },
   "scripts": {
-    "build": "tsc -b",
+    "build": "tsc -b && node ../scripts/alias-dist.mjs",
     "typecheck": "tsc -b",
     "lint": "eslint src",
     "test:unit": "vitest run src --passWithNoTests",