@hoilab/ada-cli 0.84.21 → 0.85.0

package/dist/core/remoto/destino.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destino.d.ts","sourceRoot":"","sources":["../../../src/core/remoto/destino.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;AA6D9D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAyBpD;AAED,gFAA+E;AAC/E,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CASxD","sourcesContent":["/**\n * Parseo de `--remoto <destino>`.\n *\n * Tres esquemas, cada uno con su forma de nombrar \"dónde\": un host SSH, una\n * distro WSL, un contenedor Docker. `ruta` es siempre el directorio de\n * trabajo remoto — el mismo papel que `cwd` cumple en local, y por eso\n * `ejecutor.ts`/`ficheros.ts` lo usan tal cual para resolver rutas relativas.\n *\n * Los mensajes de error son deliberadamente largos: quien los lee es el\n * usuario tecleando el flag a mano, no el modelo.\n */\n\nexport interface DestinoSsh {\n\ttipo: \"ssh\";\n\tusuario?: string;\n\thost: string;\n\tpuerto?: number;\n\truta: string;\n}\n\nexport interface DestinoWsl {\n\ttipo: \"wsl\";\n\tdistro: string;\n\truta: string;\n}\n\nexport interface DestinoDocker {\n\ttipo: \"docker\";\n\tcontenedor: string;\n\truta: string;\n}\n\nexport type Destino = DestinoSsh | DestinoWsl | DestinoDocker;\n\n/** Ruta por defecto cuando el destino no trae una: la home del lado remoto. */\nconst RUTA_POR_DEFECTO = \".\";\n\nfunction separaRuta(resto: string): { cabecera: string; ruta: string } {\n\tconst barra = resto.indexOf(\"/\");\n\tif (barra === -1) return { cabecera: resto, ruta: RUTA_POR_DEFECTO };\n\tconst ruta = resto.slice(barra + 1);\n\treturn { cabecera: resto.slice(0, barra), ruta: ruta.length > 0 ? `/${ruta}` : RUTA_POR_DEFECTO };\n}\n\nfunction parseaSsh(resto: string): DestinoSsh {\n\tif (resto.length === 0) {\n\t\tthrow new Error(\"ssh:// necesita un host: ssh://usuario@host/ruta o ssh://host/ruta\");\n\t}\n\tconst { cabecera, ruta } = separaRuta(resto);\n\tconst arroba = cabecera.indexOf(\"@\");\n\tconst usuario = arroba === -1 ? undefined : cabecera.slice(0, arroba);\n\tif (arroba !== -1 && usuario!.length === 0) {\n\t\tthrow new Error(`ssh://: usuario vacío delante de \"@\" en \"${cabecera}\"`);\n\t}\n\tconst hostYPuerto = arroba === -1 ? cabecera : cabecera.slice(arroba + 1);\n\tconst dosPuntos = hostYPuerto.lastIndexOf(\":\");\n\tconst host = dosPuntos === -1 ? hostYPuerto : hostYPuerto.slice(0, dosPuntos);\n\tif (host.length === 0) {\n\t\tthrow new Error(`ssh://: falta el host en \"${resto}\"`);\n\t}\n\tlet puerto: number | undefined;\n\tif (dosPuntos !== -1) {\n\t\tconst texto = hostYPuerto.slice(dosPuntos + 1);\n\t\tpuerto = Number(texto);\n\t\tif (!Number.isInteger(puerto) || puerto <= 0 || puerto > 65535 || texto.length === 0) {\n\t\t\tthrow new Error(`ssh://: puerto inválido \"${texto}\" en \"${resto}\"`);\n\t\t}\n\t}\n\treturn { tipo: \"ssh\", usuario, host, puerto, ruta };\n}\n\nfunction parseaWsl(resto: string): DestinoWsl {\n\tif (resto.length === 0) {\n\t\tthrow new Error(\"wsl:// necesita una distro: wsl://distro/ruta (ver `wsl -l -v` en Windows)\");\n\t}\n\tconst { cabecera: distro, ruta } = separaRuta(resto);\n\tif (distro.length === 0) {\n\t\tthrow new Error(`wsl://: falta la distro en \"${resto}\"`);\n\t}\n\treturn { tipo: \"wsl\", distro, ruta };\n}\n\nfunction parseaDocker(resto: string): DestinoDocker {\n\tif (resto.length === 0) {\n\t\tthrow new Error(\"docker:// necesita un contenedor: docker://contenedor/ruta (ver `docker ps`)\");\n\t}\n\tconst { cabecera: contenedor, ruta } = separaRuta(resto);\n\tif (contenedor.length === 0) {\n\t\tthrow new Error(`docker://: falta el nombre o id del contenedor en \"${resto}\"`);\n\t}\n\treturn { tipo: \"docker\", contenedor, ruta };\n}\n\n/**\n * Parsea `ssh://…`, `wsl://…` o `docker://…`. Lanza con un mensaje claro si\n * el esquema no es ninguno de los tres o si la parte que sigue no tiene lo\n * mínimo (host, distro o contenedor).\n */\nexport function parseaDestino(texto: string): Destino {\n\tconst t = texto.trim();\n\tif (t.length === 0) {\n\t\tthrow new Error(\n\t\t\t\"--remoto necesita un valor: ssh://usuario@host/ruta, wsl://distro/ruta o docker://contenedor/ruta\",\n\t\t);\n\t}\n\tconst separador = t.indexOf(\"://\");\n\tif (separador === -1) {\n\t\tthrow new Error(\n\t\t\t`--remoto \"${t}\" no tiene esquema. Usa ssh://, wsl:// o docker:// (ejemplo: ssh://usuario@host/ruta)`,\n\t\t);\n\t}\n\tconst esquema = t.slice(0, separador);\n\tconst resto = t.slice(separador + 3);\n\tswitch (esquema) {\n\t\tcase \"ssh\":\n\t\t\treturn parseaSsh(resto);\n\t\tcase \"wsl\":\n\t\t\treturn parseaWsl(resto);\n\t\tcase \"docker\":\n\t\t\treturn parseaDocker(resto);\n\t\tdefault:\n\t\t\tthrow new Error(`--remoto \"${t}\": esquema \"${esquema}\" desconocido. Usa ssh://, wsl:// o docker://`);\n\t}\n}\n\n/** Representación legible para logs y mensajes de error, sin nada sensible. */\nexport function describeDestino(destino: Destino): string {\n\tswitch (destino.tipo) {\n\t\tcase \"ssh\":\n\t\t\treturn `ssh://${destino.usuario ? `${destino.usuario}@` : \"\"}${destino.host}${destino.puerto ? `:${destino.puerto}` : \"\"}${destino.ruta}`;\n\t\tcase \"wsl\":\n\t\t\treturn `wsl://${destino.distro}${destino.ruta}`;\n\t\tcase \"docker\":\n\t\t\treturn `docker://${destino.contenedor}${destino.ruta}`;\n\t}\n}\n"]}

package/dist/core/remoto/destino.js

