@ronaldjdevfs/forge 1.3.5 → 1.4.0

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.4.0** — Forge Init, Auto-Fix Iterativo & Inspect Full Default
 
 ## Forge — Backend Architecture Operating System
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ronaldjdevfs/forge",
-  "version": "1.3.5",
+  "version": "1.4.0",
   "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 |
@@ -217,6 +217,7 @@ node --test .opencode/skills/forge/tests/core.test.mjs
 | Flag | Comando | Descripción |
 |------|---------|-------------|
 | `--fix` | `quench` | Auto-corrige violaciones WARNING/INFO (missing @injectable(), tsconfig, naming, container.resolve) |
+| `--auto` | `quench` | Itera fix → re-detect → fix hasta estabilizar violaciones auto-corregibles |
 | `--show-ignores` | `quench` | Muestra los inline ignores encontrados en el código |
 | `--persona=<id>` | `assay` | Filtra ensayo por una persona (bezos, fowler, hacker, pm, senior) |
 | `--save` | `assay` | Persiste ensayo en `.forge/assay/` |

package/skills/forge/command/forge.md

@@ -9,11 +9,11 @@ Si el subcomando NO tiene flags en $ARGUMENTS y tiene flags disponibles (ver tab
 
 | Comando | Flags disponibles |
 |---------|------------------|
-| `forge` | Sin flags |
+| `forge` | `--force` |
 | `cast` | Sin flags (pide nombre del feature interactivamente) |
 | `inspect` | `--json`, `--diff`, `--full`, `--summary`, `--severity=<nivel>`, `--force` |
 | `assay` | `--persona=<id>`, `--json`, `--save`, `history` |
-| `quench` | `--fix`, `--show-ignores`, `--severity=<nivel>`, `--json` |
+| `quench` | `--fix`, `--auto`, `--show-ignores`, `--severity=<nivel>`, `--json` |
 | `chain` | `--json` |
 | `graph` | `--json` |
 | `armorer` | Sin flags |
@@ -27,17 +27,19 @@ Si el subcomando NO tiene flags en $ARGUMENTS y tiene flags disponibles (ver tab
 
 ### forge
 
-Inicializa el proyecto arquitectónicamente. Ejecuta context + bootstrap + profile + armorer + graph + chain + inscribe.
+Inicializa el proyecto arquitectónicamente con configuración persistente.
 
-```
-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
-```
+1. `node {{AGENT_PATH}}/scripts/context.mjs` — detectar stack actual
+2. `node {{AGENT_PATH}}/scripts/bootstrap.mjs` — crear platform/, shared/, infra/
+3. Crear `src/features/` — si no existe
+4. `node {{AGENT_PATH}}/scripts/forge-config.mjs --init` — crear `.forge/config.json` + `.forge/state.json`
+5. `node {{AGENT_PATH}}/scripts/forge-config.mjs --update` — detectar y persistir perfil
+6. Verificar `tsconfig.json` — agregar `experimentalDecorators` y `emitDecoratorMetadata` si falta
+7. `node {{AGENT_PATH}}/scripts/armorer.mjs` — ownership
+8. `node {{AGENT_PATH}}/scripts/graph.mjs` — grafo arquitectónico
+9. `node {{AGENT_PATH}}/scripts/chain.mjs` — dependencias multi-capa
+10. `node {{AGENT_PATH}}/scripts/detect.mjs --summary` — auditoría base
+11. `node {{AGENT_PATH}}/scripts/architecture.mjs` — generar `ARCHITECTURE.md`
 
 ### cast
 
@@ -52,7 +54,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 +62,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 +80,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 +90,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 +104,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 +121,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 +129,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 +143,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/forge.md

@@ -11,20 +11,28 @@ Inicializa un proyecto para trabajar con Forge como Backend Architecture Operati
 
 ## Flujo
 
-1. Ejecutar `scripts/context.mjs` para detectar stack actual (incluye platform, features, shared, infra)
-2. Ejecutar `scripts/bootstrap.mjs` para crear layers faltantes (platform, shared, infra)
-3. Ejecutar `scripts/profile.mjs` para determinar perfil tecnológico
-4. Ejecutar `scripts/armorer.mjs` para detectar ownership y huérfanos
-5. Ejecutar `scripts/graph.mjs` para construir grafo arquitectónico global
-6. Ejecutar `scripts/chain.mjs` para analizar dependencias multi-capa
-7. Si `ARCHITECTURE.md` no existe, crearlo con `forge inscribe`
-8. Si faltan dependencias clave (según perfil), listarlas
-9. Si el proyecto tiene código legacy, sugerir `forge relocate`
-10. Si el proyecto está listo, sugerir `forge cast`
+1. Ejecutar `scripts/context.mjs` — detectar stack actual (incluye platform, features, shared, infra)
+2. Ejecutar `scripts/bootstrap.mjs` — crear layers faltantes (platform, shared, infra)
+3. Crear `src/features/` — directorio de features si no existe
+4. Ejecutar `forge-config.mjs --init` — crear `.forge/config.json` + `.forge/state.json`
+5. Ejecutar `forge-config.mjs --update` — detectar y persistir perfil tecnológico
+6. Verificar `tsconfig.json` — agregar `experimentalDecorators` y `emitDecoratorMetadata` si falta
+7. Ejecutar `scripts/armorer.mjs` — detectar ownership y huérfanos
+8. Ejecutar `scripts/graph.mjs` — construir grafo arquitectónico global
+9. Ejecutar `scripts/chain.mjs` — analizar dependencias multi-capa
+10. Ejecutar `detect.mjs --summary` — auditoría base
+11. Ejecutar `architecture.mjs` — generar `ARCHITECTURE.md`
+12. Si faltan dependencias clave (según perfil), listarlas
+13. Si el proyecto tiene código legacy, sugerir `forge relocate`
+14. Si el proyecto está listo, sugerir `forge cast`
 
 ## Output esperado
 
 - `ARCHITECTURE.md` creado en la raíz del proyecto
+- `.forge/config.json` con perfil tecnológico persistido
+- `.forge/state.json` con estado inicial
+- `src/features/` creado si no existía
+- `tsconfig.json` con `experimentalDecorators` y `emitDecoratorMetadata` habilitados
 - Layers Platform, Shared e Infrastructure creados si no existían
 - Perfil tecnológico detectado y registrado
 - Ownership analizado

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/detect.mjs

@@ -1308,6 +1308,45 @@ export function applyFixes(checks, projectRoot = ROOT) {
   return { fixed, skipped, details };
 }
 
+/**
+ * autoFixLoop — Iterative auto-fix: fix → re-detect → fix → ... until stable.
+ * Returns { totalFixed, iterations, remaining } where remaining is the filtered
+ * violations list from the last iteration.
+ */
+async function autoFixLoop(initialFiltered, maxIterations = 10) {
+  let totalFixed = 0;
+  let filtered = initialFiltered;
+  let iteration = 0;
+
+  for (; iteration < maxIterations; iteration++) {
+    const result = applyFixes(filtered);
+    if (result.fixed === 0) break;
+
+    totalFixed += result.fixed;
+
+    // Re-detect after fixes
+    const { buildContext } = await import("./context.mjs");
+    const ctx = await buildContext();
+    const features = detectFeaturesOnSrc();
+    const graph = ctx.graph || getGraph();
+    const results = allChecks(features, graph, ctx);
+
+    let all = [];
+    for (const [, cat] of Object.entries(results)) {
+      all = all.concat(cat.checks);
+    }
+
+    const allIgnores = loadAllInlineIgnores(join(ROOT, "src"));
+    filtered = all.filter(c => {
+      if (c.pass) return true;
+      if (isIgnored(c, allIgnores)) return false;
+      return true;
+    });
+  }
+
+  return { totalFixed, iterations: iteration, remaining: filtered };
+}
+
 /* ── CLI ── */
 async function main() {
   const args = process.argv.slice(2);
@@ -1315,6 +1354,7 @@ async function main() {
   const filterSeverity = args.includes("--severity") ? args[args.indexOf("--severity") + 1] : null;
   const format = args.includes("--json") ? "json" : "text";
   const doFix = args.includes("--fix");
+  const doAuto = args.includes("--auto");
   const showIgnores = args.includes("--show-ignores");
 
   const { buildContext } = await import("./context.mjs");
@@ -1356,6 +1396,29 @@ async function main() {
     return;
   }
 
+  if (doAuto) {
+    const result = await autoFixLoop(filtered);
+    console.log(`\n${BOLD}Auto-Fix Iterativo${RESET}`);
+    console.log(` ${GREEN}✔${RESET} ${result.totalFixed} violación(es) corregidas en ${result.iterations} iteración(es)`);
+    console.log();
+
+    const remaining = result.remaining.filter(c => !c.pass);
+    if (remaining.length === 0) {
+      console.log(` ${GREEN}✔${RESET} No quedan violaciones.`);
+      return;
+    }
+
+    const critical = remaining.filter(c => c.severity === "CRITICAL").length;
+    const errors = remaining.filter(c => c.severity === "ERROR").length;
+    const warnings = remaining.filter(c => c.severity === "WARNING").length;
+    console.log(` ${YELLOW}⚠${RESET} Quedan ${remaining.length} violación(es) sin corregir (${critical} CRITICAL, ${errors} ERROR, ${warnings} WARNING):\n`);
+    for (const c of remaining) {
+      console.log(formatCheck(c));
+    }
+    console.log();
+    return;
+  }
+
   // Show inline ignores summary
   let totalIgnores = 0;
   for (const [, fileIgnores] of allIgnores) {

package/skills/forge/scripts/forge-boot.mjs

@@ -105,4 +105,6 @@ async function main() {
   console.log(`Boot [${depth}]: ${result.profile.profile} | features: ${ctx.features.total} | graph: ${result.graph.stats.totalNodes}n/${result.graph.stats.totalEdges}e | violations: ${result.inspect.totalChecks} [CRIT:${result.inspect.critical} ERR:${result.inspect.errors} WARN:${result.inspect.warnings}]`);
 }
 
-main().catch(console.error);
+if (process.argv[1] && (process.argv[1].endsWith("forge-boot.mjs") || process.argv[1].endsWith("forge-boot.js"))) {
+  main().catch(console.error);
+}

package/skills/forge/scripts/forgeSentinel-lib.mjs

@@ -10,7 +10,7 @@ import { evaluateRules } from "./registry/rules.mjs";
 const ROOT = process.cwd();
 
 export async function runSentinelCheck(files, opts = {}) {
-  const { strict = false, reminder = false } = opts;
+  const { reminder = false } = opts;
 
   if (!files || files.length === 0) {
     return { violations: [], graphViolations: [], total: 0, hasCritical: false, hasErrors: false, filesChecked: 0, summary: "Sin archivos fuente modificados" };

package/skills/forge/scripts/inspect.mjs

@@ -5,7 +5,7 @@ import { execFileSync } from "child_process";
 import { buildContext } from "./context.mjs";
 import { detectProfile, detectProfileExtended } from "./profile.mjs";
 import { buildDependencyGraph } from "./chain.mjs";
-import { allChecks, checkStructure, checkLayers, checkDecorators } from "./detect.mjs";
+import { allChecks, checkStructure, checkLayers, checkDecorators, detectFeaturesOnSrc } from "./detect.mjs";
 import { saveHistory, updateStateFromAudit } from "./forge-config.mjs";
 import { buildPipeline, printPipeline } from "./recommendation-engine.mjs";
 
@@ -217,7 +217,7 @@ function getChangedFeatures(changedFiles, allFeatures) {
 async function main() {
   const args = process.argv.slice(2);
   const isJson = args.includes("--json");
-  const isDiff = args.includes("--diff") || !args.includes("--full");
+  const isDiff = args.includes("--diff");
   const isSummary = args.includes("--summary");
   const force = args.includes("--force");
   const filterSeverity = args.includes("--severity") ? args[args.indexOf("--severity") + 1] : null;
@@ -227,7 +227,7 @@ async function main() {
   const profile = profileExtended.profile;
   const archGraph = ctx.graph;
   const chainGraph = buildDependencyGraph(process.cwd(), archGraph);
-  const features = ctx.features.migrated;
+  const features = detectFeaturesOnSrc();
 
   if (isSummary) {
     const result = allChecks(features, archGraph, ctx);
@@ -267,7 +267,8 @@ async function main() {
     if (changedFeatures.length === 0) {
       if (!isJson) {
         console.log(`\n${YELLOW}⚠ No hay features afectados por los cambios.${RESET}`);
-        console.log(`${DIM}Los cambios están fuera de src/features/ o no hay features migrados.${RESET}\n`);
+        console.log(`${DIM}Los cambios están fuera de src/features/ o no hay features migrados.${RESET}`);
+        console.log(`${DIM}Usá 'inspect --full' para un análisis completo de todo el proyecto.${RESET}\n`);
       } else {
         console.log(JSON.stringify({ diff: { changedFiles: changedFiles.length, changedFeatures: [], affectedFeatures: false } }));
       }

package/skills/forge/scripts/update.mjs

@@ -11,13 +11,32 @@
  */
 
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
-import { join } from "path";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
 
+const __dirname = dirname(fileURLToPath(import.meta.url));
 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";
+
+function readVersion() {
+  const candidates = [
+    join(__dirname, "..", "package.json"),
+    join(__dirname, "..", "..", "package.json"),
+    join(__dirname, "..", "..", "..", "package.json"),
+    join(__dirname, "..", "..", "..", "..", "package.json"),
+    join(__dirname, "..", "..", "..", "..", "..", "package.json"),
+  ];
+  for (const p of candidates) {
+    try {
+      const pkg = JSON.parse(readFileSync(p, "utf-8"));
+      if (pkg.version && pkg.name === "@ronaldjdevfs/forge") return pkg.version;
+    } catch {}
+  }
+  return "0.0.0";
+}
+const CURRENT_VERSION = readVersion();
 
 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"})`);
 }