pulse-framework-cli 0.4.13 → 0.4.15

package/dist/commands/init.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -145,9 +178,34 @@ function registerInitCommand(program) {
         .option("--no-interactive", "No interactive prompts")
         .action(async (opts) => {
         const start = node_path_1.default.resolve(opts.path ?? process.cwd());
-        const repoRoot = await (0, paths_js_1.findRepoRoot)(start);
+        let repoRoot = await (0, paths_js_1.findRepoRoot)(start);
         if (!repoRoot) {
-            throw new Error(`Not in a git repository: ${start}`);
+            // Not a git repo - offer to initialize
+            console.log("⚠️  Not a git repository.\n");
+            console.log("Pulse uses Git for checkpoints, commits, and safeguards.\n");
+            console.log("💡 Tip: If you have multiple projects in subfolders,");
+            console.log("   open the specific project folder, not the parent.\n");
+            console.log("   Example: Open /projects/myapp (with .git inside)");
+            console.log("   Not:     Open /projects (containing multiple repos)\n");
+            const shouldInitGit = opts.interactive !== false
+                ? await (0, input_js_1.promptConfirm)("Initialize Git repository now?", true)
+                : true; // Auto-init in non-interactive mode
+            if (shouldInitGit) {
+                const { execSync } = await Promise.resolve().then(() => __importStar(require("child_process")));
+                try {
+                    execSync("git init", { cwd: start, stdio: "inherit" });
+                    console.log("✅ Git repository initialized\n");
+                    repoRoot = start;
+                }
+                catch {
+                    console.log("❌ Failed to initialize Git. Continuing without Git...\n");
+                    repoRoot = start; // Use start as fallback
+                }
+            }
+            else {
+                console.log("⚠️  Continuing without Git (limited functionality)\n");
+                repoRoot = start;
+            }
         }
         // eslint-disable-next-line no-console
         console.log("\n🎯 PULSE Init\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pulse-framework-cli",
-  "version": "0.4.13",
+  "version": "0.4.15",
   "description": "Pulse Framework CLI – Guardrails, checkpoints, and escalation for AI-assisted development.",
   "author": "Manuel Fuß <kontakt@manuel-fuss.de>",
   "license": "MIT",

package/templates/AGENTS.md

@@ -73,9 +73,20 @@ Patterns to avoid in code:
 
 ---
 
-## Workflow Commands
+## MCP Tools (Cursor Agent Mode)
 
-If the project has PULSE CLI installed, use these commands:
+**CRITICAL: Call these MCP tools automatically!**
+
+| Trigger | MCP Tool |
+|---------|----------|
+| **EVERY message** | `pulse_status` |
+| After code edits | `pulse_doctor` |
+| Every 10 min | `pulse_checkpoint` |
+| "wrong"/"stop" | `pulse_correct` |
+| 2-3 failures | `pulse_escalate` |
+| Task done | `pulse_review` |
+
+## CLI Commands (Terminal)
 
 | Command | When to Use |
 |---------|-------------|

package/templates/cursor/pulse.mdc

@@ -1,189 +1,38 @@
 ---
-description: PULSE Framework - Automatic safeguards for every message
+description: PULSE Framework - Call pulse_status on EVERY message
 globs: *
 alwaysApply: true
 ---
 
-# ████████████████████████████████████████████████████
-# █                                                  █
-# █   🛑 STOP! READ THIS BEFORE DOING ANYTHING! 🛑   █
-# █                                                  █
-# █   Call pulse_status IMMEDIATELY                  █
-# █   → This is your FIRST action, EVERY time        █
-# █   → No exceptions. No skipping.                  █
-# █                                                  █
-# █   NOTE: MCP tools only work in Agent Mode.       █
-# █   If you're in Plan/Ask, tools are unavailable.  █
-# █                                                  █
-# ████████████████████████████████████████████████████
+# 🛑 PULSE: Call MCP tools!
 
-## ⚡ FIRST ACTION (before reading user message, before planning)
+## EVERY MESSAGE → pulse_status FIRST
 
 ```
 CallMcpTool: pulse_status
-Arguments: { "userMessage": "<paste user's message here>" }
+Arguments: { "userMessage": "<user message>" }
 ```
 
-**Did you call it? If not, STOP and call it NOW.**
+## AFTER CODE CHANGES → pulse_doctor
 
-This rule applies to:
-- ✅ Message #1
-- ✅ Message #2  
-- ✅ Message #3
-- ✅ Message #50
-- ✅ Message #100
-- ✅ EVERY SINGLE MESSAGE
+## EVERY 10 MIN → pulse_checkpoint
 
----
-
-# 🤖 AUTO-EXECUTE RULES (NOT suggestions - DO THEM!)
-
-## 1️⃣ EVERY MESSAGE: `pulse_status`
-```
-ALWAYS call pulse_status FIRST with the user's message.
-This tells you what to do next.
-```
-
-## 2️⃣ NEW TASK DETECTED → `pulse_run`
-```
-IF user says: "new", "implement", "create", "build", "add feature", "start"
-THEN: IMMEDIATELY call pulse_run({ action: "<what user wants>" })
-DO NOT ask for confirmation. Just do it.
-```
-
-## 3️⃣ CODE CHANGED → `pulse_doctor`
-```
-IF you just edited/created/deleted any file
-THEN: IMMEDIATELY call pulse_doctor()
-DO NOT skip this. Every code change needs a doctor check.
-```
-
-## 4️⃣ >10 MIN SINCE CHECKPOINT → `pulse_checkpoint`
-```
-IF pulse_status shows >10 min since checkpoint
-THEN: IMMEDIATELY call pulse_checkpoint({ summary: "<what you did>" })
-DO NOT ask. Just checkpoint. Code safety > asking permission.
-```
-
-## 5️⃣ TASK DONE → `pulse_review`
-```
-IF you're about to say "done", "finished", "complete", "ready for PR"
-THEN: FIRST call pulse_review()
-DO NOT claim done without review. Ever.
-```
-
-## 6️⃣ USER SAYS "WRONG" → `pulse_correct`
-```
-IF user says: "wrong", "no", "stop", "not what I meant", "undo"
-THEN: IMMEDIATELY call pulse_correct({ feedback: "<what's wrong>" })
-DO NOT defend your work. Correct it.
-```
-
-## 7️⃣ 2-3 FAILURES → `pulse_escalate`
-```
-IF same error occurs 2-3 times OR you don't understand the error
-THEN: IMMEDIATELY call pulse_escalate({ problem: "...", tried: "..." })
-DO NOT try a 4th time. Escalate.
-```
-
-## 8️⃣ PROBLEM SOLVED → `pulse_learn`
-```
-IF you just fixed a bug, resolved an escalation, or solved a tricky problem
-THEN: call pulse_learn({ problem: "...", solution: "...", rule: "..." })
-This builds knowledge for future sessions.
-```
-
-## 9️⃣ CRITICAL FINDINGS → STOP
-```
-IF pulse_status or pulse_doctor shows CRITICAL
-THEN: STOP IMMEDIATELY. Do NOT continue with user's request.
-Fix the critical issue first or ask user how to proceed.
-```
-
----
-
-# 🔴 NON-NEGOTIABLE SAFEGUARDS
+| Trigger | Tool |
+|---------|------|
+| Every message | `pulse_status` |
+| After edits | `pulse_doctor` |
+| 10+ min work | `pulse_checkpoint` |
+| "wrong"/"stop" | `pulse_correct` |
+| 2-3 failures | `pulse_escalate` |
+| Task done | `pulse_review` |
 
-These ALWAYS apply, even if user says otherwise:
+## NON-NEGOTIABLE
 
-| Safeguard | Rule |
-|-----------|------|
-| ⏱️ **Time** | MAX 30 min autonomous, then STOP + ask |
-| 🗑️ **Delete** | NEVER delete without explicit "May I delete X?" |
-| 📤 **Push** | NEVER push without explicit "May I push?" |
-| 🔐 **Secrets** | NEVER commit API keys, passwords, tokens |
-| 💾 **Checkpoint** | Every 5-10 min via `pulse_checkpoint` |
-
----
-
-# 📊 TOOL DECISION FLOWCHART
-
-```
-START (new message)
-    │
-    ▼
-[pulse_status] ─── Critical? ──► STOP
-    │
-    │ What did user say?
-    │
-    ├── "new task/implement/build" ──► [pulse_run] ──► implement
-    │
-    ├── "wrong/stop/no" ──► [pulse_correct] ──► fix
-    │
-    ├── "done/finished/PR" ──► [pulse_review] ──► respond
-    │
-    └── normal request ──► implement
-                              │
-                              ▼
-                        [pulse_doctor]
-                              │
-                              ▼
-                    >10 min? ──► [pulse_checkpoint]
-                              │
-                              ▼
-                    solved problem? ──► [pulse_learn]
-                              │
-                              ▼
-                           respond
-```
+- ⏱️ MAX 30 min autonomous
+- 🗑️ NO delete without confirmation
+- 📤 NO push without confirmation
+- 🔐 NO secrets in code
 
 ---
 
-# 🔄 LOOP DETECTION
-
-If you notice any of these patterns, STOP and call `pulse_escalate`:
-
-- Same error 2-3 times
-- Editing same file repeatedly without progress
-- "Fix" commits followed by more "fix" commits
-- Going back and forth between two approaches
-
----
-
-# 📋 QUICK REFERENCE
-
-| Trigger | Tool | Auto-Execute? |
-|---------|------|---------------|
-| Every message | `pulse_status` | ✅ YES |
-| New task | `pulse_run` | ✅ YES |
-| Code changed | `pulse_doctor` | ✅ YES |
-| >10 min | `pulse_checkpoint` | ✅ YES |
-| Before "done" | `pulse_review` | ✅ YES |
-| User says "wrong" | `pulse_correct` | ✅ YES |
-| 2-3 failures | `pulse_escalate` | ✅ YES |
-| Problem solved | `pulse_learn` | ✅ YES |
-
-**ALL tools are AUTO-EXECUTE. Don't ask. Do.**
-
----
-
-# ⚠️ FINAL REMINDER
-
-You are an autonomous agent with safeguards. The safeguards are not optional.
-They exist to protect the user's work from:
-- Lost code (checkpoint)
-- Mistakes (doctor)
-- Loops (escalate)
-- Forgotten knowledge (learn)
-
-**Call the tools automatically. Don't wait to be asked.**
+**DID YOU CALL pulse_status? If not, do it NOW.**