@neriros/ralphy 2.22.0 → 2.22.1

package/README.md

@@ -142,19 +142,19 @@ The cycle repeats every poll. For code-review-iteration in particular, `setDone`
 
 Linear is the source of truth for which issues Ralph has touched. The `linear.indicators` map declares how Ralph queries and mutates Linear at each lifecycle event. All keys are optional; an unset key means "Ralph doesn't perform that action".
 
-| Key               | Type                            | Purpose                                                                         |
-| ----------------- | ------------------------------- | ------------------------------------------------------------------------------- |
-| `getTodo`         | `{filter: Marker[]}`            | Issues to pick up (fresh)                                                       |
-| `getInProgress`   | `{filter: Marker[]}`            | Issues to resume after restart                                                  |
-| `getConflicted`   | `{filter: Marker[]}`            | Issues whose PR is conflicted (re-fix run)                                      |
-| `getReview`       | `{filter: Marker[]}`            | Done issues flagged for review follow-up                                        |
-| `getAutoMerge`    | `{filter: Marker[]}`            | Issues whose PR should be auto-merged once required checks pass                 |
-| `setInProgress`   | `Marker` or `{apply: Marker[]}` | Applied when a worker spawns (any non-resume mode)                              |
-| `setDone`         | `Marker` or `{apply: Marker[]}` | Applied on clean exit                                                           |
-| `setError`        | `Marker` or `{apply: Marker[]}` | Applied on non-zero exit (quarantine signal — issue is _not_ auto-resumed)      |
-| `setConflicted`   | `Marker` or `{apply: Marker[]}` | Applied when a done-PR is detected as conflicted                                |
-| `clearConflicted` | `Marker` or `{apply: Marker[]}` | Label(s) removed when a conflict-fix succeeds (status removal is not supported) |
-| `clearReview`     | `Marker` or `{apply: Marker[]}` | Label(s) removed when a review pickup happens (status removal is not supported) |
+| Key               | Type                   | Purpose                                                                         |
+| ----------------- | ---------------------- | ------------------------------------------------------------------------------- |
+| `getTodo`         | `{filter: Marker[]}`   | Issues to pick up (fresh)                                                       |
+| `getInProgress`   | `{filter: Marker[]}`   | Issues to resume after restart                                                  |
+| `getConflicted`   | `{filter: Marker[]}`   | Issues whose PR is conflicted (re-fix run)                                      |
+| `getReview`       | `{filter: Marker[]}`   | Done issues flagged for review follow-up                                        |
+| `getAutoMerge`    | `{filter: Marker[]}`   | Issues whose PR should be auto-merged once required checks pass                 |
+| `setInProgress`   | `Marker` or `Marker[]` | Applied when a worker spawns (any non-resume mode)                              |
+| `setDone`         | `Marker` or `Marker[]` | Applied on clean exit                                                           |
+| `setError`        | `Marker` or `Marker[]` | Applied on non-zero exit (quarantine signal — issue is _not_ auto-resumed)      |
+| `setConflicted`   | `Marker` or `Marker[]` | Applied when a done-PR is detected as conflicted                                |
+| `clearConflicted` | `Marker` or `Marker[]` | Label(s) removed when a conflict-fix succeeds (status removal is not supported) |
+| `clearReview`     | `Marker` or `Marker[]` | Label(s) removed when a review pickup happens (status removal is not supported) |
 
 A `Marker` is one of three types:
 
@@ -164,7 +164,7 @@ A `Marker` is one of three types:
 | `"status"`     | `"In Progress"`       | Updates the Linear workflow status of the issue                                                                                                                                                                                           |
 | `"attachment"` | `"In Progress"`       | Upserts a single **Ralphy** attachment on the issue; `value` becomes the subtitle. The same entry is reused across every lifecycle transition — Ralph creates it on first apply and edits it on subsequent ones, so the issue stays tidy. |
 
-Combine with `apply` when one event sets multiple — e.g. `setDone` flipping a status _and_ adding a label _and_ updating the attachment subtitle.
+Use an array when one event sets multiple — e.g. `setDone` flipping a status _and_ adding a label _and_ updating the attachment subtitle.
 
 Example `ralphy.config.json`:
 
@@ -200,12 +200,10 @@ Example `ralphy.config.json`:
         "filter": [{ "type": "label", "value": "ralph:auto-merge" }],
       },
       "setInProgress": { "type": "status", "value": "In Progress" },
-      "setDone": {
-        "apply": [
-          { "type": "status", "value": "In Review" },
-          { "type": "label", "value": "ralphy-done" },
-        ],
-      },
+      "setDone": [
+        { "type": "status", "value": "In Review" },
+        { "type": "label", "value": "ralphy-done" },
+      ],
       "setError": { "type": "label", "value": "ralph:error" },
       "setConflicted": { "type": "label", "value": "ralph:conflicted" },
       "clearConflicted": { "type": "label", "value": "ralph:conflicted" },

package/dist/cli/index.js

@@ -35029,8 +35029,8 @@ import { readFileSync as readFileSync2 } from "fs";
 import { resolve } from "path";
 function getVersion() {
   try {
-    if ("2.22.0")
-      return "2.22.0";
+    if ("2.22.1")
+      return "2.22.1";
   } catch {}
   const dirsToTry = [];
   try {
@@ -35095,13 +35095,7 @@ function mergeIndicator(bag, key, marker) {
     bag[key] = { filter: filter2 };
   } else {
     const existing = bag[key];
-    let next;
-    if (!existing)
-      next = marker;
-    else if ("apply" in existing)
-      next = { apply: [...existing.apply, marker] };
-    else
-      next = { apply: [existing, marker] };
+    const next = existing ? [...Array.isArray(existing) ? existing : [existing], marker] : marker;
     bag[key] = next;
   }
 }
@@ -39410,7 +39404,7 @@ var init_zod = __esm(() => {
 
 // packages/types/src/types.ts
 function markersOf(set2) {
-  return "apply" in set2 ? set2.apply : [set2];
+  return Array.isArray(set2) ? set2 : [set2];
 }
 var IterationUsageSchema, UsageSchema, HistoryEntrySchema, StateSchema, PhaseFrontmatterSchema;
 var init_types2 = __esm(() => {
@@ -59538,8 +59532,26 @@ async function loadRalphyConfig(projectRoot) {
     return RalphyConfigSchema.parse({});
   }
   const text = await file.text();
-  const raw = JSON.parse(stripJsonComments(text));
-  return RalphyConfigSchema.parse(raw);
+  let raw;
+  try {
+    raw = JSON.parse(stripJsonComments(text));
+  } catch (error) {
+    throw new Error(`ralphy.config.json is not valid JSON.
+` + `  File: ${path}
+` + `  ${error instanceof Error ? error.message : String(error)}
+
+` + `Run \`ralph init\` to see the full default config with all available settings.`);
+  }
+  const result2 = RalphyConfigSchema.safeParse(raw);
+  if (!result2.success) {
+    const issues = result2.error.issues.map((issue) => `  \u2022 ${issue.path.join(".") || "(root)"}: ${issue.message}`).join(`
+`);
+    throw new Error(`ralphy.config.json has invalid settings:
+${issues}
+
+` + `Run \`ralph init\` to see the full default config with all available settings.`);
+  }
+  return result2.data;
 }
 async function ensureRalphyConfig(projectRoot) {
   const path = join11(projectRoot, "ralphy.config.json");
@@ -59669,18 +59681,18 @@ var MarkerSchema, GetIndicatorSchema, SetIndicatorSchema, IndicatorsSchema, Ralp
       // after opening the PR so the PR merges as soon as required checks pass.
       // "getAutoMerge": { "filter": [{ "type": "label", "value": "ralph:auto-merge" }] },
 
-      // Applied when Ralph picks up an issue.
+      // Applied when Ralph picks up an issue. Single marker or array of markers.
       // "setInProgress": { "type": "label", "value": "ralph:in-progress" },
-      // \u2014 or use attachment type to stamp a single "Ralphy" entry on the issue:
       // "setInProgress": { "type": "attachment", "value": "In Progress" },
+      // "setInProgress": [{ "type": "status", "value": "In Progress" }, { "type": "attachment", "value": "In Progress" }],
 
       // Applied on clean success.
       // "setDone": { "type": "status", "value": "In Review" },
-      // "setDone": { "type": "attachment", "value": "Done" },
+      // "setDone": [{ "type": "status", "value": "In Review" }, { "type": "attachment", "value": "Done" }],
 
       // Applied when the task exits with an error (quarantine signal).
       // "setError": { "type": "label", "value": "ralph:error" },
-      // "setError": { "type": "attachment", "value": "Error" },
+      // "setError": [{ "type": "label", "value": "ralph:error" }, { "type": "attachment", "value": "Error" }],
 
       // Applied when a PR merge conflict is detected.
       // "setConflicted": { "type": "label", "value": "ralph:conflict" },
@@ -59703,10 +59715,7 @@ var init_config = __esm(() => {
   GetIndicatorSchema = exports_external.object({
     filter: exports_external.array(MarkerSchema).default([])
   });
-  SetIndicatorSchema = exports_external.union([
-    MarkerSchema,
-    exports_external.object({ apply: exports_external.array(MarkerSchema).min(1) })
-  ]);
+  SetIndicatorSchema = exports_external.union([exports_external.array(MarkerSchema).min(1), MarkerSchema]);
   IndicatorsSchema = exports_external.object({
     getTodo: GetIndicatorSchema.optional(),
     getInProgress: GetIndicatorSchema.optional(),
@@ -59724,7 +59733,7 @@ var init_config = __esm(() => {
       const clear = value[key];
       if (!clear)
         continue;
-      const markers = "apply" in clear ? clear.apply : [clear];
+      const markers = Array.isArray(clear) ? clear : [clear];
       for (const m of markers) {
         if (m.type !== "label") {
           ctx.addIssue({
@@ -61483,7 +61492,7 @@ function buildAgentCoordinator(input) {
   async function fetchByGet(inc, excl) {
     if (!inc)
       return [];
-    const include = "filter" in inc ? inc.filter : [];
+    const include = !Array.isArray(inc) && "filter" in inc ? inc.filter : [];
     if (include.length === 0)
       return [];
     const spec = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neriros/ralphy",
-  "version": "2.22.0",
+  "version": "2.22.1",
   "description": "An iterative AI task execution framework. Orchestrates multi-phase autonomous work using Claude or Codex engines.",
   "keywords": [
     "agent",