@usezombie/zombiectl 0.3.0

package/src/commands/agent_profile.js

@@ -0,0 +1,39 @@
+import { AGENTS_PATH } from "../lib/api-paths.js";
+import { queueCliAnalyticsEvent, setCliAnalyticsContext } from "../lib/analytics.js";
+
+export async function commandAgentProfile(ctx, parsed, agentId, deps) {
+  const { request, apiHeaders, printJson, printKeyValue, printSection = () => {} } = deps;
+
+  const res = await request(ctx, `${AGENTS_PATH}${encodeURIComponent(agentId)}`, {
+    method: "GET",
+    headers: apiHeaders(ctx),
+  });
+  setCliAnalyticsContext(ctx, {
+    agent_id: res.agent_id,
+    workspace_id: res.workspace_id,
+    trust_level: res.trust_level,
+    agent_status: res.status,
+  });
+  queueCliAnalyticsEvent(ctx, "agent_profile_viewed", {
+    agent_id: res.agent_id,
+    workspace_id: res.workspace_id,
+  });
+
+  if (ctx.jsonMode) {
+    printJson(ctx.stdout, res);
+  } else {
+    printSection(ctx.stdout, `Agent profile · ${res.agent_id}`);
+    printKeyValue(ctx.stdout, {
+      agent_id: res.agent_id,
+      name: res.name,
+      status: res.status,
+      workspace_id: res.workspace_id,
+      trust_level: res.trust_level,
+      trust_streak_runs: res.trust_streak_runs,
+      improvement_stalled_warning: res.improvement_stalled_warning,
+      created_at: res.created_at,
+      updated_at: res.updated_at,
+    });
+  }
+  return 0;
+}

package/src/commands/agent_proposals.js

