pumuki 6.3.111 → 6.3.113

package/CHANGELOG.md

@@ -6,12 +6,13 @@ This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
-## [6.3.111] - 2026-04-23
+## [6.3.113] - 2026-04-23
 
 ### Fixed
 
-- **Alignment commands now respect the consumer runtime declaration:** `status`, `doctor` and the lifecycle helpers prepend the matching Node runtime switch when the consumer declares `volta`, `.nvmrc`, or `package.json.engines.node` and the current shell Node does not match.
-- **Reproducible remediation stays repo-aware:** the suggested command keeps the consumer's runtime manager in the loop before the Pumuki install/alignment step, so fixes stay tied to the repo that is being audited.
+- **Contrato bloqueado canónico en `status` / `doctor`:** cuando el runtime está bloqueado, la salida expone `issues` accionables en vez de dejar el diagnóstico implícito.
+- **`governanceNextAction.stage` alineado con la evidencia:** el stage visible deja de forzarse y respeta `evidence.snapshot_stage` cuando existe.
+- **Remediación reproducible respecto al runtime diagnosticado:** la guía de alineación deja de apuntar a `pumuki@latest` y pasa a resolver contra el runtime efectivo del consumer.
 
 ## [6.3.102] - 2026-04-22
 

package/VERSION

@@ -1 +1 @@
-v6.3.102
+v6.3.113

package/docs/operations/RELEASE_NOTES.md

@@ -6,10 +6,11 @@ This file keeps only the operational highlights and rollout notes that matter wh
 
 ## 2026-04 (CLI stability and macOS notifications)
 
-### 2026-04-23 (v6.3.111)
+### 2026-04-23 (v6.3.113)
 
-- **Runtime-aware remediation:** `alignmentCommand` now respects the consumer's declared Node runtime when the shell Node does not match, using `volta`, `.nvmrc`, or `package.json.engines.node` as the source of truth.
-- **Rollout recommended:** publish `pumuki@6.3.111`, repin the active consumer, and revalidate `status` / `doctor` to confirm the consumer runtime is aligned before following the remediation command.
+- **Tracking canónico accionable en `status` / `doctor`:** cuando el runtime está bloqueado, la salida visible ya incluye `issues` y contexto suficiente para no depender de grep manual.
+- **Stage visible coherente con la evidencia:** `governanceNextAction.stage` deja de ser un valor forzado y sigue el `snapshot_stage` real cuando existe.
+- **Remediación reproducible:** la recomendación de alineación ahora apunta al runtime diagnosticado del consumer, no a una versión comodín.
 
 ### 2026-04-22 (v6.3.102)
 

package/integrations/lifecycle/bootstrapManifest.ts

@@ -174,7 +174,7 @@ export const buildLifecycleBootstrapManifest = (params: {
   })
   const governanceNextAction = readGovernanceNextAction({
     repoRoot,
-    stage: 'PRE_WRITE',
+    stage: governanceObservation.evidence.snapshot_stage ?? 'PRE_WRITE',
     governanceObservation,
   })
   const hooksDirectory = resolvePumukiHooksDirectory(repoRoot)

package/integrations/lifecycle/doctor.ts

@@ -30,7 +30,11 @@ import {
   evaluateOpenSpecCompatibility,
   isOpenSpecProjectInitialized,
 } from '../sdd/openSpecCli';
-import { resolveRepoTrackingState, type RepoTrackingState } from './trackingState';
+import {
+  formatTrackingActionableContext,
+  resolveRepoTrackingState,
+  type RepoTrackingState,
+} from './trackingState';
 
 export type DoctorIssueSeverity = 'warning' | 'error';
 
@@ -180,16 +184,11 @@ const buildDoctorIssues = (params: {
           `Tracking contract has conflicting canonical declarations (${params.tracking.declarations.map((declaration) => declaration.resolved_path).join(', ')}).`,
       });
     } else if (!params.tracking.single_in_progress_valid) {
-      const activeEntries = (params.tracking.in_progress_entries ?? [])
-        .map((entry) => `${entry.task_id ?? 'UNKNOWN'}@L${entry.line_number}`)
-        .join(', ');
-      const actionableContext = activeEntries.length > 0
-        ? ` active_entries=${activeEntries} last_run_status=${params.tracking.last_run_status ?? 'absent'}`
-        : '';
+      const actionableContext = formatTrackingActionableContext(params.tracking);
       issues.push({
         severity: 'warning',
         message:
-          `Canonical tracking is inconsistent for ${params.tracking.canonical_path} (in_progress_count=${params.tracking.in_progress_count}, active_task=${params.tracking.active_task_id ?? 'unknown'}, last_run_status=${params.tracking.last_run_status ?? 'absent'}).${actionableContext}`,
+          `Canonical tracking is inconsistent for ${params.tracking.canonical_path} (in_progress_count=${params.tracking.in_progress_count}, active_task=${params.tracking.active_task_id ?? 'unknown'}, last_run_status=${params.tracking.last_run_status ?? 'absent'}).${actionableContext ? ` ${actionableContext}` : ''}`,
       });
     }
   }

