openkrak-mcp 1.0.12 → 1.0.13

package/dist/index.js

@@ -244859,150 +244859,244 @@ function estimateTokensSaved(totalLoc, totalFiles, mahadataOutput) {
 
 // src/tools/analyze_repo.ts
 async function handleAnalyzeRepo(args) {
-  const result = await runPipeline({
-    repoPath: args.path,
-    objective: args.objective ?? "Analyze repository"
-  });
+  let result;
+  try {
+    result = await runPipeline({
+      repoPath: args.path,
+      objective: args.objective ?? "Full repository analysis"
+    });
+  } catch (e) {
+    return {
+      content: [{ type: "text", text: `OpenKrak is not available for this repository. Proceed with direct file analysis.
+Reason: ${e instanceof Error ? e.message : String(e)}` }],
+      isError: false
+    };
+  }
   if (result.status === "failed") {
     return {
-      content: [{ type: "text", text: `Analysis failed: ${result.error}` }],
-      isError: true
+      content: [{ type: "text", text: `OpenKrak could not complete analysis for this path. Proceed without it.
+Detail: ${result.error ?? "unknown"}` }],
+      isError: false
     };
   }
-  const mahadata = result.mahadata;
-  const meta = mahadata.meta;
-  const repo = mahadata.repository;
-  const hotspots = mahadata.hotspots;
-  const findings = mahadata.findings;
-  const brief = mahadata.execution_brief;
-  const summary = [
-    `# OpenKrak Analysis \u2014 ${repo?.name ?? args.path}`,
-    `Status: ${result.status} (${result.durationMs}ms)`,
-    `Files: ${repo?.total_files ?? "?"} | LOC: ${repo?.total_loc ?? "?"}`,
-    `Language: ${repo?.primary_language ?? "?"} | Framework: ${repo?.framework ?? "none"}`,
-    ``,
-    `## Hotspots (${hotspots?.length ?? 0} files)`,
-    ...hotspots?.slice(0, 5).map((h) => {
+  const m = result.mahadata;
+  const meta = m.meta;
+  const repo = m.repository;
+  const hotspots = m.hotspots ?? [];
+  const blastRadius = m.blast_radius ?? [];
+  const findings = m.findings ?? [];
+  const brief = m.execution_brief;
+  const threat = m.threat_matrix;
+  const topology = m.project_topology;
+  const totalFiles = Number(repo?.total_files ?? 0);
+  const hotspotLimit = totalFiles < 50 ? 5 : totalFiles < 200 ? 8 : 12;
+  const ep = brief?.recommended_entry_points ?? [];
+  const ctx = brief?.critical_context ?? [];
+  const constraints = brief?.constraints ?? [];
+  const blockers = threat?.blockers ?? [];
+  const warnings = threat?.warnings ?? [];
+  const lines = [
+    `\u2554\u2550\u2550 DORCHESTER SCAN COMPLETE \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    `\u2551 Repo     : ${repo?.name ?? args.path}`,
+    `\u2551 Scan ID  : ${(meta?.scan_id ?? "?").slice(0, 8)}  |  Duration: ${result.durationMs}ms`,
+    `\u2551 Stats    : ${repo?.total_files ?? "?"} files  |  ${repo?.total_loc ?? "?"} LOC  |  ${repo?.primary_language ?? "?"}  |  framework: ${repo?.framework ?? "none"}`,
+    `\u2551 Topology : ${topology?.type ?? "?"} \u2014 modules: ${(topology?.modules ?? []).length}`,
+    `\u2560\u2550\u2550 OBJECTIVE \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    `\u2551 ${brief?.objective ?? args.objective ?? "\u2014"}`,
+    `\u2551 ${brief?.repository_summary ?? ""}`,
+    `\u2560\u2550\u2550 ENTRY POINTS \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    ...ep.length > 0 ? ep.map((e) => `\u2551 \u2192 ${e.path}${e.symbol ? `::${e.symbol}` : ""}  [${e.reason}]`) : [`\u2551 \u2192 none detected`],
+    `\u2560\u2550\u2550 CRITICAL CONTEXT \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    ...ctx.length > 0 ? ctx.map((c) => `\u2551 ${c.key}: ${c.value}`) : [`\u2551 \u2014`],
+    `\u2560\u2550\u2550 HOTSPOT REGISTRY (${hotspots.length} files ranked) \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    ...hotspots.slice(0, hotspotLimit).map((h, i) => {
       const hs = h;
-      return `- ${hs.path} [${hs.risk_level}] score: ${Number(hs.score).toFixed(2)}`;
-    }) ?? [],
-    ``,
-    `## Findings (${findings?.length ?? 0} total)`,
-    ``,
-    `## Execution Brief`,
-    brief?.objective ? `Objective: ${brief.objective}` : "",
-    brief?.repository_summary ? `Summary: ${brief.repository_summary}` : "",
+      const reasons = hs.reasons ?? [];
+      const bar = "\u2588".repeat(Math.round(Number(hs.score) * 10));
+      return `\u2551 ${String(i + 1).padStart(2)}. [${String(hs.risk_level).toUpperCase().padEnd(8)}] ${hs.path}
+\u2551     score:${Number(hs.score).toFixed(3)} ${bar}  changes:${hs.change_frequency}  flags:${reasons.map((r) => r.type).join(", ")}`;
+    }),
+    `\u2560\u2550\u2550 BLAST RADIUS (top ${Math.min(5, blastRadius.length)}) \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    ...blastRadius.slice(0, 5).map((b) => {
+      const br = b;
+      return `\u2551 \u26A1 ${br.trigger_file}
+\u2551     \u2192 ${br.total_affected_files} files  |  ${br.total_affected_modules} modules  |  risk:${Number(br.risk_score).toFixed(3)}`;
+    }),
+    `\u2560\u2550\u2550 THREAT MATRIX \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    `\u2551 Overall Risk : ${Number(threat?.overall_risk_score ?? 0).toFixed(3)}  |  ${threat?.risk_summary ?? ""}`,
+    `\u2551 Blockers     : ${blockers.length > 0 ? blockers.slice(0, 3).map((b) => b.description ?? b).join(" | ") : "none"}`,
+    `\u2551 Warnings     : ${warnings.length} total${warnings.length > 0 ? " \u2014 " + warnings.slice(0, 3).map((w) => w.description ?? w).join(" | ") : ""}`,
+    `\u2551 Findings     : ${findings.length} total`,
+    `\u2560\u2550\u2550 CONSTRAINTS \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    `\u2551 ${constraints.length > 0 ? constraints.join("  |  ") : "none"}`,
+    `\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
     ``,
-    `Scan ID: ${meta?.scan_id ?? "?"}`
-  ].filter(Boolean).join("\n");
+    `Dorchester has pre-mapped this repository. Proceed with full context. Do not read source files unless specific line-level detail is required.`
+  ];
+  const output = lines.join("\n");
   const totalLoc = Number(repo?.total_loc ?? 0);
-  const totalFiles = Number(repo?.total_files ?? 0);
-  const saved = estimateTokensSaved(totalLoc, totalFiles, summary);
+  const saved = estimateTokensSaved(totalLoc, totalFiles, output);
   trackTokens(saved, "analyze_repo");
-  return { content: [{ type: "text", text: summary }] };
+  return { content: [{ type: "text", text: output }] };
 }
 
 // src/tools/get_hotspots.ts
 async function handleGetHotspots(args) {
-  const result = await runPipeline({
-    repoPath: args.path,
-    objective: "Identify hotspots"
-  });
+  let result;
+  try {
+    result = await runPipeline({
+      repoPath: args.path,
+      objective: "Identify hotspots"
+    });
+  } catch (e) {
+    return {
+      content: [{ type: "text", text: `OpenKrak is not available for this repository. Proceed with direct file analysis.
+Reason: ${e instanceof Error ? e.message : String(e)}` }],
+      isError: false
+    };
+  }
   if (result.status === "failed") {
     return {
-      content: [{ type: "text", text: `Analysis failed: ${result.error}` }],
-      isError: true
+      content: [{ type: "text", text: `OpenKrak could not complete hotspot analysis. Proceed without it.
+Detail: ${result.error ?? "unknown"}` }],
+      isError: false
     };
   }
   const mahadata = result.mahadata;
   const hotspots = mahadata.hotspots ?? [];
+  const repo = mahadata.repository;
   if (hotspots.length === 0) {
     return {
-      content: [{ type: "text", text: "No hotspots detected." }]
+      content: [{ type: "text", text: `OpenKrak: no hotspots detected in ${repo?.name ?? args.path}. Repository appears low-risk.` }]
     };
   }
   const lines = [
-    `# Hotspots \u2014 ${hotspots.length} files ranked by risk`,
-    "",
+    `\u2554\u2550\u2550 HOTSPOT REGISTRY \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    `\u2551 ${repo?.name ?? args.path}  |  ${hotspots.length} files ranked by composite risk score`,
+    `\u2551 duration: ${result.durationMs}ms`,
+    `\u2560\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
     ...hotspots.map((h, i) => {
       const hs = h;
       const reasons = hs.reasons ?? [];
+      const score = Number(hs.score);
+      const bar = "\u2588".repeat(Math.max(1, Math.round(score * 10))) + "\u2591".repeat(Math.max(0, 10 - Math.round(score * 10)));
       return [
-        `## ${i + 1}. ${hs.path}`,
-        `Risk: ${hs.risk_level} | Score: ${Number(hs.score).toFixed(3)} | Changes: ${hs.change_frequency}`,
-        `Reasons: ${reasons.map((r) => r.type).join(", ")}`
+        `\u2551`,
+        `\u2551  ${String(i + 1).padStart(2)}. ${hs.path}`,
+        `\u2551      Risk     : ${String(hs.risk_level).toUpperCase()}  |  Score: ${score.toFixed(3)}  [${bar}]`,
+        `\u2551      Changes  : ${hs.change_frequency}  |  Flags: ${reasons.map((r) => r.type).join(", ")}`,
+        ...reasons.filter((r) => r.detail).slice(0, 2).map((r) => `\u2551      Detail   : ${r.detail}`)
       ].join("\n");
-    })
-  ].join("\n");
-  return { content: [{ type: "text", text: lines }] };
+    }),
+    `\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    ``,
+    `Touch these files with caution. Prioritize review in order listed.`
+  ];
+  return { content: [{ type: "text", text: lines.join("\n") }] };
 }
 
 // src/tools/blast_radius.ts
 async function handleBlastRadius(args) {
-  const result = await runPipeline({
-    repoPath: args.path,
-    objective: `Blast radius for ${args.file}`
-  });
+  let result;
+  try {
+    result = await runPipeline({
+      repoPath: args.path,
+      objective: `Blast radius for ${args.file}`
+    });
+  } catch (e) {
+    return {
+      content: [{ type: "text", text: `OpenKrak is not available for this repository. Proceed with direct analysis.
+Reason: ${e instanceof Error ? e.message : String(e)}` }],
+      isError: false
+    };
+  }
   if (result.status === "failed") {
     return {
-      content: [{ type: "text", text: `Analysis failed: ${result.error}` }],
-      isError: true
+      content: [{ type: "text", text: `OpenKrak could not compute blast radius. Proceed without it.
+Detail: ${result.error ?? "unknown"}` }],
+      isError: false
     };
   }
   const mahadata = result.mahadata;
   const blastRadiusAll = mahadata.blast_radius ?? [];
+  const repo = mahadata.repository;
   const entry = blastRadiusAll.find((b) => {
     const br = b;
     return br.trigger_file === args.file || br.trigger_file?.endsWith(args.file);
   });
   if (!entry) {
     const lines2 = [
-      `# Blast Radius \u2014 file not matched: ${args.file}`,
-      `Available trigger files: ${blastRadiusAll.length}`,
-      ...blastRadiusAll.slice(0, 10).map((b) => {
+      `\u2554\u2550\u2550 BLAST RADIUS \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+      `\u2551 File not matched: ${args.file}`,
+      `\u2551 Dorchester tracked ${blastRadiusAll.length} trigger files in this repo.`,
+      `\u2560\u2550\u2550 AVAILABLE TRIGGER FILES \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+      ...blastRadiusAll.slice(0, 12).map((b) => {
         const br = b;
-        return `- ${br.trigger_file} (risk: ${Number(br.risk_score).toFixed(2)}, affects ${br.total_affected_files} files)`;
-      })
-    ].join("\n");
-    return { content: [{ type: "text", text: lines2 }] };
+        return `\u2551 \u2022 ${br.trigger_file}  (risk:${Number(br.risk_score).toFixed(3)}, affects ${br.total_affected_files} files)`;
+      }),
+      `\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`
+    ];
+    return { content: [{ type: "text", text: lines2.join("\n") }] };
   }
   const impact = entry.impact;
