50 lines
2.2 KiB
Markdown
50 lines
2.2 KiB
Markdown
|
---
|
||
|
|
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).
|