@chappibunny/repolens 0.4.1 → 0.4.3

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to RepoLens will be documented in this file.
 
+## 0.4.3
+
+### 🐛 Bug Fixes
+- **Migration Tool**: Fixed over-aggressive npm install removal
+  - Now only removes `npm install/ci` from legacy `cd tools/repolens` multi-line blocks
+  - Preserves legitimate dependency installation steps in release workflows
+  - Fixes YAML corruption that broke workflows with standalone npm ci/install steps
+  - Added test case to verify legitimate npm install steps are preserved
+
+## 0.4.2
+
+### 🐛 Bug Fixes
+- **Migration Tool**: Fixed duplicate `run:` keys issue when adding environment variables
+  - Updated pattern to capture and preserve existing run command
+  - Properly positions `env:` block before `run:` with correct indentation
+  - Fixes GitHub Actions validation error: "'run' is already defined"
+  - Added test case to prevent regression
+
 ## 0.4.1
 
 ### ✨ New Features
@@ -21,6 +39,7 @@ All notable changes to RepoLens will be documented in this file.
 - Detects `npx repolens` without `@latest` suffix
 - Detects missing `actions/setup-node@v4` setup
 - Detects missing environment variables (NOTION_TOKEN, REPOLENS_AI_API_KEY)
+- Migrates to `@chappibunny/repolens` scoped package
 - Automatically adds AI environment variables to existing env sections
 - Skips already-migrated workflows (no-op when up to date)
 
@@ -188,7 +207,7 @@ RepoLens is no longer just a "flashy code intelligence toy" — it's now a **doc
 ### 📦 Package Changes
 - Removed test artifacts from repository (cleaner npm package)
 - Updated .gitignore to exclude test files
-- Simplified workflow template to use `npx repolens@latest`
+- Simplified workflow template to use `npx @chappibunny/repolens@latest`
 
 ## 0.2.0
 

package/README.md

@@ -27,7 +27,7 @@ npm install github:CHAPIBUNNY/repolens
 
 **Step 2: Initialize** (creates config + GitHub Actions workflow)
 ```bash
-npx repolens init
+npx @chappibunny/repolens init
 ```
 
 **Step 3: Configure Notion** (optional, skip if using Markdown only)
@@ -39,13 +39,13 @@ NOTION_PARENT_PAGE_ID=xxx
 
 **Step 4: Publish**
 ```bash
-npx repolens publish
+npx @chappibunny/repolens publish
 ```
 
 **Done!** Your docs are now live in Notion and/or `.repolens/` directory.
 
 **🔄 Upgrading from v0.3.0 or earlier?**
-Run `npx repolens migrate` to automatically update your workflow files. See [MIGRATION.md](MIGRATION.md) for details.
+Run `npx @chappibunny/repolens migrate` to automatically update your workflow files. See [MIGRATION.md](MIGRATION.md) for details.
 
 ---
 
@@ -166,7 +166,7 @@ npm install -g repolens
 Run this in your project root:
 
 ```bash
-npx repolens init
+npx @chappibunny/repolens init
 ```
 
 **What it creates:**
@@ -343,7 +343,7 @@ module_roots:
 Run locally to test:
 
 ```bash
-npx repolens publish
+npx @chappibunny/repolens publish
 ```
 
 **Expected output:**
@@ -413,12 +413,12 @@ git push
 
 Auto-discovers `.repolens.yml`:
 ```bash
-npx repolens publish
+npx @chappibunny/repolens publish
 ```
 
 Specify config path explicitly:
 ```bash
-npx repolens publish --config /path/to/.repolens.yml
+npx @chappibunny/repolens publish --config /path/to/.repolens.yml
 ```
 
 Via npm script (add to package.json):
@@ -435,7 +435,7 @@ Via npm script (add to package.json):
 Check if your RepoLens setup is valid:
 
 ```bash
-npx repolens doctor
+npx @chappibunny/repolens doctor
 ```
 
 Validates:
