clawdlets 0.0.1 → 0.2.0

package/dist/commands/cattle/spawn.d.ts

@@ -0,0 +1,73 @@
+export declare const cattleSpawn: import("citty").CommandDef<{
+    runtimeDir: {
+        type: "string";
+        description: string;
+    };
+    host: {
+        type: "string";
+        description: string;
+    };
+    persona: {
+        type: "string";
+        description: string;
+        required: true;
+    };
+    taskFile: {
+        type: "string";
+        description: string;
+        required: true;
+    };
+    ttl: {
+        type: "string";
+        description: string;
+    };
+    image: {
+        type: "string";
+        description: string;
+    };
+    serverType: {
+        type: "string";
+        description: string;
+    };
+    location: {
+        type: "string";
+        description: string;
+    };
+    autoShutdown: {
+        type: "boolean";
+        description: string;
+    };
+    withGithubToken: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+    socket: {
+        type: "string";
+        description: string;
+    };
+    requester: {
+        type: "string";
+        description: string;
+    };
+    idempotencyKey: {
+        type: "string";
+        description: string;
+    };
+    wait: {
+        type: "boolean";
+        description: string;
+        default: true;
+    };
+    waitTimeout: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    dryRun: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+}>;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/commands/cattle/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/commands/cattle/spawn.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0JtB,CAAC"}

package/dist/commands/cattle/spawn.js

