openkrak-mcp 1.0.11 → 1.0.12

package/README.md

@@ -2,7 +2,7 @@
 
 MCP server for developer tooling. Performs static analysis on a software repository via the Dorchester engine and delivers a structured context brief to the language model before any file is accessed.
 
-**Current integration:** OpenCode. Claude Code, Codex, and Cursor support in development.
+**Supported:** OpenCode (TUI + Desktop). Claude Code, Codex, and Cursor support in development.
 
 ---
 
@@ -46,9 +46,21 @@ Requires Node.js ≥ 18.
 
 ---
 
-## Setup — OpenCode
+## Setup
 
-**Step 1.** Open `~/.config/opencode/opencode.jsonc` and add the `mcp` block:
+OpenKrak works with both **OpenCode TUI** and **OpenCode Desktop**. The config file and setup steps are identical for both.
+
+### Config file location
+
+| Platform | Path |
+|----------|------|
+| Windows | `C:\Users\<username>\.config\opencode\opencode.jsonc` |
+| macOS | `~/.config/opencode/opencode.jsonc` |
+| Linux | `~/.config/opencode/opencode.jsonc` |
+
+### Step 1 — Add OpenKrak to your config
+
+Open the config file and add the `mcp` block:
 
 ```jsonc
 {
@@ -63,45 +75,62 @@ Requires Node.js ≥ 18.
 }
 ```
 
-> Windows: `C:\Users\<username>\.config\opencode\opencode.jsonc`  
-> macOS / Linux: `~/.config/opencode/opencode.jsonc`
+### Step 2 — Restart OpenCode
 
-**Step 2.** Restart OpenCode. Confirm **openkrak Connected** appears in the MCP panel.
+Close and reopen OpenCode (TUI or Desktop). Confirm **openkrak Connected** appears in the MCP panel.
 
-**Step 3.** Open any repository and run a coding task. OpenKrak runs automatically before the language model accesses any file.
+> **OpenCode Desktop:** MCP status is shown in the bottom status bar. Green dot = connected.  
+> **OpenCode TUI:** MCP status is shown in the top-right panel.
+
+### Step 3 — Run your first analysis
+
+Open any repository in OpenCode and send a message:
 
-To invoke explicitly:
 ```
-Use analyze_repo on /path/to/your/repo with objective "refactor the auth module"
+analyze_repo on /absolute/path/to/your/repo
 ```
 
+Or just start a coding task normally — OpenKrak runs automatically before the model reads any file.
+
 ---
 
-## Enabling and Disabling
+## Tools
 
-Set `"enabled"` in your config and restart OpenCode:
+| Tool | When to use |
+|------|-------------|
+| `analyze_repo` | Full pipeline. Call before any coding task on a new repo. Returns dependency graph, hotspot rankings, blast radius, and threat matrix. |
+| `get_mahadata` | Compact repo brief — structure, entry points, constraints, risk score. Use when you need repo-wide context without a full re-analysis. |
+| `get_hotspots` | Ranked list of high-risk files by complexity, coupling, and change frequency. Use before reviewing or refactoring. |
+| `blast_radius` | Impact map for a specific file. Which files, modules, and APIs are affected by a change. Use before modifying a critical file. |
+
+### Example prompts
 
