pumuki 6.3.102 → 6.3.103

package/CHANGELOG.md

@@ -6,6 +6,14 @@ This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [6.3.103] - 2026-04-22
+
+### Fixed
+
+- **Diagnóstico accionable del tracking canónico en consumers:** `status`, `doctor` y el gate repo-policy ya incluyen `TRACKING_CANONICAL_IN_PROGRESS_INVALID` junto con referencias a entradas activas y al board canónico del repo consumidor cuando existe.
+- **Separación explícita entre blocker y warning secundario:** la salida de `PRE_WRITE` conserva un `block-summary` primario y añade `warning-summary` para warnings de higiene (`EVIDENCE_PREWRITE_WORKTREE_WARN`) cuando conviven con un bloqueo duro de tracking.
+- **Cobertura de regresión del hotfix:** nuevas pruebas fijan el parsing de boards tabulares `🚧 reported activo` y la impresión del resumen jerárquico con warning secundario.
+
 ## [6.3.102] - 2026-04-22
 
 ### Fixed

package/VERSION

@@ -1 +1 @@
-v6.3.102
+v6.3.103

package/docs/operations/RELEASE_NOTES.md

@@ -6,6 +6,12 @@ This file keeps only the operational highlights and rollout notes that matter wh
 
 ## 2026-04 (CLI stability and macOS notifications)
 
+### 2026-04-22 (v6.3.103)
+
+- **Tracking canónico accionable:** `status`, `doctor` y el gate repo-policy enriquecen `TRACKING_CANONICAL_IN_PROGRESS_INVALID` con referencias a las entradas activas detectadas en el board del consumer.
+- **PRE_WRITE menos ambiguo:** cuando un warning de higiene de worktree convive con un bloqueo duro, el runtime imprime `warning-summary` separado del `block-summary`.
+- **Rollout recomendado:** publicar `pumuki@6.3.103`, repin inmediato en `RuralGo` y revalidar `status` / `doctor` / `git commit` sobre un board con varias filas `🚧 reported activo`.
+
 ### 2026-04-22 (v6.3.102)
 
 - **Convergencia de policy efectiva:** `strict` deja de depender solo de `PUMUKI_POLICY_STRICT` cuando el contrato firmado ya lo declara por stage; `status`, `doctor` y runtime vuelven a hablar el mismo idioma.

package/integrations/git/aiGateRepoPolicyFindings.ts

@@ -1,3 +1,5 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
 import type { Finding } from '../../core/gate/Finding';
 import type { GateStage } from '../../core/gate/GateStage';
 import { evaluateAiGate, type AiGateStage } from '../gate/evaluateAiGate';
