pulse-framework-cli 0.4.1

package/dist/commands/learn.js

@@ -0,0 +1,137 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLearnCommand = registerLearnCommand;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const artifacts_js_1 = require("../lib/artifacts.js");
+const input_js_1 = require("../lib/input.js");
+const paths_js_1 = require("../lib/paths.js");
+function registerLearnCommand(program) {
+    program
+        .command("learn")
+        .description("Save learned knowledge (Problem → Solution → Rule)")
+        .option("--problem <text>", "What was the problem?")
+        .option("--solution <text>", "What was the solution?")
+        .option("--rule <text>", "Derived rule")
+        .option("--reason <text>", "Why this rule?")
+        .option("--no-promote", "Do not ask to update .cursorrules")
+        .action(async (opts) => {
+        const repoRoot = await (0, paths_js_1.findRepoRoot)(process.cwd());
+        if (!repoRoot)
+            throw new Error("Not in a git repository.");
+        await (0, artifacts_js_1.ensurePulseDirs)(repoRoot);
+        // eslint-disable-next-line no-console
+        console.log("\n📚 PULSE Learn\n");
+        // Gather information
+        const problem = opts.problem ?? (await (0, input_js_1.promptText)("What was the problem?", ""));
+        const solution = opts.solution ?? (await (0, input_js_1.promptText)("What was the solution?", ""));
+        const rule = opts.rule ?? (await (0, input_js_1.promptText)("Derived rule (what to observe?)", ""));
+        const reason = opts.reason ?? (await (0, input_js_1.promptText)("Why? (optional)", ""));
+        const ts = (0, artifacts_js_1.timestampId)();
+        // ════════════════════════════════════════════════════════════════════════
+        // Create memory entry
+        // ════════════════════════════════════════════════════════════════════════
+        const entry = [
+            `## Learning: ${ts}`,
+            ``,
+            problem.trim() ? `**Problem:** ${problem.trim()}` : "",
+            solution.trim() ? `**Solution:** ${solution.trim()}` : "",
+            rule.trim() ? `**Rule:** ${rule.trim()}` : "",
+            reason.trim() ? `**Reason:** ${reason.trim()}` : "",
+            ``,
+            `---`,
+            ``,
+        ]
+            .filter((l) => l !== "")
+            .join("\n");
+        const memPath = node_path_1.default.join((0, paths_js_1.pulseDir)(repoRoot), "memory.md");
+        // Create file with header if doesn't exist
+        try {
+            await promises_1.default.access(memPath);
+        }
+        catch {
+            const header = `# PULSE Memory\n\nLearned rules and insights from this project.\n\n---\n\n`;
+            await promises_1.default.writeFile(memPath, header, "utf8");
+        }
+        await promises_1.default.appendFile(memPath, entry, "utf8");
+        // eslint-disable-next-line no-console
+        console.log(`✅ Saved: ${memPath}`);
+        // ════════════════════════════════════════════════════════════════════════
+        // Auto-Promotion zu .cursorrules
+        // ════════════════════════════════════════════════════════════════════════
+        if (rule.trim() && opts.promote !== false) {
+            // eslint-disable-next-line no-console
+            console.log(`\n${"─".repeat(50)}`);
+            // eslint-disable-next-line no-console
+            console.log(`\n📋 Proposal for .cursorrules:\n`);
+            const cursorrulesSnippet = formatCursorrulesSnippet(rule, reason, problem);
+            // eslint-disable-next-line no-console
+            console.log(cursorrulesSnippet);
+            const doPromote = await (0, input_js_1.promptConfirm)("\nAdd to .cursorrules?", true);
+            if (doPromote) {
+                const cursorrulesPath = node_path_1.default.join(repoRoot, ".cursorrules");
+                await appendToCursorrules(cursorrulesPath, cursorrulesSnippet);
+                // eslint-disable-next-line no-console
+                console.log(`\n✅ Added to .cursorrules!`);
+            }
+            else {
+                // eslint-disable-next-line no-console
+                console.log(`\nℹ️ Not added. You can add it manually later.`);
+            }
+        }
+        // eslint-disable-next-line no-console
+        console.log("");
+    });
+}
+/**
+ * Format a rule for .cursorrules
+ */
+function formatCursorrulesSnippet(rule, reason, problem) {
+    const lines = [];
+    lines.push(`# ┌────────────────────────────────────────────────────────────────────────────┐`);
+    lines.push(`# │ LEARNED RULE                                                               │`);
+    lines.push(`# └────────────────────────────────────────────────────────────────────────────┘`);
+    lines.push(`#`);
+    lines.push(`# ${rule.trim()}`);
+    if (reason.trim()) {
+        lines.push(`#`);
+        lines.push(`# Reason: ${reason.trim()}`);
+    }
+    if (problem.trim()) {
+        lines.push(`#`);
+        lines.push(`# Context: ${problem.trim()}`);
+    }
+    lines.push(`#`);
+    return lines.join("\n");
+}
+/**
+ * Append snippet to .cursorrules (create if doesn't exist)
+ */
+async function appendToCursorrules(filepath, snippet) {
+    let content = "";
+    try {
+        content = await promises_1.default.readFile(filepath, "utf8");
+    }
+    catch {
+        // File doesn't exist, create with header
+        content = `# ═══════════════════════════════════════════════════════════════════════════════
+# PULSE FRAMEWORK - AI Agent Rules
+# ═══════════════════════════════════════════════════════════════════════════════
+
+`;
+    }
+    // Check if there's already a "LEARNED RULE" section
+    const hasLearnedSection = content.includes("# LEARNED RULE");
+    if (hasLearnedSection) {
+        // Append to existing section (before the last closing block if possible)
+        content = content.trimEnd() + "\n\n" + snippet + "\n";
+    }
+    else {
+        // Add at the end
+        content = content.trimEnd() + "\n\n" + snippet + "\n";
+    }
+    await promises_1.default.writeFile(filepath, content, "utf8");
+}