-```jsonc
-"enabled": true   // on
-"enabled": false  // off
+```
+analyze_repo on /path/to/repo with objective "refactor the auth module"
+```
+```
+Run get_hotspots on /path/to/repo — which files should I avoid touching?
+```
+```
+blast_radius on /path/to/repo for file src/api/routes/user.ts
 ```
 
 ---
 
-## Tools
+## Enable / Disable
 
-| Tool | Description |
-|------|-------------|
-| `analyze_repo` | Full Dorchester pipeline. Returns dependency graph, hotspot rankings, blast radius, and threat matrix. Call before any coding task. |
-| `get_mahadata` | Compact repository intelligence brief. Structure, entry points, constraints, risk score. |
-| `get_hotspots` | Ranked list of high-risk files by complexity, coupling, and change frequency. |
-| `blast_radius` | Impact map for a specific file change. Which files, modules, and APIs are affected. |
+Set `"enabled"` in your config and restart OpenCode:
+
+```jsonc
+"enabled": true   // on
+"enabled": false  // off
+```
 
 ---
 
-## License Tiers
+## Pro License
 
-Free tier is active by default — no account or configuration required.
+Free tier is active by default — no account required.
 
 | Plan | Price | Queries |
 |------|-------|---------|
@@ -109,7 +138,7 @@ Free tier is active by default — no account or configuration required.
 | Pro Monthly | $8 / month | Unlimited |
 | Pro Annual | $67.20 / year | Unlimited |
 
-To activate a Pro license, add your key to the MCP config:
+To activate Pro, add your key to the config:
 
 ```jsonc
 {
@@ -127,7 +156,7 @@ To activate a Pro license, add your key to the MCP config:
 }
 ```
 
-License keys are available at [openkrak-web.vercel.app](https://openkrak-web.vercel.app). Delivered instantly via email after purchase. No subscription, no auto-renewal.
+License keys: [openkrak-web.vercel.app](https://openkrak-web.vercel.app). Delivered via email after purchase. No subscription, no auto-renewal.
 
 ---
 
@@ -135,7 +164,7 @@ License keys are available at [openkrak-web.vercel.app](https://openkrak-web.ver
 
 - Static analysis only. No AI inference in the pipeline.
 - Anonymous usage telemetry is collected (query count, tool name, error events). No source code or file contents are transmitted.
-- License validation requires a network call to verify your key against the license server.
+- License validation requires a network call to the license server on each tool invocation.
 
 ---
 

package/dist/index.js

@@ -241794,7 +241794,7 @@ function inferLanguage(filePath) {
   if (filePath.endsWith(".js") || filePath.endsWith(".jsx")) return "javascript";
   return "unknown";
 }
-function extractRawEdges(filePath, ast, fileNodeId) {
+function extractRawEdges(filePath, ast, fileNodeId, tsconfigPaths2) {
   const edges = [];
   const symbolRanges = [];
   (0, import_typescript_estree3.simpleTraverse)(ast, {
@@ -241845,8 +241845,7 @@ function extractRawEdges(filePath, ast, fileNodeId) {
       if (node.type === "ImportDeclaration") {
         const importPath = node.source.value;
         const line = node.loc?.start.line ?? null;
-        const isBarrel = isBarrelPath(importPath);
-        const resolvedTarget = resolveImportTarget(filePath, importPath);
+        const resolvedTarget = resolveImportTarget(filePath, importPath, tsconfigPaths2);
         edges.push({
           from: importFromNodeId,
           to: resolvedTarget,
@@ -241875,7 +241874,7 @@ function extractRawEdges(filePath, ast, fileNodeId) {
         const sourceLiteral = node.source.type === "Literal" ? node.source.value : "<dynamic>";
         edges.push({
           from: fileNodeId,
-          to: resolveImportTarget(filePath, sourceLiteral),
+          to: resolveImportTarget(filePath, sourceLiteral, tsconfigPaths2),
           kind: "dynamic_import",
           file: filePath,
           line,
@@ -241889,7 +241888,6 @@ function extractRawEdges(filePath, ast, fileNodeId) {
         edges.push({
           from: fileNodeId,
           to: superName,
-          // resolved to node_id in assembly
           kind: "extend",
           file: filePath,
           line: node.loc.start.line,
@@ -241954,7 +241952,7 @@ function extractRawEdges(filePath, ast, fileNodeId) {
   });
   return edges;
 }
-function extractBarrelReExports(filePath, ast) {
+function extractBarrelReExports(filePath, ast, tsconfigPaths2) {
   const reExports = [];
   (0, import_typescript_estree3.simpleTraverse)(ast, {
     enter(node) {
@@ -241962,7 +241960,7 @@ function extractBarrelReExports(filePath, ast) {
         if (!node.source) return;
         const sourcePath = node.source.value;
         if (!sourcePath.startsWith(".")) return;
-        const resolvedSource = resolveImportTarget(filePath, sourcePath);
+        const resolvedSource = resolveImportTarget(filePath, sourcePath, tsconfigPaths2);
         if (node.type === "ExportAllDeclaration") {
           reExports.push({
             barrelFile: filePath,
@@ -241985,7 +241983,7 @@ function extractBarrelReExports(filePath, ast) {
   });
   return reExports;
 }
-function resolveImportTarget(fromFile, importPath) {
+function resolveImportTarget(fromFile, importPath, tsconfigPaths2) {
   if (importPath.startsWith(".")) {
     const dir = import_path3.default.dirname(fromFile);
     const resolved = import_path3.default.join(dir, importPath).replace(/\\/g, "/");
@@ -241995,11 +241993,29 @@ function resolveImportTarget(fromFile, importPath) {
     }
     return normalized;
   }
+  if (tsconfigPaths2) {
+    for (const [prefix, target] of Object.entries(tsconfigPaths2)) {
+      if (importPath.startsWith(prefix)) {
+        const rest = importPath.slice(prefix.length);
+        const resolved = (target + rest).replace(/\\/g, "/");
+        const normalized = resolved.replace(/\.js$/, ".ts");
+        if (!import_path3.default.extname(normalized)) {
+          return normalized + ".ts";
+        }
+        return normalized;
+      }
+    }
+  }
+  if (importPath.startsWith("@/")) {
+    const stripped = importPath.slice(2);
+    const normalized = stripped.replace(/\.js$/, ".ts");
+    if (!import_path3.default.extname(normalized)) {
+      return normalized + ".ts";
+    }
+    return normalized;
+  }
   return importPath;
 }
-function isBarrelPath(importPath) {
-  return importPath.endsWith("/index") || importPath.endsWith("/index.ts") || importPath.endsWith("/index.js") || importPath === "index";
-}
 function assembleGraph(allNodes, rawEdges, barrelReExports = []) {
   for (const node of allNodes) {
     node.id = node.id.replace(/\\/g, "/");
@@ -242511,7 +242527,14 @@ function inferModule(filePath) {
   return parts.length >= 2 ? parts[0] : null;
 }
 function isEntryPoint(filePath) {
-  return /\/(index|main|app|server|cli)\.(ts|js)x?$/.test(filePath);
+  const normalized = filePath.replace(/\\/g, "/");
+  if (/\/(index|main|server|cli)\.(ts|js)x?$/.test(normalized)) return true;
+  if (/^app\/.*page\.(ts|js)x?$/.test(normalized)) return true;
+  if (/^app\/layout\.(ts|js)x?$/.test(normalized)) return true;
+  if (/^app\/.*route\.(ts|js)x?$/.test(normalized)) return true;
+  if (/^pages\//.test(normalized) && /\.(ts|js)x?$/.test(normalized)) return true;
+  if (/^src\/(main|index|App)\.(ts|js)x?$/.test(normalized)) return true;
+  return false;
 }
 function walkAst(node, onEnter, onLeave) {
   if (!node || typeof node !== "object" || !("type" in node)) return;
@@ -242622,9 +242645,9 @@ async function runDeepStrike(store, opts) {
     for (const s of symbols) s.content_hash = currentHash;
     allNodes.push(...symbols);
     const fileNodeId = symbols.find((n) => n.kind === "file")?.id ?? `${relPath}::file::0`;
-    const rawEdges = extractRawEdges(relPath, ast, fileNodeId);
+    const rawEdges = extractRawEdges(relPath, ast, fileNodeId, tsconfigPaths);
     allRawEdges.push(...rawEdges);
-    const barrelReExports = extractBarrelReExports(relPath, ast);
+    const barrelReExports = extractBarrelReExports(relPath, ast, tsconfigPaths);
     allBarrelReExports.push(...barrelReExports);
     const secFindings = detectSecurityPatterns(relPath, content);
     allFindings.push(...secFindings);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openkrak-mcp",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "OpenKrak MCP Server - AI coding intelligence via Dorchester engine",
   "mcpName": "io.github.FrnzJulianBergmann/openkrak",
   "type": "commonjs",