specatlas 0.1.36 → 0.1.38

package/dist/bin.js

@@ -5810,7 +5810,7 @@ var require_pako = __commonJS({
 });
 
 // src/cli.ts
-import path61 from "path";
+import path62 from "path";
 
 // ../core/dist/index.js
 import path from "path";
@@ -23473,14 +23473,14 @@ var parameters = /* @__PURE__ */ new Map([
   ["Z", 0],
   ["z", 0]
 ]);
-var parse = function(path62) {
+var parse = function(path63) {
   var cmd;
   var ret = [];
   var args = [];
   var curArg = "";
   var foundDecimal = false;
   var params = 0;
-  for (var _i = 0, path_1 = path62; _i < path_1.length; _i++) {
+  for (var _i = 0, path_1 = path63; _i < path_1.length; _i++) {
     var c = path_1[_i];
     if (parameters.has(c)) {
       params = parameters.get(c);
@@ -23794,8 +23794,8 @@ var segmentToBezier = function(cx1, cy1, th0, th1, rx, ry, sinTh, cosTh) {
   ];
   return result;
 };
-var svgPathToOperators = function(path62) {
-  return apply(parse(path62));
+var svgPathToOperators = function(path63) {
+  return apply(parse(path63));
 };
 
 // ../../node_modules/.pnpm/pdf-lib@1.17.1/node_modules/pdf-lib/es/api/operations.js
@@ -23952,7 +23952,7 @@ var drawEllipse = function(options) {
     popGraphicsState()
   ]).filter(Boolean);
 };
-var drawSvgPath = function(path62, options) {
+var drawSvgPath = function(path63, options) {
   var _a, _b, _c;
   return __spreadArrays([
     pushGraphicsState(),
@@ -23966,7 +23966,7 @@ var drawSvgPath = function(path62, options) {
     options.borderWidth && setLineWidth(options.borderWidth),
     options.borderLineCap && setLineCap(options.borderLineCap),
     setDashPattern((_b = options.borderDashArray) !== null && _b !== void 0 ? _b : [], (_c = options.borderDashPhase) !== null && _c !== void 0 ? _c : 0)
-  ], svgPathToOperators(path62), [
+  ], svgPathToOperators(path63), [
     // prettier-ignore
     options.color && options.borderWidth ? fillAndStroke() : options.color ? fill() : options.borderColor ? stroke() : closePath(),
     popGraphicsState()
@@ -27948,12 +27948,12 @@ var PDFPage = (
         graphicsState: graphicsStateKey
       }));
     };
-    PDFPage2.prototype.drawSvgPath = function(path62, options) {
+    PDFPage2.prototype.drawSvgPath = function(path63, options) {
       var _a, _b, _c, _d, _e, _f, _g, _h, _j;
       if (options === void 0) {
         options = {};
       }
-      assertIs(path62, "path", ["string"]);
+      assertIs(path63, "path", ["string"]);
       assertOrUndefined(options.x, "options.x", ["number"]);
       assertOrUndefined(options.y, "options.y", ["number"]);
       assertOrUndefined(options.scale, "options.scale", ["number"]);
@@ -27982,7 +27982,7 @@ var PDFPage = (
         options.borderColor = rgb(0, 0, 0);
       }
       var contentStream = this.getContentStream();
-      contentStream.push.apply(contentStream, drawSvgPath(path62, {
+      contentStream.push.apply(contentStream, drawSvgPath(path63, {
         x: (_a = options.x) !== null && _a !== void 0 ? _a : this.x,
         y: (_b = options.y) !== null && _b !== void 0 ? _b : this.y,
         scale: options.scale,
@@ -29375,10 +29375,12 @@ import path23 from "path";
 import { promises as fs2 } from "fs";
 import path24 from "path";
 import { parse as parseYaml11, stringify as stringifyYaml8 } from "yaml";
+import os from "os";
 import path25 from "path";
 import path26 from "path";
 import path27 from "path";
 import path28 from "path";
+import path29 from "path";
 var CORE_VERSION = "0.0.1";
 var DIAGNOSTIC_FAMILIES = [
   { prefix: "LINT-STR", title: "Estructura", description: "La forma del documento: ids, encabezados y bloques donde corresponde." },
@@ -30710,13 +30712,13 @@ var FIELD_LABEL = {
   when: "un CUANDO",
   then: "un ENTONCES"
 };
-function lintPlaceholders(req, path292) {
+function lintPlaceholders(req, path302) {
   const hits = requirementPlaceholders(req);
   if (hits.length === 0) return [];
   if (isSkeletonRequirement(req)) {
     return [
       diag("LINT-BIZ-003", "error", `El requisito ${req.id} sigue siendo la plantilla de \`satlas new\`: no especifica nada todav\xEDa`, {
-        path: path292,
+        path: path302,
         line: req.line,
         suggestion: "Escribe la necesidad de negocio, sus reglas y el CUANDO/ENTONCES de cada escenario"
       })
@@ -30725,7 +30727,7 @@ function lintPlaceholders(req, path292) {
   return hits.map((hit) => {
     const where = hit.scenario ? `${hit.scenario}` : req.id;
     return diag("LINT-BIZ-003", "error", `Texto de plantilla sin completar en ${where}: ${FIELD_LABEL[hit.field]} sigue siendo el hueco de \`satlas new\``, {
-      path: path292,
+      path: path302,
       line: hit.line,
       suggestion: "Escribe el comportamiento real de negocio en lugar del texto entre par\xE9ntesis de la plantilla"
     });
@@ -30755,14 +30757,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, path292, line) {
+function lintText(text, code, terms, label, path302, line) {
   const out = [];
   const lower = text.toLowerCase();
   for (const term of terms) {
     if (wordBoundary(lower, term)) {
       out.push(
         diag(code, "error", `${label}: "${term}"`, {
-          path: path292,
+          path: path302,
           line,
           suggestion: "La especificaci\xF3n es funcional y de negocio: describe comportamiento, no tecnolog\xEDa ni adjetivos vagos"
         })
@@ -30771,7 +30773,7 @@ function lintText(text, code, terms, label, path292, line) {
   }
   return out;
 }
-function lintRequirement(req, path292, opts = {}) {
+function lintRequirement(req, path302, opts = {}) {
   const out = [];
   const vague = opts.language === "en" ? VAGUE_EN : VAGUE_ES;
   const tech = opts.language === "en" ? TECH_EN : TECH_ES;
@@ -30782,33 +30784,33 @@ function lintRequirement(req, path292, 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", path292, part.line));
+    out.push(...lintText(part.text, "LINT-BIZ-002", vague, "Palabra vaga en la especificaci\xF3n", path302, part.line));
     if (opts.businessOnly !== false) {
-      out.push(...lintText(part.text, "LINT-BIZ-001", tech, "Jerga t\xE9cnica en la especificaci\xF3n de negocio", path292, part.line));
+      out.push(...lintText(part.text, "LINT-BIZ-001", tech, "Jerga t\xE9cnica en la especificaci\xF3n de negocio", path302, part.line));
     }
   }
-  out.push(...lintPlaceholders(req, path292));
+  out.push(...lintPlaceholders(req, path302));
   if (req.scenarios.length === 0) {
-    out.push(diag("TRACE-001", "error", `El requisito ${req.id} no tiene ning\xFAn escenario`, { path: path292, 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: path302, line: req.line, suggestion: "A\xF1ade al menos un escenario CUANDO/ENTONCES" }));
   }
   return out;
 }
-function lintDelta(delta, livingRequirements, path292, opts = {}) {
+function lintDelta(delta, livingRequirements, path302, opts = {}) {
   const out = [...delta.diagnostics];
   for (const req of [...delta.added, ...delta.modified]) {
-    out.push(...lintRequirement(req, path292, opts));
+    out.push(...lintRequirement(req, path302, 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: path292, line: req.line }));
+      out.push(diag("TRACE-007", "error", `MODIFIED ${req.id} no existe en la spec viva; usa ADDED`, { path: path302, 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: path292,
+            path: path302,
             line: req.line,
             suggestion: "Copia el bloque completo de la spec viva y ed\xEDtalo; para quitarlo, decl\xE1ralo en REMOVED"
           })
@@ -30819,15 +30821,15 @@ function lintDelta(delta, livingRequirements, path292, 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: path292, line: req.line }));
+      out.push(diag("TRACE-007", "error", `REMOVED ${req.id} no existe en la spec viva`, { path: path302, 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: path292, 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: path302, 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: path292, line: rename2.line }));
+      out.push(diag("TRACE-007", "error", `RENAMED ${rename2.from.id} no existe en la spec viva`, { path: path302, line: rename2.line }));
     }
   }
   return out;
@@ -30851,7 +30853,7 @@ var MERMAID_KEYWORDS = [
   "architecture-beta"
 ];
 var MERMAID_BLOCKS = /^\s*(alt|loop|opt|par|rect|critical|break|subgraph)\b/;
-function lintPlan(planText, path292) {
+function lintPlan(planText, path302) {
   const out = [];
   const blocks = [...planText.matchAll(/```mermaid\r?\n([\s\S]*?)```/g)];
   for (const [index, block] of blocks.entries()) {
@@ -30861,7 +30863,7 @@ function lintPlan(planText, path292) {
     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: path292,
+          path: path302,
           suggestion: "Corrige el tipo del diagrama o elimina el bloque"
         })
       );
@@ -30875,7 +30877,7 @@ function lintPlan(planText, path292) {
     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: path292,
+          path: path302,
           suggestion: "Cierra cada bloque alt/loop/opt/par/rect/subgraph con `end`"
         })
       );
@@ -30887,7 +30889,7 @@ function lintPlan(planText, path292) {
         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: path292,
+              path: path302,
               suggestion: "Sustituye `;` por `\xB7` o `,` en los mensajes de sequenceDiagram"
             })
           );
@@ -34463,6 +34465,11 @@ function labelsFor(language) {
       signatureName: "Approver name",
       signatureDate: "Signature date",
       signatureNote: "The signature is recorded with the specification hash and the date.",
+      signedBy: "Approved by",
+      signedAt: "Date",
+      signedHash: "Signed hash",
+      signedChannel: "Channel",
+      signHere: "Sign here to approve this proposal.",
       openMockup: "Open mockup",
       mockupHint: "Each screen opens full size in its own tab. In a browser they are also previewed inline.",
       illustrates: "Illustrates"
@@ -34494,6 +34501,11 @@ function labelsFor(language) {
     missingMockups: "Mockups declarados que faltan",
     screenshots: "Capturas",
     print: "Imprimir / Guardar PDF",
+    signedBy: "Aprobada por",
+    signedAt: "Fecha",
+    signedHash: "Huella firmada",
+    signedChannel: "Canal",
+    signHere: "Firma aqu\xED para aprobar esta propuesta.",
     signatureName: "Nombre de quien aprueba",
     signatureDate: "Fecha de la firma",
     signatureNote: "La firma se registra con la huella de la especificaci\xF3n y la fecha.",
@@ -34576,6 +34588,8 @@ th { background:var(--elev); font-size:11px; text-transform:uppercase; letter-sp
 .grid-shots { display:grid; grid-template-columns:repeat(auto-fill, minmax(220px, 1fr)); gap:12px; margin-top:12px; }
 .grid-shots img { width:100%; border:1px solid var(--line); border-radius:10px; }
 .signature { display:grid; grid-template-columns:1.2fr .8fr; gap:18px; }
+.sign-line.signed { border-style:solid; border-color:var(--ok); background:color-mix(in srgb, var(--ok) 8%, transparent); }
+.sign-line .mono { font-family:ui-monospace, Consolas, monospace; font-size:11.5px; word-break:break-all; }
 .sign-line { border:1px dashed var(--accent); border-radius:8px; padding:16px; background:var(--accent-soft); }
 .sign-line .sl-row { display:flex; justify-content:space-between; gap:12px; border-bottom:1px solid var(--line); padding:0 0 6px; margin-bottom:18px; color:var(--muted); font-size:12.5px; }
 .sign-line .sl-row:last-child { border-bottom:0; margin-bottom:0; padding-top:14px; }
@@ -34622,6 +34636,15 @@ function page(input) {
     return `<tr><td><code>${esc(s.id)}</code></td><td>${esc(s.title)}</td><td><span class="pill ${cls}">${esc(label)}</span></td></tr>`;
   }).join("");
   const signatureState = input.approvalStatus === "valid" && input.approval ? `<div class="sign-state ok"><span class="ss-label">${esc(l.approve)}</span><b>${esc(l.approveDone.replace("{by}", input.approval.by).replace("{at}", input.approval.at))}</b></div>` : input.approvalStatus === "stale" && input.approval ? `<div class="sign-state stale"><span class="ss-label">${esc(l.approve)}</span><b>${esc(l.approveStale)}</b><p>${esc(l.approveDone.replace("{by}", input.approval.by).replace("{at}", input.approval.at))}</p></div>` : `<div class="sign-state"><span class="ss-label">${esc(l.approve)}</span><b>${esc(l.approvePending)}</b><p>${esc(l.approveText)}</p></div>`;
+  const signatureBlock = input.approvalStatus === "valid" && input.approval ? `<div class="sign-line signed">
+            <div class="sl-row"><span>${esc(l.signedBy)}</span><b>${esc(input.approval.by)}</b></div>
+            <div class="sl-row"><span>${esc(l.signedAt)}</span><b>${esc(input.approval.at)}</b></div>
+            <div class="sl-row"><span>${esc(l.signedHash)}</span><span class="mono">${esc(input.hash)}</span></div>
+          </div>` : `<div class="sign-line">
+            <p class="sign-help" style="margin:0 0 12px">${esc(l.signHere)}</p>
+            <div class="sl-row"><span>${esc(l.signatureName)}</span><span style="font-family:ui-monospace,Consolas,monospace">____________________</span></div>
+            <div class="sl-row"><span>${esc(l.signatureDate)}</span><span style="font-family:ui-monospace,Consolas,monospace">____ / ____ / ________</span></div>
+          </div>`;
   const mockupHtml = input.mockups.length === 0 ? `<div class="callout">${esc(l.noMockups)}</div>` : `<p class="sign-help" style="margin:0 0 12px">${esc(l.mockupHint)}</p><div class="mockups">${input.mockups.map(
     (m) => `<div class="mockup ${m.platform === "mobile" ? "phone" : ""}" data-mockup="${esc(m.file)}" data-title="${esc(m.title)}"><header><span>${esc(m.title)}</span><a class="btn" href="${esc(m.file)}" target="_blank" rel="noopener">${esc(l.openMockup)}</a></header><div class="mockup-body"><span class="mockup-file">${esc(m.file)}</span>${m.illustrates.length > 0 ? `<span class="mockup-scn">${esc(l.illustrates)}: ${m.illustrates.map((id) => esc(id)).join(", ")}</span>` : ""}</div></div>`
   ).join("")}</div>`;
@@ -34716,14 +34739,11 @@ function page(input) {
       <div class="card-head"><span class="num">05</span><h2>${esc(l.approve)}</h2><span class="sub">acto humano \xB7 queda auditado</span></div>
       <div class="card-body">
         <div class="signature">
-          <div class="sign-line">
-            <div class="sl-row"><span>${esc(l.signatureName)}</span><span style="font-family:ui-monospace,Consolas,monospace">____________________</span></div>
-            <div class="sl-row"><span>${esc(l.signatureDate)}</span><span style="font-family:ui-monospace,Consolas,monospace">____ / ____ / ________</span></div>
-          </div>
+          ${signatureBlock}
           <div>
             <p class="sign-help">${esc(l.signatureNote)}</p>
-            <p class="sign-help" style="margin-top:8px"><code>${esc(input.approveHint)}</code></p>
-            <p class="sign-help" style="margin-top:10px">${esc(l.approveStale)}</p>
+            ${input.approvalStatus === "valid" ? "" : `<p class="sign-help" style="margin-top:8px"><code>${esc(input.approveHint)}</code></p>`}
+            ${input.approvalStatus === "stale" ? `<p class="sign-help" style="margin-top:10px">${esc(l.approveStale)}</p>` : ""}
           </div>
         </div>
       </div>
@@ -35712,6 +35732,140 @@ async function upgradeAdvisory(root) {
   }
   return { plan, diagnostics };
 }
+var PACKAGE_NAME = "specatlas";
+var REGISTRY = "https://registry.npmjs.org";
+var TTL_MS = 24 * 60 * 60 * 1e3;
+var TIMEOUT_MS = 2e3;
+function detectarInstalacion(rutaEjecutable2, plataforma = process.platform) {
+  const ruta = toPosix(rutaEjecutable2).toLowerCase();
+  if (/[/](_npx|\.npm[/]_npx)[/]/.test(ruta) || ruta.includes("/.pnpm-store/") || /[/]dlx-[^/]*[/]/.test(ruta)) {
+    return {
+      gestor: "npx",
+      motivo: "la herramienta se est\xE1 ejecutando sin instalar: cada ejecuci\xF3n ya usa la versi\xF3n publicada"
+    };
+  }
+  if (ruta.includes("/pnpm/global/") || ruta.includes("/.pnpm/global/") || /[/]pnpm[/][^/]*[/]global[/]/.test(ruta)) {
+    return { gestor: "pnpm", comando: `pnpm add -g ${PACKAGE_NAME}@latest` };
+  }
+  if (ruta.includes("/.bun/")) {
+    return { gestor: "bun", comando: `bun add -g ${PACKAGE_NAME}@latest` };
+  }
+  if (ruta.includes("/.yarn/") || ruta.includes("/yarn/global/")) {
+    return { gestor: "yarn", comando: `yarn global add ${PACKAGE_NAME}@latest` };
+  }
+  if (ruta.includes("/npm/node_modules/") || ruta.includes("/roaming/npm/") || ruta.includes("/lib/node_modules/") || ruta.includes("/npm-global/")) {
+    return { gestor: "npm", comando: `npm install -g ${PACKAGE_NAME}@latest` };
+  }
+  return { gestor: "desconocido", comando: plataforma === "win32" ? `npm install -g ${PACKAGE_NAME}@latest` : `npm install -g ${PACKAGE_NAME}@latest` };
+}
+function compararVersiones(a, b) {
+  const partes = (v) => v.trim().replace(/^v/, "").split("-")[0].split(".").map((n) => Number.parseInt(n, 10) || 0);
+  const ap = partes(a);
+  const bp = partes(b);
+  for (let i = 0; i < 3; i += 1) {
+    const diff = (ap[i] ?? 0) - (bp[i] ?? 0);
+    if (diff !== 0) return diff > 0 ? 1 : -1;
+  }
+  return 0;
+}
+function hayVersionNueva(instalada, publicada) {
+  if (!publicada) return false;
+  return compararVersiones(publicada, instalada) > 0;
+}
+var PREFERENCIAS_POR_DEFECTO = { comprobar: true, automatica: false };
+function directorioPersonal(home = os.homedir()) {
+  return path25.join(home, ".specatlas");
+}
+function rutaPreferencias(home) {
+  return path25.join(directorioPersonal(home), "config.json");
+}
+function rutaEstado(home) {
+  return path25.join(directorioPersonal(home), "update-check.json");
+}
+async function leerPreferencias(home) {
+  const raw = await readTextIfExists(rutaPreferencias(home));
+  if (raw === void 0) return { ...PREFERENCIAS_POR_DEFECTO };
+  try {
+    const data = JSON.parse(raw);
+    return {
+      comprobar: data.update?.comprobar ?? PREFERENCIAS_POR_DEFECTO.comprobar,
+      automatica: data.update?.automatica ?? PREFERENCIAS_POR_DEFECTO.automatica
+    };
+  } catch {
+    return { ...PREFERENCIAS_POR_DEFECTO };
+  }
+}
+async function escribirPreferencias(preferencias, home) {
+  const file = rutaPreferencias(home);
+  await ensureDir(path25.dirname(file));
+  await writeText(file, `${JSON.stringify({ update: preferencias }, null, 2)}
+`);
+  return file;
+}
+async function leerEstado(home) {
+  const raw = await readTextIfExists(rutaEstado(home));
+  if (raw === void 0) return {};
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+async function escribirEstado(estado, home) {
+  const file = rutaEstado(home);
+  await ensureDir(path25.dirname(file));
+  await writeText(file, `${JSON.stringify(estado, null, 2)}
+`);
+}
+function tocaConsultar(estado, ahora = /* @__PURE__ */ new Date(), ttlMs = TTL_MS) {
+  if (!estado.ultimaConsulta) return true;
+  const ultima = Date.parse(estado.ultimaConsulta);
+  if (Number.isNaN(ultima)) return true;
+  return ahora.getTime() - ultima >= ttlMs;
+}
+function esIntegracionContinua(env = process.env) {
+  return Boolean(env["CI"] || env["CONTINUOUS_INTEGRATION"] || env["GITHUB_ACTIONS"] || env["GITLAB_CI"] || env["BUILDKITE"] || env["TEAMCITY_VERSION"]);
+}
+function comprobacionDesactivada(env = process.env) {
+  const flag3 = env["SPECATLAS_NO_UPDATE_CHECK"];
+  return flag3 === "1" || flag3 === "true";
+}
+async function consultarVersionPublicada(timeoutMs = TIMEOUT_MS, fetchImpl = fetch) {
+  const control = new AbortController();
+  const timer = setTimeout(() => control.abort(), timeoutMs);
+  try {
+    const respuesta = await fetchImpl(`${REGISTRY}/-/package/${PACKAGE_NAME}/dist-tags`, { signal: control.signal });
+    if (!respuesta.ok) return void 0;
+    const data = await respuesta.json();
+    return typeof data.latest === "string" ? data.latest : void 0;
+  } catch {
+    return void 0;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function comprobarActualizacion(ctx) {
+  const env = ctx.env ?? process.env;
+  if (ctx.json || esIntegracionContinua(env) || comprobacionDesactivada(env)) return void 0;
+  const preferencias = await leerPreferencias(ctx.home);
+  if (!preferencias.comprobar) return void 0;
+  const ahora = ctx.ahora ?? /* @__PURE__ */ new Date();
+  const estado = await leerEstado(ctx.home);
+  let publicada = estado.ultimaVersion;
+  if (tocaConsultar(estado, ahora)) {
+    publicada = await consultarVersionPublicada(TIMEOUT_MS, ctx.fetchImpl ?? fetch);
+    if (publicada === void 0) return void 0;
+    await escribirEstado({ ultimaConsulta: ahora.toISOString(), ultimaVersion: publicada }, ctx.home);
+  }
+  if (!hayVersionNueva(ctx.instalada, publicada)) return void 0;
+  const instalacion = detectarInstalacion(ctx.rutaEjecutable);
+  return {
+    instalada: ctx.instalada,
+    publicada,
+    comando: instalacion.comando ?? `npm install -g ${PACKAGE_NAME}@latest`,
+    gestor: instalacion.gestor
+  };
+}
 var DOCS_MARKER_START = "<!-- specatlas:generado:inicio -->";
 var DOCS_MARKER_END = "<!-- specatlas:generado:fin -->";
 var ES_WORDING = {
@@ -36197,7 +36351,7 @@ ${notes}
 ${existing}`;
 }
 async function generateDocs(opts) {
-  const root = path25.resolve(opts.root);
+  const root = path26.resolve(opts.root);
   const { config } = await loadWorkspace(root);
   const change = await loadChange(root, opts.slug);
   if (!change.meta) {
@@ -36213,10 +36367,10 @@ async function generateDocs(opts) {
   const tipos = tipo === "all" ? ["tecnica", "manual"] : [tipo];
   const templates = templatesFor(language);
   const [proposalRaw, planRaw, glossaryRaw, analyzeRaw, mockupManifest] = await Promise.all([
-    readTextIfExists(path25.join(change.dir, "proposal.md")),
-    readTextIfExists(path25.join(change.dir, "plan.md")),
-    readTextIfExists(path25.join(root, ".sdd", "glossary.md")),
-    readTextIfExists(path25.join(change.dir, "analyze.md")),
+    readTextIfExists(path26.join(change.dir, "proposal.md")),
+    readTextIfExists(path26.join(change.dir, "plan.md")),
+    readTextIfExists(path26.join(root, ".sdd", "glossary.md")),
+    readTextIfExists(path26.join(change.dir, "analyze.md")),
     readMockupManifest(root, change.slug)
   ]);
   const mockups = (mockupManifest.manifest?.screens ?? []).map((screen) => ({
@@ -36230,7 +36384,7 @@ async function generateDocs(opts) {
   const files = [];
   const diagnostics = [];
   for (const current of tipos) {
-    const file = path25.join(change.dir, "docs", `${current}.md`);
+    const file = path26.join(change.dir, "docs", `${current}.md`);
     const block = renderTemplate(current === "tecnica" ? templates.docTecnica : templates.docManual, data);
     const existing = await readTextIfExists(file);
     const content = mergeManaged(existing, block, language);
@@ -36239,7 +36393,7 @@ async function generateDocs(opts) {
     const label = current === "tecnica" ? "t\xE9cnico" : "manual";
     const title = `${current === "tecnica" ? language === "en" ? "Technical document" : "Documento t\xE9cnico" : language === "en" ? "User manual" : "Manual de usuario"} \u2014 ${change.meta.title ?? change.slug}`;
     try {
-      const htmlPath = path25.join(change.dir, "docs", `${current}.html`);
+      const htmlPath = path26.join(change.dir, "docs", `${current}.html`);
       await writeText(htmlPath, renderDocument(content, { theme: "auto", title }));
       doc.htmlPath = htmlPath;
     } catch (error2) {
@@ -36251,7 +36405,7 @@ async function generateDocs(opts) {
       );
     }
     try {
-      const pdfPath = path25.join(change.dir, "docs", `${current}.pdf`);
+      const pdfPath = path26.join(change.dir, "docs", `${current}.pdf`);
       const pdf = await renderPdf(content, { title, project: config.project.name, generatedAt: localStamp(ahora) });
       await writeBytes(pdfPath, pdf.bytes);
       doc.pdfPath = pdfPath;
@@ -36304,7 +36458,7 @@ function resultOf(diagnostic, root) {
     message: { text: diagnostic.message }
   };
   if (diagnostic.path) {
-    const rel = path26.relative(root, diagnostic.path);
+    const rel = path27.relative(root, diagnostic.path);
     if (rel !== "") {
       const physicalLocation = {
         artifactLocation: { uri: toPosix(rel) },
@@ -36359,7 +36513,7 @@ async function runDoctor(root) {
   const approvals = await loadApprovals(workspace.sddDir);
   findings.push(...approvals.diagnostics);
   for (const change of workspace.changes) {
-    const deltaPath = path27.join(change.dir, "spec.md");
+    const deltaPath = path28.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")) {
@@ -36381,7 +36535,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: path27.join(change.dir, "meta.yaml") }));
+        findings.push(diag("ATLAS-LIFECYCLE-004", "error", `Override del gate "${override.gate}" sin motivo o autor`, { path: path28.join(change.dir, "meta.yaml") }));
       }
     }
   }
@@ -36413,7 +36567,7 @@ function livingRequirementsMap(specs) {
   return map;
 }
 async function runCiGate(opts) {
-  const root = path28.resolve(opts.root);
+  const root = path29.resolve(opts.root);
   const { workspace, config } = await loadWorkspace(root);
   const diagnostics = [];
   const checks = [];
@@ -36424,7 +36578,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, path28.join(change.dir, "spec.md"), { language: config.spec.language }) : [];
+    const lintFindings = change.delta ? lintDelta(change.delta, living, path29.join(change.dir, "spec.md"), { language: config.spec.language }) : [];
     const trace = checkTrace({
       specs: workspace.specs,
       change,
@@ -36565,6 +36719,7 @@ var CATALOG = [
   { name: "run", description: "Persiste runs y eventos de ejecuci\xF3n (auditor\xEDa y reanudaci\xF3n)", flags: ["phase", "inputs", "data", "slug", "status", "json"], usage: "satlas run start|event|status|show|list" },
   { name: "hash", description: "Calcula el sha256 de un archivo o texto (para evidencia)", flags: ["text", "json"], usage: 'satlas hash <archivo> | satlas hash --text "salida"' },
   { name: "explain", description: "Explica un c\xF3digo de diagn\xF3stico: qu\xE9 significa, por qu\xE9 importa y c\xF3mo se cierra", flags: ["json"], usage: "satlas explain [<c\xF3digo>]" },
+  { name: "self-update", description: "Actualiza la herramienta a la versi\xF3n publicada (o solo comprueba si la hay)", flags: ["check", "auto", "json"], usage: "satlas self-update [--check] [--auto on|off]" },
   { name: "version", description: "Muestra la versi\xF3n", flags: ["json"], usage: "satlas version" },
   { name: "help", description: "Muestra la ayuda", flags: ["json"], usage: "satlas help [comando]" }
 ];
@@ -36682,26 +36837,26 @@ function cliVersion() {
 }
 
 // src/commands/adapters.ts
-import path31 from "path";
+import path32 from "path";
 
 // ../adapters/dist/index.js
-import path29 from "path";
+import path30 from "path";
 import { stringify as stringifyYaml9 } from "yaml";
 import path210 from "path";
 async function loadWorkflow(workflowDir) {
-  const phasesDir = path29.join(workflowDir, "phases");
-  const snippetsDir = path29.join(workflowDir, "snippets");
+  const phasesDir = path30.join(workflowDir, "phases");
+  const snippetsDir = path30.join(workflowDir, "snippets");
   const phases = [];
   const snippets = /* @__PURE__ */ new Map();
   const hashParts = [];
   for (const entry of (await listDir(phasesDir)).sort()) {
     if (!entry.endsWith(".md")) continue;
-    const filePath = path29.join(phasesDir, entry);
+    const filePath = path30.join(phasesDir, entry);
     const raw = await readText(filePath);
     hashParts.push(raw);
     const fm = parseFrontmatter(raw, filePath);
     const data = fm.data;
-    const id = typeof data["id"] === "string" ? data["id"] : path29.basename(entry, ".md");
+    const id = typeof data["id"] === "string" ? data["id"] : path30.basename(entry, ".md");
     phases.push({
       id,
       title: typeof data["title"] === "string" ? data["title"] : id,
@@ -36715,9 +36870,9 @@ async function loadWorkflow(workflowDir) {
   }
   for (const entry of (await listDir(snippetsDir)).sort()) {
     if (!entry.endsWith(".md")) continue;
-    const raw = await readTextIfExists(path29.join(snippetsDir, entry)) ?? "";
+    const raw = await readTextIfExists(path30.join(snippetsDir, entry)) ?? "";
     hashParts.push(raw);
-    snippets.set(path29.basename(entry, ".md"), raw.trim());
+    snippets.set(path30.basename(entry, ".md"), raw.trim());
   }
   return { phases: phases.sort((a, b) => a.id.localeCompare(b.id)), snippets, sourceHash: sha256(hashParts.join("\n---\n")) };
 }
@@ -37032,11 +37187,11 @@ async function checkAdapters(opts) {
 }
 
 // src/paths.ts
-import path30 from "path";
+import path31 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 async function isSourceRepoRoot(dir) {
-  if (!await exists(path30.join(dir, "pnpm-workspace.yaml"))) return false;
-  const raw = await readTextIfExists(path30.join(dir, "packages", "cli", "package.json"));
+  if (!await exists(path31.join(dir, "pnpm-workspace.yaml"))) return false;
+  const raw = await readTextIfExists(path31.join(dir, "packages", "cli", "package.json"));
   if (raw === void 0) return false;
   try {
     return JSON.parse(raw).name === "specatlas";
@@ -37048,17 +37203,17 @@ async function sourceRepoRoot(startDir) {
   let dir = startDir;
   for (let i = 0; i < 5; i += 1) {
     if (await isSourceRepoRoot(dir)) return dir;
-    const parent = path30.dirname(dir);
+    const parent = path31.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
   return void 0;
 }
 async function resolveFromSource(relative) {
-  const start = path30.dirname(fileURLToPath2(import.meta.url));
+  const start = path31.dirname(fileURLToPath2(import.meta.url));
   const root = await sourceRepoRoot(start);
   if (!root) return void 0;
-  const candidate = path30.join(root, relative);
+  const candidate = path31.join(root, relative);
   return await exists(candidate) ? candidate : void 0;
 }
 async function resolveProfilesDir() {
@@ -37069,16 +37224,16 @@ async function resolveProfilesDir() {
 async function resolveWorkflowDir() {
   const env = process.env["SPECATLAS_WORKFLOW_DIR"];
   if (env && await exists(env)) return env;
-  return await resolveFromSource("workflow") ?? walkUpFor(path30.join("workflow", "phases"));
+  return await resolveFromSource("workflow") ?? walkUpFor(path31.join("workflow", "phases"));
 }
 async function walkUpFor(relative) {
-  let dir = path30.dirname(fileURLToPath2(import.meta.url));
+  let dir = path31.dirname(fileURLToPath2(import.meta.url));
   for (let i = 0; i < 8; i += 1) {
-    const candidate = path30.join(dir, relative);
+    const candidate = path31.join(dir, relative);
     if (await exists(candidate)) {
-      return relative.includes(path30.sep) ? path30.dirname(candidate) : candidate;
+      return relative.includes(path31.sep) ? path31.dirname(candidate) : candidate;
     }
-    const parent = path30.dirname(dir);
+    const parent = path31.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
@@ -37156,7 +37311,7 @@ async function runAdapters(ctx) {
   for (const [target, count2] of byTarget) lines.push(`  ${target}: ${count2} archivo(s)`);
   if (report.written.length > 0) {
     lines.push("");
-    for (const p of report.written) lines.push(`  + ${path31.relative(ctx.cwd, path31.join(root, p))}`);
+    for (const p of report.written) lines.push(`  + ${path32.relative(ctx.cwd, path32.join(root, p))}`);
   } else {
     lines.push("");
     lines.push("Sin cambios: los adaptadores ya estaban al d\xEDa.");
@@ -37167,7 +37322,7 @@ async function runAdapters(ctx) {
 }
 
 // src/commands/adopt.ts
-import path32 from "path";
+import path33 from "path";
 async function runAdopt(ctx) {
   const { root } = await requireWorkspace(ctx);
   const domainsFlag = flagString(ctx.flags, "domains") ?? flagString(ctx.flags, "domain");
@@ -37187,11 +37342,11 @@ async function runAdopt(ctx) {
   }
   if (result.createdSpecs.length > 0) {
     lines.push("");
-    for (const spec of result.createdSpecs) lines.push(`  ${result.dryRun ? "[dry-run] " : "+ "}${path32.relative(ctx.cwd, spec)}`);
+    for (const spec of result.createdSpecs) lines.push(`  ${result.dryRun ? "[dry-run] " : "+ "}${path33.relative(ctx.cwd, spec)}`);
   }
   if (result.reportPath && !result.dryRun) {
     lines.push("");
-    lines.push(`  Informe: ${path32.relative(ctx.cwd, result.reportPath)}`);
+    lines.push(`  Informe: ${path33.relative(ctx.cwd, result.reportPath)}`);
   }
   lines.push("");
   lines.push("Siguiente: fase /satlas-adopt por dominio (requisitos AS-IS) y luego:");
@@ -37204,8 +37359,8 @@ async function runAdopt(ctx) {
     diagnostics: result.diagnostics,
     data: {
       domains: result.domains.map((d) => ({ name: d.name, files: d.files, existingSpec: d.existingSpec })),
-      createdSpecs: result.createdSpecs.map((s) => path32.relative(ctx.cwd, s)),
-      reportPath: result.reportPath ? path32.relative(ctx.cwd, result.reportPath) : void 0,
+      createdSpecs: result.createdSpecs.map((s) => path33.relative(ctx.cwd, s)),
+      reportPath: result.reportPath ? path33.relative(ctx.cwd, result.reportPath) : void 0,
       stack: result.stack,
       dryRun: result.dryRun
     },
@@ -37254,7 +37409,7 @@ async function runAmend(ctx) {
 }
 
 // src/commands/analyze.ts
-import path33 from "path";
+import path34 from "path";
 async function runAnalyzeCommand(ctx) {
   const { root } = await requireWorkspace(ctx);
   const slug = ctx.positionals[0];
@@ -37265,23 +37420,23 @@ async function runAnalyzeCommand(ctx) {
   const lines = [`An\xE1lisis \u2014 ${slug}`, "", `  estado: ${result.status}`, `  hallazgos: ${result.summary.errors} errores, ${result.summary.warnings} avisos`, `  evidencia: ${result.evidence.done}/${result.evidence.total} escenarios`];
   if (result.waves) lines.push(`  olas: ${result.waves.blocks} bloque(s), ${result.waves.waves} ola(s), ${result.waves.tasks} tarea(s)`);
   if (result.mockups) lines.push(`  mockups: ${result.mockups.screens} pantalla(s)${result.mockups.stale ? " (desactualizados)" : ""}`);
-  if (result.path) lines.push("", `  informe: ${path33.relative(ctx.cwd, result.path)}`);
+  if (result.path) lines.push("", `  informe: ${path34.relative(ctx.cwd, result.path)}`);
   for (const finding of result.findings) {
     lines.push(`  ${finding.severity.toUpperCase()} ${finding.code} \u2014 ${finding.message}`);
   }
   return {
     exitCode: result.status === "blocked" ? 1 : 0,
     diagnostics: result.findings,
-    data: result.path ? { ...result, path: path33.relative(ctx.cwd, result.path) } : result,
+    data: result.path ? { ...result, path: path34.relative(ctx.cwd, result.path) } : result,
     text: lines
   };
 }
 
 // src/commands/approve.ts
-import path35 from "path";
+import path36 from "path";
 
 // src/commands/issue.ts
-import path34 from "path";
+import path35 from "path";
 async function runIssue(ctx) {
   const action = ctx.positionals[0] ?? "status";
   const slug = ctx.positionals[1];
@@ -37309,7 +37464,7 @@ async function runIssue(ctx) {
       return { exitCode: 2, diagnostics: [{ code: "ATLAS-ISSUE-000", severity: "error", message: "Falta el slug: satlas issue status <slug>" }] };
     }
     const change = await loadChange(root, slug);
-    const { config } = await loadConfig(path34.join(root, ".sdd"));
+    const { config } = await loadConfig(path35.join(root, ".sdd"));
     const tracker = change.meta?.tracker;
     const lines = [`Issue de ${slug}`, ""];
     if (!tracker || tracker.provider !== "github") {
@@ -37380,7 +37535,7 @@ async function runApprove(ctx) {
     };
   }
   const { root, workspace, config } = await requireWorkspace(ctx);
-  const artifact = target.includes("/") || target.includes("\\") ? target : path35.join("changes", target, "spec.md");
+  const artifact = target.includes("/") || target.includes("\\") ? target : path36.join("changes", target, "spec.md");
   const channelFlag = flagString(ctx.flags, "channel");
   const channel = channelFlag === "presentation" || channelFlag === "editor" || channelFlag === "pr" || channelFlag === "tracker" ? channelFlag : "cli";
   const change = workspace.changes.find(
@@ -37416,18 +37571,30 @@ async function runApprove(ctx) {
     lines.push(`  fecha:     ${result.approval.approvedAt}`);
     lines.push("");
     lines.push("La firma desbloquea el plan. Si el artefacto cambia, la firma queda obsoleta autom\xE1ticamente.");
+    const slug = change?.slug;
+    if (slug && !flagBool(ctx.flags, "dry-run")) {
+      const presentation = path36.join(root, ".sdd", "changes", slug, "presentation", "index.html");
+      if (await exists(presentation)) {
+        try {
+          await generatePresentation({ root, slug });
+          lines.push(`Propuesta actualizada con la firma: ${path36.relative(ctx.cwd, presentation)}`);
+        } catch (error2) {
+          lines.push(`La propuesta no se pudo rehacer (${error2.message}); vuelve a generarla con \`satlas present ${slug}\`.`);
+        }
+      }
+    }
   }
   const hasErrors2 = result.diagnostics.some((d) => d.severity === "error");
   return {
     exitCode: hasErrors2 ? 1 : 0,
     diagnostics: result.diagnostics,
-    data: result.approval ? { ...result.approval, file: path35.relative(ctx.cwd, result.file) } : void 0,
+    data: result.approval ? { ...result.approval, file: path36.relative(ctx.cwd, result.file) } : void 0,
     text: lines
   };
 }
 
 // src/commands/archive.ts
-import path36 from "path";
+import path37 from "path";
 async function runArchive(ctx) {
   const slug = ctx.positionals[0];
   if (!slug) {
@@ -37464,7 +37631,7 @@ async function runArchive(ctx) {
   } else {
     lines.push("El delta no contiene operaciones (ADDED/MODIFIED/REMOVED/RENAMED).");
   }
-  if (result.archivedTo) lines.push(`  archivado en: ${path36.relative(ctx.cwd, result.archivedTo)}`);
+  if (result.archivedTo) lines.push(`  archivado en: ${path37.relative(ctx.cwd, result.archivedTo)}`);
   const hasErrors2 = result.diagnostics.some((d) => d.severity === "error");
   return {
     exitCode: hasErrors2 ? 1 : 0,
@@ -37475,7 +37642,7 @@ async function runArchive(ctx) {
 }
 
 // src/commands/ci.ts
-import path37 from "path";
+import path38 from "path";
 async function runCi(ctx) {
   const { root, config } = await requireWorkspace(ctx);
   const strict = flagBool(ctx.flags, "strict");
@@ -37501,10 +37668,10 @@ async function runCi(ctx) {
   const lines = ["CI de SpecAtlas", ""];
   let sarifWritten;
   if (sarifPath) {
-    const target = path37.resolve(ctx.cwd, sarifPath);
+    const target = path38.resolve(ctx.cwd, sarifPath);
     try {
       await writeText(target, toSarifText({ diagnostics: gate.diagnostics, root, version: cliVersion(), failed: gate.failed }));
-      sarifWritten = path37.relative(ctx.cwd, target);
+      sarifWritten = path38.relative(ctx.cwd, target);
     } catch (err) {
       diagnostics.push({
         code: "ATLAS-CI-SARIF-001",
@@ -37581,7 +37748,7 @@ async function runClarify(ctx) {
 }
 
 // src/commands/contracts.ts
-import path38 from "path";
+import path39 from "path";
 async function runContracts(ctx) {
   const slug = ctx.positionals[0];
   if (!slug) {
@@ -37601,7 +37768,7 @@ async function runContracts(ctx) {
   const coverage = contractCoverage(change, config.gates.contracts.mode);
   const findings = [...state.findings, ...coverage];
   for (const file of state.files) {
-    lines.push(`  ${path38.relative(ctx.cwd, file.path)} (${file.format}) \u2014 ${file.operations.length} operaci\xF3n(es)`);
+    lines.push(`  ${path39.relative(ctx.cwd, file.path)} (${file.format}) \u2014 ${file.operations.length} operaci\xF3n(es)`);
     for (const operation of file.operations) lines.push(`    ${operation.id}`);
   }
   lines.push("");
@@ -37617,7 +37784,7 @@ async function runContracts(ctx) {
     data: {
       slug,
       mode: config.gates.contracts.mode,
-      contracts: state.files.map((file) => ({ path: path38.relative(ctx.cwd, file.path), format: file.format, operations: file.operations.map((operation) => operation.id) })),
+      contracts: state.files.map((file) => ({ path: path39.relative(ctx.cwd, file.path), format: file.format, operations: file.operations.map((operation) => operation.id) })),
       findings
     },
     text: lines
@@ -37625,7 +37792,7 @@ async function runContracts(ctx) {
 }
 
 // src/commands/docs.ts
-import path39 from "path";
+import path40 from "path";
 async function runDocs(ctx) {
   const slug = ctx.positionals[0];
   if (!slug) {
@@ -37639,9 +37806,9 @@ async function runDocs(ctx) {
   const warnings = result.diagnostics.filter((d) => d.severity === "warning");
   const lines = [msg("docs.title", ctx.language), ""];
   for (const file of result.files) {
-    lines.push(`  ${file.created ? msg("docs.created", ctx.language) : msg("docs.updated", ctx.language)}: ${path39.relative(ctx.cwd, file.path)}`);
-    if (file.htmlPath) lines.push(`    html: ${path39.relative(ctx.cwd, file.htmlPath)}`);
-    if (file.pdfPath) lines.push(`    pdf:  ${path39.relative(ctx.cwd, file.pdfPath)}`);
+    lines.push(`  ${file.created ? msg("docs.created", ctx.language) : msg("docs.updated", ctx.language)}: ${path40.relative(ctx.cwd, file.path)}`);
+    if (file.htmlPath) lines.push(`    html: ${path40.relative(ctx.cwd, file.htmlPath)}`);
+    if (file.pdfPath) lines.push(`    pdf:  ${path40.relative(ctx.cwd, file.pdfPath)}`);
   }
   for (const warning of warnings) lines.push(`  AVISO ${warning.code} \u2014 ${warning.message}`);
   for (const error2 of errors) lines.push(`  ERROR ${error2.code} \u2014 ${error2.message}`);
@@ -37653,10 +37820,10 @@ async function runDocs(ctx) {
       tipo,
       files: result.files.map((file) => ({
         tipo: file.tipo,
-        path: path39.relative(ctx.cwd, file.path),
+        path: path40.relative(ctx.cwd, file.path),
         created: file.created,
-        html: file.htmlPath ? path39.relative(ctx.cwd, file.htmlPath) : void 0,
-        pdf: file.pdfPath ? path39.relative(ctx.cwd, file.pdfPath) : void 0
+        html: file.htmlPath ? path40.relative(ctx.cwd, file.htmlPath) : void 0,
+        pdf: file.pdfPath ? path40.relative(ctx.cwd, file.pdfPath) : void 0
       }))
     },
     text: lines
@@ -37664,7 +37831,7 @@ async function runDocs(ctx) {
 }
 
 // src/commands/drift.ts
-import path40 from "path";
+import path41 from "path";
 async function runDrift(ctx) {
   const { root, config } = await requireWorkspace(ctx);
   const anchors = await loadAllAnchors(root);
@@ -37708,7 +37875,7 @@ async function runDrift(ctx) {
       mode: report.mode,
       domains: report.domains,
       checked: report.checked,
-      drifted: report.drifted.map((item) => ({ ...item, specPath: path40.relative(ctx.cwd, item.specPath) }))
+      drifted: report.drifted.map((item) => ({ ...item, specPath: path41.relative(ctx.cwd, item.specPath) }))
     },
     text: lines
   };
@@ -37759,7 +37926,7 @@ async function runImpact(ctx) {
 }
 
 // src/commands/link.ts
-import path41 from "path";
+import path42 from "path";
 async function runLink(ctx) {
   const { root } = await requireWorkspace(ctx);
   const action = ctx.positionals[0] ?? "list";
@@ -37771,7 +37938,7 @@ async function runLink(ctx) {
     } else {
       for (const entry of state.entries) {
         const status = entry.available ? `${entry.requirements} requisito(s) \xB7 ${entry.domains.join(", ") || "sin dominios"}` : "NO DISPONIBLE";
-        lines.push(`  ${entry.name}  ${path41.relative(ctx.cwd, entry.path)}  ${status}`);
+        lines.push(`  ${entry.name}  ${path42.relative(ctx.cwd, entry.path)}  ${status}`);
       }
     }
     return {
@@ -37780,7 +37947,7 @@ async function runLink(ctx) {
       data: {
         links: state.entries.map((entry) => ({
           name: entry.name,
-          path: path41.relative(ctx.cwd, entry.path),
+          path: path42.relative(ctx.cwd, entry.path),
           available: entry.available,
           requirements: entry.requirements,
           domains: entry.domains
@@ -37825,12 +37992,12 @@ async function runLink(ctx) {
 }
 
 // src/commands/profile.ts
-import path42 from "path";
+import path43 from "path";
 async function runProfile(ctx) {
   const action = ctx.positionals[0] ?? "detect";
   const { root, workspace } = await requireWorkspace(ctx);
   const officialDir = await resolveProfilesDir();
-  const customDir = path42.join(workspace.sddDir, "profiles", "custom");
+  const customDir = path43.join(workspace.sddDir, "profiles", "custom");
   const profiles = [...officialDir ? await loadProfilesFromDir(officialDir) : [], ...await loadProfilesFromDir(customDir)];
   if (action === "detect") {
     const result = await detectProfiles(root, profiles);
@@ -37859,7 +38026,7 @@ async function runProfile(ctx) {
     if (!name) {
       return { exitCode: 2, diagnostics: [{ code: "ATLAS-PROFILE-001", severity: "error", message: "Falta el nombre del perfil: satlas profile create <nombre>" }] };
     }
-    const file = path42.join(customDir, `${name}.yaml`);
+    const file = path43.join(customDir, `${name}.yaml`);
     if (await exists(file)) {
       return { exitCode: 2, diagnostics: [{ code: "ATLAS-PROFILE-002", severity: "error", message: `El perfil ya existe: ${file}` }] };
     }
@@ -37868,7 +38035,7 @@ async function runProfile(ctx) {
       exitCode: 0,
       diagnostics: [],
       data: { file },
-      text: [`Perfil creado: ${path42.relative(ctx.cwd, file)}`, "", "Ed\xEDtalo con los comandos reales de tu stack (build/lint/test) y tus anti-patrones."]
+      text: [`Perfil creado: ${path43.relative(ctx.cwd, file)}`, "", "Ed\xEDtalo con los comandos reales de tu stack (build/lint/test) y tus anti-patrones."]
     };
   }
   return {
@@ -37877,7 +38044,7 @@ async function runProfile(ctx) {
   };
 }
 async function isInside(dir, name) {
-  return exists(path42.join(dir, `${name}.yaml`));
+  return exists(path43.join(dir, `${name}.yaml`));
 }
 function profileTemplate(name) {
   return `name: ${name}
@@ -37905,7 +38072,7 @@ assumptions: []
 }
 
 // src/commands/doctor.ts
-import path43 from "path";
+import path44 from "path";
 async function runDoctorCommand(ctx) {
   const { root, config } = await requireWorkspace(ctx);
   const report = await runDoctor(root);
@@ -37930,7 +38097,7 @@ async function runDoctorCommand(ctx) {
     lines.push("Sin hallazgos. El workspace est\xE1 sano.");
   } else {
     for (const finding of report.findings) {
-      const location = finding.path ? ` ${path43.relative(ctx.cwd, finding.path)}${finding.line ? `:${finding.line}` : ""}` : "";
+      const location = finding.path ? ` ${path44.relative(ctx.cwd, finding.path)}${finding.line ? `:${finding.line}` : ""}` : "";
       lines.push(`  ${finding.severity.toUpperCase()}  ${finding.code}${location} \u2014 ${finding.message}`);
       if (finding.suggestion) lines.push(`       \u21B3 ${finding.suggestion}`);
     }
@@ -38041,7 +38208,7 @@ async function runHelp(ctx, commandName) {
 }
 
 // src/commands/init.ts
-import path44 from "path";
+import path45 from "path";
 async function runInit(ctx) {
   const languageFlag = flagString(ctx.flags, "language");
   const language = languageFlag === "en" ? "en" : languageFlag === "es" ? "es" : void 0;
@@ -38091,11 +38258,11 @@ async function runInit(ctx) {
   const lines = [msg("init.title", ctx.language), ""];
   if (result.created.length > 0) {
     lines.push(msg("init.done", ctx.language));
-    for (const file of result.created) lines.push(`  + ${path44.relative(ctx.cwd, file)}`);
+    for (const file of result.created) lines.push(`  + ${path45.relative(ctx.cwd, file)}`);
     if (compiled.length > 0) {
       lines.push("");
       lines.push("Adaptadores compilados:");
-      for (const file of compiled) lines.push(`  + ${path44.relative(ctx.cwd, path44.join(ctx.cwd, file))}`);
+      for (const file of compiled) lines.push(`  + ${path45.relative(ctx.cwd, path45.join(ctx.cwd, file))}`);
     }
     lines.push("");
     lines.push("Siguiente: crea un cambio con `satlas new <slug>` y escribe la spec funcional.");
@@ -38105,8 +38272,8 @@ async function runInit(ctx) {
     exitCode: hasErrors2 ? 1 : 0,
     diagnostics: result.diagnostics,
     data: {
-      sddDir: path44.relative(ctx.cwd, result.sddDir),
-      created: result.created.map((f) => path44.relative(ctx.cwd, f)),
+      sddDir: path45.relative(ctx.cwd, result.sddDir),
+      created: result.created.map((f) => path45.relative(ctx.cwd, f)),
       detected: result.detected?.matches.map((m) => ({ name: m.name, score: m.score })),
       best: result.detected?.best?.name
     },
@@ -38147,7 +38314,7 @@ async function runMetrics(ctx) {
 }
 
 // src/commands/mockup.ts
-import path45 from "path";
+import path46 from "path";
 async function runMockup(ctx) {
   const { root, workspace, config } = await requireWorkspace(ctx);
   const slug = ctx.positionals[0];
@@ -38197,17 +38364,17 @@ async function runMockup(ctx) {
     `  pantallas: ${plan.screens.length}`,
     ...plan.screens.map((s) => `    - ${s.id}: ${s.title} (${s.illustrates.length} escenario(s))`),
     "",
-    `  plan: ${path45.relative(ctx.cwd, planFile)}`,
-    `  manifiesto: ${path45.relative(ctx.cwd, manifestFile)}`,
+    `  plan: ${path46.relative(ctx.cwd, planFile)}`,
+    `  manifiesto: ${path46.relative(ctx.cwd, manifestFile)}`,
     "",
     `Siguiente: genera el HTML de cada pantalla (fase ${agentCommand("mockup", slug, config)}) y valida con \`satlas mockup ${slug} --check\`.`
   ];
-  return { exitCode: 0, diagnostics: [], data: { plan, planFile: path45.relative(ctx.cwd, planFile), manifestFile: path45.relative(ctx.cwd, manifestFile) }, text: lines };
+  return { exitCode: 0, diagnostics: [], data: { plan, planFile: path46.relative(ctx.cwd, planFile), manifestFile: path46.relative(ctx.cwd, manifestFile) }, text: lines };
 }
 
 // src/mcp/server.ts
 import { promises as fs3 } from "fs";
-import path50 from "path";
+import path51 from "path";
 import { createInterface } from "readline/promises";
 
 // src/mcp/protocol.ts
@@ -38269,7 +38436,7 @@ function stringArg(args, key) {
 }
 
 // src/mcp/tools/contracts.ts
-import path46 from "path";
+import path47 from "path";
 async function runAtlasContracts(args, host) {
   const resolved = await host.getWorkspace();
   if (!resolved) return noWorkspaceResult();
@@ -38289,7 +38456,7 @@ async function runAtlasContracts(args, host) {
     slug,
     mode,
     contracts: state.files.map((file) => ({
-      path: path46.relative(resolved.root, file.path),
+      path: path47.relative(resolved.root, file.path),
       format: file.format,
       operations: file.operations.map((operation) => operation.id)
     })),
@@ -38325,12 +38492,12 @@ async function runAtlasFixes(_args, host) {
 }
 
 // src/mcp/tools/glossary.ts
-import path47 from "path";
+import path48 from "path";
 async function runAtlasGlossary(_args, host) {
   const resolved = await host.getWorkspace();
   if (!resolved) return noWorkspaceResult();
   const { root, config } = resolved;
-  const glossaryPath = path47.resolve(root, config.spec.glossary);
+  const glossaryPath = path48.resolve(root, config.spec.glossary);
   const raw = await readTextIfExists(glossaryPath);
   if (raw === void 0) {
     return jsonResult({
@@ -38351,7 +38518,7 @@ async function runAtlasGlossary(_args, host) {
 }
 
 // src/mcp/tools/links.ts
-import path48 from "path";
+import path49 from "path";
 async function runAtlasLinks(_args, host) {
   const resolved = await host.getWorkspace();
   if (!resolved) return noWorkspaceResult();
@@ -38362,7 +38529,7 @@ async function runAtlasLinks(_args, host) {
   return jsonResult({
     links: state.entries.map((entry) => ({
       name: entry.name,
-      path: path48.relative(resolved.root, entry.path),
+      path: path49.relative(resolved.root, entry.path),
       available: entry.available,
       requirements: entry.requirements,
       domains: entry.domains
@@ -38399,7 +38566,7 @@ async function runAtlasImpact(args, host) {
 }
 
 // src/evaluate.ts
-import path49 from "path";
+import path50 from "path";
 function livingRequirementsMap2(specs) {
   const map = /* @__PURE__ */ new Map();
   for (const spec of specs) {
@@ -38408,7 +38575,7 @@ function livingRequirementsMap2(specs) {
   return map;
 }
 async function evaluateChange(workspace, config, change, approvals) {
-  const deltaPath = path49.join(change.dir, "spec.md");
+  const deltaPath = path50.join(change.dir, "spec.md");
   const deltaContent = await readTextIfExists(deltaPath);
   const approval = verifyApproval(change, approvals, config, deltaContent ?? void 0);
   const living = livingRequirementsMap2(workspace.specs);
@@ -38704,8 +38871,8 @@ var WorkspaceCache = class {
   }
 };
 async function workspaceStamp(root) {
-  const sddDir = path50.join(root, ".sdd");
-  const markers = [sddDir, path50.join(sddDir, "config.yaml"), path50.join(sddDir, "changes"), path50.join(sddDir, "specs"), path50.join(sddDir, "approvals.yaml")];
+  const sddDir = path51.join(root, ".sdd");
+  const markers = [sddDir, path51.join(sddDir, "config.yaml"), path51.join(sddDir, "changes"), path51.join(sddDir, "specs"), path51.join(sddDir, "approvals.yaml")];
   let stamp2 = 0;
   for (const marker of markers) {
     try {
@@ -38723,7 +38890,7 @@ async function resolveMcpWorkspace(cwd, cache) {
   const cached2 = cache.get(root);
   if (cached2 && cached2.mtimeMs === stamp2) return cached2.value;
   const { workspace, config } = await loadWorkspace(root);
-  const approvals = await loadApprovals(path50.join(root, ".sdd"));
+  const approvals = await loadApprovals(path51.join(root, ".sdd"));
   const value = { root, workspace, config, approvals: approvals.byArtifact };
   cache.set(root, stamp2, value);
   return value;
@@ -38815,7 +38982,7 @@ async function runMcp(ctx) {
 }
 
 // src/commands/packs.ts
-import path51 from "path";
+import path52 from "path";
 async function runPacks(ctx) {
   const { root, config, workspace } = await requireWorkspace(ctx);
   const slug = flagString(ctx.flags, "check");
@@ -38873,14 +39040,14 @@ async function runPacks(ctx) {
     data: {
       slug,
       packs: evaluations.map((evaluation) => ({ id: evaluation.pack.id, status: evaluation.status, passed: evaluation.passed, failed: evaluation.failed, results: evaluation.results })),
-      analyzePath: path51.posix.join(".sdd", "changes", slug, "analyze.md")
+      analyzePath: path52.posix.join(".sdd", "changes", slug, "analyze.md")
     },
     text: lines
   };
 }
 
 // src/commands/pause.ts
-import path52 from "path";
+import path53 from "path";
 async function runPause(ctx) {
   const slug = ctx.positionals[0];
   if (!slug) {
@@ -38910,7 +39077,7 @@ async function runPause(ctx) {
     `  motivo: ${result.paused?.reason ?? ""}`,
     `  por:    ${result.paused?.by ?? ""}`,
     `  fecha:  ${result.paused?.at ?? ""}`,
-    `  estado: ${path52.relative(ctx.cwd, result.path)}`,
+    `  estado: ${path53.relative(ctx.cwd, result.path)}`,
     "",
     `Ret\xF3malo cuando quieras con \`satlas resume ${slug}\`.`
   ];
@@ -38953,7 +39120,7 @@ async function runResume(ctx) {
 }
 
 // src/commands/new.ts
-import path53 from "path";
+import path54 from "path";
 async function runNew(ctx) {
   const slug = ctx.positionals[0];
   if (!slug) {
@@ -38979,14 +39146,14 @@ async function runNew(ctx) {
     msg("new.title", ctx.language),
     "",
     msg("new.done", ctx.language),
-    ...result.files.map((f) => `  + ${path53.relative(ctx.cwd, f)}`),
+    ...result.files.map((f) => `  + ${path54.relative(ctx.cwd, f)}`),
     "",
     `Siguiente: ${agentCommand("specify", result.slug, config)} \u2014 escribe la especificaci\xF3n 100% funcional y de negocio.`
   ];
   return {
     exitCode: hasErrors2 ? 1 : 0,
     diagnostics: result.diagnostics,
-    data: { slug: result.slug, files: result.files.map((f) => path53.relative(ctx.cwd, f)) },
+    data: { slug: result.slug, files: result.files.map((f) => path54.relative(ctx.cwd, f)) },
     text: lines
   };
 }
@@ -39119,7 +39286,7 @@ async function runNext(ctx) {
 }
 
 // src/commands/present.ts
-import path54 from "path";
+import path55 from "path";
 async function runPresentCommand(ctx) {
   const { root } = await requireWorkspace(ctx);
   const slug = ctx.positionals[0];
@@ -39131,7 +39298,7 @@ async function runPresentCommand(ctx) {
   if (result.path) {
     lines.push("Propuesta generada");
     lines.push("");
-    lines.push(`  archivo: ${path54.relative(ctx.cwd, result.path)}`);
+    lines.push(`  archivo: ${path55.relative(ctx.cwd, result.path)}`);
     if (result.hash) lines.push(`  hash de la spec: ${shortHash(result.hash)}`);
     lines.push("");
     lines.push("\xC1brela en el navegador y comp\xE1rtela con el stakeholder.");
@@ -39141,13 +39308,13 @@ async function runPresentCommand(ctx) {
   return {
     exitCode: hasErrors2 ? 1 : 0,
     diagnostics: result.diagnostics,
-    data: result.path ? { path: path54.relative(ctx.cwd, result.path), hash: result.hash } : void 0,
+    data: result.path ? { path: path55.relative(ctx.cwd, result.path), hash: result.hash } : void 0,
     text: lines
   };
 }
 
 // src/commands/review.ts
-import path55 from "path";
+import path56 from "path";
 async function runReview(ctx) {
   const slug = ctx.positionals[0];
   if (!slug) {
@@ -39159,7 +39326,7 @@ async function runReview(ctx) {
     return { exitCode: 2, diagnostics: [{ code: "ATLAS-REVIEW-000", severity: "error", message: `No existe el cambio "${slug}"` }] };
   }
   const mode = config.gates.review.mode;
-  const reviewFile = path55.join(change.dir, "review.md");
+  const reviewFile = path56.join(change.dir, "review.md");
   if (!await exists(reviewFile)) {
     const templates = templatesFor(config.project.language);
     await writeText(reviewFile, renderTemplate(templates.review, { TITLE: change.meta?.title ?? slug, SLUG: slug }));
@@ -39167,7 +39334,7 @@ async function runReview(ctx) {
       "Revisi\xF3n del cambio",
       "",
       `  modo: ${mode}`,
-      `  creado: ${path55.relative(ctx.cwd, reviewFile)}`,
+      `  creado: ${path56.relative(ctx.cwd, reviewFile)}`,
       "",
       `Revisa el c\xF3digo con la fase del agente: ${agentCommand("review", slug, config)}`,
       "Al cerrar, deja `- resultado: pass` en el veredicto y marca los hallazgos resueltos."
@@ -39180,7 +39347,7 @@ async function runReview(ctx) {
   const passed = reviewPassed(review);
   const lines = ["Revisi\xF3n del cambio", ""];
   lines.push(`  modo: ${mode}`);
-  lines.push(`  archivo: ${path55.relative(ctx.cwd, reviewFile)}`);
+  lines.push(`  archivo: ${path56.relative(ctx.cwd, reviewFile)}`);
   lines.push(`  resultado: ${review?.verdict ?? "pendiente"}${review?.by ? ` \xB7 por ${review.by}` : ""}${review?.date ? ` \xB7 ${review.date}` : ""}`);
   lines.push(`  hallazgos: ${review?.findings.length ?? 0} (${open.length} sin resolver, ${blocking.length} bloqueante(s))`);
   if (open.length > 0) {
@@ -39282,6 +39449,124 @@ function usage(usageText) {
   return { exitCode: 2, diagnostics: [{ code: "ATLAS-RUN-000", severity: "error", message: `Uso: ${usageText}` }] };
 }
 
+// src/commands/self-update.ts
+function rutaEjecutable() {
+  return process.argv[1] ?? process.execPath;
+}
+async function instalarUltima(instalacion, cwd) {
+  if (!instalacion.comando) return { ok: false, salida: instalacion.motivo ?? "no se puede actualizar esta instalaci\xF3n" };
+  const resultado = await runProcess(instalacion.comando, { cwd, timeoutMs: 18e4 });
+  return { ok: resultado.ok, salida: `${resultado.stdout}${resultado.stderr}`.trim() };
+}
+async function runSelfUpdate(ctx) {
+  const instalada = cliVersion();
+  const soloConsultar = flagBool(ctx.flags, "check");
+  const auto = flagString(ctx.flags, "auto");
+  if (auto !== void 0) {
+    const valor = auto.toLowerCase();
+    if (valor !== "on" && valor !== "off") {
+      return {
+        exitCode: 2,
+        diagnostics: [{ code: "ATLAS-SELFUPDATE-000", severity: "error", message: "Valor inv\xE1lido para --auto", suggestion: "satlas self-update --auto on | off" }]
+      };
+    }
+    const preferencias2 = await leerPreferencias();
+    const nuevas = { ...preferencias2, automatica: valor === "on" };
+    const file = await escribirPreferencias(nuevas);
+    return {
+      exitCode: 0,
+      diagnostics: [],
+      data: { automatica: nuevas.automatica, archivo: file },
+      text: [
+        "Actualizaci\xF3n desatendida",
+        "",
+        `  ${nuevas.automatica ? "activada: la herramienta se actualizar\xE1 sola al detectar una versi\xF3n nueva" : "desactivada: solo se avisa cuando hay versi\xF3n nueva"}`,
+        `  preferencia: ${file}`
+      ]
+    };
+  }
+  const publicada = await consultarVersionPublicada();
+  const instalacion = detectarInstalacion(rutaEjecutable());
+  const preferencias = await leerPreferencias();
+  if (publicada === void 0) {
+    return {
+      exitCode: 1,
+      diagnostics: [
+        {
+          code: "ATLAS-SELFUPDATE-001",
+          severity: "error",
+          message: "No se pudo consultar la versi\xF3n publicada",
+          suggestion: `Comprueba tu conexi\xF3n o instala a mano: ${instalacion.comando ?? "npm install -g specatlas@latest"}`
+        }
+      ]
+    };
+  }
+  const base = [
+    "Actualizaci\xF3n de SpecAtlas",
+    "",
+    `  instalada: ${instalada}`,
+    `  publicada: ${publicada}`,
+    `  instalada con: ${instalacion.gestor}`,
+    `  desatendida: ${preferencias.automatica ? "activada" : "desactivada"}`
+  ];
+  if (!hayVersionNueva(instalada, publicada)) {
+    return { exitCode: 0, diagnostics: [], data: { instalada, publicada, actualizada: false, alDia: true }, text: [...base, "", "  Ya est\xE1s en la \xFAltima versi\xF3n."] };
+  }
+  if (soloConsultar) {
+    return {
+      exitCode: 0,
+      diagnostics: [],
+      data: { instalada, publicada, actualizada: false, alDia: false, comando: instalacion.comando },
+      text: [...base, "", `  Hay una versi\xF3n nueva. Actualiza con \`satlas self-update\`${instalacion.comando ? ` (o \`${instalacion.comando}\`)` : ""}.`]
+    };
+  }
+  if (!instalacion.comando) {
+    return {
+      exitCode: 0,
+      diagnostics: [{ code: "ATLAS-SELFUPDATE-002", severity: "info", message: instalacion.motivo ?? "esta instalaci\xF3n no se actualiza sola" }],
+      data: { instalada, publicada, actualizada: false, motivo: instalacion.motivo },
+      text: [...base, "", `  ${instalacion.motivo}`]
+    };
+  }
+  const resultado = await instalarUltima(instalacion, ctx.cwd);
+  if (!resultado.ok) {
+    return {
+      exitCode: 1,
+      diagnostics: [
+        {
+          code: "ATLAS-SELFUPDATE-003",
+          severity: "error",
+          message: `No se pudo instalar ${publicada}: ${resultado.salida.split("\n")[0] ?? "el gestor fall\xF3"}`,
+          suggestion: `Ejec\xFAtalo a mano: ${instalacion.comando}`
+        }
+      ],
+      data: { instalada, publicada, actualizada: false, comando: instalacion.comando },
+      text: [...base, "", `  La instalaci\xF3n fall\xF3; sigues con ${instalada}.`]
+    };
+  }
+  return {
+    exitCode: 0,
+    diagnostics: [],
+    data: { instalada, publicada, actualizada: true, comando: instalacion.comando },
+    text: [...base, "", `  Actualizada: ${instalada} \u2192 ${publicada}.`, "  Abre una terminal nueva si el comando sigue apuntando a la versi\xF3n anterior."]
+  };
+}
+async function avisoDeActualizacion(json2, cwd) {
+  try {
+    const aviso = await comprobarActualizacion({ instalada: cliVersion(), rutaEjecutable: rutaEjecutable(), json: json2 });
+    if (!aviso) return [];
+    const preferencias = await leerPreferencias();
+    if (!preferencias.automatica) {
+      return ["", `Hay una versi\xF3n nueva de SpecAtlas: ${aviso.instalada} \u2192 ${aviso.publicada}. Actualiza con \`satlas self-update\`.`];
+    }
+    const instalacion = detectarInstalacion(rutaEjecutable());
+    const resultado = await instalarUltima(instalacion, cwd);
+    return resultado.ok ? ["", `SpecAtlas se actualiz\xF3 solo: ${aviso.instalada} \u2192 ${aviso.publicada}.`] : ["", `Hay una versi\xF3n nueva (${aviso.publicada}) y la actualizaci\xF3n autom\xE1tica fall\xF3. Ejecuta \`${aviso.comando}\`.`];
+  } catch {
+    return [];
+  }
+}
+
 // src/commands/status.ts
 async function runStatus(ctx) {
   const { root, workspace, config, approvals } = await requireWorkspace(ctx);
@@ -39356,7 +39641,7 @@ async function runStatus(ctx) {
 }
 
 // src/commands/trace.ts
-import path56 from "path";
+import path57 from "path";
 async function runTrace(ctx) {
   const { workspace, config } = await requireWorkspace(ctx);
   const slug = flagString(ctx.flags, "change");
@@ -39376,7 +39661,7 @@ async function runTrace(ctx) {
     data.push({ slug: change.slug, nodes: result.graph.nodes.length, edges: result.graph.edges.length, summary: result.summary, findings: result.findings });
     lines.push(`  ${change.slug}: ${result.graph.nodes.length} nodos, ${result.graph.edges.length} aristas, ${errors} errores, ${result.summary.warnings} avisos`);
     for (const finding of result.findings) {
-      const location = finding.path ? ` (${path56.relative(ctx.cwd, finding.path)}${finding.line ? `:${finding.line}` : ""})` : "";
+      const location = finding.path ? ` (${path57.relative(ctx.cwd, finding.path)}${finding.line ? `:${finding.line}` : ""})` : "";
       lines.push(`    ${finding.severity.toUpperCase()} ${finding.code} \u2014 ${finding.message}${location}`);
     }
   }
@@ -39386,7 +39671,7 @@ async function runTrace(ctx) {
 }
 
 // src/commands/upgrade.ts
-import path57 from "path";
+import path58 from "path";
 async function runUpgrade(ctx) {
   const { root } = await requireWorkspace(ctx);
   const apply2 = flagBool(ctx.flags, "apply");
@@ -39440,7 +39725,7 @@ function renderPreview(plan, root, ctx) {
   }
   for (const item of plan.unreadable) {
     lines.push(`  Ilegible: "${item.artifact}" \u2014 ${item.reason}`);
-    lines.push(`    \u21B3 ${path57.relative(ctx.cwd, item.path)}`);
+    lines.push(`    \u21B3 ${path58.relative(ctx.cwd, item.path)}`);
   }
   return { exitCode: 0, diagnostics: [], data: summarizable(plan), text: lines };
 }
@@ -39503,7 +39788,7 @@ function renderRollback(report, ctx) {
 }
 
 // src/commands/validate.ts
-import path58 from "path";
+import path59 from "path";
 async function runValidate(ctx) {
   const { root, workspace, config, approvals } = await requireWorkspace(ctx);
   const slug = flagString(ctx.flags, "change");
@@ -39530,7 +39815,7 @@ async function runValidate(ctx) {
     for (const finding of evaluation.lintFindings) {
       lines.push(`    ${finding.severity.toUpperCase()} ${finding.code}${finding.line ? `:${finding.line}` : ""} \u2014 ${finding.message}`);
     }
-    lines.push(`    archivo: ${path58.relative(ctx.cwd, path58.join(change.dir, "spec.md"))}`);
+    lines.push(`    archivo: ${path59.relative(ctx.cwd, path59.join(change.dir, "spec.md"))}`);
   }
   if (targets.length === 0) lines.push("Sin cambios activos.");
   if (advisory && advisory.plan.pending.length > 0) {
@@ -39558,7 +39843,7 @@ async function runValidate(ctx) {
 }
 
 // src/commands/verify.ts
-import path59 from "path";
+import path60 from "path";
 async function runVerify(ctx) {
   const { root, workspace, config } = await requireWorkspace(ctx);
   const slug = ctx.positionals[0];
@@ -39601,7 +39886,7 @@ async function runVerify(ctx) {
     return { exitCode: 2, diagnostics: [{ code: "ATLAS-VERIFY-001", severity: "error", message: "Falta --by <nombre> (o define meta.owner)" }] };
   }
   const profilesDir = await resolveProfilesDir();
-  const profile = await loadActiveProfile(path59.join(root, ".sdd"), [profilesDir ?? "", path59.join(root, ".sdd", "profiles", "custom")].filter(Boolean));
+  const profile = await loadActiveProfile(path60.join(root, ".sdd"), [profilesDir ?? "", path60.join(root, ".sdd", "profiles", "custom")].filter(Boolean));
   const record = await recordEvidence({
     root,
     slug,
@@ -39623,7 +39908,7 @@ async function runVerify(ctx) {
     if (record.evidence.command) lines.push(`  comando: ${record.evidence.command}`);
     lines.push(`  resultado: ${record.evidence.result}`);
     if (record.evidence.outputHash) lines.push(`  hash:    ${record.evidence.outputHash}`);
-    lines.push(`  archivo: ${path59.relative(ctx.cwd, record.path)}`);
+    lines.push(`  archivo: ${path60.relative(ctx.cwd, record.path)}`);
     if (record.stdout) {
       lines.push("");
       lines.push("  salida (\xFAltimas l\xEDneas):");
@@ -39651,14 +39936,14 @@ async function runVerify(ctx) {
   return {
     exitCode: record.exitCode === 0 ? 0 : 1,
     diagnostics: [...record.diagnostics, ...mockupDiagnostics],
-    data: { evidence: record.evidence, path: path59.relative(ctx.cwd, record.path), exitCode: record.exitCode },
+    data: { evidence: record.evidence, path: path60.relative(ctx.cwd, record.path), exitCode: record.exitCode },
     text: lines
   };
 }
 
 // src/commands/watch.ts
 import { watch } from "fs";
-import path60 from "path";
+import path61 from "path";
 var DEBOUNCE_MS = 250;
 function stamp(now) {
   return now.toTimeString().slice(0, 8);
@@ -39672,7 +39957,7 @@ async function runWatch(ctx) {
       diagnostics: [{ code: "ATLAS-WATCH-001", severity: "error", message: "`satlas watch` es interactivo y no admite --json", suggestion: "Usa `satlas ci --json` en una tuber\xEDa" }]
     };
   }
-  const sddDir = path60.join(root, ".sdd");
+  const sddDir = path61.join(root, ".sdd");
   const write = (line) => {
     process.stdout.write(`${line}
 `);
@@ -39690,7 +39975,7 @@ async function runWatch(ctx) {
     } else {
       write(`  ${counts.errors} errores, ${counts.warnings} avisos`);
       for (const finding of findings.slice(0, 8)) {
-        const where = finding.path ? ` ${path60.relative(root, finding.path)}${finding.line ? `:${finding.line}` : ""}` : "";
+        const where = finding.path ? ` ${path61.relative(root, finding.path)}${finding.line ? `:${finding.line}` : ""}` : "";
         write(`  ${finding.severity === "error" ? "ERROR" : "AVISO"} ${finding.code}${where} \u2014 ${finding.message}`);
       }
       if (findings.length > 8) write(`  \u2026 y ${findings.length - 8} m\xE1s (satlas validate)`);
@@ -39701,7 +39986,7 @@ async function runWatch(ctx) {
     }
     if (changes.length === 0) write("  sin cambios activos");
   };
-  write(`Vigilando ${path60.relative(ctx.cwd, sddDir) || ".sdd"} \u2014 Ctrl+C para salir`);
+  write(`Vigilando ${path61.relative(ctx.cwd, sddDir) || ".sdd"} \u2014 Ctrl+C para salir`);
   await pass();
   await new Promise((resolve) => {
     let timer;
@@ -39805,6 +40090,7 @@ var HANDLERS2 = {
   pause: runPause,
   resume: runResume,
   archive: runArchive,
+  "self-update": runSelfUpdate,
   version: async () => ({ exitCode: 0, data: { version: cliVersion() }, diagnostics: [], text: [`specatlas ${cliVersion()}`] }),
   help: (ctx) => runHelp(ctx)
 };
@@ -39834,7 +40120,7 @@ async function requireWorkspace(ctx) {
     throw new CliError("ATLAS-WS-001", msg("cli.noWorkspace", ctx.language), 2);
   }
   const { workspace, config } = await loadWorkspace(root);
-  const approvals = await loadApprovals(path61.join(root, ".sdd"));
+  const approvals = await loadApprovals(path62.join(root, ".sdd"));
   return { root, workspace, config, approvals: approvals.byArtifact };
 }
 var CliError = class extends Error {
@@ -39885,6 +40171,11 @@ async function main(argv) {
   try {
     const result = await command.handler(ctx);
     printResult(parsed.command, result, json2, ctx.language);
+    if (parsed.command !== "self-update" && parsed.command !== "mcp") {
+      const aviso = await avisoDeActualizacion(json2, ctx.cwd);
+      if (aviso.length > 0) process.stdout.write(`${aviso.join("\n")}
+`);
+    }
     return result.exitCode;
   } catch (err) {
     if (err instanceof CliError) {
@@ -39903,7 +40194,7 @@ function printResult(command, result, json2, language) {
   }
   const lines = [...result.text ?? []];
   for (const d of result.diagnostics) {
-    const location = d.path ? ` ${path61.relative(process.cwd(), d.path)}${d.line ? `:${d.line}` : ""}` : "";
+    const location = d.path ? ` ${path62.relative(process.cwd(), d.path)}${d.line ? `:${d.line}` : ""}` : "";
     lines.push(`${d.severity === "error" ? "ERROR" : d.severity === "warning" ? "AVISO" : "NOTA"}  ${d.code}${location} \u2014 ${d.message}`);
     if (d.suggestion) lines.push(`       \u21B3 ${d.suggestion}`);
   }