@substrate-ai/core 0.19.54 → 0.20.2

package/README.md

@@ -1,55 +1,55 @@
 # @substrate-ai/core
 
-General-purpose agent infrastructure for the Substrate platform. This package contains all transport-agnostic modules extracted from the Substrate monolith during Epic 41 (Core Extraction Phase 1). Downstream packages — `substrate-ai` (SDLC), factory, and any custom orchestrators — import from `@substrate-ai/core` without coupling to SDLC-specific types.
+Transport-agnostic primitives for the [Substrate](https://github.com/johnplanow/substrate) platform. This is the foundation package — adapters, dispatch, routing, persistence, telemetry, cost tracking, event bus, and supervisor analysis — kept free of SDLC-specific concerns so downstream packages (`@substrate-ai/sdlc`, `@substrate-ai/factory`, or custom orchestrators) can compose the pieces they need.
 
-## Exported Modules
+## Install
 
-| Namespace | Key exports |
+```bash
+npm install @substrate-ai/core
+```
+
+Node 22 or later is required. If you plan to use the Dolt persistence adapter in socket mode, also install `mysql2` — it is declared as an optional peer dependency so consumers who only use the CLI or file-backed adapters skip the transitive binary.
+
+## Modules
+
+| Namespace | Representative exports |
 |---|---|
 | **adapters** | `WorkerAdapter`, `AdapterRegistry`, `SpawnCommand`, `AdapterOptions` |
+| **budget** | `BudgetTracker` |
 | **config** | `SubstrateConfig`, config loader, validation helpers |
-| **dispatch** | `Dispatcher`, `DispatchRequest`, `DispatchHandle`, `DispatchResult`, `DispatchConfig` |
-| **events** | `TypedEventBus`, `TypedEventBusImpl`, `createEventBus`, `CoreEvents`, `EventMap`, `EventHandler` |
-| **git** | Git utilities, worktree management, `GitManager` |
-| **persistence** | `DatabaseAdapter`, `DatabaseAdapterConfig`, `SyncAdapter`, `isSyncAdapter`, `InitSchemaFn` |
-| **routing** | `RoutingDecision`, `RoutingPolicy`, `IRoutingResolver`, `ModelResolution` |
-| **telemetry** | Telemetry pipeline, scoring modules, `ITelemetryPersistence`, `estimateCost` |
-| **supervisor** | Analysis engine, experimenter framework |
-| **budget** | `BudgetTracker` interface and implementation |
-| **cost-tracker** | Token rates, cost tracking, `CostEntry`, `TaskCostSummary`, `SessionCostSummary` |
-| **monitor** | `MonitorAgent`, `RecommendationEngine`, `ReportGenerator`, `TaskTypeClassifier` |
-| **version-manager** | `VersionManager`, `VersionManagerImpl`, `UpdateChecker`, `VersionCache` |
 | **context** | `ContextCompiler`, `TaskDescriptor`, `CompileResult` |
+| **cost-tracker** | `CostTracker`, `CostEntry`, `TaskCostSummary`, `TOKEN_RATES` |
+| **dispatch** | `Dispatcher`, `DispatchRequest`, `DispatchHandle`, `DispatchResult` |
+| **events** | `TypedEventBus`, `createEventBus`, `CoreEvents`, `EventMap`, `EventHandler` |
+| **git** | Git utilities, worktree management, `GitManager` |
+| **llm** | `callLLM`, `LLMCallParams`, `LLMCallResult` (default stub — provide your own implementation) |
+| **monitor** | `MonitorAgent`, `RecommendationEngine`, `ReportGenerator` |
+| **persistence** | `DatabaseAdapter`, `SyncAdapter`, `createDatabaseAdapter` |
 | **quality-gates** | `QualityGate`, `GatePipeline`, `GateResult` |
+| **routing** | `RoutingDecision`, `RoutingPolicy`, `IRoutingResolver` |
+| **supervisor** | Analysis engine, experimenter framework |
+| **telemetry** | Telemetry pipeline, scoring modules, `estimateCost` |
+| **version-manager** | `VersionManager`, `UpdateChecker`, `VersionCache` |
 
 ## Usage
 
 ```typescript
-// Event bus — subscribe and publish typed pipeline events
-import { createEventBus, TypedEventBus } from '@substrate-ai/core';
+import { createEventBus, type TypedEventBus } from '@substrate-ai/core'
 
-const bus: TypedEventBus = createEventBus();
-bus.on('story:complete', (event) => console.log('Story done:', event.storyKey));
+const bus: TypedEventBus = createEventBus()
+bus.on('story:complete', (event) => console.log('Story done:', event.storyKey))
 ```
 
 ```typescript
-// Adapter registry — register and retrieve worker adapters
-import { AdapterRegistry, WorkerAdapter } from '@substrate-ai/core';
+import { AdapterRegistry } from '@substrate-ai/core'
 
-const registry = new AdapterRegistry();
-registry.register('claude', myClaudeAdapter);
-const adapter: WorkerAdapter = registry.get('claude');
+const registry = new AdapterRegistry()
+registry.register('claude', myClaudeAdapter)
+const adapter = registry.get('claude')
 ```
 
-```typescript
-// Persistence — create a database adapter for pipeline state
-import { DatabaseAdapterConfig, createDatabaseAdapter } from '@substrate-ai/core';
-
-const config: DatabaseAdapterConfig = { backend: 'dolt', basePath: '.substrate' };
-const db = await createDatabaseAdapter(config);
-await db.initSchema(mySchema);
-```
+## Versioning
 
-## Version
+This package releases in lockstep with `substrate-ai` on every `v*` tag push. Pick any version ≥ `0.20.1` — all four `@substrate-ai/*` packages publish together with verified npm provenance.
 
-`@substrate-ai/core` follows the root `substrate-ai` version. Current version: **0.9.0** (Epic 41 — Core Extraction Phase 1 complete).
+See the [main repository](https://github.com/johnplanow/substrate) for the full platform documentation.

package/dist/config/types.d.ts

@@ -12,9 +12,9 @@ import { z } from 'zod';
 import type { ILogger } from '../dispatch/types.js';
 /** Subscription routing modes */
 export declare const SubscriptionRoutingSchema: z.ZodEnum<{
-    auto: "auto";
     subscription: "subscription";
     api: "api";
+    auto: "auto";
     disabled: "disabled";
 }>;
 export type SubscriptionRouting = z.infer<typeof SubscriptionRoutingSchema>;
@@ -29,9 +29,9 @@ export declare const ProviderConfigSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
     cli_path: z.ZodOptional<z.ZodString>;
     subscription_routing: z.ZodEnum<{
-        auto: "auto";
         subscription: "subscription";
         api: "api";
+        auto: "auto";
         disabled: "disabled";
     }>;
     max_concurrent: z.ZodNumber;
@@ -49,9 +49,9 @@ export declare const ProvidersSchema: z.ZodObject<{
         enabled: z.ZodBoolean;
         cli_path: z.ZodOptional<z.ZodString>;
         subscription_routing: z.ZodEnum<{
-            auto: "auto";
             subscription: "subscription";
             api: "api";
+            auto: "auto";
             disabled: "disabled";
         }>;
         max_concurrent: z.ZodNumber;
@@ -66,9 +66,9 @@ export declare const ProvidersSchema: z.ZodObject<{
         enabled: z.ZodBoolean;
         cli_path: z.ZodOptional<z.ZodString>;
         subscription_routing: z.ZodEnum<{
-            auto: "auto";
             subscription: "subscription";
             api: "api";
+            auto: "auto";
             disabled: "disabled";
         }>;
         max_concurrent: z.ZodNumber;
@@ -83,9 +83,9 @@ export declare const ProvidersSchema: z.ZodObject<{
         enabled: z.ZodBoolean;
         cli_path: z.ZodOptional<z.ZodString>;
         subscription_routing: z.ZodEnum<{
-            auto: "auto";
             subscription: "subscription";
             api: "api";
+            auto: "auto";
             disabled: "disabled";
         }>;
         max_concurrent: z.ZodNumber;
@@ -99,21 +99,21 @@ export declare const ProvidersSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type ProvidersConfig = z.infer<typeof ProvidersSchema>;
 export declare const LogLevelSchema: z.ZodEnum<{
-    error: "error";
     trace: "trace";
     debug: "debug";
     info: "info";
     warn: "warn";
+    error: "error";
     fatal: "fatal";
 }>;
 export type LogLevelValue = z.infer<typeof LogLevelSchema>;
 export declare const GlobalSettingsSchema: z.ZodObject<{
     log_level: z.ZodEnum<{
-        error: "error";
         trace: "trace";
         debug: "debug";
         info: "info";
         warn: "warn";
+        error: "error";
         fatal: "fatal";
     }>;
     max_concurrent_tasks: z.ZodNumber;
@@ -164,11 +164,11 @@ export declare const SubstrateConfigSchema: z.ZodObject<{
     }>>;
     global: z.ZodObject<{
         log_level: z.ZodEnum<{
-            error: "error";
             trace: "trace";
             debug: "debug";
             info: "info";
             warn: "warn";
+            error: "error";
             fatal: "fatal";
         }>;
         max_concurrent_tasks: z.ZodNumber;
@@ -182,9 +182,9 @@ export declare const SubstrateConfigSchema: z.ZodObject<{
             enabled: z.ZodBoolean;
             cli_path: z.ZodOptional<z.ZodString>;
             subscription_routing: z.ZodEnum<{
-                auto: "auto";
                 subscription: "subscription";
                 api: "api";
+                auto: "auto";
                 disabled: "disabled";
             }>;
             max_concurrent: z.ZodNumber;
@@ -199,9 +199,9 @@ export declare const SubstrateConfigSchema: z.ZodObject<{
             enabled: z.ZodBoolean;
             cli_path: z.ZodOptional<z.ZodString>;
             subscription_routing: z.ZodEnum<{
-                auto: "auto";
                 subscription: "subscription";
                 api: "api";
+                auto: "auto";
                 disabled: "disabled";
             }>;
             max_concurrent: z.ZodNumber;
@@ -216,9 +216,9 @@ export declare const SubstrateConfigSchema: z.ZodObject<{
             enabled: z.ZodBoolean;
             cli_path: z.ZodOptional<z.ZodString>;
             subscription_routing: z.ZodEnum<{
-                auto: "auto";
                 subscription: "subscription";
                 api: "api";
+                auto: "auto";
                 disabled: "disabled";
             }>;
             max_concurrent: z.ZodNumber;
@@ -258,9 +258,9 @@ export declare const PartialProviderConfigSchema: z.ZodObject<{
     enabled: z.ZodOptional<z.ZodBoolean>;
     cli_path: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     subscription_routing: z.ZodOptional<z.ZodEnum<{
-        auto: "auto";
         subscription: "subscription";
         api: "api";
+        auto: "auto";
         disabled: "disabled";
     }>>;
     max_concurrent: z.ZodOptional<z.ZodNumber>;
@@ -274,11 +274,11 @@ export declare const PartialProviderConfigSchema: z.ZodObject<{
 export type PartialProviderConfig = z.infer<typeof PartialProviderConfigSchema>;
 export declare const PartialGlobalSettingsSchema: z.ZodObject<{
     log_level: z.ZodOptional<z.ZodEnum<{
-        error: "error";
         trace: "trace";
         debug: "debug";
         info: "info";
         warn: "warn";
+        error: "error";
         fatal: "fatal";
     }>>;
     max_concurrent_tasks: z.ZodOptional<z.ZodNumber>;
@@ -297,11 +297,11 @@ export declare const PartialSubstrateConfigSchema: z.ZodObject<{
     }>>;
     global: z.ZodOptional<z.ZodObject<{
         log_level: z.ZodOptional<z.ZodEnum<{
-            error: "error";
             trace: "trace";
             debug: "debug";
             info: "info";
             warn: "warn";
+            error: "error";
             fatal: "fatal";
         }>>;
         max_concurrent_tasks: z.ZodOptional<z.ZodNumber>;
@@ -315,9 +315,9 @@ export declare const PartialSubstrateConfigSchema: z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
             cli_path: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             subscription_routing: z.ZodOptional<z.ZodEnum<{
-                auto: "auto";
                 subscription: "subscription";
                 api: "api";
+                auto: "auto";
                 disabled: "disabled";
             }>>;
             max_concurrent: z.ZodOptional<z.ZodNumber>;
@@ -332,9 +332,9 @@ export declare const PartialSubstrateConfigSchema: z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
             cli_path: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             subscription_routing: z.ZodOptional<z.ZodEnum<{
-                auto: "auto";
                 subscription: "subscription";
                 api: "api";
+                auto: "auto";
                 disabled: "disabled";
             }>>;
             max_concurrent: z.ZodOptional<z.ZodNumber>;
@@ -349,9 +349,9 @@ export declare const PartialSubstrateConfigSchema: z.ZodObject<{
             enabled: z.ZodOptional<z.ZodBoolean>;
             cli_path: z.ZodOptional<z.ZodOptional<z.ZodString>>;
             subscription_routing: z.ZodOptional<z.ZodEnum<{
-                auto: "auto";
                 subscription: "subscription";
                 api: "api";
+                auto: "auto";
                 disabled: "disabled";
             }>>;
             max_concurrent: z.ZodOptional<z.ZodNumber>;

package/package.json

@@ -1,7 +1,13 @@
 {
   "name": "@substrate-ai/core",
-  "version": "0.19.54",
+  "version": "0.20.2",
   "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/johnplanow/substrate.git",
+    "directory": "packages/core"
+  },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -16,12 +22,20 @@
   "scripts": {
     "build": "tsc -b"
   },
+  "engines": {
+    "node": ">=22.0.0"
+  },
   "dependencies": {
     "js-yaml": "^4.1.1",
     "semver": "^7.6.3",
     "zod": "^4.3.6"
   },
-  "optionalDependencies": {
+  "peerDependencies": {
     "mysql2": "^3.20.0"
+  },
+  "peerDependenciesMeta": {
+    "mysql2": {
+      "optional": true
+    }
   }
 }

package/dist/__tests__/adapter.test.d.ts

@@ -1,12 +0,0 @@
-/**
- * Unit tests for packages/core/src/persistence/adapter.ts
- *
- * Tests the createDatabaseAdapter() factory function with all three backend
- * modes (auto, memory, dolt), Dolt availability detection, fallback logic,
- * and warning messages.
- *
- * All filesystem and child_process interactions are mocked — no real Dolt
- * installation is required.
- */
-export {};
-//# sourceMappingURL=adapter.test.d.ts.map

package/dist/__tests__/adapter.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/adapter.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/__tests__/adapter.test.js

@@ -1,259 +0,0 @@
-/**
- * Unit tests for packages/core/src/persistence/adapter.ts
- *
- * Tests the createDatabaseAdapter() factory function with all three backend
- * modes (auto, memory, dolt), Dolt availability detection, fallback logic,
- * and warning messages.
- *
- * All filesystem and child_process interactions are mocked — no real Dolt
- * installation is required.
- */
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { createDatabaseAdapter } from '../persistence/adapter.js';
-import { DoltDatabaseAdapter } from '../persistence/dolt-adapter.js';
-import { InMemoryDatabaseAdapter } from '../persistence/memory-adapter.js';
-// ---------------------------------------------------------------------------
-// Mock node:child_process and node:fs
-// ---------------------------------------------------------------------------
-vi.mock('node:child_process', () => ({
-    spawnSync: vi.fn(),
-}));
-vi.mock('node:fs', () => ({
-    existsSync: vi.fn(),
-}));
-import { spawnSync } from 'node:child_process';
-import { existsSync } from 'node:fs';
-const mockedSpawnSync = vi.mocked(spawnSync);
-const mockedExistsSync = vi.mocked(existsSync);
-// ---------------------------------------------------------------------------
-// Helper: create a mock DoltClientLike factory
-// ---------------------------------------------------------------------------
-function makeMockDoltClientFactory() {
-    const mockClient = {
-        query: vi.fn().mockResolvedValue([]),
-        close: vi.fn().mockResolvedValue(undefined),
-    };
-    const factory = vi.fn().mockReturnValue(mockClient);
-    return { factory, mockClient };
-}
-// ---------------------------------------------------------------------------
-// Helper: configure mocks so isDoltAvailable returns true
-// ---------------------------------------------------------------------------
-function configureDoltAvailable() {
-    mockedExistsSync.mockReturnValue(true);
-    mockedSpawnSync.mockReturnValue({
-        status: 0,
-        pid: 1,
-        output: [],
-        stdout: Buffer.from(''),
-        stderr: Buffer.from(''),
-        signal: null,
-    });
-}
-// ---------------------------------------------------------------------------
-// Helper: configure mocks so isDoltAvailable returns false (no .dolt dir)
-// ---------------------------------------------------------------------------
-function configureDoltUnavailable() {
-    mockedExistsSync.mockReturnValue(false);
-    mockedSpawnSync.mockReturnValue({
-        error: new Error('ENOENT'),
-        status: null,
-        pid: 0,
-        output: [],
-        stdout: Buffer.from(''),
-        stderr: Buffer.from(''),
-        signal: null,
-    });
-}
-// ---------------------------------------------------------------------------
-// Helper: configure mocks so .dolt dir exists but binary fails
-// ---------------------------------------------------------------------------
-function configureDoltDirExistsBinaryFails() {
-    mockedExistsSync.mockReturnValue(true);
-    mockedSpawnSync.mockReturnValue({
-        error: new Error('ENOENT'),
-        status: null,
-        pid: 0,
-        output: [],
-        stdout: Buffer.from(''),
-        stderr: Buffer.from(''),
-        signal: null,
-    });
-}
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-describe('createDatabaseAdapter', () => {
-    beforeEach(() => {
-        vi.clearAllMocks();
-    });
-    afterEach(() => {
-        vi.restoreAllMocks();
-    });
-    // -------------------------------------------------------------------------
-    // backend = 'memory'
-    // -------------------------------------------------------------------------
-    describe('backend = "memory"', () => {
-        it('returns an InMemoryDatabaseAdapter regardless of Dolt availability', () => {
-            configureDoltAvailable();
-            const adapter = createDatabaseAdapter({ backend: 'memory' });
-            expect(adapter).toBeInstanceOf(InMemoryDatabaseAdapter);
-            // Should not probe Dolt at all
-            expect(mockedExistsSync).not.toHaveBeenCalled();
-            expect(mockedSpawnSync).not.toHaveBeenCalled();
-        });
-        it('does not call the doltClientFactory when backend is memory', () => {
-            const { factory } = makeMockDoltClientFactory();
-            const adapter = createDatabaseAdapter({ backend: 'memory' }, factory);
-            expect(adapter).toBeInstanceOf(InMemoryDatabaseAdapter);
-            expect(factory).not.toHaveBeenCalled();
-        });
-    });
-    // -------------------------------------------------------------------------
-    // backend = 'dolt'
-    // -------------------------------------------------------------------------
-    describe('backend = "dolt"', () => {
-        it('returns a DoltDatabaseAdapter when factory is provided', () => {
-            const { factory, mockClient } = makeMockDoltClientFactory();
-            const adapter = createDatabaseAdapter({ backend: 'dolt', basePath: '/tmp/test-project' }, factory);
-            expect(adapter).toBeInstanceOf(DoltDatabaseAdapter);
-            expect(factory).toHaveBeenCalledWith('/tmp/test-project/.substrate/state');
-        });
-        it('falls back to InMemoryDatabaseAdapter when no factory is provided', () => {
-            const warnSpy = vi.spyOn(console, 'debug').mockImplementation(() => { });
-            const adapter = createDatabaseAdapter({ backend: 'dolt' });
-            expect(adapter).toBeInstanceOf(InMemoryDatabaseAdapter);
-            expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('no doltClientFactory provided'));
-        });
-    });
-    // -------------------------------------------------------------------------
-    // backend = 'auto'
-    // -------------------------------------------------------------------------
-    describe('backend = "auto"', () => {
-        it('returns DoltDatabaseAdapter when Dolt is available and factory provided', () => {
-            configureDoltAvailable();
-            const { factory } = makeMockDoltClientFactory();
-            const adapter = createDatabaseAdapter({ backend: 'auto', basePath: '/tmp/test-project' }, factory);
-            expect(adapter).toBeInstanceOf(DoltDatabaseAdapter);
-            expect(factory).toHaveBeenCalledWith('/tmp/test-project/.substrate/state');
-        });
-        it('returns InMemoryDatabaseAdapter when Dolt dir does not exist', () => {
-            configureDoltUnavailable();
-            const { factory } = makeMockDoltClientFactory();
-            const adapter = createDatabaseAdapter({ backend: 'auto', basePath: '/tmp/test-project' }, factory);
-            expect(adapter).toBeInstanceOf(InMemoryDatabaseAdapter);
-            // Factory should NOT be called since Dolt is unavailable
-            expect(factory).not.toHaveBeenCalled();
-        });
-        it('returns InMemoryDatabaseAdapter when no factory is provided even if Dolt is available', () => {
-            configureDoltAvailable();
-            const adapter = createDatabaseAdapter({
-                backend: 'auto',
-                basePath: '/tmp/test-project',
-            });
-            expect(adapter).toBeInstanceOf(InMemoryDatabaseAdapter);
-        });
-        it('defaults backend to "auto" when config is undefined', () => {
-            configureDoltUnavailable();
-            const adapter = createDatabaseAdapter();
-            expect(adapter).toBeInstanceOf(InMemoryDatabaseAdapter);
-        });
-        it('defaults basePath to process.cwd() when not specified', () => {
-            configureDoltAvailable();
-            const { factory } = makeMockDoltClientFactory();
-            const cwd = process.cwd();
-            const adapter = createDatabaseAdapter({ backend: 'auto' }, factory);
-            expect(adapter).toBeInstanceOf(DoltDatabaseAdapter);
-            expect(factory).toHaveBeenCalledWith(`${cwd}/.substrate/state`);
-        });
-    });
-    // -------------------------------------------------------------------------
-    // isDoltAvailable — retry logic
-    // -------------------------------------------------------------------------
-    describe('isDoltAvailable retry logic (via auto backend)', () => {
-        it('retries once when .dolt dir exists but binary fails, then succeeds', () => {
-            const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
-            // .dolt directory exists
-            mockedExistsSync.mockReturnValue(true);
-            // First call to `dolt version` fails, retry succeeds
-            let callCount = 0;
-            mockedSpawnSync.mockImplementation((cmd) => {
-                if (cmd === 'dolt') {
-                    callCount++;
-                    if (callCount <= 1) {
-                        // First attempt: binary unavailable
-                        return {
-                            error: new Error('ENOENT'),
-                            status: null,
-                            pid: 0,
-                            output: [],
-                            stdout: Buffer.from(''),
-                            stderr: Buffer.from(''),
-                            signal: null,
-                        };
-                    }
-                    // Retry: binary available
-                    return {
-                        status: 0,
-                        pid: 1,
-                        output: [],
-                        stdout: Buffer.from(''),
-                        stderr: Buffer.from(''),
-                        signal: null,
-                    };
-                }
-                // sleep call
-                return {
-                    status: 0,
-                    pid: 1,
-                    output: [],
-                    stdout: Buffer.from(''),
-                    stderr: Buffer.from(''),
-                    signal: null,
-                };
-            });
-            const { factory } = makeMockDoltClientFactory();
-            const adapter = createDatabaseAdapter({ backend: 'auto', basePath: '/tmp/test-project' }, factory);
-            expect(adapter).toBeInstanceOf(DoltDatabaseAdapter);
-            // Should have warned about the retry
-            expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('retrying once'));
-        });
-        it('falls back to InMemory with warning when .dolt dir exists but binary fails on both attempts', () => {
-            const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
-            configureDoltDirExistsBinaryFails();
-            const { factory } = makeMockDoltClientFactory();
-            const adapter = createDatabaseAdapter({ backend: 'auto', basePath: '/tmp/test-project' }, factory);
-            expect(adapter).toBeInstanceOf(InMemoryDatabaseAdapter);
-            // Should warn about retry and about final fallback
-            expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('retrying once'));
-            expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('still unavailable after retry'));
-        });
-    });
-    // -------------------------------------------------------------------------
-    // backendType property
-    // -------------------------------------------------------------------------
-    describe('backendType property', () => {
-        it('InMemoryDatabaseAdapter has backendType "memory"', () => {
-            configureDoltUnavailable();
-            const adapter = createDatabaseAdapter({ backend: 'memory' });
-            expect(adapter.backendType).toBe('memory');
-        });
-        it('DoltDatabaseAdapter has backendType "dolt"', () => {
-            configureDoltAvailable();
-            const { factory } = makeMockDoltClientFactory();
-            const adapter = createDatabaseAdapter({ backend: 'auto', basePath: '/tmp/test-project' }, factory);
-            expect(adapter.backendType).toBe('dolt');
-        });
-    });
-    // -------------------------------------------------------------------------
-    // Edge cases
-    // -------------------------------------------------------------------------
-    describe('edge cases', () => {
-        it('handles backend=undefined in config (defaults to auto)', () => {
-            configureDoltUnavailable();
-            const adapter = createDatabaseAdapter({ backend: 'auto' });
-            expect(adapter).toBeInstanceOf(InMemoryDatabaseAdapter);
-        });
-    });
-});
-//# sourceMappingURL=adapter.test.js.map

package/dist/__tests__/adapter.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.test.js","sourceRoot":"","sources":["../../src/__tests__/adapter.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/event-bus.test.d.ts

@@ -1,14 +0,0 @@
-/**
- * Unit tests for packages/core/src/events/event-bus.ts
- *
- * Tests the TypedEventBusImpl class and createEventBus factory:
- * - Basic emit/on/off lifecycle
- * - Typed event emission with correct payload delivery
- * - Multiple handlers for same event
- * - Handler removal (off)
- * - Synchronous dispatch guarantee
- * - Multiple event types coexisting
- * - createEventBus factory returns working instance
- */
-export {};
-//# sourceMappingURL=event-bus.test.d.ts.map

package/dist/__tests__/event-bus.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-bus.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/event-bus.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}