@ghostystudio/cli 0.71.0 → 0.74.0

package/README.md

@@ -121,6 +121,9 @@ ghosty connectors ls|connect|disconnect [id]  [--q TEXT] [--from-env VAR] [--no-
 ghosty support open --title T --body TEXT · support ls | show <id> | reply <id> --body TEXT   # ask Ghosty for help; answered by email
 ghosty browser logout                    # revoke your terminal agents' browser tokens and disconnect Ghosty for Chrome
 ghosty audit ls [--workspace SLUG] [--agent ID] [--actor EMAIL] [--action A] [--since 24h] [--limit N]   # who changed what
+ghosty factory rooms connect owner/name --room R --create   # set up the factory for a repo from the terminal
+ghosty factory run "…" --repo owner/name [--wait]   # hand a request to the Software Factory from the terminal
+ghosty factory runs watch|approve|changes|merge|card <run>   # wait for it and decide it without opening Teams
 ghosty factory runs ls|show|why|stats|rename [--workspace SLUG] [--room R] [--status S] [show --timing] [why --refresh]   # Software Factory runs
 ghosty docs
 
@@ -137,6 +140,14 @@ 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.73.0
+
+- `factory rooms ls|connect|disconnect`: set up the factory for a repo without opening Teams. `connect owner/repo --room R --create` creates the room, connects the repo (only if your GitHub App sees it) and tells you how ready it is for agents.
+
+### Changes in 0.72.0
+
+- `factory run "…" --repo owner/name [--wait]`: hand a request to the Software Factory from the terminal (it posts «@plan …» in the repo's room under your name). `--wait` and `runs watch <run>` return when the run needs you and print the next command; `runs approve <run> --plan-version N`, `runs changes <run> --note "…"`, `runs merge <run>` and `runs card <run>` decide it without opening Teams.
+
 ### Changes in 0.71.0
 
 - `channels mteams ls|connect|zip|on|off|rm`: your agent as a Microsoft Teams bot through an Azure Bot in the client's tenant (no app store). `ls` now shows the bot's last problem (token rejected, send failed, app uninstalled), also in `--json` as `lastError`/`lastErrorAt`.

package/dist/index.js

@@ -1175,7 +1175,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.71.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
+      headers: { authorization: `Bearer ${token}`, "user-agent": `ghosty-cli/${"0.74.0"}`, "content-type": "application/json", "content-length": Buffer.byteLength(data) }
     }, (res) => {
       let buf = "";
       res.on("data", (c) => buf += c);
@@ -1217,7 +1217,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.71.0"}`,
+      "user-agent": `ghosty-cli/${"0.74.0"}`,
       "accept-language": lang(),
       ...opts.body !== void 0 ? { "content-type": "application/json" } : {},
       ...opts.headers
@@ -11193,7 +11193,7 @@ async function call(path, v, init = {}) {
         "x-ghosty-ts": ts,
         "x-ghosty-sig": sig,
         "content-type": "application/json",
-        "user-agent": `ghosty-cli/${"0.71.0"}`
+        "user-agent": `ghosty-cli/${"0.74.0"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -13558,26 +13558,39 @@ 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 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"']],
+    summary: "P\xEDdele cosas a la Software Factory de un espacio desde la terminal y decide sin abrir Teams (firmar el plan, mergear el PR): la f\xE1brica como complemento de tu agente de c\xF3digo. Tambi\xE9n sus pedidos (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"'], [`"What, why and how we know it's done"`, '"Qu\xE9, por qu\xE9 y c\xF3mo se sabe que qued\xF3"']],
     flags: [
       ["--workspace SLUG", "el espacio (default: el de ghosty use)"],
-      ["--room R", "ls: s\xF3lo los pedidos de ese room (#slug o nombre)"],
+      ["--repo OWNER/REPO", "run: el repo; va al room que lo tiene conectado. stats: s\xF3lo ese repo"],
+      ["--wait", "run: espera a que el pedido te necesite (firmar el plan, decidir, mergear el PR) o termine; imprime el siguiente comando"],
+      ["--timeout S", "run --wait / watch: segundos de espera (default 1800); exit 1 si se acaba"],
+      ["--thread ID", "watch: el hilo que te dio run, antes de que @plan cree el pedido"],
+      ["--plan-version N", "approve: la versi\xF3n del plan que le\xEDste (runs show <pedido> --full); una m\xE1s nueva se rechaza"],
+      ["--note T", "changes: qu\xE9 cambiar del plan (o por qu\xE9 replanear tras un escalado). approve tras un escalado: qu\xE9 debe arreglar @build"],
+      ["--check-scope T", "approve/changes: lo \xFAnico que @check revisa en la siguiente vuelta (lo propone runs advise); lo nuevo va como nota, no como hallazgo"],
+      ["--skip-preview", "merge: mergea sin la preview que ped\xEDa el plan (queda en bit\xE1cora)"],
+      ["--create", "rooms connect: crea el room si no existe"],
+      ["--private", "rooms connect --create: el room nuevo es privado (s\xF3lo t\xFA, y a quien agregues)"],
+      ["--room R", "rooms connect/disconnect: el room (slug o nombre). run: ese room en vez de buscarlo por --repo. ls: s\xF3lo los pedidos de ese room (#slug o nombre)"],
       ["--status S", "ls: s\xF3lo esa etapa (planning, building, checking, pr_review, merged\u2026)"],
       ["--limit N", "ls: cu\xE1ntos (default 30)"],
-      ["--full", "show: imprime el plan vigente"],
+      ["--full", "show: imprime el plan vigente. rooms ls: tambi\xE9n los rooms sin repo"],
       ["--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"],
-      ["--yes", "rename: se salta la confirmaci\xF3n (obligatorio sin terminal)"]
+      ["--yes", "rename, approve, changes, merge: se salta la confirmaci\xF3n (obligatorio sin terminal)"]
     ],
     notes: [
+      "rooms connect revisa que TU instalaci\xF3n de la GitHub App vea el repo (si no, te da la liga para darle acceso) y dice qu\xE9 tan listo est\xE1 para agentes (niveles 1\u20133 y lo que falta). Cualquier miembro puede conectar; desconectar, quien lo conect\xF3 o el due\xF1o. Queda en bit\xE1cora (factory.room_connect / factory.room_disconnect).",
+      "run publica \xAB@plan <tu texto>\xBB en el room A TU NOMBRE, como si lo escribieras en Teams: el mismo plan, firmas y tarjeta. Escr\xEDbelo como ticket: el objetivo, por qu\xE9 y c\xF3mo se sabe que qued\xF3. Cualquier miembro puede pedir, firmar, pedir cambios y mergear; todo queda en bit\xE1cora (factory.run, factory.run_approve\u2026).",
+      "card baja la tarjeta viva del pedido al final de su hilo; la anterior queda como huella quieta con liga a la viva. Los roles tambi\xE9n pueden (factory_card).",
       "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. 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.",
+      "advise: con un pedido ESCALADO, qu\xE9 hacer \u2014que @build lo arregle o rehacer el plan\u2014 con la nota para @build punto por punto (cada uno cita el hallazgo o el paso del plan que lo justifica) y qu\xE9 debe revisar @check. Compara los hallazgos de @check contra el plan firmado. No aplica nada: imprime el comando exacto de approve/changes. show dice por qu\xE9 se escal\xF3.",
       "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. Primero cruza los criterios del plan aprobado con la evidencia: aprobado sin la preview que ped\xEDa un criterio, mezclado sin preview, smoke rojo sobre el commit mezclado o criterio de CI con CI none \u2192 approved_unmet_criterion, arriba de cualquier atasco. 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."
     ]
@@ -14460,8 +14473,18 @@ 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 and why it got stuck or failed, totals for the workspace, and fix a run's title.",
+  summary: "Hand requests to a workspace's Software Factory from the terminal and decide them (approve the plan, merge the PR) without opening Teams \u2014 the factory as a sidekick for your coding agent. Also its 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 rooms ls [--full] [--workspace SLUG]",
+    "ghosty factory rooms connect OWNER/REPO --room R [--create] [--private] [--workspace SLUG]",
+    "ghosty factory rooms disconnect OWNER/REPO --room R [--yes]",
+    `ghosty factory run "What, why and how we know it's done" --repo OWNER/REPO [--room R] [--wait] [--timeout 1800] [--workspace SLUG]`,
+    "ghosty factory runs watch <run> | --thread <id> [--timeout 1800] [--workspace SLUG]",
+    'ghosty factory runs approve <run> --plan-version N [--note "\u2026"] [--check-scope "\u2026"] [--yes]',
+    "ghosty factory runs advise <run> [--workspace SLUG]",
+    'ghosty factory runs changes <run> --note "\u2026" [--yes]',
+    "ghosty factory runs merge <run> [--skip-preview] [--yes]",
+    "ghosty factory runs card <run>",
     "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]",
@@ -14471,19 +14494,28 @@ HELPS.factory = {
   ],
   flags: [
     ["--workspace SLUG", "the workspace (default: the one from ghosty use)"],
-    ["--room R", "ls: only that room's runs (#slug or name)"],
+    ["--repo OWNER/REPO", "run: the repo; it goes to the room connected to it. stats: only that repo"],
+    ["--wait", "run: wait until the run needs you (plan to approve, a decision, PR to merge) or ends; prints the next command"],
+    ["--timeout S", "run --wait / watch: seconds to wait (default 1800); exit 1 when it runs out"],
+    ["--thread ID", "watch: the thread run gave you, before @plan has created the run"],
+    ["--plan-version N", "approve: the plan version you read (runs show <run> --full); a newer one is rejected"],
+    ["--note T", "changes: what to change in the plan (or why to replan after an escalation). approve after an escalation: what @build must fix"],
+    ["--check-scope T", "approve/changes: the only thing @check reviews on the next loop (runs advise proposes it); anything new goes as a note, not a finding"],
+    ["--skip-preview", "merge: merge without the preview the plan asked for (logged)"],
+    ["--create", "rooms connect: create the room if it doesn't exist"],
+    ["--private", "rooms connect --create: make the new room private (only you, then whoever you add)"],
+    ["--room R", "rooms connect/disconnect: the room (slug or name). run: that room instead of finding it by --repo. ls: only that room's runs (#slug or name)"],
     ["--status S", "ls: only that stage (planning, building, checking, pr_review, merged\u2026)"],
     ["--limit N", "ls: how many (default 30)"],
-    ["--full", "show: print the current plan"],
+    ["--full", "show: print the current plan. rooms ls: also rooms without a repo"],
     ["--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)"]
+    ["--yes", "rename, approve, changes, merge: 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 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. First it checks the approved plan's criteria against the evidence: approved without the preview a criterion asked for, merged without preview, smoke failed on the merged commit, or a CI criterion with CI none \u2192 approved_unmet_criterion, above any stuck pattern. 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."],
+  examples: ["ghosty factory rooms connect blissito/ghosty-studio --room studio --create --workspace business", 'ghosty factory run "Add a COLLABORATOR role: invited by room, lands in the room, no personal agent. Done when an invite to #factory logs in straight there" --repo blissito/ghosty-studio --wait --workspace business', "ghosty factory runs approve 31 --plan-version 2 --workspace business", "ghosty factory runs watch 31 --workspace business", "ghosty factory runs merge 31 --workspace business", "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 advise 115 --workspace business", "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: ["rooms connect checks that YOUR GitHub App installation sees the repo (if not, it gives you the link to grant access) and tells you how ready the repo is for agents (levels 1\u20133 and what's missing). Any member can connect; only whoever connected it, or the owner, can disconnect. Logged as factory.room_connect / factory.room_disconnect.", "run posts \xAB@plan <your text>\xBB in the room under YOUR name, like typing it in Teams: the same plan, approvals and card. Write it like a ticket: the goal, why, and how you'll know it's done. Any member can run, approve, ask for changes and merge; each one is logged (factory.run, factory.run_approve\u2026).", "card brings the run's live card down to the bottom of its thread; the old one stays as a still footprint linking to the live one. The roles can do it too (factory_card).", "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. First it checks the approved plan's criteria against the evidence: approved without the preview a criterion asked for, merged without preview, smoke failed on the merged commit, or a CI criterion with CI none \u2192 approved_unmet_criterion, above any stuck pattern. A healthy run doesn't call the model. When a run closes unhealthy, the room gets this summary in its thread.", "advise: for an ESCALATED run, what to do \u2014 let @build fix it or redo the plan \u2014 with the note for @build point by point (each one cites the finding or plan step behind it) and what @check should review. It compares @check's findings against the signed plan. Nothing is applied: it prints the exact approve/changes command. show tells you why it was escalated.", "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) {
@@ -15488,11 +15520,134 @@ var money = (n) => n === null || n === void 0 ? "\u2014" : `$${n.toFixed(2)}`;
 var mins = (n) => n === null || n === void 0 ? "\u2014" : n >= 120 ? `${(n / 60).toFixed(1)} h` : `${n} min`;
 var hhmm = (iso) => new Date(iso).toLocaleTimeString("es-MX", { hour: "2-digit", minute: "2-digit", hour12: false });
 var short3 = (s2) => (s2 ?? "").slice(0, 16).replace("T", " ");
+async function roomsCmd(ws, verb, repo, v) {
+  const path = `/api/v2/workspaces/${enc16(ws)}/factory/rooms`;
+  if (!verb || verb === "ls" || verb === "list") {
+    const r2 = await api(path);
+    const rows = r2.rooms.filter((x) => x.repos.length || v.full).map((x) => ({ room: `#${x.slug}`, repos: x.repos.join(", ") || dim("\u2014"), factory: x.factory ? lavender(t("yes", "s\xED")) : dim("\u2014"), private: x.private ? t("yes", "s\xED") : "" }));
+    return out(
+      r2,
+      () => [
+        rows.length ? table(rows, ["room", "repos", "factory", "private"]) : dim(t(`No room in ${r2.workspace} has a repo yet.`, `Ning\xFAn room de ${r2.workspace} tiene repo todav\xEDa.`)),
+        ...r2.factoryInstalled ? [] : [red(t("The Software Factory isn't installed in this workspace: rooms with repos won't get @plan/@build/@check until the owner installs it in Teams \u2192 /factory.", "La Software Factory no est\xE1 instalada en este espacio: los rooms con repo no tendr\xE1n @plan/@build/@check hasta que el due\xF1o la instale en Teams \u2192 /factory."))],
+        dim(t(`Connect one: ghosty factory rooms connect owner/repo --room R [--create] --workspace ${r2.workspace}`, `Conecta uno: ghosty factory rooms connect due\xF1o/repo --room R [--create] --workspace ${r2.workspace}`))
+      ].join("\n")
+    );
+  }
+  if (verb !== "connect" && verb !== "disconnect") throw usage(t(`Unknown rooms subcommand: ${verb}.`, `Subcomando de rooms desconocido: ${verb}.`), "ghosty factory rooms ls | connect <owner/repo> --room R [--create] [--private] | disconnect <owner/repo> --room R --yes");
+  if (!repo) throw usage(t("Missing the repo.", "Falta el repo."), `ghosty factory rooms ${verb} owner/repo --room R --workspace ${ws}`);
+  if (!v.room) throw usage(t("Which room?", "\xBFQu\xE9 room?"), t("Add --room NAME (with --create it's made if missing).", "Agrega --room NOMBRE (con --create se crea si no existe)."));
+  if (verb === "disconnect") {
+    const retry = `ghosty factory rooms disconnect ${repo} --room ${v.room} --workspace ${ws}`;
+    requireYesIfHeadless(v.yes, retry);
+    await confirm(t(`Disconnect ${repo} from #${v.room}?`, `\xBFDesconectar ${repo} de #${v.room}?`), { yes: v.yes, retry });
+    const r2 = await api(path, { body: { action: "disconnect", repo, room: v.room } });
+    return out(r2, () => `${lavender("\u2713")} ${t(`${repo} is no longer connected to #${r2.room}.`, `${repo} ya no est\xE1 conectado a #${r2.room}.`)}`);
+  }
+  const r = await api(path, { body: { action: "connect", repo, room: v.room, ...v.create ? { create: true } : {}, ...v.private ? { private: true } : {} } });
+  const rd = r.readiness;
+  return out(
+    r,
+    () => [
+      `${lavender("\u2713")} ${r.created ? t(`Created #${r.room} and connected ${r.repo}`, `Cre\xE9 #${r.room} y le conect\xE9 ${r.repo}`) : t(`Connected ${r.repo} to #${r.room}`, `Conect\xE9 ${r.repo} a #${r.room}`)}`,
+      `  ${dim(r.url)}`,
+      r.factoryInstalled ? `  ${t("factory", "f\xE1brica")}: ${lavender(t("on", "activa"))}${r.ciLabel ? dim(` \xB7 CI ${r.ciLabel}`) : ""}` : `  ${red(t("The Software Factory isn't installed in this workspace (Teams \u2192 /factory).", "La Software Factory no est\xE1 instalada en este espacio (Teams \u2192 /factory)."))}`,
+      rd ? `  ${t("ready for agents", "listo para agentes")}: ${t("level", "nivel")} ${rd.level}/3 (${rd.passed}/${rd.total})${rd.missing.length ? dim(` \xB7 ${t("missing", "falta")}: ${rd.missing.join(", ")}`) : ""}` : "",
+      "",
+      dim(t(`Next: ghosty factory run "\u2026" --repo ${r.repo} --wait --workspace ${r.workspace}`, `Siguiente: ghosty factory run "\u2026" --repo ${r.repo} --wait --workspace ${r.workspace}`))
+    ].filter((l) => l !== "").join("\n")
+  );
+}
+var sleep3 = (ms) => new Promise((ok) => setTimeout(ok, ms));
+var STOPS = /* @__PURE__ */ new Set(["plan_review", "escalated", "pr_review", "done", "cancelled"]);
+var STAGE = {
+  planning: ["@plan is writing the plan", "@plan est\xE1 escribiendo el plan"],
+  plan_review: ["plan ready, waiting for your approval", "plan listo, espera tu firma"],
+  building: ["@build is building", "@build est\xE1 construyendo"],
+  checking: ["@check is reviewing the PR", "@check est\xE1 revisando el PR"],
+  pr_review: ["PR ready, waiting for your merge", "PR listo, espera tu merge"],
+  escalated: ["needs a decision", "necesita una decisi\xF3n"],
+  done: ["merged", "mergeado"],
+  cancelled: ["cancelled", "cancelado"]
+};
+var stage = (s2) => t(...STAGE[s2] ?? [s2, s2]);
+function nextStep(r, ws) {
+  const w = `--workspace ${ws}`;
+  if (r.status === "plan_review")
+    return t(
+      `Read it: ghosty factory runs show ${r.id} --full ${w}
+Approve: ghosty factory runs approve ${r.id} --plan-version ${r.planVersion} ${w}
+Or ask for changes: ghosty factory runs changes ${r.id} --note "\u2026" ${w}`,
+      `L\xE9elo: ghosty factory runs show ${r.id} --full ${w}
+Firma: ghosty factory runs approve ${r.id} --plan-version ${r.planVersion} ${w}
+O pide cambios: ghosty factory runs changes ${r.id} --note "\u2026" ${w}`
+    );
+  if (r.status === "escalated")
+    return t(
+      `Another loop: ghosty factory runs approve ${r.id} ${w}
+Replan: ghosty factory runs changes ${r.id} --note "\u2026" ${w}`,
+      `Otra vuelta: ghosty factory runs approve ${r.id} ${w}
+Replanear: ghosty factory runs changes ${r.id} --note "\u2026" ${w}`
+    );
+  if (r.status === "pr_review") return t(`Merge: ghosty factory runs merge ${r.id} ${w}`, `Mergea: ghosty factory runs merge ${r.id} ${w}`);
+  return null;
+}
+async function waitRun(base, ws, from, timeoutS) {
+  const deadline = Date.now() + timeoutS * 1e3;
+  let runId = from.runId ?? null;
+  let last = "";
+  while (Date.now() < deadline) {
+    if (!runId && from.thread) runId = (await api(`${base}?thread=${from.thread}`)).run?.id ?? null;
+    if (runId) {
+      const { run } = await api(`${base}/${runId}`);
+      if (run.status !== last && !globals.json) console.log(`${dim(hhmm((/* @__PURE__ */ new Date()).toISOString()))} #${run.id} ${stage(run.status)}`);
+      last = run.status;
+      if (STOPS.has(run.status)) return { run, done: true };
+    } else if (!last && !globals.json) {
+      console.log(`${dim(hhmm((/* @__PURE__ */ new Date()).toISOString()))} ${stage("planning")}`);
+      last = "planning";
+    }
+    await sleep3(5e3);
+  }
+  return { run: runId ? (await api(`${base}/${runId}`)).run : null, done: false };
+}
+function waitResult(ws, r, timeoutS, url) {
+  const step = r.run ? nextStep(r.run, ws) : null;
+  out(
+    { workspace: ws, ...r, next: step },
+    () => [
+      r.run ? `${bold(`#${r.run.id} ${r.run.title}`)} ${dim("\xB7")} ${stage(r.run.status)}${r.run.pr ? `
+  PR: ${r.run.pr}` : ""}` : "",
+      r.done ? step ? `
+${step}` : "" : dim(t(`Timed out after ${timeoutS}s; keep watching with ghosty factory runs watch ${r.run?.id ?? "<run>"} --workspace ${ws}${url ? ` or at ${url}` : ""}`, `Pasaron ${timeoutS} s; sigue esperando con ghosty factory runs watch ${r.run?.id ?? "<pedido>"} --workspace ${ws}${url ? ` o en ${url}` : ""}`))
+    ].filter(Boolean).join("\n")
+  );
+  if (!r.done) process.exitCode = 1;
+}
+function timeoutOf(v) {
+  const s2 = Number(v.timeout ?? 1800);
+  if (!Number.isFinite(s2) || s2 <= 0) throw usage(t(`Invalid --timeout: ${v.timeout}.`, `--timeout inv\xE1lido: ${v.timeout}.`), t("Seconds, e.g. --timeout 1800", "Segundos, p. ej. --timeout 1800"));
+  return s2;
+}
 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|why|stats|rename \u2026");
+  if (sub !== "runs" && sub !== "run" && sub !== "rooms") throw usage(t(`Unknown factory subcommand: ${sub ?? "(none)"}.`, `Subcomando de factory desconocido: ${sub ?? "(ninguno)"}.`), 'ghosty factory run "\u2026" | rooms ls|connect|disconnect | runs ls|show|why|advise|stats|rename|watch|approve|changes|merge|card \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)."));
+  if (sub === "rooms") return roomsCmd(ws, verb, ref, v);
   const base = `/api/v2/workspaces/${enc16(ws)}/factory/runs`;
+  if (sub === "run") {
+    const text = verb?.trim();
+    if (!text) throw usage(t("Missing the request.", "Falta el pedido."), `ghosty factory run "\u2026" --repo owner/name [--room R] [--wait] --workspace ${ws}`);
+    if (!v.repo && !v.room) throw usage(t("Which repo?", "\xBFQu\xE9 repo?"), t("Add --repo owner/name (or --room R).", "Agrega --repo owner/nombre (o --room R)."));
+    const timeoutS = timeoutOf(v);
+    const r = await api(base, { method: "POST", body: { text, ...v.repo ? { repo: v.repo } : {}, ...v.room ? { room: v.room } : {} } });
+    const head = `${lavender("\u2713")} ${t(`Sent to @plan in #${r.room}`, `Enviado a @plan en #${r.room}`)} ${dim(`(${t("thread", "hilo")} ${r.threadId})`)}
+  ${dim(r.url)}`;
+    if (!v.wait) return out(r, () => `${head}
+${dim(t(`Wait for the plan: ghosty factory runs watch --thread ${r.threadId} --workspace ${ws}`, `Espera el plan: ghosty factory runs watch --thread ${r.threadId} --workspace ${ws}`))}`);
+    if (!globals.json) console.log(head);
+    return waitResult(ws, await waitRun(base, ws, { thread: r.threadId }, timeoutS), timeoutS, r.url);
+  }
   if (!verb || verb === "ls" || verb === "list") {
     const qs = new URLSearchParams({ ...v.room ? { room: v.room } : {}, ...v.status ? { status: v.status } : {}, ...v.limit ? { limit: v.limit } : {} });
     const r = await api(`${base}?${qs}`);
@@ -15515,6 +15670,12 @@ ${dim(`${t("Detail", "Detalle")}: ghosty factory runs show <run> --workspace ${r
       ].join("\n");
     });
   }
+  if (verb === "watch") {
+    const timeoutS = timeoutOf(v);
+    const thread = Number(v.thread);
+    if (!ref && !(thread > 0)) throw usage(t("Missing run.", "Falta el pedido."), `ghosty factory runs watch <run> | --thread <id> --workspace ${ws}`);
+    return waitResult(ws, await waitRun(base, ws, ref ? { runId: Number(ref.replace(/^#/, "")) } : { thread }, timeoutS), timeoutS);
+  }
   if (!ref) throw usage(t("Missing run.", "Falta el pedido."), `ghosty factory runs ${verb} <run> --workspace ${ws}`);
   const path = `${base}/${enc16(ref.replace(/^#/, ""))}`;
   if (verb === "show" && v.timing) {
@@ -15567,6 +15728,26 @@ ${dim(`${t("Detail", "Detalle")}: ghosty factory runs show <run> --workspace ${r
       ].join("\n");
     });
   }
+  if (verb === "advise") {
+    const id = Number(ref.replace(/^#/, ""));
+    const { advice: a, workspace } = await api(`${path}/advise`, { body: {} });
+    const apply = a.decision === "fix" ? `ghosty factory runs approve ${id} --note ${JSON.stringify(a.note)}${a.checkScope ? ` --check-scope ${JSON.stringify(a.checkScope)}` : ""} --workspace ${workspace}` : `ghosty factory runs changes ${id} --note ${JSON.stringify(a.note)} --workspace ${workspace}`;
+    return out({ workspace, advice: a, apply }, () => {
+      const conf = { high: t("high", "alta"), medium: t("medium", "media"), low: t("low", "baja") }[a.confidence] ?? a.confidence;
+      return [
+        `${bold(`#${id}`)} ${bold(a.decision === "fix" ? t("Let @build fix it", "Que @build lo arregle") : t("Redo the plan", "Rehacer el plan"))} ${dim(`\xB7 ${t("confidence", "confianza")} ${conf} \xB7 ${a.model}`)}`,
+        a.why,
+        "",
+        bold(a.decision === "fix" ? t("Note for @build", "Nota para @build") : t("What to change in the plan", "Qu\xE9 cambiar en el plan")),
+        ...a.buildNote.map((p, i) => `  ${i + 1}. ${p.point}
+     ${dim(p.cites)}`),
+        ...a.checkScope && a.decision === "fix" ? ["", bold(t("@check reviews only", "@check revisa s\xF3lo")), `  ${a.checkScope}`] : [],
+        "",
+        dim(t("Nothing was applied. To apply it (edit the note first if you want):", "No se aplic\xF3 nada. Para aplicarla (edita la nota antes si quieres):")),
+        `  ${apply}`
+      ].join("\n");
+    });
+  }
   if (verb === "show") {
     const { run: r } = await api(path);
     const lines = [
@@ -15576,6 +15757,11 @@ ${dim(`${t("Detail", "Detalle")}: ghosty factory runs show <run> --workspace ${r
       `${t("plan", "plan")}: v${r.planVersion}${r.plan ? ` ${r.plan.decision ?? t("pending", "pendiente")}${r.plan.decidedBy ? ` ${t("by", "por")} ${r.plan.decidedBy}` : ""}` : ""} \xB7 ${t("loops", "vueltas")}: ${r.loops} \xB7 ${t("requested by", "pidi\xF3")} ${r.requestedBy}`,
       ...r.plans.map((p) => dim(`  v${p.version} ${p.decision ?? "\u2014"}: ${p.title ?? ""}`)),
       `${t("running", "trabajando")}: ${r.running.length ? r.running.map((x) => `@${x.role} ${dim(`(${x.turn}, ${short3(x.since)})`)}`).join(", ") : dim(t("nobody", "nadie"))}`,
+      ...r.escalation ? [
+        bold(red(r.escalation.blocked ? t("@check stopped it: needs something @build can't do", "@check lo fren\xF3: falta algo que @build no puede dar") : t(`@check stopped it after ${r.escalation.loops} loops`, `@check lo fren\xF3 tras ${r.escalation.loops} vueltas`))),
+        r.escalation.findings,
+        dim(t(`What to do: ghosty factory runs advise ${r.id} --workspace ${ws}`, `Qu\xE9 hacer: ghosty factory runs advise ${r.id} --workspace ${ws}`))
+      ] : [],
       bold(t("Latest events", "\xDAltimos eventos")),
       ...r.events.map((e) => `  ${dim(short3(e.at))} ${e.type}${e.actor ? ` ${dim(e.actor)}` : ""}`),
       ...v.full && r.plan ? ["", bold(t("Current plan", "Plan vigente")), r.plan.markdown] : [dim(t("--full prints the current plan.", "--full imprime el plan vigente."))]
@@ -15594,7 +15780,31 @@ ${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] | why <run> [--refresh] | stats [--since 30d] | rename <run> "title"');
+  if (verb === "approve" || verb === "changes" || verb === "merge" || verb === "card") {
+    const id = Number(ref.replace(/^#/, ""));
+    const note = v.note?.trim() ?? title?.trim();
+    const scope = verb === "approve" || verb === "changes" ? v["check-scope"]?.trim() : void 0;
+    if (verb === "changes" && !note) throw usage(t("Say what to change.", "Di qu\xE9 cambiar."), `ghosty factory runs changes ${id} --note "\u2026" --workspace ${ws}`);
+    const retry = `ghosty factory runs ${verb} ${id}${v["plan-version"] ? ` --plan-version ${v["plan-version"]}` : ""}${note ? ` --note ${JSON.stringify(note)}` : ""}${scope ? ` --check-scope ${JSON.stringify(scope)}` : ""} --workspace ${ws}`;
+    if (verb !== "card") {
+      requireYesIfHeadless(v.yes, retry);
+      const cur = (await api(`${base}/${id}`)).run;
+      const what = { approve: t(`Approve #${id} (plan v${cur.planVersion})`, `\xBFFirmar el #${id} (plan v${cur.planVersion})`), changes: t(`Ask for changes on #${id}`, `\xBFPedir cambios en el #${id}`), merge: t(`Merge the PR of #${id} (${cur.pr ?? "\u2014"})`, `\xBFMergear el PR del #${id} (${cur.pr ?? "\u2014"})`) }[verb];
+      await confirm(`${what}?`, { yes: v.yes, retry });
+    }
+    const r = await api(`${base}/${id}/act`, {
+      body: { action: verb, ...v["plan-version"] ? { version: Number(v["plan-version"]) } : {}, ...note ? { note } : {}, ...scope ? { checkScope: scope } : {}, ...v["skip-preview"] ? { skipPreview: true } : {} }
+    });
+    const msg = {
+      approve: t(`#${id} approved: ${stage(r.status)}.`, `#${id} firmado: ${stage(r.status)}.`),
+      changes: t(`#${id}: changes sent to @plan.`, `#${id}: cambios enviados a @plan.`),
+      merge: r.queued ? t(`#${id}: merge queued, it goes in when CI passes.`, `#${id}: merge en cola, entra cuando pase el CI.`) : t(`#${id} merged.`, `#${id} mergeado.`),
+      card: t(`#${id}: the card is at the bottom of its thread again.`, `#${id}: la tarjeta volvi\xF3 al final de su hilo.`)
+    }[verb];
+    return out(r, () => `${lavender("\u2713")} ${msg}${verb === "approve" || verb === "changes" ? `
+${dim(t(`Follow it: ghosty factory runs watch ${id} --workspace ${ws}`, `S\xEDguelo: ghosty factory runs watch ${id} --workspace ${ws}`))}` : ""}`);
+  }
+  throw usage(t(`Unknown runs subcommand: ${verb}.`, `Subcomando de runs desconocido: ${verb}.`), 'ghosty factory runs ls | show <run> [--timing] | why <run> [--refresh] | advise <run> | stats [--since 30d] | rename <run> "title" | watch <run> | approve <run> --plan-version N [--note "\u2026"] [--check-scope "\u2026"] | changes <run> --note "\u2026" | merge <run> | card <run>');
 }
 async function agentsByHandle(handle, workspace) {
   const qs = new URLSearchParams({ handle, ...workspace ? { workspace } : {} });
@@ -15971,7 +16181,9 @@ ${bold("Workspaces")}  ${dim("(changing them: Ghosty staff)")}
   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]
   settings ls|set|unset <KEY> [value]         Platform switches (staff): who answers /c without an account, native subagents\u2026   [+id/-id edits a list]
   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|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]
+  factory rooms ls|connect|disconnect         Set up the factory for a repo without opening Teams: create a room and connect the repo to it   [connect owner/repo --room R --create]
+  factory run "\u2026" --repo o/n [--wait]          Hand a request to the Software Factory from the terminal (@plan plans, @build builds, @check reviews); --wait returns when you have to decide   [runs watch|approve|changes|merge|card <run>]
+  factory runs ls|show|why|advise|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, what to do when it's escalated, 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)
@@ -16167,7 +16379,9 @@ ${bold("Espacios")}  ${dim("(cambiarlos: staff de Ghosty)")}
   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]
   settings ls|set|unset <CLAVE> [valor]       Perillas de la plataforma (staff): qui\xE9n atiende /c sin cuenta, subagentes nativos\u2026   [+id/-id edita una lista]
   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|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]
+  factory rooms ls|connect|disconnect         Deja lista la f\xE1brica de un repo sin abrir Teams: crea un room y con\xE9ctale el repo   [connect due\xF1o/repo --room R --create]
+  factory run "\u2026" --repo o/n [--wait]          P\xEDdele algo a la Software Factory desde la terminal (@plan planea, @build construye, @check revisa); --wait regresa cuando te toca decidir   [runs watch|approve|changes|merge|card <pedido>]
+  factory runs ls|show|why|advise|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, qu\xE9 hacer si se escal\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)
@@ -16579,6 +16793,11 @@ async function main() {
       teams: { type: "string" },
       wait: { type: "boolean" },
       timeout: { type: "string" },
+      "plan-version": { type: "string" },
+      "check-scope": { type: "string" },
+      thread: { type: "string" },
+      private: { type: "boolean" },
+      "skip-preview": { type: "boolean" },
       owner: { type: "string" },
       cursor: { type: "string" },
       user: { type: "string" },
@@ -16626,7 +16845,7 @@ async function main() {
   const tokens = splitTokens(pos, v);
   globals.token = tokens.session;
   globals.profile = v.profile;
-  if (v.version) return out({ version: "0.71.0" }, () => "0.71.0");
+  if (v.version) return out({ version: "0.74.0" }, () => "0.74.0");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -16819,7 +17038,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.71.0").catch(() => null);
+var notice = updateNotice("0.74.0").catch(() => null);
 main().then(
   async () => {
     const n = await notice;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghostystudio/cli",
-  "version": "0.71.0",
+  "version": "0.74.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": {