pumuki 6.3.316 → 6.3.318

package/package.json

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

@@ -192,6 +192,24 @@ const isGoldenFlowCause = (
   (cause.ruleId ?? '').startsWith('generic_tdd_') ||
   (cause.ruleId ?? '').startsWith('generic_red_green_refactor');
 
+const isBddScenarioMissingCause = (
+  cause: NonNullable<Extract<PumukiCriticalNotificationEvent, { kind: 'gate.blocked' }>['blockingCauses']>[number]
+): boolean => {
+  const searchable = `${cause.code} ${cause.ruleId ?? ''} ${cause.message}`.toLowerCase();
+  return (
+    searchable.includes('tdd_bdd_scenario_file_missing') ||
+    searchable.includes('generic_bdd_feature_required') ||
+    searchable.includes('missing feature file')
+  );
+};
+
+const extractExpectedBddFeatureFile = (cause: NonNullable<Extract<PumukiCriticalNotificationEvent, { kind: 'gate.blocked' }>['blockingCauses']>[number]): string => {
+  const directFile = cause.file?.endsWith('.feature') ? cause.file : null;
+  const fileField = extractFieldFromCauseMessage(cause.message, 'file');
+  const missingFeature = cause.message.match(/missing feature file\s+([^\s.]+\.feature|[^\s]+\.feature)/i)?.[1];
+  return directFile ?? fileField ?? missingFeature ?? 'fichero .feature de la slice';
+};
+
 const isSkillCause = (
   cause: NonNullable<Extract<PumukiCriticalNotificationEvent, { kind: 'gate.blocked' }>['blockingCauses']>[number]
 ): boolean =>
@@ -274,6 +292,15 @@ const formatBlockingCauseForDialog = (
       `   Falta: ${truncateNotificationText(formatGoldenFlowMissing(cause.message), 120)}`,
     ];
   }
