Add media archive and slopbot design docs

2026-09-16 07:47:28 +02:00
parent 677afc747f
commit b59b9db461
10 changed files with 453 additions and 197 deletions
@@ -16,6 +16,10 @@ before you stop.
 - [daemon.md](docs/daemon.md) — the external MCP daemon
 - [webui.md](docs/webui.md) — the web control UI and its JSON API
 - [voice.md](docs/voice.md) — voice state reads, planned actions, and lifecycle
+- [media.md](docs/media.md) — media archive: command, storage, limits, and Web UI
+- [media-scraper.md](docs/media-scraper.md) — the scrape engine: backends, walk, pacing, schema
+- [media-mcp.md](docs/media-mcp.md) — the media MCP tool surface
+- [slopbot.md](docs/slopbot.md) — the dedicated bot core for media scraping
 - [communication.md](docs/communication.md) — trust model, commands, trigger log
 - [auth.md](docs/auth.md) — QR login and token persistence
 - [testing.md](docs/testing.md) — tests and live test setup
@@ -42,6 +46,7 @@ before you stop.
 - All outbound actions go through the paced queue.
 - Triggers come from trusted users only: one-to-one DMs and direct mentions.
 - Test with throwaway accounts and private test guilds only.
+- Never commit `media-scrape/db/`, scrape databases, downloaded media, or the slopbot token.
 - Live send tests: only DMs to user **zzib** (`177117296140091393`).
 - Run `pnpm testTypes` and `pnpm lint` before you report done. Run `pnpm build` to compile.

@@ -69,6 +74,8 @@ before you stop.
 | Voice video | Not started. Plan in [docs/voice.md](docs/voice.md). |
 | Notification parsing (edits, deletes, reactions, replies) | Implemented |
 | Reply-to-puppet as a trigger | Implemented |
+| Media archive (`scrape media`, Media/Bot tabs) | Design approved 2026-09-16. Checkpoints in [CURRENT.md](CURRENT.md). |
+| Slopbot (dedicated bot core for scraping) | Design approved 2026-09-16. Checkpoints in [CURRENT.md](CURRENT.md). |
 | Auth persistence in the core | Implemented and verified live |
 | CDP transport | Kept as a development fallback |

@@ -82,6 +89,8 @@ See [CURRENT.md](CURRENT.md) and [TODO.md](TODO.md) for the live list. The main
 3. Per-user rate limit and command cooldowns.
 4. Collector account with read-only voice membership.
 5. Remote agent MCP path: notification tools and a documented LAN/Tailscale bind.
+6. Media archive (`media-scrape/`, slopbot): work the checkpoints in [CURRENT.md](CURRENT.md) and
+   push the branch after each one.

 Paused: the `poll` command and the setup command flow. Open decisions wait in
 [CURRENT.md](CURRENT.md) → Open discussions.