@vibesdotdev/storage 0.0.1

package/README.md

@@ -0,0 +1,75 @@
+# @vibesdotdev/storage
+
+Universal storage primitive. Defines `storage/manifest` and `storage/adapter`
+runtime kinds, the `StorageManifest<T>` base, and the sync/policy/record
+abstractions. Adapters live in sibling packages and register themselves.
+
+## Quickstart
+
+### Define a storage manifest
+
+```ts
+import { z } from 'zod';
+import { createStorageManifest } from '@vibesdotdev/storage/manifest';
+
+export const sessions = createStorageManifest({
+  id: 'auth.sessions',
+  namespace: 'auth',
+  schema: z.object({
+    id: z.string(),
+    userId: z.string(),
+    expiresAt: z.string().datetime(),
+  }),
+  adapters: ['localdb', 'cloud-api'],
+});
+```
+
+### Load + save through the runtime
+
+```ts
+import { StorageManifest } from '@vibesdotdev/storage';
+
+const sessions = new StorageManifest('auth.sessions');
+await sessions.put({ id: 's1', userId: 'u1', expiresAt: '2026-12-31T00:00:00Z' });
+const session = await sessions.get('s1');
+```
+
+The runtime selects the adapter (`localdb` consumer-side, `cloud-api`
+cloud-side) based on scope. Feature code never branches on hardware.
+
+### Sync (local-first)
+
+When sync is enabled in runtime config, consumer writes mirror to the cloud
+adapter via `cloud-sync.consumer`. Sync state is tracked in a separate
+manifest so divergent writes are reconciled rather than silently merged.
+
+## Adapters
+
+Storage core ships zero adapter implementations. Apps load the adapter
+packages their scope can support:
+
+- [`@vibesdotdev/storage-adapter-memory`](../storage-adapter-memory/) — tests/ephemeral
+- [`@vibesdotdev/storage-adapter-json`](../storage-adapter-json/) — local file-backed
+- [`@vibesdotdev/storage-adapter-localdb`](../storage-adapter-localdb/) — SQLite (Bun)
+- [`@vibesdotdev/storage-adapter-cloud-api`](../storage-adapter-cloud-api/) — hosted
+- [`@vibesdotdev/storage-adapter-drizzle`](../storage-adapter-drizzle/) — SQL via Drizzle
+- External integrations (SharePoint, etc.) → [`platform`](../platform/SPEC.md)
+
+## CLI
+
+```bash
+vibes storage list
+vibes storage status
+vibes storage sync run
+```
+
+## Test
+
+```bash
+bun run test
+```
+
+## Docs
+
+- [SPEC.md](./SPEC.md) — package contract, owned surfaces, hard rules
+- [runtime](../runtime/SPEC.md), [config](../config/SPEC.md)

package/SPEC.md

