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

Molecules — פייפליין 12-הבלוקים כתבנית הצהרתית עם checkpoint-recovery (השראת Gastown formulas) #451

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

What & Why

להפוך את תזמור פייפליין 12-הבלוקים מלוגיקה אד-הוק בפרומפט ה-CEO לתבנית-workflow הצהרתית עם צעדים, תלויות (needs), ו-checkpoint-recovery per-step — הבשלה של יעד X16.

הקשר ופירוט

מקור-השראה: Gastown Molecules/Formulas — workflow templates ב-TOML הצהרתי, צעדים עם needs (תלויות), materialization עם checkpoint recovery (root-only wisps vs poured wisps).

הבעיה אצלנו: פייפליין 12-הבלוקים (analyst→researcher→writer→qa→ceo) מתוזמר אד-הוק ע"י ה-CEO; הלוגיקה מפוזרת בפרומפטים. X16 (LangGraph checkpointing) כבר חותר לכיוון resumability, אבל אין הגדרה הצהרתית-אחת של הפייפליין כנתון.

מטרה: הגדרת-פייפליין הצהרתית אחת (מקור-אמת יחיד, G2) עם צעדים+תלויות+checkpoint per-step, שממנה גם ה-CEO וגם ה-durability layer עובדים — במקום לוגיקה כפולה.

  • זו יוזמה, לא טלאי — לתאם עם project_platform_port_and_durability (X16) ולא ליצור מסלול מקביל.
  • לבחון: האם LangGraph graph-definition כבר יכול לשמש כ"formula", או צריך שכבת-הגדרה מעליו.
  • שער-ספ: docs/spec/X16-pipeline-durability.md לפני קוד.
    קשור: project_platform_port_and_durability, docs/block-schema.md, docs/spec/00-constitution.md (G2).

ממצא 2026-07-07 (אחרי מיזוג #219/#218/#222/#220): 221 סובסם ברובו ע"י X16. scripts/_pipeline_runtime.py כבר מממש את מנוע-ה'molecule' — Step(name, run) מסודרים ל-LangGraph StateGraph עם SqliteSaver checkpointing/resume, משותף לשני הפייפליינים (G2). כלומר 'formula עם checkpoint-recovery' קיים.
התוספת היחידה של Gastown מעבר לכך = הגדרה הצהרתית עם needs-DAG במקום רשימה-ליניארית — אבל הפייפליינים שלנו 3-4 שלבים ליניאריים (YAGNI, אין צרכן ל-DAG), ופייפליין 12-הבלוקים אסור לעבור ל-LangGraph (X16 §1 אוסר orchestrator-סוכנים — הפרת G2/G12). לכן בניית מסגרת-formula הצהרתית כעת = מסלול מקביל ל-_pipeline_runtime (הפרת G2). deferred עד שיופיע פייפליין דטרמיניסטי שדורש branching/needs; אז להרחיב את _pipeline_runtime הקיים (לא מסגרת חדשה).

Acceptance Criteria

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

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

## What & Why להפוך את תזמור פייפליין 12-הבלוקים מלוגיקה אד-הוק בפרומפט ה-CEO לתבנית-workflow הצהרתית עם צעדים, תלויות (needs), ו-checkpoint-recovery per-step — הבשלה של יעד X16. ## הקשר ופירוט מקור-השראה: Gastown Molecules/Formulas — workflow templates ב-TOML הצהרתי, צעדים עם needs (תלויות), materialization עם checkpoint recovery (root-only wisps vs poured wisps). הבעיה אצלנו: פייפליין 12-הבלוקים (analyst→researcher→writer→qa→ceo) מתוזמר אד-הוק ע"י ה-CEO; הלוגיקה מפוזרת בפרומפטים. X16 (LangGraph checkpointing) כבר חותר לכיוון resumability, אבל אין הגדרה הצהרתית-אחת של הפייפליין כנתון. מטרה: הגדרת-פייפליין הצהרתית אחת (מקור-אמת יחיד, G2) עם צעדים+תלויות+checkpoint per-step, שממנה גם ה-CEO וגם ה-durability layer עובדים — במקום לוגיקה כפולה. - זו יוזמה, לא טלאי — לתאם עם project_platform_port_and_durability (X16) ולא ליצור מסלול מקביל. - לבחון: האם LangGraph graph-definition כבר יכול לשמש כ"formula", או צריך שכבת-הגדרה מעליו. - שער-ספ: docs/spec/X16-pipeline-durability.md לפני קוד. קשור: project_platform_port_and_durability, docs/block-schema.md, docs/spec/00-constitution.md (G2). --- ממצא 2026-07-07 (אחרי מיזוג #219/#218/#222/#220): **221 סובסם ברובו ע"י X16.** scripts/_pipeline_runtime.py כבר מממש את מנוע-ה'molecule' — Step(name, run) מסודרים ל-LangGraph StateGraph עם SqliteSaver checkpointing/resume, משותף לשני הפייפליינים (G2). כלומר 'formula עם checkpoint-recovery' קיים. התוספת היחידה של Gastown מעבר לכך = הגדרה הצהרתית עם needs-DAG במקום רשימה-ליניארית — אבל הפייפליינים שלנו 3-4 שלבים ליניאריים (YAGNI, אין צרכן ל-DAG), ופייפליין 12-הבלוקים אסור לעבור ל-LangGraph (X16 §1 אוסר orchestrator-סוכנים — הפרת G2/G12). לכן בניית מסגרת-formula הצהרתית כעת = מסלול מקביל ל-_pipeline_runtime (הפרת G2). deferred עד שיופיע פייפליין דטרמיניסטי שדורש branching/needs; אז להרחיב את _pipeline_runtime הקיים (לא מסגרת חדשה). ## Acceptance Criteria > ⚠️ **טרם הוגדרו.** המשימה הועברה מ-TaskMaster ללא `testStrategy`. > לפני לקיחתה — להגדיר AC ולסמן `status:ready` (כלל התבנית: issue ללא AC אינו pickable). --- <sub>הועבר מ-TaskMaster (tag `legal-ai`, id **221**, status היה `deferred`) ב-2026-08-05. הפניות `(#221)` בהודעות-commit ישנות מתייחסות למזהה ה-TaskMaster, לא למספר ה-issue הזה.</sub>
chaim added the status:deferredpriority:p2-normalarea:agentstype:feature labels 2026-08-05 11:01:18 +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:p2-normal status:deferred 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#451
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?