@@ -0,0 +1,147 @@
+import path from "node:path";
+import process from "node:process";
+import { defineCommand } from "citty";
+import { CLF_PROTOCOL_VERSION, createClfClient } from "@clawdlets/clf-queue";
+import { sanitizeOperatorId } from "@clawdlets/core/lib/identifiers";
+import { openCattleState } from "@clawdlets/core/lib/cattle-state";
+import { loadHostContextOrExit } from "../../lib/context.js";
+import { loadTaskFromFile, requireEnabled, requireFile, requireTtlSeconds, unixSecondsNow, waitForClfJobTerminal } from "./common.js";
+export const cattleSpawn = defineCommand({
+    meta: { name: "spawn", description: "Enqueue a cattle.spawn job via clf-orchestrator (no secrets in user_data)." },
+    args: {
+        runtimeDir: { type: "string", description: "Runtime directory (default: .clawdlets)." },
+        host: { type: "string", description: "Host name (defaults to clawdlets.json defaultHost / sole host)." },
+        persona: { type: "string", description: "Persona name.", required: true },
+        taskFile: { type: "string", description: "Task JSON file (schemaVersion 1).", required: true },
+        ttl: { type: "string", description: "TTL override (default: cattle.hetzner.defaultTtl)." },
+        image: { type: "string", description: "Hetzner image override (default: cattle.hetzner.image)." },
+        serverType: { type: "string", description: "Hetzner server type override (default: cattle.hetzner.serverType)." },
+        location: { type: "string", description: "Hetzner location override (default: cattle.hetzner.location)." },
+        autoShutdown: { type: "boolean", description: "Auto poweroff after task (default: cattle.defaults.autoShutdown)." },
+        withGithubToken: { type: "boolean", description: "Include GITHUB_TOKEN in cattle env (explicit).", default: false },
+        socket: { type: "string", description: "clf-orchestrator unix socket path (default: /run/clf/orchestrator.sock)." },
+        requester: { type: "string", description: "Requester id (default: $USER)." },
+        idempotencyKey: { type: "string", description: "Idempotency key (optional)." },
+        wait: { type: "boolean", description: "Wait for job completion.", default: true },
+        waitTimeout: { type: "string", description: "Wait timeout seconds.", default: "300" },
+        dryRun: { type: "boolean", description: "Print enqueue request without enqueueing.", default: false },
+    },
+    async run({ args }) {
+        const cwd = process.cwd();
+        const ctx = loadHostContextOrExit({ cwd, runtimeDir: args.runtimeDir, hostArg: args.host });
+        if (!ctx)
+            return;
+        const { layout, config } = ctx;
+        requireEnabled({
+            enabled: Boolean(config.cattle?.enabled),
+            hint: "cattle is disabled (set cattle.enabled=true in fleet/clawdlets.json)",
+        });
+        const persona = String(args.persona || "").trim();
+        if (!persona)
+            throw new Error("missing --persona");
+        const taskFileRaw = String(args.taskFile || "").trim();
+        if (!taskFileRaw)
+            throw new Error("missing --task-file");
+        const taskFile = path.isAbsolute(taskFileRaw) ? taskFileRaw : path.resolve(cwd, taskFileRaw);
+        requireFile(taskFile, "task file");
+        const taskFromFile = loadTaskFromFile(taskFile);
+        const task = { ...taskFromFile, callbackUrl: "" };
+        const ttlRaw = String(args.ttl || config.cattle?.hetzner?.defaultTtl || "").trim();
+        if (ttlRaw)
+            requireTtlSeconds(ttlRaw);
+        const payload = {
+            persona,
+            task,
+            ttl: ttlRaw,
+            image: String(args.image || config.cattle?.hetzner?.image || "").trim(),
+            serverType: String(args.serverType || config.cattle?.hetzner?.serverType || "").trim(),
+            location: String(args.location || config.cattle?.hetzner?.location || "").trim(),
+            ...(typeof args.autoShutdown === "boolean"
+                ? { autoShutdown: Boolean(args.autoShutdown) }
+                : typeof config.cattle?.defaults?.autoShutdown === "boolean"
+                    ? { autoShutdown: Boolean(config.cattle.defaults.autoShutdown) }
+                    : {}),
+            ...(args.withGithubToken ? { withGithubToken: true } : {}),
+        };
+        const socketPath = String(args.socket || process.env.CLF_SOCKET_PATH || "/run/clf/orchestrator.sock").trim();
+        if (!socketPath)
+            throw new Error("missing --socket (or set CLF_SOCKET_PATH)");
+        const requester = sanitizeOperatorId(String(args.requester || process.env.USER || "operator"));
+        const idempotencyKey = String(args.idempotencyKey || "").trim();
+        const request = {
+            protocolVersion: CLF_PROTOCOL_VERSION,
+            requester,
+            idempotencyKey,
+            kind: "cattle.spawn",
+            payload,
+            runAt: "",
+            priority: 0,
+        };
+        if (args.dryRun) {
+            console.log(JSON.stringify({ action: "clf.jobs.enqueue", socketPath, request }, null, 2));
+            return;
+        }
+        const client = createClfClient({ socketPath });
+        const res = await client.enqueue(request);
+        const waitTimeoutRaw = String(args.waitTimeout || "300").trim();
+        if (!/^\d+$/.test(waitTimeoutRaw) || Number(waitTimeoutRaw) <= 0) {
+            throw new Error(`invalid --wait-timeout: ${waitTimeoutRaw}`);
+        }
+        const timeoutMs = Number(waitTimeoutRaw) * 1000;
+        if (!args.wait) {
+            console.log(res.jobId);
+            return;
+        }
+        const job = await waitForClfJobTerminal({
+            client,
+            jobId: res.jobId,
+            timeoutMs,
+            pollMs: 1_000,
+        });
+        if (job.status !== "done") {
+            const err = String(job.lastError || "").trim();
+            throw new Error(`spawn job ${res.jobId} ${job.status}${err ? `: ${err}` : ""}`);
+        }
+        const server = job.result?.server;
+        if (server && typeof server === "object") {
+            const id = String(server.id || "").trim();
+            const name = String(server.name || "").trim();
+            const ipv4 = String(server.ipv4 || "").trim();
+            const createdAtIso = String(server.createdAt || "").trim();
+            const expiresAtIso = String(server.expiresAt || "").trim();
+            const createdAt = Number.isFinite(Date.parse(createdAtIso)) ? Math.floor(Date.parse(createdAtIso) / 1000) : unixSecondsNow();
+            const expiresAt = Number.isFinite(Date.parse(expiresAtIso)) ? Math.floor(Date.parse(expiresAtIso) / 1000) : 0;
+            const ttlSeconds = typeof server.ttlSeconds === "number" && Number.isFinite(server.ttlSeconds)
+                ? Math.max(0, Math.floor(server.ttlSeconds))
+                : Math.max(0, expiresAt - createdAt);
+            const labels = server.labels && typeof server.labels === "object" && !Array.isArray(server.labels)
+                ? server.labels
+                : {};
+            if (id && name) {
+                const st = openCattleState(layout.cattleDbPath);
+                try {
+                    st.upsertServer({
+                        id,
+                        name,
+                        persona: String(server.persona || persona),
+                        task: String(server.taskId || task.taskId),
+                        taskId: String(server.taskId || task.taskId),
+                        ttlSeconds,
+                        createdAt,
+                        expiresAt,
+                        labels,
+                        lastStatus: String(server.status || "unknown"),
+                        lastIpv4: ipv4,
+                    });
+                }
+                finally {
+                    st.close();
+                }
+            }
+            console.log(`ok: spawned ${name || "cattle"} (id=${id || "?"} ipv4=${ipv4 || "?"} job=${res.jobId})`);
+            return;
+        }
+        console.log(`ok: spawn completed (job=${res.jobId})`);
+    },
+});
+//# sourceMappingURL=spawn.js.map

