ralphctl 0.2.4 → 0.3.0

package/dist/create-MYGOWO2F.mjs

@@ -1,12 +0,0 @@
-#!/usr/bin/env node
-import {
-  sprintCreateCommand
-} from "./chunk-DUU5346E.mjs";
-import "./chunk-JRFOUFD3.mjs";
-import "./chunk-OEUJDSHY.mjs";
-import "./chunk-IB6OCKZW.mjs";
-import "./chunk-EDJX7TT6.mjs";
-import "./chunk-QBXHAXHI.mjs";
-export {
-  sprintCreateCommand
-};

package/dist/multiline-OHSNFCRG.mjs

@@ -1,40 +0,0 @@
-#!/usr/bin/env node
-import {
-  icons,
-  muted
-} from "./chunk-QBXHAXHI.mjs";
-
-// src/utils/multiline.ts
-import * as readline from "readline";
-async function multilineInput(options) {
-  const { message, default: defaultValue, hint = "Ctrl+D to finish" } = options;
-  console.log(`${icons.edit} ${message} ${muted(`(${hint})`)}`);
-  if (defaultValue) {
-    console.log(muted("  Default:"));
-    for (const line of defaultValue.split("\n")) {
-      console.log(muted(`    ${line}`));
-    }
-    console.log("");
-  }
-  const lines = [];
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-    terminal: process.stdin.isTTY
-  });
-  return new Promise((resolve) => {
-    rl.on("line", (line) => {
-      lines.push(line);
-    });
-    rl.on("close", () => {
-      console.log("");
-      while (lines.length > 0 && lines.at(-1)?.trim() === "") {
-        lines.pop();
-      }
-      resolve(lines.join("\n"));
-    });
-  });
-}
-export {
-  multilineInput
-};

package/dist/wizard-HWOH2HPV.mjs

