pumuki 6.3.103 → 6.3.105

package/CHANGELOG.md

@@ -6,6 +6,21 @@ This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [6.3.105] - 2026-04-22
+
+### Fixed
+
+- **Remediaciones PRE_WRITE fijadas a la versión diagnosticada:** `sdd validate`, `auto_execute_ai_start` y la remediación por defecto dejan de recomendar `pumuki@latest` y pasan a devolver comandos con la versión efectiva del runtime (`pumuki@6.3.105` en esta línea).
+- **Backport útil de `PUMUKI-INC-089` a la línea publicada:** `main` mantiene la ruta reproducible para `install`, `policy reconcile --strict --json` y la revalidación `PRE_WRITE` sin exigir al consumer adivinar la versión correcta.
+
+## [6.3.104] - 2026-04-22
+
+### Fixed
+
+- **Tracking canónico de RuralGo reconocido por el parser de repo-policy:** `appendTrackingActionableContext` ya inspecciona `docs/RURALGO_SEGUIMIENTO.md`, que es la ruta canónica real del consumer.
+- **Filas `| 🚧 | TASK |` tratadas como entradas activas válidas:** el diagnóstico accionable cubre el formato de tabla usado por el hub de seguimiento de RuralGo además del backlog tabular de incidencias.
+- **Cobertura de regresión para el hub canónico:** nuevas pruebas fijan parsing y priorización de `docs/RURALGO_SEGUIMIENTO.md` antes de otros archivos de tracking del consumer.
+
 ## [6.3.103] - 2026-04-22
 
 ### Fixed

package/VERSION

@@ -1 +1 @@
-v6.3.103
+v6.3.105

package/docs/operations/RELEASE_NOTES.md

@@ -6,6 +6,18 @@ 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.105)
+
+- **Remediación reproducible en la línea publicada:** las rutas bloqueantes de `PRE_WRITE` dejan de sugerir `pumuki@latest` y fijan la versión efectiva del runtime al construir `next_action.command`.
+- **Cobertura MCP alineada:** `auto_execute_ai_start` devuelve las mismas remediaciones versionadas que `sdd validate` para evidence invalid/stale, `active_rule_ids` vacío y policy reconcile estricto.
+- **Rollout recomendado:** publicar `pumuki@6.3.105`, repin inmediato en `RuralGo` y revalidar el command contract de `PRE_WRITE` en `sdd validate`, `auto_execute_ai_start` y hooks reales.
+
+### 2026-04-22 (v6.3.104)
+
+- **RuralGo hub-aware diagnostics:** `TRACKING_CANONICAL_IN_PROGRESS_INVALID` pasa a enriquecer su mensaje usando `docs/RURALGO_SEGUIMIENTO.md` cuando ese hub es el board canónico del consumer.
+- **Compatibilidad con tablas del hub:** el parser reconoce filas `| 🚧 | TASK_ID |` y las devuelve como entradas activas accionables.
+- **Rollout recomendado:** publicar `pumuki@6.3.104`, repin inmediato en `RuralGo` y revalidar `status` / `doctor` / `pumuki-pre-write` con doble fila `🚧` temporal en el hub canónico.
+
 ### 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.

package/integrations/git/aiGateRepoPolicyFindings.ts

