@vibesdotdev/localdb 0.0.1

package/README.md

@@ -0,0 +1,121 @@
+# @vibesdotdev/localdb
+
+Local SQLite primitive for the vibes consumer-hardware toolkit. Owns the
+connection pool, namespace migration registry, recovery/trapdoor flow, and the
+`vibes dev localdb` CLI surface. Backed by `bun:sqlite`; server-runtime only.
+
+The contract lives in [`SPEC.md`](./SPEC.md). Operational status lives in
+[`PROD-CHECKLIST.md`](./PROD-CHECKLIST.md). This README is the developer
+quick-start.
+
+## Install
+
+Workspace-only:
+
+```jsonc
+// package.json
+{
+  "dependencies": {
+    "@vibesdotdev/localdb": "workspace:*",
+    "@vibesdotdev/runtime": "workspace:*"
+  }
+}
+```
+
+## Register migrations and open a database
+
+A domain module declares its migrations once and asks for its database by
+namespace + path. Migrations run on first `getDatabase()` for that
+`namespace:path`.
+
+```ts
+import { localdb, type Migration } from '@vibesdotdev/localdb';
+import type { Database } from 'bun:sqlite';
+
+const MY_MIGRATIONS: Migration[] = [
+  {
+    version: 1,
+    name: 'Create things table',
+    up: (db: Database) => {
+      db.exec(`
+        CREATE TABLE IF NOT EXISTS things (
+          id TEXT PRIMARY KEY,
+          created_at TEXT NOT NULL DEFAULT (datetime('now'))
+        )
+      `);
+    }
+  }
+];
+
+localdb.registerMigrations('my-module', MY_MIGRATIONS);
+
+const handle = await localdb.getDatabase(
+  'my-module',
+  '.vibes/my-module/state.db',
+  'my-module-storage'
+);
+
+const db = handle.getDatabase();
+db.query('INSERT INTO things (id) VALUES (?)').run('hello');
+```
+
+Migration versions must be `1..N` consecutive — registering out of order
+throws. Asking for an unregistered namespace throws. Migration failure
+triggers automatic recovery: the corrupted file is backed up
+(`*.bak-{ts}`, last 12 retained) and a fresh database is migrated from
+version 0.
+
+## Get a raw connection (no migrations)
+
+For quick read-only tools or one-off scripts that don't need version
+management, `getRawDatabase` returns a pooled `bun:sqlite.Database` directly:
+
+```ts
+import { localdb } from '@vibesdotdev/localdb';
+
+const raw = localdb.getRawDatabase('.vibes/scratch/log.db', 'log-reader');
+const rows = raw.query('SELECT * FROM events ORDER BY ts DESC LIMIT 100').all();
+```
+
+This bypasses the migration registry. Prefer `getDatabase()` for any
+schema-owning code.
+
+## CLI
+
+The package registers `vibes dev localdb` for inspecting state from a
+terminal:
+
+```sh
+vibes dev localdb status         # connection + migration status across namespaces
+vibes dev localdb namespaces     # registered migration namespaces
+vibes dev localdb pools          # connection pool statistics
+vibes dev localdb migrate <ns>   # run pending migrations for a namespace
+vibes dev localdb query <ns>     # raw SQL against a namespace database
+```
+
+Commands run on consumer hardware only.
+
+## What lives where
+
+- The `storage/adapter` impl `storage.localdb.core` →
+  [`@vibesdotdev/storage-adapter-localdb`](../storage-adapter-localdb/) (the
+  thin storage wrapper that consumes this package).
+- App and feature schemas / migration SQL → the owning package or app.
+  This package owns the SQLite *primitive*; it does not carry domain SQL.
+- Cloud / multi-tenant SQLite → use
+  [`@vibesdotdev/storage-adapter-drizzle`](../storage-adapter-drizzle/)
+  with libsql/Turso or D1.
+
+## Verification
+
+```sh
+bun test packages/localdb
+bun --bun tsc -p packages/localdb/tsconfig.json --noEmit
+```
+
+## Links
+
+- [SPEC.md](./SPEC.md) — package contract.
+- [storage](../storage/SPEC.md),
+  [storage-adapter-localdb](../storage-adapter-localdb/),
+  [storage-adapter-drizzle](../storage-adapter-drizzle/SPEC.md).

