ezer-mishpati/legal-ai
1
0
Fork 0
Code Issues 29 Pull Requests 1 Actions 1 Packages Projects Releases Wiki Activity

Escalation primitive מדורג-חומרה בשער-הפלטפורמה (השראת Gastown gt escalate) #448

New Issue
Open
opened 2026-08-05 11:01:16 +00:00 by chaim · 0 comments
chaim commented 2026-08-05 11:01:16 +00:00
Owner
Copy Link

What & Why

להוסיף פרימיטיב escalation מוצהר (CRITICAL/HIGH/MEDIUM) לשער-הפלטפורמה (X15/agent_platform_port) שמחליף את ריקוד ה"המתנה-לאדם" השביר (reassign-to-chaim + in_review + interaction) שמייצר לולאות stranded_assigned_issue.

הקשר ופירוט

מקור-השראה: Gastown gt escalate (github.com/gastownhall/gastown) — severity-routed escalation, Deacon→Mayor→Overseer.

הבעיה אצלנו (reference_paperclip_recovery_loops): "ממתין-לאדם" נגזר מצירוף שביר של status+assignee+comment-recency; חוסר-דיוק → source_scoped_recovery_action / stranded_assigned_issue / issue_continuation_needed בלולאה אינסופית (~כל 10 דק', burning budget). הפתרון הידני החוזר = human-owned end state {status:done, assigneeAgentId:null, assigneeUserId:chaim}.

מטרה: להפוך את זה מ-heuristic ידני ל-disposition מוצהר first-class בשער.

  • API/פורט: escalate(issueId, severity, reason) שמבצע את מעבר-המצב האטומי הנכון פעם אחת (assigneeAgentId:null + assigneeUserId:human + status) במקום שכל heartbeat ינחש.
  • לוודא G12: כל מגע-Paperclip רק ב-web/agent_platform_port.py + המעטפת המוצהרת. אסור סמל ספציפי-Paperclip ב-mcp-server/src.
  • לחבר ל-HEARTBEAT: סוכן שנתקע קורא escalate במקום להשאיר issue in_progress+prose.
  • UI: תור-הסלמות מדורג ב-/operations או agents-tab (מקביל ל-gt escalate list).
    קשור: docs/spec/X15-agent-platform-port.md, reference_paperclip_recovery_loops, reference_recovery_loop_stranded_child.

Acceptance Criteria

⚠️ טרם הוגדרו. המשימה הועברה מ-TaskMaster ללא testStrategy.
לפני לקיחתה — להגדיר AC ולסמן status:ready (כלל התבנית: issue ללא AC אינו pickable).

הועבר מ-TaskMaster (tag legal-ai, id 218, status היה in-progress) ב-2026-08-05. הפניות (#218) בהודעות-commit ישנות מתייחסות למזהה ה-TaskMaster, לא למספר ה-issue הזה.

## What & Why להוסיף פרימיטיב escalation מוצהר (CRITICAL/HIGH/MEDIUM) לשער-הפלטפורמה (X15/agent_platform_port) שמחליף את ריקוד ה"המתנה-לאדם" השביר (reassign-to-chaim + in_review + interaction) שמייצר לולאות stranded_assigned_issue. ## הקשר ופירוט מקור-השראה: Gastown gt escalate (github.com/gastownhall/gastown) — severity-routed escalation, Deacon→Mayor→Overseer. הבעיה אצלנו (reference_paperclip_recovery_loops): "ממתין-לאדם" נגזר מצירוף שביר של status+assignee+comment-recency; חוסר-דיוק → source_scoped_recovery_action / stranded_assigned_issue / issue_continuation_needed בלולאה אינסופית (~כל 10 דק', burning budget). הפתרון הידני החוזר = human-owned end state {status:done, assigneeAgentId:null, assigneeUserId:chaim}. מטרה: להפוך את זה מ-heuristic ידני ל-disposition מוצהר first-class בשער. - API/פורט: escalate(issueId, severity, reason) שמבצע את מעבר-המצב האטומי הנכון פעם אחת (assigneeAgentId:null + assigneeUserId:human + status) במקום שכל heartbeat ינחש. - לוודא G12: כל מגע-Paperclip רק ב-web/agent_platform_port.py + המעטפת המוצהרת. אסור סמל ספציפי-Paperclip ב-mcp-server/src. - לחבר ל-HEARTBEAT: סוכן שנתקע קורא escalate במקום להשאיר issue in_progress+prose. - UI: תור-הסלמות מדורג ב-/operations או agents-tab (מקביל ל-gt escalate list). קשור: docs/spec/X15-agent-platform-port.md, reference_paperclip_recovery_loops, reference_recovery_loop_stranded_child. ## Acceptance Criteria > ⚠️ **טרם הוגדרו.** המשימה הועברה מ-TaskMaster ללא `testStrategy`. > לפני לקיחתה — להגדיר AC ולסמן `status:ready` (כלל התבנית: issue ללא AC אינו pickable). --- <sub>הועבר מ-TaskMaster (tag `legal-ai`, id **218**, status היה `in-progress`) ב-2026-08-05. הפניות `(#218)` בהודעות-commit ישנות מתייחסות למזהה ה-TaskMaster, לא למספר ה-issue הזה.</sub>
chaim added the area:agentsstatus:in-progresstype:featurepriority:p1-high labels 2026-08-05 11:01:16 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area:agents
סוכני Paperclip, תזמור, שער-הפלטפורמה (X15)
 area:backend
FastAPI web/, endpoints
 area:ci
Gitea Actions, שערי-CI
 area:docs
ספ-המערכת, תיעוד, תכנון
 area:extraction
קליטה, OCR, חילוץ הלכות/מטא/טענות/תכניות
 area:frontend
web-ui/ (Next.js), RTL
 area:infra
Deploy, Coolify, MinIO, אחסון, גיבויים
 area:mcp
שרת ה-MCP וחוזה-הכלים (X9)
 area:retrieval
RAG, חיפוש, קורפוס, גרף-ציטוטים, יומונים
 area:security
אבטחה, סודות, PII, audit
 area:writing
12 הבלוקים, סגנון דפנה, QA, רכישת-סגנון
 priority:p0-blocker
Blocks everything
 priority:p1-high
High priority
 priority:p2-normal
Normal priority
 priority:p3-low
Low priority / nice to have
 size:l
a week+ — consider splitting
 size:m
2-3 days
 size:s
~1 day
 size:xs
< half a day
 status:blocked
Waiting on another issue/decision
 status:deferred
Decided to defer — parked backlog; not auto-picked
 status:good-first-issue
Small, self-contained starting point
 status:in-progress
Being worked on (a branch/worktree exists)
 status:in-review
A PR is open for this issue
 status:needs-decision
Requires a call before proceeding
 status:ready
Scoped + pickable (has acceptance criteria + size)
 type:bug
Something works incorrectly
 type:chore
Infra, deps, refactor, CI, docs
 type:feature
New capability
 type:spike
Time-boxed investigation -> a decision/doc
No Label area:agents priority:p1-high status:in-progress type:feature
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
chaim
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ezer-mishpati/legal-ai#448
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?