@dharta/cli 0.6.77

package/dist/money.js

@@ -0,0 +1,16 @@
+export function parseDollarAmountToCents(value, flag) {
+    const trimmed = value.trim();
+    const match = trimmed.match(/^(?:(\d+)(?:\.(\d{1,2}))?|\.(\d{1,2}))$/);
+    if (!match)
+        throw amountError(flag);
+    const dollars = match[1] ? Number(match[1]) : 0;
+    const centsPart = match[2] ?? match[3] ?? "";
+    const cents = dollars * 100 + Number(centsPart.padEnd(2, "0"));
+    if (!Number.isSafeInteger(cents) || cents <= 0)
+        throw amountError(flag);
+    return cents;
+}
+function amountError(flag) {
+    return new Error(`${flag} must be a dollar amount greater than 0 with at most two decimal places.`);
+}
+//# sourceMappingURL=money.js.map

package/dist/money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.js","sourceRoot":"","sources":["../src/money.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,wBAAwB,CAAC,KAAa,EAAE,IAAY;IAClE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACvE,IAAI,CAAC,KAAK;QAAE,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,GAAG,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,KAAK,CAAC,GAAG,IAAI,0EAA0E,CAAC,CAAC;AACtG,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,2 @@
+export declare function table(rows: Array<Record<string, string>>): string;
+export declare function fmtTs(ts: string | null | undefined): string;

package/dist/output.js

@@ -0,0 +1,20 @@
+// Output helpers. Tiny on purpose — the CLI's UX is "narrate one line
+// per row + occasional table"; pulling in cli-table or chalk costs
+// more than it buys at this scale.
+export function table(rows) {
+    if (rows.length === 0)
+        return "";
+    const cols = Object.keys(rows[0]);
+    const widths = cols.map((c) => Math.max(c.length, ...rows.map((r) => (r[c] ?? "").length)));
+    const pad = (s, w) => s + " ".repeat(Math.max(0, w - s.length));
+    const header = cols.map((c, i) => pad(c, widths[i])).join("  ");
+    const divider = widths.map((w) => "-".repeat(w)).join("  ");
+    const body = rows
+        .map((r) => cols.map((c, i) => pad(r[c] ?? "", widths[i])).join("  "))
+        .join("\n");
+    return `${header}\n${divider}\n${body}`;
+}
+export function fmtTs(ts) {
+    return ts ?? "—";
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,mEAAmE;AACnE,mCAAmC;AAEnC,MAAM,UAAU,KAAK,CAAC,IAAmC;IACvD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAC5D,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI;SACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACrE,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,GAAG,MAAM,KAAK,OAAO,KAAK,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAA6B;IACjD,OAAO,EAAE,IAAI,GAAG,CAAC;AACnB,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,19 @@
+import { spawn } from "node:child_process";
+export declare const DHARTA_RUNTIME_PIN = "0.6.77";
+export declare const UV_INSTALL_HINT: string;
+export interface RuntimeCommand {
+    command: string[];
+    source: "env-executable" | "env-checkout" | "uv";
+    description: string;
+}
+export interface RuntimeResolveOptions {
+    env?: NodeJS.ProcessEnv;
+    commandExists?: (cmd: string) => Promise<boolean>;
+}
+export declare function resolveRuntime(opts?: RuntimeResolveOptions): Promise<RuntimeCommand>;
+export declare function whichAll(cmd: string, env?: NodeJS.ProcessEnv): Promise<string[]>;
+export declare function spawnRuntime(runtime: RuntimeCommand, args: string[], options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    stdio?: "inherit" | "pipe";
+}): ReturnType<typeof spawn>;

package/dist/runtime.js

