@chappibunny/repolens 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to RepoLens will be documented in this file.
 
+## 1.3.0
+
+### ✨ New Feature: `repolens demo`
+
+- **Zero-config local preview**: New `demo` command generates documentation locally without any API keys or publisher configuration. Works on any repository, even without a `.repolens.yml` — uses sensible default scan patterns.
+- **Instant onboarding**: Run `npx @chappibunny/repolens demo` on any repo to see what RepoLens generates. Output written to `.repolens/` directory.
+- **Config-aware**: If a `.repolens.yml` exists, demo uses it. Otherwise, defaults to scanning common source patterns (`js`, `ts`, `py`, `go`, `rs`, `java`, etc.) with standard ignore paths.
+
+### 📝 Documentation
+
+- Added demo command to all documentation: README, STABILITY, ROADMAP, copilot-instructions
+- Added "Quick Preview" section to README usage guide
+- Updated all version references to 1.3.0
+
 ## 1.2.0
 
 ### ✨ Config Migration

package/README.md

@@ -16,7 +16,7 @@
 
 AI-assisted documentation intelligence system that generates architecture docs for engineers AND readable system docs for stakeholders
 
-**Current Status**: v1.2.0 — Stable Release
+**Current Status**: v1.3.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.
 
@@ -230,7 +230,7 @@ npm link
 Install from a specific version:
 
 ```bash
-npm install https://github.com/CHAPIBUNNY/repolens/releases/download/v1.2.0/chappibunny-repolens-1.2.0.tgz
+npm install https://github.com/CHAPIBUNNY/repolens/releases/download/v1.3.0/chappibunny-repolens-1.3.0.tgz
 ```
 </details>
 
@@ -656,6 +656,15 @@ Error: Process completed with exit code 1.
 
 See [MIGRATION.md](MIGRATION.md) for detailed upgrade guide.
 
+### Quick Preview (No API Keys)
+
+Generate local documentation instantly — no Notion, Confluence, or GitHub tokens needed:
+```bash
+npx @chappibunny/repolens demo
+```
+
+Works on any repo, even without a `.repolens.yml`. Output is written to `.repolens/`.
+
 ### Get Help
 
 ```bash
@@ -1106,7 +1115,7 @@ Simulates the full user installation experience:
 npm pack
 
 # Install globally from tarball
-npm install -g chappibunny-repolens-1.2.0.tgz
+npm install -g chappibunny-repolens-1.3.0.tgz
 
 # Verify
 repolens --version
@@ -1230,11 +1239,11 @@ See [RELEASE.md](./RELEASE.md) for detailed workflow.
 
 ## 🗺️ Roadmap
 
-**Current Status:** v1.2.0 — Stable Release
+**Current Status:** v1.3.0 — Stable Release
 
 ### v1.0 — Complete ✅
 
-- [x] CLI commands: `init`, `doctor`, `publish`, `migrate`, `watch`, `feedback`, `version`, `help`
+- [x] CLI commands: `init`, `doctor`, `publish`, `demo`, `migrate`, `watch`, `feedback`, `version`, `help`
 - [x] Config schema v1 with validation (frozen)
 - [x] Auto-discovery of `.repolens.yml`
 - [x] Publishers: Notion + Confluence + GitHub Wiki + Markdown

package/package.json

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

package/src/cli.js

@@ -143,6 +143,7 @@ Commands:
   doctor      Validate your RepoLens setup
   migrate     Upgrade workflow files to current format
   publish     Scan, render, and publish documentation
+  demo        Generate local docs without API keys (quick preview)
   watch       Watch for file changes and regenerate docs
   feedback    Send feedback to the RepoLens team
   version     Print the current RepoLens version
@@ -166,6 +167,7 @@ Examples:
   repolens migrate --dry-run                    # Preview changes without applying
   repolens publish                              # Auto-discovers .repolens.yml
   repolens publish --config /path/.repolens.yml # Explicit config path
+  repolens demo                                  # Quick local preview (no API keys)
   repolens watch                                # Watch mode (Markdown only)
   repolens --version
 `);
