fix(tools): use PAI_DIR env var instead of hardcoded ~/.claude paths

Add process.env.PAI_DIR fallback to 15 PAI Tools that hardcode
~/.claude as the base directory. Each tool now checks PAI_DIR first,
falling back to ~/.claude for backward compatibility.

This enables PAI_DIR portability — users can set PAI_DIR to install
PAI outside ~/.claude/ (e.g. to work around Claude Code v2.1.78+
sensitive directory protection).

Special case: BuildCLAUDE.ts still writes CLAUDE.md to ~/.claude/
since Claude Code reads it from that fixed location, but reads PAI
content from PAI_DIR.

Tools fixed: ActivityParser, AlgorithmPhaseReport, Banner,
BannerMatrix, BannerNeofetch, BannerRetro, BuildCLAUDE,
FeatureRegistry, LearningPatternSynthesis, LoadSkillConfig,
NeofetchBanner, pai, RebuildPAI, SessionHarvester, SessionProgress.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Marvin

Releases/v4.0.3/.claude/PAI/Tools/ActivityParser.ts

@@ -21,7 +21,7 @@ import * as path from "path";
 // Configuration
 // ============================================================================
 
-const CLAUDE_DIR = path.join(process.env.HOME!, ".claude");
+const CLAUDE_DIR = process.env.PAI_DIR || path.join(process.env.HOME!, ".claude");
 const MEMORY_DIR = path.join(CLAUDE_DIR, "MEMORY");
 const USERNAME = process.env.USER || require("os").userInfo().username;
 const PROJECTS_DIR = path.join(CLAUDE_DIR, "projects", `-Users-${USERNAME}--claude`);  // Claude Code native storage

Releases/v4.0.3/.claude/PAI/Tools/AlgorithmPhaseReport.ts

@@ -15,7 +15,8 @@ import { join } from "path";
 import { homedir } from "os";
 import { parseArgs } from "util";
 
-const STATE_DIR = join(homedir(), ".claude", "MEMORY", "STATE");
+const PAI_DIR = process.env.PAI_DIR || join(homedir(), ".claude");
+const STATE_DIR = join(PAI_DIR, "MEMORY", "STATE");
 const STATE_FILE = join(STATE_DIR, "algorithm-phase.json");
 
 interface AlgorithmState {

Releases/v4.0.3/.claude/PAI/Tools/Banner.ts

@@ -13,7 +13,7 @@ import { join } from "path";
 import { spawnSync } from "child_process";
 
 const HOME = process.env.HOME!;
-const CLAUDE_DIR = join(HOME, ".claude");
+const CLAUDE_DIR = process.env.PAI_DIR || join(HOME, ".claude");
 
 // ═══════════════════════════════════════════════════════════════════════════
 // Terminal Width Detection

Releases/v4.0.3/.claude/PAI/Tools/BannerMatrix.ts

@@ -22,7 +22,7 @@ import { join } from "path";
 import { spawnSync } from "child_process";
 
 const HOME = process.env.HOME!;
-const CLAUDE_DIR = join(HOME, ".claude");
+const CLAUDE_DIR = process.env.PAI_DIR || join(HOME, ".claude");
 
 // =============================================================================
 // Terminal Width Detection

Releases/v4.0.3/.claude/PAI/Tools/BannerNeofetch.ts

@@ -15,7 +15,7 @@ import { join } from "path";
 import { spawnSync } from "child_process";
 
 const HOME = process.env.HOME!;
-const CLAUDE_DIR = join(HOME, ".claude");
+const CLAUDE_DIR = process.env.PAI_DIR || join(HOME, ".claude");
 
 // ═══════════════════════════════════════════════════════════════════════
 // Terminal Width Detection

Releases/v4.0.3/.claude/PAI/Tools/BannerRetro.ts

@@ -20,7 +20,7 @@ import { join } from "path";
 import { spawnSync } from "child_process";
 
 const HOME = process.env.HOME!;
-const CLAUDE_DIR = join(HOME, ".claude");
+const CLAUDE_DIR = process.env.PAI_DIR || join(HOME, ".claude");
 
 // ═══════════════════════════════════════════════════════════════════════════
 // Terminal Width Detection

Releases/v4.0.3/.claude/PAI/Tools/BuildCLAUDE.ts

@@ -15,9 +15,9 @@
 import { readFileSync, writeFileSync, existsSync } from "fs";
 import { join } from "path";
 
-const PAI_DIR = join(process.env.HOME!, ".claude");
+const PAI_DIR = process.env.PAI_DIR || join(process.env.HOME!, ".claude");
 const TEMPLATE_PATH = join(PAI_DIR, "CLAUDE.md.template");
-const OUTPUT_PATH = join(PAI_DIR, "CLAUDE.md");
+const OUTPUT_PATH = join(process.env.HOME!, ".claude", "CLAUDE.md");  // Always ~/.claude/ — Claude Code reads from fixed location
 const SETTINGS_PATH = join(PAI_DIR, "settings.json");
 const ALGORITHM_DIR = join(PAI_DIR, "PAI/Algorithm");
 const LATEST_PATH = join(ALGORITHM_DIR, "LATEST");

Releases/v4.0.3/.claude/PAI/Tools/FeatureRegistry.ts

@@ -55,7 +55,8 @@ interface FeatureRegistry {
   };
 }
 
-const REGISTRY_DIR = join(process.env.HOME || '', '.claude', 'MEMORY', 'progress');
+const PAI_DIR = process.env.PAI_DIR || join(process.env.HOME || '', '.claude');
+const REGISTRY_DIR = join(PAI_DIR, 'MEMORY', 'progress');
 
 function getRegistryPath(project: string): string {
   return join(REGISTRY_DIR, `${project}-features.json`);

Releases/v4.0.3/.claude/PAI/Tools/LearningPatternSynthesis.ts

@@ -24,7 +24,7 @@ import * as path from "path";
 // Configuration
 // ============================================================================
 
-const CLAUDE_DIR = path.join(process.env.HOME!, ".claude");
+const CLAUDE_DIR = process.env.PAI_DIR || path.join(process.env.HOME!, ".claude");
 const LEARNING_DIR = path.join(CLAUDE_DIR, "MEMORY", "LEARNING");
 const RATINGS_FILE = path.join(LEARNING_DIR, "SIGNALS", "ratings.jsonl");
 const SYNTHESIS_DIR = path.join(LEARNING_DIR, "SYNTHESIS");

Releases/v4.0.3/.claude/PAI/Tools/LoadSkillConfig.ts

@@ -35,7 +35,8 @@ interface ExtendManifest {
 
 // Constants
 const HOME = homedir();
-const CUSTOMIZATION_DIR = join(HOME, '.claude', 'PAI', 'USER', 'SKILLCUSTOMIZATIONS');
+const PAI_DIR = process.env.PAI_DIR || join(HOME, '.claude');
+const CUSTOMIZATION_DIR = join(PAI_DIR, 'PAI', 'USER', 'SKILLCUSTOMIZATIONS');
 
 /**
  * Deep merge two objects recursively