pumuki 6.3.31 → 6.3.33

package/docs/registro-maestro-de-seguimiento.md

@@ -7,7 +7,7 @@
 ## Estado actual
 - Plan activo: `docs/seguimiento-completo-validacion-ruralgo-03-03-2026.md`
 - Estado del plan: EN CURSO
-- Task activa (`🚧`): `P12.F2.T51` (publicar release con el hardening `#551` y cerrar trazabilidad final en canónico + master).
+- Task activa (`🚧`): `P12.F2.T55` (publicar patch release del contrato de compatibilidad `doctor --deep`, issue `#565`).
 
 ## Historial resumido
 - No se mantienen MDs históricos de seguimiento en este repositorio.

package/docs/seguimiento-completo-validacion-ruralgo-03-03-2026.md

@@ -1736,11 +1736,55 @@ Criterio de salida F5:
     - `npm run -s validation:contract-suite:enterprise -- --json`
     - `npm run -s validation:package-manifest`
 
-- 🚧 `P12.F2.T51` Publicar release que incluya el hardening `#551` (suite contractual) y dejar trazabilidad final en canónico + master.
+- ✅ `P12.F2.T51` Publicar release que incluya el hardening `#551` (suite contractual) y dejar trazabilidad final en canónico + master.
+  - cierre ejecutado:
+    - rama release creada y mergeada: `release/6.3.31` -> `#555` (`https://github.com/SwiftEnProfundidad/ast-intelligence-hooks/pull/555`).
+    - publicación npm completada: `pumuki@6.3.31`.
+    - issue `#551` cerrada tras merge de `#553` y release publicada.
+  - evidencia:
+    - `npm publish --access public`
+    - `npm view pumuki version` => `6.3.31`
+    - `gh pr view 555 --json state,mergeCommit,url`
+
+- ✅ `P12.F2.T52` Ejecutar siguiente iteración técnica post-release `6.3.31`: ampliar la suite contractual multi-repo con fixture adicional y cobertura de regresión.
+  - cierre ejecutado:
+    - issue creada y cerrada: `#557`.
+    - rama técnica creada y mergeada: `feature/557-contract-suite-repeat-profile` -> `#558` (`https://github.com/SwiftEnProfundidad/ast-intelligence-hooks/pull/558`).
+    - commit de merge en `develop`: `5f0302c`.
+  - evidencia:
+    - `npx --yes tsx@4.21.0 --test scripts/__tests__/enterprise-contract-suite-contract.test.ts scripts/__tests__/enterprise-contract-suite-args-lib.test.ts scripts/__tests__/enterprise-contract-suite-report-lib.test.ts`
+    - `npm run -s typecheck`
+    - `npm run -s validation:contract-suite:enterprise -- --json`
+    - `npm run -s validation:tracking-single-active`
+
+- ✅ `P12.F2.T53` Publicar patch release con la ampliación de suite contractual (`#557`) y dejar disponibilidad inmediata para consumidores.
+  - cierre ejecutado:
+    - rama release creada y mergeada: `release/6.3.32` -> `#560` (`https://github.com/SwiftEnProfundidad/ast-intelligence-hooks/pull/560`).
+    - publicación npm completada: `pumuki@6.3.32`.
+  - evidencia:
+    - `npx --yes tsx@4.21.0 --test scripts/__tests__/enterprise-contract-suite-contract.test.ts scripts/__tests__/enterprise-contract-suite-args-lib.test.ts scripts/__tests__/enterprise-contract-suite-report-lib.test.ts`
+    - `npm run -s typecheck`
+    - `npm run -s validation:contract-suite:enterprise -- --json`
+    - `npm run -s validation:package-manifest`
+    - `npm publish --access public`
+    - `npm view pumuki version` => `6.3.32`
+
+- ✅ `P12.F2.T54` Ejecutar siguiente mejora estratégica: contrato explícito de compatibilidad (pumuki/openspec/hooks/adapters) con validación automática en `doctor`.
+  - cierre ejecutado:
+    - issue creada y cerrada: `#562`.
+    - rama técnica creada y mergeada: `feature/562-doctor-deep-compatibility-contract` -> `#563` (`https://github.com/SwiftEnProfundidad/ast-intelligence-hooks/pull/563`).
+    - commit de merge en `develop`: `a1df815`.
+  - evidencia:
+    - `npx --yes tsx@4.21.0 --test integrations/lifecycle/__tests__/doctor.test.ts integrations/lifecycle/__tests__/cli.test.ts`
+    - `npm run -s typecheck`
+    - `npm run -s validation:contract-suite:enterprise -- --json`
+    - `npm run -s validation:tracking-single-active`
+
+- 🚧 `P12.F2.T55` Publicar patch release con el contrato de compatibilidad de `doctor --deep` ya mergeado en `#563`.
   - salida esperada:
-    - versión npm publicada con el MVP de suite contractual multi-repo.
-    - canónico RuralGO y master plan alineados con refs de release.
-    - estado operativo preparado para siguiente bloque de mejoras.
+    - issue de release creada con alcance/doD verificable (`#565`).
+    - versión npm nueva publicada con el fix de `#562`.
+    - trazabilidad cerrada en plan activo + registro maestro con evidencia de publicación.
 
 Criterio de salida F6:
 - veredicto final trazable y cierre administrativo completo.