package/dist/commands/cattle/spawn.js.map

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

package/dist/commands/cattle/ssh.d.ts

@@ -0,0 +1,20 @@
+export declare const cattleSsh: import("citty").CommandDef<{
+    runtimeDir: {
+        type: "string";
+        description: string;
+    };
+    envFile: {
+        type: "string";
+        description: string;
+    };
+    host: {
+        type: "string";
+        description: string;
+    };
+    idOrName: {
+        type: "string";
+        description: string;
+        required: true;
+    };
+}>;
+//# sourceMappingURL=ssh.d.ts.map

package/dist/commands/cattle/ssh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh.d.ts","sourceRoot":"","sources":["../../../src/commands/cattle/ssh.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;EA+BpB,CAAC"}

package/dist/commands/cattle/ssh.js

@@ -0,0 +1,37 @@
+import process from "node:process";
+import { defineCommand } from "citty";
+import { loadDeployCreds } from "@clawdlets/core/lib/deploy-creds";
+import { buildCattleLabelSelector, listCattleServers } from "@clawdlets/core/lib/hcloud-cattle";
+import { run } from "@clawdlets/core/lib/run";
+import { loadHostContextOrExit } from "../../lib/context.js";
+import { requireEnabled, resolveOne, resolveTailscaleIpv4 } from "./common.js";
+export const cattleSsh = defineCommand({
+    meta: { name: "ssh", description: "SSH into a cattle VM over tailnet (admin@<tailscale-ip>)." },
+    args: {
+        runtimeDir: { type: "string", description: "Runtime directory (default: .clawdlets)." },
+        envFile: { type: "string", description: "Env file for deploy creds (default: <runtimeDir>/env)." },
+        host: { type: "string", description: "Host name (defaults to clawdlets.json defaultHost / sole host)." },
+        idOrName: { type: "string", description: "Cattle server id or name.", required: true },
+    },
+    async run({ args }) {
+        const cwd = process.cwd();
+        const ctx = loadHostContextOrExit({ cwd, runtimeDir: args.runtimeDir, hostArg: args.host });
+        if (!ctx)
+            return;
+        const { config } = ctx;
+        requireEnabled({
+            enabled: Boolean(config.cattle?.enabled),
+            hint: "cattle is disabled (set cattle.enabled=true in fleet/clawdlets.json)",
+        });
+        const deployCreds = loadDeployCreds({ cwd, runtimeDir: args.runtimeDir, envFile: args.envFile });
+        const hcloudToken = String(deployCreds.values.HCLOUD_TOKEN || "").trim();
+        if (!hcloudToken)
+            throw new Error("missing HCLOUD_TOKEN (set in .clawdlets/env or env var; run: clawdlets env init)");
+        const servers = await listCattleServers({ token: hcloudToken, labelSelector: buildCattleLabelSelector() });
+        const server = resolveOne(servers, String(args.idOrName || ""));
+        const ip = await resolveTailscaleIpv4(server.name);
+        const targetHost = `admin@${ip}`;
+        await run("ssh", ["-t", "--", targetHost], { redact: [] });
+    },
+});
+//# sourceMappingURL=ssh.js.map

package/dist/commands/cattle/ssh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh.js","sourceRoot":"","sources":["../../../src/commands/cattle/ssh.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAChG,OAAO,EAAE,GAAG,EAAE,MAAM,yBAAyB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE/E,MAAM,CAAC,MAAM,SAAS,GAAG,aAAa,CAAC;IACrC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,2DAA2D,EAAE;IAC/F,IAAI,EAAE;QACJ,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;QACvF,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wDAAwD,EAAE;QAClG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iEAAiE,EAAE;QACxG,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE,QAAQ,EAAE,IAAI,EAAE;KACvF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,qBAAqB,CAAC,EAAE,GAAG,EAAE,UAAU,EAAG,IAAY,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACrG,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;QAEvB,cAAc,CAAC;YACb,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;YACxC,IAAI,EAAE,sEAAsE;SAC7E,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,UAAU,EAAG,IAAY,CAAC,UAAU,EAAE,OAAO,EAAG,IAAY,CAAC,OAAO,EAAE,CAAC,CAAC;QACnH,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACzE,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;QAEtH,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,wBAAwB,EAAE,EAAE,CAAC,CAAC;QAC3G,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,CAAE,IAAY,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;QAEzE,MAAM,EAAE,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,SAAS,EAAE,EAAE,CAAC;QAEjC,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/cattle.d.ts

@@ -0,0 +1,2 @@
+export declare const cattle: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=cattle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cattle.d.ts","sourceRoot":"","sources":["../../src/commands/cattle.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,MAAM,qDAWjB,CAAC"}

package/dist/commands/cattle.js

@@ -0,0 +1,21 @@
+import { defineCommand } from "citty";
+import { cattleDestroy } from "./cattle/destroy.js";
+import { cattleList } from "./cattle/list.js";
+import { cattleLogs } from "./cattle/logs.js";
+import { cattlePersona } from "./cattle/persona.js";
+import { cattleReap } from "./cattle/reap.js";
+import { cattleSpawn } from "./cattle/spawn.js";
+import { cattleSsh } from "./cattle/ssh.js";
+export const cattle = defineCommand({
+    meta: { name: "cattle", description: "Cattle (ephemeral agents on Hetzner Cloud)." },
+    subCommands: {
+        spawn: cattleSpawn,
+        list: cattleList,
+        destroy: cattleDestroy,
+        reap: cattleReap,
+        logs: cattleLogs,
+        ssh: cattleSsh,
+        persona: cattlePersona,
+    },
+});
+//# sourceMappingURL=cattle.js.map

package/dist/commands/cattle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cattle.js","sourceRoot":"","sources":["../../src/commands/cattle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,MAAM,MAAM,GAAG,aAAa,CAAC;IAClC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE;IACpF,WAAW,EAAE;QACX,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,aAAa;QACtB,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,SAAS;QACd,OAAO,EAAE,aAAa;KACvB;CACF,CAAC,CAAC"}

package/dist/commands/config.d.ts

@@ -0,0 +1,2 @@
+export declare const config: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AA2JA,eAAO,MAAM,MAAM,qDAGjB,CAAC"}

package/dist/commands/config.js

