openlore 2.0.0

package/dist/core/services/mcp-handlers/decisions.js

@@ -0,0 +1,239 @@
+/**
+ * MCP tool handlers: decisions
+ *
+ * record_decision      — agent records an architectural decision during dev
+ * list_decisions       — list pending/approved/all decisions
+ * approve_decision     — approve a decision for syncing
+ * reject_decision      — reject a decision
+ * sync_decisions       — write approved decisions to spec.md files
+ */
+import { spawn } from 'node:child_process';
+import { validateDirectory, sanitizeMcpError } from './utils.js';
+import { loadDecisionStore, saveDecisionStore, upsertDecisions, patchDecision, makeDecisionId, } from '../../decisions/store.js';
+import { syncApprovedDecisions } from '../../decisions/syncer.js';
+import { buildSpecMap, matchFileToDomains } from '../../../core/drift/spec-mapper.js';
+import { readOpenLoreConfig } from '../config-manager.js';
+import { join } from 'node:path';
+import { OPENSPEC_DIR } from '../../../constants.js';
+function spawnConsolidateBackground(rootPath) {
+    // Resolve binary: prefer local build over global install (same order as pre-commit hook)
+    const localDist = join(rootPath, 'dist', 'cli', 'index.js');
+    const localBin = join(rootPath, 'node_modules', '.bin', 'openlore');
+    import('node:fs').then(({ existsSync }) => {
+        let cmd;
+        let args;
+        if (existsSync(localBin)) {
+            cmd = localBin;
+            args = ['decisions', '--consolidate'];
+        }
+        else if (existsSync(localDist)) {
+            cmd = process.execPath;
+            args = [localDist, 'decisions', '--consolidate'];
+        }
+        else {
+            cmd = 'openlore';
+            args = ['decisions', '--consolidate'];
+        }
+        const child = spawn(cmd, args, {
+            cwd: rootPath,
+            detached: true,
+            stdio: 'ignore',
+        });
+        child.unref();
+    }).catch(() => { });
+}
+// ============================================================================
+// record_decision
+// ============================================================================
+export async function handleRecordDecision(directory, title, rationale, consequences, affectedFiles, supersedes, scope) {
+    try {
+        if (!title?.trim())
+            return { error: 'title is required and must not be empty.' };
+        if (!rationale?.trim())
+            return { error: 'rationale is required and must not be empty.' };
+        const rootPath = await validateDirectory(directory);
+        const store = await loadDecisionStore(rootPath);
+        // Infer domain from affectedFiles via spec-map (best-effort, falls back to 'unknown')
+        let primaryDomain = 'unknown';
+        let inferredDomains = [];
+        if (affectedFiles?.length) {
+            try {
+                const openloreConfig = await readOpenLoreConfig(rootPath);
+                const openspecPath = join(rootPath, openloreConfig?.openspecPath ?? OPENSPEC_DIR);
+                const specMap = await buildSpecMap({ rootPath, openspecPath });
+                const domainSet = new Set();
+                for (const file of affectedFiles) {
+                    for (const domain of matchFileToDomains(file, specMap)) {
+                        domainSet.add(domain);
+                    }
+                }
+                inferredDomains = [...domainSet];
+                if (inferredDomains.length > 0)
+                    primaryDomain = inferredDomains[0];
+            }
+            catch {
+                // spec-map unavailable — keep 'unknown'
+            }
+        }
+        const id = makeDecisionId(store.sessionId, primaryDomain, title.trim());
+        // Resolve scope: explicit caller value wins; otherwise auto-promote via deterministic signals.
+        // Two independent triggers, either is sufficient:
+        //   1. Structural: files span 2+ distinct top-level source dirs (file-topology, no LLM)
+        //   2. Semantic: multiple domains inferred AND rationale contains contract/API keywords
+        // Rationale-only matching is intentionally avoided — too fuzzy to be reliable under replay.
+        let resolvedScope = scope ?? 'component';
+        if (!scope) {
+            const topLevelDirs = new Set((affectedFiles ?? []).map((f) => f.split('/').slice(0, 2).join('/')));
+            const hasStructuralCrossDomain = topLevelDirs.size >= 2;
+            const lowerRationale = (rationale ?? '').toLowerCase();
+            const isRefactorOrUtil = /\b(refactor|rename|extract|util|helper|constant|config|logging|test)\b/.test(lowerRationale);
+            const hasContractKeyword = /\b(api|schema|contract|interface|protocol|auth|database|event|migration)\b/.test(lowerRationale);
+            const hasSemanticCrossDomain = inferredDomains.length >= 2 && !isRefactorOrUtil && hasContractKeyword;
+            if (hasStructuralCrossDomain || hasSemanticCrossDomain) {
+                resolvedScope = 'cross-domain';
+            }
+        }
+        const decision = {
+            id,
+            status: 'draft',
+            scope: resolvedScope,
+            title: title.trim(),
+            rationale: rationale.trim(),
+            consequences: consequences ?? '',
+            proposedRequirement: null,
+            affectedDomains: inferredDomains,
+            affectedFiles: affectedFiles ?? [],
+            supersedes,
+            sessionId: store.sessionId,
+            recordedAt: new Date().toISOString(),
+            confidence: 'medium',
+            syncedToSpecs: [],
+        };
+        const updated = upsertDecisions(store, [decision]);
+        await saveDecisionStore(rootPath, updated);
+        // Consolidate in background so commit-time gate is instant
+        spawnConsolidateBackground(rootPath);
+        return {
+            id,
+            message: `Decision recorded: "${title}". Consolidation running in background.`,
+        };
+    }
+    catch (err) {
+        return { error: sanitizeMcpError(err) };
+    }
+}
+// ============================================================================
+// list_decisions
+// ============================================================================
+export async function handleListDecisions(directory, status) {
+    try {
+        const rootPath = await validateDirectory(directory);
+        const store = await loadDecisionStore(rootPath);
+        const decisions = status
+            ? store.decisions.filter((d) => d.status === status)
+            : store.decisions;
+        return {
+            total: decisions.length,
+            sessionId: store.sessionId,
+            updatedAt: store.updatedAt,
+            decisions: decisions.map((d) => ({
+                id: d.id,
+                status: d.status,
+                title: d.title,
+                rationale: d.rationale,
+                confidence: d.confidence,
+                affectedDomains: d.affectedDomains,
+                affectedFiles: d.affectedFiles,
+                proposedRequirement: d.proposedRequirement,
+                recordedAt: d.recordedAt,
+                syncedToSpecs: d.syncedToSpecs,
+            })),
+        };
+    }
+    catch (err) {
+        return { error: sanitizeMcpError(err) };
+    }
+}
+// ============================================================================
+// approve_decision
+// ============================================================================
+export async function handleApproveDecision(directory, id, note) {
+    try {
+        const rootPath = await validateDirectory(directory);
+        const store = await loadDecisionStore(rootPath);
+        const decision = store.decisions.find((d) => d.id === id);
+        if (!decision)
+            return { error: `Decision ${id} not found.` };
+        if (decision.status === 'synced')
+            return { error: `Decision ${id} is already synced to spec files — re-approval not allowed.` };
+        const updated = patchDecision(store, id, {
+            status: 'approved',
+            reviewedAt: new Date().toISOString(),
+            reviewNote: note,
+        });
+        await saveDecisionStore(rootPath, updated);
+        return { id, status: 'approved', title: decision.title };
+    }
+    catch (err) {
+        return { error: sanitizeMcpError(err) };
+    }
+}
+// ============================================================================
+// reject_decision
+// ============================================================================
+export async function handleRejectDecision(directory, id, note) {
+    try {
+        const rootPath = await validateDirectory(directory);
+        const store = await loadDecisionStore(rootPath);
+        const decision = store.decisions.find((d) => d.id === id);
+        if (!decision)
+            return { error: `Decision ${id} not found.` };
+        const updated = patchDecision(store, id, {
+            status: 'rejected',
+            reviewedAt: new Date().toISOString(),
+            reviewNote: note,
+        });
+        await saveDecisionStore(rootPath, updated);
+        return { id, status: 'rejected', title: decision.title };
+    }
+    catch (err) {
+        return { error: sanitizeMcpError(err) };
+    }
+}
+// ============================================================================
+// sync_decisions
+// ============================================================================
+export async function handleSyncDecisions(directory, dryRun = false, id) {
+    try {
+        const rootPath = await validateDirectory(directory);
+        const openloreConfig = await readOpenLoreConfig(rootPath);
+        if (!openloreConfig)
+            return { error: 'No openlore configuration found. Run openlore init first.' };
+        const openspecPath = join(rootPath, openloreConfig.openspecPath ?? OPENSPEC_DIR);
+        const specMap = await buildSpecMap({ rootPath, openspecPath });
+        let store = await loadDecisionStore(rootPath);
+        // If a specific id is given, promote it to approved before syncing
+        if (id) {
+            const decision = store.decisions.find((d) => d.id === id);
+            if (!decision)
+                return { error: `Decision ${id} not found.` };
+            store = patchDecision(store, id, { status: 'approved' });
+        }
+        const { result } = await syncApprovedDecisions(store, {
+            rootPath,
+            openspecPath,
+            specMap,
+            dryRun,
+        });
+        return {
+            synced: result.synced.map((d) => ({ id: d.id, title: d.title, specs: d.syncedToSpecs })),
+            errors: result.errors,
+            modifiedSpecs: result.modifiedSpecs,
+            dryRun,
+        };
+    }
+    catch (err) {
+        return { error: sanitizeMcpError(err) };
+    }
+}
+//# sourceMappingURL=decisions.js.map

