delimit-cli 4.1.30 → 4.1.32

package/README.md

@@ -156,6 +156,8 @@ npx delimit-cli diff old.yaml new.yaml           # Compare two specs
 npx delimit-cli explain old.yaml new.yaml        # Generate migration guide
 npx delimit-cli check                            # Pre-commit governance check
 npx delimit-cli check --staged --fix             # Check staged files + show guidance
+npx delimit-cli hooks install                    # Install git pre-commit hook
+npx delimit-cli hooks install --pre-push         # Also add pre-push hook
 npx delimit-cli ci                               # Generate GitHub Action workflow
 npx delimit-cli ci --strict --dry-run            # Preview strict workflow
 npx delimit-cli doctor                           # Check setup health

package/bin/delimit-cli.js

@@ -3044,6 +3044,140 @@ program
         }
     });
 
+// Hooks command — install/remove git hooks for governance
+program
+    .command('hooks <action>')
+    .description('Install or remove git hooks (install | remove | status)')
+    .option('--pre-push', 'Also add pre-push hook')
+    .action(async (action, opts) => {
+        const projectDir = process.cwd();
+        const gitDir = path.join(projectDir, '.git');
+
+        if (!fs.existsSync(gitDir)) {
+            console.log(chalk.red('\n  Not a git repository. Run git init first.\n'));
+            process.exitCode = 1;
+            return;
+        }
+
+        const hooksDir = path.join(gitDir, 'hooks');
+        fs.mkdirSync(hooksDir, { recursive: true });
+
+        const preCommitPath = path.join(hooksDir, 'pre-commit');
+        const prePushPath = path.join(hooksDir, 'pre-push');
+        const marker = '# delimit-governance-hook';
+
+        const preCommitHook = `#!/bin/sh
+${marker}
+# Delimit API governance gate
+# Blocks commits with breaking API changes
+npx delimit-cli check --staged
+`;
+
+        const prePushHook = `#!/bin/sh
+${marker}
+# Delimit API governance gate
+# Blocks pushes with breaking API changes
+npx delimit-cli check --base origin/main
+`;
+
+        if (action === 'install') {
+            console.log(chalk.bold('\n  Delimit Hooks\n'));
+
+            let installed = 0;
+
+            // Pre-commit hook
+            if (fs.existsSync(preCommitPath)) {
+                const existing = fs.readFileSync(preCommitPath, 'utf-8');
+                if (existing.includes(marker)) {
+                    console.log(chalk.gray('  pre-commit hook already installed'));
+                } else {
+                    // Append to existing hook
+                    fs.appendFileSync(preCommitPath, '\n' + preCommitHook.split('\n').slice(1).join('\n'));
+                    console.log(chalk.green('  + pre-commit hook added (appended to existing)'));
+                    installed++;
+                }
+            } else {
+                fs.writeFileSync(preCommitPath, preCommitHook);
+                fs.chmodSync(preCommitPath, '755');
+                console.log(chalk.green('  + pre-commit hook installed'));
+                installed++;
+            }
+
+            // Pre-push hook (optional)
+            if (opts.prePush) {
+                if (fs.existsSync(prePushPath)) {
+                    const existing = fs.readFileSync(prePushPath, 'utf-8');
+                    if (existing.includes(marker)) {
+                        console.log(chalk.gray('  pre-push hook already installed'));
+                    } else {
+                        fs.appendFileSync(prePushPath, '\n' + prePushHook.split('\n').slice(1).join('\n'));
+                        console.log(chalk.green('  + pre-push hook added (appended to existing)'));
+                        installed++;
+                    }
+                } else {
+                    fs.writeFileSync(prePushPath, prePushHook);
+                    fs.chmodSync(prePushPath, '755');
+                    console.log(chalk.green('  + pre-push hook installed'));
+                    installed++;
+                }
+            }
+
+            if (installed > 0) {
+                console.log(chalk.bold(`\n  ${installed} hook(s) installed.`));
+                console.log(chalk.gray('  Commits that introduce breaking API changes will be blocked.'));
+                console.log(chalk.gray('  Override with: git commit --no-verify\n'));
+            } else {
+                console.log(chalk.gray('\n  All hooks already installed.\n'));
+            }
+
+        } else if (action === 'remove') {
+            console.log(chalk.bold('\n  Delimit Hooks — Remove\n'));
+            let removed = 0;
+
+            for (const [hookPath, name] of [[preCommitPath, 'pre-commit'], [prePushPath, 'pre-push']]) {
+                if (fs.existsSync(hookPath)) {
+                    const content = fs.readFileSync(hookPath, 'utf-8');
+                    if (content.includes(marker)) {
+                        // If the entire hook is ours, remove it
+                        const lines = content.split('\n');
+                        const delimitStart = lines.findIndex(l => l.includes(marker));
+                        if (delimitStart <= 1) {
+                            // Whole file is ours
+                            fs.unlinkSync(hookPath);
+                            console.log(chalk.yellow(`  - ${name} hook removed`));
+                        } else {
+                            // Remove just our section
+                            const before = lines.slice(0, delimitStart).join('\n');
+                            fs.writeFileSync(hookPath, before + '\n');
+                            console.log(chalk.yellow(`  - ${name} Delimit section removed`));
+                        }
+                        removed++;
+                    }
+                }
+            }
+            if (removed === 0) {
+                console.log(chalk.gray('  No Delimit hooks found.\n'));
+            } else {
+                console.log(chalk.bold(`\n  ${removed} hook(s) removed.\n`));
+            }
+
+        } else if (action === 'status') {
+            console.log(chalk.bold('\n  Delimit Hooks — Status\n'));
+            for (const [hookPath, name] of [[preCommitPath, 'pre-commit'], [prePushPath, 'pre-push']]) {
+                if (fs.existsSync(hookPath) && fs.readFileSync(hookPath, 'utf-8').includes(marker)) {
+                    console.log(`  ${chalk.green('●')} ${name} — installed`);
+                } else {
+                    console.log(`  ${chalk.gray('○')} ${name} — not installed`);
+                }
+            }
+            console.log('');
+
+        } else {
+            console.log(chalk.red(`\n  Unknown action: ${action}`));
+            console.log(chalk.gray('  Usage: delimit hooks install | remove | status\n'));
+        }
+    });
+
 // Check command — pre-commit/pre-push governance check
 program
     .command('check')

