pulse-framework-cli 0.4.1

package/dist/commands/run.js

@@ -0,0 +1,272 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRunCommand = registerRunCommand;
+const artifacts_js_1 = require("../lib/artifacts.js");
+const config_js_1 = require("../lib/config.js");
+const input_js_1 = require("../lib/input.js");
+const paths_js_1 = require("../lib/paths.js");
+const git_js_1 = require("../lib/git.js");
+const notifications_js_1 = require("../lib/notifications.js");
+const clipboard_js_1 = require("../lib/clipboard.js");
+const prompts_js_1 = require("../lib/prompts.js");
+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("--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")
+        .action(async (opts) => {
+        const repoRoot = await (0, paths_js_1.findRepoRoot)(process.cwd());
+        if (!repoRoot)
+            throw new Error("Nicht in einem 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
+            ? Math.max(5, Number(opts.minutes))
+            : config.checkpointReminderMinutes ?? 30;
+        const presetProfile = config.preset ? `${config.preset}/${state.profile}` : state.profile;
+        // ════════════════════════════════════════════════════════════════════════
+        // HEADER
+        // ════════════════════════════════════════════════════════════════════════
+        // eslint-disable-next-line no-console
+        console.log(`
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+┃  🚀 PULSE Run                                                 ┃
+┃  Profile: ${presetProfile.padEnd(49)}┃
+┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+`);
+        // ════════════════════════════════════════════════════════════════════════
+        // PHASE 1: Create prompt
+        // ════════════════════════════════════════════════════════════════════════
+        // eslint-disable-next-line no-console
+        console.log(`━━━ PHASE 1: Prompt ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`);
+        // Template auswählen
+        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");
+            template = (0, prompts_js_1.getTemplateById)(selectedId);
+        }
+        // 6-Elemente sammeln
+        const el = {
+            role: template?.defaults.role,
+            context: template?.defaults.context,
+            output: template?.defaults.output,
+            action: opts.action,
+        };
+        const layer = template?.layer ?? state.profile;
+        if (!el.action?.trim()) {
+            el.action = await (0, input_js_1.promptText)("⚡ ACTION (Was soll gemacht werden?)", "");
+        }
+        if (!el.context?.trim()) {
+            el.context = await (0, input_js_1.promptText)("📍 KONTEXT (Projekt, Stack)", "");
+        }
+        // Prompt generieren
+        const prompt = (0, prompts_js_1.renderSixElementPrompt)(layer, el);
+        // Artefakt speichern
+        const ts = (0, artifacts_js_1.timestampId)();
+        const filename = `${ts}-run.md`;
+        const content = [
+            `# Pulse Run (${ts})`,
+            ``,
+            `- Profile: **${presetProfile}**`,
+            `- Layer: **${layer}**`,
+            template ? `- Vorlage: **${template.name}**` : "",
+            `- Checkpoint interval: **${minutes} min**`,
+            ``,
+            `## Prompt`,
+            ``,
+            "```",
+            prompt.trimEnd(),
+            "```",
+            ``,
+        ]
+            .filter((line) => line !== "")
+            .join("\n");
+        const artifactPath = await (0, artifacts_js_1.writeArtifact)(repoRoot, "pulses", filename, content);
+        // eslint-disable-next-line no-console
+        console.log(`✅ Template: ${template?.name ?? "custom"}`);
+        // eslint-disable-next-line no-console
+        console.log(`✅ Artefakt: ${artifactPath}`);
+        // Clipboard
+        if (opts.clipboard) {
+            const clipMsg = await (0, clipboard_js_1.copyAndNotify)(prompt);
+            // eslint-disable-next-line no-console
+            console.log(clipMsg);
+        }
+        // eslint-disable-next-line no-console
+        console.log(`\n┌${"─".repeat(58)}┐`);
+        // eslint-disable-next-line no-console
+        console.log(`│ PROMPT ${opts.clipboard ? "(copied)" : "(copy and paste into Cursor)"}${" ".repeat(opts.clipboard ? 35 : 19)}│`);
+        // eslint-disable-next-line no-console
+        console.log(`└${"─".repeat(58)}┘\n`);
+        // eslint-disable-next-line no-console
+        console.log(prompt.trimEnd());
+        // eslint-disable-next-line no-console
+        console.log(`\n${"─".repeat(60)}\n`);
+        // ════════════════════════════════════════════════════════════════════════
+        // PHASE 2: Watch Loop
+        // ════════════════════════════════════════════════════════════════════════
+        if (opts.watch === false) {
+            // eslint-disable-next-line no-console
+            console.log(`━━━ PHASE 2: Übersprungen ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\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");
+            // eslint-disable-next-line no-console
+            console.log("   2. `pulse checkpoint` alle 5-10 Min");
+            // eslint-disable-next-line no-console
+            console.log("   3. Bei Problemen: `pulse escalate`");
+            // eslint-disable-next-line no-console
+            console.log("   4. Am Ende: `pulse review`\n");
+            return;
+        }
+        // eslint-disable-next-line no-console
+        console.log(`━━━ PHASE 2: Watcher ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`);
+        // eslint-disable-next-line no-console
+        console.log(`⏱️  Checkpoint interval: ${minutes} min (${config.preset ?? "custom"} preset)`);
+        // 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`);
+        // eslint-disable-next-line no-console
+        console.log(`   2. Arbeite los`);
+        // 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.`);
+        // Update state
+        state.lastCheckpointAt = new Date().toISOString();
+        await (0, artifacts_js_1.saveState)(repoRoot, state);
+        let checkpointCount = 0;
+        let lastReminderAt = Date.now();
+        // Polling loop
+        const interval = setInterval(async () => {
+            const now = Date.now();
+            const shouldRemind = now - lastReminderAt >= minutes * 60_000;
+            if (!shouldRemind)
+                return;
+            lastReminderAt = now;
+            const status = await (0, git_js_1.gitStatusPorcelain)(repoRoot);
+            const dirty = status.trim().length > 0;
+            if (dirty) {
+                checkpointCount++;
+                await (0, notifications_js_1.notify)(config.notifications, `⏱️ Checkpoint #${checkpointCount}`, `${minutes} min passed. Time for: pulse checkpoint`);
+                // eslint-disable-next-line no-console
+                console.log(`\n┌${"─".repeat(58)}┐`);
+                // eslint-disable-next-line no-console
+                console.log(`│ ⏰ CHECKPOINT REMINDER #${checkpointCount}${" ".repeat(58 - 26 - String(checkpointCount).length)}│`);
+                // eslint-disable-next-line no-console
+                console.log(`└${"─".repeat(58)}┘`);
+                // eslint-disable-next-line no-console
+                console.log(`   Zeit: ${new Date().toLocaleTimeString()}`);
+                // eslint-disable-next-line no-console
+                console.log(`   Status: Uncommitted Changes vorhanden`);
+                // eslint-disable-next-line no-console
+                console.log(`   → pulse checkpoint -m 'deine message'\n`);
+            }
+            else {
+                // eslint-disable-next-line no-console
+                console.log(`\n✨ [${new Date().toLocaleTimeString()}] Repo is clean - no checkpoint needed\n`);
+            }
+        }, 30_000); // Check every 30 seconds
+        // ════════════════════════════════════════════════════════════════════════
+        // PHASE 3: Cleanup on exit
+        // ════════════════════════════════════════════════════════════════════════
+        const cleanup = async (signal) => {
+            clearInterval(interval);
+            // eslint-disable-next-line no-console
+            console.log(`\n\n━━━ PHASE 3: Abschluss ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`);
+            // eslint-disable-next-line no-console
+            console.log(`🛑 ${signal} empfangen - Beende 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");
+                const stat = await (0, git_js_1.gitDiffStat)(repoRoot);
+                // eslint-disable-next-line no-console
+                console.log(stat);
+                // eslint-disable-next-line no-console
+                console.log("");
+                const doCheckpoint = await (0, input_js_1.promptConfirm)("Create checkpoint?", true);
+                if (doCheckpoint) {
+                    const msg = await (0, input_js_1.promptText)("Commit message", "checkpoint: work in progress");
+                    const { exec } = await Promise.resolve().then(() => __importStar(require("../lib/exec.js")));
+                    await exec("git", ["add", "-A"], { cwd: repoRoot });
+                    await exec("git", ["commit", "-m", msg], { cwd: repoRoot });
+                    // eslint-disable-next-line no-console
+                    console.log("✅ Committed.\n");
+                }
+            }
+            else {
+                // eslint-disable-next-line no-console
+                console.log("✨ Keine 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");
+            }
+            // Summary
+            // eslint-disable-next-line no-console
+            console.log(`┌${"─".repeat(58)}┐`);
+            // eslint-disable-next-line no-console
+            console.log(`│ 👋 Pulse Run beendet${" ".repeat(37)}│`);
+            // 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))}│`);
+            // eslint-disable-next-line no-console
+            console.log(`└${"─".repeat(58)}┘\n`);
+            process.exit(0);
+        };
+        process.on("SIGINT", () => cleanup("SIGINT"));
+        process.on("SIGTERM", () => cleanup("SIGTERM"));
+    });
+}

