4runr-cursor-setup 0.1.20 → 0.1.21

package/README.md

@@ -34,9 +34,11 @@ npx -y 4runr-cursor-setup@latest doctor --strict
 
 ```bash
 # Repair / normalize any repo (safe)
+# Installs: manifest + docs + .cursor/rules/project.md
 npx -y 4runr-cursor-setup@latest doctor --fix --purge-orphans --strict
 
 # Install core commands (updates if already installed)
+# Installs: .cursor/commands/* (4runr-start.md, 4runr-close.md)
 npx -y 4runr-cursor-setup@latest add core --force
 
 # CI / health check (fails if issues)
@@ -46,6 +48,8 @@ npx -y 4runr-cursor-setup@latest doctor --strict
 npx -y 4runr-cursor-setup@latest doctor --plan
 ```
 
+**Note:** If Cursor UI doesn't show Project Rules after running `doctor --fix`, reload the window (Ctrl+Shift+P → Developer: Reload Window).
+
 ## Contract / Invariants
 
 - Tool never overwrites un-managed files (even with `--force`)

package/dist/commands/commands.js

@@ -248,8 +248,26 @@ export function addGroup(opts) {
     else {
         console.log('Installed group "' + group + '" into .cursor/commands (' + copied + " file(s) written).");
     }
-    if (group === "core")
+    // Check for rules file and provide hints (for core group, after successful write or when already installed)
+    if (group === "core" && (copied > 0 || (copied === 0 && !hasAnyFileToWrite))) {
+        const rulesPath = path.join(cwd, ".cursor/rules/project.md");
+        const rulesExistedBefore = fs.existsSync(rulesPath);
+        // Call ensureMemory (creates empty file if missing)
         ensureMemory(cwd);
+        // Check if rules were missing before ensureMemory created them
+        if (!rulesExistedBefore) {
+            // Rules were missing, hint user to run doctor --fix for proper setup
+            console.log("Hint: Project rules not found (.cursor/rules/project.md). Run: doctor --fix --purge-orphans --strict");
+        }
+        else if (fs.existsSync(rulesPath)) {
+            // Rules exist, show reload tip
+            console.log("Cursor tip: if rules exist but don't appear, reload Cursor window (Ctrl+Shift+P → Developer: Reload Window).");
+        }
+    }
+    else if (group === "core") {
+        // Still call ensureMemory even if we don't show hints
+        ensureMemory(cwd);
+    }
 }
 export function removeGroup(opts) {
     const { cwd, group, dryRun = false } = opts;

package/dist/commands/doctor.js

@@ -79,9 +79,25 @@ function purgeOrphans(cwd, dryRun, silent) {
     return { count: deleted, files: deletedFiles };
 }
 export function doctor(cwd, toolVersion, opts) {
+    // Track files created/verified during --fix
+    const rulesPath = path.join(cwd, ".cursor/rules/project.md");
+    const rulesExistedBefore = opts.fix && !opts.dryRun ? fs.existsSync(rulesPath) : false;
+    let rulesCreated = false;
+    let rulesVerified = false;
     // Run fixes first if requested
     if (opts.fix) {
         ensureMemory(cwd, { dryRun: !!opts.dryRun });
+        // Check if rules were created or verified
+        if (!opts.dryRun) {
+            if (fs.existsSync(rulesPath)) {
+                if (!rulesExistedBefore) {
+                    rulesCreated = true;
+                }
+                else {
+                    rulesVerified = true;
+                }
+            }
+        }
         // Always ensure manifest exists when --fix is used
         if (!loadManifest(cwd)) {
             const nm = createEmptyManifest(toolVersion);
@@ -190,6 +206,20 @@ export function doctor(cwd, toolVersion, opts) {
     if (opts.plan) {
         planItems = generatePlan(issues, m || null);
     }
+    // Prepare fixed files info for output
+    const fixedInfo = { created: [], verified: [] };
+    const notes = [];
+    if (opts.fix && !opts.dryRun) {
+        if (rulesCreated) {
+            fixedInfo.created.push(".cursor/rules/project.md");
+        }
+        else if (rulesVerified) {
+            fixedInfo.verified.push(".cursor/rules/project.md");
+        }
+        if (fs.existsSync(rulesPath)) {
+            notes.push("Reload Cursor window to apply Project Rules.");
+        }
+    }
     if (opts.json) {
         const jsonOutput = { ok: !hasErrors, issues };
         if (purgedInfo) {
@@ -198,6 +228,12 @@ export function doctor(cwd, toolVersion, opts) {
         if (opts.plan) {
             jsonOutput.plan = planItems;
         }
+        if (opts.fix && (fixedInfo.created.length > 0 || fixedInfo.verified.length > 0)) {
+            jsonOutput.fixed = fixedInfo;
+        }
+        if (notes.length > 0) {
+            jsonOutput.notes = notes;
+        }
         console.log(JSON.stringify(jsonOutput, null, 2));
     }
     else {
@@ -220,6 +256,18 @@ export function doctor(cwd, toolVersion, opts) {
         }
         else {
             // Normal output mode
+            // Print rules status if --fix was used
+            if (opts.fix && !opts.dryRun) {
+                if (rulesCreated) {
+                    console.log("CREATED rules: .cursor/rules/project.md");
+                }
+                else if (rulesVerified) {
+                    console.log("OK rules: .cursor/rules/project.md");
+                }
+                if (fs.existsSync(rulesPath)) {
+                    console.log("Note: if Cursor doesn't show Project Rules yet, reload the window (Ctrl+Shift+P → Developer: Reload Window).");
+                }
+            }
             if (issues.length === 0)
                 console.log("✅ doctor: OK");
             else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "4runr-cursor-setup",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "description": "",
   "main": "index.js",
   "scripts": {

package/scripts/smoke.ps1

@@ -69,6 +69,16 @@ try {
     Pop-Location
     Write-Host ""
 
+    # Verify .cursor/rules/project.md exists after doctor fix
+    $rulesPath = Join-Path $tempDir ".cursor\rules\project.md"
+    if (-not (Test-Path $rulesPath)) {
+        Write-Host "FAILED: .cursor/rules/project.md not found after doctor --fix" -ForegroundColor Red
+        $exitCode = 1
+    } else {
+        Write-Host "PASSED: .cursor/rules/project.md exists" -ForegroundColor Green
+    }
+    Write-Host ""
+
     if ($exitCode -ne 0) {
         exit $exitCode
     }