@stanco323/oh-my-claude-code 4.10.3 → 4.11.0

package/docs/CLAUDE.md

@@ -1,5 +1,5 @@
 <!-- OMC:START -->
-<!-- OMC:VERSION:4.10.3 -->
+<!-- OMC:VERSION:4.11.0 -->
 
 # oh-my-claudecode - Intelligent Multi-Agent Orchestration
 

package/hooks/hooks.json

@@ -31,6 +31,11 @@
             "type": "command",
             "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/project-memory-session.mjs",
             "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/wiki-session-start.mjs",
+            "timeout": 5
           }
         ]
       },
@@ -150,6 +155,11 @@
             "type": "command",
             "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/project-memory-precompact.mjs",
             "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/wiki-pre-compact.mjs",
+            "timeout": 3
           }
         ]
       }
@@ -184,6 +194,11 @@
             "type": "command",
             "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/session-end.mjs",
             "timeout": 30
+          },
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PLUGIN_ROOT\"/scripts/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/scripts/wiki-session-end.mjs",
+            "timeout": 30
           }
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stanco323/oh-my-claude-code",
-  "version": "4.10.3",
+  "version": "4.11.0",
   "description": "Multi-agent orchestration system for Claude Code - Inspired by oh-my-opencode",
   "keywords": [
     "claude",

package/scripts/cleanup-orphans.mjs

@@ -24,7 +24,7 @@
 import { existsSync } from 'node:fs';
 import { execSync } from 'node:child_process';
 import { join } from 'node:path';
-import { homedir } from 'node:os';
+import { getClaudeConfigDir } from './lib/config-dir.mjs';
 
 const args = process.argv.slice(2);
 const teamNameIdx = args.indexOf('--team-name');
@@ -124,7 +124,7 @@ function getWindowsProcessListOutput() {
  * Check if a team's config still exists (i.e., team is still active).
  */
 function teamConfigExists(name) {
-  const configDir = process.env.CLAUDE_CONFIG_DIR || join(homedir(), '.claude');
+  const configDir = getClaudeConfigDir();
   const configPath = join(configDir, 'teams', name, 'config.json');
   return existsSync(configPath);
 }

package/scripts/context-guard-stop.mjs

@@ -21,8 +21,9 @@
 
 import { existsSync, readFileSync, writeFileSync, mkdirSync, statSync, openSync, readSync, closeSync } from 'node:fs';
 import { join, dirname, resolve } from 'node:path';
-import { tmpdir, homedir } from 'node:os';
+import { tmpdir } from 'node:os';
 import { execSync } from 'node:child_process';
+import { getClaudeConfigDir } from './lib/config-dir.mjs';
 import { readStdin } from './lib/stdin.mjs';
 
 const THRESHOLD = parseInt(process.env.OMC_CONTEXT_GUARD_THRESHOLD || '75', 10);
@@ -114,7 +115,7 @@ function resolveTranscriptPath(transcriptPath, cwd) {
       const lastSep = transcriptPath.lastIndexOf('/');
       const sessionFile = lastSep !== -1 ? transcriptPath.substring(lastSep + 1) : '';
       if (sessionFile) {
-        const configDir = process.env.CLAUDE_CONFIG_DIR || join(homedir(), '.claude');
+        const configDir = getClaudeConfigDir();
         const projectsDir = join(configDir, 'projects');
         if (existsSync(projectsDir)) {
           const encodedMain = mainRepoRoot.replace(/[/\\]/g, '-');
@@ -173,9 +174,14 @@ function estimateContextPercent(transcriptPath) {
  * Prevents infinite block loops by capping at MAX_BLOCKS.
  */
 function getGuardFilePath(sessionId) {
-  const configDir = process.env.CLAUDE_CONFIG_DIR || join(homedir(), '.claude');
+  const configDir = getClaudeConfigDir();
   const guardDir = join(configDir, 'projects', '.omc-guards');
-  mkdirSync(guardDir, { recursive: true, mode: 0o700 });
+  try {
+    mkdirSync(guardDir, { recursive: true, mode: 0o700 });
+  } catch (err) {
+    // On Windows, concurrent hooks can throw EEXIST even with recursive:true
+    if (err?.code !== 'EEXIST') throw err;
+  }
   return join(guardDir, `context-guard-${sessionId}.json`);
 }
 

package/scripts/find-node.sh

@@ -16,10 +16,22 @@
 
 NODE_BIN=""
 
+case "$0" in
+  */*)
+    SCRIPT_DIR="${0%/*}"
+    ;;
+  *)
+    SCRIPT_DIR='.'
+    ;;
+esac
+
+SCRIPT_DIR="$(cd "$SCRIPT_DIR" && pwd)"
+. "$SCRIPT_DIR/lib/config-dir.sh"
+
 # ---------------------------------------------------------------------------
 # 1. Read stored node path from OMC config
 # ---------------------------------------------------------------------------
-CLAUDE_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
+CLAUDE_DIR="$(resolve_claude_config_dir)"
 CONFIG_FILE="$CLAUDE_DIR/.omc-config.json"
 if [ -f "$CONFIG_FILE" ]; then
   # POSIX-safe extraction without requiring jq

package/scripts/keyword-detector.mjs

@@ -27,6 +27,7 @@ import { writeFileSync, readFileSync, mkdirSync, existsSync, unlinkSync } from '
 import { join, dirname } from 'path';
 import { homedir } from 'os';
 import { fileURLToPath } from 'url';
+import { getClaudeConfigDir } from './lib/config-dir.mjs';
 import { readStdin } from './lib/stdin.mjs';
 
 // Resolve OMC package root: CLAUDE_PLUGIN_ROOT (plugin system) or derive from this script's location
@@ -309,13 +310,14 @@ function linkRalphTeam(directory, sessionId) {
 
 /**
  * Check if the team feature is enabled in Claude Code settings.
- * Reads ~/.claude/settings.json and checks for CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS env var.
+ * Reads settings.json from [$CLAUDE_CONFIG_DIR|~/.claude] and checks for
+ * CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS env var.
  * @returns {boolean} true if team feature is enabled
  */
 function isTeamEnabled() {
   try {
     // Check settings.json first (authoritative, user-controlled)
-    const cfgDir = process.env.CLAUDE_CONFIG_DIR || join(homedir(), '.claude');
+    const cfgDir = getClaudeConfigDir();
     const settingsPath = join(cfgDir, 'settings.json');
     if (existsSync(settingsPath)) {
       const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
@@ -565,6 +567,11 @@ async function main() {
       matches.push({ name: 'analyze', args: '' });
     }
 
+    // Wiki keywords
+    if (hasActionableKeyword(cleanPrompt, /\b(wiki(?:\s+(?:this|add|lint|query))?)\b/i)) {
+      matches.push({ name: 'wiki', args: '' });
+    }
+
     // No matches - pass through
     if (matches.length === 0) {
       console.log(JSON.stringify({ continue: true, suppressOutput: true }));

package/scripts/lib/config-dir.cjs

@@ -0,0 +1,31 @@
+const { homedir } = require('node:os');
+const { join, normalize, parse, sep } = require('node:path');
+
+function stripTrailingSep(p) {
+  if (!p.endsWith(sep)) {
+    return p;
+  }
+
+  return p === parse(p).root ? p : p.slice(0, -1);
+}
+
+function getClaudeConfigDir() {
+  const home = homedir();
+  const configured = process.env.CLAUDE_CONFIG_DIR?.trim();
+
+  if (!configured) {
+    return stripTrailingSep(normalize(join(home, '.claude')));
+  }
+
+  if (configured === '~') {
+    return stripTrailingSep(normalize(home));
+  }
+
+  if (configured.startsWith('~/') || configured.startsWith('~\\')) {
+    return stripTrailingSep(normalize(join(home, configured.slice(2))));
+  }
+
+  return stripTrailingSep(normalize(configured));
+}
+
+module.exports = { getClaudeConfigDir };

package/scripts/lib/config-dir.mjs

@@ -0,0 +1,29 @@
+import { homedir } from 'node:os';
+import { join, normalize, parse, sep } from 'node:path';
+
+function stripTrailingSep(p) {
+  if (!p.endsWith(sep)) {
+    return p;
+  }
+
+  return p === parse(p).root ? p : p.slice(0, -1);
+}
+
+export function getClaudeConfigDir() {
+  const home = homedir();
+  const configured = process.env.CLAUDE_CONFIG_DIR?.trim();
+
+  if (!configured) {
+    return stripTrailingSep(normalize(join(home, '.claude')));
+  }
+
+  if (configured === '~') {
+    return stripTrailingSep(normalize(home));
+  }
+
+  if (configured.startsWith('~/') || configured.startsWith('~\\')) {
+    return stripTrailingSep(normalize(join(home, configured.slice(2))));
+  }
+
+  return stripTrailingSep(normalize(configured));
+}

package/scripts/lib/config-dir.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env sh
+
+resolve_claude_config_dir() {
+  configured="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
+  configured="${configured%/}"
+  case "$configured" in
+    \~)
+      printf '%s\n' "$HOME"
+      ;;
+    \~/*)
+      configured="${configured#\~/}"
+      printf '%s/%s\n' "$HOME" "$configured"
+      ;;
+    *)
+      printf '%s\n' "$configured"
+      ;;
+  esac
+}

package/scripts/lib/pre-tool-enforcer-preflight.mjs

@@ -0,0 +1,63 @@
+import { closeSync, openSync, readSync, statSync } from 'fs';
+
+const AGENT_HEAVY_TOOLS = new Set(['Task', 'TaskCreate', 'TaskUpdate']);
+const DEFAULT_PREFLIGHT_CONTEXT_THRESHOLD = 72;
+
+export function getPreflightContextThreshold(env = process.env) {
+  const parsed = Number.parseInt(env.OMC_AGENT_PREFLIGHT_CONTEXT_THRESHOLD || '72', 10);
+  if (Number.isNaN(parsed)) return DEFAULT_PREFLIGHT_CONTEXT_THRESHOLD;
+  return Math.max(1, Math.min(100, parsed));
+}
+
+export function estimateContextPercent(transcriptPath) {
+  if (!transcriptPath) return 0;
+
+  let fd = -1;
+  try {
+    const stat = statSync(transcriptPath);
+    if (stat.size === 0) return 0;
+
+    fd = openSync(transcriptPath, 'r');
+    const readSize = Math.min(4096, stat.size);
+    const buf = Buffer.alloc(readSize);
+    readSync(fd, buf, 0, readSize, stat.size - readSize);
+    closeSync(fd);
+    fd = -1;
+
+    const tail = buf.toString('utf-8');
+    const windowMatch = tail.match(/"context_window"\s{0,5}:\s{0,5}(\d+)/g);
+    const inputMatch = tail.match(/"input_tokens"\s{0,5}:\s{0,5}(\d+)/g);
+
+    if (!windowMatch || !inputMatch) return 0;
+
+    const lastWindow = parseInt(windowMatch[windowMatch.length - 1].match(/(\d+)/)[1], 10);
+    const lastInput = parseInt(inputMatch[inputMatch.length - 1].match(/(\d+)/)[1], 10);
+
+    if (lastWindow === 0) return 0;
+    return Math.round((lastInput / lastWindow) * 100);
+  } catch {
+    return 0;
+  } finally {
+    if (fd !== -1) try { closeSync(fd); } catch { /* ignore */ }
+  }
+}
+
+export function buildPreflightRecoveryAdvice(contextPercent, threshold = DEFAULT_PREFLIGHT_CONTEXT_THRESHOLD) {
+  return `[OMC] Preflight context guard: ${contextPercent}% used ` +
+    `(threshold: ${threshold}%). Avoid spawning additional agent-heavy tasks ` +
+    `until context is reduced. Safe recovery: (1) pause new Task fan-out, (2) run /compact now, ` +
+    `(3) if compact fails, open a fresh session and continue from .omc/state + .omc/notepad.md.`;
+}
+
+export function evaluateAgentHeavyPreflight({ toolName, transcriptPath, env = process.env }) {
+  if (!AGENT_HEAVY_TOOLS.has(toolName)) return null;
+
+  const threshold = getPreflightContextThreshold(env);
+  const contextPercent = estimateContextPercent(transcriptPath);
+  if (contextPercent < threshold) return null;
+
+  return {
+    decision: 'block',
+    reason: buildPreflightRecoveryAdvice(contextPercent, threshold),
+  };
+}

package/scripts/persistent-mode.cjs

@@ -22,7 +22,7 @@ const {
   statSync,
 } = require("fs");
 const { join, dirname, resolve, normalize } = require("path");
-const { homedir } = require("os");
+const { getClaudeConfigDir } = require("./lib/config-dir.cjs");
 
 async function readStdin(timeoutMs = 2000) {
   return new Promise((resolve) => {
@@ -208,8 +208,28 @@ function getSafeReinforcementCount(value) {
     : 0;
 }
 
+const AWAITING_CONFIRMATION_TTL_MS = 2 * 60 * 1000;
+
 function isAwaitingConfirmation(state) {
-  return state?.awaiting_confirmation === true;
+  if (!state || state.awaiting_confirmation !== true) {
+    return false;
+  }
+
+  const setAt =
+    state.awaiting_confirmation_set_at ||
+    state.started_at ||
+    null;
+
+  if (!setAt) {
+    return false;
+  }
+
+  const setAtMs = new Date(setAt).getTime();
+  if (!Number.isFinite(setAtMs)) {
+    return false;
+  }
+
+  return Date.now() - setAtMs < AWAITING_CONFIRMATION_TTL_MS;
 }
 
 // ---------------------------------------------------------------------------
@@ -413,7 +433,7 @@ function countIncompleteTasks(sessionId) {
   if (!sessionId || typeof sessionId !== "string") return 0;
   if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,255}$/.test(sessionId)) return 0;
 
-  const cfgDir = process.env.CLAUDE_CONFIG_DIR || join(homedir(), ".claude");
+  const cfgDir = getClaudeConfigDir();
   const taskDir = join(cfgDir, "tasks", sessionId);
   if (!existsSync(taskDir)) return 0;
 
@@ -447,8 +467,7 @@ function countIncompleteTodos(sessionId, projectDir) {
     /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,255}$/.test(sessionId)
   ) {
     const sessionTodoPath = join(
-      homedir(),
-      ".claude",
+      getClaudeConfigDir(),
       "todos",
       `${sessionId}.json`,
     );
@@ -529,14 +548,16 @@ const CRITICAL_CONTEXT_STOP_PERCENT = 95;
 function estimateContextPercent(transcriptPath) {
   if (!transcriptPath || !existsSync(transcriptPath)) return 0;
 
+  let fd = -1;
   try {
     const size = statSync(transcriptPath).size;
     const readSize = 4096;
     const offset = Math.max(0, size - readSize);
     const buf = Buffer.alloc(Math.min(readSize, size));
-    const fd = openSync(transcriptPath, "r");
+    fd = openSync(transcriptPath, "r");
     readSync(fd, buf, 0, buf.length, offset);
     closeSync(fd);
+    fd = -1;
     const content = buf.toString("utf-8");
 
     const windowMatch = content.match(/"context_window"\s{0,5}:\s{0,5}(\d+)/g);
@@ -549,6 +570,8 @@ function estimateContextPercent(transcriptPath) {
     return Math.round((lastInput / lastWindow) * 100);
   } catch {
     return 0;
+  } finally {
+    if (fd !== -1) try { closeSync(fd); } catch { /* best-effort */ }
   }
 }
 

package/scripts/persistent-mode.mjs

@@ -24,6 +24,7 @@ import {
 import { join, dirname, resolve, normalize } from "path";
 import { homedir } from "os";
 import { fileURLToPath, pathToFileURL } from "url";
+import { getClaudeConfigDir } from "./lib/config-dir.mjs";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -242,8 +243,28 @@ function getSafeReinforcementCount(value) {
     : 0;
 }
 
+const AWAITING_CONFIRMATION_TTL_MS = 2 * 60 * 1000;
+
 function isAwaitingConfirmation(state) {
-  return state?.awaiting_confirmation === true;
+  if (!state || state.awaiting_confirmation !== true) {
+    return false;
+  }
+
+  const setAt =
+    state.awaiting_confirmation_set_at ||
+    state.started_at ||
+    null;
+
+  if (!setAt) {
+    return false;
+  }
+
+  const setAtMs = new Date(setAt).getTime();
+  if (!Number.isFinite(setAtMs)) {
+    return false;
+  }
+
+  return Date.now() - setAtMs < AWAITING_CONFIRMATION_TTL_MS;
 }
 
 /**
@@ -398,7 +419,7 @@ function countIncompleteTasks(sessionId) {
   if (!sessionId || typeof sessionId !== "string") return 0;
   if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,255}$/.test(sessionId)) return 0;
 
-  const cfgDir = process.env.CLAUDE_CONFIG_DIR || join(homedir(), ".claude");
+  const cfgDir = getClaudeConfigDir();
   const taskDir = join(cfgDir, "tasks", sessionId);
   if (!existsSync(taskDir)) return 0;
 
@@ -432,8 +453,7 @@ function countIncompleteTodos(sessionId, projectDir) {
     /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,255}$/.test(sessionId)
   ) {
     const sessionTodoPath = join(
-      homedir(),
-      ".claude",
+      getClaudeConfigDir(),
       "todos",
       `${sessionId}.json`,
     );

package/scripts/plugin-setup.mjs

@@ -5,19 +5,24 @@
  * Configures HUD statusline when plugin is installed.
  */
 
-import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, chmodSync } from 'node:fs';
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, chmodSync, copyFileSync } from 'node:fs';
 import { execFileSync, execSync } from 'node:child_process';
 import { createRequire } from 'node:module';
 import { homedir } from 'node:os';
 import { join, dirname, resolve } from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
+import { getClaudeConfigDir } from './lib/config-dir.mjs';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-const CLAUDE_DIR = process.env.CLAUDE_CONFIG_DIR || join(homedir(), '.claude');
+const CLAUDE_DIR = getClaudeConfigDir();
 const HUD_DIR = join(CLAUDE_DIR, 'hud');
+const HUD_LIB_DIR = join(HUD_DIR, 'lib');
 const SETTINGS_FILE = join(CLAUDE_DIR, 'settings.json');
+// Use the absolute node binary path so nvm/fnm users don't get
+// "node not found" errors in non-interactive shells (issue #892).
+const nodeBin = process.execPath || 'node';
 
 console.log('[OMC] Running post-install setup...');
 
@@ -26,6 +31,11 @@ if (!existsSync(HUD_DIR)) {
   mkdirSync(HUD_DIR, { recursive: true });
 }
 
+if (!existsSync(HUD_LIB_DIR)) {
+  mkdirSync(HUD_LIB_DIR, { recursive: true });
+}
+copyFileSync(join(__dirname, 'lib', 'config-dir.mjs'), join(HUD_LIB_DIR, 'config-dir.mjs'));
+
 // 2. Create HUD wrapper script
 const hudScriptPath = join(HUD_DIR, 'omc-hud.mjs').replace(/\\/g, '/');
 const hudScript = `#!/usr/bin/env node
@@ -39,7 +49,11 @@ import { existsSync, readdirSync } from "node:fs";
 import { createRequire } from "node:module";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
-import { pathToFileURL } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const { getClaudeConfigDir } = await import(pathToFileURL(join(__dirname, "lib", "config-dir.mjs")).href);
 
 // Semantic version comparison: returns negative if a < b, positive if a > b, 0 if equal
 function semverCompare(a, b) {
@@ -133,7 +147,7 @@ async function main() {
 
   // 1. Try plugin cache first (marketplace: omc, plugin: oh-my-claudecode)
   // Respect CLAUDE_CONFIG_DIR so installs under a custom config dir are found
-  const configDir = process.env.CLAUDE_CONFIG_DIR || join(home, ".claude");
+  const configDir = getClaudeConfigDir();
   const pluginCacheBase = join(configDir, "plugins", "cache", "omc", "oh-my-claudecode");
   if (existsSync(pluginCacheBase)) {
     try {
@@ -224,9 +238,6 @@ try {
     settings = JSON.parse(readFileSync(SETTINGS_FILE, 'utf-8'));
   }
 
-  // Use the absolute node binary path so nvm/fnm users don't get
-  // "node not found" errors in non-interactive shells (issue #892).
-  const nodeBin = process.execPath || 'node';
   settings.statusLine = {
     type: 'command',
     command: `"${nodeBin}" "${hudScriptPath.replace(/\\/g, "/")}"`