@smoothbricks/lmao 0.1.2 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smoothbricks/lmao",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -118,7 +118,7 @@
   "dependencies": {
     "@msgpack/msgpack": "^3.1.3",
     "@neophi/sieve-cache": "^1.5.0",
-    "@smoothbricks/arrow-builder": "0.1.1",
+    "@smoothbricks/arrow-builder": "0.1.2",
     "@smoothbricks/validation": "0.1.1",
     "@uwdata/flechette": "^2.3.0",
     "tslib": "^2.8.1"
@@ -126,7 +126,8 @@
   "scripts": {
     "bench": "bun run benchmarks/*.bench.ts",
     "bench:wasm": "bun run benchmarks/js-vs-wasm.bench.ts",
-    "build:wasm": "zig build -Doptimize=ReleaseSmall"
+    "build:wasm": "zig build -Doptimize=ReleaseSmall",
+    "test": "nx run lmao:test --outputStyle=stream"
   },
   "nx": {
     "sourceRoot": "packages/lmao/src",
@@ -140,10 +141,12 @@
         ]
       },
       "test": {
-        "executor": "nx:run-commands",
+        "executor": "@smoothbricks/nx-plugin:bounded-exec",
         "options": {
-          "command": "bun test",
-          "cwd": "packages/lmao"
+          "command": "bun test --timeout=30000",
+          "cwd": "{projectRoot}",
+          "timeoutMs": 120000,
+          "killAfterMs": 1e4
         }
       }
     },

package/src/es.ts

@@ -8,4 +8,6 @@
 export * from './index.js';
 
 // Export browser-specific TraceRoot factory for Tracer construction
+//#region smoo/lmao!n/trace-root-timestamps.entry-points #es
 export { createTraceRoot } from './lib/traceRoot.es.js';
+//#endregion smoo/lmao!n/trace-root-timestamps.entry-points

package/src/lib/archive/chunkCompaction.ts

@@ -14,6 +14,7 @@ export interface CompactedChunkSet {
   readonly window: CompactionWindow;
 }
 
+//#region smoo/lmao!n/trace-archive-compaction.manifest
 export function compactTraceChunks(chunks: readonly TraceChunkEnvelope[], window: CompactionWindow): CompactedChunkSet {
   const sourceChunkIds = [...new Set(chunks.map((chunk) => chunk.chunk_id))].sort();
   const totalRows = chunks.reduce((sum, chunk) => sum + chunk.row_count, 0);
@@ -29,6 +30,7 @@ export function compactTraceChunks(chunks: readonly TraceChunkEnvelope[], window
     window,
   };
 }
