mirror of
https://github.com/Tyrrrz/DiscordChatExporter.git
synced 2026-06-10 00:02:37 -06:00
docs(scrape): sync smoke inventory to 23 offline tests
Add print-scrape-summary and scrape-summary-json smokes to the setup table and update merge-readiness gate count from 21/21 to 23/23.
This commit is contained in:
parent
c8ed19d26b
commit
33faba74d6
|
|
@ -326,7 +326,7 @@ Space requirements:
|
||||||
|
|
||||||
## Smoke test validation
|
## Smoke test validation
|
||||||
|
|
||||||
Run the full offline suite from the repo root (requires `jq`). **21 offline smokes** run by default; add `--include-container` for a 22nd local-only check:
|
Run the full offline suite from the repo root (requires `jq`). **23 offline smokes** run by default; add `--include-container` for a 24th local-only check:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
./scripts/run-all-smokes.sh
|
./scripts/run-all-smokes.sh
|
||||||
|
|
@ -357,6 +357,7 @@ With Docker/Podman, include the container smoke:
|
||||||
| `error-path-smoke.sh` | yes | Failure paths |
|
| `error-path-smoke.sh` | yes | Failure paths |
|
||||||
| `gh-approve-pr-runs-smoke.sh` | yes | Fork PR workflow helper |
|
| `gh-approve-pr-runs-smoke.sh` | yes | Fork PR workflow helper |
|
||||||
| `operator-handoff-smoke.sh` | yes | Operator handoff dry-run |
|
| `operator-handoff-smoke.sh` | yes | Operator handoff dry-run |
|
||||||
|
| `print-scrape-summary-smoke.sh` | yes | JSON summary pretty-print CLI |
|
||||||
| `prove-incremental-append-smoke.sh` | yes | Offline prove snapshot/compare |
|
| `prove-incremental-append-smoke.sh` | yes | Offline prove snapshot/compare |
|
||||||
| `run-discord-scrape-host-lock-smoke.sh` | yes | Archive-root scrape lock |
|
| `run-discord-scrape-host-lock-smoke.sh` | yes | Archive-root scrape lock |
|
||||||
| `run-discord-scrape-host-smoke.sh` | yes | Host wrapper |
|
| `run-discord-scrape-host-smoke.sh` | yes | Host wrapper |
|
||||||
|
|
@ -365,6 +366,7 @@ With Docker/Podman, include the container smoke:
|
||||||
| `run-operator-validation-smoke.sh` | yes | Validation runner dry-run |
|
| `run-operator-validation-smoke.sh` | yes | Validation runner dry-run |
|
||||||
| `scrape-here-smoke.sh` | yes | Workspace bridge launcher |
|
| `scrape-here-smoke.sh` | yes | Workspace bridge launcher |
|
||||||
| `scrape-lock-status-smoke.sh` | yes | Lock status + stale reclaim |
|
| `scrape-lock-status-smoke.sh` | yes | Lock status + stale reclaim |
|
||||||
|
| `scrape-summary-json-smoke.sh` | yes | Log marker extract + per-target path helper |
|
||||||
| `setup-cron-smoke.sh` | yes | Cron setup dry-run |
|
| `setup-cron-smoke.sh` | yes | Cron setup dry-run |
|
||||||
| `sync-gui-bridge-doc-smoke.sh` | yes | GUI bridge doc sync |
|
| `sync-gui-bridge-doc-smoke.sh` | yes | GUI bridge doc sync |
|
||||||
| `verify-documents-auth-smoke.sh` | yes | Archive verify + auth bootstrap |
|
| `verify-documents-auth-smoke.sh` | yes | Archive verify + auth bootstrap |
|
||||||
|
|
|
||||||
52
docs/plans/2026-06-04-077-docs-smoke-inventory-23-plan.md
Normal file
52
docs/plans/2026-06-04-077-docs-smoke-inventory-23-plan.md
Normal file
|
|
@ -0,0 +1,52 @@
|
||||||
|
---
|
||||||
|
title: "docs: Sync smoke inventory to 23 offline tests"
|
||||||
|
type: docs
|
||||||
|
status: complete
|
||||||
|
date: 2026-06-04
|
||||||
|
origin: /lfg — plan 062 deferred refresh; plans 071/074 added smokes not reflected in setup doc or merge-readiness header
|
||||||
|
---
|
||||||
|
|
||||||
|
# docs: Sync smoke inventory to 23 offline tests
|
||||||
|
|
||||||
|
## Summary
|
||||||
|
|
||||||
|
Update `.docs/Recurring-Scrape-Setup.md` and `docs/recurring-scrape-merge-readiness.md` so smoke counts and tables match `scripts/run-all-smokes.sh` (23 offline scripts; 24 with `--include-container`).
|
||||||
|
|
||||||
|
## Problem Frame
|
||||||
|
|
||||||
|
Plan 062 listed 21 smokes. Plans 071 (`scrape-summary-json-smoke.sh`) and 074 (`print-scrape-summary-smoke.sh`) landed without updating the setup doc table or the merge-readiness status table (still says 21/21).
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
| ID | Requirement |
|
||||||
|
|----|-------------|
|
||||||
|
| R1 | Setup doc prose says **23 offline smokes**; `--include-container` → 24th local-only |
|
||||||
|
| R2 | Smoke table includes `print-scrape-summary-smoke.sh` and `scrape-summary-json-smoke.sh` |
|
||||||
|
| R3 | Table rows remain alphabetically sorted |
|
||||||
|
| R4 | Merge-readiness branch status table shows **23/23** offline smokes |
|
||||||
|
| R5 | Merge-readiness adds plan 077 stamp |
|
||||||
|
| R6 | `DCE_MIN_FREE_MB=0 ./scripts/run-all-smokes.sh` → 23/23 |
|
||||||
|
|
||||||
|
## Implementation Units
|
||||||
|
|
||||||
|
### U1. Setup doc
|
||||||
|
|
||||||
|
**Files:** `.docs/Recurring-Scrape-Setup.md`
|
||||||
|
|
||||||
|
### U2. Merge-readiness
|
||||||
|
|
||||||
|
**Files:** `docs/recurring-scrape-merge-readiness.md`
|
||||||
|
|
||||||
|
## Verification
|
||||||
|
|
||||||
|
```bash
|
||||||
|
DCE_MIN_FREE_MB=0 ./scripts/run-all-smokes.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
## Scope Boundaries
|
||||||
|
|
||||||
|
### Deferred
|
||||||
|
|
||||||
|
- Live KotOR catch-up on host
|
||||||
|
- Tee full documents-scrape stdout to persistent log
|
||||||
|
- Refresh PR #1538 body with plans 070–077 stamps
|
||||||
|
|
@ -4,7 +4,7 @@
|
||||||
|
|
||||||
| Gate | Status |
|
| Gate | Status |
|
||||||
|------|--------|
|
|------|--------|
|
||||||
| Offline smokes (`run-all-smokes.sh`) | 21/21 pass |
|
| Offline smokes (`run-all-smokes.sh`) | 23/23 pass |
|
||||||
| Live proof (`run-operator-proof.sh --sync-gui --target eod_discord`) | Passed on maintainer host |
|
| 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 |
|
| 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 |
|
| Upstream CI (fork PR) | `action_required` until Tyrrrz approves workflow runs |
|
||||||
|
|
@ -182,6 +182,8 @@ DCE_MIN_FREE_MB=0 ./scripts/run-operator-validation.sh \
|
||||||
|
|
||||||
**Plan 076 (2026-06-04):** Multi-target validation (`--per-target`) and proof loops write separate `logs/operator-*-<target>-<UTC>.summary.json` per scrape.
|
**Plan 076 (2026-06-04):** Multi-target validation (`--per-target`) and proof loops write separate `logs/operator-*-<target>-<UTC>.summary.json` per scrape.
|
||||||
|
|
||||||
|
**Plan 077 (2026-06-04):** Setup doc + merge-readiness smoke inventory synced to 23 offline tests (includes `print-scrape-summary-smoke`, `scrape-summary-json-smoke`).
|
||||||
|
|
||||||
**Disk:** ~65 GiB free on `/home` (2026-05-30); large channel merges still need headroom.
|
**Disk:** ~65 GiB free on `/home` (2026-05-30); large channel merges still need headroom.
|
||||||
|
|
||||||
## CI note (fork PRs)
|
## CI note (fork PRs)
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue