---
model: claude-fable-5[1m]
service: claude
timestamp: 2026-06-11T17:51:52Z
git_ref: 8526985c
diff_cmd: git diff test_cpu_throttling..wkt/big_boi_docs
---

# Raw output pointers (diff-ref mode)

All generated content is code/config/docs committed alongside
this entry on branch `wkt/big_boi_docs`; per the prompt-io
diff-ref decision rule each file's verbatim content is the diff
itself rather than a copy here:

> `git diff test_cpu_throttling..wkt/big_boi_docs -- docs/`
> `git diff test_cpu_throttling..wkt/big_boi_docs -- examples/`
> `git diff test_cpu_throttling..wkt/big_boi_docs -- pyproject.toml uv.lock .github/`

## Generation notes (non-code output summary)

- Theme research (web, agent-verified 2026-06-11): msgspec=furo,
  xonsh=furo, numpy/ray/polars=pydata-sphinx-theme (ray migrated
  off sphinx-book-theme); sphinx-book-theme 1.2.0 hard-pins
  pydata 0.16.1 (stale) -> chose pydata 0.18 + sphinx 9.1.
- d2 ecosystem: no production-grade pypi extension exists
  (sphinxcontrib-d2lang 0.0.5 ignores returncodes, uuid4 output
  names; sphinx-d2 is an empty stub) -> wrote local
  `docs/_ext/d2diagrams.py` (~230 LOC) with D2_BIN env
  discovery, mtime caching, committed-SVG fallback and
  literal-block last resort.
- Diagrams authored in d2 (theme-id 1 "Neutral Grey" + sketch
  mode + ELK layout, validated by render + headless-firefox
  screenshot loop): actor_tree, context_handshake (real
  msg-spec names Start/StartAck/Started/Yield/Stop/Return),
  streaming_pipeline, runtime_stack, debug_lock,
  error_propagation, infected_aio.
- API truth enforced from a 6-agent recon pass over the
  reorganized package tree (runtime/, discovery/, spawn/, ipc/,
  msg/, devx/, trionics/): docs teach `.wait_for_result()`,
  registrar (not arbiter) naming, `@tractor.context` +
  `open_context()` as the core model, `run_in_actor()` as
  convenience only.
- All ~30 literalincluded example scripts verified present; 9
  touched/new example files smoke-run green (exit 0, <16s).
- Final build: `sphinx-build -b html` succeeded; 24 residual
  warnings, every one sourced from pre-existing library
  docstring rst-isms or legacy NEWS.rst content (left untouched
  by design; flagged for a follow-up docstring lint pass).
