@slope-dev/slope 1.5.1

package/dist/cli/commands/flows.js

@@ -0,0 +1,156 @@
+// slope flows — Manage user flow definitions
+import { existsSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { execSync } from 'node:child_process';
+import { loadConfig, loadFlows, validateFlows, checkFlowStaleness } from '../../core/index.js';
+const EXAMPLE_FLOWS = {
+    version: '1',
+    last_generated: new Date().toISOString(),
+    flows: [
+        {
+            id: 'example-flow',
+            title: 'Example User Flow',
+            description: 'Replace this with a real user-facing workflow (e.g., OAuth login, checkout, onboarding).',
+            entry_point: 'src/index.ts',
+            steps: [
+                {
+                    name: 'Entry',
+                    description: 'User arrives at the entry point',
+                    file_paths: ['src/index.ts'],
+                },
+            ],
+            files: ['src/index.ts'],
+            tags: ['example'],
+            last_verified_sha: '',
+            last_verified_at: '',
+        },
+    ],
+};
+function getCurrentSha(cwd) {
+    try {
+        return execSync('git rev-parse HEAD', { cwd, encoding: 'utf8', timeout: 5000 }).trim();
+    }
+    catch {
+        return '';
+    }
+}
+function flowsInit(cwd, flowsPath) {
+    if (existsSync(flowsPath)) {
+        console.log(`Flows file already exists at ${flowsPath}`);
+        console.log('Edit it directly to add flow definitions.\n');
+        return;
+    }
+    const dir = dirname(flowsPath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(flowsPath, JSON.stringify(EXAMPLE_FLOWS, null, 2) + '\n');
+    console.log(`Created flows file at ${flowsPath}`);
+    console.log('Edit the example flow or replace with your own definitions.\n');
+}
+function flowsList(cwd, flowsPath) {
+    const flows = loadFlows(flowsPath);
+    if (!flows) {
+        console.log('No flows defined. Run `slope flows init` to create a template.\n');
+        return;
+    }
+    if (flows.flows.length === 0) {
+        console.log('Flows file exists but contains no flow definitions.\n');
+        return;
+    }
+    const currentSha = getCurrentSha(cwd);
+    console.log('\nUser Flow Definitions\n');
+    console.log('| ID | Title | Tags | Files | Stale? |');
+    console.log('|----|-------|------|-------|--------|');
+    for (const flow of flows.flows) {
+        const tags = flow.tags.join(', ') || '—';
+        let staleLabel = '—';
+        if (flow.last_verified_sha && currentSha) {
+            const { stale, changedFiles } = checkFlowStaleness(flow, currentSha, cwd);
+            staleLabel = stale ? `Yes (${changedFiles.length} files)` : 'No';
+        }
+        else if (!flow.last_verified_sha) {
+            staleLabel = 'Unverified';
+        }
+        console.log(`| ${flow.id} | ${flow.title} | ${tags} | ${flow.files.length} | ${staleLabel} |`);
+    }
+    console.log(`\n${flows.flows.length} flow(s) defined.\n`);
+}
+function flowsCheck(cwd, flowsPath) {
+    const flows = loadFlows(flowsPath);
+    if (!flows) {
+        console.error('No flows file found. Run `slope flows init` to create one.\n');
+        process.exit(1);
+    }
+    console.log('\nSLOPE Flow Validation\n');
+    // Structural validation
+    const { errors, warnings } = validateFlows(flows, cwd);
+    for (const err of errors) {
+        console.log(`  \x1b[31m[ERROR]\x1b[0m ${err}`);
+    }
+    for (const warn of warnings) {
+        console.log(`  \x1b[33m[WARN]\x1b[0m ${warn}`);
+    }
+    // Staleness check
+    const currentSha = getCurrentSha(cwd);
+    const staleFlows = [];
+    if (currentSha) {
+        for (const flow of flows.flows) {
+            if (!flow.last_verified_sha) {
+                console.log(`  \x1b[33m[WARN]\x1b[0m Flow "${flow.id}": no last_verified_sha — cannot check staleness`);
+                continue;
+            }
+            const { stale, changedFiles } = checkFlowStaleness(flow, currentSha, cwd);
+            if (stale) {
+                staleFlows.push(flow.id);
+                console.log(`  \x1b[31m[STALE]\x1b[0m Flow "${flow.id}": ${changedFiles.length} file(s) changed: ${changedFiles.join(', ')}`);
+            }
+            else {
+                console.log(`  \x1b[32m[OK]\x1b[0m Flow "${flow.id}": current`);
+            }
+        }
+    }
+    console.log('');
+    if (errors.length > 0) {
+        console.log(`\x1b[31m${errors.length} error(s), ${warnings.length} warning(s)\x1b[0m\n`);
+        process.exit(1);
+    }
+    if (staleFlows.length > 0) {
+        console.log(`\x1b[33m${staleFlows.length} stale flow(s)\x1b[0m\n`);
+        process.exit(1);
+    }
+    console.log(`\x1b[32mAll ${flows.flows.length} flow(s) valid and current.\x1b[0m\n`);
+}
+export async function flowsCommand(args) {
+    const cwd = process.cwd();
+    const config = loadConfig(cwd);
+    const flowsPath = join(cwd, config.flowsPath);
+    const sub = args[0];
+    switch (sub) {
+        case 'init':
+            flowsInit(cwd, flowsPath);
+            break;
+        case 'list':
+            flowsList(cwd, flowsPath);
+            break;
+        case 'check':
+            flowsCheck(cwd, flowsPath);
+            break;
+        default:
+            console.log(`
+slope flows — Manage user flow definitions
+
+Usage:
+  slope flows init     Create .slope/flows.json with example template
+  slope flows list     List all flows with staleness indicators
+  slope flows check    Validate all flows (file existence, staleness); exit 1 if stale
+
+Flow definitions map user-facing workflows (OAuth, checkout, onboarding) to
+code paths, making them queryable via MCP: search({ module: 'flows' })
+`);
+            if (sub)
+                process.exit(1);
+            break;
+    }
+}
+//# sourceMappingURL=flows.js.map

package/dist/cli/commands/flows.js.map

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

package/dist/cli/commands/guard.d.ts

@@ -0,0 +1,15 @@
+import type { HookInput, GuardResult, GuardName } from '../../core/index.js';
+type GuardHandler = (input: HookInput, cwd: string) => Promise<GuardResult>;
+/** Register a guard handler */
+export declare function registerGuard(name: GuardName, handler: GuardHandler): void;
+/**
+ * slope guard <name> — Execute a guard handler.
+ * Reads hook JSON from stdin, runs the named guard, outputs response JSON.
+ */
+export declare function guardCommand(args: string[]): Promise<void>;
+/**
+ * slope guard list/enable/disable subcommands
+ */
+export declare function guardManageCommand(args: string[]): Promise<void>;
+export {};
+//# sourceMappingURL=guard.d.ts.map

package/dist/cli/commands/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAsB,MAAM,qBAAqB,CAAC;AAgBjG,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAkB5E,+BAA+B;AAC/B,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAE1E;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0FhE;AAuCD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDtE"}

package/dist/cli/commands/guard.js

@@ -0,0 +1,207 @@
+import { GUARD_DEFINITIONS, formatPreToolUseOutput, formatPostToolUseOutput, formatStopOutput, getAllGuardDefinitions, getCustomGuard, loadPluginGuards } from '../../core/index.js';
+import { loadConfig } from '../config.js';
+import { exploreGuard } from '../guards/explore.js';
+import { hazardGuard } from '../guards/hazard.js';
+import { commitNudgeGuard } from '../guards/commit-nudge.js';
+import { scopeDriftGuard } from '../guards/scope-drift.js';
+import { compactionGuard } from '../guards/compaction.js';
+import { stopCheckGuard } from '../guards/stop-check.js';
+import { subagentGateGuard } from '../guards/subagent-gate.js';
+import { pushNudgeGuard } from '../guards/push-nudge.js';
+import { workflowGateGuard } from '../guards/workflow-gate.js';
+import { reviewTierGuard } from '../guards/review-tier.js';
+import { versionCheckGuard } from '../guards/version-check.js';
+import { nextActionGuard } from '../guards/next-action.js';
+import { execSync } from 'node:child_process';
+/** Registry of guard handler implementations */
+const handlers = {
+    explore: exploreGuard,
+    hazard: hazardGuard,
+    'commit-nudge': commitNudgeGuard,
+    'scope-drift': scopeDriftGuard,
+    compaction: compactionGuard,
+    'stop-check': stopCheckGuard,
+    'subagent-gate': subagentGateGuard,
+    'push-nudge': pushNudgeGuard,
+    'workflow-gate': workflowGateGuard,
+    'review-tier': reviewTierGuard,
+    'version-check': versionCheckGuard,
+    'next-action': nextActionGuard,
+};
+/** Register a guard handler */
+export function registerGuard(name, handler) {
+    handlers[name] = handler;
+}
+/**
+ * slope guard <name> — Execute a guard handler.
+ * Reads hook JSON from stdin, runs the named guard, outputs response JSON.
+ */
+export async function guardCommand(args) {
+    const name = args[0];
+    if (!name || args.includes('--help') || args.includes('-h')) {
+        printUsage();
+        return;
+    }
+    // Check if guard is disabled
+    const cwd = process.cwd();
+    const config = loadConfig();
+    const disabled = config.guidance?.disabled ?? [];
+    if (disabled.includes(name)) {
+        // Silently exit — disabled guards produce no output
+        return;
+    }
+    // Load custom guard plugins
+    loadPluginGuards(cwd, config.plugins);
+    // Find guard definition (built-in or custom)
+    const def = getAllGuardDefinitions().find(d => d.name === name);
+    if (!def) {
+        console.error(`Unknown guard: "${name}". Available: ${getAllGuardDefinitions().map(d => d.name).join(', ')}`);
+        process.exit(1);
+    }
+    // Read hook input from stdin
+    let input;
+    try {
+        input = await readStdin();
+    }
+    catch {
+        // No stdin or invalid JSON — run with minimal input (for manual testing)
+        input = {
+            session_id: '',
+            cwd,
+            hook_event_name: def.hookEvent,
+        };
+    }
+    // Find and run the handler
+    const handler = handlers[name];
+    if (!handler) {
+        // Check for custom guard plugin — shell out to its command
+        const customDef = getCustomGuard(name);
+        if (customDef) {
+            try {
+                const output = execSync(customDef.command, {
+                    cwd,
+                    input: JSON.stringify(input),
+                    encoding: 'utf8',
+                    timeout: 10000,
+                });
+                if (output.trim()) {
+                    process.stdout.write(output);
+                }
+            }
+            catch { /* custom guard failed — silent passthrough */ }
+            return;
+        }
+        // No handler registered — passthrough
+        return;
+    }
+    const result = await handler(input, cwd);
+    // Format output based on hook event type
+    if (!result.context && !result.decision && !result.blockReason) {
+        // No guidance to inject — silent passthrough
+        return;
+    }
+    let output;
+    switch (def.hookEvent) {
+        case 'PreToolUse':
+            output = formatPreToolUseOutput(result);
+            break;
+        case 'PostToolUse':
+            output = formatPostToolUseOutput(result);
+            break;
+        case 'Stop':
+            output = formatStopOutput(result);
+            break;
+        case 'PreCompact':
+            // PreCompact doesn't return JSON — just run the handler for side effects
+            return;
+    }
+    if (output && Object.keys(output).length > 0) {
+        process.stdout.write(JSON.stringify(output));
+    }
+}
+async function readStdin() {
+    return new Promise((resolve, reject) => {
+        let data = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', chunk => { data += chunk; });
+        process.stdin.on('end', () => {
+            try {
+                resolve(JSON.parse(data));
+            }
+            catch {
+                reject(new Error('Invalid JSON on stdin'));
+            }
+        });
+        process.stdin.on('error', reject);
+        // Timeout if no stdin after 100ms (for manual/testing use)
+        setTimeout(() => {
+            if (data === '')
+                reject(new Error('No stdin'));
+        }, 100);
+    });
+}
+function printUsage() {
+    const allDefs = getAllGuardDefinitions();
+    console.log(`
+slope guard — Execute a SLOPE guidance hook
+
+Usage:
+  slope guard <name>          Run a guard (reads hook JSON from stdin)
+  slope guard list            Show all available guards
+  slope guard enable <name>   Enable a disabled guard
+  slope guard disable <name>  Disable a guard
+
+Guards:
+${allDefs.map(d => `  ${d.name.padEnd(16)} [${d.hookEvent}] ${d.description}`).join('\n')}
+`);
+}
+/**
+ * slope guard list/enable/disable subcommands
+ */
+export async function guardManageCommand(args) {
+    const sub = args[0];
+    const name = args[1];
+    const cwd = process.cwd();
+    switch (sub) {
+        case 'list': {
+            const config = loadConfig();
+            const disabled = config.guidance?.disabled ?? [];
+            // Load custom guard plugins
+            loadPluginGuards(cwd, config.plugins);
+            console.log('\nSLOPE Guards:\n');
+            for (const d of GUARD_DEFINITIONS) {
+                const status = disabled.includes(d.name) ? '[disabled]' : '[enabled] ';
+                console.log(`  ${status} ${d.name.padEnd(16)} [${d.hookEvent}] ${d.description}`);
+            }
+            // Show custom guards
+            const allDefs = getAllGuardDefinitions();
+            const customDefs = allDefs.filter(d => !GUARD_DEFINITIONS.includes(d));
+            for (const d of customDefs) {
+                const status = disabled.includes(d.name) ? '[disabled]' : '[enabled] ';
+                console.log(`  ${status} ${d.name.padEnd(16)} [${d.hookEvent}] ${d.description} [custom]`);
+            }
+            console.log('');
+            break;
+        }
+        case 'enable':
+        case 'disable': {
+            if (!name) {
+                console.error(`Error: guard name required. Usage: slope guard ${sub} <name>`);
+                process.exit(1);
+            }
+            // Load custom guard plugins to check against all guards
+            const config = loadConfig();
+            loadPluginGuards(cwd, config.plugins);
+            if (!getAllGuardDefinitions().find(d => d.name === name)) {
+                console.error(`Unknown guard: "${name}"`);
+                process.exit(1);
+            }
+            console.log(`\nTo ${sub} the "${name}" guard, update .slope/config.json:`);
+            console.log(`  "guidance": { "disabled": [${sub === 'disable' ? `"${name}"` : '...remove...'} ] }\n`);
+            break;
+        }
+        default:
+            printUsage();
+    }
+}
+//# sourceMappingURL=guard.js.map

package/dist/cli/commands/guard.js.map

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

package/dist/cli/commands/hook.d.ts

@@ -0,0 +1,2 @@
+export declare function hookCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=hook.d.ts.map

package/dist/cli/commands/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/hook.ts"],"names":[],"mappings":"AAqFA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsC/D"}