package/SPEC.md

@@ -0,0 +1,119 @@
+# @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/cli/commands/_shared.consumer.d.ts

@@ -0,0 +1,5 @@
+export declare const databasePathsByNamespace: Record<string, string>;
+export declare function resolveDatabasePathForNamespace(namespace: string): string | undefined;
+export declare function resolveFromCwd(p: string): string;
+export declare function formatAgeMs(ageMs: number): string;
+//# sourceMappingURL=_shared.consumer.d.ts.map

package/dist/cli/commands/_shared.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.consumer.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/_shared.consumer.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG3D,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErF;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD"}

package/dist/cli/commands/_shared.consumer.js

@@ -0,0 +1,17 @@
+import { resolve } from 'node:path';
+export const databasePathsByNamespace = {
+    atlas: '.vibes/atlas/vibes.db',
+    session: '.vibes/session/sessions.db'
+};
+export function resolveDatabasePathForNamespace(namespace) {
+    return databasePathsByNamespace[namespace];
+}
+export function resolveFromCwd(p) {
+    return resolve(process.cwd(), p);
+}
+export function formatAgeMs(ageMs) {
+    const ageMin = Math.floor(ageMs / 60000);
+    const ageSec = Math.floor((ageMs % 60000) / 1000);
+    return ageMin > 0 ? `${ageMin}m ${ageSec}s` : `${ageSec}s`;
+}
+//# sourceMappingURL=_shared.consumer.js.map

package/dist/cli/commands/_shared.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.consumer.js","sourceRoot":"","sources":["../../../src/cli/commands/_shared.consumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,MAAM,wBAAwB,GAA2B;IAC/D,KAAK,EAAE,uBAAuB;IAC9B,OAAO,EAAE,4BAA4B;CACrC,CAAC;AAEF,MAAM,UAAU,+BAA+B,CAAC,SAAiB;IAChE,OAAO,wBAAwB,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAS;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAClD,OAAO,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC;AAC5D,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * Dev LocalDB Migrate CLI Command Descriptor
+ */
+declare const _default: {
+    id: string;
+    kind: "cli/command";
+    name: string;
+    description: string;
+    group: string;
+    surfaces: string[];
+    hardware: string[];
+    enabled: true;
+    options: {
+        flags: string;
+        description: string;
+    }[];
+};
+export default _default;
+//# sourceMappingURL=dev.localdb.migrate.cli-command.descriptor.d.ts.map

package/dist/cli/commands/migrate/dev.localdb.migrate.cli-command.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.localdb.migrate.cli-command.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/migrate/dev.localdb.migrate.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;;;;;;;;;;;;;;;AAIH,wBAaG"}

package/dist/cli/commands/migrate/dev.localdb.migrate.cli-command.descriptor.js

