ralphctl 0.2.4 → 0.3.0

package/README.md

@@ -99,6 +99,8 @@ Or run `ralphctl` with no arguments for an interactive menu that walks you throu
 - **Catch mistakes before they compound** — independent AI review after each task, iterating until quality passes or
   budget is exhausted
 - **Coordinate across repositories** — one sprint can span multiple repos with automatic dependency tracking
+- **Branch per sprint** — optional shared branch across every affected repo, with `sprint close --create-pr` to open
+  pull requests when you're done
 - **Run tasks in parallel** — one per repo, with rate-limit backoff and automatic session resume
 - **Separate the what from the how** — AI clarifies requirements first, then generates implementation tasks, with human
   approval gates
@@ -119,6 +121,15 @@ ralphctl config set provider copilot     # Use GitHub Copilot
 
 Auto-prompts on first AI command if not set. Both CLIs must be in your PATH and authenticated.
 
+Tune the generator-evaluator loop:
+
+```bash
+ralphctl config set evaluationIterations 2   # Up to 2 fix attempts per task (default: 1)
+ralphctl config set evaluationIterations 0   # Disable evaluation entirely
+```
+
+`sprint start --no-evaluate` skips evaluation for a single run without touching the global setting.
+
 <details>
 <summary>Provider differences</summary>
 
@@ -181,15 +192,16 @@ export RALPHCTL_ROOT="/path/to/custom/data-dir"
 
 ### Execution & Monitoring
 
-| Command                  | Description                       |
-| ------------------------ | --------------------------------- |
-| `ralphctl sprint start`  | Execute tasks with AI             |
-| `ralphctl sprint health` | Diagnose blockers and stale tasks |
-| `ralphctl status`        | Sprint overview with progress bar |
-| `ralphctl task list`     | List tasks in the current sprint  |
-| `ralphctl task next`     | Show the next unblocked task      |
-| `ralphctl sprint close`  | Close an active sprint            |
-| `ralphctl sprint delete` | Delete a sprint permanently       |
+| Command                    | Description                                            |
+| -------------------------- | ------------------------------------------------------ |
+| `ralphctl sprint start`    | Execute tasks with AI (`--branch` for a sprint branch) |
+| `ralphctl sprint health`   | Diagnose blockers and stale tasks                      |
+| `ralphctl sprint insights` | Analyze evaluator results across tasks                 |
+| `ralphctl status`          | Sprint overview with progress bar                      |
+| `ralphctl task list`       | List tasks in the current sprint                       |
+| `ralphctl task next`       | Show the next unblocked task                           |
+| `ralphctl sprint close`    | Close an active sprint (`--create-pr` for PRs)         |
+| `ralphctl sprint delete`   | Delete a sprint permanently                            |
 
 Run `ralphctl <command> --help` for details on any command.
 

package/dist/add-GX7P7XTT.mjs

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import {
+  addCheckScriptToRepository,
+  projectAddCommand
+} from "./chunk-D2YGPLIV.mjs";
+import "./chunk-NUYQK5MN.mjs";
+import "./chunk-CFUVE2BP.mjs";
+import "./chunk-747KW2RW.mjs";
+import "./chunk-FKMKOWLA.mjs";
+import "./chunk-IWXBJD2D.mjs";
+import "./chunk-CTP2A436.mjs";
+import "./chunk-57UWLHRH.mjs";
+export {
+  addCheckScriptToRepository,
+  projectAddCommand
+};

package/dist/add-JGUOR4Z5.mjs

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import {
+  addSingleTicketInteractive,
+  ticketAddCommand
+} from "./chunk-JXMHLW42.mjs";
+import "./chunk-NUYQK5MN.mjs";
+import "./chunk-HL4ZMHCQ.mjs";
+import "./chunk-CFUVE2BP.mjs";
+import "./chunk-747KW2RW.mjs";
+import "./chunk-YCDUVPRT.mjs";
+import "./chunk-FKMKOWLA.mjs";
+import "./chunk-IWXBJD2D.mjs";
+import "./chunk-CTP2A436.mjs";
+import "./chunk-57UWLHRH.mjs";
+export {
+  addSingleTicketInteractive,
+  ticketAddCommand
+};

