@chappibunny/repolens 1.8.0 → 1.8.1

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to RepoLens will be documented in this file.
 
+## 1.8.1
+
+### 📖 Documentation Refresh
+
+- **README overhaul**: Updated test badge (379 passing), version reference (v1.8.1), document count (15 types), expanded audience table to include all 15 documents (GraphQL Schema, TypeScript Type Graph, Dependency Graph, Architecture Drift), added `uninstall` and `uninstall --force` to commands table.
+- **DEVELOPMENT.md**: Updated test coverage (379 across 22 files), expanded test suite description to cover all test categories, fixed tarball version in install example.
+- **CLI version test**: Now reads version from `package.json` dynamically instead of hardcoding — won't break on future version bumps.
+
 ## 1.8.0
 
 ### ✨ GitHub Models — First-Class AI Provider
@@ -11,6 +19,7 @@ All notable changes to RepoLens will be documented in this file.
 - **Config-driven AI settings**: `ai.enabled`, `ai.provider`, `ai.model`, `ai.temperature`, and `ai.base_url` in `.repolens.yml` are now fully respected at runtime (env vars still take precedence). Previously these config values were ignored.
 - **Init wizard fixes**: Provider selection now uses correct runtime values (`github`, `openai_compatible`, `anthropic`, `google`) instead of mismatched labels. The wizard now emits `ai.provider` to the generated YAML. Added `github_wiki` to publisher choices.
 - **Demo AI upsell**: `repolens demo` now shows a hint about GitHub Models (free) when AI is not enabled, guiding users to `repolens init --interactive`.
+- **Uninstall command**: `repolens uninstall` removes all RepoLens-generated files (`.repolens/`, `.repolens.yml`, workflow, `.env.example`, `README.repolens.md`) with confirmation prompt and `--force` flag.
 - **Doctor validation**: `repolens doctor` now checks for `GITHUB_TOKEN` when provider is `github`, and `REPOLENS_AI_API_KEY` for other providers.
 
 ### 📖 Documentation
@@ -21,8 +30,8 @@ All notable changes to RepoLens will be documented in this file.
 
 ### 🧪 Tests
 
