@chappibunny/repolens 1.9.1 → 1.9.3

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 All notable changes to RepoLens will be documented in this file.
 
+## 1.9.3
+
+### ✨ Premium Deterministic Documentation
+
+**Major overhaul of all 6 AI-fallback document generators.** Deterministic mode now produces documentation quality comparable to AI-enhanced mode:
+
+- **Executive Summary**: Complete rewrite with health scoring (0-100 scale), monorepo structure detection, module composition breakdown by layer, codebase health tables with status indicators, key data flow summaries with criticality markers, and strategic observations based on actual patterns.
+
+- **System Overview**: Enhanced with route pattern descriptions, dependency graph metrics, hub module analysis, and detailed route summaries explaining what each pattern (API, page, SSR) means.
+
+- **Business Domains**: Rich domain capability descriptions, cross-domain dependency analysis with full module paths, domain health summary table, and business impact assessment per domain.
+
+- **Architecture Overview**: Pattern explanation with benefits, system layers table with architectural insights, dependency health metrics, strengths and concerns sections, and hub module highlighting.
+
+- **Data Flows**: Flow diagrams with step-by-step breakdowns explaining what each step does, shared libraries context, import network statistics, and actionable recommendations.
+
+- **Developer Onboarding**: Getting Started checklist, codebase-at-a-glance statistics, key routes with explanations, framework and language learning tips, common pitfalls section, and module importance ratings.
+
+**18+ new helper functions** added for intelligent content generation:
+`inferDomainCapability()`, `getLayerResponsibility()`, `calculateHealthScore()`, `formatFileScale()`, `describeRoutePattern()`, `inferFrameworkPurpose()`, `explainPattern()`, `getBenefitsForPattern()`, `getLayerInsight()`, `getFrameworkArchitecturalImplication()`, `getLanguageImplication()`, `inferPageDescription()`, `inferAPIEndpointPurpose()`, `inferPackageDescription()`, `inferStepPurpose()`, `shouldStartHere()`, `getFrameworkLearningTip()`, `getLanguageLearningTip()`, `getModuleImportance()`
+
+### 🔧 Why This Matters
+
+Users without AI API keys now get production-quality documentation instead of sparse placeholders. The deterministic output includes:
+- Health scores and assessments
+- Business capability descriptions
+- Architectural pattern explanations
+- Actionable recommendations
+- Framework-specific learning tips
+- Rich tables with insights
+
+### 🧪 Tests
+
+- **380 tests passing** across 22 test files
+- All deterministic enrichment tests updated and passing
+
+## 1.9.2
+
+### 🐛 Bug Fixes
+
+- **Notion duplicate pages fixed**: Publishing no longer creates duplicate pages on every release. Added Notion Search API as primary lookup method for existing pages (more reliable than child block iteration), with case-insensitive title matching fallback.
+- **Confluence empty pages fixed**: Executive Summary, System Overview, Business Domains and other AI-generated docs now publish correctly to Confluence. Added defensive null/empty content checks with helpful fallback messages instead of blank pages.
+- **Document generation validation**: All document generators now validate output and provide error placeholders if generation fails, ensuring publishers always have content to work with.
+- **Notion publisher robustness**: Now iterates over all rendered pages (not just config-defined ones), with content length logging for debugging.
+
+### 🧪 Tests
+
+- Added test for `markdownToConfluenceStorage` handling of empty/null content
+- **380 tests passing** across 22 test files
+
 ## 1.8.2
 
 ### 🐛 Bug Fixes

package/README.md

