pumuki 6.3.88 → 6.3.89

package/docs/operations/RELEASE_NOTES.md

@@ -1,3 +1,8 @@
+## 2026-04-20 (v6.3.89)
+- **Aislamiento por worktree**: `pumuki install` detecta worktrees sin `core.hooksPath` explícito y fija un `core.hooksPath` local a `.pumuki/git-hooks`, evitando que los hooks gestionados se escriban en `.git/hooks` del checkout principal compartido.
+- **Rollback limpio**: `pumuki uninstall` retira ese `core.hooksPath` solo si fue creado por Pumuki para el worktree.
+- **Rollout recomendado**: publicar `pumuki@6.3.89`, repin inmediato en `Flux_training` y repetir la repro de worktree (`install`, `bootstrap-manifest`, `status --json`, checksums de hooks en checkout principal).
+
 ## 2026-04-20 (v6.3.87)
 - Cierra el segundo tramo de PUM-026: si PRE_WRITE solo arregla el receipt MCP y el gate pasa a verde, fuerza un refresh de paridad contra PRE_COMMIT antes del veredicto final.
 - Rollout recomendado: actualizar Flux_training y repetir la repro mínima de validate/pre-commit/.ai_evidence.

package/integrations/lifecycle/hookManager.ts

@@ -27,6 +27,81 @@ export type PumukiHooksDirectoryResolution = {
 };
 
 const HOOK_FILE_MODE = 0o755;
+const PUMUKI_WORKTREE_HOOKS_PATH = '.pumuki/git-hooks';
+
+const readLocalGitConfigValue = (repoRoot: string, key: string): string | null => {
+  try {
+    const value = execFileSync('git', ['config', '--local', '--get', key], {
+      cwd: repoRoot,
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+    }).trim();
+    return value.length > 0 ? value : null;
+  } catch {
+    return null;
+  }
+};
+
+const writeLocalGitConfigValue = (repoRoot: string, key: string, value: string): void => {
+  execFileSync('git', ['config', '--local', key, value], {
+    cwd: repoRoot,
+    stdio: ['ignore', 'ignore', 'ignore'],
+  });
+};
+
+const unsetLocalGitConfigValue = (repoRoot: string, key: string): void => {
+  try {
+    execFileSync('git', ['config', '--local', '--unset-all', key], {
+      cwd: repoRoot,
+      stdio: ['ignore', 'ignore', 'ignore'],
+    });
+  } catch {
+    // noop
+  }
+};
+
+const isWorktreeCheckout = (repoRoot: string): boolean => {
+  try {
+    const gitPointer = readFileSync(join(repoRoot, '.git'), 'utf8').trim();
+    return /^gitdir:\s+/i.test(gitPointer);
+  } catch {
+    return false;
+  }
+};
+
+const isPumukiManagedWorktreeHooksPath = (repoRoot: string, hooksPath: string): boolean => {
+  const normalizedHooksPath = hooksPath.trim();
+  return (
+    normalizedHooksPath === PUMUKI_WORKTREE_HOOKS_PATH ||
+    normalizedHooksPath === resolve(repoRoot, PUMUKI_WORKTREE_HOOKS_PATH)
+  );
+};
+
+const ensureWorktreeLocalHooksPath = (repoRoot: string): void => {
+  if (!isWorktreeCheckout(repoRoot)) {
+    return;
+  }
+
+  const currentHooksPath = readLocalGitConfigValue(repoRoot, 'core.hooksPath');
+  if (currentHooksPath) {
+    return;
+  }
+
+  writeLocalGitConfigValue(repoRoot, 'core.hooksPath', PUMUKI_WORKTREE_HOOKS_PATH);
+};
+
+const clearWorktreeLocalHooksPath = (repoRoot: string): void => {
+  if (!isWorktreeCheckout(repoRoot)) {
+    return;
+  }
+
+  const currentHooksPath = readLocalGitConfigValue(repoRoot, 'core.hooksPath');
+  if (!currentHooksPath || !isPumukiManagedWorktreeHooksPath(repoRoot, currentHooksPath)) {
+    return;
+  }
+
+  unsetLocalGitConfigValue(repoRoot, 'core.hooksPath');
+};
 
 const resolveGitPath = (repoRoot: string, gitPathTarget: string): string | null => {
   try {
@@ -137,6 +212,7 @@ const ensureHooksDirectory = (repoRoot: string): void => {
 };
 
 export const installPumukiHooks = (repoRoot: string): HookInstallResult => {
+  ensureWorktreeLocalHooksPath(repoRoot);
   ensureHooksDirectory(repoRoot);
   const changedHooks: PumukiManagedHook[] = [];
 
@@ -180,6 +256,7 @@ export const uninstallPumukiHooks = (repoRoot: string): HookUninstallResult => {
     changedHooks.push(hook);
   }
 
+  clearWorktreeLocalHooksPath(repoRoot);
   return { changedHooks };
 };
 

package/package.json

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