@dharta/cli 0.6.77

package/dist/harness-preflight.js

@@ -0,0 +1,252 @@
+// RFC 0035 D7: an advisory, client-side pre-flight for a dharta.toml [harness]
+// version declaration. Release acceptance on the control plane is authoritative;
+// this check is stale-able (the catalog is CDN-cached) and bypassable (the API
+// and old CLIs exist), so a green pre-flight is not a guarantee. Its only job is
+// fast LOCAL feedback before a deploy round-trips:
+//
+//   - block a version pin the platform can't honour (exit non-zero, like the
+//     server would, but instantly and with the supported list), and
+//   - surface a local-vs-cloud version gap so the developer deploys knowingly.
+//
+// Resolution rule A (locked): a range like "2" resolves to the LATEST matching
+// supported version for everyone and for CI - deterministic, the same on every
+// machine. The locally-installed build never changes what deploys; it only
+// *guides* an optional parity pin. So this pre-flight warns on a gap and offers
+// the closest version to pin, but the deploy target itself stays deterministic.
+//
+// It must never block a deploy on its own failure: any error reaching the
+// catalog, parsing, or probing the local binary degrades to "proceed" and lets
+// the authoritative server have the final word. The two deliberate aborts are an
+// unsatisfiable pin and a developer answering "no" to the gap prompt.
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { spawn } from "node:child_process";
+import * as readline from "node:readline";
+import TOML from "@iarna/toml";
+import { sniffHarnessType } from "./harnesses.js";
+import { whichAll } from "./runtime.js";
+// The binary whose `--version` reports the locally-installed harness build. Only
+// types we can probe are listed; an unlisted type yields a null local version
+// (the pin is still validated against the catalog, just no gap warning).
+const LOCAL_BIN = {
+    "claude-code": "claude",
+    opencode: "opencode",
+};
+// Read [harness] from dir/dharta.toml. Returns null when there's no manifest, no
+// [harness] table, or the file can't be parsed - all "nothing to check" cases.
+async function readHarnessTable(dir) {
+    const path = join(dir, "dharta.toml");
+    if (!existsSync(path))
+        return null;
+    let parsed;
+    try {
+        parsed = TOML.parse(await readFile(path, "utf8"));
+    }
+    catch {
+        return null; // a malformed manifest fails loudly at the server; not our job
+    }
+    const table = parsed.harness;
+    if (table === null || typeof table !== "object")
+        return null;
+    const t = table;
+    return {
+        type: typeof t.type === "string" && t.type.trim() ? t.type.trim() : undefined,
+        version: typeof t.version === "string" && t.version.trim() ? t.version.trim() : undefined,
+    };
+}
+// Back-compat type sniff, mirroring the data plane's sniff_harness_type: a tree
+// is claude-code only when it carries Claude config and NOT OpenCode config;
+// anything else (incl. a bare folder) is the opencode default. Used only when
+// [harness] declares a version but omits the type.
+export function sniffType(dir) {
+    return sniffHarnessType(dir);
+}
+// Compare two dotted numeric versions; positive when a > b. Pads the shorter
+// with zeros and compares segment-by-segment (Gem::Version-style, the server's
+// ordering). Non-numeric segments compare as 0 - claude-code/opencode versions
+// are plain numerics, and a malformed entry shouldn't crash the advisory path.
+export function compareVersions(a, b) {
+    const pa = a.split(".");
+    const pb = b.split(".");
+    const n = Math.max(pa.length, pb.length);
+    for (let i = 0; i < n; i++) {
+        const da = Number.parseInt(pa[i] ?? "0", 10) || 0;
+        const db = Number.parseInt(pb[i] ?? "0", 10) || 0;
+        if (da !== db)
+            return da - db;
+    }
+    return 0;
+}
+// True when `version`'s dot segments start with all of `prefix`'s segments
+// ("2" matches 2.x.x; "2.1" matches 2.1.x; an exact string also matches). Mirrors
+// HarnessVersion.version_has_prefix? - a plain string prefix would wrongly match
+// "20.x" for "2"; segment compare won't.
+export function versionHasPrefix(version, prefix) {
+    const v = version.split(".");
+    const p = prefix.split(".");
+    if (p.length === 0 || p.length > v.length)
+        return false;
+    return p.every((seg, i) => v[i] === seg);
+}
+// Advisory mirror of Harness#resolve_version (rule A): blank -> the default (if
+// supported), exact -> that version, prefix -> the LATEST matching. Returns null
+// when nothing matches, exactly when the server would fail acceptance.
+export function resolvePreview(constraint, supported, defaultVersion) {
+    if (!constraint) {
+        return defaultVersion && supported.includes(defaultVersion) ? defaultVersion : null;
+    }
+    if (supported.includes(constraint))
+        return constraint;
+    const matching = supported.filter((v) => versionHasPrefix(v, constraint));
+    if (matching.length === 0)
+        return null;
+    return matching.slice().sort((a, b) => compareVersions(b, a))[0];
+}
+// The supported version closest to the local build, to offer as a parity pin:
+// the longest shared leading-segment prefix with `local` (stay in the same
+// major.minor line), tie-broken by the latest within that line. Null when
+// there's no local build or no supported versions.
+export function closestForParity(local, supported) {
+    if (!local || supported.length === 0)
+        return null;
+    const lp = local.split(".");
+    const shared = (v) => {
+        const vp = v.split(".");
+        let n = 0;
+        while (n < lp.length && n < vp.length && lp[n] === vp[n])
+            n++;
+        return n;
+    };
+    const maxShared = Math.max(...supported.map(shared));
+    return supported
+        .filter((v) => shared(v) === maxShared)
+        .sort((a, b) => compareVersions(b, a))[0];
+}
+// Fetch the public harness catalog (GET /harnesses.json). Returns null on any
+// failure - the pre-flight then proceeds and the server decides.
+async function fetchCatalog(baseUrl, fetchImpl) {
+    try {
+        const res = await fetchImpl(`${baseUrl.replace(/\/$/, "")}/harnesses.json`);
+        if (!res.ok)
+            return null;
+        const body = (await res.json());
+        return Array.isArray(body.harnesses) ? body.harnesses : null;
+    }
+    catch {
+        return null;
+    }
+}
+// Probe the locally-installed harness build via `<bin> --version`, returning the
+// first dotted-numeric token (e.g. "2.1.190" from "2.1.190 (Claude Code)") or
+// null when the binary isn't on PATH or doesn't answer. Best-effort: any failure
+// is a null, never a throw.
+async function detectLocalVersionDefault(type) {
+    const bin = LOCAL_BIN[type];
+    if (!bin)
+        return null;
+    if ((await whichAll(bin)).length === 0)
+        return null;
+    const out = await runVersion(bin);
+    const match = out?.match(/\d+(?:\.\d+)+/);
+    return match ? match[0] : null;
+}
+function runVersion(bin) {
+    return new Promise((resolve) => {
+        let settled = false;
+        const done = (v) => {
+            if (!settled) {
+                settled = true;
+                resolve(v);
+            }
+        };
+        try {
+            const proc = spawn(bin, ["--version"], { stdio: ["ignore", "pipe", "ignore"] });
+            const out = [];
+            proc.stdout?.on("data", (c) => out.push(c));
+            proc.on("error", () => done(null));
+            proc.on("close", () => done(Buffer.concat(out).toString().trim() || null));
+            // A hung binary must not hang the deploy.
+            const timer = setTimeout(() => {
+                proc.kill();
+                done(null);
+            }, 4000);
+            timer.unref?.();
+        }
+        catch {
+            done(null);
+        }
+    });
+}
+// TTY-aware [Y/n] confirm, default yes. Non-interactive (no TTY, or piped stdin
+// in CI) auto-confirms so a deploy pipeline never hangs waiting on input - the
+// gap was already printed, so it's surfaced either way.
+function confirmTTYDefault(question) {
+    if (!process.stdin.isTTY)
+        return Promise.resolve(true);
+    const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            const a = answer.trim().toLowerCase();
+            resolve(a === "" || a === "y" || a === "yes");
+        });
+    });
+}
+// Right-pad a label so the values line up in the printed table.
+function row(label, value) {
+    return `  ${label.padEnd(24)}${value}`;
+}
+// Run the pre-flight. Resolves normally to let the deploy proceed; throws to
+// abort it (an unsatisfiable pin, or a declined gap prompt). Activates only when
+// [harness] declares a version - an omitted version is always the curated
+// default, so there's nothing to validate and the post-deploy echo shows what
+// was frozen.
+export async function harnessPreflight(deps) {
+    const table = await readHarnessTable(deps.dir);
+    if (!table?.version)
+        return; // no declared constraint -> nothing to check
+    const type = table.type ?? sniffType(deps.dir);
+    const fetchImpl = deps.fetchImpl ?? fetch;
+    const catalog = await fetchCatalog(deps.baseUrl, fetchImpl);
+    if (!catalog)
+        return; // catalog unreachable -> defer to the authoritative server
+    const harness = catalog.find((h) => h.id === type);
+    if (!harness)
+        return; // unknown to the advisory catalog -> let the server judge
+    const supported = harness.versions.filter((v) => v.status === "supported").map((v) => v.version);
+    const detect = deps.detectLocalVersion ?? detectLocalVersionDefault;
+    const local = await detect(type).catch(() => null);
+    const localLabel = local ?? "not detected";
+    const resolved = resolvePreview(table.version, supported, harness.default_version);
+    if (resolved === null) {
+        // The pin matches no supported version. Block - the platform can't run a
+        // version it doesn't have - with the supported list so the fix is obvious.
+        const supportedLabel = supported.length ? supported.join(", ") : "(none published)";
+        throw new Error(`Harness version pre-flight failed.\n` +
+            row(`Local ${type}:`, localLabel) + "\n" +
+            row("dharta.toml version:", table.version) + "\n" +
+            row("Supported on Dharta:", supportedLabel) + "\n\n" +
+            `  No Dharta-supported ${type} version matches "${table.version}". ` +
+            `Update or clear the version in [harness] in dharta.toml, then re-deploy.`);
+    }
+    if (local && local !== resolved) {
+        // The deploy target is deterministic (rule A: latest matching); the local
+        // build just differs. Surface the gap and the closest version to pin for
+        // parity, then let the developer decide.
+        const closest = closestForParity(local, supported);
+        deps.log(`⚠ Your local ${type} build differs from the deploy target.`);
+        deps.log(row(`Local ${type}:`, local));
+        deps.log(row("dharta.toml version:", `${table.version}  (deploys as ${resolved})`));
+        if (closest && closest !== resolved) {
+            deps.log(row("Closest to your local:", `${closest}  (pin it in [harness] for parity)`));
+        }
+        const confirm = deps.confirm ?? confirmTTYDefault;
+        const proceed = await confirm(`  Deploy on ${type} ${resolved} anyway? [Y/n] `);
+        if (!proceed) {
+            throw new Error(`Deploy cancelled - local ${type} ${local} differs from the deploy target ${resolved}. ` +
+                `Pin a version in [harness] in dharta.toml, or re-run to accept the difference.`);
+        }
+    }
+}
+//# sourceMappingURL=harness-preflight.js.map

