@jaggerxtrm/specialists 2.1.2 → 2.1.4

package/bin/install.js

@@ -1,14 +1,18 @@
 #!/usr/bin/env node
-// OmniSpecialist Installer
-// Usage: npx --package=github:Jaggerxtrm/specialists install
+// Specialists Installer
+// Usage: npx --package=@jaggerxtrm/specialists install
 
 import { spawnSync } from 'node:child_process';
-import { existsSync, mkdirSync } from 'node:fs';
+import { existsSync, mkdirSync, writeFileSync, readFileSync, chmodSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 
 const HOME            = homedir();
 const SPECIALISTS_DIR = join(HOME, '.agents', 'specialists');
+const CLAUDE_DIR      = join(HOME, '.claude');
+const HOOKS_DIR       = join(CLAUDE_DIR, 'hooks');
+const SETTINGS_FILE   = join(CLAUDE_DIR, 'settings.json');
+const HOOK_FILE       = join(HOOKS_DIR, 'specialists-main-guard.mjs');
 const MCP_NAME        = 'specialists';
 const GITHUB_PKG      = '@jaggerxtrm/specialists';
 
@@ -72,8 +76,93 @@ function registerMCP() {
   return true;
 }
 
+// ── Hook installation ─────────────────────────────────────────────────────────
+
+const HOOK_SCRIPT = `#!/usr/bin/env node
+// specialists — Claude Code PreToolUse hook
+// Blocks writes and git commit/push on main/master branch.
+// Exit 0: allow  |  Exit 2: block (message shown to user)
+//
+// Installed by: npx --package=@jaggerxtrm/specialists install
+
+import { execSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+
+let branch = '';
+try {
+  branch = execSync('git branch --show-current', {
+    encoding: 'utf8',
+    stdio: ['pipe', 'pipe', 'pipe'],
+  }).trim();
+} catch {}
+
+if (!branch || (branch !== 'main' && branch !== 'master')) {
+  process.exit(0);
+}
+
+let input;
+try {
+  input = JSON.parse(readFileSync(0, 'utf8'));
+} catch {
+  process.exit(0);
+}
+
+const tool = input.tool_name ?? '';
+const blockMsg =
+  \`⛔ Direct edits on '\${branch}' are not allowed.\\n\` +
+  \`Create a feature branch first: git checkout -b feature/<name>\`;
+
+const WRITE_TOOLS = new Set(['Edit', 'Write', 'MultiEdit', 'NotebookEdit']);
+
+if (WRITE_TOOLS.has(tool)) {
+  process.stderr.write(blockMsg + '\\n');
+  process.exit(2);
+}
+
+if (tool === 'Bash') {
+  const cmd = input.tool_input?.command ?? '';
+  if (/^git (commit|push)/.test(cmd)) {
+    process.stderr.write(blockMsg + '\\n');
+    process.exit(2);
+  }
+}
+
+process.exit(0);
+`;
+
+const HOOK_ENTRY = {
+  matcher: 'Edit|Write|MultiEdit|NotebookEdit|Bash',
+  hooks: [{ type: 'command', command: HOOK_FILE }],
+};
+
+function installHook() {
+  // 1. Write hook script
+  mkdirSync(HOOKS_DIR, { recursive: true });
+  writeFileSync(HOOK_FILE, HOOK_SCRIPT, 'utf8');
+  chmodSync(HOOK_FILE, 0o755);
+
+  // 2. Merge into ~/.claude/settings.json
+  let settings = {};
+  if (existsSync(SETTINGS_FILE)) {
+    try { settings = JSON.parse(readFileSync(SETTINGS_FILE, 'utf8')); } catch { /* malformed, overwrite */ }
+  }
+
+  if (!Array.isArray(settings.hooks?.PreToolUse)) {
+    settings.hooks = settings.hooks ?? {};
+    settings.hooks.PreToolUse = [];
+  }
+
+  // Idempotent: remove any previous specialists-main-guard entry, re-add
+  settings.hooks.PreToolUse = settings.hooks.PreToolUse
+    .filter(e => !e.hooks?.some(h => h.command?.includes('specialists-main-guard')));
+  settings.hooks.PreToolUse.push(HOOK_ENTRY);
+
+  mkdirSync(CLAUDE_DIR, { recursive: true });
+  writeFileSync(SETTINGS_FILE, JSON.stringify(settings, null, 2) + '\n', 'utf8');
+}
+
 // ── Main ──────────────────────────────────────────────────────────────────────
-console.log('\n' + bold('  OmniSpecialist — full-stack installer'));
+console.log('\n' + bold('  Specialists — full-stack installer'));
 
 // 1. pi
 section('pi  (coding agent runtime)');
@@ -119,7 +208,16 @@ if (!existsSync(SPECIALISTS_DIR)) {
   skip('~/.agents/specialists/ already exists');
 }
 
-// 6. Health check
+// 6. Claude Code hooks
+section('Claude Code hooks');
+const hookExisted = existsSync(HOOK_FILE);
+installHook();
+hookExisted
+  ? ok('main-guard hook updated')
+  : ok('main-guard hook installed → ~/.claude/hooks/specialists-main-guard.sh');
+info('Blocks Edit/Write/git commit/push on main or master branch (JS, no jq needed)');
+
+// 7. Health check
 section('Health check');
 if (isInstalled('pi')) {
   const r = spawnSync('pi', ['--list-models'], { encoding: 'utf8' });
@@ -128,9 +226,9 @@ if (isInstalled('pi')) {
     : skip('No active provider — run pi config to set one up');
 }
 
-// 7. Done
+// 8. Done
 console.log('\n' + bold(green('  Done!')));
 console.log('\n' + bold('  Next steps:'));
 console.log(`  1. ${bold('Configure pi:')} run ${yellow('pi')} then ${yellow('pi config')} to enable model providers`);
-console.log(`  2. ${bold('Restart Claude Code')} to load the MCP`);
+console.log(`  2. ${bold('Restart Claude Code')} to load the MCP and hooks`);
 console.log(`  3. ${bold('Update later:')} re-run this installer\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaggerxtrm/specialists",
-  "version": "2.1.2",
+  "version": "2.1.4",
   "description": "OmniSpecialist — 7-tool MCP orchestration layer powered by the Specialist System. Discover and execute .specialist.yaml files across project/user/system scopes via pi.",
   "main": "dist/index.js",
   "type": "module",