package/dist/core/services/mcp-handlers/decisions.js.map

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

package/dist/core/services/mcp-handlers/graph.d.ts

@@ -0,0 +1,94 @@
+/**
+ * MCP tool handlers for call-graph analysis:
+ * get_call_graph, get_subgraph, analyze_impact, get_critical_hubs,
+ * get_leaf_functions, get_low_risk_refactor_candidates, get_god_functions,
+ * trace_execution_path.
+ */
+import type { CachedContext } from './utils.js';
+import type { SerializedCallGraph, FunctionNode } from '../../analyzer/call-graph.js';
+/**
+ * Build forward (caller→callees) and backward (callee→callers) adjacency maps
+ * from a serialised call graph, returning both maps and a node lookup.
+ *
+ * Includes inheritance edges: parent class methods point forward to all child
+ * class methods so blast-radius BFS propagates through the class hierarchy.
+ */
+export declare function buildAdjacency(cg: SerializedCallGraph): {
+    nodeMap: Map<string, FunctionNode>;
+    forward: Map<string, Set<string>>;
+    backward: Map<string, Set<string>>;
+};
+/** BFS up to `maxDepth`. Returns a map of visited node-id → depth reached. */
+export declare function bfs(seeds: string[], adjacency: Map<string, Set<string>>, maxDepth: number): Map<string, number>;
+/**
+ * DB-backed lazy BFS — fetches only edges for visited nodes instead of loading all edges.
+ * direction: 'forward' = downstream (callees), 'backward' = upstream (callers).
+ */
+export declare function bfsFromDB(seeds: string[], direction: 'forward' | 'backward', maxDepth: number, es: CachedContext['edgeStore']): Map<string, number>;
+/**
+ * Compute a risk score [0–100] for a node.
+ *
+ * Weights: fan-in × 4, fan-out × 2, isHub × 20, blastRadius × 1.5. Capped at 100.
+ */
+export declare function computeRiskScore(node: FunctionNode, blastRadius: number, isHub: boolean): number;
+/** Derive a plain-language refactoring strategy from the risk profile. */
+export declare function recommendStrategy(riskScore: number, fanIn: number, fanOut: number, isHub: boolean): {
+    approach: string;
+    rationale: string;
+};
+export declare function nodeToSummary(n: FunctionNode | undefined): {
+    name: string;
+    file: string;
+    className: string | null;
+    depth: number;
+};
+/**
+ * Return the call graph summary from cached analysis.
+ */
+export declare function handleGetCallGraph(directory: string): Promise<unknown>;
+/**
+ * Extract a depth-limited subgraph centred on a named function.
+ * Falls back to semantic search if no exact name match is found.
+ */
+export declare function handleGetSubgraph(directory: string, functionName: string, direction?: 'downstream' | 'upstream' | 'both', maxDepth?: number, format?: 'json' | 'mermaid'): Promise<unknown>;
+/**
+ * Deep impact analysis for a single symbol.
+ * Falls back to semantic search if no exact name match is found.
+ */
+export declare function handleAnalyzeImpact(directory: string, symbol: string, depth?: number): Promise<unknown>;
+/**
+ * Return the N safest functions to refactor.
+ */
+export declare function handleGetLowRiskRefactorCandidates(directory: string, limit?: number, filePattern?: string): Promise<unknown>;
+/**
+ * Return leaf functions (fan-out === 0).
+ */
+export declare function handleGetLeafFunctions(directory: string, limit?: number, filePattern?: string, sortBy?: 'fanIn' | 'name' | 'file'): Promise<unknown>;
+/**
+ * Return critical hub functions ranked by composite criticality.
+ */
+export declare function handleGetCriticalHubs(directory: string, limit?: number, minFanIn?: number): Promise<unknown>;
+/**
+ * Detect god functions (high fan-out) and return their call-graph neighborhood.
+ */
+export declare function handleGetGodFunctions(directory: string, filePath?: string, fanOutThreshold?: number): Promise<unknown>;
+/**
+ * Return the file-level import dependencies for a given file.
+ *
+ * Uses the dependency-graph.json produced by `openlore analyze`.
+ * direction:
+ *   "imports"  — files this file depends on (outgoing edges)
+ *   "importedBy" — files that depend on this file (incoming edges)
+ *   "both"     — both directions
+ */
+export declare function handleGetFileDependencies(directory: string, filePath: string, direction?: 'imports' | 'importedBy' | 'both'): Promise<unknown>;
+/**
+ * Find all execution paths between two functions in the call graph.
+ * Useful for debugging: "how does request X reach function Y?",
+ * "which call chain produced this error?".
+ *
+ * Uses DFS with visited-set cycle detection. Returns paths ordered
+ * by hop count (shortest first), capped at maxPaths.
+ */
+export declare function handleTraceExecutionPath(directory: string, entryFunction: string, targetFunction: string, maxDepth?: number, maxPaths?: number): Promise<unknown>;
+//# sourceMappingURL=graph.d.ts.map

package/dist/core/services/mcp-handlers/graph.d.ts.map

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