pumuki 6.3.299 → 6.3.301

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [6.3.301] - 2026-05-19
+
+- `PUMUKI-INC-157`: PRE_WRITE no longer hard-blocks when evidence reports `ai_gate.status=BLOCKED` but exposes no real blocking causes and only non-blocking WARN signals such as worktree hygiene warnings. Explicit AST/skills findings with `blocking=true` still block, even when their inherited severity is WARN.
+
+## [6.3.300] - 2026-05-19
+
+- CLI: `pumuki --version` and `pumuki -v` now return the effective package version with exit code `0` without invoking lifecycle status, audit, gates, notifications or evidence writes. This prevents consumer repin checks from mutating `.ai_evidence.json` just to read the installed version.
+
 ## [6.3.298] - 2026-05-19
 
 ## [6.3.299] - 2026-05-19

package/VERSION

@@ -1 +1 @@
-6.3.299
+6.3.301

package/integrations/gate/evaluateAiGate.ts

@@ -226,6 +226,9 @@ const buildEvidenceGateBlockedMessage = (result: Extract<EvidenceReadResult, { k
   return `Evidence AI gate status is BLOCKED. Blocking causes: ${formattedCauses.join(' || ')}${suffix}`;
 };
 
+const hasEvidenceBlockingCause = (result: Extract<EvidenceReadResult, { kind: 'valid' }>): boolean =>
+  extractEvidenceBlockingCauses(result.evidence).length > 0;
+
 const normalizeRepoStateLifecycleVersions = (repoState: RepoState): RepoState => {
   const packageVersion = repoState.lifecycle.package_version;
   const lifecycleVersion = repoState.lifecycle.lifecycle_version;
@@ -1273,7 +1276,12 @@ const collectEvidenceViolations = (
   if (result.evidence.ai_gate.status === 'BLOCKED') {
     const gateBlockedMessage = buildEvidenceGateBlockedMessage(result);
     violations.push(
-      isAdvisoryDocumentationRenderSlice(repoRoot, ageSeconds, maxAgeSeconds)
+      !hasEvidenceBlockingCause(result) && ageSeconds <= maxAgeSeconds
+        ? toWarnViolation(
+            'EVIDENCE_GATE_BLOCKED',
+            `${gateBlockedMessage} Advisory because the evidence snapshot did not expose any blocking cause.`
+          )
+        : isAdvisoryDocumentationRenderSlice(repoRoot, ageSeconds, maxAgeSeconds)
         ? toWarnViolation(
             'EVIDENCE_GATE_BLOCKED',
             `${gateBlockedMessage} Advisory because the current slice only contains documentation/render/tooling artifacts and evidence is fresh.`

package/integrations/lifecycle/cli.ts

@@ -192,6 +192,7 @@ export type ParsedArgs = {
 
 const HELP_TEXT = `
 Pumuki lifecycle commands:
+  pumuki --version | -v
   pumuki bootstrap [--enterprise] [--agent=<name>] [--json]
   pumuki install [--with-mcp] [--agent=<name>]
   pumuki uninstall [--purge-artifacts]
@@ -2255,6 +2256,11 @@ export const runLifecycleCli = async (
   dependencies: Partial<LifecycleCliDependencies> = {}
 ): Promise<number> => {
   try {
+    if (argv.length === 1 && (argv[0] === '--version' || argv[0] === '-v')) {
+      writeInfo(getCurrentPumukiVersion());
+      return 0;
+    }
+
     const activeDependencies: LifecycleCliDependencies = {
       ...defaultLifecycleCliDependencies,
       ...dependencies,

package/package.json

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