@kaynooo/cli-doctor 0.8.0 → 0.9.0

package/dist/cli-bin.js

@@ -2,16 +2,37 @@
 // @bun
 
 // src/cli-bin.ts
-import process15 from "process";
+import process18 from "process";
 // ../kit/src/args.ts
-import process5 from "process";
+import process7 from "process";
 import { parseArgs } from "util";
 
 // ../kit/src/format.ts
-import process3 from "process";
+import process5 from "process";
 
-// ../kit/src/style.ts
+// ../kit/src/mode.ts
 import process2 from "process";
+var MODES = new Set(["terminal", "ci", "agent", "pipe"]);
+var AGENT_VARIABLES = ["CLAUDECODE", "AI_AGENT"];
+function isSet(value) {
+  return value !== undefined && value !== "" && value !== "0" && value.toLowerCase() !== "false";
+}
+function outputMode(stream = process2.stdout, env = process2.env) {
+  const chosen = env.KIT_MODE;
+  if (chosen !== undefined && MODES.has(chosen))
+    return chosen;
+  if (AGENT_VARIABLES.some((name) => isSet(env[name])))
+    return "agent";
+  if (stream.isTTY === true)
+    return "terminal";
+  return isSet(env.CI) ? "ci" : "pipe";
+}
+function isInteractive(streams = process2) {
+  return streams.stdin?.isTTY === true && streams.stderr?.isTTY === true;
+}
+
+// ../kit/src/style.ts
+import process4 from "process";
 
 // ../../node_modules/.bun/@kaynooo+utils@2.31.2+d0769e28dc4dad16/node_modules/@kaynooo/utils/dist/chunk-mtetydvc.js
 function x(s) {
@@ -274,22 +295,34 @@ function le(i = {}) {
 }
 var t = le();
 
+// ../kit/src/user-config.ts
+import { homedir } from "os";
+import { join } from "path";
+import process3 from "process";
+function configBase(where = {}) {
+  const xdg = where.xdg ?? (where.home === undefined ? process3.env.XDG_CONFIG_HOME : undefined);
+  return xdg !== undefined && xdg !== "" ? xdg : join(where.home ?? homedir(), ".config");
+}
+function userConfigPath(bin, where = {}) {
+  return join(configBase(where), "kaynooo-cli", `${bin}.json`);
+}
+
 // ../kit/src/theme.ts
 var STYLES = new Set(["bold", "dim", "italic", "underline", "inverse", "strikethrough", "black", "red", "green", "yellow", "blue", "magenta", "cyan", "white", "gray", "grey", "blackBright", "redBright", "greenBright", "yellowBright", "blueBright", "magentaBright", "cyanBright", "whiteBright"]);
 var MAX_FILE_BYTES = 64 * 1024;
 var warned = new Set;
 
 // ../kit/src/style.ts
-function takesControlCodes(stream, env = process2.env) {
-  return stream.isTTY === true && env.NO_COLOR === undefined && env.NODE_DISABLE_COLORS === undefined && env.TERM !== "dumb";
+function takesControlCodes(stream, env = process4.env) {
+  return stream.isTTY === true && env.NO_COLOR === undefined && env.NODE_DISABLE_COLORS === undefined && env.TERM !== "dumb" && outputMode(stream, env) === "terminal";
 }
-function paint(stream, env = process2.env) {
+function paint(stream, env = process4.env) {
   return le({ stream: { isTTY: takesControlCodes(stream, env) }, env });
 }
 var STATUS_WORDS = {
   passed: ["passed", "success", "succeeded", "ok"],
   failed: ["failed", "failure", "error", "errored"],
-  running: ["running", "in_progress", "started"],
+  running: ["running", "in_progress", "started", "holding"],
   queued: ["queued", "waiting", "pending", "created", "blocked", "scheduled"],
   skipped: ["skipped", "cancelled", "canceled", "manual"]
 };
@@ -308,8 +341,11 @@ var ESCAPE = String.fromCharCode(27);
 function textWidth(text) {
   return Bun.stringWidth(text);
 }
-function table(rows, { cellWidth, header = false, align = [], fit, stream = process3.stdout } = {}) {
+function table(rows, { cellWidth, header = false, align = [], fit, stream = process5.stdout, env = process5.env } = {}) {
   const cells = cellWidth === undefined ? rows : rows.map((row) => row.map((cell) => truncate(cell.replaceAll(LINE_BREAKS, " "), cellWidth)));
+  if (outputMode(stream, env) === "agent")
+    return cells.map((row) => row.map((cell) => Bun.stripANSI(cell).replaceAll(/[\t\r\n]+/g, " ")).join("\t")).join(`
+`);
   const widths = [];
   for (const row of cells) {
     for (const [index, cell] of row.entries())
@@ -344,32 +380,35 @@ function narrow(rows, widths, limit) {
   }
   return rows.map((row) => row.map((cell, index) => textWidth(cell) > (widths[index] ?? 0) ? truncate(cell, widths[index] ?? 0) : cell));
 }
+function jsonText(value, replacer, { stream = process5.stdout, env = process5.env } = {}) {
+  return JSON.stringify(value, replacer, outputMode(stream, env) === "agent" ? undefined : 2);
+}
 function printJson(value) {
-  console.log(JSON.stringify(value, undefined, 2));
+  console.log(jsonText(value));
 }
 
 // ../kit/src/help.ts
-import process4 from "process";
+import process6 from "process";
 var OPTIONAL = /\[[^\]]+\]/g;
 var USAGE_PREFIX = /^usage:\s*/i;
 var FULL_STOP = /\.$/;
-function usageLine(usage, colors = paint(process4.stdout)) {
+function usageLine(usage, colors = paint(process6.stdout)) {
   return `${colors.bold("Usage:")} ${usage.replace(USAGE_PREFIX, "").replaceAll(OPTIONAL, (part) => colors.dim(part))}`;
 }
-function helpText(usage, options, colors = paint(process4.stdout), { examples = [], replaces, exits = [] } = {}) {
+function helpText(usage, options, colors = paint(process6.stdout), { examples = [], replaces, exits = [] } = {}) {
   return [usageLine(usage, colors), ...replacesRows(replaces, colors), "", colors.bold("Options:"), ...optionRows(options, colors), ...exitRows(exits, colors), ...exampleRows(examples, colors)].join(`
 `);
 }
-function exitRows(exits, colors = paint(process4.stdout)) {
+function exitRows(exits, colors = paint(process6.stdout)) {
   if (exits.length === 0)
     return [];
   const width = Math.max(...exits.map(([code]) => String(code).length));
   return ["", colors.bold("Exits:"), ...exits.map(([code, meaning]) => `  ${colors.cyan(String(code).padEnd(width))}  ${meaning}`)];
 }
-function replacesRows(replaces, colors = paint(process4.stdout)) {
-  return replaces === undefined ? [] : ["", `${colors.bold("Instead of:")} ${replaces}`];
+function replacesRows(replaces, colors = paint(process6.stdout)) {
+  return replaces === undefined || outputMode() === "agent" ? [] : ["", `${colors.bold("Instead of:")} ${replaces}`];
 }
-function wantsHelpJson(env = process4.env) {
+function wantsHelpJson(env = process6.env) {
   return env.KIT_HELP === "json";
 }
 function description(usage, { examples = [], replaces, exits } = {}, options) {
@@ -388,12 +427,12 @@ function description(usage, { examples = [], replaces, exits } = {}, options) {
     ...options === undefined ? {} : { options: Object.entries(options).map(([name, { short, description }]) => ({ name, ...short === undefined ? {} : { short }, ...description === undefined ? {} : { description } })) }
   };
 }
-function exampleRows(examples, colors = paint(process4.stdout)) {
-  if (examples.length === 0)
+function exampleRows(examples, colors = paint(process6.stdout)) {
+  if (examples.length === 0 || outputMode() === "agent")
     return [];
   return ["", colors.bold("Examples:"), ...examples.map((example) => typeof example === "string" ? `  ${example}` : `  ${example[0]}  ${colors.dim(`# ${example[1]}`)}`)];
 }
-function optionRows(options, colors = paint(process4.stdout)) {
+function optionRows(options, colors = paint(process6.stdout)) {
   const rows = Object.entries(options).map(([name, option]) => {
     const short = option.short === undefined ? "    " : `${colors.cyan(`-${option.short}`)}, `;
     const named = option.choices === undefined ? "<value>" : `<${option.choices.join("|")}>`;
@@ -486,7 +525,7 @@ var OUTPUT_OPTIONS = {
   color: { type: "string", description: "auto (on a terminal alone), always or never" },
   plain: { type: "boolean", description: "plain text, no colour or spinner: --color never" }
 };
-function applyOutput(color, plain, env = process5.env) {
+function applyOutput(color, plain, env = process7.env) {
   const when = plain === true ? "never" : color ?? "auto";
   if (when === "auto")
     return;
@@ -657,7 +696,7 @@ function nearestOption(message, options, allowNegative) {
 }
 // ../kit/src/process.ts
 import { constants } from "os";
-import process6 from "process";
+import process8 from "process";
 var KILL_GRACE_MS = 2000;
 function exitCodeOf(code, signal) {
   if (code !== null)
@@ -677,7 +716,7 @@ async function runCommand(argv, { cwd, env, stdin = "ignore", timeoutMs, signal,
       return;
     try {
       if (grouped)
-        process6.kill(-proc.pid, killing);
+        process8.kill(-proc.pid, killing);
       else
         proc.kill(killing);
     } catch {}
@@ -752,14 +791,14 @@ var RESET_STYLE = `${ESC}[0m`;
 var CLOSE_LINK = `${ESC}]8;;${ESC}\\`;
 // ../kit/src/cli.ts
 import { readFileSync, realpathSync } from "fs";
-import { dirname as dirname2, join as join2 } from "path";
-import process8 from "process";
+import { dirname as dirname2, join as join3 } from "path";
+import process10 from "process";
 
 // ../kit/src/usage.ts
 import { appendFileSync, mkdirSync } from "fs";
-import { homedir } from "os";
-import { dirname, isAbsolute, join } from "path";
-import process7 from "process";
+import { homedir as homedir2 } from "os";
+import { dirname, isAbsolute, join as join2 } from "path";
+import process9 from "process";
 
 // ../kit/src/logs.ts
 var DAY_MS = 24 * 60 * 60 * 1000;
@@ -773,14 +812,14 @@ var usageError;
 function noteUsageError(message) {
   usageError = message;
 }
-function stateHome(env = process7.env) {
+function stateHome(env = process9.env) {
   const dir = env.XDG_STATE_HOME;
-  return dir !== undefined && isAbsolute(dir) ? dir : join(homedir(), ".local", "state");
+  return dir !== undefined && isAbsolute(dir) ? dir : join2(homedir2(), ".local", "state");
 }
-function usagePath(env = process7.env) {
-  return join(stateHome(env), CLI_FOLDER, "usage.jsonl");
+function usagePath(env = process9.env) {
+  return join2(stateHome(env), CLI_FOLDER, "usage.jsonl");
 }
-function usageRecorded(env = process7.env) {
+function usageRecorded(env = process9.env) {
   const off = env.KAYNOOO_CLI_NO_USAGE;
   return env.NODE_ENV !== "test" && (off === undefined || off === "" || off === "0");
 }
@@ -794,7 +833,7 @@ function usageEntry(bin, command, argv, code, now = new Date) {
   usageError = undefined;
   return { at: now.toISOString(), bin, ...command === undefined ? {} : { command }, flags: flagNames(argv), code, ...unknown === undefined ? {} : { unknown } };
 }
-function recordUsage(entry, env = process7.env) {
+function recordUsage(entry, env = process9.env) {
   if (!usageRecorded(env))
     return;
   try {
@@ -933,8 +972,8 @@ async function help2({ path, header, summary: lazySummary, commands, defaultComm
 `);
 }
 function printError(prefix, message, hint, cause) {
-  const colors = paint(process8.stderr);
-  const styled = takesControlCodes(process8.stderr);
+  const colors = paint(process10.stderr);
+  const styled = takesControlCodes(process10.stderr);
   const head = styled ? `${colors.red.bold("error")} ${colors.dim(`${prefix}:`)}` : `error: ${prefix}:`;
   const under = (label, text, tint) => text === undefined ? "" : `
   ${styled ? tint(label) : `${label}:`} ${text}`;
@@ -977,11 +1016,11 @@ async function dispatch(level, typed, { version, redact }) {
     }
   }
   if (name === undefined && level.path.length > 1) {
-    console.error(await help2(await expand(level, [...level.path.slice(1), ...argv]), process8.stderr));
+    console.error(await help2(await expand(level, [...level.path.slice(1), ...argv]), process10.stderr));
     return 2;
   }
   if (name === undefined || name === "help" || name === "--help" || name === "-h") {
-    console.log(await help2(await expand(level, [...level.path.slice(1), ...argv]), process8.stdout));
+    console.log(await help2(await expand(level, [...level.path.slice(1), ...argv]), process10.stdout));
     return 0;
   }
   if (level.path.length === 1 && (name === "--version" || name === "-v")) {
@@ -1100,7 +1139,7 @@ async function printCandidates(found) {
 function packageVersion(entry = Bun.main) {
   for (let dir = dirname2(realpathSync(entry));; dir = dirname2(dir)) {
     try {
-      const { version } = JSON.parse(readFileSync(join2(dir, "package.json"), "utf8"));
+      const { version } = JSON.parse(readFileSync(join3(dir, "package.json"), "utf8"));
       if (typeof version === "string")
         return version;
     } catch {}
@@ -1108,7 +1147,7 @@ function packageVersion(entry = Bun.main) {
       return "0.0.0";
   }
 }
-async function runCli(cli, argv = process8.argv.slice(2)) {
+async function runCli(cli, argv = process10.argv.slice(2)) {
   const version = cli.version ?? packageVersion();
   if (argv[0] === COMPLETE)
     return printCandidates(candidates(scopeOf(cli.commands, cli.extraCommands, cli.aliases), cli.defaultCommand, argv.slice(1)));
@@ -1135,7 +1174,7 @@ function commandPath(scope, argv) {
   }
   return path.length === 0 ? undefined : path.join(" ");
 }
-async function runMain({ name, version, run, redact, usage }, argv = process8.argv.slice(2)) {
+async function runMain({ name, version, run, redact, usage }, argv = process10.argv.slice(2)) {
   if (argv[0] === COMPLETE)
     return printCandidates(leafCandidates(run, argv.slice(1)));
   if (argv.length === 1 && (argv[0] === "--version" || argv[0] === "-v")) {
@@ -1161,14 +1200,61 @@ var SECRET_WORDS = new Set(["key", "pass", "pwd", "auth", "salt", "cookie", "ses
 var {Glob } = globalThis.Bun;
 var SESSION_FILES = new Glob("*.json");
 var ACCOUNT_DIRS = new Glob("*/sessions");
+// ../kit/src/workspace-root.ts
+import { existsSync, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { homedir as homedir3 } from "os";
+import { dirname as dirname3, join as join4, resolve } from "path";
+import process11 from "process";
+function expandHome(path, home) {
+  if (path === "~")
+    return home;
+  return path.startsWith("~/") ? join4(home, path.slice(2)) : path;
+}
+function configured(env, home) {
+  const path = userConfigPath("config", { home, xdg: env.XDG_CONFIG_HOME });
+  if (!existsSync(path))
+    return;
+  try {
+    const parsed = JSON.parse(readFileSync2(path, "utf8"));
+    const folder = typeof parsed === "object" && parsed !== null ? parsed.workspace : undefined;
+    return typeof folder === "string" && folder !== "" ? folder : undefined;
+  } catch {
+    return;
+  }
+}
+function workspaceRoot({ given, env = process11.env, home = homedir3() } = {}) {
+  const fromEnv = env.KAYNOOO_WORKSPACE === "" ? undefined : env.KAYNOOO_WORKSPACE;
+  return resolve(expandHome(given ?? fromEnv ?? configured(env, home) ?? join4(home, "Workspace"), home));
+}
+function workspaceChosen({ env = process11.env, home = homedir3() } = {}) {
+  return (env.KAYNOOO_WORKSPACE ?? "") !== "" || configured(env, home) !== undefined;
+}
+function saveWorkspace(folder, { env = process11.env, home = homedir3() } = {}) {
+  const path = userConfigPath("config", { home, xdg: env.XDG_CONFIG_HOME });
+  let current = {};
+  if (existsSync(path)) {
+    try {
+      const parsed = JSON.parse(readFileSync2(path, "utf8"));
+      if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+        return false;
+      current = parsed;
+    } catch {
+      return false;
+    }
+  }
+  mkdirSync2(dirname3(path), { recursive: true });
+  writeFileSync(path, `${JSON.stringify({ ...current, workspace: folder }, undefined, 2)}
+`);
+  return true;
+}
 // src/completions.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync3, rmSync } from "fs";
-import { join as join4 } from "path";
-import process10 from "process";
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readdirSync, readFileSync as readFileSync4, rmSync } from "fs";
+import { join as join6 } from "path";
+import process13 from "process";
 
 // src/checks.ts
-import { existsSync, readFileSync as readFileSync2 } from "fs";
-import { basename, join as join3 } from "path";
+import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
+import { basename, join as join5 } from "path";
 
 // src/catalog.ts
 var HOOKS_REQUIRES = "@kaynooo/cli-guard";
@@ -1244,7 +1330,7 @@ function readJsonText(text) {
   }
 }
 function readJson(path) {
-  return existsSync(path) ? readJsonText(readFileSync2(path, "utf8")) : undefined;
+  return existsSync2(path) ? readJsonText(readFileSync3(path, "utf8")) : undefined;
 }
 function firstLine(text) {
   const trimmed = text.trim();
@@ -1253,7 +1339,7 @@ function firstLine(text) {
   return end === -1 ? trimmed : trimmed.slice(0, end);
 }
 function installed(host, name) {
-  return readJson(join3(host.globalModules, name, "package.json"));
+  return readJson(join5(host.globalModules, name, "package.json"));
 }
 function isInstalled(host, name) {
   return installed(host, name)?.version !== undefined;
@@ -1261,7 +1347,7 @@ function isInstalled(host, name) {
 function ownBin(host, name, bin) {
   const declared = installed(host, name)?.bin;
   const file = typeof declared === "string" ? declared : declared?.[bin];
-  return file === undefined ? undefined : join3(host.globalModules, name, file);
+  return file === undefined ? undefined : join5(host.globalModules, name, file);
 }
 async function checkTool(host, name, bins) {
   const check = name.slice(name.indexOf("/") + 1);
@@ -1276,7 +1362,7 @@ async function checkTool(host, name, bins) {
   if (latest !== "" && Bun.semver.order(version, latest) < 0)
     return { check, ok: false, detail: `${version}, ${latest} released${off.length > 0 ? `, ${off.join(", ")} not on the PATH` : ""}`, fix: `bun install -g ${name}@${latest}` };
   if (off.length > 0)
-    return { check, ok: false, detail: `${version}, ${off.join(", ")} not on the PATH`, fix: `add ${join3(host.globalModules, "..", "..", "..", "bin")} to the PATH` };
+    return { check, ok: false, detail: `${version}, ${off.join(", ")} not on the PATH`, fix: `add ${join5(host.globalModules, "..", "..", "..", "bin")} to the PATH` };
   if (latest === "")
     return { check, ok: true, detail: `${version}, the registry did not answer: ${firstLine(info.stderr) || answered || "no version"}` };
   return { check, ok: true, detail: version };
@@ -1297,9 +1383,9 @@ async function checkTea(host) {
   return { check: "tea", ok: true, detail: `logged in to ${forge} as ${login.name}, Forgejo ${served}` };
 }
 function hooksWiring(host) {
-  const settings = readJson(join3(host.home, ".claude", "settings.json")) ?? {};
+  const settings = readJson(join5(host.home, ".claude", "settings.json")) ?? {};
   const plugin = settings.enabledPlugins?.[PLUGIN] === true;
-  const mod = (settings.env?.CLAUDE_CODE_PLUGIN_DIRS ?? "").split(":").map((dir) => dir.replace(LEADING_TILDE, host.home)).find((dir) => basename(dir) === "cli" && existsSync(join3(dir, "hooks", "hooks.json")));
+  const mod = (settings.env?.CLAUDE_CODE_PLUGIN_DIRS ?? "").split(":").map((dir) => dir.replace(LEADING_TILDE, host.home)).find((dir) => basename(dir) === "cli" && existsSync2(join5(dir, "hooks", "hooks.json")));
   return { plugin, mod };
 }
 function checkHooks(host) {
@@ -1337,8 +1423,15 @@ function checkNeeds(host) {
   return { check: "needs", ok: true, detail: "every tool the installed packages need is on the PATH" };
 }
 var toolCheck = (name) => name.slice(name.indexOf("/") + 1);
-var OTHER_CHECKS = ["tea", "hooks", "needs", "bun", "completions"];
+var OTHER_CHECKS = ["tea", "hooks", "needs", "bun", "completions", "workspace"];
 var FORGEJO = "@kaynooo/cli-forgejo";
+var WORKSPACE = "@kaynooo/cli-workspace";
+function checkWorkspace(host, env = process.env) {
+  const folder = workspaceRoot({ home: host.home, env });
+  if (existsSync2(folder))
+    return { check: "workspace", ok: true, detail: folder };
+  return { check: "workspace", ok: false, detail: `${folder} does not exist`, fix: `mkdir -p ${folder}, or set "workspace" in ~/.config/kaynooo-cli/config.json to your folder` };
+}
 var CHECK_NAMES = [...Object.keys(TOOLS).map(toolCheck), ...OTHER_CHECKS];
 async function runChecks(host, only = []) {
   const wanted = (check) => only.length === 0 || only.includes(check);
@@ -1354,7 +1447,8 @@ async function runChecks(host, only = []) {
     ...wanted("hooks") && hooks ? [checkHooks(host)] : [],
     ...wanted("needs") ? [checkNeeds(host)] : [],
     ...wanted("bun") ? [checkBun(host)] : [],
-    ...wanted("completions") ? [checkCompletions(host)] : []
+    ...wanted("completions") ? [checkCompletions(host)] : [],
+    ...wanted("workspace") && (only.length > 0 || isInstalled(host, WORKSPACE) || isInstalled(host, "@kaynooo/cli-pkg")) ? [checkWorkspace(host)] : []
   ];
 }
 
@@ -1392,8 +1486,8 @@ ${BASH_FUNCTION}
 complete -F __kaynooo_cli_complete ${bins.join(" ")}
 `;
 }
-function completionDir(home, env = process10.env) {
-  return join4(env.XDG_CACHE_HOME ?? join4(home, ".cache"), "fish", "kaynooo-cli");
+function completionDir(home, env = process13.env) {
+  return join6(env.XDG_CACHE_HOME ?? join6(home, ".cache"), "fish", "kaynooo-cli");
 }
 function installedBins(host) {
   return Object.values(TOOLS).flat().filter((bin) => host.which(bin) !== null);
@@ -1406,19 +1500,19 @@ complete -c ${bin} -f -a '(__kaynooo_cli_complete ${bin})'
 }
 async function installCompletions(host, dir) {
   const bins = installedBins(host);
-  mkdirSync2(dir, { recursive: true });
-  const removed = readdirSync(dir).filter((name) => FISH_FILE.test(name) && !bins.includes(name.replace(FISH_FILE, "")) && readFileSync3(join4(dir, name), "utf8").startsWith(MARKER));
+  mkdirSync3(dir, { recursive: true });
+  const removed = readdirSync(dir).filter((name) => FISH_FILE.test(name) && !bins.includes(name.replace(FISH_FILE, "")) && readFileSync4(join6(dir, name), "utf8").startsWith(MARKER));
   for (const name of removed)
-    rmSync(join4(dir, name));
-  await Promise.all(bins.map(async (bin) => Bun.write(join4(dir, `${bin}.fish`), completionFile(bin))));
+    rmSync(join6(dir, name));
+  await Promise.all(bins.map(async (bin) => Bun.write(join6(dir, `${bin}.fish`), completionFile(bin))));
   return { written: bins, removed: removed.map((name) => name.replace(FISH_FILE, "")) };
 }
 function missingCompletions(host, dir) {
-  return installedBins(host).filter((bin) => !existsSync2(join4(dir, `${bin}.fish`)));
+  return installedBins(host).filter((bin) => !existsSync3(join6(dir, `${bin}.fish`)));
 }
 
 // src/doctor.ts
-import process14 from "process";
+import process17 from "process";
 
 // src/fix.ts
 var INSTALL = /^bun install -g (\S+)$/;
@@ -1458,19 +1552,19 @@ async function applyFixes(host, steps, dry) {
 }
 
 // src/host.ts
-import { homedir as homedir2 } from "os";
-import { join as join5 } from "path";
-import process11 from "process";
+import { homedir as homedir4 } from "os";
+import { join as join7 } from "path";
+import process14 from "process";
 var RUN_TIMEOUT_MS = 20000;
 function hostHere() {
-  const home = homedir2();
+  const home = homedir4();
   return {
     home,
-    globalModules: join5(process11.env.BUN_INSTALL ?? join5(home, ".bun"), "install", "global", "node_modules"),
+    globalModules: join7(process14.env.BUN_INSTALL ?? join7(home, ".bun"), "install", "global", "node_modules"),
     bunVersion: Bun.version,
     which: (bin) => Bun.which(bin),
     run: async (argv, env) => {
-      const ran = await runCommand(argv, { timeoutMs: RUN_TIMEOUT_MS, ...env === undefined ? {} : { env: { ...process11.env, ...env } } });
+      const ran = await runCommand(argv, { timeoutMs: RUN_TIMEOUT_MS, ...env === undefined ? {} : { env: { ...process14.env, ...env } } });
       if (ran.timedOut)
         return { code: 1, stdout: "", stderr: `timed out after ${RUN_TIMEOUT_MS / 1000}s` };
       const of = (stream) => Buffer.concat(ran.chunks.filter((chunk) => chunk.stream === stream).map((chunk) => chunk.data)).toString();
@@ -1480,10 +1574,10 @@ function hostHere() {
 }
 
 // src/install.ts
-import process13 from "process";
+import process16 from "process";
 
 // ../kit/src/prompt.ts
-import process12 from "process";
+import process15 from "process";
 var KEY_SEQUENCES = /\x1B\[[0-9;]*[A-Z~]|\x1BO[A-Z]|[\s\S]/giu;
 var CONTROL = /^[\x00-\x1F\x7F]/;
 var WORDS = /\s+/;
@@ -1521,6 +1615,36 @@ async function checklist(question, choices, { initial = new Set, min = 0, toggle
   });
   return accepted ? checked : undefined;
 }
+async function input2(question, { default: fallback, mask = false, validate, ...settings } = {}) {
+  let value = "";
+  let invalid;
+  const taken = () => value === "" ? fallback ?? "" : value;
+  const shown = () => mask ? "*".repeat([...taken()].length) : taken();
+  const accepted = await ask(question, settings, (colors, state, { columns }) => {
+    if (state !== "asking")
+      return [answer(colors, question, state, shown())];
+    const characters = [...shown()];
+    const room = Math.max(columns - question.length - 5, 1);
+    const tail = characters.length > room ? `\u2026${characters.slice(1 - room).join("")}` : shown();
+    const typed = value === "" ? colors.dim(tail) : tail;
+    return [`${colors.cyan("?")} ${question} ${typed}${colors.dim("\u2588")}`, ...invalid === undefined ? [] : [`  ${colors.red(invalid)}`]];
+  }, (key) => {
+    if (key === "cancel")
+      return "cancel";
+    invalid = undefined;
+    if (key === "enter") {
+      invalid = validate?.(taken());
+      return invalid === undefined ? "enter" : undefined;
+    }
+    if (key === "erase")
+      value = [...value].slice(0, -1).join("");
+    else if (typeof key === "object")
+      value += key.text;
+    return;
+  });
+  return accepted ? taken() : undefined;
+}
+
 class List {
   choices;
   query = "";
@@ -1579,9 +1703,9 @@ function asking(colors, question, typed, keys) {
 function answer(colors, question, state, picked) {
   return state === "enter" ? `${colors.green("\u2713")} ${question} ${colors.cyan(picked)}` : `${colors.red("\u2717")} ${question} ${colors.dim("cancelled")}`;
 }
-async function ask(question, { hint, terminal = process12 }, render, press) {
+async function ask(question, { hint, terminal = process15 }, render, press) {
   const { stdin, stderr } = terminal;
-  if (stdin.isTTY !== true || stderr.isTTY !== true)
+  if (!isInteractive(terminal))
     fail(`cannot ask "${question}" off a terminal`, 2, hint);
   const colors = paint(stderr);
   let drawn = 0;
@@ -1680,15 +1804,22 @@ function checksFor(packages, plugin) {
   return [...packages.map((name) => name.slice(name.indexOf("/") + 1)), ...plugin ? ["hooks"] : [], "needs", "completions", ...packages.includes("@kaynooo/cli-forgejo") ? ["tea"] : []];
 }
 async function ask2(pool) {
-  if (process13.stdin.isTTY !== true || process13.stderr.isTTY !== true)
+  if (!isInteractive())
     badUsage("name what to install, or all: doctor --install forgejo check hooks (doctor --install --list shows the choices)");
   const choices = pool.map((each) => ({ value: each, label: each.label, hint: each.hint }));
   const picked = await checklist("install which?", choices, { hint: "name them instead: doctor --install forgejo check" });
   return picked === undefined ? [] : [...picked];
 }
+async function askWorkspace(host) {
+  if (!isInteractive() || workspaceChosen({ home: host.home }))
+    return;
+  const folder = await input2("folder holding your repositories (repos, sweep and pkg bump look there)", { default: "~/Workspace" });
+  if (folder !== undefined && folder !== "" && !saveWorkspace(folder, { home: host.home }))
+    console.error(`could not write the workspace into ${userConfigPath("config", { home: host.home })}: it does not parse, fix it by hand`);
+}
 async function install(host, options, recheck) {
   const pool = candidates2(host);
-  const { dim, green, red, yellow } = paint(process13.stdout);
+  const { dim, green, red, yellow } = paint(process16.stdout);
   if (options.list) {
     for (const each of pool)
       console.log(`${each.label.padEnd(12)} ${dim(each.hint)}`);
@@ -1719,6 +1850,8 @@ async function install(host, options, recheck) {
     console.log(`${yellow("warn   ")}  ${each.package}: ${each.need} is missing, ${each.why}`);
   if (planned.packages.length === 0 && !planned.plugin)
     return 1;
+  if (!options.dryRun && planned.packages.some((name) => name === "@kaynooo/cli-workspace" || name === "@kaynooo/cli-pkg"))
+    await askWorkspace(host);
   const command = ["bun", "install", "-g", ...planned.packages];
   if (planned.packages.length > 0)
     console.log(`${options.dryRun ? dim("would  ") : green("install")}  ${command.join(" ")}`);
@@ -1775,7 +1908,7 @@ var OPTIONS = {
 function print(results) {
   if (results.length === 0)
     return;
-  const { green, red, dim } = paint(process14.stdout);
+  const { green, red, dim } = paint(process17.stdout);
   const width = Math.max(...results.map((result) => result.check.length));
   for (const { check, ok, detail, fix } of results)
     console.log(`${ok ? green("ok  ") : red("FAIL")}  ${check.padEnd(width)}  ${detail}${fix === undefined ? "" : `  ${dim("fix:")} ${fix}`}`);
@@ -1785,7 +1918,7 @@ function print(results) {
 ${dim("fix them all:")} ${INSTALL2}${installs.join(" ")}`);
 }
 function printOutcomes(outcomes, log) {
-  const { green, red, dim } = paint(process14.stdout);
+  const { green, red, dim } = paint(process17.stdout);
   const marks = { ran: green("ran    "), failed: red("failed "), "dry-run": dim("would  "), "not run": dim("not run") };
   for (const { command, status, detail } of outcomes)
     log(`${marks[status]}  ${command}${detail === undefined ? "" : `  ${dim(detail)}`}`);
@@ -1825,7 +1958,7 @@ after the fixes:`);
   const absent = Object.keys(TOOLS).filter((name) => !isInstalled(host, name)).length;
   if (!json && only.length === 0 && absent > 0)
     console.log(`
-${paint(process14.stdout).dim(`${absent} packages not installed: doctor --install`)}`);
+${paint(process17.stdout).dim(`${absent} packages not installed: doctor --install`)}`);
   return results.every((result) => result.ok) ? 0 : 1;
 }
 
@@ -1854,7 +1987,7 @@ var LIST_OPTIONS = {
   json: jsonOption("[{bin, package, installed, synopsis?, summary?, replaces?, examples?}]")
 };
 function print2(listed) {
-  const { cyan, dim } = paint(process15.stdout);
+  const { cyan, dim } = paint(process18.stdout);
   const width = Math.max(...listed.map((each) => each.bin.length));
   for (const each of listed) {
     const what = !each.installed ? dim(`not installed: bun install -g ${each.package}`) : `${each.summary ?? ""}${each.replaces === undefined ? "" : dim(`; instead of ${each.replaces}`)}`;
@@ -1937,7 +2070,7 @@ ${table(summary.usageErrors.map((each) => [`${each.bin}${each.command === undefi
   return 0;
 }
 if (import.meta.main) {
-  process15.exitCode = await runCli({
+  process18.exitCode = await runCli({
     name: "cli",
     about: "the bins of the @kaynooo/cli-* packages, described by their own help",
     replaces: "running each bin's --help to find the one that fits",

package/dist/cli.js

@@ -2,16 +2,37 @@
 // @bun
 
 // src/cli.ts
-import process15 from "process";
+import process18 from "process";
 // ../kit/src/args.ts
-import process5 from "process";
+import process7 from "process";
 import { parseArgs } from "util";
 
 // ../kit/src/format.ts
-import process3 from "process";
+import process5 from "process";
 
-// ../kit/src/style.ts
+// ../kit/src/mode.ts
 import process2 from "process";
+var MODES = new Set(["terminal", "ci", "agent", "pipe"]);
+var AGENT_VARIABLES = ["CLAUDECODE", "AI_AGENT"];
+function isSet(value) {
+  return value !== undefined && value !== "" && value !== "0" && value.toLowerCase() !== "false";
+}
+function outputMode(stream = process2.stdout, env = process2.env) {
+  const chosen = env.KIT_MODE;
+  if (chosen !== undefined && MODES.has(chosen))
+    return chosen;
+  if (AGENT_VARIABLES.some((name) => isSet(env[name])))
+    return "agent";
+  if (stream.isTTY === true)
+    return "terminal";
+  return isSet(env.CI) ? "ci" : "pipe";
+}
+function isInteractive(streams = process2) {
+  return streams.stdin?.isTTY === true && streams.stderr?.isTTY === true;
+}
+
+// ../kit/src/style.ts
+import process4 from "process";
 
 // ../../node_modules/.bun/@kaynooo+utils@2.31.2+d0769e28dc4dad16/node_modules/@kaynooo/utils/dist/chunk-mtetydvc.js
 function x(s) {
@@ -274,22 +295,34 @@ function le(i = {}) {
 }
 var t = le();
 
+// ../kit/src/user-config.ts
+import { homedir } from "os";
+import { join } from "path";
+import process3 from "process";
+function configBase(where = {}) {
+  const xdg = where.xdg ?? (where.home === undefined ? process3.env.XDG_CONFIG_HOME : undefined);
+  return xdg !== undefined && xdg !== "" ? xdg : join(where.home ?? homedir(), ".config");
+}
+function userConfigPath(bin, where = {}) {
+  return join(configBase(where), "kaynooo-cli", `${bin}.json`);
+}
+
 // ../kit/src/theme.ts
 var STYLES = new Set(["bold", "dim", "italic", "underline", "inverse", "strikethrough", "black", "red", "green", "yellow", "blue", "magenta", "cyan", "white", "gray", "grey", "blackBright", "redBright", "greenBright", "yellowBright", "blueBright", "magentaBright", "cyanBright", "whiteBright"]);
 var MAX_FILE_BYTES = 64 * 1024;
 var warned = new Set;
 
 // ../kit/src/style.ts
-function takesControlCodes(stream, env = process2.env) {
-  return stream.isTTY === true && env.NO_COLOR === undefined && env.NODE_DISABLE_COLORS === undefined && env.TERM !== "dumb";
+function takesControlCodes(stream, env = process4.env) {
+  return stream.isTTY === true && env.NO_COLOR === undefined && env.NODE_DISABLE_COLORS === undefined && env.TERM !== "dumb" && outputMode(stream, env) === "terminal";
 }
-function paint(stream, env = process2.env) {
+function paint(stream, env = process4.env) {
   return le({ stream: { isTTY: takesControlCodes(stream, env) }, env });
 }
 var STATUS_WORDS = {
   passed: ["passed", "success", "succeeded", "ok"],
   failed: ["failed", "failure", "error", "errored"],
-  running: ["running", "in_progress", "started"],
+  running: ["running", "in_progress", "started", "holding"],
   queued: ["queued", "waiting", "pending", "created", "blocked", "scheduled"],
   skipped: ["skipped", "cancelled", "canceled", "manual"]
 };
@@ -308,8 +341,11 @@ var ESCAPE = String.fromCharCode(27);
 function textWidth(text) {
   return Bun.stringWidth(text);
 }
-function table(rows, { cellWidth, header = false, align = [], fit, stream = process3.stdout } = {}) {
+function table(rows, { cellWidth, header = false, align = [], fit, stream = process5.stdout, env = process5.env } = {}) {
   const cells = cellWidth === undefined ? rows : rows.map((row) => row.map((cell) => truncate(cell.replaceAll(LINE_BREAKS, " "), cellWidth)));
+  if (outputMode(stream, env) === "agent")
+    return cells.map((row) => row.map((cell) => Bun.stripANSI(cell).replaceAll(/[\t\r\n]+/g, " ")).join("\t")).join(`
+`);
   const widths = [];
   for (const row of cells) {
     for (const [index, cell] of row.entries())
@@ -344,32 +380,35 @@ function narrow(rows, widths, limit) {
   }
   return rows.map((row) => row.map((cell, index) => textWidth(cell) > (widths[index] ?? 0) ? truncate(cell, widths[index] ?? 0) : cell));
 }
+function jsonText(value, replacer, { stream = process5.stdout, env = process5.env } = {}) {
+  return JSON.stringify(value, replacer, outputMode(stream, env) === "agent" ? undefined : 2);
+}
 function printJson(value) {
-  console.log(JSON.stringify(value, undefined, 2));
+  console.log(jsonText(value));
 }
 
 // ../kit/src/help.ts
-import process4 from "process";
+import process6 from "process";
 var OPTIONAL = /\[[^\]]+\]/g;
 var USAGE_PREFIX = /^usage:\s*/i;
 var FULL_STOP = /\.$/;
-function usageLine(usage, colors = paint(process4.stdout)) {
+function usageLine(usage, colors = paint(process6.stdout)) {
   return `${colors.bold("Usage:")} ${usage.replace(USAGE_PREFIX, "").replaceAll(OPTIONAL, (part) => colors.dim(part))}`;
 }
-function helpText(usage, options, colors = paint(process4.stdout), { examples = [], replaces, exits = [] } = {}) {
+function helpText(usage, options, colors = paint(process6.stdout), { examples = [], replaces, exits = [] } = {}) {
   return [usageLine(usage, colors), ...replacesRows(replaces, colors), "", colors.bold("Options:"), ...optionRows(options, colors), ...exitRows(exits, colors), ...exampleRows(examples, colors)].join(`
 `);
 }
-function exitRows(exits, colors = paint(process4.stdout)) {
+function exitRows(exits, colors = paint(process6.stdout)) {
   if (exits.length === 0)
     return [];
   const width = Math.max(...exits.map(([code]) => String(code).length));
   return ["", colors.bold("Exits:"), ...exits.map(([code, meaning]) => `  ${colors.cyan(String(code).padEnd(width))}  ${meaning}`)];
 }
-function replacesRows(replaces, colors = paint(process4.stdout)) {
-  return replaces === undefined ? [] : ["", `${colors.bold("Instead of:")} ${replaces}`];
+function replacesRows(replaces, colors = paint(process6.stdout)) {
+  return replaces === undefined || outputMode() === "agent" ? [] : ["", `${colors.bold("Instead of:")} ${replaces}`];
 }
-function wantsHelpJson(env = process4.env) {
+function wantsHelpJson(env = process6.env) {
   return env.KIT_HELP === "json";
 }
 function description(usage, { examples = [], replaces, exits } = {}, options) {
@@ -388,12 +427,12 @@ function description(usage, { examples = [], replaces, exits } = {}, options) {
     ...options === undefined ? {} : { options: Object.entries(options).map(([name, { short, description }]) => ({ name, ...short === undefined ? {} : { short }, ...description === undefined ? {} : { description } })) }
   };
 }
-function exampleRows(examples, colors = paint(process4.stdout)) {
-  if (examples.length === 0)
+function exampleRows(examples, colors = paint(process6.stdout)) {
+  if (examples.length === 0 || outputMode() === "agent")
     return [];
   return ["", colors.bold("Examples:"), ...examples.map((example) => typeof example === "string" ? `  ${example}` : `  ${example[0]}  ${colors.dim(`# ${example[1]}`)}`)];
 }
-function optionRows(options, colors = paint(process4.stdout)) {
+function optionRows(options, colors = paint(process6.stdout)) {
   const rows = Object.entries(options).map(([name, option]) => {
     const short = option.short === undefined ? "    " : `${colors.cyan(`-${option.short}`)}, `;
     const named = option.choices === undefined ? "<value>" : `<${option.choices.join("|")}>`;
@@ -486,7 +525,7 @@ var OUTPUT_OPTIONS = {
   color: { type: "string", description: "auto (on a terminal alone), always or never" },
   plain: { type: "boolean", description: "plain text, no colour or spinner: --color never" }
 };
-function applyOutput(color, plain, env = process5.env) {
+function applyOutput(color, plain, env = process7.env) {
   const when = plain === true ? "never" : color ?? "auto";
   if (when === "auto")
     return;
@@ -657,7 +696,7 @@ function nearestOption(message, options, allowNegative) {
 }
 // ../kit/src/process.ts
 import { constants } from "os";
-import process6 from "process";
+import process8 from "process";
 var KILL_GRACE_MS = 2000;
 function exitCodeOf(code, signal) {
   if (code !== null)
@@ -677,7 +716,7 @@ async function runCommand(argv, { cwd, env, stdin = "ignore", timeoutMs, signal,
       return;
     try {
       if (grouped)
-        process6.kill(-proc.pid, killing);
+        process8.kill(-proc.pid, killing);
       else
         proc.kill(killing);
     } catch {}
@@ -752,14 +791,14 @@ var RESET_STYLE = `${ESC}[0m`;
 var CLOSE_LINK = `${ESC}]8;;${ESC}\\`;
 // ../kit/src/cli.ts
 import { readFileSync, realpathSync } from "fs";
-import { dirname as dirname2, join as join2 } from "path";
-import process8 from "process";
+import { dirname as dirname2, join as join3 } from "path";
+import process10 from "process";
 
 // ../kit/src/usage.ts
 import { appendFileSync, mkdirSync } from "fs";
-import { homedir } from "os";
-import { dirname, isAbsolute, join } from "path";
-import process7 from "process";
+import { homedir as homedir2 } from "os";
+import { dirname, isAbsolute, join as join2 } from "path";
+import process9 from "process";
 
 // ../kit/src/logs.ts
 var DAY_MS = 24 * 60 * 60 * 1000;
@@ -773,14 +812,14 @@ var usageError;
 function noteUsageError(message) {
   usageError = message;
 }
-function stateHome(env = process7.env) {
+function stateHome(env = process9.env) {
   const dir = env.XDG_STATE_HOME;
-  return dir !== undefined && isAbsolute(dir) ? dir : join(homedir(), ".local", "state");
+  return dir !== undefined && isAbsolute(dir) ? dir : join2(homedir2(), ".local", "state");
 }
-function usagePath(env = process7.env) {
-  return join(stateHome(env), CLI_FOLDER, "usage.jsonl");
+function usagePath(env = process9.env) {
+  return join2(stateHome(env), CLI_FOLDER, "usage.jsonl");
 }
-function usageRecorded(env = process7.env) {
+function usageRecorded(env = process9.env) {
   const off = env.KAYNOOO_CLI_NO_USAGE;
   return env.NODE_ENV !== "test" && (off === undefined || off === "" || off === "0");
 }
@@ -794,7 +833,7 @@ function usageEntry(bin, command, argv, code, now = new Date) {
   usageError = undefined;
   return { at: now.toISOString(), bin, ...command === undefined ? {} : { command }, flags: flagNames(argv), code, ...unknown === undefined ? {} : { unknown } };
 }
-function recordUsage(entry, env = process7.env) {
+function recordUsage(entry, env = process9.env) {
   if (!usageRecorded(env))
     return;
   try {
@@ -933,8 +972,8 @@ async function help2({ path, header, summary: lazySummary, commands, defaultComm
 `);
 }
 function printError(prefix, message, hint, cause) {
-  const colors = paint(process8.stderr);
-  const styled = takesControlCodes(process8.stderr);
+  const colors = paint(process10.stderr);
+  const styled = takesControlCodes(process10.stderr);
   const head = styled ? `${colors.red.bold("error")} ${colors.dim(`${prefix}:`)}` : `error: ${prefix}:`;
   const under = (label, text, tint) => text === undefined ? "" : `
   ${styled ? tint(label) : `${label}:`} ${text}`;
@@ -977,11 +1016,11 @@ async function dispatch(level, typed, { version, redact }) {
     }
   }
   if (name === undefined && level.path.length > 1) {
-    console.error(await help2(await expand(level, [...level.path.slice(1), ...argv]), process8.stderr));
+    console.error(await help2(await expand(level, [...level.path.slice(1), ...argv]), process10.stderr));
     return 2;
   }
   if (name === undefined || name === "help" || name === "--help" || name === "-h") {
-    console.log(await help2(await expand(level, [...level.path.slice(1), ...argv]), process8.stdout));
+    console.log(await help2(await expand(level, [...level.path.slice(1), ...argv]), process10.stdout));
     return 0;
   }
   if (level.path.length === 1 && (name === "--version" || name === "-v")) {
@@ -1100,7 +1139,7 @@ async function printCandidates(found) {
 function packageVersion(entry = Bun.main) {
   for (let dir = dirname2(realpathSync(entry));; dir = dirname2(dir)) {
     try {
-      const { version } = JSON.parse(readFileSync(join2(dir, "package.json"), "utf8"));
+      const { version } = JSON.parse(readFileSync(join3(dir, "package.json"), "utf8"));
       if (typeof version === "string")
         return version;
     } catch {}
@@ -1108,7 +1147,7 @@ function packageVersion(entry = Bun.main) {
       return "0.0.0";
   }
 }
-async function runCli(cli, argv = process8.argv.slice(2)) {
+async function runCli(cli, argv = process10.argv.slice(2)) {
   const version = cli.version ?? packageVersion();
   if (argv[0] === COMPLETE)
     return printCandidates(candidates(scopeOf(cli.commands, cli.extraCommands, cli.aliases), cli.defaultCommand, argv.slice(1)));
@@ -1135,7 +1174,7 @@ function commandPath(scope, argv) {
   }
   return path.length === 0 ? undefined : path.join(" ");
 }
-async function runMain({ name, version, run, redact, usage }, argv = process8.argv.slice(2)) {
+async function runMain({ name, version, run, redact, usage }, argv = process10.argv.slice(2)) {
   if (argv[0] === COMPLETE)
     return printCandidates(leafCandidates(run, argv.slice(1)));
   if (argv.length === 1 && (argv[0] === "--version" || argv[0] === "-v")) {
@@ -1161,12 +1200,59 @@ var SECRET_WORDS = new Set(["key", "pass", "pwd", "auth", "salt", "cookie", "ses
 var {Glob } = globalThis.Bun;
 var SESSION_FILES = new Glob("*.json");
 var ACCOUNT_DIRS = new Glob("*/sessions");
+// ../kit/src/workspace-root.ts
+import { existsSync, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { homedir as homedir3 } from "os";
+import { dirname as dirname3, join as join4, resolve } from "path";
+import process11 from "process";
+function expandHome(path, home) {
+  if (path === "~")
+    return home;
+  return path.startsWith("~/") ? join4(home, path.slice(2)) : path;
+}
+function configured(env, home) {
+  const path = userConfigPath("config", { home, xdg: env.XDG_CONFIG_HOME });
+  if (!existsSync(path))
+    return;
+  try {
+    const parsed = JSON.parse(readFileSync2(path, "utf8"));
+    const folder = typeof parsed === "object" && parsed !== null ? parsed.workspace : undefined;
+    return typeof folder === "string" && folder !== "" ? folder : undefined;
+  } catch {
+    return;
+  }
+}
+function workspaceRoot({ given, env = process11.env, home = homedir3() } = {}) {
+  const fromEnv = env.KAYNOOO_WORKSPACE === "" ? undefined : env.KAYNOOO_WORKSPACE;
+  return resolve(expandHome(given ?? fromEnv ?? configured(env, home) ?? join4(home, "Workspace"), home));
+}
+function workspaceChosen({ env = process11.env, home = homedir3() } = {}) {
+  return (env.KAYNOOO_WORKSPACE ?? "") !== "" || configured(env, home) !== undefined;
+}
+function saveWorkspace(folder, { env = process11.env, home = homedir3() } = {}) {
+  const path = userConfigPath("config", { home, xdg: env.XDG_CONFIG_HOME });
+  let current = {};
+  if (existsSync(path)) {
+    try {
+      const parsed = JSON.parse(readFileSync2(path, "utf8"));
+      if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+        return false;
+      current = parsed;
+    } catch {
+      return false;
+    }
+  }
+  mkdirSync2(dirname3(path), { recursive: true });
+  writeFileSync(path, `${JSON.stringify({ ...current, workspace: folder }, undefined, 2)}
+`);
+  return true;
+}
 // src/doctor.ts
-import process14 from "process";
+import process17 from "process";
 
 // src/checks.ts
-import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
-import { basename, join as join4 } from "path";
+import { existsSync as existsSync3, readFileSync as readFileSync4 } from "fs";
+import { basename, join as join6 } from "path";
 
 // src/catalog.ts
 var HOOKS_REQUIRES = "@kaynooo/cli-guard";
@@ -1202,9 +1288,9 @@ var NEEDS = {
 };
 
 // src/completions.ts
-import { existsSync, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync2, rmSync } from "fs";
-import { join as join3 } from "path";
-import process10 from "process";
+import { existsSync as existsSync2, mkdirSync as mkdirSync3, readdirSync, readFileSync as readFileSync3, rmSync } from "fs";
+import { join as join5 } from "path";
+import process13 from "process";
 var MARKER = "# Generated by `cli completions fish`";
 var FISH_FILE = /\.fish$/;
 var FUNCTION = `functions -q __kaynooo_cli_complete; or function __kaynooo_cli_complete --argument-names bin --description 'what a @kaynooo/cli-* bin offers for the word being typed'
@@ -1238,8 +1324,8 @@ ${BASH_FUNCTION}
 complete -F __kaynooo_cli_complete ${bins.join(" ")}
 `;
 }
-function completionDir(home, env = process10.env) {
-  return join3(env.XDG_CACHE_HOME ?? join3(home, ".cache"), "fish", "kaynooo-cli");
+function completionDir(home, env = process13.env) {
+  return join5(env.XDG_CACHE_HOME ?? join5(home, ".cache"), "fish", "kaynooo-cli");
 }
 function installedBins(host) {
   return Object.values(TOOLS).flat().filter((bin) => host.which(bin) !== null);
@@ -1252,15 +1338,15 @@ complete -c ${bin} -f -a '(__kaynooo_cli_complete ${bin})'
 }
 async function installCompletions(host, dir) {
   const bins = installedBins(host);
-  mkdirSync2(dir, { recursive: true });
-  const removed = readdirSync(dir).filter((name) => FISH_FILE.test(name) && !bins.includes(name.replace(FISH_FILE, "")) && readFileSync2(join3(dir, name), "utf8").startsWith(MARKER));
+  mkdirSync3(dir, { recursive: true });
+  const removed = readdirSync(dir).filter((name) => FISH_FILE.test(name) && !bins.includes(name.replace(FISH_FILE, "")) && readFileSync3(join5(dir, name), "utf8").startsWith(MARKER));
   for (const name of removed)
-    rmSync(join3(dir, name));
-  await Promise.all(bins.map(async (bin) => Bun.write(join3(dir, `${bin}.fish`), completionFile(bin))));
+    rmSync(join5(dir, name));
+  await Promise.all(bins.map(async (bin) => Bun.write(join5(dir, `${bin}.fish`), completionFile(bin))));
   return { written: bins, removed: removed.map((name) => name.replace(FISH_FILE, "")) };
 }
 function missingCompletions(host, dir) {
-  return installedBins(host).filter((bin) => !existsSync(join3(dir, `${bin}.fish`)));
+  return installedBins(host).filter((bin) => !existsSync2(join5(dir, `${bin}.fish`)));
 }
 
 // src/checks.ts
@@ -1304,7 +1390,7 @@ function readJsonText(text) {
   }
 }
 function readJson(path) {
-  return existsSync2(path) ? readJsonText(readFileSync3(path, "utf8")) : undefined;
+  return existsSync3(path) ? readJsonText(readFileSync4(path, "utf8")) : undefined;
 }
 function firstLine(text) {
   const trimmed = text.trim();
@@ -1313,7 +1399,7 @@ function firstLine(text) {
   return end === -1 ? trimmed : trimmed.slice(0, end);
 }
 function installed(host, name) {
-  return readJson(join4(host.globalModules, name, "package.json"));
+  return readJson(join6(host.globalModules, name, "package.json"));
 }
 function isInstalled(host, name) {
   return installed(host, name)?.version !== undefined;
@@ -1321,7 +1407,7 @@ function isInstalled(host, name) {
 function ownBin(host, name, bin) {
   const declared = installed(host, name)?.bin;
   const file = typeof declared === "string" ? declared : declared?.[bin];
-  return file === undefined ? undefined : join4(host.globalModules, name, file);
+  return file === undefined ? undefined : join6(host.globalModules, name, file);
 }
 async function checkTool(host, name, bins) {
   const check = name.slice(name.indexOf("/") + 1);
@@ -1336,7 +1422,7 @@ async function checkTool(host, name, bins) {
   if (latest !== "" && Bun.semver.order(version, latest) < 0)
     return { check, ok: false, detail: `${version}, ${latest} released${off.length > 0 ? `, ${off.join(", ")} not on the PATH` : ""}`, fix: `bun install -g ${name}@${latest}` };
   if (off.length > 0)
-    return { check, ok: false, detail: `${version}, ${off.join(", ")} not on the PATH`, fix: `add ${join4(host.globalModules, "..", "..", "..", "bin")} to the PATH` };
+    return { check, ok: false, detail: `${version}, ${off.join(", ")} not on the PATH`, fix: `add ${join6(host.globalModules, "..", "..", "..", "bin")} to the PATH` };
   if (latest === "")
     return { check, ok: true, detail: `${version}, the registry did not answer: ${firstLine(info.stderr) || answered || "no version"}` };
   return { check, ok: true, detail: version };
@@ -1357,9 +1443,9 @@ async function checkTea(host) {
   return { check: "tea", ok: true, detail: `logged in to ${forge} as ${login.name}, Forgejo ${served}` };
 }
 function hooksWiring(host) {
-  const settings = readJson(join4(host.home, ".claude", "settings.json")) ?? {};
+  const settings = readJson(join6(host.home, ".claude", "settings.json")) ?? {};
   const plugin = settings.enabledPlugins?.[PLUGIN] === true;
-  const mod = (settings.env?.CLAUDE_CODE_PLUGIN_DIRS ?? "").split(":").map((dir) => dir.replace(LEADING_TILDE, host.home)).find((dir) => basename(dir) === "cli" && existsSync2(join4(dir, "hooks", "hooks.json")));
+  const mod = (settings.env?.CLAUDE_CODE_PLUGIN_DIRS ?? "").split(":").map((dir) => dir.replace(LEADING_TILDE, host.home)).find((dir) => basename(dir) === "cli" && existsSync3(join6(dir, "hooks", "hooks.json")));
   return { plugin, mod };
 }
 function checkHooks(host) {
@@ -1397,8 +1483,15 @@ function checkNeeds(host) {
   return { check: "needs", ok: true, detail: "every tool the installed packages need is on the PATH" };
 }
 var toolCheck = (name) => name.slice(name.indexOf("/") + 1);
-var OTHER_CHECKS = ["tea", "hooks", "needs", "bun", "completions"];
+var OTHER_CHECKS = ["tea", "hooks", "needs", "bun", "completions", "workspace"];
 var FORGEJO = "@kaynooo/cli-forgejo";
+var WORKSPACE = "@kaynooo/cli-workspace";
+function checkWorkspace(host, env = process.env) {
+  const folder = workspaceRoot({ home: host.home, env });
+  if (existsSync3(folder))
+    return { check: "workspace", ok: true, detail: folder };
+  return { check: "workspace", ok: false, detail: `${folder} does not exist`, fix: `mkdir -p ${folder}, or set "workspace" in ~/.config/kaynooo-cli/config.json to your folder` };
+}
 var CHECK_NAMES = [...Object.keys(TOOLS).map(toolCheck), ...OTHER_CHECKS];
 async function runChecks(host, only = []) {
   const wanted = (check) => only.length === 0 || only.includes(check);
@@ -1414,7 +1507,8 @@ async function runChecks(host, only = []) {
     ...wanted("hooks") && hooks ? [checkHooks(host)] : [],
     ...wanted("needs") ? [checkNeeds(host)] : [],
     ...wanted("bun") ? [checkBun(host)] : [],
-    ...wanted("completions") ? [checkCompletions(host)] : []
+    ...wanted("completions") ? [checkCompletions(host)] : [],
+    ...wanted("workspace") && (only.length > 0 || isInstalled(host, WORKSPACE) || isInstalled(host, "@kaynooo/cli-pkg")) ? [checkWorkspace(host)] : []
   ];
 }
 
@@ -1456,19 +1550,19 @@ async function applyFixes(host, steps, dry) {
 }
 
 // src/host.ts
-import { homedir as homedir2 } from "os";
-import { join as join5 } from "path";
-import process11 from "process";
+import { homedir as homedir4 } from "os";
+import { join as join7 } from "path";
+import process14 from "process";
 var RUN_TIMEOUT_MS = 20000;
 function hostHere() {
-  const home = homedir2();
+  const home = homedir4();
   return {
     home,
-    globalModules: join5(process11.env.BUN_INSTALL ?? join5(home, ".bun"), "install", "global", "node_modules"),
+    globalModules: join7(process14.env.BUN_INSTALL ?? join7(home, ".bun"), "install", "global", "node_modules"),
     bunVersion: Bun.version,
     which: (bin) => Bun.which(bin),
     run: async (argv, env) => {
-      const ran = await runCommand(argv, { timeoutMs: RUN_TIMEOUT_MS, ...env === undefined ? {} : { env: { ...process11.env, ...env } } });
+      const ran = await runCommand(argv, { timeoutMs: RUN_TIMEOUT_MS, ...env === undefined ? {} : { env: { ...process14.env, ...env } } });
       if (ran.timedOut)
         return { code: 1, stdout: "", stderr: `timed out after ${RUN_TIMEOUT_MS / 1000}s` };
       const of = (stream) => Buffer.concat(ran.chunks.filter((chunk) => chunk.stream === stream).map((chunk) => chunk.data)).toString();
@@ -1478,10 +1572,10 @@ function hostHere() {
 }
 
 // src/install.ts
-import process13 from "process";
+import process16 from "process";
 
 // ../kit/src/prompt.ts
-import process12 from "process";
+import process15 from "process";
 var KEY_SEQUENCES = /\x1B\[[0-9;]*[A-Z~]|\x1BO[A-Z]|[\s\S]/giu;
 var CONTROL = /^[\x00-\x1F\x7F]/;
 var WORDS = /\s+/;
@@ -1519,6 +1613,36 @@ async function checklist(question, choices, { initial = new Set, min = 0, toggle
   });
   return accepted ? checked : undefined;
 }
+async function input2(question, { default: fallback, mask = false, validate, ...settings } = {}) {
+  let value = "";
+  let invalid;
+  const taken = () => value === "" ? fallback ?? "" : value;
+  const shown = () => mask ? "*".repeat([...taken()].length) : taken();
+  const accepted = await ask(question, settings, (colors, state, { columns }) => {
+    if (state !== "asking")
+      return [answer(colors, question, state, shown())];
+    const characters = [...shown()];
+    const room = Math.max(columns - question.length - 5, 1);
+    const tail = characters.length > room ? `\u2026${characters.slice(1 - room).join("")}` : shown();
+    const typed = value === "" ? colors.dim(tail) : tail;
+    return [`${colors.cyan("?")} ${question} ${typed}${colors.dim("\u2588")}`, ...invalid === undefined ? [] : [`  ${colors.red(invalid)}`]];
+  }, (key) => {
+    if (key === "cancel")
+      return "cancel";
+    invalid = undefined;
+    if (key === "enter") {
+      invalid = validate?.(taken());
+      return invalid === undefined ? "enter" : undefined;
+    }
+    if (key === "erase")
+      value = [...value].slice(0, -1).join("");
+    else if (typeof key === "object")
+      value += key.text;
+    return;
+  });
+  return accepted ? taken() : undefined;
+}
+
 class List {
   choices;
   query = "";
@@ -1577,9 +1701,9 @@ function asking(colors, question, typed, keys) {
 function answer(colors, question, state, picked) {
   return state === "enter" ? `${colors.green("\u2713")} ${question} ${colors.cyan(picked)}` : `${colors.red("\u2717")} ${question} ${colors.dim("cancelled")}`;
 }
-async function ask(question, { hint, terminal = process12 }, render, press) {
+async function ask(question, { hint, terminal = process15 }, render, press) {
   const { stdin, stderr } = terminal;
-  if (stdin.isTTY !== true || stderr.isTTY !== true)
+  if (!isInteractive(terminal))
     fail(`cannot ask "${question}" off a terminal`, 2, hint);
   const colors = paint(stderr);
   let drawn = 0;
@@ -1678,15 +1802,22 @@ function checksFor(packages, plugin) {
   return [...packages.map((name) => name.slice(name.indexOf("/") + 1)), ...plugin ? ["hooks"] : [], "needs", "completions", ...packages.includes("@kaynooo/cli-forgejo") ? ["tea"] : []];
 }
 async function ask2(pool) {
-  if (process13.stdin.isTTY !== true || process13.stderr.isTTY !== true)
+  if (!isInteractive())
     badUsage("name what to install, or all: doctor --install forgejo check hooks (doctor --install --list shows the choices)");
   const choices = pool.map((each) => ({ value: each, label: each.label, hint: each.hint }));
   const picked = await checklist("install which?", choices, { hint: "name them instead: doctor --install forgejo check" });
   return picked === undefined ? [] : [...picked];
 }
+async function askWorkspace(host) {
+  if (!isInteractive() || workspaceChosen({ home: host.home }))
+    return;
+  const folder = await input2("folder holding your repositories (repos, sweep and pkg bump look there)", { default: "~/Workspace" });
+  if (folder !== undefined && folder !== "" && !saveWorkspace(folder, { home: host.home }))
+    console.error(`could not write the workspace into ${userConfigPath("config", { home: host.home })}: it does not parse, fix it by hand`);
+}
 async function install(host, options, recheck) {
   const pool = candidates2(host);
-  const { dim, green, red, yellow } = paint(process13.stdout);
+  const { dim, green, red, yellow } = paint(process16.stdout);
   if (options.list) {
     for (const each of pool)
       console.log(`${each.label.padEnd(12)} ${dim(each.hint)}`);
@@ -1717,6 +1848,8 @@ async function install(host, options, recheck) {
     console.log(`${yellow("warn   ")}  ${each.package}: ${each.need} is missing, ${each.why}`);
   if (planned.packages.length === 0 && !planned.plugin)
     return 1;
+  if (!options.dryRun && planned.packages.some((name) => name === "@kaynooo/cli-workspace" || name === "@kaynooo/cli-pkg"))
+    await askWorkspace(host);
   const command = ["bun", "install", "-g", ...planned.packages];
   if (planned.packages.length > 0)
     console.log(`${options.dryRun ? dim("would  ") : green("install")}  ${command.join(" ")}`);
@@ -1773,7 +1906,7 @@ var OPTIONS = {
 function print(results) {
   if (results.length === 0)
     return;
-  const { green, red, dim } = paint(process14.stdout);
+  const { green, red, dim } = paint(process17.stdout);
   const width = Math.max(...results.map((result) => result.check.length));
   for (const { check, ok, detail, fix } of results)
     console.log(`${ok ? green("ok  ") : red("FAIL")}  ${check.padEnd(width)}  ${detail}${fix === undefined ? "" : `  ${dim("fix:")} ${fix}`}`);
@@ -1783,7 +1916,7 @@ function print(results) {
 ${dim("fix them all:")} ${INSTALL2}${installs.join(" ")}`);
 }
 function printOutcomes(outcomes, log) {
-  const { green, red, dim } = paint(process14.stdout);
+  const { green, red, dim } = paint(process17.stdout);
   const marks = { ran: green("ran    "), failed: red("failed "), "dry-run": dim("would  "), "not run": dim("not run") };
   for (const { command, status, detail } of outcomes)
     log(`${marks[status]}  ${command}${detail === undefined ? "" : `  ${dim(detail)}`}`);
@@ -1823,9 +1956,9 @@ after the fixes:`);
   const absent = Object.keys(TOOLS).filter((name) => !isInstalled(host, name)).length;
   if (!json && only.length === 0 && absent > 0)
     console.log(`
-${paint(process14.stdout).dim(`${absent} packages not installed: doctor --install`)}`);
+${paint(process17.stdout).dim(`${absent} packages not installed: doctor --install`)}`);
   return results.every((result) => result.ok) ? 0 : 1;
 }
 
 // src/cli.ts
-process15.exitCode = await runMain({ name: "doctor", run: async (args) => main(args) });
+process18.exitCode = await runMain({ name: "doctor", run: async (args) => main(args) });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kaynooo/cli-doctor",
   "type": "module",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "doctor: checks the @kaynooo/cli-* install of a host: each bin's version against the registry, tea's login to Forgejo, the Claude Code hooks and the Bun floor; cli list: every bin in one line, read from its own help.",
   "author": "Kaynooo <contact@kaynooo.fr>",
   "license": "MIT",
@@ -37,6 +37,6 @@
     "doctor": "$npm_execpath src/cli.ts"
   },
   "devDependencies": {
-    "@kaynooo/cli-kit": "0.21.1"
+    "@kaynooo/cli-kit": "0.22.0"
   }
 }