pumuki 6.3.233 → 6.3.235

package/bin/_chained-pre-write.js

@@ -0,0 +1,22 @@
+const PRE_WRITE_ENTRY = 'integrations/lifecycle/cli.ts';
+const PRE_WRITE_ARGS = ['sdd', 'validate', '--stage=PRE_WRITE'];
+
+function shouldRunChainedPreWrite(env = process.env) {
+  if (env.PUMUKI_SKIP_CHAINED_PRE_WRITE === '1') {
+    return false;
+  }
+  return env.PUMUKI_CHAINED_PRE_WRITE_DONE !== '1';
+}
+
+function runChainedPreWriteIfNeeded(runTsEntry, env = process.env) {
+  if (!shouldRunChainedPreWrite(env)) {
+    return 0;
+  }
+  env.PUMUKI_CHAINED_PRE_WRITE_DONE = '1';
+  return runTsEntry(PRE_WRITE_ENTRY, PRE_WRITE_ARGS);
+}
+
+module.exports = {
+  runChainedPreWriteIfNeeded,
+  shouldRunChainedPreWrite,
+};

package/bin/pumuki-pre-commit.js

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
 
 const { runTsEntry } = require('./_run-ts-entry');
+const { runChainedPreWriteIfNeeded } = require('./_chained-pre-write');
 
+const preWriteStatus = runChainedPreWriteIfNeeded(runTsEntry);
+if (preWriteStatus !== 0) {
+  process.exit(preWriteStatus);
+}
 process.exit(runTsEntry('integrations/git/preCommitBackend.cli.ts', process.argv.slice(2)));

package/bin/pumuki-pre-push.js

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
 
 const { runTsEntry } = require('./_run-ts-entry');
+const { runChainedPreWriteIfNeeded } = require('./_chained-pre-write');
 
+const preWriteStatus = runChainedPreWriteIfNeeded(runTsEntry);
+if (preWriteStatus !== 0) {
+  process.exit(preWriteStatus);
+}
 process.exit(runTsEntry('integrations/git/prePushBackend.cli.ts', process.argv.slice(2)));

package/integrations/git/runPlatformGate.ts

@@ -80,6 +80,61 @@ const defaultServices: GateServices = {
   evidence: new EvidenceService(),
 };
 
