agent-cloud-kit 1.0.0-rc.4 → 1.0.0-rc.6

package/dist/manual.js

@@ -5,7 +5,7 @@
 import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { readConfig } from "./config.js";
-import { CONFIG_FILE, OUTPUT_PREFIX, PACKAGE, packageSpec } from "./constants.js";
+import { CONFIG_FILE, PACKAGE, packageSpec } from "./constants.js";
 /** Path of the manual, relative to the repo. */
 export const MANUAL_FILE = "docs/agent-cloud.md";
 /** Marker that opens the generated block. */
@@ -27,18 +27,8 @@ const HTTPS_PREFIX = "https://";
 function setupScript(packageVersion) {
     return `#!/bin/bash\nnpx -y ${packageSpec(packageVersion)} setup`;
 }
-/** The "how it works" section, five lines. */
-const HOW_IT_WORKS = [
-    "## Cómo funciona",
-    "",
-    "1. agent-kitchen instala las herramientas y los ganchos en el repo.",
-    `2. \`${PACKAGE} prepare\` configura el repo con la skill y genera este documento.`,
-    "3. Tú configuras el entorno en claude.ai con lo que indica la siguiente sección.",
-    "4. Una sesión en la nube verifica que el entorno quedó bien.",
-    "5. El PR guarda el resultado.",
-    "",
-    "Este documento se va actualizando. Cuando la skill `cloud-ready`, en local o en la nube, detecta que hace falta un dominio o una variable de entorno nueva, la agrega a `.claude/cloud.json`, regenera este archivo y te lo dice en la sesión. Cuando cambie la sección \"Configurar el entorno en claude.ai\", aplica lo nuevo en claude.ai y vuelve a verificar con `npx agent-cloud-kit verify` desde la rama.",
-].join("\n");
+/** Note at the top: the document grows when the skill finds something new. */
+const UPDATES_NOTE = `> Se actualiza solo cuando la skill \`cloud-ready\` detecta un dominio o una variable nueva. Si cambia, aplícalo en claude.ai y corre \`npx ${PACKAGE} verify\`.`;
 /**
  * Extracts the host of an apt repo URL.
  *
@@ -80,46 +70,30 @@ function allowedHosts(config) {
  */
 export function renderEnvironmentSection(config, packageVersion) {
     const hosts = allowedHosts(config);
+    const code = (items) => items.map((item) => `\`${item}\``).join(", ");
     const lines = [
         "## Configurar el entorno en claude.ai",
         "",
-        "`claude --cloud` usa el entorno que elijas con `/remote-env` en una terminal (queda en tu configuración de usuario). Configura ese entorno en claude.ai/code:",
-        "",
-        "### Network access",
-        "",
-        'Elige **Custom**, marca "Also include default list of common package managers" y agrega estos dominios:',
-        "",
-        ...(hosts.length ? hosts.map((host) => `- ${host}`) : ["ninguno extra"]),
+        "Elige el entorno con `/remote-env` y edítalo en claude.ai/code:",
         "",
-        "### Setup script",
+        `- **Network access:** Custom y marca "Also include default list of common package managers". Dominios extra: ${hosts.length ? code(hosts) : "ninguno"}.`,
+        `- **Variables:** ${config.requiredEnv.length ? `${code(config.requiredEnv)} (solo los nombres; los valores los pones tú)` : "ninguna"}.`,
+        "- **Claude GitHub App:** instalado en el repo, o la sesión no puede pushear.",
+        "- **Setup script:**",
         "",
         "```bash",
         setupScript(packageVersion),
         "```",
-        "",
-        "### Variables de entorno",
-        "",
     ];
-    if (config.requiredEnv.length) {
-        lines.push(...config.requiredEnv.map((name) => `- \`${name}\``));
-        lines.push("", "Solo los nombres; los valores los pones tú en el entorno. Ojo: quien use el entorno puede leerlas, y no llegan al setup script (solo a la sesión).");
-    }
-    else {
-        lines.push("Ninguna.");
-    }
-    lines.push("", "### Claude GitHub App", "", "El Claude GitHub App debe estar instalado en el repo. Sin él, la sesión no puede pushear.");
+    if (config.requiredEnv.length)
+        lines.push("", "> ⚠️ Quien use el entorno puede leer las variables, y no llegan al setup script (solo a la sesión).");
     return lines.join("\n");
 }
