pumuki 6.3.30 → 6.3.31

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.F1.T42` (sincronizar canónico RuralGO tras cierre de `#543` y actualizar refs reales en feedback/master plan).
+- Task activa (`🚧`): `P12.F2.T51` (publicar release con el hardening `#551` y cerrar trazabilidad final en canónico + master).
 
 ## Historial resumido
 - No se mantienen MDs históricos de seguimiento en este repositorio.

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

@@ -1326,10 +1326,21 @@ Criterio de salida F5:
     - desbloquear billing de la cuenta/organización de GitHub Actions.
     - restaurar cuota/permisos de Snyk o ajustar temporalmente ese check requerido.
 
-- 🚧 `P12.F1.T42` Sincronizar canónico RuralGO tras cierre de `#543` (`REPORTED -> FIXED` en feedback + master plan con refs reales).
-  - salida esperada:
-    - `R_GO/docs/technical/08-validation/refactor/pumuki-integration-feedback.md` actualizado a `FIXED` para `PUMUKI-INC-055`.
-    - `R_GO/ruralgo-master-plan.md` con leyenda actualizada (solo 1 `🚧` activa) y referencia de issue/PR/commit.
+- ✅ `P12.F1.T42` Sincronizar canónico RuralGO tras cierre de `#543` (`REPORTED -> FIXED` en feedback + master plan con refs reales).
+  - cierre ejecutado:
+    - se resolvió el bloqueo histórico de rama creando una rama docs limpia desde `origin/develop` en `R_GO`: `docs/rgo-sync-issue-543-fixed-20260304`.
+    - commit documental atómico aplicado: `66d88dacb` (`docs(validation): sync canonical issue 543 to fixed`).
+    - PR abierta en `R_GO`: `https://github.com/SwiftEnProfundidad/R_GO/pull/1503`.
+    - canónico actualizado en la PR:
+      - `docs/technical/08-validation/refactor/pumuki-integration-feedback.md` (`PUMUKI-INC-055 => ✅ FIXED`).
+      - `ruralgo-master-plan.md` (`#543 => ✅`, leyenda recalculada).
+  - evidencia:
+    - `git -C /tmp/rgo-sync-issue-543-*/ commit -m "docs(validation): sync canonical issue 543 to fixed"`
+    - `git -C /tmp/rgo-sync-issue-543-*/ push -u origin docs/rgo-sync-issue-543-fixed-20260304`
+    - `gh pr create --base develop --head docs/rgo-sync-issue-543-fixed-20260304`
+    - hook gates en verde:
+      - `pre-commit => ALLOW/PASS`
+      - `pre-push => ALLOW/PASS`
 
 - ✅ `P12.F1.T46` Sincronizar canónico RuralGO en estado intermedio de `#544` (`REPORTED` con refs reales de issue/branch/PR/commit/evidencia) y alinear master plan con una única mejora `🚧`.
   - cierre ejecutado:
@@ -1678,10 +1689,58 @@ Criterio de salida F5:
       - `gh run rerun 22648216106 --failed` (rerun solicitado en iteración actual).
       - `gh run rerun 22670371464 --failed` (rerun solicitado en iteración actual).
 