-- 24 new tests: provider config fallbacks, `isAIEnabled` with config, `getAIConfig` with config, GitHub Models defaults, init wizard content, doctor env validation
-- **374 tests passing** across 22 test files
+- 29 new tests: provider config fallbacks, `isAIEnabled` with config, `getAIConfig` with config, GitHub Models defaults, init wizard content, doctor env validation, uninstall command (5 scenarios)
+- **379 tests passing** across 22 test files
 
 ## 1.7.1
 

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-185%20passing-brightgreen)](https://github.com/CHAPIBUNNY/repolens/actions)
+[![Tests](https://img.shields.io/badge/tests-379%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.5.0
+> Stable as of v1.0 — [API guarantees](STABILITY.md) · [Security hardened](SECURITY.md) · v1.8.1
 
 ---
 
@@ -75,13 +75,13 @@ Run `npx @chappibunny/repolens migrate` to automatically update your workflow fi
 
 ## 📋 What It Generates
 
-**11 document types** for three audiences — no manual writing required:
+**15 document types** for three audiences — no manual writing required:
 
 | Audience | Documents |
 |---|---|
 | **Stakeholders** (founders, PMs, ops) | Executive Summary · Business Domains · Data Flows |
-| **Everyone** | System Overview · Developer Onboarding · Change Impact |
-| **Engineers** | Architecture Overview · Module Catalog · API Surface · Route Map · System Map |
+| **Everyone** | System Overview · Developer Onboarding · Change Impact · Architecture Drift |
+| **Engineers** | Architecture Overview · Module Catalog · API Surface · Route Map · System Map · GraphQL Schema · TypeScript Type Graph · Dependency Graph |
 
 **Two modes:** Deterministic (free, fast, always works) or AI-Enhanced (optional — GitHub Models, OpenAI, Anthropic, Google, Azure, Ollama).
 
@@ -155,6 +155,8 @@ Step-by-step setup for publishers, AI features, Notion, Confluence, GitHub Wiki,
 | `repolens doctor` | Validate your setup |
 | `repolens watch` | Auto-regenerate docs on file changes |
 | `repolens migrate` | Upgrade from v0.3.0 workflows ([details](MIGRATION.md)) |
+| `repolens uninstall` | Remove all RepoLens files (config, docs, workflow) |
+| `repolens uninstall --force` | Remove without confirmation prompt |
 | `repolens feedback` | Send feedback to the team |
 
 ---
@@ -237,7 +239,7 @@ When you open a pull request, RepoLens posts:
 | [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 (185 across 15 files), release process |
+| [Development](DEVELOPMENT.md) | Setup, tests (379 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 |

package/package.json

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

package/src/cli.js

@@ -145,6 +145,7 @@ Commands:
   publish     Scan, render, and publish documentation
   demo        Generate local docs without API keys (quick preview)
   watch       Watch for file changes and regenerate docs
+  uninstall   Remove all RepoLens-generated files from your repository
   feedback    Send feedback to the RepoLens team
   version     Print the current RepoLens version
 
@@ -169,6 +170,8 @@ Examples:
   repolens publish --config /path/.repolens.yml # Explicit config path
   repolens demo                                  # Quick local preview (no API keys)
   repolens watch                                # Watch mode (Markdown only)
+  repolens uninstall                             # Remove all RepoLens files
+  repolens uninstall --target /tmp/my-repo       # Uninstall from specific repo
   repolens --version
 `);
 }
@@ -521,6 +524,96 @@ async function main() {
     return;
   }
 
+  if (command === "uninstall") {
+    await printBanner();
+    
+    const targetDir = getArg("--target") || process.cwd();
+    const forceFlag = process.argv.includes("--force");
+    
+    info("Scanning for RepoLens files...\n");
+    
+    // All files/directories that RepoLens creates
+    const candidates = [
+      { path: path.join(targetDir, ".repolens"),                    type: "dir",  label: ".repolens/",                     source: "demo/publish" },
+      { path: path.join(targetDir, ".repolens.yml"),                type: "file", label: ".repolens.yml",                  source: "init" },
+      { path: path.join(targetDir, ".github", "workflows", "repolens.yml"), type: "file", label: ".github/workflows/repolens.yml", source: "init" },
+      { path: path.join(targetDir, ".env.example"),                 type: "file", label: ".env.example",                   source: "init" },
+      { path: path.join(targetDir, "README.repolens.md"),           type: "file", label: "README.repolens.md",             source: "init" },
+    ];
+    
+    // Check which files exist
+    const found = [];
+    for (const item of candidates) {
+      try {
+        const stat = await fs.stat(item.path);
+        if ((item.type === "dir" && stat.isDirectory()) || (item.type === "file" && stat.isFile())) {
+          found.push(item);
+        }
+      } catch {
+        // File doesn't exist — skip
+      }
+    }
+    
+    if (found.length === 0) {
+      info("No RepoLens files found. Nothing to remove.");
+      await closeTelemetry();
+      return;
+    }
+    
+    info("Found the following RepoLens files:\n");
+    for (const item of found) {
+      const icon = item.type === "dir" ? "📁" : "📄";
+      info(`  ${icon} ${item.label}  (created by ${item.source})`);
+    }
+    
+    // Confirm unless --force
+    if (!forceFlag) {
+      const isCI = process.env.CI || process.env.GITHUB_ACTIONS;
+      const isTest = process.env.NODE_ENV === "test" || process.env.VITEST;
+      
+      if (isCI || isTest) {
+        info("\nCI/test environment detected — skipping confirmation (use --force to suppress this message).");
+      } else {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await rl.question(`\nRemove ${found.length} item${found.length === 1 ? "" : "s"}? This cannot be undone. (y/N): `);
+        rl.close();
+        
+        if (answer.trim().toLowerCase() !== "y") {
+          info("Uninstall cancelled.");
+          await closeTelemetry();
+          return;
+        }
+      }
+    }
+    
+    // Remove files
+    let removed = 0;
+    for (const item of found) {
+      try {
+        if (item.type === "dir") {
+          await fs.rm(item.path, { recursive: true, force: true });
+        } else {
+          await fs.unlink(item.path);
+        }
+        info(`  ✓ Removed ${item.label}`);
+        removed++;
+      } catch (err) {
+        error(`  ✗ Failed to remove ${item.label}: ${err.message}`);
+      }
+    }
+    
+    info(`\n✓ Removed ${removed}/${found.length} RepoLens file${found.length === 1 ? "" : "s"}.`);
+    
+    if (removed > 0) {
+      info("\nTo reinstall, run: repolens init");
+      info("To uninstall the npm package: npm uninstall @chappibunny/repolens");
+    }
+    
+    trackUsage("uninstall", "success", { removed, total: found.length });
+    await closeTelemetry();
+    return;
+  }
+
   if (command === "feedback") {
     await printBanner();
     info("Send feedback to the RepoLens team");
@@ -567,7 +660,7 @@ async function main() {
   }
 
   error(`Unknown command: ${command}`);
-  error("Available commands: init, doctor, migrate, publish, demo, watch, feedback, version, help");
+  error("Available commands: init, doctor, migrate, publish, demo, watch, uninstall, feedback, version, help");
   process.exit(EXIT_ERROR);
 }