@codemarc/blt 1.6.5 → 1.8.0

package/dist/commands/data/helpers.d.ts

@@ -0,0 +1,15 @@
+/** Redact credentials from a Postgres URL for manifest logging. */
+export declare function redactedDbUrl(connectionString: string): string;
+/** ISO-ish UTC timestamp for snapshot folder names. */
+export declare function snapshotTimestamp(): string;
+/**
+ * Resolve `"latest"` to the most recent snapshot directory.
+ *
+ * Scans `<baseDir>/<instance?>/<timestamp>/manifest.json` and returns the
+ * full path to the newest stamped snapshot folder. When no instance prefix is
+ * given the search covers every instance sub-directory.
+ *
+ * @returns absolute path to the snapshot directory, or `null` if none found.
+ */
+export declare function resolveLatestSnapshot(baseDir: string): string | null;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/commands/data/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/commands/data/helpers.ts"],"names":[],"mappings":"AAGA,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAS9D;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyBpE"}

package/dist/commands/data/helpers.js

@@ -0,0 +1,53 @@
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+/** Redact credentials from a Postgres URL for manifest logging. */
+export function redactedDbUrl(connectionString) {
+    try {
+        const u = new URL(connectionString);
+        if (u.password)
+            u.password = "***";
+        if (u.username)
+            u.username = "***";
+        return u.toString();
+    }
+    catch {
+        return "(unparseable-connection-string)";
+    }
+}
+/** ISO-ish UTC timestamp for snapshot folder names. */
+export function snapshotTimestamp() {
+    return new Date().toISOString().replace(/:/g, "-").replace(/\.\d{3}Z$/, "Z");
+}
+/**
+ * Resolve `"latest"` to the most recent snapshot directory.
+ *
+ * Scans `<baseDir>/<instance?>/<timestamp>/manifest.json` and returns the
+ * full path to the newest stamped snapshot folder. When no instance prefix is
+ * given the search covers every instance sub-directory.
+ *
+ * @returns absolute path to the snapshot directory, or `null` if none found.
+ */
+export function resolveLatestSnapshot(baseDir) {
+    if (!existsSync(baseDir))
+        return null;
+    let best = null;
+    const instanceDirs = readdirSync(baseDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory());
+    for (const instDir of instanceDirs) {
+        const instPath = join(baseDir, instDir.name);
+        const stamps = readdirSync(instPath, { withFileTypes: true })
+            .filter((d) => d.isDirectory());
+        for (const stamp of stamps) {
+            const snapPath = join(instPath, stamp.name);
+            const manifestPath = join(snapPath, "manifest.json");
+            if (!existsSync(manifestPath))
+                continue;
+            const mtime = statSync(manifestPath).mtimeMs;
+            if (!best || mtime > best.mtime) {
+                best = { path: snapPath, mtime };
+            }
+        }
+    }
+    return best?.path ?? null;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/commands/data/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/commands/data/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,mEAAmE;AACnE,MAAM,UAAU,aAAa,CAAC,gBAAwB;IACrD,IAAI,CAAC;QACJ,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACpC,IAAI,CAAC,CAAC,QAAQ;YAAE,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC;QACnC,IAAI,CAAC,CAAC,QAAQ;YAAE,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC;QACnC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,iCAAiC,CAAC;IAC1C,CAAC;AACF,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,iBAAiB;IAChC,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACpD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,IAAI,IAAI,GAA2C,IAAI,CAAC;IAExD,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAChE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAEjC,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC3D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAEjC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;YACrD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;gBAAE,SAAS;YACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;YAC7C,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;gBACjC,IAAI,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;YAClC,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC;AAC3B,CAAC"}

package/dist/commands/data/pull.d.ts

@@ -0,0 +1,11 @@
+import type { Logger } from "@caporal/core";
+export type DataPullOpts = {
+    outBaseDir: string;
+    format: "json" | "yaml" | "toon";
+    includeUsers: boolean;
+    includeSecrets: boolean;
+    /** When true (default), dump every other `public` base table not covered by the curated manifest. */
+    includeExtraTables: boolean;
+};
+export declare function dataPull(instanceLabel: string, opts: DataPullOpts, logger: Logger): Promise<void>;
+//# sourceMappingURL=pull.d.ts.map

package/dist/commands/data/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../../src/commands/data/pull.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAe5C,MAAM,MAAM,YAAY,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,qGAAqG;IACrG,kBAAkB,EAAE,OAAO,CAAC;CAC5B,CAAC;AA4CF,wBAAsB,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiEvG"}

package/dist/commands/data/pull.js

@@ -0,0 +1,101 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { encode } from "@toon-format/toon";
+import yaml from "js-yaml";
+import { getPullConnectionString, withReadOnlyClient } from "../../lib/database-runner";
+import { discoverAndSortExtraPublicTables, pullExtraPublicTablePartition } from "../../lib/data-pull-extra-tables";
+import { getFullPullManifest } from "../../lib/data-pull-manifest";
+import { redactedDbUrl, snapshotTimestamp } from "./helpers";
+function writeSnapshotAsset(snapDir, format, part, functionName, sqlType, logger, assetsManifest) {
+    const rows = part.rows;
+    const ext = format === "yaml" ? "yaml" : format === "toon" ? "toon" : "json";
+    const fileName = `${part.snapshotStem}.${ext}`;
+    const filePath = join(snapDir, fileName);
+    const payload = {
+        assetId: part.assetId,
+        function: functionName,
+        sqlType,
+        rows,
+    };
+    if (part.primaryKey?.length)
+        payload.primaryKey = part.primaryKey;
+    if (part.conflictUpdateExclude?.length)
+        payload.conflictUpdateExclude = part.conflictUpdateExclude;
+    if (part.conflictWhere)
+        payload.conflictWhere = part.conflictWhere;
+    if (part.columnUdts && Object.keys(part.columnUdts).length > 0) {
+        payload.columnUdts = part.columnUdts;
+    }
+    const body = format === "yaml"
+        ? yaml.dump(payload, { lineWidth: 120, noRefs: true })
+        : format === "toon"
+            ? `${encode(payload)}\n`
+            : `${JSON.stringify(payload, null, 2)}\n`;
+    writeFileSync(filePath, body, "utf8");
+    assetsManifest.push({
+        id: part.assetId,
+        file: fileName,
+        function: functionName,
+        sqlType,
+        rowCount: rows.length,
+    });
+    logger.info(`  Wrote ${fileName} (${rows.length} rows)`);
+}
+export async function dataPull(instanceLabel, opts, logger) {
+    const url = getPullConnectionString();
+    const stamped = snapshotTimestamp();
+    const snapDir = join(process.cwd(), opts.outBaseDir, instanceLabel, stamped);
+    mkdirSync(snapDir, { recursive: true });
+    logger.info(`Snapshot directory: ${snapDir}`);
+    logger.info(`Source (redacted): ${redactedDbUrl(url)}`);
+    const ctx = {
+        includeUsers: opts.includeUsers,
+        includeSecrets: opts.includeSecrets,
+    };
+    if (!ctx.includeUsers) {
+        logger.info("Pull: skipping users and profile_roles_extra (--skip-users)");
+    }
+    if (!ctx.includeSecrets) {
+        logger.info("Pull: redacting payment_providers secrets (use --include-secrets to include)");
+    }
+    if (!opts.includeExtraTables) {
+        logger.info("Pull: skipping extra public.* tables (--skip-extra-tables)");
+    }
+    let pgVersion = "unknown";
+    const assetsManifest = [];
+    await withReadOnlyClient(url, async (client) => {
+        const v = await client.query("SELECT version() AS version");
+        pgVersion = v.rows[0]?.version ?? "unknown";
+        const seq = getFullPullManifest();
+        for (const entry of seq) {
+            if (entry.skip?.(ctx)) {
+                continue;
+            }
+            const partitions = await entry.fetchPartitions(client, ctx);
+            for (const part of partitions) {
+                logger.info(`Pulling ${part.assetId}…`);
+                writeSnapshotAsset(snapDir, opts.format, part, entry.targetName, entry.sqlType, logger, assetsManifest);
+            }
+        }
+        if (opts.includeExtraTables) {
+            const extras = await discoverAndSortExtraPublicTables(client, ctx);
+            logger.info(`Pulling ${extras.length} additional public table(s) (not in curated manifest)…`);
+            for (const table of extras) {
+                const part = await pullExtraPublicTablePartition(client, table);
+                logger.info(`Pulling ${part.assetId}…`);
+                writeSnapshotAsset(snapDir, opts.format, part, `public.${table}`, "table", logger, assetsManifest);
+            }
+        }
+    });
+    const manifest = {
+        instance: instanceLabel,
+        pulledAt: new Date().toISOString(),
+        sourceHostRedacted: redactedDbUrl(url),
+        pgVersion,
+        assets: assetsManifest,
+    };
+    const mfPath = join(snapDir, "manifest.json");
+    writeFileSync(mfPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+    logger.info(`Wrote manifest: ${mfPath}`);
+}
+//# sourceMappingURL=pull.js.map

package/dist/commands/data/pull.js.map

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

package/dist/commands/data/remove.d.ts

@@ -0,0 +1,7 @@
+import type { Logger } from "@caporal/core";
+export type DataRemoveOpts = {
+    outBaseDir: string;
+    dryRun: boolean;
+};
+export declare function dataRemove(instance: string, opts: DataRemoveOpts, logger: Logger): void;
+//# sourceMappingURL=remove.d.ts.map

package/dist/commands/data/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/commands/data/remove.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,MAAM,cAAc,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CAChB,CAAC;AAgBF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAevF"}

package/dist/commands/data/remove.js

@@ -0,0 +1,29 @@
+import { existsSync, rmSync } from "node:fs";
+import { isAbsolute, relative, resolve } from "node:path";
+function resolveInstanceSnapshotRoot(outBaseDir, instance) {
+    const inst = instance.trim();
+    if (!inst || inst === "." || inst === ".." || inst.includes("/") || inst.includes("\\")) {
+        throw new Error(`Instance must be a simple label (e.g. laf), not a path: "${instance}"`);
+    }
+    const base = resolve(process.cwd(), outBaseDir);
+    const target = resolve(base, inst);
+    const rel = relative(base, target);
+    if (rel.startsWith("..") || isAbsolute(rel)) {
+        throw new Error(`Resolved path escapes snapshot base: ${target}`);
+    }
+    return target;
+}
+export function dataRemove(instance, opts, logger) {
+    const target = resolveInstanceSnapshotRoot(opts.outBaseDir, instance);
+    if (!existsSync(target)) {
+        logger.info(`Nothing to remove (missing): ${target}`);
+        return;
+    }
+    if (opts.dryRun) {
+        logger.info(`Dry-run: would remove recursively: ${target}`);
+        return;
+    }
+    rmSync(target, { recursive: true, force: true });
+    logger.info(`Removed: ${target}`);
+}
+//# sourceMappingURL=remove.js.map

package/dist/commands/data/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../src/commands/data/remove.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQ1D,SAAS,2BAA2B,CAAC,UAAkB,EAAE,QAAgB;IACxE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CAAC,4DAA4D,QAAQ,GAAG,CAAC,CAAC;IAC1F,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,wCAAwC,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,IAAoB,EAAE,MAAc;IAChF,MAAM,MAAM,GAAG,2BAA2B,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAEtE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAC;QACtD,OAAO;IACR,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,sCAAsC,MAAM,EAAE,CAAC,CAAC;QAC5D,OAAO;IACR,CAAC;IAED,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,CAAC,IAAI,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/dist/commands/data.d.ts

@@ -0,0 +1,3 @@
+import type { Program } from "@caporal/core";
+export default function dataCommand(program: Program): void;
+//# sourceMappingURL=data.d.ts.map

package/dist/commands/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/commands/data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,eAAe,CAAC;AAsB5E,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,OAAO,EAAE,OAAO,QAqInD"}

package/dist/commands/data.js

@@ -0,0 +1,115 @@
+import { dataPull } from "./data/pull";
+import { dataApply } from "./data/apply";
+import { dataRemove } from "./data/remove";
+import { resolveLatestSnapshot } from "./data/helpers";
+const dataHelp = `
+instance data snapshots (read-only pull, apply to dev)
+
+Usage:
+  blt data pull <instance> [--out DIR] [--format json|yaml|toon] [--skip-users] [--include-secrets] [--skip-extra-tables]
+  blt data apply <snapshotDir|latest> [--dry-run] [--out DIR]
+  blt data remove <instance> [--out DIR] [--dry-run]
+
+Pull reads from BLT_DATA_PULL_URL (recommended) or SUPABASE_CONNECTION_STRING in a READ ONLY transaction.
+
+Apply executes generated SQL against BLT_DATA_LOAD_URL or SUPABASE_CONNECTION_STRING — use only on disposable dev databases.
+Use "latest" as the snapshot target to automatically apply the most recent snapshot.
+
+See tools/cli/README.md → "Data snapshots".
+`;
+export default function dataCommand(program) {
+    program
+        .command("data", "Instance data snapshot pull / apply / remove")
+        .help(dataHelp)
+        .action(() => {
+        console.log(dataHelp);
+    });
+    program
+        .command("data pull", "Export full instance-shaped snapshot (read-only)")
+        .hide()
+        .argument("<instance>", "Snapshot label / folder name (e.g. laf, staging)")
+        .option("-o, --out <dir>", 'Base directory for snapshots under cwd', {
+        default: "data-snapshots",
+    })
+        .option("-f, --format <fmt>", 'Per-asset format: json, yaml, or toon (compact LLM-oriented)', {
+        default: "json",
+        validator: ["json", "yaml", "toon"],
+    })
+        .option("--skip-users", "Omit create_user and profile_roles_extra assets (e.g. prod pulls)", {
+        default: false,
+    })
+        .option("--include-secrets", "Include api_key / encrypted secrets in payment_providers rows", {
+        default: false,
+    })
+        .option("--skip-extra-tables", "Only pull the curated manifest (omit other public.* base tables discovered in the DB)", {
+        default: false,
+    })
+        .action(async ({ args, options, logger, }) => {
+        try {
+            const instance = args.instance;
+            const fmt = options.format;
+            const format = fmt === "yaml" ? "yaml" : fmt === "toon" ? "toon" : "json";
+            await dataPull(instance, {
+                outBaseDir: options.out || "data-snapshots",
+                format,
+                includeUsers: !options.skipUsers,
+                includeSecrets: !!options.includeSecrets,
+                includeExtraTables: !options.skipExtraTables,
+            }, logger);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error(`data pull failed: ${message}`);
+            process.exit(1);
+        }
+    });
+    program
+        .command("data apply", "Replay a snapshot bundle as SQL on the load database")
+        .hide()
+        .argument("<snapshotDir>", 'Path to stamped snapshot folder (contains manifest.json), or "latest"')
+        .option("--dry-run", "Print combined SQL instead of executing", { default: false })
+        .option("-o, --out <dir>", 'Snapshot base directory (used with "latest")', {
+        default: "data-snapshots",
+    })
+        .action(async ({ args, options, logger, }) => {
+        try {
+            let dir = args.snapshotDir;
+            if (dir === "latest") {
+                const baseDir = options.out || "data-snapshots";
+                const resolved = resolveLatestSnapshot(baseDir);
+                if (!resolved) {
+                    logger.error(`No snapshots found under ${baseDir}/`);
+                    process.exit(1);
+                }
+                dir = resolved;
+                logger.info(`Resolved latest → ${dir}`);
+            }
+            await dataApply(dir, { dryRun: !!options.dryRun }, logger);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error(`data apply failed: ${message}`);
+            process.exit(1);
+        }
+    });
+    program
+        .command("data remove", "Delete all snapshots for an instance under data-snapshots/<instance>")
+        .hide()
+        .argument("<instance>", "Snapshot folder label (e.g. laf) — removes every stamped run under it")
+        .option("-o, --out <dir>", 'Snapshot base directory under cwd (must contain <instance>/)', {
+        default: "data-snapshots",
+    })
+        .option("--dry-run", "Print path that would be removed without deleting", { default: false })
+        .action(async ({ args, options, logger, }) => {
+        try {
+            const instance = args.instance;
+            dataRemove(instance, { outBaseDir: options.out || "data-snapshots", dryRun: !!options.dryRun }, logger);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error(`data remove failed: ${message}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=data.js.map

package/dist/commands/data.js.map

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

package/dist/commands/spin/dns.d.ts

@@ -0,0 +1,7 @@
+import type { Logger } from "@caporal/core";
+export declare function spinDns(action: string, domain: string, opts: {
+    name?: string;
+    ip?: string;
+    recordId?: string;
+}, logger: Logger): Promise<void>;
+//# sourceMappingURL=dns.d.ts.map

package/dist/commands/spin/dns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns.d.ts","sourceRoot":"","sources":["../../../src/commands/spin/dns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAI5C,wBAAsB,OAAO,CAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EACvD,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAyCf"}

package/dist/commands/spin/dns.js

@@ -0,0 +1,42 @@
+import { createDnsRecord, listDnsRecords, deleteDnsRecord } from "../../lib/digitalocean";
+import { formatTable } from "./helpers";
+export async function spinDns(action, domain, opts, logger) {
+    switch (action) {
+        case "create": {
+            if (!opts.name || !opts.ip) {
+                throw new Error("spin dns create requires --name and --ip");
+            }
+            const record = await createDnsRecord(domain, "A", opts.name, opts.ip);
+            logger.info(`DNS record created — id: ${record.id}, ${record.name}.${domain} → ${record.data}`);
+            break;
+        }
+        case "list": {
+            const records = await listDnsRecords(domain);
+            if (records.length === 0) {
+                logger.info(`No DNS records found for ${domain}.`);
+                return;
+            }
+            const header = ["ID", "TYPE", "NAME", "DATA", "TTL"];
+            const rows = records.map((r) => [
+                String(r.id),
+                r.type,
+                r.name,
+                r.data,
+                String(r.ttl),
+            ]);
+            console.log(formatTable([header, ...rows]));
+            break;
+        }
+        case "delete": {
+            if (!opts.recordId) {
+                throw new Error("spin dns delete requires --record-id");
+            }
+            await deleteDnsRecord(domain, Number(opts.recordId));
+            logger.info(`DNS record ${opts.recordId} deleted from ${domain}.`);
+            break;
+        }
+        default:
+            throw new Error(`Unknown dns action "${action}". Use: create, list, delete`);
+    }
+}
+//# sourceMappingURL=dns.js.map

package/dist/commands/spin/dns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns.js","sourceRoot":"","sources":["../../../src/commands/spin/dns.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,OAAO,CAC5B,MAAc,EACd,MAAc,EACd,IAAuD,EACvD,MAAc;IAEd,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAC7D,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YACtE,MAAM,CAAC,IAAI,CAAC,4BAA4B,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,IAAI,MAAM,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAChG,MAAM;QACP,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACb,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CAAC,4BAA4B,MAAM,GAAG,CAAC,CAAC;gBACnD,OAAO;YACR,CAAC;YACD,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;gBACZ,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,IAAI;gBACN,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;aACb,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM;QACP,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YACzD,CAAC;YACD,MAAM,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,QAAQ,iBAAiB,MAAM,GAAG,CAAC,CAAC;YACnE,MAAM;QACP,CAAC;QAED;YACC,MAAM,IAAI,KAAK,CAAC,uBAAuB,MAAM,8BAA8B,CAAC,CAAC;IAC/E,CAAC;AACF,CAAC"}

package/dist/commands/spin/down.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from "@caporal/core";
+export declare function spinDown(nameOrId: string, force: boolean, logger: Logger): Promise<void>;
+//# sourceMappingURL=down.d.ts.map

package/dist/commands/spin/down.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"down.d.ts","sourceRoot":"","sources":["../../../src/commands/spin/down.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAI5C,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB9F"}

package/dist/commands/spin/down.js

@@ -0,0 +1,17 @@
+import { deleteDroplet, getDroplet } from "../../lib/digitalocean";
+import { confirm, getPublicIp } from "./helpers";
+export async function spinDown(nameOrId, force, logger) {
+    const droplet = await getDroplet(nameOrId);
+    const ip = getPublicIp(droplet) ?? "n/a";
+    if (!force) {
+        const ok = await confirm(`Destroy droplet "${droplet.name}" (id: ${droplet.id}, ip: ${ip})?`);
+        if (!ok) {
+            logger.info("Aborted.");
+            return;
+        }
+    }
+    logger.info(`Destroying droplet "${droplet.name}" (${droplet.id})…`);
+    await deleteDroplet(droplet.id);
+    logger.info("Droplet destroyed.");
+}
+//# sourceMappingURL=down.js.map

package/dist/commands/spin/down.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"down.js","sourceRoot":"","sources":["../../../src/commands/spin/down.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB,EAAE,KAAc,EAAE,MAAc;IAC9E,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;IAEzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,EAAE,GAAG,MAAM,OAAO,CACvB,oBAAoB,OAAO,CAAC,IAAI,UAAU,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,CACnE,CAAC;QACF,IAAI,CAAC,EAAE,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACxB,OAAO;QACR,CAAC;IACF,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,uBAAuB,OAAO,CAAC,IAAI,MAAM,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IACrE,MAAM,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AACnC,CAAC"}

package/dist/commands/spin/helpers.d.ts

@@ -0,0 +1,7 @@
+import type { Logger } from "@caporal/core";
+import { type Droplet } from "../../lib/digitalocean";
+export declare function getPublicIp(droplet: Droplet): string | undefined;
+export declare function waitForActive(idOrName: string, logger: Logger, timeoutMs?: number, intervalMs?: number): Promise<Droplet>;
+export declare function confirm(prompt: string): Promise<boolean>;
+export declare function formatTable(rows: string[][]): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/commands/spin/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/commands/spin/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAElE,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEhE;AAED,wBAAsB,aAAa,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,SAAU,EACnB,UAAU,SAAQ,GAChB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ9D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAWpD"}

package/dist/commands/spin/helpers.js

@@ -0,0 +1,38 @@
+import { createInterface } from "node:readline";
+import { getDroplet } from "../../lib/digitalocean";
+export function getPublicIp(droplet) {
+    return droplet.networks.v4.find((n) => n.type === "public")?.ip_address;
+}
+export async function waitForActive(idOrName, logger, timeoutMs = 120_000, intervalMs = 5_000) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        const d = await getDroplet(idOrName);
+        const ip = getPublicIp(d);
+        if (d.status === "active" && ip)
+            return d;
+        logger.info(`  status: ${d.status} — waiting…`);
+        await new Promise((r) => setTimeout(r, intervalMs));
+    }
+    throw new Error(`Timed out waiting for droplet ${idOrName} to become active`);
+}
+export async function confirm(prompt) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(`${prompt} [y/N] `, (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === "y");
+        });
+    });
+}
+export function formatTable(rows) {
+    if (rows.length === 0)
+        return "";
+    const widths = rows[0].map((_, col) => Math.max(...rows.map((row) => (row[col] ?? "").length)));
+    return rows
+        .map((row) => row.map((cell, i) => {
+        const w = widths[i];
+        return cell.length >= w ? cell : cell + " ".repeat(w - cell.length);
+    }).join("  "))
+        .join("\n");
+}
+//# sourceMappingURL=helpers.js.map

package/dist/commands/spin/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/commands/spin/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAgB,MAAM,wBAAwB,CAAC;AAElE,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC3C,OAAO,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,UAAU,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,QAAgB,EAChB,MAAc,EACd,SAAS,GAAG,OAAO,EACnB,UAAU,GAAG,KAAK;IAElB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,SAAS,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QACrC,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,EAAE;YAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,aAAa,CAAC,CAAC;QAChD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,mBAAmB,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAc;IAC3C,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,EAAE,CAAC,QAAQ,CAAC,GAAG,MAAM,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;YAC1C,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAgB;IAC3C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CACrC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CACvD,CAAC;IACF,OAAO,IAAI;SACT,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACjC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACb,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/commands/spin/list.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from "@caporal/core";
+export declare function spinList(tag: string, logger: Logger): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/spin/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/spin/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAI5C,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBzE"}

package/dist/commands/spin/list.js

@@ -0,0 +1,20 @@
+import { listDroplets } from "../../lib/digitalocean";
+import { formatTable, getPublicIp } from "./helpers";
+export async function spinList(tag, logger) {
+    const droplets = await listDroplets(tag);
+    if (droplets.length === 0) {
+        logger.info(`No droplets found with tag "${tag}".`);
+        return;
+    }
+    const header = ["NAME", "ID", "IP", "STATUS", "REGION", "SIZE"];
+    const rows = droplets.map((d) => [
+        d.name,
+        String(d.id),
+        getPublicIp(d) ?? "pending",
+        d.status,
+        d.region.slug,
+        d.size_slug,
+    ]);
+    console.log(formatTable([header, ...rows]));
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/spin/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/spin/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,MAAc;IACzD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;IAEzC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAC;QACpD,OAAO;IACR,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAChC,CAAC,CAAC,IAAI;QACN,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACZ,WAAW,CAAC,CAAC,CAAC,IAAI,SAAS;QAC3B,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,MAAM,CAAC,IAAI;QACb,CAAC,CAAC,SAAS;KACX,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/commands/spin/setup.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from "@caporal/core";
+export declare function spinSetup(nameOrId: string, user: string, logger: Logger): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/spin/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/commands/spin/setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAO5C,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC7F"}

package/dist/commands/spin/setup.js

@@ -0,0 +1,32 @@
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { getDroplet } from "../../lib/digitalocean";
+import { getPublicIp } from "./helpers";
+export async function spinSetup(nameOrId, user, logger) {
+    const droplet = await getDroplet(nameOrId);
+    const ip = getPublicIp(droplet);
+    if (!ip) {
+        throw new Error(`Droplet "${droplet.name}" has no public IP yet (status: ${droplet.status})`);
+    }
+    const scriptPath = join(process.cwd(), "deploy", "scripts", "bootstrap-droplet.sh");
+    if (!existsSync(scriptPath)) {
+        logger.info("Bootstrap script not found — showing what would run:");
+        logger.info(`  1. scp ${scriptPath} ${user}@${ip}:/tmp/bootstrap-droplet.sh`);
+        logger.info(`  2. ssh ${user}@${ip} 'bash /tmp/bootstrap-droplet.sh'`);
+        logger.info(`\nCreate deploy/scripts/bootstrap-droplet.sh to enable automatic setup.`);
+        return;
+    }
+    logger.info(`Uploading bootstrap script to ${user}@${ip}…`);
+    const scp = spawnSync("scp", ["-o", "StrictHostKeyChecking=accept-new", scriptPath, `${user}@${ip}:/tmp/bootstrap-droplet.sh`], { stdio: "inherit" });
+    if (scp.status !== 0) {
+        throw new Error(`scp failed with exit code ${scp.status}`);
+    }
+    logger.info("Running bootstrap script…");
+    const ssh = spawnSync("ssh", ["-o", "StrictHostKeyChecking=accept-new", `${user}@${ip}`, "bash /tmp/bootstrap-droplet.sh"], { stdio: "inherit" });
+    if (ssh.status !== 0) {
+        throw new Error(`Bootstrap script failed with exit code ${ssh.status}`);
+    }
+    logger.info("Bootstrap complete.");
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/spin/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/commands/spin/setup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB,EAAE,IAAY,EAAE,MAAc;IAC7E,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,CAAC,IAAI,mCAAmC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,sBAAsB,CAAC,CAAC;IACpF,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;QACpE,MAAM,CAAC,IAAI,CAAC,YAAY,UAAU,IAAI,IAAI,IAAI,EAAE,4BAA4B,CAAC,CAAC;QAC9E,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,EAAE,mCAAmC,CAAC,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;QACvF,OAAO;IACR,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,iCAAiC,IAAI,IAAI,EAAE,GAAG,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,SAAS,CACpB,KAAK,EACL,CAAC,IAAI,EAAE,kCAAkC,EAAE,UAAU,EAAE,GAAG,IAAI,IAAI,EAAE,4BAA4B,CAAC,EACjG,EAAE,KAAK,EAAE,SAAS,EAAE,CACpB,CAAC;IACF,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,SAAS,CACpB,KAAK,EACL,CAAC,IAAI,EAAE,kCAAkC,EAAE,GAAG,IAAI,IAAI,EAAE,EAAE,EAAE,gCAAgC,CAAC,EAC7F,EAAE,KAAK,EAAE,SAAS,EAAE,CACpB,CAAC;IACF,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,0CAA0C,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AACpC,CAAC"}