openlore 2.0.9 → 2.0.11

package/dist/core/services/tool-dispatch.js

@@ -0,0 +1,246 @@
+/**
+ * Shared tool dispatch — single source of truth mapping a tool name + args to its
+ * handler. Consumed by BOTH transports:
+ *   - the stdio MCP server (`src/cli/commands/mcp.ts`)
+ *   - the local HTTP daemon (`src/cli/commands/serve.ts`)
+ *
+ * Keeping one dispatch table here prevents the two transports from drifting as
+ * handlers are added or their signatures change. This function is intentionally
+ * pure: it resolves args → handler → result and nothing else. Transport concerns
+ * (input validation, telemetry, epistemic/panic tracking, output truncation) stay
+ * in the caller.
+ *
+ * `directory` is passed explicitly (already resolved from `args.directory` by the
+ * caller) but most branches re-read it from `args` to preserve the exact behaviour
+ * the MCP server had before this extraction.
+ */
+import { DEFAULT_DRIFT_MAX_FILES } from '../../constants.js';
+import { handleOrient } from './mcp-handlers/orient.js';
+import { handleSelectTests } from './mcp-handlers/test-impact.js';
+import { handleFindDeadCode } from './mcp-handlers/reachability.js';
+import { handleStructuralDiff } from './mcp-handlers/structural-diff.js';
+import { handleGetChangeCoupling } from './mcp-handlers/change-coupling.js';
+import { handleCheckArchitecture } from './mcp-handlers/architecture.js';
+import { handleGenerateChangeProposal, handleAnnotateStory } from './mcp-handlers/change.js';
+import { handleGetCallGraph, handleGetSubgraph, handleAnalyzeImpact, handleGetLowRiskRefactorCandidates, handleGetLeafFunctions, handleGetCriticalHubs, handleGetGodFunctions, handleGetFileDependencies, handleTraceExecutionPath, } from './mcp-handlers/graph.js';
+import { handleSearchCode, handleSuggestInsertionPoints, handleSearchSpecs, handleListSpecDomains, handleGetSpec, handleUnifiedSearch, } from './mcp-handlers/semantic.js';
+import { handleRecordDecision, handleListDecisions, handleApproveDecision, handleRejectDecision, handleSyncDecisions, } from './mcp-handlers/decisions.js';
+import { handleAnalyzeCodebase, handleGetArchitectureOverview, handleGetRefactorReport, handleGetDuplicateReport, handleGetSignatures, handleGetMapping, handleCheckSpecDrift, handleGetFunctionSkeleton, handleGetFunctionBody, handleGetDecisions, handleGetRouteInventory, handleGetMiddlewareInventory, handleGetSchemaInventory, handleGetUIComponents, handleGetEnvVars, handleGetExternalPackages, handleAuditSpecCoverage, handleGenerateTests, handleGetTestCoverage, handleGetMinimalContext, handleGetCluster, handleDetectChanges, } from './mcp-handlers/analysis.js';
+/** Thrown when a tool name has no registered handler. Callers map this to their
+ * transport's "unknown tool" response (isError result / HTTP 404). */
+export class UnknownToolError extends Error {
+    toolName;
+    constructor(toolName) {
+        super(`Unknown tool: ${toolName}`);
+        this.toolName = toolName;
+        this.name = 'UnknownToolError';
+    }
+}
+/**
+ * Resolve a tool call to its result. Throws {@link UnknownToolError} for an
+ * unregistered name; propagates any handler error unchanged.
+ */
+export async function dispatchTool(name, args, directory) {
+    if (name === 'orient') {
+        const { task, limit = 5, tokenBudget, lean } = args;
+        return handleOrient(directory, task, limit, tokenBudget, lean);
+    }
+    else if (name === 'analyze_codebase') {
+        const { directory, force = false } = args;
+        return handleAnalyzeCodebase(directory, force);
+    }
+    else if (name === 'get_architecture_overview') {
+        const { directory } = args;
+        return handleGetArchitectureOverview(directory);
+    }
+    else if (name === 'get_refactor_report') {
+        const { directory } = args;
+        return handleGetRefactorReport(directory);
+    }
+    else if (name === 'get_call_graph') {
+        const { directory } = args;
+        return handleGetCallGraph(directory);
+    }
+    else if (name === 'get_signatures') {
+        const { directory, filePattern } = args;
+        return handleGetSignatures(directory, filePattern);
+    }
+    else if (name === 'get_subgraph') {
+        const { directory, functionName, direction = 'downstream', maxDepth = 3, format = 'json' } = args;
+        return handleGetSubgraph(directory, functionName, direction, maxDepth, format);
+    }
+    else if (name === 'trace_execution_path') {
+        const { directory, entryFunction, targetFunction, maxDepth = 6, maxPaths = 10 } = args;
+        return handleTraceExecutionPath(directory, entryFunction, targetFunction, maxDepth, maxPaths);
+    }
+    else if (name === 'get_mapping') {
+        const { directory, domain, orphansOnly } = args;
+        return handleGetMapping(directory, domain, orphansOnly);
+    }
+    else if (name === 'analyze_impact') {
+        const { directory, symbol, depth = 2 } = args;
+        return handleAnalyzeImpact(directory, symbol, depth);
+    }
+    else if (name === 'select_tests') {
+        const { directory, changedSymbols, diffRef, maxDepth } = args;
+        return handleSelectTests({ directory, changedSymbols, diffRef, maxDepth });
+    }
+    else if (name === 'find_dead_code') {
+        const { directory, ifDeleted, maxResults, filePattern } = args;
+        return handleFindDeadCode({ directory, ifDeleted, maxResults, filePattern });
+    }
+    else if (name === 'structural_diff') {
+        const { directory, baseRef, headRef, maxResults } = args;
+        return handleStructuralDiff({ directory, baseRef, headRef, maxResults });
+    }
+    else if (name === 'get_change_coupling') {
+        const { directory, file, limit } = args;
+        return handleGetChangeCoupling({ directory, file, limit });
+    }
+    else if (name === 'check_architecture') {
+        const { directory, from, to } = args;
+        return handleCheckArchitecture({ directory, from, to });
+    }
+    else if (name === 'get_low_risk_refactor_candidates') {
+        const { directory, limit = 5, filePattern } = args;
+        return handleGetLowRiskRefactorCandidates(directory, limit, filePattern);
+    }
+    else if (name === 'get_leaf_functions') {
+        const { directory, limit = 20, filePattern, sortBy = 'fanIn' } = args;
+        return handleGetLeafFunctions(directory, limit, filePattern, sortBy);
+    }
+    else if (name === 'get_critical_hubs') {
+        const { directory, limit = 10, minFanIn = 3 } = args;
+        return handleGetCriticalHubs(directory, limit, minFanIn);
+    }
+    else if (name === 'get_duplicate_report') {
+        const { directory } = args;
+        return handleGetDuplicateReport(directory);
+    }
+    else if (name === 'get_function_skeleton') {
+        const { directory, filePath } = args;
+        return handleGetFunctionSkeleton(directory, filePath);
+    }
+    else if (name === 'get_god_functions') {
+        const { directory, filePath, fanOutThreshold = 8 } = args;
+        return handleGetGodFunctions(directory, filePath, fanOutThreshold);
+    }
+    else if (name === 'check_spec_drift') {
+        const { directory, base = 'auto', files = [], domains = [], failOn = 'warning', maxFiles = DEFAULT_DRIFT_MAX_FILES } = args;
+        return handleCheckSpecDrift(directory, base, files, domains, failOn, maxFiles);
+    }
+    else if (name === 'search_code') {
+        const { directory, query, limit = 10, language, minFanIn, tokenBudget } = args;
+        return handleSearchCode(directory, query, limit, language, minFanIn, tokenBudget);
+    }
+    else if (name === 'suggest_insertion_points') {
+        const { directory, description, limit = 5, language } = args;
+        return handleSuggestInsertionPoints(directory, description, limit, language);
+    }
+    else if (name === 'search_specs') {
+        const { directory, query, limit = 10, domain, section } = args;
+        return handleSearchSpecs(directory, query, limit, domain, section);
+    }
+    else if (name === 'search_unified') {
+        const { directory, query, limit = 10, language, domain, section } = args;
+        return handleUnifiedSearch(directory, query, limit, language, domain, section);
+    }
+    else if (name === 'list_spec_domains') {
+        const { directory } = args;
+        return handleListSpecDomains(directory);
+    }
+    else if (name === 'get_spec') {
+        const { directory, domain } = args;
+        return handleGetSpec(directory, domain);
+    }
+    else if (name === 'get_function_body') {
+        const { directory, filePath, functionName } = args;
+        return handleGetFunctionBody(directory, filePath, functionName);
+    }
+    else if (name === 'get_file_dependencies') {
+        const { directory, filePath, direction = 'both' } = args;
+        return handleGetFileDependencies(directory, filePath, direction);
+    }
+    else if (name === 'generate_change_proposal') {
+        const { directory, description, slug, storyContent } = args;
+        return handleGenerateChangeProposal(directory, description, slug, storyContent);
+    }
+    else if (name === 'annotate_story') {
+        const { directory, storyFilePath, description } = args;
+        return handleAnnotateStory(directory, storyFilePath, description);
+    }
+    else if (name === 'get_decisions') {
+        const { directory, query } = args;
+        return handleGetDecisions(directory, query);
+    }
+    else if (name === 'get_route_inventory') {
+        const { directory } = args;
+        return handleGetRouteInventory(directory);
+    }
+    else if (name === 'get_middleware_inventory') {
+        const { directory } = args;
+        return handleGetMiddlewareInventory(directory);
+    }
+    else if (name === 'get_schema_inventory') {
+        const { directory } = args;
+        return handleGetSchemaInventory(directory);
+    }
+    else if (name === 'get_ui_components') {
+        const { directory } = args;
+        return handleGetUIComponents(directory);
+    }
+    else if (name === 'get_env_vars') {
+        const { directory } = args;
+        return handleGetEnvVars(directory);
+    }
+    else if (name === 'get_external_packages') {
+        const { directory } = args;
+        return handleGetExternalPackages(directory);
+    }
+    else if (name === 'audit_spec_coverage') {
+        const { directory, maxUncovered = 50, hubThreshold = 5 } = args;
+        return handleAuditSpecCoverage(directory, maxUncovered, hubThreshold);
+    }
+    else if (name === 'generate_tests') {
+        const { directory, domains, framework, useLlm, dryRun } = args;
+        return handleGenerateTests({ directory, domains, framework, useLlm, dryRun });
+    }
+    else if (name === 'get_test_coverage') {
+        const { directory, domains, minCoverage } = args;
+        return handleGetTestCoverage({ directory, domains, minCoverage });
+    }
+    else if (name === 'get_minimal_context') {
+        const { directory, functionName, filePath } = args;
+        return handleGetMinimalContext(directory, functionName, filePath);
+    }
+    else if (name === 'get_cluster') {
+        const { directory, functionName } = args;
+        return handleGetCluster(directory, functionName);
+    }
+    else if (name === 'detect_changes') {
+        const { directory, base } = args;
+        return handleDetectChanges(directory, base);
+    }
+    else if (name === 'record_decision') {
+        const { directory, title, rationale, consequences, affectedFiles, supersedes, scope } = args;
+        return handleRecordDecision(directory, title, rationale, consequences, affectedFiles, supersedes, scope);
+    }
+    else if (name === 'list_decisions') {
+        const { directory, status } = args;
+        return handleListDecisions(directory, status);
+    }
+    else if (name === 'approve_decision') {
+        const { directory, id, note } = args;
+        return handleApproveDecision(directory, id, note);
+    }
+    else if (name === 'reject_decision') {
+        const { directory, id, note } = args;
+        return handleRejectDecision(directory, id, note);
+    }
+    else if (name === 'sync_decisions') {
+        const { directory, dryRun = false, id } = args;
+        return handleSyncDecisions(directory, dryRun, id);
+    }
+    throw new UnknownToolError(name);
+}
+//# sourceMappingURL=tool-dispatch.js.map