@@ -0,0 +1,60 @@
+# @vibesdotdev/storage
+
+Runtime-resolved persistence. Universal core: defines the kinds, manifest base, sync/policy/record abstractions. Adapters live in sibling packages and register themselves.
+
+## Owns
+
+- **Runtime kinds:**
+  - `storage/adapter` — storage backends (impls live in sibling adapter packages). Descriptors carry a coarse-grained `capabilities: ('list'|'read'|'write'|'browse')[]` array (default `['read','write']`); adapters declaring `'browse'` implement `listDrives() → StorageDrive[]` + `list(driveId, path) → StorageEntry[]`.
+  - `storage/manifest` — storable data type definitions; default impl `StorageManifest`
+  - `storage/record` — single-table CRUD with relations, indexes, FTS, migrations, computed fields, hierarchy, and side effects
+  - `storage/sync-bridge` — declarative runtime-kind ↔ cloud-CRUD sync wiring (server/CLI only; no default impl)
+- **`StorageManifest<T>`** (`./manifest`): base manifest, source-policy, cloud-sync handoff (`cloud-sync.consumer` — universal; uses runtime to resolve cloud adapter)
+- **Interfaces** (`./interfaces`): adapter, document-store, key-value, repository, record, schema, and `StorageConsumerFs` TS contracts. `StorageAdapterInterface` declares optional `listDrives()` and `list(driveId, path)` methods for `browse`-capable adapters.
+- **Schemas** (`./schemas`): Zod schemas for adapter / manifest / record / schema / sync-bridge descriptors, plus the rich record-descriptor surface (relations, indexes, FTS, migrations, computed fields, hierarchy, side effects) and the multi-table `StorageSchemaDescriptor`. Also exports `StorageEntrySchema`, `StorageDriveSchema`, and `StorageCapabilitySchema` for use by browse-capable adapters and consumers.
+- **Client surface** (`./client`): `listBrowsableStorageAdapters()` — synchronous helper that queries the runtime for every `storage/adapter` descriptor with `'browse'` in `capabilities`. Consumed by picker UIs (AI model sources, knowledge corpora, etc.). Does not load implementations.
+- **Record events** (`./record/events`): `storage.record.afterCreate`, `storage.record.afterUpdate`, `storage.record.afterDelete` — registered as descriptors by the plugin
+- **Sync** (`./sync`): sync-bridge, record-sync-bridge, cloud-pull, sync-manifest, sync-state, resolve-sync-target — all runtime-resolved, no adapter imports
+- **Policy** (`./policy`): storage policy / overrides / persistence / context / types, plus `storage-policy.context.descriptor` (universal descriptor) and `storage-policy.context.server` (server-side loader; registered via plugin `onRegister`)
+- **Record** (`./record`): base record class (`StorageRecord`), events, extensions
+- **Resolver** (`./resolver/storage-backed-resolver`): resolves arbitrary kinds whose data lives in either a `storage/manifest` or a `config/manifest`
+- **Bridge** (`./bridge`): `storage-kind-bridge` + `bridgeStorageKinds` helper that hydrates feature kinds from their backing storage manifests
+- **CLI** (`./cli`): `vibes storage` and `vibes storage sync` groups; commands `storage list`, `storage sync pull`, `storage sync push`, `storage sync status`, `storage sync resolve` — all query the runtime, never import adapters
+- **TUI** (`./tui`): `storage.explorer` (`tui/app`) and `storage.open` (`tui/command`) — registered conditionally by plugin `onRegister` when the `tui/*` kinds are loaded
+- **Daemon commands** (`./daemon/commands`): storage RPC verbs `sync.status`, `sync.trigger`, `sync.resolve` using runtime-plugin types, self-contained implementations
+- **Paths** (`./paths`): canonical storage path resolution (string-only, no FS)
+- **Plugin** (`./storage.plugin` = `./plugin`): registers the four runtime kinds, the CLI groups + commands, and the record-event descriptors. `onRegister` additionally wires the storage-policy context loader and (when `tui/app` / `tui/command` are present) the TUI explorer + open implementations.
+
+## Does not own
+
+- **Adapter implementations.** Each adapter is its own package: [`storage-adapter-json`](../storage-adapter-json/), [`storage-adapter-localdb`](../storage-adapter-localdb/), [`storage-adapter-memory`](../storage-adapter-memory/), [`storage-adapter-cloud-api`](../storage-adapter-cloud-api/), [`storage-adapter-drizzle`](../storage-adapter-drizzle/). They each register `storage/adapter` descriptors when imported.
+- **External-integration adapters** (SharePoint, etc.) → the owning integration package (e.g. [`integrations-microsoft`](../integrations-microsoft/SPEC.md) registers the `sharepoint` adapter alongside the Microsoft 365 integration providers).
+- **Server DB connection helper.** Lives in [`storage-adapter-drizzle`](../storage-adapter-drizzle/SPEC.md) (`./db` subpath), co-located with the Drizzle persistence factory.
+- **Encryption primitive** → [`config/services`](../config/SPEC.md). Encrypted adapters consume it.
+- **Configuration modeling** → [`config`](../config/SPEC.md).
+- **Domain-specific manifests** (chat history, AI artifacts, knowledge sources, account tables, etc.). Each owning module declares its own `storage/manifest` descriptors.
+- **Module-level client** (`runtime/client`). Storage is consumed via `StorageManifest<T>` instances and runtime kind resolution directly.
+
+## Hard rules
+
+- **The core package is universal.** No Node/Bun/SQL/HTTP imports in core. Anything that breaks browser or Cloudflare bundles belongs in an adapter package.
+- **All persistence goes through `StorageManifest<T>`.** No direct adapter calls in features.
+- **Adapter selection is runtime-resolved.** Manifests declare allowed adapters; runtime picks one via scope (`hardware`, `qualifiers: { storage }`). Features do not branch on `isCloud`/`connectionMode`.
+- **Local-first writes can mirror to cloud** when sync is enabled. Sync state is tracked separately; do not silently merge divergent writes.
+- **Adapter package contract:** each `storage-adapter-{name}` package exports a plugin that registers a `storage/adapter` descriptor + impl. Apps load the adapter packages their scope can support. The core never imports adapter packages.
+- **CLI / TUI / daemon descriptors here query the runtime; they do not import adapters.**
+
+## Public entrypoints
+
+Canonical entrypoints: `.`, `./manifest`, `./manifest/*`, `./interfaces`, `./interfaces/record`, `./interfaces/schema`, `./interfaces/*`, `./schemas`, `./schemas/record`, `./schemas/schema`, `./schemas/*`, `./sync`, `./sync/*`, `./record`, `./record/base`, `./record/*`, `./bridge`, `./bridge/types`, `./client`, `./client/*`, `./resolver/*`, `./cli/*`, `./tui/*`, `./daemon/commands/*`, `./paths`, `./plugin` (= `./storage.plugin`).
+
+## Verification
+
+`bun run test` from package root (runs `test:isolated` + `test:main`). Covers manifest base, sync state + bridge, policy, record, resolver, schemas, interfaces, and TUI descriptors. Adapter-specific tests live in each adapter package.
+
+## Links
+
+- [runtime/SPEC.md](../runtime/SPEC.md)
+- [config/SPEC.md](../config/SPEC.md)
+- [storage-adapter-drizzle](../storage-adapter-drizzle/)
+- [platform/SPEC.md](../platform/SPEC.md)

