pumuki 6.3.79 → 6.3.80

package/VERSION

@@ -1 +1 @@
-v6.3.79
+v6.3.80

package/docs/operations/RELEASE_NOTES.md

@@ -6,11 +6,11 @@ This file keeps only the operational highlights and rollout notes that matter wh
 
 ## 2026-04 (CLI stability and macOS notifications)
 
-### 2026-04-16 (v6.3.79)
+### 2026-04-17 (v6.3.80)
 
-- **Fix RuralGo (`PUMUKI-INC-078`)**: el parser de tracking canónico reconoce ya boards tabulares con la `🚧` en la primera columna, evitando falsos positivos `TRACKING_CANONICAL_IN_PROGRESS_INVALID` en `status` / `doctor`.
-- **Convergencia con guardrails del consumer**: `captureRepoState` y la consola de governance quedan alineados con el shape real de `docs/RURALGO_SEGUIMIENTO.md`, sin exigir reestructurar el tablero del repo consumidor.
-- **Rollout recomendado**: publicar `pumuki@6.3.79` y revalidar primero RuralGo (`pumuki status`, `pumuki doctor`) antes de extender el repin a otros consumers si aplica.
+- **Tracking canónico**: la línea viva acepta el formato contractual `[🚧] - tarea` en el plan maestro y en tablas con backticks, tanto en el parser de tracking como en el guardrail shell de una sola task activa.
+- **Notificaciones bloqueantes**: copy y remediaciones de `gate.blocked` salen en español cuando el payload legacy llega en inglés; el banner macOS corta por palabra y conserva una solución breve y accionable.
+- **Rollout recomendado**: publicar `pumuki@6.3.80` y repin ordenado `RuralGo -> SAAS -> Flux`, revalidando después `pumuki status`, `pumuki doctor` y hooks Git en cada consumer.
 
 ### 2026-04-16 (v6.3.78)
 

package/integrations/evidence/trackingContract.ts

