Compare commits
5 Commits
chore/1117
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
| 976e8ebe2d | |||
| c934a6be44 | |||
| f0925982c9 | |||
| cfbeb582fa | |||
| 4550c4132a |
73
src/comment-routing.test.ts
Normal file
73
src/comment-routing.test.ts
Normal file
@@ -0,0 +1,73 @@
|
||||
/// <reference types="node" />
|
||||
|
||||
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"]);
|
||||
});
|
||||
43
src/comment-routing.ts
Normal file
43
src/comment-routing.ts
Normal file
@@ -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<string> = 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);
|
||||
}
|
||||
@@ -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.
|
||||
@@ -1238,27 +1243,17 @@ const plugin = definePlugin({
|
||||
// double-routed. Runs every 2 minutes (manifest schedule).
|
||||
ctx.jobs.register("route-pending-comments", async (_job) => {
|
||||
await runJobHandler("route-pending-comments", ctx.logger, async () => {
|
||||
// כשל-מהיר: דחיית-scope (legal-ai issue #637) אינה "שגיאה
|
||||
// פר-issue" שאפשר להתעלם ממנה — היא אומרת שה-run **כולו** לא
|
||||
// יכול לעבוד. לזרוק מיד במקום לבלוע ולהמשיך ללולאה על 2
|
||||
// חברות × 200 issues שכולן ייכשלו זהה. שגיאה אחרת (ולא scope)
|
||||
// נשארת warn+continue — זו העמידות האמיתית פר-issue.
|
||||
let companies: Awaited<ReturnType<typeof ctx.companies.list>>;
|
||||
try {
|
||||
companies = await ctx.companies.list();
|
||||
} catch (err) {
|
||||
if (isCompanyScopeDenied(err)) {
|
||||
throw new CompanyScopeUnavailableError(
|
||||
"route-pending-comments",
|
||||
"companies.list",
|
||||
{ cause: err },
|
||||
);
|
||||
}
|
||||
ctx.logger.warn("route-pending-comments: companies.list failed", {
|
||||
error: String(err),
|
||||
});
|
||||
return;
|
||||
}
|
||||
// רשימת החברות נלקחת ממפת ה-CEO ולא מ-`ctx.companies.list()` (legal-ai
|
||||
// #1280): הקריאה הזו דורשת scope של instance, וה-host דוחה אותה
|
||||
// באקראי בג'וב מתוזמן (invalidInvocationScope, ~21% מהריצות מ-10.11).
|
||||
// הלולאה ממילא מדלגת על חברה בלי CEO ממופה, ולכן הרשימה זהה
|
||||
// (אותו דפוס כמו `knownCompanyIds` ב-`resolveApiBase`).
|
||||
//
|
||||
// כשל-מהיר נשאר ב-`issues.list`: דחיית-scope (legal-ai issue #637)
|
||||
// אינה "שגיאה פר-issue" שאפשר להתעלם ממנה — היא אומרת שה-run
|
||||
// **כולו** לא יכול לעבוד. שגיאה אחרת (ולא scope) נשארת
|
||||
// warn+continue — זו העמידות האמיתית פר-issue.
|
||||
const companies = Object.keys(CEO_AGENT_IDS).map((id) => ({ id }));
|
||||
|
||||
for (const company of companies) {
|
||||
const ceoAgentId = CEO_AGENT_IDS[company.id];
|
||||
|
||||
Reference in New Issue
Block a user