@@ -0,0 +1,95 @@
+// Runtime bootstrap for `dharta dev` (RFC 0013 CLI-3, decision D2): the
+// harness-adapter kernel lives in the Python `dharta-runtime` package,
+// single-sourced with production. The CLI resolves it via uv with a
+// version pin that ships inside each CLI release, so CLI and runtime
+// version as a pair. DHARTA_RUNTIME is the escape hatch (point it at a
+// checkout or an executable). Zero Python is ever visible on the happy
+// path; every failure prints the one remedial command.
+import { promises as fs } from "node:fs";
+import * as path from "node:path";
+import { spawn } from "node:child_process";
+// Ships with the CLI release; bump together with dharta-runtime.
+export const DHARTA_RUNTIME_PIN = "0.6.77";
+export const UV_INSTALL_HINT = "Install uv first:  curl -LsSf https://astral.sh/uv/install.sh | sh  (or: brew install uv)\n" +
+    "Then re-run dharta dev. To use a local checkout instead, set DHARTA_RUNTIME=/path/to/dharta-runtime.";
+// Resolve how to launch dharta-runtime. Throws with remedial guidance —
+// never a stack trace — when the bootstrap can't work.
+export async function resolveRuntime(opts = {}) {
+    const env = opts.env ?? process.env;
+    const exists = opts.commandExists ?? commandOnPath;
+    const override = env.DHARTA_RUNTIME;
+    if (override) {
+        const stat = await fs.stat(override).catch(() => null);
+        if (!stat) {
+            throw new Error(`DHARTA_RUNTIME points at ${override}, which does not exist. ` +
+                "Unset it to use the pinned runtime, or point it at a dharta-runtime checkout or executable.");
+        }
+        if (stat.isDirectory()) {
+            if (!(await exists("uv"))) {
+                throw new Error(`DHARTA_RUNTIME is a checkout, which needs uv to run.\n${UV_INSTALL_HINT}`);
+            }
+            return {
+                command: ["uv", "run", "--project", override, "dharta-runtime"],
+                source: "env-checkout",
+                description: `checkout at ${override} (DHARTA_RUNTIME)`,
+            };
+        }
+        return {
+            command: [override],
+            source: "env-executable",
+            description: `executable ${override} (DHARTA_RUNTIME)`,
+        };
+    }
+    // Check for the binary we actually launch (uvx ships with uv, but a
+    // partial install would otherwise surface as a raw spawn ENOENT).
+    if (!(await exists("uvx"))) {
+        throw new Error(`dharta dev needs uv to bootstrap the agent runtime.\n${UV_INSTALL_HINT}`);
+    }
+    return {
+        // uvx resolves and caches the pinned package on first use — the
+        // "install" step the user never sees.
+        command: ["uvx", "--from", `dharta-runtime==${DHARTA_RUNTIME_PIN}`, "dharta-runtime"],
+        source: "uv",
+        description: `dharta-runtime ${DHARTA_RUNTIME_PIN} via uv`,
+    };
+}
+// `which`-equivalent: scan PATH for an executable, returning every hit
+// in order. Used both for uv detection and the doctor's PATH-shadow
+// check (a stale pip-installed `dharta` shadowing this CLI). On Windows
+// the PATHEXT suffixes apply and the executable bit is meaningless.
+export async function whichAll(cmd, env = process.env) {
+    const dirs = (env.PATH ?? "").split(path.delimiter).filter(Boolean);
+    const win = process.platform === "win32";
+    const suffixes = win
+        ? (env.PATHEXT ?? ".COM;.EXE;.BAT;.CMD").split(";").map((s) => s.toLowerCase())
+        : [""];
+    const hits = [];
+    for (const dir of dirs) {
+        for (const suffix of suffixes) {
+            const candidate = path.join(dir, cmd + suffix);
+            try {
+                await fs.access(candidate, win ? fs.constants.F_OK : fs.constants.X_OK);
+                hits.push(candidate);
+                break;
+            }
+            catch {
+                // not here
+            }
+        }
+    }
+    return hits;
+}
+async function commandOnPath(cmd) {
+    return (await whichAll(cmd)).length > 0;
+}
+// Spawn the runtime with the resolved command + args, inheriting stdio
+// by default. The error path names the escape hatch.
+export function spawnRuntime(runtime, args, options = {}) {
+    const [cmd, ...prefix] = runtime.command;
+    return spawn(cmd, [...prefix, ...args], {
+        cwd: options.cwd,
+        env: options.env ?? process.env,
+        stdio: options.stdio ?? "inherit",
+    });
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/scaffold.d.ts

@@ -0,0 +1,16 @@
+import { type HarnessType } from "./harnesses.js";
+export interface ScaffoldOptions {
+    template?: string;
+    harness?: HarnessType;
+    baseUrl: string;
+    fetchImpl?: typeof fetch;
+    log?: (line: string) => void;
+}
+export interface ScaffoldResult {
+    template: string;
+    harness: HarnessType;
+    instructionFile: "CLAUDE.md" | "AGENTS.md";
+    files: string[];
+    source: "control-plane" | "bundled";
+}
+export declare function scaffoldTemplate(target: string, opts: ScaffoldOptions): Promise<ScaffoldResult>;

package/dist/scaffold.js

@@ -0,0 +1,74 @@
+// Template scaffolding, extracted from the old `dharta init` (RFC 0024 DEP-4c,
+// B.1): `dharta setup` reuses this to lay down a starter agent in a brand-new
+// folder. Unlike init it does NOT git-init or commit (setup prompts for git,
+// `dharta deploy` makes the first commit), does NOT require an empty directory
+// (setup configures folders that may already have files), never clobbers an
+// existing file, and skips dharta.toml - setup writes the self-documenting one.
+import { existsSync, promises as fs } from "node:fs";
+import * as path from "node:path";
+import { resolveTemplates } from "./templates.js";
+import { closestChoice, normalizeNonBlank } from "./validators.js";
+import { DEFAULT_CREATE_HARNESS, nativeInstructionFile, translateTemplateFilesForHarness, } from "./harnesses.js";
+export async function scaffoldTemplate(target, opts) {
+    const log = opts.log ?? ((line) => console.log(line));
+    const templateKey = opts.template === undefined ? "blank" : normalizeNonBlank(opts.template, "--template");
+    const harness = opts.harness ?? DEFAULT_CREATE_HARNESS;
+    const resolved = await resolveTemplates(opts.baseUrl, opts.fetchImpl);
+    if (resolved.source === "bundled") {
+        log("Could not reach the template service - using the bundled template set.");
+    }
+    const template = resolved.templates.find((t) => t.key === templateKey);
+    if (!template) {
+        const keys = resolved.templates.map((t) => t.key);
+        const suggestion = closestChoice(templateKey, keys);
+        throw new Error(`Unknown template '${templateKey}'. Available: ${keys.join(", ")}.` +
+            (suggestion ? ` Did you mean ${suggestion}?` : ""));
+    }
+    await fs.mkdir(target, { recursive: true });
+    const written = [];
+    const files = translateTemplateFilesForHarness(template.files, harness);
+    for (const [rel, content] of Object.entries(files)) {
+        if (rel === "dharta.toml")
+            continue; // setup owns identity (the commented manifest)
+        // Template files come from server JSON - never let a hostile path
+        // (../..) or non-string content escape the target directory.
+        const dest = path.resolve(target, rel);
+        if (dest !== target && !dest.startsWith(target + path.sep)) {
+            throw new Error(`Template file path escapes the target directory: ${rel}. ` +
+                "Re-run with a bundled template (--template blank) and report this.");
+        }
+        if (typeof content !== "string") {
+            throw new Error(`Template file ${rel} has non-text content. Re-run with --template blank and report this.`);
+        }
+        if (existsSync(dest))
+            continue; // never clobber the user's own file
+        await fs.mkdir(path.dirname(dest), { recursive: true });
+        await fs.writeFile(dest, content);
+        written.push(rel);
+    }
+    // .env binds the [env] declarations locally and must never be committed.
+    await ensureGitignoreHasDotEnv(target);
+    return {
+        template: template.key,
+        harness,
+        instructionFile: nativeInstructionFile(harness),
+        files: written,
+        source: resolved.source,
+    };
+}
+async function ensureGitignoreHasDotEnv(target) {
+    const file = path.join(target, ".gitignore");
+    let existing = "";
+    try {
+        existing = await fs.readFile(file, "utf8");
+    }
+    catch {
+        // no .gitignore yet
+    }
+    const lines = existing.split("\n").map((l) => l.trim());
+    if (lines.includes(".env"))
+        return;
+    const next = existing.length > 0 && !existing.endsWith("\n") ? `${existing}\n.env\n` : `${existing}.env\n`;
+    await fs.writeFile(file, next);
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

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

package/dist/setup-scan.d.ts

@@ -0,0 +1,21 @@
+import { type HarnessType } from "./harnesses.js";
+import type { DeployMethod } from "./manifest.js";
+export declare const MARKERS: (".claude" | "CLAUDE.md" | ".deepagents" | ".goose" | "dharta.toml" | ".opencode" | ".codex")[];
+export interface AgentFolder {
+    dir: string;
+    rel: string;
+    name?: string;
+    slug?: string;
+    configured: boolean;
+    deployEnabled: boolean;
+    deployMethod?: DeployMethod;
+    harnessType?: HarnessType;
+}
+export declare function findGitRoot(start: string): string | null;
+export interface ScanOptions {
+    isGitRepo?: boolean;
+    runGit?: (args: string[], cwd: string) => Promise<string | null>;
+}
+export declare function scanAgentFolders(root: string, opts?: ScanOptions): Promise<AgentFolder[]>;
+export declare function renderTable(folders: AgentFolder[]): string;
+export declare function describeFolder(dir: string, rel: string): Promise<AgentFolder>;

package/dist/setup-scan.js

@@ -0,0 +1,127 @@
+import { spawn } from "node:child_process";
+import { existsSync, promises as fs } from "node:fs";
+import * as path from "node:path";
+import TOML from "@iarna/toml";
+import { AGENT_MARKERS, hasAgentMarker, markerFolderRel, readDeclaredHarnessType, sniffHarnessType, } from "./harnesses.js";
+// `dharta setup` lists every agent folder so you can pick one to configure
+// (RFC 0024 DEP-4 / D10). A folder counts if it holds ANY harness/karta
+// marker - configured or not, repo root included. Detection never
+// auto-deploys; it just surfaces candidates.
+export const MARKERS = [...AGENT_MARKERS];
+// Walk up from `start` for a directory containing .git; null if none.
+export function findGitRoot(start) {
+    let dir = path.resolve(start);
+    for (;;) {
+        if (existsSync(path.join(dir, ".git")))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+// Every agent folder under `root`, sorted by relative path. In a git repo we
+// union git's view of marker files - tracked AND new-but-not-ignored, at ANY
+// depth (`--cached --others --exclude-standard`) - with a shallow walk that
+// also catches directory markers like `.claude`. Outside git it is the shallow
+// walk alone (root + immediate subdirs, RFC 0024 §4). The `--others` half is
+// what surfaces a freshly `dharta create`d folder before it is committed.
+export async function scanAgentFolders(root, opts = {}) {
+    const absRoot = path.resolve(root);
+    const rels = new Set();
+    if (opts.isGitRepo) {
+        const listed = await (opts.runGit ?? gitLsFiles)(["ls-files", "-z", "--cached", "--others", "--exclude-standard"], absRoot);
+        for (const p of (listed ?? "").split("\0")) {
+            if (!p)
+                continue;
+            const folder = markerFolderRel(p);
+            if (!folder)
+                continue;
+            rels.add(folder);
+        }
+    }
+    await shallowWalk(absRoot, rels);
+    const folders = [];
+    for (const rel of [...rels].sort()) {
+        folders.push(await describeFolder(path.resolve(absRoot, rel), rel));
+    }
+    return folders;
+}
+// Destination-agnostic setup table: folder, name, configured?, deploy enabled?,
+// and transport. Live release/version is joined separately by `dharta status`
+// when an authenticated profile is available.
+export function renderTable(folders) {
+    const headers = ["AGENT FOLDER", "NAME", "HARNESS", "CONFIGURED", "DEPLOY", "METHOD"];
+    const rows = folders.map((f) => [
+        f.rel === "." ? "./ (repo root)" : `./${f.rel}`,
+        f.name ?? "-",
+        f.harnessType ?? "-",
+        f.configured ? "yes" : "no",
+        f.configured ? (f.deployEnabled ? "enabled" : "disabled") : "-",
+        f.deployMethod ?? "-",
+    ]);
+    const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
+    const fmt = (cols) => cols.map((c, i) => c.padEnd(widths[i])).join("  ").trimEnd();
+    return [fmt(headers), ...rows.map(fmt)].join("\n");
+}
+async function shallowWalk(absRoot, rels) {
+    if (await hasMarker(absRoot))
+        rels.add(".");
+    let entries;
+    try {
+        entries = await fs.readdir(absRoot, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const e of entries) {
+        // Skip dot-dirs (incl. .git) and node_modules as CANDIDATES - a marker
+        // like .claude makes its PARENT an agent folder, not itself.
+        if (!e.isDirectory() || e.name === "node_modules" || e.name.startsWith("."))
+            continue;
+        if (await hasMarker(path.join(absRoot, e.name)))
+            rels.add(e.name);
+    }
+}
+async function hasMarker(dir) {
+    return hasAgentMarker(dir);
+}
+export async function describeFolder(dir, rel) {
+    const folder = { dir, rel: rel === "" ? "." : rel, configured: false, deployEnabled: false };
+    const tomlPath = path.join(dir, "dharta.toml");
+    if (!existsSync(tomlPath)) {
+        folder.harnessType = sniffHarnessType(dir);
+        return folder;
+    }
+    folder.configured = true;
+    try {
+        const raw = await fs.readFile(tomlPath, "utf8");
+        const parsed = TOML.parse(raw);
+        if (typeof parsed.name === "string")
+            folder.name = parsed.name;
+        if (typeof parsed.slug === "string")
+            folder.slug = parsed.slug;
+        folder.deployEnabled = parsed.deploy === true;
+        if (parsed.deploy_method === "git" || parsed.deploy_method === "folder") {
+            folder.deployMethod = parsed.deploy_method;
+        }
+        folder.harnessType = readDeclaredHarnessType(raw) ?? sniffHarnessType(dir);
+    }
+    catch {
+        // A malformed dharta.toml is still a configured folder; it stays
+        // nameless here and the manifest writer / build server reports the
+        // parse error when it matters.
+        folder.harnessType = sniffHarnessType(dir);
+    }
+    return folder;
+}
+function gitLsFiles(args, cwd) {
+    return new Promise((resolve) => {
+        const proc = spawn("git", args, { cwd, stdio: ["ignore", "pipe", "ignore"] });
+        const out = [];
+        proc.stdout.on("data", (c) => out.push(c));
+        proc.on("error", () => resolve(null));
+        proc.on("close", (code) => resolve(code === 0 ? Buffer.concat(out).toString("utf8") : null));
+    });
+}
+//# sourceMappingURL=setup-scan.js.map

package/dist/setup-scan.js.map

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

package/dist/templates.d.ts

@@ -0,0 +1,14 @@
+export interface Template {
+    key: string;
+    title: string;
+    description: string;
+    files: Record<string, string>;
+}
+export interface ResolvedTemplates {
+    templates: Template[];
+    source: "control-plane" | "bundled";
+}
+export declare const TEMPLATE_FETCH_TIMEOUT_MS = 3000;
+export declare function resolveTemplates(baseUrl: string, fetchImpl?: typeof fetch): Promise<ResolvedTemplates>;
+export declare function bundledTemplates(): Promise<Template[]>;
+export declare function bundledTemplatesRoot(): string;

package/dist/templates.js

@@ -0,0 +1,65 @@
+// Template resolution for `dharta setup` scaffolding (RFC 0013 CLI-2 / 0024
+// DEP-4c, decision D9): fetch the current set from the control plane so CLI
+// and dashboard scaffolds never drift, with the launch set bundled in the
+// package as the offline fallback.
+import { promises as fs } from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+// How long the control-plane fetch gets before we give up and take the bundled
+// set below. `dharta create` is often a new user's first command, so it must
+// not hang on a blackholed network. Exported because anything that kills the
+// CLI on its own clock - the packed-CLI smoke test - has to allow strictly
+// longer than this: kill the process first and the fallback never runs, so the
+// only evidence left is an empty stdout+stderr.
+export const TEMPLATE_FETCH_TIMEOUT_MS = 3000;
+export async function resolveTemplates(baseUrl, fetchImpl) {
+    try {
+        const f = (fetchImpl ?? globalThis.fetch).bind(globalThis);
+        const res = await f(`${baseUrl.replace(/\/+$/, "")}/agent_templates`, {
+            headers: { Accept: "application/json" },
+            signal: AbortSignal.timeout(TEMPLATE_FETCH_TIMEOUT_MS),
+        });
+        if (res.ok) {
+            const body = (await res.json());
+            if (Array.isArray(body.templates) && body.templates.length > 0) {
+                return { templates: body.templates, source: "control-plane" };
+            }
+        }
+    }
+    catch {
+        // fall through to the bundled set
+    }
+    return { templates: await bundledTemplates(), source: "bundled" };
+}
+// The launch set shipped inside the package (templates/ at the package
+// root, vendored from dharta-web's lib/agent_templates — a test pins the
+// two trees identical).
+export async function bundledTemplates() {
+    const root = bundledTemplatesRoot();
+    const meta = {
+        blank: {
+            title: "Blank",
+            description: "A minimal skeleton. Start from an empty native instruction outline.",
+        },
+        "faq-agent": {
+            title: "FAQ agent",
+            description: "A worked support-agent example: persona, knowledge section, escalation rule.",
+        },
+    };
+    const templates = [];
+    for (const key of Object.keys(meta)) {
+        const dir = path.join(root, key);
+        const files = {};
+        for (const name of await fs.readdir(dir)) {
+            files[name] = await fs.readFile(path.join(dir, name), "utf8");
+        }
+        templates.push({ key, ...meta[key], files });
+    }
+    return templates;
+}
+export function bundledTemplatesRoot() {
+    // src/templates.ts compiles to dist/templates.js; templates/ sits at
+    // the package root either way.
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "templates");
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

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

package/dist/validators.d.ts

@@ -0,0 +1,10 @@
+export declare function validateDateOnly(value: string, flag: string): void;
+export declare function normalizeDateOnly(value: string, flag: string): string;
+export declare function validateIsoTimestamp(value: string, flag: string): void;
+export declare function normalizeIsoTimestamp(value: string, flag: string): string;
+export declare function parseReleaseVersion(value: string, flag: string): number;
+export declare function parsePositiveInteger(value: string, label: string): number;
+export declare function normalizeNonBlank(value: string, label: string): string;
+export declare function normalizeHttpUrl(value: string, flag: string): string;
+export declare function normalizeTimezone(value: string, flag: string): string;
+export declare function closestChoice(value: string, allowed: readonly string[]): string | null;