@@ -6,10 +8,82 @@ const AI_GATE_STAGES = new Set<AiGateStage>(['PRE_WRITE', 'PRE_COMMIT', 'PRE_PUS
 
 const REPO_POLICY_CODES = new Set<string>([
   'GITFLOW_PROTECTED_BRANCH',
+  'TRACKING_CANONICAL_IN_PROGRESS_INVALID',
   'EVIDENCE_PREWRITE_WORKTREE_OVER_LIMIT',
   'EVIDENCE_PREWRITE_WORKTREE_WARN',
 ]);
 
+const TRACKING_CANDIDATE_FILES = [
+  'docs/technical/08-validation/refactor/pumuki-integration-feedback.md',
+  'docs/pumuki/PUMUKI_BUGS_MEJORAS.md',
+  'docs/BUGS_Y_MEJORAS_PUMUKI.md',
+  'PUMUKI-RESET-MASTER-PLAN.md',
+  'RURALGO_SEGUIMIENTO.md',
+] as const;
+
+type TrackingActiveEntry = {
+  taskId: string | null;
+  lineNumber: number;
+};
+
+export const collectTrackingActiveEntriesFromMarkdown = (
+  markdown: string
+): ReadonlyArray<TrackingActiveEntry> => {
+  const entries: TrackingActiveEntry[] = [];
+  const lines = markdown.split(/\r?\n/u);
+  for (const [index, line] of lines.entries()) {
+    const tableMatch = line.match(
+      /^\|\s*\d+\s*\|\s*`([^`]+)`\s*\|.*\|\s*🚧(?:\s+reported\s+activo|\s+En construcción|\s+En construccion)?\s*\|/u
+    );
+    if (tableMatch) {
+      entries.push({
+        taskId: tableMatch[1]!.trim(),
+        lineNumber: index + 1,
+      });
+      continue;
+    }
+    const bulletMatch = line.match(/^- 🚧 (`?P[0-9A-Za-z.-]+`?)/u);
+    if (bulletMatch) {
+      entries.push({
+        taskId: bulletMatch[1]!.replaceAll('`', '').trim(),
+        lineNumber: index + 1,
+      });
+      continue;
+    }
+    if (/^- Estado:\s*🚧/u.test(line)) {
+      entries.push({
+        taskId: null,
+        lineNumber: index + 1,
+      });
+    }
+  }
+  return entries;
+};
+
+const formatTrackingEntry = (entry: TrackingActiveEntry): string =>
+  entry.taskId ? `${entry.taskId}@L${entry.lineNumber}` : `line_${entry.lineNumber}`;
+
+export const appendTrackingActionableContext = (params: {
+  repoRoot: string;
+  message: string;
+}): string => {
+  for (const candidate of TRACKING_CANDIDATE_FILES) {
+    const candidatePath = resolve(params.repoRoot, candidate);
+    if (!existsSync(candidatePath)) {
+      continue;
+    }
+    const source = readFileSync(candidatePath, 'utf8');
+    const entries = collectTrackingActiveEntriesFromMarkdown(source);
+    if (entries.length === 0) {
+      continue;
+    }
+    const preview = entries.slice(0, 3).map(formatTrackingEntry).join(', ');
+    const overflow = entries.length > 3 ? ` (+${entries.length - 3} more)` : '';
+    return `${params.message} active_entries=${preview}${overflow} tracking_source=${candidate}`;
+  }
+  return params.message;
+};
+
 const toRepoPolicyFinding = (params: {
   code: string;
   message: string;
@@ -39,7 +113,13 @@ export const collectAiGateRepoPolicyFindings = (params: {
     .map((v) =>
       toRepoPolicyFinding({
         code: v.code,
-        message: v.message,
+        message:
+          v.code === 'TRACKING_CANONICAL_IN_PROGRESS_INVALID'
+            ? appendTrackingActionableContext({
+              repoRoot: params.repoRoot,
+              message: v.message,
+            })
+            : v.message,
         severity: v.severity === 'ERROR' ? 'ERROR' : 'WARN',
       })
     );

package/integrations/git/runPlatformGateOutput.ts

@@ -52,6 +52,15 @@ const resolvePrimaryFinding = (findings: ReadonlyArray<Finding>): Finding => {
   return primary ?? findings[0]!;
 };
 
+const sortFindingsBySeverity = (findings: ReadonlyArray<Finding>): ReadonlyArray<Finding> =>
+  [...findings].sort((left, right) => {
+    const severityDelta = severityWeight(right.severity) - severityWeight(left.severity);
+    if (severityDelta !== 0) {
+      return severityDelta;
+    }
+    return left.ruleId.localeCompare(right.ruleId);
+  });
+
 const normalizeAnchorLine = (lines: Finding['lines']): number => {
   if (Array.isArray(lines)) {
     const candidates = lines
@@ -98,7 +107,8 @@ export const printGateFindings = (findings: ReadonlyArray<Finding>): void => {
   if (findings.length === 0) {
     return;
   }
-  const primary = resolvePrimaryFinding(findings);
+  const orderedFindings = sortFindingsBySeverity(findings);
+  const primary = resolvePrimaryFinding(orderedFindings);
   const nextAction =
     BLOCK_NEXT_ACTION_BY_CODE[primary.code]
     ?? 'Corrige el bloqueante primario y vuelve a ejecutar el mismo comando.';
@@ -106,7 +116,17 @@ export const printGateFindings = (findings: ReadonlyArray<Finding>): void => {
     `[pumuki][block-summary] primary=${primary.code} severity=${primary.severity.toUpperCase()} rule=${primary.ruleId}\n`
   );
   process.stdout.write(`[pumuki][block-summary] next_action=${nextAction}\n`);
-  for (const finding of findings) {
+  const secondaryWarnings = orderedFindings.filter(
+    (finding) =>
+      finding !== primary &&
+      severityWeight(finding.severity) < severityWeight(primary.severity)
+  );
+  for (const finding of secondaryWarnings) {
+    process.stdout.write(
+      `[pumuki][warning-summary] secondary=${finding.code} severity=${finding.severity.toUpperCase()} rule=${finding.ruleId}\n`
+    );
+  }
+  for (const finding of orderedFindings) {
     process.stdout.write(`${formatFinding(finding)}\n`);
   }
 };

package/package.json

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