@vibesdotdev/localdb 0.0.1 → 1.0.0-rc.2

package/package.json

@@ -1,146 +1,119 @@
 {
   "name": "@vibesdotdev/localdb",
-  "version": "0.0.1",
-  "type": "module",
+  "version": "1.0.0-rc.2",
+  "dependencies": {
+    "@vibesdotdev/filesystem": "^1.0.0-rc.2",
+    "zod": "^4.6.7"
+  },
+  "peerDependencies": {
+    "@vibesdotdev/logging": "^1.0.0-rc.3",
+    "@vibesdotdev/kernel": "^1.0.0-rc.5"
+  },
   "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "bun": "./dist/index.js",
       "types": "./dist/index.d.ts",
-      "bun": "./src/index.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
     "./plugin": {
+      "bun": "./dist/localdb.plugin.js",
       "types": "./dist/localdb.plugin.d.ts",
-      "bun": "./src/localdb.plugin.ts",
       "import": "./dist/localdb.plugin.js",
       "default": "./dist/localdb.plugin.js"
     },
-    "./cloud.plugin": {
-      "types": "./dist/localdb.cloud.plugin.d.ts",
-      "bun": "./src/localdb.cloud.plugin.ts",
-      "import": "./dist/localdb.cloud.plugin.js",
-      "default": "./dist/localdb.cloud.plugin.js"
-    },
     "./schemas": {
+      "bun": "./dist/schemas/api.js",
       "types": "./dist/schemas/api.d.ts",
-      "bun": "./src/schemas/api.ts",
       "import": "./dist/schemas/api.js",
       "default": "./dist/schemas/api.js"
     },
     "./migrations/load-sql": {
+      "bun": "./dist/migrations/load-sql.js",
       "types": "./dist/migrations/load-sql.d.ts",
-      "bun": "./src/migrations/load-sql.ts",
       "import": "./dist/migrations/load-sql.js",
       "default": "./dist/migrations/load-sql.js"
     },
-    "./*": {
-      "types": "./dist/*.d.ts",
-      "bun": "./src/*.ts",
-      "import": "./dist/*.js",
-      "default": "./dist/*.js"
-    },
-    "./*.js": {
-      "types": "./dist/*.d.ts",
-      "bun": "./src/*.ts",
-      "import": "./dist/*.js",
-      "default": "./dist/*.js"
-    },
-    "./*/*": {
-      "types": "./dist/*/*.d.ts",
-      "bun": "./src/*/*.ts",
-      "import": "./dist/*/*.js",
-      "default": "./dist/*/*.js"
+    "./wal-policy": {
+      "bun": "./dist/core/wal-policy.js",
+      "types": "./dist/core/wal-policy.d.ts",
+      "import": "./dist/core/wal-policy.js",
+      "default": "./dist/core/wal-policy.js"
     },
-    "./*/*.js": {
-      "types": "./dist/*/*.d.ts",
-      "bun": "./src/*/*.ts",
-      "import": "./dist/*/*.js",
-      "default": "./dist/*/*.js"
+    "./location": {
+      "bun": "./dist/location.js",
+      "types": "./dist/location.d.ts",
+      "import": "./dist/location.js",
+      "default": "./dist/location.js"
     },
-    "./*/*/*": {
-      "types": "./dist/*/*/*.d.ts",
-      "bun": "./src/*/*/*.ts",
-      "import": "./dist/*/*/*.js",
-      "default": "./dist/*/*/*.js"
+    "./sqlite-driver": {
+      "bun": "./dist/driver/sqlite-driver.js",
+      "types": "./dist/driver/sqlite-driver.d.ts",
+      "import": "./dist/driver/sqlite-driver.js",
+      "default": "./dist/driver/sqlite-driver.js"
     },
-    "./*/*/*.js": {
-      "types": "./dist/*/*/*.d.ts",
-      "bun": "./src/*/*/*.ts",
-      "import": "./dist/*/*/*.js",
-      "default": "./dist/*/*/*.js"
+    "./sqlite-driver/base": {
+      "bun": "./dist/driver/sqlite-driver.base.js",
+      "types": "./dist/driver/sqlite-driver.base.d.ts",
+      "import": "./dist/driver/sqlite-driver.base.js",
+      "default": "./dist/driver/sqlite-driver.base.js"
     },
-    "./*/*/*/*": {
-      "types": "./dist/*/*/*/*.d.ts",
-      "bun": "./src/*/*/*/*.ts",
-      "import": "./dist/*/*/*/*.js",
-      "default": "./dist/*/*/*/*.js"
+    "./test-tooling/sqlite-driver-conformance": {
+      "bun": "./dist/testing/sqlite-driver-conformance.js",
+      "types": "./dist/testing/sqlite-driver-conformance.d.ts",
+      "import": "./dist/testing/sqlite-driver-conformance.js",
+      "default": "./dist/testing/sqlite-driver-conformance.js"
     },
-    "./*/*/*/*.js": {
-      "types": "./dist/*/*/*/*.d.ts",
-      "bun": "./src/*/*/*/*.ts",
-      "import": "./dist/*/*/*/*.js",
-      "default": "./dist/*/*/*/*.js"
-    },
-    "./*/*/*/*/*": {
-      "types": "./dist/*/*/*/*/*.d.ts",
-      "bun": "./src/*/*/*/*/*.ts",
-      "import": "./dist/*/*/*/*/*.js",
-      "default": "./dist/*/*/*/*/*.js"
-    },
-    "./*/*/*/*/*.js": {
-      "types": "./dist/*/*/*/*/*.d.ts",
-      "bun": "./src/*/*/*/*/*.ts",
-      "import": "./dist/*/*/*/*/*.js",
-      "default": "./dist/*/*/*/*/*.js"
+    "./pool": {
+      "bun": "./dist/pool.js",
+      "types": "./dist/pool.d.ts",
+      "import": "./dist/pool.js",
+      "default": "./dist/pool.js"
     }
   },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org",
-    "access": "public"
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "lint": "node ../node_modules/@vibesdotdev/internal-oxlint-toolchain/ratchet.mjs .",
+    "test": "bun test && bun run test:contention && bun run test:node",
+    "test:node": "rm -rf .cache/node-run && bun build --target=node --conditions=bun --splitting --format=esm --outdir .cache/node-run/bundle src/__tests__/node-run/localdb.node-run.ts && node --test .cache/node-run/bundle/localdb.node-run.js",
+    "check": "bun --bun tsc -p tsconfig.json",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "test:contention": "bun test ./src/__tests__/startup-contention.integration.ts"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/vibesdotdev/monorepo.git",
-    "directory": "packages/localdb"
+    "url": "ssh://git@git.vibes.dev/vibesdotdev/framework.git",
+    "directory": "localdb"
   },
-  "peerDependencies": {
-    "@vibesdotdev/runtime": "0.0.1",
-    "@vibesdotdev/logging": "0.0.1",
-    "@vibesdotdev/cli": "0.0.1"
+  "publishConfig": {
+    "registry": "https://packages.vibes.dev",
+    "access": "public"
   },
-  "scripts": {
-    "test": "bun test",
-    "check": "bun --bun tsc -p tsconfig.json --noEmit",
-    "build": "tsc -p tsconfig.json"
+  "vibes": {
+    "visibility": "public",
+    "registry": {
+      "repositoryId": "4b1374d4-6830-4bfd-98e3-de66416368a8",
+      "directory": "localdb"
+    },
+    "handedRuntimeLogging": true
   },
+  "type": "module",
+  "types": "./dist/index.d.ts",
   "license": "MIT",
-  "files": [
-    "dist",
-    "src",
-    "bin",
-    "README.md",
-    "SPEC.md",
-    "LICENSE",
-    "!src/**/__tests__/**",
-    "!src/**/__stubs__/**",
-    "!src/**/*.test.ts",
-    "!src/**/*.test.tsx",
-    "!src/**/*.spec.ts",
-    "!src/**/*.spec.tsx",
-    "!dist/**/__tests__/**",
-    "!dist/**/__stubs__/**",
-    "!dist/**/*.test.js",
-    "!dist/**/*.test.js.map",
-    "!dist/**/*.test.d.ts",
-    "!dist/**/*.test.d.ts.map",
-    "!dist/**/*.spec.js",
-    "!dist/**/*.spec.js.map",
-    "!dist/**/*.spec.d.ts",
-    "!dist/**/*.spec.d.ts.map"
-  ],
-  "vibes": {
-    "visibility": "public-framework"
+  "description": "Local SQLite storage helpers and migration utilities for Vibes development surfaces.",
+  "homepage": "https://docs.vibes.dev/localdb",
+  "bugs": {
+    "url": "https://docs.vibes.dev/localdb#support"
+  },
+  "gitHead": "51230ebdad54bc405014633f435b499fa2a06b89",
+  "_vibes_source": {
+    "repo": "ssh://git@git.vibes.dev/vibesdotdev/framework.git",
+    "sha": "51230ebdad54bc405014633f435b499fa2a06b89",
+    "workspaceDigest": "sha256:a238deb4a7000e7e51353eaa5b0088fd048ca160459aef60ae36f2d2f3b4c1d6"
   }
 }

package/SPEC.md

@@ -1,119 +0,0 @@
-# @vibesdotdev/localdb
-
-Local SQLite primitive for the vibes consumer-hardware toolkit. Owns the
-connection pool (one `bun:sqlite` `Database` per file path, WAL mode, busy
-timeout, ref-counted, idle-cleanup), the namespace migration registry
-(sequential-version enforcement, legacy `PRAGMA user_version` bootstrap,
-`vibes_schema_versions` tracking table), the recovery/trapdoor flow (backup →
-delete → recreate → re-migrate on migration failure or version mismatch), and
-the `vibes dev localdb` CLI surface. Consumer hardware only — `bun:sqlite` is
-server-runtime only. The storage adapter that wraps localdb lives in a sibling
-adapter package, not here.
-
-## Owns
-
-- **Plugin descriptors registered by the plugin** (`./plugin`):
-  - `runtime/context` `dev/localdb` — server-side `LocaldbApi` access for
-    runtime callers.
-  - `cli/group` `dev.localdb` parented under `dev` — `vibes dev localdb`.
-  - `cli/command` `dev.localdb.{status,migrate,namespaces,pools,query}`.
-- **Connection pool** (`./core/connection-pool`): per-path pooled `bun:sqlite`
-  `Database`, ref-counting, idle stale-cleanup (30 min), uniform PRAGMAs
-  (`journal_mode=WAL`, `busy_timeout=5000`, `foreign_keys=ON`,
-  `synchronous=NORMAL`, `temp_store=MEMORY`).
-- **Migration registry** (`./core/migration-registry`): namespace-keyed
-  `Migration[]`, sequential `1..N` version enforcement,
-  `vibes_schema_versions` tracking, legacy `PRAGMA user_version` one-time
-  bootstrap, incompatible-database (version-too-high) detection.
-- **`LocalDatabase` + `localdb` singleton manager** (`./core/database`):
-  per-`namespace:path` entry caching with per-`dbPath` async lock,
-  recovery/trapdoor on migration failure with retained backups (last 12),
-  `getRawDatabase()` for migration-free pooled access, `closeAll()` /
-  process-exit cleanup.
-- **Public API types** (`./schemas`): `LocaldbApi`, `LocaldbRawDatabase`,
-  `LocaldbStatement`, `Migration`, `MigrationFunction`, `ConnectionStats`,
-  `ConnectionPoolApi`, `MigrationRegistryApi`.
-
-## Does not own
-
-- The `storage/adapter` impl `storage.localdb.core` →
-  [`storage-adapter-localdb`](../storage-adapter-localdb/SPEC.md). Per pattern
-  1, environment-specific storage adapters live in sibling packages; the
-  adapter is a thin `storage` consumer of `localdb`.
-- Domain migration SQL → owning module:
-  - `atlas` schema → [`workspace`](../workspace/SPEC.md) (the only registrar,
-    via `packages/workspace/src/codegraph/storage/register-migrations.ts`).
-  - `pm-state` schema → [`pm`](../pm/SPEC.md) (already lives there; PM passes
-    its own dir as an absolute path to `loadMigrationSQLSync`).
-  - `external` `file_accesses` → [`external`](../external/SPEC.md) (already
-    inline-defined in `packages/external/src/register-migrations.ts`).
-  - `config` schema → [`cli`](../cli/SPEC.md) (its app-config storage
-    subsystem already declares the namespace).
-- Cross-process / multi-tenant locking, replication, observability of pool
-  stats. Out of scope for the consumer-hardware floor; cloud storage uses
-  [`storage-adapter-drizzle`](../storage-adapter-drizzle/SPEC.md).
-- A `runtime/client` descriptor or `getVibesLocaldbClient()`. LocalDB is a
-  runtime substrate consumed via the `localdb` singleton or the `dev/localdb`
-  context, not a domain module.
-
-## Hard rules
-
-- **`bun:sqlite`, server-runtime only.** All filesystem/SQLite imports are
-  dynamic and gated on `isLocaldbServerRuntime()`. `LocalDatabase.initialize()`
-  throws in browser bundles.
-- **Sequential migration versions.** Registered migrations form `1..N` with
-  no gaps; out-of-sequence registration throws at `register()` time.
-- **Unknown namespace = throw.** `needsMigration` / `runMigrations` /
-  `getDatabase` against an unregistered namespace is a hard failure (per
-  pattern 4); domain modules call
-  `localdb.registerMigrations(namespace, migrations)` before opening their
-  database.
-- **Recovery is automatic and lossy.** Migration failure or
-  version-higher-than-registered triggers backup (`*.bak-{ts}`, last 12
-  retained) → delete file + WAL/SHM artifacts → fresh DB → re-run migrations
-  from version 0. Domain code must not rely on data surviving migration
-  failure.
-- **One Database per file path.** All access goes through the pool; the
-  `usePool: false` direct-connection path stays for special cases but new
-  code uses the pool.
-- **No domain SQL in this package.** Migration SQL files for a feature live
-  with that feature's package.
-
-## Migration debt
-
-All items completed in t11-mig-localdb-final-and-seal. See git history for original debt items.
-
-## Public entrypoints
-
-`.` — root exports (`localdb`, `LocalDatabase`, `Migration`, etc.)
-`./plugin` — LocalDB plugin registration
-`./schemas` — TypeScript type definitions (`LocaldbApi`, `Migration`, etc.)
-
-Migration-era subpaths (`./core/*`, `./migrations/*`, `./localdb.plugin`) have been removed.
-
-## Verification
-
-`bun test` from `packages/localdb`. Covers `MigrationRegistry` (version
-tracking, sequence validation, legacy-bootstrap, incompatible-version
-detection), `ConnectionPool` (pooling, ref-count, stats), `LocalDatabase`
-(init / idempotence / recovery / backup pruning), `localdb` manager
-(namespace caching + per-path lock), and `loadMigrationSQL` file resolution.
-Today (per `PROD-CHECKLIST.md` 2026-04-18): 79 pass / 0 fail.
-
-## Links
-
-- [storage/SPEC.md](../storage/SPEC.md),
-  [storage-adapter-localdb/SPEC.md](../storage-adapter-localdb/SPEC.md),
-  [storage-adapter-drizzle/SPEC.md](../storage-adapter-drizzle/SPEC.md),
-  [runtime/SPEC.md](../runtime/SPEC.md),
-  [cli/SPEC.md](../cli/SPEC.md),
-  [logging/SPEC.md](../logging/SPEC.md)
-- Active consumers: [pm](../pm/SPEC.md), [workspace](../workspace/SPEC.md),
-  [external](../external/SPEC.md), [cli](../cli/SPEC.md),
-  [presence](../presence/SPEC.md), [prompts](../prompts/SPEC.md),
-  [experiments](../experiments/SPEC.md), [desktop](../desktop/SPEC.md),
-  [browser-automation](../browser-automation/SPEC.md),
-  [knowledge](../knowledge/SPEC.md), [setup](../setup/SPEC.md)
-- Doctrine:
-  [RUNTIME-FIRST-MODULES.md](../../docs/architecture/RUNTIME-FIRST-MODULES.md),
-  [RUNTIME-SCOPE-TOPOLOGY.md](../../docs/architecture/RUNTIME-SCOPE-TOPOLOGY.md)

package/dist/core/error-context.d.ts

@@ -1,2 +0,0 @@
-export declare function toErrorContext(error: unknown): Record<string, unknown> | undefined;
-//# sourceMappingURL=error-context.d.ts.map

package/dist/core/error-context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-context.d.ts","sourceRoot":"","sources":["../../src/core/error-context.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAkBlF"}

package/dist/core/error-context.js

@@ -1,17 +0,0 @@
-export function toErrorContext(error) {
-    if (error instanceof Error) {
-        return {
-            error: error.message,
-            name: error.name,
-            stack: error.stack
-        };
-    }
-    if (typeof error === 'object' && error !== null && !Array.isArray(error)) {
-        return error;
-    }
-    if (error === undefined) {
-        return undefined;
-    }
-    return { error: String(error) };
-}
-//# sourceMappingURL=error-context.js.map

package/dist/core/error-context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-context.js","sourceRoot":"","sources":["../../src/core/error-context.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,KAAc;IAC5C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO;YACN,KAAK,EAAE,KAAK,CAAC,OAAO;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;SAClB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1E,OAAO,KAAgC,CAAC;IACzC,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACjC,CAAC"}

package/dist/core/runtime.d.ts

@@ -1,3 +0,0 @@
-export declare function isLocaldbBrowserRuntime(scope?: typeof globalThis): boolean;
-export declare function isLocaldbServerRuntime(scope?: typeof globalThis): boolean;
-//# sourceMappingURL=runtime.d.ts.map

package/dist/core/runtime.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/core/runtime.ts"],"names":[],"mappings":"AAMA,wBAAgB,uBAAuB,CAAC,KAAK,GAAE,OAAO,UAAuB,GAAG,OAAO,CAMtF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,GAAE,OAAO,UAAuB,GAAG,OAAO,CAErF"}

package/dist/core/runtime.js

@@ -1,17 +0,0 @@
-function hasRuntimeProcessVersion(name) {
-    if (typeof process === 'undefined')
-        return false;
-    const value = process.versions?.[name];
-    return typeof value === 'string' && value.length > 0;
-}
-export function isLocaldbBrowserRuntime(scope = globalThis) {
-    const globals = scope;
-    const hasWindow = typeof globals.window !== 'undefined' && globals.window !== null;
-    const hasDocument = typeof globals.document !== 'undefined' && globals.document !== null;
-    const hasServerRuntime = hasRuntimeProcessVersion('bun') || hasRuntimeProcessVersion('node');
-    return hasDocument || (hasWindow && !hasServerRuntime);
-}
-export function isLocaldbServerRuntime(scope = globalThis) {
-    return !isLocaldbBrowserRuntime(scope);
-}
-//# sourceMappingURL=runtime.js.map

package/dist/core/runtime.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/core/runtime.ts"],"names":[],"mappings":"AAAA,SAAS,wBAAwB,CAAC,IAAoB;IACrD,IAAI,OAAO,OAAO,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAA2B,UAAU;IAC5E,MAAM,OAAO,GAAG,KAAoD,CAAC;IACrE,MAAM,SAAS,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,WAAW,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC;IACnF,MAAM,WAAW,GAAG,OAAO,OAAO,CAAC,QAAQ,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC;IACzF,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,KAAK,CAAC,IAAI,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC7F,OAAO,WAAW,IAAI,CAAC,SAAS,IAAI,CAAC,gBAAgB,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAA2B,UAAU;IAC3E,OAAO,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/dist/localdb.cloud.plugin.d.ts

@@ -1,17 +0,0 @@
-/**
- * LocalDB Cloud Plugin
- *
- * Cloud-bundle-safe variant of `localdb.plugin.ts`.
- *
- * LocalDB manages on-disk SQLite (libsql / better-sqlite3) for consumer
- * environments. Every loader in `localdb.plugin.ts` is `.impl.consumer.ts`
- * and reaches `bun:sqlite` / `node:fs`. None of it is reachable from a
- * cloudflare-workers bundle.
- *
- * ai-web's plugin chain still loads localdb for shape uniformity per
- * `apps/ai-web (consolidated)/SPEC.md` line 14. This empty cloud variant satisfies
- * the chain without pulling consumer-only code into the cloud bundle.
- */
-declare const _default: import("@vibesdotdev/runtime").RuntimePlugin;
-export default _default;
-//# sourceMappingURL=localdb.cloud.plugin.d.ts.map

package/dist/localdb.cloud.plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"localdb.cloud.plugin.d.ts","sourceRoot":"","sources":["../src/localdb.cloud.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;;AAIH,wBAMG"}

package/dist/localdb.cloud.plugin.js

@@ -1,23 +0,0 @@
-/**
- * LocalDB Cloud Plugin
- *
- * Cloud-bundle-safe variant of `localdb.plugin.ts`.
- *
- * LocalDB manages on-disk SQLite (libsql / better-sqlite3) for consumer
- * environments. Every loader in `localdb.plugin.ts` is `.impl.consumer.ts`
- * and reaches `bun:sqlite` / `node:fs`. None of it is reachable from a
- * cloudflare-workers bundle.
- *
- * ai-web's plugin chain still loads localdb for shape uniformity per
- * `apps/ai-web (consolidated)/SPEC.md` line 14. This empty cloud variant satisfies
- * the chain without pulling consumer-only code into the cloud bundle.
- */
-import { createRuntimePlugin } from '@vibesdotdev/runtime';
-export default createRuntimePlugin({
-    // Same id as the consumer `localdb` plugin per AGENT-CONSTITUTION
-    // §PLUGIN ID PARITY: the bare id is the public capability.
-    id: 'localdb',
-    name: 'LocalDB (Cloud)',
-    description: 'Cloud-safe localdb registration — empty (localdb is consumer-only)'
-});
-//# sourceMappingURL=localdb.cloud.plugin.js.map

package/dist/localdb.cloud.plugin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"localdb.cloud.plugin.js","sourceRoot":"","sources":["../src/localdb.cloud.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,eAAe,mBAAmB,CAAC;IAClC,kEAAkE;IAClE,2DAA2D;IAC3D,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,oEAAoE;CACjF,CAAC,CAAC"}

package/src/cli/commands/_shared.consumer.ts

@@ -1,20 +0,0 @@
-import { resolve } from 'node:path';
-
-export const databasePathsByNamespace: Record<string, string> = {
-	atlas: '.vibes/atlas/vibes.db',
-	session: '.vibes/session/sessions.db'
-};
-
-export function resolveDatabasePathForNamespace(namespace: string): string | undefined {
-	return databasePathsByNamespace[namespace];
-}
-
-export function resolveFromCwd(p: string): string {
-	return resolve(process.cwd(), p);
-}
-
-export function formatAgeMs(ageMs: number): string {
-	const ageMin = Math.floor(ageMs / 60000);
-	const ageSec = Math.floor((ageMs % 60000) / 1000);
-	return ageMin > 0 ? `${ageMin}m ${ageSec}s` : `${ageSec}s`;
-}

package/src/cli/commands/migrate/dev.localdb.migrate.cli-command.descriptor.ts

@@ -1,20 +0,0 @@
-/**
- * Dev LocalDB Migrate CLI Command Descriptor
- */
-
-import { createRuntimeAsset } from '@vibesdotdev/runtime';
-
-export default createRuntimeAsset({
-	id: 'dev.localdb.migrate',
-	kind: 'cli/command',
-	name: 'migrate',
-	description: 'Run pending migrations',
-	group: 'dev.localdb',
-	surfaces: ['cli'],
-	hardware: ['consumer'],
-	enabled: true,
-	options: [
-		{ flags: '--namespace <name>', description: 'Run migrations for a specific namespace' },
-		{ flags: '--dry-run', description: 'Show pending migrations without applying them' }
-	]
-});

package/src/cli/commands/migrate/dev.localdb.migrate.cli-command.impl.consumer.ts

@@ -1,97 +0,0 @@
-import { existsSync } from 'node:fs';
-import { getVibesRuntime } from '@vibesdotdev/runtime';
-import { requestCLIExit, type UIContext } from '@vibesdotdev/cli/providers';
-import type { LocaldbApi, MigrationRegistryApi } from '../../..';
-import { resolveDatabasePathForNamespace, resolveFromCwd } from '../_shared.consumer';
-
-export default {
-	async execute(_args: Record<string, unknown>, opts: Record<string, unknown>): Promise<void> {
-		const runtime = getVibesRuntime();
-		const ui = (await runtime.context('cli/ui')) as UIContext;
-		const localdb = (await runtime.context('dev/localdb')) as LocaldbApi;
-
-		const namespaceOpt = typeof opts.namespace === 'string' ? opts.namespace : undefined;
-		const dryRun = Boolean(opts.dryRun);
-
-		ui.log(`\n=== LocalDB Migrate${dryRun ? ' (Dry Run)' : ''} ===\n`);
-
-		const namespaces = localdb.listNamespaces();
-		if (namespaces.length === 0) {
-			ui.info('No migration namespaces registered.');
-			return;
-		}
-
-		const namespacesToMigrate = namespaceOpt
-			? namespaces.filter((ns) => ns === namespaceOpt)
-			: namespaces;
-
-		if (namespacesToMigrate.length === 0) {
-			ui.error(`Namespace '${namespaceOpt}' not found.`);
-			ui.info(`Available namespaces: ${namespaces.join(', ')}`);
-			requestCLIExit(1);
-		}
-
-		const { migrationRegistry } =
-			(await import('../../../core/migration-registry')) as {
-				migrationRegistry: MigrationRegistryApi;
-			};
-
-		let migratedCount = 0;
-		let errorCount = 0;
-
-		for (const ns of namespacesToMigrate) {
-			const dbPath = resolveDatabasePathForNamespace(ns);
-			if (!dbPath) {
-				ui.warn(`Skipping '${ns}': no known database path`);
-				continue;
-			}
-
-			const fullPath = resolveFromCwd(dbPath);
-			if (!existsSync(fullPath)) {
-				ui.warn(`Skipping '${ns}': database not found (${dbPath})`);
-				continue;
-			}
-
-			ui.log(`\nNamespace: ${ns}`);
-			ui.log(`Database: ${dbPath}`);
-
-			try {
-				const db = localdb.getRawDatabase(fullPath, 'localdb-migrate');
-				const needsMigration = migrationRegistry.needsMigration(db, ns);
-
-				if (!needsMigration) {
-					ui.success('Already up to date');
-					continue;
-				}
-
-				const status = migrationRegistry.getDatabaseStatus(db, ns);
-				ui.log(
-					`Pending: ${status.pendingMigrations} migration(s) (v${status.currentVersion} → v${status.targetVersion})`
-				);
-
-				if (dryRun) {
-					ui.log('Would apply:');
-					for (const m of status.migrations) {
-						if (!m.applied) ui.log(`  • v${m.version}: ${m.name}`);
-					}
-				} else {
-					await migrationRegistry.runMigrations(db, ns);
-					ui.success('Migrations completed');
-					migratedCount++;
-				}
-			} catch (error) {
-				ui.error(`Error: ${String(error)}`);
-				errorCount++;
-			}
-		}
-
-		ui.log('\n' + '─'.repeat(50));
-		if (dryRun) {
-			ui.info(`Dry run complete. Checked ${namespacesToMigrate.length} namespace(s).`);
-		} else {
-			ui.info(`Migration complete: ${migratedCount} migrated, ${errorCount} errors`);
-		}
-
-		if (errorCount > 0) requestCLIExit(1);
-	}
-};

package/src/cli/commands/namespaces/dev.localdb.namespaces.cli-command.descriptor.ts

@@ -1,17 +0,0 @@
-/**
- * Dev LocalDB Namespaces CLI Command Descriptor
- */
-
-import { createRuntimeAsset } from '@vibesdotdev/runtime';
-
-export default createRuntimeAsset({
-	id: 'dev.localdb.namespaces',
-	kind: 'cli/command',
-	name: 'namespaces',
-	description: 'List registered migration namespaces',
-	group: 'dev.localdb',
-	surfaces: ['cli'],
-	hardware: ['consumer'],
-	enabled: true,
-	options: [{ flags: '--verbose', description: 'Show migration details for each namespace' }]
-});