@@ -1,193 +0,0 @@
-#!/usr/bin/env node
-import {
-  sprintPlanCommand,
-  sprintRefineCommand,
-  sprintStartCommand
-} from "./chunk-U62BX47C.mjs";
-import "./chunk-7LZ6GOGN.mjs";
-import {
-  sprintCreateCommand
-} from "./chunk-DUU5346E.mjs";
-import {
-  addSingleTicketInteractive
-} from "./chunk-742XQ7FL.mjs";
-import "./chunk-7TG3EAQ2.mjs";
-import "./chunk-EUNAUHC3.mjs";
-import {
-  getCurrentSprint,
-  getSprint
-} from "./chunk-JRFOUFD3.mjs";
-import {
-  ensureError,
-  wrapAsync
-} from "./chunk-OEUJDSHY.mjs";
-import "./chunk-IB6OCKZW.mjs";
-import "./chunk-EDJX7TT6.mjs";
-import {
-  colors,
-  emoji,
-  icons,
-  log,
-  printHeader,
-  printSeparator,
-  progressBar,
-  showSuccess,
-  showWarning
-} from "./chunk-QBXHAXHI.mjs";
-
-// src/interactive/wizard.ts
-import { confirm } from "@inquirer/prompts";
-var TOTAL_STEPS = 5;
-function showStepProgress(step, title) {
-  const bar = progressBar(step - 1, TOTAL_STEPS, { width: 10, showPercent: false });
-  log.newline();
-  printSeparator();
-  console.log(`  ${colors.highlight(`Step ${String(step)} of ${String(TOTAL_STEPS)}`)}  ${bar}  ${title}`);
-  log.newline();
-}
-async function runWizard() {
-  const r = await wrapAsync(async () => {
-    printHeader("Sprint Setup Wizard", emoji.donut);
-    log.dim("This wizard will guide you through setting up a new sprint.");
-    log.dim("You can skip optional steps along the way.");
-    log.newline();
-    showStepProgress(1, "Create Sprint");
-    const createResult = await wrapAsync(() => sprintCreateCommand({ interactive: true }), ensureError);
-    if (!createResult.ok) {
-      log.error(`Sprint creation failed: ${createResult.error.message}`);
-      log.newline();
-      showWarning("Cannot continue without a sprint. Wizard aborted.");
-      return;
-    }
-    const sprintId = await getCurrentSprint();
-    if (!sprintId) {
-      showWarning("No current sprint set. Wizard aborted.");
-      return;
-    }
-    showStepProgress(2, "Add Tickets");
-    let ticketCount = 0;
-    let addMore = true;
-    while (addMore) {
-      const ticketResult = await wrapAsync(() => addSingleTicketInteractive({}), ensureError);
-      if (ticketResult.ok) {
-        if (ticketResult.value) {
-          ticketCount++;
-        } else {
-          break;
-        }
-      } else {
-        log.error(`Failed to add ticket: ${ticketResult.error.message}`);
-      }
-      log.newline();
-      addMore = await confirm({
-        message: `${emoji.donut} Add another ticket?`,
-        default: true
-      });
-    }
-    if (ticketCount === 0) {
-      log.newline();
-      showWarning("No tickets added. You can add them later with: ralphctl ticket add");
-    }
-    showStepProgress(3, "Refine Requirements");
-    if (ticketCount === 0) {
-      log.dim("Skipped -- no tickets to refine.");
-    } else {
-      const shouldRefine = await confirm({
-        message: `${emoji.donut} Refine requirements now?`,
-        default: true
-      });
-      if (shouldRefine) {
-        const refineResult = await wrapAsync(() => sprintRefineCommand([]), ensureError);
-        if (!refineResult.ok) {
-          log.error(`Refinement failed: ${refineResult.error.message}`);
-          log.dim("You can refine later with: ralphctl sprint refine");
-        }
-      } else {
-        log.dim("Skipped. You can refine later with: ralphctl sprint refine");
-      }
-    }
-    showStepProgress(4, "Plan Tasks");
-    let canPlan = false;
-    const sprintCheckResult = await wrapAsync(() => getSprint(sprintId), ensureError);
-    if (sprintCheckResult.ok) {
-      const sprint = sprintCheckResult.value;
-      const hasTickets = sprint.tickets.length > 0;
-      const allApproved = hasTickets && sprint.tickets.every((t) => t.requirementStatus === "approved");
-      canPlan = allApproved;
-      if (!hasTickets) {
-        log.dim("Skipped -- no tickets to plan.");
-      } else if (!allApproved) {
-        log.dim("Skipped -- not all requirements are approved yet.");
-        log.dim("Refine first with: ralphctl sprint refine");
-      }
-    } else {
-      log.dim("Skipped -- could not read sprint state.");
-    }
-    if (canPlan) {
-      const shouldPlan = await confirm({
-        message: `${emoji.donut} Generate tasks now?`,
-        default: true
-      });
-      if (shouldPlan) {
-        const planResult = await wrapAsync(() => sprintPlanCommand([]), ensureError);
-        if (!planResult.ok) {
-          log.error(`Planning failed: ${planResult.error.message}`);
-          log.dim("You can plan later with: ralphctl sprint plan");
-        }
-      } else {
-        log.dim("Skipped. You can plan later with: ralphctl sprint plan");
-      }
-    }
-    showStepProgress(5, "Start Execution");
-    const shouldStart = await confirm({
-      message: `${emoji.donut} Start execution now?`,
-      default: false
-    });
-    if (shouldStart) {
-      const startResult = await wrapAsync(
-        // Note: sprintStartCommand may call process.exit() on completion
-        () => sprintStartCommand([]),
-        ensureError
-      );
-      if (!startResult.ok) {
-        log.error(`Execution failed: ${startResult.error.message}`);
-      }
-      return;
-    }
-    log.newline();
-    printSeparator();
-    showSuccess("Wizard complete!");
-    log.newline();
-    const summaryResult = await wrapAsync(() => getSprint(sprintId), ensureError);
-    if (summaryResult.ok) {
-      const sprint = summaryResult.value;
-      log.info(`Sprint "${sprint.name}" is ready.`);
-      log.item(`${icons.ticket}  ${String(sprint.tickets.length)} ticket(s)`);
-      const approvedCount = sprint.tickets.filter((t) => t.requirementStatus === "approved").length;
-      if (sprint.tickets.length > 0) {
-        log.item(`${icons.success}  ${String(approvedCount)}/${String(sprint.tickets.length)} requirements approved`);
-      }
-    }
-    log.newline();
-    log.dim("Next steps:");
-    if (ticketCount === 0) {
-      log.item("ralphctl ticket add --project <name>");
-    }
-    log.item("ralphctl sprint refine");
-    log.item("ralphctl sprint plan");
-    log.item("ralphctl sprint start");
-    log.newline();
-  }, ensureError);
-  if (!r.ok) {
-    if (r.error.name === "ExitPromptError") {
-      log.newline();
-      showWarning("Wizard cancelled");
-      log.newline();
-      return;
-    }
-    throw r.error;
-  }
-}
-export {
-  runWizard
-};