@@ -0,0 +1,148 @@
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import { defineCommand } from "citty";
+import { ensureDir } from "@clawdlets/core/lib/fs-safe";
+import { splitDotPath } from "@clawdlets/core/lib/dot-path";
+import { findRepoRoot } from "@clawdlets/core/lib/repo";
+import { getRepoLayout } from "@clawdlets/core/repo-layout";
+import { createDefaultClawdletsConfig, ClawdletsConfigSchema, loadClawdletsConfig, writeClawdletsConfig, } from "@clawdlets/core/lib/clawdlets-config";
+function getAtPath(obj, parts) {
+    let cur = obj;
+    for (const k of parts) {
+        if (cur == null || typeof cur !== "object")
+            return undefined;
+        cur = cur[k];
+    }
+    return cur;
+}
+function setAtPath(obj, parts, value) {
+    let cur = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const k = parts[i];
+        if (cur[k] == null || typeof cur[k] !== "object" || Array.isArray(cur[k]))
+            cur[k] = {};
+        cur = cur[k];
+    }
+    cur[parts[parts.length - 1]] = value;
+}
+function deleteAtPath(obj, parts) {
+    let cur = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const k = parts[i];
+        if (cur == null || typeof cur !== "object")
+            return false;
+        cur = cur[k];
+    }
+    const last = parts[parts.length - 1];
+    if (cur && typeof cur === "object" && Object.prototype.hasOwnProperty.call(cur, last)) {
+        delete cur[last];
+        return true;
+    }
+    return false;
+}
+const init = defineCommand({
+    meta: { name: "init", description: "Initialize fleet/clawdlets.json (canonical config)." },
+    args: {
+        host: { type: "string", description: "Initial host name.", default: "clawdbot-fleet-host" },
+        force: { type: "boolean", description: "Overwrite existing clawdlets.json.", default: false },
+        "dry-run": { type: "boolean", description: "Print planned writes without writing.", default: false },
+    },
+    async run({ args }) {
+        const repoRoot = findRepoRoot(process.cwd());
+        const host = String(args.host || "clawdbot-fleet-host").trim() || "clawdbot-fleet-host";
+        const configPath = getRepoLayout(repoRoot).clawdletsConfigPath;
+        if (fs.existsSync(configPath) && !args.force) {
+            throw new Error(`config already exists (pass --force to overwrite): ${configPath}`);
+        }
+        const config = createDefaultClawdletsConfig({ host });
+        if (args["dry-run"]) {
+            console.log(`planned: write ${path.relative(repoRoot, configPath)}`);
+            return;
+        }
+        await ensureDir(path.dirname(configPath));
+        await writeClawdletsConfig({ configPath, config });
+        console.log(`ok: wrote ${path.relative(repoRoot, configPath)}`);
+    },
+});
+const show = defineCommand({
+    meta: { name: "show", description: "Print fleet/clawdlets.json." },
+    args: {
+        pretty: { type: "boolean", description: "Pretty-print JSON.", default: true },
+    },
+    async run({ args }) {
+        const repoRoot = findRepoRoot(process.cwd());
+        const { config } = loadClawdletsConfig({ repoRoot });
+        console.log(args.pretty ? JSON.stringify(config, null, 2) : JSON.stringify(config));
+    },
+});
+const validate = defineCommand({
+    meta: { name: "validate", description: "Validate fleet/clawdlets.json schema." },
+    args: {},
+    async run() {
+        const repoRoot = findRepoRoot(process.cwd());
+        loadClawdletsConfig({ repoRoot });
+        console.log("ok");
+    },
+});
+const get = defineCommand({
+    meta: { name: "get", description: "Get a value from fleet/clawdlets.json (dot path)." },
+    args: {
+        path: { type: "string", description: "Dot path (e.g. fleet.botOrder)." },
+        json: { type: "boolean", description: "JSON output.", default: false },
+    },
+    async run({ args }) {
+        const repoRoot = findRepoRoot(process.cwd());
+        const { config } = loadClawdletsConfig({ repoRoot });
+        const parts = splitDotPath(String(args.path || ""));
+        const v = getAtPath(config, parts);
+        if (args.json)
+            console.log(JSON.stringify({ path: parts.join("."), value: v }, null, 2));
+        else
+            console.log(typeof v === "string" ? v : JSON.stringify(v, null, 2));
+    },
+});
+const set = defineCommand({
+    meta: { name: "set", description: "Set a value in fleet/clawdlets.json (dot path)." },
+    args: {
+        path: { type: "string", description: "Dot path (e.g. fleet.botOrder)." },
+        value: { type: "string", description: "String value." },
+        "value-json": { type: "string", description: "JSON value (parsed)." },
+        delete: { type: "boolean", description: "Delete the key at path.", default: false },
+    },
+    async run({ args }) {
+        const repoRoot = findRepoRoot(process.cwd());
+        const { configPath, config } = loadClawdletsConfig({ repoRoot });
+        const parts = splitDotPath(String(args.path || ""));
+        const next = structuredClone(config);
+        if (args.delete) {
+            const ok = deleteAtPath(next, parts);
+            if (!ok)
+                throw new Error(`path not found: ${parts.join(".")}`);
+        }
+        else if (args["value-json"] !== undefined) {
+            let parsed;
+            try {
+                parsed = JSON.parse(String(args["value-json"]));
+            }
+            catch {
+                throw new Error("invalid --value-json (must be valid JSON)");
+            }
+            setAtPath(next, parts, parsed);
+        }
+        else if (args.value !== undefined) {
+            setAtPath(next, parts, String(args.value));
+        }
+        else {
+            throw new Error("set requires --value or --value-json (or --delete)");
+        }
+        const validated = ClawdletsConfigSchema.parse(next);
+        await writeClawdletsConfig({ configPath, config: validated });
+        console.log("ok");
+    },
+});
+export const config = defineCommand({
+    meta: { name: "config", description: "Canonical config (fleet/clawdlets.json)." },
+    subCommands: { init, show, validate, get, set },
+});
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,sCAAsC,CAAC;AAE9C,SAAS,SAAS,CAAC,GAAQ,EAAE,KAAe;IAC1C,IAAI,GAAG,GAAQ,GAAG,CAAC;IACnB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC7D,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,SAAS,CAAC,GAAQ,EAAE,KAAe,EAAE,KAAc;IAC1D,IAAI,GAAG,GAAQ,GAAG,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACpB,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QACvF,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,GAAG,KAAK,CAAC;AACxC,CAAC;AAED,SAAS,YAAY,CAAC,GAAQ,EAAE,KAAe;IAC7C,IAAI,GAAG,GAAQ,GAAG,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACpB,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACzD,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IACtC,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QACtF,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,IAAI,GAAG,aAAa,CAAC;IACzB,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,qDAAqD,EAAE;IAC1F,IAAI,EAAE;QACJ,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE,OAAO,EAAE,qBAAqB,EAAE;QAC3F,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,oCAAoC,EAAE,OAAO,EAAE,KAAK,EAAE;QAC7F,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,uCAAuC,EAAE,OAAO,EAAE,KAAK,EAAE;KACrG;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,qBAAqB,CAAC,CAAC,IAAI,EAAE,IAAI,qBAAqB,CAAC;QACxF,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,mBAAmB,CAAC;QAE/D,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,sDAAsD,UAAU,EAAE,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,MAAM,GAAG,4BAA4B,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtD,IAAK,IAAY,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QAED,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QAC1C,MAAM,oBAAoB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;CACF,CAAC,CAAC;AAGH,MAAM,IAAI,GAAG,aAAa,CAAC;IACzB,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,6BAA6B,EAAE;IAClE,IAAI,EAAE;QACJ,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,oBAAoB,EAAE,OAAO,EAAE,IAAI,EAAE;KAC9E;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7C,MAAM,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACtF,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,aAAa,CAAC;IAC7B,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,uCAAuC,EAAE;IAChF,IAAI,EAAE,EAAE;IACR,KAAK,CAAC,GAAG;QACP,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7C,mBAAmB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,GAAG,GAAG,aAAa,CAAC;IACxB,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,mDAAmD,EAAE;IACvF,IAAI,EAAE;QACJ,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;QACxE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE;KACvE;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7C,MAAM,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,SAAS,CAAC,MAAa,EAAE,KAAK,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;;YACpF,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,GAAG,GAAG,aAAa,CAAC;IACxB,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,iDAAiD,EAAE;IACrF,IAAI,EAAE;QACJ,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;QACxE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;QACvD,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;QACrE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,yBAAyB,EAAE,OAAO,EAAE,KAAK,EAAE;KACpF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7C,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QAEpD,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAQ,CAAC;QAE5C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACrC,IAAI,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;aAAM,IAAK,IAAY,CAAC,YAAY,CAAC,KAAK,SAAS,EAAE,CAAC;YACrD,IAAI,MAAe,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAE,IAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC3D,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC/D,CAAC;YACD,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACpC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,oBAAoB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,aAAa,CAAC;IAClC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;IACjF,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE;CAChD,CAAC,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,35 @@
+export declare const doctor: import("citty").CommandDef<{
+    runtimeDir: {
+        type: "string";
+        description: string;
+    };
+    envFile: {
+        type: "string";
+        description: string;
+    };
+    host: {
+        type: "string";
+        description: string;
+    };
+    scope: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    json: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+    "show-ok": {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+    strict: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+}>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwDjB,CAAC"}

package/dist/commands/doctor.js

@@ -0,0 +1,65 @@
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import { defineCommand } from "citty";
+import { collectDoctorChecks } from "@clawdlets/core/doctor";
+import { findRepoRoot } from "@clawdlets/core/lib/repo";
+import { resolveHostNameOrExit } from "../lib/host-resolve.js";
+import { renderDoctorReport } from "../lib/doctor-render.js";
+export const doctor = defineCommand({
+    meta: {
+        name: "doctor",
+        description: "Validate repo + runtime inputs for deploying a host.",
+    },
+    args: {
+        runtimeDir: { type: "string", description: "Runtime directory (default: .clawdlets)." },
+        envFile: { type: "string", description: "Env file for deploy creds (default: <runtimeDir>/env)." },
+        host: { type: "string", description: "Host name (defaults to clawdlets.json defaultHost / sole host)." },
+        scope: {
+            type: "string",
+            description: "Which checks to run: repo | bootstrap | server-deploy | cattle | all (default: all).",
+            default: "all",
+        },
+        json: { type: "boolean", description: "Output JSON.", default: false },
+        "show-ok": { type: "boolean", description: "Show ok checks too.", default: false },
+        strict: { type: "boolean", description: "Fail on warn too (deploy gating).", default: false },
+    },
+    async run({ args }) {
+        const cwd = process.cwd();
+        const scopeRaw = String(args.scope || "all").trim();
+        if (scopeRaw !== "repo" && scopeRaw !== "bootstrap" && scopeRaw !== "server-deploy" && scopeRaw !== "cattle" && scopeRaw !== "all") {
+            throw new Error(`invalid --scope: ${scopeRaw} (expected repo|bootstrap|server-deploy|cattle|all)`);
+        }
+        const scope = scopeRaw;
+        if (scope === "repo") {
+            const repoRoot = findRepoRoot(cwd);
+            const templateSource = path.join(repoRoot, "config", "template-source.json");
+            const clawdletsConfig = path.join(repoRoot, "fleet", "clawdlets.json");
+            if (fs.existsSync(templateSource) && !fs.existsSync(clawdletsConfig)) {
+                console.log("note: CLI repo detected; run doctor in a project repo or via template-e2e.");
+                return;
+            }
+        }
+        const hostName = resolveHostNameOrExit({ cwd, runtimeDir: args.runtimeDir, hostArg: args.host });
+        if (!hostName)
+            return;
+        const checks = await collectDoctorChecks({
+            cwd,
+            runtimeDir: args.runtimeDir,
+            envFile: args.envFile,
+            host: hostName,
+            scope,
+        });
+        if (args.json) {
+            console.log(JSON.stringify({ scope: scopeRaw, host: hostName, checks }, null, 2));
+        }
+        else {
+            console.log(renderDoctorReport({ checks, host: hostName, scope, strict: args.strict, showOk: Boolean(args["show-ok"]) }));
+        }
+        if (checks.some((c) => c.status === "missing"))
+            process.exitCode = 1;
+        if (args.strict && checks.some((c) => c.status === "warn"))
+            process.exitCode = 1;
+    },
+});
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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