diff --git a/docs/plans/2026-05-29-036-docs-lfg-merge-ready-stamp-plan.md b/docs/plans/2026-05-29-036-docs-lfg-merge-ready-stamp-plan.md new file mode 100644 index 00000000..fe9346b0 --- /dev/null +++ b/docs/plans/2026-05-29-036-docs-lfg-merge-ready-stamp-plan.md @@ -0,0 +1,27 @@ +--- +title: docs: LFG merge-ready stamp +type: docs +status: complete +date: 2026-05-29 +origin: /lfg — recurring scrape validated on host; document merge-ready state +--- + +# docs: LFG merge-ready stamp + +## Summary + +Recurring scrape is validated offline (19 smokes), live (`run-operator-proof` on `eod_discord`), and scheduled (monthly cron installed). Stamp merge-readiness and operator checklist accordingly. + +## Requirements + +| ID | Requirement | +|----|-------------| +| R1 | `docs/recurring-scrape-merge-readiness.md` has explicit merge-ready / host-activation status | +| R2 | `docs/recurring-scrape-operator-checklist.md` reflects post-live-proof path | +| R3 | `sync-gui-bridge-doc.sh` run; 19 smokes pass | +| R4 | PR #1538 updated with plan 036 closure | + +## Verification + +- `DCE_MIN_FREE_MB=0 ./scripts/run-all-smokes.sh` +- `./scripts/setup-cron.sh --dry-run` (preflight all enabled targets) diff --git a/docs/recurring-scrape-merge-readiness.md b/docs/recurring-scrape-merge-readiness.md index a77f4a71..ffcc12be 100644 --- a/docs/recurring-scrape-merge-readiness.md +++ b/docs/recurring-scrape-merge-readiness.md @@ -1,5 +1,16 @@ # Recurring scrape — merge readiness +## Branch status (2026-05-29) + +| Gate | Status | +|------|--------| +| Offline smokes (`run-all-smokes.sh`) | 19/19 pass | +| Live proof (`run-operator-proof.sh --sync-gui --target eod_discord`) | Passed on maintainer host | +| Monthly cron (`setup-cron.sh`) | Installed (`00 04 1 * *`); dry-run preflight OK for all enabled targets | +| Upstream CI (fork PR) | `action_required` until Tyrrrz approves workflow runs | + +**Merge-ready** for upstream review. Further feature work should use a new branch; avoid additional `/lfg` passes unless scope changes. + Fork branch `feat/recurring-cli-scrape` adds append-only, Docker-based incremental exports with optional monthly cron. Intended for personal archive trees under a configurable `archive_root` (for example `~/Documents/*`). GUI zip users: [docs/gui-zip-recurring-scrape-bridge.md](gui-zip-recurring-scrape-bridge.md). diff --git a/docs/recurring-scrape-operator-checklist.md b/docs/recurring-scrape-operator-checklist.md index 18a545c2..3d70dd92 100644 --- a/docs/recurring-scrape-operator-checklist.md +++ b/docs/recurring-scrape-operator-checklist.md @@ -10,7 +10,8 @@ Use this after cloning or opening the **source** repo (`DiscordChatExporter`, no 2. `./scripts/bootstrap-recurring-scrape.sh --dry-run` — confirm every **enabled** target has seeded JSON under `output_dir`. 3. `./scripts/bootstrap-recurring-scrape.sh` — verify archives, build image, preflight Discord. 4. `./scripts/run-documents-scrape.sh` — first incremental append-only scrape. -5. `./scripts/prove-incremental-append.sh --target ` — optional grow-only proof. + Or `./scripts/run-operator-proof.sh --sync-gui --target ` — handoff + scrape + grow-only proof in one step. +5. `./scripts/prove-incremental-append.sh --target ` — optional if you did not use `run-operator-proof.sh`. 6. `./scripts/audit-archive-json.sh` — optional; lists invalid JSON before cron runs. ## Monthly automation