@dharta/cli 0.6.77

package/dist/commands/kartas.js

@@ -0,0 +1,289 @@
+import { randomUUID } from "node:crypto";
+import { table } from "../output.js";
+import { maskEnvValue } from "./env.js";
+import { closestChoice, normalizeNonBlank } from "../validators.js";
+const DHARTA_AUDIENCES = ["members", "anonymous", "off"];
+const DHARTA_ROLES = ["viewer", "participant", "manager"];
+export function validateKartaCreateOptions(name, options) {
+    normalizeNonBlank(name, "dharta name");
+    normalizeNonBlank(options.agent ?? "", "Agent slug");
+    normalizeNonBlank(options.slug ?? "", "dharta vanity slug");
+    normalizeAudience(options.access ?? "members");
+    normalizeRole(options.memberRole ?? "participant");
+    for (const email of options.members ?? [])
+        normalizeNonBlank(email, "karta member email");
+}
+export async function kartasCreateData(ctx, name, options) {
+    validateKartaCreateOptions(name, options);
+    const access = normalizeAudience(options.access ?? "members");
+    const role = normalizeRole(options.memberRole ?? "participant");
+    const agent = normalizeNonBlank(options.agent ?? "", "Agent slug");
+    const slug = normalizeNonBlank(options.slug ?? "", "dharta vanity slug");
+    return ctx.http.request({
+        method: "POST",
+        path: "/api/kartas",
+        headers: { "Idempotency-Key": randomUUID() },
+        body: {
+            agent,
+            name: name.trim(),
+            vanity_slug: slug.toLowerCase(),
+            access_audience: access === "off" ? null : access,
+            members: (options.members ?? []).map((email) => ({ email: email.trim(), role })),
+        },
+    });
+}
+export async function kartasCreate(ctx, name, options) {
+    const { karta } = await kartasCreateData(ctx, name, options);
+    return karta.url
+        ? `Created ${karta.name ?? karta.id}. Stable URL: ${karta.url}`
+        : `Created ${karta.name ?? karta.id}. Stable URL is off.`;
+}
+export async function kartasListData(ctx, options = {}) {
+    const query = new URLSearchParams();
+    if (options.agent !== undefined)
+        query.set("agent", normalizeNonBlank(options.agent, "Agent slug"));
+    if (options.named)
+        query.set("named", "true");
+    // Archived kartas are hidden by default; --archived lists only those.
+    if (options.archived)
+        query.set("archived", "true");
+    const suffix = query.size > 0 ? `?${query.toString()}` : "";
+    const response = await ctx.http.request({ path: `/api/kartas${suffix}` });
+    return response.data;
+}
+export async function kartasList(ctx, options = {}) {
+    const kartas = await kartasListData(ctx, options);
+    if (kartas.length === 0)
+        return options.named ? "No named kartas yet." : "No kartas yet.";
+    return table(kartas.map((karta) => ({
+        id: karta.id,
+        name: karta.name ?? "—",
+        agent: karta.agent?.slug ?? "—",
+        slug: karta.vanity_slug ?? "—",
+        access: accessLabel(karta),
+        url: karta.url ?? "—",
+    })));
+}
+export async function kartasShowData(ctx, id) {
+    const kartaId = normalizeNonBlank(id, "dharta id");
+    const response = await ctx.http.request({
+        path: `/api/kartas/${encodeURIComponent(kartaId)}`,
+    });
+    return response.karta;
+}
+export async function kartasShow(ctx, id) {
+    const karta = await kartasShowData(ctx, id);
+    const members = karta.members?.length
+        ? table(karta.members.map((member) => ({
+            id: String(member.id), email: member.email, role: member.role,
+        })))
+        : "No people listed.";
+    return [
+        `karta: ${karta.name ?? karta.id} (${karta.id})`,
+        `Agent: ${karta.agent?.slug ?? "—"}`,
+        `Vanity slug: ${karta.vanity_slug ?? "—"}`,
+        `Stable URL access: ${accessLabel(karta)}`,
+        `Signed-in access: ${karta.access_model === "native_shared" ? "managed here" : "controlled by the existing agent integration"}`,
+        `URL: ${karta.url ?? "—"}`,
+        "",
+        "People",
+        members,
+    ].join("\n");
+}
+export function validateKartaConfigureOptions(options) {
+    if (options.name === undefined && options.slug === undefined && options.access === undefined) {
+        throw new Error("Set at least one of --name, --slug, or --access.");
+    }
+    if (options.name !== undefined)
+        normalizeNonBlank(options.name, "dharta name");
+    if (options.slug !== undefined)
+        normalizeNonBlank(options.slug, "dharta vanity slug");
+    if (options.access !== undefined)
+        normalizeAudience(options.access);
+}
+export function validateKartaNameOptions(options) {
+    normalizeNonBlank(options.name ?? "", "dharta name");
+    normalizeNonBlank(options.slug ?? "", "dharta vanity slug");
+}
+export async function kartasNameData(ctx, id, options) {
+    validateKartaNameOptions(options);
+    return kartasConfigureData(ctx, id, { name: options.name, slug: options.slug });
+}
+export async function kartasName(ctx, id, options) {
+    const { karta } = await kartasNameData(ctx, id, options);
+    return `Named ${karta.id} as ${karta.name} (/kartas/${karta.vanity_slug}). Stable URL access remains ${accessLabel(karta)}.`;
+}
+export async function kartasConfigureData(ctx, id, options) {
+    const kartaId = normalizeNonBlank(id, "dharta id");
+    validateKartaConfigureOptions(options);
+    const body = {};
+    if (options.name !== undefined)
+        body.name = options.name.trim();
+    if (options.slug !== undefined)
+        body.vanity_slug = options.slug.trim().toLowerCase();
+    if (options.access !== undefined) {
+        const access = normalizeAudience(options.access);
+        body.access_audience = access === "off" ? null : access;
+    }
+    return ctx.http.request({
+        method: "PATCH",
+        path: `/api/kartas/${encodeURIComponent(kartaId)}`,
+        headers: { "Idempotency-Key": randomUUID() },
+        body,
+    });
+}
+export async function kartasConfigure(ctx, id, options) {
+    const { karta } = await kartasConfigureData(ctx, id, options);
+    return karta.url
+        ? `Updated ${karta.name ?? karta.id}. Stable URL: ${karta.url}`
+        : `Updated ${karta.name ?? karta.id}. Stable URL is off.`;
+}
+// Retire a dharta. A REVERSIBLE archive, never a delete: the durable workspace
+// and its history survive untouched, and `dharta kartas restore` brings them
+// back. Erasing the underlying tree is a separate admin operation (RFC 0036
+// W7) - list-tidying must never destroy an end user's accumulated work.
+export async function kartasArchiveData(ctx, id) {
+    const kartaId = normalizeNonBlank(id, "dharta id");
+    return ctx.http.request({
+        method: "DELETE",
+        path: `/api/kartas/${encodeURIComponent(kartaId)}`,
+        headers: { "Idempotency-Key": randomUUID() },
+    });
+}
+export async function kartasArchive(ctx, id) {
+    const { karta } = await kartasArchiveData(ctx, id);
+    return (`Archived ${karta.name ?? karta.id}. Its files and history are kept - ` +
+        `restore with: dharta kartas restore ${karta.id}`);
+}
+export async function kartasRestoreData(ctx, id) {
+    const kartaId = normalizeNonBlank(id, "dharta id");
+    return ctx.http.request({
+        method: "POST",
+        path: `/api/kartas/${encodeURIComponent(kartaId)}/restore`,
+        headers: { "Idempotency-Key": randomUUID() },
+    });
+}
+export async function kartasRestore(ctx, id) {
+    const { karta } = await kartasRestoreData(ctx, id);
+    return karta.url
+        ? `Restored ${karta.name ?? karta.id}. Stable URL: ${karta.url}`
+        : `Restored ${karta.name ?? karta.id}.`;
+}
+export async function kartaMembersGrantData(ctx, id, email, role) {
+    const kartaId = normalizeNonBlank(id, "dharta id");
+    const normalizedEmail = normalizeNonBlank(email, "person email");
+    const normalizedRole = normalizeRole(role);
+    return ctx.http.request({
+        method: "POST",
+        path: `/api/kartas/${encodeURIComponent(kartaId)}/members`,
+        headers: { "Idempotency-Key": randomUUID() },
+        body: { email: normalizedEmail, role: normalizedRole },
+    });
+}
+export async function kartaMembersGrant(ctx, id, email, role) {
+    const { member } = await kartaMembersGrantData(ctx, id, email, role);
+    return `Granted ${member.email} ${member.role} access to karta ${id}.`;
+}
+export async function kartaMembersSetRoleData(ctx, id, membershipId, role) {
+    const kartaId = normalizeNonBlank(id, "dharta id");
+    const memberId = normalizeNonBlank(membershipId, "dharta membership id");
+    const normalizedRole = normalizeRole(role);
+    return ctx.http.request({
+        method: "PATCH",
+        path: `/api/kartas/${encodeURIComponent(kartaId)}/members/${encodeURIComponent(memberId)}`,
+        headers: { "Idempotency-Key": randomUUID() },
+        body: { role: normalizedRole },
+    });
+}
+export async function kartaMembersSetRole(ctx, id, membershipId, role) {
+    const { member } = await kartaMembersSetRoleData(ctx, id, membershipId, role);
+    return `${member.email} is now a ${member.role} on karta ${id}.`;
+}
+export async function kartaMembersRevokeData(ctx, id, membershipId) {
+    const kartaId = normalizeNonBlank(id, "dharta id");
+    const memberId = normalizeNonBlank(membershipId, "dharta membership id");
+    await ctx.http.request({
+        method: "DELETE",
+        path: `/api/kartas/${encodeURIComponent(kartaId)}/members/${encodeURIComponent(memberId)}`,
+        headers: { "Idempotency-Key": randomUUID() },
+    });
+    return { id: kartaId, membership_id: memberId, revoked: true };
+}
+export async function kartaMembersRevoke(ctx, id, membershipId) {
+    await kartaMembersRevokeData(ctx, id, membershipId);
+    return `Revoked dharta membership ${membershipId} from ${id}.`;
+}
+function normalizeAudience(audience) {
+    const normalized = normalizeNonBlank(audience, "karta access audience");
+    if (DHARTA_AUDIENCES.includes(normalized))
+        return normalized;
+    const suggestion = closestChoice(normalized, DHARTA_AUDIENCES);
+    throw new Error(`Unknown karta access ${normalized}. Allowed values: ${DHARTA_AUDIENCES.join(", ")}.` +
+        (suggestion ? ` Did you mean ${suggestion}?` : ""));
+}
+function normalizeRole(role) {
+    const normalized = normalizeNonBlank(role, "karta member role");
+    if (DHARTA_ROLES.includes(normalized))
+        return normalized;
+    const suggestion = closestChoice(normalized, DHARTA_ROLES);
+    throw new Error(`Unknown karta member role ${normalized}. Allowed roles: ${DHARTA_ROLES.join(", ")}.` +
+        (suggestion ? ` Did you mean ${suggestion}?` : ""));
+}
+function accessLabel(karta) {
+    if (karta.access_audience === "members")
+        return "specific people (sign-in required)";
+    if (karta.access_audience === "anonymous")
+        return "anyone with the link";
+    return "off";
+}
+function envPath(agent, karta, name) {
+    const base = `/api/agents/${encodeURIComponent(agent)}/instances/${encodeURIComponent(karta)}/env`;
+    return name === undefined ? base : `${base}/${encodeURIComponent(name)}`;
+}
+export async function kartaEnvListData(ctx, agent, karta) {
+    const agentSlug = normalizeNonBlank(agent, "agent slug");
+    const kartaId = normalizeNonBlank(karta, "dharta id");
+    const response = await ctx.http.request({
+        path: envPath(agentSlug, kartaId),
+    });
+    return response.env ?? [];
+}
+export async function kartaEnvList(ctx, agent, karta) {
+    const env = await kartaEnvListData(ctx, agent, karta);
+    if (env.length === 0)
+        return "No per-dharta environment variables set.";
+    return table(env.map((row) => ({
+        name: row.name,
+        // Secret values are never returned by the API; non-secret (--plain) values
+        // are masked here too so a routine list never prints a token to the
+        // terminal. Use `--json` for raw values. Shared with `dharta env list`.
+        value: maskEnvValue(row, false),
+        updated: row.updated_at ?? "—",
+        by: row.updated_by ?? "—",
+    })));
+}
+export async function kartaEnvSetData(ctx, agent, karta, name, value, options = {}) {
+    const agentSlug = normalizeNonBlank(agent, "agent slug");
+    const kartaId = normalizeNonBlank(karta, "dharta id");
+    const varName = normalizeNonBlank(name, "variable name");
+    return ctx.http.request({
+        method: "PUT",
+        path: envPath(agentSlug, kartaId, varName),
+        body: options.secret === undefined ? { value } : { value, secret: options.secret },
+    });
+}
+export async function kartaEnvSet(ctx, agent, karta, name, value, options = {}) {
+    const row = await kartaEnvSetData(ctx, agent, karta, name, value, options);
+    return `Set ${row.name} on ${karta}.`;
+}
+export async function kartaEnvUnsetData(ctx, agent, karta, name) {
+    const agentSlug = normalizeNonBlank(agent, "agent slug");
+    const kartaId = normalizeNonBlank(karta, "dharta id");
+    const varName = normalizeNonBlank(name, "variable name");
+    await ctx.http.request({ method: "DELETE", path: envPath(agentSlug, kartaId, varName) });
+}
+export async function kartaEnvUnset(ctx, agent, karta, name) {
+    await kartaEnvUnsetData(ctx, agent, karta, name);
+    return `Removed ${name} from ${karta}.`;
+}
+//# sourceMappingURL=kartas.js.map

