Files
plugin-legal-ai/src/sync-target.test.ts
Chaim Marcus 510f276717 fix(sync): onWebhook גוזר תוויות-סטטוס מ-/api/status-model (legal-ai #616)
מפת-התוויות העברית הקשיחה ב-onWebhook הייתה מקור-האמת השני לאותו enum
של סטטוסי-תיק, והספיקה לסטות: חסרו בה analyst_verified ו-research_complete
(שנוספו ל-case_status_model.py ב-30.6), והיו בה חמישה מפתחות מתים —
uploading, brainstorming, drafting, in_progress ו-qa_failed. #604 תיקן את
המפה הראשונה (CASE_STATUS_TO_ISSUE_STATUS); זו השנייה.

- statusLabels נמחקת; התווית נגזרת מ-GET /api/status-model דרך labelFor()
  הקיימת — אותו SSOT שהג'וב sync-case-status כבר צורך (G2).
- resolveStatusLabel() חדשה ב-sync-target.ts (המודול הטהור): מרכיבה את
  labelFor ומחזירה גם את **סיבת** הנפילה-לגולמי, כדי שההיגיון יהיה
  בר-בדיקה — worker.ts אינו ניתן ל-import בטסט (runWorker ברמת-המודול).
- אין בליעה שקטה (כלל-הנדסה §6): סטטוס שנטען ואינו במודל → logger.warn עם
  מספר-התיק והסטטוס; מודל שלא נטען כלל (כשל-רשת או LegalApi חסר) → שני
  logger.error נבדלים. בכל המקרים התגובה עדיין מתפרסמת והערת-ה-CEO עדיין
  נורית — תווית חסרה אינה מפילה webhook.
- oldStatus מתורגם אף הוא לתווית (היה מודפס כמפתח-אנגלית בתוך משפט עברי).
- legalApi עשה hoist ליד pluginCtx ומועבר מפורשות ל-handleCaseStatusWebhook
  — אותו מופע, לא שני.
- AC2: הוסרו שתי רשימות-הסטטוסים הקשיחות הנוספות ב-worker.ts — ה-enum
  המיושן ב-legal_case_update (חסם 8 סטטוסים חוקיים והתיר את in_progress
  שאינו case.status; המניפסט כבר מגדיר את השדה כמחרוזת חופשית, והוולידציה
  האמיתית היא server-side) והמנייה בתיאור legal_case_list.

Invariants: G2 (מקור-אמת אחד לתוויות, בשני הצרכנים) · G1 (נרמול-במקור —
הפלאגין מושך מה-SSOT במקום להחזיק העתק סטטי) · G12 (legal-ai לא נגע כלל;
אפס סמל ספציפי-Paperclip נכנס אליו) · X7 INV-INT9 (onWebhook עדיין אינו
כותב issue.status — המשבצת השמורה נשארת שמורה) · כלל-הנדסה §6.

tsc --noEmit נקי · biome check src/ נקי · node --test 39/39.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-01 23:33:15 +03:00

390 lines
12 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/// <reference types="node" />
import assert from "node:assert/strict";
import { test } from "node:test";
// Excluded from tsc (tsconfig.json) — never bundled/emitted, run natively via
// `node --test`, which requires the literal `.ts` extension (Node's ESM
// resolver does not remap `.js` specifiers to `.ts` files at runtime).
import type { StatusModelEntry } from "./legal-api.ts";
import {
isWritableStatus,
labelFor,
pickSyncTargetIssue,
resolveIssueStatus,
resolveStatusLabel,
type SyncCandidate,
} from "./sync-target.ts";
/**
* הכלל הישן (worker.ts:894 לפני #446): כל issue מקושר שסטטוסו שונה מהיעד —
* נכתב, בלי סינון parentId ובלי סינון-סטטוס.
*/
function legacyTargets(
candidates: readonly SyncCandidate[],
targetStatus: string,
): string[] {
return candidates.filter((c) => c.status !== targetStatus).map((c) => c.id);
}
test("רגרסיית 8125-09-24 / CMPA-140: 11 ה-issues הממשיים של התיק, אף sub-task done לא נבחר", () => {
// נמדד ב-DB החי של Paperclip (2026-08-24) — כל ה-issues המקושרים לתיק
// 8125-09-24. CMPA-140 (זה שנדרס בפועל, done→in_progress) הוא **ילד** של
// CMPA-139, לא שורש. CMPA-139 עצמו אינו ברשימה בכוונה: נמדד שאין לו
// רשומת legal-case-number ב-plugin_state, ולכן הוא לא מגיע כמועמד כלל —
// לילד יש הורה שאינו מקושר.
const candidates: SyncCandidate[] = [
{ id: "CMPA-116", status: "cancelled", parentId: null, companyId: "c1" },
{ id: "CMPA-84", status: "cancelled", parentId: null, companyId: "c1" },
{ id: "CMPA-86", status: "cancelled", parentId: null, companyId: "c1" },
{ id: "CMPA-140", status: "done", parentId: "CMPA-139", companyId: "c1" }, // זה שנדרס בפועל
{
id: "CMPA-141",
status: "cancelled",
parentId: "CMPA-139",
companyId: "c1",
},
{ id: "CMPA-85", status: "done", parentId: "CMPA-84", companyId: "c1" },
{ id: "CMPA-146", status: "done", parentId: "CMPA-84", companyId: "c1" },
{ id: "CMPA-147", status: "done", parentId: "CMPA-84", companyId: "c1" },
{ id: "CMPA-87", status: "done", parentId: "CMPA-86", companyId: "c1" },
{ id: "CMPA-88", status: "done", parentId: "CMPA-86", companyId: "c1" },
{
id: "CMPA-89",
status: "cancelled",
parentId: "CMPA-86",
companyId: "c1",
},
];
// סטטוס-התיק היה drafted → in_progress (CASE_STATUS_TO_ISSUE_STATUS ב-worker.ts).
const targetStatus = "in_progress";
// הכלל הישן היה כותב על CMPA-140 — זה הבאג שתועד.
assert.ok(legacyTargets(candidates, targetStatus).includes("CMPA-140"));
const result = pickSyncTargetIssue(candidates);
// הכלל החדש אינו כותב על דבר.
assert.equal(result.target, null);
assert.equal(result.reason, "no_writable_root");
});
test("sub-task יחיד ב-done ומקושר: sub-task לעולם לא נבחר", () => {
const candidates: SyncCandidate[] = [
{ id: "sub-1", status: "done", parentId: "some-root", companyId: "c1" },
];
const result = pickSyncTargetIssue(candidates);
assert.equal(result.target, null);
assert.equal(result.reason, "no_writable_root");
});
test("sub-task יחיד פתוח (in_progress) + שורש cancelled: פתוח אינו מספיק, חייב שורש", () => {
const candidates: SyncCandidate[] = [
{ id: "root-1", status: "cancelled", parentId: null, companyId: "c1" },
{ id: "sub-1", status: "in_progress", parentId: "root-1", companyId: "c1" },
];
const result = pickSyncTargetIssue(candidates);
assert.equal(result.target, null);
assert.equal(result.reason, "no_writable_root");
});
test("שורש יחיד ב-todo: נבחר", () => {
const candidates: SyncCandidate[] = [
{ id: "root-1", status: "todo", parentId: null, companyId: "c1" },
];
const result = pickSyncTargetIssue(candidates);
assert.equal(result.target?.id, "root-1");
assert.equal(result.reason, "ok");
assert.equal(result.writableRoots, 1);
});
// הכרעת #626 (2026-08-26): in_review כבר לא ב-NON_WRITABLE_STATUSES —
// שורש יחיד ב-in_review עכשיו נבחר כיעד-כתיבה, במקום להיחסם.
test("שורש יחיד ב-in_review: נבחר (הכרעת #626 — 2026-08-26)", () => {
const candidates: SyncCandidate[] = [
{ id: "root-1", status: "in_review", parentId: null, companyId: "c1" },
];
const result = pickSyncTargetIssue(candidates);
assert.equal(result.target?.id, "root-1");
assert.equal(result.reason, "ok");
assert.equal(result.writableRoots, 1);
});
test("שורש יחיד ב-blocked: לא נכתב", () => {
const candidates: SyncCandidate[] = [
{ id: "root-1", status: "blocked", parentId: null, companyId: "c1" },
];
const result = pickSyncTargetIssue(candidates);
assert.equal(result.target, null);
assert.equal(result.reason, "no_writable_root");
});
test("isWritableStatus: הגבול המלא בין בר-כתיבה ללא-בר-כתיבה", () => {
assert.equal(isWritableStatus("in_review"), true);
assert.equal(isWritableStatus("blocked"), false);
assert.equal(isWritableStatus("done"), false);
assert.equal(isWritableStatus("cancelled"), false);
assert.equal(isWritableStatus("todo"), true);
});
test("שני שורשים ברי-כתיבה: ambiguous, לא נכתב", () => {
const candidates: SyncCandidate[] = [
{ id: "root-1", status: "todo", parentId: null, companyId: "c1" },
{ id: "root-2", status: "in_progress", parentId: null, companyId: "c1" },
];
const result = pickSyncTargetIssue(candidates);
assert.equal(result.target, null);
assert.equal(result.reason, "ambiguous_writable_roots");
assert.equal(result.writableRoots, 2);
});
test("שורש todo + ילד in_progress: השורש נבחר", () => {
const candidates: SyncCandidate[] = [
{ id: "root-1", status: "todo", parentId: null, companyId: "c1" },
{
id: "child-1",
status: "in_progress",
parentId: "root-1",
companyId: "c1",
},
];
const result = pickSyncTargetIssue(candidates);
assert.equal(result.target?.id, "root-1");
assert.equal(result.reason, "ok");
});
/**
* פיקסצ'ר ריאלי של `/api/status-model` (case_status_model.py) — הסדר קובע
* מי הוא "todo" (האינדקס הראשון), ו-`terminal: true` קובע מי "done".
*/
const STATUS_MODEL: StatusModelEntry[] = [
{
key: "new",
label: "חדש",
description: "תיק נפתח, טרם הועלו מסמכים",
phase: "intake",
selectable: true,
terminal: false,
on_enter: null,
},
{
key: "processing",
label: "בעיבוד",
description: "מסמכים בעיבוד",
phase: "intake",
selectable: false,
terminal: false,
on_enter: null,
},
{
key: "documents_ready",
label: "מסמכים מוכנים",
description: "העיבוד הושלם",
phase: "intake",
selectable: true,
terminal: false,
on_enter: null,
},
{
key: "analyst_verified",
label: 'אומת ע"י אנליסט',
description: "אנליסט אימת את התוכן",
phase: "analysis",
selectable: true,
terminal: false,
on_enter: null,
},
{
key: "research_complete",
label: "מחקר הושלם",
description: "מחקר תקדימים הושלם",
phase: "analysis",
selectable: true,
terminal: false,
on_enter: null,
},
{
key: "outcome_set",
label: "תוצאה נקבעה",
description: "תוצאה הוזנה",
phase: "analysis",
selectable: true,
terminal: false,
on_enter: null,
},
{
key: "direction_approved",
label: "כיוון אושר",
description: "כיוון הכתיבה אושר",
phase: "drafting",
selectable: true,
terminal: false,
on_enter: null,
},
{
key: "qa_review",
label: "בדיקת איכות",
description: "בבדיקת איכות",
phase: "drafting",
selectable: true,
terminal: false,
on_enter: null,
},
{
key: "drafted",
label: "טיוטה מוכנה",
description: "טיוטה נכתבה",
phase: "drafting",
selectable: true,
terminal: false,
on_enter: null,
},
{
key: "exported",
label: "יוצא ל-DOCX",
description: "יוצא כקובץ DOCX",
phase: "review",
selectable: true,
terminal: false,
on_enter: null,
},
{
key: "reviewed",
label: 'נבדק ע"י דפנה',
description: "דפנה הגיהה",
phase: "review",
selectable: true,
terminal: false,
on_enter: null,
},
{
key: "final",
label: "סופי",
description: "גרסה סופית",
phase: "final",
selectable: true,
terminal: true,
on_enter: null,
},
];
test("resolveIssueStatus: הסטטוס הראשון ברשימה (new) → todo", () => {
assert.equal(resolveIssueStatus(STATUS_MODEL, "new"), "todo");
});
test("resolveIssueStatus: סטטוס terminal (final) → done", () => {
assert.equal(resolveIssueStatus(STATUS_MODEL, "final"), "done");
});
test("resolveIssueStatus: analyst_verified (חסר במפה הישנה) → in_progress", () => {
assert.equal(
resolveIssueStatus(STATUS_MODEL, "analyst_verified"),
"in_progress",
);
});
test("resolveIssueStatus: research_complete → in_progress", () => {
assert.equal(
resolveIssueStatus(STATUS_MODEL, "research_complete"),
"in_progress",
);
});
test("resolveIssueStatus: סטטוס לא-מוכר → null (לא בליעה שקטה)", () => {
assert.equal(
resolveIssueStatus(STATUS_MODEL, "totally_unknown_status"),
null,
);
});
test("labelFor: מחזיר את התווית מהפיקסצ'ר, ו-null לסטטוס לא-מוכר", () => {
assert.equal(labelFor(STATUS_MODEL, "new"), "חדש");
assert.equal(labelFor(STATUS_MODEL, "totally_unknown_status"), null);
});
test("רגרסיה: companyId של המועמד-הנבחר שורד את pickSyncTargetIssue (לא companyId חיצוני קבוע)", () => {
const candidates: SyncCandidate[] = [
{
id: "issue-a",
status: "cancelled",
parentId: null,
companyId: "company-a",
},
{
id: "issue-b",
status: "todo",
parentId: null,
companyId: "company-b",
},
];
const result = pickSyncTargetIssue(candidates);
assert.equal(result.target?.id, "issue-b");
assert.equal(result.target?.companyId, "company-b");
});
test("resolveStatusLabel: סטטוס מוכר → תווית מה-SSOT, בלי fallback", () => {
assert.deepEqual(resolveStatusLabel(STATUS_MODEL, "new"), {
label: "חדש",
fallback: null,
});
});
test("resolveStatusLabel: סטטוס שאינו במודל → warning-worthy fallback + ערך גולמי, בלי זריקה", () => {
assert.doesNotThrow(() =>
resolveStatusLabel(STATUS_MODEL, "totally_unknown_status"),
);
assert.deepEqual(resolveStatusLabel(STATUS_MODEL, "totally_unknown_status"), {
label: "totally_unknown_status",
fallback: "unknown_status",
});
});
test("resolveStatusLabel: מודל לא-זמין (null) → model_unavailable, נבדל מסטטוס-לא-מוכר", () => {
assert.deepEqual(resolveStatusLabel(null, "processing"), {
label: "processing",
fallback: "model_unavailable",
});
});
test("רגרסיה #616: כל הסטטוסים שהיו במפה הקשיחה ועודם חיים מקבלים תווית מה-SSOT", () => {
const survivingKeys = [
"new",
"processing",
"documents_ready",
"outcome_set",
"direction_approved",
"qa_review",
"drafted",
"exported",
"reviewed",
"final",
].filter((key) => STATUS_MODEL.some((s) => s.key === key));
for (const key of survivingKeys) {
const result = resolveStatusLabel(STATUS_MODEL, key);
assert.equal(result.fallback, null, `${key}: expected no fallback`);
assert.equal(
typeof result.label,
"string",
`${key}: expected string label`,
);
assert.notEqual(result.label, "", `${key}: expected non-empty label`);
}
});