fix runtime path drift in v3 OpenCode release

.opencode/OPENCODE.md

@@ -7,7 +7,7 @@ When you start in this directory, determine the installation state:
 ### If settings.json exists and is configured:
 This is an established PAI installation. Read and follow the PAI skill:
 ```
-read skills/PAI/SKILL.md
+read PAI/SKILL.md
 ```
 
 ### If this is a fresh installation:
@@ -21,7 +21,7 @@ Welcome to PAI-OpenCode v1.0!
 
 1. **Just start**: `opencode` - everything works with defaults
 2. **Customize**: Edit `settings.json` for identity and preferences
-3. **Learn more**: Read `skills/PAI/SKILL.md`
+3. **Learn more**: Read `PAI/SKILL.md`
 
 For full documentation, see the README.md in the repository root.
 

.opencode/PAI/PAISYSTEMARCHITECTURE.md

@@ -461,7 +461,7 @@ PAI actions and pipelines run in two environments with identical behavior:
 ### Repository Separation
 
 ```
-PRIVATE: ~/.claude/                    PUBLIC: ${PROJECTS_DIR}/PAI/
+PRIVATE: ~/.opencode/                  PUBLIC: ${PROJECTS_DIR}/PAI/
 ├── Personal data                      ├── Sanitized examples
 ├── API keys (.env)                    ├── Generic templates
 ├── Session history                    └── Community sharing
@@ -487,7 +487,7 @@ The System skill is the centralized mechanism for PAI self-management. It ensure
 
 | Function | Description | Workflow |
 |----------|-------------|----------|
-| **Integrity Audits** | 16 parallel agents verify broken references across ~/.claude | `PrivateSystemAudit.md` |
+| **Integrity Audits** | 16 parallel agents verify broken references across ~/.opencode | `PrivateSystemAudit.md` |
 | **Secret Scanning** | TruffleHog credential detection in any directory | `SecretScanning.md` |
 | **Privacy Validation** | Ensures USER/WORK content isolation from regular skills | `PrivacyCheck.md` |
 | **Cross-Repo Validation** | Verifies private/public repository separation | `CrossRepoValidation.md` |

.opencode/PAI/SKILL.md

@@ -293,7 +293,7 @@ Extended+: Rehearse verification for each CRITICAL criterion.
 
 - Validate prerequisites: env vars, credentials, dependencies, state, files.
 - Execution strategy: parallelize non-serial work at Extended+ (use Delegation skill).
-- Create PRD at `~/.claude/MEMORY/WORK/{session-slug}/PRD-{YYYYMMDD}-{slug}.md` via `generatePRDTemplate()`.
+- Create PRD at `${OPENCODE_DIR:-~/.opencode}/MEMORY/WORK/{session-slug}/PRD-{YYYYMMDD}-{slug}.md` via `generatePRDTemplate()` (writes to OPENCODE_DIR-based location).
 - Write PLAN section. Every PRD requires a plan.
 - For complex multi-approach tasks, use PlanMode skill.
 - Quality Gate re-check.

.opencode/PAI/THEDELEGATIONSYSTEM.md

@@ -99,7 +99,7 @@ Use the Agents skill to compose task-specific agents with unique traits, voices,
 
 **For research specifically:** Use the Research skill, which has dedicated researcher agents (ClaudeResearcher, GeminiResearcher, etc.)
 
-**Reference:** Agents skill (`~/.claude/skills/Agents/SKILL.md`)
+**Reference:** Agents skill (`~/.opencode/skills/Agents/SKILL.md`)
 
 **Full Context Requirements:**
 When delegating, ALWAYS include:

.opencode/PAI/Tools/AddBg.ts

@@ -10,7 +10,7 @@
  *   add-bg input.png "#EAE9DF" output.png
  *   add-bg input.png --brand output.png
  *
- * @see ~/.claude/skills/Images/SKILL.md
+ * @see ~/.opencode/skills/Media/Art/SKILL.md
  */
 
 import { existsSync } from "node:fs";

.opencode/PAI/Tools/AlgorithmPhaseReport.ts

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

.opencode/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.OPENCODE_DIR || join(HOME, ".opencode");
 
 // ═══════════════════════════════════════════════════════════════════════════
 // Terminal Width Detection

.opencode/PAI/Tools/BannerMatrix.ts

@@ -23,7 +23,7 @@ import { spawnSync } from "child_process";
 import { homedir } from "os";
 
 const HOME = process.env.HOME ?? homedir();
-const CLAUDE_DIR = join(HOME, ".claude");
+const CLAUDE_DIR = process.env.OPENCODE_DIR || join(HOME, ".opencode");
 
 // =============================================================================
 // Terminal Width Detection

.opencode/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.OPENCODE_DIR || join(HOME, ".opencode");
 
 // ═══════════════════════════════════════════════════════════════════════
 // Terminal Width Detection

.opencode/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 OPENCODE_ROOT = process.env.OPENCODE_DIR || join(HOME, ".opencode");
 
 // ═══════════════════════════════════════════════════════════════════════════
 // Terminal Width Detection
@@ -311,7 +311,7 @@ interface SystemStats {
 }
 
 function readDAIdentity(): string {
-  const settingsPath = join(CLAUDE_DIR, "settings.json");
+  const settingsPath = join(OPENCODE_ROOT, "settings.json");
   try {
     const settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
     return settings.daidentity?.displayName || settings.daidentity?.name || settings.env?.DA || "PAI";
@@ -321,7 +321,7 @@ function readDAIdentity(): string {
 }
 
 function countSkills(): number {
-  const skillsDir = join(CLAUDE_DIR, "skills");
+  const skillsDir = join(OPENCODE_ROOT, "skills");
   if (!existsSync(skillsDir)) return 0;
   let count = 0;
   try {
@@ -333,7 +333,7 @@ function countSkills(): number {
 }
 
 function countUserFiles(): number {
-  const userDir = join(CLAUDE_DIR, "PAI/USER");
+  const userDir = join(OPENCODE_ROOT, "PAI/USER");
   if (!existsSync(userDir)) return 0;
   let count = 0;
   const countRecursive = (dir: string) => {
@@ -349,19 +349,32 @@ function countUserFiles(): number {
 }
 
 function countHooks(): number {
-  const hooksDir = join(CLAUDE_DIR, "hooks");
-  if (!existsSync(hooksDir)) return 0;
+  const pluginsDir = join(OPENCODE_ROOT, "plugins");
+  const hooksDir = join(OPENCODE_ROOT, "hooks");
+
+  const targetDir = existsSync(pluginsDir) ? pluginsDir : hooksDir;
+  if (!existsSync(targetDir)) return 0;
+
   let count = 0;
-  try {
-    for (const entry of readdirSync(hooksDir, { withFileTypes: true })) {
-      if (entry.isFile() && entry.name.endsWith(".ts")) count++;
-    }
-  } catch {}
+  const countRecursive = (dir: string) => {
+    try {
+      for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+          countRecursive(fullPath);
+        } else if (entry.isFile() && entry.name.endsWith(".ts")) {
+          count++;
+        }
+      }
+    } catch {}
+  };
+
+  countRecursive(targetDir);
   return count;
 }
 
 function countWorkItems(): number {
-  const workDir = join(CLAUDE_DIR, "MEMORY/WORK");
+  const workDir = join(OPENCODE_ROOT, "MEMORY/WORK");
   if (!existsSync(workDir)) return 0;
   try {
     return readdirSync(workDir, { withFileTypes: true })
@@ -372,7 +385,7 @@ function countWorkItems(): number {
 }
 
 function countLearnings(): number {
-  const learningDir = join(CLAUDE_DIR, "MEMORY/LEARNING");
+  const learningDir = join(OPENCODE_ROOT, "MEMORY/LEARNING");
   if (!existsSync(learningDir)) return 0;
   let count = 0;
   const countRecursive = (dir: string) => {

.opencode/PAI/Tools/FailureCapture.ts

@@ -30,7 +30,7 @@ import { join, basename } from 'path';
 import { homedir } from 'os';
 import { inference } from './Inference';
 
-const PAI_DIR = process.env.PAI_DIR || join(process.env.HOME ?? homedir(), '.claude');
+const PAI_DIR = process.env.OPENCODE_DIR || join(process.env.HOME ?? homedir(), '.opencode');
 
 interface FailureCaptureInput {
   transcriptPath: string;

.opencode/PAI/Tools/FeatureRegistry.ts

@@ -7,7 +7,7 @@
  * than Markdown because models are less likely to corrupt structured data.
  *
  * Usage:
- *   bun run ~/.claude/Tools/FeatureRegistry.ts <command> [options]
+ *   bun run ~/.opencode/PAI/Tools/FeatureRegistry.ts <command> [options]
  *
  * Commands:
  *   init <project>              Initialize feature registry for project
@@ -19,7 +19,7 @@
  */
 
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
-import { join } from 'path';
+import { join, resolve } from 'path';
 import { homedir } from 'os';
 
 // Validate home directory
@@ -29,7 +29,10 @@ if (!HOME) {
   process.exit(1);
 }
 
-const REGISTRY_DIR = join(HOME, '.claude', 'MEMORY', 'progress');
+const OPENCODE_DIR = process.env.OPENCODE_DIR
+  ? resolve(process.env.OPENCODE_DIR)
+  : join(HOME, '.opencode');
+const REGISTRY_DIR = join(OPENCODE_DIR, 'MEMORY', 'progress');
 
 interface TestStep {
   step: string;

.opencode/PAI/Tools/GenerateSkillIndex.ts

@@ -5,7 +5,7 @@
  * Parses all SKILL.md files and builds a searchable index for dynamic skill discovery.
  * Run this after adding/modifying skills to update the index.
  *
- * Usage: bun run ~/.opencode/skills/PAI/Tools/GenerateSkillIndex.ts
+ * Usage: bun run ~/.opencode/PAI/Tools/GenerateSkillIndex.ts
  *
  * Output: ~/.opencode/skills/skill-index.json
  */

.opencode/PAI/Tools/GetCounts.ts

@@ -37,7 +37,7 @@ import { readdirSync, existsSync, statSync } from "fs";
 import { join } from "path";
 
 const HOME = process.env.HOME!;
-const PAI_DIR = process.env.PAI_DIR || join(HOME, ".claude");
+const PAI_DIR = process.env.OPENCODE_DIR || join(HOME, ".opencode");
 
 interface Counts {
   skills: number;

.opencode/PAI/Tools/IntegrityMaintenance.ts

@@ -108,8 +108,9 @@ interface UpdateData {
 // Constants
 // ============================================================================
 
-const PAI_DIR = process.env.HOME + '/.claude';
-const CREATE_UPDATE_SCRIPT = join(PAI_DIR, 'skills/_SYSTEM/Tools/CreateUpdate.ts');
+const OPENCODE_DIR = process.env.OPENCODE_DIR || process.env.HOME + '/.opencode';
+const CREATE_UPDATE_SCRIPT = join(OPENCODE_DIR, 'skills/_SYSTEM/Tools/CreateUpdate.ts');
+const UPDATE_SEARCH_SCRIPT = join(OPENCODE_DIR, 'PAI', 'Tools', 'UpdateSearch.ts');
 
 // Words that indicate generic/bad titles - reject these
 const GENERIC_TITLE_PATTERNS = [
@@ -719,7 +720,7 @@ async function generateVerboseNarrative(
         future_impact: aiNarrative.future_impact,
         future_bullets: aiNarrative.future_bullets,
         verification_steps: aiNarrative.verification_steps,
-        verification_commands: [`bun ~/.claude/skills/_SYSTEM/Tools/UpdateSearch.ts recent 5`],
+        verification_commands: [`bun ${UPDATE_SEARCH_SCRIPT} recent 5`],
         confidence: 'high',
       },
       aiTitle: aiNarrative.title,
@@ -749,7 +750,7 @@ async function generateVerboseNarrative(
       future_impact: `The ${changeType.replace('_', ' ')} will use updated behavior.`,
       future_bullets: ['Changes are active for future sessions'],
       verification_steps: ['Changes applied via automatic detection'],
-      verification_commands: [`bun ~/.claude/skills/_SYSTEM/Tools/UpdateSearch.ts recent 5`],
+      verification_commands: [`bun ${UPDATE_SEARCH_SCRIPT} recent 5`],
       confidence: 'medium',
     },
   };

.opencode/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.OPENCODE_DIR || path.join(process.env.HOME!, ".opencode");
 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");

.opencode/PAI/Tools/LoadSkillConfig.ts

@@ -250,7 +250,7 @@ Usage:
   bun LoadSkillConfig.ts --check <skill-name>      Check if skill has customizations
 
 Examples:
-  bun LoadSkillConfig.ts ~/.opencode/skills/PAIUpgrade sources.json
+  bun LoadSkillConfig.ts ~/.opencode/skills/Utilities/PAIUpgrade sources.json
   bun LoadSkillConfig.ts --list
   bun LoadSkillConfig.ts --check PAIUpgrade
 `);

