cursor-lint 0.3.1 → 0.4.1

package/README.md

@@ -1,7 +1,12 @@
 # cursor-lint
 
+[![npm](https://img.shields.io/npm/dw/cursor-lint)](https://www.npmjs.com/package/cursor-lint)
+[![npm version](https://img.shields.io/npm/v/cursor-lint)](https://www.npmjs.com/package/cursor-lint)
+
 Lint your [Cursor](https://cursor.com) rules. Catch common mistakes before they silently break your workflow.
 
+![cursor-lint demo](demo.png)
+
 ```bash
 npx cursor-lint
 ```
@@ -92,3 +97,11 @@ MIT
 ---
 
 Made by [nedcodes](https://dev.to/nedcodes) · [Free rules collection](https://github.com/cursorrulespacks/cursorrules-collection) · [Setup audits](https://cursorrulespacks.gumroad.com/l/cursor-setup-audit)
+
+---
+
+## Related
+
+- [cursorrules-collection](https://github.com/cursorrulespacks/cursorrules-collection) — 77+ free .mdc rules
+- [Cursor Setup Audit](https://cursorrulespacks.gumroad.com/l/cursor-setup-audit) — Professional review of your rules setup ($50)
+- [Articles on Dev.to](https://dev.to/nedcodes) — Guides on writing effective Cursor rules

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cursor-lint",
-  "version": "0.3.1",
-  "description": "Lint your Cursor rules — catch common mistakes before they break your workflow",
+  "version": "0.4.1",
+  "description": "Lint your Cursor rules \u2014 catch common mistakes before they break your workflow",
   "main": "src/index.js",
   "bin": {
     "cursor-lint": "src/cli.js"
@@ -12,7 +12,12 @@
     "cursorrules",
     "mdc",
     "linter",
-    "developer-tools"
+    "developer-tools",
+    "cursor-rules",
+    "lint",
+    "validate",
+    "ai-coding",
+    "code-quality"
   ],
   "author": "nedcodes",
   "license": "MIT",
@@ -26,4 +31,4 @@
   "files": [
     "src/"
   ]
-}
+}

package/src/cli.js

@@ -4,8 +4,9 @@ const path = require('path');
 const { lintProject } = require('./index');
 const { verifyProject } = require('./verify');
 const { initProject } = require('./init');
+const { fixProject } = require('./fix');
 
-const VERSION = '0.3.1';
+const VERSION = '0.4.1';
 
 const RED = '\x1b[31m';
 const YELLOW = '\x1b[33m';
@@ -28,6 +29,7 @@ ${YELLOW}Options:${RESET}
   --version, -v  Show version number
   --verify       Check if code follows rules with verify: blocks
   --init         Generate starter .mdc rules (auto-detects your stack)
+  --fix          Auto-fix common issues (missing frontmatter, alwaysApply)
 
 ${YELLOW}What it checks (default):${RESET}
   • .cursorrules files (warns about agent mode compatibility)
@@ -81,8 +83,43 @@ async function main() {
   const cwd = process.cwd();
   const isVerify = args.includes('--verify');
   const isInit = args.includes('--init');
+  const isFix = args.includes('--fix');
 
-  if (isInit) {
+  if (isFix) {
+    console.log(`\n🔧 cursor-lint v${VERSION} --fix\n`);
+    console.log(`Scanning ${cwd} for fixable issues...\n`);
+
+    const results = await fixProject(cwd);
+
+    if (results.length === 0) {
+      console.log(`${YELLOW}No .mdc files found in .cursor/rules/${RESET}\n`);
+      process.exit(0);
+    }
+
+    let totalFixed = 0;
+    for (const result of results) {
+      const relPath = path.relative(cwd, result.file) || result.file;
+      if (result.changes.length > 0) {
+        console.log(`${GREEN}✓${RESET} ${relPath}`);
+        for (const change of result.changes) {
+          console.log(`  ${DIM}→ ${change}${RESET}`);
+        }
+        totalFixed++;
+      } else {
+        console.log(`${DIM}  ${relPath} — nothing to fix${RESET}`);
+      }
+    }
+
+    console.log();
+    console.log('─'.repeat(50));
+    if (totalFixed > 0) {
+      console.log(`${GREEN}Fixed ${totalFixed} file(s)${RESET}. Run cursor-lint to verify.\n`);
+    } else {
+      console.log(`${GREEN}All files look good — nothing to fix${RESET}\n`);
+    }
+    process.exit(0);
+
+  } else if (isInit) {
     console.log(`\n🔍 cursor-lint v${VERSION} --init\n`);
     console.log(`Detecting stack in ${cwd}...\n`);
 
@@ -209,6 +246,8 @@ async function main() {
     if (totalErrors > 0) {
       console.log(`${DIM}Need help fixing these? Get a full setup review:${RESET}`);
       console.log(`${CYAN}https://cursorrulespacks.gumroad.com/l/cursor-setup-audit${RESET}\n`);
+    } else if (totalPassed > 0) {
+      console.log(`${DIM}If cursor-lint saved you time: ${CYAN}https://github.com/cursorrulespacks/cursor-lint${RESET} ${DIM}(⭐ helps others find it)${RESET}\n`);
     }
 
     process.exit(totalErrors > 0 ? 1 : 0);

package/src/fix.js

@@ -0,0 +1,89 @@
+const fs = require('fs');
+const path = require('path');
+
+function addFrontmatter(content, filePath) {
+  const name = path.basename(filePath, '.mdc');
+  const frontmatter = `---
+description: ${name} rules
+alwaysApply: true
+---
+`;
+  return { fixed: frontmatter + content, changes: ['Added YAML frontmatter with alwaysApply: true'] };
+}
+
+function addAlwaysApply(content) {
+  // Insert alwaysApply: true after the first ---
+  const match = content.match(/^(---\n)([\s\S]*?)(---)/);
+  if (!match) return { fixed: content, changes: [] };
+  
+  const frontmatterBody = match[2];
+  if (frontmatterBody.includes('alwaysApply')) return { fixed: content, changes: [] };
+  
+  const newFm = match[1] + 'alwaysApply: true\n' + frontmatterBody + match[3];
+  const rest = content.slice(match[0].length);
+  return { fixed: newFm + rest, changes: ['Added alwaysApply: true to frontmatter'] };
+}
+
+function addDescription(content, filePath) {
+  const match = content.match(/^(---\n)([\s\S]*?)(---)/);
+  if (!match) return { fixed: content, changes: [] };
+  
+  const frontmatterBody = match[2];
+  if (frontmatterBody.includes('description')) return { fixed: content, changes: [] };
+  
+  const name = path.basename(filePath, '.mdc');
+  const newFm = match[1] + `description: ${name} rules\n` + frontmatterBody + match[3];
+  const rest = content.slice(match[0].length);
+  return { fixed: newFm + rest, changes: [`Added description: "${name} rules" to frontmatter`] };
+}
+
+async function fixFile(filePath) {
+  let content = fs.readFileSync(filePath, 'utf-8');
+  const allChanges = [];
+
+  // Check if frontmatter exists
+  const hasFm = content.match(/^---\n[\s\S]*?\n---/);
+  
+  if (!hasFm) {
+    const result = addFrontmatter(content, filePath);
+    content = result.fixed;
+    allChanges.push(...result.changes);
+  } else {
+    // Fix missing alwaysApply
+    const r1 = addAlwaysApply(content);
+    if (r1.changes.length) {
+      content = r1.fixed;
+      allChanges.push(...r1.changes);
+    }
+    
+    // Fix missing description
+    const r2 = addDescription(content, filePath);
+    if (r2.changes.length) {
+      content = r2.fixed;
+      allChanges.push(...r2.changes);
+    }
+  }
+
+  if (allChanges.length > 0) {
+    fs.writeFileSync(filePath, content, 'utf-8');
+  }
+
+  return { file: filePath, changes: allChanges };
+}
+
+async function fixProject(dir) {
+  const results = [];
+  const rulesDir = path.join(dir, '.cursor', 'rules');
+  
+  if (fs.existsSync(rulesDir) && fs.statSync(rulesDir).isDirectory()) {
+    for (const entry of fs.readdirSync(rulesDir)) {
+      if (entry.endsWith('.mdc')) {
+        results.push(await fixFile(path.join(rulesDir, entry)));
+      }
+    }
+  }
+
+  return results;
+}
+
+module.exports = { fixProject, fixFile };