@slope-dev/slope 1.12.0 → 1.13.1

package/dist/cli/guards/stop-check.js

@@ -2,26 +2,51 @@ import { execSync } from 'node:child_process';
 /**
  * Stop check guard: fires on Stop.
  * Checks for uncommitted/unpushed work before session end.
+ *
+ * Modified/staged/deleted files → block (real uncommitted work).
+ * Untracked-only files → warn via context (may be orphaned/intentional).
+ * Unpushed commits → block (recovery point not preserved).
  */
 export async function stopCheckGuard(input, cwd) {
-    const issues = [];
+    const blockingIssues = [];
+    const warningIssues = [];
     // Check for uncommitted changes (excluding gitignored files)
     try {
         const status = execSync('git status --porcelain 2>/dev/null', { cwd, encoding: 'utf8' }).trim();
         if (status.length > 0) {
-            const paths = status.split('\n').filter(Boolean).map(l => l.slice(3));
-            // Filter out files matched by .gitignore (catches tracked-but-ignored files)
-            let filtered = paths;
-            if (paths.length > 0) {
+            const lines = status.split('\n').filter(Boolean);
+            // Separate untracked (??) from modified/staged/deleted
+            const untrackedPaths = [];
+            const modifiedPaths = [];
+            for (const line of lines) {
+                const statusCode = line.slice(0, 2);
+                const path = line.slice(3);
+                if (statusCode === '??') {
+                    untrackedPaths.push(path);
+                }
+                else {
+                    modifiedPaths.push(path);
+                }
+            }
+            // Filter out gitignored files from both lists
+            const allPaths = [...modifiedPaths, ...untrackedPaths];
+            const ignoredSet = new Set();
+            if (allPaths.length > 0) {
                 try {
-                    const ignored = execSync(`git check-ignore ${paths.map(p => `'${p}'`).join(' ')} 2>/dev/null`, { cwd, encoding: 'utf8' }).trim();
-                    const ignoredSet = new Set(ignored.split('\n').filter(Boolean));
-                    filtered = paths.filter(p => !ignoredSet.has(p));
+                    const ignored = execSync(`git check-ignore ${allPaths.map(p => `'${p}'`).join(' ')} 2>/dev/null`, { cwd, encoding: 'utf8' }).trim();
+                    for (const p of ignored.split('\n').filter(Boolean)) {
+                        ignoredSet.add(p);
+                    }
                 }
                 catch { /* check-ignore exits 1 when no files are ignored — all files are real changes */ }
             }
-            if (filtered.length > 0) {
-                issues.push(`${filtered.length} uncommitted change${filtered.length === 1 ? '' : 's'}`);
+            const filteredModified = modifiedPaths.filter(p => !ignoredSet.has(p));
+            const filteredUntracked = untrackedPaths.filter(p => !ignoredSet.has(p));
+            if (filteredModified.length > 0) {
+                blockingIssues.push(`${filteredModified.length} uncommitted change${filteredModified.length === 1 ? '' : 's'}`);
+            }
+            if (filteredUntracked.length > 0) {
+                warningIssues.push(`${filteredUntracked.length} untracked file${filteredUntracked.length === 1 ? '' : 's'}`);
             }
         }
     }
@@ -32,15 +57,24 @@ export async function stopCheckGuard(input, cwd) {
         if (unpushed) {
             const lines = unpushed.split('\n').filter(Boolean);
             if (lines.length > 0) {
-                issues.push(`${lines.length} unpushed commit${lines.length === 1 ? '' : 's'}`);
+                blockingIssues.push(`${lines.length} unpushed commit${lines.length === 1 ? '' : 's'}`);
             }
         }
     }
     catch { /* no upstream */ }
-    if (issues.length === 0)
-        return {};
-    return {
-        blockReason: `SLOPE: ${issues.join(' and ')} detected. Commit and push before stopping to preserve your recovery point.`,
-    };
+    // Blocking issues take priority
+    if (blockingIssues.length > 0) {
+        const allIssues = [...blockingIssues, ...warningIssues];
+        return {
+            blockReason: `SLOPE: ${allIssues.join(' and ')} detected. Commit and push before stopping to preserve your recovery point.`,
+        };
+    }
+    // Untracked-only: warn but don't block
+    if (warningIssues.length > 0) {
+        return {
+            context: `SLOPE: ${warningIssues.join(' and ')} detected. Consider committing or cleaning up untracked files.`,
+        };
+    }
+    return {};
 }
 //# sourceMappingURL=stop-check.js.map

package/dist/cli/guards/stop-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"stop-check.js","sourceRoot":"","sources":["../../../src/cli/guards/stop-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAgB,EAAE,GAAW;IAChE,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,6DAA6D;IAC7D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,oCAAoC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAChG,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACtE,6EAA6E;YAC7E,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,QAAQ,CAAC,oBAAoB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;oBACjI,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;oBAChE,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnD,CAAC;gBAAC,MAAM,CAAC,CAAC,iFAAiF,CAAC,CAAC;YAC/F,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,sBAAsB,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC;IAEhC,6BAA6B;IAC7B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,0CAA0C,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxG,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACnD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,mBAAmB,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAE7B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,OAAO;QACL,WAAW,EAAE,UAAU,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,6EAA6E;KACzH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"stop-check.js","sourceRoot":"","sources":["../../../src/cli/guards/stop-check.ts"],"names":[],"mappings":"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"}

package/dist/cli/registry.d.ts

@@ -0,0 +1,12 @@
+export interface CliCommandMeta {
+    /** Command name as invoked: e.g. "init", "auto-card" */
+    cmd: string;
+    /** Short description of the command */
+    desc: string;
+    /** Functional category */
+    category: 'lifecycle' | 'scoring' | 'analysis' | 'tooling' | 'planning';
+}
+/** Command files that are internal implementation modules, not user-invocable top-level commands. */
+export declare const CLI_INTERNAL_MODULES: readonly ["review-state"];
+export declare const CLI_COMMAND_REGISTRY: readonly CliCommandMeta[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/cli/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/cli/registry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,QAAQ,EAAE,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;CACzE;AAED,qGAAqG;AACrG,eAAO,MAAM,oBAAoB,2BAA4B,CAAC;AAE9D,eAAO,MAAM,oBAAoB,EAAE,SAAS,cAAc,EAuCzD,CAAC"}

package/dist/cli/registry.js

@@ -0,0 +1,40 @@
+// CLI Command Registry — metadata for CLI commands (map generation, documentation, slope-web)
+/** Command files that are internal implementation modules, not user-invocable top-level commands. */
+export const CLI_INTERNAL_MODULES = ['review-state'];
+export const CLI_COMMAND_REGISTRY = [
+    // ── Lifecycle ──────────────────────────────────────────────────
+    { cmd: 'init', desc: 'Initialize .slope/ directory', category: 'lifecycle' },
+    { cmd: 'session', desc: 'Manage live sessions', category: 'lifecycle' },
+    { cmd: 'claim', desc: 'Claim a ticket or area for the sprint', category: 'lifecycle' },
+    { cmd: 'release', desc: 'Release a claim by ID or target', category: 'lifecycle' },
+    { cmd: 'status', desc: 'Show sprint course status and conflicts', category: 'lifecycle' },
+    { cmd: 'next', desc: 'Show next sprint number (auto-detect)', category: 'lifecycle' },
+    // ── Scoring ────────────────────────────────────────────────────
+    { cmd: 'card', desc: 'Display handicap card', category: 'scoring' },
+    { cmd: 'validate', desc: 'Validate scorecard(s)', category: 'scoring' },
+    { cmd: 'review', desc: 'Format sprint review or manage review state', category: 'scoring' },
+    { cmd: 'auto-card', desc: 'Generate scorecard from git + CI signals', category: 'scoring' },
+    { cmd: 'classify', desc: 'Classify a shot from execution trace', category: 'scoring' },
+    { cmd: 'tournament', desc: 'Build tournament review from sprints', category: 'scoring' },
+    // ── Analysis ───────────────────────────────────────────────────
+    { cmd: 'briefing', desc: 'Pre-round briefing with hazards and nutrition', category: 'analysis' },
+    { cmd: 'plan', desc: 'Pre-shot advisor (club + training + hazards)', category: 'analysis' },
+    { cmd: 'report', desc: 'Generate HTML performance report', category: 'analysis' },
+    { cmd: 'dashboard', desc: 'Live local performance dashboard', category: 'analysis' },
+    { cmd: 'standup', desc: 'Generate or ingest standup report', category: 'analysis' },
+    { cmd: 'analyze', desc: 'Scan repo and generate profile', category: 'analysis' },
+    // ── Tooling ────────────────────────────────────────────────────
+    { cmd: 'hook', desc: 'Manage lifecycle hooks', category: 'tooling' },
+    { cmd: 'guard', desc: 'Run guard handler or manage guard activation', category: 'tooling' },
+    { cmd: 'extract', desc: 'Extract events into SLOPE store', category: 'tooling' },
+    { cmd: 'distill', desc: 'Promote event patterns to common issues', category: 'tooling' },
+    { cmd: 'map', desc: 'Generate/update codebase map', category: 'tooling' },
+    { cmd: 'flows', desc: 'Manage user flow definitions', category: 'tooling' },
+    { cmd: 'plugin', desc: 'Manage custom plugins', category: 'tooling' },
+    { cmd: 'escalate', desc: 'Escalate issues based on severity triggers', category: 'tooling' },
+    { cmd: 'transcript', desc: 'View session transcript data', category: 'tooling' },
+    // ── Planning ───────────────────────────────────────────────────
+    { cmd: 'roadmap', desc: 'Strategic planning and roadmap tools', category: 'planning' },
+    { cmd: 'vision', desc: 'Display project vision document', category: 'planning' },
+];
+//# sourceMappingURL=registry.js.map

package/dist/cli/registry.js.map

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

package/dist/core/adapters/claude-code.d.ts

@@ -0,0 +1,25 @@
+import type { HarnessAdapter, ToolNameMap } from '../harness.js';
+import type { GuardResult, AnyGuardDefinition, PreToolUseOutput, PostToolUseOutput, StopOutput } from '../guard.js';
+/** Claude Code adapter — formats guard output for Claude Code's hook protocol. */
+export declare class ClaudeCodeAdapter implements HarnessAdapter {
+    readonly id: "claude-code";
+    readonly displayName = "Claude Code";
+    readonly toolNames: ToolNameMap;
+    formatPreToolOutput(result: GuardResult): PreToolUseOutput;
+    formatPostToolOutput(result: GuardResult): PostToolUseOutput;
+    formatStopOutput(result: GuardResult): StopOutput;
+    generateHooksConfig(guards: AnyGuardDefinition[], guardScriptPath: string): Record<string, Array<{
+        matcher?: string;
+        hooks: Array<{
+            type: string;
+            command: string;
+            timeout?: number;
+            statusMessage?: string;
+        }>;
+    }>>;
+    installGuards(cwd: string, guards: AnyGuardDefinition[]): void;
+    detect(cwd: string): boolean;
+}
+/** Singleton instance */
+export declare const claudeCodeAdapter: ClaudeCodeAdapter;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/core/adapters/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/claude-code.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEpH,kFAAkF;AAClF,qBAAa,iBAAkB,YAAW,cAAc;IACtD,QAAQ,CAAC,EAAE,EAAG,aAAa,CAAU;IACrC,QAAQ,CAAC,WAAW,iBAAiB;IACrC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAqB;IAEpD,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB;IAW1D,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB;IAsB5D,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU;IAOjD,mBAAmB,CACjB,MAAM,EAAE,kBAAkB,EAAE,EAC5B,eAAe,EAAE,MAAM,GACtB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,aAAa,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IA+BzI,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,IAAI;IA0D9D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG7B;AAED,yBAAyB;AACzB,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

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":"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"}

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"}