desertthunder.dev
a love letter to tangled (android, iOS, and a search API)
1// Package backfill provides Tap bootstrap tooling for Twister.
2//
3// # Backfill runbook
4//
5// The default command is:
6//
7// twister backfill
8//
9// `--source lightrail` is the default and discovers DIDs from
10// com.atproto.sync.listReposByCollection. `--source graph` remains available for
11// targeted fallback runs.
12//
13// # Graph seeds input
14//
15// The `--seeds` flag applies only to `--source graph` and accepts either:
16//
17// 1. a file path
18// 2. a comma-separated list of DIDs or handles
19//
20// Prerequisites
21//
22// - DATABASE_URL
23// - TAP_URL
24// - TAP_AUTH_PASSWORD
25//
26// Typical bootstrap
27//
28// 1. twister backfill --dry-run
29// 2. twister backfill
30// 3. twister enrich
31// 4. twister reindex
32//
33// In local development, docker-compose.dev.yaml runs Tap on
34// ws://localhost:2480/channel.
35//
36// Re-run backfill whenever you need to reseed the authoritative Tap corpus.
37package backfill