pumuki 6.3.318 → 6.3.320

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki",
-  "version": "6.3.318",
+  "version": "6.3.320",
   "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/framework-menu-system-notifications-macos-dialog-payload.ts

@@ -216,6 +216,37 @@ const isSkillCause = (
   (cause.ruleId ?? '').startsWith('skills.') ||
   cause.code.startsWith('SKILLS_');
 
+const isSkillsContractCause = (
+  cause: NonNullable<Extract<PumukiCriticalNotificationEvent, { kind: 'gate.blocked' }>['blockingCauses']>[number]
+): boolean => {
+  const searchable = `${cause.code} ${cause.ruleId ?? ''} ${cause.message}`.toUpperCase();
+  return (
+    searchable.includes('EVIDENCE_PLATFORM_CRITICAL_SKILLS_RULES_MISSING') ||
+    searchable.includes('EVIDENCE_SKILLS_CONTRACT_INCOMPLETE')
+  );
+};
+
+const formatPlatformName = (platform: string | null): string =>
+  platform
+    ? platform
+      .replace(/\bios\b/giu, 'iOS')
+      .replace(/\bandroid\b/giu, 'Android')
+      .replace(/\bfrontend\b/giu, 'Frontend')
+      .replace(/\bbackend\b/giu, 'Backend')
+    : 'plataforma detectada';
+
+const extractSkillsContractPlatform = (message: string): string | null =>
+  message.match(/\bplatforms?=([a-z0-9_,.-]+)/i)?.[1]?.split(',')[0]?.trim() ?? null;
+
+const extractSkillsContractRules = (message: string): string | null => {
+  const rulesMatch = message.match(/\brules?=\{([^}]+)\}/i)?.[1];
+  const missingMatch = message.match(/\bmissing=\[([^\]]+)\]/i)?.[1];
+  return normalizeNotificationText(rulesMatch ?? missingMatch ?? '');
+};
+
+const SKILLS_CONTRACT_REMEDIATION =
+  'Actualiza o reconcilia el contrato de skills de Pumuki y vuelve a intentar el commit. Si estás en un repo consumidor, repinea Pumuki a una versión que incluya esa regla crítica.';
+
 const WORKTREE_HYGIENE_REMEDIATION =
   'Reduce el worktree pendiente a un slice atómico: stagea solo la tarea activa o guarda el resto en stash nombrado, y reejecuta PRE_WRITE.';
 
@@ -301,6 +332,16 @@ const formatBlockingCauseForDialog = (
       '   Solución: Crea ese .feature con el escenario de aceptación de la slice, o corrige la referencia si el id de tarea no es correcto.',
     ];
   }
