@chappibunny/repolens 1.3.1 → 1.5.0

package/CHANGELOG.md

@@ -2,6 +2,44 @@
 
 All notable changes to RepoLens will be documented in this file.
 
+## 1.5.0
+
+### 🚀 New Features (Tier 3 — Differentiation)
+
+- **Document caching**: Hash-based caching skips redundant API calls for unchanged documents. Notion, Confluence, and GitHub Wiki publishers now receive only changed pages; Markdown always gets the full set. Cache persists in `.repolens/doc-hashes.json`.
+- **Structured AI output**: AI sections now request JSON-mode responses with schema validation. If JSON parsing or schema validation fails, a single re-prompt is attempted before falling back to plain-text AI, then deterministic generation. All 6 AI document types have JSON schemas and Markdown renderers.
+- **Multi-provider AI**: Added native adapters for Anthropic (Messages API) and Google Gemini alongside existing OpenAI-compatible support. Set `REPOLENS_AI_PROVIDER` to `anthropic`, `google`, or `openai_compatible` (default). Azure OpenAI uses the OpenAI-compatible adapter.
+- **Monorepo awareness**: Automatic detection of npm/yarn workspaces, pnpm workspaces, and Lerna configurations. Scan results include workspace metadata. System Overview renderer shows package inventory table. AI context includes monorepo structure.
+- **CODEOWNERS integration**: Parses `CODEOWNERS` / `.github/CODEOWNERS` / `docs/CODEOWNERS` files. Maps file ownership to modules via last-match-wins pattern matching. Module Catalog now displays an "Owners" column when CODEOWNERS is present. Ownership data is included in artifacts.
+
+### 📊 Test Coverage
+
+- **219 tests** passing across **17 test files** (up from 188/16).
+- New `tests/tier3.test.js` with 31 tests covering caching, monorepo detection, CODEOWNERS parsing, multi-provider AI config, and structured output rendering.
+
+## 1.4.0
+
+### 🐛 Bug Fixes (Tier 1 — Production)
+
+- **Confluence CDATA injection**: Code blocks containing `]]>` no longer break Confluence XML storage format. Applied standard CDATA escape pattern (`]]]]><![CDATA[>`).
+- **Discord branding**: Replaced 3 leftover "RABITAI" references with "RepoLens" in Discord webhook embeds (title, footer, error title).
+- **CLI branding**: Updated 2 remaining "RABITAI" banner strings to "RepoLens" in CLI output and help text.
+- **Markdown publisher missing mappings**: Added 9 missing document-type filename mappings (`executive_summary`, `business_domains`, `architecture_overview`, `data_flows`, `developer_onboarding`, `graphql_schema`, `type_graph`, `dependency_graph`, `architecture_drift`). All 15 document plan keys now map to output filenames.
+- **Relative link rewriting**: Notion and Confluence publishers now strip relative markdown links (`./path.md`, `../path.md`) that can't resolve in external platforms. Links are replaced with their display text.
+
+### 🔧 Improvements (Tier 2 — Robustness)
+
+- **Generic domain defaults**: Replaced 12 fintech-specific domain hints with 15 universally applicable domains (Authentication, Analytics, Content Management, Search, Notifications, Payments, API Layer, UI Components, Hooks, State, Utilities, Data Layer, Config, Testing, Background Jobs). Domain inference no longer maps "chart" to "Market Data" in non-finance apps.
+- **Real import-based system map**: `renderSystemMap()` now uses actual import edges from the dependency graph analyzer when available, instead of heuristic guessing. Diagram labels indicate whether relationships are from "Real import analysis" or "Heuristic inference".
+- **AI context size limiting**: Added `truncateContext()` function to AI prompts with a 12K character cap. Progressive pruning: routes/pages to 15, domains to 8, top modules to 10, then hard-truncate. Prevents token overflow on large codebases.
+- **Doctor env var validation**: `repolens doctor` now checks for publisher-specific environment variables (NOTION_TOKEN, CONFLUENCE_URL/EMAIL/API_TOKEN, GITHUB_TOKEN, REPOLENS_AI_API_KEY) and warns when required vars are missing for configured publishers.
+- **Truncation warnings**: Renderers now display notes when output is truncated — modules >100 in catalog, routes >200 in route map, files/routes >25 and modules >40 in architecture diff.
+- **Watch mode tests**: Added 3 new tests for `src/watch.js` covering no-directory handling, watcher setup, and node_modules filtering.
+
+### 📊 Test Coverage
+
+- **188 tests** passing across **16 test files** (up from 185/15).
+
 ## 1.3.1
 
 ### 📝 Documentation Overhaul

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Charl Van Zyl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -9,6 +9,7 @@
 ```
 
 [![npm version](https://img.shields.io/npm/v/@chappibunny/repolens)](https://www.npmjs.com/package/@chappibunny/repolens)
+[![VS Code Extension](https://img.shields.io/visual-studio-marketplace/v/CHAPIBUNNY.repolens-architecture?label=VS%20Code)](https://marketplace.visualstudio.com/items?itemName=CHAPIBUNNY.repolens-architecture)
 [![Tests](https://img.shields.io/badge/tests-185%20passing-brightgreen)](https://github.com/CHAPIBUNNY/repolens/actions)
 [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
@@ -16,7 +17,7 @@
 
 RepoLens scans your repository, generates living architecture documentation, and publishes it to Notion, Confluence, GitHub Wiki, or Markdown — automatically on every push. Engineers get technical docs. Stakeholders get readable system overviews. Nobody writes a word.
 
-> Stable as of v1.0 — [API guarantees](STABILITY.md) · [Security hardened](SECURITY.md) · v1.3.1
+> Stable as of v1.0 — [API guarantees](STABILITY.md) · [Security hardened](SECURITY.md) · v1.5.0
 
 ---
 
@@ -113,6 +114,28 @@ For alternative methods, see [INSTALLATION.md](INSTALLATION.md).
 
 ---
 
+## 🎨 VS Code Extension
+
+**View your architecture directly in VS Code** — browse modules, visualize dependencies, and explore your codebase structure without leaving the editor.
+
+**Install from Marketplace:**
+```
+ext install CHAPIBUNNY.repolens-architecture
+```
+
+[**→ Get it on Visual Studio Marketplace**](https://marketplace.visualstudio.com/items?itemName=CHAPIBUNNY.repolens-architecture)
+
+**Features:**
+- 🏗️ **Architecture Explorer** — Tree view of your system structure
+- 📊 **Dependency Visualizer** — Interactive dependency graphs
+- 📁 **Module Browser** — Navigate modules by domain and function
+- 🔍 **Command Palette** — Quick access to architecture insights
+- 📈 **System Metrics** — Real-time architecture health indicators
+
+The extension reads your `.repolens.yml` configuration and provides an interactive UI for exploring the documentation that RepoLens generates.
+
+---
+
 ## 🎓 Onboarding Guide
 
 Step-by-step setup for publishers, AI features, Notion, Confluence, GitHub Wiki, Discord, and CI/CD automation.
@@ -238,9 +261,11 @@ When you open a pull request, RepoLens posts:
 
 v1.0+ features complete — CLI, config schema, and plugin interface are frozen.
 
+**Completed:**
+- [x] VS Code extension ([available on Marketplace](https://marketplace.visualstudio.com/items?itemName=CHAPIBUNNY.repolens-architecture))
+
 **Next:**
 - [ ] Obsidian publisher
-- [ ] VS Code extension
 - [ ] GitHub App
 
 See [ROADMAP.md](ROADMAP.md) for detailed planning.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chappibunny/repolens",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "description": "AI-assisted documentation intelligence system for technical and non-technical audiences",
   "license": "MIT",
   "type": "module",

package/src/ai/generate-sections.js

@@ -11,129 +11,109 @@ import {
   createDeveloperOnboardingPrompt,
   createModuleSummaryPrompt,
   createRouteSummaryPrompt,
-  createAPIDocumentationPrompt
+  createAPIDocumentationPrompt,
+  AI_SCHEMAS,
+  renderStructuredToMarkdown,
 } from "./prompts.js";
 import { info, warn } from "../utils/logger.js";
 
-export async function generateExecutiveSummary(context) {
-  if (!isAIEnabled()) {
-    return getFallbackExecutiveSummary(context);
+/**
+ * Try structured JSON mode first, fall back to plain-text AI, then deterministic.
+ */
+async function generateWithStructuredFallback(key, promptText, maxTokens, fallbackFn) {
+  if (!isAIEnabled()) return fallbackFn();
+
+  const schema = AI_SCHEMAS[key];
+
+  // Try structured JSON mode
+  if (schema) {
+    info(`Generating ${key} with structured AI...`);
+    const jsonPrompt = promptText + `\n\nRespond ONLY with a JSON object matching this schema: ${JSON.stringify({ required: schema.required })}. No markdown, no explanation — just the JSON object.`;
+
+    const result = await generateText({
+      system: SYSTEM_PROMPT,
+      user: jsonPrompt,
+      maxTokens,
+      jsonMode: true,
+      jsonSchema: schema,
+    });
+
+    if (result.success && result.parsed) {
+      const md = renderStructuredToMarkdown(key, result.parsed);
+      if (md) return md;
+    }
+    // If structured mode failed, fall through to plain-text
+    warn(`Structured AI failed for ${key}, trying plain-text mode...`);
   }
-  
-  info("Generating executive summary with AI...");
-  
+
+  // Plain-text AI fallback
+  info(`Generating ${key} with AI...`);
   const result = await generateText({
     system: SYSTEM_PROMPT,
-    user: createExecutiveSummaryPrompt(context),
-    maxTokens: 1500
+    user: promptText,
+    maxTokens,
   });
-  
+
   if (!result.success) {
     warn("AI generation failed, using fallback");
-    return getFallbackExecutiveSummary(context);
+    return fallbackFn();
   }
-  
+
   return result.text;
 }
 
+export async function generateExecutiveSummary(context) {
+  return generateWithStructuredFallback(
+    "executive_summary",
+    createExecutiveSummaryPrompt(context),
+    1500,
+    () => getFallbackExecutiveSummary(context),
+  );
+}
+
 export async function generateSystemOverview(context) {
-  if (!isAIEnabled()) {
-    return getFallbackSystemOverview(context);
-  }
-  
-  info("Generating system overview with AI...");
-  
-  const result = await generateText({
-    system: SYSTEM_PROMPT,
-    user: createSystemOverviewPrompt(context),
-    maxTokens: 1200
-  });
-  
-  if (!result.success) {
-    return getFallbackSystemOverview(context);
-  }
-  
-  return result.text;
+  return generateWithStructuredFallback(
+    "system_overview",
+    createSystemOverviewPrompt(context),
+    1200,
+    () => getFallbackSystemOverview(context),
+  );
 }
 
 export async function generateBusinessDomains(context) {
-  if (!isAIEnabled()) {
-    return getFallbackBusinessDomains(context);
-  }
-  
-  info("Generating business domains with AI...");
-  
-  const result = await generateText({
-    system: SYSTEM_PROMPT,
-    user: createBusinessDomainsPrompt(context),
-    maxTokens: 2000
-  });
-  
-  if (!result.success) {
-    return getFallbackBusinessDomains(context);
-  }
-  
-  return result.text;
+  return generateWithStructuredFallback(
+    "business_domains",
+    createBusinessDomainsPrompt(context),
+    2000,
+    () => getFallbackBusinessDomains(context),
+  );
 }
 
 export async function generateArchitectureOverview(context) {
-  if (!isAIEnabled()) {
-    return getFallbackArchitectureOverview(context);
-  }
-  
-  info("Generating architecture overview with AI...");
-  
-  const result = await generateText({
-    system: SYSTEM_PROMPT,
-    user: createArchitectureOverviewPrompt(context),
-    maxTokens: 1800
-  });
-  
-  if (!result.success) {
-    return getFallbackArchitectureOverview(context);
-  }
-  
-  return result.text;
+  return generateWithStructuredFallback(
+    "architecture_overview",
+    createArchitectureOverviewPrompt(context),
+    1800,
+    () => getFallbackArchitectureOverview(context),
+  );
 }
 
 export async function generateDataFlows(flows, context) {
-  if (!isAIEnabled()) {
-    return getFallbackDataFlows(flows);
-  }
-  
-  info("Generating data flows with AI...");
-  
-  const result = await generateText({
-    system: SYSTEM_PROMPT,
-    user: createDataFlowsPrompt(flows, context),
-    maxTokens: 1800
-  });
-  
-  if (!result.success) {
-    return getFallbackDataFlows(flows);
-  }
-  
-  return result.text;
+  return generateWithStructuredFallback(
+    "data_flows",
+    createDataFlowsPrompt(flows, context),
+    1800,
+    () => getFallbackDataFlows(flows),
+  );
 }
 
 export async function generateDeveloperOnboarding(context) {
-  if (!isAIEnabled()) {
-    return getFallbackDeveloperOnboarding(context);
-  }
-  
-  info("Generating developer onboarding with AI...");
-  
-  const result = await generateText({
-    system: SYSTEM_PROMPT,
-    user: createDeveloperOnboardingPrompt(context),
-    maxTokens: 2200
-  });
-  
-  if (!result.success) {
-    return getFallbackDeveloperOnboarding(context);
-  }
-  
-  return result.text;
+  return generateWithStructuredFallback(
+    "developer_onboarding",
+    createDeveloperOnboardingPrompt(context),
+    2200,
+    () => getFallbackDeveloperOnboarding(context),
+  );
 }
 
 // Fallback generators (deterministic, no AI)

package/src/ai/prompts.js

@@ -1,5 +1,48 @@
 // Strict prompt templates for AI-generated documentation sections
 
+const MAX_CONTEXT_CHARS = 12000; // ~3000 tokens, safe for all models
+
+/**
+ * Truncate a context object to fit within token limits.
+ * Prunes large arrays (routes, modules, domains) to keep context compact.
+ */
+function truncateContext(context) {
+  let json = JSON.stringify(context, null, 2);
+  if (json.length <= MAX_CONTEXT_CHARS) return json;
+
+  // Progressively shrink: reduce array sizes
+  const trimmed = { ...context };
+
+  // Trim routes
+  if (trimmed.routes) {
+    if (trimmed.routes.pages && trimmed.routes.pages.length > 15) {
+      trimmed.routes = { ...trimmed.routes, pages: trimmed.routes.pages.slice(0, 15) };
+    }
+    if (trimmed.routes.apis && trimmed.routes.apis.length > 15) {
+      trimmed.routes = { ...trimmed.routes, apis: trimmed.routes.apis.slice(0, 15) };
+    }
+  }
+
+  // Trim domains
+  if (Array.isArray(trimmed.domains) && trimmed.domains.length > 8) {
+    trimmed.domains = trimmed.domains.slice(0, 8);
+  }
+
+  // Trim top modules
+  if (Array.isArray(trimmed.topModules) && trimmed.topModules.length > 10) {
+    trimmed.topModules = trimmed.topModules.slice(0, 10);
+  }
+
+  json = JSON.stringify(trimmed, null, 2);
+
+  // Final hard truncation if still over limit
+  if (json.length > MAX_CONTEXT_CHARS) {
+    json = json.slice(0, MAX_CONTEXT_CHARS) + "\n... (context truncated for token limit)";
+  }
+
+  return json;
+}
+
 export const SYSTEM_PROMPT = `You are a senior software architect and technical writer.
 Your job is to turn structured repository analysis into clear documentation.
 
