ralphctl 0.4.2 → 0.4.3

package/dist/{chunk-GL7MKLLS.mjs → chunk-WOMGKKZY.mjs}

@@ -2,27 +2,18 @@
 import {
   PromptCancelledError,
   addCheckScriptToRepository,
-  escapableSelect
-} from "./chunk-D2YGPLIV.mjs";
+  escapableSelect,
+  getAllConfigSchemaEntries,
+  getConfigDefaultValue,
+  parseConfigValue
+} from "./chunk-TDBEEHTS.mjs";
 import {
   editorInput
-} from "./chunk-7JLZQICD.mjs";
+} from "./chunk-MDE6KPJQ.mjs";
 import {
-  addProjectRepo,
-  getProject,
-  getProjectById,
-  getRepoById,
-  listProjects,
-  removeProject,
-  removeProjectRepo,
-  resolveRepoPath
-} from "./chunk-NUYQK5MN.mjs";
-import {
-  SignalParser,
   addTask,
   areAllTasksDone,
   branchExists,
-  buildTicketRefinePrompt,
   createIdeatePipeline,
   createPlanPipeline,
   createRefinePipeline,
@@ -40,19 +31,23 @@ import {
   isGlabAvailable,
   listTasks,
   parseRequirementsFile,
-  processLifecycleAdapter,
-  providerDisplayName,
   removeTask,
   renderParsedTasksTable,
   reorderByDependencies,
   reorderTask,
-  resolveProvider,
   runAiSession,
   saveTasks,
   updateTask,
   updateTaskStatus,
   validateImportTasks
-} from "./chunk-TKPTT2UG.mjs";
+} from "./chunk-LCY32RW4.mjs";
+import {
+  SignalParser,
+  buildTicketRefinePrompt,
+  processLifecycleAdapter,
+  providerDisplayName,
+  resolveProvider
+} from "./chunk-2FT37OZX.mjs";
 import {
   fetchIssueFromUrl,
   formatIssueContext,
@@ -63,7 +58,7 @@ import {
   removeTicket,
   truncate,
   updateTicket
-} from "./chunk-JOQO4HMM.mjs";
+} from "./chunk-EGUFQNRB.mjs";
 import {
   EXIT_ERROR,
   exitWithCode
@@ -72,33 +67,33 @@ import {
   getPrompt,
   getSharedDeps
 } from "./chunk-747KW2RW.mjs";
+import {
+  addProjectRepo,
+  getProject,
+  getProjectById,
+  getRepoById,
+  listProjects,
+  removeProject,
+  removeProjectRepo,
+  resolveRepoPath
+} from "./chunk-LDSG7G2T.mjs";
 import {
   activateSprint,
   assertSprintStatus,
   closeSprint,
   createSprint,
   deleteSprint,
-  getAiProvider,
-  getConfig,
-  getCurrentSprint,
   getCurrentSprintOrThrow,
-  getEditor,
-  getEvaluationIterations,
   getProgress,
   getSprint,
   listSprints,
   logProgress,
   logSprintBaselines,
   resolveSprintId,
-  saveConfig,
   saveSprint,
-  setAiProvider,
-  setCurrentSprint,
-  setEditor,
-  setEvaluationIterations,
   summarizeProgressForContext,
   withFileLock
-} from "./chunk-YCDUVPRT.mjs";
+} from "./chunk-RQGD5WS6.mjs";
 import {
   DETAIL_LABEL_WIDTH,
   badge,
@@ -111,6 +106,11 @@ import {
   fieldMultiline,
   formatSprintStatus,
   formatTaskStatus,
+  getAiProvider,
+  getConfig,
+  getCurrentSprint,
+  getEditor,
+  getEvaluationIterations,
   getQuoteForContext,
   horizontalLine,
   icons,
@@ -123,6 +123,11 @@ import {
   progressBar,
   renderCard,
   renderTable,
+  saveConfig,
+  setAiProvider,
+  setCurrentSprint,
+  setEditor,
+  setEvaluationIterations,
   showEmpty,
   showError,
   showNextStep,
@@ -133,13 +138,14 @@ import {
   showWarning,
   success,
   terminalBell
-} from "./chunk-FKMKOWLA.mjs";
+} from "./chunk-WZTY77GY.mjs";
 import {
   ensureError,
   unwrapOrThrow,
   wrapAsync
 } from "./chunk-IWXBJD2D.mjs";
 import {
+  CURRENT_ONBOARDING_VERSION,
   ImportTasksSchema,
   RequirementStatusSchema,
   SprintSchema,
@@ -162,7 +168,7 @@ import {
   getTasksFilePath,
   readValidatedJson,
   validateProjectPath
-} from "./chunk-CTP2A436.mjs";
+} from "./chunk-D2HWXEHH.mjs";
 import {
   NoCurrentSprintError,
   ProjectNotFoundError,
@@ -170,14 +176,13 @@ import {
   SprintStatusError,
   StorageError,
   TaskNotFoundError,
-  TicketNotFoundError,
-  ValidationError
+  TicketNotFoundError
 } from "./chunk-57UWLHRH.mjs";
 
 // package.json
 var package_default = {
   name: "ralphctl",
-  version: "0.4.2",
+  version: "0.4.3",
   description: "Agent harness for long-running AI coding tasks \u2014 orchestrates Claude Code & GitHub Copilot across repositories",
   homepage: "https://github.com/lukas-grigis/ralphctl",
   type: "module",
@@ -245,8 +250,8 @@ var package_default = {
     "@types/node": "^25.6.0",
     "@types/react": "^19.2.14",
     "@types/tabtab": "^3.0.4",
-    "@vitest/coverage-v8": "^4.1.4",
-    eslint: "^10.2.0",
+    "@vitest/coverage-v8": "^4.1.5",
+    eslint: "^10.2.1",
     "eslint-config-prettier": "^10.1.8",
     globals: "^17.5.0",
     husky: "^9.1.7",
@@ -256,11 +261,11 @@ var package_default = {
     tsup: "^8.5.1",
     tsx: "^4.21.0",
     typescript: "^5.9.3",
-    "typescript-eslint": "^8.58.2",
-    vitest: "^4.1.4"
+    "typescript-eslint": "^8.59.0",
+    vitest: "^4.1.5"
   },
   "lint-staged": {
-    "*.ts": [
+    "*.{ts,tsx}": [
       "eslint --cache --fix",
       "prettier --write"
     ],
@@ -1897,7 +1902,7 @@ async function selectProject(message = "Select project:") {
       default: true
     });
     if (create) {
-      const { projectAddCommand } = await import("./add-GX7P7XTT.mjs");
+      const { projectAddCommand } = await import("./add-ZZYL4BSF.mjs");
       await projectAddCommand({ interactive: true });
       const updated = await listProjects();
       if (updated.length === 0) return null;
@@ -1932,7 +1937,7 @@ async function selectSprint(message = "Select sprint:", filter) {
       default: true
     });
     if (create) {
-      const { sprintCreateCommand } = await import("./create-7WFSCMP4.mjs");
+      const { sprintCreateCommand } = await import("./create-PQK6KKRD.mjs");
       await sprintCreateCommand({ interactive: true });
       const updated = await listSprints();
       const refiltered = filter ? updated.filter((s) => filter.includes(s.status)) : updated;
@@ -1967,7 +1972,7 @@ async function selectTicket(message = "Select ticket:", filter) {
         default: true
       });
       if (create) {
-        const { ticketAddCommand } = await import("./add-CIM72NE3.mjs");
+        const { ticketAddCommand } = await import("./add-MG26JWBP.mjs");
         await ticketAddCommand({ interactive: true });
         const updated = await listTickets();
         const refiltered = filter ? updated.filter(filter) : updated;
@@ -4615,136 +4620,6 @@ async function progressShowCommand() {
   console.log(content);
 }
 
-// src/integration/config/schema-provider.ts
-import { Result as Result6 } 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"
-  }
-  // 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 Result6.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 Result6.error(new ValidationError(errorMsg, key));
-  }
-  return Result6.ok(value);
-}
-function parseConfigValue(key, stringValue) {
-  if (!(key in ConfigSchemaDefinition)) {
-    return Result6.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 Result6.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 Result6.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 Result6.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 Result6.error(
-      new ValidationError(`Failed to parse ${key}: ${err instanceof Error ? err.message : String(err)}`, key)
-    );
-  }
-  return validateConfigValue(key, parsedValue);
-}
-
 // src/integration/cli/commands/config/config.ts
 var KEY_ALIASES = {
   provider: "aiProvider"
@@ -4820,7 +4695,7 @@ async function configShowCommand() {
 }
 
 // src/integration/cli/commands/doctor/doctor.ts
-import { access as access2, constants } from "fs/promises";
+import { access as access2, constants, readFile as readFile4 } from "fs/promises";
 import { join as join5 } from "path";
 import { spawnSync as spawnSync2 } from "child_process";
 var REQUIRED_NODE_MAJOR = 24;
@@ -4935,6 +4810,90 @@ async function checkProjectPaths() {
   }
   return { name: "Project paths", status: "fail", detail: issues.join("; ") };
 }
+function providerInstructionsRelPath(provider) {
+  if (provider === "claude") return "CLAUDE.md";
+  return ".github/copilot-instructions.md";
+}
+async function checkRepoOnboarding() {
+  const projects = await listProjects();
+  const config = await getConfig();
+  const provider = config.aiProvider;
+  const results = [];
+  for (const project of projects) {
+    for (const repo of project.repositories) {
+      const name = `Onboarding \u2014 ${project.name}/${repo.name}`;
+      if (!provider) {
+        results.push({
+          name,
+          status: "skip",
+          detail: "configure an AI provider to use onboarding"
+        });
+        continue;
+      }
+      const relPath = providerInstructionsRelPath(provider);
+      const instructionsPath = join5(repo.path, relPath);
+      const hasInstructions = await fileExists(instructionsPath);
+      const ver = repo.onboardingVersion;
+      if (ver == null) {
+        if (hasInstructions) {
+          results.push({
+            name,
+            status: "pass",
+            detail: `authored ${relPath} (not harness-managed)`
+          });
+        } else {
+          results.push({
+            name,
+            status: "skip",
+            detail: `never onboarded \u2014 run \`ralphctl project onboard ${project.name} --repo ${repo.name}\``
+          });
+        }
+        continue;
+      }
+      if (!hasInstructions) {
+        results.push({
+          name,
+          status: "warn",
+          detail: `onboardingVersion set but ${relPath} missing \u2014 re-run \`ralphctl project onboard\``
+        });
+        continue;
+      }
+      if (ver < CURRENT_ONBOARDING_VERSION) {
+        results.push({
+          name,
+          status: "warn",
+          detail: `onboarding v${String(ver)} < v${String(CURRENT_ONBOARDING_VERSION)} \u2014 re-run to refresh`
+        });
+        continue;
+      }
+      if (ver > CURRENT_ONBOARDING_VERSION) {
+        results.push({
+          name,
+          status: "warn",
+          detail: `onboarding v${String(ver)} > v${String(CURRENT_ONBOARDING_VERSION)} \u2014 repo onboarded by a newer ralphctl version \u2014 upgrade the CLI to manage it cleanly`
+        });
+        continue;
+      }
+      let body;
+      try {
+        body = await readFile4(instructionsPath, "utf-8");
+      } catch {
+        results.push({ name, status: "warn", detail: `${relPath} unreadable \u2014 re-run \`ralphctl project onboard\`` });
+        continue;
+      }
+      if (body.includes("LOW-CONFIDENCE:")) {
+        results.push({
+          name,
+          status: "warn",
+          detail: "low-confidence sections detected \u2014 re-run interactively to review"
+        });
+        continue;
+      }
+      results.push({ name, status: "pass", detail: `onboarding v${String(ver)}` });
+    }
+  }
+  return results;
+}
 async function checkEvaluationConfig() {
   const config = await getConfig();
   if (config.evaluationIterations == null) {
@@ -4950,6 +4909,17 @@ async function checkEvaluationConfig() {
     detail: `evaluationIterations: ${String(config.evaluationIterations)}`
   };
 }
+async function checkAiCheckScriptDiscovery() {
+  const config = await getConfig();
+  if (config.aiCheckScriptDiscovery === false) {
+    return {
+      name: "AI check-script discovery",
+      status: "warn",
+      detail: "disabled \u2014 `project add` will skip the AI fallback for unrecognized ecosystems (re-enable: ralphctl config set aiCheckScriptDiscovery true)"
+    };
+  }
+  return null;
+}
 async function checkConfigSchemaValidation() {
   const config = await getConfig();
   const entries = getAllConfigSchemaEntries();
@@ -4999,9 +4969,14 @@ async function doctorCommand() {
     checkProjectPaths(),
     checkCurrentSprint(),
     checkEvaluationConfig(),
+    checkAiCheckScriptDiscovery(),
     checkConfigSchemaValidation()
   ]);
-  results.push(...asyncResults);
+  for (const r of asyncResults) {
+    if (r !== null) results.push(r);
+  }
+  const onboardingResults = await checkRepoOnboarding();
+  results.push(...onboardingResults);
   for (const result of results) {
     if (result.status === "pass") {
       log.success(`${result.name}${result.detail ? colors.muted(` \u2014 ${result.detail}`) : ""}`);
@@ -5225,9 +5200,6 @@ export {
   loadDashboardData,
   getNextAction,
   showDashboard,
-  getAllSchemaEntries,
-  validateConfigValue,
-  parseConfigValue,
   configSetCommand,
   configShowCommand,
   checkNodeVersion,
@@ -5237,6 +5209,7 @@ export {
   checkGlabInstalled,
   checkDataDirectory,
   checkProjectPaths,
+  checkRepoOnboarding,
   checkEvaluationConfig,
   checkConfigSchemaValidation,
   checkCurrentSprint,

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

@@ -1,4 +1,14 @@
 #!/usr/bin/env node
+import {
+  unwrapOrThrow
+} from "./chunk-IWXBJD2D.mjs";
+import {
+  ConfigSchema,
+  fileExists,
+  getConfigPath,
+  readValidatedJson,
+  writeValidatedJson
+} from "./chunk-D2HWXEHH.mjs";
 
 // src/integration/ui/theme/theme.ts
 import { bold, cyan, gray, green, red, yellow } from "colorette";
@@ -467,6 +477,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,
@@ -504,5 +568,15 @@ export {
   horizontalLine,
   renderCard,
   progressBar,
-  renderTable
+  renderTable,
+  getConfig,
+  saveConfig,
+  getCurrentSprint,
+  setCurrentSprint,
+  getAiProvider,
+  setAiProvider,
+  getEditor,
+  setEditor,
+  getEvaluationIterations,
+  setEvaluationIterations
 };