pulse-framework-cli 0.4.1

package/dist/commands/checkpoint.d.ts

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

package/dist/commands/checkpoint.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCheckpointCommand = registerCheckpointCommand;
+const artifacts_js_1 = require("../lib/artifacts.js");
+const config_js_1 = require("../lib/config.js");
+const exec_js_1 = require("../lib/exec.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");
+function registerCheckpointCommand(program) {
+    program
+        .command("checkpoint")
+        .alias("c") // Kurzform: pulse c
+        .description("Git Checkpoint: Check status, detect red flags, optional tests/commit")
+        .option("--staged", "Use staged diff")
+        .option("--inspect-latest", "Inspect the latest commit diff (useful if Cursor auto-committed)")
+        .option("--run-tests", "Run configured test command")
+        .option("-m, --message <msg>", "If provided, run git commit -am/-m with this message (staged only)")
+        .action(async (opts) => {
+        const repoRoot = await (0, paths_js_1.findRepoRoot)(process.cwd());
+        if (!repoRoot)
+            throw new Error("Not inside a git repository.");
+        const [config, status, log] = await Promise.all([
+            (0, config_js_1.loadConfig)(repoRoot),
+            (0, git_js_1.gitStatusPorcelain)(repoRoot),
+            (0, git_js_1.gitLogOneline)(repoRoot, 5),
+        ]);
+        let diffText = "";
+        let diffStat = "";
+        let diffNumstat = "";
+        let diffNameStatus = "";
+        if (opts.inspectLatest) {
+            // last commit diff
+            const d = await (0, exec_js_1.exec)("git", ["show", "--format=", "--unified=0"], { cwd: repoRoot });
+            diffText = d.stdout;
+            const s = await (0, exec_js_1.exec)("git", ["show", "--format=", "--stat"], { cwd: repoRoot });
+            diffStat = s.stdout.trimEnd();
+            const n = await (0, exec_js_1.exec)("git", ["show", "--format=", "--numstat"], { cwd: repoRoot });
+            diffNumstat = n.stdout.trimEnd();
+            const ns = await (0, exec_js_1.exec)("git", ["show", "--format=", "--name-status"], { cwd: repoRoot });
+            diffNameStatus = ns.stdout.trimEnd();
+        }
+        else {
+            const staged = Boolean(opts.staged);
+            [diffText, diffStat, diffNumstat] = await Promise.all([
+                (0, git_js_1.gitDiffText)(repoRoot, { staged }),
+                (0, git_js_1.gitDiffStat)(repoRoot, { staged }),
+                (0, git_js_1.gitDiffNumstat)(repoRoot, { staged }),
+            ]);
+            const ns = await (0, exec_js_1.exec)("git", ["diff", "--name-status", ...(staged ? ["--staged"] : [])], { cwd: repoRoot });
+            diffNameStatus = ns.stdout.trimEnd();
+        }
+        const scan = (0, scanner_js_1.scanDiff)(config, { diffText, diffStat, diffNumstat, diffNameStatus });
+        const ts = (0, artifacts_js_1.timestampId)();
+        const artifact = [
+            `# Checkpoint (${ts})`,
+            ``,
+            `## Git status`,
+            "```",
+            status || "(clean)",
+            "```",
+            ``,
+            `## Recent commits`,
+            "```",
+            log || "(none)",
+            "```",
+            ``,
+            `## Diff stat`,
+            "```",
+            diffStat || "(no changes)",
+            "```",
+            ``,
+            `## Findings`,
+            ...formatFindings(scan.findings),
+            ``,
+        ].join("\n");
+        const p = await (0, artifacts_js_1.writeArtifact)(repoRoot, "worklogs", `${ts}-checkpoint.md`, artifact);
+        // eslint-disable-next-line no-console
+        console.log(`✅ Wrote ${p}`);
+        if (scan.findings.length) {
+            // eslint-disable-next-line no-console
+            console.log("\nFindings:");
+            for (const f of scan.findings) {
+                // eslint-disable-next-line no-console
+                console.log(`- [${f.severity.toUpperCase()}] ${f.code}: ${f.message}`);
+            }
+        }
+        // Optionally run tests
+        const shouldRunTests = Boolean(opts.runTests) && Boolean(config.commands.test?.trim());
+        if (shouldRunTests) {
+            // eslint-disable-next-line no-console
+            console.log(`\nRunning tests: ${config.commands.test}`);
+            const res = await execShell(config.commands.test, repoRoot);
+            if (res.exitCode !== 0) {
+                // eslint-disable-next-line no-console
+                console.error(res.stderr || res.stdout);
+                process.exit(res.exitCode);
+            }
+        }
+        // Optional commit (staged only)
+        if (opts.message) {
+            // eslint-disable-next-line no-console
+            console.log(`\nCreating commit: ${opts.message}`);
+            const res = await (0, exec_js_1.exec)("git", ["commit", "-m", opts.message], { cwd: repoRoot });
+            if (res.exitCode !== 0) {
+                // eslint-disable-next-line no-console
+                console.error(res.stderr || res.stdout);
+                process.exit(res.exitCode);
+            }
+        }
+        const state = await (0, artifacts_js_1.loadState)(repoRoot);
+        state.lastCheckpointAt = new Date().toISOString();
+        await (0, artifacts_js_1.saveState)(repoRoot, state);
+    });
+}
+function formatFindings(findings) {
+    if (!findings.length)
+        return ["- ✅ No findings."];
+    return findings.map((f) => {
+        const details = f.details ? `\n  - Details:\n\n\`\`\`\n${f.details}\n\`\`\`` : "";
+        return `- **${f.severity.toUpperCase()} ${f.code}**: ${f.message}${details}`;
+    });
+}
+async function execShell(cmd, cwd) {
+    // minimal shell wrapper to run configured commands
+    const shell = process.platform === "win32" ? "cmd.exe" : "/bin/sh";
+    const args = process.platform === "win32" ? ["/c", cmd] : ["-lc", cmd];
+    return await (0, exec_js_1.exec)(shell, args, { cwd });
+}