package/dist/commands/kartas.js.map

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

package/dist/commands/keys.d.ts

@@ -0,0 +1,33 @@
+import type { CliContext } from "../context.js";
+import { type ApiKeyScope } from "@dharta/sdk";
+interface ApiKey {
+    id: string;
+    name: string;
+    prefix: string;
+    scopes: ApiKeyScope[];
+    mode?: string;
+    expires_at?: string | null;
+    created_at: string;
+    last_used_at: string | null;
+    revoked_at: string | null;
+}
+interface ApiKeyCreateResponse {
+    api_key: ApiKey;
+    secret: string;
+}
+export interface ApiKeyCreateOptions {
+    expiresAt?: string;
+}
+export declare function keysListData(ctx: CliContext): Promise<ApiKey[]>;
+export declare function keysList(ctx: CliContext): Promise<string>;
+export declare function keysCreateData(ctx: CliContext, name: string, scopes: ApiKeyScope[], opts?: ApiKeyCreateOptions): Promise<ApiKeyCreateResponse>;
+export declare function keysCreate(ctx: CliContext, name: string, scopes: ApiKeyScope[], opts?: ApiKeyCreateOptions): Promise<string>;
+export declare function validateKeysCreateInput(name: string, scopes: ApiKeyScope[], opts?: ApiKeyCreateOptions): void;
+export declare function keysRevokeData(ctx: CliContext, id: string): Promise<{
+    id: string;
+    revoked: boolean;
+}>;
+export declare function keysRevoke(ctx: CliContext, id: string): Promise<string>;
+export declare function keysRenameData(ctx: CliContext, id: string, name: string): Promise<ApiKey>;
+export declare function keysRename(ctx: CliContext, id: string, name: string): Promise<string>;
+export {};

