pumuki 6.3.48 → 6.3.50

package/docs/RELEASE_NOTES.md

@@ -5,6 +5,32 @@ 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:
+  - `lastTick.changed` now reflects real scoped file delta, not merely tick execution.
+  - In `scope=staged` with no staged files:
+    - `changed=false`
+    - `changedFiles=[]`
+    - `evaluatedFiles=[]`
+- Operational impact:
+  - prevents false interpretation of activity in consumer diagnostics and backlog evidence.
+- Validation evidence:
+  - `npx --yes tsx@4.21.0 --test integrations/lifecycle/__tests__/watch.test.ts` (`6 pass / 0 fail`)
+  - `npm run -s typecheck` (`PASS`)
+  - consumer smoke (Flux, local core bin): `watch --once --stage=PRE_COMMIT --scope=staged --json` -> `changed=false` with empty arrays.
+
 ### 2026-03-05 (v6.3.48)
 
 - Anti-drift hardening for consumer validation flows:

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

@@ -2546,4 +2546,60 @@
     - `sed -n '1,60p' /Users/.../R_GO/docs/.../pumuki-integration-feedback.md` (estado cerrado 100/0).
     - `gh issue close 720 --repo SwiftEnProfundidad/ast-intelligence-hooks ...`.
 
-- 🚧 PUMUKI-189: Ejecutar siguiente bug prioritaria activa de Flux (`PUM-013`) sobre drift de dependencia en manifests durante validación y cerrar con fix + release + validación consumer.
+- ✅ PUMUKI-189: Ejecutar siguiente bug prioritaria activa de Flux (`PUM-013`) sobre drift de dependencia en manifests durante validación y cerrar con fix + release + validación consumer.
+  - Resultado (2026-03-05):
+    - issue upstream `#722` cerrada tras validación real en consumer.
+    - `PUM-013` actualizado a `✅ Cerrado` en el MD externo de Flux.
+    - verificación de no-mutación confirmada:
+      - `package.json` hash before/after sin cambios,
+      - `pnpm-lock.yaml` hash before/after sin cambios,
+      - `watch --once --json` en `ALLOW` (`gateExitCode=0`).
+  - Evidencia:
+    - `npx --yes --package pumuki@latest pumuki watch --once --stage=PRE_COMMIT --scope=staged --json`
+    - `gh issue close 722 --repo SwiftEnProfundidad/ast-intelligence-hooks ...`
+    - `/Users/juancarlosmerlosalbarracin/Developer/Projects/Flux_training/docs/BUGS_Y_MEJORAS_PUMUKI.md` (`PUM-013` -> `✅ Cerrado`).
+
+- ✅ PUMUKI-190: Ejecutar vigilancia activa del backlog canónico de RuralGo y abrir/cerrar loop solo ante nuevos hallazgos netos reproducibles (`OPEN/REPORTED`), manteniendo SAAS/Flux en validación de no-regresión sin tocar código consumidor.
+  - Resultado (2026-03-05):
+    - tick fleet ejecutado sobre los 3 backlogs externos (`SAAS`, `RuralGo`, `Flux`) sin hallazgos netos.
+    - `non_closed_total=0`, `action_required_targets=0`, `has_action_required=false`.
+    - no se abren issues nuevas ni se requiere fix técnico en este ciclo.
+  - Evidencia:
+    - `npm run -s validation:backlog-watch:tick`
+    - salida JSON: `targets=3`, `entries_scanned_total=142`, `non_closed_total=0`.
+
+- ✅ PUMUKI-191: Mantener monitorización continua multi-consumer (tick periódico) y abrir ejecución técnica inmediata solo cuando `has_action_required=true`, actualizando en el mismo ciclo el MD externo afectado + este MD interno.
+  - Resultado (2026-03-05):
+    - tick fleet detectó hallazgo neto nuevo en Flux (`PUM-014`) con `has_action_required=true`.
+    - issue upstream creada: `#723`.
+    - MD externo Flux actualizado a estado activo (`PUM-014` -> `🚧 En construccion (#723)`).
+  - Evidencia:
+    - `npm run -s validation:backlog-watch:tick` (run_id `819f019e-36ce-405f-ba24-3cb1372a2021`)
+    - `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.
+  - 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.
+  - 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/integrations/lifecycle/watch.ts

@@ -373,6 +373,7 @@ export const runLifecycleWatch = async (
       });
       const changedFiles = collectChangedFilesFromFacts(facts);
       const evaluatedFiles = collectEvaluatedFilesFromFacts(facts);
+      const scopeHasFileDelta = changedFiles.length > 0 || evaluatedFiles.length > 0;
       const runEvaluation = async (): Promise<{
         gateExitCode: number;
         evidence: AiEvidenceV2_1 | undefined;
@@ -530,7 +531,7 @@ export const runLifecycleWatch = async (
 
       lastTick = {
         tick: ticks,
-        changed,
+        changed: scopeHasFileDelta,
         evaluated: true,
         stage,
         scope,

package/package.json

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