@eventmodelers/cli 1.0.49 → 1.0.51

package/cli.js

@@ -918,24 +918,7 @@ async function installStack(stackKey, stackCfg, options = {}) {
     if (options.hooks) {
       const hooksSrc = join(rootSrc, '.githooks');
       if (existsSync(hooksSrc)) {
-        copyDirContents(hooksSrc, join(targetDir, '.githooks'));
-        const preCommitHook = join(targetDir, '.githooks', 'pre-commit');
-        if (existsSync(preCommitHook)) {
-          // cpSync doesn't reliably carry over the executable bit across platforms,
-          // and git silently skips a non-executable hook.
-          try { execSync(`chmod +x "${preCommitHook}"`); } catch {}
-        }
-        try {
-          execSync('git rev-parse --git-dir', { cwd: targetDir, stdio: 'ignore' });
-          // core.hooksPath is resolved against the repo's actual top level, not `cwd` —
-          // a relative `.githooks` breaks silently (no error, hooks just don't run) when
-          // targetDir is a subfolder of a larger repo rather than the repo root itself.
-          // Use an absolute path so it's correct regardless of where the git root is.
-          execSync(`git config core.hooksPath "${join(targetDir, '.githooks')}"`, { cwd: targetDir });
-          console.log('  ✓ Installed .githooks/ and set core.hooksPath — commits touching src/slices/ are now scope-guarded');
-        } catch {
-          console.log(`  ✓ Installed .githooks/ — run \`git config core.hooksPath ${join(targetDir, '.githooks')}\` once this directory is a git repo to activate it`);
-        }
+        configureHooks({ hooksSrc, targetDir });
       } else {
         console.log('  ℹ️  --hooks was given but this stack ships no .githooks/ template — nothing to install');
       }
@@ -1192,6 +1175,33 @@ async function configureMcp(options = {}) {
   }
 }
 
+// Installs/refreshes the slice commit-scope guard (.githooks/pre-commit, running
+// .build-kit/lib/check-commit-scope.cjs) and wires it up via `git config
+// core.hooksPath .githooks`. Shared by `init --hooks`, `re-init --hooks`, and the
+// standalone `init-hooks` command so all three copy/chmod/git-config identically
+// instead of drifting apart — callers are responsible for checking `hooksSrc`
+// exists first, since what "no template for this stack" means differs per caller.
+function configureHooks({ hooksSrc, targetDir }) {
+  copyDirContents(hooksSrc, join(targetDir, '.githooks'));
+  const preCommitHook = join(targetDir, '.githooks', 'pre-commit');
+  if (existsSync(preCommitHook)) {
+    // cpSync doesn't reliably carry over the executable bit across platforms,
+    // and git silently skips a non-executable hook.
+    try { execSync(`chmod +x "${preCommitHook}"`); } catch {}
+  }
+  try {
+    execSync('git rev-parse --git-dir', { cwd: targetDir, stdio: 'ignore' });
+    // core.hooksPath is resolved against the repo's actual top level, not `cwd` —
+    // a relative `.githooks` breaks silently (no error, hooks just don't run) when
+    // targetDir is a subfolder of a larger repo rather than the repo root itself.
+    // Use an absolute path so it's correct regardless of where the git root is.
+    execSync(`git config core.hooksPath "${join(targetDir, '.githooks')}"`, { cwd: targetDir });
+    console.log('  ✓ Installed .githooks/ and set core.hooksPath — commits touching src/slices/ are now scope-guarded');
+  } catch {
+    console.log(`  ✓ Installed .githooks/ — run \`git config core.hooksPath ${join(targetDir, '.githooks')}\` once this directory is a git repo to activate it`);
+  }
+}
+
 // Registers the eventmodelers MCP server in `.mcp.json` at the project root, the
 // same file/shape the `connect` skill's Step 3.5 produces — kept here as a
 // belt-and-suspenders guarantee, since an agent executing that skill can skip a
@@ -1777,6 +1787,99 @@ program
     await configureAgentHosts({ hosts, global: opts.global });
   });
 
