@series-a/cli 1.2.0 → 1.3.1

package/src/ui.mjs

@@ -0,0 +1,104 @@
+import chalk from "chalk";
+import Table from "cli-table3";
+
+export function isJsonMode(cmd) {
+  return Boolean(cmd?.optsWithGlobals?.().json ?? cmd?.opts?.().json);
+}
+
+export function emit(cmd, data, renderHuman) {
+  if (isJsonMode(cmd)) {
+    process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+    return;
+  }
+  renderHuman(data);
+}
+
+export function fail(err) {
+  const msg = err?.message ?? String(err);
+  process.stderr.write(chalk.red(`✖ ${msg}\n`));
+  if (err?.body) {
+    try {
+      process.stderr.write(chalk.gray(JSON.stringify(err.body, null, 2)) + "\n");
+    } catch {}
+  }
+  process.exit(1);
+}
+
+export function table(headers, rows) {
+  const t = new Table({
+    head: headers.map((h) => chalk.bold.cyan(h)),
+    style: { head: [], border: ["gray"] },
+    wordWrap: true,
+  });
+  for (const row of rows) t.push(row);
+  return t.toString();
+}
+
+export function truncate(str, n = 40) {
+  if (str == null) return "";
+  const s = String(str);
+  return s.length > n ? s.slice(0, n - 1) + "…" : s;
+}
+
+export function withCommonOpts(cmd) {
+  return cmd
+    .option("--json", "output raw JSON")
+    .option("-w, --workspace <id>", "override workspace_id")
+    .option("-p, --profile <name>", "use a named profile")
+    .option("--api-key <key>", "override API key")
+    .option("--as-agent <name>", "caller identity sent as agent_name (audit label)");
+}
+
+export function ctxFrom(cmd) {
+  const opts = cmd.optsWithGlobals();
+  return {
+    apiKey: opts.apiKey,
+    workspaceId: opts.workspace,
+    profile: opts.profile,
+    agentName: opts.asAgent,
+  };
+}
+
+/**
+ * Gate a destructive command. Returns true when it may proceed.
+ * Non-interactive shells must pass --yes; --json implies scripted use, so it
+ * also requires --yes rather than hanging on a prompt.
+ */
+export async function confirmDestructive(cmd, summary, { expect } = {}) {
+  const opts = cmd.optsWithGlobals();
+  if (opts.yes) return true;
+  if (isJsonMode(cmd) || !process.stdin.isTTY) {
+    process.stderr.write(
+      chalk.red(`✖ Refusing to run without confirmation.\n`) +
+      chalk.gray(`  ${summary}\n  Re-run with --yes to confirm (or --dry-run to preview).\n`),
+    );
+    process.exit(1);
+  }
+  const { default: prompts } = await import("prompts");
+  process.stdout.write(chalk.yellow(`\n${summary}\n`));
+  if (expect) {
+    const r = await prompts({
+      type: "text",
+      name: "v",
+      message: `Type "${expect}" to confirm`,
+    });
+    if (r.v !== expect) {
+      process.stdout.write("Aborted.\n");
+      process.exit(1);
+    }
+    return true;
+  }
+  const r = await prompts({ type: "confirm", name: "v", message: "Proceed?", initial: false });
+  if (!r.v) {
+    process.stdout.write("Aborted.\n");
+    process.exit(1);
+  }
+  return true;
+}
+
+/** Common flags for destructive commands. */
+export function withDestructiveOpts(cmd) {
+  return cmd
+    .option("-y, --yes", "skip the confirmation prompt")
+    .option("--dry-run", "show what would happen without changing anything");
+}