@@ -0,0 +1,105 @@
+/**
+ * Parseo de `--remoto <destino>`.
+ *
+ * Tres esquemas, cada uno con su forma de nombrar "dónde": un host SSH, una
+ * distro WSL, un contenedor Docker. `ruta` es siempre el directorio de
+ * trabajo remoto — el mismo papel que `cwd` cumple en local, y por eso
+ * `ejecutor.ts`/`ficheros.ts` lo usan tal cual para resolver rutas relativas.
+ *
+ * Los mensajes de error son deliberadamente largos: quien los lee es el
+ * usuario tecleando el flag a mano, no el modelo.
+ */
+/** Ruta por defecto cuando el destino no trae una: la home del lado remoto. */
+const RUTA_POR_DEFECTO = ".";
+function separaRuta(resto) {
+    const barra = resto.indexOf("/");
+    if (barra === -1)
+        return { cabecera: resto, ruta: RUTA_POR_DEFECTO };
+    const ruta = resto.slice(barra + 1);
+    return { cabecera: resto.slice(0, barra), ruta: ruta.length > 0 ? `/${ruta}` : RUTA_POR_DEFECTO };
+}
+function parseaSsh(resto) {
+    if (resto.length === 0) {
+        throw new Error("ssh:// necesita un host: ssh://usuario@host/ruta o ssh://host/ruta");
+    }
+    const { cabecera, ruta } = separaRuta(resto);
+    const arroba = cabecera.indexOf("@");
+    const usuario = arroba === -1 ? undefined : cabecera.slice(0, arroba);
+    if (arroba !== -1 && usuario.length === 0) {
+        throw new Error(`ssh://: usuario vacío delante de "@" en "${cabecera}"`);
+    }
+    const hostYPuerto = arroba === -1 ? cabecera : cabecera.slice(arroba + 1);
+    const dosPuntos = hostYPuerto.lastIndexOf(":");
+    const host = dosPuntos === -1 ? hostYPuerto : hostYPuerto.slice(0, dosPuntos);
+    if (host.length === 0) {
+        throw new Error(`ssh://: falta el host en "${resto}"`);
+    }
+    let puerto;
+    if (dosPuntos !== -1) {
+        const texto = hostYPuerto.slice(dosPuntos + 1);
+        puerto = Number(texto);
+        if (!Number.isInteger(puerto) || puerto <= 0 || puerto > 65535 || texto.length === 0) {
+            throw new Error(`ssh://: puerto inválido "${texto}" en "${resto}"`);
+        }
+    }
+    return { tipo: "ssh", usuario, host, puerto, ruta };
+}
+function parseaWsl(resto) {
+    if (resto.length === 0) {
+        throw new Error("wsl:// necesita una distro: wsl://distro/ruta (ver `wsl -l -v` en Windows)");
+    }
+    const { cabecera: distro, ruta } = separaRuta(resto);
+    if (distro.length === 0) {
+        throw new Error(`wsl://: falta la distro en "${resto}"`);
+    }
+    return { tipo: "wsl", distro, ruta };
+}
+function parseaDocker(resto) {
+    if (resto.length === 0) {
+        throw new Error("docker:// necesita un contenedor: docker://contenedor/ruta (ver `docker ps`)");
+    }
+    const { cabecera: contenedor, ruta } = separaRuta(resto);
+    if (contenedor.length === 0) {
+        throw new Error(`docker://: falta el nombre o id del contenedor en "${resto}"`);
+    }
+    return { tipo: "docker", contenedor, ruta };
+}
+/**
+ * Parsea `ssh://…`, `wsl://…` o `docker://…`. Lanza con un mensaje claro si
+ * el esquema no es ninguno de los tres o si la parte que sigue no tiene lo
+ * mínimo (host, distro o contenedor).
+ */
+export function parseaDestino(texto) {
+    const t = texto.trim();
+    if (t.length === 0) {
+        throw new Error("--remoto necesita un valor: ssh://usuario@host/ruta, wsl://distro/ruta o docker://contenedor/ruta");
+    }
+    const separador = t.indexOf("://");
+    if (separador === -1) {
+        throw new Error(`--remoto "${t}" no tiene esquema. Usa ssh://, wsl:// o docker:// (ejemplo: ssh://usuario@host/ruta)`);
+    }
+    const esquema = t.slice(0, separador);
+    const resto = t.slice(separador + 3);
+    switch (esquema) {
+        case "ssh":
+            return parseaSsh(resto);
+        case "wsl":
+            return parseaWsl(resto);
+        case "docker":
+            return parseaDocker(resto);
+        default:
+            throw new Error(`--remoto "${t}": esquema "${esquema}" desconocido. Usa ssh://, wsl:// o docker://`);
+    }
+}
+/** Representación legible para logs y mensajes de error, sin nada sensible. */
+export function describeDestino(destino) {
+    switch (destino.tipo) {
+        case "ssh":
+            return `ssh://${destino.usuario ? `${destino.usuario}@` : ""}${destino.host}${destino.puerto ? `:${destino.puerto}` : ""}${destino.ruta}`;
+        case "wsl":
+            return `wsl://${destino.distro}${destino.ruta}`;
+        case "docker":
+            return `docker://${destino.contenedor}${destino.ruta}`;
+    }
+}
+//# sourceMappingURL=destino.js.map

package/dist/core/remoto/destino.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destino.js","sourceRoot":"","sources":["../../../src/core/remoto/destino.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAwBH,+EAA+E;AAC/E,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,SAAS,UAAU,CAAC,KAAa,EAAsC;IACtE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACrE,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACpC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC;AAAA,CAClG;AAED,SAAS,SAAS,CAAC,KAAa,EAAc;IAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACvF,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtE,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,OAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,6CAA4C,QAAQ,GAAG,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1E,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC9E,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,GAAG,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,MAA0B,CAAC;IAC/B,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QAC/C,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,GAAG,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtF,MAAM,IAAI,KAAK,CAAC,6BAA4B,KAAK,SAAS,KAAK,GAAG,CAAC,CAAC;QACrE,CAAC;IACF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAAA,CACpD;AAED,SAAS,SAAS,CAAC,KAAa,EAAc;IAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACrD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,GAAG,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAAA,CACrC;AAED,SAAS,YAAY,CAAC,KAAa,EAAiB;IACnD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IACjG,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACzD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,sDAAsD,KAAK,GAAG,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AAAA,CAC5C;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAW;IACrD,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACd,mGAAmG,CACnG,CAAC;IACH,CAAC;IACD,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACd,aAAa,CAAC,uFAAuF,CACrG,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IACrC,QAAQ,OAAO,EAAE,CAAC;QACjB,KAAK,KAAK;YACT,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QACzB,KAAK,KAAK;YACT,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QACzB,KAAK,QAAQ;YACZ,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;QAC5B;YACC,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,eAAe,OAAO,+CAA+C,CAAC,CAAC;IACvG,CAAC;AAAA,CACD;AAED,gFAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAU;IACzD,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,KAAK;YACT,OAAO,SAAS,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC3I,KAAK,KAAK;YACT,OAAO,SAAS,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QACjD,KAAK,QAAQ;YACZ,OAAO,YAAY,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IACzD,CAAC;AAAA,CACD","sourcesContent":["/**\n * Parseo de `--remoto <destino>`.\n *\n * Tres esquemas, cada uno con su forma de nombrar \"dónde\": un host SSH, una\n * distro WSL, un contenedor Docker. `ruta` es siempre el directorio de\n * trabajo remoto — el mismo papel que `cwd` cumple en local, y por eso\n * `ejecutor.ts`/`ficheros.ts` lo usan tal cual para resolver rutas relativas.\n *\n * Los mensajes de error son deliberadamente largos: quien los lee es el\n * usuario tecleando el flag a mano, no el modelo.\n */\n\nexport interface DestinoSsh {\n\ttipo: \"ssh\";\n\tusuario?: string;\n\thost: string;\n\tpuerto?: number;\n\truta: string;\n}\n\nexport interface DestinoWsl {\n\ttipo: \"wsl\";\n\tdistro: string;\n\truta: string;\n}\n\nexport interface DestinoDocker {\n\ttipo: \"docker\";\n\tcontenedor: string;\n\truta: string;\n}\n\nexport type Destino = DestinoSsh | DestinoWsl | DestinoDocker;\n\n/** Ruta por defecto cuando el destino no trae una: la home del lado remoto. */\nconst RUTA_POR_DEFECTO = \".\";\n\nfunction separaRuta(resto: string): { cabecera: string; ruta: string } {\n\tconst barra = resto.indexOf(\"/\");\n\tif (barra === -1) return { cabecera: resto, ruta: RUTA_POR_DEFECTO };\n\tconst ruta = resto.slice(barra + 1);\n\treturn { cabecera: resto.slice(0, barra), ruta: ruta.length > 0 ? `/${ruta}` : RUTA_POR_DEFECTO };\n}\n\nfunction parseaSsh(resto: string): DestinoSsh {\n\tif (resto.length === 0) {\n\t\tthrow new Error(\"ssh:// necesita un host: ssh://usuario@host/ruta o ssh://host/ruta\");\n\t}\n\tconst { cabecera, ruta } = separaRuta(resto);\n\tconst arroba = cabecera.indexOf(\"@\");\n\tconst usuario = arroba === -1 ? undefined : cabecera.slice(0, arroba);\n\tif (arroba !== -1 && usuario!.length === 0) {\n\t\tthrow new Error(`ssh://: usuario vacío delante de \"@\" en \"${cabecera}\"`);\n\t}\n\tconst hostYPuerto = arroba === -1 ? cabecera : cabecera.slice(arroba + 1);\n\tconst dosPuntos = hostYPuerto.lastIndexOf(\":\");\n\tconst host = dosPuntos === -1 ? hostYPuerto : hostYPuerto.slice(0, dosPuntos);\n\tif (host.length === 0) {\n\t\tthrow new Error(`ssh://: falta el host en \"${resto}\"`);\n\t}\n\tlet puerto: number | undefined;\n\tif (dosPuntos !== -1) {\n\t\tconst texto = hostYPuerto.slice(dosPuntos + 1);\n\t\tpuerto = Number(texto);\n\t\tif (!Number.isInteger(puerto) || puerto <= 0 || puerto > 65535 || texto.length === 0) {\n\t\t\tthrow new Error(`ssh://: puerto inválido \"${texto}\" en \"${resto}\"`);\n\t\t}\n\t}\n\treturn { tipo: \"ssh\", usuario, host, puerto, ruta };\n}\n\nfunction parseaWsl(resto: string): DestinoWsl {\n\tif (resto.length === 0) {\n\t\tthrow new Error(\"wsl:// necesita una distro: wsl://distro/ruta (ver `wsl -l -v` en Windows)\");\n\t}\n\tconst { cabecera: distro, ruta } = separaRuta(resto);\n\tif (distro.length === 0) {\n\t\tthrow new Error(`wsl://: falta la distro en \"${resto}\"`);\n\t}\n\treturn { tipo: \"wsl\", distro, ruta };\n}\n\nfunction parseaDocker(resto: string): DestinoDocker {\n\tif (resto.length === 0) {\n\t\tthrow new Error(\"docker:// necesita un contenedor: docker://contenedor/ruta (ver `docker ps`)\");\n\t}\n\tconst { cabecera: contenedor, ruta } = separaRuta(resto);\n\tif (contenedor.length === 0) {\n\t\tthrow new Error(`docker://: falta el nombre o id del contenedor en \"${resto}\"`);\n\t}\n\treturn { tipo: \"docker\", contenedor, ruta };\n}\n\n/**\n * Parsea `ssh://…`, `wsl://…` o `docker://…`. Lanza con un mensaje claro si\n * el esquema no es ninguno de los tres o si la parte que sigue no tiene lo\n * mínimo (host, distro o contenedor).\n */\nexport function parseaDestino(texto: string): Destino {\n\tconst t = texto.trim();\n\tif (t.length === 0) {\n\t\tthrow new Error(\n\t\t\t\"--remoto necesita un valor: ssh://usuario@host/ruta, wsl://distro/ruta o docker://contenedor/ruta\",\n\t\t);\n\t}\n\tconst separador = t.indexOf(\"://\");\n\tif (separador === -1) {\n\t\tthrow new Error(\n\t\t\t`--remoto \"${t}\" no tiene esquema. Usa ssh://, wsl:// o docker:// (ejemplo: ssh://usuario@host/ruta)`,\n\t\t);\n\t}\n\tconst esquema = t.slice(0, separador);\n\tconst resto = t.slice(separador + 3);\n\tswitch (esquema) {\n\t\tcase \"ssh\":\n\t\t\treturn parseaSsh(resto);\n\t\tcase \"wsl\":\n\t\t\treturn parseaWsl(resto);\n\t\tcase \"docker\":\n\t\t\treturn parseaDocker(resto);\n\t\tdefault:\n\t\t\tthrow new Error(`--remoto \"${t}\": esquema \"${esquema}\" desconocido. Usa ssh://, wsl:// o docker://`);\n\t}\n}\n\n/** Representación legible para logs y mensajes de error, sin nada sensible. */\nexport function describeDestino(destino: Destino): string {\n\tswitch (destino.tipo) {\n\t\tcase \"ssh\":\n\t\t\treturn `ssh://${destino.usuario ? `${destino.usuario}@` : \"\"}${destino.host}${destino.puerto ? `:${destino.puerto}` : \"\"}${destino.ruta}`;\n\t\tcase \"wsl\":\n\t\t\treturn `wsl://${destino.distro}${destino.ruta}`;\n\t\tcase \"docker\":\n\t\t\treturn `docker://${destino.contenedor}${destino.ruta}`;\n\t}\n}\n"]}