@@ -0,0 +1,19 @@
+/**
+ * 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' }
+    ]
+});
+//# sourceMappingURL=dev.localdb.migrate.cli-command.descriptor.js.map

package/dist/cli/commands/migrate/dev.localdb.migrate.cli-command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.localdb.migrate.cli-command.descriptor.js","sourceRoot":"","sources":["../../../../src/cli/commands/migrate/dev.localdb.migrate.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,eAAe,kBAAkB,CAAC;IACjC,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,wBAAwB;IACrC,KAAK,EAAE,aAAa;IACpB,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;IACb,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,yCAAyC,EAAE;QACvF,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,+CAA+C,EAAE;KACpF;CACD,CAAC,CAAC"}

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

@@ -0,0 +1,5 @@
+declare const _default: {
+    execute(_args: Record<string, unknown>, opts: Record<string, unknown>): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=dev.localdb.migrate.cli-command.impl.consumer.d.ts.map

package/dist/cli/commands/migrate/dev.localdb.migrate.cli-command.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.localdb.migrate.cli-command.impl.consumer.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/migrate/dev.localdb.migrate.cli-command.impl.consumer.ts"],"names":[],"mappings":";mBAOsB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;;AAD5F,wBA0FE"}

package/dist/cli/commands/migrate/dev.localdb.migrate.cli-command.impl.consumer.js

@@ -0,0 +1,80 @@
+import { existsSync } from 'node:fs';
+import { getVibesRuntime } from '@vibesdotdev/runtime';
+import { requestCLIExit } from '@vibesdotdev/cli/providers';
+import { resolveDatabasePathForNamespace, resolveFromCwd } from '../_shared.consumer';
+export default {
+    async execute(_args, opts) {
+        const runtime = getVibesRuntime();
+        const ui = (await runtime.context('cli/ui'));
+        const localdb = (await runtime.context('dev/localdb'));
+        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'));
+        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);
+    }
+};
+//# sourceMappingURL=dev.localdb.migrate.cli-command.impl.consumer.js.map

package/dist/cli/commands/migrate/dev.localdb.migrate.cli-command.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.localdb.migrate.cli-command.impl.consumer.js","sourceRoot":"","sources":["../../../../src/cli/commands/migrate/dev.localdb.migrate.cli-command.impl.consumer.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,19 @@
+/**
+ * Dev LocalDB Namespaces CLI Command Descriptor
+ */
+declare const _default: {
+    id: string;
+    kind: "cli/command";
+    name: string;
+    description: string;
+    group: string;
+    surfaces: string[];
+    hardware: string[];
+    enabled: true;
+    options: {
+        flags: string;
+        description: string;
+    }[];
+};
+export default _default;
+//# sourceMappingURL=dev.localdb.namespaces.cli-command.descriptor.d.ts.map

package/dist/cli/commands/namespaces/dev.localdb.namespaces.cli-command.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.localdb.namespaces.cli-command.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/namespaces/dev.localdb.namespaces.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;;;;;;;;;;;;;;;AAIH,wBAUG"}

package/dist/cli/commands/namespaces/dev.localdb.namespaces.cli-command.descriptor.js