package/dist/adapters/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Storage Adapters
+ *
+ * Concrete adapter implementations are resolved through the vibes runtime.
+ * Feature packages must NEVER import adapter packages directly.
+ *
+ * Adapters register themselves via runtime plugins; consumers query them
+ * through `runtime.query('storage/adapter')` or use the StorageManifest
+ * abstraction which handles adapter resolution internally.
+ *
+ * External integrations (SharePoint, etc.) live in their owning integration
+ * package (e.g. `@vibesdotdev/integrations-microsoft/sharepoint`).
+ */
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/adapters/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Storage Adapters
+ *
+ * Concrete adapter implementations are resolved through the vibes runtime.
+ * Feature packages must NEVER import adapter packages directly.
+ *
+ * Adapters register themselves via runtime plugins; consumers query them
+ * through `runtime.query('storage/adapter')` or use the StorageManifest
+ * abstraction which handles adapter resolution internally.
+ *
+ * External integrations (SharePoint, etc.) live in their owning integration
+ * package (e.g. `@vibesdotdev/integrations-microsoft/sharepoint`).
+ */
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG"}

package/dist/bridge/index.d.ts

@@ -0,0 +1,3 @@
+export { bridgeStorageKinds } from './storage-kind-bridge';
+export type { StorageKindBridgeConfig } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/bridge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC"}

package/dist/bridge/index.js

@@ -0,0 +1,2 @@
+export { bridgeStorageKinds } from './storage-kind-bridge.js';
+//# sourceMappingURL=index.js.map

