cmdr-agent 2.2.0 → 2.4.0

package/dist/src/core/graph-context.js

@@ -0,0 +1,370 @@
+/**
+ * GraphContextProvider — token-budgeted, heuristic-gated context injection
+ * powered by code-review-graph's MCP tools.
+ *
+ * This is NOT injected into the system prompt. It prepends a structured
+ * context message to the conversation when heuristics indicate the graph
+ * can provide useful grounding for the current turn.
+ *
+ * Design rules:
+ *  - Context injection = initial grounding (bounded, passive)
+ *  - Tool calls = deep analysis mid-reasoning (on-demand)
+ *  - Never duplicates: if context was injected, tools drill deeper
+ */
+import { DEFAULT_GRAPH_CONFIG } from '../config/mcp-config.js';
+import { execSync } from 'node:child_process';
+// ---------------------------------------------------------------------------
+// Graph usage keywords — triggers graph context when found in user message
+// ---------------------------------------------------------------------------
+const CHANGE_KEYWORDS = /\b(review|refactor|impact|blast.?radius|affected|depends|dependency|dependencies|callers?|callees?|imports?|test.?coverage|dead.?code|what.?calls|who.?uses|trace)\b/gi;
+const FILE_PATH_PATTERN = /(?:^|\s)([\w./-]+\.(?:ts|tsx|js|jsx|py|rs|go|java|c|cpp|h|rb|kt|swift|php|vue|svelte|scala|cs|dart|lua|pl|r|sol))\b/gi;
+// Symbol-like identifiers: camelCase, PascalCase, or snake_case (min 4 chars, must have case change or underscore)
+const SYMBOL_PATTERN = /\b([a-z][a-zA-Z0-9]{3,}(?:[A-Z][a-zA-Z0-9]*)+|[A-Z][a-zA-Z0-9]{3,}(?:[A-Z][a-z][a-zA-Z0-9]*)+|[a-z][a-z0-9]*(?:_[a-z0-9]+)+)\b/g;
+// ---------------------------------------------------------------------------
+// GraphContextProvider
+// ---------------------------------------------------------------------------
+export class GraphContextProvider {
+    mcpClient = null;
+    projectRoot;
+    config;
+    graphAvailable = false;
+    buildReady = false;
+    lastKnownSha = null;
+    turnLogs = [];
+    loggedUnavailable = false;
+    constructor(projectRoot, config) {
+        this.projectRoot = projectRoot;
+        this.config = { ...DEFAULT_GRAPH_CONFIG, ...config };
+    }
+    /**
+     * Initialize with an MCP client that has a connected 'crg' server.
+     */
+    setMcpClient(client) {
+        this.mcpClient = client;
+        this.graphAvailable = true;
+    }
+    setGraphAvailable(available) {
+        this.graphAvailable = available;
+    }
+    /** Mark the graph as ready (build complete). */
+    setBuildReady(ready) {
+        this.buildReady = ready;
+    }
+    isAvailable() {
+        return this.graphAvailable && this.buildReady;
+    }
+    // ─── Heuristic trigger ──────────────────────────────────────
+    /**
+     * Determine if graph context should be injected for this turn.
+     * Returns false for conversational intents or messages without
+     * concrete code references.
+     */
+    shouldUseGraph(intent, userMessage) {
+        if (!this.graphAvailable || !this.buildReady)
+            return false;
+        if (intent === 'conversational')
+            return false;
+        // Weighted scoring — avoids naive boolean OR
+        // fileRef=2, symbol=2, keyword=1. Threshold: score >= 2
+        let score = 0;
+        // Reset regex lastIndex (global flag)
+        FILE_PATH_PATTERN.lastIndex = 0;
+        CHANGE_KEYWORDS.lastIndex = 0;
+        SYMBOL_PATTERN.lastIndex = 0;
+        const fileMatches = userMessage.match(FILE_PATH_PATTERN);
+        if (fileMatches)
+            score += fileMatches.length * 2;
+        const symbolMatches = userMessage.match(SYMBOL_PATTERN);
+        if (symbolMatches)
+            score += Math.min(symbolMatches.length, 3) * 2;
+        const keywordMatches = userMessage.match(CHANGE_KEYWORDS);
+        if (keywordMatches)
+            score += keywordMatches.length;
+        return score >= 2;
+    }
+    // ─── Freshness check ───────────────────────────────────────
+    /**
+     * Check if the graph is stale (files changed outside cmdr).
+     * Returns true if an incremental update was triggered.
+     */
+    async checkFreshness() {
+        try {
+            const currentSha = execSync('git rev-parse HEAD', {
+                cwd: this.projectRoot,
+                stdio: ['pipe', 'pipe', 'pipe'],
+                timeout: 5000,
+            }).toString().trim();
+            if (this.lastKnownSha && this.lastKnownSha !== currentSha) {
+                // Graph is stale — trigger incremental update
+                await this.callMcp('build_or_update_graph_tool', {
+                    full_rebuild: false,
+                    repo_root: this.projectRoot,
+                });
+                this.lastKnownSha = currentSha;
+                return 'stale';
+            }
+            this.lastKnownSha = currentSha;
+            return 'fresh';
+        }
+        catch {
+            return 'fresh'; // Can't check — assume fresh
+        }
+    }
+    // ─── Context generation ─────────────────────────────────────
+    /**
+     * Generate a graph context message for the current turn.
+     * Returns null if graph is unavailable, nothing relevant found,
+     * or an error occurs (graceful internal fallback).
+     */
+    async getContext(intent, userMessage) {
+        const start = Date.now();
+        if (!this.shouldUseGraph(intent, userMessage)) {
+            this.logTurn({ used: false, reason: 'heuristic_skip', files: 0, estimatedTokens: 0, freshness: 'skipped', latencyMs: 0 });
+            return null;
+        }
+        try {
+            // Freshness check
+            const freshness = await this.checkFreshness();
+            // Determine query strategy based on intent
+            let contextText = null;
+            if (intent === 'actionable') {
+                contextText = await this.getImpactContext(userMessage);
+            }
+            else if (intent === 'exploratory') {
+                contextText = await this.getExploratoryContext(userMessage);
+            }
+            if (!contextText) {
+                this.logTurn({ used: false, reason: 'no_results', files: 0, estimatedTokens: 0, freshness, latencyMs: Date.now() - start });
+                return null;
+            }
+            // Token budget enforcement — rough estimate: 4 chars per token
+            const estimatedTokens = Math.ceil(contextText.length / 4);
+            if (estimatedTokens > this.config.maxTokens) {
+                // Truncate to budget
+                const maxChars = this.config.maxTokens * 4;
+                contextText = contextText.slice(0, maxChars) + '\n\n[Graph context truncated to token budget]';
+            }
+            const fileCount = (contextText.match(/📄|file_path/g) || []).length || 1;
+            this.logTurn({
+                used: true,
+                reason: intent,
+                files: fileCount,
+                estimatedTokens: Math.ceil(contextText.length / 4),
+                freshness,
+                latencyMs: Date.now() - start,
+            });
+            return {
+                role: 'user',
+                content: [{ type: 'text', text: `[Graph Context]\n${contextText}` }],
+                isMeta: true,
+            };
+        }
+        catch (err) {
+            // Internal fallback — never crash the turn
+            const reason = err instanceof Error ? err.message : String(err);
+            if (!this.loggedUnavailable) {
+                console.error(`[graph] query failed: ${reason}, falling back`);
+                this.loggedUnavailable = true;
+            }
+            this.logTurn({ used: false, reason: `error: ${reason}`, files: 0, estimatedTokens: 0, freshness: 'skipped', latencyMs: Date.now() - start });
+            return null;
+        }
+    }
+    // ─── Impact context (actionable intent) ─────────────────────
+    async getImpactContext(userMessage) {
+        // Extract file paths from message
+        const fileRefs = this.extractFileRefs(userMessage);
+        // Get blast radius — either from mentioned files or auto-detected changed files
+        const params = {
+            max_depth: this.config.maxDepth,
+            repo_root: this.projectRoot,
+            base: this.config.base,
+        };
+        if (fileRefs.length > 0) {
+            params.changed_files = fileRefs;
+        }
+        const result = await this.callMcp('get_impact_radius_tool', params);
+        if (!result)
+            return null;
+        return this.formatImpactResult(result);
+    }
+    // ─── Exploratory context ────────────────────────────────────
+    async getExploratoryContext(userMessage) {
+        // Try to extract a query target from the message
+        const fileRefs = this.extractFileRefs(userMessage);
+        const callMatch = userMessage.match(/(?:what\s+calls|who\s+uses|callers?\s+of|trace)\s+[`"]?(\w+)[`"]?/i);
+        if (callMatch) {
+            // Caller query
+            const result = await this.callMcp('query_graph_tool', {
+                pattern: 'callers_of',
+                target: callMatch[1],
+                repo_root: this.projectRoot,
+            });
+            if (result)
+                return this.formatQueryResult(result, 'callers_of', callMatch[1]);
+        }
+        if (fileRefs.length > 0) {
+            // File summary
+            const result = await this.callMcp('query_graph_tool', {
+                pattern: 'file_summary',
+                target: fileRefs[0],
+                repo_root: this.projectRoot,
+            });
+            if (result)
+                return this.formatQueryResult(result, 'file_summary', fileRefs[0]);
+        }
+        // Fall back to impact radius with auto-detection
+        const result = await this.callMcp('get_impact_radius_tool', {
+            max_depth: this.config.maxDepth,
+            repo_root: this.projectRoot,
+            base: this.config.base,
+        });
+        if (result)
+            return this.formatImpactResult(result);
+        return null;
+    }
+    // ─── MCP call wrapper ──────────────────────────────────────
+    async callMcp(toolName, input) {
+        if (!this.mcpClient)
+            return null;
+        const timeoutMs = 5000;
+        const result = await Promise.race([
+            this.mcpClient.callTool('crg', toolName, input),
+            new Promise(resolve => setTimeout(() => resolve(null), timeoutMs)),
+        ]);
+        if (!result || ('isError' in result && result.isError))
+            return null;
+        try {
+            const data = typeof result.data === 'string' ? JSON.parse(result.data) : result.data;
+            return data;
+        }
+        catch {
+            return null;
+        }
+    }
+    // ─── Formatting helpers ─────────────────────────────────────
+    formatImpactResult(data) {
+        const lines = ['## Blast Radius Analysis'];
+        const impactedFiles = data.impacted_files || [];
+        const changedNodes = data.changed_nodes || [];
+        const impactedNodes = data.impacted_nodes || [];
+        if (impactedFiles.length === 0 && changedNodes.length === 0) {
+            return ''; // Nothing to report
+        }
+        // Changed nodes summary
+        if (changedNodes.length > 0) {
+            lines.push(`\n### Changed (${changedNodes.length} nodes)`);
+            for (const node of changedNodes.slice(0, this.config.maxNodes)) {
+                const name = node.name || node.qualified_name || 'unknown';
+                const kind = node.kind || '';
+                const file = node.file_path || '';
+                lines.push(`- ${kind} \`${name}\` in ${file}`);
+            }
+        }
+        // Impacted files
+        if (impactedFiles.length > 0) {
+            lines.push(`\n### Impacted Files (${impactedFiles.length})`);
+            for (const file of impactedFiles.slice(0, this.config.maxFiles)) {
+                lines.push(`- 📄 ${file}`);
+            }
+            if (impactedFiles.length > this.config.maxFiles) {
+                lines.push(`- ... and ${impactedFiles.length - this.config.maxFiles} more`);
+            }
+        }
+        // Impacted nodes (brief)
+        if (impactedNodes.length > 0) {
+            lines.push(`\n### Impacted Nodes (${impactedNodes.length})`);
+            for (const node of impactedNodes.slice(0, this.config.maxNodes)) {
+                const name = node.name || node.qualified_name || 'unknown';
+                const kind = node.kind || '';
+                lines.push(`- ${kind} \`${name}\``);
+            }
+            if (impactedNodes.length > this.config.maxNodes) {
+                lines.push(`- ... and ${impactedNodes.length - this.config.maxNodes} more`);
+            }
+        }
+        if (data.truncated) {
+            lines.push(`\n> ⚠️ Results truncated. Use graph_impact tool for full analysis.`);
+        }
+        return lines.join('\n');
+    }
+    formatQueryResult(data, pattern, target) {
+        const lines = [`## Graph Query: ${pattern}(${target})`];
+        const nodes = data.nodes || [];
+        const results = data.results || nodes;
+        if (results.length === 0) {
+            return ''; // Nothing to report
+        }
+        for (const node of results.slice(0, this.config.maxNodes)) {
+            const name = node.name || node.qualified_name || 'unknown';
+            const kind = node.kind || '';
+            const file = node.file_path || '';
+            const line = node.line_start ? `:${node.line_start}` : '';
+            lines.push(`- ${kind} \`${name}\` in ${file}${line}`);
+        }
+        if (results.length > this.config.maxNodes) {
+            lines.push(`- ... and ${results.length - this.config.maxNodes} more. Use graph_query tool to explore.`);
+        }
+        return lines.join('\n');
+    }
+    // ─── Utility ────────────────────────────────────────────────
+    extractFileRefs(message) {
+        const matches = message.match(new RegExp(FILE_PATH_PATTERN.source, 'gi'));
+        return matches ? [...new Set(matches.map(m => m.trim()))] : [];
+    }
+    logTurn(entry) {
+        this.turnLogs.push(entry);
+        // Keep last 100 entries
+        if (this.turnLogs.length > 100) {
+            this.turnLogs = this.turnLogs.slice(-100);
+        }
+    }
+    // ─── Public accessors ───────────────────────────────────────
+    getLastLog() {
+        return this.turnLogs[this.turnLogs.length - 1];
+    }
+    getStats() {
+        const graphHits = this.turnLogs.filter(l => l.used).length;
+        const totalFiles = this.turnLogs.reduce((sum, l) => sum + l.files, 0);
+        return { totalQueries: this.turnLogs.length, graphHits, totalFiles };
+    }
+    /**
+     * Trigger an incremental graph update (call after file writes).
+     * Debounce externally — this is the raw update call.
+     */
+    async triggerIncrementalUpdate() {
+        if (!this.graphAvailable || !this.mcpClient)
+            return;
+        try {
+            await this.callMcp('build_or_update_graph_tool', {
+                full_rebuild: false,
+                repo_root: this.projectRoot,
+            });
+        }
+        catch {
+            // Non-critical — log and continue
+        }
+    }
+    /**
+     * Build the graph for the first time (or full rebuild).
+     */
+    async buildGraph() {
+        if (!this.mcpClient)
+            return false;
+        try {
+            const result = await this.callMcp('build_or_update_graph_tool', {
+                full_rebuild: false,
+                repo_root: this.projectRoot,
+            });
+            if (result !== null) {
+                this.buildReady = true;
+                return true;
+            }
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=graph-context.js.map

package/dist/src/core/graph-context.js.map

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

package/dist/src/core/hooks.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Hooks — shell-based pre/post hooks for tool and command lifecycle.
+ *
+ * Hooks are defined in .cmdr.toml under [hooks]:
+ *   [hooks]
+ *   "pre:tool:bash" = "echo 'About to run bash tool'"
+ *   "post:tool:file_write" = "./scripts/lint-changed.sh"
+ *   "pre:command:commit" = "npm test"
+ *   "session:end" = "./scripts/cleanup.sh"
+ *
+ * Hook types:
+ *   pre:tool:<name>   — runs before a tool executes (can block on non-zero exit)
+ *   post:tool:<name>  — runs after a tool completes
+ *   pre:command:<name> — runs before a slash command
+ *   post:command:<name> — runs after a slash command
+ *   session:start     — runs when session begins
+ *   session:end       — runs when session ends
+ *
+ * Hooks receive context via environment variables:
+ *   CMDR_HOOK_TYPE, CMDR_TOOL_NAME, CMDR_TOOL_INPUT (JSON), CMDR_CWD
+ */
+export interface HookConfig {
+    [pattern: string]: string;
+}
+export interface HookResult {
+    success: boolean;
+    output?: string;
+    error?: string;
+}
+export declare class HookManager {
+    private hooks;
+    private cwd;
+    constructor(hookConfig?: HookConfig, cwd?: string);
+    /** Register hooks from config. */
+    loadConfig(config: HookConfig): void;
+    /** Find matching hooks for a given event pattern. */
+    private findHooks;
+    /** Execute a hook command. Returns result with success/failure info. */
+    private executeHook;
+    /**
+     * Run pre-tool hooks. Returns false if a hook blocks execution (non-zero exit).
+     */
+    runPreTool(toolName: string, input: Record<string, unknown>): Promise<{
+        allowed: boolean;
+        output?: string;
+    }>;
+    /** Run post-tool hooks (informational — cannot block). */
+    runPostTool(toolName: string, input: Record<string, unknown>, success: boolean): Promise<void>;
+    /** Run session lifecycle hooks. */
+    runSessionHook(type: 'session:start' | 'session:end'): Promise<void>;
+    /** Wire hooks into the EventBus for automatic firing. */
+    wireEventBus(): void;
+    /** Get the number of registered hooks. */
+    get count(): number;
+    /** List all registered hook patterns. */
+    list(): Array<{
+        pattern: string;
+        command: string;
+    }>;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/src/core/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/core/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,MAAM,WAAW,UAAU;IACzB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,GAAG,CAAQ;gBAEP,UAAU,GAAE,UAAe,EAAE,GAAG,GAAE,MAAsB;IAOpE,kCAAkC;IAClC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAMpC,qDAAqD;IACrD,OAAO,CAAC,SAAS;IAUjB,wEAAwE;IACxE,OAAO,CAAC,WAAW;IAmBnB;;OAEG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAqBjD,0DAA0D;IACpD,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IAiBhB,mCAAmC;IAC7B,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1E,yDAAyD;IACzD,YAAY,IAAI,IAAI;IAepB,0CAA0C;IAC1C,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,yCAAyC;IACzC,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAGpD"}

package/dist/src/core/hooks.js

@@ -0,0 +1,140 @@
+/**
+ * Hooks — shell-based pre/post hooks for tool and command lifecycle.
+ *
+ * Hooks are defined in .cmdr.toml under [hooks]:
+ *   [hooks]
+ *   "pre:tool:bash" = "echo 'About to run bash tool'"
+ *   "post:tool:file_write" = "./scripts/lint-changed.sh"
+ *   "pre:command:commit" = "npm test"
+ *   "session:end" = "./scripts/cleanup.sh"
+ *
+ * Hook types:
+ *   pre:tool:<name>   — runs before a tool executes (can block on non-zero exit)
+ *   post:tool:<name>  — runs after a tool completes
+ *   pre:command:<name> — runs before a slash command
+ *   post:command:<name> — runs after a slash command
+ *   session:start     — runs when session begins
+ *   session:end       — runs when session ends
+ *
+ * Hooks receive context via environment variables:
+ *   CMDR_HOOK_TYPE, CMDR_TOOL_NAME, CMDR_TOOL_INPUT (JSON), CMDR_CWD
+ */
+import { execSync } from 'node:child_process';
+import { globalEventBus } from './event-bus.js';
+const HOOK_TIMEOUT_MS = 30_000;
+export class HookManager {
+    hooks = new Map();
+    cwd;
+    constructor(hookConfig = {}, cwd = process.cwd()) {
+        this.cwd = cwd;
+        for (const [pattern, command] of Object.entries(hookConfig)) {
+            this.hooks.set(pattern, command);
+        }
+    }
+    /** Register hooks from config. */
+    loadConfig(config) {
+        for (const [pattern, command] of Object.entries(config)) {
+            this.hooks.set(pattern, command);
+        }
+    }
+    /** Find matching hooks for a given event pattern. */
+    findHooks(pattern) {
+        const matches = [];
+        for (const [hookPattern, command] of this.hooks) {
+            if (hookPattern === pattern) {
+                matches.push({ pattern: hookPattern, command });
+            }
+        }
+        return matches;
+    }
+    /** Execute a hook command. Returns result with success/failure info. */
+    executeHook(command, env) {
+        try {
+            const output = execSync(command, {
+                cwd: this.cwd,
+                timeout: HOOK_TIMEOUT_MS,
+                stdio: ['pipe', 'pipe', 'pipe'],
+                env: { ...process.env, ...env },
+            }).toString().trim();
+            return { success: true, output };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { success: false, error: message };
+        }
+    }
+    /**
+     * Run pre-tool hooks. Returns false if a hook blocks execution (non-zero exit).
+     */
+    async runPreTool(toolName, input) {
+        const hooks = this.findHooks(`pre:tool:${toolName}`);
+        if (hooks.length === 0)
+            return { allowed: true };
+        const env = {
+            CMDR_HOOK_TYPE: 'pre:tool',
+            CMDR_TOOL_NAME: toolName,
+            CMDR_TOOL_INPUT: JSON.stringify(input),
+            CMDR_CWD: this.cwd,
+        };
+        for (const hook of hooks) {
+            const result = this.executeHook(hook.command, env);
+            if (!result.success) {
+                return { allowed: false, output: result.error };
+            }
+        }
+        return { allowed: true };
+    }
+    /** Run post-tool hooks (informational — cannot block). */
+    async runPostTool(toolName, input, success) {
+        const hooks = this.findHooks(`post:tool:${toolName}`);
+        if (hooks.length === 0)
+            return;
+        const env = {
+            CMDR_HOOK_TYPE: 'post:tool',
+            CMDR_TOOL_NAME: toolName,
+            CMDR_TOOL_INPUT: JSON.stringify(input),
+            CMDR_TOOL_SUCCESS: String(success),
+            CMDR_CWD: this.cwd,
+        };
+        for (const hook of hooks) {
+            this.executeHook(hook.command, env);
+        }
+    }
+    /** Run session lifecycle hooks. */
+    async runSessionHook(type) {
+        const hooks = this.findHooks(type);
+        if (hooks.length === 0)
+            return;
+        const env = {
+            CMDR_HOOK_TYPE: type,
+            CMDR_CWD: this.cwd,
+        };
+        for (const hook of hooks) {
+            this.executeHook(hook.command, env);
+        }
+    }
+    /** Wire hooks into the EventBus for automatic firing. */
+    wireEventBus() {
+        globalEventBus.on('tool:before', async (data) => {
+            await this.runPreTool(data.name, data.input);
+        });
+        globalEventBus.on('tool:after', async (data) => {
+            await this.runPostTool(data.name, {}, !data.result.isError);
+        });
+        globalEventBus.on('session:start', async () => {
+            await this.runSessionHook('session:start');
+        });
+        globalEventBus.on('session:end', async () => {
+            await this.runSessionHook('session:end');
+        });
+    }
+    /** Get the number of registered hooks. */
+    get count() {
+        return this.hooks.size;
+    }
+    /** List all registered hook patterns. */
+    list() {
+        return Array.from(this.hooks.entries()).map(([pattern, command]) => ({ pattern, command }));
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/src/core/hooks.js.map

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

package/dist/src/core/intent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../src/core/intent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,aAAa,GAAG,YAAY,CAAA;AA+BxE;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CA8B1D;AAQD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,eAAO,MAAM,iBAAiB,+RAI+B,CAAA;AAE7D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,SAAS,UAAU,EAAE,GAC9B,UAAU,EAAE,CASd"}
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../src/core/intent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,aAAa,GAAG,YAAY,CAAA;AAkCxE;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CA8B1D;AAQD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,eAAO,MAAM,iBAAiB,+RAI+B,CAAA;AAE7D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,SAAS,UAAU,EAAE,GAC9B,UAAU,EAAE,CASd"}

package/dist/src/core/intent.js

@@ -21,6 +21,9 @@ const EXPLORATORY_TOOLS = new Set([
     'git_diff',
     'git_log',
     'think',
+    'graph_impact',
+    'graph_query',
+    'graph_review',
 ]);
 // ---------------------------------------------------------------------------
 // Intent detection heuristics

package/dist/src/core/intent.js.map

@@ -1 +1 @@
-{"version":3,"file":"intent.js","sourceRoot":"","sources":["../../../src/core/intent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,8EAA8E;AAC9E,wCAAwC;AACxC,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,WAAW;IACX,MAAM;IACN,MAAM;IACN,UAAU;IACV,SAAS;IACT,OAAO;CACR,CAAC,CAAA;AAEF,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,4EAA4E;AAC5E,MAAM,cAAc,GAAG,6MAA6M,CAAA;AAEpO,wEAAwE;AACxE,MAAM,eAAe,GAAG,sLAAsL,CAAA;AAE9M,oEAAoE;AACpE,MAAM,iBAAiB,GAAG,gKAAgK,CAAA;AAE1L,6EAA6E;AAC7E,MAAM,aAAa,GAAG,iHAAiH,CAAA;AAEvI;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IAE9B,iDAAiD;IACjD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,gBAAgB,CAAA;IACjD,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,gBAAgB,CAAA;IAC5D,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,gBAAgB,CAAA;IAExD,8EAA8E;IAC9E,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3F,OAAO,gBAAgB,CAAA;IACzB,CAAC;IAED,uCAAuC;IACvC,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,YAAY,CAAA;IAErD,yCAAyC;IACzC,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,aAAa,CAAA;IAEvD,iEAAiE;IACjE,IAAI,sEAAsE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzF,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,gEAAgE;IAChE,6DAA6D;IAC7D,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE;QAAE,OAAO,YAAY,CAAA;IAE7C,iEAAiE;IACjE,OAAO,aAAa,CAAA;AACtB,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG,6PAA6P,CAAA;AAEvR,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AACxC,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;6DAI4B,CAAA;AAE7D;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAkB,EAClB,QAA+B;IAE/B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,gBAAgB;YACnB,OAAO,EAAE,CAAA;QACX,KAAK,aAAa;YAChB,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;QAC5D,KAAK,YAAY;YACf,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAA;IACxB,CAAC;AACH,CAAC"}
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../../../src/core/intent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,8EAA8E;AAC9E,wCAAwC;AACxC,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,WAAW;IACX,MAAM;IACN,MAAM;IACN,UAAU;IACV,SAAS;IACT,OAAO;IACP,cAAc;IACd,aAAa;IACb,cAAc;CACf,CAAC,CAAA;AAEF,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,4EAA4E;AAC5E,MAAM,cAAc,GAAG,6MAA6M,CAAA;AAEpO,wEAAwE;AACxE,MAAM,eAAe,GAAG,sLAAsL,CAAA;AAE9M,oEAAoE;AACpE,MAAM,iBAAiB,GAAG,gKAAgK,CAAA;AAE1L,6EAA6E;AAC7E,MAAM,aAAa,GAAG,iHAAiH,CAAA;AAEvI;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IAE9B,iDAAiD;IACjD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,gBAAgB,CAAA;IACjD,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,gBAAgB,CAAA;IAC5D,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,gBAAgB,CAAA;IAExD,8EAA8E;IAC9E,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3F,OAAO,gBAAgB,CAAA;IACzB,CAAC;IAED,uCAAuC;IACvC,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,YAAY,CAAA;IAErD,yCAAyC;IACzC,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,aAAa,CAAA;IAEvD,iEAAiE;IACjE,IAAI,sEAAsE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzF,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,gEAAgE;IAChE,6DAA6D;IAC7D,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE;QAAE,OAAO,YAAY,CAAA;IAE7C,iEAAiE;IACjE,OAAO,aAAa,CAAA;AACtB,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG,6PAA6P,CAAA;AAEvR,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AACxC,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;6DAI4B,CAAA;AAE7D;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAkB,EAClB,QAA+B;IAE/B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,gBAAgB;YACnB,OAAO,EAAE,CAAA;QACX,KAAK,aAAa;YAChB,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;QAC5D,KAAK,YAAY;YACf,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAA;IACxB,CAAC;AACH,CAAC"}