package/dist/harness-preflight.js.map

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

package/dist/harnesses.d.ts

@@ -0,0 +1,11 @@
+export declare const HARNESS_TYPES: readonly ["claude-code", "opencode", "deepagents", "goose", "codex-cli"];
+export type HarnessType = (typeof HARNESS_TYPES)[number];
+export declare const DEFAULT_CREATE_HARNESS: HarnessType;
+export declare const AGENT_MARKERS: readonly ["dharta.toml", "CLAUDE.md", ".claude", ".opencode", ".deepagents", ".goose", ".codex"];
+export declare function parseHarnessType(value: string | undefined, label?: string): HarnessType | undefined;
+export declare function nativeInstructionFile(harness: HarnessType): "CLAUDE.md" | "AGENTS.md";
+export declare function translateTemplateFilesForHarness(files: Record<string, string>, harness: HarnessType): Record<string, string>;
+export declare function hasAgentMarker(dir: string): boolean;
+export declare function markerFolderRel(filePath: string): string | null;
+export declare function sniffHarnessType(dir: string): HarnessType;
+export declare function readDeclaredHarnessType(manifestText: string): HarnessType | undefined;

package/dist/harnesses.js

@@ -0,0 +1,112 @@
+import { existsSync } from "node:fs";
+import * as path from "node:path";
+import TOML from "@iarna/toml";
+import { closestChoice, normalizeNonBlank } from "./validators.js";
+export const HARNESS_TYPES = ["claude-code", "opencode", "deepagents", "goose", "codex-cli"];
+export const DEFAULT_CREATE_HARNESS = "claude-code";
+const HARNESS_MARKERS = {
+    "claude-code": [".claude", "CLAUDE.md"],
+    opencode: [".opencode/opencode.jsonc", ".opencode/agents"],
+    deepagents: [".deepagents", ".deepagents/agents"],
+    goose: [".goose", ".goose/agents"],
+    "codex-cli": [".codex/config.toml", ".codex/agents"],
+};
+const NATIVE_TEMPLATE_MARKER = {
+    opencode: { path: ".opencode/opencode.jsonc", content: "{}\n" },
+    deepagents: { path: ".deepagents/dharta.jsonc", content: "{}\n" },
+    goose: { path: ".goose/dharta.jsonc", content: "{}\n" },
+    "codex-cli": { path: ".codex/config.toml", content: "# Codex project config for this Dharta agent.\n" },
+};
+export const AGENT_MARKERS = [
+    "dharta.toml",
+    "CLAUDE.md",
+    ".claude",
+    ".opencode",
+    ".deepagents",
+    ".goose",
+    ".codex",
+];
+export function parseHarnessType(value, label = "--harness") {
+    if (value === undefined)
+        return undefined;
+    const normalized = normalizeNonBlank(value, label);
+    if (HARNESS_TYPES.includes(normalized))
+        return normalized;
+    const suggestion = closestChoice(normalized, HARNESS_TYPES);
+    throw new Error(`${label} must be one of ${HARNESS_TYPES.join(", ")}.` +
+        (suggestion ? ` Did you mean ${suggestion}?` : ""));
+}
+export function nativeInstructionFile(harness) {
+    return harness === "claude-code" ? "CLAUDE.md" : "AGENTS.md";
+}
+export function translateTemplateFilesForHarness(files, harness) {
+    if (harness === "claude-code")
+        return { ...files };
+    const translated = {};
+    for (const [rel, content] of Object.entries(files)) {
+        if (rel !== "CLAUDE.md")
+            translated[rel] = content;
+    }
+    if (translated["AGENTS.md"] === undefined && files["CLAUDE.md"] !== undefined) {
+        translated["AGENTS.md"] = files["CLAUDE.md"];
+    }
+    const marker = NATIVE_TEMPLATE_MARKER[harness];
+    if (marker && translated[marker.path] === undefined) {
+        translated[marker.path] = marker.content;
+    }
+    return translated;
+}
+export function hasAgentMarker(dir) {
+    return AGENT_MARKERS.some((marker) => existsSync(path.join(dir, marker)));
+}
+export function markerFolderRel(filePath) {
+    const parts = filePath.split(/[\\/]+/).filter(Boolean);
+    if (parts.includes("node_modules"))
+        return null;
+    const last = parts.at(-1);
+    if (last === "dharta.toml" || last === "CLAUDE.md") {
+        return parts.slice(0, -1).join(path.sep) || ".";
+    }
+    for (const marker of [".claude", ".opencode", ".deepagents", ".goose", ".codex"]) {
+        const index = parts.indexOf(marker);
+        if (index >= 0)
+            return parts.slice(0, index).join(path.sep) || ".";
+    }
+    return null;
+}
+export function sniffHarnessType(dir) {
+    if (presentIn(dir, "opencode"))
+        return "opencode";
+    if (presentIn(dir, "deepagents"))
+        return "deepagents";
+    if (presentIn(dir, "goose"))
+        return "goose";
+    if (presentIn(dir, "claude-code"))
+        return "claude-code";
+    if (presentIn(dir, "codex-cli"))
+        return "codex-cli";
+    return "opencode";
+}
+export function readDeclaredHarnessType(manifestText) {
+    let parsed;
+    try {
+        parsed = TOML.parse(manifestText);
+    }
+    catch {
+        return undefined;
+    }
+    const table = parsed.harness;
+    if (table === null || typeof table !== "object")
+        return undefined;
+    const type = table.type;
+    try {
+        return typeof type === "string" ? parseHarnessType(type, "[harness] type") : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function presentIn(dir, harness) {
+    return HARNESS_MARKERS[harness].some((marker) => existsSync(path.join(dir, marker)));
+}
+//# sourceMappingURL=harnesses.js.map

package/dist/harnesses.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { main } from "./cli.js";
+export { buildContext } from "./context.js";
+export type { CliContext, CtxOverrides } from "./context.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+export { main } from "./cli.js";
+export { buildContext } from "./context.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/login-offer.d.ts

@@ -0,0 +1,9 @@
+export interface OfferLoginOptions {
+    force?: boolean;
+    ask?: (q: string) => Promise<string>;
+    log: (line: string) => void;
+    isLoggedIn?: () => Promise<boolean>;
+    runLogin?: () => Promise<void>;
+}
+export type OfferLoginOutcome = "logged-in" | "skipped" | "completed";
+export declare function offerLogin(opts: OfferLoginOptions): Promise<OfferLoginOutcome>;

package/dist/login-offer.js

@@ -0,0 +1,36 @@
+// RFC 0024 DEP-9 / D5: `dharta setup` is fully functional logged-out - it
+// writes local config only and reads no logged-in state. If you are not
+// logged in, it offers login ONCE at the end as the bridge to `dharta deploy`
+// (which does need auth). --login forces it; otherwise we only prompt an
+// interactive terminal. It never blocks setup.
+import { activeProfile } from "./config.js";
+import { login } from "./commands/login.js";
+export async function offerLogin(opts) {
+    // Non-interactive and not forced: stay silent (don't even read the config).
+    if (!opts.force && !opts.ask)
+        return "skipped";
+    const loggedIn = opts.isLoggedIn ?? defaultIsLoggedIn;
+    if (await loggedIn())
+        return "logged-in";
+    let go = opts.force ?? false;
+    if (!go && opts.ask) {
+        const a = (await opts.ask("You are not logged into Dharta. Log in now? (optional) [y/N]  ")).trim().toLowerCase();
+        go = a === "y" || a === "yes";
+    }
+    if (!go) {
+        opts.log("Setup is complete. You're not logged in - run `dharta login`, then `dharta deploy`.");
+        return "skipped";
+    }
+    await (opts.runLogin ?? (() => login({ log: opts.log }).then(() => undefined)))();
+    return "completed";
+}
+async function defaultIsLoggedIn() {
+    try {
+        await activeProfile();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=login-offer.js.map

package/dist/login-offer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login-offer.js","sourceRoot":"","sources":["../src/login-offer.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wEAAwE;AACxE,8EAA8E;AAC9E,yEAAyE;AACzE,+CAA+C;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAa5C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAuB;IACtD,4EAA4E;IAC5E,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAE/C,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,IAAI,iBAAiB,CAAC;IACtD,IAAI,MAAM,QAAQ,EAAE;QAAE,OAAO,WAAW,CAAC;IAEzC,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;IAC7B,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACpB,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAClH,EAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC;IAChC,CAAC;IACD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,IAAI,CAAC,GAAG,CAAC,qFAAqF,CAAC,CAAC;QAChG,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,KAAK,UAAU,iBAAiB;IAC9B,IAAI,CAAC;QACH,MAAM,aAAa,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,15 @@
+import { type HarnessType } from "./harnesses.js";
+export type DeployMethod = "git" | "folder";
+export declare function renderManifest(o: {
+    name: string;
+    deploy: boolean;
+    deployMethod?: DeployMethod;
+    harness?: HarnessType;
+    harnessVersion?: string;
+}): string;
+export declare function patchScalar(src: string, key: string, literal: string): string;
+export declare function patchManifest(src: string, o: {
+    name?: string;
+    deploy?: boolean;
+    deployMethod?: DeployMethod;
+}): string;

package/dist/manifest.js

@@ -0,0 +1,142 @@
+import TOML from "@iarna/toml";
+import { DEFAULT_CREATE_HARNESS } from "./harnesses.js";
+const DEPLOY_METHOD_PLACEHOLDER = '# deploy_method = "git" # set by `dharta setup`';
+// The scaffolded dharta.toml is self-documenting (RFC 0024 DEP-1/DEP-4):
+// every field is commented with its purpose and its alternatives, which
+// is the whole DX fix. TOML.stringify drops comments, so a fresh manifest
+// is written from this string template, and an edit to an existing one is
+// a surgical top-level-scalar patch that leaves the comments and [tables]
+// intact.
+export function renderManifest(o) {
+    const harness = o.harness ?? DEFAULT_CREATE_HARNESS;
+    const versionExample = harnessVersionExample(harness);
+    const versionLine = o.harnessVersion
+        ? `version = ${JSON.stringify(o.harnessVersion)}`
+        : `# version = ${JSON.stringify(versionExample)}`;
+    return [
+        "# --- Identity -------------------------------------------------------------",
+        "# Display name (1-100 characters). Dharta derives the deploy slug from this",
+        "# name (for example, Support Bot -> support-bot); that slug must be unique",
+        "# within your org. Changing the name so its slug changes targets a different agent.",
+        "# Each deploy creates a new immutable release; earlier releases remain available.",
+        `name = ${JSON.stringify(o.name)}`,
+        "",
+        "# Deploy gate. Only agents with deploy = true ship on `dharta deploy` /",
+        "# `git push dharta`. Absent or false = configured but not deployed.",
+        `deploy = ${o.deploy}`,
+        "",
+        "# How this agent is deployed. `git` pushes the containing repo while",
+        "# selecting this folder; `folder` uploads this folder directly.",
+        o.deployMethod
+            ? `deploy_method = ${JSON.stringify(o.deployMethod)}`
+            : DEPLOY_METHOD_PLACEHOLDER,
+        "",
+        "# --- Build ----------------------------------------------------------------",
+        "# OMIT this whole section for a harness-only agent (for example CLAUDE.md,",
+        "# AGENTS.md + .opencode/, .deepagents/, .goose/, or .codex/) - Dharta serves it as-is,",
+        "# no build step.",
+        '#   "python" - Python project; Dharta builds it (set entry_point below)',
+        '#   "node"   - Node project; Dharta builds it',
+        '# buildpack = "python"',
+        "",
+        '# Import path "module:attribute" to your app object. Required ONLY when',
+        "# buildpack is set; omit for harness-only agents.",
+        '# entry_point = "app:app"',
+        "",
+        "# --- Harness ---------------------------------------------------------------",
+        "# The agent runtime this agent runs on. `type` is fixed for the life of the",
+        "# agent (switching harness = a new agent). Supported types today:",
+        "# claude-code, opencode, deepagents, goose, codex-cli.",
+        "# `version` is optional: a range resolves to the latest matching version Dharta",
+        "# supports at deploy time; omit it for the curated default; pin an exact",
+        "# version only when you need determinism (`dharta deploy` checks it).",
+        "[harness]",
+        `type = ${JSON.stringify(harness)}`,
+        versionLine,
+        "",
+        "# --- Environment (declare-or-bind) -----------------------------------------",
+        "# Names this agent needs. Bind locally in .env, in prod via `dharta env set`.",
+        "# A required var with no prod binding fails the build.",
+        "[env]",
+        '# SUPPORT_DB_URL = { required = false, description = "Support database DSN" }',
+        "",
+        "# --- Environment setup -----------------------------------------------------",
+        "# A Bash setup script run once per cold start, before the agent, to install",
+        "# what the base image lacks. Use user-space installs: `pip install` and",
+        "# `npm i -g` are auto-configured (pip --user) to persist under ~/.local, so",
+        "# no --user flag is needed. apt/system packages are NOT available",
+        "# here (they need a custom image - a higher tier). The script is validated at",
+        "# deploy (`bash -n`); a syntax error fails the deploy, not your users.",
+        "#   network: none | trusted | full (default) | custom. Only `full` is enforced",
+        "#   today (every agent has open egress); the others arrive with a later phase.",
+        "# [environment]",
+        '# setup = "scripts/setup.sh"',
+        '# network = "full"',
+        "",
+    ].join("\n");
+}
+function harnessVersionExample(harness) {
+    switch (harness) {
+        case "claude-code":
+            return "2";
+        case "opencode":
+            return "1";
+        case "deepagents":
+            return "0.1.28";
+        case "goose":
+            return "1.39.0";
+        case "codex-cli":
+            return "0.133.0";
+    }
+}
+// Flip or insert a top-level scalar WITHOUT disturbing comments or
+// [tables]: replace it in place if present (anchored to a line, so a
+// commented `# name = ...` is never matched), else insert before the
+// first table so it stays a top-level key rather than nesting under a
+// section. `key` is always a literal we control
+// ("name"/"deploy"/"deploy_method").
+export function patchScalar(src, key, literal) {
+    const re = new RegExp(`^(\\s*${key}\\s*=).*$`, "m");
+    const tbl = src.search(/^\s*\[/m);
+    const top = tbl >= 0 ? src.slice(0, tbl) : src;
+    const rest = tbl >= 0 ? src.slice(tbl) : "";
+    if (re.test(top))
+        return top.replace(re, `$1 ${literal}`) + rest;
+    const line = `${key} = ${literal}\n`;
+    if (tbl >= 0)
+        return src.slice(0, tbl) + line + src.slice(tbl);
+    return (src.endsWith("\n") ? src : src + "\n") + line;
+}
+function hasTopLevelScalar(src, key) {
+    const tbl = src.search(/^\s*\[/m);
+    const top = tbl >= 0 ? src.slice(0, tbl) : src;
+    return new RegExp(`^\\s*${key}\\s*=`, "m").test(top);
+}
+// Set identity/deploy configuration on an existing manifest, preserving its
+// comments and tables, then round-trip through the parser so a broken edit
+// fails loud instead of writing an invalid manifest.
+export function patchManifest(src, o) {
+    let out = src;
+    if (o.name !== undefined)
+        out = patchScalar(out, "name", JSON.stringify(o.name));
+    if (o.deploy !== undefined)
+        out = patchScalar(out, "deploy", String(o.deploy));
+    if (o.deployMethod !== undefined) {
+        const literal = JSON.stringify(o.deployMethod);
+        // `dharta create` leaves this decision visibly unset for setup. Activate
+        // that generated placeholder in place so the field stays next to its
+        // explanation; arbitrary user comments remain untouched.
+        if (hasTopLevelScalar(out, "deploy_method")) {
+            out = patchScalar(out, "deploy_method", literal);
+        }
+        else if (out.includes(DEPLOY_METHOD_PLACEHOLDER)) {
+            out = out.replace(DEPLOY_METHOD_PLACEHOLDER, `deploy_method = ${literal}`);
+        }
+        else {
+            out = patchScalar(out, "deploy_method", literal);
+        }
+    }
+    TOML.parse(out); // throws on an invalid result
+    return out;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,aAAa,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAoB,MAAM,gBAAgB,CAAC;AAI1E,MAAM,yBAAyB,GAAG,iDAAiD,CAAC;AAEpF,yEAAyE;AACzE,wEAAwE;AACxE,0EAA0E;AAC1E,0EAA0E;AAC1E,0EAA0E;AAC1E,UAAU;AAEV,MAAM,UAAU,cAAc,CAAC,CAM9B;IACC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,sBAAsB,CAAC;IACpD,MAAM,cAAc,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,CAAC,CAAC,cAAc;QAClC,CAAC,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE;QACjD,CAAC,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;IACpD,OAAO;QACL,8EAA8E;QAC9E,6EAA6E;QAC7E,4EAA4E;QAC5E,qFAAqF;QACrF,mFAAmF;QACnF,UAAU,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE;QAClC,EAAE;QACF,yEAAyE;QACzE,qEAAqE;QACrE,YAAY,CAAC,CAAC,MAAM,EAAE;QACtB,EAAE;QACF,sEAAsE;QACtE,iEAAiE;QACjE,CAAC,CAAC,YAAY;YACZ,CAAC,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE;YACrD,CAAC,CAAC,yBAAyB;QAC7B,EAAE;QACF,8EAA8E;QAC9E,4EAA4E;QAC5E,wFAAwF;QACxF,kBAAkB;QAClB,yEAAyE;QACzE,+CAA+C;QAC/C,wBAAwB;QACxB,EAAE;QACF,yEAAyE;QACzE,mDAAmD;QACnD,2BAA2B;QAC3B,EAAE;QACF,+EAA+E;QAC/E,6EAA6E;QAC7E,mEAAmE;QACnE,wDAAwD;QACxD,iFAAiF;QACjF,0EAA0E;QAC1E,uEAAuE;QACvE,WAAW;QACX,UAAU,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;QACnC,WAAW;QACX,EAAE;QACF,+EAA+E;QAC/E,+EAA+E;QAC/E,wDAAwD;QACxD,OAAO;QACP,+EAA+E;QAC/E,EAAE;QACF,+EAA+E;QAC/E,6EAA6E;QAC7E,yEAAyE;QACzE,6EAA6E;QAC7E,mEAAmE;QACnE,+EAA+E;QAC/E,wEAAwE;QACxE,gFAAgF;QAChF,gFAAgF;QAChF,iBAAiB;QACjB,8BAA8B;QAC9B,oBAAoB;QACpB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAoB;IACjD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,aAAa;YAChB,OAAO,GAAG,CAAC;QACb,KAAK,UAAU;YACb,OAAO,GAAG,CAAC;QACb,KAAK,YAAY;YACf,OAAO,QAAQ,CAAC;QAClB,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC;QAClB,KAAK,WAAW;YACd,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,qEAAqE;AACrE,qEAAqE;AACrE,sEAAsE;AACtE,gDAAgD;AAChD,qCAAqC;AACrC,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,GAAW,EAAE,OAAe;IACnE,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,SAAS,GAAG,WAAW,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/C,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IACjE,MAAM,IAAI,GAAG,GAAG,GAAG,MAAM,OAAO,IAAI,CAAC;IACrC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AACxD,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW,EAAE,GAAW;IACjD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/C,OAAO,IAAI,MAAM,CAAC,QAAQ,GAAG,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,4EAA4E;AAC5E,2EAA2E;AAC3E,qDAAqD;AACrD,MAAM,UAAU,aAAa,CAC3B,GAAW,EACX,CAAmE;IAEnE,IAAI,GAAG,GAAG,GAAG,CAAC;IACd,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;QAAE,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACjF,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/E,IAAI,CAAC,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAC/C,yEAAyE;QACzE,qEAAqE;QACrE,yDAAyD;QACzD,IAAI,iBAAiB,CAAC,GAAG,EAAE,eAAe,CAAC,EAAE,CAAC;YAC5C,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;aAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC;YACnD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,yBAAyB,EAAE,mBAAmB,OAAO,EAAE,CAAC,CAAC;QAC7E,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,8BAA8B;IAC/C,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/money.d.ts

@@ -0,0 +1 @@
+export declare function parseDollarAmountToCents(value: string, flag: string): number;