package/dist/bridge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/bridge/storage-kind-bridge.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Storage Kind Bridge
+ *
+ * Hydrates runtime kind registries from storage manifest data.
+ * Storage manifests that declare `providesRuntimeKinds` will have their
+ * stored items loaded and registered as runtime descriptors (and optionally
+ * implementation loaders) so they are discoverable via `runtime.query()`.
+ *
+ * This runs at boot after discovery completes and storage adapters are available.
+ */
+import type { VibesRuntime } from '@vibesdotdev/runtime/api/runtime';
+/**
+ * Bridge storage manifest items into runtime kind registries.
+ *
+ * For each storage manifest with `providesRuntimeKinds`:
+ * 1. Loads stored data via the manifest's resolved adapter
+ * 2. Transforms each item into a runtime descriptor
+ * 3. Registers the descriptor (makes it queryable)
+ * 4. Optionally registers an implementation loader
+ *
+ * @returns Count of bridged items and any errors encountered
+ */
+export declare function bridgeStorageKinds(runtime: VibesRuntime): Promise<{
+    bridged: number;
+    errors: string[];
+}>;
+//# sourceMappingURL=storage-kind-bridge.d.ts.map

package/dist/bridge/storage-kind-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-kind-bridge.d.ts","sourceRoot":"","sources":["../../src/bridge/storage-kind-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAMrE;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAoGhD"}

package/dist/bridge/storage-kind-bridge.js

