@brainervirus/workit-cli 8.41.1 → 8.42.0

package/dist/index.js

@@ -9417,7 +9417,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@brainervirus/workit-cli",
-    version: "8.41.1",
+    version: "8.42.0",
     private: false,
     description: "Workit CLI — setup wizard, doctor, and task control for agentic coding workflows",
     keywords: [
@@ -9455,13 +9455,13 @@ var init_package = __esm(() => {
     },
     dependencies: {
       "@babel/parser": "7.29.9",
-      "@brainervirus/workit-cursor": "^8.41.1",
+      "@brainervirus/workit-cursor": "^8.42.0",
       "@inkjs/ui": "2.0.0",
       ink: "7.1.1",
       react: "19.2.8"
     },
     devDependencies: {
-      "@brainervirus/workit-core": "^8.41.1"
+      "@brainervirus/workit-core": "^8.42.0"
     },
     engines: {
       node: ">=24"
@@ -21951,6 +21951,108 @@ var init_task = __esm(() => {
   };
 });
 
+// packages/workit-cli/src/style.ts
+import { stripVTControlCharacters } from "node:util";
+function createStyle(options = {}) {
+  const enabled = colorEnabled(options);
+  const pick = (open) => enabled ? sgr(open) : same2;
+  return {
+    enabled,
+    width: enabled ? options.stream?.columns || undefined : undefined,
+    ok: pick("32"),
+    fail: pick("1;31"),
+    warn: pick("33"),
+    info: pick("2"),
+    dim: pick("2"),
+    bold: pick("1"),
+    accent: pick("36"),
+    diffAdd: pick("32"),
+    diffDel: pick("31"),
+    diffHunk: pick("36"),
+    path: pick("2"),
+    command: pick("1;36")
+  };
+}
+function wrap(text, width, indent, firstUsed = indent) {
+  if (!width || width <= indent + 10)
+    return text;
+  const lines = [];
+  let line = "";
+  let room = width - firstUsed;
+  const place = (word) => {
+    let rest = word;
+    while (visibleLength(rest) > room) {
+      const chars = Array.from(rest);
+      lines.push(chars.slice(0, room).join(""));
+      rest = chars.slice(room).join("");
+      room = width - indent;
+    }
+    line = rest;
+  };
+  for (const word of text.split(/ +/)) {
+    if (word === "")
+      continue;
+    if (line === "")
+      place(word);
+    else if (visibleLength(line) + 1 + visibleLength(word) <= room)
+      line = `${line} ${word}`;
+    else {
+      lines.push(line);
+      room = width - indent;
+      place(word);
+    }
+  }
+  lines.push(line);
+  return lines.join(`
+${" ".repeat(indent)}`);
+}
+function colorDiff(text, style) {
+  if (!style.enabled)
+    return text;
+  return text.split(`
+`).map((line) => {
+    if (line.startsWith("+++") || line.startsWith("---"))
+      return style.bold(line);
+    if (line.startsWith("+"))
+      return style.diffAdd(line);
+    if (line.startsWith("-"))
+      return style.diffDel(line);
+    if (line.startsWith("@@") || line.trim() === "…" || line.trim() === "...")
+      return style.diffHunk(line);
+    return style.dim(line);
+  }).join(`
+`);
+}
+function spinnerPaint(elapsed, env, glyph) {
+  const k = (Math.sin(elapsed / 2400 * Math.PI * 2) + 1) / 2;
+  const [r, g, b] = [
+    [170, 80],
+    [120, 200],
+    [255, 255]
+  ].map(([from, to]) => Math.round(from + (to - from) * k));
+  const depth = (env.COLORTERM || "").toLowerCase();
+  const level = (v) => v < 48 ? 0 : v < 115 ? 1 : Math.min(5, Math.floor((v - 35) / 40));
+  const code = depth === "truecolor" || depth === "24bit" ? `38;2;${r};${g};${b}` : /256/.test(env.TERM || "") ? `38;5;${16 + 36 * level(r) + 6 * level(g) + level(b)}` : "36";
+  return `\x1B[${code}m${glyph}\x1B[0m`;
+}
+var truthy = (value) => value !== undefined && value !== "" && value !== "0" && value.toLowerCase() !== "false", terminalMode = (options) => {
+  const env = options.env ?? process.env;
+  if (options.json || !options.stream?.isTTY || truthy(env.CI))
+    return "off";
+  if (truthy(env.NO_COLOR) || env.TERM === "dumb")
+    return "plain";
+  return "spinner";
+}, colorEnabled = (options) => {
+  if (options.json || !options.stream)
+    return false;
+  if (truthy((options.env ?? process.env).FORCE_COLOR))
+    return true;
+  return terminalMode(options) === "spinner";
+}, sgr = (open) => (text) => text === "" ? text : `\x1B[${open}m${text}\x1B[0m`, same2 = (text) => text, visibleLength = (text) => Array.from(stripVTControlCharacters(text)).length, SPINNER_FRAMES, SPINNER_FRAME_MS = 140;
+var init_style = __esm(() => {
+  SPINNER_FRAMES = ["◐", "◓", "◑", "◒"];
+});
+
 // packages/workit-cli/src/output.ts
 function emit(io, envelope, human) {
   if (io.json) {
@@ -21988,11 +22090,12 @@ async function withFailureLine(io, command, run, outcome) {
   });
   if (code === 0)
     return code;
+  const red = createStyle({ stream: io.terminals?.stderr, env: io.env, json: io.json }).fail;
   if (outcome)
-    io.stderr(`workit: error: ${outcome} (${reason ?? EXIT_NAMES[code] ?? "failed"}, exit ${code})
+    io.stderr(`${red(`workit: error: ${outcome} (${reason ?? EXIT_NAMES[code] ?? "failed"}, exit ${code})`)}
 `);
   else if (!wrote)
-    io.stderr(`workit: error: ${command} failed (exit ${code})
+    io.stderr(`${red(`workit: error: ${command} failed (exit ${code})`)}
 `);
   return code;
 }
@@ -22017,6 +22120,7 @@ var EXIT, EXIT_BY_CODE, exitCodeFor = (code) => EXIT_BY_CODE[code], ok2 = (data)
   })));
 };
 var init_output = __esm(() => {
+  init_style();
   EXIT = {
     ok: 0,
     failed: 1,
@@ -75191,14 +75295,18 @@ async function run4(argv, io) {
     ...io.env.HOME ? { home: io.env.HOME } : {}
   });
   const say = io.json ? io.stderr : io.stdout;
+  const style = createStyle({
+    stream: io.json ? io.terminals?.stderr : io.terminals?.stdout,
+    env: io.env
+  });
   for (const note of plan.notes)
     say(`${note}
 `);
   for (const blocked of plan.blocked)
-    say(`blocked: ${blocked}
+    say(`${style.warn("blocked:")} ${blocked}
 `);
   for (const change of plan.changes)
-    say(`${permissionDiff(change)}
+    say(`${colorDiff(permissionDiff(change), style)}
 `);
   const summary = {
     changes: plan.changes.map((c) => ({ host: c.host, file: c.file })),
@@ -75220,7 +75328,7 @@ async function run4(argv, io) {
         data: summary,
         unblock: `review the diff above, then run ${USAGE2.replace("[--dry-run | --yes]", "--yes")} or run it in a terminal`
       }));
-    const answer = await askOrCancel(io, () => askLine("Write Workit's permission block shown above? [y/N] ", io.json ? process.stderr : process.stdout));
+    const answer = await askOrCancel(io, () => askLine(`${style.bold("Write Workit's permission block shown above?")} [y/N] `, io.json ? process.stderr : process.stdout));
     if (answer === null)
       return cancelled(io);
     if (!/^y(es)?$/i.test(answer.trim()))
@@ -75235,7 +75343,7 @@ async function run4(argv, io) {
   if (failed.length)
     return emit(io, fail2("failed", failed.map((e) => `${e.file}: ${e.detail ?? "failed"}`).join("; "), { data }));
   return emit(io, ok2(data), () => [
-    ...entries.map((e) => `written ${e.file}`),
+    ...entries.map((e) => `${style.ok("written")} ${style.path(e.file)}`),
     "Restart the host sessions to load the new permissions. `workit uninstall` removes them."
   ]);
 }
@@ -75271,6 +75379,7 @@ var init_setup2 = __esm(() => {
   init_host_permissions();
   init_output();
   init_prompt();
+  init_style();
   ALL_HOSTS = ["claude-code", "codex", "cursor", "opencode", "pi"];
 });
 
@@ -75279,7 +75388,7 @@ import { spawn } from "node:child_process";
 import path44 from "node:path";
 function createProgress(options = {}) {
   const env = options.env ?? process.env;
-  const mode = modeFor(options, env);
+  const mode = terminalMode({ ...options, env });
   const stream = options.stream;
   const now = options.now ?? Date.now;
   const every = options.setInterval ?? ((tick, ms) => setInterval(tick, ms));
@@ -75287,7 +75396,7 @@ function createProgress(options = {}) {
   const proc = options.proc ?? process;
   const ascii = env.TERM === "dumb";
   const glyphs = mode === "spinner" ? { done: "\x1B[32m✓\x1B[0m", failed: "\x1B[31m✗\x1B[0m", skipped: "–" } : ascii ? { done: "ok", failed: "x", skipped: "-" } : { done: "✓", failed: "✗", skipped: "–" };
-  const start = (initial) => {
+  const start = (initial, signals = true) => {
     if (mode === "off" || !stream)
       return NOOP_STEP;
     let text = initial;
@@ -75296,10 +75405,11 @@ function createProgress(options = {}) {
     let frame = 0;
     const draw = () => {
       const seconds = Math.floor((now() - began) / 1000);
-      let line = `${FRAMES[frame % FRAMES.length]} ${text} (${seconds}s)`;
-      if (stream.columns && line.length >= stream.columns)
-        line = `${line.slice(0, Math.max(1, stream.columns - 2))}…`;
-      stream.write(`${CLEAR}${line}`);
+      let line = `${text} (${seconds}s)`;
+      if (stream.columns && line.length + 2 >= stream.columns)
+        line = `${line.slice(0, Math.max(1, stream.columns - 4))}…`;
+      const glyph = spinnerPaint(now() - began, env, FRAMES[frame % FRAMES.length] ?? "");
+      stream.write(`${CLEAR}${glyph} ${line}`);
     };
     let timer;
     if (mode === "spinner") {
@@ -75315,7 +75425,7 @@ function createProgress(options = {}) {
         proc.off(event, handler);
       handlers.length = 0;
     };
-    if (mode === "spinner") {
+    if (mode === "spinner" && signals) {
       const onSignal = (signal) => () => {
         if (!finished) {
           finished = true;
@@ -75326,11 +75436,13 @@ function createProgress(options = {}) {
         release();
         proc.kill(proc.pid, signal);
       };
+      handlers.push(["SIGINT", onSignal("SIGINT")], ["SIGTERM", onSignal("SIGTERM")]);
+    }
+    if (mode === "spinner") {
       const onExit = () => {
         if (!finished)
           stream.write(CLEAR);
       };
-      handlers.push(["SIGINT", onSignal("SIGINT")], ["SIGTERM", onSignal("SIGTERM")]);
       handlers.push(["exit", onExit]);
       for (const [event, handler] of handlers)
         proc.on(event, handler);
@@ -75357,7 +75469,7 @@ function createProgress(options = {}) {
     mode,
     start,
     async run(label, fn, classify) {
-      const step = start(label);
+      const step = start(label, false);
       try {
         const value = await fn();
         step.end(classify ? classify(value) : "done");
@@ -75368,7 +75480,7 @@ function createProgress(options = {}) {
       }
     },
     runSync(label, fn, classify) {
-      const step = start(label);
+      const step = start(label, false);
       const ticker = mode === "spinner" && stream ? (options.spawnTicker ?? ((text, began) => defaultTicker(text, began, stream)))(label, now()) : undefined;
       try {
         const value = fn();
@@ -75383,7 +75495,7 @@ function createProgress(options = {}) {
     }
   };
 }
-var FRAMES, FRAME_MS = 120, CLEAR = "\r\x1B[2K", TICKER_SOURCE, defaultTicker = (label, began, stream) => {
+var FRAMES, FRAME_MS, CLEAR = "\r\x1B[2K", TICKER_SOURCE, defaultTicker = (label, began, stream) => {
   if (stream !== process.stderr)
     return;
   if (!/^(?:node|nodejs|bun)(?:\.exe)?$/i.test(path44.basename(process.execPath)))
@@ -75405,18 +75517,19 @@ var FRAMES, FRAME_MS = 120, CLEAR = "\r\x1B[2K", TICKER_SOURCE, defaultTicker =
   } catch {
     return;
   }
-}, truthy = (value) => value !== undefined && value !== "" && value !== "0" && value.toLowerCase() !== "false", modeFor = (options, env) => {
-  if (options.json || !options.stream?.isTTY || truthy(env.CI))
-    return "off";
-  if (truthy(env.NO_COLOR) || env.TERM === "dumb")
-    return "plain";
-  return "spinner";
-}, NOOP_STEP;
+}, NOOP_STEP, progressFor = (io) => {
+  const stderr = io.terminals?.stderr;
+  const stream = stderr?.write ? stderr : undefined;
+  return createProgress({ json: io.json, env: io.env, ...stream ? { stream } : {} });
+};
 var init_progress = __esm(() => {
-  FRAMES = ["·", "✢", "✳", "∗", "✻", "✽"];
+  init_style();
+  FRAMES = SPINNER_FRAMES;
+  FRAME_MS = SPINNER_FRAME_MS;
   TICKER_SOURCE = `
 const frames = ${JSON.stringify(FRAMES)};
 const { WORKIT_TICK_LABEL: label, WORKIT_TICK_BEGAN: began, WORKIT_TICK_COLS: cols } = process.env;
+const spinnerPaint = ${spinnerPaint.toString()};
 const parent = process.ppid;
 let frame = 0;
 const timer = setInterval(() => {
@@ -75425,9 +75538,9 @@ const timer = setInterval(() => {
   if (!alive || Date.now() - Number(began) > 600000) process.exit(0);
   frame += 1;
   const seconds = Math.floor((Date.now() - Number(began)) / 1000);
-  let line = frames[frame % frames.length] + " " + label + " (" + seconds + "s)";
-  if (Number(cols) && line.length >= Number(cols)) line = line.slice(0, Math.max(1, Number(cols) - 2)) + "…";
-  process.stderr.write(${JSON.stringify(CLEAR)} + line);
+  let line = label + " (" + seconds + "s)";
+  if (Number(cols) && line.length + 2 >= Number(cols)) line = line.slice(0, Math.max(1, Number(cols) - 4)) + "…";
+  process.stderr.write(${JSON.stringify(CLEAR)} + spinnerPaint(Date.now() - Number(began), process.env, frames[frame % frames.length]) + " " + line);
 }, ${FRAME_MS});
 `;
   NOOP_STEP = { label: () => {}, end: () => {} };
@@ -76418,26 +76531,29 @@ var init_plan = __esm(() => {
 });
 
 // packages/workit-cli/src/upgrade/report.ts
-var pad2 = (text) => text.padEnd(12), summary = (plan, permissions) => {
-  const lines = ["Workit upgrade plan:"];
+var pad2 = (text) => text.padEnd(12), PLAIN, summary = (plan, permissions, style = PLAIN) => {
+  const host = (name) => `  ${style.bold(pad2(name))}`;
+  const run = (fix) => fix ? ` (run: ${style.command(fix)})` : "";
+  const version = (from, to) => `update ${style.dim(from)} -> ${style.ok(to)}`;
+  const lines = [style.bold("Workit upgrade plan:")];
   if (plan.cli)
-    lines.push(`  ${pad2("cli")}update ${plan.cli.installed} -> ${plan.cli.latest}`);
+    lines.push(`${host("cli")}${version(plan.cli.installed, plan.cli.latest)}`);
   for (const entry of plan.entries) {
-    const what = entry.repair ? `reinstall missing plugin files (${entry.latest})` : entry.latest ? `update ${entry.installedVersion ?? "?"} -> ${entry.latest}` : `update (${entry.commands.map((c) => `${c.command} ${c.args.join(" ")}`).join(" && ")})`;
-    lines.push(`  ${pad2(entry.host)}${what}`);
+    const what = entry.repair ? `reinstall missing plugin files (${entry.latest})` : entry.latest ? version(entry.installedVersion ?? "?", entry.latest) : `update (${style.command(entry.commands.map((c) => `${c.command} ${c.args.join(" ")}`).join(" && "))})`;
+    lines.push(`${host(entry.host)}${what}`);
   }
   for (const skipped of plan.skipped)
-    lines.push(`  ${pad2(skipped.host)}${skipped.reason.startsWith("already current") ? "" : "skip: "}${skipped.reason}${skipped.fix ? ` (run: ${skipped.fix})` : ""}`);
+    lines.push(`${host(skipped.host)}${skipped.reason.startsWith("already current") ? style.dim(skipped.reason) : `${style.warn("skip:")} ${skipped.reason}`}${run(skipped.fix)}`);
   for (const failed of plan.failed)
-    lines.push(`  ${pad2(failed.host)}cannot upgrade: ${failed.reason}${failed.fix ? ` (run: ${failed.fix})` : ""}`);
+    lines.push(`${host(failed.host)}${style.fail("cannot upgrade:")} ${failed.reason}${run(failed.fix)}`);
   for (const migration of plan.migrations)
-    lines.push(`  ${pad2("config")}${migration.description}`);
+    lines.push(`${host("config")}${migration.description}`);
   for (const change of permissions)
-    lines.push(`  ${pad2("permissions")}refresh the ${change.host} block in ${change.file}`);
+    lines.push(`${host("permissions")}refresh the ${change.host} block in ${style.path(change.file)}`);
   for (const blocked of plan.blocked)
-    lines.push(`  blocked: ${blocked}`);
+    lines.push(`  ${style.fail("blocked:")} ${blocked}`);
   for (const warning of plan.warnings ?? [])
-    lines.push(`  warning: ${warning}`);
+    lines.push(`  ${style.warn("warning:")} ${warning}`);
   return lines.join(`
 `) + `
 `;
@@ -76445,10 +76561,14 @@ var pad2 = (text) => text.padEnd(12), summary = (plan, permissions) => {
   const label = LABEL[entry.status];
   const head = entry.reason.slice(0, label.length);
   return entry.status !== "failed" && head.toLowerCase() === label.toLowerCase() && !/^[a-z]/i.test(entry.reason[label.length] ?? "") ? entry.reason.slice(label.length).replace(/^[\s:;,-]+/, "") : entry.reason;
-}, table = (hosts) => [
-  "Result:",
-  ...hosts.map((entry) => `  ${pad2(entry.host)}${LABEL[entry.status].padEnd(16)}${reasonFor(entry)}${entry.fix && entry.status !== "updated" && entry.status !== "current" ? `
-  ${pad2("")}${"".padEnd(16)}fix: ${entry.fix}` : ""}`)
+}, PAINT, table = (hosts, style = PLAIN) => [
+  style.bold("Result:"),
+  ...hosts.map((entry) => {
+    const paint = style[PAINT[entry.status]];
+    const reason = reasonFor(entry);
+    return `  ${style.bold(pad2(entry.host))}${paint(LABEL[entry.status])}${" ".repeat(16 - LABEL[entry.status].length)}${entry.status === "current" ? style.dim(reason) : reason}${entry.fix && entry.status !== "updated" && entry.status !== "current" ? `
+  ${pad2("")}${"".padEnd(16)}fix: ${style.command(entry.fix)}` : ""}`;
+  })
 ].join(`
 `) + `
 `, askConfirm = async (question, out) => {
@@ -76461,12 +76581,20 @@ var pad2 = (text) => text.padEnd(12), summary = (plan, permissions) => {
   return /^y(?:es)?$/i.test((await askLine(question)).trim());
 };
 var init_report = __esm(() => {
+  init_style();
+  PLAIN = createStyle({ json: true });
   LABEL = {
     updated: "updated",
     current: "already current",
     skipped: "skipped",
     failed: "FAILED"
   };
+  PAINT = {
+    updated: "ok",
+    current: "dim",
+    skipped: "warn",
+    failed: "fail"
+  };
 });
 
 // packages/workit-cli/src/upgrade.ts
@@ -76498,6 +76626,11 @@ async function runUpgradeCommand(argv, deps = {}) {
   });
   plan.ok = plan.blocked.length === 0 && plan.failed.length === 0;
   const { home, env } = upgradePaths(deps);
+  const style = createStyle({
+    stream: out === process.stdout ? process.stdout : undefined,
+    env,
+    json
+  });
   const permissions = planHostPermissions({
     hosts: raw,
     refreshOnly: true,
@@ -76515,7 +76648,7 @@ async function runUpgradeCommand(argv, deps = {}) {
   };
   const withPermissions = (value) => permissions.changes.length ? { ...value, permissions: permissionPreview } : value;
   const applyCommand = `workit upgrade ${[...hostFlag === undefined ? [] : [`--hosts=${hostFlag}`], ...flags.has("--cli") ? ["--cli"] : [], "--yes"].join(" ")}`;
-  const nothingChanged = `preview only; nothing changed. Apply with: ${applyCommand}
+  const nothingChanged = `${style.dim("preview only; nothing changed.")} Apply with: ${style.command(applyCommand)}
 `;
   if (json && !legacy && !flags.has("--yes")) {
     out.write(JSON.stringify(withPermissions(plan), null, 2) + `
@@ -76523,20 +76656,20 @@ async function runUpgradeCommand(argv, deps = {}) {
     return plan.blocked.length ? 1 : 0;
   }
   if (!json)
-    out.write(summary(plan, permissions.changes));
+    out.write(summary(plan, permissions.changes, style));
   if (flags.has("--preview")) {
     out.write(nothingChanged);
     return plan.blocked.length ? 1 : 0;
   }
   if (plan.blocked.length) {
-    out.write(`Upgrade blocked: ${plan.blocked.join("; ")}
+    out.write(`${style.fail("Upgrade blocked:")} ${plan.blocked.join("; ")}
 Nothing changed.
 `);
     return 1;
   }
   const work = plan.entries.length + plan.migrations.length + (plan.cli ? 1 : 0) + permissions.changes.length;
   if (work > 0 && !flags.has("--yes") && !legacy) {
-    const confirmed = await (deps.confirm ?? ((q) => askConfirm(q, out)))("Apply this upgrade? [y/N] ");
+    const confirmed = await (deps.confirm ?? ((q) => askConfirm(q, out)))(`${style.bold("Apply this upgrade?")} [y/N] `);
     if (!confirmed) {
       out.write(nothingChanged);
       return 0;
@@ -76575,19 +76708,19 @@ Nothing changed.
     return failed ? 1 : 0;
   }
   if (result.error && result.hosts.every((h) => h.status !== "failed"))
-    out.write(`Upgrade stopped: ${result.error}
+    out.write(`${style.fail("Upgrade stopped:")} ${result.error}
 `);
-  out.write(table(result.hosts));
+  out.write(table(result.hosts, style));
   if (permissions.refused)
-    out.write(`permissions: not refreshed: ${permissions.refused}
+    out.write(`permissions: ${style.warn("not refreshed:")} ${permissions.refused}
 `);
   if (result.backup)
-    out.write(`Backup: ${result.backup}
+    out.write(`Backup: ${style.path(result.backup)}
 `);
-  out.write(left.length === 0 ? `Verified: workit doctor is clean for versions, assets, agents and permissions.
-` : `Left after upgrade (workit doctor):
-${left.map((check) => `  ${check.id}: ${check.detail}${check.fix ? `
-    fix: ${check.fix}` : ""}`).join(`
+  out.write(left.length === 0 ? `${style.ok("Verified:")} workit doctor is clean for versions, assets, agents and permissions.
+` : `${style.warn("Left after upgrade (workit doctor):")}
+${left.map((check) => `  ${style.bold(check.id)}: ${check.detail}${check.fix ? `
+    fix: ${style.command(check.fix)}` : ""}`).join(`
 `)}
 `);
   return failed ? 1 : 0;
@@ -76650,6 +76783,7 @@ var init_upgrade = __esm(() => {
   init_doctor();
   init_host_permissions();
   init_progress();
+  init_style();
   init_apply();
   init_plan();
   init_report();
@@ -76946,6 +77080,7 @@ var init_knowledge = __esm(() => {
 // packages/workit-cli/src/verbs/doctor.ts
 var exports_doctor = {};
 __export(exports_doctor, {
+  renderDoctor: () => renderDoctor,
   run: () => run7
 });
 async function confirmForcedLockClear(root, args, io) {
@@ -77010,7 +77145,7 @@ async function run7(argv, io) {
       };
     }
   }
-  const report = createProgress({ stream: process.stderr, json: io.json }).runSync("Checking Workit (workit doctor)", () => runDoctor({
+  const report = progressFor(io).runSync("Checking Workit (workit doctor)", () => runDoctor({
     host: "cli",
     cwd: io.cwd,
     workspaceRoot: root,
@@ -77047,24 +77182,65 @@ async function run7(argv, io) {
   if (checksConfig && checksConfig.action !== "none")
     io.stdout(`fix: checks config ${checksConfig.action}: ${checksConfig.detail}
 `);
-  io.stdout(`workit doctor — ${report.ok ? "healthy" : "problems found"} (${report.offline ? "offline" : "online"})
+  for (const line of renderDoctor(report, knowledgeLine, createStyle({ stream: io.terminals?.stdout, env: io.env, json: io.json })))
+    io.stdout(`${line}
 `);
+  return report.exitCode;
+}
+function renderDoctor(report, knowledgeLine, style) {
+  const summary = `passed ${report.summary.passed} / warned ${report.summary.warned} / failed ${report.summary.failed}`;
+  const header = `workit doctor — ${report.ok ? "healthy" : "problems found"} (${report.offline ? "offline" : "online"})`;
+  if (!style.enabled) {
+    const lines = [header];
+    for (const check of report.checks) {
+      const mark = check.status === "fail" ? "FAIL" : check.status === "warn" ? "WARN" : "ok  ";
+      lines.push(`${mark} ${check.id} — ${check.detail}`);
+      if (check.fix)
+        lines.push(`     fix: ${check.fix.replaceAll(`
+`, `
+          `)}`);
+    }
+    return [...lines, knowledgeLine, summary];
+  }
+  const marks = {
+    pass: style.ok("ok  "),
+    info: style.info("info"),
+    warn: style.warn("WARN"),
+    fail: style.fail("FAIL")
+  };
+  const idWidth = Math.min(ID_COLUMN, Math.max(0, ...report.checks.map((check) => check.id.length)));
+  const column = 5 + idWidth + 2;
+  const fixLines = (fix) => `     fix: ${fix.split(`
+`).map((line) => style.command(line)).join(`
+          `)}`;
+  const row = (check) => {
+    const id = check.id.padEnd(idWidth);
+    const used = 5 + id.length + 2;
+    return `${marks[check.status]} ${style.bold(id)}  ${wrap(check.detail, style.width, column, used)}`;
+  };
+  const lines = [
+    `workit doctor — ${report.ok ? style.ok("healthy") : style.fail("problems found")} ${style.dim(`(${report.offline ? "offline" : "online"})`)}`
+  ];
   for (const check of report.checks) {
-    const mark = check.status === "fail" ? "FAIL" : check.status === "warn" ? "WARN" : "ok  ";
-    io.stdout(`${mark} ${check.id} — ${check.detail}
-`);
+    lines.push(row(check));
     if (check.fix)
-      io.stdout(`     fix: ${check.fix.replaceAll(`
-`, `
-          `)}
-`);
+      lines.push(fixLines(check.fix));
   }
-  io.stdout(`${knowledgeLine}
-`);
-  io.stdout(`passed ${report.summary.passed} / warned ${report.summary.warned} / failed ${report.summary.failed}
-`);
-  return report.exitCode;
+  lines.push(style.dim(wrap(knowledgeLine, style.width, 5)));
+  const attention = report.checks.filter((c) => c.status === "fail" || c.status === "warn");
+  if (attention.length > 0) {
+    lines.push("", style.bold("Needs attention:"));
+    for (const check of attention) {
+      lines.push(row(check));
+      if (check.fix)
+        lines.push(fixLines(check.fix));
+    }
+  }
+  const paint = report.summary.failed > 0 ? style.fail : report.summary.warned > 0 ? style.warn : style.ok;
+  lines.push(paint(summary));
+  return lines;
 }
+var ID_COLUMN = 28;
 var init_doctor2 = __esm(() => {
   init_package();
   init_doctor();
@@ -77072,6 +77248,7 @@ var init_doctor2 = __esm(() => {
   init_store_lock();
   init_output();
   init_progress();
+  init_style();
   init_prompt();
   init_task();
 });
@@ -77555,7 +77732,7 @@ async function run8(argv, io) {
   const store = new TaskStore(workspaceRootFor({ cwd: io.cwd }));
   const location = store.location();
   const logs = location.ok ? pruneCheckLogs(location.data.dir, { dryRun }) : null;
-  const result = store.collectGarbage({ dryRun, pruneRecovery });
+  const result = progressFor(io).runSync("Collecting garbage", () => store.collectGarbage({ dryRun, pruneRecovery }), (r) => r.ok ? "done" : "failed");
   if (!result.ok)
     return emit(io, fail2(result.code === "busy" ? "busy" : "failed", `${result.code}: ${result.error}`, {
       data: { code: result.code, details: result.details },
@@ -77580,6 +77757,7 @@ async function run8(argv, io) {
 }
 var megabytes = (bytes) => (bytes / 1048576).toFixed(1);
 var init_gc = __esm(() => {
+  init_progress();
   init_checks3();
   init_task_store();
   init_output();
@@ -79428,7 +79606,7 @@ async function prepareHeavy(io, settings, label, runCwd, timeoutMs) {
       wrapper: null,
       env: io.env
     };
-  const progress = createProgress({ stream: process.stderr, json: io.json });
+  const progress = progressFor(io);
   let waiting = null;
   const acquired = await acquireLease({
     dir,
@@ -85673,13 +85851,13 @@ function placeRef(ref, forge, tracker, relation, youtrackBase) {
   const configured = tracker?.provider === ref.tracker;
   const home = ref.tracker === forge.kind ? forge.host : DEFAULT_HOST[ref.tracker];
   const host = ref.host ?? (configured ? tracker?.host : null) ?? home;
-  const repo = ref.repo ?? (configured ? tracker?.repo : null) ?? (ref.tracker === forge.kind && same2(host, forge.host) ? forge.repo : null);
+  const repo = ref.repo ?? (configured ? tracker?.repo : null) ?? (ref.tracker === forge.kind && same3(host, forge.host) ? forge.repo : null);
   if (!repo)
     return {
       error: `#${ref.id} is a ${ref.tracker} issue, but the PR is on ${forge.kind}: set issues.repo to the ${ref.tracker} project that holds it, or pass the issue URL`
     };
-  if (ref.tracker === forge.kind && same2(host, forge.host)) {
-    const own = same2(repo, forge.repo);
+  if (ref.tracker === forge.kind && same3(host, forge.host)) {
+    const own = same3(repo, forge.repo);
     return {
       tracker: ref.tracker,
       id: ref.id,
@@ -85816,7 +85994,7 @@ function issueForge(resolved, link, runner) {
   if (link.repo === null && link.host === null)
     return resolved.forge;
   const apiHost = resolved.forge.apiHost;
-  if (link.tracker !== resolved.forge.kind || !same2(link.host ?? apiHost, apiHost))
+  if (link.tracker !== resolved.forge.kind || !same3(link.host ?? apiHost, apiHost))
     return null;
   const options = {
     apiHost,
@@ -85883,7 +86061,7 @@ async function postBacklinks(cwd, resolved, pr, links, deps = {}) {
   }
   return out;
 }
-var DEFAULT_HOST, same2 = (left, right) => (left ?? "").toLowerCase() === (right ?? "").toLowerCase(), issueUrl = (kind, host, repo, id) => `https://${host}/${repo}/${kind === "gitlab" ? "-/" : ""}issues/${id}`, label = (link) => link.tracker === "youtrack" ? link.id : link.url ?? `${link.repo ?? ""}#${link.id}`, defaultYouTrackComment = (root, issueId, text, marker) => writeOnce(issueId, marker, "comments", async () => {
+var DEFAULT_HOST, same3 = (left, right) => (left ?? "").toLowerCase() === (right ?? "").toLowerCase(), issueUrl = (kind, host, repo, id) => `https://${host}/${repo}/${kind === "gitlab" ? "-/" : ""}issues/${id}`, label = (link) => link.tracker === "youtrack" ? link.id : link.url ?? `${link.repo ?? ""}#${link.id}`, defaultYouTrackComment = (root, issueId, text, marker) => writeOnce(issueId, marker, "comments", async () => {
   try {
     return {
       ok: true,
@@ -87843,7 +88021,7 @@ async function create4(argv, io) {
     return usage4(io, planned.error, CREATE_USAGE);
   const links = planned.data.links;
   const actor = actorFromEnv(io.env);
-  const result = await createPullRequest(io.cwd, connected.data, {
+  const result = await progressFor(io).run("Opening the pull request", () => createPullRequest(io.cwd, connected.data, {
     base,
     title,
     body: withIssueLines(body ?? "", links),
@@ -87851,12 +88029,12 @@ async function create4(argv, io) {
     actor,
     labels: flags.lists.label ?? [],
     reviewers: flags.lists.reviewer ?? []
-  }, forgeDeps.sleep);
+  }, forgeDeps.sleep), (r) => r.ok ? "done" : "failed");
   if (!result.ok)
     return forgeFail(io, result);
   const opened = result.data.created;
   const linked = opened ? recordIssueLinks(io.cwd, result.data, links, { actor, forge: forge.kind, repo: forge.repo }) : [];
-  const backlinks = opened && planned.data.backlink && links.length ? await postBacklinks(io.cwd, connected.data, result.data, links, { env: io.env }) : [];
+  const backlinks = opened && planned.data.backlink && links.length ? await progressFor(io).run("Posting issue backlinks", () => postBacklinks(io.cwd, connected.data, result.data, links, { env: io.env })) : [];
   const created = {
     ...result.data,
     issues: links.map((link) => ({
@@ -87965,7 +88143,7 @@ async function merge3(argv, io) {
   const connected = connect(io);
   if (!connected.ok)
     return forgeFail(io, connected);
-  const result = await mergePullRequest(io.cwd, connected.data, {
+  const result = await progressFor(io).run(`Merging PR #${pr}`, () => mergePullRequest(io.cwd, connected.data, {
     pr,
     method,
     deleteBranch: flags.booleans.has("delete-branch"),
@@ -87975,7 +88153,7 @@ async function merge3(argv, io) {
     ...baseRedOk && baseRedReason ? { baseRedOk: { reason: baseRedReason } } : {},
     ...subject !== undefined ? { subject } : {},
     ...body !== undefined ? { body } : {}
-  }, forgeDeps.sleep);
+  }, forgeDeps.sleep), (r) => r.ok ? "done" : "failed");
   if (!result.ok)
     return emit(io, fail2(result.code, result.error, {
       unblock: result.unblock,
@@ -88179,6 +88357,7 @@ var CONVENTIONAL_TYPES, COMMITLINT_FILES, DEFAULT_IGNORES, UNCHECKED = (what) =>
   return `verdict ${verdict.verdictId} accepted for that head${verdict.cover ? ` (stack verdict on ${verdict.cover.branch} @ ${verdict.cover.head.slice(0, 12)})` : verdict.carry ? ` (${carryLabel(verdict.carry)})` : ""}`;
 }, acceptedHow = (verdict) => verdict.cover ? `stack verdict ${verdict.cover.verdictId} on ${verdict.cover.branch} @ ${verdict.cover.head.slice(0, 12)}` : verdict.carry ? carryLabel(verdict.carry) : verdict.basis, METHODS2;
 var init_pr = __esm(() => {
+  init_progress();
   init_autonomy();
   init_issue_link();
   init_pr_edit();
@@ -88292,7 +88471,7 @@ async function wait2(argv, io) {
   let verdict = { state: "waiting", reason: "not_polled" };
   let baseContexts = null;
   let expectedMissing = [];
-  const waiting = createProgress({ stream: process.stderr, json: io.json }).start("Waiting for CI");
+  const waiting = progressFor(io).start("Waiting for CI");
   const abort = (...args) => {
     waiting.end("failed");
     return forgeFail(io, ...args);
@@ -88415,15 +88594,15 @@ async function rerun(argv, io) {
   const number = selectPr(io.cwd, resolved, { pr, branch: flags.values.branch ?? null });
   if (!number.ok)
     return forgeFail(io, number);
-  const status = resolved.forge.prStatus(number.data);
+  const status = progressFor(io).runSync(`Reading PR #${number.data} checks`, () => resolved.forge.prStatus(number.data), (r) => r.ok ? "done" : "failed");
   if (!status.ok)
     return forgeFail(io, status);
-  const done = executeRerun(io.cwd, resolved, status.data, {
+  const done = progressFor(io).runSync("Rerunning the checks", () => executeRerun(io.cwd, resolved, status.data, {
     failed: names.length === 0,
     names,
     reason,
     force: flags.booleans.has("force")
-  });
+  }), (r) => r.ok ? "done" : "failed");
   if (!done.ok)
     return forgeFail(io, done);
   const outcome = done.data;
@@ -89537,17 +89716,17 @@ async function releasePr(io, plan, dryRun) {
   const switched = switchToRelease(io.cwd, plan);
   if (!switched.ok)
     return forgeFail(io, switched);
-  const pushed = await subVerb(() => Promise.resolve().then(() => (init_git2(), exports_git)), ["push", "--set-upstream"], io);
+  const pushed = await progressFor(io).run(`Pushing ${plan.branch}`, () => subVerb(() => Promise.resolve().then(() => (init_git2(), exports_git)), ["push", "--set-upstream"], io), (r) => r.ok ? "done" : "failed");
   if (!pushed.ok)
     return emit(io, pushed);
-  const pr = await subVerb(() => Promise.resolve().then(() => (init_pr(), exports_pr)), [
+  const pr = await progressFor(io).run("Opening the release PR", () => subVerb(() => Promise.resolve().then(() => (init_pr(), exports_pr)), [
     "create",
     "--base",
     plan.production,
     "--title",
     title,
     `--body=${plan.changelog ?? `Release ${plan.version}`}`
-  ], io);
+  ], io), (r) => r.ok ? "done" : "failed");
   if (!pr.ok)
     return emit(io, pr);
   recordReleaseStep(io.cwd, actorFromEnv(io.env), plan, {
@@ -89603,11 +89782,11 @@ async function finish2(argv, io) {
   if (!push.allowed)
     return blocked(io, push);
   const resume = `workit release finish ${plan.version}${plan.track ? ` --track ${plan.track}` : ""}`;
-  const merged = finishLocally(io.cwd, plan, actor);
+  const merged = progressFor(io).runSync(`Merging release ${plan.version} locally`, () => finishLocally(io.cwd, plan, actor), (r) => r.ok ? "done" : "failed");
   if (!merged.ok)
     return forgeFail(io, merged, { step: "merge", resume });
   const notes = [...plan.notes];
-  const pushed = await subVerb(() => Promise.resolve().then(() => (init_git2(), exports_git)), ["push", ...[...plan.pushBranches, plan.tag].flatMap((ref) => ["--release", ref])], io);
+  const pushed = await progressFor(io).run("Pushing the release branches and tag", () => subVerb(() => Promise.resolve().then(() => (init_git2(), exports_git)), ["push", ...[...plan.pushBranches, plan.tag].flatMap((ref) => ["--release", ref])], io), (r) => r.ok ? "done" : "failed");
   if (!pushed.ok)
     return emit(io, { ...pushed, data: { ...pushed.data, step: "push", resume } });
   if (plan.published && plan.remote) {
@@ -89739,6 +89918,7 @@ var START_USAGE = "workit release start <version> [--hotfix] [--track <t>] [--js
   { step: `verify ${plan.tag} on the remote`, done: false }
 ];
 var init_release2 = __esm(() => {
+  init_progress();
   init_autonomy();
   init_verify();
   init_ops();
@@ -89789,14 +89969,14 @@ async function run19(argv, io) {
   if (expect === "pushed") {
     if (pr)
       return usage4(io, "push is checked by --branch, not --pr", USAGE12);
-    result = verifyPushed(io.cwd, { branch, sha, actor });
+    result = progressFor(io).runSync("Checking the push", () => verifyPushed(io.cwd, { branch, sha, actor }), (r) => r.ok ? "done" : "failed");
   } else if (expect === "released") {
-    result = verifyReleased(io.cwd, { tag: flags.values.tag ?? null, pkg: flags.values.package ?? null, sha, actor }, forgeDeps.npm);
+    result = progressFor(io).runSync("Checking the release", () => verifyReleased(io.cwd, { tag: flags.values.tag ?? null, pkg: flags.values.package ?? null, sha, actor }, forgeDeps.npm), (r) => r.ok ? "done" : "failed");
   } else {
     const connected = connect(io, branch);
     if (!connected.ok)
       return forgeFail(io, connected);
-    result = expect === "pr" ? verifyPr(io.cwd, connected.data, { pr, branch, sha, actor }) : verifyMerged(io.cwd, connected.data, { pr, branch, actor });
+    result = expect === "pr" ? progressFor(io).runSync(`Checking the PR`, () => verifyPr(io.cwd, connected.data, { pr, branch, sha, actor }), (r) => r.ok ? "done" : "failed") : progressFor(io).runSync("Checking the merge", () => verifyMerged(io.cwd, connected.data, { pr, branch, actor }), (r) => r.ok ? "done" : "failed");
   }
   if (!result.ok)
     return forgeFail(io, result);
@@ -89823,6 +90003,7 @@ var USAGE12 = "workit verify-delivery [push|pr|merge|release] [--expect pushed|p
   ...report.observations.map((entry) => `  ${entry.ok ? "ok" : "x "} ${entry.kind}: expected ${entry.expected ?? "-"}, observed ${entry.observed ?? "(none)"}${entry.note ? ` — ${entry.note}` : ""}`)
 ];
 var init_verify_delivery = __esm(() => {
+  init_progress();
   init_verify();
   init_task_store();
   init_task_delivery();
@@ -89958,7 +90139,7 @@ async function sync(argv, io, restack = false) {
     };
   }
   const name = selected.data.name;
-  const result = await withStackLock(io.cwd, name, async () => {
+  const result = await progressFor(io).run(restack ? `Restacking ${name}` : `Syncing ${name}`, () => withStackLock(io.cwd, name, async () => {
     const fresh = readStack(io.cwd, name);
     if (!fresh.ok)
       return fresh;
@@ -89971,10 +90152,13 @@ async function sync(argv, io, restack = false) {
       ok: true,
       data: {
         ...synced.data,
-        pruned: pruneMergedBranches(io.cwd, ctx, stack, { dryRun, actor: actorFromEnv(io.env) })
+        pruned: pruneMergedBranches(io.cwd, ctx, stack, {
+          dryRun,
+          actor: actorFromEnv(io.env)
+        })
       }
     };
-  });
+  }), (r) => r.ok ? "done" : "failed");
   if (!result.ok)
     return stackFailed(io, result);
   if (restack)
@@ -90023,7 +90207,7 @@ async function land(argv, io) {
   if (!connected.ok)
     return forgeFail(io, connected);
   const name = selected.data.name;
-  const result = await withStackLock(io.cwd, name, async () => {
+  const result = await progressFor(io).run(`Landing ${name}`, () => withStackLock(io.cwd, name, async () => {
     const fresh = readStack(io.cwd, name);
     if (!fresh.ok)
       return fresh;
@@ -90041,7 +90225,7 @@ async function land(argv, io) {
       unverified,
       baseRedOk: baseRedOk && baseRedReason ? { reason: baseRedReason } : null
     });
-  });
+  }), (r) => r.ok ? "done" : "failed");
   if (!result.ok)
     return stackFailed(io, result);
   const kind = connected.data.forge.kind;
@@ -90088,6 +90272,7 @@ var PLAN_USAGE = "workit stack plan [--name <n>] [--trunk <b> | --track <t>] [<b
   ...data.pruned.kept.map((item) => `kept merged branch ${item.branch}: ${item.reason}`)
 ], METHODS3;
 var init_stack2 = __esm(() => {
+  init_progress();
   init_ledger();
   init_stack();
   init_output();
@@ -90850,11 +91035,11 @@ function check2(argv, io) {
   const selected = selectFanout(io.cwd, flags.values.name ?? null, currentBranch(io.cwd));
   if (!selected.ok)
     return failed(io, selected);
-  const result = checkFanout(io.cwd, selected.data, {
+  const result = progressFor(io).runSync("Checking the fan-out slices", () => checkFanout(io.cwd, selected.data, {
     only: flags.positionals,
     trunkRef: flags.values.base ?? null,
     forge: forgeFor(io, flags.booleans.has("offline")).forge
-  });
+  }), (r) => r.ok ? "done" : "failed");
   if (!result.ok)
     return failed(io, result);
   if (result.data.ready)
@@ -90883,11 +91068,11 @@ function status4(argv, io) {
   if (!selected.ok)
     return failed(io, selected);
   const forge = forgeFor(io, flags.booleans.has("offline"));
-  const result = fanoutStatus(io.cwd, selected.data, {
+  const result = progressFor(io).runSync("Reading the fan-out status", () => fanoutStatus(io.cwd, selected.data, {
     forge: forge.forge,
     forgeError: forge.error,
     stuckAfterMs
-  });
+  }), (r) => r.ok ? "done" : "failed");
   if (!result.ok)
     return failed(io, result);
   return emit(io, ok2(result.data), renderStatus2);
@@ -90993,6 +91178,7 @@ var PLAN_USAGE2 = "workit fanout plan <plan.json> [--name <n>] [--trunk <b> | --
   ];
 };
 var init_fanout2 = __esm(() => {
+  init_progress();
   init_fanout_brief();
   init_fanout_check();
   init_fanout_status();
@@ -108171,7 +108357,7 @@ async function run25(argv, io) {
   }
   const results = [];
   for (const entry of steps) {
-    const outcome = await entry.run();
+    const outcome = await progressFor(io).run(entry.label, () => entry.run());
     results.push({
       step: entry.label,
       status: outcome.status,
@@ -108206,6 +108392,7 @@ var USAGE18 = "workit youtrack note <ISSUE> (--markdown <t> | --file <p>) [--min
   }
 };
 var init_youtrack2 = __esm(() => {
+  init_progress();
   init_youtrack();
   init_youtrack_tools();
   init_youtrack_writes();
@@ -109348,7 +109535,16 @@ var defaultIo = (json) => ({
 async function main(argv, overrides = {}, options = {}) {
   const parsed = parseGlobals(argv);
   const cwd = path78.resolve(overrides.cwd ?? process.cwd(), parsed.cwd ?? ".");
-  const io = { ...defaultIo(parsed.json), ...overrides, json: parsed.json, cwd };
+  const io = {
+    ...defaultIo(parsed.json),
+    terminals: {
+      ...overrides.stdout ? {} : { stdout: process.stdout },
+      ...overrides.stderr ? {} : { stderr: process.stderr }
+    },
+    ...overrides,
+    json: parsed.json,
+    cwd
+  };
   if (parsed.error)
     return emit(io, fail2("invalid_input", parsed.error));
   if (parsed.session !== undefined) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainervirus/workit-cli",
-  "version": "8.41.1",
+  "version": "8.42.0",
   "private": false,
   "description": "Workit CLI — setup wizard, doctor, and task control for agentic coding workflows",
   "keywords": [
@@ -38,13 +38,13 @@
   },
   "dependencies": {
     "@babel/parser": "7.29.9",
-    "@brainervirus/workit-cursor": "^8.41.1",
+    "@brainervirus/workit-cursor": "^8.42.0",
     "@inkjs/ui": "2.0.0",
     "ink": "7.1.1",
     "react": "19.2.8"
   },
   "devDependencies": {
-    "@brainervirus/workit-core": "^8.41.1"
+    "@brainervirus/workit-core": "^8.42.0"
   },
   "engines": {
     "node": ">=24"