-- ⏳ `P12.F1.T45` Sincronizar canónico RuralGO tras cierre de `#544` (`REPORTED -> FIXED` en feedback + master plan con refs reales).
+- ✅ `P12.F1.T48` Corregir regresión crítica de packaging en `pumuki@6.3.29` (módulo telemetry ausente en npm) y publicar patch release.
+  - cierre ejecutado:
+    - issue creada: `#548` (`bug: npm package misses integrations/telemetry and breaks hooks at runtime`).
+    - fix implementado:
+      - `package.json` incluye `integrations/telemetry/*.ts` en `files`.
+      - `scripts/package-manifest-lib.ts` exige `integrations/telemetry/gateTelemetry.ts` como ruta requerida.
+    - PR mergeada: `#549` (commit de merge `1075752d338f38354772781b5e32e0face35189c`).
+    - issue `#548` cerrada.
+    - release publicada: `pumuki@6.3.30` + tag `v6.3.30`.
+  - evidencia:
+    - `npx --yes tsx@4.21.0 --test scripts/__tests__/package-manifest-lib.test.ts scripts/__tests__/check-package-manifest.test.ts`
+    - `npm run -s validation:package-manifest`
+    - `npm pack --json --dry-run | rg "integrations/telemetry/gateTelemetry.ts"`
+    - `npm run -s typecheck`
+    - `npm publish --access public`
+
+- ✅ `P12.F1.T45` Sincronizar canónico RuralGO tras cierre de `#544` (`REPORTED -> FIXED` en feedback + master plan con refs reales).
+  - cierre ejecutado:
+    - rama docs creada y publicada: `docs/rgo-sync-issue-544-fixed-20260304`.
+    - PR abierta y mergeada: `R_GO#1504` (`https://github.com/SwiftEnProfundidad/R_GO/pull/1504`).
+    - commit de merge en `develop`: `5c0306ba14ab59511a10d12d01a35911481154e3`.
+  - evidencia:
+    - `R_GO/docs/technical/08-validation/refactor/pumuki-integration-feedback.md` actualizado a `✅ FIXED` para `PUMUKI-INC-056`.
+    - `R_GO/ruralgo-master-plan.md` actualizado con leyenda y siguiente mejora estratégica activa.
+    - hooks en verde durante commit/push de la rama docs (`PRE_COMMIT=ALLOW`, `PRE_PUSH=ALLOW`).
+
+- ✅ `P12.F2.T49` Ejecutar la siguiente mejora estratégica pendiente: suite contractual multi-repo de regresión enterprise (issue -> rama -> PR -> evidencia).
+  - cierre ejecutado:
+    - issue creada y priorizada: `#551` (`feature: suite contractual multi-repo de regresión enterprise`).
+    - sincronización canónica RuralGO aplicada y mergeada: `R_GO#1505` (`https://github.com/SwiftEnProfundidad/R_GO/pull/1505`).
+    - commit de merge en `R_GO/develop`: `64e40d2365f3edf1137cf70a038a638398503db1`.
+  - evidencia:
+    - `R_GO/docs/technical/08-validation/refactor/pumuki-integration-feedback.md` actualizado con `PUMUKI-INC-057` en estado `🚧 REPORTED (#551)`.
+    - `R_GO/ruralgo-master-plan.md` actualizado con mejora estratégica activa referenciada a `#551`.
+
+- ✅ `P12.F2.T50` Ejecutar implementación técnica de la suite contractual multi-repo (`#551`) con ciclo RED -> GREEN -> REFACTOR y trazabilidad E2E.
+  - cierre ejecutado:
+    - rama técnica creada: `feature/551-enterprise-contract-suite`.
+    - PR abierta y mergeada: `#553` (`https://github.com/SwiftEnProfundidad/ast-intelligence-hooks/pull/553`).
+    - issue cerrada: `#551`.
+    - commit de merge en `develop`: `0a3a005f004f6a65bb33946450cdb382af1a59f6`.
+  - evidencia:
+    - `npx --yes tsx@4.21.0 --test 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`
+
+- 🚧 `P12.F2.T51` Publicar release que incluya el hardening `#551` (suite contractual) y dejar trazabilidad final en canónico + master.
   - salida esperada:
-    - `R_GO/docs/technical/08-validation/refactor/pumuki-integration-feedback.md` actualizado a `FIXED` para `PUMUKI-INC-056`.
-    - `R_GO/ruralgo-master-plan.md` con leyenda final actualizada y referencia de merge real.
+    - 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.
 
 Criterio de salida F6:
 - veredicto final trazable y cierre administrativo completo.

package/docs/validation/README.md

@@ -15,6 +15,7 @@ Este directorio contiene solo documentación oficial y estable de validación pa
 
 - Master de seguimiento: `docs/registro-maestro-de-seguimiento.md`.
 - Plan activo: `docs/seguimiento-completo-validacion-ruralgo-03-03-2026.md`.
