DiscordChatExporter/docs/plans/2026-05-28-007-verify-documents-auth-bootstrap-plan.md
Boden 9e55378c84 feat(scrape): add Documents verify and auth bootstrap helpers
Add scripts to confirm enabled targets map to seeded ~/Documents archives
and to create scrape.env from exported DISCORD_TOKEN credentials.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-28 01:18:05 -05:00

29 lines
1.3 KiB
Markdown

---
title: fix: Verify Documents targets and bootstrap scrape auth
type: fix
status: completed
date: 2026-05-28
origin: LFG repeat — confirm ~/Documents/** append paths and unblock auth setup
depends_on: docs/plans/2026-05-28-006-fix-documents-append-auth-plan.md
---
# fix: Verify Documents targets and bootstrap scrape auth
## Summary
Plan 006 landed append-safe scraping. This pass adds operator tooling so you can (1) verify every enabled target maps to an on-disk `~/Documents/<server>/` tree with seeded channel archives, and (2) create `scrape.env` without manual file editing when a token is already exported.
## Requirements
| ID | Requirement | Files |
|----|-------------|-------|
| V1 | `verify-documents-archives.sh` reports per-target output_dir, JSON count, seeded channel IDs, channel-map coverage | `scripts/verify-documents-archives.sh`, smoke test |
| V2 | `setup-scrape-auth.sh` writes `scrape.env` from `DISCORD_TOKEN` or `DISCORD_TOKEN_FILE` (chmod 600), idempotent | `scripts/setup-scrape-auth.sh`, smoke test |
| V3 | Document verify + auth bootstrap in setup guide | `.docs/Recurring-Scrape-Setup.md` |
## Success Criteria
- Verify script runs against real `config/scrape-targets.json` and exits 0 when enabled targets have archive dirs
- Auth bootstrap creates scrape.env when token env vars are set
- Smoke tests pass