pumuki 6.3.167 → 6.3.169

package/CHANGELOG.md

@@ -6,6 +6,18 @@ This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [6.3.169] - 2026-05-06
+
+### Fixed
+
+- **Tracked evidence working-tree hygiene:** successful `pumuki-pre-commit` now restores tracked `.ai_evidence.json` from `HEAD` when the file was not staged at hook start, preventing pre-commit frameworks from failing with “files were modified by this hook” while still excluding evidence from code commits.
+
+## [6.3.168] - 2026-05-06
+
+### Fixed
+
+- **Tracked evidence commit hygiene:** `pumuki-pre-commit` now respects tracked `.ai_evidence.json` when it was not staged by the developer before a successful code commit. Documentation-only commits still restore evidence drift, and `PUMUKI_PRE_COMMIT_ALWAYS_RESTAGE_TRACKED_EVIDENCE=1` preserves the previous forced restage behavior.
+
 ## [6.3.167] - 2026-05-06
 
 ### Fixed

package/integrations/git/stageRunners.ts

@@ -77,6 +77,9 @@ const shouldSkipRestagingTrackedEvidenceForDocumentationOnlyScope = (params: {
   return paths.every(isDocumentationOnlyStagedPath);
 };
 
+const hasStagedEvidencePath = (paths: ReadonlyArray<string>): boolean =>
+  paths.some((path) => path === '.ai_evidence.json' || path === '.AI_EVIDENCE.json');
+
 const PRE_COMMIT_EVIDENCE_MAX_AGE_SECONDS = 900;
 const PRE_PUSH_EVIDENCE_MAX_AGE_SECONDS = 1800;
 const HOOK_GATE_PROGRESS_REMINDER_MS = 2000;
@@ -520,6 +523,7 @@ const syncTrackedEvidenceAfterSuccessfulPreCommit = (params: {
   dependencies: StageRunnerDependencies;
   repoRoot: string;
   gateBlocked: boolean;
+  evidenceWasStagedAtStart: boolean;
 }): boolean => {
   const evidenceAbsolutePath = join(params.repoRoot, EVIDENCE_FILE_PATH);
   if (!existsSync(evidenceAbsolutePath)) {
@@ -543,6 +547,20 @@ const syncTrackedEvidenceAfterSuccessfulPreCommit = (params: {
     params.dependencies.restorePathFromHead(params.repoRoot, EVIDENCE_FILE_PATH);
     return false;
   }
+  if (
+    !params.gateBlocked &&
+    !params.evidenceWasStagedAtStart &&
+    !isTruthyEnvFlag(process.env.PUMUKI_PRE_COMMIT_ALWAYS_RESTAGE_TRACKED_EVIDENCE)
+  ) {
+    if (!params.dependencies.isQuietMode()) {
+      process.stderr.write(
+        `[pumuki][evidence-sync] tracked ${EVIDENCE_FILE_PATH} restored because it was not staged before PRE_COMMIT. ` +
+          `Force previous behavior: PUMUKI_PRE_COMMIT_ALWAYS_RESTAGE_TRACKED_EVIDENCE=1\n`
+      );
+    }
+    params.dependencies.restorePathFromHead(params.repoRoot, EVIDENCE_FILE_PATH);
+    return false;
+  }
   try {
     params.dependencies.stagePath(params.repoRoot, EVIDENCE_FILE_PATH);
     return false;
@@ -787,6 +805,7 @@ export async function runPreCommitStage(
   const activeDependencies = getDependencies(dependencies);
   const repoRoot = activeDependencies.resolveRepoRoot();
   const manifestSnapshot = captureManifestGuardSnapshot(repoRoot);
+  const initiallyStagedPaths = activeDependencies.listStagedIndexPaths(repoRoot);
   activeDependencies.ensureRuntimeArtifactsIgnored(repoRoot);
   if (
     enforceGitAtomicityGate({
@@ -820,6 +839,7 @@ export async function runPreCommitStage(
       dependencies: activeDependencies,
       repoRoot,
       gateBlocked: result.exitCode !== 0,
+      evidenceWasStagedAtStart: hasStagedEvidencePath(initiallyStagedPaths),
     })
   ) {
     return 1;

package/package.json

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