1# Researcher Queue
2 
3The queue files are the persistent ledger that lets the autonomous loop run for days without losing state. Every change is append-only or replaces the entire file with a new sorted snapshot.
4 
5## Files
6 
7- `inbox.jsonl` - candidate sources discovered but not yet initialized as runs.
8- `parked.jsonl` - run IDs that hit a human-review gate and are waiting for a reviewer.
9- `done.jsonl` - run IDs that have been closed (accepted, rejected, reference-only, abandoned).
10- `quarantine.jsonl` - sources removed from rotation because retrieval failed or the source registry rejects them.
11 
12## Source Record Shape
13 
14Each line in `inbox.jsonl` and `quarantine.jsonl` is a JSON object:
15 
16```json
17{
18  "source_id": "deterministic-hash",
19  "url": "https://example.com/post",
20  "title": "Short title",
21  "author_or_org": "Org",
22  "source_type": "paper | engineering_blog | documentation | benchmark | code | talk | other",
23  "candidate_reason": "Why this source matters",
24  "feed": "manual-seed | parallel-research | rss | other",
25  "discovered_at": "ISO-8601",
26  "attempts": 0,
27  "last_status": "queued | initialized | failed"
28}
29```
30 
31Active runs live under `researcher/runs/<run-id>/` and have their own `run-state.json`. The loop scripts read those state files directly rather than duplicating active-run state here, so there is one source of truth per run.
32