package/dist/core/remoto/ejecutor.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Ejecuta comandos EN el destino: SSH, Docker o WSL.
+ *
+ * Sin dependencias nuevas: cada transporte es el binario del sistema
+ * (`ssh`, `docker`, `wsl.exe`) invocado con `spawn`, igual que
+ * `createLocalBashOperations` hace con el shell local en `tools/bash.ts`.
+ *
+ * SSH reutiliza conexión con `ControlMaster`: todas las invocaciones pasan el
+ * mismo `ControlPath`, así que OpenSSH abre el túnel una vez y lo comparte.
+ * Docker y WSL no lo necesitan — `docker exec` y `wsl.exe` ya son ligeros por
+ * llamada, y no hay handshake que amortizar.
+ */
+import type { ChildProcess } from "node:child_process";
+import type { BashOperations } from "../tools/bash.ts";
+import { type Destino } from "./destino.ts";
+/**
+ * Comprueba que el binario del transporte existe ANTES de intentar usarlo.
+ *
+ * `spawnSync` con un binario ausente falla en la propia llamada al sistema
+ * (`ENOENT`), sin lanzar el proceso — los argumentos no importan para esta
+ * comprobación, solo si el spawn en sí pudo arrancar.
+ */
+export declare function compruebaBinario(destino: Destino): void;
+/** Comillas simples POSIX, válidas para sh/bash/dash en el lado remoto. */
+export declare function comillaPosix(texto: string): string;
+/** Lanza `comandoRemoto` en el destino y devuelve el proceso hijo crudo (stdio: pipe/pipe/pipe). */
+export declare function lanza(destino: Destino, cwd: string, comandoRemoto: string, opciones?: {
+    stdin?: boolean;
+    env?: NodeJS.ProcessEnv;
+}): ChildProcess;
+/** Ejecuta y espera, acumulando stdout/stderr por separado. Para `ficheros.ts`: comandos cortos, salida completa en memoria. */
+export declare function ejecutaCapturando(destino: Destino, cwd: string, comandoRemoto: string, opciones?: {
+    stdin?: Buffer | string;
+}): Promise<{
+    exitCode: number | null;
+    stdout: Buffer;
+    stderr: Buffer;
+}>;
+/**
+ * `BashOperations` que delega en el destino en vez del shell local.
+ *
+ * Misma forma que `createLocalBashOperations` (señal de aborto, timeout,
+ * streaming por `onData`) para que la tool `bash` no note la diferencia más
+ * allá de dónde corre el comando.
+ */
+export declare function creaBashOperations(destino: Destino): BashOperations;
+/**
+ * Cierra el `ControlMaster` de SSH explícitamente, en vez de esperar los
+ * `ControlPersist` segundos de gracia. Para Docker y WSL no hay nada que
+ * cerrar: cada llamada es un proceso independiente que ya ha terminado.
+ *
+ * ponytail: si `-O exit` falla (el master ya murió, o nunca llegó a abrirse
+ * porque no se ejecutó ningún comando), no es un error — no había nada que
+ * cerrar. El techo real es `ControlPersist`: aunque esta llamada se pierda
+ * (proceso matado con -9), el socket se limpia solo a los
+ * `SSH_CONTROL_PERSIST_S` segundos.
+ */
+export declare function cierraConexion(destino: Destino): Promise<void>;
+//# sourceMappingURL=ejecutor.d.ts.map

