@chappibunny/repolens 0.9.0 → 1.0.0

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 All notable changes to RepoLens will be documented in this file.
 
+## 1.0.0
+
+### 🎉 Stable Release
+
+RepoLens v1.0.0 marks the first stable release with a frozen public API. All CLI commands, configuration schema, and plugin interfaces are now covered by semantic versioning guarantees. See [STABILITY.md](STABILITY.md) for the full contract.
+
+### 🐛 Bug Fixes
+- **Doctor false-success**: `repolens doctor` now correctly exits with code 2 when `runDoctor()` reports failures (previously always printed "validation passed")
+- **Feedback exit code**: `repolens feedback` now exits with code 1 when feedback fails to send (previously exited 0)
+- **Unknown flags**: `repolens --unknown-flag` now prints an error instead of silently running publish
+- **scan.ignore security bypass**: Security validator now checks `scan.ignore` patterns (was incorrectly checking non-existent `scan.exclude`)
+- **Domains type mismatch**: Both validators now expect `domains` as an object (was array in security validator, object in schema validator)
+- **Plugin publisher crash isolation**: Plugin publisher errors are now caught and logged instead of crashing the pipeline
+
+### ✅ Config Stability
+- `configVersion: 1` is now **required** (was optional in schema validator)
+- Added `confluence` config section validation (branches array)
+- Added `ai.temperature` range validation (0–2)
+- Added `ai.max_tokens` range validation (>0)
+- AI config values from `.repolens.yml` are now used as fallbacks when env vars are not set
+
+### 🔧 Improvements
+- Standardized exit codes: `EXIT_SUCCESS=0`, `EXIT_ERROR=1`, `EXIT_VALIDATION=2` as named constants
+- Replaced all `console.log`/`console.warn` in production code with logger utilities
+- Removed stale "v0.4.0" references from CLI help text and migrate command
+- Sentry DSN moved to `REPOLENS_SENTRY_DSN` env var (with backwards-compatible default)
+- Hardcoded email in `init` scaffolding replaced with `your-email@example.com` placeholder
+
+### 📄 Documentation
+- Added [STABILITY.md](STABILITY.md): Complete public API contract (CLI, config schema, plugin interface, exit codes, env vars)
+
 ## 0.9.0
 
 ### ✨ New Features

package/README.md

@@ -16,11 +16,11 @@
 
 AI-assisted documentation intelligence system that generates architecture docs for engineers AND readable system docs for stakeholders
 
-**Current Status**: v0.9.0 — Plugin System
+**Current Status**: v1.0.0 — Stable Release
 
 RepoLens automatically generates and maintains living architecture documentation by analyzing your repository structure, extracting meaningful insights from your package.json, and creating visual dependency graphs. Run it once, or let it auto-update on every push.
 
-⚠️ **Early Access Notice**: The CLI commands and configuration format may evolve until v1.0. We will provide migration guides for any breaking changes. v1.0 will guarantee stable CLI behavior and config schema.
+The CLI, configuration schema, and plugin interface are **stable** as of v1.0. See [STABILITY.md](STABILITY.md) for the full API contract and semver guarantees.
 
 ---
 
@@ -49,7 +49,7 @@ For Confluence:
 ```bash
 # Edit .env and add:
 CONFLUENCE_URL=https://your-company.atlassian.net/wiki
-CONFLUENCE_EMAIL=trades@rabitaitrades.com
+CONFLUENCE_EMAIL=your-email@example.com
 CONFLUENCE_API_TOKEN=your-token
 CONFLUENCE_SPACE_KEY=DOCS
 ```
@@ -137,6 +137,8 @@ RepoLens automatically detects:
 ✅ **TypeScript Type Graph** - Map interfaces, classes, and type relationships (NEW in v0.8.0)  
 ✅ **Dependency Graph** - Import analysis with circular dependency detection (NEW in v0.8.0)  
 ✅ **Architecture Drift** - Track structural changes against a baseline (NEW in v0.8.0)  
+✅ **Plugin System** - Extend with custom renderers, publishers, and hooks (NEW in v0.9.0)  
+✅ **Stable API** - CLI, config, and plugin interface frozen with semver guarantees (v1.0.0)  
 
 ---
 