package/dist/commands/correct.d.ts

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

package/dist/commands/correct.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCorrectCommand = registerCorrectCommand;
+const artifacts_js_1 = require("../lib/artifacts.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");
+function registerCorrectCommand(program) {
+    program
+        .command("correct")
+        .description("Create correction prompt when agent goes off track")
+        .option("--feedback <text>", "Correction feedback to the agent")
+        .option("--mode <mode>", "explain | narrow | milestone", "narrow")
+        .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("Not in a git repository.");
+        const state = await (0, artifacts_js_1.loadState)(repoRoot);
+        const feedback = opts.feedback ?? (await (0, input_js_1.promptText)("What is going wrong? (Correction feedback)", ""));
+        const mode = (opts.mode ?? "narrow").toLowerCase();
+        // eslint-disable-next-line no-console
+        console.log("\n🔄 PULSE Correction\n");
+        const modePrompts = {
+            explain: `STOP. Explain what you understood:
+
+1. **AS-IS**: What is the current state?
+2. **TO-BE**: What should be the state?
+3. **Attempts**: What have you tried so far?
+4. **Theory**: Why does it not work?
+
+Then suggest a MINIMAL next step.`,
+            narrow: `CORRECTION: Apply the following change with MINIMAL scope.
+Change ONLY what is necessary. NO refactoring of unrelated code.`,
+            milestone: `STOP. The task is too big.
+
+Split it into small milestones (1 change per milestone).
+Suggest only Milestone 1, implement it, and then STOP.`,
+        };
+        const modePrompt = modePrompts[mode] ?? modePrompts.narrow ?? "";
+        const fullPrompt = feedback.trim()
+            ? `${modePrompt}\n\n**Feedback:**\n${feedback.trim()}`
+            : modePrompt;
+        const ts = (0, artifacts_js_1.timestampId)();
+        const filename = `${ts}-correct.md`;
+        const content = [
+            `# Correction Pulse (${ts})`,
+            ``,
+            `- Layer: **${state.profile}**`,
+            `- Mode: **${mode}**`,
+            ``,
+            `## Prompt`,
+            ``,
+            "```",
+            fullPrompt,
+            "```",
+            ``,
+        ].join("\n");
+        const p = await (0, artifacts_js_1.writeArtifact)(repoRoot, "pulses", filename, content);
+        // eslint-disable-next-line no-console
+        console.log(`✅ Saved: ${p}`);
+        // Clipboard
+        if (opts.clipboard) {
+            const clipboardMsg = await (0, clipboard_js_1.copyAndNotify)(fullPrompt);
+            // 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📋 CORRECTION PROMPT${opts.clipboard ? " (copied)" : ""}:\n`);
+        // eslint-disable-next-line no-console
+        console.log(fullPrompt);
+        // eslint-disable-next-line no-console
+        console.log(`\n${"─".repeat(60)}\n`);
+    });
+}

package/dist/commands/doctor.d.ts

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

