pumuki 6.3.49 → 6.3.50

package/docs/RELEASE_NOTES.md

@@ -5,6 +5,17 @@ Detailed commit history remains available through Git history (`git log` / `git
 
 ## 2026-03 (enterprise hardening updates)
 
+### 2026-03-05 (v6.3.50)
+
+- Atomicity remediation clarity (`GIT_ATOMICITY_TOO_MANY_SCOPES`):
+  - blocking message now includes `scope_files=` with per-scope file breakdown,
+  - remediation now includes explicit `Sugerencia split` wording for deterministic staging split.
+- Gate summary `next_action` updated for this code:
+  - explicitly instructs to use `scope_files` before running split commands.
+- Validation evidence:
+  - `npx --yes tsx@4.21.0 --test integrations/git/__tests__/gitAtomicity.test.ts integrations/git/__tests__/runPlatformGateOutput.test.ts` (`9 pass / 0 fail`)
+  - `npm run -s typecheck` (`PASS`)
+
 ### 2026-03-05 (v6.3.49)
 
 - Watch JSON contract clarity for staged scope:

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

@@ -2578,14 +2578,28 @@
     - `gh issue create --repo SwiftEnProfundidad/ast-intelligence-hooks ...` -> `#723`
     - `/Users/juancarlosmerlosalbarracin/Developer/Projects/Flux_training/docs/BUGS_Y_MEJORAS_PUMUKI.md` actualizado.
 
-- 🚧 PUMUKI-192: Ejecutar fix de `PUM-014/#723` en `watch --json` para alinear `lastTick.changed` con delta real de archivos del scope, validar en tests y preparar cierre de leyenda externa.
+- ✅ PUMUKI-192: Ejecutar fix de `PUM-014/#723` en `watch --json` para alinear `lastTick.changed` con delta real de archivos del scope, validar en tests y preparar cierre de leyenda externa.
   - Avance (2026-03-05):
     - fix aplicado en `integrations/lifecycle/watch.ts` (`changed` ahora depende del delta real del scope).
     - regresión añadida/actualizada en `integrations/lifecycle/__tests__/watch.test.ts`.
     - smoke en Flux con binario local del core:
       - `changed=false`, `changedFiles=[]`, `evaluatedFiles=[]`, `gateOutcome=ALLOW`.
     - issue `#723` actualizada con evidencia técnica.
-  - Pendiente para cierre:
-    - publicar corte con este fix,
-    - validar en Flux con `npx --yes --package pumuki@latest ...`,
-    - mover `PUM-014` de `🚧` a `✅` y cerrar `#723`.
+  - Cierre (2026-03-05):
+    - release publicada: `pumuki@6.3.49`.
+    - validación final en Flux con `@latest`:
+      - `changed=false`, `changedFiles=[]`, `evaluatedFiles=[]`, `gateOutcome=ALLOW`.
+    - MD externo Flux actualizado: `PUM-014` -> `✅ Cerrado`.
+    - issue `#723` cerrada.
+
+- ✅ PUMUKI-193: Mantener monitorización continua multi-consumer (`SAAS` + `RuralGo` + `Flux`) y abrir fix inmediato solo ante hallazgo neto nuevo, actualizando en el mismo ciclo MD externo afectado + MD interno.
+  - Resultado (2026-03-05):
+    - tick fleet posterior al cierre de Flux detectó nuevo pendiente en SAAS: `PUMUKI-M009` (`needs_issue`).
+    - issue upstream creada: `#724`.
+    - MD externo SAAS actualizado a estado activo (`PUMUKI-M009` -> `🚧`, ref `#724`).
+  - Evidencia:
+    - `npm run -s validation:backlog-watch:tick` (run_id `0856d3f4-9508-4a93-9229-ce5c702c8b4d`)
+    - `gh issue create --repo SwiftEnProfundidad/ast-intelligence-hooks ...` -> `#724`
+    - `/Users/juancarlosmerlosalbarracin/Developer/Projects/SAAS:APP_SUPERMERCADOS/docs/pumuki/PUMUKI_BUGS_MEJORAS.md` actualizado.
+
+- 🚧 PUMUKI-194: Implementar `PUMUKI-M009/#724` para que bloqueos `GIT_ATOMICITY_TOO_MANY_SCOPES` incluyan desglose accionable por scopes/archivos + `next_action` determinista de split.

package/integrations/git/gitAtomicity.ts

@@ -172,6 +172,26 @@ const resolveScopeKey = (filePath: string): string => {
   return segments[0] ?? '';
 };
 
+const collectScopePaths = (
+  changedPaths: ReadonlyArray<string>
+): ReadonlyMap<string, ReadonlyArray<string>> => {
+  const buckets = new Map<string, Array<string>>();
+  for (const path of changedPaths) {
+    const scope = resolveScopeKey(path);
+    if (scope.length === 0) {
+      continue;
+    }
+    const current = buckets.get(scope) ?? [];
+    current.push(path.replace(/\\/g, '/'));
+    buckets.set(scope, current);
+  }
+  const normalized = new Map<string, ReadonlyArray<string>>();
+  for (const [scope, paths] of buckets.entries()) {
+    normalized.set(scope, [...new Set(paths)].sort());
+  }
+  return normalized;
+};
+
 const collectChangedPaths = (params: {
   git: IGitService;
   repoRoot: string;
@@ -259,25 +279,30 @@ export const evaluateGitAtomicity = (params: {
     });
   }
 
-  const scopeKeys = new Set(
-    changedPaths
-      .map((filePath) => resolveScopeKey(filePath))
-      .filter((scopeKey) => scopeKey.length > 0)
-  );
+  const scopePaths = collectScopePaths(changedPaths);
+  const scopeKeys = new Set(scopePaths.keys());
   if (scopeKeys.size > config.maxScopes) {
     const sortedScopes = [...scopeKeys].sort();
     const suggestedScopeAdds = sortedScopes
       .slice(0, Math.max(1, Math.min(config.maxScopes + 1, 3)))
       .map((scope) => `git add ${scope}/`)
       .join(' && ');
+    const scopeBreakdown = sortedScopes
+      .map((scope) => {
+        const paths = scopePaths.get(scope) ?? [];
+        const sample = paths.slice(0, 3);
+        return `${scope}{count=${paths.length}; sample=[${sample.join(', ')}]}`;
+      })
+      .join(' | ');
     violations.push({
       code: 'GIT_ATOMICITY_TOO_MANY_SCOPES',
       message:
-        `Git atomicity guard blocked at ${params.stage}: changed_scopes=${scopeKeys.size} exceeds max_scopes=${config.maxScopes}.`,
+        `Git atomicity guard blocked at ${params.stage}: changed_scopes=${scopeKeys.size} exceeds max_scopes=${config.maxScopes}. ` +
+        `scope_files=${scopeBreakdown}.`,
       remediation:
         `Agrupa cambios por ámbito funcional (máximo ${config.maxScopes} scopes por commit). ` +
         `scopes_detectados=[${sortedScopes.join(', ')}]. ` +
-        `Sugerencia: git restore --staged . && ${suggestedScopeAdds} && git commit -m "<tipo>: <scope>".`,
+        `Sugerencia split: git restore --staged . && ${suggestedScopeAdds} && git commit -m "<tipo>: <scope>".`,
     });
   }
 

package/integrations/git/runPlatformGateOutput.ts

@@ -16,7 +16,7 @@ const BLOCK_NEXT_ACTION_BY_CODE: Readonly<Record<string, string>> = {
   GIT_ATOMICITY_TOO_MANY_FILES:
     'git restore --staged . && separa cambios en commits más pequeños',
   GIT_ATOMICITY_TOO_MANY_SCOPES:
-    'git restore --staged . && git add <scope>/ && git commit -m "<tipo>: <scope>"',
+    'Revisa scope_files del bloqueo y aplica: git restore --staged . && git add <scope>/ && git commit -m "<tipo>: <scope>"',
   ACTIVE_RULE_IDS_EMPTY_FOR_CODE_CHANGES_HIGH:
     'Reconcilia policy/skills y reintenta PRE_COMMIT: npx --yes --package pumuki@latest pumuki policy reconcile --strict --json && npx --yes --package pumuki@latest pumuki-pre-commit',
   SKILLS_SKILLS_FRONTEND_NO_SOLID_VIOLATIONS:

package/package.json

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