package/dist/core/services/tool-dispatch.js.map

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

package/examples/pi/README.md

@@ -0,0 +1,70 @@
+# openlore × Pi
+
+A [Pi](https://pi.dev) extension that brings openlore's deterministic structural
+context into Pi — built for local models (Qwen, Gemma, …) that are strong at
+using injected context but weaker at tool-calling.
+
+It does **not** use MCP. It talks to a warm `openlore serve` HTTP daemon over
+loopback, so tool calls hit warm caches and the analysis stays continuously
+fresh while you edit.
+
+## What you get
+
+- **Context injection** (no tool call needed): each session starts grounded with
+  the architecture digest (`CODEBASE.md`), the spec-domain index, and a
+  task-specific `orient` on your first message.
+- **Native tools**: the navigation surface as Pi tools —
+  `openlore_orient`, `openlore_search_code`, `openlore_get_subgraph`,
+  `openlore_trace_execution_path`, `openlore_analyze_impact`,
+  `openlore_suggest_insertion_points`, `openlore_get_function_skeleton`.
+
+## Prerequisites
+
+```bash
+npm i -g openlore         # `openlore` must be on PATH
+cd your-project
+openlore analyze          # build the structural index at least once
+```
+
+## Install
+
+Automatic:
+
+```bash
+openlore setup --tools pi            # → .pi/extensions/openlore.ts (this project)
+openlore setup --tools pi --global   # → ~/.pi/agent/extensions/openlore.ts (all projects)
+```
+
+Manual: copy `openlore.ts` into either location.
+
+> Imports are verified against pi 0.78 (`Type` from `typebox`, `StringEnum` from
+> `@earendil-works/pi-ai`, extension types from `@earendil-works/pi-coding-agent`).
+> If a future Pi version moves these, adjust the imports at the top of `openlore.ts`.
+
+## How it works
+
+On first use the extension looks for `.openlore/serve.json`; if no healthy daemon
+is announced it spawns `openlore serve` detached and waits for `/health`.
+The daemon:
+
+- serves the `navigation` tool preset over `127.0.0.1`,
+- keeps signatures/vector fresh live, and
+- re-analyzes the call graph (debounced) after each edit burst — so what the
+  model sees never silently diverges from the code.
+
+The extension never kills a daemon it didn't start; it may be serving other
+clients (another Pi session, an editor).
+
+## Verify
+
+```bash
+# daemon is reachable
+curl 127.0.0.1:$(jq .port .openlore/serve.json)/health
+
+# a tool round-trips
+curl -XPOST 127.0.0.1:$(jq .port .openlore/serve.json)/tool/orient \
+  -d '{"args":{"task":"add rate limiting"}}'
+```
+
+Then run Pi in the project and confirm the session opens with openlore context
+and that `openlore_orient` is callable.