package/schemas/config.schema.json

@@ -1,30 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "config.schema.json",
-  "title": "Config",
-  "description": "RalphCTL configuration",
-  "type": "object",
-  "properties": {
-    "currentSprint": {
-      "type": ["string", "null"],
-      "default": null,
-      "description": "Current sprint ID (which sprint CLI commands target)"
-    },
-    "aiProvider": {
-      "type": ["string", "null"],
-      "enum": ["claude", "copilot", null],
-      "default": null,
-      "description": "AI provider to use for code generation (claude or copilot)"
-    },
-    "editor": {
-      "type": ["string", "null"],
-      "default": null,
-      "description": "Editor command for editing files (e.g., 'subl -w', 'code --wait', 'vim')"
-    },
-    "evaluationIterations": {
-      "type": "integer",
-      "minimum": 0,
-      "description": "Number of evaluation iterations (0 = disabled, default fallback: 1)"
-    }
-  }
-}

package/schemas/ideate-output.schema.json

@@ -1,22 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "Ideate Output Schema",
-  "description": "Combined requirements and tasks from sprint ideate command",
-  "type": "object",
-  "required": ["requirements", "tasks"],
-  "properties": {
-    "requirements": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Refined requirements in markdown format"
-    },
-    "tasks": {
-      "type": "array",
-      "description": "Array of implementation tasks",
-      "items": {
-        "$ref": "task-import.schema.json#/definitions/ImportTask"
-      }
-    }
-  },
-  "additionalProperties": false
-}

package/schemas/projects.schema.json

@@ -1,58 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "projects.schema.json",
-  "title": "Projects",
-  "description": "Array of project definitions",
-  "type": "array",
-  "items": {
-    "type": "object",
-    "required": ["name", "displayName", "repositories"],
-    "properties": {
-      "name": {
-        "type": "string",
-        "pattern": "^[a-z0-9-]+$",
-        "minLength": 1,
-        "description": "Project slug (lowercase, numbers, hyphens only)"
-      },
-      "displayName": {
-        "type": "string",
-        "minLength": 1,
-        "description": "Human-readable project name"
-      },
-      "repositories": {
-        "type": "array",
-        "minItems": 1,
-        "description": "Array of repositories for this project",
-        "items": {
-          "type": "object",
-          "required": ["name", "path"],
-          "properties": {
-            "name": {
-              "type": "string",
-              "minLength": 1,
-              "description": "Repository name (auto-derived from path basename)"
-            },
-            "path": {
-              "type": "string",
-              "minLength": 1,
-              "description": "Absolute path to the repository"
-            },
-            "checkScript": {
-              "type": "string",
-              "description": "Idempotent check command that bootstraps and verifies the environment (e.g., pnpm install && pnpm typecheck && pnpm lint && pnpm test)"
-            },
-            "checkTimeout": {
-              "type": "number",
-              "exclusiveMinimum": 0,
-              "description": "Per-repo timeout in milliseconds for check script execution (overrides RALPHCTL_SETUP_TIMEOUT_MS)"
-            }
-          }
-        }
-      },
-      "description": {
-        "type": "string",
-        "description": "Optional project description"
-      }
-    }
-  }
-}