@@ -424,6 +426,95 @@ async function main() {
     return;
   }
 
+  if (command === "demo") {
+    await printBanner();
+    info("Demo mode — generating local documentation (no API keys required)...");
+    
+    const commandTimer = startTimer("demo");
+    const targetDir = getArg("--target") || process.cwd();
+    
+    // Try to load existing config, otherwise use sensible defaults
+    let cfg;
+    try {
+      const configPath = getArg("--config") || await findConfig();
+      info(`Using config: ${configPath}`);
+      cfg = await loadConfig(configPath);
+    } catch {
+      info("No .repolens.yml found — using default scan patterns");
+      cfg = {
+        configVersion: 1,
+        project: { name: path.basename(targetDir) },
+        publishers: ["markdown"],
+        scan: {
+          include: ["**/*.{js,ts,jsx,tsx,mjs,cjs,py,go,rs,java,rb,php,cs,swift,kt}"],
+          ignore: ["**/node_modules/**", "**/dist/**", "**/build/**", "**/.git/**", "**/vendor/**", "**/target/**", "**/__pycache__/**"],
+        },
+        module_roots: ["src", "lib", "app", "packages"],
+        outputs: {
+          pages: [
+            { key: "system_overview", title: "System Overview" },
+            { key: "module_catalog", title: "Module Catalog" },
+            { key: "api_surface", title: "API Surface" },
+            { key: "route_map", title: "Route Map" },
+            { key: "system_map", title: "System Map" },
+            { key: "executive_summary", title: "Executive Summary" },
+            { key: "business_domains", title: "Business Domains" },
+            { key: "architecture_overview", title: "Architecture Overview" },
+            { key: "data_flows", title: "Data Flows" },
+            { key: "developer_onboarding", title: "Developer Onboarding" },
+          ],
+        },
+        __repoRoot: targetDir,
+        __configPath: path.join(targetDir, ".repolens.yml"),
+      };
+    }
+    
+    try {
+      info("Scanning repository...");
+      const scanTimer = startTimer("scan");
+      const scan = await scanRepo(cfg);
+      stopTimer(scanTimer);
+      info(`Detected ${scan.modules?.length || 0} modules, ${scan.filesCount || 0} files`);
+      
+      const rawDiff = getGitDiff("origin/main");
+      
+      info("Generating documentation set...");
+      const renderTimer = startTimer("render");
+      const docSet = await generateDocumentSet(scan, cfg, rawDiff);
+      stopTimer(renderTimer);
+      
+      info("Writing documentation to disk...");
+      const writeResult = await writeDocumentSet(docSet, targetDir);
+      
+      const totalDuration = stopTimer(commandTimer);
+      
+      info(`\n✓ Generated ${writeResult.documentCount} documents in ${writeResult.outputDir}`);
+      info("Browse your docs: open the .repolens/ directory");
+      info("\nTo publish to Notion, Confluence, or GitHub Wiki, run: repolens publish");
+      
+      printPerformanceSummary();
+      
+      trackUsage("demo", "success", {
+        duration: totalDuration,
+        fileCount: scan.filesCount || 0,
+        moduleCount: scan.modules?.length || 0,
+        documentCount: writeResult.documentCount,
+        usedConfig: Boolean(cfg.__configPath && cfg.__configPath !== path.join(targetDir, ".repolens.yml")),
+      });
+    } catch (err) {
+      stopTimer(commandTimer);
+      captureError(err, { command: "demo", targetDir });
+      trackUsage("demo", "failure");
+      error("Demo failed:");
+      error(err.message);
+      await closeTelemetry();
+      process.exit(EXIT_ERROR);
+    }
+    
+    await closeTelemetry();
+    return;
+  }
+
   if (command === "feedback") {
     await printBanner();
     info("Send feedback to the RepoLens team");
@@ -470,7 +561,7 @@ async function main() {
   }
 
   error(`Unknown command: ${command}`);
-  error("Available commands: init, doctor, migrate, publish, watch, feedback, version, help");
+  error("Available commands: init, doctor, migrate, publish, demo, watch, feedback, version, help");
   process.exit(EXIT_ERROR);
 }