-/** The "how to verify" section: what a fresh cloud session checks. */
+/** The "how to verify" section, one line. */
 const VERIFY_SECTION = [
-    "## Verificar el entorno",
-    "",
-    "En una sesión nueva en la nube, revisa esto:",
+    "## Verificar",
     "",
-    `1. \`${PACKAGE} doctor\` muestra todo en \`ok\` y termina con salida 0.`,
-    "2. `node_modules` existe.",
-    "3. Las versiones de `.tool-versions` son las que están instaladas.",
-    `4. Al empezar la sesión no hay líneas \`${OUTPUT_PREFIX.trim()}\` de falla.`,
+    `Corre \`npx ${PACKAGE} verify\` desde la rama subida: abre una sesión en la nube que revisa \`${PACKAGE} doctor\`, las dependencias, las versiones y las variables, y lo reporta en el PR.`,
 ].join("\n");
 /**
  * Resolves the `notes` of the config: the content of the file when it is a relative path to an
@@ -164,8 +138,8 @@ export function renderManual(input) {
     const parts = [
         BEGIN,
         `<!-- Generado por ${PACKAGE} ${input.packageVersion}. No edites entre las marcas. -->`,
-        "# Nube de Claude Code",
-        HOW_IT_WORKS,
+        "# Claude Code en la nube",
+        UPDATES_NOTE,
         renderEnvironmentSection(input.config, input.packageVersion),
         VERIFY_SECTION,
         `## Qué corre en la nube\n\n${notes?.trim() ? notes.trim() : "Nada anotado."}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-cloud-kit",
-  "version": "1.0.0-rc.4",
+  "version": "1.0.0-rc.6",
   "description": "Zero-dependency CLI that prepares Claude Code cloud sessions.",
   "type": "module",
   "license": "MIT",

package/skills/cloud-ready/SKILL.md

@@ -71,14 +71,17 @@ No le pidas al usuario una lista de variables secretas ni de dominios: anota en
    comprueba ni crees scripts de tests nuevos sin aprobación.
 7. **Escribe el archivo de `notes`:** qué correr en la nube (el comando tal como lo corre el
    repo, lo que hay que levantar antes, cuánto tarda y si va en segundo plano), qué no y por qué.
-   Por ejemplo:
+   Va dentro de `docs/agent-cloud.md`, así que sé breve: una viñeta por cosa, marcada con ✅ (corre), ⏳ (hay que levantar algo
+   antes) o ❌ (no corre), sin párrafos. Por ejemplo:
 
    ```markdown
-   En la nube: `npm test` (~1 min). Antes de `npm run test:db`, `docker compose up -d db`
-   (~3 min, en segundo plano). No corre `npm run test:e2e:prod`: pega a una API externa que el
-   entorno no permite.
+   - ✅ `npm test` (~1 min)
+   - ⏳ Antes de `npm run test:db`: `docker compose up -d db` (~3 min, en segundo plano)
+   - ❌ `npm run test:e2e:prod`: pega a una API externa que el entorno no permite
    ```
 
+   Sin tests: `- El repo no tiene tests; en la nube solo se prepara la máquina.`
+
 8. **Si existe `.agents/skills/test-audit/project.md`:** escribe o actualiza su sección "Nube"
    con el mismo resumen; no toques el resto del archivo.
 9. **Corre `agent-cloud-kit manual`** y muéstrale al usuario la sección "Configurar el entorno en