@@ -0,0 +1,16 @@
+/**
+ * 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' }]
+});
+//# sourceMappingURL=dev.localdb.namespaces.cli-command.descriptor.js.map

package/dist/cli/commands/namespaces/dev.localdb.namespaces.cli-command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.localdb.namespaces.cli-command.descriptor.js","sourceRoot":"","sources":["../../../../src/cli/commands/namespaces/dev.localdb.namespaces.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,eAAe,kBAAkB,CAAC;IACjC,EAAE,EAAE,wBAAwB;IAC5B,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,sCAAsC;IACnD,KAAK,EAAE,aAAa;IACpB,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC;CAC3F,CAAC,CAAC"}

package/dist/cli/commands/namespaces/dev.localdb.namespaces.cli-command.impl.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    execute(_args: Record<string, unknown>, opts: Record<string, unknown>): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=dev.localdb.namespaces.cli-command.impl.d.ts.map

package/dist/cli/commands/namespaces/dev.localdb.namespaces.cli-command.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.localdb.namespaces.cli-command.impl.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/namespaces/dev.localdb.namespaces.cli-command.impl.ts"],"names":[],"mappings":";mBAKsB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;;AAD5F,wBAyCE"}

package/dist/cli/commands/namespaces/dev.localdb.namespaces.cli-command.impl.js

@@ -0,0 +1,33 @@
+import { getVibesRuntime } from '@vibesdotdev/runtime';
+export default {
+    async execute(_args, opts) {
+        const runtime = getVibesRuntime();
+        const ui = (await runtime.context('cli/ui'));
+        const localdb = (await runtime.context('dev/localdb'));
+        const verbose = Boolean(opts.verbose);
+        ui.log('\n=== Registered Migration Namespaces ===\n');
+        const namespaces = localdb.listNamespaces();
+        if (namespaces.length === 0) {
+            ui.info('No migration namespaces registered.');
+            ui.info('Namespaces are registered when their modules are loaded.');
+            ui.info('Try running a command that uses the database first.');
+            return;
+        }
+        if (!verbose) {
+            ui.table(namespaces.map((ns) => ({ namespace: ns })));
+            ui.info('\nUse --verbose to see migration details\n');
+            return;
+        }
+        const { migrationRegistry } = (await import('../../../core/migration-registry.js'));
+        for (const ns of namespaces) {
+            ui.log(`\nNamespace: ${ns}`);
+            const migrations = migrationRegistry.getMigrations(ns);
+            ui.log(`Migrations: ${migrations.length}`);
+            for (const m of migrations) {
+                ui.log(`  • v${m.version}: ${m.name}${m.down ? ' (reversible)' : ''}`);
+            }
+        }
+        ui.log('\n');
+    }
+};
+//# sourceMappingURL=dev.localdb.namespaces.cli-command.impl.js.map

package/dist/cli/commands/namespaces/dev.localdb.namespaces.cli-command.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.localdb.namespaces.cli-command.impl.js","sourceRoot":"","sources":["../../../../src/cli/commands/namespaces/dev.localdb.namespaces.cli-command.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAIvD,eAAe;IACd,KAAK,CAAC,OAAO,CAAC,KAA8B,EAAE,IAA6B;QAC1E,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAc,CAAC;QAC1D,MAAM,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAe,CAAC;QAErE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEtC,EAAE,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;QAEtD,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;QAC5C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,EAAE,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;YAC/C,EAAE,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;YACpE,EAAE,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;YAC/D,OAAO;QACR,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YACtD,EAAE,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;YACtD,OAAO;QACR,CAAC;QAED,MAAM,EAAE,iBAAiB,EAAE,GAC1B,CAAC,MAAM,MAAM,CAAC,kCAAkC,CAAC,CAEhD,CAAC;QAEH,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC7B,EAAE,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;YAC7B,MAAM,UAAU,GAAG,iBAAiB,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YACvD,EAAE,CAAC,GAAG,CAAC,eAAe,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAE3C,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;gBAC5B,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxE,CAAC;QACF,CAAC;QAED,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;CACD,CAAC"}

package/dist/cli/commands/pools/dev.localdb.pools.cli-command.descriptor.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Dev LocalDB Pools CLI Command Descriptor
+ */
+declare const _default: {
+    id: string;
+    kind: "cli/command";
+    name: string;
+    description: string;
+    group: string;
+    surfaces: string[];
+    hardware: string[];
+    enabled: true;
+};
+export default _default;
+//# sourceMappingURL=dev.localdb.pools.cli-command.descriptor.d.ts.map

package/dist/cli/commands/pools/dev.localdb.pools.cli-command.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.localdb.pools.cli-command.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/pools/dev.localdb.pools.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;;;;;;;;;;;AAIH,wBASG"}

package/dist/cli/commands/pools/dev.localdb.pools.cli-command.descriptor.js

@@ -0,0 +1,15 @@
+/**
+ * Dev LocalDB Pools CLI Command Descriptor
+ */
+import { createRuntimeAsset } from '@vibesdotdev/runtime';
+export default createRuntimeAsset({
+    id: 'dev.localdb.pools',
+    kind: 'cli/command',
+    name: 'pools',
+    description: 'Show connection pool statistics',
+    group: 'dev.localdb',
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+});
+//# sourceMappingURL=dev.localdb.pools.cli-command.descriptor.js.map

