@smoothbricks/lmao 0.2.3 → 0.3.0

package/README.md

@@ -1,269 +1,269 @@
-# lmao
+# @smoothbricks/lmao
 
-This library was generated with [Nx](https://nx.dev).
+A high-performance, type-safe structured tracing and observability library for TypeScript.
 
-## Building
+Instrumented code writes spans directly into columnar [Apache Arrow](https://arrow.apache.org/) buffers — near-zero
+hot-path overhead — and emits queryable Arrow tables that persist to SQLite (a local file, Node, or Cloudflare D1). A
+headline feature is **trace-testing**: assert on the span tree your code emits instead of on return values.
 
-Run `nx build lmao` to build the library.
+- **Type-safe by construction.** Your log schema drives the types of `ctx.tag`, `ctx.log`, feature flags, and results —
+  autocomplete everywhere, no casts.
+- **Columnar & cheap.** Attributes are written to fixed buffer positions; string columns are dictionary-encoded. No
+  per-event object allocation on the hot path.
+- **Arrow-native.** Convert a trace to an Arrow table and persist it to SQLite/D1, or analyze it with the companion
+  inspector.
 
-## Trace Testing
+> Part of the `smoothbricks` monorepo. Full documentation lives in [`targets/lmao-docs/`](../../targets/lmao-docs) (an Astro Starlight
+> site). Runnable examples are in [`examples/`](./examples).
 
-LMAO provides a trace-testing system where each test creates queryable trace spans. Instead of testing return values
-directly, you execute code that emits trace facts and assert on WHAT happened.
+## Install
 
-### Quick Start (bun:test)
-
-1. Create a preload file:
-
-```typescript
-// test-trace-setup.ts (preload)
-import * as bunTest from 'bun:test';
-import { mock } from 'bun:test';
-import { createBunTestMock, initTraceTestRun } from '@smoothbricks/lmao/testing/bun';
-import { myOpContext } from './src/opContext.js';
-
-initTraceTestRun(myOpContext, { sqlite: { dbPath: '.trace-results.db' } });
-mock.module('bun:test', () => createBunTestMock(bunTest));
+```bash
+bun add @smoothbricks/lmao
 ```
 
-`mock.module` MUST be called from the preload file itself — bun only intercepts subsequent imports when the mock is
-registered from the entry module context.
-
-2. Add to `bunfig.toml`:
+## Quick start
+
+```ts
+import {
+  defineLogSchema,
+  defineOpContext,
+  JsBufferStrategy,
+  S,
+  StdioTracer,
+} from '@smoothbricks/lmao';
+import { createTraceRoot } from '@smoothbricks/lmao/node'; // or '/es' for browsers/Workers
+
+// 1. Describe your columns. Pick a string strategy per field:
+//    S.enum (known set, 1 byte) · S.category (repeating, dictionary) · S.text (mostly unique)
+const schema = defineLogSchema({
+  userId: S.category(),
+  operation: S.enum(['SELECT', 'INSERT', 'UPDATE', 'DELETE']),
+  duration: S.number(),
+});
 
-```toml
-[test]
-preload = ["./test-trace-setup.ts"]
-```
+// 2. Bundle the schema into an op context.
+const opContext = defineOpContext({ logSchema: schema });
+const { defineOp } = opContext;
 
-3. Write tests — import from `bun:test` as normal, `mock.module` intercepts transparently:
+// 3. Define an op. Its body receives a typed SpanContext (`ctx`).
+const createUser = defineOp('create-user', async (ctx, email: string) => {
+  ctx.tag.userId(email).operation('INSERT');
+  ctx.log.info('creating {{userId}}').userId(email); // {{field}} = template, value set via the chain
 
-```typescript
-import { describe, it, expect } from 'bun:test';
-import { useTestSpan } from '@smoothbricks/lmao/testing/bun';
-import { querySpan, findSpan } from '@smoothbricks/lmao/testing';
-
-describe('Order Processing', () => {
-  it('validates and saves order', async () => {
-    const ctx = useTestSpan();
+  const validated = await ctx.span('validate', async (child) => {
+    child.tag.operation('SELECT');
+    return child.ok({ valid: true });
+  });
+  if (!validated.success) return ctx.err(new Error('validation failed'));
 
-    await ctx.span('processOrder', async (child) => {
-      child.tag.orderId('123');
-      await child.span('validate', async (v) => v.ok(true));
-      await child.span('save', async (s) => s.ok({ id: 'order-123' }));
-      return child.ok({ status: 'saved' });
-    });
+  return ctx.ok({ id: 'user-1', email }).with({ duration: 12 });
+});
 
-    // Query the trace tree
-    const q = querySpan(ctx.buffer);
-    expect(q.names()).toEqual(['processOrder', 'validate', 'save']);
-    expect(q.find('validate')).toBeDefined();
-    expect(findSpan(ctx.buffer, 'save')).toBeDefined();
-  });
+// 4. Build a tracer and run at the request boundary.
+const { trace } = new StdioTracer(opContext, {
+  bufferStrategy: new JsBufferStrategy(),
+  createTraceRoot,
 });
+
+const result = await trace('create-user', createUser, 'ada@example.com');
+console.log(result.success ? result.value : result.error);
 ```
 
-Note: `describe`/`it`/`expect` are imported from `bun:test` as normal — `mock.module` intercepts transparently. Only
-`useTestSpan` comes from `@smoothbricks/lmao/testing/bun`.
+## Core API
+
+### Schema (`S` + `defineLogSchema`)
 
-### Quick Start (vitest)
+| Builder | Use |
+|---|---|
+| `S.enum([...])` | A fixed set of known values (stored as 1 byte). |
+| `S.category()` | Repeating strings (dictionary-encoded). |
+| `S.text()` | Mostly-unique strings (no dictionary). |
+| `S.number()` | Numeric column. |
+| `S.boolean()` | Boolean column (bit-packed). |
 
-1. Configure vitest:
+### `defineOpContext`
 
-```typescript
-// vitest.config.ts
-export default defineConfig({
-  test: { setupFiles: ['./test-setup.ts'] },
+```ts
+const opContext = defineOpContext({
+  logSchema,        // required
+  flags,            // optional: defineFeatureFlags(...).schema
+  deps,             // optional: other op groups, wired with .prefix()/.mapColumns()
+  ctx: {            // optional: user context carried on every span
+    requestId: undefined as string | undefined,
+  },
 });
+const { defineOp, defineOps } = opContext;
 ```
 
-2. Create the setup file with `vi.mock` for transparent interception:
+`defineOp(name, fn)` creates a single op; `defineOps({ ... })` batches ops into a reusable group.
 
-```typescript
-// test-setup.ts
-import { vi } from 'vitest';
-import { createNodeSQLiteDatabase } from '@smoothbricks/lmao/sqlite/node';
-import { myOpContext } from './src/opContext.js';
+### `SpanContext` (`ctx`)
 
-vi.mock('vitest', async (importOriginal) => {
-  const [mod, { createVitestMock }] = await Promise.all([
-    importOriginal(),
-    import('@smoothbricks/lmao/testing/vitest'),
-  ]);
-  return createVitestMock(mod as Record<string, unknown>);
-});
+The object every op body receives:
 
-import { initTraceTestRun } from '@smoothbricks/lmao/testing/vitest';
-initTraceTestRun(myOpContext, {
-  sqlite: { dbPath: '.trace-results.db', createDatabase: createNodeSQLiteDatabase },
-});
-```
+| Member | What it does |
+|---|---|
+| `ctx.tag.field(value)` | Set span-start attributes (row 0). Chainable; `ctx.tag.with({...})` sets several. |
+| `ctx.log.info/debug/warn/error(msg)` | Append a log event. `msg` is a `{{field}}` template; attach values via the chain. |
+| `ctx.span(name, opOrFn, ...args)` | Open a child span; returns `Promise<Result>`. |
+| `ctx.spanSync(name, fn)` | Open a **synchronous** child span; `fn` returns a `Result` directly (no `await`). |
+| `ctx.ok(value)` / `ctx.err(error)` | Complete the span. Both chain `.with({...})` and `.message('...')`. |
+| `ctx.setScope({...})` / `ctx.scope` | Set/read attributes inherited by all subsequent logs and child spans. |
+| `ctx.ff` | Feature-flag access (present when `flags` is declared). |
+| `ctx.deps` | Declared dependency op groups. |
+| `ctx.buffer` | The underlying span buffer (used in tests and for Arrow conversion). |
+| user context | Anything declared in `ctx: {...}` (e.g. `ctx.requestId`). |
 
-3. Write tests — import from `vitest` as normal, `vi.mock` intercepts transparently:
+### Results & typed errors
 
-```typescript
-import { describe, it, expect } from 'vitest';
-import { useTestSpan } from '@smoothbricks/lmao/testing/vitest';
-import { querySpan, findSpan } from '@smoothbricks/lmao/testing';
+Ops return a `Result` — check `result.success`, then read `result.value` or `result.error`. Error codes are typed
+factories:
 
-describe('Order Processing', () => {
-  it('validates and saves order', async () => {
-    const ctx = useTestSpan();
+```ts
+import { defineCodeError } from '@smoothbricks/lmao';
 
-    await ctx.span('processOrder', async (child) => {
-      child.tag.orderId('123');
-      await child.span('validate', async (v) => v.ok(true));
-      return child.ok({ status: 'saved' });
-    });
+const NOT_FOUND = defineCodeError('NOT_FOUND')<{ userId: string }>();
 
-    const q = querySpan(ctx.buffer);
-    expect(q.names()).toContain('validate');
-    expect(findSpan(ctx.buffer, 'processOrder')).toBeDefined();
-  });
+const getUser = defineOp('get-user', async (ctx, id: string) => {
+  const user = await lookup(id);
+  return user ? ctx.ok(user) : ctx.err(NOT_FOUND({ userId: id }));
 });
+
+const r = await trace('get-user', getUser, 'u1');
+if (r.success) {
+  console.log(r.value);
+} else {
+  console.log(r.error.code, r.error.userId); // 'NOT_FOUND' + the typed payload field
+}
 ```
 
-Both bun:test and vitest use the same transparent interception pattern — tests import from their native test module as
-normal. Only `useTestSpan` (for accessing the it-local trace root) comes from the lmao testing module.
+## Tracers
+
+Construct a tracer with `new SomeTracer(opContext, options)`, then destructure `trace`. Every tracer needs a
+`bufferStrategy` (`new JsBufferStrategy()`) and a `createTraceRoot` (from `@smoothbricks/lmao/node` for Node, or `/es`
+for browsers/Deno/Workers).
+
+| Tracer | Use |
+|---|---|
+| `StdioTracer` | Print the span tree to the console. |
+| `TestTracer` | Keep completed traces in memory (`tracer.rootBuffers`) for inspection/tests. |
+| `ArrayQueueTracer` | Queue completed traces for batch processing (`tracer.drain()`). |
+| `SQLiteTracer` / `SQLiteAsyncTracer` | Persist to a synchronous SQLite DB, or an async one (e.g. D1). |
+| `CompositeTracer` | Fan out to several tracers. |
+| `NoOpTracer` | Execute ops without emitting. |
+
+```ts
+// trace() runs an op (or an inline fn) as the root span; overrides carry user-context values.
+await trace('greet', greet);
+await trace('greet', { requestId: 'req-1' }, greet, ...args);
+```
 
-#### Cloudflare Worker + Vitest notes
+## Feature flags
 
-- Keep the setup file wiring-only: call `setupVitestTestSuiteTracing(...)` and keep the `vi.mock('vitest', ...)` bridge
-  with `createVitestMock(...)`.
-- Configure SQLite sink in the package-local vitest tracer module (not in test files) so worker suites flush to a
-  worker-appropriate SQLite target (for example `d1://TRACE_RESULTS`).
-- Debug logging is harness-owned and toggled by `LMAO_VITEST_DEBUG`.
-- Verbose trace replay is toggled by `LMAO_TEST_TRACE_VERBOSE` (prints spans to stdout and still flushes SQLite).
-- In Worker tests, forward the debug env in `vitest.config.ts` via `define`, for example
-  `globalThis.__LMAO_VITEST_DEBUG_ENV__`, and do the same for `globalThis.__LMAO_TEST_TRACE_VERBOSE_ENV__` when verbose
-  replay is needed.
-- Enable debug for Cloudflare tests with:
+Declare flags, pass the schema to `defineOpContext`, and supply an evaluator **to the tracer**:
 
-```bash
-```
+```ts
+import { defineFeatureFlags, InMemoryFlagEvaluator, S } from '@smoothbricks/lmao';
 
-### Setting Up Trace Testing for a New Package
+const flags = defineFeatureFlags({
+  advancedValidation: S.boolean().default(false).sync(),
+  maxRetries: S.number().default(3).sync(),
+});
 
-1. Create the preload file (`test-trace-setup.ts`):
+const opContext = defineOpContext({ logSchema: schema, flags: flags.schema });
 
-```typescript
-import * as bunTest from 'bun:test';
-import { mock } from 'bun:test';
-import { createBunTestMock, initTraceTestRun } from '@smoothbricks/lmao/testing/bun';
-import { myOpContext } from './src/opContext.js';
+const { trace } = new StdioTracer(opContext, {
+  bufferStrategy: new JsBufferStrategy(),
+  createTraceRoot,
+  flagEvaluator: new InMemoryFlagEvaluator(flags.schema, { advancedValidation: true, maxRetries: 5 }),
+});
 
-initTraceTestRun(myOpContext, { sqlite: { dbPath: '.trace-results.db' } });
-mock.module('bun:test', () => createBunTestMock(bunTest));
+// Inside an op — sync flags are read as `ctx.ff.<name>?.value`:
+if (ctx.ff.advancedValidation?.value) { /* ... */ }
 ```
 
-2. Add `bunfig.toml`:
+## Persist & analyze
 
-```toml
-[test]
-preload = ["./test-trace-setup.ts"]
-```
+Convert a completed trace to an Arrow table, then persist or query it:
 
-3. Tests import `describe`/`it`/`expect` from `bun:test` as normal — the mock intercepts transparently.
+```ts
+import { convertSpanTreeToArrowTable } from '@smoothbricks/lmao';
 
-4. Add `.trace-results.db` to `.gitignore`.
+const table = convertSpanTreeToArrowTable(tracer.rootBuffers[0]);
+console.log(table.numRows, table.names);
+```
 
-### Querying Trace Results
+- **SQLite / D1** — use `SQLiteTracer`/`SQLiteAsyncTracer` with `createNodeSQLiteDatabase` (`@smoothbricks/lmao/sqlite/node`)
+  or `createD1SQLiteDatabase` (`@smoothbricks/lmao/sqlite`).
+- **Query engine** — the companion package [`@smoothbricks/lmao-inspector`](../lmao-inspector) runs SQL over exported
+  Arrow data in the browser.
 
-After a test run, the trace database is written to the configured path. The `trace_id` is printed at the end:
+## Trace-testing
 
-```
-[trace] trace_id: 550e8400-e29b-41d4-a716-446655440000 → .trace-results.db
-```
+Assert on **what your code did**, not just what it returned. Each test's ops emit a queryable span tree.
 
-The `trace_id` IS the run identifier — one root span per test run, with each `it()` as a child span.
+```ts
+import { describe, it, expect } from 'bun:test';
+import { useTestSpan } from '@smoothbricks/lmao/testing/bun';
+import { querySpan, findSpan } from '@smoothbricks/lmao/testing';
 
-**SQLite CLI queries:**
+describe('order processing', () => {
+  it('validates and saves', async () => {
+    const ctx = useTestSpan();
 
-```bash
-# All spans for the latest trace (root span name = 'test-run')
-sqlite3 .trace-results.db "SELECT s0.message, s0.describe FROM spans s0 WHERE s0.row_index = 0 ORDER BY s0.timestamp_ns"
-
-# Find root span_id, then query it-level spans
-sqlite3 .trace-results.db "
-  SELECT s0.message AS test_name, s0.describe,
-         CASE WHEN s1.entry_type = 2 THEN 'ok'
-              WHEN s1.entry_type = 3 THEN 'err'
-              WHEN s1.entry_type = 4 THEN 'exception'
-              ELSE 'running' END AS status,
-         s1.timestamp_ns - s0.timestamp_ns AS duration_ns
-  FROM spans s0
-  LEFT JOIN spans s1 ON s1.trace_id = s0.trace_id AND s1.span_id = s0.span_id AND s1.row_index = 1
-  WHERE s0.trace_id = (SELECT trace_id FROM spans WHERE parent_span_id = 0 AND row_index = 0 ORDER BY timestamp_ns DESC LIMIT 1)
-    AND s0.parent_span_id = (SELECT span_id FROM spans WHERE parent_span_id = 0 AND row_index = 0 ORDER BY timestamp_ns DESC LIMIT 1)
-    AND s0.row_index = 0
-  ORDER BY s0.timestamp_ns"
-
-# All tests under a specific describe group
-sqlite3 .trace-results.db "SELECT message FROM spans WHERE describe = 'Order Processing > validation' AND row_index = 0"
-
-# Nested describe paths use ' > ' separator
-sqlite3 .trace-results.db "SELECT DISTINCT describe FROM spans WHERE describe IS NOT NULL AND row_index = 0"
-```
+    await ctx.span('processOrder', async (child) => {
+      child.tag.orderId('123');
+      await child.span('validate', async (v) => v.ok(true));
+      await child.span('save', async (s) => s.ok({ id: 'order-123' }));
+      return child.ok({ status: 'saved' });
+    });
 
-**Schema:**
-
-| Column           | Description                                                      |
-| ---------------- | ---------------------------------------------------------------- |
-| `trace_id`       | Run identifier (= root span's trace_id)                          |
-| `span_id`        | Unique span counter within trace                                 |
-| `parent_span_id` | Parent span (0 = root, root's span_id = it-level)                |
-| `row_index`      | Row within span (0 = span-start, 1 = span-end, 2+ = log entries) |
-| `entry_type`     | 1=span-start, 2=span-ok, 3=span-err, 4=span-exception            |
-| `timestamp_ns`   | Nanosecond timestamp                                             |
-| `message`        | Span name (row 0), log message (rows 2+)                         |
-| `describe`       | `' > '`-separated describe path (user schema column)             |
-| `...`            | Additional user schema columns added dynamically via ALTER TABLE |
-
-Tree structure is encoded via `span_id` / `parent_span_id`. The root span (`parent_span_id = 0`) represents the entire
-test run. Each `it()` is a direct child of the root. User operations create deeper children.
-
-**TraceQuery API (programmatic access):**
-
-```typescript
-import { Database } from 'bun:sqlite';
-import { TraceQuery } from '@smoothbricks/lmao/testing';
-
-const query = new TraceQuery(new Database('.trace-results.db'));
-query.failures(); // all failed tests
-query.slowest(undefined, 10); // 10 slowest tests
-query.findSpans('%validate%'); // spans matching pattern
-query.testTree('my-test'); // full span tree for a test
-query.close();
+    const q = querySpan(ctx.buffer);
+    expect(q.names()).toEqual(['processOrder', 'validate', 'save']);
+    expect(findSpan(ctx.buffer, 'save')).toBeDefined();
+  });
+});
 ```
 
-### Querying Span Results (in-test)
+Setup is wiring-only: a preload/setup file calls `initTraceTestRun(opContext, { sqlite: { dbPath: '.trace-results.db' } })`
+and installs a transparent mock so tests import `describe`/`it`/`expect` from their native runner as usual. Bun and
+Vitest are both supported (`@smoothbricks/lmao/testing/bun` · `@smoothbricks/lmao/testing/vitest`). Traces flush to a
+SQLite sink you can query with the `TraceQuery` API or the `sqlite3` CLI. See the docs for the full harness setup, the
+SQLite schema, and query recipes.
 
-**QueryableSpan** wraps a SpanBuffer with ergonomic helpers:
+## Package exports
 
-```typescript
-import { querySpan } from '@smoothbricks/lmao/testing';
+| Import | Provides |
+|---|---|
+| `@smoothbricks/lmao` | Core API: `defineOpContext`, `defineLogSchema`, `defineFeatureFlags`, `S`, `JsBufferStrategy`, all tracers, Arrow conversion, results (`Ok`/`Err`/`defineCodeError`), `InMemoryFlagEvaluator`, entry-type constants. |
+| `@smoothbricks/lmao/node` | `createTraceRoot` using `process.hrtime.bigint()`. |
+| `@smoothbricks/lmao/es` | `createTraceRoot` using `performance.now()` (browser/Deno/Workers). |
+| `@smoothbricks/lmao/sqlite`, `/sqlite/node` | SQLite/D1 tracers and database factories. |
+| `@smoothbricks/lmao/cloudflare` | Cloudflare trace-sink adapters (`DiagnosticDrainTracer`, `ClassSplitTracer`, transports). *Partially implemented.* |
+| `@smoothbricks/lmao/errors*` | `Transient`, `Blocked`, `defineCodeError`, backoff/retry helpers. |
+| `@smoothbricks/lmao/testing`, `/testing/bun`, `/testing/vitest` | Trace-testing query API and runner harnesses. |
 
-const q = querySpan(tracer.rootBuffers[0]);
-q.name; // span name
-q.facts(); // all facts from this span tree
-q.find('validate'); // first child span by name
-q.findAll('db-query'); // all matching descendants
-q.children; // direct child QueryableSpans
-q.names(); // all descendant span names
-```
+### Companion packages
 
-**Standalone functions** (tree-shakable):
+- [`@smoothbricks/lmao-inspector`](../lmao-inspector) — client-side Arrow query engine and trace sources.
+- [`@smoothbricks/lmao-transformer`](../lmao-transformer) — optional build-time TypeScript transformer (source-line
+  injection and `ctx.tag` inlining).
 
-```typescript
-import { findSpan, extractFactsFor, spanNames } from '@smoothbricks/lmao/testing';
+## Examples
 
-const span = findSpan(rootBuffer, 'validate');
-const facts = extractFactsFor(rootBuffer, 'save');
-const names = spanNames(rootBuffer);
-```
+Runnable with `bun run examples/<name>.ts`:
 
-### SQLite Persistence
+| Example | Shows |
+|---|---|
+| `basic-usage.ts` | Schema, feature flags, user context, fluent tags, child spans. |
+| `fluent-result-api.ts` | `ok`/`err` with `.with()`/`.message()`, typed error codes, exceptions. |
+| `chaining-showcase.ts` | Tag/log fluent chaining patterns. |
+| `middleware-pattern.ts` | Wrapping ops with cross-cutting behavior. |
+| `library-integration.ts` | Composing op groups across packages with `.prefix()`/`.mapColumns()`. |
+| `complete-example.ts` | An end-to-end request flow. |
+| `arrow-export.ts` | Converting a trace to an Arrow table. |
 
-When configured, the trace database is written after all tests complete. Schema columns evolve automatically based on
-your LogSchema fields.
+## License
 
+MIT

package/dist/lib/opContext/spanContextTypes.d.ts

@@ -26,13 +26,13 @@ import type { SpanBuffer } from '../types.js';
 import type { Op } from './opTypes.js';
 import type { OpContext } from './types.js';
 /**
- * DepsConfig - structural type to avoid importing from opGroupTypes.
- * Represents a record of dependency groups.
+ * DepsConfig - structural placeholder for a record of dependency groups.
+ * The authoritative type is `DepsConfig` in opGroupTypes; see the WHY above.
  */
 export type DepsConfig = Record<string, any>;
 /**
- * ResolvedDeps - structural type to avoid importing from opGroupTypes.
- * At runtime, deps are resolved OpGroups with their ops accessible.
+ * ResolvedDeps - structural placeholder for resolved dependency OpGroups.
+ * The authoritative type is `ResolvedDeps` in opGroupTypes; see the WHY above.
  */
 export type ResolvedDeps<_D extends DepsConfig> = Record<string, any>;
 /**

package/dist/lib/opContext/spanContextTypes.d.ts.map

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

package/dist/lib/schema/typeGuards.d.ts

@@ -1,52 +1,12 @@
 /**
- * Type guard functions for runtime type checking
+ * Schema type-guard re-exports.
  *
- * Re-exports schema type guards from arrow-builder and adds lmao-specific guards.
+ * Re-exports the schema introspection guards from arrow-builder so the rest of
+ * the package imports them from a single place.
+ *
+ * NOTE: Do not hand-write `isRecord`/`typeof` guards here. For runtime
+ * validation at trust boundaries use Typia (`typia.is<T>()`) or
+ * `@smoothbricks/validation`'s shared helpers (e.g. `isRecord`).
  */
 export { getBinaryEncoder, getEnumUtf8, getEnumValues, getSchemaType, isEnumSchema, isSchemaWithMetadata, } from '@smoothbricks/arrow-builder';
-import type { EvaluationContext, UsageContext } from './defineFeatureFlags.js';
-import type { FeatureFlagDefinition } from './types.js';
-/** Narrow unknown to Record<string, unknown> — non-null object with string-keyed access. */
-export declare function isRecord(value: unknown): value is Record<string, unknown>;
-/**
- * Type guard to check if a value is a FeatureFlagDefinition
- */
-export declare function isFeatureFlagDefinition(value: unknown): value is FeatureFlagDefinition<string | number | boolean>;
-/**
- * Type guard to check if a value is a valid EvaluationContext
- */
-export declare function isEvaluationContext(value: unknown): value is EvaluationContext;
-/**
- * Type guard to check if a value is a valid UsageContext
- */
-export declare function isUsageContext(value: unknown): value is UsageContext;
-/**
- * Type guard to check if a value is a string
- * Useful for narrowing unknown types in safe contexts
- */
-export declare function isString(value: unknown): value is string;
-/**
- * Type guard to check if a value is a number
- * Useful for narrowing unknown types in safe contexts
- */
-export declare function isNumber(value: unknown): value is number;
-/**
- * Type guard to check if a value is a boolean
- * Useful for narrowing unknown types in safe contexts
- */
-export declare function isBoolean(value: unknown): value is boolean;
-/**
- * Type guard to check if a value is a primitive type (string | number | boolean)
- * Useful for validating feature flag values and tag attributes
- */
-export declare function isPrimitive(value: unknown): value is string | number | boolean;
-/**
- * Type guard to check if a value is a plain object (not array, not null)
- */
-export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
-/**
- * Type guard to check if a value is a valid record with primitive values
- * Useful for validating tag attribute objects
- */
-export declare function isRecordOfPrimitives(value: unknown): value is Record<string, string | number | boolean>;
 //# sourceMappingURL=typeGuards.d.ts.map

package/dist/lib/schema/typeGuards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typeGuards.d.ts","sourceRoot":"","sources":["../../../src/lib/schema/typeGuards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,4FAA4F;AAC5F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAWjH;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAe9E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAqCpE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,GAAG,MAAM,GAAG,OAAO,CAE9E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO9E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAYvG"}
+{"version":3,"file":"typeGuards.d.ts","sourceRoot":"","sources":["../../../src/lib/schema/typeGuards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,oBAAoB,GACrB,MAAM,6BAA6B,CAAC"}

package/dist/lib/schema/typeGuards.js

@@ -1,127 +1,11 @@
 /**
- * Type guard functions for runtime type checking
+ * Schema type-guard re-exports.
  *
- * Re-exports schema type guards from arrow-builder and adds lmao-specific guards.
+ * Re-exports the schema introspection guards from arrow-builder so the rest of
+ * the package imports them from a single place.
+ *
+ * NOTE: Do not hand-write `isRecord`/`typeof` guards here. For runtime
+ * validation at trust boundaries use Typia (`typia.is<T>()`) or
+ * `@smoothbricks/validation`'s shared helpers (e.g. `isRecord`).
  */
-// Re-export schema type guards from arrow-builder
 export { getBinaryEncoder, getEnumUtf8, getEnumValues, getSchemaType, isEnumSchema, isSchemaWithMetadata, } from '@smoothbricks/arrow-builder';
-/** Narrow unknown to Record<string, unknown> — non-null object with string-keyed access. */
-export function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-/**
- * Type guard to check if a value is a FeatureFlagDefinition
- */
-export function isFeatureFlagDefinition(value) {
-    if (!isRecord(value)) {
-        return false;
-    }
-    return ('schema' in value &&
-        'defaultValue' in value &&
-        'evaluationType' in value &&
-        (value.evaluationType === 'sync' || value.evaluationType === 'async'));
-}
-/**
- * Type guard to check if a value is a valid EvaluationContext
- */
-export function isEvaluationContext(value) {
-    if (!isRecord(value)) {
-        return false;
-    }
-    // EvaluationContext can have various string/number/boolean properties
-    // Check that all values are of valid types
-    for (const key in value) {
-        const val = value[key];
-        if (val !== undefined && typeof val !== 'string' && typeof val !== 'number' && typeof val !== 'boolean') {
-            return false;
-        }
-    }
-    return true;
-}
-/**
- * Type guard to check if a value is a valid UsageContext
- */
-export function isUsageContext(value) {
-    if (!isRecord(value)) {
-        return false;
-    }
-    // Check action property if present
-    if ('action' in value && typeof value.action !== 'string' && value.action !== undefined) {
-        return false;
-    }
-    // Check outcome property if present
-    if ('outcome' in value && value.outcome !== undefined && value.outcome !== 'success' && value.outcome !== 'failure') {
-        return false;
-    }
-    // Check value property if present
-    if ('value' in value && typeof value.value !== 'number' && value.value !== undefined) {
-        return false;
-    }
-    // Check metadata property if present
-    if ('metadata' in value && value.metadata !== undefined) {
-        if (!isRecord(value.metadata)) {
-            return false;
-        }
-        // Validate metadata values
-        const metadata = value.metadata;
-        for (const key in metadata) {
-            const val = metadata[key];
-            if (typeof val !== 'string' && typeof val !== 'number' && typeof val !== 'boolean') {
-                return false;
-            }
-        }
-    }
-    return true;
-}
-/**
- * Type guard to check if a value is a string
- * Useful for narrowing unknown types in safe contexts
- */
-export function isString(value) {
-    return typeof value === 'string';
-}
-/**
- * Type guard to check if a value is a number
- * Useful for narrowing unknown types in safe contexts
- */
-export function isNumber(value) {
-    return typeof value === 'number' && !Number.isNaN(value);
-}
-/**
- * Type guard to check if a value is a boolean
- * Useful for narrowing unknown types in safe contexts
- */
-export function isBoolean(value) {
-    return typeof value === 'boolean';
-}
-/**
- * Type guard to check if a value is a primitive type (string | number | boolean)
- * Useful for validating feature flag values and tag attributes
- */
-export function isPrimitive(value) {
-    return isString(value) || isNumber(value) || isBoolean(value);
-}
-/**
- * Type guard to check if a value is a plain object (not array, not null)
- */
-export function isPlainObject(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        !Array.isArray(value) &&
-        Object.getPrototypeOf(value) === Object.prototype);
-}
-/**
- * Type guard to check if a value is a valid record with primitive values
- * Useful for validating tag attribute objects
- */
-export function isRecordOfPrimitives(value) {
-    if (!isPlainObject(value)) {
-        return false;
-    }
-    for (const key in value) {
-        if (!isPrimitive(value[key])) {
-            return false;
-        }
-    }
-    return true;
-}

package/dist/lib/traceContext.d.ts.map

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

package/dist/lib/traceContext.js

@@ -38,8 +38,5 @@ export const TraceContextProto = {
  * Type guard to check if a value is a TraceContext
  */
 export function isTraceContext(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        TRACE_CONTEXT_MARKER in value &&
-        value[TRACE_CONTEXT_MARKER] === true);
+    return typeof value === 'object' && value !== null && Reflect.get(value, TRACE_CONTEXT_MARKER) === true;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smoothbricks/lmao",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "type": "module",
   "sideEffects": [
     "./dist/vocabulary/register/v1.js",

package/src/lib/opContext/spanContextTypes.ts

@@ -28,21 +28,38 @@ import type { Op } from './opTypes.js';
 import type { OpContext } from './types.js';
 
 // =============================================================================
-// DEPENDENCY TYPES (structural to avoid circular imports)
+// DEPENDENCY TYPES (deliberate `any` placeholders — see rationale below)
 // =============================================================================
 
+// WHY these are `any` and not the real `DepsConfig`/`ResolvedDeps` from opGroupTypes:
+//
+// `ResolvedDeps<D>` maps each dep to `OpGroup<Ctx, Ops>`, and an OpGroup's ops carry
+// `SpanContext<DepCtx>` in their signatures. If `SpanContext` referenced the *real*
+// `ResolvedDeps<Ctx['deps']>` for its `deps` member, `SpanContext` would become
+// structurally recursive: deps -> OpGroup -> op -> SpanContext -> deps -> ...
+//
+// That recursion breaks the structural assignability TypeScript performs when a
+// dependency's op is passed to `ctx.span(name, ctx.deps.x.op)` across libraries
+// (verified: it regresses the nested-library-tasks composition tests) and makes
+// type comparison cost explode. The `any` keeps `ctx.deps.x.op` ergonomic for op
+// authors while keeping `SpanContext` comparisons tractable and non-recursive.
+//
+// A real fix (fully-typed `ctx.deps`) requires reworking deps resolution so the
+// resolved-deps view does not pull `SpanContext` back into its own definition.
+// Until then these placeholders are load-bearing, not laziness.
+
 /**
- * DepsConfig - structural type to avoid importing from opGroupTypes.
- * Represents a record of dependency groups.
+ * DepsConfig - structural placeholder for a record of dependency groups.
+ * The authoritative type is `DepsConfig` in opGroupTypes; see the WHY above.
  */
-// biome-ignore lint/suspicious/noExplicitAny: Structural placeholder - actual type in opGroupTypes
+// biome-ignore lint/suspicious/noExplicitAny: load-bearing placeholder — real type makes SpanContext recursive (see WHY above)
 export type DepsConfig = Record<string, any>;
 
 /**
- * ResolvedDeps - structural type to avoid importing from opGroupTypes.
- * At runtime, deps are resolved OpGroups with their ops accessible.
+ * ResolvedDeps - structural placeholder for resolved dependency OpGroups.
+ * The authoritative type is `ResolvedDeps` in opGroupTypes; see the WHY above.
  */
-// biome-ignore lint/suspicious/noExplicitAny: Structural placeholder - actual type in opGroupTypes
+// biome-ignore lint/suspicious/noExplicitAny: load-bearing placeholder — real type makes SpanContext recursive (see WHY above)
 export type ResolvedDeps<_D extends DepsConfig> = Record<string, any>;
 
 // =============================================================================

package/src/lib/schema/typeGuards.ts

@@ -1,10 +1,14 @@
 /**
- * Type guard functions for runtime type checking
+ * Schema type-guard re-exports.
  *
- * Re-exports schema type guards from arrow-builder and adds lmao-specific guards.
+ * Re-exports the schema introspection guards from arrow-builder so the rest of
+ * the package imports them from a single place.
+ *
+ * NOTE: Do not hand-write `isRecord`/`typeof` guards here. For runtime
+ * validation at trust boundaries use Typia (`typia.is<T>()`) or
+ * `@smoothbricks/validation`'s shared helpers (e.g. `isRecord`).
  */
 
-// Re-export schema type guards from arrow-builder
 export {
   getBinaryEncoder,
   getEnumUtf8,
@@ -13,151 +17,3 @@ export {
   isEnumSchema,
   isSchemaWithMetadata,
 } from '@smoothbricks/arrow-builder';
-
-import type { EvaluationContext, UsageContext } from './defineFeatureFlags.js';
-import type { FeatureFlagDefinition } from './types.js';
-
-/** Narrow unknown to Record<string, unknown> — non-null object with string-keyed access. */
-export function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-/**
- * Type guard to check if a value is a FeatureFlagDefinition
- */
-export function isFeatureFlagDefinition(value: unknown): value is FeatureFlagDefinition<string | number | boolean> {
-  if (!isRecord(value)) {
-    return false;
-  }
-
-  return (
-    'schema' in value &&
-    'defaultValue' in value &&
-    'evaluationType' in value &&
-    (value.evaluationType === 'sync' || value.evaluationType === 'async')
-  );
-}
-
-/**
- * Type guard to check if a value is a valid EvaluationContext
- */
-export function isEvaluationContext(value: unknown): value is EvaluationContext {
-  if (!isRecord(value)) {
-    return false;
-  }
-
-  // EvaluationContext can have various string/number/boolean properties
-  // Check that all values are of valid types
-  for (const key in value) {
-    const val = value[key];
-    if (val !== undefined && typeof val !== 'string' && typeof val !== 'number' && typeof val !== 'boolean') {
-      return false;
-    }
-  }
-
-  return true;
-}
-
-/**
- * Type guard to check if a value is a valid UsageContext
- */
-export function isUsageContext(value: unknown): value is UsageContext {
-  if (!isRecord(value)) {
-    return false;
-  }
-
-  // Check action property if present
-  if ('action' in value && typeof value.action !== 'string' && value.action !== undefined) {
-    return false;
-  }
-
-  // Check outcome property if present
-  if ('outcome' in value && value.outcome !== undefined && value.outcome !== 'success' && value.outcome !== 'failure') {
-    return false;
-  }
-
-  // Check value property if present
-  if ('value' in value && typeof value.value !== 'number' && value.value !== undefined) {
-    return false;
-  }
-
-  // Check metadata property if present
-  if ('metadata' in value && value.metadata !== undefined) {
-    if (!isRecord(value.metadata)) {
-      return false;
-    }
-
-    // Validate metadata values
-    const metadata = value.metadata;
-    for (const key in metadata) {
-      const val = metadata[key];
-      if (typeof val !== 'string' && typeof val !== 'number' && typeof val !== 'boolean') {
-        return false;
-      }
-    }
-  }
-
-  return true;
-}
-
-/**
- * Type guard to check if a value is a string
- * Useful for narrowing unknown types in safe contexts
- */
-export function isString(value: unknown): value is string {
-  return typeof value === 'string';
-}
-
-/**
- * Type guard to check if a value is a number
- * Useful for narrowing unknown types in safe contexts
- */
-export function isNumber(value: unknown): value is number {
-  return typeof value === 'number' && !Number.isNaN(value);
-}
-
-/**
- * Type guard to check if a value is a boolean
- * Useful for narrowing unknown types in safe contexts
- */
-export function isBoolean(value: unknown): value is boolean {
-  return typeof value === 'boolean';
-}
-
-/**
- * Type guard to check if a value is a primitive type (string | number | boolean)
- * Useful for validating feature flag values and tag attributes
- */
-export function isPrimitive(value: unknown): value is string | number | boolean {
-  return isString(value) || isNumber(value) || isBoolean(value);
-}
-
-/**
- * Type guard to check if a value is a plain object (not array, not null)
- */
-export function isPlainObject(value: unknown): value is Record<string, unknown> {
-  return (
-    typeof value === 'object' &&
-    value !== null &&
-    !Array.isArray(value) &&
-    Object.getPrototypeOf(value) === Object.prototype
-  );
-}
-
-/**
- * Type guard to check if a value is a valid record with primitive values
- * Useful for validating tag attribute objects
- */
-export function isRecordOfPrimitives(value: unknown): value is Record<string, string | number | boolean> {
-  if (!isPlainObject(value)) {
-    return false;
-  }
-
-  for (const key in value) {
-    if (!isPrimitive(value[key])) {
-      return false;
-    }
-  }
-
-  return true;
-}

package/src/lib/traceContext.ts

@@ -173,10 +173,5 @@ export const TraceContextProto: TraceContextBase = {
  * Type guard to check if a value is a TraceContext
  */
 export function isTraceContext(value: unknown): value is TraceContext<FeatureFlagSchema, Record<string, unknown>> {
-  return (
-    typeof value === 'object' &&
-    value !== null &&
-    TRACE_CONTEXT_MARKER in value &&
-    (value as Record<symbol, unknown>)[TRACE_CONTEXT_MARKER] === true
-  );
+  return typeof value === 'object' && value !== null && Reflect.get(value, TRACE_CONTEXT_MARKER) === true;
 }

package/src/lib/tracers/__tests__/CompositeTracer.test.ts

@@ -0,0 +1,150 @@
+/**
+ * CompositeTracer tests
+ *
+ * CompositeTracer fans one trace run out to several delegate tracers. The case
+ * that matters in practice — and the one the examples and the convert-to-Arrow
+ * guide document — is stacking StdioTracer (human-readable output) with
+ * ArrayQueueTracer (retains completed root buffers for Arrow conversion), so a
+ * single run both prints and exports.
+ */
+
+// Configure Node.js timestamp implementation - MUST be first import
+import '../../__tests__/test-helpers.js';
+
+import { describe, expect, it } from 'bun:test';
+import { Writable } from 'node:stream';
+import { createTestTracerOptions } from '../../__tests__/test-helpers.js';
+import { convertSpanTreeToArrowTable } from '../../convertToArrow.js';
+import { defineLogSchema, defineOpContext, S } from '../../defineOpContext.js';
+import { resolveMessage } from '../../resolveMessage.js';
+import { ArrayQueueTracer } from '../ArrayQueueTracer.js';
+import { CompositeTracer } from '../CompositeTracer.js';
+import { StdioTracer, type StdioWritable } from '../StdioTracer.js';
+
+type MockStream = { stream: StdioWritable; output: string[] };
+
+function createMockStream(): MockStream {
+  const output: string[] = [];
+  const writable = new Writable({
+    write(chunk, _encoding, callback) {
+      output.push(chunk.toString());
+      callback();
+    },
+  });
+  const stream: StdioWritable = {
+    write(chunk: string): boolean {
+      return writable.write(chunk);
+    },
+  };
+  return { stream, output };
+}
+
+describe('CompositeTracer', () => {
+  const testSchema = defineLogSchema({
+    userId: S.category(),
+  });
+
+  const ctx = defineOpContext({
+    logSchema: testSchema,
+  });
+  const { defineOp } = ctx;
+
+  // `CompositeTracerOptions` carries `delegates: Tracer<B>[]`, which pins B to this
+  // op context — so the shared tracer options must be built for the same concrete
+  // log schema rather than the loose `LogSchema` default.
+  type TestLogSchema = (typeof ctx)['logBinding']['logSchema'];
+
+  /** Stdio + ArrayQueue behind one composite, sharing the same tracer options. */
+  function createStackedTracer() {
+    const { stream: out, output } = createMockStream();
+    const { stream: err } = createMockStream();
+    const options = createTestTracerOptions<TestLogSchema>();
+
+    const stdio = new StdioTracer(ctx, { ...options, out, err, colorEnabled: false });
+    const queued = new ArrayQueueTracer(ctx, { ...options });
+    const tracer = new CompositeTracer(ctx, { ...options, delegates: [stdio, queued] });
+
+    return { tracer, queued, output };
+  }
+
+  describe('stdio + ArrayQueue stacking', () => {
+    it('should print to stdout and retain the root buffer from one trace run', async () => {
+      const { tracer, queued, output } = createStackedTracer();
+
+      const testOp = defineOp('test', (ctx) => ctx.ok('done'));
+      await tracer.trace('stacked-trace', testOp);
+
+      // StdioTracer delegate printed the span tree...
+      expect(output.some((line) => line.includes('stacked-trace'))).toBe(true);
+
+      // ...and the ArrayQueueTracer delegate kept the completed root buffer.
+      expect(queued.queue).toHaveLength(1);
+      expect(resolveMessage(queued.queue[0], 0)).toBe('stacked-trace');
+    });
+
+    it('should convert the retained buffer to an Arrow table', async () => {
+      const { tracer, queued } = createStackedTracer();
+
+      const testOp = defineOp('test', (ctx) => ctx.ok('done'));
+      await tracer.trace('exported-trace', testOp);
+
+      const tables = queued.drain().map((rootBuffer) => convertSpanTreeToArrowTable(rootBuffer));
+
+      expect(tables).toHaveLength(1);
+      // span-start + span-ok
+      expect(tables[0]?.numRows).toBe(2);
+      expect(tables[0]?.names).toContain('entry_type');
+      expect(tables[0]?.names).toContain('userId');
+    });
+
+    it('should leave the queue empty after draining so the next batch is clean', async () => {
+      const { tracer, queued } = createStackedTracer();
+
+      const testOp = defineOp('test', (ctx) => ctx.ok('done'));
+      await tracer.trace('first', testOp);
+
+      expect(queued.drain()).toHaveLength(1);
+      expect(queued.queue).toHaveLength(0);
+
+      await tracer.trace('second', testOp);
+
+      const batch = queued.drain();
+      expect(batch).toHaveLength(1);
+      expect(resolveMessage(batch[0], 0)).toBe('second');
+    });
+
+    it('should capture child spans in both delegates', async () => {
+      const { tracer, queued, output } = createStackedTracer();
+
+      const childOp = defineOp('child', (ctx) => ctx.ok('child-done'));
+      const parentOp = defineOp('parent', async (ctx) => {
+        await ctx.span('child-span', childOp);
+        return ctx.ok('parent-done');
+      });
+
+      await tracer.trace('with-children', parentOp);
+
+      expect(output.some((line) => line.includes('child-span'))).toBe(true);
+
+      const table = convertSpanTreeToArrowTable(queued.drain()[0]);
+      // parent span-start/ok + child span-start/ok
+      expect(table.numRows).toBe(4);
+    });
+  });
+
+  describe('delegate fan-out', () => {
+    it('should keep delegates independent — draining one does not affect the other', async () => {
+      const { tracer, queued, output } = createStackedTracer();
+
+      const testOp = defineOp('test', (ctx) => ctx.ok('done'));
+      await tracer.trace('independent', testOp);
+
+      const printedBefore = output.length;
+      queued.drain();
+
+      // Draining the queue must not retroactively change what stdio already wrote.
+      expect(output).toHaveLength(printedBefore);
+      expect(output.some((line) => line.includes('independent'))).toBe(true);
+    });
+  });
+});