cursor-lint 0.2.0 → 0.3.1

package/README.md

@@ -81,10 +81,14 @@ cursor-lint --version      Show version
 
 Every check in cursor-lint comes from [actual experiments](https://dev.to/nedcodes) testing what Cursor does and doesn't follow. Not guesswork — data.
 
+## Need a deeper review?
+
+cursor-lint catches structural issues. For a full review of your rules, project structure, and model settings, I offer [$50 async setup audits](https://cursorrulespacks.gumroad.com/l/cursor-setup-audit). You get a written report with specific fixes, not generic advice.
+
 ## License
 
 MIT
 
 ---
 
-Made by [nedcodes](https://dev.to/nedcodes)
+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)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cursor-lint",
-  "version": "0.2.0",
-  "description": "Lint your Cursor rules \u2014 catch common mistakes before they break your workflow",
+  "version": "0.3.1",
+  "description": "Lint your Cursor rules — catch common mistakes before they break your workflow",
   "main": "src/index.js",
   "bin": {
     "cursor-lint": "src/cli.js"

package/src/cli.js

@@ -3,8 +3,9 @@
 const path = require('path');
 const { lintProject } = require('./index');
 const { verifyProject } = require('./verify');
+const { initProject } = require('./init');
 
-const VERSION = '0.2.0';
+const VERSION = '0.3.1';
 
 const RED = '\x1b[31m';
 const YELLOW = '\x1b[33m';
@@ -26,6 +27,7 @@ ${YELLOW}Options:${RESET}
   --help, -h     Show this help message
   --version, -v  Show version number
   --verify       Check if code follows rules with verify: blocks
+  --init         Generate starter .mdc rules (auto-detects your stack)
 
 ${YELLOW}What it checks (default):${RESET}
   • .cursorrules files (warns about agent mode compatibility)
@@ -56,6 +58,7 @@ ${YELLOW}verify: block syntax in .mdc frontmatter:${RESET}
 ${YELLOW}Examples:${RESET}
   npx cursor-lint              # Lint rule files
   npx cursor-lint --verify     # Check code against rules
+  npx cursor-lint --init       # Generate starter rules for your project
 
 ${YELLOW}More info:${RESET}
   https://github.com/cursorrulespacks/cursor-lint
@@ -77,8 +80,44 @@ async function main() {
 
   const cwd = process.cwd();
   const isVerify = args.includes('--verify');
+  const isInit = args.includes('--init');
 
-  if (isVerify) {
+  if (isInit) {
+    console.log(`\n🔍 cursor-lint v${VERSION} --init\n`);
+    console.log(`Detecting stack in ${cwd}...\n`);
+
+    const results = await initProject(cwd);
+
+    const stacks = Object.entries(results.detected)
+      .filter(([_, v]) => v)
+      .map(([k]) => k.charAt(0).toUpperCase() + k.slice(1));
+
+    if (stacks.length > 0) {
+      console.log(`Detected: ${stacks.join(', ')}\n`);
+    }
+
+    if (results.created.length > 0) {
+      console.log(`${GREEN}Created:${RESET}`);
+      for (const f of results.created) {
+        console.log(`  ${GREEN}✓${RESET} .cursor/rules/${f}`);
+      }
+    }
+
+    if (results.skipped.length > 0) {
+      console.log(`\n${YELLOW}Skipped (already exist):${RESET}`);
+      for (const f of results.skipped) {
+        console.log(`  ${YELLOW}⚠${RESET} .cursor/rules/${f}`);
+      }
+    }
+
+    if (results.created.length > 0) {
+      console.log(`\n${DIM}Run cursor-lint to check these rules${RESET}`);
+      console.log(`${DIM}Run cursor-lint --verify to check code against them${RESET}\n`);
+    }
+
+    process.exit(0);
+
+  } else if (isVerify) {
     console.log(`\n🔍 cursor-lint v${VERSION} --verify\n`);
     console.log(`Scanning ${cwd} for rule violations...\n`);
 
@@ -167,6 +206,11 @@ async function main() {
     if (totalPassed > 0) parts.push(`${GREEN}${totalPassed} passed${RESET}`);
     console.log(parts.join(', ') + '\n');
 
+    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`);
+    }
+
     process.exit(totalErrors > 0 ? 1 : 0);
   }
 }

package/src/init.js

@@ -0,0 +1,227 @@
+const fs = require('fs');
+const path = require('path');
+
+async function initProject(projectPath) {
+  const detected = detectStack(projectPath);
+  const created = [];
+  const skipped = [];
+
+  const rulesDir = path.join(projectPath, '.cursor', 'rules');
+  
+  if (!fs.existsSync(rulesDir)) {
+    fs.mkdirSync(rulesDir, { recursive: true });
+  }
+
+  const generalResult = writeRule(rulesDir, 'general.mdc', generateGeneral());
+  if (generalResult.created) created.push(generalResult.file);
+  else skipped.push(generalResult.file);
+
+  if (detected.typescript) {
+    const result = writeRule(rulesDir, 'typescript.mdc', generateTypeScript());
+    if (result.created) created.push(result.file);
+    else skipped.push(result.file);
+  }
+
+  if (detected.react && !detected.nextjs) {
+    const result = writeRule(rulesDir, 'react.mdc', generateReact());
+    if (result.created) created.push(result.file);
+    else skipped.push(result.file);
+  }
+
+  if (detected.nextjs) {
+    const result = writeRule(rulesDir, 'nextjs.mdc', generateNextJs());
+    if (result.created) created.push(result.file);
+    else skipped.push(result.file);
+  }
+
+  if (detected.express) {
+    const result = writeRule(rulesDir, 'express.mdc', generateExpress());
+    if (result.created) created.push(result.file);
+    else skipped.push(result.file);
+  }
+
+  if (detected.python) {
+    const result = writeRule(rulesDir, 'python.mdc', generatePython());
+    if (result.created) created.push(result.file);
+    else skipped.push(result.file);
+  }
+
+  return { created, skipped, detected };
+}
+
+function detectStack(projectPath) {
+  const detected = {
+    typescript: false,
+    react: false,
+    nextjs: false,
+    express: false,
+    python: false,
+    node: false
+  };
+
+  if (fs.existsSync(path.join(projectPath, 'tsconfig.json'))) {
+    detected.typescript = true;
+  }
+
+  const pkgPath = path.join(projectPath, 'package.json');
+  if (fs.existsSync(pkgPath)) {
+    detected.node = true;
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+      const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+
+      if (allDeps.react || allDeps['react-dom']) detected.react = true;
+      if (allDeps.next) { detected.nextjs = true; detected.react = true; }
+      if (allDeps.express) detected.express = true;
+      if (allDeps.typescript || allDeps['@types/node']) detected.typescript = true;
+    } catch (e) {}
+  }
+
+  try {
+    const files = fs.readdirSync(projectPath);
+    if (files.some(f => f.endsWith('.py')) || 
+        fs.existsSync(path.join(projectPath, 'requirements.txt')) ||
+        fs.existsSync(path.join(projectPath, 'pyproject.toml'))) {
+      detected.python = true;
+    }
+  } catch (e) {}
+
+  return detected;
+}
+
+function writeRule(rulesDir, filename, content) {
+  const filePath = path.join(rulesDir, filename);
+  if (fs.existsSync(filePath)) return { file: filename, created: false };
+  fs.writeFileSync(filePath, content);
+  return { file: filename, created: true };
+}
+
+function generateGeneral() {
+  return `---
+description: General code quality rules
+alwaysApply: true
+globs: ["*"]
+verify:
+  - antipattern: "TODO"
+    message: "Resolve TODO comments before committing"
+  - antipattern: "FIXME"
+    message: "Resolve FIXME comments before committing"
+  - antipattern: "console\\\\.log"
+    message: "Remove console.log statements"
+---
+
+# General Guidelines
+
+- Write clear, self-documenting code
+- Use meaningful variable and function names
+- Keep functions small and focused
+- Remove all TODOs and FIXMEs before committing
+- No console.log in production code
+`;
+}
+
+function generateTypeScript() {
+  return `---
+description: TypeScript best practices
+alwaysApply: true
+globs: ["*.ts", "*.tsx"]
+verify:
+  - antipattern: ": any"
+    message: "Avoid using 'any' type - use proper typing"
+  - antipattern: "@ts-ignore"
+    message: "Remove @ts-ignore - fix the type error instead"
+---
+
+# TypeScript Rules
+
+- Use strict TypeScript configuration
+- Avoid \`any\` type - use \`unknown\` if type is truly unknown
+- Use type inference where possible, explicit types where helpful
+- Prefer interfaces for object shapes, types for unions/intersections
+`;
+}
+
+function generateReact() {
+  return `---
+description: React best practices
+alwaysApply: true
+globs: ["*.tsx", "*.jsx"]
+verify:
+  - antipattern: "dangerouslySetInnerHTML"
+    message: "Avoid dangerouslySetInnerHTML - use proper sanitization if needed"
+---
+
+# React Rules
+
+- Use functional components with hooks
+- Before writing a useEffect, ask: can this be computed during render?
+- Keep components small and focused
+- Use proper key props in lists (never use array index as key for dynamic lists)
+`;
+}
+
+function generateNextJs() {
+  return `---
+description: Next.js App Router best practices
+alwaysApply: true
+globs: ["*.ts", "*.tsx"]
+verify:
+  - antipattern: "getServerSideProps"
+    message: "Use App Router patterns instead of getServerSideProps"
+  - antipattern: "getStaticProps"
+    message: "Use App Router patterns instead of getStaticProps"
+---
+
+# Next.js Rules
+
+- Use App Router (app directory), not Pages Router
+- Mark components as 'use client' only when they need client-side interactivity
+- Default to Server Components
+- Use Server Actions for mutations instead of API routes
+- Use the @/ path alias for imports
+`;
+}
+
+function generateExpress() {
+  return `---
+description: Express/Node.js best practices
+alwaysApply: true
+globs: ["*.js", "*.ts"]
+verify:
+  - antipattern: "app\\\\.use\\\\(express\\\\.json\\\\(\\\\)\\\\)"
+    message: "Consider adding body size limits to express.json()"
+---
+
+# Express Rules
+
+- Use async/await with proper error handling
+- Always validate and sanitize user input
+- Use middleware for cross-cutting concerns
+- Add rate limiting for public endpoints
+`;
+}
+
+function generatePython() {
+  return `---
+description: Python best practices
+alwaysApply: true
+globs: ["*.py"]
+verify:
+  - antipattern: "print\\\\("
+    message: "Use logging instead of print statements"
+  - antipattern: "import \\\\*"
+    message: "Avoid wildcard imports - import specific names"
+  - antipattern: "except:"
+    message: "Avoid bare except - catch specific exceptions"
+---
+
+# Python Rules
+
+- Follow PEP 8 style guidelines
+- Use type hints for function signatures
+- Use logging instead of print statements
+- Handle exceptions specifically, never use bare except
+`;
+}
+
+module.exports = { initProject, detectStack };