pumuki 6.3.113 → 6.3.115

package/integrations/mcp/preFlightCheck.ts

@@ -1,16 +1,11 @@
-import {
-  resolveGovernanceCatalogAction,
-  type GovernanceCatalogNextAction,
-} from '../gate/governanceActionCatalog';
 import { evaluateAiGate, type AiGateStage, type AiGateViolation } from '../gate/evaluateAiGate';
 import { collectWorktreeAtomicSlices } from '../git/worktreeAtomicSlices';
-import { readLifecyclePolicyValidationSnapshot } from '../lifecycle/policyValidationSnapshot';
 import { resolveLearningContextExperimentalFeature } from '../policy/experimentalFeatures';
-import { resolvePreWriteEnforcement } from '../policy/preWriteEnforcement';
 import { readSddLearningContext, type SddLearningContext } from '../sdd/learningInsights';
 
 const ACTIONABLE_HINTS_BY_CODE: Readonly<Record<string, string>> = {
-  EVIDENCE_MISSING: 'Ejecuta una auditoría (1/2/3/4) para regenerar .ai_evidence.json.',
+  EVIDENCE_MISSING:
+    'Ejecuta una auditoría (1/2/3/4 u opciones de motor 11–14) para regenerar .ai_evidence.json.',
   EVIDENCE_INVALID: 'Regenera .ai_evidence.json desde una opción de auditoría.',
   EVIDENCE_INTEGRITY_MISSING: 'Refresca evidencia para regenerar metadatos de integridad.',
   EVIDENCE_ACTIVE_RULE_IDS_EMPTY_FOR_CODE_CHANGES:
@@ -44,28 +39,6 @@ const ACTIONABLE_HINTS_BY_CODE: Readonly<Record<string, string>> = {
     'Mapea todas las reglas AUTO a detectores AST antes de continuar.',
   EVIDENCE_TIMESTAMP_FUTURE: 'Corrige la hora del sistema y regenera evidencia.',
   GITFLOW_PROTECTED_BRANCH: 'Evita trabajo directo en ramas protegidas (usa feature/*).',
-  GITFLOW_BRANCH_NAMING_INVALID:
-    'La rama actual no cumple GitFlow. Usa feature/*, bugfix/*, hotfix/*, release/*, chore/*, refactor/* o docs/*.',
-  TRACKING_CANONICAL_SOURCE_CONFLICT:
-    'AGENTS.md y los README del repo no apuntan a la misma fuente canónica de tracking.',
-  TRACKING_CANONICAL_FILE_MISSING:
-    'El repo declara un MD de tracking canónico que ahora mismo no existe.',
-  TRACKING_CANONICAL_IN_PROGRESS_INVALID:
-    'El MD canónico de tracking debe dejar exactamente una task o fase en construcción.',
-};
-
-const normalizeGovernanceCatalogCode = (code: string): string => {
-  switch (code) {
-    case 'EVIDENCE_INVALID':
-    case 'EVIDENCE_CHAIN_INVALID':
-      return 'EVIDENCE_INVALID_OR_CHAIN';
-    case 'GITFLOW_PROTECTED_BRANCH':
-      return 'GITFLOW_PROTECTED_BRANCH_CONTEXT';
-    case 'GITFLOW_BRANCH_NAMING_INVALID':
-      return 'GITFLOW_BRANCH_NAMING_INVALID_CONTEXT';
-    default:
-      return code;
-  }
 };
 
 const buildPreFlightHints = (params: {
@@ -142,14 +115,6 @@ export type EnterprisePreFlightCheckResult = {
     phase: 'GREEN' | 'RED';
     message: string;
     instruction: string;
-    reason_code: string;
-    prewrite_effective: {
-      mode: ReturnType<typeof resolvePreWriteEnforcement>['mode'];
-      source: ReturnType<typeof resolvePreWriteEnforcement>['source'];
-      blocking: boolean;
-      strict_policy: boolean;
-    };
-    next_action: GovernanceCatalogNextAction;
     stage: ReturnType<typeof evaluateAiGate>['stage'];
     policy: ReturnType<typeof evaluateAiGate>['policy'];
     violations: ReturnType<typeof evaluateAiGate>['violations'];
@@ -180,8 +145,6 @@ export const runEnterprisePreFlightCheck = (params: {
     : readSddLearningContext({
       repoRoot: params.repoRoot,
     });
-  const preWriteEnforcement = resolvePreWriteEnforcement();
-  const policyValidation = readLifecyclePolicyValidationSnapshot(params.repoRoot);
 
   const hints = buildPreFlightHints({
     repoRoot: params.repoRoot,
@@ -191,30 +154,13 @@ export const runEnterprisePreFlightCheck = (params: {
     upstream: evaluation.repo_state.git.upstream,
     learningContext,
   });
-  const firstViolation = evaluation.violations[0];
-  const reasonCode = firstViolation?.code ?? 'READY';
-  const governanceAction = firstViolation
-    ? resolveGovernanceCatalogAction({
-      code: normalizeGovernanceCatalogCode(firstViolation.code),
-      stage: evaluation.stage,
-    })
-    : resolveGovernanceCatalogAction({
-      code: 'READY',
-      stage: evaluation.stage,
-    });
   const phase: 'GREEN' | 'RED' = evaluation.allowed ? 'GREEN' : 'RED';
   const message = evaluation.allowed
     ? '✅ Pre-flight aprobado: puedes continuar con la implementación.'
-    : `🔴 Pre-flight bloqueado: corrige ${reasonCode} y vuelve a ejecutar.`;
-  const instruction = !firstViolation && evaluation.allowed
+    : `🔴 Pre-flight bloqueado: corrige ${evaluation.violations[0]?.code ?? 'la causa'} y vuelve a ejecutar.`;
+  const instruction = evaluation.allowed
     ? 'Implementa el cambio mínimo para pasar en verde y vuelve a validar.'
-    : governanceAction.instruction;
-  const nextAction: GovernanceCatalogNextAction = evaluation.allowed
-    ? {
-      kind: 'info',
-      message: governanceAction.next_action.message,
-    }
-    : governanceAction.next_action;
+    : hints[0] ?? 'Corrige la causa bloqueante y vuelve a ejecutar el pre-flight.';
 
   return {
     tool: 'pre_flight_check',
@@ -227,14 +173,6 @@ export const runEnterprisePreFlightCheck = (params: {
       phase,
       message,
       instruction,
-      reason_code: reasonCode,
-      prewrite_effective: {
-        mode: preWriteEnforcement.mode,
-        source: preWriteEnforcement.source,
-        blocking: preWriteEnforcement.blocking,
-        strict_policy: policyValidation.stages.PRE_WRITE.strict,
-      },
-      next_action: nextAction,
       stage: evaluation.stage,
       policy: evaluation.policy,
       violations: evaluation.violations,

package/integrations/platform/detectPlatforms.ts

@@ -51,6 +51,38 @@ const collectFilePaths = (facts: ReadonlyArray<Fact>): string[] => {
     .filter((path): path is string => typeof path === 'string');
 };
 
+const ALLOWED_PIN_KEYS = new Set(['ios', 'android', 'backend', 'frontend']);
+
+const readPinnedPlatformsFromEnv = (): ReadonlySet<keyof DetectedPlatforms> | null => {
+  const raw = process.env.PUMUKI_PIN_PLATFORMS?.trim().toLowerCase();
+  if (!raw) {
+    return null;
+  }
+  const tokens = raw
+    .split(',')
+    .map((token) => token.trim())
+    .filter((token) => token.length > 0)
+    .filter((token) => ALLOWED_PIN_KEYS.has(token)) as Array<keyof DetectedPlatforms>;
+  if (tokens.length === 0) {
+    return null;
+  }
+  return new Set(tokens);
+};
+
+const applyPinnedPlatformsFilter = (
+  detected: DetectedPlatforms,
+  pin: ReadonlySet<keyof DetectedPlatforms>
+): DetectedPlatforms => {
+  const next: DetectedPlatforms = {};
+  for (const key of pin) {
+    const state = detected[key];
+    if (state) {
+      next[key] = state;
+    }
+  }
+  return next;
+};
+
 export const detectPlatformsFromFacts = (
   facts: ReadonlyArray<Fact>
 ): DetectedPlatforms => {
@@ -102,5 +134,10 @@ export const detectPlatformsFromFacts = (
     };
   }
 
+  const pin = readPinnedPlatformsFromEnv();
+  if (pin && pin.size > 0) {
+    return applyPinnedPlatformsFilter(result, pin);
+  }
+
   return result;
 };

package/integrations/sdd/policy.ts

@@ -14,6 +14,7 @@ import {
 } from './sessionStore';
 import type { ILifecycleGitService } from '../lifecycle/gitService';
 import { resolveDegradedMode } from '../gate/degradedMode';
+import { getCurrentPumukiVersion } from '../lifecycle/packageInfo';
 import { resolveSddCompletenessEnforcement } from '../policy/sddCompletenessEnforcement';
 import { resolveSddExperimentalFeature } from '../policy/experimentalFeatures';
 import type {
@@ -23,16 +24,20 @@ import type {
   SddStatusPayload,
 } from './types';
 
-const SDD_SESSION_REFRESH_COMMAND =
-  'npx --yes --package pumuki@latest pumuki sdd session --refresh --ttl-minutes=90';
-const SDD_SESSION_OPEN_AUTO_COMMAND =
-  'npx --yes --package pumuki@latest pumuki sdd session --open --change=auto';
-const SDD_SESSION_OPEN_EXPLICIT_COMMAND =
-  'npx --yes --package pumuki@latest pumuki sdd session --open --change=<id>';
 const SDD_COMPLETENESS_CONTRACT_VERSION = '1.0';
 
-const buildSddExperimentalEnableCommand = (stage: SddStage): string =>
-  `PUMUKI_EXPERIMENTAL_SDD=advisory npx --yes --package pumuki@latest pumuki sdd validate --stage=${stage} --json`;
+const buildPinnedPumukiNpxCommand = (version: string): string =>
+  `npx --yes --package pumuki@${version} pumuki`;
+const buildSddSessionRefreshCommand = (repoRoot: string): string =>
+  `${buildPinnedPumukiNpxCommand(getCurrentPumukiVersion({ repoRoot }))} sdd session --refresh --ttl-minutes=90`;
+const buildSddSessionOpenAutoCommand = (repoRoot: string): string =>
+  `${buildPinnedPumukiNpxCommand(getCurrentPumukiVersion({ repoRoot }))} sdd session --open --change=auto`;
+const buildSddSessionOpenExplicitCommand = (repoRoot: string): string =>
+  `${buildPinnedPumukiNpxCommand(getCurrentPumukiVersion({ repoRoot }))} sdd session --open --change=<id>`;
+const buildSddExperimentalEnableCommand = (stage: SddStage, repoRoot: string): string =>
+  `PUMUKI_EXPERIMENTAL_SDD=advisory ${buildPinnedPumukiNpxCommand(
+    getCurrentPumukiVersion({ repoRoot })
+  )} sdd validate --stage=${stage} --json`;
 
 const resolveMissingSessionGuidance = (repoRoot: string): {
   message: string;
@@ -41,15 +46,17 @@ const resolveMissingSessionGuidance = (repoRoot: string): {
   suggestedChangeId?: string;
   availableChangeIds: ReadonlyArray<string>;
 } => {
+  const sessionOpenAutoCommand = buildSddSessionOpenAutoCommand(repoRoot);
+  const sessionOpenExplicitCommand = buildSddSessionOpenExplicitCommand(repoRoot);
   const availableChangeIds = listActiveOpenSpecChangeIds(repoRoot);
   if (availableChangeIds.length === 1) {
     const suggestedChangeId = availableChangeIds[0] ?? '';
     const command =
-      `npx --yes --package pumuki@latest pumuki sdd session --open --change=${suggestedChangeId}`;
+      `${buildPinnedPumukiNpxCommand(getCurrentPumukiVersion({ repoRoot }))} sdd session --open --change=${suggestedChangeId}`;
     return {
       message: `SDD session is not active. Run \`${command}\` and retry.`,
       command,
-      fallbackCommand: SDD_SESSION_OPEN_AUTO_COMMAND,
+      fallbackCommand: sessionOpenAutoCommand,
       suggestedChangeId,
       availableChangeIds,
     };
@@ -57,17 +64,17 @@ const resolveMissingSessionGuidance = (repoRoot: string): {
   if (availableChangeIds.length > 1) {
     return {
       message:
-        `SDD session is not active. Run \`${SDD_SESSION_OPEN_EXPLICIT_COMMAND}\` ` +
+        `SDD session is not active. Run \`${sessionOpenExplicitCommand}\` ` +
         `with one active change id. Active changes: ${availableChangeIds.join(', ')}.`,
-      command: SDD_SESSION_OPEN_EXPLICIT_COMMAND,
-      fallbackCommand: SDD_SESSION_OPEN_EXPLICIT_COMMAND,
+      command: sessionOpenExplicitCommand,
+      fallbackCommand: sessionOpenExplicitCommand,
       availableChangeIds,
     };
   }
   return {
-    message: `SDD session is not active. Run \`${SDD_SESSION_OPEN_AUTO_COMMAND}\` and retry.`,
-    command: SDD_SESSION_OPEN_AUTO_COMMAND,
-    fallbackCommand: SDD_SESSION_OPEN_AUTO_COMMAND,
+    message: `SDD session is not active. Run \`${sessionOpenAutoCommand}\` and retry.`,
+    command: sessionOpenAutoCommand,
+    fallbackCommand: sessionOpenAutoCommand,
     availableChangeIds,
   };
 };
@@ -182,8 +189,9 @@ const evaluateSessionRequirements = (params: {
     );
   }
   if (!status.session.valid || !status.session.changeId) {
+    const refreshCommand = buildSddSessionRefreshCommand(params.repoRoot);
     const details: Record<string, string | boolean> = {
-      command: SDD_SESSION_REFRESH_COMMAND,
+      command: refreshCommand,
       autoRefreshEnabled: params.autoRefreshEnabled,
       autoRefreshAttempted: params.autoRefreshAttempted,
     };
@@ -192,8 +200,8 @@ const evaluateSessionRequirements = (params: {
     }
     const message =
       params.autoRefreshAttempted && params.autoRefreshError
-        ? `SDD session is invalid or expired. Auto-refresh failed (${params.autoRefreshError}). Run \`${SDD_SESSION_REFRESH_COMMAND}\` or reopen it.`
-        : `SDD session is invalid or expired. Run \`${SDD_SESSION_REFRESH_COMMAND}\` or reopen it.`;
+        ? `SDD session is invalid or expired. Auto-refresh failed (${params.autoRefreshError}). Run \`${refreshCommand}\` or reopen it.`
+        : `SDD session is invalid or expired. Run \`${refreshCommand}\` or reopen it.`;
     return blocked(
       'SDD_SESSION_INVALID',
       message,
@@ -327,7 +335,7 @@ export const evaluateSddPolicy = (params: {
           experimentalSource: sddExperimentalFeature.source,
           activation_env: sddExperimentalFeature.activationVariable,
           legacy_activation_env: sddExperimentalFeature.legacyActivationVariable,
-          activation_command: buildSddExperimentalEnableCommand(params.stage),
+          activation_command: buildSddExperimentalEnableCommand(params.stage, params.repoRoot),
         },
       },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki",
-  "version": "6.3.113",
+  "version": "6.3.115",
   "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/check-tracking-single-active.sh

@@ -31,7 +31,7 @@ for FILE in "${FILES[@]}"; do
   fi
 
   if [[ "${FILE}" == "PUMUKI-RESET-MASTER-PLAN.md" ]]; then
-    ACTIVE_PATTERN='(^- Estado:\s*🚧(?:\s|$))|(^`?\[\s*🚧\s*\]\s*-`?)|(^\|\s*[^|]+\|\s*`?\[\s*🚧\s*\]\s*-`?)|(^\|\s*🚧(?:\s|\|))'
+    ACTIVE_PATTERN='^- Estado: 🚧'
   else
     ACTIVE_PATTERN='^- 🚧 (`?P[0-9A-Za-z.-]+`?)'
   fi

package/scripts/consumer-menu-matrix-baseline-report-lib.ts

@@ -4,10 +4,11 @@ import type {
   ConsumerMenuMatrixReport,
   MatrixOptionId,
 } from './framework-menu-matrix-baseline-lib';
+import { MATRIX_MENU_OPTION_IDS } from './framework-menu-matrix-evidence-lib';
 import type { DoctorDeepCheckLayer, LifecycleDoctorReport } from '../integrations/lifecycle/doctor';
 import type { LifecycleStatus } from '../integrations/lifecycle/status';
 
-const OPTION_IDS: ReadonlyArray<MatrixOptionId> = ['1', '2', '3', '4', '9'];
+const OPTION_IDS: ReadonlyArray<MatrixOptionId> = [...MATRIX_MENU_OPTION_IDS];
 const DOCTOR_LAYERS: ReadonlyArray<DoctorDeepCheckLayer> = [
   'core',
   'operational',
@@ -51,45 +52,19 @@ export type ConsumerMenuMatrixBaselineSnapshot = {
   };
 };
 
+const UNKNOWN_OPTION_REPORT = {
+  stage: 'UNKNOWN',
+  outcome: 'UNKNOWN',
+  filesScanned: 0,
+  totalViolations: 0,
+  diagnosis: 'unknown' as const,
+};
+
 const buildEmptyRound = (): ConsumerMenuMatrixReport => {
   return {
-    byOption: {
-      '1': {
-        stage: 'UNKNOWN',
-        outcome: 'UNKNOWN',
-        filesScanned: 0,
-        totalViolations: 0,
-        diagnosis: 'unknown',
-      },
-      '2': {
-        stage: 'UNKNOWN',
-        outcome: 'UNKNOWN',
-        filesScanned: 0,
-        totalViolations: 0,
-        diagnosis: 'unknown',
-      },
-      '3': {
-        stage: 'UNKNOWN',
-        outcome: 'UNKNOWN',
-        filesScanned: 0,
-        totalViolations: 0,
-        diagnosis: 'unknown',
-      },
-      '4': {
-        stage: 'UNKNOWN',
-        outcome: 'UNKNOWN',
-        filesScanned: 0,
-        totalViolations: 0,
-        diagnosis: 'unknown',
-      },
-      '9': {
-        stage: 'UNKNOWN',
-        outcome: 'UNKNOWN',
-        filesScanned: 0,
-        totalViolations: 0,
-        diagnosis: 'unknown',
-      },
-    },
+    byOption: Object.fromEntries(
+      MATRIX_MENU_OPTION_IDS.map((id) => [id, { ...UNKNOWN_OPTION_REPORT }])
+    ) as ConsumerMenuMatrixReport['byOption'],
   };
 };
 

package/scripts/consumer-postinstall-resolve-args.cjs

@@ -0,0 +1,44 @@
+'use strict';
+
+const KNOWN_MCP_AGENTS = new Set(['cursor', 'codex', 'claude', 'repo']);
+
+const normalizeExplicitAgent = (raw) => {
+  const trimmed = (raw ?? '').trim();
+  if (!trimmed) {
+    return '';
+  }
+  const lower = trimmed.toLowerCase();
+  if (lower === '0' || lower === 'none' || lower === 'false') {
+    return '';
+  }
+  if (!KNOWN_MCP_AGENTS.has(lower)) {
+    return '';
+  }
+  return lower;
+};
+
+const resolveConsumerPostinstallInstallExtras = (_consumerRoot, env = process.env) => {
+  if (env.PUMUKI_POSTINSTALL_SKIP_MCP === '1') {
+    return { extras: [], reason: 'skip_mcp' };
+  }
+  const withMcpFlag =
+    env.PUMUKI_POSTINSTALL_WITH_MCP === '1' ||
+    env.PUMUKI_POSTINSTALL_WITH_MCP?.toLowerCase() === 'true';
+  const explicit = normalizeExplicitAgent(env.PUMUKI_POSTINSTALL_MCP_AGENT);
+  if (explicit) {
+    return { extras: ['--with-mcp', `--agent=${explicit}`], reason: 'explicit_agent' };
+  }
+  if (withMcpFlag) {
+    return { extras: ['--with-mcp', '--agent=repo'], reason: 'explicit_repo_flag' };
+  }
+  return {
+    extras: [],
+    reason: 'disabled_default',
+  };
+};
+
+module.exports = {
+  KNOWN_MCP_AGENTS,
+  resolveConsumerPostinstallInstallExtras,
+  normalizeExplicitAgent,
+};

package/scripts/consumer-postinstall.cjs

@@ -4,56 +4,111 @@
 const { existsSync } = require('node:fs');
 const { join, resolve } = require('node:path');
 const { spawnSync } = require('node:child_process');
+const { resolveConsumerPostinstallInstallExtras } = require('./consumer-postinstall-resolve-args.cjs');
 
-const skipReason = () => {
-  if (process.env.PUMUKI_SKIP_POSTINSTALL === '1') {
+const skipReason = (env = process.env) => {
+  if (env.PUMUKI_SKIP_POSTINSTALL === '1') {
     return 'PUMUKI_SKIP_POSTINSTALL=1';
   }
-  if (process.env.CI === 'true' || process.env.CI === '1') {
+  if (env.CI === 'true' || env.CI === '1') {
     return 'CI';
   }
-  if (process.env.npm_config_ignore_scripts === 'true') {
+  if (env.npm_config_ignore_scripts === 'true') {
     return 'npm ignore-scripts';
   }
   return '';
 };
 
-const main = () => {
-  const reason = skipReason();
+const normalizePumukiInstallResult = (result) => {
+  if (result.error) {
+    return {
+      code: 1,
+      errorMessage: result.error.message ?? String(result.error),
+    };
+  }
+
+  return { code: typeof result.status === 'number' ? result.status : 1, errorMessage: null };
+};
+
+const runPostinstall = ({
+  spawnSyncFn = spawnSync,
+  packageRoot = resolve(__dirname, '..'),
+  consumerRoot = process.env.INIT_CWD || process.cwd(),
+  env = process.env,
+  logger = console,
+} = {}) => {
+  const reason = skipReason(env);
   if (reason) {
     return 0;
   }
 
-  const consumerRoot = process.env.INIT_CWD || process.cwd();
   if (!existsSync(join(consumerRoot, '.git'))) {
     return 0;
   }
 
-  const packageRoot = resolve(__dirname, '..');
   const pumukiCli = join(packageRoot, 'bin', 'pumuki.js');
   if (!existsSync(pumukiCli)) {
     return 0;
   }
 
-  const env = {
-    ...process.env,
+  const postinstallEnv = {
+    ...env,
     PUMUKI_AUTO_POSTINSTALL: '1',
-    PUMUKI_SKIP_OPENSPEC_BOOTSTRAP: process.env.PUMUKI_SKIP_OPENSPEC_BOOTSTRAP ?? '1',
+    PUMUKI_SKIP_OPENSPEC_BOOTSTRAP: env.PUMUKI_SKIP_OPENSPEC_BOOTSTRAP ?? '1',
   };
 
-  const result = spawnSync(process.execPath, [pumukiCli, 'install'], {
-    cwd: consumerRoot,
-    env,
-    stdio: 'inherit',
-  });
+  const { extras: installExtras, reason: mcpReason } = resolveConsumerPostinstallInstallExtras(
+    consumerRoot,
+    postinstallEnv
+  );
+  if (installExtras.length > 0 && postinstallEnv.PUMUKI_VERBOSE_INSTALL === '1') {
+    logger.debug(
+      `[pumuki] postinstall: mcp wiring (${mcpReason}): ${installExtras.join(' ')}`
+    );
+  }
+
+  if (installExtras.length === 0 && postinstallEnv.PUMUKI_VERBOSE_INSTALL === '1') {
+    logger.debug('[pumuki] postinstall: no extra args; running baseline install only.');
+  }
+
+  const result = normalizePumukiInstallResult(
+    spawnSyncFn(process.execPath, [pumukiCli, 'install', ...installExtras], {
+      cwd: consumerRoot,
+      env: postinstallEnv,
+      stdio: 'inherit',
+    })
+  );
 
-  const code = typeof result.status === 'number' ? result.status : 1;
-  if (code !== 0) {
-    console.error(
-      '[pumuki] postinstall: `pumuki install` exited non-zero; npm install will still succeed. Run `npx pumuki install` or `npx pumuki doctor` from the repo root.'
+  if (result.code !== 0) {
+    const scope = installExtras.length > 0 ? 'postinstall+extras' : 'postinstall';
+    const severityHint =
+      installExtras.length > 0
+        ? 'Run `pumuki install` manually with the desired options to investigar y resolver el fallo.'
+        : 'Run `pumuki install` o `pumuki doctor` desde la raíz del repo.';
+    logger.error(
+      `[pumuki] postinstall: install exited non-zero (scope=${scope}, reason=${mcpReason}). ${severityHint}`
     );
+    if (result.errorMessage) {
+      logger.error(`[pumuki] postinstall: ${result.errorMessage}`);
+    }
   }
-  return 0;
+
+  return result.code;
+};
+
+const main = () => {
+  return runPostinstall({
+    spawnSyncFn: spawnSync,
+    packageRoot: resolve(__dirname, '..'),
+    consumerRoot: process.env.INIT_CWD || process.cwd(),
+    env: process.env,
+    logger: console,
+  });
 };
 
 process.exitCode = main();
+
+module.exports = {
+  runPostinstall,
+  skipReason,
+};

package/scripts/framework-menu-advanced-view-lib.ts

@@ -19,47 +19,20 @@ import {
   renderActionRow,
   renderBadge,
 } from './framework-menu-ui-components-lib';
-import {
-  buildGovernanceConsoleSummaryLines,
-  type GovernanceConsoleSnapshot,
-} from '../integrations/lifecycle/cliGovernanceConsole';
-import type { ConsumerPreflightResult } from './framework-menu-consumer-preflight-types';
 
 export const formatAdvancedMenuView = (
   actions: ReadonlyArray<MenuAction>,
   options?: {
     evidenceSummary?: FrameworkMenuEvidenceSummary;
-    preflight?: ConsumerPreflightResult | null;
-    governanceConsole?: GovernanceConsoleSnapshot | null;
   }
 ): string => {
   const evidenceSummary = options?.evidenceSummary ?? readEvidenceSummaryForMenu(process.cwd());
   const tokens = buildCliDesignTokens();
   const statusBadge = resolveAdvancedStatusBadge(evidenceSummary, tokens);
   const groupedActions = resolveAdvancedMenuLayout(actions);
-  const governanceConsole = options?.preflight
-    ? {
-      governanceObservation: options.preflight.governanceObservation,
-      governanceNextAction: options.preflight.governanceNextAction,
-      policyValidation: options.preflight.policyValidation,
-      experimentalFeatures: options.preflight.experimentalFeatures,
-    }
-    : (options?.governanceConsole ?? null);
   const lines = [
     'Pumuki Framework Menu (Advanced)',
     `Status: ${statusBadge}`,
-    ...(governanceConsole
-      ? [
-        'Governance Console',
-        ...buildGovernanceConsoleSummaryLines({
-          governanceObservation: governanceConsole.governanceObservation,
-          governanceNextAction: governanceConsole.governanceNextAction,
-          policyValidation: governanceConsole.policyValidation,
-          experimentalFeatures: governanceConsole.experimentalFeatures,
-        }).map((line) => `  ${line}`),
-        '',
-      ]
-      : []),
     'C. Switch to consumer menu',
     '',
     ...groupedActions.flatMap((group, groupIndex) => [
@@ -87,33 +60,11 @@ export const formatAdvancedMenuClassicView = (
   actions: ReadonlyArray<MenuAction>,
   options?: {
     evidenceSummary?: FrameworkMenuEvidenceSummary;
-    preflight?: ConsumerPreflightResult | null;
-    governanceConsole?: GovernanceConsoleSnapshot | null;
   }
 ): string => {
   const evidenceSummary = options?.evidenceSummary ?? readEvidenceSummaryForMenu(process.cwd());
-  const governanceConsole = options?.preflight
-    ? {
-      governanceObservation: options.preflight.governanceObservation,
-      governanceNextAction: options.preflight.governanceNextAction,
-      policyValidation: options.preflight.policyValidation,
-      experimentalFeatures: options.preflight.experimentalFeatures,
-    }
-    : (options?.governanceConsole ?? null);
   const lines = [
     'Pumuki Framework Menu (Advanced)',
-    ...(governanceConsole
-      ? [
-        'Governance Console',
-        ...buildGovernanceConsoleSummaryLines({
-          governanceObservation: governanceConsole.governanceObservation,
-          governanceNextAction: governanceConsole.governanceNextAction,
-          policyValidation: governanceConsole.policyValidation,
-          experimentalFeatures: governanceConsole.experimentalFeatures,
-        }).map((line) => `  ${line}`),
-        '',
-      ]
-      : []),
     'C. Switch to consumer menu',
     ...actions.map((action) => {
       const help = ADVANCED_MENU_HELP[action.id];