gm-cc 2.0.75 → 2.0.77

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.75",
+  "version": "2.0.77",
   "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.75",
+  "version": "2.0.77",
   "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: 180000
+      }]
+    }];
+    settings.hooks.UserPromptSubmit = [{
+      matcher: '*',
+      hooks: [{
+        type: 'command',
+        command: 'node ${CLAUDE_PROJECT_DIR}/.claude/hooks/prompt-submit-hook.js',
+        timeout: 60000
+      }]
+    }];
+    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/pre-tool-use-hook.js

@@ -76,22 +76,12 @@ try {
     if (isGemini) {
       console.log(JSON.stringify({ decision: 'deny', reason: result.reason }));
     } else {
-      console.log(JSON.stringify({ hookSpecificOutput: { hookEventName: 'PreToolUse', permissionDecision: 'deny', permissionDecisionReason: result.reason } }));
+      console.log(JSON.stringify({ decision: 'block', reason: result.reason }));
     }
     process.exit(0);
   }
 
-  if (isGemini) {
-    console.log(JSON.stringify({ decision: 'allow' }));
-  } else {
-    console.log(JSON.stringify({ hookSpecificOutput: { hookEventName: 'PreToolUse', permissionDecision: 'allow' } }));
-  }
   process.exit(0);
 } catch (error) {
-  if (isGemini) {
-    console.log(JSON.stringify({ decision: 'allow' }));
-  } else {
-    console.log(JSON.stringify({ hookSpecificOutput: { hookEventName: 'PreToolUse', permissionDecision: 'allow' } }));
-  }
   process.exit(0);
 }

package/hooks/prompt-submit-hook.js

@@ -65,7 +65,7 @@ const emit = (additionalContext) => {
   } else if (isOpenCode) {
     console.log(JSON.stringify({ hookSpecificOutput: { hookEventName: 'message.updated', additionalContext } }, null, 2));
   } else {
-    console.log(JSON.stringify({ hookSpecificOutput: { hookEventName: 'UserPromptSubmit', additionalContext } }, null, 2));
+    console.log(JSON.stringify({ additionalContext }, null, 2));
   }
 };
 

package/hooks/session-start-hook.js

@@ -4,7 +4,7 @@ const fs = require('fs');
 const path = require('path');
 const { execSync } = require('child_process');
 
-const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT || process.env.GEMINI_PROJECT_DIR || process.env.OC_PLUGIN_ROOT || process.env.KILO_PLUGIN_ROOT;
+const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT || process.env.GEMINI_PROJECT_DIR || process.env.OC_PLUGIN_ROOT || process.env.KILO_PLUGIN_ROOT || path.join(__dirname, '..');
 const projectDir = process.env.CLAUDE_PROJECT_DIR || process.env.GEMINI_PROJECT_DIR || process.env.OC_PROJECT_DIR || process.env.KILO_PROJECT_DIR;
 
 const ensureGitignore = () => {
@@ -116,26 +116,11 @@ When exploring unfamiliar code, finding similar patterns, understanding integrat
   const isKilo = process.env.KILO_PLUGIN_ROOT !== undefined;
 
   if (isGemini) {
-    const result = {
-      systemMessage: additionalContext
-    };
-    console.log(JSON.stringify(result, null, 2));
+    console.log(JSON.stringify({ systemMessage: additionalContext }, null, 2));
   } else if (isOpenCode || isKilo) {
-    const result = {
-      hookSpecificOutput: {
-        hookEventName: 'session.created',
-        additionalContext
-      }
-    };
-    console.log(JSON.stringify(result, null, 2));
+    console.log(JSON.stringify({ hookSpecificOutput: { hookEventName: 'session.created', additionalContext } }, null, 2));
   } else {
-    const result = {
-      hookSpecificOutput: {
-        hookEventName: 'SessionStart',
-        additionalContext
-      }
-    };
-    console.log(JSON.stringify(result, null, 2));
+    console.log(JSON.stringify({ additionalContext }, null, 2));
   }
 } catch (error) {
   const isGemini = process.env.GEMINI_PROJECT_DIR !== undefined;
@@ -143,23 +128,11 @@ When exploring unfamiliar code, finding similar patterns, understanding integrat
   const isKilo = process.env.KILO_PLUGIN_ROOT !== undefined;
 
   if (isGemini) {
-    console.log(JSON.stringify({
-      systemMessage: `Error executing hook: ${error.message}`
-    }, null, 2));
+    console.log(JSON.stringify({ systemMessage: `Error executing hook: ${error.message}` }, null, 2));
   } else if (isOpenCode || isKilo) {
-    console.log(JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: 'session.created',
-        additionalContext: `Error executing hook: ${error.message}`
-      }
-    }, null, 2));
+    console.log(JSON.stringify({ hookSpecificOutput: { hookEventName: 'session.created', additionalContext: `Error executing hook: ${error.message}` } }, null, 2));
   } else {
-    console.log(JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: 'SessionStart',
-        additionalContext: `Error executing hook: ${error.message}`
-      }
-    }, null, 2));
+    console.log(JSON.stringify({ additionalContext: `Error executing hook: ${error.message}` }, null, 2));
   }
   process.exit(0);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gm-cc",
-  "version": "2.0.75",
+  "version": "2.0.77",
   "description": "State machine agent with hooks, skills, and automated git enforcement",
   "author": "AnEntrypoint",
   "license": "MIT",