claudecode-omc 4.3.4

package/hooks/hooks.json

@@ -0,0 +1,202 @@
+{
+  "description": "OMC orchestration hooks with async capabilities",
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/keyword-detector.mjs\"",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/skill-injector.mjs\"",
+            "timeout": 3
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/session-start.mjs\"",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/project-memory-session.mjs\"",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "init",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/setup-init.mjs\"",
+            "timeout": 30
+          }
+        ]
+      },
+      {
+        "matcher": "maintenance",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/setup-maintenance.mjs\"",
+            "timeout": 60
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/pre-tool-enforcer.mjs\"",
+            "timeout": 3
+          }
+        ]
+      },
+      {
+        "matcher": "TeamCreate|ExitPlanMode",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/context-safety.mjs\"",
+            "timeout": 3
+          }
+        ]
+      }
+    ],
+    "PermissionRequest": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/permission-handler.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/post-tool-verifier.mjs\"",
+            "timeout": 3
+          },
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/project-memory-posttool.mjs\"",
+            "timeout": 3
+          }
+        ]
+      }
+    ],
+    "PostToolUseFailure": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/post-tool-use-failure.mjs\"",
+            "timeout": 3
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/subagent-tracker.mjs\" start",
+            "timeout": 3
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/subagent-tracker.mjs\" stop",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/verify-deliverables.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/pre-compact.mjs\"",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/project-memory-precompact.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/context-guard-stop.mjs\"",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/persistent-mode.cjs\"",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/code-simplifier.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh \"${CLAUDE_PLUGIN_ROOT}/scripts/find-node.sh\" \"${CLAUDE_PLUGIN_ROOT}/scripts/session-end.mjs\"",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,117 @@
+{
+  "name": "claudecode-omc",
+  "version": "4.3.4",
+  "description": "Multi-agent orchestration system for Claude Code - Inspired by oh-my-opencode",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "oh-my-claudecode": "dist/cli/index.js",
+    "omc": "dist/cli/index.js",
+    "omc-analytics": "dist/cli/analytics.js",
+    "omc-cli": "dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "agents",
+    "bridge",
+    "bridge/mcp-server.cjs",
+    "bridge/codex-server.cjs",
+    "bridge/gemini-server.cjs",
+    "bridge/team-bridge.cjs",
+    "commands",
+    "hooks",
+    "scripts",
+    "skills",
+    "templates",
+    "docs",
+    ".claude-plugin",
+    ".mcp.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && node scripts/build-skill-bridge.mjs && node scripts/build-mcp-server.mjs && node scripts/build-codex-server.mjs && node scripts/build-gemini-server.mjs && node scripts/build-bridge-entry.mjs && npm run compose-docs",
+    "build:bridge": "node scripts/build-skill-bridge.mjs",
+    "build:codex": "node scripts/build-codex-server.mjs",
+    "build:gemini": "node scripts/build-gemini-server.mjs",
+    "build:bridge-entry": "node scripts/build-bridge-entry.mjs",
+    "compose-docs": "node scripts/compose-docs.mjs",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src",
+    "format": "prettier --write src/**/*.ts",
+    "sync-metadata": "tsx scripts/sync-metadata.ts",
+    "sync-metadata:verify": "tsx scripts/sync-metadata.ts --verify",
+    "sync-metadata:dry-run": "tsx scripts/sync-metadata.ts --dry-run",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build && npm run compose-docs"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.1.0",
+    "@ast-grep/napi": "^0.31.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@tokscale/core": "^1.0.25",
+    "@types/better-sqlite3": "^7.6.13",
+    "ajv": "^8.17.1",
+    "better-sqlite3": "^12.6.2",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "jsonc-parser": "^3.3.1",
+    "safe-regex": "^2.1.1",
+    "vscode-languageserver-protocol": "^3.17.5",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^22.19.7",
+    "@typescript-eslint/eslint-plugin": "^8.18.2",
+    "@typescript-eslint/parser": "^8.18.2",
+    "@vitest/ui": "^4.0.17",
+    "esbuild": "^0.27.2",
+    "eslint": "^9.17.0",
+    "prettier": "^3.4.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.53.0",
+    "vitest": "^4.0.17"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Yeachan-Heo/oh-my-claudecode.git"
+  },
+  "homepage": "https://github.com/Yeachan-Heo/oh-my-claudecode#readme",
+  "bugs": {
+    "url": "https://github.com/Yeachan-Heo/oh-my-claudecode/issues"
+  },
+  "author": "Yeachan Heo",
+  "license": "MIT",
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "agent",
+    "multi-agent",
+    "orchestration",
+    "omc",
+    "claudecode",
+    "anthropic",
+    "llm"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/build-bridge-entry.mjs

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * Build script for standalone Team Bridge entry point bundle
+ * Bundles the bridge entry into a standalone JS file for plugin distribution
+ */
+
+import * as esbuild from 'esbuild';
+import { mkdir } from 'fs/promises';
+
+// Output to bridge/ directory (not gitignored) for plugin distribution
+const outfile = 'bridge/team-bridge.cjs';
+
+// Ensure output directory exists
+await mkdir('bridge', { recursive: true });
+
+// Preamble: resolve global npm modules so externalized native packages
+// (like @ast-grep/napi) can be found when running from plugin cache
+const banner = `
+// Resolve global npm modules for native package imports
+try {
+  var _cp = require('child_process');
+  var _Module = require('module');
+  var _globalRoot = _cp.execSync('npm root -g', { encoding: 'utf8', timeout: 5000 }).trim();
+  if (_globalRoot) {
+    var _sep = process.platform === 'win32' ? ';' : ':';
+    process.env.NODE_PATH = _globalRoot + (process.env.NODE_PATH ? _sep + process.env.NODE_PATH : '');
+    _Module._initPaths();
+  }
+} catch (_e) { /* npm not available - native modules will gracefully degrade */ }
+`;
+
+await esbuild.build({
+  entryPoints: ['src/team/bridge-entry.ts'],
+  bundle: true,
+  platform: 'node',
+  target: 'node18',
+  format: 'cjs',
+  outfile,
+  banner: { js: banner },
+  // Externalize Node.js built-ins and native modules
+  external: [
+    'fs', 'path', 'os', 'util', 'stream', 'events',
+    'buffer', 'crypto', 'http', 'https', 'url',
+    'child_process', 'assert', 'module', 'net', 'tls',
+    'dns', 'readline', 'tty', 'worker_threads',
+    // Native modules that can't be bundled
+    '@ast-grep/napi',
+    'better-sqlite3',
+  ],
+});
+
+console.log(`Built ${outfile}`);

package/scripts/build-codex-server.mjs

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+/**
+ * Build script for standalone Codex MCP server bundle
+ * Bundles the Codex MCP server into a standalone JS file for plugin distribution
+ */
+
+import * as esbuild from 'esbuild';
+import { mkdir, readdir, readFile } from 'fs/promises';
+import { basename, join } from 'path';
+
+// Output to bridge/ directory (not gitignored) for plugin distribution
+const outfile = 'bridge/codex-server.cjs';
+
+// Scan agents/*.md at build time to embed roles and prompts in the bundle.
+// This eliminates fragile runtime filesystem scanning from CJS bundles.
+const agentFiles = (await readdir('agents')).filter(f => f.endsWith('.md')).sort();
+const agentRoles = agentFiles.map(f => basename(f, '.md'));
+
+// Read and strip frontmatter from each agent prompt
+const agentPrompts = {};
+for (const file of agentFiles) {
+  const content = await readFile(join('agents', file), 'utf-8');
+  const match = content.match(/^---[\s\S]*?---\s*([\s\S]*)$/);
+  agentPrompts[basename(file, '.md')] = match ? match[1].trim() : content.trim();
+}
+console.log(`Embedding ${agentRoles.length} agent roles + prompts into ${outfile}`);
+
+// Scan agents.codex/*.md at build time to embed Codex-specific prompts
+const codexPrompts = {};
+try {
+  const codexFiles = (await readdir('agents.codex'))
+    .filter(f => f.endsWith('.md') && f !== 'CONVERSION-GUIDE.md').sort();
+  for (const file of codexFiles) {
+    const content = await readFile(join('agents.codex', file), 'utf-8');
+    const match = content.match(/^---[\s\S]*?---\s*([\s\S]*)$/);
+    codexPrompts[basename(file, '.md')] = match ? match[1].trim() : content.trim();
+  }
+  console.log(`Embedding ${Object.keys(codexPrompts).length} Codex agent prompts`);
+} catch { /* agents.codex/ not present - OK */ }
+
+// Warn about agents missing Codex-specific prompts
+for (const role of agentRoles) {
+  if (!codexPrompts[role]) {
+    console.warn(`WARNING: Agent '${role}' has no Codex-specific prompt in agents.codex/`);
+  }
+}
+
+// Ensure output directory exists
+await mkdir('bridge', { recursive: true });
+
+// Preamble: resolve global npm modules so externalized native packages
+// (like @ast-grep/napi) can be found when running from plugin cache
+const banner = `
+// Resolve global npm modules for native package imports
+try {
+  var _cp = require('child_process');
+  var _Module = require('module');
+  var _globalRoot = _cp.execSync('npm root -g', { encoding: 'utf8', timeout: 5000 }).trim();
+  if (_globalRoot) {
+    var _sep = process.platform === 'win32' ? ';' : ':';
+    process.env.NODE_PATH = _globalRoot + (process.env.NODE_PATH ? _sep + process.env.NODE_PATH : '');
+    _Module._initPaths();
+  }
+} catch (_e) { /* npm not available - native modules will gracefully degrade */ }
+`;
+
+await esbuild.build({
+  entryPoints: ['src/mcp/codex-standalone-server.ts'],
+  bundle: true,
+  platform: 'node',
+  target: 'node18',
+  format: 'cjs',
+  outfile,
+  banner: { js: banner },
+  // Inject build-time constants: agent roles list and prompt contents
+  define: {
+    '__AGENT_ROLES__': JSON.stringify(agentRoles),
+    '__AGENT_PROMPTS__': JSON.stringify(agentPrompts),
+    '__AGENT_PROMPTS_CODEX__': JSON.stringify(codexPrompts),
+  },
+  // Prefer ESM entry points so UMD packages (e.g. jsonc-parser) get properly bundled
+  mainFields: ['module', 'main'],
+  // Externalize Node.js built-ins and native modules
+  external: [
+    'fs', 'path', 'os', 'util', 'stream', 'events',
+    'buffer', 'crypto', 'http', 'https', 'url',
+    'child_process', 'assert', 'module', 'net', 'tls',
+    'dns', 'readline', 'tty', 'worker_threads',
+    // Native modules that can't be bundled
+    '@ast-grep/napi',
+    'better-sqlite3',
+  ],
+});
+
+console.log(`Built ${outfile}`);

package/scripts/build-gemini-server.mjs

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+/**
+ * Build script for standalone Gemini MCP server bundle
+ * Bundles the Gemini MCP server into a standalone JS file for plugin distribution
+ */
+
+import * as esbuild from 'esbuild';
+import { mkdir, readdir, readFile } from 'fs/promises';
+import { basename, join } from 'path';
+
+// Output to bridge/ directory (not gitignored) for plugin distribution
+const outfile = 'bridge/gemini-server.cjs';
+
+// Scan agents/*.md at build time to embed roles and prompts in the bundle.
+// This eliminates fragile runtime filesystem scanning from CJS bundles.
+const agentFiles = (await readdir('agents')).filter(f => f.endsWith('.md')).sort();
+const agentRoles = agentFiles.map(f => basename(f, '.md'));
+
+// Read and strip frontmatter from each agent prompt
+const agentPrompts = {};
+for (const file of agentFiles) {
+  const content = await readFile(join('agents', file), 'utf-8');
+  const match = content.match(/^---[\s\S]*?---\s*([\s\S]*)$/);
+  agentPrompts[basename(file, '.md')] = match ? match[1].trim() : content.trim();
+}
+console.log(`Embedding ${agentRoles.length} agent roles + prompts into ${outfile}`);
+
+// Ensure output directory exists
+await mkdir('bridge', { recursive: true });
+
+// Preamble: resolve global npm modules so externalized native packages
+// (like @ast-grep/napi) can be found when running from plugin cache
+const banner = `
+// Resolve global npm modules for native package imports
+try {
+  var _cp = require('child_process');
+  var _Module = require('module');
+  var _globalRoot = _cp.execSync('npm root -g', { encoding: 'utf8', timeout: 5000 }).trim();
+  if (_globalRoot) {
+    var _sep = process.platform === 'win32' ? ';' : ':';
+    process.env.NODE_PATH = _globalRoot + (process.env.NODE_PATH ? _sep + process.env.NODE_PATH : '');
+    _Module._initPaths();
+  }
+} catch (_e) { /* npm not available - native modules will gracefully degrade */ }
+`;
+
+await esbuild.build({
+  entryPoints: ['src/mcp/gemini-standalone-server.ts'],
+  bundle: true,
+  platform: 'node',
+  target: 'node18',
+  format: 'cjs',
+  outfile,
+  banner: { js: banner },
+  // Inject build-time constants: agent roles list and prompt contents
+  define: {
+    '__AGENT_ROLES__': JSON.stringify(agentRoles),
+    '__AGENT_PROMPTS__': JSON.stringify(agentPrompts),
+  },
+  // Prefer ESM entry points so UMD packages (e.g. jsonc-parser) get properly bundled
+  mainFields: ['module', 'main'],
+  // Externalize Node.js built-ins and native modules
+  external: [
+    'fs', 'path', 'os', 'util', 'stream', 'events',
+    'buffer', 'crypto', 'http', 'https', 'url',
+    'child_process', 'assert', 'module', 'net', 'tls',
+    'dns', 'readline', 'tty', 'worker_threads',
+    // Native modules that can't be bundled
+    '@ast-grep/napi',
+    'better-sqlite3',
+  ],
+});
+
+console.log(`Built ${outfile}`);

package/scripts/build-mcp-server.mjs

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/**
+ * Build script for standalone MCP server bundle
+ * Bundles the MCP server into a standalone JS file for plugin distribution
+ */
+
+import * as esbuild from 'esbuild';
+import { mkdir } from 'fs/promises';
+
+// Output to bridge/ directory (not gitignored) for plugin distribution
+const outfile = 'bridge/mcp-server.cjs';
+
+// Ensure output directory exists
+await mkdir('bridge', { recursive: true });
+
+// Preamble: resolve global npm modules so externalized native packages
+// (like @ast-grep/napi) can be found when running from plugin cache
+const banner = `
+// Resolve global npm modules for native package imports
+try {
+  var _cp = require('child_process');
+  var _Module = require('module');
+  var _globalRoot = _cp.execSync('npm root -g', { encoding: 'utf8', timeout: 5000 }).trim();
+  if (_globalRoot) {
+    var _sep = process.platform === 'win32' ? ';' : ':';
+    process.env.NODE_PATH = _globalRoot + (process.env.NODE_PATH ? _sep + process.env.NODE_PATH : '');
+    _Module._initPaths();
+  }
+} catch (_e) { /* npm not available - native modules will gracefully degrade */ }
+`;
+
+await esbuild.build({
+  entryPoints: ['src/mcp/standalone-server.ts'],
+  bundle: true,
+  platform: 'node',
+  target: 'node18',
+  format: 'cjs',
+  outfile,
+  banner: { js: banner },
+  // Prefer ESM entry points so UMD packages (e.g. jsonc-parser) get properly bundled
+  mainFields: ['module', 'main'],
+  // Externalize Node.js built-ins and native modules
+  external: [
+    'fs', 'path', 'os', 'util', 'stream', 'events',
+    'buffer', 'crypto', 'http', 'https', 'url',
+    'child_process', 'assert', 'module', 'net', 'tls',
+    'dns', 'readline', 'tty', 'worker_threads',
+    // Native modules that can't be bundled
+    '@ast-grep/napi',
+    'better-sqlite3',
+  ],
+});
+
+console.log(`Built ${outfile}`);

package/scripts/build-skill-bridge.mjs

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * Build script for skill-bridge.cjs bundle
+ * Bundles the TypeScript learner bridge module into a standalone CJS file
+ * that skill-injector.mjs can require()
+ */
+
+import * as esbuild from 'esbuild';
+import { mkdir } from 'fs/promises';
+import { dirname } from 'path';
+
+const outfile = 'dist/hooks/skill-bridge.cjs';
+
+// Ensure output directory exists
+await mkdir(dirname(outfile), { recursive: true });
+
+await esbuild.build({
+  entryPoints: ['src/hooks/learner/bridge.ts'],
+  bundle: true,
+  platform: 'node',
+  target: 'node18',
+  format: 'cjs',
+  outfile,
+  // Externalize Node.js built-ins (they're available at runtime)
+  external: [
+    'fs', 'path', 'os', 'util', 'stream', 'events',
+    'buffer', 'crypto', 'http', 'https', 'url',
+    'child_process', 'assert', 'module'
+  ],
+});
+
+console.log(`Built ${outfile}`);