@@ -15,8 +15,10 @@ const TRACKING_PRIORITY_SOURCE = new Set(['AGENTS.md']);
 const IN_PROGRESS_PATTERNS = [
   /^- Estado:\s*🚧/m,
   /^- 🚧 (\`?P[0-9A-Za-z.-]+\`?)/m,
+  /^\`?\[\s*🚧\s*\]\s*-\`?/m,
   /^\|\s*🚧(?:\s|\|)/m,
   /^\|[^|\n]+\|\s*🚧(?:\s|\|)/m,
+  /^\|[^|\n]+\|\s*\`?\[\s*🚧\s*\]\s*-\`?/m,
 ] as const;
 
 const toRepoRelativePath = (repoRoot: string, absolutePath: string): string => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki",
-  "version": "6.3.79",
+  "version": "6.3.80",
   "description": "Enterprise-grade AST Intelligence System with multi-platform support (iOS, Android, Backend, Frontend) and Feature-First + DDD + Clean Architecture enforcement. Includes dynamic violations API for intelligent querying.",
   "main": "index.js",
   "bin": {

package/scripts/check-tracking-single-active.sh

@@ -31,7 +31,7 @@ for FILE in "${FILES[@]}"; do
   fi
 
   if [[ "${FILE}" == "PUMUKI-RESET-MASTER-PLAN.md" ]]; then
-    ACTIVE_PATTERN='^- Estado: 🚧'
+    ACTIVE_PATTERN='(^- Estado:\s*🚧\b)|(^`?\[\s*🚧\s*\]\s*-`?)|(^\|\s*[^|]+\|\s*`?\[\s*🚧\s*\]\s*-`?)'
   else
     ACTIVE_PATTERN='^- 🚧 (`?P[0-9A-Za-z.-]+`?)'
   fi

package/scripts/framework-menu-system-notifications-cause.ts

@@ -18,6 +18,8 @@ const BLOCKED_CAUSE_SUMMARY_BY_CODE: Readonly<Record<string, string>> = {
   OPENSPEC_MISSING: 'OpenSpec no está instalado en este repositorio.',
   MCP_ENTERPRISE_RECEIPT_MISSING: 'Falta el recibo enterprise de MCP.',
   BACKEND_AVOID_EXPLICIT_ANY: 'Se detectó uso de "any" explícito en backend.',
+  GIT_ATOMICITY_TOO_MANY_SCOPES: 'Se han cambiado demasiados scopes en el mismo commit.',
+  SOLID_HEURISTIC: 'Se detectó una violación estructural en el cambio actual.',
 };
 
 const toKnownSpanishCauseFromMessage = (message: string): string | null => {
@@ -31,6 +33,12 @@ const toKnownSpanishCauseFromMessage = (message: string): string | null => {
   if (normalized.includes('no upstream tracking reference')) {
     return BLOCKED_CAUSE_SUMMARY_BY_CODE.PRE_PUSH_UPSTREAM_MISSING;
   }
+  if (normalized.includes('too many scopes changed') || normalized.includes('atomicity budget exceeded')) {
+    return BLOCKED_CAUSE_SUMMARY_BY_CODE.GIT_ATOMICITY_TOO_MANY_SCOPES;
+  }
+  if (normalized.includes('heuristic violation')) {
+    return BLOCKED_CAUSE_SUMMARY_BY_CODE.SOLID_HEURISTIC;
+  }
   return null;
 };
 

package/scripts/framework-menu-system-notifications-payloads-blocked.ts

@@ -22,7 +22,7 @@ export const buildGateBlockedPayload = (
     resolveBlockedCauseSummary(event, causeCode),
     72
   );
-  const remediation = resolveBlockedRemediation(event, causeCode);
+  const remediation = resolveBlockedRemediation(event, causeCode, { variant: 'banner' });
   return {
     title: '🔴 Pumuki bloqueado',
     subtitle: `${projectPrefix}${event.stage} · ${causeSummary}`,

package/scripts/framework-menu-system-notifications-remediation.ts

@@ -4,55 +4,101 @@ import {
   truncateNotificationText,
 } from './framework-menu-system-notifications-text';
 
+type BlockedRemediationVariant = 'banner' | 'dialog';
+
 const BLOCKED_REMEDIATION_BY_CODE: Readonly<Record<string, string>> = {
-  EVIDENCE_MISSING: 'Genera evidencia del slice actual y vuelve a validar el gate de esta fase.',
-  EVIDENCE_INVALID: 'Regenera la evidencia de la iteración y repite la validación en el mismo stage.',
+  EVIDENCE_MISSING: 'Genera la evidencia del slice actual y vuelve a validar esta fase.',
+  EVIDENCE_INVALID: 'Regenera la evidencia de esta iteración y repite la validación.',
   EVIDENCE_CHAIN_INVALID: 'Regenera la evidencia para restaurar la cadena de integridad y vuelve a validar.',
-  EVIDENCE_STALE: 'Ejecuta una auditoría completa de evidencia y vuelve a validar PRE_WRITE/PRE_PUSH. Si persiste, refresca la sesión SDD y reintenta.',
-  EVIDENCE_BRANCH_MISMATCH: 'Regenera evidencia en esta rama y vuelve a ejecutar la validación para sincronizar branch y snapshot.',
-  EVIDENCE_REPO_ROOT_MISMATCH: 'Regenera evidencia desde este repositorio y relanza la validación del gate.',
-  PRE_PUSH_UPSTREAM_MISSING: 'Configura upstream con `git push --set-upstream origin <branch>` y vuelve a ejecutar PRE_PUSH.',
-  SDD_SESSION_MISSING: 'Abre sesión SDD del change activo y repite la validación de la fase actual.',
-  SDD_SESSION_INVALID: 'Refresca la sesión SDD (open/refresh) y vuelve a validar en el mismo stage.',
-  OPENSPEC_MISSING: 'Instala OpenSpec en el repositorio y relanza la validación del gate.',
-  MCP_ENTERPRISE_RECEIPT_MISSING: 'Genera el receipt enterprise de MCP y vuelve a ejecutar la validación.',
-  BACKEND_AVOID_EXPLICIT_ANY: 'Reemplaza `any` por tipos concretos en backend y vuelve a lanzar el gate para confirmar el fix.',
+  EVIDENCE_STALE: 'Refresca la evidencia y vuelve a validar PRE_WRITE/PRE_PUSH.',
+  EVIDENCE_BRANCH_MISMATCH: 'Regenera la evidencia en esta rama y repite la validación.',
+  EVIDENCE_REPO_ROOT_MISMATCH: 'Regenera la evidencia desde este repositorio y vuelve a validar.',
+  PRE_PUSH_UPSTREAM_MISSING: 'Configura upstream con `git push --set-upstream origin <branch>` y repite PRE_PUSH.',
+  SDD_SESSION_MISSING: 'Abre la sesión SDD del change activo y repite la validación.',
+  SDD_SESSION_INVALID: 'Refresca la sesión SDD activa y vuelve a validar esta fase.',
+  OPENSPEC_MISSING: 'Instala OpenSpec en este repositorio y vuelve a validar el gate.',
+  MCP_ENTERPRISE_RECEIPT_MISSING: 'Genera el receipt enterprise de MCP y vuelve a validar.',
+  BACKEND_AVOID_EXPLICIT_ANY: 'Sustituye `any` por tipos concretos en backend y relanza el gate.',
+  GIT_ATOMICITY_TOO_MANY_SCOPES: 'Divide el cambio por scope o en commits más pequeños y vuelve a ejecutar el gate.',
+  SOLID_HEURISTIC: 'Corrige la violación detectada y vuelve a ejecutar el gate.',
+};
+
+const BLOCKED_REMEDIATION_MAX_LENGTH_BY_VARIANT: Readonly<Record<BlockedRemediationVariant, number>> = {
+  banner: 120,
+  dialog: 220,
 };
 
-const BLOCKED_REMEDIATION_MAX_LENGTH = 220;
+const GENERIC_BLOCKED_REMEDIATION =
+  'Corrige el bloqueo indicado y vuelve a ejecutar el comando.';
+
+const normalizeBlockedRemediation = (value: string): string =>
+  normalizeNotificationText(value)
+    .replace(/^cómo solucionarlo:\s*/i, '')
+    .replace(/^remediation:\s*/i, '')
+    .replace(/^solution:\s*/i, '')
+    .replace(/^fix:\s*/i, '');
+
+const resolveFallbackRemediation = (causeCode: string): string =>
+  BLOCKED_REMEDIATION_BY_CODE[causeCode] ?? GENERIC_BLOCKED_REMEDIATION;
+
+const hasEnglishHints = (message: string): boolean => {
+  const normalized = message.toLowerCase();
+  return [
+    'avoid explicit any',
+    'set-upstream',
+    'refresh evidence',
+    'fix and retry',
+    'split the change',
+    'smaller commits',
+    're-run',
+    'rerun',
+    'retry',
+    'to continue',
+    'run ',
+  ].some((hint) => normalized.includes(hint));
+};
 
-const toKnownSpanishRemediationFromMessage = (message: string): string | null => {
+const toKnownSpanishRemediationFromMessage = (message: string, causeCode: string): string | null => {
   const normalized = message.toLowerCase();
   if (normalized.includes('avoid explicit any')) {
     return BLOCKED_REMEDIATION_BY_CODE.BACKEND_AVOID_EXPLICIT_ANY;
   }
-  if (normalized.includes('set-upstream')) {
+  if (normalized.includes('set-upstream') || normalized.includes('no upstream tracking reference')) {
     return BLOCKED_REMEDIATION_BY_CODE.PRE_PUSH_UPSTREAM_MISSING;
   }
-  if (normalized.includes('refresh evidence')) {
+  if (normalized.includes('refresh evidence') || normalized.includes('evidence is stale')) {
     return BLOCKED_REMEDIATION_BY_CODE.EVIDENCE_STALE;
   }
+  if (normalized.includes('split the change')) {
+    return BLOCKED_REMEDIATION_BY_CODE.GIT_ATOMICITY_TOO_MANY_SCOPES;
+  }
+  if (normalized.includes('fix and retry') || normalized.includes('retry')) {
+    return resolveFallbackRemediation(causeCode);
+  }
   return null;
 };
 
 export const resolveBlockedRemediation = (
   event: Extract<PumukiCriticalNotificationEvent, { kind: 'gate.blocked' }>,
-  causeCode: string
+  causeCode: string,
+  options?: {
+    variant?: BlockedRemediationVariant;
+  }
 ): string => {
+  const variant = options?.variant ?? 'dialog';
+  const maxLength = BLOCKED_REMEDIATION_MAX_LENGTH_BY_VARIANT[variant];
   const fromEvent = event.remediation
-    ? normalizeNotificationText(event.remediation)
-        .replace(/^cómo solucionarlo:\s*/i, '')
-        .replace(/^remediation:\s*/i, '')
+    ? normalizeBlockedRemediation(event.remediation)
     : '';
   if (fromEvent.length > 0) {
-    const translated = toKnownSpanishRemediationFromMessage(fromEvent);
+    const translated = toKnownSpanishRemediationFromMessage(fromEvent, causeCode);
     if (translated) {
-      return truncateNotificationText(translated, BLOCKED_REMEDIATION_MAX_LENGTH);
+      return truncateNotificationText(translated, maxLength);
+    }
+    if (hasEnglishHints(fromEvent)) {
+      return truncateNotificationText(resolveFallbackRemediation(causeCode), maxLength);
     }
-    return truncateNotificationText(fromEvent, BLOCKED_REMEDIATION_MAX_LENGTH);
+    return truncateNotificationText(fromEvent, maxLength);
   }
-  const fallback =
-    BLOCKED_REMEDIATION_BY_CODE[causeCode]
-    ?? 'Corrige el bloqueo indicado y vuelve a ejecutar el comando.';
-  return truncateNotificationText(fallback, BLOCKED_REMEDIATION_MAX_LENGTH);
+  return truncateNotificationText(resolveFallbackRemediation(causeCode), maxLength);
 };

package/scripts/framework-menu-system-notifications-text.ts

@@ -7,7 +7,13 @@ export const truncateNotificationText = (value: string, maxLength: number): stri
   if (value.length <= maxLength) {
     return value;
   }
-  return `${value.slice(0, Math.max(1, maxLength - 1)).trimEnd()}…`;
+  const limit = Math.max(1, maxLength - 1);
+  const trimmed = value.slice(0, limit).trimEnd();
+  const boundary = trimmed.lastIndexOf(' ');
+  const shortened = boundary >= Math.floor(limit * 0.6)
+    ? trimmed.slice(0, boundary).trimEnd()
+    : trimmed;
+  return `${shortened}…`;
 };
 
 export const resolveProjectLabel = (params: {