@vibesdotdev/storage 0.0.1 → 1.0.0-rc.3

package/dist/cli/backup/commands/backup.restore.cli-command.descriptor.js

@@ -0,0 +1,24 @@
+const descriptor = {
+    kind: "cli/command",
+    id: "backup.restore",
+    name: "restore",
+    description: "Restore a verified snapshot's files into a directory (never through a link; refuses to overwrite without --force)",
+    group: "backup",
+    arguments: [
+        {
+            name: "snapshotId",
+            description: "Snapshot id to restore (use `vibes backup status --json` or the snapshot run's output)",
+            required: true,
+        },
+    ],
+    options: [
+        { flags: "--into <dir>", description: "Absolute directory to restore into (created when missing)" },
+        { flags: "--force", description: "Replace regular files already at the destination" },
+        { flags: "--json", description: "Output as JSON" },
+    ],
+    surfaces: ["cli"],
+    hardware: ["consumer"],
+    enabled: true,
+};
+export default descriptor;
+//# sourceMappingURL=backup.restore.cli-command.descriptor.js.map

package/dist/cli/backup/commands/backup.restore.cli-command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.restore.cli-command.descriptor.js","sourceRoot":"","sources":["../../../../src/cli/backup/commands/backup.restore.cli-command.descriptor.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,GAA8B;IAC5C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,SAAS;IACf,WAAW,EACT,mHAAmH;IACrH,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE;QACT;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,wFAAwF;YACrG,QAAQ,EAAE,IAAI;SACf;KACF;IACD,OAAO,EAAE;QACP,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,2DAA2D,EAAE;QACnG,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,kDAAkD,EAAE;QACrF,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;KACnD;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/backup/commands/backup.restore.cli-command.impl.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `vibes backup restore <snapshotId> --into <dir> [--force]` — restore a
+ * snapshot's files, verified against their recorded hashes, under `<dir>` at
+ * the names the run recorded. Nothing is written unless every file verifies
+ * and every destination is free (or, with `--force`, a regular file); a link
+ * is never written through. Files are written owner-only (0600). Output names
+ * the files and sizes, never their contents.
+ */
+import * as z from "zod/v4";
+import type { CommandContext } from "@vibesdotdev/cli-contracts";
+declare const RestoreArgsSchema: z.ZodObject<{
+    snapshotId: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+declare const RestoreOptionsSchema: z.ZodObject<{
+    into: z.ZodOptional<z.ZodString>;
+    force: z.ZodOptional<z.ZodBoolean>;
+    json: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const _default: {
+    execute(args: z.input<typeof RestoreArgsSchema>, opts: z.input<typeof RestoreOptionsSchema>, context: CommandContext): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=backup.restore.cli-command.impl.d.ts.map

package/dist/cli/backup/commands/backup.restore.cli-command.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.restore.cli-command.impl.d.ts","sourceRoot":"","sources":["../../../../src/cli/backup/commands/backup.restore.cli-command.impl.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAQjE,QAAA,MAAM,iBAAiB;;iBAAmD,CAAC;AAC3E,QAAA,MAAM,oBAAoB;;;;iBAIxB,CAAC;;kBAIO,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,QACjC,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,WACjC,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC;;AALlB,wBAkCE"}

package/dist/cli/backup/commands/backup.restore.cli-command.impl.js

@@ -0,0 +1,50 @@
+/**
+ * `vibes backup restore <snapshotId> --into <dir> [--force]` — restore a
+ * snapshot's files, verified against their recorded hashes, under `<dir>` at
+ * the names the run recorded. Nothing is written unless every file verifies
+ * and every destination is free (or, with `--force`, a regular file); a link
+ * is never written through. Files are written owner-only (0600). Output names
+ * the files and sizes, never their contents.
+ */
+import * as z from "zod/v4";
+import { CapabilityError } from "@vibesdotdev/kernel";
+import { backupIoOf } from "../../../backup/core/io.js";
+import { loadSnapshotRecord, restoreSnapshot } from "../../../backup/core/restore.js";
+import { listBackupTargets } from "../../../backup/core/registry.js";
+const RestoreArgsSchema = z.object({ snapshotId: z.string().default("") });
+const RestoreOptionsSchema = z.object({
+    into: z.string().optional(),
+    force: 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 { snapshotId } = RestoreArgsSchema.parse(args);
+        const { into, force, json } = RestoreOptionsSchema.parse(opts);
+        if (!into || into.trim().length === 0) {
+            throw new CapabilityError("Name the directory to restore into with --into <dir>.", "INVALID_INPUT", {
+                reason: "backup-restore-into-required",
+                retryable: false,
+            });
+        }
+        const record = await loadSnapshotRecord(runtime, snapshotId);
+        // The target's declared source kind marks a SQLite primary (a target no longer registered declares none).
+        const [target] = await listBackupTargets(runtime, { targetId: record.targetId });
+        const restoreOptions = { into, force: force ?? false };
+        if (target)
+            restoreOptions.sourceKind = target.source.kind;
+        const result = await restoreSnapshot(await backupIoOf(runtime), record, restoreOptions);
+        if (json) {
+            ui.render(result, { format: "json" });
+            return;
+        }
+        ui.info(`\nRestored snapshot ${result.snapshotId} (target: ${result.targetId}) into ${result.into}:`);
+        ui.table(result.files, ["name", "bytes", "destination"]);
+        for (const skipped of result.skipped) {
+            ui.warn(`${skipped.name}: not restored (${skipped.reason}); the database snapshot already holds its committed data.`);
+        }
+    },
+};
+//# sourceMappingURL=backup.restore.cli-command.impl.js.map

package/dist/cli/backup/commands/backup.restore.cli-command.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.restore.cli-command.impl.js","sourceRoot":"","sources":["../../../../src/cli/backup/commands/backup.restore.cli-command.impl.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAA+B,MAAM,iCAAiC,CAAC;AACnH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC3E,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH,eAAe;IACb,KAAK,CAAC,OAAO,CACX,IAAuC,EACvC,IAA0C,EAC1C,OAAuB;QAEvB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAY,QAAQ,CAAC,CAAC;QACtD,MAAM,EAAE,UAAU,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,eAAe,CAAC,uDAAuD,EAAE,eAAe,EAAE;gBAClG,MAAM,EAAE,8BAA8B;gBACtC,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC7D,0GAA0G;QAC1G,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjF,MAAM,cAAc,GAA2B,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,KAAK,EAAE,CAAC;QAC/E,IAAI,MAAM;YAAE,cAAc,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QAC3D,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;QAExF,IAAI,IAAI,EAAE,CAAC;YACT,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QACD,EAAE,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,UAAU,aAAa,MAAM,CAAC,QAAQ,UAAU,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;QACtG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;QACzD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACrC,EAAE,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,mBAAmB,OAAO,CAAC,MAAM,4DAA4D,CAAC,CAAC;QACxH,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/cli/backup/commands/backup.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=backup.status.cli-command.descriptor.d.ts.map

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

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

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

@@ -0,0 +1,19 @@
+const descriptor = {
+    kind: "cli/command",
+    id: "backup.status",
+    name: "status",
+    description: "List configured backup targets and recent snapshot status",
+    group: "backup",
+    options: [
+        {
+            flags: "-t, --target <id>",
+            description: "Filter to a single target by id",
+        },
+        { flags: "--json", description: "Output as JSON" },
+    ],
+    surfaces: ["cli"],
+    hardware: ["consumer", "cloud"],
+    enabled: true,
+};
+export default descriptor;
+//# sourceMappingURL=backup.status.cli-command.descriptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backup.status.cli-command.descriptor.js","sourceRoot":"","sources":["../../../../src/cli/backup/commands/backup.status.cli-command.descriptor.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,GAA8B;IAC5C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,2DAA2D;IACxE,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE;QACP;YACE,KAAK,EAAE,mBAAmB;YAC1B,WAAW,EAAE,iCAAiC;SAC/C;QACD,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;KACnD;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,21 @@
+export type { TargetStatusRow } from '../../../backup/schemas/core.ts';
+/**
+ * `vibes backup status` — list targets, what each backs up, and its latest
+ * snapshot (id, time, status), the id `vibes backup restore` and `verify` take.
+ *
+ * Read-only. A provenance read that fails is the command's typed failure,
+ * never a row shown as "no snapshots"; a source path that cannot be resolved
+ * shows its code and reason, never its message.
+ */
+import * as z from "zod/v4";
+import type { CommandContext } from "@vibesdotdev/cli-contracts";
+/** One target's row: JSON carries every field, the table the short ones. */
+declare const StatusOptionsSchema: z.ZodObject<{
+    target: z.ZodOptional<z.ZodString>;
+    json: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const _default: {
+    execute(_args: Record<string, never>, opts: z.input<typeof StatusOptionsSchema>, context: CommandContext): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=backup.status.cli-command.impl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backup.status.cli-command.impl.d.ts","sourceRoot":"","sources":["../../../../src/cli/backup/commands/backup.status.cli-command.impl.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE;;;;;;;GAOG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AASjE,4EAA4E;AAG5E,QAAA,MAAM,mBAAmB;;;iBAA4E,CAAC;;mBAmB3F,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QACtB,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,WAChC,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC;;AALlB,wBAmDE"}

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

@@ -0,0 +1,76 @@
+/**
+ * `vibes backup status` — list targets, what each backs up, and its latest
+ * snapshot (id, time, status), the id `vibes backup restore` and `verify` take.
+ *
+ * Read-only. A provenance read that fails is the command's typed failure,
+ * never a row shown as "no snapshots"; a source path that cannot be resolved
+ * shows its code and reason, never its message.
+ */
+import * as z from "zod/v4";
+import { CapabilityError, CaughtFailureSchema } from "@vibesdotdev/kernel";
+import { listBackupTargets } from "../../../backup/core/registry.js";
+import { backupPathRoots, expandPath } from "../../../backup/core/paths.js";
+import { snapshotProvenanceStore } from "../../../backup/core/restore.js";
+/** One target's row: JSON carries every field, the table the short ones. */
+const StatusOptionsSchema = z.object({ target: z.string().optional(), json: z.boolean().optional() });
+/** A source path expanded on this invocation, or the typed failure it could not be. */
+async function expandSource(target, roots) {
+    try {
+        return await expandPath(target.source.path, roots);
+    }
+    catch (error) {
+        return CapabilityError.from(CaughtFailureSchema.parse(error));
+    }
+}
+/** The source column: the path, or the code and reason it could not be resolved (never a message). */
+async function sourceOf(target, roots) {
+    const source = await expandSource(target, roots);
+    return source instanceof CapabilityError ? `unresolved: ${source.code} ${source.reason}` : source;
+}
+export default {
+    async execute(_args, opts, context) {
+        const runtime = context.runtime;
+        const ui = await runtime.context("cli/ui");
+        const { target: targetId, json } = StatusOptionsSchema.parse(opts);
+        const targets = await listBackupTargets(runtime, { includeDisabled: true, targetId });
+        const store = runtime.hasKind("storage/record") ? await snapshotProvenanceStore(runtime) : null;
+        const roots = await backupPathRoots(runtime);
+        const rows = [];
+        for (const target of targets) {
+            const last = store
+                ? (await store.list({ where: { targetId: target.id }, limit: 1, orderBy: { startedAt: "desc" } })).items[0]
+                : undefined;
+            rows.push({
+                target: target.id,
+                description: target.description ?? "",
+                enabled: target.enabled,
+                source: await sourceOf(target, roots),
+                lastSnapshotId: last ? last.id : "—",
+                lastSnapshot: last ? String(last.startedAt) : "—",
+                lastStatus: last ? last.status : "—",
+                totalSnapshots: store ? await store.count({ targetId: target.id }) : 0,
+            });
+        }
+        if (json) {
+            ui.render({ targets: rows }, { format: "json" });
+            return;
+        }
+        ui.info(`\nBackup targets (${rows.length}):`);
+        if (rows.length === 0) {
+            ui.warn("No backup/target descriptors registered.");
+            return;
+        }
+        ui.table(rows, ["target", "enabled", "source", "lastStatus", "lastSnapshot", "lastSnapshotId", "totalSnapshots"]);
+        if (!store)
+            ui.warn("Backup provenance is not composed on this runtime; snapshot history is unavailable.");
+        for (const row of rows) {
+            if (row.lastStatus === "empty") {
+                ui.warn(`${row.target}: the last snapshot found none of the target's declared files; nothing was backed up.`);
+            }
+            else if (row.lastStatus === "failed") {
+                ui.warn(`${row.target}: the last snapshot failed.`);
+            }
+        }
+    },
+};
+//# sourceMappingURL=backup.status.cli-command.impl.js.map

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

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

package/dist/cli/backup/commands/backup.verify.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=backup.verify.cli-command.descriptor.d.ts.map

package/dist/cli/backup/commands/backup.verify.cli-command.descriptor.d.ts.map

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

package/dist/cli/backup/commands/backup.verify.cli-command.descriptor.js

@@ -0,0 +1,20 @@
+const descriptor = {
+    kind: "cli/command",
+    id: "backup.verify",
+    name: "verify",
+    description: "Verify a snapshot opens cleanly and matches recorded provenance",
+    group: "backup",
+    arguments: [
+        {
+            name: "snapshotId",
+            description: "Snapshot id to verify (use `vibes backup status` to list)",
+            required: true,
+        },
+    ],
+    options: [{ flags: "--json", description: "Output as JSON" }],
+    surfaces: ["cli"],
+    hardware: ["consumer", "cloud"],
+    enabled: true,
+};
+export default descriptor;
+//# sourceMappingURL=backup.verify.cli-command.descriptor.js.map

package/dist/cli/backup/commands/backup.verify.cli-command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.verify.cli-command.descriptor.js","sourceRoot":"","sources":["../../../../src/cli/backup/commands/backup.verify.cli-command.descriptor.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,GAA8B;IAC5C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,iEAAiE;IACnE,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE;QACT;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,2DAA2D;YACxE,QAAQ,EAAE,IAAI;SACf;KACF;IACD,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAC7D,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/backup/commands/backup.verify.cli-command.impl.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `vibes backup verify <snapshotId>` — re-read every snapshot file through the
+ * runtime's filesystem kind (never through a link), recompute its hash and
+ * compare with the recorded provenance. A snapshot that does not match is a
+ * typed failure (`INTERNAL backup-snapshot-corrupt`) after the table is shown.
+ */
+import * as z from "zod/v4";
+import type { CommandContext } from "@vibesdotdev/cli-contracts";
+/** The command's own arguments and options, parsed at the boundary. */
+declare const VerifyArgsSchema: z.ZodObject<{
+    snapshotId: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+declare const VerifyOptionsSchema: z.ZodObject<{
+    json: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const _default: {
+    execute(args: z.input<typeof VerifyArgsSchema>, opts: z.input<typeof VerifyOptionsSchema>, context: CommandContext): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=backup.verify.cli-command.impl.d.ts.map

package/dist/cli/backup/commands/backup.verify.cli-command.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.verify.cli-command.impl.d.ts","sourceRoot":"","sources":["../../../../src/cli/backup/commands/backup.verify.cli-command.impl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAOjE,uEAAuE;AACvE,QAAA,MAAM,gBAAgB;;iBAAmD,CAAC;AAC1E,QAAA,MAAM,mBAAmB;;iBAA6C,CAAC;;kBAI7D,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,QAChC,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,WAChC,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC;;AALlB,wBAqCE"}

package/dist/cli/backup/commands/backup.verify.cli-command.impl.js

@@ -0,0 +1,48 @@
+/**
+ * `vibes backup verify <snapshotId>` — re-read every snapshot file through the
+ * runtime's filesystem kind (never through a link), recompute its hash and
+ * compare with the recorded provenance. A snapshot that does not match is a
+ * typed failure (`INTERNAL backup-snapshot-corrupt`) after the table is shown.
+ */
+import * as z from "zod/v4";
+import { CapabilityError } from "@vibesdotdev/kernel";
+import { backupIoOf } from "../../../backup/core/io.js";
+import { loadSnapshotRecord, verifySnapshotFiles } from "../../../backup/core/restore.js";
+/** The command's own arguments and options, parsed at the boundary. */
+const VerifyArgsSchema = z.object({ snapshotId: z.string().default("") });
+const VerifyOptionsSchema = z.object({ json: z.boolean().optional() });
+export default {
+    async execute(args, opts, context) {
+        const runtime = context.runtime;
+        const ui = await runtime.context("cli/ui");
+        const { snapshotId } = VerifyArgsSchema.parse(args);
+        const { json } = VerifyOptionsSchema.parse(opts);
+        const record = await loadSnapshotRecord(runtime, snapshotId);
+        const fileChecks = await verifySnapshotFiles(await backupIoOf(runtime), record);
+        const allOk = fileChecks.every((check) => check.exists && check.bytesOk && check.hashOk);
+        const summary = {
+            snapshotId,
+            targetId: record.targetId,
+            recordedStatus: record.status,
+            files: fileChecks,
+            verdict: allOk ? "intact" : "corrupted-or-missing",
+        };
+        if (json) {
+            ui.render(summary, { format: "json" });
+        }
+        else {
+            ui.info(`\nSnapshot ${snapshotId} (target: ${record.targetId}, status: ${record.status})`);
+            ui.table(fileChecks, ["path", "exists", "bytesOk", "hashOk", "actualBytes"]);
+            if (allOk)
+                ui.info("\nVerdict: intact");
+        }
+        if (!allOk) {
+            throw new CapabilityError("The snapshot does not match its recorded provenance.", "INTERNAL", {
+                reason: "backup-snapshot-corrupt",
+                retryable: false,
+                details: { snapshotId },
+            });
+        }
+    },
+};
+//# sourceMappingURL=backup.verify.cli-command.impl.js.map

package/dist/cli/backup/commands/backup.verify.cli-command.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.verify.cli-command.impl.js","sourceRoot":"","sources":["../../../../src/cli/backup/commands/backup.verify.cli-command.impl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE1F,uEAAuE;AACvE,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC1E,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAEvE,eAAe;IACb,KAAK,CAAC,OAAO,CACX,IAAsC,EACtC,IAAyC,EACzC,OAAuB;QAEvB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAY,QAAQ,CAAC,CAAC;QACtD,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,EAAE,IAAI,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEjD,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC7D,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;QAChF,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;QACzF,MAAM,OAAO,GAAG;YACd,UAAU;YACV,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,cAAc,EAAE,MAAM,CAAC,MAAM;YAC7B,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,sBAAsB;SACnD,CAAC;QAEF,IAAI,IAAI,EAAE,CAAC;YACT,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,IAAI,CAAC,cAAc,UAAU,aAAa,MAAM,CAAC,QAAQ,aAAa,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YAC3F,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;YAC7E,IAAI,KAAK;gBAAE,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,eAAe,CAAC,sDAAsD,EAAE,UAAU,EAAE;gBAC5F,MAAM,EAAE,yBAAyB;gBACjC,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,EAAE,UAAU,EAAE;aACxB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/cli/backup/plugin.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,oBAAoB,yUAMvB,CAAC;AAEX,eAAO,MAAM,gBAAgB,uLAanB,CAAC;AAEX,eAAO,MAAM,eAAe,6CAO1B,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/dist/cli/backup/plugin.js

@@ -0,0 +1,30 @@
+/** Backup CLI surface. Core backup kinds, records, targets, and jobs remain universal. */
+import { createRuntimePlugin, loader } from "@vibesdotdev/kernel";
+import backupGroupDescriptor from "./backup.cli-group.descriptor.js";
+import backupStatusCmdDescriptor from "./commands/backup.status.cli-command.descriptor.js";
+import backupNowCmdDescriptor from "./commands/backup.now.cli-command.descriptor.js";
+import backupVerifyCmdDescriptor from "./commands/backup.verify.cli-command.descriptor.js";
+import backupRestoreCmdDescriptor from "./commands/backup.restore.cli-command.descriptor.js";
+export const backupCliDescriptors = [
+    backupGroupDescriptor,
+    backupStatusCmdDescriptor,
+    backupNowCmdDescriptor,
+    backupVerifyCmdDescriptor,
+    backupRestoreCmdDescriptor,
+];
+export const backupCliLoaders = [
+    loader("backup.status", { kind: "cli/command" }, () => import("./commands/backup.status.cli-command.impl.js")),
+    loader("backup.now", { kind: "cli/command" }, () => import("./commands/backup.now.cli-command.impl.js")),
+    loader("backup.verify", { kind: "cli/command" }, () => import("./commands/backup.verify.cli-command.impl.js")),
+    loader("backup.restore", { kind: "cli/command" }, () => import("./commands/backup.restore.cli-command.impl.js")),
+];
+export const backupCliPlugin = createRuntimePlugin({
+    id: "backup.cli",
+    name: "Backup CLI Surface",
+    description: "vibes backup status, now, verify and restore commands",
+    dependencies: ["backup", "cli"],
+    descriptors: [...backupCliDescriptors],
+    loaders: [...backupCliLoaders],
+});
+export default backupCliPlugin;
+//# sourceMappingURL=plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/cli/backup/plugin.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,qBAAqB,MAAM,kCAAkC,CAAC;AACrE,OAAO,yBAAyB,MAAM,oDAAoD,CAAC;AAC3F,OAAO,sBAAsB,MAAM,iDAAiD,CAAC;AACrF,OAAO,yBAAyB,MAAM,oDAAoD,CAAC;AAC3F,OAAO,0BAA0B,MAAM,qDAAqD,CAAC;AAE7F,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,qBAAqB;IACrB,yBAAyB;IACzB,sBAAsB;IACtB,yBAAyB;IACzB,0BAA0B;CAClB,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,CACpD,MAAM,CAAC,8CAA8C,CAAC,CACvD;IACD,MAAM,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,CACjD,MAAM,CAAC,2CAA2C,CAAC,CACpD;IACD,MAAM,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,CACpD,MAAM,CAAC,8CAA8C,CAAC,CACvD;IACD,MAAM,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,CACrD,MAAM,CAAC,+CAA+C,CAAC,CACxD;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;IACjD,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,uDAAuD;IACpE,YAAY,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;IAC/B,WAAW,EAAE,CAAC,GAAG,oBAAoB,CAAC;IACtC,OAAO,EAAE,CAAC,GAAG,gBAAgB,CAAC;CAC/B,CAAC,CAAC;AAEH,eAAe,eAAe,CAAC"}

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

@@ -1,4 +1,4 @@
-import type { CLICommandAssetDescriptor } from '@vibesdotdev/runtime/schemas/asset';
+import type { CLICommandAssetDescriptor } from '@vibesdotdev/kernel/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

@@ -1 +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"}
+{"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,mCAAmC,CAAC;AAEnF,QAAA,MAAM,UAAU,EAAE,yBAejB,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -4,8 +4,15 @@
  * Lists all registered storage manifests with their adapter configuration,
  * custom table status, and sync eligibility.
  */
+import * as z from 'zod/v4';
+import type { CommandContext } from '@vibesdotdev/cli-contracts';
+/** `--json` and `--sync-only`. */
+declare const ListOptionsSchema: z.ZodObject<{
+    json: z.ZodOptional<z.ZodBoolean>;
+    syncOnly: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
 declare const _default: {
-    execute(_args: Record<string, unknown>, opts: Record<string, unknown>): Promise<void>;
+    execute(_args: Record<string, never>, opts: z.input<typeof ListOptionsSchema>, context: CommandContext): 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

@@ -1 +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"}
+{"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;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAIjE,kCAAkC;AAClC,QAAA,MAAM,iBAAiB;;;iBAA+E,CAAC;;mBAGjF,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,WAAW,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;;AAD7H,wBAuDE"}

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

@@ -4,18 +4,22 @@
  * Lists all registered storage manifests with their adapter configuration,
  * custom table status, and sync eligibility.
  */
-import { getVibesRuntime } from '@vibesdotdev/runtime';
+import * as z from 'zod/v4';
+import { CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+/** `--json` and `--sync-only`. */
+const ListOptionsSchema = z.object({ json: z.boolean().optional(), syncOnly: z.boolean().optional() });
 export default {
-    async execute(_args, opts) {
-        const runtime = getVibesRuntime();
-        const ui = (await runtime.context('cli/ui'));
+    async execute(_args, opts, context) {
+        const runtime = context.runtime;
+        const ui = await runtime.context('cli/ui');
+        const options = ListOptionsSchema.parse(opts);
         try {
             const descriptors = runtime.query('storage/manifest').descriptors();
             let manifests = descriptors.filter((d) => d.enabled !== false);
-            if (opts.syncOnly) {
+            if (options.syncOnly) {
                 manifests = manifests.filter((d) => d.allowedAdapters?.includes('storage.cloud-api'));
             }
-            if (opts.json) {
+            if (options.json) {
                 ui.render(manifests.map((d) => ({
                     id: d.id,
                     namespace: d.namespace,
@@ -40,8 +44,13 @@ export default {
             })), ['ID', 'Namespace', 'Adapter', 'Custom Tables', 'Cloud Sync', 'Scope']);
         }
         catch (e) {
-            ui.error(`Failed to list manifests: ${e}`);
-            process.exit(1);
+            if (e instanceof CapabilityError)
+                throw e;
+            // The failure travels as `cause`; its text never reaches the message.
+            throw new CapabilityError('The storage manifests could not be listed.', 'INTERNAL', {
+                reason: 'storage-list-failed',
+                cause: CaughtFailureSchema.parse(e)
+            });
         }
     }
 };

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

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

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

@@ -1,4 +1,4 @@
-import type { CLICommandAssetDescriptor } from '@vibesdotdev/runtime/schemas/asset';
+import type { CLICommandAssetDescriptor } from '@vibesdotdev/kernel/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

@@ -1 +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"}
+{"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,mCAAmC,CAAC;AAEnF,QAAA,MAAM,UAAU,EAAE,yBAuBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -5,9 +5,17 @@
  * Uses pullFromCloud() for storage manifests and SyncBridge.execute() for bridges.
  *
  * The manifest-id argument matches both manifest IDs and bridge IDs.
+ *
+ * Machine contract (`--json` / `--format json`):
+ * - stdout is a single JSON document (success: results array; failure: CapabilityError envelope)
+ * - no human per-item lines on stdout/stderr during the run
+ * - non-zero exit when any target reports error or conflict (including dry-run)
  */
+import type { CommandContext } from '@vibesdotdev/cli-contracts';
+import type * as z from 'zod/v4';
+import { SyncRunOptionsSchema, SyncTargetArgsSchema } from '../sync-command-input.ts';
 declare const _default: {
-    execute(args: Record<string, unknown>, opts: Record<string, unknown>): Promise<void>;
+    execute(args: z.input<typeof SyncTargetArgsSchema>, opts: z.input<typeof SyncRunOptionsSchema>, context: CommandContext): 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

@@ -1 +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"}
+{"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;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,KAAK,CAAC,MAAM,QAAQ,CAAC;AAejC,OAAO,EAEN,oBAAoB,EACpB,oBAAoB,EAGpB,MAAM,0BAA0B,CAAC;;kBAU1B,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,QACpC,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,WACjC,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC;;AALjB,wBAgME"}