@smoothbricks/lmao 0.2.1 → 0.2.3

package/dist/lib/op.d.ts

@@ -13,11 +13,16 @@
  * - Op name is used for metrics tracking (separate from span names)
  */
 import type { PreEncodedEntry } from '@smoothbricks/arrow-builder';
-import type { RemappedViewConstructor } from './logBinding.js';
+import type { RemapDescriptor } from './logBinding.js';
 import type { SpanContext } from './opContext/spanContextTypes.js';
 import type { OpContext, OpContextBinding } from './opContext/types.js';
+import type { ArrowExposurePlan, CallsitePlan, EagerColumnDescriptor, PhysicalAppenders } from './physicalLayoutPlan.js';
 import type { Result } from './result.js';
+import type { LogSchema } from './schema/LogSchema.js';
 import type { SpanBufferConstructor } from './spanBuffer.js';
+import type { TimestampAppendPrimitive } from './traceRoot.js';
+import type { VocabularyGeneration } from './vocabularyRegistry.js';
+import type { WasmLayoutTemplate } from './wasm/wasmPhysicalLayout.js';
 /**
  * Metadata injected by the transformer into each Op.
  * These values are determined at compile time from the source location.
@@ -25,7 +30,14 @@ import type { SpanBufferConstructor } from './spanBuffer.js';
  * Includes pre-encoded UTF-8 entries for Arrow dictionary building -
  * encode once at Op definition time, reuse for every span conversion.
  */
