sistema-multiagente-sdlc 1.2.1 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog
 
+## [Unreleased]
+
+_No hay cambios pendientes._
+
+## [1.4.0] — 2026-05-24
+
+### Added
+
+- ADR `0004-codegraph-graphify-orden-canonico.md`: cierra la decisión pendiente de ADR 0002 y canoniza CodeGraph para estructura de código + Graphify para semántica documental/export Obsidian.
+- Runtime Node multiagente como interfaz canónica: `sdlc session-start`, `resume`, `save`, `continua`, `memory-sync`, `validate-runtime` y `hooks install --post-merge-checkpoint`.
+- `.sdlc/session.json` como estado generado de sesión para healthcheck y continuidad cross-IDE.
+- Skills canónicas `resume`, `save` y `continua` bajo `.github/skills/` y mirrors para `.claude/`, `.agents/` y `.windsurf/`, todas apuntando al mismo CLI `sdlc`.
+- `templates/scripts/continua.mjs` como implementación portable Node de continuidad; `continua.ps1` queda como wrapper Windows delgado.
+- Migración `1.4.0` con marcador `.sdlc/migrations/1.4.0-applied.txt`.
+
+### Changed
+
+- `sdlc doctor` y el runner de regresión validan la versión `1.4.0`.
+- El manifest de skills gobernadas incluye `resume`, `save` y `continua`.
+- La continuidad multiagente deja de depender de PowerShell como runtime primario; PowerShell queda para compatibilidad en Windows.
+
+### Tests
+
+- Regresión extendida con smoke tests de `session-start`, `resume`, `save --no-mutate`, `continua`, `memory-sync --mode health`, `validate-runtime` y `hooks install`.
+
+## [1.3.0] — 2026-05-23
+
+### Added
+
+- ADR `0002-codegraph-spike.md` (versión Propuesta inicial): aprobar evaluación de 7 días de [CodeGraph (colbymchenry)](https://github.com/colbymchenry/codegraph). Esta versión queda en el historial git; la versión vigente es la Aceptada del bloque "Changed" anterior.
+- ADR `0003-per-phase-model-assignment.md`: extender `templates/scripts/models.yaml` con bloque opcional `phases:` para asignar modelos distintos a fases SDD (`sdd-explore`, `sdd-design`, `sdd-implement`, `sdd-review` o F0-F17). Reduce costo en exploración manteniendo precisión en F2-F3. Inspirado por el patrón `--profile-phase` de `gentle-ai`.
+- `templates/scripts/models.yaml`: bloque `phases:` opt-in con defaults documentados (Haiku para `sdd-explore`, Opus para `sdd-design`, Sonnet para `sdd-implement`/`sdd-review`).
+- Skill `edge-case-hunter`: checklist portable para revisar entradas límite, concurrencia, fallos parciales, dependencias, autorización y volumen antes de implementación.
+- `analista-requisitos.agent.md`: protocolo de elicitación avanzada para historias ambiguas antes de pasar a diseño.
+
+### Changed
+
+- ADR `0002-codegraph-spike.md` cambia de estado **Propuesta → Aceptada**. Se reemplaza la estrategia de "spike 7 días con benchmarks sintéticos obligatorios" por **"instalar y observar"**: la adopción es coexistencia con Graphify desde el día 1, sin slice dedicado, y la verificación del ahorro de tokens claimado por CodeGraph (94 % menos tool-calls según su README) se hará por observación natural durante varias sesiones reales. El ADR ahora documenta:
+  - Reglas concretas de coexistencia (Graphify-first para razonamiento humano y `enrich-us` 4.5; CodeGraph vía MCP para queries estructurales runtime).
+  - Triggers para abrir ADR 0004 (evidencia de ahorro real, cobertura de rutas framework, o costo operativo excesivo).
+  - Implementación operativa ya ejecutada en `FacturacionDian` con scope narrow (`apps/**/src` + `packages/**/src`, `.ts/.tsx`) para evitar el OOM del index default sobre un monorepo grande.
+  - Métricas del index inicial sobre `FacturacionDian`: 658 archivos, 7.954 nodes, 14.869 edges, 14.48 MB native SQLite.
+- `scripts/validate-models-schema.mjs`: soporte para clave top-level `phases` opcional + verificación de shape `{ primary, fallback }` por fase. Bloque `phases:` declarado pero vacío produce error explícito.
+
+### Docs
+
+- README: actualizada tabla `BMAD Comparison` con realidad V6 de BMAD-METHOD (module ecosystem BMM/BMB/TEA/BMGD/CIS, Skills Architecture, Sub-Agent inclusion, scale-adaptive, Discord community) y comparación side-by-side honesta. Datos tomados del README oficial v6 de `bmad-code-org/BMAD-METHOD`.
+- README Roadmap v1.3.0: agregadas entradas `macos-latest` para `regression-install` matrix y bump de `actions/checkout@v5` + `actions/setup-node@v5` con `node-version: 24` antes del deprecation deadline de GitHub (Node 20 deprecated jun 2026, removed sep 2026).
+
 ## [1.2.1] — 2026-05-18
 
 ### UX fix — `init` sin `--target` usa cwd

package/README.md

@@ -47,6 +47,28 @@ node ./bin/sdlc.js install --target ../legacy-project --mode legacy --project-na
 node ./bin/sdlc.js doctor --target ../legacy-project --json
 ```
 
+## Runtime Multiagente
+
+Desde `1.4.0`, `sdlc` incluye comandos ejecutables para continuidad cross-IDE. El runtime primario es Node; los wrappers PowerShell solo existen para ergonomia Windows.
+
+```powershell
+sdlc session-start --target . --json
+sdlc resume --target . --markdown
+sdlc save --target . --event manual --json
+sdlc continua --target . --platform codex --json
+sdlc memory-sync --target . --mode health --json
+sdlc validate-runtime --target . --json
+sdlc hooks install --target . --post-merge-checkpoint --json
+```
+
+Reglas base:
+
+- `session-start` crea `.sdlc/session.json` con healthcheck de Headroom, CodeGraph, Graphify, caveman, vault y slice actual.
+- `resume` es solo lectura y recompone contexto en orden repo -> CodeGraph -> Graphify -> vault.
+- `save` escribe checkpoints locales en el vault; no promueve GitHub Issues, OpenSpec ni PRs sin gate humano.
+- `hooks install --post-merge-checkpoint` instala un hook local `post-merge` que ejecuta `sdlc save --event post-merge`.
+- `memory-sync --mode nightly --apply` importa chats y exporta Graphify al vault; no crea checkpoints automaticos.
+
 ## Modes
 
 | Mode | Use when | Adds |
@@ -122,21 +144,35 @@ All external installs are opt-in. Scripts default to dry-run or local-only behav
 
 ## BMAD Comparison
 
-| Feature | BMAD-METHOD | SistemaMultiagente_SDLC |
+Side-by-side de los dos frameworks. La intención no es competir sino aclarar dónde se solapan y dónde cada uno se especializa. Datos de BMAD tomados de su README oficial v6 (`bmad-code-org/BMAD-METHOD`, npm `bmad-method`).
+
+| Feature | BMAD-METHOD v6 | SistemaMultiagente_SDLC v1.4.0 |
 | --- | --- | --- |
-| AI-driven agents | 12+ personas | 8 personas plus extensible roadmap |
-| Workflows | agile | SDD waterfall by slice, agile by release |
-| Scale-adaptive | yes | reserved for v1.3.0 |
-| Party mode | yes | roundtable opt-in planned for v1.3.0 |
-| Help CLI | bmad-help | `sdlc next` planned for v1.3.0 |
-| Modules/packs | yes | packs marketplace planned for v2.0.0 |
-| Governance validators | not core | 14 validators |
-| OpenSpec/SDD | not core | integrated |
-| Readiness L1/L2/L3 | not core | integrated |
-| Multi-agent lock | not core | TTL platform-context lock |
-| Brownfield-first | no | yes |
-| Migration system | not core | backup and rollback |
-| Sanitization validators | not core | no-personal-paths and template-sanitization |
+| License | MIT | MIT |
+| Runtime requisitos | Node ≥20.12, Python ≥3.10, `uv` | Node ≥18, PowerShell (pwsh/powershell), Git |
+| Install command | `npx bmad-method install` (interactive) o `--yes --modules --tools` (CI) | `npx sistema-multiagente-sdlc init` (cwd default desde v1.2.1) |
+| Scope principal | AI-driven agile development | AI-assisted SDLC con governance enterprise y SDD |
+| Workflows | 34+ agile workflows (BMM core) | SDD waterfall por slice + agile por release (F0-F17 phases) |
+| Scale-adaptive | sí, automático (bug → enterprise) | scale hint activo desde v1.3.0 |
+| Agentes/personas | 12+ personas (PM, Architect, Dev, UX, …) | 8 personas activas + roadmap extensible |
+| Party / collaboration mode | yes (multiple personas en sesión) | roundtable opt-in planned v1.3.0 |
+| Help CLI / next-step coach | `bmad-help` skill | `sdlc doctor` (state checks); `sdlc next` planned v1.3.0 |
+| Modules / ecosystem | BMM (core) + BMB (builder) + TEA (test architect) + BMGD (game dev) + CIS (creative) | mode-based (`greenfield` / `legacy`) + extensible packs planned v2.0.0 |
+| Skills architecture | sí (V6 + Sub-Agent inclusion + Cross-Platform Agent Team) | skills mirroring across `.claude/`, `.agents/`, `.windsurf/` (`bootstrap-agent-skills.ps1`) |
+| Custom agent/workflow builder | BMad Builder v1 | personas `.agent.md` + validators (`validate-agent-persona-schema`) |
+| Dev Loop automation | en roadmap V6 | `phase-graph.yaml` + rework label-driven + lock TTL |
+| Brownfield-first | no | sí (legacy mode con research obligatorio antes de proposal) |
+| Governance validators | not core | 14 validators (config, personal-paths, template-sanitization, manifest-integrity, governance-precedence, …) |
+| OpenSpec / SDD | not core | integrated (capacidades canónicas en `openspec/specs/`) |
+| Readiness L1/L2/L3 + matriz NFR | not core | integrated (`business-production-readiness` spec) |
+| Migration system + rollback | not core | backup automático + `sdlc upgrade --to-version` + `sdlc rollback --to <id>` |
+| Multi-agent lock | not core | TTL `platform-context.json` lock |
+| Sanitization de paths/templates | not core | `validate:no-personal-paths` + `validate:template-sanitization` |
+| Provenance (SLSA) | n/d explícito | sí, SLSA v1 + signatures vía OIDC GitHub (workflow `publish.yml`) |
+| Community | Discord abierto, YouTube, X | GitHub Issues + Discussions (Discord no necesario) |
+| Trademark | BMad / BMAD-METHOD trademarks of BMad Code, LLC | sin restricción explícita más allá de MIT |
+
+Lectura corta: BMAD lidera en agile breadth y community (12+ personas, 34+ workflows, 5 módulos, Discord activo, Skills Architecture V6). SistemaMultiagente_SDLC lidera en governance + brownfield + SDD + validators (14) + migration system + readiness L1/L2/L3 + sanitization. Ambos pueden coexistir: BMAD orquesta; SistemaMultiagente_SDLC orquesta **y verifica**.
 
 ## Roadmap
 
@@ -148,6 +184,8 @@ v1.3.0:
 - calibration extensions
 - roundtable opt-in
 - docs site
+- regression-install matrix: agregar `macos-latest` (triple coverage ubuntu + windows + macos)
+- bump `actions/checkout@v5` + `actions/setup-node@v5` con `node-version: 24`; deadline GitHub: Node 20 deprecated jun 2026, removed sep 2026
 
 v2.0.0:
 

package/migrations/1.3.0/up.mjs

@@ -0,0 +1,14 @@
+export function up(files = {}) {
+  const extra = {
+    ".sdlc/migrations/1.3.0-applied.txt": "Migration 1.3.0 applied by SistemaMultiagente_SDLC.\ngenerated-by-sdlc\n"
+  };
+
+  const configPath = ".sdlc/config.json";
+  if (typeof files[configPath] === "string") {
+    const config = JSON.parse(files[configPath]);
+    config.frameworkVersion = "1.3.0";
+    extra[configPath] = `${JSON.stringify(config, null, 2)}\n`;
+  }
+
+  return extra;
+}

package/migrations/1.4.0/README.md

@@ -0,0 +1,8 @@
+# Migration 1.4.0
+
+Adds the executable runtime layer for multi-agent continuity:
+
+- Node-first `sdlc` runtime commands.
+- Generated `.sdlc/session.json`.
+- Cross-IDE `resume`, `save`, and `continua` skills.
+- Thin PowerShell wrappers for Windows convenience.

package/migrations/1.4.0/up.mjs

@@ -0,0 +1,14 @@
+export function up(files = {}) {
+  const extra = {
+    ".sdlc/migrations/1.4.0-applied.txt": "Migration 1.4.0 applied by SistemaMultiagente_SDLC.\ngenerated-by-sdlc\n"
+  };
+
+  const configPath = ".sdlc/config.json";
+  if (typeof files[configPath] === "string") {
+    const config = JSON.parse(files[configPath]);
+    config.frameworkVersion = "1.4.0";
+    extra[configPath] = `${JSON.stringify(config, null, 2)}\n`;
+  }
+
+  return extra;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sistema-multiagente-sdlc",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "description": "Framework reusable para instalar un SDLC multiagente gobernado en repos greenfield o legacy.",
   "type": "module",
   "bin": {

package/schemas/sdlc.config.schema.json

@@ -21,7 +21,7 @@
       "type": "string",
       "enum": ["bug", "feature", "epic", "platform"],
       "default": "feature",
-      "description": "Reserved for v1.3.0 adaptive scale. Not consumed in v1.2.0."
+      "description": "Scale hint used by v1.3.0+ for adaptive planning and agent routing."
     },
     "stack": {
       "type": "object",

package/scripts/validate-models-schema.mjs

@@ -25,7 +25,31 @@ for (const platform of ["claude_code", "codex", "copilot", "windsurf"]) {
   requirePattern(new RegExp(`^  ${platform}:\\s*\\n    default:\\s*\\S+`, "m"), `platform ${platform} requires default`);
 }
 
-const allowedTopLevel = new Set(["version", "updated", "roles", "platforms", "fallbacks"]);
+// Optional `phases:` block (v1.3.0+). When present, each phase entry must
+// declare primary and fallback model identifiers, same shape as `roles`.
+if (/^phases:\s*$/m.test(content)) {
+  const phasesBlockRegex = /^phases:\s*$([\s\S]*?)(?=^[A-Za-z0-9_-]+:|\Z)/m;
+  const phasesBlockMatch = phasesBlockRegex.exec(content);
+  if (phasesBlockMatch) {
+    const phasesBody = phasesBlockMatch[1];
+    const phaseEntryRegex = /^  ([A-Za-z0-9_-]+):\s*$/gm;
+    let phaseMatch;
+    let phasesFound = 0;
+    while ((phaseMatch = phaseEntryRegex.exec(phasesBody)) !== null) {
+      phasesFound += 1;
+      const phaseName = phaseMatch[1];
+      const phaseShape = new RegExp(`^  ${phaseName}:\\s*\\n    primary:\\s*\\S+\\n    fallback:\\s*\\S+`, "m");
+      if (!phaseShape.test(phasesBody)) {
+        errors.push(`phase ${phaseName} requires primary and fallback`);
+      }
+    }
+    if (phasesFound === 0) {
+      errors.push("phases block declared but contains no phase entries");
+    }
+  }
+}
+
+const allowedTopLevel = new Set(["version", "updated", "roles", "platforms", "phases", "fallbacks"]);
 for (const line of content.split("\n")) {
   const match = /^([A-Za-z0-9_-]+):/.exec(line);
   if (match && !allowedTopLevel.has(match[1])) {

package/src/cli.js

@@ -17,6 +17,15 @@ import {
 } from "./file-utils.js";
 import { buildManagedFiles, defaultConfig, FRAMEWORK_VERSION, validateConfigShape } from "./render.js";
 import { applyMigrations, migrationsToRun, SUPPORTED_VERSIONS } from "./migrations.js";
+import {
+  commandContinua,
+  commandHooks,
+  commandMemorySync,
+  commandResume,
+  commandSave,
+  commandSessionStart,
+  commandValidateRuntime
+} from "./runtime.js";
 
 const EXIT_OK = 0;
 const EXIT_ERROR = 1;
@@ -44,7 +53,10 @@ function parseArgs(argv) {
     }
     positionals.push(token);
   }
-  result.command = positionals[0] ?? "help";
+  result.positionals = positionals;
+  result.command = positionals[0] === "hooks" && positionals[1] === "install"
+    ? "hooks install"
+    : positionals[0] ?? "help";
   return result;
 }
 
@@ -392,7 +404,7 @@ function collectDoctorEnhancements(target, config) {
   }
 
   if (!config || !config.scale) {
-    findings.push({ level: "error", code: "scale-missing", message: "config.scale is required in v1.2.0" });
+    findings.push({ level: "error", code: "scale-missing", message: "config.scale is required in v1.3.0" });
   } else {
     findings.push({ level: "info", code: "scale-present", message: `scale=${config.scale}` });
   }
@@ -622,7 +634,7 @@ function commandHelp() {
     exitCode: EXIT_OK,
     payload: {
       status: "ok",
-      message: "Uso: sdlc <init|install|upgrade|rollback|doctor|diff|prune-backups|migrate-config> [--target <repo>] [--json]\nSi --target se omite, se usa el directorio actual (process.cwd())."
+      message: "Uso: sdlc <init|install|upgrade|rollback|doctor|diff|prune-backups|migrate-config|session-start|resume|save|continua|memory-sync|validate-runtime|hooks install> [--target <repo>] [--json]\nSi --target se omite, se usa el directorio actual (process.cwd())."
     }
   };
 }
@@ -645,6 +657,20 @@ export function run(argv) {
       return commandPruneBackups(parsed.options);
     case "migrate-config":
       return commandMigrateConfig(parsed.options);
+    case "session-start":
+      return commandSessionStart(parsed.options);
+    case "resume":
+      return commandResume(parsed.options);
+    case "save":
+      return commandSave(parsed.options);
+    case "continua":
+      return commandContinua(parsed.options);
+    case "memory-sync":
+      return commandMemorySync(parsed.options);
+    case "validate-runtime":
+      return commandValidateRuntime(parsed.options);
+    case "hooks install":
+      return commandHooks(parsed.options);
     case "help":
     default:
       return commandHelp();

package/src/migrations.js

@@ -1,11 +1,15 @@
 import { up as up_1_0_1 } from "../migrations/1.0.1/up.mjs";
 import { up as up_1_1_0 } from "../migrations/1.1.0/up.mjs";
 import { up as up_1_2_0 } from "../migrations/1.2.0/up.mjs";
+import { up as up_1_3_0 } from "../migrations/1.3.0/up.mjs";
+import { up as up_1_4_0 } from "../migrations/1.4.0/up.mjs";
 
 const REGISTRY = [
   { version: "1.0.1", up: up_1_0_1 },
   { version: "1.1.0", up: up_1_1_0 },
-  { version: "1.2.0", up: up_1_2_0 }
+  { version: "1.2.0", up: up_1_2_0 },
+  { version: "1.3.0", up: up_1_3_0 },
+  { version: "1.4.0", up: up_1_4_0 }
 ];
 
 function semverTuple(v) {

package/src/render.js

@@ -2,7 +2,7 @@ import path from "node:path";
 import { renderTemplates } from "./template-loader.js";
 export { validateConfigShape } from "./config-validator.js";
 
-export const FRAMEWORK_VERSION = "1.2.0";
+export const FRAMEWORK_VERSION = "1.4.0";
 export const SCHEMA_VERSION = 1;
 export const SUPPORTED_MODES = new Set(["greenfield", "legacy"]);