@@ -0,0 +1,158 @@
+import { AGENTS_PATH } from "../lib/api-paths.js";
+import { queueCliAnalyticsEvent, setCliAnalyticsContext } from "../lib/analytics.js";
+
+export async function commandAgentProposals(ctx, parsed, agentId, deps) {
+  const { request, apiHeaders, printJson, printSection = () => {}, printTable, ui, writeLine } = deps;
+
+  const subaction = parsed.positionals[1] || "list";
+  const proposalId = parsed.positionals[2] || null;
+
+  if (subaction === "list") {
+    const res = await request(ctx, `${AGENTS_PATH}${encodeURIComponent(agentId)}/proposals`, {
+      method: "GET",
+      headers: apiHeaders(ctx),
+    });
+    const items = Array.isArray(res.data) ? res.data : [];
+    setCliAnalyticsContext(ctx, {
+      agent_id: agentId,
+      proposal_count: items.length,
+    });
+    queueCliAnalyticsEvent(ctx, "agent_proposals_viewed", {
+      agent_id: agentId,
+      proposal_count: items.length,
+    });
+
+    if (ctx.jsonMode) {
+      printJson(ctx.stdout, res);
+    } else {
+      if (items.length === 0) {
+        writeLine(ctx.stdout, ui.info("no open proposals"));
+      } else {
+        printSection(ctx.stdout, `Agent proposals · ${agentId}`);
+        printTable(ctx.stdout, [
+          { key: "proposal_id", label: "PROPOSAL_ID" },
+          { key: "status", label: "STATUS" },
+          { key: "trigger_reason", label: "TRIGGER" },
+          { key: "action", label: "ACTION" },
+          { key: "config_version_id", label: "CONFIG_VERSION_ID" },
+          { key: "created_at", label: "CREATED_AT" },
+        ], items.map((item) => ({
+          ...item,
+          action: describeProposalAction(item),
+        })));
+      }
+    }
+    return 0;
+  }
+
+  if (!proposalId) {
+    writeLine(ctx.stderr, ui.err(`agent proposals ${subaction} requires <proposal-id>`));
+    return 2;
+  }
+
+  if (subaction === "approve") {
+    const res = await request(
+      ctx,
+      `${AGENTS_PATH}${encodeURIComponent(agentId)}/proposals/${encodeURIComponent(proposalId)}:approve`,
+      {
+        method: "POST",
+        headers: apiHeaders(ctx),
+      },
+    );
+    setCliAnalyticsContext(ctx, {
+      agent_id: agentId,
+      proposal_id: res.proposal_id,
+      proposal_status: res.status,
+    });
+    queueCliAnalyticsEvent(ctx, "agent_proposal_approved", {
+      agent_id: agentId,
+      proposal_id: res.proposal_id,
+    });
+    if (ctx.jsonMode) {
+      printJson(ctx.stdout, res);
+    } else {
+      writeLine(ctx.stdout, ui.ok(`approved ${res.proposal_id} -> ${res.status}`));
+    }
+    return 0;
+  }
+
+  if (subaction === "reject") {
+    const reason = parsed.options.reason || null;
+    const res = await request(
+      ctx,
+      `${AGENTS_PATH}${encodeURIComponent(agentId)}/proposals/${encodeURIComponent(proposalId)}:reject`,
+      {
+        method: "POST",
+        headers: apiHeaders(ctx),
+        body: JSON.stringify(reason ? { reason } : {}),
+      },
+    );
+    setCliAnalyticsContext(ctx, {
+      agent_id: agentId,
+      proposal_id: res.proposal_id,
+      proposal_status: res.status,
+      rejection_reason: res.rejection_reason,
+    });
+    queueCliAnalyticsEvent(ctx, "agent_proposal_rejected", {
+      agent_id: agentId,
+      proposal_id: res.proposal_id,
+    });
+    if (ctx.jsonMode) {
+      printJson(ctx.stdout, res);
+    } else {
+      writeLine(ctx.stdout, ui.ok(`rejected ${res.proposal_id} (${res.rejection_reason})`));
+    }
+    return 0;
+  }
+
+  if (subaction === "veto") {
+    const reason = parsed.options.reason || null;
+    const res = await request(
+      ctx,
+      `${AGENTS_PATH}${encodeURIComponent(agentId)}/proposals/${encodeURIComponent(proposalId)}:veto`,
+      {
+        method: "POST",
+        headers: apiHeaders(ctx),
+        body: JSON.stringify(reason ? { reason } : {}),
+      },
+    );
+    setCliAnalyticsContext(ctx, {
+      agent_id: agentId,
+      proposal_id: res.proposal_id,
+      proposal_status: res.status,
+      rejection_reason: res.rejection_reason,
+    });
+    queueCliAnalyticsEvent(ctx, "agent_proposal_vetoed", {
+      agent_id: agentId,
+      proposal_id: res.proposal_id,
+    });
+    if (ctx.jsonMode) {
+      printJson(ctx.stdout, res);
+    } else {
+      writeLine(ctx.stdout, ui.ok(`vetoed ${res.proposal_id} (${res.rejection_reason})`));
+    }
+    return 0;
+  }
+
+  writeLine(ctx.stderr, ui.err("usage: agent proposals <agent-id>"));
+  writeLine(ctx.stderr, ui.err("       agent proposals <agent-id> approve <proposal-id>"));
+  writeLine(ctx.stderr, ui.err("       agent proposals <agent-id> reject <proposal-id> [--reason TEXT]"));
+  writeLine(ctx.stderr, ui.err("       agent proposals <agent-id> veto <proposal-id> [--reason TEXT]"));
+  return 2;
+}
+
+function describeProposalAction(item) {
+  if (item?.status === "VETO_WINDOW") {
+    return `${formatCountdown(item.auto_apply_at)} - zombiectl agent proposals veto ${item.proposal_id} to cancel`;
+  }
+  return "manual review required";
+}
+
+function formatCountdown(autoApplyAt) {
+  if (!Number.isFinite(autoApplyAt)) return "Auto-apply scheduled";
+  const diffMs = Math.max(0, autoApplyAt - Date.now());
+  const totalMinutes = Math.floor(diffMs / 60000);
+  const hours = Math.floor(totalMinutes / 60);
+  const minutes = totalMinutes % 60;
+  return `Auto-applies in ${hours}h ${minutes}m`;
+}

package/src/commands/agent_scores.js

@@ -0,0 +1,44 @@
+import { AGENTS_PATH } from "../lib/api-paths.js";
+import { queueCliAnalyticsEvent, setCliAnalyticsContext } from "../lib/analytics.js";
+
+export async function commandAgentScores(ctx, parsed, agentId, deps) {
+  const { request, apiHeaders, ui, printJson, printSection = () => {}, printTable, writeLine } = deps;
+
+  const limit = parsed.options.limit || 20;
+  const startingAfter = parsed.options["starting-after"] || null;
+
+  let url = `${AGENTS_PATH}${encodeURIComponent(agentId)}/scores?limit=${limit}`;
+  if (startingAfter) url += `&starting_after=${encodeURIComponent(startingAfter)}`;
+
+  const res = await request(ctx, url, { method: "GET", headers: apiHeaders(ctx) });
+  const items = Array.isArray(res.data) ? res.data : [];
+  setCliAnalyticsContext(ctx, {
+    agent_id: agentId,
+    score_count: items.length,
+    next_cursor: res.next_cursor ?? "",
+  });
+  queueCliAnalyticsEvent(ctx, "agent_scores_viewed", {
+    agent_id: agentId,
+    score_count: items.length,
+  });
+
+  if (ctx.jsonMode) {
+    printJson(ctx.stdout, res);
+  } else {
+    if (items.length === 0) {
+      writeLine(ctx.stdout, ui.info("no scores"));
+    } else {
+      printSection(ctx.stdout, `Agent scores · ${agentId}`);
+      printTable(ctx.stdout, [
+        { key: "score_id", label: "SCORE_ID" },
+        { key: "run_id", label: "RUN_ID" },
+        { key: "score", label: "SCORE" },
+        { key: "scored_at", label: "SCORED_AT" },
+      ], items);
+    }
+    if (res.has_more && res.next_cursor) {
+      writeLine(ctx.stdout, ui.dim(`next: --starting-after ${res.next_cursor}`));
+    }
+  }
+  return 0;
+}