@@ -15,6 +15,7 @@ const REPO_POLICY_CODES = new Set<string>([
 
 const TRACKING_CANDIDATE_FILES = [
   'docs/technical/08-validation/refactor/pumuki-integration-feedback.md',
+  'docs/RURALGO_SEGUIMIENTO.md',
   'docs/pumuki/PUMUKI_BUGS_MEJORAS.md',
   'docs/BUGS_Y_MEJORAS_PUMUKI.md',
   'PUMUKI-RESET-MASTER-PLAN.md',
@@ -32,6 +33,14 @@ export const collectTrackingActiveEntriesFromMarkdown = (
   const entries: TrackingActiveEntry[] = [];
   const lines = markdown.split(/\r?\n/u);
   for (const [index, line] of lines.entries()) {
+    const boardRowMatch = line.match(/^\|\s*🚧\s*\|\s*([A-Z0-9-]+)\s*\|/u);
+    if (boardRowMatch) {
+      entries.push({
+        taskId: boardRowMatch[1]!.trim(),
+        lineNumber: index + 1,
+      });
+      continue;
+    }
     const tableMatch = line.match(
       /^\|\s*\d+\s*\|\s*`([^`]+)`\s*\|.*\|\s*🚧(?:\s+reported\s+activo|\s+En construcción|\s+En construccion)?\s*\|/u
     );

package/integrations/lifecycle/cli.ts

@@ -11,6 +11,7 @@ import {
 } from './doctor';
 import { runLifecycleInstall } from './install';
 import { runLifecycleRemove } from './remove';
+import { getCurrentPumukiVersion } from './packageInfo';
 import { readLifecycleStatus } from './status';
 import {
   readLifecycleExperimentalFeaturesSnapshot,
@@ -1615,10 +1616,26 @@ const printDoctorReport = (
 };
 
 const PRE_WRITE_TELEMETRY_CHAIN = 'pumuki->mcp->ai_gate->ai_evidence';
-const PRE_WRITE_INSTALL_REMEDIATION_COMMAND =
-  'npx --yes --package pumuki@latest pumuki install';
-const PRE_WRITE_POLICY_RECONCILE_COMMAND =
-  'npx --yes --package pumuki@latest pumuki policy reconcile --strict --json && npx --yes --package pumuki@latest pumuki sdd validate --stage=PRE_WRITE --json';
+const buildPinnedPumukiNpxCommand = (params: {
+  repoRoot?: string;
+  executableAndArgs: string;
+}): string =>
+  `npx --yes --package pumuki@${getCurrentPumukiVersion({ repoRoot: params.repoRoot })} ${params.executableAndArgs}`;
+const buildPreWriteInstallRemediationCommand = (repoRoot?: string): string =>
+  buildPinnedPumukiNpxCommand({ repoRoot, executableAndArgs: 'pumuki install' });
+const buildPreWriteValidateCommand = (params: {
+  repoRoot?: string;
+  stage: SddStage;
+}): string =>
+  buildPinnedPumukiNpxCommand({
+    repoRoot: params.repoRoot,
+    executableAndArgs: `pumuki sdd validate --stage=${params.stage} --json`,
+  });
+const buildPreWritePolicyReconcileCommand = (repoRoot?: string): string =>
+  `${buildPinnedPumukiNpxCommand({
+    repoRoot,
+    executableAndArgs: 'pumuki policy reconcile --strict --json',
+  })} && ${buildPreWriteValidateCommand({ repoRoot, stage: 'PRE_WRITE' })}`;
 
 type PreWriteValidationEnvelope = {
   sdd: SddEvaluateResult;
@@ -1813,8 +1830,11 @@ const PRE_WRITE_HINTS_BY_CODE: Readonly<Record<string, string>> = {
   MCP_ENTERPRISE_RECEIPT_REPO_ROOT_MISMATCH: 'Genera el recibo MCP en este mismo repositorio.',
 };
 
-const PRE_WRITE_DEFAULT_REMEDIATION =
-  'Corrige la causa bloqueante y vuelve a ejecutar: npx --yes --package pumuki@latest pumuki-pre-write';
+const buildPreWriteDefaultRemediation = (repoRoot?: string): string =>
+  `Corrige la causa bloqueante y vuelve a ejecutar: ${buildPinnedPumukiNpxCommand({
+    repoRoot,
+    executableAndArgs: 'pumuki-pre-write',
+  })}`;
 
 export const PRE_WRITE_OPENSPEC_AUTOREMEDIABLE_CODES = new Set<string>([
   'OPENSPEC_MISSING',
@@ -1838,7 +1858,7 @@ export const resolvePreWriteNextAction = (params: {
   if (!params.sdd.decision.allowed && PRE_WRITE_OPENSPEC_AUTOREMEDIABLE_CODES.has(params.sdd.decision.code)) {
     return {
       reason: params.sdd.decision.code,
-      command: PRE_WRITE_INSTALL_REMEDIATION_COMMAND,
+      command: buildPreWriteInstallRemediationCommand(params.aiGate?.repo_state.repo_root),
     };
   }
   if (!params.aiGate || params.aiGate.allowed) {
@@ -1850,7 +1870,7 @@ export const resolvePreWriteNextAction = (params: {
   if (policyReconcileViolation) {
     return {
       reason: policyReconcileViolation.code,
-      command: PRE_WRITE_POLICY_RECONCILE_COMMAND,
+      command: buildPreWritePolicyReconcileCommand(params.aiGate.repo_state.repo_root),
     };
   }
   const atomicSliceViolation = params.aiGate.violations.find((violation) =>
@@ -1866,7 +1886,10 @@ export const resolvePreWriteNextAction = (params: {
     return {
       reason: atomicSliceViolation.code,
       command:
-        `${firstSliceCommand} && npx --yes --package pumuki@latest pumuki sdd validate --stage=PRE_WRITE --json`,
+        `${firstSliceCommand} && ${buildPreWriteValidateCommand({
+          repoRoot: params.aiGate.repo_state.repo_root,
+          stage: 'PRE_WRITE',
+        })}`,
     };
   }
   const hasMcpViolation = params.aiGate.violations.some((violation) =>
@@ -1877,7 +1900,10 @@ export const resolvePreWriteNextAction = (params: {
   }
   return {
     reason: 'MCP_ENTERPRISE_RECEIPT',
-    command: 'npx --yes --package pumuki@latest pumuki-pre-write',
+    command: buildPinnedPumukiNpxCommand({
+      repoRoot: params.aiGate.repo_state.repo_root,
+      executableAndArgs: 'pumuki-pre-write',
+    }),
   };
 };
 
@@ -1888,7 +1914,7 @@ export const resolvePreWriteBlockedRemediation = (params: {
   if (params.nextAction?.command) {
     return params.nextAction.command;
   }
-  return PRE_WRITE_HINTS_BY_CODE[params.causeCode] ?? PRE_WRITE_DEFAULT_REMEDIATION;
+  return PRE_WRITE_HINTS_BY_CODE[params.causeCode] ?? buildPreWriteDefaultRemediation();
 };
 
 const wrapPreWritePanelLine = (value: string, width: number): string[] => {

package/integrations/mcp/autoExecuteAiStart.ts

@@ -1,5 +1,6 @@
 import { evaluateAiGate, type AiGateStage, type AiGateViolation } from '../gate/evaluateAiGate';
 import { collectWorktreeAtomicSlices } from '../git/worktreeAtomicSlices';
+import { getCurrentPumukiVersion } from '../lifecycle/packageInfo';
 import { resolveLearningContextExperimentalFeature } from '../policy/experimentalFeatures';
 import { readSddLearningContext, type SddLearningContext } from '../sdd/learningInsights';
 
@@ -56,6 +57,12 @@ const confidenceFromViolation = (violationCode: string | null): number => {
   return 50;
 };
 
+const buildPinnedPumukiNpxCommand = (params: {
+  repoRoot: string;
+  executableAndArgs: string;
+}): string =>
+  `npx --yes --package pumuki@${getCurrentPumukiVersion({ repoRoot: params.repoRoot })} ${params.executableAndArgs}`;
+
 const nextActionFromViolation = (
   violation: AiGateViolation | undefined,
   repoRoot: string
@@ -74,7 +81,10 @@ const nextActionFromViolation = (
       return {
         kind: 'run_command',
         message: 'Regenera o refresca evidencia y vuelve a evaluar PRE_WRITE.',
-        command: 'npx --yes --package pumuki@latest pumuki sdd validate --stage=PRE_WRITE --json',
+        command: buildPinnedPumukiNpxCommand({
+          repoRoot,
+          executableAndArgs: 'pumuki sdd validate --stage=PRE_WRITE --json',
+        }),
       };
     case 'EVIDENCE_ACTIVE_RULE_IDS_EMPTY_FOR_CODE_CHANGES':
       return {
@@ -82,7 +92,13 @@ const nextActionFromViolation = (
         message:
           'No hay active_rule_ids para plataforma de código detectada. Reconciliación strict de policy/skills y revalidación PRE_WRITE.',
         command:
-          'npx --yes --package pumuki@latest pumuki policy reconcile --strict --json && npx --yes --package pumuki@latest pumuki sdd validate --stage=PRE_WRITE --json',
+          `${buildPinnedPumukiNpxCommand({
+            repoRoot,
+            executableAndArgs: 'pumuki policy reconcile --strict --json',
+          })} && ${buildPinnedPumukiNpxCommand({
+            repoRoot,
+            executableAndArgs: 'pumuki sdd validate --stage=PRE_WRITE --json',
+          })}`,
       };
     case 'EVIDENCE_PLATFORM_SKILLS_SCOPE_INCOMPLETE':
     case 'EVIDENCE_PLATFORM_SKILLS_BUNDLES_MISSING':
@@ -91,7 +107,10 @@ const nextActionFromViolation = (
         kind: 'run_command',
         message:
           'Completa cobertura de skills por plataforma (prefijos + bundles) y revalida PRE_WRITE.',
-        command: 'npx --yes --package pumuki@latest pumuki sdd validate --stage=PRE_WRITE --json',
+        command: buildPinnedPumukiNpxCommand({
+          repoRoot,
+          executableAndArgs: 'pumuki sdd validate --stage=PRE_WRITE --json',
+        }),
       };
     case 'EVIDENCE_PLATFORM_CRITICAL_SKILLS_RULES_MISSING':
     case 'EVIDENCE_CROSS_PLATFORM_CRITICAL_ENFORCEMENT_INCOMPLETE':
@@ -100,7 +119,13 @@ const nextActionFromViolation = (
         message:
           'Reconcilia policy/skills en modo estricto (incluida skills.ios.critical-test-quality cuando aplique) y revalida PRE_WRITE.',
         command:
-          'npx --yes --package pumuki@latest pumuki policy reconcile --strict --json && npx --yes --package pumuki@latest pumuki sdd validate --stage=PRE_WRITE --json',
+          `${buildPinnedPumukiNpxCommand({
+            repoRoot,
+            executableAndArgs: 'pumuki policy reconcile --strict --json',
+          })} && ${buildPinnedPumukiNpxCommand({
+            repoRoot,
+            executableAndArgs: 'pumuki sdd validate --stage=PRE_WRITE --json',
+          })}`,
       };
     case 'EVIDENCE_PREWRITE_WORKTREE_OVER_LIMIT':
     case 'EVIDENCE_PREWRITE_WORKTREE_WARN':
@@ -117,7 +142,10 @@ const nextActionFromViolation = (
             message:
               `Particiona el worktree en slices atómicos por scope. Primer lote sugerido: ${firstSlice?.scope ?? 'scope-desconocido'}.`,
             command:
-              `${firstSlice?.staged_command ?? 'git add -p'} && npx --yes --package pumuki@latest pumuki sdd validate --stage=PRE_WRITE --json`,
+              `${firstSlice?.staged_command ?? 'git add -p'} && ${buildPinnedPumukiNpxCommand({
+                repoRoot,
+                executableAndArgs: 'pumuki sdd validate --stage=PRE_WRITE --json',
+              })}`,
           };
         }
       }
@@ -126,7 +154,10 @@ const nextActionFromViolation = (
         message:
           'Particiona el worktree en slices atómicos y revalida PRE_WRITE para continuar sin fricción.',
         command:
-          'git status --short && git add -p && npx --yes --package pumuki@latest pumuki sdd validate --stage=PRE_WRITE --json',
+          `git status --short && git add -p && ${buildPinnedPumukiNpxCommand({
+            repoRoot,
+            executableAndArgs: 'pumuki sdd validate --stage=PRE_WRITE --json',
+          })}`,
       };
     case 'GITFLOW_PROTECTED_BRANCH':
       return {

package/package.json

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