@neriros/ralphy 3.10.20 → 3.10.22

package/dist/shell/index.js

@@ -18928,8 +18928,8 @@ import { readFileSync } from "fs";
 import { resolve } from "path";
 function getVersion() {
   try {
-    if ("3.10.20")
-      return "3.10.20";
+    if ("3.10.22")
+      return "3.10.22";
   } catch {}
   const dirsToTry = [];
   try {
@@ -81405,7 +81405,6 @@ var init_schema = __esm(() => {
     getAutoMerge: GetIndicatorSchema.optional(),
     getApproved: GetIndicatorSchema.optional(),
     getConfirmGate: GetIndicatorSchema.optional(),
-    getAutoApprove: GetIndicatorSchema.optional(),
     setInProgress: SetIndicatorSchema.optional(),
     setDone: SetIndicatorSchema.optional(),
     setPrReady: SetIndicatorSchema.optional(),
@@ -82117,6 +82116,24 @@ function stampDescription(document2, path) {
     return;
   pair.key.commentBefore = toCommentLines(match.description);
 }
+function toMarkerArray(node2) {
+  if (node2 == null)
+    return [];
+  const js = import_yaml2.default.isNode(node2) ? node2.toJSON() : node2;
+  return Array.isArray(js) ? js : [];
+}
+function dedupeMarkers(markers) {
+  const seen = new Set;
+  const out = [];
+  for (const marker of markers) {
+    const key = JSON.stringify(marker);
+    if (seen.has(key))
+      continue;
+    seen.add(key);
+    out.push(marker);
+  }
+  return out;
+}
 function normalizeWorkflowMarkdown(markdown) {
   const match = FRONTMATTER_RE.exec(markdown);
   if (!match)
@@ -82133,6 +82150,17 @@ function normalizeWorkflowMarkdown(markdown) {
     stampDescription(document2, path);
     added.push(path.join("."));
   }
+  const autoApprovePath = ["linear", "indicators", "getAutoApprove"];
+  if (document2.getIn(autoApprovePath) !== undefined) {
+    const merged = dedupeMarkers([
+      ...toMarkerArray(document2.getIn(["linear", "indicators", "getApproved", "filter"])),
+      ...toMarkerArray(document2.getIn([...autoApprovePath, "filter"]))
+    ]);
+    document2.setIn(["linear", "indicators", "getApproved"], { filter: merged });
+    stampDescription(document2, ["linear", "indicators", "getApproved"]);
+    document2.deleteIn(autoApprovePath);
+    added.push("linear.indicators.getApproved");
+  }
   const gateEnabled = document2.getIn(["linear", "confirmationMode", "enabled"]) === true;
   const hasGetApproved = document2.getIn(["linear", "indicators", "getApproved"]) !== undefined;
   if (gateEnabled && !hasGetApproved) {
@@ -82284,9 +82312,9 @@ function matchesAnyValue(type, values2, ticket) {
 }
 function computeConfirmationFlags(config2, ticket) {
   const cm = config2.linear.confirmationMode;
-  const { getConfirmGate, getAutoApprove, getApproved } = config2.linear.indicators;
+  const { getConfirmGate, getApproved } = config2.linear.indicators;
   const optInSatisfied = !getConfirmGate || matchesIndicator(getConfirmGate, ticket);
-  const confirmationGated = cm.enabled && optInSatisfied && !matchesIndicator(getAutoApprove, ticket);
+  const confirmationGated = cm.enabled && optInSatisfied;
   const approved = matchesIndicator(getApproved, ticket);
   return { confirmationGated, approved };
 }
@@ -102996,11 +103024,13 @@ var init_config = __esm(() => {
 // apps/agent/src/shared/capabilities/poll-context.ts
 class PollContext {
   memo = new Map;
-  fetchPrOnce(url2, fields, runner, cwd2) {
+  fetchPrOnce(url2, fields, runner, cwd2, opts) {
     const key = `${url2}|${[...fields].sort().join(",")}`;
-    const existing = this.memo.get(key);
-    if (existing)
-      return existing;
+    if (!opts?.forceRefresh) {
+      const existing = this.memo.get(key);
+      if (existing)
+        return existing;
+    }
     const pending = this.runGhView(url2, fields, runner, cwd2);
     this.memo.set(key, pending);
     pending.catch(() => {
@@ -103056,6 +103086,13 @@ function parseRalphyMarker(body) {
     return null;
   return { version: version3, type, fields };
 }
+function findStickyComment(comments, type) {
+  for (const comment of comments) {
+    if (parseRalphyMarker(comment.body)?.type === type)
+      return comment;
+  }
+  return null;
+}
 function buildRalphyComment(input) {
   const lines = [`${RALPHY_TITLE_PREFIX}${input.action}`];
   const body = input.body?.trim();
@@ -108151,8 +108188,8 @@ async function releaseAwaitingMarker(issue2, statePath, deps) {
   return true;
 }
 function confirmationUsesCommentIndicator(cfg) {
-  const { getApproved, getAutoApprove, getConfirmGate } = cfg.linear.indicators;
-  return [getApproved, getAutoApprove, getConfirmGate].some((g) => g?.filter.some((m) => m.type === "comment"));
+  const { getApproved, getConfirmGate } = cfg.linear.indicators;
+  return [getApproved, getConfirmGate].some((g) => g?.filter.some((m) => m.type === "comment"));
 }
 async function processAwaitingForIssue(issue2, deps) {
   try {
@@ -108793,6 +108830,46 @@ var init_linear_resolvers = __esm(() => {
   init_identifier_strategy();
 });
 
+// apps/agent/src/agent/wire/tracker/sticky-comment.ts
+async function upsertStickyComment(deps) {
+  const { cmdRunner, repo, projectRoot, issueNumber, type, body, diag } = deps;
+  let comments;
+  try {
+    const { stdout } = await cmdRunner.run(["gh", "issue", "view", issueNumber, "--repo", repo, "--json", "comments"], projectRoot);
+    const parsed = JSON.parse(stdout.trim() || "{}");
+    comments = parsed.comments ?? [];
+  } catch (err) {
+    diag("sticky-comment", `! could not list comments for issue #${issueNumber}: ${err.message}`, "yellow");
+    return;
+  }
+  const existing = findStickyComment(comments, type);
+  try {
+    if (existing?.id) {
+      await cmdRunner.run([
+        "gh",
+        "api",
+        "graphql",
+        "-f",
+        `query=${UPDATE_COMMENT_MUTATION}`,
+        "-f",
+        `id=${existing.id}`,
+        "-F",
+        `body=${body}`
+      ], projectRoot);
+      diag("sticky-comment", `  \u2192 #${issueNumber} ${type} comment edited in place`, "gray");
+      return;
+    }
+    await cmdRunner.run(["gh", "issue", "comment", issueNumber, "--repo", repo, "--body", body], projectRoot);
+    diag("sticky-comment", `  \u2192 #${issueNumber} ${type} comment created`, "gray");
+  } catch (err) {
+    diag("sticky-comment", `! could not upsert ${type} comment on issue #${issueNumber}: ${err.message}`, "yellow");
+  }
+}
+var UPDATE_COMMENT_MUTATION = "mutation($id:ID!,$body:String!){updateIssueComment(input:{id:$id,body:$body}){clientMutationId}}";
+var init_sticky_comment = __esm(() => {
+  init_src8();
+});
+
 // apps/agent/src/agent/wire/tracker/github.ts
 function identifierForNumber(n) {
   return `issue-${n}`;
@@ -108888,6 +108965,24 @@ function createGithubTrackerProvider(input) {
       diag("github-marker", `  \u2192 ${issue2.identifier} comment`, "gray");
       return;
     }
+    if (m.type === "attachment") {
+      const body = buildRalphyComment({
+        type: "attachment",
+        action: m.value,
+        fields: { issue: issue2.identifier }
+      });
+      await upsertStickyComment({
+        cmdRunner,
+        repo: await repo(),
+        projectRoot,
+        issueNumber: issue2.id,
+        type: "attachment",
+        body,
+        diag
+      });
+      diag("github-marker", `  \u2192 ${issue2.identifier} attachment (sticky upsert)`, "gray");
+      return;
+    }
     if (m.type !== "label") {
       diag("github-marker", `! ${issue2.identifier}: '${m.type}' markers are not supported by the GitHub tracker \u2014 skipped`, "yellow");
       return;
@@ -108915,6 +109010,18 @@ function createGithubTrackerProvider(input) {
       diag("github-marker", `  \u2192 ${issue2.identifier} -label='${m.value}'`, "gray");
     }
   }
+  async function listOpenIssues() {
+    if (!todoLabel || todoLabel.trim() === "")
+      return listIssues([]);
+    const [todo, inProgress] = await Promise.all([
+      listIssues(["--label", todoLabel.trim()]),
+      listIssues(["--label", statusLabels.inProgress])
+    ]);
+    const byId = new Map;
+    for (const i of [...todo, ...inProgress])
+      byId.set(i.id, i);
+    return [...byId.values()];
+  }
   async function fetchDoneCandidates() {
     return listIssues(["--label", statusLabels.inProgress]);
   }
@@ -108927,7 +109034,9 @@ function createGithubTrackerProvider(input) {
     removeIndicator,
     applyMarker,
     fetchDoneCandidates,
-    resolveLabelIdForTeam
+    resolveLabelIdForTeam,
+    listOpenIssues,
+    repo
   };
 }
 function githubIndicators(issues) {
@@ -108943,7 +109052,9 @@ function githubIndicators(issues) {
 }
 var DEFAULT_STATUS_LABELS;
 var init_github = __esm(() => {
+  init_src8();
   init_types2();
+  init_sticky_comment();
   DEFAULT_STATUS_LABELS = {
     inProgress: "ralph:in-progress",
     done: "ralph:done",
@@ -109431,7 +109542,7 @@ function createPrDiscovery(input) {
       prByChange.set(changeName, prUrl);
     }
     const outcome = await waitForMergeability({
-      probe: async () => await getPollContext().fetchPrOnce(prUrl, ["state", "mergeable", "mergeStateStatus"], cmdRunner, projectRoot),
+      probe: async (attempt2) => await getPollContext().fetchPrOnce(prUrl, ["state", "mergeable", "mergeStateStatus"], cmdRunner, projectRoot, { forceRefresh: attempt2 > 0 }),
       onError: (err, attempt2, total) => diag("pr", `! gh pr view ${prUrl} failed (attempt ${attempt2 + 1}/${total}): ${err.message} \u2014 will retry`, "yellow")
     });
     if (outcome.kind === "closed") {
@@ -109694,44 +109805,49 @@ async function addGithubReactionToComment(cmdRunner, projectRoot, source, commen
   const path = source.kind === "issue" ? `repos/${source.owner}/${source.repo}/issues/comments/${commentId}/reactions` : `repos/${source.owner}/${source.repo}/pulls/comments/${commentId}/reactions`;
   await cmdRunner.run(["gh", "api", "-X", "POST", path, "-f", `content=${content}`], projectRoot);
 }
-async function postGithubPrComment(cmdRunner, projectRoot, prUrl, body, onLog) {
-  const m = /^https:\/\/github\.com\/([^/]+)\/([^/]+)\/pull\/(\d+)/.exec(prUrl);
-  if (!m)
-    return;
-  const [, owner, repo, num] = m;
+async function fetchGithubIssueComments(cmdRunner, projectRoot, repo, issueNumber, onLog) {
+  try {
+    const res = await cmdRunner.run([
+      "gh",
+      "api",
+      `repos/${repo}/issues/${issueNumber}/comments`,
+      "--jq",
+      "[.[] | {id: .id, body: .body, createdAt: .created_at, author: .user.login, url: .html_url}]"
+    ], projectRoot);
+    return JSON.parse(res.stdout || "[]");
+  } catch (err) {
+    onLog(`! mention scan: gh comments failed for ${repo}#${issueNumber}: ${formatLinearError(err)}`, "yellow");
+    return [];
+  }
+}
+async function postGithubIssueComment(cmdRunner, projectRoot, repo, issueNumber, body, onLog) {
   try {
     await cmdRunner.run([
       "gh",
       "api",
       "-X",
       "POST",
-      `repos/${owner}/${repo}/issues/${num}/comments`,
+      `repos/${repo}/issues/${issueNumber}/comments`,
       "-f",
       `body=${body}`
     ], projectRoot);
   } catch (err) {
-    onLog(`! mention scan: gh ack comment failed for ${prUrl}: ${formatLinearError(err)}`, "yellow");
+    onLog(`! mention scan: gh ack comment failed for ${repo}#${issueNumber}: ${formatLinearError(err)}`, "yellow");
   }
 }
+async function postGithubPrComment(cmdRunner, projectRoot, prUrl, body, onLog) {
+  const m = /^https:\/\/github\.com\/([^/]+)\/([^/]+)\/pull\/(\d+)/.exec(prUrl);
+  if (!m)
+    return;
+  const [, owner, repo, num] = m;
+  await postGithubIssueComment(cmdRunner, projectRoot, `${owner}/${repo}`, Number(num), body, onLog);
+}
 async function fetchPrIssueComments(cmdRunner, projectRoot, prUrl, onLog) {
   const m = /^https:\/\/github\.com\/([^/]+)\/([^/]+)\/pull\/(\d+)/.exec(prUrl);
   if (!m)
     return [];
   const [, owner, repo, num] = m;
-  try {
-    const res = await cmdRunner.run([
-      "gh",
-      "api",
-      `repos/${owner}/${repo}/issues/${num}/comments`,
-      "--jq",
-      "[.[] | {id: .id, body: .body, createdAt: .created_at, author: .user.login, url: .html_url}]"
-    ], projectRoot);
-    const parsed = JSON.parse(res.stdout || "[]");
-    return parsed;
-  } catch (err) {
-    onLog(`! mention scan: gh comments failed for ${prUrl}: ${formatLinearError(err)}`, "yellow");
-    return [];
-  }
+  return fetchGithubIssueComments(cmdRunner, projectRoot, `${owner}/${repo}`, Number(num), onLog);
 }
 var init_github2 = __esm(() => {
   init_linear();
@@ -109926,6 +110042,77 @@ function createMentionScanner(input) {
     return out;
   };
 }
+function createGithubMentionScanner(input) {
+  const { cfg, cmdRunner, projectRoot, onLog, diag, listOpenIssues, repo } = input;
+  return async function fetchMentions() {
+    if (!cfg.linear.mentionTrigger)
+      return [];
+    const handle = cfg.linear.mentionHandle;
+    let repoSlug;
+    try {
+      repoSlug = await repo();
+    } catch (err) {
+      diag("mention", `! github mention scan: ${err.message}`, "yellow");
+      return [];
+    }
+    const [owner, name] = repoSlug.split("/");
+    if (!owner || !name) {
+      diag("mention", `! github mention scan: unexpected repo slug '${repoSlug}'`, "yellow");
+      return [];
+    }
+    let candidates;
+    try {
+      candidates = await listOpenIssues();
+    } catch (err) {
+      diag("mention", `! github mention scan: list issues failed: ${formatLinearError(err)}`, "yellow");
+      return [];
+    }
+    const out = [];
+    for (const issue2 of candidates) {
+      const issueNumber = Number(issue2.id);
+      if (!Number.isFinite(issueNumber))
+        continue;
+      const comments = await fetchGithubIssueComments(cmdRunner, projectRoot, repoSlug, issueNumber, onLog);
+      issue2.comments = comments.map((c) => ({
+        id: String(c.id),
+        body: c.body,
+        createdAt: c.createdAt,
+        user: c.author ? { name: c.author, email: null } : null
+      }));
+      const gate2 = latestIso(findLastRalphPickupISO(comments), findLastMentionAckISO(comments));
+      for (const c of comments) {
+        if (isRalphComment(c.body))
+          continue;
+        if (!containsHandle(c.body, handle))
+          continue;
+        if (gate2 && c.createdAt <= gate2)
+          continue;
+        out.push({
+          issue: issue2,
+          trigger: {
+            source: "github",
+            body: c.body,
+            createdAt: c.createdAt,
+            ...c.author ? { author: c.author } : {},
+            url: c.url
+          }
+        });
+        try {
+          await addGithubReactionToComment(cmdRunner, projectRoot, { owner, repo: name, kind: "issue" }, c.id, "\uD83D\uDC40");
+        } catch (err) {
+          if (!isAlreadyReactedError(err)) {
+            diag("mention", `! github mention scan: reaction failed for ${repoSlug}#${issueNumber}: ${formatLinearError(err)}`, "yellow");
+          }
+        }
+        if (cfg.linear.postComments !== false) {
+          await postGithubIssueComment(cmdRunner, projectRoot, repoSlug, issueNumber, buildMentionAckComment(), onLog);
+        }
+        break;
+      }
+    }
+    return out;
+  };
+}
 async function isChangeArchivedForIssue(issue2, cwdByChange, projectRoot) {
   const changeName = changeNameForIssue(issue2);
   const root = cwdByChange.get(changeName) ?? projectRoot;
@@ -264002,12 +264189,13 @@ function buildAgentCoordinator(input) {
     diag,
     ...ticketNumbers.length > 0 ? { ticketNumbers } : {}
   });
-  const provider = isGithubTracker ? createGithubTrackerProvider({
+  const githubProvider = isGithubTracker ? createGithubTrackerProvider({
     issues: cfg.github?.issues,
     cmdRunner,
     projectRoot,
     diag
-  }) : {
+  }) : null;
+  const provider = githubProvider ? githubProvider : {
     ...resolvers,
     fetchDoneCandidates: () => fetchDoneCandidatesWith(apiKey, team, assignee, anyAssignee, scope, indicators, ticketNumbers.length > 0 ? ticketNumbers : undefined)
   };
@@ -264041,7 +264229,15 @@ function buildAgentCoordinator(input) {
     scriptRunner,
     ...input.runners?.worktree ? { worktreeProvider: input.runners.worktree } : {}
   });
-  const fetchMentions = isGithubTracker ? async () => [] : createMentionScanner({
+  const fetchMentions = githubProvider ? createGithubMentionScanner({
+    cfg,
+    cmdRunner,
+    projectRoot,
+    onLog,
+    diag,
+    listOpenIssues: githubProvider.listOpenIssues,
+    repo: githubProvider.repo
+  }) : createMentionScanner({
     apiKey,
     args,
     cfg,

package/package.json

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