@@ -228,7 +230,7 @@ npm link
 Install from a specific version:
 
 ```bash
-npm install https://github.com/CHAPIBUNNY/repolens/releases/download/v0.9.0/chappibunny-repolens-0.9.0.tgz
+npm install https://github.com/CHAPIBUNNY/repolens/releases/download/v1.0.0/chappibunny-repolens-1.0.0.tgz
 ```
 </details>
 
@@ -318,7 +320,7 @@ Maximum visibility: Notion for async collaboration, Confluence for enterprise do
 **3.1: Choose an AI Provider**
 
 RepoLens works with any OpenAI-compatible API:
-- **OpenAI** (gpt-4-turbo-preview, gpt-3.5-turbo)
+- **OpenAI** (gpt-5-mini, gpt-5.4, gpt-5-nano)
 - **Anthropic Claude** (via API gateway)
 - **Azure OpenAI** (enterprise deployments)
 - **Local Models** (Ollama, LM Studio, etc.)
@@ -333,7 +335,7 @@ REPOLENS_AI_API_KEY=sk-xxxxxxxxxxxxx
 
 # Optional: Customize provider
 REPOLENS_AI_BASE_URL=https://api.openai.com/v1
-REPOLENS_AI_MODEL=gpt-4-turbo-preview
+REPOLENS_AI_MODEL=gpt-5-mini
 REPOLENS_AI_TEMPERATURE=0.3
 REPOLENS_AI_MAX_TOKENS=2000
 ```
@@ -356,7 +358,7 @@ features:
   change_impact: true        # Architecture diff with context
 ```
 
-**Cost Estimates** (with gpt-4-turbo-preview):
+**Cost Estimates** (with gpt-5-mini):
 - Small repo (<50 files): $0.10-$0.30 per run
 - Medium repo (50-200 files): $0.30-$0.80 per run
 - Large repo (200+ files): $0.80-$2.00 per run
@@ -428,7 +430,7 @@ If using the Confluence publisher:
 Create `.env` in your project root:
 ```bash
 CONFLUENCE_URL=https://your-company.atlassian.net/wiki
-CONFLUENCE_EMAIL=trades@rabitaitrades.com
+CONFLUENCE_EMAIL=your-email@example.com
 CONFLUENCE_API_TOKEN=your-api-token-here
 CONFLUENCE_SPACE_KEY=DOCS
 CONFLUENCE_PARENT_PAGE_ID=123456789  # Optional
@@ -449,7 +451,7 @@ Add as repository secrets:
 2. Click **"New repository secret"**
 3. Add:
    - Name: `CONFLUENCE_URL`, Value: `https://your-company.atlassian.net/wiki`
-   - Name: `CONFLUENCE_EMAIL`, Value: `trades@rabitaitrades.com`
+   - Name: `CONFLUENCE_EMAIL`, Value: `your-email@example.com`
    - Name: `CONFLUENCE_API_TOKEN`, Value: `your-token`
    - Name: `CONFLUENCE_SPACE_KEY`, Value: `DOCS`
    - Name: `CONFLUENCE_PARENT_PAGE_ID`, Value: `123456789` (optional)
@@ -939,10 +941,11 @@ features:
 
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
-| `configVersion` | number | No | Schema version (current: 1) for future migrations |
+| `configVersion` | number | **Yes** | Schema version (must be `1`) |
 | `project.name` | string | Yes | Project name |
 | `project.docs_title_prefix` | string | No | Prefix for documentation titles (default: project name) |
-| `publishers` | array | Yes | Output targets: `notion`, `confluence`, `markdown` |
+| `publishers` | array | Yes | Output targets: `notion`, `confluence`, `markdown` (+ plugin publishers) |
+| `plugins` | array | No | Plugin paths or npm package names |
 | `notion.branches` | array | No | Branch whitelist for Notion publishing. Supports globs. |
 | `notion.includeBranchInTitle` | boolean | No | Add `[branch-name]` to titles (default: `true`) |
 | `confluence.branches` | array | No | Branch whitelist for Confluence publishing. Supports globs. |
@@ -956,7 +959,11 @@ features:
 | `scan.ignore` | array | Yes | Glob patterns to exclude |
 | `module_roots` | array | No | Root directories for module detection |
 | `outputs.pages` | array | Yes | Documentation pages to generate |
