@neriros/ralphy 2.7.0 → 2.7.1

package/dist/cli/index.js

@@ -56149,7 +56149,7 @@ var HELP_TEXT = [
   "  --linear-team <key>     Linear team key (e.g. ENG)",
   "  --linear-assignee <id>  Filter by assignee (user id, email, or 'me')",
   "  --linear-status <name>  Filter by status name (repeatable, e.g. Todo, In Progress)",
-  "  --linear-label <name>   Filter by label name",
+  "  --linear-label <name>   Filter by label name (repeatable, any-of)",
   "  --poll-interval <s>     Seconds between Linear polls (default: 60)",
   "  --concurrency <n>       Max concurrent task loops (default: 1)",
   "",
@@ -56185,7 +56185,7 @@ async function parseArgs(argv) {
     linearTeam: "",
     linearAssignee: "",
     linearStatus: [],
-    linearLabel: "",
+    linearLabel: [],
     pollInterval: 60,
     concurrency: 1
   };
@@ -56288,7 +56288,7 @@ async function parseArgs(argv) {
       continue;
     }
     if (expectLinearLabel) {
-      result2.linearLabel = arg;
+      result2.linearLabel.push(arg);
       expectLinearLabel = false;
       continue;
     }
@@ -69595,8 +69595,9 @@ async function fetchOpenIssues(apiKey, filter2) {
   } else {
     where.state = { type: { in: [...OPEN_STATE_TYPES] } };
   }
-  if (filter2.label)
-    where.labels = { some: { name: { eq: filter2.label } } };
+  if (filter2.labels && filter2.labels.length > 0) {
+    where.labels = { some: { name: { in: filter2.labels } } };
+  }
   const query = `query Issues($filter: IssueFilter) {
     issues(filter: $filter, first: 50) {
       nodes {
@@ -69607,13 +69608,25 @@ async function fetchOpenIssues(apiKey, filter2) {
       }
     }
   }`;
+  const data = await linearRequest(apiKey, query, {
+    filter: where
+  });
+  return data.issues.nodes.map((n) => ({
+    id: n.id,
+    identifier: n.identifier,
+    title: n.title,
+    description: n.description,
+    url: n.url,
+    state: n.state,
+    assignee: n.assignee,
+    labels: n.labels.nodes.map((l) => l.name)
+  }));
+}
+async function linearRequest(apiKey, query, variables) {
   const res = await fetch(LINEAR_API, {
     method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      Authorization: apiKey
-    },
-    body: JSON.stringify({ query, variables: { filter: where } })
+    headers: { "Content-Type": "application/json", Authorization: apiKey },
+    body: JSON.stringify({ query, variables })
   });
   if (!res.ok) {
     const err = new Error("Linear API request failed");
@@ -69627,18 +69640,50 @@ async function fetchOpenIssues(apiKey, filter2) {
     err.messages = json.errors.map((e) => e.message);
     throw err;
   }
-  if (!json.data)
-    return [];
-  return json.data.issues.nodes.map((n) => ({
-    id: n.id,
-    identifier: n.identifier,
-    title: n.title,
-    description: n.description,
-    url: n.url,
-    state: n.state,
-    assignee: n.assignee,
-    labels: n.labels.nodes.map((l) => l.name)
-  }));
+  if (!json.data) {
+    throw new Error("Linear API returned no data");
+  }
+  return json.data;
+}
+async function addIssueComment(apiKey, issueId, body) {
+  const mutation = `mutation Comment($issueId: String!, $body: String!) {
+    commentCreate(input: { issueId: $issueId, body: $body }) { success }
+  }`;
+  await linearRequest(apiKey, mutation, {
+    issueId,
+    body
+  });
+}
+async function fetchIssueComments(apiKey, issueId) {
+  const query = `query Comments($id: String!) {
+    issue(id: $id) {
+      comments(first: 50) {
+        nodes { id body createdAt user { name email } }
+      }
+    }
+  }`;
+  const data = await linearRequest(apiKey, query, { id: issueId });
+  return data.issue?.comments.nodes ?? [];
+}
+async function fetchWorkflowStates(apiKey, teamKey) {
+  const query = `query States($team: String!) {
+    workflowStates(filter: { team: { key: { eq: $team } } }, first: 50) {
+      nodes { id name type }
+    }
+  }`;
+  const data = await linearRequest(apiKey, query, {
+    team: teamKey
+  });
+  return data.workflowStates.nodes;
+}
+async function updateIssueState(apiKey, issueId, stateId) {
+  const mutation = `mutation Update($id: String!, $stateId: String!) {
+    issueUpdate(id: $id, input: { stateId: $stateId }) { success }
+  }`;
+  await linearRequest(apiKey, mutation, {
+    id: issueId,
+    stateId
+  });
 }
 
 // apps/cli/src/agent/state.ts