package/dist/commands/profile.d.ts

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

package/dist/commands/profile.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerProfileCommand = registerProfileCommand;
+const artifacts_js_1 = require("../lib/artifacts.js");
+const paths_js_1 = require("../lib/paths.js");
+function registerProfileCommand(program) {
+    const profileCmd = program
+        .command("profile")
+        .description("View or set the active Pulse layer profile (concept/build/escalation).");
+    // Show current profile
+    profileCmd
+        .command("show", { isDefault: true })
+        .description("Show current profile")
+        .action(async () => {
+        const repoRoot = await (0, paths_js_1.findRepoRoot)(process.cwd());
+        if (!repoRoot)
+            throw new Error("Not inside a git repository.");
+        const state = await (0, artifacts_js_1.loadState)(repoRoot);
+        // eslint-disable-next-line no-console
+        console.log(state.profile);
+    });
+    // Set profile
+    profileCmd
+        .command("set <layer>")
+        .description("Set profile: concept | build | escalation")
+        .action(async (layer) => {
+        const repoRoot = await (0, paths_js_1.findRepoRoot)(process.cwd());
+        if (!repoRoot)
+            throw new Error("Not inside a git repository.");
+        if (!["concept", "build", "escalation"].includes(layer)) {
+            throw new Error(`Invalid layer: ${layer}. Use: concept | build | escalation`);
+        }
+        const state = await (0, artifacts_js_1.loadState)(repoRoot);
+        state.profile = layer;
+        await (0, artifacts_js_1.saveState)(repoRoot, state);
+        // eslint-disable-next-line no-console
+        console.log(`Profile set to ${state.profile}`);
+    });
+}

package/dist/commands/reset.d.ts

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