package/dist/core/remoto/ejecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ejecutor.d.ts","sourceRoot":"","sources":["../../../src/core/remoto/ejecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,KAAK,OAAO,EAAmB,MAAM,cAAc,CAAC;AAgB7D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQvD;AAED,4EAA2E;AAC3E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAmED,oGAAoG;AACpG,wBAAgB,KAAK,CACpB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GACrD,YAAY,CASd;AAED,gIAAgI;AAChI,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACpC,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAYtE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAoDnE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CASpE","sourcesContent":["/**\n * Ejecuta comandos EN el destino: SSH, Docker o WSL.\n *\n * Sin dependencias nuevas: cada transporte es el binario del sistema\n * (`ssh`, `docker`, `wsl.exe`) invocado con `spawn`, igual que\n * `createLocalBashOperations` hace con el shell local en `tools/bash.ts`.\n *\n * SSH reutiliza conexión con `ControlMaster`: todas las invocaciones pasan el\n * mismo `ControlPath`, así que OpenSSH abre el túnel una vez y lo comparte.\n * Docker y WSL no lo necesitan — `docker exec` y `wsl.exe` ya son ligeros por\n * llamada, y no hay handshake que amortizar.\n */\n\nimport type { ChildProcess } from \"node:child_process\";\nimport { createHash } from \"node:crypto\";\nimport { join } from \"node:path\";\nimport { spawnProcess, spawnProcessSync, waitForChildProcess } from \"../../utils/child-process.ts\";\nimport { killProcessTree } from \"../../utils/shell.ts\";\nimport type { BashOperations } from \"../tools/bash.ts\";\nimport { type Destino, describeDestino } from \"./destino.ts\";\n\n/** Segundos que OpenSSH mantiene el `ControlMaster` vivo sin actividad. Ver `cierraConexion`. */\nconst SSH_CONTROL_PERSIST_S = 30;\n\nfunction binarioDe(destino: Destino): string {\n\tswitch (destino.tipo) {\n\t\tcase \"ssh\":\n\t\t\treturn \"ssh\";\n\t\tcase \"docker\":\n\t\t\treturn \"docker\";\n\t\tcase \"wsl\":\n\t\t\treturn \"wsl.exe\";\n\t}\n}\n\n/**\n * Comprueba que el binario del transporte existe ANTES de intentar usarlo.\n *\n * `spawnSync` con un binario ausente falla en la propia llamada al sistema\n * (`ENOENT`), sin lanzar el proceso — los argumentos no importan para esta\n * comprobación, solo si el spawn en sí pudo arrancar.\n */\nexport function compruebaBinario(destino: Destino): void {\n\tconst bin = binarioDe(destino);\n\tconst r = spawnProcessSync(bin, [\"--version\"], { encoding: \"utf-8\" });\n\tif (r.error && (r.error as NodeJS.ErrnoException).code === \"ENOENT\") {\n\t\tthrow new Error(\n\t\t\t`Falta el binario \\`${bin}\\` para --remoto ${describeDestino(destino)}. Instálalo y vuelve a intentarlo.`,\n\t\t);\n\t}\n}\n\n/** Comillas simples POSIX, válidas para sh/bash/dash en el lado remoto. */\nexport function comillaPosix(texto: string): string {\n\treturn `'${texto.replaceAll(\"'\", `'\\\\''`)}'`;\n}\n\nfunction socketControlMaster(destino: Extract<Destino, { tipo: \"ssh\" }>): string {\n\t// Un socket por usuario+host+puerto, no por proceso: es lo que permite\n\t// reutilizar conexión entre llamadas sucesivas de `bash`/`read`/`write`.\n\t//\n\t// `sockaddr_un.sun_path` tiene un límite de ~104 bytes (macOS) / ~108\n\t// (Linux), y OpenSSH añade un sufijo aleatorio de 17 caracteres a la ruta\n\t// ANTES del bind. `os.tmpdir()` en macOS ya es\n\t// `/var/folders/xx/xxxxxxxx/T/`, así que un `ControlPath` \"legible\" con el\n\t// host de por medio revienta ese límite (visto en producción: \"unix_listener:\n\t// path … too long\"). Un hash corto en `/tmp` (siempre corto en cualquier\n\t// POSIX) lo evita sin dejar de ser estable por destino.\n\tconst clave = `${destino.usuario ?? \"\"}@${destino.host}:${destino.puerto ?? 22}`;\n\tconst hash = createHash(\"sha256\").update(clave).digest(\"hex\").slice(0, 16);\n\treturn join(\"/tmp\", `ada-ssh-${hash}.sock`);\n}\n\n/**\n * Argv para ejecutar `comandoRemoto` (una línea de shell POSIX) en el\n * destino, con `cwd` (ruta remota) como directorio de trabajo.\n */\nfunction argvRemoto(destino: Destino, cwd: string, comandoRemoto: string): { bin: string; args: string[] } {\n\tconst conCd = cwd && cwd !== \".\" ? `cd -- ${comillaPosix(cwd)} && ${comandoRemoto}` : comandoRemoto;\n\tswitch (destino.tipo) {\n\t\tcase \"ssh\": {\n\t\t\tconst objetivo = destino.usuario ? `${destino.usuario}@${destino.host}` : destino.host;\n\t\t\tconst args = [\n\t\t\t\t\"-o\",\n\t\t\t\t\"BatchMode=yes\",\n\t\t\t\t\"-o\",\n\t\t\t\t\"ControlMaster=auto\",\n\t\t\t\t\"-o\",\n\t\t\t\t`ControlPersist=${SSH_CONTROL_PERSIST_S}`,\n\t\t\t\t\"-o\",\n\t\t\t\t`ControlPath=${socketControlMaster(destino)}`,\n\t\t\t];\n\t\t\tif (destino.puerto) args.push(\"-p\", String(destino.puerto));\n\t\t\targs.push(objetivo, conCd);\n\t\t\treturn { bin: \"ssh\", args };\n\t\t}\n\t\tcase \"docker\":\n\t\t\treturn {\n\t\t\t\tbin: \"docker\",\n\t\t\t\targs: [\"exec\", \"-w\", cwd && cwd !== \".\" ? cwd : \"/\", destino.contenedor, \"sh\", \"-c\", comandoRemoto],\n\t\t\t};\n\t\tcase \"wsl\":\n\t\t\treturn {\n\t\t\t\tbin: \"wsl.exe\",\n\t\t\t\targs: [\"-d\", destino.distro, \"--cd\", cwd && cwd !== \".\" ? cwd : \"~\", \"--\", \"sh\", \"-c\", comandoRemoto],\n\t\t\t};\n\t}\n}\n\n/**\n * Igual que `argvRemoto`, pero con el stdin del proceso remoto conectado.\n *\n * `ssh` y `wsl.exe` heredan el stdio que `spawn` les da sin flags extra;\n * `docker exec` no — sin `-i` el contenedor nunca ve lo que se le escribe,\n * y `ficheros.ts` necesita justo eso para `write`/`edit`.\n */\nfunction argvRemotoConStdin(destino: Destino, cwd: string, comandoRemoto: string): { bin: string; args: string[] } {\n\tconst { bin, args } = argvRemoto(destino, cwd, comandoRemoto);\n\tif (destino.tipo !== \"docker\") return { bin, args };\n\treturn { bin, args: [\"exec\", \"-i\", ...args.slice(1)] };\n}\n\n/** Lanza `comandoRemoto` en el destino y devuelve el proceso hijo crudo (stdio: pipe/pipe/pipe). */\nexport function lanza(\n\tdestino: Destino,\n\tcwd: string,\n\tcomandoRemoto: string,\n\topciones?: { stdin?: boolean; env?: NodeJS.ProcessEnv },\n): ChildProcess {\n\tconst { bin, args } = opciones?.stdin\n\t\t? argvRemotoConStdin(destino, cwd, comandoRemoto)\n\t\t: argvRemoto(destino, cwd, comandoRemoto);\n\treturn spawnProcess(bin, args, {\n\t\tstdio: [opciones?.stdin ? \"pipe\" : \"ignore\", \"pipe\", \"pipe\"],\n\t\tenv: opciones?.env ?? process.env,\n\t\twindowsHide: true,\n\t});\n}\n\n/** Ejecuta y espera, acumulando stdout/stderr por separado. Para `ficheros.ts`: comandos cortos, salida completa en memoria. */\nexport async function ejecutaCapturando(\n\tdestino: Destino,\n\tcwd: string,\n\tcomandoRemoto: string,\n\topciones?: { stdin?: Buffer | string },\n): Promise<{ exitCode: number | null; stdout: Buffer; stderr: Buffer }> {\n\tconst child = lanza(destino, cwd, comandoRemoto, { stdin: opciones?.stdin !== undefined });\n\tconst stdoutChunks: Buffer[] = [];\n\tconst stderrChunks: Buffer[] = [];\n\tchild.stdout?.on(\"data\", (d: Buffer) => stdoutChunks.push(d));\n\tchild.stderr?.on(\"data\", (d: Buffer) => stderrChunks.push(d));\n\tif (opciones?.stdin !== undefined) {\n\t\tchild.stdin?.on(\"error\", () => {}); // EPIPE si el remoto cierra antes de tiempo: el exitCode ya cuenta la historia\n\t\tchild.stdin?.end(opciones.stdin);\n\t}\n\tconst exitCode = await waitForChildProcess(child);\n\treturn { exitCode, stdout: Buffer.concat(stdoutChunks), stderr: Buffer.concat(stderrChunks) };\n}\n\n/**\n * `BashOperations` que delega en el destino en vez del shell local.\n *\n * Misma forma que `createLocalBashOperations` (señal de aborto, timeout,\n * streaming por `onData`) para que la tool `bash` no note la diferencia más\n * allá de dónde corre el comando.\n */\nexport function creaBashOperations(destino: Destino): BashOperations {\n\treturn {\n\t\texec: (command, cwd, { onData, signal, timeout, env }) => {\n\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\treject(new Error(\"aborted\"));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\t// `env` (las PI_* de la sesión) llega aquí pensado para un shell\n\t\t\t\t// LOCAL: se lo pasamos al cliente ssh/docker/wsl.exe (le hace falta\n\t\t\t\t// su propio PATH, SSH_AUTH_SOCK…), pero eso NO las mete en el shell\n\t\t\t\t// REMOTO — ssh no reenvía variables salvo que el sshd de destino\n\t\t\t\t// tenga AcceptEnv configurado, que no podemos asumir. Un comando que\n\t\t\t\t// dependa de PI_MODEL, etc. dentro de --remoto no las va a ver.\n\t\t\t\tconst child = lanza(destino, cwd, command, { env });\n\t\t\t\tlet timedOut = false;\n\t\t\t\tlet timeoutHandle: NodeJS.Timeout | undefined;\n\t\t\t\tconst onAbort = () => {\n\t\t\t\t\tif (child.pid) killProcessTree(child.pid);\n\t\t\t\t};\n\t\t\t\tif (timeout !== undefined) {\n\t\t\t\t\ttimeoutHandle = setTimeout(() => {\n\t\t\t\t\t\ttimedOut = true;\n\t\t\t\t\t\tif (child.pid) killProcessTree(child.pid);\n\t\t\t\t\t}, timeout * 1000);\n\t\t\t\t}\n\t\t\t\tchild.stdout?.on(\"data\", onData);\n\t\t\t\tchild.stderr?.on(\"data\", onData);\n\t\t\t\tif (signal) {\n\t\t\t\t\tif (signal.aborted) onAbort();\n\t\t\t\t\telse signal.addEventListener(\"abort\", onAbort, { once: true });\n\t\t\t\t}\n\t\t\t\twaitForChildProcess(child)\n\t\t\t\t\t.then((exitCode) => {\n\t\t\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\t\t\treject(new Error(\"aborted\"));\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (timedOut) {\n\t\t\t\t\t\t\treject(new Error(`timeout:${timeout}`));\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tresolve({ exitCode });\n\t\t\t\t\t})\n\t\t\t\t\t.catch(reject)\n\t\t\t\t\t.finally(() => {\n\t\t\t\t\t\tif (timeoutHandle) clearTimeout(timeoutHandle);\n\t\t\t\t\t\tif (signal) signal.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\t});\n\t\t\t});\n\t\t},\n\t};\n}\n\n/**\n * Cierra el `ControlMaster` de SSH explícitamente, en vez de esperar los\n * `ControlPersist` segundos de gracia. Para Docker y WSL no hay nada que\n * cerrar: cada llamada es un proceso independiente que ya ha terminado.\n *\n * ponytail: si `-O exit` falla (el master ya murió, o nunca llegó a abrirse\n * porque no se ejecutó ningún comando), no es un error — no había nada que\n * cerrar. El techo real es `ControlPersist`: aunque esta llamada se pierda\n * (proceso matado con -9), el socket se limpia solo a los\n * `SSH_CONTROL_PERSIST_S` segundos.\n */\nexport async function cierraConexion(destino: Destino): Promise<void> {\n\tif (destino.tipo !== \"ssh\") return;\n\tconst objetivo = destino.usuario ? `${destino.usuario}@${destino.host}` : destino.host;\n\tconst args = [\"-o\", `ControlPath=${socketControlMaster(destino)}`, \"-O\", \"exit\", objetivo];\n\tawait new Promise<void>((resolve) => {\n\t\tconst child = spawnProcess(\"ssh\", args, { stdio: \"ignore\" });\n\t\tchild.on(\"exit\", () => resolve());\n\t\tchild.on(\"error\", () => resolve());\n\t});\n}\n"]}

package/dist/core/remoto/ejecutor.js

@@ -0,0 +1,225 @@
+/**
+ * Ejecuta comandos EN el destino: SSH, Docker o WSL.
+ *
+ * Sin dependencias nuevas: cada transporte es el binario del sistema
+ * (`ssh`, `docker`, `wsl.exe`) invocado con `spawn`, igual que
+ * `createLocalBashOperations` hace con el shell local en `tools/bash.ts`.
+ *
+ * SSH reutiliza conexión con `ControlMaster`: todas las invocaciones pasan el
+ * mismo `ControlPath`, así que OpenSSH abre el túnel una vez y lo comparte.
+ * Docker y WSL no lo necesitan — `docker exec` y `wsl.exe` ya son ligeros por
+ * llamada, y no hay handshake que amortizar.
+ */
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+import { spawnProcess, spawnProcessSync, waitForChildProcess } from "../../utils/child-process.js";
+import { killProcessTree } from "../../utils/shell.js";
+import { describeDestino } from "./destino.js";
+/** Segundos que OpenSSH mantiene el `ControlMaster` vivo sin actividad. Ver `cierraConexion`. */
+const SSH_CONTROL_PERSIST_S = 30;
+function binarioDe(destino) {
+    switch (destino.tipo) {
+        case "ssh":
+            return "ssh";
+        case "docker":
+            return "docker";
+        case "wsl":
+            return "wsl.exe";
+    }
+}
+/**
+ * Comprueba que el binario del transporte existe ANTES de intentar usarlo.
+ *
+ * `spawnSync` con un binario ausente falla en la propia llamada al sistema
+ * (`ENOENT`), sin lanzar el proceso — los argumentos no importan para esta
+ * comprobación, solo si el spawn en sí pudo arrancar.
+ */
+export function compruebaBinario(destino) {
+    const bin = binarioDe(destino);
+    const r = spawnProcessSync(bin, ["--version"], { encoding: "utf-8" });
+    if (r.error && r.error.code === "ENOENT") {
+        throw new Error(`Falta el binario \`${bin}\` para --remoto ${describeDestino(destino)}. Instálalo y vuelve a intentarlo.`);
+    }
+}
+/** Comillas simples POSIX, válidas para sh/bash/dash en el lado remoto. */
+export function comillaPosix(texto) {
+    return `'${texto.replaceAll("'", `'\\''`)}'`;
+}
+function socketControlMaster(destino) {
+    // Un socket por usuario+host+puerto, no por proceso: es lo que permite
+    // reutilizar conexión entre llamadas sucesivas de `bash`/`read`/`write`.
+    //
+    // `sockaddr_un.sun_path` tiene un límite de ~104 bytes (macOS) / ~108
+    // (Linux), y OpenSSH añade un sufijo aleatorio de 17 caracteres a la ruta
+    // ANTES del bind. `os.tmpdir()` en macOS ya es
+    // `/var/folders/xx/xxxxxxxx/T/`, así que un `ControlPath` "legible" con el
+    // host de por medio revienta ese límite (visto en producción: "unix_listener:
+    // path … too long"). Un hash corto en `/tmp` (siempre corto en cualquier
+    // POSIX) lo evita sin dejar de ser estable por destino.
+    const clave = `${destino.usuario ?? ""}@${destino.host}:${destino.puerto ?? 22}`;
+    const hash = createHash("sha256").update(clave).digest("hex").slice(0, 16);
+    return join("/tmp", `ada-ssh-${hash}.sock`);
+}
+/**
+ * Argv para ejecutar `comandoRemoto` (una línea de shell POSIX) en el
+ * destino, con `cwd` (ruta remota) como directorio de trabajo.
+ */
+function argvRemoto(destino, cwd, comandoRemoto) {
+    const conCd = cwd && cwd !== "." ? `cd -- ${comillaPosix(cwd)} && ${comandoRemoto}` : comandoRemoto;
+    switch (destino.tipo) {
+        case "ssh": {
+            const objetivo = destino.usuario ? `${destino.usuario}@${destino.host}` : destino.host;
+            const args = [
+                "-o",
+                "BatchMode=yes",
+                "-o",
+                "ControlMaster=auto",
+                "-o",
+                `ControlPersist=${SSH_CONTROL_PERSIST_S}`,
+                "-o",
+                `ControlPath=${socketControlMaster(destino)}`,
+            ];
+            if (destino.puerto)
+                args.push("-p", String(destino.puerto));
+            args.push(objetivo, conCd);
+            return { bin: "ssh", args };
+        }
+        case "docker":
+            return {
+                bin: "docker",
+                args: ["exec", "-w", cwd && cwd !== "." ? cwd : "/", destino.contenedor, "sh", "-c", comandoRemoto],
+            };
+        case "wsl":
+            return {
+                bin: "wsl.exe",
+                args: ["-d", destino.distro, "--cd", cwd && cwd !== "." ? cwd : "~", "--", "sh", "-c", comandoRemoto],
+            };
+    }
+}
+/**
+ * Igual que `argvRemoto`, pero con el stdin del proceso remoto conectado.
+ *
+ * `ssh` y `wsl.exe` heredan el stdio que `spawn` les da sin flags extra;
+ * `docker exec` no — sin `-i` el contenedor nunca ve lo que se le escribe,
+ * y `ficheros.ts` necesita justo eso para `write`/`edit`.
+ */
+function argvRemotoConStdin(destino, cwd, comandoRemoto) {
+    const { bin, args } = argvRemoto(destino, cwd, comandoRemoto);
+    if (destino.tipo !== "docker")
+        return { bin, args };
+    return { bin, args: ["exec", "-i", ...args.slice(1)] };
+}
+/** Lanza `comandoRemoto` en el destino y devuelve el proceso hijo crudo (stdio: pipe/pipe/pipe). */
+export function lanza(destino, cwd, comandoRemoto, opciones) {
+    const { bin, args } = opciones?.stdin
+        ? argvRemotoConStdin(destino, cwd, comandoRemoto)
+        : argvRemoto(destino, cwd, comandoRemoto);
+    return spawnProcess(bin, args, {
+        stdio: [opciones?.stdin ? "pipe" : "ignore", "pipe", "pipe"],
+        env: opciones?.env ?? process.env,
+        windowsHide: true,
+    });
+}
+/** Ejecuta y espera, acumulando stdout/stderr por separado. Para `ficheros.ts`: comandos cortos, salida completa en memoria. */
+export async function ejecutaCapturando(destino, cwd, comandoRemoto, opciones) {
+    const child = lanza(destino, cwd, comandoRemoto, { stdin: opciones?.stdin !== undefined });
+    const stdoutChunks = [];
+    const stderrChunks = [];
+    child.stdout?.on("data", (d) => stdoutChunks.push(d));
+    child.stderr?.on("data", (d) => stderrChunks.push(d));
+    if (opciones?.stdin !== undefined) {
+        child.stdin?.on("error", () => { }); // EPIPE si el remoto cierra antes de tiempo: el exitCode ya cuenta la historia
+        child.stdin?.end(opciones.stdin);
+    }
+    const exitCode = await waitForChildProcess(child);
+    return { exitCode, stdout: Buffer.concat(stdoutChunks), stderr: Buffer.concat(stderrChunks) };
+}
+/**
+ * `BashOperations` que delega en el destino en vez del shell local.
+ *
+ * Misma forma que `createLocalBashOperations` (señal de aborto, timeout,
+ * streaming por `onData`) para que la tool `bash` no note la diferencia más
+ * allá de dónde corre el comando.
+ */
+export function creaBashOperations(destino) {
+    return {
+        exec: (command, cwd, { onData, signal, timeout, env }) => {
+            return new Promise((resolve, reject) => {
+                if (signal?.aborted) {
+                    reject(new Error("aborted"));
+                    return;
+                }
+                // `env` (las PI_* de la sesión) llega aquí pensado para un shell
+                // LOCAL: se lo pasamos al cliente ssh/docker/wsl.exe (le hace falta
+                // su propio PATH, SSH_AUTH_SOCK…), pero eso NO las mete en el shell
+                // REMOTO — ssh no reenvía variables salvo que el sshd de destino
+                // tenga AcceptEnv configurado, que no podemos asumir. Un comando que
+                // dependa de PI_MODEL, etc. dentro de --remoto no las va a ver.
+                const child = lanza(destino, cwd, command, { env });
+                let timedOut = false;
+                let timeoutHandle;
+                const onAbort = () => {
+                    if (child.pid)
+                        killProcessTree(child.pid);
+                };
+                if (timeout !== undefined) {
+                    timeoutHandle = setTimeout(() => {
+                        timedOut = true;
+                        if (child.pid)
+                            killProcessTree(child.pid);
+                    }, timeout * 1000);
+                }
+                child.stdout?.on("data", onData);
+                child.stderr?.on("data", onData);
+                if (signal) {
+                    if (signal.aborted)
+                        onAbort();
+                    else
+                        signal.addEventListener("abort", onAbort, { once: true });
+                }
+                waitForChildProcess(child)
+                    .then((exitCode) => {
+                    if (signal?.aborted) {
+                        reject(new Error("aborted"));
+                        return;
+                    }
+                    if (timedOut) {
+                        reject(new Error(`timeout:${timeout}`));
+                        return;
+                    }
+                    resolve({ exitCode });
+                })
+                    .catch(reject)
+                    .finally(() => {
+                    if (timeoutHandle)
+                        clearTimeout(timeoutHandle);
+                    if (signal)
+                        signal.removeEventListener("abort", onAbort);
+                });
+            });
+        },
+    };
+}
+/**
+ * Cierra el `ControlMaster` de SSH explícitamente, en vez de esperar los
+ * `ControlPersist` segundos de gracia. Para Docker y WSL no hay nada que
+ * cerrar: cada llamada es un proceso independiente que ya ha terminado.
+ *
+ * ponytail: si `-O exit` falla (el master ya murió, o nunca llegó a abrirse
+ * porque no se ejecutó ningún comando), no es un error — no había nada que
+ * cerrar. El techo real es `ControlPersist`: aunque esta llamada se pierda
+ * (proceso matado con -9), el socket se limpia solo a los
+ * `SSH_CONTROL_PERSIST_S` segundos.
+ */
+export async function cierraConexion(destino) {
+    if (destino.tipo !== "ssh")
+        return;
+    const objetivo = destino.usuario ? `${destino.usuario}@${destino.host}` : destino.host;
+    const args = ["-o", `ControlPath=${socketControlMaster(destino)}`, "-O", "exit", objetivo];
+    await new Promise((resolve) => {
+        const child = spawnProcess("ssh", args, { stdio: "ignore" });
+        child.on("exit", () => resolve());
+        child.on("error", () => resolve());
+    });
+}
+//# sourceMappingURL=ejecutor.js.map

package/dist/core/remoto/ejecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ejecutor.js","sourceRoot":"","sources":["../../../src/core/remoto/ejecutor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Ejecuta comandos EN el destino: SSH, Docker o WSL.\n *\n * Sin dependencias nuevas: cada transporte es el binario del sistema\n * (`ssh`, `docker`, `wsl.exe`) invocado con `spawn`, igual que\n * `createLocalBashOperations` hace con el shell local en `tools/bash.ts`.\n *\n * SSH reutiliza conexión con `ControlMaster`: todas las invocaciones pasan el\n * mismo `ControlPath`, así que OpenSSH abre el túnel una vez y lo comparte.\n * Docker y WSL no lo necesitan — `docker exec` y `wsl.exe` ya son ligeros por\n * llamada, y no hay handshake que amortizar.\n */\n\nimport type { ChildProcess } from \"node:child_process\";\nimport { createHash } from \"node:crypto\";\nimport { join } from \"node:path\";\nimport { spawnProcess, spawnProcessSync, waitForChildProcess } from \"../../utils/child-process.ts\";\nimport { killProcessTree } from \"../../utils/shell.ts\";\nimport type { BashOperations } from \"../tools/bash.ts\";\nimport { type Destino, describeDestino } from \"./destino.ts\";\n\n/** Segundos que OpenSSH mantiene el `ControlMaster` vivo sin actividad. Ver `cierraConexion`. */\nconst SSH_CONTROL_PERSIST_S = 30;\n\nfunction binarioDe(destino: Destino): string {\n\tswitch (destino.tipo) {\n\t\tcase \"ssh\":\n\t\t\treturn \"ssh\";\n\t\tcase \"docker\":\n\t\t\treturn \"docker\";\n\t\tcase \"wsl\":\n\t\t\treturn \"wsl.exe\";\n\t}\n}\n\n/**\n * Comprueba que el binario del transporte existe ANTES de intentar usarlo.\n *\n * `spawnSync` con un binario ausente falla en la propia llamada al sistema\n * (`ENOENT`), sin lanzar el proceso — los argumentos no importan para esta\n * comprobación, solo si el spawn en sí pudo arrancar.\n */\nexport function compruebaBinario(destino: Destino): void {\n\tconst bin = binarioDe(destino);\n\tconst r = spawnProcessSync(bin, [\"--version\"], { encoding: \"utf-8\" });\n\tif (r.error && (r.error as NodeJS.ErrnoException).code === \"ENOENT\") {\n\t\tthrow new Error(\n\t\t\t`Falta el binario \\`${bin}\\` para --remoto ${describeDestino(destino)}. Instálalo y vuelve a intentarlo.`,\n\t\t);\n\t}\n}\n\n/** Comillas simples POSIX, válidas para sh/bash/dash en el lado remoto. */\nexport function comillaPosix(texto: string): string {\n\treturn `'${texto.replaceAll(\"'\", `'\\\\''`)}'`;\n}\n\nfunction socketControlMaster(destino: Extract<Destino, { tipo: \"ssh\" }>): string {\n\t// Un socket por usuario+host+puerto, no por proceso: es lo que permite\n\t// reutilizar conexión entre llamadas sucesivas de `bash`/`read`/`write`.\n\t//\n\t// `sockaddr_un.sun_path` tiene un límite de ~104 bytes (macOS) / ~108\n\t// (Linux), y OpenSSH añade un sufijo aleatorio de 17 caracteres a la ruta\n\t// ANTES del bind. `os.tmpdir()` en macOS ya es\n\t// `/var/folders/xx/xxxxxxxx/T/`, así que un `ControlPath` \"legible\" con el\n\t// host de por medio revienta ese límite (visto en producción: \"unix_listener:\n\t// path … too long\"). Un hash corto en `/tmp` (siempre corto en cualquier\n\t// POSIX) lo evita sin dejar de ser estable por destino.\n\tconst clave = `${destino.usuario ?? \"\"}@${destino.host}:${destino.puerto ?? 22}`;\n\tconst hash = createHash(\"sha256\").update(clave).digest(\"hex\").slice(0, 16);\n\treturn join(\"/tmp\", `ada-ssh-${hash}.sock`);\n}\n\n/**\n * Argv para ejecutar `comandoRemoto` (una línea de shell POSIX) en el\n * destino, con `cwd` (ruta remota) como directorio de trabajo.\n */\nfunction argvRemoto(destino: Destino, cwd: string, comandoRemoto: string): { bin: string; args: string[] } {\n\tconst conCd = cwd && cwd !== \".\" ? `cd -- ${comillaPosix(cwd)} && ${comandoRemoto}` : comandoRemoto;\n\tswitch (destino.tipo) {\n\t\tcase \"ssh\": {\n\t\t\tconst objetivo = destino.usuario ? `${destino.usuario}@${destino.host}` : destino.host;\n\t\t\tconst args = [\n\t\t\t\t\"-o\",\n\t\t\t\t\"BatchMode=yes\",\n\t\t\t\t\"-o\",\n\t\t\t\t\"ControlMaster=auto\",\n\t\t\t\t\"-o\",\n\t\t\t\t`ControlPersist=${SSH_CONTROL_PERSIST_S}`,\n\t\t\t\t\"-o\",\n\t\t\t\t`ControlPath=${socketControlMaster(destino)}`,\n\t\t\t];\n\t\t\tif (destino.puerto) args.push(\"-p\", String(destino.puerto));\n\t\t\targs.push(objetivo, conCd);\n\t\t\treturn { bin: \"ssh\", args };\n\t\t}\n\t\tcase \"docker\":\n\t\t\treturn {\n\t\t\t\tbin: \"docker\",\n\t\t\t\targs: [\"exec\", \"-w\", cwd && cwd !== \".\" ? cwd : \"/\", destino.contenedor, \"sh\", \"-c\", comandoRemoto],\n\t\t\t};\n\t\tcase \"wsl\":\n\t\t\treturn {\n\t\t\t\tbin: \"wsl.exe\",\n\t\t\t\targs: [\"-d\", destino.distro, \"--cd\", cwd && cwd !== \".\" ? cwd : \"~\", \"--\", \"sh\", \"-c\", comandoRemoto],\n\t\t\t};\n\t}\n}\n\n/**\n * Igual que `argvRemoto`, pero con el stdin del proceso remoto conectado.\n *\n * `ssh` y `wsl.exe` heredan el stdio que `spawn` les da sin flags extra;\n * `docker exec` no — sin `-i` el contenedor nunca ve lo que se le escribe,\n * y `ficheros.ts` necesita justo eso para `write`/`edit`.\n */\nfunction argvRemotoConStdin(destino: Destino, cwd: string, comandoRemoto: string): { bin: string; args: string[] } {\n\tconst { bin, args } = argvRemoto(destino, cwd, comandoRemoto);\n\tif (destino.tipo !== \"docker\") return { bin, args };\n\treturn { bin, args: [\"exec\", \"-i\", ...args.slice(1)] };\n}\n\n/** Lanza `comandoRemoto` en el destino y devuelve el proceso hijo crudo (stdio: pipe/pipe/pipe). */\nexport function lanza(\n\tdestino: Destino,\n\tcwd: string,\n\tcomandoRemoto: string,\n\topciones?: { stdin?: boolean; env?: NodeJS.ProcessEnv },\n): ChildProcess {\n\tconst { bin, args } = opciones?.stdin\n\t\t? argvRemotoConStdin(destino, cwd, comandoRemoto)\n\t\t: argvRemoto(destino, cwd, comandoRemoto);\n\treturn spawnProcess(bin, args, {\n\t\tstdio: [opciones?.stdin ? \"pipe\" : \"ignore\", \"pipe\", \"pipe\"],\n\t\tenv: opciones?.env ?? process.env,\n\t\twindowsHide: true,\n\t});\n}\n\n/** Ejecuta y espera, acumulando stdout/stderr por separado. Para `ficheros.ts`: comandos cortos, salida completa en memoria. */\nexport async function ejecutaCapturando(\n\tdestino: Destino,\n\tcwd: string,\n\tcomandoRemoto: string,\n\topciones?: { stdin?: Buffer | string },\n): Promise<{ exitCode: number | null; stdout: Buffer; stderr: Buffer }> {\n\tconst child = lanza(destino, cwd, comandoRemoto, { stdin: opciones?.stdin !== undefined });\n\tconst stdoutChunks: Buffer[] = [];\n\tconst stderrChunks: Buffer[] = [];\n\tchild.stdout?.on(\"data\", (d: Buffer) => stdoutChunks.push(d));\n\tchild.stderr?.on(\"data\", (d: Buffer) => stderrChunks.push(d));\n\tif (opciones?.stdin !== undefined) {\n\t\tchild.stdin?.on(\"error\", () => {}); // EPIPE si el remoto cierra antes de tiempo: el exitCode ya cuenta la historia\n\t\tchild.stdin?.end(opciones.stdin);\n\t}\n\tconst exitCode = await waitForChildProcess(child);\n\treturn { exitCode, stdout: Buffer.concat(stdoutChunks), stderr: Buffer.concat(stderrChunks) };\n}\n\n/**\n * `BashOperations` que delega en el destino en vez del shell local.\n *\n * Misma forma que `createLocalBashOperations` (señal de aborto, timeout,\n * streaming por `onData`) para que la tool `bash` no note la diferencia más\n * allá de dónde corre el comando.\n */\nexport function creaBashOperations(destino: Destino): BashOperations {\n\treturn {\n\t\texec: (command, cwd, { onData, signal, timeout, env }) => {\n\t\t\treturn new Promise((resolve, reject) => {\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\treject(new Error(\"aborted\"));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\t// `env` (las PI_* de la sesión) llega aquí pensado para un shell\n\t\t\t\t// LOCAL: se lo pasamos al cliente ssh/docker/wsl.exe (le hace falta\n\t\t\t\t// su propio PATH, SSH_AUTH_SOCK…), pero eso NO las mete en el shell\n\t\t\t\t// REMOTO — ssh no reenvía variables salvo que el sshd de destino\n\t\t\t\t// tenga AcceptEnv configurado, que no podemos asumir. Un comando que\n\t\t\t\t// dependa de PI_MODEL, etc. dentro de --remoto no las va a ver.\n\t\t\t\tconst child = lanza(destino, cwd, command, { env });\n\t\t\t\tlet timedOut = false;\n\t\t\t\tlet timeoutHandle: NodeJS.Timeout | undefined;\n\t\t\t\tconst onAbort = () => {\n\t\t\t\t\tif (child.pid) killProcessTree(child.pid);\n\t\t\t\t};\n\t\t\t\tif (timeout !== undefined) {\n\t\t\t\t\ttimeoutHandle = setTimeout(() => {\n\t\t\t\t\t\ttimedOut = true;\n\t\t\t\t\t\tif (child.pid) killProcessTree(child.pid);\n\t\t\t\t\t}, timeout * 1000);\n\t\t\t\t}\n\t\t\t\tchild.stdout?.on(\"data\", onData);\n\t\t\t\tchild.stderr?.on(\"data\", onData);\n\t\t\t\tif (signal) {\n\t\t\t\t\tif (signal.aborted) onAbort();\n\t\t\t\t\telse signal.addEventListener(\"abort\", onAbort, { once: true });\n\t\t\t\t}\n\t\t\t\twaitForChildProcess(child)\n\t\t\t\t\t.then((exitCode) => {\n\t\t\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\t\t\treject(new Error(\"aborted\"));\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (timedOut) {\n\t\t\t\t\t\t\treject(new Error(`timeout:${timeout}`));\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tresolve({ exitCode });\n\t\t\t\t\t})\n\t\t\t\t\t.catch(reject)\n\t\t\t\t\t.finally(() => {\n\t\t\t\t\t\tif (timeoutHandle) clearTimeout(timeoutHandle);\n\t\t\t\t\t\tif (signal) signal.removeEventListener(\"abort\", onAbort);\n\t\t\t\t\t});\n\t\t\t});\n\t\t},\n\t};\n}\n\n/**\n * Cierra el `ControlMaster` de SSH explícitamente, en vez de esperar los\n * `ControlPersist` segundos de gracia. Para Docker y WSL no hay nada que\n * cerrar: cada llamada es un proceso independiente que ya ha terminado.\n *\n * ponytail: si `-O exit` falla (el master ya murió, o nunca llegó a abrirse\n * porque no se ejecutó ningún comando), no es un error — no había nada que\n * cerrar. El techo real es `ControlPersist`: aunque esta llamada se pierda\n * (proceso matado con -9), el socket se limpia solo a los\n * `SSH_CONTROL_PERSIST_S` segundos.\n */\nexport async function cierraConexion(destino: Destino): Promise<void> {\n\tif (destino.tipo !== \"ssh\") return;\n\tconst objetivo = destino.usuario ? `${destino.usuario}@${destino.host}` : destino.host;\n\tconst args = [\"-o\", `ControlPath=${socketControlMaster(destino)}`, \"-O\", \"exit\", objetivo];\n\tawait new Promise<void>((resolve) => {\n\t\tconst child = spawnProcess(\"ssh\", args, { stdio: \"ignore\" });\n\t\tchild.on(\"exit\", () => resolve());\n\t\tchild.on(\"error\", () => resolve());\n\t});\n}\n"]}

