@specatlas/core 0.1.22 → 0.1.25

package/dist/index.js

@@ -794,14 +794,14 @@ function wordBoundary(text, term) {
   const re = new RegExp(`(?<![\\p{L}\\p{N}])${escaped}(?![\\p{L}\\p{N}])`, "iu");
   return re.test(text);
 }
-function lintText(text, code, terms, label, path19, line) {
+function lintText(text, code, terms, label, path22, line) {
   const out = [];
   const lower = text.toLowerCase();
   for (const term of terms) {
     if (wordBoundary(lower, term)) {
       out.push(
         diag(code, "error", `${label}: "${term}"`, {
-          path: path19,
+          path: path22,
           line,
           suggestion: "La especificaci\xF3n es funcional y de negocio: describe comportamiento, no tecnolog\xEDa ni adjetivos vagos"
         })
@@ -810,7 +810,7 @@ function lintText(text, code, terms, label, path19, line) {
   }
   return out;
 }
-function lintRequirement(req, path19, opts = {}) {
+function lintRequirement(req, path22, opts = {}) {
   const out = [];
   const vague = opts.language === "en" ? VAGUE_EN : VAGUE_ES;
   const tech = opts.language === "en" ? TECH_EN : TECH_ES;
@@ -821,32 +821,32 @@ function lintRequirement(req, path19, opts = {}) {
     ...req.scenarios.flatMap((s) => [...s.when.map((w) => ({ text: w, line: s.line })), ...s.then.map((t) => ({ text: t, line: s.line }))])
   ];
   for (const part of parts) {
-    out.push(...lintText(part.text, "LINT-BIZ-002", vague, "Palabra vaga en la especificaci\xF3n", path19, part.line));
+    out.push(...lintText(part.text, "LINT-BIZ-002", vague, "Palabra vaga en la especificaci\xF3n", path22, part.line));
     if (opts.businessOnly !== false) {
-      out.push(...lintText(part.text, "LINT-BIZ-001", tech, "Jerga t\xE9cnica en la especificaci\xF3n de negocio", path19, part.line));
+      out.push(...lintText(part.text, "LINT-BIZ-001", tech, "Jerga t\xE9cnica en la especificaci\xF3n de negocio", path22, part.line));
     }
   }
   if (req.scenarios.length === 0) {
-    out.push(diag("TRACE-001", "error", `El requisito ${req.id} no tiene ning\xFAn escenario`, { path: path19, line: req.line, suggestion: "A\xF1ade al menos un escenario CUANDO/ENTONCES" }));
+    out.push(diag("TRACE-001", "error", `El requisito ${req.id} no tiene ning\xFAn escenario`, { path: path22, line: req.line, suggestion: "A\xF1ade al menos un escenario CUANDO/ENTONCES" }));
   }
   return out;
 }
-function lintDelta(delta, livingRequirements, path19, opts = {}) {
+function lintDelta(delta, livingRequirements, path22, opts = {}) {
   const out = [...delta.diagnostics];
   for (const req of [...delta.added, ...delta.modified]) {
-    out.push(...lintRequirement(req, path19, opts));
+    out.push(...lintRequirement(req, path22, opts));
   }
   for (const req of delta.modified) {
     const living = livingRequirements.get(req.id);
     if (!living) {
-      out.push(diag("TRACE-007", "error", `MODIFIED ${req.id} no existe en la spec viva; usa ADDED`, { path: path19, line: req.line }));
+      out.push(diag("TRACE-007", "error", `MODIFIED ${req.id} no existe en la spec viva; usa ADDED`, { path: path22, line: req.line }));
       continue;
     }
     for (const existing of living.scenarios) {
       if (!req.scenarios.some((s) => s.id === existing.id)) {
         out.push(
           diag("TRACE-007", "error", `MODIFIED ${req.id} pierde el escenario ${existing.id}: copia el bloque completo`, {
-            path: path19,
+            path: path22,
             line: req.line,
             suggestion: "Copia el bloque completo de la spec viva y ed\xEDtalo; para quitarlo, decl\xE1ralo en REMOVED"
           })
@@ -857,15 +857,15 @@ function lintDelta(delta, livingRequirements, path19, opts = {}) {
   for (const req of delta.removed) {
     const living = livingRequirements.get(req.id);
     if (!living) {
-      out.push(diag("TRACE-007", "error", `REMOVED ${req.id} no existe en la spec viva`, { path: path19, line: req.line }));
+      out.push(diag("TRACE-007", "error", `REMOVED ${req.id} no existe en la spec viva`, { path: path22, line: req.line }));
     }
   }
   for (const rename2 of delta.renamed) {
     if (rename2.from.id !== rename2.to.id) {
-      out.push(diag("LINT-DLT-003", "error", `RENAMED cambia el id (${rename2.from.id} \u2192 ${rename2.to.id}); los ids son inmutables`, { path: path19, line: rename2.line }));
+      out.push(diag("LINT-DLT-003", "error", `RENAMED cambia el id (${rename2.from.id} \u2192 ${rename2.to.id}); los ids son inmutables`, { path: path22, line: rename2.line }));
     }
     if (!livingRequirements.has(rename2.from.id)) {
-      out.push(diag("TRACE-007", "error", `RENAMED ${rename2.from.id} no existe en la spec viva`, { path: path19, line: rename2.line }));
+      out.push(diag("TRACE-007", "error", `RENAMED ${rename2.from.id} no existe en la spec viva`, { path: path22, line: rename2.line }));
     }
   }
   return out;
@@ -895,7 +895,7 @@ var MERMAID_KEYWORDS = [
   "architecture-beta"
 ];
 var MERMAID_BLOCKS = /^\s*(alt|loop|opt|par|rect|critical|break|subgraph)\b/;
-function lintPlan(planText, path19) {
+function lintPlan(planText, path22) {
   const out = [];
   const blocks = [...planText.matchAll(/```mermaid\r?\n([\s\S]*?)```/g)];
   for (const [index, block] of blocks.entries()) {
@@ -905,7 +905,7 @@ function lintPlan(planText, path19) {
     if (!MERMAID_KEYWORDS.some((keyword) => first.startsWith(keyword))) {
       out.push(
         diag("LINT-PLN-002", "error", `Diagrama mermaid ${index + 1}: la primera l\xEDnea debe declarar el tipo (${MERMAID_KEYWORDS.slice(0, 5).join(", ")}\u2026) y empieza por "${first.slice(0, 30)}"`, {
-          path: path19,
+          path: path22,
           suggestion: "Corrige el tipo del diagrama o elimina el bloque"
         })
       );
@@ -919,7 +919,7 @@ function lintPlan(planText, path19) {
     if (open !== 0) {
       out.push(
         diag("LINT-PLN-002", "error", `Diagrama mermaid ${index + 1}: faltan ${Math.abs(open)} \`end\` (bloques alt/loop/subgraph sin cerrar)`, {
-          path: path19,
+          path: path22,
           suggestion: "Cierra cada bloque alt/loop/opt/par/rect/subgraph con `end`"
         })
       );
@@ -931,7 +931,7 @@ function lintPlan(planText, path19) {
         if (message.includes(";")) {
           out.push(
             diag("LINT-PLN-003", "error", `Diagrama mermaid ${index + 1}: el mensaje "${message.trim().slice(0, 40)}\u2026" usa \`;\` y mermaid lo interpreta como fin de sentencia`, {
-              path: path19,
+              path: path22,
               suggestion: "Sustituye `;` por `\xB7` o `,` en los mensajes de sequenceDiagram"
             })
           );
@@ -1088,6 +1088,16 @@ function checkTrace(input) {
       findings.push(diag("TRACE-006", "warning", `Evidencia hu\xE9rfana: ${ev.scenario} no existe`, { path: change.verify?.path, line: ev.line }));
     }
   }
+  for (const cover of change.fixCovers ?? []) {
+    if (!livingReqs.has(cover)) {
+      findings.push(
+        diag("TRACE-011", "warning", `El fix ${change.slug} declara ${cover}, que no existe en las specs vivas`, {
+          path: change.fix?.path,
+          suggestion: "Corrige el identificador o qu\xEDtalo: la declaraci\xF3n es opcional"
+        })
+      );
+    }
+  }
   const summary = countBySeverity(findings);
   return { graph: buildTraceGraph(input), findings, summary };
 }
@@ -1463,35 +1473,117 @@ function detectionToYaml(result, generatedAt) {
 }
 
 // src/workspace.ts
+import path5 from "path";
+
+// src/fixes.ts
 import path4 from "path";
+import { stringify as stringifyYaml3 } from "yaml";
+var LIVING_FIXES_DIR = path4.join(".sdd", "fixes");
+var COMMENT_RE = /<!--[\s\S]*?-->/g;
+function parseFixCovers(content) {
+  const clean = content.replace(COMMENT_RE, "");
+  const covers = [];
+  for (const line of clean.replace(/\r\n?/g, "\n").split("\n")) {
+    const match = /^\s*-?\s*Cubre:\s*(.+?)\s*$/.exec(line);
+    if (!match) continue;
+    for (const raw of (match[1] ?? "").split(",")) {
+      const id = raw.trim().toUpperCase();
+      if (/^REQ-[A-Z0-9-]+$/.test(id) && !covers.includes(id)) covers.push(id);
+    }
+  }
+  return covers;
+}
+function coversOf(value) {
+  if (Array.isArray(value)) {
+    return value.map((v) => String(v).trim().toUpperCase()).filter((v) => /^REQ-[A-Z0-9-]+$/.test(v));
+  }
+  if (typeof value === "string") {
+    return value.split(",").map((v) => v.trim().toUpperCase()).filter((v) => /^REQ-[A-Z0-9-]+$/.test(v));
+  }
+  return [];
+}
+function parseLivingFix(content, file) {
+  const fm = parseFrontmatter(content, file);
+  const data = fm.data;
+  const base = path4.basename(file).replace(/\.md$/i, "");
+  const slug = typeof data["slug"] === "string" && data["slug"].trim() !== "" ? data["slug"].trim() : base.replace(/^\d{4}-\d{2}-/, "");
+  const fix = {
+    slug,
+    file,
+    date: typeof data["date"] === "string" ? data["date"] : "",
+    result: typeof data["result"] === "string" ? data["result"] : "pass",
+    covers: coversOf(data["covers"]),
+    content: fm.body.trimStart()
+  };
+  if (typeof data["domain"] === "string") fix.domain = data["domain"];
+  if (typeof data["title"] === "string") fix.title = data["title"];
+  return fix;
+}
+async function loadLivingFixes(root) {
+  const dir = path4.join(root, LIVING_FIXES_DIR);
+  const entries = (await listDir(dir)).filter((entry) => entry.toLowerCase().endsWith(".md")).sort();
+  const fixes = [];
+  for (const entry of entries) {
+    const file = path4.join(dir, entry);
+    const content = await readTextIfExists(file);
+    if (content === void 0) continue;
+    fixes.push(parseLivingFix(content, file));
+  }
+  return fixes.sort((a, b) => b.date.localeCompare(a.date) || b.slug.localeCompare(a.slug));
+}
+async function writeLivingFix(root, input) {
+  const dir = path4.join(root, LIVING_FIXES_DIR);
+  const month = input.date.slice(0, 7);
+  const file = path4.join(dir, `${month}-${input.slug}.md`);
+  const relativePath = toPosix(path4.relative(root, file));
+  if (await exists(file)) return { file, relativePath, created: false };
+  const data = {
+    slug: input.slug,
+    date: input.date,
+    result: input.result ?? "pass"
+  };
+  if (input.domain) data["domain"] = input.domain;
+  if (input.title) data["title"] = input.title;
+  if (input.covers && input.covers.length > 0) data["covers"] = input.covers;
+  const body = input.content.replace(/^[\r\n]+/, "").trimEnd();
+  const text = `---
+${stringifyYaml3(data, { lineWidth: 120 })}---
+
+${body}
+`;
+  await writeText(file, text);
+  return { file, relativePath, created: true };
+}
+
+// src/workspace.ts
 var SDD_DIR = ".sdd";
 async function findWorkspaceRoot(start) {
-  let current = path4.resolve(start);
+  let current = path5.resolve(start);
   for (let i = 0; i < 40; i += 1) {
-    if (await isDirectory(path4.join(current, SDD_DIR))) return current;
-    const parent = path4.dirname(current);
+    if (await isDirectory(path5.join(current, SDD_DIR))) return current;
+    const parent = path5.dirname(current);
     if (parent === current) return void 0;
     current = parent;
   }
   return void 0;
 }
 async function loadApprovals(sddDir) {
-  const file = path4.join(sddDir, "approvals.yaml");
+  const file = path5.join(sddDir, "approvals.yaml");
   const raw = await readTextIfExists(file);
   if (raw === void 0) return { byArtifact: /* @__PURE__ */ new Map(), diagnostics: [] };
   const parsed = parseApprovals(raw, file);
   const map = /* @__PURE__ */ new Map();
   for (const a of parsed.approvals?.approvals ?? []) {
-    map.set(a.artifact.split(path4.sep).join("/"), { hash: a.artifactHash, by: a.approvedBy, at: a.approvedAt });
+    map.set(a.artifact.split(path5.sep).join("/"), { hash: a.artifactHash, by: a.approvedBy, at: a.approvedAt });
   }
   return { byArtifact: map, diagnostics: parsed.diagnostics };
 }
 async function loadSpecs(sddDir) {
-  const specsDir = path4.join(sddDir, "specs");
+  const specsDir = path5.join(sddDir, "specs");
   const domains = await listDirs(specsDir);
   const out = [];
   for (const domain of domains) {
-    const file = path4.join(specsDir, domain, "spec.md");
+    const file = path5.join(specsDir, domain, "spec.md");
     if (!await exists(file)) continue;
     const content = await readText(file);
     out.push({ domain, path: file, spec: parseSpecFile(content, file) });
@@ -1499,10 +1591,10 @@ async function loadSpecs(sddDir) {
   return out;
 }
 async function loadChange(root, slug, relDir) {
-  const dir = path4.join(root, SDD_DIR, "changes", relDir ?? slug);
+  const dir = path5.join(root, SDD_DIR, "changes", relDir ?? slug);
   const diagnostics = [];
   const change = { slug, dir, diagnostics };
-  const metaFile = path4.join(dir, "meta.yaml");
+  const metaFile = path5.join(dir, "meta.yaml");
   const metaRaw = await readTextIfExists(metaFile);
   if (metaRaw === void 0) {
     diagnostics.push(diag("ATLAS-FILES-001", "error", `El cambio "${slug}" no tiene meta.yaml`, { path: metaFile, suggestion: "Crea meta.yaml con slug, lane y dominio" }));
@@ -1511,7 +1603,7 @@ async function loadChange(root, slug, relDir) {
     diagnostics.push(...parsed.diagnostics);
     if (parsed.meta) change.meta = parsed.meta;
   }
-  const deltaFile = path4.join(dir, "spec.md");
+  const deltaFile = path5.join(dir, "spec.md");
   const deltaRaw = await readTextIfExists(deltaFile);
   if (deltaRaw !== void 0) {
     change.delta = parseDelta(deltaRaw, deltaFile);
@@ -1519,41 +1611,42 @@ async function loadChange(root, slug, relDir) {
   } else {
     diagnostics.push(diag("ATLAS-FILES-002", "warning", `El cambio "${slug}" no tiene spec.md (delta)`, { path: deltaFile }));
   }
-  const planFile = path4.join(dir, "plan.md");
+  const planFile = path5.join(dir, "plan.md");
   if (await exists(planFile)) change.planPath = planFile;
-  const reviewFile = path4.join(dir, "review.md");
+  const reviewFile = path5.join(dir, "review.md");
   if (await exists(reviewFile)) change.reviewPath = reviewFile;
-  const presentationFile = path4.join(dir, "presentation", "index.html");
+  const presentationFile = path5.join(dir, "presentation", "index.html");
   if (await exists(presentationFile)) change.presentationPath = presentationFile;
-  const tasksFile = path4.join(dir, "tasks.md");
+  const tasksFile = path5.join(dir, "tasks.md");
   const tasksRaw = await readTextIfExists(tasksFile);
   if (tasksRaw !== void 0) {
     change.tasks = parseTasksFile(tasksRaw, tasksFile);
     diagnostics.push(...change.tasks.diagnostics);
   }
-  const verifyFile = path4.join(dir, "verify.md");
+  const verifyFile = path5.join(dir, "verify.md");
   const verifyRaw = await readTextIfExists(verifyFile);
   if (verifyRaw !== void 0) {
     change.verify = parseVerifyFile(verifyRaw, verifyFile);
     diagnostics.push(...change.verify.diagnostics);
   }
-  const fixFile = path4.join(dir, "fix.md");
+  const fixFile = path5.join(dir, "fix.md");
   const fixRaw = await readTextIfExists(fixFile);
   if (fixRaw !== void 0) {
     change.fix = parseVerifyFile(fixRaw, fixFile);
     diagnostics.push(...change.fix.diagnostics);
+    change.fixCovers = parseFixCovers(fixRaw);
   }
-  const mockupManifest = path4.join(dir, "mockups", "manifest.yaml");
+  const mockupManifest = path5.join(dir, "mockups", "manifest.yaml");
   if (await exists(mockupManifest)) change.mockupManifestPath = mockupManifest;
   return change;
 }
 async function listChangeSlugs(root, opts = {}) {
-  const changesDir = path4.join(root, SDD_DIR, "changes");
+  const changesDir = path5.join(root, SDD_DIR, "changes");
   const dirs = await listDirs(changesDir);
   return dirs.filter((d) => opts.includeArchived ? true : d !== "archive");
 }
 async function loadWorkspace(root) {
-  const sddDir = path4.join(root, SDD_DIR);
+  const sddDir = path5.join(root, SDD_DIR);
   const { config, diagnostics: configDiags } = await loadConfig(sddDir);
   const diagnostics = [...configDiags];
   const specs = await loadSpecs(sddDir);
@@ -1566,20 +1659,20 @@ async function loadWorkspace(root) {
     diagnostics.push(...change.diagnostics);
   }
   const archived = [];
-  const archivedDir = path4.join(sddDir, "changes", "archive");
+  const archivedDir = path5.join(sddDir, "changes", "archive");
   if (await isDirectory(archivedDir)) {
     for (const entry of await listDirs(archivedDir)) {
-      archived.push(await loadChange(root, entry.replace(/^\d{4}-\d{2}-/, ""), path4.join("archive", entry)));
+      archived.push(await loadChange(root, entry.replace(/^\d{4}-\d{2}-/, ""), path5.join("archive", entry)));
     }
   }
   return { workspace: { root, sddDir, specs, changes, archived, diagnostics }, config };
 }
 async function ensureSddDirs(sddDir) {
   const created = [];
-  const dirs = ["specs", "changes", "runs", "metrics", path4.join("profiles", "custom")];
+  const dirs = ["specs", "changes", "runs", "metrics", "fixes", path5.join("profiles", "custom")];
   const { ensureDir: ensureDir2 } = await import("./fsx-VF2P7ALA.js");
   for (const d of dirs) {
-    const full = path4.join(sddDir, d);
+    const full = path5.join(sddDir, d);
     if (!await exists(full)) {
       await ensureDir2(full);
       created.push(full);
@@ -1589,7 +1682,7 @@ async function ensureSddDirs(sddDir) {
 }
 
 // src/templates.ts
-import { stringify as stringifyYaml3 } from "yaml";
+import { stringify as stringifyYaml4 } from "yaml";
 var ES = {
   constitution: `# Constituci\xF3n del proyecto
 
@@ -1750,6 +1843,10 @@ notes: 12/12 casos
 
 ## Evidencia
 
+<!-- Opcional: declara los requisitos que este fix afecta (aparecen en su trazabilidad).
+Cubre: REQ-DOMINIO-001
+-->
+
 <!-- Registra la evidencia real con:
 satlas verify <slug> --file fix --scenario REQ-DOMINIO-001-S1 --command "<comando>" --by "<nombre>"
 o, si es manual:
@@ -1873,6 +1970,10 @@ by: your-name
 ## Rollback
 ## Evidence
 
+<!-- Optional: declare the requirements this fix affects (they show up in its traceability).
+Cubre: REQ-DOMAIN-001
+-->
+
 <!-- Register real evidence with:
 satlas verify <slug> --file fix --scenario REQ-DOMAIN-001-S1 --command "<command>" --by "<name>"
 -->
@@ -1897,7 +1998,7 @@ function changeMetaYaml(meta) {
   if (meta.owner) doc["owner"] = meta.owner;
   if (meta.mockups) doc["mockups"] = meta.mockups;
   return `# Estado del cambio. La fase se DERIVA de los artefactos; aqu\xED solo hechos.
-` + stringifyYaml3(doc, { lineWidth: 120 });
+` + stringifyYaml4(doc, { lineWidth: 120 });
 }
 function indexMarkdown(input) {
   const es = input.language !== "en";
@@ -1911,6 +2012,15 @@ function indexMarkdown(input) {
   if (input.specs.length === 0) lines.push(es ? "_Sin specs todav\xEDa._" : "_No specs yet._");
   for (const spec of input.specs) lines.push(`- \`${spec.domain}\` \u2014 ${spec.requirements} ${es ? "requisitos" : "requirements"}`);
   lines.push("");
+  lines.push(es ? "## Fixes vivos" : "## Living fixes");
+  lines.push("");
+  const fixes = input.fixes ?? [];
+  if (fixes.length === 0) lines.push(es ? "_Sin fixes archivados todav\xEDa._" : "_No archived fixes yet._");
+  for (const fix of fixes) {
+    const parts = [fix.date, fix.domain ? `\`${fix.domain}\`` : "", `\`${fix.slug}\``, fix.result].filter((part) => part !== "");
+    lines.push(`- ${parts.join(" \xB7 ")}`);
+  }
+  lines.push("");
   lines.push(es ? "## Cambios activos" : "## Active changes");
   lines.push("");
   if (input.changes.length === 0) lines.push(es ? "_Sin cambios activos._" : "_No active changes._");
@@ -1926,7 +2036,7 @@ ${input.archived} change(s) in \`changes/archive/\`.`);
 }
 
 // src/github.ts
-import path5 from "path";
+import path6 from "path";
 import { parse as parseYaml5 } from "yaml";
 
 // src/exec.ts
@@ -2071,8 +2181,8 @@ function issueBody(input) {
   lines.push(`- Siguiente: \`${input.next}\` \u2014 ${input.nextDescription}`);
   lines.push("");
   lines.push("### Artefactos");
-  lines.push(`- Spec: \`${path5.posix.join(".sdd", "changes", change.slug, "spec.md")}\``);
-  if (change.planPath) lines.push(`- Plan: \`${path5.posix.join(".sdd", "changes", change.slug, "plan.md")}\``);
+  lines.push(`- Spec: \`${path6.posix.join(".sdd", "changes", change.slug, "spec.md")}\``);
+  if (change.planPath) lines.push(`- Plan: \`${path6.posix.join(".sdd", "changes", change.slug, "plan.md")}\``);
   if (change.tasks) lines.push(`- Tareas: ${change.tasks.counts.done}/${change.tasks.counts.total}`);
   if (change.verify) lines.push(`- Evidencia registrada: ${change.verify.evidence.length}`);
   lines.push("");
@@ -2140,10 +2250,10 @@ async function commentIssue(root, number, body, runner = defaultRunner) {
   return result.ok ? [] : [diag("ATLAS-GH-006", "error", `No se pudo comentar el issue #${number}: ${(result.stderr || result.stdout).trim().slice(0, 300)}`)];
 }
 async function patchChangeMeta(root, slug, patch) {
-  const file = path5.join(path5.resolve(root), ".sdd", "changes", slug, "meta.yaml");
+  const file = path6.join(path6.resolve(root), ".sdd", "changes", slug, "meta.yaml");
   const raw = await readTextIfExists(file);
   if (raw === void 0) {
-    return { path: file, diagnostics: [diag("ATLAS-GH-007", "error", `No existe ${path5.relative(root, file)}`)] };
+    return { path: file, diagnostics: [diag("ATLAS-GH-007", "error", `No existe ${path6.relative(root, file)}`)] };
   }
   let data;
   try {
@@ -2197,7 +2307,7 @@ async function approveFromGithub(opts) {
   const { signApproval: signApproval2 } = await import("./approvals-2PO6223I.js");
   const signed = await signApproval2({
     root: opts.root,
-    artifact: path5.posix.join("changes", opts.slug, "spec.md"),
+    artifact: path6.posix.join("changes", opts.slug, "spec.md"),
     by,
     channel: "tracker",
     note: `Aprobado v\xEDa GitHub issue #${number} (etiqueta "${label}")`
@@ -2257,7 +2367,7 @@ async function syncGithubIssue(root, slug, opts = {}) {
 }
 
 // src/evidence.ts
-import path6 from "path";
+import path7 from "path";
 var SCENARIO_HEAD_RE2 = /^###\s+(REQ-[A-Z0-9-]+-S\d+)\b/;
 function locateBlocks(content) {
   const normalized = content.replace(/\r\n?/g, "\n");
@@ -2295,10 +2405,10 @@ function buildEvidenceYaml(evidence) {
   return lines.join("\n");
 }
 async function recordEvidence(opts) {
-  const root = path6.resolve(opts.root);
+  const root = path7.resolve(opts.root);
   const slug = opts.slug;
   const fileKind = opts.file ?? "verify";
-  const file = path6.join(root, ".sdd", "changes", slug, fileKind === "fix" ? "fix.md" : "verify.md");
+  const file = path7.join(root, ".sdd", "changes", slug, fileKind === "fix" ? "fix.md" : "verify.md");
   const diagnostics = [];
   const scenario = opts.scenario.toUpperCase();
   if (!SCENARIO_ID_RE.test(scenario)) {
@@ -2395,7 +2505,7 @@ function evidenceSummary(content) {
 }
 
 // src/runs.ts
-import path7 from "path";
+import path8 from "path";
 import { randomBytes } from "crypto";
 var RUN_EVENT_TYPES = [
   "run_started",
@@ -2421,7 +2531,7 @@ function generateRunId(now = /* @__PURE__ */ new Date()) {
   return `${iso.slice(0, 8)}-${iso.slice(8, 14)}-${randomBytes(3).toString("hex")}`;
 }
 function runsDir(root) {
-  return path7.join(path7.resolve(root), ".sdd", "runs");
+  return path8.join(path8.resolve(root), ".sdd", "runs");
 }
 async function createRun(root, slug, phase, inputs, now = /* @__PURE__ */ new Date()) {
   const runId = generateRunId(now);
@@ -2434,25 +2544,25 @@ async function createRun(root, slug, phase, inputs, now = /* @__PURE__ */ new Da
     updatedAt: localStamp(now)
   };
   if (inputs) state.inputs = inputs;
-  const dir = path7.join(runsDir(root), runId);
+  const dir = path8.join(runsDir(root), runId);
   await ensureDir(dir);
-  await writeText(path7.join(dir, "state.json"), `${JSON.stringify(state, null, 2)}
+  await writeText(path8.join(dir, "state.json"), `${JSON.stringify(state, null, 2)}
 `);
-  await writeText(path7.join(dir, "events.jsonl"), "");
+  await writeText(path8.join(dir, "events.jsonl"), "");
   await appendRunEvent(root, runId, "run_started", { slug, phase });
   return state;
 }
 async function appendRunEvent(root, runId, type, data, now = /* @__PURE__ */ new Date()) {
   const event = { eventId: randomBytes(4).toString("hex"), at: localStamp(now), type };
   if (data) event.data = data;
-  const file = path7.join(runsDir(root), runId, "events.jsonl");
+  const file = path8.join(runsDir(root), runId, "events.jsonl");
   const previous = await readTextIfExists(file) ?? "";
   await writeText(file, `${previous}${JSON.stringify(event)}
 `);
   return event;
 }
 async function updateRunStatus(root, runId, status, now = /* @__PURE__ */ new Date()) {
-  const file = path7.join(runsDir(root), runId, "state.json");
+  const file = path8.join(runsDir(root), runId, "state.json");
   const raw = await readTextIfExists(file);
   if (raw === void 0) return;
   const state = JSON.parse(raw);
@@ -2462,13 +2572,13 @@ async function updateRunStatus(root, runId, status, now = /* @__PURE__ */ new Da
 `);
 }
 async function readRun(root, runId) {
-  const dir = path7.join(runsDir(root), runId);
-  const stateRaw = await readTextIfExists(path7.join(dir, "state.json"));
+  const dir = path8.join(runsDir(root), runId);
+  const stateRaw = await readTextIfExists(path8.join(dir, "state.json"));
   if (stateRaw === void 0) {
     return { diagnostics: [diag("ATLAS-RUN-001", "error", `No existe el run ${runId}`, { path: dir })] };
   }
   const state = JSON.parse(stateRaw);
-  const eventsRaw = await readTextIfExists(path7.join(dir, "events.jsonl")) ?? "";
+  const eventsRaw = await readTextIfExists(path8.join(dir, "events.jsonl")) ?? "";
   const events = [];
   for (const line of eventsRaw.split("\n")) {
     if (line.trim() === "") continue;
@@ -2485,7 +2595,7 @@ async function listRuns(root, filter = {}) {
   const ids = await listDirs(dir);
   const out = [];
   for (const id of ids) {
-    const raw = await readTextIfExists(path7.join(dir, id, "state.json"));
+    const raw = await readTextIfExists(path8.join(dir, id, "state.json"));
     if (raw === void 0) continue;
     try {
       const state = JSON.parse(raw);
@@ -2499,11 +2609,11 @@ async function listRuns(root, filter = {}) {
 }
 
 // src/analyze.ts
-import path10 from "path";
+import path11 from "path";
 
 // src/mockups.ts
-import path8 from "path";
-import { parse as parseYaml6, stringify as stringifyYaml4 } from "yaml";
+import path9 from "path";
+import { parse as parseYaml6, stringify as stringifyYaml5 } from "yaml";
 import { z as z4 } from "zod";
 var mockupManifestSchema = z4.object({
   schema_version: z4.number().int().positive().default(1),
@@ -2528,20 +2638,20 @@ var mockupManifestSchema = z4.object({
 });
 var TOKEN_CANDIDATES = ["design/tokens.json", "DESIGN.md", "design/DESIGN.md", ".sdd/design/tokens.json"];
 function mockupsDir(root, slug) {
-  return path8.join(path8.resolve(root), ".sdd", "changes", slug, "mockups");
+  return path9.join(path9.resolve(root), ".sdd", "changes", slug, "mockups");
 }
 async function tokensFile(root) {
   for (const candidate of TOKEN_CANDIDATES) {
-    const abs = path8.join(root, candidate);
+    const abs = path9.join(root, candidate);
     if (await exists(abs)) return candidate;
   }
   return void 0;
 }
 async function computeInputsHash(root, change) {
-  const deltaPath = path8.join(change.dir, "spec.md");
+  const deltaPath = path9.join(change.dir, "spec.md");
   const delta = await readTextIfExists(deltaPath) ?? "";
   const tokens = await tokensFile(root);
-  const tokensContent = tokens ? await readTextIfExists(path8.join(root, tokens)) ?? "" : "";
+  const tokensContent = tokens ? await readTextIfExists(path9.join(root, tokens)) ?? "" : "";
   return artifactHash(`${delta}
 ---tokens---
 ${tokensContent}`);
@@ -2566,7 +2676,7 @@ function planMockups(change, platform = "web") {
   return { platform, screens };
 }
 async function readMockupManifest(root, slug) {
-  const file = path8.join(mockupsDir(root, slug), "manifest.yaml");
+  const file = path9.join(mockupsDir(root, slug), "manifest.yaml");
   const raw = await readTextIfExists(file);
   if (raw === void 0) return { diagnostics: [] };
   let data;
@@ -2658,7 +2768,7 @@ async function checkMockups(root, slug, change) {
   const { manifest, path: manifestPath, diagnostics } = await readMockupManifest(root, slug);
   const findings = [...diagnostics];
   if (!manifest || !manifestPath) {
-    return { findings: [...findings, diag("LINT-MKP-004", "error", "No existe mockups/manifest.yaml", { path: path8.join(dir, "manifest.yaml") })], stale: false };
+    return { findings: [...findings, diag("LINT-MKP-004", "error", "No existe mockups/manifest.yaml", { path: path9.join(dir, "manifest.yaml") })], stale: false };
   }
   const known = /* @__PURE__ */ new Set();
   for (const req of [...change.delta?.added ?? [], ...change.delta?.modified ?? []]) {
@@ -2666,12 +2776,12 @@ async function checkMockups(root, slug, change) {
   }
   findings.push(...lintMockupManifest(manifest, known, manifestPath));
   for (const screen of manifest.screens) {
-    const html = await readTextIfExists(path8.join(dir, screen.file));
+    const html = await readTextIfExists(path9.join(dir, screen.file));
     if (html === void 0) {
-      findings.push(diag("ATLAS-MKP-004", "error", `Falta el archivo del mockup: ${screen.file}`, { path: path8.join(dir, screen.file) }));
+      findings.push(diag("ATLAS-MKP-004", "error", `Falta el archivo del mockup: ${screen.file}`, { path: path9.join(dir, screen.file) }));
       continue;
     }
-    findings.push(...lintMockupHtml(html, path8.join(dir, screen.file)));
+    findings.push(...lintMockupHtml(html, path9.join(dir, screen.file)));
   }
   const inputsHash = await computeInputsHash(root, change);
   const stale = manifest.inputsHash !== void 0 && manifest.inputsHash !== inputsHash;
@@ -2686,7 +2796,7 @@ async function checkMockups(root, slug, change) {
   return { findings, stale, manifest, manifestPath };
 }
 async function writeMockupPlan(root, slug, plan, now = /* @__PURE__ */ new Date()) {
-  const file = path8.join(mockupsDir(root, slug), "plan.yaml");
+  const file = path9.join(mockupsDir(root, slug), "plan.yaml");
   if (await exists(file)) return file;
   const doc = {
     schema_version: 1,
@@ -2694,11 +2804,11 @@ async function writeMockupPlan(root, slug, plan, now = /* @__PURE__ */ new Date(
     platform: plan.platform,
     screens: plan.screens.map((s) => ({ id: s.id, title: s.title, file: s.file, illustrates: s.illustrates, states: s.states, breakpoints: s.breakpoints }))
   };
-  await writeText(file, stringifyYaml4(doc, { lineWidth: 120 }));
+  await writeText(file, stringifyYaml5(doc, { lineWidth: 120 }));
   return file;
 }
 async function writeMockupManifest(root, slug, plan, inputsHash, now = /* @__PURE__ */ new Date()) {
-  const file = path8.join(mockupsDir(root, slug), "manifest.yaml");
+  const file = path9.join(mockupsDir(root, slug), "manifest.yaml");
   if (await exists(file)) return file;
   const doc = {
     schema_version: 1,
@@ -2710,16 +2820,16 @@ async function writeMockupManifest(root, slug, plan, inputsHash, now = /* @__PUR
     screens: plan.screens.map((s) => ({ id: s.id, title: s.title, file: s.file, illustrates: s.illustrates, states: s.states, breakpoints: s.breakpoints })),
     screenshots: []
   };
-  await writeText(file, stringifyYaml4(doc, { lineWidth: 120 }));
+  await writeText(file, stringifyYaml5(doc, { lineWidth: 120 }));
   return file;
 }
 async function updateMockupScreenshots(root, slug, screenshots) {
-  const file = path8.join(mockupsDir(root, slug), "manifest.yaml");
+  const file = path9.join(mockupsDir(root, slug), "manifest.yaml");
   const raw = await readTextIfExists(file);
   if (raw === void 0) return void 0;
   const data = parseYaml6(raw) ?? {};
   data["screenshots"] = screenshots;
-  await writeText(file, stringifyYaml4(data, { lineWidth: 120 }));
+  await writeText(file, stringifyYaml5(data, { lineWidth: 120 }));
   return file;
 }
 async function captureMockups(root, slug, manifest, now = /* @__PURE__ */ new Date()) {
@@ -2744,9 +2854,9 @@ async function captureMockups(root, slug, manifest, now = /* @__PURE__ */ new Da
       const page2 = await browser.newPage();
       for (const bp of screen.breakpoints && screen.breakpoints.length > 0 ? screen.breakpoints : [1440]) {
         await page2.setViewportSize({ width: bp, height: 900 });
-        await page2.goto(`file://${path8.join(dir, screen.file).split(path8.sep).join("/")}`);
-        const rel = path8.posix.join("screens", `${screen.id}-${bp}.png`);
-        await page2.screenshot({ path: path8.join(dir, rel) });
+        await page2.goto(`file://${path9.join(dir, screen.file).split(path9.sep).join("/")}`);
+        const rel = path9.posix.join("screens", `${screen.id}-${bp}.png`);
+        await page2.screenshot({ path: path9.join(dir, rel) });
         screenshots.push(rel);
       }
       await page2.close();
@@ -2762,7 +2872,7 @@ async function mockupsReady(root, slug, change) {
   return Boolean(check.manifest && check.manifest.screens.length > 0 && !check.stale);
 }
 async function setMockupRequirement(root, slug, value) {
-  const file = path8.join(root, ".sdd", "changes", slug, "meta.yaml");
+  const file = path9.join(root, ".sdd", "changes", slug, "meta.yaml");
   const raw = await readTextIfExists(file) ?? `schema_version: 1
 slug: ${slug}
 lane: standard
@@ -2781,7 +2891,7 @@ lane: standard
 }
 
 // src/packs.ts
-import path9 from "path";
+import path10 from "path";
 import { parse as parseYaml7 } from "yaml";
 import { z as z5 } from "zod";
 var checkSchema = z5.object({
@@ -2997,12 +3107,12 @@ ${texts.scenarios}`);
   }
 }
 async function loadProjectPacks(sddDir) {
-  const dir = path9.join(sddDir, "packs");
+  const dir = path10.join(sddDir, "packs");
   const diagnostics = [];
   const packs = [];
   for (const entry of await listDir(dir)) {
     if (!/\.ya?ml$/i.test(entry)) continue;
-    const file = path9.join(dir, entry);
+    const file = path10.join(dir, entry);
     const raw = await readTextIfExists(file);
     if (raw === void 0) continue;
     let data;
@@ -3091,7 +3201,7 @@ function packFindings(evaluations, change) {
 // src/analyze.ts
 var UI_DOMAINS = /* @__PURE__ */ new Set(["frontend", "mobile", "fullstack"]);
 async function runAnalyze(opts) {
-  const root = path10.resolve(opts.root);
+  const root = path11.resolve(opts.root);
   const { workspace, config } = await loadWorkspace(root);
   const change = workspace.changes.find((c) => c.slug === opts.slug);
   if (!change) {
@@ -3109,7 +3219,7 @@ async function runAnalyze(opts) {
     for (const req of spec.spec.requirements) living.set(req.id, req);
   }
   if (change.delta) {
-    findings.push(...lintDelta(change.delta, living, path10.join(change.dir, "spec.md"), { language: config.spec.language }));
+    findings.push(...lintDelta(change.delta, living, path11.join(change.dir, "spec.md"), { language: config.spec.language }));
   }
   const trace = checkTrace({ specs: workspace.specs, change, requireEvidence: false });
   findings.push(...trace.findings);
@@ -3158,7 +3268,7 @@ async function runAnalyze(opts) {
   if (mockups) result.mockups = mockups;
   if (packs) result.packs = packs;
   if (opts.write !== false) {
-    const file = path10.join(change.dir, "analyze.md");
+    const file = path11.join(change.dir, "analyze.md");
     await writeText(file, renderAnalyze(change, result, localStamp(opts.now)));
     result.path = file;
   }
@@ -3201,9 +3311,9 @@ function renderAnalyze(change, result, generatedAt) {
 }
 
 // src/metrics.ts
-import path11 from "path";
+import path12 from "path";
 async function collectMetrics(root, now = /* @__PURE__ */ new Date()) {
-  const resolved = path11.resolve(root);
+  const resolved = path12.resolve(root);
   const { workspace, config } = await loadWorkspace(resolved);
   const approvals = await loadApprovals(workspace.sddDir);
   const living = /* @__PURE__ */ new Map();
@@ -3218,7 +3328,7 @@ async function collectMetrics(root, now = /* @__PURE__ */ new Date()) {
     const deltaContent = await readDelta(change);
     const approval = verifyApproval(change, approvals.byArtifact, config, deltaContent);
     const findings = [];
-    if (change.delta) findings.push(...lintDelta(change.delta, living, path11.join(change.dir, "spec.md"), { language: config.spec.language }));
+    if (change.delta) findings.push(...lintDelta(change.delta, living, path12.join(change.dir, "spec.md"), { language: config.spec.language }));
     const trace = checkTrace({
       specs: workspace.specs,
       change,
@@ -3283,7 +3393,7 @@ async function collectMetrics(root, now = /* @__PURE__ */ new Date()) {
       attention.push({ slug: change.slug, kind: "missing-evidence", detail: `evidencia ${change.scenariosPassed}/${change.scenariosTotal}` });
     }
   }
-  const archiveDir = path11.join(workspace.sddDir, "changes", "archive");
+  const archiveDir = path12.join(workspace.sddDir, "changes", "archive");
   const archivedEntries = await listDirs(archiveDir);
   const throughputByMonth = {};
   for (const entry of archivedEntries) {
@@ -3321,15 +3431,15 @@ async function collectMetrics(root, now = /* @__PURE__ */ new Date()) {
 }
 async function readDelta(change) {
   const { readTextIfExists: readTextIfExists2 } = await import("./fsx-VF2P7ALA.js");
-  return readTextIfExists2(path11.join(change.dir, "spec.md"));
+  return readTextIfExists2(path12.join(change.dir, "spec.md"));
 }
 
 // src/present.ts
-import path12 from "path";
+import path13 from "path";
 import { escapeHtml, inlineMarkdown, renderMarkdown as renderRich } from "@specatlas/render";
 import { defaultTokens, renderDocument, renderStyles } from "@specatlas/render";
 async function generatePresentation(opts) {
-  const root = path12.resolve(opts.root);
+  const root = path13.resolve(opts.root);
   const { workspace, config } = await loadWorkspace(root);
   const language = config.project.language;
   const change = workspace.changes.find((c) => c.slug === opts.slug);
@@ -3339,17 +3449,17 @@ async function generatePresentation(opts) {
   if (!change.delta) {
     return { slug: opts.slug, diagnostics: [diag("ATLAS-PRESENT-001", "error", `El cambio "${opts.slug}" no tiene spec.md (delta)`)] };
   }
-  const deltaPath = path12.join(change.dir, "spec.md");
+  const deltaPath = path13.join(change.dir, "spec.md");
   const deltaContent = await readTextIfExists(deltaPath) ?? "";
   const hash = artifactHash(deltaContent);
   const now = opts.now ?? /* @__PURE__ */ new Date();
-  const presentationDir = path12.join(change.dir, "presentation");
-  const mockupsCopyDir = path12.join(presentationDir, "mockups");
+  const presentationDir = path13.join(change.dir, "presentation");
+  const mockupsCopyDir = path13.join(presentationDir, "mockups");
   await ensureDir(presentationDir);
   const mockupInfo = await copyMockups(root, change, mockupsCopyDir);
-  const proposalRaw = await readTextIfExists(path12.join(change.dir, "proposal.md"));
+  const proposalRaw = await readTextIfExists(path13.join(change.dir, "proposal.md"));
   const proposalBody = proposalRaw ? parseFrontmatter(proposalRaw).body : "";
-  const approvals = await loadApprovals(path12.join(root, ".sdd"));
+  const approvals = await loadApprovals(path13.join(root, ".sdd"));
   const approval = verifyApproval(change, approvals.byArtifact, config, deltaContent);
   const labels = labelsFor(language);
   const html = page({
@@ -3370,7 +3480,7 @@ async function generatePresentation(opts) {
     approveHint: `satlas approve ${change.slug} --by "<nombre>" --channel presentation`,
     ...approval.status === "valid" && approval.approvedBy ? { approval: { by: approval.approvedBy, at: approval.approvedAt ?? "" } } : {}
   });
-  const outFile = path12.join(presentationDir, "index.html");
+  const outFile = path13.join(presentationDir, "index.html");
   await writeText(outFile, html);
   return { slug: change.slug, path: outFile, hash, diagnostics: mockupInfo.diagnostics };
 }
@@ -3382,12 +3492,12 @@ async function copyMockups(root, change, destDir) {
   await ensureDir(destDir);
   const screens = [];
   for (const screen of manifest.screens) {
-    const src = path12.join(dir, screen.file);
+    const src = path13.join(dir, screen.file);
     if (!await exists(src)) {
       diagnostics.push(diag("ATLAS-PRESENT-002", "warning", `El mockup ${screen.file} no existe y no se incluir\xE1`, { path: src }));
       continue;
     }
-    await copyFile(src, path12.join(destDir, screen.file));
+    await copyFile(src, path13.join(destDir, screen.file));
     screens.push({
       id: screen.id,
       title: screen.title ?? screen.id,
@@ -3397,13 +3507,13 @@ async function copyMockups(root, change, destDir) {
     });
   }
   const screenshots = [];
-  const shotsDir = path12.join(dir, "screens");
+  const shotsDir = path13.join(dir, "screens");
   if (await exists(shotsDir)) {
-    await ensureDir(path12.join(destDir, "screens"));
+    await ensureDir(path13.join(destDir, "screens"));
     const { listDir: listDir4 } = await import("./fsx-VF2P7ALA.js");
     for (const file of await listDir4(shotsDir)) {
       if (!/\.(png|jpe?g|webp)$/i.test(file)) continue;
-      await copyFile(path12.join(shotsDir, file), path12.join(destDir, "screens", file));
+      await copyFile(path13.join(shotsDir, file), path13.join(destDir, "screens", file));
       screenshots.push(`mockups/screens/${file}`);
     }
   }
@@ -3578,7 +3688,7 @@ function renderMarkdown(markdown) {
 }
 
 // src/adopt.ts
-import path13 from "path";
+import path14 from "path";
 var COMMON_ROOTS = ["src", "app", "lib", "modules", "services", "packages", "api", "features", "domain", "internal", "components"];
 var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "dist", "build", "out", "coverage", ".git", ".sdd", ".opencode", ".claude", "test", "tests", "__tests__", "e2e", "docs", "scripts", "assets", "public", "migrations", "vendor", "bin", "obj"]);
 var SOURCE_EXT = /* @__PURE__ */ new Set([
@@ -3622,11 +3732,11 @@ var SOURCE_EXT = /* @__PURE__ */ new Set([
   ".groovy"
 ]);
 async function adoptWorkspace(opts) {
-  const root = path13.resolve(opts.root);
+  const root = path14.resolve(opts.root);
   const dryRun = opts.dryRun ?? false;
   const diagnostics = [];
-  const sddDir = path13.join(root, ".sdd");
-  if (!await exists(path13.join(sddDir, "config.yaml"))) {
+  const sddDir = path14.join(root, ".sdd");
+  if (!await exists(path14.join(sddDir, "config.yaml"))) {
     return {
       root,
       domains: [],
@@ -3637,8 +3747,8 @@ async function adoptWorkspace(opts) {
   }
   const { config } = await loadConfig(sddDir);
   const files = await walkFiles(root, { skipDirs: [...SKIP_DIRS] });
-  const inventoried = files.map((f) => toPosix(path13.relative(root, f.path)));
-  const relative = inventoried.filter((f) => SOURCE_EXT.has(path13.extname(f).toLowerCase()));
+  const inventoried = files.map((f) => toPosix(path14.relative(root, f.path)));
+  const relative = inventoried.filter((f) => SOURCE_EXT.has(path14.extname(f).toLowerCase()));
   if (relative.length === 0) {
     diagnostics.push(diag("ATLAS-ADOPT-002", "warning", "No se encontraron archivos de c\xF3digo para inventariar", { path: root, suggestion: "A\xF1ade el dominio a mano con --domains <nombre>" }));
   }
@@ -3666,13 +3776,13 @@ async function adoptWorkspace(opts) {
   const createdSpecs = [];
   for (const name of domainNames.sort()) {
     const domainFiles = (counts.get(name) ?? []).sort();
-    const existingSpec = await exists(path13.join(sddDir, "specs", name, "spec.md"));
+    const existingSpec = await exists(path14.join(sddDir, "specs", name, "spec.md"));
     domains.push({ name, files: domainFiles.length, samples: domainFiles.slice(0, 8), existingSpec });
     if (existingSpec) {
-      diagnostics.push(diag("ATLAS-ADOPT-003", "info", `La spec de "${name}" ya existe; se conserva`, { path: path13.join(sddDir, "specs", name, "spec.md") }));
+      diagnostics.push(diag("ATLAS-ADOPT-003", "info", `La spec de "${name}" ya existe; se conserva`, { path: path14.join(sddDir, "specs", name, "spec.md") }));
       continue;
     }
-    const specPath = path13.join(sddDir, "specs", name, "spec.md");
+    const specPath = path14.join(sddDir, "specs", name, "spec.md");
     if (!dryRun) {
       await writeText(specPath, baselineSpec(name, domainFiles));
       createdSpecs.push(specPath);
@@ -3680,7 +3790,7 @@ async function adoptWorkspace(opts) {
       createdSpecs.push(specPath);
     }
   }
-  const reportPath = path13.join(sddDir, "adopt-report.md");
+  const reportPath = path14.join(sddDir, "adopt-report.md");
   if (!dryRun) {
     await writeText(reportPath, adoptReport({ root, config, domains, detection: detection?.best, language: config.project.language, files: relative.length, inventoried: inventoried.length, now: opts.now ?? /* @__PURE__ */ new Date() }));
   }
@@ -3700,12 +3810,12 @@ async function loadProjectProfiles(root, dirs) {
     if (!await exists(dir)) continue;
     out.push(...await loadProfilesFromDir(dir));
   }
-  const custom = path13.join(root, ".sdd", "profiles", "custom");
+  const custom = path14.join(root, ".sdd", "profiles", "custom");
   if (await exists(custom)) out.push(...await loadProfilesFromDir(custom));
   return out;
 }
 async function fallbackDomainName(root, projectName) {
-  const pkg = await readTextIfExists(path13.join(root, "package.json"));
+  const pkg = await readTextIfExists(path14.join(root, "package.json"));
   if (pkg) {
     try {
       const data = JSON.parse(pkg);
@@ -3793,13 +3903,13 @@ function adoptReport(input) {
 }
 
 // src/init.ts
-import path14 from "path";
+import path15 from "path";
 async function initWorkspace(opts) {
-  const root = path14.resolve(opts.root);
-  const sddDir = path14.join(root, ".sdd");
+  const root = path15.resolve(opts.root);
+  const sddDir = path15.join(root, ".sdd");
   const diagnostics = [];
   const created = [];
-  if (await exists(path14.join(sddDir, "config.yaml"))) {
+  if (await exists(path15.join(sddDir, "config.yaml"))) {
     return {
       sddDir,
       created,
@@ -3809,29 +3919,29 @@ async function initWorkspace(opts) {
   created.push(...await ensureSddDirs(sddDir));
   const language = opts.language ?? "es";
   const cfg = defaultConfig({ name: opts.name, language });
-  cfg.project.name = opts.name ?? path14.basename(root);
+  cfg.project.name = opts.name ?? path15.basename(root);
   await writeConfig(sddDir, cfg);
-  created.push(path14.join(sddDir, "config.yaml"));
+  created.push(path15.join(sddDir, "config.yaml"));
   const templates = templatesFor(language);
-  await writeText(path14.join(sddDir, "constitution.md"), templates.constitution);
-  created.push(path14.join(sddDir, "constitution.md"));
-  await writeText(path14.join(sddDir, "glossary.md"), templates.glossary);
-  created.push(path14.join(sddDir, "glossary.md"));
+  await writeText(path15.join(sddDir, "constitution.md"), templates.constitution);
+  created.push(path15.join(sddDir, "constitution.md"));
+  await writeText(path15.join(sddDir, "glossary.md"), templates.glossary);
+  created.push(path15.join(sddDir, "glossary.md"));
   const detected = await detectIfPossible(root, opts.profilesDir);
   if (detected) {
     const yaml = detectionToYaml(detected, localStamp(opts.now));
-    await writeText(path14.join(sddDir, "profiles", "detected.yaml"), yaml);
-    created.push(path14.join(sddDir, "profiles", "detected.yaml"));
+    await writeText(path15.join(sddDir, "profiles", "detected.yaml"), yaml);
+    created.push(path15.join(sddDir, "profiles", "detected.yaml"));
     if (detected.best) {
       diagnostics.push(diag("ATLAS-INIT-002", "info", `Stack detectado: ${detected.best.displayName} (${detected.best.score} puntos)`, { suggestion: "Revisa .sdd/profiles/detected.yaml" }));
     } else {
       diagnostics.push(diag("ATLAS-INIT-003", "info", "No se detect\xF3 un stack conocido: se usar\xE1 el perfil gen\xE9rico", { suggestion: "Crea un perfil propio con `satlas profile` (F2) o edita .sdd/profiles/custom/" }));
     }
   }
-  await writeText(path14.join(sddDir, "INDEX.md"), initialIndex(language, cfg.project.name));
-  created.push(path14.join(sddDir, "INDEX.md"));
+  await writeText(path15.join(sddDir, "INDEX.md"), initialIndex(language, cfg.project.name));
+  created.push(path15.join(sddDir, "INDEX.md"));
   if (opts.local) {
-    const gitignore = path14.join(root, ".gitignore");
+    const gitignore = path15.join(root, ".gitignore");
     const current = await readTextIfExists(gitignore) ?? "";
     if (!/(^|\n)\.sdd\/?(\n|$)/.test(current)) {
       const next = current.endsWith("\n") || current === "" ? `${current}.sdd/
@@ -3866,13 +3976,13 @@ ${es ? "## Archivados\n\n0 cambio(s) en `changes/archive/`." : "## Archived\n\n0
 }
 
 // src/new.ts
-import path15 from "path";
+import path16 from "path";
 var SLUG_RE = /^[a-z0-9][a-z0-9-]{1,49}$/;
 async function createChange(opts) {
   const diagnostics = [];
   const slug = opts.slug.trim().toLowerCase();
   const language = opts.language ?? opts.cfg?.project.language ?? "es";
-  const dir = path15.join(path15.resolve(opts.root), ".sdd", "changes", slug);
+  const dir = path16.join(path16.resolve(opts.root), ".sdd", "changes", slug);
   if (!SLUG_RE.test(slug)) {
     return {
       slug,
@@ -3903,20 +4013,20 @@ async function createChange(opts) {
   await ensureDir(dir);
   const templates = templatesFor(language);
   const files = [];
-  const metaFile = path15.join(dir, "meta.yaml");
+  const metaFile = path16.join(dir, "meta.yaml");
   await writeText(metaFile, changeMetaYaml(meta));
   files.push(metaFile);
   if (lane === "fix") {
-    const fixFile = path15.join(dir, "fix.md");
+    const fixFile = path16.join(dir, "fix.md");
     await writeText(fixFile, renderTemplate(templates.fix, { TITLE: title }));
     files.push(fixFile);
     return { slug, dir, files, diagnostics };
   }
-  const proposalFile = path15.join(dir, "proposal.md");
+  const proposalFile = path16.join(dir, "proposal.md");
   await writeText(proposalFile, renderTemplate(templates.proposal, { TITLE: title }));
   files.push(proposalFile);
   const domainUpper = domain.replace(/[^a-z0-9]/gi, "").toUpperCase() || "GEN";
-  const deltaFile = path15.join(dir, "spec.md");
+  const deltaFile = path16.join(dir, "spec.md");
   await writeText(deltaFile, templates.specDelta({ title, domainUpper, domain }));
   files.push(deltaFile);
   return { slug, dir, files, diagnostics };
@@ -3925,7 +4035,7 @@ async function createChange(opts) {
 // src/archive.ts
 import { promises as fs } from "fs";
 import { cp, rename, rm } from "fs/promises";
-import path16 from "path";
+import path17 from "path";
 var REQ_HEADER_RE = /^###\s+(?:Requisito|Requirement):\s+(REQ-[A-Z0-9-]+)\s*(?:—|-|–)\s*(.*)$/;
 function foldDelta(livingBody, delta, language = "es") {
   const diagnostics = [];
@@ -4034,7 +4144,7 @@ async function restoreFile(file, previous) {
   }
 }
 async function archiveChange(opts) {
-  const root = path16.resolve(opts.root);
+  const root = path17.resolve(opts.root);
   const diagnostics = [];
   const { config } = await loadWorkspace(root);
   const language = opts.language ?? config.project.language;
@@ -4050,16 +4160,43 @@ async function archiveChange(opts) {
       return { slug: opts.slug, fold: emptyFold, diagnostics, dryRun: opts.dryRun ?? false };
     }
     const nowFix = opts.now ?? /* @__PURE__ */ new Date();
-    const targetFix = path16.join(root, ".sdd", "changes", "archive", `${localMonth(nowFix)}-${opts.slug}`);
+    const targetFix = path17.join(root, ".sdd", "changes", "archive", `${localMonth(nowFix)}-${opts.slug}`);
     if (await exists(targetFix)) {
       diagnostics.push(diag("ATLAS-ARCH-002", "error", `Ya existe un cambio archivado en ${targetFix}`, { path: targetFix }));
       return { slug: opts.slug, fold: emptyFold, diagnostics, dryRun: opts.dryRun ?? false };
     }
+    let livingFix;
+    let livingCreated = false;
+    if (!opts.dryRun) {
+      const fixRaw = await readTextIfExists(path17.join(change.dir, "fix.md")) ?? "";
+      try {
+        const written = await writeLivingFix(root, {
+          slug: opts.slug,
+          date: localDate(nowFix),
+          result: "pass",
+          ...change.meta.domain !== void 0 ? { domain: change.meta.domain } : {},
+          ...change.meta.title !== void 0 ? { title: change.meta.title } : {},
+          covers: change.fixCovers ?? [],
+          content: fixRaw
+        });
+        livingFix = written.relativePath;
+        livingCreated = written.created;
+      } catch (error) {
+        diagnostics.push(
+          diag("ATLAS-ARCH-006", "error", `No se pudo conservar el fix vivo: ${error.message}`, {
+            path: path17.join(root, ".sdd", "fixes"),
+            suggestion: "Revisa los permisos de .sdd/fixes y vuelve a intentar; el fix sigue sin archivar"
+          })
+        );
+        return { slug: opts.slug, fold: emptyFold, diagnostics, dryRun: false };
+      }
+    }
     if (!opts.dryRun) {
-      await ensureDir(path16.dirname(targetFix));
+      await ensureDir(path17.dirname(targetFix));
       try {
         await moveDirectory(change.dir, targetFix);
       } catch (error) {
+        if (livingCreated && livingFix) await removeFile(path17.join(root, livingFix));
         diagnostics.push(
           diag("ATLAS-ARCH-004", "error", `No se pudo mover el cambio al hist\xF3rico: ${error.message}`, {
             path: change.dir,
@@ -4068,9 +4205,16 @@ async function archiveChange(opts) {
         );
         return { slug: opts.slug, fold: emptyFold, diagnostics, dryRun: false };
       }
-      await regenerateIndex(root, config);
+      await regenerateIndex(root, config, nowFix);
     }
-    return { slug: opts.slug, archivedTo: targetFix, fold: emptyFold, diagnostics, dryRun: opts.dryRun ?? false };
+    return {
+      slug: opts.slug,
+      archivedTo: targetFix,
+      ...livingFix !== void 0 ? { livingFix } : {},
+      fold: emptyFold,
+      diagnostics,
+      dryRun: opts.dryRun ?? false
+    };
   }
   if (!change.delta) {
     diagnostics.push(diag("ATLAS-ARCH-003", "error", `El cambio "${opts.slug}" no tiene spec.md (delta): no hay nada que plegar`, { path: change.dir }));
@@ -4078,10 +4222,10 @@ async function archiveChange(opts) {
   }
   const domain = change.meta.domain;
   if (!domain) {
-    diagnostics.push(diag("ATLAS-ARCH-001", "error", `El cambio "${opts.slug}" no declara domain en meta.yaml`, { path: path16.join(change.dir, "meta.yaml") }));
+    diagnostics.push(diag("ATLAS-ARCH-001", "error", `El cambio "${opts.slug}" no declara domain en meta.yaml`, { path: path17.join(change.dir, "meta.yaml") }));
     return { slug: opts.slug, fold: { content: "", applied: { added: [], modified: [], removed: [], renamed: [] }, diagnostics }, diagnostics, dryRun: opts.dryRun ?? false };
   }
-  const specFile = path16.join(root, ".sdd", "specs", domain, "spec.md");
+  const specFile = path17.join(root, ".sdd", "specs", domain, "spec.md");
   const existing = await readTextIfExists(specFile);
   const base = existing ?? `---
 domain: ${domain}
@@ -4111,8 +4255,8 @@ ${Object.entries(nextFm).map(([k, v]) => `${k}: ${String(v)}`).join("\n")}
 
 ${body}`;
   const month = localMonth(now);
-  const archiveDir = path16.join(root, ".sdd", "changes", "archive");
-  const target = path16.join(archiveDir, `${month}-${opts.slug}`);
+  const archiveDir = path17.join(root, ".sdd", "changes", "archive");
+  const target = path17.join(archiveDir, `${month}-${opts.slug}`);
   if (await exists(target)) {
     diagnostics.push(diag("ATLAS-ARCH-002", "error", `Ya existe un cambio archivado en ${target}`, { path: target }));
     return { slug: opts.slug, domain, fold, diagnostics, dryRun: opts.dryRun ?? false };
@@ -4138,21 +4282,382 @@ ${body}`;
 }
 async function regenerateIndex(root, cfg, now = /* @__PURE__ */ new Date()) {
   const { workspace, config } = cfg ? { workspace: (await loadWorkspace(root)).workspace, config: cfg } : await loadWorkspace(root);
-  const archiveDir = path16.join(root, ".sdd", "changes", "archive");
+  const archiveDir = path17.join(root, ".sdd", "changes", "archive");
   const archived = await exists(archiveDir) ? (await fs.readdir(archiveDir)).filter((e) => !e.startsWith(".")).length : 0;
+  const fixes = await loadLivingFixes(root);
   const markdown = indexMarkdown({
     projectName: config.project.name,
     language: config.project.language,
     specs: workspace.specs.map((s) => ({ domain: s.domain, requirements: s.spec.requirements.length })),
     changes: workspace.changes.map((c) => ({ slug: c.slug, lane: c.meta?.lane ?? config.lanes.default })),
+    fixes: fixes.map((fix) => ({ slug: fix.slug, date: fix.date, result: fix.result, ...fix.domain !== void 0 ? { domain: fix.domain } : {} })),
     archived
   });
   void now;
-  await writeText(path16.join(root, ".sdd", "INDEX.md"), markdown);
+  await writeText(path17.join(root, ".sdd", "INDEX.md"), markdown);
+}
+async function removeFile(file) {
+  try {
+    await rm(file, { force: true });
+  } catch {
+  }
+}
+
+// src/migrations.ts
+import { promises as fs2 } from "fs";
+import path18 from "path";
+import { parse as parseYaml8, stringify as stringifyYaml6 } from "yaml";
+var SCHEMA_VERSION = 1;
+var BACKUP_DIRNAME = ".backup";
+var BACKUP_POINTER = ".latest";
+var SCHEMA_MIGRATIONS = [
+  {
+    id: "0001-sellar-version-de-esquema",
+    description: "Sella la versi\xF3n de esquema vigente en los elementos que no la declaran",
+    from: 0,
+    to: SCHEMA_VERSION
+  }
+];
+var FIXED_ARTIFACTS = ["config.yaml", "approvals.yaml", path18.join("profiles", "detected.yaml")];
+var CHANGE_ARTIFACTS = ["meta.yaml", path18.join("mockups", "manifest.yaml")];
+async function pushChangeArtifacts(out, sddDir, relDir) {
+  for (const rel of CHANGE_ARTIFACTS) {
+    const abs = path18.join(sddDir, relDir, rel);
+    if (await exists(abs)) out.push({ artifact: toPosix(path18.join(relDir, rel)), path: abs });
+  }
+}
+async function collectVersionedArtifacts(root) {
+  const sddDir = path18.join(root, ".sdd");
+  const out = [];
+  for (const rel of FIXED_ARTIFACTS) {
+    const abs = path18.join(sddDir, rel);
+    if (await exists(abs)) out.push({ artifact: toPosix(rel), path: abs });
+  }
+  const changesDir = path18.join(sddDir, "changes");
+  for (const slug of await listDirs(changesDir)) {
+    if (slug === "archive") continue;
+    await pushChangeArtifacts(out, sddDir, path18.join("changes", slug));
+  }
+  for (const entry of await listDirs(path18.join(changesDir, "archive"))) {
+    await pushChangeArtifacts(out, sddDir, path18.join("changes", "archive", entry));
+  }
+  return out;
+}
+function readArtifactVersion(content) {
+  let data;
+  try {
+    data = parseYaml8(content);
+  } catch (err) {
+    return { state: "unreadable", reason: `YAML inv\xE1lido (${err.message})` };
+  }
+  if (data === null || data === void 0) return { state: "absent" };
+  if (typeof data !== "object" || Array.isArray(data)) return { state: "unreadable", reason: "la ra\xEDz no es un mapa de claves y valores" };
+  const raw = data["schema_version"];
+  if (raw === void 0) return { state: "absent" };
+  if (typeof raw !== "number" || !Number.isInteger(raw) || raw < 1) return { state: "unreadable", reason: `schema_version con valor no v\xE1lido: ${String(raw)}` };
+  return { state: "ok", version: raw };
+}
+function stampSchemaVersion(content, version) {
+  const line = `schema_version: ${version}`;
+  const bom = content.startsWith("\uFEFF") ? "\uFEFF" : "";
+  const body = bom ? content.slice(1) : content;
+  if (body.trim() === "") return `${bom}${line}
+`;
+  const eol = body.includes("\r\n") ? "\r\n" : "\n";
+  const lines = body.split(/\r?\n/);
+  const trailing = lines.length > 1 && lines[lines.length - 1] === "";
+  let index = 0;
+  while (index < lines.length) {
+    const trimmed = (lines[index] ?? "").trim();
+    if (trimmed === "" || trimmed.startsWith("#")) {
+      index += 1;
+      continue;
+    }
+    break;
+  }
+  if ((lines[index] ?? "").trim() === "---") index += 1;
+  const insertAt = trailing ? Math.min(index, lines.length - 1) : index;
+  lines.splice(insertAt, 0, line);
+  const next = bom + lines.join(eol);
+  const check = readArtifactVersion(next);
+  if (check.state !== "ok" || check.version !== version) return void 0;
+  return next;
+}
+async function planUpgrade(root) {
+  const artifacts = await collectVersionedArtifacts(root);
+  const pending = [];
+  const newer = [];
+  const unreadable = [];
+  for (const found of artifacts) {
+    const content = await readTextIfExists(found.path);
+    if (content === void 0) continue;
+    const state = readArtifactVersion(content);
+    if (state.state === "unreadable") {
+      unreadable.push({ ...found, reason: state.reason });
+      continue;
+    }
+    if (state.state === "ok") {
+      if (state.version > SCHEMA_VERSION) {
+        newer.push({ ...found, reason: `produce la versi\xF3n ${state.version}, m\xE1s nueva que la vigente (${SCHEMA_VERSION})` });
+        continue;
+      }
+      if (state.version === SCHEMA_VERSION) continue;
+    }
+    const from = state.state === "ok" ? state.version : 0;
+    const migration = SCHEMA_MIGRATIONS.find((m) => m.from === from);
+    if (!migration) {
+      unreadable.push({ ...found, reason: `no hay migraci\xF3n registrada desde la versi\xF3n ${from}` });
+      continue;
+    }
+    const stamped = stampSchemaVersion(content, migration.to);
+    if (stamped === void 0) {
+      unreadable.push({ ...found, reason: "no se pudo sellar con seguridad sin alterar el resto del contenido" });
+      continue;
+    }
+    pending.push({ ...found, from, to: migration.to, migration: migration.id, summary: migration.description });
+  }
+  return { root, currentVersion: SCHEMA_VERSION, pending, newer, unreadable, upToDate: pending.length === 0 };
+}
+async function removeDir(dir) {
+  try {
+    await fs2.rm(dir, { recursive: true, force: true });
+  } catch {
+  }
+}
+async function removeFile2(file) {
+  try {
+    await fs2.rm(file, { force: true });
+  } catch {
+  }
+}
+function backupName(now) {
+  return `${localCompact(now)}${localOffset(now).replace(":", "")}`;
+}
+async function applyUpgrade(root, now = /* @__PURE__ */ new Date()) {
+  const plan = await planUpgrade(root);
+  if (plan.pending.length === 0) return { status: "up-to-date", plan, applied: [] };
+  const sddDir = path18.join(root, ".sdd");
+  const backupRoot = path18.join(sddDir, BACKUP_DIRNAME);
+  const name = backupName(now);
+  const backupDir = path18.join(backupRoot, name);
+  const pointerFile = path18.join(backupRoot, BACKUP_POINTER);
+  const previous = [];
+  try {
+    for (const item of plan.pending) {
+      const content = await readTextIfExists(item.path);
+      if (content === void 0) throw new Error("el elemento desapareci\xF3 mientras se respaldaba");
+      previous.push({ item, contents: content });
+      await writeText(path18.join(backupDir, "files", ...item.artifact.split("/")), content);
+    }
+    await writeText(
+      path18.join(backupDir, "backup.yaml"),
+      stringifyYaml6(
+        {
+          schema_version: SCHEMA_VERSION,
+          created_at: localStamp(now),
+          to_version: SCHEMA_VERSION,
+          files: plan.pending.map((i) => ({ artifact: i.artifact, from: i.from, to: i.to, migration: i.migration }))
+        },
+        { lineWidth: 120 }
+      )
+    );
+    await writeText(pointerFile, `${name}
+`);
+  } catch (err) {
+    await removeDir(backupDir);
+    await removeFile2(pointerFile);
+    return { status: "failed", plan, applied: [], failure: { artifact: "(respaldo)", message: err.message } };
+  }
+  const written = [];
+  for (const { item, contents } of previous) {
+    try {
+      const next = stampSchemaVersion(contents, item.to);
+      if (next === void 0) throw new Error("no se pudo sellar con seguridad");
+      await writeText(item.path, next);
+      written.push(item);
+    } catch (err) {
+      for (const w of written) {
+        const prev = previous.find((p) => p.item.artifact === w.artifact);
+        if (prev) {
+          try {
+            await writeText(prev.item.path, prev.contents);
+          } catch {
+          }
+        }
+      }
+      await removeFile2(pointerFile);
+      await removeDir(backupDir);
+      return { status: "failed", plan, applied: [], failure: { artifact: item.artifact, message: err.message } };
+    }
+  }
+  for (const dir of await listDirs(backupRoot)) {
+    if (dir !== name) await removeDir(path18.join(backupRoot, dir));
+  }
+  return {
+    status: "applied",
+    plan,
+    applied: written,
+    backup: {
+      name,
+      dir: backupDir,
+      relativeDir: toPosix(path18.relative(root, backupDir)),
+      createdAt: localStamp(now),
+      files: plan.pending.map((i) => i.artifact)
+    }
+  };
+}
+async function rollbackUpgrade(root) {
+  const sddDir = path18.join(root, ".sdd");
+  const backupRoot = path18.join(sddDir, BACKUP_DIRNAME);
+  const pointerFile = path18.join(backupRoot, BACKUP_POINTER);
+  const name = (await readTextIfExists(pointerFile))?.trim();
+  if (!name) return { status: "no-backup", restored: [] };
+  const backupDir = path18.join(backupRoot, name);
+  const manifestRaw = await readTextIfExists(path18.join(backupDir, "backup.yaml"));
+  if (manifestRaw === void 0) return { status: "no-backup", restored: [] };
+  let files = [];
+  try {
+    const parsed = parseYaml8(manifestRaw);
+    files = (parsed?.files ?? []).filter((f) => typeof f?.artifact === "string");
+  } catch {
+    return { status: "no-backup", restored: [] };
+  }
+  const restored = [];
+  for (const file of files) {
+    const from = path18.join(backupDir, "files", ...file.artifact.split("/"));
+    const to = path18.join(sddDir, ...file.artifact.split("/"));
+    const content = await readTextIfExists(from);
+    if (content === void 0) continue;
+    try {
+      await writeText(to, content);
+      restored.push(file.artifact);
+    } catch (err) {
+      return { status: "failed", restored, backup: name, failure: { artifact: file.artifact, message: err.message } };
+    }
+  }
+  await removeDir(backupDir);
+  await removeFile2(pointerFile);
+  return { status: "restored", restored, backup: name };
+}
+async function upgradeAdvisory(root) {
+  const plan = await planUpgrade(root);
+  const diagnostics = [];
+  if (plan.pending.length > 0) {
+    diagnostics.push(
+      diag("ATLAS-UPGRADE-001", "warning", `El estado del proyecto no corresponde a la versi\xF3n vigente: ${plan.pending.length} elemento(s) por actualizar`, {
+        suggestion: "Vista previa: `satlas upgrade` \xB7 Aplicar: `satlas upgrade --apply`"
+      })
+    );
+  }
+  for (const item of plan.newer) {
+    diagnostics.push(
+      diag("ATLAS-UPGRADE-002", "warning", `El proyecto fue producido por una versi\xF3n m\xE1s nueva: "${item.artifact}" (${item.reason})`, {
+        path: item.path,
+        suggestion: "Actualiza la herramienta; no se actualiza hacia atr\xE1s"
+      })
+    );
+  }
+  for (const item of plan.unreadable) {
+    diagnostics.push(
+      diag("ATLAS-UPGRADE-003", "warning", `No se pudo interpretar "${item.artifact}": ${item.reason}`, {
+        path: item.path,
+        suggestion: "Revisa el elemento; no se modificar\xE1"
+      })
+    );
+  }
+  return { plan, diagnostics };
+}
+
+// src/sarif.ts
+import path19 from "path";
+var SARIF_SCHEMA = "https://json.schemastore.org/sarif-2.1.0.json";
+var SARIF_VERSION = "2.1.0";
+var TOOL_NAME = "SpecAtlas";
+var TOOL_URL = "https://github.com/AlonsoAM/specatlas";
+var RULE_FAMILIES = [
+  [/^LINT-STR-/, "Estructura de los artefactos"],
+  [/^LINT-BIZ-/, "Lenguaje de negocio de la especificaci\xF3n"],
+  [/^LINT-DLT-/, "Delta de especificaci\xF3n"],
+  [/^LINT-EVD-/, "Evidencia registrada"],
+  [/^LINT-TSK-/, "Tareas declaradas"],
+  [/^LINT-PLN-/, "Plan t\xE9cnico"],
+  [/^(LINT-MKP|MKP)-/, "Mockups"],
+  [/^TRACE-/, "Trazabilidad requisito, escenario, tarea y evidencia"],
+  [/^PACK-/, "Pack de cumplimiento"],
+  [/^ATLAS-UPGRADE-/, "Actualizaci\xF3n del estado del proyecto"],
+  [/^ATLAS-ADAPTERS-/, "Adaptadores de agente"],
+  [/^ATLAS-CI-/, "Comprobaci\xF3n continua"],
+  [/^ATLAS-/, "Estado del proyecto"]
+];
+function ruleDescription(code) {
+  for (const [pattern, description] of RULE_FAMILIES) {
+    if (pattern.test(code)) return description;
+  }
+  return code;
+}
+function sarifLevel(severity) {
+  if (severity === "error") return "error";
+  if (severity === "warning") return "warning";
+  return "note";
+}
+function resultOf(diagnostic, root) {
+  const result = {
+    ruleId: diagnostic.code,
+    level: sarifLevel(diagnostic.severity),
+    message: { text: diagnostic.message }
+  };
+  if (diagnostic.path) {
+    const rel = path19.relative(root, diagnostic.path);
+    if (rel !== "") {
+      const physicalLocation = {
+        artifactLocation: { uri: toPosix(rel) },
+        ...diagnostic.line ? { region: { startLine: diagnostic.line } } : {}
+      };
+      result.locations = [{ physicalLocation }];
+    }
+  }
+  return result;
+}
+function toSarifReport(opts) {
+  const rules = /* @__PURE__ */ new Map();
+  const results = [];
+  for (const diagnostic of opts.diagnostics) {
+    let rule = rules.get(diagnostic.code);
+    if (!rule) {
+      rule = { id: diagnostic.code, shortDescription: { text: ruleDescription(diagnostic.code) } };
+      if (diagnostic.suggestion) rule.help = { text: diagnostic.suggestion };
+      rules.set(diagnostic.code, rule);
+    } else if (!rule.help && diagnostic.suggestion) {
+      rule.help = { text: diagnostic.suggestion };
+    }
+    results.push(resultOf(diagnostic, opts.root));
+  }
+  return {
+    $schema: SARIF_SCHEMA,
+    version: SARIF_VERSION,
+    runs: [
+      {
+        tool: {
+          driver: {
+            name: TOOL_NAME,
+            informationUri: TOOL_URL,
+            version: opts.version,
+            rules: [...rules.values()]
+          }
+        },
+        results,
+        invocations: [{ executionSuccessful: !(opts.failed ?? false) }]
+      }
+    ]
+  };
+}
+function toSarifText(opts) {
+  return `${JSON.stringify(toSarifReport(opts), null, 2)}
+`;
 }
 
 // src/doctor.ts
-import path17 from "path";
+import path20 from "path";
 async function runDoctor(root) {
   const findings = [];
   const { workspace, config } = await loadWorkspace(root);
@@ -4160,7 +4665,7 @@ async function runDoctor(root) {
   const approvals = await loadApprovals(workspace.sddDir);
   findings.push(...approvals.diagnostics);
   for (const change of workspace.changes) {
-    const deltaPath = path17.join(change.dir, "spec.md");
+    const deltaPath = path20.join(change.dir, "spec.md");
     const deltaContent = await readTextIfExists(deltaPath);
     const approval = verifyApproval(change, approvals.byArtifact, config, deltaContent ?? void 0);
     if ((change.planPath || change.tasks) && (approval.status === "missing" || approval.status === "stale")) {
@@ -4182,7 +4687,7 @@ async function runDoctor(root) {
     }
     for (const override of change.meta?.overrides ?? []) {
       if (!override.reason.trim() || !override.by.trim()) {
-        findings.push(diag("ATLAS-LIFECYCLE-004", "error", `Override del gate "${override.gate}" sin motivo o autor`, { path: path17.join(change.dir, "meta.yaml") }));
+        findings.push(diag("ATLAS-LIFECYCLE-004", "error", `Override del gate "${override.gate}" sin motivo o autor`, { path: path20.join(change.dir, "meta.yaml") }));
       }
     }
   }
@@ -4205,7 +4710,7 @@ async function specHashOf(filePath) {
 }
 
 // src/gate.ts
-import path18 from "path";
+import path21 from "path";
 var UI_DOMAINS2 = /* @__PURE__ */ new Set(["frontend", "mobile", "fullstack"]);
 function count(name, diagnostics) {
   return {
@@ -4222,7 +4727,7 @@ function livingRequirementsMap(specs) {
   return map;
 }
 async function runCiGate(opts) {
-  const root = path18.resolve(opts.root);
+  const root = path21.resolve(opts.root);
   const { workspace, config } = await loadWorkspace(root);
   const diagnostics = [];
   const checks = [];
@@ -4233,7 +4738,7 @@ async function runCiGate(opts) {
   let changesErrors = 0;
   let changesWarnings = 0;
   for (const change of workspace.changes) {
-    const lintFindings = change.delta ? lintDelta(change.delta, living, path18.join(change.dir, "spec.md"), { language: config.spec.language }) : [];
+    const lintFindings = change.delta ? lintDelta(change.delta, living, path21.join(change.dir, "spec.md"), { language: config.spec.language }) : [];
     const trace = checkTrace({
       specs: workspace.specs,
       change,
@@ -4277,23 +4782,33 @@ async function runCiGate(opts) {
   return { checks, diagnostics, errors, warnings, failed };
 }
 export {
+  BACKUP_DIRNAME,
+  BACKUP_POINTER,
   BLOCK_HEAD_RE,
   BUILTIN_PACKS,
   CONFIG_FILE,
   CORE_VERSION,
+  LIVING_FIXES_DIR,
   REQ_HEAD_RE,
   REQ_ID_RE,
   RULE_ID_RE,
   RULE_RE,
   RUN_EVENT_TYPES,
+  SARIF_SCHEMA,
+  SARIF_VERSION,
   SCENARIO_HEAD_RE,
   SCENARIO_ID_RE,
+  SCHEMA_MIGRATIONS,
+  SCHEMA_VERSION,
   SDD_DIR,
   SLUG_RE,
   TASK_ID_RE,
   TASK_LINE_RE,
+  TOOL_NAME,
+  TOOL_URL,
   adoptWorkspace,
   appendRunEvent,
+  applyUpgrade,
   approvalsSchema,
   approveFromGithub,
   archiveChange,
@@ -4308,6 +4823,7 @@ export {
   checkMockups,
   checkTrace,
   collectMetrics,
+  collectVersionedArtifacts,
   commentIssue,
   compareTaskIds,
   computeInputsHash,
@@ -4372,6 +4888,7 @@ export {
   loadChange,
   loadConfig,
   loadDetectedBest,
+  loadLivingFixes,
   loadProfileFile,
   loadProfilesFromDir,
   loadProjectPacks,
@@ -4392,10 +4909,12 @@ export {
   parseChangeMeta,
   parseConfig,
   parseDelta,
+  parseFixCovers,
   parseFrontmatter,
   parseGitHubRemote,
   parseGlossary,
   parseIssueUrl,
+  parseLivingFix,
   parseRequirementBlocks,
   parseSpecFile,
   parseTasksFile,
@@ -4403,8 +4922,10 @@ export {
   patchChangeMeta,
   planBlock,
   planMockups,
+  planUpgrade,
   planWaves,
   profileSchema,
+  readArtifactVersion,
   readMockupManifest,
   readRun,
   readText,
@@ -4418,26 +4939,34 @@ export {
   renderTemplate,
   requiresMockups,
   resolvePacks,
+  rollbackUpgrade,
+  ruleDescription,
   runAnalyze,
   runCiGate,
   runDoctor,
   runProcess,
+  sarifLevel,
   setMockupRequirement,
   sha256,
   shortHash,
   signApproval,
   specHashOf,
   splitCommand,
+  stampSchemaVersion,
   stateLabel,
   syncGithubIssue,
   templatesFor,
   toPosix,
+  toSarifReport,
+  toSarifText,
   tokensFile,
   updateMockupScreenshots,
   updateRunStatus,
+  upgradeAdvisory,
   verifyApproval,
   walkFiles,
   writeConfig,
+  writeLivingFix,
   writeMockupManifest,
   writeMockupPlan,
   writeText