+const hasPositiveFindingLine = (lines: Finding['lines']): boolean => {
+  if (typeof lines === 'number') {
+    return Number.isFinite(lines) && lines > 0;
+  }
+  if (typeof lines === 'string') {
+    return lines.trim().length > 0;
+  }
+  if (Array.isArray(lines)) {
+    return lines.some((line) => Number.isFinite(line) && line > 0);
+  }
+  return false;
+};
+
+const hasActionableFindingLocation = (finding: Finding): boolean => {
+  return (
+    hasPositiveFindingLine(finding.lines) ||
+    finding.primary_node !== undefined ||
+    (finding.related_nodes?.length ?? 0) > 0
+  );
+};
+
+const toNonActionableScopedAdvisoryFinding = (finding: Finding): Finding => ({
+  ...finding,
+  blocking: false,
+  message:
+    `${finding.message} ` +
+    '(Advisory: Pumuki no pudo atribuir este hallazgo a una linea, rango o nodo accionable en el scope actual.)',
+  why:
+    finding.why ??
+    'El gate esta limitado a un scope acotado y este finding solo pudo atribuirse al archivo completo.',
+  expected_fix:
+    finding.expected_fix ??
+    'Reintentar cuando el detector aporte lineas, rango, simbolo o nodo; mientras tanto no bloquea el slice acotado.',
+});
+
+const normalizeScopedRuleEngineFindings = (params: {
+  findings: ReadonlyArray<Finding>;
+  scope: GateScope;
+}): ReadonlyArray<Finding> => {
+  if (params.scope.kind !== 'staged' && params.scope.kind !== 'range') {
+    return params.findings;
+  }
+
+  return params.findings.map((finding) => {
+    if (
+      !finding.filePath ||
+      hasActionableFindingLocation(finding) ||
+      (!finding.ruleId.startsWith('skills.') && !finding.ruleId.startsWith('heuristics.'))
+    ) {
+      return finding;
+    }
+    return toNonActionableScopedAdvisoryFinding(finding);
+  });
+};
+
 const buildDefaultMemoryShadowRecommendation = (params: {
   findings: ReadonlyArray<Finding>;
   tddBddSnapshot?: TddBddSnapshot;
@@ -960,7 +1015,11 @@ export async function runPlatformGate(params: {
     evaluationFacts = factsForPlatformEvaluation,
     findings: ruleEngineFindings,
   } = platformEvaluation;
-  const findings = [...aiGateRepoPolicyFindings, ...ruleEngineFindings];
+  const scopedRuleEngineFindings = normalizeScopedRuleEngineFindings({
+    findings: ruleEngineFindings,
+    scope: params.scope,
+  });
+  const findings = [...aiGateRepoPolicyFindings, ...scopedRuleEngineFindings];
   const evaluationMetrics: SnapshotEvaluationMetrics = coverage
     ? {
       facts_total: coverage.factsTotal,
@@ -1270,7 +1329,15 @@ export async function runPlatformGate(params: {
         ? [...brownfieldHotspotFindings, ...findings]
         : findings;
   const hasAstIntelligenceBlockingFinding = shouldBlockFromFinding(astIntelligenceDualFinding);
-  const decision = dependencies.evaluateGate([...effectiveFindings], params.policy);
+  const gateDecisionFindings = effectiveFindings.filter((finding) => finding.blocking !== false);
+  const decision = dependencies.evaluateGate([...gateDecisionFindings], params.policy);
+  const hasNonBlockingAdvisoryFinding = effectiveFindings.some(
+    (finding) =>
+      finding.blocking === false &&
+      (finding.severity === 'WARN' ||
+        finding.severity === 'ERROR' ||
+        finding.severity === 'CRITICAL')
+  );
   const baseGateOutcome =
     sddBlockingFinding ||
     degradedModeBlocks ||
@@ -1286,7 +1353,8 @@ export async function runPlatformGate(params: {
     brownfieldHotspotFindings.some((finding) => shouldBlockFromFinding(finding)) ||
     hasTddBddBlockingFinding
       ? 'BLOCK'
-      : (decision.outcome === 'PASS' && tddBddSnapshot?.status === 'advisory'
+      : (decision.outcome === 'PASS' &&
+          (tddBddSnapshot?.status === 'advisory' || hasNonBlockingAdvisoryFinding)
           ? 'WARN'
           : decision.outcome);
   const gateWaiverStage =

package/integrations/lifecycle/audit.ts

@@ -207,7 +207,10 @@ const resolveLifecycleAuditScope = (params: {
   extensions: ReadonlyArray<string>;
   stagedMatchingExtensions: ReadonlyArray<string>;
 }): LifecycleAuditScope => {
-  if (params.stage === 'PRE_WRITE' && params.stagedMatchingExtensions.length > 0) {
+  if (
+    (params.stage === 'PRE_WRITE' || params.stage === 'PRE_COMMIT') &&
+    params.stagedMatchingExtensions.length > 0
+  ) {
     return { kind: 'staged' };
   }
   if (params.stage === 'PRE_PUSH') {

package/integrations/lifecycle/hookBlock.ts

@@ -33,8 +33,11 @@ const runnerLine = (
   phase: ResolverPhase,
   runner: string
 ): string => {
-  if (parentHook === 'pre-push' && phase === 'main') {
-    return `  PUMUKI_PRE_PUSH_STDIN="$PUMUKI_PRE_PUSH_STDIN" ${runner} "$@"`;
+  if (phase === 'main') {
+    if (parentHook === 'pre-push') {
+      return `  PUMUKI_CHAINED_PRE_WRITE_DONE=1 PUMUKI_PRE_PUSH_STDIN="$PUMUKI_PRE_PUSH_STDIN" ${runner} "$@"`;
+    }
+    return `  PUMUKI_CHAINED_PRE_WRITE_DONE=1 ${runner}`;
   }
   return `  ${runner}`;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pumuki",
-  "version": "6.3.233",
+  "version": "6.3.235",
   "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/framework-menu-system-notifications-cause.ts

@@ -30,6 +30,10 @@ const BLOCKED_CAUSE_SUMMARY_BY_CODE: Readonly<Record<string, string>> = {
     'Hay conflicto entre fuentes de tracking canónico.',
   ACTIVE_RULE_IDS_EMPTY_FOR_CODE_CHANGES_HIGH:
     'No hay reglas activas para cambios de código.',
+  EVIDENCE_PLATFORM_CRITICAL_SKILLS_RULES_MISSING:
+    'Falta enforcement crítico de skills para la plataforma detectada.',
+  EVIDENCE_SKILLS_CONTRACT_INCOMPLETE:
+    'El contrato de skills está incompleto para este stage.',
 };
 
 const ENGLISH_CAUSE_HINTS = [
@@ -53,6 +57,19 @@ const ENGLISH_CAUSE_HINTS = [
   'usage.',
 ];
 
+const PRIORITY_CODES_FROM_MESSAGE = [
+  'EVIDENCE_PLATFORM_CRITICAL_SKILLS_RULES_MISSING',
+  'EVIDENCE_SKILLS_CONTRACT_INCOMPLETE',
+  'ACTIVE_RULE_IDS_EMPTY_FOR_CODE_CHANGES_HIGH',
+];
+
+const resolvePriorityCauseFromMessage = (message?: string): string | null => {
+  if (!message) {
+    return null;
+  }
+  return PRIORITY_CODES_FROM_MESSAGE.find((code) => message.includes(code)) ?? null;
+};
+
 const buildGenericSpanishBlockedCauseSummary = (
   event: Extract<PumukiCriticalNotificationEvent, { kind: 'gate.blocked' }>,
   causeCode: string
@@ -97,6 +114,10 @@ export const resolveBlockedCauseSummary = (
   causeCode: string
 ): string => {
   const trackingContext = extractNotificationTrackingContext(event.causeMessage);
+  const priorityCode = resolvePriorityCauseFromMessage(event.causeMessage);
+  if (priorityCode) {
+    return BLOCKED_CAUSE_SUMMARY_BY_CODE[priorityCode];
+  }
   if (trackingContext) {
     return buildNotificationTrackingCauseSummary(trackingContext);
   }