package/dist/core/remoto/ficheros.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Lee y escribe ficheros EN el destino, montado sobre `ejecutor.ts`.
+ *
+ * No hay SFTP ni `sshfs`: son comandos POSIX cortos (`cat`, `test`, `mkdir`)
+ * a través del mismo transporte que ya usa `bash` — ni una dependencia más,
+ * y el mismo camino que `--remoto` ya tiene que dejar pasar por la política
+ * de aprobación (ver `core/aprobacion/politica.ts`).
+ *
+ * `cat` sobre stdout capturado como `Buffer` es binario-seguro: no hace falta
+ * base64 porque nunca pasa por un terminal ni por un parseo de texto, solo
+ * por la tubería del proceso hijo.
+ */
+import type { EditOperations } from "../tools/edit.ts";
+import type { ReadOperations } from "../tools/read.ts";
+import type { WriteOperations } from "../tools/write.ts";
+import type { Destino } from "./destino.ts";
+/**
+ * `ReadOperations` remotas.
+ *
+ * `detectImageMimeType` se deja sin definir a propósito: es opcional en la
+ * interfaz, y detectarlo hoy exigiría traer los bytes completos al cliente
+ * solo para mirar la cabecera. `read` remoto trata todo como texto.
+ * ponytail: sin deteción de imágenes remotas; añadir si hace falta leer
+ * capturas de pantalla de un contenedor o servidor.
+ */
+export declare function creaReadOperations(destino: Destino, cwd: string): ReadOperations;
+export declare function creaWriteOperations(destino: Destino, cwd: string): WriteOperations;
+export declare function creaEditOperations(destino: Destino, cwd: string): EditOperations;
+//# sourceMappingURL=ficheros.d.ts.map

