ralphctl 0.2.5 → 0.3.0

package/dist/{chunk-7TG3EAQ2.mjs → chunk-CFUVE2BP.mjs}

@@ -1,20 +1,16 @@
 #!/usr/bin/env node
 
-// src/utils/exit-codes.ts
-var EXIT_SUCCESS = 0;
+// src/domain/exit-codes.ts
 var EXIT_ERROR = 1;
 var EXIT_NO_TASKS = 2;
-var EXIT_ALL_BLOCKED = 3;
 var EXIT_INTERRUPTED = 130;
 function exitWithCode(code) {
   process.exit(code);
 }
 
 export {
-  EXIT_SUCCESS,
   EXIT_ERROR,
   EXIT_NO_TASKS,
-  EXIT_ALL_BLOCKED,
   EXIT_INTERRUPTED,
   exitWithCode
 };

package/dist/{chunk-IB6OCKZW.mjs → chunk-CTP2A436.mjs}

@@ -3,27 +3,13 @@ import {
   IOError,
   StorageError,
   ValidationError
-} from "./chunk-EDJX7TT6.mjs";
+} from "./chunk-57UWLHRH.mjs";
 
-// src/utils/paths.ts
-import { fileURLToPath } from "url";
-import { dirname, isAbsolute, join, resolve, sep } from "path";
-import { existsSync } from "fs";
+// src/integration/persistence/paths.ts
+import { isAbsolute, join, resolve, sep } from "path";
 import { homedir } from "os";
 import { lstat, realpath, stat } from "fs/promises";
 import { Result } from "typescript-result";
-var __filename = fileURLToPath(import.meta.url);
-var __dirname = dirname(__filename);
-function getRepoRoot() {
-  let dir = __dirname;
-  while (dir !== dirname(dir)) {
-    if (existsSync(join(dir, "package.json"))) {
-      return dir;
-    }
-    dir = dirname(dir);
-  }
-  return join(__dirname, "..", "..");
-}
 function getDataDir() {
   return process.env["RALPHCTL_ROOT"] ?? join(homedir(), ".ralphctl");
 }
