@smoothbricks/lmao 0.2.2 → 0.3.0

package/dist/lib/tracer.js

@@ -58,15 +58,14 @@
  *
  * @module tracer
  */
-import { createTagWriter } from './codegen/fixedPositionWriterGenerator.js';
-import { createSpanLogger as createSpanLoggerFromGenerator } from './codegen/spanLoggerGenerator.js';
 import { Op } from './op.js';
 import { createOpMetadata } from './opContext/defineOp.js';
+import { getPhysicalLayoutPlan, sealCallsitePlan, } from './physicalLayoutPlan.js';
 import { Err, Ok } from './result.js';
 import { createFeatureFlagEvaluator, InMemoryFlagEvaluator } from './schema/evaluator.js';
 import { ENTRY_TYPE_SPAN_EXCEPTION, ENTRY_TYPE_SPAN_OK } from './schema/systemSchema.js';
-import { EMPTY_SCOPE } from './spanBuffer.js';
-import { createSpanContextClass, writeSpanEnd, writeSpanStart, } from './spanContext.js';
+import { EMPTY_SCOPE, getSpanBufferClass } from './spanBuffer.js';
+import { createSpanContextClass, isPhysicalLayoutPlanForContext, writeSpanEnd, } from './spanContext.js';
 import { generateTraceId, isValidTraceId } from './traceId.js';
 function isTraceOverridesArg(value) {
     return value !== null && typeof value === 'object' && !(value instanceof Op);
@@ -97,8 +96,10 @@ function isPromiseResult(value) {
 export class Tracer {
     logBinding;
     SpanContextClass;
+    physicalLayoutPlan;
     flagEvaluator;
     ctxDefaults;
+    requiredCtxKeys;
     deps;
     createTraceRoot;
     /**
@@ -111,18 +112,29 @@ export class Tracer {
         this.logBinding = binding.logBinding;
         this.bufferStrategy = options.bufferStrategy;
         this.ctxDefaults = binding.ctxDefaults ?? EMPTY_SCOPE;
+        const userContextKeys = Object.keys(this.ctxDefaults).sort();
+        const requiredCtxKeys = [];
+        for (const key of userContextKeys) {
+            if (this.ctxDefaults[key] === null)
+                requiredCtxKeys.push(key);
+        }
+        this.requiredCtxKeys = requiredCtxKeys;
         this.deps = binding.deps ?? EMPTY_SCOPE;
         this.flagEvaluator = this._createFlagEvaluator(binding.flags, options.flagEvaluator);
         this.createTraceRoot = options.createTraceRoot;
         // Create SpanContext class for all contexts created by this tracer
         // The class closes over schema/logBinding and provides typed methods
-        this.SpanContextClass = createSpanContextClass(binding.logBinding.logSchema, binding.logBinding);
+        this.SpanContextClass = createSpanContextClass(binding.logBinding.logSchema, binding.logBinding, undefined, userContextKeys);
+        this.physicalLayoutPlan = getPhysicalLayoutPlan(getSpanBufferClass(binding.logBinding.logSchema), 0, this.SpanContextClass, undefined, 'strategy-selected', userContextKeys.join('\u0000'));
         // Bind methods for destructuring (per AGENTS.md - "Always destructure")
         this.trace = this.trace.bind(this);
         this.trace_op = this.trace_op.bind(this);
         this.trace_fn = this.trace_fn.bind(this);
         this.flush = this.flush.bind(this);
     }
+    getFlagEvaluatorForContext() {
+        return this.flagEvaluator;
+    }
     _createFlagEvaluator(flags, evaluator) {
         const delegate = evaluator ?? new InMemoryFlagEvaluator(flags);
         const boundEvaluator = {
@@ -165,23 +177,23 @@ export class Tracer {
         if (fnOrOp instanceof Op) {
             switch (argCount) {
                 case 0:
-                    return this._trace_unknown_op(line, name, overrides, fnOrOp.metadata, fnOrOp.fn);
+                    return this._trace_unknown_op(line, name, overrides, fnOrOp.callsitePlan, fnOrOp.fn);
                 case 1:
-                    return this._trace_unknown_op(line, name, overrides, fnOrOp.metadata, fnOrOp.fn, args[fnIdx + 1]);
+                    return this._trace_unknown_op(line, name, overrides, fnOrOp.callsitePlan, fnOrOp.fn, args[fnIdx + 1]);
                 case 2:
-                    return this._trace_unknown_op(line, name, overrides, fnOrOp.metadata, fnOrOp.fn, args[fnIdx + 1], args[fnIdx + 2]);
+                    return this._trace_unknown_op(line, name, overrides, fnOrOp.callsitePlan, fnOrOp.fn, args[fnIdx + 1], args[fnIdx + 2]);
                 case 3:
-                    return this._trace_unknown_op(line, name, overrides, fnOrOp.metadata, fnOrOp.fn, args[fnIdx + 1], args[fnIdx + 2], args[fnIdx + 3]);
+                    return this._trace_unknown_op(line, name, overrides, fnOrOp.callsitePlan, fnOrOp.fn, args[fnIdx + 1], args[fnIdx + 2], args[fnIdx + 3]);
                 case 4:
-                    return this._trace_unknown_op(line, name, overrides, fnOrOp.metadata, fnOrOp.fn, args[fnIdx + 1], args[fnIdx + 2], args[fnIdx + 3], args[fnIdx + 4]);
+                    return this._trace_unknown_op(line, name, overrides, fnOrOp.callsitePlan, fnOrOp.fn, args[fnIdx + 1], args[fnIdx + 2], args[fnIdx + 3], args[fnIdx + 4]);
                 case 5:
-                    return this._trace_unknown_op(line, name, overrides, fnOrOp.metadata, fnOrOp.fn, args[fnIdx + 1], args[fnIdx + 2], args[fnIdx + 3], args[fnIdx + 4], args[fnIdx + 5]);
+                    return this._trace_unknown_op(line, name, overrides, fnOrOp.callsitePlan, fnOrOp.fn, args[fnIdx + 1], args[fnIdx + 2], args[fnIdx + 3], args[fnIdx + 4], args[fnIdx + 5]);
                 case 6:
-                    return this._trace_unknown_op(line, name, overrides, fnOrOp.metadata, fnOrOp.fn, args[fnIdx + 1], args[fnIdx + 2], args[fnIdx + 3], args[fnIdx + 4], args[fnIdx + 5], args[fnIdx + 6]);
+                    return this._trace_unknown_op(line, name, overrides, fnOrOp.callsitePlan, fnOrOp.fn, args[fnIdx + 1], args[fnIdx + 2], args[fnIdx + 3], args[fnIdx + 4], args[fnIdx + 5], args[fnIdx + 6]);
                 case 7:
-                    return this._trace_unknown_op(line, name, overrides, fnOrOp.metadata, fnOrOp.fn, args[fnIdx + 1], args[fnIdx + 2], args[fnIdx + 3], args[fnIdx + 4], args[fnIdx + 5], args[fnIdx + 6], args[fnIdx + 7]);
+                    return this._trace_unknown_op(line, name, overrides, fnOrOp.callsitePlan, fnOrOp.fn, args[fnIdx + 1], args[fnIdx + 2], args[fnIdx + 3], args[fnIdx + 4], args[fnIdx + 5], args[fnIdx + 6], args[fnIdx + 7]);
                 case 8:
-                    return this._trace_unknown_op(line, name, overrides, fnOrOp.metadata, fnOrOp.fn, args[fnIdx + 1], args[fnIdx + 2], args[fnIdx + 3], args[fnIdx + 4], args[fnIdx + 5], args[fnIdx + 6], args[fnIdx + 7], args[fnIdx + 8]);
+                    return this._trace_unknown_op(line, name, overrides, fnOrOp.callsitePlan, fnOrOp.fn, args[fnIdx + 1], args[fnIdx + 2], args[fnIdx + 3], args[fnIdx + 4], args[fnIdx + 5], args[fnIdx + 6], args[fnIdx + 7], args[fnIdx + 8]);
                 default:
                     throw new Error(`trace() supports up to 8 op arguments, got ${argCount}`);
             }
@@ -204,15 +216,22 @@ export class Tracer {
      * Supports 0-8 arguments. The transformer rewrites trace() calls to this.
      */
     _trace_op(line, name, overrides, op, ...opArgs) {
-        const ctx = this._createRootContext(line, name, overrides, op.metadata);
+        if (!isPhysicalLayoutPlanForContext(op.callsitePlan, this.logBinding.logSchema)) {
+            throw new TypeError('Op physical layout plan does not match this tracer context');
+        }
+        const ctx = this._createRootContext(line, name, overrides, op.callsitePlan);
         return this._executeResultWithContext(ctx, (c) => op.fn(c, ...opArgs));
     }
-    _trace_unknown_op(line, name, overrides, metadata, fn, ...opArgs) {
-        const ctx = this._createRootContext(line, name, overrides, metadata);
+    _trace_unknown_op(line, name, overrides, callsitePlan, fn, ...opArgs) {
+        const ctx = this._createRootContext(line, name, overrides, callsitePlan);
         return this._executeResultWithContext(ctx, (childCtx) => fn(childCtx, ...opArgs));
     }
     _trace_fn(line, name, overrides, fn) {
-        const ctx = this._createRootContext(line, name, overrides, createOpMetadata('root', 'tracer', 'runtime', 'unknown', 0));
+        const metadata = Object.freeze({
+            ...createOpMetadata('root', 'tracer', 'runtime', 'unknown', 0),
+            _physicalLayoutPlan: this.physicalLayoutPlan,
+        });
+        const ctx = this._createRootContext(line, name, overrides, sealCallsitePlan(this.physicalLayoutPlan, metadata));
         return this._executeUnknownWithContext(ctx, fn);
     }
     _trace_unknown_fn(line, name, overrides, fn) {
@@ -234,68 +253,41 @@ export class Tracer {
     // ===========================================================================
     // Internal helpers
     // ===========================================================================
-    _createRootContext(_line, name, overrides, metadata) {
+    _createRootContext(_line, name, overrides, callsitePlan) {
         // Extract trace_id from overrides if present
         const traceId = isValidTraceId(overrides.trace_id) ? overrides.trace_id : generateTraceId();
-        const schema = this.logBinding.logSchema;
-        // Validate null-sentinel required fields and merge user context.
-        // _resolveUserContext ignores trace_id (transport-only field).
-        const overrideRecord = { ...overrides };
-        const resolvedUserCtx = this._resolveUserContext(overrideRecord);
+        const schema = callsitePlan.schema;
+        // Validate required null-sentinel fields before allocating the trace root or buffer.
+        this._validateRequiredUserContext(overrides);
         // Create TraceRoot via platform-specific factory
         const traceRoot = this.createTraceRoot(traceId, this);
         // Create root SpanBuffer with pre-built TraceRoot via strategy
-        const buffer = this.bufferStrategy.createSpanBuffer(schema, traceRoot, // pre-built TraceRoot with trace_id, anchors, tracer
-        metadata);
+        const buffer = this.bufferStrategy.createSpanBuffer(schema, traceRoot, callsitePlan.metadata, callsitePlan.capacityTier, callsitePlan.SpanBufferClass);
         // Write span-start entry (row 0)
-        writeSpanStart(buffer, name);
-        // Create tag writer and span logger (needed for constructor)
-        const tagWriter = createTagWriter(schema, buffer);
-        const spanLogger = createSpanLoggerFromGenerator(schema, buffer);
-        // Instantiate SpanContext class with direct arguments (no temp object allocation)
-        const ctx = new this.SpanContextClass(buffer, schema, spanLogger, tagWriter);
-        // Set up deps from config (may be EMPTY_SCOPE if none provided)
-        ctx.deps = this.deps;
-        ctx.ff = this.flagEvaluator.forContext(ctx);
-        // Copy resolved user context onto SpanContext.
-        for (const key in resolvedUserCtx) {
-            ctx[key] = resolvedUserCtx[key];
-        }
-        return ctx;
+        callsitePlan.appenders.writeSpanStart(buffer, name);
+        return new callsitePlan.SpanContextClass(buffer, schema, callsitePlan, this.ctxDefaults, overrides, this.deps, this.flagEvaluator);
     }
     /**
-     * Validate null-sentinel required fields and merge with provided overrides.
+     * Validate null-sentinel required fields without materializing a merged
+     * user-context carrier.
      *
      * Per the ctx config pattern:
      * - Properties with null values in ctxDefaults must be provided in overrides
      * - Properties with default values can optionally be overridden
      * - undefined is allowed for optional fields
      */
-    _resolveUserContext(overrides) {
-        const ctxDefaults = this.ctxDefaults;
-        // Check that all null-sentinel keys are provided in overrides
-        for (const key of Object.keys(ctxDefaults)) {
-            const defaultValue = ctxDefaults[key];
-            if (defaultValue === null) {
-                const providedValue = overrides[key];
-                if (providedValue === null || providedValue === undefined) {
-                    throw new Error(`Required context parameter '${key}' must be provided. ` +
-                        'Properties with null values in ctx config are required.');
-                }
-            }
-        }
-        // Merge defaults with provided overrides (provided values win)
-        const resolvedUserCtx = { ...ctxDefaults };
-        for (const key of Object.keys(overrides)) {
-            if (key === 'trace_id') {
-                continue;
+    _validateRequiredUserContext(overrides) {
+        for (const key of this.requiredCtxKeys) {
+            if (!Object.prototype.propertyIsEnumerable.call(overrides, key)) {
+                throw new Error(`Required context parameter '${key}' must be provided. ` +
+                    'Properties with null values in ctx config are required.');
             }
-            const value = overrides[key];
-            if (value !== undefined) {
-                resolvedUserCtx[key] = value;
+            const providedValue = overrides[key];
+            if (providedValue === null || providedValue === undefined) {
+                throw new Error(`Required context parameter '${key}' must be provided. ` +
+                    'Properties with null values in ctx config are required.');
             }
         }
-        return resolvedUserCtx;
     }
     /**
      * Execute function with context and handle span-ok/span-err/span-exception writes
@@ -305,7 +297,8 @@ export class Tracer {
      * when the function returns an Ok/Err result.
      */
     _executeResultWithContext(ctx, fn) {
-        const buffer = ctx._buffer;
+        const buffer = ctx._spanBuffer;
+        const writeSpanEndEntry = ctx._physicalLayoutPlan.appenders.writeSpanEnd;
         this.onTraceStart(buffer);
         let isAsync = false;
         try {
@@ -317,7 +310,7 @@ export class Tracer {
                     writeSpanEnd(buffer, resolved);
                     return resolved;
                 }, (error) => {
-                    buffer._traceRoot.writeSpanEnd(buffer, ENTRY_TYPE_SPAN_EXCEPTION);
+                    writeSpanEndEntry(buffer, ENTRY_TYPE_SPAN_EXCEPTION);
                     const errorMessage = error instanceof Error ? error.message : String(error);
                     const errorStack = error instanceof Error ? error.stack : undefined;
                     buffer.message(1, errorMessage);
@@ -332,7 +325,7 @@ export class Tracer {
             return result;
         }
         catch (error) {
-            buffer._traceRoot.writeSpanEnd(buffer, ENTRY_TYPE_SPAN_EXCEPTION);
+            writeSpanEndEntry(buffer, ENTRY_TYPE_SPAN_EXCEPTION);
             const errorMessage = error instanceof Error ? error.message : String(error);
             const errorStack = error instanceof Error ? error.stack : undefined;
             buffer.message(1, errorMessage);
@@ -348,7 +341,8 @@ export class Tracer {
         }
     }
     _executeUnknownWithContext(ctx, fn) {
-        const buffer = ctx._buffer;
+        const buffer = ctx._spanBuffer;
+        const writeSpanEndEntry = ctx._physicalLayoutPlan.appenders.writeSpanEnd;
         // Call trace start hook
         this.onTraceStart(buffer);
         let isAsync = false;
@@ -362,11 +356,11 @@ export class Tracer {
                         writeSpanEnd(buffer, resolved);
                     }
                     else {
-                        buffer._traceRoot.writeSpanEnd(buffer, ENTRY_TYPE_SPAN_OK);
+                        writeSpanEndEntry(buffer, ENTRY_TYPE_SPAN_OK);
                     }
                     return resolved;
                 }, (error) => {
-                    buffer._traceRoot.writeSpanEnd(buffer, ENTRY_TYPE_SPAN_EXCEPTION);
+                    writeSpanEndEntry(buffer, ENTRY_TYPE_SPAN_EXCEPTION);
                     const errorMessage = error instanceof Error ? error.message : String(error);
                     const errorStack = error instanceof Error ? error.stack : undefined;
                     buffer.message(1, errorMessage);
@@ -382,13 +376,13 @@ export class Tracer {
                 writeSpanEnd(buffer, result);
             }
             else {
-                buffer._traceRoot.writeSpanEnd(buffer, ENTRY_TYPE_SPAN_OK);
+                writeSpanEndEntry(buffer, ENTRY_TYPE_SPAN_OK);
             }
             return result;
         }
         catch (error) {
             // Sync exception path
-            buffer._traceRoot.writeSpanEnd(buffer, ENTRY_TYPE_SPAN_EXCEPTION);
+            writeSpanEndEntry(buffer, ENTRY_TYPE_SPAN_EXCEPTION);
             // Write exception details
             const errorMessage = error instanceof Error ? error.message : String(error);
             const errorStack = error instanceof Error ? error.stack : undefined;

package/dist/lib/tracers/ArrayQueueTracer.d.ts

@@ -49,7 +49,7 @@ export declare class ArrayQueueTracer<B extends OpContextBinding = OpContextBind
      * Consume all queued buffers and clear the queue.
      * Returns an independent copy of the queue contents.
      *
-     * @returns Array of root buffers (with child spans in _children tree)
+     * @returns Array of root buffers whose children live in the trace topology arena
      */
     drain(): SpanBuffer<B['logBinding']['logSchema']>[];
 }

package/dist/lib/tracers/ArrayQueueTracer.js

@@ -57,7 +57,7 @@ export class ArrayQueueTracer extends Tracer {
      * Consume all queued buffers and clear the queue.
      * Returns an independent copy of the queue contents.
      *
-     * @returns Array of root buffers (with child spans in _children tree)
+     * @returns Array of root buffers whose children live in the trace topology arena
      */
     drain() {
         const buffers = [...this.queue];

package/dist/lib/tracers/StdioTracer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StdioTracer.d.ts","sourceRoot":"","sources":["../../../src/lib/tracers/StdioTracer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAY9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AA+HD;;GAEG;AACH,MAAM,WAAW,kBAAkB,CACjC,CAAC,SAAS,OAAO,wBAAwB,EAAE,SAAS,GAAG,OAAO,wBAAwB,EAAE,SAAS,CACjG,SAAQ,aAAa,CAAC,CAAC,CAAC;IACxB,iDAAiD;IACjD,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,gDAAgD;IAChD,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAMD;;;;;;;;;GASG;AAEH,qBAAa,WAAW,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;IACvF;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IAEvC,YAAY,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,EAKhF;IAMD,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,YAAY;IAoCpB,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,aAAa,GAAG,IAAI,CAOvF;IAED,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,aAAa,GAAG,IAAI,CAqBrF;IAED,WAAW,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,aAAa,GAAG,IAAI,CAQvF;IAED,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,aAAa,GAAG,IAAI,CAsBrF;IAED,mBAAmB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAgB3E;CACF"}
+{"version":3,"file":"StdioTracer.d.ts","sourceRoot":"","sources":["../../../src/lib/tracers/StdioTracer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAa9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAgID;;GAEG;AACH,MAAM,WAAW,kBAAkB,CACjC,CAAC,SAAS,OAAO,wBAAwB,EAAE,SAAS,GAAG,OAAO,wBAAwB,EAAE,SAAS,CACjG,SAAQ,aAAa,CAAC,CAAC,CAAC;IACxB,iDAAiD;IACjD,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,gDAAgD;IAChD,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAMD;;;;;;;;;GASG;AAEH,qBAAa,WAAW,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;IACvF;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IAEvC,YAAY,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,EAKhF;IAMD,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,YAAY;IAoCpB,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,aAAa,GAAG,IAAI,CAOvF;IAED,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,aAAa,GAAG,IAAI,CAqBrF;IAED,WAAW,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,aAAa,GAAG,IAAI,CAQvF;IAED,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,aAAa,GAAG,IAAI,CAsBrF;IAED,mBAAmB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAgB3E;CACF"}

package/dist/lib/tracers/StdioTracer.js

@@ -30,6 +30,7 @@
  * // [2025-12-25T10:30:45.226Z] [123456] fetch-user (103.00ms) ========
  * ```
  */
+import { resolveEntryType, resolveMessage } from '../resolveMessage.js';
 import { ENTRY_TYPE_DEBUG, ENTRY_TYPE_ERROR, ENTRY_TYPE_INFO, ENTRY_TYPE_SPAN_ERR, ENTRY_TYPE_SPAN_EXCEPTION, ENTRY_TYPE_SPAN_OK, ENTRY_TYPE_TRACE, ENTRY_TYPE_WARN, } from '../schema/systemSchema.js';
 import { Tracer } from '../tracer.js';
 // ============================================================================
@@ -127,19 +128,20 @@ function getLogLevel(entryType) {
     }
 }
 function formatTemplateMessage(buffer, row, template) {
-    return template.replace(/\{\{([A-Za-z0-9_]+)\}\}/g, (_full, key) => {
+    return template.replace(/\{([A-Za-z0-9_]+)\}/g, (_full, key) => {
+        const placeholder = `{${key}}`;
         const values = Reflect.get(buffer, `${key}_values`);
         if (values == null)
-            return `{{${key}}}`;
+            return placeholder;
         if (Array.isArray(values)) {
             const value = values[row];
-            return value === null || value === undefined ? `{{${key}}}` : String(value);
+            return value === null || value === undefined ? placeholder : String(value);
         }
         if (ArrayBuffer.isView(values)) {
             const value = Reflect.get(values, row);
-            return value === null || value === undefined ? `{{${key}}}` : String(value);
+            return value === null || value === undefined ? placeholder : String(value);
         }
-        return `{{${key}}}`;
+        return placeholder;
     });
 }
 // ============================================================================
@@ -208,10 +210,10 @@ export class StdioTracer extends Tracer {
             const start = isRootSegment ? 2 : 0;
             const end = current._writeIndex;
             for (let i = start; i < end; i++) {
-                const level = getLogLevel(current.entry_type[i]);
+                const level = getLogLevel(resolveEntryType(current, i));
                 if (!level)
                     continue;
-                const template = current.message_values[i] ?? '';
+                const template = resolveMessage(current, i) ?? '';
                 const message = formatTemplateMessage(current, i, template);
                 const ts = formatTimestamp(current.timestamp[i]);
                 const traceId = current.trace_id;
@@ -233,7 +235,7 @@ export class StdioTracer extends Tracer {
     // --------------------------------------------------------------------------
     onTraceStart(rootBuffer) {
         const traceId = rootBuffer.trace_id;
-        const name = rootBuffer.message_values[0];
+        const name = resolveMessage(rootBuffer, 0);
         const ts = formatTimestamp(rootBuffer.timestamp[0]);
         this.out.write(`[${ts}] ${this.color(traceId)}[${traceId}]${this.reset()} ${name}\n`);
         this.incrementIndent(traceId);
@@ -242,11 +244,11 @@ export class StdioTracer extends Tracer {
         const traceId = rootBuffer.trace_id;
         this.printLogRows(rootBuffer, 1);
         this.decrementIndent(traceId);
-        const name = rootBuffer.message_values[0];
+        const name = resolveMessage(rootBuffer, 0);
         const startTs = rootBuffer.timestamp[0];
         const endTs = rootBuffer.timestamp[1];
         const duration = formatDuration(endTs - startTs);
-        const entryType = rootBuffer.entry_type[1];
+        const entryType = resolveEntryType(rootBuffer, 1);
         const status = getStatus(entryType);
         const ts = formatTimestamp(endTs);
         const line = `[${ts}] ${this.color(traceId)}[${traceId}]${this.reset()} ${name} [${status}] (${duration}) ${'='.repeat(40)}\n`;
@@ -261,7 +263,7 @@ export class StdioTracer extends Tracer {
     onSpanStart(childBuffer) {
         const traceId = childBuffer.trace_id;
         const indent = this.getIndent(traceId);
-        const name = childBuffer.message_values[0];
+        const name = resolveMessage(childBuffer, 0);
         const ts = formatTimestamp(childBuffer.timestamp[0]);
         this.out.write(`[${ts}] ${this.color(traceId)}[${traceId}]${this.reset()} ${'  '.repeat(indent)}├─ ${name}\n`);
         this.incrementIndent(traceId);
@@ -271,11 +273,11 @@ export class StdioTracer extends Tracer {
         this.decrementIndent(traceId);
         const indent = this.getIndent(traceId);
         this.printLogRows(childBuffer, indent + 1);
-        const name = childBuffer.message_values[0];
+        const name = resolveMessage(childBuffer, 0);
         const startTs = childBuffer.timestamp[0];
         const endTs = childBuffer.timestamp[1];
         const duration = formatDuration(endTs - startTs);
-        const entryType = childBuffer.entry_type[1];
+        const entryType = resolveEntryType(childBuffer, 1);
         const status = getStatus(entryType);
         const ts = formatTimestamp(endTs);
         const line = `[${ts}] ${this.color(traceId)}[${traceId}]${this.reset()} ${'  '.repeat(indent)}└─ ${name} [${status}] (${duration})\n`;

package/dist/lib/tracers/TestTracer.d.ts

@@ -1,7 +1,7 @@
 /**
  * TestTracer - A tracer that accumulates completed root trace buffers for test inspection.
  *
- * Child spans are accessible via the buffer's `_children` tree - no need to track them separately.
+ * Child spans are accessible through the trace topology arena; no duplicate tracking is needed.
  * This is the primary tracer for tests that need to inspect trace output, convert to Arrow tables,
  * or verify buffer contents.
  *
@@ -43,9 +43,8 @@ export interface StatsSnapshot<T extends LogSchema = LogSchema> {
 /**
  * Test tracer that accumulates root buffers for inspection.
  *
- * Collects all completed root trace buffers in `rootBuffers` array.
- * Child spans are accessible via the buffer's `_children` tree -
- * no need to track them separately.
+ * Collects all completed root trace buffers in `rootBuffers`; child spans remain reachable
+ * through each root's trace topology arena.
  *
  * Also tracks capacity tuning events via `statsSnapshots` to verify
  * that `onStatsWillResetFor` is called before stats are reset.
@@ -72,8 +71,7 @@ export interface StatsSnapshot<T extends LogSchema = LogSchema> {
  */
 export declare class TestTracer<B extends OpContextBinding = OpContextBinding> extends Tracer<B> {
     /**
-     * All completed root trace buffers.
-     * Child spans are accessible via each buffer's `_children` tree.
+     * All completed root trace buffers. Child spans remain in each root's topology arena.
      */
     readonly rootBuffers: SpanBuffer<B['logBinding']['logSchema']>[];
     /**

package/dist/lib/tracers/TestTracer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TestTracer.d.ts","sourceRoot":"","sources":["../../../src/lib/tracers/TestTracer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAU9C;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IAC5D,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,qBAAa,UAAU,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;IACtF;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,CAAM;IAEtE;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,CAAM;IAM5E,YAAY,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAExE;IAED,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAGrE;IAED,WAAW,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAExE;IAED,SAAS,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAEtE;IAED,mBAAmB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAS1E;IAMD;;;OAGG;IACH,KAAK,IAAI,IAAI,CAQZ;CACF"}
+{"version":3,"file":"TestTracer.d.ts","sourceRoot":"","sources":["../../../src/lib/tracers/TestTracer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAU9C;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IAC5D,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,qBAAa,UAAU,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;IACtF;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,CAAM;IAEtE;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,CAAM;IAM5E,YAAY,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAExE;IAED,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAGrE;IAED,WAAW,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAExE;IAED,SAAS,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAEtE;IAED,mBAAmB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAS1E;IAMD;;;OAGG;IACH,KAAK,IAAI,IAAI,CAQZ;CACF"}

package/dist/lib/tracers/TestTracer.js

@@ -1,7 +1,7 @@
 /**
  * TestTracer - A tracer that accumulates completed root trace buffers for test inspection.
  *
- * Child spans are accessible via the buffer's `_children` tree - no need to track them separately.
+ * Child spans are accessible through the trace topology arena; no duplicate tracking is needed.
  * This is the primary tracer for tests that need to inspect trace output, convert to Arrow tables,
  * or verify buffer contents.
  *
@@ -34,9 +34,8 @@ function isResettableBufferStrategy(value) {
 /**
  * Test tracer that accumulates root buffers for inspection.
  *
- * Collects all completed root trace buffers in `rootBuffers` array.
- * Child spans are accessible via the buffer's `_children` tree -
- * no need to track them separately.
+ * Collects all completed root trace buffers in `rootBuffers`; child spans remain reachable
+ * through each root's trace topology arena.
  *
  * Also tracks capacity tuning events via `statsSnapshots` to verify
  * that `onStatsWillResetFor` is called before stats are reset.
@@ -64,8 +63,7 @@ function isResettableBufferStrategy(value) {
 //#region smoo/lmao!n/tracer-implementations.test
 export class TestTracer extends Tracer {
     /**
-     * All completed root trace buffers.
-     * Child spans are accessible via each buffer's `_children` tree.
+     * All completed root trace buffers. Child spans remain in each root's topology arena.
      */
     rootBuffers = [];
     /**
@@ -84,10 +82,10 @@ export class TestTracer extends Tracer {
         this.rootBuffers.push(rootBuffer);
     }
     onSpanStart(_childBuffer) {
-        // No-op - children are in tree, accessed via rootBuffer._children
+        // No-op - children are registered in the trace topology arena
     }
     onSpanEnd(_childBuffer) {
-        // No-op - children are in tree, accessed via rootBuffer._children
+        // No-op - children are registered in the trace topology arena
     }
     onStatsWillResetFor(buffer) {
         // Capture stats snapshot before they're reset

package/dist/lib/types.d.ts

@@ -10,12 +10,14 @@
  */
 import type { AnyColumnBuffer, ColumnBuffer, ColumnValueType, EagerBinarySchema, LazyBinarySchema, Nanoseconds, TypedArray } from '@smoothbricks/arrow-builder';
 import type { OpMetadata } from './opContext/opTypes.js';
+import type { MessageLayoutFamily, MessagePhysicalLayout } from './runtimeHint.js';
 import type { LogSchema } from './schema/LogSchema.js';
 import type { InferSchema } from './schema/types.js';
 import type { SpanBufferStats } from './spanBufferStats.js';
 import type { TraceId } from './traceId.js';
 import type { ITraceRoot } from './traceRoot.js';
-export type { LogBinding, RemappedViewConstructor } from './logBinding.js';
+import type { VocabularyGeneration } from './vocabularyRegistry.js';
+export type { LogBinding, RemapDescriptor, RemappedColumn } from './logBinding.js';
 export type { OpMetadata } from './opContext/opTypes.js';
 export type { extractSpanIdentity, SpanIdentity } from './traceId.js';
 export type { TracerLifecycleHooks } from './traceRoot.js';
@@ -77,13 +79,29 @@ export interface AnySpanBuffer extends AnyColumnBuffer {
      * - Rows 2+: log entry timestamps
      */
     readonly timestamp: BigInt64Array;
-    /**
-     * Entry type enum for each row (Uint8Array, 1 byte per entry).
-     *
-     * Per specs/lmao/01h_entry_types_and_logging_primitives.md:
-     * Values are ENTRY_TYPE_* constants (span-start=1, span-ok=2, etc.)
-     */
-    readonly entry_type: Uint8Array;
+    /** Current and specialized layouts expose this direct lane; packed uses `resolveEntryType`. */
+    readonly entry_type?: Uint8Array;
+    /** Current-mode buffer-local template IDs. Zero selects the raw reference lane. */
+    readonly _messageIds?: Uint16Array;
+    /** Specialized 1-based global dense message identities. Zero selects the raw/null sidecar sentinel. */
+    readonly _logHeaders?: Uint32Array;
+    /** Packed row headers: low 8 bits entry type, high 24 bits dense message index plus one. */
+    readonly _rowHeaders?: Uint32Array;
+    /** Immutable vocabulary generation against which packed message indices resolve. */
+    readonly _vocabularyGeneration: VocabularyGeneration;
+    /** Concrete semantic message family selected once for this buffer constructor. */
+    readonly _messageLayoutFamily: MessageLayoutFamily;
+    /**
+     * One-shot token set by WASM constructors whose allocation export already
+     * initialized row 0, row 1, and the shared write index.
+     */
+    _spanStartedAtAllocation?: boolean;
+    /** Concrete physical row layout selected once for this buffer constructor. */
+    readonly _messagePhysicalLayout: MessagePhysicalLayout;
+    /** Dedicated row-0 span name used when the selected capacity lane cannot represent it. */
+    _spanName?: string | number;
+    /** Dedicated row-1 raw result/exception text for static-only buffers. */
+    _terminalMessage?: string;
     /**
      * Timestamp of span start (row 0).
      *
@@ -112,6 +130,10 @@ export interface AnySpanBuffer extends AnyColumnBuffer {
      * Per specs/lmao/01b2: Buffers chain rather than resize for predictable allocation.
      */
     _overflow?: AnySpanBuffer;
+    /** Whether this physical segment has contributed its rows to shared stats. */
+    _statsSealed: boolean;
+    /** Lifecycle rows excluded when this physical segment is sealed (2 for first segment, 0 for overflow). */
+    _statsReservedRows: number;
     /**
      * Span ID - 32-bit counter unique within this trace.
      * Per specs/lmao/01b4_span_identity.md: Monotonic counter, not globally unique.
@@ -146,29 +168,24 @@ export interface AnySpanBuffer extends AnyColumnBuffer {
      */
     readonly _logSchema: LogSchema;
     /**
-     * Column entries for Arrow conversion iteration.
-     * For SpanBuffer: delegates to _logSchema._columns (unprefixed names)
-     * For RemappedBufferView: built in constructor with prefixed names from mapping
-     *
-     * This enables Arrow conversion to iterate column names correctly regardless of
-     * whether the buffer is wrapped in a RemappedBufferView.
+     * Canonical schema column entries for this buffer.
+     * Output remapping lives separately in `_remapDescriptor` and is interpreted
+     * only by cold Arrow traversal.
      */
     readonly _columns: ReadonlyArray<[string, unknown]>;
+    /** Immutable cold-path output remapping attached to canonical child buffers. */
+    _remapDescriptor?: import('./logBinding.js').RemapDescriptor;
     /**
      * Shared stats for all buffers from same defineOpContext (accessed via constructor.stats).
      * Enables self-tuning capacity learning across all ops in the same context.
      * Underscore prefix since this is an internal property.
      */
     readonly _stats: SpanBufferStats;
-    /**
-     * Child spans created via ctx.span().
-     * Per specs/lmao/01c: Parent-child relationship for trace tree.
-     */
-    _children: AnySpanBuffer[];
-    /**
-     * Parent span buffer (undefined for root).
-     * Set during createChildSpanBuffer().
-     */
+    /** Stable trace-owned logical node index. Overflow segments share the same index. */
+    _nodeIndex: number;
+    /** Trace-topology generation used to reject released or reset handles. */
+    _topologyGeneration: number;
+    /** Parent span buffer (undefined for root). Preserved for identity access and parent ascent. */
     _parent?: AnySpanBuffer;
     /**
      * Root trace context - shared by all buffers in a trace.
@@ -199,12 +216,8 @@ export interface AnySpanBuffer extends AnyColumnBuffer {
      * - Applied to all rows at Arrow conversion via TypedArray.fill()
      */
     _scopeValues: Readonly<Record<string, unknown>>;
-    /**
-     * Message column values - category strings (eager, always allocated).
-     * Contains span names, log messages, exception messages, etc.
-     */
-    readonly message_values: string[];
-    readonly message_nulls: Uint8Array;
+    /** Raw per-row message lane. Omitted by static-only; `undefined` is the null sentinel. */
+    readonly message_values?: (string | undefined)[];
     /**
      * Line number column values - Float64Array (lazy but always present).
      * Contains source code line numbers injected by transformer.
@@ -290,6 +303,10 @@ export interface AnySpanBuffer extends AnyColumnBuffer {
      * @returns The overflow buffer (existing or newly created)
      */
     getOrCreateOverflow(): AnySpanBuffer;
+    /** Account this physical segment's completed rows exactly once. */
+    _sealStats(): void;
+    /** Account every physical segment in this logical span's overflow chain exactly once. */
+    _sealStatsChain(): void;
     /**
      * Check if this span is a parent of another span.
      * Used for tree traversal and validation.
@@ -347,19 +364,19 @@ type FilterSchemaFields<T> = {
  * T is REQUIRED - there is no default. Use AnySpanBuffer for generic processing.
  */
 export type SpanBuffer<T extends LogSchema> = AnySpanBuffer & {
-    _children: SpanBuffer<T>[];
     _parent?: SpanBuffer<T>;
     _overflow?: SpanBuffer<T>;
     readonly _logSchema: T;
+    _traceRoot: ITraceRoot<T>;
     _scopeValues: Readonly<Partial<InferSchema<T>>>;
     isParentOf(other: SpanBuffer<T>): boolean;
     isChildOf(other: SpanBuffer<T>): boolean;
     [key: `${string}_values`]: TypedArray | string[] | unknown[] | undefined;
     [key: `${string}_nulls`]: Uint8Array | undefined;
 } & {
-    readonly [K in keyof FilterSchemaFields<T['fields']> as `${K & string}_values`]: ValuesArrayType<FilterSchemaFields<T['fields']>[K]>;
+    readonly [K in keyof FilterSchemaFields<T['fields']> as K extends 'message' ? never : `${K & string}_values`]: ValuesArrayType<FilterSchemaFields<T['fields']>[K]>;
 } & {
-    readonly [K in keyof FilterSchemaFields<T['fields']> as `${K & string}_nulls`]: Uint8Array;
+    readonly [K in keyof FilterSchemaFields<T['fields']> as K extends 'message' ? never : `${K & string}_nulls`]: Uint8Array;
 } & {
     [K in keyof FilterSchemaFields<T['fields']>]: (pos: number, val: SetterValueType<FilterSchemaFields<T['fields']>[K]>) => SpanBuffer<T>;
 };