agentic-workflow-manager 3.13.5 → 3.13.6

package/dist/src/core/provider-artifacts.js

@@ -8,39 +8,64 @@ exports.scanLegacyArtifacts = scanLegacyArtifacts;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const providers_1 = require("../providers");
+const artifact_state_1 = require("./artifact-state");
 const ARTIFACT_TYPES = ['skill', 'workflow', 'agent'];
 function preflightLinkArtifactPairs(pairs) {
     for (const { agent, artifact } of pairs) {
         (0, providers_1.assertLinkRenderer)(artifact.type, agent);
     }
 }
-function scanLegacyArtifacts(agents, scope) {
+/**
+ * Artefactos instalados que AWM puede ofrecer para remover.
+ *
+ * Cuatro defectos corregidos aca, todos con perdida de datos o no-operacion:
+ *
+ *  1. **Clave por nombre solo**, a traves de TODOS los tipos y agentes. Un
+ *     workflow `deploy.md` de antigravity y un agent `deploy.md` de claude-code
+ *     colapsaban en UNA entrada, asi que elegir "deploy.md" borraba los dos. El
+ *     escritor (`planInstall`) siempre clavea por ubicacion fisica.
+ *  2. **Scope local resuelto contra `process.cwd()`**: `config.local` es
+ *     relativo (`.claude/skills`), asi que desde un subdirectorio no encontraba
+ *     nada, y cuando encontraba algo le pasaba una ruta RELATIVA a `fs.rmSync`.
+ *     Ahora recibe el projectRoot explicito, como todos los demas consumidores.
+ *  3. **Listaba el directorio entero**, ofreciendo borrar skills que el usuario
+ *     escribio a mano. Ahora se cruza contra `readArtifactState()`: solo se
+ *     ofrece lo que AWM realmente instalo. El registro de propiedad existe
+ *     justamente para poder distinguirlo.
+ *  4. **Se tragaba `UnsupportedRendererError`**, asi que era un no-op permanente
+ *     para skills de cursor/copilot y agents de codex: `awm remove -a cursor`
+ *     decia "no hay artefactos instalados" con el directorio lleno.
+ */
+function scanLegacyArtifacts(agents, scope, projectRoot = process.cwd(), owned = (0, artifact_state_1.readArtifactState)()) {
     const artifacts = new Map();
+    const ownedPaths = new Set(owned.map((r) => path_1.default.resolve(r.targetPath)));
     for (const agent of agents) {
         for (const type of ARTIFACT_TYPES) {
-            let config;
-            try {
-                config = (0, providers_1.assertLinkRenderer)(type, agent);
-            }
-            catch (error) {
-                if (error instanceof providers_1.UnsupportedRendererError)
-                    continue;
-                throw error;
-            }
+            const config = (0, providers_1.providerFor)(agent)[type];
             if (!config)
                 continue;
-            const dir = config[scope];
+            // Se usa la config del provider directamente: `assertLinkRenderer`
+            // TIRA para renderers que producen contenido, y atrapar ese throw
+            // convertia a cursor/copilot/codex en invisibles para `awm remove`.
+            const dir = scope === 'local' ? path_1.default.join(projectRoot, config.local) : config.global;
             if (dir === null || !fs_1.default.existsSync(dir))
                 continue;
             for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
                 const fullPath = path_1.default.join(dir, entry.name);
-                const existing = artifacts.get(entry.name);
+                // Solo lo que AWM instalo. Un archivo del usuario en el mismo
+                // directorio no es nuestro para ofrecerlo en un menu de borrado.
+                if (!ownedPaths.has(path_1.default.resolve(fullPath)))
+                    continue;
+                // Clave por TIPO + nombre: dos artefactos de tipos distintos con
+                // el mismo nombre son cosas distintas en lugares distintos.
+                const key = `${type}\u0000${entry.name}`;
+                const existing = artifacts.get(key);
                 if (existing) {
                     existing.installedIn.push(agent);
                     existing.fullPaths.push(fullPath);
                 }
                 else {
-                    artifacts.set(entry.name, {
+                    artifacts.set(key, {
                         name: entry.name,
                         type,
                         installedIn: [agent],

package/dist/src/core/provider-version.js

@@ -19,18 +19,24 @@ function assertProviderSupported(agent, exec = child_process_1.execFileSync) {
     }
     catch (error) {
         const code = error.code;
+        // `provider.label` y `versionCommand`, no "Codex" literal. Esta funcion es
+        // generica sobre AgentTarget desde siempre, pero cada mensaje y el patron de
+        // parseo nombraban al unico provider que hoy declara `versionCommand` — el
+        // segundo en declararlo habria reportado "Codex no esta instalado" al no
+        // encontrar SU binario, y habria fallado a parsear una salida perfectamente
+        // valida contra el formato de otro programa.
         if (code === 'ENOENT') {
-            throw new Error('Codex is not installed or not available on PATH. ' +
-                'Install the current stable @openai/codex release, then re-run.');
+            throw new Error(`${provider.label} is not installed or not available on PATH ` +
+                `(tried \`${provider.versionCommand.command}\`). Install it, then re-run.`);
         }
-        throw new Error(`Codex version probe failed: ${error.message}`);
+        throw new Error(`${provider.label} version probe failed: ${error.message}`);
     }
-    const match = output.trim().match(/^codex-cli (\d+\.\d+\.\d+)$/);
+    const match = output.trim().match(provider.versionCommand.versionPattern);
     if (!match) {
-        throw new Error(`could not parse Codex version from: ${output.trim()}`);
+        throw new Error(`could not parse ${provider.label} version from: ${output.trim()}`);
     }
     if ((0, versioning_1.compareSemver)(match[1], provider.minimumVersion) < 0) {
-        throw new Error(`requires Codex >= ${provider.minimumVersion}; found ${match[1]}`);
+        throw new Error(`requires ${provider.label} >= ${provider.minimumVersion}; found ${match[1]}`);
     }
     return { provider: agent, version: match[1] };
 }

package/dist/src/core/registries.js

@@ -3,7 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.REGISTRY_MANIFEST_NAME = exports.CONTENT_DIR_NAMES = exports.REGISTRIES_CONFIG_PATH = exports.REGISTRIES_DIR = void 0;
+exports.REGISTRY_MANIFEST_NAME = exports.CONTENT_DIR_NAMES = void 0;
+exports.registriesDir = registriesDir;
+exports.registriesConfigPath = registriesConfigPath;
 exports.registryContentRoot = registryContentRoot;
 exports.readRegistriesConfig = readRegistriesConfig;
 exports.writeRegistriesConfig = writeRegistriesConfig;
@@ -30,49 +32,57 @@ const versioning_1 = require("./versioning");
 const cli_version_1 = require("./cli-version");
 const paths_1 = require("./paths");
 // Computed at require-time by calling the shared resolver (single source of truth: core/paths.ts).
-const AWM_HOME = (0, paths_1.awmHome)();
-exports.REGISTRIES_DIR = path_1.default.join(AWM_HOME, 'registries');
-exports.REGISTRIES_CONFIG_PATH = path_1.default.join(AWM_HOME, 'registries.json');
+// Funciones, no constantes de nivel de modulo. `awmHome()` lee AWM_HOME/HOME EN CADA
+// LLAMADA a proposito (paths.ts) — resolverlo una sola vez al hacer `require` congelaba
+// la respuesta en el instante del import, asi que cualquier cosa que fijara AWM_HOME
+// despues (un test, un comando que cambia de home) seguia apuntando al viejo. Este
+// modulo era el unico lugar que contradecia esa regla.
+function registriesDir() {
+    return path_1.default.join((0, paths_1.awmHome)(), 'registries');
+}
+function registriesConfigPath() {
+    return path_1.default.join((0, paths_1.awmHome)(), 'registries.json');
+}
 exports.CONTENT_DIR_NAMES = ['skills', 'bundles', 'workflows', 'agents'];
 function registryContentRoot(name) {
-    const root = path_1.default.join(exports.REGISTRIES_DIR, name);
-    if (!path_1.default.resolve(root).startsWith(path_1.default.resolve(exports.REGISTRIES_DIR) + path_1.default.sep)) {
+    const root = path_1.default.join(registriesDir(), name);
+    if (!path_1.default.resolve(root).startsWith(path_1.default.resolve(registriesDir()) + path_1.default.sep)) {
         throw new Error(`Invalid registry name "${name}" — must not contain path separators`);
     }
     return root;
 }
 function readRegistriesConfig() {
-    if (!fs_1.default.existsSync(exports.REGISTRIES_CONFIG_PATH))
+    if (!fs_1.default.existsSync(registriesConfigPath()))
         return [];
     let raw;
     try {
-        raw = JSON.parse(fs_1.default.readFileSync(exports.REGISTRIES_CONFIG_PATH, 'utf-8'));
+        raw = JSON.parse(fs_1.default.readFileSync(registriesConfigPath(), 'utf-8'));
     }
     catch (e) {
-        throw new Error(`Invalid registries config at ${exports.REGISTRIES_CONFIG_PATH}: ${e instanceof Error ? e.message : String(e)}`);
+        throw new Error(`Invalid registries config at ${registriesConfigPath()}: ${e instanceof Error ? e.message : String(e)}`);
     }
     if (!Array.isArray(raw)) {
-        throw new Error(`Invalid registries config at ${exports.REGISTRIES_CONFIG_PATH}: expected a JSON array`);
+        throw new Error(`Invalid registries config at ${registriesConfigPath()}: expected a JSON array`);
     }
     for (const entry of raw) {
         if (typeof entry?.name !== 'string' || typeof entry?.remote !== 'string') {
-            throw new Error(`Invalid registries config at ${exports.REGISTRIES_CONFIG_PATH}: malformed entry ${JSON.stringify(entry)}`);
+            throw new Error(`Invalid registries config at ${registriesConfigPath()}: malformed entry ${JSON.stringify(entry)}`);
         }
         if (entry.name === '.' || entry.name.includes('/') || entry.name.includes('\\') || entry.name.includes('..')) {
-            throw new Error(`Invalid registries config at ${exports.REGISTRIES_CONFIG_PATH}: malformed entry name "${entry.name}" (path traversal)`);
+            throw new Error(`Invalid registries config at ${registriesConfigPath()}: malformed entry name "${entry.name}" (path traversal)`);
         }
     }
     return raw;
 }
 function writeRegistriesConfig(entries) {
-    fs_1.default.mkdirSync(AWM_HOME, { recursive: true });
-    fs_1.default.writeFileSync(exports.REGISTRIES_CONFIG_PATH, JSON.stringify(entries, null, 2) + '\n', 'utf-8');
+    fs_1.default.mkdirSync((0, paths_1.awmHome)(), { recursive: true });
+    fs_1.default.writeFileSync(registriesConfigPath(), JSON.stringify(entries, null, 2) + '\n', 'utf-8');
 }
 /** Bootstrap de máquina (awm init): si no hay registries.json, lo crea con la
  *  entrada baseline (remote por cadena WS-2: env > prefs > default).
  *  Devuelve true si sembró. Nunca toca un registries.json existente. */
 function seedBaselineRegistry() {
-    if (fs_1.default.existsSync(exports.REGISTRIES_CONFIG_PATH))
+    if (fs_1.default.existsSync(registriesConfigPath()))
         return false;
     writeRegistriesConfig([{ name: 'baseline', remote: (0, registry_1.resolveBaseRemote)() }]);
     return true;
@@ -111,7 +121,7 @@ async function syncRegistries() {
         try {
             const freshClone = !fs_1.default.existsSync(reg.contentRoot);
             if (freshClone) {
-                fs_1.default.mkdirSync(exports.REGISTRIES_DIR, { recursive: true });
+                fs_1.default.mkdirSync(registriesDir(), { recursive: true });
                 try {
                     await (0, simple_git_1.default)().clone(reg.remote, reg.contentRoot);
                 }
@@ -219,11 +229,11 @@ function readRegistryManifest(root) {
     }
     return { overrides: new Set(overrides), minCliVersion };
 }
-/** Nombre del registry dueño de un path: el nombre del clone bajo REGISTRIES_DIR,
+/** Nombre del registry dueño de un path: el nombre del clone bajo registriesDir(),
  *  o null si no pertenece a ninguno. */
 function registryNameForPath(p) {
     const resolved = path_1.default.resolve(p);
-    const regsRoot = path_1.default.resolve(exports.REGISTRIES_DIR) + path_1.default.sep;
+    const regsRoot = path_1.default.resolve(registriesDir()) + path_1.default.sep;
     if (resolved.startsWith(regsRoot)) {
         const first = resolved.slice(regsRoot.length).split(path_1.default.sep)[0];
         return first || null;
@@ -243,8 +253,19 @@ function verifyMinCliVersions(current = (0, cli_version_1.cliVersion)()) {
         catch {
             continue;
         }
-        if (min && (0, versioning_1.compareSemver)(current, min) < 0)
+        // Falla CERRADO: si alguna de las dos versiones no es legible, se
+        // reporta el fallo en vez de dejar pasar. Antes `compareSemver`
+        // devolvia NaN y `NaN < 0` es false, asi que un `minCliVersion`
+        // malformado hacia que el gate se saltara en silencio.
+        if (!min)
+            continue;
+        try {
+            if ((0, versioning_1.compareSemver)(current, min) < 0)
+                failures.push({ name: reg.name, min });
+        }
+        catch {
             failures.push({ name: reg.name, min });
+        }
     }
     return failures;
 }

package/dist/src/core/renderers/registry.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderedFilename = renderedFilename;
+exports.rendererExtension = rendererExtension;
+/** Extension que el renderer estampa sobre el nombre base, o `null` cuando el
+ *  artefacto se instala con el nombre tal cual (renderer `link`). */
+const RENDERER_EXTENSION = {
+    link: null,
+    'codex-agent-toml': '.toml',
+    'cursor-mdc': '.mdc',
+    'copilot-instructions': '.instructions.md',
+};
+/** `.md` es la unica extension que un `installName` de artefacto puede traer.
+ *  Deliberadamente NO se usa `path.parse().name`: eso corta desde el ULTIMO
+ *  punto, asi que un skill llamado `v1.2-migration` se truncaria a `v1`,
+ *  perdiendo `2-migration` y arriesgando colision con otro skill `v1`. */
+function stripMarkdownSuffix(installName) {
+    return installName.endsWith('.md') ? installName.slice(0, -'.md'.length) : installName;
+}
+/**
+ * Nombre de archivo FISICO que `renderer` produce para `installName`.
+ *
+ * Es la funcion que deben usar por igual el escritor (al planificar la
+ * instalacion) y todo lector (al preguntar "¿esta instalado?"). Que ambos lados
+ * salgan de aca es lo que hace estructuralmente imposible que vuelvan a
+ * discrepar.
+ */
+function renderedFilename(installName, renderer) {
+    const extension = RENDERER_EXTENSION[renderer];
+    return extension === null ? installName : `${stripMarkdownSuffix(installName)}${extension}`;
+}
+/** Extension del renderer, o `null` si instala con el nombre tal cual. Para los
+ *  pocos casos que necesitan la extension suelta (p. ej. "¿hay ALGUN archivo
+ *  renderizado en este directorio?") en vez de un nombre concreto. */
+function rendererExtension(renderer) {
+    return RENDERER_EXTENSION[renderer];
+}

package/dist/src/core/skill-integrity.js

@@ -3,12 +3,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.classifyGlobalSkills = classifyGlobalSkills;
-exports.repairGlobalSkills = repairGlobalSkills;
+exports.classifySkillLinks = classifySkillLinks;
+exports.repairSkillLinks = repairSkillLinks;
 exports.reconcileAllSkillLinks = reconcileAllSkillLinks;
+exports.reconcileProjectSkillLinks = reconcileProjectSkillLinks;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const providers_1 = require("../providers");
+const paths_1 = require("./paths");
 function findRegistrySkillPath(registryContentDirs, name) {
     for (const root of registryContentDirs) {
         const p = path_1.default.join(root, 'skills', name);
@@ -17,8 +19,11 @@ function findRegistrySkillPath(registryContentDirs, name) {
     }
     return null;
 }
-/** Clasifica cada entrada de `skillsDir` (read-only, no muta nada). */
-function classifyGlobalSkills(skillsDir, registryContentDirs) {
+/** Clasifica cada entrada de `skillsDir` (read-only, no muta nada).
+ *  Agnostico al alcance: `skillsDir` es global (`provider.skill.global`) o de
+ *  proyecto (`<projectRoot>/<provider.skill.local>`) — el nombre decia "Global" y
+ *  eso basto para que nadie lo apuntara nunca a un dir de proyecto. */
+function classifySkillLinks(skillsDir, registryContentDirs) {
     const out = { valid: [], repairable: [], dead: [] };
     let entries;
     try {
@@ -51,10 +56,11 @@ function classifyGlobalSkills(skillsDir, registryContentDirs) {
     return out;
 }
 /** Re-linkea los repairable al primer root que tenga la skill y poda los dead. Idempotente. Cada
- *  symlink aislado en try/catch — una falla no aborta el resto. */
-function repairGlobalSkills(skillsDir, registryContentDirs) {
+ *  symlink aislado en try/catch — una falla no aborta el resto. Agnostico al alcance:
+ *  ver la nota de `classifySkillLinks`. */
+function repairSkillLinks(skillsDir, registryContentDirs) {
     const result = { relinked: [], pruned: [], failed: [] };
-    const { repairable, dead } = classifyGlobalSkills(skillsDir, registryContentDirs);
+    const { repairable, dead } = classifySkillLinks(skillsDir, registryContentDirs);
     for (const name of repairable) {
         const p = path_1.default.join(skillsDir, name);
         try {
@@ -63,8 +69,35 @@ function repairGlobalSkills(skillsDir, registryContentDirs) {
                 result.failed.push(name);
                 continue;
             }
-            fs_1.default.rmSync(p, { force: true });
-            fs_1.default.symlinkSync(target, p, 'dir');
+            // Dos correcciones, ambas criticas en Windows:
+            //
+            // 1. `'junction'` en win32, no `'dir'`. Un symlink de directorio
+            //    exige SeCreateSymbolicLinkPrivilege, denegado por defecto en
+            //    cuentas sin privilegios (incluido el runner windows-latest);
+            //    una junction la puede crear cualquiera y libuv la reporta
+            //    igual. `executor.ts` ya documenta esto en extenso — este sitio
+            //    nunca recibio el fix.
+            //
+            // 2. Se crea el link NUEVO antes de retirar el viejo. Antes el
+            //    `rmSync` iba primero, asi que en Windows el link se borraba y
+            //    la recreacion fallaba: el usuario quedaba PEOR que antes, y
+            //    con la entrada ya ausente el proximo `awm init` ni siquiera
+            //    podia verla como reparable. Un fallo ahora deja el estado
+            //    original intacto.
+            const staged = path_1.default.join(skillsDir, `.${name}.${process.pid}.relink`);
+            try {
+                fs_1.default.rmSync(staged, { recursive: true, force: true });
+                fs_1.default.symlinkSync(target, staged, (0, paths_1.isWindowsNative)() ? 'junction' : 'dir');
+                fs_1.default.rmSync(p, { recursive: true, force: true });
+                fs_1.default.renameSync(staged, p);
+            }
+            finally {
+                // El staging jamas debe sobrevivir a esta iteracion: si quedara,
+                // `classifySkillLinks` lo veria como un symlink valido (apunta
+                // al registry, que existe) y nunca lo clasificaria como muerto,
+                // asi que se quedaria en el directorio para siempre.
+                fs_1.default.rmSync(staged, { recursive: true, force: true });
+            }
             result.relinked.push(name);
         }
         catch {
@@ -92,7 +125,35 @@ function reconcileAllSkillLinks(registryContentDirs) {
         const skillsDir = (0, providers_1.providerFor)(agent).skill.global;
         if (skillsDir === null || !fs_1.default.existsSync(skillsDir))
             continue;
-        out.push({ agent, result: repairGlobalSkills(skillsDir, registryContentDirs) });
+        out.push({ agent, result: repairSkillLinks(skillsDir, registryContentDirs) });
+    }
+    return out;
+}
+/**
+ * El equivalente de `reconcileAllSkillLinks` para el alcance de PROYECTO: reconcilia
+ * los symlinks de skills bajo `<projectRoot>/<provider.skill.local>` de cada agente
+ * pedido. Es la mitad que faltaba — todo lo de arriba servia igual para un dir local,
+ * pero ningun llamador lo apuntaba ahi, asi que un link colgante de proyecto no se
+ * curaba, no se podaba y no se reportaba en ninguna superficie. Para Copilot
+ * (`skill.global === null`) esto no era una mitad sino el total: TODAS sus skills son
+ * de proyecto.
+ *
+ * Un dir inexistente se omite (no hay nada que reconciliar y crearlo seria instalar,
+ * no reparar). Solo toca symlinks colgantes: los archivos y directorios reales del
+ * usuario, y los links vivos, quedan intactos — ver `classifySkillLinks`.
+ */
+function reconcileProjectSkillLinks(projectRoot, agents, registryContentDirs) {
+    const out = [];
+    const seen = new Set();
+    for (const agent of agents) {
+        // Varios providers comparten dir local (opencode y codex → `.agents/skills`).
+        // Reconciliar dos veces el mismo dir reportaria las mismas curaciones por
+        // duplicado, y la segunda pasada las veria ya sanas: se hace una sola vez.
+        const skillsDir = path_1.default.join(projectRoot, (0, providers_1.providerFor)(agent).skill.local);
+        if (seen.has(skillsDir) || !fs_1.default.existsSync(skillsDir))
+            continue;
+        seen.add(skillsDir);
+        out.push({ agent, result: repairSkillLinks(skillsDir, registryContentDirs) });
     }
     return out;
 }

package/dist/src/core/update-check.js

@@ -21,6 +21,18 @@ const picocolors_1 = __importDefault(require("picocolors"));
 const prompts_1 = require("@clack/prompts");
 const cli_version_1 = require("./cli-version");
 const versioning_1 = require("./versioning");
+/** El aviso de actualizacion es cosmetico: una version ilegible (de la cache o
+ *  del registro de npm) no debe romper el comando que el usuario pidio — solo
+ *  se omite el aviso. El gate de `minCliVersion`, en cambio, falla CERRADO
+ *  (ver verifyMinCliVersions). */
+function isNewer(a, b) {
+    try {
+        return (0, versioning_1.compareSemver)(a, b) > 0;
+    }
+    catch {
+        return false;
+    }
+}
 const paths_1 = require("./paths");
 const TTL_MS = 24 * 60 * 60 * 1000;
 const REGISTRY_URL = `https://registry.npmjs.org/${cli_version_1.CLI_PACKAGE_NAME}/latest`;
@@ -70,7 +82,7 @@ function maybeNotifyUpdate(opts) {
     const now = opts?.now ?? Date.now();
     const spawnWorker = opts?.spawnWorker ?? spawnRefreshWorker;
     const cache = readUpdateCache();
-    if (cache?.latest && (0, versioning_1.compareSemver)(cache.latest, (0, cli_version_1.cliVersion)()) > 0) {
+    if (cache?.latest && isNewer(cache.latest, (0, cli_version_1.cliVersion)())) {
         console.log(picocolors_1.default.dim(`\n⬆ awm v${cache.latest} available → npm i -g ${cli_version_1.CLI_PACKAGE_NAME}`));
     }
     if (!cache || now - cache.lastCheck > TTL_MS)
@@ -83,7 +95,7 @@ async function offerSelfUpdate(deps = {}) {
     const current = deps.current ?? (0, cli_version_1.cliVersion)();
     const latest = deps.latest !== undefined ? deps.latest : await fetchLatestVersion(deps.fetchImpl ?? fetch);
     writeUpdateCache({ lastCheck: Date.now(), latest: latest ?? null });
-    if (!latest || (0, versioning_1.compareSemver)(latest, current) <= 0)
+    if (!latest || !isNewer(latest, current))
         return;
     const confirmImpl = deps.confirmImpl ?? (async (message) => {
         const r = await (0, prompts_1.confirm)({ message });

package/dist/src/core/versioning.js

@@ -105,8 +105,23 @@ function machineVersionOpts(registryName) {
     }
 }
 /** Compara "X.Y.Z" vs "X.Y.Z" (sin prefijo v) numéricamente. <0, 0, >0. */
+/** Compara dos semver X.Y.Z.
+ *
+ *  Antes devolvia `NaN` ante una entrada malformada (`'1.2'`, `'x.y.z'`), y como
+ *  `NaN > 0` y `NaN < 0` son AMBOS false, el gate de version fallaba ABIERTO:
+ *  `verifyMinCliVersions` dejaba pasar en silencio un CLI por debajo del minimo,
+ *  y el aviso de actualizacion no disparaba nunca. Para un gate, la direccion
+ *  correcta de fallo es la contraria. Ahora una entrada que no es semver lanza,
+ *  nombrando el valor: es el llamador quien decide como tratarlo, con
+ *  informacion suficiente para hacerlo. */
 function compareSemver(a, b) {
-    const pa = a.split('.').map(Number);
-    const pb = b.split('.').map(Number);
+    const parse = (v) => {
+        const m = /^v?(\d+)\.(\d+)\.(\d+)/.exec(String(v).trim());
+        if (!m)
+            throw new Error(`not a semver version: ${JSON.stringify(v)}`);
+        return [Number(m[1]), Number(m[2]), Number(m[3])];
+    };
+    const pa = parse(a);
+    const pb = parse(b);
     return (pa[0] - pb[0]) || (pa[1] - pb[1]) || (pa[2] - pb[2]);
 }

package/dist/src/index.js

@@ -18,6 +18,9 @@ const provider_preflight_1 = require("./ui/provider-preflight");
 const discovery_1 = require("./core/discovery");
 const bundles_1 = require("./core/bundles");
 const registries_1 = require("./core/registries");
+const install_planner_1 = require("./core/install-planner");
+const install_transaction_1 = require("./core/install-transaction");
+const profile_1 = require("./core/profile");
 const path_1 = __importDefault(require("path"));
 const picocolors_1 = __importDefault(require("picocolors"));
 const fs_1 = __importDefault(require("fs"));
@@ -166,31 +169,33 @@ program.command('add [name]')
             (0, prompts_1.outro)(picocolors_1.default.yellow('No artifacts available.'));
             return;
         }
-        const preflightOk = (0, provider_preflight_1.preflightLinkArtifactsForCli)(targetAgents.flatMap((agent) => artifactsToInstall.map((artifact) => ({ agent, artifact }))));
-        if (!preflightOk)
-            return;
         const installSpinner = (0, prompts_1.spinner)();
         installSpinner.start('Installing artifacts...');
         try {
-            const installed = [];
-            const skipped = [];
-            for (const currentAgent of targetAgents) {
-                for (const artifact of artifactsToInstall) {
-                    const config = (0, providers_1.assertLinkRenderer)(artifact.type, currentAgent);
-                    if (config === null) {
-                        skipped.push(`${artifact.name} (${currentAgent})`);
-                        continue;
-                    }
-                    const targetDir = config[scopeVal];
-                    if (targetDir === null) {
-                        skipped.push(`${artifact.name} (${currentAgent})`);
-                        continue;
-                    }
-                    const finalDest = path_1.default.join(targetDir, artifact.name);
-                    (0, executor_1.installArtifact)(artifact.sourcePath, finalDest, methodVal);
-                    installed.push(`${artifact.name} → ${currentAgent} (${scopeVal})`);
-                }
-            }
+            // Se delega en el MISMO pipeline que `awm add <bundle>`
+            // (planInstall + applyInstallPlan): transaccional, con backups,
+            // rollback y soporte real de renderers.
+            //
+            // Antes esto instalaba a mano y pasaba por `assertLinkRenderer`,
+            // que TIRA para cualquier renderer que no sea `link` — asi que
+            // `awm add --all` moria con "Renderer 'cursor-mdc' … is not
+            // implemented yet" para cursor y copilot, y para CODEX era puro
+            // dano colateral: sus skills son `link` e instalan bien, pero un
+            // solo artefacto `agent` mataba la corrida entera. El pipeline
+            // real ya soporta los tres renderers — `awm add <bundle> -a cursor`
+            // lo demuestra — asi que el unico problema era este camino paralelo.
+            const summary = (0, install_transaction_1.applyInstallPlan)((0, install_planner_1.planInstall)({
+                artifacts: artifactsToInstall.map((a) => ({
+                    name: a.name, type: a.type, installName: a.name, sourcePath: a.sourcePath,
+                })),
+                selectedAgents: targetAgents,
+                enabledAgents: prefs.enabledAgents,
+                scope: scopeVal,
+                projectRoot: (0, profile_1.findProjectRoot)(process.cwd()) ?? process.cwd(),
+                method: methodVal,
+            }));
+            const installed = summary.installed;
+            const skipped = summary.skipped;
             const updatedPrefs = targetAgents.reduce((current, agent) => (0, config_1.enableAgent)(current, agent), prefs);
             (0, config_1.savePreferences)({
                 ...updatedPrefs,
@@ -497,7 +502,10 @@ program.command('remove')
     });
     handleCancel(scopeChoice);
     const scopeVal = scopeChoice;
-    const installed = (0, provider_artifacts_1.scanLegacyArtifacts)(targetAgents, scopeVal);
+    // projectRoot explicito: `config.local` es relativo, y resolverlo contra
+    // `process.cwd()` hacia que `awm remove` no encontrara nada desde un
+    // subdirectorio — y que le pasara rutas RELATIVAS a fs.rmSync cuando si.
+    const installed = (0, provider_artifacts_1.scanLegacyArtifacts)(targetAgents, scopeVal, (0, profile_1.findProjectRoot)(process.cwd()) ?? process.cwd());
     if (installed.length === 0) {
         (0, prompts_1.outro)(picocolors_1.default.yellow('No installed artifacts found for the selected agents/scope.'));
         process.exit(0);

package/dist/src/providers/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UnsupportedRendererError = exports.AGENT_TARGETS = void 0;
+exports.UnsupportedRendererError = exports.RENDERER_IDS = exports.AGENT_TARGETS = void 0;
 exports.isAgentTarget = isAgentTarget;
 exports.requireAgentTarget = requireAgentTarget;
 exports.unsupportedScopeError = unsupportedScopeError;
@@ -18,6 +18,11 @@ exports.getInjection = getInjection;
 const path_1 = __importDefault(require("path"));
 const paths_1 = require("../core/paths");
 exports.AGENT_TARGETS = ['antigravity', 'opencode', 'claude-code', 'codex', 'cursor', 'copilot'];
+/** Runtime-enumerable, so the renderer table in `core/renderers/registry.ts` can be
+ *  checked for completeness against it (tests/structural/renderer-table-is-single-source).
+ *  A type-only union cannot be iterated, which is part of why four partial copies of the
+ *  renderer→extension mapping could drift apart unnoticed. */
+exports.RENDERER_IDS = ['link', 'codex-agent-toml', 'cursor-mdc', 'copilot-instructions'];
 function isAgentTarget(value) {
     return typeof value === 'string' &&
         exports.AGENT_TARGETS.includes(value);
@@ -102,7 +107,7 @@ function providers() {
         codex: {
             label: 'Codex',
             minimumVersion: '0.145.0',
-            versionCommand: { command: 'codex', args: ['--version'] },
+            versionCommand: { command: 'codex', args: ['--version'], versionPattern: /^codex-cli (\d+\.\d+\.\d+)$/ },
             skill: {
                 global: path_1.default.join(home, '.agents/skills'),
                 local: '.agents/skills',

package/dist/src/utils/config.js

@@ -13,6 +13,7 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const providers_1 = require("../providers");
 const paths_1 = require("../core/paths");
+const atomic_file_1 = require("../core/atomic-file");
 const DEFAULT_PREFS = {
     // claude-code matches `awm init`'s own documented default (see init.ts / `awm init --help`).
     // Previously 'antigravity', which silently mis-installed bundles in claude-code
@@ -118,14 +119,12 @@ function loadPreferences(initialAgent = 'claude-code') {
 }
 function savePreferences(prefs) {
     const normalized = normalizePreferences(prefs, false).prefs;
-    const file = prefsFile();
-    fs_1.default.mkdirSync(path_1.default.dirname(file), { recursive: true });
-    const temp = `${file}.${process.pid}.tmp`;
-    fs_1.default.writeFileSync(temp, JSON.stringify(normalized, null, 2) + '\n', {
-        encoding: 'utf8',
-        mode: 0o600,
-    });
-    fs_1.default.renameSync(temp, file);
+    // `writeFileAtomic`, not a second hand-rolled write-temp-then-rename. The local copy
+    // predated the primitive and had drifted below it: no fsync, a pid-only temp name,
+    // and none of the guards the shared one grew. Same 0o600 intent and same
+    // mode-preservation semantics as `artifact-state.ts`, the other 0o600 file written
+    // through it — a file of this sensitivity has an established treatment here.
+    (0, atomic_file_1.writeFileAtomic)(prefsFile(), JSON.stringify(normalized, null, 2) + '\n', 0o600);
 }
 function enableAgent(prefs, agent) {
     normalizePreferences(prefs);

package/dist/tests/commands/doctor.test.js

@@ -148,6 +148,12 @@ describe('runDoctor', () => {
         expect(code).toBe(1);
     });
     it('reports every enabled provider and stable remediation codes in JSON', () => {
+        // El check `agents.native` solo se emite si hay artefactos nativos que
+        // verificar: un registry sin `agents/` ya no produce una fila roja sin
+        // remedio. Se siembra uno para que el check sea genuino en vez de
+        // asertar sobre una fila que hoy, con razon, no existiria.
+        fs_1.default.mkdirSync(path_1.default.join(tmpHome, '.codex', 'agents'), { recursive: true });
+        fs_1.default.writeFileSync(path_1.default.join(tmpHome, '.codex', 'agents', 'demo.toml'), 'name = "demo"\n');
         writePrefs(prefsWith(['claude-code', 'opencode', 'codex']));
         const code = (0, doctor_1.runDoctor)({ cwd: tmpWork, json: true });
         const report = JSON.parse(stdout());