package/schemas/requirements-output.schema.json

@@ -1,24 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "requirements-output.schema.json",
-  "title": "Requirements Output",
-  "description": "Schema for refined requirements output from ralphctl sprint refine",
-  "type": "array",
-  "items": {
-    "type": "object",
-    "required": ["ref", "requirements"],
-    "additionalProperties": false,
-    "properties": {
-      "ref": {
-        "type": "string",
-        "minLength": 1,
-        "description": "Reference to the ticket - either internal ID, external ID, or exact title"
-      },
-      "requirements": {
-        "type": "string",
-        "minLength": 1,
-        "description": "Refined requirements in markdown format - should include problem statement, requirements, acceptance criteria, scope, and constraints"
-      }
-    }
-  }
-}

package/schemas/sprint.schema.json

@@ -1,109 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "sprint.schema.json",
-  "title": "Sprint",
-  "description": "Sprint metadata and tickets",
-  "type": "object",
-  "required": ["id", "name", "status", "createdAt"],
-  "properties": {
-    "id": {
-      "type": "string",
-      "pattern": "^\\d{8}-\\d{6}-[a-z0-9-]+$",
-      "description": "Sprint ID in format YYYYMMDD-HHmmss-<slug> (lexicographically sortable)"
-    },
-    "name": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Human-readable sprint name"
-    },
-    "status": {
-      "type": "string",
-      "enum": ["draft", "active", "closed"],
-      "default": "draft",
-      "description": "Sprint status (one-way: draft → active → closed)"
-    },
-    "createdAt": {
-      "type": "string",
-      "format": "date-time",
-      "description": "ISO 8601 timestamp when sprint was created"
-    },
-    "activatedAt": {
-      "type": ["string", "null"],
-      "format": "date-time",
-      "default": null,
-      "description": "ISO 8601 timestamp when sprint was activated"
-    },
-    "closedAt": {
-      "type": ["string", "null"],
-      "format": "date-time",
-      "default": null,
-      "description": "ISO 8601 timestamp when sprint was closed"
-    },
-    "checkRanAt": {
-      "type": "object",
-      "default": {},
-      "description": "Map of projectPath → ISO 8601 timestamp recording when check script last ran (per sprint lifecycle)",
-      "additionalProperties": {
-        "type": "string",
-        "format": "date-time"
-      }
-    },
-    "branch": {
-      "type": ["string", "null"],
-      "default": null,
-      "description": "Branch name used for sprint execution. When set, all repos checkout this branch before task execution."
-    },
-    "tickets": {
-      "type": "array",
-      "default": [],
-      "description": "Tickets to be planned into tasks",
-      "items": {
-        "type": "object",
-        "required": ["id", "title", "projectName"],
-        "properties": {
-          "id": {
-            "type": "string",
-            "minLength": 1,
-            "description": "Internal ticket ID (uuid8, auto-generated)"
-          },
-          "title": {
-            "type": "string",
-            "minLength": 1,
-            "description": "Short summary of the work"
-          },
-          "description": {
-            "type": "string",
-            "description": "Detailed description of requirements, acceptance criteria, context"
-          },
-          "link": {
-            "type": "string",
-            "format": "uri",
-            "description": "URL to external issue tracker"
-          },
-          "projectName": {
-            "type": "string",
-            "minLength": 1,
-            "description": "Reference to project name (from projects.json)"
-          },
-          "requirementStatus": {
-            "type": "string",
-            "enum": ["pending", "approved"],
-            "default": "pending",
-            "description": "Status of requirement refinement"
-          },
-          "affectedRepositories": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "Repository paths selected during planning"
-          },
-          "requirements": {
-            "type": "string",
-            "description": "Refined requirements (set during sprint refine)"
-          }
-        }
-      }
-    }
-  }
-}

package/schemas/task-import.schema.json