@@ -72,13 +58,10 @@ function getRefinementDir(sprintId, ticketId) {
 function getPlanningDir(sprintId) {
   return join(getSprintDir(sprintId), "planning");
 }
-function getIdeateDir(sprintId, ticketId) {
+function getIdeationDir(sprintId, ticketId) {
   assertSafeSegment(ticketId, "ticket ID");
   return join(getSprintDir(sprintId), "ideation", ticketId);
 }
-function getSchemaPath(schemaName) {
-  return join(getRepoRoot(), "schemas", schemaName);
-}
 function assertSafeCwd(path) {
   if (!path || path.includes("\0") || path.includes("\n") || path.includes("\r")) {
     throw new Error("Unsafe path for cwd: contains null bytes or newlines");
@@ -115,9 +98,9 @@ async function validateProjectPath(path) {
   }
 }
 
-// src/utils/storage.ts
+// src/integration/persistence/storage.ts
 import { access, appendFile, mkdir, readdir, readFile, rm, writeFile } from "fs/promises";
-import { dirname as dirname2 } from "path";
+import { dirname } from "path";
 import { Result as Result2 } from "typescript-result";
 async function ensureDir(dirPath) {
   await mkdir(dirPath, { recursive: true });
@@ -177,7 +160,7 @@ ${issues}`, filePath, result.error)
     );
   }
   try {
-    await ensureDir(dirname2(filePath));
+    await ensureDir(dirname(filePath));
     await writeFile(filePath, JSON.stringify(result.data, null, 2) + "\n", { encoding: "utf-8", mode: 384 });
   } catch (err) {
     return Result2.error(new StorageError(`Failed to write ${filePath}`, err instanceof Error ? err : void 0));
@@ -186,7 +169,7 @@ ${issues}`, filePath, result.error)
 }
 async function appendToFile(filePath, content) {
   try {
-    await ensureDir(dirname2(filePath));
+    await ensureDir(dirname(filePath));
     await appendFile(filePath, content, { encoding: "utf-8", mode: 384 });
     return Result2.ok(void 0);
   } catch (err) {
@@ -205,13 +188,16 @@ async function readTextFile(filePath) {
   }
 }
 
-// src/schemas/index.ts
+// src/domain/models.ts
 import { z } from "zod";
 var SprintStatusSchema = z.enum(["draft", "active", "closed"]);
 var TaskStatusSchema = z.enum(["todo", "in_progress", "done"]);
 var RequirementStatusSchema = z.enum(["pending", "approved"]);
-var EvaluationStatusSchema = z.enum(["passed", "failed", "malformed"]);
+var EvaluationStatusSchema = z.enum(["passed", "failed", "malformed", "plateau"]);
+var IdSchema = z.string().min(1);
 var RepositorySchema = z.object({
+  id: IdSchema,
+  // UUID8, stable across renames
   name: z.string().min(1),
   // Auto-derived from basename(path)
   path: z.string().min(1),
@@ -222,6 +208,7 @@ var RepositorySchema = z.object({
   // Per-repo timeout in ms (overrides RALPHCTL_SETUP_TIMEOUT_MS)
 });
 var ProjectSchema = z.object({
+  id: IdSchema,
   name: z.string().min(1).regex(/^[a-z0-9-]+$/, "Project name must be a slug (lowercase, numbers, hyphens only)"),
   displayName: z.string().min(1),
   repositories: z.array(RepositorySchema).min(1),
@@ -229,21 +216,19 @@ var ProjectSchema = z.object({
 });
 var ProjectsSchema = z.array(ProjectSchema);
 var TicketSchema = z.object({
-  id: z.string().min(1),
-  // Internal UUID8 (auto-generated)
+  id: IdSchema,
+  // UUID8
   title: z.string().min(1),
   description: z.string().optional(),
   link: z.url().optional(),
-  projectName: z.string().min(1),
-  // References Project.name
-  affectedRepositories: z.array(z.string()).optional(),
-  // Repository paths selected during planning
+  affectedRepoIds: z.array(IdSchema).optional(),
+  // Subset of sprint's project's repos
   requirementStatus: RequirementStatusSchema.default("pending"),
   requirements: z.string().optional()
-  // Refined requirements (set during sprint refine)
+  // Set during sprint refine
 });
 var TaskSchema = z.object({
-  id: z.string().min(1),
+  id: IdSchema,
   // UUID8
   name: z.string().min(1),
   description: z.string().optional(),
@@ -251,37 +236,31 @@ var TaskSchema = z.object({
   verificationCriteria: z.array(z.string()).default([]),
   status: TaskStatusSchema.default("todo"),
   order: z.number().int().positive(),
-  ticketId: z.string().optional(),
-  // References Ticket.id (internal)
-  blockedBy: z.array(z.string()).default([]),
-  projectPath: z.string().min(1),
-  // Single path for execution
+  ticketId: IdSchema.optional(),
+  blockedBy: z.array(IdSchema).default([]),
+  repoId: IdSchema,
+  // Required — resolves to an absolute path at runtime
   verified: z.boolean().default(false),
-  // Whether verification passed
   verificationOutput: z.string().optional(),
-  // Output from verification run
   evaluated: z.boolean().default(false),
-  // Whether evaluation passed
   evaluationOutput: z.string().optional(),
-  // Truncated output from evaluation run (full critique lives in evaluationFile)
   evaluationStatus: EvaluationStatusSchema.optional(),
-  // Discriminator: 'passed' | 'failed' | 'malformed'
-  evaluationFile: z.string().optional()
-  // Sidecar file path containing the full untruncated critique
+  evaluationFile: z.string().optional(),
+  // Planner-emitted extra evaluator dimensions; floor-only when undefined.
+  extraDimensions: z.array(z.string().min(1)).optional()
 });
 var TasksSchema = z.array(TaskSchema);
 var ImportTaskSchema = z.object({
   id: z.string().optional(),
   // Local ID for referencing in blockedBy
   name: z.string().min(1),
-  // Required
   description: z.string().optional(),
   steps: z.array(z.string()).optional(),
   verificationCriteria: z.array(z.string()).optional(),
   ticketId: z.string().optional(),
   blockedBy: z.array(z.string()).optional(),
-  projectPath: z.string().min(1)
-  // Required - execution directory
+  repoId: IdSchema,
+  extraDimensions: z.array(z.string().min(1)).optional()
 });
 var ImportTasksSchema = z.array(ImportTaskSchema);
 var RefinedRequirementSchema = z.object({
@@ -296,12 +275,14 @@ var IdeateOutputSchema = z.object({
 var SprintSchema = z.object({
   id: z.string().regex(/^\d{8}-\d{6}-[a-z0-9-]+$/, "Invalid sprint ID format"),
   name: z.string().min(1),
+  projectId: IdSchema,
+  // Every sprint belongs to exactly one project
   status: SprintStatusSchema.default("draft"),
   createdAt: z.iso.datetime(),
   activatedAt: z.iso.datetime().nullable().default(null),
   closedAt: z.iso.datetime().nullable().default(null),
   tickets: z.array(TicketSchema).default([]),
-  checkRanAt: z.record(z.string(), z.iso.datetime()).default({}),
+  checkRanAt: z.record(IdSchema, z.iso.datetime()).default({}),
   branch: z.string().nullable().default(null)
 });
 var AiProviderSchema = z.enum(["claude", "copilot"]);
@@ -311,6 +292,28 @@ var ConfigSchema = z.object({
   editor: z.string().nullable().default(null),
   evaluationIterations: z.number().int().min(0).optional()
 });
+function getRequirementsOutputJsonSchema() {
+  return JSON.stringify(z.toJSONSchema(RefinedRequirementsSchema), null, 2);
+}
+function getTaskImportJsonSchema() {
+  return JSON.stringify(z.toJSONSchema(ImportTasksSchema), null, 2);
+}
+
+// src/domain/ids.ts
+import { randomBytes } from "crypto";
+function generateUuid8() {
+  return randomBytes(4).toString("hex");
+}
+function slugify(input, maxLength = 40) {
+  return input.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/-{2,}/g, "-").slice(0, maxLength).replace(/-$/, "");
+}
+function generateSprintId(name) {
+  const now = /* @__PURE__ */ new Date();
+  const date = now.toISOString().slice(0, 10).replace(/-/g, "");
+  const time = now.toISOString().slice(11, 19).replace(/:/g, "");
+  const slug = name ? slugify(name) : generateUuid8();
+  return `${date}-${time}-${slug || generateUuid8()}`;
+}
 
 export {
   getDataDir,
@@ -324,8 +327,7 @@ export {
   getEvaluationFilePath,
   getRefinementDir,
   getPlanningDir,
-  getIdeateDir,
-  getSchemaPath,
+  getIdeationDir,
   assertSafeCwd,
   expandTilde,
   validateProjectPath,
@@ -346,6 +348,9 @@ export {
   RefinedRequirementsSchema,
   IdeateOutputSchema,
   SprintSchema,
-  AiProviderSchema,
-  ConfigSchema
+  ConfigSchema,
+  getRequirementsOutputJsonSchema,
+  getTaskImportJsonSchema,
+  generateUuid8,
+  generateSprintId
 };

package/dist/{chunk-UBPZHHCD.mjs → chunk-D2YGPLIV.mjs}

@@ -1,26 +1,14 @@
 #!/usr/bin/env node
 import {
-  escapableSelect
-} from "./chunk-7LZ6GOGN.mjs";
+  createProject
+} from "./chunk-NUYQK5MN.mjs";
 import {
   EXIT_ERROR,
   exitWithCode
-} from "./chunk-7TG3EAQ2.mjs";
-import {
-  createProject
-} from "./chunk-EUNAUHC3.mjs";
+} from "./chunk-CFUVE2BP.mjs";
 import {
-  ensureError,
-  wrapAsync
-} from "./chunk-OEUJDSHY.mjs";
-import {
-  expandTilde,
-  validateProjectPath
-} from "./chunk-IB6OCKZW.mjs";
-import {
-  IOError,
-  ProjectExistsError
-} from "./chunk-EDJX7TT6.mjs";
+  getPrompt
+} from "./chunk-747KW2RW.mjs";
 import {
   createSpinner,
   emoji,
@@ -33,19 +21,74 @@ import {
   showSuccess,
   showTip,
   showWarning
-} from "./chunk-QBXHAXHI.mjs";
+} from "./chunk-FKMKOWLA.mjs";
+import {
+  ensureError,
+  wrapAsync
+} from "./chunk-IWXBJD2D.mjs";
+import {
+  expandTilde,
+  validateProjectPath
+} from "./chunk-CTP2A436.mjs";
+import {
+  IOError,
+  ProjectExistsError
+} from "./chunk-57UWLHRH.mjs";
 
-// src/commands/project/add.ts
+// src/integration/cli/commands/project/add.ts
 import { existsSync as existsSync2, statSync as statSync2 } from "fs";
 import { basename, join as join3, resolve as resolve2 } from "path";
-import { input, select } from "@inquirer/prompts";
 import { Result as Result3 } from "typescript-result";
 
-// src/interactive/file-browser.ts
+// src/integration/ui/prompts/file-browser-impl.ts
 import { readdirSync, statSync } from "fs";
 import { homedir } from "os";
 import { dirname, join, resolve } from "path";
 import { Result } from "typescript-result";
+
+// src/business/ports/prompt.ts
+var PromptCancelledError = class extends Error {
+  constructor(message = "Prompt cancelled by user") {
+    super(message);
+    this.name = "PromptCancelledError";
+  }
+};
+
+// src/integration/ui/prompts/escapable.ts
+function isChoice(item) {
+  return "value" in item && "name" in item;
+}
+async function escapableSelect(config) {
+  const choices = config.choices.map(
+    (item) => {
+      if (isChoice(item)) {
+        return {
+          label: item.name,
+          value: item.value,
+          description: item.description,
+          disabled: item.disabled
+        };
+      }
+      return {
+        label: item.separator,
+        value: void 0,
+        disabled: true
+      };
+    }
+  );
+  try {
+    return await getPrompt().select({
+      message: config.message,
+      choices,
+      default: config.default
+    });
+  } catch (err) {
+    if (err instanceof PromptCancelledError) return null;
+    throw err;
+  }
+}
+
+// src/integration/ui/prompts/file-browser-impl.ts
 function listDirectories(dirPath) {
   const r = Result.try(() => readdirSync(dirPath, { withFileTypes: true }));
   if (!r.ok) return [];
@@ -110,9 +153,7 @@ async function browseDirectory(message = "Browse to directory:", startPath) {
       () => escapableSelect({
         message: `${emoji.donut} ${message}
    ${muted(currentPath)}`,
-        choices,
-        pageSize: 15,
-        loop: false
+        choices
       }),
       ensureError
     );
@@ -141,7 +182,7 @@ async function browseDirectory(message = "Browse to directory:", startPath) {
   }
 }
 
-// src/utils/detect-scripts.ts
+// src/integration/external/detect-scripts.ts
 import { existsSync, readFileSync } from "fs";
 import { join as join2 } from "path";
 import { Result as Result2 } from "typescript-result";
@@ -287,7 +328,7 @@ function suggestCheckScript(projectPath) {
   return parts.length > 0 ? parts.join(" && ") : null;
 }
 
-// src/commands/project/add.ts
+// src/integration/cli/commands/project/add.ts
 function validateSlug(slug) {
   return /^[a-z0-9-]+$/.test(slug);
 }
@@ -306,7 +347,7 @@ async function addCheckScriptToRepository(repo) {
     log.success(`  Detected: ${detectR.value.typeLabel}`);
     suggested = suggestCheckScript(repo.path);
   }
-  const checkInput = await input({
+  const checkInput = await getPrompt().input({
     message: "  Check script (optional):",
     default: suggested ?? void 0
   });
@@ -366,7 +407,7 @@ async function projectAddCommand(options = {}) {
     const trimmedDesc = options.description?.trim();
     description = trimmedDesc === "" ? void 0 : trimmedDesc;
   } else {
-    name = await input({
+    name = await getPrompt().input({
       message: "Project name (slug):",
       default: options.name?.trim(),
       validate: (v) => {
@@ -377,7 +418,7 @@ async function projectAddCommand(options = {}) {
       }
     });
     name = name.trim();
-    displayName = await input({
+    displayName = await getPrompt().input({
       message: "Display name:",
       default: options.displayName?.trim() ?? name,
       validate: (v) => v.trim().length > 0 ? true : "Display name is required"
@@ -394,12 +435,12 @@ async function projectAddCommand(options = {}) {
       }
     }
     if (repositories.length === 0) {
-      const pathMethod = await select({
+      const pathMethod = await getPrompt().select({
         message: `${emoji.donut} How to specify repository path?`,
         choices: [
-          { name: "Browse filesystem", value: "browse", description: "Navigate from home folder" },
-          { name: "Use current directory", value: "cwd", description: process.cwd() },
-          { name: "Type path manually", value: "manual" }
+          { label: "Browse filesystem", value: "browse", description: "Navigate from home folder" },
+          { label: "Use current directory", value: "cwd", description: process.cwd() },
+          { label: "Type path manually", value: "manual" }
         ]
       });
       let firstPath;
@@ -413,7 +454,7 @@ async function projectAddCommand(options = {}) {
       } else if (pathMethod === "cwd") {
         firstPath = process.cwd();
       } else {
-        firstPath = await input({
+        firstPath = await getPrompt().input({
           message: "Repository path:",
           default: process.cwd(),
           validate: async (v) => {
@@ -440,17 +481,17 @@ async function projectAddCommand(options = {}) {
         showTip("Add CLAUDE.md or .github/copilot-instructions.md for better AI assistance");
       }
       log.info(`
-Configuring: ${firstRepo.name}`);
+Configuring: ${firstRepo.name ?? basename(firstRepo.path)}`);
       repositories[0] = await addCheckScriptToRepository(firstRepo);
     }
     let addMore = true;
     while (addMore) {
-      const addAction = await select({
+      const addAction = await getPrompt().select({
         message: `${emoji.donut} Add another repository?`,
         choices: [
-          { name: "No, done adding repositories", value: "done" },
-          { name: "Browse filesystem", value: "browse" },
-          { name: "Type path manually", value: "manual" }
+          { label: "No, done adding repositories", value: "done" },
+          { label: "Browse filesystem", value: "browse" },
+          { label: "Type path manually", value: "manual" }
         ]
       });
       if (addAction === "done") {
@@ -470,7 +511,7 @@ Configuring: ${firstRepo.name}`);
           }
         }
       } else {
-        const additionalPath = await input({
+        const additionalPath = await getPrompt().input({
           message: "Repository path:"
         });
         if (additionalPath.trim() === "") {
@@ -489,7 +530,7 @@ Configuring: ${firstRepo.name}`);
         }
       }
     }
-    description = await input({
+    description = await getPrompt().input({
       message: "Description (optional):",
       default: options.description?.trim()
     });
@@ -534,6 +575,8 @@ Configuring: ${firstRepo.name}`);
 }
 
 export {
+  PromptCancelledError,
+  escapableSelect,
   addCheckScriptToRepository,
   projectAddCommand
 };