+program
+  .command('init-hooks')
+  .description('Install/refresh the slice commit-scope guard (.githooks/pre-commit) and set `git config core.hooksPath .githooks` — same as `init --hooks`/`re-init --hooks`, for installing the latest hooks or re-pointing git config at them without a full re-scaffold')
+  .option('--stack <name>', `Which stack's .githooks/ template to install (${Object.keys(STACKS).join(', ')}) — defaults to whichever stack is recorded in install-manifest.json`)
+  .action(async (opts) => {
+    const targetDir = process.cwd();
+
+    let stackKey = opts.stack;
+    if (stackKey && !STACKS[stackKey]) {
+      console.error(`❌ Unknown stack "${stackKey}". Available: ${Object.keys(STACKS).join(', ')}`);
+      process.exit(1);
+    }
+    if (!stackKey) {
+      for (const name of KIT_DIR_NAMES) {
+        const manifest = readJsonSafe(join(targetDir, name, '.eventmodelers', 'install-manifest.json'));
+        if (manifest.stack && STACKS[manifest.stack]) {
+          stackKey = manifest.stack;
+          break;
+        }
+      }
+    }
+    if (!stackKey) {
+      console.error(`❌ Can't tell which stack's .githooks/ template to install — pass --stack <name> (${Object.keys(STACKS).join(', ')}), or run \`init\`/\`re-init\` for one of those stacks first.`);
+      process.exit(1);
+    }
+
+    const hooksSrc = join(__dirname, 'stacks', stackKey, 'templates', 'root', '.githooks');
+    if (!existsSync(hooksSrc)) {
+      console.error(`❌ "${stackKey}" ships no .githooks/ template — nothing to install.`);
+      process.exit(1);
+    }
+
+    console.log('🪝 Configuring git hooks...');
+    configureHooks({ hooksSrc, targetDir });
+  });
+
+program
+  .command('disable-hooks')
+  .description('Turn off the slice commit-scope guard by unsetting `git config core.hooksPath` — leaves .githooks/ on disk untouched; run `init-hooks` again any time to re-enable')
+  .action(() => {
+    const targetDir = process.cwd();
+
+    try {
+      execSync('git rev-parse --git-dir', { cwd: targetDir, stdio: 'ignore' });
+    } catch {
+      console.error(`❌ ${targetDir} is not a git repository — nothing to unset.`);
+      process.exit(1);
+    }
+
+    let currentHooksPath = null;
+    try {
+      currentHooksPath = execSync('git config --get core.hooksPath', { cwd: targetDir, stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim();
+    } catch {
+      // core.hooksPath isn't set — nothing to do
+    }
+
+    if (!currentHooksPath) {
+      console.log('  ℹ️  core.hooksPath is not set — the guard is already off, nothing to do.');
+      return;
+    }
+
+    execSync('git config --unset core.hooksPath', { cwd: targetDir });
+    console.log(`  ✓ Unset core.hooksPath (was "${currentHooksPath}") — the commit-scope guard is now off. Run \`init-hooks\` again to turn it back on.`);
+  });
+
+program
+  .command('run-checks')
+  .alias('run:checks')
+  .description("Run this project's commit-scope checks (.build-kit/lib/check-commit-scope.cjs, the same runner .githooks/pre-commit calls) against the currently staged changeset. Works for any build-kit stack — stacks/installs that ship no checks yet report that and exit 0, so this is safe to call unconditionally (e.g. from an agent loop) without checking the stack first.")
+  .action(() => {
+    const cwd = process.cwd();
+    // Mirrors `run`'s buildKitDir resolution: modeling-kit/bridge-kit installs share
+    // KIT_DIR_NAMES but never ship check-commit-scope.cjs, so prefer whichever
+    // installed dir isn't one of those over blindly taking the first match.
+    const installedKitDirs = findAllInstalledKitDirs(cwd);
+    const modelingKitDir = installedKitDirs.find((d) => d.endsWith(MODELING_KIT.kitDirName)) ?? null;
+    const bridgeKitDir = installedKitDirs.find((d) => d.endsWith(BRIDGE_KIT.kitDirName)) ?? null;
+    const kitDir = installedKitDirs.find((d) => d !== modelingKitDir && d !== bridgeKitDir) ?? installedKitDirs[0];
+
+    const checkScript = join(kitDir, 'lib', 'check-commit-scope.cjs');
+    if (!existsSync(checkScript)) {
+      console.log(`ℹ️  ${relative(cwd, kitDir)} ships no checks yet — nothing to run.`);
+      return;
+    }
+
+    console.log(`🔎 Running checks from ${relative(cwd, checkScript)}...`);
+    try {
+      execSync(`node "${checkScript}"`, { cwd: kitDir, stdio: 'inherit' });
+    } catch (err) {
+      process.exit(err.status || 1);
+    }
+  });
+
 credentialFlags(program
   .command('init-config')
   .description('Configure credentials only — writes .eventmodelers/config.json in the current directory, or ~/.eventmodelers/config.json with --global')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eventmodelers/cli",
-  "version": "1.0.49",
+  "version": "1.0.51",
   "description": "Eventmodelers CLI — real-time Claude agent + skills for Claude Code, for any stack (Node, Supabase, Axon, Cratis, OpenCQRS, UmaDB, Kurrent, or modeling-only)",
   "type": "module",
   "bin": {

package/stacks/node/templates/build-kit/CLAUDE.md

@@ -75,7 +75,7 @@ It loads every check under `.build-kit/lib/checks/` and rejects the commit if an
 - **tsc-build** — `npx tsc --noEmit` must still pass
 
 If a commit is rejected, split it — commit the out-of-scope file separately from the slice work, or add
-the missing test/fix the field — rather than passing `--no-verify`. Run `npm run check:scope` any time
+the missing test/fix the field — rather than passing `--no-verify`. Run `npm run run:checks` any time
 you want to check staged files before committing. To add a new check, read
 `.build-kit/lib/checks/README.md` and drop in a file following its interface — no other wiring needed.
 

package/stacks/node/templates/build-kit/lib/check-commit-scope.cjs

@@ -23,7 +23,7 @@
 //   SLICE_PATTERN   RegExp matching a path inside a slice's own folder
 //
 // Zero dependencies — plain Node, so it works from git's pre-commit hook
-// (see ../../.githooks/pre-commit), from `npm run check:scope`, or from CI.
+// (see ../../.githooks/pre-commit), from `npm run run:checks`, or from CI.
 // Invoked as: node .build-kit/lib/check-commit-scope.cjs
 
 const { execSync } = require('child_process');

package/stacks/node/templates/root/package.json

@@ -8,7 +8,7 @@
     "build": "tsc",
     "start": "NODE_ENV=production node --env-file=.env --require ts-node/register server.ts",
     "test": "tsx --test 'src/**/*.test.ts'",
-    "check:scope": "node .build-kit/lib/check-commit-scope.cjs"
+    "run:checks": "node .build-kit/lib/check-commit-scope.cjs"
   },
   "dependencies": {
     "@event-driven-io/emmett": "^0.42.1-alpha.1",

package/stacks/supabase/templates/build-kit/CLAUDE.md

@@ -79,7 +79,7 @@ and rejects the commit if any of them find a problem:
 - **tsc-build** — `npx tsc --noEmit` must still pass
 
 If a commit is rejected, split it — commit the out-of-scope file separately from the slice work, or add
-the missing test/fix the field — rather than passing `--no-verify`. Run `npm run check:scope` any time
+the missing test/fix the field — rather than passing `--no-verify`. Run `npm run run:checks` any time
 you want to check staged files before committing. To add a new check, read
 `.build-kit/lib/checks/README.md` and drop in a file following its interface — no other wiring needed.
 

package/stacks/supabase/templates/build-kit/lib/check-commit-scope.cjs

@@ -23,7 +23,7 @@
 //   SLICE_PATTERN   RegExp matching a path inside a slice's own folder
 //
 // Zero dependencies — plain Node, so it works from git's pre-commit hook
-// (see ../../.githooks/pre-commit), from `npm run check:scope`, or from CI.
+// (see ../../.githooks/pre-commit), from `npm run run:checks`, or from CI.
 // Invoked as: node .build-kit/lib/check-commit-scope.cjs
 
 const { execSync } = require('child_process');

package/stacks/supabase/templates/root/package.json

@@ -8,7 +8,7 @@
     "build": "tsc",
     "start": "NODE_ENV=production node --env-file=.env --require ts-node/register server.ts",
     "test": "tsx --test 'src/**/*.test.ts'",
-    "check:scope": "node .build-kit/lib/check-commit-scope.cjs"
+    "run:checks": "node .build-kit/lib/check-commit-scope.cjs"
   },
   "dependencies": {
     "@event-driven-io/emmett": "^0.42.1-alpha.1",