@chappibunny/repolens 1.8.2 → 1.9.1

package/README.md

@@ -17,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.8.1
+> Stable as of v1.0 — [API guarantees](STABILITY.md) · [Security hardened](SECURITY.md) · v1.9.0
 
 ---
 
@@ -29,6 +29,14 @@ RepoLens scans your repository, generates living architecture documentation, and
 
 ▶️ *Click to watch on YouTube*
 
+<details>
+<summary>🔍 <strong>Supported Languages</strong> (16 auto-detected)</summary>
+
+`JavaScript` `TypeScript` `Python` `Go` `Rust` `Java` `C` `C++` `C#` `Ruby` `PHP` `Swift` `Kotlin` `Scala` `Shell` `SQL`
+
+Plus framework detection: **Django** · **FastAPI** · **Flask** · **Gin** · **Echo** · **Fiber** · **Actix** · **Rocket** — and all major JS frameworks (React, Next.js, Vue, Angular, Express, NestJS, Svelte, etc.)
+</details>
+
 ---
 
 ## 🚀 Quick Start (60 seconds)

package/package.json

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

package/src/cli.js

@@ -21,7 +21,7 @@ import { upsertPrComment } from "./delivery/comment.js";
 import { runInit } from "./init.js";
 import { runMigrate } from "./migrate.js";
 import { runWatch } from "./watch.js";
-import { info, error, warn } from "./utils/logger.js";
+import { info, error, warn, fmt } from "./utils/logger.js";
 import { formatError } from "./utils/errors.js";
 import { checkForUpdates } from "./utils/update-check.js";
 import { generateDocumentSet } from "./docs/generate-doc-set.js";
