@ronaldjdevfs/forge 1.3.5 → 1.3.6

package/README.md

@@ -1,6 +1,6 @@
 <img src="favicon.svg" alt="Forge Logo" width="100" height="100">
 
-> **v1.3.5** — R13 Platform Domain Guard & Legacy Cleanup
+> **v1.3.6** — Multi-Agent Path Resolution Fix
 
 ## Forge — Backend Architecture Operating System
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ronaldjdevfs/forge",
-  "version": "1.3.5",
+  "version": "1.3.6",
   "description": "Forge — Architecture Operating System for backend systems. Arquitectura Hexagonal, DDD pragmático y vertical slices.",
   "type": "module",
   "bin": {

package/skills/forge/SKILL.md

@@ -75,7 +75,7 @@ En esencia:
 ANTES de cualquier acción, Forge DEBE ejecutar `forge-boot.mjs` con la profundidad adecuada al comando:
 
 ```bash
-boot=$(node .opencode/skills/forge/scripts/forge-boot.mjs --depth <depth> --json 2>/dev/null)
+boot=$(node {{AGENT_PATH}}/scripts/forge-boot.mjs --depth <depth> --json 2>/dev/null)
 ```
 
 La profundidad (`--depth`) depende del comando (ver Execution Flow):
@@ -193,7 +193,7 @@ El agente DEBE leer este archivo al inicio de cada interacción y actualizarlo a
 Forge incluye tests unitarios con `node:test` (sin dependencias externas).
 
 ```bash
-node --test .opencode/skills/forge/tests/core.test.mjs
+node --test {{AGENT_PATH}}/tests/core.test.mjs
 ```
 
 | Módulo | Tests | Descripción |

package/skills/forge/command/forge.md

@@ -30,13 +30,13 @@ Si el subcomando NO tiene flags en $ARGUMENTS y tiene flags disponibles (ver tab
 Inicializa el proyecto arquitectónicamente. Ejecuta context + bootstrap + profile + armorer + graph + chain + inscribe.
 
 ```
-node .opencode/skills/forge/scripts/context.mjs
-node .opencode/skills/forge/scripts/bootstrap.mjs
-node .opencode/skills/forge/scripts/profile.mjs
-node .opencode/skills/forge/scripts/armorer.mjs
-node .opencode/skills/forge/scripts/graph.mjs
-node .opencode/skills/forge/scripts/chain.mjs
-node .opencode/skills/forge/scripts/architecture.mjs
+node {{AGENT_PATH}}/scripts/context.mjs
+node {{AGENT_PATH}}/scripts/bootstrap.mjs
+node {{AGENT_PATH}}/scripts/profile.mjs
+node {{AGENT_PATH}}/scripts/armorer.mjs
+node {{AGENT_PATH}}/scripts/graph.mjs
+node {{AGENT_PATH}}/scripts/chain.mjs
+node {{AGENT_PATH}}/scripts/architecture.mjs
 ```
 
 ### cast
@@ -52,7 +52,7 @@ Migra un feature existente. Puede targetizar platform/, shared/, infra/ o featur
 Genera ARCHITECTURE.md con grafo arquitectónico, ownership y platform.
 
 ```
-node .opencode/skills/forge/scripts/architecture.mjs
+node {{AGENT_PATH}}/scripts/architecture.mjs
 ```
 
 ### graph
@@ -60,13 +60,13 @@ node .opencode/skills/forge/scripts/architecture.mjs
 Construye el grafo arquitectónico del proyecto (4 capas: platform, feature, shared, infra) con reglas R1-R9.
 
 ```
-node .opencode/skills/forge/scripts/graph.mjs
+node {{AGENT_PATH}}/scripts/graph.mjs
 ```
 
 Para salida JSON:
 
 ```
-node .opencode/skills/forge/scripts/graph.mjs --json
+node {{AGENT_PATH}}/scripts/graph.mjs --json
 ```
 
 ### smelt
@@ -78,7 +78,7 @@ Extrae código reutilizable a shared/ (solo código puro, sin dependencias infra
 Inicializa platform, shared e infra layers (uso interno, se ejecuta automáticamente).
 
 ```
-node .opencode/skills/forge/scripts/bootstrap.mjs
+node {{AGENT_PATH}}/scripts/bootstrap.mjs
 ```
 
 ## Evaluate
@@ -88,13 +88,13 @@ node .opencode/skills/forge/scripts/bootstrap.mjs
 Audita la conformidad arquitectónica completa. 6 categorías: structure(20), layers(20), ownership(20), platform(15), dependencies(15), graph(20).
 
 ```
-node .opencode/skills/forge/scripts/inspect.mjs
+node {{AGENT_PATH}}/scripts/inspect.mjs
 ```
 
 Para salida JSON:
 
 ```
-node .opencode/skills/forge/scripts/inspect.mjs --json
+node {{AGENT_PATH}}/scripts/inspect.mjs --json
 ```
 
 ### assay
@@ -102,16 +102,16 @@ node .opencode/skills/forge/scripts/inspect.mjs --json
 Ensayo arquitectónico multi-persona. Interpretación cualitativa del audit desde 5 perspectivas (Bezos, Fowler, Hacker, PM, Arquitecta Senior).
 
 ```
-node .opencode/skills/forge/scripts/assay.mjs
+node {{AGENT_PATH}}/scripts/assay.mjs
 ```
 
 Filtros:
 
 ```
-node .opencode/skills/forge/scripts/assay.mjs --persona=bezos
-node .opencode/skills/forge/scripts/assay.mjs --json
-node .opencode/skills/forge/scripts/assay.mjs --save
-node .opencode/skills/forge/scripts/assay.mjs history
+node {{AGENT_PATH}}/scripts/assay.mjs --persona=bezos
+node {{AGENT_PATH}}/scripts/assay.mjs --json
+node {{AGENT_PATH}}/scripts/assay.mjs --save
+node {{AGENT_PATH}}/scripts/assay.mjs history
 ```
 
 ### quench
@@ -119,7 +119,7 @@ node .opencode/skills/forge/scripts/assay.mjs history
 Valida reglas arquitectónicas R1-R9.
 
 ```
-node .opencode/skills/forge/scripts/detect.mjs
+node {{AGENT_PATH}}/scripts/detect.mjs
 ```
 
 ### chain
@@ -127,13 +127,13 @@ node .opencode/skills/forge/scripts/detect.mjs
 Orden topológico de dependencias multi-capa (platform, features, shared, infra).
 
 ```
-node .opencode/skills/forge/scripts/chain.mjs
+node {{AGENT_PATH}}/scripts/chain.mjs
 ```
 
 Para salida JSON:
 
 ```
-node .opencode/skills/forge/scripts/chain.mjs --json
+node {{AGENT_PATH}}/scripts/chain.mjs --json
 ```
 
 ### armorer
@@ -141,7 +141,7 @@ node .opencode/skills/forge/scripts/chain.mjs --json
 Reporte de ownership: huérfanos, duplicados, componentes mal ubicados.
 
 ```
-node .opencode/skills/forge/scripts/armorer.mjs
+node {{AGENT_PATH}}/scripts/armorer.mjs
 ```
 
 ## Refine

package/skills/forge/reference/assay.md

@@ -23,26 +23,26 @@ Genera un **ensayo arquitectónico multi-persona** que evalúa el estado actual
 
 ```bash
 # Ensayo completo con todas las personas
-node .opencode/skills/forge/scripts/assay.mjs
+node {{AGENT_PATH}}/scripts/assay.mjs
 
 # Solo la opinión de una persona
-node .opencode/skills/forge/scripts/assay.mjs --persona=bezos
-node .opencode/skills/forge/scripts/assay.mjs --persona=fowler
-node .opencode/skills/forge/scripts/assay.mjs --persona=hacker
-node .opencode/skills/forge/scripts/assay.mjs --persona=pm
-node .opencode/skills/forge/scripts/assay.mjs --persona=senior
+node {{AGENT_PATH}}/scripts/assay.mjs --persona=bezos
+node {{AGENT_PATH}}/scripts/assay.mjs --persona=fowler
+node {{AGENT_PATH}}/scripts/assay.mjs --persona=hacker
+node {{AGENT_PATH}}/scripts/assay.mjs --persona=pm
+node {{AGENT_PATH}}/scripts/assay.mjs --persona=senior
 
 # Salida JSON (para consumo por herramientas)
-node .opencode/skills/forge/scripts/assay.mjs --json
+node {{AGENT_PATH}}/scripts/assay.mjs --json
 
 # Persistir ensayo en .forge/assay/
-node .opencode/skills/forge/scripts/assay.mjs --save
+node {{AGENT_PATH}}/scripts/assay.mjs --save
 
 # Ver historial de ensayos
-node .opencode/skills/forge/scripts/assay.mjs history
+node {{AGENT_PATH}}/scripts/assay.mjs history
 
 # Leer un ensayo previo
-node .opencode/skills/forge/scripts/assay.mjs read assay-2026-06-25T00-00-00.md
+node {{AGENT_PATH}}/scripts/assay.mjs read assay-2026-06-25T00-00-00.md
 ```
 
 ## Formato de salida

package/skills/forge/reference/chain.md

@@ -54,13 +54,13 @@ container.registerSingleton<ICreditRepository>(
 
 ```bash
 # Grafo de dependencias entre features (API legacy)
-node .opencode/skills/forge/scripts/chain.mjs
+node {{AGENT_PATH}}/scripts/chain.mjs
 
 # Grafo arquitectónico completo (nodos, edges, violaciones)
-node .opencode/skills/forge/scripts/graph.mjs
+node {{AGENT_PATH}}/scripts/graph.mjs
 
 # ARCHITECTURE.md con grafo incluido
-node .opencode/skills/forge/scripts/architecture.mjs
+node {{AGENT_PATH}}/scripts/architecture.mjs
 ```
 
 `chain.mjs` ahora es un wrapper sobre `graph.mjs`. Produce el mismo formato de salida para compatibilidad (nodos, edges, features, orden topológico). El nuevo `graph.mjs` amplía el análisis a todos los tipos de nodo (core, feature, domain, infra, adapter) y detecta violaciones de reglas arquitectónicas (R1-R6).

package/skills/forge/reference/evolutionary-architecture.md

@@ -85,10 +85,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - run: node .opencode/skills/forge/scripts/detect.mjs
+      - run: node {{AGENT_PATH}}/scripts/detect.mjs
         env:
           FORGE_STRICT: "true"
-      - run: node .opencode/skills/forge/scripts/chain.mjs --json
+      - run: node {{AGENT_PATH}}/scripts/chain.mjs --json
 ```
 
 ---

package/skills/forge/reference/inspect.md

@@ -52,9 +52,9 @@ Inspecciona la conformidad arquitectónica del proyecto.
 ## Ejecución
 
 ```bash
-node .opencode/skills/forge/scripts/inspect.mjs
-node .opencode/skills/forge/scripts/inspect.mjs --json
-node .opencode/skills/forge/scripts/detect.mjs --severity ERROR
+node {{AGENT_PATH}}/scripts/inspect.mjs
+node {{AGENT_PATH}}/scripts/inspect.mjs --json
+node {{AGENT_PATH}}/scripts/detect.mjs --severity ERROR
 
 ## Ver también
 

package/skills/forge/reference/quench.md

@@ -64,13 +64,13 @@ El grafo se construye automáticamente con `scripts/graph.mjs` y las violaciones
 
 ```bash
 # Validación completa
-node .opencode/skills/forge/scripts/detect.mjs
+node {{AGENT_PATH}}/scripts/detect.mjs
 
 # Solo errores y críticos
-node .opencode/skills/forge/scripts/detect.mjs --severity ERROR
+node {{AGENT_PATH}}/scripts/detect.mjs --severity ERROR
 
 # Solo un tipo específico
-node .opencode/skills/forge/scripts/detect.mjs --type layers
+node {{AGENT_PATH}}/scripts/detect.mjs --type layers
 
 ## Ver también
 

package/skills/forge/reference/reforge.md

@@ -23,10 +23,10 @@ Renombra un único archivo según las convenciones de `reference/patterns.md` y
 ### Flujo
 
 1. Identificar la ruta del archivo (relativa a la raíz del proyecto)
-2. Ejecutar `node .opencode/skills/forge/scripts/rename.mjs --detect --file <path>` para detectar violación
+2. Ejecutar `node {{AGENT_PATH}}/scripts/rename.mjs --detect --file <path>` para detectar violación
 3. Si el archivo ya cumple naming, informar y terminar
 4. Mostrar preview del cambio al usuario
-5. Ejecutar `node .opencode/skills/forge/scripts/rename.mjs --file <path>` que:
+5. Ejecutar `node {{AGENT_PATH}}/scripts/rename.mjs --file <path>` que:
    - Renombra físicamente el archivo
    - Escanea todos los `.ts`/`.js` del proyecto
    - Actualiza imports que referencian el path antiguo (relativos y absolutos)
@@ -57,9 +57,9 @@ $ forge reforge src/features/users/domain/userEntity.ts
 1. Ejecutar `forge inspect` para obtener estado actual
 2. Identificar violaciones en el grafo arquitectónico
 3. Identificar ownership problemático (huérfanos, duplicados, mal ubicados)
-4. **Detectar naming violations**: Ejecutar `node .opencode/skills/forge/scripts/rename.mjs --detect --json`
+4. **Detectar naming violations**: Ejecutar `node {{AGENT_PATH}}/scripts/rename.mjs --detect --json`
 5. Si hay naming violations, preguntar al usuario: "¿Corregir naming conventions automáticamente?"
-   - Si acepta, ejecutar `node .opencode/skills/forge/scripts/rename.mjs --all`
+   - Si acepta, ejecutar `node {{AGENT_PATH}}/scripts/rename.mjs --all`
 6. Decidir las acciones correctivas en orden:
    - Violaciones CRITICAL primero (R1, R2, R5, R6)
    - Violaciones ERROR después (R3, R4, R8, R9)

package/skills/forge/scripts/update.mjs

@@ -17,7 +17,7 @@ const ROOT = process.cwd();
 const CACHE_PATH = join(ROOT, ".forge", "version-cache.json");
 const CACHE_TTL = 86400000; // 24h
 const VERSION_URL = "https://forge.dev/latest";
-const CURRENT_VERSION = "1.3.5";
+const CURRENT_VERSION = "1.3.6";
 
 function readJson(path) {
   try {

package/src/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { copyFileSync, mkdirSync, existsSync, writeFileSync, readFileSync, cpSync, readdirSync } from "fs";
+import { copyFileSync, mkdirSync, existsSync, writeFileSync, readFileSync, cpSync, readdirSync, statSync } from "fs";
 import { join, dirname, relative } from "path";
 import { fileURLToPath } from "url";
 import { execSync } from "child_process";
@@ -43,6 +43,20 @@ function copyRecursive(src, dest) {
   cpSync(src, dest, { recursive: true, force: true });
 }
 
+function renderSkillPaths(skillDest, skillPath) {
+  for (const entry of readdirSync(skillDest)) {
+    const fullPath = join(skillDest, entry);
+    if (statSync(fullPath).isDirectory()) {
+      renderSkillPaths(fullPath, skillPath);
+    } else if (entry.endsWith(".md")) {
+      const content = readFileSync(fullPath, "utf-8");
+      if (content.includes("{{AGENT_PATH}}")) {
+        writeFileSync(fullPath, content.replace(/\{\{AGENT_PATH\}\}/g, skillPath), "utf-8");
+      }
+    }
+  }
+}
+
 function detectPM(configDir) {
   if (existsSync(join(configDir, "pnpm-lock.yaml")) || existsSync(join(process.cwd(), "pnpm-lock.yaml"))) return "pnpm";
   if (existsSync(join(configDir, "bun.lock")) || existsSync(join(configDir, "bun.lockb"))) return "bun";
@@ -143,8 +157,11 @@ async function installOpenCode(isGlobal = false) {
 
   const s = spinner();
 
+  const skillPath = isGlobal ? join("~/.config/opencode", "skills", "forge") : join(".opencode", "skills", "forge");
+
   s.start("Copiando skill a " + rel);
   copyRecursive(SKILL_SRC, target);
+  renderSkillPaths(target, skillPath);
   s.stop("Skill copiada a " + rel);
 
   s.start("Generando comandos /forge-*");
@@ -192,6 +209,9 @@ async function installAgentTemplates(agentDir, agentName) {
     writeFileSync(join(skillDest, "SKILL.md"), rendered, "utf-8");
   }
 
+  // Render {{AGENT_PATH}} in remaining .md files (command/forge.md, reference/*.md)
+  renderSkillPaths(skillDest, config.skillPath);
+
   s.stop(`${agentName} configurado en ${agentDir}/`);
   log.success(`${agentName} listo (skill + ${config.postInstall || "templates"})`);
 }