pumuki 6.3.118 → 6.3.120

package/CHANGELOG.md

@@ -6,6 +6,19 @@ This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [6.3.120] - 2026-04-28
+
+### Fixed
+
+- **Watch no interactivo para auditoría machine-readable:** `pumuki watch --scope=repo --once --json` desactiva notificaciones por defecto en esa invocación de una sola pasada para terminar y emitir JSON sin depender de UI del sistema, cerrando `PUMUKI-INC-112`.
+- **Bloqueos de install visibles:** cuando `pumuki install` queda bloqueado por governance, emite una notificación `gate.blocked` y añade el estado de entrega al error, cerrando la brecha de visibilidad de `PUMUKI-INC-113`.
+
+## [6.3.119] - 2026-04-28
+
+### Fixed
+
+- **Contrato CLI estable para menú:** `pumuki menu --help` deja de fallar como comando desconocido y `pumuki menu` delega en el runtime de menú existente (`pumuki-framework`), cerrando `PUMUKI-INC-111` para consumers como RuralGo.
+
 ## [6.3.118] - 2026-04-28
 
 ### Fixed

package/VERSION

@@ -1 +1 @@
-v6.3.118
+v6.3.120

package/integrations/lifecycle/cli.ts

@@ -1,4 +1,5 @@
 import { mkdirSync, writeFileSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
 import { dirname, isAbsolute, relative, resolve } from 'node:path';
 import type { GatePolicy } from '../../core/gate/GatePolicy';
 import { runPlatformGate } from '../git/runPlatformGate';
@@ -84,6 +85,7 @@ type LifecycleCommand =
   | 'update'
   | 'doctor'
   | 'status'
+  | 'menu'
   | 'watch'
   | 'loop'
   | 'sdd'
@@ -190,6 +192,7 @@ Pumuki lifecycle commands:
   pumuki doctor [--remote-checks] [--deep] [--parity] [--json]
   pumuki audit [--stage=PRE_WRITE|PRE_COMMIT|PRE_PUSH|CI] [--engine] [--json]
   pumuki status [--json] [--remote-checks]
+  pumuki menu
   pumuki watch [--stage=PRE_COMMIT|PRE_PUSH|CI] [--scope=workingTree|staged|repoAndStaged|repo] [--severity=critical|high|medium|low] [--interval-ms=<n>] [--notify-cooldown-ms=<n>] [--no-notify] [--once|--iterations=<n>] [--json]
   pumuki loop run --objective=<text> [--max-attempts=<n>] [--json]
   pumuki loop status --session=<session-id> [--json]
@@ -229,6 +232,7 @@ const isLifecycleCommand = (value: string): value is LifecycleCommand =>
   value === 'update' ||
   value === 'doctor' ||
   value === 'status' ||
+  value === 'menu' ||
   value === 'watch' ||
   value === 'loop' ||
   value === 'sdd' ||
@@ -559,6 +563,19 @@ const printHotspotsPublishDiagnostics = (diagnostics: HotspotsPublishDiagnostics
   }
 };
 
+const runFrameworkMenuShim = (argv: ReadonlyArray<string>): number => {
+  const frameworkMenuBin = resolve(__dirname, '../../bin/pumuki-framework.js');
+  const result = spawnSync(process.execPath, [frameworkMenuBin, ...argv], {
+    stdio: 'inherit',
+    env: process.env,
+  });
+  if (result.error) {
+    writeError(`[pumuki] menu failed to start: ${result.error.message}`);
+    return 1;
+  }
+  return typeof result.status === 'number' ? result.status : 1;
+};
+
 export const parseLifecycleCliArgs = (argv: ReadonlyArray<string>): ParsedArgs => {
   const commandRaw = argv[0];
   if (!commandRaw || commandRaw === '--help' || commandRaw === '-h') {
@@ -704,7 +721,9 @@ export const parseLifecycleCliArgs = (argv: ReadonlyArray<string>): ParsedArgs =
       watchIntervalMs: watchIntervalMs ?? 3000,
       watchNotifyCooldownMs: watchNotifyCooldownMs ?? 30_000,
       watchSeverityThreshold: watchSeverityThreshold ?? 'high',
-      watchNotifyEnabled: watchNotifyEnabled !== false,
+      watchNotifyEnabled:
+        watchNotifyEnabled !== false &&
+        !(json && watchIterations === 1),
       ...(typeof watchIterations === 'number' ? { watchIterations } : {}),
     };
   }
@@ -2463,6 +2482,9 @@ export const runLifecycleCli = async (
         }
         return 0;
       }
+      case 'menu': {
+        return runFrameworkMenuShim(argv.slice(1));
+      }
       case 'watch': {
         const watchResult = await activeDependencies.runLifecycleWatch(
           {

package/integrations/lifecycle/install.ts

@@ -14,6 +14,7 @@ import { readOpenSpecManagedArtifacts, writeLifecycleState } from './state';
 import { ensureRuntimeArtifactsIgnored } from './artifacts';
 import { runLifecycleAdapterInstall } from './adapter';
 import { runPolicyReconcile } from './policyReconcile';
+import { emitGateBlockedNotification } from '../notifications/emitAuditSummaryNotification';
 
 export type LifecycleInstallResult = {
   repoRoot: string;
@@ -104,6 +105,7 @@ export const runLifecycleInstall = (params?: {
   npm?: ILifecycleNpmService;
   bootstrapOpenSpec?: boolean;
   bestEffortAfterDoctorBlock?: boolean;
+  notifyGateBlocked?: typeof emitGateBlockedNotification;
 }): LifecycleInstallResult => {
   const git = params?.git ?? new LifecycleGitService();
   const bestEffortAfterDoctorBlock =
@@ -134,8 +136,20 @@ export const runLifecycleInstall = (params?: {
       };
     }
     const renderedIssues = report.issues.map((issue) => `- [${issue.severity}] ${issue.message}`).join('\n');
+    const firstIssue = report.issues[0];
+    const notificationResult = (params?.notifyGateBlocked ?? emitGateBlockedNotification)({
+      repoRoot: report.repoRoot,
+      stage: 'PRE_COMMIT',
+      totalViolations: report.issues.length,
+      causeCode: 'LIFECYCLE_INSTALL_SAFETY_BLOCKED',
+      causeMessage: firstIssue?.message ?? 'pumuki install blocked by repository safety checks.',
+      remediation: 'Corrige las incidencias activas del tracking externo y reintenta pumuki install.',
+    });
+    const notificationLine = notificationResult.delivered
+      ? '- [info] Blocking notification delivered.'
+      : `- [warning] Blocking notification not delivered: ${notificationResult.reason}`;
     throw new Error(
-      `pumuki install blocked by repository safety checks.\n${renderedIssues}\n` +
+      `pumuki install blocked by repository safety checks.\n${renderedIssues}\n${notificationLine}\n` +
       'Fix the baseline (for example tracked node_modules) and retry.'
     );
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki",
-  "version": "6.3.118",
+  "version": "6.3.120",
   "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": {