recuse: Instructions file for Claude Code

Working in this repo

Read DNA.md first. It has the rules. This file is the mechanics.

Layout

src/
  sources/    one module per external service, each returning typed records
    http.ts       fetch with timeout, backoff, a body size cap, embedded JSON
    gamma.ts      market catalogue and resolution lifecycles
    dataapi.ts    current balances, with the display names accounts chose
    subgraph.ts   cumulative positions through the old index head, plus payouts
    trades.ts     the current trade log, with request-scope and paging checks
    chain.ts      the oracle layer, unbuilt. reports that it read nothing,
                  and validates RECUSE_RPC_URL on every reading
  core/       pure logic, no I/O except where noted
    safe.ts       making remote text safe to put on a terminal. pure
    dispute.ts    parses umaResolutionStatuses into rounds, phase, clock
    capture.ts    which side is measurable, concentration, repeat tallies
    rebuild.ts    cumulative positions summed out of fills. pure
    wallet.ts     one wallet's ledger, chain payout first, closing-price fallback. pure
    rank.ts       sort order, filtering, viewport. pure
    watch.ts      what counts as a resolution moving. pure
    recall.ts     what moved since the last radar run. pure, reuses watch.ts
    queue.ts      lifecycles that never terminated, and how long. pure
    ledger.ts     the event log summarised. pure
    mcp.ts        the MCP protocol, pure. the engine is injected
    update.ts     version check. checks and prints, never installs
    assess.ts     assembles one answer from every source (does I/O)
    watcher.ts    one poll pass, and the loop (does I/O)
    store.ts      the watchlist, both snapshots, the event log, under ~/.recuse
    notify.ts     webhook delivery. the only outbound sink
  ui/
    theme.ts      five themes, colour depth detection, hex to escape
    format.ts     numbers, widths, NO_COLOR and non-TTY detection
    logo.ts       the wordmark, the face, and the launch banner
    loading.ts    the spinner, on stderr, silent when piped
    plain.ts      the plain renderer, and the fallback for pipes
    App.tsx       the ink radar
  cli.ts      arg parsing, command dispatch, --json on every path
tools/
  logo.mjs          regenerates assets/. run after changing the wordmark
  site.mjs          builds site/, flat HTML, no backend and no client JS
  prepare.mjs       builds on install, so a git install produces a binary
  reachable.mjs     which symbols the entry point can get to. pure, tested
  housekeeping.mjs  the house rules, checked. run by CI
.github/workflows/
  ci.yml      typecheck, build, test, audit and check on node 22 and 24
  site.yml    nightly site build, publishes to Pages