gm-cc 2.0.74 → 2.0.76

package/.claude-plugin/marketplace.json

@@ -4,7 +4,7 @@
     "name": "AnEntrypoint"
   },
   "description": "State machine agent with hooks, skills, and automated git enforcement",
-  "version": "2.0.74",
+  "version": "2.0.76",
   "metadata": {
     "description": "State machine agent with hooks, skills, and automated git enforcement"
   },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "gm",
-  "version": "2.0.74",
+  "version": "2.0.76",
   "description": "State machine agent with hooks, skills, and automated git enforcement",
   "author": {
     "name": "AnEntrypoint",

package/README.md

@@ -50,6 +50,32 @@ After running `bun x gm-cc@latest`, your project will have:
 
 Each hook runs automatically at the appropriate session event. No manual trigger needed.
 
+### Project Provisioning (Explicit Installation)
+
+To explicitly add all gm-cc hooks, agents, and skills to an existing project:
+
+```bash
+bun x gm-cc@latest -- -p
+```
+
+Or with a global installation:
+
+```bash
+gm-cc -p
+```
+
+This creates a project-local `.claude/settings.json` that configures hooks to use `${CLAUDE_PROJECT_DIR}` for project-specific environments. Useful for:
+- Explicitly provisioning gm-cc to an existing project
+- Overriding global plugin settings for a specific project
+- Team workflows requiring consistent project-level configuration
+
+The `-p` flag copies:
+- All hooks to `.claude/hooks/`
+- All agents to `.claude/agents/`
+- All skills to `.claude/skills/`
+- MCP configuration to `.claude/.mcp.json`
+- Project-specific hook settings to `.claude/settings.json`
+
 ## File Installation (Manual Setup)
 
 If you prefer manual file management, clone the repository and copy files directly:

package/cli.js

@@ -3,100 +3,227 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
-const homeDir = process.env.HOME || process.env.USERPROFILE || os.homedir();
-const claudeDir = path.join(homeDir, '.claude');
-const pluginsDir = path.join(claudeDir, 'plugins');
-const destDir = path.join(pluginsDir, 'gm-cc');
-
-const srcDir = __dirname;
-const isUpgrade = fs.existsSync(destDir);
-
-console.log(isUpgrade ? 'Upgrading gm-cc plugin...' : 'Installing gm-cc plugin...');
-
-try {
-  fs.mkdirSync(destDir, { recursive: true });
-
-  const filesToCopy = [
-    'agents',
-    'hooks',
-    'skills',
-    '.mcp.json',
-    '.claude-plugin',
-    'README.md',
-    'CLAUDE.md'
-  ];
-
-  function copyRecursive(src, dst) {
-    if (!fs.existsSync(src)) return;
-    if (fs.statSync(src).isDirectory()) {
-      fs.mkdirSync(dst, { recursive: true });
-      fs.readdirSync(src).forEach(f => copyRecursive(path.join(src, f), path.join(dst, f)));
-    } else {
-      fs.copyFileSync(src, dst);
+const args = process.argv.slice(2);
+const isProvision = args.includes('-p') || args.includes('--provision');
+
+if (isProvision) {
+  provisionProject();
+} else {
+  installGlobally();
+}
+
+function provisionProject() {
+  const projectDir = process.cwd();
+  const claudeDir = path.join(projectDir, '.claude');
+  const srcDir = __dirname;
+
+  console.log('Provisioning gm-cc to current project...');
+
+  try {
+    const filesToCopy = [
+      'agents',
+      'hooks',
+      'skills',
+      '.mcp.json'
+    ];
+
+    function copyRecursive(src, dst) {
+      if (!fs.existsSync(src)) return;
+      if (fs.statSync(src).isDirectory()) {
+        fs.mkdirSync(dst, { recursive: true });
+        fs.readdirSync(src).forEach(f => copyRecursive(path.join(src, f), path.join(dst, f)));
+      } else {
+        fs.copyFileSync(src, dst);
+      }
     }
-  }
 
-  filesToCopy.forEach(name => copyRecursive(path.join(srcDir, name), path.join(destDir, name)));
+    filesToCopy.forEach(name => copyRecursive(path.join(srcDir, name), path.join(claudeDir, name)));
 
-  // Remove stale root-level plugin.json (moved to .claude-plugin/plugin.json)
-  const stalePluginJson = path.join(destDir, 'plugin.json');
-  if (fs.existsSync(stalePluginJson)) fs.unlinkSync(stalePluginJson);
+    // Update .gitignore to exclude .gm-stop-verified
+    const gitignorePath = path.join(projectDir, '.gitignore');
+    const gitignoreEntry = '.gm-stop-verified';
 
-  // Register in settings.json (enabledPlugins only, no hook injection)
-  const settingsPath = path.join(claudeDir, 'settings.json');
-  let settings = {};
-  if (fs.existsSync(settingsPath)) {
-    try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8')); } catch (e) {}
-  }
-  if (!settings.enabledPlugins) settings.enabledPlugins = {};
-  settings.enabledPlugins['gm@gm-cc'] = true;
-  // Remove stale hook entries (handled by plugin hooks.json)
-  if (settings.hooks) delete settings.hooks;
-  // Register marketplace so Claude Code resolves gm@gm-cc locally
-  if (!settings.extraKnownMarketplaces) settings.extraKnownMarketplaces = {};
-  settings.extraKnownMarketplaces['gm-cc'] = { source: { source: 'directory', path: destDir } };
-  fs.mkdirSync(claudeDir, { recursive: true });
-  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
-  console.log('✓ Plugin registered in ~/.claude/settings.json');
-
-  // Write installed_plugins.json so Claude Code loads from local cache
-  const pluginVersion = require('./package.json').version;
-  const installedPluginsPath = path.join(pluginsDir, 'installed_plugins.json');
-  let installedPlugins = { version: 2, plugins: {} };
-  if (fs.existsSync(installedPluginsPath)) {
-    try { installedPlugins = JSON.parse(fs.readFileSync(installedPluginsPath, 'utf-8')); } catch (e) {}
+    let gitignoreContent = '';
+    if (fs.existsSync(gitignorePath)) {
+      gitignoreContent = fs.readFileSync(gitignorePath, 'utf-8');
+    }
+
+    if (!gitignoreContent.includes(gitignoreEntry)) {
+      if (gitignoreContent && !gitignoreContent.endsWith('\n')) {
+        gitignoreContent += '\n';
+      }
+      gitignoreContent += gitignoreEntry + '\n';
+      fs.writeFileSync(gitignorePath, gitignoreContent, 'utf-8');
+    }
+
+    // Generate project-specific settings.json with hook configuration
+    const settingsPath = path.join(claudeDir, 'settings.json');
+    let settings = {};
+    if (fs.existsSync(settingsPath)) {
+      try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8')); } catch (e) {}
+    }
+
+    // Configure hooks to use project-local paths with ${CLAUDE_PROJECT_DIR}
+    if (!settings.hooks) settings.hooks = {};
+    settings.hooks.PreToolUse = [{
+      matcher: '*',
+      hooks: [{
+        type: 'command',
+        command: 'node ${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-tool-use-hook.js',
+        timeout: 3600
+      }]
+    }];
+    settings.hooks.SessionStart = [{
+      matcher: '*',
+      hooks: [{
+        type: 'command',
+        command: 'node ${CLAUDE_PROJECT_DIR}/.claude/hooks/session-start-hook.js',
+        timeout: 10000
+      }]
+    }];
+    settings.hooks.UserPromptSubmit = [{
+      matcher: '*',
+      hooks: [{
+        type: 'command',
+        command: 'node ${CLAUDE_PROJECT_DIR}/.claude/hooks/prompt-submit-hook.js',
+        timeout: 3600
+      }]
+    }];
+    settings.hooks.Stop = [{
+      matcher: '*',
+      hooks: [
+        {
+          type: 'command',
+          command: 'node ${CLAUDE_PROJECT_DIR}/.claude/hooks/stop-hook.js',
+          timeout: 300000
+        },
+        {
+          type: 'command',
+          command: 'node ${CLAUDE_PROJECT_DIR}/.claude/hooks/stop-hook-git.js',
+          timeout: 60000
+        }
+      ]
+    }];
+
+    fs.mkdirSync(claudeDir, { recursive: true });
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
+
+    console.log('✓ Hooks copied to .claude/hooks/');
+    console.log('✓ Agents copied to .claude/agents/');
+    console.log('✓ Skills copied to .claude/skills/');
+    console.log('✓ MCP configuration written to .claude/.mcp.json');
+    console.log('✓ Hook configuration written to .claude/settings.json');
+    console.log('✓ .gitignore updated');
+    console.log('');
+    console.log('Provisioning complete! Your project now has:');
+    console.log('  • All gm-cc hooks in .claude/hooks/');
+    console.log('  • All agents in .claude/agents/');
+    console.log('  • All skills in .claude/skills/');
+    console.log('  • Hook configuration in .claude/settings.json');
+    console.log('');
+    console.log('Restart Claude Code to activate the hooks.');
+  } catch (e) {
+    console.error('Provisioning failed:', e.message);
+    process.exit(1);
   }
-  if (!installedPlugins.plugins || Array.isArray(installedPlugins.plugins)) installedPlugins.plugins = {};
-  const now = new Date().toISOString();
-  const existing = Array.isArray(installedPlugins.plugins['gm@gm-cc']) ? installedPlugins.plugins['gm@gm-cc'][0] : null;
-  // Also write cache dir so Claude Code finds it without network fetch
-  const cacheDir = path.join(pluginsDir, 'cache', 'gm-cc', 'gm', pluginVersion);
-  const filesToCache = ['agents', 'hooks', 'skills', '.mcp.json', '.claude-plugin', 'README.md', 'CLAUDE.md'];
-  function copyRecursiveCache(src, dst) {
-    if (!fs.existsSync(src)) return;
-    if (fs.statSync(src).isDirectory()) {
-      fs.mkdirSync(dst, { recursive: true });
-      fs.readdirSync(src).forEach(f => copyRecursiveCache(path.join(src, f), path.join(dst, f)));
-    } else { fs.copyFileSync(src, dst); }
+}
+
+function installGlobally() {
+  const homeDir = process.env.HOME || process.env.USERPROFILE || os.homedir();
+  const claudeDir = path.join(homeDir, '.claude');
+  const pluginsDir = path.join(claudeDir, 'plugins');
+  const destDir = path.join(pluginsDir, 'gm-cc');
+
+  const srcDir = __dirname;
+  const isUpgrade = fs.existsSync(destDir);
+
+  console.log(isUpgrade ? 'Upgrading gm-cc plugin...' : 'Installing gm-cc plugin...');
+
+  try {
+    fs.mkdirSync(destDir, { recursive: true });
+
+    const filesToCopy = [
+      'agents',
+      'hooks',
+      'skills',
+      '.mcp.json',
+      '.claude-plugin',
+      'README.md',
+      'CLAUDE.md'
+    ];
+
+    function copyRecursive(src, dst) {
+      if (!fs.existsSync(src)) return;
+      if (fs.statSync(src).isDirectory()) {
+        fs.mkdirSync(dst, { recursive: true });
+        fs.readdirSync(src).forEach(f => copyRecursive(path.join(src, f), path.join(dst, f)));
+      } else {
+        fs.copyFileSync(src, dst);
+      }
+    }
+
+    filesToCopy.forEach(name => copyRecursive(path.join(srcDir, name), path.join(destDir, name)));
+
+    // Remove stale root-level plugin.json (moved to .claude-plugin/plugin.json)
+    const stalePluginJson = path.join(destDir, 'plugin.json');
+    if (fs.existsSync(stalePluginJson)) fs.unlinkSync(stalePluginJson);
+
+    // Register in settings.json (enabledPlugins only, no hook injection)
+    const settingsPath = path.join(claudeDir, 'settings.json');
+    let settings = {};
+    if (fs.existsSync(settingsPath)) {
+      try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8')); } catch (e) {}
+    }
+    if (!settings.enabledPlugins) settings.enabledPlugins = {};
+    settings.enabledPlugins['gm@gm-cc'] = true;
+    // Remove stale hook entries (handled by plugin hooks.json)
+    if (settings.hooks) delete settings.hooks;
+    // Register marketplace so Claude Code resolves gm@gm-cc locally
+    if (!settings.extraKnownMarketplaces) settings.extraKnownMarketplaces = {};
+    settings.extraKnownMarketplaces['gm-cc'] = { source: { source: 'directory', path: destDir } };
+    fs.mkdirSync(claudeDir, { recursive: true });
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
+    console.log('✓ Plugin registered in ~/.claude/settings.json');
+
+    // Write installed_plugins.json so Claude Code loads from local cache
+    const pluginVersion = require('./package.json').version;
+    const installedPluginsPath = path.join(pluginsDir, 'installed_plugins.json');
+    let installedPlugins = { version: 2, plugins: {} };
+    if (fs.existsSync(installedPluginsPath)) {
+      try { installedPlugins = JSON.parse(fs.readFileSync(installedPluginsPath, 'utf-8')); } catch (e) {}
+    }
+    if (!installedPlugins.plugins || Array.isArray(installedPlugins.plugins)) installedPlugins.plugins = {};
+    const now = new Date().toISOString();
+    const existing = Array.isArray(installedPlugins.plugins['gm@gm-cc']) ? installedPlugins.plugins['gm@gm-cc'][0] : null;
+    // Also write cache dir so Claude Code finds it without network fetch
+    const cacheDir = path.join(pluginsDir, 'cache', 'gm-cc', 'gm', pluginVersion);
+    const filesToCache = ['agents', 'hooks', 'skills', '.mcp.json', '.claude-plugin', 'README.md', 'CLAUDE.md'];
+    function copyRecursiveCache(src, dst) {
+      if (!fs.existsSync(src)) return;
+      if (fs.statSync(src).isDirectory()) {
+        fs.mkdirSync(dst, { recursive: true });
+        fs.readdirSync(src).forEach(f => copyRecursiveCache(path.join(src, f), path.join(dst, f)));
+      } else { fs.copyFileSync(src, dst); }
+    }
+    fs.mkdirSync(cacheDir, { recursive: true });
+    filesToCache.forEach(name => copyRecursiveCache(path.join(destDir, name), path.join(cacheDir, name)));
+    // Remove stale root-level plugin.json from cache (moved to .claude-plugin/plugin.json)
+    const staleCachePluginJson = path.join(cacheDir, 'plugin.json');
+    if (fs.existsSync(staleCachePluginJson)) fs.unlinkSync(staleCachePluginJson);
+    installedPlugins.plugins['gm@gm-cc'] = [{
+      scope: 'user',
+      installPath: cacheDir,
+      version: pluginVersion,
+      installedAt: existing?.installedAt || now,
+      lastUpdated: now
+    }];
+    fs.writeFileSync(installedPluginsPath, JSON.stringify(installedPlugins, null, 2), 'utf-8');
+    console.log('✓ Plugin registered in installed_plugins.json');
+
+    console.log(`✓ gm-cc ${isUpgrade ? 'upgraded' : 'installed'} to ${destDir}`);
+    console.log('Restart Claude Code to activate the gm plugin.');
+  } catch (e) {
+    console.error('Installation failed:', e.message);
+    process.exit(1);
   }
-  fs.mkdirSync(cacheDir, { recursive: true });
-  filesToCache.forEach(name => copyRecursiveCache(path.join(destDir, name), path.join(cacheDir, name)));
-  // Remove stale root-level plugin.json from cache (moved to .claude-plugin/plugin.json)
-  const staleCachePluginJson = path.join(cacheDir, 'plugin.json');
-  if (fs.existsSync(staleCachePluginJson)) fs.unlinkSync(staleCachePluginJson);
-  installedPlugins.plugins['gm@gm-cc'] = [{
-    scope: 'user',
-    installPath: cacheDir,
-    version: pluginVersion,
-    installedAt: existing?.installedAt || now,
-    lastUpdated: now
-  }];
-  fs.writeFileSync(installedPluginsPath, JSON.stringify(installedPlugins, null, 2), 'utf-8');
-  console.log('✓ Plugin registered in installed_plugins.json');
-
-  console.log(`✓ gm-cc ${isUpgrade ? 'upgraded' : 'installed'} to ${destDir}`);
-  console.log('Restart Claude Code to activate the gm plugin.');
-} catch (e) {
-  console.error('Installation failed:', e.message);
-  process.exit(1);
 }

package/hooks/prompt-submit-hook.js

@@ -31,7 +31,7 @@ const runCodeSearch = (query, cwd) => {
     const escaped = query.replace(/"/g, '\\"').substring(0, 200);
     let out;
     try {
-      out = execSync(`bun x codebasesearch@latest "${escaped}"`, {
+      out = execSync(`bun x codebasesearch "${escaped}"`, {
         encoding: 'utf-8',
         stdio: ['pipe', 'pipe', 'pipe'],
         cwd,
@@ -40,7 +40,7 @@ const runCodeSearch = (query, cwd) => {
       });
     } catch (bunErr) {
       if (bunErr.killed) return '';
-      out = execSync(`npx -y codebasesearch@latest "${escaped}"`, {
+      out = execSync(`npx -y codebasesearch "${escaped}"`, {
         encoding: 'utf-8',
         stdio: ['pipe', 'pipe', 'pipe'],
         cwd,

package/hooks/session-start-hook.js

@@ -71,7 +71,7 @@ When exploring unfamiliar code, finding similar patterns, understanding integrat
     try {
       let thornOutput;
       try {
-        thornOutput = execSync(`bun x mcp-thorns@latest`, {
+        thornOutput = execSync(`bun x mcp-thorns`, {
           encoding: 'utf-8',
           stdio: ['pipe', 'pipe', 'pipe'],
           cwd: projectDir,
@@ -83,7 +83,7 @@ When exploring unfamiliar code, finding similar patterns, understanding integrat
           thornOutput = '=== mcp-thorns ===\nSkipped (3min timeout)';
         } else {
           try {
-            thornOutput = execSync(`npx -y mcp-thorns@latest`, {
+            thornOutput = execSync(`npx -y mcp-thorns`, {
               encoding: 'utf-8',
               stdio: ['pipe', 'pipe', 'pipe'],
               cwd: projectDir,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gm-cc",
-  "version": "2.0.74",
+  "version": "2.0.76",
   "description": "State machine agent with hooks, skills, and automated git enforcement",
   "author": "AnEntrypoint",
   "license": "MIT",
@@ -49,5 +49,12 @@
   ],
   "peerDependencies": {
     "@anthropic-ai/claude-code": "*"
+  },
+  "dependencies": {
+    "mcp-thorns": "latest",
+    "codebasesearch": "latest"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
   }
 }

package/scripts/postinstall.js

@@ -2,38 +2,19 @@
 
 const fs = require('fs');
 const path = require('path');
-
-/**
- * Postinstall script for gm-cc
- * Implements Mode 1: Standalone .claude/ directory installation
- * 
- * When installed via npm in a project:
- * - Copies agents/, hooks/, .mcp.json to project's .claude/
- * - Updates .gitignore with .gm-stop-verified
- * - Runs silently, never breaks npm install
- * - Safe to run multiple times (idempotent)
- */
+const { execSync } = require('child_process');
 
 function isInsideNodeModules() {
-  // Check if __dirname contains /node_modules/ in its path
-  // Example: /project/node_modules/gm-cc/scripts
   return __dirname.includes(path.sep + 'node_modules' + path.sep);
 }
 
 function getProjectRoot() {
-  // From /project/node_modules/gm-cc/scripts
-  // Navigate to /project
-  if (!isInsideNodeModules()) {
-    return null;
-  }
-  
-  // Find the node_modules parent (project root)
+  if (!isInsideNodeModules()) return null;
   let current = __dirname;
-  while (current !== path.dirname(current)) { // While not at root
+  while (current !== path.dirname(current)) {
     current = path.dirname(current);
-    const parent = path.dirname(current);
     if (path.basename(current) === 'node_modules') {
-      return parent;
+      return path.dirname(current);
     }
   }
   return null;
@@ -43,39 +24,26 @@ function safeCopyFile(src, dst) {
   try {
     const content = fs.readFileSync(src, 'utf-8');
     const dstDir = path.dirname(dst);
-    if (!fs.existsSync(dstDir)) {
-      fs.mkdirSync(dstDir, { recursive: true });
-    }
+    if (!fs.existsSync(dstDir)) fs.mkdirSync(dstDir, { recursive: true });
     fs.writeFileSync(dst, content, 'utf-8');
     return true;
   } catch (err) {
-    // Silently skip errors
     return false;
   }
 }
 
 function safeCopyDirectory(src, dst) {
   try {
-    if (!fs.existsSync(src)) {
-      return false; // Source doesn't exist, skip
-    }
-    
+    if (!fs.existsSync(src)) return false;
     fs.mkdirSync(dst, { recursive: true });
-    const entries = fs.readdirSync(src, { withFileTypes: true });
-    
-    entries.forEach(entry => {
+    fs.readdirSync(src, { withFileTypes: true }).forEach(entry => {
       const srcPath = path.join(src, entry.name);
       const dstPath = path.join(dst, entry.name);
-      
-      if (entry.isDirectory()) {
-        safeCopyDirectory(srcPath, dstPath);
-      } else if (entry.isFile()) {
-        safeCopyFile(srcPath, dstPath);
-      }
+      if (entry.isDirectory()) safeCopyDirectory(srcPath, dstPath);
+      else if (entry.isFile()) safeCopyFile(srcPath, dstPath);
     });
     return true;
   } catch (err) {
-    // Silently skip errors
     return false;
   }
 }
@@ -84,45 +52,22 @@ function updateGitignore(projectRoot) {
   try {
     const gitignorePath = path.join(projectRoot, '.gitignore');
     const entry = '.gm-stop-verified';
-    
-    // Read existing content
-    let content = '';
-    if (fs.existsSync(gitignorePath)) {
-      content = fs.readFileSync(gitignorePath, 'utf-8');
-    }
-    
-    // Check if entry already exists
-    if (content.includes(entry)) {
-      return true; // Already there
-    }
-    
-    // Append entry
-    if (content && !content.endsWith('\n')) {
-      content += '\n';
-    }
-    content += entry + '\n';
-    
-    fs.writeFileSync(gitignorePath, content, 'utf-8');
+    let content = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, 'utf-8') : '';
+    if (content.includes(entry)) return true;
+    if (content && !content.endsWith('\n')) content += '\n';
+    fs.writeFileSync(gitignorePath, content + entry + '\n', 'utf-8');
     return true;
   } catch (err) {
-    // Silently skip errors
     return false;
   }
 }
 
 function install() {
-  // Only run if inside node_modules
-  if (!isInsideNodeModules()) {
-    return; // Silent exit
-  }
-  
+  if (!isInsideNodeModules()) return;
   const projectRoot = getProjectRoot();
-  if (!projectRoot) {
-    return; // Silent exit
-  }
-  
+  if (!projectRoot) return;
   const claudeDir = path.join(projectRoot, '.claude');
-  const sourceDir = __dirname.replace(/[\/]scripts$/, ''); // Remove /scripts
+  const sourceDir = __dirname.replace(/[/\\]scripts$/, '');
   
   // Copy files
   safeCopyDirectory(path.join(sourceDir, 'agents'), path.join(claudeDir, 'agents'));
@@ -131,8 +76,26 @@ function install() {
   
   // Update .gitignore
   updateGitignore(projectRoot);
-  
+
+  // Warm bun x cache for packages used by hooks
+  warmBunCache();
+
   // Silent success
 }
 
+function warmBunCache() {
+  const packages = ['mcp-thorns@latest', 'codebasesearch@latest'];
+  for (const pkg of packages) {
+    try {
+      execSync(`bun x ${pkg} --version`, {
+        encoding: 'utf-8',
+        stdio: 'pipe',
+        timeout: 60000
+      });
+    } catch (e) {
+      // Silent - cache warming is best-effort
+    }
+  }
+}
+
 install();