package/dist/cli/commands/pools/dev.localdb.pools.cli-command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.localdb.pools.cli-command.descriptor.js","sourceRoot":"","sources":["../../../../src/cli/commands/pools/dev.localdb.pools.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,eAAe,kBAAkB,CAAC;IACjC,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,iCAAiC;IAC9C,KAAK,EAAE,aAAa;IACpB,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC,CAAC"}

package/dist/cli/commands/pools/dev.localdb.pools.cli-command.impl.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    execute(_args: Record<string, unknown>, _opts: Record<string, unknown>): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=dev.localdb.pools.cli-command.impl.d.ts.map

package/dist/cli/commands/pools/dev.localdb.pools.cli-command.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.localdb.pools.cli-command.impl.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/pools/dev.localdb.pools.cli-command.impl.ts"],"names":[],"mappings":";mBAMsB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;;AAD7F,wBA+BE"}

package/dist/cli/commands/pools/dev.localdb.pools.cli-command.impl.js

@@ -0,0 +1,28 @@
+import { getVibesRuntime } from '@vibesdotdev/runtime';
+import { formatAgeMs } from '../_shared.consumer.js';
+export default {
+    async execute(_args, _opts) {
+        const runtime = getVibesRuntime();
+        const ui = (await runtime.context('cli/ui'));
+        const localdb = (await runtime.context('dev/localdb'));
+        ui.log('\n=== Connection Pool Statistics ===\n');
+        const stats = localdb.getPoolStats();
+        ui.log(`Total Connections: ${stats.total}`);
+        ui.log(`Active (in use):   ${stats.active}`);
+        ui.log(`Idle (pooled):     ${stats.idle}`);
+        if (stats.connections.length === 0) {
+            ui.info('\nNo active connections.\n');
+            return;
+        }
+        ui.log('\nConnections:\n' + '─'.repeat(80));
+        ui.table(stats.connections.map((c) => ({
+            path: c.path,
+            status: c.refCount > 0 ? 'ACTIVE' : 'IDLE',
+            refs: c.refCount,
+            age: formatAgeMs(c.ageMs),
+            consumer: c.consumer
+        })));
+        ui.log('');
+    }
+};
+//# sourceMappingURL=dev.localdb.pools.cli-command.impl.js.map

package/dist/cli/commands/pools/dev.localdb.pools.cli-command.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.localdb.pools.cli-command.impl.js","sourceRoot":"","sources":["../../../../src/cli/commands/pools/dev.localdb.pools.cli-command.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,eAAe;IACd,KAAK,CAAC,OAAO,CAAC,KAA8B,EAAE,KAA8B;QAC3E,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAc,CAAC;QAC1D,MAAM,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAe,CAAC;QAErE,EAAE,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QAEjD,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;QAErC,EAAE,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5C,EAAE,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7C,EAAE,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAE3C,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,EAAE,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YACtC,OAAO;QACR,CAAC;QAED,EAAE,CAAC,GAAG,CAAC,kBAAkB,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5C,EAAE,CAAC,KAAK,CACP,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;YAC1C,IAAI,EAAE,CAAC,CAAC,QAAQ;YAChB,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC;YACzB,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACpB,CAAC,CAAC,CACH,CAAC;QACF,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACZ,CAAC;CACD,CAAC"}

package/dist/cli/commands/query/dev.localdb.query.cli-command.descriptor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Dev LocalDB Query CLI Command Descriptor
+ */
+declare const _default: {
+    id: string;
+    kind: "cli/command";
+    name: string;
+    description: string;
+    group: string;
+    surfaces: string[];
+    hardware: string[];
+    enabled: true;
+    arguments: {
+        name: string;
+        description: string;
+        required: boolean;
+    }[];
+    options: {
+        flags: string;
+        description: string;
+    }[];
+};
+export default _default;
+//# sourceMappingURL=dev.localdb.query.cli-command.descriptor.d.ts.map

package/dist/cli/commands/query/dev.localdb.query.cli-command.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.localdb.query.cli-command.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/query/dev.localdb.query.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;AAIH,wBAcG"}