-export interface OpMetadata {
+export interface OpCompileMetadata {
+    readonly runtimeHint: number;
+    readonly eagerColumns?: readonly string[];
+    readonly localMessageDictionary?: readonly number[];
+    /** ttsc-only startup hook that installs the source-emitted physical buffer constructor. */
+    readonly materializeSpanBufferClass?: (schema: LogSchema) => void;
+}
+export interface OpMetadata<T extends LogSchema = LogSchema> {
     /** Op name for metrics tracking (distinct from span names which are provided at call sites) */
     readonly name: string;
     /** Package name from package.json */
@@ -42,6 +54,18 @@ export interface OpMetadata {
     readonly package_file_entry: PreEncodedEntry;
     /** Pre-encoded git_sha for Arrow dictionary building */
     readonly git_sha_entry: PreEncodedEntry;
+    /** Startup-resolved physical layout used by span setup; absent only on raw fallback metadata. */
+    readonly _physicalLayoutPlan?: {
+        readonly SpanBufferClass: SpanBufferConstructor<T>;
+        readonly eagerColumns: EagerColumnDescriptor;
+        readonly vocabularyGeneration: VocabularyGeneration;
+        readonly localMessageDictionary: readonly number[];
+        readonly encodeLocalMessage: (globalDenseIndex: number) => number;
+        readonly wasmLayout: WasmLayoutTemplate;
+        readonly appendLogEntry: TimestampAppendPrimitive;
+        readonly arrowExposure: ArrowExposurePlan;
+        readonly appenders: PhysicalAppenders;
+    };
 }
 /**
  * Op - Traced operation (Phase 2 architecture)
@@ -63,7 +87,7 @@ export interface OpMetadata {
  *
  * Phase 2 architecture:
  * - SpanBufferClass carries static schema + stats (shared by all ops from same defineOpContext)
- * - remappedViewClass only set for prefixed ops (wraps child buffers before adding to _children)
+ * - remapDescriptor is an immutable cold-path binding for prefixed/mapped ops
  * - No LogBinding - stats accessed via SpanBufferClass.stats
  *
  * @typeParam Ctx - OpContext with deps, ff, env (contravariant position)
@@ -72,34 +96,10 @@ export interface OpMetadata {
  * @typeParam E - Error type of the Result
  */
 export declare class Op<Ctx extends OpContext, Args extends unknown[], S, E> {
-    /** Op name for metrics, telemetry, and debugging */
     readonly metadata: OpMetadata;
-    /** Op owns buffer creation - class has static schema + stats shared by all instances */
-    readonly SpanBufferClass: SpanBufferConstructor;
-    /** The user function to execute - called by span_op after context creation (can be sync or async) */
+    readonly callsitePlan: CallsitePlan<Ctx['logSchema'], Ctx>;
     readonly fn: (ctx: SpanContext<Ctx>, ...args: Args) => Result<S, E> | Promise<Result<S, E>>;
-    /** Only set for prefixed ops - wraps child buffers during registration */
-    readonly remappedViewClass?: RemappedViewConstructor | undefined;
-    /**
-     * WHY: Carries the OpContextBinding from the factory that created this Op.
-     * Enables downstream consumers (defineAgentOps, OpRegistry) to extract the
-     * LMAO schema for context merging and conflict detection.
-     */
-    readonly _opContextBinding?: OpContextBinding | undefined;
-    constructor(
-    /** Op name for metrics, telemetry, and debugging */
-    metadata: OpMetadata, 
-    /** Op owns buffer creation - class has static schema + stats shared by all instances */
-    SpanBufferClass: SpanBufferConstructor, 
-    /** The user function to execute - called by span_op after context creation (can be sync or async) */
-    fn: (ctx: SpanContext<Ctx>, ...args: Args) => Result<S, E> | Promise<Result<S, E>>, 
-    /** Only set for prefixed ops - wraps child buffers during registration */
-    remappedViewClass?: RemappedViewConstructor | undefined, 
-    /**
-     * WHY: Carries the OpContextBinding from the factory that created this Op.
-     * Enables downstream consumers (defineAgentOps, OpRegistry) to extract the
-     * LMAO schema for context merging and conflict detection.
-     */
-    _opContextBinding?: OpContextBinding | undefined);
+    readonly _opContextBinding?: OpContextBinding<Ctx['logSchema'], Ctx['flags'], Ctx['deps'], Ctx['userCtx']>;
+    constructor(metadata: OpMetadata, SpanBufferClass: SpanBufferConstructor<Ctx['logSchema']>, fn: (ctx: SpanContext<Ctx>, ...args: Args) => Result<S, E> | Promise<Result<S, E>>, remapDescriptor?: RemapDescriptor, opContextBinding?: OpContextBinding<Ctx['logSchema'], Ctx['flags'], Ctx['deps'], Ctx['userCtx']>, runtimeHint?: number, eagerColumns?: readonly string[], localMessageDictionary?: readonly number[]);
 }
 //# sourceMappingURL=op.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"op.d.ts","sourceRoot":"","sources":["../../src/lib/op.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAM7D;;;;;;GAMG;AAMH,MAAM,WAAW,UAAU;IACzB,+FAA+F;IAC/F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,6DAA6D;IAC7D,QAAQ,CAAC,kBAAkB,EAAE,eAAe,CAAC;IAC7C,6DAA6D;IAC7D,QAAQ,CAAC,kBAAkB,EAAE,eAAe,CAAC;IAC7C,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC;CACzC;AAQD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,EAAE,CAAC,GAAG,SAAS,SAAS,EAAE,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;IAE/D,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,UAAU;IAC7B,wFAAwF;IACxF,QAAQ,CAAC,eAAe,EAAE,qBAAqB;IAC/C,qGAAqG;IACrG,QAAQ,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3F,0EAA0E;IAC1E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,uBAAuB;IACpD;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,gBAAgB;IAd/C;IACE,oDAAoD;IAC3C,QAAQ,EAAE,UAAU;IAC7B,wFAAwF;IAC/E,eAAe,EAAE,qBAAqB;IAC/C,qGAAqG;IAC5F,EAAE,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3F,0EAA0E;IACjE,iBAAiB,CAAC,EAAE,uBAAuB,YAAA;IACpD;;;;OAIG;IACM,iBAAiB,CAAC,EAAE,gBAAgB,YAAA,EAC3C;CACL"}
+{"version":3,"file":"op.d.ts","sourceRoot":"","sources":["../../src/lib/op.ts"],"names":[],"mappings":"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"}

package/dist/lib/op.js

@@ -12,6 +12,9 @@
  * - fn is called by span_op() after span_op creates the SpanBuffer/SpanContext
  * - Op name is used for metrics tracking (separate from span names)
  */
+import { getPhysicalLayoutPlan, sealCallsitePlan } from './physicalLayoutPlan.js';
+import { decodeRuntimeHint } from './runtimeHint.js';
+import { createSpanContextClass } from './spanContext.js';
 //#endregion smoo/lmao!n/opcontext-hierarchy
 // =============================================================================
 // Op Class
@@ -37,7 +40,7 @@
  *
  * Phase 2 architecture:
  * - SpanBufferClass carries static schema + stats (shared by all ops from same defineOpContext)
- * - remappedViewClass only set for prefixed ops (wraps child buffers before adding to _children)
+ * - remapDescriptor is an immutable cold-path binding for prefixed/mapped ops
  * - No LogBinding - stats accessed via SpanBufferClass.stats
  *
  * @typeParam Ctx - OpContext with deps, ff, env (contravariant position)
@@ -47,30 +50,20 @@
  */
 export class Op {
     metadata;
-    SpanBufferClass;
+    callsitePlan;
     fn;
-    remappedViewClass;
     _opContextBinding;
-    constructor(
-    /** Op name for metrics, telemetry, and debugging */
-    metadata, 
-    /** Op owns buffer creation - class has static schema + stats shared by all instances */
-    SpanBufferClass, 
-    /** The user function to execute - called by span_op after context creation (can be sync or async) */
-    fn, 
-    /** Only set for prefixed ops - wraps child buffers during registration */
-    remappedViewClass, 
-    /**
-     * WHY: Carries the OpContextBinding from the factory that created this Op.
-     * Enables downstream consumers (defineAgentOps, OpRegistry) to extract the
-     * LMAO schema for context merging and conflict detection.
-     */
-    _opContextBinding) {
-        this.metadata = metadata;
-        this.SpanBufferClass = SpanBufferClass;
+    constructor(metadata, SpanBufferClass, fn, remapDescriptor, opContextBinding, runtimeHint = 0, eagerColumns = [], localMessageDictionary = Object.freeze([])) {
+        const userContextKeys = Object.keys(opContextBinding?.ctxDefaults ?? {}).sort();
+        const layoutKey = userContextKeys.join('\u0000');
+        const capabilities = decodeRuntimeHint(runtimeHint).capabilities;
+        const SpanContextClass = createSpanContextClass(SpanBufferClass.schema, opContextBinding?.logBinding ?? { logSchema: SpanBufferClass.schema }, capabilities, userContextKeys);
+        const physicalLayoutPlan = getPhysicalLayoutPlan(SpanBufferClass, runtimeHint, SpanContextClass, remapDescriptor, 'strategy-selected', layoutKey, eagerColumns, localMessageDictionary);
+        const resolvedMetadata = Object.freeze({ ...metadata, _physicalLayoutPlan: physicalLayoutPlan });
+        this.callsitePlan = sealCallsitePlan(physicalLayoutPlan, resolvedMetadata);
+        this.metadata = resolvedMetadata;
         this.fn = fn;
-        this.remappedViewClass = remappedViewClass;
-        this._opContextBinding = _opContextBinding;
+        this._opContextBinding = opContextBinding;
     }
 }
 //#endregion smoo/lmao!n/op-class

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

@@ -8,7 +8,7 @@
  * - Private fields (#columnMapping) don't affect hidden class (truly hidden, no enumeration)
  * - Ops as own properties enable direct access and predictable object shape
  * - prefix()/mapColumns() create new instances with same SpanBufferClass (shared stats)
- * - Only remappedViewClass differs between original and prefixed op instances
+ * - Only immutable remap metadata differs between original and mapped op instances
  *
  * Internal properties (_logSchema, _flags, etc.) are prefixed with underscore to avoid
  * collision with user-defined op names. Public interfaces hide these from intellisense.

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

@@ -1 +1 @@
-{"version":3,"file":"createOpGroup.d.ts","sourceRoot":"","sources":["../../../src/lib/opContext/createOpGroup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAKV,OAAO,EAEP,UAAU,EAGX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA8X5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,aAAa,CAAC,GAAG,SAAS,SAAS,EAAE,GAAG,SAAS,UAAU,CAAC,GAAG,CAAC,EAC9E,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,EAC3B,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,EACnB,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAInB"}
+{"version":3,"file":"createOpGroup.d.ts","sourceRoot":"","sources":["../../../src/lib/opContext/createOpGroup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,KAAK,EAKV,OAAO,EAEP,UAAU,EAGX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA+X5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,aAAa,CAAC,GAAG,SAAS,SAAS,EAAE,GAAG,SAAS,UAAU,CAAC,GAAG,CAAC,EAC9E,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,EAC3B,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,EACnB,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAInB"}

package/dist/lib/opContext/createOpGroup.js

@@ -8,22 +8,22 @@
  * - Private fields (#columnMapping) don't affect hidden class (truly hidden, no enumeration)
  * - Ops as own properties enable direct access and predictable object shape
  * - prefix()/mapColumns() create new instances with same SpanBufferClass (shared stats)
- * - Only remappedViewClass differs between original and prefixed op instances
+ * - Only immutable remap metadata differs between original and mapped op instances
  *
  * Internal properties (_logSchema, _flags, etc.) are prefixed with underscore to avoid
  * collision with user-defined op names. Public interfaces hide these from intellisense.
  *
  * @module opContext/createOpGroup
  */
-import { generateRemappedBufferViewClass } from '../library.js';
+import { createRemapDescriptor } from '../library.js';
 import { Op } from '../op.js';
 import { SYSTEM_SCHEMA_FIELD_NAMES } from '../schema/systemSchema.js';
 import { validateOpName } from './opGroupTypes.js';
 //#region smoo/lmao!n/column-mapping-api
 // 01l "Dependencies with Column Mapping" + 01e "Column Mapping API": .prefix(name) and
-// .mapColumns({ col: 'new' | 'shared' | null }) are realized here. Each call clones the
-// OpGroup's ops with a fresh RemappedBufferView (cold-path codegen via library.ts), so the
-// hot path still writes the clean unprefixed columns; the view remaps clean->target for Arrow.
+// .mapColumns({ col: 'new' | 'shared' | null }) are composed here. Each call clones the
+// OpGroup's ops with one immutable descriptor; child buffers remain canonical and Arrow
+// interprets the descriptor only on its cold traversal path.
 // =============================================================================
 // INTERNAL HELPERS
 // =============================================================================
@@ -31,12 +31,8 @@ function getSchemaFields(fieldsSchema) {
     return fieldsSchema.fields;
 }
 /**
- * Create reverse mapping for RemappedBufferView.
- * Input: clean -> prefixed mapping (e.g., { status: 'http_status' })
- * Output: prefixed -> clean mapping (e.g., { http_status: 'status' })
- *
- * Why reverse: RemappedBufferView wraps child buffer at registration time.
- * Arrow conversion asks for 'http_status', view needs to find 'status' in raw buffer.
+ * Create the fully composed Arrow output-to-canonical-source mapping.
+ * Input: clean -> output mapping; output: output -> clean mapping.
  */
 function createReverseMapping(mapping) {
     const reverse = {};
@@ -50,10 +46,10 @@ function createReverseMapping(mapping) {
 function isOpInstance(value) {
     return value instanceof Op;
 }
-function copyOpsWithView(source, target, remappedViewClass) {
+function copyOpsWithDescriptor(source, target, remapDescriptor) {
     for (const [key, value] of Object.entries(source)) {
         if (isOpInstance(value)) {
-            target[key] = new Op(value.metadata, value.SpanBufferClass, value.fn, remappedViewClass, value._opContextBinding);
+            target[key] = new Op(value.metadata, value.callsitePlan.SpanBufferClass, value.fn, remapDescriptor, value._opContextBinding, value.callsitePlan.runtimeHint, value.callsitePlan.eagerColumns.names, value.callsitePlan.localMessageDictionary);
         }
     }
 }
@@ -64,15 +60,17 @@ function assertGroupCarriesOps(group, ops) {
         }
     }
 }
-function cloneOpsWithView(source, remappedViewClass) {
+function cloneOpsWithDescriptor(source, remapDescriptor) {
     const cloned = {};
-    copyOpsWithView(source, cloned, remappedViewClass);
+    copyOpsWithDescriptor(source, cloned, remapDescriptor);
     assertGroupCarriesOps(cloned, source);
     return cloned;
 }
 function prefixContributedSchema(fields, prefix) {
     const result = {};
     for (const [key, value] of Object.entries(fields)) {
+        if (SYSTEM_SCHEMA_FIELD_NAMES.has(key))
+            continue;
         result[`${prefix}_${key}`] = value;
     }
     assertMappedSchema(result);
@@ -182,7 +180,7 @@ function validateAllOpNames(ops) {
  * 2. Ops spread as own properties for direct access (`.request` not `.ops.request`)
  * 3. Prototype methods (prefix/mapColumns) shared across instances
  * 4. Same SpanBufferClass preserved across prefix() calls (shared schema + stats)
- * 5. Only remappedViewClass differs between original and prefixed ops
+ * 5. Only immutable remap metadata differs between original and mapped ops
  *
  * Structure enables V8 optimization:
  * - All OpGroup instances with same ops have same hidden class
@@ -218,25 +216,22 @@ class OpGroupImpl {
         const newMapping = hasMapping
             ? prefixMapping(this.#columnMapping, p)
             : buildPrefixMapping(this._logSchema._columnNames, p);
-        // Generate RemappedBufferView for this prefix
-        // Why reverse mapping: Arrow conversion asks for 'http_status', needs to find 'status'
         const reverseMapping = createReverseMapping(newMapping);
-        const remappedViewClass = generateRemappedBufferViewClass(reverseMapping);
+        const remapDescriptor = createRemapDescriptor(this._logSchema, reverseMapping);
         // Create new OpGroup with prefixed ops
-        const newGroup = new MappedOpGroupImpl(this._logSchema, this._flags, cloneOpsWithView(this.#ops, remappedViewClass), newMapping, prefixContributedSchema(getSchemaFields(this._logSchema), p));
+        const newGroup = new MappedOpGroupImpl(this._logSchema, this._flags, cloneOpsWithDescriptor(this.#ops, remapDescriptor), newMapping, prefixContributedSchema(getSchemaFields(this._logSchema), p));
         assertGroupCarriesOps(newGroup, this.#ops);
         return newGroup;
     }
     mapColumns(mapping) {
         // Override/extend the existing mapping with new mapping
         const newMapping = { ...this.#columnMapping, ...mapping };
-        // Generate RemappedBufferView for this mapping
         const reverseMapping = createReverseMapping(newMapping);
-        const remappedViewClass = generateRemappedBufferViewClass(reverseMapping);
+        const remapDescriptor = createRemapDescriptor(this._logSchema, reverseMapping);
         // Build contributed schema from original fields with new mapping
         const newContributed = buildContributedSchema(getSchemaFields(this._logSchema), newMapping);
         // Create new OpGroup with mapped ops
-        const newGroup = new MappedOpGroupImpl(this._logSchema, this._flags, cloneOpsWithView(this.#ops, remappedViewClass), newMapping, newContributed);
+        const newGroup = new MappedOpGroupImpl(this._logSchema, this._flags, cloneOpsWithDescriptor(this.#ops, remapDescriptor), newMapping, newContributed);
         assertGroupCarriesOps(newGroup, this.#ops);
         return newGroup;
     }
@@ -276,26 +271,24 @@ class MappedOpGroupImpl {
     prefix(p) {
         // Apply prefix to the current mapping's target names
         const newMapping = prefixMapping(this.#columnMapping, p);
-        // Generate RemappedBufferView
         const reverseMapping = createReverseMapping(newMapping);
-        const remappedViewClass = generateRemappedBufferViewClass(reverseMapping);
+        const remapDescriptor = createRemapDescriptor(this._logSchema, reverseMapping);
         // Build new contributed schema by prefixing current contributed schema
         const newContributed = prefixContributedSchema(this._contributedSchema, p);
         // Create new MappedOpGroup
-        const newGroup = new MappedOpGroupImpl(this._logSchema, this._flags, cloneOpsWithView(this.#ops, remappedViewClass), newMapping, newContributed);
+        const newGroup = new MappedOpGroupImpl(this._logSchema, this._flags, cloneOpsWithDescriptor(this.#ops, remapDescriptor), newMapping, newContributed);
         assertGroupCarriesOps(newGroup, this.#ops);
         return newGroup;
     }
     mapColumns(mapping) {
         // Override/extend the existing mapping
         const newMapping = { ...this.#columnMapping, ...mapping };
-        // Generate RemappedBufferView
         const reverseMapping = createReverseMapping(newMapping);
-        const remappedViewClass = generateRemappedBufferViewClass(reverseMapping);
+        const remapDescriptor = createRemapDescriptor(this._logSchema, reverseMapping);
         // Build contributed schema from current contributed fields so chained maps stay typed to the public surface.
         const newContributed = buildContributedSchema(this._contributedSchema, mapping);
         // Create new MappedOpGroup
-        const newGroup = new MappedOpGroupImpl(this._logSchema, this._flags, cloneOpsWithView(this.#ops, remappedViewClass), newMapping, newContributed);
+        const newGroup = new MappedOpGroupImpl(this._logSchema, this._flags, cloneOpsWithDescriptor(this.#ops, remapDescriptor), newMapping, newContributed);
         assertGroupCarriesOps(newGroup, this.#ops);
         return newGroup;
     }

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

@@ -7,7 +7,7 @@
  * @module opContext/defineOp
  */
 import type { OpGroup, OpGroupOps } from './opGroupTypes.js';
-import type { Op, OpFn, OpMetadata, OpsFromRecord } from './opTypes.js';
+import type { Op, OpCompileMetadata, OpFn, OpMetadata, OpsFromRecord } from './opTypes.js';
 import type { OpContext } from './types.js';
 /**
  * Create OpMetadata with pre-encoded entries for Arrow dictionary building.
@@ -54,13 +54,13 @@ type CreateOpGroupFn<Ctx extends OpContext> = <Ops extends OpGroupOps<Ctx>>(logS
  * - metadata: includes name + merged with defaults
  * - SpanBufferClass: from getSpanBufferClass(logSchema) - has static schema + stats
  * - fn(ctx, ...args): the user function to execute
- * - remappedViewClass: undefined for original ops (set by .prefix() method)
+ * - remapDescriptor: undefined for original ops (set by .prefix()/.mapColumns())
  *
  * @template Ctx - Bundled OpContext (logSchema, flags, deps, userCtx)
  * @param factoryConfig - Configuration containing logSchema and flags
  * @returns A defineOp function for creating Op instances
  */
-export declare function createDefineOp<Ctx extends OpContext>(factoryConfig: DefineOpFactoryConfig<Ctx>): <Args extends unknown[], S, E>(name: string, fn: OpFn<Ctx, Args, S, E>, metadata?: Partial<OpMetadata>) => Op<Ctx, Args, S, E>;
+export declare function createDefineOp<Ctx extends OpContext>(factoryConfig: DefineOpFactoryConfig<Ctx>): <Args extends unknown[], S, E>(name: string, fn: OpFn<Ctx, Args, S, E>, metadata?: Partial<OpMetadata>, compileMetadata?: OpCompileMetadata) => Op<Ctx, Args, S, E>;
 /**
  * Creates a defineOps function bound to a specific factory config.
  *
@@ -78,6 +78,6 @@ export declare function createDefineOp<Ctx extends OpContext>(factoryConfig: Def
  * @param createOpGroup - Factory function for creating OpGroups
  * @returns A defineOps function for creating OpGroups
  */
-export declare function createDefineOps<Ctx extends OpContext>(factoryConfig: DefineOpFactoryConfig<Ctx>, createOpGroup: CreateOpGroupFn<Ctx>): <Defs extends Record<string, Op<Ctx, unknown[], unknown, unknown> | OpFn<Ctx, unknown[], unknown, unknown>>>(definitions: Defs & ThisType<OpsFromRecord<Ctx, Defs>>) => OpGroup<Ctx, OpsFromRecord<Ctx, Defs>>;
+export declare function createDefineOps<Ctx extends OpContext>(factoryConfig: DefineOpFactoryConfig<Ctx>, createOpGroup: CreateOpGroupFn<Ctx>): <Defs extends Record<string, Op<Ctx, unknown[], unknown, unknown> | OpFn<Ctx, unknown[], unknown, unknown>>>(definitions: Defs & ThisType<OpsFromRecord<Ctx, Defs>>, compileMetadataByKey?: Partial<Record<keyof Defs, OpCompileMetadata>>) => OpGroup<Ctx, OpsFromRecord<Ctx, Defs>>;
 export {};
 //# sourceMappingURL=defineOp.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"defineOp.d.ts","sourceRoot":"","sources":["../../../src/lib/opContext/defineOp.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAW5C;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,UAAU,CAYZ;AAMD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAA4E,CAAC;AAM5G;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,SAAI,GAAG,UAAU,CA6DnE;AAOD;;;GAGG;AACH,UAAU,qBAAqB,CAAC,GAAG,SAAS,SAAS;IACnD,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,YAAY,EAAE,gBAAgB,CAAC;CACnE;AAED;;;GAGG;AACH,KAAK,eAAe,CAAC,GAAG,SAAS,SAAS,IAAI,CAAC,GAAG,SAAS,UAAU,CAAC,GAAG,CAAC,EACxE,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,EAC3B,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,EACnB,GAAG,EAAE,GAAG,KACL,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAMvB;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,GAAG,SAAS,SAAS,EAClD,aAAa,EAAE,qBAAqB,CAAC,GAAG,CAAC,GACxC,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,EACzB,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,KAC3B,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CA0BvB;AAyBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,GAAG,SAAS,SAAS,EACnD,aAAa,EAAE,qBAAqB,CAAC,GAAG,CAAC,EACzC,aAAa,EAAE,eAAe,CAAC,GAAG,CAAC,GAClC,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,EAC5G,WAAW,EAAE,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KACnD,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CA0B1C"}
+{"version":3,"file":"defineOp.d.ts","sourceRoot":"","sources":["../../../src/lib/opContext/defineOp.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAW5C;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,UAAU,CAYZ;AAMD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAA4E,CAAC;AA+B5G;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,SAAI,GAAG,UAAU,CA6DnE;AAOD;;;GAGG;AACH,UAAU,qBAAqB,CAAC,GAAG,SAAS,SAAS;IACnD,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,YAAY,EAAE,gBAAgB,CAAC;CACnE;AAED;;;GAGG;AACH,KAAK,eAAe,CAAC,GAAG,SAAS,SAAS,IAAI,CAAC,GAAG,SAAS,UAAU,CAAC,GAAG,CAAC,EACxE,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,EAC3B,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,EACnB,GAAG,EAAE,GAAG,KACL,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAMvB;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,GAAG,SAAS,SAAS,EAClD,aAAa,EAAE,qBAAqB,CAAC,GAAG,CAAC,GACxC,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,EACzB,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,EAC9B,eAAe,CAAC,EAAE,iBAAiB,KAChC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAoDvB;AAyBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,GAAG,SAAS,SAAS,EACnD,aAAa,EAAE,qBAAqB,CAAC,GAAG,CAAC,EACzC,aAAa,EAAE,eAAe,CAAC,GAAG,CAAC,GAClC,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,EAC5G,WAAW,EAAE,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,EACtD,oBAAoB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,iBAAiB,CAAC,CAAC,KAClE,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAgD1C"}

package/dist/lib/opContext/defineOp.js

@@ -8,6 +8,8 @@
  */
 import { intern, PreEncodedEntry } from '@smoothbricks/arrow-builder';
 import { Op as OpClass } from '../op.js';
+import { resolveEagerColumns } from '../physicalLayoutPlan.js';
+import { runtimeHintMessageLayoutFamily, runtimeHintMessagePhysicalLayout } from '../runtimeHint.js';
 import { getSpanBufferClass } from '../spanBuffer.js';
 //#region smoo/lmao!n/metadata-injection
 // 01l "Metadata Injection (Transformer)": package_name/package_file/git_sha/line are the
@@ -42,6 +44,27 @@ export function createOpMetadata(name, package_name, package_file, git_sha, line
  * These are placeholder values that will be replaced at compile time.
  */
 export const DEFAULT_METADATA = createOpMetadata('unknown', 'unknown', 'unknown', 'unknown', 0);
+const DEFAULT_COMPILE_METADATA = Object.freeze({
+    runtimeHint: 0,
+});
+const EMPTY_EAGER_COLUMNS = Object.freeze([]);
+const EMPTY_LOCAL_MESSAGE_DICTIONARY = Object.freeze([]);
+function normalizeCompileMetadata(compileMetadata) {
+    if (compileMetadata === undefined)
+        return DEFAULT_COMPILE_METADATA;
+    const eagerColumns = compileMetadata.eagerColumns;
+    const localMessageDictionary = compileMetadata.localMessageDictionary;
+    return Object.freeze({
+        runtimeHint: compileMetadata.runtimeHint,
+        eagerColumns: eagerColumns === undefined || eagerColumns.length === 0
+            ? EMPTY_EAGER_COLUMNS
+            : Object.freeze([...new Set(eagerColumns)]),
+        localMessageDictionary: localMessageDictionary === undefined || localMessageDictionary.length === 0
+            ? EMPTY_LOCAL_MESSAGE_DICTIONARY
+            : Object.freeze([...localMessageDictionary]),
+        materializeSpanBufferClass: compileMetadata.materializeSpanBufferClass,
+    });
+}
 // =============================================================================
 // STACK TRACE METADATA EXTRACTION
 // =============================================================================
@@ -119,31 +142,39 @@ export function extractMetadataFromStack(skipFrames = 2) {
  * - metadata: includes name + merged with defaults
  * - SpanBufferClass: from getSpanBufferClass(logSchema) - has static schema + stats
  * - fn(ctx, ...args): the user function to execute
- * - remappedViewClass: undefined for original ops (set by .prefix() method)
+ * - remapDescriptor: undefined for original ops (set by .prefix()/.mapColumns())
  *
  * @template Ctx - Bundled OpContext (logSchema, flags, deps, userCtx)
  * @param factoryConfig - Configuration containing logSchema and flags
  * @returns A defineOp function for creating Op instances
  */
 export function createDefineOp(factoryConfig) {
-    // Why get class from schema: Class has static schema + stats shared by all instances
-    const SpanBufferClass = getSpanBufferClass(factoryConfig.logSchema);
-    return function defineOpImpl(name, fn, metadata) {
+    return function defineOpImpl(name, fn, metadata, compileMetadata) {
+        const normalizedCompileMetadata = normalizeCompileMetadata(compileMetadata);
+        normalizedCompileMetadata.materializeSpanBufferClass?.(factoryConfig.logSchema);
+        const eagerColumns = resolveEagerColumns(factoryConfig.logSchema, normalizedCompileMetadata.eagerColumns ?? EMPTY_EAGER_COLUMNS);
+        const messageLayoutFamily = runtimeHintMessageLayoutFamily(normalizedCompileMetadata.runtimeHint);
+        const messagePhysicalLayout = runtimeHintMessagePhysicalLayout(normalizedCompileMetadata.runtimeHint);
+        const SelectedSpanBufferClass = getSpanBufferClass(factoryConfig.logSchema, messageLayoutFamily, messagePhysicalLayout, eagerColumns);
         // When transformer is not installed, extract metadata from stack trace
         // This provides useful file/line info for debugging even without build-time injection
         // skipFrames=3: Error -> extractMetadataFromStack -> defineOpImpl -> caller
         const baseMetadata = metadata?.package_file ? DEFAULT_METADATA : extractMetadataFromStack(3);
         // Use name from: 1) explicit metadata.name (transformer), 2) defineOp('name', fn), 3) baseMetadata
-        const finalMetadata = { ...baseMetadata, ...metadata, name: metadata?.name ?? name };
+        const finalMetadata = {
+            ...baseMetadata,
+            ...metadata,
+            name: metadata?.name ?? name,
+        };
         // Use the Op class which handles all span/buffer management:
         // - Creates SpanBuffer for the op
         // - Registers child buffers with parent
         // - Sets _opMetadata and _callsiteMetadata
         // - Writes span-start/span-ok/span-err entries
         // - Handles exceptions with span-exception
-        // Why SpanBufferClass: All ops from same defineOpContext share this class for stats coordination
-        // Why undefined for remappedViewClass: Only prefixed ops need remapping - set by .prefix() method
-        return new OpClass(finalMetadata, SpanBufferClass, fn, undefined, factoryConfig.opContextBinding);
+        // Why SelectedSpanBufferClass: Ops with the same physical layout share one constructor and stats object.
+        // Base Ops have no remap descriptor; mapped OpGroups bind one during startup cloning.
+        return new OpClass(finalMetadata, SelectedSpanBufferClass, fn, undefined, factoryConfig.opContextBinding, normalizedCompileMetadata.runtimeHint, normalizedCompileMetadata.eagerColumns ?? EMPTY_EAGER_COLUMNS, normalizedCompileMetadata.localMessageDictionary ?? EMPTY_LOCAL_MESSAGE_DICTIONARY);
     };
 }
 // =============================================================================
@@ -183,13 +214,25 @@ function hasAllDefinedOps(definitions, ops) {
 export function createDefineOps(factoryConfig, createOpGroup) {
     // Get the defineOp function for wrapping raw functions
     const defineOp = createDefineOp(factoryConfig);
-    return function defineOpsImpl(definitions) {
+    return function defineOpsImpl(definitions, compileMetadataByKey) {
         // Build the ops record by processing each definition.
         // Keep the runtime container broad, then narrow once we've populated every key.
         const ops = {};
         for (const name in definitions) {
             const def = definitions[name];
-            ops[name] = isOp(def) ? def : defineOp(name, def);
+            const compileMetadata = compileMetadataByKey?.[name];
+            if (isOp(def)) {
+                if (compileMetadata === undefined) {
+                    ops[name] = def;
+                }
+                else {
+                    const normalizedCompileMetadata = normalizeCompileMetadata(compileMetadata);
+                    ops[name] = new OpClass(def.metadata, def.callsitePlan.SpanBufferClass, def.fn, def.callsitePlan.remapDescriptor ?? undefined, def._opContextBinding, normalizedCompileMetadata.runtimeHint, normalizedCompileMetadata.eagerColumns ?? EMPTY_EAGER_COLUMNS, normalizedCompileMetadata.localMessageDictionary ?? EMPTY_LOCAL_MESSAGE_DICTIONARY);
+                }
+            }
+            else {
+                ops[name] = defineOp(name, def, undefined, compileMetadata);
+            }
         }
         if (!hasAllDefinedOps(definitions, ops)) {
             throw new Error('defineOps failed to normalize all op definitions');

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

@@ -124,8 +124,8 @@ export type OpGroup<Ctx extends OpContext, Ops extends object = NoOpMembers> = O
 /**
  * An OpGroup with column mapping applied.
  *
- * The mapping is used during wiring to create RemappedBufferView
- * that translates the library's column writes to the app's column names.
+ * Wiring composes the mapping into immutable metadata interpreted only by cold
+ * Arrow conversion; library child buffers keep their canonical storage layout.
  *
  * Note: Ops are accessed directly as properties (`.opName` not `.ops.opName`)
  * for V8 hidden class optimization and cleaner API ergonomics.

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

@@ -15,7 +15,7 @@
 import type { ExtractError, ExtractSuccess, Result } from '../result.js';
 import type { SpanContext } from './spanContextTypes.js';
 import type { OpContext } from './types.js';
-export { Op, type OpMetadata } from '../op.js';
+export { Op, type OpCompileMetadata, type OpMetadata } from '../op.js';
 /**
  * Op function signature - what the user provides to defineOp.
  * MUST return Result<S, E> or Promise<Result<S, E>>.

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

@@ -1 +1 @@
-{"version":3,"file":"opTypes.d.ts","sourceRoot":"","sources":["../../../src/lib/opContext/opTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAS5C,OAAO,EAAE,EAAE,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAM/C;;;;;;;;GAQG;AACH,MAAM,MAAM,IAAI,CAAC,GAAG,SAAS,SAAS,EAAE,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CACtE,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,EACrB,GAAG,IAAI,EAAE,IAAI,KACV,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAO1C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC;;;GAGG;AACH,KAAK,OAAO,CAAC,GAAG,SAAS,SAAS,EAAE,GAAG,IACrC,GAAG,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAC7C,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,GACnB,GAAG,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,IAAI,KAAK,MAAM,CAAC,GACjE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,GACjD,KAAK,CAAC;AAEd;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,CACvB,GAAG,SAAS,SAAS,EACrB,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,IACxG;KACD,CAAC,IAAI,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;CACzC,CAAC"}
+{"version":3,"file":"opTypes.d.ts","sourceRoot":"","sources":["../../../src/lib/opContext/opTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAS5C,OAAO,EAAE,EAAE,EAAE,KAAK,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAMvE;;;;;;;;GAQG;AACH,MAAM,MAAM,IAAI,CAAC,GAAG,SAAS,SAAS,EAAE,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CACtE,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,EACrB,GAAG,IAAI,EAAE,IAAI,KACV,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAO1C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC;;;GAGG;AACH,KAAK,OAAO,CAAC,GAAG,SAAS,SAAS,EAAE,GAAG,IACrC,GAAG,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAC7C,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,GACnB,GAAG,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,IAAI,KAAK,MAAM,CAAC,GACjE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,GACjD,KAAK,CAAC;AAEd;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,CACvB,GAAG,SAAS,SAAS,EACrB,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,IACxG;KACD,CAAC,IAAI,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;CACzC,CAAC"}

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

@@ -53,24 +53,29 @@ export type TagWriter<T extends LogSchema> = {
 /**
  * SpanLogger - public API surface for structured logging.
  *
- * Includes core methods (info/debug/warn/error) from BaseSpanLogger
- * and schema-specific methods from ColumnWriter.
- * Internal methods (_setScope, _buffer, etc.) are hidden from this type.
+ * Operational info/warn/error calls accept either a static template or the
+ * untransformed fallback form `(template, fields)`. Debug/trace retain the raw
+ * dynamic message API. The transformer lowers supported calls to direct writes;
+ * internal methods and buffers remain hidden from this type.
  *
- * Per specs/lmao/01h_entry_types_and_logging_primitives.md:
- * - Each level (info/debug/warn/error) creates a log entry
- * - Returns FluentLogEntry for chaining field setters
- * - Generated at runtime via createSpanLoggerFromGenerator()
+ * Per specs/lmao/01h_entry_types_and_logging_primitives.md, each call creates
+ * exactly one log entry. The generated runtime implementation binds structured
+ * fallback fields to the schema-specific column writers.
  */
 export interface SpanLogger<T extends LogSchema> {
-    /** Log at info level */
-    info(message: string): FluentLogEntry<T>;
+    /** Log a static info template, optionally with schema-bound fallback fields */
+    info(template: string): FluentLogEntry<T>;
+    info(template: string, fields: Partial<InferSchema<T>>): FluentLogEntry<T>;
     /** Log at debug level */
     debug(message: string): FluentLogEntry<T>;
-    /** Log at warn level */
-    warn(message: string): FluentLogEntry<T>;
-    /** Log at error level */
-    error(message: string): FluentLogEntry<T>;
+    /** Log a static warn template, optionally with schema-bound fallback fields */
+    warn(template: string): FluentLogEntry<T>;
+    warn(template: string, fields: Partial<InferSchema<T>>): FluentLogEntry<T>;
+    /** Log a static error template, optionally with schema-bound fallback fields */
+    error(template: string): FluentLogEntry<T>;
+    error(template: string, fields: Partial<InferSchema<T>>): FluentLogEntry<T>;
+    /** Log at trace level */
+    trace(message: string): FluentLogEntry<T>;
 }
 /**
  * Fluent log entry - chainable attribute setters after log level.
@@ -174,7 +179,7 @@ export type SpanFn<Ctx extends OpContext> = {
  * Use when the callback is guaranteed sync and should return immediately
  * with a Result envelope.
  */
-export type SpanSyncFn<Ctx extends OpContext> = <S, E>(name: string, fn: (ctx: SpanContext<Ctx>) => Result<S, E>) => Result<S, E>;
+export type SpanSyncFn<Ctx extends OpContext> = <S, E>(name: string, op: Op<Ctx, [], S, E>) => Result<S, E>;
 /**
  * SpanContext - what op functions receive.
  *
@@ -308,6 +313,16 @@ export type SpanContext<Ctx extends OpContext> = {
      * It does not await or perform async retry/backoff behavior.
      */
     spanSync: SpanSyncFn<Ctx>;
+    /** @internal Transformer-only fixed-arity sync-fast span ABI. */
+    spanAuto0<S, E>(line: number, name: string, op: Op<Ctx, [], S, E>): Result<S, E> | Promise<Result<S, E>>;
+    spanAuto1<S, E, A1>(line: number, name: string, op: Op<Ctx, [A1], S, E>, a1: A1): Result<S, E> | Promise<Result<S, E>>;
+    spanAuto2<S, E, A1, A2>(line: number, name: string, op: Op<Ctx, [A1, A2], S, E>, a1: A1, a2: A2): Result<S, E> | Promise<Result<S, E>>;
+    spanAuto3<S, E, A1, A2, A3>(line: number, name: string, op: Op<Ctx, [A1, A2, A3], S, E>, a1: A1, a2: A2, a3: A3): Result<S, E> | Promise<Result<S, E>>;
+    spanAuto4<S, E, A1, A2, A3, A4>(line: number, name: string, op: Op<Ctx, [A1, A2, A3, A4], S, E>, a1: A1, a2: A2, a3: A3, a4: A4): Result<S, E> | Promise<Result<S, E>>;
+    spanAuto5<S, E, A1, A2, A3, A4, A5>(line: number, name: string, op: Op<Ctx, [A1, A2, A3, A4, A5], S, E>, a1: A1, a2: A2, a3: A3, a4: A4, a5: A5): Result<S, E> | Promise<Result<S, E>>;
+    spanAuto6<S, E, A1, A2, A3, A4, A5, A6>(line: number, name: string, op: Op<Ctx, [A1, A2, A3, A4, A5, A6], S, E>, a1: A1, a2: A2, a3: A3, a4: A4, a5: A5, a6: A6): Result<S, E> | Promise<Result<S, E>>;
+    spanAuto7<S, E, A1, A2, A3, A4, A5, A6, A7>(line: number, name: string, op: Op<Ctx, [A1, A2, A3, A4, A5, A6, A7], S, E>, a1: A1, a2: A2, a3: A3, a4: A4, a5: A5, a6: A6, a7: A7): Result<S, E> | Promise<Result<S, E>>;
+    spanAuto8<S, E, A1, A2, A3, A4, A5, A6, A7, A8>(line: number, name: string, op: Op<Ctx, [A1, A2, A3, A4, A5, A6, A7, A8], S, E>, a1: A1, a2: A2, a3: A3, a4: A4, a5: A5, a6: A6, a7: A7, a8: A8): Result<S, E> | Promise<Result<S, E>>;
     /**
      * Set scoped attributes that auto-propagate to all subsequent log entries.
      *