-| `features` | object | No | Experimental feature flags |
+| `features` | object | No | Feature flags (boolean values) |
+| `ai.enabled` | boolean | No | Enable AI-powered documentation |
+| `ai.mode` | string | No | AI mode: `hybrid`, `full`, or `off` |
+| `ai.temperature` | number | No | Generation temperature (0\u20132) |
+| `ai.max_tokens` | number | No | Max tokens per request (>0) |
 
 ---
 
@@ -1081,7 +1088,7 @@ Simulates the full user installation experience:
 npm pack
 
 # Install globally from tarball
-npm install -g chappibunny-repolens-0.9.0.tgz
+npm install -g chappibunny-repolens-1.0.0.tgz
 
 # Verify
 repolens --version
@@ -1135,6 +1142,9 @@ repolens/
 │   │   └── 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)
@@ -1150,6 +1160,7 @@ repolens/
 ├── .repolens.yml            # Dogfooding config
 ├── package.json
 ├── CHANGELOG.md
+├── STABILITY.md
 ├── RELEASE.md
 └── ROADMAP.md
 ```
@@ -1163,13 +1174,13 @@ RepoLens uses automated GitHub Actions releases.
 ### Creating a Release
 
 ```bash
-# Patch version (0.9.0 → 0.9.1) - Bug fixes
+# Patch version (1.0.0 → 1.0.1) - Bug fixes
 npm run release:patch
 
-# Minor version (0.9.0 → 0.10.0) - New features
+# Minor version (1.0.0 → 1.1.0) - New features
 npm run release:minor
 
-# Major version (0.9.0 → 1.0.0) - Breaking changes
+# Major version (1.0.0 → 2.0.0) - Breaking changes
 npm run release:major
 
 # Push the tag to trigger workflow
@@ -1189,24 +1200,23 @@ See [RELEASE.md](./RELEASE.md) for detailed workflow.
 
 ## 🤝 Contributing
 
-RepoLens is currently in early access. v1.0 will open for community contributions.
-
 **Ways to help:**
 - **Try it out**: Install and use in your projects
 - **Report issues**: Share bugs, edge cases, or UX friction
 - **Request features**: Tell us what's missing
-- **Share feedback**: What works? What doesn't?
+- **Build plugins**: Extend RepoLens with custom renderers and publishers
+- **Share feedback**: `repolens feedback`
 
 ---
 
-## 🗺️ Roadmap to v1.0
+## 🗺️ Roadmap
 
-**Current Status:** v0.9.0 — Plugin System
+**Current Status:** v1.0.0 — Stable Release
 
-### Completed ✅
+### v1.0 — Complete ✅
 
 - [x] CLI commands: `init`, `doctor`, `publish`, `migrate`, `watch`, `feedback`, `version`, `help`
-- [x] Config schema v1 with validation
+- [x] Config schema v1 with validation (frozen)
 - [x] Auto-discovery of `.repolens.yml`
 - [x] Publishers: Notion + Confluence + Markdown
 - [x] Branch-aware publishing with filtering
@@ -1235,11 +1245,14 @@ RepoLens is currently in early access. v1.0 will open for community contribution
 - [x] Dependency graph with circular dependency detection
 - [x] Architecture drift detection (baseline comparison)
 - [x] Plugin system for custom renderers and publishers
+- [x] Stability audit: CLI, config schema, and plugin interface frozen
+- [x] [STABILITY.md](STABILITY.md): Public API contract with semver guarantees
 
-### Planned for v1.0 🎯
+### Future
 
-- [ ] Stability audit: freeze CLI flags and config schema
 - [ ] Additional publishers (GitHub Wiki, Obsidian)
+- [ ] VS Code extension
+- [ ] GitHub App
 
 See [ROADMAP.md](./ROADMAP.md) for detailed planning.
 

package/package.json

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

package/src/ai/provider.js

@@ -7,9 +7,10 @@ const DEFAULT_TIMEOUT_MS = 60000;
 const DEFAULT_TEMPERATURE = 0.2;
 const DEFAULT_MAX_TOKENS = 2500;
 
