pumuki 6.3.307 → 6.3.309

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

@@ -20,8 +20,10 @@ const BLOCKED_REMEDIATION_BY_CODE: Readonly<Record<string, string>> = {
   EVIDENCE_BRANCH_MISMATCH: 'La evidencia no corresponde a esta rama. Regenera el receipt/evidencia y vuelve a validar.',
   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.',
+  SDD_SESSION_MISSING:
+    'Abre una sesión SDD válida para el change activo (`pumuki sdd session --open --change=<id>`) y reejecuta PRE_WRITE. Agente IA: STOP hasta que exista esa sesión.',
+  SDD_SESSION_INVALID:
+    'Refresca la sesión SDD activa (`pumuki sdd session --refresh --ttl-minutes=90`) y reejecuta PRE_WRITE. Agente IA: STOP hasta que sea válida.',
   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.',
@@ -31,6 +33,10 @@ const BLOCKED_REMEDIATION_BY_CODE: Readonly<Record<string, string>> = {
   TRACKING_CANONICAL_SOURCE_CONFLICT: TRACKING_BLOCKED_REMEDIATION,
   ACTIVE_RULE_IDS_EMPTY_FOR_CODE_CHANGES_HIGH:
     'Ejecuta `pumuki policy reconcile --strict --json` y revalida antes de continuar.',
+  EVIDENCE_PREWRITE_WORKTREE_WARN:
+    'Reduce el worktree pendiente a un slice atómico antes del commit: stagea solo la tarea activa o guarda el resto en stash nombrado, y reejecuta PRE_WRITE.',
+  EVIDENCE_PREWRITE_WORKTREE_OVER_LIMIT:
+    'El worktree supera el límite permitido: divide cambios por scope en commits atómicos o stashes nombrados antes de continuar.',
 };
 
 const BLOCKED_REMEDIATION_MAX_LENGTH_BY_VARIANT: Readonly<Record<BlockedRemediationVariant, number>> = {
@@ -54,6 +60,81 @@ const normalizeBlockedRemediation = (value: string): string =>
 const resolveFallbackRemediation = (causeCode: string): string =>
   BLOCKED_REMEDIATION_BY_CODE[causeCode] ?? GENERIC_BLOCKED_REMEDIATION;
 
+const resolveSddSessionCauseCode = (
+  event: Extract<PumukiCriticalNotificationEvent, { kind: 'gate.blocked' }>,
+  causeCode: string
+): 'SDD_SESSION_MISSING' | 'SDD_SESSION_INVALID' | null => {
+  if (causeCode === 'SDD_SESSION_MISSING' || causeCode === 'SDD_SESSION_INVALID') {
+    return causeCode;
+  }
+  const searchable = [
+    event.causeMessage,
+    event.remediation,
+    ...(event.blockingCauses ?? []).flatMap((cause) => [
+      cause.code,
+      cause.ruleId,
+      cause.message,
+      cause.remediation,
+    ]),
+  ]
+    .filter((value): value is string => typeof value === 'string')
+    .join(' ')
+    .toLowerCase();
+  if (
+    searchable.includes('sdd_session_missing') ||
+    searchable.includes('no hay sesión sdd activa') ||
+    searchable.includes('no hay sesion sdd activa') ||
+    searchable.includes('no active sdd session')
+  ) {
+    return 'SDD_SESSION_MISSING';
+  }
+  if (
+    searchable.includes('sdd_session_invalid') ||
+    searchable.includes('sesión sdd actual no es válida') ||
+    searchable.includes('sesion sdd actual no es valida') ||
+    searchable.includes('invalid sdd session')
+  ) {
+    return 'SDD_SESSION_INVALID';
+  }
+  return null;
+};
+
+const resolveWorktreeHygieneCauseCode = (
+  event: Extract<PumukiCriticalNotificationEvent, { kind: 'gate.blocked' }>,
+  causeCode: string
+): 'EVIDENCE_PREWRITE_WORKTREE_WARN' | 'EVIDENCE_PREWRITE_WORKTREE_OVER_LIMIT' | null => {
+  if (
+    causeCode === 'EVIDENCE_PREWRITE_WORKTREE_WARN' ||
+    causeCode === 'EVIDENCE_PREWRITE_WORKTREE_OVER_LIMIT'
+  ) {
+    return causeCode;
+  }
+  const searchable = [
+    event.causeMessage,
+    event.remediation,
+    ...(event.blockingCauses ?? []).flatMap((cause) => [
+      cause.code,
+      cause.ruleId,
+      cause.message,
+      cause.remediation,
+    ]),
+  ]
+    .filter((value): value is string => typeof value === 'string')
+    .join(' ')
+    .toLowerCase();
+  if (searchable.includes('evidence_prewrite_worktree_over_limit')) {
+    return 'EVIDENCE_PREWRITE_WORKTREE_OVER_LIMIT';
+  }
+  if (
+    searchable.includes('evidence_prewrite_worktree_warn') ||
+    searchable.includes('worktree hygiene warning') ||
+    searchable.includes('warn_threshold=')
+  ) {
+    return 'EVIDENCE_PREWRITE_WORKTREE_WARN';
+  }
+  return null;
+};
+
 const isGenericPolicyReconcileRemediation = (message: string): boolean => {
   const normalized = message.toLowerCase();
   return normalized.includes('policy reconcile') && normalized.includes('sdd validate');
@@ -105,6 +186,20 @@ export const resolveBlockedRemediation = (
 ): string => {
   const variant = options?.variant ?? 'dialog';
   const maxLength = BLOCKED_REMEDIATION_MAX_LENGTH_BY_VARIANT[variant];
+  const sddSessionCauseCode = resolveSddSessionCauseCode(event, causeCode);
+  if (sddSessionCauseCode) {
+    return truncateNotificationText(
+      resolveFallbackRemediation(sddSessionCauseCode),
+      maxLength
+    );
+  }
+  const worktreeHygieneCauseCode = resolveWorktreeHygieneCauseCode(event, causeCode);
+  if (worktreeHygieneCauseCode) {
+    return truncateNotificationText(
+      resolveFallbackRemediation(worktreeHygieneCauseCode),
+      maxLength
+    );
+  }
   const blockingCausesCount = event.blockingCauses?.length ?? 0;
   if (blockingCausesCount > 1) {
     return truncateNotificationText(

package/skills.lock.json

@@ -1,7 +1,7 @@
 {
   "version": "1.0",
   "compilerVersion": "1.0.0",
-  "generatedAt": "2026-05-19T20:42:51.075Z",
+  "generatedAt": "2026-05-19T21:32:21.704Z",
   "bundles": [
     {
       "name": "android-guidelines",