4runr-cursor-setup 0.1.0 → 0.1.2

package/dist/cli.js

@@ -1,14 +1,48 @@
 #!/usr/bin/env node
 import { init } from "./commands/init.js";
+import { addGroup, listGroups, removeGroup, GROUPS } from "./commands/commands.js";
 const args = process.argv.slice(2);
 const cmd = args[0];
+function usage() {
+    console.log("4runr-cursor-setup");
+    console.log("Usage:");
+    console.log("  4runr-cursor-setup init [--force]");
+    console.log("  4runr-cursor-setup list");
+    console.log("  4runr-cursor-setup add <group> [--force]");
+    console.log("  4runr-cursor-setup remove <group>");
+    console.log("");
+    console.log("Groups: " + Object.keys(GROUPS).join(", "));
+}
 async function main() {
+    const force = args.includes("--force");
     if (cmd === "init") {
         await init({ cwd: process.cwd() });
+        addGroup({ cwd: process.cwd(), group: "core", force });
         return;
     }
-    console.log("4runr-cursor-setup");
-    console.log("Usage: 4runr-cursor-setup init");
+    if (cmd === "list") {
+        listGroups();
+        return;
+    }
+    if (cmd === "add") {
+        const group = args[1];
+        if (!group || !(group in GROUPS)) {
+            usage();
+            process.exit(1);
+        }
+        addGroup({ cwd: process.cwd(), group, force });
+        return;
+    }
+    if (cmd === "remove") {
+        const group = args[1];
+        if (!group || !(group in GROUPS)) {
+            usage();
+            process.exit(1);
+        }
+        removeGroup({ cwd: process.cwd(), group });
+        return;
+    }
+    usage();
     process.exit(1);
 }
 main().catch((err) => {

package/dist/commands/commands.js

@@ -0,0 +1,91 @@
+import * as fs from "fs";
+import * as path from "path";
+import * as url from "url";
+export const GROUPS = {
+    core: ["4runr-start.md", "4runr-close.md"],
+    planning: ["4runr-task.md", "4runr-phase.md"],
+    governance: ["4runr-decision.md", "4runr-scope-change.md"],
+    debugging: ["4runr-repro.md", "4runr-verify.md"],
+};
+const MANAGED_MARKER = "<!-- managed-by: 4runr-cursor-setup -->";
+function ensureDir(p) {
+    fs.mkdirSync(p, { recursive: true });
+}
+function fileContainsMarker(p) {
+    if (!fs.existsSync(p))
+        return false;
+    const s = fs.readFileSync(p, "utf8");
+    return s.includes(MANAGED_MARKER);
+}
+function ensureMarkerOnFile(p) {
+    // If a file exists but lacks the marker, we do not modify it.
+    // Marker is only guaranteed for files we write.
+    if (!fs.existsSync(p))
+        return;
+    const s = fs.readFileSync(p, "utf8");
+    if (s.includes(MANAGED_MARKER))
+        return;
+}
+function writeWithMarker(src, dst) {
+    const body = fs.readFileSync(src, "utf8");
+    const out = body.includes(MANAGED_MARKER) ? body : `${MANAGED_MARKER}\n\n${body}`;
+    ensureDir(path.dirname(dst));
+    fs.writeFileSync(dst, out, "utf8");
+}
+function copyIfMissing(src, dst, force = false) {
+    if (!force && fs.existsSync(dst)) {
+        // never touch existing files unless --force
+        ensureMarkerOnFile(dst);
+        return false;
+    }
+    writeWithMarker(src, dst);
+    return true;
+}
+function getTemplatesRoot() {
+    const here = path.dirname(url.fileURLToPath(import.meta.url));
+    return path.resolve(here, "..", "templates");
+}
+export function listGroups() {
+    console.log("Available groups:");
+    Object.keys(GROUPS).forEach((g) => {
+        console.log("- " + g + ": " + GROUPS[g].join(", "));
+    });
+}
+export function addGroup(opts) {
+    const { cwd, group, force = false } = opts;
+    const templatesRoot = getTemplatesRoot();
+    const srcBase = path.join(templatesRoot, "commands", group);
+    const outBase = path.join(cwd, ".cursor", "commands");
+    ensureDir(outBase);
+    const files = GROUPS[group];
+    let copied = 0;
+    for (const f of files) {
+        const src = path.join(srcBase, f);
+        const dst = path.join(outBase, f);
+        if (!fs.existsSync(src))
+            throw new Error("Template missing: " + src);
+        if (copyIfMissing(src, dst, force))
+            copied++;
+    }
+    console.log('Installed group "' + group + '" into .cursor/commands (' + copied + " file(s) written).");
+}
+export function removeGroup(opts) {
+    const { cwd, group } = opts;
+    const outBase = path.join(cwd, ".cursor", "commands");
+    const files = GROUPS[group];
+    let removed = 0;
+    let skipped = 0;
+    for (const f of files) {
+        const dst = path.join(outBase, f);
+        if (!fs.existsSync(dst))
+            continue;
+        // Only delete files we manage.
+        if (!fileContainsMarker(dst)) {
+            skipped++;
+            continue;
+        }
+        fs.unlinkSync(dst);
+        removed++;
+    }
+    console.log('Removed group "' + group + '" from .cursor/commands (' + removed + " file(s) deleted, " + skipped + " skipped).");
+}

package/dist/templates/commands/core/4runr-close.md

@@ -0,0 +1,7 @@
+# /4runr-close
+
+Before ending the chat:
+1) Update docs/status.md with a short snapshot (what exists now, what changed).
+2) Update docs/todo.md with next steps + blockers.
+3) If any decisions were made, append them to docs/decisions.md (date + decision + reason).
+4) List files changed (or that should be changed).