package/dist/commands/doctor.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDoctorCommand = registerDoctorCommand;
+const config_js_1 = require("../lib/config.js");
+const artifacts_js_1 = require("../lib/artifacts.js");
+const exec_js_1 = require("../lib/exec.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 briefing_js_1 = require("../lib/briefing.js");
+function registerDoctorCommand(program) {
+    program
+        .command("doctor")
+        .alias("d")
+        .description("Check safeguards + red flags (secrets, deletes, loops, scope)")
+        .option("--staged", "Scan staged diff")
+        .option("--ci", "CI mode: quieter output + exit codes")
+        .option("--hook <name>", "Hook mode: pre-commit | pre-push", "none")
+        .option("--loop", "Include loop-detection hints (heuristics)")
+        .option("--confirm-delete", "Explicitly confirm deletes (for this run)")
+        .option("--allow-push", "Explicitly allow push (for this run)")
+        .action(async (opts) => {
+        const repoRoot = await (0, paths_js_1.findRepoRoot)(process.cwd());
+        if (!repoRoot)
+            throw new Error("Not in a git repository.");
+        const [config, state] = await Promise.all([(0, config_js_1.loadConfig)(repoRoot), (0, artifacts_js_1.loadState)(repoRoot)]);
+        const hook = (opts.hook ?? "none");
+        // Safeguard: Push gate (hook only)
+        if (hook === "pre-push") {
+            const allowed = opts.allowPush || process.env.PULSE_ALLOW_PUSH === "1";
+            if (!allowed) {
+                print(opts.ci, `PULSE safeguard: push blocked. Set PULSE_ALLOW_PUSH=1 for an explicit push.`, "");
+                process.exit(2);
+            }
+        }
+        const staged = Boolean(opts.staged) || hook === "pre-commit";
+        const [diffText, diffStat, diffNumstat, diffNameStatus] = await Promise.all([
+            (0, git_js_1.gitDiffText)(repoRoot, { staged }),
+            (0, git_js_1.gitDiffStat)(repoRoot, { staged }),
+            (0, git_js_1.gitDiffNumstat)(repoRoot, { staged }),
+            (0, git_js_1.gitDiffNameStatus)(repoRoot, { staged }),
+        ]);
+        const scan = (0, scanner_js_1.scanDiff)(config, { diffText, diffStat, diffNumstat, diffNameStatus });
+        // Mixed enforcement: deletes are critical only if not explicitly confirmed
+        const hasDeleteFinding = scan.findings.some((f) => f.code === "MASS_DELETE" && f.message.includes("File deletion"));
+        const deleteConfirmed = Boolean(opts.confirmDelete) || process.env.PULSE_CONFIRM_DELETE === "1";
+        if (hasDeleteFinding && deleteConfirmed) {
+            scan.findings = scan.findings.map((f) => f.code === "MASS_DELETE" && f.message.includes("File deletion")
+                ? { ...f, severity: "warn", message: `${f.message} (confirmed)` }
+                : f);
+        }
+        // Optional loop heuristics
+        if (opts.loop) {
+            const log = await (0, git_js_1.gitLogOneline)(repoRoot, 15);
+            const logWithFiles = await (0, exec_js_1.exec)("git", ["log", "--name-only", "--oneline", "-15"], {
+                cwd: repoRoot,
+            });
+            const loopSignals = (0, scanner_js_1.detectLoopSignals)(log, logWithFiles.stdout);
+            for (const signal of loopSignals) {
+                scan.findings.push({
+                    severity: signal.severity,
+                    code: "LOOP_SIGNAL",
+                    message: signal.message,
+                    details: signal.details,
+                });
+            }
+        }
+        // ════════════════════════════════════════════════════════════════════════
+        // Preset-Verletzungen explizit hinzufügen
+        // ════════════════════════════════════════════════════════════════════════
+        const scope = (0, briefing_js_1.calculateScopeCheck)(config, scan.stats);
+        if (scope.exceeded) {
+            const presetName = config.preset ?? "custom";
+            for (const field of scope.exceededFields) {
+                const current = field === "files"
+                    ? scope.files.current
+                    : field === "lines"
+                        ? scope.lines.current
+                        : scope.deletes.current;
+                const max = field === "files"
+                    ? scope.files.max
+                    : field === "lines"
+                        ? scope.lines.max
+                        : scope.deletes.max;
+                scan.findings.push({
+                    severity: "warn",
+                    code: "BIG_CHANGESET",
+                    message: `Preset limit exceeded (${presetName}): ${field} ${current}/${max}`,
+                });
+            }
+        }
+        // Output
+        const critical = scan.findings.filter((f) => f.severity === "critical");
+        const warnings = scan.findings.filter((f) => f.severity === "warn");
+        // Calculate recommendation
+        const risk = (0, briefing_js_1.calculateRiskSummary)(scan);
+        const time = (0, briefing_js_1.calculateTimeSummary)(state.lastCheckpointAt, config.checkpointReminderMinutes ?? 30);
+        const recommendation = (0, briefing_js_1.generateRecommendation)(scope, risk, time);
+        if (!opts.ci) {
+            const presetProfile = config.preset
+                ? `${config.preset}/${state.profile}`
+                : state.profile;
+            // eslint-disable-next-line no-console
+            console.log(`\n🔍 Pulse Doctor (${staged ? "staged" : "working tree"})\n`);
+            // eslint-disable-next-line no-console
+            console.log(`Profile: ${presetProfile}`);
+            // eslint-disable-next-line no-console
+            console.log(`Scope: ${scan.stats.filesChanged} files | +${scan.stats.linesAdded} -${scan.stats.linesDeleted} lines`);
+            // Scope progress
+            if (scan.stats.filesChanged > 0) {
+                // eslint-disable-next-line no-console
+                console.log(`Limits (${config.preset ?? "custom"}): Files ${scope.files.percent}%, Lines ${scope.lines.percent}%`);
+            }
+            // eslint-disable-next-line no-console
+            console.log(`\nDiff stat:\n${diffStat || "(no changes)"}`);
+            // eslint-disable-next-line no-console
+            console.log("");
+            printFindings(scan.findings);
+            // eslint-disable-next-line no-console
+            console.log("");
+            // ══════════════════════════════════════════════════════════════════════
+            // Show recommendation
+            // ══════════════════════════════════════════════════════════════════════
+            const actionEmoji = {
+                approve: "✅",
+                checkpoint: "⏱️",
+                escalate: "🚨",
+                stop: "🛑",
+            }[recommendation.action];
+            // eslint-disable-next-line no-console
+            console.log(`${actionEmoji} RECOMMENDATION: ${recommendation.action.toUpperCase()}`);
+            // eslint-disable-next-line no-console
+            console.log(`   → ${recommendation.reason}`);
+            if (recommendation.command) {
+                // eslint-disable-next-line no-console
+                console.log(`   → ${recommendation.command}`);
+            }
+            // eslint-disable-next-line no-console
+            console.log("");
+        }
+        else {
+            printFindings(scan.findings);
+        }
+        if (critical.length)
+            process.exit(2);
+        if (warnings.length)
+            process.exit(1);
+        process.exit(0);
+    });
+}
+function print(ci, msg, details) {
+    if (!ci) {
+        // eslint-disable-next-line no-console
+        console.error(msg);
+        if (details) {
+            // eslint-disable-next-line no-console
+            console.error(details);
+        }
+    }
+    else {
+        // eslint-disable-next-line no-console
+        console.log(msg);
+    }
+}
+function printFindings(findings) {
+    if (!findings.length) {
+        // eslint-disable-next-line no-console
+        console.log("✅ No findings");
+        return;
+    }
+    for (const f of findings) {
+        const emoji = f.severity === "critical" ? "🚨" : "⚠️";
+        // eslint-disable-next-line no-console
+        console.log(`${emoji} ${f.code}: ${f.message}`);
+        if (f.details) {
+            // eslint-disable-next-line no-console
+            console.log(f.details
+                .split("\n")
+                .map((l) => `   ${l}`)
+                .join("\n"));
+        }
+    }
+}

package/dist/commands/escalate.d.ts

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

package/dist/commands/escalate.js

@@ -0,0 +1,226 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerEscalateCommand = registerEscalateCommand;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const artifacts_js_1 = require("../lib/artifacts.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 prompts_js_1 = require("../lib/prompts.js");
+const clipboard_js_1 = require("../lib/clipboard.js");
+const context_export_js_1 = require("../lib/context-export.js");
+async function readOptionalFile(p) {
+    if (!p)
+        return "";
+    try {
+        return await promises_1.default.readFile(p, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+function registerEscalateCommand(program) {
+    program
+        .command("escalate")
+        .alias("e")
+        .description("Create escalation: Prepare problem for external model (GPT-5/Claude/Opus)")
+        .option("--problem <text>", "What is the problem?")
+        .option("--tried <text>", "What has Cursor tried already?")
+        .option("--error <text>", "Error message / logs")
+        .option("--error-file <path>", "Path to log file")
+        .option("--code <text>", "Relevant code")
+        .option("--code-file <path>", "Path to code file")
+        .option("--question <text>", "Your specific question")
+        .option("--detailed", "Include full diff (not just summary)")
+        .option("-C, --clipboard", "Copy prompt to clipboard")
+        .option("--include <patterns...>", "Include files (glob patterns)")
+        .option("--auto-include", "Automatically include relevant files from git diff")
+        .action(async (opts) => {
+        const repoRoot = await (0, paths_js_1.findRepoRoot)(process.cwd());
+        if (!repoRoot)
+            throw new Error("Not in a git repository.");
+        // eslint-disable-next-line no-console
+        console.log("\n🚨 PULSE Escalation\n");
+        // eslint-disable-next-line no-console
+        console.log("Creating escalation package for external reasoning model (GPT-5/Claude/Opus)\n");
+        // ══════════════════════════════════════════════════════════════════════
+        // Collect information (interactive if not via flag)
+        // ══════════════════════════════════════════════════════════════════════
+        const cursorExplanation = opts.problem ??
+            opts.tried ??
+            (await (0, input_js_1.promptText)("What is the problem? (What did Cursor try, where is it stuck?)", ""));
+        // Versuche sammeln
+        const attempts = [];
+        if (opts.tried) {
+            attempts.push(opts.tried);
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.log("\nWhat has Cursor tried already? (Enter to finish)\n");
+            for (let i = 1; i <= 5; i++) {
+                const attempt = await (0, input_js_1.promptText)(`  Attempt ${i}`, "");
+                if (!attempt.trim())
+                    break;
+                attempts.push(attempt);
+            }
+        }
+        // Error
+        const errorText = opts.error ??
+            (opts.errorFile
+                ? await readOptionalFile(opts.errorFile)
+                : await (0, input_js_1.promptText)("Error message / logs (optional)", ""));
+        // Code (legacy option)
+        let codeSnippets = opts.code ??
+            (opts.codeFile ? await readOptionalFile(opts.codeFile) : "");
+        // Frage
+        const question = opts.question ??
+            (await (0, input_js_1.promptText)("Your specific question", "What is the root cause and how do I solve it?"));
+        // ══════════════════════════════════════════════════════════════════════
+        // Git-Kontext sammeln
+        // ══════════════════════════════════════════════════════════════════════
+        // eslint-disable-next-line no-console
+        console.log("\n📊 Collecting Git context...");
+        const [log, stat, diff, nameStatus] = await Promise.all([
+            (0, git_js_1.gitLogOneline)(repoRoot, 10),
+            (0, git_js_1.gitDiffStat)(repoRoot),
+            opts.detailed ? (0, git_js_1.gitDiffText)(repoRoot, { maxLines: 300 }) : Promise.resolve(""),
+            (0, git_js_1.gitDiffNameStatus)(repoRoot),
+        ]);
+        // ══════════════════════════════════════════════════════════════════════
+        // Kontext-Export (Dateien inkludieren)
+        // ══════════════════════════════════════════════════════════════════════
+        let contextExportXml = "";
+        if (opts.include && opts.include.length > 0) {
+            // eslint-disable-next-line no-console
+            console.log(`📁 Exporting files: ${opts.include.join(", ")}`);
+            const ctx = await (0, context_export_js_1.exportFiles)(repoRoot, opts.include);
+            contextExportXml = (0, context_export_js_1.renderContextExportXml)(ctx);
+            // eslint-disable-next-line no-console
+            console.log(`   → ${ctx.totalFiles} files, ~${ctx.totalLines} lines`);
+            if (ctx.truncated) {
+                // eslint-disable-next-line no-console
+                console.log(`   ⚠️ Truncated (limit reached)`);
+            }
+        }
+        else if (opts.autoInclude) {
+            // eslint-disable-next-line no-console
+            console.log("📁 Auto-detecting relevant files...");
+            const files = await (0, context_export_js_1.autoDetectFiles)(repoRoot, nameStatus);
+            if (files.length > 0) {
+                // eslint-disable-next-line no-console
+                console.log(`   Found: ${files.join(", ")}`);
+                const doInclude = await (0, input_js_1.promptConfirm)(`Include these ${files.length} files?`, true);
+                if (doInclude) {
+                    const ctx = await (0, context_export_js_1.exportFiles)(repoRoot, files);
+                    contextExportXml = (0, context_export_js_1.renderContextExportXml)(ctx);
+                    // eslint-disable-next-line no-console
+                    console.log(`   → ${ctx.totalFiles} files, ~${ctx.totalLines} lines`);
+                }
+            }
+            else {
+                // eslint-disable-next-line no-console
+                console.log("   No relevant files found.");
+            }
+        }
+        else if (!codeSnippets && !opts.code && !opts.codeFile) {
+            // Ask if user wants to include files
+            const wantInclude = await (0, input_js_1.promptConfirm)("Do you want to include files?", false);
+            if (wantInclude) {
+                const files = await (0, context_export_js_1.autoDetectFiles)(repoRoot, nameStatus);
+                if (files.length > 0) {
+                    // eslint-disable-next-line no-console
+                    console.log(`   Auto-detected: ${files.join(", ")}`);
+                    const useAuto = await (0, input_js_1.promptConfirm)("Use these files?", true);
+                    if (useAuto) {
+                        const ctx = await (0, context_export_js_1.exportFiles)(repoRoot, files);
+                        contextExportXml = (0, context_export_js_1.renderContextExportXml)(ctx);
+                        // eslint-disable-next-line no-console
+                        console.log(`   → ${ctx.totalFiles} files, ~${ctx.totalLines} lines`);
+                    }
+                    else {
+                        const pattern = await (0, input_js_1.promptText)("Enter glob pattern (e.g. src/**/*.ts)", "");
+                        if (pattern) {
+                            const ctx = await (0, context_export_js_1.exportFiles)(repoRoot, [pattern]);
+                            contextExportXml = (0, context_export_js_1.renderContextExportXml)(ctx);
+                            // eslint-disable-next-line no-console
+                            console.log(`   → ${ctx.totalFiles} files, ~${ctx.totalLines} lines`);
+                        }
+                    }
+                }
+            }
+        }
+        // Merge context export with code snippets
+        if (contextExportXml) {
+            codeSnippets = contextExportXml + (codeSnippets ? `\n\n${codeSnippets}` : "");
+        }
+        // ══════════════════════════════════════════════════════════════════════
+        // Eskalations-Prompt generieren
+        // ══════════════════════════════════════════════════════════════════════
+        const prompt = (0, prompts_js_1.renderEscalationPrompt)({
+            cursorExplanation,
+            errorText,
+            gitLog: log,
+            gitDiff: opts.detailed ? diff : stat,
+            question,
+            codeSnippets: codeSnippets || undefined,
+            attempts: attempts.length > 0 ? attempts : undefined,
+        });
+        // ══════════════════════════════════════════════════════════════════════
+        // Save
+        // ══════════════════════════════════════════════════════════════════════
+        const ts = (0, artifacts_js_1.timestampId)();
+        const filename = `${ts}-escalate.md`;
+        const content = [
+            `# Escalation (${ts})`,
+            ``,
+            `## Instructions`,
+            ``,
+            `1. **Copy** the prompt below`,
+            `2. **Paste** into ChatGPT, Claude, GPT-5 or Opus`,
+            `3. **Read** the analysis and step-by-step instructions`,
+            `4. **Pass** instructions to Cursor (DO NOT blindly copy code!)`,
+            ``,
+            `---`,
+            ``,
+            `## Prompt`,
+            ``,
+            "```",
+            prompt,
+            "```",
+            ``,
+            `---`,
+            ``,
+            `## Metadata`,
+            `- Created: ${new Date().toISOString()}`,
+            `- Attempts documented: ${attempts.length}`,
+            `- Git context: ${log ? "✅" : "❌"}`,
+            `- Files included: ${contextExportXml ? "✅" : "❌"}`,
+            ``,
+        ].join("\n");
+        const p = await (0, artifacts_js_1.writeArtifact)(repoRoot, "escalations", filename, content);
+        // ══════════════════════════════════════════════════════════════════════
+        // Output
+        // ══════════════════════════════════════════════════════════════════════
+        // eslint-disable-next-line no-console
+        console.log(`\n✅ Saved: ${p}`);
+        // Clipboard
+        if (opts.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📋 ESCALATION PROMPT${opts.clipboard ? " (copied)" : ""}:\n`);
+        // eslint-disable-next-line no-console
+        console.log(prompt);
+        // eslint-disable-next-line no-console
+        console.log(`\n${"═".repeat(60)}`);
+        // eslint-disable-next-line no-console
+        console.log(`\n💡 Tip: The answer contains step-by-step instructions for Cursor.\n`);
+    });
+}

package/dist/commands/init.d.ts

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