-export async function generateText({ system, user, temperature, maxTokens }) {
-  // Check if AI is enabled
-  const enabled = process.env.REPOLENS_AI_ENABLED === "true";
+export async function generateText({ system, user, temperature, maxTokens, config }) {
+  // Check if AI is enabled (env var takes precedence, then config)
+  const aiConfig = config?.ai || {};
+  const enabled = process.env.REPOLENS_AI_ENABLED === "true" || aiConfig.enabled === true;
   
   if (!enabled) {
     return {
@@ -19,13 +20,17 @@ export async function generateText({ system, user, temperature, maxTokens }) {
     };
   }
   
-  // Get provider configuration from environment
+  // Get provider configuration (env vars take precedence, then config, then defaults)
   const provider = process.env.REPOLENS_AI_PROVIDER || "openai_compatible";
   const baseUrl = process.env.REPOLENS_AI_BASE_URL;
   const apiKey = process.env.REPOLENS_AI_API_KEY;
-  const model = process.env.REPOLENS_AI_MODEL || "gpt-4-turbo-preview";
+  const model = process.env.REPOLENS_AI_MODEL || "gpt-5-mini";
   const timeoutMs = parseInt(process.env.REPOLENS_AI_TIMEOUT_MS || DEFAULT_TIMEOUT_MS);
   
+  // Use config values as fallback for temperature/maxTokens
+  const resolvedTemp = temperature ?? aiConfig.temperature ?? DEFAULT_TEMPERATURE;
+  const resolvedMaxTokens = maxTokens ?? aiConfig.max_tokens ?? DEFAULT_MAX_TOKENS;
+  
   // Validate configuration
   if (!apiKey) {
     warn("REPOLENS_AI_API_KEY not set. AI features disabled.");
@@ -47,8 +52,8 @@ export async function generateText({ system, user, temperature, maxTokens }) {
       model,
       system,
       user,
-      temperature: temperature ?? DEFAULT_TEMPERATURE,
-      maxTokens: maxTokens ?? DEFAULT_MAX_TOKENS,
+      temperature: resolvedTemp,
+      maxTokens: resolvedMaxTokens,
       timeoutMs
     });
     
@@ -129,7 +134,7 @@ export function getAIConfig() {
   return {
     enabled: isAIEnabled(),
     provider: process.env.REPOLENS_AI_PROVIDER || "openai_compatible",
-    model: process.env.REPOLENS_AI_MODEL || "gpt-4-turbo-preview",
+    model: process.env.REPOLENS_AI_MODEL || "gpt-5-mini",
     hasApiKey: !!process.env.REPOLENS_AI_API_KEY,
     temperature: parseFloat(process.env.REPOLENS_AI_TEMPERATURE || DEFAULT_TEMPERATURE),
     maxTokens: parseInt(process.env.REPOLENS_AI_MAX_TOKENS || DEFAULT_MAX_TOKENS)

package/src/cli.js

@@ -41,6 +41,11 @@ import {
 } from "./utils/telemetry.js";
 import { createInterface } from "node:readline";
 
+// Standardized exit codes
+const EXIT_SUCCESS = 0;
+const EXIT_ERROR = 1;
+const EXIT_VALIDATION = 2;
+
 function formatDuration(ms) {
   if (ms < 1000) return `${ms}ms`;
   return `${(ms / 1000).toFixed(1)}s`;
@@ -136,7 +141,7 @@ Usage:
 Commands:
   init        Scaffold RepoLens files in your repository
   doctor      Validate your RepoLens setup
-  migrate     Upgrade workflow files to v0.4.0 format
+  migrate     Upgrade workflow files to current format
   publish     Scan, render, and publish documentation
   watch       Watch for file changes and regenerate docs
   feedback    Send feedback to the RepoLens team
@@ -213,7 +218,7 @@ async function main() {
       error("Failed to initialize RepoLens:");
       error(err.message);
       await closeTelemetry();
-      process.exit(1);
+      process.exit(EXIT_ERROR);
     }
     return;
   }
@@ -225,10 +230,16 @@ async function main() {
     
     const timer = startTimer("doctor");
     try {
-      await runDoctor(targetDir);
+      const result = await runDoctor(targetDir);
       const duration = stopTimer(timer);
-      info("✓ RepoLens validation passed");
       
+      if (result && result.ok === false) {
+        trackUsage("doctor", "failure", { duration });
+        await closeTelemetry();
+        process.exit(EXIT_VALIDATION);
+      }
+      
+      info("✓ RepoLens validation passed");
       trackUsage("doctor", "success", { duration });
       await closeTelemetry();
     } catch (err) {
@@ -238,7 +249,7 @@ async function main() {
       error("Validation failed:");
       error(err.message);
       await closeTelemetry();
-      process.exit(2);
+      process.exit(EXIT_VALIDATION);
     }
     return;
   }
@@ -267,7 +278,7 @@ async function main() {
       error("Migration failed:");
       error(err.message);
       await closeTelemetry();
-      process.exit(1);
+      process.exit(EXIT_ERROR);
     }
     return;
   }
@@ -280,13 +291,20 @@ async function main() {
       info(`Using config: ${configPath}`);
     } catch (err) {
       error(err.message);
-      process.exit(2);
+      process.exit(EXIT_VALIDATION);
     }
     await runWatch(configPath);
     return;
   }
 
-  if (command === "publish" || !command || command.startsWith("--")) {
+  // Reject unknown flags/commands before falling through to publish
+  if (command && command.startsWith("--") && !["--help", "-h", "--version", "-v"].includes(command)) {
+    error(`Unknown option: ${command}`);
+    error("Run 'repolens help' for usage information.");
+    process.exit(EXIT_ERROR);
+  }
+
+  if (command === "publish" || !command) {
     await printBanner();
     
     const commandTimer = startTimer("publish");
@@ -299,7 +317,7 @@ async function main() {
     } catch (err) {
       stopTimer(commandTimer);
       error(err.message);
-      process.exit(2);
+      process.exit(EXIT_VALIDATION);
     }
 
     let cfg, scan;
@@ -312,7 +330,7 @@ async function main() {
       trackUsage("publish", "failure", { step: "config-load" });
       error(formatError("CONFIG_VALIDATION_FAILED", err));
       await closeTelemetry();
-      process.exit(2);
+      process.exit(EXIT_VALIDATION);
     }
 
     // Load plugins
@@ -342,7 +360,7 @@ async function main() {
                  : err.message?.includes("limit") ? "SCAN_TOO_MANY_FILES" : null;
       error(code ? formatError(code, err) : `Failed to scan repository:\n  ${err.message}`);
       await closeTelemetry();
-      process.exit(1);
+      process.exit(EXIT_ERROR);
     }
 
     const rawDiff = getGitDiff("origin/main");
@@ -399,7 +417,7 @@ async function main() {
       error("Failed to publish documentation:");
       error(err.message);
       await closeTelemetry();
-      process.exit(1);
+      process.exit(EXIT_ERROR);
     }
 
     await closeTelemetry();
@@ -423,7 +441,7 @@ async function main() {
       if (!message.trim()) {
         error("Feedback message cannot be empty.");
         await closeTelemetry();
-        process.exit(1);
+        process.exit(EXIT_ERROR);
       }
 
       info("\nSending feedback...");
@@ -437,6 +455,8 @@ async function main() {
         info("✓ Thank you! Your feedback has been sent.");
       } else {
         error("Failed to send feedback. Please try again later.");
+        await closeTelemetry();
+        process.exit(EXIT_ERROR);
       }
     } catch (err) {
       rl.close();
@@ -451,7 +471,7 @@ async function main() {
 
   error(`Unknown command: ${command}`);
   error("Available commands: init, doctor, migrate, publish, watch, feedback, version, help");
-  process.exit(1);
+  process.exit(EXIT_ERROR);
 }
 
 main().catch(async (err) => {
@@ -481,5 +501,5 @@ main().catch(async (err) => {
   }
   
   await closeTelemetry();
-  process.exit(1);
+  process.exit(EXIT_ERROR);
 });

package/src/core/config-schema.js

@@ -39,17 +39,17 @@ class ValidationError extends Error {
 export function validateConfig(config) {
   const errors = [];
 
-  // Check schema version
-  if (config.configVersion !== undefined) {
-    if (typeof config.configVersion !== "number") {
-      errors.push("configVersion must be a number");
-    } else if (config.configVersion > CURRENT_SCHEMA_VERSION) {
-      errors.push(
-        `Config schema version ${config.configVersion} is not supported. ` +
-        `This version of RepoLens supports schema version ${CURRENT_SCHEMA_VERSION}. ` +
-        `Please upgrade RepoLens or downgrade your config.`
-      );
-    }
+  // Check schema version (required for v1.0+)
+  if (config.configVersion === undefined || config.configVersion === null) {
+    errors.push("Missing required field: configVersion (must be 1)");
+  } else if (typeof config.configVersion !== "number") {
+    errors.push("configVersion must be a number");
+  } else if (config.configVersion > CURRENT_SCHEMA_VERSION) {
+    errors.push(
+      `Config schema version ${config.configVersion} is not supported. ` +
+      `This version of RepoLens supports schema version ${CURRENT_SCHEMA_VERSION}. ` +
+      `Please upgrade RepoLens or downgrade your config.`
+    );
   }
 
   // Validate project section
@@ -173,6 +173,26 @@ export function validateConfig(config) {
     }
   }
 
+  // Validate Confluence configuration (optional)
+  if (config.confluence !== undefined) {
+    if (typeof config.confluence !== "object" || Array.isArray(config.confluence)) {
+      errors.push("confluence must be an object");
+    } else {
+      // Validate branches filter
+      if (config.confluence.branches !== undefined) {
+        if (!Array.isArray(config.confluence.branches)) {
+          errors.push("confluence.branches must be an array");
+        } else {
+          config.confluence.branches.forEach((branch, idx) => {
+            if (typeof branch !== "string") {
+              errors.push(`confluence.branches[${idx}] must be a string`);
+            }
+          });
+        }
+      }
+    }
+  }
+
   // Validate Discord configuration (optional)
   if (config.discord !== undefined) {
     if (typeof config.discord !== "object" || Array.isArray(config.discord)) {
@@ -241,9 +261,13 @@ export function validateConfig(config) {
       }
       if (config.ai.temperature !== undefined && typeof config.ai.temperature !== "number") {
         errors.push("ai.temperature must be a number");
+      } else if (typeof config.ai.temperature === "number" && (config.ai.temperature < 0 || config.ai.temperature > 2)) {
+        errors.push("ai.temperature must be between 0 and 2");
       }
       if (config.ai.max_tokens !== undefined && typeof config.ai.max_tokens !== "number") {
         errors.push("ai.max_tokens must be a number");
+      } else if (typeof config.ai.max_tokens === "number" && config.ai.max_tokens <= 0) {
+        errors.push("ai.max_tokens must be greater than 0");
       }
     }
   }

package/src/init.js

@@ -94,7 +94,7 @@ NOTION_VERSION=2022-06-28
 
 # Confluence Publishing
 CONFLUENCE_URL=https://your-company.atlassian.net/wiki
-CONFLUENCE_EMAIL=trades@rabitaitrades.com
+CONFLUENCE_EMAIL=your-email@example.com
 CONFLUENCE_API_TOKEN=
 CONFLUENCE_SPACE_KEY=DOCS
 CONFLUENCE_PARENT_PAGE_ID=
@@ -104,7 +104,7 @@ CONFLUENCE_PARENT_PAGE_ID=
 # REPOLENS_AI_ENABLED=true
 # REPOLENS_AI_API_KEY=sk-...
 # REPOLENS_AI_BASE_URL=https://api.openai.com/v1
-# REPOLENS_AI_MODEL=gpt-4-turbo-preview
+# REPOLENS_AI_MODEL=gpt-5-mini
 # REPOLENS_AI_TEMPERATURE=0.3
 # REPOLENS_AI_MAX_TOKENS=2000
 `;

package/src/migrate.js

@@ -234,7 +234,7 @@ export async function runMigrate(targetDir = process.cwd(), options = {}) {
         console.log("\n📝 Next steps:");
         console.log("   1. Review the changes: git diff .github/workflows/");
         console.log("   2. Test locally: npx @chappibunny/repolens@latest publish");
-        console.log("   3. Commit: git add .github/workflows/ && git commit -m 'chore: migrate RepoLens workflow to v0.4.0'");
+        console.log("   3. Commit: git add .github/workflows/ && git commit -m 'chore: migrate RepoLens workflow to latest format'");
         console.log("   4. Push: git push");
         console.log("\n💡 Tip: Backups saved as *.backup - delete them once verified");
       } else {
@@ -259,6 +259,6 @@ export async function runMigrate(targetDir = process.cwd(), options = {}) {
 async function printMigrationBanner() {
   console.log("\n" + "=".repeat(60));
   console.log("🔄 RepoLens Workflow Migration Tool");
-  console.log("   Upgrading to v0.4.0 format");
+  console.log("   Upgrading to latest format");
   console.log("=".repeat(60));
 }

package/src/publishers/index.js

@@ -90,8 +90,8 @@ export async function publishDocs(cfg, renderedPages, scanResult, pluginManager
           await publisher.publish(cfg, renderedPages);
           publishedTo.push(key);
         } catch (err) {
+          warn(`Plugin publisher "${key}" failed: ${err.message}`);
           publishStatus = "failure";
-          throw err;
         }
       }
     }

package/src/publishers/notion.js

@@ -1,7 +1,7 @@
 import fetch from "node-fetch";
 import fs from "node:fs/promises";
 import path from "node:path";
-import { log } from "../utils/logger.js";
+import { log, warn } from "../utils/logger.js";
 import { fetchWithRetry } from "../utils/retry.js";
 import { executeNotionRequest } from "../utils/rate-limit.js";
 import { createRepoLensError } from "../utils/errors.js";
@@ -243,7 +243,7 @@ function parseInlineRichText(text) {
 function markdownToNotionBlocks(markdown) {
   // Safety check: handle undefined/null markdown
   if (!markdown || typeof markdown !== 'string') {
-    console.warn(`Warning: markdownToNotionBlocks received invalid markdown: ${typeof markdown}`);
+    warn(`markdownToNotionBlocks received invalid markdown: ${typeof markdown}`);
     return [];
   }
   

package/src/publishers/publish.js

@@ -1,5 +1,6 @@
 import { ensurePage, replacePageContent } from "./notion.js";
 import { getCurrentBranch, getBranchQualifiedTitle } from "../utils/branch.js";
+import { warn } from "../utils/logger.js";
 
 export async function publishToNotion(cfg, renderedPages) {
   const parentPageId = process.env.NOTION_PARENT_PAGE_ID;
@@ -22,7 +23,7 @@ export async function publishToNotion(cfg, renderedPages) {
     
     // Skip if content not generated (e.g., disabled feature or generation error)
     if (!markdown) {
-      console.log(`⚠️  Skipping ${page.key}: No content generated`);
+      warn(`Skipping ${page.key}: No content generated`);
       continue;
     }
     

package/src/utils/rate-limit.js

@@ -5,6 +5,8 @@
  * to prevent abuse and respect API limits.
  */
 
+import { warn } from "./logger.js";
+
 /**
  * Rate limiter class using token bucket algorithm
  */
@@ -193,7 +195,7 @@ export async function executeNotionRequest(fn, options = {}) {
         if (options.onRetry) {
           options.onRetry(attempt, maxRetries, delay, error);
         } else {
-          console.warn(
+          warn(
             `Notion API retry ${attempt}/${maxRetries} after ${Math.round(delay)}ms (${error.message})`
           );
         }
@@ -221,7 +223,7 @@ export async function executeAIRequest(fn, options = {}) {
         if (options.onRetry) {
           options.onRetry(attempt, maxRetries, delay, error);
         } else {
-          console.warn(
+          warn(
             `AI API retry ${attempt}/${maxRetries} after ${Math.round(delay)}ms (${error.message})`
           );
         }

package/src/utils/telemetry.js

@@ -33,8 +33,10 @@ export function initTelemetry() {
     const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
     const version = packageJson.version || "unknown";
 
+    const dsn = process.env.REPOLENS_SENTRY_DSN || "https://082083dbf5899ed7e65dfd9b8dc72f90@o4511014913703936.ingest.de.sentry.io/4511014919209040";
+
     Sentry.init({
-      dsn: "https://082083dbf5899ed7e65dfd9b8dc72f90@o4511014913703936.ingest.de.sentry.io/4511014919209040", // TODO: Replace with actual DSN
+      dsn,
       
       // Release tracking
       release: `repolens@${version}`,
@@ -412,8 +414,10 @@ function ensureSentryForFeedback() {
     const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
     const version = packageJson.version || "unknown";
 
+    const dsn = process.env.REPOLENS_SENTRY_DSN || "https://082083dbf5899ed7e65dfd9b8dc72f90@o4511014913703936.ingest.de.sentry.io/4511014919209040";
+
     Sentry.init({
-      dsn: "https://082083dbf5899ed7e65dfd9b8dc72f90@o4511014913703936.ingest.de.sentry.io/4511014919209040",
+      dsn,
       release: `repolens@${version}`,
       environment: process.env.NODE_ENV || "production",
       sampleRate: 1.0, // Always send feedback

package/src/utils/update-check.js

@@ -104,7 +104,7 @@ export async function checkForUpdates() {
 }
 
 function showUpdateMessage(current, latest) {
-  console.log("");
+  info("");
   warn("┌────────────────────────────────────────────────────────────┐");
   warn("│                   📦 Update Available                      │");
   warn("├────────────────────────────────────────────────────────────┤");
@@ -118,7 +118,7 @@ function showUpdateMessage(current, latest) {
   warn("│                                                            │");
   warn("│  Release notes: https://github.com/CHAPIBUNNY/repolens    │");
   warn("└────────────────────────────────────────────────────────────┘");
-  console.log("");
+  info("");
 }
 
 export async function forceCheckForUpdates() {

package/src/utils/validate.js

@@ -103,13 +103,13 @@ function validateScanConfig(scan) {
     }
   }
   
-  if (scan.exclude) {
-    if (!Array.isArray(scan.exclude)) {
-      errors.push("scan.exclude must be an array of glob patterns");
+  if (scan.ignore) {
+    if (!Array.isArray(scan.ignore)) {
+      errors.push("scan.ignore must be an array of glob patterns");
     } else {
-      for (const pattern of scan.exclude) {
+      for (const pattern of scan.ignore) {
         if (typeof pattern !== "string") {
-          errors.push(`Invalid pattern in scan.exclude: ${pattern} (must be string)`);
+          errors.push(`Invalid pattern in scan.ignore: ${pattern} (must be string)`);
           continue; // Skip further checks if not a string
         }
       }
@@ -207,33 +207,34 @@ function checkNotionWarnings(notion) {
 }
 
 /**
- * Validate domains configuration
+ * Validate domains configuration (object format: { key: { match: [], description? } })
  */
 function validateDomains(domains) {
   const errors = [];
   
-  if (!Array.isArray(domains)) {
-    errors.push("domains must be an array");
+  if (typeof domains !== "object" || Array.isArray(domains)) {
+    errors.push("domains must be an object");
     return errors;
   }
   
-  for (const domain of domains) {
-    if (!domain.name || typeof domain.name !== "string") {
-      errors.push("Each domain must have a 'name' field (string)");
+  for (const [key, domain] of Object.entries(domains)) {
+    if (typeof domain !== "object" || Array.isArray(domain)) {
+      errors.push(`domains.${key} must be an object`);
+      continue;
     }
     
-    if (!domain.patterns || !Array.isArray(domain.patterns)) {
-      errors.push(`Domain '${domain.name}' must have 'patterns' array`);
+    if (!domain.match || !Array.isArray(domain.match)) {
+      errors.push(`domains.${key} must have a 'match' array`);
     } else {
-      for (const pattern of domain.patterns) {
+      for (const pattern of domain.match) {
         if (typeof pattern !== "string") {
-          errors.push(`Invalid pattern in domain '${domain.name}': ${pattern}`);
+          errors.push(`Invalid pattern in domains.${key}.match: ${pattern}`);
         }
       }
     }
     
     if (domain.description && typeof domain.description !== "string") {
-      errors.push(`Domain '${domain.name}' description must be a string`);
+      errors.push(`domains.${key}.description must be a string`);
     }
   }
   
@@ -319,17 +320,25 @@ function checkForInjection(config) {
     });
   }
   
-  // Check domain patterns
-  if (config.domains && Array.isArray(config.domains)) {
-    config.domains.forEach((domain, i) => {
-      if (domain.patterns && Array.isArray(domain.patterns)) {
-        domain.patterns.forEach((pattern, j) => {
+  if (config.scan?.ignore && Array.isArray(config.scan.ignore)) {
+    config.scan.ignore.forEach((pattern, i) => {
+      if (typeof pattern === "string") {
+        checkString(pattern, `scan.ignore[${i}]`);
+      }
+    });
+  }
+  
+  // Check domain patterns (object format: { key: { match: [] } })
+  if (config.domains && typeof config.domains === "object" && !Array.isArray(config.domains)) {
+    for (const [domainKey, domain] of Object.entries(config.domains)) {
+      if (domain.match && Array.isArray(domain.match)) {
+        domain.match.forEach((pattern, j) => {
           if (typeof pattern === "string") {
-            checkString(pattern, `domains[${i}].patterns[${j}]`);
+            checkString(pattern, `domains.${domainKey}.match[${j}]`);
           }
         });
       }
-    });
+    }
   }
   
   return errors;