docs(paperclip-quirks): §5 — pruned npx cache → 500/crash-loop + fix #99

chaim · 2026-06-06T21:24:36Z

chaim commented

2026-06-06 21:24:36 +00:00

מה

מתעד ב-docs/paperclip-quirks.md §5 את התקלה מ-06/06/26: מחיקת ה-npx cache של Paperclip גרמה ל-GET / → 500 (ui-dist מחוק) ול-crash-loop בריסטארט (השרת קורס על assertCloudDatabaseContract() לפני שלולאת-הרקע מחילה את ה-bypass).

תיקון משויך

ההקשחה עצמה ב-paperclip-config (commit c824e0f) — שער סינכרוני ensure_patched_before_run() שמחלץ דרך --help ומתקן לפני exec. אומת מקצה-לקצה: מחיקת cache + restart → התאוששות אוטומטית ~72ש', אפס crash-loop.

Invariants

docs-only — לא נוגע בנתיב-קוד G*/INV-*.

🤖 Generated with Claude Code

## מה מתעד ב-`docs/paperclip-quirks.md` §5 את התקלה מ-06/06/26: מחיקת ה-npx cache של Paperclip גרמה ל-`GET /` → 500 (ui-dist מחוק) ול-crash-loop בריסטארט (השרת קורס על `assertCloudDatabaseContract()` לפני שלולאת-הרקע מחילה את ה-bypass). ## תיקון משויך ההקשחה עצמה ב-`paperclip-config` (commit c824e0f) — שער סינכרוני `ensure_patched_before_run()` שמחלץ דרך `--help` ומתקן לפני `exec`. אומת מקצה-לקצה: מחיקת cache + restart → התאוששות אוטומטית ~72ש', אפס crash-loop. ## Invariants docs-only — לא נוגע בנתיב-קוד G*/INV-*. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

chaim added 1 commit 2026-06-06 21:24:36 +00:00

docs(paperclip-quirks): §5 — pruned npx cache → 500/crash-loop + fix e239915fd3

Document the failure mode hit on 06/06/26: a pruned npx cache makes the
running paperclip serve GET / → 500 (deleted ui-dist) and, on restart,
crash-loop because the server's startup assertCloudDatabaseContract()
out-races the post-exec patch loop.

Records the synchronous pre-extract+patch gate now in start-paperclip.sh
(paperclip-config c824e0f), the `--help` clean-extract trick, the three
bugs found while building the fix (ui-dist vs dist marker, set -e on patch
failure, pkill -f self-match), the manual recovery runbook, and the e2e
verification.

Invariants: docs-only; touches no G*/INV-* code paths.

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

chaim merged commit ab99cfa1d3 into main

2026-06-06 21:24:42 +00:00

chaim deleted branch worktree-pc-quirks-doc

2026-06-06 21:24:42 +00:00

chaim referenced this issue from a commit

2026-06-06 21:24:44 +00:00

Merge pull request 'docs(paperclip-quirks): §5 — pruned npx cache → 500/crash-loop + fix' (#99) from worktree-pc-quirks-doc 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#99