.opencode/PAI/Tools/NeofetchBanner.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.OPENCODE_DIR || join(HOME, ".opencode");
 
 // ═══════════════════════════════════════════════════════════════════════
 // Terminal Width Detection

.opencode/PAI/Tools/OpinionTracker.ts

@@ -24,7 +24,7 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
 import { join } from 'path';
 
-const PAI_DIR = process.env.PAI_DIR || join(process.env.HOME!, '.claude');
+const PAI_DIR = process.env.OPENCODE_DIR || process.env.PAI_DIR || join(process.env.HOME!, '.opencode');
 const OPINIONS_FILE = join(PAI_DIR, 'PAI/USER/OPINIONS.md');
 const RELATIONSHIP_LOG = join(PAI_DIR, 'MEMORY/RELATIONSHIP');
 

.opencode/PAI/Tools/RelationshipReflect.ts

@@ -29,7 +29,7 @@ import { readFileSync, writeFileSync, existsSync, readdirSync, mkdirSync } from
 import { join } from 'path';
 import { execFileSync } from 'child_process';
 
-const PAI_DIR = process.env.PAI_DIR || join(process.env.HOME!, '.claude');
+const PAI_DIR = process.env.OPENCODE_DIR || join(process.env.HOME!, '.opencode');
 
 interface RelationshipNote {
   type: 'W' | 'B' | 'O';

.opencode/PAI/Tools/RemoveBg.ts

@@ -11,7 +11,7 @@
  *   remove-bg input.png output.png         # Saves to new file
  *   remove-bg file1.png file2.png file3.png # Batch process
  *
- * @see ~/.claude/skills/Images/SKILL.md
+ * @see ~/.opencode/skills/Media/Art/SKILL.md
  */
 
 import { readFile, writeFile } from "node:fs/promises";

.opencode/PAI/Tools/SessionHarvester.ts

@@ -2,7 +2,7 @@
 /**
  * SessionHarvester - Extract learnings from Claude Code session transcripts
  *
- * Harvests insights from ~/.claude/projects/ sessions and writes to LEARNING/
+ * Harvests insights from ~/.opencode/projects/ sessions and writes to LEARNING/
  *
  * Commands:
  *   --recent N     Harvest from N most recent sessions (default: 10)
@@ -19,19 +19,17 @@
 import { parseArgs } from "util";
 import * as fs from "fs";
 import * as path from "path";
-import { getLearningCategory, isLearningCapture } from "../../hooks/lib/learning-utils";
+import { getLearningCategory, isLearningCapture } from "../../plugins/lib/learning-utils";
 
 // ============================================================================
 // Configuration
 // ============================================================================
 
-const CLAUDE_DIR = path.join(process.env.HOME!, ".claude");
-// Derive the project slug dynamically from CLAUDE_DIR (works on macOS and Linux)
-// macOS: ${HOME}/.claude → -Users-username--claude
-// Linux: /home/username/.claude → -home-username--claude
-const CWD_SLUG = CLAUDE_DIR.replace(/[\/\.]/g, "-");
-const PROJECTS_DIR = path.join(CLAUDE_DIR, "projects", CWD_SLUG);
-const LEARNING_DIR = path.join(CLAUDE_DIR, "MEMORY", "LEARNING");
+const OPENCODE_DIR = process.env.OPENCODE_DIR || path.join(process.env.HOME!, ".opencode");
+// Derive the project slug dynamically from current working directory
+const CWD_SLUG = process.cwd().replace(/[\/\.]/g, "-");
+const PROJECTS_DIR = path.join(OPENCODE_DIR, "projects", CWD_SLUG);
+const LEARNING_DIR = path.join(OPENCODE_DIR, "MEMORY", "LEARNING");
 
 // Patterns indicating learning moments in conversations
 const CORRECTION_PATTERNS = [

.opencode/PAI/Tools/SessionProgress.ts

@@ -6,7 +6,7 @@
  * Based on Anthropic's claude-progress.txt pattern.
  *
  * Usage:
- *   bun run ~/.claude/PAI/Tools/SessionProgress.ts <command> [options]
+ *   bun run ~/.opencode/PAI/Tools/SessionProgress.ts <command> [options]
  */
 
 import { existsSync, readFileSync, writeFileSync, readdirSync, mkdirSync } from 'fs';
@@ -52,7 +52,7 @@ interface SessionProgress {
 }
 
 // Progress files are now in STATE/progress/ (consolidated from MEMORY/PROGRESS/)
-const PROGRESS_DIR = join(HOME, '.claude', 'MEMORY', 'STATE', 'progress');
+const PROGRESS_DIR = join(process.env.OPENCODE_DIR || join(HOME, '.opencode'), 'MEMORY', 'STATE', 'progress');
 
 function getProgressPath(project: string): string {
   // Validate project name to prevent path traversal