+//#endregion smoo/lmao!n/trace-archive-compaction.manifest
 
 function hashDeterministic(input: string): string {
   let hash = 0xcbf29ce484222325n;

package/src/lib/archive/chunkEnvelope.ts

@@ -1,3 +1,4 @@
+//#region smoo/lmao!n/trace-archive-envelope.build
 export interface TraceChunkEnvelopeInput {
   readonly file_ref: string;
   readonly chunk_ref: string;
@@ -77,3 +78,4 @@ function fnv1a64(input: string): string {
 
   return hash.toString(16).padStart(16, '0');
 }
+//#endregion smoo/lmao!n/trace-archive-envelope.build

package/src/lib/archive/chunkRouting.ts

@@ -7,6 +7,7 @@ export interface PartitionSplit<T> {
   readonly rows: readonly T[];
 }
 
+//#region smoo/lmao!n/trace-archive-partition-inspect.inspect
 export function inspectPartitionCardinality<T>(
   rows: readonly T[],
   partitionOf: (row: T) => string | null | undefined,
@@ -29,7 +30,9 @@ export function inspectPartitionCardinality<T>(
 
   return partitions.size === 1 ? 'single' : 'unknown';
 }
+//#endregion smoo/lmao!n/trace-archive-partition-inspect.inspect
 
+//#region smoo/lmao!n/trace-archive-partition-split.split
 export function splitChunkByPartition<T>(
   rows: readonly T[],
   partitionOf: (row: T) => string | null | undefined,
@@ -68,3 +71,4 @@ export function splitChunkByPartition<T>(
     };
   });
 }
+//#endregion smoo/lmao!n/trace-archive-partition-split.split

package/src/lib/archive/chunkStats.ts

@@ -10,6 +10,7 @@ export interface TraceChunkStats {
   readonly duration_ms: number;
 }
 
+//#region smoo/lmao!n/trace-archive-stats.chunk-level
 export function extractChunkStats<T>(
   envelope: TraceChunkEnvelope,
   partitions: readonly PartitionSplit<T>[] = [],
@@ -23,3 +24,4 @@ export function extractChunkStats<T>(
     duration_ms: Math.max(0, envelope.ended_at_ms - envelope.started_at_ms),
   };
 }
+//#endregion smoo/lmao!n/trace-archive-stats.chunk-level

package/src/lib/arrow/capacityStats.ts

@@ -57,6 +57,7 @@ function append(entries: [string, Column<unknown>][], name: string, column: Colu
   entries.push([name, column]);
 }
 
+//#region smoo/lmao!n/buffer-tuning-stats-logging
 export function createCapacityStatsTable(
   entriesToLog: CapacityStatsEntry[],
   periodStartNs: bigint,
@@ -338,3 +339,4 @@ export function createCapacityStatsTable(
 
   return tableFromColumns(cols);
 }
+//#endregion smoo/lmao!n/buffer-tuning-stats-logging

package/src/lib/bufferStrategy.ts

@@ -1,3 +1,4 @@
+//#region corpos/billing!n/audit-pricing-metering.lmao-buffer-strategy
 /**
  * BufferStrategy - Abstraction for SpanBuffer memory management and Arrow conversion.
  *
@@ -104,3 +105,4 @@ export interface BufferStrategy<T extends LogSchema = LogSchema> {
    */
   releaseBuffer(buffer: AnySpanBuffer): void;
 }
+//#endregion corpos/billing!n/audit-pricing-metering.lmao-buffer-strategy

package/src/lib/capacityTuning.ts

@@ -26,6 +26,7 @@
 
 import type { SpanBufferStats } from './spanBufferStats.js';
 
+//#region smoo/lmao!n/buffer-tuning-capacity
 /** Minimum spans needed before tuning decisions */
 const MIN_SPANS_FOR_TUNING = 10;
 
@@ -100,3 +101,4 @@ export function shouldTuneCapacity(stats: SpanBufferStats): void {
     resetStats(stats);
   }
 }
+//#endregion smoo/lmao!n/buffer-tuning-capacity

package/src/lib/cleanupDiagnostics.ts

@@ -0,0 +1,52 @@
+/// <reference types="bun" />
+
+function isTruthyEnvFlag(value: unknown): boolean {
+  return value === true || value === '1' || value === 'true';
+}
+
+export function isCleanupDebugEnabled(): boolean {
+  const globalDebug = Reflect.get(globalThis, '__LMAO_TEST_CLEANUP_DEBUG__');
+  if (isTruthyEnvFlag(globalDebug)) {
+    return true;
+  }
+
+  return isTruthyEnvFlag(process.env.LMAO_TEST_CLEANUP_DEBUG);
+}
+
+export function cleanupDebug(label: string, details?: Record<string, unknown>): void {
+  if (!isCleanupDebugEnabled()) {
+    return;
+  }
+
+  const suffix = details ? ` ${JSON.stringify(details)}` : '';
+  console.error(`[lmao/cleanup] ${label}${suffix}`);
+}
+
+export function cleanupDebugActiveHandles(label: string): void {
+  if (!isCleanupDebugEnabled()) {
+    return;
+  }
+
+  const getActiveHandles = Reflect.get(process, '_getActiveHandles');
+  if (typeof getActiveHandles !== 'function') {
+    cleanupDebug(label, { activeHandles: 'unavailable' });
+    return;
+  }
+
+  const handles = getActiveHandles.call(process);
+  if (!Array.isArray(handles)) {
+    cleanupDebug(label, { activeHandles: 'unavailable' });
+    return;
+  }
+
+  const names = handles.map((handle) => {
+    if (typeof handle !== 'object' || handle === null) {
+      return typeof handle;
+    }
+    const constructor = Reflect.get(handle, 'constructor');
+    const name = typeof constructor === 'function' ? Reflect.get(constructor, 'name') : undefined;
+    return typeof name === 'string' && name.length > 0 ? name : 'Object';
+  });
+
+  cleanupDebug(label, { activeHandleCount: handles.length, activeHandles: names });
+}

package/src/lib/codegen/evaluatorGenerator.ts