package/dist/core/remoto/ficheros.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ficheros.d.ts","sourceRoot":"","sources":["../../../src/core/remoto/ficheros.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA4D5C;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,CAKhF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAKlF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,CAMhF","sourcesContent":["/**\n * Lee y escribe ficheros EN el destino, montado sobre `ejecutor.ts`.\n *\n * No hay SFTP ni `sshfs`: son comandos POSIX cortos (`cat`, `test`, `mkdir`)\n * a través del mismo transporte que ya usa `bash` — ni una dependencia más,\n * y el mismo camino que `--remoto` ya tiene que dejar pasar por la política\n * de aprobación (ver `core/aprobacion/politica.ts`).\n *\n * `cat` sobre stdout capturado como `Buffer` es binario-seguro: no hace falta\n * base64 porque nunca pasa por un terminal ni por un parseo de texto, solo\n * por la tubería del proceso hijo.\n */\n\nimport type { EditOperations } from \"../tools/edit.ts\";\nimport type { ReadOperations } from \"../tools/read.ts\";\nimport type { WriteOperations } from \"../tools/write.ts\";\nimport type { Destino } from \"./destino.ts\";\nimport { comillaPosix, ejecutaCapturando } from \"./ejecutor.ts\";\n\nfunction errorRemoto(accion: string, ruta: string, resultado: { exitCode: number | null; stderr: Buffer }): Error {\n\tconst detalle = resultado.stderr.toString(\"utf-8\").trim();\n\treturn new Error(\n\t\t`${accion} \"${ruta}\" en el destino remoto falló (código ${resultado.exitCode ?? \"desconocido\"})${detalle ? `: ${detalle}` : \"\"}`,\n\t);\n}\n\nasync function leeRemoto(destino: Destino, cwd: string, rutaAbsoluta: string): Promise<Buffer> {\n\tconst r = await ejecutaCapturando(destino, cwd, `cat -- ${comillaPosix(rutaAbsoluta)}`);\n\tif (r.exitCode !== 0) throw errorRemoto(\"Leer\", rutaAbsoluta, r);\n\treturn r.stdout;\n}\n\nasync function accesoRemoto(destino: Destino, cwd: string, rutaAbsoluta: string, escritura: boolean): Promise<void> {\n\t// `test`/`[` (POSIX / busybox ash) no entiende `--` como fin de opciones —\n\t// eso es un busybox de bash, no de `test(1)`. `[ -r -- /f ]` falla con\n\t// \"unknown operand\" en Alpine. Sin `--` es seguro igualmente porque\n\t// `rutaAbsoluta` siempre empieza por `/` (la resuelve `resolveToCwd` antes\n\t// de llegar aquí), así que nunca puede confundirse con una opción `-x`.\n\t//\n\t// Un solo `[ ]` por motivo, no `test -r && test -w`: con eso, \"no se pudo\"\n\t// tenía un único mensaje (\"no existe o falta permiso\") para tres causas\n\t// distintas — no existe, no se puede leer, no se puede escribir — y quien\n\t// lo lee no puede saber cuál de las tres pasó. Un viaje de ida y vuelta\n\t// hace las tres preguntas en orden y el remoto dice cuál falló primero.\n\tconst p = comillaPosix(rutaAbsoluta);\n\tconst prueba = `if [ ! -e ${p} ]; then echo no-existe; elif [ ! -r ${p} ]; then echo sin-lectura; elif ${\n\t\tescritura ? `[ ! -w ${p} ]` : \"false\"\n\t}; then echo sin-escritura; else echo ok; fi`;\n\tconst r = await ejecutaCapturando(destino, cwd, prueba);\n\tconst motivo = r.stdout.toString(\"utf-8\").trim();\n\tif (motivo === \"ok\") return;\n\tconst detalle: Record<string, string> = {\n\t\t\"no-existe\": \"no existe\",\n\t\t\"sin-lectura\": \"no se puede leer (permiso denegado)\",\n\t\t\"sin-escritura\": \"no se puede escribir (permiso denegado)\",\n\t};\n\tthrow new Error(\n\t\t`No se puede leer${escritura ? \"/escribir\" : \"\"} \"${rutaAbsoluta}\" en el destino remoto: ${\n\t\t\tdetalle[motivo] ?? `fallo inesperado (código ${r.exitCode ?? \"desconocido\"})`\n\t\t}.`,\n\t);\n}\n\nasync function escribeRemoto(destino: Destino, cwd: string, rutaAbsoluta: string, contenido: string): Promise<void> {\n\t// El contenido va por stdin, nunca en la línea de comando: así un fichero\n\t// con comillas, `$(...)` o saltos de línea no puede inyectar nada en el\n\t// shell remoto — solo `cat` lo interpreta, y `cat` no ejecuta lo que lee.\n\tconst r = await ejecutaCapturando(destino, cwd, `cat > ${comillaPosix(rutaAbsoluta)}`, { stdin: contenido });\n\tif (r.exitCode !== 0) throw errorRemoto(\"Escribir\", rutaAbsoluta, r);\n}\n\nasync function creaDirectorioRemoto(destino: Destino, cwd: string, dir: string): Promise<void> {\n\tconst r = await ejecutaCapturando(destino, cwd, `mkdir -p -- ${comillaPosix(dir)}`);\n\tif (r.exitCode !== 0) throw errorRemoto(\"Crear el directorio\", dir, r);\n}\n\n/**\n * `ReadOperations` remotas.\n *\n * `detectImageMimeType` se deja sin definir a propósito: es opcional en la\n * interfaz, y detectarlo hoy exigiría traer los bytes completos al cliente\n * solo para mirar la cabecera. `read` remoto trata todo como texto.\n * ponytail: sin deteción de imágenes remotas; añadir si hace falta leer\n * capturas de pantalla de un contenedor o servidor.\n */\nexport function creaReadOperations(destino: Destino, cwd: string): ReadOperations {\n\treturn {\n\t\treadFile: (rutaAbsoluta) => leeRemoto(destino, cwd, rutaAbsoluta),\n\t\taccess: (rutaAbsoluta) => accesoRemoto(destino, cwd, rutaAbsoluta, false),\n\t};\n}\n\nexport function creaWriteOperations(destino: Destino, cwd: string): WriteOperations {\n\treturn {\n\t\twriteFile: (rutaAbsoluta, contenido) => escribeRemoto(destino, cwd, rutaAbsoluta, contenido),\n\t\tmkdir: (dir) => creaDirectorioRemoto(destino, cwd, dir),\n\t};\n}\n\nexport function creaEditOperations(destino: Destino, cwd: string): EditOperations {\n\treturn {\n\t\treadFile: (rutaAbsoluta) => leeRemoto(destino, cwd, rutaAbsoluta),\n\t\twriteFile: (rutaAbsoluta, contenido) => escribeRemoto(destino, cwd, rutaAbsoluta, contenido),\n\t\taccess: (rutaAbsoluta) => accesoRemoto(destino, cwd, rutaAbsoluta, true),\n\t};\n}\n"]}