package/lib/cross-model-hooks.js

@@ -530,6 +530,54 @@ fi
         }
     }
 
+    // --- Stop hook: session handoff on exit ---
+    if (hookConfig.session_start) {  // If session-start is enabled, also add session-end
+        if (!config.hooks.Stop) {
+            config.hooks.Stop = [];
+        }
+        const home = getHome();
+        const hooksDir = path.join(home, '.claude', 'hooks');
+        fs.mkdirSync(hooksDir, { recursive: true });
+        const stopScript = path.join(hooksDir, 'delimit-stop');
+        const delimitHome = path.join(home, '.delimit');
+        const stopContent = '#!/bin/bash\n' + `
+# Delimit Stop — session handoff on exit
+# Preserves context for next session across all AI assistants
+DELIMIT_HOME="\${DELIMIT_HOME:-${delimitHome}}"
+LEDGER_DIR="$DELIMIT_HOME/ledger"
+
+# Push ledger changes so other models pick them up
+if [ -d "$LEDGER_DIR/.git" ]; then
+  cd "$LEDGER_DIR"
+  git add -A 2>/dev/null
+  git commit -m "session handoff $(date -u +%Y-%m-%dT%H:%M:%SZ)" --no-verify 2>/dev/null
+  git push origin main 2>/dev/null &
+fi
+
+# Save session timestamp
+echo "$(date -u +%Y-%m-%dT%H:%M:%SZ)" > "$DELIMIT_HOME/.last_session_end"
+echo "[Delimit] Session context saved."
+`;
+        fs.writeFileSync(stopScript, stopContent);
+        fs.chmodSync(stopScript, '755');
+
+        const existingStop = config.hooks.Stop.find(group => {
+            const cmds = (group.hooks || []).map(h => h.command || '');
+            return cmds.some(c => c.includes('delimit'));
+        });
+        if (!existingStop) {
+            config.hooks.Stop.push({
+                matcher: '',
+                hooks: [{
+                    type: 'command',
+                    command: stopScript,
+                    timeout: 10,
+                }],
+            });
+            changes.push('Stop');
+        }
+    }
+
     // Write hooks to all target settings files
     const configJson = JSON.stringify(config, null, 2);
     for (const target of writeTargets) {
@@ -686,7 +734,7 @@ function removeClaudeHooks() {
 
         let changed = false;
 
-        for (const event of ['SessionStart', 'PreToolUse', 'PostToolUse']) {
+        for (const event of ['SessionStart', 'PreToolUse', 'PostToolUse', 'Stop']) {
             if (Array.isArray(config.hooks[event])) {
                 const before = config.hooks[event].length;
                 config.hooks[event] = config.hooks[event].filter(h => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "delimit-cli",
   "mcpName": "io.github.delimit-ai/delimit-mcp-server",
-  "version": "4.1.30",
+  "version": "4.1.32",
   "description": "Unify Claude Code, Codex, Cursor, and Gemini CLI with persistent context, governance, and multi-model debate.",
   "main": "index.js",
   "files": [