trim21

Download client torrent lifecycle stages and tag transitions. Use when working on torrent download, processing, or tag logic in app/bin/downloader.py.

Database thread lifecycle stages and transitions. Use when working on thread state queries, scraping logic, or status filtering in app/scrape.py, app/server.py, app/downloader.py.

M-Team scraping workflow, search cursor, rate limiting, and torrent or mediainfo fetch behavior. Use when working on app/scrape.py, app/mt.py, or thread discovery and fetch flow.

FastAPI dashboard routes, daily_stats cache and backfill, thread pages, node pages, and admin APIs. Use when working on app/server.py or dashboard templates.

RPC command queue system for server-to-downloader communication. Use when working on RPC methods, command dispatch, or the /rpc and /api/node/{node_id}/rpc endpoints in app/rpc.py, app/downloader.py, app/server.py.

Build and validate the nanobind C++ extension with meson. Use for changes in src/bencode2/*.cpp or *.hpp, meson.build, native crashes, ABI issues, import failures, or any task that must run with --assert-pkg-compiled=true.

Keep the C++ extension and pure Python fallback behavior aligned. Use for encode or decode semantic changes, validation rules, security hardening, recursion or overflow fixes, error message updates, and regression tests that must cover both implementations.

Validate the pure Python decoder and encoder fallback. Use for changes in src/bencode2/__decoder.py or __encoder.py, PyPy compatibility, tests that should pass without the native module, or any task that must run with --assert-pkg-compiled=false.

Complete lifecycle of a named block claim in Neptune's BitTorrent pipeline: free, claimed, response accepted, disk write, and hash verification.

Guide for adding new JSON-RPC HTTP API methods in Neptune. Use when asked to add a new API endpoint, RPC method, or HTTP handler.