@ronaldjdevfs/forge 1.3.6 → 1.4.0

package/README.md

@@ -1,6 +1,6 @@
 <img src="favicon.svg" alt="Forge Logo" width="100" height="100">
 
-> **v1.3.6** — Multi-Agent Path Resolution Fix
+> **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.6",
+  "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

@@ -217,6 +217,7 @@ node --test {{AGENT_PATH}}/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.
-
-```
-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
-```
+Inicializa el proyecto arquitectónicamente con configuración persistente.
+
+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
 

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/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.6";
+
+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 {