@@ -450,17 +450,17 @@ Validates:
 **🚨 Upgrading from v0.3.0 or earlier?** Automatically update your GitHub Actions workflows:
 
 ```bash
-npx repolens migrate
+npx @chappibunny/repolens migrate
 ```
 
 Preview changes without applying:
 ```bash
-npx repolens migrate --dry-run
+npx @chappibunny/repolens migrate --dry-run
 ```
 
 What it fixes:
 - ❌ Removes outdated `cd tools/repolens` commands
-- ✅ Updates to `npx repolens@latest publish`
+- ✅ Updates to `npx @chappibunny/repolens@latest publish`
 - ✅ Adds Node.js setup step if missing
 - ✅ Adds environment variables (NOTION_TOKEN, REPOLENS_AI_API_KEY)
 - 💾 Creates backup files for safety
@@ -477,8 +477,8 @@ See [MIGRATION.md](MIGRATION.md) for detailed upgrade guide.
 ### Get Help
 
 ```bash
-npx repolens --help
-npx repolens --version
+npx @chappibunny/repolens --help
+npx @chappibunny/repolens --version
 ```
 
 ---

package/RELEASE.md

@@ -47,6 +47,6 @@ To test that users can upgrade successfully:
 
 ```bash
 # In a test project
-npx repolens@latest --version
-npx repolens@latest publish
+npx @chappibunny/repolens@latest --version
+npx @chappibunny/repolens@latest publish
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chappibunny/repolens",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "AI-assisted documentation intelligence system for technical and non-technical audiences",
   "license": "MIT",
   "type": "module",
@@ -36,7 +36,7 @@
   "author": "Charl van Zyl",
   "scripts": {
     "test:notion": "node notion-test.js",
-    "publish": "node src/cli.js publish --config ../../.repolens.yml",
+    "docs:publish": "node src/cli.js publish --config ../../.repolens.yml",
     "init:test": "node src/cli.js init --target /tmp/repolens-init-test",
     "test": "NODE_ENV=test vitest run --no-watch --reporter=verbose",
     "pack:check": "npm pack",

package/src/init.js

@@ -46,7 +46,7 @@ jobs:
         env:
           NOTION_TOKEN: \${{ secrets.NOTION_TOKEN }}
           NOTION_PARENT_PAGE_ID: \${{ secrets.NOTION_PARENT_PAGE_ID }}
-        run: npx repolens@latest publish
+        run: npx @chappibunny/repolens@latest publish
 `;
 
 const DEFAULT_ENV_EXAMPLE = `# Notion Publishing
@@ -81,7 +81,7 @@ This repository is configured to use [RepoLens](https://github.com/CHAPIBUNNY/re
 
 \`\`\`bash
 # Test documentation generation locally
-npx repolens publish
+npx @chappibunny/repolens publish
 \`\`\`
 
 ### Notion Publishing
@@ -514,7 +514,7 @@ NOTION_VERSION=2022-06-28
     info("   Your credentials are stored in .env (gitignored)\n");
     info("Next steps:");
     info("  1. Review .repolens.yml to customize your documentation");
-    info("  2. Run 'npx repolens publish' to generate your first docs (deterministic mode)");
+    info("  2. Run 'npx @chappibunny/repolens publish' to generate your first docs (deterministic mode)");
     info("  3. (Optional) Enable AI features by adding to .env:");
     info("     REPOLENS_AI_ENABLED=true");
     info("     REPOLENS_AI_API_KEY=sk-...");
@@ -534,7 +534,7 @@ NOTION_VERSION=2022-06-28
     info("     REPOLENS_AI_ENABLED=true");
     info("     REPOLENS_AI_API_KEY=sk-...");
     info("     See: https://github.com/CHAPIBUNNY/repolens/blob/main/AI.md");
-    info("  4. Run 'npx repolens publish' to test locally");
+    info("  4. Run 'npx @chappibunny/repolens publish' to test locally");
     info("  5. Commit the generated files");
   }
 }

package/src/migrate.js

@@ -43,14 +43,19 @@ function detectLegacyPatterns(content) {
 function migrateWorkflowContent(content) {
   let migrated = content;
 
-  // Remove cd tools/repolens commands
-  migrated = migrated.replace(/cd\s+tools\/repolens\s*\n?/gi, "");
-  
-  // Remove standalone npm ci/install that's part of old setup
-  migrated = migrated.replace(/npm\s+(?:ci|install)\s*\n/g, "");
+  // Remove cd tools/repolens commands and associated npm install in the same run block
+  // This handles the legacy pattern: run: | cd tools/repolens; npm install; npx repolens publish
+  if (/cd\s+tools\/repolens/i.test(migrated)) {
+    // Remove cd command
+    migrated = migrated.replace(/cd\s+tools\/repolens\s*\n?/gi, "");
+    
+    // Only remove npm install/ci if it appears in what looks like a multi-line run block
+    // after we've removed the cd command (indicates it was part of the legacy pattern)
+    migrated = migrated.replace(/(run:\s*\|[^\n]*\n(?:\s+[^\n]*\n)*?\s+)npm\s+(?:ci|install)\s*\n/g, "$1");
+  }
 
-  // Update npx repolens to npx repolens@latest
-  migrated = migrated.replace(/npx\s+repolens\s+/g, "npx repolens@latest ");
+  // Update npx repolens to npx @chappibunny/repolens@latest
+  migrated = migrated.replace(/npx\s+repolens\s+/g, "npx @chappibunny/repolens@latest ");
 
   // Add Node.js setup if missing (insert after checkout step)
   if (!migrated.includes("actions/setup-node@")) {
@@ -70,17 +75,18 @@ function migrateWorkflowContent(content) {
 
   // Add environment variables if missing
   if (!migrated.includes("NOTION_TOKEN") && !migrated.includes("env:")) {
-    // Find the publish/generate documentation step
-    const publishPattern = /(- name: .*(?:publish|generate).*documentation.*\n)/i;
+    // Find the publish/generate documentation step with its run command
+    // Pattern captures: step name, indentation before run, and run command
+    const publishPattern = /(- name: .*(?:publish|generate).*documentation.*\n)(\s+)(run:.*)/i;
     if (publishPattern.test(migrated)) {
       migrated = migrated.replace(
         publishPattern,
-        `$1        env:
-          NOTION_TOKEN: \${{ secrets.NOTION_TOKEN }}
-          NOTION_PARENT_PAGE_ID: \${{ secrets.NOTION_PARENT_PAGE_ID }}
-          REPOLENS_AI_API_KEY: \${{ secrets.REPOLENS_AI_API_KEY }}
-          REPOLENS_AI_PROVIDER: openai
-        `
+        `$1$2env:
+$2  NOTION_TOKEN: \${{ secrets.NOTION_TOKEN }}
+$2  NOTION_PARENT_PAGE_ID: \${{ secrets.NOTION_PARENT_PAGE_ID }}
+$2  REPOLENS_AI_API_KEY: \${{ secrets.REPOLENS_AI_API_KEY }}
+$2  REPOLENS_AI_PROVIDER: openai
+$2$3`
       );
     }
   }
@@ -226,7 +232,7 @@ export async function runMigrate(targetDir = process.cwd(), options = {}) {
       if (!dryRun) {
         console.log("\n📝 Next steps:");
         console.log("   1. Review the changes: git diff .github/workflows/");
-        console.log("   2. Test locally: npx repolens@latest publish");
+        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("   4. Push: git push");
         console.log("\n💡 Tip: Backups saved as *.backup - delete them once verified");

package/src/utils/update-check.js

@@ -112,9 +112,9 @@ function showUpdateMessage(current, latest) {
   warn("│                                                            │");
   warn("│  Run one of these commands to update:                     │");
   warn("│                                                            │");
-  warn("│  • npm install -g repolens@latest    (global install)     │");
-  warn("│  • npm install repolens@latest       (local install)      │");
-  warn("│  • npx repolens@latest <command>     (always latest)      │");
+  warn("│  • npm install -g @chappibunny/repolens@latest (global)  │");
+  warn("│  • npm install @chappibunny/repolens@latest (local)      │");
+  warn("│  • npx @chappibunny/repolens@latest <command>  (latest)  │");
   warn("│                                                            │");
   warn("│  Release notes: https://github.com/CHAPIBUNNY/repolens    │");
   warn("└────────────────────────────────────────────────────────────┘");