@vibesdotdev/storage 0.0.1 → 1.0.0-rc.3

package/dist/cli/gc/commands/gc.run.cli-command.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gc.run.cli-command.impl.d.ts","sourceRoot":"","sources":["../../../../src/cli/gc/commands/gc.run.cli-command.impl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAOjE,wGAAwG;AACxG,QAAA,MAAM,kBAAkB;;;;iBAA8G,CAAC;;mBAGjH,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,WAAW,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;;AAD9H,wBAoGE"}

package/dist/cli/gc/commands/gc.run.cli-command.impl.js

@@ -0,0 +1,104 @@
+/**
+ * `vibes gc run` — apply retention, then return the space.
+ *
+ * Two passes in this order, deliberately. Deleting rows frees SQLite pages onto
+ * a freelist and shrinks nothing; vacuuming before the delete would rewrite the
+ * file and then immediately re-bloat it. Delete first, reclaim second.
+ *
+ * The command exists because everything else here is automatic, and automatic
+ * is not the same as available. A user who has just noticed a full disk needs to
+ * act now, not at 03:30 tomorrow.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { sweepDeclaredRetention } from "../../../retention/sweep.js";
+import { reclaimDatabases } from "../../../retention/reclaim.js";
+import { pruneCatalogChunks } from "../../../retention/catalog-chunks.js";
+import { sweepTmpScratch } from "../../../retention/tmp-scratch.js";
+import { formatBytes, listRootDatabases, resolveVibesRoots } from "../../../retention/roots.js";
+/** The command's options, parsed at the boundary. Commander maps `--no-reclaim` to `reclaim: false`. */
+const GcRunOptionsSchema = z.object({ dryRun: z.boolean().optional(), reclaim: z.boolean().optional(), json: z.boolean().optional() });
+export default {
+    async execute(_args, opts, context) {
+        const runtime = context.runtime;
+        const ui = await runtime.context('cli/ui');
+        const options = GcRunOptionsSchema.parse(opts);
+        const dryRun = options.dryRun ?? false;
+        const shouldReclaim = options.reclaim !== false && !dryRun;
+        const sweep = await sweepDeclaredRetention({ runtime, dryRun });
+        let reclaimedBytes = 0;
+        const reclaimedFrom = [];
+        const roots = await resolveVibesRoots(runtime);
+        if (shouldReclaim) {
+            for (const root of roots) {
+                const result = await reclaimDatabases(runtime, await listRootDatabases(runtime, root));
+                reclaimedBytes += result.bytesReclaimed;
+                reclaimedFrom.push(...result.databases.filter((d) => d.sizeBefore > d.sizeAfter).map((d) => d.path));
+            }
+        }
+        const catalogChunks = dryRun
+            ? { roots: [], deleted: 0 }
+            : await pruneCatalogChunks(runtime, roots);
+        // Dry runs never acquire custody or remove scratch.
+        const tmp = await sweepTmpScratch(runtime, roots, { deleteExpired: !dryRun });
+        const failedRoots = tmp.roots.filter((root) => root.failure).length;
+        if (failedRoots > 0)
+            throw new CapabilityError('Scratch reclamation could not be certified.', 'UNAVAILABLE', {
+                reason: 'gc-scratch-reclamation-failed', details: { failedRoots }
+            });
+        if (options.json) {
+            ui.json({ sweep, reclaimedBytes, reclaimedFrom, catalogChunks, tmp });
+            return;
+        }
+        const acted = sweep.records.filter((r) => r.deletedByAge + r.deletedByCount > 0);
+        if (acted.length > 0) {
+            ui.table(acted.map((r) => ({
+                Record: r.recordId,
+                'By age': String(r.deletedByAge),
+                'By count': String(r.deletedByCount)
+            })));
+        }
+        ui.log(dryRun
+            ? `Would remove ${sweep.totalDeleted} row(s) across ${sweep.examined} record(s).`
+            : `Removed ${sweep.totalDeleted} row(s) across ${sweep.examined} record(s).`);
+        // Skips are printed, not swallowed. "Nothing to do" and "nobody looked"
+        // are the two states this whole effort exists to tell apart.
+        const skipped = sweep.records.filter((r) => r.skipped);
+        for (const record of skipped)
+            ui.log(`  skipped ${record.recordId}: ${record.skipped}`);
+        const failed = sweep.records.filter((r) => r.error);
+        for (const record of failed)
+            ui.log(`  FAILED ${record.recordId}: ${record.error}`);
+        if (sweep.undeclared.length > 0) {
+            ui.log(`  ${sweep.undeclared.length} record(s) declare no retention policy and are unbounded.`);
+        }
+        if (shouldReclaim) {
+            ui.log(reclaimedBytes > 0
+                ? `Reclaimed ${formatBytes(reclaimedBytes)} from ${reclaimedFrom.length} database(s).`
+                : 'No database space to reclaim.');
+        }
+        if (catalogChunks.deleted > 0) {
+            ui.log(`Pruned ${catalogChunks.deleted} unreferenced catalog chunk(s).`);
+        }
+        for (const result of catalogChunks.roots) {
+            if (result.skipped && result.skipped !== 'no catalog/chunks directory') {
+                ui.log(`  catalog ${result.root}: ${result.skipped}`);
+            }
+        }
+        // What was kept is printed, not summarised to a count. These are lane
+        // directories someone may still be working in, and "swept tmp" with no
+        // list is indistinguishable from "swept tmp and took your evidence".
+        ui.log(`Tmp scratch: ${tmp.candidates} expired candidates (${formatBytes(tmp.candidateBytes)}); ${tmp.deleted} removed (${formatBytes(tmp.bytesReclaimed)}).`);
+        for (const result of tmp.roots) {
+            for (const candidate of result.candidates)
+                ui.log(`  candidate ${candidate.path}: ${formatBytes(candidate.bytes)}`);
+            for (const kept of result.kept) {
+                ui.log(`  kept ${kept.path}: ${kept.reason}`);
+            }
+            if (result.skipped && result.skipped !== 'no tmp directory') {
+                ui.log(`  tmp ${result.root}: ${result.skipped}`);
+            }
+        }
+    }
+};
+//# sourceMappingURL=gc.run.cli-command.impl.js.map