package/dist/core/remoto/ficheros.js

@@ -0,0 +1,90 @@
+/**
+ * Lee y escribe ficheros EN el destino, montado sobre `ejecutor.ts`.
+ *
+ * No hay SFTP ni `sshfs`: son comandos POSIX cortos (`cat`, `test`, `mkdir`)
+ * a través del mismo transporte que ya usa `bash` — ni una dependencia más,
+ * y el mismo camino que `--remoto` ya tiene que dejar pasar por la política
+ * de aprobación (ver `core/aprobacion/politica.ts`).
+ *
+ * `cat` sobre stdout capturado como `Buffer` es binario-seguro: no hace falta
+ * base64 porque nunca pasa por un terminal ni por un parseo de texto, solo
+ * por la tubería del proceso hijo.
+ */
+import { comillaPosix, ejecutaCapturando } from "./ejecutor.js";
+function errorRemoto(accion, ruta, resultado) {
+    const detalle = resultado.stderr.toString("utf-8").trim();
+    return new Error(`${accion} "${ruta}" en el destino remoto falló (código ${resultado.exitCode ?? "desconocido"})${detalle ? `: ${detalle}` : ""}`);
+}
+async function leeRemoto(destino, cwd, rutaAbsoluta) {
+    const r = await ejecutaCapturando(destino, cwd, `cat -- ${comillaPosix(rutaAbsoluta)}`);
+    if (r.exitCode !== 0)
+        throw errorRemoto("Leer", rutaAbsoluta, r);
+    return r.stdout;
+}
+async function accesoRemoto(destino, cwd, rutaAbsoluta, escritura) {
+    // `test`/`[` (POSIX / busybox ash) no entiende `--` como fin de opciones —
+    // eso es un busybox de bash, no de `test(1)`. `[ -r -- /f ]` falla con
+    // "unknown operand" en Alpine. Sin `--` es seguro igualmente porque
+    // `rutaAbsoluta` siempre empieza por `/` (la resuelve `resolveToCwd` antes
+    // de llegar aquí), así que nunca puede confundirse con una opción `-x`.
+    //
+    // Un solo `[ ]` por motivo, no `test -r && test -w`: con eso, "no se pudo"
+    // tenía un único mensaje ("no existe o falta permiso") para tres causas
+    // distintas — no existe, no se puede leer, no se puede escribir — y quien
+    // lo lee no puede saber cuál de las tres pasó. Un viaje de ida y vuelta
+    // hace las tres preguntas en orden y el remoto dice cuál falló primero.
+    const p = comillaPosix(rutaAbsoluta);
+    const prueba = `if [ ! -e ${p} ]; then echo no-existe; elif [ ! -r ${p} ]; then echo sin-lectura; elif ${escritura ? `[ ! -w ${p} ]` : "false"}; then echo sin-escritura; else echo ok; fi`;
+    const r = await ejecutaCapturando(destino, cwd, prueba);
+    const motivo = r.stdout.toString("utf-8").trim();
+    if (motivo === "ok")
+        return;
+    const detalle = {
+        "no-existe": "no existe",
+        "sin-lectura": "no se puede leer (permiso denegado)",
+        "sin-escritura": "no se puede escribir (permiso denegado)",
+    };
+    throw new Error(`No se puede leer${escritura ? "/escribir" : ""} "${rutaAbsoluta}" en el destino remoto: ${detalle[motivo] ?? `fallo inesperado (código ${r.exitCode ?? "desconocido"})`}.`);
+}
+async function escribeRemoto(destino, cwd, rutaAbsoluta, contenido) {
+    // El contenido va por stdin, nunca en la línea de comando: así un fichero
+    // con comillas, `$(...)` o saltos de línea no puede inyectar nada en el
+    // shell remoto — solo `cat` lo interpreta, y `cat` no ejecuta lo que lee.
+    const r = await ejecutaCapturando(destino, cwd, `cat > ${comillaPosix(rutaAbsoluta)}`, { stdin: contenido });
+    if (r.exitCode !== 0)
+        throw errorRemoto("Escribir", rutaAbsoluta, r);
+}
+async function creaDirectorioRemoto(destino, cwd, dir) {
+    const r = await ejecutaCapturando(destino, cwd, `mkdir -p -- ${comillaPosix(dir)}`);
+    if (r.exitCode !== 0)
+        throw errorRemoto("Crear el directorio", dir, r);
+}
+/**
+ * `ReadOperations` remotas.
+ *
+ * `detectImageMimeType` se deja sin definir a propósito: es opcional en la
+ * interfaz, y detectarlo hoy exigiría traer los bytes completos al cliente
+ * solo para mirar la cabecera. `read` remoto trata todo como texto.
+ * ponytail: sin deteción de imágenes remotas; añadir si hace falta leer
+ * capturas de pantalla de un contenedor o servidor.
+ */
+export function creaReadOperations(destino, cwd) {
+    return {
+        readFile: (rutaAbsoluta) => leeRemoto(destino, cwd, rutaAbsoluta),
+        access: (rutaAbsoluta) => accesoRemoto(destino, cwd, rutaAbsoluta, false),
+    };
+}
+export function creaWriteOperations(destino, cwd) {
+    return {
+        writeFile: (rutaAbsoluta, contenido) => escribeRemoto(destino, cwd, rutaAbsoluta, contenido),
+        mkdir: (dir) => creaDirectorioRemoto(destino, cwd, dir),
+    };
+}
+export function creaEditOperations(destino, cwd) {
+    return {
+        readFile: (rutaAbsoluta) => leeRemoto(destino, cwd, rutaAbsoluta),
+        writeFile: (rutaAbsoluta, contenido) => escribeRemoto(destino, cwd, rutaAbsoluta, contenido),
+        access: (rutaAbsoluta) => accesoRemoto(destino, cwd, rutaAbsoluta, true),
+    };
+}
+//# sourceMappingURL=ficheros.js.map