@slope-dev/slope 1.13.0 → 1.13.1

package/dist/core/adapters/claude-code.js

@@ -0,0 +1,133 @@
+// SLOPE ClaudeCodeAdapter — adapts guard framework to Claude Code's hook system.
+import { existsSync, writeFileSync, readFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { CLAUDE_CODE_TOOLS, registerAdapter } from '../harness.js';
+/** Claude Code adapter — formats guard output for Claude Code's hook protocol. */
+export class ClaudeCodeAdapter {
+    id = 'claude-code';
+    displayName = 'Claude Code';
+    toolNames = CLAUDE_CODE_TOOLS;
+    formatPreToolOutput(result) {
+        return {
+            hookSpecificOutput: {
+                hookEventName: 'PreToolUse',
+                ...(result.decision && { permissionDecision: result.decision }),
+                ...(result.blockReason && { permissionDecisionReason: result.blockReason }),
+                ...(result.context && { additionalContext: result.context }),
+            },
+        };
+    }
+    formatPostToolOutput(result) {
+        if (result.blockReason) {
+            return {
+                decision: 'block',
+                reason: result.blockReason,
+                hookSpecificOutput: {
+                    hookEventName: 'PostToolUse',
+                    ...(result.context && { additionalContext: result.context }),
+                },
+            };
+        }
+        if (result.context) {
+            return {
+                hookSpecificOutput: {
+                    hookEventName: 'PostToolUse',
+                    additionalContext: result.context,
+                },
+            };
+        }
+        return {};
+    }
+    formatStopOutput(result) {
+        if (result.blockReason) {
+            return { decision: 'block', reason: result.blockReason };
+        }
+        return {};
+    }
+    generateHooksConfig(guards, guardScriptPath) {
+        const config = {};
+        // Group guards by hookEvent + matcher
+        const groups = new Map();
+        for (const g of guards) {
+            const key = `${g.hookEvent}::${g.matcher ?? ''}`;
+            const list = groups.get(key) || [];
+            list.push(g);
+            groups.set(key, list);
+        }
+        for (const [key, defs] of groups) {
+            const [hookEvent, matcher] = key.split('::');
+            if (!config[hookEvent])
+                config[hookEvent] = [];
+            const hooks = defs.map(d => ({
+                type: 'command',
+                command: `${guardScriptPath} ${d.name}`,
+                timeout: 10,
+                statusMessage: `SLOPE: ${d.description}`,
+            }));
+            const entry = { hooks };
+            if (matcher)
+                entry.matcher = matcher;
+            config[hookEvent].push(entry);
+        }
+        return config;
+    }
+    installGuards(cwd, guards) {
+        const hooksDir = join(cwd, '.claude', 'hooks');
+        mkdirSync(hooksDir, { recursive: true });
+        // Create the guard dispatcher script
+        const dispatcherPath = join(hooksDir, 'slope-guard.sh');
+        if (!existsSync(dispatcherPath)) {
+            const script = [
+                '#!/usr/bin/env bash',
+                '# SLOPE guard dispatcher — routes hook events to slope guard handlers',
+                '# Auto-generated by slope hook add --level=full',
+                '',
+                '# === SLOPE MANAGED (do not edit above this line) ===',
+                'slope guard "$@"',
+                '# === SLOPE END ===',
+                '',
+            ].join('\n');
+            writeFileSync(dispatcherPath, script, { mode: 0o755 });
+            console.log(`  Created ${dispatcherPath}`);
+        }
+        // Generate the hooks config for .claude/settings.json
+        const guardScript = '"$CLAUDE_PROJECT_DIR"/.claude/hooks/slope-guard.sh';
+        const hooksConfig = this.generateHooksConfig(guards, guardScript);
+        // Read and merge into .claude/settings.json
+        const settingsPath = join(cwd, '.claude', 'settings.json');
+        let settings = {};
+        if (existsSync(settingsPath)) {
+            try {
+                settings = JSON.parse(readFileSync(settingsPath, 'utf8'));
+            }
+            catch { /* start fresh */ }
+        }
+        // Merge hooks — preserve existing non-SLOPE hooks
+        const existingHooks = (settings.hooks ?? {});
+        for (const [event, entries] of Object.entries(hooksConfig)) {
+            if (!existingHooks[event]) {
+                existingHooks[event] = [];
+            }
+            for (const entry of entries) {
+                const entryWithMatcher = entry;
+                const existing = existingHooks[event];
+                const isDuplicate = existing.some(e => e.matcher === entryWithMatcher.matcher &&
+                    e.hooks?.some(h => h.command?.includes('slope-guard.sh')));
+                if (!isDuplicate) {
+                    existingHooks[event].push(entry);
+                }
+            }
+        }
+        settings.hooks = existingHooks;
+        writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+        console.log(`  Updated ${settingsPath} with guard hooks`);
+    }
+    detect(cwd) {
+        return existsSync(join(cwd, '.claude'));
+    }
+}
+/** Singleton instance */
+export const claudeCodeAdapter = new ClaudeCodeAdapter();
+// Auto-register on import
+registerAdapter(claudeCodeAdapter);
+//# sourceMappingURL=claude-code.js.map

package/dist/core/adapters/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../src/core/adapters/claude-code.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGnE,kFAAkF;AAClF,MAAM,OAAO,iBAAiB;IACnB,EAAE,GAAG,aAAsB,CAAC;IAC5B,WAAW,GAAG,aAAa,CAAC;IAC5B,SAAS,GAAgB,iBAAiB,CAAC;IAEpD,mBAAmB,CAAC,MAAmB;QACrC,OAAO;YACL,kBAAkB,EAAE;gBAClB,aAAa,EAAE,YAAY;gBAC3B,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,kBAAkB,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC/D,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,wBAAwB,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;gBAC3E,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,iBAAiB,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;aAC7D;SACF,CAAC;IACJ,CAAC;IAED,oBAAoB,CAAC,MAAmB;QACtC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,OAAO;gBACL,QAAQ,EAAE,OAAO;gBACjB,MAAM,EAAE,MAAM,CAAC,WAAW;gBAC1B,kBAAkB,EAAE;oBAClB,aAAa,EAAE,aAAa;oBAC5B,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,iBAAiB,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;iBAC7D;aACF,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO;gBACL,kBAAkB,EAAE;oBAClB,aAAa,EAAE,aAAa;oBAC5B,iBAAiB,EAAE,MAAM,CAAC,OAAO;iBAClC;aACF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,gBAAgB,CAAC,MAAmB;QAClC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;QAC3D,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,mBAAmB,CACjB,MAA4B,EAC5B,eAAuB;QAEvB,MAAM,MAAM,GAA2I,EAAE,CAAC;QAE1J,sCAAsC;QACtC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgC,CAAC;QACvD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACxB,CAAC;QAED,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;gBAAE,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;YAE/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC3B,IAAI,EAAE,SAAkB;gBACxB,OAAO,EAAE,GAAG,eAAe,IAAI,CAAC,CAAC,IAAI,EAAE;gBACvC,OAAO,EAAE,EAAE;gBACX,aAAa,EAAE,UAAU,CAAC,CAAC,WAAW,EAAE;aACzC,CAAC,CAAC,CAAC;YAEJ,MAAM,KAAK,GAA8C,EAAE,KAAK,EAAE,CAAC;YACnE,IAAI,OAAO;gBAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;YACrC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,aAAa,CAAC,GAAW,EAAE,MAA4B;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/C,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzC,qCAAqC;QACrC,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QACxD,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG;gBACb,qBAAqB;gBACrB,uEAAuE;gBACvE,iDAAiD;gBACjD,EAAE;gBACF,uDAAuD;gBACvD,kBAAkB;gBAClB,qBAAqB;gBACrB,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,aAAa,cAAc,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,sDAAsD;QACtD,MAAM,WAAW,GAAG,oDAAoD,CAAC;QACzE,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAElE,4CAA4C;QAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;QAC3D,IAAI,QAAQ,GAA4B,EAAE,CAAC;QAC3C,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;YAC5D,CAAC;YAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAC/B,CAAC;QAED,kDAAkD;QAClD,MAAM,aAAa,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAA8B,CAAC;QAC1E,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YAC5B,CAAC;YACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,gBAAgB,GAAG,KAAiE,CAAC;gBAC3F,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAqE,CAAC;gBAC1G,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACpC,CAAC,CAAC,OAAO,KAAK,gBAAgB,CAAC,OAAO;oBACtC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAC1D,CAAC;gBACF,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;QACD,QAAQ,CAAC,KAAK,GAAG,aAAa,CAAC;QAE/B,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,aAAa,YAAY,mBAAmB,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;IAC1C,CAAC;CACF;AAED,yBAAyB;AACzB,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAEzD,0BAA0B;AAC1B,eAAe,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/core/adapters/cursor.d.ts

@@ -0,0 +1,35 @@
+import type { HarnessAdapter, ToolNameMap } from '../harness.js';
+import type { GuardResult, AnyGuardDefinition } from '../guard.js';
+/** Cursor hook entry in .cursor/hooks.json */
+export interface CursorHookEntry {
+    event: string;
+    matcher?: string;
+    command: string;
+    timeout?: number;
+    description?: string;
+}
+/** Cursor hooks config shape */
+export interface CursorHooksConfig {
+    hooks: CursorHookEntry[];
+}
+/** Cursor hook output protocol */
+export interface CursorHookOutput {
+    decision: 'allow' | 'block';
+    reason?: string;
+    context?: string;
+}
+/** Cursor adapter — formats guard output for Cursor's JSON hook protocol. */
+export declare class CursorAdapter implements HarnessAdapter {
+    readonly id: "cursor";
+    readonly displayName = "Cursor";
+    readonly toolNames: ToolNameMap;
+    formatPreToolOutput(result: GuardResult): CursorHookOutput;
+    formatPostToolOutput(result: GuardResult): CursorHookOutput;
+    formatStopOutput(result: GuardResult): CursorHookOutput;
+    generateHooksConfig(guards: AnyGuardDefinition[], guardScriptPath: string): CursorHooksConfig;
+    installGuards(cwd: string, guards: AnyGuardDefinition[]): void;
+    detect(cwd: string): boolean;
+}
+/** Singleton instance */
+export declare const cursorAdapter: CursorAdapter;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/core/adapters/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/cursor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAanE,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD,6EAA6E;AAC7E,qBAAa,aAAc,YAAW,cAAc;IAClD,QAAQ,CAAC,EAAE,EAAG,QAAQ,CAAU;IAChC,QAAQ,CAAC,WAAW,YAAY;IAChC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAgB;IAE/C,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB;IAe1D,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB;IAc3D,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB;IAUvD,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,iBAAiB;IAsB7F,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAmD9D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG7B;AAED,yBAAyB;AACzB,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/core/adapters/cursor.js

@@ -0,0 +1,138 @@
+// SLOPE CursorAdapter — adapts guard framework to Cursor's hook system.
+// Cursor (v1.7+) uses JSON stdin/stdout protocol with .cursor/hooks.json config.
+import { existsSync, writeFileSync, readFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { registerAdapter, resolveToolMatcher } from '../harness.js';
+/** Cursor tool name mappings */
+const CURSOR_TOOLS = {
+    read_file: 'read_file',
+    write_file: 'file_edit|create_file',
+    search_files: 'list_directory',
+    search_content: 'grep_search',
+    execute_command: 'run_terminal_command',
+    create_subagent: 'create_subagent',
+    exit_plan: 'exit_plan',
+};
+/**
+ * Map SLOPE hook events to Cursor hook events.
+ * PreCompact is intentionally omitted — Cursor has no pre-compaction hook.
+ */
+const HOOK_EVENT_MAP = {
+    PreToolUse: 'pre-tool-use',
+    PostToolUse: 'post-tool-use',
+    Stop: 'on-stop',
+};
+/** Cursor adapter — formats guard output for Cursor's JSON hook protocol. */
+export class CursorAdapter {
+    id = 'cursor';
+    displayName = 'Cursor';
+    toolNames = CURSOR_TOOLS;
+    formatPreToolOutput(result) {
+        if (result.decision === 'deny' || result.blockReason) {
+            return {
+                decision: 'block',
+                ...(result.blockReason && { reason: result.blockReason }),
+                ...(result.context && { context: result.context }),
+            };
+        }
+        // 'ask' falls through to 'allow' — Cursor has no user-confirmation prompt
+        return {
+            decision: 'allow',
+            ...(result.context && { context: result.context }),
+        };
+    }
+    formatPostToolOutput(result) {
+        if (result.blockReason) {
+            return {
+                decision: 'block',
+                reason: result.blockReason,
+                ...(result.context && { context: result.context }),
+            };
+        }
+        return {
+            decision: 'allow',
+            ...(result.context && { context: result.context }),
+        };
+    }
+    formatStopOutput(result) {
+        if (result.blockReason) {
+            return {
+                decision: 'block',
+                reason: result.blockReason,
+            };
+        }
+        return { decision: 'allow' };
+    }
+    generateHooksConfig(guards, guardScriptPath) {
+        const hooks = [];
+        for (const g of guards) {
+            const cursorEvent = HOOK_EVENT_MAP[g.hookEvent];
+            if (!cursorEvent)
+                continue; // Skip unsupported hook events
+            const matcher = resolveToolMatcher(this, 'toolCategories' in g ? g.toolCategories : undefined) ?? g.matcher;
+            const entry = {
+                event: cursorEvent,
+                command: `${guardScriptPath} ${g.name}`,
+                timeout: 10000,
+                description: `SLOPE: ${g.description}`,
+            };
+            if (matcher)
+                entry.matcher = matcher;
+            hooks.push(entry);
+        }
+        return { hooks };
+    }
+    installGuards(cwd, guards) {
+        const hooksDir = join(cwd, '.cursor', 'hooks');
+        mkdirSync(hooksDir, { recursive: true });
+        // Create the guard dispatcher script
+        const dispatcherPath = join(hooksDir, 'slope-guard.sh');
+        if (!existsSync(dispatcherPath)) {
+            const script = [
+                '#!/usr/bin/env bash',
+                '# SLOPE guard dispatcher — routes hook events to slope guard handlers',
+                '# Auto-generated by slope hook add --level=full --harness=cursor',
+                '#',
+                '# Cursor passes JSON on stdin and reads JSON from stdout.',
+                '',
+                '# === SLOPE MANAGED (do not edit above this line) ===',
+                'slope guard "$@"',
+                '# === SLOPE END ===',
+                '',
+            ].join('\n');
+            writeFileSync(dispatcherPath, script, { mode: 0o755 });
+            console.log(`  Created ${dispatcherPath}`);
+        }
+        // Generate hooks config and merge into .cursor/hooks.json
+        // Command paths are relative to the project root (cwd), not the hooks.json file
+        const guardScript = '.cursor/hooks/slope-guard.sh';
+        const hooksConfig = this.generateHooksConfig(guards, guardScript);
+        const configPath = join(cwd, '.cursor', 'hooks.json');
+        let existing = { hooks: [] };
+        if (existsSync(configPath)) {
+            try {
+                existing = JSON.parse(readFileSync(configPath, 'utf8'));
+                if (!Array.isArray(existing.hooks))
+                    existing.hooks = [];
+            }
+            catch { /* start fresh */ }
+        }
+        // Merge — avoid duplicates by checking command
+        for (const entry of hooksConfig.hooks) {
+            const isDuplicate = existing.hooks.some(e => e.command === entry.command && e.event === entry.event);
+            if (!isDuplicate) {
+                existing.hooks.push(entry);
+            }
+        }
+        writeFileSync(configPath, JSON.stringify(existing, null, 2) + '\n');
+        console.log(`  Updated ${configPath} with guard hooks`);
+    }
+    detect(cwd) {
+        return existsSync(join(cwd, '.cursor'));
+    }
+}
+/** Singleton instance */
+export const cursorAdapter = new CursorAdapter();
+// Auto-register on import
+registerAdapter(cursorAdapter);
+//# sourceMappingURL=cursor.js.map

package/dist/core/adapters/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../src/core/adapters/cursor.ts"],"names":[],"mappings":"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"}

package/dist/core/adapters/generic.d.ts

@@ -0,0 +1,26 @@
+import type { HarnessAdapter, ToolNameMap } from '../harness.js';
+import type { GuardResult, AnyGuardDefinition } from '../guard.js';
+/** Guard manifest entry written to guards-manifest.json */
+export interface GuardManifestEntry {
+    name: string;
+    description: string;
+    hookEvent: string;
+    matcher?: string;
+    level: string;
+    command: string;
+}
+/** Generic adapter — works with any harness via shell scripts and JSON manifest. */
+export declare class GenericAdapter implements HarnessAdapter {
+    readonly id: "generic";
+    readonly displayName = "Generic (Shell)";
+    readonly toolNames: ToolNameMap;
+    formatPreToolOutput(result: GuardResult): unknown;
+    formatPostToolOutput(result: GuardResult): unknown;
+    formatStopOutput(result: GuardResult): unknown;
+    generateHooksConfig(guards: AnyGuardDefinition[], guardScriptPath: string): GuardManifestEntry[];
+    installGuards(cwd: string, guards: AnyGuardDefinition[]): void;
+    detect(_cwd: string): boolean;
+}
+/** Singleton instance */
+export declare const genericAdapter: GenericAdapter;
+//# sourceMappingURL=generic.d.ts.map

package/dist/core/adapters/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/generic.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAanE,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oFAAoF;AACpF,qBAAa,cAAe,YAAW,cAAc;IACnD,QAAQ,CAAC,EAAE,EAAG,SAAS,CAAU;IACjC,QAAQ,CAAC,WAAW,qBAAqB;IACzC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAiB;IAEhD,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAYjD,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAQlD,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAO9C,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAehG,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAyE9D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAI9B;AAED,yBAAyB;AACzB,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/dist/core/adapters/generic.js

@@ -0,0 +1,137 @@
+// SLOPE GenericAdapter — fallback adapter for any harness without a dedicated adapter.
+// Outputs simple JSON, generates a guards manifest, and creates shell-based dispatcher.
+import { existsSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { registerAdapter, resolveToolMatcher } from '../harness.js';
+/** Generic tool name map — uses common operation names */
+const GENERIC_TOOLS = {
+    read_file: 'read_file',
+    write_file: 'write_file',
+    search_files: 'search_files',
+    search_content: 'search_content',
+    execute_command: 'execute_command',
+    create_subagent: 'create_subagent',
+    exit_plan: 'exit_plan',
+};
+/** Generic adapter — works with any harness via shell scripts and JSON manifest. */
+export class GenericAdapter {
+    id = 'generic';
+    displayName = 'Generic (Shell)';
+    toolNames = GENERIC_TOOLS;
+    formatPreToolOutput(result) {
+        const action = result.decision === 'deny' ? 'deny'
+            : result.decision === 'ask' ? 'ask'
+                : result.context ? 'context'
+                    : 'allow';
+        return {
+            action,
+            ...(result.context && { message: result.context }),
+            ...(result.blockReason && { reason: result.blockReason }),
+        };
+    }
+    formatPostToolOutput(result) {
+        return {
+            action: result.blockReason ? 'deny' : result.context ? 'context' : 'allow',
+            ...(result.context && { message: result.context }),
+            ...(result.blockReason && { reason: result.blockReason }),
+        };
+    }
+    formatStopOutput(result) {
+        return {
+            action: result.blockReason ? 'deny' : 'allow',
+            ...(result.blockReason && { reason: result.blockReason }),
+        };
+    }
+    generateHooksConfig(guards, guardScriptPath) {
+        return guards.map(g => {
+            // Resolve matcher via toolCategories (harness-agnostic) with fallback to raw matcher
+            const matcher = resolveToolMatcher(this, 'toolCategories' in g ? g.toolCategories : undefined) ?? g.matcher;
+            return {
+                name: g.name,
+                description: g.description,
+                hookEvent: g.hookEvent,
+                ...(matcher && { matcher }),
+                level: g.level,
+                command: `${guardScriptPath} ${g.name}`,
+            };
+        });
+    }
+    installGuards(cwd, guards) {
+        const hooksDir = join(cwd, '.slope', 'hooks');
+        mkdirSync(hooksDir, { recursive: true });
+        // Create the guard dispatcher script
+        const dispatcherPath = join(hooksDir, 'slope-guard.sh');
+        if (!existsSync(dispatcherPath)) {
+            const script = [
+                '#!/usr/bin/env bash',
+                '# SLOPE guard dispatcher — routes hook events to slope guard handlers',
+                '# Auto-generated by slope hook add --level=full --harness=generic',
+                '#',
+                '# Usage: ./slope-guard.sh <guard-name>',
+                '# Reads JSON from stdin, outputs JSON to stdout.',
+                '# See guards-manifest.json for available guards.',
+                '',
+                '# === SLOPE MANAGED (do not edit above this line) ===',
+                'slope guard "$@"',
+                '# === SLOPE END ===',
+                '',
+            ].join('\n');
+            writeFileSync(dispatcherPath, script, { mode: 0o755 });
+            console.log(`  Created ${dispatcherPath}`);
+        }
+        // Generate guards manifest
+        const manifestPath = join(hooksDir, 'guards-manifest.json');
+        const manifest = this.generateHooksConfig(guards, './slope-guard.sh');
+        writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+        console.log(`  Created ${manifestPath}`);
+        // Generate README
+        const readmePath = join(hooksDir, 'README.md');
+        if (!existsSync(readmePath)) {
+            const readme = [
+                '# SLOPE Guard Hooks',
+                '',
+                'This directory contains SLOPE guard hooks for use with any AI coding harness.',
+                '',
+                '## Files',
+                '',
+                '- `slope-guard.sh` — Dispatcher script that routes guard names to `slope guard`',
+                '- `guards-manifest.json` — Machine-readable list of all installed guards',
+                '',
+                '## Integration',
+                '',
+                'To wire these guards into your harness:',
+                '',
+                '1. Configure your harness to call `slope-guard.sh <guard-name>` at the appropriate hook event',
+                '2. Pass the hook context as JSON on stdin',
+                '3. Read the JSON response from stdout',
+                '',
+                '### Hook Events',
+                '',
+                '- **PreToolUse** — Before a tool executes (can allow, deny, or inject context)',
+                '- **PostToolUse** — After a tool executes (can block or inject context)',
+                '- **Stop** — Before session ends (can block to prevent premature exit)',
+                '- **PreCompact** — Before context compaction (extract state before compression)',
+                '',
+                '### Response Format',
+                '',
+                '```json',
+                '{ "action": "allow" | "deny" | "context", "message": "...", "reason": "..." }',
+                '```',
+                '',
+                'See `guards-manifest.json` for the full list of guards and their hook events.',
+                '',
+            ].join('\n');
+            writeFileSync(readmePath, readme);
+            console.log(`  Created ${readmePath}`);
+        }
+    }
+    detect(_cwd) {
+        // Generic is the fallback — only used when no other adapter matches
+        return true;
+    }
+}
+/** Singleton instance */
+export const genericAdapter = new GenericAdapter();
+// Auto-register on import
+registerAdapter(genericAdapter);
+//# sourceMappingURL=generic.js.map

package/dist/core/adapters/generic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.js","sourceRoot":"","sources":["../../../src/core/adapters/generic.ts"],"names":[],"mappings":"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"}

package/dist/core/adapters/windsurf.d.ts

@@ -0,0 +1,34 @@
+import type { HarnessAdapter, ToolNameMap } from '../harness.js';
+import type { GuardResult, AnyGuardDefinition } from '../guard.js';
+/** Windsurf hook entry in .windsurf/hooks.json */
+export interface WindsurfHookEntry {
+    event: string;
+    matcher?: string;
+    command: string;
+    timeout?: number;
+    description?: string;
+}
+/** Windsurf hooks config shape */
+export interface WindsurfHooksConfig {
+    hooks: WindsurfHookEntry[];
+}
+/** Windsurf hook output (JSON from adapter, translated to exit codes by dispatcher) */
+export interface WindsurfHookOutput {
+    action: 'allow' | 'deny';
+    message?: string;
+}
+/** Windsurf adapter — formats guard output for Windsurf's exit-code-based hook system. */
+export declare class WindsurfAdapter implements HarnessAdapter {
+    readonly id: "windsurf";
+    readonly displayName = "Windsurf";
+    readonly toolNames: ToolNameMap;
+    formatPreToolOutput(result: GuardResult): WindsurfHookOutput;
+    formatPostToolOutput(result: GuardResult): WindsurfHookOutput;
+    formatStopOutput(result: GuardResult): WindsurfHookOutput;
+    generateHooksConfig(guards: AnyGuardDefinition[], guardScriptPath: string): WindsurfHooksConfig;
+    installGuards(cwd: string, guards: AnyGuardDefinition[]): void;
+    detect(cwd: string): boolean;
+}
+/** Singleton instance */
+export declare const windsurfAdapter: WindsurfAdapter;
+//# sourceMappingURL=windsurf.d.ts.map

package/dist/core/adapters/windsurf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/windsurf.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAanE,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,kCAAkC;AAClC,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED,uFAAuF;AACvF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD,0FAA0F;AAC1F,qBAAa,eAAgB,YAAW,cAAc;IACpD,QAAQ,CAAC,EAAE,EAAG,UAAU,CAAU;IAClC,QAAQ,CAAC,WAAW,cAAc;IAClC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAkB;IAEjD,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,kBAAkB;IAW5D,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,kBAAkB;IAU7D,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,kBAAkB;IAWzD,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,mBAAmB;IAsB/F,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAkF9D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG7B;AAED,yBAAyB;AACzB,eAAO,MAAM,eAAe,iBAAwB,CAAC"}