package/src/commands/core-ops.js

@@ -0,0 +1,108 @@
+function createCoreOpsHandlers(ctx, workspaces, deps) {
+  const {
+    apiHeaders,
+    parseFlags,
+    printJson,
+    request,
+    ui,
+    writeLine,
+  } = deps;
+
+  async function commandDoctor() {
+    const checks = [];
+
+    try {
+      const healthz = await request(ctx, "/healthz", { method: "GET" });
+      checks.push({ name: "healthz", ok: healthz.status === "ok", detail: healthz });
+    } catch (err) {
+      checks.push({ name: "healthz", ok: false, detail: String(err) });
+    }
+
+    try {
+      const readyz = await request(ctx, "/readyz", { method: "GET" });
+      checks.push({ name: "readyz", ok: readyz.ready === true, detail: readyz });
+    } catch (err) {
+      checks.push({ name: "readyz", ok: false, detail: String(err) });
+    }
+
+    checks.push({ name: "credentials", ok: Boolean(ctx.token || ctx.apiKey), detail: ctx.token ? "token" : ctx.apiKey ? "api_key" : "missing" });
+    checks.push({ name: "workspace", ok: Boolean(workspaces.current_workspace_id), detail: workspaces.current_workspace_id || "missing" });
+
+    const ok = checks.every((c) => c.ok);
+    const report = { ok, api_url: ctx.apiUrl, checks };
+
+    if (ctx.jsonMode) {
+      printJson(ctx.stdout, report);
+    } else {
+      writeLine(ctx.stdout, ui.head("zombiectl doctor"));
+      writeLine(ctx.stdout);
+      for (const c of checks) {
+        const tag = c.ok ? "[OK]" : "[FAIL]";
+        writeLine(ctx.stdout, c.ok ? ui.ok(`${tag} ${c.name}`) : ui.err(`${tag} ${c.name}`));
+      }
+      writeLine(ctx.stdout);
+      const passed = checks.filter((c) => c.ok).length;
+      if (ok) {
+        writeLine(ctx.stdout, ui.ok(`All checks passed.`));
+      } else {
+        writeLine(ctx.stdout, ui.err(`${passed}/${checks.length} checks passed`));
+      }
+    }
+    return ok ? 0 : 1;
+  }
+
+  async function commandSkillSecret(args) {
+    const action = args[0];
+    const parsed = parseFlags(args.slice(1));
+    const workspaceId = parsed.options["workspace-id"] || workspaces.current_workspace_id;
+    const skillRef = parsed.options["skill-ref"];
+    const key = parsed.options.key;
+
+    if (!workspaceId || !skillRef || !key) {
+      writeLine(ctx.stderr, ui.err("skill-secret requires --workspace-id --skill-ref --key"));
+      return 2;
+    }
+
+    const route = `/v1/workspaces/${encodeURIComponent(workspaceId)}/skills/${encodeURIComponent(skillRef)}/secrets/${encodeURIComponent(key)}`;
+
+    if (action === "put") {
+      if (!parsed.options.value) {
+        writeLine(ctx.stderr, ui.err("skill-secret put requires --value"));
+        return 2;
+      }
+      const body = {
+        value: String(parsed.options.value),
+        scope: parsed.options.scope || "sandbox",
+        meta: {},
+      };
+      const res = await request(ctx, route, {
+        method: "PUT",
+        headers: apiHeaders(ctx),
+        body: JSON.stringify(body),
+      });
+      if (ctx.jsonMode) printJson(ctx.stdout, res);
+      else writeLine(ctx.stdout, ui.ok("skill secret stored"));
+      return 0;
+    }
+
+    if (action === "delete") {
+      const res = await request(ctx, route, {
+        method: "DELETE",
+        headers: apiHeaders(ctx),
+      });
+      if (ctx.jsonMode) printJson(ctx.stdout, res);
+      else writeLine(ctx.stdout, ui.ok("skill secret deleted"));
+      return 0;
+    }
+
+    writeLine(ctx.stderr, ui.err("usage: skill-secret put|delete ..."));
+    return 2;
+  }
+
+  return {
+    commandDoctor,
+    commandSkillSecret,
+  };
+}
+
+export { createCoreOpsHandlers };