ralphctl 0.4.2 → 0.4.4

package/dist/{chunk-7JLZQICD.mjs → chunk-OGEXYSFS.mjs}

@@ -1,12 +1,9 @@
 #!/usr/bin/env node
-import {
-  getProjectById
-} from "./chunk-NUYQK5MN.mjs";
 import {
   addTicket,
   fetchIssueFromUrl,
   truncate
-} from "./chunk-JOQO4HMM.mjs";
+} from "./chunk-GQ2WFKBN.mjs";
 import {
   EXIT_ERROR,
   exitWithCode
@@ -14,9 +11,12 @@ import {
 import {
   getPrompt
 } from "./chunk-747KW2RW.mjs";
+import {
+  getProjectById
+} from "./chunk-BSB4EDGR.mjs";
 import {
   getCurrentSprintOrThrow
-} from "./chunk-YCDUVPRT.mjs";
+} from "./chunk-CBMFRQ4Y.mjs";
 import {
   createSpinner,
   emoji,
@@ -29,7 +29,7 @@ import {
   showError,
   showSuccess,
   showWarning
-} from "./chunk-FKMKOWLA.mjs";
+} from "./chunk-XN2UIHBY.mjs";
 import {
   ensureError,
   wrapAsync
@@ -37,7 +37,7 @@ import {
 import {
   IOError,
   SprintStatusError
-} from "./chunk-57UWLHRH.mjs";
+} from "./chunk-VAZ3LJBI.mjs";
 
 // src/integration/cli/commands/ticket/add.ts
 import { Result as Result2 } from "typescript-result";

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

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 import {
-  createProject
-} from "./chunk-NUYQK5MN.mjs";
+  ProviderAiSessionAdapter,
+  SignalParser,
+  buildCheckScriptDiscoverPrompt
+} from "./chunk-ZLWSPLWI.mjs";
 import {
   EXIT_ERROR,
   exitWithCode
@@ -9,11 +11,15 @@ import {
 import {
   getPrompt
 } from "./chunk-747KW2RW.mjs";
+import {
+  createProject
+} from "./chunk-BSB4EDGR.mjs";
 import {
   createSpinner,
   emoji,
   error,
   field,
+  getConfig,
   log,
   muted,
   showError,
@@ -21,7 +27,7 @@ import {
   showSuccess,
   showTip,
   showWarning
-} from "./chunk-FKMKOWLA.mjs";
+} from "./chunk-XN2UIHBY.mjs";
 import {
   ensureError,
   wrapAsync
@@ -29,16 +35,17 @@ import {
 import {
   expandTilde,
   validateProjectPath
-} from "./chunk-CTP2A436.mjs";
+} from "./chunk-WDMLPXOD.mjs";
 import {
   IOError,
-  ProjectExistsError
-} from "./chunk-57UWLHRH.mjs";
+  ProjectExistsError,
+  ValidationError
+} from "./chunk-VAZ3LJBI.mjs";
 
 // 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 { Result as Result3 } from "typescript-result";
+import { Result as Result4 } from "typescript-result";
 
 // src/integration/ui/prompts/file-browser-impl.ts
 import { readdirSync, statSync } from "fs";
@@ -328,13 +335,173 @@ function suggestCheckScript(projectPath) {
   return parts.length > 0 ? parts.join(" && ") : null;
 }
 
+// src/integration/ai/discover-check-script.ts
+var DISCOVERY_TIMEOUT_MS = 3e4;
+async function discoverCheckScriptWithAi(repoPath, aiSession, signalParser) {
+  const prompt = buildCheckScriptDiscoverPrompt(repoPath);
+  const session = aiSession.spawnHeadless(prompt, { cwd: repoPath });
+  const timeout = new Promise((resolve3) => {
+    setTimeout(() => {
+      resolve3(null);
+    }, DISCOVERY_TIMEOUT_MS).unref();
+  });
+  try {
+    const result = await Promise.race([session, timeout]);
+    if (!result) return null;
+    const signals = signalParser.parseSignals(result.output);
+    const discovery = signals.find((s) => s.type === "check-script-discovery");
+    return discovery ? discovery.command : null;
+  } catch {
+    return null;
+  }
+}
+
+// src/integration/config/schema-provider.ts
+import { Result as Result3 } from "typescript-result";
+
+// src/domain/config-schema.ts
+var ConfigSchemaDefinition = {
+  currentSprint: {
+    key: "currentSprint",
+    label: "Current Sprint",
+    type: "string",
+    default: null,
+    description: "Currently active sprint ID (set by `sprint start`, cleared on `sprint close`)",
+    validation: (val) => val === null || typeof val === "string" && val.length > 0,
+    scope: "global"
+  },
+  aiProvider: {
+    key: "aiProvider",
+    label: "AI Provider",
+    type: "enum",
+    enum: ["claude", "copilot"],
+    default: null,
+    description: "AI provider for task execution (Claude Code or GitHub Copilot CLI)",
+    validation: (val) => val === null || typeof val === "string" && ["claude", "copilot"].includes(val),
+    scope: "global"
+  },
+  evaluationIterations: {
+    key: "evaluationIterations",
+    label: "Evaluation Iterations",
+    type: "integer",
+    min: 0,
+    max: 10,
+    default: 1,
+    description: "Number of fix-attempt iterations after initial evaluation; 0 = disabled. Higher values allow more refinement rounds.",
+    validation: (val) => typeof val === "number" && Number.isInteger(val) && val >= 0 && val <= 10,
+    scope: "sprint"
+  },
+  aiCheckScriptDiscovery: {
+    key: "aiCheckScriptDiscovery",
+    label: "AI Check-Script Discovery",
+    type: "boolean",
+    default: false,
+    description: "When static ecosystem detection cannot suggest a check script during `project add`, ask the configured AI provider to inspect the repo and propose one. User approval is always required before saving. Disabled by default \u2014 enable with `ralphctl config set aiCheckScriptDiscovery true`.",
+    validation: (val) => typeof val === "boolean",
+    scope: "user"
+  }
+  // Phase 2+ additions can be added here as single schema entries
+  // maxTaskTurns: { ... },
+  // checkScriptTimeout: { ... },
+};
+function getSchemaEntry(key) {
+  return ConfigSchemaDefinition[key];
+}
+function getAllSchemaEntries() {
+  return Object.values(ConfigSchemaDefinition);
+}
+function getDefaultValue(key) {
+  return ConfigSchemaDefinition[key].default;
+}
+
+// src/integration/config/schema-provider.ts
+function getAllConfigSchemaEntries() {
+  return getAllSchemaEntries();
+}
+function getConfigSchemaEntry(key) {
+  return getSchemaEntry(key);
+}
+function getConfigDefaultValue(key) {
+  return getDefaultValue(key);
+}
+function validateConfigValue(key, value) {
+  if (!(key in ConfigSchemaDefinition)) {
+    return Result3.error(new ValidationError(`Unknown config key: ${key}`, key));
+  }
+  const schemaKey = key;
+  const entry = getConfigSchemaEntry(schemaKey);
+  if (!entry.validation(value)) {
+    let errorMsg = `Invalid value for ${key}`;
+    if (entry.type === "enum" && entry.enum) {
+      errorMsg += `: must be one of ${entry.enum.join(", ")}`;
+    } else if (entry.type === "integer" || entry.type === "number") {
+      const constraints = [];
+      if (entry.min !== void 0) constraints.push(`min: ${String(entry.min)}`);
+      if (entry.max !== void 0) constraints.push(`max: ${String(entry.max)}`);
+      if (constraints.length > 0) errorMsg += ` (${constraints.join(", ")})`;
+    }
+    return Result3.error(new ValidationError(errorMsg, key));
+  }
+  return Result3.ok(value);
+}
+function parseConfigValue(key, stringValue) {
+  if (!(key in ConfigSchemaDefinition)) {
+    return Result3.error(new ValidationError(`Unknown config key: ${key}`, key));
+  }
+  const schemaKey = key;
+  const entry = getConfigSchemaEntry(schemaKey);
+  let parsedValue;
+  try {
+    switch (entry.type) {
+      case "string":
+        parsedValue = stringValue === "null" ? null : stringValue;
+        break;
+      case "integer":
+        parsedValue = stringValue === "null" ? null : Number.parseInt(stringValue, 10);
+        if (Number.isNaN(parsedValue)) {
+          return Result3.error(new ValidationError(`Expected integer for ${key}, got ${stringValue}`, key));
+        }
+        break;
+      case "number":
+        parsedValue = stringValue === "null" ? null : Number.parseFloat(stringValue);
+        if (Number.isNaN(parsedValue)) {
+          return Result3.error(new ValidationError(`Expected number for ${key}, got ${stringValue}`, key));
+        }
+        break;
+      case "boolean":
+        if (stringValue.toLowerCase() === "true" || stringValue === "1") {
+          parsedValue = true;
+        } else if (stringValue.toLowerCase() === "false" || stringValue === "0") {
+          parsedValue = false;
+        } else if (stringValue === "null") {
+          parsedValue = null;
+        } else {
+          return Result3.error(new ValidationError(`Expected boolean for ${key}, got ${stringValue}`, key));
+        }
+        break;
+      case "enum":
+        if (stringValue === "null") {
+          parsedValue = null;
+        } else {
+          parsedValue = stringValue;
+        }
+        break;
+    }
+  } catch (err) {
+    return Result3.error(
+      new ValidationError(`Failed to parse ${key}: ${err instanceof Error ? err.message : String(err)}`, key)
+    );
+  }
+  return validateConfigValue(key, parsedValue);
+}
+
 // src/integration/cli/commands/project/add.ts
 function validateSlug(slug) {
   return /^[a-z0-9-]+$/.test(slug);
 }
 function isGitRepo2(path) {
   const gitDir = join3(path, ".git");
-  const r = Result3.try(() => existsSync2(gitDir) && statSync2(gitDir).isDirectory());
+  const r = Result4.try(() => existsSync2(gitDir) && statSync2(gitDir).isDirectory());
   return r.ok ? r.value : false;
 }
 function hasAiInstructions(repoPath) {
@@ -342,11 +509,12 @@ function hasAiInstructions(repoPath) {
 }
 async function addCheckScriptToRepository(repo) {
   let suggested = null;
-  const detectR = Result3.try(() => detectCheckScriptCandidates(repo.path));
+  const detectR = Result4.try(() => detectCheckScriptCandidates(repo.path));
   if (detectR.ok && detectR.value) {
     log.success(`  Detected: ${detectR.value.typeLabel}`);
     suggested = suggestCheckScript(repo.path);
   }
+  suggested ??= await tryAiCheckScriptDiscovery(repo.path);
   const checkInput = await getPrompt().input({
     message: "  Check script (optional):",
     default: suggested ?? void 0
@@ -357,6 +525,35 @@ async function addCheckScriptToRepository(repo) {
     checkScript
   };
 }
+async function tryAiCheckScriptDiscovery(repoPath) {
+  const config = await getConfig();
+  const enabled = config.aiCheckScriptDiscovery ?? getConfigDefaultValue("aiCheckScriptDiscovery");
+  if (!enabled) return null;
+  if (!config.aiProvider) return null;
+  const wantAi = await getPrompt().confirm({
+    message: "  No ecosystem detected. Ask AI to inspect the repo and suggest a check script?",
+    default: true
+  });
+  if (!wantAi) return null;
+  const spinner = createSpinner("  Asking AI to discover check script...").start();
+  const aiSession = new ProviderAiSessionAdapter();
+  const signalParser = new SignalParser();
+  const discoverR = await wrapAsync(async () => {
+    await aiSession.ensureReady();
+    return discoverCheckScriptWithAi(repoPath, aiSession, signalParser);
+  }, ensureError);
+  if (!discoverR.ok) {
+    spinner.fail("AI discovery unavailable");
+    return null;
+  }
+  const suggestion = discoverR.value;
+  if (suggestion) {
+    spinner.succeed("AI suggestion ready (review before saving)");
+  } else {
+    spinner.fail("AI returned no suggestion");
+  }
+  return suggestion;
+}
 async function projectAddCommand(options = {}) {
   let name;
   let displayName;
@@ -577,6 +774,14 @@ Configuring: ${firstRepo.name ?? basename(firstRepo.path)}`);
 export {
   PromptCancelledError,
   escapableSelect,
+  detectCheckScriptCandidates,
+  suggestCheckScript,
+  discoverCheckScriptWithAi,
+  getAllSchemaEntries,
+  getAllConfigSchemaEntries,
+  getConfigDefaultValue,
+  validateConfigValue,
+  parseConfigValue,
   addCheckScriptToRepository,
   projectAddCommand
 };

package/dist/{chunk-57UWLHRH.mjs → chunk-VAZ3LJBI.mjs}

@@ -145,6 +145,16 @@ var BranchPreflightError = class extends DomainError {
     this.expectedBranch = expectedBranch;
   }
 };
+var ExecutionAlreadyRunningError = class extends DomainError {
+  code = "EXECUTION_ALREADY_RUNNING";
+  projectName;
+  existingExecutionId;
+  constructor(projectName, existingExecutionId) {
+    super(`An execution is already running for project '${projectName}' (id: ${existingExecutionId}).`);
+    this.projectName = projectName;
+    this.existingExecutionId = existingExecutionId;
+  }
+};
 
 export {
   DomainError,
@@ -164,5 +174,6 @@ export {
   DependencyCycleError,
   IssueFetchError,
   StepError,
-  BranchPreflightError
+  BranchPreflightError,
+  ExecutionAlreadyRunningError
 };

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

@@ -3,7 +3,7 @@ import {
   IOError,
   StorageError,
   ValidationError
-} from "./chunk-57UWLHRH.mjs";
+} from "./chunk-VAZ3LJBI.mjs";
 
 // src/integration/persistence/paths.ts
 import { isAbsolute, join, resolve, sep } from "path";
@@ -191,10 +191,11 @@ async function readTextFile(filePath) {
 // src/domain/models.ts
 import { z } from "zod";
 var SprintStatusSchema = z.enum(["draft", "active", "closed"]);
-var TaskStatusSchema = z.enum(["todo", "in_progress", "done"]);
+var TaskStatusSchema = z.enum(["todo", "in_progress", "done", "cancelled"]);
 var RequirementStatusSchema = z.enum(["pending", "approved"]);
 var EvaluationStatusSchema = z.enum(["passed", "failed", "malformed", "plateau"]);
 var IdSchema = z.string().min(1);
+var CURRENT_ONBOARDING_VERSION = 1;
 var RepositorySchema = z.object({
   id: IdSchema,
   // UUID8, stable across renames
@@ -204,8 +205,12 @@ var RepositorySchema = z.object({
   // Absolute path
   checkScript: z.string().optional(),
   // e.g., "pnpm install && pnpm typecheck && pnpm lint && pnpm test"
-  checkTimeout: z.number().positive().optional()
+  checkTimeout: z.number().positive().optional(),
   // Per-repo timeout in ms (overrides RALPHCTL_SETUP_TIMEOUT_MS)
+  // Stamped by `project onboard` on success. Absence means the repo was never
+  // onboarded; `doctor` surfaces a hint. A value < CURRENT_ONBOARDING_VERSION
+  // means the contract has drifted and re-onboarding is recommended.
+  onboardingVersion: z.number().int().nonnegative().optional()
 });
 var ProjectSchema = z.object({
   id: IdSchema,
@@ -290,7 +295,8 @@ var ConfigSchema = z.object({
   currentSprint: z.string().nullable().default(null),
   aiProvider: AiProviderSchema.nullable().default(null),
   editor: z.string().nullable().default(null),
-  evaluationIterations: z.number().int().min(0).optional()
+  evaluationIterations: z.number().int().min(0).optional(),
+  aiCheckScriptDiscovery: z.boolean().optional()
 });
 function getRequirementsOutputJsonSchema() {
   return JSON.stringify(z.toJSONSchema(RefinedRequirementsSchema), null, 2);
@@ -342,6 +348,7 @@ export {
   SprintStatusSchema,
   TaskStatusSchema,
   RequirementStatusSchema,
+  CURRENT_ONBOARDING_VERSION,
   ProjectsSchema,
   TasksSchema,
   ImportTasksSchema,

package/dist/{chunk-FKMKOWLA.mjs → chunk-XN2UIHBY.mjs}

@@ -1,4 +1,14 @@
 #!/usr/bin/env node
+import {
+  unwrapOrThrow
+} from "./chunk-IWXBJD2D.mjs";
+import {
+  ConfigSchema,
+  fileExists,
+  getConfigPath,
+  readValidatedJson,
+  writeValidatedJson
+} from "./chunk-WDMLPXOD.mjs";
 
 // src/integration/ui/theme/theme.ts
 import { bold, cyan, gray, green, red, yellow } from "colorette";
@@ -295,11 +305,17 @@ function labelValue(label, value, labelWidth = DETAIL_LABEL_WIDTH) {
 }
 function formatTaskStatus(status) {
   const e = getStatusEmoji(status);
-  const labels = { todo: "To Do", in_progress: "In Progress", done: "Done" };
+  const labels = {
+    todo: "To Do",
+    in_progress: "In Progress",
+    done: "Done",
+    cancelled: "Cancelled"
+  };
   const statusColors = {
     todo: colors.muted,
     in_progress: colors.warning,
-    done: colors.success
+    done: colors.success,
+    cancelled: colors.muted
   };
   return (statusColors[status] ?? colors.muted)(`${e} ${labels[status] ?? status}`);
 }
@@ -467,6 +483,60 @@ function renderTable(columns, rows, options = {}) {
   return result.join("\n");
 }
 
+// src/integration/persistence/config.ts
+var DEFAULT_EVALUATION_ITERATIONS = 1;
+var DEFAULT_CONFIG = {
+  currentSprint: null,
+  aiProvider: null,
+  editor: null
+};
+async function getConfig() {
+  const configPath = getConfigPath();
+  if (!await fileExists(configPath)) {
+    return DEFAULT_CONFIG;
+  }
+  return unwrapOrThrow(await readValidatedJson(configPath, ConfigSchema));
+}
+async function saveConfig(config) {
+  unwrapOrThrow(await writeValidatedJson(getConfigPath(), config, ConfigSchema));
+}
+async function getCurrentSprint() {
+  const config = await getConfig();
+  return config.currentSprint;
+}
+async function setCurrentSprint(sprintId) {
+  const config = await getConfig();
+  config.currentSprint = sprintId;
+  await saveConfig(config);
+}
+async function getAiProvider() {
+  const config = await getConfig();
+  return config.aiProvider ?? null;
+}
+async function setAiProvider(provider) {
+  const config = await getConfig();
+  config.aiProvider = provider;
+  await saveConfig(config);
+}
+async function getEditor() {
+  const config = await getConfig();
+  return config.editor ?? null;
+}
+async function setEditor(editor) {
+  const config = await getConfig();
+  config.editor = editor;
+  await saveConfig(config);
+}
+async function getEvaluationIterations() {
+  const config = await getConfig();
+  return config.evaluationIterations ?? DEFAULT_EVALUATION_ITERATIONS;
+}
+async function setEvaluationIterations(iterations) {
+  const config = await getConfig();
+  config.evaluationIterations = iterations;
+  await saveConfig(config);
+}
+
 export {
   emoji,
   colors,
@@ -491,6 +561,7 @@ export {
   showRandomQuote,
   printCountSummary,
   printBanner,
+  isTTY,
   terminalBell,
   createSpinner,
   field,
@@ -504,5 +575,15 @@ export {
   horizontalLine,
   renderCard,
   progressBar,
-  renderTable
+  renderTable,
+  getConfig,
+  saveConfig,
+  getCurrentSprint,
+  setCurrentSprint,
+  getAiProvider,
+  setAiProvider,
+  getEditor,
+  setEditor,
+  getEvaluationIterations,
+  setEvaluationIterations
 };