@@ -520,23 +520,25 @@ async function main() {
       info("\nTo publish to Notion, Confluence, or GitHub Wiki, run: repolens publish");
       
       if (aiAutoEnabled) {
-        info("\n🤖 AI-enhanced docs were generated using GitHub Models (free tier)");
+        info(`\n🤖 AI-enhanced docs were generated using ${fmt.boldGreen("GitHub Models (FREE)")}`);
         info("   To keep AI enabled permanently, run: repolens init --interactive");
       } else if (!cfg.ai?.enabled && process.env.REPOLENS_AI_ENABLED !== "true") {
-        info("\n─────────────────────────────────────────────────────────────────");
-        info("💡 Your docs are missing AI-enhanced sections:");
-        info("   • Executive Summary — plain language overview for leadership");
-        info("   • Business Domains — what the system does for stakeholders");
-        info("   • Architecture Overview — deeper narrative for architects");
-        info("   • Data Flows — how information moves through your system");
-        info("   • Developer Onboarding — getting started guide for new hires");
-        info("");
-        info("   To enable for FREE with GitHub Models:");
-        info("     export GITHUB_TOKEN=<your-token>");
-        info("     repolens demo");
-        info("");
-        info("   Or run: repolens init --interactive → select GitHub Models");
-        info("─────────────────────────────────────────────────────────────────");
+        info(`\n${fmt.cyan("┌──────────────────────────────────────────────────────────────────┐")}`);
+        info(`${fmt.cyan("│")} ${fmt.boldYellow("✨ Unlock AI-Enhanced Documentation")}                             ${fmt.cyan("│")}`);
+        info(`${fmt.cyan("├──────────────────────────────────────────────────────────────────┤")}`);
+        info(`${fmt.cyan("│")} Your docs are missing these AI-powered sections:                ${fmt.cyan("│")}`);
+        info(`${fmt.cyan("│")}   ${fmt.yellow("•")} Executive Summary — plain language overview for leadership   ${fmt.cyan("│")}`);
+        info(`${fmt.cyan("│")}   ${fmt.yellow("•")} Business Domains — what the system does for stakeholders    ${fmt.cyan("│")}`);
+        info(`${fmt.cyan("│")}   ${fmt.yellow("•")} Architecture Overview — deeper narrative for architects     ${fmt.cyan("│")}`);
+        info(`${fmt.cyan("│")}   ${fmt.yellow("•")} Data Flows — how information moves through your system      ${fmt.cyan("│")}`);
+        info(`${fmt.cyan("│")}   ${fmt.yellow("•")} Developer Onboarding — getting started guide for new hires  ${fmt.cyan("│")}`);
+        info(`${fmt.cyan("│")}                                                                  ${fmt.cyan("│")}`);
+        info(`${fmt.cyan("│")} ${fmt.boldGreen("🆓 Enable for FREE with GitHub Models:")}                          ${fmt.cyan("│")}`);
+        info(`${fmt.cyan("│")}   ${fmt.green("export GITHUB_TOKEN=<your-token>")}                            ${fmt.cyan("│")}`);
+        info(`${fmt.cyan("│")}   ${fmt.green("repolens demo")}                                               ${fmt.cyan("│")}`);
+        info(`${fmt.cyan("│")}                                                                  ${fmt.cyan("│")}`);
+        info(`${fmt.cyan("│")} Or run: ${fmt.brightCyan("repolens init --interactive")} → select GitHub Models      ${fmt.cyan("│")}`);
+        info(`${fmt.cyan("└──────────────────────────────────────────────────────────────────┘")}`);
       }
       
       printPerformanceSummary();

package/src/core/scan.js

@@ -136,7 +136,70 @@ function routePathFromFile(file) {
   return file;
 }
 
-async function extractRepoMetadata(repoRoot) {
+/**
+ * Detect languages from file extensions
+ */
+function detectLanguagesFromFiles(files) {
+  const languages = new Set();
+  
+  // Extension to language mapping
+  const extensionMap = {
+    // JavaScript/TypeScript
+    ".js": "JavaScript",
+    ".mjs": "JavaScript",
+    ".cjs": "JavaScript",
+    ".jsx": "JavaScript",
+    ".ts": "TypeScript",
+    ".tsx": "TypeScript",
+    // Python
+    ".py": "Python",
+    ".pyw": "Python",
+    ".pyi": "Python",
+    // Go
+    ".go": "Go",
+    // Rust
+    ".rs": "Rust",
+    // Java
+    ".java": "Java",
+    // C/C++
+    ".c": "C",
+    ".h": "C",
+    ".cpp": "C++",
+    ".hpp": "C++",
+    ".cc": "C++",
+    ".cxx": "C++",
+    // C#
+    ".cs": "C#",
+    // Ruby
+    ".rb": "Ruby",
+    // PHP
+    ".php": "PHP",
+    // Swift
+    ".swift": "Swift",
+    // Kotlin
+    ".kt": "Kotlin",
+    ".kts": "Kotlin",
+    // Scala
+    ".scala": "Scala",
+    // Shell
+    ".sh": "Shell",
+    ".bash": "Shell",
+    ".zsh": "Shell",
+    // SQL
+    ".sql": "SQL",
+  };
+
+  for (const file of files) {
+    const ext = path.extname(file).toLowerCase();
+    if (extensionMap[ext]) {
+      languages.add(extensionMap[ext]);
+    }
+  }
+
+  return languages;
+}
+
+async function extractRepoMetadata(repoRoot, files = []) {
   const metadata = {
     hasPackageJson: false,
     frameworks: [],
@@ -191,12 +254,9 @@ async function extractRepoMetadata(repoRoot) {
     if (allDeps["swc"] || allDeps["@swc/core"]) metadata.buildTools.push("SWC");
     if (allDeps["parcel"]) metadata.buildTools.push("Parcel");
 
-    // Detect languages
+    // Detect TypeScript from dependencies (supplements file detection)
     if (allDeps["typescript"]) metadata.languages.add("TypeScript");
 
-    // Infer JavaScript if package.json exists (any npm project uses JS/Node)
-    metadata.languages.add("JavaScript");
-
     // Detect Node.js runtime indicators
     const hasNodeEngines = pkg.engines && pkg.engines.node;
     const hasBin = pkg.bin != null;
@@ -210,6 +270,82 @@ async function extractRepoMetadata(repoRoot) {
     // No package.json or invalid JSON
   }
 
+  // Detect Python frameworks and tools
+  try {
+    // Check for pyproject.toml (modern Python)
+    const pyprojectPath = path.join(repoRoot, "pyproject.toml");
+    const pyprojectContent = await fs.readFile(pyprojectPath, "utf8");
+    metadata.languages.add("Python");
+    
+    // Detect Python frameworks from pyproject.toml
+    if (/django/i.test(pyprojectContent)) metadata.frameworks.push("Django");
+    if (/fastapi/i.test(pyprojectContent)) metadata.frameworks.push("FastAPI");
+    if (/flask/i.test(pyprojectContent)) metadata.frameworks.push("Flask");
+    if (/pytest/i.test(pyprojectContent)) metadata.testFrameworks.push("pytest");
+    if (/poetry/i.test(pyprojectContent)) metadata.buildTools.push("Poetry");
+  } catch {
+    // No pyproject.toml
+  }
+
+  try {
+    // Check for requirements.txt
+    const reqPath = path.join(repoRoot, "requirements.txt");
+    const reqContent = await fs.readFile(reqPath, "utf8");
+    metadata.languages.add("Python");
+    
+    if (/django/i.test(reqContent)) metadata.frameworks.push("Django");
+    if (/fastapi/i.test(reqContent)) metadata.frameworks.push("FastAPI");
+    if (/flask/i.test(reqContent)) metadata.frameworks.push("Flask");
+    if (/pytest/i.test(reqContent)) metadata.testFrameworks.push("pytest");
+  } catch {
+    // No requirements.txt
+  }
+
+  try {
+    // Check for setup.py (legacy Python)
+    await fs.access(path.join(repoRoot, "setup.py"));
+    metadata.languages.add("Python");
+  } catch {
+    // No setup.py
+  }
+
+  // Detect Go modules
+  try {
+    const goModPath = path.join(repoRoot, "go.mod");
+    const goModContent = await fs.readFile(goModPath, "utf8");
+    metadata.languages.add("Go");
+    
+    if (/gin-gonic/i.test(goModContent)) metadata.frameworks.push("Gin");
+    if (/echo/i.test(goModContent)) metadata.frameworks.push("Echo");
+    if (/fiber/i.test(goModContent)) metadata.frameworks.push("Fiber");
+  } catch {
+    // No go.mod
+  }
+
+  // Detect Rust via Cargo.toml
+  try {
+    const cargoPath = path.join(repoRoot, "Cargo.toml");
+    const cargoContent = await fs.readFile(cargoPath, "utf8");
+    metadata.languages.add("Rust");
+    
+    if (/actix/i.test(cargoContent)) metadata.frameworks.push("Actix");
+    if (/rocket/i.test(cargoContent)) metadata.frameworks.push("Rocket");
+    if (/tokio/i.test(cargoContent)) metadata.frameworks.push("Tokio");
+  } catch {
+    // No Cargo.toml
+  }
+
+  // Merge languages detected from file extensions
+  const fileLanguages = detectLanguagesFromFiles(files);
+  for (const lang of fileLanguages) {
+    metadata.languages.add(lang);
+  }
+
+  // De-duplicate frameworks (in case detected from multiple sources)
+  metadata.frameworks = [...new Set(metadata.frameworks)];
+  metadata.testFrameworks = [...new Set(metadata.testFrameworks)];
+  metadata.buildTools = [...new Set(metadata.buildTools)];
+
   return metadata;
 }
 
@@ -435,8 +571,8 @@ export async function scanRepo(cfg) {
     }
   }
 
-  // Extract repository metadata
-  const metadata = await extractRepoMetadata(repoRoot);
+  // Extract repository metadata (pass files for language detection)
+  const metadata = await extractRepoMetadata(repoRoot, files);
 
   // Detect external API integrations
   const externalApis = await detectExternalApis(files, repoRoot);

package/src/utils/logger.js

@@ -3,6 +3,53 @@ import { sanitizeSecrets } from "./secrets.js";
 const isVerbose = process.argv.includes("--verbose");
 const isTest = process.env.NODE_ENV === "test";
 
+// Terminal color support detection
+const supportsColor = !process.env.NO_COLOR && 
+  (process.env.FORCE_COLOR || 
+   (process.stdout.isTTY && process.env.TERM !== "dumb"));
+
+// ANSI color codes
+const colors = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  cyan: "\x1b[36m",
+  magenta: "\x1b[35m",
+  brightGreen: "\x1b[92m",
+  brightCyan: "\x1b[96m",
+  brightYellow: "\x1b[93m",
+};
+
+/**
+ * Apply color formatting to text (respects NO_COLOR)
+ */
+export function colorize(text, ...styles) {
+  if (!supportsColor) return text;
+  const codes = styles.map(s => colors[s] || "").join("");
+  return `${codes}${text}${colors.reset}`;
+}
+
+/**
+ * Shorthand color helpers
+ */
+export const fmt = {
+  bold: (text) => colorize(text, "bold"),
+  green: (text) => colorize(text, "green"),
+  brightGreen: (text) => colorize(text, "brightGreen"),
+  cyan: (text) => colorize(text, "cyan"),
+  brightCyan: (text) => colorize(text, "brightCyan"),
+  yellow: (text) => colorize(text, "yellow"),
+  brightYellow: (text) => colorize(text, "brightYellow"),
+  magenta: (text) => colorize(text, "magenta"),
+  dim: (text) => colorize(text, "dim"),
+  // Combined styles
+  boldGreen: (text) => colorize(text, "bold", "brightGreen"),
+  boldCyan: (text) => colorize(text, "bold", "brightCyan"),
+  boldYellow: (text) => colorize(text, "bold", "brightYellow"),
+};
+
 /**
  * Sanitize arguments for logging
  */