@chappibunny/repolens 0.4.3 → 0.6.2

package/src/core/scan.js

@@ -2,6 +2,7 @@ import fg from "fast-glob";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { info, warn } from "../utils/logger.js";
+import { trackScan } from "../utils/telemetry.js";
 
 const norm = (p) => p.replace(/\\/g, "/");
 
@@ -17,6 +18,25 @@ function isNextRoute(file) {
   );
 }
 
+function isExpressRoute(content) {
+  // Detect Express.js route patterns
+  const expressPatterns = [
+    /(?:app|router)\.(get|post|put|patch|delete|all)\s*\(\s*['"`]([^'"`]+)['"`]/gi,
+    /(?:app|router)\.route\s*\(\s*['"`]([^'"`]+)['"`]/gi
+  ];
+  return expressPatterns.some(pattern => pattern.test(content));
+}
+
+function isReactRouterFile(content) {
+  // Detect React Router patterns
+  return content.includes("<Route") || content.includes("createBrowserRouter") || content.includes("createRoutesFromElements");
+}
+
+function isVueRouterFile(content) {
+  // Detect Vue Router patterns  
+  return (content.includes("createRouter") || content.includes("VueRouter")) && content.includes("routes");
+}
+
 function isNextPage(file) {
   const f = norm(file);
 
@@ -162,6 +182,113 @@ async function extractRepoMetadata(repoRoot) {
   return metadata;
 }
 
+function extractExpressRoutes(content) {
+  const routes = [];
+  const seenRoutes = new Set();
+
+  // Match app.METHOD(path) or router.METHOD(path)
+  const methodPattern = /(?:app|router)\.(get|post|put|patch|delete|all)\s*\(\s*['"`]([^'"`]+)['"`]/gi;
+  let match;
+
+  while ((match = methodPattern.exec(content)) !== null) {
+    const [, method, path] = match;
+    const routeKey = `${method.toUpperCase()}:${path}`;
+    
+    if (!seenRoutes.has(routeKey)) {
+      seenRoutes.add(routeKey);
+      
+     const existing = routes.find(r => r.path === path);
+      if (existing) {
+        if (!existing.methods.includes(method.toUpperCase())) {
+          existing.methods.push(method.toUpperCase());
+}
+      } else {
+        routes.push({
+          path,
+          methods: [method.toUpperCase()]
+        });
+      }
+    }
+  }
+
+  // Match app.route(path).METHOD()
+  const routePattern = /(?:app|router)\.route\s*\(\s*['"`]([^'"`]+)['"`]\s*\)([.\s\w()]*)/gi;
+  while ((match = routePattern.exec(content)) !== null) {
+    const [, path, chain] = match;
+    const methods = [];
+    
+    if (chain.includes(".get(")) methods.push("GET");
+    if (chain.includes(".post(")) methods.push("POST");
+    if (chain.includes(".put(")) methods.push("PUT");
+    if (chain.includes(".patch(")) methods.push("PATCH");
+    if (chain.includes(".delete(")) methods.push("DELETE");
+    
+    if (methods.length > 0) {
+      const existing = routes.find(r => r.path === path);
+      if (existing) {
+        methods.forEach(m => {
+          if (!existing.methods.includes(m)) existing.methods.push(m);
+        });
+      } else {
+        routes.push({ path, methods });
+      }
+    }
+  }
+
+  return routes;
+}
+
+function extractReactRoutes(content, file) {
+  const routes = [];
+  
+  // Match <Route path="..." />
+  const routePattern = /<Route\s+[^>]*path\s*=\s*['"`]([^'"`]+)['"`][^>]*\/?>/gi;
+  let match;
+
+  while ((match = routePattern.exec(content)) !== null) {
+    const [, path] = match;
+    routes.push({
+      file,
+      path,
+      framework: "React Router"
+    });
+  }
+
+  // Match path: "..." in route objects  
+  const objectPattern = /path\s*:\s*['"`]([^'"`]+)['"`]/gi;
+  while ((match = objectPattern.exec(content)) !== null) {
+    const [, path] = match;
+    if (!routes.some(r => r.path === path)) {
+      routes.push({
+        file,
+        path,
+        framework: "React Router"
+      });
+    }
+  }
+
+  return routes;
+}
+
+function extractVueRoutes(content, file) {
+  const routes = [];
+  
+  // Match path: '...' or path: "..." in Vue router definitions
+  const pathPattern = /path\s*:\s*['"`]([^'"`]+)['"`]/gi;
+  let match;
+
+  while ((match = pathPattern.exec(content)) !== null) {
+    const [, path] = match;
+    routes.push({
+      file,
+      path,
+      framework: "Vue Router"
+    });
+  }
+
+  return routes;
+}
+
 export async function scanRepo(cfg) {
   const repoRoot = cfg.__repoRoot;
 
@@ -197,6 +324,7 @@ export async function scanRepo(cfg) {
   const apiFiles = files.filter(isNextRoute);
   const api = [];
 
+  // Extract Next.js API routes
   for (const file of apiFiles) {
     const absoluteFile = path.join(repoRoot, file);
     const content = await readFileSafe(absoluteFile);
@@ -211,23 +339,71 @@ export async function scanRepo(cfg) {
     api.push({
       file,
       path: routePathFromFile(file),
-      methods: methods.length ? methods : ["UNKNOWN"]
+      methods: methods.length ? methods : ["UNKNOWN"],
+      framework: "Next.js"
     });
   }
 
+  // Extract Express.js routes
+  for (const file of files) {
+    if (file.endsWith(".ts") || file.endsWith(".js")) {
+      const absoluteFile = path.join(repoRoot, file);
+      const content = await readFileSafe(absoluteFile);
+      
+      if (isExpressRoute(content)) {
+        const expressRoutes = extractExpressRoutes(content);
+        for (const route of expressRoutes) {
+          api.push({
+            file,
+            path: route.path,
+            methods: route.methods,
+            framework: "Express"
+          });
+        }
+      }
+    }
+  }
+
   const pageFiles = files.filter(isNextPage);
   const pages = pageFiles.map((file) => ({
     file,
-    path: routePathFromFile(file)
+    path: routePathFromFile(file),
+    framework: "Next.js"
   }));
 
+  // Extract React Router routes
+  for (const file of files) {
+    if (file.endsWith(".tsx") || file.endsWith(".jsx")) {
+      const absoluteFile = path.join(repoRoot, file);
+      const content = await readFileSafe(absoluteFile);
+      
+      if (isReactRouterFile(content)) {
+        const reactRoutes = extractReactRoutes(content, file);
+        pages.push(...reactRoutes);
+      }
+    }
+  }
+
+  // Extract Vue Router routes
+  for (const file of files) {
+    if (file.endsWith(".ts") || file.endsWith(".js") || file.endsWith(".vue")) {
+      const absoluteFile = path.join(repoRoot, file);
+      const content = await readFileSafe(absoluteFile);
+      
+      if (isVueRouterFile(content)) {
+        const vueRoutes = extractVueRoutes(content, file);
+        pages.push(...vueRoutes);
+      }
+    }
+  }
+
   // Extract repository metadata
   const metadata = await extractRepoMetadata(repoRoot);
 
   // Detect external API integrations
   const externalApis = await detectExternalApis(files, repoRoot);
 
-  return {
+  const scanResult = {
     filesCount: files.length,
     modules,
     api,
@@ -235,6 +411,11 @@ export async function scanRepo(cfg) {
     metadata,
     externalApis
   };
+  
+  // Track scan metrics
+  trackScan(scanResult);
+  
+  return scanResult;
 }
 
 async function detectExternalApis(files, repoRoot) {

package/src/init.js

@@ -46,6 +46,11 @@ jobs:
         env:
           NOTION_TOKEN: \${{ secrets.NOTION_TOKEN }}
           NOTION_PARENT_PAGE_ID: \${{ secrets.NOTION_PARENT_PAGE_ID }}
+          CONFLUENCE_URL: \${{ secrets.CONFLUENCE_URL }}
+          CONFLUENCE_EMAIL: \${{ secrets.CONFLUENCE_EMAIL }}
+          CONFLUENCE_API_TOKEN: \${{ secrets.CONFLUENCE_API_TOKEN }}
+          CONFLUENCE_SPACE_KEY: \${{ secrets.CONFLUENCE_SPACE_KEY }}
+          CONFLUENCE_PARENT_PAGE_ID: \${{ secrets.CONFLUENCE_PARENT_PAGE_ID }}
         run: npx @chappibunny/repolens@latest publish
 `;
 
@@ -54,6 +59,13 @@ NOTION_TOKEN=
 NOTION_PARENT_PAGE_ID=
 NOTION_VERSION=2022-06-28
 
+# Confluence Publishing
+CONFLUENCE_URL=https://your-company.atlassian.net/wiki
+CONFLUENCE_EMAIL=your@email.com
+CONFLUENCE_API_TOKEN=
+CONFLUENCE_SPACE_KEY=DOCS
+CONFLUENCE_PARENT_PAGE_ID=
+
 # AI-Assisted Documentation (Optional)
 # Enable AI features for natural language explanations
 # REPOLENS_AI_ENABLED=true
@@ -66,7 +78,7 @@ NOTION_VERSION=2022-06-28
 
 const DEFAULT_REPOLENS_README = `# RepoLens Documentation
 
-This repository is configured to use [RepoLens](https://github.com/CHAPIBUNNY/repolens) for automatic architecture documentation.
+This repository is configured to use [RepoLens](https://github.com/CHAPIBUNNY/repolens) (@chappibunny/repolens) for automatic architecture documentation.
 
 ## 📋 What RepoLens Created
 
@@ -93,14 +105,37 @@ If you configured Notion credentials during setup, documentation will publish au
    - \`NOTION_TOKEN\` — Get from https://www.notion.so/my-integrations
    - \`NOTION_PARENT_PAGE_ID\` — The page where docs will be published
 
+### Confluence Publishing
+
+To publish documentation to Atlassian Confluence:
+
+1. Copy \`.env.example\` to \`.env\`
+2. Generate an API token: https://id.atlassian.com/manage-profile/security/api-tokens
+3. Add your credentials:
+   - \`CONFLUENCE_URL\` — Your Confluence base URL (e.g., https://your-company.atlassian.net/wiki)
+   - \`CONFLUENCE_EMAIL\` — Your Atlassian account email
+   - \`CONFLUENCE_API_TOKEN\` — API token from step 2
+   - \`CONFLUENCE_SPACE_KEY\` — Space key (e.g., DOCS, ENG)
+   - \`CONFLUENCE_PARENT_PAGE_ID\` — (Optional) Parent page ID for nested docs
+
 ### GitHub Actions
 
 For automated publishing on every push:
 
 1. Go to repository Settings → Secrets → Actions
-2. Add secrets:
+2. Add secrets for your chosen publisher(s):
+   
+   **For Notion:**
    - \`NOTION_TOKEN\`
    - \`NOTION_PARENT_PAGE_ID\`
+   
+   **For Confluence:**
+   - \`CONFLUENCE_URL\`
+   - \`CONFLUENCE_EMAIL\`
+   - \`CONFLUENCE_API_TOKEN\`
+   - \`CONFLUENCE_SPACE_KEY\`
+   - \`CONFLUENCE_PARENT_PAGE_ID\` (optional)
+
 3. Push to main branch
 
 ## 📊 Generated Documentation
@@ -243,8 +278,9 @@ function buildRepoLensConfig(projectName, detectedRoots) {
     `  docs_title_prefix: "RepoLens"`,
     ``,
     `publishers:`,
-    `  - markdown  # Always generate local Markdown files`,
-    `  - notion    # Auto-detected: publishes if NOTION_TOKEN is set`,
+    `  - markdown    # Always generate local Markdown files`,
+    `  - notion      # Auto-detected: publishes if NOTION_TOKEN is set`,
+    `  - confluence  # Auto-detected: publishes if CONFLUENCE_URL is set`,
     ``,
     `# Optional: Configure Notion publishing behavior`,
     `# notion:`,
@@ -253,6 +289,12 @@ function buildRepoLensConfig(projectName, detectedRoots) {
     `#     - staging     # Or add specific branches`,
     `#   includeBranchInTitle: false  # Clean titles without [branch-name]`,
     ``,
+    `# Optional: Configure Confluence publishing behavior`,
+    `# confluence:`,
+    `#   branches:`,
+    `#     - main        # Only publish from main branch`,
+    `#     - develop     # Or add specific branches`,
+    ``,
     `# Optional: GitHub integration for SVG diagram hosting`,
     `# github:`,
     `#   owner: "your-username"`,

package/src/integrations/discord.js

@@ -0,0 +1,261 @@
+/**
+ * Discord Integration for RepoLens
+ * Sends rich embed notifications to Discord channels via webhooks
+ */
+
+import fetch from "node-fetch";
+import { info, warn, error } from "../utils/logger.js";
+
+/**
+ * Send a notification to Discord webhook
+ * @param {string} webhookUrl - Discord webhook URL
+ * @param {object} payload - Notification payload
+ * @returns {Promise<boolean>} - Success status
+ */
+export async function sendDiscordNotification(webhookUrl, payload) {
+  if (!webhookUrl) {
+    warn("Discord webhook URL not configured, skipping notification");
+    return false;
+  }
+
+  try {
+    const embed = buildEmbed(payload);
+    const body = {
+      username: "RepoLens",
+      avatar_url: "https://raw.githubusercontent.com/CHAPIBUNNY/repolens/main/.github/repolens-icon.png",
+      embeds: [embed],
+    };
+
+    const response = await fetch(webhookUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+    });
+
+    if (!response.ok) {
+      const text = await response.text();
+      error(`Discord webhook failed (${response.status}): ${text}`);
+      return false;
+    }
+
+    info("✓ Discord notification sent");
+    return true;
+  } catch (err) {
+    error(`Discord notification failed: ${err.message}`);
+    return false;
+  }
+}
+
+/**
+ * Build Discord embed from payload
+ * @param {object} payload - Notification data
+ * @returns {object} - Discord embed object
+ */
+function buildEmbed(payload) {
+  const {
+    title,
+    description,
+    color,
+    fields = [],
+    timestamp = new Date().toISOString(),
+    footer,
+    url,
+  } = payload;
+
+  // Color mapping: success (green), warning (yellow), error (red), info (blue)
+  const colorMap = {
+    success: 0x27ae60,
+    warning: 0xf39c12,
+    error: 0xe74c3c,
+    info: 0x3498db,
+  };
+
+  return {
+    title: title || "RABITAI Documentation Updated",
+    description: description || "Documentation has been regenerated",
+    color: typeof color === "string" ? colorMap[color] || colorMap.info : color || colorMap.info,
+    fields: fields.map((field) => ({
+      name: field.name,
+      value: field.value,
+      inline: field.inline !== false, // Default to inline
+    })),
+    timestamp,
+    footer: footer
+      ? { text: footer }
+      : { text: "RABITAI 🐰" },
+    url: url || undefined,
+  };
+}
+
+/**
+ * Build documentation update notification
+ * @param {object} options - Notification options
+ * @returns {object} - Notification payload
+ */
+export function buildDocUpdateNotification(options) {
+  const {
+    branch,
+    commitSha,
+    commitMessage,
+    filesScanned,
+    modulesDetected,
+    coverage,
+    notionUrl,
+    changePercent,
+  } = options;
+
+  const fields = [];
+
+  // Branch and commit
+  if (branch) {
+    fields.push({
+      name: "📌 Branch",
+      value: `\`${branch}\``,
+      inline: true,
+    });
+  }
+
+  if (commitSha) {
+    fields.push({
+      name: "🔖 Commit",
+      value: `\`${commitSha.substring(0, 7)}\``,
+      inline: true,
+    });
+  }
+
+  // Repository stats
+  if (filesScanned !== undefined) {
+    fields.push({
+      name: "📁 Files Scanned",
+      value: filesScanned.toLocaleString(),
+      inline: true,
+    });
+  }
+
+  if (modulesDetected !== undefined) {
+    fields.push({
+      name: "📦 Modules Detected",
+      value: modulesDetected.toLocaleString(),
+      inline: true,
+    });
+  }
+
+  // Coverage
+  if (coverage !== undefined) {
+    const coverageEmoji = coverage >= 80 ? "🟢" : coverage >= 60 ? "🟡" : "🔴";
+    fields.push({
+      name: `${coverageEmoji} Coverage`,
+      value: `${coverage.toFixed(1)}%`,
+      inline: true,
+    });
+  }
+
+  // Change percent
+  if (changePercent !== undefined) {
+    const changeEmoji = changePercent >= 20 ? "⚠️" : "📊";
+    fields.push({
+      name: `${changeEmoji} Changes`,
+      value: `${changePercent.toFixed(1)}%`,
+      inline: true,
+    });
+  }
+
+  // Links
+  const links = [];
+  if (notionUrl) {
+    links.push(`[📚 Notion Docs](${notionUrl})`);
+  }
+
+  if (links.length > 0) {
+    fields.push({
+      name: "🔗 Quick Links",
+      value: links.join(" • "),
+      inline: false,
+    });
+  }
+
+  // Determine color based on change magnitude
+  let color = "success";
+  if (changePercent !== undefined) {
+    if (changePercent >= 20) {
+      color = "warning";
+    } else if (changePercent >= 50) {
+      color = "error";
+    }
+  }
+
+  return {
+    title: "📐 Documentation Updated",
+    description: commitMessage
+      ? `*${commitMessage.split("\n")[0].substring(0, 100)}${commitMessage.length > 100 ? "..." : ""}*`
+      : "Architecture documentation has been regenerated",
+    color,
+    fields,
+  };
+}
+
+/**
+ * Build error notification
+ * @param {object} options - Error options
+ * @returns {object} - Notification payload
+ */
+export function buildErrorNotification(options) {
+  const { errorMessage, command, branch, commitSha } = options;
+
+  const fields = [];
+
+  if (command) {
+    fields.push({
+      name: "⚙️ Command",
+      value: `\`${command}\``,
+      inline: true,
+    });
+  }
+
+  if (branch) {
+    fields.push({
+      name: "📌 Branch",
+      value: `\`${branch}\``,
+      inline: true,
+    });
+  }
+
+  if (commitSha) {
+    fields.push({
+      name: "🔖 Commit",
+      value: `\`${commitSha.substring(0, 7)}\``,
+      inline: true,
+    });
+  }
+
+  if (errorMessage) {
+    fields.push({
+      name: "❌ Error",
+      value: `\`\`\`${errorMessage.substring(0, 500)}\`\`\``,
+      inline: false,
+    });
+  }
+
+  return {
+    title: "🚨 RABITAI Error",
+    description: "Documentation generation failed",
+    color: "error",
+    fields,
+  };
+}
+
+/**
+ * Should send notification based on change threshold
+ * @param {number} changePercent - Percentage of changes
+ * @param {string} notifyOn - Notification policy (always, significant, never)
+ * @param {number} significantThreshold - Threshold for significant changes (default: 10)
+ * @returns {boolean} - Whether to send notification
+ */
+export function shouldNotify(changePercent, notifyOn = "significant", significantThreshold = 10) {
+  if (notifyOn === "always") return true;
+  if (notifyOn === "never") return false;
+  if (notifyOn === "significant") {
+    return changePercent === undefined || changePercent >= significantThreshold;
+  }
+  return false;
+}

package/src/migrate.js

@@ -1,6 +1,7 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 import { info, warn, error as logError } from "./utils/logger.js";
+import { trackMigration } from "./utils/telemetry.js";
 
 /**
  * Detect legacy workflow patterns that need migration
@@ -242,6 +243,12 @@ export async function runMigrate(targetDir = process.cwd(), options = {}) {
     } else {
       console.log("\n✨ All workflows are up to date!");
     }
+    
+    // Track migration metrics
+    trackMigration(migratedCount, skippedCount);
+    
+    // Return results for telemetry tracking
+    return { migratedCount, skippedCount };
 
   } catch (err) {
     logError(`Migration failed: ${err.message}`);