@@ -1,3 +1,4 @@
+//#region corpos/billing!n/audit-flag-evaluator.lmao-evaluator-generator
 /**
  * Worker-safe feature-flag evaluator generation.
  *
@@ -307,3 +308,4 @@ export function createEvaluatorClass<Ctx extends OpContext>(
 
   return generatedEvaluatorClass;
 }
+//#endregion corpos/billing!n/audit-flag-evaluator.lmao-evaluator-generator

package/src/lib/codegen/fixedPositionWriterGenerator.ts

@@ -183,6 +183,7 @@ function generateWithMethod(schemaFields: readonly ColumnEntry[], enumFieldNames
     }`;
 }
 
+//#region smoo/lmao!n/codegen-architecture
 /**
  * Generate the complete fixed-position writer class code.
  *
@@ -442,3 +443,4 @@ export function createResultWriter<T extends LogSchema, R = unknown, E = unknown
   const WriterClass = getResultWriterClass(schema);
   return new WriterClass(buffer, resultOrError, isError);
 }
+//#endregion smoo/lmao!n/codegen-architecture

package/src/lib/codegen/spanLoggerGenerator.ts

@@ -261,6 +261,7 @@ function generateEnumFluentSetters(enumFieldNames: Set<string>): string {
   return setters.join('\n');
 }
 
+//#region smoo/lmao!n/codegen-spanlogger.scope
 /**
  * Generate _setScope() method code - IMMUTABLE scope semantics
  *
@@ -365,7 +366,9 @@ function generatePrefillScopedAttributesMethod(
       ${columnFills.join('\n')}
     }`;
 }
+//#endregion smoo/lmao!n/codegen-spanlogger.scope
 
+//#region smoo/lmao!n/codegen-spanlogger
 /**
  * Build the extension for SpanLogger that extends ColumnWriter
  */
@@ -713,3 +716,4 @@ export function createSpanLogger<T extends LogSchema>(schema: T, buffer: SpanBuf
   const SpanLoggerClass = createSpanLoggerClass(schema);
   return new SpanLoggerClass(buffer);
 }
+//#endregion smoo/lmao!n/codegen-spanlogger

package/src/lib/convertToArrow.ts

@@ -186,6 +186,11 @@ function getAllocatedBinaryColumn(buffer: AnySpanBuffer, columnName: string): un
   return Array.isArray(column) ? column : undefined;
 }
 
+//#region smoo/lmao!n/scope-attributes.arrow-fill
+// Cold-path scope materialization (01i): scope values fill NULL cells (no direct write) at
+// Arrow conversion. These typed readers pull from the buffer's immutable _scopeValues; the
+// per-column fill loops below call them so a row with a direct write keeps its value and scope
+// only fills the gaps.
 function getStringScopeValue(buffer: AnySpanBuffer, fieldName: string): string | undefined {
   const value = buffer._scopeValues?.[fieldName];
   return typeof value === 'string' ? value : undefined;
@@ -200,6 +205,7 @@ function getBooleanScopeValue(buffer: AnySpanBuffer, fieldName: string): boolean
   const value = buffer._scopeValues?.[fieldName];
   return typeof value === 'boolean' ? value : undefined;
 }
+//#endregion smoo/lmao!n/scope-attributes.arrow-fill
 
 function requireUint8Array(value: unknown, message: string): Uint8Array {
   if (!(value instanceof Uint8Array)) {

package/src/lib/defineOpContext.ts

@@ -250,9 +250,15 @@ function buildOpContextFactory<
   };
 }
 
