diff --git a/src/comment-routing.test.ts b/src/comment-routing.test.ts new file mode 100644 index 0000000..e02efc4 --- /dev/null +++ b/src/comment-routing.test.ts @@ -0,0 +1,73 @@ +/// + +import assert from "node:assert/strict"; +import { test } from "node:test"; +import { + CLOSED_ISSUE_STATUSES, + nativeWakeCoversComment, +} from "./comment-routing.ts"; + +const CEO = "cdbfa8bc-3d61-41a4-a2e7-677ec7d34562"; +const ANALYST = "752cebdd-6748-4a04-aacd-c7ab0294ef33"; + +// ── #16 AC: issue פתוח משויך-CEO, בלי reopened → הנייטיבי מכסה, אין invoke ── +test("open CEO-owned issue is covered natively (the #772 / CMPA-232 case)", () => { + for (const status of ["in_progress", "in_review", "todo", "blocked"]) { + assert.equal( + nativeWakeCoversComment({ status, assigneeAgentId: CEO }), + true, + status, + ); + } +}); + +// הכלל הוא "משויך לסוכן", לא "משויך ל-CEO": Paperclip מעיר כל assignee-סוכן. +test("open issue owned by any agent is covered natively", () => { + assert.equal( + nativeWakeCoversComment({ + status: "in_progress", + assigneeAgentId: ANALYST, + }), + true, + ); +}); + +// ── #16 AC: משויך לאדם / לא משויך → הנייטיבי מת → חובה לנתב ── +test("human-owned or unassigned open issue is NOT covered → plugin must route", () => { + assert.equal( + nativeWakeCoversComment({ status: "in_review", assigneeAgentId: null }), + false, + ); + assert.equal( + nativeWakeCoversComment({ + status: "in_review", + assigneeAgentId: undefined, + }), + false, + ); + assert.equal( + nativeWakeCoversComment({ status: "in_review", assigneeAgentId: "" }), + false, + ); +}); + +// ── סגור → Paperclip מדלג על ה-wakeup גם כשיש assignee-סוכן ── +test("closed issue is never covered natively, whoever owns it", () => { + for (const status of CLOSED_ISSUE_STATUSES) { + assert.equal( + nativeWakeCoversComment({ status, assigneeAgentId: CEO }), + false, + status, + ); + assert.equal( + nativeWakeCoversComment({ status, assigneeAgentId: null }), + false, + status, + ); + } +}); + +// מראה של legal-ai `CLOSED_ISSUE_STATUSES` — שינוי שם מחייב שינוי כאן. +test("closed statuses mirror legal-ai needs_ceo_run()", () => { + assert.deepEqual([...CLOSED_ISSUE_STATUSES].sort(), ["cancelled", "done"]); +}); diff --git a/src/comment-routing.ts b/src/comment-routing.ts new file mode 100644 index 0000000..cc73eab --- /dev/null +++ b/src/comment-routing.ts @@ -0,0 +1,43 @@ +/** + * מסלול-יקיצה יחיד להערת-יו"ר (plugin-legal-ai #16, legal-ai #772). + * + * Paperclip מעיר **בעצמו** את הסוכן המשויך ל-issue על כל הערת-משתמש + * (`@paperclipai/server` routes/issues.js — `addWakeup(assigneeId, {reason: + * "issue_commented", payload.mutation: "comment"})`), ובלבד ש-(א) יש assignee-סוכן, + * (ב) ה-issue אינו סגור (`done`/`cancelled`), (ג) ההערה אינה של אותו סוכן עצמו. + * ‏`ctx.agents.invoke` של הפלאגין על אותה הערה = ריצת-CEO שנייה במקביל: עבודה + * כפולה, שתי רשומות `chair_feedback`, שני issues לכותב (legal-ai #772; שוב + * 2026-11-01 על CMPA-232 — 3 ריצות כפולות, ~9$). + * + * ⚠️ מקור-האמת לכלל הוא **`needs_ceo_run()` ב-legal-ai `web/paperclip_client.py`** + * (נמדד על 120 יום ב-DB החי: agent-owned + open → 70/70 הערות קיבלו wakeup נייטיבי; + * human-owned/unassigned → ה-wakeup מכוון לאדם ומבוטל; closed → אין wakeup כלל). + * הפונקציה כאן היא **מראה** של אותו כלל בצד הפלאגין — אין דרך לקרוא ל-legal-ai + * מתוך event-handler בלי להוסיף תלות-רשת לנתיב-המסירה. **כל שינוי שם מחייב + * שינוי כאן**, ולהיפך (G2 — מסלול-החלטה אחד, שני מימושים שחייבים להישאר זהים). + */ + +/** סטטוסים סופיים — Paperclip מדלג על ה-wakeup הנייטיבי בהם (`isClosed`). */ +export const CLOSED_ISSUE_STATUSES: ReadonlySet = new Set([ + "done", + "cancelled", +]); + +export interface RoutableIssue { + status: string; + assigneeAgentId?: string | null; +} + +/** + * האם המסירה הנייטיבית של Paperclip כבר מעירה סוכן על הערה ב-issue הזה? + * + * `true` → **אין** להפעיל `ctx.agents.invoke` (זה יהיה המסלול הכפול). + * `false` → המסלול הנייטיבי מת (issue סגור, או משויך לאדם / לא משויך) — זו + * בדיוק הסיבה שמסלול-הפלאגין קיים (#164/#454), ויש לנתב ל-CEO. + * + * זהה ל-`not needs_ceo_run(issue)` ב-legal-ai. + */ +export function nativeWakeCoversComment(issue: RoutableIssue): boolean { + if (CLOSED_ISSUE_STATUSES.has(issue.status)) return false; + return Boolean(issue.assigneeAgentId); +} diff --git a/src/worker.ts b/src/worker.ts index 38d426c..b7ce49d 100644 --- a/src/worker.ts +++ b/src/worker.ts @@ -6,6 +6,7 @@ import type { PluginWebhookInput, } from "@paperclipai/plugin-sdk"; import { definePlugin, runWorker } from "@paperclipai/plugin-sdk"; +import { nativeWakeCoversComment } from "./comment-routing.js"; import { CompanyScopeUnavailableError, isCompanyScopeDenied, @@ -859,17 +860,21 @@ const plugin = definePlugin({ return; } - // Dedup against the host's native reopen-on-comment wake: when a comment - // reopens a `done` issue, the host already wakes that issue's assignee. - // If the assignee IS this company's CEO, that native wake covers us — - // invoking again would double-run the CEO. Skip ONLY in that exact case. - // For issues owned by any other agent (e.g. an analyst sub-task), the - // native wake targets the wrong agent (and the queued run is cancelled - // with `issue_assignee_changed`), so we MUST route the comment to the CEO. - if (issue.assigneeAgentId === ceoAgentId && payload?.reopened === true) { + // מסלול-יקיצה יחיד (#16, legal-ai #772): Paperclip מעיר בעצמו את הסוכן + // המשויך על כל הערת-משתמש ב-issue פתוח — לא רק כשההערה פותחת-מחדש issue + // סגור (זה היה הכלל הקודם, `reopened === true`, והוא פספס את המקרה הנפוץ: + // issue פתוח ב-`in_review` משויך-CEO → שתי ריצות-CEO במקביל על אותה הערה). + // הכלל נגזר מ-`needs_ceo_run()` ב-legal-ai — ראה comment-routing.ts. + // הפלאגין מנתב רק במקום שבו הנייטיבי מת: issue סגור, או משויך לאדם / לא משויך. + if (nativeWakeCoversComment(issue)) { ctx.logger.info( - "Comment reopened CEO-owned issue; native wake handles it, skipping plugin route", - { issueId, ceoAgentId }, + "Comment on open agent-owned issue; native wake handles it, skipping plugin route (#16)", + { + issueId, + status: issue.status, + assigneeAgentId: issue.assigneeAgentId, + reopened: payload?.reopened === true, + }, ); // The comment IS being handled (natively) — stamp the marker so the // reconciliation sweep does not re-route it a second time.