pumuki 6.3.51 → 6.3.52

package/integrations/lifecycle/cli.ts

@@ -1482,7 +1482,17 @@ const printDoctorReport = (
   remoteCiDiagnostics?: RemoteCiDiagnostics
 ): void => {
   writeInfo(`[pumuki] repo: ${report.repoRoot}`);
-  writeInfo(`[pumuki] package version: ${report.packageVersion}`);
+  writeInfo(`[pumuki] effective version: ${report.version.effective}`);
+  writeInfo(`[pumuki] runtime version: ${report.version.runtime}`);
+  writeInfo(
+    `[pumuki] consumer installed version: ${report.version.consumerInstalled ?? 'unknown'}`
+  );
+  writeInfo(
+    `[pumuki] lifecycle installed version: ${report.version.lifecycleInstalled ?? 'unknown'}`
+  );
+  if (report.version.driftWarning) {
+    writeInfo(`[pumuki] version drift: ${report.version.driftWarning}`);
+  }
   writeInfo(
     `[pumuki] hooks path: ${report.hooksDirectory} (${report.hooksDirectoryResolution})`
   );
@@ -2099,9 +2109,18 @@ export const runLifecycleCli = async (
           );
         } else {
           writeInfo(`[pumuki] repo: ${status.repoRoot}`);
-          writeInfo(`[pumuki] package version: ${status.packageVersion}`);
+          writeInfo(`[pumuki] effective version: ${status.version.effective}`);
+          writeInfo(`[pumuki] runtime version: ${status.version.runtime}`);
+          writeInfo(
+            `[pumuki] consumer installed version: ${status.version.consumerInstalled ?? 'unknown'}`
+          );
+          writeInfo(
+            `[pumuki] lifecycle installed version: ${status.version.lifecycleInstalled ?? 'unknown'}`
+          );
+          if (status.version.driftWarning) {
+            writeInfo(`[pumuki] version drift: ${status.version.driftWarning}`);
+          }
           writeInfo(`[pumuki] lifecycle installed: ${status.lifecycleState.installed ?? 'false'}`);
-          writeInfo(`[pumuki] lifecycle version: ${status.lifecycleState.version ?? 'unknown'}`);
           writeInfo(
             `[pumuki] hooks path: ${status.hooksDirectory} (${status.hooksDirectoryResolution})`
           );

package/integrations/lifecycle/doctor.ts

@@ -4,7 +4,7 @@ import { readEvidenceResult } from '../evidence/readEvidence';
 import { resolvePolicyForStage } from '../gate/stagePolicies';
 import { getPumukiHooksStatus, resolvePumukiHooksDirectory } from './hookManager';
 import { LifecycleGitService, type ILifecycleGitService } from './gitService';
-import { getCurrentPumukiVersion } from './packageInfo';
+import { buildLifecycleVersionReport, getCurrentPumukiVersion } from './packageInfo';
 import {
   readLifecyclePolicyValidationSnapshot,
   type LifecyclePolicyValidationSnapshot,
@@ -72,6 +72,7 @@ export type DoctorCompatibilityContract = {
 export type LifecycleDoctorReport = {
   repoRoot: string;
   packageVersion: string;
+  version: ReturnType<typeof buildLifecycleVersionReport>;
   lifecycleState: LifecycleState;
   trackedNodeModulesPaths: ReadonlyArray<string>;
   hookStatus: ReturnType<typeof getPumukiHooksStatus>;
@@ -724,10 +725,15 @@ export const runLifecycleDoctor = (params?: {
       hookStatus,
     })
     : undefined;
+  const version = buildLifecycleVersionReport({
+    repoRoot,
+    lifecycleVersion: lifecycleState.version,
+  });
 
   return {
     repoRoot,
-    packageVersion: getCurrentPumukiVersion({ repoRoot }),
+    packageVersion: version.effective,
+    version,
     lifecycleState,
     trackedNodeModulesPaths,
     hookStatus,

package/integrations/lifecycle/packageInfo.ts

@@ -24,6 +24,17 @@ export type PumukiVersionMetadata = {
   source: 'consumer-node-modules' | 'runtime-package';
 };
 
+export type LifecycleVersionReport = {
+  effective: string;
+  runtime: string;
+  consumerInstalled: string | null;
+  lifecycleInstalled: string | null;
+  source: PumukiVersionMetadata['source'];
+  driftFromRuntime: boolean;
+  driftFromLifecycleInstalled: boolean;
+  driftWarning: string | null;
+};
+
 export const resolvePumukiVersionMetadata = (params?: { repoRoot?: string }): PumukiVersionMetadata => {
   const runtimeVersion = packageJson.version;
   const repoRoot = params?.repoRoot;
@@ -51,3 +62,35 @@ export const getCurrentPumukiVersion = (params?: { repoRoot?: string }): string
 };
 
 export const getCurrentPumukiPackageName = (): string => packageJson.name;
+
+export const buildLifecycleVersionReport = (params?: {
+  repoRoot?: string;
+  lifecycleVersion?: string | null | undefined;
+}): LifecycleVersionReport => {
+  const metadata = resolvePumukiVersionMetadata({ repoRoot: params?.repoRoot });
+  const lifecycleInstalled =
+    typeof params?.lifecycleVersion === 'string' && params.lifecycleVersion.trim().length > 0
+      ? params.lifecycleVersion.trim()
+      : null;
+  const driftFromRuntime = metadata.resolvedVersion !== metadata.runtimeVersion;
+  const driftFromLifecycleInstalled =
+    lifecycleInstalled !== null && metadata.resolvedVersion !== lifecycleInstalled;
+  const driftTargets = [
+    driftFromRuntime ? `runtime=${metadata.runtimeVersion}` : null,
+    driftFromLifecycleInstalled ? `lifecycle=${lifecycleInstalled}` : null,
+  ].filter((value): value is string => value !== null);
+
+  return {
+    effective: metadata.resolvedVersion,
+    runtime: metadata.runtimeVersion,
+    consumerInstalled: metadata.consumerInstalledVersion,
+    lifecycleInstalled,
+    source: metadata.source,
+    driftFromRuntime,
+    driftFromLifecycleInstalled,
+    driftWarning:
+      driftTargets.length > 0
+        ? `Version drift detectado: effective=${metadata.resolvedVersion} ${driftTargets.join(' ')}.`
+        : null,
+  };
+};

package/integrations/lifecycle/status.ts

@@ -1,6 +1,6 @@
 import { getPumukiHooksStatus, resolvePumukiHooksDirectory } from './hookManager';
 import { LifecycleGitService, type ILifecycleGitService } from './gitService';
-import { getCurrentPumukiVersion } from './packageInfo';
+import { buildLifecycleVersionReport } from './packageInfo';
 import {
   readLifecyclePolicyValidationSnapshot,
   type LifecyclePolicyValidationSnapshot,
@@ -10,6 +10,7 @@ import { readLifecycleState, type LifecycleState } from './state';
 export type LifecycleStatus = {
   repoRoot: string;
   packageVersion: string;
+  version: ReturnType<typeof buildLifecycleVersionReport>;
   lifecycleState: LifecycleState;
   hookStatus: ReturnType<typeof getPumukiHooksStatus>;
   hooksDirectory: string;
@@ -27,11 +28,17 @@ export const readLifecycleStatus = (params?: {
   const repoRoot = git.resolveRepoRoot(cwd);
   const hooksDirectory = resolvePumukiHooksDirectory(repoRoot);
   const trackedNodeModulesCount = git.trackedNodeModulesPaths(repoRoot).length;
+  const lifecycleState = readLifecycleState(git, repoRoot);
+  const version = buildLifecycleVersionReport({
+    repoRoot,
+    lifecycleVersion: lifecycleState.version,
+  });
 
   return {
     repoRoot,
-    packageVersion: getCurrentPumukiVersion({ repoRoot }),
-    lifecycleState: readLifecycleState(git, repoRoot),
+    packageVersion: version.effective,
+    version,
+    lifecycleState,
     hookStatus: getPumukiHooksStatus(repoRoot),
     hooksDirectory: hooksDirectory.path,
     hooksDirectoryResolution: hooksDirectory.source,

package/package.json

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