+//#region smoo/lmao!n/opcontext-definition
 /**
  * Define an Op context factory
  *
+ * 01j "Module Definition", renamed: this is the shipped entry point (defineOpContext,
+ * not defineModule().ctx().make()). Returns { defineOp, defineOps }; user context is the
+ * `ctx` config field (runtime defaults, reserved-key-guarded — see the nested
+ * n/schema-env-config region), deps carry their own prefix, and per-Op attribution is OpMetadata.
+ *
  * Creates a factory for defining Ops that share the same schema, deps, and context.
  * This is the main entry point for the Op-centric API.
  *
@@ -334,7 +340,14 @@ export function defineOpContext<
   Deps extends DepsConfig = Record<string, never>,
   UserCtx extends Record<string, unknown> = Record<string, never>,
 >(config: OpContextConfig<T, FF, Deps, UserCtx>) {
-  // Runtime validation: check for reserved property names in user context
+  //#region smoo/lmao!n/schema-env-config
+  // Runtime validation: check for reserved property names in user context.
+  // The `ctx` config object is the env/deployment-config surface from
+  // 01a "Environment Variable Configuration" — a plain user object (env, services,
+  // requestId, ...) spread into SpanContext, guarded only against reserved/internal keys.
+  //#region smoo/lmao!n/schema-env-config.reserved
+  // 01l "Reserved Names": ctx keys cannot collide with built-in SpanContext members
+  // (buffer/tag/log/scope/setScope/ok/err/span/ff/deps) or start with `_` (internal).
   if (config.ctx) {
     const userKeys = Object.keys(config.ctx);
     for (const key of userKeys) {
@@ -350,6 +363,8 @@ export function defineOpContext<
       }
     }
   }
+  //#endregion smoo/lmao!n/schema-env-config.reserved
+  //#endregion smoo/lmao!n/schema-env-config
 
   // Compute effective schema by combining app schema with dep contributions.
   // This merges app fields + all dep contributed fields (after prefix/mapping).
@@ -387,6 +402,7 @@ export function defineOpContext<
 
   return buildOpContextFactory(effectiveFields, config.flags, config.deps, config.ctx);
 }
+//#endregion smoo/lmao!n/opcontext-definition
 
 // Re-export everything from opContext for convenience
 export * from './opContext/index.js';

package/src/lib/errors/Blocked.ts

@@ -53,6 +53,7 @@
 
 import type { TaggedError } from '../result.js';
 
+//#region smoo/lmao!n/op-context-tagged-errors.blocked
 /**
  * Reason why an Op is blocked.
  */
@@ -163,3 +164,4 @@ export class Blocked extends Error implements TaggedError<'Blocked'> {
     };
   }
 }
+//#endregion smoo/lmao!n/op-context-tagged-errors.blocked

package/src/lib/errors/Transient.ts

@@ -1,3 +1,4 @@
+//#region smoo/lmao!n/op-retry.transient
 /**
  * TransientError - typed transient error codes with embedded retry policy.
  *
@@ -166,3 +167,4 @@ function isRetryPolicyLike(value: unknown): value is Partial<RetryPolicy> {
 
 // Re-export policy helpers for convenience
 export { exponentialBackoff, fixedDelay, linearBackoff, mergePolicy, type RetryPolicy } from './retry-policy.js';
+//#endregion smoo/lmao!n/op-retry.transient

package/src/lib/errors/retry-policy.ts

@@ -1,3 +1,4 @@
+//#region smoo/lmao!n/op-retry.policy
 /**
  * RetryPolicy - configures retry behavior for transient failures.
  *
@@ -85,3 +86,4 @@ export function mergePolicy(base: RetryPolicy, override?: Partial<RetryPolicy>):
   if (!override) return base;
   return { ...base, ...override };
 }
+//#endregion smoo/lmao!n/op-retry.policy

package/src/lib/flushScheduler.ts

@@ -9,6 +9,7 @@
 
 import { Column, type Table, tableFromColumns } from '@uwdata/flechette';
 import type { CapacityStatsEntry } from './arrow/capacityStats.js';
+import { cleanupDebug } from './cleanupDiagnostics.js';
 import { convertSpanTreeToArrowTable } from './convertToArrow.js';
 import type { SpanBufferConstructor } from './spanBuffer.js';
 import type { AnySpanBuffer, OpMetadata } from './types.js';
@@ -119,6 +120,7 @@ export interface FlushSchedulerConfig {
  * Background flush scheduler
  * Manages automatic flushing of span buffers to Arrow tables
  */