@@ -20,7 +63,7 @@ export function createExecutiveSummaryPrompt(context) {
   return `Write an executive summary for a mixed audience of technical and non-technical readers.
 
 Use this context:
-${JSON.stringify(context, null, 2)}
+${truncateContext(context)}
 
 Requirements:
 - Explain what the system appears to do based on the modules and routes.
@@ -53,7 +96,7 @@ export function createSystemOverviewPrompt(context) {
   return `Write a system overview for a mixed audience.
 
 Use this context:
-${JSON.stringify(context, null, 2)}
+${truncateContext(context)}
 
 Requirements:
 - Provide a concise, high-level orientation to the codebase.
@@ -81,7 +124,7 @@ export function createBusinessDomainsPrompt(context) {
   return `Write business domain documentation for a mixed audience, especially non-technical readers.
 
 Use this context:
-${JSON.stringify(context, null, 2)}
+${truncateContext(context)}
 
 Requirements:
 - Translate codebase structure into business language.
@@ -113,7 +156,7 @@ export function createArchitectureOverviewPrompt(context) {
   return `Write an architecture overview for engineers, architects, and technical PMs.
 
 Use this context:
-${JSON.stringify(context, null, 2)}
+${truncateContext(context)}
 
 Requirements:
 - Explain the layered architecture based on observable patterns.
@@ -147,10 +190,10 @@ export function createDataFlowsPrompt(flows, context) {
   return `Write data flow documentation for a mixed audience.
 
 Use this flow information:
-${JSON.stringify(flows, null, 2)}
+${truncateContext(flows)}
 
 And this context:
-${JSON.stringify(context, null, 2)}
+${truncateContext(context)}
 
 Requirements:
 - Explain major information flows in plain language.
@@ -179,7 +222,7 @@ export function createDeveloperOnboardingPrompt(context) {
   return `Write developer onboarding documentation to help new engineers get productive quickly.
 
 Use this context:
-${JSON.stringify(context, null, 2)}
+${truncateContext(context)}
 
 Requirements:
 - Guide new developers through the codebase structure.
@@ -218,7 +261,7 @@ Type: ${module.type}
 Domain: ${module.domain}
 
 Additional context:
-${JSON.stringify(context, null, 2)}
+${truncateContext(context)}
 
 Requirements:
 - Explain the module's likely purpose.
@@ -252,7 +295,7 @@ File: ${route.file}
 Type: ${route.type}
 
 Additional context:
-${JSON.stringify(context, null, 2)}
+${truncateContext(context)}
 
 Requirements:
 - Explain the user purpose of this route.
@@ -283,7 +326,7 @@ API: ${api.methods.join(", ")} ${api.path}
 File: ${api.file}
 
 Additional context:
-${JSON.stringify(context, null, 2)}
+${truncateContext(context)}
 
 Requirements:
 - Explain the purpose in plain language and technical language.
@@ -310,3 +353,125 @@ Dependencies:
 Risks:
 [if applicable]`;
 }
+
+// --- JSON schemas for structured AI output ---
+
+export const AI_SCHEMAS = {
+  executive_summary: {
+    required: ["whatItDoes", "whoItServes", "coreCapabilities", "mainAreas", "risks"],
+    description: "Executive summary for mixed audience",
+  },
+  system_overview: {
+    required: ["snapshot", "layers", "domains", "patterns", "observations"],
+    description: "High-level system overview",
+  },
+  business_domains: {
+    required: ["domains"],
+    description: "Business domain breakdown",
+  },
+  architecture_overview: {
+    required: ["style", "layers", "strengths", "weaknesses"],
+    description: "Architecture overview for engineers",
+  },
+  data_flows: {
+    required: ["flows"],
+    description: "Data flow documentation",
+  },
+  developer_onboarding: {
+    required: ["startHere", "mainFolders", "coreFlows", "complexityHotspots"],
+    description: "Developer onboarding guide",
+  },
+};
+
+/**
+ * Render a structured JSON response into Markdown for the given document type.
+ */
+export function renderStructuredToMarkdown(key, parsed) {
+  switch (key) {
+    case "executive_summary":
+      return renderExecutiveSummaryJSON(parsed);
+    case "system_overview":
+      return renderSystemOverviewJSON(parsed);
+    case "business_domains":
+      return renderBusinessDomainsJSON(parsed);
+    case "architecture_overview":
+      return renderArchitectureOverviewJSON(parsed);
+    case "data_flows":
+      return renderDataFlowsJSON(parsed);
+    case "developer_onboarding":
+      return renderDeveloperOnboardingJSON(parsed);
+    default:
+      return null;
+  }
+}
+
+function renderExecutiveSummaryJSON(d) {
+  let md = `# Executive Summary\n\n`;
+  md += `## What This System Does\n\n${d.whatItDoes}\n\n`;
+  md += `## Who It Serves\n\n${d.whoItServes}\n\n`;
+  md += `## Core Capabilities\n\n`;
+  if (Array.isArray(d.coreCapabilities)) {
+    md += d.coreCapabilities.map(c => `- ${c}`).join("\n") + "\n\n";
+  } else {
+    md += `${d.coreCapabilities}\n\n`;
+  }
+  md += `## Main System Areas\n\n${Array.isArray(d.mainAreas) ? d.mainAreas.map(a => `- **${a.name || a}**${a.description ? `: ${a.description}` : ""}`).join("\n") : d.mainAreas}\n\n`;
+  if (d.dependencies) md += `## Key Dependencies\n\n${Array.isArray(d.dependencies) ? d.dependencies.map(dep => `- ${dep}`).join("\n") : d.dependencies}\n\n`;
+  md += `## Operational and Architectural Risks\n\n${Array.isArray(d.risks) ? d.risks.map(r => `- ${r}`).join("\n") : d.risks}\n\n`;
+  if (d.focusAreas) md += `## Recommended Focus Areas\n\n${Array.isArray(d.focusAreas) ? d.focusAreas.map(f => `- ${f}`).join("\n") : d.focusAreas}\n`;
+  return md;
+}
+
+function renderSystemOverviewJSON(d) {
+  let md = `# System Overview\n\n`;
+  md += `## Repository Snapshot\n\n${d.snapshot}\n\n`;
+  md += `## Main Architectural Layers\n\n${Array.isArray(d.layers) ? d.layers.map(l => `- **${l.name || l}**${l.description ? `: ${l.description}` : ""}`).join("\n") : d.layers}\n\n`;
+  md += `## Dominant Domains\n\n${Array.isArray(d.domains) ? d.domains.map(dom => `- ${dom}`).join("\n") : d.domains}\n\n`;
+  md += `## Main Technology Patterns\n\n${Array.isArray(d.patterns) ? d.patterns.map(p => `- ${p}`).join("\n") : d.patterns}\n\n`;
+  md += `## Key Observations\n\n${Array.isArray(d.observations) ? d.observations.map(o => `- ${o}`).join("\n") : d.observations}\n`;
+  return md;
+}
+
+function renderBusinessDomainsJSON(d) {
+  let md = `# Business Domains\n\n`;
+  if (!Array.isArray(d.domains)) return md + d.domains;
+  for (const dom of d.domains) {
+    md += `## ${dom.name}\n\n${dom.description || ""}\n\n`;
+    if (dom.modules) md += `**Key modules:** ${Array.isArray(dom.modules) ? dom.modules.join(", ") : dom.modules}\n\n`;
+    if (dom.userFunctionality) md += `**User-visible functionality:** ${dom.userFunctionality}\n\n`;
+    if (dom.dependencies) md += `**Dependencies:** ${Array.isArray(dom.dependencies) ? dom.dependencies.join(", ") : dom.dependencies}\n\n`;
+  }
+  return md;
+}
+
+function renderArchitectureOverviewJSON(d) {
+  let md = `# Architecture Overview\n\n`;
+  md += `## Architecture Style\n\n${d.style}\n\n`;
+  md += `## Layers\n\n${Array.isArray(d.layers) ? d.layers.map(l => `### ${l.name || l}\n\n${l.description || ""}`).join("\n\n") : d.layers}\n\n`;
+  md += `## Architectural Strengths\n\n${Array.isArray(d.strengths) ? d.strengths.map(s => `- ${s}`).join("\n") : d.strengths}\n\n`;
+  md += `## Architectural Weaknesses\n\n${Array.isArray(d.weaknesses) ? d.weaknesses.map(w => `- ${w}`).join("\n") : d.weaknesses}\n`;
+  return md;
+}
+
+function renderDataFlowsJSON(d) {
+  let md = `# Data Flows\n\n`;
+  if (!Array.isArray(d.flows)) return md + d.flows;
+  for (const flow of d.flows) {
+    md += `## ${flow.name}\n\n${flow.description || ""}\n\n`;
+    if (flow.steps) md += `**Steps:**\n${Array.isArray(flow.steps) ? flow.steps.map((s, i) => `${i + 1}. ${s}`).join("\n") : flow.steps}\n\n`;
+    if (flow.modules) md += `**Involved modules:** ${Array.isArray(flow.modules) ? flow.modules.join(", ") : flow.modules}\n\n`;
+    if (flow.criticalDependencies) md += `**Critical dependencies:** ${flow.criticalDependencies}\n\n`;
+  }
+  return md;
+}
+
+function renderDeveloperOnboardingJSON(d) {
+  let md = `# Developer Onboarding\n\n`;
+  md += `## Start Here\n\n${d.startHere}\n\n`;
+  md += `## Main Folders\n\n${Array.isArray(d.mainFolders) ? d.mainFolders.map(f => `- **${f.name || f}**${f.description ? `: ${f.description}` : ""}`).join("\n") : d.mainFolders}\n\n`;
+  md += `## Core Product Flows\n\n${Array.isArray(d.coreFlows) ? d.coreFlows.map(f => `- ${f}`).join("\n") : d.coreFlows}\n\n`;
+  if (d.importantRoutes) md += `## Important Routes\n\n${Array.isArray(d.importantRoutes) ? d.importantRoutes.map(r => `- ${r}`).join("\n") : d.importantRoutes}\n\n`;
+  if (d.sharedLibraries) md += `## Important Shared Libraries\n\n${Array.isArray(d.sharedLibraries) ? d.sharedLibraries.map(l => `- ${l}`).join("\n") : d.sharedLibraries}\n\n`;
+  md += `## Known Complexity Hotspots\n\n${Array.isArray(d.complexityHotspots) ? d.complexityHotspots.map(h => `- ${h}`).join("\n") : d.complexityHotspots}\n`;
+  return md;
+}