+- Suite contractual enterprise (MVP): `npm run -s validation:contract-suite:enterprise`.
 
 ## Política de higiene
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki",
-  "version": "6.3.30",
+  "version": "6.3.31",
   "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": {
@@ -108,6 +108,7 @@
     "validation:package-smoke": "node --import tsx scripts/package-install-smoke.ts --mode=block",
     "validation:package-smoke:minimal": "node --import tsx scripts/package-install-smoke.ts --mode=minimal",
     "validation:lifecycle-smoke": "node --import tsx scripts/package-install-smoke.ts --mode=minimal",
+    "validation:contract-suite:enterprise": "node --import tsx scripts/run-enterprise-contract-suite.ts",
     "validation:c020-benchmark": "node --import tsx scripts/run-c020-benchmark.ts",
     "validation:clean-artifacts": "npx --yes tsx@4.21.0 scripts/clean-validation-artifacts.ts",
     "skills:compile": "npx --yes tsx@4.21.0 scripts/compile-skills-lock.ts",

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

@@ -0,0 +1,60 @@
+import { resolve } from 'node:path';
+import type { EnterpriseContractSuiteOptions } from './enterprise-contract-suite-contract';
+
+export const DEFAULT_ENTERPRISE_CONTRACT_REPORT_PATH =
+  '.audit-reports/enterprise-contract-suite/report.json';
+
+export const DEFAULT_ENTERPRISE_CONTRACT_SUMMARY_PATH =
+  '.audit-reports/enterprise-contract-suite/summary.md';
+
+export const parseEnterpriseContractSuiteArgs = (
+  argv: ReadonlyArray<string>,
+  cwd = process.cwd()
+): EnterpriseContractSuiteOptions => {
+  const options: EnterpriseContractSuiteOptions = {
+    repoRoot: resolve(cwd),
+    reportPath: DEFAULT_ENTERPRISE_CONTRACT_REPORT_PATH,
+    summaryPath: DEFAULT_ENTERPRISE_CONTRACT_SUMMARY_PATH,
+    printJson: false,
+  };
+
+  for (const arg of argv) {
+    if (arg === '--json') {
+      options.printJson = true;
+      continue;
+    }
+
+    if (arg.startsWith('--repo=')) {
+      const value = arg.slice('--repo='.length).trim();
+      if (!value) {
+        throw new Error('Flag --repo requires a non-empty path.');
+      }
+      options.repoRoot = resolve(value);
+      continue;
+    }
+
+    if (arg.startsWith('--out=')) {
+      const value = arg.slice('--out='.length).trim();
+      if (!value) {
+        throw new Error('Flag --out requires a non-empty path.');
+      }
+      options.reportPath = value;
+      continue;
+    }
+
+    if (arg.startsWith('--summary=')) {
+      const value = arg.slice('--summary='.length).trim();
+      if (!value) {
+        throw new Error('Flag --summary requires a non-empty path.');
+      }
+      options.summaryPath = value;
+      continue;
+    }
+
+    throw new Error(
+      `Unsupported argument "${arg}". Allowed: --repo=<path> --out=<path> --summary=<path> --json`
+    );
+  }
+
+  return options;
+};

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

@@ -0,0 +1,31 @@
+export type EnterpriseContractProfileId = 'minimal' | 'block';
+
+export type EnterpriseContractProfileSpec = {
+  id: EnterpriseContractProfileId;
+  mode: 'minimal' | 'block';
+  expectedExitCode: number;
+};
+
+export type EnterpriseContractProfileResult = {
+  id: EnterpriseContractProfileId;
+  mode: 'minimal' | 'block';
+  command: string;
+  expectedExitCode: number;
+  exitCode: number;
+  status: 'PASS' | 'FAIL';
+};
+
+export type EnterpriseContractSuiteReport = {
+  suiteVersion: '1';
+  generatedAt: string;
+  repoRoot: string;
+  profiles: ReadonlyArray<EnterpriseContractProfileResult>;
+  overall: 'PASS' | 'FAIL';
+};
+
+export type EnterpriseContractSuiteOptions = {
+  repoRoot: string;
+  reportPath: string;
+  summaryPath: string;
+  printJson: boolean;
+};

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

@@ -0,0 +1,45 @@
+import type {
+  EnterpriseContractProfileResult,
+  EnterpriseContractSuiteReport,
+} from './enterprise-contract-suite-contract';
+
+export const resolveEnterpriseContractOverall = (
+  profiles: ReadonlyArray<EnterpriseContractProfileResult>
+): 'PASS' | 'FAIL' =>
+  profiles.every((profile) => profile.status === 'PASS') ? 'PASS' : 'FAIL';
+
+export const buildEnterpriseContractReport = (params: {
+  repoRoot: string;
+  generatedAt?: string;
+  profiles: ReadonlyArray<EnterpriseContractProfileResult>;
+}): EnterpriseContractSuiteReport => ({
+  suiteVersion: '1',
+  generatedAt: params.generatedAt ?? new Date().toISOString(),
+  repoRoot: params.repoRoot,
+  profiles: params.profiles,
+  overall: resolveEnterpriseContractOverall(params.profiles),
+});
+
+export const renderEnterpriseContractSummary = (
+  report: EnterpriseContractSuiteReport
+): string => {
+  const lines: string[] = [
+    '# Enterprise Contract Suite Summary',
+    '',
+    `- Overall: ${report.overall}`,
+    `- Generated At: ${report.generatedAt}`,
+    `- Repo Root: ${report.repoRoot}`,
+    '',
+    '## Profiles',
+    '',
+  ];
+
+  for (const profile of report.profiles) {
+    lines.push(
+      `- ${profile.id}: status=${profile.status} expected_exit=${profile.expectedExitCode} actual_exit=${profile.exitCode}`
+    );
+  }
+
+  lines.push('');
+  return lines.join('\n');
+};

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

@@ -0,0 +1,78 @@
+import { dirname, join } from 'node:path';
+import { writeFileSync } from 'node:fs';
+import {
+  parseEnterpriseContractSuiteArgs,
+} from './enterprise-contract-suite-args-lib';
+import {
+  buildEnterpriseContractReport,
+  renderEnterpriseContractSummary,
+} from './enterprise-contract-suite-report-lib';
+import type {
+  EnterpriseContractProfileResult,
+  EnterpriseContractProfileSpec,
+} 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
+): EnterpriseContractProfileResult => {
+  const args = ['--import', 'tsx', 'scripts/package-install-smoke.ts', `--mode=${profile.mode}`];
+  const result = runCommand({
+    cwd: repoRoot,
+    executable: 'node',
+    args,
+  });
+
+  return {
+    id: profile.id,
+    mode: profile.mode,
+    command: `node ${args.join(' ')}`,
+    expectedExitCode: profile.expectedExitCode,
+    exitCode: result.exitCode,
+    status: result.exitCode === profile.expectedExitCode ? 'PASS' : 'FAIL',
+  };
+};
+
+const writeTextFile = (repoRoot: string, relativePath: string, content: string): void => {
+  const filePath = join(repoRoot, relativePath);
+  ensureDirectory(dirname(filePath));
+  writeFileSync(filePath, content, 'utf8');
+};
+
+const main = (): number => {
+  const options = parseEnterpriseContractSuiteArgs(process.argv.slice(2));
+  const results = PROFILE_SPECS.map((profile) => runProfile(options.repoRoot, profile));
+
+  const report = buildEnterpriseContractReport({
+    repoRoot: options.repoRoot,
+    profiles: results,
+  });
+
+  writeTextFile(options.repoRoot, options.reportPath, `${JSON.stringify(report, null, 2)}\n`);
+  writeTextFile(options.repoRoot, options.summaryPath, renderEnterpriseContractSummary(report));
+
+  if (options.printJson) {
+    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+  }
+
+  return report.overall === 'PASS' ? 0 : 1;
+};
+
+process.exit(main());