agent-cloud-kit 1.0.0-rc.1 → 1.0.0-rc.3

package/dist/installers.js

@@ -123,7 +123,7 @@ async function nodeExpectedHash(run, env, dir, version, file) {
     await run("curl", ["-fsSL", "-o", path, "--", url], { env, timeoutMs: TOOL_INSTALL_TIMEOUT_MS });
     const hash = parseShasums(readFileSync(path, "utf8"), file);
     if (!hash)
-        throw new Error(`${file} is not listed in ${NODE_SHASUMS_FILE}`);
+        throw new Error(`${file} no aparece en ${NODE_SHASUMS_FILE}`);
     return hash;
 }
 /**
@@ -138,7 +138,7 @@ async function nodeExpectedHash(run, env, dir, version, file) {
 export function nodeArch(arch) {
     const mapped = NODE_ARCHS[arch];
     if (!mapped)
-        throw new Error(`unsupported architecture for node: ${arch}`);
+        throw new Error(`arquitectura no soportada para node: ${arch}`);
     return mapped;
 }
 /**
@@ -153,7 +153,7 @@ export function nodeArch(arch) {
  */
 export function assertVersion(tool, version) {
     if (!VERSION_PATTERN.test(version))
-        throw new Error(`invalid version for ${tool}: ${version}`);
+        throw new Error(`versión inválida para ${tool}: ${version}`);
 }
 /**
  * Tells whether a version is safe to use.
@@ -254,7 +254,7 @@ export function curlNodeIndex(run, env) {
             await run("curl", ["-fsSL", "--max-time", NODE_INDEX_TIMEOUT_SECONDS, "-o", file, "--", NODE_INDEX_URL], { env });
             const parsed = JSON.parse(readFileSync(file, "utf8"));
             if (!Array.isArray(parsed))
-                throw new Error("the node release index is not a list");
+                throw new Error("el índice de versiones de node no es una lista");
             return parsed.filter((r) => typeof r === "object" && r !== null && typeof r.version === "string" && (r.lts === false || typeof r.lts === "string"));
         }
         finally {
@@ -283,7 +283,7 @@ export async function resolveVersions(versions, fetchIndex) {
     const result = await step(`node ${requested}`, async () => {
         exact = resolveNodeVersion(requested, await fetchIndex());
         if (!exact)
-            throw new Error(`no node release matches ${requested}`);
+            throw new Error(`ninguna versión de node coincide con ${requested}`);
     });
     if (!exact)
         return { resolved, results: [result] };
@@ -403,7 +403,7 @@ export async function installTools(versions, toolsDir, run, env) {
         }
         if (tool === "node" && !NODE_EXACT.test(version)) {
             results.push(await step(`${tool} ${version}`, async () => {
-                throw new Error(`node ${version} must be resolved to an exact version first`);
+                throw new Error(`node ${version} debe resolverse primero a una versión exacta`);
             }));
             continue;
         }

package/dist/launcher.js

@@ -58,7 +58,7 @@ export function planSetup(repos, current, read) {
     return repos.map((repo) => {
         const { config, errors } = read(repo);
         if (!config)
-            return { repo, action: "skip", reason: errors.length ? errors.join("; ") : `no ${CONFIG_FILE}` };
+            return { repo, action: "skip", reason: errors.length ? errors.join("; ") : `no hay ${CONFIG_FILE}` };
         if (config.version === current)
             return { repo, action: "run", version: current };
         return { repo, action: "relaunch", version: config.version };

package/dist/manual.js

@@ -37,7 +37,7 @@ const HOW_IT_WORKS = [
     "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 abre una sesión nueva.",
+    "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");
 /**
  * Extracts the host of an apt repo URL.
@@ -205,7 +205,7 @@ export function mergeManual(existing, block) {
 export function writeManual(repo, packageVersion) {
     const { config, errors } = readConfig(repo);
     if (!config)
-        throw new Error(errors[0] ?? `${CONFIG_FILE} not found; run init first`);
+        throw new Error(errors[0] ?? `no existe ${CONFIG_FILE}; corre init primero`);
     const file = join(repo, MANUAL_FILE);
     const existing = existsSync(file) ? readFileSync(file, "utf8") : undefined;
     const block = renderManual({ config, packageVersion, notes: resolveNotes(repo, config.notes) });

package/dist/prepare/banner.js

@@ -0,0 +1,130 @@
+/**
+ * @file The screen `prepare` shows before opening Claude Code: a small cloud, what will happen and
+ * what the user has to do, in a few colored lines.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/** Script of claude-repo-guard that opens Claude without sandbox nor permission prompts. */
+export const FREE_SCRIPT = "claude:free";
+/**
+ * Wraps a text in an ANSI code when color is on.
+ *
+ * @param on - Whether color is on.
+ * @param code - SGR code, like `36` for cyan.
+ * @param text - Text.
+ * @returns The text, colored or not.
+ * @example
+ * paint(false, "36", "a"); // "a"
+ */
+function paint(on, code, text) {
+    return on ? `\x1b[${code}m${text}\x1b[0m` : text;
+}
+/**
+ * Renders the screen shown before opening Claude Code (without the Enter line, which the caller
+ * asks).
+ *
+ * @param input - Place, mode and color.
+ * @returns The lines.
+ * @example
+ * renderBanner({ place: "pr", free: false, color: false })[2]; // "     .-(    ).     Ahora se abre Claude Code"
+ */
+export function renderBanner(input) {
+    const c = (code, text) => paint(input.color, code, text);
+    const cloud = (text) => c("36", text);
+    const step = (n, text) => `   ${c("1;35", String(n))}  ${text}`;
+    const after = input.place === "pr" ? "prepare hace commit, push y PR" : "quedan los cambios sin commit";
+    const lines = [
+        "",
+        cloud("        .--."),
+        `${cloud("     .-(    ).")}     ${c("1", "Ahora se abre Claude Code")}`,
+        `${cloud("    (___.__)__)")}    ${c("2", "con la skill cloud-ready")}`,
+        "",
+        step(1, "Claude revisa el repo y te propone cómo prepararlo para la nube"),
+        step(2, "Responde sus preguntas"),
+        step(3, `Cuando diga ${c("1", "configure terminó")}, sal con ${c("1;33", "/exit")} ${c("2", `→ ${after}`)}`),
+    ];
+    if (input.free)
+        lines.push("", c("2", `   Se abre con ${FREE_SCRIPT} (sin sandbox ni preguntas de permisos): el repo usa claude-repo-guard`));
+    lines.push("");
+    return lines;
+}
+/**
+ * The line asked after the banner.
+ *
+ * @param color - Whether to use ANSI colors.
+ * @returns The text.
+ * @example
+ * enterLine(false); // "   ⏎ Enter abre Claude Code · Ctrl+C cancela "
+ */
+export function enterLine(color) {
+    return `   ${paint(color, "1;32", "⏎ Enter")} abre Claude Code ${paint(color, "2", "· Ctrl+C cancela")} `;
+}
+/** Config file claude-repo-guard installs; the free mode is used only when it is there. */
+const GUARD_CONFIG = ".claude/repo-guard.config.json";
+/**
+ * Tells whether the repo uses claude-repo-guard and has its `claude:free` script. Both are
+ * required: the free mode drops the sandbox and the permission prompts, so a script with that
+ * name alone is not enough.
+ *
+ * @param repo - Repo root.
+ * @returns True when the guard config exists and `package.json` has the script.
+ * @example
+ * hasFreeScript("/home/u/app"); // true
+ */
+export function hasFreeScript(repo) {
+    const file = join(repo, "package.json");
+    if (!existsSync(file) || !existsSync(join(repo, GUARD_CONFIG)))
+        return false;
+    try {
+        const scripts = JSON.parse(readFileSync(file, "utf8")).scripts;
+        return typeof scripts?.[FREE_SCRIPT] === "string";
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The command that opens Claude with a prompt: the repo's `claude:free` script through its package
+ * manager, or `claude` itself.
+ *
+ * @param repo - Repo root.
+ * @param prompt - First prompt.
+ * @returns Command and arguments.
+ * @example
+ * claudeCommand("/home/u/app", "/cloud-ready configure"); // { cmd: "npm", args: ["run", "claude:free", "--", "/cloud-ready configure"] }
+ */
+export function claudeCommand(repo, prompt) {
+    if (!hasFreeScript(repo))
+        return { cmd: "claude", args: [prompt] };
+    const manager = packageManager(repo);
+    if (manager === "npm")
+        return { cmd: "npm", args: ["run", FREE_SCRIPT, "--", prompt] };
+    return { cmd: manager, args: ["run", FREE_SCRIPT, prompt] };
+}
+/** Lockfiles that tell the package manager, checked in order. */
+const LOCKFILES = [
+    ["pnpm-lock.yaml", "pnpm"],
+    ["bun.lock", "bun"],
+    ["bun.lockb", "bun"],
+    ["yarn.lock", "yarn"],
+];
+/**
+ * The repo's package manager: `packageManager` in `package.json`, else the lockfile, else npm.
+ *
+ * @param repo - Repo root.
+ * @returns `npm`, `pnpm`, `yarn` or `bun`.
+ * @example
+ * packageManager("/home/u/app"); // "pnpm"
+ */
+function packageManager(repo) {
+    try {
+        const field = JSON.parse(readFileSync(join(repo, "package.json"), "utf8")).packageManager;
+        const name = typeof field === "string" ? field.split("@")[0] : undefined;
+        if (name === "npm" || name === "pnpm" || name === "yarn" || name === "bun")
+            return name;
+    }
+    catch {
+        // NOTE: no readable package.json; fall back to the lockfile.
+    }
+    return LOCKFILES.find(([file]) => existsSync(join(repo, file)))?.[1] ?? "npm";
+}

package/dist/prepare/detect.js

@@ -4,26 +4,25 @@
 /** Flag `claude` must advertise in its help to launch cloud sessions. */
 const CLOUD_FLAG = "--cloud";
 /**
- * Checks that `prepare` can run.
+ * Checks that `prepare` (or `verify`) can run.
  *
  * @param probe What was observed about the environment.
- * @returns Problems in English, in a fixed order; empty when everything is fine.
+ * @param command Command named in the messages.
+ * @returns Problems in Spanish, in a fixed order; empty when everything is fine.
  * @example
- * preflight({ isTty: false, hasOrigin: true, clean: true }); // ["prepare needs an interactive terminal", ...]
+ * preflight({ isTty: false, hasOrigin: true }); // ["prepare necesita una terminal interactiva", ...]
  */
-export function preflight(probe) {
+export function preflight(probe, command = "prepare") {
     const problems = [];
     if (!probe.isTty)
-        problems.push("prepare needs an interactive terminal");
+        problems.push(`${command} necesita una terminal interactiva (corre el comando directamente en tu terminal)`);
     if (probe.gitRoot === undefined)
-        problems.push("not inside a git repository");
+        problems.push(`esto no es un repositorio git; corre ${command} dentro del repo`);
     if (!probe.hasOrigin)
-        problems.push("the repository has no 'origin' remote");
-    if (!probe.clean)
-        problems.push("the working tree has uncommitted changes; commit or stash them first");
+        problems.push(`el repositorio no tiene el remoto 'origin'; ${command} necesita subir una rama a GitHub`);
     if (probe.claudeHelp === undefined)
-        problems.push("claude is not installed or not on the PATH");
+        problems.push(`claude no está instalado o no está en el PATH; instala Claude Code y vuelve a correr ${command}`);
     else if (!probe.claudeHelp.includes(CLOUD_FLAG))
-        problems.push("claude does not support --cloud; update Claude Code");
+        problems.push(`tu versión de claude no soporta --cloud; actualiza Claude Code y vuelve a correr ${command}`);
     return problems;
 }