@@ -0,0 +1,110 @@
+/**
+ * Storage Kind Bridge
+ *
+ * Hydrates runtime kind registries from storage manifest data.
+ * Storage manifests that declare `providesRuntimeKinds` will have their
+ * stored items loaded and registered as runtime descriptors (and optionally
+ * implementation loaders) so they are discoverable via `runtime.query()`.
+ *
+ * This runs at boot after discovery completes and storage adapters are available.
+ */
+import { StorageManifest } from '../manifest/base.js';
+import { createTracer } from '@vibesdotdev/runtime/debug';
+/**
+ * Bridge storage manifest items into runtime kind registries.
+ *
+ * For each storage manifest with `providesRuntimeKinds`:
+ * 1. Loads stored data via the manifest's resolved adapter
+ * 2. Transforms each item into a runtime descriptor
+ * 3. Registers the descriptor (makes it queryable)
+ * 4. Optionally registers an implementation loader
+ *
+ * @returns Count of bridged items and any errors encountered
+ */
+export async function bridgeStorageKinds(runtime) {
+    const bridgeTracer = createTracer('bridgeStorageKinds');
+    bridgeTracer.start();
+    if (!runtime.hasKind('storage/manifest')) {
+        bridgeTracer.end('no storage/manifest kind');
+        return { bridged: 0, errors: [] };
+    }
+    const manifests = runtime.assets('storage/manifest').descriptors();
+    let bridged = 0;
+    const errors = [];
+    // Process manifests in parallel to reduce I/O wait time
+    const manifestPromises = manifests.map(async (manifest) => {
+        const storageManifest = manifest;
+        const bridgeConfig = storageManifest.providesRuntimeKinds;
+        if (!bridgeConfig)
+            return { bridged: 0, errors: [] };
+        const manifestTracer = createTracer(`manifest:${manifest.id}`);
+        manifestTracer.start();
+        let items;
+        try {
+            const storage = StorageManifest.fromId(manifest.id);
+            const data = await storage.load();
+            if (!data) {
+                manifestTracer.end('no data');
+                return { bridged: 0, errors: [] };
+            }
+            if (Array.isArray(data)) {
+                items = data;
+            }
+            else if (typeof data === 'object' && data !== null) {
+                // Record/object storage: extract values as individual items
+                items = Object.values(data);
+            }
+            else {
+                items = [data];
+            }
+            manifestTracer.end(`loaded ${items.length} items`);
+        }
+        catch (err) {
+            manifestTracer.end('failed');
+            return {
+                bridged: 0,
+                errors: [
+                    `Failed to load storage '${manifest.id}': ${err instanceof Error ? err.message : String(err)}`
+                ]
+            };
+        }
+        let manifestBridged = 0;
+        const manifestErrors = [];
+        for (const [kindId, rawConfig] of Object.entries(bridgeConfig)) {
+            if (!runtime.hasKind(kindId)) {
+                manifestErrors.push(`Storage '${manifest.id}' declares providesRuntimeKinds for unregistered kind '${kindId}'`);
+                continue;
+            }
+            const config = rawConfig;
+            for (const item of items) {
+                try {
+                    if (config.filter && !config.filter(item))
+                        continue;
+                    const descriptor = config.toDescriptor(item);
+                    runtime.registerDescriptor(kindId, descriptor);
+                    if (config.implementation) {
+                        const ImplClass = config.implementation;
+                        runtime.registerLoader(kindId, descriptor.id, async () => ({
+                            meta: { id: descriptor.id, kind: kindId, priority: 0 },
+                            impl: ImplClass
+                        }));
+                    }
+                    manifestBridged++;
+                }
+                catch (err) {
+                    manifestErrors.push(`Failed to bridge item from '${manifest.id}' to '${kindId}': ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        }
+        return { bridged: manifestBridged, errors: manifestErrors };
+    });
+    // Wait for all manifest processing to complete
+    const results = await Promise.all(manifestPromises);
+    for (const result of results) {
+        bridged += result.bridged;
+        errors.push(...result.errors);
+    }
+    bridgeTracer.end(`bridged ${bridged} items`);
+    return { bridged, errors };
+}
+//# sourceMappingURL=storage-kind-bridge.js.map

package/dist/bridge/storage-kind-bridge.js.map

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

package/dist/bridge/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Storage Kind Bridge Types
+ *
+ * Type-safe configuration for bridging storage manifest items
+ * into runtime kind queries.
+ */
+import type { RuntimeDescriptor } from '@vibesdotdev/runtime/schemas/descriptor';
+/**
+ * Configuration for bridging stored items to a runtime kind.
+ *
+ * Declared on a StorageManifestDescriptor via `providesRuntimeKinds`.
+ * The bridge utility reads this config to register descriptors and
+ * optional implementation loaders with the runtime.
+ *
+ * @template TStored - The shape of individual stored items
+ *
+ * @example
+ * ```ts
+ * const config: StorageKindBridgeConfig<AgentConfig> = {
+ *   toDescriptor: (item) => createAIAgentDescriptor({ ... }),
+ *   implementation: ReactAgent,
+ *   filter: (item) => item.enabled !== false
+ * };
+ * ```
+ */
+export interface StorageKindBridgeConfig<TStored = unknown> {
+    /** Transform a stored item into a runtime descriptor for this kind */
+    toDescriptor: (item: TStored) => RuntimeDescriptor;
+    /**
+     * Implementation class to register as a loader.
+     * If provided, the runtime will instantiate it with (descriptor, context)
+     * when the asset is resolved. If omitted, the kind's defaultImplementation
+     * is used instead.
+     */
+    implementation?: new (descriptor: RuntimeDescriptor, context: {
+        runtime: unknown;
+    }) => unknown;
+    /**
+     * Filter which stored items to bridge.
+     * Return true to include the item, false to skip.
+     * If omitted, all items are bridged.
+     */
+    filter?: (item: TStored) => boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/bridge/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAEjF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,uBAAuB,CAAC,OAAO,GAAG,OAAO;IACzD,sEAAsE;IACtE,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,iBAAiB,CAAC;IAEnD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,KAAK,UAAU,EAAE,iBAAiB,EAAE,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC;IAE/F;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;CACpC"}

package/dist/bridge/types.js

@@ -0,0 +1,8 @@
+/**
+ * Storage Kind Bridge Types
+ *
+ * Type-safe configuration for bridging storage manifest items
+ * into runtime kind queries.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/bridge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/cli/commands/list/storage.list.cli-command.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { CLICommandAssetDescriptor } from '@vibesdotdev/runtime/schemas/asset';
+declare const descriptor: CLICommandAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=storage.list.cli-command.descriptor.d.ts.map

package/dist/cli/commands/list/storage.list.cli-command.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.list.cli-command.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/list/storage.list.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAEpF,QAAA,MAAM,UAAU,EAAE,yBAejB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/commands/list/storage.list.cli-command.descriptor.js

@@ -0,0 +1,18 @@
+const descriptor = {
+    kind: 'cli/command',
+    id: 'storage.list',
+    name: 'list',
+    description: 'List all registered storage manifests',
+    group: 'storage',
+    arguments: [],
+    options: [
+        { flags: '--json', description: 'Output as JSON' },
+        { flags: '--sync-only', description: 'Only show manifests with cloud sync enabled' }
+    ],
+    aliases: ['ls'],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=storage.list.cli-command.descriptor.js.map

package/dist/cli/commands/list/storage.list.cli-command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.list.cli-command.descriptor.js","sourceRoot":"","sources":["../../../../src/cli/commands/list/storage.list.cli-command.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,uCAAuC;IACpD,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,EAAE;IACb,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;QAClD,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,6CAA6C,EAAE;KACpF;IACD,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/commands/list/storage.list.cli-command.impl.d.ts

@@ -0,0 +1,11 @@
+/**
+ * vibes storage list
+ *
+ * Lists all registered storage manifests with their adapter configuration,
+ * custom table status, and sync eligibility.
+ */
+declare const _default: {
+    execute(_args: Record<string, unknown>, opts: Record<string, unknown>): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=storage.list.cli-command.impl.d.ts.map

package/dist/cli/commands/list/storage.list.cli-command.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.list.cli-command.impl.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/list/storage.list.cli-command.impl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;mBAiBmB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;;AAD5F,wBAkDE"}

package/dist/cli/commands/list/storage.list.cli-command.impl.js

@@ -0,0 +1,48 @@
+/**
+ * vibes storage list
+ *
+ * Lists all registered storage manifests with their adapter configuration,
+ * custom table status, and sync eligibility.
+ */
+import { getVibesRuntime } from '@vibesdotdev/runtime';
+export default {
+    async execute(_args, opts) {
+        const runtime = getVibesRuntime();
+        const ui = (await runtime.context('cli/ui'));
+        try {
+            const descriptors = runtime.query('storage/manifest').descriptors();
+            let manifests = descriptors.filter((d) => d.enabled !== false);
+            if (opts.syncOnly) {
+                manifests = manifests.filter((d) => d.allowedAdapters?.includes('storage.cloud-api'));
+            }
+            if (opts.json) {
+                ui.render(manifests.map((d) => ({
+                    id: d.id,
+                    namespace: d.namespace,
+                    defaultAdapter: d.defaultAdapter,
+                    customTables: d.customTables ?? false,
+                    syncEnabled: d.allowedAdapters?.includes('storage.cloud-api') ?? false,
+                    scope: d.scope ?? 'global'
+                })), { format: 'json' });
+                return;
+            }
+            if (manifests.length === 0) {
+                ui.info('No storage manifests registered.');
+                return;
+            }
+            ui.table(manifests.map((d) => ({
+                ID: d.id,
+                Namespace: d.namespace,
+                Adapter: d.defaultAdapter ?? '—',
+                'Custom Tables': d.customTables ? 'yes' : 'no',
+                'Cloud Sync': d.allowedAdapters?.includes('storage.cloud-api') ? 'yes' : 'no',
+                Scope: d.scope ?? 'global'
+            })), ['ID', 'Namespace', 'Adapter', 'Custom Tables', 'Cloud Sync', 'Scope']);
+        }
+        catch (e) {
+            ui.error(`Failed to list manifests: ${e}`);
+            process.exit(1);
+        }
+    }
+};
+//# sourceMappingURL=storage.list.cli-command.impl.js.map

package/dist/cli/commands/list/storage.list.cli-command.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.list.cli-command.impl.js","sourceRoot":"","sources":["../../../../src/cli/commands/list/storage.list.cli-command.impl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAcvD,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;QAE1D,IAAI,CAAC;YACJ,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,WAAW,EAAqC,CAAC;YAEvG,IAAI,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC;YAE/D,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnB,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC;YACvF,CAAC;YAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,EAAE,CAAC,MAAM,CACR,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACrB,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,cAAc,EAAE,CAAC,CAAC,cAAc;oBAChC,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,KAAK;oBACrC,WAAW,EAAE,CAAC,CAAC,eAAe,EAAE,QAAQ,CAAC,mBAAmB,CAAC,IAAI,KAAK;oBACtE,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,QAAQ;iBAC1B,CAAC,CAAC,EACH,EAAE,MAAM,EAAE,MAAM,EAAE,CAClB,CAAC;gBACF,OAAO;YACR,CAAC;YAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5B,EAAE,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;gBAC5C,OAAO;YACR,CAAC;YAED,EAAE,CAAC,KAAK,CACP,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACrB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,OAAO,EAAE,CAAC,CAAC,cAAc,IAAI,GAAG;gBAChC,eAAe,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;gBAC9C,YAAY,EAAE,CAAC,CAAC,eAAe,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;gBAC7E,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,QAAQ;aAC1B,CAAC,CAAC,EACH,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,OAAO,CAAC,CACtE,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,EAAE,CAAC,KAAK,CAAC,6BAA6B,CAAC,EAAE,CAAC,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;IACF,CAAC;CACD,CAAC"}

package/dist/cli/commands/sync/pull/storage.sync.pull.cli-command.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { CLICommandAssetDescriptor } from '@vibesdotdev/runtime/schemas/asset';
+declare const descriptor: CLICommandAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=storage.sync.pull.cli-command.descriptor.d.ts.map

package/dist/cli/commands/sync/pull/storage.sync.pull.cli-command.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.sync.pull.cli-command.descriptor.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/sync/pull/storage.sync.pull.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAEpF,QAAA,MAAM,UAAU,EAAE,yBAuBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/commands/sync/pull/storage.sync.pull.cli-command.descriptor.js

@@ -0,0 +1,26 @@
+const descriptor = {
+    kind: 'cli/command',
+    id: 'storage.sync.pull',
+    name: 'pull',
+    description: 'Pull cloud storage manifests to local',
+    group: 'storage.sync',
+    arguments: [
+        {
+            name: 'manifest-id',
+            description: 'Manifest ID to pull (omit for all)',
+            required: false,
+            variadic: false
+        }
+    ],
+    options: [
+        { flags: '--force', description: 'Force overwrite local even if local has changes' },
+        { flags: '--dry-run', description: 'Show what would be synced without making changes' },
+        { flags: '--json', description: 'Output results as JSON' }
+    ],
+    aliases: [],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=storage.sync.pull.cli-command.descriptor.js.map

package/dist/cli/commands/sync/pull/storage.sync.pull.cli-command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.sync.pull.cli-command.descriptor.js","sourceRoot":"","sources":["../../../../../src/cli/commands/sync/pull/storage.sync.pull.cli-command.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,uCAAuC;IACpD,KAAK,EAAE,cAAc;IACrB,SAAS,EAAE;QACV;YACC,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,oCAAoC;YACjD,QAAQ,EAAE,KAAK;YACf,QAAQ,EAAE,KAAK;SACf;KACD;IACD,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,iDAAiD,EAAE;QACpF,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,kDAAkD,EAAE;QACvF,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;KAC1D;IACD,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/commands/sync/pull/storage.sync.pull.cli-command.impl.d.ts

@@ -0,0 +1,13 @@
+/**
+ * vibes storage sync pull [manifest-id]
+ *
+ * Pulls cloud data to local for storage manifests AND sync-bridges.
+ * Uses pullFromCloud() for storage manifests and SyncBridge.execute() for bridges.
+ *
+ * The manifest-id argument matches both manifest IDs and bridge IDs.
+ */
+declare const _default: {
+    execute(args: Record<string, unknown>, opts: Record<string, unknown>): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=storage.sync.pull.cli-command.impl.d.ts.map

package/dist/cli/commands/sync/pull/storage.sync.pull.cli-command.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.sync.pull.cli-command.impl.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/sync/pull/storage.sync.pull.cli-command.impl.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;;kBAgBkB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;;AAD3F,wBAoJE"}