pumuki 6.3.40 → 6.3.41

package/VERSION

@@ -1 +1 @@
-v6.3.40
+v6.3.41

package/docs/RELEASE_NOTES.md

@@ -5,6 +5,20 @@ Detailed commit history remains available through Git history (`git log` / `git
 
 ## 2026-03 (enterprise hardening updates)
 
+### 2026-03-05 (v6.3.41)
+
+- UX de notificaciones de bloqueo mejorada para escenarios multi-repo:
+  - el subtítulo ahora incluye proyecto/repositorio (`<project> · <stage> · <causa>`),
+  - facilita distinguir bloqueos cuando hay varios repos abiertos.
+- Modal de bloqueo en macOS ahora activa por defecto en `gate.blocked`:
+  - sin requerir `PUMUKI_MACOS_BLOCKED_DIALOG=1`,
+  - override explícito soportado con `PUMUKI_MACOS_BLOCKED_DIALOG=0|1`.
+- Contrato de configuración de notificaciones endurecido:
+  - `blockedDialogEnabled` persistido y leído de forma determinista.
+- Evidencia de validación:
+  - `npx --yes tsx@4.21.0 --test scripts/__tests__/framework-menu-system-notifications.test.ts` (`13 pass / 0 fail`)
+  - `npm run -s typecheck` (`PASS`)
+
 ### 2026-03-05 (v6.3.40)
 
 - AST Intelligence dual validation PoC (`#616`) integrado en gate:

package/docs/seguimiento-activo-pumuki-saas-supermercados.md

@@ -1713,8 +1713,45 @@
     - actualización directa de `/Users/juancarlosmerlosalbarracin/Developer/Projects/R_GO/docs/technical/08-validation/refactor/pumuki-integration-feedback.md`.
     - verificación de consistencia: `rg -n \"🚧 REPORTED|⏳ REPORTED\" .../pumuki-integration-feedback.md` -> sin incidencias abiertas.
 
-- 🚧 PUMUKI-137: Preparar y ejecutar el siguiente corte de release (versionado + publicación npm + upgrade en consumidores RuralGo/SAAS/Flux_training).
+- ✅ PUMUKI-137: Preparar y ejecutar el siguiente corte de release (versionado + publicación npm + upgrade en consumidores RuralGo/SAAS/Flux_training).
+  - Resultado implementado:
+    - release publicada: `pumuki@6.3.40` (npm `latest`).
+    - upgrade consumidores completado:
+      - `R_GO`: `pumuki@6.3.40` + `pumuki install` + `status/doctor` en verde.
+      - `SAAS:APP_SUPERMERCADOS`: `pumuki@6.3.40` + `pumuki install` + `status/doctor` en verde.
+      - `Flux_training`: instalación inicial `pumuki@6.3.40` + `pumuki install` + `status/doctor` en verde.
+  - Evidencia (2026-03-05):
+    - `npm publish --access public` -> `+ pumuki@6.3.40`.
+    - `npm view pumuki version` -> `6.3.40`.
+    - validación local release:
+      - `npm run -s test:backlog-tooling` -> `49 pass / 0 fail`.
+      - `npm run -s typecheck` -> `PASS`.
+
+- ✅ PUMUKI-138: Endurecer UX de notificaciones de bloqueo multi-repo (contexto de proyecto + modal fiable).
+  - Resultado implementado:
+    - `scripts/framework-menu-system-notifications-lib.ts`:
+      - añade contexto de proyecto en notificaciones (`<repo> · <stage> · <causa>`),
+      - activa modal de bloqueo por defecto en macOS cuando hay `gate.blocked` (sin depender obligatoriamente de `PUMUKI_MACOS_BLOCKED_DIALOG=1`),
+      - soporta override explícito (`PUMUKI_MACOS_BLOCKED_DIALOG=0|1`) y preserva control anti-spam existente.
+    - `scripts/__tests__/framework-menu-system-notifications.test.ts`:
+      - nueva cobertura para subtítulo con proyecto,
+      - nueva cobertura para apertura de modal por defecto.
+  - Evidencia (2026-03-05):
+    - `npx --yes tsx@4.21.0 --test scripts/__tests__/framework-menu-system-notifications.test.ts` -> `13 pass / 0 fail`.
+    - `npm run -s typecheck` -> `PASS`.
+
+- 🚧 PUMUKI-139: Monitorizar feedback post-release en consumidores reales (SAAS y RuralGo) y registrar únicamente hallazgos netos nuevos para siguiente corte.
   - Alcance:
-    - validar worktree/release notes/changelog y publicar patch release con fixes recientes (`PUMUKI-132..136`),
-    - verificar versión publicada en npm,
-    - ejecutar upgrade de `pumuki` en repos consumidores acordados y dejar evidencia.
+    - vigilar nuevos bloqueos/regresiones tras `6.3.41`,
+    - mantener MDs externos sincronizados por leyenda sin contradicciones,
+    - preparar siguiente paquete de fixes/mejoras sin re-bugs.
+
+- ✅ PUMUKI-140: Publicar patch release con mejoras UX de notificación de bloqueo multi-repo.
+  - Resultado implementado:
+    - release `pumuki@6.3.41` publicada con:
+      - proyecto visible en subtítulo de bloqueo,
+      - modal de bloqueo habilitada por defecto en macOS,
+      - override explícito `PUMUKI_MACOS_BLOCKED_DIALOG=0|1`.
+  - Evidencia (2026-03-05):
+    - `npm publish --access public` -> `+ pumuki@6.3.41`.
+    - `npm view pumuki version` -> `6.3.41`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki",
-  "version": "6.3.40",
+  "version": "6.3.41",
   "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-lib.ts

@@ -1,6 +1,6 @@
 import { execFileSync as runBinarySync } from 'node:child_process';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { basename, join } from 'node:path';
 
 export type PumukiNotificationStage = 'PRE_COMMIT' | 'PRE_PUSH' | 'CI' | 'PRE_WRITE';
 
@@ -41,6 +41,7 @@ export type SystemNotificationsConfig = {
   enabled: boolean;
   channel: 'macos';
   muteUntil?: string;
+  blockedDialogEnabled?: boolean;
 };
 
 export type SystemNotificationEmitResult =
@@ -110,6 +111,37 @@ const isTruthyFlag = (value?: string): boolean => {
   return normalized === '1' || normalized === 'true' || normalized === 'yes' || normalized === 'on';
 };
 
+const resolveProjectLabel = (params: {
+  repoRoot?: string;
+  projectLabel?: string;
+}): string | null => {
+  const explicit = params.projectLabel
+    ? normalizeNotificationText(params.projectLabel)
+    : '';
+  if (explicit.length > 0) {
+    return truncateNotificationText(explicit, 28);
+  }
+  if (!params.repoRoot) {
+    return null;
+  }
+  const inferred = normalizeNotificationText(basename(params.repoRoot));
+  if (inferred.length === 0) {
+    return null;
+  }
+  return truncateNotificationText(inferred, 28);
+};
+
+const resolveBlockedDialogEnabled = (params: {
+  env: NodeJS.ProcessEnv;
+  config: SystemNotificationsConfig;
+}): boolean => {
+  const raw = params.env.PUMUKI_MACOS_BLOCKED_DIALOG;
+  if (typeof raw === 'string' && raw.trim().length > 0) {
+    return isTruthyFlag(raw);
+  }
+  return params.config.blockedDialogEnabled !== false;
+};
+
 const BLOCKED_CAUSE_SUMMARY_BY_CODE: Readonly<Record<string, string>> = {
   EVIDENCE_MISSING: 'Falta evidencia para validar este paso.',
   EVIDENCE_INVALID: 'La evidencia actual es inválida.',
@@ -253,6 +285,7 @@ export const buildSystemNotificationsConfigFromSelection = (
 ): SystemNotificationsConfig => ({
   enabled,
   channel: 'macos',
+  blockedDialogEnabled: true,
 });
 
 export const persistSystemNotificationsConfig = (repoRoot: string, enabled: boolean): string => {
@@ -273,10 +306,12 @@ export const readSystemNotificationsConfig = (repoRoot: string): SystemNotificat
       enabled?: unknown;
       channel?: unknown;
       muteUntil?: unknown;
+      blockedDialogEnabled?: unknown;
     };
     const config: SystemNotificationsConfig = {
       enabled: parsed.enabled === true,
       channel: 'macos',
+      blockedDialogEnabled: parsed.blockedDialogEnabled !== false,
     };
     if (typeof parsed.muteUntil === 'string' && parsed.muteUntil.trim().length > 0) {
       config.muteUntil = parsed.muteUntil;
@@ -319,6 +354,7 @@ const applyDialogChoice = (params: {
     persistSystemNotificationsConfigFile(params.repoRoot, {
       enabled: false,
       channel: params.config.channel,
+      blockedDialogEnabled: params.config.blockedDialogEnabled !== false,
     });
     return;
   }
@@ -329,13 +365,24 @@ const applyDialogChoice = (params: {
       enabled: true,
       channel: params.config.channel,
       muteUntil,
+      blockedDialogEnabled: params.config.blockedDialogEnabled !== false,
     });
   }
 };
 
 export const buildSystemNotificationPayload = (
-  event: PumukiCriticalNotificationEvent
+  event: PumukiCriticalNotificationEvent,
+  context?: {
+    repoRoot?: string;
+    projectLabel?: string;
+  }
 ): SystemNotificationPayload => {
+  const projectLabel = resolveProjectLabel({
+    repoRoot: context?.repoRoot,
+    projectLabel: context?.projectLabel,
+  });
+  const projectPrefix = projectLabel ? `${projectLabel} · ` : '';
+
   if (event.kind === 'audit.summary') {
     if (event.criticalViolations > 0) {
       return {
@@ -370,7 +417,7 @@ export const buildSystemNotificationPayload = (
     const remediation = resolveBlockedRemediation(event, causeCode);
     return {
       title: '🔴 Pumuki bloqueado',
-      subtitle: `${event.stage} · ${causeSummary}`,
+      subtitle: `${projectPrefix}${event.stage} · ${causeSummary}`,
       message: `Solución: ${remediation}`,
       soundName: 'Basso',
     };
@@ -418,7 +465,10 @@ export const emitSystemNotification = (params: {
   }
 
   const runner = params.runCommand ?? runSystemCommand;
-  const payload = buildSystemNotificationPayload(params.event);
+  const payload = buildSystemNotificationPayload(params.event, {
+    repoRoot: params.repoRoot,
+    projectLabel: params.env?.PUMUKI_PROJECT_LABEL,
+  });
   const script = buildDisplayNotificationScript(payload);
   const exitCode = runner('osascript', ['-e', script]);
 
@@ -427,12 +477,22 @@ export const emitSystemNotification = (params: {
   }
 
   const env = params.env ?? process.env;
-  if (params.event.kind === 'gate.blocked' && isTruthyFlag(env.PUMUKI_MACOS_BLOCKED_DIALOG)) {
+  if (
+    params.event.kind === 'gate.blocked'
+    && resolveBlockedDialogEnabled({ env, config })
+  ) {
     const causeCode = params.event.causeCode ?? 'GATE_BLOCKED';
     const cause = resolveBlockedCauseSummary(params.event, causeCode);
     const remediation = resolveBlockedRemediation(params.event, causeCode);
+    const projectLabel = resolveProjectLabel({
+      repoRoot: params.repoRoot,
+      projectLabel: env.PUMUKI_PROJECT_LABEL,
+    });
+    const dialogTitle = projectLabel
+      ? `🔴 Pumuki bloqueado · ${projectLabel}`
+      : '🔴 Pumuki bloqueado';
     const dialogScript = buildDisplayDialogScript({
-      title: '🔴 Pumuki bloqueado',
+      title: dialogTitle,
       cause,
       remediation,
     });