package/dist/commands/keys.js

@@ -0,0 +1,141 @@
+import { API_KEY_SCOPES } from "@dharta/sdk";
+import { randomUUID } from "node:crypto";
+import { fmtTs, table } from "../output.js";
+import { closestChoice, normalizeIsoTimestamp, normalizeNonBlank } from "../validators.js";
+import { formatScopes, SENSITIVE_API_KEY_SCOPES } from "./scopes.js";
+const MAX_FORCED_EXPIRY_MS = 90 * 24 * 60 * 60 * 1000;
+export async function keysListData(ctx) {
+    try {
+        const res = await ctx.http.request({ path: "/api_keys" });
+        return res.data;
+    }
+    catch (error) {
+        throw addKeysListScopeGuidance(error);
+    }
+}
+export async function keysList(ctx) {
+    const keys = await keysListData(ctx);
+    if (keys.length === 0)
+        return "No API keys. Create one with: dharta keys create <name> --scope agents:read";
+    return table(keys.map((k) => ({
+        prefix: k.prefix,
+        name: k.name,
+        scopes: formatScopes(k.scopes, ","),
+        created: fmtTs(k.created_at),
+        last_used: fmtTs(k.last_used_at),
+        revoked: fmtTs(k.revoked_at),
+    })));
+}
+export async function keysCreateData(ctx, name, scopes, opts = {}) {
+    validateKeysCreateInput(name, scopes, opts);
+    const normalizedScopes = normalizeScopes(scopes);
+    const normalizedOpts = normalizeCreateOptions(normalizedScopes, opts);
+    const body = { name: normalizeKeyName(name), scopes: normalizedScopes };
+    if (normalizedOpts.expiresAt !== undefined)
+        body.expires_at = normalizedOpts.expiresAt;
+    return ctx.http.request({
+        method: "POST",
+        path: "/api_keys",
+        body,
+        headers: { "Idempotency-Key": randomUUID() },
+    });
+}
+export async function keysCreate(ctx, name, scopes, opts = {}) {
+    const res = await keysCreateData(ctx, name, scopes, opts);
+    return [
+        `Created key ${res.api_key.prefix} (${res.api_key.id})`,
+        `Scopes: ${res.api_key.scopes.join(",")}`,
+        res.api_key.expires_at ? `Expires: ${res.api_key.expires_at}` : null,
+        "",
+        `Secret (shown once — store it now):`,
+        res.secret,
+    ].filter((line) => line !== null).join("\n");
+}
+export function validateKeysCreateInput(name, scopes, opts = {}) {
+    normalizeKeyName(name);
+    normalizeCreateOptions(normalizeScopes(scopes), opts);
+}
+export async function keysRevokeData(ctx, id) {
+    const normalizedId = normalizeNonBlank(id, "API key id");
+    await ctx.http.request({
+        method: "DELETE",
+        path: `/api_keys/${encodeURIComponent(normalizedId)}`,
+        headers: { "Idempotency-Key": randomUUID() },
+    });
+    return { id: normalizedId, revoked: true };
+}
+export async function keysRevoke(ctx, id) {
+    const res = await keysRevokeData(ctx, id);
+    return `Revoked ${res.id}.`;
+}
+export async function keysRenameData(ctx, id, name) {
+    const normalizedId = normalizeNonBlank(id, "API key id");
+    const normalizedName = normalizeKeyName(name);
+    const res = await ctx.http.request({
+        method: "PATCH",
+        path: `/api_keys/${encodeURIComponent(normalizedId)}`,
+        body: { name: normalizedName },
+        headers: { "Idempotency-Key": randomUUID() },
+    });
+    return res.api_key;
+}
+export async function keysRename(ctx, id, name) {
+    const key = await keysRenameData(ctx, id, name);
+    return `Renamed ${key.prefix} to ${key.name}.`;
+}
+function normalizeKeyName(name) {
+    const normalized = name.trim();
+    if (!normalized) {
+        throw new Error("API key name cannot be blank.");
+    }
+    return normalized;
+}
+function normalizeScopes(scopes) {
+    if (scopes.length === 0) {
+        throw new Error("Pass at least one --scope, e.g. --scope agents:read.");
+    }
+    const allowed = new Set(API_KEY_SCOPES);
+    const normalized = scopes.map((scope) => normalizeNonBlank(scope, "API key scope"));
+    const unknown = normalized.filter((scope) => !allowed.has(scope));
+    if (unknown.length > 0) {
+        const suggestion = unknown.length === 1 ? closestChoice(unknown[0], API_KEY_SCOPES) : null;
+        throw new Error(`Unknown --scope ${unknown.join(", ")}. Allowed scopes: ${API_KEY_SCOPES.join(", ")}.` +
+            (suggestion ? ` Did you mean ${suggestion}?` : ""));
+    }
+    return normalized;
+}
+function normalizeCreateOptions(scopes, opts) {
+    const normalized = { ...opts };
+    if (opts.expiresAt !== undefined) {
+        normalized.expiresAt = normalizeIsoTimestamp(opts.expiresAt, "--expires-at");
+        if (new Date(normalized.expiresAt).getTime() <= Date.now()) {
+            throw new Error("--expires-at must be in the future.");
+        }
+    }
+    const forced = scopes.filter((scope) => SENSITIVE_API_KEY_SCOPES.has(scope));
+    if (forced.length === 0)
+        return normalized;
+    if (normalized.expiresAt === undefined) {
+        throw new Error(`Sensitive scopes require --expires-at within 90 days: ${forced.join(", ")}.`);
+    }
+    if (new Date(normalized.expiresAt).getTime() > Date.now() + MAX_FORCED_EXPIRY_MS) {
+        throw new Error("Sensitive scopes require --expires-at within 90 days.");
+    }
+    return normalized;
+}
+function addKeysListScopeGuidance(error) {
+    if (error instanceof Error) {
+        const status = error.status;
+        if (status === 403 &&
+            /scope/i.test(error.message) &&
+            /(keys:read|keys:write)/.test(error.message) &&
+            !error.message.includes("Listing API keys requires")) {
+            error.message +=
+                `${error.message.endsWith(".") ? "" : "."} ` +
+                    "Listing API keys requires `keys:read` or `keys:write`.";
+        }
+        return error;
+    }
+    return new Error(String(error));
+}
+//# sourceMappingURL=keys.js.map