package/dist/commands/reset.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerResetCommand = registerResetCommand;
+const paths_js_1 = require("../lib/paths.js");
+const input_js_1 = require("../lib/input.js");
+const exec_js_1 = require("../lib/exec.js");
+const git_js_1 = require("../lib/git.js");
+function registerResetCommand(program) {
+    program
+        .command("reset")
+        .description("Safe Git reset with safeguards (for loop recovery)")
+        .option("-n, --commits <n>", "Number of commits to reset (default: 1)", "1")
+        .option("--soft", "Soft reset (changes remain staged)")
+        .option("--hard", "Hard reset (changes are DISCARDED)")
+        .option("-y, --yes", "Do not ask for confirmation")
+        .action(async (opts) => {
+        const repoRoot = await (0, paths_js_1.findRepoRoot)(process.cwd());
+        if (!repoRoot)
+            throw new Error("Not in a git repository.");
+        const numCommits = Math.max(1, Math.min(10, parseInt(opts.commits ?? "1", 10)));
+        const branch = await (0, git_js_1.gitCurrentBranch)(repoRoot);
+        // eslint-disable-next-line no-console
+        console.log("\n🔄 PULSE Reset\n");
+        // ══════════════════════════════════════════════════════════════════════
+        // Safeguard: Not on main/master without explicit confirmation
+        // ══════════════════════════════════════════════════════════════════════
+        const protectedBranches = ["main", "master", "develop", "production"];
+        if (protectedBranches.includes(branch.toLowerCase())) {
+            // eslint-disable-next-line no-console
+            console.log(`⚠️  WARNING: You are on '${branch}' (protected branch)!\n`);
+            if (!opts.yes) {
+                const confirm = await (0, input_js_1.promptConfirm)(`Really reset on '${branch}'? (not recommended)`, false);
+                if (!confirm) {
+                    // eslint-disable-next-line no-console
+                    console.log("❌ Aborted.\n");
+                    return;
+                }
+            }
+        }
+        // ══════════════════════════════════════════════════════════════════════
+        // Zeige betroffene Commits
+        // ══════════════════════════════════════════════════════════════════════
+        const recentLog = await (0, git_js_1.gitLogOneline)(repoRoot, numCommits + 2);
+        const logLines = recentLog.split("\n").filter((l) => l.trim());
+        // eslint-disable-next-line no-console
+        console.log(`📍 Branch: ${branch}`);
+        // eslint-disable-next-line no-console
+        console.log(`📋 Affected commits (${numCommits}):\n`);
+        for (let i = 0; i < Math.min(numCommits, logLines.length); i++) {
+            // eslint-disable-next-line no-console
+            console.log(`   🗑️  ${logLines[i]}`);
+        }
+        if (logLines.length > numCommits) {
+            // eslint-disable-next-line no-console
+            console.log(`\n   ✅ New HEAD: ${logLines[numCommits]}`);
+        }
+        // eslint-disable-next-line no-console
+        console.log("");
+        // ══════════════════════════════════════════════════════════════════════
+        // Reset-Modus wählen
+        // ══════════════════════════════════════════════════════════════════════
+        let mode = "mixed";
+        if (opts.soft) {
+            mode = "soft";
+        }
+        else if (opts.hard) {
+            mode = "hard";
+        }
+        else if (!opts.yes) {
+            const choices = [
+                { value: "mixed", label: "🔄 Mixed (default) - changes remain unstaged" },
+                { value: "soft", label: "📝 Soft - changes remain staged" },
+                { value: "hard", label: "🗑️ Hard - changes are DISCARDED" },
+            ];
+            mode = await (0, input_js_1.promptSelect)("Reset mode", choices, "mixed");
+        }
+        // ══════════════════════════════════════════════════════════════════════
+        // Letzte Bestätigung bei Hard Reset
+        // ══════════════════════════════════════════════════════════════════════
+        if (mode === "hard" && !opts.yes) {
+            // eslint-disable-next-line no-console
+            console.log("\n⚠️  HARD RESET: All uncommitted changes will be lost!\n");
+            const confirm = await (0, input_js_1.promptConfirm)("Really continue?", false);
+            if (!confirm) {
+                // eslint-disable-next-line no-console
+                console.log("❌ Aborted.\n");
+                return;
+            }
+        }
+        // ══════════════════════════════════════════════════════════════════════
+        // Git Reset ausführen
+        // ══════════════════════════════════════════════════════════════════════
+        const resetArg = `HEAD~${numCommits}`;
+        const modeArg = mode === "mixed" ? "" : `--${mode}`;
+        const args = ["reset", modeArg, resetArg].filter(Boolean);
+        // eslint-disable-next-line no-console
+        console.log(`\n🔧 Running: git ${args.join(" ")}\n`);
+        const result = await (0, exec_js_1.exec)("git", args, { cwd: repoRoot });
+        if (result.exitCode !== 0) {
+            // eslint-disable-next-line no-console
+            console.error(`❌ Git reset failed:\n${result.stderr}`);
+            process.exit(1);
+        }
+        // ══════════════════════════════════════════════════════════════════════
+        // Erfolgsmeldung
+        // ══════════════════════════════════════════════════════════════════════
+        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
+        if (mode === "soft" || mode === "mixed") {
+            // eslint-disable-next-line no-console
+            console.log(`💡 Tip: Changes are still there.`);
+            // eslint-disable-next-line no-console
+            console.log(`   → git status       - Show changes`);
+            // eslint-disable-next-line no-console
+            console.log(`   → git stash        - Stash temporarily`);
+            // eslint-disable-next-line no-console
+            console.log(`   → git checkout .   - Discard\n`);
+        }
+        // eslint-disable-next-line no-console
+        console.log(`💡 Next step:`);
+        // eslint-disable-next-line no-console
+        console.log(`   → pulse start      - Start new approach`);
+        // eslint-disable-next-line no-console
+        console.log(`   → pulse escalate   - Escalate problem\n`);
+    });
+}