@@ -10,14 +10,14 @@
 
 [![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-379%20passing-brightgreen)](https://github.com/CHAPIBUNNY/repolens/actions)
+[![Tests](https://img.shields.io/badge/tests-380%20passing-brightgreen)](https://github.com/CHAPIBUNNY/repolens/actions)
 [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 **Your architecture docs are already outdated.** RepoLens fixes that.
 
 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.9.0
+> Stable as of v1.0 — [API guarantees](docs/STABILITY.md) · [Security hardened](SECURITY.md) · v1.9.2
 
 ---
 
@@ -77,7 +77,7 @@ npx @chappibunny/repolens publish
 **Done!** Your docs are now live in Notion, Confluence, and/or `.repolens/` directory.
 
 **🔄 Upgrading from v0.3.0 or earlier?**
-Run `npx @chappibunny/repolens migrate` to automatically update your workflow files. See [MIGRATION.md](MIGRATION.md) for details.
+Run `npx @chappibunny/repolens migrate` to automatically update your workflow files. See [MIGRATION.md](docs/MIGRATION.md) for details.
 
 ---
 
@@ -118,7 +118,7 @@ npm install @chappibunny/repolens
 
 Or try instantly without installing: `npx @chappibunny/repolens demo`
 
-For alternative methods, see [INSTALLATION.md](INSTALLATION.md).
+For alternative methods, see [INSTALLATION.md](docs/INSTALLATION.md).
 
 ---
 
@@ -148,7 +148,7 @@ The extension reads your `.repolens.yml` configuration and provides an interacti
 
 Step-by-step setup for publishers, AI features, Notion, Confluence, GitHub Wiki, Discord, and CI/CD automation.
 
-**[→ Full Onboarding Guide](ONBOARDING.md)**
+**[→ Full Onboarding Guide](docs/ONBOARDING.md)**
 
 ---
 
@@ -162,7 +162,7 @@ Step-by-step setup for publishers, AI features, Notion, Confluence, GitHub Wiki,
 | `npx @chappibunny/repolens demo` | Quick local preview — no API keys needed |
 | `npx @chappibunny/repolens doctor` | Validate your setup |
 | `npx @chappibunny/repolens watch` | Auto-regenerate docs on file changes |
-| `npx @chappibunny/repolens migrate` | Upgrade from v0.3.0 workflows ([details](MIGRATION.md)) |
+| `npx @chappibunny/repolens migrate` | Upgrade from v0.3.0 workflows ([details](docs/MIGRATION.md)) |
 | `npx @chappibunny/repolens uninstall` | Remove all RepoLens files (config, docs, workflow) |
 | `npx @chappibunny/repolens uninstall --force` | Remove without confirmation prompt |
 | `npx @chappibunny/repolens feedback` | Send feedback to the team |
@@ -236,7 +236,7 @@ When you open a pull request, RepoLens posts:
 
 ## 🔒 Privacy & Security
 
-- **Telemetry is opt-in and disabled by default** — no code, secrets, or personal data leaves your machine. See [TELEMETRY.md](TELEMETRY.md).
+- **Telemetry is opt-in and disabled by default** — no code, secrets, or personal data leaves your machine. See [TELEMETRY.md](docs/TELEMETRY.md).
 - **Defense-in-depth security** — input validation, secret detection (15+ patterns), rate limiting, injection prevention, supply chain hardening. See [SECURITY.md](SECURITY.md).
 - **Report vulnerabilities** to trades@rabitaitrades.com (not public issues). Response within 48 hours.
 
@@ -246,16 +246,16 @@ When you open a pull request, RepoLens posts:
 
 | Guide | Description |
 |---|---|
-| [Onboarding Guide](ONBOARDING.md) | Step-by-step setup: publishers, AI, Notion, Confluence, Discord |
-| [Configuration](CONFIGURATION.md) | Complete `.repolens.yml` schema and examples |
-| [Environment Variables](ENVIRONMENT.md) | All env vars by publisher and feature |
-| [Architecture](ARCHITECTURE.md) | Pipeline diagram, project structure |
-| [Development](DEVELOPMENT.md) | Setup, tests (379 across 22 files), release process |
+| [Onboarding Guide](docs/ONBOARDING.md) | Step-by-step setup: publishers, AI, Notion, Confluence, Discord |
+| [Configuration](docs/CONFIGURATION.md) | Complete `.repolens.yml` schema and examples |
+| [Environment Variables](docs/ENVIRONMENT.md) | All env vars by publisher and feature |
+| [Architecture](docs/ARCHITECTURE.md) | Pipeline diagram, project structure |
+| [Development](docs/DEVELOPMENT.md) | Setup, tests (380 across 22 files), release process |
 | [Security](SECURITY.md) | Threat model, secret detection, validation layers |
-| [Telemetry](TELEMETRY.md) | Opt-in privacy-first usage analytics |
-| [Troubleshooting](TROUBLESHOOTING.md) | Common issues and fixes |
-| [Migration](MIGRATION.md) | Upgrading from v0.3.0 or earlier |
-| [Stability](STABILITY.md) | API contract and semver guarantees |
+| [Telemetry](docs/TELEMETRY.md) | Opt-in privacy-first usage analytics |
+| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common issues and fixes |
+| [Migration](docs/MIGRATION.md) | Upgrading from v0.3.0 or earlier |
+| [Stability](docs/STABILITY.md) | API contract and semver guarantees |
 
 ---
 
@@ -281,7 +281,7 @@ v1.0+ features complete — CLI, config schema, and plugin interface are frozen.
 - [ ] Obsidian publisher
 - [ ] GitHub App
 
-See [ROADMAP.md](ROADMAP.md) for detailed planning.
+See [ROADMAP.md](docs/ROADMAP.md) for detailed planning.
 
 ---
 
@@ -293,7 +293,7 @@ MIT
 
 ## 💬 Support & Contact
 
-- **Troubleshooting**: [TROUBLESHOOTING.md](TROUBLESHOOTING.md) — installation, config, publishing, AI, and CI/CD issues
+- **Troubleshooting**: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) — installation, config, publishing, AI, and CI/CD issues
 - **Diagnostics**: Run `npx @chappibunny/repolens doctor` to validate your setup
 - **Issues**: [GitHub Issues](https://github.com/CHAPIBUNNY/repolens/issues)
 - **Discussions**: [GitHub Discussions](https://github.com/CHAPIBUNNY/repolens/discussions)

package/docs/AI.md

@@ -0,0 +1,329 @@
+# AI-Enhanced Documentation
+
+As of v0.4.0, RepoLens supports AI-powered documentation generation that creates clear, audience-specific documentation for both technical and non-technical readers. This feature is available in the current version (v1.4.0).
+
+## Overview
+
+RepoLens uses a hybrid approach:
+
+1. **Deterministic extraction** - Scans your repository structure, files, routes, APIs, and technologies
+2. **Structured context** - Builds intermediate JSON artifacts with facts about your codebase
+3. **AI synthesis** - Uses LLMs to generate human-readable explanations and insights
+4. **Audience-aware output** - Creates documents for engineers, PMs, stakeholders, and executives
+
+This approach prevents hallucination while providing rich, readable documentation.
+
+## Document Structure
+
+RepoLens generates up to 15 documents:
+
+### For Non-Technical Audiences
+
+- **00-executive-summary.md** - What the system does, who it serves, key risks
+- **02-business-domains.md** - Codebase structure in business language
+
+### For Mixed Audiences
+
+- **01-system-overview.md** - High-level technical snapshot
+- **05-route-map.md** - User-facing pages and capabilities
+- **07-data-flows.md** - How information moves through the system
+- **08-change-impact.md** - PR/diff analysis in plain language
+- **09-system-map.md** - Visual diagram with explanation
+
+### For Technical Audiences
+
+- **03-architecture-overview.md** - Layered architecture analysis
+- **04-module-catalog.md** - Complete code module inventory
+- **06-api-surface.md** - Backend API documentation
+- **10-developer-onboarding.md** - Quick start for new engineers
+
+### Extended Analysis (New in v0.8.0)
+
+- **11-graphql-schema.md** - GraphQL types, queries, mutations, and resolvers
+- **12-type-graph.md** - TypeScript interfaces, classes, and type relationships
+- **13-dependency-graph.md** - Import analysis with circular dependency detection
+- **14-architecture-drift.md** - Structural changes tracked against baseline
+
+## Enabling AI Features
+
+### 1. Set Environment Variables
+
+Create a `.env` file (or set in GitHub Actions secrets):
+
+```bash
+# Enable AI features
+REPOLENS_AI_ENABLED=true
+
+# Your OpenAI API key (or compatible provider)
+REPOLENS_AI_API_KEY=sk-xxx
+
+# API endpoint (optional, defaults to OpenAI)
+REPOLENS_AI_BASE_URL=https://api.openai.com/v1
+
+# Model to use
+REPOLENS_AI_MODEL=gpt-5-mini
+```
+
+### 2. Configure in .repolens.yml
+
+```yaml
+features:
+  executive_summary: true
+  business_domains: true
+  architecture_overview: true
+  data_flows: true
+  developer_onboarding: true
+  ai_enrichment: true
+
+ai:
+  enabled: true
+  mode: "hybrid" # deterministic facts + AI explanations
+  max_tokens: 2500
+```
+
+### 3. Run Publish
+
+```bash
+npx @chappibunny/repolens publish
+```
+
+## AI Providers
+
+RepoLens supports multiple AI providers natively. Set `REPOLENS_AI_PROVIDER` to select one.
+
+### GitHub Models (Free — Recommended for GitHub Actions)
+
+Every GitHub repository gets free access to AI models via [GitHub Models](https://github.com/marketplace/models). In GitHub Actions, the `GITHUB_TOKEN` is already available — no API key signup needed.
+
+```bash
+REPOLENS_AI_ENABLED=true
+REPOLENS_AI_PROVIDER=github
+# Uses GITHUB_TOKEN automatically — no REPOLENS_AI_API_KEY needed
+# Default model: gpt-4o-mini (free tier)
+```
+
+**GitHub Actions workflow:**
+```yaml
+env:
+  REPOLENS_AI_ENABLED: true
+  REPOLENS_AI_PROVIDER: github
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+
+> **Free tier limits:** ~150 requests/day for gpt-4o-mini. RepoLens makes ~15 AI calls per run, so this is more than sufficient.
+
+### OpenAI
+
+```bash
+REPOLENS_AI_PROVIDER=openai_compatible
+REPOLENS_AI_BASE_URL=https://api.openai.com/v1
+REPOLENS_AI_API_KEY=sk-xxx
+REPOLENS_AI_MODEL=gpt-5-mini
+```
+
+### Anthropic
+
+```bash
+REPOLENS_AI_PROVIDER=anthropic
+REPOLENS_AI_API_KEY=sk-ant-xxx
+REPOLENS_AI_MODEL=claude-sonnet-4-20250514
+```
+
+### Google Gemini
+
+```bash
+REPOLENS_AI_PROVIDER=google
+REPOLENS_AI_API_KEY=xxx
+REPOLENS_AI_MODEL=gemini-pro
+```
+
+### Azure OpenAI
+
+```bash
+REPOLENS_AI_PROVIDER=openai_compatible
+REPOLENS_AI_BASE_URL=https://your-resource.openai.azure.com/openai/deployments/your-deployment
+REPOLENS_AI_API_KEY=xxx
+REPOLENS_AI_MODEL=gpt-5-mini
+```
+
+### Local Models (Ollama, LM Studio, etc.)
+
+```bash
+REPOLENS_AI_PROVIDER=openai_compatible
+REPOLENS_AI_BASE_URL=http://localhost:11434/v1
+REPOLENS_AI_API_KEY=dummy # not used for local
+REPOLENS_AI_MODEL=llama3
+```
+
+## Configuration Options
+
+### AI Section
+
+```yaml
+ai:
+  enabled: true # Master switch
+  
+  mode: "hybrid" # Options: hybrid, full, off
+    # hybrid: Deterministic facts + AI explanations
+    # full: More AI-generated content
+    # off: Deterministic only
+  
+  audience_default: "mixed" # Default target audience
+    # mixed: Readable by technical and non-technical
+    # technical: Developer-focused
+    # non-technical: Leadership/stakeholder-focused
+  
+  max_tokens: 2500 # Maximum response length
+```
+
+### Business Domains
+
+Help AI understand your codebase by defining business domains:
+
+```yaml
+domains:
+  authentication:
+    match: ["auth", "login", "session"]
+    description: "User authentication flows"
+  
+  payments:
+    match: ["payment", "stripe", "checkout"]
+    description: "Payment processing"
+  
+  market_data:
+    match: ["stock", "chart", "price"]
+    description: "Financial market data"
+```
+
+### Documentation Output
+
+```yaml
+documentation:
+  output_dir: ".repolens" # Where to write files
+  include_artifacts: true # Save JSON for debugging
+  file_prefix: true # Add 00-, 01- numbers
+  
+  sections: # Which documents to generate
+    - executive_summary
+    - system_overview
+    - business_domains
+    - architecture_overview
+    - module_catalog
+    - route_map
+    - api_surface
+    - data_flows
+    - change_impact
+    - system_map
+    - developer_onboarding
+```
+
+## Cost Considerations
+
+AI generation adds cost. Typical pricing (GPT-5-mini):
+
+- Small repo (~50 modules): $0.10 - $0.30 per run
+- Medium repo (~200 modules): $0.30 - $0.80 per run
+- Large repo (~500 modules): $0.80 - $2.00 per run
+
+Tips to reduce cost:
+
+1. Use `gpt-5-nano` for faster, cheaper results
+2. Disable documents you don't need in `documentation.sections`
+3. Run on main branch only (configure `notion.branches`)
+4. Use local models for free (quality varies)
+
+## Fallback Behavior
+
+If AI is disabled or fails, RepoLens generates deterministic documentation automatically. You'll see a note: "AI-enhanced documentation is disabled."
+
+## Zero Hallucination Policy
+
+RepoLens prompts are designed to prevent AI from inventing facts:
+
+- AI receives only structured JSON context (not raw code)
+- Prompts explicitly forbid fabrication
+- AI must state uncertainty when context is insufficient
+- Deterministic facts (file counts, routes, modules) are never AI-generated
+
+## Example Outputs
+
+### Executive Summary (with AI)
+
+```markdown
+# Executive Summary
+
+## What this system does
+
+Based on the detected modules and routing structure, this appears to be 
+a financial analytics platform that combines market data visualization, 
+user account management, and research content delivery.
+
+## Who it serves
+
+The system serves retail investors and financial analysts who need...
+
+## Core capabilities
+
+1. Real-time market data analysis with interactive charts
+2. Portfolio tracking and trade management
+3. Research articles and investment insights
+...
+```
+
+### Executive Summary (without AI)
+
+```markdown
+# Executive Summary
+
+## What this system does
+
+my-project is a Next.js, React application with 271 modules across 
+1139 files.
+
+## Main system areas
+
+The codebase is organized into 12 main domains:
+- Market Data & Analysis: 45 modules
+- Authentication: 8 modules
+...
+
+Note: AI-enhanced documentation is disabled.
+```
+
+## Troubleshooting
+
+### "AI features are disabled"
+
+Set `REPOLENS_AI_ENABLED=true`
+
+### "Missing API key"
+
+Set `REPOLENS_AI_API_KEY=your-key`
+
+### "Request timeout"
+
+Increase timeout: `REPOLENS_AI_TIMEOUT_MS=120000` (2 minutes)
+
+### "Rate limit exceeded"
+
+Wait and retry, or reduce `max_tokens`
+
+### Poor quality output
+
+- Try `gpt-5.4` for highest quality output
+- Increase `max_tokens`
+- Add more detail to `domains` configuration
+
+### Running costs too high
+
+- Use `gpt-5-nano` instead of `gpt-5-mini`
+- Reduce number of documents in `documentation.sections`
+- Run less frequently (only on main branch merges)
+
+## Next Steps
+
+1. Start with default settings and `gpt-5-mini`
+2. Review generated documentation
+3. Add business domains to improve quality
+4. Adjust `max_tokens` as needed
+5. Switch to `gpt-5-nano` to reduce costs if quality is acceptable

package/docs/ARCHITECTURE.md

@@ -0,0 +1,145 @@
+# 🏗️ Architecture & Design
+
+## How RepoLens Works
+
+```
+1. SCAN           2. ANALYZE         3. RENDER           4. PUBLISH
+──────────────────────────────────────────────────────────────────
+Read files   →   Detect tech     →  Generate docs   →   Notion pages
+from patterns    stack patterns      with insights       + Confluence pages
+                                                         + Markdown files
+```
+
+**Scan Phase:**
+- Uses `fast-glob` to match your `scan.include` patterns
+- Filters out `scan.ignore` patterns
+- Reads package.json for framework/tool detection
+- Analyzes file paths for Next.js routes, API endpoints
+
+**Analyze Phase:**
+- Extracts frameworks (Next.js, React, Vue, Express, etc.)
+- Detects build tools (Vite, Webpack, Turbo, esbuild)
+- Identifies test frameworks (Vitest, Jest, Playwright)
+- Infers module relationships and dependencies
+
+**Render Phase:**
+- Groups files into modules based on `module_roots`
+- Generates Mermaid diagrams showing module dependencies
+- Creates technical profiles with actual stack insights
+- Renders Markdown documentation
+
+**Publish Phase:**
+- Markdown: Writes files to `.repolens/` directory
+- Notion: Creates/updates pages via API with retry logic
+- Confluence: Creates/updates pages via REST API v1 (storage format)
+
+## Module Dependency Detection
+
+RepoLens infers relationships by analyzing import patterns:
+
+```typescript
+// In src/publishers/notion.js
+import { renderSystemOverview } from "../renderers/render.js";
+// → Publishers depend on Renderers
+
+// In src/renderers/render.js  
+import { scanRepo } from "../core/scan.js";
+// → Renderers depend on Core
+
+// Result: Dependency graph shows Publishers → Renderers → Core
+```
+
+## System Map
+
+```mermaid
+graph LR
+    CLI[bin/repolens<br/>1 file] --> Core[src/core<br/>4 files]
+    Publishers[src/publishers<br/>6 files] --> Core
+    Publishers --> Renderers[src/renderers<br/>4 files]
+    Publishers --> Utils[src/utils<br/>10 files]
+    Renderers --> Core
+    Delivery[src/delivery<br/>1 file] --> Publishers
+    Tests[tests<br/>15 files] -. tests .-> CLI
+    Tests -. tests .-> Core
+    Tests -. tests .-> Publishers
+    
+    style CLI fill:#9b59b6,color:#fff
+    style Core fill:#f39c12,color:#000
+    style Publishers fill:#27ae60,color:#fff
+    style Renderers fill:#27ae60,color:#fff
+    style Delivery fill:#16a085,color:#fff
+    style Utils fill:#95a5a6,color:#000
+    style Tests fill:#e67e22,color:#fff
+```
+
+## Project Structure
+
+```
+repolens/
+├── bin/
+│   └── repolens.js          # CLI executable wrapper
+├── src/
+│   ├── cli.js               # Command orchestration + banner
+│   ├── init.js              # Scaffolding command (+ interactive wizard)
+│   ├── doctor.js            # Validation command
+│   ├── migrate.js           # Workflow migration (legacy → current)
+│   ├── watch.js             # Watch mode for local development
+│   ├── core/
+│   │   ├── config.js        # Config loading + validation
+│   │   ├── config-schema.js # Schema version tracking
+│   │   ├── diff.js          # Git diff operations
+│   │   └── scan.js          # Repository scanning + metadata extraction
+│   ├── analyzers/
+│   │   ├── domain-inference.js    # Business domain mapping
+│   │   ├── context-builder.js     # Structured AI context assembly
+│   │   ├── flow-inference.js      # Data flow detection
+│   │   ├── graphql-analyzer.js    # GraphQL schema detection
+│   │   ├── typescript-analyzer.js # TypeScript type graph analysis
+│   │   ├── dependency-graph.js    # Import graph with cycle detection
+│   │   └── drift-detector.js      # Architecture drift detection
+│   ├── ai/
+│   │   ├── provider.js          # Provider-agnostic AI generation
+│   │   ├── prompts.js           # Strict prompt templates
+│   │   ├── document-plan.js     # Document structure definition
+│   │   └── generate-sections.js # AI section generation + fallbacks
+│   ├── docs/
+│   │   ├── generate-doc-set.js  # Document generation orchestration
+│   │   └── write-doc-set.js     # Write docs to disk
+│   ├── renderers/
+│   │   ├── render.js           # System overview, catalog, API, routes
+│   │   ├── renderDiff.js       # Architecture diff rendering
+│   │   ├── renderMap.js        # Unicode dependency diagrams
+│   │   └── renderAnalysis.js   # Extended analysis renderers
+│   ├── publishers/
+│   │   ├── index.js         # Publisher orchestration + branch filtering
+│   │   ├── publish.js       # Publishing pipeline
+│   │   ├── notion.js        # Notion API integration
+│   │   ├── confluence.js    # Confluence REST API integration
+│   │   ├── github-wiki.js   # GitHub Wiki publisher (git-based)
+│   │   └── markdown.js      # Local Markdown generation
+│   ├── integrations/
+│   │   └── discord.js       # Discord webhook notifications
+│   ├── delivery/
+│   │   └── comment.js       # PR comment delivery
+│   ├── plugins/
+│   │   ├── loader.js        # Plugin resolution and dynamic import
+│   │   └── manager.js       # Plugin registry and lifecycle orchestration
+│   └── utils/
+│       ├── logger.js        # Logging utilities
+│       ├── retry.js         # API retry logic (exponential backoff)
+│       ├── branch.js        # Branch detection (multi-platform)
+│       ├── validate.js      # Configuration validation & security
+│       ├── metrics.js       # Documentation coverage & health scoring
+│       ├── rate-limit.js    # Token bucket rate limiter for APIs
+│       ├── secrets.js       # Secret detection & sanitization
+│       ├── telemetry.js     # Opt-in error tracking + performance timers
+│       ├── errors.js        # Enhanced error messages with guidance
+│       └── update-check.js  # Version update notifications
+├── tests/                   # Vitest test suite (185 tests across 15 files)
+├── .repolens.yml            # Dogfooding config
+├── package.json
+├── CHANGELOG.md
+├── STABILITY.md
+├── RELEASE.md
+└── ROADMAP.md
+```