gitops-ai 1.0.0

package/dist/core/kubernetes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kubernetes.js","sourceRoot":"","sources":["../../src/core/kubernetes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAa,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,UAAU,kBAAkB;IAChC,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,kCAAkC,CAAC,CAAC;IAClE,OAAO,QAAQ,KAAK,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB;IACxD,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,8BAA8B,CAAC,CAAC;IAC5D,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,OAAO,CAAC,gBAAgB,WAAW,kBAAkB,CAAC,CAAC;QAC3D,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG;QACV,oBAAoB;QACpB,WAAW;QACX,yBAAyB,kBAAkB,QAAQ;QACnD,wCAAwC;QACxC,6BAA6B;QAC7B,+BAA+B;QAC/B,QAAQ;KACT,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChB,MAAM,WAAW,CAAC,yBAAyB,WAAW,GAAG,EAAE,GAAG,EAAE,CAC9D,SAAS,CAAC,GAAG,CAAC,CACf,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAChD,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,GAAG,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IAED,MAAM,WAAW,CAAC,gBAAgB,EAAE,GAAG,EAAE,CACvC,SAAS,CACP,wDAAwD,kBAAkB,qFAAqF,CAChK,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,SAAS,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5D,IAAI,OAAO,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;QACxB,MAAM,cAAc,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,cAAc,WAAW,EAAE,CAAC;QACtE,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,WAAW,EAAE,CAAC,CAAC;QAC7D,aAAa,CAAC,cAAc,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,cAAc,CAAC;QACxC,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,IAAI,CAAC,sDAAsD,CAAC,CAAC;IAC7D,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAC1D,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACrC,MAAM,cAAc,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,cAAc,CAAC;IACxC,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,WAAW,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAC9C,MAAM,SAAS,CACb,8DAA8D,CAC/D,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,MAAM,SAAS,CACb,4BAA4B,IAAI,gDAAgD,CACjF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,SAAiB,EACjB,IAA4B;IAE5B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC;SAC7C,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,MAAM,GAAG,GAAG,iCAAiC,IAAI,gBAAgB,SAAS,IAAI,QAAQ,EAAE,CAAC;IACzF,GAAG,CAAC,MAAM,CAAC,iCAAiC,IAAI,gBAAgB,SAAS,EAAE,CAAC,CAAC;IAC7E,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,SAAiB;IAC1D,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAC3B,sBAAsB,IAAI,OAAO,SAAS,cAAc,CACzD,CAAC;IACF,OAAO,QAAQ,KAAK,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,SAAiB;IAEjB,MAAM,SAAS,CAAC,yBAAyB,IAAI,OAAO,SAAS,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAY,EACZ,SAAiB,EACjB,GAAW,EACX,QAAgB;IAEhB,MAAM,GAAG,GAAG,iCAAiC,IAAI,gBAAgB,SAAS,gBAAgB,GAAG,KAAK,QAAQ,GAAG,CAAC;IAC9G,GAAG,CAAC,MAAM,CAAC,iCAAiC,IAAI,gBAAgB,SAAS,gBAAgB,GAAG,EAAE,CAAC,CAAC;IAChG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { bootstrap, openclawPair } from "./commands/bootstrap.js";
+import { sops } from "./commands/sops.js";
+import pc from "picocolors";
+const program = new Command();
+program
+    .name("flux-cli")
+    .description("Flux GitOps cluster bootstrap CLI with interactive TUI")
+    .version("1.0.0");
+program
+    .command("bootstrap")
+    .alias("install")
+    .description("Bootstrap a Kubernetes cluster with Flux GitOps (create new repo or use existing)")
+    .action(async () => {
+    try {
+        await bootstrap();
+    }
+    catch (err) {
+        console.error(pc.red(`\n  Error: ${err.message}`));
+        process.exit(1);
+    }
+});
+program
+    .command("sops [subcommand] [file]")
+    .description("SOPS secret encryption management (init, encrypt, decrypt, edit, status, import, rotate)")
+    .action(async (subcommand, file) => {
+    try {
+        await sops(subcommand, file);
+    }
+    catch (err) {
+        console.error(pc.red(`\n  Error: ${err.message}`));
+        process.exit(1);
+    }
+});
+program
+    .command("openclaw-pair")
+    .description("Pair an OpenClaw device with the cluster")
+    .action(async () => {
+    try {
+        await openclawPair();
+    }
+    catch (err) {
+        console.error(pc.red(`\n  Error: ${err.message}`));
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,wDAAwD,CAAC;KACrE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,WAAW,CAAC;KACpB,KAAK,CAAC,SAAS,CAAC;KAChB,WAAW,CAAC,mFAAmF,CAAC;KAChG,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,IAAI,CAAC;QACH,MAAM,SAAS,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,cAAe,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,0BAA0B,CAAC;KACnC,WAAW,CAAC,0FAA0F,CAAC;KACvG,MAAM,CAAC,KAAK,EAAE,UAAmB,EAAE,IAAa,EAAE,EAAE;IACnD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,cAAe,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,IAAI,CAAC;QACH,MAAM,YAAY,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,cAAe,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,50 @@
+import { z } from "zod";
+export declare const ClusterConfigSchema: z.ZodObject<{
+    clusterName: z.ZodString;
+    clusterDomain: z.ZodString;
+    clusterPublicIp: z.ZodString;
+    letsencryptEmail: z.ZodOptional<z.ZodString>;
+    ingressAllowedIps: z.ZodString;
+}, z.core.$strip>;
+export declare const GitLabConfigSchema: z.ZodObject<{
+    gitlabPat: z.ZodString;
+    repoName: z.ZodString;
+    repoOwner: z.ZodString;
+    repoBranch: z.ZodString;
+}, z.core.$strip>;
+export declare const SecretsConfigSchema: z.ZodObject<{
+    cloudflareApiToken: z.ZodOptional<z.ZodString>;
+    openaiApiKey: z.ZodOptional<z.ZodString>;
+    openclawGatewayToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ClusterConfig = z.infer<typeof ClusterConfigSchema>;
+export type GitLabConfig = z.infer<typeof GitLabConfigSchema>;
+export type SecretsConfig = z.infer<typeof SecretsConfigSchema>;
+export type BootstrapConfig = ClusterConfig & GitLabConfig & SecretsConfig & {
+    selectedComponents: string[];
+};
+export interface SopsConfig {
+    keyDir: string;
+    keyFile: string;
+    namespace: string;
+    secretName: string;
+    configFile: string;
+    backupDir: string;
+}
+export interface ComponentDef {
+    id: string;
+    label: string;
+    hint: string;
+    required: boolean;
+    secrets?: string[];
+    subdomain?: string;
+}
+export declare const COMPONENTS: ComponentDef[];
+export declare const REQUIRED_COMPONENT_IDS: string[];
+export declare const DNS_TLS_COMPONENT_IDS: string[];
+export declare const OPTIONAL_COMPONENTS: ComponentDef[];
+export declare const KUBERNETES_VERSION = "1.35.1";
+export declare const SOURCE_GITLAB_HOST = "gitlab.com";
+export declare const SOURCE_PROJECT_PATH = "everythings-gonna-be-alright/fluxcd_ai_template";
+export declare const INSTALL_PLAN_PATH = "/tmp/installplan.json";
+export declare function defaultSopsConfig(repoRoot: string): SopsConfig;

package/dist/schemas.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+// ---------------------------------------------------------------------------
+// Validation schemas
+// ---------------------------------------------------------------------------
+export const ClusterConfigSchema = z.object({
+    clusterName: z.string().min(1),
+    clusterDomain: z
+        .string()
+        .min(1)
+        .refine((v) => v.includes("."), "Must be a valid domain"),
+    clusterPublicIp: z.string().min(1),
+    letsencryptEmail: z.string().optional(),
+    ingressAllowedIps: z.string().min(1),
+});
+export const GitLabConfigSchema = z.object({
+    gitlabPat: z.string().min(1, "GitLab PAT is required"),
+    repoName: z.string().min(1),
+    repoOwner: z.string().min(1),
+    repoBranch: z.string().min(1),
+});
+export const SecretsConfigSchema = z.object({
+    cloudflareApiToken: z.string().optional(),
+    openaiApiKey: z.string().optional(),
+    openclawGatewayToken: z.string().optional(),
+});
+export const COMPONENTS = [
+    { id: "helm-repos", label: "Helm Repositories", hint: "Shared Helm chart repos", required: true },
+    { id: "ingress-nginx-external", label: "Ingress Nginx (external)", hint: "External HTTP/HTTPS ingress controller", required: true },
+    { id: "cert-manager", label: "Cert Manager", hint: "Automatic TLS certificates via Let's Encrypt", required: false, secrets: ["secret-cloudflare.yaml"] },
+    { id: "external-dns", label: "External DNS", hint: "Automatic DNS records in Cloudflare", required: false, secrets: ["secret-cloudflare.yaml"] },
+    { id: "prometheus-operator-crds", label: "Prometheus CRDs", hint: "Monitoring custom resource definitions", required: true },
+    { id: "flux-web", label: "Flux Web UI", hint: "Web dashboard for Flux status", required: false, subdomain: "flux" },
+    { id: "openclaw", label: "OpenClaw", hint: "AI assistant gateway (requires OpenAI key)", required: false, secrets: ["secret-openclaw-envs.yaml"], subdomain: "openclaw" },
+];
+export const REQUIRED_COMPONENT_IDS = COMPONENTS.filter((c) => c.required).map((c) => c.id);
+export const DNS_TLS_COMPONENT_IDS = ["cert-manager", "external-dns"];
+export const OPTIONAL_COMPONENTS = COMPONENTS.filter((c) => !c.required && !DNS_TLS_COMPONENT_IDS.includes(c.id));
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const KUBERNETES_VERSION = "1.35.1";
+export const SOURCE_GITLAB_HOST = "gitlab.com";
+export const SOURCE_PROJECT_PATH = "everythings-gonna-be-alright/fluxcd_ai_template";
+export const INSTALL_PLAN_PATH = "/tmp/installplan.json";
+export function defaultSopsConfig(repoRoot) {
+    const keyDir = process.env.SOPS_AGE_KEY_DIR ?? `${process.env.HOME}/.sops`;
+    return {
+        keyDir,
+        keyFile: `${keyDir}/age.agekey`,
+        namespace: process.env.SOPS_NAMESPACE ?? "flux-system",
+        secretName: process.env.SOPS_SECRET_NAME ?? "sops-age",
+        configFile: `${repoRoot}/.sops.yaml`,
+        backupDir: `${keyDir}/backups`,
+    };
+}
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/utils/config.d.ts

@@ -0,0 +1,3 @@
+export declare function saveInstallPlan(config: Record<string, string>): void;
+export declare function loadInstallPlan(): Record<string, string> | null;
+export declare function clearInstallPlan(): void;

package/dist/utils/config.js

@@ -0,0 +1,26 @@
+import { readFileSync, writeFileSync, unlinkSync, existsSync, } from "node:fs";
+import { INSTALL_PLAN_PATH } from "../schemas.js";
+export function saveInstallPlan(config) {
+    writeFileSync(INSTALL_PLAN_PATH, JSON.stringify(config, null, 2), {
+        mode: 0o600,
+    });
+}
+export function loadInstallPlan() {
+    if (!existsSync(INSTALL_PLAN_PATH))
+        return null;
+    try {
+        return JSON.parse(readFileSync(INSTALL_PLAN_PATH, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function clearInstallPlan() {
+    try {
+        unlinkSync(INSTALL_PLAN_PATH);
+    }
+    catch {
+        /* already gone */
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,UAAU,EACV,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,UAAU,eAAe,CAAC,MAA8B;IAC5D,aAAa,CAAC,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QAChE,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC;QACH,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;AACH,CAAC"}

package/dist/utils/log.d.ts

@@ -0,0 +1,31 @@
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+export declare const log: {
+    step: (msg: string) => void;
+    success: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    info: (msg: string) => void;
+    message: (msg: string) => void;
+    detail: (msg: string) => void;
+};
+export declare function header(title: string, subtitle?: string): void;
+export declare function summary(title: string, entries: Record<string, string>): void;
+export declare function nextSteps(steps: string[]): void;
+export declare function finish(msg: string): void;
+export declare function handleCancel(): never;
+/**
+ * Format an error for display — extracts stderr, stdout, and message.
+ */
+export declare function formatError(err: unknown): string;
+/**
+ * Wrap an async task with a @clack/prompts spinner.
+ * Shows command output on success (if string) and error details on failure.
+ */
+export declare function withSpinner<T>(message: string, fn: () => Promise<T>, doneMessage?: string): Promise<T>;
+/**
+ * Run a step with error handling — logs the error and exits.
+ * Use for steps that should abort the bootstrap on failure.
+ */
+export declare function runStep<T>(title: string, fn: () => Promise<T>): Promise<T>;
+export { pc, p };

package/dist/utils/log.js

@@ -0,0 +1,96 @@
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+export const log = {
+    step: (msg) => p.log.step(pc.cyan(msg)),
+    success: (msg) => p.log.success(pc.green(msg)),
+    warn: (msg) => p.log.warning(pc.yellow(msg)),
+    error: (msg) => p.log.error(pc.red(msg)),
+    info: (msg) => p.log.info(msg),
+    message: (msg) => p.log.message(msg),
+    detail: (msg) => p.log.message(pc.dim(msg)),
+};
+export function header(title, subtitle) {
+    console.log();
+    p.intro(pc.bgCyan(pc.black(` ${title} `)));
+    if (subtitle) {
+        p.log.info(pc.dim(subtitle));
+    }
+}
+export function summary(title, entries) {
+    const lines = Object.entries(entries)
+        .map(([key, value]) => `${pc.bold(key + ":")}  ${pc.cyan(value)}`)
+        .join("\n");
+    p.note(lines, title);
+}
+export function nextSteps(steps) {
+    const lines = steps
+        .map((s, i) => `${pc.bold(`${i + 1}.`)} ${s}`)
+        .join("\n");
+    p.note(lines, "Next Steps");
+}
+export function finish(msg) {
+    p.outro(pc.green(msg));
+}
+export function handleCancel() {
+    p.cancel("Operation cancelled.");
+    return process.exit(0);
+}
+/**
+ * Format an error for display — extracts stderr, stdout, and message.
+ */
+export function formatError(err) {
+    const e = err;
+    const parts = [];
+    if (e.stderr)
+        parts.push(e.stderr.trim());
+    else if (e.message)
+        parts.push(e.message);
+    if (e.stdout)
+        parts.push(pc.dim(e.stdout.trim()));
+    return parts.join("\n");
+}
+/**
+ * Wrap an async task with a @clack/prompts spinner.
+ * Shows command output on success (if string) and error details on failure.
+ */
+export async function withSpinner(message, fn, doneMessage) {
+    const s = p.spinner();
+    s.start(message);
+    try {
+        const result = await fn();
+        s.stop(doneMessage ?? pc.green(message));
+        if (typeof result === "string" && result.trim()) {
+            log.detail(result.trim());
+        }
+        return result;
+    }
+    catch (err) {
+        s.stop(pc.red(`Failed: ${message}`));
+        const details = formatError(err);
+        if (details)
+            log.error(details);
+        throw err;
+    }
+}
+/**
+ * Run a step with error handling — logs the error and exits.
+ * Use for steps that should abort the bootstrap on failure.
+ */
+export async function runStep(title, fn) {
+    log.step(title);
+    try {
+        const result = await fn();
+        if (typeof result === "string" && result.trim()) {
+            log.detail(result.trim());
+        }
+        return result;
+    }
+    catch (err) {
+        const details = formatError(err);
+        if (details)
+            log.error(details);
+        return process.exit(1);
+    }
+}
+export { pc, p };
+//# sourceMappingURL=log.js.map

package/dist/utils/log.js.map

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

package/dist/utils/platform.d.ts

@@ -0,0 +1,7 @@
+export type OS = "darwin" | "linux";
+export type Arch = "amd64" | "arm64";
+export declare function getOS(): OS;
+export declare function getArch(): Arch;
+export declare const isMacOS: () => boolean;
+export declare const isLinux: () => boolean;
+export declare const isCI: () => boolean;

package/dist/utils/platform.js

@@ -0,0 +1,21 @@
+import os from "node:os";
+export function getOS() {
+    const p = os.platform();
+    if (p === "darwin")
+        return "darwin";
+    if (p === "linux")
+        return "linux";
+    throw new Error(`Unsupported platform: ${p}`);
+}
+export function getArch() {
+    const a = os.arch();
+    if (a === "x64")
+        return "amd64";
+    if (a === "arm64")
+        return "arm64";
+    throw new Error(`Unsupported architecture: ${a}`);
+}
+export const isMacOS = () => getOS() === "darwin";
+export const isLinux = () => getOS() === "linux";
+export const isCI = () => process.env.CI === "true";
+//# sourceMappingURL=platform.js.map

package/dist/utils/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAKzB,MAAM,UAAU,KAAK;IACnB,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IACxB,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACpC,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAClC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IACpB,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,OAAO,CAAC;IAChC,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAClC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,GAAY,EAAE,CAAC,KAAK,EAAE,KAAK,QAAQ,CAAC;AAC3D,MAAM,CAAC,MAAM,OAAO,GAAG,GAAY,EAAE,CAAC,KAAK,EAAE,KAAK,OAAO,CAAC;AAC1D,MAAM,CAAC,MAAM,IAAI,GAAG,GAAY,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,CAAC"}

package/dist/utils/shell.d.ts

@@ -0,0 +1,41 @@
+import { type StdioOptions } from "node:child_process";
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Run a command synchronously, returning trimmed stdout.
+ * Throws on non-zero exit.
+ */
+export declare function exec(command: string, opts?: {
+    cwd?: string;
+    env?: Record<string, string>;
+}): string;
+/**
+ * Run a command synchronously, never throws.
+ */
+export declare function execSafe(command: string, opts?: {
+    cwd?: string;
+}): ExecResult;
+/**
+ * Run a command asynchronously (for use with spinners).
+ */
+export declare function execAsync(command: string, opts?: {
+    cwd?: string;
+}): Promise<string>;
+/**
+ * Run a command with output streamed to the terminal (inherit stdio).
+ */
+export declare function streamExec(command: string, opts?: {
+    cwd?: string;
+    stdio?: StdioOptions;
+}): void;
+/**
+ * Run a command with spawnSync for finer arg control.
+ */
+export declare function run(cmd: string, args: string[], opts?: {
+    cwd?: string;
+    stdio?: StdioOptions;
+}): ExecResult;
+export declare function commandExists(name: string): boolean;

package/dist/utils/shell.js

@@ -0,0 +1,86 @@
+import { execSync, exec as execCb, spawnSync, } from "node:child_process";
+/**
+ * Run a command synchronously, returning trimmed stdout.
+ * Throws on non-zero exit.
+ */
+export function exec(command, opts) {
+    return execSync(command, {
+        encoding: "utf-8",
+        cwd: opts?.cwd,
+        env: { ...process.env, ...opts?.env },
+        stdio: ["pipe", "pipe", "pipe"],
+        maxBuffer: 10 * 1024 * 1024,
+    }).trim();
+}
+/**
+ * Run a command synchronously, never throws.
+ */
+export function execSafe(command, opts) {
+    try {
+        const stdout = execSync(command, {
+            encoding: "utf-8",
+            cwd: opts?.cwd,
+            stdio: "pipe",
+        }).trim();
+        return { stdout, stderr: "", exitCode: 0 };
+    }
+    catch (err) {
+        const e = err;
+        return {
+            stdout: e.stdout?.toString().trim() ?? "",
+            stderr: e.stderr?.toString().trim() ?? "",
+            exitCode: e.status ?? 1,
+        };
+    }
+}
+/**
+ * Run a command asynchronously (for use with spinners).
+ */
+export function execAsync(command, opts) {
+    return new Promise((resolve, reject) => {
+        execCb(command, {
+            encoding: "utf-8",
+            cwd: opts?.cwd,
+            maxBuffer: 10 * 1024 * 1024,
+        }, (error, stdout, stderr) => {
+            if (error) {
+                const wrapped = new Error(stderr || error.message);
+                wrapped.exitCode = error.code;
+                wrapped.stdout = stdout;
+                reject(wrapped);
+            }
+            else {
+                resolve(stdout.trim());
+            }
+        });
+    });
+}
+/**
+ * Run a command with output streamed to the terminal (inherit stdio).
+ */
+export function streamExec(command, opts) {
+    execSync(command, {
+        cwd: opts?.cwd,
+        stdio: opts?.stdio ?? "inherit",
+    });
+}
+/**
+ * Run a command with spawnSync for finer arg control.
+ */
+export function run(cmd, args, opts) {
+    const result = spawnSync(cmd, args, {
+        encoding: "utf-8",
+        stdio: opts?.stdio ?? "pipe",
+        cwd: opts?.cwd,
+    });
+    return {
+        stdout: result.stdout?.trim() ?? "",
+        stderr: result.stderr?.trim() ?? "",
+        exitCode: result.status ?? 1,
+    };
+}
+export function commandExists(name) {
+    const { exitCode } = execSafe(`command -v ${name}`);
+    return exitCode === 0;
+}
+//# sourceMappingURL=shell.js.map

package/dist/utils/shell.js.map

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

package/dist/utils/wizard.d.ts

@@ -0,0 +1,16 @@
+declare const BACK: unique symbol;
+export type StepResult<T> = T | typeof BACK;
+export declare function back<T>(): StepResult<T>;
+export interface WizardField<T> {
+    id: string;
+    section: string;
+    run: (state: T) => Promise<StepResult<T>>;
+    review: (state: T) => [label: string, value: string];
+    /** Skip prompting during forward pass (field still shows in review) */
+    skip?: (state: T) => boolean;
+    /** Hide from review table entirely (field is not applicable) */
+    hidden?: (state: T) => boolean;
+}
+declare function maskSecret(value: string): string;
+export { maskSecret };
+export declare function stepWizard<T>(fields: WizardField<T>[], initialState: T): Promise<T>;

package/dist/utils/wizard.js

@@ -0,0 +1,117 @@
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import { handleCancel } from "./log.js";
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+const BACK = Symbol("wizard-back");
+export function back() {
+    return BACK;
+}
+function isBack(result) {
+    return result === BACK;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function maskSecret(value) {
+    if (!value || value.length < 8)
+        return value ? "••••" : pc.dim("(empty)");
+    return value.slice(0, 4) + "••••" + value.slice(-4);
+}
+export { maskSecret };
+function uniqueSections(fields) {
+    const seen = new Set();
+    const result = [];
+    for (const f of fields) {
+        if (!seen.has(f.section)) {
+            seen.add(f.section);
+            result.push(f.section);
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Step-by-step navigation within a subset of fields.
+// Ctrl+C = go back one non-skipped field.
+// Returns false if the user backed out past the first field in the subset.
+// ---------------------------------------------------------------------------
+async function runFieldSlice(fields, state, opts) {
+    let step = 0;
+    const shouldSkip = (f, s) => f.hidden?.(s) || (!opts?.ignoreSkip && f.skip?.(s));
+    while (step < fields.length) {
+        const field = fields[step];
+        if (shouldSkip(field, state.current)) {
+            step++;
+            continue;
+        }
+        const result = await field.run(state.current);
+        if (isBack(result)) {
+            let prev = step - 1;
+            while (prev >= 0 && shouldSkip(fields[prev], state.current)) {
+                prev--;
+            }
+            if (prev < 0)
+                return false;
+            step = prev;
+            continue;
+        }
+        state.current = result;
+        step++;
+    }
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export async function stepWizard(fields, initialState) {
+    const state = { current: initialState };
+    // ── Initial forward pass with per-field back ─────────────────────────
+    const completed = await runFieldSlice(fields, state);
+    if (!completed)
+        handleCancel();
+    // ── Review / edit loop ───────────────────────────────────────────────
+    const sections = uniqueSections(fields);
+    while (true) {
+        const reviewLines = [];
+        for (const section of sections) {
+            const sectionFields = fields.filter((f) => f.section === section);
+            const visibleFields = sectionFields.filter((f) => !f.hidden?.(state.current));
+            if (visibleFields.length === 0)
+                continue;
+            reviewLines.push(pc.bold(pc.cyan(section)));
+            for (const field of visibleFields) {
+                const [label, value] = field.review(state.current);
+                reviewLines.push(`  ${pc.dim(label + ":")} ${value}`);
+            }
+            reviewLines.push("");
+        }
+        p.note(reviewLines.join("\n"), "Configuration Review");
+        const visibleSections = sections.filter((s) => fields.some((f) => f.section === s && !f.hidden?.(state.current)));
+        const action = await p.select({
+            message: "How would you like to proceed?",
+            options: [
+                {
+                    value: "_confirm",
+                    label: "Confirm and proceed",
+                    hint: "start bootstrap",
+                },
+                ...visibleSections.map((s) => ({
+                    value: s,
+                    label: `Edit: ${s}`,
+                })),
+                { value: "_cancel", label: "Cancel" },
+            ],
+        });
+        if (p.isCancel(action))
+            handleCancel();
+        if (action === "_confirm")
+            break;
+        if (action === "_cancel")
+            handleCancel();
+        const sectionFields = fields.filter((f) => f.section === action);
+        await runFieldSlice(sectionFields, state, { ignoreSkip: true });
+    }
+    return state.current;
+}
+//# sourceMappingURL=wizard.js.map