+//#region smoo/lmao!n/buffer-tuning-flush
 export class FlushScheduler {
   private config: Required<FlushSchedulerConfig>;
   private handler: FlushHandler;
@@ -178,6 +180,7 @@ export class FlushScheduler {
     this.isRunning = true;
     this.lastFlushTime = Date.now();
     this.lastActivityTime = Date.now();
+    cleanupDebug('flushScheduler.start', this.config);
 
     // Set up periodic flush timer
     this.flushTimer = setInterval(() => {
@@ -208,6 +211,7 @@ export class FlushScheduler {
   stop(): void {
     if (!this.isRunning) return;
 
+    cleanupDebug('flushScheduler.stop:start', { pendingBuffers: this.buffers.size });
     this.isRunning = false;
 
     if (this.flushTimer) {
@@ -224,6 +228,7 @@ export class FlushScheduler {
       clearInterval(this.memoryTimer);
       this.memoryTimer = undefined;
     }
+    cleanupDebug('flushScheduler.stop:end', { pendingBuffers: this.buffers.size });
   }
 
   /**
@@ -443,6 +448,12 @@ export class FlushScheduler {
       }
     } catch (error) {
       console.error('Error in flush handler:', error);
+      cleanupDebug('flushScheduler.doFlush:error', {
+        reason,
+        totalRows,
+        totalBuffers,
+        pendingBuffers: this.buffers.size,
+      });
       // Do NOT reset buffers on failure to avoid data loss
     }
   }
@@ -454,6 +465,7 @@ export class FlushScheduler {
     this.lastActivityTime = Date.now();
   }
 }
+//#endregion smoo/lmao!n/buffer-tuning-flush
 
 /**
  * Global flush scheduler instance (optional)

package/src/lib/library.ts

@@ -71,10 +71,16 @@ function isRemappedSpanLoggerClass<T extends LogSchema>(value: unknown): value i
   );
 }
 
+//#region smoo/lmao!n/codegen-prefixed-remap
 /**
  * Prefix a tag attribute schema
  * Renames all fields with a prefix to avoid conflicts
  *
+ * 01j "Library Compilation (Prefixed)": a library defines clean field names
+ * (status, method); the consumer applies a prefix (http) at wire time. This block
+ * generates the prefixed schema, the clean->prefixed mapping, and the RemappedSpanLogger /
+ * RemappedBufferView classes whose clean methods write to prefixed columns.
+ *
  * Example:
  * - Input: { status: S.number(), method: S.enum(['GET', 'POST']) }
  * - Prefix: 'http'
@@ -680,3 +686,4 @@ export function createRemappedSpanLoggerClass<T extends LogSchema>(
 
   return GeneratedClass;
 }
+//#endregion smoo/lmao!n/codegen-prefixed-remap

package/src/lib/op.ts

@@ -31,6 +31,11 @@ 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.
  */
+//#region smoo/lmao!n/opcontext-hierarchy
+// 01j "ModuleContext", renamed: per-Op source-attribution metadata
+// (package_name/package_file/git_sha) + pre-encoded UTF-8 entries for Arrow
+// dictionary building. One per defineOp; SpanBuffer/SpanContext are the other
+// two levels of the 01j Context Hierarchy.
 export interface OpMetadata {
   /** Op name for metrics tracking (distinct from span names which are provided at call sites) */
   readonly name: string;
@@ -50,11 +55,13 @@ export interface OpMetadata {
   /** Pre-encoded git_sha for Arrow dictionary building */
   readonly git_sha_entry: PreEncodedEntry;
 }
+//#endregion smoo/lmao!n/opcontext-hierarchy
 
 // =============================================================================
 // Op Class
 // =============================================================================
 
+//#region smoo/lmao!n/op-class
 /**
  * Op - Traced operation (Phase 2 architecture)
  *
@@ -101,3 +108,4 @@ export class Op<Ctx extends OpContext, Args extends unknown[], S, E> {
     readonly _opContextBinding?: OpContextBinding,
   ) {}
 }
+//#endregion smoo/lmao!n/op-class

package/src/lib/opContext/createOpGroup.ts

@@ -34,6 +34,11 @@ import type {
 import { validateOpName } from './opGroupTypes.js';
 import type { OpContext } from './types.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.
 // =============================================================================
 // INTERNAL HELPERS
 // =============================================================================
@@ -454,3 +459,4 @@ export function createOpGroup<Ctx extends OpContext, Ops extends OpGroupOps<Ctx>
   assertGroupCarriesOps<Ctx, Ops>(group, ops);
   return group;
 }
+//#endregion smoo/lmao!n/column-mapping-api

package/src/lib/opContext/defineOp.ts

@@ -14,6 +14,11 @@ import type { OpGroup, OpGroupOps } from './opGroupTypes.js';
 import type { Op, OpFn, OpMetadata, OpsFromRecord } from './opTypes.js';
 import type { OpContext } from './types.js';
 
+//#region smoo/lmao!n/metadata-injection
+// 01l "Metadata Injection (Transformer)": package_name/package_file/git_sha/line are the
+// per-Op OpMetadata the transformer injects at the defineOpContext call site. createOpMetadata
+// pre-encodes the dictionary entries (interned UTF-8); DEFAULT_METADATA is the un-injected
+// placeholder; extractMetadataFromStack is the no-transformer dev fallback (parses the stack).
 // =============================================================================
 // METADATA HELPERS
 // =============================================================================
@@ -130,6 +135,7 @@ export function extractMetadataFromStack(skipFrames = 2): OpMetadata {
 
   return createOpMetadata('unknown', packageName, filePath, 'runtime', lineNumber);
 }
+//#endregion smoo/lmao!n/metadata-injection
 
 // =============================================================================
 // FACTORY CONFIG

package/src/lib/result.ts

@@ -104,6 +104,7 @@ function createCodeErrorValue<Code extends string, Fields extends object>(
 // OK CLASS
 // =============================================================================
 
+//#region smoo/lmao!n/lmao-entry-fluentok
 /**
  * Success result with fluent tag application.
  *
@@ -240,11 +241,13 @@ export class Ok<V, T extends LogSchema = LogSchema> {
     return { ok: true, value: this.value };
   }
 }
+//#endregion smoo/lmao!n/lmao-entry-fluentok
 
 // =============================================================================
 // ERR CLASS
 // =============================================================================
 
+//#region smoo/lmao!n/lmao-entry-fluenterr
 /**
  * Error result with fluent tag application.
  *
@@ -410,6 +413,7 @@ export class Err<E, T extends LogSchema = LogSchema> {
     return { ok: false, error: this.error };
   }
 }
+//#endregion smoo/lmao!n/lmao-entry-fluenterr
 
 // =============================================================================
 // RESULT TYPE

package/src/lib/schema/builder.ts

@@ -66,6 +66,7 @@ function createSchemaWithFlagBuilder<Value, TSchema extends Schema<Value>>(
   return schemaWithBuilder;
 }
 
+//#region smoo/lmao!n/schema-string-types
 /**
  * Schema builder that wraps arrow-builder's S with feature flag support
  *
@@ -199,3 +200,4 @@ const schemaBuilderImpl: SchemaBuilder = {
 // Export as S for convenience
 // Note: The SchemaBuilder type is exported from types.ts
 export const S = schemaBuilderImpl;
+//#endregion smoo/lmao!n/schema-string-types

package/src/lib/schema/defineFeatureFlags.ts

@@ -1,3 +1,4 @@
+//#region corpos/billing!n/audit-flag-evaluator.lmao-flag-schema
 import type { Output } from '@smoothbricks/arrow-builder';
 import type { FeatureFlagDefinition } from './types.js';
 
@@ -89,3 +90,4 @@ export interface UsageContext {
   value?: number;
   metadata?: Record<string, string | number | boolean>;
 }
+//#endregion corpos/billing!n/audit-flag-evaluator.lmao-flag-schema

package/src/lib/schema/defineLogSchema.ts

@@ -229,6 +229,7 @@ function assertValidatedObject<T extends SchemaFields>(
   }
 }
 
+//#region smoo/lmao!n/schema-log-schema
 export function defineLogSchema<T extends SchemaFields>(
   schema: T,
   options?: DefineLogSchemaOptions,
@@ -289,3 +290,4 @@ export function defineLogSchema<T extends SchemaFields>(
   // Return logSchema (still a LogSchema instance with added methods)
   return result;
 }
+//#endregion smoo/lmao!n/schema-log-schema

package/src/lib/schema/evaluator.ts

@@ -1,3 +1,4 @@
+//#region corpos/billing!n/audit-flag-evaluator.lmao-evaluator
 import type { Schema, SchemaWithMetadata } from '@smoothbricks/arrow-builder';
 import { createEvaluatorClass, type GeneratedEvaluatorInstance } from '../codegen/evaluatorGenerator.js';
 import type { FluentLogEntry } from '../codegen/spanLoggerGenerator.js';
@@ -402,3 +403,4 @@ export class InMemoryFlagEvaluator<Ctx extends OpContext = OpContext> implements
     return createFeatureFlagEvaluator(this.ffSchema, ctx, this);
   }
 }
+//#endregion corpos/billing!n/audit-flag-evaluator.lmao-evaluator

package/src/lib/schema/systemSchema.ts

@@ -203,6 +203,7 @@ export function mergeWithSystemSchema<T extends Record<string, unknown>>(userSch
   return merged;
 }
 
+//#region smoo/lmao!n/lmao-entry-entry-type-definitions
 // =============================================================================
 // Entry Type Constants
 // =============================================================================
@@ -337,3 +338,4 @@ export const ENTRY_TYPE_NAMES = [
   'buffer-spans', // 23
   'buffer-capacity', // 24
 ] as const;
+//#endregion smoo/lmao!n/lmao-entry-entry-type-definitions