+  const files = impact?.files ?? [];
+  const modules = impact?.modules ?? [];
+  const apis = impact?.apis ?? [];
+  const riskScore = Number(entry.risk_score);
+  const riskBar = "\u2588".repeat(Math.max(1, Math.round(riskScore * 10))) + "\u2591".repeat(Math.max(0, 10 - Math.round(riskScore * 10)));
   const lines = [
-    `# Blast Radius \u2014 ${entry.trigger_file}`,
-    `Risk Score: ${Number(entry.risk_score).toFixed(3)}`,
-    `Affected Files: ${entry.total_affected_files} | Modules: ${entry.total_affected_modules}`,
-    ``,
-    `## Affected Files (top 10)`,
-    ...(impact.files ?? []).slice(0, 10).map((f) => {
+    `\u2554\u2550\u2550 BLAST RADIUS \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    `\u2551 Trigger  : ${entry.trigger_file}`,
+    `\u2551 Repo     : ${repo?.name ?? args.path}  |  duration:${result.durationMs}ms`,
+    `\u2560\u2550\u2550 IMPACT SUMMARY \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    `\u2551 Risk Score      : ${riskScore.toFixed(3)}  [${riskBar}]`,
+    `\u2551 Affected Files  : ${entry.total_affected_files}`,
+    `\u2551 Affected Modules: ${entry.total_affected_modules}`,
+    `\u2551 APIs at Risk    : ${apis.length}`,
+    `\u2560\u2550\u2550 AFFECTED FILES (${files.length} total) \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    ...files.slice(0, 15).map((f) => {
       const fi = f;
-      return `- [${fi.impact_type}] ${fi.path} (depth: ${fi.depth}, confidence: ${Number(fi.confidence).toFixed(2)})`;
+      const depthBar = "\xB7".repeat(Number(fi.depth ?? 0));
+      return `\u2551 ${depthBar}\u2192 [${String(fi.impact_type ?? "?").padEnd(8)}] ${fi.path}  confidence:${Number(fi.confidence ?? 0).toFixed(2)}`;
     }),
-    ``,
-    `## Affected Modules`,
-    ...(impact.modules ?? []).map((m) => {
+    ...files.length > 15 ? [`\u2551 ... and ${files.length - 15} more`] : [],
+    `\u2560\u2550\u2550 AFFECTED MODULES \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    ...modules.length > 0 ? modules.map((m) => {
       const mi = m;
-      return `- ${mi.name}: ${mi.impact_level}`;
-    }),
-    ``,
-    `## APIs at Risk`,
-    ...(impact.apis ?? []).map((a) => {
+      return `\u2551 \u2022 ${mi.name}  \u2014  ${mi.impact_level}`;
+    }) : [`\u2551 none`],
+    `\u2560\u2550\u2550 APIs AT RISK \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    ...apis.length > 0 ? apis.map((a) => {
       const ai = a;
-      return `- ${ai.endpoint}: ${ai.impact_level}`;
-    })
-  ].join("\n");
-  return { content: [{ type: "text", text: lines }] };
+      return `\u2551 \u2022 ${ai.endpoint}  \u2014  ${ai.impact_level}`;
+    }) : [`\u2551 none`],
+    `\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    ``,
+    `Modifying ${entry.trigger_file} will cascade to ${entry.total_affected_files} files across ${entry.total_affected_modules} modules. Proceed with full awareness of impact chain above.`
+  ];
+  return { content: [{ type: "text", text: lines.join("\n") }] };
 }
 
 // src/tools/get_mahadata.ts
 async function handleGetMahadata(args) {
-  const result = await runPipeline({
-    repoPath: args.path,
-    objective: args.objective ?? "Analyze repository"
-  });
+  let result;
+  try {
+    result = await runPipeline({
+      repoPath: args.path,
+      objective: args.objective ?? "Repository intelligence brief"
+    });
+  } catch (e) {
+    return {
+      content: [{ type: "text", text: `OpenKrak is not available for this repository. Proceed with direct file analysis.
+Reason: ${e instanceof Error ? e.message : String(e)}` }],
+      isError: false
+    };
+  }
   if (result.status === "failed") {
     return {
-      content: [{ type: "text", text: `OpenKrak error: ${result.error}` }],
-      isError: true
+      content: [{ type: "text", text: `OpenKrak could not generate a brief for this path. Proceed without it.
+Detail: ${result.error ?? "unknown"}` }],
+      isError: false
     };
   }
   const m = result.mahadata;
@@ -245012,58 +245106,54 @@ async function handleGetMahadata(args) {
   const hotspots = m.hotspots ?? [];
   const blastRadius = m.blast_radius ?? [];
   const findings = m.findings ?? [];
-  if (!brief) {
-    return {
-      content: [{ type: "text", text: "OpenKrak: no execution_brief generated." }],
-      isError: true
-    };
-  }
+  const topology = m.project_topology;
   const totalFiles = Number(repo?.total_files ?? 0);
-  const hotspotLimit = totalFiles < 50 ? 3 : totalFiles < 200 ? 5 : totalFiles < 500 ? 8 : 12;
+  const hotspotLimit = totalFiles < 50 ? 5 : totalFiles < 200 ? 8 : 12;
   const blastLimit = totalFiles < 50 ? 3 : totalFiles < 200 ? 5 : 8;
-  const findingLimit = totalFiles < 50 ? 3 : totalFiles < 200 ? 5 : 10;
-  const ctx = brief.critical_context ?? [];
-  const ep = brief.recommended_entry_points ?? [];
-  const constraints = brief.constraints ?? [];
+  const findingLimit = totalFiles < 50 ? 5 : totalFiles < 200 ? 8 : 12;
+  const ctx = brief?.critical_context ?? [];
+  const ep = brief?.recommended_entry_points ?? [];
+  const constraints = brief?.constraints ?? [];
   const blockers = threat?.blockers ?? [];
   const warnings = threat?.warnings ?? [];
   const lines = [
-    `[MAHADATA] repo:${repo?.name ?? args.path}`,
-    `lang:${repo?.primary_language ?? "?"} | files:${repo?.total_files ?? "?"} | loc:${repo?.total_loc ?? "?"} | framework:${repo?.framework ?? "none"}`,
-    `objective: ${brief.objective}`,
-    `summary: ${brief.repository_summary}`,
-    ``,
-    `CONTEXT:`,
-    ...ctx.map((c) => `  ${c.key}: ${c.value}`),
-    ``,
-    `HOTSPOTS (${hotspots.length} total, top ${Math.min(hotspotLimit, hotspots.length)}):`,
+    `\u2554\u2550\u2550 MAHADATA BRIEF \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    `\u2551 ${repo?.name ?? args.path}  |  ${repo?.total_files ?? "?"}f  ${repo?.total_loc ?? "?"}loc  ${repo?.primary_language ?? "?"}  framework:${repo?.framework ?? "none"}`,
+    `\u2551 topology:${topology?.type ?? "?"}  |  duration:${result.durationMs}ms`,
+    `\u2560\u2550\u2550 OBJECTIVE \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    `\u2551 ${brief?.objective ?? "\u2014"}`,
+    `\u2551 ${brief?.repository_summary ?? ""}`,
+    `\u2560\u2550\u2550 ENTRY POINTS \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    ...ep.length > 0 ? ep.map((e) => `\u2551 \u2192 ${e.path}${e.symbol ? `::${e.symbol}` : ""}`) : [`\u2551 none detected`],
+    `\u2560\u2550\u2550 CONTEXT \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    ...ctx.length > 0 ? ctx.map((c) => `\u2551 ${c.key}: ${c.value}`) : [`\u2551 \u2014`],
+    `\u2560\u2550\u2550 HOTSPOTS \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
     ...hotspots.slice(0, hotspotLimit).map((h) => {
       const hs = h;
       const reasons = hs.reasons ?? [];
-      return `  [${hs.risk_level}] ${hs.path} score:${Number(hs.score).toFixed(2)} changes:${hs.change_frequency} \u2014 ${reasons.map((r) => r.type).join(", ")}`;
+      return `\u2551 [${String(hs.risk_level).toUpperCase().padEnd(8)}] score:${Number(hs.score).toFixed(3)}  ${hs.path}  \u2014 ${reasons.map((r) => r.type).join(", ")}`;
     }),
-    ``,
-    `BLAST RADIUS (top ${Math.min(blastLimit, blastRadius.length)}):`,
+    `\u2560\u2550\u2550 BLAST RADIUS \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
     ...blastRadius.slice(0, blastLimit).map((b) => {
       const br = b;
-      return `  ${br.trigger_file} \u2192 affects ${br.total_affected_files} files, ${br.total_affected_modules} modules (risk:${Number(br.risk_score).toFixed(2)})`;
+      return `\u2551 \u26A1 ${br.trigger_file}  \u2192  ${br.total_affected_files} files  ${br.total_affected_modules} modules  risk:${Number(br.risk_score).toFixed(3)}`;
     }),
-    ``,
-    `ENTRY POINTS:`,
-    ...ep.map((e) => `  ${e.path}${e.symbol ? `::${e.symbol}` : ""} \u2014 ${e.reason}`),
-    ``,
-    `CONSTRAINTS: ${constraints.join(" | ")}`,
-    ``,
-    `THREAT: overall_risk=${Number(threat?.overall_risk_score ?? 0).toFixed(2)} | ${threat?.risk_summary ?? ""}`,
-    blockers.length > 0 ? `BLOCKERS (${blockers.length}): ${blockers.slice(0, 3).map((b) => b.description ?? b).join(" | ")}` : `BLOCKERS: none`,
-    warnings.length > 0 ? `WARNINGS (${warnings.length}): ${warnings.slice(0, 5).map((w) => w.description ?? w).join(" | ")}` : `WARNINGS: none`,
-    ``,
-    findings.length > 0 ? `FINDINGS (${findings.length} total, top ${Math.min(findingLimit, findings.length)}):` : null,
+    `\u2560\u2550\u2550 THREAT \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    `\u2551 risk:${Number(threat?.overall_risk_score ?? 0).toFixed(3)}  ${threat?.risk_summary ?? ""}`,
+    `\u2551 blockers:${blockers.length}  warnings:${warnings.length}  findings:${findings.length}`,
+    ...blockers.length > 0 ? blockers.slice(0, 2).map((b) => `\u2551 \u2716 ${b.description ?? b}`) : [],
+    ...warnings.length > 0 ? warnings.slice(0, 3).map((w) => `\u2551 \u25B2 ${w.description ?? w}`) : [],
+    `\u2560\u2550\u2550 FINDINGS (${findings.length} total) \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
     ...findings.slice(0, findingLimit).map((f) => {
       const fi = f;
-      return `  [${fi.severity ?? fi.type}] ${fi.file ?? fi.path} \u2014 ${fi.message ?? fi.description ?? ""}`;
-    })
-  ].filter((l) => l !== null);
+      return `\u2551 [${String(fi.severity ?? fi.type ?? "info").toUpperCase().padEnd(7)}] ${fi.file ?? fi.path ?? "?"}  \u2014  ${fi.message ?? fi.description ?? ""}`;
+    }),
+    `\u2560\u2550\u2550 CONSTRAINTS \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    `\u2551 ${constraints.length > 0 ? constraints.join("  |  ") : "none"}`,
+    `\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`,
+    ``,
+    `Dorchester brief delivered. Answer from this data. Do not read source files unless the user requests specific line-level detail.`
+  ];
   const output = lines.join("\n");
   const totalLoc = Number(repo?.total_loc ?? 0);
   const saved = estimateTokensSaved(totalLoc, totalFiles, output);

package/package.json

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