package/dist/bootstrap-FMHG6DRY.mjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import {
+  getPrompt,
+  getSharedDeps,
+  setSharedDeps
+} from "./chunk-747KW2RW.mjs";
+export {
+  getPrompt,
+  getSharedDeps,
+  setSharedDeps
+};

package/dist/chunk-3QBEBKMZ.mjs

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+import {
+  listProjects
+} from "./chunk-NUYQK5MN.mjs";
+import {
+  EXIT_ERROR,
+  exitWithCode
+} from "./chunk-CFUVE2BP.mjs";
+import {
+  getPrompt
+} from "./chunk-747KW2RW.mjs";
+import {
+  createSprint,
+  setCurrentSprint
+} from "./chunk-YCDUVPRT.mjs";
+import {
+  emoji,
+  field,
+  formatSprintStatus,
+  icons,
+  showError,
+  showNextStep,
+  showRandomQuote,
+  showSuccess
+} from "./chunk-FKMKOWLA.mjs";
+
+// src/integration/cli/commands/sprint/create.ts
+async function sprintCreateCommand(options = {}) {
+  const projects = await listProjects();
+  if (projects.length === 0) {
+    showError("No projects configured.");
+    showNextStep("ralphctl project add", "add a project first");
+    if (options.interactive === false) exitWithCode(EXIT_ERROR);
+    return;
+  }
+  let projectId;
+  const projectFlag = options.project?.trim();
+  if (projectFlag) {
+    const match = projects.find((p) => p.name === projectFlag || p.id === projectFlag);
+    if (!match) {
+      showError(`Project not found: ${projectFlag}`);
+      if (options.interactive === false) exitWithCode(EXIT_ERROR);
+      return;
+    }
+    projectId = match.id;
+  } else if (options.interactive === false) {
+    showError("--project is required in non-interactive mode");
+    exitWithCode(EXIT_ERROR);
+  } else if (projects.length === 1 && projects[0]) {
+    projectId = projects[0].id;
+  } else {
+    projectId = await getPrompt().select({
+      message: `${icons.project} Project:`,
+      choices: projects.map((p) => ({ label: p.displayName, value: p.id, description: p.description }))
+    });
+  }
+  if (!projectId) {
+    showError("No project selected.");
+    return;
+  }
+  const pickedProject = projects.find((p) => p.id === projectId);
+  let name;
+  if (options.interactive === false) {
+    const trimmed = options.name?.trim();
+    name = trimmed && trimmed.length > 0 ? trimmed : void 0;
+  } else {
+    const inputName = await getPrompt().input({
+      message: `${icons.sprint} Sprint name (optional):`,
+      default: options.name?.trim()
+    });
+    const trimmed = inputName.trim();
+    name = trimmed.length > 0 ? trimmed : void 0;
+  }
+  const sprint = await createSprint({ projectId, name });
+  let setAsCurrent = true;
+  if (options.interactive) {
+    setAsCurrent = await getPrompt().confirm({
+      message: `${emoji.donut} Set as current sprint?`,
+      default: true
+    });
+  }
+  if (setAsCurrent) {
+    await setCurrentSprint(sprint.id);
+  }
+  showSuccess("Sprint created!", [
+    ["ID", sprint.id],
+    ["Name", sprint.name],
+    ["Project", pickedProject ? `${pickedProject.displayName} (${pickedProject.name})` : projectId],
+    ["Status", formatSprintStatus(sprint.status)]
+  ]);
+  showRandomQuote();
+  if (setAsCurrent) {
+    console.log(field("Current", "Yes (this sprint is now active target)"));
+    showNextStep("ralphctl ticket add", "add tickets to this sprint");
+  } else {
+    console.log(field("Current", "No"));
+    showNextStep(`ralphctl sprint current ${sprint.id}`, "set as current later");
+  }
+}
+
+export {
+  sprintCreateCommand
+};