ralphctl 0.4.1 → 0.4.3

package/dist/{chunk-NUYQK5MN.mjs → chunk-LDSG7G2T.mjs}

@@ -8,7 +8,7 @@ import {
   readValidatedJson,
   validateProjectPath,
   writeValidatedJson
-} from "./chunk-CTP2A436.mjs";
+} from "./chunk-D2HWXEHH.mjs";
 import {
   ParseError,
   ProjectExistsError,

package/dist/{chunk-7JLZQICD.mjs → chunk-MDE6KPJQ.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-EGUFQNRB.mjs";
 import {
   EXIT_ERROR,
   exitWithCode
@@ -14,9 +11,12 @@ import {
 import {
   getPrompt
 } from "./chunk-747KW2RW.mjs";
+import {
+  getProjectById
+} from "./chunk-LDSG7G2T.mjs";
 import {
   getCurrentSprintOrThrow
-} from "./chunk-YCDUVPRT.mjs";
+} from "./chunk-RQGD5WS6.mjs";
 import {
   createSpinner,
   emoji,
@@ -29,7 +29,7 @@ import {
   showError,
   showSuccess,
   showWarning
-} from "./chunk-FKMKOWLA.mjs";
+} from "./chunk-WZTY77GY.mjs";
 import {
   ensureError,
   wrapAsync

package/dist/{chunk-3QBEBKMZ.mjs → chunk-Q4AVHUZL.mjs}

@@ -1,7 +1,4 @@
 #!/usr/bin/env node
-import {
-  listProjects
-} from "./chunk-NUYQK5MN.mjs";
 import {
   EXIT_ERROR,
   exitWithCode
@@ -10,19 +7,22 @@ import {
   getPrompt
 } from "./chunk-747KW2RW.mjs";
 import {
-  createSprint,
-  setCurrentSprint
-} from "./chunk-YCDUVPRT.mjs";
+  listProjects
+} from "./chunk-LDSG7G2T.mjs";
+import {
+  createSprint
+} from "./chunk-RQGD5WS6.mjs";
 import {
   emoji,
   field,
   formatSprintStatus,
   icons,
+  setCurrentSprint,
   showError,
   showNextStep,
   showRandomQuote,
   showSuccess
-} from "./chunk-FKMKOWLA.mjs";
+} from "./chunk-WZTY77GY.mjs";
 
 // src/integration/cli/commands/sprint/create.ts
 async function sprintCreateCommand(options = {}) {

package/dist/{chunk-YCDUVPRT.mjs → chunk-RQGD5WS6.mjs}

@@ -1,12 +1,9 @@
 #!/usr/bin/env node
 import {
+  getCurrentSprint,
   log
-} from "./chunk-FKMKOWLA.mjs";
-import {
-  unwrapOrThrow
-} from "./chunk-IWXBJD2D.mjs";
+} from "./chunk-WZTY77GY.mjs";
 import {
-  ConfigSchema,
   SprintSchema,
   TasksSchema,
   appendToFile,
@@ -14,7 +11,6 @@ import {
   ensureDir,
   fileExists,
   generateSprintId,
-  getConfigPath,
   getProgressFilePath,
   getSprintDir,
   getSprintFilePath,
@@ -25,7 +21,7 @@ import {
   readValidatedJson,
   removeDir,
   writeValidatedJson
-} from "./chunk-CTP2A436.mjs";
+} from "./chunk-D2HWXEHH.mjs";
 import {
   LockError,
   NoCurrentSprintError,
@@ -34,60 +30,6 @@ import {
   StorageError
 } from "./chunk-57UWLHRH.mjs";
 
-// 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);
-}
-
 // src/integration/persistence/progress.ts
 import { execSync } from "child_process";
 
@@ -267,7 +209,7 @@ async function getProgress(sprintId) {
   const id = await resolveSprintId(sprintId);
   const result = await readTextFile(getProgressFilePath(id));
   if (!result.ok) {
-    if (result.error instanceof StorageError && result.error.cause?.code === "ENOENT") {
+    if (result.error instanceof StorageError && result.error.cause && "code" in result.error.cause && result.error.cause.code === "ENOENT") {
       return "";
     }
     throw result.error;
@@ -481,16 +423,6 @@ async function resolveSprintId(sprintId) {
 }
 
 export {
-  getConfig,
-  saveConfig,
-  getCurrentSprint,
-  setCurrentSprint,
-  getAiProvider,
-  setAiProvider,
-  getEditor,
-  setEditor,
-  getEvaluationIterations,
-  setEvaluationIterations,
   withFileLock,
   logProgress,
   getProgress,

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

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 import {
-  createProject
-} from "./chunk-NUYQK5MN.mjs";
+  ProviderAiSessionAdapter,
+  SignalParser,
+  buildCheckScriptDiscoverPrompt
+} from "./chunk-2FT37OZX.mjs";
 import {
   EXIT_ERROR,
   exitWithCode
@@ -9,11 +11,15 @@ import {
 import {
   getPrompt
 } from "./chunk-747KW2RW.mjs";
+import {
+  createProject
+} from "./chunk-LDSG7G2T.mjs";
 import {
   createSpinner,
   emoji,
   error,
   field,
+  getConfig,
   log,
   muted,
   showError,
@@ -21,7 +27,7 @@ import {
   showSuccess,
   showTip,
   showWarning
-} from "./chunk-FKMKOWLA.mjs";
+} from "./chunk-WZTY77GY.mjs";
 import {
   ensureError,
   wrapAsync
@@ -29,16 +35,17 @@ import {
 import {
   expandTilde,
   validateProjectPath
-} from "./chunk-CTP2A436.mjs";
+} from "./chunk-D2HWXEHH.mjs";
 import {
   IOError,
-  ProjectExistsError
+  ProjectExistsError,
+  ValidationError
 } from "./chunk-57UWLHRH.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
 };