docs(spec): Path A — prospective held-out style-distance trend (07-learning §0.7) #338

chaim · 2026-06-28T21:16:28Z

chaim commented

2026-06-28 21:16:28 +00:00

מתעד ב-docs/spec/07-learning.md את מסלול A שנפרס ב-PR #337.

§0.7 חדש — מדד-ההכללה הפרוספקטיבי: למה held-out רטרואקטיבי בלתי-אפשרי (לקחים universal ללא תיוג-מקור → אין leave-one-out), והמנגנון הפרוספקטיבי (snapshot של style_distance + גודל-בריכה בהעלאת-סופי, לפני fold) → style_distance_history + GET /api/learning/style-distance-history.
חיווט שלב [7] MEASUREMENT ו-INV-LRN4 ל-§0.7.
מתועד: בלבול change_percent (סגנון↔תוכן) + חלון-נקי חד-פעמי (אין backfill).

Invariants: INV-LRN4 (זהו משטח-המגמה שלו), G2 (שימוש-חוזר ב-style_distance + appeal_type_rules — אין מסלול-מדד מקביל).

תיעוד בלבד — אין שינוי-קוד, אין deploy.

🤖 Generated with Claude Code

מתעד ב-`docs/spec/07-learning.md` את מסלול A שנפרס ב-PR #337. - **§0.7 חדש** — מדד-ההכללה הפרוספקטיבי: למה held-out רטרואקטיבי בלתי-אפשרי (לקחים `universal` ללא תיוג-מקור → אין leave-one-out), והמנגנון הפרוספקטיבי (snapshot של `style_distance` + גודל-בריכה בהעלאת-סופי, לפני fold) → `style_distance_history` + `GET /api/learning/style-distance-history`. - חיווט שלב **[7] MEASUREMENT** ו-**INV-LRN4** ל-§0.7. - מתועד: בלבול change_percent (סגנון↔תוכן) + חלון-נקי חד-פעמי (אין backfill). **Invariants:** INV-LRN4 (זהו משטח-המגמה שלו), G2 (שימוש-חוזר ב-style_distance + appeal_type_rules — אין מסלול-מדד מקביל). תיעוד בלבד — אין שינוי-קוד, אין deploy. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

chaim added 1 commit 2026-06-28 21:16:29 +00:00

docs(spec): add Path A — prospective held-out style-distance trend (07-learning §0.7)

G12 Leak-Guard / leak-guard (pull_request) Successful in 4s

Details

Lint — undefined names / undefined-names (pull_request) Successful in 10s

Details

927be5c6bb

Documents the prospective held-out methodology shipped in PR #337: why a clean
retrospective held-out is impossible (lessons stored universal/untagged → no
leave-one-out), and how the system instead captures a clean generalization
datapoint at final-upload — before this case's lessons are folded — via a
style_distance snapshot + lesson-pool size into style_distance_history,
surfaced by GET /api/learning/style-distance-history.

Adds §0.7, wires step [7] MEASUREMENT and INV-LRN4 to it. Notes the
change_percent style/content confound and the one-time clean window.

Invariants documented: INV-LRN4 (this is its trend surface), G2 (reuses
style_distance + appeal_type_rules — no parallel metric path).

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

chaim merged commit c00e7b4f49 into main

2026-06-28 21:16:36 +00:00

chaim deleted branch worktree-spec-path-a

2026-06-28 21:16:36 +00:00

chaim referenced this issue from a commit

2026-06-28 21:16:36 +00:00

Merge pull request 'docs(spec): Path A — prospective held-out style-distance trend (07-learning §0.7)' (#338) from worktree-spec-path-a into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: ezer-mishpati/legal-ai#338