+  if (isBddScenarioMissingCause(cause)) {
+    const expectedFeatureFile = extractExpectedBddFeatureFile(cause);
+    return [
+      `${index + 1}. Causa bloqueante: escenario BDD sin fichero .feature`,
+      `   Fichero esperado: ${truncateNotificationText(expectedFeatureFile, 120)}`,
+      '   Falla: La slice referencia un escenario BDD, pero no existe su fichero .feature.',
+      '   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.',
+    ];
+  }
 
   const causeLabel = isSkillCause(cause) ? 'Regla' : 'Causa bloqueante';
   return [
@@ -295,6 +322,11 @@ const hasOnlyGoldenFlowCauses = (
 ): boolean =>
   Boolean(causes?.length) && causes!.every(isGoldenFlowCause);
 
+const hasOnlyBddScenarioMissingCauses = (
+  causes: Extract<PumukiCriticalNotificationEvent, { kind: 'gate.blocked' }>['blockingCauses']
+): boolean =>
+  Boolean(causes?.length) && causes!.every(isBddScenarioMissingCause);
+
 const resolveGoldenFlowDialogRemediation = (
   causes: Extract<PumukiCriticalNotificationEvent, { kind: 'gate.blocked' }>['blockingCauses']
 ): string => {
@@ -314,6 +346,8 @@ export const buildBlockedDialogPayload = (params: {
     ? WORKTREE_HYGIENE_REMEDIATION
     : hasOnlyGoldenFlowCauses(params.event.blockingCauses)
     ? 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.'
     : 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

@@ -38,6 +38,23 @@ const isGoldenFlowCause = (cause: BlockedCause): boolean => {
   );
 };
 
+const isBddScenarioMissingCause = (cause: BlockedCause): boolean => {
+  const searchable = `${cause.code} ${cause.ruleId ?? ''} ${cause.message}`.toLowerCase();
+  return (
+    searchable.includes('tdd_bdd_scenario_file_missing') ||
+    searchable.includes('generic_bdd_feature_required') ||
+    searchable.includes('missing feature file')
+  );
+};
+
+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];
+  const missingFeature = cause.message.match(/missing feature file\s+([^\s.]+\.feature|[^\s]+\.feature)/i)?.[1];
+  const raw = directFile ?? fieldMatch ?? missingFeature ?? 'fichero .feature de la slice';
+  return raw.split('/').filter(Boolean).pop() ?? raw;
+};
+
 const normalizeGoldenFlowMissingToken = (message: string): string => {
   const match = message.match(/missing=\[([^\]]+)\]/i);
   return (match?.[1] ?? '').toUpperCase();
@@ -145,7 +162,7 @@ const formatCauseProblem = (cause: BlockedCause): string => {
 const formatCauseFix = (cause: BlockedCause): string =>
   normalizeNotificationText(
     cause.remediation ??
-    'Corrige la violación indicada con regla, fichero y línea, y vuelve a ejecutar el gate.'
+    'Corrige la violación indicada con regla, fichero y línea, y vuelve a intentar el commit.'
   );
 
 export const resolvePrioritizedBlockingCauses = (
@@ -165,6 +182,11 @@ export const resolvePrioritizedBlockingCauses = (
     if (leftGoldenFlow !== rightGoldenFlow) {
       return leftGoldenFlow ? -1 : 1;
     }
+    const leftBddScenarioMissing = isBddScenarioMissingCause(left);
+    const rightBddScenarioMissing = isBddScenarioMissingCause(right);
+    if (leftBddScenarioMissing !== rightBddScenarioMissing) {
+      return leftBddScenarioMissing ? -1 : 1;
+    }
     return 0;
   });
 };
@@ -188,6 +210,9 @@ const buildBlockingCausesSummary = (
   if (isGoldenFlowCause(first)) {
     return `Violación del ciclo TDD${overflow}`;
   }
+  if (isBddScenarioMissingCause(first)) {
+    return `BDD sin fichero .feature: ${extractExpectedBddFeatureFile(first)}${overflow}`;
+  }
   return `${prefix}: ${formatCauseRule(first)} · ${formatCauseLocation(first)}${overflow}`;
 };
 
@@ -206,7 +231,7 @@ const buildBlockingCausesRemediation = (
     return [
       `Regla: ${formatVisibleRule(first)}.`,
       `Fichero: ${formatCauseLocation(first)}.`,
-      `Viola: ${formatCauseProblem(first)}.`,
+      `Falla: ${formatCauseProblem(first)}.`,
       `Solución: ${formatCauseFix(first)}.`,
       prioritized.length > 1 ? `Quedan ${prioritized.length - 1} causa(s) más en el reporte completo.` : '',
     ]
@@ -216,6 +241,9 @@ const buildBlockingCausesRemediation = (
   if (isGoldenFlowCause(first)) {
     return formatGoldenFlowBannerRemediation(first);
   }
+  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.`;
+  }
   return `${formatCauseFix(first)} Revisa el reporte completo para el resto de causas bloqueantes.`;
 };
 

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

@@ -4,6 +4,7 @@ import {
   truncateNotificationText,
 } from './framework-menu-system-notifications-text';
 import {
+  buildNotificationTrackingRemediation,
   extractNotificationTrackingContext,
   TRACKING_BLOCKED_REMEDIATION,
 } from './framework-menu-system-notifications-tracking';
@@ -21,9 +22,9 @@ 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 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.',
+    '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.',
   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.',
+    '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.',
   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.',
@@ -34,7 +35,7 @@ const BLOCKED_REMEDIATION_BY_CODE: Readonly<Record<string, string>> = {
   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.',
+    '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 vuelve a intentar el commit.',
   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.',
 };
@@ -219,8 +220,9 @@ export const resolveBlockedRemediation = (
   const fromEvent = event.remediation
     ? normalizeBlockedRemediation(event.remediation)
     : '';
-  if (extractNotificationTrackingContext(event.causeMessage)) {
-    return truncateNotificationText(TRACKING_BLOCKED_REMEDIATION, maxLength);
+  const trackingContext = extractNotificationTrackingContext(event.causeMessage);
+  if (trackingContext) {
+    return truncateNotificationText(buildNotificationTrackingRemediation(trackingContext), maxLength);
   }
   if (fromEvent.length > 0) {
     if (

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

@@ -1,6 +1,7 @@
 export type NotificationTrackingContext = {
   activeEntry?: string;
   trackingSource?: string;
+  line?: string;
 };
 
 const TRACKING_CONTEXT_PATTERN = /\b(active_entries=|tracking_source=|TRACKING_CANONICAL_)/u;
@@ -15,28 +16,46 @@ export const extractNotificationTrackingContext = (
     .match(/\bactive_entries=([^,\s]+)/u)?.[1]
     ?.replace(/@L\d+$/u, '')
     .trim();
+  const line = message.match(/\bline[_=]([0-9]+)\b/u)?.[1]?.trim();
   const trackingSource = message.match(/\btracking_source=([^\s]+)/u)?.[1]?.trim();
   return {
-    activeEntry: activeEntry && activeEntry.length > 0 ? activeEntry : undefined,
+    activeEntry: activeEntry && activeEntry.length > 0 && !/^line_[0-9]+$/u.test(activeEntry)
+      ? activeEntry
+      : undefined,
     trackingSource: trackingSource && trackingSource.length > 0 ? trackingSource : undefined,
+    line: line && line.length > 0 ? line : undefined,
   };
 };
 
 export const buildNotificationTrackingCauseSummary = (
   context: NotificationTrackingContext
 ): string => {
+  const lineSuffix = context.line ? `, línea ${context.line}` : '';
   if (context.activeEntry && context.trackingSource) {
-    return `Tracking bloqueado: ${context.activeEntry} en ${context.trackingSource}.`;
+    return `Tracking bloqueado: ${context.activeEntry} en ${context.trackingSource}${lineSuffix}.`;
   }
   if (context.activeEntry) {
-    return `Tracking bloqueado: ${context.activeEntry}.`;
+    return `Tracking bloqueado: ${context.activeEntry}${lineSuffix}.`;
   }
   if (context.trackingSource) {
-    return `Tracking bloqueado en ${context.trackingSource}.`;
+    return `Tracking bloqueado en ${context.trackingSource}${lineSuffix}.`;
+  }
+  if (context.line) {
+    return `Tracking bloqueado en la línea ${context.line}.`;
   }
   return 'El tracking canónico del repo bloquea la governance.';
 };
 
 export const TRACKING_BLOCKED_REMEDIATION =
-  'Corrige el MD de tracking: deja una única tarea activa válida y vuelve a ejecutar el gate.';
+  'Corrige el MD de tracking: deja una única tarea activa válida, elimina estados activos duplicados o inválidos y vuelve a intentar el commit.';
 
+export const buildNotificationTrackingRemediation = (
+  context: NotificationTrackingContext
+): string => {
+  const target = context.trackingSource
+    ? `${context.trackingSource}${context.line ? `, línea ${context.line}` : ''}`
+    : context.line
+    ? `la línea ${context.line} del MD de tracking`
+    : 'el MD de tracking';
+  return `Abre el MD de tracking ${target}. Deja una única tarea activa válida, elimina estados activos duplicados o inválidos y vuelve a intentar el commit.`;
+};