pulse-framework-cli 0.4.3 → 0.4.5

package/dist/commands/doctor.js

@@ -66,7 +66,7 @@ function registerDoctorCommand(program) {
             }
         }
         // ════════════════════════════════════════════════════════════════════════
-        // Preset-Verletzungen explizit hinzufügen
+        // Add preset limit violations explicitly
         // ════════════════════════════════════════════════════════════════════════
         const scope = (0, briefing_js_1.calculateScopeCheck)(config, scan.stats);
         if (scope.exceeded) {

package/dist/commands/init.js

@@ -200,19 +200,28 @@ function registerInitCommand(program) {
             console.log(`ℹ️ Config exists: ${cfgPath}`);
         }
         // ════════════════════════════════════════════════════════════════════════
-        // .cursorrules kopieren (Fallback ohne MCP)
+        // .cursorrules copy (Fallback without MCP)
         // ════════════════════════════════════════════════════════════════════════
         const cursorrulesDst = node_path_1.default.join(repoRoot, ".cursorrules");
         if (!(await fileExists(cursorrulesDst))) {
             const src = node_path_1.default.join(packageRoot(), "templates", ".cursorrules");
-            if (await fileExists(src)) {
-                await promises_1.default.copyFile(src, cursorrulesDst);
-                // eslint-disable-next-line no-console
-                console.log(`✅ .cursorrules created (Fallback rules)`);
+            try {
+                if (await fileExists(src)) {
+                    await promises_1.default.copyFile(src, cursorrulesDst);
+                    // eslint-disable-next-line no-console
+                    console.log(`✅ .cursorrules created (Fallback rules)`);
+                }
+                else {
+                    // eslint-disable-next-line no-console
+                    console.log(`⚠️ .cursorrules template not found: ${src}`);
+                }
             }
-            else {
+            catch (error) {
+                const errMsg = error instanceof Error ? error.message : String(error);
+                // eslint-disable-next-line no-console
+                console.log(`❌ Failed to create .cursorrules: ${errMsg}`);
                 // eslint-disable-next-line no-console
-                console.log(`⚠️ .cursorrules template not found: ${src}`);
+                console.log(`   💡 Check write permissions for: ${repoRoot}`);
             }
         }
         else {
@@ -535,12 +544,13 @@ async function installAgentsMd(repoRoot) {
         console.log(`ℹ️ AGENTS.md already exists`);
         return;
     }
-    if (await fileExists(agentsSrc)) {
-        await promises_1.default.copyFile(agentsSrc, agentsDst);
-    }
-    else {
-        // Fallback: Minimal inline version
-        const content = `# AI Agent Instructions
+    try {
+        if (await fileExists(agentsSrc)) {
+            await promises_1.default.copyFile(agentsSrc, agentsDst);
+        }
+        else {
+            // Fallback: Minimal inline version
+            const content = `# AI Agent Instructions
 
 > Universal agent configuration for PULSE Framework.
 
@@ -563,8 +573,31 @@ async function installAgentsMd(repoRoot) {
 
 *Generated by PULSE Framework*
 `;
-        await promises_1.default.writeFile(agentsDst, content, "utf8");
+            await promises_1.default.writeFile(agentsDst, content, "utf8");
+        }
+        // eslint-disable-next-line no-console
+        console.log(`✅ AGENTS.md created (universal for all AI editors)`);
+    }
+    catch (error) {
+        const errMsg = error instanceof Error ? error.message : String(error);
+        // eslint-disable-next-line no-console
+        console.log(`❌ Failed to create AGENTS.md: ${errMsg}`);
+        // Provide helpful hints based on error type
+        if (errMsg.includes("EACCES") || errMsg.includes("permission")) {
+            // eslint-disable-next-line no-console
+            console.log(`   💡 Permission denied. Try: sudo pulse init --agents`);
+        }
+        else if (errMsg.includes("ENOENT")) {
+            // eslint-disable-next-line no-console
+            console.log(`   💡 Directory not found. Make sure you're in your project root.`);
+        }
+        else if (errMsg.includes("ENOSPC")) {
+            // eslint-disable-next-line no-console
+            console.log(`   💡 No space left on disk.`);
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.log(`   💡 Check write permissions for: ${repoRoot}`);
+        }
     }
-    // eslint-disable-next-line no-console
-    console.log(`✅ AGENTS.md created (universal for all AI editors)`);
 }

package/dist/commands/reset.js

@@ -38,7 +38,7 @@ function registerResetCommand(program) {
             }
         }
         // ══════════════════════════════════════════════════════════════════════
-        // Zeige betroffene Commits
+        // Show affected commits
         // ══════════════════════════════════════════════════════════════════════
         const recentLog = await (0, git_js_1.gitLogOneline)(repoRoot, numCommits + 2);
         const logLines = recentLog.split("\n").filter((l) => l.trim());
@@ -57,7 +57,7 @@ function registerResetCommand(program) {
         // eslint-disable-next-line no-console
         console.log("");
         // ══════════════════════════════════════════════════════════════════════
-        // Reset-Modus wählen
+        // Choose reset mode
         // ══════════════════════════════════════════════════════════════════════
         let mode = "mixed";
         if (opts.soft) {
@@ -75,7 +75,7 @@ function registerResetCommand(program) {
             mode = await (0, input_js_1.promptSelect)("Reset mode", choices, "mixed");
         }
         // ══════════════════════════════════════════════════════════════════════
-        // Letzte Bestätigung bei Hard Reset
+        // Final confirmation for hard reset
         // ══════════════════════════════════════════════════════════════════════
         if (mode === "hard" && !opts.yes) {
             // eslint-disable-next-line no-console
@@ -88,7 +88,7 @@ function registerResetCommand(program) {
             }
         }
         // ══════════════════════════════════════════════════════════════════════
-        // Git Reset ausführen
+        // Execute git reset
         // ══════════════════════════════════════════════════════════════════════
         const resetArg = `HEAD~${numCommits}`;
         const modeArg = mode === "mixed" ? "" : `--${mode}`;
@@ -102,14 +102,14 @@ function registerResetCommand(program) {
             process.exit(1);
         }
         // ══════════════════════════════════════════════════════════════════════
-        // Erfolgsmeldung
+        // Success message
         // ══════════════════════════════════════════════════════════════════════
         const newLog = await (0, git_js_1.gitLogOneline)(repoRoot, 1);
         // eslint-disable-next-line no-console
         console.log(`✅ Reset successful!`);
         // eslint-disable-next-line no-console
         console.log(`📍 New HEAD: ${newLog}\n`);
-        // Hinweise
+        // Tips
         if (mode === "soft" || mode === "mixed") {
             // eslint-disable-next-line no-console
             console.log(`💡 Tip: Changes are still there.`);

package/dist/commands/run.js

@@ -46,15 +46,15 @@ function registerRunCommand(program) {
     program
         .command("run")
         .description("Combined workflow: Start → Watch → Checkpoints → Review")
-        .option("-t, --template <id>", "Vorlage: feature, bugfix, refactor, concept, analyze, review")
+        .option("-t, --template <id>", "Template: feature, bugfix, refactor, concept, analyze, review")
         .option("--minutes <n>", "Minutes between checkpoint reminders")
         .option("--no-watch", "Don't start watcher")
-        .option("--action <text>", "ACTION direkt angeben")
-        .option("-C, --clipboard", "Prompt in Zwischenablage kopieren")
+        .option("--action <text>", "Provide ACTION directly")
+        .option("-C, --clipboard", "Copy prompt to clipboard")
         .action(async (opts) => {
         const repoRoot = await (0, paths_js_1.findRepoRoot)(process.cwd());
         if (!repoRoot)
-            throw new Error("Nicht in einem Git-Repository.");
+            throw new Error("Not in a git repository.");
         const [state, config] = await Promise.all([(0, artifacts_js_1.loadState)(repoRoot), (0, config_js_1.loadConfig)(repoRoot)]);
         // Use preset checkpoint interval if not specified
         const minutes = opts.minutes
@@ -76,17 +76,17 @@ function registerRunCommand(program) {
         // ════════════════════════════════════════════════════════════════════════
         // eslint-disable-next-line no-console
         console.log(`━━━ PHASE 1: Prompt ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`);
-        // Template auswählen
+        // Select template
         let template = opts.template ? (0, prompts_js_1.getTemplateById)(opts.template) : undefined;
         if (!template && !opts.action) {
             const choices = prompts_js_1.PROMPT_TEMPLATES.map((t) => ({
                 value: t.id,
                 label: `${t.name} - ${t.description}`,
             }));
-            const selectedId = await (0, input_js_1.promptSelect)("📋 Vorlage wählen", choices, "feature");
+            const selectedId = await (0, input_js_1.promptSelect)("📋 Choose template", choices, "feature");
             template = (0, prompts_js_1.getTemplateById)(selectedId);
         }
-        // 6-Elemente sammeln
+        // Collect the 6 elements
         const el = {
             role: template?.defaults.role,
             context: template?.defaults.context,
@@ -95,14 +95,14 @@ function registerRunCommand(program) {
         };
         const layer = template?.layer ?? state.profile;
         if (!el.action?.trim()) {
-            el.action = await (0, input_js_1.promptText)("⚡ ACTION (Was soll gemacht werden?)", "");
+            el.action = await (0, input_js_1.promptText)("⚡ ACTION (what should be built?)", "");
         }
         if (!el.context?.trim()) {
-            el.context = await (0, input_js_1.promptText)("📍 KONTEXT (Projekt, Stack)", "");
+            el.context = await (0, input_js_1.promptText)("📍 CONTEXT (project, stack)", "");
         }
-        // Prompt generieren
+        // Generate prompt
         const prompt = (0, prompts_js_1.renderSixElementPrompt)(layer, el);
-        // Artefakt speichern
+        // Save artifact
         const ts = (0, artifacts_js_1.timestampId)();
         const filename = `${ts}-run.md`;
         const content = [
@@ -110,7 +110,7 @@ function registerRunCommand(program) {
             ``,
             `- Profile: **${presetProfile}**`,
             `- Layer: **${layer}**`,
-            template ? `- Vorlage: **${template.name}**` : "",
+            template ? `- Template: **${template.name}**` : "",
             `- Checkpoint interval: **${minutes} min**`,
             ``,
             `## Prompt`,
@@ -126,7 +126,7 @@ function registerRunCommand(program) {
         // eslint-disable-next-line no-console
         console.log(`✅ Template: ${template?.name ?? "custom"}`);
         // eslint-disable-next-line no-console
-        console.log(`✅ Artefakt: ${artifactPath}`);
+        console.log(`✅ Artifact: ${artifactPath}`);
         // Clipboard
         if (opts.clipboard) {
             const clipMsg = await (0, clipboard_js_1.copyAndNotify)(prompt);
@@ -148,19 +148,19 @@ function registerRunCommand(program) {
         // ════════════════════════════════════════════════════════════════════════
         if (opts.watch === false) {
             // eslint-disable-next-line no-console
-            console.log(`━━━ PHASE 2: Übersprungen ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`);
+            console.log(`━━━ PHASE 2: Skipped ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`);
             // eslint-disable-next-line no-console
             console.log("Watcher not started (--no-watch).\n");
             // eslint-disable-next-line no-console
             console.log("💡 Next steps:");
             // eslint-disable-next-line no-console
-            console.log("   1. Prompt in Cursor einfügen");
+            console.log("   1. Paste the prompt into Cursor");
             // eslint-disable-next-line no-console
-            console.log("   2. `pulse checkpoint` alle 5-10 Min");
+            console.log("   2. Run `pulse checkpoint` every 5-10 min");
             // eslint-disable-next-line no-console
-            console.log("   3. Bei Problemen: `pulse escalate`");
+            console.log("   3. If stuck: `pulse escalate`");
             // eslint-disable-next-line no-console
-            console.log("   4. Am Ende: `pulse review`\n");
+            console.log("   4. At the end: `pulse review`\n");
             return;
         }
         // eslint-disable-next-line no-console
@@ -170,12 +170,12 @@ function registerRunCommand(program) {
         // eslint-disable-next-line no-console
         console.log(`📍 Watcher running... (Ctrl+C to stop)\n`);
         // eslint-disable-next-line no-console
-        console.log(`   1. Kopiere den Prompt oben in Cursor`);
+        console.log(`   1. Paste the prompt above into Cursor`);
         // eslint-disable-next-line no-console
-        console.log(`   2. Arbeite los`);
+        console.log(`   2. Start working`);
         // eslint-disable-next-line no-console
-        console.log(`   3. Ctrl+C wenn fertig\n`);
-        await (0, notifications_js_1.notify)(config.notifications, "Pulse Run gestartet", `Checkpoint reminder every ${minutes} min. Ctrl+C to exit.`);
+        console.log(`   3. Ctrl+C when done\n`);
+        await (0, notifications_js_1.notify)(config.notifications, "Pulse Run started", `Checkpoint reminder every ${minutes} min. Ctrl+C to exit.`);
         // Update state
         state.lastCheckpointAt = new Date().toISOString();
         await (0, artifacts_js_1.saveState)(repoRoot, state);
@@ -200,11 +200,11 @@ function registerRunCommand(program) {
                 // eslint-disable-next-line no-console
                 console.log(`└${"─".repeat(58)}┘`);
                 // eslint-disable-next-line no-console
-                console.log(`   Zeit: ${new Date().toLocaleTimeString()}`);
+                console.log(`   Time: ${new Date().toLocaleTimeString()}`);
                 // eslint-disable-next-line no-console
-                console.log(`   Status: Uncommitted Changes vorhanden`);
+                console.log(`   Status: uncommitted changes present`);
                 // eslint-disable-next-line no-console
-                console.log(`   → pulse checkpoint -m 'deine message'\n`);
+                console.log(`   → pulse checkpoint -m 'your message'\n`);
             }
             else {
                 // eslint-disable-next-line no-console
@@ -217,15 +217,15 @@ function registerRunCommand(program) {
         const cleanup = async (signal) => {
             clearInterval(interval);
             // eslint-disable-next-line no-console
-            console.log(`\n\n━━━ PHASE 3: Abschluss ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`);
+            console.log(`\n\n━━━ PHASE 3: Wrap-up ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`);
             // eslint-disable-next-line no-console
-            console.log(`🛑 ${signal} empfangen - Beende Pulse Run...\n`);
+            console.log(`🛑 Received ${signal} - stopping Pulse Run...\n`);
             // Check final status
             const status = await (0, git_js_1.gitStatusPorcelain)(repoRoot);
             const dirty = status.trim().length > 0;
             if (dirty) {
                 // eslint-disable-next-line no-console
-                console.log("📝 Uncommitted Changes gefunden:\n");
+                console.log("📝 Uncommitted changes found:\n");
                 const stat = await (0, git_js_1.gitDiffStat)(repoRoot);
                 // eslint-disable-next-line no-console
                 console.log(stat);
@@ -243,25 +243,25 @@ function registerRunCommand(program) {
             }
             else {
                 // eslint-disable-next-line no-console
-                console.log("✨ Keine uncommitted Changes.\n");
+                console.log("✨ No uncommitted changes.\n");
             }
             // Offer review
             const doReview = await (0, input_js_1.promptConfirm)("Create review?", dirty);
             if (doReview) {
                 // eslint-disable-next-line no-console
-                console.log("\n💡 Führe aus: pulse review\n");
+                console.log("\n💡 Run: pulse review\n");
             }
             // Summary
             // eslint-disable-next-line no-console
             console.log(`┌${"─".repeat(58)}┐`);
             // eslint-disable-next-line no-console
-            console.log(`│ 👋 Pulse Run beendet${" ".repeat(37)}│`);
+            console.log(`│ 👋 Pulse Run finished${" ".repeat(35)}│`);
             // eslint-disable-next-line no-console
             console.log(`│                                                          │`);
             // eslint-disable-next-line no-console
             console.log(`│ Checkpoints: ${checkpointCount}${" ".repeat(43 - String(checkpointCount).length)}│`);
             // eslint-disable-next-line no-console
-            console.log(`│ Artefakt: .pulse/pulses/${filename}${" ".repeat(Math.max(0, 32 - filename.length))}│`);
+            console.log(`│ Artifact: .pulse/pulses/${filename}${" ".repeat(Math.max(0, 32 - filename.length))}│`);
             // eslint-disable-next-line no-console
             console.log(`└${"─".repeat(58)}┘\n`);
             process.exit(0);

package/dist/hooks/install.js

@@ -75,13 +75,39 @@ fi
 `, "utf8");
     await ensureExecutable(postCommit);
     await promises_1.default.writeFile(prePush, `#!/bin/sh
-set -e
-
 # Pulse safeguard: never push without explicit permission.
 # Allow push explicitly by running:
 #   PULSE_ALLOW_PUSH=1 git push ...
 
-pulse doctor --hook pre-push
+if [ "$PULSE_SKIP_HOOKS" = "1" ]; then
+  exit 0
+fi
+
+if [ "$PULSE_ALLOW_PUSH" != "1" ]; then
+  echo "PULSE safeguard: push blocked. Set PULSE_ALLOW_PUSH=1 for an explicit push."
+  exit 1
+fi
+
+# Run doctor check if pulse CLI is available
+if command -v pulse >/dev/null 2>&1; then
+  pulse doctor --hook pre-push
+  EXIT_CODE=$?
+elif command -v pulse-framework >/dev/null 2>&1; then
+  pulse-framework doctor --hook pre-push
+  EXIT_CODE=$?
+else
+  EXIT_CODE=0
+fi
+
+# Only block on CRITICAL (exit 2), allow warnings (exit 1) - consistent with pre-commit
+if [ $EXIT_CODE -eq 2 ]; then
+  echo ""
+  echo "❌ Push blocked by PULSE (critical findings)"
+  echo "   Fix issues or use: PULSE_SKIP_HOOKS=1 git push ..."
+  exit 2
+fi
+
+exit 0
 `, "utf8");
     await ensureExecutable(prePush);
     // eslint-disable-next-line no-console

package/dist/lib/input.js

@@ -37,7 +37,7 @@ async function promptSelect(label, choices, defaultValue) {
         });
         // eslint-disable-next-line no-console
         console.log("");
-        const ans = await rl.question("Nummer wählen: ");
+        const ans = await rl.question("Enter number: ");
         const num = parseInt(ans.trim(), 10);
         if (num >= 1 && num <= choices.length) {
             const choice = choices[num - 1];
@@ -65,12 +65,13 @@ async function promptSelect(label, choices, defaultValue) {
 async function promptConfirm(label, defaultYes = false) {
     const rl = promises_1.default.createInterface({ input: process.stdin, output: process.stdout });
     try {
-        const hint = defaultYes ? "(J/n)" : "(j/N)";
+        const hint = defaultYes ? "(Y/n)" : "(y/N)";
         const ans = await rl.question(`${label} ${hint}: `);
         const v = ans.trim().toLowerCase();
-        if (v === "j" || v === "y" || v === "ja" || v === "yes")
+        // Accept a few common variants (English + legacy German inputs)
+        if (v === "y" || v === "yes" || v === "j" || v === "ja")
             return true;
-        if (v === "n" || v === "nein" || v === "no")
+        if (v === "n" || v === "no" || v === "nein")
             return false;
         return defaultYes;
     }

package/package.json

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

package/templates/cursor/pulse.mdc

@@ -156,4 +156,4 @@ Agent:
 - Call the tools ACTIVELY, not only when user asks
 - When uncertain: STOP and ASK
 - The safeguards ALWAYS apply, even if user argues against them
-- **ALWAYS update CHANGELOG.md** after significant changes (features, fixes, changes)
+- **ALWAYS update CHANGELOG.md** after significant changes (features, fixes, changes)