package/integrations/lifecycle/doctor.ts

@@ -6,6 +6,11 @@ import { getPumukiHooksStatus } from './hookManager';
 import { LifecycleGitService, type ILifecycleGitService } from './gitService';
 import { getCurrentPumukiVersion } from './packageInfo';
 import { readLifecycleState, type LifecycleState } from './state';
+import {
+  detectOpenSpecInstallation,
+  evaluateOpenSpecCompatibility,
+  isOpenSpecProjectInitialized,
+} from '../sdd/openSpecCli';
 
 export type DoctorIssueSeverity = 'warning' | 'error';
 
@@ -18,7 +23,8 @@ export type DoctorDeepCheckId =
   | 'upstream-readiness'
   | 'adapter-wiring'
   | 'policy-drift'
-  | 'evidence-source-drift';
+  | 'evidence-source-drift'
+  | 'compatibility-contract';
 
 export type DoctorDeepCheck = {
   id: DoctorDeepCheckId;
@@ -33,6 +39,30 @@ export type DoctorDeepReport = {
   enabled: true;
   checks: ReadonlyArray<DoctorDeepCheck>;
   blocking: boolean;
+  contract: DoctorCompatibilityContract;
+};
+
+export type DoctorCompatibilityContract = {
+  overall: 'compatible' | 'incompatible';
+  pumuki: {
+    installed: boolean;
+    version: string;
+  };
+  openspec: {
+    required: boolean;
+    installed: boolean;
+    version: string | null;
+    minimumVersion: string;
+    compatible: boolean;
+  };
+  hooks: {
+    managed: boolean;
+    managedCount: number;
+    totalCount: number;
+  };
+  adapter: {
+    valid: boolean;
+  };
 };
 
 export type LifecycleDoctorReport = {
@@ -457,21 +487,128 @@ const evaluateEvidenceSourceDriftCheck = (params: {
   });
 };
 
+const buildCompatibilityContract = (params: {
+  repoRoot: string;
+  lifecycleState: LifecycleState;
+  hookStatus: ReturnType<typeof getPumukiHooksStatus>;
+  adapterCheck: DoctorDeepCheck;
+}): DoctorCompatibilityContract => {
+  const hooks = Object.values(params.hookStatus);
+  const managedCount = hooks.filter((entry) => entry.managedBlockPresent).length;
+  const totalCount = hooks.length;
+  const hooksManaged = totalCount > 0 && managedCount === totalCount;
+
+  const openSpecRequired = isOpenSpecProjectInitialized(params.repoRoot);
+  const openSpecInstalled = detectOpenSpecInstallation(params.repoRoot);
+  const openSpecCompatibility = evaluateOpenSpecCompatibility(openSpecInstalled);
+  const openSpecCompatible = openSpecRequired ? openSpecCompatibility.compatible : true;
+
+  const adapterValid = params.adapterCheck.status === 'pass';
+  const pumukiInstalled = params.lifecycleState.installed === 'true';
+  const overallCompatible =
+    pumukiInstalled && hooksManaged && adapterValid && openSpecCompatible;
+
+  return {
+    overall: overallCompatible ? 'compatible' : 'incompatible',
+    pumuki: {
+      installed: pumukiInstalled,
+      version: getCurrentPumukiVersion(),
+    },
+    openspec: {
+      required: openSpecRequired,
+      installed: openSpecInstalled.installed,
+      version: openSpecInstalled.version ?? null,
+      minimumVersion: openSpecCompatibility.minimumVersion,
+      compatible: openSpecCompatible,
+    },
+    hooks: {
+      managed: hooksManaged,
+      managedCount,
+      totalCount,
+    },
+    adapter: {
+      valid: adapterValid,
+    },
+  };
+};
+
+const evaluateCompatibilityContractCheck = (
+  contract: DoctorCompatibilityContract
+): DoctorDeepCheck => {
+  if (contract.overall === 'compatible') {
+    return buildDeepCheck({
+      id: 'compatibility-contract',
+      status: 'pass',
+      severity: 'info',
+      message: 'Compatibility contract is satisfied for pumuki/openspec/hooks/adapter.',
+      metadata: {
+        pumuki_installed: contract.pumuki.installed,
+        openspec_required: contract.openspec.required,
+        openspec_compatible: contract.openspec.compatible,
+        hooks_managed: contract.hooks.managed,
+        adapter_valid: contract.adapter.valid,
+      },
+    });
+  }
+
+  const remediation: string[] = [];
+  if (!contract.pumuki.installed) {
+    remediation.push('Run "pumuki install" to restore lifecycle state.');
+  }
+  if (!contract.hooks.managed) {
+    remediation.push('Regenerate managed hooks with "pumuki install".');
+  }
+  if (!contract.adapter.valid) {
+    remediation.push('Repair adapter wiring with "pumuki adapter install --agent=codex".');
+  }
+  if (contract.openspec.required && !contract.openspec.compatible) {
+    remediation.push(
+      `Install or upgrade OpenSpec to >= ${contract.openspec.minimumVersion} before enterprise validation.`
+    );
+  }
+
+  return buildDeepCheck({
+    id: 'compatibility-contract',
+    status: 'fail',
+    severity: 'warning',
+    message: 'Compatibility contract is not satisfied for one or more required components.',
+    remediation: remediation.join(' '),
+    metadata: {
+      pumuki_installed: contract.pumuki.installed,
+      openspec_required: contract.openspec.required,
+      openspec_compatible: contract.openspec.compatible,
+      hooks_managed: contract.hooks.managed,
+      adapter_valid: contract.adapter.valid,
+    },
+  });
+};
+
 const buildDoctorDeepReport = (params: {
   git: ILifecycleGitService;
   repoRoot: string;
+  lifecycleState: LifecycleState;
+  hookStatus: ReturnType<typeof getPumukiHooksStatus>;
 }): DoctorDeepReport => {
+  const adapterCheck = evaluateAdapterWiringCheck(params.repoRoot);
+  const compatibilityContract = buildCompatibilityContract({
+    repoRoot: params.repoRoot,
+    lifecycleState: params.lifecycleState,
+    hookStatus: params.hookStatus,
+    adapterCheck,
+  });
+
   const checks: DoctorDeepCheck[] = [
     evaluateUpstreamReadinessCheck({
       git: params.git,
       repoRoot: params.repoRoot,
     }),
-    evaluateAdapterWiringCheck(params.repoRoot),
+    adapterCheck,
     evaluatePolicyDriftCheck(params.repoRoot),
     evaluateEvidenceSourceDriftCheck({
       git: params.git,
       repoRoot: params.repoRoot,
     }),
+    evaluateCompatibilityContractCheck(compatibilityContract),
   ];
 
   return {
@@ -480,6 +617,7 @@ const buildDoctorDeepReport = (params: {
     blocking: checks.some(
       (check) => check.status === 'fail' && check.severity === 'error'
     ),
+    contract: compatibilityContract,
   };
 };
 
@@ -504,6 +642,8 @@ export const runLifecycleDoctor = (params?: {
     ? buildDoctorDeepReport({
       git,
       repoRoot,
+      lifecycleState,
+      hookStatus,
     })
     : undefined;
 

package/package.json

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

package/scripts/enterprise-contract-suite-contract.ts

@@ -1,4 +1,4 @@
-export type EnterpriseContractProfileId = 'minimal' | 'block';
+export type EnterpriseContractProfileId = 'minimal' | 'block' | 'minimal-repeat';
 
 export type EnterpriseContractProfileSpec = {
   id: EnterpriseContractProfileId;
@@ -29,3 +29,21 @@ export type EnterpriseContractSuiteOptions = {
   summaryPath: string;
   printJson: boolean;
 };
+
+export const resolveEnterpriseContractProfiles = (): ReadonlyArray<EnterpriseContractProfileSpec> => [
+  {
+    id: 'minimal',
+    mode: 'minimal',
+    expectedExitCode: 1,
+  },
+  {
+    id: 'block',
+    mode: 'block',
+    expectedExitCode: 0,
+  },
+  {
+    id: 'minimal-repeat',
+    mode: 'minimal',
+    expectedExitCode: 1,
+  },
+];

package/scripts/run-enterprise-contract-suite.ts

@@ -8,27 +8,13 @@ import {
   renderEnterpriseContractSummary,
 } from './enterprise-contract-suite-report-lib';
 import type {
-  EnterpriseContractProfileResult,
   EnterpriseContractProfileSpec,
+  EnterpriseContractProfileResult,
 } from './enterprise-contract-suite-contract';
+import { resolveEnterpriseContractProfiles } from './enterprise-contract-suite-contract';
 import { ensureDirectory } from './package-install-smoke-file-lib';
 import { runCommand } from './package-install-smoke-command-lib';
 
-const PROFILE_SPECS: ReadonlyArray<EnterpriseContractProfileSpec> = [
-  {
-    id: 'minimal',
-    mode: 'minimal',
-    // The minimal fixture intentionally omits platform skill contracts to assert strict governance blocking.
-    expectedExitCode: 1,
-  },
-  {
-    id: 'block',
-    mode: 'block',
-    // The block fixture is expected to complete successfully as a deterministic BLOCK smoke scenario.
-    expectedExitCode: 0,
-  },
-];
-
 const runProfile = (
   repoRoot: string,
   profile: EnterpriseContractProfileSpec
@@ -58,7 +44,9 @@ const writeTextFile = (repoRoot: string, relativePath: string, content: string):
 
 const main = (): number => {
   const options = parseEnterpriseContractSuiteArgs(process.argv.slice(2));
-  const results = PROFILE_SPECS.map((profile) => runProfile(options.repoRoot, profile));
+  const results = resolveEnterpriseContractProfiles().map((profile) =>
+    runProfile(options.repoRoot, profile)
+  );
 
   const report = buildEnterpriseContractReport({
     repoRoot: options.repoRoot,