2.2 KiB
2.2 KiB
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 htmlsucceeded; 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).