package/dist/commands/keys.js.map

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

package/dist/commands/login.d.ts

@@ -0,0 +1,22 @@
+import { type DeviceFlowOptions } from "../device-flow.js";
+export interface LoginOptions {
+    baseUrl?: string;
+    gitBaseUrl?: string;
+    profile?: string;
+    apiKey?: string;
+    fetchImpl?: typeof fetch;
+    runGit?: (args: string[]) => Promise<boolean>;
+    deviceFlow?: Partial<DeviceFlowOptions>;
+    log?: (line: string) => void;
+}
+export interface LoginResult {
+    path: string;
+    helperInstalled: boolean;
+    gitBaseUrl: string;
+    organization: {
+        slug: string;
+        name: string;
+    };
+    keyName: string;
+}
+export declare function login(opts?: LoginOptions): Promise<LoginResult>;

package/dist/commands/login.js

@@ -0,0 +1,78 @@
+import { spawn } from "node:child_process";
+import { hostname } from "node:os";
+import { HttpClient } from "@dharta/sdk";
+import { cliFormatError, cliFormatNetworkError } from "../api-error.js";
+import { DEFAULT_BASE_URL, DEFAULT_GIT_BASE_URL, saveProfile, } from "../config.js";
+import { deviceFlowLogin } from "../device-flow.js";
+import { normalizeHttpUrl, normalizeNonBlank } from "../validators.js";
+// Default path is the RFC 8628 device flow (no key ever pasted); the
+// `--with-token` / apiKey path is the gh-parity fallback for CI and
+// air-gapped boxes.
+export async function login(opts = {}) {
+    const baseUrl = opts.baseUrl === undefined ? DEFAULT_BASE_URL : normalizeHttpUrl(opts.baseUrl, "--base-url");
+    const gitBaseUrl = opts.gitBaseUrl === undefined ? DEFAULT_GIT_BASE_URL : normalizeHttpUrl(opts.gitBaseUrl, "--git-base-url");
+    const profileName = opts.profile === undefined ? "default" : normalizeNonBlank(opts.profile, "--profile");
+    const key = opts.apiKey ??
+        (await deviceFlowLogin({
+            baseUrl,
+            clientName: hostname(),
+            fetchImpl: opts.fetchImpl,
+            log: opts.log,
+            ...opts.deviceFlow,
+        }));
+    if (!key) {
+        throw new Error("No API key provided. Run `dharta login` for the browser flow, or pipe a key: " +
+            "echo $DHARTA_API_KEY | dharta login --with-token");
+    }
+    // Validate the credential and learn who it is in one round-trip.
+    const http = new HttpClient({
+        apiKey: key,
+        baseUrl,
+        fetch: opts.fetchImpl,
+        formatError: cliFormatError,
+        formatNetworkError: cliFormatNetworkError,
+    });
+    const me = await http.request({ path: "/me" });
+    // RFC 0043 D8: the data-plane host this org clones karta workspaces from (the helper
+    // mints against it; the clone bytes never pass through the control plane).
+    const workspaceGitBaseUrl = me.workspace_git?.base_url;
+    const path = await saveProfile(profileName, {
+        api_key: key,
+        base_url: baseUrl,
+        git_base_url: gitBaseUrl,
+        workspace_git_base_url: workspaceGitBaseUrl,
+    });
+    const runGitFn = opts.runGit ?? runGit;
+    // RFC 0011 GIT-5: wire the credential helper so `git push dharta`
+    // never prompts. Scoped to the git host only; the key itself stays
+    // in ~/.dharta/config.toml (the helper reads it at use time, so
+    // re-login/rotation needs no re-wiring). Best effort: a machine
+    // without git still logs in fine.
+    const helperInstalled = await runGitFn([
+        "config",
+        "--global",
+        `credential.${gitBaseUrl}.helper`,
+        "!dharta git-credential",
+    ]);
+    // RFC 0043 D8: the same helper for the workspace clone host, plus useHttpPath so git
+    // passes the karta id in the path (the helper mints a per-karta read-only token).
+    if (workspaceGitBaseUrl) {
+        await runGitFn(["config", "--global", `credential.${workspaceGitBaseUrl}.helper`, "!dharta git-credential"]);
+        await runGitFn(["config", "--global", `credential.${workspaceGitBaseUrl}.useHttpPath`, "true"]);
+    }
+    return {
+        path,
+        helperInstalled,
+        gitBaseUrl,
+        organization: me.organization,
+        keyName: me.api_key.name,
+    };
+}
+function runGit(args) {
+    return new Promise((resolvePromise) => {
+        const proc = spawn("git", args, { stdio: "ignore" });
+        proc.on("error", () => resolvePromise(false));
+        proc.on("close", (code) => resolvePromise(code === 0));
+    });
+}
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

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

package/dist/commands/logs.d.ts

@@ -0,0 +1,14 @@
+import type { CliContext } from "../context.js";
+export interface LogLine {
+    ts: string;
+    level?: string;
+    message: string;
+}
+export interface LogsOptions {
+    tail?: boolean;
+    since?: string;
+    pollIntervalMs?: number;
+    maxIterations?: number;
+}
+export declare function validateLogsOptions(opts: LogsOptions): void;
+export declare function logsTail(ctx: CliContext, slug: string, opts: LogsOptions, write: (line: string) => void): Promise<number>;