@rulvar/testing 1.0.0 → 1.2.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { a as FAKE_MODEL, c as FakeAdapterOptions, d as FakeToolCallsValue, f as FakeWireErrorValue, i as createTestEngine, l as FakeCall, m as fakeWireError, n as TestEngine, o as FAKE_MODEL_REF, p as fakeToolCalls, r as TestRunHandle, s as FakeAdapter, t as CreateTestEngineOptions, u as FakeResponder } from "./test-engine-kYp9C72n.js";
+import { a as FAKE_MODEL, c as FakeAdapterOptions, d as FakeToolCallsValue, f as FakeWireErrorValue, i as createTestEngine, l as FakeCall, m as fakeWireError, n as TestEngine, o as FAKE_MODEL_REF, p as fakeToolCalls, r as TestRunHandle, s as FakeAdapter, t as CreateTestEngineOptions, u as FakeResponder } from "./test-engine-DwJtTU7M.js";
 import { AgentProfile, ChatEvent, ChatRequest, InvocationRole, JournalEntry, JournalStore, ModelCaps, ModelSpec, ProviderAdapter, ResumePreview, RunOutcome, WireError, Workflow, createEngine } from "@rulvar/core";
 
 //#region src/replay-strict.d.ts
@@ -36,7 +36,7 @@ interface CassetteFixture {
 }
 declare function buildM2CassetteFixtures(): CassetteFixture[];
 /**
-* The frozen v1 journal (docs/11, section "Frozen journal fixtures"): a
+* The frozen v1 journal: a
 * round-1 JSONL file with kinds agent, step, rand, external, approval and
 * the legacy `v: 1` field (no hashVersion member). Returned as raw
 * JSON-ready objects, one per line.
@@ -68,7 +68,7 @@ declare function normalizeM6Entries(entries: readonly JournalEntry[]): JournalEn
 * Phase 1: record the pre-crash journal. The transcripts store carries
 * the boundary checkpoint the resume restores from; the recorder keeps
 * it in memory because the cassette pins only journal bytes (checkpoint
-* blobs are engine-internal at-least-once state, docs/03 section 11).
+* blobs are engine-internal at-least-once state).
 */
 declare function recordOrchestratorCrash(): Promise<{
   entries: JournalEntry[]; /** Boundary checkpoint blobs by ref, base64: the resume restores from them. */
@@ -98,14 +98,14 @@ interface VcrHeader {
 type RedactFn = (value: string) => string;
 /**
 * Built-in redaction: authorization material never reaches cassette
-* bytes (docs/11, section 5.2). Deliberately aggressive; compose a
+* bytes. Deliberately aggressive; compose a
 * custom hook for payload-specific secrets.
 */
 declare function defaultRedact(value: string): string;
 /**
 * The cassette key: a hash of the canonical wire-contract request. The
-* engine-populated telemetry namespace is excluded (docs/04, section
-* 1.8: never identity); everything else the adapter would send keys the
+* engine-populated telemetry namespace is excluded (never identity);
+* everything else the adapter would send keys the
 * row.
 */
 declare function requestHash(req: ChatRequest): string;
@@ -133,8 +133,7 @@ declare function readCassette(path: string): VcrCassette;
 /**
 * Builds replay adapters from a cassette. `onMiss: 'throw'` is the
 * hermetic CI mode; `'passthrough'` forwards unrecorded requests to the
-* matching live adapter in `adapters` (a development convenience only,
-* docs/11 section 5.1).
+* matching live adapter in `adapters` (a development convenience only).
 */
 declare function replay(options: {
   cassette: string;

package/dist/index.js

@@ -7,8 +7,7 @@ import { createHash } from "node:crypto";
 * FakeAdapter (M1-T14): a REAL ProviderAdapter that resolves calls from
 * declared patterns instead of the network, behind the same seam as live
 * adapters, so unit tests run through the full engine: journal, scheduler,
-* budget layers, and event stream (docs/09, section "Tier 1: FakeAdapter
-* and createTestEngine"). Calls cost zero USD.
+* budget layers, and event stream. Calls cost zero USD.
 */
 /** Scripts a tool-calling turn from a responder. */
 function fakeToolCalls(...calls) {
@@ -204,8 +203,8 @@ var FakeAdapter = class {
 /**
 * createTestEngine (M1-T14): a full engine over FakeAdapter with zero
 * network. Orchestration logic is exercised, not mocked around: journal,
-* scheduler, budget layers, and event stream are all real (docs/09,
-* section "Tier 1"). Returned handles record their event stream so the
+* scheduler, budget layers, and event stream are all real. Returned
+* handles record their event stream so the
 * matchers can assert over settled runs.
 */
 function createTestEngine(options) {
@@ -257,8 +256,7 @@ function createTestEngine(options) {
 * against an existing journal and throws JournalMissError on ANY live
 * call: zero live calls or loud failure. Any production journal becomes a
 * deterministic integration test; a journal with open suspensions
-* completes with outcome 'suspended' and zero live calls (docs/09,
-* section "Tier 3: replay-strict journal runs").
+* completes with outcome 'suspended' and zero live calls.
 */
 const FAKE_ROUTING = {
 	loop: FAKE_MODEL_REF,
@@ -317,10 +315,9 @@ async function replayRun(wf, args, options) {
 * The COMMITTED files under repo cassettes/ and
 * packages/testing/fixtures/frozen/ are the contract; these builders
 * exist to regenerate them DELIBERATELY (scripts/record-m2-cassettes.mjs)
-* and to fail loudly in CI when key derivation drifts (docs/11, section
-* "Frozen journal fixtures": regenerating fixtures to make a test pass is
-* forbidden by policy; any diff requires an explicit hashVersion-bump
-* changeset).
+* and to fail loudly in CI when key derivation drifts (regenerating
+* fixtures to make a test pass is forbidden by policy; any diff requires
+* an explicit hashVersion-bump changeset).
 */
 const BASE_MS$1 = Date.parse("2026-02-01T00:00:00.000Z");
 const SPAN$1 = "fixture-span";
@@ -866,7 +863,7 @@ function buildM2CassetteFixtures() {
 	return fixtures;
 }
 /**
-* The frozen v1 journal (docs/11, section "Frozen journal fixtures"): a
+* The frozen v1 journal: a
 * round-1 JSONL file with kinds agent, step, rand, external, approval and
 * the legacy `v: 1` field (no hashVersion member). Returned as raw
 * JSON-ready objects, one per line.
@@ -919,7 +916,7 @@ function buildFrozenV1JournalRaw() {
 		};
 	});
 }
-/** The docs/03 section 1.5 worked example, frozen as executable data. */
+/** The agent identity worked example, frozen as executable data. */
 const WORKED_EXAMPLE_INPUT = {
 	kind: "agent",
 	agentType: "reviewer",
@@ -1041,7 +1038,7 @@ function buildV2GoldenIdentity() {
 * producer arrives with mode (c) in M6/M7. Timestamps and span ids are
 * normalized deterministically after recording (matching never reads
 * them); regeneration is DELIBERATE per the frozen-fixture policy
-* (docs/11).
+* (https://docs.rulvar.com/guide/testing).
 */
 const BASE_MS = Date.parse("2026-02-01T00:00:00.000Z");
 const SPAN = "fixture-span";
@@ -1175,7 +1172,7 @@ function subtreeChildReport() {
 * The orchestrator-subtree shape: written through the KERNEL write APIs
 * (the same calls mode (c) spawning uses from M6), since no script-mode
 * producer can spawn agents under an agent scope yet; re-recorded again
-* live in M7 with the orchestrator producers (docs/10, cassette plan).
+* live in M7 with the orchestrator producers.
 */
 async function recordAbandonSubtree() {
 	let tick = 0;
@@ -1283,7 +1280,7 @@ function frozenV1JournalPath() {
 	throw new Error("frozen v1-journal.jsonl not found next to the recorder");
 }
 /**
-* effort-defaults-shift (DEF-6; docs/10 M4 gating row): the frozen v1
+* effort-defaults-shift (DEF-6): the frozen v1
 * prefix (recorded without effort) is closed offline the way an
 * operator would (the external resolves, the approval flow is
 * abandoned under its authority), then the SAME flow resumes LIVE under
@@ -1342,7 +1339,7 @@ function liveEngine(store, agents) {
 		} }
 	});
 }
-/** An offline kernel writer over the loaded priors (docs/03, section 8). */
+/** An offline kernel writer over the loaded priors. */
 async function offlineReplayer(store, runId) {
 	let tick = 500;
 	return new Replayer({
@@ -1369,7 +1366,7 @@ function suspendedSeqOf(entries, key) {
 * DEF-4 timeout-vs-live-race, LIVE form: the run suspends on the
 * decision, the LIVE resolution wins through RunHandle.resolveExternal,
 * and the late timer attempt lands through the offline kernel writer as
-* the journaled noop (first-wins; docs/03, 8.6).
+* the journaled noop (first-wins).
 */
 async function recordTimeoutVsLiveRace() {
 	const store = new InMemoryStore();
@@ -1402,7 +1399,7 @@ async function recordTimeoutVsLiveRace() {
 * the first closes individually (applied by external); ONE class-level
 * decision entry closes the remaining two by class_decision with the
 * decisionRef, and the late class attempt against the first lands noop
-* (docs/03, 8.6; the plan-side class producer has its own cassette,
+* (the plan-side class producer has its own cassette,
 * class-storm-single-turn).
 */
 async function recordClassDecisionFanout() {
@@ -1740,7 +1737,7 @@ function normalizeM6Entries(entries) {
 * Phase 1: record the pre-crash journal. The transcripts store carries
 * the boundary checkpoint the resume restores from; the recorder keeps
 * it in memory because the cassette pins only journal bytes (checkpoint
-* blobs are engine-internal at-least-once state, docs/03 section 11).
+* blobs are engine-internal at-least-once state).
 */
 async function recordOrchestratorCrash() {
 	let orchestratorTurn = 0;
@@ -1803,8 +1800,8 @@ async function recordOrchestratorCrash() {
 //#endregion
 //#region src/vcr.ts
 /**
-* VCR cassettes at the adapter boundary (M5-T04; docs/09, section 5.2;
-* docs/11, section 5): `record` wraps live adapters and captures
+* VCR cassettes at the adapter boundary (M5-T04): `record` wraps
+* live adapters and captures
 * request/event pairs into a redacted JSONL cassette keyed by a hash of
 * the canonical wire-contract request; `replay` serves recorded streams
 * back with `onMiss: 'throw'` (hermetic CI) or `'passthrough'` (mixed
@@ -1823,7 +1820,7 @@ async function recordOrchestratorCrash() {
 */
 /**
 * Built-in redaction: authorization material never reaches cassette
-* bytes (docs/11, section 5.2). Deliberately aggressive; compose a
+* bytes. Deliberately aggressive; compose a
 * custom hook for payload-specific secrets.
 */
 function defaultRedact(value) {
@@ -1843,8 +1840,8 @@ function canonicalJson(value) {
 }
 /**
 * The cassette key: a hash of the canonical wire-contract request. The
-* engine-populated telemetry namespace is excluded (docs/04, section
-* 1.8: never identity); everything else the adapter would send keys the
+* engine-populated telemetry namespace is excluded (never identity);
+* everything else the adapter would send keys the
 * row.
 */
 function requestHash(req) {
@@ -1918,8 +1915,7 @@ function readCassette(path) {
 /**
 * Builds replay adapters from a cassette. `onMiss: 'throw'` is the
 * hermetic CI mode; `'passthrough'` forwards unrecorded requests to the
-* matching live adapter in `adapters` (a development convenience only,
-* docs/11 section 5.1).
+* matching live adapter in `adapters` (a development convenience only).
 */
 function replay(options) {
 	const { rows } = readCassette(options.cassette);

package/dist/matchers.d.ts

@@ -1,4 +1,4 @@
-import { r as TestRunHandle } from "./test-engine-kYp9C72n.js";
+import { r as TestRunHandle } from "./test-engine-DwJtTU7M.js";
 
 //#region src/matchers.d.ts
 interface MatcherResult {

package/dist/{test-engine-kYp9C72n.d.ts → test-engine-DwJtTU7M.d.ts}

@@ -38,7 +38,7 @@ declare function fakeWireError(error: WireError): FakeWireErrorValue;
 interface FakeAdapterOptions {
   /**
   * Patterns match on agentType, label, or a regex over the prompt; '*'
-  * is the fallback (docs/09, section "Tier 1").
+  * is the fallback.
   */
   agents: Record<string, FakeResponder>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulvar/testing",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "rulvar test harness: createTestEngine, FakeAdapter, VCR cassettes, replay-strict runs, matchers.",
   "type": "module",
   "license": "Apache-2.0",
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@rulvar/core": "1.0.0"
+    "@rulvar/core": "1.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.0",