@tracecode/harness 0.6.5 → 0.7.0-beta7

package/dist/runtime-types-2qM0MukN.d.cts

@@ -0,0 +1,244 @@
+declare const RUNTIME_TRACE_SCHEMA_VERSION = "runtime-trace-2026-04-28";
+type RuntimeTraceEventKind = 'line' | 'call' | 'return' | 'read' | 'write' | 'mutate' | 'snapshot' | 'stdout' | 'exception' | 'timeout';
+type RuntimeTraceTarget = {
+    variable: string;
+    scope?: 'local' | 'global' | 'builtin' | 'receiver';
+} | {
+    variable: string;
+    path: Array<string | number>;
+    indexSources?: Array<string | null>;
+    scope?: 'local' | 'global' | 'builtin' | 'receiver';
+} | {
+    objectId: string;
+    path?: Array<string | number>;
+    indexSources?: Array<string | null>;
+};
+interface RuntimeTraceCallFrame {
+    function: string;
+    line?: number;
+    args?: Record<string, unknown> | unknown[];
+}
+interface RuntimeTraceBaseEvent {
+    kind: RuntimeTraceEventKind;
+    runId: string;
+    file?: string;
+    line?: number;
+    column?: number;
+    frameId?: string;
+    callStack?: RuntimeTraceCallFrame[];
+}
+type RuntimeTraceEvent = (RuntimeTraceBaseEvent & {
+    kind: 'line';
+    line: number;
+    function?: string;
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'call';
+    line: number;
+    function: string;
+    args?: Record<string, unknown> | unknown[];
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'return';
+    line: number;
+    function?: string;
+    value?: unknown;
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'read' | 'write';
+    line: number;
+    target: RuntimeTraceTarget;
+    value?: unknown;
+    binding?: RuntimeTraceIterationBinding;
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'mutate';
+    line: number;
+    target: RuntimeTraceTarget;
+    method?: string;
+    args?: unknown[];
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'snapshot';
+    line: number;
+    target: RuntimeTraceTarget;
+    value: unknown;
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'stdout';
+    text: string;
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'exception';
+    message: string;
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'timeout';
+    message: string;
+    reason?: 'trace-limit' | 'line-limit' | 'single-line-limit' | 'client-timeout';
+});
+interface RuntimeTrace {
+    schemaVersion: typeof RUNTIME_TRACE_SCHEMA_VERSION;
+    language: Language;
+    runId: string;
+    events: RuntimeTraceEvent[];
+    lineEventCount: number;
+    traceStepCount: number;
+}
+interface RuntimeTraceIterationBinding {
+    kind?: 'iteration';
+    variable: string;
+}
+interface RuntimeTraceOptions {
+    runId?: string;
+    file?: string;
+}
+declare function createEmptyRuntimeTrace(language: Language, options?: RuntimeTraceOptions): RuntimeTrace;
+interface RuntimeTraceParityAccessTarget {
+    kind: 'read' | 'write' | 'mutate';
+    variable?: string;
+    pathDepth?: number;
+}
+interface RuntimeTraceParitySignature {
+    lineSequence: number[];
+    eventKindsByLine: Record<number, RuntimeTraceEventKind[]>;
+    variableSnapshotsByLine: Record<number, string[]>;
+    accessTargetsByLine: Record<number, RuntimeTraceParityAccessTarget[]>;
+    callReturnShape: Array<'call' | 'return'>;
+}
+declare function withRuntimeTraceOptions(trace: RuntimeTrace, options?: RuntimeTraceOptions): RuntimeTrace;
+declare function buildRuntimeTraceParitySignature(trace: RuntimeTrace): RuntimeTraceParitySignature;
+
+/**
+ * Execution types for browser runtime contracts.
+ */
+type ExecutionStatus = 'idle' | 'loading' | 'ready' | 'running' | 'stepping' | 'paused' | 'completed' | 'error';
+interface TestResult {
+    id: string;
+    passed: boolean;
+    input: Record<string, unknown>;
+    expected: unknown;
+    actual: unknown;
+    error?: string;
+    warning?: string;
+    executionTimeMs?: number;
+}
+interface RuntimeExecutionTimings {
+    totalMs?: number;
+    initMs?: number;
+    warmupMs?: number;
+    toolchainLoadMs?: number;
+    rewriteMs?: number;
+    driverBuildMs?: number;
+    compileMs?: number;
+    linkMs?: number;
+    wasmCompileMs?: number;
+    classLoadMs?: number;
+    runMs?: number;
+    hostCallMs?: number;
+    compileCacheHit?: boolean;
+}
+interface CodeExecutionResult {
+    success: boolean;
+    output: unknown;
+    error?: string;
+    errorLine?: number;
+    consoleOutput?: string[];
+    timeoutReason?: 'trace-limit' | 'line-limit' | 'single-line-limit' | 'recursion-limit' | 'memory-limit' | 'client-timeout';
+    diagnosticStage?: 'compile' | 'runtime' | 'trace' | 'interview' | 'driver-compile' | 'trace-driver-compile' | 'driver-link';
+    timings?: RuntimeExecutionTimings;
+}
+interface ExecutionResult {
+    success: boolean;
+    output?: unknown;
+    error?: string;
+    errorLine?: number;
+    trace: RuntimeTrace;
+    executionTimeMs: number;
+    consoleOutput: string[];
+    traceLimitExceeded?: boolean;
+    maxTraceSteps?: number;
+    timeoutReason?: 'trace-limit' | 'line-limit' | 'single-line-limit' | 'recursion-limit' | 'memory-limit' | 'client-timeout';
+    lineEventCount?: number;
+    traceStepCount?: number;
+    timings?: RuntimeExecutionTimings;
+}
+interface PyodideState {
+    status: 'loading' | 'ready' | 'error';
+    error?: Error;
+    loadTimeMs?: number;
+}
+
+type Language = 'python' | 'javascript' | 'typescript' | 'java' | 'csharp' | 'cpp';
+type RuntimeExecutionStyle = 'function' | 'solution-method' | 'ops-class';
+type RuntimeMaturity = 'experimental' | 'beta' | 'stable';
+interface RuntimeCapabilities {
+    execution: {
+        styles: {
+            function: boolean;
+            solutionMethod: boolean;
+            opsClass: boolean;
+            script: boolean;
+            interviewMode: boolean;
+        };
+        timeouts: {
+            clientTimeouts: boolean;
+            runtimeTimeouts: boolean;
+        };
+    };
+    tracing: {
+        supported: boolean;
+        events: {
+            line: boolean;
+            call: boolean;
+            return: boolean;
+            exception: boolean;
+            stdout: boolean;
+            timeout: boolean;
+        };
+        controls: {
+            maxTraceSteps: boolean;
+            maxLineEvents: boolean;
+            maxSingleLineHits: boolean;
+            maxStoredEvents: boolean;
+            minimalTrace: boolean;
+        };
+        fidelity: {
+            preciseLineMapping: boolean;
+            stableFunctionNames: boolean;
+            callStack: boolean;
+        };
+    };
+    diagnostics: {
+        compileErrors: boolean;
+        runtimeErrors: boolean;
+        mappedErrorLines: boolean;
+        stackTraces: boolean;
+    };
+    structures: {
+        treeNodeRefs: boolean;
+        listNodeRefs: boolean;
+        mapSerialization: boolean;
+        setSerialization: boolean;
+        graphSerialization: boolean;
+        cycleReferences: boolean;
+    };
+}
+interface TraceBudget {
+    maxTraceSteps?: number;
+    maxLineEvents?: number;
+    maxSingleLineHits?: number;
+    maxStoredEvents?: number;
+}
+interface TraceExecutionOptions extends TraceBudget {
+    minimalTrace?: boolean;
+}
+interface LanguageRuntimeProfile {
+    language: Language;
+    maturity: RuntimeMaturity;
+    capabilities: RuntimeCapabilities;
+    notes?: string[];
+}
+interface RuntimeClient {
+    init(): Promise<{
+        success: boolean;
+        loadTimeMs: number;
+    }>;
+    executeWithTracing(code: string, functionName: string | null, inputs: Record<string, unknown>, options?: TraceExecutionOptions, executionStyle?: RuntimeExecutionStyle): Promise<ExecutionResult>;
+    executeCode(code: string, functionName: string, inputs: Record<string, unknown>, executionStyle?: RuntimeExecutionStyle): Promise<CodeExecutionResult>;
+    executeCodeInterviewMode(code: string, functionName: string, inputs: Record<string, unknown>, executionStyle?: RuntimeExecutionStyle): Promise<CodeExecutionResult>;
+}
+
+export { type CodeExecutionResult as C, type ExecutionResult as E, type Language as L, type PyodideState as P, RUNTIME_TRACE_SCHEMA_VERSION as R, type TestResult as T, type ExecutionStatus as a, type LanguageRuntimeProfile as b, type RuntimeCapabilities as c, type RuntimeClient as d, type RuntimeExecutionStyle as e, type RuntimeExecutionTimings as f, type RuntimeMaturity as g, type RuntimeTrace as h, type RuntimeTraceCallFrame as i, type RuntimeTraceEvent as j, type RuntimeTraceEventKind as k, type RuntimeTraceIterationBinding as l, type RuntimeTraceOptions as m, type RuntimeTraceParityAccessTarget as n, type RuntimeTraceParitySignature as o, type RuntimeTraceTarget as p, type TraceBudget as q, type TraceExecutionOptions as r, buildRuntimeTraceParitySignature as s, createEmptyRuntimeTrace as t, withRuntimeTraceOptions as w };