@@ -1,56 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "task-import.schema.json",
-  "title": "Task Import",
-  "description": "Schema for importing tasks via ralphctl task import or scope plan",
-  "type": "array",
-  "items": {
-    "type": "object",
-    "required": ["name", "projectPath"],
-    "properties": {
-      "name": {
-        "type": "string",
-        "minLength": 1,
-        "description": "Task name - concise, actionable description"
-      },
-      "description": {
-        "type": "string",
-        "description": "Detailed description of what the task accomplishes"
-      },
-      "steps": {
-        "type": "array",
-        "description": "Implementation steps - specific, actionable items",
-        "items": {
-          "type": "string"
-        }
-      },
-      "verificationCriteria": {
-        "type": "array",
-        "description": "Definition-of-done checks used to evaluate task completion",
-        "items": {
-          "type": "string"
-        }
-      },
-      "ticketId": {
-        "type": "string",
-        "description": "Reference to parent ticket ID (e.g., TICKET-001)"
-      },
-      "id": {
-        "type": "string",
-        "description": "Local ID for referencing this task in blockedBy (e.g., '1', 'auth-setup'). Converted to real ID on import."
-      },
-      "blockedBy": {
-        "type": "array",
-        "description": "IDs of tasks that must complete first. Reference tasks by their 'id' field.",
-        "items": {
-          "type": "string"
-        }
-      },
-      "projectPath": {
-        "type": "string",
-        "minLength": 1,
-        "description": "Absolute path to the repository where this task should execute. Must be one of the project's paths."
-      }
-    }
-  }
-}

package/schemas/tasks.schema.json

@@ -1,98 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "tasks.schema.json",
-  "title": "Tasks",
-  "description": "Array of tasks in a sprint",
-  "type": "array",
-  "items": {
-    "type": "object",
-    "required": ["id", "name", "status", "order", "projectPath"],
-    "properties": {
-      "id": {
-        "type": "string",
-        "minLength": 1,
-        "description": "Task ID (uuid8)"
-      },
-      "name": {
-        "type": "string",
-        "minLength": 1,
-        "description": "Task name"
-      },
-      "description": {
-        "type": "string",
-        "description": "Task description"
-      },
-      "steps": {
-        "type": "array",
-        "default": [],
-        "description": "Implementation steps",
-        "items": {
-          "type": "string"
-        }
-      },
-      "verificationCriteria": {
-        "type": "array",
-        "default": [],
-        "description": "Definition-of-done checks used to evaluate task completion",
-        "items": {
-          "type": "string"
-        }
-      },
-      "status": {
-        "type": "string",
-        "enum": ["todo", "in_progress", "done"],
-        "default": "todo",
-        "description": "Task status (kanban: todo → in_progress → done)"
-      },
-      "order": {
-        "type": "integer",
-        "minimum": 1,
-        "description": "Task priority order"
-      },
-      "ticketId": {
-        "type": "string",
-        "description": "Reference to parent ticket (internal ID)"
-      },
-      "blockedBy": {
-        "type": "array",
-        "default": [],
-        "description": "Task IDs that must complete before this task can start",
-        "items": {
-          "type": "string"
-        }
-      },
-      "projectPath": {
-        "type": "string",
-        "minLength": 1,
-        "description": "Absolute path to the project directory for execution"
-      },
-      "verified": {
-        "type": "boolean",
-        "default": false,
-        "description": "Whether the task passed verification"
-      },
-      "verificationOutput": {
-        "type": "string",
-        "description": "Output from the verification run"
-      },
-      "evaluated": {
-        "type": "boolean",
-        "default": false,
-        "description": "Whether the evaluator ran on this task"
-      },
-      "evaluationOutput": {
-        "type": "string",
-        "description": "Output from the evaluation run (truncated to 2000 chars; full critique in evaluationFile)"
-      },
-      "evaluationStatus": {
-        "type": "string",
-        "enum": ["passed", "failed", "malformed"],
-        "description": "Evaluation outcome discriminator. 'malformed' = evaluator output had no parseable signal."
-      },
-      "evaluationFile": {
-        "type": "string",
-        "description": "Sidecar file path containing the full untruncated critique"
-      }
-    }
-  }
-}