package/dist/commands/review.d.ts

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

package/dist/commands/review.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerReviewCommand = registerReviewCommand;
+const artifacts_js_1 = require("../lib/artifacts.js");
+const config_js_1 = require("../lib/config.js");
+const paths_js_1 = require("../lib/paths.js");
+const git_js_1 = require("../lib/git.js");
+const scanner_js_1 = require("../lib/scanner.js");
+const exec_js_1 = require("../lib/exec.js");
+const briefing_js_1 = require("../lib/briefing.js");
+function registerReviewCommand(program) {
+    program
+        .command("review")
+        .alias("r")
+        .description("Review v2: Decision Briefing with automatic aggregation")
+        .option("--staged", "Staged diff instead of working tree")
+        .option("--full", "Full checklist in addition to briefing")
+        .option("--json", "Output as JSON")
+        .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),
+        ]);
+        // Gather all data in parallel
+        const [status, log, diffText, diffStat, diffNumstat, diffNameStatus, logWithFiles] = await Promise.all([
+            (0, git_js_1.gitStatusPorcelain)(repoRoot),
+            (0, git_js_1.gitLogOneline)(repoRoot, 15),
+            (0, git_js_1.gitDiffText)(repoRoot, { staged: opts.staged }),
+            (0, git_js_1.gitDiffStat)(repoRoot, { staged: opts.staged }),
+            (0, git_js_1.gitDiffNumstat)(repoRoot, { staged: opts.staged }),
+            (0, git_js_1.gitDiffNameStatus)(repoRoot, { staged: opts.staged }),
+            (0, exec_js_1.exec)("git", ["log", "--name-only", "--oneline", "-15"], { cwd: repoRoot }).then((r) => r.stdout),
+        ]);
+        // Run scanner
+        const scanResult = (0, scanner_js_1.scanDiff)(config, { diffText, diffStat, diffNumstat, diffNameStatus });
+        // Add loop signals to findings
+        const loopSignals = (0, scanner_js_1.detectLoopSignals)(log, logWithFiles);
+        for (const signal of loopSignals) {
+            scanResult.findings.push({
+                severity: signal.severity,
+                code: "LOOP_SIGNAL",
+                message: signal.message,
+                details: signal.details,
+            });
+        }
+        // Calculate briefing components
+        const scope = (0, briefing_js_1.calculateScopeCheck)(config, scanResult.stats);
+        const risk = (0, briefing_js_1.calculateRiskSummary)(scanResult);
+        const time = (0, briefing_js_1.calculateTimeSummary)(state.lastCheckpointAt, config.checkpointReminderMinutes ?? 30);
+        const recommendation = (0, briefing_js_1.generateRecommendation)(scope, risk, time);
+        const briefing = {
+            preset: config.preset ?? null,
+            profile: state.profile,
+            scope,
+            risk,
+            time,
+            recommendation,
+        };
+        // JSON output
+        if (opts.json) {
+            // eslint-disable-next-line no-console
+            console.log(JSON.stringify(briefing, null, 2));
+            return;
+        }
+        // Render briefing
+        // eslint-disable-next-line no-console
+        console.log("\n" + (0, briefing_js_1.renderBriefing)(briefing) + "\n");
+        // Save artifact
+        const ts = (0, artifacts_js_1.timestampId)();
+        const filename = `${ts}-review.md`;
+        const artifactLines = [
+            `# Review Pulse (${ts})`,
+            ``,
+            `## Decision Briefing`,
+            ``,
+            `- Preset: **${config.preset ?? "custom"}**`,
+            `- Profile: **${state.profile}**`,
+            `- Scope: **${opts.staged ? "staged" : "working tree"}**`,
+            ``,
+            `### Scope-Check`,
+            ``,
+            `| Metric | Current | Limit | Status |`,
+            `|--------|---------|-------|--------|`,
+            `| Files | ${scope.files.current} | ${scope.files.max} | ${scope.files.percent}% |`,
+            `| Lines | ${scope.lines.current} | ${scope.lines.max} | ${scope.lines.percent}% |`,
+            `| Deletes | ${scope.deletes.current} | ${scope.deletes.max} | ${scope.deletes.percent}% |`,
+            ``,
+            `### Risk Summary`,
+            ``,
+            `- Critical: ${risk.criticalCount}`,
+            `- Warnings: ${risk.warningCount}`,
+            `- Loop Risk: ${risk.loopRisk}`,
+            `- Checkpoint: ${time.minutesSinceCheckpoint ?? "n/a"} min`,
+            ``,
+            `### Recommendation`,
+            ``,
+            `**${recommendation.action.toUpperCase()}**: ${recommendation.reason}`,
+            recommendation.command ? `\n→ \`${recommendation.command}\`` : "",
+            ``,
+        ];
+        // Add findings if any
+        if (scanResult.findings.length > 0) {
+            artifactLines.push(`### Findings`, ``);
+            for (const f of scanResult.findings) {
+                const emoji = f.severity === "critical" ? "🚨" : "⚠️";
+                artifactLines.push(`- ${emoji} **${f.code}**: ${f.message}`);
+            }
+            artifactLines.push(``);
+        }
+        // Add full checklist if requested
+        if (opts.full) {
+            artifactLines.push(`---`, ``, `## Full Checklist`, ``, `### Git Context`, ``, `**Status:**`, "```", status || "(clean)", "```", ``, `**Recent Commits:**`, "```", log || "(none)", "```", ``, `**Diff Stat:**`, "```", diffStat || "(no changes)", "```", ``, `### Code Quality`, `- [ ] Do I understand the code? (If no: STOP)`, `- [ ] Naming OK?`, `- [ ] Error handling present?`, `- [ ] Edge cases considered?`, ``, `### Functionality`, `- [ ] Works as required?`, `- [ ] Tested locally?`, `- [ ] Invalid input handling OK?`, ``, `### Security`, `- [ ] No hardcoded secrets?`, `- [ ] Input validation?`, `- [ ] AuthZ/AuthN impact understood?`, ``, `### Git History`, `- [ ] Commit messages clear?`, `- [ ] Changes traceable?`, ``, `### Red Flags`, `- [ ] Code I don't understand`, `- [ ] Hundreds of lines in one commit`, `- [ ] Unknown dependencies`, `- [ ] Deleted files without confirmation`, ``, `## Decision`, ``, `- [ ] ✅ Approve`, `- [ ] ❌ Reject`, `- [ ] 🚨 Escalate`, ``, `**Notes:**`, ``);
+        }
+        const content = artifactLines.filter((l) => l !== "").join("\n");
+        const p = await (0, artifacts_js_1.writeArtifact)(repoRoot, "reviews", filename, content);
+        // eslint-disable-next-line no-console
+        console.log(`✅ Saved: ${p}`);
+        // Show recommendation action
+        if (recommendation.command) {
+            // eslint-disable-next-line no-console
+            console.log(`\n💡 Recommended next step:`);
+            // eslint-disable-next-line no-console
+            console.log(`   → ${recommendation.command}\n`);
+        }
+    });
+}

package/dist/commands/run.d.ts

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