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:
Copilot 2026-06-03 11:15:17 -05:00
parent c8ed19d26b
commit 33faba74d6
3 changed files with 58 additions and 2 deletions

View file

@ -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 |

View 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 070077 stamps

View file

@ -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)