package/dist/runtime-types-2qM0MukN.d.ts

@@ -0,0 +1,244 @@
+declare const RUNTIME_TRACE_SCHEMA_VERSION = "runtime-trace-2026-04-28";
+type RuntimeTraceEventKind = 'line' | 'call' | 'return' | 'read' | 'write' | 'mutate' | 'snapshot' | 'stdout' | 'exception' | 'timeout';
+type RuntimeTraceTarget = {
+    variable: string;
+    scope?: 'local' | 'global' | 'builtin' | 'receiver';
+} | {
+    variable: string;
+    path: Array<string | number>;
+    indexSources?: Array<string | null>;
+    scope?: 'local' | 'global' | 'builtin' | 'receiver';
+} | {
+    objectId: string;
+    path?: Array<string | number>;
+    indexSources?: Array<string | null>;
+};
+interface RuntimeTraceCallFrame {
+    function: string;
+    line?: number;
+    args?: Record<string, unknown> | unknown[];
+}
+interface RuntimeTraceBaseEvent {
+    kind: RuntimeTraceEventKind;
+    runId: string;
+    file?: string;
+    line?: number;
+    column?: number;
+    frameId?: string;
+    callStack?: RuntimeTraceCallFrame[];
+}
+type RuntimeTraceEvent = (RuntimeTraceBaseEvent & {
+    kind: 'line';
+    line: number;
+    function?: string;
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'call';
+    line: number;
+    function: string;
+    args?: Record<string, unknown> | unknown[];
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'return';
+    line: number;
+    function?: string;
+    value?: unknown;
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'read' | 'write';
+    line: number;
+    target: RuntimeTraceTarget;
+    value?: unknown;
+    binding?: RuntimeTraceIterationBinding;
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'mutate';
+    line: number;
+    target: RuntimeTraceTarget;
+    method?: string;
+    args?: unknown[];
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'snapshot';
+    line: number;
+    target: RuntimeTraceTarget;
+    value: unknown;
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'stdout';
+    text: string;
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'exception';
+    message: string;
+}) | (RuntimeTraceBaseEvent & {
+    kind: 'timeout';
+    message: string;
+    reason?: 'trace-limit' | 'line-limit' | 'single-line-limit' | 'client-timeout';
+});
+interface RuntimeTrace {
+    schemaVersion: typeof RUNTIME_TRACE_SCHEMA_VERSION;
+    language: Language;
+    runId: string;
+    events: RuntimeTraceEvent[];
+    lineEventCount: number;
+    traceStepCount: number;
+}
+interface RuntimeTraceIterationBinding {
+    kind?: 'iteration';
+    variable: string;
+}
+interface RuntimeTraceOptions {
+    runId?: string;
+    file?: string;
+}
+declare function createEmptyRuntimeTrace(language: Language, options?: RuntimeTraceOptions): RuntimeTrace;
+interface RuntimeTraceParityAccessTarget {
+    kind: 'read' | 'write' | 'mutate';
+    variable?: string;
+    pathDepth?: number;
+}
+interface RuntimeTraceParitySignature {
+    lineSequence: number[];
+    eventKindsByLine: Record<number, RuntimeTraceEventKind[]>;
+    variableSnapshotsByLine: Record<number, string[]>;
+    accessTargetsByLine: Record<number, RuntimeTraceParityAccessTarget[]>;
+    callReturnShape: Array<'call' | 'return'>;
+}
+declare function withRuntimeTraceOptions(trace: RuntimeTrace, options?: RuntimeTraceOptions): RuntimeTrace;
+declare function buildRuntimeTraceParitySignature(trace: RuntimeTrace): RuntimeTraceParitySignature;
+
+/**
+ * Execution types for browser runtime contracts.
+ */
+type ExecutionStatus = 'idle' | 'loading' | 'ready' | 'running' | 'stepping' | 'paused' | 'completed' | 'error';
+interface TestResult {
+    id: string;
+    passed: boolean;
+    input: Record<string, unknown>;
+    expected: unknown;
+    actual: unknown;
+    error?: string;
+    warning?: string;
+    executionTimeMs?: number;
+}
+interface RuntimeExecutionTimings {
+    totalMs?: number;
+    initMs?: number;
+    warmupMs?: number;
+    toolchainLoadMs?: number;
+    rewriteMs?: number;
+    driverBuildMs?: number;
+    compileMs?: number;
+    linkMs?: number;
+    wasmCompileMs?: number;
+    classLoadMs?: number;
+    runMs?: number;
+    hostCallMs?: number;
+    compileCacheHit?: boolean;
+}
+interface CodeExecutionResult {
+    success: boolean;
+    output: unknown;
+    error?: string;
+    errorLine?: number;
+    consoleOutput?: string[];
+    timeoutReason?: 'trace-limit' | 'line-limit' | 'single-line-limit' | 'recursion-limit' | 'memory-limit' | 'client-timeout';
+    diagnosticStage?: 'compile' | 'runtime' | 'trace' | 'interview' | 'driver-compile' | 'trace-driver-compile' | 'driver-link';
+    timings?: RuntimeExecutionTimings;
+}
+interface ExecutionResult {
+    success: boolean;
+    output?: unknown;
+    error?: string;
+    errorLine?: number;
+    trace: RuntimeTrace;
+    executionTimeMs: number;
+    consoleOutput: string[];
+    traceLimitExceeded?: boolean;
+    maxTraceSteps?: number;
+    timeoutReason?: 'trace-limit' | 'line-limit' | 'single-line-limit' | 'recursion-limit' | 'memory-limit' | 'client-timeout';
+    lineEventCount?: number;
+    traceStepCount?: number;
+    timings?: RuntimeExecutionTimings;
+}
+interface PyodideState {
+    status: 'loading' | 'ready' | 'error';
+    error?: Error;
+    loadTimeMs?: number;
+}
+
+type Language = 'python' | 'javascript' | 'typescript' | 'java' | 'csharp' | 'cpp';
+type RuntimeExecutionStyle = 'function' | 'solution-method' | 'ops-class';
+type RuntimeMaturity = 'experimental' | 'beta' | 'stable';
+interface RuntimeCapabilities {
+    execution: {
+        styles: {
+            function: boolean;
+            solutionMethod: boolean;
+            opsClass: boolean;
+            script: boolean;
+            interviewMode: boolean;
+        };
+        timeouts: {
+            clientTimeouts: boolean;
+            runtimeTimeouts: boolean;
+        };
+    };
+    tracing: {
+        supported: boolean;
+        events: {
+            line: boolean;
+            call: boolean;
+            return: boolean;
+            exception: boolean;
+            stdout: boolean;
+            timeout: boolean;
+        };
+        controls: {
+            maxTraceSteps: boolean;
+            maxLineEvents: boolean;
+            maxSingleLineHits: boolean;
+            maxStoredEvents: boolean;
+            minimalTrace: boolean;
+        };
+        fidelity: {
+            preciseLineMapping: boolean;
+            stableFunctionNames: boolean;
+            callStack: boolean;
+        };
+    };
+    diagnostics: {
+        compileErrors: boolean;
+        runtimeErrors: boolean;
+        mappedErrorLines: boolean;
+        stackTraces: boolean;
+    };
+    structures: {
+        treeNodeRefs: boolean;
+        listNodeRefs: boolean;
+        mapSerialization: boolean;
+        setSerialization: boolean;
+        graphSerialization: boolean;
+        cycleReferences: boolean;
+    };
+}
+interface TraceBudget {
+    maxTraceSteps?: number;
+    maxLineEvents?: number;
+    maxSingleLineHits?: number;
+    maxStoredEvents?: number;
+}
+interface TraceExecutionOptions extends TraceBudget {
+    minimalTrace?: boolean;
+}
+interface LanguageRuntimeProfile {
+    language: Language;
+    maturity: RuntimeMaturity;
+    capabilities: RuntimeCapabilities;
+    notes?: string[];
+}
+interface RuntimeClient {
+    init(): Promise<{
+        success: boolean;
+        loadTimeMs: number;
+    }>;
+    executeWithTracing(code: string, functionName: string | null, inputs: Record<string, unknown>, options?: TraceExecutionOptions, executionStyle?: RuntimeExecutionStyle): Promise<ExecutionResult>;
+    executeCode(code: string, functionName: string, inputs: Record<string, unknown>, executionStyle?: RuntimeExecutionStyle): Promise<CodeExecutionResult>;
+    executeCodeInterviewMode(code: string, functionName: string, inputs: Record<string, unknown>, executionStyle?: RuntimeExecutionStyle): Promise<CodeExecutionResult>;
+}
+
+export { type CodeExecutionResult as C, type ExecutionResult as E, type Language as L, type PyodideState as P, RUNTIME_TRACE_SCHEMA_VERSION as R, type TestResult as T, type ExecutionStatus as a, type LanguageRuntimeProfile as b, type RuntimeCapabilities as c, type RuntimeClient as d, type RuntimeExecutionStyle as e, type RuntimeExecutionTimings as f, type RuntimeMaturity as g, type RuntimeTrace as h, type RuntimeTraceCallFrame as i, type RuntimeTraceEvent as j, type RuntimeTraceEventKind as k, type RuntimeTraceIterationBinding as l, type RuntimeTraceOptions as m, type RuntimeTraceParityAccessTarget as n, type RuntimeTraceParitySignature as o, type RuntimeTraceTarget as p, type TraceBudget as q, type TraceExecutionOptions as r, buildRuntimeTraceParitySignature as s, createEmptyRuntimeTrace as t, withRuntimeTraceOptions as w };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tracecode/harness",
-  "version": "0.6.5",
+  "version": "0.7.0-beta7",
   "license": "AGPL-3.0-only",
   "homepage": "https://tracecode.app",
   "repository": {
@@ -17,7 +17,8 @@
     "workers",
     "README.md",
     "CHANGELOG.md",
-    "LICENSE"
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "bin": {
     "tracecode-harness": "./dist/cli.cjs"
@@ -59,17 +60,39 @@
       "require": "./dist/javascript.cjs",
       "default": "./dist/javascript.js"
     },
+    "./java": {
+      "types": "./dist/java.d.ts",
+      "import": "./dist/java.js",
+      "require": "./dist/java.cjs",
+      "default": "./dist/java.js"
+    },
+    "./csharp": {
+      "types": "./dist/csharp.d.ts",
+      "import": "./dist/csharp.js",
+      "require": "./dist/csharp.cjs",
+      "default": "./dist/csharp.js"
+    },
+    "./cpp": {
+      "types": "./dist/cpp.d.ts",
+      "import": "./dist/cpp.js",
+      "require": "./dist/cpp.cjs",
+      "default": "./dist/cpp.js"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {
-    "build": "pnpm generate:python-harness && pnpm exec tsup",
+    "build": "pnpm generate:runtime-info && pnpm generate:python-harness && pnpm sync:package-assets && pnpm exec tsup",
+    "generate:runtime-info": "pnpm exec tsx scripts/generate-runtime-language-info.ts",
     "generate:python-harness": "pnpm exec tsx scripts/generate-python-harness-artifacts.ts",
+    "sync:package-assets": "pnpm exec tsx scripts/sync-language-package-assets.ts",
+    "update:csharp-runtime": "bash scripts/update-csharp-wasm-runtime.sh",
     "typecheck": "pnpm typecheck:packages",
-    "typecheck:packages": "pnpm exec tsc -p packages/harness-core/tsconfig.json --noEmit && pnpm exec tsc -p packages/harness-browser/tsconfig.json --noEmit && pnpm exec tsc -p packages/harness-python/tsconfig.json --noEmit && pnpm exec tsc -p packages/harness-javascript/tsconfig.json --noEmit",
+    "typecheck:packages": "pnpm exec tsc -p packages/harness-core/tsconfig.json --noEmit && pnpm exec tsc -p packages/harness-browser/tsconfig.json --noEmit && pnpm exec tsc -p packages/harness-python/tsconfig.json --noEmit && pnpm exec tsc -p packages/harness-javascript/tsconfig.json --noEmit && pnpm exec tsc -p packages/harness-java/tsconfig.json --noEmit && pnpm exec tsc -p packages/harness-csharp/tsconfig.json --noEmit && pnpm exec tsc -p packages/harness-cpp/tsconfig.json --noEmit",
     "test:smoke": "pnpm exec tsx tests/test-harness-workspace-smoke.ts",
     "test:packaged-surface": "pnpm exec tsx tests/test-packaged-surface.ts",
     "test:browser-harness": "pnpm exec tsx tests/test-browser-harness.ts",
     "test:asset-sync": "pnpm exec tsx tests/test-asset-sync.ts",
+    "test:language-packages": "pnpm exec tsx tests/test-language-package-surface.ts",
     "test:example-app": "pnpm exec tsx tests/test-example-app.ts",
     "test:java-example-app": "pnpm exec tsx tests/test-java-example-app.ts",
     "test:example-app-packaged": "pnpm exec tsx tests/test-example-app-packaged.ts",
@@ -80,19 +103,47 @@
     "test:java-sync": "pnpm exec tsx tests/test-java-harness-sync.ts",
     "test:python-runtime": "pnpm exec tsx tests/test-python-runtime.ts",
     "test:java-runtime": "pnpm exec tsx tests/test-java-runtime.ts",
+    "test:csharp-runtime": "pnpm exec tsx tests/test-csharp-runtime.ts",
+    "test:csharp-worker-browser": "pnpm exec tsx tests/test-csharp-worker-browser.ts",
+    "test:cpp-runtime": "pnpm exec tsx tests/test-cpp-runtime.ts",
+    "test:cpp-script-lambda-trace": "pnpm exec tsx tests/test-cpp-script-lambda-trace.ts",
+    "test:cpp-rewriter": "pnpm exec tsx tests/test-cpp-rewriter.ts",
+    "test:cpp-browser-worker": "pnpm exec tsx tests/test-cpp-browser-worker.ts",
     "test:js-runtime": "pnpm exec tsx tests/test-javascript-runtime.ts",
-    "test:visualizer-conformance": "pnpm exec tsx tests/test-visualizer-language-conformance.ts",
     "test:python-harness-sync": "pnpm run test:python-sync",
     "test:java-harness-sync": "pnpm run test:java-sync",
     "test:javascript-runtime": "pnpm run test:js-runtime",
     "test:runtime-contract": "pnpm exec tsx tests/test-runtime-contract.ts",
-    "test:ci": "pnpm typecheck && pnpm test:trace-adapters && pnpm test:python-sync && pnpm test:python-runtime && pnpm test:java-sync && pnpm test:java-runtime && pnpm test:js-runtime && pnpm test:runtime-contract && pnpm test:visualizer-conformance && pnpm test:standalone-boundary && pnpm build && pnpm test:packaged-surface && pnpm test:smoke && pnpm test:asset-sync",
-    "test": "pnpm typecheck && pnpm test:trace-adapters && pnpm test:python-sync && pnpm test:python-runtime && pnpm test:java-sync && pnpm test:java-runtime && pnpm test:js-runtime && pnpm test:runtime-contract && pnpm test:visualizer-conformance && pnpm test:standalone-boundary && pnpm build && pnpm test:packaged-surface && pnpm test:smoke && pnpm test:browser-harness && pnpm test:asset-sync && pnpm test:example-app && pnpm test:java-example-app && pnpm test:example-app-packaged && pnpm test:java-example-app-packaged"
+    "test:runtime-info-sync": "pnpm exec tsx scripts/generate-runtime-language-info.ts --check",
+    "test:runtime-trace-parity": "pnpm exec tsx tests/test-runtime-trace-parity.ts",
+    "test:runtime-trace-fixtures": "pnpm exec tsx tests/test-runtime-trace-fixtures.ts",
+    "report:runtime-trace-known-gaps": "pnpm exec tsx tests/report-runtime-trace-known-gaps.ts",
+    "local:test:runtime-trace-final300-compile": "pnpm exec tsx tests/mine-runtime-trace-corpus.ts --limit=300 --fail-on-failure --report=reports/runtime-v4-final300-compile-gate.json",
+    "local:build:runtime-trace-tc83": "pnpm exec tsx tests/build-runtime-trace-tc83-corpus.ts",
+    "local:test:runtime-trace-tc83-smoke": "pnpm local:build:runtime-trace-tc83 && pnpm exec tsx tests/mine-runtime-trace-corpus.ts --corpus=reports/runtime-trace-tc83-corpus.json --source-root=/Users/obinnanwachukwu/Code/algoflow --limit=83 --jobs=8 --worker-timeout-ms=180000 --max-trace-steps=10000 --loose-any-valid-output --fail-on-failure --report=reports/runtime-trace-tc83-smoke.json",
+    "local:mine:runtime-trace-tc83-parity": "pnpm local:build:runtime-trace-tc83 && pnpm exec tsx tests/mine-runtime-trace-corpus.ts --corpus=reports/runtime-trace-tc83-corpus.json --source-root=/Users/obinnanwachukwu/Code/algoflow --limit=83 --jobs=8 --worker-timeout-ms=180000 --max-trace-steps=10000 --loose-any-valid-output --reference-language=javascript --comparison-languages=typescript,java --compare-runtime-facts --include-signature-diffs --report=reports/runtime-trace-tc83-parity.json",
+    "local:test:cpp-algoflow-smoke": "pnpm exec tsx tests/mine-cpp-algoflow-corpus.ts --sample=two-sum,map-sum-pairs,range-frequency-queries,binary-tree-tilt --loose-any-valid-output --fail-on-failure --report=reports/cpp-algoflow-smoke.json",
+    "local:mine:cpp-algoflow-corpus": "pnpm exec tsx tests/mine-cpp-algoflow-corpus.ts --limit=50 --max-stored-events=10000 --loose-any-valid-output --report=reports/cpp-algoflow-corpus.json",
+    "local:mine:cpp-algoflow-corpus:isolated": "pnpm exec tsx tests/mine-cpp-algoflow-corpus.ts --limit=0 --no-trace --jobs=4 --batch-size=16 --worker-timeout-ms=600000 --max-stored-events=10000 --loose-any-valid-output --compare-languages=javascript,typescript,python,java --report=reports/cpp-algoflow-corpus-isolated.json",
+    "test:ci": "pnpm test:runtime-info-sync && pnpm typecheck && pnpm test:trace-adapters && pnpm test:python-sync && pnpm test:python-runtime && pnpm test:java-sync && pnpm test:java-runtime && pnpm test:csharp-runtime && pnpm test:csharp-worker-browser && pnpm test:cpp-rewriter && pnpm test:cpp-script-lambda-trace && pnpm test:cpp-runtime && pnpm test:js-runtime && pnpm test:runtime-contract && pnpm test:runtime-trace && pnpm test:standalone-boundary && pnpm build && pnpm test:packaged-surface && pnpm test:language-packages && pnpm test:smoke && pnpm test:asset-sync",
+    "test": "pnpm test:runtime-info-sync && pnpm typecheck && pnpm test:trace-adapters && pnpm test:python-sync && pnpm test:python-runtime && pnpm test:java-sync && pnpm test:java-runtime && pnpm test:csharp-runtime && pnpm test:csharp-worker-browser && pnpm test:cpp-rewriter && pnpm test:cpp-script-lambda-trace && pnpm test:cpp-runtime && pnpm test:js-runtime && pnpm test:runtime-contract && pnpm test:runtime-trace && pnpm test:standalone-boundary && pnpm build && pnpm test:packaged-surface && pnpm test:language-packages && pnpm test:smoke && pnpm test:browser-harness && pnpm test:asset-sync && pnpm test:example-app && pnpm test:java-example-app && pnpm test:example-app-packaged && pnpm test:java-example-app-packaged",
+    "mine:runtime-trace-final300": "pnpm exec tsx tests/mine-runtime-trace-corpus.ts",
+    "mine:runtime-trace-final300:parallel": "pnpm exec tsx tests/mine-runtime-trace-corpus.ts --jobs=8",
+    "test:runtime-raw-emission-contract": "pnpm exec tsx tests/test-runtime-raw-emission-contract.ts",
+    "test:runtime-trace-fixtures:raw-strict": "TRACECODE_STRICT_RAW_EMISSION_PARITY=1 pnpm exec tsx tests/test-runtime-trace-fixtures.ts",
+    "test:runtime-trace": "pnpm test:runtime-trace-fixtures && pnpm test:runtime-trace-fixtures:raw-strict && pnpm test:runtime-raw-emission-contract && pnpm report:runtime-trace-known-gaps",
+    "mine:runtime-trace-corpus": "pnpm exec tsx tests/mine-runtime-trace-corpus.ts",
+    "mine:runtime-trace-corpus:parallel": "pnpm exec tsx tests/mine-runtime-trace-corpus.ts --jobs=8",
+    "bench:browser-runtimes": "pnpm exec tsx scripts/benchmark-browser-runtimes.ts",
+    "spike:csharp:publish": "dotnet publish spikes/csharp-wasm-roslyn/TraceCode.CSharpHost/TraceCode.CSharpHost.csproj -c Release",
+    "spike:csharp:smoke": "pnpm exec tsx spikes/csharp-wasm-roslyn/node-smoke/run-csharp-host.ts",
+    "spike:csharp:browser": "pnpm exec tsx spikes/csharp-wasm-roslyn/browser-worker/browser-worker-smoke.ts",
+    "spike:csharp": "pnpm run spike:csharp:publish && pnpm run spike:csharp:smoke && pnpm run spike:csharp:browser"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
-    "pyodide": "^0.29.0",
     "playwright": "^1.53.2",
+    "pyodide": "^0.29.0",
     "tsup": "^8.5.0",
     "tsx": "^4.21.0",
     "typescript": "^5.0.0"
@@ -102,5 +153,19 @@
       "dompurify": "3.4.1",
       "picomatch": "4.0.4"
     }
+  },
+  "dependencies": {
+    "@datastructures-js/binary-search-tree": "5.4.0",
+    "@datastructures-js/deque": "1.0.8",
+    "@datastructures-js/graph": "5.3.1",
+    "@datastructures-js/heap": "4.3.7",
+    "@datastructures-js/linked-list": "6.1.4",
+    "@datastructures-js/priority-queue": "6.3.5",
+    "@datastructures-js/queue": "4.3.0",
+    "@datastructures-js/set": "4.2.2",
+    "@datastructures-js/stack": "3.1.6",
+    "@datastructures-js/trie": "4.2.3",
+    "@yowasp/clang": "22.0.0-git20542-10",
+    "lodash": "4.17.21"
   }
 }