ralph-cursor 0.1.0

package/dist/commands/once.js

@@ -0,0 +1,187 @@
+import { Command } from "commander";
+import { resolve } from "path";
+import { existsSync, readFileSync } from "fs";
+import { execSync } from "child_process";
+import { runIteration } from "../loop/index.js";
+import { ensureRalphDir } from "../lib/ralph-dir.js";
+import { checkTaskComplete, getTaskFilePath, getProgress, countRemaining } from "../task-parser/index.js";
+import { loadConfig } from "../lib/config.js";
+/** Prerequisite checks: cursor-agent, git, task file, .ralph writable. */
+function checkPrerequisites(workspace, taskFilePath) {
+    if (!existsSync(taskFilePath)) {
+        console.error(`❌ No RALPH_TASK.md found in ${workspace}`);
+        console.error("");
+        console.error("Create a task file first:");
+        console.error("  cat > RALPH_TASK.md << 'EOF'");
+        console.error("  ---");
+        console.error("  task: Your task description");
+        console.error("  test_command: \"pnpm test\"");
+        console.error("  ---");
+        console.error("  # Task");
+        console.error("  ## Success Criteria");
+        console.error("  1. [ ] First thing to do");
+        console.error("  2. [ ] Second thing to do");
+        console.error("  EOF");
+        return false;
+    }
+    try {
+        execSync("which cursor-agent", { stdio: "pipe" });
+    }
+    catch {
+        console.error("❌ cursor-agent CLI not found");
+        console.error("");
+        console.error("Install via:");
+        console.error("  curl https://cursor.com/install -fsS | bash");
+        return false;
+    }
+    try {
+        execSync("git rev-parse --git-dir", { cwd: workspace, stdio: "pipe" });
+    }
+    catch {
+        console.error("❌ Not a git repository");
+        console.error("   Ralph requires git for state persistence.");
+        return false;
+    }
+    return true;
+}
+function showTaskSummary(workspace, taskPath) {
+    const path = getTaskFilePath(workspace, taskPath);
+    if (!existsSync(path))
+        return;
+    const content = readFileSync(path, "utf-8");
+    const lines = content.split("\n").slice(0, 30);
+    console.log("📋 Task Summary:");
+    console.log("─────────────────────────────────────────────────────────────────");
+    console.log(lines.join("\n"));
+    console.log("─────────────────────────────────────────────────────────────────");
+    console.log("");
+    const progress = getProgress(workspace, taskPath);
+    const [done, total] = progress.split(":").map(Number);
+    const remaining = countRemaining(workspace, taskPath);
+    console.log(`Progress: ${done} / ${total} criteria complete (${remaining} remaining)`);
+    console.log("");
+}
+export function onceCommand() {
+    return new Command("once")
+        .description("Run a single iteration (no loop)")
+        .argument("[workspace]", "Project directory (default: current)")
+        .option("-m, --model <model>", "Model to use")
+        .option("--task <path>", "Path to task file")
+        .action(async (workspaceArg, opts) => {
+        const workspace = workspaceArg ? resolve(process.cwd(), workspaceArg) : process.cwd();
+        if (!existsSync(workspace)) {
+            console.error("Workspace not found:", workspace);
+            process.exit(2);
+        }
+        const sep = "═══════════════════════════════════════════════════════════════════";
+        console.log(sep);
+        console.log("🐛 Ralph Wiggum: Single Iteration (Human-in-the-Loop)");
+        console.log(sep);
+        console.log("");
+        console.log("  This runs ONE iteration, then stops for your review.");
+        console.log("  Use this to test your task before going AFK.");
+        console.log("");
+        console.log(sep);
+        console.log("");
+        const taskFile = getTaskFilePath(workspace, opts.task);
+        if (!checkPrerequisites(workspace, taskFile)) {
+            process.exit(1);
+        }
+        ensureRalphDir(workspace);
+        const config = loadConfig(workspace);
+        console.log("Workspace:", workspace);
+        console.log("Model:    ", opts.model ?? config.default_model);
+        console.log("");
+        showTaskSummary(workspace, opts.task);
+        const statusBefore = checkTaskComplete(workspace, opts.task);
+        if (statusBefore === "COMPLETE") {
+            console.log("🎉 Task already complete! All criteria are checked.");
+            process.exit(0);
+        }
+        const readline = await import("readline");
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await new Promise((resolve) => {
+            rl.question("Run single iteration? [Y/n] ", (a) => resolve(a.trim()));
+        });
+        rl.close();
+        if (answer.toLowerCase() === "n" || answer.toLowerCase() === "no") {
+            console.log("Aborted.");
+            process.exit(0);
+        }
+        try {
+            const status = execSync("git status --porcelain", { cwd: workspace, encoding: "utf-8" });
+            if (status.trim()) {
+                console.log("📦 Committing uncommitted changes...");
+                execSync("git add -A", { cwd: workspace });
+                execSync("git commit -m \"ralph: checkpoint before single iteration\"", { cwd: workspace });
+            }
+        }
+        catch {
+            // not a git repo or nothing to commit
+        }
+        console.log("");
+        console.log("🚀 Running single iteration...");
+        console.log("");
+        const iteration = 1;
+        const signal = await runIteration({
+            workspace,
+            iteration,
+            model: opts.model ?? config.default_model,
+            taskFilePath: opts.task,
+            warnThreshold: config.warn_threshold,
+            rotateThreshold: config.rotate_threshold,
+        });
+        const status = checkTaskComplete(workspace, opts.task);
+        console.log("");
+        console.log("═══════════════════════════════════════════════════════════════════");
+        console.log("📋 Single Iteration Complete");
+        console.log("═══════════════════════════════════════════════════════════════════");
+        console.log("");
+        if (signal === "COMPLETE") {
+            if (status === "COMPLETE") {
+                console.log("🎉 Task completed in single iteration!");
+                console.log("");
+                console.log("All criteria are checked. You're done!");
+            }
+            else {
+                console.log("⚠️  Agent signaled complete but some criteria remain unchecked.");
+                console.log("   Review the results and run again if needed.");
+            }
+        }
+        else if (signal === "GUTTER") {
+            console.log("🚨 Gutter detected - agent got stuck.");
+            console.log("");
+            console.log("Review .ralph/errors.log and consider:");
+            console.log("  1. Adding a guardrail to .ralph/guardrails.md");
+            console.log("  2. Simplifying the task");
+            console.log("  3. Fixing the blocking issue manually");
+        }
+        else if (signal === "ROTATE") {
+            console.log("🔄 Context rotation was triggered.");
+            console.log("");
+            console.log("The agent used a lot of context. This is normal for complex tasks.");
+            console.log("Review the progress and run again or proceed to full loop.");
+        }
+        else {
+            if (status === "COMPLETE") {
+                console.log("🎉 Task completed in single iteration!");
+            }
+            else {
+                const remaining = status.startsWith("INCOMPLETE:") ? status.slice("INCOMPLETE:".length) : "?";
+                console.log(`Agent finished with ${remaining} criteria remaining.`);
+            }
+        }
+        console.log("");
+        console.log("Review the changes:");
+        console.log("  • git log --oneline -5     # See recent commits");
+        console.log("  • git diff HEAD~1          # See changes");
+        console.log("  • cat .ralph/progress.md   # See progress log");
+        console.log("");
+        console.log("Next steps:");
+        console.log("  • If satisfied: ralph-cursor run   # Run full loop");
+        console.log("  • If issues: fix, update task/guardrails, ralph-cursor once again");
+        console.log("");
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=once.js.map

package/dist/commands/once.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"once.js","sourceRoot":"","sources":["../../src/commands/once.ts"],"names":[],"mappings":"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"}

package/dist/commands/run.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function runCommand(): Command;
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+EpC,wBAAgB,UAAU,IAAI,OAAO,CA2PpC"}

package/dist/commands/run.js

@@ -0,0 +1,328 @@
+import { Command } from "commander";
+import * as p from "@clack/prompts";
+import { resolve } from "path";
+import { existsSync, readFileSync } from "fs";
+import { execSync } from "child_process";
+import { runRalphLoop, runIteration } from "../loop/index.js";
+import { runParallelTasks } from "../parallel/run.js";
+import { ensureRalphDir, setIteration } from "../lib/ralph-dir.js";
+import { checkTaskComplete, getTaskFilePath, getProgress, countRemaining } from "../task-parser/index.js";
+import { readLastRun, writeLastRun } from "../lib/last-run.js";
+import { loadConfig } from "../lib/config.js";
+const MODELS = [
+    "opus-4.5-thinking",
+    "sonnet-4.5-thinking",
+    "gpt-5.2-high",
+    "composer-1",
+    "Custom...",
+];
+function bail() {
+    p.cancel("Aborted.");
+    process.exit(0);
+}
+/** Prerequisite checks: cursor-agent, git, task file, .ralph writable. */
+function checkPrerequisites(workspace, taskFilePath) {
+    if (!existsSync(taskFilePath)) {
+        console.error(`❌ No RALPH_TASK.md found in ${workspace}`);
+        console.error("");
+        console.error("Create a task file first:");
+        console.error("  cat > RALPH_TASK.md << 'EOF'");
+        console.error("  ---");
+        console.error("  task: Your task description");
+        console.error("  test_command: \"pnpm test\"");
+        console.error("  ---");
+        console.error("  # Task");
+        console.error("  ## Success Criteria");
+        console.error("  1. [ ] First thing to do");
+        console.error("  2. [ ] Second thing to do");
+        console.error("  EOF");
+        return false;
+    }
+    try {
+        execSync("which cursor-agent", { stdio: "pipe" });
+    }
+    catch {
+        console.error("❌ cursor-agent CLI not found");
+        console.error("");
+        console.error("Install via:");
+        console.error("  curl https://cursor.com/install -fsS | bash");
+        return false;
+    }
+    try {
+        execSync("git rev-parse --git-dir", { cwd: workspace, stdio: "pipe" });
+    }
+    catch {
+        console.error("❌ Not a git repository");
+        console.error("   Ralph requires git for state persistence.");
+        return false;
+    }
+    return true;
+}
+function showTaskSummary(workspace, taskPath) {
+    const path = getTaskFilePath(workspace, taskPath);
+    if (!existsSync(path))
+        return;
+    const content = readFileSync(path, "utf-8");
+    const lines = content.split("\n").slice(0, 30);
+    console.log("📋 Task Summary:");
+    console.log("─────────────────────────────────────────────────────────────────");
+    console.log(lines.join("\n"));
+    console.log("─────────────────────────────────────────────────────────────────");
+    console.log("");
+    const progress = getProgress(workspace, taskPath);
+    const [done, total] = progress.split(":").map(Number);
+    const remaining = countRemaining(workspace, taskPath);
+    console.log("Progress:", done, "/", total, "criteria complete (" + remaining + " remaining)");
+    console.log("");
+}
+export function runCommand() {
+    return new Command("run")
+        .description("Interactive run: prompts for model and options, then runs the loop")
+        .argument("[workspace]", "Project directory (default: current)")
+        .option("--task <path>", "Path to task file")
+        .option("--branch <name>", "Work on this branch (create if needed)")
+        .option("--pr", "Open PR when task complete (requires --branch)")
+        .option("-y, --yes", "Use defaults / last-run without prompting")
+        .action(async (workspaceArg, opts) => {
+        const workspace = workspaceArg ? resolve(process.cwd(), workspaceArg) : process.cwd();
+        if (!existsSync(workspace)) {
+            console.error("Workspace not found:", workspace);
+            process.exit(2);
+        }
+        const sep = "═══════════════════════════════════════════════════════════════════";
+        console.log("");
+        console.log(sep);
+        console.log("🐛 Ralph Wiggum: Autonomous Development Loop");
+        console.log(sep);
+        console.log("");
+        console.log("  💡 Tip: use ralph-cursor loop for non-interactive (--branch, --pr, --parallel)");
+        console.log("");
+        const taskFile = getTaskFilePath(workspace, opts.task);
+        if (!checkPrerequisites(workspace, taskFile)) {
+            process.exit(1);
+        }
+        ensureRalphDir(workspace);
+        console.log("Workspace:", workspace);
+        console.log("");
+        showTaskSummary(workspace, opts.task);
+        const taskStatus = checkTaskComplete(workspace, opts.task);
+        if (taskStatus === "COMPLETE") {
+            console.log("🎉 Task already complete! All criteria are checked.");
+            process.exit(0);
+        }
+        if (taskStatus === "NO_TASK_FILE") {
+            process.exit(2);
+        }
+        if (opts.pr && !opts.branch) {
+            console.error("--pr requires --branch");
+            console.error("  Example: ralph-cursor run --branch feature/foo --pr");
+            process.exit(2);
+        }
+        const config = loadConfig(workspace);
+        const lastRun = readLastRun(workspace);
+        let model = opts.yes ? (lastRun?.model ?? config.default_model) : (lastRun?.model ?? config.default_model);
+        let maxIterations = opts.yes ? (lastRun?.max_iterations ?? config.max_iterations) : (lastRun?.max_iterations ?? config.max_iterations);
+        let useBranch = opts.branch ?? "";
+        let openPr = opts.pr ?? false;
+        let runSingleFirst = false;
+        let parallelMode = false;
+        let maxParallel = 3;
+        if (!opts.yes) {
+            p.intro("Configure your Ralph session");
+            let useLast = true;
+            if (lastRun) {
+                const useLastVal = await p.confirm({
+                    message: `Use last settings? (model: ${lastRun.model}, iterations: ${lastRun.max_iterations})`,
+                    initialValue: true,
+                });
+                if (p.isCancel(useLastVal))
+                    bail();
+                useLast = useLastVal;
+            }
+            if (!useLast || !lastRun) {
+                const modelChoice = await p.select({
+                    message: "Select model:",
+                    options: MODELS.map((m) => ({ value: m, label: m })),
+                });
+                if (p.isCancel(modelChoice))
+                    bail();
+                if (modelChoice === "Custom...") {
+                    const customModel = await p.text({
+                        message: "Enter model name:",
+                        placeholder: config.default_model,
+                        initialValue: config.default_model,
+                    });
+                    if (p.isCancel(customModel))
+                        bail();
+                    const customStr = typeof customModel === "string" ? customModel.trim() : "";
+                    model = customStr || config.default_model;
+                }
+                else {
+                    model = modelChoice;
+                }
+                p.log.success(`Model: ${model}`);
+                const iterVal = await p.text({
+                    message: "Max iterations:",
+                    placeholder: "20",
+                    initialValue: String(config.max_iterations),
+                });
+                if (p.isCancel(iterVal))
+                    bail();
+                const iterStr = typeof iterVal === "string" ? iterVal.trim() : "";
+                maxIterations = parseInt(iterStr, 10) || config.max_iterations;
+                p.log.success(`Max iterations: ${maxIterations}`);
+            }
+            const branchAns = await p.text({
+                message: "Work on new branch?",
+                placeholder: "leave empty for current",
+            });
+            if (p.isCancel(branchAns))
+                bail();
+            const branchStr = typeof branchAns === "string" ? branchAns.trim() : "";
+            if (branchStr) {
+                useBranch = branchStr;
+                p.log.success(`Branch: ${useBranch}`);
+            }
+            const openPrVal = await p.confirm({
+                message: "Open PR when complete?",
+                initialValue: false,
+            });
+            if (p.isCancel(openPrVal))
+                bail();
+            openPr = openPrVal;
+            if (openPr)
+                p.log.success("Will open PR when complete");
+            const singleVal = await p.confirm({
+                message: "Run single iteration first (then continue loop)?",
+                initialValue: false,
+            });
+            if (p.isCancel(singleVal))
+                bail();
+            runSingleFirst = singleVal;
+            if (runSingleFirst)
+                p.log.success("Will run single iteration first");
+            const parallelVal = await p.confirm({
+                message: "Run in parallel mode?",
+                initialValue: false,
+            });
+            if (p.isCancel(parallelVal))
+                bail();
+            parallelMode = parallelVal;
+            if (parallelMode) {
+                const maxPar = await p.text({
+                    message: "Max parallel agents:",
+                    placeholder: "3",
+                    initialValue: "3",
+                });
+                if (p.isCancel(maxPar))
+                    bail();
+                const maxParStr = typeof maxPar === "string" ? maxPar.trim() : "";
+                maxParallel = parseInt(maxParStr, 10) || 3;
+                p.log.success(`Parallel: ${maxParallel} agents`);
+            }
+            if (openPr && !parallelMode && !useBranch) {
+                p.log.warn("Opening PR requires a branch.");
+                const branchName = await p.text({
+                    message: "Branch name:",
+                    placeholder: "feature/ralph",
+                    initialValue: "feature/ralph",
+                });
+                if (p.isCancel(branchName))
+                    bail();
+                const nameStr = typeof branchName === "string" ? branchName.trim() : "";
+                useBranch = nameStr || "feature/ralph";
+                p.log.success(`Branch: ${useBranch}`);
+            }
+            p.outro("Options set");
+        }
+        writeLastRun(workspace, { model, max_iterations: maxIterations });
+        console.log("");
+        console.log("─────────────────────────────────────────────────────────────────");
+        console.log("Summary:");
+        console.log("  • Model:      ", model);
+        console.log("  • Iterations: ", maxIterations, "max");
+        if (useBranch)
+            console.log("  • Branch:     ", useBranch);
+        if (openPr)
+            console.log("  • Open PR:    Yes");
+        if (runSingleFirst)
+            console.log("  • Test first: Yes (single iteration)");
+        if (parallelMode)
+            console.log("  • Parallel:   ", maxParallel, "agents");
+        console.log("─────────────────────────────────────────────────────────────────");
+        console.log("");
+        if (!opts.yes) {
+            const go = await p.confirm({
+                message: "Start Ralph loop?",
+                initialValue: false,
+            });
+            if (p.isCancel(go))
+                bail();
+            if (!go)
+                bail();
+        }
+        if (parallelMode) {
+            const result = await runParallelTasks(workspace, {
+                maxParallel,
+                model,
+                baseBranch: undefined,
+                integrationBranch: useBranch || undefined,
+                skipMerge: false,
+                createPr: openPr,
+                taskFilePath: opts.task,
+            });
+            process.exit(result.success ? 0 : 1);
+        }
+        if (runSingleFirst) {
+            console.log("");
+            console.log("🧪 Running single iteration first...");
+            console.log("");
+            await runIteration({
+                workspace,
+                iteration: 1,
+                model,
+                taskFilePath: opts.task,
+                warnThreshold: config.warn_threshold,
+                rotateThreshold: config.rotate_threshold,
+            });
+            if (checkTaskComplete(workspace, opts.task) === "COMPLETE") {
+                console.log("");
+                console.log("🎉 Task completed in single iteration!");
+                process.exit(0);
+            }
+            console.log("");
+            console.log("Single iteration complete. Review the changes.");
+            console.log("");
+            if (!opts.yes) {
+                const cont = await p.confirm({
+                    message: "Continue with full loop?",
+                    initialValue: true,
+                });
+                if (p.isCancel(cont))
+                    bail();
+                if (!cont) {
+                    p.cancel("Stopped after single iteration.");
+                    process.exit(0);
+                }
+            }
+            setIteration(workspace, 2);
+        }
+        const result = await runRalphLoop({
+            workspace,
+            model,
+            maxIterations,
+            useBranch: useBranch || undefined,
+            openPr,
+            taskFilePath: opts.task,
+            warnThreshold: config.warn_threshold,
+            rotateThreshold: config.rotate_threshold,
+        });
+        if (result.success) {
+            console.log("\nRALPH COMPLETE! Iterations:", result.iterations);
+            process.exit(0);
+        }
+        console.error("\nLoop ended without completion.");
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"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"}

package/dist/commands/status.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function statusCommand(): Command;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,aAAa,IAAI,OAAO,CA8BvC"}

package/dist/commands/status.js

@@ -0,0 +1,33 @@
+import { Command } from "commander";
+import { existsSync } from "fs";
+import { getProgress, countRemaining, getTaskFilePath } from "../task-parser/index.js";
+import { getIteration } from "../lib/ralph-dir.js";
+export function statusCommand() {
+    return new Command("status")
+        .description("Print task summary (done/total criteria, last iteration)")
+        .option("--task <path>", "Path to task file")
+        .action(async (opts) => {
+        const workspace = process.cwd();
+        const resolvedPath = getTaskFilePath(workspace, opts.task);
+        if (!existsSync(resolvedPath)) {
+            console.error("No task file found at", resolvedPath);
+            process.exit(2);
+        }
+        try {
+            const { parseTasks } = await import("../task-parser/index.js").then((m) => m);
+            parseTasks(workspace, opts.task);
+        }
+        catch {
+            console.error("Failed to parse task file");
+            process.exit(2);
+        }
+        const progress = getProgress(workspace, opts.task);
+        const [done, total] = progress.split(":").map(Number);
+        const remaining = countRemaining(workspace, opts.task);
+        const iteration = getIteration(workspace);
+        console.log("Task file:", resolvedPath);
+        console.log("Progress:", `${done} / ${total} criteria (${remaining} remaining)`);
+        console.log("Last iteration:", iteration);
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;SACzB,WAAW,CAAC,0DAA0D,CAAC;SACvE,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,IAAuB,EAAE,EAAE;QACxC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,YAAY,CAAC,CAAC;YACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9E,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QAE1C,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,IAAI,MAAM,KAAK,cAAc,SAAS,aAAa,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/task.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function taskCommand(): Command;
+//# sourceMappingURL=task.d.ts.map

package/dist/commands/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBpC,wBAAgB,WAAW,IAAI,OAAO,CA6JrC"}