@@ -69669,13 +69714,24 @@ function changeNameForIssue(issue) {
   const slug = issue.title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40);
   return slug ? `${issue.identifier.toLowerCase()}-${slug}` : issue.identifier.toLowerCase();
 }
-async function scaffoldChangeForIssue(tasksDir, statesDir, issue) {
+async function scaffoldChangeForIssue(tasksDir, statesDir, issue, comments = []) {
   const name = changeNameForIssue(issue);
   const changeDir = join11(tasksDir, name);
   const stateDir = join11(statesDir, name);
   await mkdir(changeDir, { recursive: true });
   await mkdir(join11(changeDir, "specs"), { recursive: true });
   await mkdir(stateDir, { recursive: true });
+  const commentsBlock = comments.length > 0 ? [
+    "",
+    "## Linear comments",
+    "",
+    ...comments.flatMap((c) => [
+      `**${c.user?.name ?? "unknown"}** \u2014 ${c.createdAt}`,
+      "",
+      c.body.trim(),
+      ""
+    ])
+  ] : [];
   const proposal = [
     `# ${issue.identifier}: ${issue.title}`,
     "",
@@ -69687,6 +69743,7 @@ async function scaffoldChangeForIssue(tasksDir, statesDir, issue) {
     "## Description",
     "",
     issue.description?.trim() || "_No description provided in Linear._",
+    ...commentsBlock,
     "",
     "## Steering",
     "",
@@ -69730,8 +69787,11 @@ var RalphyConfigSchema = exports_external.object({
     team: exports_external.string().optional(),
     assignee: exports_external.string().optional(),
     statuses: exports_external.array(exports_external.string()).default([]),
-    label: exports_external.string().optional()
-  }).default({ statuses: [] })
+    labels: exports_external.union([exports_external.array(exports_external.string()), exports_external.string()]).transform((v) => typeof v === "string" ? [v] : v).default([]),
+    inProgressStatus: exports_external.string().optional(),
+    doneStatus: exports_external.string().optional(),
+    postComments: exports_external.boolean().default(true)
+  }).default({ statuses: [], labels: [], postComments: true })
 }).default({
   concurrency: 1,
   pollIntervalSeconds: 60,
@@ -69739,7 +69799,7 @@ var RalphyConfigSchema = exports_external.object({
   maxCostUsdPerTask: 0,
   engine: "claude",
   model: "opus",
-  linear: { statuses: [] }
+  linear: { statuses: [], labels: [], postComments: true }
 });
 async function loadRalphyConfig(projectRoot) {
   const path = join12(projectRoot, "ralphy.config.json");
@@ -69852,6 +69912,7 @@ class AgentCoordinator {
     this.workers.push(worker);
     this.pendingIds.delete(issue.id);
     this.deps.onWorkersChanged();
+    this.notifyStarted(issue, changeName);
     handle.exited.then((code) => {
       const idx = this.workers.indexOf(worker);
       if (idx >= 0)
@@ -69862,10 +69923,57 @@ class AgentCoordinator {
         this.state.processedIssueIds.push(issue.id);
         this.deps.saveState(this.state);
       }
+      this.notifyExited(issue, changeName, code);
       this.deps.onWorkersChanged();
       this.spawnNext();
     });
   }
+  async notifyStarted(issue, changeName) {
+    const updater = this.deps.updater;
+    if (!updater)
+      return;
+    if (this.opts.postComments !== false) {
+      try {
+        await updater.postComment(issue, `\uD83E\uDD16 Ralph started working on this issue. Tracking change: \`${changeName}\``);
+      } catch (err) {
+        this.deps.onLog(`! Linear comment failed for ${issue.identifier}: ${err.message}`, "red");
+      }
+    }
+    if (this.opts.inProgressStatus) {
+      await this.moveIssue(issue, this.opts.inProgressStatus);
+    }
+  }
+  async notifyExited(issue, changeName, code) {
+    const updater = this.deps.updater;
+    if (!updater)
+      return;
+    const ok = code === 0;
+    if (this.opts.postComments !== false) {
+      const body = ok ? `\u2705 Ralph completed work on this issue. Change: \`${changeName}\`` : `\u2717 Ralph exited with code ${code} on this issue. Change: \`${changeName}\``;
+      try {
+        await updater.postComment(issue, body);
+      } catch (err) {
+        this.deps.onLog(`! Linear comment failed for ${issue.identifier}: ${err.message}`, "red");
+      }
+    }
+    if (ok && this.opts.doneStatus) {
+      await this.moveIssue(issue, this.opts.doneStatus);
+    }
+  }
+  async moveIssue(issue, stateName) {
+    const updater = this.deps.updater;
+    try {
+      const stateId = await updater.resolveStateId(issue, stateName);
+      if (!stateId) {
+        this.deps.onLog(`! Linear state '${stateName}' not found for ${issue.identifier}`, "yellow");
+        return;
+      }
+      await updater.setState(issue, stateId);
+      this.deps.onLog(`  \u2192 ${issue.identifier} moved to '${stateName}'`, "gray");
+    } catch (err) {
+      this.deps.onLog(`! Linear state move failed for ${issue.identifier}: ${err.message}`, "red");
+    }
+  }
   stop() {
     this.stopped = true;
     for (const w of this.workers) {
@@ -69911,11 +70019,21 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
         team: args.linearTeam || cfg.linear.team,
         assignee: args.linearAssignee || cfg.linear.assignee,
         statuses: args.linearStatus.length ? args.linearStatus : cfg.linear.statuses,
-        label: args.linearLabel || cfg.linear.label
+        labels: args.linearLabel.length ? args.linearLabel : cfg.linear.labels
       };
+      const stateCache = new Map;
+      const teamKeyOf = (issue) => issue.identifier.split("-")[0];
       const coord2 = new AgentCoordinator({
         fetchIssues: (f2) => fetchOpenIssues(apiKey, f2),
-        scaffold: (issue) => scaffoldChangeForIssue(tasksDir, statesDir, issue),
+        scaffold: async (issue) => {
+          let comments = [];
+          try {
+            comments = await fetchIssueComments(apiKey, issue.id);
+          } catch (err) {
+            appendLog(`! Linear comment fetch failed for ${issue.identifier}: ${err.message}`, "yellow");
+          }
+          return scaffoldChangeForIssue(tasksDir, statesDir, issue, comments);
+        },
         spawnWorker: (changeName) => {
           const cmd = [
             process.execPath,
@@ -69944,14 +70062,34 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
         loadState: () => readAgentState(projectRoot),
         saveState: (s) => writeAgentState(projectRoot, s),
         onLog: appendLog,
-        onWorkersChanged: () => setTick((t) => t + 1)
-      }, { concurrency, filter: filter2 });
+        onWorkersChanged: () => setTick((t) => t + 1),
+        updater: {
+          postComment: (issue, body) => addIssueComment(apiKey, issue.id, body),
+          setState: (issue, stateId) => updateIssueState(apiKey, issue.id, stateId),
+          resolveStateId: async (issue, stateName) => {
+            const team = teamKeyOf(issue);
+            let map2 = stateCache.get(team);
+            if (!map2) {
+              const states = await fetchWorkflowStates(apiKey, team);
+              map2 = new Map(states.map((s) => [s.name.toLowerCase(), s.id]));
+              stateCache.set(team, map2);
+            }
+            return map2.get(stateName.toLowerCase()) ?? null;
+          }
+        }
+      }, {
+        concurrency,
+        filter: filter2,
+        inProgressStatus: cfg.linear.inProgressStatus,
+        doneStatus: cfg.linear.doneStatus,
+        postComments: cfg.linear.postComments
+      });
       coordRef.current = coord2;
       await coord2.init();
       const tick = async () => {
         if (cancelled)
           return;
-        const filterDesc = `team=${filter2.team ?? "*"}, assignee=${filter2.assignee ?? "*"}, statuses=${filter2.statuses?.length ? filter2.statuses.join(",") : "open"}${filter2.label ? `, label=${filter2.label}` : ""}`;
+        const filterDesc = `team=${filter2.team ?? "*"}, assignee=${filter2.assignee ?? "*"}, statuses=${filter2.statuses?.length ? filter2.statuses.join(",") : "open"}${filter2.labels?.length ? `, labels=${filter2.labels.join(",")}` : ""}`;
         appendLog(`\u2026 polling Linear (${filterDesc})`);
         const { found, added } = await coord2.pollOnce();
         appendLog(`  found ${found} open, ${added} new (queue=${coord2.queuedCount})`);

package/package.json

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