package/dist/cli/gc/commands/gc.run.cli-command.impl.js.map

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

package/dist/cli/gc/commands/gc.status.cli-command.descriptor.d.ts

@@ -0,0 +1,4 @@
+type CLICommandAssetDescriptor = import('@vibesdotdev/cli-contracts/descriptors').CLICommandAssetDescriptor;
+declare const descriptor: CLICommandAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=gc.status.cli-command.descriptor.d.ts.map

package/dist/cli/gc/commands/gc.status.cli-command.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gc.status.cli-command.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/cli/gc/commands/gc.status.cli-command.descriptor.ts"],"names":[],"mappings":"AAAA,KAAK,yBAAyB,GAAG,OAAO,wCAAwC,EAAE,yBAAyB,CAAC;AAE5G,QAAA,MAAM,UAAU,EAAE,yBAgBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/gc/commands/gc.status.cli-command.descriptor.js

@@ -0,0 +1,19 @@
+const descriptor = {
+    kind: 'cli/command',
+    id: 'gc.status',
+    name: 'status',
+    description: 'Report disk used by every Vibes state root, largest first',
+    group: 'gc',
+    options: [
+        { flags: '--json', description: 'Output as JSON' },
+        {
+            flags: '--root <path>',
+            description: 'Report a single root instead of every one this machine writes to'
+        }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=gc.status.cli-command.descriptor.js.map

package/dist/cli/gc/commands/gc.status.cli-command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gc.status.cli-command.descriptor.js","sourceRoot":"","sources":["../../../../src/cli/gc/commands/gc.status.cli-command.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,2DAA2D;IACxE,KAAK,EAAE,IAAI;IACX,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;QAClD;YACC,KAAK,EAAE,eAAe;YACtB,WAAW,EAAE,kEAAkE;SAC/E;KACD;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/gc/commands/gc.status.cli-command.impl.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `vibes gc status` — where the disk went.
+ *
+ * A user whose `.vibes` reached 11GB had no way to see it short of `du`, and
+ * `du` cannot tell them which 2.2GB is a refetchable dependency cache and which
+ * 533MB is irreplaceable memory. This prints the same classification the
+ * reclaim pass acts on, so what the report calls droppable is exactly what
+ * `vibes gc run` would drop.
+ */
+import * as z from 'zod/v4';
+import type { CommandContext } from '@vibesdotdev/cli-contracts';
+/** The command's options, parsed at the boundary. */
+declare const GcStatusOptionsSchema: z.ZodObject<{
+    root: z.ZodOptional<z.ZodString>;
+    json: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const _default: {
+    execute(_args: Record<string, never>, opts: z.input<typeof GcStatusOptionsSchema>, context: CommandContext): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=gc.status.cli-command.impl.d.ts.map

package/dist/cli/gc/commands/gc.status.cli-command.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gc.status.cli-command.impl.d.ts","sourceRoot":"","sources":["../../../../src/cli/gc/commands/gc.status.cli-command.impl.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAQjE,qDAAqD;AACrD,QAAA,MAAM,qBAAqB;;;iBAA0E,CAAC;;mBAGhF,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,WAAW,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;;AADjI,wBAkEE"}

package/dist/cli/gc/commands/gc.status.cli-command.impl.js

@@ -0,0 +1,74 @@
+/**
+ * `vibes gc status` — where the disk went.
+ *
+ * A user whose `.vibes` reached 11GB had no way to see it short of `du`, and
+ * `du` cannot tell them which 2.2GB is a refetchable dependency cache and which
+ * 533MB is irreplaceable memory. This prints the same classification the
+ * reclaim pass acts on, so what the report calls droppable is exactly what
+ * `vibes gc run` would drop.
+ */
+import * as z from 'zod/v4';
+import { formatBytes, measureRoot, resolveVibesRoots } from "../../../retention/roots.js";
+/** The command's options, parsed at the boundary. */
+const GcStatusOptionsSchema = z.object({ root: z.string().optional(), json: z.boolean().optional() });
+export default {
+    async execute(_args, opts, context) {
+        const runtime = context.runtime;
+        const ui = await runtime.context('cli/ui');
+        const options = GcStatusOptionsSchema.parse(opts);
+        const roots = options.root ? [options.root] : await resolveVibesRoots(runtime);
+        const measured = [];
+        for (const root of roots)
+            measured.push(await measureRoot(runtime, root));
+        if (options.json) {
+            ui.json({ roots: measured });
+            return;
+        }
+        if (measured.length === 0) {
+            ui.log('No Vibes state roots found.');
+            return;
+        }
+        for (const root of measured) {
+            ui.log('');
+            ui.log(`${root.root}  —  ${formatBytes(root.totalBytes)}`);
+            if (root.truncated) {
+                ui.log(`  (measurement stopped at its ${root.truncated.bound} bound of ${root.truncated.limit}; sizes are a floor)`);
+            }
+            const rows = root.entries
+                .filter((entry) => entry.bytes > 0)
+                .slice(0, 15)
+                .map((entry) => ({
+                Entry: entry.name,
+                Size: formatBytes(entry.bytes),
+                Disposition: entry.disposition,
+                Note: entry.note ?? ''
+            }));
+            if (rows.length > 0)
+                ui.table(rows);
+            if (root.databases.length > 0) {
+                const dbRows = root.databases
+                    .filter((db) => db.bytes > 0)
+                    .slice(0, 10)
+                    .map((db) => ({
+                    Database: db.path.split('/').pop() ?? db.path,
+                    Size: formatBytes(db.bytes)
+                }));
+                if (dbRows.length > 0) {
+                    ui.log('');
+                    ui.log('Databases');
+                    ui.table(dbRows);
+                }
+            }
+        }
+        // More than one root is normal AND is part of why growth goes unnoticed:
+        // a sweep against one leaves the others. Say so rather than let the
+        // reader assume the first number is the total.
+        if (measured.length > 1) {
+            const total = measured.reduce((sum, root) => sum + root.totalBytes, 0);
+            ui.log('');
+            ui.log(`${measured.length} state roots, ${formatBytes(total)} total. ` +
+                'Each carries its own databases; retention runs per root.');
+        }
+    }
+};
+//# sourceMappingURL=gc.status.cli-command.impl.js.map

package/dist/cli/gc/commands/gc.status.cli-command.impl.js.map

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

package/dist/cli/gc/gc.cli-group.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { CLIGroupAssetDescriptor } from '@vibesdotdev/kernel/schemas/asset';
+declare const descriptor: CLIGroupAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=gc.cli-group.descriptor.d.ts.map

package/dist/cli/gc/gc.cli-group.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gc.cli-group.descriptor.d.ts","sourceRoot":"","sources":["../../../src/cli/gc/gc.cli-group.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAEjF,QAAA,MAAM,UAAU,EAAE,uBAQjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/gc/gc.cli-group.descriptor.js

@@ -0,0 +1,11 @@
+const descriptor = {
+    kind: 'cli/group',
+    id: 'gc',
+    name: 'gc',
+    description: 'Inspect and reclaim disk used by Vibes state',
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=gc.cli-group.descriptor.js.map

package/dist/cli/gc/gc.cli-group.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gc.cli-group.descriptor.js","sourceRoot":"","sources":["../../../src/cli/gc/gc.cli-group.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAA4B;IAC3C,IAAI,EAAE,WAAW;IACjB,EAAE,EAAE,IAAI;IACR,IAAI,EAAE,IAAI;IACV,WAAW,EAAE,8CAA8C;IAC3D,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/gc/plugin.d.ts

@@ -0,0 +1,5 @@
+export declare const gcCliDescriptors: readonly [import("@vibesdotdev/kernel").CLIGroupAssetDescriptor, import("@vibesdotdev/cli-contracts").CLICommandAssetDescriptor, import("@vibesdotdev/cli-contracts").CLICommandAssetDescriptor];
+export declare const gcCliLoaders: readonly [import("@vibesdotdev/kernel").AssetLoader, import("@vibesdotdev/kernel").AssetLoader];
+export declare const gcCliPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default gcCliPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/cli/gc/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/cli/gc/plugin.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,gBAAgB,kMAInB,CAAC;AAEX,eAAO,MAAM,YAAY,iGAOf,CAAC;AAEX,eAAO,MAAM,WAAW,6CAOtB,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/dist/cli/gc/plugin.js

@@ -0,0 +1,28 @@
+/**
+ * `vibes gc` CLI surface.
+ *
+ * Consumer-only: this is about a laptop's disk. Cloud hosts never compose it.
+ */
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import gcGroupDescriptor from "./gc.cli-group.descriptor.js";
+import gcStatusCmdDescriptor from "./commands/gc.status.cli-command.descriptor.js";
+import gcRunCmdDescriptor from "./commands/gc.run.cli-command.descriptor.js";
+export const gcCliDescriptors = [
+    gcGroupDescriptor,
+    gcStatusCmdDescriptor,
+    gcRunCmdDescriptor
+];
+export const gcCliLoaders = [
+    loader('gc.status', { kind: 'cli/command' }, () => import("./commands/gc.status.cli-command.impl.js")),
+    loader('gc.run', { kind: 'cli/command' }, () => import("./commands/gc.run.cli-command.impl.js"))
+];
+export const gcCliPlugin = createRuntimePlugin({
+    id: 'gc.cli',
+    name: 'GC CLI Surface',
+    description: 'vibes gc status and run commands',
+    dependencies: ['storage', 'cli'],
+    descriptors: [...gcCliDescriptors],
+    loaders: [...gcCliLoaders]
+});
+export default gcCliPlugin;
+//# sourceMappingURL=plugin.js.map

package/dist/cli/gc/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/cli/gc/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,iBAAiB,MAAM,8BAA8B,CAAC;AAC7D,OAAO,qBAAqB,MAAM,gDAAgD,CAAC;AACnF,OAAO,kBAAkB,MAAM,6CAA6C,CAAC;AAE7E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC/B,iBAAiB;IACjB,qBAAqB;IACrB,kBAAkB;CACT,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B,MAAM,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,CACjD,MAAM,CAAC,0CAA0C,CAAC,CAClD;IACD,MAAM,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,CAC9C,MAAM,CAAC,uCAAuC,CAAC,CAC/C;CACQ,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAAC;IAC9C,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,kCAAkC;IAC/C,YAAY,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC;IAChC,WAAW,EAAE,CAAC,GAAG,gBAAgB,CAAC;IAClC,OAAO,EAAE,CAAC,GAAG,YAAY,CAAC;CAC1B,CAAC,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/dist/cli/plugin.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Storage CLI Surface Plugin (descriptors + impls, CLI scope only)
+ *
+ * Holds the `storage` + `storage.sync` cli/group descriptors, the
+ * `storage.list` + `storage.sync.{pull,push,status,resolve}` cli/command
+ * descriptors, and their lazy `*.cli-command.impl.*` loaders. These impls are
+ * consumer-only — they call `process.exit` and statically import
+ * `./sync/sync-state.consumer` (which imports `fs`/`path`/`os`/`node:crypto`) —
+ * so they MUST NOT be reachable from a cloud app bundle.
+ *
+ * The core `@vibesdotdev/storage/plugin` excludes CLI command implementations.
+ * Consumer persistence and reconciliation are composed through storage.consumer.plugin.
+ * Depends on cli and storage; mounted by consumer CLI hosts.
+ */
+export declare const storageCliPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default storageCliPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/cli/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/cli/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,eAAO,MAAM,gBAAgB,6CAsC3B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/dist/cli/plugin.js

@@ -0,0 +1,51 @@
+/**
+ * Storage CLI Surface Plugin (descriptors + impls, CLI scope only)
+ *
+ * Holds the `storage` + `storage.sync` cli/group descriptors, the
+ * `storage.list` + `storage.sync.{pull,push,status,resolve}` cli/command
+ * descriptors, and their lazy `*.cli-command.impl.*` loaders. These impls are
+ * consumer-only — they call `process.exit` and statically import
+ * `./sync/sync-state.consumer` (which imports `fs`/`path`/`os`/`node:crypto`) —
+ * so they MUST NOT be reachable from a cloud app bundle.
+ *
+ * The core `@vibesdotdev/storage/plugin` excludes CLI command implementations.
+ * Consumer persistence and reconciliation are composed through storage.consumer.plugin.
+ * Depends on cli and storage; mounted by consumer CLI hosts.
+ */
+import storageConsumerPlugin from "../storage.consumer.plugin.js";
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import storageGroup from "./storage.cli-group.descriptor.js";
+import storageSyncGroup from "./storage.sync.cli-group.descriptor.js";
+import storageList from "./commands/list/storage.list.cli-command.descriptor.js";
+import storageSyncPull from "./commands/sync/pull/storage.sync.pull.cli-command.descriptor.js";
+import storageSyncPush from "./commands/sync/push/storage.sync.push.cli-command.descriptor.js";
+import storageSyncResolve from "./commands/sync/resolve/storage.sync.resolve.cli-command.descriptor.js";
+import storageSyncStatus from "./commands/sync/status/storage.sync.status.cli-command.descriptor.js";
+const CLI_COMMAND = { kind: 'cli/command' };
+export const storageCliPlugin = createRuntimePlugin({
+    id: 'storage.cli',
+    name: 'Storage CLI Surface',
+    description: '`vibes storage list` + `vibes storage sync {pull,push,status,resolve}` — consumer/CLI scope only',
+    dependencies: ['cli', 'storage'],
+    descriptors: [
+        storageGroup,
+        storageSyncGroup,
+        storageList,
+        storageSyncPull,
+        storageSyncPush,
+        storageSyncResolve,
+        storageSyncStatus
+    ],
+    async onRegister(runtime) {
+        await runtime.registerPlugin(storageConsumerPlugin);
+    },
+    loaders: [
+        loader('storage.list', CLI_COMMAND, () => import("./commands/list/storage.list.cli-command.impl.js")),
+        loader('storage.sync.push', CLI_COMMAND, () => import("./commands/sync/push/storage.sync.push.cli-command.impl.js")),
+        loader('storage.sync.pull', CLI_COMMAND, () => import("./commands/sync/pull/storage.sync.pull.cli-command.impl.js")),
+        loader('storage.sync.status', CLI_COMMAND, () => import("./commands/sync/status/storage.sync.status.cli-command.impl.js")),
+        loader('storage.sync.resolve', CLI_COMMAND, () => import("./commands/sync/resolve/storage.sync.resolve.cli-command.impl.js"))
+    ]
+});
+export default storageCliPlugin;
+//# sourceMappingURL=plugin.js.map

package/dist/cli/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/cli/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,qBAAqB,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,YAAY,MAAM,mCAAmC,CAAC;AAC7D,OAAO,gBAAgB,MAAM,wCAAwC,CAAC;AACtE,OAAO,WAAW,MAAM,wDAAwD,CAAC;AACjF,OAAO,eAAe,MAAM,kEAAkE,CAAC;AAC/F,OAAO,eAAe,MAAM,kEAAkE,CAAC;AAC/F,OAAO,kBAAkB,MAAM,wEAAwE,CAAC;AACxG,OAAO,iBAAiB,MAAM,sEAAsE,CAAC;AAErG,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,aAAa,EAAW,CAAC;AAErD,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;IACnD,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACV,kGAAkG;IACnG,YAAY,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC;IAEhC,WAAW,EAAE;QACZ,YAAY;QACZ,gBAAgB;QAChB,WAAW;QACX,eAAe;QACf,eAAe;QACf,kBAAkB;QAClB,iBAAiB;KACjB;IAED,KAAK,CAAC,UAAU,CAAC,OAAO;QACvB,MAAM,OAAO,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,EAAE;QACR,MAAM,CAAC,cAAc,EAAE,WAAW,EAAE,GAAG,EAAE,CACxC,MAAM,CAAC,kDAAkD,CAAC,CAC1D;QACD,MAAM,CAAC,mBAAmB,EAAE,WAAW,EAAE,GAAG,EAAE,CAC7C,MAAM,CAAC,4DAA4D,CAAC,CACpE;QACD,MAAM,CAAC,mBAAmB,EAAE,WAAW,EAAE,GAAG,EAAE,CAC7C,MAAM,CAAC,4DAA4D,CAAC,CACpE;QACD,MAAM,CAAC,qBAAqB,EAAE,WAAW,EAAE,GAAG,EAAE,CAC/C,MAAM,CAAC,gEAAgE,CAAC,CACxE;QACD,MAAM,CAAC,sBAAsB,EAAE,WAAW,EAAE,GAAG,EAAE,CAChD,MAAM,CAAC,kEAAkE,CAAC,CAC1E;KACD;CACD,CAAC,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/dist/cli/storage.cli-group.descriptor.d.ts

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

package/dist/cli/storage.cli-group.descriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.cli-group.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/storage.cli-group.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAElF,QAAA,MAAM,UAAU,EAAE,uBAQjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"storage.cli-group.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/storage.cli-group.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAEjF,QAAA,MAAM,UAAU,EAAE,uBAQjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/storage.sync.cli-group.descriptor.d.ts

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

package/dist/cli/storage.sync.cli-group.descriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.sync.cli-group.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/storage.sync.cli-group.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAElF,QAAA,MAAM,UAAU,EAAE,uBASjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"storage.sync.cli-group.descriptor.d.ts","sourceRoot":"","sources":["../../src/cli/storage.sync.cli-group.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAEjF,QAAA,MAAM,UAAU,EAAE,uBASjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/types.d.ts

@@ -2,25 +2,9 @@
  * Local CLI Types (storage)
  *
  * Storage's CLI command implementations consume the runtime context `cli/ui`,
- * whose canonical shape lives in `@vibesdotdev/cli/providers`. To avoid a
- * back-import on `@vibesdotdev/cli` (which itself depends on storage), this
- * module declares a structural subset that matches the methods the storage
- * commands actually use. The full UIContext lives in `@vibesdotdev/cli`.
+ * whose canonical shape is `UIContext` in `@vibesdotdev/cli-contracts`. The
+ * import is type-only, so it adds no runtime edge back onto `@vibesdotdev/cli`
+ * (which itself depends on storage).
  */
-export interface StorageCliUIContext {
-    info(message: string): void;
-    success(message: string): void;
-    warn(message: string): void;
-    error(message: string): void;
-    log(message: string): void;
-    table(data: unknown[], options?: {
-        columns?: string[];
-    } | string | string[]): void;
-    json(data: unknown): void;
-    yaml(data: unknown): void;
-    keyValue(data: Record<string, unknown>): void;
-    render(data: unknown, options?: {
-        format?: 'json' | 'yaml' | 'table' | 'markdown' | 'text';
-    }): void | Promise<void>;
-}
+export type StorageCliUIContext = import('@vibesdotdev/cli-contracts').UIContext;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,mBAAmB;IACnC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IACnF,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9C,MAAM,CACL,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAA;KAAE,GACpE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,mBAAmB,GAAG,OAAO,4BAA4B,EAAE,SAAS,CAAC"}

package/dist/cli/types.js

@@ -2,10 +2,9 @@
  * Local CLI Types (storage)
  *
  * Storage's CLI command implementations consume the runtime context `cli/ui`,
- * whose canonical shape lives in `@vibesdotdev/cli/providers`. To avoid a
- * back-import on `@vibesdotdev/cli` (which itself depends on storage), this
- * module declares a structural subset that matches the methods the storage
- * commands actually use. The full UIContext lives in `@vibesdotdev/cli`.
+ * whose canonical shape is `UIContext` in `@vibesdotdev/cli-contracts`. The
+ * import is type-only, so it adds no runtime edge back onto `@vibesdotdev/cli`
+ * (which itself depends on storage).
  */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

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

package/dist/client/browse-adapter.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Browse a `storage/adapter` that declares the `'browse'` capability.
+ *
+ * Companion to {@link listBrowsableStorageAdapters} (which only reads
+ * descriptors): these helpers RESOLVE the adapter implementation and invoke
+ * its `listDrives()` / `list(driveId, path)` methods. Generic over any
+ * browse-capable adapter (SharePoint, …) — the runtime resolves the impl for
+ * the current scope/context, so credentialed adapters acquire their token from
+ * the surrounding request context.
+ *
+ * Lives in `@vibesdotdev/storage/client` because adapter resolution + the
+ * browse contract are storage-domain concerns; HTTP surfaces (e.g. the
+ * platform-web `/api/storage/adapters/[id]/*` route) are thin glue that wrap
+ * these in request context and map the typed errors below to HTTP status.
+ *
+ * Every helper takes the runtime its caller was handed (the request's
+ * `ctx.runtime`) as its first argument; there is no ambient runtime.
+ */
+import { CapabilityError, type RuntimeRef } from '@vibesdotdev/kernel';
+import type { StorageAdapterInterface } from '../interfaces/adapter.ts';
+import type { StorageDrive, StorageEntry, StorageTarget } from '../schemas/adapter-descriptor.ts';
+/** A per-call adapter config, handed to the adapter as given (a drive target's opaque config). */
+export type StorageAdapterCallConfig = NonNullable<StorageTarget['config']>;
+/** No `storage/adapter` is registered/enabled for the requested id (`NOT_FOUND storage-adapter-not-found`). */
+export declare class StorageAdapterNotFoundError extends CapabilityError {
+    readonly adapterId: string;
+    constructor(adapterId: string);
+}
+/** The resolved adapter does not implement the `browse` capability (`INVALID_INPUT storage-adapter-not-browsable`). */
+export declare class StorageAdapterNotBrowsableError extends CapabilityError {
+    readonly adapterId: string;
+    constructor(adapterId: string);
+}
+/** The runtime a storage client helper resolves adapters on. */
+export type StorageClientRuntime = Pick<RuntimeRef, 'query' | 'hasKind'>;
+/**
+ * Resolve an enabled `storage/adapter` by id on `runtime`. The one confirmed
+ * absence — no enabled descriptor with this id — is
+ * {@link StorageAdapterNotFoundError}; a registered adapter whose loader or
+ * construction fails rejects with that failure, never read as absence.
+ */
+export declare function resolveStorageAdapter(runtime: StorageClientRuntime, adapterId: string): Promise<StorageAdapterInterface>;
+/** Enumerate the browsable drives (SharePoint sites, OneDrive drives, …). */
+export declare function browseStorageDrives(runtime: StorageClientRuntime, adapterId: string, config?: StorageAdapterCallConfig): Promise<StorageDrive[]>;
+/** List entries at `path` inside `driveId`. Empty `path` lists the drive root. */
+export declare function browseStorageEntries(runtime: StorageClientRuntime, adapterId: string, driveId: string, path?: string, config?: StorageAdapterCallConfig, options?: {
+    itemId?: string;
+}): Promise<StorageEntry[]>;
+//# sourceMappingURL=browse-adapter.d.ts.map

package/dist/client/browse-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse-adapter.d.ts","sourceRoot":"","sources":["../../src/client/browse-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAEX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,MAAM,kCAAkC,CAAC;AAE1C,kGAAkG;AAClG,MAAM,MAAM,wBAAwB,GAAG,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE5E,+GAA+G;AAC/G,qBAAa,2BAA4B,SAAQ,eAAe;aACnC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAO7C;AAED,uHAAuH;AACvH,qBAAa,+BAAgC,SAAQ,eAAe;aACvC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAO7C;AASD,gEAAgE;AAChE,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;AAEzE;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,uBAAuB,CAAC,CAUlC;AAyBD,6EAA6E;AAC7E,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,wBAAwB,GAC/B,OAAO,CAAC,YAAY,EAAE,CAAC,CAGzB;AAED,kFAAkF;AAClF,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,wBAAwB,EACjC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,YAAY,EAAE,CAAC,CASzB"}