+  if (isSkillsContractCause(cause)) {
+    const platform = formatPlatformName(extractSkillsContractPlatform(cause.message));
+    const rules = extractSkillsContractRules(cause.message);
+    return [
+      `${index + 1}. Causa bloqueante: contrato de skills incompleto`,
+      `   Plataforma: ${platform}`,
+      `   Falla: Pumuki detecta ${platform}, pero falta activar enforcement de skills críticas${rules ? `: ${rules}` : ''}.`,
+      `   Solución: ${SKILLS_CONTRACT_REMEDIATION}`,
+    ];
+  }
 
   const causeLabel = isSkillCause(cause) ? 'Regla' : 'Causa bloqueante';
   return [
@@ -327,6 +368,11 @@ const hasOnlyBddScenarioMissingCauses = (
 ): boolean =>
   Boolean(causes?.length) && causes!.every(isBddScenarioMissingCause);
 
+const hasOnlySkillsContractCauses = (
+  causes: Extract<PumukiCriticalNotificationEvent, { kind: 'gate.blocked' }>['blockingCauses']
+): boolean =>
+  Boolean(causes?.length) && causes!.every(isSkillsContractCause);
+
 const resolveGoldenFlowDialogRemediation = (
   causes: Extract<PumukiCriticalNotificationEvent, { kind: 'gate.blocked' }>['blockingCauses']
 ): string => {
@@ -348,6 +394,8 @@ export const buildBlockedDialogPayload = (params: {
     ? resolveGoldenFlowDialogRemediation(params.event.blockingCauses)
     : hasOnlyBddScenarioMissingCauses(params.event.blockingCauses)
     ? 'Crea el fichero .feature esperado para la slice activa o corrige la referencia de tarea. Después vuelve a intentar el commit.'
+    : hasOnlySkillsContractCauses(params.event.blockingCauses)
+    ? SKILLS_CONTRACT_REMEDIATION
     : params.event.blockingCauses && params.event.blockingCauses.length > 0
     ? 'Corrige las violaciones listadas y vuelve a intentar el commit.'
     : resolveBlockedRemediation(params.event, causeCode);

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

@@ -47,6 +47,35 @@ const isBddScenarioMissingCause = (cause: BlockedCause): boolean => {
   );
 };
 
+const isSkillsContractCause = (cause: BlockedCause): boolean => {
+  const searchable = `${cause.code} ${cause.ruleId ?? ''} ${cause.message}`.toUpperCase();
+  return (
+    searchable.includes('EVIDENCE_PLATFORM_CRITICAL_SKILLS_RULES_MISSING') ||
+    searchable.includes('EVIDENCE_SKILLS_CONTRACT_INCOMPLETE')
+  );
+};
+
+const formatPlatformName = (platform: string | null): string =>
+  platform
+    ? platform
+      .replace(/\bios\b/giu, 'iOS')
+      .replace(/\bandroid\b/giu, 'Android')
+      .replace(/\bfrontend\b/giu, 'Frontend')
+      .replace(/\bbackend\b/giu, 'Backend')
+    : 'plataforma detectada';
+
+const extractSkillsContractPlatform = (message: string): string | null =>
+  message.match(/\bplatforms?=([a-z0-9_,.-]+)/i)?.[1]?.split(',')[0]?.trim() ?? null;
+
+const extractSkillsContractRules = (message: string): string | null => {
+  const rulesMatch = message.match(/\brules?=\{([^}]+)\}/i)?.[1];
+  const missingMatch = message.match(/\bmissing=\[([^\]]+)\]/i)?.[1];
+  return normalizeNotificationText(rulesMatch ?? missingMatch ?? '');
+};
+
+const SKILLS_CONTRACT_REMEDIATION =
+  'Actualiza o reconcilia el contrato de skills de Pumuki y vuelve a intentar el commit. Si estás en un repo consumidor, repinea Pumuki a una versión que incluya esa regla crítica.';
+
 const extractExpectedBddFeatureFile = (cause: BlockedCause): string => {
   const directFile = cause.file?.endsWith('.feature') ? cause.file : null;
   const fieldMatch = cause.message.match(/\bfile=([^\s]+\.feature)\b/i)?.[1];
@@ -187,6 +216,11 @@ export const resolvePrioritizedBlockingCauses = (
     if (leftBddScenarioMissing !== rightBddScenarioMissing) {
       return leftBddScenarioMissing ? -1 : 1;
     }
+    const leftSkillsContract = isSkillsContractCause(left);
+    const rightSkillsContract = isSkillsContractCause(right);
+    if (leftSkillsContract !== rightSkillsContract) {
+      return leftSkillsContract ? -1 : 1;
+    }
     return 0;
   });
 };
@@ -213,6 +247,10 @@ const buildBlockingCausesSummary = (
   if (isBddScenarioMissingCause(first)) {
     return `BDD sin fichero .feature: ${extractExpectedBddFeatureFile(first)}${overflow}`;
   }
+  if (isSkillsContractCause(first)) {
+    const platform = formatPlatformName(extractSkillsContractPlatform(first.message));
+    return `Contrato de skills incompleto: ${platform}${overflow}`;
+  }
   return `${prefix}: ${formatCauseRule(first)} · ${formatCauseLocation(first)}${overflow}`;
 };
 
@@ -244,6 +282,11 @@ const buildBlockingCausesRemediation = (
   if (isBddScenarioMissingCause(first)) {
     return `Falta el fichero ${extractExpectedBddFeatureFile(first)}. Crea ese .feature con el escenario de aceptación de la slice, o corrige la referencia de tarea si no corresponde.`;
   }
+  if (isSkillsContractCause(first)) {
+    const platform = formatPlatformName(extractSkillsContractPlatform(first.message));
+    const rules = extractSkillsContractRules(first.message);
+    return `Pumuki detecta ${platform}, pero falta activar enforcement de skills críticas${rules ? `: ${rules}` : ''}. ${SKILLS_CONTRACT_REMEDIATION}`;
+  }
   return `${formatCauseFix(first)} Revisa el reporte completo para el resto de causas bloqueantes.`;
 };
 

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

@@ -22,7 +22,7 @@ const BLOCKED_REMEDIATION_BY_CODE: Readonly<Record<string, string>> = {
   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 cambio activo: `pumuki sdd session --open --change=<id>`. Sustituye <id> por la carpeta en openspec/changes. Después vuelve a intentar el commit; Pumuki ejecutará PRE_WRITE automáticamente.',
+    'Abre `openspec/changes/` y copia la carpeta de tu tarea, por ejemplo `rgo-1900-35`. Ejecuta `pumuki sdd session --open --change=<id>` usando ese nombre. Después vuelve a intentar el commit; PRE_WRITE automáticamente.',
   SDD_SESSION_INVALID:
     'Refresca la sesión SDD activa: `pumuki sdd session --refresh --ttl-minutes=90`. Después vuelve a intentar el commit; Pumuki ejecutará PRE_WRITE automáticamente.',
   OPENSPEC_MISSING: 'Instala OpenSpec en este repositorio y vuelve a validar el gate.',