package/dist/templates/commands/core/4runr-start.md

@@ -0,0 +1,7 @@
+# /4runr-start
+
+Before doing anything:
+1) Read: docs/status.md, docs/todo.md, docs/decisions.md, docs/scope.md, docs/constraints.md, .cursor/rules/project.md (if they exist).
+2) Summarize current state in 5-10 bullets.
+3) List missing info (if any) as targeted questions.
+4) Do not implement until aligned.

package/dist/templates/commands/debugging/4runr-repro.md

@@ -0,0 +1,8 @@
+# /4runr-repro
+
+Produce minimal reproduction steps:
+- Environment
+- Steps
+- Expected vs actual
+- Minimal code / files involved
+Then propose 1-3 hypotheses to test.

package/dist/templates/commands/debugging/4runr-verify.md

@@ -0,0 +1,7 @@
+# /4runr-verify
+
+Before claiming 'fixed':
+- Show how to run verification
+- What signals prove it's fixed
+- What edge cases to check
+Never claim success without verification.

package/dist/templates/commands/governance/4runr-decision.md

@@ -0,0 +1,8 @@
+# /4runr-decision
+
+Append a decision to docs/decisions.md using:
+- Date
+- Decision
+- Context
+- Tradeoffs
+- Consequences

package/dist/templates/commands/governance/4runr-scope-change.md

@@ -0,0 +1,7 @@
+# /4runr-scope-change
+
+Record a scope change in docs/decisions.md:
+- What changed
+- Why
+- Impact
+- New constraints / risks

package/dist/templates/commands/planning/4runr-phase.md

@@ -0,0 +1,6 @@
+# /4runr-phase
+
+Ask the user for the current phase goal, then:
+- Lock scope to that phase only
+- Define exit criteria
+- Proceed in atomic steps

package/dist/templates/commands/planning/4runr-task.md

@@ -0,0 +1,6 @@
+# /4runr-task
+
+Convert the user's request into:
+- A small plan (3-7 steps)
+- The first atomic step to execute next
+Ask clarifying questions if less than 90% confident.

package/package.json

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

package/src/templates/commands/core/4runr-close.md

@@ -0,0 +1,7 @@
+# /4runr-close
+
+Before ending the chat:
+1) Update docs/status.md with a short snapshot (what exists now, what changed).
+2) Update docs/todo.md with next steps + blockers.
+3) If any decisions were made, append them to docs/decisions.md (date + decision + reason).
+4) List files changed (or that should be changed).

package/src/templates/commands/core/4runr-start.md

@@ -0,0 +1,7 @@
+# /4runr-start
+
+Before doing anything:
+1) Read: docs/status.md, docs/todo.md, docs/decisions.md, docs/scope.md, docs/constraints.md, .cursor/rules/project.md (if they exist).
+2) Summarize current state in 5-10 bullets.
+3) List missing info (if any) as targeted questions.
+4) Do not implement until aligned.

package/src/templates/commands/debugging/4runr-repro.md

@@ -0,0 +1,8 @@
+# /4runr-repro
+
+Produce minimal reproduction steps:
+- Environment
+- Steps
+- Expected vs actual
+- Minimal code / files involved
+Then propose 1-3 hypotheses to test.

package/src/templates/commands/debugging/4runr-verify.md

@@ -0,0 +1,7 @@
+# /4runr-verify
+
+Before claiming 'fixed':
+- Show how to run verification
+- What signals prove it's fixed
+- What edge cases to check
+Never claim success without verification.

package/src/templates/commands/governance/4runr-decision.md

@@ -0,0 +1,8 @@
+# /4runr-decision
+
+Append a decision to docs/decisions.md using:
+- Date
+- Decision
+- Context
+- Tradeoffs
+- Consequences

package/src/templates/commands/governance/4runr-scope-change.md

@@ -0,0 +1,7 @@
+# /4runr-scope-change
+
+Record a scope change in docs/decisions.md:
+- What changed
+- Why
+- Impact
+- New constraints / risks

package/src/templates/commands/planning/4runr-phase.md

@@ -0,0 +1,6 @@
+# /4runr-phase
+
+Ask the user for the current phase goal, then:
+- Lock scope to that phase only
+- Define exit criteria
+- Proceed in atomic steps

package/src/templates/commands/planning/4runr-task.md

@@ -0,0 +1,6 @@
+# /4runr-task
+
+Convert the user's request into:
+- A small plan (3-7 steps)
+- The first atomic step to execute next
+Ask clarifying questions if less than 90% confident.