feat(precedents): איחוד cited_only↔missing_precedents — גזירת פסיקה-חסרה (#143, G2)

שתי מערכות מקבילות לאותו מושג ("פסיקה מצוטטת שטקסטה לא נקלט"): טבלת
missing_precedents (תור-רכישה ידני של היו"ר) מול case_law source_kind='cited_only'
(stubs מגרף-הציטוטים/X11). חפיפה≈0 → 31 ה-stubs לא הופיעו ב-/missing-precedents.

הכרעה (G2): missing_precedents = SoT-לתור-יחיד; cited_only = מקור-גילוי נגזר (כמו
יומונים מזינים radar). גוזרים רשומת missing_precedents 'open' לכל stub.

תיקון:
- court_citation.citation_dedup_key — מפתח-dedup **designator-aware**
  (`{designator}|{docket}`). **מתקן פגם בתוכנית-הניתוח:** dedup על מספר-בלבד היה
  ממזג בטעות אותו docket בערכאות שונות (בג"ץ 389/87 ≠ ע"א 389/87; 18 כאלה בקיים).
- סכמה V40: missing_precedents מקבל citation_norm (מפתח-dedup) + discovery_source
  (manual|cited_only|digest|writer) + index. **בלי UNIQUE** — הקורפוס מחזיק
  לגיטימית אותו docket בערכאות שונות; ייחודיות נאכפת designator-aware בנתיב-היצירה.
- create_missing_precedent: מחשב citation_norm בכתיבה (G1), מקבל discovery_source
  + linked_case_law_id. find_missing_precedent_by_citation: dedup דרך citation_norm
  (fallback ל-citation גולמי כשאין מספר).
- scripts/derive_missing_from_cited_only.py: backfill citation_norm ל-291 +
  גזירת 31 (dry-run: 31 ייווצרו, 0 deduped). linked_case_law_id=stub, status=open
  → promote-in-place בהעלאת-טקסט דרך ON CONFLICT הקיים. אידמפוטנטי.

תלוי-הקשר: #140 (הגדרת cited_only). מתואם עם #136 (digest→MP — אותו citation_norm
+ create path). תיקון-נתון יורץ אחרי הפריסה.

בדיקות: test_dedup_key_is_designator_aware (בג"ץ≠ע"א, ערר≠בל"מ, גרסאות-format
מתמזגות). כל 356 עוברות. guards נקיים.

Invariants: G2 (SoT-לתור יחיד, cited_only נגזר), G1 (citation_norm מנורמל בכתיבה),
G3 (idempotent upsert), G10 (שער-העלאה ידני נשמר), G12.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

scripts/SCRIPTS.md

@@ -34,6 +34,7 @@
 | `legal-metadata-drain.config.cjs` | pm2/js | **תזמון כל 15 דק' של `drain_metadata_queue.py`** (cron `*/15 * * * *`, `METADATA_DRAIN_CRON` לעקיפה) — מונע סתימה של תור חילוץ-המטא ב-/precedents. דורש `GEMINI_API_KEY` ב-`~/.env`. התקנה: `pm2 start scripts/legal-metadata-drain.config.cjs && pm2 save`. | pm2 cron (host-side) |
 | `reconcile_metadata_status.py` | python | **נרמול `metadata_extraction_status` תקוע (G1)** — שורות עם ברירת-המחדל `'pending'` שאינן בצנרת-Gemini נערמות כ-backlog-רפאים שהדריינר (סורק `*_requested_at IS NOT NULL`) לעולם לא מנקה ומנפח את מונה "ממתין" ב-/operations. מיישב כל שורה למצב-אמת במקור: `internal_committee`→`completed` (מטא דטרמיניסטי, מחוץ ל-Gemini), `external_upload` מלא→`completed`, `external_upload` עם טקסט וחסר שם/תקציר→חותם `requested_at` (הדריינר יטפל), `cited_only` (אין טקסט)→`skipped`. **מכסה את שני התורים (#140):** אותו `cited_only→skipped` מוחל גם על `halacha_extraction_status` (תור-תאום, G2). אידמפוטנטי. תיקון-המקור הנלווה ב-`db.create_internal_committee_decision` + מסנן `EXTRACTION_ELIGIBLE_PREDICATE` ב-`list_pending_extraction_requests`. הרצה: `mcp-server/.venv/bin/python scripts/reconcile_metadata_status.py`. | חד-פעמי / re-runnable כהגנת-drift |
 | `reconcile_under_extracted_halacha.py` | python | **#144 — שחזור פסיקה תת-מחולצת** שהושלמה אך עם 0 הלכות למרות ≥3 מקטעי-נימוק (legal_analysis/ruling/conclusion) — חתימת ה-checkpoint-הריק שנוצרה לפני תיקון limit-notice ב-claude_session. מאפס checkpoints + `request_halacha_extraction` (נתיב קנוני, G2) → הדריינר מחלץ מחדש. שמרני (≥3 מקטעים → לא מטפל ב-remand לגיטימי חסר-הלכה; אפס אובדן כי 0 הלכות ממילא). מחריג cited_only. אידמפוטנטי, dry-run כברירת-מחדל / `--apply`. הרצה: `HOME=/home/chaim mcp-server/.venv/bin/python scripts/reconcile_under_extracted_halacha.py --apply`. | חד-פעמי / re-runnable |
+| `derive_missing_from_cited_only.py` | python | **#143 — איחוד cited_only↔missing_precedents (G2)**: גוזר רשומת `missing_precedents` 'open' לכל stub `cited_only` (פסיקה מצוטטת ללא טקסט), כך ש-31 ה-stubs מופיעים בדף "פסיקה חסרה" (היו היו חפיפה≈0). (1) backfill `citation_norm` (מפתח-dedup designator-aware — `court_citation.citation_dedup_key`) ל-291 הקיימים; (2) לכל stub → `create_missing_precedent(discovery_source='cited_only', linked_case_law_id=stub, notes=מצטטים)` עם dedup. `linked_case_law_id`=זהות-קנונית-ידועה, `status='open'` עד העלאת-טקסט (→ promote-in-place דרך ON CONFLICT). אידמפוטנטי, dry-run / `--apply`. הרצה: `HOME=/home/chaim mcp-server/.venv/bin/python scripts/derive_missing_from_cited_only.py --apply`. | חד-פעמי / re-runnable |
 | `backfill_plans_registry.py` | python | **ייבוא מרשם-התכניות (V38) מקורפוס-ההחלטות** — סורק `data/cases/*/drafts/decision.md` + `data/training/cmp/*.md`, מאתר פסקאות-תוקף ("פורסמה למתן תוקף"), מחלץ רשומת-תכנית מובנית (`plans_extractor`, claude CLI מקומי) ועושה `upsert_plan(review_status='pending_review')` עם provenance. ה-SSOT לזהות+תוקף של תכנית, פעם-אחת במקום גזירה-מחדש מהשומות בכל תיק (G2). idempotent על plan_number מנורמל (G1/G3). `--dry-run` (ברירת-מחדל, כלום לא נכתב) / `--apply` / `--glob` (תת-קבוצה). אחרי הרצה: אישור-יו"ר ב-`plan_review`/תור-האישור (G10). הרץ: `mcp-server/.venv/bin/python scripts/backfill_plans_registry.py`. | ידני (חד-פעמי + לפי-צורך כשנוספות החלטות) |
 | `backfill_precedent_citations.py` | python | **#145** — backfill ל-`citation_formatted` (מראה-מקום) ברשומות `case_law` ריקות, באמצעות `db.format_precedent_citation` הדטרמיניסטי (X1 §3 / INV-ID2 — שדה-תצוגה נגזר, לא מעוצב ע"י LLM ש-הפיל אותו, #145). שני מעברים לכל שורה: (1) **ללא-LLM** — הרכבה מהשדות השמורים (ממלא שורות-ועדה עם parties+docket+date); (2) **LLM** — אם (1) נמנע ויש full_text, מריץ את מחלץ-המטא (extract_and_apply) שמחלץ רכיבים (parties, citation_prefix) ואז מרכיב — זה ממלא את 171 פסקי-בתי-המשפט מהכותרת. שורות בלי רובריקה (אין צדדים) נשארות ריקות ומדווחות, לא מנוחשות (INV-AH). idempotent — רק שדה ריק (G3). `--apply` / `--limit N` / `--no-llm`. הרץ: `HOME=/home/chaim mcp-server/.venv/bin/python scripts/backfill_precedent_citations.py`. | ידני (חד-פעמי + לפי-צורך) |
 | `auto-sync-cases.sh` | bash | סנכרון תיקי ערר ל-Gitea — רץ כל דקה | `* * * * *` (cron) |

scripts/derive_missing_from_cited_only.py

@@ -0,0 +1,113 @@
+"""Derive missing_precedents 'open' gaps from cited_only stubs (#143, G2).
+
+Two parallel systems described the same concept — "a cited precedent whose text
+isn't in the corpus": the ``missing_precedents`` queue (the chair's acquisition
+list) and ``case_law`` rows with ``source_kind='cited_only'`` (citation-only
+stubs seeded by the X11 / corpus-graph). Overlap was ~0, so the 31 cited_only
+stubs never surfaced on /missing-precedents.
+
+This makes ``missing_precedents`` the single source-of-truth FOR THE QUEUE and
+``cited_only`` a DERIVED discovery source (like digests feed the radar):
+  1. Backfill ``citation_norm`` (designator-aware dedup key) for every existing
+     missing_precedent — required before the dedup below can match.
+  2. For each cited_only stub, derive an 'open' missing_precedent (deduped on
+     citation_norm), with ``discovery_source='cited_only'``,
+     ``linked_case_law_id`` = the stub (its canonical identity is known; status
+     stays 'open' until the text is uploaded → promote-in-place), and notes
+     listing the precedents that cite it.
+
+Idempotent / re-runnable. Dry-run by default; ``--apply`` to write.
+Host-only. Run:
+    HOME=/home/chaim mcp-server/.venv/bin/python scripts/derive_missing_from_cited_only.py [--apply]
+"""
+
+from __future__ import annotations
+
+import asyncio
+import os
+import sys
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "mcp-server", "src"))
+
+from legal_mcp.services import court_citation, db
+
+
+async def _backfill_citation_norm(pool, apply: bool) -> int:
+    rows = await pool.fetch(
+        "SELECT id, citation FROM missing_precedents "
+        "WHERE COALESCE(citation_norm, '') = ''"
+    )
+    n = 0
+    for r in rows:
+        norm = court_citation.citation_dedup_key(r["citation"] or "")
+        if not norm:
+            continue
+        if apply:
+            await pool.execute(
+                "UPDATE missing_precedents SET citation_norm = $2 WHERE id = $1",
+                r["id"], norm,
+            )
+        n += 1
+    return n
+
+
+async def _citing_precedents_note(pool, stub_id) -> str:
+    rows = await pool.fetch(
+        """SELECT DISTINCT cl.case_number
+           FROM precedent_internal_citations p
+           JOIN case_law cl ON cl.id = p.source_case_law_id
+           WHERE p.cited_case_law_id = $1 AND COALESCE(cl.case_number,'') <> ''
+           ORDER BY cl.case_number LIMIT 8""",
+        stub_id,
+    )
+    citers = [r["case_number"] for r in rows]
+    base = "נגזר מ-cited_only (גרף-הציטוטים)"
+    if citers:
+        return f"{base}; מצוטט ע\"י: {', '.join(citers)}"
+    return base
+
+
+async def main(apply: bool) -> int:
+    pool = await db.get_pool()
+
+    backfilled = await _backfill_citation_norm(pool, apply)
+    print(f"citation_norm backfill (existing rows){'' if apply else ' [dry]'}: {backfilled}")
+
+    stubs = await pool.fetch(
+        "SELECT id, case_number, case_name FROM case_law "
+        "WHERE source_kind = 'cited_only' ORDER BY case_number"
+    )
+    print(f"cited_only stubs: {len(stubs)}")
+
+    created = 0
+    skipped = 0
+    for s in stubs:
+        citation = (s["case_number"] or "").strip()
+        if not citation:
+            print(f"  SKIP (no case_number) id={s['id']}")
+            continue
+        existing = await db.find_missing_precedent_by_citation(citation)
+        if existing:
+            skipped += 1
+            continue
+        norm = court_citation.citation_dedup_key(citation)
+        print(f"  + {citation:<22} norm={norm!r} name={(s['case_name'] or '')[:24]!r}")
+        if apply:
+            note = await _citing_precedents_note(pool, s["id"])
+            await db.create_missing_precedent(
+                citation=citation,
+                case_name=s["case_name"] or None,
+                discovery_source="cited_only",
+                linked_case_law_id=s["id"],
+                notes=note,
+            )
+        created += 1
+
+    print(f"\n{'created' if apply else 'would create'}: {created}   already-present (deduped): {skipped}")
+    if not apply:
+        print("(dry-run — pass --apply to write)")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(asyncio.run(main("--apply" in sys.argv)))