package/dist/commands/start.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerStartCommand(program: Command): void;

package/dist/commands/start.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerStartCommand = registerStartCommand;
+const artifacts_js_1 = require("../lib/artifacts.js");
+const config_js_1 = require("../lib/config.js");
+const input_js_1 = require("../lib/input.js");
+const paths_js_1 = require("../lib/paths.js");
+const clipboard_js_1 = require("../lib/clipboard.js");
+const git_js_1 = require("../lib/git.js");
+const prompts_js_1 = require("../lib/prompts.js");
+function registerStartCommand(program) {
+    program
+        .command("start")
+        .alias("s") // Kurzform: pulse s
+        .description("Start a new Pulse with 6-element prompt")
+        .option("-t, --template <id>", "Template: feature, bugfix, refactor, concept, analyze, review")
+        .option("-q, --quick", "Quick-Mode: Ask only for ACTION")
+        .option("--role <text>", "ROLE")
+        .option("--context <text>", "CONTEXT")
+        .option("--input <text>", "INPUT")
+        .option("--action <text>", "ACTION")
+        .option("--output <text>", "OUTPUT")
+        .option("--examples <text>", "EXAMPLES")
+        .option("--ist <text>", "AS-IS state (for AS-IS/TO-BE prompt)")
+        .option("--soll <text>", "TO-BE state (for AS-IS/TO-BE prompt)")
+        .option("-C, --clipboard", "Copy prompt to clipboard")
+        .option("--no-branch-check", "Skip branch check (for MCP/Automation)")
+        .action(async (opts) => {
+        const repoRoot = await (0, paths_js_1.findRepoRoot)(process.cwd());
+        if (!repoRoot)
+            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)]);
+        // eslint-disable-next-line no-console
+        console.log("\n🎯 PULSE Start\n");
+        // ══════════════════════════════════════════════════════════════════════
+        // Branch check: Warning on main/master (only interactive, not with --quick)
+        // ══════════════════════════════════════════════════════════════════════
+        const skipBranchCheck = opts.branchCheck === false || opts.quick;
+        if (!skipBranchCheck) {
+            const currentBranch = await (0, git_js_1.gitCurrentBranch)(repoRoot);
+            const isMain = await (0, git_js_1.gitIsMainBranch)(repoRoot);
+            if (isMain) {
+                // eslint-disable-next-line no-console
+                console.log(`⚠️  You are on '${currentBranch}' – Feature branch recommended!\n`);
+                const createBranch = await (0, input_js_1.promptConfirm)("Create feature branch?", true);
+                if (createBranch) {
+                    const branchName = await (0, input_js_1.promptText)("Branch name (e.g., feature/user-dashboard)", "feature/");
+                    if (branchName && branchName !== "feature/") {
+                        const success = await (0, git_js_1.gitCreateBranch)(repoRoot, branchName);
+                        if (success) {
+                            // eslint-disable-next-line no-console
+                            console.log(`✅ Branch created: ${branchName}\n`);
+                        }
+                        else {
+                            // eslint-disable-next-line no-console
+                            console.log(`❌ Could not create branch\n`);
+                        }
+                    }
+                }
+                else {
+                    // eslint-disable-next-line no-console
+                    console.log(`ℹ️  Working on '${currentBranch}' (not recommended)\n`);
+                }
+            }
+        }
+        // ══════════════════════════════════════════════════════════════════════
+        // AS-IS/TO-BE Quick Prompt (for quick bug fixes)
+        // ══════════════════════════════════════════════════════════════════════
+        if (opts.ist || opts.soll) {
+            const ist = opts.ist ?? (await (0, input_js_1.promptText)("AS-IS (current state)", ""));
+            const soll = opts.soll ?? (await (0, input_js_1.promptText)("TO-BE (desired state)", ""));
+            const error = await (0, input_js_1.promptText)("ERROR log (optional, Enter to skip)", "");
+            const prompt = (0, prompts_js_1.renderIstSollPrompt)({ ist, soll, error, context: opts.context });
+            await saveAndPrint(repoRoot, "istsoll", prompt, undefined, opts.clipboard);
+            return;
+        }
+        // ══════════════════════════════════════════════════════════════════════
+        // Template selection (interactive or via flag)
+        // ══════════════════════════════════════════════════════════════════════
+        let template = opts.template ? (0, prompts_js_1.getTemplateById)(opts.template) : undefined;
+        let layer = state.profile;
+        // If no template and no flags → interactive selection
+        if (!template && (0, prompts_js_1.countProvidedElements)(opts) < 2 && !opts.quick) {
+            // eslint-disable-next-line no-console
+            console.log("What do you want to do?\n");
+            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)("Choose template", choices, "feature");
+            template = (0, prompts_js_1.getTemplateById)(selectedId);
+        }
+        // Merge template defaults
+        const el = {
+            role: opts.role ?? template?.defaults.role,
+            context: opts.context ?? template?.defaults.context,
+            input: opts.input ?? template?.defaults.input,
+            action: opts.action ?? template?.defaults.action,
+            output: opts.output ?? template?.defaults.output,
+            examples: opts.examples ?? template?.defaults.examples,
+        };
+        if (template) {
+            layer = template.layer;
+        }
+        // ══════════════════════════════════════════════════════════════════════
+        // Interaktive Abfrage der fehlenden Elemente
+        // ══════════════════════════════════════════════════════════════════════
+        if (opts.quick) {
+            // Quick Mode: Nur ACTION
+            el.action = el.action ?? (await (0, input_js_1.promptText)("⚡ ACTION (what needs to be done?)", ""));
+        }
+        else if ((0, prompts_js_1.countProvidedElements)(el) < 3) {
+            // Guided Mode: Die wichtigsten Elemente abfragen
+            // eslint-disable-next-line no-console
+            console.log("\n📝 Create 6-element prompt\n");
+            if (!el.action?.trim()) {
+                el.action = await (0, input_js_1.promptText)("⚡ ACTION (What should the AI do?)", "");
+            }
+            if (!el.context?.trim()) {
+                el.context = await (0, input_js_1.promptText)("📍 CONTEXT (Project, Stack, Situation)", el.context ?? "");
+            }
+            if (!el.role?.trim()) {
+                el.role = await (0, input_js_1.promptText)("👤 ROLE (Who should the AI be?)", el.role ?? "Senior Software Engineer");
+            }
+            // Optional: Mehr Details?
+            const wantMore = await (0, input_js_1.promptText)("Enter more details? (y/n)", "n");
+            if (wantMore.toLowerCase() === "j" || wantMore.toLowerCase() === "y") {
+                if (!el.input?.trim()) {
+                    el.input = await (0, input_js_1.promptText)("📥 INPUT (Code, Error, Screenshot description)", "");
+                }
+                if (!el.output?.trim()) {
+                    el.output = await (0, input_js_1.promptText)("📤 OUTPUT (What is the expected outcome?)", "");
+                }
+            }
+        }
+        // ══════════════════════════════════════════════════════════════════════
+        // Generate and save prompt
+        // ══════════════════════════════════════════════════════════════════════
+        const prompt = (0, prompts_js_1.renderSixElementPrompt)(layer, el);
+        const actionWarning = (0, prompts_js_1.validateOneAction)(el.action);
+        await saveAndPrint(repoRoot, "start", prompt, {
+            layer,
+            elementCount: (0, prompts_js_1.countProvidedElements)(el),
+            actionWarning,
+            template: template?.name,
+        }, opts.clipboard);
+        if (config.enforcement !== "advisory" && actionWarning) {
+            // eslint-disable-next-line no-console
+            console.log(`\n⚠️  ${actionWarning}`);
+        }
+    });
+}
+// Helper: Save and output
+async function saveAndPrint(repoRoot, type, prompt, meta, clipboard) {
+    const ts = (0, artifacts_js_1.timestampId)();
+    const filename = `${ts}-${type}.md`;
+    const content = [
+        `# Pulse: ${type.toUpperCase()} (${ts})`,
+        ``,
+        meta?.layer ? `- Layer: **${meta.layer}**` : "",
+        meta?.template ? `- Template: **${meta.template}**` : "",
+        meta?.elementCount ? `- Elements: **${meta.elementCount}/6**` : "",
+        meta?.actionWarning ? `- ⚠️ ${meta.actionWarning}` : "",
+        ``,
+        `## Prompt (copy and paste into Cursor/ChatGPT)`,
+        ``,
+        "```",
+        prompt.trimEnd(),
+        "```",
+        ``,
+        `## Tips`,
+        `- Observe safeguards: MAX 30 min autonomous`,
+        `- Git commit every 5-10 min`,
+        `- If stuck: \`pulse escalate\``,
+        ``,
+    ]
+        .filter((line) => line !== "")
+        .join("\n");
+    const p = await (0, artifacts_js_1.writeArtifact)(repoRoot, "pulses", filename, content);
+    // eslint-disable-next-line no-console
+    console.log(`\n✅ Saved: ${p}`);
+    // Clipboard
+    if (clipboard) {
+        const clipboardMsg = await (0, clipboard_js_1.copyAndNotify)(prompt);
+        // eslint-disable-next-line no-console
+        console.log(clipboardMsg);
+    }
+    // eslint-disable-next-line no-console
+    console.log(`\n${"─".repeat(60)}`);
+    // eslint-disable-next-line no-console
+    console.log(`\n📋 PROMPT${clipboard ? " (copied)" : " (copy)"}:\n`);
+    // eslint-disable-next-line no-console
+    console.log(prompt.trimEnd());
+    // eslint-disable-next-line no-console
+    console.log(`\n${"─".repeat(60)}\n`);
+}

package/dist/commands/status.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerStatusCommand(program: Command): void;