mirror of
https://github.com/Tyrrrz/DiscordChatExporter.git
synced 2026-06-10 00:02:37 -06:00
docs(scrape): stamp merge-ready after host validation
Document offline/live/cron gates; align operator checklist with run-operator-proof.
This commit is contained in:
parent
a4f080e6d9
commit
0b242ddfc4
27
docs/plans/2026-05-29-036-docs-lfg-merge-ready-stamp-plan.md
Normal file
27
docs/plans/2026-05-29-036-docs-lfg-merge-ready-stamp-plan.md
Normal file
|
|
@ -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)
|
||||||
|
|
@ -1,5 +1,16 @@
|
||||||
# Recurring scrape — merge readiness
|
# 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/*`).
|
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).
|
GUI zip users: [docs/gui-zip-recurring-scrape-bridge.md](gui-zip-recurring-scrape-bridge.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`.
|
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.
|
3. `./scripts/bootstrap-recurring-scrape.sh` — verify archives, build image, preflight Discord.
|
||||||
4. `./scripts/run-documents-scrape.sh` — first incremental append-only scrape.
|
4. `./scripts/run-documents-scrape.sh` — first incremental append-only scrape.
|
||||||
5. `./scripts/prove-incremental-append.sh --target <name>` — optional grow-only proof.
|
Or `./scripts/run-operator-proof.sh --sync-gui --target <name>` — handoff + scrape + grow-only proof in one step.
|
||||||
|
5. `./scripts/prove-incremental-append.sh --target <name>` — optional if you did not use `run-operator-proof.sh`.
|
||||||
6. `./scripts/audit-archive-json.sh` — optional; lists invalid JSON before cron runs.
|
6. `./scripts/audit-archive-json.sh` — optional; lists invalid JSON before cron runs.
|
||||||
|
|
||||||
## Monthly automation
|
## Monthly automation
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue