@ghostystudio/cli 0.55.0 → 0.56.1

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.1"}`, "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.1"}`,
       "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.1"}`
       },
       body: method === "GET" ? void 0 : raw
     });
@@ -12436,14 +12436,23 @@ var HELPS_ES = {
     notes: ["ls dice, de una ya enviada, cu\xE1ntos entreg\xF3 y rechaz\xF3 FCM (del push log, desde el 1-oct).", "--image se publica en img.ghosty.studio (WebP 1200 px). --to vac\xEDo = todos. send sin --at la manda ya (pregunta); --at '' quita la programaci\xF3n.", "--min-version N (versionCode de Android): si la app del tester es m\xE1s vieja, el bot\xF3n dice \xABActualizar\xBB y lanza la actualizaci\xF3n de Play desde la app; '' la quita."]
   },
   sites: {
-    summary: "Sitios est\xE1ticos publicados en EasyBits con la cuenta de casa de Ghosty. ls lista los que publicaron tus agentes; el staff publica los artefactos de Ghosty (demos, landings) como sitios de la casa \u2014 sin due\xF1o, sin caducidad, sin la franja \xABHecha con Ghosty\xBB \u2014 y cambia el slug de cualquier sitio.",
+    summary: "Los sitios que publican tus agentes en <slug>.ghosty.page. En el plan Gratis un sitio se PAUSA tras 30 d\xEDas sin cambios (no se borra nada; vuelve tal cual al fijarlo). \xABSitios fijos\xBB ($49 USD al a\xF1o o $5 USD al mes \u2014 $990 / $99 MXN \u2014, incluye hasta 3 sitios; se suman 3 m\xE1s por el mismo precio) no se pausan y van sin la franja \xABHecha con Ghosty\xBB. El staff adem\xE1s publica los sitios de la casa y cambia el slug de cualquiera.",
     flags: [
       ["--house", "ls (staff): los sitios de la casa en vez de los tuyos"],
+      ["--interval I", "pin: year (default, 2 meses gratis) o month \u2014 el periodo del cobro si hay que pagar"],
+      ["--currency C", "pin: usd (default) o mxn \u2014 la moneda del cobro si hay que pagar"],
+      ["--add-pack", "pin: ya usas tus lugares \u2014 suma 3 m\xE1s (mismo periodo y moneda de tu suscripci\xF3n) y fija \xE9ste"],
+      ["--cancel / --resume", "pins: cancela al final del periodo (los sitios vuelven a Gratis con aviso), o lo deshace"],
       ["--title T", "publish: el nombre del sitio (default: el <title> del HTML o el nombre de la carpeta)"],
       ["--slug S", "publish: el slug de un sitio NUEVO (a-z, 0-9 y guiones, 3\u201360, no reservado)"],
       ["--site X", "publish: actualiza ese sitio de la casa (slug, id o URL) en vez de crear uno"]
     ],
-    notes: ["Una carpeta necesita index.html en la ra\xEDz; se saltan ocultos y node_modules. Topes: 1 MB por archivo, 8 MB y 40 archivos por sitio.", "Sin --site, publish siempre crea un sitio nuevo (los de la casa nunca se buscan por t\xEDtulo).", "Errores de slug: slug_invalid, slug_taken, y slug_unsupported mientras EasyBits no acepte slug (exit 1, no cambia nada)."]
+    notes: [
+      "pin: con lugar libre lo fija al momento; sin suscripci\xF3n imprime una liga de pago con tarjeta (queda fijo al pagar); con todos los lugares ocupados contesta needs_pack (repite con --add-pack).",
+      "unpin, cancelar o un pago fallido nunca pausan de golpe: el sitio vuelve a la regla Gratis (30 d\xEDas desde su \xFAltimo cambio, m\xEDnimo 8 desde hoy, aviso 7 d\xEDas antes).",
+      "Una carpeta necesita index.html en la ra\xEDz; se saltan ocultos y node_modules. Topes: 1 MB por archivo, 8 MB y 40 archivos por sitio.",
+      "Errores de slug: slug_invalid, slug_taken, slug_unsupported (exit 1, no cambia nada)."
+    ]
   },
   spaces: {
     summary: "Espacios: crea uno a tu nombre (prueba), lista los tuyos (o, staff, los de cualquiera) y operaciones del staff de Ghosty \u2014 entrar/salir del espacio de un cliente, cambiar su combo, mover \xABpagado hasta\xBB, renombrar su slug, cambiar de due\xF1o. Cada cambio queda en la bit\xE1cora del espacio.",
@@ -12492,7 +12501,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 +12510,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 +12520,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."
     ]
   }
 };
@@ -13196,16 +13208,32 @@ HELPS.spaces = {
 };
 HELPS.workspaces = HELPS.spaces;
 HELPS.sites = {
-  summary: "Static sites published on EasyBits with Ghosty's house account. ls lists the ones your agents published; staff publish Ghosty's own artifacts (demos, landings) as house sites \u2014 no owner, no expiry, no \xABMade with Ghosty\xBB banner \u2014 and change any site's slug.",
-  usage: ["ghosty sites ls [--house]", "ghosty sites publish <file.html|folder> [--title T] [--slug S] [--site <slug|id>]", "ghosty sites slug <slug|id> <new-slug>"],
+  summary: "Sites your agents publish at <slug>.ghosty.page. On the Free plan a site PAUSES after 30 days without changes (nothing is deleted; it comes back as-is when pinned). \xABPinned sites\xBB ($49 USD/yr or $5 USD/mo \u2014 $990 / $99 MXN \u2014 includes up to 3 sites; add 3 more for the same price) never pause and carry no \xABMade with Ghosty\xBB banner. Staff also publish Ghosty's own house sites and change any site's slug.",
+  usage: [
+    "ghosty sites ls [--house]",
+    "ghosty sites pin <slug|id> [--interval year|month] [--currency usd|mxn] [--add-pack]",
+    "ghosty sites unpin <slug|id>",
+    "ghosty sites pins [--cancel | --resume]",
+    "ghosty sites publish <file.html|folder> [--title T] [--slug S] [--site <slug|id>]",
+    "ghosty sites slug <slug|id> <new-slug>"
+  ],
   flags: [
     ["--house", "ls (staff): Ghosty's house sites instead of yours"],
+    ["--interval I", "pin: year (default, 2 months free) or month \u2014 the billing period if you need to pay"],
+    ["--currency C", "pin: usd (default) or mxn \u2014 the currency charged if you need to pay"],
+    ["--add-pack", "pin: you already use your slots \u2014 add 3 more (same period and currency as your subscription) and pin this one"],
+    ["--cancel / --resume", "pins: cancel at period end (sites go back to Free with notice), or undo it"],
     ["--title T", "publish: the site's name (default: the HTML <title> or the folder name)"],
     ["--slug S", "publish: the slug for a NEW site (a-z, 0-9 and hyphens, 3\u201360, not reserved)"],
     ["--site X", "publish: update that house site (slug, id or URL) instead of creating one"]
   ],
-  examples: ["ghosty sites ls --house", 'ghosty sites publish ./melon.html --title "Gelatina de sand\xEDa" --slug gelatina-de-sandia', "ghosty sites publish ./landing/ --site gelatina-de-sandia", "ghosty sites slug arbol-palpitante gelatina-de-sandia"],
-  notes: ["A folder needs index.html at its root; hidden files and node_modules are skipped. Limits: 1 MB per file, 8 MB and 40 files per site.", "Without --site, publish always creates a new site (house sites are never matched by title).", "Slug errors: slug_invalid, slug_taken, and slug_unsupported while EasyBits does not accept a slug yet (exit 1, nothing changes)."],
+  examples: ["ghosty sites pin tacos-don-pepe", "ghosty sites pin tacos-don-pepe --interval month --currency mxn", "ghosty sites unpin landing-vieja", "ghosty sites pins --cancel", "ghosty sites publish ./landing/ --site gelatina-de-sandia"],
+  notes: [
+    "pin: with a free slot it pins right away; without a subscription it prints a card-payment link (the site is pinned when you pay); with every slot used it answers needs_pack (repeat with --add-pack).",
+    "unpin, cancelling, or a failed payment never pause a site at once: it goes back to the Free rule (30 days since its last change, at least 8 from today, notice 7 days before).",
+    "A folder needs index.html at its root; hidden files and node_modules are skipped. Limits: 1 MB per file, 8 MB and 40 files per site.",
+    "Slug errors: slug_invalid, slug_taken, slug_unsupported (exit 1, nothing changes)."
+  ],
   learn: `${REF}#sitios`
 };
 HELPS.staff = {
@@ -13244,11 +13272,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 +13288,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) {
@@ -14048,17 +14078,51 @@ function titleOf(html) {
   const s2 = m?.[1]?.replace(/\s+/g, " ").trim();
   return s2 || null;
 }
+var PACK = { year: { usd: 49, mxn: 990 }, month: { usd: 5, mxn: 99 } };
+var packPrice = (c, i, lang2) => `$${(PACK[i]?.[c] ?? 0).toLocaleString("en-US")} ${c.toUpperCase()}${lang2 === "es" ? i === "year" ? " al a\xF1o" : " al mes" : i === "year" ? "/yr" : "/mo"}`;
 var kb = (n) => n ? `${Math.max(1, Math.round(n / 1024))} KB` : "";
 var day = (iso) => iso ? iso.slice(0, 10) : "";
 async function sitesCmd(sub, a1, a2, v) {
-  const ex = "ghosty sites publish <file.html|folder> [--title T] [--slug S] [--site <slug|id>] \xB7 ls [--house] \xB7 slug <slug|id> <new-slug>";
+  const ex = "ghosty sites ls [--house] \xB7 pin|unpin <slug|id> \xB7 pins [--cancel|--resume] \xB7 publish <file.html|folder> [--title T] [--slug S] [--site <slug|id>] \xB7 slug <slug|id> <new-slug>";
   switch (sub ?? "ls") {
     case "ls":
     case "list": {
       const r = await api(`/api/v2/sites?scope=${v.house ? "house" : "mine"}`);
-      const rows = r.sites.map((s2) => ({ slug: s2.slug, title: (s2.title ?? "").slice(0, 40), url: s2.url, files: s2.files ?? "", size: kb(s2.bytes), published: day(s2.publishedAt), expires: s2.expiresAt ? day(s2.expiresAt) : t("never", "nunca") }));
+      const state = (s2) => s2.pinned ? t("pinned", "fijado") : s2.status === "paused" ? t("paused", "en pausa") : s2.expiresAt ? t(`pauses ${day(s2.expiresAt)}`, `se pausa ${day(s2.expiresAt)}`) : t("never pauses", "no caduca");
+      const rows = r.sites.map((s2) => ({ slug: s2.slug, title: (s2.title ?? "").slice(0, 40), url: s2.url, files: s2.files ?? "", size: kb(s2.bytes), published: day(s2.publishedAt), state: state(s2) }));
       return out(r, () => `${bold(v.house ? t("House sites", "Sitios de la casa") : t("Your sites", "Tus sitios"))}
-${table(rows, ["slug", "title", "url", "files", "size", "published", "expires"])}`);
+${table(rows, ["slug", "title", "url", "files", "size", "published", "state"])}`);
+    }
+    case "pin": {
+      if (!a1) throw usage(t("Missing the site (slug, id or URL).", "Falta el sitio (slug, id o URL)."), "ghosty sites pin <slug|id> [--currency usd|mxn] [--add-pack]");
+      const r = await api(`/api/v2/sites/${encodeURIComponent(a1)}/pin`, { method: "POST", body: { currency: v.currency === "mxn" ? "mxn" : "usd", interval: v.interval === "month" ? "month" : "year", addPack: v["add-pack"] === true } });
+      return out(r, () => {
+        if (r.status === "checkout") return `${t("Pay with a card here (the site gets pinned when you pay):", "Paga con tarjeta aqu\xED (el sitio queda fijo al pagar):")}
+${bold(r.url)}`;
+        if (r.status === "needs_pack")
+          return `${t(`You already use your ${r.slots.total} pinned sites \xB7 add 3 more (${packPrice(r.currency, r.interval, "en")}):`, `Ya usas tus ${r.slots.total} sitios fijos \xB7 suma 3 m\xE1s (${packPrice(r.currency, r.interval, "es")}):`)} ghosty sites pin ${a1} --add-pack
+${dim(t("or release one: ghosty sites unpin <slug>", "o suelta uno: ghosty sites unpin <slug>"))}`;
+        if (r.status === "already_pinned") return `${lavender("\u2713")} ${t("Already pinned", "Ya estaba fijo")} ${bold(r.url)}`;
+        return `${lavender("\u2713")} ${t("Pinned", "Fijado")} ${bold(r.url)} ${dim(`(${r.slots.used}/${r.slots.total})`)}`;
+      });
+    }
+    case "unpin": {
+      if (!a1) throw usage(t("Missing the site (slug, id or URL).", "Falta el sitio (slug, id o URL)."), "ghosty sites unpin <slug|id>");
+      const r = await api(`/api/v2/sites/${encodeURIComponent(a1)}/pin`, { method: "DELETE" });
+      return out(r, () => `${lavender("\u2713")} ${t("Released", "Suelto")} ${bold(r.url)}
+${dim(r.expiresAt ? t(`Free rule: pauses ${day(r.expiresAt)} unless it changes (notice 7 days before).`, `Regla Gratis: se pausa el ${day(r.expiresAt)} si no cambia (aviso 7 d\xEDas antes).`) : t("Your plan keeps it published.", "Tu plan lo mantiene publicado."))}`);
+    }
+    case "pins": {
+      if (v.cancel || v.resume) {
+        const r2 = await api("/api/v2/sites/pins", { method: "POST", body: { cancel: Boolean(v.cancel) } });
+        return out(r2, () => r2.cancelAtEnd ? `${lavender("\u2713")} ${t(`Cancelled: pinned until ${day(r2.periodEnd)}, then back to Free with notice.`, `Cancelada: fijos hasta el ${day(r2.periodEnd)}; luego vuelven a Gratis con aviso.`)}` : `${lavender("\u2713")} ${t("Resumed.", "Reanudada.")}`);
+      }
+      const r = await api("/api/v2/sites/pins");
+      return out(
+        r,
+        () => r.total ? `${bold(t(`Pinned sites: ${r.used} of ${r.total}`, `Sitios fijos: ${r.used} de ${r.total}`))} ${dim(`${r.status} \xB7 ${r.currency ?? ""} \xB7 ${r.cancelAtEnd ? t("cancels", "se cancela") : t("renews", "renueva")} ${day(r.periodEnd)}`)}
+${table(r.pinned.map((p) => ({ slug: p.slug, title: (p.title ?? "").slice(0, 40), url: p.url, since: day(p.pinnedAt) })), ["slug", "title", "url", "since"])}` : t("No pinned sites. Pin one ($49 USD/yr or $5 USD/mo, includes up to 3 sites): ghosty sites pin <slug>", "Sin sitios fijos. Fija uno ($49 USD al a\xF1o o $5 USD al mes, incluye hasta 3 sitios): ghosty sites pin <slug>")
+      );
     }
     case "publish":
     case "deploy": {
@@ -14125,7 +14189,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 +14209,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");
@@ -14161,6 +14225,7 @@ ${dim(`${t("Detail", "Detalle")}: ghosty factory runs show <run> --workspace ${r
         `${bold(`#${tm.run}`)} ${dim(`\xB7 ${tm.status} \xB7 ${t("loops", "vueltas")} ${tm.loops} \xB7 ${t("red CI", "CI rojo")} ${tm.ciFails}`)} \xB7 ${bold(money(tm.usd))} USD`,
         `${t("clock", "reloj")}: ${mins(c.totalMinutes)} = ${t("working", "trabajando")} ${mins(c.workingMinutes)} \xB7 ${t("waiting for a person", "esperando a una persona")} ${mins(c.waitingHumanMinutes)} \xB7 ${t("other (CI, queues)", "lo dem\xE1s (CI, colas)")} ${mins(c.otherMinutes)}`,
         dim(c.byState.map((b) => `${b.state} ${mins(b.minutes)}`).join(" \u2192 ")),
+        ...tm.missingRoles?.length ? [red(t(`No recorded turn for @${tm.missingRoles.join(", @")}: it was lost (e.g. a gs deploy while it closed).`, `No qued\xF3 registrado el turno de @${tm.missingRoles.join(", @")}: se perdi\xF3 (p. ej. un deploy de gs al cerrarlo).`))] : [],
         ""
       ];
       const rows = tm.steps.map((s2) => ({
@@ -14178,10 +14243,28 @@ ${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 }, () => {
+      const gap = w.incomplete?.length ? red(t(`Incomplete: no recorded turn for @${w.incomplete.join(", @")} (lost, e.g. a deploy while it closed); numbers don't add up.`, `Incompleto: no qued\xF3 registrado el turno de @${w.incomplete.join(", @")} (se perdi\xF3, p. ej. un deploy al cerrarlo); los n\xFAmeros no cuadran.`)) : null;
+      if (gap) return `${bold(`#${w.runId}`)} ${gap}`;
+      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 +14292,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 +14584,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)
@@ -14582,8 +14665,11 @@ ${bold("Support")}  ${dim("(Ghosty staff)")}
   push log --user EMAIL                   Pushes sent to someone and what Apple/Google answered   [--since 2d]
   novedades ls|create|set|test|send|rm    Android app announcements   [--title] [--body] [--image FILE] [--link] [--to] [--min-version N] [--publish] [--at]
 
-${bold("Sites")}  ${dim("(static sites on EasyBits with Ghosty's house account)")}
-  sites ls                                Sites your agents published   [--house: Ghosty's own demos and landings (staff)]
+${bold("Sites")}  ${dim("(sites your agents publish at <slug>.ghosty.page)")}
+  sites ls                                Sites your agents published (live and paused)   [--house: Ghosty's own demos and landings (staff)]
+  sites pin <slug|id>                     Pin it: never pauses, no banner ($49 USD/yr or $5/mo, includes up to 3 sites)   [--interval year|month] [--currency usd|mxn] [--add-pack: 3 more]
+  sites unpin <slug|id>                   Release its slot (back to the Free rule: 30 days + notice)
+  sites pins                              Your pinned-sites subscription and slots   [--cancel | --resume]
   sites publish <file.html|folder>        Publish a house site (staff): no owner, no expiry, no banner   [--title] [--slug S] [--site <slug|id>: update that one]
   sites slug <slug|id> <new-slug>         Change a site's slug (staff)
 
@@ -14665,7 +14751,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)
@@ -14746,8 +14832,11 @@ ${bold("Soporte")}  ${dim("(staff de Ghosty)")}
   push log --user CORREO                  Avisos que se le mandaron a alguien y qu\xE9 contest\xF3 Apple/Google   [--since 2d]
   novedades ls|create|set|test|send|rm    Novedades de la app Android   [--title] [--body] [--image ARCHIVO] [--link] [--to] [--min-version N] [--publish] [--at]
 
-${bold("Sitios")}  ${dim("(sitios est\xE1ticos en EasyBits con la cuenta de casa de Ghosty)")}
-  sites ls                                Sitios que publicaron tus agentes   [--house: demos y landings de Ghosty (staff)]
+${bold("Sitios")}  ${dim("(los sitios que publican tus agentes en <slug>.ghosty.page)")}
+  sites ls                                Sitios que publicaron tus agentes (vivos y en pausa)   [--house: demos y landings de Ghosty (staff)]
+  sites pin <slug|id>                     F\xEDjalo: no se pausa y va sin franja ($49 USD al a\xF1o o $5 al mes, incluye hasta 3 sitios)   [--interval year|month] [--currency usd|mxn] [--add-pack: 3 m\xE1s]
+  sites unpin <slug|id>                   Suelta su lugar (vuelve a la regla Gratis: 30 d\xEDas + aviso)
+  sites pins                              Tu suscripci\xF3n de Sitios fijos y sus lugares   [--cancel | --resume]
   sites publish <archivo.html|carpeta>    Publica un sitio de la casa (staff): sin due\xF1o, sin caducidad, sin franja   [--title] [--slug S] [--site <slug|id>: actualiza \xE9se]
   sites slug <slug|id> <slug-nuevo>       Cambia el slug de un sitio (staff)
 
@@ -14880,6 +14969,10 @@ async function main() {
       slug: { type: "string" },
       site: { type: "string" },
       house: { type: "boolean" },
+      currency: { type: "string" },
+      "add-pack": { type: "boolean" },
+      interval: { type: "string" },
+      cancel: { type: "boolean" },
       on: { type: "boolean" },
       off: { type: "boolean" },
       turns: { type: "string" },
@@ -14926,6 +15019,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 +15157,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.1" }, () => "0.56.1");
   for (const n of normalizeArgs(pos, v)) if (!globals.json) info(dim(n));
   const context = (await readConfig()).workspace;
   if (!explicitToken()?.startsWith("gat_")) {
@@ -15229,7 +15323,7 @@ async function main() {
       throw unknown(cmd, cmd, COMMANDS, "ghosty --help");
   }
 }
-var notice = updateNotice("0.55.0").catch(() => null);
+var notice = updateNotice("0.56.1").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.1",
   "description": "Official Ghosty Studio CLI — configure, test and chat with your agents from the terminal. Built for humans and coding agents.",
   "type": "module",
   "bin": {