@ghostystudio/cli 0.55.0 → 0.56.0

package/README.md

@@ -109,6 +109,11 @@ Every command has its own help with examples: `ghosty <command> --help` or `ghos
 
 Exit codes: `0` ok · `1` API error · `2` usage error · `3` not signed in.
 
+### Changes in 0.56.0
+
+- `factory runs why <run> [--refresh]`: why a run got stuck or failed — category, impact, the critical step with its evidence and what to change next time (a healthy run doesn't call the model).
+- `factory runs show --timing` lists stuck patterns (a command open 8+ min, the same command repeated, errors in a row, going back and forth, apt install in a box); `runs stats` counts runs with stuck alerts.
+
 ### Changes in 0.55.0
 
 - `factory runs show <run> --timing`: where a run's time and money went — each turn of each role (critic, @plan, @build, @check) with minutes, minutes in tools, model and USD; the clock split into working, waiting for a person and the rest (CI, queues); and the commands that took 60 s or more.

package/dist/index.js

@@ -8468,7 +8468,7 @@ async function postLong(path, body, timeoutMs = 9e5) {
     const req = httpsRequest(`${base}${path}`, {
       method: "POST",
       timeout: timeoutMs,
-      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.55.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.56.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -8510,7 +8510,7 @@ async function request(path, opts = {}, retried = false) {
     method: opts.method ?? (opts.body !== void 0 || opts.raw !== void 0 ? "POST" : "GET"),
     headers: {
       authorization: `Bearer ${token}`,
-      "user-agent": `ghosty-cli/${"0.55.0"}`,
+      "user-agent": `ghosty-cli/${"0.56.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -10404,7 +10404,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.55.0"}`
+        "user-agent": `ghosty-cli/${"0.56.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -12492,7 +12492,7 @@ var HELPS_ES = {
     ]
   },
   factory: {
-    summary: "Los pedidos de la Software Factory de un espacio (viven en su Teams): listarlos con tiempo y costo, ver uno (plan vigente, PR, preview, \xFAltimos eventos, qu\xE9 rol trabaja), ver en qu\xE9 se fue su tiempo y su dinero, los totales del espacio y corregir el t\xEDtulo de un pedido.",
+    summary: "Los pedidos de la Software Factory de un espacio (viven en su Teams): listarlos con tiempo y costo, ver uno (plan vigente, PR, preview, \xFAltimos eventos, qu\xE9 rol trabaja), ver en qu\xE9 se fue su tiempo y su dinero y por qu\xE9 se ator\xF3 o fall\xF3, los totales del espacio y corregir el t\xEDtulo de un pedido.",
     replace: [['"Title"', '"T\xEDtulo"']],
     flags: [
       ["--workspace SLUG", "el espacio (default: el de ghosty use)"],
@@ -12501,6 +12501,7 @@ var HELPS_ES = {
       ["--limit N", "ls: cu\xE1ntos (default 30)"],
       ["--full", "show: imprime el plan vigente"],
       ["--timing", "show: cada turno de cada rol (cr\xEDtico, @plan, @build, @check) con minutos, minutos en tools, modelo y USD; el reloj del pedido partido en trabajando, esperando a una persona (plan o PR por aprobar) y lo dem\xE1s (CI, colas); y los comandos de 60 s o m\xE1s"],
+      ["--refresh", "why: rehace el an\xE1lisis (se guarda la primera vez)"],
       ["--since 30d", "stats: cu\xE1nto hacia atr\xE1s (d\xEDas, default 30)"],
       ["--repo OWNER/REPO", "stats: s\xF3lo ese repo (due\xF1o/repo)"],
       ["-n, --dry-run", "rename: ense\xF1a el cambio, no cambia nada"],
@@ -12510,7 +12511,9 @@ var HELPS_ES = {
       "Leer pide ser miembro del espacio; renombrar, ser due\xF1o, admin o staff de Ghosty, y queda en bit\xE1cora (factory.run_rename). La tarjeta del room toma el t\xEDtulo nuevo en su siguiente refresco.",
       "Qui\xE9n es @plan o @build: ghosty agents ls --handle plan --workspace SLUG.",
       "stats: pedidos, % mezclados, mediana de minutos hasta el PR y hasta el merge, vueltas @check\u2192@build y CI rojo por pedido, y costo por pedido y por PR mezclado. El costo incluye el primer turno de @plan en el hilo, antes de que naciera el pedido.",
-      "--timing lee la transcripci\xF3n de cada rol: los motores sin una (ACP) salen con minutos y costo, pero sin comandos."
+      "--timing lee la transcripci\xF3n de cada rol: los motores sin una (ACP) salen con minutos y costo, pero sin comandos. Tambi\xE9n lista los atascos: un comando abierto 8+ min, el mismo comando 4 veces, el mismo error 3 veces, ir y venir entre dos acciones, o apt install dentro de una caja.",
+      "why: si el pedido no fue sano (atascos, @build de m\xE1s de 30 min, vueltas, CI rojo, escalado), una categor\xEDa (missing_service, unresolved_build_or_tests, fixed_strategy\u2026), el paso cr\xEDtico con su evidencia y qu\xE9 cambiar la pr\xF3xima vez. Un pedido sano no llama al modelo. Cuando un pedido cierra sin ser sano, el room recibe este resumen en su hilo.",
+      "Mientras un rol trabaja, si se atora el room recibe un \u23F3 en el hilo y al rol se le dice qu\xE9 revisar; desde la segunda vez en el mismo pedido, quien lo pidi\xF3 recibe un push."
     ]
   }
 };
@@ -13244,11 +13247,12 @@ HELPS.audit = {
   learn: `${REF}#bitacora`
 };
 HELPS.factory = {
-  summary: "A workspace's Software Factory runs (they live in its Teams): list them with time and cost, see one (current plan, PR, preview, latest events, which role is working), see where its time and money went, totals for the workspace, and fix a run's title.",
+  summary: "A workspace's Software Factory runs (they live in its Teams): list them with time and cost, see one (current plan, PR, preview, latest events, which role is working), see where its time and money went and why it got stuck or failed, totals for the workspace, and fix a run's title.",
   usage: [
     "ghosty factory runs ls [--workspace SLUG] [--room R] [--status S] [--limit 30]",
     "ghosty factory runs show <run> [--workspace SLUG] [--full]",
     "ghosty factory runs show <run> --timing [--workspace SLUG]",
+    "ghosty factory runs why <run> [--refresh] [--workspace SLUG]",
     "ghosty factory runs stats [--since 30d] [--repo OWNER/REPO] [--workspace SLUG]",
     'ghosty factory runs rename <run> "Title" [--workspace SLUG] [--dry-run] [--yes]'
   ],
@@ -13259,13 +13263,14 @@ HELPS.factory = {
     ["--limit N", "ls: how many (default 30)"],
     ["--full", "show: print the current plan"],
     ["--timing", "show: each turn of each role (critic, @plan, @build, @check) with minutes, minutes in tools, model and USD; the run's clock split into working, waiting for a person (plan or PR to approve) and the rest (CI, queues); and the commands that took 60 s or more"],
+    ["--refresh", "why: redo the analysis (it's saved the first time)"],
     ["--since 30d", "stats: how far back (days, default 30)"],
     ["--repo OWNER/REPO", "stats: only that repo"],
     ["-n, --dry-run", "rename: show the change, change nothing"],
     ["--yes", "rename: skip the confirmation (required without a terminal)"]
   ],
-  examples: ["ghosty factory runs ls --workspace business --room mailmask", "ghosty factory runs show 15 --workspace business", "ghosty factory runs show 31 --timing --workspace mercadito-verde", "ghosty factory runs stats --since 7d --workspace mercadito-verde", 'ghosty factory runs rename 15 "Docs del CLI al d\xEDa" --workspace business --dry-run'],
-  notes: ["Reading needs membership in the workspace; rename needs owner, admin or Ghosty staff, and is logged (factory.run_rename). The room's card picks the new title up on its next refresh.", "Who is @plan or @build: ghosty agents ls --handle plan --workspace SLUG.", "stats: runs, % merged, median minutes to PR and to merge, @check\u2192@build loops and red CI per run, and cost per run and per merged PR. The cost counts @plan's first turn in the thread, before the run existed.", "--timing reads each role's transcript: engines without one (ACP) show minutes and cost but no commands."],
+  examples: ["ghosty factory runs ls --workspace business --room mailmask", "ghosty factory runs show 15 --workspace business", "ghosty factory runs show 13 --timing --workspace mercadito-verde", "ghosty factory runs why 13 --workspace mercadito-verde", "ghosty factory runs stats --since 7d --workspace mercadito-verde", 'ghosty factory runs rename 15 "Docs del CLI al d\xEDa" --workspace business --dry-run'],
+  notes: ["Reading needs membership in the workspace; rename needs owner, admin or Ghosty staff, and is logged (factory.run_rename). The room's card picks the new title up on its next refresh.", "Who is @plan or @build: ghosty agents ls --handle plan --workspace SLUG.", "stats: runs, % merged, median minutes to PR and to merge, @check\u2192@build loops and red CI per run, and cost per run and per merged PR. The cost counts @plan's first turn in the thread, before the run existed.", "--timing reads each role's transcript: engines without one (ACP) show minutes and cost but no commands. It also lists stuck patterns: a command open 8+ min, the same command 4 times, the same error 3 times, going back and forth, or apt install inside a box.", "why: if the run wasn't healthy (stuck patterns, @build over 30 min, loops, red CI, escalated), a category (missing_service, unresolved_build_or_tests, fixed_strategy\u2026), the critical step with its evidence and what to change next time. A healthy run doesn't call the model. When a run closes unhealthy, the room gets this summary in its thread.", "While a role works, if it gets stuck the room gets a \u23F3 message in the thread and the role is told what to check; from the second time in the same run, whoever asked gets a push."],
   learn: `${REF}#fabrica`
 };
 function helpText(cmd) {
@@ -14125,7 +14130,7 @@ var mins = (n) => n === null || n === void 0 ? "\u2014" : n >= 120 ? `${(n / 60)
 var hhmm = (iso) => new Date(iso).toLocaleTimeString("es-MX", { hour: "2-digit", minute: "2-digit", hour12: false });
 var short2 = (s2) => (s2 ?? "").slice(0, 16).replace("T", " ");
 async function factoryCmd(sub, verb, ref, title, v, context) {
-  if (sub !== "runs") throw usage(t(`Unknown factory subcommand: ${sub ?? "(none)"}.`, `Subcomando de factory desconocido: ${sub ?? "(ninguno)"}.`), "ghosty factory runs ls|show|stats|rename \u2026");
+  if (sub !== "runs") throw usage(t(`Unknown factory subcommand: ${sub ?? "(none)"}.`, `Subcomando de factory desconocido: ${sub ?? "(ninguno)"}.`), "ghosty factory runs ls|show|why|stats|rename \u2026");
   const ws = v.workspace ?? context;
   if (!ws) throw usage(t("Which workspace?", "\xBFQu\xE9 espacio?"), t("Add --workspace SLUG (or set one with ghosty use SLUG).", "Agrega --workspace SLUG (o fija uno con ghosty use SLUG)."));
   const base = `/api/v2/workspaces/${enc12(ws)}/factory/runs`;
@@ -14145,7 +14150,7 @@ ${dim(`${t("Detail", "Detalle")}: ghosty factory runs show <run> --workspace ${r
         bold(t(`${workspace} \xB7 last ${s2.sinceDays} days${s2.repo ? ` \xB7 ${s2.repo}` : ""}`, `${workspace} \xB7 \xFAltimos ${s2.sinceDays} d\xEDas${s2.repo ? ` \xB7 ${s2.repo}` : ""}`)),
         `${t("runs", "pedidos")}: ${s2.runs} \xB7 ${t("merged", "mezclados")}: ${s2.merged} (${s2.mergedPct ?? "\u2014"} %) ${dim(s2.byStatus.map((b) => `${b.status} ${b.runs}`).join(" \xB7 "))}`,
         `${t("median to PR", "mediana hasta el PR")}: ${mins(s2.medianMinutesToPr)} \xB7 ${t("to merge", "hasta el merge")}: ${mins(s2.medianMinutesToMerge)}`,
-        `${t("@check\u2192@build loops per run", "vueltas @check\u2192@build por pedido")}: ${s2.avgLoops ?? "\u2014"} \xB7 ${t("red CI per run", "CI rojo por pedido")}: ${s2.avgCiFails ?? "\u2014"}`,
+        `${t("@check\u2192@build loops per run", "vueltas @check\u2192@build por pedido")}: ${s2.avgLoops ?? "\u2014"} \xB7 ${t("red CI per run", "CI rojo por pedido")}: ${s2.avgCiFails ?? "\u2014"}${s2.runsWithStuck !== void 0 ? ` \xB7 ${t("runs with stuck alerts", "pedidos con atascos")}: ${s2.runsWithStuck}` : ""}`,
         `${t("cost", "costo")}: ${money(s2.usd)} USD \xB7 ${t("per run", "por pedido")} ${money(s2.usdPerRun)} \xB7 ${bold(t(`per merged PR ${money(s2.usdPerMergedPr)}`, `por PR mezclado ${money(s2.usdPerMergedPr)}`))}`,
         ...s2.byRepo.length > 1 ? ["", table(s2.byRepo.map((b) => ({ repo: b.repo, runs: b.runs, merged: b.merged, usd: money(b.usd) })), ["repo", "runs", "merged", "usd"])] : []
       ].join("\n");
@@ -14178,10 +14183,26 @@ ${dim(`${t("Detail", "Detalle")}: ghosty factory runs show <run> --workspace ${r
         ...head,
         rows.length ? table(rows, cols) : dim(t("No turns found for this run.", "No hay turnos de este pedido.")),
         ...slow.length ? ["", bold(t("Slowest commands (\u2265 60 s)", "Comandos m\xE1s lentos (\u2265 60 s)")), ...slow.map((x) => `  ${hhmm(x.at)} @${x.role} ${x.secs === null ? red(t("no result", "sin resultado")) : mins(Math.round(x.secs / 6) / 10)}  ${dim(`${x.tool}: ${x.input}`)}`)] : [],
+        ...tm.steps.some((s2) => s2.flags?.length) ? ["", bold(t("Stuck patterns", "Atascos")), ...tm.steps.flatMap((s2) => (s2.flags ?? []).map((f) => `  ${hhmm(f.at)} @${s2.role} ${red(f.rule)}${f.count > 1 ? ` \xD7${f.count}` : ""}${f.secs ? ` ${mins(Math.round(f.secs / 6) / 10)}` : ""}  ${dim(f.detail.slice(0, 120))}`)), dim(t(`Why: ghosty factory runs why ${tm.run} --workspace ${workspace}`, `Por qu\xE9: ghosty factory runs why ${tm.run} --workspace ${workspace}`))] : [],
         ...tm.steps.filter((s2) => s2.why).map((s2) => dim(`  @${s2.role}: ${t("no timeline", "sin l\xEDnea de tiempo")} (${s2.why})`))
       ].join("\n");
     });
   }
+  if (verb === "why") {
+    const { why: w, workspace } = await api(`${path}/why`, v.refresh ? { body: { refresh: true } } : void 0);
+    return out({ workspace, why: w }, () => {
+      if (w.healthy) return `${lavender("\u2713")} #${w.runId} ${t("was healthy: no stuck patterns, no long @build, no loops, no red CI.", "fue sano: sin atascos, sin @build largo, sin vueltas ni CI rojo.")}`;
+      const impact = { high: t("high", "alto"), medium: t("medium", "medio"), low: t("low", "bajo") }[w.impact] ?? w.impact;
+      return [
+        `${bold(`#${w.runId}`)} ${red(w.category)} ${dim(`\xB7 ${t("impact", "impacto")} ${impact} \xB7 ${w.source === "model" ? w.model ?? "model" : t("rules", "reglas")} \xB7 ${short2(w.createdAt)}`)}`,
+        w.summary,
+        dim(`${t("signals", "se\xF1ales")}: ${w.reasons.join("; ")}`),
+        ...w.criticalStep ? ["", bold(t("Critical step", "Paso cr\xEDtico")), `  ${w.criticalStep.at ? hhmm(w.criticalStep.at) : "\u2014"} @${w.criticalStep.role ?? "?"}  ${dim(w.criticalStep.command ?? "")}`, `  ${w.criticalStep.evidence}`] : [],
+        ...w.actions.length ? ["", bold(t("Next time", "Para la pr\xF3xima")), ...w.actions.map((a) => `  ${lavender(a.type)} ${a.text}`)] : [],
+        ...v.refresh ? [] : ["", dim(t("Saved analysis; --refresh redoes it.", "An\xE1lisis guardado; --refresh lo rehace."))]
+      ].join("\n");
+    });
+  }
   if (verb === "show") {
     const { run: r } = await api(path);
     const lines = [
@@ -14209,7 +14230,7 @@ ${dim(t("Dry run: nothing changed.", "Simulacro: no se cambi\xF3 nada."))}`);
     const r = await api(path, { body: { title } });
     return out(r, () => `${lavender("\u2713")} ${line2} ${dim(t("(logged; the room card picks it up on its next refresh)", "(queda en bit\xE1cora; la tarjeta del room lo toma en su siguiente refresco)"))}`);
   }
-  throw usage(t(`Unknown runs subcommand: ${verb}.`, `Subcomando de runs desconocido: ${verb}.`), 'ghosty factory runs ls | show <run> [--timing] | stats [--since 30d] | rename <run> "title"');
+  throw usage(t(`Unknown runs subcommand: ${verb}.`, `Subcomando de runs desconocido: ${verb}.`), 'ghosty factory runs ls | show <run> [--timing] | why <run> [--refresh] | stats [--since 30d] | rename <run> "title"');
 }
 async function agentsByHandle(handle, workspace) {
   const qs = new URLSearchParams({ handle, ...workspace ? { workspace } : {} });
@@ -14501,7 +14522,7 @@ ${bold("Workspaces")}  ${dim("(changing them: Ghosty staff)")}
   staff ls [staff-email] [client-email]       Ghosty staff assigned to client accounts (staff)   [--all: also revoked]
   staff assign|unassign <staff> <client>      Staff sees and runs that account's agents, documents, databases and boards as themselves (no keys, billing or transfers; logged)   [--reason]
   audit ls                                    The audit log: who changed what (agent page, channels, pauses, replies, transfers, "log in as")   [--workspace SLUG] [--agent ID] [--actor EMAIL] [--action A] [--since 24h] [--limit N]
-  factory runs ls|show|stats|rename           A workspace's Software Factory runs: list (time and cost), detail (plan, PR, preview, who is working), where the time and money went, totals, fix a title   [--workspace SLUG] [--room R] [--status S] [show --timing] [stats --since 30d --repo R]
+  factory runs ls|show|why|stats|rename       A workspace's Software Factory runs: list (time and cost), detail (plan, PR, preview, who is working), where the time and money went, why it got stuck or failed, totals, fix a title   [--workspace SLUG] [--room R] [--status S] [show --timing] [why --refresh] [stats --since 30d --repo R]
 
 ${bold("Agents")}
   agents ls                 List your agents   [--engine E] [--ids: only ids, for xargs] \xB7 --user EMAIL --app all|android|ios|desktop: as their app sees it (staff)
@@ -14665,7 +14686,7 @@ ${bold("Espacios")}  ${dim("(cambiarlos: staff de Ghosty)")}
   staff ls [correo-staff] [correo-cliente]    Staff de Ghosty asignado a cuentas cliente (staff)   [--all: tambi\xE9n revocadas]
   staff assign|unassign <staff> <cliente>     El staff ve y opera agentes, documentos, bases y tableros de esa cuenta como s\xED mismo (sin llaves, cobro ni traspasos; queda en bit\xE1cora)   [--reason]
   audit ls                                    La bit\xE1cora: qui\xE9n cambi\xF3 qu\xE9 (ficha, canales, pausas, respuestas, traspasos, \xABentrar como\xBB)   [--workspace SLUG] [--agent ID] [--actor CORREO] [--action A] [--since 24h] [--limit N]
-  factory runs ls|show|stats|rename           Los pedidos de la Software Factory de un espacio: lista (tiempo y costo), detalle (plan, PR, preview, qui\xE9n trabaja), en qu\xE9 se fue el tiempo y el dinero, totales, corregir un t\xEDtulo   [--workspace SLUG] [--room R] [--status S] [show --timing] [stats --since 30d --repo R]
+  factory runs ls|show|why|stats|rename       Los pedidos de la Software Factory de un espacio: lista (tiempo y costo), detalle (plan, PR, preview, qui\xE9n trabaja), en qu\xE9 se fue el tiempo y el dinero, por qu\xE9 se ator\xF3 o fall\xF3, totales, corregir un t\xEDtulo   [--workspace SLUG] [--room R] [--status S] [show --timing] [why --refresh] [stats --since 30d --repo R]
 
 ${bold("Agentes")}
   agents ls                 Lista tus agentes   [--engine E] [--ids: s\xF3lo ids, para xargs] \xB7 --user CORREO --app all|android|ios|desktop: como lo ve su app (staff)
@@ -14926,6 +14947,7 @@ async function main() {
       verbose: { type: "boolean" },
       full: { type: "boolean" },
       timing: { type: "boolean" },
+      refresh: { type: "boolean" },
       repo: { type: "string" },
       "as-formmy": { type: "boolean" },
       "key-column": { type: "string" },
@@ -15063,7 +15085,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.55.0" }, () => "0.55.0");
+  if (v.version) return out({ version: "0.56.0" }, () => "0.56.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -15229,7 +15251,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.55.0").catch(() => null);
+var notice = updateNotice("0.56.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghostystudio/cli",
-  "version": "0.55.0",
+  "version": "0.56.0",
   "description": "Official Ghosty Studio CLI — configure, test and chat with your agents from the terminal. Built for humans and coding agents.",
   "type": "module",
   "bin": {