package/integrations/lifecycle/governanceObservationSnapshot.ts

@@ -10,6 +10,7 @@ import type { ILifecycleGitService } from './gitService';
 import { LifecycleGitService } from './gitService';
 import type { LifecyclePolicyValidationSnapshot } from './policyValidationSnapshot';
 import { writeInfo } from './cliOutputs';
+import { formatTrackingActionableContext } from './trackingState';
 
 const DEFAULT_PROTECTED_BRANCHES = new Set(['main', 'master', 'develop', 'dev']);
 
@@ -119,17 +120,6 @@ const buildContractSurface = (repoRoot: string): GovernanceContractSurface => ({
   pumuki_adapter_json: existsSync(join(repoRoot, '.pumuki', 'adapter.json')),
 });
 
-const formatTrackingActionableContext = (tracking: RepoTrackingState): string | null => {
-  const activeEntries = (tracking.in_progress_entries ?? [])
-    .map((entry) => `${entry.task_id ?? 'UNKNOWN'}@L${entry.line_number}`)
-    .join(', ');
-  if (!activeEntries) {
-    return null;
-  }
-  const lastRunStatus = tracking.last_run_status ?? 'absent';
-  return `active_entries=${activeEntries} last_run_status=${lastRunStatus}`;
-};
-
 const PLATFORM_BUNDLE_ORDER = [
   'android-enterprise-rules',
   'backend-enterprise-rules',

package/integrations/lifecycle/status.ts

@@ -21,7 +21,11 @@ import {
 } from './governanceNextAction';
 import type { DoctorIssue } from './doctor';
 import { readLifecycleState, type LifecycleState } from './state';
-import { resolveRepoTrackingState, type RepoTrackingState } from './trackingState';
+import {
+  formatTrackingActionableContext,
+  resolveRepoTrackingState,
+  type RepoTrackingState,
+} from './trackingState';
 
 export type LifecycleStatus = {
   repoRoot: string;
@@ -43,6 +47,7 @@ export type LifecycleStatus = {
 const buildLifecycleIssues = (params: {
   governanceObservation: GovernanceObservationSnapshot;
   governanceNextAction: GovernanceNextActionSummary;
+  tracking: RepoTrackingState;
 }): ReadonlyArray<DoctorIssue> => {
   const issues: DoctorIssue[] = [];
 
@@ -55,6 +60,15 @@ const buildLifecycleIssues = (params: {
     });
   }
 
+  if (params.tracking.enforced && params.tracking.single_in_progress_valid === false) {
+    const actionableContext = formatTrackingActionableContext(params.tracking);
+    issues.push({
+      severity: 'warning',
+      message:
+        `Canonical tracking is inconsistent for ${params.tracking.canonical_path ?? 'unknown'} (in_progress_count=${params.tracking.in_progress_count}, active_task=${params.tracking.active_task_id ?? 'unknown'}, last_run_status=${params.tracking.last_run_status ?? 'absent'}).${actionableContext ? ` ${actionableContext}` : ''}`,
+    });
+  }
+
   return issues;
 };
 
@@ -88,7 +102,7 @@ export const readLifecycleStatus = (params?: {
     governanceObservation,
   });
   const tracking = resolveRepoTrackingState(repoRoot);
-  const issues = buildLifecycleIssues({ governanceObservation, governanceNextAction });
+  const issues = buildLifecycleIssues({ governanceObservation, governanceNextAction, tracking });
 
   return {
     repoRoot,

package/integrations/lifecycle/trackingState.ts

@@ -25,6 +25,17 @@ export type RepoTrackingState = {
   last_run_status?: string | null;
 };
 
+export const formatTrackingActionableContext = (tracking: RepoTrackingState): string | null => {
+  const activeEntries = (tracking.in_progress_entries ?? [])
+    .map((entry) => `${entry.task_id ?? 'UNKNOWN'}@L${entry.line_number}`)
+    .join(', ');
+  if (!activeEntries) {
+    return null;
+  }
+  const lastRunStatus = tracking.last_run_status ?? 'absent';
+  return `active_entries=${activeEntries} last_run_status=${lastRunStatus}`;
+};
+
 type TrackingDeclarationSource = {
   sourceFile: string;
   priority: number;

package/package.json

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