Add snapshot evidence to cancel-cascade MTF issue doc

Append "Snapshot evidence (2026-05-13)" section to
`cancel_cascade_too_slow_under_main_thread_forkserver_issue.md`
documenting `fail_after_w_trace` diag capture results for
`test_nested_multierrors` under the MTF backend — reproduction cmd,
ptree analysis, observed hang signature, and updated triage plan.

(this commit msg was generated in some part by [`claude-code`][claude-code-gh])
[claude-code-gh]: https://github.com/anthropics/claude-code

(cherry picked from commit 5372fd178a)

.github/workflows/ci.yml

@@ -88,10 +88,27 @@ jobs:
 
 
   testing:
-    name: '${{ matrix.os }} Python${{ matrix.python-version }} spawn_backend=${{ matrix.spawn_backend }} tpt_proto=${{ matrix.tpt_proto }}'
+    name: '${{ matrix.os }} Python${{ matrix.python-version }} spawn_backend=${{ matrix.spawn_backend }} tpt_proto=${{ matrix.tpt_proto }} capture=${{ matrix.capture }}'
-    timeout-minutes: 16
+    timeout-minutes: 20
     runs-on: ${{ matrix.os }}
 
+    # NOTE on the matrix shape — the `capture=` mode follows
+    # `spawn_backend`:
+    #
+    # - `trio` / `mp_*` backends use `--capture=fd` (default)
+    #   for per-test attribution of subactor *raw-fd* output
+    #   in failure reports.
+    # - Fork-based backends (`main_thread_forkserver`,
+    #   `subint_forkserver`) REQUIRE `--capture=sys` because
+    #   fork-child × `--capture=fd` is a known deadlock
+    #   pattern. See the long NOTE in `tractor._testing.pytest`'s
+    #   `pytest_load_initial_conftests` for the mechanism +
+    #   tradeoff write-up.
+    #
+    # If a future matrix row adds a fork-spawn backend
+    # WITHOUT setting `capture: 'sys'`, the
+    # `pytest_load_initial_conftests` hook fail-fasts on `CI=1`
+    # with a clear error msg. So the matrix is self-policing.
     strategy:
       fail-fast: false
       matrix:
@@ -118,6 +135,26 @@ jobs:
           'tcp',
           'uds',
         ]
+        capture: [
+          'fd',  # default for non-fork backends
+        ]
+
+        # Fork-based backends — added via `include:` so each
+        # cell carries its REQUIRED `capture: 'sys'` mode.
+        # Linux-only for now; macOS coverage TBD pending
+        # local validation.
+        include:
+          - os: ubuntu-latest
+            python-version: '3.13'
+            spawn_backend: 'main_thread_forkserver'
+            tpt_proto: 'tcp'
+            capture: 'sys'
+          - os: ubuntu-latest
+            python-version: '3.13'
+            spawn_backend: 'main_thread_forkserver'
+            tpt_proto: 'uds'
+            capture: 'sys'
+
         # https://github.com/orgs/community/discussions/26253#discussioncomment-3250989
         exclude:
           # don't do UDS run on macOS (for now)
@@ -158,7 +195,11 @@ jobs:
           -rsx
           --spawn-backend=${{ matrix.spawn_backend }}
           --tpt-proto=${{ matrix.tpt_proto }}
-          --capture=fd
+          --capture=${{ matrix.capture }}
+        # NOTE: capture mode is matrix-driven — `fd` for
+        # non-fork backends (per-test fd attribution),
+        # `sys` for fork-based (avoids fork-child x
+        # capture-fd deadlock). See matrix-NOTE above.
 
   # XXX legacy NOTE XXX
   #

.github/workflows/docs.yml

@@ -0,0 +1,63 @@
+name: docs
+
+# build sphinx docs on every PR + push to main;
+# deploy to gh-pages only from main pushes.
+# (see goodboy/tractor#123 for the original ask)
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  # to run workflow manually from the "Actions" tab
+  workflow_dispatch:
+
+# needed by actions/deploy-pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    name: 'sphinx build'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install latest uv
+        uses: astral-sh/setup-uv@v6
+
+      # NOTE, no `d2` bin is installed in CI (yet) so
+      # the pre-rendered + committed SVGs under
+      # `docs/_diagrams/` are used as-is; see
+      # `docs/_ext/d2diagrams.py` for the fallback
+      # policy.
+      - name: Build html docs
+        run: |
+          uv sync --no-dev --group docs
+          uv run --no-dev --group docs make -C docs html
+
+      - name: Upload pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_build/html
+
+  deploy:
+    name: 'deploy to gh-pages'
+    if: ${{ github.ref == 'refs/heads/main' && github.event_name == 'push' }}
+    needs: build
+    # serialize deploys but NEVER cancel an in-flight one
+    # mid-upload; queue the next instead (scoped to this job so
+    # PR builds can't cancel a production deploy).
+    concurrency:
+      group: 'pages'
+      cancel-in-progress: false
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy
+        id: deployment
+        uses: actions/deploy-pages@v4

NEWS.rst

@@ -78,6 +78,7 @@ Bug Fixes
   for ``asyncio``-side errors to not propagate due to a race condition.
 
   The implementation fix summary is:
+
   - add state to signal the end of the ``trio`` side task to be
     read by the ``asyncio`` side and always cancel any ongoing
     task in such cases.

ai/conc-anal/cancel_cascade_too_slow_under_main_thread_forkserver_issue.md

@@ -0,0 +1,314 @@
+# Cancel-cascade `trio.TooSlowError` flakes under `main_thread_forkserver`
+
+## Symptom
+
+Running the full test suite under
+
+```bash
+./py313/bin/python -m pytest tests/ \
+  --tpt-proto=tcp \
+  --spawn-backend=main_thread_forkserver
+```
+
+surfaces a single, **rotating** `trio.TooSlowError`
+failure each run. The failure isn't deterministic on
+test identity — different test each run — but it
+ALWAYS looks like:
+
+```
+FAILED tests/<file>::test_<name> - trio.TooSlowError
+==== 1 failed, 373 passed, 17 skipped, 11–12 xfailed,
+       0–1 xpassed, ~550 warnings in ~6min ====
+```
+
+Pass rate: **~99.7%** (373 of 374 non-skip tests).
+Wall-clock per full run: 5–6 min.
+
+## Tests observed flaking so far
+
+Each row was the SOLE failure in a separate run:
+
+| run # | test |
+|---|---|
+| 1 | `tests/test_advanced_streaming.py::test_dynamic_pub_sub[KeyboardInterrupt]` |
+| 2 | `tests/test_infected_asyncio.py::test_context_spawns_aio_task_that_errors[parent_actor_cancels_child=False]` |
+
+Both share the same shape:
+
+- **Cancel cascade** of N subactors back to a parent root actor.
+- N ≥ `multiprocessing.cpu_count()` for `test_dynamic_pub_sub`
+  (it spawns `cpus - 1` consumers + publisher + dynamic-consumer).
+- N ≈ 2 for `test_context_spawns_aio_task_that_errors` —
+  but each subactor is `infect_asyncio=True`, so each
+  cancel involves the trio↔asyncio guest-run unwind
+  which is structurally heavier than pure-trio.
+- Test wraps the cascade in `trio.fail_after(N seconds)`
+  and the cap fires before the cascade completes.
+
+The exact failing test rotates because each test is
+independently close to the cap; whichever happens to
+be unlucky in scheduling/CPU-contention on a given run
+is the one that times out.
+
+## Root-cause family
+
+`hard_kill` (`tractor/spawn/_spawn.py:hard_kill`) runs
+the SC-graceful teardown ladder per subactor:
+
+1. `Portal.cancel_actor()` — graceful IPC cancel-req.
+2. Wait `terminate_after=1.6s` for sub to exit.
+3. If still alive: `proc.kill()` (SIGKILL).
+4. (NEW) `_unlink_uds_bind_addrs()` — post-mortem
+   sock-file cleanup for UDS leaks (issue #452 fix).
+
+For a cascade of N subactors, each pays steps 1–4. If
+graceful-cancel doesn't complete within 1.6s for ANY
+sub, that sub eats a full 1.6s of `move_on_after` plus
+the `proc.wait()` post-SIGKILL.
+
+Worst case under fork backend with N=cpus subs:
+- N × 1.6s = 16s+ on a 10-core box just for the
+  graceful timeout phase
+- Plus per-spawn fork-IPC handshake cost compounds
+  during teardown (each sub's IPC cleanup goes through
+  the same forkserver coordinator)
+- Plus the new autouse fixtures
+  (`_track_orphaned_uds_per_test`,
+  `_detect_runaway_subactors_per_test`,
+  `_reap_orphaned_subactors`) all run at test
+  teardown, adding small (10s of ms) but cumulative
+  overhead
+
+Current cap: 30s (`fail_after_s = 30 if
+is_forking_spawner else 12`). Empirically fits the
+median run but the tail breaks ~0.3% of the time.
+
+## NOT regressing
+
+To confirm this is a flake and not a regression:
+
+- Pre-`WakeupSocketpair`-patch baseline: tests
+  HUNG INDEFINITELY (busy-loop never released).
+- Post-patch: pass-or-fail-fast, ~99.7% pass, the
+  occasional cap-hit fails in bounded time (<60s for
+  the offending test).
+- Same test PASSES under `--spawn-backend=trio`
+  (no fork, no hard-kill compounding).
+
+So the suite is dramatically better than before; the
+remaining flake is a known-tolerable steady-state.
+
+## Possible mitigations (ranked)
+
+### A. Bump the cap further
+
+Cheapest. Change the per-test `fail_after_s` from 30
+to e.g. 60 for fork backends. Pros: trivial. Cons:
+masks any genuine slowness regression we'd want to
+catch.
+
+### B. CPU-count-aware cap
+
+For tests whose N scales with `cpu_count()`, scale
+the cap too:
+
+```python
+fail_after_s = (
+    max(30, cpu_count() * 3)  # 3s/actor floor
+    if is_forking_spawner
+    else 12
+)
+```
+
+Pros: scales with the actual cancel-cascade work.
+Cons: still arbitrary multiplier.
+
+### C. `pytest-rerunfailures` for these tests only
+
+Mark the known-flaky tests with
+`@pytest.mark.flaky(reruns=1)` (needs
+`pytest-rerunfailures` dep). Single retry hides
+genuine ~0.3% transient flakes.
+
+Pros: no cap change, surfaces persistent failures
+loudly. Cons: adds a dep, retries can mask real bugs
+if used widely.
+
+### D. Reduce `hard_kill`'s `terminate_after`
+
+Drop from 1.6s → 0.8s. Cuts the worst-case cascade
+time roughly in half. Risks: fewer subs get a chance
+to run their cleanup before SIGKILL → more orphaned
+state for the autouse reapers to handle (ironically,
+adds back overhead elsewhere).
+
+### E. Profile + targeted fix
+
+Add `log.devx()` markers in `hard_kill` to time each
+phase. Identify if any subactor is consistently
+hitting the 1.6s cap (vs. exiting in <0.1s). If so,
+that sub has a teardown bug worth fixing at source.
+Pros: actually fixes the underlying slowness. Cons:
+real investigation work, deferred from this round.
+
+## Recommendation
+
+Land this issue-doc as the tracker. Apply **(B)** as
+a small follow-up — cheap and proportional. If it
+still flakes, escalate to **(E)** with a `log.devx()`
+profile-pass.
+
+`(C)` is a backstop if `(B)` doesn't quite get there
+and we need green CI faster than (E) can deliver.
+
+## Verification protocol
+
+After applying any mitigation:
+
+```bash
+# Run the suite N times back-to-back, count failures.
+# A persistent failure on the SAME test == real bug.
+# Failures rotating across tests == still cap-related.
+
+for i in $(seq 1 5); do
+  ./py313/bin/python -m pytest tests/ \
+    --tpt-proto=tcp \
+    --spawn-backend=main_thread_forkserver \
+    -q 2>&1 | tail -2
+done
+```
+
+Target: 0 failures across 5 runs ⇒ ship. 1–2 failures
+still rotating ⇒ apply (C). Same test failing twice
+⇒ escalate to (E).
+
+## Snapshot evidence (2026-05-13)
+
+After landing the `fail_after_w_trace` /
+`afk_alarm_w_trace` capture-on-timeout helpers
+(`tractor._testing.trace`), `test_nested_multierrors`
+on the `main_thread_forkserver` backend produces
+**reproducible diag snapshots** at
+`$XDG_CACHE_HOME/tractor/hung-dumps/test_nested_multierrors_start_method_main_thread_forkserver__<iso-ts>/`.
+
+### Reproduction
+
+```bash
+pytest \
+  -v --verbose --durations=10 \
+  --spawn-backend=main_thread_forkserver \
+  --tpt-proto=uds \
+  --capture=sys --show-capture=stderr -rxX \
+  tests/test_cancellation.py::test_nested_multierrors
+```
+
+The test is `xfail(strict=False)` for MTF — it RUNS
+each invocation so snapshots accumulate, but doesn't
+break `--lf` workflow.
+
+### Consistent shape across runs
+
+5+ snapshots taken back-to-back show the SAME pattern:
+
+- **Timing:** ~10s wall-clock total. Inner
+  `fail_after_w_trace(10)` fires at exactly T=10s;
+  cascade's `nursery.__aexit__` takes ~0.6s more to
+  gather + propagate the resulting
+  `BaseExceptionGroup`. **Trio backend completes the
+  SAME test in <6s** — so the MTF cascade is ~2x
+  slower at minimum.
+
+- **`BaseExceptionGroup` shape:** mixed
+  `[RemoteActorError, Cancelled]`. The first
+  subactor's natural error-propagation (`assert 0`
+  raised → `RemoteActorError` portal-result)
+  arrives before T=10s; the OTHER subactor's
+  portal-wait is still in flight at T=10s, gets
+  cancelled by `fail_after_w_trace`'s scope-cancel
+  → returns `Cancelled` instead.
+
+- **Orphan-spawn skew:** snapshot's `orphans` bucket
+  (after the `_is_tractor_subactor` cgroup-slice
+  override fix) consistently shows 2-4 init-adopted
+  procs at `depth_3` and `depth_1` levels — these
+  are the leaves whose parent (`depth_2` spawner)
+  was killed mid-cascade but who hadn't yet seen
+  the cancel signal themselves.
+
+- **UDS sock-leak:** 2-6 dead-orphan socks per run
+  (varies with cascade timing). The
+  `track_orphaned_uds_per_test` fixture reaps them
+  post-test → contamination is isolated per-invocation.
+
+### Capture mechanism
+
+`fail_after_w_trace` covers two firing paths:
+
+1. **`trio.TooSlowError`** raised at scope-exit
+   (body returned cleanly past deadline) — direct
+   `except` handler captures.
+
+2. **Scope-cancel + body raises non-`Cancelled` exc**
+   (e.g. `nursery.__aexit__` wraps timeout-induced
+   `Cancelled` into a `BaseExceptionGroup` that
+   escapes before `trio.fail_after`'s exit-check
+   could fire `TooSlowError`) — body-raise `except`
+   handler checks `scope.cancel_called` and
+   captures if True. This path catches the
+   `test_nested_multierrors` shape specifically (see
+   "BaseExceptionGroup shape" above).
+
+The snapshot dir contains:
+- `trace.txt` — `ptree` + `hung_state` (kernel
+  `wchan`/`stack` + `py-spy dump --locals` when
+  sudo cached), with `include_strays=True`
+  surfacing any cross-test ghost subactor trees in
+  the `orphans` bucket.
+- `bindspace.txt` — UDS bindspace classification
+  (live-active / orphaned-alive / orphaned-dead).
+- `meta.json` — `{pid, label, captured_at, sudo_cached}`.
+
+The end-of-session `pytest_terminal_summary` hook
+in `tractor._testing.pytest` lists every snapshot
+dir from the run so you don't have to scroll back
+through captured-stderr lines:
+
+```
+========================= tractor hang-snapshot index ==========================
+N `fail_after_w_trace` / `afk_alarm_w_trace` snapshot(s) captured this session:
+  <test-id>
+    → /home/.../.cache/tractor/hung-dumps/<label>__<ts>
+```
+
+### Caveats
+
+The snapshot fires AFTER the body-raise (not at the
+exact moment of scope-cancel), so the parent's
+py-spy frames show `_do_capture_snapshot` itself
+running, NOT the cancel-cascade hang frame. To see
+the actual hang state, manual `acli.ptree` /
+`acli.hung_dump` from a second terminal at T=10s
+would be needed — **not currently possible**
+because per-test reaper fixtures clean up ~0.6s
+post-timeout. See follow-up TODO in
+`tractor/_testing/trace.py` for a
+`TRACTOR_TRACE_HOLD=1` env-var pause mode.
+
+## See also
+
+- [#452](https://github.com/goodboy/tractor/issues/452) —
+  UDS sock-file leak (related — `hard_kill`'s
+  cleanup phase contributes to cascade time)
+- `ai/conc-anal/trio_wakeup_socketpair_busy_loop_under_fork_issue.md`
+  — the upstream-trio fix that turned this from a
+  100% hang into a 0.3% flake
+- `ai/conc-anal/infected_asyncio_under_main_thread_forkserver_hang_issue.md`
+  — the asyncio variant which contributes to one of
+  the rotating failures
+- `tractor/spawn/_spawn.py::hard_kill` — the SIGKILL
+  cascade source
+- `tractor/_testing/_reap.py::_track_orphaned_uds_per_test`,
+  `_detect_runaway_subactors_per_test`,
+  `_reap_orphaned_subactors` — autouse cleanup
+  fixtures whose cumulative teardown overhead
+  contributes to the cascade time

ai/conc-anal/subint_cancel_delivery_hang_issue.md

@@ -0,0 +1,161 @@
+# `subint` backend: parent trio loop parks after subint teardown (Ctrl-C works; not a CPython-level issue)
+
+Follow-up to the Phase B subint spawn-backend PR (see
+`tractor.spawn._subint`, issue #379). Distinct from the
+`subint_sigint_starvation_issue.md` (SIGINT-unresponsive
+starvation hang): this one is **Ctrl-C-able**, which means
+it's *not* the shared-GIL-hostage class and is ours to fix
+from inside tractor rather than waiting on upstream CPython
+/ msgspec progress.
+
+## TL;DR
+
+After a stuck-subint subactor is torn down via the
+hard-kill path, a parent-side trio task parks on an
+*orphaned resource* (most likely a `chan.recv()` /
+`process_messages` loop on the now-dead subint's IPC
+channel) and waits forever for bytes that can't arrive —
+because the channel was torn down without emitting a clean
+EOF/`BrokenResourceError` to the waiting receiver.
+
+Unlike `subint_sigint_starvation_issue.md`, the main trio
+loop **is** iterating normally — SIGINT delivers cleanly
+and the test unhangs. But absent Ctrl-C, the test suite
+wedges indefinitely.
+
+## Symptom
+
+Running `test_subint_non_checkpointing_child` under
+`--spawn-backend=subint` (in
+`tests/test_subint_cancellation.py`):
+
+1. Test spawns a subactor whose main task runs
+   `threading.Event.wait(1.0)` in a loop — releases the
+   GIL but never inserts a trio checkpoint.
+2. Parent does `an.cancel_scope.cancel()`. Our
+   `subint_proc` cancel path fires: soft-kill sends
+   `Portal.cancel_actor()` over the live IPC channel →
+   subint's trio loop *should* process the cancel msg on
+   its IPC dispatcher task (since the GIL releases are
+   happening).
+3. Expected: subint's `trio.run()` unwinds, driver thread
+   exits naturally, parent returns.
+4. Actual: parent `trio.run()` never completes. Test
+   hangs past its `trio.fail_after()` deadline.
+
+## Evidence
+
+### `strace` on the hung pytest process during SIGINT
+
+```
+--- SIGINT {si_signo=SIGINT, si_code=SI_KERNEL} ---
+write(17, "\2", 1)                      = 1
+```
+
+Contrast with the SIGINT-starvation hang (see
+`subint_sigint_starvation_issue.md`) where that same
+`write()` returned `EAGAIN`. Here the SIGINT byte is
+written successfully → Python's signal handler pipe is
+being drained → main trio loop **is** iterating → SIGINT
+gets turned into `trio.Cancelled` → the test unhangs (if
+the operator happens to be there to hit Ctrl-C).
+
+### Stack dump (via `tractor.devx.dump_on_hang`)
+
+Single main thread visible, parked in
+`trio._core._io_epoll.get_events` inside `trio.run` at the
+test's `trio.run(...)` call site. No subint driver thread
+(subint was destroyed successfully — this is *after* the
+hard-kill path, not during it).
+
+## Root cause hypothesis
+
+Most consistent with the evidence: a parent-side trio
+task is awaiting a `chan.recv()` / `process_messages` loop
+on the dead subint's IPC channel. The sequence:
+
+1. Soft-kill in `subint_proc` sends `Portal.cancel_actor()`
+   over the channel. The subint's trio dispatcher *may* or
+   may not have processed the cancel msg before the subint
+   was destroyed — timing-dependent.
+2. Hard-kill timeout fires (because the subint's main
+   task was in `threading.Event.wait()` with no trio
+   checkpoint — cancel-msg processing couldn't race the
+   timeout).
+3. Driver thread abandoned, `_interpreters.destroy()`
+   runs. Subint is gone.
+4. But the parent-side trio task holding a
+   `chan.recv()` / `process_messages` loop against that
+   channel was **not** explicitly cancelled. The channel's
+   underlying socket got torn down, but without a clean
+   EOF delivered to the waiting recv, the task parks
+   forever on `trio.lowlevel.wait_readable` (or similar).
+
+This matches the "main loop fine, task parked on
+orphaned I/O" signature.
+
+## Why this is ours to fix (not CPython's)
+
+- Main trio loop iterates normally → GIL isn't starved.
+- SIGINT is deliverable → not a signal-pipe-full /
+  wakeup-fd contention scenario.
+- The hang is in *our* supervision code, specifically in
+  how `subint_proc` tears down its side of the IPC when
+  the subint is abandoned/destroyed.
+
+## Possible fix directions
+
+1. **Explicit parent-side channel abort on subint
+   abandon.** In `subint_proc`'s teardown block, after the
+   hard-kill timeout fires, explicitly close the parent's
+   end of the IPC channel to the subint. Any waiting
+   `chan.recv()` / `process_messages` task sees
+   `BrokenResourceError` (or `ClosedResourceError`) and
+   unwinds.
+2. **Cancel parent-side RPC tasks tied to the dead
+   subint's channel.** The `Actor._rpc_tasks` / nursery
+   machinery should have a handle on any
+   `process_messages` loops bound to a specific peer
+   channel. Iterate those and cancel explicitly.
+3. **Bound the top-level `await actor_nursery
+   ._join_procs.wait()` shield in `subint_proc`** (same
+   pattern as the other bounded shields the hard-kill
+   patch added). If the nursery never sets `_join_procs`
+   because a child task is parked, the bound would at
+   least let the teardown proceed.
+
+Of these, (1) is the most surgical and directly addresses
+the root cause. (2) is a defense-in-depth companion. (3)
+is a band-aid but cheap to add.
+
+## Current workaround
+
+None in-tree. The test's `trio.fail_after()` bound
+currently fires and raises `TooSlowError`, so the test
+visibly **fails** rather than hangs — which is
+intentional (an unbounded cancellation-audit test would
+defeat itself). But in interactive test runs the operator
+has to hit Ctrl-C to move past the parked state before
+pytest reports the failure.
+
+## Reproducer
+
+```
+./py314/bin/python -m pytest \
+  tests/test_subint_cancellation.py::test_subint_non_checkpointing_child \
+  --spawn-backend=subint --tb=short --no-header -v
+```
+
+Expected: hangs until `trio.fail_after(15)` fires, or
+Ctrl-C unwedges it manually.
+
+## References
+
+- `tractor.spawn._subint.subint_proc` — current subint
+  teardown code; see the `_HARD_KILL_TIMEOUT` bounded
+  shields + `daemon=True` driver-thread abandonment
+  (commit `b025c982`).
+- `ai/conc-anal/subint_sigint_starvation_issue.md` — the
+  sibling CPython-level hang (GIL-starvation,
+  SIGINT-unresponsive) which is **not** this issue.
+- Phase B tracking: issue #379.

ai/conc-anal/subint_fork_blocked_by_cpython_post_fork_issue.md

@@ -0,0 +1,337 @@
+# `os.fork()` from a non-main sub-interpreter aborts the child (CPython refuses post-fork cleanup)
+
+Third `subint`-class analysis in this project. Unlike its
+two siblings (`subint_sigint_starvation_issue.md`,
+`subint_cancel_delivery_hang_issue.md`), this one is not a
+hang — it's a **hard CPython-level refusal** of an
+experimental spawn strategy we wanted to try.
+
+## TL;DR
+
+An in-process sub-interpreter cannot be used as a
+"launchpad" for `os.fork()` on current CPython. The fork
+syscall succeeds in the parent, but the forked CHILD
+process is aborted immediately by CPython's post-fork
+cleanup with:
+
+```
+Fatal Python error: _PyInterpreterState_DeleteExceptMain: not main interpreter
+```
+
+This is enforced by a hard `PyStatus_ERR` gate in
+`Python/pystate.c`. The CPython devs acknowledge the
+fragility with an in-source comment (`// Ideally we could
+guarantee tstate is running main.`) but provide no
+mechanism to satisfy the precondition from user code.
+
+**Implication for tractor**: the `subint_fork` backend
+sketched in `tractor.spawn._subint_fork` is structurally
+dead on current CPython. The submodule is kept as
+documentation of the attempt; `--spawn-backend=subint_fork`
+raises `NotImplementedError` pointing here.
+
+## Context — why we tried this
+
+The motivation is issue #379's "Our own thoughts, ideas
+for `fork()`-workaround/hacks..." section. The existing
+trio-backend (`tractor.spawn._trio.trio_proc`) spawns
+subactors via `trio.lowlevel.open_process()` → ultimately
+`posix_spawn()` or `fork+exec`, from the parent's main
+interpreter that is currently running `trio.run()`. This
+brushes against a known-fragile interaction between
+`trio` and `fork()` tracked in
+[python-trio/trio#1614](https://github.com/python-trio/trio/issues/1614)
+and siblings — mostly mitigated in `tractor`'s case only
+incidentally (we `exec()` immediately post-fork).
+
+The idea was:
+
+1. Create a subint that has *never* imported `trio`.
+2. From a worker thread in that subint, call `os.fork()`.
+3. In the child, `execv()` back into
+   `python -m tractor._child` — same as `trio_proc` does.
+4. The fork is from a trio-free context → trio+fork
+   hazards avoided regardless of downstream behavior.
+
+The parent-side orchestration (`ipc_server.wait_for_peer`,
+`SpawnSpec`, `Portal` yield) would reuse
+`trio_proc`'s flow verbatim, with only the subproc-spawn
+mechanics swapped.
+
+## Symptom
+
+Running the prototype (`tractor.spawn._subint_fork.subint_fork_proc`,
+see git history prior to the stub revert) on py3.14:
+
+```
+Fatal Python error: _PyInterpreterState_DeleteExceptMain: not main interpreter
+Python runtime state: initialized
+
+Current thread 0x00007f6b71a456c0 [subint-fork-lau] (most recent call first):
+  File "<script>", line 2 in <module>
+<script>:2: DeprecationWarning: This process (pid=802985) is multi-threaded, use of fork() may lead to deadlocks in the child.
+```
+
+Key clues:
+
+- The **`DeprecationWarning`** fires in the parent (before
+  fork completes) — fork *is* executing, we get that far.
+- The **`Fatal Python error`** comes from the child — it
+  aborts during CPython's post-fork C initialization
+  before any user Python runs in the child.
+- The thread name `subint-fork-lau[nchpad]` is ours —
+  confirms the fork is being called from the launchpad
+  subint's driver thread.
+
+## CPython source walkthrough
+
+### Call site — `Modules/posixmodule.c:728-793`
+
+The post-fork-child hook CPython runs in the child process:
+
+```c
+void
+PyOS_AfterFork_Child(void)
+{
+    PyStatus status;
+    _PyRuntimeState *runtime = &_PyRuntime;
+
+    // re-creates runtime->interpreters.mutex (HEAD_UNLOCK)
+    status = _PyRuntimeState_ReInitThreads(runtime);
+    ...
+
+    PyThreadState *tstate = _PyThreadState_GET();
+    _Py_EnsureTstateNotNULL(tstate);
+
+    ...
+
+    // Ideally we could guarantee tstate is running main.   ← !!!
+    _PyInterpreterState_ReinitRunningMain(tstate);
+
+    status = _PyEval_ReInitThreads(tstate);
+    ...
+
+    status = _PyInterpreterState_DeleteExceptMain(runtime);
+    if (_PyStatus_EXCEPTION(status)) {
+        goto fatal_error;
+    }
+    ...
+
+fatal_error:
+    Py_ExitStatusException(status);
+}
+```
+
+The `// Ideally we could guarantee tstate is running
+main.` comment is a flashing warning sign — the CPython
+devs *know* this path is fragile when fork is called from
+a non-main subint, but they've chosen to abort rather than
+silently corrupt state. Arguably the right call.
+
+### The refusal — `Python/pystate.c:1035-1075`
+
+```c
+/*
+ * Delete all interpreter states except the main interpreter.  If there
+ * is a current interpreter state, it *must* be the main interpreter.
+ */
+PyStatus
+_PyInterpreterState_DeleteExceptMain(_PyRuntimeState *runtime)
+{
+    struct pyinterpreters *interpreters = &runtime->interpreters;
+
+    PyThreadState *tstate = _PyThreadState_Swap(runtime, NULL);
+    if (tstate != NULL && tstate->interp != interpreters->main) {
+        return _PyStatus_ERR("not main interpreter");       ← our error
+    }
+
+    HEAD_LOCK(runtime);
+    PyInterpreterState *interp = interpreters->head;
+    interpreters->head = NULL;
+    while (interp != NULL) {
+        if (interp == interpreters->main) {
+            interpreters->main->next = NULL;
+            interpreters->head = interp;
+            interp = interp->next;
+            continue;
+        }
+
+        // XXX Won't this fail since PyInterpreterState_Clear() requires
+        // the "current" tstate to be set?
+        PyInterpreterState_Clear(interp);  // XXX must activate?
+        zapthreads(interp);
+        ...
+    }
+    ...
+}
+```
+
+The comment in the docstring (`If there is a current
+interpreter state, it *must* be the main interpreter.`) is
+the formal API contract. The `XXX` comments further in
+suggest the CPython team is already aware this function
+has latent issues even in the happy path.
+
+## Chain summary
+
+1. Our launchpad subint's driver OS-thread calls
+   `os.fork()`.
+2. `fork()` succeeds. Child wakes up with:
+   - The parent's full memory image (including all
+     subints).
+   - Only the *calling* thread alive (the driver thread).
+   - `_PyThreadState_GET()` on that thread returns the
+     **launchpad subint's tstate**, *not* main's.
+3. CPython runs `PyOS_AfterFork_Child()`.
+4. It reaches `_PyInterpreterState_DeleteExceptMain()`.
+5. Gate check fails: `tstate->interp != interpreters->main`.
+6. `PyStatus_ERR("not main interpreter")` → `fatal_error`
+   goto → `Py_ExitStatusException()` → child aborts.
+
+Parent-side consequence: `os.fork()` in the subint
+bootstrap returned successfully with the child's PID, but
+the child died before connecting back. Our parent's
+`ipc_server.wait_for_peer(uid)` would hang forever — the
+child never gets to `_actor_child_main`.
+
+## Definitive answer to "Open Question 1"
+
+From the (now-stub) `subint_fork_proc` docstring:
+
+> Does CPython allow `os.fork()` from a non-main
+> sub-interpreter under the legacy config?
+
+**No.** Not in a usable-by-user-code sense. The fork
+syscall is not blocked, but the child cannot survive
+CPython's post-fork initialization. This is enforced, not
+accidental, and the CPython devs have acknowledged the
+fragility in-source.
+
+## What we'd need from CPython to unblock
+
+Any one of these, from least-to-most invasive:
+
+1. **A pre-fork hook mechanism** that lets user code (or
+   tractor itself via `os.register_at_fork(before=...)`)
+   swap the current tstate to main before fork runs. The
+   swap would need to work across the subint→main
+   boundary, which is the actual hard part —
+   `_PyThreadState_Swap()` exists but is internal.
+
+2. **A `_PyInterpreterState_DeleteExceptFor(tstate->interp)`
+   variant** that cleans up all *other* subints while
+   preserving the calling subint's state. Lets the child
+   continue executing in the subint after fork; a
+   subsequent `execv()` clears everything at the OS
+   level anyway.
+
+3. **A cleaner error** than `Fatal Python error` aborting
+   the child. Even without fixing the underlying
+   capability, a raised Python-level exception in the
+   parent's `fork()` call (rather than a silent child
+   abort) would at least make the failure mode
+   debuggable.
+
+## Upstream-report draft (for CPython issue tracker)
+
+### Title
+
+> `os.fork()` from a non-main sub-interpreter aborts the
+> child with a fatal error in `PyOS_AfterFork_Child`; can
+> we at least make it a clean `RuntimeError` in the
+> parent?
+
+### Body
+
+> **Version**: Python 3.14.x
+>
+> **Summary**: Calling `os.fork()` from a thread currently
+> executing inside a sub-interpreter causes the forked
+> child process to abort during CPython's post-fork
+> cleanup, with the following output in the child:
+>
+> ```
+> Fatal Python error: _PyInterpreterState_DeleteExceptMain: not main interpreter
+> ```
+>
+> From the **parent's** point of view the fork succeeded
+> (returned a valid child PID). The failure is completely
+> opaque to parent-side Python code — unless the parent
+> does `os.waitpid()` it won't even notice the child
+> died.
+>
+> **Root cause** (as I understand it from reading sources):
+> `Modules/posixmodule.c::PyOS_AfterFork_Child()` calls
+> `_PyInterpreterState_DeleteExceptMain()` with a
+> precondition that `_PyThreadState_GET()->interp` be the
+> main interpreter. When `fork()` is called from a thread
+> executing inside a subinterpreter, the child wakes up
+> with its tstate still pointing at the subint, and the
+> gate in `Python/pystate.c:1044-1047` fails.
+>
+> A comment in the source
+> (`Modules/posixmodule.c:753` — `// Ideally we could
+> guarantee tstate is running main.`) suggests this is a
+> known-fragile path rather than an intentional
+> invariant.
+>
+> **Use case**: I was experimenting with using a
+> sub-interpreter as a "fork launchpad" — have a subint
+> that has never imported `trio`, call `os.fork()` from
+> that subint's thread, and in the child `execv()` back
+> into a fresh Python interpreter process. The goal was
+> to sidestep known issues with `trio` + `fork()`
+> interaction (see
+> [python-trio/trio#1614](https://github.com/python-trio/trio/issues/1614))
+> by guaranteeing the forking context had never been
+> "contaminated" by trio's imports or globals. This
+> approach would allow `trio`-using applications to
+> combine `fork`-based subprocess spawning with
+> per-worker `trio.run()` runtimes — a fairly common
+> pattern that currently requires workarounds.
+>
+> **Request**:
+>
+> Ideally: make fork-from-subint work (e.g., by swapping
+> the caller's tstate to main in the pre-fork hook), or
+> provide a `_PyInterpreterState_DeleteExceptFor(interp)`
+> variant that permits the caller's subint to survive
+> post-fork so user code can subsequently `execv()`.
+>
+> Minimally: convert the fatal child-side abort into a
+> clean `RuntimeError` (or similar) raised in the
+> parent's `fork()` call. Even if the capability isn't
+> expanded, the failure mode should be debuggable by
+> user-code in the parent — right now it's a silent
+> child death with an error message buried in the
+> child's stderr that parent code can't programmatically
+> see.
+>
+> **Related**: PEP 684 (per-interpreter GIL), PEP 734
+> (`concurrent.interpreters` public API). The private
+> `_interpreters` module is what I used to create the
+> launchpad — behavior is the same whether using
+> `_interpreters.create('legacy')` or
+> `concurrent.interpreters.create()` (the latter was not
+> tested but the gate is identical).
+>
+> Happy to contribute a minimal reproducer + test case if
+> this is something the team wants to pursue.
+
+## References
+
+- `Modules/posixmodule.c:728` —
+  [`PyOS_AfterFork_Child`](https://github.com/python/cpython/blob/main/Modules/posixmodule.c#L728)
+- `Python/pystate.c:1040` —
+  [`_PyInterpreterState_DeleteExceptMain`](https://github.com/python/cpython/blob/main/Python/pystate.c#L1040)
+- PEP 684 (per-interpreter GIL):
+  <https://peps.python.org/pep-0684/>
+- PEP 734 (`concurrent.interpreters` public API):
+  <https://peps.python.org/pep-0734/>
+- [python-trio/trio#1614](https://github.com/python-trio/trio/issues/1614)
+  — the original motivation for the launchpad idea.
+- tractor issue #379 — "Our own thoughts, ideas for
+  `fork()`-workaround/hacks..." section where this was
+  first sketched.
+- `tractor.spawn._subint_fork` — in-tree stub preserving
+  the attempted impl's shape in git history.

ai/conc-anal/subint_fork_from_main_thread_smoketest.py

@@ -0,0 +1,375 @@
+#!/usr/bin/env python3
+'''
+Standalone CPython-level feasibility check for the "main-interp
+worker-thread forkserver + subint-hosted trio" architecture
+proposed as a workaround to the CPython-level refusal
+documented in
+`ai/conc-anal/subint_fork_blocked_by_cpython_post_fork_issue.md`.
+
+Purpose
+-------
+Deliberately NOT a `tractor` test. Zero `tractor` imports.
+Uses `_interpreters` (private stdlib) + `os.fork()` directly so
+the signal is unambiguous — pass/fail here is a property of
+CPython alone, independent of our runtime.
+
+Run each scenario in isolation; the child's fate is observable
+only via `os.waitpid()` of the parent and the scenario's own
+status prints.
+
+Scenarios (pick one with `--scenario <name>`)
+---------------------------------------------
+
+- `control_subint_thread_fork` — the KNOWN-BROKEN case we
+  documented in `subint_fork_blocked_by_cpython_post_fork_issue.md`:
+  drive a subint from a thread, call `os.fork()` inside its
+  `_interpreters.exec()`, watch the child abort. **Included as
+  a control** — if this scenario DOESN'T abort the child, our
+  analysis is wrong and we should re-check everything.
+
+- `main_thread_fork` — baseline sanity. Call `os.fork()` from
+  the process's main thread. Must always succeed; if this
+  fails something much bigger is broken.
+
+- `worker_thread_fork` — the architectural assertion. Spawn a
+  regular `threading.Thread` (attached to main interp, NOT a
+  subint), have IT call `os.fork()`. Child should survive
+  post-fork cleanup.
+
+- `full_architecture` — end-to-end: main-interp worker thread
+  forks. In the child, fork-thread (still main-interp) creates
+  a subint, drives a second worker thread inside it that runs
+  a trivial `trio.run()`. Validates the "root runtime lives in
+  a subint in the child" piece of the proposed arch.
+
+All scenarios print a self-contained pass/fail banner. Exit
+code 0 on expected outcome (which for `control_*` means "child
+aborted", not "child succeeded"!).
+
+Requires Python 3.14+.
+
+Usage
+-----
+::
+
+    python subint_fork_from_main_thread_smoketest.py \\
+        --scenario main_thread_fork
+
+    python subint_fork_from_main_thread_smoketest.py \\
+        --scenario full_architecture
+
+'''
+from __future__ import annotations
+import argparse
+import os
+import sys
+import threading
+import time
+
+
+# Hard-require py3.14 for the public `concurrent.interpreters`
+# API (we still drop to `_interpreters` internally, same as
+# `tractor.spawn._subint`).
+try:
+    from concurrent import interpreters as _public_interpreters  # noqa: F401
+    import _interpreters  # type: ignore
+except ImportError:
+    print(
+        'FAIL (setup): requires Python 3.14+ '
+        '(missing `concurrent.interpreters`)',
+        file=sys.stderr,
+    )
+    sys.exit(2)
+
+
+# The actual primitives this script exercises live in
+# `tractor.spawn._subint_forkserver` — we re-import them here
+# rather than inlining so the module and the validation stay
+# in sync. (Early versions of this file had them inline for
+# the "zero tractor imports" isolation guarantee; now that
+# CPython-level feasibility is confirmed, the validated
+# primitives have moved into tractor proper.)
+from tractor.spawn._main_thread_forkserver import (
+    fork_from_worker_thread,
+    wait_child,
+)
+from tractor.spawn._subint_forkserver import (
+    run_subint_in_worker_thread,
+)
+
+
+# ----------------------------------------------------------------
+# small observability helpers (test-harness only)
+# ----------------------------------------------------------------
+
+
+def _banner(title: str) -> None:
+    line = '=' * 60
+    print(f'\n{line}\n{title}\n{line}', flush=True)
+
+
+def _report(
+    label: str,
+    *,
+    ok: bool,
+    status_str: str,
+    expect_exit_ok: bool,
+) -> None:
+    verdict: str = 'PASS' if ok else 'FAIL'
+    expected_str: str = (
+        'normal exit (rc=0)'
+        if expect_exit_ok
+        else 'abnormal death (signal or nonzero exit)'
+    )
+    print(
+        f'[{verdict}] {label}: '
+        f'expected {expected_str}; observed {status_str}',
+        flush=True,
+    )
+
+
+# ----------------------------------------------------------------
+# scenario: `control_subint_thread_fork` (known-broken)
+# ----------------------------------------------------------------
+
+
+def scenario_control_subint_thread_fork() -> int:
+    _banner(
+        '[control] fork from INSIDE a subint (expected: child aborts)'
+    )
+    interp_id = _interpreters.create('legacy')
+    print(f'  created subint {interp_id}', flush=True)
+
+    # Shared flag: child writes a sentinel file we can detect from
+    # the parent. If the child manages to write this, CPython's
+    # post-fork refusal is NOT happening → analysis is wrong.
+    sentinel = '/tmp/subint_fork_smoketest_control_child_ran'
+    try:
+        os.unlink(sentinel)
+    except FileNotFoundError:
+        pass
+
+    bootstrap = (
+        'import os\n'
+        'pid = os.fork()\n'
+        'if pid == 0:\n'
+        # child — if CPython's refusal fires this code never runs
+        f'    with open({sentinel!r}, "w") as f:\n'
+        '        f.write("ran")\n'
+        '    os._exit(0)\n'
+        'else:\n'
+        # parent side (inside the launchpad subint) — stash the
+        # forked PID on a shareable dict so we can waitpid()
+        # from the outer main interp. We can't just return it;
+        # _interpreters.exec() returns nothing useful.
+        '    import builtins\n'
+        '    builtins._forked_child_pid = pid\n'
+    )
+
+    # NOTE, we can't easily pull state back from the subint.
+    # For the CONTROL scenario we just time-bound the fork +
+    # check the sentinel. If sentinel exists → child ran →
+    # analysis wrong. If not → child aborted → analysis
+    # confirmed.
+    done = threading.Event()
+
+    def _drive() -> None:
+        try:
+            _interpreters.exec(interp_id, bootstrap)
+        except Exception as err:
+            print(
+                f'  subint bootstrap raised (expected on some '
+                f'CPython versions): {type(err).__name__}: {err}',
+                flush=True,
+            )
+        finally:
+            done.set()
+
+    t = threading.Thread(
+        target=_drive,
+        name='control-subint-fork-launchpad',
+        daemon=True,
+    )
+    t.start()
+    done.wait(timeout=5.0)
+    t.join(timeout=2.0)
+
+    # Give the (possibly-aborted) child a moment to die.
+    time.sleep(0.5)
+
+    sentinel_present = os.path.exists(sentinel)
+    verdict = (
+        # "PASS" for our analysis means sentinel NOT present.
+        'PASS' if not sentinel_present else 'FAIL (UNEXPECTED)'
+    )
+    print(
+        f'[{verdict}] control: sentinel present={sentinel_present} '
+        f'(analysis predicts False — child should abort before '
+        f'writing)',
+        flush=True,
+    )
+    if sentinel_present:
+        os.unlink(sentinel)
+
+    try:
+        _interpreters.destroy(interp_id)
+    except _interpreters.InterpreterError:
+        pass
+
+    return 0 if not sentinel_present else 1
+
+
+# ----------------------------------------------------------------
+# scenario: `main_thread_fork` (baseline sanity)
+# ----------------------------------------------------------------
+
+
+def scenario_main_thread_fork() -> int:
+    _banner(
+        '[baseline] fork from MAIN thread (expected: child exits normally)'
+    )
+
+    pid = os.fork()
+    if pid == 0:
+        os._exit(0)
+
+    return 0 if _wait_child(
+        pid,
+        label='main_thread_fork',
+        expect_exit_ok=True,
+    ) else 1
+
+
+# ----------------------------------------------------------------
+# scenario: `worker_thread_fork` (architectural assertion)
+# ----------------------------------------------------------------
+
+
+def _run_worker_thread_fork_scenario(
+    label: str,
+    *,
+    child_target=None,
+) -> int:
+    '''
+    Thin wrapper: delegate the actual fork to the
+    `tractor.spawn._subint_forkserver` primitive, then wait
+    on the child and render a pass/fail banner.
+
+    '''
+    try:
+        pid: int = fork_from_worker_thread(
+            child_target=child_target,
+            thread_name=f'worker-fork-thread[{label}]',
+        )
+    except RuntimeError as err:
+        print(f'[FAIL] {label}: {err}', flush=True)
+        return 1
+    print(f'  forked child pid={pid}', flush=True)
+    ok, status_str = wait_child(pid, expect_exit_ok=True)
+    _report(
+        label,
+        ok=ok,
+        status_str=status_str,
+        expect_exit_ok=True,
+    )
+    return 0 if ok else 1
+
+
+def scenario_worker_thread_fork() -> int:
+    _banner(
+        '[arch] fork from MAIN-INTERP WORKER thread '
+        '(expected: child exits normally — this is the one '
+        'that matters)'
+    )
+    return _run_worker_thread_fork_scenario(
+        'worker_thread_fork',
+    )
+
+
+# ----------------------------------------------------------------
+# scenario: `full_architecture`
+# ----------------------------------------------------------------
+
+
+_CHILD_TRIO_BOOTSTRAP: str = (
+    'import trio\n'
+    'async def _main():\n'
+    '    await trio.sleep(0.05)\n'
+    '    return 42\n'
+    'result = trio.run(_main)\n'
+    'assert result == 42, f"trio.run returned {result}"\n'
+    'print("  CHILD subint: trio.run OK, result=42", '
+    'flush=True)\n'
+)
+
+
+def _child_trio_in_subint() -> int:
+    '''
+    CHILD-side `child_target`: drive a trivial `trio.run()`
+    inside a fresh legacy-config subint on a worker thread,
+    using the `tractor.spawn._subint_forkserver.run_subint_in_worker_thread`
+    primitive. Returns 0 on success.
+
+    '''
+    try:
+        run_subint_in_worker_thread(
+            _CHILD_TRIO_BOOTSTRAP,
+            thread_name='child-subint-trio-thread',
+        )
+    except RuntimeError as err:
+        print(
+            f'  CHILD: run_subint_in_worker_thread timed out / thread '
+            f'never returned: {err}',
+            flush=True,
+        )
+        return 3
+    except BaseException as err:
+        print(
+            f'  CHILD: subint bootstrap raised: '
+            f'{type(err).__name__}: {err}',
+            flush=True,
+        )
+        return 4
+    return 0
+
+
+def scenario_full_architecture() -> int:
+    _banner(
+        '[arch-full] worker-thread fork + child runs trio in a '
+        'subint (end-to-end proposed arch)'
+    )
+    return _run_worker_thread_fork_scenario(
+        'full_architecture',
+        child_target=_child_trio_in_subint,
+    )
+
+
+# ----------------------------------------------------------------
+# main
+# ----------------------------------------------------------------
+
+
+SCENARIOS: dict[str, Callable[[], int]] = {
+    'control_subint_thread_fork': scenario_control_subint_thread_fork,
+    'main_thread_fork': scenario_main_thread_fork,
+    'worker_thread_fork': scenario_worker_thread_fork,
+    'full_architecture': scenario_full_architecture,
+}
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser(
+        description=__doc__,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    ap.add_argument(
+        '--scenario',
+        choices=sorted(SCENARIOS.keys()),
+        required=True,
+    )
+    args = ap.parse_args()
+    return SCENARIOS[args.scenario]()
+
+
+if __name__ == '__main__':
+    sys.exit(main())

ai/conc-anal/subint_forkserver_orphan_sigint_hang_issue.md

@@ -0,0 +1,385 @@
+# `subint_forkserver` backend: orphaned-subactor SIGINT wedged in `epoll_wait`
+
+Follow-up to the Phase C `subint_forkserver` spawn-backend
+PR (see `tractor.spawn._subint_forkserver`, issue #379).
+Surfaced by the xfail'd
+`tests/spawn/test_subint_forkserver.py::test_orphaned_subactor_sigint_cleanup_DRAFT`.
+
+Related-but-distinct from
+`subint_cancel_delivery_hang_issue.md` (orphaned-channel
+park AFTER subint teardown) and
+`subint_sigint_starvation_issue.md` (GIL-starvation,
+SIGINT never delivered): here the SIGINT IS delivered,
+trio's handler IS installed, but trio's event loop never
+wakes — so the KBI-at-checkpoint → `_trio_main` catch path
+(which is the runtime's *intentional* OS-cancel design)
+never fires.
+
+## TL;DR
+
+When a `subint_forkserver`-spawned subactor is orphaned
+(parent `SIGKILL`'d, no IPC cancel path available) and then
+externally `SIGINT`'d, the subactor hangs in
+`trio/_core/_io_epoll.py::get_events` (epoll_wait)
+indefinitely — even though:
+
+1. `threading.current_thread() is threading.main_thread()`
+   post-fork (CPython 3.14 re-designates correctly).
+2. Trio's SIGINT handler IS installed in the subactor
+   (`signal.getsignal(SIGINT)` returns
+   `<function KIManager.install.<locals>.handler at 0x...>`).
+3. The kernel does deliver SIGINT — the signal arrives at
+   the only thread in the process (the fork-inherited
+   worker which IS now "main" per Python).
+
+Yet `epoll_wait` does not return. Trio's wakeup-fd mechanism
+— the machinery that turns SIGINT into an epoll-wake — is
+somehow not firing the wakeup. Until that's fixed, the
+intentional "KBI-as-OS-cancel" path in
+`tractor/spawn/_entry.py::_trio_main:164` is unreachable
+for forkserver-spawned subactors whose parent dies.
+
+## Symptom
+
+Test: `tests/spawn/test_subint_forkserver.py::test_orphaned_subactor_sigint_cleanup_DRAFT`
+(currently marked `@pytest.mark.xfail(strict=True)`).
+
+1. Harness subprocess brings up a tractor root actor +
+   one `run_in_actor(_sleep_forever)` subactor via
+   `try_set_start_method('subint_forkserver')`.
+2. Harness prints `CHILD_PID` (subactor) and
+   `PARENT_READY` (root actor) markers to stdout.
+3. Test `os.kill(parent_pid, SIGKILL)` + `proc.wait()`
+   to fully reap the root-actor harness.
+4. Child (now reparented to pid 1) is still alive.
+5. Test `os.kill(child_pid, SIGINT)` and polls
+   `os.kill(child_pid, 0)` for up to 10s.
+6. **Observed**: the child is still alive at deadline —
+   SIGINT did not unwedge the trio loop.
+
+## What the "intentional" cancel path IS
+
+`tractor/spawn/_entry.py::_trio_main:157-186` —
+
+```python
+try:
+    if infect_asyncio:
+        actor._infected_aio = True
+        run_as_asyncio_guest(trio_main)
+    else:
+        trio.run(trio_main)
+
+except KeyboardInterrupt:
+    logmeth = log.cancel
+    exit_status: str = (
+        'Actor received KBI (aka an OS-cancel)\n'
+        ...
+    )
+```
+
+The "KBI == OS-cancel" mapping IS the runtime's
+deliberate, documented design. An OS-level SIGINT should
+flow as: kernel → trio handler → KBI at trio checkpoint
+→ unwinds `async_main` → surfaces at `_trio_main`'s
+`except KeyboardInterrupt:` → `log.cancel` + clean `rc=0`.
+
+**So fixing this hang is not "add a new SIGINT behavior" —
+it's "make the existing designed behavior actually fire in
+this backend config".** That's why option (B) ("fix root
+cause") is aligned with existing design intent, not a
+scope expansion.
+
+## Evidence
+
+### Positive control: standalone fork-from-worker + `trio.run(sleep_forever)` + SIGINT WORKS
+
+```python
+import os, signal, time, trio
+from tractor.spawn._subint_forkserver import (
+    fork_from_worker_thread, wait_child,
+)
+
+def child_target() -> int:
+    async def _main():
+        try:
+            await trio.sleep_forever()
+        except KeyboardInterrupt:
+            print('CHILD: caught KBI — trio SIGINT works!')
+            return
+    trio.run(_main)
+    return 0
+
+pid = fork_from_worker_thread(child_target, thread_name='trio-sigint-test')
+time.sleep(1.0)
+os.kill(pid, signal.SIGINT)
+wait_child(pid)
+```
+
+Result: `CHILD: caught KBI — trio SIGINT works!` + clean
+exit. So the fork-child + trio signal plumbing IS healthy
+in isolation. The hang appears only with the full tractor
+subactor runtime on top.
+
+### Negative test: full tractor subactor + orphan-SIGINT
+
+Equivalent to the xfail test. Traceback dump via
+`faulthandler.register(SIGUSR1, all_threads=True)` at the
+stuck moment:
+
+```
+Current thread 0x00007... [subint-forkserv] (most recent call first):
+  File ".../trio/_core/_io_epoll.py", line 245 in get_events
+  File ".../trio/_core/_run.py", line 2415 in run
+  File "tractor/spawn/_entry.py", line 162 in _trio_main
+  File "tractor/_child.py", line 72 in _actor_child_main
+  File "tractor/spawn/_subint_forkserver.py", line 650 in _child_target
+  File "tractor/spawn/_subint_forkserver.py", line 308 in _worker
+  File ".../threading.py", line 1024 in run
+```
+
+### Thread + signal-mask inventory of the stuck subactor
+
+Single thread (`tid == pid`, comm `'subint-forkserv'`,
+which IS `threading.main_thread()` post-fork):
+
+```
+SigBlk:  0000000000000000  # nothing blocked
+SigIgn:  0000000001001000  # SIGPIPE etc (Python defaults)
+SigCgt:  0000000108000202  # bit 1 = SIGINT caught
+```
+
+Bit 1 set in `SigCgt` → SIGINT handler IS installed. So
+trio's handler IS in place at the kernel level — not a
+"handler missing" situation.
+
+### Handler identity
+
+Inside the subactor's RPC body, `signal.getsignal(SIGINT)`
+returns `<function KIManager.install.<locals>.handler at
+0x...>` — trio's own `KIManager` handler. tractor's only
+SIGINT touches are `signal.getsignal()` *reads* (to stash
+into `debug.DebugStatus._trio_handler`); nothing writes
+over trio's handler outside the debug-REPL shielding path
+(`devx/debug/_tty_lock.py::shield_sigint`) which isn't
+engaged here (no debug_mode).
+
+## Ruled out
+
+- **GIL starvation / signal-pipe-full** (class A,
+  `subint_sigint_starvation_issue.md`): subactor runs on
+  its own GIL (separate OS process), not sharing with the
+  parent → no cross-process GIL contention. And `strace`-
+  equivalent in the signal mask shows SIGINT IS caught,
+  not queued.
+- **Orphaned channel park** (`subint_cancel_delivery_hang_issue.md`):
+  different failure mode — that one has trio iterating
+  normally and getting wedged on an orphaned
+  `chan.recv()` AFTER teardown. Here trio's event loop
+  itself never wakes.
+- **Tractor explicitly catching + swallowing KBI**:
+  greppable — the one `except KeyboardInterrupt:` in the
+  runtime is the INTENTIONAL cancel-path catch at
+  `_trio_main:164`. `async_main` uses `except Exception`
+  (not BaseException), so KBI should propagate through
+  cleanly if it ever fires.
+- **Missing `signal.set_wakeup_fd` (main-thread
+  restriction)**: post-fork, the fork-worker thread IS
+  `threading.main_thread()`, so trio's main-thread check
+  passes and its wakeup-fd install should succeed.
+
+## Root cause hypothesis (unverified)
+
+The SIGINT handler fires but trio's wakeup-fd write does
+not wake `epoll_wait`. Candidate causes, ranked by
+plausibility:
+
+1. **Wakeup-fd lifecycle race around tractor IPC setup.**
+   `async_main` spins up an IPC server + `process_messages`
+   loops early. Somewhere in that path the wakeup-fd that
+   trio registered with its epoll instance may be
+   closed/replaced/clobbered, so subsequent SIGINT writes
+   land on an fd that's no longer in the epoll set.
+   Evidence needed: compare
+   `signal.set_wakeup_fd(-1)` return value inside a
+   post-tractor-bringup RPC body vs. a pre-bringup
+   equivalent. If they differ, that's it.
+2. **Shielded cancel scope around `process_messages`.**
+   The RPC message loop is likely wrapped in a trio cancel
+   scope; if that scope is `shield=True` at any outer
+   layer, KBI scheduled at a checkpoint could be absorbed
+   by the shield and never bubble out to `_trio_main`.
+3. **Pre-fork wakeup-fd inheritance.** trio in the PARENT
+   process registered a wakeup-fd with its own epoll. The
+   child inherits the fd number but not the parent's
+   epoll instance — if tractor/trio re-uses the parent's
+   stale fd number anywhere, writes would go to a no-op
+   fd. (This is the least likely — `trio.run()` on the
+   child calls `KIManager.install` which should install a
+   fresh wakeup-fd from scratch.)
+
+## Cross-backend scope question
+
+**Untested**: does the same orphan-SIGINT hang reproduce
+against the `trio_proc` backend (stock subprocess + exec)?
+If yes → pre-existing tractor bug, independent of
+`subint_forkserver`. If no → something specific to the
+fork-from-worker path (e.g. inherited fds, mid-epoll-setup
+interference).
+
+**Quick repro for trio_proc**:
+
+```python
+# save as /tmp/trio_proc_orphan_sigint_repro.py
+import os, sys, signal, time, glob
+import subprocess as sp
+
+SCRIPT = '''
+import os, sys, trio, tractor
+async def _sleep_forever():
+    print(f"CHILD_PID={os.getpid()}", flush=True)
+    await trio.sleep_forever()
+
+async def _main():
+    async with (
+        tractor.open_root_actor(registry_addrs=[("127.0.0.1", 12350)]),
+        tractor.open_nursery() as an,
+    ):
+        await an.run_in_actor(_sleep_forever, name="sf-child")
+        print(f"PARENT_READY={os.getpid()}", flush=True)
+        await trio.sleep_forever()
+
+trio.run(_main)
+'''
+
+proc = sp.Popen(
+    [sys.executable, '-c', SCRIPT],
+    stdout=sp.PIPE, stderr=sp.STDOUT,
+)
+# parse CHILD_PID + PARENT_READY off proc.stdout ...
+# SIGKILL parent, SIGINT child, poll.
+```
+
+If that hangs too, open a broader issue; if not, this is
+`subint_forkserver`-specific (likely fd-inheritance-related).
+
+## Why this is ours to fix (not CPython's)
+
+- Signal IS delivered (`SigCgt` bitmask confirms).
+- Handler IS installed (trio's `KIManager`).
+- Thread identity is correct post-fork.
+- `_trio_main` already has the intentional KBI→clean-exit
+  path waiting to fire.
+
+Every CPython-level precondition is met. Something in
+tractor's runtime or trio's integration with it is
+breaking the SIGINT→wakeup→event-loop-wake pipeline.
+
+## Possible fix directions
+
+1. **Audit the wakeup-fd across tractor's IPC bringup.**
+   Add a trio startup hook that captures
+   `signal.set_wakeup_fd(-1)` at `_trio_main` entry,
+   after `async_main` enters, and periodically — assert
+   it's unchanged. If it moves, track down the writer.
+2. **Explicit `signal.set_wakeup_fd` reset after IPC
+   setup.** Brute force: re-install a fresh wakeup-fd
+   mid-bringup. Band-aid, but fast to try.
+3. **Ensure no `shield=True` cancel scope envelopes the
+   RPC-message-loop / IPC-server task.** If one does,
+   KBI-at-checkpoint never escapes.
+4. **Once fixed, the `child_sigint='trio'` mode on
+   `subint_forkserver_proc`** becomes effectively a no-op
+   or a doc-only mode — trio's natural handler already
+   does the right thing. Might end up removing the flag
+   entirely if there's no behavioral difference between
+   modes.
+
+## Current workaround
+
+None; `child_sigint` defaults to `'ipc'` (IPC cancel is
+the only reliable cancel path today), and the xfail test
+documents the gap. Operators hitting orphan-SIGINT get a
+hung process that needs `SIGKILL`.
+
+## Reproducer
+
+Inline, standalone (no pytest):
+
+```python
+# save as /tmp/orphan_sigint_repro.py  (py3.14+)
+import os, sys, signal, time, glob, trio
+import tractor
+from tractor.spawn._subint_forkserver import (
+    fork_from_worker_thread,
+)
+
+async def _sleep_forever():
+    print(f'SUBACTOR[{os.getpid()}]', flush=True)
+    await trio.sleep_forever()
+
+async def _main():
+    async with (
+        tractor.open_root_actor(
+            registry_addrs=[('127.0.0.1', 12349)],
+        ),
+        tractor.open_nursery() as an,
+    ):
+        await an.run_in_actor(_sleep_forever, name='sf-child')
+        await trio.sleep_forever()
+
+def child_target() -> int:
+    from tractor.spawn._spawn import try_set_start_method
+    try_set_start_method('subint_forkserver')
+    trio.run(_main)
+    return 0
+
+pid = fork_from_worker_thread(child_target, thread_name='repro')
+time.sleep(3.0)
+
+# find the subactor pid via /proc
+children = []
+for path in glob.glob(f'/proc/{pid}/task/*/children'):
+    with open(path) as f:
+        children.extend(int(x) for x in f.read().split() if x)
+subactor_pid = children[0]
+
+# SIGKILL root → orphan the subactor
+os.kill(pid, signal.SIGKILL)
+os.waitpid(pid, 0)
+time.sleep(0.3)
+
+# SIGINT the orphan — should cause clean trio exit
+os.kill(subactor_pid, signal.SIGINT)
+
+# poll for exit
+for _ in range(100):
+    try:
+        os.kill(subactor_pid, 0)
+        time.sleep(0.1)
+    except ProcessLookupError:
+        print('HARNESS: subactor exited cleanly ✔')
+        sys.exit(0)
+os.kill(subactor_pid, signal.SIGKILL)
+print('HARNESS: subactor hung — reproduced')
+sys.exit(1)
+```
+
+Expected (current): `HARNESS: subactor hung — reproduced`.
+
+After fix: `HARNESS: subactor exited cleanly ✔`.
+
+## References
+
+- `tractor/spawn/_entry.py::_trio_main:157-186` — the
+  intentional KBI→clean-exit path this bug makes
+  unreachable.
+- `tractor/spawn/_subint_forkserver` — the backend whose
+  orphan cancel-robustness this blocks.
+- `tests/spawn/test_subint_forkserver.py::test_orphaned_subactor_sigint_cleanup_DRAFT`
+  — the xfail'd reproducer in the test suite.
+- `ai/conc-anal/subint_cancel_delivery_hang_issue.md` —
+  sibling "orphaned channel park" hang (different class).
+- `ai/conc-anal/subint_sigint_starvation_issue.md` —
+  sibling "GIL starvation SIGINT drop" hang (different
+  class).
+- tractor issue #379 — subint backend tracking.

ai/conc-anal/subint_forkserver_test_cancellation_leak_issue.md

@@ -0,0 +1,851 @@
+# `subint_forkserver` backend: `test_cancellation.py` multi-level cancel cascade hang
+
+> **Tracked at:** [#449](https://github.com/goodboy/tractor/issues/449)
+
+Follow-up tracker: surfaced while wiring the new
+`subint_forkserver` spawn backend into the full tractor
+test matrix (step 2 of the post-backend-lands plan).
+See also
+`ai/conc-anal/subint_forkserver_orphan_sigint_hang_issue.md`
+— sibling tracker for a different forkserver-teardown
+class which probably shares the same fundamental root
+cause (fork-FD-inheritance across nested spawns).
+
+## TL;DR
+
+`tests/test_cancellation.py::test_nested_multierrors[subint_forkserver]`
+hangs indefinitely under our new backend. The hang is
+**inside the graceful IPC cancel cascade** — every actor
+in the multi-level tree parks in `epoll_wait` waiting
+for IPC messages that never arrive. Not a hard-kill /
+tree-reap issue (we don't reach the hard-kill fallback
+path at all).
+
+Working hypothesis (unverified): **`os.fork()` from a
+subactor inherits the root parent's IPC listener socket
+FDs**. When a first-level subactor forkserver-spawns a
+grandchild, that grandchild inherits both its direct
+spawner's FDs AND the root's FDs — IPC message routing
+becomes ambiguous (or silently sends to the wrong
+channel), so the cancel cascade can't reach its target.
+
+## Corrected diagnosis vs. earlier draft
+
+An earlier version of this doc claimed the root cause
+was **"forkserver teardown doesn't tree-kill
+descendants"** (SIGKILL only reaches the direct child,
+grandchildren survive and hold TCP `:1616`). That
+diagnosis was **wrong**, caused by conflating two
+observations:
+
+1. *5-zombie leak holding :1616* — happened in my own
+   workflow when I aborted a bg pytest task with
+   `pkill` (SIGTERM/SIGKILL, not SIGINT). The abrupt
+   kill skipped the graceful `ActorNursery.__aexit__`
+   cancel cascade entirely, orphaning descendants to
+   init. **This was my cleanup bug, not a forkserver
+   teardown bug.** Codified the fix (SIGINT-first +
+   bounded wait before SIGKILL) in
+   `feedback_sc_graceful_cancel_first.md` +
+   `.claude/skills/run-tests/SKILL.md`.
+2. *`test_nested_multierrors` hangs indefinitely* —
+   the real, separate, forkserver-specific bug
+   captured by this doc.
+
+The two symptoms are unrelated. The tree-kill / setpgrp
+fix direction proposed earlier would not help (1) (SC-
+graceful-cleanup is the right answer there) and would
+not help (2) (the hang is in the cancel cascade, not
+in the hard-kill fallback).
+
+## Symptom
+
+Reproducer (py3.14, clean env):
+
+```sh
+# preflight: ensure clean env
+ss -tlnp 2>/dev/null | grep ':1616' && echo 'FOUL — cleanup first!' || echo 'clean'
+
+./py314/bin/python -m pytest --spawn-backend=subint_forkserver \
+  'tests/test_cancellation.py::test_nested_multierrors[subint_forkserver]' \
+  --timeout=30 --timeout-method=thread --tb=short -v
+```
+
+Expected: `pytest-timeout` fires at 30s with a thread-
+dump banner, but the process itself **remains alive
+after timeout** and doesn't unwedge on subsequent
+SIGINT. Requires SIGKILL to reap.
+
+## Evidence (tree structure at hang point)
+
+All 5 processes are kernel-level `S` (sleeping) in
+`do_epoll_wait` (trio's event loop waiting on I/O):
+
+```
+PID     PPID    THREADS  NAME             ROLE
+333986  1       2        subint-forkserv  pytest main (the test body)
+333993  333986  3        subint-forkserv  "child 1" spawner subactor
+  334003 333993 1        subint-forkserv  grandchild errorer under child-1
+  334014 333993 1        subint-forkserv  grandchild errorer under child-1
+333999  333986  1        subint-forkserv  "child 2" spawner subactor (NO grandchildren!)
+```
+
+### Asymmetric tree depth
+
+The test's `spawn_and_error(breadth=2, depth=3)` should
+have BOTH direct children spawning 2 grandchildren
+each, going 3 levels deep. Reality:
+
+- Child 1 (333993, 3 threads) DID spawn its two
+  grandchildren as expected — fully booted trio
+  runtime.
+- Child 2 (333999, 1 thread) did NOT spawn any
+  grandchildren — clearly never completed its
+  nursery's first `run_in_actor`. Its 1-thread state
+  suggests the runtime never fully booted (no trio
+  worker threads for `waitpid`/IPC).
+
+This asymmetry is the key clue: the two direct
+children started identically but diverged. Probably a
+race around fork-inherited state (listener FDs,
+subactor-nursery channel state) that happens to land
+differently depending on spawn ordering.
+
+### Parent-side state
+
+Thread-dump of pytest main (333986) at the hang:
+
+- Main trio thread — parked in
+  `trio._core._io_epoll.get_events` (epoll_wait on
+  its event loop). Waiting for IPC from children.
+- Two trio-cache worker threads — each parked in
+  `outcome.capture(sync_fn)` calling
+  `os.waitpid(child_pid, 0)`. These are our
+  `_ForkedProc.wait()` off-loads. They're waiting for
+  the direct children to exit — but children are
+  stuck in their own epoll_wait waiting for IPC from
+  the parent.
+
+**It's a deadlock, not a leak:** the parent is
+correctly running `soft_kill(proc, _ForkedProc.wait,
+portal)` (graceful IPC cancel via
+`Portal.cancel_actor()`), but the children never
+acknowledge the cancel message (or the message never
+reaches them through the tangled post-fork IPC).
+
+## What's NOT the cause (ruled out)
+
+- **`_ForkedProc.kill()` only SIGKILLs direct pid /
+  missing tree-kill**: doesn't apply — we never reach
+  the hard-kill path. The deadlock is in the graceful
+  cancel cascade.
+- **Port `:1616` contention**: ruled out after the
+  `reg_addr` fixture-wiring fix; each test session
+  gets a unique port now.
+- **GIL starvation / SIGINT pipe filling** (class-A,
+  `subint_sigint_starvation_issue.md`): doesn't apply
+  — each subactor is its own OS process with its own
+  GIL (not legacy-config subint).
+- **Child-side `_trio_main` absorbing KBI**: grep
+  confirmed; `_trio_main` only catches KBI at the
+  `trio.run()` callsite, which is reached only if the
+  trio loop exits normally. The children here never
+  exit trio.run() — they're wedged inside.
+
+## Hypothesis: FD inheritance across nested forks
+
+`subint_forkserver_proc` calls
+`fork_from_worker_thread()` which ultimately does
+`os.fork()` from a dedicated worker thread. Standard
+Linux/POSIX fork semantics: **the child inherits ALL
+open FDs from the parent**, including listener
+sockets, epoll fds, trio wakeup pipes, and the
+parent's IPC channel sockets.
+
+At root-actor fork-spawn time, the root's IPC server
+listener FDs are open in the parent. Those get
+inherited by child 1. Child 1 then forkserver-spawns
+its OWN subactor (grandchild). The grandchild
+inherits FDs from child 1 — but child 1's address
+space still contains **the root's IPC listener FDs
+too** (inherited at first fork). So the grandchild
+has THREE sets of FDs:
+
+1. Its own (created after becoming a subactor).
+2. Its direct parent child-1's.
+3. The ROOT's (grandparent's) — inherited transitively.
+
+IPC message routing may be ambiguous in this tangled
+state. Or a listener socket that the root thinks it
+owns is actually open in multiple processes, and
+messages sent to it go to an arbitrary one. That
+would exactly match the observed "graceful cancel
+never propagates".
+
+This hypothesis predicts the bug **scales with fork
+depth**: single-level forkserver spawn
+(`test_subint_forkserver_spawn_basic`) works
+perfectly, but any test that spawns a second level
+deadlocks. Matches observations so far.
+
+## Fix directions (to validate)
+
+### 1. `close_fds=True` equivalent in `fork_from_worker_thread()`
+
+`subprocess.Popen` / `trio.lowlevel.open_process` have
+`close_fds=True` by default on POSIX — they
+enumerate open FDs in the child post-fork and close
+everything except stdio + any explicitly-passed FDs.
+Our raw `os.fork()` doesn't. Adding the equivalent to
+our `_worker` prelude would isolate each fork
+generation's FD set.
+
+Implementation sketch in
+`tractor.spawn._subint_forkserver.fork_from_worker_thread._worker`:
+
+```python
+def _worker() -> None:
+    pid: int = os.fork()
+    if pid == 0:
+        # CHILD: close inherited FDs except stdio + the
+        # pid-pipe we just opened.
+        keep: set[int] = {0, 1, 2, rfd, wfd}
+        import resource
+        soft, _ = resource.getrlimit(resource.RLIMIT_NOFILE)
+        os.closerange(3, soft)  # blunt; or enumerate /proc/self/fd
+        # ... then child_target() as before
+```
+
+Problem: overly aggressive — closes FDs the
+grandchild might legitimately need (e.g. its parent's
+IPC channel for the spawn-spec handshake, if we rely
+on that). Needs thought about which FDs are
+"inheritable and safe" vs. "inherited by accident".
+
+### 2. Cloexec on tractor's own FDs
+
+Set `FD_CLOEXEC` on tractor-created sockets (listener
+sockets, IPC channel sockets, pipes). This flag
+causes automatic close on `execve`, but since we
+`fork()` without `exec()`, this alone doesn't help.
+BUT — combined with a child-side explicit close-
+non-cloexec loop, it gives us a way to mark "my
+private FDs" vs. "safe to inherit". Most robust, but
+requires tractor-wide audit.
+
+### 3. Explicit FD cleanup in `_ForkedProc`/`_child_target`
+
+Have `subint_forkserver_proc`'s `_child_target`
+closure explicitly close the parent-side IPC listener
+FDs before calling `_actor_child_main`. Requires
+being able to enumerate "the parent's listener FDs
+that the child shouldn't keep" — plausible via
+`Actor.ipc_server`'s socket objects.
+
+### 4. Use `os.posix_spawn` with explicit `file_actions`
+
+Instead of raw `os.fork()`, use `os.posix_spawn()`
+which supports explicit file-action specifications
+(close this FD, dup2 that FD). Cleaner semantics, but
+probably incompatible with our "no exec" requirement
+(subint_forkserver is a fork-without-exec design).
+
+**Likely correct answer: (3) — targeted FD cleanup
+via `actor.ipc_server` handle.** (1) is too blunt,
+(2) is too wide-ranging, (4) changes the spawn
+mechanism.
+
+## Reproducer (standalone, no pytest)
+
+```python
+# save as /tmp/forkserver_nested_hang_repro.py  (py3.14+)
+import trio, tractor
+
+async def assert_err():
+    assert 0
+
+async def spawn_and_error(breadth: int = 2, depth: int = 1):
+    async with tractor.open_nursery() as n:
+        for i in range(breadth):
+            if depth > 0:
+                await n.run_in_actor(
+                    spawn_and_error,
+                    breadth=breadth,
+                    depth=depth - 1,
+                    name=f'spawner_{i}_{depth}',
+                )
+            else:
+                await n.run_in_actor(
+                    assert_err,
+                    name=f'errorer_{i}',
+                )
+
+async def _main():
+    async with tractor.open_nursery() as n:
+        for i in range(2):
+            await n.run_in_actor(
+                spawn_and_error,
+                name=f'top_{i}',
+                breadth=2,
+                depth=1,
+            )
+
+if __name__ == '__main__':
+    from tractor.spawn._spawn import try_set_start_method
+    try_set_start_method('subint_forkserver')
+    with trio.fail_after(20):
+        trio.run(_main)
+```
+
+Expected (current): hangs on `trio.fail_after(20)`
+— children never ack the error-propagation cancel
+cascade. Pattern: top 2 direct children, 4
+grandchildren, 1 errorer deadlocks while trying to
+unwind through its parent chain.
+
+After fix: `trio.TooSlowError`-free completion; the
+root's `open_nursery` receives the
+`BaseExceptionGroup` containing the `AssertionError`
+from the errorer and unwinds cleanly.
+
+## Update — 2026-04-23: partial fix landed, deeper layer surfaced
+
+Three improvements landed as separate commits in the
+`subint_forkserver_backend` branch (see `git log`):
+
+1. **`_close_inherited_fds()` in fork-child prelude**
+   (`tractor/spawn/_subint_forkserver.py`). POSIX
+   close-fds-equivalent enumeration via
+   `/proc/self/fd` (or `RLIMIT_NOFILE` fallback), keep
+   only stdio. This is fix-direction (1) from the list
+   above — went with the blunt form rather than the
+   targeted enum-via-`actor.ipc_server` form, turns
+   out the aggressive close is safe because every
+   inheritable resource the fresh child needs
+   (IPC-channel socket, etc.) is opened AFTER the
+   fork anyway.
+2. **`_ForkedProc.wait()` via `os.pidfd_open()` +
+   `trio.lowlevel.wait_readable()`** — matches the
+   `trio.Process.wait` / `mp.Process.sentinel` pattern
+   used by `trio_proc` and `proc_waiter`. Gives us
+   fully trio-cancellable child-wait (prior impl
+   blocked a cache thread on a sync `os.waitpid` that
+   was NOT trio-cancellable due to
+   `abandon_on_cancel=False`).
+3. **`_parent_chan_cs` wiring** in
+   `tractor/runtime/_runtime.py`: capture the shielded
+   `loop_cs` for the parent-channel `process_messages`
+   task in `async_main`; explicitly cancel it in
+   `Actor.cancel()` teardown. This breaks the shield
+   during teardown so the parent-chan loop exits when
+   cancel is issued, instead of parking on a parent-
+   socket EOF that might never arrive under fork
+   semantics.
+
+**Concrete wins from (1):** the sibling
+`subint_forkserver_orphan_sigint_hang_issue.md` class
+is **now fixed** — `test_orphaned_subactor_sigint_cleanup_DRAFT`
+went from strict-xfail to pass. The xfail mark was
+removed; the test remains as a regression guard.
+
+**test_nested_multierrors STILL hangs** though.
+
+### Updated diagnosis (narrowed)
+
+DIAGDEBUG instrumentation of `process_messages` ENTER/
+EXIT pairs + `_parent_chan_cs.cancel()` call sites
+showed (captured during a 20s-timeout repro):
+
+- 80 `process_messages` ENTERs, 75 EXITs → 5 stuck.
+- **All 40 `shield=True` ENTERs matched EXIT** — every
+  shielded parent-chan loop exits cleanly. The
+  `_parent_chan_cs` wiring works as intended.
+- **The 5 stuck loops are all `shield=False`** — peer-
+  channel handlers (inbound connections handled by
+  `handle_stream_from_peer` in stream_handler_tn).
+- After our `_parent_chan_cs.cancel()` fires, NEW
+  shielded process_messages loops start (on the
+  session reg_addr port — probably discovery-layer
+  reconnection attempts). These don't block teardown
+  (they all exit) but indicate the cancel cascade has
+  more moving parts than expected.
+
+### Remaining unknown
+
+Why don't the 5 peer-channel loops exit when
+`service_tn.cancel_scope.cancel()` fires? They're in
+`stream_handler_tn` which IS `service_tn` in the
+current configuration (`open_ipc_server(parent_tn=
+service_tn, stream_handler_tn=service_tn)`). A
+standard nursery-scope-cancel should propagate through
+them — no shield, no special handler. Something
+specific to the fork-spawned configuration keeps them
+alive.
+
+Candidate follow-up experiments:
+
+- Dump the trio task tree at the hang point (via
+  `stackscope` or direct trio introspection) to see
+  what each stuck loop is awaiting. `chan.__anext__`
+  on a socket recv? An inner lock? A shielded sub-task?
+- Compare peer-channel handler lifecycle under
+  `trio_proc` vs `subint_forkserver` with equivalent
+  logging to spot the divergence.
+- Investigate whether the peer handler is caught in
+  the `except trio.Cancelled:` path at
+  `tractor/ipc/_server.py:448` that re-raises — but
+  re-raise means it should still exit. Unless
+  something higher up swallows it.
+
+### Attempted fix (DID NOT work) — hypothesis (3)
+
+Tried: in `_serve_ipc_eps` finally, after closing
+listeners, also iterate `server._peers` and
+sync-close each peer channel's underlying stream
+socket fd:
+
+```python
+for _uid, _chans in list(server._peers.items()):
+    for _chan in _chans:
+        try:
+            _stream = _chan._transport.stream if _chan._transport else None
+            if _stream is not None:
+                _stream.socket.close()  # sync fd close
+        except (AttributeError, OSError):
+            pass
+```
+
+Theory: closing the socket fd from outside the stuck
+recv task would make the recv see EBADF /
+ClosedResourceError and unblock.
+
+Result: `test_nested_multierrors[subint_forkserver]`
+still hangs identically. Either:
+- The sync `socket.close()` doesn't propagate into
+  trio's in-flight `recv_some()` the way I expected
+  (trio may hold an internal reference that keeps the
+  fd open even after an external close), or
+- The stuck recv isn't even the root blocker and the
+  peer handlers never reach the finally for some
+  reason I haven't understood yet.
+
+Either way, the sync-close hypothesis is **ruled
+out**. Reverted the experiment, restored the skip-
+mark on the test.
+
+### Aside: `-s` flag does NOT change `test_nested_multierrors` behavior
+
+Tested explicitly: both with and without `-s`, the
+test hangs identically. So the capture-pipe-fill
+hypothesis is **ruled out** for this test.
+
+The earlier `test_context_stream_semantics.py` `-s`
+observation was most likely caused by a competing
+pytest run in my session (confirmed via process list
+— my leftover pytest was alive at that time and
+could have been holding state on the default
+registry port).
+
+## Update — 2026-04-23 (late): cancel delivery ruled in, nursery-wait ruled BLOCKER
+
+**New diagnostic run** instrumented
+`handle_stream_from_peer` at ENTER / `except
+trio.Cancelled:` / finally, plus `Actor.cancel()`
+just before `self._parent_chan_cs.cancel()`. Result:
+
+- **40 `handle_stream_from_peer` ENTERs**.
+- **0 `except trio.Cancelled:` hits** — cancel
+  never fires on any peer-handler.
+- **35 finally hits** — those handlers exit via
+  peer-initiated EOF (normal return), NOT cancel.
+- **5 handlers never reach finally** — stuck forever.
+- **`Actor.cancel()` fired in 12 PIDs** — but the
+  PIDs with peer handlers that DIDN'T fire
+  Actor.cancel are exactly **root + 2 direct
+  spawners**. These 3 actors have peer handlers
+  (for their own subactors) that stay stuck because
+  **`Actor.cancel()` at these levels never runs**.
+
+### The actual deadlock shape
+
+`Actor.cancel()` lives in
+`open_root_actor.__aexit__` / `async_main` teardown.
+That only runs when the enclosing `async with
+tractor.open_nursery()` exits. The nursery's
+`__aexit__` calls the backend `*_proc` spawn target's
+teardown, which does `soft_kill() →
+_ForkedProc.wait()` on its child PID. That wait is
+trio-cancellable via pidfd now (good) — but nothing
+CANCELS it because the outer scope only cancels when
+`Actor.cancel()` runs, which only runs when the
+nursery completes, which waits on the child.
+
+It's a **multi-level mutual wait**:
+
+```
+root              blocks on spawner.wait()
+  spawner         blocks on grandchild.wait()
+    grandchild    blocks on errorer.wait()
+      errorer     Actor.cancel() ran, but process
+                  may not have fully exited yet
+                  (something in root_tn holding on?)
+```
+
+Each level waits for the level below. The bottom
+level (errorer) reaches Actor.cancel(), but its
+process may not fully exit — meaning its pidfd
+doesn't go readable, meaning the grandchild's
+waitpid doesn't return, meaning the grandchild's
+nursery doesn't unwind, etc. all the way up.
+
+### Refined question
+
+**Why does an errorer process not exit after its
+`Actor.cancel()` completes?**
+
+Possibilities:
+1. `_parent_chan_cs.cancel()` fires (shielded
+   parent-chan loop unshielded), but the task is
+   stuck INSIDE the shielded loop's recv in a way
+   that cancel still can't break.
+2. After `Actor.cancel()` returns, `async_main`
+   still has other tasks in `root_tn` waiting for
+   something that never arrives (e.g. outbound
+   IPC reply delivery).
+3. The `os._exit(rc)` in `_worker` (at
+   `_subint_forkserver.py`) doesn't run because
+   `_child_target` never returns.
+
+Next-session candidate probes (in priority order):
+
+1. **Instrument `_worker`'s fork-child branch** to
+   confirm whether `child_target()` returns (and
+   thus `os._exit(rc)` is reached) for errorer
+   PIDs. If yes → process should die; if no →
+   trace back into `_actor_child_main` /
+   `_trio_main` / `async_main` to find the stuck
+   spot.
+2. **Instrument `async_main`'s final unwind** to
+   see which await in the teardown doesn't
+   complete.
+3. **Compare under `trio_proc` backend** at the
+   same `_worker`-equivalent level to see where
+   the flows diverge.
+
+### Rule-out: NOT a stuck peer-chan recv
+
+Earlier hypothesis was that the 5 stuck peer-chan
+loops were blocked on a socket recv that cancel
+couldn't interrupt. This pass revealed the real
+cause: cancel **never reaches those tasks** because
+their owning actor's `Actor.cancel()` never runs.
+The recvs are fine — they're just parked because
+nothing is telling them to stop.
+
+## Update — 2026-04-23 (very late): leaves exit, middle actors stuck in `trio.run`
+
+Yet another instrumentation pass — this time
+printing at:
+
+- `_worker` child branch: `pre child_target()` /
+  `child_target RETURNED rc=N` / `about to
+  os._exit(rc)` 
+- `_trio_main`: `about to trio.run` /
+  `trio.run RETURNED NORMALLY` / `FINALLY`
+
+**Fresh-run results** (`test_nested_multierrors[
+subint_forkserver]`, depth=1/breadth=2, 1 root + 14
+forked = 15 actors total):
+
+- **9 processes completed the full flow** —
+  `trio.run RETURNED NORMALLY` → `child_target
+  RETURNED rc=0` → `about to os._exit(0)`. These
+  are the LEAVES of the tree (errorer actors) plus
+  their direct parents (depth-0 spawners). They
+  actually exit their processes.
+- **5 processes are stuck INSIDE `trio.run(trio_main)`**
+  — they hit "about to trio.run" but NEVER see
+  "trio.run RETURNED NORMALLY". These are root +
+  top-level spawners + one intermediate.
+
+**What this means:** `async_main` itself is the
+deadlock holder, not the peer-channel loops.
+Specifically, the outer `async with root_tn:` in
+`async_main` never exits for the 5 stuck actors.
+Their `trio.run` never returns → `_trio_main`
+catch/finally never runs → `_worker` never reaches
+`os._exit(rc)` → the PROCESS never dies → its
+parent's `_ForkedProc.wait()` blocks → parent's
+nursery hangs → parent's `async_main` hangs → ...
+
+### The new precise question
+
+**What task in the 5 stuck actors' `async_main`
+never completes?** Candidates:
+
+1. The shielded parent-chan `process_messages`
+   task in `root_tn` — but we explicitly cancel it
+   via `_parent_chan_cs.cancel()` in `Actor.cancel()`.
+   However, `Actor.cancel()` only runs during
+   `open_root_actor.__aexit__`, which itself runs
+   only after `async_main`'s outer unwind — which
+   doesn't happen. So the shield isn't broken.
+
+2. `await actor_nursery._join_procs.wait()` or
+   similar in the inline backend `*_proc` flow.
+
+3. `_ForkedProc.wait()` on a grandchild that
+   actually DID exit — but the pidfd_open watch
+   didn't fire for some reason (race between
+   pidfd_open and the child exiting?).
+
+The most specific next probe: **add DIAG around
+`_ForkedProc.wait()` enter/exit** to see whether
+the pidfd-based wait returns for every grandchild
+exit. If a stuck parent's `_ForkedProc.wait()`
+NEVER returns despite its child exiting, the
+pidfd mechanism has a race bug under nested
+forkserver.
+
+Alternative probe: instrument `async_main`'s outer
+nursery exits to find which nursery's `__aexit__`
+is stuck, drilling down from `trio.run` to the
+specific `async with` that never completes.
+
+### Cascade summary (updated tree view)
+
+```
+ROOT (pytest)                       STUCK in trio.run
+├── top_0 (spawner, d=1)            STUCK in trio.run
+│   ├── spawner_0_d1_0 (d=0)        exited (os._exit 0)
+│   │   ├── errorer_0_0             exited (os._exit 0)
+│   │   └── errorer_0_1             exited (os._exit 0)
+│   └── spawner_0_d1_1 (d=0)        exited (os._exit 0)
+│       ├── errorer_0_2             exited (os._exit 0)
+│       └── errorer_0_3             exited (os._exit 0)
+└── top_1 (spawner, d=1)            STUCK in trio.run
+    ├── spawner_1_d1_0 (d=0)        STUCK in trio.run (sibling race?)
+    │   ├── errorer_1_0             exited
+    │   └── errorer_1_1             exited
+    └── spawner_1_d1_1 (d=0)        STUCK in trio.run
+        ├── errorer_1_2             exited
+        └── errorer_1_3             exited
+```
+
+Grandchildren (d=0 spawners) exit OR stick —
+asymmetric. Not purely depth-determined. Some race
+condition in nursery teardown when multiple
+siblings error simultaneously.
+
+## Update — 2026-04-23 (late, probe iteration 3): hang pinpointed to `wait_for_no_more_peers()`
+
+Further DIAGDEBUG at every milestone in `async_main`
+(runtime UP / EXITED service_tn / EXITED root_tn /
+FINALLY ENTER / RETURNING) plus `_ForkedProc.wait`
+ENTER/RETURNED per-pidfd. Result:
+
+**Every stuck actor reaches `async_main: FINALLY
+ENTER` but NOT `async_main: RETURNING`.**
+
+That isolates the hang to a specific await in
+`async_main`'s finally block at
+`tractor/runtime/_runtime.py:1837+`. The suspect:
+
+```python
+# Ensure all peers (actors connected to us as clients) are finished
+if ipc_server := actor.ipc_server and ipc_server.has_peers(check_chans=True):
+    ...
+    await ipc_server.wait_for_no_more_peers()  # ← UNBOUNDED, blocks forever
+```
+
+`_no_more_peers` is an `Event` set only when
+`server._peers` empties (see
+`ipc/_server.py:526-530`). If ANY peer-handler is
+stuck (the 5 unclosed loops from the earlier pass),
+it keeps its channel in `server._peers`, so the
+event never fires, so the wait hangs.
+
+### Applied fix (partial, landed as defensive-in-depth)
+
+`tractor/runtime/_runtime.py:1981` —
+`wait_for_no_more_peers()` call now wrapped in
+`trio.move_on_after(3.0)` + a warning log when the
+timeout fires. Commented with the full rationale.
+
+**Verified:** with this fix, ALL 15 actors reach
+`async_main: RETURNING` cleanly (up from 10/15
+reaching end before).
+
+**Unfortunately:** the test still hangs past 45s
+total — meaning there's YET ANOTHER unbounded wait
+downstream of `async_main`. The bounded
+`wait_for_no_more_peers` unblocks one level, but
+the cascade has another level above it.
+
+### Candidates for the remaining hang
+
+1. `open_root_actor`'s own finally / post-
+   `async_main` flow in `_root.py` — specifically
+   `await actor.cancel(None)` which has its own
+   internal waits.
+2. The `trio.run()` itself doesn't return even
+   after the root task completes because trio's
+   nursery still has background tasks running.
+3. Maybe `_serve_ipc_eps`'s finally has an await
+   that blocks when peers aren't clearing.
+
+### Current stance
+
+- Defensive `wait_for_no_more_peers` bound landed
+  (good hygiene regardless). Revealing a real
+  deadlock-avoidance gap in tractor's cleanup.
+- Test still hangs → skip-mark restored on
+  `test_nested_multierrors[subint_forkserver]`.
+- The full chain of unbounded waits needs another
+  session of drilling, probably at
+  `open_root_actor` / `actor.cancel` level.
+
+### Summary of this investigation's wins
+
+1. **FD hygiene fix** (`_close_inherited_fds`) —
+   correct, closed orphan-SIGINT sibling issue.
+2. **pidfd-based `_ForkedProc.wait`** — cancellable,
+   matches trio_proc pattern.
+3. **`_parent_chan_cs` wiring** —
+   `Actor.cancel()` now breaks the shielded parent-
+   chan `process_messages` loop.
+4. **`wait_for_no_more_peers` bounded** —
+   prevents the actor-level finally hang.
+5. **Ruled-out hypotheses:** tree-kill missing
+   (wrong), stuck socket recv (wrong).
+6. **Pinpointed remaining unknown:** at least one
+   more unbounded wait in the teardown cascade
+   above `async_main`. Concrete candidates
+   enumerated above.
+
+## Update — 2026-04-23 (VERY late): pytest capture pipe IS the final gate
+
+After landing fixes 1-4 and instrumenting every
+layer down to `tractor_test`'s `trio.run(_main)`:
+
+**Empirical result: with `pytest -s` the test PASSES
+in 6.20s.** Without `-s` (default `--capture=fd`) it
+hangs forever.
+
+DIAG timeline for the root pytest PID (with `-s`
+implied from later verification):
+
+```
+tractor_test: about to trio.run(_main)
+open_root_actor: async_main task started, yielding to test body
+_main: about to await wrapped test fn
+_main: wrapped RETURNED cleanly        ← test body completed!
+open_root_actor: about to actor.cancel(None)
+Actor.cancel ENTER req_chan=False
+Actor.cancel RETURN
+open_root_actor: actor.cancel RETURNED
+open_root_actor: outer FINALLY
+open_root_actor: finally END (returning from ctxmgr)
+tractor_test: trio.run FINALLY (returned or raised)  ← trio.run fully returned!
+```
+
+`trio.run()` fully returns. The test body itself
+completes successfully (pytest.raises absorbed the
+expected `BaseExceptionGroup`). What blocks is
+**pytest's own stdout/stderr capture** — under
+`--capture=fd` default, pytest replaces the parent
+process's fd 1,2 with pipe write-ends it's reading
+from. Fork children inherit those pipe fds
+(because `_close_inherited_fds` correctly preserves
+stdio). High-volume subactor error-log tracebacks
+(7+ actors each logging multiple
+`RemoteActorError`/`ExceptionGroup` tracebacks on
+the error-propagation cascade) fill the 64KB Linux
+pipe buffer. Subactor writes block. Subactor can't
+progress. Process doesn't exit. Parent's
+`_ForkedProc.wait` (now pidfd-based and
+cancellable, but nothing's cancelling here since
+the test body already completed) keeps the pipe
+reader alive... but pytest isn't draining its end
+fast enough because test-teardown/fixture-cleanup
+is in progress.
+
+**Actually** the exact mechanism is slightly
+different: pytest's capture fixture MIGHT be
+actively reading, but faster-than-writer subactors
+overflow its internal buffer. Or pytest might be
+blocked itself on the finalization step.
+
+Either way, `-s` conclusively fixes it.
+
+### Why I ruled this out earlier (and shouldn't have)
+
+Earlier in this investigation I tested
+`test_nested_multierrors` with/without `-s` and
+both hung. That's because AT THAT TIME, fixes 1-4
+weren't all in place yet. The test was hanging at
+multiple deeper levels long before reaching the
+"generate lots of error-log output" phase. Once
+the cascade actually tore down cleanly, enough
+output was produced to hit the capture-pipe limit.
+
+**Classic order-of-operations mistake in
+debugging:** ruling something out too early based
+on a test that was actually failing for a
+different reason.
+
+### Fix direction (next session)
+
+Redirect subactor stdout/stderr to `/dev/null` (or
+a session-scoped log file) in the fork-child
+prelude, right after `_close_inherited_fds()`. This
+severs the inherited pytest-capture pipes and lets
+subactor output flow elsewhere. Under normal
+production use (non-pytest), stdout/stderr would
+be the TTY — we'd want to keep that. So the
+redirect should be conditional or opt-in via the
+`child_sigint`/proc_kwargs flag family.
+
+Alternative: document as a gotcha and recommend
+`pytest -s` for any tests using the
+`subint_forkserver` backend with multi-level actor
+trees. Simpler, user-visible, no code change.
+
+### Current state
+
+- Skip-mark on `test_nested_multierrors[subint_forkserver]`
+  restored with reason pointing here.
+- Test confirmed passing with `-s` after all 4
+  cascade fixes applied.
+- The 4 cascade fixes are NOT wasted — they're
+  correct hardening regardless of the capture-pipe
+  issue, AND without them we'd never reach the
+  "actually produces enough output to fill the
+  pipe" state.
+
+## Stopgap (landed)
+
+`test_nested_multierrors` skip-marked under
+`subint_forkserver` via
+`@pytest.mark.skipon_spawn_backend('subint_forkserver',
+reason='...')`, cross-referenced to this doc. Mark
+should be dropped once the peer-channel-loop exit
+issue is fixed.
+
+## References
+
+- `tractor/spawn/_subint_forkserver.py::fork_from_worker_thread`
+  — the primitive whose post-fork FD hygiene is
+  probably the culprit.
+- `tractor/spawn/_subint_forkserver.py::subint_forkserver_proc`
+  — the backend function that orchestrates the
+  graceful cancel path hitting this bug.
+- `tractor/spawn/_subint_forkserver.py::_ForkedProc`
+  — the `trio.Process`-compatible shim; NOT the
+  failing component (confirmed via thread-dump).
+- `tests/test_cancellation.py::test_nested_multierrors`
+  — the test that surfaced the hang.
+- `ai/conc-anal/subint_forkserver_orphan_sigint_hang_issue.md`
+  — sibling hang class; probably same underlying
+  fork-FD-inheritance root cause.
+- tractor issue #379 — subint backend tracking.

ai/conc-anal/subint_forkserver_thread_constraints_on_pep684_issue.md

@@ -0,0 +1,186 @@
+# Revisit `subint_forkserver` thread-cache constraints once msgspec PEP 684 support lands
+
+> **Tracked at:** [#450](https://github.com/goodboy/tractor/issues/450)
+
+Follow-up tracker for cleanup work gated on the msgspec
+PEP 684 adoption upstream ([jcrist/msgspec#563](https://github.com/jcrist/msgspec/issues/563)).
+
+Context — why this exists
+-------------------------
+
+The `tractor.spawn._subint_forkserver` submodule currently
+carries two "non-trio" thread-hygiene constraints whose
+necessity is tangled with issues that *should* dissolve
+under PEP 684 isolated-mode subinterpreters:
+
+1. `fork_from_worker_thread()` / `run_subint_in_worker_thread()`
+   internally allocate a **dedicated `threading.Thread`**
+   rather than using `trio.to_thread.run_sync()`.
+2. The test helper is named
+   `run_fork_in_non_trio_thread()` — the
+   `non_trio` qualifier is load-bearing today.
+
+This doc catalogs *why* those constraints exist, which of
+them isolated-mode would fix, and what the
+audit-and-cleanup path looks like once msgspec #563 is
+resolved.
+
+The three reasons the constraints exist
+---------------------------------------
+
+### 1. GIL-starvation class → fixed by PEP 684 isolated mode
+
+The class-A hang documented in
+`subint_sigint_starvation_issue.md` is entirely about
+legacy-config subints **sharing the main GIL**. Once
+msgspec #563 lands and tractor flips
+`tractor.spawn._subint` to
+`concurrent.interpreters.create()` (isolated config), each
+subint gets its own GIL. Abandoned subint threads can't
+contend for main's GIL → can't starve the main trio loop
+→ signal-wakeup-pipe drains normally → no SIGINT-drop.
+
+This class of hazard **dissolves entirely**. The
+non-trio-thread requirement for *this reason* disappears.
+
+### 2. Destroy race / tstate-recycling → orthogonal; unclear
+
+The `subint_proc` dedicated-thread fix (commit `26fb8206`)
+addressed a different issue: `_interpreters.destroy(interp_id)`
+was blocking on a trio-cache worker that had run an
+earlier `interp.exec()` for that subint. Working
+hypothesis at the time was "the cached thread retains the
+subint's tstate".
+
+But tstate-handling is **not specific to GIL mode** —
+`_PyXI_Enter` / `_PyXI_Exit` (the C-level machinery both
+configs use to enter/leave a subint from a thread) should
+restore the caller's tstate regardless of GIL config. So
+isolated mode **doesn't obviously fix this**. It might be:
+
+- A py3.13 bug fixed in later versions — we saw the race
+  first on 3.13 and never re-tested on 3.14 after moving
+  to dedicated threads.
+- A genuine CPython quirk around cached threads that
+  exec'd into a subint, persisting across GIL modes.
+- Something else we misdiagnosed — the empirical fix
+  (dedicated thread) worked but the analysis may have
+  been incomplete.
+
+Only way to know: once we're on isolated mode, empirically
+retry `trio.to_thread.run_sync(interp.exec, ...)` and see
+if `destroy()` still blocks. If it does, keep the
+dedicated thread; if not, one constraint relaxed.
+
+### 3. Fork-from-main-interp-tstate (the constraint in this module's helper names)
+
+The fork-from-main-interp-tstate invariant — CPython's
+`PyOS_AfterFork_Child` →
+`_PyInterpreterState_DeleteExceptMain` gate documented in
+`subint_fork_blocked_by_cpython_post_fork_issue.md` — is
+about the calling thread's **current** tstate at the
+moment `os.fork()` runs. If trio's cache threads never
+enter subints at all, their tstate is plain main-interp,
+and fork from them would be fine.
+
+The reason the smoke test +
+`run_fork_in_non_trio_thread` test helper
+currently use a dedicated `threading.Thread` is narrow:
+**we don't want to risk a trio cache thread that has
+previously been used as a subint driver being the one that
+picks up the fork job**. If cached tstate doesn't get
+cleared (back to reason #2), the fork's child-side
+post-init would see the wrong interp and abort.
+
+In an isolated-mode world where msgspec works:
+
+- `subint_proc` would use the public
+  `concurrent.interpreters.create()` + `Interpreter.exec()`
+  / `Interpreter.close()` — which *should* handle tstate
+  cleanly (they're the "blessed" API).
+- If so, trio's cache threads are safe to fork from
+  regardless of whether they've previously driven subints.
+- → the `non_trio` qualifier in
+  `run_fork_in_non_trio_thread` becomes
+  *overcautious* rather than load-bearing, and the
+  dedicated-thread primitives in `_subint_forkserver.py`
+  can likely be replaced with straight
+  `trio.to_thread.run_sync()` wrappers.
+
+TL;DR
+-----
+
+| constraint | fixed by isolated mode? |
+|---|---|
+| GIL-starvation (class A) | **yes** |
+| destroy race on cached worker | unclear — empirical test on py3.14 + isolated API required |
+| fork-from-main-tstate requirement on worker | **probably yes, conditional on the destroy-race question above** |
+
+If #2 also resolves on py3.14+ with isolated mode,
+tractor could drop the `non_trio` qualifier from the fork
+helper's name and just use `trio.to_thread.run_sync(...)`
+for everything. But **we shouldn't do that preemptively**
+— the current cautious design is cheap (one dedicated
+thread per fork / per subint-exec) and correct.
+
+Audit plan when msgspec #563 lands
+----------------------------------
+
+Assuming msgspec grows `Py_mod_multiple_interpreters`
+support:
+
+1. **Flip `tractor.spawn._subint` to isolated mode.** Drop
+   the `_interpreters.create('legacy')` call in favor of
+   the public API (`concurrent.interpreters.create()` +
+   `Interpreter.exec()` / `Interpreter.close()`). Run the
+   three `ai/conc-anal/subint_*_issue.md` reproducers —
+   class-A (`test_stale_entry_is_deleted` etc.) should
+   pass without the `skipon_spawn_backend('subint')` marks
+   (revisit the marker inventory).
+
+2. **Empirical destroy-race retest.** In `subint_proc`,
+   swap the dedicated `threading.Thread` back to
+   `trio.to_thread.run_sync(Interpreter.exec, ...,
+   abandon_on_cancel=False)` and run the full subint test
+   suite. If `Interpreter.close()` (or the backing
+   destroy) blocks the same way as the legacy version
+   did, revert and keep the dedicated thread.
+
+3. **If #2 clean**, audit `_subint_forkserver.py`:
+   - Rename `run_fork_in_non_trio_thread` → drop the
+     `_non_trio_` qualifier (e.g. `run_fork_in_thread`) or
+     inline the two-line `trio.to_thread.run_sync` call at
+     the call sites and drop the helper entirely.
+   - Consider whether `fork_from_worker_thread` +
+     `run_subint_in_worker_thread` still warrant being
+     separate module-level primitives or whether they
+     collapse into a compound
+     `trio.to_thread.run_sync`-driven pattern inside the
+     (future) `subint_forkserver_proc` backend.
+
+4. **Doc fallout.** `subint_sigint_starvation_issue.md`
+   and `subint_cancel_delivery_hang_issue.md` both cite
+   the legacy-GIL-sharing architecture as the root cause.
+   Close them with commit-refs to the isolated-mode
+   migration. This doc itself should get a closing
+   post-mortem section noting which of #1/#2/#3 actually
+   resolved vs persisted.
+
+References
+----------
+
+- `tractor.spawn._subint_forkserver` — the in-tree module
+  whose constraints this doc catalogs.
+- `ai/conc-anal/subint_sigint_starvation_issue.md` — the
+  GIL-starvation class.
+- `ai/conc-anal/subint_cancel_delivery_hang_issue.md` —
+  sibling Ctrl-C-able hang class.
+- `ai/conc-anal/subint_fork_blocked_by_cpython_post_fork_issue.md`
+  — why fork-from-subint is blocked (this drives the
+  forkserver-via-non-subint-thread workaround).
+- `ai/conc-anal/subint_fork_from_main_thread_smoketest.py`
+  — empirical validation for the workaround.
+- [PEP 684 — per-interpreter GIL](https://peps.python.org/pep-0684/)
+- [PEP 734 — `concurrent.interpreters` public API](https://peps.python.org/pep-0734/)
+- [jcrist/msgspec#563 — PEP 684 support tracker](https://github.com/jcrist/msgspec/issues/563)
+- tractor issue #379 — subint backend tracking.

ai/conc-anal/subint_sigint_starvation_issue.md

@@ -0,0 +1,350 @@
+# `subint` backend: abandoned-subint thread can wedge main trio event loop (Ctrl-C unresponsive)
+
+Follow-up to the Phase B subint spawn-backend PR (see
+`tractor.spawn._subint`, issue #379). The hard-kill escape
+hatch we landed (`_HARD_KILL_TIMEOUT`, bounded shields,
+`daemon=True` driver-thread abandonment) handles *most*
+stuck-subint scenarios cleanly, but there's one class of
+hang that can't be fully escaped from within tractor: a
+still-running abandoned sub-interpreter can starve the
+**parent's** trio event loop to the point where **SIGINT is
+effectively dropped by the kernel ↔ Python boundary** —
+making the pytest process un-Ctrl-C-able.
+
+## Symptom
+
+Running `test_stale_entry_is_deleted[subint]` under
+`--spawn-backend=subint`:
+
+1. Test spawns a subactor (`transport_fails_actor`) which
+   kills its own IPC server and then
+   `trio.sleep_forever()`.
+2. Parent tries `Portal.cancel_actor()` → channel
+   disconnected → fast return.
+3. Nursery teardown triggers our `subint_proc` cancel path.
+   Portal-cancel fails (dead channel),
+   `_HARD_KILL_TIMEOUT` fires, driver thread is abandoned
+   (`daemon=True`), `_interpreters.destroy(interp_id)`
+   raises `InterpreterError` (because the subint is still
+   running).
+4. Test appears to hang indefinitely at the *outer*
+   `async with tractor.open_nursery() as an:` exit.
+5. `Ctrl-C` at the terminal does nothing. The pytest
+   process is un-interruptable.
+
+## Evidence
+
+### `strace` on the hung pytest process
+
+```
+--- SIGINT {si_signo=SIGINT, si_code=SI_KERNEL} ---
+write(37, "\2", 1) = -1 EAGAIN (Resource temporarily unavailable)
+rt_sigreturn({mask=[WINCH]}) = 140585542325792
+```
+
+Translated:
+
+- Kernel delivers `SIGINT` to pytest.
+- CPython's C-level signal handler fires and tries to
+  write the signal number byte (`0x02` = SIGINT) to fd 37
+  — the **Python signal-wakeup fd** (set via
+  `signal.set_wakeup_fd()`, which trio uses to wake its
+  event loop on signals).
+- Write returns `EAGAIN` — **the pipe is full**. Nothing
+  is draining it.
+- `rt_sigreturn` with the signal masked off — signal is
+  "handled" from the kernel's perspective but the actual
+  Python-level handler (and therefore trio's
+  `KeyboardInterrupt` delivery) never runs.
+
+### Stack dump (via `tractor.devx.dump_on_hang`)
+
+At 20s into the hang, only the **main thread** is visible:
+
+```
+Thread 0x...7fdca0191780 [python] (most recent call first):
+  File ".../trio/_core/_io_epoll.py", line 245 in get_events
+  File ".../trio/_core/_run.py", line 2415 in run
+  File ".../tests/discovery/test_registrar.py", line 575 in test_stale_entry_is_deleted
+  ...
+```
+
+No driver thread shows up. The abandoned-legacy-subint
+thread still exists from the OS's POV (it's still running
+inside `_interpreters.exec()` driving the subint's
+`trio.run()` on `trio.sleep_forever()`) but the **main
+interp's faulthandler can't see threads currently executing
+inside a sub-interpreter's tstate**. Concretely: the thread
+is alive, holding state we can't introspect from here.
+
+## Root cause analysis
+
+The most consistent explanation for both observations:
+
+1. **Legacy-config subinterpreters share the main GIL.**
+   PEP 734's public `concurrent.interpreters.create()`
+   defaults to `'isolated'` (per-interp GIL), but tractor
+   uses `_interpreters.create('legacy')` as a workaround
+   for C extensions that don't yet support PEP 684
+   (notably `msgspec`, see
+   [jcrist/msgspec#563](https://github.com/jcrist/msgspec/issues/563)).
+   Legacy-mode subints share process-global state
+   including the GIL.
+
+2. **Our abandoned subint thread never exits.** After our
+   hard-kill timeout, `driver_thread.join()` is abandoned
+   via `abandon_on_cancel=True` and the thread is
+   `daemon=True` so proc-exit won't block on it — but the
+   thread *itself* is still alive inside
+   `_interpreters.exec()`, driving a `trio.run()` that
+   will never return (the subint actor is in
+   `trio.sleep_forever()`).
+
+3. **`_interpreters.destroy()` cannot force-stop a running
+   subint.** It raises `InterpreterError` on any
+   still-running subinterpreter; there is no public
+   CPython API to force-destroy one.
+
+4. **Shared-GIL + non-terminating subint thread → main
+   trio loop starvation.** Under enough load (the subint's
+   trio event loop iterating in the background, IPC-layer
+   tasks still in the subint, etc.) the main trio event
+   loop can fail to iterate frequently enough to drain its
+   wakeup pipe. Once that pipe fills, `SIGINT` writes from
+   the C signal handler return `EAGAIN` and signals are
+   silently dropped — exactly what `strace` shows.
+
+The shielded
+`await actor_nursery._join_procs.wait()` at the top of
+`subint_proc` (inherited unchanged from the `trio_proc`
+pattern) is structurally involved too: if main trio *does*
+get a schedule slice, it'd find the `subint_proc` task
+parked on `_join_procs` under shield — which traps whatever
+`Cancelled` arrives. But that's a second-order effect; the
+signal-pipe-full condition is the primary "Ctrl-C doesn't
+work" cause.
+
+## Why we can't fix this from inside tractor
+
+- **No force-destroy API.** CPython provides neither a
+  `_interpreters.force_destroy()` nor a thread-
+  cancellation primitive (`pthread_cancel` is actively
+  discouraged and unavailable on Windows). A subint stuck
+  in pure-Python loops (or worse, C code that doesn't poll
+  for signals) is structurally unreachable from outside.
+- **Shared GIL is the root scheduling issue.** As long as
+  we're forced into legacy-mode subints for `msgspec`
+  compatibility, the abandoned-thread scenario is
+  fundamentally a process-global GIL-starvation window.
+- **`signal.set_wakeup_fd()` is process-global.** Even if
+  we wanted to put our own drainer on the wakeup pipe,
+  only one party owns it at a time.
+
+## Current workaround
+
+- **Fixture-side SIGINT loop on the `daemon` subproc** (in
+  this test's `daemon: subprocess.Popen` fixture in
+  `tests/conftest.py`). The daemon dying closes its end of
+  the registry IPC, which unblocks a pending recv in main
+  trio's IPC-server task, which lets the event loop
+  iterate, which drains the wakeup pipe, which finally
+  delivers the test-harness SIGINT.
+- **Module-level skip on py3.13**
+  (`pytest.importorskip('concurrent.interpreters')`) — the
+  private `_interpreters` C module exists on 3.13 but the
+  multi-trio-task interaction hangs silently there
+  independently of this issue.
+
+## Path forward
+
+1. **Primary**: upstream `msgspec` PEP 684 adoption
+   ([jcrist/msgspec#563](https://github.com/jcrist/msgspec/issues/563)).
+   Unlocks `concurrent.interpreters.create()` isolated
+   mode → per-interp GIL → abandoned subint threads no
+   longer starve the parent's main trio loop. At that
+   point we can flip `_subint.py` back to the public API
+   (`create()` / `Interpreter.exec()` / `Interpreter.close()`)
+   and drop the private `_interpreters` path.
+
+2. **Secondary**: watch CPython for a public
+   force-destroy primitive. If something like
+   `Interpreter.close(force=True)` lands, we can use it as
+   a hard-kill final stage and actually tear down
+   abandoned subints.
+
+3. **Harness-level**: document the fixture-side SIGINT
+   loop pattern as the "known workaround" for subint-
+   backend tests that can leave background state holding
+   the main event loop hostage.
+
+## References
+
+- PEP 734 (`concurrent.interpreters`):
+  <https://peps.python.org/pep-0734/>
+- PEP 684 (per-interpreter GIL):
+  <https://peps.python.org/pep-0684/>
+- `msgspec` PEP 684 tracker:
+  <https://github.com/jcrist/msgspec/issues/563>
+- CPython `_interpretersmodule.c` source:
+  <https://github.com/python/cpython/blob/main/Modules/_interpretersmodule.c>
+- `tractor.spawn._subint` module docstring (in-tree
+  explanation of the legacy-mode choice and its
+  tradeoffs).
+
+## Reproducer
+
+```
+./py314/bin/python -m pytest \
+  tests/discovery/test_registrar.py::test_stale_entry_is_deleted \
+  --spawn-backend=subint \
+  --tb=short --no-header -v
+```
+
+Hangs indefinitely without the fixture-side SIGINT loop;
+with the loop, the test completes (albeit with the
+abandoned-thread warning in logs).
+
+## Additional known-hanging tests (same class)
+
+All three tests below exhibit the same
+signal-wakeup-fd-starvation fingerprint (`write() → EAGAIN`
+on the wakeup pipe after enough SIGINT attempts) and
+share the same structural cause — abandoned legacy-subint
+driver threads contending with the main interpreter for
+the shared GIL until the main trio loop can no longer
+drain its wakeup pipe fast enough to deliver signals.
+
+They're listed separately because each exposes the class
+under a different load pattern worth documenting.
+
+### `tests/discovery/test_registrar.py::test_stale_entry_is_deleted[subint]`
+
+Original exemplar — see the **Symptom** and **Evidence**
+sections above. One abandoned subint
+(`transport_fails_actor`, stuck in `trio.sleep_forever()`
+after self-cancelling its IPC server) is sufficient to
+tip main into starvation once the harness's `daemon`
+fixture subproc keeps its half of the registry IPC alive.
+
+### `tests/test_cancellation.py::test_cancel_while_childs_child_in_sync_sleep[subint-False]`
+
+Cancel a grandchild that's in sync Python sleep from 2
+nurseries up. The test's own docstring declares the
+dependency: "its parent should issue a 'zombie reaper' to
+hard kill it after sufficient timeout" — which for
+`trio`/`mp_*` is an OS-level `SIGKILL` of the grandchild
+subproc. **Under `subint` there's no equivalent** (no
+public CPython API to force-destroy a running
+sub-interpreter), so the grandchild's sync-sleeping
+`trio.run()` persists inside its abandoned driver thread
+indefinitely. The nested actor-tree (parent → child →
+grandchild, all subints) means a single cancel triggers
+multiple concurrent hard-kill abandonments, each leaving
+a live driver thread.
+
+This test often only manifests the starvation under
+**full-suite runs** rather than solo execution —
+earlier-in-session subint tests also leave abandoned
+driver threads behind, and the combined population is
+what actually tips main trio into starvation. Solo runs
+may stay Ctrl-C-able with fewer abandoned threads in the
+mix.
+
+### `tests/test_cancellation.py::test_multierror_fast_nursery[subint-25-0.5]`
+
+Nursery-error-path throughput stress-test parametrized
+for **25 concurrent subactors**. When the multierror
+fires and the nursery cancels, every subactor goes
+through our `subint_proc` teardown. The bounded
+hard-kills run in parallel (all `subint_proc` tasks are
+sibling trio tasks), so the timeout budget is ~3s total
+rather than 3s × 25. After that, **25 abandoned
+`daemon=True` driver threads are simultaneously alive** —
+an extreme pressure multiplier on the same mechanism.
+
+The `strace` fingerprint is striking under this load: six
+or more **successful** `write(16, "\2", 1) = 1` calls
+(main trio getting brief GIL slices, each long enough to
+drain exactly one wakeup-pipe byte) before finally
+saturating with `EAGAIN`:
+
+```
+--- SIGINT {si_signo=SIGINT, si_code=SI_KERNEL} ---
+write(16, "\2", 1)                      = 1
+rt_sigreturn({mask=[WINCH]})            = 140141623162400
+--- SIGINT {si_signo=SIGINT, si_code=SI_KERNEL} ---
+write(16, "\2", 1)                      = 1
+rt_sigreturn({mask=[WINCH]})            = 140141623162400
+--- SIGINT {si_signo=SIGINT, si_code=SI_KERNEL} ---
+write(16, "\2", 1)                      = 1
+rt_sigreturn({mask=[WINCH]})            = 140141623162400
+--- SIGINT {si_signo=SIGINT, si_code=SI_KERNEL} ---
+write(16, "\2", 1)                      = 1
+rt_sigreturn({mask=[WINCH]})            = 140141623162400
+--- SIGINT {si_signo=SIGINT, si_code=SI_KERNEL} ---
+write(16, "\2", 1)                      = 1
+rt_sigreturn({mask=[WINCH]})            = 140141623162400
+--- SIGINT {si_signo=SIGINT, si_code=SI_KERNEL} ---
+write(16, "\2", 1)                      = 1
+rt_sigreturn({mask=[WINCH]})            = 140141623162400
+--- SIGINT {si_signo=SIGINT, si_code=SI_KERNEL} ---
+write(16, "\2", 1)                      = -1 EAGAIN (Resource temporarily unavailable)
+rt_sigreturn({mask=[WINCH]})            = 140141623162400
+```
+
+Those successful writes indicate CPython's
+`sys.getswitchinterval()`-based GIL round-robin *is*
+giving main brief slices — just never long enough to run
+the Python-level signal handler through to the point
+where trio converts the delivered SIGINT into a
+`Cancelled` on the appropriate scope. Once the
+accumulated write rate outpaces main's drain rate, the
+pipe saturates and subsequent signals are silently
+dropped.
+
+The `pstree` below (pid `530060` = hung `pytest`) shows
+the subint-driver thread population at the moment of
+capture. Even with fewer than the full 25 shown (pstree
+truncates thread names to `subint-driver[<interp_id>` —
+interpreters `3` and `4` visible across 16 thread
+entries), the GIL-contender count is more than enough to
+explain the starvation:
+
+```
+>>> pstree -snapt 530060
+systemd,1 --switched-root --system --deserialize=40
+  └─login,1545 --
+      └─bash,1872
+          └─sway,2012
+              └─alacritty,70471 -e xonsh
+                  └─xonsh,70487 .../bin/xonsh
+                      └─uv,70955 run xonsh
+                          └─xonsh,70959 .../py314/bin/xonsh
+                              └─python,530060 .../py314/bin/pytest -v tests/test_cancellation.py --spawn-backend=subint
+                                  ├─{subint-driver[3},531857
+                                  ├─{subint-driver[3},531860
+                                  ├─{subint-driver[3},531862
+                                  ├─{subint-driver[3},531866
+                                  ├─{subint-driver[3},531877
+                                  ├─{subint-driver[3},531882
+                                  ├─{subint-driver[3},531884
+                                  ├─{subint-driver[3},531945
+                                  ├─{subint-driver[3},531950
+                                  ├─{subint-driver[3},531952
+                                  ├─{subint-driver[4},531956
+                                  ├─{subint-driver[4},531959
+                                  ├─{subint-driver[4},531961
+                                  ├─{subint-driver[4},531965
+                                  ├─{subint-driver[4},531968
+                                  └─{subint-driver[4},531979
+```
+
+(`pstree` uses `{...}` to denote threads rather than
+processes — these are all the **driver OS-threads** our
+`subint_proc` creates with name
+`f'subint-driver[{interp_id}]'`. Every one of them is
+still alive, executing `_interpreters.exec()` inside a
+sub-interpreter our hard-kill has abandoned. At 16+
+abandoned driver threads competing for the main GIL, the
+main-interpreter trio loop gets starved and signal
+delivery stalls.)

ai/prompt-io/claude/20260417T124437Z_5cd6df5_prompt_io.md

@@ -0,0 +1,97 @@
+---
+model: claude-opus-4-7[1m]
+service: claude
+session: subints-spawner-phase-b1-impl
+timestamp: 2026-04-17T12:44:37Z
+git_ref: 5cd6df5
+scope: code
+substantive: true
+raw_file: 20260417T124437Z_5cd6df5_prompt_io.raw.md
+---
+
+## Prompt
+
+Continuing the Phase B work from the design sessions
+logged in `20260417T034918Z_9703210_prompt_io.md` and
+the Phase A impl in `20260417T035800Z_61a73ba_...`.
+
+User direction at this step:
+- "ok now let's continue with the subints part of the
+  plan ya?" → kick off Phase B.
+- After I proposed a 4-sub-phase breakdown (B.1
+  scaffolding, B.2 min-viable spawn, B.3 lifecycle,
+  B.4 test enablement), user: "ok can we continue
+  with B" → approving the phasing and design
+  defaults (thread-per-subint, UDS default,
+  code-string bootstrap via `interp.exec()`).
+- User switched the worktree to
+  `subint_spawner_backend` (instead of opening a
+  fresh worktree as I'd proposed): "i already
+  switched branches in the wkt, you should work off
+  `subint_spawner_backend` now".
+
+Scope of this turn: **B.1 scaffolding only** —
+wire the `'subint'` name through the spawn-method
+registry + harness, add a feature-detected stub
+module, bump pyproject. No actual spawn flow.
+
+## Response summary
+
+Produced the Phase B.1 scaffolding patch, landed as
+commit `5cd6df58` (subject: `Add `'subint'` spawn
+backend scaffold (#379)`). Four files changed,
++124 / -2 lines.
+
+Key pieces (all generated by claude, reviewed by
+human before commit):
+- `tractor/spawn/_subint.py` — **new**; feature-
+  detects `concurrent.interpreters`; `subint_proc()`
+  stub raises `RuntimeError` on py<3.14 or
+  `NotImplementedError` with issue-#379 URL on
+  py≥3.14. Signature mirrors `trio_proc`/`mp_proc`
+  so B.2 can drop the impl in without touching
+  `_methods`.
+- `tractor/spawn/_spawn.py` — adds `'subint'` to
+  `SpawnMethodKey`, grows a `case 'subint'` arm in
+  `try_set_start_method()` with feature-gate, re-
+  imports `sys` for the gate-error msg, adds late
+  `from ._subint import subint_proc` import and
+  `_methods` entry.
+- `tractor/_testing/pytest.py` — converts the
+  gate-error into `pytest.UsageError` via a
+  `try/except` around `try_set_start_method()` so
+  `--spawn-backend=subint` on py<3.14 prints a
+  clean banner instead of a traceback.
+- `pyproject.toml` — pin `requires-python` `<3.14`
+  → `<3.15`, add `3.14` trove classifier.
+
+## Files changed
+
+See `git diff 5cd6df5~1..5cd6df5 --stat`:
+
+```
+ pyproject.toml             |   3 +-
+ tractor/_testing/pytest.py |   8 +++-
+ tractor/spawn/_spawn.py    |  15 ++++++
+ tractor/spawn/_subint.py   | 100 +++++++++++++++++++++++++
+ 4 files changed, 124 insertions(+), 2 deletions(-)
+```
+
+Validation on py3.13:
+- registry/gate probe — OK; `_has_subints = False`,
+  `subint_proc()` raises `RuntimeError` as expected.
+- `try_set_start_method('subint')` — raises cleanly.
+- `pytest --spawn-backend=subint` — exits with
+  `pytest.UsageError` banner.
+- Spawn-relevant test subset — 69 passed, 1 skipped.
+- Full suite on py3.13 deferred (scaffolding is
+  no-op on <3.14).
+- Full-suite on py3.14 pending user setting up the
+  venv.
+
+## Human edits
+
+None — committed as generated by claude. `uv.lock`
+was intentionally left unstaged by the user (pin-
+bump regenerated cp314 wheel entries but they were
+deferred to a follow-up).

ai/prompt-io/claude/20260417T124437Z_5cd6df5_prompt_io.raw.md

@@ -0,0 +1,168 @@
+---
+model: claude-opus-4-7[1m]
+service: claude
+timestamp: 2026-04-17T12:44:37Z
+git_ref: 5cd6df5
+diff_cmd: git diff 5cd6df5~1..5cd6df5
+---
+
+Code generated in this turn was committed verbatim as
+`5cd6df58` ("Add `'subint'` spawn backend scaffold
+(#379)"). Per diff-ref mode, per-file code is captured
+via the pointers below, each followed by a prose
+summary. Non-code output (sanity-check results,
+design rationale) is included verbatim.
+
+## Per-file generated content
+
+### `tractor/spawn/_subint.py` (new, 100 lines)
+
+> `git diff 5cd6df5~1..5cd6df5 -- tractor/spawn/_subint.py`
+
+New scaffolding module for the PEP 734 subinterpreter
+backend. Contents:
+- AGPL header + module docstring (describes backend
+  intent, 3.14+ availability gate, and explicit
+  "SCAFFOLDING STUB" status pointing at issue #379).
+- Top-level `try/except ImportError` wrapping
+  `from concurrent import interpreters as
+  _interpreters` → sets module-global
+  `_has_subints: bool`. This lets the registry stay
+  introspectable on py<3.14 while spawn-time still
+  fails cleanly.
+- `subint_proc()` coroutine with signature matching
+  `trio_proc`/`mp_proc` exactly (same param names,
+  defaults, and `TaskStatus[Portal]` typing) —
+  intentional so Phase B.2 can drop the impl in
+  without touching `_methods` or changing call-site
+  binding.
+- Body raises `RuntimeError` on py<3.14 (with
+  `sys.version` printed) or `NotImplementedError`
+  with issue-#379 URL on py≥3.14.
+
+### `tractor/spawn/_spawn.py` (modified, +15 LOC)
+
+> `git diff 5cd6df5~1..5cd6df5 -- tractor/spawn/_spawn.py`
+
+- `import sys` re-added (pruned during Phase A, now
+  needed again for the py-version string in the
+  `'subint'` gate-error).
+- `SpawnMethodKey = Literal[...]` grows `'subint'` as
+  the 4th member, with inline comment `# py3.14+ via
+  `concurrent.interpreters` (PEP 734)`.
+- `try_set_start_method()` match-block grows a new
+  `case 'subint':` arm that imports
+  `from ._subint import _has_subints` lazily and
+  raises `RuntimeError` with a multi-line gate msg
+  if unavailable.
+- Bottom-of-module late-import section grows
+  `from ._subint import subint_proc` alongside the
+  existing `_trio` / `_mp` imports.
+- `_methods` dict grows `'subint': subint_proc`.
+
+### `tractor/_testing/pytest.py` (modified, +8 LOC)
+
+> `git diff 5cd6df5~1..5cd6df5 -- tractor/_testing/pytest.py`
+
+`pytest_configure()` wraps the
+`try_set_start_method(backend)` call in a
+`try/except RuntimeError` that re-raises as
+`pytest.UsageError(str(err))`. Rationale: the gate
+error on py<3.14 is legitimately a configuration
+problem, not a test failure, so pytest's UsageError
+path (exit code 4) gives a clean single-line banner
+instead of a traceback.
+
+### `pyproject.toml` (modified, +2 / -1)
+
+> `git diff 5cd6df5~1..5cd6df5 -- pyproject.toml`
+
+- `requires-python` pin relaxed `>=3.12, <3.14` →
+  `>=3.12, <3.15` to admit 3.14 as a valid target.
+- Added `"Programming Language :: Python :: 3.14"`
+  to the trove classifiers.
+
+## Non-code output (verbatim)
+
+### Design choices captured in the prior turn
+
+(Previously confirmed by the user on April 17 in this
+session — relevant excerpts captured here for
+provenance since they drove the shape of the impl):
+
+1. **Python pin**: `<3.15` + feature-gate the subint
+   backend at spawn time — user answered option (a)
+   from the design triage.
+2. **Deferred `fork()`-via-subint hack** from issue
+   #379's "Our own thoughts" section.
+3. **Phase B phasing**: user approved the B.1 / B.2 /
+   B.3 / B.4 breakdown — this commit is strictly B.1
+   (scaffolding only, no spawn-flow impl).
+4. **Option (B) worktree strategy**: new worktree
+   branched from `wkt/spawn_modularize`. *(Amended by
+   user at runtime: user switched the existing
+   `spawn_modularize` worktree to the
+   `subint_spawner_backend` branch instead.)*
+
+### Sanity-check output (verbatim terminal excerpts)
+
+Registry / feature-gate verification on py3.13:
+```
+SpawnMethodKey values: ('trio', 'mp_spawn',
+                       'mp_forkserver', 'subint')
+_methods keys: ['trio', 'mp_spawn',
+                'mp_forkserver', 'subint']
+_has_subints: False (py version: (3, 13) )
+[expected] RuntimeError: The 'subint' spawn backend
+requires Python 3.14+ (stdlib
+`concurrent.interpreters`, PEP 734).
+```
+
+`try_set_start_method('subint')` gate on py3.13:
+```
+[expected] RuntimeError: Spawn method 'subint'
+requires Python 3.14+ (stdlib
+`concurrent.interpreters`, PEP 734).
+```
+
+Pytest `--spawn-backend=subint` on py3.13 (the new
+UsageError wrapper kicking in):
+```
+ERROR: Spawn method 'subint' requires Python 3.14+
+(stdlib `concurrent.interpreters`, PEP 734).
+Current runtime: 3.13.11 (main, Dec  5 2025,
+16:06:33) [GCC 15.2.0]
+```
+
+Collection probe: `404 tests collected in 0.18s`
+(no import errors from the new module).
+
+Spawn-relevant test subset (`tests/test_local.py
+test_rpc.py test_spawning.py test_multi_program.py
+tests/discovery/`):
+```
+69 passed, 1 skipped, 10 warnings in 61.38s
+```
+
+Full suite was **not** run on py3.13 for this commit
+— the scaffolding is no-op on <3.14 and full-suite
+validation under py3.14 is pending that venv being
+set up by the user.
+
+### Commit message
+
+Also AI-drafted (via `/commit-msg`, with the prose
+rewrapped through `/home/goodboy/.claude/skills/pr-msg/
+scripts/rewrap.py --width 67`) — the 33-line message
+on commit `5cd6df58` itself. Not reproduced here; see
+`git log -1 5cd6df58`.
+
+### Known follow-ups flagged to user
+
+- **`uv.lock` deferred**: pin-bump regenerated cp314
+  wheel entries in `uv.lock`, but the user chose to
+  not stage `uv.lock` for this commit. Warned
+  explicitly.
+- **Phase B.2 needs py3.14 venv** — running the
+  actual subint impl requires it; user said they'd
+  set it up separately.

ai/prompt-io/claude/20260418T042526Z_26fb820_prompt_io.md

@@ -0,0 +1,117 @@
+---
+model: claude-opus-4-7[1m]
+service: claude
+session: subints-phase-b2-destroy-race-fix
+timestamp: 2026-04-18T04:25:26Z
+git_ref: 26fb820
+scope: code
+substantive: true
+raw_file: 20260418T042526Z_26fb820_prompt_io.raw.md
+---
+
+## Prompt
+
+Follow-up to Phase B.2 (`5cd6df58`) after the user
+observed intermittent mid-suite hangs when running
+the tractor test suite under `--spawn-backend=subint`
+on py3.14. The specific sequence of prompts over
+several turns:
+
+1. User pointed at the `test_context_stream_semantics.py`
+   suite as the first thing to make run clean under
+   `--spawn-backend=subint`.
+2. After a series of `timeout`-terminated runs that
+   gave no diagnostic info, user nudged me to stop
+   relying on `timeout` and get actual runtime
+   diagnostics ("the suite hangs indefinitely, so i
+   don't think this `timeout 30` is helping you at
+   all.."). Switched to
+   `faulthandler.dump_traceback_later(...)` and a
+   resource-tracker fixture to rule out leaks.
+3. Captured a stack pinning the hang on
+   `_interpreters.destroy(interp_id)` in the subint
+   teardown finally block.
+4. Proposed dedicated-OS-thread fix. User greenlit.
+5. Implemented + verified on-worktree; user needed
+   to be pointed at the *worktree*'s `./py313` venv
+   because bare `pytest` was picking up the main
+   repo's venv (running un-patched `_subint.py`) and
+   still hanging.
+
+Running theme over the whole exchange: this patch
+only closes the *destroy race*. The user and I also
+traced through the deeper cancellation story — SIGINT
+can't reach subints, legacy-mode shares the GIL,
+portal-cancel dies when the IPC channel is already
+broken — and agreed the next step is a bounded
+hard-kill in `subint_proc`'s teardown plus a
+dedicated cancellation test suite. Those land as
+separate commits.
+
+## Response summary
+
+Produced the `tractor/spawn/_subint.py` patch landed
+as commit `26fb8206` ("Fix subint destroy race via
+dedicated OS thread"). One file, +110/-84 LOC.
+
+Mechanism: swap `trio.to_thread.run_sync(_interpreters
+.exec, ...)` for a plain `threading.Thread(target=...
+, daemon=False)`. The trio thread cache recycles
+workers — so the OS thread that ran `_interpreters
+.exec()` remained alive in the cache holding a
+stale subint tstate, blocking
+`_interpreters.destroy()` in the finally indefinitely.
+A dedicated one-shot thread exits naturally after
+the sync target returns, releasing tstate and
+unblocking destroy.
+
+Coordination across the trio↔thread boundary:
+- `trio.lowlevel.current_trio_token()` captured at
+  `subint_proc` entry
+- driver thread signals `subint_exited.set()` back
+  to parent trio via `trio.from_thread.run_sync(...,
+  trio_token=token)` (synchronous from the thread's
+  POV; the call returns after trio has run `.set()`)
+- `trio.RunFinishedError` swallowed in that path for
+  the process-teardown case where parent trio already
+  exited
+- teardown `finally` off-loads the sync
+  `driver_thread.join()` via `to_thread.run_sync` (a
+  cache thread carries no subint tstate — safe)
+
+## Files changed
+
+See `git diff 26fb820~1..26fb820 --stat`:
+
+```
+ tractor/spawn/_subint.py | 194 +++++++++++++++++++------------
+ 1 file changed, 110 insertions(+), 84 deletions(-)
+```
+
+Validation:
+- `test_parent_cancels[chk_ctx_result_before_exit=True-
+  cancel_method=ctx-child_returns_early=False]`
+  (the specific test that was hanging for the user)
+  — passed in 1.06s.
+- Full `tests/test_context_stream_semantics.py` under
+  subint — 61 passed in 100.35s (clean-cache re-run:
+  100.82s).
+- Trio backend regression subset — 69 passed / 1
+  skipped / 89.19s — no regressions from this change.
+
+## Files changed
+
+Beyond the `_subint.py` patch, the raw log also
+records the cancellation-semantics research that
+spanned this conversation but did not ship as code
+in *this* commit. Preserving it inline under "Non-
+code output" because it directly informs the
+Phase B.3 hard-kill impl that will follow (and any
+upstream CPython bug reports we end up filing).
+
+## Human edits
+
+None — committed as generated. The commit message
+itself was also AI-drafted via `/commit-msg` and
+rewrapped via the project's `rewrap.py --width 67`
+tooling; user landed it without edits.

ai/prompt-io/claude/20260418T042526Z_26fb820_prompt_io.raw.md

@@ -0,0 +1,220 @@
+---
+model: claude-opus-4-7[1m]
+service: claude
+timestamp: 2026-04-18T04:25:26Z
+git_ref: 26fb820
+diff_cmd: git diff 26fb820~1..26fb820
+---
+
+Code generated in this turn was committed as `26fb8206`
+("Fix subint destroy race via dedicated OS thread").
+Per diff-ref mode, per-file code is captured via the
+pointer below; the rest is verbatim non-code output
+— test-session diagnostics, CPython-internals
+reasoning, and the design synthesis that's worth
+keeping alongside the code since it informs the
+still-pending Phase B.3 hard-kill work.
+
+## Per-file generated content
+
+### `tractor/spawn/_subint.py` (modified, +110/-84 LOC)
+
+> `git diff 26fb820~1..26fb820 -- tractor/spawn/_subint.py`
+
+Rewrites the subint driver-thread strategy:
+- replaces `trio.to_thread.run_sync(_interpreters.exec, ...)`
+  with a plain `threading.Thread(target=_subint_target,
+  daemon=False)` so the OS thread truly exits after
+  `_interpreters.exec()` returns
+- captures a `trio.lowlevel.current_trio_token()` at
+  `subint_proc` entry; the driver thread signals
+  completion back via `trio.from_thread.run_sync(
+  subint_exited.set, trio_token=...)`
+- swallows `trio.RunFinishedError` in the signal path
+  for the case where the parent trio loop has already
+  exited (process teardown)
+- in the teardown `finally` off-loads the sync
+  `driver_thread.join()` call to `trio.to_thread.run_sync`
+  (a cache thread w/ no subint tstate — so no cache
+  conflict) to wait for the driver thread to fully
+  exit before calling `_interpreters.destroy()`
+
+## Non-code output (verbatim) — the CPython-internals research
+
+### What went wrong before this commit
+
+Under `--spawn-backend=subint` on py3.14, most single
+tests passed but longer runs hung intermittently. The
+position of the hang moved between runs (test #22 on
+one run, test #53 on another) suggesting a timing-
+dependent race rather than a deterministic bug.
+
+`faulthandler.dump_traceback_later()` eventually
+caught a stack with the main thread blocked in
+`_interpreters.destroy(interp_id)` at `_subint.py:293`.
+Only 2 threads were alive:
+- main thread waiting in `_interpreters.destroy()`
+- one idle trio thread-cache worker in
+  `trio._core._thread_cache._work`
+
+No subint was still running (`_interpreters.list_all()`
+showed only the main interp). A resource-tracker
+pytest fixture confirmed threads/subints did NOT
+accumulate across tests — this was not a leak but a
+specific "destroy blocks on cached thread w/ stale
+tstate" race.
+
+### Why the race exists
+
+`trio.to_thread.run_sync` uses a thread *cache* to
+avoid OS-thread creation overhead. When the sync
+callable returns, the OS thread is NOT terminated —
+it's parked in `_thread_cache._work` waiting for the
+next job. CPython's subinterpreter implementation
+attaches a **tstate** (thread-state object) to each
+OS thread that ever entered a subint via
+`_interpreters.exec()`. That tstate is released
+lazily — either when the thread picks up a new job
+(which re-attaches a new tstate, evicting the old
+one) or when the thread truly exits.
+
+`_interpreters.destroy(interp_id)` waits for *all*
+tstates associated w/ that subint to be released
+before it can proceed. If the cached worker is idle
+holding the stale tstate, destroy blocks indefinitely.
+Whether the race manifests depends on timing — if
+the cached thread happens to pick up another job
+quickly, destroy unblocks; if it sits idle, we hang.
+
+### Why a dedicated `threading.Thread` fixes it
+
+A plain `threading.Thread(target=_subint_target,
+daemon=False)` runs its target once and exits. When
+the target returns, OS-thread teardown (`_bootstrap_inner`
+→ `_bootstrap`) fires and CPython releases the
+tstate for that thread. `_interpreters.destroy()`
+then has no blocker.
+
+### Diagnostic tactics that actually helped
+
+1. `faulthandler.dump_traceback_later(n, repeat=False,
+   file=open(path, 'w'))` for captured stack dumps on
+   hang. Critically, pipe to a `file=` not stderr —
+   pytest captures stderr weirdly and the dump is
+   easy to miss.
+2. A resource-tracker autouse fixture printing
+   per-test `threading.active_count()` +
+   `len(_interpreters.list_all())` deltas → ruled out
+   leak-accumulation theories quickly.
+3. Running the hanging test *solo* vs in-suite —
+   when solo passes but in-suite hangs, you know
+   it's a cross-test state-transfer bug rather than
+   a test-internal bug.
+
+### Design synthesis — SIGINT + subints + SC
+
+The user and I walked through the cancellation
+semantics of PEP 684/734 subinterpreters in detail.
+Key findings we want to preserve:
+
+**Signal delivery in subints (stdlib limitation).**
+CPython's signal machinery only delivers signals
+(SIGINT included) to the *main thread of the main
+interpreter*. Subints cannot install signal handlers
+that will ever fire. This is an intentional design
+choice in PEP 684 and not expected to change. For
+tractor's subint actors, this means:
+
+- Ctrl-C never reaches a subint directly.
+- `trio.run()` running on a worker thread (as we do
+  for subints) already skips SIGINT handler install
+  because `signal.signal()` raises on non-main
+  threads.
+- The only cancellation surface into a subint is
+  our IPC `Portal.cancel_actor()`.
+
+**Legacy-mode subints share the main GIL** (which
+our impl uses since `msgspec` lacks PEP 684 support
+per `jcrist/msgspec#563`). This means a stuck subint
+thread can starve the parent's trio loop during
+cancellation — the parent can't even *start* its
+teardown handling until the subint yields the GIL.
+
+**Failure modes identified for Phase B.3 audit:**
+
+1. Portal cancel lands cleanly → subint unwinds →
+   thread exits → destroy succeeds. (Happy path.)
+2. IPC channel is already broken when we try to
+   send cancel (e.g., `test_ipc_channel_break_*`)
+   → cancel raises `BrokenResourceError` → subint
+   keeps running unaware → parent hangs waiting for
+   `subint_exited`. This is what breaks
+   `test_advanced_faults.py` under subint.
+3. Subint is stuck in non-checkpointing Python code
+   → portal-cancel msg queued but never processed.
+4. Subint is in a shielded cancel scope when cancel
+   arrives → delay until shield exits.
+
+**Current teardown has a shield-bug too:**
+`trio.CancelScope(shield=True)` wrapping the `finally`
+block absorbs Ctrl-C, so even when the user tries
+to break out they can't. This is the reason
+`test_ipc_channel_break_during_stream[break_parent-...
+no_msgstream_aclose]` locks up unkillable.
+
+**B.3 hard-kill fix plan (next commit):**
+
+1. Bound `driver_thread.join()` with
+   `trio.move_on_after(HARD_KILL_TIMEOUT)`.
+2. If it times out, log a warning naming the
+   `interp_id` and switch the driver thread to
+   `daemon=True` mode (not actually possible after
+   start — so instead create as daemon=True upfront
+   and accept the tradeoff of proc-exit not waiting
+   for a stuck subint).
+3. Best-effort `_interpreters.destroy()`; catch the
+   `InterpreterError` if the subint is still running.
+4. Document that the leak is real and the only
+   escape hatch we have without upstream cooperation.
+
+**Test plan for Phase B.3:**
+
+New `tests/test_subint_cancellation.py` covering:
+- SIGINT at spawn
+- SIGINT mid-portal-RPC
+- SIGINT during shielded section in subint
+- Dead-channel cancel (mirror of `test_ipc_channel_
+  break_during_stream` minimized)
+- Non-checkpointing subint (tight `while True` in
+  user code)
+- Per-test `pytest-timeout`-style bounds so the
+  tests visibly fail instead of wedging the runner
+
+### Sanity-check output (verbatim terminal excerpts)
+
+Post-fix single-test validation:
+```
+1 passed, 1 warning in 1.06s
+```
+(same test that was hanging pre-fix:
+`test_parent_cancels[...cancel_method=ctx-...False]`)
+
+Full `tests/test_context_stream_semantics.py`
+under subint:
+```
+61 passed, 1 warning in 100.35s (0:01:40)
+```
+and a clean-cache re-run:
+```
+61 passed, 1 warning in 100.82s (0:01:40)
+```
+
+No regressions on trio backend (same subset):
+```
+69 passed, 1 skipped, 3 warnings in 89.19s
+```
+
+### Commit msg
+
+Also AI-drafted via `/commit-msg` + `rewrap.py
+--width 67`. See `git log -1 26fb820`.

ai/prompt-io/claude/20260420T192739Z_5e8cd8b2_prompt_io.md

@@ -0,0 +1,111 @@
+---
+model: claude-opus-4-7[1m]
+service: claude
+session: subint-phase-b-hang-classification
+timestamp: 2026-04-20T19:27:39Z
+git_ref: HEAD (pre-commit; on branch `subint_spawner_backend`)
+scope: docs
+substantive: true
+raw_file: 20260420T192739Z_5e8cd8b2_prompt_io.raw.md
+---
+
+## Prompt
+
+Collab between user (`goodboy`) and `claude` to
+disambiguate two distinct hang modes hit during
+Phase B subint-spawn-backend bringup (issue #379).
+The user ran the failing suites, captured `strace`
+evidence on hung pytest pids, and set the framing:
+
+> "These cannot be the same bug. Different fix
+> paths. Write them up separately or we'll keep
+> conflating them."
+
+Follow-on asks:
+- Cross-link each doc from its reproducer test so
+  a future triager lands on the analysis without
+  needing to grep `ai/conc-anal/`.
+- On `test_stale_entry_is_deleted`: arm
+  `dump_on_hang(seconds=20, path=...)` so a
+  regression captures a stack dump (pytest stderr
+  capture otherwise eats `faulthandler` output).
+- Keep `test_stale_entry_is_deleted` un-`skip`ped
+  so the dump file remains inspectable.
+
+Defer the actual fix for the class-2 hang
+(Ctrl-C-able, tractor-side bug) to a later commit
+per the incremental-commits preference.
+
+## Response summary
+
+Wrote two new `ai/conc-anal/` classification docs
+and cross-linked them from the reproducer tests:
+
+1. **`subint_sigint_starvation_issue.md`** —
+   class 1: abandoned-legacy-subint thread +
+   shared GIL starves main trio loop →
+   signal-wakeup-fd pipe fills → SIGINT silently
+   dropped (`write() = EAGAIN`). Pytest process
+   un-Ctrl-C-able. Structurally a CPython limit;
+   blocked on `msgspec` PEP 684 support
+   (jcrist/msgspec#563). Reproducer:
+   `test_stale_entry_is_deleted[subint]`.
+
+2. **`subint_cancel_delivery_hang_issue.md`** —
+   class 2: parent-side trio task parks on an
+   orphaned IPC channel after subint teardown;
+   no clean EOF delivered to waiting receiver.
+   Ctrl-C-able (main trio loop iterating fine).
+   OUR bug to fix. Candidate fix: explicit
+   parent-side channel abort in `subint_proc`'s
+   hard-kill teardown. Reproducer:
+   `test_subint_non_checkpointing_child`.
+
+Test-side cross-links:
+- `tests/discovery/test_registrar.py`:
+  `test_stale_entry_is_deleted` → `trio.run(main)`
+  wrapped in `dump_on_hang(seconds=20,
+  path=<per-method-tmp>)`; long inline comment
+  summarizes `strace` evidence + root-cause chain
+  and points at both docs.
+- `tests/test_subint_cancellation.py`:
+  `test_subint_non_checkpointing_child` docstring
+  extended with "KNOWN ISSUE (Ctrl-C-able hang)"
+  section pointing at the class-2 doc + noting
+  the class-1 doc is NOT what this test hits.
+
+## Files changed
+
+- `ai/conc-anal/subint_sigint_starvation_issue.md`
+  — new, 205 LOC
+- `ai/conc-anal/subint_cancel_delivery_hang_issue.md`
+  — new, 161 LOC
+- `tests/discovery/test_registrar.py` — +52/-1
+  (arm `dump_on_hang`, inline-comment cross-link)
+- `tests/test_subint_cancellation.py` — +26
+  (docstring "KNOWN ISSUE" block)
+
+## Human edits
+
+Substantive collab — prose was jointly iterated:
+
+- User framed the two-doc split, set the
+  classification criteria (Ctrl-C-able vs not),
+  and provided the `strace` evidence.
+- User decided to keep `test_stale_entry_is_deleted`
+  un-`skip`ped (my initial suggestion was
+  `pytestmark.skipif(spawn_backend=='subint')`).
+- User chose the candidate fix ordering for
+  class 2 and marked "explicit parent-side channel
+  abort" as the surgical preferred fix.
+- User picked the file naming convention
+  (`subint_<hang-shape>_issue.md`) over my initial
+  `hang_class_{1,2}.md`.
+- Assistant drafted the prose, aggregated prior-
+  session root-cause findings from Phase B.2/B.3
+  bringup, and wrote the test-side cross-linking
+  comments.
+
+No further mechanical edits expected before
+commit; user may still rewrap via
+`scripts/rewrap.py` if preferred.

ai/prompt-io/claude/20260420T192739Z_5e8cd8b2_prompt_io.raw.md

@@ -0,0 +1,198 @@
+---
+model: claude-opus-4-7[1m]
+service: claude
+timestamp: 2026-04-20T19:27:39Z
+git_ref: HEAD (pre-commit; will land on branch `subint_spawner_backend`)
+diff_cmd: git diff HEAD~1..HEAD
+---
+
+Collab between `goodboy` (user) and `claude` (this
+assistant) spanning multiple test-run iterations on
+branch `subint_spawner_backend`. The user ran the
+failing suites, captured `strace` evidence on the
+hung pytest pids, and set the direction ("these are
+two different hangs — write them up separately so
+we don't re-confuse ourselves later"). The assistant
+aggregated prior-session findings (Phase B.2/B.3
+bringup) into two classification docs + test-side
+cross-links. All prose was jointly iterated; the
+user had final say on framing and decided which
+candidate fix directions to list.
+
+## Per-file generated content
+
+### `ai/conc-anal/subint_sigint_starvation_issue.md` (new, 205 LOC)
+
+> `git diff HEAD~1..HEAD -- ai/conc-anal/subint_sigint_starvation_issue.md`
+
+Writes up the "abandoned-legacy-subint thread wedges
+the parent trio loop" class. Key sections:
+
+- **Symptom** — `test_stale_entry_is_deleted[subint]`
+  hangs indefinitely AND is un-Ctrl-C-able.
+- **Evidence** — annotated `strace` excerpt showing
+  SIGINT delivered to pytest, C-level signal handler
+  tries to write to the signal-wakeup-fd pipe, gets
+  `write() = -1 EAGAIN (Resource temporarily
+  unavailable)`. Pipe is full because main trio loop
+  isn't iterating often enough to drain it.
+- **Root-cause chain** — our hard-kill abandons the
+  `daemon=True` driver OS thread after
+  `_HARD_KILL_TIMEOUT`; the subint *inside* that
+  thread is still running `trio.run()`;
+  `_interpreters.destroy()` cannot force-stop a
+  running subint (raises `InterpreterError`); legacy
+  subints share the main GIL → abandoned subint
+  starves main trio loop → wakeup-fd fills → SIGINT
+  silently dropped.
+- **Why it's structurally a CPython limit** — no
+  public force-destroy primitive for a running
+  subint; the only escape is per-interpreter GIL
+  isolation, gated on msgspec PEP 684 adoption
+  (jcrist/msgspec#563).
+- **Current escape hatch** — harness-side SIGINT
+  loop in the `daemon` fixture teardown that kills
+  the bg registrar subproc, eventually unblocking
+  a parent-side recv enough for the main loop to
+  drain the wakeup pipe.
+
+### `ai/conc-anal/subint_cancel_delivery_hang_issue.md` (new, 161 LOC)
+
+> `git diff HEAD~1..HEAD -- ai/conc-anal/subint_cancel_delivery_hang_issue.md`
+
+Writes up the *sibling* hang class — same subint
+backend, distinct root cause:
+
+- **TL;DR** — Ctrl-C-able, so NOT the SIGINT-
+  starvation class; main trio loop iterates fine;
+  ours to fix.
+- **Symptom** — `test_subint_non_checkpointing_child`
+  hangs past the expected `_HARD_KILL_TIMEOUT`
+  budget even after the subint is torn down.
+- **Diagnosis** — a parent-side trio task (likely
+  a `chan.recv()` in `process_messages`) parks on
+  an orphaned IPC channel; channel was torn down
+  without emitting a clean EOF /
+  `BrokenResourceError` to the waiting receiver.
+- **Candidate fix directions** — listed in rough
+  order of preference:
+  1. Explicit parent-side channel abort in
+     `subint_proc`'s hard-kill teardown (surgical;
+     most likely).
+  2. Audit `process_messages` to add a timeout or
+     cancel-scope protection that catches the
+     orphaned-recv state.
+  3. Wrap subint IPC channel construction in a
+     sentinel that can force-close from the parent
+     side regardless of subint liveness.
+
+### `tests/discovery/test_registrar.py` (modified, +52/-1 LOC)
+
+> `git diff HEAD~1..HEAD -- tests/discovery/test_registrar.py`
+
+Wraps the `trio.run(main)` call at the bottom of
+`test_stale_entry_is_deleted` in
+`dump_on_hang(seconds=20, path=<per-method-tmp>)`.
+Adds a long inline comment that:
+- Enumerates variant-by-variant status
+  (`[trio]`/`[mp_*]` = clean; `[subint]` = hangs
+  + un-Ctrl-C-able)
+- Summarizes the `strace` evidence and root-cause
+  chain inline (so a future reader hitting this
+  test doesn't need to cross-ref the doc to
+  understand the hang shape)
+- Points at
+  `ai/conc-anal/subint_sigint_starvation_issue.md`
+  for full analysis
+- Cross-links to the *sibling*
+  `subint_cancel_delivery_hang_issue.md` so
+  readers can tell the two classes apart
+- Explains why it's kept un-`skip`ped: the dump
+  file is useful if the hang ever returns after
+  a refactor. pytest stderr capture would
+  otherwise eat `faulthandler` output, hence the
+  file path.
+
+### `tests/test_subint_cancellation.py` (modified, +26 LOC)
+
+> `git diff HEAD~1..HEAD -- tests/test_subint_cancellation.py`
+
+Extends the docstring of
+`test_subint_non_checkpointing_child` with a
+"KNOWN ISSUE (Ctrl-C-able hang)" block:
+- Describes the current hang: parent-side orphaned
+  IPC recv after hard-kill; distinct from the
+  SIGINT-starvation sibling class.
+- Cites `strace` distinguishing signal: wakeup-fd
+  `write() = 1` (not `EAGAIN`) — i.e. main loop
+  iterating.
+- Points at
+  `ai/conc-anal/subint_cancel_delivery_hang_issue.md`
+  for full analysis + candidate fix directions.
+- Clarifies that the *other* sibling doc
+  (SIGINT-starvation) is NOT what this test hits.
+
+## Non-code output
+
+### Classification reasoning (why two docs, not one)
+
+The user and I converged on the two-doc split after
+running the suites and noticing two *qualitatively
+different* hang symptoms:
+
+1. `test_stale_entry_is_deleted[subint]` — pytest
+   process un-Ctrl-C-able. Ctrl-C at the terminal
+   does nothing. Must kill-9 from another shell.
+2. `test_subint_non_checkpointing_child` — pytest
+   process Ctrl-C-able. One Ctrl-C at the prompt
+   unblocks cleanly and the test reports a hang
+   via pytest-timeout.
+
+From the user: "These cannot be the same bug.
+Different fix paths. Write them up separately or
+we'll keep conflating them."
+
+`strace` on the `[subint]` hang gave the decisive
+signal for the first class:
+
+```
+--- SIGINT {si_signo=SIGINT, si_code=SI_KERNEL} ---
+write(5, "\2", 1) = -1 EAGAIN (Resource temporarily unavailable)
+```
+
+fd 5 is Python's signal-wakeup-fd pipe. `EAGAIN`
+on a `write()` of 1 byte to a pipe means the pipe
+buffer is full → reader side (main Python thread
+inside `trio.run()`) isn't consuming. That's the
+GIL-hostage signature.
+
+The second class's `strace` showed `write(5, "\2",
+1) = 1` — clean drain — so the main trio loop was
+iterating and the hang had to be on the application
+side of things, not the kernel-↔-Python signal
+boundary.
+
+### Why the candidate fix for class 2 is "explicit parent-side channel abort"
+
+The second hang class has the trio loop alive. A
+parked `chan.recv()` that will never get bytes is
+fundamentally a tractor-side resource-lifetime bug
+— the IPC channel was torn down (subint destroyed)
+but no one explicitly raised
+`BrokenResourceError` at the parent-side receiver.
+The `subint_proc` hard-kill path is the natural
+place to add that notification, because it already
+knows the subint is unreachable at that point.
+
+Alternative fix paths (blanket timeouts on
+`process_messages`, sentinel-wrapped channels) are
+less surgical and risk masking unrelated bugs —
+hence the preference ordering in the doc.
+
+### Why we're not just patching the code now
+
+The user explicitly deferred the fix to a later
+commit: "Document both classes now, land the fix
+for class 2 separately so the diff reviews clean."
+This matches the incremental-commits preference
+from memory.

ai/prompt-io/claude/20260422T200723Z_797f57c_prompt_io.md

@@ -0,0 +1,155 @@
+---
+model: claude-opus-4-7[1m]
+service: claude
+session: subints-phase-b-hardening-and-fork-block
+timestamp: 2026-04-22T20:07:23Z
+git_ref: 797f57c
+scope: code
+substantive: true
+raw_file: 20260422T200723Z_797f57c_prompt_io.raw.md
+---
+
+## Prompt
+
+Session-spanning work on the Phase B `subint` spawn-backend.
+Three distinct sub-phases in one log:
+
+1. **Py3.13 gate tightening** — diagnose a reproducible hang
+   of subint spawn flow under py3.13 (works on py3.14), trace
+   to a private `_interpreters` module vintage issue, tighten
+   our feature gate from "`_interpreters` present" to "public
+   `concurrent.interpreters` present" (i.e. py3.14+).
+2. **Test-harness hardening** — add `pytest-timeout` dep, put
+   `@pytest.mark.timeout(30, method='thread')` on the
+   three known-hanging subint tests cataloged in
+   `ai/conc-anal/subint_sigint_starvation_issue.md`. Separately,
+   code-review the user's in-flight `skipon_spawn_backend`
+   marker implementation; find four bugs; refactor to use
+   `item.iter_markers()`.
+3. **`subint_fork` prototype → CPython-block finding** — draft
+   a WIP `subint_fork_proc` backend using a sub-interpreter as
+   a launchpad for `os.fork()` (to sidestep trio#1614). User
+   tests on py3.14, hits
+   `Fatal Python error: _PyInterpreterState_DeleteExceptMain:
+   not main interpreter`. Walk CPython sources (local clone at
+   `~/repos/cpython/`) to pinpoint the refusal
+   (`Modules/posixmodule.c:728` → `Python/pystate.c:1040`).
+   Revert implementation to a `NotImplementedError` stub in a
+   new `_subint_fork.py` submodule, document the finding in a
+   third `conc-anal/` doc with an upstream-report draft for
+   the CPython issue tracker. Finally, discuss user's proposed
+   workaround architecture (main-interp worker-thread
+   forkserver) and draft a standalone smoke-test script for
+   feasibility validation.
+
+## Response summary
+
+All three sub-phases landed concrete artifacts:
+
+**Sub-phase 1** — `_subint.py` + `_spawn.py` gates + error
+messages updated to require py3.14+ via the public
+`concurrent.interpreters` module presence check. Module
+docstring revised to explain the empirical reason
+(py3.13's private `_interpreters` vintage wedges under
+multi-trio-task usage even though minimal standalone
+reproducers work fine there). Test-module
+`pytest.importorskip` likewise switched.
+
+**Sub-phase 2** — `pytest-timeout>=2.3` added to `testing`
+dep group. `@pytest.mark.timeout(30, method='thread')`
+applied on:
+- `tests/discovery/test_registrar.py::test_stale_entry_is_deleted`
+- `tests/test_cancellation.py::test_cancel_while_childs_child_in_sync_sleep`
+- `tests/test_cancellation.py::test_multierror_fast_nursery`
+- `tests/test_subint_cancellation.py::test_subint_non_checkpointing_child`
+
+`method='thread'` documented inline as load-bearing — the
+GIL-starvation path that drops `SIGINT` would equally drop
+`SIGALRM`, so only a watchdog-thread timeout can reliably
+escape.
+
+`skipon_spawn_backend` plugin refactored into a single
+`iter_markers`-driven loop in `pytest_collection_modifyitems`
+(~30 LOC replacing ~30 LOC of nested conditionals). Four
+bugs dissolved: wrong `.get()` key, module-level `pytestmark`
+suppressing per-test marks, unhandled `pytestmark = [list]`
+form, `pytest.Makr` typo. Marker help text updated to
+document the variadic backend-list + `reason=` kwarg
+surface.
+
+**Sub-phase 3** — Prototype drafted (then reverted):
+
+- `tractor/spawn/_subint_fork.py` — new dedicated submodule
+  housing the `subint_fork_proc` stub. Module docstring +
+  fn docstring explain the attempt, the CPython-level
+  block, and the reason for keeping the stub in-tree
+  (documentation of the attempt + starting point if CPython
+  ever lifts the restriction).
+- `tractor/spawn/_spawn.py` — `'subint_fork'` registered as a
+  `SpawnMethodKey` literal + in `_methods`, so
+  `--spawn-backend=subint_fork` routes to a clean
+  `NotImplementedError` pointing at the analysis doc rather
+  than an "invalid backend" error.
+- `ai/conc-anal/subint_fork_blocked_by_cpython_post_fork_issue.md` —
+  third sibling conc-anal doc. Full annotated CPython
+  source walkthrough from user-visible
+  `Fatal Python error` → `Modules/posixmodule.c:728
+  PyOS_AfterFork_Child()` → `Python/pystate.c:1040
+  _PyInterpreterState_DeleteExceptMain()` gate. Includes a
+  copy-paste-ready upstream-report draft for the CPython
+  issue tracker with a two-tier ask (ideally "make it work",
+  minimally "cleaner error than `Fatal Python error`
+  aborting the child").
+- `ai/conc-anal/subint_fork_from_main_thread_smoketest.py` —
+  standalone zero-tractor-import CPython-level smoke test
+  for the user's proposed workaround architecture
+  (forkserver on a main-interp worker thread). Four
+  argparse-driven scenarios: `control_subint_thread_fork`
+  (reproduces the known-broken case as a test-harness
+  sanity),  `main_thread_fork` (baseline), `worker_thread_fork`
+  (architectural assertion), `full_architecture`
+  (end-to-end trio-in-subint in forked child). User will
+  run on py3.14 next.
+
+## Files changed
+
+See `git log 26fb820..HEAD --stat` for the canonical list.
+New files this session:
+- `tractor/spawn/_subint_fork.py`
+- `ai/conc-anal/subint_fork_blocked_by_cpython_post_fork_issue.md`
+- `ai/conc-anal/subint_fork_from_main_thread_smoketest.py`
+
+Modified (diff pointers in raw log):
+- `tractor/spawn/_subint.py` (py3.14 gate)
+- `tractor/spawn/_spawn.py` (`subint_fork` registration)
+- `tractor/_testing/pytest.py` (`skipon_spawn_backend` refactor)
+- `pyproject.toml` (`pytest-timeout` dep)
+- `tests/discovery/test_registrar.py`,
+  `tests/test_cancellation.py`,
+  `tests/test_subint_cancellation.py` (timeout marks,
+  cross-refs to conc-anal docs)
+
+## Human edits
+
+Several back-and-forth iterations with user-driven
+adjustments during the session:
+
+- User corrected my initial mis-classification of
+  `test_cancel_while_childs_child_in_sync_sleep[subint-False]`
+  as Ctrl-C-able — second strace showed `EAGAIN`, putting
+  it squarely in class A (GIL-starvation). Re-analysis
+  preserved in the raw log.
+- User independently fixed the `.get(reason)` → `.get('reason', reason)`
+  bug in the marker plugin before my review; preserved their
+  fix.
+- User suggested moving the `subint_fork_proc` stub from
+  the bottom of `_subint.py` into its own
+  `_subint_fork.py` submodule — applied.
+- User asked to keep the forkserver-architecture
+  discussion as background for the smoke-test rather than
+  committing to a tractor-side refactor until the smoke
+  test validates the CPython-level assumptions.
+
+Commit messages in this range (b025c982 … 797f57c) were
+drafted via `/commit-msg` + `rewrap.py --width 67`; user
+landed them with the usual review.

ai/prompt-io/claude/20260422T200723Z_797f57c_prompt_io.raw.md

@@ -0,0 +1,343 @@
+---
+model: claude-opus-4-7[1m]
+service: claude
+timestamp: 2026-04-22T20:07:23Z
+git_ref: 797f57c
+diff_cmd: git log 26fb820..HEAD  # all session commits since the destroy-race fix log
+---
+
+Session-spanning conversation covering the Phase B hardening
+of the `subint` spawn-backend and an investigation into a
+proposed `subint_fork` follow-up which turned out to be
+blocked at the CPython level. This log is a narrative capture
+of the substantive turns (not every message) and references
+the concrete code + docs the session produced. Per diff-ref
+mode the actual code diffs are pointed at via `git log` on
+each ref rather than duplicated inline.
+
+## Narrative of the substantive turns
+
+### Py3.13 hang / gate tightening
+
+Diagnosed a reproducible hang of the `subint` backend under
+py3.13 (test_spawning tests wedge after root-actor bringup).
+Root cause: py3.13's vintage of the private `_interpreters` C
+module has a latent thread/subint-interaction issue that
+`_interpreters.exec()` silently fails to progress under
+tractor's multi-trio usage pattern — even though a minimal
+standalone `threading.Thread` + `_interpreters.exec()`
+reproducer works fine on the same Python. Empirically
+py3.14 fixes it.
+
+Fix (from this session): tighten the `_has_subints` gate in
+`tractor.spawn._subint` from "private module importable" to
+"public `concurrent.interpreters` present" — which is 3.14+
+only. This leaves `subint_proc()` unchanged in behavior (we
+still call the *private* `_interpreters.create('legacy')`
+etc. under the hood) but refuses to engage on 3.13.
+
+Also tightened the matching gate in
+`tractor.spawn._spawn.try_set_start_method('subint')` and
+rev'd the corresponding error messages from "3.13+" to
+"3.14+" with a sentence explaining why. Test-module
+`pytest.importorskip` switched from `_interpreters` →
+`concurrent.interpreters` to match.
+
+### `pytest-timeout` dep + `skipon_spawn_backend` marker plumbing
+
+Added `pytest-timeout>=2.3` to the `testing` dep group with
+an inline comment pointing at the `ai/conc-anal/*.md` docs.
+Applied `@pytest.mark.timeout(30, method='thread')` (the
+`method='thread'` is load-bearing — `signal`-method
+`SIGALRM` suffers the same GIL-starvation path that drops
+`SIGINT` in the class-A hang pattern) to the three known-
+hanging subint tests cataloged in
+`subint_sigint_starvation_issue.md`.
+
+Separately code-reviewed the user's newly-staged
+`skipon_spawn_backend` pytest marker implementation in
+`tractor/_testing/pytest.py`. Found four bugs:
+
+1. `modmark.kwargs.get(reason)` called `.get()` with the
+   *variable* `reason` as the dict key instead of the string
+   `'reason'` — user-supplied `reason=` was never picked up.
+   (User had already fixed this locally via `.get('reason',
+   reason)` by the time my review happened — preserved that
+   fix.)
+2. The module-level `pytestmark` branch suppressed per-test
+   marker handling (the `else:` was an `else:` rather than
+   independent iteration).
+3. `mod_pytestmark.mark` assumed a single
+   `MarkDecorator` — broke on the valid-pytest `pytestmark =
+   [mark, mark]` list form.
+4. Typo: `pytest.Makr` → `pytest.Mark`.
+
+Refactored the hook to use `item.iter_markers(name=...)`
+which walks function + class + module scopes uniformly and
+handles both `pytestmark` forms natively. ~30 LOC replaced
+the original ~30 LOC of nested conditionals, all four bugs
+dissolved. Also updated the marker help string to reflect
+the variadic `*start_methods` + `reason=` surface.
+
+### `subint_fork_proc` prototype attempt
+
+User's hypothesis: the known trio+`fork()` issues
+(python-trio/trio#1614) could be sidestepped by using a
+sub-interpreter purely as a launchpad — `os.fork()` from a
+subint that has never imported trio → child is in a
+trio-free context. In the child `execv()` back into
+`python -m tractor._child` and the downstream handshake
+matches `trio_proc()` identically.
+
+Drafted the prototype at `tractor/spawn/_subint.py`'s bottom
+(originally — later moved to its own submod, see below):
+launchpad-subint creation, bootstrap code-string with
+`os.fork()` + `execv()`, driver-thread orchestration,
+parent-side `ipc_server.wait_for_peer()` dance. Registered
+`'subint_fork'` as a new `SpawnMethodKey` literal, added
+`case 'subint' | 'subint_fork':` feature-gate arm in
+`try_set_start_method()`, added entry in `_methods` dict.
+
+### CPython-level block discovered
+
+User tested on py3.14 and saw:
+
+```
+Fatal Python error: _PyInterpreterState_DeleteExceptMain: not main interpreter
+Python runtime state: initialized
+
+Current thread 0x00007f6b71a456c0 [subint-fork-lau] (most recent call first):
+  File "<script>", line 2 in <module>
+<script>:2: DeprecationWarning: This process (pid=802985) is multi-threaded, use of fork() may lead to deadlocks in the child.
+```
+
+Walked CPython sources (local clone at `~/repos/cpython/`):
+
+- **`Modules/posixmodule.c:728` `PyOS_AfterFork_Child()`** —
+  post-fork child-side cleanup. Calls
+  `_PyInterpreterState_DeleteExceptMain(runtime)` with
+  `goto fatal_error` on non-zero status. Has the
+  `// Ideally we could guarantee tstate is running main.`
+  self-acknowledging-fragile comment directly above.
+
+- **`Python/pystate.c:1040`
+  `_PyInterpreterState_DeleteExceptMain()`** — the
+  refusal. Hard `PyStatus_ERR("not main interpreter")` gate
+  when `tstate->interp != interpreters->main`. Docstring
+  formally declares the precondition ("If there is a
+  current interpreter state, it *must* be the main
+  interpreter"). `XXX` comments acknowledge further latent
+  issues within.
+
+Definitive answer to "Open Question 1" of the prototype
+docstring: **no, CPython does not support `os.fork()` from
+a non-main sub-interpreter**. Not because the fork syscall
+is blocked (it isn't — the parent returns a valid pid),
+but because the child cannot survive CPython's post-fork
+initialization. This is an enforced invariant, not an
+incidental limitation.
+
+### Revert: move to stub submod + doc the finding
+
+Per user request:
+
+1. Reverted the working `subint_fork_proc` body to a
+   `NotImplementedError` stub, MOVED to its own submod
+   `tractor/spawn/_subint_fork.py` (keeps `_subint.py`
+   focused on the working `subint_proc` backend).
+2. Updated `_spawn.py` to import the stub from the new
+   submod path; kept `'subint_fork'` in `SpawnMethodKey` +
+   `_methods` so `--spawn-backend=subint_fork` routes to a
+   clean `NotImplementedError` with pointer to the analysis
+   doc rather than an "invalid backend" error.
+3. Wrote
+   `ai/conc-anal/subint_fork_blocked_by_cpython_post_fork_issue.md`
+   with the full annotated CPython walkthrough + an
+   upstream-report draft for the CPython issue tracker.
+   Draft has a two-tier ask: ideally "make it work"
+   (pre-fork tstate-swap hook or `DeleteExceptFor(interp)`
+   variant), minimally "give us a clean `RuntimeError` in
+   the parent instead of a `Fatal Python error` aborting
+   the child silently".
+
+### Design discussion — main-interp-thread forkserver workaround
+
+User proposed: set up a "subint forking server" that fork()s
+on behalf of subint callers. Core insight: the CPython gate
+is on `tstate->interp`, not thread identity, so **any thread
+whose tstate is main-interp** can fork cleanly. A worker
+thread attached to main-interp (never entering a subint)
+satisfies the precondition.
+
+Structurally this is `mp.forkserver` (which tractor already
+has as `mp_forkserver`) but **in-process**: instead of a
+separate Python subproc as the fork server, we'd put the
+forkserver on a thread in the tractor parent process. Pros:
+faster spawn (no IPC marshalling to external server + no
+separate Python startup), inherits already-imported modules
+for free. Cons: less crash isolation (forkserver failure
+takes the whole process).
+
+Required tractor-side refactor: move the root actor's
+`trio.run()` off main-interp-main-thread (so main-thread can
+run the forkserver loop). Nontrivial; approximately the same
+magnitude as "Phase C".
+
+The design would also not fully resolve the class-A
+GIL-starvation issue because child actors' trio still runs
+inside subints (legacy config, msgspec PEP 684 pending).
+Would mitigate SIGINT-starvation specifically if signal
+handling moves to the forkserver thread.
+
+Recommended pre-commitment: a standalone CPython-only smoke
+test validating the four assumptions the arch rests on,
+before any tractor-side work.
+
+### Smoke-test script drafted
+
+Wrote `ai/conc-anal/subint_fork_from_main_thread_smoketest.py`:
+argparse-driven, four scenarios (`control_subint_thread_fork`
+reproducing the known-broken case, `main_thread_fork`
+baseline, `worker_thread_fork` the architectural assertion,
+`full_architecture` end-to-end with trio in a subint in the
+forked child). No `tractor` imports; pure CPython + `_interpreters`
++ `trio`. Bails cleanly on py<3.14. Pass/fail banners per
+scenario.
+
+User will validate on their py3.14 env next.
+
+## Per-code-artifact provenance
+
+### `tractor/spawn/_subint_fork.py` (new submod)
+
+> `git show 797f57c -- tractor/spawn/_subint_fork.py`
+
+NotImplementedError stub for the subint-fork backend. Module
+docstring + fn docstring explain the attempt, the CPython
+block, and why the stub is kept in-tree. No runtime behavior
+beyond raising with a pointer at the conc-anal doc.
+
+### `tractor/spawn/_spawn.py` (modified)
+
+> `git log 26fb820..HEAD -- tractor/spawn/_spawn.py`
+
+- Added `'subint_fork'` to `SpawnMethodKey` literal with a
+  block comment explaining the CPython-level block.
+- Generalized the `case 'subint':` arm to `case 'subint' |
+  'subint_fork':` since both use the same py3.14+ gate.
+- Registered `subint_fork_proc` in `_methods` with a
+  pointer-comment at the analysis doc.
+
+### `tractor/spawn/_subint.py` (modified across session)
+
+> `git log 26fb820..HEAD -- tractor/spawn/_subint.py`
+
+- Tightened `_has_subints` gate: dual-requires public
+  `concurrent.interpreters` + private `_interpreters`
+  (tests for py3.14-or-newer on the public-API presence,
+  then uses the private one for legacy-config subints
+  because `msgspec` still blocks the public isolated mode
+  per jcrist/msgspec#563).
+- Updated module docstring, `subint_proc()` docstring, and
+  gate-error messages to reflect the 3.14+ requirement and
+  the reason (py3.13 wedges under multi-trio usage even
+  though the private module exists there).
+
+### `tractor/_testing/pytest.py` (modified)
+
+> `git log 26fb820..HEAD -- tractor/_testing/pytest.py`
+
+- New `skipon_spawn_backend(*start_methods, reason=...)`
+  pytest marker expanded into `pytest.mark.skip(reason=...)`
+  at collection time via
+  `pytest_collection_modifyitems()`.
+- Implementation uses `item.iter_markers(name=...)` which
+  walks function + class + module scopes uniformly and
+  handles both `pytestmark = <single Mark>` and
+  `pytestmark = [mark, ...]` forms natively. ~30-LOC
+  single-loop refactor replacing a prior nested
+  conditional that had four bugs (see "Review" narrative
+  above).
+- Added `pytest.Config` / `pytest.Function` /
+  `pytest.FixtureRequest` type annotations on fixture
+  signatures while touching the file.
+
+### `pyproject.toml` (modified)
+
+> `git log 26fb820..HEAD -- pyproject.toml`
+
+Added `pytest-timeout>=2.3` to `testing` dep group with
+comment pointing at the `ai/conc-anal/` docs.
+
+### `tests/discovery/test_registrar.py`,
+`tests/test_subint_cancellation.py`,
+`tests/test_cancellation.py` (modified)
+
+> `git log 26fb820..HEAD -- tests/`
+
+Applied `@pytest.mark.timeout(30, method='thread')` on
+known-hanging subint tests. Extended comments to cross-
+reference the `ai/conc-anal/*.md` docs. `method='thread'`
+is documented inline as load-bearing (`signal`-method
+SIGALRM suffers the same GIL-starvation path that drops
+SIGINT).
+
+### `ai/conc-anal/subint_fork_blocked_by_cpython_post_fork_issue.md` (new)
+
+> `git show 797f57c -- ai/conc-anal/subint_fork_blocked_by_cpython_post_fork_issue.md`
+
+Third sibling doc under `conc-anal/`. Structure: TL;DR,
+context ("what we tried"), symptom (the user's exact
+`Fatal Python error` output), CPython source walkthrough
+with excerpted snippets from `posixmodule.c` +
+`pystate.c`, chain summary, definitive answer to Open
+Question 1, `## Upstream-report draft (for CPython issue
+tracker)` section with a two-tier ask, references.
+
+### `ai/conc-anal/subint_fork_from_main_thread_smoketest.py` (new, THIS turn)
+
+Zero-tractor-import smoke test for the proposed workaround
+architecture. Four argparse-driven scenarios covering the
+control case + baseline + arch-critical case + end-to-end.
+Pass/fail banners per scenario; clean `--help` output;
+py3.13 early-exit.
+
+## Non-code output (verbatim)
+
+### The `strace` signature that kicked off the CPython
+walkthrough
+
+```
+--- SIGINT {si_signo=SIGINT, si_code=SI_KERNEL} ---
+write(16, "\2", 1)                      = -1 EAGAIN (Resource temporarily unavailable)
+rt_sigreturn({mask=[WINCH]})            = 139801964688928
+```
+
+### Key user quotes framing the direction
+
+> ok actually we get this [fatal error] ... see if you can
+> take a look at what's going on, in particular wrt to
+> cpython's sources. pretty sure there's a local copy at
+> ~/repos/cpython/
+
+(Drove the CPython walkthrough that produced the
+definitive refusal chain.)
+
+> is there any reason we can't just sidestep this "must fork
+> from main thread in main subint" issue by simply ensuring
+> a "subint forking server" is always setup prior to
+> invoking trio in a non-main-thread subint ...
+
+(Drove the main-interp-thread-forkserver architectural
+discussion + smoke-test script design.)
+
+### CPython source tags for quick jump-back
+
+```
+Modules/posixmodule.c:728   PyOS_AfterFork_Child()
+Modules/posixmodule.c:753   // Ideally we could guarantee tstate is running main.
+Modules/posixmodule.c:778   status = _PyInterpreterState_DeleteExceptMain(runtime);
+
+Python/pystate.c:1040       _PyInterpreterState_DeleteExceptMain()
+Python/pystate.c:1044-1047  tstate->interp != main → PyStatus_ERR("not main interpreter")
+```

ai/prompt-io/claude/20260611T175152Z_8526985c_prompt_io.md

@@ -0,0 +1,93 @@
+---
+model: claude-fable-5[1m]
+service: claude
+session: 0780a862-e19a-4f0a-86cd-c8afc0997757
+timestamp: 2026-06-11T17:51:52Z
+git_ref: 8526985c
+scope: docs+code+config
+substantive: true
+raw_file: 20260611T175152Z_8526985c_prompt_io.raw.md
+---
+
+## Prompt
+
+> we need big boi docs; ours are way out of date and generally
+> terrible. i'd like to use a sphinx theme in the vein and/or
+> one-of/nearly-the-same-as used in one or all of the `msgspec`,
+> `numpy`, `ray`, `xonsh`, `polars` projects.
+>
+> see the following oustanding but now very old issues to guide
+> you: #175, #126, #123, #157
+>
+> we should try to target a 3 columned sphinx theme with,
+> - document index-nav on left,
+> - body content in middle,
+> - diagrams (ideally in d2lang if possible) on RHS
+>
+> optimize for (if possible),
+> - reusing examples code without duplication in docs,
+> - generating new examples from todos throughout code base,
+> - distilling the essence of SC across processes in the simplest
+>   and most friendly way possible.
+>
+> do this work in a /open-wkt and do you best without my guidance
+> for the first major pass - we will refine asap once you are
+> complete.
+
+Session settings: `/effort max` + ultracode (multi-agent workflow
+orchestration). Fully autonomous first pass; two orchestrated
+agent fleets were used (6-agent recon survey, then 10-agent
+content fan-out: 9 section writers + 1 examples smith), with the
+orchestrator authoring the landing page, SC essay, sphinx
+scaffold, d2 pipeline + diagram sources, CI workflow and all
+integration/fix passes directly.
+
+## Response summary
+
+Complete sphinx docs revamp on branch `wkt/big_boi_docs`:
+`pydata-sphinx-theme` 0.18 (3-column: left nav / content /
+page-toc, with d2 diagrams + asides floated into the RHS margin
+via custom CSS), sphinx 9.1, a local `.. d2::` directive
+rendering `docs/diagrams/*.d2` sources with committed-SVG
+fallback, a vendored `.. margin::` directive, ~25 new doc pages
+(landing, start/, explain/, 12 guides, 10 api-ref pages,
+project/), 5 new auto-tested examples + 3 modernized + 1
+renamed, and a gh-pages deploy workflow (issue #123). All
+example code is `literalinclude`d from `examples/` (zero
+duplication, CI-verified). Build: green, 24 warnings all
+pre-existing-docstring/NEWS sourced.
+
+## Files changed
+
+See the branch diff (uncommitted at entry-write time):
+
+> `git diff test_cpu_throttling..wkt/big_boi_docs`
+> `git -C <wkt> status --short` (pre-commit working tree)
+
+- `docs/conf.py` — full rewrite for pydata theme + ext stack
+- `docs/_ext/d2diagrams.py` — new `.. d2::` sphinx directive
+- `docs/_ext/marginalia.py` — new `.. margin::` directive
+- `docs/_static/css/custom.css` — b&w skin + RHS margin floats
+- `docs/diagrams/*.d2` (7) — diagram sources (sketch/grayscale)
+- `docs/_diagrams/*.svg` (7) — committed rendered fallbacks
+- `docs/index.rst` — new landing (replaces dead-API doc)
+- `docs/start/*.rst` (3), `docs/explain/*.rst` (3),
+  `docs/guide/*.rst` (13), `docs/api/*.rst` (10),
+  `docs/project/*.rst` (3) — new content tree
+- `docs/dev_tips.rst` — removed (ported to project/dev-tips)
+- `examples/{typed_payloads,nested_actor_tree,
+  service_daemon_discovery,uds_transport_actor_tree,
+  streaming_broadcast_fanout}.py` — new, smoke-tested
+- `examples/{a_trynamic_first_scene,
+  actor_spawning_and_causality,parallelism/single_func}.py` —
+  `.result()` -> `.wait_for_result()` modernization
+- `examples/parallelism/concurrent_futures_primes.py` — renamed
+  from leading-underscore + trio-runner shim added
+- `pyproject.toml` — `docs` dependency-group filled in
+- `uv.lock` — relock for docs group
+- `.github/workflows/docs.yml` — build + gh-pages deploy
+
+## Human edits
+
+None yet — entry written pre-commit; the author reviews, stages
+and commits manually (per repo workflow policy).

ai/prompt-io/claude/20260611T175152Z_8526985c_prompt_io.raw.md

@@ -0,0 +1,49 @@
+---
+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).

ai/prompt-io/claude/20260625T232506Z_0a3c48fc_prompt_io.md

@@ -0,0 +1,65 @@
+---
+model: claude-fable-5[1m]
+service: claude
+session: 638d5a98-abd2-4217-a447-19f2330eb334
+timestamp: 2026-06-25T23:25:06Z
+git_ref: 0a3c48fc
+scope: code
+substantive: true
+raw_file: 20260625T232506Z_0a3c48fc_prompt_io.raw.md
+---
+
+## Prompt
+
+Same `/code-review` follow-up session (PR #460). Finding #10:
+the new `api/` autodoc reference pages surfaced 22 docutils
+warnings sourced from informal reST in public docstrings. The
+user opted to fix it on this branch,
+
+> well we're on a clean main so why not just do these now too?
+
+Goal: drive the docs build warning-free (24 -> 0) without any
+code/behaviour change — docstring content only.
+
+## Response summary
+
+Surgical docstring-RST lint across 9 library modules + the one
+offending `NEWS.rst` changelog entry,
+
+- bullet lists given a blank line + base-column indent
+  (`Context`, `Context.cancel_called`/`.cancelled_caught`/
+  `.outcome`, `ActorNursery.cancel_called`, `query_actor`,
+  `open_crash_handler`, the `#318` `NEWS.rst` entry),
+- the under-short `Behaviour:` underline in `Context.cancel`
+  demoted to a `**bold**` label,
+- unbalanced/pluralized-role backticks fixed — closed the
+  `wait_for_actor` summary backtick; applied the `` `role`\ s ``
+  escaped-plural idiom in `gather_contexts`, `mk_pdb`,
+  `MsgCodec`, msg `Error`, `open_context_from_portal`,
+- the `|_` method-tree in `ContextCancelled.canceller` made a
+  literal block (bare `|` was parsed as a substitution ref).
+
+Verified: build `24 -> 0` warnings; `import tractor` clean under
+`-W error::SyntaxWarning`; the `\ s` idiom renders as e.g.
+"acms" (no backslash/space leak in HTML); `ruff` clean; diff
+confirmed docstring-content-only.
+
+Initial generation was delegated to a constrained subagent
+(docstring-only edits + a rebuild-to-zero verification gate);
+the orchestrator independently re-built, reviewed the full
+diff, and added the `NEWS.rst` fix to reach zero.
+
+## Files changed
+
+- `tractor/_context.py`, `tractor/_exceptions.py`,
+  `tractor/devx/debug/_post_mortem.py`,
+  `tractor/devx/debug/_repl.py`, `tractor/discovery/_api.py`,
+  `tractor/msg/_codec.py`, `tractor/msg/types.py`,
+  `tractor/runtime/_supervise.py`,
+  `tractor/trionics/_mngrs.py` — docstring reST fixes,
+- `NEWS.rst` — blank line before a bullet list in the `#318`
+  entry.
+
+## Human edits
+
+None — committed as generated (`0a3c48fc`).

ai/prompt-io/claude/20260625T232506Z_0a3c48fc_prompt_io.raw.md

@@ -0,0 +1,35 @@
+---
+model: claude-fable-5[1m]
+service: claude
+timestamp: 2026-06-25T23:25:06Z
+git_ref: 0a3c48fc
+diff_cmd: git diff 0a3c48fc~1..0a3c48fc
+---
+
+# Raw output pointers (diff-ref mode)
+
+The generated patch is committed; the verbatim content is the
+diff:
+
+> `git diff 0a3c48fc~1..0a3c48fc`
+
+## Generation notes (non-code, verbatim)
+
+- Pure docstring-content edits; no signatures, logic, or
+  non-docstring lines touched (confirmed via `git diff` review).
+- reST fix patterns applied: blank-line + base-column indent
+  for bullet lists ("Unexpected indentation" / "Definition
+  list ..." / "Block quote ..."); `**bold**` in place of an
+  under-length section underline ("Title underline too short");
+  closing/escaping backticks ("Inline interpreted text ...
+  without end-string"); literal-block for an ASCII tree whose
+  `|` chars tripped "Inline substitution_reference ...".
+- The pluralized-role idiom is written `\\ s` in the Python
+  source (so the runtime docstring holds `` `role`\ s ``); a
+  bare `\ ` would raise a 3.13 invalid-escape SyntaxWarning.
+  Verified clean via `python -W error::SyntaxWarning -c
+  "import tractor"`.
+- Verification gate: `sphinx-build` warning count 24 -> 2
+  (subagent, docstrings only) -> 0 after the orchestrator added
+  the `NEWS.rst` blank-line fix; rendered-HTML spot-check
+  confirmed no literal `\ s` leak; `ruff check` clean.

ai/prompt-io/claude/20260625T232506Z_3a5cfde0_prompt_io.md

@@ -0,0 +1,64 @@
+---
+model: claude-fable-5[1m]
+service: claude
+session: 638d5a98-abd2-4217-a447-19f2330eb334
+timestamp: 2026-06-25T23:25:06Z
+git_ref: 3a5cfde0
+scope: code
+substantive: true
+raw_file: 20260625T232506Z_3a5cfde0_prompt_io.raw.md
+---
+
+## Prompt
+
+Follow-up to a `/code-review` of PR #460 (this branch) which
+surfaced lower-severity findings in the `.. d2::` sphinx
+directive. The user's driving instructions across the session,
+
+> yup do both *at least*, then report back.
+
+(re: "implement #7 (+ optionally #8) on the branch") and,
+
+> well we're on a clean main so why not just do these now too?
+
+(re: also doing #9). The three findings being addressed,
+
+- #7: a `d2` render that is *attempted and fails* (binary
+  present but errors on the source) silently degraded to the
+  stale committed SVG and the build still exited 0,
+- #8: `parallel_*_safe = True` was declared while `run()`
+  writes the shared output SVG during the read phase (torn
+  write under `sphinx-build -j`),
+- #9: output keyed only by `src.stem` so two `.d2` sources
+  with the same stem collide.
+
+## Response summary
+
+Reworked `docs/_ext/d2diagrams.py`,
+
+- `render_svg()` now returns a `RenderResult` tristate
+  (`OK` / `FELL_BACK` / `NO_OUTPUT` / `FAILED`) so `run()` can
+  distinguish a graceful no-binary fallback from a real render
+  failure; `FAILED` emits a `reporter.error` (build fails under
+  `-W`),
+- the render writes into a sibling temp-file then `os.replace()`
+  (atomic) so a failed/torn render can never clobber a good
+  committed SVG,
+- a per-build `_seen_outputs` map (reset on `builder-inited`)
+  errors on a same-stem output collision.
+
+Verified: a corrupted `.d2` errors under `-W` (exit 1) with the
+committed SVG byte-unchanged; the collision guard fires on a
+duplicate stem; `nix run nixpkgs#d2` render path + atomic swap
+leave no temp residue; `ruff` clean.
+
+## Response summary (cont.) — Files changed
+
+- `docs/_ext/d2diagrams.py` — tristate render result, atomic
+  temp-file render, output-collision guard, doc-string policy
+  update.
+
+## Human edits
+
+None — committed as generated (`3a5cfde0`). The user noted
+follow-up refinements may come in later commits.

ai/prompt-io/claude/20260625T232506Z_3a5cfde0_prompt_io.raw.md

@@ -0,0 +1,35 @@
+---
+model: claude-fable-5[1m]
+service: claude
+timestamp: 2026-06-25T23:25:06Z
+git_ref: 3a5cfde0
+diff_cmd: git diff 3a5cfde0~1..3a5cfde0
+---
+
+# Raw output pointers (diff-ref mode)
+
+The generated patch is committed; per the diff-ref decision
+rule the verbatim content is the diff itself:
+
+> `git diff 3a5cfde0~1..3a5cfde0 -- docs/_ext/d2diagrams.py`
+
+## Generation notes (non-code, verbatim)
+
+- `RenderResult` enum added; `render_svg()` return type changed
+  `bool -> RenderResult`. Mapping in `run()`: `FAILED` ->
+  `state_machine.reporter.error(...)`, `NO_OUTPUT` -> raw `.d2`
+  source as a `literal_block`, `OK`/`FELL_BACK` -> `image`.
+- Atomicity via `tempfile.mkstemp(dir=out.parent, ...)` +
+  `os.replace(tmp, out)`; temp unlinked on any failure path.
+- Collision guard: module-level `_seen_outputs: dict[str,str]`
+  keyed by output basename, cleared by a `builder-inited`
+  handler connected in `setup()`.
+- `parallel_read_safe`/`parallel_write_safe` kept `True` but
+  now justified by the atomic swap (documented inline).
+- Empirical verification performed before commit:
+  - broken `.d2` + `sphinx-build -W` -> exit 1, ERROR node
+    rendered, committed `actor_tree.svg` md5 unchanged,
+  - duplicate-stem orphan page -> "d2 output collision" error,
+  - `nix run nixpkgs#d2` forced re-render -> deterministic
+    (no git drift), no `.tmp` residue,
+  - `ruff check` clean.

docs/README.rst

@@ -1,4 +1,4 @@
-|logo| ``tractor``: distributed structurred concurrency
+|logo| ``tractor``: distributed structured concurrency
 
 ``tractor`` is a `structured concurrency`_ (SC), multi-processing_ runtime built on trio_.
 
@@ -23,16 +23,11 @@ model" looks like, and that's **intentional**.
 
 Where do i start!?
 ------------------
-The first step to grok ``tractor`` is to get an intermediate
+New to ``trio`` and **structured concurrency**? Our docs collect the
-knowledge of ``trio`` and **structured concurrency** B)
+best starting points and then walk you straight into a hands-on
-
+quickstart:
-Some great places to start are,
-
-- the seminal `blog post`_
-- obviously the `trio docs`_
-- wikipedia's nascent SC_ page
-- the fancy diagrams @ libdill-docs_
 
+  https://goodboy.github.io/tractor/start/quickstart.html
 
 Features
 --------
@@ -57,6 +52,7 @@ Features
   `discovery`_ sys with plans to support multiple `modern protocol`_
   approaches.
 - Various ``trio`` extension APIs via ``tractor.trionics`` such as,
+
   - task fan-out `broadcasting`_,
   - multi-task-single-resource-caching and fan-out-to-multi
     ``__aenter__()`` APIs for ``@acm`` functions,
@@ -98,7 +94,7 @@ the code base::
 
     # but @goodboy prefers the more explicit (and shell agnostic)
     # https://docs.astral.sh/uv/configuration/environment/#uv_project_environment
-    UV_PROJECT_ENVIRONMENT="tractor_py313
+    UV_PROJECT_ENVIRONMENT="tractor_py313"
 
     # hint hint, enter @goodboy's fave shell B)
     uv run --dev xonsh
@@ -110,546 +106,53 @@ Alongside all this we ofc offer "releases" on PyPi::
 Just note that YMMV since the main git branch is often much further
 ahead then any latest release.
 
+Hacking on the docs themselves? The build + live-preview one-liners
+(incl. nix-shell specifics) are collected in `notes_to_self/howtodocs.md
+<https://github.com/goodboy/tractor/blob/main/notes_to_self/howtodocs.md>`_,
+and rendered as the "Building these docs" section of our dev-tips guide.
+
 
 Example codez
 -------------
-In ``tractor``'s (very lacking) documention we prefer to point to
+We prefer to point you at the runnable scripts under ``examples/``
-example scripts in the repo over duplicating them in docs, but with
+- each is CI-run and ``literalinclude``-d straight into the docs, so
-that in mind here are some definitive snippets to try and hook you
+what you read there is what actually runs - rather than inline a
-into digging deeper.
+pile of them here. The one-minute pitch: spawn a subactor per core,
-
+open a ``Context`` into each, then crash the root *on purpose* and
-
+watch the runtime reap the whole tree - zero zombies, guaranteed (if
-Run a func in a process
+you can make a zombie child without a system signal, it **is a
-***********************
+bug**).
-Use ``trio``'s style of focussing on *tasks as functions*:
+
-
+See it run - plus the full tour (the flagship multi-process
-.. code:: python
+debugger, bidirectional streaming over a ``Context``, cancellation,
-
+discovery, "infected ``asyncio``", typed messaging and worker-pool /
-    """
+cluster patterns) - in the docs:
-    Run with a process monitor from a terminal using::
+
-
+- docs: https://goodboy.github.io/tractor/
-        $TERM -e watch -n 0.1  "pstree -a $$" \
+- examples: https://github.com/goodboy/tractor/tree/main/examples
-            & python examples/parallelism/single_func.py \
-            && kill $!
-
-    """
-    import os
-
-    import tractor
-    import trio
-
-
-    async def burn_cpu():
-
-        pid = os.getpid()
-
-        # burn a core @ ~ 50kHz
-        for _ in range(50000):
-            await trio.sleep(1/50000/50)
-
-        return os.getpid()
-
-
-    async def main():
-
-        async with tractor.open_nursery() as n:
-
-            portal = await n.run_in_actor(burn_cpu)
-
-            #  burn rubber in the parent too
-            await burn_cpu()
-
-            # wait on result from target function
-            pid = await portal.result()
-
-        # end of nursery block
-        print(f"Collected subproc {pid}")
-
-
-    if __name__ == '__main__':
-        trio.run(main)
-
-
-This runs ``burn_cpu()`` in a new process and reaps it on completion
-of the nursery block.
-
-If you only need to run a sync function and retreive a single result, you
-might want to check out `trio-parallel`_.
-
-
-Zombie safe: self-destruct a process tree
-*****************************************
-``tractor`` tries to protect you from zombies, no matter what.
-
-.. code:: python
-
-    """
-    Run with a process monitor from a terminal using::
-
-        $TERM -e watch -n 0.1  "pstree -a $$" \
-            & python examples/parallelism/we_are_processes.py \
-            && kill $!
-
-    """
-    from multiprocessing import cpu_count
-    import os
-
-    import tractor
-    import trio
-
-
-    async def target():
-        print(
-            f"Yo, i'm '{tractor.current_actor().name}' "
-            f"running in pid {os.getpid()}"
-        )
-
-        await trio.sleep_forever()
-
-
-    async def main():
-
-        async with tractor.open_nursery() as n:
-
-            for i in range(cpu_count()):
-                await n.run_in_actor(target, name=f'worker_{i}')
-
-            print('This process tree will self-destruct in 1 sec...')
-            await trio.sleep(1)
-
-            # raise an error in root actor/process and trigger
-            # reaping of all minions
-            raise Exception('Self Destructed')
-
-
-    if __name__ == '__main__':
-        try:
-            trio.run(main)
-        except Exception:
-            print('Zombies Contained')
-
-
-If you can create zombie child processes (without using a system signal)
-it **is a bug**.
-
-
-"Native" multi-process debugging
-********************************
-Using the magic of `pdbp`_ and our internal IPC, we've
-been able to create a native feeling debugging experience for
-any (sub-)process in your ``tractor`` tree.
-
-.. code:: python
-
-    from os import getpid
-
-    import tractor
-    import trio
-
-
-    async def breakpoint_forever():
-        "Indefinitely re-enter debugger in child actor."
-        while True:
-            yield 'yo'
-            await tractor.breakpoint()
-
-
-    async def name_error():
-        "Raise a ``NameError``"
-        getattr(doggypants)
-
-
-    async def main():
-        """Test breakpoint in a streaming actor.
-        """
-        async with tractor.open_nursery(
-            debug_mode=True,
-            loglevel='error',
-        ) as n:
-
-            p0 = await n.start_actor('bp_forever', enable_modules=[__name__])
-            p1 = await n.start_actor('name_error', enable_modules=[__name__])
-
-            # retreive results
-            stream = await p0.run(breakpoint_forever)
-            await p1.run(name_error)
-
-
-    if __name__ == '__main__':
-        trio.run(main)
-
-
-You can run this with::
-
-    >>> python examples/debugging/multi_daemon_subactors.py
-
-And, yes, there's a built-in crash handling mode B)
-
-We're hoping to add a respawn-from-repl system soon!
-
-
-SC compatible bi-directional streaming
-**************************************
-Yes, you saw it here first; we provide 2-way streams
-with reliable, transitive setup/teardown semantics.
-
-Our nascent api is remniscent of ``trio.Nursery.start()``
-style invocation:
-
-.. code:: python
-
-    import trio
-    import tractor
-
-
-    @tractor.context
-    async def simple_rpc(
-
-        ctx: tractor.Context,
-        data: int,
-
-    ) -> None:
-        '''Test a small ping-pong 2-way streaming server.
-
-        '''
-        # signal to parent that we're up much like
-        # ``trio_typing.TaskStatus.started()``
-        await ctx.started(data + 1)
-
-        async with ctx.open_stream() as stream:
-
-            count = 0
-            async for msg in stream:
-
-                assert msg == 'ping'
-                await stream.send('pong')
-                count += 1
-
-            else:
-                assert count == 10
-
-
-    async def main() -> None:
-
-        async with tractor.open_nursery() as n:
-
-            portal = await n.start_actor(
-                'rpc_server',
-                enable_modules=[__name__],
-            )
-
-            # XXX: this syntax requires py3.9
-            async with (
-
-                portal.open_context(
-                    simple_rpc,
-                    data=10,
-                ) as (ctx, sent),
-
-                ctx.open_stream() as stream,
-            ):
-
-                assert sent == 11
-
-                count = 0
-                # receive msgs using async for style
-                await stream.send('ping')
-
-                async for msg in stream:
-                    assert msg == 'pong'
-                    await stream.send('ping')
-                    count += 1
-
-                    if count >= 9:
-                        break
-
-
-            # explicitly teardown the daemon-actor
-            await portal.cancel_actor()
-
-
-    if __name__ == '__main__':
-        trio.run(main)
-
-
-See original proposal and discussion in `#53`_ as well
-as follow up improvements in `#223`_ that we'd love to
-hear your thoughts on!
-
-.. _#53: https://github.com/goodboy/tractor/issues/53
-.. _#223: https://github.com/goodboy/tractor/issues/223
-
-
-Worker poolz are easy peasy
-***************************
-The initial ask from most new users is *"how do I make a worker
-pool thing?"*.
-
-``tractor`` is built to handle any SC (structured concurrent) process
-tree you can imagine; a "worker pool" pattern is a trivial special
-case.
-
-We have a `full worker pool re-implementation`_ of the std-lib's
-``concurrent.futures.ProcessPoolExecutor`` example for reference.
-
-You can run it like so (from this dir) to see the process tree in
-real time::
-
-    $TERM -e watch -n 0.1  "pstree -a $$" \
-        & python examples/parallelism/concurrent_actors_primes.py \
-        && kill $!
-
-This uses no extra threads, fancy semaphores or futures; all we need
-is ``tractor``'s IPC!
-
-"Infected ``asyncio``" mode
-***************************
-Have a bunch of ``asyncio`` code you want to force to be SC at the process level?
-
-Check out our experimental system for `guest`_-mode controlled
-``asyncio`` actors:
-
-.. code:: python
-
-    import asyncio
-    from statistics import mean
-    import time
-
-    import trio
-    import tractor
-
-
-    async def aio_echo_server(
-        chan: tractor.to_asyncio.LinkedTaskChannel,
-    ) -> None:
-
-        # a first message must be sent **from** this ``asyncio``
-        # task or the ``trio`` side will never unblock from
-        # ``tractor.to_asyncio.open_channel_from():``
-        chan.started_nowait('start')
-
-        while True:
-            # echo the msg back
-            chan.send_nowait(await chan.get())
-            await asyncio.sleep(0)
-
-
-    @tractor.context
-    async def trio_to_aio_echo_server(
-        ctx: tractor.Context,
-    ):
-        # this will block until the ``asyncio`` task sends a "first"
-        # message.
-        async with tractor.to_asyncio.open_channel_from(
-            aio_echo_server,
-        ) as (chan, first):
-
-            assert first == 'start'
-            await ctx.started(first)
-
-            async with ctx.open_stream() as stream:
-
-                async for msg in stream:
-                    await chan.send(msg)
-
-                    out = await chan.receive()
-                    # echo back to parent actor-task
-                    await stream.send(out)
-
-
-    async def main():
-
-        async with tractor.open_nursery() as n:
-            p = await n.start_actor(
-                'aio_server',
-                enable_modules=[__name__],
-                infect_asyncio=True,
-            )
-            async with p.open_context(
-                trio_to_aio_echo_server,
-            ) as (ctx, first):
-
-                assert first == 'start'
-
-                count = 0
-                async with ctx.open_stream() as stream:
-
-                    delays = []
-                    send = time.time()
-
-                    await stream.send(count)
-                    async for msg in stream:
-                        recv = time.time()
-                        delays.append(recv - send)
-                        assert msg == count
-                        count += 1
-                        send = time.time()
-                        await stream.send(count)
-
-                        if count >= 1e3:
-                            break
-
-            print(f'mean round trip rate (Hz): {1/mean(delays)}')
-            await p.cancel_actor()
-
-
-    if __name__ == '__main__':
-        trio.run(main)
-
-
-Yes, we spawn a python process, run ``asyncio``, start ``trio`` on the
-``asyncio`` loop, then send commands to the ``trio`` scheduled tasks to
-tell ``asyncio`` tasks what to do XD
-
-The ``asyncio``-side task receives a single
-``chan: LinkedTaskChannel`` handle providing a ``trio``-like
-API: ``.started_nowait()``, ``.send_nowait()``, ``.get()``
-and more. Feel free to sling your opinion in `#273`_!
-
-
-.. _#273: https://github.com/goodboy/tractor/issues/273
-
-
-Higher level "cluster" APIs
-***************************
-To be extra terse the ``tractor`` devs have started hacking some "higher
-level" APIs for managing actor trees/clusters. These interfaces should
-generally be condsidered provisional for now but we encourage you to try
-them and provide feedback. Here's a new API that let's you quickly
-spawn a flat cluster:
-
-.. code:: python
-
-    import trio
-    import tractor
-
-
-    async def sleepy_jane():
-        uid = tractor.current_actor().uid
-        print(f'Yo i am actor {uid}')
-        await trio.sleep_forever()
-
-
-    async def main():
-        '''
-        Spawn a flat actor cluster, with one process per
-        detected core.
-
-        '''
-        portal_map: dict[str, tractor.Portal]
-        results: dict[str, str]
-
-        # look at this hip new syntax!
-        async with (
-
-            tractor.open_actor_cluster(
-                modules=[__name__]
-            ) as portal_map,
-
-            trio.open_nursery() as n,
-        ):
-
-            for (name, portal) in portal_map.items():
-                n.start_soon(portal.run, sleepy_jane)
-
-            await trio.sleep(0.5)
-
-            # kill the cluster with a cancel
-            raise KeyboardInterrupt
-
-
-    if __name__ == '__main__':
-        try:
-            trio.run(main)
-        except KeyboardInterrupt:
-            pass
-
-
-.. _full worker pool re-implementation: https://github.com/goodboy/tractor/blob/master/examples/parallelism/concurrent_actors_primes.py
-
 
 Under the hood
 --------------
-``tractor`` is an attempt to pair trionic_ `structured concurrency`_ with
+``tractor`` is an attempt to pair trionic_ `structured
-distributed Python. You can think of it as a ``trio``
+concurrency`_ with distributed Python - think of it as ``trio``
-*-across-processes* or simply as an opinionated replacement for the
+*-across-processes*, or as an opinionated replacement for the
-stdlib's ``multiprocessing`` but built on async programming primitives
+stdlib's ``multiprocessing`` built on async primitives from the
-from the ground up.
+ground up. But really it **is just** ``trio``: nurseries that
+spawn *processes* and cancel-able streaming IPC between them. If
+you can drive ``trio``, you can drive ``tractor``.
 
-Don't be scared off by this description. ``tractor`` **is just** ``trio``
+"But wait - don't 'actors' have mailboxes and messages and
-but with nurseries for process management and cancel-able streaming IPC.
+stuff?!" Well, we've got (well referenced) opinions on what an "actor
-If you understand how to work with ``trio``, ``tractor`` will give you
+model" **actually is** (tl;dr: the `3 axioms`_, not the cultural
-the parallelism you may have been needing.
+baggage) - that whole riff lives in our docs:
 
+  https://goodboy.github.io/tractor/explain/sc-distributed.html#hold-up-is-this-an-actor-model
 
-Wait, huh?! I thought "actors" have messages, and mailboxes and stuff?!
+What's on the TODO
-***********************************************************************
+------------------
-Let's stop and ask how many canon actor model papers have you actually read ;)
+The roadmap lives with our docs - see `what the future holds
-
+<https://goodboy.github.io/tractor/project/index.html#what-the-future-holds>`_
-From our experience many "actor systems" aren't really "actor models"
+for where ``tractor`` is headed.
-since they **don't adhere** to the `3 axioms`_ and pay even less
-attention to the problem of *unbounded non-determinism* (which was the
-whole point for creation of the model in the first place).
-
-From the author's mouth, **the only thing required** is `adherance to`_
-the `3 axioms`_, *and that's it*.
-
-``tractor`` adheres to said base requirements of an "actor model"::
-
-    In response to a message, an actor may:
-
-    - send a finite number of new messages
-    - create a finite number of new actors
-    - designate a new behavior to process subsequent messages
-
-
-**and** requires *no further api changes* to accomplish this.
-
-If you want do debate this further please feel free to chime in on our
-chat or discuss on one of the following issues *after you've read
-everything in them*:
-
-- https://github.com/goodboy/tractor/issues/210
-- https://github.com/goodboy/tractor/issues/18
-
-
-Let's clarify our parlance
-**************************
-Whether or not ``tractor`` has "actors" underneath should be mostly
-irrelevant to users other then for referring to the interactions of our
-primary runtime primitives: each Python process + ``trio.run()``
-+ surrounding IPC machinery. These are our high level, base
-*runtime-units-of-abstraction* which both *are* (as much as they can
-be in Python) and will be referred to as our *"actors"*.
-
-The main goal of ``tractor`` is is to allow for highly distributed
-software that, through the adherence to *structured concurrency*,
-results in systems which fail in predictable, recoverable and maybe even
-understandable ways; being an "actor model" is just one way to describe
-properties of the system.
-
-
-What's on the TODO:
--------------------
-Help us push toward the future of distributed `Python`.
-
-- Erlang-style supervisors via composed context managers (see `#22
-  <https://github.com/goodboy/tractor/issues/22>`_)
-- Typed messaging protocols (ex. via ``msgspec.Struct``, see `#36
-  <https://github.com/goodboy/tractor/issues/36>`_)
-- Typed capability-based (dialog) protocols ( see `#196
-  <https://github.com/goodboy/tractor/issues/196>`_ with draft work
-  started in `#311 <https://github.com/goodboy/tractor/pull/311>`_)
-- **macOS is now officially supported** and tested in CI
-  alongside Linux!
-- We **recently disabled CI-testing on windows** and need
-  help getting it running again! (see `#327
-  <https://github.com/goodboy/tractor/pull/327>`_). **We do
-  have windows support** (and have for quite a while) but
-  since no active hacker exists in the user-base to help
-  test on that OS, for now we're not actively maintaining
-  testing due to the added hassle and general latency..
-
 
 Feel like saying hi?
 --------------------
@@ -660,36 +163,24 @@ say hi, please feel free to reach us in our `matrix channel`_.  If
 matrix seems too hip, we're also mostly all in the the `trio gitter
 channel`_!
 
-.. _structured concurrent: https://trio.discourse.group/t/concise-definition-of-structured-concurrency/228
 .. _distributed: https://en.wikipedia.org/wiki/Distributed_computing
 .. _multi-processing: https://en.wikipedia.org/wiki/Multiprocessing
 .. _trio: https://github.com/python-trio/trio
 .. _nurseries: https://vorpus.org/blog/notes-on-structured-concurrency-or-go-statement-considered-harmful/#nurseries-a-structured-replacement-for-go-statements
 .. _actor model: https://en.wikipedia.org/wiki/Actor_model
 .. _trionic: https://trio.readthedocs.io/en/latest/design.html#high-level-design-principles
-.. _async sandwich: https://trio.readthedocs.io/en/latest/tutorial.html#async-sandwich
 .. _3 axioms: https://www.youtube.com/watch?v=7erJ1DV_Tlo&t=162s
 .. .. _3 axioms: https://en.wikipedia.org/wiki/Actor_model#Fundamental_concepts
-.. _adherance to: https://www.youtube.com/watch?v=7erJ1DV_Tlo&t=1821s
 .. _trio gitter channel: https://gitter.im/python-trio/general
 .. _matrix channel: https://matrix.to/#/!tractor:matrix.org
 .. _broadcasting: https://github.com/goodboy/tractor/pull/229
-.. _modern procotol: https://en.wikipedia.org/wiki/Rendezvous_protocol
 .. _pdbp: https://github.com/mdmintz/pdbp
 .. _pdb++: https://github.com/pdbpp/pdbpp
 .. _cheap or nasty: https://zguide.zeromq.org/docs/chapter7/#The-Cheap-or-Nasty-Pattern
 .. _(un)protocol: https://zguide.zeromq.org/docs/chapter7/#Unprotocols
 .. _discovery: https://zguide.zeromq.org/docs/chapter8/#Discovery
 .. _modern protocol: https://en.wikipedia.org/wiki/Rendezvous_protocol
-.. _messages: https://en.wikipedia.org/wiki/Message_passing
-.. _trio docs: https://trio.readthedocs.io/en/latest/
-.. _blog post: https://vorpus.org/blog/notes-on-structured-concurrency-or-go-statement-considered-harmful/
 .. _structured concurrency: https://en.wikipedia.org/wiki/Structured_concurrency
-.. _SC: https://en.wikipedia.org/wiki/Structured_concurrency
-.. _libdill-docs: https://sustrik.github.io/libdill/structured-concurrency.html
-.. _unrequirements: https://en.wikipedia.org/wiki/Actor_model#Direct_communication_and_asynchrony
-.. _async generators: https://www.python.org/dev/peps/pep-0525/
-.. _trio-parallel: https://github.com/richardsheridan/trio-parallel
 .. _uv: https://docs.astral.sh/uv/
 .. _msgspec: https://jcristharif.com/msgspec/
 .. _guest: https://trio.readthedocs.io/en/stable/reference-lowlevel.html?highlight=guest%20mode#using-guest-mode-to-run-trio-on-top-of-other-event-loops
@@ -700,10 +191,10 @@ channel`_!
 .. |gh_actions| image:: https://github.com/goodboy/tractor/actions/workflows/ci.yml/badge.svg?branch=main
     :target: https://github.com/goodboy/tractor/actions/workflows/ci.yml
 
-.. |docs| image:: https://readthedocs.org/projects/tractor/badge/?version=latest
+.. |docs| image:: https://github.com/goodboy/tractor/actions/workflows/docs.yml/badge.svg?branch=main
-    :target: https://tractor.readthedocs.io/en/latest/?badge=latest
+    :target: https://goodboy.github.io/tractor/
-    :alt: Documentation Status
+    :alt: Documentation
 
-.. |logo| image:: _static/tractor_logo_side.svg
+.. |logo| image:: _static/tractor_logo_wire.svg
     :width: 250
     :align: middle

docs/_ext/d2diagrams.py

@@ -0,0 +1,387 @@
+# tractor: distributed structured concurrency.
+'''
+``.. d2::`` - embed d2lang_ diagrams in sphinx docs
+with build-time rendering and a committed-SVG
+fallback.
+
+Rendering policy,
+
+- when a ``d2`` binary is found (see discovery order
+  below) any out-of-date SVG is (re)rendered from its
+  ``.d2`` source (normally kept in ``docs/diagrams/``)
+  into ``docs/_diagrams/``,
+- otherwise any pre-rendered (and git committed) SVG
+  already in ``docs/_diagrams/`` is used as-is,
+- when neither is possible the diagram *source* is
+  emitted as a literal block so no content is ever
+  silently dropped.
+
+A render that is *attempted and fails* (a ``d2`` bin is
+present but errors on the source) is NOT silently
+degraded to the stale committed SVG: it raises a
+docutils error (so ``sphinx-build -W`` fails the
+build). The render is also atomic — a failed/torn
+render can never clobber a good committed SVG — so the
+last-good diagram survives a bad edit.
+
+Binary discovery order,
+
+- the ``D2_BIN`` env var; may contain args which are
+  split via `shlex`, eg.
+  ``D2_BIN='nix run nixpkgs#d2 --'``,
+- the ``d2_bin`` sphinx config value,
+- ``shutil.which('d2')``.
+
+Usage,
+
+.. code:: rst
+
+    .. d2:: diagrams/actor_tree.d2
+       :caption: A tree of ``trio``-task-trees.
+       :margin:
+
+.. _d2lang: https://d2lang.com
+
+'''
+from __future__ import annotations
+
+import enum
+import hashlib
+import os
+from pathlib import Path
+import re
+import shlex
+import shutil
+import subprocess as sp
+import tempfile
+
+from docutils import nodes
+from docutils.parsers.rst import directives
+from sphinx.application import Sphinx
+from sphinx.util import logging
+from sphinx.util.docutils import SphinxDirective
+
+log = logging.getLogger(__name__)
+
+# subdir (under the sphinx srcdir) holding rendered,
+# git-committed, fallback SVG outputs.
+_outdir: str = '_diagrams'
+
+# per-build map of {output-svg-name: source-relpath} used
+# to detect 2 distinct `.d2` sources colliding on a single
+# output stem; reset on each `builder-inited` (see `setup`).
+_seen_outputs: dict[str, str] = {}
+
+
+class RenderResult(enum.Enum):
+    '''
+    Outcome of a `render_svg()` call.
+
+    '''
+    OK = 'ok'                # fresh SVG exists on disk
+    FELL_BACK = 'fell_back'  # no bin; serving committed SVG
+    NO_OUTPUT = 'no_output'  # no bin AND no committed SVG
+    FAILED = 'failed'        # bin present, render errored
+
+
+def find_d2(
+    app: Sphinx,
+) -> list[str]|None:
+    '''
+    Resolve the d2 render command as an argv list or
+    `None` when no binary can be found.
+
+    '''
+    if env_bin := os.environ.get('D2_BIN'):
+        return shlex.split(env_bin)
+    if cfg_bin := app.config.d2_bin:
+        return shlex.split(cfg_bin)
+    if path_bin := shutil.which('d2'):
+        return [path_bin]
+    return None
+
+
+def render_svg(
+    app: Sphinx,
+    src: Path,
+    out: Path,
+) -> RenderResult:
+    '''
+    Maybe (re)render `src` -> `out` and report the
+    outcome as a `RenderResult`.
+
+    A render is performed only when `out` is missing or
+    older than `src` AND a `d2` binary is available. The
+    write is atomic (temp-file + `os.replace`) so a
+    failed or torn render never clobbers an existing
+    (committed) SVG.
+
+    '''
+    fresh: bool = (
+        out.exists()
+        and
+        src.stat().st_mtime <= out.stat().st_mtime
+    )
+    if fresh:
+        return RenderResult.OK
+    d2cmd: list[str]|None = find_d2(app)
+    if d2cmd is None:
+        # no binary: fall back to whatever is committed,
+        # else signal the caller to emit the raw source.
+        if out.exists():
+            log.info(
+                f'no d2 binary; using committed svg '
+                f'for {src.name}'
+            )
+            return RenderResult.FELL_BACK
+        return RenderResult.NO_OUTPUT
+    out.parent.mkdir(
+        parents=True,
+        exist_ok=True,
+    )
+    # render into a sibling temp-file first so a bad
+    # `d2` exit (or a crash mid-write) leaves any prior
+    # committed SVG fully intact.
+    fd, tmpname = tempfile.mkstemp(
+        dir=str(out.parent),
+        prefix=f'.{out.stem}.',
+        suffix='.svg.tmp',
+    )
+    os.close(fd)
+    tmp = Path(tmpname)
+    argv: list[str] = (
+        d2cmd
+        + list(app.config.d2_args)
+        + [str(src), str(tmp)]
+    )
+    try:
+        proc = sp.run(
+            argv,
+            capture_output=True,
+            text=True,
+            timeout=120,
+        )
+    except (
+        OSError,
+        sp.TimeoutExpired,
+    ) as err:
+        tmp.unlink(missing_ok=True)
+        log.warning(
+            f'd2 invocation failed for {src.name}: '
+            f'{err}'
+        )
+        return RenderResult.FAILED
+    if proc.returncode != 0:
+        tmp.unlink(missing_ok=True)
+        log.warning(
+            f'd2 render error for {src.name}:\n'
+            f'{proc.stderr}'
+        )
+        return RenderResult.FAILED
+    # atomic swap-in of the freshly rendered SVG.
+    os.replace(tmp, out)
+    return RenderResult.OK
+
+
+class D2Diagram(SphinxDirective):
+    '''
+    Render a ``.d2`` source file (path relative to
+    the sphinx srcdir) as an SVG figure.
+
+    '''
+    required_arguments = 1
+    has_content = False
+    option_spec = {
+        'caption': directives.unchanged,
+        'alt': directives.unchanged,
+        'width': (
+            directives.length_or_percentage_or_unitless
+        ),
+        'margin': directives.flag,
+        'class': directives.class_option,
+        'name': directives.unchanged,
+    }
+
+    def run(self) -> list[nodes.Node]:
+        relsrc: str = self.arguments[0]
+        srcdir = Path(self.env.srcdir)
+        src: Path = srcdir / relsrc
+        self.env.note_dependency(relsrc)
+        if not src.exists():
+            err = self.state_machine.reporter.error(
+                f'd2 source not found: {relsrc}',
+                line=self.lineno,
+            )
+            return [err]
+        out: Path = (
+            srcdir
+            / _outdir
+            / f'{src.stem}.svg'
+        )
+        # collision guard: two distinct sources must not
+        # map onto the same output stem within a build.
+        prior: str|None = _seen_outputs.get(out.name)
+        if (
+            prior is not None
+            and
+            prior != relsrc
+        ):
+            err = self.state_machine.reporter.error(
+                f'd2 output collision: {relsrc!r} and '
+                f'{prior!r} both render to '
+                f'{_outdir}/{out.name}; rename one '
+                f'`.d2` stem',
+                line=self.lineno,
+            )
+            return [err]
+        _seen_outputs[out.name] = relsrc
+
+        result: RenderResult = render_svg(
+            self.env.app,
+            src,
+            out,
+        )
+        if result is RenderResult.FAILED:
+            # loud, build-failing (under `-W`) signal; the
+            # prior committed SVG, if any, is untouched.
+            err = self.state_machine.reporter.error(
+                f'd2 render failed for {relsrc} (see '
+                f'build log); the committed svg, if any, '
+                f'was left untouched',
+                line=self.lineno,
+            )
+            return [err]
+        if result is RenderResult.NO_OUTPUT:
+            # last resort: emit the raw d2 source so no
+            # content is ever silently dropped.
+            log.warning(
+                f'no svg available for {relsrc}; '
+                f'emitting d2 source as literal block'
+            )
+            src_text: str = src.read_text()
+            literal = nodes.literal_block(
+                src_text,
+                src_text,
+            )
+            literal['language'] = 'text'
+            return [literal]
+        # OK | FELL_BACK -> embed the SVG figure.
+        img = nodes.image(
+            uri=f'/{_outdir}/{out.name}',
+            alt=self.options.get(
+                'alt',
+                f'd2 diagram: {src.stem}',
+            ),
+        )
+        if width := self.options.get('width'):
+            img['width'] = width
+        # content-hash the rendered svg so the served
+        # `<img src>` carries a `?v=<hash>` cache-buster
+        # (sphinx tags css/js this way but not images);
+        # without it an edited diagram keeps showing the
+        # browser's stale copy at the stable
+        # `_images/<stem>.svg` url on autobuild reload.
+        if out.exists():
+            img['d2_stem'] = out.stem
+            img['d2_cachebust'] = hashlib.sha256(
+                out.read_bytes()
+            ).hexdigest()[:8]
+        fig = nodes.figure()
+        fig += img
+        classes: list[str] = (
+            ['d2-diagram']
+            + self.options.get('class', [])
+        )
+        if 'margin' in self.options:
+            # NB: the bare 'margin' class is what
+            # book-style themes key off for
+            # right-margin placement; our custom css
+            # uses 'd2-margin'.
+            classes += [
+                'margin',
+                'd2-margin',
+            ]
+        fig['classes'] += classes
+        if caption_txt := self.options.get('caption'):
+            (
+                inline_nodes,
+                _msgs,
+            ) = self.state.inline_text(
+                caption_txt,
+                self.lineno,
+            )
+            caption = nodes.caption(
+                caption_txt,
+                '',
+                *inline_nodes,
+            )
+            fig += caption
+        self.add_name(fig)
+        return [fig]
+
+
+def _reset_seen(
+    app: Sphinx,
+) -> None:
+    '''
+    Clear the per-build output-collision map at the
+    start of each build.
+
+    '''
+    _seen_outputs.clear()
+
+
+def _cachebust_d2_images(
+    app: Sphinx,
+    pagename: str,
+    templatename: str,
+    context: dict,
+    doctree,
+) -> None:
+    '''
+    Append a ``?v=<content-hash>`` query to every d2
+    diagram ``<img src>`` in the rendered page ``body``
+    so a browser re-fetches an *edited* SVG instead of
+    its stale cached copy at the stable
+    ``_images/<stem>.svg`` url (sphinx cache-busts
+    css/js this way, but not images).
+
+    Scoped strictly to d2 images (those carrying the
+    `d2_cachebust` attr set in `D2Diagram.run()`); all
+    other markup is left untouched.
+
+    '''
+    if doctree is None or 'body' not in context:
+        return
+    busts: dict[str, str] = {}
+    for img in doctree.findall(nodes.image):
+        if ver := img.get('d2_cachebust'):
+            busts[img['d2_stem']] = ver
+    if not busts:
+        return
+    body: str = context['body']
+    for stem, ver in busts.items():
+        body = re.sub(
+            r'(src="[^"]*?' + re.escape(stem) + r'\.svg)(")',
+            rf'\1?v={ver}\2',
+            body,
+        )
+    context['body'] = body
+
+
+def setup(app: Sphinx) -> dict:
+    app.add_config_value('d2_bin', None, 'env')
+    app.add_config_value('d2_args', [], 'env')
+    app.add_directive('d2', D2Diagram)
+    app.connect('builder-inited', _reset_seen)
+    app.connect('html-page-context', _cachebust_d2_images)
+    return {
+        'version': '0.1.0',
+        # NB: run() writes the rendered SVG during the
+        # READ phase; the temp-file + `os.replace` swap
+        # keeps that atomic so concurrent renders of the
+        # same diagram (under `sphinx-build -j`) can't
+        # tear the output file.
+        'parallel_read_safe': True,
+        'parallel_write_safe': True,
+    }

docs/_ext/marginalia.py

@@ -0,0 +1,51 @@
+# tractor: distributed structured concurrency.
+'''
+``.. margin::`` - prose-anchored, right-margin asides.
+
+A theme-agnostic vendoring of `sphinx_book_theme`'s
+`Margin` directive: a `docutils` `Sidebar` subclass
+which tags the node with a ``margin`` class; placement
+is then pure CSS (see ``_static/css/custom.css``)
+allowing use on any theme incl. our
+`pydata_sphinx_theme`.
+
+Usage,
+
+.. code:: rst
+
+    .. margin:: An optional title
+
+       Aside content; text, figures, whatever.
+
+'''
+from docutils import nodes
+from docutils.parsers.rst.directives.body import (
+    Sidebar,
+)
+from sphinx.application import Sphinx
+
+
+class Margin(Sidebar):
+    '''
+    Notes/figures placed in the right margin, anchored
+    at the current point in the prose flow.
+
+    '''
+    required_arguments = 0
+    optional_arguments = 1
+
+    def run(self) -> list[nodes.Node]:
+        if not self.arguments:
+            self.arguments = ['']
+        out: list[nodes.Node] = super().run()
+        out[0].attributes['classes'].append('margin')
+        return out
+
+
+def setup(app: Sphinx) -> dict:
+    app.add_directive('margin', Margin)
+    return {
+        'version': '0.1.0',
+        'parallel_read_safe': True,
+        'parallel_write_safe': True,
+    }

docs/_static/css/custom.css

@@ -0,0 +1,185 @@
+/* tractor docs: a minimal black + white skin over
+ * `pydata-sphinx-theme` plus RHS-marginalia + d2
+ * diagram styling.
+ */
+html[data-theme="light"] {
+  --pst-color-primary: #000000;
+  --pst-color-secondary: #3d3d3d;
+  --pst-color-accent: #5a5a5a;
+  --pst-color-link: #000000;
+  --pst-color-link-hover: #5a5a5a;
+  --pst-color-inline-code: #1a1a1a;
+  --pst-color-inline-code-links: #000000;
+}
+html[data-theme="dark"] {
+  --pst-color-primary: #ffffff;
+  --pst-color-secondary: #c9c9c9;
+  --pst-color-accent: #a8a8a8;
+  --pst-color-link: #ffffff;
+  --pst-color-link-hover: #bdbdbd;
+  --pst-color-inline-code: #e8e8e8;
+  --pst-color-inline-code-links: #ffffff;
+}
+/* mono-chrome links: rely on underline for
+ * affordance instead of color.
+ */
+.bd-content a:not(.headerlink) {
+  text-decoration: underline;
+  text-underline-offset: 0.18em;
+}
+/* d2 diagram figures */
+figure.d2-diagram {
+  text-align: center;
+}
+figure.d2-diagram img {
+  max-width: 100%;
+  height: auto;
+}
+/* keep light-rendered svgs legible in dark mode */
+html[data-theme="dark"] figure.d2-diagram img {
+  background: #ffffff;
+  border-radius: 6px;
+  padding: 6px;
+}
+/* prose-anchored right-margin asides (tufte-ish):
+ * float right within the content column on wide
+ * screens, collapse inline on narrow ones.
+ */
+@media (min-width: 960px) {
+  aside.margin,
+  figure.margin,
+  div.margin,
+  figure.d2-margin {
+    float: right;
+    clear: right;
+    width: 44%;
+    margin: 0.2rem 0 1rem 1.4rem;
+    font-size: 0.85rem;
+  }
+}
+/* strip docutils sidebar chrome from margin asides */
+aside.sidebar.margin {
+  border: none;
+  background: transparent;
+  padding: 0;
+}
+aside.sidebar.margin > p.sidebar-title {
+  font-weight: 600;
+  font-size: 0.9rem;
+  margin-bottom: 0.3rem;
+}
+/* landing-page hero logo (inline svg): the linework uses
+ * `fill: currentColor` so it inherits the theme text colour
+ * (auto-flips light<->dark), and the faces are transparent so
+ * the page background shows through. */
+svg.hero-logo {
+  display: block;
+  max-width: 360px;
+  height: auto;
+  color: var(--pst-color-text-base);
+}
+/* 3-up landing hero row: name | logo | tagline, with a centered
+ * sub-tagline beneath. */
+.hero-row {
+  display: flex;
+  align-items: center;
+  /* left-anchored single row; tighter gap so the logo sits over
+   * the sub-line and the tagline over the prose below it (stack
+   * only on mobile, via the media query). */
+  justify-content: flex-start;
+  flex-wrap: nowrap;
+  gap: clamp(0.5rem, 2vw, 1.5rem);
+  margin: 0 0 0.25rem;
+}
+.hero-row svg.hero-logo {
+  /* override the stacked-hero sizing for the inline row */
+  width: clamp(240px, 34vw, 360px);
+  margin: 0;
+}
+.hero-row .hero-tag {
+  margin: 0;
+  /* keep it on a single line beside the logo */
+  max-width: none;
+  white-space: nowrap;
+  font-size: clamp(1rem, 2.1vw, 1.4rem);
+  font-weight: 400;
+  line-height: 1.15;
+  color: var(--pst-color-text-base);
+}
+.hero-row .hero-tag {
+  min-width: 0;
+}
+.hero-sub {
+  /* wrap at the prose width (not the logo's), with a line of
+   * space before the prose section below. */
+  margin: 0 0 4rem;
+  max-width: none;
+  text-align: left;
+  font-size: 1.05rem;
+  color: var(--pst-color-text-muted);
+}
+/* the page carries a single rst <h1> ("tractor") for semantics
+ * + SEO, but the visual title is the hero — so hide the doc
+ * title accessibly (still read by screen readers + search). */
+#tractor > h1 {
+  position: absolute !important;
+  width: 1px;
+  height: 1px;
+  margin: -1px;
+  padding: 0;
+  overflow: hidden;
+  clip: rect(0 0 0 0);
+  clip-path: inset(50%);
+  white-space: nowrap;
+  border: 0;
+}
+/* smaller section headings on the landing only */
+#sixty-seconds-of-why > :is(h1, h2),
+#dig-in > :is(h1, h2),
+#features > :is(h1, h2),
+#where-do-i-start > :is(h1, h2) {
+  font-size: 1.75rem;
+}
+/* extra breathing room before the first landing section */
+#sixty-seconds-of-why {
+  margin-top: 4rem;
+}
+/* pull the section's `tl;dr` margin-note up so its top edge is
+ * level with the heading (default floats it beside the body). */
+#sixty-seconds-of-why aside.margin {
+  margin-top: -3.75rem;
+}
+/* stack the 3-up hero only on real mobile */
+@media (max-width: 640px) {
+  .hero-row {
+    flex-direction: column;
+  }
+  .hero-row .hero-tag {
+    max-width: none;
+  }
+}
+/* navbar brand: the "distributed SC" tagline next to the logo
+ * (the logo `text` value), kept small + muted like a sub-line. */
+.navbar-brand .title {
+  /* match the centered nav tabs (Bootstrap leaves the nav-link
+   * size/weight vars empty → ~1rem / normal); `inline-block` is
+   * the real underline fix — it stops the parent brand-link's
+   * :hover underline from propagating onto the text (a block
+   * child's `text-decoration:none` can't cancel an ancestor's
+   * underline). */
+  display: inline-block;
+  font-size: 1rem;
+  font-weight: 400;
+  text-decoration: none;
+}
+/* it's a brand mark, not a content link — never underline the
+ * brand text (base / hover / focus). */
+.navbar-brand,
+.navbar-brand:hover,
+.navbar-brand:focus,
+.navbar-brand:visited:hover,
+.navbar-brand .title,
+.navbar-brand:hover .title {
+  text-decoration: none !important;
+  border-bottom: 0 !important;
+}

docs/_static/tractor_hero.html

@@ -0,0 +1,462 @@
+<div class="hero-row">
+  <svg class="hero-logo" role="img" aria-label="tractor" version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 2670 1980" style="enable-background:new 0 0 2670 1980;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:currentColor;}
+	.st1{fill:none;}
+</style>
+<g>
+	<path class="st0" d="M2275.3,1000.1c-0.1,2.3,0,4.7,0,7c0,189.3,0,378.7,0,568c0,6,0.1,12.1-0.8,17.9c-2.4,15.2-12.9,17.4-23.6,10
+		c-45.4-31-91.2-61.4-136.9-91.9l-30.1-20.3c-9.8-6.3-19.2-13.2-29.2-19.3c-6.7-4.1-9.8-9.7-9.9-17.2c-0.1-9.3-0.6-18.7-0.3-28
+		c0.2-7.3-1.7-13-6.5-19c-18.6-23.3-36.2-47.3-56.9-69c-18-18.8-36.7-36.8-56.4-53.8c-31.8-27.5-65.4-52.7-101-74.9
+		c-32.7-20.4-66.8-38.4-102.2-54c-50.7-22.4-103.2-39.2-157.1-51.5c-36.7-8.4-73.8-14.4-111.2-18.5c-34.5-3.8-69-6.5-103.7-5.8
+		c-23.1,0.5-46.2-1.3-69.3,0.4c-22.9,1.8-45.9,3-68.7,5.6c-72.7,8.4-143.7,24.6-212.1,50.6c-65.5,24.8-127.4,57-184.9,97.4
+		c-46.8,32.8-90.1,69.8-129.5,111.1c-18.1,19-35.1,39.2-50.5,60.6c-3.9,5.5-5.5,11-5.3,17.6c0.4,9.3,0,18.7,0,28
+		c0,9.3-3.1,16.4-11.8,21.4c-10.4,5.9-19.9,13.4-30.1,19.8l-25.4,17.2c-11.6,7.8-23.3,15.5-34.9,23.3c-34.3,23-68.6,46-102.9,69
+		c-14.6,9.7-23.6,5.5-25.2-12.1c-0.5-5.3-0.5-10.7-0.5-16c0-189.7,0-379.3,0-569l-0.1-26.1c0.2-190.3,0.1-380.7,0.2-571
+		c0-5.7,0.4-11.3,0.5-17c0.1-3.7,1.2-7.3,3-10.5c3.4-5.9,9.3-7.7,15.4-4.8c2.7,1.3,5.1,3.1,7.6,4.8c44.3,29.6,88.5,59.3,132.8,88.9
+		l29.7,20.1c10.8,6.6,20.9,14.3,31.7,20.9c6.7,4.1,9.7,9.8,9.8,17.3c0.2,11,0.4,22,0.2,33c-0.1,5.2,1.2,9.6,4.2,13.9
+		c15.4,22.2,33,42.8,51.6,62.2c53.9,56.4,114.1,105.1,181.4,144.6c38.4,22.6,78.3,42.4,119.9,58.6c40,15.6,80.9,28.3,122.8,38
+		c52.7,12.1,106,19.3,160,22.6c18.3,1.1,36.6,2.1,54.9,1.5c17.7-0.6,35.5,1.1,53.2-0.1c17.6-1.1,35.2-2.3,52.8-3.6
+		c35.9-2.5,71.4-8.5,106.7-15.1c53.4-9.9,105.5-25,156-45.1c53.8-21.5,105.1-48.2,153.2-80.9c43.4-29.5,83.6-62.7,121.1-99.3
+		c27.3-26.6,50.3-56.8,73.9-86.6c2.9-3.6,3.6-7.6,3.6-12.1c-0.1-10.7,0.2-21.3,0.4-32c0.1-7.5,3.2-13.1,9.9-17.2
+		c10.2-6.2,19.9-13.4,30-19.8l23.2-16.3c4.2-1.3,7.4-4.3,11-6.7c42.9-28.7,85.8-57.4,128.7-86.1c1.1-0.7,2.3-1.4,3.3-2.3
+		c10.9-9.1,21.4-4.7,23.8,10.7c0.8,5.6,0.6,11.3,0.6,17c0,189.3,0,378.7,0,568L2275.3,1000.1z M740,1203.1c-2-0.2-4-0.3-6-0.5
+		c-0.5,2.5-4.8,2-4.2,5.8c2.9-1,6.4-1.2,4.2-5.8C735.8,1206,738.1,1202.3,740,1203.1c-0.6-0.7-0.5-1.3,0.2-1.7
+		c-1.1-0.3-1.1-0.1-0.4,0.8C740,1202.3,739.9,1202.8,740,1203.1z M1935.5,780.5c-0.2,0.2-0.4,0.4-0.6,0.4c-0.3,0.1-0.6,0-0.8,0
+		c0.4-0.2,0.8-0.5,1.1-0.8c1.4-0.9,2-1.9,0.5-3.3c3.2,1.1,6.1,1.2,7.9-2.8c-3.3-0.7-4.6,3.8-7.7,2.9
+		C1935.7,778.2,1935.6,779.4,1935.5,780.5z M1934.8,1202.5c-0.1-0.2-0.1-0.4-0.2-0.6c0,0,0.1-0.1,0.1-0.1c0,0.2,0.1,0.3,0.1,0.5
+		c3.1,1.6,5,5.7,11.3,5.1C1941.3,1205,1938.9,1202,1934.8,1202.5z M2072.4,516.6c-1,2.3-3.4,3-5.3,4.3c-7.4,5.1-8.2,7.2-5.3,17.8
+		c4.2-6.5,8-12.6,11.9-18.6c1.1-1.7,0.9-3.1-1.3-3.6c0,1,0.3,1.8,1.4,2c0.2,0,0.4-0.4,0.6-0.7C2073.8,517.4,2073.1,517,2072.4,516.6
+		z M599.6,517.5c-0.4-0.8-1.1-1.7-1.8-0.8c-0.8,0.8,0.1,1.5,1,1.6c2.4,8.9,7.5,16.2,13.4,24.1c2.3-16.5,1.9-17.3-10.7-24.4
+		C600.9,517.6,600.2,517.6,599.6,517.5z M534.9,1353.5c-20,21.8-37.3,44.1-53.4,67.4c-16.1,23.4-26.8,49.5-41.8,73.5
+		c9-21,17.4-42.2,28.9-61.9c16.9-28.7,35.4-56.4,57.5-81.5c0.9-1,1.6-2.1,2.6-3.1c2.9-2.9,3.3-6,2.3-10
+		c-9.1-33.8-14.6-68.3-19.2-103c-5-38-8.3-76.1-10.6-114.3c-2.5-39.9-3.4-79.9-3.9-119.8c-0.1-5.1-1.4-6.8-6.7-6.9
+		c-21.6-0.2-43.3-0.8-64.9-1.3c-2,0-4-0.4-6,0.8c0,195.2,0,390.5,0,585.6c2.1,0.6,3.1-0.4,4.1-1.1c52.7-33.8,105.3-67.7,158-101.4
+		c3.6-2.3,5.7-5.4,7.3-9.1c6-13,12.5-25.8,20.8-37.4c4.2-5.9,3.9-11.9,2.5-19.1c-2.4,1.8-4,2.9-5.5,4.2
+		c-13.9,12.6-32.1,8.7-42.7-2.9c-7.3-8-12.4-17.2-17.1-26.8C542.3,1375.7,539.4,1365.1,534.9,1353.5z M534.6,627.2
+		c3.6-5,4.3-10.7,6.3-15.9c6.2-15.8,12.6-31.5,25.2-43.7c10.8-10.5,26.8-12.6,38.9-2.8c2.3,1.9,4.3,5,7.9,5
+		c1.6-8.3-0.2-15.3-5.1-21.9c-7.4-9.9-12.7-21-17.8-32.3c-2.4-5.3-5.8-9.2-10.8-12.4c-50.5-32.2-100.9-64.7-151.3-97.1
+		c-2.4-1.5-4.5-3.9-8.7-3.9c0,3.7,0,7.2,0,10.7c0,187.9,0,375.8,0,563.7c0,2,0.2,4,0,6c-0.6,4.9,1.4,6.3,6.2,6.1
+		c13.6-0.6,27.3-0.7,41-1c8.3-0.2,16.7-0.6,25-0.4c4.9,0.1,6.7-1.8,6.1-6.4c-0.1-1,0-2,0-3c1.2-75,4.3-149.8,13.7-224.3
+		c4.6-36.3,10-72.5,19.6-107.9c1.6-5.7,0.4-9.9-3.4-14.4c-10.7-12.8-21.7-25.4-31-39.1c-19-28.1-36.8-57-49.6-88.7
+		c-2.2-5.4-5.5-10.4-6.2-16.6C465,538.3,494.6,586,534.6,627.2z M2060.9,1411.1c-2.3,8.5-0.1,15.1,4,21.4
+		c5.9,9.3,13.4,18.1,17.1,28.2c3.9,10.7,10.9,16.6,19.9,22.4c47.8,30.3,95.3,61.1,143,91.7c2.7,1.7,5,4.3,9.5,4.5c0-3.4,0-6.6,0-9.8
+		c0-188.3,0-376.6,0-565c0-2-0.1-4,0-6c0.2-3.4-1.1-5-4.6-4.8c-2.3,0.1-4.7,0-7,0.1c-20,0.6-40,1.2-60,1.9c-6.7,0.2-6.7,0.4-7,7.4
+		c0,1.3,0,2.7-0.1,4c-0.4,60-3,119.9-8.9,179.7c-5,50.1-11.3,99.9-24,148.7c-1.4,5.2,0.1,8.3,3.5,12.3c15,17.8,29.6,36.1,42.4,55.5
+		c20,30.4,36.1,62.9,49.3,96.8c3.2,8.2,5.7,16.6,6.8,25.4c-33.9-90.8-82.6-145-107.2-169.7c-4.1,11-7.5,22.1-12.7,32.5
+		c-4.9,9.9-10.3,19.5-18.8,26.8c-7.1,6.1-15.1,8.9-24.8,7.5C2073.2,1421.4,2068.3,1415.5,2060.9,1411.1z M2244.8,454.3
+		c0.6,4.5-0.2,6.7-0.8,8.9c-6.5,24.2-17,47-28.2,69.2c-18.9,37.2-43,71.2-70.4,102.8c-2.7,3.2-3.6,5.8-2.5,9.8
+		c7.9,29.6,13.1,59.8,17.3,90.2c6.4,45.6,10.2,91.3,12.8,137.3c2,35.3,2.6,70.6,3.1,105.9c0.1,7.6,0.2,7.6,7.6,7.8
+		c17,0.5,34,1,51,1.4c5,0.1,10,0.2,15,0.5c3.2,0.1,5.1-0.9,4.9-4.5c-0.1-1.7,0-3.3,0-5c0-189.6,0-379.3-0.1-568.9
+		c0-2.4,1.1-5.2-1.2-7.3c-0.8,0.1-1.6,0-2.1,0.4c-52.7,33.8-105.3,67.7-158,101.5c-2,1.3-3.7,2.6-4.7,4.9c-6.9,16-16.9,30.1-25.8,45
+		c-3.1,5.2-3.4,10.2-2,15.7c2.6,0.1,3.5-1.6,4.6-2.6c15.7-13.9,33-10.6,45.6,3.8c6,6.8,10.4,14.6,14.4,22.7
+		c5.1,10.3,8.3,21.3,12.8,32.9C2185.2,576.1,2221.7,520.5,2244.8,454.3z M553.7,662.8c-0.3,1.3-0.7,2.8-1,4.3
+		c-7.1,31.2-11.7,62.8-15.4,94.5c-7.1,59.9-10.3,120.1-11.8,180.4c-0.3,13-0.2,26-0.5,39c-0.1,4.4,1.5,5.7,5.7,5.6
+		c25-0.5,50-0.7,74.9-1.1c7.4-0.1,7.6-0.2,7.6-7.8c0-85.6,0-171.2,0.1-256.8c0-5.3-1.7-8.5-5.8-11.7c-16.6-12.8-32.4-26.6-46.9-41.9
+		C559,665.6,557.6,663,553.7,662.8z M553.6,1319.7c2.1-1,2.8-1.2,3.2-1.6c16.4-17.1,34-32.9,52.7-47.4c3-2.4,3.8-5,3.8-8.6
+		c-0.1-13.3-0.1-26.7-0.1-40c0-72.3,0-144.7,0-217c0-10.3,0.4-9-9.2-9.2c-23.3-0.4-46.7-0.8-70-1.1c-2.8,0-5.9-1-9.3,1.5
+		C526.2,1104.4,531.1,1212.3,553.6,1319.7z M2119.8,1319.2c4.8-20.9,8.3-40.2,11.1-59.6c5.8-39.5,9.8-79.2,12.5-119.1
+		c3.1-45.5,4.7-91.1,5.1-136.7c0.1-7.6-0.1-7.7-7.6-7.7c-24.3,0.1-48.6,0.3-72.9,0.5c-7.9,0.1-8,0.1-8,8.5c0,84.6,0,169.1-0.1,253.7
+		c0,5.6,1.7,9.3,5.9,12.7c12.1,9.9,24.2,19.9,36,30.1C2107.7,1306.9,2113.1,1312.7,2119.8,1319.2z M2120.4,664.4
+		c-2.1-0.6-2.9-0.1-3.6,0.7c-15.2,16.5-33.1,29.9-50.2,44.2c-4.8,4-6.8,8-6.8,14.3c0.3,32,0.2,64,0.2,96c0,52.3,0,104.6,0,157
+		c0,8.1,0.1,8.2,8.2,8.2c18.3,0.2,36.7,0.2,55,0.4c6.7,0.1,13.3,0.1,20,0.3c3.7,0.1,5.7-1.1,5.4-5.1c-0.2-2.3,0-4.7-0.1-7
+		c-0.5-45-2.1-89.9-5.2-134.8C2139.2,780.1,2132.7,721.9,2120.4,664.4z M878.7,1138.5c-36,15-69.8,32.9-102.3,53.1
+		c-3.4,2.1-4.9,4.7-5.7,8.6c-2.8,14.4-5.7,28.8-12.2,42c-3.6,7.3-7.7,14.4-17.3,14.4c-9.6,0-13.4-7.4-17.4-14.4
+		c-1.9-3.2-2-7.6-5.4-9.8c-22.3,17.4-41.6,37.2-58.8,58.9c-5.8,7.3-10.2,15.3-12,24.8c-3.8,20.3-9.1,40.2-16.7,59.5
+		c-2.6,6.7-1.3,13.3-1.5,20.3c1.5-0.4,2-0.3,2.1-0.5c3.2-3.8,6.4-7.6,9.4-11.6c31.2-40.5,66-77.4,105.4-110.2
+		c36.9-30.8,75.6-59.1,117.2-83.1c54.3-31.2,110.9-57.4,170.8-76.4c38.4-12.2,77.4-21.8,117-29.2c9.5-1.8,19.1-3,28.6-4.6
+		c1.5-0.3,3.8,0.3,4.4-1.5c1.4-3.9,0.6-8-0.4-11.7c-1-3.6-4.5-1.7-6.9-1.5c-40.6,3.2-80.4,11-120.4,18c-7,1.2-10.4,4.1-10.9,11.2
+		c-0.3,3.8-0.5,9.1-5.8,9c-4.6-0.1-4.7-5-5.3-8.5c-0.7-4.5-2.4-6-7.3-4.9c-39.3,9.1-78,19.9-115.5,34.7c-4.6,1.8-7.1,4.2-7.8,8.9
+		c-0.9,5.9-2.2,11.8-5.2,17.1c-4.1,7.1-10.6,7.2-14.6,0C881.9,1147.7,880.7,1143.4,878.7,1138.5z M1032.8,891.9
+		c0.9-3.8,1.6-6.7,2.4-9.5c0.7-2.3,1.7-4.6,4.4-4.9c3.4-0.3,4.4,2.3,5.3,4.9c0.4,1.3,0.8,2.6,0.8,3.9c0.1,7.7,4.5,10.4,11.7,11.6
+		c32.5,5.5,64.8,11.9,97.5,15.7c7.9,0.9,15.9,1.7,23.8,2.4c1.9,0.2,4,0.7,5.3-1.6c3.5-6.5,0.3-13-7-14.2c-1-0.2-2-0.2-3-0.4
+		c-42.6-5.8-84.2-15.9-125.4-28.2c-41.8-12.4-82.5-28.2-121.6-47.1c-51-24.6-99.8-53.3-144.7-87.9c-20.6-15.8-40.9-32.1-59.9-49.7
+		c-29.1-26.9-56.4-55.7-80.1-87.7c-3.7-4.9-7.7-9.6-11.6-14.3c-0.8,7.6-2.4,14.7,0.5,21.8c7.4,18.2,12.4,37.2,16,56.5
+		c1.7,9.1,5,17.3,10.6,24.4c9.2,11.4,18.5,22.8,28.7,33.3c9.9,10.1,21.1,19,32.2,28.9c3.8-6.5,5.6-13,9.8-18.2
+		c7.7-9.4,17.7-9.5,25.3-0.1c3.6,4.5,5.7,9.7,7.8,15c4.3,10.9,6.8,22.3,8.9,33.7c0.9,5.2,3.3,8.1,7.5,10.7
+		c21.9,13.4,44.1,26,67.3,37.1c10.9,5.2,22.1,10,33.5,15.2c1.8-4.8,3.1-8.6,4.7-12.2c1.6-3.5,4.2-6.3,8.3-6.1
+		c3.6,0.2,5.8,2.9,7.3,6.1c2.4,5.2,3.8,10.6,4.8,16.2c0.8,4.6,2.9,7.2,7.7,9C950.6,871.5,990.8,883,1032.8,891.9z M1953.8,1233.7
+		c-2.9,5.8-4.9,11.5-8.8,16.2c-7.6,9.3-17.8,9.3-25.3,0c-3.4-4.2-5.5-9-7.5-14c-4.4-11.5-7.2-23.5-9.4-35.7
+		c-0.7-3.9-2.4-6.4-5.8-8.6c-30.4-19.4-62.4-35.6-95-50.8c-6.9-3.3-7-3-9.9,4.7c-0.7,1.9-1.5,3.7-2.3,5.5c-1.6,3.1-3.7,5.6-7.6,5.6
+		c-3.8,0-5.9-2.5-7.6-5.6c-2.9-5.4-4.3-11.3-5.1-17.2c-0.7-5-3-7.3-7.5-9.1c-37.8-15.2-77.3-24.6-116.7-34.3c-3.8-0.9-5.4,0.2-6.2,4
+		c-0.7,3.9-0.2,9.9-6.3,9.5c-5-0.3-5.1-6.1-5.3-9.6c-0.4-6.6-3.3-8.9-9.6-10c-32.8-5.6-65.4-12.2-98.6-15.7
+		c-8.3-0.9-16.5-2.1-24.8-2.7c-5.4-0.4-7.1,1.2-7.5,6.6c-0.3,3.9-1.3,8,5.2,8.4c6.3,0.4,12.4,2.1,18.7,3.1
+		c47.7,7.5,94.4,19.1,140.3,34.3c42.4,14,83.5,31.2,123,52c46.3,24.4,90.2,52.6,131,85.6c48.5,39.1,93.7,81.2,129.4,132.6
+		c1.9,2.8,4.8,7.5,7.3,6.7c4.5-1.5,1.4-6.8,2.1-10.4c0.6-3.4-0.5-6.6-1.8-9.7c-7.8-19.5-12.6-40-17.1-60.4c-1.1-5.1-3-9.4-6-13.5
+		c-17-22.8-36.7-43.1-57.6-62.2C1959.6,1237.1,1957.6,1234.7,1953.8,1233.7z M2043.6,585.1c-4.2,2.7-6.2,6.2-8.5,9.2
+		c-29.9,40.3-64.6,76.1-102.5,109c-33.8,29.3-69.5,56.2-107.6,79.4c-51.8,31.6-106.3,57.7-163.9,77.3
+		c-40.7,13.8-82.1,24.9-124.2,33.1c-13.7,2.7-27.6,4.7-41.3,7c-2.2,0.4-5.3-0.1-6.2,2.4c-1.4,3.8-1.1,8.2,0.3,11.7
+		c1.4,3.5,5.3,1.6,8.1,1.3c40.1-4.2,79.8-10.7,119.5-18.1c6.2-1.2,10.4-2.7,10.5-10.2c0-3.5,0.3-9.3,5.4-9.5c6-0.3,5.5,5.7,6.2,9.6
+		c0.7,3.9,2.3,4.9,6.1,3.9c10-2.7,20-5.1,30-7.5c28.5-6.9,56.4-15.6,83.9-25.7c6.8-2.5,10.2-6.3,11-13.3c0.5-5,2-9.8,4.5-14.2
+		c4.2-7.6,10.8-7.6,15.1,0.1c1.6,2.9,2.5,6.2,3.4,9.3c0.9,2.9,2.5,3.5,5.2,2.2c2.4-1.2,5-1.9,7.3-3.1c26.6-13.1,53.2-26,78.7-41.2
+		c11.9-7.1,19.6-14.7,21.3-29.3c1.4-12.4,5.5-24.8,12.8-35.4c8.1-11.7,19.5-11.7,27.5,0.1c3.1,4.6,5.4,9.7,8.2,14.9
+		c1.9-1.4,3.6-2.5,5.1-3.8c22.2-19.8,42.7-41.1,60.6-64.9c2.6-3.5,4.3-7.3,5.2-11.7c4.5-21.2,9.6-42.2,17.6-62.4
+		C2045.3,599.2,2044.5,592.6,2043.6,585.1z M777.2,1163.8c1.2,0.2,1.6,0.4,1.9,0.3c30.4-14.3,60.9-28.3,92.6-39.6
+		c4.2-1.5,4.4-3.7,3.9-7.5c-4.5-37.4-6.3-75-6.5-112.6c0-7.8-0.2-7.9-8.5-7.9c-22,0-44,0-65.9,0c-8.6,0-8.8,0.1-8.8,8.7
+		c-0.4,45.3-2.2,90.5-6.6,135.6C778.4,1148.4,776.3,1155.9,777.2,1163.8z M776.8,817.8c0.3,3.8,0.5,7.1,0.9,10.4
+		c2.5,21.2,4.1,42.4,5.5,63.7c1.8,28.6,2.3,57.2,2.7,85.9c0.1,7.1,0.3,7.3,7.2,7.3c22.6,0.1,45.3,0.1,67.9,0.1
+		c8.8,0,8.1-0.2,8.1-8.3c0.1-37,1.9-73.9,6.4-110.6c0.7-5.8-0.5-8.2-6-10.1c-29.5-10.3-58-23.3-86.2-36.8
+		C781.5,818.4,779.9,817.2,776.8,817.8z M1896.4,1163.9c1-2.7,0.2-5.3-0.1-7.9c-2.4-19.8-3.9-39.8-5.3-59.7
+		c-2.1-30.3-2.5-60.6-3.3-90.9c-0.2-8.7-0.2-8.8-8.6-8.8c-16.7-0.1-33.3,0-50-0.1c-6.3,0-12.7,0.2-19-0.1c-3.9-0.1-5.5,1.4-5.2,5.3
+		c0.1,1.7,0.1,3.3,0,5c-1.1,36-2,72-6.4,107.7c-0.9,7.7-1.1,7.9,6.3,10.6c28.5,10.4,56.1,22.9,83.3,36.1
+		C1890.6,1162.4,1893.1,1164.4,1896.4,1163.9z M1896.8,817.7c-2.5-0.3-4.3,0.6-6.1,1.5c-6,2.9-12,5.6-18,8.6
+		c-22.1,10.9-44.9,20.1-67.9,28.7c-7.5,2.8-7.3,3-6.5,10.6c1,8.9,1.9,17.9,2.7,26.8c2.4,28.2,3.2,56.5,3.6,84.7
+		c0.1,5.4,1.8,6.7,6.8,6.6c22.6-0.2,45.3-0.1,67.9-0.2c1,0,2-0.1,3,0c3.8,0.3,5.6-1.2,5.2-5.1c-0.2-1.6,0-3.3,0.1-5
+		c0.7-38.6,1.7-77.2,5.2-115.6C1894.1,845.4,1895.5,831.6,1896.8,817.7z M908.3,1109.6c1.4,0,2.4,0.2,3.2,0
+		c37.8-11.7,75.5-24,114.2-32.5c4.5-1,5.8-2.9,5.5-7.4c-1.3-22-2.5-43.9-2.3-65.9c0.1-7.3-0.2-7.4-8-7.4c-33.3,0-66.7,0.1-100,0.2
+		c-7.7,0-7.9,0.1-7.9,7.5c0,31-1.6,61.9-4,92.9C908.8,1101,907.3,1105.2,908.3,1109.6z M1765.3,1110.4c0-2.5,0.1-3.5,0-4.4
+		c-3.1-33.9-4.7-67.8-4.8-101.8c0-7.4-0.4-7.6-8.2-7.7c-33.3-0.1-66.7-0.2-100-0.2c-7.3,0-7.2,0.1-7.5,7.9c-0.7,21-1.1,42-2.3,62.9
+		c-0.5,9-1.3,8.3,7.6,10.4c29.8,7.1,59.4,14.9,88.5,24.5C1747.2,1104.8,1755.7,1107.4,1765.3,1110.4z M908.8,872.2
+		c-0.2,0.3-0.6,0.6-0.6,0.8c2.8,35.5,5.2,71,4.8,106.7c-0.1,4.6,1.9,5.6,6,5.6c34.7-0.1,69.3-0.1,104,0.1c4.9,0,6.2-1.8,6.1-6.4
+		c-0.5-22,0.8-44,2.1-65.9c0.3-5.2-0.9-7.7-6.4-8.8c-36.9-7.6-72.4-20.1-108.5-30.5C913.8,873,911.6,871.1,908.8,872.2z
+		 M1765.6,872.4c-3.2-0.6-5.1,0.3-7,0.9c-22.2,6.7-44.2,14.5-66.7,20.3c-14.5,3.7-29,7.3-43.5,10.8c-4.4,1.1-6.5,2.6-6.2,8
+		c1.3,21.9,1.8,43.9,2.6,65.8c0.2,7,0.2,7.1,7.1,7.1c33.6,0,67.2,0,100.8-0.1c7.5,0,7.7-0.2,7.7-7.8c0.2-24.6,0.9-49.2,2.6-73.8
+		C1763.8,893.4,1764.7,883.1,1765.6,872.4z M725.8,1192.5c8.7-4.8,15.8-9.8,23.8-12.8c9.6-3.7,12.7-10.5,13-19.7
+		c0.1-1.3,0.2-2.7,0.4-4c3.4-27.1,5.6-54.3,6.7-81.5c1-23.6,1.5-47.2,2-70.8c0.2-7-0.1-7-7.3-7.1c-6.7-0.1-13.3,0-20,0
+		c-9,0-18,0.2-27,0c-4.2-0.1-6.2,1.3-5.9,5.7c0.2,2.3,0,4.7,0.1,7c0.8,27.6,1.2,55.2,3,82.8C717,1125.1,719.9,1158.2,725.8,1192.5z
+		 M1946.2,1191.7c2.9-2.2,2.4-4.7,2.8-6.9c4.5-26.6,6.9-53.5,8.9-80.4c2.5-33.9,3.2-67.9,3.7-101.8c0.1-5-1.8-6.2-6.4-6.1
+		c-15.3,0.2-30.6,0-46,0.1c-7.6,0-7.8,0.2-7.7,7.8c0.7,44,2,87.9,6.7,131.6c1.1,10.3,2.2,20.5,3.5,30.7c0.4,2.8,0.2,6,3.5,7.8
+		C1925.8,1180.2,1936.2,1186.1,1946.2,1191.7z M1947.7,789.1c-9.1,5-16.9,10.1-25.3,13.8c-8.2,3.6-10.5,9.5-11.5,17.8
+		c-3,27.1-5.6,54.3-6.9,81.6c-1.2,25.3-1.5,50.6-2.5,75.9c-0.2,5.1,1.5,7,6.7,7c15-0.3,30-0.1,45-0.2c8.6,0,8.4,0.6,8.3-8.9
+		c-0.3-30.6-1-61.3-3.1-91.9C1956.3,852.9,1953.6,821.8,1947.7,789.1z M726,789.2c-3.3,16.4-5.1,31.3-6.7,46.2
+		c-4.6,42.4-6.3,85-7.3,127.7c-0.1,5.7,0,11.3-0.2,17c-0.1,3.4,1.4,4.8,4.7,4.8c17,0,34,0,51,0.1c3.6,0,4.6-1.9,4.4-5
+		c-0.1-2.3-0.1-4.7-0.1-7c-0.5-37.3-1.7-74.6-5-111.8c-1.4-15.9-2.8-31.9-5.5-47.6c-0.4-2.6-0.3-5.2-3.2-6.8
+		C747.6,801.1,737.2,795.4,726,789.2z M1625.1,910.5c-9.8,1.8-18,3.4-26.2,4.6c-23.3,3.5-46.2,9.9-70,10
+		c-10.9,0.1-21.8,2.4-32.7,3.7c-3.5,0.4-6.2,1.1-6,6c0.5,15,0.7,30,0.7,44.9c0,4.4,1.7,5.8,5.9,5.7c8.3-0.2,16.6,0,25-0.1
+		c30.6,0,61.3,0,91.9-0.1c9,0,9-0.1,9.2-9.4c0.2-13,0.2-26,0.6-38.9C1623.7,928.4,1624.5,919.8,1625.1,910.5z M1625.2,1071.1
+		c-2.2-23.8-2.3-46.1-2.4-68.4c0-4.5-1-6.6-6.1-6.6c-39.9,0.1-79.9,0.1-119.8-0.1c-5.1,0-6.1,2-6.1,6.5c0,14.6-0.1,29.3-0.6,43.9
+		c-0.1,4.5,1.6,5.6,5.6,6.1c12.6,1.4,25,3.8,37.7,4c8,0.1,15.9,1.1,23.8,2.5C1579.5,1063,1601.7,1066.9,1625.2,1071.1z
+		 M1049.3,1070.4c2.6,1,4.9-0.1,7-0.6c23-5.5,46.3-8.9,69.7-12.3c16.7-2.5,33.7-3.8,50.6-5.2c5.1-0.4,6.8-1.9,6.6-7
+		c-0.4-14-0.3-27.9-0.5-41.9c-0.1-7-0.2-7.2-7.2-7.2c-39.3,0-78.5,0-117.8,0.1c-6.7,0-6.8,0.2-6.8,7.5c0,16.3-0.5,32.6-1.4,48.9
+		C1049.3,1058.6,1048.4,1064.5,1049.3,1070.4z M1049.8,910.2c-0.4,1.2-0.8,1.8-0.8,2.4c0.6,22.6,2.5,45.2,1.9,67.8
+		c-0.1,4.2,2.1,4.8,5.6,4.8c39.9,0,79.9-0.1,119.8,0.1c5.5,0,6.7-2.3,6.6-7.2c-0.2-11,0.1-22,0.2-32.9c0.1-15.9,0.1-15.5-16.3-17.4
+		c-16.5-1.9-33.1-2.4-49.6-5.2C1094.7,918.9,1072,915.9,1049.8,910.2z M1260.5,985.4c21.6,0,43.2,0,64.9,0c9.1,0,9.1-0.1,9.1-9.4
+		c0-10.3,0-20.6-0.1-30.9c-0.1-7.7-0.1-7.7-7.6-7.9c-2.3-0.1-4.7,0-7,0c-41.9,0-83.8-2.2-125.5-6.2c-4.6-0.4-5.9,0.9-6,5.1
+		c-0.2,13.6-0.6,27.3-0.8,40.9c-0.1,8.3,0.1,8.4,8.1,8.4C1217.3,985.4,1238.9,985.4,1260.5,985.4z M1485,931.5
+		c-3.1-1.4-5.4-0.6-7.7-0.4c-26.2,1.9-52.4,4.3-78.7,5.1c-17.3,0.5-34.6,1.3-51.9,1.1c-7.4-0.1-7.5,0.1-7.6,7.8
+		c-0.1,11.7,0,23.3-0.1,35c0,3.7,1,5.8,5,5.5c2-0.1,4,0,6,0c41.6,0,83.2,0,124.9,0c2,0,4-0.1,6,0c3.3,0.1,5-1.2,4.9-4.6
+		C1485.5,964.2,1485.3,947.6,1485,931.5z M1485,1051.1c0.3-17,0.5-33.6,0.9-50.1c0.1-4.2-2.2-4.8-5.7-4.8c-45,0.1-89.9,0.1-134.9,0
+		c-4.7,0-6.5,1.4-6.3,6.2c0.3,12,0.4,24,0,36c-0.2,5.2,2.1,6,6.5,6c11.6-0.1,23.3,0.1,34.9,0.4
+		C1415,1045.8,1449.5,1048.1,1485,1051.1z M1188.4,1050.6c47.5-3.4,93.2-6.8,139.2-6.4c0.7,0,1.3,0,2,0c3.2,0.2,4.9-0.9,4.9-4.5
+		c-0.1-13,0-25.9,0-38.9c0-3.4-1.6-4.8-4.9-4.6c-1.7,0.1-3.3,0-5,0c-42.6,0-85.1,0-127.7,0c-1.7,0-3.3,0.1-5,0
+		c-2.8-0.1-4.4,1.1-4.4,4.1C1187.9,1016.8,1188.1,1033.4,1188.4,1050.6z M2010.7,1230.1c0.9-7.3-0.9-13.8-1.5-20.3
+		c-6.8-66-10.3-132.2-10.7-198.6c-0.1-16.1-0.3-16.3-16.8-14.7c-2.9,0.3-4.2,1.1-4.1,4.1c0.1,3,0,6,0,9
+		c-0.3,41.3-2.1,82.6-6.1,123.8c-2,20.2-4.3,40.4-8.2,60.4c-0.9,4.8-0.2,7.8,4.5,10.4c10.2,5.7,19.9,12.2,29.8,18.3
+		C2001.8,1225,2005.6,1228.2,2010.7,1230.1z M2011.2,752.5c-2.7-0.8-3.6,0.3-4.7,1c-13.3,8.3-26.4,16.7-39.8,24.7
+		c-3.6,2.1-4.2,4.5-3.5,8.2c1.4,7.8,2.8,15.7,3.9,23.6c7.4,53.8,10.1,107.9,10.6,162.2c0.1,14.1-2.6,12.8,13.7,12.8
+		c7,0,7-0.2,7.1-7.3c0.4-27.3,0.6-54.6,1.8-81.8c1.4-30.9,3.1-61.8,6.1-92.6C2008,786.3,2009.6,769.5,2011.2,752.5z M662.1,1231.5
+		c3.7-2.4,5.6-3.7,7.5-4.9c11.6-7.7,22.9-16.2,35.5-22.2c5.3-2.5,6.2-5.5,5.1-11c-4.6-22.5-7-45.4-9-68.3
+		c-3.5-39.9-5-79.8-5.4-119.8c-0.1-8.6-0.2-8.6-8.8-8.7c-1.3,0-2.7,0-4,0c-7.9,0.1-8,0.1-7.9,8.4c0,24.7-0.6,49.3-1.6,74
+		c-1.3,32-3,63.9-6,95.8C665.8,1192.9,664.1,1211.1,662.1,1231.5z M662.9,752.1c-1,1.4-0.4,3-0.3,4.6c2,20.5,4.6,41.1,6,61.7
+		c3.8,52.5,6.5,105.1,6.4,157.8c0,8.8,0.1,8.9,8.5,8.9c14.5-0.1,12.1,1.3,12.3-12.1c1.1-62.7,3.5-125.2,14.8-187
+		c0.8-4.1-0.9-6-4.2-7.7c-13.4-6.8-25.6-15.5-38-23.9C666.8,753.1,665.5,751.1,662.9,752.1z M2044.3,728.6c-5.4,1.1-7.1,3.9-7.7,8.3
+		c-1.7,14.9-4,29.7-5.6,44.6c-4.6,42.1-7.2,84.2-8.9,126.5c-1,25.3-1.3,50.5-1.3,76.8c6.5,0,12.4-0.1,18.3,0
+		c3.8,0.1,5.5-1.4,5.2-5.3c-0.2-1.7,0-3.3,0-5c0-78.9,0-157.9,0-236.8C2044.3,734.9,2044.3,732,2044.3,728.6z M2044.3,1253
+		c0-3.7,0-6.4,0-9c0-78.6,0-157.2,0-235.8c0-13,1.3-11.5-11.9-11.5c-13,0-11.5-1.8-11.5,11.8c0,59.3,3.1,118.5,8.7,177.6
+		c1.9,19.5,4,39.1,7,58.5C2037.3,1248.9,2038.8,1251.8,2044.3,1253z M629.2,728.7c0,4.3,0,8,0,11.6c0,76.5,0,153.1,0,229.6
+		c0,15.8,0,15.8,16,15.3c7.6-0.2,7.6-0.2,7.7-7.7c0.1-3.3,0-6.7,0-10c-0.8-55.6-3.1-111.1-8.5-166.4c-2-21.2-5-42.3-7.3-63.4
+		C636.6,733.3,635,730.3,629.2,728.7z M629.2,1253.2c5.3-2.1,7.4-4.5,7.9-9.2c1.6-14.9,4-29.7,5.5-44.6
+		c6.5-62.4,9.5-124.9,10.3-187.6c0.2-15.6,0.1-15.6-15-15.6c-9,0-8.8-0.6-8.7,8.6c0,2,0,4,0,6c0,75.7,0,151.3,0,227
+		C629.2,1242.5,629.2,1247.2,629.2,1253.2z M2060,697.5c19-15.9,36.7-29.3,52.3-45.3c3.5-3.5,3.7-6.7,2.4-10.7
+		c-2.8-8.9-5.4-17.8-8.7-26.5c-3.5-9.3-7.4-18.5-13.7-26.4c-5.3-6.6-8-6.6-13.4-0.4c-1.3,1.5-2.7,3-3.6,4.7
+		c-8.9,15.7-17.3,31.5-15.3,50.5c0.4,3.6,0.1,7.3,0.1,11C2060,668,2060,681.5,2060,697.5z M613.2,1283.1
+		c-20.8,13.6-36.9,29.9-53.8,45.4c-2.8,2.6-2.3,5.1-1.5,8.1c4.1,14.7,8.6,29.3,15.3,43.2c2.6,5.4,5.4,10.7,9.8,15
+		c4.3,4.2,6.2,4.6,10,0.4c10.7-11.9,18.4-26.3,19.7-41.7C614.7,1330.6,613.2,1307.6,613.2,1283.1z M2060,1284.4
+		c0,19.5,0.7,36.8-0.2,54c-1.1,19.1,6.3,35.2,15.8,50.5c7.4,12.1,12.1,11.7,19.8-0.6c9.7-15.4,14.6-32.7,19.7-50
+		c1.1-3.7,0-6.2-2.6-8.8C2096.8,1313.6,2079.3,1299.9,2060,1284.4z M611.9,698.2c2.1-3.3,1.3-5.9,1.3-8.4c0.1-16-0.8-32,0.3-47.9
+		c1.2-18.4-6.2-33.8-15.1-48.6c-7.6-12.7-12.6-12.4-20.4,0.3c-10.1,16.3-15.1,34.6-20.4,52.8c-1,3.6,0.6,5.5,3,7.7
+		c8.8,8.1,17.3,16.7,26.3,24.5C594.8,685.4,603.3,691.5,611.9,698.2z M1788.2,864c-12.5,3.2-12.6,3.2-13.9,13.8
+		c-0.9,7.6-1.6,15.2-2.1,22.8c-1.8,26.2-2.9,52.5-3.2,78.8c0,4,0.8,6.3,5.4,6c4.6-0.3,9.3-0.2,14,0c5.1,0.1,6.9-2.1,6.7-7.3
+		c-0.5-11.3-0.2-22.6-0.7-33.9C1793.2,917.5,1792.3,890.9,1788.2,864z M885.3,1118.4c12.8-3,12.5-3,13.8-13.9
+		c3.5-29.5,4.6-59.1,5-88.8c0.3-23.5,5.2-18.7-19.8-19.4c-4.4-0.1-5.7,1.5-5.7,5.8C878.8,1040.8,880.3,1079.4,885.3,1118.4z
+		 M885.7,863.5c-0.2,0.9-0.6,1.9-0.7,2.9c-4.3,33.7-6,67.5-6.1,101.4c0,5.5-2.5,12.6,1.3,16.2c3.8,3.6,10.8,1.1,16.3,1.2
+		c7.9,0.1,8.1-0.1,7.9-8.4c-0.6-33.2-1.5-66.4-5.3-99.4C897.9,865.6,898,865.6,885.7,863.5z M1788.4,1117.5
+		c4.4-34.4,5.9-68.6,6.5-102.9c0.1-5.6,2.4-12.7-0.9-16.5c-3.9-4.3-11.3-1.4-17.2-1.6c-7.6-0.2-7.7,0.1-7.7,7.6
+		c0,24.7,1.3,49.3,2.8,73.9c0.6,10.3,2.2,20.5,2.9,30.8c0.3,3.6,1.7,5.5,4.9,6.5C1782.2,1116,1784.4,1117.7,1788.4,1117.5z
+		 M1481.1,1078.1c0-2.7,0.1-4.4,0-6c-0.3-7.8-0.3-8.1-8.2-8.7c-22.9-1.7-45.8-3.3-68.7-4.7c-19.9-1.2-39.9-0.9-59.9-1
+		c-4.6,0-5.5,2-5.4,6c0.1,3.7,0.3,6.7,5.2,6.2c1.3-0.1,2.7,0,4,0c34.3-0.3,68.4,1.9,102.5,5.6
+		C1460.6,1076.6,1470.4,1078.5,1481.1,1078.1z M1480,903c-15.3,1.6-30.8,3.6-46.3,4.8c-29.5,2.4-59.1,4.7-88.8,3.9
+		c-5.1-0.1-6.1,2-6,6.5c0.1,4.1,1.1,6.3,5.6,5.8c1.3-0.2,2.7,0,4,0c42.3,0.3,84.5-2.6,126.7-5.9c4.2-0.3,6.2-1.6,5.8-5.9
+		C1480.7,909.3,1482,906.3,1480,903z M1192.2,1078.2c3.1-0.2,5.4-0.3,7.6-0.5c37-4.6,74-7.6,111.3-7.8c6,0,12-0.1,18,0
+		c3.7,0.1,5.3-1.1,5.4-5.1c0.1-6.5,0-6.9-7.3-7c-40.6-0.8-81.1,1.7-121.6,4.6C1193.1,1063.3,1193.2,1063.6,1192.2,1078.2z
+		 M1192.6,903.2c0.2,14.4,0.2,14.4,12.8,16c3,0.4,6,0.6,8.9,0.8c19.3,1.1,38.5,2,57.8,3.2c18.6,1.2,37.2,0.8,55.9,0.8
+		c6.4,0,6.3-0.5,6.6-6.8c0.2-5.8-3.3-5.5-7.1-5.4c-28.3,0.8-56.5-1.5-84.7-3.6C1226.3,907,1209.8,905.4,1192.6,903.2z M653.6,694.6
+		c2,12.3,3.8,22.4,5.1,32.6c0.5,3.7,1.7,6.1,4.8,8c14.2,8.8,27.5,18.8,42.2,26.6c2.7,1.4,6.2,6.3,8.9,2.4c2.7-3.7-2.6-6.2-5-8.5
+		c-19-17.3-36.7-35.8-51.8-56.7C657,698.1,656,697.3,653.6,694.6z M654,1284.6c0.8,0,1.3,0.1,1.5,0c1.4-1.4,2.9-2.7,4-4.3
+		c14.6-20.8,32.8-38.3,51.2-55.5c1.2-1.1,2.6-2.1,3.6-3.4c1.4-1.7,1.5-3.6-0.2-5.7c-2.9,0.3-5.3,2.1-7.8,3.6
+		c-10.2,6.3-19.8,13.5-30.5,18.8c-12.9,6.4-19.3,15.7-19.2,30.2C656.6,1273.7,654.9,1279.1,654,1284.6z M2019.1,698.8
+		c-0.5-0.3-1-0.6-1.5-0.9c-1,1.2-2,2.4-3,3.6c-6.8,9-13,18.4-21.4,26.1c-11,10.1-20.5,21.7-32.4,30.8c-1.9,1.5-3.6,3.2-2.1,5.9
+		c2,3.5,4.1,0.5,5.7-0.4c15.4-9.7,30.8-19.6,46.1-29.5c2.3-1.5,4-3.1,4.4-6.2C2016.2,718.5,2017.7,708.6,2019.1,698.8z
+		 M2017.1,1283.9c0.7-0.2,1.4-0.5,2.1-0.7c-1.5-10.1-3-20.2-4.4-30.4c-0.4-2.6-1.9-4.1-3.9-5.4c-15.6-10-31.3-20.1-46.9-30
+		c-1.5-1-3.3-2.8-5-0.5c-1.7,2.4-0.3,4.2,1.7,5.9c4,3.4,8.1,6.9,11.8,10.6C1988.4,1249.3,2005.3,1264.3,2017.1,1283.9z M1044.6,1034
+		c0.2,0,0.3,0,0.5,0c0-11-0.1-21.9,0.1-32.9c0.1-4.2-2-4.8-5.5-4.9c-4.5-0.1-4.6,2.6-4.6,5.9c0.1,22.3,1.2,44.5,2.4,66.8
+		c0.1,1,0.2,2,0.4,3c0.2,1.2,1.2,1.8,2.1,1.7c0.8-0.1,1.9-1,2.2-1.7c0.5-1.5,0.7-3.2,0.8-4.9C1043.5,1055.9,1044,1045,1044.6,1034z
+		 M1636.4,1033.8c0.7,0,1.4,0,2.1,0c0-10.6,0-21.2,0-31.8c0-2.7,0.2-5.3-3.6-5.8c-4.7-0.6-6,0.4-6,6.1c-0.1,21.9,0.2,43.7,2.1,65.6
+		c0.1,1.3,0.1,2.7,0.6,3.9c0.3,0.7,1.5,1.6,2.2,1.5c0.7,0,1.7-1.1,1.9-1.8c0.5-1.9,0.7-3.9,0.7-5.9
+		C1636.4,1055,1636.4,1044.4,1636.4,1033.8z M1638.5,948.1c-0.2,0-0.5,0-0.7,0c-0.5-11.6-1-23.3-1.6-34.9c-0.1-1.9,0.2-4.8-2.3-4.9
+		c-3.3-0.1-2.8,3-3,5.2c-0.3,3-0.4,6-0.7,9c-1.5,19-1.4,37.9-1.4,56.9c0,5.3,2,6.8,6.4,5.8c3.8-0.8,3.3-3.6,3.3-6.2
+		C1638.5,968.8,1638.5,958.4,1638.5,948.1z M1045.1,948c-0.1,0-0.3,0-0.4,0c-0.6-11.9-1.2-23.9-1.9-35.8c-0.1-1.9-0.4-4.3-3.2-3.9
+		c-2.2,0.3-1.9,2.4-2,4c-1.3,22.5-2.3,45.1-2.5,67.7c0,3.7,1.2,5.4,5.1,5.4c4.1,0.1,5-1.9,5-5.5C1045,969.3,1045.1,958.7,1045.1,948
+		z M741.9,740.1c-4.9,5.5-6.3,11-8.3,16.2c-0.8,2-0.8,4,1.2,5.3c6.2,4.1,11.6,9.4,19.7,13C751.6,762.1,748.8,750.9,741.9,740.1z
+		 M1931.7,1241.3c11.7-16.6,11.5-18.2-3-28.3c-2.7-1.9-4.9-4.5-9.1-4.9C1921.9,1219.6,1924.7,1230.7,1931.7,1241.3z M1931.6,740
+		c-6.6,10.9-9.8,22-12.1,33.9c4-0.9,6.1-3.1,8.5-4.8C1943.5,758.3,1943.6,757.2,1931.6,740z M742.1,1241.3
+		c6.6-11.1,9.8-21.9,12.2-34.3c-8,3.6-13.2,8.8-19.2,12.6c-2,1.3-2.3,3.1-1.6,5.1C735.6,1230.2,736.7,1236.2,742.1,1241.3z
+		 M597.6,1464.4c16.9-6.5,17.3-8.9,14-24.4C605.8,1447.2,601.7,1455,597.6,1464.4z M2061.5,1442.5c-5.1,14.3,5.6,17.3,12.5,22.8
+		C2072.1,1457,2066.2,1451,2061.5,1442.5z M1781.6,836.9c-1,5.2-3.6,8.5-1.8,12.6C1785.7,846.2,1785.7,846.2,1781.6,836.9z
+		 M895.4,849.3c-1.5-4.5-1.6-7.9-3.8-11.1C887.9,846.3,887.9,846.3,895.4,849.3z M630.1,1284.6c-0.4-5.3,4.1-10.2,1.8-17
+		C627.4,1273.6,629.9,1279.2,630.1,1284.6z M629.9,697.1c0.2,5.4-3,11.4,2.4,16.6C633.8,707.4,630.4,702.5,629.9,697.1z
+		 M2044.5,1284.5c-1-5.2,1.5-10.3-2.8-15C2040.3,1275.4,2042.4,1279.6,2044.5,1284.5z M2041.9,712.1c4.1-4.8,1.6-10,2.2-14.6
+		C2043,702.1,2039.8,706.2,2041.9,712.1z M892.2,1143.9c0.4-4.2,3.5-7.3,1.6-11.5C887.6,1136,887.6,1136,892.2,1143.9z
+		 M1779.6,1132.2c-1,2.9-0.4,4.8,0.4,6.5c0.7,1.5,0.4,3.6,2.3,4.6C1785.7,1135.3,1785.7,1135.3,1779.6,1132.2z M729.5,774
+		c1.5,1.6,2.6,4,5.8,3.2C733.9,774.7,732.2,773.5,729.5,774z M737.9,778.4c-0.2,0.2-0.5,0.4-0.7,0.6c0.2,0.2,0.4,0.6,0.6,0.6
+		c0.2,0,0.5-0.3,0.7-0.5C738.4,778.8,738.1,778.6,737.9,778.4z"/>
+	<path class="st1" d="M534.9,1353.5c4.5,11.6,7.4,22.2,12.2,32c4.7,9.6,9.8,18.8,17.1,26.8c10.6,11.6,28.8,15.5,42.7,2.9
+		c1.4-1.3,3.1-2.4,5.5-4.2c1.4,7.2,1.7,13.2-2.5,19.1c-8.4,11.7-14.8,24.4-20.8,37.4c-1.7,3.7-3.7,6.7-7.3,9.1
+		c-52.7,33.7-105.3,67.6-158,101.4c-1.1,0.7-2.1,1.7-4.1,1.1c0-195.1,0-390.4,0-585.6c2.1-1.2,4.1-0.9,6-0.8
+		c21.6,0.5,43.3,1.1,64.9,1.3c5.3,0,6.7,1.8,6.7,6.9c0.5,40,1.4,79.9,3.9,119.8c2.4,38.2,5.6,76.4,10.6,114.3
+		c4.6,34.7,10.1,69.1,19.2,103c1.1,4,0.6,7.1-2.3,10c-0.9,0.9-1.7,2.1-2.6,3.1c-22.1,25.1-40.6,52.7-57.5,81.5
+		c-11.6,19.7-19.9,41-28.9,61.9c14.9-23.9,25.7-50.1,41.8-73.5C497.6,1397.6,514.9,1375.3,534.9,1353.5z"/>
+	<path class="st1" d="M534.6,627.2c-40-41.2-69.6-89-94.2-140.1c0.7,6.2,4,11.2,6.2,16.6c12.7,31.7,30.5,60.6,49.6,88.7
+		c9.3,13.7,20.4,26.3,31,39.1c3.8,4.5,5,8.7,3.4,14.4c-9.6,35.4-15,71.6-19.6,107.9c-9.4,74.5-12.5,149.3-13.7,224.3c0,1-0.1,2,0,3
+		c0.6,4.7-1.2,6.5-6.1,6.4c-8.3-0.2-16.7,0.2-25,0.4c-13.7,0.3-27.3,0.4-41,1c-4.8,0.2-6.8-1.2-6.2-6.1c0.3-2,0-4,0-6
+		c0-187.9,0-375.8,0-563.7c0-3.5,0-7.1,0-10.7c4.2-0.1,6.3,2.3,8.7,3.9c50.4,32.4,100.8,64.9,151.3,97.1c5,3.2,8.4,7.1,10.8,12.4
+		c5.1,11.2,10.4,22.4,17.8,32.3c4.9,6.6,6.7,13.5,5.1,21.9c-3.6-0.1-5.6-3.1-7.9-5c-12-9.8-28.1-7.7-38.9,2.8
+		c-12.6,12.2-19,27.9-25.2,43.7C538.8,616.5,538.2,622.2,534.6,627.2z"/>
+	<path class="st1" d="M2060.9,1411.1c7.4,4.3,12.3,10.3,20.6,11.4c9.8,1.4,17.7-1.4,24.8-7.5c8.5-7.3,13.9-16.9,18.8-26.8
+		c5.1-10.4,8.6-21.5,12.7-32.5c24.7,24.7,73.3,78.9,107.2,169.7c-1.1-8.8-3.5-17.2-6.8-25.4c-13.2-33.9-29.3-66.4-49.3-96.8
+		c-12.8-19.5-27.4-37.7-42.4-55.5c-3.4-4-4.8-7.1-3.5-12.3c12.8-48.8,19.1-98.6,24-148.7c5.9-59.7,8.4-119.6,8.9-179.7
+		c0-1.3,0-2.7,0.1-4c0.2-7,0.2-7.1,7-7.4c20-0.7,40-1.3,60-1.9c2.3-0.1,4.7,0,7-0.1c3.5-0.2,4.8,1.4,4.6,4.8c-0.1,2,0,4,0,6
+		c0,188.3,0,376.6,0,565c0,3.2,0,6.4,0,9.8c-4.5-0.2-6.9-2.8-9.5-4.5c-47.7-30.6-95.2-61.4-143-91.7c-9-5.7-16-11.6-19.9-22.4
+		c-3.7-10.1-11.2-18.9-17.1-28.2C2060.8,1426.2,2058.6,1419.6,2060.9,1411.1z"/>
+	<path class="st1" d="M2244.8,454.3c-23,66.2-59.6,121.8-106.6,172.4c-4.5-11.6-7.7-22.6-12.8-32.9c-4-8.1-8.4-15.8-14.4-22.7
+		c-12.6-14.4-29.9-17.7-45.6-3.8c-1.1,1-2,2.7-4.6,2.6c-1.4-5.5-1.1-10.5,2-15.7c8.8-14.9,18.9-29,25.8-45c1-2.3,2.7-3.7,4.7-4.9
+		c52.7-33.9,105.3-67.7,158-101.5c0.5-0.3,1.3-0.2,2.1-0.4c2.3,2.1,1.2,4.9,1.2,7.3c0.1,189.6,0.1,379.3,0.1,568.9
+		c0,1.7-0.1,3.3,0,5c0.2,3.6-1.7,4.6-4.9,4.5c-5-0.2-10-0.3-15-0.5c-17-0.5-34-1-51-1.4c-7.4-0.2-7.5-0.2-7.6-7.8
+		c-0.5-35.3-1.1-70.6-3.1-105.9c-2.6-45.9-6.4-91.7-12.8-137.3c-4.2-30.3-9.4-60.5-17.3-90.2c-1.1-4-0.2-6.6,2.5-9.8
+		c27.4-31.6,51.5-65.6,70.4-102.8c11.3-22.2,21.7-44.9,28.2-69.2C2244.6,460.9,2245.4,458.8,2244.8,454.3z"/>
+	<path class="st1" d="M553.7,662.8c3.8,0.2,5.2,2.8,6.9,4.6c14.5,15.2,30.3,29,46.9,41.9c4.1,3.2,5.8,6.4,5.8,11.7
+		c-0.2,85.6-0.1,171.2-0.1,256.8c0,7.5-0.1,7.7-7.6,7.8c-25,0.4-50,0.6-74.9,1.1c-4.3,0.1-5.9-1.2-5.7-5.6c0.4-13,0.2-26,0.5-39
+		c1.5-60.3,4.7-120.5,11.8-180.4c3.7-31.7,8.3-63.3,15.4-94.5C553,665.6,553.4,664.1,553.7,662.8z"/>
+	<path class="st1" d="M553.6,1319.7c-22.4-107.4-27.4-215.3-28.7-323.3c3.3-2.5,6.4-1.5,9.3-1.5c23.3,0.3,46.7,0.7,70,1.1
+		c9.5,0.1,9.2-1.2,9.2,9.2c0,72.3,0,144.7,0,217c0,13.3-0.1,26.7,0.1,40c0,3.6-0.7,6.2-3.8,8.6c-18.7,14.5-36.3,30.3-52.7,47.4
+		C556.3,1318.5,555.6,1318.7,553.6,1319.7z"/>
+	<path class="st1" d="M2119.8,1319.2c-6.7-6.5-12.1-12.3-18-17.5c-11.8-10.2-23.8-20.2-36-30.1c-4.2-3.4-5.9-7.1-5.9-12.7
+		c0.2-84.6,0.1-169.1,0.1-253.7c0-8.4,0.1-8.5,8-8.5c24.3-0.2,48.6-0.4,72.9-0.5c7.5,0,7.7,0,7.6,7.7c-0.3,45.6-1.9,91.2-5.1,136.7
+		c-2.7,39.9-6.7,79.6-12.5,119.1C2128.1,1279,2124.6,1298.3,2119.8,1319.2z"/>
+	<path class="st1" d="M2120.4,664.4c12.3,57.5,18.7,115.7,22.8,174.2c3.1,44.9,4.7,89.8,5.2,134.8c0,2.3-0.1,4.7,0.1,7
+		c0.3,4-1.7,5.2-5.4,5.1c-6.7-0.2-13.3-0.3-20-0.3c-18.3-0.1-36.7-0.2-55-0.4c-8-0.1-8.2-0.1-8.2-8.2c0-52.3,0-104.6,0-157
+		c0-32,0.2-64-0.2-96c-0.1-6.3,2-10.3,6.8-14.3c17.1-14.3,35.1-27.7,50.2-44.2C2117.5,664.3,2118.3,663.8,2120.4,664.4z"/>
+	<path class="st1" d="M878.7,1138.5c2,4.9,3.2,9.1,5.3,12.8c4,7.2,10.5,7.1,14.6,0c3-5.3,4.3-11.2,5.2-17.1c0.8-4.7,3.2-7.1,7.8-8.9
+		c37.6-14.8,76.3-25.6,115.5-34.7c5-1.1,6.6,0.4,7.3,4.9c0.6,3.5,0.7,8.4,5.3,8.5c5.3,0.1,5.5-5.2,5.8-9c0.5-7.1,3.9-10,10.9-11.2
+		c40-7,79.8-14.9,120.4-18c2.4-0.2,5.9-2.1,6.9,1.5c1,3.7,1.8,7.8,0.4,11.7c-0.7,1.8-2.9,1.2-4.4,1.5c-9.5,1.6-19.1,2.8-28.6,4.6
+		c-39.6,7.4-78.6,17-117,29.2c-59.9,19-116.5,45.2-170.8,76.4c-41.6,24-80.2,52.3-117.2,83.1c-39.4,32.8-74.3,69.6-105.4,110.2
+		c-3,3.9-6.2,7.7-9.4,11.6c-0.1,0.2-0.6,0.2-2.1,0.5c0.2-7-1.1-13.6,1.5-20.3c7.6-19.2,12.9-39.2,16.7-59.5
+		c1.8-9.6,6.2-17.5,12-24.8c17.2-21.7,36.5-41.5,58.8-58.9c3.4,2.2,3.5,6.6,5.4,9.8c4,7,7.8,14.4,17.4,14.4
+		c9.6,0,13.8-7.2,17.3-14.4c6.5-13.3,9.4-27.7,12.2-42c0.8-3.9,2.2-6.5,5.7-8.6C808.9,1171.4,842.7,1153.5,878.7,1138.5z"/>
+	<path class="st1" d="M1032.8,891.9c-42-9-82.2-20.4-121.3-35.7c-4.8-1.9-6.9-4.4-7.7-9c-0.9-5.6-2.3-11.1-4.8-16.2
+		c-1.5-3.2-3.7-5.9-7.3-6.1c-4.1-0.2-6.8,2.5-8.3,6.1c-1.6,3.6-2.8,7.4-4.7,12.2c-11.4-5.2-22.6-10-33.5-15.2
+		c-23.1-11.1-45.4-23.7-67.3-37.1c-4.3-2.6-6.6-5.5-7.5-10.7c-2.1-11.4-4.6-22.8-8.9-33.7c-2.1-5.3-4.2-10.5-7.8-15
+		c-7.6-9.4-17.5-9.4-25.3,0.1c-4.2,5.2-6,11.7-9.8,18.2c-11.1-9.9-22.3-18.8-32.2-28.9c-10.2-10.4-19.5-21.8-28.7-33.3
+		c-5.6-7-8.9-15.3-10.6-24.4c-3.7-19.3-8.6-38.3-16-56.5c-2.9-7.1-1.4-14.1-0.5-21.8c3.9,4.8,7.9,9.4,11.6,14.3
+		c23.7,32,51,60.7,80.1,87.7c19,17.6,39.4,33.9,59.9,49.7c45,34.7,93.8,63.3,144.7,87.9c39.2,18.9,79.8,34.7,121.6,47.1
+		c41.2,12.2,82.8,22.3,125.4,28.2c1,0.1,2,0.2,3,0.4c7.3,1.2,10.5,7.7,7,14.2c-1.3,2.3-3.4,1.7-5.3,1.6c-8-0.7-15.9-1.5-23.8-2.4
+		c-32.8-3.7-65.1-10.2-97.5-15.7c-7.1-1.2-11.5-3.9-11.7-11.6c0-1.3-0.4-2.6-0.8-3.9c-0.8-2.6-1.9-5.3-5.3-4.9
+		c-2.7,0.3-3.7,2.6-4.4,4.9C1034.4,885.3,1033.7,888.2,1032.8,891.9z"/>
+	<path class="st1" d="M1953.8,1233.7c3.8,1,5.8,3.4,8,5.3c21,19.1,40.7,39.4,57.6,62.2c3,4.1,4.9,8.4,6,13.5
+		c4.5,20.5,9.3,40.9,17.1,60.4c1.3,3.1,2.4,6.3,1.8,9.7c-0.6,3.6,2.4,8.9-2.1,10.4c-2.5,0.8-5.4-3.9-7.3-6.7
+		c-35.7-51.5-81-93.6-129.4-132.6c-40.8-32.9-84.7-61.2-131-85.6c-39.5-20.8-80.6-37.9-123-52c-45.9-15.2-92.6-26.8-140.3-34.3
+		c-6.2-1-12.4-2.7-18.7-3.1c-6.5-0.4-5.5-4.5-5.2-8.4c0.4-5.4,2.1-7.1,7.5-6.6c8.3,0.7,16.5,1.9,24.8,2.7
+		c33.2,3.4,65.8,10.1,98.6,15.7c6.3,1.1,9.2,3.4,9.6,10c0.2,3.6,0.3,9.3,5.3,9.6c6,0.4,5.5-5.6,6.3-9.5c0.7-3.9,2.4-5,6.2-4
+		c39.4,9.7,78.9,19.2,116.7,34.3c4.5,1.8,6.8,4.2,7.5,9.1c0.9,5.9,2.2,11.8,5.1,17.2c1.7,3.1,3.8,5.6,7.6,5.6c3.8,0,6-2.5,7.6-5.6
+		c0.9-1.8,1.7-3.6,2.3-5.5c2.8-7.7,2.9-7.9,9.9-4.7c32.6,15.3,64.6,31.4,95,50.8c3.4,2.2,5.1,4.7,5.8,8.6
+		c2.1,12.1,4.9,24.1,9.4,35.7c1.9,5,4.1,9.8,7.5,14c7.5,9.4,17.7,9.4,25.3,0C1948.9,1245.3,1950.9,1239.5,1953.8,1233.7z"/>
+	<path class="st1" d="M2043.6,585.1c0.9,7.5,1.7,14.1-0.8,20.4c-8,20.2-13.1,41.2-17.6,62.4c-0.9,4.4-2.6,8.3-5.2,11.7
+		c-17.8,23.8-38.4,45.2-60.6,64.9c-1.5,1.3-3.2,2.3-5.1,3.8c-2.9-5.3-5.1-10.4-8.2-14.9c-8-11.8-19.3-11.8-27.5-0.1
+		c-7.4,10.6-11.4,23-12.8,35.4c-1.7,14.6-9.4,22.2-21.3,29.3c-25.5,15.2-52.1,28.1-78.7,41.2c-2.4,1.2-5,2-7.3,3.1
+		c-2.7,1.3-4.3,0.7-5.2-2.2c-1-3.2-1.9-6.4-3.4-9.3c-4.2-7.7-10.8-7.7-15.1-0.1c-2.5,4.4-3.9,9.3-4.5,14.2c-0.8,7-4.2,10.7-11,13.3
+		c-27.5,10.2-55.4,18.9-83.9,25.7c-10,2.4-20.1,4.8-30,7.5c-3.8,1-5.4,0-6.1-3.9c-0.7-4-0.2-9.9-6.2-9.6c-5.1,0.2-5.3,6-5.4,9.5
+		c-0.1,7.5-4.3,9-10.5,10.2c-39.6,7.4-79.4,13.9-119.5,18.1c-2.8,0.3-6.7,2.3-8.1-1.3c-1.4-3.6-1.7-7.9-0.3-11.7
+		c0.9-2.4,3.9-2,6.2-2.4c13.8-2.4,27.6-4.4,41.3-7c42.1-8.2,83.5-19.3,124.2-33.1c57.6-19.6,112.2-45.7,163.9-77.3
+		c38.1-23.2,73.8-50.1,107.6-79.4c37.9-32.8,72.6-68.6,102.5-109C2037.5,591.3,2039.4,587.8,2043.6,585.1z"/>
+	<path class="st1" d="M777.2,1163.8c-0.9-7.9,1.2-15.4,2-23c4.4-45.1,6.3-90.3,6.6-135.6c0.1-8.6,0.2-8.7,8.8-8.7
+		c22-0.1,44-0.1,65.9,0c8.3,0,8.4,0.1,8.5,7.9c0.2,37.7,2,75.2,6.5,112.6c0.5,3.8,0.3,6-3.9,7.5c-31.7,11.3-62.2,25.3-92.6,39.6
+		C778.8,1164.3,778.4,1164.1,777.2,1163.8z"/>
+	<path class="st1" d="M776.8,817.8c3.1-0.6,4.7,0.6,6.5,1.4c28.2,13.5,56.6,26.5,86.2,36.8c5.4,1.9,6.7,4.3,6,10.1
+		c-4.5,36.7-6.3,73.6-6.4,110.6c0,8.1,0.7,8.3-8.1,8.3c-22.6-0.1-45.3,0-67.9-0.1c-7,0-7.1-0.2-7.2-7.3c-0.4-28.6-0.9-57.3-2.7-85.9
+		c-1.3-21.3-2.9-42.5-5.5-63.7C777.2,824.9,777.1,821.6,776.8,817.8z"/>
+	<path class="st1" d="M1896.4,1163.9c-3.3,0.5-5.7-1.5-8.4-2.8c-27.2-13.3-54.8-25.7-83.3-36.1c-7.4-2.7-7.2-2.9-6.3-10.6
+		c4.4-35.8,5.3-71.8,6.4-107.7c0.1-1.7,0.1-3.3,0-5c-0.3-3.8,1.3-5.4,5.2-5.3c6.3,0.2,12.7,0.1,19,0.1c16.7,0,33.3,0,50,0.1
+		c8.4,0,8.4,0.1,8.6,8.8c0.8,30.3,1.2,60.6,3.3,90.9c1.4,19.9,2.9,39.9,5.3,59.7C1896.5,1158.6,1897.4,1161.2,1896.4,1163.9z"/>
+	<path class="st1" d="M1896.8,817.7c-1.3,13.9-2.7,27.7-3.9,41.6c-3.5,38.5-4.5,77-5.2,115.6c0,1.7-0.2,3.3-0.1,5
+		c0.4,4-1.5,5.5-5.2,5.1c-1-0.1-2,0-3,0c-22.6,0-45.3-0.1-67.9,0.2c-5,0-6.8-1.2-6.8-6.6c-0.4-28.3-1.2-56.5-3.6-84.7
+		c-0.8-8.9-1.6-17.9-2.7-26.8c-0.9-7.6-1.1-7.8,6.5-10.6c23-8.7,45.8-17.8,67.9-28.7c6-2.9,12-5.7,18-8.6
+		C1892.5,818.3,1894.3,817.4,1896.8,817.7z"/>
+	<path class="st1" d="M908.3,1109.6c-1-4.4,0.4-8.6,0.8-12.8c2.5-30.9,4-61.8,4-92.9c0-7.4,0.2-7.5,7.9-7.5
+		c33.3-0.1,66.7-0.2,100-0.2c7.8,0,8.1,0.1,8,7.4c-0.3,22,1,44,2.3,65.9c0.3,4.5-1,6.5-5.5,7.4c-38.7,8.5-76.4,20.9-114.2,32.5
+		C910.7,1109.8,909.7,1109.6,908.3,1109.6z"/>
+	<path class="st1" d="M1765.3,1110.4c-9.6-3-18.1-5.6-26.6-8.4c-29.1-9.6-58.7-17.4-88.5-24.5c-8.9-2.1-8.1-1.4-7.6-10.4
+		c1.2-21,1.6-42,2.3-62.9c0.2-7.7,0.2-7.9,7.5-7.9c33.3,0,66.7,0.1,100,0.2c7.8,0,8.2,0.3,8.2,7.7c0.2,34,1.7,68,4.8,101.8
+		C1765.4,1106.9,1765.3,1107.9,1765.3,1110.4z"/>
+	<path class="st1" d="M908.8,872.2c2.8-1.1,5,0.8,7.5,1.5c36.1,10.3,71.6,22.9,108.5,30.5c5.5,1.1,6.7,3.6,6.4,8.8
+		c-1.3,21.9-2.6,43.9-2.1,65.9c0.1,4.7-1.2,6.5-6.1,6.4c-34.7-0.2-69.3-0.2-104-0.1c-4.1,0-6.1-1-6-5.6c0.4-35.6-2-71.2-4.8-106.7
+		C908.2,872.8,908.6,872.5,908.8,872.2z"/>
+	<path class="st1" d="M1765.6,872.4c-0.9,10.7-1.8,20.9-2.5,31.2c-1.7,24.6-2.4,49.2-2.6,73.8c-0.1,7.7-0.2,7.8-7.7,7.8
+		c-33.6,0.1-67.2,0.1-100.8,0.1c-6.9,0-6.9-0.2-7.1-7.1c-0.8-21.9-1.3-43.9-2.6-65.8c-0.3-5.4,1.8-7,6.2-8
+		c14.5-3.5,29-7.1,43.5-10.8c22.5-5.7,44.5-13.5,66.7-20.3C1760.5,872.7,1762.3,871.8,1765.6,872.4z"/>
+	<path class="st1" d="M725.8,1192.5c-5.9-34.3-8.8-67.4-11-100.6c-1.8-27.6-2.2-55.2-3-82.8c-0.1-2.3,0.1-4.7-0.1-7
+		c-0.4-4.4,1.6-5.8,5.9-5.7c9,0.2,18,0,27,0c6.7,0,13.3-0.1,20,0c7.2,0.1,7.4,0.2,7.3,7.1c-0.5,23.6-1,47.2-2,70.8
+		c-1.2,27.2-3.3,54.4-6.7,81.5c-0.2,1.3-0.3,2.6-0.4,4c-0.4,9.2-3.4,16-13,19.7C741.7,1182.7,734.5,1187.7,725.8,1192.5z"/>
+	<path class="st1" d="M1946.2,1191.7c-10.1-5.6-20.4-11.5-30.8-17.2c-3.3-1.8-3.1-5-3.5-7.8c-1.4-10.2-2.4-20.5-3.5-30.7
+		c-4.7-43.8-6-87.7-6.7-131.6c-0.1-7.7,0.1-7.8,7.7-7.8c15.3-0.1,30.6,0.1,46-0.1c4.6-0.1,6.5,1.1,6.4,6.1
+		c-0.5,34-1.2,67.9-3.7,101.8c-2,26.9-4.5,53.7-8.9,80.4C1948.7,1187,1949.1,1189.5,1946.2,1191.7z"/>
+	<path class="st1" d="M1947.7,789.1c5.8,32.7,8.6,63.8,10.8,95c2.1,30.6,2.8,61.2,3.1,91.9c0.1,9.6,0.3,8.9-8.3,8.9
+		c-15,0-30-0.1-45,0.2c-5.3,0.1-6.9-1.8-6.7-7c0.9-25.3,1.3-50.6,2.5-75.9c1.3-27.3,3.9-54.4,6.9-81.6c0.9-8.3,3.3-14.2,11.5-17.8
+		C1930.8,799.2,1938.6,794.1,1947.7,789.1z"/>
+	<path class="st1" d="M726,789.2c11.3,6.2,21.7,11.9,32.2,17.5c2.9,1.6,2.8,4.2,3.2,6.8c2.7,15.8,4.1,31.7,5.5,47.6
+		c3.3,37.2,4.5,74.5,5,111.8c0,2.3,0,4.7,0.1,7c0.1,3.1-0.8,5-4.4,5c-17-0.1-34-0.1-51-0.1c-3.3,0-4.8-1.5-4.7-4.8
+		c0.2-5.7,0-11.3,0.2-17c1-42.6,2.7-85.2,7.3-127.7C720.9,820.5,722.6,805.7,726,789.2z"/>
+	<path class="st1" d="M1625.1,910.5c-0.6,9.4-1.4,18-1.7,26.5c-0.4,13-0.4,26-0.6,38.9c-0.1,9.3-0.2,9.4-9.2,9.4
+		c-30.6,0.1-61.3,0.1-91.9,0.1c-8.3,0-16.7-0.1-25,0.1c-4.2,0.1-5.9-1.3-5.9-5.7c0-15-0.1-30-0.7-44.9c-0.2-4.8,2.5-5.5,6-6
+		c10.9-1.3,21.8-3.6,32.7-3.7c23.9-0.2,46.7-6.5,70-10C1607.1,913.9,1615.2,912.2,1625.1,910.5z"/>
+	<path class="st1" d="M1625.2,1071.1c-23.5-4.2-45.7-8.1-67.9-12.1c-7.9-1.4-15.8-2.4-23.8-2.5c-12.7-0.1-25.1-2.6-37.7-4
+		c-4-0.4-5.8-1.6-5.6-6.1c0.5-14.6,0.6-29.3,0.6-43.9c0-4.5,1-6.5,6.1-6.5c39.9,0.2,79.9,0.2,119.8,0.1c5,0,6.1,2.1,6.1,6.6
+		C1622.9,1025,1623,1047.3,1625.2,1071.1z"/>
+	<path class="st1" d="M1049.3,1070.4c-1-5.9-0.1-11.8,0.3-17.7c0.9-16.3,1.4-32.6,1.4-48.9c0-7.3,0.2-7.5,6.8-7.5
+		c39.3-0.1,78.5-0.1,117.8-0.1c7,0,7.1,0.2,7.2,7.2c0.2,14,0,27.9,0.5,41.9c0.2,5.2-1.5,6.6-6.6,7c-16.9,1.3-33.8,2.7-50.6,5.2
+		c-23.3,3.4-46.7,6.8-69.7,12.3C1054.2,1070.3,1051.9,1071.4,1049.3,1070.4z"/>
+	<path class="st1" d="M1049.8,910.2c22.1,5.7,44.8,8.7,67.4,12.5c16.4,2.8,33.1,3.3,49.6,5.2c16.4,1.9,16.4,1.5,16.3,17.4
+		c-0.1,11-0.3,22-0.2,32.9c0.1,4.9-1,7.2-6.6,7.2c-39.9-0.2-79.9-0.2-119.8-0.1c-3.4,0-5.7-0.6-5.6-4.8c0.6-22.6-1.3-45.2-1.9-67.8
+		C1049,912,1049.4,911.4,1049.8,910.2z"/>
+	<path class="st1" d="M1260.5,985.4c-21.6,0-43.2,0-64.9,0c-8,0-8.2-0.1-8.1-8.4c0.2-13.6,0.6-27.3,0.8-40.9c0.1-4.2,1.4-5.6,6-5.1
+		c41.7,4.1,83.5,6.2,125.5,6.2c2.3,0,4.7,0,7,0c7.5,0.2,7.5,0.2,7.6,7.9c0.1,10.3,0.1,20.6,0.1,30.9c0,9.3,0,9.4-9.1,9.4
+		C1303.8,985.4,1282.2,985.4,1260.5,985.4z"/>
+	<path class="st1" d="M1485,931.5c0.3,16.2,0.5,32.7,0.8,49.3c0.1,3.4-1.7,4.8-4.9,4.6c-2-0.1-4,0-6,0c-41.6,0-83.2,0-124.9,0
+		c-2,0-4-0.1-6,0c-4,0.3-5.1-1.8-5-5.5c0.1-11.7,0-23.3,0.1-35c0.1-7.6,0.1-7.8,7.6-7.8c17.3,0.2,34.6-0.6,51.9-1.1
+		c26.3-0.7,52.5-3.1,78.7-5.1C1479.6,930.9,1481.8,930,1485,931.5z"/>
+	<path class="st1" d="M1485,1051.1c-35.4-3-69.9-5.3-104.5-6.4c-11.6-0.4-23.3-0.5-34.9-0.4c-4.4,0-6.7-0.8-6.5-6
+		c0.4-12,0.3-24,0-36c-0.1-4.8,1.6-6.3,6.3-6.2c45,0.1,89.9,0.1,134.9,0c3.5,0,5.8,0.7,5.7,4.8
+		C1485.5,1017.5,1485.3,1034.1,1485,1051.1z"/>
+	<path class="st1" d="M1188.4,1050.6c-0.3-17.2-0.5-33.7-0.8-50.3c0-2.9,1.6-4.1,4.4-4.1c1.7,0,3.3,0,5,0c42.6,0,85.1,0,127.7,0
+		c1.7,0,3.3,0.1,5,0c3.3-0.2,4.9,1.2,4.9,4.6c-0.1,13-0.1,25.9,0,38.9c0,3.6-1.7,4.7-4.9,4.5c-0.7,0-1.3,0-2,0
+		C1281.6,1043.7,1235.9,1047.2,1188.4,1050.6z"/>
+	<path class="st1" d="M2010.7,1230.1c-5.1-1.9-9-5.1-13.1-7.7c-9.9-6.1-19.6-12.6-29.8-18.3c-4.8-2.6-5.5-5.6-4.5-10.4
+		c3.9-20,6.2-40.1,8.2-60.4c4-41.2,5.8-82.4,6.1-123.8c0-3,0.1-6,0-9c-0.1-3,1.1-3.8,4.1-4.1c16.5-1.5,16.7-1.4,16.8,14.7
+		c0.4,66.4,3.9,132.5,10.7,198.6C2009.9,1216.3,2011.6,1222.7,2010.7,1230.1z"/>
+	<path class="st1" d="M2011.2,752.5c-1.6,16.9-3.2,33.8-4.8,50.6c-3,30.8-4.6,61.7-6.1,92.6c-1.3,27.3-1.5,54.5-1.8,81.8
+		c-0.1,7.1-0.2,7.3-7.1,7.3c-16.3,0-13.6,1.3-13.7-12.8c-0.5-54.3-3.2-108.4-10.6-162.2c-1.1-7.9-2.5-15.8-3.9-23.6
+		c-0.7-3.6-0.1-6,3.5-8.2c13.4-8,26.6-16.4,39.8-24.7C2007.6,752.8,2008.5,751.7,2011.2,752.5z"/>
+	<path class="st1" d="M662.1,1231.5c1.9-20.4,3.7-38.6,5.4-56.8c3-31.9,4.7-63.8,6-95.8c1-24.6,1.6-49.3,1.6-74
+		c0-8.3,0.1-8.3,7.9-8.4c1.3,0,2.7,0,4,0c8.6,0.1,8.7,0.1,8.8,8.7c0.4,40,1.8,80,5.4,119.8c2,22.9,4.4,45.8,9,68.3
+		c1.1,5.5,0.2,8.5-5.1,11c-12.7,6-23.9,14.5-35.5,22.2C667.7,1227.9,665.8,1229.1,662.1,1231.5z"/>
+	<path class="st1" d="M662.9,752.1c2.6-0.9,3.9,1,5.4,2.1c12.4,8.4,24.6,17.1,38,23.9c3.3,1.7,5,3.6,4.2,7.7
+		c-11.3,61.8-13.7,124.4-14.8,187c-0.2,13.5,2.2,12.1-12.3,12.1c-8.4,0-8.5-0.1-8.5-8.9c0.1-52.7-2.6-105.3-6.4-157.8
+		c-1.5-20.6-4-41.1-6-61.7C662.5,755.1,661.9,753.4,662.9,752.1z"/>
+	<path class="st1" d="M2044.3,728.6c0,3.4,0,6.3,0,9.2c0,78.9,0,157.9,0,236.8c0,1.7-0.1,3.3,0,5c0.4,3.9-1.3,5.4-5.2,5.3
+		c-5.9-0.2-11.9,0-18.3,0c0-26.3,0.3-51.6,1.3-76.8c1.7-42.3,4.4-84.5,8.9-126.5c1.6-14.9,3.9-29.7,5.6-44.6
+		C2037.2,732.4,2038.9,729.7,2044.3,728.6z"/>
+	<path class="st1" d="M2044.3,1253c-5.6-1.2-7-4.1-7.7-8.6c-3.1-19.4-5.2-38.9-7-58.5c-5.6-59-8.7-118.2-8.7-177.6
+		c0-13.6-1.4-11.7,11.5-11.8c13.3,0,11.9-1.5,11.9,11.5c0,78.6,0,157.2,0,235.8C2044.3,1246.6,2044.3,1249.3,2044.3,1253z"/>
+	<path class="st1" d="M629.2,728.7c5.8,1.6,7.4,4.6,7.9,9c2.3,21.2,5.3,42.2,7.3,63.4c5.3,55.3,7.7,110.8,8.5,166.4
+		c0,3.3,0.1,6.7,0,10c-0.1,7.5-0.1,7.5-7.7,7.7c-16,0.5-16,0.5-16-15.3c0-76.5,0-153.1,0-229.6C629.2,736.7,629.2,733,629.2,728.7z"
+		/>
+	<path class="st1" d="M629.2,1253.2c0-6,0-10.6,0-15.3c0-75.7,0-151.3,0-227c0-2,0-4,0-6c-0.1-9.2-0.3-8.7,8.7-8.6
+		c15.1,0,15.2,0,15,15.6c-0.7,62.7-3.8,125.2-10.3,187.6c-1.5,14.9-3.9,29.7-5.5,44.6C636.6,1248.7,634.5,1251.1,629.2,1253.2z"/>
+	<path class="st1" d="M2060,697.5c0-15.9,0-29.5,0-43c0-3.7,0.3-7.3-0.1-11c-2-19,6.4-34.8,15.3-50.5c1-1.7,2.3-3.2,3.6-4.7
+		c5.4-6.2,8.1-6.2,13.4,0.4c6.3,7.8,10.3,17.1,13.7,26.4c3.2,8.7,5.9,17.6,8.7,26.5c1.3,4,1,7.1-2.4,10.7
+		C2096.7,668.2,2079,681.6,2060,697.5z"/>
+	<path class="st1" d="M613.2,1283.1c0,24.5,1.5,47.6-0.5,70.3c-1.4,15.4-9,29.8-19.7,41.7c-3.8,4.2-5.7,3.9-10-0.4
+		c-4.3-4.3-7.2-9.6-9.8-15c-6.7-13.8-11.2-28.4-15.3-43.2c-0.8-3-1.3-5.6,1.5-8.1C576.3,1313,592.4,1296.7,613.2,1283.1z"/>
+	<path class="st1" d="M2060,1284.4c19.3,15.5,36.8,29.3,52.5,45.2c2.6,2.6,3.7,5.1,2.6,8.8c-5.1,17.2-10,34.5-19.7,50
+		c-7.7,12.2-12.4,12.7-19.8,0.6c-9.5-15.4-16.9-31.4-15.8-50.5C2060.7,1321.2,2060,1303.9,2060,1284.4z"/>
+	<path class="st1" d="M611.9,698.2c-8.5-6.7-17.1-12.8-25-19.7c-9.1-7.8-17.5-16.4-26.3-24.5c-2.3-2.2-4-4.1-3-7.7
+		c5.3-18.2,10.3-36.5,20.4-52.8c7.8-12.7,12.8-13,20.4-0.3c8.9,14.9,16.3,30.2,15.1,48.6c-1,15.9-0.2,31.9-0.3,47.9
+		C613.2,692.2,614,694.9,611.9,698.2z"/>
+	<path class="st1" d="M1788.2,864c4.1,27,4.9,53.5,6.1,80.1c0.5,11.3,0.2,22.6,0.7,33.9c0.2,5.2-1.6,7.4-6.7,7.3
+		c-4.7-0.1-9.3-0.3-14,0c-4.6,0.3-5.5-2-5.4-6c0.2-26.3,1.3-52.5,3.2-78.8c0.5-7.6,1.2-15.2,2.1-22.8
+		C1775.6,867.2,1775.7,867.2,1788.2,864z"/>
+	<path class="st1" d="M885.3,1118.4c-5.1-39.1-6.6-77.6-6.6-116.3c0-4.2,1.3-5.9,5.7-5.8c25,0.7,20.1-4.1,19.8,19.4
+		c-0.4,29.6-1.5,59.3-5,88.8C897.9,1115.4,898.1,1115.4,885.3,1118.4z"/>
+	<path class="st1" d="M885.7,863.5c12.4,2.1,12.2,2.1,13.5,13.8c3.8,33,4.6,66.2,5.3,99.4c0.2,8.3,0,8.5-7.9,8.4
+		c-5.6-0.1-12.6,2.4-16.3-1.2c-3.8-3.6-1.3-10.7-1.3-16.2c0.1-33.9,1.8-67.7,6.1-101.4C885.1,865.4,885.4,864.5,885.7,863.5z"/>
+	<path class="st1" d="M1788.4,1117.5c-4,0.3-6.2-1.5-8.7-2.2c-3.2-0.9-4.6-2.9-4.9-6.5c-0.7-10.3-2.2-20.5-2.9-30.8
+		c-1.5-24.6-2.8-49.2-2.8-73.9c0-7.5,0.1-7.8,7.7-7.6c5.9,0.2,13.3-2.7,17.2,1.6c3.4,3.7,1,10.9,0.9,16.5
+		C1794.3,1048.8,1792.8,1083.1,1788.4,1117.5z"/>
+	<path class="st1" d="M1481.1,1078.1c-10.7,0.3-20.5-1.5-30.3-2.6c-34.1-3.7-68.2-5.9-102.5-5.6c-1.3,0-2.7-0.1-4,0
+		c-4.9,0.5-5.1-2.5-5.2-6.2c-0.1-4,0.7-6,5.4-6c20,0.1,39.9-0.2,59.9,1c22.9,1.4,45.8,3,68.7,4.7c7.9,0.6,7.8,0.9,8.2,8.7
+		C1481.2,1073.7,1481.1,1075.4,1481.1,1078.1z"/>
+	<path class="st1" d="M1480,903c2,3.3,0.7,6.3,1,9.2c0.4,4.3-1.6,5.6-5.8,5.9c-42.2,3.3-84.3,6.2-126.7,5.9c-1.3,0-2.7-0.1-4,0
+		c-4.5,0.5-5.5-1.7-5.6-5.8c-0.1-4.5,0.9-6.6,6-6.5c29.7,0.7,59.2-1.5,88.8-3.9C1449.3,906.5,1464.7,904.6,1480,903z"/>
+	<path class="st1" d="M1192.2,1078.2c1-14.7,0.9-15,13.5-15.8c40.5-2.9,80.9-5.4,121.6-4.6c7.3,0.1,7.4,0.5,7.3,7
+		c-0.1,4-1.7,5.2-5.4,5.1c-6-0.2-12-0.1-18,0c-37.3,0.2-74.3,3.2-111.3,7.8C1197.6,1078,1195.3,1078,1192.2,1078.2z"/>
+	<path class="st1" d="M1192.6,903.2c17.2,2.2,33.7,3.8,50.2,5c28.2,2.1,56.4,4.4,84.7,3.6c3.8-0.1,7.3-0.4,7.1,5.4
+		c-0.3,6.3-0.2,6.8-6.6,6.8c-18.6,0-37.2,0.4-55.9-0.8c-19.2-1.2-38.5-2.1-57.8-3.2c-3-0.2-6-0.4-8.9-0.8
+		C1192.8,917.6,1192.8,917.6,1192.6,903.2z"/>
+	<path class="st1" d="M653.6,694.6c2.5,2.7,3.4,3.5,4.2,4.6c15.1,20.9,32.8,39.4,51.8,56.7c2.5,2.3,7.7,4.8,5,8.5
+		c-2.7,3.9-6.2-1-8.9-2.4c-14.7-7.8-28.1-17.9-42.2-26.6c-3.1-1.9-4.3-4.4-4.8-8C657.4,717,655.5,706.9,653.6,694.6z"/>
+	<path class="st1" d="M654,1284.6c0.9-5.5,2.7-11,2.6-16.4c-0.1-14.4,6.3-23.8,19.2-30.2c10.6-5.3,20.3-12.5,30.5-18.8
+		c2.5-1.5,4.9-3.3,7.8-3.6c1.6,2.1,1.5,4,0.2,5.7c-1,1.3-2.4,2.3-3.6,3.4c-18.4,17.3-36.5,34.8-51.2,55.5c-1.1,1.6-2.6,2.9-4,4.3
+		C655.3,1284.8,654.8,1284.6,654,1284.6z"/>
+	<path class="st1" d="M2019.1,698.8c-1.4,9.8-3,19.6-4.2,29.5c-0.4,3-2.2,4.7-4.4,6.2c-15.3,9.9-30.7,19.7-46.1,29.5
+		c-1.5,1-3.7,4-5.7,0.4c-1.5-2.6,0.2-4.4,2.1-5.9c11.9-9.2,21.5-20.7,32.4-30.8c8.4-7.7,14.5-17.2,21.4-26.1c0.9-1.2,2-2.4,3-3.6
+		C2018.1,698.2,2018.6,698.5,2019.1,698.8z"/>
+	<path class="st1" d="M2017.1,1283.9c-11.8-19.6-28.7-34.6-44.6-50.5c-3.7-3.7-7.8-7.2-11.8-10.6c-1.9-1.7-3.4-3.4-1.7-5.9
+		c1.7-2.4,3.5-0.5,5,0.5c15.7,10,31.3,20,46.9,30c2,1.3,3.5,2.9,3.9,5.4c1.4,10.1,2.9,20.2,4.4,30.4
+		C2018.5,1283.4,2017.8,1283.7,2017.1,1283.9z"/>
+	<path class="st1" d="M1044.6,1034c-0.6,11-1.1,21.9-1.7,32.9c-0.1,1.6-0.3,3.3-0.8,4.9c-0.3,0.8-1.4,1.6-2.2,1.7
+		c-0.9,0.1-1.9-0.5-2.1-1.7c-0.1-1-0.3-2-0.4-3c-1.2-22.2-2.3-44.5-2.4-66.8c0-3.2,0-6,4.6-5.9c3.5,0.1,5.6,0.7,5.5,4.9
+		c-0.2,11-0.1,21.9-0.1,32.9C1044.9,1034,1044.8,1034,1044.6,1034z"/>
+	<path class="st1" d="M1636.4,1033.8c0,10.6,0,21.2,0,31.8c0,2-0.3,4-0.7,5.9c-0.2,0.8-1.2,1.8-1.9,1.8c-0.8,0-1.9-0.8-2.2-1.5
+		c-0.5-1.2-0.5-2.6-0.6-3.9c-1.9-21.8-2.2-43.7-2.1-65.6c0-5.7,1.3-6.7,6-6.1c3.9,0.5,3.6,3.1,3.6,5.8c0,10.6,0,21.2,0,31.8
+		C1637.8,1033.8,1637.1,1033.8,1636.4,1033.8z"/>
+	<path class="st1" d="M1638.5,948.1c0,10.3,0,20.6,0,31c0,2.6,0.5,5.4-3.3,6.2c-4.4,0.9-6.4-0.5-6.4-5.8c0-19,0-38,1.4-56.9
+		c0.2-3,0.4-6,0.7-9c0.2-2.2-0.3-5.4,3-5.2c2.5,0.1,2.2,3,2.3,4.9c0.6,11.6,1.1,23.3,1.6,34.9C1638,948.1,1638.2,948.1,1638.5,948.1
+		z"/>
+	<path class="st1" d="M1045.1,948c0,10.6-0.1,21.2,0,31.9c0,3.6-0.9,5.5-5,5.5c-3.9-0.1-5.1-1.7-5.1-5.4c0.1-22.6,1.2-45.1,2.5-67.7
+		c0.1-1.6-0.1-3.7,2-4c2.8-0.4,3.1,1.9,3.2,3.9c0.7,11.9,1.3,23.9,1.9,35.8C1044.8,948,1044.9,948,1045.1,948z"/>
+	<path class="st1" d="M741.9,740.1c7,10.8,9.7,22,12.6,34.5c-8.1-3.6-13.5-8.9-19.7-13c-2-1.3-2-3.3-1.2-5.3
+		C735.6,751.1,737,745.6,741.9,740.1z"/>
+	<path class="st1" d="M1931.7,1241.3c-6.9-10.6-9.7-21.7-12.1-33.3c4.2,0.4,6.4,3.1,9.1,4.9
+		C1943.2,1223.1,1943.4,1224.7,1931.7,1241.3z"/>
+	<path class="st1" d="M1931.6,740c12,17.2,11.9,18.3-3.6,29.1c-2.4,1.7-4.5,3.9-8.5,4.8C1921.8,761.9,1925,750.9,1931.6,740z"/>
+	<path class="st1" d="M742.1,1241.3c-5.3-5.2-6.5-11.1-8.6-16.5c-0.8-2-0.5-3.8,1.6-5.1c6-3.9,11.2-9.1,19.2-12.6
+		C751.8,1219.5,748.7,1230.3,742.1,1241.3z"/>
+	<path class="st1" d="M599.6,517.5c0.6,0.1,1.4,0.1,1.9,0.4c12.6,7.1,13,7.9,10.7,24.4c-5.9-7.9-11-15.2-13.4-24.1
+		C599,518,599.3,517.7,599.6,517.5z"/>
+	<path class="st1" d="M597.6,1464.4c4-9.4,8.1-17.2,14-24.4C614.9,1455.5,614.5,1457.9,597.6,1464.4z"/>
+	<path class="st1" d="M2072.4,516.4c2.2,0.6,2.3,2,1.3,3.7c-3.8,6.1-7.7,12.1-11.9,18.6c-2.8-10.6-2.1-12.7,5.3-17.8
+		c1.9-1.3,4.2-2,5.3-4.3L2072.4,516.4z"/>
+	<path class="st1" d="M2061.5,1442.5c4.7,8.5,10.5,14.5,12.5,22.8C2067.2,1459.8,2056.4,1456.8,2061.5,1442.5z"/>
+	<path class="st1" d="M1781.6,836.9c4.2,9.3,4.2,9.3-1.8,12.6C1777.9,845.4,1780.6,842.1,1781.6,836.9z"/>
+	<path class="st1" d="M895.4,849.3c-7.5-2.9-7.5-2.9-3.8-11.1C893.8,841.3,893.9,844.7,895.4,849.3z"/>
+	<path class="st1" d="M630.1,1284.6c-0.2-5.4-2.7-11,1.8-17C634.2,1274.4,629.7,1279.3,630.1,1284.6z"/>
+	<path class="st1" d="M629.9,697.1c0.5,5.4,3.9,10.3,2.4,16.6C626.9,708.5,630.1,702.5,629.9,697.1z"/>
+	<path class="st1" d="M2044.5,1284.5c-2.2-5-4.3-9.2-2.8-15C2046.1,1274.3,2043.5,1279.4,2044.5,1284.5z"/>
+	<path class="st1" d="M2041.9,712.1c-2.2-6,1.1-10.1,2.2-14.6C2043.5,702.2,2046,707.4,2041.9,712.1z"/>
+	<path class="st1" d="M892.2,1143.9c-4.6-7.9-4.6-7.9,1.6-11.5C895.7,1136.5,892.6,1139.7,892.2,1143.9z"/>
+	<path class="st1" d="M1779.6,1132.2c6.1,3.1,6.1,3.1,2.7,11.1c-1.9-1-1.7-3.1-2.3-4.6C1779.2,1137,1778.6,1135.1,1779.6,1132.2z"/>
+	<path class="st1" d="M1934.8,1202.5c4.1-0.6,6.5,2.5,11.4,4.9c-6.3,0.5-8.2-3.5-11.3-5.1L1934.8,1202.5z"/>
+	<path class="st1" d="M1935.8,777c3.1,0.9,4.5-3.5,7.8-2.9c-1.8,4-4.7,3.9-7.9,2.8L1935.8,777z"/>
+	<path class="st1" d="M729.5,774c2.7-0.5,4.4,0.6,5.8,3.2C732.1,778,731,775.7,729.5,774z"/>
+	<path class="st1" d="M734,1202.5c2.3,4.6-1.2,4.8-4.2,5.9c-0.6-3.7,3.7-3.3,4.2-5.7C734,1202.7,734,1202.5,734,1202.5z"/>
+	<path class="st1" d="M1935.2,780.3c-0.4,0.2-0.8,0.5-1.2,0.7c0.3,0,0.6,0.1,0.8,0c0.2-0.1,0.4-0.3,0.6-0.5
+		C1935.5,780.5,1935.2,780.3,1935.2,780.3z"/>
+	<path class="st1" d="M740,1203.1c-1.9-0.8-4.2,2.9-6-0.5c0,0,0,0.2,0,0.1C736,1202.8,738,1202.9,740,1203.1L740,1203.1z"/>
+	<path class="st1" d="M1935.7,777c1.4,1.3,0.9,2.4-0.5,3.3c0,0,0.3,0.3,0.3,0.3c0.1-1.2,0.3-2.3,0.4-3.5
+		C1935.8,777,1935.7,777,1935.7,777z"/>
+	<path class="st1" d="M737.9,778.4c0.2,0.2,0.4,0.5,0.6,0.7c-0.2,0.2-0.5,0.5-0.7,0.5c-0.2,0-0.4-0.4-0.6-0.6
+		C737.4,778.8,737.7,778.6,737.9,778.4z"/>
+	<path class="st1" d="M740,1203.1c0-0.3,0-0.8-0.2-1c-0.8-0.8-0.7-1.1,0.4-0.8C739.5,1201.9,739.4,1202.4,740,1203.1
+		C740,1203.1,740,1203.1,740,1203.1z"/>
+	<path class="st1" d="M1934.9,1202.3c0-0.2-0.1-0.3-0.1-0.5c0,0-0.1,0.1-0.1,0.1c0.1,0.2,0.1,0.4,0.2,0.6
+		C1934.8,1202.5,1934.9,1202.3,1934.9,1202.3z"/>
+	<path class="st1" d="M2072.4,516.6c0.7,0.4,1.4,0.8,2.1,1.2c-0.2,0.2-0.4,0.7-0.6,0.7c-1.1-0.2-1.5-1-1.4-2
+		C2072.4,516.4,2072.4,516.6,2072.4,516.6z"/>
+	<path class="st1" d="M598.7,518.3c-1-0.2-1.8-0.8-1-1.6c0.8-0.9,1.4,0,1.8,0.8C599.3,517.7,599,518,598.7,518.3z"/>
+</g>
+</svg>
+  <p class="hero-tag">distributed structured concurrency</p>
+</div>
+<p class="hero-sub">a multi-processing runtime built on (and shaped
+entirely like) <a class="reference external"
+href="https://github.com/python-trio/trio">trio</a>.</p>

docs/_static/tractor_logo_hero.html

@@ -0,0 +1,456 @@
+<svg class="hero-logo" role="img" aria-label="tractor" version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 2670 1980" style="enable-background:new 0 0 2670 1980;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:currentColor;}
+	.st1{fill:none;}
+</style>
+<g>
+	<path class="st0" d="M2275.3,1000.1c-0.1,2.3,0,4.7,0,7c0,189.3,0,378.7,0,568c0,6,0.1,12.1-0.8,17.9c-2.4,15.2-12.9,17.4-23.6,10
+		c-45.4-31-91.2-61.4-136.9-91.9l-30.1-20.3c-9.8-6.3-19.2-13.2-29.2-19.3c-6.7-4.1-9.8-9.7-9.9-17.2c-0.1-9.3-0.6-18.7-0.3-28
+		c0.2-7.3-1.7-13-6.5-19c-18.6-23.3-36.2-47.3-56.9-69c-18-18.8-36.7-36.8-56.4-53.8c-31.8-27.5-65.4-52.7-101-74.9
+		c-32.7-20.4-66.8-38.4-102.2-54c-50.7-22.4-103.2-39.2-157.1-51.5c-36.7-8.4-73.8-14.4-111.2-18.5c-34.5-3.8-69-6.5-103.7-5.8
+		c-23.1,0.5-46.2-1.3-69.3,0.4c-22.9,1.8-45.9,3-68.7,5.6c-72.7,8.4-143.7,24.6-212.1,50.6c-65.5,24.8-127.4,57-184.9,97.4
+		c-46.8,32.8-90.1,69.8-129.5,111.1c-18.1,19-35.1,39.2-50.5,60.6c-3.9,5.5-5.5,11-5.3,17.6c0.4,9.3,0,18.7,0,28
+		c0,9.3-3.1,16.4-11.8,21.4c-10.4,5.9-19.9,13.4-30.1,19.8l-25.4,17.2c-11.6,7.8-23.3,15.5-34.9,23.3c-34.3,23-68.6,46-102.9,69
+		c-14.6,9.7-23.6,5.5-25.2-12.1c-0.5-5.3-0.5-10.7-0.5-16c0-189.7,0-379.3,0-569l-0.1-26.1c0.2-190.3,0.1-380.7,0.2-571
+		c0-5.7,0.4-11.3,0.5-17c0.1-3.7,1.2-7.3,3-10.5c3.4-5.9,9.3-7.7,15.4-4.8c2.7,1.3,5.1,3.1,7.6,4.8c44.3,29.6,88.5,59.3,132.8,88.9
+		l29.7,20.1c10.8,6.6,20.9,14.3,31.7,20.9c6.7,4.1,9.7,9.8,9.8,17.3c0.2,11,0.4,22,0.2,33c-0.1,5.2,1.2,9.6,4.2,13.9
+		c15.4,22.2,33,42.8,51.6,62.2c53.9,56.4,114.1,105.1,181.4,144.6c38.4,22.6,78.3,42.4,119.9,58.6c40,15.6,80.9,28.3,122.8,38
+		c52.7,12.1,106,19.3,160,22.6c18.3,1.1,36.6,2.1,54.9,1.5c17.7-0.6,35.5,1.1,53.2-0.1c17.6-1.1,35.2-2.3,52.8-3.6
+		c35.9-2.5,71.4-8.5,106.7-15.1c53.4-9.9,105.5-25,156-45.1c53.8-21.5,105.1-48.2,153.2-80.9c43.4-29.5,83.6-62.7,121.1-99.3
+		c27.3-26.6,50.3-56.8,73.9-86.6c2.9-3.6,3.6-7.6,3.6-12.1c-0.1-10.7,0.2-21.3,0.4-32c0.1-7.5,3.2-13.1,9.9-17.2
+		c10.2-6.2,19.9-13.4,30-19.8l23.2-16.3c4.2-1.3,7.4-4.3,11-6.7c42.9-28.7,85.8-57.4,128.7-86.1c1.1-0.7,2.3-1.4,3.3-2.3
+		c10.9-9.1,21.4-4.7,23.8,10.7c0.8,5.6,0.6,11.3,0.6,17c0,189.3,0,378.7,0,568L2275.3,1000.1z M740,1203.1c-2-0.2-4-0.3-6-0.5
+		c-0.5,2.5-4.8,2-4.2,5.8c2.9-1,6.4-1.2,4.2-5.8C735.8,1206,738.1,1202.3,740,1203.1c-0.6-0.7-0.5-1.3,0.2-1.7
+		c-1.1-0.3-1.1-0.1-0.4,0.8C740,1202.3,739.9,1202.8,740,1203.1z M1935.5,780.5c-0.2,0.2-0.4,0.4-0.6,0.4c-0.3,0.1-0.6,0-0.8,0
+		c0.4-0.2,0.8-0.5,1.1-0.8c1.4-0.9,2-1.9,0.5-3.3c3.2,1.1,6.1,1.2,7.9-2.8c-3.3-0.7-4.6,3.8-7.7,2.9
+		C1935.7,778.2,1935.6,779.4,1935.5,780.5z M1934.8,1202.5c-0.1-0.2-0.1-0.4-0.2-0.6c0,0,0.1-0.1,0.1-0.1c0,0.2,0.1,0.3,0.1,0.5
+		c3.1,1.6,5,5.7,11.3,5.1C1941.3,1205,1938.9,1202,1934.8,1202.5z M2072.4,516.6c-1,2.3-3.4,3-5.3,4.3c-7.4,5.1-8.2,7.2-5.3,17.8
+		c4.2-6.5,8-12.6,11.9-18.6c1.1-1.7,0.9-3.1-1.3-3.6c0,1,0.3,1.8,1.4,2c0.2,0,0.4-0.4,0.6-0.7C2073.8,517.4,2073.1,517,2072.4,516.6
+		z M599.6,517.5c-0.4-0.8-1.1-1.7-1.8-0.8c-0.8,0.8,0.1,1.5,1,1.6c2.4,8.9,7.5,16.2,13.4,24.1c2.3-16.5,1.9-17.3-10.7-24.4
+		C600.9,517.6,600.2,517.6,599.6,517.5z M534.9,1353.5c-20,21.8-37.3,44.1-53.4,67.4c-16.1,23.4-26.8,49.5-41.8,73.5
+		c9-21,17.4-42.2,28.9-61.9c16.9-28.7,35.4-56.4,57.5-81.5c0.9-1,1.6-2.1,2.6-3.1c2.9-2.9,3.3-6,2.3-10
+		c-9.1-33.8-14.6-68.3-19.2-103c-5-38-8.3-76.1-10.6-114.3c-2.5-39.9-3.4-79.9-3.9-119.8c-0.1-5.1-1.4-6.8-6.7-6.9
+		c-21.6-0.2-43.3-0.8-64.9-1.3c-2,0-4-0.4-6,0.8c0,195.2,0,390.5,0,585.6c2.1,0.6,3.1-0.4,4.1-1.1c52.7-33.8,105.3-67.7,158-101.4
+		c3.6-2.3,5.7-5.4,7.3-9.1c6-13,12.5-25.8,20.8-37.4c4.2-5.9,3.9-11.9,2.5-19.1c-2.4,1.8-4,2.9-5.5,4.2
+		c-13.9,12.6-32.1,8.7-42.7-2.9c-7.3-8-12.4-17.2-17.1-26.8C542.3,1375.7,539.4,1365.1,534.9,1353.5z M534.6,627.2
+		c3.6-5,4.3-10.7,6.3-15.9c6.2-15.8,12.6-31.5,25.2-43.7c10.8-10.5,26.8-12.6,38.9-2.8c2.3,1.9,4.3,5,7.9,5
+		c1.6-8.3-0.2-15.3-5.1-21.9c-7.4-9.9-12.7-21-17.8-32.3c-2.4-5.3-5.8-9.2-10.8-12.4c-50.5-32.2-100.9-64.7-151.3-97.1
+		c-2.4-1.5-4.5-3.9-8.7-3.9c0,3.7,0,7.2,0,10.7c0,187.9,0,375.8,0,563.7c0,2,0.2,4,0,6c-0.6,4.9,1.4,6.3,6.2,6.1
+		c13.6-0.6,27.3-0.7,41-1c8.3-0.2,16.7-0.6,25-0.4c4.9,0.1,6.7-1.8,6.1-6.4c-0.1-1,0-2,0-3c1.2-75,4.3-149.8,13.7-224.3
+		c4.6-36.3,10-72.5,19.6-107.9c1.6-5.7,0.4-9.9-3.4-14.4c-10.7-12.8-21.7-25.4-31-39.1c-19-28.1-36.8-57-49.6-88.7
+		c-2.2-5.4-5.5-10.4-6.2-16.6C465,538.3,494.6,586,534.6,627.2z M2060.9,1411.1c-2.3,8.5-0.1,15.1,4,21.4
+		c5.9,9.3,13.4,18.1,17.1,28.2c3.9,10.7,10.9,16.6,19.9,22.4c47.8,30.3,95.3,61.1,143,91.7c2.7,1.7,5,4.3,9.5,4.5c0-3.4,0-6.6,0-9.8
+		c0-188.3,0-376.6,0-565c0-2-0.1-4,0-6c0.2-3.4-1.1-5-4.6-4.8c-2.3,0.1-4.7,0-7,0.1c-20,0.6-40,1.2-60,1.9c-6.7,0.2-6.7,0.4-7,7.4
+		c0,1.3,0,2.7-0.1,4c-0.4,60-3,119.9-8.9,179.7c-5,50.1-11.3,99.9-24,148.7c-1.4,5.2,0.1,8.3,3.5,12.3c15,17.8,29.6,36.1,42.4,55.5
+		c20,30.4,36.1,62.9,49.3,96.8c3.2,8.2,5.7,16.6,6.8,25.4c-33.9-90.8-82.6-145-107.2-169.7c-4.1,11-7.5,22.1-12.7,32.5
+		c-4.9,9.9-10.3,19.5-18.8,26.8c-7.1,6.1-15.1,8.9-24.8,7.5C2073.2,1421.4,2068.3,1415.5,2060.9,1411.1z M2244.8,454.3
+		c0.6,4.5-0.2,6.7-0.8,8.9c-6.5,24.2-17,47-28.2,69.2c-18.9,37.2-43,71.2-70.4,102.8c-2.7,3.2-3.6,5.8-2.5,9.8
+		c7.9,29.6,13.1,59.8,17.3,90.2c6.4,45.6,10.2,91.3,12.8,137.3c2,35.3,2.6,70.6,3.1,105.9c0.1,7.6,0.2,7.6,7.6,7.8
+		c17,0.5,34,1,51,1.4c5,0.1,10,0.2,15,0.5c3.2,0.1,5.1-0.9,4.9-4.5c-0.1-1.7,0-3.3,0-5c0-189.6,0-379.3-0.1-568.9
+		c0-2.4,1.1-5.2-1.2-7.3c-0.8,0.1-1.6,0-2.1,0.4c-52.7,33.8-105.3,67.7-158,101.5c-2,1.3-3.7,2.6-4.7,4.9c-6.9,16-16.9,30.1-25.8,45
+		c-3.1,5.2-3.4,10.2-2,15.7c2.6,0.1,3.5-1.6,4.6-2.6c15.7-13.9,33-10.6,45.6,3.8c6,6.8,10.4,14.6,14.4,22.7
+		c5.1,10.3,8.3,21.3,12.8,32.9C2185.2,576.1,2221.7,520.5,2244.8,454.3z M553.7,662.8c-0.3,1.3-0.7,2.8-1,4.3
+		c-7.1,31.2-11.7,62.8-15.4,94.5c-7.1,59.9-10.3,120.1-11.8,180.4c-0.3,13-0.2,26-0.5,39c-0.1,4.4,1.5,5.7,5.7,5.6
+		c25-0.5,50-0.7,74.9-1.1c7.4-0.1,7.6-0.2,7.6-7.8c0-85.6,0-171.2,0.1-256.8c0-5.3-1.7-8.5-5.8-11.7c-16.6-12.8-32.4-26.6-46.9-41.9
+		C559,665.6,557.6,663,553.7,662.8z M553.6,1319.7c2.1-1,2.8-1.2,3.2-1.6c16.4-17.1,34-32.9,52.7-47.4c3-2.4,3.8-5,3.8-8.6
+		c-0.1-13.3-0.1-26.7-0.1-40c0-72.3,0-144.7,0-217c0-10.3,0.4-9-9.2-9.2c-23.3-0.4-46.7-0.8-70-1.1c-2.8,0-5.9-1-9.3,1.5
+		C526.2,1104.4,531.1,1212.3,553.6,1319.7z M2119.8,1319.2c4.8-20.9,8.3-40.2,11.1-59.6c5.8-39.5,9.8-79.2,12.5-119.1
+		c3.1-45.5,4.7-91.1,5.1-136.7c0.1-7.6-0.1-7.7-7.6-7.7c-24.3,0.1-48.6,0.3-72.9,0.5c-7.9,0.1-8,0.1-8,8.5c0,84.6,0,169.1-0.1,253.7
+		c0,5.6,1.7,9.3,5.9,12.7c12.1,9.9,24.2,19.9,36,30.1C2107.7,1306.9,2113.1,1312.7,2119.8,1319.2z M2120.4,664.4
+		c-2.1-0.6-2.9-0.1-3.6,0.7c-15.2,16.5-33.1,29.9-50.2,44.2c-4.8,4-6.8,8-6.8,14.3c0.3,32,0.2,64,0.2,96c0,52.3,0,104.6,0,157
+		c0,8.1,0.1,8.2,8.2,8.2c18.3,0.2,36.7,0.2,55,0.4c6.7,0.1,13.3,0.1,20,0.3c3.7,0.1,5.7-1.1,5.4-5.1c-0.2-2.3,0-4.7-0.1-7
+		c-0.5-45-2.1-89.9-5.2-134.8C2139.2,780.1,2132.7,721.9,2120.4,664.4z M878.7,1138.5c-36,15-69.8,32.9-102.3,53.1
+		c-3.4,2.1-4.9,4.7-5.7,8.6c-2.8,14.4-5.7,28.8-12.2,42c-3.6,7.3-7.7,14.4-17.3,14.4c-9.6,0-13.4-7.4-17.4-14.4
+		c-1.9-3.2-2-7.6-5.4-9.8c-22.3,17.4-41.6,37.2-58.8,58.9c-5.8,7.3-10.2,15.3-12,24.8c-3.8,20.3-9.1,40.2-16.7,59.5
+		c-2.6,6.7-1.3,13.3-1.5,20.3c1.5-0.4,2-0.3,2.1-0.5c3.2-3.8,6.4-7.6,9.4-11.6c31.2-40.5,66-77.4,105.4-110.2
+		c36.9-30.8,75.6-59.1,117.2-83.1c54.3-31.2,110.9-57.4,170.8-76.4c38.4-12.2,77.4-21.8,117-29.2c9.5-1.8,19.1-3,28.6-4.6
+		c1.5-0.3,3.8,0.3,4.4-1.5c1.4-3.9,0.6-8-0.4-11.7c-1-3.6-4.5-1.7-6.9-1.5c-40.6,3.2-80.4,11-120.4,18c-7,1.2-10.4,4.1-10.9,11.2
+		c-0.3,3.8-0.5,9.1-5.8,9c-4.6-0.1-4.7-5-5.3-8.5c-0.7-4.5-2.4-6-7.3-4.9c-39.3,9.1-78,19.9-115.5,34.7c-4.6,1.8-7.1,4.2-7.8,8.9
+		c-0.9,5.9-2.2,11.8-5.2,17.1c-4.1,7.1-10.6,7.2-14.6,0C881.9,1147.7,880.7,1143.4,878.7,1138.5z M1032.8,891.9
+		c0.9-3.8,1.6-6.7,2.4-9.5c0.7-2.3,1.7-4.6,4.4-4.9c3.4-0.3,4.4,2.3,5.3,4.9c0.4,1.3,0.8,2.6,0.8,3.9c0.1,7.7,4.5,10.4,11.7,11.6
+		c32.5,5.5,64.8,11.9,97.5,15.7c7.9,0.9,15.9,1.7,23.8,2.4c1.9,0.2,4,0.7,5.3-1.6c3.5-6.5,0.3-13-7-14.2c-1-0.2-2-0.2-3-0.4
+		c-42.6-5.8-84.2-15.9-125.4-28.2c-41.8-12.4-82.5-28.2-121.6-47.1c-51-24.6-99.8-53.3-144.7-87.9c-20.6-15.8-40.9-32.1-59.9-49.7
+		c-29.1-26.9-56.4-55.7-80.1-87.7c-3.7-4.9-7.7-9.6-11.6-14.3c-0.8,7.6-2.4,14.7,0.5,21.8c7.4,18.2,12.4,37.2,16,56.5
+		c1.7,9.1,5,17.3,10.6,24.4c9.2,11.4,18.5,22.8,28.7,33.3c9.9,10.1,21.1,19,32.2,28.9c3.8-6.5,5.6-13,9.8-18.2
+		c7.7-9.4,17.7-9.5,25.3-0.1c3.6,4.5,5.7,9.7,7.8,15c4.3,10.9,6.8,22.3,8.9,33.7c0.9,5.2,3.3,8.1,7.5,10.7
+		c21.9,13.4,44.1,26,67.3,37.1c10.9,5.2,22.1,10,33.5,15.2c1.8-4.8,3.1-8.6,4.7-12.2c1.6-3.5,4.2-6.3,8.3-6.1
+		c3.6,0.2,5.8,2.9,7.3,6.1c2.4,5.2,3.8,10.6,4.8,16.2c0.8,4.6,2.9,7.2,7.7,9C950.6,871.5,990.8,883,1032.8,891.9z M1953.8,1233.7
+		c-2.9,5.8-4.9,11.5-8.8,16.2c-7.6,9.3-17.8,9.3-25.3,0c-3.4-4.2-5.5-9-7.5-14c-4.4-11.5-7.2-23.5-9.4-35.7
+		c-0.7-3.9-2.4-6.4-5.8-8.6c-30.4-19.4-62.4-35.6-95-50.8c-6.9-3.3-7-3-9.9,4.7c-0.7,1.9-1.5,3.7-2.3,5.5c-1.6,3.1-3.7,5.6-7.6,5.6
+		c-3.8,0-5.9-2.5-7.6-5.6c-2.9-5.4-4.3-11.3-5.1-17.2c-0.7-5-3-7.3-7.5-9.1c-37.8-15.2-77.3-24.6-116.7-34.3c-3.8-0.9-5.4,0.2-6.2,4
+		c-0.7,3.9-0.2,9.9-6.3,9.5c-5-0.3-5.1-6.1-5.3-9.6c-0.4-6.6-3.3-8.9-9.6-10c-32.8-5.6-65.4-12.2-98.6-15.7
+		c-8.3-0.9-16.5-2.1-24.8-2.7c-5.4-0.4-7.1,1.2-7.5,6.6c-0.3,3.9-1.3,8,5.2,8.4c6.3,0.4,12.4,2.1,18.7,3.1
+		c47.7,7.5,94.4,19.1,140.3,34.3c42.4,14,83.5,31.2,123,52c46.3,24.4,90.2,52.6,131,85.6c48.5,39.1,93.7,81.2,129.4,132.6
+		c1.9,2.8,4.8,7.5,7.3,6.7c4.5-1.5,1.4-6.8,2.1-10.4c0.6-3.4-0.5-6.6-1.8-9.7c-7.8-19.5-12.6-40-17.1-60.4c-1.1-5.1-3-9.4-6-13.5
+		c-17-22.8-36.7-43.1-57.6-62.2C1959.6,1237.1,1957.6,1234.7,1953.8,1233.7z M2043.6,585.1c-4.2,2.7-6.2,6.2-8.5,9.2
+		c-29.9,40.3-64.6,76.1-102.5,109c-33.8,29.3-69.5,56.2-107.6,79.4c-51.8,31.6-106.3,57.7-163.9,77.3
+		c-40.7,13.8-82.1,24.9-124.2,33.1c-13.7,2.7-27.6,4.7-41.3,7c-2.2,0.4-5.3-0.1-6.2,2.4c-1.4,3.8-1.1,8.2,0.3,11.7
+		c1.4,3.5,5.3,1.6,8.1,1.3c40.1-4.2,79.8-10.7,119.5-18.1c6.2-1.2,10.4-2.7,10.5-10.2c0-3.5,0.3-9.3,5.4-9.5c6-0.3,5.5,5.7,6.2,9.6
+		c0.7,3.9,2.3,4.9,6.1,3.9c10-2.7,20-5.1,30-7.5c28.5-6.9,56.4-15.6,83.9-25.7c6.8-2.5,10.2-6.3,11-13.3c0.5-5,2-9.8,4.5-14.2
+		c4.2-7.6,10.8-7.6,15.1,0.1c1.6,2.9,2.5,6.2,3.4,9.3c0.9,2.9,2.5,3.5,5.2,2.2c2.4-1.2,5-1.9,7.3-3.1c26.6-13.1,53.2-26,78.7-41.2
+		c11.9-7.1,19.6-14.7,21.3-29.3c1.4-12.4,5.5-24.8,12.8-35.4c8.1-11.7,19.5-11.7,27.5,0.1c3.1,4.6,5.4,9.7,8.2,14.9
+		c1.9-1.4,3.6-2.5,5.1-3.8c22.2-19.8,42.7-41.1,60.6-64.9c2.6-3.5,4.3-7.3,5.2-11.7c4.5-21.2,9.6-42.2,17.6-62.4
+		C2045.3,599.2,2044.5,592.6,2043.6,585.1z M777.2,1163.8c1.2,0.2,1.6,0.4,1.9,0.3c30.4-14.3,60.9-28.3,92.6-39.6
+		c4.2-1.5,4.4-3.7,3.9-7.5c-4.5-37.4-6.3-75-6.5-112.6c0-7.8-0.2-7.9-8.5-7.9c-22,0-44,0-65.9,0c-8.6,0-8.8,0.1-8.8,8.7
+		c-0.4,45.3-2.2,90.5-6.6,135.6C778.4,1148.4,776.3,1155.9,777.2,1163.8z M776.8,817.8c0.3,3.8,0.5,7.1,0.9,10.4
+		c2.5,21.2,4.1,42.4,5.5,63.7c1.8,28.6,2.3,57.2,2.7,85.9c0.1,7.1,0.3,7.3,7.2,7.3c22.6,0.1,45.3,0.1,67.9,0.1
+		c8.8,0,8.1-0.2,8.1-8.3c0.1-37,1.9-73.9,6.4-110.6c0.7-5.8-0.5-8.2-6-10.1c-29.5-10.3-58-23.3-86.2-36.8
+		C781.5,818.4,779.9,817.2,776.8,817.8z M1896.4,1163.9c1-2.7,0.2-5.3-0.1-7.9c-2.4-19.8-3.9-39.8-5.3-59.7
+		c-2.1-30.3-2.5-60.6-3.3-90.9c-0.2-8.7-0.2-8.8-8.6-8.8c-16.7-0.1-33.3,0-50-0.1c-6.3,0-12.7,0.2-19-0.1c-3.9-0.1-5.5,1.4-5.2,5.3
+		c0.1,1.7,0.1,3.3,0,5c-1.1,36-2,72-6.4,107.7c-0.9,7.7-1.1,7.9,6.3,10.6c28.5,10.4,56.1,22.9,83.3,36.1
+		C1890.6,1162.4,1893.1,1164.4,1896.4,1163.9z M1896.8,817.7c-2.5-0.3-4.3,0.6-6.1,1.5c-6,2.9-12,5.6-18,8.6
+		c-22.1,10.9-44.9,20.1-67.9,28.7c-7.5,2.8-7.3,3-6.5,10.6c1,8.9,1.9,17.9,2.7,26.8c2.4,28.2,3.2,56.5,3.6,84.7
+		c0.1,5.4,1.8,6.7,6.8,6.6c22.6-0.2,45.3-0.1,67.9-0.2c1,0,2-0.1,3,0c3.8,0.3,5.6-1.2,5.2-5.1c-0.2-1.6,0-3.3,0.1-5
+		c0.7-38.6,1.7-77.2,5.2-115.6C1894.1,845.4,1895.5,831.6,1896.8,817.7z M908.3,1109.6c1.4,0,2.4,0.2,3.2,0
+		c37.8-11.7,75.5-24,114.2-32.5c4.5-1,5.8-2.9,5.5-7.4c-1.3-22-2.5-43.9-2.3-65.9c0.1-7.3-0.2-7.4-8-7.4c-33.3,0-66.7,0.1-100,0.2
+		c-7.7,0-7.9,0.1-7.9,7.5c0,31-1.6,61.9-4,92.9C908.8,1101,907.3,1105.2,908.3,1109.6z M1765.3,1110.4c0-2.5,0.1-3.5,0-4.4
+		c-3.1-33.9-4.7-67.8-4.8-101.8c0-7.4-0.4-7.6-8.2-7.7c-33.3-0.1-66.7-0.2-100-0.2c-7.3,0-7.2,0.1-7.5,7.9c-0.7,21-1.1,42-2.3,62.9
+		c-0.5,9-1.3,8.3,7.6,10.4c29.8,7.1,59.4,14.9,88.5,24.5C1747.2,1104.8,1755.7,1107.4,1765.3,1110.4z M908.8,872.2
+		c-0.2,0.3-0.6,0.6-0.6,0.8c2.8,35.5,5.2,71,4.8,106.7c-0.1,4.6,1.9,5.6,6,5.6c34.7-0.1,69.3-0.1,104,0.1c4.9,0,6.2-1.8,6.1-6.4
+		c-0.5-22,0.8-44,2.1-65.9c0.3-5.2-0.9-7.7-6.4-8.8c-36.9-7.6-72.4-20.1-108.5-30.5C913.8,873,911.6,871.1,908.8,872.2z
+		 M1765.6,872.4c-3.2-0.6-5.1,0.3-7,0.9c-22.2,6.7-44.2,14.5-66.7,20.3c-14.5,3.7-29,7.3-43.5,10.8c-4.4,1.1-6.5,2.6-6.2,8
+		c1.3,21.9,1.8,43.9,2.6,65.8c0.2,7,0.2,7.1,7.1,7.1c33.6,0,67.2,0,100.8-0.1c7.5,0,7.7-0.2,7.7-7.8c0.2-24.6,0.9-49.2,2.6-73.8
+		C1763.8,893.4,1764.7,883.1,1765.6,872.4z M725.8,1192.5c8.7-4.8,15.8-9.8,23.8-12.8c9.6-3.7,12.7-10.5,13-19.7
+		c0.1-1.3,0.2-2.7,0.4-4c3.4-27.1,5.6-54.3,6.7-81.5c1-23.6,1.5-47.2,2-70.8c0.2-7-0.1-7-7.3-7.1c-6.7-0.1-13.3,0-20,0
+		c-9,0-18,0.2-27,0c-4.2-0.1-6.2,1.3-5.9,5.7c0.2,2.3,0,4.7,0.1,7c0.8,27.6,1.2,55.2,3,82.8C717,1125.1,719.9,1158.2,725.8,1192.5z
+		 M1946.2,1191.7c2.9-2.2,2.4-4.7,2.8-6.9c4.5-26.6,6.9-53.5,8.9-80.4c2.5-33.9,3.2-67.9,3.7-101.8c0.1-5-1.8-6.2-6.4-6.1
+		c-15.3,0.2-30.6,0-46,0.1c-7.6,0-7.8,0.2-7.7,7.8c0.7,44,2,87.9,6.7,131.6c1.1,10.3,2.2,20.5,3.5,30.7c0.4,2.8,0.2,6,3.5,7.8
+		C1925.8,1180.2,1936.2,1186.1,1946.2,1191.7z M1947.7,789.1c-9.1,5-16.9,10.1-25.3,13.8c-8.2,3.6-10.5,9.5-11.5,17.8
+		c-3,27.1-5.6,54.3-6.9,81.6c-1.2,25.3-1.5,50.6-2.5,75.9c-0.2,5.1,1.5,7,6.7,7c15-0.3,30-0.1,45-0.2c8.6,0,8.4,0.6,8.3-8.9
+		c-0.3-30.6-1-61.3-3.1-91.9C1956.3,852.9,1953.6,821.8,1947.7,789.1z M726,789.2c-3.3,16.4-5.1,31.3-6.7,46.2
+		c-4.6,42.4-6.3,85-7.3,127.7c-0.1,5.7,0,11.3-0.2,17c-0.1,3.4,1.4,4.8,4.7,4.8c17,0,34,0,51,0.1c3.6,0,4.6-1.9,4.4-5
+		c-0.1-2.3-0.1-4.7-0.1-7c-0.5-37.3-1.7-74.6-5-111.8c-1.4-15.9-2.8-31.9-5.5-47.6c-0.4-2.6-0.3-5.2-3.2-6.8
+		C747.6,801.1,737.2,795.4,726,789.2z M1625.1,910.5c-9.8,1.8-18,3.4-26.2,4.6c-23.3,3.5-46.2,9.9-70,10
+		c-10.9,0.1-21.8,2.4-32.7,3.7c-3.5,0.4-6.2,1.1-6,6c0.5,15,0.7,30,0.7,44.9c0,4.4,1.7,5.8,5.9,5.7c8.3-0.2,16.6,0,25-0.1
+		c30.6,0,61.3,0,91.9-0.1c9,0,9-0.1,9.2-9.4c0.2-13,0.2-26,0.6-38.9C1623.7,928.4,1624.5,919.8,1625.1,910.5z M1625.2,1071.1
+		c-2.2-23.8-2.3-46.1-2.4-68.4c0-4.5-1-6.6-6.1-6.6c-39.9,0.1-79.9,0.1-119.8-0.1c-5.1,0-6.1,2-6.1,6.5c0,14.6-0.1,29.3-0.6,43.9
+		c-0.1,4.5,1.6,5.6,5.6,6.1c12.6,1.4,25,3.8,37.7,4c8,0.1,15.9,1.1,23.8,2.5C1579.5,1063,1601.7,1066.9,1625.2,1071.1z
+		 M1049.3,1070.4c2.6,1,4.9-0.1,7-0.6c23-5.5,46.3-8.9,69.7-12.3c16.7-2.5,33.7-3.8,50.6-5.2c5.1-0.4,6.8-1.9,6.6-7
+		c-0.4-14-0.3-27.9-0.5-41.9c-0.1-7-0.2-7.2-7.2-7.2c-39.3,0-78.5,0-117.8,0.1c-6.7,0-6.8,0.2-6.8,7.5c0,16.3-0.5,32.6-1.4,48.9
+		C1049.3,1058.6,1048.4,1064.5,1049.3,1070.4z M1049.8,910.2c-0.4,1.2-0.8,1.8-0.8,2.4c0.6,22.6,2.5,45.2,1.9,67.8
+		c-0.1,4.2,2.1,4.8,5.6,4.8c39.9,0,79.9-0.1,119.8,0.1c5.5,0,6.7-2.3,6.6-7.2c-0.2-11,0.1-22,0.2-32.9c0.1-15.9,0.1-15.5-16.3-17.4
+		c-16.5-1.9-33.1-2.4-49.6-5.2C1094.7,918.9,1072,915.9,1049.8,910.2z M1260.5,985.4c21.6,0,43.2,0,64.9,0c9.1,0,9.1-0.1,9.1-9.4
+		c0-10.3,0-20.6-0.1-30.9c-0.1-7.7-0.1-7.7-7.6-7.9c-2.3-0.1-4.7,0-7,0c-41.9,0-83.8-2.2-125.5-6.2c-4.6-0.4-5.9,0.9-6,5.1
+		c-0.2,13.6-0.6,27.3-0.8,40.9c-0.1,8.3,0.1,8.4,8.1,8.4C1217.3,985.4,1238.9,985.4,1260.5,985.4z M1485,931.5
+		c-3.1-1.4-5.4-0.6-7.7-0.4c-26.2,1.9-52.4,4.3-78.7,5.1c-17.3,0.5-34.6,1.3-51.9,1.1c-7.4-0.1-7.5,0.1-7.6,7.8
+		c-0.1,11.7,0,23.3-0.1,35c0,3.7,1,5.8,5,5.5c2-0.1,4,0,6,0c41.6,0,83.2,0,124.9,0c2,0,4-0.1,6,0c3.3,0.1,5-1.2,4.9-4.6
+		C1485.5,964.2,1485.3,947.6,1485,931.5z M1485,1051.1c0.3-17,0.5-33.6,0.9-50.1c0.1-4.2-2.2-4.8-5.7-4.8c-45,0.1-89.9,0.1-134.9,0
+		c-4.7,0-6.5,1.4-6.3,6.2c0.3,12,0.4,24,0,36c-0.2,5.2,2.1,6,6.5,6c11.6-0.1,23.3,0.1,34.9,0.4
+		C1415,1045.8,1449.5,1048.1,1485,1051.1z M1188.4,1050.6c47.5-3.4,93.2-6.8,139.2-6.4c0.7,0,1.3,0,2,0c3.2,0.2,4.9-0.9,4.9-4.5
+		c-0.1-13,0-25.9,0-38.9c0-3.4-1.6-4.8-4.9-4.6c-1.7,0.1-3.3,0-5,0c-42.6,0-85.1,0-127.7,0c-1.7,0-3.3,0.1-5,0
+		c-2.8-0.1-4.4,1.1-4.4,4.1C1187.9,1016.8,1188.1,1033.4,1188.4,1050.6z M2010.7,1230.1c0.9-7.3-0.9-13.8-1.5-20.3
+		c-6.8-66-10.3-132.2-10.7-198.6c-0.1-16.1-0.3-16.3-16.8-14.7c-2.9,0.3-4.2,1.1-4.1,4.1c0.1,3,0,6,0,9
+		c-0.3,41.3-2.1,82.6-6.1,123.8c-2,20.2-4.3,40.4-8.2,60.4c-0.9,4.8-0.2,7.8,4.5,10.4c10.2,5.7,19.9,12.2,29.8,18.3
+		C2001.8,1225,2005.6,1228.2,2010.7,1230.1z M2011.2,752.5c-2.7-0.8-3.6,0.3-4.7,1c-13.3,8.3-26.4,16.7-39.8,24.7
+		c-3.6,2.1-4.2,4.5-3.5,8.2c1.4,7.8,2.8,15.7,3.9,23.6c7.4,53.8,10.1,107.9,10.6,162.2c0.1,14.1-2.6,12.8,13.7,12.8
+		c7,0,7-0.2,7.1-7.3c0.4-27.3,0.6-54.6,1.8-81.8c1.4-30.9,3.1-61.8,6.1-92.6C2008,786.3,2009.6,769.5,2011.2,752.5z M662.1,1231.5
+		c3.7-2.4,5.6-3.7,7.5-4.9c11.6-7.7,22.9-16.2,35.5-22.2c5.3-2.5,6.2-5.5,5.1-11c-4.6-22.5-7-45.4-9-68.3
+		c-3.5-39.9-5-79.8-5.4-119.8c-0.1-8.6-0.2-8.6-8.8-8.7c-1.3,0-2.7,0-4,0c-7.9,0.1-8,0.1-7.9,8.4c0,24.7-0.6,49.3-1.6,74
+		c-1.3,32-3,63.9-6,95.8C665.8,1192.9,664.1,1211.1,662.1,1231.5z M662.9,752.1c-1,1.4-0.4,3-0.3,4.6c2,20.5,4.6,41.1,6,61.7
+		c3.8,52.5,6.5,105.1,6.4,157.8c0,8.8,0.1,8.9,8.5,8.9c14.5-0.1,12.1,1.3,12.3-12.1c1.1-62.7,3.5-125.2,14.8-187
+		c0.8-4.1-0.9-6-4.2-7.7c-13.4-6.8-25.6-15.5-38-23.9C666.8,753.1,665.5,751.1,662.9,752.1z M2044.3,728.6c-5.4,1.1-7.1,3.9-7.7,8.3
+		c-1.7,14.9-4,29.7-5.6,44.6c-4.6,42.1-7.2,84.2-8.9,126.5c-1,25.3-1.3,50.5-1.3,76.8c6.5,0,12.4-0.1,18.3,0
+		c3.8,0.1,5.5-1.4,5.2-5.3c-0.2-1.7,0-3.3,0-5c0-78.9,0-157.9,0-236.8C2044.3,734.9,2044.3,732,2044.3,728.6z M2044.3,1253
+		c0-3.7,0-6.4,0-9c0-78.6,0-157.2,0-235.8c0-13,1.3-11.5-11.9-11.5c-13,0-11.5-1.8-11.5,11.8c0,59.3,3.1,118.5,8.7,177.6
+		c1.9,19.5,4,39.1,7,58.5C2037.3,1248.9,2038.8,1251.8,2044.3,1253z M629.2,728.7c0,4.3,0,8,0,11.6c0,76.5,0,153.1,0,229.6
+		c0,15.8,0,15.8,16,15.3c7.6-0.2,7.6-0.2,7.7-7.7c0.1-3.3,0-6.7,0-10c-0.8-55.6-3.1-111.1-8.5-166.4c-2-21.2-5-42.3-7.3-63.4
+		C636.6,733.3,635,730.3,629.2,728.7z M629.2,1253.2c5.3-2.1,7.4-4.5,7.9-9.2c1.6-14.9,4-29.7,5.5-44.6
+		c6.5-62.4,9.5-124.9,10.3-187.6c0.2-15.6,0.1-15.6-15-15.6c-9,0-8.8-0.6-8.7,8.6c0,2,0,4,0,6c0,75.7,0,151.3,0,227
+		C629.2,1242.5,629.2,1247.2,629.2,1253.2z M2060,697.5c19-15.9,36.7-29.3,52.3-45.3c3.5-3.5,3.7-6.7,2.4-10.7
+		c-2.8-8.9-5.4-17.8-8.7-26.5c-3.5-9.3-7.4-18.5-13.7-26.4c-5.3-6.6-8-6.6-13.4-0.4c-1.3,1.5-2.7,3-3.6,4.7
+		c-8.9,15.7-17.3,31.5-15.3,50.5c0.4,3.6,0.1,7.3,0.1,11C2060,668,2060,681.5,2060,697.5z M613.2,1283.1
+		c-20.8,13.6-36.9,29.9-53.8,45.4c-2.8,2.6-2.3,5.1-1.5,8.1c4.1,14.7,8.6,29.3,15.3,43.2c2.6,5.4,5.4,10.7,9.8,15
+		c4.3,4.2,6.2,4.6,10,0.4c10.7-11.9,18.4-26.3,19.7-41.7C614.7,1330.6,613.2,1307.6,613.2,1283.1z M2060,1284.4
+		c0,19.5,0.7,36.8-0.2,54c-1.1,19.1,6.3,35.2,15.8,50.5c7.4,12.1,12.1,11.7,19.8-0.6c9.7-15.4,14.6-32.7,19.7-50
+		c1.1-3.7,0-6.2-2.6-8.8C2096.8,1313.6,2079.3,1299.9,2060,1284.4z M611.9,698.2c2.1-3.3,1.3-5.9,1.3-8.4c0.1-16-0.8-32,0.3-47.9
+		c1.2-18.4-6.2-33.8-15.1-48.6c-7.6-12.7-12.6-12.4-20.4,0.3c-10.1,16.3-15.1,34.6-20.4,52.8c-1,3.6,0.6,5.5,3,7.7
+		c8.8,8.1,17.3,16.7,26.3,24.5C594.8,685.4,603.3,691.5,611.9,698.2z M1788.2,864c-12.5,3.2-12.6,3.2-13.9,13.8
+		c-0.9,7.6-1.6,15.2-2.1,22.8c-1.8,26.2-2.9,52.5-3.2,78.8c0,4,0.8,6.3,5.4,6c4.6-0.3,9.3-0.2,14,0c5.1,0.1,6.9-2.1,6.7-7.3
+		c-0.5-11.3-0.2-22.6-0.7-33.9C1793.2,917.5,1792.3,890.9,1788.2,864z M885.3,1118.4c12.8-3,12.5-3,13.8-13.9
+		c3.5-29.5,4.6-59.1,5-88.8c0.3-23.5,5.2-18.7-19.8-19.4c-4.4-0.1-5.7,1.5-5.7,5.8C878.8,1040.8,880.3,1079.4,885.3,1118.4z
+		 M885.7,863.5c-0.2,0.9-0.6,1.9-0.7,2.9c-4.3,33.7-6,67.5-6.1,101.4c0,5.5-2.5,12.6,1.3,16.2c3.8,3.6,10.8,1.1,16.3,1.2
+		c7.9,0.1,8.1-0.1,7.9-8.4c-0.6-33.2-1.5-66.4-5.3-99.4C897.9,865.6,898,865.6,885.7,863.5z M1788.4,1117.5
+		c4.4-34.4,5.9-68.6,6.5-102.9c0.1-5.6,2.4-12.7-0.9-16.5c-3.9-4.3-11.3-1.4-17.2-1.6c-7.6-0.2-7.7,0.1-7.7,7.6
+		c0,24.7,1.3,49.3,2.8,73.9c0.6,10.3,2.2,20.5,2.9,30.8c0.3,3.6,1.7,5.5,4.9,6.5C1782.2,1116,1784.4,1117.7,1788.4,1117.5z
+		 M1481.1,1078.1c0-2.7,0.1-4.4,0-6c-0.3-7.8-0.3-8.1-8.2-8.7c-22.9-1.7-45.8-3.3-68.7-4.7c-19.9-1.2-39.9-0.9-59.9-1
+		c-4.6,0-5.5,2-5.4,6c0.1,3.7,0.3,6.7,5.2,6.2c1.3-0.1,2.7,0,4,0c34.3-0.3,68.4,1.9,102.5,5.6
+		C1460.6,1076.6,1470.4,1078.5,1481.1,1078.1z M1480,903c-15.3,1.6-30.8,3.6-46.3,4.8c-29.5,2.4-59.1,4.7-88.8,3.9
+		c-5.1-0.1-6.1,2-6,6.5c0.1,4.1,1.1,6.3,5.6,5.8c1.3-0.2,2.7,0,4,0c42.3,0.3,84.5-2.6,126.7-5.9c4.2-0.3,6.2-1.6,5.8-5.9
+		C1480.7,909.3,1482,906.3,1480,903z M1192.2,1078.2c3.1-0.2,5.4-0.3,7.6-0.5c37-4.6,74-7.6,111.3-7.8c6,0,12-0.1,18,0
+		c3.7,0.1,5.3-1.1,5.4-5.1c0.1-6.5,0-6.9-7.3-7c-40.6-0.8-81.1,1.7-121.6,4.6C1193.1,1063.3,1193.2,1063.6,1192.2,1078.2z
+		 M1192.6,903.2c0.2,14.4,0.2,14.4,12.8,16c3,0.4,6,0.6,8.9,0.8c19.3,1.1,38.5,2,57.8,3.2c18.6,1.2,37.2,0.8,55.9,0.8
+		c6.4,0,6.3-0.5,6.6-6.8c0.2-5.8-3.3-5.5-7.1-5.4c-28.3,0.8-56.5-1.5-84.7-3.6C1226.3,907,1209.8,905.4,1192.6,903.2z M653.6,694.6
+		c2,12.3,3.8,22.4,5.1,32.6c0.5,3.7,1.7,6.1,4.8,8c14.2,8.8,27.5,18.8,42.2,26.6c2.7,1.4,6.2,6.3,8.9,2.4c2.7-3.7-2.6-6.2-5-8.5
+		c-19-17.3-36.7-35.8-51.8-56.7C657,698.1,656,697.3,653.6,694.6z M654,1284.6c0.8,0,1.3,0.1,1.5,0c1.4-1.4,2.9-2.7,4-4.3
+		c14.6-20.8,32.8-38.3,51.2-55.5c1.2-1.1,2.6-2.1,3.6-3.4c1.4-1.7,1.5-3.6-0.2-5.7c-2.9,0.3-5.3,2.1-7.8,3.6
+		c-10.2,6.3-19.8,13.5-30.5,18.8c-12.9,6.4-19.3,15.7-19.2,30.2C656.6,1273.7,654.9,1279.1,654,1284.6z M2019.1,698.8
+		c-0.5-0.3-1-0.6-1.5-0.9c-1,1.2-2,2.4-3,3.6c-6.8,9-13,18.4-21.4,26.1c-11,10.1-20.5,21.7-32.4,30.8c-1.9,1.5-3.6,3.2-2.1,5.9
+		c2,3.5,4.1,0.5,5.7-0.4c15.4-9.7,30.8-19.6,46.1-29.5c2.3-1.5,4-3.1,4.4-6.2C2016.2,718.5,2017.7,708.6,2019.1,698.8z
+		 M2017.1,1283.9c0.7-0.2,1.4-0.5,2.1-0.7c-1.5-10.1-3-20.2-4.4-30.4c-0.4-2.6-1.9-4.1-3.9-5.4c-15.6-10-31.3-20.1-46.9-30
+		c-1.5-1-3.3-2.8-5-0.5c-1.7,2.4-0.3,4.2,1.7,5.9c4,3.4,8.1,6.9,11.8,10.6C1988.4,1249.3,2005.3,1264.3,2017.1,1283.9z M1044.6,1034
+		c0.2,0,0.3,0,0.5,0c0-11-0.1-21.9,0.1-32.9c0.1-4.2-2-4.8-5.5-4.9c-4.5-0.1-4.6,2.6-4.6,5.9c0.1,22.3,1.2,44.5,2.4,66.8
+		c0.1,1,0.2,2,0.4,3c0.2,1.2,1.2,1.8,2.1,1.7c0.8-0.1,1.9-1,2.2-1.7c0.5-1.5,0.7-3.2,0.8-4.9C1043.5,1055.9,1044,1045,1044.6,1034z
+		 M1636.4,1033.8c0.7,0,1.4,0,2.1,0c0-10.6,0-21.2,0-31.8c0-2.7,0.2-5.3-3.6-5.8c-4.7-0.6-6,0.4-6,6.1c-0.1,21.9,0.2,43.7,2.1,65.6
+		c0.1,1.3,0.1,2.7,0.6,3.9c0.3,0.7,1.5,1.6,2.2,1.5c0.7,0,1.7-1.1,1.9-1.8c0.5-1.9,0.7-3.9,0.7-5.9
+		C1636.4,1055,1636.4,1044.4,1636.4,1033.8z M1638.5,948.1c-0.2,0-0.5,0-0.7,0c-0.5-11.6-1-23.3-1.6-34.9c-0.1-1.9,0.2-4.8-2.3-4.9
+		c-3.3-0.1-2.8,3-3,5.2c-0.3,3-0.4,6-0.7,9c-1.5,19-1.4,37.9-1.4,56.9c0,5.3,2,6.8,6.4,5.8c3.8-0.8,3.3-3.6,3.3-6.2
+		C1638.5,968.8,1638.5,958.4,1638.5,948.1z M1045.1,948c-0.1,0-0.3,0-0.4,0c-0.6-11.9-1.2-23.9-1.9-35.8c-0.1-1.9-0.4-4.3-3.2-3.9
+		c-2.2,0.3-1.9,2.4-2,4c-1.3,22.5-2.3,45.1-2.5,67.7c0,3.7,1.2,5.4,5.1,5.4c4.1,0.1,5-1.9,5-5.5C1045,969.3,1045.1,958.7,1045.1,948
+		z M741.9,740.1c-4.9,5.5-6.3,11-8.3,16.2c-0.8,2-0.8,4,1.2,5.3c6.2,4.1,11.6,9.4,19.7,13C751.6,762.1,748.8,750.9,741.9,740.1z
+		 M1931.7,1241.3c11.7-16.6,11.5-18.2-3-28.3c-2.7-1.9-4.9-4.5-9.1-4.9C1921.9,1219.6,1924.7,1230.7,1931.7,1241.3z M1931.6,740
+		c-6.6,10.9-9.8,22-12.1,33.9c4-0.9,6.1-3.1,8.5-4.8C1943.5,758.3,1943.6,757.2,1931.6,740z M742.1,1241.3
+		c6.6-11.1,9.8-21.9,12.2-34.3c-8,3.6-13.2,8.8-19.2,12.6c-2,1.3-2.3,3.1-1.6,5.1C735.6,1230.2,736.7,1236.2,742.1,1241.3z
+		 M597.6,1464.4c16.9-6.5,17.3-8.9,14-24.4C605.8,1447.2,601.7,1455,597.6,1464.4z M2061.5,1442.5c-5.1,14.3,5.6,17.3,12.5,22.8
+		C2072.1,1457,2066.2,1451,2061.5,1442.5z M1781.6,836.9c-1,5.2-3.6,8.5-1.8,12.6C1785.7,846.2,1785.7,846.2,1781.6,836.9z
+		 M895.4,849.3c-1.5-4.5-1.6-7.9-3.8-11.1C887.9,846.3,887.9,846.3,895.4,849.3z M630.1,1284.6c-0.4-5.3,4.1-10.2,1.8-17
+		C627.4,1273.6,629.9,1279.2,630.1,1284.6z M629.9,697.1c0.2,5.4-3,11.4,2.4,16.6C633.8,707.4,630.4,702.5,629.9,697.1z
+		 M2044.5,1284.5c-1-5.2,1.5-10.3-2.8-15C2040.3,1275.4,2042.4,1279.6,2044.5,1284.5z M2041.9,712.1c4.1-4.8,1.6-10,2.2-14.6
+		C2043,702.1,2039.8,706.2,2041.9,712.1z M892.2,1143.9c0.4-4.2,3.5-7.3,1.6-11.5C887.6,1136,887.6,1136,892.2,1143.9z
+		 M1779.6,1132.2c-1,2.9-0.4,4.8,0.4,6.5c0.7,1.5,0.4,3.6,2.3,4.6C1785.7,1135.3,1785.7,1135.3,1779.6,1132.2z M729.5,774
+		c1.5,1.6,2.6,4,5.8,3.2C733.9,774.7,732.2,773.5,729.5,774z M737.9,778.4c-0.2,0.2-0.5,0.4-0.7,0.6c0.2,0.2,0.4,0.6,0.6,0.6
+		c0.2,0,0.5-0.3,0.7-0.5C738.4,778.8,738.1,778.6,737.9,778.4z"/>
+	<path class="st1" d="M534.9,1353.5c4.5,11.6,7.4,22.2,12.2,32c4.7,9.6,9.8,18.8,17.1,26.8c10.6,11.6,28.8,15.5,42.7,2.9
+		c1.4-1.3,3.1-2.4,5.5-4.2c1.4,7.2,1.7,13.2-2.5,19.1c-8.4,11.7-14.8,24.4-20.8,37.4c-1.7,3.7-3.7,6.7-7.3,9.1
+		c-52.7,33.7-105.3,67.6-158,101.4c-1.1,0.7-2.1,1.7-4.1,1.1c0-195.1,0-390.4,0-585.6c2.1-1.2,4.1-0.9,6-0.8
+		c21.6,0.5,43.3,1.1,64.9,1.3c5.3,0,6.7,1.8,6.7,6.9c0.5,40,1.4,79.9,3.9,119.8c2.4,38.2,5.6,76.4,10.6,114.3
+		c4.6,34.7,10.1,69.1,19.2,103c1.1,4,0.6,7.1-2.3,10c-0.9,0.9-1.7,2.1-2.6,3.1c-22.1,25.1-40.6,52.7-57.5,81.5
+		c-11.6,19.7-19.9,41-28.9,61.9c14.9-23.9,25.7-50.1,41.8-73.5C497.6,1397.6,514.9,1375.3,534.9,1353.5z"/>
+	<path class="st1" d="M534.6,627.2c-40-41.2-69.6-89-94.2-140.1c0.7,6.2,4,11.2,6.2,16.6c12.7,31.7,30.5,60.6,49.6,88.7
+		c9.3,13.7,20.4,26.3,31,39.1c3.8,4.5,5,8.7,3.4,14.4c-9.6,35.4-15,71.6-19.6,107.9c-9.4,74.5-12.5,149.3-13.7,224.3c0,1-0.1,2,0,3
+		c0.6,4.7-1.2,6.5-6.1,6.4c-8.3-0.2-16.7,0.2-25,0.4c-13.7,0.3-27.3,0.4-41,1c-4.8,0.2-6.8-1.2-6.2-6.1c0.3-2,0-4,0-6
+		c0-187.9,0-375.8,0-563.7c0-3.5,0-7.1,0-10.7c4.2-0.1,6.3,2.3,8.7,3.9c50.4,32.4,100.8,64.9,151.3,97.1c5,3.2,8.4,7.1,10.8,12.4
+		c5.1,11.2,10.4,22.4,17.8,32.3c4.9,6.6,6.7,13.5,5.1,21.9c-3.6-0.1-5.6-3.1-7.9-5c-12-9.8-28.1-7.7-38.9,2.8
+		c-12.6,12.2-19,27.9-25.2,43.7C538.8,616.5,538.2,622.2,534.6,627.2z"/>
+	<path class="st1" d="M2060.9,1411.1c7.4,4.3,12.3,10.3,20.6,11.4c9.8,1.4,17.7-1.4,24.8-7.5c8.5-7.3,13.9-16.9,18.8-26.8
+		c5.1-10.4,8.6-21.5,12.7-32.5c24.7,24.7,73.3,78.9,107.2,169.7c-1.1-8.8-3.5-17.2-6.8-25.4c-13.2-33.9-29.3-66.4-49.3-96.8
+		c-12.8-19.5-27.4-37.7-42.4-55.5c-3.4-4-4.8-7.1-3.5-12.3c12.8-48.8,19.1-98.6,24-148.7c5.9-59.7,8.4-119.6,8.9-179.7
+		c0-1.3,0-2.7,0.1-4c0.2-7,0.2-7.1,7-7.4c20-0.7,40-1.3,60-1.9c2.3-0.1,4.7,0,7-0.1c3.5-0.2,4.8,1.4,4.6,4.8c-0.1,2,0,4,0,6
+		c0,188.3,0,376.6,0,565c0,3.2,0,6.4,0,9.8c-4.5-0.2-6.9-2.8-9.5-4.5c-47.7-30.6-95.2-61.4-143-91.7c-9-5.7-16-11.6-19.9-22.4
+		c-3.7-10.1-11.2-18.9-17.1-28.2C2060.8,1426.2,2058.6,1419.6,2060.9,1411.1z"/>
+	<path class="st1" d="M2244.8,454.3c-23,66.2-59.6,121.8-106.6,172.4c-4.5-11.6-7.7-22.6-12.8-32.9c-4-8.1-8.4-15.8-14.4-22.7
+		c-12.6-14.4-29.9-17.7-45.6-3.8c-1.1,1-2,2.7-4.6,2.6c-1.4-5.5-1.1-10.5,2-15.7c8.8-14.9,18.9-29,25.8-45c1-2.3,2.7-3.7,4.7-4.9
+		c52.7-33.9,105.3-67.7,158-101.5c0.5-0.3,1.3-0.2,2.1-0.4c2.3,2.1,1.2,4.9,1.2,7.3c0.1,189.6,0.1,379.3,0.1,568.9
+		c0,1.7-0.1,3.3,0,5c0.2,3.6-1.7,4.6-4.9,4.5c-5-0.2-10-0.3-15-0.5c-17-0.5-34-1-51-1.4c-7.4-0.2-7.5-0.2-7.6-7.8
+		c-0.5-35.3-1.1-70.6-3.1-105.9c-2.6-45.9-6.4-91.7-12.8-137.3c-4.2-30.3-9.4-60.5-17.3-90.2c-1.1-4-0.2-6.6,2.5-9.8
+		c27.4-31.6,51.5-65.6,70.4-102.8c11.3-22.2,21.7-44.9,28.2-69.2C2244.6,460.9,2245.4,458.8,2244.8,454.3z"/>
+	<path class="st1" d="M553.7,662.8c3.8,0.2,5.2,2.8,6.9,4.6c14.5,15.2,30.3,29,46.9,41.9c4.1,3.2,5.8,6.4,5.8,11.7
+		c-0.2,85.6-0.1,171.2-0.1,256.8c0,7.5-0.1,7.7-7.6,7.8c-25,0.4-50,0.6-74.9,1.1c-4.3,0.1-5.9-1.2-5.7-5.6c0.4-13,0.2-26,0.5-39
+		c1.5-60.3,4.7-120.5,11.8-180.4c3.7-31.7,8.3-63.3,15.4-94.5C553,665.6,553.4,664.1,553.7,662.8z"/>
+	<path class="st1" d="M553.6,1319.7c-22.4-107.4-27.4-215.3-28.7-323.3c3.3-2.5,6.4-1.5,9.3-1.5c23.3,0.3,46.7,0.7,70,1.1
+		c9.5,0.1,9.2-1.2,9.2,9.2c0,72.3,0,144.7,0,217c0,13.3-0.1,26.7,0.1,40c0,3.6-0.7,6.2-3.8,8.6c-18.7,14.5-36.3,30.3-52.7,47.4
+		C556.3,1318.5,555.6,1318.7,553.6,1319.7z"/>
+	<path class="st1" d="M2119.8,1319.2c-6.7-6.5-12.1-12.3-18-17.5c-11.8-10.2-23.8-20.2-36-30.1c-4.2-3.4-5.9-7.1-5.9-12.7
+		c0.2-84.6,0.1-169.1,0.1-253.7c0-8.4,0.1-8.5,8-8.5c24.3-0.2,48.6-0.4,72.9-0.5c7.5,0,7.7,0,7.6,7.7c-0.3,45.6-1.9,91.2-5.1,136.7
+		c-2.7,39.9-6.7,79.6-12.5,119.1C2128.1,1279,2124.6,1298.3,2119.8,1319.2z"/>
+	<path class="st1" d="M2120.4,664.4c12.3,57.5,18.7,115.7,22.8,174.2c3.1,44.9,4.7,89.8,5.2,134.8c0,2.3-0.1,4.7,0.1,7
+		c0.3,4-1.7,5.2-5.4,5.1c-6.7-0.2-13.3-0.3-20-0.3c-18.3-0.1-36.7-0.2-55-0.4c-8-0.1-8.2-0.1-8.2-8.2c0-52.3,0-104.6,0-157
+		c0-32,0.2-64-0.2-96c-0.1-6.3,2-10.3,6.8-14.3c17.1-14.3,35.1-27.7,50.2-44.2C2117.5,664.3,2118.3,663.8,2120.4,664.4z"/>
+	<path class="st1" d="M878.7,1138.5c2,4.9,3.2,9.1,5.3,12.8c4,7.2,10.5,7.1,14.6,0c3-5.3,4.3-11.2,5.2-17.1c0.8-4.7,3.2-7.1,7.8-8.9
+		c37.6-14.8,76.3-25.6,115.5-34.7c5-1.1,6.6,0.4,7.3,4.9c0.6,3.5,0.7,8.4,5.3,8.5c5.3,0.1,5.5-5.2,5.8-9c0.5-7.1,3.9-10,10.9-11.2
+		c40-7,79.8-14.9,120.4-18c2.4-0.2,5.9-2.1,6.9,1.5c1,3.7,1.8,7.8,0.4,11.7c-0.7,1.8-2.9,1.2-4.4,1.5c-9.5,1.6-19.1,2.8-28.6,4.6
+		c-39.6,7.4-78.6,17-117,29.2c-59.9,19-116.5,45.2-170.8,76.4c-41.6,24-80.2,52.3-117.2,83.1c-39.4,32.8-74.3,69.6-105.4,110.2
+		c-3,3.9-6.2,7.7-9.4,11.6c-0.1,0.2-0.6,0.2-2.1,0.5c0.2-7-1.1-13.6,1.5-20.3c7.6-19.2,12.9-39.2,16.7-59.5
+		c1.8-9.6,6.2-17.5,12-24.8c17.2-21.7,36.5-41.5,58.8-58.9c3.4,2.2,3.5,6.6,5.4,9.8c4,7,7.8,14.4,17.4,14.4
+		c9.6,0,13.8-7.2,17.3-14.4c6.5-13.3,9.4-27.7,12.2-42c0.8-3.9,2.2-6.5,5.7-8.6C808.9,1171.4,842.7,1153.5,878.7,1138.5z"/>
+	<path class="st1" d="M1032.8,891.9c-42-9-82.2-20.4-121.3-35.7c-4.8-1.9-6.9-4.4-7.7-9c-0.9-5.6-2.3-11.1-4.8-16.2
+		c-1.5-3.2-3.7-5.9-7.3-6.1c-4.1-0.2-6.8,2.5-8.3,6.1c-1.6,3.6-2.8,7.4-4.7,12.2c-11.4-5.2-22.6-10-33.5-15.2
+		c-23.1-11.1-45.4-23.7-67.3-37.1c-4.3-2.6-6.6-5.5-7.5-10.7c-2.1-11.4-4.6-22.8-8.9-33.7c-2.1-5.3-4.2-10.5-7.8-15
+		c-7.6-9.4-17.5-9.4-25.3,0.1c-4.2,5.2-6,11.7-9.8,18.2c-11.1-9.9-22.3-18.8-32.2-28.9c-10.2-10.4-19.5-21.8-28.7-33.3
+		c-5.6-7-8.9-15.3-10.6-24.4c-3.7-19.3-8.6-38.3-16-56.5c-2.9-7.1-1.4-14.1-0.5-21.8c3.9,4.8,7.9,9.4,11.6,14.3
+		c23.7,32,51,60.7,80.1,87.7c19,17.6,39.4,33.9,59.9,49.7c45,34.7,93.8,63.3,144.7,87.9c39.2,18.9,79.8,34.7,121.6,47.1
+		c41.2,12.2,82.8,22.3,125.4,28.2c1,0.1,2,0.2,3,0.4c7.3,1.2,10.5,7.7,7,14.2c-1.3,2.3-3.4,1.7-5.3,1.6c-8-0.7-15.9-1.5-23.8-2.4
+		c-32.8-3.7-65.1-10.2-97.5-15.7c-7.1-1.2-11.5-3.9-11.7-11.6c0-1.3-0.4-2.6-0.8-3.9c-0.8-2.6-1.9-5.3-5.3-4.9
+		c-2.7,0.3-3.7,2.6-4.4,4.9C1034.4,885.3,1033.7,888.2,1032.8,891.9z"/>
+	<path class="st1" d="M1953.8,1233.7c3.8,1,5.8,3.4,8,5.3c21,19.1,40.7,39.4,57.6,62.2c3,4.1,4.9,8.4,6,13.5
+		c4.5,20.5,9.3,40.9,17.1,60.4c1.3,3.1,2.4,6.3,1.8,9.7c-0.6,3.6,2.4,8.9-2.1,10.4c-2.5,0.8-5.4-3.9-7.3-6.7
+		c-35.7-51.5-81-93.6-129.4-132.6c-40.8-32.9-84.7-61.2-131-85.6c-39.5-20.8-80.6-37.9-123-52c-45.9-15.2-92.6-26.8-140.3-34.3
+		c-6.2-1-12.4-2.7-18.7-3.1c-6.5-0.4-5.5-4.5-5.2-8.4c0.4-5.4,2.1-7.1,7.5-6.6c8.3,0.7,16.5,1.9,24.8,2.7
+		c33.2,3.4,65.8,10.1,98.6,15.7c6.3,1.1,9.2,3.4,9.6,10c0.2,3.6,0.3,9.3,5.3,9.6c6,0.4,5.5-5.6,6.3-9.5c0.7-3.9,2.4-5,6.2-4
+		c39.4,9.7,78.9,19.2,116.7,34.3c4.5,1.8,6.8,4.2,7.5,9.1c0.9,5.9,2.2,11.8,5.1,17.2c1.7,3.1,3.8,5.6,7.6,5.6c3.8,0,6-2.5,7.6-5.6
+		c0.9-1.8,1.7-3.6,2.3-5.5c2.8-7.7,2.9-7.9,9.9-4.7c32.6,15.3,64.6,31.4,95,50.8c3.4,2.2,5.1,4.7,5.8,8.6
+		c2.1,12.1,4.9,24.1,9.4,35.7c1.9,5,4.1,9.8,7.5,14c7.5,9.4,17.7,9.4,25.3,0C1948.9,1245.3,1950.9,1239.5,1953.8,1233.7z"/>
+	<path class="st1" d="M2043.6,585.1c0.9,7.5,1.7,14.1-0.8,20.4c-8,20.2-13.1,41.2-17.6,62.4c-0.9,4.4-2.6,8.3-5.2,11.7
+		c-17.8,23.8-38.4,45.2-60.6,64.9c-1.5,1.3-3.2,2.3-5.1,3.8c-2.9-5.3-5.1-10.4-8.2-14.9c-8-11.8-19.3-11.8-27.5-0.1
+		c-7.4,10.6-11.4,23-12.8,35.4c-1.7,14.6-9.4,22.2-21.3,29.3c-25.5,15.2-52.1,28.1-78.7,41.2c-2.4,1.2-5,2-7.3,3.1
+		c-2.7,1.3-4.3,0.7-5.2-2.2c-1-3.2-1.9-6.4-3.4-9.3c-4.2-7.7-10.8-7.7-15.1-0.1c-2.5,4.4-3.9,9.3-4.5,14.2c-0.8,7-4.2,10.7-11,13.3
+		c-27.5,10.2-55.4,18.9-83.9,25.7c-10,2.4-20.1,4.8-30,7.5c-3.8,1-5.4,0-6.1-3.9c-0.7-4-0.2-9.9-6.2-9.6c-5.1,0.2-5.3,6-5.4,9.5
+		c-0.1,7.5-4.3,9-10.5,10.2c-39.6,7.4-79.4,13.9-119.5,18.1c-2.8,0.3-6.7,2.3-8.1-1.3c-1.4-3.6-1.7-7.9-0.3-11.7
+		c0.9-2.4,3.9-2,6.2-2.4c13.8-2.4,27.6-4.4,41.3-7c42.1-8.2,83.5-19.3,124.2-33.1c57.6-19.6,112.2-45.7,163.9-77.3
+		c38.1-23.2,73.8-50.1,107.6-79.4c37.9-32.8,72.6-68.6,102.5-109C2037.5,591.3,2039.4,587.8,2043.6,585.1z"/>
+	<path class="st1" d="M777.2,1163.8c-0.9-7.9,1.2-15.4,2-23c4.4-45.1,6.3-90.3,6.6-135.6c0.1-8.6,0.2-8.7,8.8-8.7
+		c22-0.1,44-0.1,65.9,0c8.3,0,8.4,0.1,8.5,7.9c0.2,37.7,2,75.2,6.5,112.6c0.5,3.8,0.3,6-3.9,7.5c-31.7,11.3-62.2,25.3-92.6,39.6
+		C778.8,1164.3,778.4,1164.1,777.2,1163.8z"/>
+	<path class="st1" d="M776.8,817.8c3.1-0.6,4.7,0.6,6.5,1.4c28.2,13.5,56.6,26.5,86.2,36.8c5.4,1.9,6.7,4.3,6,10.1
+		c-4.5,36.7-6.3,73.6-6.4,110.6c0,8.1,0.7,8.3-8.1,8.3c-22.6-0.1-45.3,0-67.9-0.1c-7,0-7.1-0.2-7.2-7.3c-0.4-28.6-0.9-57.3-2.7-85.9
+		c-1.3-21.3-2.9-42.5-5.5-63.7C777.2,824.9,777.1,821.6,776.8,817.8z"/>
+	<path class="st1" d="M1896.4,1163.9c-3.3,0.5-5.7-1.5-8.4-2.8c-27.2-13.3-54.8-25.7-83.3-36.1c-7.4-2.7-7.2-2.9-6.3-10.6
+		c4.4-35.8,5.3-71.8,6.4-107.7c0.1-1.7,0.1-3.3,0-5c-0.3-3.8,1.3-5.4,5.2-5.3c6.3,0.2,12.7,0.1,19,0.1c16.7,0,33.3,0,50,0.1
+		c8.4,0,8.4,0.1,8.6,8.8c0.8,30.3,1.2,60.6,3.3,90.9c1.4,19.9,2.9,39.9,5.3,59.7C1896.5,1158.6,1897.4,1161.2,1896.4,1163.9z"/>
+	<path class="st1" d="M1896.8,817.7c-1.3,13.9-2.7,27.7-3.9,41.6c-3.5,38.5-4.5,77-5.2,115.6c0,1.7-0.2,3.3-0.1,5
+		c0.4,4-1.5,5.5-5.2,5.1c-1-0.1-2,0-3,0c-22.6,0-45.3-0.1-67.9,0.2c-5,0-6.8-1.2-6.8-6.6c-0.4-28.3-1.2-56.5-3.6-84.7
+		c-0.8-8.9-1.6-17.9-2.7-26.8c-0.9-7.6-1.1-7.8,6.5-10.6c23-8.7,45.8-17.8,67.9-28.7c6-2.9,12-5.7,18-8.6
+		C1892.5,818.3,1894.3,817.4,1896.8,817.7z"/>
+	<path class="st1" d="M908.3,1109.6c-1-4.4,0.4-8.6,0.8-12.8c2.5-30.9,4-61.8,4-92.9c0-7.4,0.2-7.5,7.9-7.5
+		c33.3-0.1,66.7-0.2,100-0.2c7.8,0,8.1,0.1,8,7.4c-0.3,22,1,44,2.3,65.9c0.3,4.5-1,6.5-5.5,7.4c-38.7,8.5-76.4,20.9-114.2,32.5
+		C910.7,1109.8,909.7,1109.6,908.3,1109.6z"/>
+	<path class="st1" d="M1765.3,1110.4c-9.6-3-18.1-5.6-26.6-8.4c-29.1-9.6-58.7-17.4-88.5-24.5c-8.9-2.1-8.1-1.4-7.6-10.4
+		c1.2-21,1.6-42,2.3-62.9c0.2-7.7,0.2-7.9,7.5-7.9c33.3,0,66.7,0.1,100,0.2c7.8,0,8.2,0.3,8.2,7.7c0.2,34,1.7,68,4.8,101.8
+		C1765.4,1106.9,1765.3,1107.9,1765.3,1110.4z"/>
+	<path class="st1" d="M908.8,872.2c2.8-1.1,5,0.8,7.5,1.5c36.1,10.3,71.6,22.9,108.5,30.5c5.5,1.1,6.7,3.6,6.4,8.8
+		c-1.3,21.9-2.6,43.9-2.1,65.9c0.1,4.7-1.2,6.5-6.1,6.4c-34.7-0.2-69.3-0.2-104-0.1c-4.1,0-6.1-1-6-5.6c0.4-35.6-2-71.2-4.8-106.7
+		C908.2,872.8,908.6,872.5,908.8,872.2z"/>
+	<path class="st1" d="M1765.6,872.4c-0.9,10.7-1.8,20.9-2.5,31.2c-1.7,24.6-2.4,49.2-2.6,73.8c-0.1,7.7-0.2,7.8-7.7,7.8
+		c-33.6,0.1-67.2,0.1-100.8,0.1c-6.9,0-6.9-0.2-7.1-7.1c-0.8-21.9-1.3-43.9-2.6-65.8c-0.3-5.4,1.8-7,6.2-8
+		c14.5-3.5,29-7.1,43.5-10.8c22.5-5.7,44.5-13.5,66.7-20.3C1760.5,872.7,1762.3,871.8,1765.6,872.4z"/>
+	<path class="st1" d="M725.8,1192.5c-5.9-34.3-8.8-67.4-11-100.6c-1.8-27.6-2.2-55.2-3-82.8c-0.1-2.3,0.1-4.7-0.1-7
+		c-0.4-4.4,1.6-5.8,5.9-5.7c9,0.2,18,0,27,0c6.7,0,13.3-0.1,20,0c7.2,0.1,7.4,0.2,7.3,7.1c-0.5,23.6-1,47.2-2,70.8
+		c-1.2,27.2-3.3,54.4-6.7,81.5c-0.2,1.3-0.3,2.6-0.4,4c-0.4,9.2-3.4,16-13,19.7C741.7,1182.7,734.5,1187.7,725.8,1192.5z"/>
+	<path class="st1" d="M1946.2,1191.7c-10.1-5.6-20.4-11.5-30.8-17.2c-3.3-1.8-3.1-5-3.5-7.8c-1.4-10.2-2.4-20.5-3.5-30.7
+		c-4.7-43.8-6-87.7-6.7-131.6c-0.1-7.7,0.1-7.8,7.7-7.8c15.3-0.1,30.6,0.1,46-0.1c4.6-0.1,6.5,1.1,6.4,6.1
+		c-0.5,34-1.2,67.9-3.7,101.8c-2,26.9-4.5,53.7-8.9,80.4C1948.7,1187,1949.1,1189.5,1946.2,1191.7z"/>
+	<path class="st1" d="M1947.7,789.1c5.8,32.7,8.6,63.8,10.8,95c2.1,30.6,2.8,61.2,3.1,91.9c0.1,9.6,0.3,8.9-8.3,8.9
+		c-15,0-30-0.1-45,0.2c-5.3,0.1-6.9-1.8-6.7-7c0.9-25.3,1.3-50.6,2.5-75.9c1.3-27.3,3.9-54.4,6.9-81.6c0.9-8.3,3.3-14.2,11.5-17.8
+		C1930.8,799.2,1938.6,794.1,1947.7,789.1z"/>
+	<path class="st1" d="M726,789.2c11.3,6.2,21.7,11.9,32.2,17.5c2.9,1.6,2.8,4.2,3.2,6.8c2.7,15.8,4.1,31.7,5.5,47.6
+		c3.3,37.2,4.5,74.5,5,111.8c0,2.3,0,4.7,0.1,7c0.1,3.1-0.8,5-4.4,5c-17-0.1-34-0.1-51-0.1c-3.3,0-4.8-1.5-4.7-4.8
+		c0.2-5.7,0-11.3,0.2-17c1-42.6,2.7-85.2,7.3-127.7C720.9,820.5,722.6,805.7,726,789.2z"/>
+	<path class="st1" d="M1625.1,910.5c-0.6,9.4-1.4,18-1.7,26.5c-0.4,13-0.4,26-0.6,38.9c-0.1,9.3-0.2,9.4-9.2,9.4
+		c-30.6,0.1-61.3,0.1-91.9,0.1c-8.3,0-16.7-0.1-25,0.1c-4.2,0.1-5.9-1.3-5.9-5.7c0-15-0.1-30-0.7-44.9c-0.2-4.8,2.5-5.5,6-6
+		c10.9-1.3,21.8-3.6,32.7-3.7c23.9-0.2,46.7-6.5,70-10C1607.1,913.9,1615.2,912.2,1625.1,910.5z"/>
+	<path class="st1" d="M1625.2,1071.1c-23.5-4.2-45.7-8.1-67.9-12.1c-7.9-1.4-15.8-2.4-23.8-2.5c-12.7-0.1-25.1-2.6-37.7-4
+		c-4-0.4-5.8-1.6-5.6-6.1c0.5-14.6,0.6-29.3,0.6-43.9c0-4.5,1-6.5,6.1-6.5c39.9,0.2,79.9,0.2,119.8,0.1c5,0,6.1,2.1,6.1,6.6
+		C1622.9,1025,1623,1047.3,1625.2,1071.1z"/>
+	<path class="st1" d="M1049.3,1070.4c-1-5.9-0.1-11.8,0.3-17.7c0.9-16.3,1.4-32.6,1.4-48.9c0-7.3,0.2-7.5,6.8-7.5
+		c39.3-0.1,78.5-0.1,117.8-0.1c7,0,7.1,0.2,7.2,7.2c0.2,14,0,27.9,0.5,41.9c0.2,5.2-1.5,6.6-6.6,7c-16.9,1.3-33.8,2.7-50.6,5.2
+		c-23.3,3.4-46.7,6.8-69.7,12.3C1054.2,1070.3,1051.9,1071.4,1049.3,1070.4z"/>
+	<path class="st1" d="M1049.8,910.2c22.1,5.7,44.8,8.7,67.4,12.5c16.4,2.8,33.1,3.3,49.6,5.2c16.4,1.9,16.4,1.5,16.3,17.4
+		c-0.1,11-0.3,22-0.2,32.9c0.1,4.9-1,7.2-6.6,7.2c-39.9-0.2-79.9-0.2-119.8-0.1c-3.4,0-5.7-0.6-5.6-4.8c0.6-22.6-1.3-45.2-1.9-67.8
+		C1049,912,1049.4,911.4,1049.8,910.2z"/>
+	<path class="st1" d="M1260.5,985.4c-21.6,0-43.2,0-64.9,0c-8,0-8.2-0.1-8.1-8.4c0.2-13.6,0.6-27.3,0.8-40.9c0.1-4.2,1.4-5.6,6-5.1
+		c41.7,4.1,83.5,6.2,125.5,6.2c2.3,0,4.7,0,7,0c7.5,0.2,7.5,0.2,7.6,7.9c0.1,10.3,0.1,20.6,0.1,30.9c0,9.3,0,9.4-9.1,9.4
+		C1303.8,985.4,1282.2,985.4,1260.5,985.4z"/>
+	<path class="st1" d="M1485,931.5c0.3,16.2,0.5,32.7,0.8,49.3c0.1,3.4-1.7,4.8-4.9,4.6c-2-0.1-4,0-6,0c-41.6,0-83.2,0-124.9,0
+		c-2,0-4-0.1-6,0c-4,0.3-5.1-1.8-5-5.5c0.1-11.7,0-23.3,0.1-35c0.1-7.6,0.1-7.8,7.6-7.8c17.3,0.2,34.6-0.6,51.9-1.1
+		c26.3-0.7,52.5-3.1,78.7-5.1C1479.6,930.9,1481.8,930,1485,931.5z"/>
+	<path class="st1" d="M1485,1051.1c-35.4-3-69.9-5.3-104.5-6.4c-11.6-0.4-23.3-0.5-34.9-0.4c-4.4,0-6.7-0.8-6.5-6
+		c0.4-12,0.3-24,0-36c-0.1-4.8,1.6-6.3,6.3-6.2c45,0.1,89.9,0.1,134.9,0c3.5,0,5.8,0.7,5.7,4.8
+		C1485.5,1017.5,1485.3,1034.1,1485,1051.1z"/>
+	<path class="st1" d="M1188.4,1050.6c-0.3-17.2-0.5-33.7-0.8-50.3c0-2.9,1.6-4.1,4.4-4.1c1.7,0,3.3,0,5,0c42.6,0,85.1,0,127.7,0
+		c1.7,0,3.3,0.1,5,0c3.3-0.2,4.9,1.2,4.9,4.6c-0.1,13-0.1,25.9,0,38.9c0,3.6-1.7,4.7-4.9,4.5c-0.7,0-1.3,0-2,0
+		C1281.6,1043.7,1235.9,1047.2,1188.4,1050.6z"/>
+	<path class="st1" d="M2010.7,1230.1c-5.1-1.9-9-5.1-13.1-7.7c-9.9-6.1-19.6-12.6-29.8-18.3c-4.8-2.6-5.5-5.6-4.5-10.4
+		c3.9-20,6.2-40.1,8.2-60.4c4-41.2,5.8-82.4,6.1-123.8c0-3,0.1-6,0-9c-0.1-3,1.1-3.8,4.1-4.1c16.5-1.5,16.7-1.4,16.8,14.7
+		c0.4,66.4,3.9,132.5,10.7,198.6C2009.9,1216.3,2011.6,1222.7,2010.7,1230.1z"/>
+	<path class="st1" d="M2011.2,752.5c-1.6,16.9-3.2,33.8-4.8,50.6c-3,30.8-4.6,61.7-6.1,92.6c-1.3,27.3-1.5,54.5-1.8,81.8
+		c-0.1,7.1-0.2,7.3-7.1,7.3c-16.3,0-13.6,1.3-13.7-12.8c-0.5-54.3-3.2-108.4-10.6-162.2c-1.1-7.9-2.5-15.8-3.9-23.6
+		c-0.7-3.6-0.1-6,3.5-8.2c13.4-8,26.6-16.4,39.8-24.7C2007.6,752.8,2008.5,751.7,2011.2,752.5z"/>
+	<path class="st1" d="M662.1,1231.5c1.9-20.4,3.7-38.6,5.4-56.8c3-31.9,4.7-63.8,6-95.8c1-24.6,1.6-49.3,1.6-74
+		c0-8.3,0.1-8.3,7.9-8.4c1.3,0,2.7,0,4,0c8.6,0.1,8.7,0.1,8.8,8.7c0.4,40,1.8,80,5.4,119.8c2,22.9,4.4,45.8,9,68.3
+		c1.1,5.5,0.2,8.5-5.1,11c-12.7,6-23.9,14.5-35.5,22.2C667.7,1227.9,665.8,1229.1,662.1,1231.5z"/>
+	<path class="st1" d="M662.9,752.1c2.6-0.9,3.9,1,5.4,2.1c12.4,8.4,24.6,17.1,38,23.9c3.3,1.7,5,3.6,4.2,7.7
+		c-11.3,61.8-13.7,124.4-14.8,187c-0.2,13.5,2.2,12.1-12.3,12.1c-8.4,0-8.5-0.1-8.5-8.9c0.1-52.7-2.6-105.3-6.4-157.8
+		c-1.5-20.6-4-41.1-6-61.7C662.5,755.1,661.9,753.4,662.9,752.1z"/>
+	<path class="st1" d="M2044.3,728.6c0,3.4,0,6.3,0,9.2c0,78.9,0,157.9,0,236.8c0,1.7-0.1,3.3,0,5c0.4,3.9-1.3,5.4-5.2,5.3
+		c-5.9-0.2-11.9,0-18.3,0c0-26.3,0.3-51.6,1.3-76.8c1.7-42.3,4.4-84.5,8.9-126.5c1.6-14.9,3.9-29.7,5.6-44.6
+		C2037.2,732.4,2038.9,729.7,2044.3,728.6z"/>
+	<path class="st1" d="M2044.3,1253c-5.6-1.2-7-4.1-7.7-8.6c-3.1-19.4-5.2-38.9-7-58.5c-5.6-59-8.7-118.2-8.7-177.6
+		c0-13.6-1.4-11.7,11.5-11.8c13.3,0,11.9-1.5,11.9,11.5c0,78.6,0,157.2,0,235.8C2044.3,1246.6,2044.3,1249.3,2044.3,1253z"/>
+	<path class="st1" d="M629.2,728.7c5.8,1.6,7.4,4.6,7.9,9c2.3,21.2,5.3,42.2,7.3,63.4c5.3,55.3,7.7,110.8,8.5,166.4
+		c0,3.3,0.1,6.7,0,10c-0.1,7.5-0.1,7.5-7.7,7.7c-16,0.5-16,0.5-16-15.3c0-76.5,0-153.1,0-229.6C629.2,736.7,629.2,733,629.2,728.7z"
+		/>
+	<path class="st1" d="M629.2,1253.2c0-6,0-10.6,0-15.3c0-75.7,0-151.3,0-227c0-2,0-4,0-6c-0.1-9.2-0.3-8.7,8.7-8.6
+		c15.1,0,15.2,0,15,15.6c-0.7,62.7-3.8,125.2-10.3,187.6c-1.5,14.9-3.9,29.7-5.5,44.6C636.6,1248.7,634.5,1251.1,629.2,1253.2z"/>
+	<path class="st1" d="M2060,697.5c0-15.9,0-29.5,0-43c0-3.7,0.3-7.3-0.1-11c-2-19,6.4-34.8,15.3-50.5c1-1.7,2.3-3.2,3.6-4.7
+		c5.4-6.2,8.1-6.2,13.4,0.4c6.3,7.8,10.3,17.1,13.7,26.4c3.2,8.7,5.9,17.6,8.7,26.5c1.3,4,1,7.1-2.4,10.7
+		C2096.7,668.2,2079,681.6,2060,697.5z"/>
+	<path class="st1" d="M613.2,1283.1c0,24.5,1.5,47.6-0.5,70.3c-1.4,15.4-9,29.8-19.7,41.7c-3.8,4.2-5.7,3.9-10-0.4
+		c-4.3-4.3-7.2-9.6-9.8-15c-6.7-13.8-11.2-28.4-15.3-43.2c-0.8-3-1.3-5.6,1.5-8.1C576.3,1313,592.4,1296.7,613.2,1283.1z"/>
+	<path class="st1" d="M2060,1284.4c19.3,15.5,36.8,29.3,52.5,45.2c2.6,2.6,3.7,5.1,2.6,8.8c-5.1,17.2-10,34.5-19.7,50
+		c-7.7,12.2-12.4,12.7-19.8,0.6c-9.5-15.4-16.9-31.4-15.8-50.5C2060.7,1321.2,2060,1303.9,2060,1284.4z"/>
+	<path class="st1" d="M611.9,698.2c-8.5-6.7-17.1-12.8-25-19.7c-9.1-7.8-17.5-16.4-26.3-24.5c-2.3-2.2-4-4.1-3-7.7
+		c5.3-18.2,10.3-36.5,20.4-52.8c7.8-12.7,12.8-13,20.4-0.3c8.9,14.9,16.3,30.2,15.1,48.6c-1,15.9-0.2,31.9-0.3,47.9
+		C613.2,692.2,614,694.9,611.9,698.2z"/>
+	<path class="st1" d="M1788.2,864c4.1,27,4.9,53.5,6.1,80.1c0.5,11.3,0.2,22.6,0.7,33.9c0.2,5.2-1.6,7.4-6.7,7.3
+		c-4.7-0.1-9.3-0.3-14,0c-4.6,0.3-5.5-2-5.4-6c0.2-26.3,1.3-52.5,3.2-78.8c0.5-7.6,1.2-15.2,2.1-22.8
+		C1775.6,867.2,1775.7,867.2,1788.2,864z"/>
+	<path class="st1" d="M885.3,1118.4c-5.1-39.1-6.6-77.6-6.6-116.3c0-4.2,1.3-5.9,5.7-5.8c25,0.7,20.1-4.1,19.8,19.4
+		c-0.4,29.6-1.5,59.3-5,88.8C897.9,1115.4,898.1,1115.4,885.3,1118.4z"/>
+	<path class="st1" d="M885.7,863.5c12.4,2.1,12.2,2.1,13.5,13.8c3.8,33,4.6,66.2,5.3,99.4c0.2,8.3,0,8.5-7.9,8.4
+		c-5.6-0.1-12.6,2.4-16.3-1.2c-3.8-3.6-1.3-10.7-1.3-16.2c0.1-33.9,1.8-67.7,6.1-101.4C885.1,865.4,885.4,864.5,885.7,863.5z"/>
+	<path class="st1" d="M1788.4,1117.5c-4,0.3-6.2-1.5-8.7-2.2c-3.2-0.9-4.6-2.9-4.9-6.5c-0.7-10.3-2.2-20.5-2.9-30.8
+		c-1.5-24.6-2.8-49.2-2.8-73.9c0-7.5,0.1-7.8,7.7-7.6c5.9,0.2,13.3-2.7,17.2,1.6c3.4,3.7,1,10.9,0.9,16.5
+		C1794.3,1048.8,1792.8,1083.1,1788.4,1117.5z"/>
+	<path class="st1" d="M1481.1,1078.1c-10.7,0.3-20.5-1.5-30.3-2.6c-34.1-3.7-68.2-5.9-102.5-5.6c-1.3,0-2.7-0.1-4,0
+		c-4.9,0.5-5.1-2.5-5.2-6.2c-0.1-4,0.7-6,5.4-6c20,0.1,39.9-0.2,59.9,1c22.9,1.4,45.8,3,68.7,4.7c7.9,0.6,7.8,0.9,8.2,8.7
+		C1481.2,1073.7,1481.1,1075.4,1481.1,1078.1z"/>
+	<path class="st1" d="M1480,903c2,3.3,0.7,6.3,1,9.2c0.4,4.3-1.6,5.6-5.8,5.9c-42.2,3.3-84.3,6.2-126.7,5.9c-1.3,0-2.7-0.1-4,0
+		c-4.5,0.5-5.5-1.7-5.6-5.8c-0.1-4.5,0.9-6.6,6-6.5c29.7,0.7,59.2-1.5,88.8-3.9C1449.3,906.5,1464.7,904.6,1480,903z"/>
+	<path class="st1" d="M1192.2,1078.2c1-14.7,0.9-15,13.5-15.8c40.5-2.9,80.9-5.4,121.6-4.6c7.3,0.1,7.4,0.5,7.3,7
+		c-0.1,4-1.7,5.2-5.4,5.1c-6-0.2-12-0.1-18,0c-37.3,0.2-74.3,3.2-111.3,7.8C1197.6,1078,1195.3,1078,1192.2,1078.2z"/>
+	<path class="st1" d="M1192.6,903.2c17.2,2.2,33.7,3.8,50.2,5c28.2,2.1,56.4,4.4,84.7,3.6c3.8-0.1,7.3-0.4,7.1,5.4
+		c-0.3,6.3-0.2,6.8-6.6,6.8c-18.6,0-37.2,0.4-55.9-0.8c-19.2-1.2-38.5-2.1-57.8-3.2c-3-0.2-6-0.4-8.9-0.8
+		C1192.8,917.6,1192.8,917.6,1192.6,903.2z"/>
+	<path class="st1" d="M653.6,694.6c2.5,2.7,3.4,3.5,4.2,4.6c15.1,20.9,32.8,39.4,51.8,56.7c2.5,2.3,7.7,4.8,5,8.5
+		c-2.7,3.9-6.2-1-8.9-2.4c-14.7-7.8-28.1-17.9-42.2-26.6c-3.1-1.9-4.3-4.4-4.8-8C657.4,717,655.5,706.9,653.6,694.6z"/>
+	<path class="st1" d="M654,1284.6c0.9-5.5,2.7-11,2.6-16.4c-0.1-14.4,6.3-23.8,19.2-30.2c10.6-5.3,20.3-12.5,30.5-18.8
+		c2.5-1.5,4.9-3.3,7.8-3.6c1.6,2.1,1.5,4,0.2,5.7c-1,1.3-2.4,2.3-3.6,3.4c-18.4,17.3-36.5,34.8-51.2,55.5c-1.1,1.6-2.6,2.9-4,4.3
+		C655.3,1284.8,654.8,1284.6,654,1284.6z"/>
+	<path class="st1" d="M2019.1,698.8c-1.4,9.8-3,19.6-4.2,29.5c-0.4,3-2.2,4.7-4.4,6.2c-15.3,9.9-30.7,19.7-46.1,29.5
+		c-1.5,1-3.7,4-5.7,0.4c-1.5-2.6,0.2-4.4,2.1-5.9c11.9-9.2,21.5-20.7,32.4-30.8c8.4-7.7,14.5-17.2,21.4-26.1c0.9-1.2,2-2.4,3-3.6
+		C2018.1,698.2,2018.6,698.5,2019.1,698.8z"/>
+	<path class="st1" d="M2017.1,1283.9c-11.8-19.6-28.7-34.6-44.6-50.5c-3.7-3.7-7.8-7.2-11.8-10.6c-1.9-1.7-3.4-3.4-1.7-5.9
+		c1.7-2.4,3.5-0.5,5,0.5c15.7,10,31.3,20,46.9,30c2,1.3,3.5,2.9,3.9,5.4c1.4,10.1,2.9,20.2,4.4,30.4
+		C2018.5,1283.4,2017.8,1283.7,2017.1,1283.9z"/>
+	<path class="st1" d="M1044.6,1034c-0.6,11-1.1,21.9-1.7,32.9c-0.1,1.6-0.3,3.3-0.8,4.9c-0.3,0.8-1.4,1.6-2.2,1.7
+		c-0.9,0.1-1.9-0.5-2.1-1.7c-0.1-1-0.3-2-0.4-3c-1.2-22.2-2.3-44.5-2.4-66.8c0-3.2,0-6,4.6-5.9c3.5,0.1,5.6,0.7,5.5,4.9
+		c-0.2,11-0.1,21.9-0.1,32.9C1044.9,1034,1044.8,1034,1044.6,1034z"/>
+	<path class="st1" d="M1636.4,1033.8c0,10.6,0,21.2,0,31.8c0,2-0.3,4-0.7,5.9c-0.2,0.8-1.2,1.8-1.9,1.8c-0.8,0-1.9-0.8-2.2-1.5
+		c-0.5-1.2-0.5-2.6-0.6-3.9c-1.9-21.8-2.2-43.7-2.1-65.6c0-5.7,1.3-6.7,6-6.1c3.9,0.5,3.6,3.1,3.6,5.8c0,10.6,0,21.2,0,31.8
+		C1637.8,1033.8,1637.1,1033.8,1636.4,1033.8z"/>
+	<path class="st1" d="M1638.5,948.1c0,10.3,0,20.6,0,31c0,2.6,0.5,5.4-3.3,6.2c-4.4,0.9-6.4-0.5-6.4-5.8c0-19,0-38,1.4-56.9
+		c0.2-3,0.4-6,0.7-9c0.2-2.2-0.3-5.4,3-5.2c2.5,0.1,2.2,3,2.3,4.9c0.6,11.6,1.1,23.3,1.6,34.9C1638,948.1,1638.2,948.1,1638.5,948.1
+		z"/>
+	<path class="st1" d="M1045.1,948c0,10.6-0.1,21.2,0,31.9c0,3.6-0.9,5.5-5,5.5c-3.9-0.1-5.1-1.7-5.1-5.4c0.1-22.6,1.2-45.1,2.5-67.7
+		c0.1-1.6-0.1-3.7,2-4c2.8-0.4,3.1,1.9,3.2,3.9c0.7,11.9,1.3,23.9,1.9,35.8C1044.8,948,1044.9,948,1045.1,948z"/>
+	<path class="st1" d="M741.9,740.1c7,10.8,9.7,22,12.6,34.5c-8.1-3.6-13.5-8.9-19.7-13c-2-1.3-2-3.3-1.2-5.3
+		C735.6,751.1,737,745.6,741.9,740.1z"/>
+	<path class="st1" d="M1931.7,1241.3c-6.9-10.6-9.7-21.7-12.1-33.3c4.2,0.4,6.4,3.1,9.1,4.9
+		C1943.2,1223.1,1943.4,1224.7,1931.7,1241.3z"/>
+	<path class="st1" d="M1931.6,740c12,17.2,11.9,18.3-3.6,29.1c-2.4,1.7-4.5,3.9-8.5,4.8C1921.8,761.9,1925,750.9,1931.6,740z"/>
+	<path class="st1" d="M742.1,1241.3c-5.3-5.2-6.5-11.1-8.6-16.5c-0.8-2-0.5-3.8,1.6-5.1c6-3.9,11.2-9.1,19.2-12.6
+		C751.8,1219.5,748.7,1230.3,742.1,1241.3z"/>
+	<path class="st1" d="M599.6,517.5c0.6,0.1,1.4,0.1,1.9,0.4c12.6,7.1,13,7.9,10.7,24.4c-5.9-7.9-11-15.2-13.4-24.1
+		C599,518,599.3,517.7,599.6,517.5z"/>
+	<path class="st1" d="M597.6,1464.4c4-9.4,8.1-17.2,14-24.4C614.9,1455.5,614.5,1457.9,597.6,1464.4z"/>
+	<path class="st1" d="M2072.4,516.4c2.2,0.6,2.3,2,1.3,3.7c-3.8,6.1-7.7,12.1-11.9,18.6c-2.8-10.6-2.1-12.7,5.3-17.8
+		c1.9-1.3,4.2-2,5.3-4.3L2072.4,516.4z"/>
+	<path class="st1" d="M2061.5,1442.5c4.7,8.5,10.5,14.5,12.5,22.8C2067.2,1459.8,2056.4,1456.8,2061.5,1442.5z"/>
+	<path class="st1" d="M1781.6,836.9c4.2,9.3,4.2,9.3-1.8,12.6C1777.9,845.4,1780.6,842.1,1781.6,836.9z"/>
+	<path class="st1" d="M895.4,849.3c-7.5-2.9-7.5-2.9-3.8-11.1C893.8,841.3,893.9,844.7,895.4,849.3z"/>
+	<path class="st1" d="M630.1,1284.6c-0.2-5.4-2.7-11,1.8-17C634.2,1274.4,629.7,1279.3,630.1,1284.6z"/>
+	<path class="st1" d="M629.9,697.1c0.5,5.4,3.9,10.3,2.4,16.6C626.9,708.5,630.1,702.5,629.9,697.1z"/>
+	<path class="st1" d="M2044.5,1284.5c-2.2-5-4.3-9.2-2.8-15C2046.1,1274.3,2043.5,1279.4,2044.5,1284.5z"/>
+	<path class="st1" d="M2041.9,712.1c-2.2-6,1.1-10.1,2.2-14.6C2043.5,702.2,2046,707.4,2041.9,712.1z"/>
+	<path class="st1" d="M892.2,1143.9c-4.6-7.9-4.6-7.9,1.6-11.5C895.7,1136.5,892.6,1139.7,892.2,1143.9z"/>
+	<path class="st1" d="M1779.6,1132.2c6.1,3.1,6.1,3.1,2.7,11.1c-1.9-1-1.7-3.1-2.3-4.6C1779.2,1137,1778.6,1135.1,1779.6,1132.2z"/>
+	<path class="st1" d="M1934.8,1202.5c4.1-0.6,6.5,2.5,11.4,4.9c-6.3,0.5-8.2-3.5-11.3-5.1L1934.8,1202.5z"/>
+	<path class="st1" d="M1935.8,777c3.1,0.9,4.5-3.5,7.8-2.9c-1.8,4-4.7,3.9-7.9,2.8L1935.8,777z"/>
+	<path class="st1" d="M729.5,774c2.7-0.5,4.4,0.6,5.8,3.2C732.1,778,731,775.7,729.5,774z"/>
+	<path class="st1" d="M734,1202.5c2.3,4.6-1.2,4.8-4.2,5.9c-0.6-3.7,3.7-3.3,4.2-5.7C734,1202.7,734,1202.5,734,1202.5z"/>
+	<path class="st1" d="M1935.2,780.3c-0.4,0.2-0.8,0.5-1.2,0.7c0.3,0,0.6,0.1,0.8,0c0.2-0.1,0.4-0.3,0.6-0.5
+		C1935.5,780.5,1935.2,780.3,1935.2,780.3z"/>
+	<path class="st1" d="M740,1203.1c-1.9-0.8-4.2,2.9-6-0.5c0,0,0,0.2,0,0.1C736,1202.8,738,1202.9,740,1203.1L740,1203.1z"/>
+	<path class="st1" d="M1935.7,777c1.4,1.3,0.9,2.4-0.5,3.3c0,0,0.3,0.3,0.3,0.3c0.1-1.2,0.3-2.3,0.4-3.5
+		C1935.8,777,1935.7,777,1935.7,777z"/>
+	<path class="st1" d="M737.9,778.4c0.2,0.2,0.4,0.5,0.6,0.7c-0.2,0.2-0.5,0.5-0.7,0.5c-0.2,0-0.4-0.4-0.6-0.6
+		C737.4,778.8,737.7,778.6,737.9,778.4z"/>
+	<path class="st1" d="M740,1203.1c0-0.3,0-0.8-0.2-1c-0.8-0.8-0.7-1.1,0.4-0.8C739.5,1201.9,739.4,1202.4,740,1203.1
+		C740,1203.1,740,1203.1,740,1203.1z"/>
+	<path class="st1" d="M1934.9,1202.3c0-0.2-0.1-0.3-0.1-0.5c0,0-0.1,0.1-0.1,0.1c0.1,0.2,0.1,0.4,0.2,0.6
+		C1934.8,1202.5,1934.9,1202.3,1934.9,1202.3z"/>
+	<path class="st1" d="M2072.4,516.6c0.7,0.4,1.4,0.8,2.1,1.2c-0.2,0.2-0.4,0.7-0.6,0.7c-1.1-0.2-1.5-1-1.4-2
+		C2072.4,516.4,2072.4,516.6,2072.4,516.6z"/>
+	<path class="st1" d="M598.7,518.3c-1-0.2-1.8-0.8-1-1.6c0.8-0.9,1.4,0,1.8,0.8C599.3,517.7,599,518,598.7,518.3z"/>
+</g>
+</svg>

docs/_static/tractor_logo_nav_dark.svg

@@ -0,0 +1,458 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 24.2.1, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 2670 1980" style="enable-background:new 0 0 2670 1980;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:#FCFCFB;}
+	.st1{fill:none;}
+</style>
+<g>
+	<path class="st0" d="M2275.3,1000.1c-0.1,2.3,0,4.7,0,7c0,189.3,0,378.7,0,568c0,6,0.1,12.1-0.8,17.9c-2.4,15.2-12.9,17.4-23.6,10
+		c-45.4-31-91.2-61.4-136.9-91.9l-30.1-20.3c-9.8-6.3-19.2-13.2-29.2-19.3c-6.7-4.1-9.8-9.7-9.9-17.2c-0.1-9.3-0.6-18.7-0.3-28
+		c0.2-7.3-1.7-13-6.5-19c-18.6-23.3-36.2-47.3-56.9-69c-18-18.8-36.7-36.8-56.4-53.8c-31.8-27.5-65.4-52.7-101-74.9
+		c-32.7-20.4-66.8-38.4-102.2-54c-50.7-22.4-103.2-39.2-157.1-51.5c-36.7-8.4-73.8-14.4-111.2-18.5c-34.5-3.8-69-6.5-103.7-5.8
+		c-23.1,0.5-46.2-1.3-69.3,0.4c-22.9,1.8-45.9,3-68.7,5.6c-72.7,8.4-143.7,24.6-212.1,50.6c-65.5,24.8-127.4,57-184.9,97.4
+		c-46.8,32.8-90.1,69.8-129.5,111.1c-18.1,19-35.1,39.2-50.5,60.6c-3.9,5.5-5.5,11-5.3,17.6c0.4,9.3,0,18.7,0,28
+		c0,9.3-3.1,16.4-11.8,21.4c-10.4,5.9-19.9,13.4-30.1,19.8l-25.4,17.2c-11.6,7.8-23.3,15.5-34.9,23.3c-34.3,23-68.6,46-102.9,69
+		c-14.6,9.7-23.6,5.5-25.2-12.1c-0.5-5.3-0.5-10.7-0.5-16c0-189.7,0-379.3,0-569l-0.1-26.1c0.2-190.3,0.1-380.7,0.2-571
+		c0-5.7,0.4-11.3,0.5-17c0.1-3.7,1.2-7.3,3-10.5c3.4-5.9,9.3-7.7,15.4-4.8c2.7,1.3,5.1,3.1,7.6,4.8c44.3,29.6,88.5,59.3,132.8,88.9
+		l29.7,20.1c10.8,6.6,20.9,14.3,31.7,20.9c6.7,4.1,9.7,9.8,9.8,17.3c0.2,11,0.4,22,0.2,33c-0.1,5.2,1.2,9.6,4.2,13.9
+		c15.4,22.2,33,42.8,51.6,62.2c53.9,56.4,114.1,105.1,181.4,144.6c38.4,22.6,78.3,42.4,119.9,58.6c40,15.6,80.9,28.3,122.8,38
+		c52.7,12.1,106,19.3,160,22.6c18.3,1.1,36.6,2.1,54.9,1.5c17.7-0.6,35.5,1.1,53.2-0.1c17.6-1.1,35.2-2.3,52.8-3.6
+		c35.9-2.5,71.4-8.5,106.7-15.1c53.4-9.9,105.5-25,156-45.1c53.8-21.5,105.1-48.2,153.2-80.9c43.4-29.5,83.6-62.7,121.1-99.3
+		c27.3-26.6,50.3-56.8,73.9-86.6c2.9-3.6,3.6-7.6,3.6-12.1c-0.1-10.7,0.2-21.3,0.4-32c0.1-7.5,3.2-13.1,9.9-17.2
+		c10.2-6.2,19.9-13.4,30-19.8l23.2-16.3c4.2-1.3,7.4-4.3,11-6.7c42.9-28.7,85.8-57.4,128.7-86.1c1.1-0.7,2.3-1.4,3.3-2.3
+		c10.9-9.1,21.4-4.7,23.8,10.7c0.8,5.6,0.6,11.3,0.6,17c0,189.3,0,378.7,0,568L2275.3,1000.1z M740,1203.1c-2-0.2-4-0.3-6-0.5
+		c-0.5,2.5-4.8,2-4.2,5.8c2.9-1,6.4-1.2,4.2-5.8C735.8,1206,738.1,1202.3,740,1203.1c-0.6-0.7-0.5-1.3,0.2-1.7
+		c-1.1-0.3-1.1-0.1-0.4,0.8C740,1202.3,739.9,1202.8,740,1203.1z M1935.5,780.5c-0.2,0.2-0.4,0.4-0.6,0.4c-0.3,0.1-0.6,0-0.8,0
+		c0.4-0.2,0.8-0.5,1.1-0.8c1.4-0.9,2-1.9,0.5-3.3c3.2,1.1,6.1,1.2,7.9-2.8c-3.3-0.7-4.6,3.8-7.7,2.9
+		C1935.7,778.2,1935.6,779.4,1935.5,780.5z M1934.8,1202.5c-0.1-0.2-0.1-0.4-0.2-0.6c0,0,0.1-0.1,0.1-0.1c0,0.2,0.1,0.3,0.1,0.5
+		c3.1,1.6,5,5.7,11.3,5.1C1941.3,1205,1938.9,1202,1934.8,1202.5z M2072.4,516.6c-1,2.3-3.4,3-5.3,4.3c-7.4,5.1-8.2,7.2-5.3,17.8
+		c4.2-6.5,8-12.6,11.9-18.6c1.1-1.7,0.9-3.1-1.3-3.6c0,1,0.3,1.8,1.4,2c0.2,0,0.4-0.4,0.6-0.7C2073.8,517.4,2073.1,517,2072.4,516.6
+		z M599.6,517.5c-0.4-0.8-1.1-1.7-1.8-0.8c-0.8,0.8,0.1,1.5,1,1.6c2.4,8.9,7.5,16.2,13.4,24.1c2.3-16.5,1.9-17.3-10.7-24.4
+		C600.9,517.6,600.2,517.6,599.6,517.5z M534.9,1353.5c-20,21.8-37.3,44.1-53.4,67.4c-16.1,23.4-26.8,49.5-41.8,73.5
+		c9-21,17.4-42.2,28.9-61.9c16.9-28.7,35.4-56.4,57.5-81.5c0.9-1,1.6-2.1,2.6-3.1c2.9-2.9,3.3-6,2.3-10
+		c-9.1-33.8-14.6-68.3-19.2-103c-5-38-8.3-76.1-10.6-114.3c-2.5-39.9-3.4-79.9-3.9-119.8c-0.1-5.1-1.4-6.8-6.7-6.9
+		c-21.6-0.2-43.3-0.8-64.9-1.3c-2,0-4-0.4-6,0.8c0,195.2,0,390.5,0,585.6c2.1,0.6,3.1-0.4,4.1-1.1c52.7-33.8,105.3-67.7,158-101.4
+		c3.6-2.3,5.7-5.4,7.3-9.1c6-13,12.5-25.8,20.8-37.4c4.2-5.9,3.9-11.9,2.5-19.1c-2.4,1.8-4,2.9-5.5,4.2
+		c-13.9,12.6-32.1,8.7-42.7-2.9c-7.3-8-12.4-17.2-17.1-26.8C542.3,1375.7,539.4,1365.1,534.9,1353.5z M534.6,627.2
+		c3.6-5,4.3-10.7,6.3-15.9c6.2-15.8,12.6-31.5,25.2-43.7c10.8-10.5,26.8-12.6,38.9-2.8c2.3,1.9,4.3,5,7.9,5
+		c1.6-8.3-0.2-15.3-5.1-21.9c-7.4-9.9-12.7-21-17.8-32.3c-2.4-5.3-5.8-9.2-10.8-12.4c-50.5-32.2-100.9-64.7-151.3-97.1
+		c-2.4-1.5-4.5-3.9-8.7-3.9c0,3.7,0,7.2,0,10.7c0,187.9,0,375.8,0,563.7c0,2,0.2,4,0,6c-0.6,4.9,1.4,6.3,6.2,6.1
+		c13.6-0.6,27.3-0.7,41-1c8.3-0.2,16.7-0.6,25-0.4c4.9,0.1,6.7-1.8,6.1-6.4c-0.1-1,0-2,0-3c1.2-75,4.3-149.8,13.7-224.3
+		c4.6-36.3,10-72.5,19.6-107.9c1.6-5.7,0.4-9.9-3.4-14.4c-10.7-12.8-21.7-25.4-31-39.1c-19-28.1-36.8-57-49.6-88.7
+		c-2.2-5.4-5.5-10.4-6.2-16.6C465,538.3,494.6,586,534.6,627.2z M2060.9,1411.1c-2.3,8.5-0.1,15.1,4,21.4
+		c5.9,9.3,13.4,18.1,17.1,28.2c3.9,10.7,10.9,16.6,19.9,22.4c47.8,30.3,95.3,61.1,143,91.7c2.7,1.7,5,4.3,9.5,4.5c0-3.4,0-6.6,0-9.8
+		c0-188.3,0-376.6,0-565c0-2-0.1-4,0-6c0.2-3.4-1.1-5-4.6-4.8c-2.3,0.1-4.7,0-7,0.1c-20,0.6-40,1.2-60,1.9c-6.7,0.2-6.7,0.4-7,7.4
+		c0,1.3,0,2.7-0.1,4c-0.4,60-3,119.9-8.9,179.7c-5,50.1-11.3,99.9-24,148.7c-1.4,5.2,0.1,8.3,3.5,12.3c15,17.8,29.6,36.1,42.4,55.5
+		c20,30.4,36.1,62.9,49.3,96.8c3.2,8.2,5.7,16.6,6.8,25.4c-33.9-90.8-82.6-145-107.2-169.7c-4.1,11-7.5,22.1-12.7,32.5
+		c-4.9,9.9-10.3,19.5-18.8,26.8c-7.1,6.1-15.1,8.9-24.8,7.5C2073.2,1421.4,2068.3,1415.5,2060.9,1411.1z M2244.8,454.3
+		c0.6,4.5-0.2,6.7-0.8,8.9c-6.5,24.2-17,47-28.2,69.2c-18.9,37.2-43,71.2-70.4,102.8c-2.7,3.2-3.6,5.8-2.5,9.8
+		c7.9,29.6,13.1,59.8,17.3,90.2c6.4,45.6,10.2,91.3,12.8,137.3c2,35.3,2.6,70.6,3.1,105.9c0.1,7.6,0.2,7.6,7.6,7.8
+		c17,0.5,34,1,51,1.4c5,0.1,10,0.2,15,0.5c3.2,0.1,5.1-0.9,4.9-4.5c-0.1-1.7,0-3.3,0-5c0-189.6,0-379.3-0.1-568.9
+		c0-2.4,1.1-5.2-1.2-7.3c-0.8,0.1-1.6,0-2.1,0.4c-52.7,33.8-105.3,67.7-158,101.5c-2,1.3-3.7,2.6-4.7,4.9c-6.9,16-16.9,30.1-25.8,45
+		c-3.1,5.2-3.4,10.2-2,15.7c2.6,0.1,3.5-1.6,4.6-2.6c15.7-13.9,33-10.6,45.6,3.8c6,6.8,10.4,14.6,14.4,22.7
+		c5.1,10.3,8.3,21.3,12.8,32.9C2185.2,576.1,2221.7,520.5,2244.8,454.3z M553.7,662.8c-0.3,1.3-0.7,2.8-1,4.3
+		c-7.1,31.2-11.7,62.8-15.4,94.5c-7.1,59.9-10.3,120.1-11.8,180.4c-0.3,13-0.2,26-0.5,39c-0.1,4.4,1.5,5.7,5.7,5.6
+		c25-0.5,50-0.7,74.9-1.1c7.4-0.1,7.6-0.2,7.6-7.8c0-85.6,0-171.2,0.1-256.8c0-5.3-1.7-8.5-5.8-11.7c-16.6-12.8-32.4-26.6-46.9-41.9
+		C559,665.6,557.6,663,553.7,662.8z M553.6,1319.7c2.1-1,2.8-1.2,3.2-1.6c16.4-17.1,34-32.9,52.7-47.4c3-2.4,3.8-5,3.8-8.6
+		c-0.1-13.3-0.1-26.7-0.1-40c0-72.3,0-144.7,0-217c0-10.3,0.4-9-9.2-9.2c-23.3-0.4-46.7-0.8-70-1.1c-2.8,0-5.9-1-9.3,1.5
+		C526.2,1104.4,531.1,1212.3,553.6,1319.7z M2119.8,1319.2c4.8-20.9,8.3-40.2,11.1-59.6c5.8-39.5,9.8-79.2,12.5-119.1
+		c3.1-45.5,4.7-91.1,5.1-136.7c0.1-7.6-0.1-7.7-7.6-7.7c-24.3,0.1-48.6,0.3-72.9,0.5c-7.9,0.1-8,0.1-8,8.5c0,84.6,0,169.1-0.1,253.7
+		c0,5.6,1.7,9.3,5.9,12.7c12.1,9.9,24.2,19.9,36,30.1C2107.7,1306.9,2113.1,1312.7,2119.8,1319.2z M2120.4,664.4
+		c-2.1-0.6-2.9-0.1-3.6,0.7c-15.2,16.5-33.1,29.9-50.2,44.2c-4.8,4-6.8,8-6.8,14.3c0.3,32,0.2,64,0.2,96c0,52.3,0,104.6,0,157
+		c0,8.1,0.1,8.2,8.2,8.2c18.3,0.2,36.7,0.2,55,0.4c6.7,0.1,13.3,0.1,20,0.3c3.7,0.1,5.7-1.1,5.4-5.1c-0.2-2.3,0-4.7-0.1-7
+		c-0.5-45-2.1-89.9-5.2-134.8C2139.2,780.1,2132.7,721.9,2120.4,664.4z M878.7,1138.5c-36,15-69.8,32.9-102.3,53.1
+		c-3.4,2.1-4.9,4.7-5.7,8.6c-2.8,14.4-5.7,28.8-12.2,42c-3.6,7.3-7.7,14.4-17.3,14.4c-9.6,0-13.4-7.4-17.4-14.4
+		c-1.9-3.2-2-7.6-5.4-9.8c-22.3,17.4-41.6,37.2-58.8,58.9c-5.8,7.3-10.2,15.3-12,24.8c-3.8,20.3-9.1,40.2-16.7,59.5
+		c-2.6,6.7-1.3,13.3-1.5,20.3c1.5-0.4,2-0.3,2.1-0.5c3.2-3.8,6.4-7.6,9.4-11.6c31.2-40.5,66-77.4,105.4-110.2
+		c36.9-30.8,75.6-59.1,117.2-83.1c54.3-31.2,110.9-57.4,170.8-76.4c38.4-12.2,77.4-21.8,117-29.2c9.5-1.8,19.1-3,28.6-4.6
+		c1.5-0.3,3.8,0.3,4.4-1.5c1.4-3.9,0.6-8-0.4-11.7c-1-3.6-4.5-1.7-6.9-1.5c-40.6,3.2-80.4,11-120.4,18c-7,1.2-10.4,4.1-10.9,11.2
+		c-0.3,3.8-0.5,9.1-5.8,9c-4.6-0.1-4.7-5-5.3-8.5c-0.7-4.5-2.4-6-7.3-4.9c-39.3,9.1-78,19.9-115.5,34.7c-4.6,1.8-7.1,4.2-7.8,8.9
+		c-0.9,5.9-2.2,11.8-5.2,17.1c-4.1,7.1-10.6,7.2-14.6,0C881.9,1147.7,880.7,1143.4,878.7,1138.5z M1032.8,891.9
+		c0.9-3.8,1.6-6.7,2.4-9.5c0.7-2.3,1.7-4.6,4.4-4.9c3.4-0.3,4.4,2.3,5.3,4.9c0.4,1.3,0.8,2.6,0.8,3.9c0.1,7.7,4.5,10.4,11.7,11.6
+		c32.5,5.5,64.8,11.9,97.5,15.7c7.9,0.9,15.9,1.7,23.8,2.4c1.9,0.2,4,0.7,5.3-1.6c3.5-6.5,0.3-13-7-14.2c-1-0.2-2-0.2-3-0.4
+		c-42.6-5.8-84.2-15.9-125.4-28.2c-41.8-12.4-82.5-28.2-121.6-47.1c-51-24.6-99.8-53.3-144.7-87.9c-20.6-15.8-40.9-32.1-59.9-49.7
+		c-29.1-26.9-56.4-55.7-80.1-87.7c-3.7-4.9-7.7-9.6-11.6-14.3c-0.8,7.6-2.4,14.7,0.5,21.8c7.4,18.2,12.4,37.2,16,56.5
+		c1.7,9.1,5,17.3,10.6,24.4c9.2,11.4,18.5,22.8,28.7,33.3c9.9,10.1,21.1,19,32.2,28.9c3.8-6.5,5.6-13,9.8-18.2
+		c7.7-9.4,17.7-9.5,25.3-0.1c3.6,4.5,5.7,9.7,7.8,15c4.3,10.9,6.8,22.3,8.9,33.7c0.9,5.2,3.3,8.1,7.5,10.7
+		c21.9,13.4,44.1,26,67.3,37.1c10.9,5.2,22.1,10,33.5,15.2c1.8-4.8,3.1-8.6,4.7-12.2c1.6-3.5,4.2-6.3,8.3-6.1
+		c3.6,0.2,5.8,2.9,7.3,6.1c2.4,5.2,3.8,10.6,4.8,16.2c0.8,4.6,2.9,7.2,7.7,9C950.6,871.5,990.8,883,1032.8,891.9z M1953.8,1233.7
+		c-2.9,5.8-4.9,11.5-8.8,16.2c-7.6,9.3-17.8,9.3-25.3,0c-3.4-4.2-5.5-9-7.5-14c-4.4-11.5-7.2-23.5-9.4-35.7
+		c-0.7-3.9-2.4-6.4-5.8-8.6c-30.4-19.4-62.4-35.6-95-50.8c-6.9-3.3-7-3-9.9,4.7c-0.7,1.9-1.5,3.7-2.3,5.5c-1.6,3.1-3.7,5.6-7.6,5.6
+		c-3.8,0-5.9-2.5-7.6-5.6c-2.9-5.4-4.3-11.3-5.1-17.2c-0.7-5-3-7.3-7.5-9.1c-37.8-15.2-77.3-24.6-116.7-34.3c-3.8-0.9-5.4,0.2-6.2,4
+		c-0.7,3.9-0.2,9.9-6.3,9.5c-5-0.3-5.1-6.1-5.3-9.6c-0.4-6.6-3.3-8.9-9.6-10c-32.8-5.6-65.4-12.2-98.6-15.7
+		c-8.3-0.9-16.5-2.1-24.8-2.7c-5.4-0.4-7.1,1.2-7.5,6.6c-0.3,3.9-1.3,8,5.2,8.4c6.3,0.4,12.4,2.1,18.7,3.1
+		c47.7,7.5,94.4,19.1,140.3,34.3c42.4,14,83.5,31.2,123,52c46.3,24.4,90.2,52.6,131,85.6c48.5,39.1,93.7,81.2,129.4,132.6
+		c1.9,2.8,4.8,7.5,7.3,6.7c4.5-1.5,1.4-6.8,2.1-10.4c0.6-3.4-0.5-6.6-1.8-9.7c-7.8-19.5-12.6-40-17.1-60.4c-1.1-5.1-3-9.4-6-13.5
+		c-17-22.8-36.7-43.1-57.6-62.2C1959.6,1237.1,1957.6,1234.7,1953.8,1233.7z M2043.6,585.1c-4.2,2.7-6.2,6.2-8.5,9.2
+		c-29.9,40.3-64.6,76.1-102.5,109c-33.8,29.3-69.5,56.2-107.6,79.4c-51.8,31.6-106.3,57.7-163.9,77.3
+		c-40.7,13.8-82.1,24.9-124.2,33.1c-13.7,2.7-27.6,4.7-41.3,7c-2.2,0.4-5.3-0.1-6.2,2.4c-1.4,3.8-1.1,8.2,0.3,11.7
+		c1.4,3.5,5.3,1.6,8.1,1.3c40.1-4.2,79.8-10.7,119.5-18.1c6.2-1.2,10.4-2.7,10.5-10.2c0-3.5,0.3-9.3,5.4-9.5c6-0.3,5.5,5.7,6.2,9.6
+		c0.7,3.9,2.3,4.9,6.1,3.9c10-2.7,20-5.1,30-7.5c28.5-6.9,56.4-15.6,83.9-25.7c6.8-2.5,10.2-6.3,11-13.3c0.5-5,2-9.8,4.5-14.2
+		c4.2-7.6,10.8-7.6,15.1,0.1c1.6,2.9,2.5,6.2,3.4,9.3c0.9,2.9,2.5,3.5,5.2,2.2c2.4-1.2,5-1.9,7.3-3.1c26.6-13.1,53.2-26,78.7-41.2
+		c11.9-7.1,19.6-14.7,21.3-29.3c1.4-12.4,5.5-24.8,12.8-35.4c8.1-11.7,19.5-11.7,27.5,0.1c3.1,4.6,5.4,9.7,8.2,14.9
+		c1.9-1.4,3.6-2.5,5.1-3.8c22.2-19.8,42.7-41.1,60.6-64.9c2.6-3.5,4.3-7.3,5.2-11.7c4.5-21.2,9.6-42.2,17.6-62.4
+		C2045.3,599.2,2044.5,592.6,2043.6,585.1z M777.2,1163.8c1.2,0.2,1.6,0.4,1.9,0.3c30.4-14.3,60.9-28.3,92.6-39.6
+		c4.2-1.5,4.4-3.7,3.9-7.5c-4.5-37.4-6.3-75-6.5-112.6c0-7.8-0.2-7.9-8.5-7.9c-22,0-44,0-65.9,0c-8.6,0-8.8,0.1-8.8,8.7
+		c-0.4,45.3-2.2,90.5-6.6,135.6C778.4,1148.4,776.3,1155.9,777.2,1163.8z M776.8,817.8c0.3,3.8,0.5,7.1,0.9,10.4
+		c2.5,21.2,4.1,42.4,5.5,63.7c1.8,28.6,2.3,57.2,2.7,85.9c0.1,7.1,0.3,7.3,7.2,7.3c22.6,0.1,45.3,0.1,67.9,0.1
+		c8.8,0,8.1-0.2,8.1-8.3c0.1-37,1.9-73.9,6.4-110.6c0.7-5.8-0.5-8.2-6-10.1c-29.5-10.3-58-23.3-86.2-36.8
+		C781.5,818.4,779.9,817.2,776.8,817.8z M1896.4,1163.9c1-2.7,0.2-5.3-0.1-7.9c-2.4-19.8-3.9-39.8-5.3-59.7
+		c-2.1-30.3-2.5-60.6-3.3-90.9c-0.2-8.7-0.2-8.8-8.6-8.8c-16.7-0.1-33.3,0-50-0.1c-6.3,0-12.7,0.2-19-0.1c-3.9-0.1-5.5,1.4-5.2,5.3
+		c0.1,1.7,0.1,3.3,0,5c-1.1,36-2,72-6.4,107.7c-0.9,7.7-1.1,7.9,6.3,10.6c28.5,10.4,56.1,22.9,83.3,36.1
+		C1890.6,1162.4,1893.1,1164.4,1896.4,1163.9z M1896.8,817.7c-2.5-0.3-4.3,0.6-6.1,1.5c-6,2.9-12,5.6-18,8.6
+		c-22.1,10.9-44.9,20.1-67.9,28.7c-7.5,2.8-7.3,3-6.5,10.6c1,8.9,1.9,17.9,2.7,26.8c2.4,28.2,3.2,56.5,3.6,84.7
+		c0.1,5.4,1.8,6.7,6.8,6.6c22.6-0.2,45.3-0.1,67.9-0.2c1,0,2-0.1,3,0c3.8,0.3,5.6-1.2,5.2-5.1c-0.2-1.6,0-3.3,0.1-5
+		c0.7-38.6,1.7-77.2,5.2-115.6C1894.1,845.4,1895.5,831.6,1896.8,817.7z M908.3,1109.6c1.4,0,2.4,0.2,3.2,0
+		c37.8-11.7,75.5-24,114.2-32.5c4.5-1,5.8-2.9,5.5-7.4c-1.3-22-2.5-43.9-2.3-65.9c0.1-7.3-0.2-7.4-8-7.4c-33.3,0-66.7,0.1-100,0.2
+		c-7.7,0-7.9,0.1-7.9,7.5c0,31-1.6,61.9-4,92.9C908.8,1101,907.3,1105.2,908.3,1109.6z M1765.3,1110.4c0-2.5,0.1-3.5,0-4.4
+		c-3.1-33.9-4.7-67.8-4.8-101.8c0-7.4-0.4-7.6-8.2-7.7c-33.3-0.1-66.7-0.2-100-0.2c-7.3,0-7.2,0.1-7.5,7.9c-0.7,21-1.1,42-2.3,62.9
+		c-0.5,9-1.3,8.3,7.6,10.4c29.8,7.1,59.4,14.9,88.5,24.5C1747.2,1104.8,1755.7,1107.4,1765.3,1110.4z M908.8,872.2
+		c-0.2,0.3-0.6,0.6-0.6,0.8c2.8,35.5,5.2,71,4.8,106.7c-0.1,4.6,1.9,5.6,6,5.6c34.7-0.1,69.3-0.1,104,0.1c4.9,0,6.2-1.8,6.1-6.4
+		c-0.5-22,0.8-44,2.1-65.9c0.3-5.2-0.9-7.7-6.4-8.8c-36.9-7.6-72.4-20.1-108.5-30.5C913.8,873,911.6,871.1,908.8,872.2z
+		 M1765.6,872.4c-3.2-0.6-5.1,0.3-7,0.9c-22.2,6.7-44.2,14.5-66.7,20.3c-14.5,3.7-29,7.3-43.5,10.8c-4.4,1.1-6.5,2.6-6.2,8
+		c1.3,21.9,1.8,43.9,2.6,65.8c0.2,7,0.2,7.1,7.1,7.1c33.6,0,67.2,0,100.8-0.1c7.5,0,7.7-0.2,7.7-7.8c0.2-24.6,0.9-49.2,2.6-73.8
+		C1763.8,893.4,1764.7,883.1,1765.6,872.4z M725.8,1192.5c8.7-4.8,15.8-9.8,23.8-12.8c9.6-3.7,12.7-10.5,13-19.7
+		c0.1-1.3,0.2-2.7,0.4-4c3.4-27.1,5.6-54.3,6.7-81.5c1-23.6,1.5-47.2,2-70.8c0.2-7-0.1-7-7.3-7.1c-6.7-0.1-13.3,0-20,0
+		c-9,0-18,0.2-27,0c-4.2-0.1-6.2,1.3-5.9,5.7c0.2,2.3,0,4.7,0.1,7c0.8,27.6,1.2,55.2,3,82.8C717,1125.1,719.9,1158.2,725.8,1192.5z
+		 M1946.2,1191.7c2.9-2.2,2.4-4.7,2.8-6.9c4.5-26.6,6.9-53.5,8.9-80.4c2.5-33.9,3.2-67.9,3.7-101.8c0.1-5-1.8-6.2-6.4-6.1
+		c-15.3,0.2-30.6,0-46,0.1c-7.6,0-7.8,0.2-7.7,7.8c0.7,44,2,87.9,6.7,131.6c1.1,10.3,2.2,20.5,3.5,30.7c0.4,2.8,0.2,6,3.5,7.8
+		C1925.8,1180.2,1936.2,1186.1,1946.2,1191.7z M1947.7,789.1c-9.1,5-16.9,10.1-25.3,13.8c-8.2,3.6-10.5,9.5-11.5,17.8
+		c-3,27.1-5.6,54.3-6.9,81.6c-1.2,25.3-1.5,50.6-2.5,75.9c-0.2,5.1,1.5,7,6.7,7c15-0.3,30-0.1,45-0.2c8.6,0,8.4,0.6,8.3-8.9
+		c-0.3-30.6-1-61.3-3.1-91.9C1956.3,852.9,1953.6,821.8,1947.7,789.1z M726,789.2c-3.3,16.4-5.1,31.3-6.7,46.2
+		c-4.6,42.4-6.3,85-7.3,127.7c-0.1,5.7,0,11.3-0.2,17c-0.1,3.4,1.4,4.8,4.7,4.8c17,0,34,0,51,0.1c3.6,0,4.6-1.9,4.4-5
+		c-0.1-2.3-0.1-4.7-0.1-7c-0.5-37.3-1.7-74.6-5-111.8c-1.4-15.9-2.8-31.9-5.5-47.6c-0.4-2.6-0.3-5.2-3.2-6.8
+		C747.6,801.1,737.2,795.4,726,789.2z M1625.1,910.5c-9.8,1.8-18,3.4-26.2,4.6c-23.3,3.5-46.2,9.9-70,10
+		c-10.9,0.1-21.8,2.4-32.7,3.7c-3.5,0.4-6.2,1.1-6,6c0.5,15,0.7,30,0.7,44.9c0,4.4,1.7,5.8,5.9,5.7c8.3-0.2,16.6,0,25-0.1
+		c30.6,0,61.3,0,91.9-0.1c9,0,9-0.1,9.2-9.4c0.2-13,0.2-26,0.6-38.9C1623.7,928.4,1624.5,919.8,1625.1,910.5z M1625.2,1071.1
+		c-2.2-23.8-2.3-46.1-2.4-68.4c0-4.5-1-6.6-6.1-6.6c-39.9,0.1-79.9,0.1-119.8-0.1c-5.1,0-6.1,2-6.1,6.5c0,14.6-0.1,29.3-0.6,43.9
+		c-0.1,4.5,1.6,5.6,5.6,6.1c12.6,1.4,25,3.8,37.7,4c8,0.1,15.9,1.1,23.8,2.5C1579.5,1063,1601.7,1066.9,1625.2,1071.1z
+		 M1049.3,1070.4c2.6,1,4.9-0.1,7-0.6c23-5.5,46.3-8.9,69.7-12.3c16.7-2.5,33.7-3.8,50.6-5.2c5.1-0.4,6.8-1.9,6.6-7
+		c-0.4-14-0.3-27.9-0.5-41.9c-0.1-7-0.2-7.2-7.2-7.2c-39.3,0-78.5,0-117.8,0.1c-6.7,0-6.8,0.2-6.8,7.5c0,16.3-0.5,32.6-1.4,48.9
+		C1049.3,1058.6,1048.4,1064.5,1049.3,1070.4z M1049.8,910.2c-0.4,1.2-0.8,1.8-0.8,2.4c0.6,22.6,2.5,45.2,1.9,67.8
+		c-0.1,4.2,2.1,4.8,5.6,4.8c39.9,0,79.9-0.1,119.8,0.1c5.5,0,6.7-2.3,6.6-7.2c-0.2-11,0.1-22,0.2-32.9c0.1-15.9,0.1-15.5-16.3-17.4
+		c-16.5-1.9-33.1-2.4-49.6-5.2C1094.7,918.9,1072,915.9,1049.8,910.2z M1260.5,985.4c21.6,0,43.2,0,64.9,0c9.1,0,9.1-0.1,9.1-9.4
+		c0-10.3,0-20.6-0.1-30.9c-0.1-7.7-0.1-7.7-7.6-7.9c-2.3-0.1-4.7,0-7,0c-41.9,0-83.8-2.2-125.5-6.2c-4.6-0.4-5.9,0.9-6,5.1
+		c-0.2,13.6-0.6,27.3-0.8,40.9c-0.1,8.3,0.1,8.4,8.1,8.4C1217.3,985.4,1238.9,985.4,1260.5,985.4z M1485,931.5
+		c-3.1-1.4-5.4-0.6-7.7-0.4c-26.2,1.9-52.4,4.3-78.7,5.1c-17.3,0.5-34.6,1.3-51.9,1.1c-7.4-0.1-7.5,0.1-7.6,7.8
+		c-0.1,11.7,0,23.3-0.1,35c0,3.7,1,5.8,5,5.5c2-0.1,4,0,6,0c41.6,0,83.2,0,124.9,0c2,0,4-0.1,6,0c3.3,0.1,5-1.2,4.9-4.6
+		C1485.5,964.2,1485.3,947.6,1485,931.5z M1485,1051.1c0.3-17,0.5-33.6,0.9-50.1c0.1-4.2-2.2-4.8-5.7-4.8c-45,0.1-89.9,0.1-134.9,0
+		c-4.7,0-6.5,1.4-6.3,6.2c0.3,12,0.4,24,0,36c-0.2,5.2,2.1,6,6.5,6c11.6-0.1,23.3,0.1,34.9,0.4
+		C1415,1045.8,1449.5,1048.1,1485,1051.1z M1188.4,1050.6c47.5-3.4,93.2-6.8,139.2-6.4c0.7,0,1.3,0,2,0c3.2,0.2,4.9-0.9,4.9-4.5
+		c-0.1-13,0-25.9,0-38.9c0-3.4-1.6-4.8-4.9-4.6c-1.7,0.1-3.3,0-5,0c-42.6,0-85.1,0-127.7,0c-1.7,0-3.3,0.1-5,0
+		c-2.8-0.1-4.4,1.1-4.4,4.1C1187.9,1016.8,1188.1,1033.4,1188.4,1050.6z M2010.7,1230.1c0.9-7.3-0.9-13.8-1.5-20.3
+		c-6.8-66-10.3-132.2-10.7-198.6c-0.1-16.1-0.3-16.3-16.8-14.7c-2.9,0.3-4.2,1.1-4.1,4.1c0.1,3,0,6,0,9
+		c-0.3,41.3-2.1,82.6-6.1,123.8c-2,20.2-4.3,40.4-8.2,60.4c-0.9,4.8-0.2,7.8,4.5,10.4c10.2,5.7,19.9,12.2,29.8,18.3
+		C2001.8,1225,2005.6,1228.2,2010.7,1230.1z M2011.2,752.5c-2.7-0.8-3.6,0.3-4.7,1c-13.3,8.3-26.4,16.7-39.8,24.7
+		c-3.6,2.1-4.2,4.5-3.5,8.2c1.4,7.8,2.8,15.7,3.9,23.6c7.4,53.8,10.1,107.9,10.6,162.2c0.1,14.1-2.6,12.8,13.7,12.8
+		c7,0,7-0.2,7.1-7.3c0.4-27.3,0.6-54.6,1.8-81.8c1.4-30.9,3.1-61.8,6.1-92.6C2008,786.3,2009.6,769.5,2011.2,752.5z M662.1,1231.5
+		c3.7-2.4,5.6-3.7,7.5-4.9c11.6-7.7,22.9-16.2,35.5-22.2c5.3-2.5,6.2-5.5,5.1-11c-4.6-22.5-7-45.4-9-68.3
+		c-3.5-39.9-5-79.8-5.4-119.8c-0.1-8.6-0.2-8.6-8.8-8.7c-1.3,0-2.7,0-4,0c-7.9,0.1-8,0.1-7.9,8.4c0,24.7-0.6,49.3-1.6,74
+		c-1.3,32-3,63.9-6,95.8C665.8,1192.9,664.1,1211.1,662.1,1231.5z M662.9,752.1c-1,1.4-0.4,3-0.3,4.6c2,20.5,4.6,41.1,6,61.7
+		c3.8,52.5,6.5,105.1,6.4,157.8c0,8.8,0.1,8.9,8.5,8.9c14.5-0.1,12.1,1.3,12.3-12.1c1.1-62.7,3.5-125.2,14.8-187
+		c0.8-4.1-0.9-6-4.2-7.7c-13.4-6.8-25.6-15.5-38-23.9C666.8,753.1,665.5,751.1,662.9,752.1z M2044.3,728.6c-5.4,1.1-7.1,3.9-7.7,8.3
+		c-1.7,14.9-4,29.7-5.6,44.6c-4.6,42.1-7.2,84.2-8.9,126.5c-1,25.3-1.3,50.5-1.3,76.8c6.5,0,12.4-0.1,18.3,0
+		c3.8,0.1,5.5-1.4,5.2-5.3c-0.2-1.7,0-3.3,0-5c0-78.9,0-157.9,0-236.8C2044.3,734.9,2044.3,732,2044.3,728.6z M2044.3,1253
+		c0-3.7,0-6.4,0-9c0-78.6,0-157.2,0-235.8c0-13,1.3-11.5-11.9-11.5c-13,0-11.5-1.8-11.5,11.8c0,59.3,3.1,118.5,8.7,177.6
+		c1.9,19.5,4,39.1,7,58.5C2037.3,1248.9,2038.8,1251.8,2044.3,1253z M629.2,728.7c0,4.3,0,8,0,11.6c0,76.5,0,153.1,0,229.6
+		c0,15.8,0,15.8,16,15.3c7.6-0.2,7.6-0.2,7.7-7.7c0.1-3.3,0-6.7,0-10c-0.8-55.6-3.1-111.1-8.5-166.4c-2-21.2-5-42.3-7.3-63.4
+		C636.6,733.3,635,730.3,629.2,728.7z M629.2,1253.2c5.3-2.1,7.4-4.5,7.9-9.2c1.6-14.9,4-29.7,5.5-44.6
+		c6.5-62.4,9.5-124.9,10.3-187.6c0.2-15.6,0.1-15.6-15-15.6c-9,0-8.8-0.6-8.7,8.6c0,2,0,4,0,6c0,75.7,0,151.3,0,227
+		C629.2,1242.5,629.2,1247.2,629.2,1253.2z M2060,697.5c19-15.9,36.7-29.3,52.3-45.3c3.5-3.5,3.7-6.7,2.4-10.7
+		c-2.8-8.9-5.4-17.8-8.7-26.5c-3.5-9.3-7.4-18.5-13.7-26.4c-5.3-6.6-8-6.6-13.4-0.4c-1.3,1.5-2.7,3-3.6,4.7
+		c-8.9,15.7-17.3,31.5-15.3,50.5c0.4,3.6,0.1,7.3,0.1,11C2060,668,2060,681.5,2060,697.5z M613.2,1283.1
+		c-20.8,13.6-36.9,29.9-53.8,45.4c-2.8,2.6-2.3,5.1-1.5,8.1c4.1,14.7,8.6,29.3,15.3,43.2c2.6,5.4,5.4,10.7,9.8,15
+		c4.3,4.2,6.2,4.6,10,0.4c10.7-11.9,18.4-26.3,19.7-41.7C614.7,1330.6,613.2,1307.6,613.2,1283.1z M2060,1284.4
+		c0,19.5,0.7,36.8-0.2,54c-1.1,19.1,6.3,35.2,15.8,50.5c7.4,12.1,12.1,11.7,19.8-0.6c9.7-15.4,14.6-32.7,19.7-50
+		c1.1-3.7,0-6.2-2.6-8.8C2096.8,1313.6,2079.3,1299.9,2060,1284.4z M611.9,698.2c2.1-3.3,1.3-5.9,1.3-8.4c0.1-16-0.8-32,0.3-47.9
+		c1.2-18.4-6.2-33.8-15.1-48.6c-7.6-12.7-12.6-12.4-20.4,0.3c-10.1,16.3-15.1,34.6-20.4,52.8c-1,3.6,0.6,5.5,3,7.7
+		c8.8,8.1,17.3,16.7,26.3,24.5C594.8,685.4,603.3,691.5,611.9,698.2z M1788.2,864c-12.5,3.2-12.6,3.2-13.9,13.8
+		c-0.9,7.6-1.6,15.2-2.1,22.8c-1.8,26.2-2.9,52.5-3.2,78.8c0,4,0.8,6.3,5.4,6c4.6-0.3,9.3-0.2,14,0c5.1,0.1,6.9-2.1,6.7-7.3
+		c-0.5-11.3-0.2-22.6-0.7-33.9C1793.2,917.5,1792.3,890.9,1788.2,864z M885.3,1118.4c12.8-3,12.5-3,13.8-13.9
+		c3.5-29.5,4.6-59.1,5-88.8c0.3-23.5,5.2-18.7-19.8-19.4c-4.4-0.1-5.7,1.5-5.7,5.8C878.8,1040.8,880.3,1079.4,885.3,1118.4z
+		 M885.7,863.5c-0.2,0.9-0.6,1.9-0.7,2.9c-4.3,33.7-6,67.5-6.1,101.4c0,5.5-2.5,12.6,1.3,16.2c3.8,3.6,10.8,1.1,16.3,1.2
+		c7.9,0.1,8.1-0.1,7.9-8.4c-0.6-33.2-1.5-66.4-5.3-99.4C897.9,865.6,898,865.6,885.7,863.5z M1788.4,1117.5
+		c4.4-34.4,5.9-68.6,6.5-102.9c0.1-5.6,2.4-12.7-0.9-16.5c-3.9-4.3-11.3-1.4-17.2-1.6c-7.6-0.2-7.7,0.1-7.7,7.6
+		c0,24.7,1.3,49.3,2.8,73.9c0.6,10.3,2.2,20.5,2.9,30.8c0.3,3.6,1.7,5.5,4.9,6.5C1782.2,1116,1784.4,1117.7,1788.4,1117.5z
+		 M1481.1,1078.1c0-2.7,0.1-4.4,0-6c-0.3-7.8-0.3-8.1-8.2-8.7c-22.9-1.7-45.8-3.3-68.7-4.7c-19.9-1.2-39.9-0.9-59.9-1
+		c-4.6,0-5.5,2-5.4,6c0.1,3.7,0.3,6.7,5.2,6.2c1.3-0.1,2.7,0,4,0c34.3-0.3,68.4,1.9,102.5,5.6
+		C1460.6,1076.6,1470.4,1078.5,1481.1,1078.1z M1480,903c-15.3,1.6-30.8,3.6-46.3,4.8c-29.5,2.4-59.1,4.7-88.8,3.9
+		c-5.1-0.1-6.1,2-6,6.5c0.1,4.1,1.1,6.3,5.6,5.8c1.3-0.2,2.7,0,4,0c42.3,0.3,84.5-2.6,126.7-5.9c4.2-0.3,6.2-1.6,5.8-5.9
+		C1480.7,909.3,1482,906.3,1480,903z M1192.2,1078.2c3.1-0.2,5.4-0.3,7.6-0.5c37-4.6,74-7.6,111.3-7.8c6,0,12-0.1,18,0
+		c3.7,0.1,5.3-1.1,5.4-5.1c0.1-6.5,0-6.9-7.3-7c-40.6-0.8-81.1,1.7-121.6,4.6C1193.1,1063.3,1193.2,1063.6,1192.2,1078.2z
+		 M1192.6,903.2c0.2,14.4,0.2,14.4,12.8,16c3,0.4,6,0.6,8.9,0.8c19.3,1.1,38.5,2,57.8,3.2c18.6,1.2,37.2,0.8,55.9,0.8
+		c6.4,0,6.3-0.5,6.6-6.8c0.2-5.8-3.3-5.5-7.1-5.4c-28.3,0.8-56.5-1.5-84.7-3.6C1226.3,907,1209.8,905.4,1192.6,903.2z M653.6,694.6
+		c2,12.3,3.8,22.4,5.1,32.6c0.5,3.7,1.7,6.1,4.8,8c14.2,8.8,27.5,18.8,42.2,26.6c2.7,1.4,6.2,6.3,8.9,2.4c2.7-3.7-2.6-6.2-5-8.5
+		c-19-17.3-36.7-35.8-51.8-56.7C657,698.1,656,697.3,653.6,694.6z M654,1284.6c0.8,0,1.3,0.1,1.5,0c1.4-1.4,2.9-2.7,4-4.3
+		c14.6-20.8,32.8-38.3,51.2-55.5c1.2-1.1,2.6-2.1,3.6-3.4c1.4-1.7,1.5-3.6-0.2-5.7c-2.9,0.3-5.3,2.1-7.8,3.6
+		c-10.2,6.3-19.8,13.5-30.5,18.8c-12.9,6.4-19.3,15.7-19.2,30.2C656.6,1273.7,654.9,1279.1,654,1284.6z M2019.1,698.8
+		c-0.5-0.3-1-0.6-1.5-0.9c-1,1.2-2,2.4-3,3.6c-6.8,9-13,18.4-21.4,26.1c-11,10.1-20.5,21.7-32.4,30.8c-1.9,1.5-3.6,3.2-2.1,5.9
+		c2,3.5,4.1,0.5,5.7-0.4c15.4-9.7,30.8-19.6,46.1-29.5c2.3-1.5,4-3.1,4.4-6.2C2016.2,718.5,2017.7,708.6,2019.1,698.8z
+		 M2017.1,1283.9c0.7-0.2,1.4-0.5,2.1-0.7c-1.5-10.1-3-20.2-4.4-30.4c-0.4-2.6-1.9-4.1-3.9-5.4c-15.6-10-31.3-20.1-46.9-30
+		c-1.5-1-3.3-2.8-5-0.5c-1.7,2.4-0.3,4.2,1.7,5.9c4,3.4,8.1,6.9,11.8,10.6C1988.4,1249.3,2005.3,1264.3,2017.1,1283.9z M1044.6,1034
+		c0.2,0,0.3,0,0.5,0c0-11-0.1-21.9,0.1-32.9c0.1-4.2-2-4.8-5.5-4.9c-4.5-0.1-4.6,2.6-4.6,5.9c0.1,22.3,1.2,44.5,2.4,66.8
+		c0.1,1,0.2,2,0.4,3c0.2,1.2,1.2,1.8,2.1,1.7c0.8-0.1,1.9-1,2.2-1.7c0.5-1.5,0.7-3.2,0.8-4.9C1043.5,1055.9,1044,1045,1044.6,1034z
+		 M1636.4,1033.8c0.7,0,1.4,0,2.1,0c0-10.6,0-21.2,0-31.8c0-2.7,0.2-5.3-3.6-5.8c-4.7-0.6-6,0.4-6,6.1c-0.1,21.9,0.2,43.7,2.1,65.6
+		c0.1,1.3,0.1,2.7,0.6,3.9c0.3,0.7,1.5,1.6,2.2,1.5c0.7,0,1.7-1.1,1.9-1.8c0.5-1.9,0.7-3.9,0.7-5.9
+		C1636.4,1055,1636.4,1044.4,1636.4,1033.8z M1638.5,948.1c-0.2,0-0.5,0-0.7,0c-0.5-11.6-1-23.3-1.6-34.9c-0.1-1.9,0.2-4.8-2.3-4.9
+		c-3.3-0.1-2.8,3-3,5.2c-0.3,3-0.4,6-0.7,9c-1.5,19-1.4,37.9-1.4,56.9c0,5.3,2,6.8,6.4,5.8c3.8-0.8,3.3-3.6,3.3-6.2
+		C1638.5,968.8,1638.5,958.4,1638.5,948.1z M1045.1,948c-0.1,0-0.3,0-0.4,0c-0.6-11.9-1.2-23.9-1.9-35.8c-0.1-1.9-0.4-4.3-3.2-3.9
+		c-2.2,0.3-1.9,2.4-2,4c-1.3,22.5-2.3,45.1-2.5,67.7c0,3.7,1.2,5.4,5.1,5.4c4.1,0.1,5-1.9,5-5.5C1045,969.3,1045.1,958.7,1045.1,948
+		z M741.9,740.1c-4.9,5.5-6.3,11-8.3,16.2c-0.8,2-0.8,4,1.2,5.3c6.2,4.1,11.6,9.4,19.7,13C751.6,762.1,748.8,750.9,741.9,740.1z
+		 M1931.7,1241.3c11.7-16.6,11.5-18.2-3-28.3c-2.7-1.9-4.9-4.5-9.1-4.9C1921.9,1219.6,1924.7,1230.7,1931.7,1241.3z M1931.6,740
+		c-6.6,10.9-9.8,22-12.1,33.9c4-0.9,6.1-3.1,8.5-4.8C1943.5,758.3,1943.6,757.2,1931.6,740z M742.1,1241.3
+		c6.6-11.1,9.8-21.9,12.2-34.3c-8,3.6-13.2,8.8-19.2,12.6c-2,1.3-2.3,3.1-1.6,5.1C735.6,1230.2,736.7,1236.2,742.1,1241.3z
+		 M597.6,1464.4c16.9-6.5,17.3-8.9,14-24.4C605.8,1447.2,601.7,1455,597.6,1464.4z M2061.5,1442.5c-5.1,14.3,5.6,17.3,12.5,22.8
+		C2072.1,1457,2066.2,1451,2061.5,1442.5z M1781.6,836.9c-1,5.2-3.6,8.5-1.8,12.6C1785.7,846.2,1785.7,846.2,1781.6,836.9z
+		 M895.4,849.3c-1.5-4.5-1.6-7.9-3.8-11.1C887.9,846.3,887.9,846.3,895.4,849.3z M630.1,1284.6c-0.4-5.3,4.1-10.2,1.8-17
+		C627.4,1273.6,629.9,1279.2,630.1,1284.6z M629.9,697.1c0.2,5.4-3,11.4,2.4,16.6C633.8,707.4,630.4,702.5,629.9,697.1z
+		 M2044.5,1284.5c-1-5.2,1.5-10.3-2.8-15C2040.3,1275.4,2042.4,1279.6,2044.5,1284.5z M2041.9,712.1c4.1-4.8,1.6-10,2.2-14.6
+		C2043,702.1,2039.8,706.2,2041.9,712.1z M892.2,1143.9c0.4-4.2,3.5-7.3,1.6-11.5C887.6,1136,887.6,1136,892.2,1143.9z
+		 M1779.6,1132.2c-1,2.9-0.4,4.8,0.4,6.5c0.7,1.5,0.4,3.6,2.3,4.6C1785.7,1135.3,1785.7,1135.3,1779.6,1132.2z M729.5,774
+		c1.5,1.6,2.6,4,5.8,3.2C733.9,774.7,732.2,773.5,729.5,774z M737.9,778.4c-0.2,0.2-0.5,0.4-0.7,0.6c0.2,0.2,0.4,0.6,0.6,0.6
+		c0.2,0,0.5-0.3,0.7-0.5C738.4,778.8,738.1,778.6,737.9,778.4z"/>
+	<path class="st1" d="M534.9,1353.5c4.5,11.6,7.4,22.2,12.2,32c4.7,9.6,9.8,18.8,17.1,26.8c10.6,11.6,28.8,15.5,42.7,2.9
+		c1.4-1.3,3.1-2.4,5.5-4.2c1.4,7.2,1.7,13.2-2.5,19.1c-8.4,11.7-14.8,24.4-20.8,37.4c-1.7,3.7-3.7,6.7-7.3,9.1
+		c-52.7,33.7-105.3,67.6-158,101.4c-1.1,0.7-2.1,1.7-4.1,1.1c0-195.1,0-390.4,0-585.6c2.1-1.2,4.1-0.9,6-0.8
+		c21.6,0.5,43.3,1.1,64.9,1.3c5.3,0,6.7,1.8,6.7,6.9c0.5,40,1.4,79.9,3.9,119.8c2.4,38.2,5.6,76.4,10.6,114.3
+		c4.6,34.7,10.1,69.1,19.2,103c1.1,4,0.6,7.1-2.3,10c-0.9,0.9-1.7,2.1-2.6,3.1c-22.1,25.1-40.6,52.7-57.5,81.5
+		c-11.6,19.7-19.9,41-28.9,61.9c14.9-23.9,25.7-50.1,41.8-73.5C497.6,1397.6,514.9,1375.3,534.9,1353.5z"/>
+	<path class="st1" d="M534.6,627.2c-40-41.2-69.6-89-94.2-140.1c0.7,6.2,4,11.2,6.2,16.6c12.7,31.7,30.5,60.6,49.6,88.7
+		c9.3,13.7,20.4,26.3,31,39.1c3.8,4.5,5,8.7,3.4,14.4c-9.6,35.4-15,71.6-19.6,107.9c-9.4,74.5-12.5,149.3-13.7,224.3c0,1-0.1,2,0,3
+		c0.6,4.7-1.2,6.5-6.1,6.4c-8.3-0.2-16.7,0.2-25,0.4c-13.7,0.3-27.3,0.4-41,1c-4.8,0.2-6.8-1.2-6.2-6.1c0.3-2,0-4,0-6
+		c0-187.9,0-375.8,0-563.7c0-3.5,0-7.1,0-10.7c4.2-0.1,6.3,2.3,8.7,3.9c50.4,32.4,100.8,64.9,151.3,97.1c5,3.2,8.4,7.1,10.8,12.4
+		c5.1,11.2,10.4,22.4,17.8,32.3c4.9,6.6,6.7,13.5,5.1,21.9c-3.6-0.1-5.6-3.1-7.9-5c-12-9.8-28.1-7.7-38.9,2.8
+		c-12.6,12.2-19,27.9-25.2,43.7C538.8,616.5,538.2,622.2,534.6,627.2z"/>
+	<path class="st1" d="M2060.9,1411.1c7.4,4.3,12.3,10.3,20.6,11.4c9.8,1.4,17.7-1.4,24.8-7.5c8.5-7.3,13.9-16.9,18.8-26.8
+		c5.1-10.4,8.6-21.5,12.7-32.5c24.7,24.7,73.3,78.9,107.2,169.7c-1.1-8.8-3.5-17.2-6.8-25.4c-13.2-33.9-29.3-66.4-49.3-96.8
+		c-12.8-19.5-27.4-37.7-42.4-55.5c-3.4-4-4.8-7.1-3.5-12.3c12.8-48.8,19.1-98.6,24-148.7c5.9-59.7,8.4-119.6,8.9-179.7
+		c0-1.3,0-2.7,0.1-4c0.2-7,0.2-7.1,7-7.4c20-0.7,40-1.3,60-1.9c2.3-0.1,4.7,0,7-0.1c3.5-0.2,4.8,1.4,4.6,4.8c-0.1,2,0,4,0,6
+		c0,188.3,0,376.6,0,565c0,3.2,0,6.4,0,9.8c-4.5-0.2-6.9-2.8-9.5-4.5c-47.7-30.6-95.2-61.4-143-91.7c-9-5.7-16-11.6-19.9-22.4
+		c-3.7-10.1-11.2-18.9-17.1-28.2C2060.8,1426.2,2058.6,1419.6,2060.9,1411.1z"/>
+	<path class="st1" d="M2244.8,454.3c-23,66.2-59.6,121.8-106.6,172.4c-4.5-11.6-7.7-22.6-12.8-32.9c-4-8.1-8.4-15.8-14.4-22.7
+		c-12.6-14.4-29.9-17.7-45.6-3.8c-1.1,1-2,2.7-4.6,2.6c-1.4-5.5-1.1-10.5,2-15.7c8.8-14.9,18.9-29,25.8-45c1-2.3,2.7-3.7,4.7-4.9
+		c52.7-33.9,105.3-67.7,158-101.5c0.5-0.3,1.3-0.2,2.1-0.4c2.3,2.1,1.2,4.9,1.2,7.3c0.1,189.6,0.1,379.3,0.1,568.9
+		c0,1.7-0.1,3.3,0,5c0.2,3.6-1.7,4.6-4.9,4.5c-5-0.2-10-0.3-15-0.5c-17-0.5-34-1-51-1.4c-7.4-0.2-7.5-0.2-7.6-7.8
+		c-0.5-35.3-1.1-70.6-3.1-105.9c-2.6-45.9-6.4-91.7-12.8-137.3c-4.2-30.3-9.4-60.5-17.3-90.2c-1.1-4-0.2-6.6,2.5-9.8
+		c27.4-31.6,51.5-65.6,70.4-102.8c11.3-22.2,21.7-44.9,28.2-69.2C2244.6,460.9,2245.4,458.8,2244.8,454.3z"/>
+	<path class="st1" d="M553.7,662.8c3.8,0.2,5.2,2.8,6.9,4.6c14.5,15.2,30.3,29,46.9,41.9c4.1,3.2,5.8,6.4,5.8,11.7
+		c-0.2,85.6-0.1,171.2-0.1,256.8c0,7.5-0.1,7.7-7.6,7.8c-25,0.4-50,0.6-74.9,1.1c-4.3,0.1-5.9-1.2-5.7-5.6c0.4-13,0.2-26,0.5-39
+		c1.5-60.3,4.7-120.5,11.8-180.4c3.7-31.7,8.3-63.3,15.4-94.5C553,665.6,553.4,664.1,553.7,662.8z"/>
+	<path class="st1" d="M553.6,1319.7c-22.4-107.4-27.4-215.3-28.7-323.3c3.3-2.5,6.4-1.5,9.3-1.5c23.3,0.3,46.7,0.7,70,1.1
+		c9.5,0.1,9.2-1.2,9.2,9.2c0,72.3,0,144.7,0,217c0,13.3-0.1,26.7,0.1,40c0,3.6-0.7,6.2-3.8,8.6c-18.7,14.5-36.3,30.3-52.7,47.4
+		C556.3,1318.5,555.6,1318.7,553.6,1319.7z"/>
+	<path class="st1" d="M2119.8,1319.2c-6.7-6.5-12.1-12.3-18-17.5c-11.8-10.2-23.8-20.2-36-30.1c-4.2-3.4-5.9-7.1-5.9-12.7
+		c0.2-84.6,0.1-169.1,0.1-253.7c0-8.4,0.1-8.5,8-8.5c24.3-0.2,48.6-0.4,72.9-0.5c7.5,0,7.7,0,7.6,7.7c-0.3,45.6-1.9,91.2-5.1,136.7
+		c-2.7,39.9-6.7,79.6-12.5,119.1C2128.1,1279,2124.6,1298.3,2119.8,1319.2z"/>
+	<path class="st1" d="M2120.4,664.4c12.3,57.5,18.7,115.7,22.8,174.2c3.1,44.9,4.7,89.8,5.2,134.8c0,2.3-0.1,4.7,0.1,7
+		c0.3,4-1.7,5.2-5.4,5.1c-6.7-0.2-13.3-0.3-20-0.3c-18.3-0.1-36.7-0.2-55-0.4c-8-0.1-8.2-0.1-8.2-8.2c0-52.3,0-104.6,0-157
+		c0-32,0.2-64-0.2-96c-0.1-6.3,2-10.3,6.8-14.3c17.1-14.3,35.1-27.7,50.2-44.2C2117.5,664.3,2118.3,663.8,2120.4,664.4z"/>
+	<path class="st1" d="M878.7,1138.5c2,4.9,3.2,9.1,5.3,12.8c4,7.2,10.5,7.1,14.6,0c3-5.3,4.3-11.2,5.2-17.1c0.8-4.7,3.2-7.1,7.8-8.9
+		c37.6-14.8,76.3-25.6,115.5-34.7c5-1.1,6.6,0.4,7.3,4.9c0.6,3.5,0.7,8.4,5.3,8.5c5.3,0.1,5.5-5.2,5.8-9c0.5-7.1,3.9-10,10.9-11.2
+		c40-7,79.8-14.9,120.4-18c2.4-0.2,5.9-2.1,6.9,1.5c1,3.7,1.8,7.8,0.4,11.7c-0.7,1.8-2.9,1.2-4.4,1.5c-9.5,1.6-19.1,2.8-28.6,4.6
+		c-39.6,7.4-78.6,17-117,29.2c-59.9,19-116.5,45.2-170.8,76.4c-41.6,24-80.2,52.3-117.2,83.1c-39.4,32.8-74.3,69.6-105.4,110.2
+		c-3,3.9-6.2,7.7-9.4,11.6c-0.1,0.2-0.6,0.2-2.1,0.5c0.2-7-1.1-13.6,1.5-20.3c7.6-19.2,12.9-39.2,16.7-59.5
+		c1.8-9.6,6.2-17.5,12-24.8c17.2-21.7,36.5-41.5,58.8-58.9c3.4,2.2,3.5,6.6,5.4,9.8c4,7,7.8,14.4,17.4,14.4
+		c9.6,0,13.8-7.2,17.3-14.4c6.5-13.3,9.4-27.7,12.2-42c0.8-3.9,2.2-6.5,5.7-8.6C808.9,1171.4,842.7,1153.5,878.7,1138.5z"/>
+	<path class="st1" d="M1032.8,891.9c-42-9-82.2-20.4-121.3-35.7c-4.8-1.9-6.9-4.4-7.7-9c-0.9-5.6-2.3-11.1-4.8-16.2
+		c-1.5-3.2-3.7-5.9-7.3-6.1c-4.1-0.2-6.8,2.5-8.3,6.1c-1.6,3.6-2.8,7.4-4.7,12.2c-11.4-5.2-22.6-10-33.5-15.2
+		c-23.1-11.1-45.4-23.7-67.3-37.1c-4.3-2.6-6.6-5.5-7.5-10.7c-2.1-11.4-4.6-22.8-8.9-33.7c-2.1-5.3-4.2-10.5-7.8-15
+		c-7.6-9.4-17.5-9.4-25.3,0.1c-4.2,5.2-6,11.7-9.8,18.2c-11.1-9.9-22.3-18.8-32.2-28.9c-10.2-10.4-19.5-21.8-28.7-33.3
+		c-5.6-7-8.9-15.3-10.6-24.4c-3.7-19.3-8.6-38.3-16-56.5c-2.9-7.1-1.4-14.1-0.5-21.8c3.9,4.8,7.9,9.4,11.6,14.3
+		c23.7,32,51,60.7,80.1,87.7c19,17.6,39.4,33.9,59.9,49.7c45,34.7,93.8,63.3,144.7,87.9c39.2,18.9,79.8,34.7,121.6,47.1
+		c41.2,12.2,82.8,22.3,125.4,28.2c1,0.1,2,0.2,3,0.4c7.3,1.2,10.5,7.7,7,14.2c-1.3,2.3-3.4,1.7-5.3,1.6c-8-0.7-15.9-1.5-23.8-2.4
+		c-32.8-3.7-65.1-10.2-97.5-15.7c-7.1-1.2-11.5-3.9-11.7-11.6c0-1.3-0.4-2.6-0.8-3.9c-0.8-2.6-1.9-5.3-5.3-4.9
+		c-2.7,0.3-3.7,2.6-4.4,4.9C1034.4,885.3,1033.7,888.2,1032.8,891.9z"/>
+	<path class="st1" d="M1953.8,1233.7c3.8,1,5.8,3.4,8,5.3c21,19.1,40.7,39.4,57.6,62.2c3,4.1,4.9,8.4,6,13.5
+		c4.5,20.5,9.3,40.9,17.1,60.4c1.3,3.1,2.4,6.3,1.8,9.7c-0.6,3.6,2.4,8.9-2.1,10.4c-2.5,0.8-5.4-3.9-7.3-6.7
+		c-35.7-51.5-81-93.6-129.4-132.6c-40.8-32.9-84.7-61.2-131-85.6c-39.5-20.8-80.6-37.9-123-52c-45.9-15.2-92.6-26.8-140.3-34.3
+		c-6.2-1-12.4-2.7-18.7-3.1c-6.5-0.4-5.5-4.5-5.2-8.4c0.4-5.4,2.1-7.1,7.5-6.6c8.3,0.7,16.5,1.9,24.8,2.7
+		c33.2,3.4,65.8,10.1,98.6,15.7c6.3,1.1,9.2,3.4,9.6,10c0.2,3.6,0.3,9.3,5.3,9.6c6,0.4,5.5-5.6,6.3-9.5c0.7-3.9,2.4-5,6.2-4
+		c39.4,9.7,78.9,19.2,116.7,34.3c4.5,1.8,6.8,4.2,7.5,9.1c0.9,5.9,2.2,11.8,5.1,17.2c1.7,3.1,3.8,5.6,7.6,5.6c3.8,0,6-2.5,7.6-5.6
+		c0.9-1.8,1.7-3.6,2.3-5.5c2.8-7.7,2.9-7.9,9.9-4.7c32.6,15.3,64.6,31.4,95,50.8c3.4,2.2,5.1,4.7,5.8,8.6
+		c2.1,12.1,4.9,24.1,9.4,35.7c1.9,5,4.1,9.8,7.5,14c7.5,9.4,17.7,9.4,25.3,0C1948.9,1245.3,1950.9,1239.5,1953.8,1233.7z"/>
+	<path class="st1" d="M2043.6,585.1c0.9,7.5,1.7,14.1-0.8,20.4c-8,20.2-13.1,41.2-17.6,62.4c-0.9,4.4-2.6,8.3-5.2,11.7
+		c-17.8,23.8-38.4,45.2-60.6,64.9c-1.5,1.3-3.2,2.3-5.1,3.8c-2.9-5.3-5.1-10.4-8.2-14.9c-8-11.8-19.3-11.8-27.5-0.1
+		c-7.4,10.6-11.4,23-12.8,35.4c-1.7,14.6-9.4,22.2-21.3,29.3c-25.5,15.2-52.1,28.1-78.7,41.2c-2.4,1.2-5,2-7.3,3.1
+		c-2.7,1.3-4.3,0.7-5.2-2.2c-1-3.2-1.9-6.4-3.4-9.3c-4.2-7.7-10.8-7.7-15.1-0.1c-2.5,4.4-3.9,9.3-4.5,14.2c-0.8,7-4.2,10.7-11,13.3
+		c-27.5,10.2-55.4,18.9-83.9,25.7c-10,2.4-20.1,4.8-30,7.5c-3.8,1-5.4,0-6.1-3.9c-0.7-4-0.2-9.9-6.2-9.6c-5.1,0.2-5.3,6-5.4,9.5
+		c-0.1,7.5-4.3,9-10.5,10.2c-39.6,7.4-79.4,13.9-119.5,18.1c-2.8,0.3-6.7,2.3-8.1-1.3c-1.4-3.6-1.7-7.9-0.3-11.7
+		c0.9-2.4,3.9-2,6.2-2.4c13.8-2.4,27.6-4.4,41.3-7c42.1-8.2,83.5-19.3,124.2-33.1c57.6-19.6,112.2-45.7,163.9-77.3
+		c38.1-23.2,73.8-50.1,107.6-79.4c37.9-32.8,72.6-68.6,102.5-109C2037.5,591.3,2039.4,587.8,2043.6,585.1z"/>
+	<path class="st1" d="M777.2,1163.8c-0.9-7.9,1.2-15.4,2-23c4.4-45.1,6.3-90.3,6.6-135.6c0.1-8.6,0.2-8.7,8.8-8.7
+		c22-0.1,44-0.1,65.9,0c8.3,0,8.4,0.1,8.5,7.9c0.2,37.7,2,75.2,6.5,112.6c0.5,3.8,0.3,6-3.9,7.5c-31.7,11.3-62.2,25.3-92.6,39.6
+		C778.8,1164.3,778.4,1164.1,777.2,1163.8z"/>
+	<path class="st1" d="M776.8,817.8c3.1-0.6,4.7,0.6,6.5,1.4c28.2,13.5,56.6,26.5,86.2,36.8c5.4,1.9,6.7,4.3,6,10.1
+		c-4.5,36.7-6.3,73.6-6.4,110.6c0,8.1,0.7,8.3-8.1,8.3c-22.6-0.1-45.3,0-67.9-0.1c-7,0-7.1-0.2-7.2-7.3c-0.4-28.6-0.9-57.3-2.7-85.9
+		c-1.3-21.3-2.9-42.5-5.5-63.7C777.2,824.9,777.1,821.6,776.8,817.8z"/>
+	<path class="st1" d="M1896.4,1163.9c-3.3,0.5-5.7-1.5-8.4-2.8c-27.2-13.3-54.8-25.7-83.3-36.1c-7.4-2.7-7.2-2.9-6.3-10.6
+		c4.4-35.8,5.3-71.8,6.4-107.7c0.1-1.7,0.1-3.3,0-5c-0.3-3.8,1.3-5.4,5.2-5.3c6.3,0.2,12.7,0.1,19,0.1c16.7,0,33.3,0,50,0.1
+		c8.4,0,8.4,0.1,8.6,8.8c0.8,30.3,1.2,60.6,3.3,90.9c1.4,19.9,2.9,39.9,5.3,59.7C1896.5,1158.6,1897.4,1161.2,1896.4,1163.9z"/>
+	<path class="st1" d="M1896.8,817.7c-1.3,13.9-2.7,27.7-3.9,41.6c-3.5,38.5-4.5,77-5.2,115.6c0,1.7-0.2,3.3-0.1,5
+		c0.4,4-1.5,5.5-5.2,5.1c-1-0.1-2,0-3,0c-22.6,0-45.3-0.1-67.9,0.2c-5,0-6.8-1.2-6.8-6.6c-0.4-28.3-1.2-56.5-3.6-84.7
+		c-0.8-8.9-1.6-17.9-2.7-26.8c-0.9-7.6-1.1-7.8,6.5-10.6c23-8.7,45.8-17.8,67.9-28.7c6-2.9,12-5.7,18-8.6
+		C1892.5,818.3,1894.3,817.4,1896.8,817.7z"/>
+	<path class="st1" d="M908.3,1109.6c-1-4.4,0.4-8.6,0.8-12.8c2.5-30.9,4-61.8,4-92.9c0-7.4,0.2-7.5,7.9-7.5
+		c33.3-0.1,66.7-0.2,100-0.2c7.8,0,8.1,0.1,8,7.4c-0.3,22,1,44,2.3,65.9c0.3,4.5-1,6.5-5.5,7.4c-38.7,8.5-76.4,20.9-114.2,32.5
+		C910.7,1109.8,909.7,1109.6,908.3,1109.6z"/>
+	<path class="st1" d="M1765.3,1110.4c-9.6-3-18.1-5.6-26.6-8.4c-29.1-9.6-58.7-17.4-88.5-24.5c-8.9-2.1-8.1-1.4-7.6-10.4
+		c1.2-21,1.6-42,2.3-62.9c0.2-7.7,0.2-7.9,7.5-7.9c33.3,0,66.7,0.1,100,0.2c7.8,0,8.2,0.3,8.2,7.7c0.2,34,1.7,68,4.8,101.8
+		C1765.4,1106.9,1765.3,1107.9,1765.3,1110.4z"/>
+	<path class="st1" d="M908.8,872.2c2.8-1.1,5,0.8,7.5,1.5c36.1,10.3,71.6,22.9,108.5,30.5c5.5,1.1,6.7,3.6,6.4,8.8
+		c-1.3,21.9-2.6,43.9-2.1,65.9c0.1,4.7-1.2,6.5-6.1,6.4c-34.7-0.2-69.3-0.2-104-0.1c-4.1,0-6.1-1-6-5.6c0.4-35.6-2-71.2-4.8-106.7
+		C908.2,872.8,908.6,872.5,908.8,872.2z"/>
+	<path class="st1" d="M1765.6,872.4c-0.9,10.7-1.8,20.9-2.5,31.2c-1.7,24.6-2.4,49.2-2.6,73.8c-0.1,7.7-0.2,7.8-7.7,7.8
+		c-33.6,0.1-67.2,0.1-100.8,0.1c-6.9,0-6.9-0.2-7.1-7.1c-0.8-21.9-1.3-43.9-2.6-65.8c-0.3-5.4,1.8-7,6.2-8
+		c14.5-3.5,29-7.1,43.5-10.8c22.5-5.7,44.5-13.5,66.7-20.3C1760.5,872.7,1762.3,871.8,1765.6,872.4z"/>
+	<path class="st1" d="M725.8,1192.5c-5.9-34.3-8.8-67.4-11-100.6c-1.8-27.6-2.2-55.2-3-82.8c-0.1-2.3,0.1-4.7-0.1-7
+		c-0.4-4.4,1.6-5.8,5.9-5.7c9,0.2,18,0,27,0c6.7,0,13.3-0.1,20,0c7.2,0.1,7.4,0.2,7.3,7.1c-0.5,23.6-1,47.2-2,70.8
+		c-1.2,27.2-3.3,54.4-6.7,81.5c-0.2,1.3-0.3,2.6-0.4,4c-0.4,9.2-3.4,16-13,19.7C741.7,1182.7,734.5,1187.7,725.8,1192.5z"/>
+	<path class="st1" d="M1946.2,1191.7c-10.1-5.6-20.4-11.5-30.8-17.2c-3.3-1.8-3.1-5-3.5-7.8c-1.4-10.2-2.4-20.5-3.5-30.7
+		c-4.7-43.8-6-87.7-6.7-131.6c-0.1-7.7,0.1-7.8,7.7-7.8c15.3-0.1,30.6,0.1,46-0.1c4.6-0.1,6.5,1.1,6.4,6.1
+		c-0.5,34-1.2,67.9-3.7,101.8c-2,26.9-4.5,53.7-8.9,80.4C1948.7,1187,1949.1,1189.5,1946.2,1191.7z"/>
+	<path class="st1" d="M1947.7,789.1c5.8,32.7,8.6,63.8,10.8,95c2.1,30.6,2.8,61.2,3.1,91.9c0.1,9.6,0.3,8.9-8.3,8.9
+		c-15,0-30-0.1-45,0.2c-5.3,0.1-6.9-1.8-6.7-7c0.9-25.3,1.3-50.6,2.5-75.9c1.3-27.3,3.9-54.4,6.9-81.6c0.9-8.3,3.3-14.2,11.5-17.8
+		C1930.8,799.2,1938.6,794.1,1947.7,789.1z"/>
+	<path class="st1" d="M726,789.2c11.3,6.2,21.7,11.9,32.2,17.5c2.9,1.6,2.8,4.2,3.2,6.8c2.7,15.8,4.1,31.7,5.5,47.6
+		c3.3,37.2,4.5,74.5,5,111.8c0,2.3,0,4.7,0.1,7c0.1,3.1-0.8,5-4.4,5c-17-0.1-34-0.1-51-0.1c-3.3,0-4.8-1.5-4.7-4.8
+		c0.2-5.7,0-11.3,0.2-17c1-42.6,2.7-85.2,7.3-127.7C720.9,820.5,722.6,805.7,726,789.2z"/>
+	<path class="st1" d="M1625.1,910.5c-0.6,9.4-1.4,18-1.7,26.5c-0.4,13-0.4,26-0.6,38.9c-0.1,9.3-0.2,9.4-9.2,9.4
+		c-30.6,0.1-61.3,0.1-91.9,0.1c-8.3,0-16.7-0.1-25,0.1c-4.2,0.1-5.9-1.3-5.9-5.7c0-15-0.1-30-0.7-44.9c-0.2-4.8,2.5-5.5,6-6
+		c10.9-1.3,21.8-3.6,32.7-3.7c23.9-0.2,46.7-6.5,70-10C1607.1,913.9,1615.2,912.2,1625.1,910.5z"/>
+	<path class="st1" d="M1625.2,1071.1c-23.5-4.2-45.7-8.1-67.9-12.1c-7.9-1.4-15.8-2.4-23.8-2.5c-12.7-0.1-25.1-2.6-37.7-4
+		c-4-0.4-5.8-1.6-5.6-6.1c0.5-14.6,0.6-29.3,0.6-43.9c0-4.5,1-6.5,6.1-6.5c39.9,0.2,79.9,0.2,119.8,0.1c5,0,6.1,2.1,6.1,6.6
+		C1622.9,1025,1623,1047.3,1625.2,1071.1z"/>
+	<path class="st1" d="M1049.3,1070.4c-1-5.9-0.1-11.8,0.3-17.7c0.9-16.3,1.4-32.6,1.4-48.9c0-7.3,0.2-7.5,6.8-7.5
+		c39.3-0.1,78.5-0.1,117.8-0.1c7,0,7.1,0.2,7.2,7.2c0.2,14,0,27.9,0.5,41.9c0.2,5.2-1.5,6.6-6.6,7c-16.9,1.3-33.8,2.7-50.6,5.2
+		c-23.3,3.4-46.7,6.8-69.7,12.3C1054.2,1070.3,1051.9,1071.4,1049.3,1070.4z"/>
+	<path class="st1" d="M1049.8,910.2c22.1,5.7,44.8,8.7,67.4,12.5c16.4,2.8,33.1,3.3,49.6,5.2c16.4,1.9,16.4,1.5,16.3,17.4
+		c-0.1,11-0.3,22-0.2,32.9c0.1,4.9-1,7.2-6.6,7.2c-39.9-0.2-79.9-0.2-119.8-0.1c-3.4,0-5.7-0.6-5.6-4.8c0.6-22.6-1.3-45.2-1.9-67.8
+		C1049,912,1049.4,911.4,1049.8,910.2z"/>
+	<path class="st1" d="M1260.5,985.4c-21.6,0-43.2,0-64.9,0c-8,0-8.2-0.1-8.1-8.4c0.2-13.6,0.6-27.3,0.8-40.9c0.1-4.2,1.4-5.6,6-5.1
+		c41.7,4.1,83.5,6.2,125.5,6.2c2.3,0,4.7,0,7,0c7.5,0.2,7.5,0.2,7.6,7.9c0.1,10.3,0.1,20.6,0.1,30.9c0,9.3,0,9.4-9.1,9.4
+		C1303.8,985.4,1282.2,985.4,1260.5,985.4z"/>
+	<path class="st1" d="M1485,931.5c0.3,16.2,0.5,32.7,0.8,49.3c0.1,3.4-1.7,4.8-4.9,4.6c-2-0.1-4,0-6,0c-41.6,0-83.2,0-124.9,0
+		c-2,0-4-0.1-6,0c-4,0.3-5.1-1.8-5-5.5c0.1-11.7,0-23.3,0.1-35c0.1-7.6,0.1-7.8,7.6-7.8c17.3,0.2,34.6-0.6,51.9-1.1
+		c26.3-0.7,52.5-3.1,78.7-5.1C1479.6,930.9,1481.8,930,1485,931.5z"/>
+	<path class="st1" d="M1485,1051.1c-35.4-3-69.9-5.3-104.5-6.4c-11.6-0.4-23.3-0.5-34.9-0.4c-4.4,0-6.7-0.8-6.5-6
+		c0.4-12,0.3-24,0-36c-0.1-4.8,1.6-6.3,6.3-6.2c45,0.1,89.9,0.1,134.9,0c3.5,0,5.8,0.7,5.7,4.8
+		C1485.5,1017.5,1485.3,1034.1,1485,1051.1z"/>
+	<path class="st1" d="M1188.4,1050.6c-0.3-17.2-0.5-33.7-0.8-50.3c0-2.9,1.6-4.1,4.4-4.1c1.7,0,3.3,0,5,0c42.6,0,85.1,0,127.7,0
+		c1.7,0,3.3,0.1,5,0c3.3-0.2,4.9,1.2,4.9,4.6c-0.1,13-0.1,25.9,0,38.9c0,3.6-1.7,4.7-4.9,4.5c-0.7,0-1.3,0-2,0
+		C1281.6,1043.7,1235.9,1047.2,1188.4,1050.6z"/>
+	<path class="st1" d="M2010.7,1230.1c-5.1-1.9-9-5.1-13.1-7.7c-9.9-6.1-19.6-12.6-29.8-18.3c-4.8-2.6-5.5-5.6-4.5-10.4
+		c3.9-20,6.2-40.1,8.2-60.4c4-41.2,5.8-82.4,6.1-123.8c0-3,0.1-6,0-9c-0.1-3,1.1-3.8,4.1-4.1c16.5-1.5,16.7-1.4,16.8,14.7
+		c0.4,66.4,3.9,132.5,10.7,198.6C2009.9,1216.3,2011.6,1222.7,2010.7,1230.1z"/>
+	<path class="st1" d="M2011.2,752.5c-1.6,16.9-3.2,33.8-4.8,50.6c-3,30.8-4.6,61.7-6.1,92.6c-1.3,27.3-1.5,54.5-1.8,81.8
+		c-0.1,7.1-0.2,7.3-7.1,7.3c-16.3,0-13.6,1.3-13.7-12.8c-0.5-54.3-3.2-108.4-10.6-162.2c-1.1-7.9-2.5-15.8-3.9-23.6
+		c-0.7-3.6-0.1-6,3.5-8.2c13.4-8,26.6-16.4,39.8-24.7C2007.6,752.8,2008.5,751.7,2011.2,752.5z"/>
+	<path class="st1" d="M662.1,1231.5c1.9-20.4,3.7-38.6,5.4-56.8c3-31.9,4.7-63.8,6-95.8c1-24.6,1.6-49.3,1.6-74
+		c0-8.3,0.1-8.3,7.9-8.4c1.3,0,2.7,0,4,0c8.6,0.1,8.7,0.1,8.8,8.7c0.4,40,1.8,80,5.4,119.8c2,22.9,4.4,45.8,9,68.3
+		c1.1,5.5,0.2,8.5-5.1,11c-12.7,6-23.9,14.5-35.5,22.2C667.7,1227.9,665.8,1229.1,662.1,1231.5z"/>
+	<path class="st1" d="M662.9,752.1c2.6-0.9,3.9,1,5.4,2.1c12.4,8.4,24.6,17.1,38,23.9c3.3,1.7,5,3.6,4.2,7.7
+		c-11.3,61.8-13.7,124.4-14.8,187c-0.2,13.5,2.2,12.1-12.3,12.1c-8.4,0-8.5-0.1-8.5-8.9c0.1-52.7-2.6-105.3-6.4-157.8
+		c-1.5-20.6-4-41.1-6-61.7C662.5,755.1,661.9,753.4,662.9,752.1z"/>
+	<path class="st1" d="M2044.3,728.6c0,3.4,0,6.3,0,9.2c0,78.9,0,157.9,0,236.8c0,1.7-0.1,3.3,0,5c0.4,3.9-1.3,5.4-5.2,5.3
+		c-5.9-0.2-11.9,0-18.3,0c0-26.3,0.3-51.6,1.3-76.8c1.7-42.3,4.4-84.5,8.9-126.5c1.6-14.9,3.9-29.7,5.6-44.6
+		C2037.2,732.4,2038.9,729.7,2044.3,728.6z"/>
+	<path class="st1" d="M2044.3,1253c-5.6-1.2-7-4.1-7.7-8.6c-3.1-19.4-5.2-38.9-7-58.5c-5.6-59-8.7-118.2-8.7-177.6
+		c0-13.6-1.4-11.7,11.5-11.8c13.3,0,11.9-1.5,11.9,11.5c0,78.6,0,157.2,0,235.8C2044.3,1246.6,2044.3,1249.3,2044.3,1253z"/>
+	<path class="st1" d="M629.2,728.7c5.8,1.6,7.4,4.6,7.9,9c2.3,21.2,5.3,42.2,7.3,63.4c5.3,55.3,7.7,110.8,8.5,166.4
+		c0,3.3,0.1,6.7,0,10c-0.1,7.5-0.1,7.5-7.7,7.7c-16,0.5-16,0.5-16-15.3c0-76.5,0-153.1,0-229.6C629.2,736.7,629.2,733,629.2,728.7z"
+		/>
+	<path class="st1" d="M629.2,1253.2c0-6,0-10.6,0-15.3c0-75.7,0-151.3,0-227c0-2,0-4,0-6c-0.1-9.2-0.3-8.7,8.7-8.6
+		c15.1,0,15.2,0,15,15.6c-0.7,62.7-3.8,125.2-10.3,187.6c-1.5,14.9-3.9,29.7-5.5,44.6C636.6,1248.7,634.5,1251.1,629.2,1253.2z"/>
+	<path class="st1" d="M2060,697.5c0-15.9,0-29.5,0-43c0-3.7,0.3-7.3-0.1-11c-2-19,6.4-34.8,15.3-50.5c1-1.7,2.3-3.2,3.6-4.7
+		c5.4-6.2,8.1-6.2,13.4,0.4c6.3,7.8,10.3,17.1,13.7,26.4c3.2,8.7,5.9,17.6,8.7,26.5c1.3,4,1,7.1-2.4,10.7
+		C2096.7,668.2,2079,681.6,2060,697.5z"/>
+	<path class="st1" d="M613.2,1283.1c0,24.5,1.5,47.6-0.5,70.3c-1.4,15.4-9,29.8-19.7,41.7c-3.8,4.2-5.7,3.9-10-0.4
+		c-4.3-4.3-7.2-9.6-9.8-15c-6.7-13.8-11.2-28.4-15.3-43.2c-0.8-3-1.3-5.6,1.5-8.1C576.3,1313,592.4,1296.7,613.2,1283.1z"/>
+	<path class="st1" d="M2060,1284.4c19.3,15.5,36.8,29.3,52.5,45.2c2.6,2.6,3.7,5.1,2.6,8.8c-5.1,17.2-10,34.5-19.7,50
+		c-7.7,12.2-12.4,12.7-19.8,0.6c-9.5-15.4-16.9-31.4-15.8-50.5C2060.7,1321.2,2060,1303.9,2060,1284.4z"/>
+	<path class="st1" d="M611.9,698.2c-8.5-6.7-17.1-12.8-25-19.7c-9.1-7.8-17.5-16.4-26.3-24.5c-2.3-2.2-4-4.1-3-7.7
+		c5.3-18.2,10.3-36.5,20.4-52.8c7.8-12.7,12.8-13,20.4-0.3c8.9,14.9,16.3,30.2,15.1,48.6c-1,15.9-0.2,31.9-0.3,47.9
+		C613.2,692.2,614,694.9,611.9,698.2z"/>
+	<path class="st1" d="M1788.2,864c4.1,27,4.9,53.5,6.1,80.1c0.5,11.3,0.2,22.6,0.7,33.9c0.2,5.2-1.6,7.4-6.7,7.3
+		c-4.7-0.1-9.3-0.3-14,0c-4.6,0.3-5.5-2-5.4-6c0.2-26.3,1.3-52.5,3.2-78.8c0.5-7.6,1.2-15.2,2.1-22.8
+		C1775.6,867.2,1775.7,867.2,1788.2,864z"/>
+	<path class="st1" d="M885.3,1118.4c-5.1-39.1-6.6-77.6-6.6-116.3c0-4.2,1.3-5.9,5.7-5.8c25,0.7,20.1-4.1,19.8,19.4
+		c-0.4,29.6-1.5,59.3-5,88.8C897.9,1115.4,898.1,1115.4,885.3,1118.4z"/>
+	<path class="st1" d="M885.7,863.5c12.4,2.1,12.2,2.1,13.5,13.8c3.8,33,4.6,66.2,5.3,99.4c0.2,8.3,0,8.5-7.9,8.4
+		c-5.6-0.1-12.6,2.4-16.3-1.2c-3.8-3.6-1.3-10.7-1.3-16.2c0.1-33.9,1.8-67.7,6.1-101.4C885.1,865.4,885.4,864.5,885.7,863.5z"/>
+	<path class="st1" d="M1788.4,1117.5c-4,0.3-6.2-1.5-8.7-2.2c-3.2-0.9-4.6-2.9-4.9-6.5c-0.7-10.3-2.2-20.5-2.9-30.8
+		c-1.5-24.6-2.8-49.2-2.8-73.9c0-7.5,0.1-7.8,7.7-7.6c5.9,0.2,13.3-2.7,17.2,1.6c3.4,3.7,1,10.9,0.9,16.5
+		C1794.3,1048.8,1792.8,1083.1,1788.4,1117.5z"/>
+	<path class="st1" d="M1481.1,1078.1c-10.7,0.3-20.5-1.5-30.3-2.6c-34.1-3.7-68.2-5.9-102.5-5.6c-1.3,0-2.7-0.1-4,0
+		c-4.9,0.5-5.1-2.5-5.2-6.2c-0.1-4,0.7-6,5.4-6c20,0.1,39.9-0.2,59.9,1c22.9,1.4,45.8,3,68.7,4.7c7.9,0.6,7.8,0.9,8.2,8.7
+		C1481.2,1073.7,1481.1,1075.4,1481.1,1078.1z"/>
+	<path class="st1" d="M1480,903c2,3.3,0.7,6.3,1,9.2c0.4,4.3-1.6,5.6-5.8,5.9c-42.2,3.3-84.3,6.2-126.7,5.9c-1.3,0-2.7-0.1-4,0
+		c-4.5,0.5-5.5-1.7-5.6-5.8c-0.1-4.5,0.9-6.6,6-6.5c29.7,0.7,59.2-1.5,88.8-3.9C1449.3,906.5,1464.7,904.6,1480,903z"/>
+	<path class="st1" d="M1192.2,1078.2c1-14.7,0.9-15,13.5-15.8c40.5-2.9,80.9-5.4,121.6-4.6c7.3,0.1,7.4,0.5,7.3,7
+		c-0.1,4-1.7,5.2-5.4,5.1c-6-0.2-12-0.1-18,0c-37.3,0.2-74.3,3.2-111.3,7.8C1197.6,1078,1195.3,1078,1192.2,1078.2z"/>
+	<path class="st1" d="M1192.6,903.2c17.2,2.2,33.7,3.8,50.2,5c28.2,2.1,56.4,4.4,84.7,3.6c3.8-0.1,7.3-0.4,7.1,5.4
+		c-0.3,6.3-0.2,6.8-6.6,6.8c-18.6,0-37.2,0.4-55.9-0.8c-19.2-1.2-38.5-2.1-57.8-3.2c-3-0.2-6-0.4-8.9-0.8
+		C1192.8,917.6,1192.8,917.6,1192.6,903.2z"/>
+	<path class="st1" d="M653.6,694.6c2.5,2.7,3.4,3.5,4.2,4.6c15.1,20.9,32.8,39.4,51.8,56.7c2.5,2.3,7.7,4.8,5,8.5
+		c-2.7,3.9-6.2-1-8.9-2.4c-14.7-7.8-28.1-17.9-42.2-26.6c-3.1-1.9-4.3-4.4-4.8-8C657.4,717,655.5,706.9,653.6,694.6z"/>
+	<path class="st1" d="M654,1284.6c0.9-5.5,2.7-11,2.6-16.4c-0.1-14.4,6.3-23.8,19.2-30.2c10.6-5.3,20.3-12.5,30.5-18.8
+		c2.5-1.5,4.9-3.3,7.8-3.6c1.6,2.1,1.5,4,0.2,5.7c-1,1.3-2.4,2.3-3.6,3.4c-18.4,17.3-36.5,34.8-51.2,55.5c-1.1,1.6-2.6,2.9-4,4.3
+		C655.3,1284.8,654.8,1284.6,654,1284.6z"/>
+	<path class="st1" d="M2019.1,698.8c-1.4,9.8-3,19.6-4.2,29.5c-0.4,3-2.2,4.7-4.4,6.2c-15.3,9.9-30.7,19.7-46.1,29.5
+		c-1.5,1-3.7,4-5.7,0.4c-1.5-2.6,0.2-4.4,2.1-5.9c11.9-9.2,21.5-20.7,32.4-30.8c8.4-7.7,14.5-17.2,21.4-26.1c0.9-1.2,2-2.4,3-3.6
+		C2018.1,698.2,2018.6,698.5,2019.1,698.8z"/>
+	<path class="st1" d="M2017.1,1283.9c-11.8-19.6-28.7-34.6-44.6-50.5c-3.7-3.7-7.8-7.2-11.8-10.6c-1.9-1.7-3.4-3.4-1.7-5.9
+		c1.7-2.4,3.5-0.5,5,0.5c15.7,10,31.3,20,46.9,30c2,1.3,3.5,2.9,3.9,5.4c1.4,10.1,2.9,20.2,4.4,30.4
+		C2018.5,1283.4,2017.8,1283.7,2017.1,1283.9z"/>
+	<path class="st1" d="M1044.6,1034c-0.6,11-1.1,21.9-1.7,32.9c-0.1,1.6-0.3,3.3-0.8,4.9c-0.3,0.8-1.4,1.6-2.2,1.7
+		c-0.9,0.1-1.9-0.5-2.1-1.7c-0.1-1-0.3-2-0.4-3c-1.2-22.2-2.3-44.5-2.4-66.8c0-3.2,0-6,4.6-5.9c3.5,0.1,5.6,0.7,5.5,4.9
+		c-0.2,11-0.1,21.9-0.1,32.9C1044.9,1034,1044.8,1034,1044.6,1034z"/>
+	<path class="st1" d="M1636.4,1033.8c0,10.6,0,21.2,0,31.8c0,2-0.3,4-0.7,5.9c-0.2,0.8-1.2,1.8-1.9,1.8c-0.8,0-1.9-0.8-2.2-1.5
+		c-0.5-1.2-0.5-2.6-0.6-3.9c-1.9-21.8-2.2-43.7-2.1-65.6c0-5.7,1.3-6.7,6-6.1c3.9,0.5,3.6,3.1,3.6,5.8c0,10.6,0,21.2,0,31.8
+		C1637.8,1033.8,1637.1,1033.8,1636.4,1033.8z"/>
+	<path class="st1" d="M1638.5,948.1c0,10.3,0,20.6,0,31c0,2.6,0.5,5.4-3.3,6.2c-4.4,0.9-6.4-0.5-6.4-5.8c0-19,0-38,1.4-56.9
+		c0.2-3,0.4-6,0.7-9c0.2-2.2-0.3-5.4,3-5.2c2.5,0.1,2.2,3,2.3,4.9c0.6,11.6,1.1,23.3,1.6,34.9C1638,948.1,1638.2,948.1,1638.5,948.1
+		z"/>
+	<path class="st1" d="M1045.1,948c0,10.6-0.1,21.2,0,31.9c0,3.6-0.9,5.5-5,5.5c-3.9-0.1-5.1-1.7-5.1-5.4c0.1-22.6,1.2-45.1,2.5-67.7
+		c0.1-1.6-0.1-3.7,2-4c2.8-0.4,3.1,1.9,3.2,3.9c0.7,11.9,1.3,23.9,1.9,35.8C1044.8,948,1044.9,948,1045.1,948z"/>
+	<path class="st1" d="M741.9,740.1c7,10.8,9.7,22,12.6,34.5c-8.1-3.6-13.5-8.9-19.7-13c-2-1.3-2-3.3-1.2-5.3
+		C735.6,751.1,737,745.6,741.9,740.1z"/>
+	<path class="st1" d="M1931.7,1241.3c-6.9-10.6-9.7-21.7-12.1-33.3c4.2,0.4,6.4,3.1,9.1,4.9
+		C1943.2,1223.1,1943.4,1224.7,1931.7,1241.3z"/>
+	<path class="st1" d="M1931.6,740c12,17.2,11.9,18.3-3.6,29.1c-2.4,1.7-4.5,3.9-8.5,4.8C1921.8,761.9,1925,750.9,1931.6,740z"/>
+	<path class="st1" d="M742.1,1241.3c-5.3-5.2-6.5-11.1-8.6-16.5c-0.8-2-0.5-3.8,1.6-5.1c6-3.9,11.2-9.1,19.2-12.6
+		C751.8,1219.5,748.7,1230.3,742.1,1241.3z"/>
+	<path class="st1" d="M599.6,517.5c0.6,0.1,1.4,0.1,1.9,0.4c12.6,7.1,13,7.9,10.7,24.4c-5.9-7.9-11-15.2-13.4-24.1
+		C599,518,599.3,517.7,599.6,517.5z"/>
+	<path class="st1" d="M597.6,1464.4c4-9.4,8.1-17.2,14-24.4C614.9,1455.5,614.5,1457.9,597.6,1464.4z"/>
+	<path class="st1" d="M2072.4,516.4c2.2,0.6,2.3,2,1.3,3.7c-3.8,6.1-7.7,12.1-11.9,18.6c-2.8-10.6-2.1-12.7,5.3-17.8
+		c1.9-1.3,4.2-2,5.3-4.3L2072.4,516.4z"/>
+	<path class="st1" d="M2061.5,1442.5c4.7,8.5,10.5,14.5,12.5,22.8C2067.2,1459.8,2056.4,1456.8,2061.5,1442.5z"/>
+	<path class="st1" d="M1781.6,836.9c4.2,9.3,4.2,9.3-1.8,12.6C1777.9,845.4,1780.6,842.1,1781.6,836.9z"/>
+	<path class="st1" d="M895.4,849.3c-7.5-2.9-7.5-2.9-3.8-11.1C893.8,841.3,893.9,844.7,895.4,849.3z"/>
+	<path class="st1" d="M630.1,1284.6c-0.2-5.4-2.7-11,1.8-17C634.2,1274.4,629.7,1279.3,630.1,1284.6z"/>
+	<path class="st1" d="M629.9,697.1c0.5,5.4,3.9,10.3,2.4,16.6C626.9,708.5,630.1,702.5,629.9,697.1z"/>
+	<path class="st1" d="M2044.5,1284.5c-2.2-5-4.3-9.2-2.8-15C2046.1,1274.3,2043.5,1279.4,2044.5,1284.5z"/>
+	<path class="st1" d="M2041.9,712.1c-2.2-6,1.1-10.1,2.2-14.6C2043.5,702.2,2046,707.4,2041.9,712.1z"/>
+	<path class="st1" d="M892.2,1143.9c-4.6-7.9-4.6-7.9,1.6-11.5C895.7,1136.5,892.6,1139.7,892.2,1143.9z"/>
+	<path class="st1" d="M1779.6,1132.2c6.1,3.1,6.1,3.1,2.7,11.1c-1.9-1-1.7-3.1-2.3-4.6C1779.2,1137,1778.6,1135.1,1779.6,1132.2z"/>
+	<path class="st1" d="M1934.8,1202.5c4.1-0.6,6.5,2.5,11.4,4.9c-6.3,0.5-8.2-3.5-11.3-5.1L1934.8,1202.5z"/>
+	<path class="st1" d="M1935.8,777c3.1,0.9,4.5-3.5,7.8-2.9c-1.8,4-4.7,3.9-7.9,2.8L1935.8,777z"/>
+	<path class="st1" d="M729.5,774c2.7-0.5,4.4,0.6,5.8,3.2C732.1,778,731,775.7,729.5,774z"/>
+	<path class="st1" d="M734,1202.5c2.3,4.6-1.2,4.8-4.2,5.9c-0.6-3.7,3.7-3.3,4.2-5.7C734,1202.7,734,1202.5,734,1202.5z"/>
+	<path class="st1" d="M1935.2,780.3c-0.4,0.2-0.8,0.5-1.2,0.7c0.3,0,0.6,0.1,0.8,0c0.2-0.1,0.4-0.3,0.6-0.5
+		C1935.5,780.5,1935.2,780.3,1935.2,780.3z"/>
+	<path class="st1" d="M740,1203.1c-1.9-0.8-4.2,2.9-6-0.5c0,0,0,0.2,0,0.1C736,1202.8,738,1202.9,740,1203.1L740,1203.1z"/>
+	<path class="st1" d="M1935.7,777c1.4,1.3,0.9,2.4-0.5,3.3c0,0,0.3,0.3,0.3,0.3c0.1-1.2,0.3-2.3,0.4-3.5
+		C1935.8,777,1935.7,777,1935.7,777z"/>
+	<path class="st1" d="M737.9,778.4c0.2,0.2,0.4,0.5,0.6,0.7c-0.2,0.2-0.5,0.5-0.7,0.5c-0.2,0-0.4-0.4-0.6-0.6
+		C737.4,778.8,737.7,778.6,737.9,778.4z"/>
+	<path class="st1" d="M740,1203.1c0-0.3,0-0.8-0.2-1c-0.8-0.8-0.7-1.1,0.4-0.8C739.5,1201.9,739.4,1202.4,740,1203.1
+		C740,1203.1,740,1203.1,740,1203.1z"/>
+	<path class="st1" d="M1934.9,1202.3c0-0.2-0.1-0.3-0.1-0.5c0,0-0.1,0.1-0.1,0.1c0.1,0.2,0.1,0.4,0.2,0.6
+		C1934.8,1202.5,1934.9,1202.3,1934.9,1202.3z"/>
+	<path class="st1" d="M2072.4,516.6c0.7,0.4,1.4,0.8,2.1,1.2c-0.2,0.2-0.4,0.7-0.6,0.7c-1.1-0.2-1.5-1-1.4-2
+		C2072.4,516.4,2072.4,516.6,2072.4,516.6z"/>
+	<path class="st1" d="M598.7,518.3c-1-0.2-1.8-0.8-1-1.6c0.8-0.9,1.4,0,1.8,0.8C599.3,517.7,599,518,598.7,518.3z"/>
+</g>
+</svg>

docs/_static/tractor_logo_nav_light.svg

@@ -0,0 +1,458 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 24.2.1, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 2670 1980" style="enable-background:new 0 0 2670 1980;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:#0A0A0A;}
+	.st1{fill:none;}
+</style>
+<g>
+	<path class="st0" d="M2275.3,1000.1c-0.1,2.3,0,4.7,0,7c0,189.3,0,378.7,0,568c0,6,0.1,12.1-0.8,17.9c-2.4,15.2-12.9,17.4-23.6,10
+		c-45.4-31-91.2-61.4-136.9-91.9l-30.1-20.3c-9.8-6.3-19.2-13.2-29.2-19.3c-6.7-4.1-9.8-9.7-9.9-17.2c-0.1-9.3-0.6-18.7-0.3-28
+		c0.2-7.3-1.7-13-6.5-19c-18.6-23.3-36.2-47.3-56.9-69c-18-18.8-36.7-36.8-56.4-53.8c-31.8-27.5-65.4-52.7-101-74.9
+		c-32.7-20.4-66.8-38.4-102.2-54c-50.7-22.4-103.2-39.2-157.1-51.5c-36.7-8.4-73.8-14.4-111.2-18.5c-34.5-3.8-69-6.5-103.7-5.8
+		c-23.1,0.5-46.2-1.3-69.3,0.4c-22.9,1.8-45.9,3-68.7,5.6c-72.7,8.4-143.7,24.6-212.1,50.6c-65.5,24.8-127.4,57-184.9,97.4
+		c-46.8,32.8-90.1,69.8-129.5,111.1c-18.1,19-35.1,39.2-50.5,60.6c-3.9,5.5-5.5,11-5.3,17.6c0.4,9.3,0,18.7,0,28
+		c0,9.3-3.1,16.4-11.8,21.4c-10.4,5.9-19.9,13.4-30.1,19.8l-25.4,17.2c-11.6,7.8-23.3,15.5-34.9,23.3c-34.3,23-68.6,46-102.9,69
+		c-14.6,9.7-23.6,5.5-25.2-12.1c-0.5-5.3-0.5-10.7-0.5-16c0-189.7,0-379.3,0-569l-0.1-26.1c0.2-190.3,0.1-380.7,0.2-571
+		c0-5.7,0.4-11.3,0.5-17c0.1-3.7,1.2-7.3,3-10.5c3.4-5.9,9.3-7.7,15.4-4.8c2.7,1.3,5.1,3.1,7.6,4.8c44.3,29.6,88.5,59.3,132.8,88.9
+		l29.7,20.1c10.8,6.6,20.9,14.3,31.7,20.9c6.7,4.1,9.7,9.8,9.8,17.3c0.2,11,0.4,22,0.2,33c-0.1,5.2,1.2,9.6,4.2,13.9
+		c15.4,22.2,33,42.8,51.6,62.2c53.9,56.4,114.1,105.1,181.4,144.6c38.4,22.6,78.3,42.4,119.9,58.6c40,15.6,80.9,28.3,122.8,38
+		c52.7,12.1,106,19.3,160,22.6c18.3,1.1,36.6,2.1,54.9,1.5c17.7-0.6,35.5,1.1,53.2-0.1c17.6-1.1,35.2-2.3,52.8-3.6
+		c35.9-2.5,71.4-8.5,106.7-15.1c53.4-9.9,105.5-25,156-45.1c53.8-21.5,105.1-48.2,153.2-80.9c43.4-29.5,83.6-62.7,121.1-99.3
+		c27.3-26.6,50.3-56.8,73.9-86.6c2.9-3.6,3.6-7.6,3.6-12.1c-0.1-10.7,0.2-21.3,0.4-32c0.1-7.5,3.2-13.1,9.9-17.2
+		c10.2-6.2,19.9-13.4,30-19.8l23.2-16.3c4.2-1.3,7.4-4.3,11-6.7c42.9-28.7,85.8-57.4,128.7-86.1c1.1-0.7,2.3-1.4,3.3-2.3
+		c10.9-9.1,21.4-4.7,23.8,10.7c0.8,5.6,0.6,11.3,0.6,17c0,189.3,0,378.7,0,568L2275.3,1000.1z M740,1203.1c-2-0.2-4-0.3-6-0.5
+		c-0.5,2.5-4.8,2-4.2,5.8c2.9-1,6.4-1.2,4.2-5.8C735.8,1206,738.1,1202.3,740,1203.1c-0.6-0.7-0.5-1.3,0.2-1.7
+		c-1.1-0.3-1.1-0.1-0.4,0.8C740,1202.3,739.9,1202.8,740,1203.1z M1935.5,780.5c-0.2,0.2-0.4,0.4-0.6,0.4c-0.3,0.1-0.6,0-0.8,0
+		c0.4-0.2,0.8-0.5,1.1-0.8c1.4-0.9,2-1.9,0.5-3.3c3.2,1.1,6.1,1.2,7.9-2.8c-3.3-0.7-4.6,3.8-7.7,2.9
+		C1935.7,778.2,1935.6,779.4,1935.5,780.5z M1934.8,1202.5c-0.1-0.2-0.1-0.4-0.2-0.6c0,0,0.1-0.1,0.1-0.1c0,0.2,0.1,0.3,0.1,0.5
+		c3.1,1.6,5,5.7,11.3,5.1C1941.3,1205,1938.9,1202,1934.8,1202.5z M2072.4,516.6c-1,2.3-3.4,3-5.3,4.3c-7.4,5.1-8.2,7.2-5.3,17.8
+		c4.2-6.5,8-12.6,11.9-18.6c1.1-1.7,0.9-3.1-1.3-3.6c0,1,0.3,1.8,1.4,2c0.2,0,0.4-0.4,0.6-0.7C2073.8,517.4,2073.1,517,2072.4,516.6
+		z M599.6,517.5c-0.4-0.8-1.1-1.7-1.8-0.8c-0.8,0.8,0.1,1.5,1,1.6c2.4,8.9,7.5,16.2,13.4,24.1c2.3-16.5,1.9-17.3-10.7-24.4
+		C600.9,517.6,600.2,517.6,599.6,517.5z M534.9,1353.5c-20,21.8-37.3,44.1-53.4,67.4c-16.1,23.4-26.8,49.5-41.8,73.5
+		c9-21,17.4-42.2,28.9-61.9c16.9-28.7,35.4-56.4,57.5-81.5c0.9-1,1.6-2.1,2.6-3.1c2.9-2.9,3.3-6,2.3-10
+		c-9.1-33.8-14.6-68.3-19.2-103c-5-38-8.3-76.1-10.6-114.3c-2.5-39.9-3.4-79.9-3.9-119.8c-0.1-5.1-1.4-6.8-6.7-6.9
+		c-21.6-0.2-43.3-0.8-64.9-1.3c-2,0-4-0.4-6,0.8c0,195.2,0,390.5,0,585.6c2.1,0.6,3.1-0.4,4.1-1.1c52.7-33.8,105.3-67.7,158-101.4
+		c3.6-2.3,5.7-5.4,7.3-9.1c6-13,12.5-25.8,20.8-37.4c4.2-5.9,3.9-11.9,2.5-19.1c-2.4,1.8-4,2.9-5.5,4.2
+		c-13.9,12.6-32.1,8.7-42.7-2.9c-7.3-8-12.4-17.2-17.1-26.8C542.3,1375.7,539.4,1365.1,534.9,1353.5z M534.6,627.2
+		c3.6-5,4.3-10.7,6.3-15.9c6.2-15.8,12.6-31.5,25.2-43.7c10.8-10.5,26.8-12.6,38.9-2.8c2.3,1.9,4.3,5,7.9,5
+		c1.6-8.3-0.2-15.3-5.1-21.9c-7.4-9.9-12.7-21-17.8-32.3c-2.4-5.3-5.8-9.2-10.8-12.4c-50.5-32.2-100.9-64.7-151.3-97.1
+		c-2.4-1.5-4.5-3.9-8.7-3.9c0,3.7,0,7.2,0,10.7c0,187.9,0,375.8,0,563.7c0,2,0.2,4,0,6c-0.6,4.9,1.4,6.3,6.2,6.1
+		c13.6-0.6,27.3-0.7,41-1c8.3-0.2,16.7-0.6,25-0.4c4.9,0.1,6.7-1.8,6.1-6.4c-0.1-1,0-2,0-3c1.2-75,4.3-149.8,13.7-224.3
+		c4.6-36.3,10-72.5,19.6-107.9c1.6-5.7,0.4-9.9-3.4-14.4c-10.7-12.8-21.7-25.4-31-39.1c-19-28.1-36.8-57-49.6-88.7
+		c-2.2-5.4-5.5-10.4-6.2-16.6C465,538.3,494.6,586,534.6,627.2z M2060.9,1411.1c-2.3,8.5-0.1,15.1,4,21.4
+		c5.9,9.3,13.4,18.1,17.1,28.2c3.9,10.7,10.9,16.6,19.9,22.4c47.8,30.3,95.3,61.1,143,91.7c2.7,1.7,5,4.3,9.5,4.5c0-3.4,0-6.6,0-9.8
+		c0-188.3,0-376.6,0-565c0-2-0.1-4,0-6c0.2-3.4-1.1-5-4.6-4.8c-2.3,0.1-4.7,0-7,0.1c-20,0.6-40,1.2-60,1.9c-6.7,0.2-6.7,0.4-7,7.4
+		c0,1.3,0,2.7-0.1,4c-0.4,60-3,119.9-8.9,179.7c-5,50.1-11.3,99.9-24,148.7c-1.4,5.2,0.1,8.3,3.5,12.3c15,17.8,29.6,36.1,42.4,55.5
+		c20,30.4,36.1,62.9,49.3,96.8c3.2,8.2,5.7,16.6,6.8,25.4c-33.9-90.8-82.6-145-107.2-169.7c-4.1,11-7.5,22.1-12.7,32.5
+		c-4.9,9.9-10.3,19.5-18.8,26.8c-7.1,6.1-15.1,8.9-24.8,7.5C2073.2,1421.4,2068.3,1415.5,2060.9,1411.1z M2244.8,454.3
+		c0.6,4.5-0.2,6.7-0.8,8.9c-6.5,24.2-17,47-28.2,69.2c-18.9,37.2-43,71.2-70.4,102.8c-2.7,3.2-3.6,5.8-2.5,9.8
+		c7.9,29.6,13.1,59.8,17.3,90.2c6.4,45.6,10.2,91.3,12.8,137.3c2,35.3,2.6,70.6,3.1,105.9c0.1,7.6,0.2,7.6,7.6,7.8
+		c17,0.5,34,1,51,1.4c5,0.1,10,0.2,15,0.5c3.2,0.1,5.1-0.9,4.9-4.5c-0.1-1.7,0-3.3,0-5c0-189.6,0-379.3-0.1-568.9
+		c0-2.4,1.1-5.2-1.2-7.3c-0.8,0.1-1.6,0-2.1,0.4c-52.7,33.8-105.3,67.7-158,101.5c-2,1.3-3.7,2.6-4.7,4.9c-6.9,16-16.9,30.1-25.8,45
+		c-3.1,5.2-3.4,10.2-2,15.7c2.6,0.1,3.5-1.6,4.6-2.6c15.7-13.9,33-10.6,45.6,3.8c6,6.8,10.4,14.6,14.4,22.7
+		c5.1,10.3,8.3,21.3,12.8,32.9C2185.2,576.1,2221.7,520.5,2244.8,454.3z M553.7,662.8c-0.3,1.3-0.7,2.8-1,4.3
+		c-7.1,31.2-11.7,62.8-15.4,94.5c-7.1,59.9-10.3,120.1-11.8,180.4c-0.3,13-0.2,26-0.5,39c-0.1,4.4,1.5,5.7,5.7,5.6
+		c25-0.5,50-0.7,74.9-1.1c7.4-0.1,7.6-0.2,7.6-7.8c0-85.6,0-171.2,0.1-256.8c0-5.3-1.7-8.5-5.8-11.7c-16.6-12.8-32.4-26.6-46.9-41.9
+		C559,665.6,557.6,663,553.7,662.8z M553.6,1319.7c2.1-1,2.8-1.2,3.2-1.6c16.4-17.1,34-32.9,52.7-47.4c3-2.4,3.8-5,3.8-8.6
+		c-0.1-13.3-0.1-26.7-0.1-40c0-72.3,0-144.7,0-217c0-10.3,0.4-9-9.2-9.2c-23.3-0.4-46.7-0.8-70-1.1c-2.8,0-5.9-1-9.3,1.5
+		C526.2,1104.4,531.1,1212.3,553.6,1319.7z M2119.8,1319.2c4.8-20.9,8.3-40.2,11.1-59.6c5.8-39.5,9.8-79.2,12.5-119.1
+		c3.1-45.5,4.7-91.1,5.1-136.7c0.1-7.6-0.1-7.7-7.6-7.7c-24.3,0.1-48.6,0.3-72.9,0.5c-7.9,0.1-8,0.1-8,8.5c0,84.6,0,169.1-0.1,253.7
+		c0,5.6,1.7,9.3,5.9,12.7c12.1,9.9,24.2,19.9,36,30.1C2107.7,1306.9,2113.1,1312.7,2119.8,1319.2z M2120.4,664.4
+		c-2.1-0.6-2.9-0.1-3.6,0.7c-15.2,16.5-33.1,29.9-50.2,44.2c-4.8,4-6.8,8-6.8,14.3c0.3,32,0.2,64,0.2,96c0,52.3,0,104.6,0,157
+		c0,8.1,0.1,8.2,8.2,8.2c18.3,0.2,36.7,0.2,55,0.4c6.7,0.1,13.3,0.1,20,0.3c3.7,0.1,5.7-1.1,5.4-5.1c-0.2-2.3,0-4.7-0.1-7
+		c-0.5-45-2.1-89.9-5.2-134.8C2139.2,780.1,2132.7,721.9,2120.4,664.4z M878.7,1138.5c-36,15-69.8,32.9-102.3,53.1
+		c-3.4,2.1-4.9,4.7-5.7,8.6c-2.8,14.4-5.7,28.8-12.2,42c-3.6,7.3-7.7,14.4-17.3,14.4c-9.6,0-13.4-7.4-17.4-14.4
+		c-1.9-3.2-2-7.6-5.4-9.8c-22.3,17.4-41.6,37.2-58.8,58.9c-5.8,7.3-10.2,15.3-12,24.8c-3.8,20.3-9.1,40.2-16.7,59.5
+		c-2.6,6.7-1.3,13.3-1.5,20.3c1.5-0.4,2-0.3,2.1-0.5c3.2-3.8,6.4-7.6,9.4-11.6c31.2-40.5,66-77.4,105.4-110.2
+		c36.9-30.8,75.6-59.1,117.2-83.1c54.3-31.2,110.9-57.4,170.8-76.4c38.4-12.2,77.4-21.8,117-29.2c9.5-1.8,19.1-3,28.6-4.6
+		c1.5-0.3,3.8,0.3,4.4-1.5c1.4-3.9,0.6-8-0.4-11.7c-1-3.6-4.5-1.7-6.9-1.5c-40.6,3.2-80.4,11-120.4,18c-7,1.2-10.4,4.1-10.9,11.2
+		c-0.3,3.8-0.5,9.1-5.8,9c-4.6-0.1-4.7-5-5.3-8.5c-0.7-4.5-2.4-6-7.3-4.9c-39.3,9.1-78,19.9-115.5,34.7c-4.6,1.8-7.1,4.2-7.8,8.9
+		c-0.9,5.9-2.2,11.8-5.2,17.1c-4.1,7.1-10.6,7.2-14.6,0C881.9,1147.7,880.7,1143.4,878.7,1138.5z M1032.8,891.9
+		c0.9-3.8,1.6-6.7,2.4-9.5c0.7-2.3,1.7-4.6,4.4-4.9c3.4-0.3,4.4,2.3,5.3,4.9c0.4,1.3,0.8,2.6,0.8,3.9c0.1,7.7,4.5,10.4,11.7,11.6
+		c32.5,5.5,64.8,11.9,97.5,15.7c7.9,0.9,15.9,1.7,23.8,2.4c1.9,0.2,4,0.7,5.3-1.6c3.5-6.5,0.3-13-7-14.2c-1-0.2-2-0.2-3-0.4
+		c-42.6-5.8-84.2-15.9-125.4-28.2c-41.8-12.4-82.5-28.2-121.6-47.1c-51-24.6-99.8-53.3-144.7-87.9c-20.6-15.8-40.9-32.1-59.9-49.7
+		c-29.1-26.9-56.4-55.7-80.1-87.7c-3.7-4.9-7.7-9.6-11.6-14.3c-0.8,7.6-2.4,14.7,0.5,21.8c7.4,18.2,12.4,37.2,16,56.5
+		c1.7,9.1,5,17.3,10.6,24.4c9.2,11.4,18.5,22.8,28.7,33.3c9.9,10.1,21.1,19,32.2,28.9c3.8-6.5,5.6-13,9.8-18.2
+		c7.7-9.4,17.7-9.5,25.3-0.1c3.6,4.5,5.7,9.7,7.8,15c4.3,10.9,6.8,22.3,8.9,33.7c0.9,5.2,3.3,8.1,7.5,10.7
+		c21.9,13.4,44.1,26,67.3,37.1c10.9,5.2,22.1,10,33.5,15.2c1.8-4.8,3.1-8.6,4.7-12.2c1.6-3.5,4.2-6.3,8.3-6.1
+		c3.6,0.2,5.8,2.9,7.3,6.1c2.4,5.2,3.8,10.6,4.8,16.2c0.8,4.6,2.9,7.2,7.7,9C950.6,871.5,990.8,883,1032.8,891.9z M1953.8,1233.7
+		c-2.9,5.8-4.9,11.5-8.8,16.2c-7.6,9.3-17.8,9.3-25.3,0c-3.4-4.2-5.5-9-7.5-14c-4.4-11.5-7.2-23.5-9.4-35.7
+		c-0.7-3.9-2.4-6.4-5.8-8.6c-30.4-19.4-62.4-35.6-95-50.8c-6.9-3.3-7-3-9.9,4.7c-0.7,1.9-1.5,3.7-2.3,5.5c-1.6,3.1-3.7,5.6-7.6,5.6
+		c-3.8,0-5.9-2.5-7.6-5.6c-2.9-5.4-4.3-11.3-5.1-17.2c-0.7-5-3-7.3-7.5-9.1c-37.8-15.2-77.3-24.6-116.7-34.3c-3.8-0.9-5.4,0.2-6.2,4
+		c-0.7,3.9-0.2,9.9-6.3,9.5c-5-0.3-5.1-6.1-5.3-9.6c-0.4-6.6-3.3-8.9-9.6-10c-32.8-5.6-65.4-12.2-98.6-15.7
+		c-8.3-0.9-16.5-2.1-24.8-2.7c-5.4-0.4-7.1,1.2-7.5,6.6c-0.3,3.9-1.3,8,5.2,8.4c6.3,0.4,12.4,2.1,18.7,3.1
+		c47.7,7.5,94.4,19.1,140.3,34.3c42.4,14,83.5,31.2,123,52c46.3,24.4,90.2,52.6,131,85.6c48.5,39.1,93.7,81.2,129.4,132.6
+		c1.9,2.8,4.8,7.5,7.3,6.7c4.5-1.5,1.4-6.8,2.1-10.4c0.6-3.4-0.5-6.6-1.8-9.7c-7.8-19.5-12.6-40-17.1-60.4c-1.1-5.1-3-9.4-6-13.5
+		c-17-22.8-36.7-43.1-57.6-62.2C1959.6,1237.1,1957.6,1234.7,1953.8,1233.7z M2043.6,585.1c-4.2,2.7-6.2,6.2-8.5,9.2
+		c-29.9,40.3-64.6,76.1-102.5,109c-33.8,29.3-69.5,56.2-107.6,79.4c-51.8,31.6-106.3,57.7-163.9,77.3
+		c-40.7,13.8-82.1,24.9-124.2,33.1c-13.7,2.7-27.6,4.7-41.3,7c-2.2,0.4-5.3-0.1-6.2,2.4c-1.4,3.8-1.1,8.2,0.3,11.7
+		c1.4,3.5,5.3,1.6,8.1,1.3c40.1-4.2,79.8-10.7,119.5-18.1c6.2-1.2,10.4-2.7,10.5-10.2c0-3.5,0.3-9.3,5.4-9.5c6-0.3,5.5,5.7,6.2,9.6
+		c0.7,3.9,2.3,4.9,6.1,3.9c10-2.7,20-5.1,30-7.5c28.5-6.9,56.4-15.6,83.9-25.7c6.8-2.5,10.2-6.3,11-13.3c0.5-5,2-9.8,4.5-14.2
+		c4.2-7.6,10.8-7.6,15.1,0.1c1.6,2.9,2.5,6.2,3.4,9.3c0.9,2.9,2.5,3.5,5.2,2.2c2.4-1.2,5-1.9,7.3-3.1c26.6-13.1,53.2-26,78.7-41.2
+		c11.9-7.1,19.6-14.7,21.3-29.3c1.4-12.4,5.5-24.8,12.8-35.4c8.1-11.7,19.5-11.7,27.5,0.1c3.1,4.6,5.4,9.7,8.2,14.9
+		c1.9-1.4,3.6-2.5,5.1-3.8c22.2-19.8,42.7-41.1,60.6-64.9c2.6-3.5,4.3-7.3,5.2-11.7c4.5-21.2,9.6-42.2,17.6-62.4
+		C2045.3,599.2,2044.5,592.6,2043.6,585.1z M777.2,1163.8c1.2,0.2,1.6,0.4,1.9,0.3c30.4-14.3,60.9-28.3,92.6-39.6
+		c4.2-1.5,4.4-3.7,3.9-7.5c-4.5-37.4-6.3-75-6.5-112.6c0-7.8-0.2-7.9-8.5-7.9c-22,0-44,0-65.9,0c-8.6,0-8.8,0.1-8.8,8.7
+		c-0.4,45.3-2.2,90.5-6.6,135.6C778.4,1148.4,776.3,1155.9,777.2,1163.8z M776.8,817.8c0.3,3.8,0.5,7.1,0.9,10.4
+		c2.5,21.2,4.1,42.4,5.5,63.7c1.8,28.6,2.3,57.2,2.7,85.9c0.1,7.1,0.3,7.3,7.2,7.3c22.6,0.1,45.3,0.1,67.9,0.1
+		c8.8,0,8.1-0.2,8.1-8.3c0.1-37,1.9-73.9,6.4-110.6c0.7-5.8-0.5-8.2-6-10.1c-29.5-10.3-58-23.3-86.2-36.8
+		C781.5,818.4,779.9,817.2,776.8,817.8z M1896.4,1163.9c1-2.7,0.2-5.3-0.1-7.9c-2.4-19.8-3.9-39.8-5.3-59.7
+		c-2.1-30.3-2.5-60.6-3.3-90.9c-0.2-8.7-0.2-8.8-8.6-8.8c-16.7-0.1-33.3,0-50-0.1c-6.3,0-12.7,0.2-19-0.1c-3.9-0.1-5.5,1.4-5.2,5.3
+		c0.1,1.7,0.1,3.3,0,5c-1.1,36-2,72-6.4,107.7c-0.9,7.7-1.1,7.9,6.3,10.6c28.5,10.4,56.1,22.9,83.3,36.1
+		C1890.6,1162.4,1893.1,1164.4,1896.4,1163.9z M1896.8,817.7c-2.5-0.3-4.3,0.6-6.1,1.5c-6,2.9-12,5.6-18,8.6
+		c-22.1,10.9-44.9,20.1-67.9,28.7c-7.5,2.8-7.3,3-6.5,10.6c1,8.9,1.9,17.9,2.7,26.8c2.4,28.2,3.2,56.5,3.6,84.7
+		c0.1,5.4,1.8,6.7,6.8,6.6c22.6-0.2,45.3-0.1,67.9-0.2c1,0,2-0.1,3,0c3.8,0.3,5.6-1.2,5.2-5.1c-0.2-1.6,0-3.3,0.1-5
+		c0.7-38.6,1.7-77.2,5.2-115.6C1894.1,845.4,1895.5,831.6,1896.8,817.7z M908.3,1109.6c1.4,0,2.4,0.2,3.2,0
+		c37.8-11.7,75.5-24,114.2-32.5c4.5-1,5.8-2.9,5.5-7.4c-1.3-22-2.5-43.9-2.3-65.9c0.1-7.3-0.2-7.4-8-7.4c-33.3,0-66.7,0.1-100,0.2
+		c-7.7,0-7.9,0.1-7.9,7.5c0,31-1.6,61.9-4,92.9C908.8,1101,907.3,1105.2,908.3,1109.6z M1765.3,1110.4c0-2.5,0.1-3.5,0-4.4
+		c-3.1-33.9-4.7-67.8-4.8-101.8c0-7.4-0.4-7.6-8.2-7.7c-33.3-0.1-66.7-0.2-100-0.2c-7.3,0-7.2,0.1-7.5,7.9c-0.7,21-1.1,42-2.3,62.9
+		c-0.5,9-1.3,8.3,7.6,10.4c29.8,7.1,59.4,14.9,88.5,24.5C1747.2,1104.8,1755.7,1107.4,1765.3,1110.4z M908.8,872.2
+		c-0.2,0.3-0.6,0.6-0.6,0.8c2.8,35.5,5.2,71,4.8,106.7c-0.1,4.6,1.9,5.6,6,5.6c34.7-0.1,69.3-0.1,104,0.1c4.9,0,6.2-1.8,6.1-6.4
+		c-0.5-22,0.8-44,2.1-65.9c0.3-5.2-0.9-7.7-6.4-8.8c-36.9-7.6-72.4-20.1-108.5-30.5C913.8,873,911.6,871.1,908.8,872.2z
+		 M1765.6,872.4c-3.2-0.6-5.1,0.3-7,0.9c-22.2,6.7-44.2,14.5-66.7,20.3c-14.5,3.7-29,7.3-43.5,10.8c-4.4,1.1-6.5,2.6-6.2,8
+		c1.3,21.9,1.8,43.9,2.6,65.8c0.2,7,0.2,7.1,7.1,7.1c33.6,0,67.2,0,100.8-0.1c7.5,0,7.7-0.2,7.7-7.8c0.2-24.6,0.9-49.2,2.6-73.8
+		C1763.8,893.4,1764.7,883.1,1765.6,872.4z M725.8,1192.5c8.7-4.8,15.8-9.8,23.8-12.8c9.6-3.7,12.7-10.5,13-19.7
+		c0.1-1.3,0.2-2.7,0.4-4c3.4-27.1,5.6-54.3,6.7-81.5c1-23.6,1.5-47.2,2-70.8c0.2-7-0.1-7-7.3-7.1c-6.7-0.1-13.3,0-20,0
+		c-9,0-18,0.2-27,0c-4.2-0.1-6.2,1.3-5.9,5.7c0.2,2.3,0,4.7,0.1,7c0.8,27.6,1.2,55.2,3,82.8C717,1125.1,719.9,1158.2,725.8,1192.5z
+		 M1946.2,1191.7c2.9-2.2,2.4-4.7,2.8-6.9c4.5-26.6,6.9-53.5,8.9-80.4c2.5-33.9,3.2-67.9,3.7-101.8c0.1-5-1.8-6.2-6.4-6.1
+		c-15.3,0.2-30.6,0-46,0.1c-7.6,0-7.8,0.2-7.7,7.8c0.7,44,2,87.9,6.7,131.6c1.1,10.3,2.2,20.5,3.5,30.7c0.4,2.8,0.2,6,3.5,7.8
+		C1925.8,1180.2,1936.2,1186.1,1946.2,1191.7z M1947.7,789.1c-9.1,5-16.9,10.1-25.3,13.8c-8.2,3.6-10.5,9.5-11.5,17.8
+		c-3,27.1-5.6,54.3-6.9,81.6c-1.2,25.3-1.5,50.6-2.5,75.9c-0.2,5.1,1.5,7,6.7,7c15-0.3,30-0.1,45-0.2c8.6,0,8.4,0.6,8.3-8.9
+		c-0.3-30.6-1-61.3-3.1-91.9C1956.3,852.9,1953.6,821.8,1947.7,789.1z M726,789.2c-3.3,16.4-5.1,31.3-6.7,46.2
+		c-4.6,42.4-6.3,85-7.3,127.7c-0.1,5.7,0,11.3-0.2,17c-0.1,3.4,1.4,4.8,4.7,4.8c17,0,34,0,51,0.1c3.6,0,4.6-1.9,4.4-5
+		c-0.1-2.3-0.1-4.7-0.1-7c-0.5-37.3-1.7-74.6-5-111.8c-1.4-15.9-2.8-31.9-5.5-47.6c-0.4-2.6-0.3-5.2-3.2-6.8
+		C747.6,801.1,737.2,795.4,726,789.2z M1625.1,910.5c-9.8,1.8-18,3.4-26.2,4.6c-23.3,3.5-46.2,9.9-70,10
+		c-10.9,0.1-21.8,2.4-32.7,3.7c-3.5,0.4-6.2,1.1-6,6c0.5,15,0.7,30,0.7,44.9c0,4.4,1.7,5.8,5.9,5.7c8.3-0.2,16.6,0,25-0.1
+		c30.6,0,61.3,0,91.9-0.1c9,0,9-0.1,9.2-9.4c0.2-13,0.2-26,0.6-38.9C1623.7,928.4,1624.5,919.8,1625.1,910.5z M1625.2,1071.1
+		c-2.2-23.8-2.3-46.1-2.4-68.4c0-4.5-1-6.6-6.1-6.6c-39.9,0.1-79.9,0.1-119.8-0.1c-5.1,0-6.1,2-6.1,6.5c0,14.6-0.1,29.3-0.6,43.9
+		c-0.1,4.5,1.6,5.6,5.6,6.1c12.6,1.4,25,3.8,37.7,4c8,0.1,15.9,1.1,23.8,2.5C1579.5,1063,1601.7,1066.9,1625.2,1071.1z
+		 M1049.3,1070.4c2.6,1,4.9-0.1,7-0.6c23-5.5,46.3-8.9,69.7-12.3c16.7-2.5,33.7-3.8,50.6-5.2c5.1-0.4,6.8-1.9,6.6-7
+		c-0.4-14-0.3-27.9-0.5-41.9c-0.1-7-0.2-7.2-7.2-7.2c-39.3,0-78.5,0-117.8,0.1c-6.7,0-6.8,0.2-6.8,7.5c0,16.3-0.5,32.6-1.4,48.9
+		C1049.3,1058.6,1048.4,1064.5,1049.3,1070.4z M1049.8,910.2c-0.4,1.2-0.8,1.8-0.8,2.4c0.6,22.6,2.5,45.2,1.9,67.8
+		c-0.1,4.2,2.1,4.8,5.6,4.8c39.9,0,79.9-0.1,119.8,0.1c5.5,0,6.7-2.3,6.6-7.2c-0.2-11,0.1-22,0.2-32.9c0.1-15.9,0.1-15.5-16.3-17.4
+		c-16.5-1.9-33.1-2.4-49.6-5.2C1094.7,918.9,1072,915.9,1049.8,910.2z M1260.5,985.4c21.6,0,43.2,0,64.9,0c9.1,0,9.1-0.1,9.1-9.4
+		c0-10.3,0-20.6-0.1-30.9c-0.1-7.7-0.1-7.7-7.6-7.9c-2.3-0.1-4.7,0-7,0c-41.9,0-83.8-2.2-125.5-6.2c-4.6-0.4-5.9,0.9-6,5.1
+		c-0.2,13.6-0.6,27.3-0.8,40.9c-0.1,8.3,0.1,8.4,8.1,8.4C1217.3,985.4,1238.9,985.4,1260.5,985.4z M1485,931.5
+		c-3.1-1.4-5.4-0.6-7.7-0.4c-26.2,1.9-52.4,4.3-78.7,5.1c-17.3,0.5-34.6,1.3-51.9,1.1c-7.4-0.1-7.5,0.1-7.6,7.8
+		c-0.1,11.7,0,23.3-0.1,35c0,3.7,1,5.8,5,5.5c2-0.1,4,0,6,0c41.6,0,83.2,0,124.9,0c2,0,4-0.1,6,0c3.3,0.1,5-1.2,4.9-4.6
+		C1485.5,964.2,1485.3,947.6,1485,931.5z M1485,1051.1c0.3-17,0.5-33.6,0.9-50.1c0.1-4.2-2.2-4.8-5.7-4.8c-45,0.1-89.9,0.1-134.9,0
+		c-4.7,0-6.5,1.4-6.3,6.2c0.3,12,0.4,24,0,36c-0.2,5.2,2.1,6,6.5,6c11.6-0.1,23.3,0.1,34.9,0.4
+		C1415,1045.8,1449.5,1048.1,1485,1051.1z M1188.4,1050.6c47.5-3.4,93.2-6.8,139.2-6.4c0.7,0,1.3,0,2,0c3.2,0.2,4.9-0.9,4.9-4.5
+		c-0.1-13,0-25.9,0-38.9c0-3.4-1.6-4.8-4.9-4.6c-1.7,0.1-3.3,0-5,0c-42.6,0-85.1,0-127.7,0c-1.7,0-3.3,0.1-5,0
+		c-2.8-0.1-4.4,1.1-4.4,4.1C1187.9,1016.8,1188.1,1033.4,1188.4,1050.6z M2010.7,1230.1c0.9-7.3-0.9-13.8-1.5-20.3
+		c-6.8-66-10.3-132.2-10.7-198.6c-0.1-16.1-0.3-16.3-16.8-14.7c-2.9,0.3-4.2,1.1-4.1,4.1c0.1,3,0,6,0,9
+		c-0.3,41.3-2.1,82.6-6.1,123.8c-2,20.2-4.3,40.4-8.2,60.4c-0.9,4.8-0.2,7.8,4.5,10.4c10.2,5.7,19.9,12.2,29.8,18.3
+		C2001.8,1225,2005.6,1228.2,2010.7,1230.1z M2011.2,752.5c-2.7-0.8-3.6,0.3-4.7,1c-13.3,8.3-26.4,16.7-39.8,24.7
+		c-3.6,2.1-4.2,4.5-3.5,8.2c1.4,7.8,2.8,15.7,3.9,23.6c7.4,53.8,10.1,107.9,10.6,162.2c0.1,14.1-2.6,12.8,13.7,12.8
+		c7,0,7-0.2,7.1-7.3c0.4-27.3,0.6-54.6,1.8-81.8c1.4-30.9,3.1-61.8,6.1-92.6C2008,786.3,2009.6,769.5,2011.2,752.5z M662.1,1231.5
+		c3.7-2.4,5.6-3.7,7.5-4.9c11.6-7.7,22.9-16.2,35.5-22.2c5.3-2.5,6.2-5.5,5.1-11c-4.6-22.5-7-45.4-9-68.3
+		c-3.5-39.9-5-79.8-5.4-119.8c-0.1-8.6-0.2-8.6-8.8-8.7c-1.3,0-2.7,0-4,0c-7.9,0.1-8,0.1-7.9,8.4c0,24.7-0.6,49.3-1.6,74
+		c-1.3,32-3,63.9-6,95.8C665.8,1192.9,664.1,1211.1,662.1,1231.5z M662.9,752.1c-1,1.4-0.4,3-0.3,4.6c2,20.5,4.6,41.1,6,61.7
+		c3.8,52.5,6.5,105.1,6.4,157.8c0,8.8,0.1,8.9,8.5,8.9c14.5-0.1,12.1,1.3,12.3-12.1c1.1-62.7,3.5-125.2,14.8-187
+		c0.8-4.1-0.9-6-4.2-7.7c-13.4-6.8-25.6-15.5-38-23.9C666.8,753.1,665.5,751.1,662.9,752.1z M2044.3,728.6c-5.4,1.1-7.1,3.9-7.7,8.3
+		c-1.7,14.9-4,29.7-5.6,44.6c-4.6,42.1-7.2,84.2-8.9,126.5c-1,25.3-1.3,50.5-1.3,76.8c6.5,0,12.4-0.1,18.3,0
+		c3.8,0.1,5.5-1.4,5.2-5.3c-0.2-1.7,0-3.3,0-5c0-78.9,0-157.9,0-236.8C2044.3,734.9,2044.3,732,2044.3,728.6z M2044.3,1253
+		c0-3.7,0-6.4,0-9c0-78.6,0-157.2,0-235.8c0-13,1.3-11.5-11.9-11.5c-13,0-11.5-1.8-11.5,11.8c0,59.3,3.1,118.5,8.7,177.6
+		c1.9,19.5,4,39.1,7,58.5C2037.3,1248.9,2038.8,1251.8,2044.3,1253z M629.2,728.7c0,4.3,0,8,0,11.6c0,76.5,0,153.1,0,229.6
+		c0,15.8,0,15.8,16,15.3c7.6-0.2,7.6-0.2,7.7-7.7c0.1-3.3,0-6.7,0-10c-0.8-55.6-3.1-111.1-8.5-166.4c-2-21.2-5-42.3-7.3-63.4
+		C636.6,733.3,635,730.3,629.2,728.7z M629.2,1253.2c5.3-2.1,7.4-4.5,7.9-9.2c1.6-14.9,4-29.7,5.5-44.6
+		c6.5-62.4,9.5-124.9,10.3-187.6c0.2-15.6,0.1-15.6-15-15.6c-9,0-8.8-0.6-8.7,8.6c0,2,0,4,0,6c0,75.7,0,151.3,0,227
+		C629.2,1242.5,629.2,1247.2,629.2,1253.2z M2060,697.5c19-15.9,36.7-29.3,52.3-45.3c3.5-3.5,3.7-6.7,2.4-10.7
+		c-2.8-8.9-5.4-17.8-8.7-26.5c-3.5-9.3-7.4-18.5-13.7-26.4c-5.3-6.6-8-6.6-13.4-0.4c-1.3,1.5-2.7,3-3.6,4.7
+		c-8.9,15.7-17.3,31.5-15.3,50.5c0.4,3.6,0.1,7.3,0.1,11C2060,668,2060,681.5,2060,697.5z M613.2,1283.1
+		c-20.8,13.6-36.9,29.9-53.8,45.4c-2.8,2.6-2.3,5.1-1.5,8.1c4.1,14.7,8.6,29.3,15.3,43.2c2.6,5.4,5.4,10.7,9.8,15
+		c4.3,4.2,6.2,4.6,10,0.4c10.7-11.9,18.4-26.3,19.7-41.7C614.7,1330.6,613.2,1307.6,613.2,1283.1z M2060,1284.4
+		c0,19.5,0.7,36.8-0.2,54c-1.1,19.1,6.3,35.2,15.8,50.5c7.4,12.1,12.1,11.7,19.8-0.6c9.7-15.4,14.6-32.7,19.7-50
+		c1.1-3.7,0-6.2-2.6-8.8C2096.8,1313.6,2079.3,1299.9,2060,1284.4z M611.9,698.2c2.1-3.3,1.3-5.9,1.3-8.4c0.1-16-0.8-32,0.3-47.9
+		c1.2-18.4-6.2-33.8-15.1-48.6c-7.6-12.7-12.6-12.4-20.4,0.3c-10.1,16.3-15.1,34.6-20.4,52.8c-1,3.6,0.6,5.5,3,7.7
+		c8.8,8.1,17.3,16.7,26.3,24.5C594.8,685.4,603.3,691.5,611.9,698.2z M1788.2,864c-12.5,3.2-12.6,3.2-13.9,13.8
+		c-0.9,7.6-1.6,15.2-2.1,22.8c-1.8,26.2-2.9,52.5-3.2,78.8c0,4,0.8,6.3,5.4,6c4.6-0.3,9.3-0.2,14,0c5.1,0.1,6.9-2.1,6.7-7.3
+		c-0.5-11.3-0.2-22.6-0.7-33.9C1793.2,917.5,1792.3,890.9,1788.2,864z M885.3,1118.4c12.8-3,12.5-3,13.8-13.9
+		c3.5-29.5,4.6-59.1,5-88.8c0.3-23.5,5.2-18.7-19.8-19.4c-4.4-0.1-5.7,1.5-5.7,5.8C878.8,1040.8,880.3,1079.4,885.3,1118.4z
+		 M885.7,863.5c-0.2,0.9-0.6,1.9-0.7,2.9c-4.3,33.7-6,67.5-6.1,101.4c0,5.5-2.5,12.6,1.3,16.2c3.8,3.6,10.8,1.1,16.3,1.2
+		c7.9,0.1,8.1-0.1,7.9-8.4c-0.6-33.2-1.5-66.4-5.3-99.4C897.9,865.6,898,865.6,885.7,863.5z M1788.4,1117.5
+		c4.4-34.4,5.9-68.6,6.5-102.9c0.1-5.6,2.4-12.7-0.9-16.5c-3.9-4.3-11.3-1.4-17.2-1.6c-7.6-0.2-7.7,0.1-7.7,7.6
+		c0,24.7,1.3,49.3,2.8,73.9c0.6,10.3,2.2,20.5,2.9,30.8c0.3,3.6,1.7,5.5,4.9,6.5C1782.2,1116,1784.4,1117.7,1788.4,1117.5z
+		 M1481.1,1078.1c0-2.7,0.1-4.4,0-6c-0.3-7.8-0.3-8.1-8.2-8.7c-22.9-1.7-45.8-3.3-68.7-4.7c-19.9-1.2-39.9-0.9-59.9-1
+		c-4.6,0-5.5,2-5.4,6c0.1,3.7,0.3,6.7,5.2,6.2c1.3-0.1,2.7,0,4,0c34.3-0.3,68.4,1.9,102.5,5.6
+		C1460.6,1076.6,1470.4,1078.5,1481.1,1078.1z M1480,903c-15.3,1.6-30.8,3.6-46.3,4.8c-29.5,2.4-59.1,4.7-88.8,3.9
+		c-5.1-0.1-6.1,2-6,6.5c0.1,4.1,1.1,6.3,5.6,5.8c1.3-0.2,2.7,0,4,0c42.3,0.3,84.5-2.6,126.7-5.9c4.2-0.3,6.2-1.6,5.8-5.9
+		C1480.7,909.3,1482,906.3,1480,903z M1192.2,1078.2c3.1-0.2,5.4-0.3,7.6-0.5c37-4.6,74-7.6,111.3-7.8c6,0,12-0.1,18,0
+		c3.7,0.1,5.3-1.1,5.4-5.1c0.1-6.5,0-6.9-7.3-7c-40.6-0.8-81.1,1.7-121.6,4.6C1193.1,1063.3,1193.2,1063.6,1192.2,1078.2z
+		 M1192.6,903.2c0.2,14.4,0.2,14.4,12.8,16c3,0.4,6,0.6,8.9,0.8c19.3,1.1,38.5,2,57.8,3.2c18.6,1.2,37.2,0.8,55.9,0.8
+		c6.4,0,6.3-0.5,6.6-6.8c0.2-5.8-3.3-5.5-7.1-5.4c-28.3,0.8-56.5-1.5-84.7-3.6C1226.3,907,1209.8,905.4,1192.6,903.2z M653.6,694.6
+		c2,12.3,3.8,22.4,5.1,32.6c0.5,3.7,1.7,6.1,4.8,8c14.2,8.8,27.5,18.8,42.2,26.6c2.7,1.4,6.2,6.3,8.9,2.4c2.7-3.7-2.6-6.2-5-8.5
+		c-19-17.3-36.7-35.8-51.8-56.7C657,698.1,656,697.3,653.6,694.6z M654,1284.6c0.8,0,1.3,0.1,1.5,0c1.4-1.4,2.9-2.7,4-4.3
+		c14.6-20.8,32.8-38.3,51.2-55.5c1.2-1.1,2.6-2.1,3.6-3.4c1.4-1.7,1.5-3.6-0.2-5.7c-2.9,0.3-5.3,2.1-7.8,3.6
+		c-10.2,6.3-19.8,13.5-30.5,18.8c-12.9,6.4-19.3,15.7-19.2,30.2C656.6,1273.7,654.9,1279.1,654,1284.6z M2019.1,698.8
+		c-0.5-0.3-1-0.6-1.5-0.9c-1,1.2-2,2.4-3,3.6c-6.8,9-13,18.4-21.4,26.1c-11,10.1-20.5,21.7-32.4,30.8c-1.9,1.5-3.6,3.2-2.1,5.9
+		c2,3.5,4.1,0.5,5.7-0.4c15.4-9.7,30.8-19.6,46.1-29.5c2.3-1.5,4-3.1,4.4-6.2C2016.2,718.5,2017.7,708.6,2019.1,698.8z
+		 M2017.1,1283.9c0.7-0.2,1.4-0.5,2.1-0.7c-1.5-10.1-3-20.2-4.4-30.4c-0.4-2.6-1.9-4.1-3.9-5.4c-15.6-10-31.3-20.1-46.9-30
+		c-1.5-1-3.3-2.8-5-0.5c-1.7,2.4-0.3,4.2,1.7,5.9c4,3.4,8.1,6.9,11.8,10.6C1988.4,1249.3,2005.3,1264.3,2017.1,1283.9z M1044.6,1034
+		c0.2,0,0.3,0,0.5,0c0-11-0.1-21.9,0.1-32.9c0.1-4.2-2-4.8-5.5-4.9c-4.5-0.1-4.6,2.6-4.6,5.9c0.1,22.3,1.2,44.5,2.4,66.8
+		c0.1,1,0.2,2,0.4,3c0.2,1.2,1.2,1.8,2.1,1.7c0.8-0.1,1.9-1,2.2-1.7c0.5-1.5,0.7-3.2,0.8-4.9C1043.5,1055.9,1044,1045,1044.6,1034z
+		 M1636.4,1033.8c0.7,0,1.4,0,2.1,0c0-10.6,0-21.2,0-31.8c0-2.7,0.2-5.3-3.6-5.8c-4.7-0.6-6,0.4-6,6.1c-0.1,21.9,0.2,43.7,2.1,65.6
+		c0.1,1.3,0.1,2.7,0.6,3.9c0.3,0.7,1.5,1.6,2.2,1.5c0.7,0,1.7-1.1,1.9-1.8c0.5-1.9,0.7-3.9,0.7-5.9
+		C1636.4,1055,1636.4,1044.4,1636.4,1033.8z M1638.5,948.1c-0.2,0-0.5,0-0.7,0c-0.5-11.6-1-23.3-1.6-34.9c-0.1-1.9,0.2-4.8-2.3-4.9
+		c-3.3-0.1-2.8,3-3,5.2c-0.3,3-0.4,6-0.7,9c-1.5,19-1.4,37.9-1.4,56.9c0,5.3,2,6.8,6.4,5.8c3.8-0.8,3.3-3.6,3.3-6.2
+		C1638.5,968.8,1638.5,958.4,1638.5,948.1z M1045.1,948c-0.1,0-0.3,0-0.4,0c-0.6-11.9-1.2-23.9-1.9-35.8c-0.1-1.9-0.4-4.3-3.2-3.9
+		c-2.2,0.3-1.9,2.4-2,4c-1.3,22.5-2.3,45.1-2.5,67.7c0,3.7,1.2,5.4,5.1,5.4c4.1,0.1,5-1.9,5-5.5C1045,969.3,1045.1,958.7,1045.1,948
+		z M741.9,740.1c-4.9,5.5-6.3,11-8.3,16.2c-0.8,2-0.8,4,1.2,5.3c6.2,4.1,11.6,9.4,19.7,13C751.6,762.1,748.8,750.9,741.9,740.1z
+		 M1931.7,1241.3c11.7-16.6,11.5-18.2-3-28.3c-2.7-1.9-4.9-4.5-9.1-4.9C1921.9,1219.6,1924.7,1230.7,1931.7,1241.3z M1931.6,740
+		c-6.6,10.9-9.8,22-12.1,33.9c4-0.9,6.1-3.1,8.5-4.8C1943.5,758.3,1943.6,757.2,1931.6,740z M742.1,1241.3
+		c6.6-11.1,9.8-21.9,12.2-34.3c-8,3.6-13.2,8.8-19.2,12.6c-2,1.3-2.3,3.1-1.6,5.1C735.6,1230.2,736.7,1236.2,742.1,1241.3z
+		 M597.6,1464.4c16.9-6.5,17.3-8.9,14-24.4C605.8,1447.2,601.7,1455,597.6,1464.4z M2061.5,1442.5c-5.1,14.3,5.6,17.3,12.5,22.8
+		C2072.1,1457,2066.2,1451,2061.5,1442.5z M1781.6,836.9c-1,5.2-3.6,8.5-1.8,12.6C1785.7,846.2,1785.7,846.2,1781.6,836.9z
+		 M895.4,849.3c-1.5-4.5-1.6-7.9-3.8-11.1C887.9,846.3,887.9,846.3,895.4,849.3z M630.1,1284.6c-0.4-5.3,4.1-10.2,1.8-17
+		C627.4,1273.6,629.9,1279.2,630.1,1284.6z M629.9,697.1c0.2,5.4-3,11.4,2.4,16.6C633.8,707.4,630.4,702.5,629.9,697.1z
+		 M2044.5,1284.5c-1-5.2,1.5-10.3-2.8-15C2040.3,1275.4,2042.4,1279.6,2044.5,1284.5z M2041.9,712.1c4.1-4.8,1.6-10,2.2-14.6
+		C2043,702.1,2039.8,706.2,2041.9,712.1z M892.2,1143.9c0.4-4.2,3.5-7.3,1.6-11.5C887.6,1136,887.6,1136,892.2,1143.9z
+		 M1779.6,1132.2c-1,2.9-0.4,4.8,0.4,6.5c0.7,1.5,0.4,3.6,2.3,4.6C1785.7,1135.3,1785.7,1135.3,1779.6,1132.2z M729.5,774
+		c1.5,1.6,2.6,4,5.8,3.2C733.9,774.7,732.2,773.5,729.5,774z M737.9,778.4c-0.2,0.2-0.5,0.4-0.7,0.6c0.2,0.2,0.4,0.6,0.6,0.6
+		c0.2,0,0.5-0.3,0.7-0.5C738.4,778.8,738.1,778.6,737.9,778.4z"/>
+	<path class="st1" d="M534.9,1353.5c4.5,11.6,7.4,22.2,12.2,32c4.7,9.6,9.8,18.8,17.1,26.8c10.6,11.6,28.8,15.5,42.7,2.9
+		c1.4-1.3,3.1-2.4,5.5-4.2c1.4,7.2,1.7,13.2-2.5,19.1c-8.4,11.7-14.8,24.4-20.8,37.4c-1.7,3.7-3.7,6.7-7.3,9.1
+		c-52.7,33.7-105.3,67.6-158,101.4c-1.1,0.7-2.1,1.7-4.1,1.1c0-195.1,0-390.4,0-585.6c2.1-1.2,4.1-0.9,6-0.8
+		c21.6,0.5,43.3,1.1,64.9,1.3c5.3,0,6.7,1.8,6.7,6.9c0.5,40,1.4,79.9,3.9,119.8c2.4,38.2,5.6,76.4,10.6,114.3
+		c4.6,34.7,10.1,69.1,19.2,103c1.1,4,0.6,7.1-2.3,10c-0.9,0.9-1.7,2.1-2.6,3.1c-22.1,25.1-40.6,52.7-57.5,81.5
+		c-11.6,19.7-19.9,41-28.9,61.9c14.9-23.9,25.7-50.1,41.8-73.5C497.6,1397.6,514.9,1375.3,534.9,1353.5z"/>
+	<path class="st1" d="M534.6,627.2c-40-41.2-69.6-89-94.2-140.1c0.7,6.2,4,11.2,6.2,16.6c12.7,31.7,30.5,60.6,49.6,88.7
+		c9.3,13.7,20.4,26.3,31,39.1c3.8,4.5,5,8.7,3.4,14.4c-9.6,35.4-15,71.6-19.6,107.9c-9.4,74.5-12.5,149.3-13.7,224.3c0,1-0.1,2,0,3
+		c0.6,4.7-1.2,6.5-6.1,6.4c-8.3-0.2-16.7,0.2-25,0.4c-13.7,0.3-27.3,0.4-41,1c-4.8,0.2-6.8-1.2-6.2-6.1c0.3-2,0-4,0-6
+		c0-187.9,0-375.8,0-563.7c0-3.5,0-7.1,0-10.7c4.2-0.1,6.3,2.3,8.7,3.9c50.4,32.4,100.8,64.9,151.3,97.1c5,3.2,8.4,7.1,10.8,12.4
+		c5.1,11.2,10.4,22.4,17.8,32.3c4.9,6.6,6.7,13.5,5.1,21.9c-3.6-0.1-5.6-3.1-7.9-5c-12-9.8-28.1-7.7-38.9,2.8
+		c-12.6,12.2-19,27.9-25.2,43.7C538.8,616.5,538.2,622.2,534.6,627.2z"/>
+	<path class="st1" d="M2060.9,1411.1c7.4,4.3,12.3,10.3,20.6,11.4c9.8,1.4,17.7-1.4,24.8-7.5c8.5-7.3,13.9-16.9,18.8-26.8
+		c5.1-10.4,8.6-21.5,12.7-32.5c24.7,24.7,73.3,78.9,107.2,169.7c-1.1-8.8-3.5-17.2-6.8-25.4c-13.2-33.9-29.3-66.4-49.3-96.8
+		c-12.8-19.5-27.4-37.7-42.4-55.5c-3.4-4-4.8-7.1-3.5-12.3c12.8-48.8,19.1-98.6,24-148.7c5.9-59.7,8.4-119.6,8.9-179.7
+		c0-1.3,0-2.7,0.1-4c0.2-7,0.2-7.1,7-7.4c20-0.7,40-1.3,60-1.9c2.3-0.1,4.7,0,7-0.1c3.5-0.2,4.8,1.4,4.6,4.8c-0.1,2,0,4,0,6
+		c0,188.3,0,376.6,0,565c0,3.2,0,6.4,0,9.8c-4.5-0.2-6.9-2.8-9.5-4.5c-47.7-30.6-95.2-61.4-143-91.7c-9-5.7-16-11.6-19.9-22.4
+		c-3.7-10.1-11.2-18.9-17.1-28.2C2060.8,1426.2,2058.6,1419.6,2060.9,1411.1z"/>
+	<path class="st1" d="M2244.8,454.3c-23,66.2-59.6,121.8-106.6,172.4c-4.5-11.6-7.7-22.6-12.8-32.9c-4-8.1-8.4-15.8-14.4-22.7
+		c-12.6-14.4-29.9-17.7-45.6-3.8c-1.1,1-2,2.7-4.6,2.6c-1.4-5.5-1.1-10.5,2-15.7c8.8-14.9,18.9-29,25.8-45c1-2.3,2.7-3.7,4.7-4.9
+		c52.7-33.9,105.3-67.7,158-101.5c0.5-0.3,1.3-0.2,2.1-0.4c2.3,2.1,1.2,4.9,1.2,7.3c0.1,189.6,0.1,379.3,0.1,568.9
+		c0,1.7-0.1,3.3,0,5c0.2,3.6-1.7,4.6-4.9,4.5c-5-0.2-10-0.3-15-0.5c-17-0.5-34-1-51-1.4c-7.4-0.2-7.5-0.2-7.6-7.8
+		c-0.5-35.3-1.1-70.6-3.1-105.9c-2.6-45.9-6.4-91.7-12.8-137.3c-4.2-30.3-9.4-60.5-17.3-90.2c-1.1-4-0.2-6.6,2.5-9.8
+		c27.4-31.6,51.5-65.6,70.4-102.8c11.3-22.2,21.7-44.9,28.2-69.2C2244.6,460.9,2245.4,458.8,2244.8,454.3z"/>
+	<path class="st1" d="M553.7,662.8c3.8,0.2,5.2,2.8,6.9,4.6c14.5,15.2,30.3,29,46.9,41.9c4.1,3.2,5.8,6.4,5.8,11.7
+		c-0.2,85.6-0.1,171.2-0.1,256.8c0,7.5-0.1,7.7-7.6,7.8c-25,0.4-50,0.6-74.9,1.1c-4.3,0.1-5.9-1.2-5.7-5.6c0.4-13,0.2-26,0.5-39
+		c1.5-60.3,4.7-120.5,11.8-180.4c3.7-31.7,8.3-63.3,15.4-94.5C553,665.6,553.4,664.1,553.7,662.8z"/>
+	<path class="st1" d="M553.6,1319.7c-22.4-107.4-27.4-215.3-28.7-323.3c3.3-2.5,6.4-1.5,9.3-1.5c23.3,0.3,46.7,0.7,70,1.1
+		c9.5,0.1,9.2-1.2,9.2,9.2c0,72.3,0,144.7,0,217c0,13.3-0.1,26.7,0.1,40c0,3.6-0.7,6.2-3.8,8.6c-18.7,14.5-36.3,30.3-52.7,47.4
+		C556.3,1318.5,555.6,1318.7,553.6,1319.7z"/>
+	<path class="st1" d="M2119.8,1319.2c-6.7-6.5-12.1-12.3-18-17.5c-11.8-10.2-23.8-20.2-36-30.1c-4.2-3.4-5.9-7.1-5.9-12.7
+		c0.2-84.6,0.1-169.1,0.1-253.7c0-8.4,0.1-8.5,8-8.5c24.3-0.2,48.6-0.4,72.9-0.5c7.5,0,7.7,0,7.6,7.7c-0.3,45.6-1.9,91.2-5.1,136.7
+		c-2.7,39.9-6.7,79.6-12.5,119.1C2128.1,1279,2124.6,1298.3,2119.8,1319.2z"/>
+	<path class="st1" d="M2120.4,664.4c12.3,57.5,18.7,115.7,22.8,174.2c3.1,44.9,4.7,89.8,5.2,134.8c0,2.3-0.1,4.7,0.1,7
+		c0.3,4-1.7,5.2-5.4,5.1c-6.7-0.2-13.3-0.3-20-0.3c-18.3-0.1-36.7-0.2-55-0.4c-8-0.1-8.2-0.1-8.2-8.2c0-52.3,0-104.6,0-157
+		c0-32,0.2-64-0.2-96c-0.1-6.3,2-10.3,6.8-14.3c17.1-14.3,35.1-27.7,50.2-44.2C2117.5,664.3,2118.3,663.8,2120.4,664.4z"/>
+	<path class="st1" d="M878.7,1138.5c2,4.9,3.2,9.1,5.3,12.8c4,7.2,10.5,7.1,14.6,0c3-5.3,4.3-11.2,5.2-17.1c0.8-4.7,3.2-7.1,7.8-8.9
+		c37.6-14.8,76.3-25.6,115.5-34.7c5-1.1,6.6,0.4,7.3,4.9c0.6,3.5,0.7,8.4,5.3,8.5c5.3,0.1,5.5-5.2,5.8-9c0.5-7.1,3.9-10,10.9-11.2
+		c40-7,79.8-14.9,120.4-18c2.4-0.2,5.9-2.1,6.9,1.5c1,3.7,1.8,7.8,0.4,11.7c-0.7,1.8-2.9,1.2-4.4,1.5c-9.5,1.6-19.1,2.8-28.6,4.6
+		c-39.6,7.4-78.6,17-117,29.2c-59.9,19-116.5,45.2-170.8,76.4c-41.6,24-80.2,52.3-117.2,83.1c-39.4,32.8-74.3,69.6-105.4,110.2
+		c-3,3.9-6.2,7.7-9.4,11.6c-0.1,0.2-0.6,0.2-2.1,0.5c0.2-7-1.1-13.6,1.5-20.3c7.6-19.2,12.9-39.2,16.7-59.5
+		c1.8-9.6,6.2-17.5,12-24.8c17.2-21.7,36.5-41.5,58.8-58.9c3.4,2.2,3.5,6.6,5.4,9.8c4,7,7.8,14.4,17.4,14.4
+		c9.6,0,13.8-7.2,17.3-14.4c6.5-13.3,9.4-27.7,12.2-42c0.8-3.9,2.2-6.5,5.7-8.6C808.9,1171.4,842.7,1153.5,878.7,1138.5z"/>
+	<path class="st1" d="M1032.8,891.9c-42-9-82.2-20.4-121.3-35.7c-4.8-1.9-6.9-4.4-7.7-9c-0.9-5.6-2.3-11.1-4.8-16.2
+		c-1.5-3.2-3.7-5.9-7.3-6.1c-4.1-0.2-6.8,2.5-8.3,6.1c-1.6,3.6-2.8,7.4-4.7,12.2c-11.4-5.2-22.6-10-33.5-15.2
+		c-23.1-11.1-45.4-23.7-67.3-37.1c-4.3-2.6-6.6-5.5-7.5-10.7c-2.1-11.4-4.6-22.8-8.9-33.7c-2.1-5.3-4.2-10.5-7.8-15
+		c-7.6-9.4-17.5-9.4-25.3,0.1c-4.2,5.2-6,11.7-9.8,18.2c-11.1-9.9-22.3-18.8-32.2-28.9c-10.2-10.4-19.5-21.8-28.7-33.3
+		c-5.6-7-8.9-15.3-10.6-24.4c-3.7-19.3-8.6-38.3-16-56.5c-2.9-7.1-1.4-14.1-0.5-21.8c3.9,4.8,7.9,9.4,11.6,14.3
+		c23.7,32,51,60.7,80.1,87.7c19,17.6,39.4,33.9,59.9,49.7c45,34.7,93.8,63.3,144.7,87.9c39.2,18.9,79.8,34.7,121.6,47.1
+		c41.2,12.2,82.8,22.3,125.4,28.2c1,0.1,2,0.2,3,0.4c7.3,1.2,10.5,7.7,7,14.2c-1.3,2.3-3.4,1.7-5.3,1.6c-8-0.7-15.9-1.5-23.8-2.4
+		c-32.8-3.7-65.1-10.2-97.5-15.7c-7.1-1.2-11.5-3.9-11.7-11.6c0-1.3-0.4-2.6-0.8-3.9c-0.8-2.6-1.9-5.3-5.3-4.9
+		c-2.7,0.3-3.7,2.6-4.4,4.9C1034.4,885.3,1033.7,888.2,1032.8,891.9z"/>
+	<path class="st1" d="M1953.8,1233.7c3.8,1,5.8,3.4,8,5.3c21,19.1,40.7,39.4,57.6,62.2c3,4.1,4.9,8.4,6,13.5
+		c4.5,20.5,9.3,40.9,17.1,60.4c1.3,3.1,2.4,6.3,1.8,9.7c-0.6,3.6,2.4,8.9-2.1,10.4c-2.5,0.8-5.4-3.9-7.3-6.7
+		c-35.7-51.5-81-93.6-129.4-132.6c-40.8-32.9-84.7-61.2-131-85.6c-39.5-20.8-80.6-37.9-123-52c-45.9-15.2-92.6-26.8-140.3-34.3
+		c-6.2-1-12.4-2.7-18.7-3.1c-6.5-0.4-5.5-4.5-5.2-8.4c0.4-5.4,2.1-7.1,7.5-6.6c8.3,0.7,16.5,1.9,24.8,2.7
+		c33.2,3.4,65.8,10.1,98.6,15.7c6.3,1.1,9.2,3.4,9.6,10c0.2,3.6,0.3,9.3,5.3,9.6c6,0.4,5.5-5.6,6.3-9.5c0.7-3.9,2.4-5,6.2-4
+		c39.4,9.7,78.9,19.2,116.7,34.3c4.5,1.8,6.8,4.2,7.5,9.1c0.9,5.9,2.2,11.8,5.1,17.2c1.7,3.1,3.8,5.6,7.6,5.6c3.8,0,6-2.5,7.6-5.6
+		c0.9-1.8,1.7-3.6,2.3-5.5c2.8-7.7,2.9-7.9,9.9-4.7c32.6,15.3,64.6,31.4,95,50.8c3.4,2.2,5.1,4.7,5.8,8.6
+		c2.1,12.1,4.9,24.1,9.4,35.7c1.9,5,4.1,9.8,7.5,14c7.5,9.4,17.7,9.4,25.3,0C1948.9,1245.3,1950.9,1239.5,1953.8,1233.7z"/>
+	<path class="st1" d="M2043.6,585.1c0.9,7.5,1.7,14.1-0.8,20.4c-8,20.2-13.1,41.2-17.6,62.4c-0.9,4.4-2.6,8.3-5.2,11.7
+		c-17.8,23.8-38.4,45.2-60.6,64.9c-1.5,1.3-3.2,2.3-5.1,3.8c-2.9-5.3-5.1-10.4-8.2-14.9c-8-11.8-19.3-11.8-27.5-0.1
+		c-7.4,10.6-11.4,23-12.8,35.4c-1.7,14.6-9.4,22.2-21.3,29.3c-25.5,15.2-52.1,28.1-78.7,41.2c-2.4,1.2-5,2-7.3,3.1
+		c-2.7,1.3-4.3,0.7-5.2-2.2c-1-3.2-1.9-6.4-3.4-9.3c-4.2-7.7-10.8-7.7-15.1-0.1c-2.5,4.4-3.9,9.3-4.5,14.2c-0.8,7-4.2,10.7-11,13.3
+		c-27.5,10.2-55.4,18.9-83.9,25.7c-10,2.4-20.1,4.8-30,7.5c-3.8,1-5.4,0-6.1-3.9c-0.7-4-0.2-9.9-6.2-9.6c-5.1,0.2-5.3,6-5.4,9.5
+		c-0.1,7.5-4.3,9-10.5,10.2c-39.6,7.4-79.4,13.9-119.5,18.1c-2.8,0.3-6.7,2.3-8.1-1.3c-1.4-3.6-1.7-7.9-0.3-11.7
+		c0.9-2.4,3.9-2,6.2-2.4c13.8-2.4,27.6-4.4,41.3-7c42.1-8.2,83.5-19.3,124.2-33.1c57.6-19.6,112.2-45.7,163.9-77.3
+		c38.1-23.2,73.8-50.1,107.6-79.4c37.9-32.8,72.6-68.6,102.5-109C2037.5,591.3,2039.4,587.8,2043.6,585.1z"/>
+	<path class="st1" d="M777.2,1163.8c-0.9-7.9,1.2-15.4,2-23c4.4-45.1,6.3-90.3,6.6-135.6c0.1-8.6,0.2-8.7,8.8-8.7
+		c22-0.1,44-0.1,65.9,0c8.3,0,8.4,0.1,8.5,7.9c0.2,37.7,2,75.2,6.5,112.6c0.5,3.8,0.3,6-3.9,7.5c-31.7,11.3-62.2,25.3-92.6,39.6
+		C778.8,1164.3,778.4,1164.1,777.2,1163.8z"/>
+	<path class="st1" d="M776.8,817.8c3.1-0.6,4.7,0.6,6.5,1.4c28.2,13.5,56.6,26.5,86.2,36.8c5.4,1.9,6.7,4.3,6,10.1
+		c-4.5,36.7-6.3,73.6-6.4,110.6c0,8.1,0.7,8.3-8.1,8.3c-22.6-0.1-45.3,0-67.9-0.1c-7,0-7.1-0.2-7.2-7.3c-0.4-28.6-0.9-57.3-2.7-85.9
+		c-1.3-21.3-2.9-42.5-5.5-63.7C777.2,824.9,777.1,821.6,776.8,817.8z"/>
+	<path class="st1" d="M1896.4,1163.9c-3.3,0.5-5.7-1.5-8.4-2.8c-27.2-13.3-54.8-25.7-83.3-36.1c-7.4-2.7-7.2-2.9-6.3-10.6
+		c4.4-35.8,5.3-71.8,6.4-107.7c0.1-1.7,0.1-3.3,0-5c-0.3-3.8,1.3-5.4,5.2-5.3c6.3,0.2,12.7,0.1,19,0.1c16.7,0,33.3,0,50,0.1
+		c8.4,0,8.4,0.1,8.6,8.8c0.8,30.3,1.2,60.6,3.3,90.9c1.4,19.9,2.9,39.9,5.3,59.7C1896.5,1158.6,1897.4,1161.2,1896.4,1163.9z"/>
+	<path class="st1" d="M1896.8,817.7c-1.3,13.9-2.7,27.7-3.9,41.6c-3.5,38.5-4.5,77-5.2,115.6c0,1.7-0.2,3.3-0.1,5
+		c0.4,4-1.5,5.5-5.2,5.1c-1-0.1-2,0-3,0c-22.6,0-45.3-0.1-67.9,0.2c-5,0-6.8-1.2-6.8-6.6c-0.4-28.3-1.2-56.5-3.6-84.7
+		c-0.8-8.9-1.6-17.9-2.7-26.8c-0.9-7.6-1.1-7.8,6.5-10.6c23-8.7,45.8-17.8,67.9-28.7c6-2.9,12-5.7,18-8.6
+		C1892.5,818.3,1894.3,817.4,1896.8,817.7z"/>
+	<path class="st1" d="M908.3,1109.6c-1-4.4,0.4-8.6,0.8-12.8c2.5-30.9,4-61.8,4-92.9c0-7.4,0.2-7.5,7.9-7.5
+		c33.3-0.1,66.7-0.2,100-0.2c7.8,0,8.1,0.1,8,7.4c-0.3,22,1,44,2.3,65.9c0.3,4.5-1,6.5-5.5,7.4c-38.7,8.5-76.4,20.9-114.2,32.5
+		C910.7,1109.8,909.7,1109.6,908.3,1109.6z"/>
+	<path class="st1" d="M1765.3,1110.4c-9.6-3-18.1-5.6-26.6-8.4c-29.1-9.6-58.7-17.4-88.5-24.5c-8.9-2.1-8.1-1.4-7.6-10.4
+		c1.2-21,1.6-42,2.3-62.9c0.2-7.7,0.2-7.9,7.5-7.9c33.3,0,66.7,0.1,100,0.2c7.8,0,8.2,0.3,8.2,7.7c0.2,34,1.7,68,4.8,101.8
+		C1765.4,1106.9,1765.3,1107.9,1765.3,1110.4z"/>
+	<path class="st1" d="M908.8,872.2c2.8-1.1,5,0.8,7.5,1.5c36.1,10.3,71.6,22.9,108.5,30.5c5.5,1.1,6.7,3.6,6.4,8.8
+		c-1.3,21.9-2.6,43.9-2.1,65.9c0.1,4.7-1.2,6.5-6.1,6.4c-34.7-0.2-69.3-0.2-104-0.1c-4.1,0-6.1-1-6-5.6c0.4-35.6-2-71.2-4.8-106.7
+		C908.2,872.8,908.6,872.5,908.8,872.2z"/>
+	<path class="st1" d="M1765.6,872.4c-0.9,10.7-1.8,20.9-2.5,31.2c-1.7,24.6-2.4,49.2-2.6,73.8c-0.1,7.7-0.2,7.8-7.7,7.8
+		c-33.6,0.1-67.2,0.1-100.8,0.1c-6.9,0-6.9-0.2-7.1-7.1c-0.8-21.9-1.3-43.9-2.6-65.8c-0.3-5.4,1.8-7,6.2-8
+		c14.5-3.5,29-7.1,43.5-10.8c22.5-5.7,44.5-13.5,66.7-20.3C1760.5,872.7,1762.3,871.8,1765.6,872.4z"/>
+	<path class="st1" d="M725.8,1192.5c-5.9-34.3-8.8-67.4-11-100.6c-1.8-27.6-2.2-55.2-3-82.8c-0.1-2.3,0.1-4.7-0.1-7
+		c-0.4-4.4,1.6-5.8,5.9-5.7c9,0.2,18,0,27,0c6.7,0,13.3-0.1,20,0c7.2,0.1,7.4,0.2,7.3,7.1c-0.5,23.6-1,47.2-2,70.8
+		c-1.2,27.2-3.3,54.4-6.7,81.5c-0.2,1.3-0.3,2.6-0.4,4c-0.4,9.2-3.4,16-13,19.7C741.7,1182.7,734.5,1187.7,725.8,1192.5z"/>
+	<path class="st1" d="M1946.2,1191.7c-10.1-5.6-20.4-11.5-30.8-17.2c-3.3-1.8-3.1-5-3.5-7.8c-1.4-10.2-2.4-20.5-3.5-30.7
+		c-4.7-43.8-6-87.7-6.7-131.6c-0.1-7.7,0.1-7.8,7.7-7.8c15.3-0.1,30.6,0.1,46-0.1c4.6-0.1,6.5,1.1,6.4,6.1
+		c-0.5,34-1.2,67.9-3.7,101.8c-2,26.9-4.5,53.7-8.9,80.4C1948.7,1187,1949.1,1189.5,1946.2,1191.7z"/>
+	<path class="st1" d="M1947.7,789.1c5.8,32.7,8.6,63.8,10.8,95c2.1,30.6,2.8,61.2,3.1,91.9c0.1,9.6,0.3,8.9-8.3,8.9
+		c-15,0-30-0.1-45,0.2c-5.3,0.1-6.9-1.8-6.7-7c0.9-25.3,1.3-50.6,2.5-75.9c1.3-27.3,3.9-54.4,6.9-81.6c0.9-8.3,3.3-14.2,11.5-17.8
+		C1930.8,799.2,1938.6,794.1,1947.7,789.1z"/>
+	<path class="st1" d="M726,789.2c11.3,6.2,21.7,11.9,32.2,17.5c2.9,1.6,2.8,4.2,3.2,6.8c2.7,15.8,4.1,31.7,5.5,47.6
+		c3.3,37.2,4.5,74.5,5,111.8c0,2.3,0,4.7,0.1,7c0.1,3.1-0.8,5-4.4,5c-17-0.1-34-0.1-51-0.1c-3.3,0-4.8-1.5-4.7-4.8
+		c0.2-5.7,0-11.3,0.2-17c1-42.6,2.7-85.2,7.3-127.7C720.9,820.5,722.6,805.7,726,789.2z"/>
+	<path class="st1" d="M1625.1,910.5c-0.6,9.4-1.4,18-1.7,26.5c-0.4,13-0.4,26-0.6,38.9c-0.1,9.3-0.2,9.4-9.2,9.4
+		c-30.6,0.1-61.3,0.1-91.9,0.1c-8.3,0-16.7-0.1-25,0.1c-4.2,0.1-5.9-1.3-5.9-5.7c0-15-0.1-30-0.7-44.9c-0.2-4.8,2.5-5.5,6-6
+		c10.9-1.3,21.8-3.6,32.7-3.7c23.9-0.2,46.7-6.5,70-10C1607.1,913.9,1615.2,912.2,1625.1,910.5z"/>
+	<path class="st1" d="M1625.2,1071.1c-23.5-4.2-45.7-8.1-67.9-12.1c-7.9-1.4-15.8-2.4-23.8-2.5c-12.7-0.1-25.1-2.6-37.7-4
+		c-4-0.4-5.8-1.6-5.6-6.1c0.5-14.6,0.6-29.3,0.6-43.9c0-4.5,1-6.5,6.1-6.5c39.9,0.2,79.9,0.2,119.8,0.1c5,0,6.1,2.1,6.1,6.6
+		C1622.9,1025,1623,1047.3,1625.2,1071.1z"/>
+	<path class="st1" d="M1049.3,1070.4c-1-5.9-0.1-11.8,0.3-17.7c0.9-16.3,1.4-32.6,1.4-48.9c0-7.3,0.2-7.5,6.8-7.5
+		c39.3-0.1,78.5-0.1,117.8-0.1c7,0,7.1,0.2,7.2,7.2c0.2,14,0,27.9,0.5,41.9c0.2,5.2-1.5,6.6-6.6,7c-16.9,1.3-33.8,2.7-50.6,5.2
+		c-23.3,3.4-46.7,6.8-69.7,12.3C1054.2,1070.3,1051.9,1071.4,1049.3,1070.4z"/>
+	<path class="st1" d="M1049.8,910.2c22.1,5.7,44.8,8.7,67.4,12.5c16.4,2.8,33.1,3.3,49.6,5.2c16.4,1.9,16.4,1.5,16.3,17.4
+		c-0.1,11-0.3,22-0.2,32.9c0.1,4.9-1,7.2-6.6,7.2c-39.9-0.2-79.9-0.2-119.8-0.1c-3.4,0-5.7-0.6-5.6-4.8c0.6-22.6-1.3-45.2-1.9-67.8
+		C1049,912,1049.4,911.4,1049.8,910.2z"/>
+	<path class="st1" d="M1260.5,985.4c-21.6,0-43.2,0-64.9,0c-8,0-8.2-0.1-8.1-8.4c0.2-13.6,0.6-27.3,0.8-40.9c0.1-4.2,1.4-5.6,6-5.1
+		c41.7,4.1,83.5,6.2,125.5,6.2c2.3,0,4.7,0,7,0c7.5,0.2,7.5,0.2,7.6,7.9c0.1,10.3,0.1,20.6,0.1,30.9c0,9.3,0,9.4-9.1,9.4
+		C1303.8,985.4,1282.2,985.4,1260.5,985.4z"/>
+	<path class="st1" d="M1485,931.5c0.3,16.2,0.5,32.7,0.8,49.3c0.1,3.4-1.7,4.8-4.9,4.6c-2-0.1-4,0-6,0c-41.6,0-83.2,0-124.9,0
+		c-2,0-4-0.1-6,0c-4,0.3-5.1-1.8-5-5.5c0.1-11.7,0-23.3,0.1-35c0.1-7.6,0.1-7.8,7.6-7.8c17.3,0.2,34.6-0.6,51.9-1.1
+		c26.3-0.7,52.5-3.1,78.7-5.1C1479.6,930.9,1481.8,930,1485,931.5z"/>
+	<path class="st1" d="M1485,1051.1c-35.4-3-69.9-5.3-104.5-6.4c-11.6-0.4-23.3-0.5-34.9-0.4c-4.4,0-6.7-0.8-6.5-6
+		c0.4-12,0.3-24,0-36c-0.1-4.8,1.6-6.3,6.3-6.2c45,0.1,89.9,0.1,134.9,0c3.5,0,5.8,0.7,5.7,4.8
+		C1485.5,1017.5,1485.3,1034.1,1485,1051.1z"/>
+	<path class="st1" d="M1188.4,1050.6c-0.3-17.2-0.5-33.7-0.8-50.3c0-2.9,1.6-4.1,4.4-4.1c1.7,0,3.3,0,5,0c42.6,0,85.1,0,127.7,0
+		c1.7,0,3.3,0.1,5,0c3.3-0.2,4.9,1.2,4.9,4.6c-0.1,13-0.1,25.9,0,38.9c0,3.6-1.7,4.7-4.9,4.5c-0.7,0-1.3,0-2,0
+		C1281.6,1043.7,1235.9,1047.2,1188.4,1050.6z"/>
+	<path class="st1" d="M2010.7,1230.1c-5.1-1.9-9-5.1-13.1-7.7c-9.9-6.1-19.6-12.6-29.8-18.3c-4.8-2.6-5.5-5.6-4.5-10.4
+		c3.9-20,6.2-40.1,8.2-60.4c4-41.2,5.8-82.4,6.1-123.8c0-3,0.1-6,0-9c-0.1-3,1.1-3.8,4.1-4.1c16.5-1.5,16.7-1.4,16.8,14.7
+		c0.4,66.4,3.9,132.5,10.7,198.6C2009.9,1216.3,2011.6,1222.7,2010.7,1230.1z"/>
+	<path class="st1" d="M2011.2,752.5c-1.6,16.9-3.2,33.8-4.8,50.6c-3,30.8-4.6,61.7-6.1,92.6c-1.3,27.3-1.5,54.5-1.8,81.8
+		c-0.1,7.1-0.2,7.3-7.1,7.3c-16.3,0-13.6,1.3-13.7-12.8c-0.5-54.3-3.2-108.4-10.6-162.2c-1.1-7.9-2.5-15.8-3.9-23.6
+		c-0.7-3.6-0.1-6,3.5-8.2c13.4-8,26.6-16.4,39.8-24.7C2007.6,752.8,2008.5,751.7,2011.2,752.5z"/>
+	<path class="st1" d="M662.1,1231.5c1.9-20.4,3.7-38.6,5.4-56.8c3-31.9,4.7-63.8,6-95.8c1-24.6,1.6-49.3,1.6-74
+		c0-8.3,0.1-8.3,7.9-8.4c1.3,0,2.7,0,4,0c8.6,0.1,8.7,0.1,8.8,8.7c0.4,40,1.8,80,5.4,119.8c2,22.9,4.4,45.8,9,68.3
+		c1.1,5.5,0.2,8.5-5.1,11c-12.7,6-23.9,14.5-35.5,22.2C667.7,1227.9,665.8,1229.1,662.1,1231.5z"/>
+	<path class="st1" d="M662.9,752.1c2.6-0.9,3.9,1,5.4,2.1c12.4,8.4,24.6,17.1,38,23.9c3.3,1.7,5,3.6,4.2,7.7
+		c-11.3,61.8-13.7,124.4-14.8,187c-0.2,13.5,2.2,12.1-12.3,12.1c-8.4,0-8.5-0.1-8.5-8.9c0.1-52.7-2.6-105.3-6.4-157.8
+		c-1.5-20.6-4-41.1-6-61.7C662.5,755.1,661.9,753.4,662.9,752.1z"/>
+	<path class="st1" d="M2044.3,728.6c0,3.4,0,6.3,0,9.2c0,78.9,0,157.9,0,236.8c0,1.7-0.1,3.3,0,5c0.4,3.9-1.3,5.4-5.2,5.3
+		c-5.9-0.2-11.9,0-18.3,0c0-26.3,0.3-51.6,1.3-76.8c1.7-42.3,4.4-84.5,8.9-126.5c1.6-14.9,3.9-29.7,5.6-44.6
+		C2037.2,732.4,2038.9,729.7,2044.3,728.6z"/>
+	<path class="st1" d="M2044.3,1253c-5.6-1.2-7-4.1-7.7-8.6c-3.1-19.4-5.2-38.9-7-58.5c-5.6-59-8.7-118.2-8.7-177.6
+		c0-13.6-1.4-11.7,11.5-11.8c13.3,0,11.9-1.5,11.9,11.5c0,78.6,0,157.2,0,235.8C2044.3,1246.6,2044.3,1249.3,2044.3,1253z"/>
+	<path class="st1" d="M629.2,728.7c5.8,1.6,7.4,4.6,7.9,9c2.3,21.2,5.3,42.2,7.3,63.4c5.3,55.3,7.7,110.8,8.5,166.4
+		c0,3.3,0.1,6.7,0,10c-0.1,7.5-0.1,7.5-7.7,7.7c-16,0.5-16,0.5-16-15.3c0-76.5,0-153.1,0-229.6C629.2,736.7,629.2,733,629.2,728.7z"
+		/>
+	<path class="st1" d="M629.2,1253.2c0-6,0-10.6,0-15.3c0-75.7,0-151.3,0-227c0-2,0-4,0-6c-0.1-9.2-0.3-8.7,8.7-8.6
+		c15.1,0,15.2,0,15,15.6c-0.7,62.7-3.8,125.2-10.3,187.6c-1.5,14.9-3.9,29.7-5.5,44.6C636.6,1248.7,634.5,1251.1,629.2,1253.2z"/>
+	<path class="st1" d="M2060,697.5c0-15.9,0-29.5,0-43c0-3.7,0.3-7.3-0.1-11c-2-19,6.4-34.8,15.3-50.5c1-1.7,2.3-3.2,3.6-4.7
+		c5.4-6.2,8.1-6.2,13.4,0.4c6.3,7.8,10.3,17.1,13.7,26.4c3.2,8.7,5.9,17.6,8.7,26.5c1.3,4,1,7.1-2.4,10.7
+		C2096.7,668.2,2079,681.6,2060,697.5z"/>
+	<path class="st1" d="M613.2,1283.1c0,24.5,1.5,47.6-0.5,70.3c-1.4,15.4-9,29.8-19.7,41.7c-3.8,4.2-5.7,3.9-10-0.4
+		c-4.3-4.3-7.2-9.6-9.8-15c-6.7-13.8-11.2-28.4-15.3-43.2c-0.8-3-1.3-5.6,1.5-8.1C576.3,1313,592.4,1296.7,613.2,1283.1z"/>
+	<path class="st1" d="M2060,1284.4c19.3,15.5,36.8,29.3,52.5,45.2c2.6,2.6,3.7,5.1,2.6,8.8c-5.1,17.2-10,34.5-19.7,50
+		c-7.7,12.2-12.4,12.7-19.8,0.6c-9.5-15.4-16.9-31.4-15.8-50.5C2060.7,1321.2,2060,1303.9,2060,1284.4z"/>
+	<path class="st1" d="M611.9,698.2c-8.5-6.7-17.1-12.8-25-19.7c-9.1-7.8-17.5-16.4-26.3-24.5c-2.3-2.2-4-4.1-3-7.7
+		c5.3-18.2,10.3-36.5,20.4-52.8c7.8-12.7,12.8-13,20.4-0.3c8.9,14.9,16.3,30.2,15.1,48.6c-1,15.9-0.2,31.9-0.3,47.9
+		C613.2,692.2,614,694.9,611.9,698.2z"/>
+	<path class="st1" d="M1788.2,864c4.1,27,4.9,53.5,6.1,80.1c0.5,11.3,0.2,22.6,0.7,33.9c0.2,5.2-1.6,7.4-6.7,7.3
+		c-4.7-0.1-9.3-0.3-14,0c-4.6,0.3-5.5-2-5.4-6c0.2-26.3,1.3-52.5,3.2-78.8c0.5-7.6,1.2-15.2,2.1-22.8
+		C1775.6,867.2,1775.7,867.2,1788.2,864z"/>
+	<path class="st1" d="M885.3,1118.4c-5.1-39.1-6.6-77.6-6.6-116.3c0-4.2,1.3-5.9,5.7-5.8c25,0.7,20.1-4.1,19.8,19.4
+		c-0.4,29.6-1.5,59.3-5,88.8C897.9,1115.4,898.1,1115.4,885.3,1118.4z"/>
+	<path class="st1" d="M885.7,863.5c12.4,2.1,12.2,2.1,13.5,13.8c3.8,33,4.6,66.2,5.3,99.4c0.2,8.3,0,8.5-7.9,8.4
+		c-5.6-0.1-12.6,2.4-16.3-1.2c-3.8-3.6-1.3-10.7-1.3-16.2c0.1-33.9,1.8-67.7,6.1-101.4C885.1,865.4,885.4,864.5,885.7,863.5z"/>
+	<path class="st1" d="M1788.4,1117.5c-4,0.3-6.2-1.5-8.7-2.2c-3.2-0.9-4.6-2.9-4.9-6.5c-0.7-10.3-2.2-20.5-2.9-30.8
+		c-1.5-24.6-2.8-49.2-2.8-73.9c0-7.5,0.1-7.8,7.7-7.6c5.9,0.2,13.3-2.7,17.2,1.6c3.4,3.7,1,10.9,0.9,16.5
+		C1794.3,1048.8,1792.8,1083.1,1788.4,1117.5z"/>
+	<path class="st1" d="M1481.1,1078.1c-10.7,0.3-20.5-1.5-30.3-2.6c-34.1-3.7-68.2-5.9-102.5-5.6c-1.3,0-2.7-0.1-4,0
+		c-4.9,0.5-5.1-2.5-5.2-6.2c-0.1-4,0.7-6,5.4-6c20,0.1,39.9-0.2,59.9,1c22.9,1.4,45.8,3,68.7,4.7c7.9,0.6,7.8,0.9,8.2,8.7
+		C1481.2,1073.7,1481.1,1075.4,1481.1,1078.1z"/>
+	<path class="st1" d="M1480,903c2,3.3,0.7,6.3,1,9.2c0.4,4.3-1.6,5.6-5.8,5.9c-42.2,3.3-84.3,6.2-126.7,5.9c-1.3,0-2.7-0.1-4,0
+		c-4.5,0.5-5.5-1.7-5.6-5.8c-0.1-4.5,0.9-6.6,6-6.5c29.7,0.7,59.2-1.5,88.8-3.9C1449.3,906.5,1464.7,904.6,1480,903z"/>
+	<path class="st1" d="M1192.2,1078.2c1-14.7,0.9-15,13.5-15.8c40.5-2.9,80.9-5.4,121.6-4.6c7.3,0.1,7.4,0.5,7.3,7
+		c-0.1,4-1.7,5.2-5.4,5.1c-6-0.2-12-0.1-18,0c-37.3,0.2-74.3,3.2-111.3,7.8C1197.6,1078,1195.3,1078,1192.2,1078.2z"/>
+	<path class="st1" d="M1192.6,903.2c17.2,2.2,33.7,3.8,50.2,5c28.2,2.1,56.4,4.4,84.7,3.6c3.8-0.1,7.3-0.4,7.1,5.4
+		c-0.3,6.3-0.2,6.8-6.6,6.8c-18.6,0-37.2,0.4-55.9-0.8c-19.2-1.2-38.5-2.1-57.8-3.2c-3-0.2-6-0.4-8.9-0.8
+		C1192.8,917.6,1192.8,917.6,1192.6,903.2z"/>
+	<path class="st1" d="M653.6,694.6c2.5,2.7,3.4,3.5,4.2,4.6c15.1,20.9,32.8,39.4,51.8,56.7c2.5,2.3,7.7,4.8,5,8.5
+		c-2.7,3.9-6.2-1-8.9-2.4c-14.7-7.8-28.1-17.9-42.2-26.6c-3.1-1.9-4.3-4.4-4.8-8C657.4,717,655.5,706.9,653.6,694.6z"/>
+	<path class="st1" d="M654,1284.6c0.9-5.5,2.7-11,2.6-16.4c-0.1-14.4,6.3-23.8,19.2-30.2c10.6-5.3,20.3-12.5,30.5-18.8
+		c2.5-1.5,4.9-3.3,7.8-3.6c1.6,2.1,1.5,4,0.2,5.7c-1,1.3-2.4,2.3-3.6,3.4c-18.4,17.3-36.5,34.8-51.2,55.5c-1.1,1.6-2.6,2.9-4,4.3
+		C655.3,1284.8,654.8,1284.6,654,1284.6z"/>
+	<path class="st1" d="M2019.1,698.8c-1.4,9.8-3,19.6-4.2,29.5c-0.4,3-2.2,4.7-4.4,6.2c-15.3,9.9-30.7,19.7-46.1,29.5
+		c-1.5,1-3.7,4-5.7,0.4c-1.5-2.6,0.2-4.4,2.1-5.9c11.9-9.2,21.5-20.7,32.4-30.8c8.4-7.7,14.5-17.2,21.4-26.1c0.9-1.2,2-2.4,3-3.6
+		C2018.1,698.2,2018.6,698.5,2019.1,698.8z"/>
+	<path class="st1" d="M2017.1,1283.9c-11.8-19.6-28.7-34.6-44.6-50.5c-3.7-3.7-7.8-7.2-11.8-10.6c-1.9-1.7-3.4-3.4-1.7-5.9
+		c1.7-2.4,3.5-0.5,5,0.5c15.7,10,31.3,20,46.9,30c2,1.3,3.5,2.9,3.9,5.4c1.4,10.1,2.9,20.2,4.4,30.4
+		C2018.5,1283.4,2017.8,1283.7,2017.1,1283.9z"/>
+	<path class="st1" d="M1044.6,1034c-0.6,11-1.1,21.9-1.7,32.9c-0.1,1.6-0.3,3.3-0.8,4.9c-0.3,0.8-1.4,1.6-2.2,1.7
+		c-0.9,0.1-1.9-0.5-2.1-1.7c-0.1-1-0.3-2-0.4-3c-1.2-22.2-2.3-44.5-2.4-66.8c0-3.2,0-6,4.6-5.9c3.5,0.1,5.6,0.7,5.5,4.9
+		c-0.2,11-0.1,21.9-0.1,32.9C1044.9,1034,1044.8,1034,1044.6,1034z"/>
+	<path class="st1" d="M1636.4,1033.8c0,10.6,0,21.2,0,31.8c0,2-0.3,4-0.7,5.9c-0.2,0.8-1.2,1.8-1.9,1.8c-0.8,0-1.9-0.8-2.2-1.5
+		c-0.5-1.2-0.5-2.6-0.6-3.9c-1.9-21.8-2.2-43.7-2.1-65.6c0-5.7,1.3-6.7,6-6.1c3.9,0.5,3.6,3.1,3.6,5.8c0,10.6,0,21.2,0,31.8
+		C1637.8,1033.8,1637.1,1033.8,1636.4,1033.8z"/>
+	<path class="st1" d="M1638.5,948.1c0,10.3,0,20.6,0,31c0,2.6,0.5,5.4-3.3,6.2c-4.4,0.9-6.4-0.5-6.4-5.8c0-19,0-38,1.4-56.9
+		c0.2-3,0.4-6,0.7-9c0.2-2.2-0.3-5.4,3-5.2c2.5,0.1,2.2,3,2.3,4.9c0.6,11.6,1.1,23.3,1.6,34.9C1638,948.1,1638.2,948.1,1638.5,948.1
+		z"/>
+	<path class="st1" d="M1045.1,948c0,10.6-0.1,21.2,0,31.9c0,3.6-0.9,5.5-5,5.5c-3.9-0.1-5.1-1.7-5.1-5.4c0.1-22.6,1.2-45.1,2.5-67.7
+		c0.1-1.6-0.1-3.7,2-4c2.8-0.4,3.1,1.9,3.2,3.9c0.7,11.9,1.3,23.9,1.9,35.8C1044.8,948,1044.9,948,1045.1,948z"/>
+	<path class="st1" d="M741.9,740.1c7,10.8,9.7,22,12.6,34.5c-8.1-3.6-13.5-8.9-19.7-13c-2-1.3-2-3.3-1.2-5.3
+		C735.6,751.1,737,745.6,741.9,740.1z"/>
+	<path class="st1" d="M1931.7,1241.3c-6.9-10.6-9.7-21.7-12.1-33.3c4.2,0.4,6.4,3.1,9.1,4.9
+		C1943.2,1223.1,1943.4,1224.7,1931.7,1241.3z"/>
+	<path class="st1" d="M1931.6,740c12,17.2,11.9,18.3-3.6,29.1c-2.4,1.7-4.5,3.9-8.5,4.8C1921.8,761.9,1925,750.9,1931.6,740z"/>
+	<path class="st1" d="M742.1,1241.3c-5.3-5.2-6.5-11.1-8.6-16.5c-0.8-2-0.5-3.8,1.6-5.1c6-3.9,11.2-9.1,19.2-12.6
+		C751.8,1219.5,748.7,1230.3,742.1,1241.3z"/>
+	<path class="st1" d="M599.6,517.5c0.6,0.1,1.4,0.1,1.9,0.4c12.6,7.1,13,7.9,10.7,24.4c-5.9-7.9-11-15.2-13.4-24.1
+		C599,518,599.3,517.7,599.6,517.5z"/>
+	<path class="st1" d="M597.6,1464.4c4-9.4,8.1-17.2,14-24.4C614.9,1455.5,614.5,1457.9,597.6,1464.4z"/>
+	<path class="st1" d="M2072.4,516.4c2.2,0.6,2.3,2,1.3,3.7c-3.8,6.1-7.7,12.1-11.9,18.6c-2.8-10.6-2.1-12.7,5.3-17.8
+		c1.9-1.3,4.2-2,5.3-4.3L2072.4,516.4z"/>
+	<path class="st1" d="M2061.5,1442.5c4.7,8.5,10.5,14.5,12.5,22.8C2067.2,1459.8,2056.4,1456.8,2061.5,1442.5z"/>
+	<path class="st1" d="M1781.6,836.9c4.2,9.3,4.2,9.3-1.8,12.6C1777.9,845.4,1780.6,842.1,1781.6,836.9z"/>
+	<path class="st1" d="M895.4,849.3c-7.5-2.9-7.5-2.9-3.8-11.1C893.8,841.3,893.9,844.7,895.4,849.3z"/>
+	<path class="st1" d="M630.1,1284.6c-0.2-5.4-2.7-11,1.8-17C634.2,1274.4,629.7,1279.3,630.1,1284.6z"/>
+	<path class="st1" d="M629.9,697.1c0.5,5.4,3.9,10.3,2.4,16.6C626.9,708.5,630.1,702.5,629.9,697.1z"/>
+	<path class="st1" d="M2044.5,1284.5c-2.2-5-4.3-9.2-2.8-15C2046.1,1274.3,2043.5,1279.4,2044.5,1284.5z"/>
+	<path class="st1" d="M2041.9,712.1c-2.2-6,1.1-10.1,2.2-14.6C2043.5,702.2,2046,707.4,2041.9,712.1z"/>
+	<path class="st1" d="M892.2,1143.9c-4.6-7.9-4.6-7.9,1.6-11.5C895.7,1136.5,892.6,1139.7,892.2,1143.9z"/>
+	<path class="st1" d="M1779.6,1132.2c6.1,3.1,6.1,3.1,2.7,11.1c-1.9-1-1.7-3.1-2.3-4.6C1779.2,1137,1778.6,1135.1,1779.6,1132.2z"/>
+	<path class="st1" d="M1934.8,1202.5c4.1-0.6,6.5,2.5,11.4,4.9c-6.3,0.5-8.2-3.5-11.3-5.1L1934.8,1202.5z"/>
+	<path class="st1" d="M1935.8,777c3.1,0.9,4.5-3.5,7.8-2.9c-1.8,4-4.7,3.9-7.9,2.8L1935.8,777z"/>
+	<path class="st1" d="M729.5,774c2.7-0.5,4.4,0.6,5.8,3.2C732.1,778,731,775.7,729.5,774z"/>
+	<path class="st1" d="M734,1202.5c2.3,4.6-1.2,4.8-4.2,5.9c-0.6-3.7,3.7-3.3,4.2-5.7C734,1202.7,734,1202.5,734,1202.5z"/>
+	<path class="st1" d="M1935.2,780.3c-0.4,0.2-0.8,0.5-1.2,0.7c0.3,0,0.6,0.1,0.8,0c0.2-0.1,0.4-0.3,0.6-0.5
+		C1935.5,780.5,1935.2,780.3,1935.2,780.3z"/>
+	<path class="st1" d="M740,1203.1c-1.9-0.8-4.2,2.9-6-0.5c0,0,0,0.2,0,0.1C736,1202.8,738,1202.9,740,1203.1L740,1203.1z"/>
+	<path class="st1" d="M1935.7,777c1.4,1.3,0.9,2.4-0.5,3.3c0,0,0.3,0.3,0.3,0.3c0.1-1.2,0.3-2.3,0.4-3.5
+		C1935.8,777,1935.7,777,1935.7,777z"/>
+	<path class="st1" d="M737.9,778.4c0.2,0.2,0.4,0.5,0.6,0.7c-0.2,0.2-0.5,0.5-0.7,0.5c-0.2,0-0.4-0.4-0.6-0.6
+		C737.4,778.8,737.7,778.6,737.9,778.4z"/>
+	<path class="st1" d="M740,1203.1c0-0.3,0-0.8-0.2-1c-0.8-0.8-0.7-1.1,0.4-0.8C739.5,1201.9,739.4,1202.4,740,1203.1
+		C740,1203.1,740,1203.1,740,1203.1z"/>
+	<path class="st1" d="M1934.9,1202.3c0-0.2-0.1-0.3-0.1-0.5c0,0-0.1,0.1-0.1,0.1c0.1,0.2,0.1,0.4,0.2,0.6
+		C1934.8,1202.5,1934.9,1202.3,1934.9,1202.3z"/>
+	<path class="st1" d="M2072.4,516.6c0.7,0.4,1.4,0.8,2.1,1.2c-0.2,0.2-0.4,0.7-0.6,0.7c-1.1-0.2-1.5-1-1.4-2
+		C2072.4,516.4,2072.4,516.6,2072.4,516.6z"/>
+	<path class="st1" d="M598.7,518.3c-1-0.2-1.8-0.8-1-1.6c0.8-0.9,1.4,0,1.8,0.8C599.3,517.7,599,518,598.7,518.3z"/>
+</g>
+</svg>

docs/_static/tractor_logo_wire.svg

@@ -0,0 +1,455 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 24.2.1, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 2670 1980" style="enable-background:new 0 0 2670 1980;" xml:space="preserve">
+
+<g>
+	<path fill="#808080" d="M2275.3,1000.1c-0.1,2.3,0,4.7,0,7c0,189.3,0,378.7,0,568c0,6,0.1,12.1-0.8,17.9c-2.4,15.2-12.9,17.4-23.6,10
+		c-45.4-31-91.2-61.4-136.9-91.9l-30.1-20.3c-9.8-6.3-19.2-13.2-29.2-19.3c-6.7-4.1-9.8-9.7-9.9-17.2c-0.1-9.3-0.6-18.7-0.3-28
+		c0.2-7.3-1.7-13-6.5-19c-18.6-23.3-36.2-47.3-56.9-69c-18-18.8-36.7-36.8-56.4-53.8c-31.8-27.5-65.4-52.7-101-74.9
+		c-32.7-20.4-66.8-38.4-102.2-54c-50.7-22.4-103.2-39.2-157.1-51.5c-36.7-8.4-73.8-14.4-111.2-18.5c-34.5-3.8-69-6.5-103.7-5.8
+		c-23.1,0.5-46.2-1.3-69.3,0.4c-22.9,1.8-45.9,3-68.7,5.6c-72.7,8.4-143.7,24.6-212.1,50.6c-65.5,24.8-127.4,57-184.9,97.4
+		c-46.8,32.8-90.1,69.8-129.5,111.1c-18.1,19-35.1,39.2-50.5,60.6c-3.9,5.5-5.5,11-5.3,17.6c0.4,9.3,0,18.7,0,28
+		c0,9.3-3.1,16.4-11.8,21.4c-10.4,5.9-19.9,13.4-30.1,19.8l-25.4,17.2c-11.6,7.8-23.3,15.5-34.9,23.3c-34.3,23-68.6,46-102.9,69
+		c-14.6,9.7-23.6,5.5-25.2-12.1c-0.5-5.3-0.5-10.7-0.5-16c0-189.7,0-379.3,0-569l-0.1-26.1c0.2-190.3,0.1-380.7,0.2-571
+		c0-5.7,0.4-11.3,0.5-17c0.1-3.7,1.2-7.3,3-10.5c3.4-5.9,9.3-7.7,15.4-4.8c2.7,1.3,5.1,3.1,7.6,4.8c44.3,29.6,88.5,59.3,132.8,88.9
+		l29.7,20.1c10.8,6.6,20.9,14.3,31.7,20.9c6.7,4.1,9.7,9.8,9.8,17.3c0.2,11,0.4,22,0.2,33c-0.1,5.2,1.2,9.6,4.2,13.9
+		c15.4,22.2,33,42.8,51.6,62.2c53.9,56.4,114.1,105.1,181.4,144.6c38.4,22.6,78.3,42.4,119.9,58.6c40,15.6,80.9,28.3,122.8,38
+		c52.7,12.1,106,19.3,160,22.6c18.3,1.1,36.6,2.1,54.9,1.5c17.7-0.6,35.5,1.1,53.2-0.1c17.6-1.1,35.2-2.3,52.8-3.6
+		c35.9-2.5,71.4-8.5,106.7-15.1c53.4-9.9,105.5-25,156-45.1c53.8-21.5,105.1-48.2,153.2-80.9c43.4-29.5,83.6-62.7,121.1-99.3
+		c27.3-26.6,50.3-56.8,73.9-86.6c2.9-3.6,3.6-7.6,3.6-12.1c-0.1-10.7,0.2-21.3,0.4-32c0.1-7.5,3.2-13.1,9.9-17.2
+		c10.2-6.2,19.9-13.4,30-19.8l23.2-16.3c4.2-1.3,7.4-4.3,11-6.7c42.9-28.7,85.8-57.4,128.7-86.1c1.1-0.7,2.3-1.4,3.3-2.3
+		c10.9-9.1,21.4-4.7,23.8,10.7c0.8,5.6,0.6,11.3,0.6,17c0,189.3,0,378.7,0,568L2275.3,1000.1z M740,1203.1c-2-0.2-4-0.3-6-0.5
+		c-0.5,2.5-4.8,2-4.2,5.8c2.9-1,6.4-1.2,4.2-5.8C735.8,1206,738.1,1202.3,740,1203.1c-0.6-0.7-0.5-1.3,0.2-1.7
+		c-1.1-0.3-1.1-0.1-0.4,0.8C740,1202.3,739.9,1202.8,740,1203.1z M1935.5,780.5c-0.2,0.2-0.4,0.4-0.6,0.4c-0.3,0.1-0.6,0-0.8,0
+		c0.4-0.2,0.8-0.5,1.1-0.8c1.4-0.9,2-1.9,0.5-3.3c3.2,1.1,6.1,1.2,7.9-2.8c-3.3-0.7-4.6,3.8-7.7,2.9
+		C1935.7,778.2,1935.6,779.4,1935.5,780.5z M1934.8,1202.5c-0.1-0.2-0.1-0.4-0.2-0.6c0,0,0.1-0.1,0.1-0.1c0,0.2,0.1,0.3,0.1,0.5
+		c3.1,1.6,5,5.7,11.3,5.1C1941.3,1205,1938.9,1202,1934.8,1202.5z M2072.4,516.6c-1,2.3-3.4,3-5.3,4.3c-7.4,5.1-8.2,7.2-5.3,17.8
+		c4.2-6.5,8-12.6,11.9-18.6c1.1-1.7,0.9-3.1-1.3-3.6c0,1,0.3,1.8,1.4,2c0.2,0,0.4-0.4,0.6-0.7C2073.8,517.4,2073.1,517,2072.4,516.6
+		z M599.6,517.5c-0.4-0.8-1.1-1.7-1.8-0.8c-0.8,0.8,0.1,1.5,1,1.6c2.4,8.9,7.5,16.2,13.4,24.1c2.3-16.5,1.9-17.3-10.7-24.4
+		C600.9,517.6,600.2,517.6,599.6,517.5z M534.9,1353.5c-20,21.8-37.3,44.1-53.4,67.4c-16.1,23.4-26.8,49.5-41.8,73.5
+		c9-21,17.4-42.2,28.9-61.9c16.9-28.7,35.4-56.4,57.5-81.5c0.9-1,1.6-2.1,2.6-3.1c2.9-2.9,3.3-6,2.3-10
+		c-9.1-33.8-14.6-68.3-19.2-103c-5-38-8.3-76.1-10.6-114.3c-2.5-39.9-3.4-79.9-3.9-119.8c-0.1-5.1-1.4-6.8-6.7-6.9
+		c-21.6-0.2-43.3-0.8-64.9-1.3c-2,0-4-0.4-6,0.8c0,195.2,0,390.5,0,585.6c2.1,0.6,3.1-0.4,4.1-1.1c52.7-33.8,105.3-67.7,158-101.4
+		c3.6-2.3,5.7-5.4,7.3-9.1c6-13,12.5-25.8,20.8-37.4c4.2-5.9,3.9-11.9,2.5-19.1c-2.4,1.8-4,2.9-5.5,4.2
+		c-13.9,12.6-32.1,8.7-42.7-2.9c-7.3-8-12.4-17.2-17.1-26.8C542.3,1375.7,539.4,1365.1,534.9,1353.5z M534.6,627.2
+		c3.6-5,4.3-10.7,6.3-15.9c6.2-15.8,12.6-31.5,25.2-43.7c10.8-10.5,26.8-12.6,38.9-2.8c2.3,1.9,4.3,5,7.9,5
+		c1.6-8.3-0.2-15.3-5.1-21.9c-7.4-9.9-12.7-21-17.8-32.3c-2.4-5.3-5.8-9.2-10.8-12.4c-50.5-32.2-100.9-64.7-151.3-97.1
+		c-2.4-1.5-4.5-3.9-8.7-3.9c0,3.7,0,7.2,0,10.7c0,187.9,0,375.8,0,563.7c0,2,0.2,4,0,6c-0.6,4.9,1.4,6.3,6.2,6.1
+		c13.6-0.6,27.3-0.7,41-1c8.3-0.2,16.7-0.6,25-0.4c4.9,0.1,6.7-1.8,6.1-6.4c-0.1-1,0-2,0-3c1.2-75,4.3-149.8,13.7-224.3
+		c4.6-36.3,10-72.5,19.6-107.9c1.6-5.7,0.4-9.9-3.4-14.4c-10.7-12.8-21.7-25.4-31-39.1c-19-28.1-36.8-57-49.6-88.7
+		c-2.2-5.4-5.5-10.4-6.2-16.6C465,538.3,494.6,586,534.6,627.2z M2060.9,1411.1c-2.3,8.5-0.1,15.1,4,21.4
+		c5.9,9.3,13.4,18.1,17.1,28.2c3.9,10.7,10.9,16.6,19.9,22.4c47.8,30.3,95.3,61.1,143,91.7c2.7,1.7,5,4.3,9.5,4.5c0-3.4,0-6.6,0-9.8
+		c0-188.3,0-376.6,0-565c0-2-0.1-4,0-6c0.2-3.4-1.1-5-4.6-4.8c-2.3,0.1-4.7,0-7,0.1c-20,0.6-40,1.2-60,1.9c-6.7,0.2-6.7,0.4-7,7.4
+		c0,1.3,0,2.7-0.1,4c-0.4,60-3,119.9-8.9,179.7c-5,50.1-11.3,99.9-24,148.7c-1.4,5.2,0.1,8.3,3.5,12.3c15,17.8,29.6,36.1,42.4,55.5
+		c20,30.4,36.1,62.9,49.3,96.8c3.2,8.2,5.7,16.6,6.8,25.4c-33.9-90.8-82.6-145-107.2-169.7c-4.1,11-7.5,22.1-12.7,32.5
+		c-4.9,9.9-10.3,19.5-18.8,26.8c-7.1,6.1-15.1,8.9-24.8,7.5C2073.2,1421.4,2068.3,1415.5,2060.9,1411.1z M2244.8,454.3
+		c0.6,4.5-0.2,6.7-0.8,8.9c-6.5,24.2-17,47-28.2,69.2c-18.9,37.2-43,71.2-70.4,102.8c-2.7,3.2-3.6,5.8-2.5,9.8
+		c7.9,29.6,13.1,59.8,17.3,90.2c6.4,45.6,10.2,91.3,12.8,137.3c2,35.3,2.6,70.6,3.1,105.9c0.1,7.6,0.2,7.6,7.6,7.8
+		c17,0.5,34,1,51,1.4c5,0.1,10,0.2,15,0.5c3.2,0.1,5.1-0.9,4.9-4.5c-0.1-1.7,0-3.3,0-5c0-189.6,0-379.3-0.1-568.9
+		c0-2.4,1.1-5.2-1.2-7.3c-0.8,0.1-1.6,0-2.1,0.4c-52.7,33.8-105.3,67.7-158,101.5c-2,1.3-3.7,2.6-4.7,4.9c-6.9,16-16.9,30.1-25.8,45
+		c-3.1,5.2-3.4,10.2-2,15.7c2.6,0.1,3.5-1.6,4.6-2.6c15.7-13.9,33-10.6,45.6,3.8c6,6.8,10.4,14.6,14.4,22.7
+		c5.1,10.3,8.3,21.3,12.8,32.9C2185.2,576.1,2221.7,520.5,2244.8,454.3z M553.7,662.8c-0.3,1.3-0.7,2.8-1,4.3
+		c-7.1,31.2-11.7,62.8-15.4,94.5c-7.1,59.9-10.3,120.1-11.8,180.4c-0.3,13-0.2,26-0.5,39c-0.1,4.4,1.5,5.7,5.7,5.6
+		c25-0.5,50-0.7,74.9-1.1c7.4-0.1,7.6-0.2,7.6-7.8c0-85.6,0-171.2,0.1-256.8c0-5.3-1.7-8.5-5.8-11.7c-16.6-12.8-32.4-26.6-46.9-41.9
+		C559,665.6,557.6,663,553.7,662.8z M553.6,1319.7c2.1-1,2.8-1.2,3.2-1.6c16.4-17.1,34-32.9,52.7-47.4c3-2.4,3.8-5,3.8-8.6
+		c-0.1-13.3-0.1-26.7-0.1-40c0-72.3,0-144.7,0-217c0-10.3,0.4-9-9.2-9.2c-23.3-0.4-46.7-0.8-70-1.1c-2.8,0-5.9-1-9.3,1.5
+		C526.2,1104.4,531.1,1212.3,553.6,1319.7z M2119.8,1319.2c4.8-20.9,8.3-40.2,11.1-59.6c5.8-39.5,9.8-79.2,12.5-119.1
+		c3.1-45.5,4.7-91.1,5.1-136.7c0.1-7.6-0.1-7.7-7.6-7.7c-24.3,0.1-48.6,0.3-72.9,0.5c-7.9,0.1-8,0.1-8,8.5c0,84.6,0,169.1-0.1,253.7
+		c0,5.6,1.7,9.3,5.9,12.7c12.1,9.9,24.2,19.9,36,30.1C2107.7,1306.9,2113.1,1312.7,2119.8,1319.2z M2120.4,664.4
+		c-2.1-0.6-2.9-0.1-3.6,0.7c-15.2,16.5-33.1,29.9-50.2,44.2c-4.8,4-6.8,8-6.8,14.3c0.3,32,0.2,64,0.2,96c0,52.3,0,104.6,0,157
+		c0,8.1,0.1,8.2,8.2,8.2c18.3,0.2,36.7,0.2,55,0.4c6.7,0.1,13.3,0.1,20,0.3c3.7,0.1,5.7-1.1,5.4-5.1c-0.2-2.3,0-4.7-0.1-7
+		c-0.5-45-2.1-89.9-5.2-134.8C2139.2,780.1,2132.7,721.9,2120.4,664.4z M878.7,1138.5c-36,15-69.8,32.9-102.3,53.1
+		c-3.4,2.1-4.9,4.7-5.7,8.6c-2.8,14.4-5.7,28.8-12.2,42c-3.6,7.3-7.7,14.4-17.3,14.4c-9.6,0-13.4-7.4-17.4-14.4
+		c-1.9-3.2-2-7.6-5.4-9.8c-22.3,17.4-41.6,37.2-58.8,58.9c-5.8,7.3-10.2,15.3-12,24.8c-3.8,20.3-9.1,40.2-16.7,59.5
+		c-2.6,6.7-1.3,13.3-1.5,20.3c1.5-0.4,2-0.3,2.1-0.5c3.2-3.8,6.4-7.6,9.4-11.6c31.2-40.5,66-77.4,105.4-110.2
+		c36.9-30.8,75.6-59.1,117.2-83.1c54.3-31.2,110.9-57.4,170.8-76.4c38.4-12.2,77.4-21.8,117-29.2c9.5-1.8,19.1-3,28.6-4.6
+		c1.5-0.3,3.8,0.3,4.4-1.5c1.4-3.9,0.6-8-0.4-11.7c-1-3.6-4.5-1.7-6.9-1.5c-40.6,3.2-80.4,11-120.4,18c-7,1.2-10.4,4.1-10.9,11.2
+		c-0.3,3.8-0.5,9.1-5.8,9c-4.6-0.1-4.7-5-5.3-8.5c-0.7-4.5-2.4-6-7.3-4.9c-39.3,9.1-78,19.9-115.5,34.7c-4.6,1.8-7.1,4.2-7.8,8.9
+		c-0.9,5.9-2.2,11.8-5.2,17.1c-4.1,7.1-10.6,7.2-14.6,0C881.9,1147.7,880.7,1143.4,878.7,1138.5z M1032.8,891.9
+		c0.9-3.8,1.6-6.7,2.4-9.5c0.7-2.3,1.7-4.6,4.4-4.9c3.4-0.3,4.4,2.3,5.3,4.9c0.4,1.3,0.8,2.6,0.8,3.9c0.1,7.7,4.5,10.4,11.7,11.6
+		c32.5,5.5,64.8,11.9,97.5,15.7c7.9,0.9,15.9,1.7,23.8,2.4c1.9,0.2,4,0.7,5.3-1.6c3.5-6.5,0.3-13-7-14.2c-1-0.2-2-0.2-3-0.4
+		c-42.6-5.8-84.2-15.9-125.4-28.2c-41.8-12.4-82.5-28.2-121.6-47.1c-51-24.6-99.8-53.3-144.7-87.9c-20.6-15.8-40.9-32.1-59.9-49.7
+		c-29.1-26.9-56.4-55.7-80.1-87.7c-3.7-4.9-7.7-9.6-11.6-14.3c-0.8,7.6-2.4,14.7,0.5,21.8c7.4,18.2,12.4,37.2,16,56.5
+		c1.7,9.1,5,17.3,10.6,24.4c9.2,11.4,18.5,22.8,28.7,33.3c9.9,10.1,21.1,19,32.2,28.9c3.8-6.5,5.6-13,9.8-18.2
+		c7.7-9.4,17.7-9.5,25.3-0.1c3.6,4.5,5.7,9.7,7.8,15c4.3,10.9,6.8,22.3,8.9,33.7c0.9,5.2,3.3,8.1,7.5,10.7
+		c21.9,13.4,44.1,26,67.3,37.1c10.9,5.2,22.1,10,33.5,15.2c1.8-4.8,3.1-8.6,4.7-12.2c1.6-3.5,4.2-6.3,8.3-6.1
+		c3.6,0.2,5.8,2.9,7.3,6.1c2.4,5.2,3.8,10.6,4.8,16.2c0.8,4.6,2.9,7.2,7.7,9C950.6,871.5,990.8,883,1032.8,891.9z M1953.8,1233.7
+		c-2.9,5.8-4.9,11.5-8.8,16.2c-7.6,9.3-17.8,9.3-25.3,0c-3.4-4.2-5.5-9-7.5-14c-4.4-11.5-7.2-23.5-9.4-35.7
+		c-0.7-3.9-2.4-6.4-5.8-8.6c-30.4-19.4-62.4-35.6-95-50.8c-6.9-3.3-7-3-9.9,4.7c-0.7,1.9-1.5,3.7-2.3,5.5c-1.6,3.1-3.7,5.6-7.6,5.6
+		c-3.8,0-5.9-2.5-7.6-5.6c-2.9-5.4-4.3-11.3-5.1-17.2c-0.7-5-3-7.3-7.5-9.1c-37.8-15.2-77.3-24.6-116.7-34.3c-3.8-0.9-5.4,0.2-6.2,4
+		c-0.7,3.9-0.2,9.9-6.3,9.5c-5-0.3-5.1-6.1-5.3-9.6c-0.4-6.6-3.3-8.9-9.6-10c-32.8-5.6-65.4-12.2-98.6-15.7
+		c-8.3-0.9-16.5-2.1-24.8-2.7c-5.4-0.4-7.1,1.2-7.5,6.6c-0.3,3.9-1.3,8,5.2,8.4c6.3,0.4,12.4,2.1,18.7,3.1
+		c47.7,7.5,94.4,19.1,140.3,34.3c42.4,14,83.5,31.2,123,52c46.3,24.4,90.2,52.6,131,85.6c48.5,39.1,93.7,81.2,129.4,132.6
+		c1.9,2.8,4.8,7.5,7.3,6.7c4.5-1.5,1.4-6.8,2.1-10.4c0.6-3.4-0.5-6.6-1.8-9.7c-7.8-19.5-12.6-40-17.1-60.4c-1.1-5.1-3-9.4-6-13.5
+		c-17-22.8-36.7-43.1-57.6-62.2C1959.6,1237.1,1957.6,1234.7,1953.8,1233.7z M2043.6,585.1c-4.2,2.7-6.2,6.2-8.5,9.2
+		c-29.9,40.3-64.6,76.1-102.5,109c-33.8,29.3-69.5,56.2-107.6,79.4c-51.8,31.6-106.3,57.7-163.9,77.3
+		c-40.7,13.8-82.1,24.9-124.2,33.1c-13.7,2.7-27.6,4.7-41.3,7c-2.2,0.4-5.3-0.1-6.2,2.4c-1.4,3.8-1.1,8.2,0.3,11.7
+		c1.4,3.5,5.3,1.6,8.1,1.3c40.1-4.2,79.8-10.7,119.5-18.1c6.2-1.2,10.4-2.7,10.5-10.2c0-3.5,0.3-9.3,5.4-9.5c6-0.3,5.5,5.7,6.2,9.6
+		c0.7,3.9,2.3,4.9,6.1,3.9c10-2.7,20-5.1,30-7.5c28.5-6.9,56.4-15.6,83.9-25.7c6.8-2.5,10.2-6.3,11-13.3c0.5-5,2-9.8,4.5-14.2
+		c4.2-7.6,10.8-7.6,15.1,0.1c1.6,2.9,2.5,6.2,3.4,9.3c0.9,2.9,2.5,3.5,5.2,2.2c2.4-1.2,5-1.9,7.3-3.1c26.6-13.1,53.2-26,78.7-41.2
+		c11.9-7.1,19.6-14.7,21.3-29.3c1.4-12.4,5.5-24.8,12.8-35.4c8.1-11.7,19.5-11.7,27.5,0.1c3.1,4.6,5.4,9.7,8.2,14.9
+		c1.9-1.4,3.6-2.5,5.1-3.8c22.2-19.8,42.7-41.1,60.6-64.9c2.6-3.5,4.3-7.3,5.2-11.7c4.5-21.2,9.6-42.2,17.6-62.4
+		C2045.3,599.2,2044.5,592.6,2043.6,585.1z M777.2,1163.8c1.2,0.2,1.6,0.4,1.9,0.3c30.4-14.3,60.9-28.3,92.6-39.6
+		c4.2-1.5,4.4-3.7,3.9-7.5c-4.5-37.4-6.3-75-6.5-112.6c0-7.8-0.2-7.9-8.5-7.9c-22,0-44,0-65.9,0c-8.6,0-8.8,0.1-8.8,8.7
+		c-0.4,45.3-2.2,90.5-6.6,135.6C778.4,1148.4,776.3,1155.9,777.2,1163.8z M776.8,817.8c0.3,3.8,0.5,7.1,0.9,10.4
+		c2.5,21.2,4.1,42.4,5.5,63.7c1.8,28.6,2.3,57.2,2.7,85.9c0.1,7.1,0.3,7.3,7.2,7.3c22.6,0.1,45.3,0.1,67.9,0.1
+		c8.8,0,8.1-0.2,8.1-8.3c0.1-37,1.9-73.9,6.4-110.6c0.7-5.8-0.5-8.2-6-10.1c-29.5-10.3-58-23.3-86.2-36.8
+		C781.5,818.4,779.9,817.2,776.8,817.8z M1896.4,1163.9c1-2.7,0.2-5.3-0.1-7.9c-2.4-19.8-3.9-39.8-5.3-59.7
+		c-2.1-30.3-2.5-60.6-3.3-90.9c-0.2-8.7-0.2-8.8-8.6-8.8c-16.7-0.1-33.3,0-50-0.1c-6.3,0-12.7,0.2-19-0.1c-3.9-0.1-5.5,1.4-5.2,5.3
+		c0.1,1.7,0.1,3.3,0,5c-1.1,36-2,72-6.4,107.7c-0.9,7.7-1.1,7.9,6.3,10.6c28.5,10.4,56.1,22.9,83.3,36.1
+		C1890.6,1162.4,1893.1,1164.4,1896.4,1163.9z M1896.8,817.7c-2.5-0.3-4.3,0.6-6.1,1.5c-6,2.9-12,5.6-18,8.6
+		c-22.1,10.9-44.9,20.1-67.9,28.7c-7.5,2.8-7.3,3-6.5,10.6c1,8.9,1.9,17.9,2.7,26.8c2.4,28.2,3.2,56.5,3.6,84.7
+		c0.1,5.4,1.8,6.7,6.8,6.6c22.6-0.2,45.3-0.1,67.9-0.2c1,0,2-0.1,3,0c3.8,0.3,5.6-1.2,5.2-5.1c-0.2-1.6,0-3.3,0.1-5
+		c0.7-38.6,1.7-77.2,5.2-115.6C1894.1,845.4,1895.5,831.6,1896.8,817.7z M908.3,1109.6c1.4,0,2.4,0.2,3.2,0
+		c37.8-11.7,75.5-24,114.2-32.5c4.5-1,5.8-2.9,5.5-7.4c-1.3-22-2.5-43.9-2.3-65.9c0.1-7.3-0.2-7.4-8-7.4c-33.3,0-66.7,0.1-100,0.2
+		c-7.7,0-7.9,0.1-7.9,7.5c0,31-1.6,61.9-4,92.9C908.8,1101,907.3,1105.2,908.3,1109.6z M1765.3,1110.4c0-2.5,0.1-3.5,0-4.4
+		c-3.1-33.9-4.7-67.8-4.8-101.8c0-7.4-0.4-7.6-8.2-7.7c-33.3-0.1-66.7-0.2-100-0.2c-7.3,0-7.2,0.1-7.5,7.9c-0.7,21-1.1,42-2.3,62.9
+		c-0.5,9-1.3,8.3,7.6,10.4c29.8,7.1,59.4,14.9,88.5,24.5C1747.2,1104.8,1755.7,1107.4,1765.3,1110.4z M908.8,872.2
+		c-0.2,0.3-0.6,0.6-0.6,0.8c2.8,35.5,5.2,71,4.8,106.7c-0.1,4.6,1.9,5.6,6,5.6c34.7-0.1,69.3-0.1,104,0.1c4.9,0,6.2-1.8,6.1-6.4
+		c-0.5-22,0.8-44,2.1-65.9c0.3-5.2-0.9-7.7-6.4-8.8c-36.9-7.6-72.4-20.1-108.5-30.5C913.8,873,911.6,871.1,908.8,872.2z
+		 M1765.6,872.4c-3.2-0.6-5.1,0.3-7,0.9c-22.2,6.7-44.2,14.5-66.7,20.3c-14.5,3.7-29,7.3-43.5,10.8c-4.4,1.1-6.5,2.6-6.2,8
+		c1.3,21.9,1.8,43.9,2.6,65.8c0.2,7,0.2,7.1,7.1,7.1c33.6,0,67.2,0,100.8-0.1c7.5,0,7.7-0.2,7.7-7.8c0.2-24.6,0.9-49.2,2.6-73.8
+		C1763.8,893.4,1764.7,883.1,1765.6,872.4z M725.8,1192.5c8.7-4.8,15.8-9.8,23.8-12.8c9.6-3.7,12.7-10.5,13-19.7
+		c0.1-1.3,0.2-2.7,0.4-4c3.4-27.1,5.6-54.3,6.7-81.5c1-23.6,1.5-47.2,2-70.8c0.2-7-0.1-7-7.3-7.1c-6.7-0.1-13.3,0-20,0
+		c-9,0-18,0.2-27,0c-4.2-0.1-6.2,1.3-5.9,5.7c0.2,2.3,0,4.7,0.1,7c0.8,27.6,1.2,55.2,3,82.8C717,1125.1,719.9,1158.2,725.8,1192.5z
+		 M1946.2,1191.7c2.9-2.2,2.4-4.7,2.8-6.9c4.5-26.6,6.9-53.5,8.9-80.4c2.5-33.9,3.2-67.9,3.7-101.8c0.1-5-1.8-6.2-6.4-6.1
+		c-15.3,0.2-30.6,0-46,0.1c-7.6,0-7.8,0.2-7.7,7.8c0.7,44,2,87.9,6.7,131.6c1.1,10.3,2.2,20.5,3.5,30.7c0.4,2.8,0.2,6,3.5,7.8
+		C1925.8,1180.2,1936.2,1186.1,1946.2,1191.7z M1947.7,789.1c-9.1,5-16.9,10.1-25.3,13.8c-8.2,3.6-10.5,9.5-11.5,17.8
+		c-3,27.1-5.6,54.3-6.9,81.6c-1.2,25.3-1.5,50.6-2.5,75.9c-0.2,5.1,1.5,7,6.7,7c15-0.3,30-0.1,45-0.2c8.6,0,8.4,0.6,8.3-8.9
+		c-0.3-30.6-1-61.3-3.1-91.9C1956.3,852.9,1953.6,821.8,1947.7,789.1z M726,789.2c-3.3,16.4-5.1,31.3-6.7,46.2
+		c-4.6,42.4-6.3,85-7.3,127.7c-0.1,5.7,0,11.3-0.2,17c-0.1,3.4,1.4,4.8,4.7,4.8c17,0,34,0,51,0.1c3.6,0,4.6-1.9,4.4-5
+		c-0.1-2.3-0.1-4.7-0.1-7c-0.5-37.3-1.7-74.6-5-111.8c-1.4-15.9-2.8-31.9-5.5-47.6c-0.4-2.6-0.3-5.2-3.2-6.8
+		C747.6,801.1,737.2,795.4,726,789.2z M1625.1,910.5c-9.8,1.8-18,3.4-26.2,4.6c-23.3,3.5-46.2,9.9-70,10
+		c-10.9,0.1-21.8,2.4-32.7,3.7c-3.5,0.4-6.2,1.1-6,6c0.5,15,0.7,30,0.7,44.9c0,4.4,1.7,5.8,5.9,5.7c8.3-0.2,16.6,0,25-0.1
+		c30.6,0,61.3,0,91.9-0.1c9,0,9-0.1,9.2-9.4c0.2-13,0.2-26,0.6-38.9C1623.7,928.4,1624.5,919.8,1625.1,910.5z M1625.2,1071.1
+		c-2.2-23.8-2.3-46.1-2.4-68.4c0-4.5-1-6.6-6.1-6.6c-39.9,0.1-79.9,0.1-119.8-0.1c-5.1,0-6.1,2-6.1,6.5c0,14.6-0.1,29.3-0.6,43.9
+		c-0.1,4.5,1.6,5.6,5.6,6.1c12.6,1.4,25,3.8,37.7,4c8,0.1,15.9,1.1,23.8,2.5C1579.5,1063,1601.7,1066.9,1625.2,1071.1z
+		 M1049.3,1070.4c2.6,1,4.9-0.1,7-0.6c23-5.5,46.3-8.9,69.7-12.3c16.7-2.5,33.7-3.8,50.6-5.2c5.1-0.4,6.8-1.9,6.6-7
+		c-0.4-14-0.3-27.9-0.5-41.9c-0.1-7-0.2-7.2-7.2-7.2c-39.3,0-78.5,0-117.8,0.1c-6.7,0-6.8,0.2-6.8,7.5c0,16.3-0.5,32.6-1.4,48.9
+		C1049.3,1058.6,1048.4,1064.5,1049.3,1070.4z M1049.8,910.2c-0.4,1.2-0.8,1.8-0.8,2.4c0.6,22.6,2.5,45.2,1.9,67.8
+		c-0.1,4.2,2.1,4.8,5.6,4.8c39.9,0,79.9-0.1,119.8,0.1c5.5,0,6.7-2.3,6.6-7.2c-0.2-11,0.1-22,0.2-32.9c0.1-15.9,0.1-15.5-16.3-17.4
+		c-16.5-1.9-33.1-2.4-49.6-5.2C1094.7,918.9,1072,915.9,1049.8,910.2z M1260.5,985.4c21.6,0,43.2,0,64.9,0c9.1,0,9.1-0.1,9.1-9.4
+		c0-10.3,0-20.6-0.1-30.9c-0.1-7.7-0.1-7.7-7.6-7.9c-2.3-0.1-4.7,0-7,0c-41.9,0-83.8-2.2-125.5-6.2c-4.6-0.4-5.9,0.9-6,5.1
+		c-0.2,13.6-0.6,27.3-0.8,40.9c-0.1,8.3,0.1,8.4,8.1,8.4C1217.3,985.4,1238.9,985.4,1260.5,985.4z M1485,931.5
+		c-3.1-1.4-5.4-0.6-7.7-0.4c-26.2,1.9-52.4,4.3-78.7,5.1c-17.3,0.5-34.6,1.3-51.9,1.1c-7.4-0.1-7.5,0.1-7.6,7.8
+		c-0.1,11.7,0,23.3-0.1,35c0,3.7,1,5.8,5,5.5c2-0.1,4,0,6,0c41.6,0,83.2,0,124.9,0c2,0,4-0.1,6,0c3.3,0.1,5-1.2,4.9-4.6
+		C1485.5,964.2,1485.3,947.6,1485,931.5z M1485,1051.1c0.3-17,0.5-33.6,0.9-50.1c0.1-4.2-2.2-4.8-5.7-4.8c-45,0.1-89.9,0.1-134.9,0
+		c-4.7,0-6.5,1.4-6.3,6.2c0.3,12,0.4,24,0,36c-0.2,5.2,2.1,6,6.5,6c11.6-0.1,23.3,0.1,34.9,0.4
+		C1415,1045.8,1449.5,1048.1,1485,1051.1z M1188.4,1050.6c47.5-3.4,93.2-6.8,139.2-6.4c0.7,0,1.3,0,2,0c3.2,0.2,4.9-0.9,4.9-4.5
+		c-0.1-13,0-25.9,0-38.9c0-3.4-1.6-4.8-4.9-4.6c-1.7,0.1-3.3,0-5,0c-42.6,0-85.1,0-127.7,0c-1.7,0-3.3,0.1-5,0
+		c-2.8-0.1-4.4,1.1-4.4,4.1C1187.9,1016.8,1188.1,1033.4,1188.4,1050.6z M2010.7,1230.1c0.9-7.3-0.9-13.8-1.5-20.3
+		c-6.8-66-10.3-132.2-10.7-198.6c-0.1-16.1-0.3-16.3-16.8-14.7c-2.9,0.3-4.2,1.1-4.1,4.1c0.1,3,0,6,0,9
+		c-0.3,41.3-2.1,82.6-6.1,123.8c-2,20.2-4.3,40.4-8.2,60.4c-0.9,4.8-0.2,7.8,4.5,10.4c10.2,5.7,19.9,12.2,29.8,18.3
+		C2001.8,1225,2005.6,1228.2,2010.7,1230.1z M2011.2,752.5c-2.7-0.8-3.6,0.3-4.7,1c-13.3,8.3-26.4,16.7-39.8,24.7
+		c-3.6,2.1-4.2,4.5-3.5,8.2c1.4,7.8,2.8,15.7,3.9,23.6c7.4,53.8,10.1,107.9,10.6,162.2c0.1,14.1-2.6,12.8,13.7,12.8
+		c7,0,7-0.2,7.1-7.3c0.4-27.3,0.6-54.6,1.8-81.8c1.4-30.9,3.1-61.8,6.1-92.6C2008,786.3,2009.6,769.5,2011.2,752.5z M662.1,1231.5
+		c3.7-2.4,5.6-3.7,7.5-4.9c11.6-7.7,22.9-16.2,35.5-22.2c5.3-2.5,6.2-5.5,5.1-11c-4.6-22.5-7-45.4-9-68.3
+		c-3.5-39.9-5-79.8-5.4-119.8c-0.1-8.6-0.2-8.6-8.8-8.7c-1.3,0-2.7,0-4,0c-7.9,0.1-8,0.1-7.9,8.4c0,24.7-0.6,49.3-1.6,74
+		c-1.3,32-3,63.9-6,95.8C665.8,1192.9,664.1,1211.1,662.1,1231.5z M662.9,752.1c-1,1.4-0.4,3-0.3,4.6c2,20.5,4.6,41.1,6,61.7
+		c3.8,52.5,6.5,105.1,6.4,157.8c0,8.8,0.1,8.9,8.5,8.9c14.5-0.1,12.1,1.3,12.3-12.1c1.1-62.7,3.5-125.2,14.8-187
+		c0.8-4.1-0.9-6-4.2-7.7c-13.4-6.8-25.6-15.5-38-23.9C666.8,753.1,665.5,751.1,662.9,752.1z M2044.3,728.6c-5.4,1.1-7.1,3.9-7.7,8.3
+		c-1.7,14.9-4,29.7-5.6,44.6c-4.6,42.1-7.2,84.2-8.9,126.5c-1,25.3-1.3,50.5-1.3,76.8c6.5,0,12.4-0.1,18.3,0
+		c3.8,0.1,5.5-1.4,5.2-5.3c-0.2-1.7,0-3.3,0-5c0-78.9,0-157.9,0-236.8C2044.3,734.9,2044.3,732,2044.3,728.6z M2044.3,1253
+		c0-3.7,0-6.4,0-9c0-78.6,0-157.2,0-235.8c0-13,1.3-11.5-11.9-11.5c-13,0-11.5-1.8-11.5,11.8c0,59.3,3.1,118.5,8.7,177.6
+		c1.9,19.5,4,39.1,7,58.5C2037.3,1248.9,2038.8,1251.8,2044.3,1253z M629.2,728.7c0,4.3,0,8,0,11.6c0,76.5,0,153.1,0,229.6
+		c0,15.8,0,15.8,16,15.3c7.6-0.2,7.6-0.2,7.7-7.7c0.1-3.3,0-6.7,0-10c-0.8-55.6-3.1-111.1-8.5-166.4c-2-21.2-5-42.3-7.3-63.4
+		C636.6,733.3,635,730.3,629.2,728.7z M629.2,1253.2c5.3-2.1,7.4-4.5,7.9-9.2c1.6-14.9,4-29.7,5.5-44.6
+		c6.5-62.4,9.5-124.9,10.3-187.6c0.2-15.6,0.1-15.6-15-15.6c-9,0-8.8-0.6-8.7,8.6c0,2,0,4,0,6c0,75.7,0,151.3,0,227
+		C629.2,1242.5,629.2,1247.2,629.2,1253.2z M2060,697.5c19-15.9,36.7-29.3,52.3-45.3c3.5-3.5,3.7-6.7,2.4-10.7
+		c-2.8-8.9-5.4-17.8-8.7-26.5c-3.5-9.3-7.4-18.5-13.7-26.4c-5.3-6.6-8-6.6-13.4-0.4c-1.3,1.5-2.7,3-3.6,4.7
+		c-8.9,15.7-17.3,31.5-15.3,50.5c0.4,3.6,0.1,7.3,0.1,11C2060,668,2060,681.5,2060,697.5z M613.2,1283.1
+		c-20.8,13.6-36.9,29.9-53.8,45.4c-2.8,2.6-2.3,5.1-1.5,8.1c4.1,14.7,8.6,29.3,15.3,43.2c2.6,5.4,5.4,10.7,9.8,15
+		c4.3,4.2,6.2,4.6,10,0.4c10.7-11.9,18.4-26.3,19.7-41.7C614.7,1330.6,613.2,1307.6,613.2,1283.1z M2060,1284.4
+		c0,19.5,0.7,36.8-0.2,54c-1.1,19.1,6.3,35.2,15.8,50.5c7.4,12.1,12.1,11.7,19.8-0.6c9.7-15.4,14.6-32.7,19.7-50
+		c1.1-3.7,0-6.2-2.6-8.8C2096.8,1313.6,2079.3,1299.9,2060,1284.4z M611.9,698.2c2.1-3.3,1.3-5.9,1.3-8.4c0.1-16-0.8-32,0.3-47.9
+		c1.2-18.4-6.2-33.8-15.1-48.6c-7.6-12.7-12.6-12.4-20.4,0.3c-10.1,16.3-15.1,34.6-20.4,52.8c-1,3.6,0.6,5.5,3,7.7
+		c8.8,8.1,17.3,16.7,26.3,24.5C594.8,685.4,603.3,691.5,611.9,698.2z M1788.2,864c-12.5,3.2-12.6,3.2-13.9,13.8
+		c-0.9,7.6-1.6,15.2-2.1,22.8c-1.8,26.2-2.9,52.5-3.2,78.8c0,4,0.8,6.3,5.4,6c4.6-0.3,9.3-0.2,14,0c5.1,0.1,6.9-2.1,6.7-7.3
+		c-0.5-11.3-0.2-22.6-0.7-33.9C1793.2,917.5,1792.3,890.9,1788.2,864z M885.3,1118.4c12.8-3,12.5-3,13.8-13.9
+		c3.5-29.5,4.6-59.1,5-88.8c0.3-23.5,5.2-18.7-19.8-19.4c-4.4-0.1-5.7,1.5-5.7,5.8C878.8,1040.8,880.3,1079.4,885.3,1118.4z
+		 M885.7,863.5c-0.2,0.9-0.6,1.9-0.7,2.9c-4.3,33.7-6,67.5-6.1,101.4c0,5.5-2.5,12.6,1.3,16.2c3.8,3.6,10.8,1.1,16.3,1.2
+		c7.9,0.1,8.1-0.1,7.9-8.4c-0.6-33.2-1.5-66.4-5.3-99.4C897.9,865.6,898,865.6,885.7,863.5z M1788.4,1117.5
+		c4.4-34.4,5.9-68.6,6.5-102.9c0.1-5.6,2.4-12.7-0.9-16.5c-3.9-4.3-11.3-1.4-17.2-1.6c-7.6-0.2-7.7,0.1-7.7,7.6
+		c0,24.7,1.3,49.3,2.8,73.9c0.6,10.3,2.2,20.5,2.9,30.8c0.3,3.6,1.7,5.5,4.9,6.5C1782.2,1116,1784.4,1117.7,1788.4,1117.5z
+		 M1481.1,1078.1c0-2.7,0.1-4.4,0-6c-0.3-7.8-0.3-8.1-8.2-8.7c-22.9-1.7-45.8-3.3-68.7-4.7c-19.9-1.2-39.9-0.9-59.9-1
+		c-4.6,0-5.5,2-5.4,6c0.1,3.7,0.3,6.7,5.2,6.2c1.3-0.1,2.7,0,4,0c34.3-0.3,68.4,1.9,102.5,5.6
+		C1460.6,1076.6,1470.4,1078.5,1481.1,1078.1z M1480,903c-15.3,1.6-30.8,3.6-46.3,4.8c-29.5,2.4-59.1,4.7-88.8,3.9
+		c-5.1-0.1-6.1,2-6,6.5c0.1,4.1,1.1,6.3,5.6,5.8c1.3-0.2,2.7,0,4,0c42.3,0.3,84.5-2.6,126.7-5.9c4.2-0.3,6.2-1.6,5.8-5.9
+		C1480.7,909.3,1482,906.3,1480,903z M1192.2,1078.2c3.1-0.2,5.4-0.3,7.6-0.5c37-4.6,74-7.6,111.3-7.8c6,0,12-0.1,18,0
+		c3.7,0.1,5.3-1.1,5.4-5.1c0.1-6.5,0-6.9-7.3-7c-40.6-0.8-81.1,1.7-121.6,4.6C1193.1,1063.3,1193.2,1063.6,1192.2,1078.2z
+		 M1192.6,903.2c0.2,14.4,0.2,14.4,12.8,16c3,0.4,6,0.6,8.9,0.8c19.3,1.1,38.5,2,57.8,3.2c18.6,1.2,37.2,0.8,55.9,0.8
+		c6.4,0,6.3-0.5,6.6-6.8c0.2-5.8-3.3-5.5-7.1-5.4c-28.3,0.8-56.5-1.5-84.7-3.6C1226.3,907,1209.8,905.4,1192.6,903.2z M653.6,694.6
+		c2,12.3,3.8,22.4,5.1,32.6c0.5,3.7,1.7,6.1,4.8,8c14.2,8.8,27.5,18.8,42.2,26.6c2.7,1.4,6.2,6.3,8.9,2.4c2.7-3.7-2.6-6.2-5-8.5
+		c-19-17.3-36.7-35.8-51.8-56.7C657,698.1,656,697.3,653.6,694.6z M654,1284.6c0.8,0,1.3,0.1,1.5,0c1.4-1.4,2.9-2.7,4-4.3
+		c14.6-20.8,32.8-38.3,51.2-55.5c1.2-1.1,2.6-2.1,3.6-3.4c1.4-1.7,1.5-3.6-0.2-5.7c-2.9,0.3-5.3,2.1-7.8,3.6
+		c-10.2,6.3-19.8,13.5-30.5,18.8c-12.9,6.4-19.3,15.7-19.2,30.2C656.6,1273.7,654.9,1279.1,654,1284.6z M2019.1,698.8
+		c-0.5-0.3-1-0.6-1.5-0.9c-1,1.2-2,2.4-3,3.6c-6.8,9-13,18.4-21.4,26.1c-11,10.1-20.5,21.7-32.4,30.8c-1.9,1.5-3.6,3.2-2.1,5.9
+		c2,3.5,4.1,0.5,5.7-0.4c15.4-9.7,30.8-19.6,46.1-29.5c2.3-1.5,4-3.1,4.4-6.2C2016.2,718.5,2017.7,708.6,2019.1,698.8z
+		 M2017.1,1283.9c0.7-0.2,1.4-0.5,2.1-0.7c-1.5-10.1-3-20.2-4.4-30.4c-0.4-2.6-1.9-4.1-3.9-5.4c-15.6-10-31.3-20.1-46.9-30
+		c-1.5-1-3.3-2.8-5-0.5c-1.7,2.4-0.3,4.2,1.7,5.9c4,3.4,8.1,6.9,11.8,10.6C1988.4,1249.3,2005.3,1264.3,2017.1,1283.9z M1044.6,1034
+		c0.2,0,0.3,0,0.5,0c0-11-0.1-21.9,0.1-32.9c0.1-4.2-2-4.8-5.5-4.9c-4.5-0.1-4.6,2.6-4.6,5.9c0.1,22.3,1.2,44.5,2.4,66.8
+		c0.1,1,0.2,2,0.4,3c0.2,1.2,1.2,1.8,2.1,1.7c0.8-0.1,1.9-1,2.2-1.7c0.5-1.5,0.7-3.2,0.8-4.9C1043.5,1055.9,1044,1045,1044.6,1034z
+		 M1636.4,1033.8c0.7,0,1.4,0,2.1,0c0-10.6,0-21.2,0-31.8c0-2.7,0.2-5.3-3.6-5.8c-4.7-0.6-6,0.4-6,6.1c-0.1,21.9,0.2,43.7,2.1,65.6
+		c0.1,1.3,0.1,2.7,0.6,3.9c0.3,0.7,1.5,1.6,2.2,1.5c0.7,0,1.7-1.1,1.9-1.8c0.5-1.9,0.7-3.9,0.7-5.9
+		C1636.4,1055,1636.4,1044.4,1636.4,1033.8z M1638.5,948.1c-0.2,0-0.5,0-0.7,0c-0.5-11.6-1-23.3-1.6-34.9c-0.1-1.9,0.2-4.8-2.3-4.9
+		c-3.3-0.1-2.8,3-3,5.2c-0.3,3-0.4,6-0.7,9c-1.5,19-1.4,37.9-1.4,56.9c0,5.3,2,6.8,6.4,5.8c3.8-0.8,3.3-3.6,3.3-6.2
+		C1638.5,968.8,1638.5,958.4,1638.5,948.1z M1045.1,948c-0.1,0-0.3,0-0.4,0c-0.6-11.9-1.2-23.9-1.9-35.8c-0.1-1.9-0.4-4.3-3.2-3.9
+		c-2.2,0.3-1.9,2.4-2,4c-1.3,22.5-2.3,45.1-2.5,67.7c0,3.7,1.2,5.4,5.1,5.4c4.1,0.1,5-1.9,5-5.5C1045,969.3,1045.1,958.7,1045.1,948
+		z M741.9,740.1c-4.9,5.5-6.3,11-8.3,16.2c-0.8,2-0.8,4,1.2,5.3c6.2,4.1,11.6,9.4,19.7,13C751.6,762.1,748.8,750.9,741.9,740.1z
+		 M1931.7,1241.3c11.7-16.6,11.5-18.2-3-28.3c-2.7-1.9-4.9-4.5-9.1-4.9C1921.9,1219.6,1924.7,1230.7,1931.7,1241.3z M1931.6,740
+		c-6.6,10.9-9.8,22-12.1,33.9c4-0.9,6.1-3.1,8.5-4.8C1943.5,758.3,1943.6,757.2,1931.6,740z M742.1,1241.3
+		c6.6-11.1,9.8-21.9,12.2-34.3c-8,3.6-13.2,8.8-19.2,12.6c-2,1.3-2.3,3.1-1.6,5.1C735.6,1230.2,736.7,1236.2,742.1,1241.3z
+		 M597.6,1464.4c16.9-6.5,17.3-8.9,14-24.4C605.8,1447.2,601.7,1455,597.6,1464.4z M2061.5,1442.5c-5.1,14.3,5.6,17.3,12.5,22.8
+		C2072.1,1457,2066.2,1451,2061.5,1442.5z M1781.6,836.9c-1,5.2-3.6,8.5-1.8,12.6C1785.7,846.2,1785.7,846.2,1781.6,836.9z
+		 M895.4,849.3c-1.5-4.5-1.6-7.9-3.8-11.1C887.9,846.3,887.9,846.3,895.4,849.3z M630.1,1284.6c-0.4-5.3,4.1-10.2,1.8-17
+		C627.4,1273.6,629.9,1279.2,630.1,1284.6z M629.9,697.1c0.2,5.4-3,11.4,2.4,16.6C633.8,707.4,630.4,702.5,629.9,697.1z
+		 M2044.5,1284.5c-1-5.2,1.5-10.3-2.8-15C2040.3,1275.4,2042.4,1279.6,2044.5,1284.5z M2041.9,712.1c4.1-4.8,1.6-10,2.2-14.6
+		C2043,702.1,2039.8,706.2,2041.9,712.1z M892.2,1143.9c0.4-4.2,3.5-7.3,1.6-11.5C887.6,1136,887.6,1136,892.2,1143.9z
+		 M1779.6,1132.2c-1,2.9-0.4,4.8,0.4,6.5c0.7,1.5,0.4,3.6,2.3,4.6C1785.7,1135.3,1785.7,1135.3,1779.6,1132.2z M729.5,774
+		c1.5,1.6,2.6,4,5.8,3.2C733.9,774.7,732.2,773.5,729.5,774z M737.9,778.4c-0.2,0.2-0.5,0.4-0.7,0.6c0.2,0.2,0.4,0.6,0.6,0.6
+		c0.2,0,0.5-0.3,0.7-0.5C738.4,778.8,738.1,778.6,737.9,778.4z"/>
+	<path fill="none" d="M534.9,1353.5c4.5,11.6,7.4,22.2,12.2,32c4.7,9.6,9.8,18.8,17.1,26.8c10.6,11.6,28.8,15.5,42.7,2.9
+		c1.4-1.3,3.1-2.4,5.5-4.2c1.4,7.2,1.7,13.2-2.5,19.1c-8.4,11.7-14.8,24.4-20.8,37.4c-1.7,3.7-3.7,6.7-7.3,9.1
+		c-52.7,33.7-105.3,67.6-158,101.4c-1.1,0.7-2.1,1.7-4.1,1.1c0-195.1,0-390.4,0-585.6c2.1-1.2,4.1-0.9,6-0.8
+		c21.6,0.5,43.3,1.1,64.9,1.3c5.3,0,6.7,1.8,6.7,6.9c0.5,40,1.4,79.9,3.9,119.8c2.4,38.2,5.6,76.4,10.6,114.3
+		c4.6,34.7,10.1,69.1,19.2,103c1.1,4,0.6,7.1-2.3,10c-0.9,0.9-1.7,2.1-2.6,3.1c-22.1,25.1-40.6,52.7-57.5,81.5
+		c-11.6,19.7-19.9,41-28.9,61.9c14.9-23.9,25.7-50.1,41.8-73.5C497.6,1397.6,514.9,1375.3,534.9,1353.5z"/>
+	<path fill="none" d="M534.6,627.2c-40-41.2-69.6-89-94.2-140.1c0.7,6.2,4,11.2,6.2,16.6c12.7,31.7,30.5,60.6,49.6,88.7
+		c9.3,13.7,20.4,26.3,31,39.1c3.8,4.5,5,8.7,3.4,14.4c-9.6,35.4-15,71.6-19.6,107.9c-9.4,74.5-12.5,149.3-13.7,224.3c0,1-0.1,2,0,3
+		c0.6,4.7-1.2,6.5-6.1,6.4c-8.3-0.2-16.7,0.2-25,0.4c-13.7,0.3-27.3,0.4-41,1c-4.8,0.2-6.8-1.2-6.2-6.1c0.3-2,0-4,0-6
+		c0-187.9,0-375.8,0-563.7c0-3.5,0-7.1,0-10.7c4.2-0.1,6.3,2.3,8.7,3.9c50.4,32.4,100.8,64.9,151.3,97.1c5,3.2,8.4,7.1,10.8,12.4
+		c5.1,11.2,10.4,22.4,17.8,32.3c4.9,6.6,6.7,13.5,5.1,21.9c-3.6-0.1-5.6-3.1-7.9-5c-12-9.8-28.1-7.7-38.9,2.8
+		c-12.6,12.2-19,27.9-25.2,43.7C538.8,616.5,538.2,622.2,534.6,627.2z"/>
+	<path fill="none" d="M2060.9,1411.1c7.4,4.3,12.3,10.3,20.6,11.4c9.8,1.4,17.7-1.4,24.8-7.5c8.5-7.3,13.9-16.9,18.8-26.8
+		c5.1-10.4,8.6-21.5,12.7-32.5c24.7,24.7,73.3,78.9,107.2,169.7c-1.1-8.8-3.5-17.2-6.8-25.4c-13.2-33.9-29.3-66.4-49.3-96.8
+		c-12.8-19.5-27.4-37.7-42.4-55.5c-3.4-4-4.8-7.1-3.5-12.3c12.8-48.8,19.1-98.6,24-148.7c5.9-59.7,8.4-119.6,8.9-179.7
+		c0-1.3,0-2.7,0.1-4c0.2-7,0.2-7.1,7-7.4c20-0.7,40-1.3,60-1.9c2.3-0.1,4.7,0,7-0.1c3.5-0.2,4.8,1.4,4.6,4.8c-0.1,2,0,4,0,6
+		c0,188.3,0,376.6,0,565c0,3.2,0,6.4,0,9.8c-4.5-0.2-6.9-2.8-9.5-4.5c-47.7-30.6-95.2-61.4-143-91.7c-9-5.7-16-11.6-19.9-22.4
+		c-3.7-10.1-11.2-18.9-17.1-28.2C2060.8,1426.2,2058.6,1419.6,2060.9,1411.1z"/>
+	<path fill="none" d="M2244.8,454.3c-23,66.2-59.6,121.8-106.6,172.4c-4.5-11.6-7.7-22.6-12.8-32.9c-4-8.1-8.4-15.8-14.4-22.7
+		c-12.6-14.4-29.9-17.7-45.6-3.8c-1.1,1-2,2.7-4.6,2.6c-1.4-5.5-1.1-10.5,2-15.7c8.8-14.9,18.9-29,25.8-45c1-2.3,2.7-3.7,4.7-4.9
+		c52.7-33.9,105.3-67.7,158-101.5c0.5-0.3,1.3-0.2,2.1-0.4c2.3,2.1,1.2,4.9,1.2,7.3c0.1,189.6,0.1,379.3,0.1,568.9
+		c0,1.7-0.1,3.3,0,5c0.2,3.6-1.7,4.6-4.9,4.5c-5-0.2-10-0.3-15-0.5c-17-0.5-34-1-51-1.4c-7.4-0.2-7.5-0.2-7.6-7.8
+		c-0.5-35.3-1.1-70.6-3.1-105.9c-2.6-45.9-6.4-91.7-12.8-137.3c-4.2-30.3-9.4-60.5-17.3-90.2c-1.1-4-0.2-6.6,2.5-9.8
+		c27.4-31.6,51.5-65.6,70.4-102.8c11.3-22.2,21.7-44.9,28.2-69.2C2244.6,460.9,2245.4,458.8,2244.8,454.3z"/>
+	<path fill="none" d="M553.7,662.8c3.8,0.2,5.2,2.8,6.9,4.6c14.5,15.2,30.3,29,46.9,41.9c4.1,3.2,5.8,6.4,5.8,11.7
+		c-0.2,85.6-0.1,171.2-0.1,256.8c0,7.5-0.1,7.7-7.6,7.8c-25,0.4-50,0.6-74.9,1.1c-4.3,0.1-5.9-1.2-5.7-5.6c0.4-13,0.2-26,0.5-39
+		c1.5-60.3,4.7-120.5,11.8-180.4c3.7-31.7,8.3-63.3,15.4-94.5C553,665.6,553.4,664.1,553.7,662.8z"/>
+	<path fill="none" d="M553.6,1319.7c-22.4-107.4-27.4-215.3-28.7-323.3c3.3-2.5,6.4-1.5,9.3-1.5c23.3,0.3,46.7,0.7,70,1.1
+		c9.5,0.1,9.2-1.2,9.2,9.2c0,72.3,0,144.7,0,217c0,13.3-0.1,26.7,0.1,40c0,3.6-0.7,6.2-3.8,8.6c-18.7,14.5-36.3,30.3-52.7,47.4
+		C556.3,1318.5,555.6,1318.7,553.6,1319.7z"/>
+	<path fill="none" d="M2119.8,1319.2c-6.7-6.5-12.1-12.3-18-17.5c-11.8-10.2-23.8-20.2-36-30.1c-4.2-3.4-5.9-7.1-5.9-12.7
+		c0.2-84.6,0.1-169.1,0.1-253.7c0-8.4,0.1-8.5,8-8.5c24.3-0.2,48.6-0.4,72.9-0.5c7.5,0,7.7,0,7.6,7.7c-0.3,45.6-1.9,91.2-5.1,136.7
+		c-2.7,39.9-6.7,79.6-12.5,119.1C2128.1,1279,2124.6,1298.3,2119.8,1319.2z"/>
+	<path fill="none" d="M2120.4,664.4c12.3,57.5,18.7,115.7,22.8,174.2c3.1,44.9,4.7,89.8,5.2,134.8c0,2.3-0.1,4.7,0.1,7
+		c0.3,4-1.7,5.2-5.4,5.1c-6.7-0.2-13.3-0.3-20-0.3c-18.3-0.1-36.7-0.2-55-0.4c-8-0.1-8.2-0.1-8.2-8.2c0-52.3,0-104.6,0-157
+		c0-32,0.2-64-0.2-96c-0.1-6.3,2-10.3,6.8-14.3c17.1-14.3,35.1-27.7,50.2-44.2C2117.5,664.3,2118.3,663.8,2120.4,664.4z"/>
+	<path fill="none" d="M878.7,1138.5c2,4.9,3.2,9.1,5.3,12.8c4,7.2,10.5,7.1,14.6,0c3-5.3,4.3-11.2,5.2-17.1c0.8-4.7,3.2-7.1,7.8-8.9
+		c37.6-14.8,76.3-25.6,115.5-34.7c5-1.1,6.6,0.4,7.3,4.9c0.6,3.5,0.7,8.4,5.3,8.5c5.3,0.1,5.5-5.2,5.8-9c0.5-7.1,3.9-10,10.9-11.2
+		c40-7,79.8-14.9,120.4-18c2.4-0.2,5.9-2.1,6.9,1.5c1,3.7,1.8,7.8,0.4,11.7c-0.7,1.8-2.9,1.2-4.4,1.5c-9.5,1.6-19.1,2.8-28.6,4.6
+		c-39.6,7.4-78.6,17-117,29.2c-59.9,19-116.5,45.2-170.8,76.4c-41.6,24-80.2,52.3-117.2,83.1c-39.4,32.8-74.3,69.6-105.4,110.2
+		c-3,3.9-6.2,7.7-9.4,11.6c-0.1,0.2-0.6,0.2-2.1,0.5c0.2-7-1.1-13.6,1.5-20.3c7.6-19.2,12.9-39.2,16.7-59.5
+		c1.8-9.6,6.2-17.5,12-24.8c17.2-21.7,36.5-41.5,58.8-58.9c3.4,2.2,3.5,6.6,5.4,9.8c4,7,7.8,14.4,17.4,14.4
+		c9.6,0,13.8-7.2,17.3-14.4c6.5-13.3,9.4-27.7,12.2-42c0.8-3.9,2.2-6.5,5.7-8.6C808.9,1171.4,842.7,1153.5,878.7,1138.5z"/>
+	<path fill="none" d="M1032.8,891.9c-42-9-82.2-20.4-121.3-35.7c-4.8-1.9-6.9-4.4-7.7-9c-0.9-5.6-2.3-11.1-4.8-16.2
+		c-1.5-3.2-3.7-5.9-7.3-6.1c-4.1-0.2-6.8,2.5-8.3,6.1c-1.6,3.6-2.8,7.4-4.7,12.2c-11.4-5.2-22.6-10-33.5-15.2
+		c-23.1-11.1-45.4-23.7-67.3-37.1c-4.3-2.6-6.6-5.5-7.5-10.7c-2.1-11.4-4.6-22.8-8.9-33.7c-2.1-5.3-4.2-10.5-7.8-15
+		c-7.6-9.4-17.5-9.4-25.3,0.1c-4.2,5.2-6,11.7-9.8,18.2c-11.1-9.9-22.3-18.8-32.2-28.9c-10.2-10.4-19.5-21.8-28.7-33.3
+		c-5.6-7-8.9-15.3-10.6-24.4c-3.7-19.3-8.6-38.3-16-56.5c-2.9-7.1-1.4-14.1-0.5-21.8c3.9,4.8,7.9,9.4,11.6,14.3
+		c23.7,32,51,60.7,80.1,87.7c19,17.6,39.4,33.9,59.9,49.7c45,34.7,93.8,63.3,144.7,87.9c39.2,18.9,79.8,34.7,121.6,47.1
+		c41.2,12.2,82.8,22.3,125.4,28.2c1,0.1,2,0.2,3,0.4c7.3,1.2,10.5,7.7,7,14.2c-1.3,2.3-3.4,1.7-5.3,1.6c-8-0.7-15.9-1.5-23.8-2.4
+		c-32.8-3.7-65.1-10.2-97.5-15.7c-7.1-1.2-11.5-3.9-11.7-11.6c0-1.3-0.4-2.6-0.8-3.9c-0.8-2.6-1.9-5.3-5.3-4.9
+		c-2.7,0.3-3.7,2.6-4.4,4.9C1034.4,885.3,1033.7,888.2,1032.8,891.9z"/>
+	<path fill="none" d="M1953.8,1233.7c3.8,1,5.8,3.4,8,5.3c21,19.1,40.7,39.4,57.6,62.2c3,4.1,4.9,8.4,6,13.5
+		c4.5,20.5,9.3,40.9,17.1,60.4c1.3,3.1,2.4,6.3,1.8,9.7c-0.6,3.6,2.4,8.9-2.1,10.4c-2.5,0.8-5.4-3.9-7.3-6.7
+		c-35.7-51.5-81-93.6-129.4-132.6c-40.8-32.9-84.7-61.2-131-85.6c-39.5-20.8-80.6-37.9-123-52c-45.9-15.2-92.6-26.8-140.3-34.3
+		c-6.2-1-12.4-2.7-18.7-3.1c-6.5-0.4-5.5-4.5-5.2-8.4c0.4-5.4,2.1-7.1,7.5-6.6c8.3,0.7,16.5,1.9,24.8,2.7
+		c33.2,3.4,65.8,10.1,98.6,15.7c6.3,1.1,9.2,3.4,9.6,10c0.2,3.6,0.3,9.3,5.3,9.6c6,0.4,5.5-5.6,6.3-9.5c0.7-3.9,2.4-5,6.2-4
+		c39.4,9.7,78.9,19.2,116.7,34.3c4.5,1.8,6.8,4.2,7.5,9.1c0.9,5.9,2.2,11.8,5.1,17.2c1.7,3.1,3.8,5.6,7.6,5.6c3.8,0,6-2.5,7.6-5.6
+		c0.9-1.8,1.7-3.6,2.3-5.5c2.8-7.7,2.9-7.9,9.9-4.7c32.6,15.3,64.6,31.4,95,50.8c3.4,2.2,5.1,4.7,5.8,8.6
+		c2.1,12.1,4.9,24.1,9.4,35.7c1.9,5,4.1,9.8,7.5,14c7.5,9.4,17.7,9.4,25.3,0C1948.9,1245.3,1950.9,1239.5,1953.8,1233.7z"/>
+	<path fill="none" d="M2043.6,585.1c0.9,7.5,1.7,14.1-0.8,20.4c-8,20.2-13.1,41.2-17.6,62.4c-0.9,4.4-2.6,8.3-5.2,11.7
+		c-17.8,23.8-38.4,45.2-60.6,64.9c-1.5,1.3-3.2,2.3-5.1,3.8c-2.9-5.3-5.1-10.4-8.2-14.9c-8-11.8-19.3-11.8-27.5-0.1
+		c-7.4,10.6-11.4,23-12.8,35.4c-1.7,14.6-9.4,22.2-21.3,29.3c-25.5,15.2-52.1,28.1-78.7,41.2c-2.4,1.2-5,2-7.3,3.1
+		c-2.7,1.3-4.3,0.7-5.2-2.2c-1-3.2-1.9-6.4-3.4-9.3c-4.2-7.7-10.8-7.7-15.1-0.1c-2.5,4.4-3.9,9.3-4.5,14.2c-0.8,7-4.2,10.7-11,13.3
+		c-27.5,10.2-55.4,18.9-83.9,25.7c-10,2.4-20.1,4.8-30,7.5c-3.8,1-5.4,0-6.1-3.9c-0.7-4-0.2-9.9-6.2-9.6c-5.1,0.2-5.3,6-5.4,9.5
+		c-0.1,7.5-4.3,9-10.5,10.2c-39.6,7.4-79.4,13.9-119.5,18.1c-2.8,0.3-6.7,2.3-8.1-1.3c-1.4-3.6-1.7-7.9-0.3-11.7
+		c0.9-2.4,3.9-2,6.2-2.4c13.8-2.4,27.6-4.4,41.3-7c42.1-8.2,83.5-19.3,124.2-33.1c57.6-19.6,112.2-45.7,163.9-77.3
+		c38.1-23.2,73.8-50.1,107.6-79.4c37.9-32.8,72.6-68.6,102.5-109C2037.5,591.3,2039.4,587.8,2043.6,585.1z"/>
+	<path fill="none" d="M777.2,1163.8c-0.9-7.9,1.2-15.4,2-23c4.4-45.1,6.3-90.3,6.6-135.6c0.1-8.6,0.2-8.7,8.8-8.7
+		c22-0.1,44-0.1,65.9,0c8.3,0,8.4,0.1,8.5,7.9c0.2,37.7,2,75.2,6.5,112.6c0.5,3.8,0.3,6-3.9,7.5c-31.7,11.3-62.2,25.3-92.6,39.6
+		C778.8,1164.3,778.4,1164.1,777.2,1163.8z"/>
+	<path fill="none" d="M776.8,817.8c3.1-0.6,4.7,0.6,6.5,1.4c28.2,13.5,56.6,26.5,86.2,36.8c5.4,1.9,6.7,4.3,6,10.1
+		c-4.5,36.7-6.3,73.6-6.4,110.6c0,8.1,0.7,8.3-8.1,8.3c-22.6-0.1-45.3,0-67.9-0.1c-7,0-7.1-0.2-7.2-7.3c-0.4-28.6-0.9-57.3-2.7-85.9
+		c-1.3-21.3-2.9-42.5-5.5-63.7C777.2,824.9,777.1,821.6,776.8,817.8z"/>
+	<path fill="none" d="M1896.4,1163.9c-3.3,0.5-5.7-1.5-8.4-2.8c-27.2-13.3-54.8-25.7-83.3-36.1c-7.4-2.7-7.2-2.9-6.3-10.6
+		c4.4-35.8,5.3-71.8,6.4-107.7c0.1-1.7,0.1-3.3,0-5c-0.3-3.8,1.3-5.4,5.2-5.3c6.3,0.2,12.7,0.1,19,0.1c16.7,0,33.3,0,50,0.1
+		c8.4,0,8.4,0.1,8.6,8.8c0.8,30.3,1.2,60.6,3.3,90.9c1.4,19.9,2.9,39.9,5.3,59.7C1896.5,1158.6,1897.4,1161.2,1896.4,1163.9z"/>
+	<path fill="none" d="M1896.8,817.7c-1.3,13.9-2.7,27.7-3.9,41.6c-3.5,38.5-4.5,77-5.2,115.6c0,1.7-0.2,3.3-0.1,5
+		c0.4,4-1.5,5.5-5.2,5.1c-1-0.1-2,0-3,0c-22.6,0-45.3-0.1-67.9,0.2c-5,0-6.8-1.2-6.8-6.6c-0.4-28.3-1.2-56.5-3.6-84.7
+		c-0.8-8.9-1.6-17.9-2.7-26.8c-0.9-7.6-1.1-7.8,6.5-10.6c23-8.7,45.8-17.8,67.9-28.7c6-2.9,12-5.7,18-8.6
+		C1892.5,818.3,1894.3,817.4,1896.8,817.7z"/>
+	<path fill="none" d="M908.3,1109.6c-1-4.4,0.4-8.6,0.8-12.8c2.5-30.9,4-61.8,4-92.9c0-7.4,0.2-7.5,7.9-7.5
+		c33.3-0.1,66.7-0.2,100-0.2c7.8,0,8.1,0.1,8,7.4c-0.3,22,1,44,2.3,65.9c0.3,4.5-1,6.5-5.5,7.4c-38.7,8.5-76.4,20.9-114.2,32.5
+		C910.7,1109.8,909.7,1109.6,908.3,1109.6z"/>
+	<path fill="none" d="M1765.3,1110.4c-9.6-3-18.1-5.6-26.6-8.4c-29.1-9.6-58.7-17.4-88.5-24.5c-8.9-2.1-8.1-1.4-7.6-10.4
+		c1.2-21,1.6-42,2.3-62.9c0.2-7.7,0.2-7.9,7.5-7.9c33.3,0,66.7,0.1,100,0.2c7.8,0,8.2,0.3,8.2,7.7c0.2,34,1.7,68,4.8,101.8
+		C1765.4,1106.9,1765.3,1107.9,1765.3,1110.4z"/>
+	<path fill="none" d="M908.8,872.2c2.8-1.1,5,0.8,7.5,1.5c36.1,10.3,71.6,22.9,108.5,30.5c5.5,1.1,6.7,3.6,6.4,8.8
+		c-1.3,21.9-2.6,43.9-2.1,65.9c0.1,4.7-1.2,6.5-6.1,6.4c-34.7-0.2-69.3-0.2-104-0.1c-4.1,0-6.1-1-6-5.6c0.4-35.6-2-71.2-4.8-106.7
+		C908.2,872.8,908.6,872.5,908.8,872.2z"/>
+	<path fill="none" d="M1765.6,872.4c-0.9,10.7-1.8,20.9-2.5,31.2c-1.7,24.6-2.4,49.2-2.6,73.8c-0.1,7.7-0.2,7.8-7.7,7.8
+		c-33.6,0.1-67.2,0.1-100.8,0.1c-6.9,0-6.9-0.2-7.1-7.1c-0.8-21.9-1.3-43.9-2.6-65.8c-0.3-5.4,1.8-7,6.2-8
+		c14.5-3.5,29-7.1,43.5-10.8c22.5-5.7,44.5-13.5,66.7-20.3C1760.5,872.7,1762.3,871.8,1765.6,872.4z"/>
+	<path fill="none" d="M725.8,1192.5c-5.9-34.3-8.8-67.4-11-100.6c-1.8-27.6-2.2-55.2-3-82.8c-0.1-2.3,0.1-4.7-0.1-7
+		c-0.4-4.4,1.6-5.8,5.9-5.7c9,0.2,18,0,27,0c6.7,0,13.3-0.1,20,0c7.2,0.1,7.4,0.2,7.3,7.1c-0.5,23.6-1,47.2-2,70.8
+		c-1.2,27.2-3.3,54.4-6.7,81.5c-0.2,1.3-0.3,2.6-0.4,4c-0.4,9.2-3.4,16-13,19.7C741.7,1182.7,734.5,1187.7,725.8,1192.5z"/>
+	<path fill="none" d="M1946.2,1191.7c-10.1-5.6-20.4-11.5-30.8-17.2c-3.3-1.8-3.1-5-3.5-7.8c-1.4-10.2-2.4-20.5-3.5-30.7
+		c-4.7-43.8-6-87.7-6.7-131.6c-0.1-7.7,0.1-7.8,7.7-7.8c15.3-0.1,30.6,0.1,46-0.1c4.6-0.1,6.5,1.1,6.4,6.1
+		c-0.5,34-1.2,67.9-3.7,101.8c-2,26.9-4.5,53.7-8.9,80.4C1948.7,1187,1949.1,1189.5,1946.2,1191.7z"/>
+	<path fill="none" d="M1947.7,789.1c5.8,32.7,8.6,63.8,10.8,95c2.1,30.6,2.8,61.2,3.1,91.9c0.1,9.6,0.3,8.9-8.3,8.9
+		c-15,0-30-0.1-45,0.2c-5.3,0.1-6.9-1.8-6.7-7c0.9-25.3,1.3-50.6,2.5-75.9c1.3-27.3,3.9-54.4,6.9-81.6c0.9-8.3,3.3-14.2,11.5-17.8
+		C1930.8,799.2,1938.6,794.1,1947.7,789.1z"/>
+	<path fill="none" d="M726,789.2c11.3,6.2,21.7,11.9,32.2,17.5c2.9,1.6,2.8,4.2,3.2,6.8c2.7,15.8,4.1,31.7,5.5,47.6
+		c3.3,37.2,4.5,74.5,5,111.8c0,2.3,0,4.7,0.1,7c0.1,3.1-0.8,5-4.4,5c-17-0.1-34-0.1-51-0.1c-3.3,0-4.8-1.5-4.7-4.8
+		c0.2-5.7,0-11.3,0.2-17c1-42.6,2.7-85.2,7.3-127.7C720.9,820.5,722.6,805.7,726,789.2z"/>
+	<path fill="none" d="M1625.1,910.5c-0.6,9.4-1.4,18-1.7,26.5c-0.4,13-0.4,26-0.6,38.9c-0.1,9.3-0.2,9.4-9.2,9.4
+		c-30.6,0.1-61.3,0.1-91.9,0.1c-8.3,0-16.7-0.1-25,0.1c-4.2,0.1-5.9-1.3-5.9-5.7c0-15-0.1-30-0.7-44.9c-0.2-4.8,2.5-5.5,6-6
+		c10.9-1.3,21.8-3.6,32.7-3.7c23.9-0.2,46.7-6.5,70-10C1607.1,913.9,1615.2,912.2,1625.1,910.5z"/>
+	<path fill="none" d="M1625.2,1071.1c-23.5-4.2-45.7-8.1-67.9-12.1c-7.9-1.4-15.8-2.4-23.8-2.5c-12.7-0.1-25.1-2.6-37.7-4
+		c-4-0.4-5.8-1.6-5.6-6.1c0.5-14.6,0.6-29.3,0.6-43.9c0-4.5,1-6.5,6.1-6.5c39.9,0.2,79.9,0.2,119.8,0.1c5,0,6.1,2.1,6.1,6.6
+		C1622.9,1025,1623,1047.3,1625.2,1071.1z"/>
+	<path fill="none" d="M1049.3,1070.4c-1-5.9-0.1-11.8,0.3-17.7c0.9-16.3,1.4-32.6,1.4-48.9c0-7.3,0.2-7.5,6.8-7.5
+		c39.3-0.1,78.5-0.1,117.8-0.1c7,0,7.1,0.2,7.2,7.2c0.2,14,0,27.9,0.5,41.9c0.2,5.2-1.5,6.6-6.6,7c-16.9,1.3-33.8,2.7-50.6,5.2
+		c-23.3,3.4-46.7,6.8-69.7,12.3C1054.2,1070.3,1051.9,1071.4,1049.3,1070.4z"/>
+	<path fill="none" d="M1049.8,910.2c22.1,5.7,44.8,8.7,67.4,12.5c16.4,2.8,33.1,3.3,49.6,5.2c16.4,1.9,16.4,1.5,16.3,17.4
+		c-0.1,11-0.3,22-0.2,32.9c0.1,4.9-1,7.2-6.6,7.2c-39.9-0.2-79.9-0.2-119.8-0.1c-3.4,0-5.7-0.6-5.6-4.8c0.6-22.6-1.3-45.2-1.9-67.8
+		C1049,912,1049.4,911.4,1049.8,910.2z"/>
+	<path fill="none" d="M1260.5,985.4c-21.6,0-43.2,0-64.9,0c-8,0-8.2-0.1-8.1-8.4c0.2-13.6,0.6-27.3,0.8-40.9c0.1-4.2,1.4-5.6,6-5.1
+		c41.7,4.1,83.5,6.2,125.5,6.2c2.3,0,4.7,0,7,0c7.5,0.2,7.5,0.2,7.6,7.9c0.1,10.3,0.1,20.6,0.1,30.9c0,9.3,0,9.4-9.1,9.4
+		C1303.8,985.4,1282.2,985.4,1260.5,985.4z"/>
+	<path fill="none" d="M1485,931.5c0.3,16.2,0.5,32.7,0.8,49.3c0.1,3.4-1.7,4.8-4.9,4.6c-2-0.1-4,0-6,0c-41.6,0-83.2,0-124.9,0
+		c-2,0-4-0.1-6,0c-4,0.3-5.1-1.8-5-5.5c0.1-11.7,0-23.3,0.1-35c0.1-7.6,0.1-7.8,7.6-7.8c17.3,0.2,34.6-0.6,51.9-1.1
+		c26.3-0.7,52.5-3.1,78.7-5.1C1479.6,930.9,1481.8,930,1485,931.5z"/>
+	<path fill="none" d="M1485,1051.1c-35.4-3-69.9-5.3-104.5-6.4c-11.6-0.4-23.3-0.5-34.9-0.4c-4.4,0-6.7-0.8-6.5-6
+		c0.4-12,0.3-24,0-36c-0.1-4.8,1.6-6.3,6.3-6.2c45,0.1,89.9,0.1,134.9,0c3.5,0,5.8,0.7,5.7,4.8
+		C1485.5,1017.5,1485.3,1034.1,1485,1051.1z"/>
+	<path fill="none" d="M1188.4,1050.6c-0.3-17.2-0.5-33.7-0.8-50.3c0-2.9,1.6-4.1,4.4-4.1c1.7,0,3.3,0,5,0c42.6,0,85.1,0,127.7,0
+		c1.7,0,3.3,0.1,5,0c3.3-0.2,4.9,1.2,4.9,4.6c-0.1,13-0.1,25.9,0,38.9c0,3.6-1.7,4.7-4.9,4.5c-0.7,0-1.3,0-2,0
+		C1281.6,1043.7,1235.9,1047.2,1188.4,1050.6z"/>
+	<path fill="none" d="M2010.7,1230.1c-5.1-1.9-9-5.1-13.1-7.7c-9.9-6.1-19.6-12.6-29.8-18.3c-4.8-2.6-5.5-5.6-4.5-10.4
+		c3.9-20,6.2-40.1,8.2-60.4c4-41.2,5.8-82.4,6.1-123.8c0-3,0.1-6,0-9c-0.1-3,1.1-3.8,4.1-4.1c16.5-1.5,16.7-1.4,16.8,14.7
+		c0.4,66.4,3.9,132.5,10.7,198.6C2009.9,1216.3,2011.6,1222.7,2010.7,1230.1z"/>
+	<path fill="none" d="M2011.2,752.5c-1.6,16.9-3.2,33.8-4.8,50.6c-3,30.8-4.6,61.7-6.1,92.6c-1.3,27.3-1.5,54.5-1.8,81.8
+		c-0.1,7.1-0.2,7.3-7.1,7.3c-16.3,0-13.6,1.3-13.7-12.8c-0.5-54.3-3.2-108.4-10.6-162.2c-1.1-7.9-2.5-15.8-3.9-23.6
+		c-0.7-3.6-0.1-6,3.5-8.2c13.4-8,26.6-16.4,39.8-24.7C2007.6,752.8,2008.5,751.7,2011.2,752.5z"/>
+	<path fill="none" d="M662.1,1231.5c1.9-20.4,3.7-38.6,5.4-56.8c3-31.9,4.7-63.8,6-95.8c1-24.6,1.6-49.3,1.6-74
+		c0-8.3,0.1-8.3,7.9-8.4c1.3,0,2.7,0,4,0c8.6,0.1,8.7,0.1,8.8,8.7c0.4,40,1.8,80,5.4,119.8c2,22.9,4.4,45.8,9,68.3
+		c1.1,5.5,0.2,8.5-5.1,11c-12.7,6-23.9,14.5-35.5,22.2C667.7,1227.9,665.8,1229.1,662.1,1231.5z"/>
+	<path fill="none" d="M662.9,752.1c2.6-0.9,3.9,1,5.4,2.1c12.4,8.4,24.6,17.1,38,23.9c3.3,1.7,5,3.6,4.2,7.7
+		c-11.3,61.8-13.7,124.4-14.8,187c-0.2,13.5,2.2,12.1-12.3,12.1c-8.4,0-8.5-0.1-8.5-8.9c0.1-52.7-2.6-105.3-6.4-157.8
+		c-1.5-20.6-4-41.1-6-61.7C662.5,755.1,661.9,753.4,662.9,752.1z"/>
+	<path fill="none" d="M2044.3,728.6c0,3.4,0,6.3,0,9.2c0,78.9,0,157.9,0,236.8c0,1.7-0.1,3.3,0,5c0.4,3.9-1.3,5.4-5.2,5.3
+		c-5.9-0.2-11.9,0-18.3,0c0-26.3,0.3-51.6,1.3-76.8c1.7-42.3,4.4-84.5,8.9-126.5c1.6-14.9,3.9-29.7,5.6-44.6
+		C2037.2,732.4,2038.9,729.7,2044.3,728.6z"/>
+	<path fill="none" d="M2044.3,1253c-5.6-1.2-7-4.1-7.7-8.6c-3.1-19.4-5.2-38.9-7-58.5c-5.6-59-8.7-118.2-8.7-177.6
+		c0-13.6-1.4-11.7,11.5-11.8c13.3,0,11.9-1.5,11.9,11.5c0,78.6,0,157.2,0,235.8C2044.3,1246.6,2044.3,1249.3,2044.3,1253z"/>
+	<path fill="none" d="M629.2,728.7c5.8,1.6,7.4,4.6,7.9,9c2.3,21.2,5.3,42.2,7.3,63.4c5.3,55.3,7.7,110.8,8.5,166.4
+		c0,3.3,0.1,6.7,0,10c-0.1,7.5-0.1,7.5-7.7,7.7c-16,0.5-16,0.5-16-15.3c0-76.5,0-153.1,0-229.6C629.2,736.7,629.2,733,629.2,728.7z"
+		/>
+	<path fill="none" d="M629.2,1253.2c0-6,0-10.6,0-15.3c0-75.7,0-151.3,0-227c0-2,0-4,0-6c-0.1-9.2-0.3-8.7,8.7-8.6
+		c15.1,0,15.2,0,15,15.6c-0.7,62.7-3.8,125.2-10.3,187.6c-1.5,14.9-3.9,29.7-5.5,44.6C636.6,1248.7,634.5,1251.1,629.2,1253.2z"/>
+	<path fill="none" d="M2060,697.5c0-15.9,0-29.5,0-43c0-3.7,0.3-7.3-0.1-11c-2-19,6.4-34.8,15.3-50.5c1-1.7,2.3-3.2,3.6-4.7
+		c5.4-6.2,8.1-6.2,13.4,0.4c6.3,7.8,10.3,17.1,13.7,26.4c3.2,8.7,5.9,17.6,8.7,26.5c1.3,4,1,7.1-2.4,10.7
+		C2096.7,668.2,2079,681.6,2060,697.5z"/>
+	<path fill="none" d="M613.2,1283.1c0,24.5,1.5,47.6-0.5,70.3c-1.4,15.4-9,29.8-19.7,41.7c-3.8,4.2-5.7,3.9-10-0.4
+		c-4.3-4.3-7.2-9.6-9.8-15c-6.7-13.8-11.2-28.4-15.3-43.2c-0.8-3-1.3-5.6,1.5-8.1C576.3,1313,592.4,1296.7,613.2,1283.1z"/>
+	<path fill="none" d="M2060,1284.4c19.3,15.5,36.8,29.3,52.5,45.2c2.6,2.6,3.7,5.1,2.6,8.8c-5.1,17.2-10,34.5-19.7,50
+		c-7.7,12.2-12.4,12.7-19.8,0.6c-9.5-15.4-16.9-31.4-15.8-50.5C2060.7,1321.2,2060,1303.9,2060,1284.4z"/>
+	<path fill="none" d="M611.9,698.2c-8.5-6.7-17.1-12.8-25-19.7c-9.1-7.8-17.5-16.4-26.3-24.5c-2.3-2.2-4-4.1-3-7.7
+		c5.3-18.2,10.3-36.5,20.4-52.8c7.8-12.7,12.8-13,20.4-0.3c8.9,14.9,16.3,30.2,15.1,48.6c-1,15.9-0.2,31.9-0.3,47.9
+		C613.2,692.2,614,694.9,611.9,698.2z"/>
+	<path fill="none" d="M1788.2,864c4.1,27,4.9,53.5,6.1,80.1c0.5,11.3,0.2,22.6,0.7,33.9c0.2,5.2-1.6,7.4-6.7,7.3
+		c-4.7-0.1-9.3-0.3-14,0c-4.6,0.3-5.5-2-5.4-6c0.2-26.3,1.3-52.5,3.2-78.8c0.5-7.6,1.2-15.2,2.1-22.8
+		C1775.6,867.2,1775.7,867.2,1788.2,864z"/>
+	<path fill="none" d="M885.3,1118.4c-5.1-39.1-6.6-77.6-6.6-116.3c0-4.2,1.3-5.9,5.7-5.8c25,0.7,20.1-4.1,19.8,19.4
+		c-0.4,29.6-1.5,59.3-5,88.8C897.9,1115.4,898.1,1115.4,885.3,1118.4z"/>
+	<path fill="none" d="M885.7,863.5c12.4,2.1,12.2,2.1,13.5,13.8c3.8,33,4.6,66.2,5.3,99.4c0.2,8.3,0,8.5-7.9,8.4
+		c-5.6-0.1-12.6,2.4-16.3-1.2c-3.8-3.6-1.3-10.7-1.3-16.2c0.1-33.9,1.8-67.7,6.1-101.4C885.1,865.4,885.4,864.5,885.7,863.5z"/>
+	<path fill="none" d="M1788.4,1117.5c-4,0.3-6.2-1.5-8.7-2.2c-3.2-0.9-4.6-2.9-4.9-6.5c-0.7-10.3-2.2-20.5-2.9-30.8
+		c-1.5-24.6-2.8-49.2-2.8-73.9c0-7.5,0.1-7.8,7.7-7.6c5.9,0.2,13.3-2.7,17.2,1.6c3.4,3.7,1,10.9,0.9,16.5
+		C1794.3,1048.8,1792.8,1083.1,1788.4,1117.5z"/>
+	<path fill="none" d="M1481.1,1078.1c-10.7,0.3-20.5-1.5-30.3-2.6c-34.1-3.7-68.2-5.9-102.5-5.6c-1.3,0-2.7-0.1-4,0
+		c-4.9,0.5-5.1-2.5-5.2-6.2c-0.1-4,0.7-6,5.4-6c20,0.1,39.9-0.2,59.9,1c22.9,1.4,45.8,3,68.7,4.7c7.9,0.6,7.8,0.9,8.2,8.7
+		C1481.2,1073.7,1481.1,1075.4,1481.1,1078.1z"/>
+	<path fill="none" d="M1480,903c2,3.3,0.7,6.3,1,9.2c0.4,4.3-1.6,5.6-5.8,5.9c-42.2,3.3-84.3,6.2-126.7,5.9c-1.3,0-2.7-0.1-4,0
+		c-4.5,0.5-5.5-1.7-5.6-5.8c-0.1-4.5,0.9-6.6,6-6.5c29.7,0.7,59.2-1.5,88.8-3.9C1449.3,906.5,1464.7,904.6,1480,903z"/>
+	<path fill="none" d="M1192.2,1078.2c1-14.7,0.9-15,13.5-15.8c40.5-2.9,80.9-5.4,121.6-4.6c7.3,0.1,7.4,0.5,7.3,7
+		c-0.1,4-1.7,5.2-5.4,5.1c-6-0.2-12-0.1-18,0c-37.3,0.2-74.3,3.2-111.3,7.8C1197.6,1078,1195.3,1078,1192.2,1078.2z"/>
+	<path fill="none" d="M1192.6,903.2c17.2,2.2,33.7,3.8,50.2,5c28.2,2.1,56.4,4.4,84.7,3.6c3.8-0.1,7.3-0.4,7.1,5.4
+		c-0.3,6.3-0.2,6.8-6.6,6.8c-18.6,0-37.2,0.4-55.9-0.8c-19.2-1.2-38.5-2.1-57.8-3.2c-3-0.2-6-0.4-8.9-0.8
+		C1192.8,917.6,1192.8,917.6,1192.6,903.2z"/>
+	<path fill="none" d="M653.6,694.6c2.5,2.7,3.4,3.5,4.2,4.6c15.1,20.9,32.8,39.4,51.8,56.7c2.5,2.3,7.7,4.8,5,8.5
+		c-2.7,3.9-6.2-1-8.9-2.4c-14.7-7.8-28.1-17.9-42.2-26.6c-3.1-1.9-4.3-4.4-4.8-8C657.4,717,655.5,706.9,653.6,694.6z"/>
+	<path fill="none" d="M654,1284.6c0.9-5.5,2.7-11,2.6-16.4c-0.1-14.4,6.3-23.8,19.2-30.2c10.6-5.3,20.3-12.5,30.5-18.8
+		c2.5-1.5,4.9-3.3,7.8-3.6c1.6,2.1,1.5,4,0.2,5.7c-1,1.3-2.4,2.3-3.6,3.4c-18.4,17.3-36.5,34.8-51.2,55.5c-1.1,1.6-2.6,2.9-4,4.3
+		C655.3,1284.8,654.8,1284.6,654,1284.6z"/>
+	<path fill="none" d="M2019.1,698.8c-1.4,9.8-3,19.6-4.2,29.5c-0.4,3-2.2,4.7-4.4,6.2c-15.3,9.9-30.7,19.7-46.1,29.5
+		c-1.5,1-3.7,4-5.7,0.4c-1.5-2.6,0.2-4.4,2.1-5.9c11.9-9.2,21.5-20.7,32.4-30.8c8.4-7.7,14.5-17.2,21.4-26.1c0.9-1.2,2-2.4,3-3.6
+		C2018.1,698.2,2018.6,698.5,2019.1,698.8z"/>
+	<path fill="none" d="M2017.1,1283.9c-11.8-19.6-28.7-34.6-44.6-50.5c-3.7-3.7-7.8-7.2-11.8-10.6c-1.9-1.7-3.4-3.4-1.7-5.9
+		c1.7-2.4,3.5-0.5,5,0.5c15.7,10,31.3,20,46.9,30c2,1.3,3.5,2.9,3.9,5.4c1.4,10.1,2.9,20.2,4.4,30.4
+		C2018.5,1283.4,2017.8,1283.7,2017.1,1283.9z"/>
+	<path fill="none" d="M1044.6,1034c-0.6,11-1.1,21.9-1.7,32.9c-0.1,1.6-0.3,3.3-0.8,4.9c-0.3,0.8-1.4,1.6-2.2,1.7
+		c-0.9,0.1-1.9-0.5-2.1-1.7c-0.1-1-0.3-2-0.4-3c-1.2-22.2-2.3-44.5-2.4-66.8c0-3.2,0-6,4.6-5.9c3.5,0.1,5.6,0.7,5.5,4.9
+		c-0.2,11-0.1,21.9-0.1,32.9C1044.9,1034,1044.8,1034,1044.6,1034z"/>
+	<path fill="none" d="M1636.4,1033.8c0,10.6,0,21.2,0,31.8c0,2-0.3,4-0.7,5.9c-0.2,0.8-1.2,1.8-1.9,1.8c-0.8,0-1.9-0.8-2.2-1.5
+		c-0.5-1.2-0.5-2.6-0.6-3.9c-1.9-21.8-2.2-43.7-2.1-65.6c0-5.7,1.3-6.7,6-6.1c3.9,0.5,3.6,3.1,3.6,5.8c0,10.6,0,21.2,0,31.8
+		C1637.8,1033.8,1637.1,1033.8,1636.4,1033.8z"/>
+	<path fill="none" d="M1638.5,948.1c0,10.3,0,20.6,0,31c0,2.6,0.5,5.4-3.3,6.2c-4.4,0.9-6.4-0.5-6.4-5.8c0-19,0-38,1.4-56.9
+		c0.2-3,0.4-6,0.7-9c0.2-2.2-0.3-5.4,3-5.2c2.5,0.1,2.2,3,2.3,4.9c0.6,11.6,1.1,23.3,1.6,34.9C1638,948.1,1638.2,948.1,1638.5,948.1
+		z"/>
+	<path fill="none" d="M1045.1,948c0,10.6-0.1,21.2,0,31.9c0,3.6-0.9,5.5-5,5.5c-3.9-0.1-5.1-1.7-5.1-5.4c0.1-22.6,1.2-45.1,2.5-67.7
+		c0.1-1.6-0.1-3.7,2-4c2.8-0.4,3.1,1.9,3.2,3.9c0.7,11.9,1.3,23.9,1.9,35.8C1044.8,948,1044.9,948,1045.1,948z"/>
+	<path fill="none" d="M741.9,740.1c7,10.8,9.7,22,12.6,34.5c-8.1-3.6-13.5-8.9-19.7-13c-2-1.3-2-3.3-1.2-5.3
+		C735.6,751.1,737,745.6,741.9,740.1z"/>
+	<path fill="none" d="M1931.7,1241.3c-6.9-10.6-9.7-21.7-12.1-33.3c4.2,0.4,6.4,3.1,9.1,4.9
+		C1943.2,1223.1,1943.4,1224.7,1931.7,1241.3z"/>
+	<path fill="none" d="M1931.6,740c12,17.2,11.9,18.3-3.6,29.1c-2.4,1.7-4.5,3.9-8.5,4.8C1921.8,761.9,1925,750.9,1931.6,740z"/>
+	<path fill="none" d="M742.1,1241.3c-5.3-5.2-6.5-11.1-8.6-16.5c-0.8-2-0.5-3.8,1.6-5.1c6-3.9,11.2-9.1,19.2-12.6
+		C751.8,1219.5,748.7,1230.3,742.1,1241.3z"/>
+	<path fill="none" d="M599.6,517.5c0.6,0.1,1.4,0.1,1.9,0.4c12.6,7.1,13,7.9,10.7,24.4c-5.9-7.9-11-15.2-13.4-24.1
+		C599,518,599.3,517.7,599.6,517.5z"/>
+	<path fill="none" d="M597.6,1464.4c4-9.4,8.1-17.2,14-24.4C614.9,1455.5,614.5,1457.9,597.6,1464.4z"/>
+	<path fill="none" d="M2072.4,516.4c2.2,0.6,2.3,2,1.3,3.7c-3.8,6.1-7.7,12.1-11.9,18.6c-2.8-10.6-2.1-12.7,5.3-17.8
+		c1.9-1.3,4.2-2,5.3-4.3L2072.4,516.4z"/>
+	<path fill="none" d="M2061.5,1442.5c4.7,8.5,10.5,14.5,12.5,22.8C2067.2,1459.8,2056.4,1456.8,2061.5,1442.5z"/>
+	<path fill="none" d="M1781.6,836.9c4.2,9.3,4.2,9.3-1.8,12.6C1777.9,845.4,1780.6,842.1,1781.6,836.9z"/>
+	<path fill="none" d="M895.4,849.3c-7.5-2.9-7.5-2.9-3.8-11.1C893.8,841.3,893.9,844.7,895.4,849.3z"/>
+	<path fill="none" d="M630.1,1284.6c-0.2-5.4-2.7-11,1.8-17C634.2,1274.4,629.7,1279.3,630.1,1284.6z"/>
+	<path fill="none" d="M629.9,697.1c0.5,5.4,3.9,10.3,2.4,16.6C626.9,708.5,630.1,702.5,629.9,697.1z"/>
+	<path fill="none" d="M2044.5,1284.5c-2.2-5-4.3-9.2-2.8-15C2046.1,1274.3,2043.5,1279.4,2044.5,1284.5z"/>
+	<path fill="none" d="M2041.9,712.1c-2.2-6,1.1-10.1,2.2-14.6C2043.5,702.2,2046,707.4,2041.9,712.1z"/>
+	<path fill="none" d="M892.2,1143.9c-4.6-7.9-4.6-7.9,1.6-11.5C895.7,1136.5,892.6,1139.7,892.2,1143.9z"/>
+	<path fill="none" d="M1779.6,1132.2c6.1,3.1,6.1,3.1,2.7,11.1c-1.9-1-1.7-3.1-2.3-4.6C1779.2,1137,1778.6,1135.1,1779.6,1132.2z"/>
+	<path fill="none" d="M1934.8,1202.5c4.1-0.6,6.5,2.5,11.4,4.9c-6.3,0.5-8.2-3.5-11.3-5.1L1934.8,1202.5z"/>
+	<path fill="none" d="M1935.8,777c3.1,0.9,4.5-3.5,7.8-2.9c-1.8,4-4.7,3.9-7.9,2.8L1935.8,777z"/>
+	<path fill="none" d="M729.5,774c2.7-0.5,4.4,0.6,5.8,3.2C732.1,778,731,775.7,729.5,774z"/>
+	<path fill="none" d="M734,1202.5c2.3,4.6-1.2,4.8-4.2,5.9c-0.6-3.7,3.7-3.3,4.2-5.7C734,1202.7,734,1202.5,734,1202.5z"/>
+	<path fill="none" d="M1935.2,780.3c-0.4,0.2-0.8,0.5-1.2,0.7c0.3,0,0.6,0.1,0.8,0c0.2-0.1,0.4-0.3,0.6-0.5
+		C1935.5,780.5,1935.2,780.3,1935.2,780.3z"/>
+	<path fill="none" d="M740,1203.1c-1.9-0.8-4.2,2.9-6-0.5c0,0,0,0.2,0,0.1C736,1202.8,738,1202.9,740,1203.1L740,1203.1z"/>
+	<path fill="none" d="M1935.7,777c1.4,1.3,0.9,2.4-0.5,3.3c0,0,0.3,0.3,0.3,0.3c0.1-1.2,0.3-2.3,0.4-3.5
+		C1935.8,777,1935.7,777,1935.7,777z"/>
+	<path fill="none" d="M737.9,778.4c0.2,0.2,0.4,0.5,0.6,0.7c-0.2,0.2-0.5,0.5-0.7,0.5c-0.2,0-0.4-0.4-0.6-0.6
+		C737.4,778.8,737.7,778.6,737.9,778.4z"/>
+	<path fill="none" d="M740,1203.1c0-0.3,0-0.8-0.2-1c-0.8-0.8-0.7-1.1,0.4-0.8C739.5,1201.9,739.4,1202.4,740,1203.1
+		C740,1203.1,740,1203.1,740,1203.1z"/>
+	<path fill="none" d="M1934.9,1202.3c0-0.2-0.1-0.3-0.1-0.5c0,0-0.1,0.1-0.1,0.1c0.1,0.2,0.1,0.4,0.2,0.6
+		C1934.8,1202.5,1934.9,1202.3,1934.9,1202.3z"/>
+	<path fill="none" d="M2072.4,516.6c0.7,0.4,1.4,0.8,2.1,1.2c-0.2,0.2-0.4,0.7-0.6,0.7c-1.1-0.2-1.5-1-1.4-2
+		C2072.4,516.4,2072.4,516.6,2072.4,516.6z"/>
+	<path fill="none" d="M598.7,518.3c-1-0.2-1.8-0.8-1-1.6c0.8-0.9,1.4,0,1.8,0.8C599.3,517.7,599,518,598.7,518.3z"/>
+</g>
+</svg>

docs/api/context.rst

@@ -0,0 +1,134 @@
+Contexts and streaming
+======================
+
+The modern core of ``tractor``: a :class:`Context` links a task in
+one actor to a task in another as a *single* structured concurrency
+(SC) scope stretched across the IPC boundary — errors, results and
+cancellation flow between the pair `exactly like trio`_ tasks under
+a common `nursery`_. Open one with ``Portal.open_context()`` (see
+:func:`tractor._context.open_context_from_portal` in
+:doc:`/api/core`), then optionally bridge a bidirectional
+:class:`MsgStream` between the two tasks.
+
+.. d2:: diagrams/context_handshake.d2
+   :caption: The ``open_context()`` <-> ``ctx.started()`` handshake.
+   :margin:
+   :alt: parent and child actor context handshake sequence
+
+For the guided, example-driven tour see :doc:`/guide/context`; this
+page is the precise API surface.
+
+.. currentmodule:: tractor
+
+The ``@context`` decorator
+--------------------------
+
+.. autofunction:: context
+
+.. note::
+
+   The decorated function **must** declare a parameter annotated
+   ``tractor.Context`` (any param name works); the runtime injects
+   the context instance there on each remote invocation. Pass
+   ``pld_spec`` to type-restrict (and validate) the payloads this
+   endpoint may shuttle — violations raise
+   :class:`MsgTypeError`. See ``examples/typed_payloads.py``.
+
+``Context``
+-----------
+
+.. autoclass:: Context
+   :members: started,
+             wait_for_result,
+             cancel,
+             cid,
+             chan,
+             side,
+             cancel_called,
+             cancelled_caught,
+             cancel_acked,
+             canceller,
+             maybe_error,
+             outcome
+
+.. deprecated:: 0.1.0a6
+
+   ``Context.result()`` warns; use :meth:`Context.wait_for_result`.
+
+.. note::
+
+   A :class:`Context` is **not** a :class:`trio.CancelScope`:
+   :meth:`Context.cancel` requests cancellation of the *remote*
+   peer task and does not cancel the local scope. If *you*
+   requested the cancel, the resulting :class:`ContextCancelled`
+   is absorbed at ``open_context()`` exit; a cancel originating
+   anywhere else (the peer, or a third-party actor recorded in
+   :attr:`ContextCancelled.canceller`) *is* raised locally. This
+   self-vs-cross-cancel rule is the key to writing correct
+   inter-actor teardown logic — see :doc:`/guide/context`.
+
+Bidirectional streaming
+-----------------------
+
+.. autofunction:: tractor._streaming.open_stream_from_ctx
+
+.. note::
+
+   :func:`~tractor._streaming.open_stream_from_ctx` is bound as
+   the **method-alias** ``Context.open_stream()`` — call it as
+   ``async with ctx.open_stream() as stream:``. Both sides of the
+   context must enter it for the dialog to be open.
+
+.. autoclass:: MsgStream
+   :members: send,
+             receive,
+             receive_nowait,
+             aclose,
+             subscribe,
+             ctx,
+             closed
+
+.. note::
+
+   A :class:`MsgStream` is one-shot use: once closed it can never
+   be "re-opened" — open a fresh :class:`Context` instead. Remote
+   end-of-stream surfaces as :class:`StopAsyncIteration` from
+   ``async for``; un-consumed sends overrun the receiver and raise
+   :class:`tractor._exceptions.StreamOverrun` unless the context
+   was opened with ``allow_overruns=True``.
+
+:meth:`MsgStream.subscribe` fans a single IPC stream out to
+multiple *local* tasks via a
+:class:`tractor.trionics.BroadcastReceiver` (see
+:doc:`/api/trionics`); the underlying allocation is idempotent and
+non-reversible for the stream's lifetime. See
+``examples/streaming_broadcast_fanout.py`` for the pattern in
+action.
+
+Legacy one-way streaming
+------------------------
+
+.. autofunction:: stream
+
+.. warning::
+
+   ``@tractor.stream`` and ``Portal.open_stream_from()`` are the
+   *legacy* one-way streaming API kept for backward compat: a
+   plain async-generator function streamed parent-ward with no
+   child-side receive leg. New code should use
+   ``@tractor.context`` + ``ctx.open_stream()`` (bidirectional,
+   SC-linked, typed). Note ``ctx`` is now a reserved param name
+   for ``@context`` endpoints — ``@stream`` functions must use
+   ``stream`` instead, and ``ctx.send_yield()`` is deprecated in
+   favor of :meth:`MsgStream.send`.
+
+.. seealso::
+
+   :doc:`/api/errors` for :class:`ContextCancelled` /
+   :class:`MsgTypeError` semantics, :doc:`/api/msg` for payload
+   typing via ``pld_spec`` and codecs, :doc:`/api/trionics` for
+   the broadcast fan-out machinery, and the guided tours in
+   :doc:`/guide/streaming` + :doc:`/guide/cancellation`.
+
+.. _exactly like trio: https://trio.readthedocs.io/en/latest/reference-core.html#cancellation-semantics
+.. _nursery: https://trio.readthedocs.io/en/latest/reference-core.html#nurseries-and-spawning

docs/api/core.rst

@@ -0,0 +1,157 @@
+Runtime and spawning
+====================
+
+The core lifecycle API: boot the runtime in your root process,
+spawn trio-"actors" (processes running ``trio.run()`` task trees)
+under a one-cancels-all supervisor, and talk to them through
+portals. This is structured concurrency (SC) applied *transitively*:
+every spawned process is owned by a nursery block and errors
+`always propagate`_. If you can create zombies it **is a bug**.
+
+.. currentmodule:: tractor
+
+Booting the runtime
+-------------------
+
+.. autofunction:: open_root_actor
+
+.. note::
+
+   The env vars ``TRACTOR_LOGLEVEL`` and ``TRACTOR_SPAWN_METHOD``
+   override the ``loglevel`` / ``start_method`` params so you can
+   crank verbosity or swap spawn backends without touching app
+   code. Exactly **one** IPC transport may be enabled per actor
+   (see ``enable_transports`` and :doc:`/api/ipc`).
+
+.. autofunction:: run_daemon
+
+Spawning actors
+---------------
+
+.. d2:: diagrams/actor_tree.d2
+   :caption: A supervised actor (process) tree.
+   :margin:
+   :alt: root actor supervising a tree of subactors
+
+.. autofunction:: open_nursery
+
+.. autoclass:: ActorNursery
+   :members: start_actor,
+             run_in_actor,
+             cancel,
+             cancel_called,
+             cancelled_caught
+
+.. note::
+
+   :meth:`ActorNursery.start_actor` (daemon actor + portal) is the
+   blessed spawning primitive; pair it with
+   ``Portal.open_context()`` for SC-linked remote tasks.
+   :meth:`ActorNursery.run_in_actor` is a *convenience* one-shot —
+   spawn, run a single task, auto-cancel after the result — slated
+   to be rebuilt as a high-level wrapper, so don't design around
+   it as the core model.
+
+.. deprecated:: 0.1.0a6
+
+   ``ActorNursery.cancelled`` warns; use
+   :attr:`ActorNursery.cancel_called` and
+   :attr:`ActorNursery.cancelled_caught`. The ``rpc_module_paths``
+   kwarg is likewise deprecated in favor of ``enable_modules``.
+
+Portals
+-------
+
+A :class:`Portal` "opens a portal" into a peer actor's memory
+domain: you call functions and start SC-linked tasks *over IPC* as
+though they were local, with results, errors and cancellation
+flowing back `exactly like trio`_.
+
+.. autoclass:: Portal
+   :members: run,
+             run_from_ns,
+             open_stream_from,
+             wait_for_result,
+             cancel_actor,
+             chan
+
+.. deprecated:: 0.1.0a6
+
+   ``Portal.result()`` warns; use :meth:`Portal.wait_for_result`.
+   The str-form ``Portal.run('mod.path', 'fn_name')`` also warns;
+   pass a function *object* whose module is listed in the target's
+   ``enable_modules``. ``Portal.channel`` is the legacy spelling
+   of :attr:`Portal.chan`.
+
+.. autofunction:: tractor._context.open_context_from_portal
+
+.. note::
+
+   :func:`~tractor._context.open_context_from_portal` is bound as
+   the **method-alias** ``Portal.open_context()`` — that's the
+   spelling you should actually call:
+   ``portal.open_context(fn, **kwargs)``. See :doc:`/api/context`
+   for the full ``Context`` + ``MsgStream`` API it unlocks.
+
+.. note::
+
+   :meth:`Portal.cancel_actor` cancels the *whole* remote runtime
+   and process (machine-level), not a single task — use
+   :meth:`Context.cancel` for task-level cancellation. Pass
+   ``raise_on_timeout=True`` to get an ``ActorTooSlowError`` you
+   can escalate per SC discipline (see :doc:`/api/errors`).
+
+Clusters
+--------
+
+.. autofunction:: open_actor_cluster
+
+Spawn a *flat* cluster of ``count`` worker actors (default: one
+per core) all serving the RPC ``modules`` list, yielding a
+``dict[str, Portal]`` keyed by actor name. Handy for
+embarrassingly parallel fan-out; see ``examples/quick_cluster.py``.
+
+Runtime introspection
+---------------------
+
+.. autofunction:: current_actor
+
+.. autoclass:: Actor
+   :members: aid,
+             name,
+             uid,
+             is_registrar,
+             is_infected_aio,
+             cancel_soon
+
+.. note::
+
+   :class:`Actor` is the per-process runtime singleton (msg loop,
+   RPC scheduling, IPC server) — you never instantiate it yourself
+   and should normally only touch the identity/introspection
+   surface listed above. The canonical identity type is
+   :attr:`Actor.aid` (a ``tractor.msg.Aid`` struct);
+   :attr:`Actor.uid` is the legacy ``(name, uuid)`` 2-tuple which
+   is still pervasive in logs and error metadata.
+
+.. deprecated:: 0.1.0a6
+
+   ``Actor.is_arbiter`` warns; use :attr:`Actor.is_registrar`.
+   The ``arbiter_addr`` constructor kwarg is deprecated for
+   ``registry_addrs``.
+
+.. autofunction:: current_ipc_ctx
+
+.. autofunction:: is_root_process
+
+.. autofunction:: get_runtime_vars
+
+.. seealso::
+
+   :doc:`/api/context` for the SC-linked remote task API,
+   :doc:`/api/discovery` for finding actors by name, and the
+   guided tours in :doc:`/guide/spawning`, :doc:`/guide/rpc` and
+   :doc:`/guide/context`.
+
+.. _always propagate: https://trio.readthedocs.io/en/latest/design.html#exceptions-always-propagate
+.. _exactly like trio: https://trio.readthedocs.io/en/latest/reference-core.html#cancellation-semantics

docs/api/devx.rst

@@ -0,0 +1,92 @@
+Debugging and devx: ``tractor.devx``
+====================================
+
+Multi-process debugging that actually works: boot the tree with
+``open_root_actor(debug_mode=True)`` (or pass it to
+``open_nursery()``) and any crash or explicit pause in *any* actor
+acquires a tree-global TTY lock and drops you into a
+`pdbp`_-powered REPL — one actor at a time, ``SIGINT`` shielded,
+no garbled terminals. The top-level helpers below are the daily
+drivers; the rest of the toolbox lives under ``tractor.devx``.
+
+.. currentmodule:: tractor
+
+Pausing and post-mortems
+------------------------
+
+.. autofunction:: pause
+
+.. autofunction:: pause_from_sync
+
+.. note::
+
+   :func:`pause_from_sync` needs the `greenback`_ portal: boot
+   with ``open_root_actor(maybe_enable_greenback=True)`` (mind
+   the `performance implications`_). With ``debug_mode`` on, the
+   built-in ``breakpoint()`` is also remapped to a
+   ``tractor``-safe equivalent.
+
+.. autofunction:: post_mortem
+
+.. deprecated:: 0.1.0a6
+
+   ``tractor.breakpoint()`` warns and simply calls :func:`pause`
+   — use :func:`tractor.pause` (async) or
+   :func:`tractor.pause_from_sync` in new code.
+
+Crash handling for CLIs and sync entrypoints
+--------------------------------------------
+
+.. currentmodule:: tractor.devx
+
+.. autofunction:: open_crash_handler
+
+.. autofunction:: maybe_open_crash_handler
+
+.. note::
+
+   Both are *sync* context managers usable before (or without)
+   ``trio.run()`` — wrap your CLI ``main()`` to get a post-mortem
+   REPL on any uncaught exception instead of a bare traceback.
+
+Runtime hang-hunting
+--------------------
+
+.. autofunction:: enable_stack_on_sig
+
+With stackscope_ integration enabled (also via
+``open_root_actor(enable_stack_on_sig=True)`` or the
+``TRACTOR_ENABLE_STACKSCOPE`` env var) a ``SIGUSR1`` triggers a
+full trio task-tree dump from every actor — works on live,
+*non*-debug-mode trees too:
+
+.. code:: sh
+
+   pkill --signal SIGUSR1 -f <part-of-your-cmd>
+
+Dumps also tee to ``/tmp/tractor-stackscope-<pid>.log`` so you
+still get output under captured/CI stdio.
+
+Lower-level debug plumbing
+--------------------------
+
+.. autofunction:: mk_pdb
+
+.. autofunction:: maybe_wait_for_debugger
+
+:func:`maybe_wait_for_debugger` is mainly useful in runtime/test
+code that must avoid tearing down a tree while a child still
+holds the global debug lock.
+
+.. seealso::
+
+   :doc:`/api/errors` for the boxed error types you'll inspect
+   from the REPL, :doc:`/api/core` for the ``debug_mode`` /
+   ``maybe_enable_greenback`` / ``enable_stack_on_sig`` boot
+   flags on :func:`tractor.open_root_actor`, and
+   :doc:`/guide/debugging` for the guided multi-actor REPL tour.
+
+.. _pdbp: https://github.com/mdmintz/pdbp
+.. _greenback: https://greenback.readthedocs.io/en/latest/
+.. _performance implications: https://greenback.readthedocs.io/en/latest/principle.html#performance
+.. _stackscope: https://github.com/oremanj/stackscope

docs/api/discovery.rst

@@ -0,0 +1,67 @@
+Discovery and the registrar
+===========================
+
+Every actor registers its ``(name, uuid)`` and transport addresses
+with a *registrar* actor — by default the root of the tree, or
+whichever actor serves at the ``registry_addrs`` you boot with.
+The discovery API lets any actor look up any other **by name** and
+get back a connected :class:`~tractor.Portal`, giving you
+service-discovery patterns (daemons, service trees, multi-host
+meshes) without hard-coding addresses.
+
+Lookups first scan already-connected peers before RPC-ing the
+registrar, and multihomed results are ranked UDS > local TCP >
+remote TCP. See ``examples/service_daemon_discovery.py`` for the
+canonical daemon + lookup pattern.
+
+.. currentmodule:: tractor
+
+Lookup APIs
+-----------
+
+.. autofunction:: find_actor
+
+.. autofunction:: wait_for_actor
+
+.. autofunction:: query_actor
+
+.. autofunction:: get_registry
+
+.. note::
+
+   :func:`find_actor` yields ``None`` when nothing is registered
+   under the name (or raises with ``raise_on_none=True``);
+   :func:`wait_for_actor` blocks until the name appears;
+   :func:`query_actor` only *looks up* the address without
+   connecting to the target.
+
+The ``Registrar``
+-----------------
+
+.. autoclass:: Registrar
+   :show-inheritance:
+
+A :class:`Registrar` is just an :class:`~tractor.Actor` subtype
+maintaining the name -> addresses table; you rarely touch it
+directly beyond passing ``registry_addrs`` /
+``ensure_registry=True`` to :func:`~tractor.open_root_actor`.
+Check :attr:`Actor.is_registrar <tractor.Actor.is_registrar>` to
+ask "am I it?".
+
+Legacy ``Arbiter`` alias
+------------------------
+
+.. deprecated:: 0.1.0a6
+
+   ``tractor.Arbiter`` survives only as a class alias of
+   :class:`Registrar` and all "arbiter" terminology is replaced
+   by "registrar"/"registry" across the API: ``get_arbiter()`` is
+   removed (use :func:`get_registry`) and the ``arbiter_addr``
+   kwarg is replaced by ``registry_addrs``.
+
+.. seealso::
+
+   :doc:`/api/core` for booting a registrar via
+   ``open_root_actor(registry_addrs=...)``, :doc:`/api/ipc` for
+   the transport/address model the registry stores, and
+   :doc:`/guide/discovery` for the worked walkthrough.

docs/api/errors.rst

@@ -0,0 +1,102 @@
+Errors and cancellation types
+=============================
+
+``tractor`` extends trio's "exceptions `always propagate`_" rule
+across the process boundary: a crash in any actor is serialized as
+an ``Error`` msg, shuttled over IPC, and re-raised in the linked
+parent scope as a *boxed* :class:`RemoteActorError` — preserving
+the original type, traceback text and source-actor identity, even
+across multi-hop relays (a.k.a. "inceptions").
+
+The most-used types below are importable from ``tractor``
+directly; the remainder live in ``tractor._exceptions`` (not yet
+re-exported at top level).
+
+.. currentmodule:: tractor
+
+Boxed remote errors
+-------------------
+
+.. autoexception:: RemoteActorError
+   :members: boxed_type,
+             src_uid,
+             relay_uid,
+             pformat
+
+.. code:: python
+
+   try:
+       async with portal.open_context(ep_fn) as (ctx, first):
+           ...
+   except tractor.RemoteActorError as rae:
+       if rae.boxed_type is ValueError:
+           ...  # remote task raised a `ValueError`
+
+.. autoexception:: ContextCancelled
+   :show-inheritance:
+   :members: canceller
+
+.. note::
+
+   Inspect :attr:`ContextCancelled.canceller` (the requesting
+   actor's uid) to distinguish a *self*-requested cancel (absorbed
+   at ``open_context()`` exit) from a *cross*-actor cancel (raised
+   locally) — the full rules live in :doc:`/api/context`.
+
+Typed-messaging errors
+----------------------
+
+.. autoexception:: MsgTypeError
+   :show-inheritance:
+   :members: bad_msg,
+             expected_msg_type
+
+An "IPC ``TypeError``": a message failed validation against the
+active msg-spec / ``pld_spec`` (see :doc:`/api/msg`). Raised
+sender-side for control msgs (``Started``/``Return``) and
+receiver-side for stream ``Yield`` payloads.
+
+.. autoexception:: tractor._exceptions.StreamOverrun
+   :show-inheritance:
+
+The sender out-paced the receiver's buffer on a
+:class:`~tractor.MsgStream` opened without
+``allow_overruns=True``; subtypes :class:`trio.TooSlowError`.
+
+Transport and runtime errors
+----------------------------
+
+.. autoexception:: TransportClosed
+
+.. autoexception:: ModuleNotExposed
+   :show-inheritance:
+
+Raised when an RPC requests a function from a module not listed
+in the target actor's ``enable_modules`` allowlist —
+capability-style access control, not an import bug on your end ;)
+
+.. autoexception:: tractor._exceptions.NoRuntime
+   :show-inheritance:
+
+Raised by :func:`tractor.current_actor` (and friends) when no
+actor runtime is up in the current process.
+
+.. autoexception:: tractor._exceptions.ActorTooSlowError
+   :show-inheritance:
+
+A peer actor failed to ack a cancel request within the bounded
+wait — the SC-sanctioned escalation signal from APIs like
+``Portal.cancel_actor(raise_on_timeout=True)``. Catch it to
+escalate (e.g. hard-kill via the supervising
+:class:`~tractor.ActorNursery`); never just ignore it, that's how
+zombies happen.
+
+.. seealso::
+
+   :doc:`/api/context` for how cancellation and errors flow
+   through a :class:`~tractor.Context`, :doc:`/api/devx` for
+   crash-handling REPL tooling (``debug_mode``, post-mortems),
+   and :doc:`/guide/cancellation` for the full SC-cancellation
+   story.
+
+.. _always propagate: https://trio.readthedocs.io/en/latest/design.html#exceptions-always-propagate

docs/api/index.rst

@@ -0,0 +1,67 @@
+API reference
+=============
+
+This is the curated reference for ``tractor``'s public surface: the
+names you can import and lean on without reading runtime internals.
+Everything below is re-exported at the top level (``import
+tractor``) unless a page says otherwise; subsystems like
+``tractor.msg``, ``tractor.trionics``, ``tractor.to_asyncio``,
+``tractor.devx`` and ``tractor.log`` are importable as submodules.
+
+``tractor`` is "just trio_" extended across processes: every API
+here is designed to keep the structured concurrency (SC) rules you
+already know from the `trio docs`_ intact across the process
+boundary. If a name isn't documented here it's an internal — expect
+it to change without notice B).
+
+.. currentmodule:: tractor
+
+Most-used names at a glance:
+
+.. autosummary::
+   :nosignatures:
+
+   open_root_actor
+   open_nursery
+   run_daemon
+   ActorNursery
+   Portal
+   context
+   Context
+   MsgStream
+   open_actor_cluster
+   find_actor
+   wait_for_actor
+   get_registry
+   current_actor
+   current_ipc_ctx
+   is_root_process
+   get_runtime_vars
+   RemoteActorError
+   ContextCancelled
+   MsgTypeError
+   pause
+   post_mortem
+   Channel
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Reference pages
+
+   core
+   context
+   discovery
+   errors
+   msg
+   trionics
+   to_asyncio
+   devx
+   ipc
+
+Where to next? If you're new, start with the runtime and spawning
+APIs in :doc:`/api/core`, then graduate to the inter-actor task
+linking model in :doc:`/api/context` — it's the heart of the whole
+system.
+
+.. _trio: https://github.com/python-trio/trio
+.. _trio docs: https://trio.readthedocs.io/en/latest/

docs/api/ipc.rst

@@ -0,0 +1,89 @@
+IPC and logging
+===============
+
+Under every portal, context and stream sits a per-peer
+:class:`~tractor.Channel`: a msgpack-typed messaging link wrapping
+one OS transport connection. Transports are pluggable per actor
+via ``enable_transports=['tcp' | 'uds']`` — TCP is the default,
+UDS (unix domain sockets) gives you port-less, same-host IPC with
+kernel-provided peer credentials for free — and exactly **one**
+transport may currently be enabled per actor.
+
+.. d2:: diagrams/runtime_stack.d2
+   :caption: Where ``Channel`` sits in the runtime stack.
+   :margin:
+   :alt: layered runtime stack from app code down to transports
+
+Addresses are "unwrapped" tuples at the API edges:
+``('host', port)`` for TCP, filesystem-path pairs for UDS. For
+the full layering story — transport protocols, the IPC server,
+address types and the msg loop — see
+:doc:`/explain/architecture`.
+
+.. currentmodule:: tractor
+
+``Channel``
+-----------
+
+.. autoclass:: Channel
+   :members: from_addr,
+             send,
+             recv,
+             aclose,
+             connected,
+             apply_codec,
+             aid,
+             laddr,
+             raddr,
+             closed
+
+.. deprecated:: 0.1.0a6
+
+   ``Channel.uid`` warns; use :attr:`Channel.aid` which carries
+   richer (optional) identity fields beyond the legacy
+   ``(name, uuid)`` pair.
+
+.. note::
+
+   You rarely construct a :class:`Channel` yourself — the runtime
+   hands them out via :attr:`Portal.chan <tractor.Portal.chan>`
+   and :attr:`Context.chan <tractor.Context.chan>`. Treat the
+   send/recv surface as advanced API: normal apps should speak
+   :class:`~tractor.MsgStream` instead.
+
+Choosing a transport
+--------------------
+
+.. literalinclude:: ../../examples/uds_transport_actor_tree.py
+   :caption: examples/uds_transport_actor_tree.py
+   :language: python
+
+Logging
+-------
+
+``tractor.log`` provides the structured, colorized console
+logging used across the runtime — with actor-name + task-aware
+record headers and extra log levels below :data:`logging.DEBUG`
+(``'transport'``, ``'runtime'``, ``'cancel'``, ``'devx'``) for
+spelunking the runtime itself. Use it for your app too: it's
+already distributed-system aware.
+
+.. currentmodule:: tractor.log
+
+.. autofunction:: get_logger
+
+.. autofunction:: get_console_log
+
+.. note::
+
+   The ``TRACTOR_LOGLEVEL`` env var overrides any caller-passed
+   ``loglevel`` (e.g. to ``open_root_actor()``) so you can crank
+   console verbosity without touching code; subactors inherit
+   the root's level by default.
+
+.. seealso::
+
+   :doc:`/explain/architecture` for the transport/server
+   internals, :doc:`/api/discovery` for how channel addresses
+   get registered and found, and :doc:`/api/msg` for the codec
+   layer every channel speaks.

docs/api/msg.rst

@@ -0,0 +1,107 @@
+Typed messaging: ``tractor.msg``
+================================
+
+All inter-actor communication rides a small, strictly-typed
+msgpack wire protocol built from :class:`msgspec.Struct` types —
+the "SC-shuttle" protocol that powers contexts, streams, RPC and
+cancellation. You normally never touch these msg types directly
+(the :class:`~tractor.Context` API speaks them for you) but you
+*do* use this subpackage to define **payload type contracts**: per
+endpoint via ``@tractor.context(pld_spec=...)`` or per channel via
+custom codecs.
+
+Violations of an active msg-spec surface as
+:class:`~tractor.MsgTypeError` (see :doc:`/api/errors`); the full
+typed-payload workflow is shown in ``examples/typed_payloads.py``.
+
+.. currentmodule:: tractor.msg
+
+The protocol message set
+------------------------
+
+.. autosummary::
+   :nosignatures:
+
+   PayloadMsg
+   Aid
+   SpawnSpec
+   Start
+   StartAck
+   Started
+   Yield
+   Stop
+   Return
+   CancelAck
+   Error
+
+``Aid`` (identity handshake) and ``SpawnSpec`` (parent -> child
+init) run at connection setup; ``Start``/``StartAck`` initiate an
+RPC task; ``Started``/``Yield``/``Stop``/``Return`` are the
+:class:`~tractor.Context` dialog phases; ``CancelAck`` and
+``Error`` close the loop on cancellation and (boxed) failure.
+``Msg`` is a legacy alias of ``PayloadMsg``. The union of all of
+the above is exported as ``MsgType`` (also ``__msg_spec__``).
+
+.. automodule:: tractor.msg.types
+   :no-members:
+
+.. currentmodule:: tractor.msg
+
+Codec construction and override
+-------------------------------
+
+.. autofunction:: mk_codec
+
+.. autoclass:: MsgCodec
+   :members: encode,
+             decode,
+             msg_spec
+
+.. autofunction:: mk_dec
+
+.. autoclass:: MsgDec
+   :members: decode,
+             spec
+
+.. autofunction:: apply_codec
+
+.. autofunction:: current_codec
+
+.. note::
+
+   :func:`apply_codec` swaps the codec via a
+   :class:`contextvars.ContextVar` — the override only applies to
+   the *current task* (and tasks it starts), not sibling tasks
+   already running in the actor. Payload-decoding is layered: the
+   outer codec leaves ``.pld`` fields as ``msgspec.Raw`` and each
+   context's payload-receiver decodes them against *its* spec
+   (the "cheap-or-nasty" validation pattern).
+
+Namespace pointers
+------------------
+
+.. autoclass:: NamespacePath
+   :members: from_ref,
+             load_ref,
+             to_tuple
+
+The ``'module.path:obj_name'`` :class:`str`-subtype used to
+address every RPC target function over the wire (same format as
+:func:`pkgutil.resolve_name`).
+
+Pretty structs
+--------------
+
+.. autoclass:: Struct
+   :show-inheritance:
+
+A :class:`msgspec.Struct` subtype with a multi-line pretty
+``__repr__`` — handy as a base for your own IPC payload types so
+crash logs stay readable.
+
+.. seealso::
+
+   :doc:`/api/context` for where ``pld_spec`` typing plugs into
+   the ``@context`` decorator, :doc:`/api/errors` for
+   :class:`~tractor.MsgTypeError` semantics, and
+   :doc:`/guide/msging` for the guided typed-messaging tour.

docs/api/to_asyncio.rst

@@ -0,0 +1,97 @@
+asyncio interop: ``tractor.to_asyncio``
+=======================================
+
+"Infected asyncio" mode: spawn an actor with
+``start_actor(..., infect_asyncio=True)`` and its process runs
+:mod:`trio` as a `guest`_ on top of the :mod:`asyncio` loop —
+letting your trio task tree drive asyncio tasks *in the same
+process* while the rest of the actor tree stays pure trio. Each
+trio <-> asyncio task pair is linked with structured concurrency
+(SC) semantics: error or cancellation on either side tears down
+both, with the cause translated cross-loop.
+
+.. d2:: diagrams/infected_aio.d2
+   :caption: A trio guest driving asyncio tasks in one actor.
+   :margin:
+   :alt: trio guest mode inside an asyncio-infected actor
+
+See ``examples/infected_asyncio_echo_server.py`` for a complete
+worked example.
+
+.. currentmodule:: tractor.to_asyncio
+
+Starting asyncio tasks from trio
+--------------------------------
+
+.. autofunction:: open_channel_from
+
+.. autofunction:: run_task
+
+.. note::
+
+   :func:`open_channel_from` mirrors the
+   ``Portal.open_context()`` handshake: the asyncio side calls
+   ``chan.started_nowait(value)`` and that value pops out as
+   ``first`` on the trio side. :func:`run_task` is the one-shot
+   form — run a single asyncio-compatible coroutine fn and return
+   its result to trio.
+
+The inter-loop channel
+----------------------
+
+.. autoclass:: LinkedTaskChannel
+   :members: send,
+             receive,
+             wait_for_result,
+             subscribe,
+             started_nowait,
+             send_nowait,
+             get,
+             cancel_asyncio_task,
+             closed
+
+.. note::
+
+   The trio side uses the async API
+   (:meth:`LinkedTaskChannel.send` /
+   :meth:`LinkedTaskChannel.receive`); the asyncio side uses the
+   loop-safe sync/await mix
+   (:meth:`LinkedTaskChannel.send_nowait` /
+   :meth:`LinkedTaskChannel.get` /
+   :meth:`LinkedTaskChannel.started_nowait`).
+
+Translated exception types
+--------------------------
+
+Cross-loop failures are re-raised on the *other* side as one of
+these explicit translation types, so you always know which loop
+actually died first:
+
+.. autoexception:: tractor._exceptions.AsyncioCancelled
+
+.. autoexception:: tractor._exceptions.AsyncioTaskExited
+
+.. autoexception:: tractor._exceptions.TrioCancelled
+
+.. autoexception:: tractor._exceptions.TrioTaskExited
+
+.. autoexception:: AsyncioRuntimeTranslationError
+   :show-inheritance:
+
+Guest-mode entrypoint
+---------------------
+
+``run_as_asyncio_guest()`` is the runtime-internal entrypoint that
+boots trio in `guest`_ mode inside an infected actor — you get it
+implicitly via ``infect_asyncio=True`` and shouldn't need to call
+it yourself.
+
+.. seealso::
+
+   :doc:`/api/core` for the ``infect_asyncio`` spawn flag,
+   :meth:`tractor.Actor.is_infected_aio` for runtime
+   introspection, :doc:`/api/devx` for using the debugger from
+   inside asyncio tasks, and :doc:`/guide/asyncio` for the
+   guided tour.
+
+.. _guest: https://trio.readthedocs.io/en/stable/reference-lowlevel.html?highlight=guest%20mode#using-guest-mode-to-run-trio-on-top-of-other-event-loops

docs/api/trionics.rst

@@ -0,0 +1,76 @@
+Trio patterns: ``tractor.trionics``
+===================================
+
+Sugary structured concurrency (SC) patterns for plain :mod:`trio`
+code — **no actor runtime required**. These helpers grew out of
+real distributed-system needs in ``tractor`` apps but every one of
+them works in a single-process program too; import via
+``from tractor import trionics``.
+
+.. currentmodule:: tractor.trionics
+
+Context-manager helpers
+-----------------------
+
+.. autofunction:: gather_contexts
+
+.. autofunction:: maybe_open_context
+
+.. autofunction:: maybe_open_nursery
+
+.. note::
+
+   :func:`gather_contexts` is "a nursery for async context
+   managers": it enters N acms concurrently and yields their
+   values in input order. :func:`maybe_open_context` is the
+   actor-wide cache/multiplex layer on top — the first task pays
+   the acm setup cost, later callers get ``(cache_hit=True, ...)``
+   and share the same value until all users exit.
+
+Broadcast fan-out
+-----------------
+
+.. autofunction:: broadcast_receiver
+
+.. autoclass:: BroadcastReceiver
+   :members: receive,
+             subscribe,
+             aclose
+
+.. autoexception:: Lagged
+   :show-inheritance:
+
+A single-producer, many-consumer broadcast layer over any
+``trio``-style receive channel: non-lossy for the *fastest*
+consumer while slower consumers raise :class:`Lagged` (a
+:class:`trio.TooSlowError` subtype) once they fall behind the
+internal ring. This is exactly the machinery behind
+:meth:`tractor.MsgStream.subscribe` — see
+``examples/streaming_broadcast_fanout.py``.
+
+ExceptionGroup helpers
+----------------------
+
+.. autofunction:: collapse_eg
+
+.. autofunction:: maybe_raise_from_masking_exc
+
+.. note::
+
+   :func:`collapse_eg` "un-nests" single-exception
+   :class:`ExceptionGroup` wrappers from strict-eg ``trio``
+   nurseries so your ``except`` clauses match the original error;
+   :func:`maybe_raise_from_masking_exc` surfaces real errors that
+   would otherwise be masked by :class:`trio.Cancelled` during
+   teardown.
+
+.. seealso::
+
+   :doc:`/api/context` for the IPC-stream consumer of
+   :class:`BroadcastReceiver`, :doc:`/guide/streaming` for
+   fan-out in a worked pipeline, and the `trio docs`_ for the
+   underlying channel and `nursery`_ semantics these helpers
+   compose.
+
+.. _trio docs: https://trio.readthedocs.io/en/latest/
+.. _nursery: https://trio.readthedocs.io/en/latest/reference-core.html#nurseries-and-spawning

docs/conf.py

@@ -1,105 +1,160 @@
-# Configuration file for the Sphinx documentation builder.
+# tractor: distributed structured concurrency.
-#
+'''
-# This file only contains a selection of the most common options. For a full
+Sphinx config for `tractor`'s documentation.
-# list see the documentation:
-# https://www.sphinx-doc.org/en/master/usage/configuration.html
 
-# -- Path setup --------------------------------------------------------------
+Theme-wise we ride the `pydata_sphinx_theme` (per the
+research + history in #157) skinned to a minimal
+black + white look via `_static/css/custom.css`; see
+the local extensions under `_ext/` for our `.. d2::`
+diagram and `.. margin::` aside directives.
 
-# If extensions (or modules to document with autodoc) are in another directory,
+Build locally via,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-#
-# import os
-# import sys
-# sys.path.insert(0, os.path.abspath('.'))
 
-# Warn about all references to unknown targets
+    uv run --group docs make -C docs html
-nitpicky = True
 
-# The master toctree document.
+'''
-master_doc = 'index'
+from importlib.metadata import version as get_version
+from pathlib import Path
+import sys
 
-# -- Project information -----------------------------------------------------
+# local sphinx extensions live in `_ext/`:
+# - `d2diagrams`: `.. d2::` diagram rendering
+# - `marginalia`: `.. margin::` RHS prose-asides
+sys.path.insert(
+    0,
+    str((Path(__file__).parent / '_ext').resolve()),
+)
+
+# -- project info ---------------------------------
 
 project = 'tractor'
-copyright = '2018, Tyler Goodlet'
+copyright = '2018-2026, Tyler Goodlet'
 author = 'Tyler Goodlet'
+release: str = get_version('tractor')
+version: str = release
 
-# The full version, including alpha/beta/rc tags
+# -- general config -------------------------------
-release = '0.0.0a0.dev0'
 
-# -- General configuration ---------------------------------------------------
-
-# Add any Sphinx extension module names here, as strings. They can be
-# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
-# ones.
 extensions = [
     'sphinx.ext.autodoc',
+    'sphinx.ext.autosummary',
     'sphinx.ext.intersphinx',
+    'sphinx.ext.viewcode',
     'sphinx.ext.todo',
+    # emit a `.nojekyll` so GitHub Pages serves the `_static/`
+    # + `_images/` dirs (Jekyll would otherwise drop `_`-prefixed
+    # paths and break all styling/assets).
+    'sphinx.ext.githubpages',
+    'sphinx_design',
+    'sphinx_copybutton',
+    'sphinxext.opengraph',
+    'sphinx_togglebutton',
+    'd2diagrams',
+    'marginalia',
 ]
-
-# Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
+exclude_patterns = [
+    '_build',
+    # the pypi/gh readme + its standalone generator
+    # sub-project; NOT doc-tree pages.
+    'README.rst',
+    'github_readme',
+    'Thumbs.db',
+    '.DS_Store',
+]
+root_doc = 'index'
+# TODO: flip this on + burn down the (many) warnings
+# from our informal docstring style; see the autodoc
+# readiness notes from the revamp's recon pass.
+nitpicky = False
 
-# List of patterns, relative to source directory, that match files and
+# -- autodoc/autosummary --------------------------
-# directories to ignore when looking for source files.
-# This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
 
+autodoc_member_order = 'bysource'
+autodoc_typehints = 'description'
+autosummary_generate = True
 
-# -- Options for HTML output -------------------------------------------------
+# -- intersphinx ----------------------------------
 
-# The theme to use for HTML and HTML Help pages.  See the documentation for
+intersphinx_mapping = {
-# a list of builtin themes.
+    'python': (
-#
+        'https://docs.python.org/3',
-html_theme = 'sphinx_book_theme'
+        None,
-
+    ),
-pygments_style = 'algol_nu'
+    'trio': (
-
+        'https://trio.readthedocs.io/en/stable',
-# Theme options are theme-specific and customize the look and feel of a theme
+        None,
-# further.  For a list of options available for each theme, see the
+    ),
-# documentation.
+    # NOTE, msgspec's site doesn't publish an
-html_theme_options = {
+    # `objects.inv` (404s) so no intersphinx for it.
-    # 'logo': 'tractor_logo_side.svg',
+    'pytest': (
-    # 'description': 'Structured concurrent "actors"',
+        'https://docs.pytest.org/en/stable',
-    "repository_url": "https://github.com/goodboy/tractor",
+        None,
-    "use_repository_button": True,
+    ),
-    "home_page_in_toc": False,
-    "show_toc_level": 1,
-    "path_to_docs": "docs",
-
-}
-html_sidebars = {
-    "**": [
-        "sbt-sidebar-nav.html",
-        # "sidebar-search-bs.html",
-        # 'localtoc.html',
-    ],
-    #     'logo.html',
-    #     'github.html',
-    #     'relations.html',
-    #     'searchbox.html'
-    # ]
 }
 
-# doesn't seem to work?
+# -- html output ----------------------------------
-# extra_navbar = "<p>nextttt-gennnnn</p>"
 
-html_title = ''
+html_theme = 'pydata_sphinx_theme'
+html_title = 'tractor'
+# canonical site root (GitHub Pages); drives <link rel=canonical>,
+# og:url + any future sitemap. Update if a custom domain is added.
+html_baseurl = 'https://goodboy.github.io/tractor/'
 html_logo = '_static/tractor_logo_side.svg'
 html_favicon = '_static/tractor_logo_side.svg'
-# show_navbar_depth = 1
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']
-
+html_css_files = ['css/custom.css']
-# Example configuration for intersphinx: refer to the Python standard library.
+html_show_sourcelink = False
-intersphinx_mapping = {
+html_theme_options = {
-    "python": ("https://docs.python.org/3", None),
+    # theme-adaptive navbar logo: faces transparent, linework
-    "pytest": ("https://docs.pytest.org/en/latest", None),
+    # near-black on light / near-white on dark (pydata swaps by
-    "setuptools": ("https://setuptools.readthedocs.io/en/latest", None),
+    # the active theme). Matches the landing hero's wireframe.
+    'logo': {
+        'image_light': '_static/tractor_logo_nav_light.svg',
+        'image_dark': '_static/tractor_logo_nav_dark.svg',
+        'alt_text': 'tractor',
+        # text shown to the right of the navbar logo (à la
+        # polars).
+        'text': 'tractor',
+    },
+    'github_url': 'https://github.com/goodboy/tractor',
+    'navbar_align': 'content',
+    'show_toc_level': 2,
+    'secondary_sidebar_items': {
+        '**': ['page-toc'],
+        'index': [],
+    },
+    'use_edit_page_button': True,
+    'footer_start': ['copyright'],
+    'footer_end': ['theme-version'],
+    'pygments_light_style': 'algol_nu',
+    'pygments_dark_style': 'github-dark',
 }
+html_context = {
+    'github_user': 'goodboy',
+    'github_repo': 'tractor',
+    'github_version': 'main',
+    'doc_path': 'docs',
+}
+
+# -- ext: opengraph -------------------------------
+
+ogp_site_url = 'https://goodboy.github.io/tractor/'
+ogp_use_first_image = True
+
+# -- ext: copybutton ------------------------------
+
+copybutton_prompt_text = r'>>> |\.\.\. |\$ '
+copybutton_prompt_is_regexp = True
+
+# -- ext: todo ------------------------------------
+
+todo_include_todos = True
+
+# -- ext: d2diagrams (local) ----------------------
+
+# normally resolved from PATH or the `D2_BIN` env
+# var; when neither hits, the committed SVGs under
+# `_diagrams/` are used as-is.
+d2_bin = None
+d2_args = []

docs/dev_tips.rst

@@ -1,51 +0,0 @@
-Hot tips for ``tractor`` hackers
-================================
-
-This is a WIP guide for newcomers to the project mostly to do with
-dev, testing, CI and release gotchas, reminders and best practises.
-
-``tractor`` is a fairly novel project compared to most since it is
-effectively a new way of doing distributed computing in Python and is
-much closer to working with an "application level runtime" (like erlang
-OTP or scala's akka project) then it is a traditional Python library.
-As such, having an arsenal of tools and recipes for figuring out the
-right way to debug problems when they do arise is somewhat of
-a necessity.
-
-
-Making a Release
-----------------
-We currently do nothing special here except the traditional
-PyPa release recipe as in `documented by twine`_. I personally
-create sub-dirs within the generated `dist/` with an explicit
-release name such as `alpha3/` when there's been a sequence of
-releases I've made, but it really is up to you how you like to
-organize generated sdists locally.
-
-The resulting build cmds are approximately:
-
-.. code:: bash
-
-    python setup.py sdist -d ./dist/XXX.X/
-
-    twine upload -r testpypi dist/XXX.X/*
-
-    twine upload dist/XXX.X/*
-
-
-
-.. _documented by twine: https://twine.readthedocs.io/en/latest/#using-twine
-
-
-Debugging and monitoring actor trees
-------------------------------------
-TODO: but there are tips in the readme for some terminal commands
-which can be used to see the process trees easily on Linux.
-
-
-Using the log system to trace `trio` task flow
-----------------------------------------------
-TODO: the logging system is meant to be oriented around
-stack "layers" of the runtime such that you can track
-"logical abstraction layers" in the code such as errors, cancellation,
-IPC and streaming, and the low level transport and wire protocols.

docs/diagrams/actor_tree.d2

@@ -0,0 +1,31 @@
+# tractor docs diagram: the hero supervision tree.
+# A process tree of trio-task-trees; every arrow is
+# a parent which *must wait* on its children.
+vars: {
+  d2-config: {
+    sketch: true
+    theme-id: 1
+    pad: 16
+    layout-engine: elk
+  }
+}
+direction: down
+root: "root actor" {
+  main: "main()"
+  an: "ActorNursery"
+  main -> an: opens
+}
+w0: "subactor\n'worker_0'" {
+  tasks: "trio task tree"
+}
+w1: "subactor\n'worker_1'" {
+  main: "serve()"
+  an: "ActorNursery"
+  main -> an: opens
+}
+gc: "subactor\n'deeper'" {
+  tasks: "trio task tree"
+}
+root.an -> w0: "spawns +\nsupervises"
+root.an -> w1: "spawns +\nsupervises"
+w1.an -> gc: "spawns +\nsupervises"

docs/diagrams/context_handshake.d2

@@ -0,0 +1,33 @@
+# tractor docs diagram: the inter-actor `Context`
+# dialog; tractor's SC-transitive msg protocol as
+# seen from both sides of `Portal.open_context()`.
+vars: {
+  d2-config: {
+    sketch: true
+    theme-id: 1
+    pad: 16
+    layout-engine: elk
+  }
+}
+shape: sequence_diagram
+parent: "parent task\n(Portal)"
+child: "child actor task\n(@tractor.context fn)"
+parent -> child: "Start: open_context(fn, **kwargs)"
+child -> parent: "StartAck"
+child -> parent: "Started: await ctx.started(value)"
+parent -> child: "Yield: stream.send()"
+child -> parent: "Yield: stream.send()"
+parent -> child: "Stop: stream closed"
+child -> parent: "Return: fn return value"
+# the non-graceful endings: errors/cancels always
+# propagate, both ways (`ContextCancelled` rides in
+# an `Error` msg, hence the `Error: ...` labels).
+"... or, instead of a graceful Return": {
+  parent-initiated: {
+    parent -> child: "ctx.cancel()  |  parent-side error"
+    child -> parent: "Error: ContextCancelled"
+  }
+  child-initiated: {
+    child -> parent: "Error: child raised  |  ContextCancelled"
+  }
+}

docs/diagrams/debug_lock.d2

@@ -0,0 +1,19 @@
+# tractor docs diagram: multi-actor debugger REPL
+# serialization via the root actor's tty lock.
+vars: {
+  d2-config: {
+    sketch: true
+    theme-id: 1
+    pad: 16
+    layout-engine: elk
+  }
+}
+shape: sequence_diagram
+mary: "subactor 'mary'"
+root: "root actor\n(owns the tty)"
+bob: "subactor 'bob'"
+mary -> root: "tractor.pause(): acquire tty lock"
+root -> mary: "granted: pdb REPL is yours"
+bob -> root: "tractor.pause(): acquire tty lock"
+mary -> root: "continue: release lock"
+root -> bob: "granted: pdb REPL is yours"

docs/diagrams/error_propagation.d2

@@ -0,0 +1,27 @@
+# tractor docs diagram: one-cancels-all error
+# propagation up a (sub-)actor tree; no zombies,
+# no lost errors.
+vars: {
+  d2-config: {
+    sketch: true
+    theme-id: 1
+    pad: 16
+    layout-engine: elk
+  }
+}
+direction: down
+root: "root actor\n(ActorNursery)"
+gertie: "subactor 'gertie'\n(healthy, gets cancelled)"
+bobbie: "subactor 'bobbie'\nraises NameError"
+root -> gertie: supervises
+root -> bobbie: supervises
+bobbie -> root: "RemoteActorError\n(boxed NameError)" {
+  style: {
+    stroke-dash: 3
+  }
+}
+root -> gertie: "cancel()" {
+  style: {
+    stroke-dash: 3
+  }
+}

docs/diagrams/infected_aio.d2

@@ -0,0 +1,23 @@
+# tractor docs diagram: "infected asyncio" mode;
+# trio runs as a guest on the asyncio loop with
+# SC supervision linking tasks across both.
+vars: {
+  d2-config: {
+    sketch: true
+    theme-id: 1
+    pad: 16
+    layout-engine: elk
+  }
+}
+direction: down
+sub: "subactor process (infect_asyncio=True)" {
+  aio: "asyncio event loop" {
+    aiotask: "asyncio.Task\naio_echo_server()"
+    trio: "trio (guest mode)" {
+      triotask: "trio task\n@tractor.context fn"
+    }
+    trio.triotask <-> aiotask: "LinkedTaskChannel\n.send()/.receive()"
+  }
+}
+parent: "parent actor (pure trio)"
+parent <-> sub.aio.trio.triotask: "IPC: Context + MsgStream"

docs/diagrams/runtime_stack.d2

@@ -0,0 +1,16 @@
+# tractor docs diagram: the layered runtime view
+# inside any single actor process.
+vars: {
+  d2-config: {
+    sketch: true
+    theme-id: 1
+    pad: 16
+    layout-engine: elk
+  }
+}
+grid-rows: 4
+grid-gap: 0
+app: "your app: plain trio tasks + nurseries"
+tractor: "tractor runtime: actors, portals,\ncontexts + streams, RPC"
+ipc: "IPC Channel: msgspec-typed msgs\nover TCP | UDS transports"
+os: "OS: one process per actor"

docs/diagrams/streaming_pipeline.d2

@@ -0,0 +1,27 @@
+# tractor docs diagram: multi-actor streaming
+# pipeline topology from
+# examples/full_fledged_streaming_service.py
+vars: {
+  d2-config: {
+    sketch: true
+    theme-id: 1
+    pad: 16
+    layout-engine: elk
+  }
+}
+direction: right
+s0: "actor 'streamer_0'" {
+  fn: "stream_data(0)"
+}
+s1: "actor 'streamer_1'" {
+  fn: "stream_data(1)"
+}
+agg: "actor 'aggregator'" {
+  fn: "aggregate()"
+}
+main: "root actor" {
+  fn: "main()"
+}
+s0 -> agg: "async for:\nyielded ints"
+s1 -> agg: "async for:\nyielded ints"
+agg -> main: "deduped\nstream"

docs/explain/architecture.rst

@@ -0,0 +1,369 @@
+Anatomy of the runtime
+======================
+
+You can get a long way with ``tractor`` by treating it as "trio_
+with nurseries that spawn processes". But once you start asking
+*where does my msg actually go?*, *which process is that?* or
+*who keeps the phonebook?*, it pays to know how the runtime hangs
+together. This page walks the stack top to bottom.
+
+.. d2:: diagrams/runtime_stack.d2
+   :caption: The four runtime layers inside *every* actor process.
+   :alt: layer cake of app tasks, tractor runtime, IPC, OS process
+   :width: 70%
+
+The layer cake
+--------------
+
+Every actor process is the same four-layer sandwich:
+
+- **your app**: plain ``trio`` tasks, nurseries and cancel
+  scopes; nothing special. ``tractor`` is a `structured
+  concurrency`_ (SC) multi-processing runtime built on trio_ and
+  the whole pitch is that this layer stays *just trio*: no
+  callbacks, no futures, no proxy objects.
+- **the** ``tractor`` **runtime**: a per-process
+  :class:`tractor.Actor` running the msg loop and RPC task
+  scheduler, plus the user-facing primitives layered on it:
+  :class:`tractor.ActorNursery` (spawning + supervision),
+  :class:`tractor.Portal` (calling into a peer) and
+  :class:`tractor.Context` + :class:`tractor.MsgStream`
+  (SC-linked cross-actor task pairs and streaming).
+- **IPC channels**: one :class:`tractor.Channel` per connected
+  peer, each wrapping a ``MsgTransport`` that ships
+  msgspec_-typed msgs over TCP or UDS.
+- **the OS**: one process per actor, started by a swappable
+  spawn backend.
+
+The property that holds it all together: SC composes *through*
+the layers. A crash in a leaf actor's app task unwinds that
+actor's trio tree, ships across its IPC channel as a typed
+``Error`` msg, and unwinds the parent's trio tree in turn — the
+"SC-transitive supervision protocol" from the README's pitch.
+The whole tree cancels and errors like one big trio program; it
+just happens to be spread across processes.
+
+One actor, one process, one ``trio.run()``
+------------------------------------------
+
+A ``tractor`` "actor" is not a green thread, nor an object with
+a mailbox, nor a coroutine: it's one OS process running one
+:func:`trio.run` whose root task boots the runtime machinery —
+msg loop, RPC task scheduler, IPC server — all embodied by a
+single :class:`tractor.Actor` instance.
+
+.. margin:: Shared nothing
+
+   Processes buy you a real `shared nothing architecture`_: no
+   accidentally-shared mutable state, no GIL contention, and
+   every actor can be inspected (or killed) like any other OS
+   process.
+
+You rarely construct an :class:`~tractor.Actor` yourself; the
+runtime makes exactly one per process and you grab it with
+:func:`tractor.current_actor`:
+
+.. code:: python
+
+    import tractor
+
+    actor = tractor.current_actor()  # NoRuntime if none running
+    print(actor.aid.name)   # str name, need not be unique
+    print(actor.aid.uuid)   # uuid4 str, IS unique
+    print(actor.aid.pid)    # the OS pid
+    print(actor.uid)        # legacy (name, uuid) pair
+
+Identity is carried by the ``Aid`` msg-struct (see
+``tractor.msg.types``): a ``name``/``uuid``/``pid`` triple
+exchanged in the very first "mailbox handshake" whenever two
+actors connect. It's what the registrar stores and what shows up
+in logs and proc-titles. The older ``.uid`` 2-tuple of
+``(name, uuid)`` predates ``Aid`` and is still pervasive across
+the codebase; treat it as the legacy spelling of the same
+identity.
+
+If this smells like the `actor model`_, sure — but as the
+README warns, it probably doesn't look like what you *think* an
+actor model looks like, and that's intentional. Here an "actor"
+is purely a runtime-unit-of-abstraction: process +
+``trio.run()`` + IPC machinery.
+
+IPC: channels, transports, addresses
+------------------------------------
+
+Two connected actors talk through a :class:`tractor.Channel`: a
+duplex, per-peer msg pipe. Each ``Channel`` wraps a
+``MsgTransport`` instance which does the wire work: framing,
+encode/decode and the socket itself. The encoding is msgpack
+(via msgspec_) and *every* msg is an instance of one of the
+runtime's tagged-union :class:`msgspec.Struct` types: the
+``Aid`` handshake, ``Start``/``StartAck`` (RPC init),
+``Started``/``Yield``/``Stop``/``Return`` (the ctx dialog
+phases), ``Error``, etc. There is no raw-bytes mode; the
+msg-spec *is* the protocol, which is exactly what lets payloads
+be type-limited per-context (see ``pld_spec`` in
+:doc:`/guide/context`).
+
+Addresses come in two spellings:
+
+- *unwrapped*: the plain-tuple form you pass to user APIs —
+  ``('127.0.0.1', 1616)`` for tcp, or a
+  ``(<filedir>, <filename>)`` path-pair for uds;
+- *wrapped*: the internal ``TCPAddress``/``UDSAddress`` struct
+  types (plus libp2p-style multiaddr helpers over in
+  ``tractor.discovery``).
+
+You only ever need the tuple form; the runtime wraps and
+unwraps at the boundaries.
+
+TCP: the boring default
+***********************
+
+The default transport (``'tcp'``) binds each actor's IPC server
+to loopback ``('127.0.0.1', <random port>)`` unless told
+otherwise, and is the only choice when your tree spans hosts.
+Nothing exotic: ``trio`` TCP streams + length-prefixed msgpack
+framing.
+
+UDS: same-host, creds included
+******************************
+
+Pass ``enable_transports=['uds']`` and actors instead talk over
+unix-domain sockets, with socket files placed in the per-user
+runtime dir (``$XDG_RUNTIME_DIR/tractor/`` on linux, the
+``platformdirs`` equivalent elsewhere). Two perks over tcp on a
+single host:
+
+- no ports to fight over; addrs are just file paths,
+- the kernel snitches on your peer for free: the listening side
+  reads the connector's ``pid`` (plus ``uid``/``gid`` on linux)
+  straight off the socket via ``SO_PEERCRED`` /
+  ``LOCAL_PEERPID`` — no extra handshake msgs required B)
+
+.. warning::
+
+   Socket-file lifetime == listening actor lifetime. On
+   listener teardown the runtime ``os.unlink()``\s the socket
+   file immediately, so any *late* connection attempt (say, a
+   sub-actor racing to deregister with a registrar that's
+   already shutting down) fails with ``FileNotFoundError``.
+   And ofc, UDS is same-host only.
+
+Here's a full actor tree run entirely over uds:
+
+.. literalinclude:: ../../examples/uds_transport_actor_tree.py
+   :caption: examples/uds_transport_actor_tree.py
+   :language: python
+
+Picking a transport
+*******************
+
+Transport choice is per-actor via the ``enable_transports``
+kwarg accepted by :func:`tractor.open_root_actor` (and proxied
+through ``open_nursery()`` when it implicitly boots the
+runtime), plus per-child via
+``ActorNursery.start_actor(enable_transports=...)``. Two rules
+the runtime enforces today:
+
+- exactly ONE transport per actor: multi-transport actors are
+  on the roadmap but currently raise ``RuntimeError``;
+- your ``registry_addrs`` protos must all be in
+  ``enable_transports``: mismatches fail fast with
+  ``ValueError`` instead of (as in darker times) hanging the
+  registrar handshake forever.
+
+Spawn backends
+--------------
+
+How does an actor actually *become* a process? Via a swappable
+spawn backend, selected with the ``start_method`` kwarg to
+:func:`tractor.open_root_actor`:
+
+``'trio'`` (default)
+   The home-grown spawner: re-exec the child as
+   ``python -m tractor._child`` using ``trio``'s subprocess
+   machinery, then bootstrap it over the first IPC exchange
+   (the parent ships a ``SpawnSpec`` msg carrying all init
+   state). Supported on all platforms and the most battle
+   tested choice by far.
+
+``'mp_spawn'`` / ``'mp_forkserver'``
+   The stdlib :mod:`multiprocessing` start-methods of the same
+   names (forkserver is posix-only). Mostly interesting for
+   ecosystem compat and start-up-latency tuning.
+
+``'subint'`` (in development, py3.14+)
+   On the roadmap (not yet selectable via ``start_method`` on
+   this release): run each actor as a `PEP 734`_
+   sub-interpreter (``concurrent.interpreters``) driven on its
+   own OS thread *inside the parent process* — interpreter-level
+   shared-nothing isolation with much faster start-up. Yes, this
+   bends the one-actor-one-process rule; the rest of the model
+   is unchanged.
+
+The ``TRACTOR_SPAWN_METHOD`` env-var beats any caller-passed
+``start_method``, so you can swap backends under an unmodified
+app:
+
+.. code:: bash
+
+    TRACTOR_SPAWN_METHOD=mp_forkserver python my_app.py
+
+One current limitation worth knowing: ``debug_mode=True`` (the
+crash-to-REPL machinery) is only supported on backends whose
+child-side runtime is trio-native, e.g. the default ``'trio'``;
+see :doc:`/guide/debugging` for the deats.
+
+The registrar
+-------------
+
+Discovery needs a phonebook. Every actor, as part of boot,
+registers its ``Aid`` and bind-addrs with the *registrar*: an
+otherwise ordinary actor (a :class:`tractor.Registrar`, subtype
+of :class:`~tractor.Actor`) that keeps the name -> addrs table
+for the tree; on graceful exit each actor de-registers itself.
+
+.. margin:: Default registry addrs
+
+   With no ``registry_addrs`` passed:
+
+   - tcp: ``('127.0.0.1', 1616)``
+   - uds: ``registry@1616.sock``
+     in the runtime dir
+
+Who *is* the registrar? Decided at root boot, rendezvous style.
+:func:`tractor.open_root_actor` probes each addr in
+``registry_addrs`` with a quick connect-ping, then:
+
+- **somebody answered**: this root is a plain actor; it
+  registers with the existing registrar and binds random
+  same-proto addrs for its own IPC server;
+- **nobody answered**: this root *becomes* the registrar and
+  binds the registry addrs itself.
+
+So single-program trees need zero config — the root quietly
+self-appoints — while multi-program setups share a registrar by
+pointing every program at the same ``registry_addrs``. Pass
+``ensure_registry=True`` to demand that *this* call create the
+registry; it raises if the addrs are already served.
+
+The lookup APIs — :func:`tractor.find_actor`,
+:func:`tractor.wait_for_actor`, :func:`tractor.query_actor` and
+:func:`tractor.get_registry` — all consult it (after first
+checking already-connected peers):
+
+.. literalinclude:: ../../examples/service_daemon_discovery.py
+   :caption: examples/service_daemon_discovery.py
+   :language: python
+
+If you bump into "arbiter" in old issues or posts: that's the
+legacy name for the same thing, surviving in-code only as the
+``Arbiter = Registrar`` class alias; all current terminology is
+"registrar"/"registry". Fair warning per the README: this is
+still a **very naive** discovery sys (no re-election, no gossip
+protocol... yet) and a registrar is expected to outlive its
+registrants.
+
+Runtime env vars
+----------------
+
+A few env-vars let you re-tune a whole tree *without touching
+app code*; each wins over its corresponding kwarg:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 30 44 26
+
+   * - env-var
+     - effect
+     - vs. kwarg
+   * - ``TRACTOR_LOGLEVEL``
+     - crank (or silence) console-log verbosity for every actor
+       in the tree
+     - beats ``loglevel``
+   * - ``TRACTOR_SPAWN_METHOD``
+     - swap the process spawn backend
+     - beats ``start_method``
+   * - ``TRACTOR_ENABLE_STACKSCOPE``
+     - install the ``SIGUSR1`` task-tree-dump handler in every
+       actor, even outside ``debug_mode`` (see
+       :doc:`/guide/debugging`)
+     - OR'd with ``enable_stack_on_sig``
+
+Spotting actors from your shell
+*******************************
+
+Every sub-actor sets an OS-level proc-title of the form
+``_subactor[<name>@<pid>]`` (via ``setproctitle``, silently
+skipped when not installed) so ``ps``/``htop``/``pstree`` show
+*which actor is which* at a glance. The README's signature
+incantation — watch a tree build and self-destruct live:
+
+.. code:: bash
+
+    $TERM -e watch -n 0.1 "pstree -a $$" \
+        & python examples/nested_actor_tree.py \
+        && kill $!
+
+For scripting there are two stable cmdline markers:
+
+.. code:: bash
+
+    pgrep -fa '_subactor\['     # live, titled sub-actors
+    pgrep -fa 'tractor._child'  # 'trio'-backend children not
+                                # yet (re)titled
+
+The title also lands in the kernel ``comm`` (truncated to ~15
+bytes) which survives into zombie state — that's what
+``tractor``'s own test-harness reapers key off. To be crystal
+clear about the contract though: you should never *need* a
+reaper; if you can create zombie child processes (without using
+a system signal) it **is a bug** — please report it!
+
+Logging
+-------
+
+The runtime logs through a thin adapter over stdlib
+:mod:`logging` that stamps every record with actor + task info.
+Two calls get you going:
+
+.. code:: python
+
+    from tractor.log import get_console_log, get_logger
+
+    log = get_logger(__name__)  # actor/task-aware sub-logger
+    get_console_log('info')     # attach console handler @ level
+
+(or just pass ``loglevel='info'`` to
+:func:`tractor.open_root_actor` and the console handler comes up
+with the runtime).
+
+``tractor`` adds custom levels — and matching logger methods —
+that slot between the stdlib ones so you can dial in *which
+runtime subsystem* you want to hear from: ``.transport()`` (5),
+``.runtime()`` (15), ``.devx()`` (17), ``.cancel()`` (22), plus
+a ``PDB`` (500) level for debugger chatter. E.g.
+``loglevel='cancel'`` plays the whole cancellation chorus while
+staying quiet about transport-layer noise. Beyond that
+``tractor`` isn't opinionated about how you consume logs: it's
+all stdlib ``logging`` underneath.
+
+Where to next?
+--------------
+
+.. seealso::
+
+   - :doc:`/guide/context` — the SC-linked cross-actor task API
+     that rides on every ``Channel``.
+   - :doc:`/guide/debugging` — ``debug_mode``, the multi-process
+     REPL and ``stackscope`` task-tree dumps.
+   - :doc:`/explain/sc-distributed` — *why*
+     one-actor-one-process, and what kind of "actor model" this
+     is (and isn't).
+
+.. _structured concurrency: https://en.wikipedia.org/wiki/Structured_concurrency
+.. _trio: https://github.com/python-trio/trio
+.. _actor model: https://en.wikipedia.org/wiki/Actor_model
+.. _shared nothing architecture: https://en.wikipedia.org/wiki/Shared-nothing_architecture
+.. _msgspec: https://jcristharif.com/msgspec/
+.. _PEP 734: https://peps.python.org/pep-0734/

docs/explain/index.rst

@@ -0,0 +1,16 @@
+Big ideas
+=========
+The conceptual core of ``tractor``: what *structured
+concurrency* (SC) means once your "tasks" are whole
+processes, and how the runtime is layered to deliver
+that without (much) magic.
+
+If you only read one page in these docs make it
+:doc:`sc-distributed`; if you read two, follow it with
+:doc:`architecture`.
+
+.. toctree::
+   :maxdepth: 2
+
+   sc-distributed
+   architecture

docs/explain/sc-distributed.rst

@@ -0,0 +1,221 @@
+Structured concurrency, across processes
+=========================================
+``tractor`` makes one bet: the discipline that made
+``trio``'s concurrency *readable* — `structured
+concurrency`_ (SC) — works just as well when the
+"tasks" are whole OS processes talking over a wire.
+This page distills what that means, from first
+principles, with as little ceremony as possible.
+
+.. margin:: The canon
+
+   If SC is new to you, the seminal `blog post`_ is
+   still the best hour you'll spend on concurrent
+   programming; the `trio docs`_, wikipedia's SC_
+   page and the diagrams over at libdill-docs_ round
+   it out nicely.
+
+SC in one breath
+----------------
+Structured concurrency is the rule that **concurrency
+gets a scope**: every task is spawned *inside* a block
+(a ``trio`` *nursery*) and that block **cannot exit
+until every task it spawned has finished** — returned,
+errored, or been cancelled.
+
+That one rule buys you the properties you already
+rely on in sequential code,
+
+- a function call is a *black box*: when it returns,
+  everything it started is **done** — no secret
+  background tasks leaking out the sides,
+- an exception **always has somewhere to go**: up the
+  (task) tree to a parent which is, by construction,
+  still there waiting,
+- cancellation has a well defined *shape*: cancel a
+  scope and it flows down to every task inside it,
+  and only those.
+
+In short: your **runtime task tree matches your source
+code's indentation**. Concurrency you can read.
+
+The leap: process-shaped tasks
+------------------------------
+Now swap "task" for "process".
+
+A ``tractor`` *actor* is just a Python process running
+its own ``trio.run()`` — its own private task tree,
+sharing **nothing** with its siblings. You spawn
+actors from an :class:`tractor.ActorNursery`, which
+behaves exactly the way the name implies,
+
+.. code:: python
+
+    async with tractor.open_nursery() as an:
+        portal = await an.start_actor(
+            'worker',
+            enable_modules=[__name__],
+        )
+        ...
+    # ^ block exit == every spawned process has
+    # completed, errored or been cancelled, and
+    # been **reaped**. No exceptions, no zombies.
+
+so the whole program becomes a *tree of process-trees*
+— a `supervision tree`_ in erlang-speak — where every
+arrow means "spawned by, **waited on by**, and
+supervised by".
+
+.. d2:: diagrams/actor_tree.d2
+   :caption: A ``tractor`` program: a process tree of
+       ``trio`` task trees; every parent **must wait**
+       on its children.
+   :width: 85%
+
+Causality: no process outlives its parent
+-----------------------------------------
+The stdlib's ``multiprocessing`` (and most "job
+queue" systems) treat child processes as
+fire-and-forget by default: orphans, zombies, lost
+tracebacks and ``kill -9`` cleanup scripts are *your*
+problem. ``tractor`` instead inherits ``trio``'s
+`causality`_ discipline,
+
+- **no spawning willy-nilly**: every actor is born
+  from a nursery block with a known parent,
+- **lifetimes nest**: a sub-actor's entire process
+  tree lives strictly inside its parent's nursery
+  scope,
+- **teardown is guaranteed**: when a scope exits (or
+  errors, or is cancelled) the runtime SIGINTs,
+  waits, and (only if it must) hard-kills + reaps
+  everything underneath.
+
+We take the zombie thing personally: *if you can
+create orphaned child processes without using a
+system signal, it* **is a bug** — and there's a test
+suite to back that sentence up.
+
+Errors always propagate (yes, across the wire)
+----------------------------------------------
+In ``trio``, an exception in any task tears through
+its nursery to a parent that must handle it —
+`exceptions always propagate`_. ``tractor`` extends
+the same guarantee across process boundaries: an
+uncaught error in a remote task is
+
+1. captured + serialized in the child,
+2. shipped home over IPC as a typed ``Error`` msg,
+3. re-raised in the parent **boxed** as a
+   :class:`tractor.RemoteActorError` carrying the
+   original type (``.boxed_type``), a rendered remote
+   traceback, and the erroring actor's id,
+
+while the supervising nursery applies its (currently
+*one-cancels-all*, just like ``trio``) strategy to any
+sibling actors. A crash three processes deep arrives
+at your shell as one coherent, causal traceback chain
+— not a silent dead worker and a stuck queue.
+
+Cancellation is a request, supervision is the rule
+--------------------------------------------------
+Cancellation likewise keeps ``trio``'s semantics
+*verbatim*, just transported: cancelling an actor
+nursery (or a single :class:`tractor.Context` between
+two tasks in different processes) sends an explicit
+cancel **request** over IPC which the remote runtime
+translates into a real ``trio`` cancel-scope cancel —
+then *acks back* so the requester can await
+confirmation within a bounded time. Nothing is ever
+"just killed" first; graceful always precedes brutal.
+
+Because every cross-process dialog is a pair of
+**linked tasks** — one on each side, each inside its
+own cancel scope — SC stays *transitive*: supervision
+doesn't stop at the process boundary, it tunnels
+through every hop of the tree. The wire protocol that
+enforces this (a small set of typed msgs:
+``Start``/``Started``/``Yield``/``Stop``/``Return``/
+``Error``) is detailed in :doc:`/guide/msging` and
+:doc:`/guide/context`.
+
+Hold up, is this an "actor model"?
+----------------------------------
+Let's stop and ask how many canon actor model papers
+you've actually read ;)
+
+From our experience many "actor systems" aren't really
+"actor models" since they **don't adhere** to the `3
+axioms`_ and pay even less attention to the problem of
+`unbounded non-determinism`_ — which was the whole
+point for creating the model in the first place.
+
+From `the author's mouth`_, the **only** requirement
+is `adherence to`_ the `3 axioms`_::
+
+    In response to a message, an actor may:
+
+    - send a finite number of new messages
+    - create a finite number of new actors
+    - designate a new behavior to process subsequent
+      messages
+
+Want to debate whether that makes us a "real" actor
+model? Chime in on our chat, or on one of these issues
+*after you've read everything in them* ;)
+
+- `#210 <https://github.com/goodboy/tractor/issues/210>`_
+- `#18 <https://github.com/goodboy/tractor/issues/18>`_
+
+``tractor`` adheres — actors exchange msgs, spawn
+actors, and swap behaviors — **with no extra API** to
+learn. What we *don't* copy is the cultural baggage:
+no visible mailboxes, no untyped fire-and-forget
+``send()``, no "let it crash" without a supervisor
+that actually hears about it, and definitely no
+shared-reference *proxy objects* pretending the
+network isn't there. If our "actors" don't look like
+what you expected, that's **intentional**: being an
+actor model is just one property of the system; being
+*structured* is the point.
+
+Why processes at all?
+---------------------
+Python has a GIL; an actor model by definition shares
+no state; so the *process* is the natural runtime
+unit — you get real multi-core parallelism and hard
+memory isolation for free. But the deeper win is
+uniformity: because actors only ever talk via msgs
+over a :class:`tractor.Channel` (TCP, UDS, more to
+come), the **same code** runs your laptop's worker
+pool and a multi-host cluster; "distributed" is a
+deployment detail, not an API.
+
+It's just ``trio``
+------------------
+If you remember one framing, make it this: ``tractor``
+**is just** ``trio`` — with nurseries that can spawn
+processes and streams that can cross them. Same
+nursery discipline, same cancellation semantics, same
+"how was this not always the API?" feeling, one level
+up the process tree.
+
+.. seealso::
+
+   :doc:`/explain/architecture` for how the runtime
+   layers deliver all of the above, and
+   :doc:`/start/quickstart` to feel it in ~20 lines of
+   code.
+
+.. _structured concurrency: https://en.wikipedia.org/wiki/Structured_concurrency
+.. _SC: https://en.wikipedia.org/wiki/Structured_concurrency
+.. _blog post: https://vorpus.org/blog/notes-on-structured-concurrency-or-go-statement-considered-harmful/
+.. _trio docs: https://trio.readthedocs.io/en/latest/
+.. _libdill-docs: https://sustrik.github.io/libdill/structured-concurrency.html
+.. _supervision tree: https://www.erlang.org/doc/design_principles/des_princ.html
+.. _causality: https://vorpus.org/blog/some-thoughts-on-asynchronous-api-design-in-a-post-asyncawait-world/#c-c-c-c-causality-breaker
+.. _exceptions always propagate: https://trio.readthedocs.io/en/latest/design.html#exceptions-always-propagate
+.. _the author's mouth: https://www.youtube.com/watch?v=7erJ1DV_Tlo&t=162s
+.. _adherence to: https://www.youtube.com/watch?v=7erJ1DV_Tlo&t=1821s
+.. _3 axioms: https://en.wikipedia.org/wiki/Actor_model#Fundamental_concepts
+.. _unbounded non-determinism: https://en.wikipedia.org/wiki/Unbounded_nondeterminism

docs/guide/asyncio.rst

@@ -0,0 +1,309 @@
+Infected ``asyncio``
+====================
+``tractor`` is "just trio_", but the Python world is packed with
+libraries that only speak ``asyncio``: websocket stacks, vendor
+SDKs, that one exchange client you can't route around. Rather than
+make you rewrite them, ``tractor`` lets you *quarantine* them inside
+a dedicated subactor which runs both event loops at once, with full
+`structured concurrency`_ (SC) guarantees maintained across the
+loop boundary *and* the process tree.
+
+In the project's own words:
+
+    Yes, we spawn a python process, run ``asyncio``, start ``trio``
+    on the ``asyncio`` loop, then send commands to the ``trio``
+    scheduled tasks to tell ``asyncio`` tasks what to do XD
+
+We call this "infected ``asyncio``" mode: the subactor's stdlib
+loop runs as the *host* with ``trio`` embedded on top in `guest`_
+mode, and your ``trio`` tasks drive ``asyncio`` tasks through
+a linked, SC-supervised, in-memory channel.
+
+.. d2:: diagrams/infected_aio.d2
+   :caption: One process, two schedulers: ``trio`` rides the
+       ``asyncio`` loop as a guest while the parent speaks plain
+       ``tractor`` IPC, none the wiser.
+   :alt: parent actor connected over IPC to a subactor whose
+       asyncio loop hosts trio in guest mode, with a
+       LinkedTaskChannel pairing a trio task to an asyncio task
+
+.. note::
+
+   Infected ``asyncio`` mode is **experimental**: it works (we
+   beat on it plenty) but parts of the API surface and some
+   edge-case semantics are still settling. Got opinions on the
+   interop design? Feel free to sling them in `#273`_!
+
+How the infection takes hold
+----------------------------
+A normal subactor boots by running the ``tractor`` runtime's task
+tree directly under ``trio.run()``. Pass ``infect_asyncio=True``
+at spawn time and the child's entrypoint changes shape entirely:
+
+1. the process starts the stdlib loop via ``asyncio.run()``,
+2. the first ``asyncio`` task calls
+   ``trio.lowlevel.start_guest_run()``, embedding the ``trio``
+   scheduler *inside* the already running ``asyncio`` loop (the
+   upstream `guest`_-mode feature),
+3. the regular ``tractor`` runtime then boots on the guest
+   ``trio`` side and connects back to its parent like any other
+   subactor.
+
+.. margin:: Symptoms
+
+   Looks like your stdlib event loop has caught a case of "the
+   trios"! Don't worry, you'll barely notice; and if anything
+   gets too bad, your parents will know about it B)
+
+Both schedulers interleave in a single thread, no GIL gymnastics
+required. From the rest of the actor tree the infected child is
+indistinguishable from any other actor: same IPC protocol, same
+supervision and cancellation semantics, same zombie-safety
+guarantees. The difference is purely internal: ``trio`` tasks in
+that process can start and drive ``asyncio`` tasks through the
+``tractor.to_asyncio`` API.
+
+Spawning an infected subactor
+-----------------------------
+Just flip the flag on :meth:`tractor.ActorNursery.start_actor`:
+
+.. code:: python
+
+    async with tractor.open_nursery() as an:
+        portal = await an.start_actor(
+            'aio_side',
+            enable_modules=[__name__],
+            infect_asyncio=True,
+        )
+
+The one-shot convenience ``ActorNursery.run_in_actor()`` accepts
+the same flag. The ``to_asyncio`` APIs may **only** be called from
+tasks inside an infected actor; calling them anywhere else raises
+a loud ``RuntimeError``. You can introspect at runtime with
+``tractor.current_actor().is_infected_aio()``.
+
+Linking tasks with ``open_channel_from()``
+------------------------------------------
+The core primitive is :func:`tractor.to_asyncio.open_channel_from`,
+an async context manager which starts your ``asyncio`` function as
+a real ``asyncio.Task`` and yields a two-way channel linking it to
+the calling ``trio`` task:
+
+.. code:: python
+
+    from tractor import to_asyncio
+
+    async with to_asyncio.open_channel_from(
+        aio_main,        # async def aio_main(chan, **kwargs)
+        period=0.5,      # extra kwargs are passed through
+    ) as (chan, first):
+        await chan.send('tick')
+
+The semantics deliberately mirror the inter-actor ``Context``
+handshake from :doc:`/guide/context`:
+
+- the target fn must declare a parameter literally named ``chan``;
+  the runtime injects the shared
+  :class:`~tractor.to_asyncio.LinkedTaskChannel` by keyword.
+- the ``trio`` side blocks at entry until the ``asyncio`` task
+  calls ``chan.started_nowait(value)``; that value is delivered as
+  ``first``, exactly like the ``(ctx, first)`` pair you get from
+  ``Portal.open_context()`` after the child calls
+  ``ctx.started()``.
+- a first value **must** be sent from the ``asyncio`` side or the
+  ``trio`` side will never unblock.
+- on block exit the pair is torn down *together*; neither task can
+  outlive the other (more on this below).
+
+A full example: the echo server
+-------------------------------
+Here's the canonical demo, a round-trip echo service where the
+``asyncio`` task is told what to do by a ``trio`` task which is in
+turn driven over IPC by the root actor:
+
+.. literalinclude:: ../../examples/infected_asyncio_echo_server.py
+   :caption: examples/infected_asyncio_echo_server.py
+   :language: python
+
+What's going on?
+
+- there are three task layers: the root actor's pure ``trio``
+  task, the infected child's ``trio``-side ``@tractor.context``
+  endpoint (``trio_to_aio_echo_server()``), and the child's
+  ``asyncio`` task (``aio_echo_server()``).
+- two ``started``-style handshakes compose: the aio task's
+  ``chan.started_nowait('start')`` unblocks the child's
+  ``open_channel_from()`` entry, then the child relays that same
+  value up via ``await ctx.started(first)`` which unblocks the
+  root's ``open_context()`` entry. Synchronization all the way
+  down, er, up.
+- each round trip flows: root ``stream.send()`` -> IPC -> child
+  ``async for msg in stream`` -> ``chan.send(msg)`` -> aio
+  ``await chan.get()`` -> ``chan.send_nowait()`` -> child
+  ``chan.receive()`` -> ``stream.send(out)`` -> IPC -> root.
+- when the root breaks out of its stream loop and exits the
+  context block, the child's stream ends, its channel block exits,
+  and the ``asyncio`` task is reaped along with it; the final
+  ``portal.cancel_actor()`` then tears down the whole process. No
+  orphaned ``asyncio`` tasks, no zombie procs; if you manage to
+  create either it **is a bug**.
+
+``LinkedTaskChannel``: one channel, two sides
+---------------------------------------------
+The same channel object is shared by both tasks; which methods you
+call depends on which loop schedules your task. The ``trio`` side
+gets a standard ``trio.abc.Channel`` interface while the
+``asyncio`` side gets queue-flavored, mostly-sync methods:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 14 36 50
+
+   * - side
+     - call
+     - what it does
+   * - ``trio``
+     - ``await chan.send(item)``
+     - ship ``item`` to the ``asyncio`` task (enqueues onto an
+       internal ``asyncio.Queue``).
+   * - ``trio``
+     - ``await chan.receive()``
+     - wait for the next value from the ``asyncio`` side; the
+       channel also supports ``async for``.
+   * - ``trio``
+     - ``await chan.wait_for_result()``
+     - block until the ``asyncio`` task completes; return its
+       final result or raise its (translated) error.
+   * - ``trio``
+     - ``chan.subscribe()``
+     - acm yielding a ``BroadcastReceiver`` so N local tasks can
+       each consume a copy of the inbound stream (see below).
+   * - ``trio``
+     - ``chan.cancel_asyncio_task()``
+     - explicitly request cancellation of the linked ``asyncio``
+       task.
+   * - ``asyncio``
+     - ``chan.started_nowait(value)``
+     - deliver the "first" value; unblocks the ``trio`` side's
+       ``open_channel_from()`` entry (mirrors ``ctx.started()``).
+   * - ``asyncio``
+     - ``await chan.get()``
+     - wait for the next value sent from the ``trio`` side.
+   * - ``asyncio``
+     - ``chan.send_nowait(item)``
+     - push a value to the ``trio`` side without blocking.
+
+Fan-out with ``.subscribe()``
+*****************************
+Just like :meth:`tractor.MsgStream.subscribe` does for IPC
+streams, ``chan.subscribe()`` lets multiple local ``trio`` tasks
+each receive *every* value sent from the single ``asyncio`` task:
+
+.. code:: python
+
+    async with chan.subscribe() as bcast:
+        async for msg in bcast:
+            ...
+
+The underlying broadcast machinery is lazily allocated on first
+use and is *not* reversible for the channel's remaining lifetime,
+so only reach for it when you actually want the fan-out.
+
+One-shot calls with ``run_task()``
+----------------------------------
+When you just want a single ``asyncio`` result and no streaming
+dialog, skip the channel ceremony and use
+:func:`tractor.to_asyncio.run_task`:
+
+.. code:: python
+
+    import asyncio
+    from tractor import to_asyncio
+
+    async def aio_fetch(url: str) -> str:
+        await asyncio.sleep(0.3)   # pretend-IO, aio style
+        return f'<html>sup {url}</html>'
+
+    # from any trio task inside the infected actor:
+    page = await to_asyncio.run_task(aio_fetch, url='https://x.io')
+
+It schedules the fn as an ``asyncio.Task``, waits for completion
+and hands the return value back to ``trio``; think of it as the
+cross-loop sibling of ``ActorNursery.run_in_actor()``. Errors and
+cancellation are translated exactly as for channels.
+
+Cross-loop errors and cancellation
+----------------------------------
+The paired tasks are *SC linked*: exception and cancel handling
+tears down **both** sides on any unexpected error or cancellation,
+in either loop. There is no fire-and-forget mode; a
+``LinkedTaskChannel`` is a supervision scope just like a
+``Context`` is across processes.
+
+Because each loop has its own (incompatible) cancellation and exit
+machinery, boundary crossings are translated into dedicated
+exception types, all importable from ``tractor.to_asyncio``:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 26 22 52
+
+   * - exception
+     - raised in
+     - meaning
+   * - ``AsyncioCancelled``
+     - the ``trio`` task
+     - the linked ``asyncio`` task was cancelled by itself or
+       a 3rd party (i.e. *not* by the ``trio`` side).
+   * - ``AsyncioTaskExited``
+     - the ``trio`` task
+     - the ``asyncio`` task returned/exited early while the
+       ``trio`` side still held the link open.
+   * - ``TrioCancelled``
+     - the ``asyncio`` task
+     - the ``trio`` side was cancelled (or crashed) so the
+       ``asyncio`` task is being torn down per SC rules.
+   * - ``TrioTaskExited``
+     - the ``asyncio`` task
+     - the ``trio`` side exited gracefully while the ``asyncio``
+       task was still running; a "clean shutdown" signal much
+       like closing a ``trio`` mem-chan.
+
+By default ``open_channel_from(suppress_graceful_exits=True)``
+absorbs the two ``*TaskExited`` signals so happy-path teardown
+stays silent; pass ``False`` when your app wants to handle early
+peer-exit explicitly.
+
+Past the task pair, everything composes with the normal actor
+story: an unhandled ``asyncio`` error is translated into the
+``trio`` side, propagates out of your ``@tractor.context``
+endpoint, and arrives at the parent boxed as
+a :class:`tractor.RemoteActorError`. One SC discipline,
+end-to-end, across loops *and* processes.
+
+Breakpoints in ``asyncio`` tasks
+--------------------------------
+Yes, the multi-actor REPL works here too. With
+``debug_mode=True`` enabled on your tree the ``trio`` side of an
+infected actor can ``await tractor.pause()`` as usual, and with
+greenback enabled (``maybe_enable_greenback=True``) even the
+builtin ``breakpoint()`` works from *inside* ``asyncio`` tasks;
+see ``examples/debugging/asyncio_bp.py`` for the full tour. The
+root-TTY locking dance behind all this is covered in
+:doc:`/guide/debugging`.
+
+Where to next?
+--------------
+.. seealso::
+
+   - :doc:`/guide/context` for the inter-actor handshake and
+     streaming APIs which this whole interop layer mirrors.
+   - :doc:`/guide/msging` for typing the payloads you shuttle
+     between actors (and loops).
+   - :doc:`/guide/debugging` for the multi-process REPL that
+     keeps working even when your loop has "the trios".
+
+.. _trio: https://github.com/python-trio/trio
+.. _structured concurrency: https://en.wikipedia.org/wiki/Structured_concurrency
+.. _guest: https://trio.readthedocs.io/en/stable/reference-lowlevel.html?highlight=guest%20mode#using-guest-mode-to-run-trio-on-top-of-other-event-loops
+.. _#273: https://github.com/goodboy/tractor/issues/273

docs/guide/cancellation.rst

@@ -0,0 +1,285 @@
+Cancellation and error propagation
+==================================
+
+``tractor`` supports ``trio``'s cancellation_ system *verbatim*,
+then extends it across process boundaries. If you know how to
+cancel a task in ``trio`` you already know how to cancel an actor —
+and its whole subtree — in ``tractor``; the runtime's job is making
+that statement hold over IPC with every structured concurrency (SC)
+guarantee intact.
+
+The ground rules,
+
+- a remote actor is **never** cancelled unless explicitly requested
+  (by a parent or peer), unless supervision demands it (an error
+  triggered one-cancels-all teardown), or unless there's a bug in
+  ``tractor`` itself (please report it!),
+- (remote) errors `always propagate`_ back to the parent
+  supervisor; nothing is silently dropped on the floor,
+- every spawned process gets reaped no matter how it dies; if you
+  can create a zombie child process (without using a system signal)
+  it **is a bug**.
+
+``trio`` cancellation, across the wire
+--------------------------------------
+
+Locally everything is bog-standard ``trio``: nurseries, cancel
+scopes, timeouts. ``tractor`` adds exactly one twist: a cancel
+scope can't physically reach into another process, so the runtime
+*relays cancellation as messages*. Concretely,
+
+- cancelling an *actor* means sending it a runtime-cancel request
+  msg; the target then runs its own graceful teardown — cancelling
+  RPC tasks, closing channels, exiting its :func:`trio.run` — and
+  acks the request back to the canceller,
+- cancelling a single *cross-actor task* works through the
+  :class:`tractor.Context` layer: each ``ctx`` task-pair is
+  cancel-scope-linked over IPC such that either side erroring or
+  cancelling relays an equivalent error to the other side (see
+  :doc:`/guide/context` for the gory details),
+- a cancel is therefore always a *request with an ack*: the
+  canceller does a **bounded wait** for confirmation and escalates
+  if the peer is unresponsive (see the teardown ladder below).
+
+One-cancels-all supervision
+---------------------------
+
+An :class:`tractor.ActorNursery` supervises subactors `exactly like
+trio`_ nurseries supervise tasks: when one child errors, the error
+propagates to the supervising block and **all** sibling subactors
+get cancelled before the error continues bubbling up the (process)
+tree.
+
+.. d2:: diagrams/error_propagation.d2
+   :caption: One-cancels-all: no zombies, no lost errors.
+   :alt: error propagation up a subactor tree
+   :width: 80%
+
+.. literalinclude:: ../../examples/remote_error_propagation.py
+   :caption: examples/remote_error_propagation.py
+   :language: python
+
+What's going on here?
+
+- three healthy actors are spawned as daemons via
+  :meth:`tractor.ActorNursery.start_actor`; left alone they'd
+  happily idle forever,
+- a fourth actor runs ``assert_err()`` via ``.run_in_actor()`` and
+  promptly trips its ``assert 0``,
+- the resulting ``AssertionError`` ships back over IPC as a
+  serialized error msg and re-raises *boxed* inside the nursery
+  block as a :class:`tractor.RemoteActorError`,
+- the nursery reacts like any ``trio`` nursery would: it cancels
+  the three healthy siblings (graceful runtime-cancel requests,
+  acks awaited), reaps all four processes, then re-raises,
+- ``trio.run(main)`` sees that same ``RemoteActorError`` in the
+  parent-most process — propagation is end-to-end or bust.
+
+This one-cancels-all style is currently the *only* supervision
+strategy offered (it's the one ``trio`` gives you); more
+`erlang strategies`_ are roadmap, see the bottom of this page.
+
+The boxed-error bestiary
+------------------------
+
+All remote failures arrive locally as one of a small set of
+exception types, each carrying enough metadata to work out *who*
+failed, *where*, and *why*.
+
+``RemoteActorError``
+********************
+
+The workhorse: a "boxed" exception relayed over IPC from another
+actor. The original error's type, traceback string and msgdata are
+preserved so you can pattern-match on what actually went wrong
+remotely,
+
+- ``.boxed_type``: the reconstructed **type** of the original
+  remote exception (``ValueError``, ``NameError``, what have you),
+- ``.src_uid``: the ``(name, uuid)`` pair of the actor where the
+  error *originated*,
+- ``.relay_uid`` / ``.relay_path``: when an error crosses more than
+  one actor boundary (grandchild -> child -> root) every relaying
+  actor is recorded; multi-hop boxings are lovingly referred to as
+  "inceptions" in the runtime internals,
+- ``.pformat()``: a rich "tb box" rendering of the remote traceback
+  for your logs or REPL.
+
+.. code:: python
+
+    try:
+        async with portal.open_context(ep) as (ctx, first):
+            ...
+    except tractor.RemoteActorError as rae:
+        if rae.boxed_type is ValueError:
+            ...  # the remote task raised `ValueError`
+
+``ContextCancelled``
+********************
+
+The cancel-ack for a cross-actor task pair: raised when a
+:class:`tractor.Context` task is cancelled *by request*. Its
+``.canceller`` attr is the uid of the actor which **requested** the
+cancel, which powers the key rule,
+
+- if **you** requested it (you called
+  :meth:`tractor.Context.cancel`) the resulting ctxc is *absorbed*
+  at ``open_context()`` exit: an expected outcome, not an error,
+- if **anyone else** did — the peer task, or some third-party actor
+  — it *raises* locally so your code always hears about it.
+
+The full self- vs. cross-cancel semantics are a core teaching point
+of :doc:`/guide/context`; go read them there.
+
+``MsgTypeError``
+****************
+
+An IPC-payload "type error": a msg violated the dialog's declared
+payload spec. See :doc:`/guide/msging` for the typed-messaging
+system which enforces it.
+
+``TransportClosed``
+*******************
+
+The underlying IPC transport (TCP stream, UDS socket, ...) died or
+closed out from under a channel. You'll normally only see this
+surface when a peer hard-exits without any graceful runtime
+teardown; the supervision machinery treats unexpected transport
+loss on a busy channel as a failure and tears down accordingly.
+
+Pick your blast radius
+----------------------
+
+Three cancel surfaces, three scopes of effect; choose the smallest
+hammer that does the job.
+
+.. list-table::
+   :header-rows: 1
+   :widths: 36 34 30
+
+   * - surface
+     - cancels
+     - typical use
+   * - :meth:`tractor.ActorNursery.cancel`
+     - every subactor in the nursery
+     - whole-tree teardown
+   * - :meth:`tractor.Portal.cancel_actor`
+     - one actor: full runtime + proc
+     - daemon teardown
+   * - :meth:`tractor.Context.cancel`
+     - exactly one remote task
+     - surgical task cancel
+
+``ActorNursery.cancel()``
+*************************
+
+The big red button: gracefully cancel every subactor supervised by
+the nursery, in parallel, with the escalation discipline below
+applied per-child. It's invoked for you whenever an error hits the
+nursery block (one-cancels-all); call it yourself for an orderly
+early shutdown. Passing ``hard_kill=True`` skips the graceful phase
+and goes straight to OS-level process termination — rarely what you
+want outside tests.
+
+``Portal.cancel_actor()``
+*************************
+
+Cancel one **whole actor**: its entire runtime, every task it's
+scheduled, and (for subactors) the OS process, via a graceful
+runtime-cancel request,
+
+.. code:: python
+
+    await portal.cancel_actor()    # bounded wait, bool result
+    await portal.cancel_actor(
+        raise_on_timeout=True,     # no ack in time?
+    )                              # -> `ActorTooSlowError`
+
+The wait for the peer's ack is *bounded* (default
+``Portal.cancel_timeout = 0.5`` seconds, tunable per call via
+``timeout=``). By default a missed ack just returns ``False``; with
+``raise_on_timeout=True`` you instead get an ``ActorTooSlowError``
+(from ``tractor._exceptions``) so *your* code can escalate per SC
+discipline — exactly what the nursery's own teardown does
+internally before resorting to OS-level signalling.
+
+Note the granularity: this cancels an **actor**, not a task. For
+one remote task use the ``Context`` layer instead.
+
+``Context.cancel()``
+********************
+
+Request cancellation of exactly one remote task: the peer task of
+an open :class:`tractor.Context`. Two things to keep straight,
+
+- it cancels the **remote** side only; a ``Context`` is *not* a
+  :class:`trio.CancelScope` and your local task keeps running until
+  you exit the ``open_context()`` block,
+- the resulting :class:`tractor.ContextCancelled` is absorbed
+  locally (you asked for it, after all) per the self- vs.
+  cross-cancel rule above.
+
+Again, :doc:`/guide/context` covers this dance in depth.
+
+Graceful first, hard as a last resort
+-------------------------------------
+
+.. margin:: REPL-safe by design
+
+   The hard-kill path is *skipped* whenever an actor in the tree
+   holds the debug-REPL lock (``debug_mode=True`` flavors):
+   SIGTERM raining down on a tree mid-``pdb`` session would
+   clobber your prompt. See :doc:`/guide/debugging`.
+
+Every process teardown in ``tractor`` walks the same escalation
+ladder, top rung first,
+
+1. **graceful cancel request**: a runtime-cancel msg over IPC; the
+   target actor cancels its tasks, closes its channels and exits
+   its :func:`trio.run` cleanly,
+2. **soft wait**: the parent waits (bounded) for the child process
+   to exit on its own,
+3. **SIGTERM**: no ack within the bounded wait (internally an
+   ``ActorTooSlowError``) escalates to ``proc.terminate()``,
+4. **SIGKILL ultimatum**: still alive after the hard-kill timeout
+   (~1.6s)? The runtime logs that the "T-800" has been deployed to
+   collect the zombie and issues ``proc.kill()``. No survivors.
+
+The result is the **no-zombies guarantee**: ``tractor`` tries to
+protect you from zombies, no matter what. Quoting the project
+manifesto,
+
+    If you can create zombie child processes (without using
+    a system signal) it **is a bug**.
+
+Run the quickstart's self-destructing process-tree demo
+(``examples/parallelism/we_are_processes.py``, walked through in
+:doc:`/start/quickstart`) under a ``pstree`` watcher and try to
+catch a
+straggler; we'll wait B)
+
+Roadmap: ``erlang``-style strategies
+------------------------------------
+
+One-cancels-all is ``trio``'s strategy and, for now, the only one
+``tractor`` ships. Pluggable `erlang strategies`_ — one-for-one
+restarts, rest-for-one, transient/permanent child specs and friends
+(see the `supervision strategies`_ canon) — are a long-standing
+roadmap item tracked in `#22`_. If supervisors are your jam that
+issue is the place to sling opinions.
+
+.. seealso::
+
+   - :doc:`/guide/context` — the cross-actor task layer where
+     per-task cancellation actually lives,
+   - :doc:`/guide/msging` — the typed msg layer that raises
+     :class:`tractor.MsgTypeError`,
+   - :doc:`/guide/debugging` — what cancellation does (and very
+     carefully does *not* do) while a REPL is up.
+
+.. _cancellation: https://trio.readthedocs.io/en/latest/reference-core.html#cancellation-and-timeouts
+.. _exactly like trio: https://trio.readthedocs.io/en/latest/reference-core.html#cancellation-semantics
+.. _always propagate: https://trio.readthedocs.io/en/latest/design.html#exceptions-always-propagate
+.. _erlang strategies: https://learnyousomeerlang.com/supervisors
+.. _supervision strategies: https://www.erlang.org/doc/system/sup_princ.html
+.. _#22: https://github.com/goodboy/tractor/issues/22

docs/guide/clustering.rst

@@ -0,0 +1,127 @@
+Higher-level cluster APIs
+=========================
+
+Sometimes you don't want a hand-crafted supervision tree; you want
+"a pile of workers, one per core, now please". For that there's
+:func:`tractor.open_actor_cluster`: a convenience wrapper which
+spawns a *flat* cluster of subactors and hands you back a portal to
+each,
+
+.. code:: python
+
+    @acm
+    async def open_actor_cluster(
+        modules: list[str],            # RPC allowlist for workers
+        count: int = cpu_count(),      # one per core by default
+        names: list[str]|None = None,  # default: 'worker_{i}'
+        hard_kill: bool = False,       # fwd to `an.cancel()`
+        **runtime_kwargs,              # fwd to `open_root_actor()`
+    ) -> AsyncGenerator[dict[str, tractor.Portal], None]:
+
+A cluster in one block
+----------------------
+
+.. literalinclude:: ../../examples/quick_cluster.py
+   :caption: examples/quick_cluster.py
+   :language: python
+
+Walkthrough,
+
+- ``open_actor_cluster(modules=[__name__])`` concurrently spawns
+  one subactor per detected core (per
+  :func:`multiprocessing.cpu_count`); the ``modules`` list is the
+  usual ``enable_modules``-style capability allowlist so workers
+  may run functions defined in this module,
+- it yields a ``dict[str, tractor.Portal]`` mapping worker name to
+  portal; note the keys get prefixed with the *spawning* actor's
+  name, so from the root you'll see ``'root.worker_0'``,
+  ``'root.worker_1'``, etc.,
+- a plain :class:`trio.Nursery` then fans out one
+  ``portal.run(sleepy_jane)`` per worker; each prints its actor
+  ``.uid`` from inside its own process then naps forever — what
+  runs *inside* each worker (and how many tasks you point at it)
+  is entirely yours to compose,
+- ``tractor.trionics.collapse_eg()`` un-nests the strict
+  ``ExceptionGroup`` wrapping so the demo's ``KeyboardInterrupt``
+  surfaces as itself instead of arriving eg-boxed,
+- on block exit the whole fleet is torn down for you via
+  :meth:`tractor.ActorNursery.cancel`; pass ``hard_kill=True`` at
+  open time to skip straight to OS-level termination instead of
+  the graceful ladder described in :doc:`/guide/cancellation`.
+
+Sizing, naming, fleet-wide options
+----------------------------------
+
+``count`` doesn't have to be core-count and the auto-generated
+``'worker_{i}'`` names are just the default; pass your own (the
+length must match ``count`` or you get a ``ValueError``). Any
+extra ``**runtime_kwargs`` pass through verbatim to
+:func:`tractor.open_root_actor`, so fleet-wide runtime options are
+one kwarg away,
+
+.. code:: python
+
+    async with tractor.open_actor_cluster(
+        modules=['mylib.workers'],
+        count=4,
+        names=['scout', 'miner', 'smelter', 'smith'],
+        debug_mode=True,    # whole-fleet crash-to-REPL
+    ) as portal_map:
+        ...
+
+From here the composition patterns are the usual ``tractor`` fare:
+``portal.run()`` for one-shot calls (as in the demo), or — for a
+persistent bidirectional dialog per worker — concurrently enter N
+``portal.open_context()`` blocks with
+``tractor.trionics.gather_contexts()``; see :doc:`/guide/context`
+for that whole layer.
+
+Clusters vs. nurseries
+----------------------
+
+.. d2:: diagrams/actor_tree.d2
+   :margin:
+   :caption: The general shape: arbitrary nesting. A cluster is
+       this, minus the nesting.
+   :alt: a nested supervision tree of subactors
+
+``open_actor_cluster()`` is sugar, not a new primitive: under the
+hood it's just :func:`tractor.open_nursery` plus N concurrent
+``start_actor()`` calls plus a ``.cancel()`` on the way out. Reach
+for it when,
+
+- you want a *flat*, homogeneous fleet (classic worker-pool or
+  map-style fan-out shapes),
+- "one per core" — or a fixed ``count`` — is the right sizing
+  story,
+- every child can share the same spawn options.
+
+Drop down to a raw :class:`tractor.ActorNursery` when the topology
+gets any fancier: nested trees, heterogeneous children, per-child
+``debug_mode``/transport/module options, daemons mixed with
+one-shot workers, and so on (see :doc:`/guide/parallelism` for a
+hand-rolled pool). Either way the supervision semantics are
+identical: one-cancels-all error propagation and the no-zombies
+guarantee from :doc:`/guide/cancellation` apply to clusters too.
+
+Provisional, by design
+----------------------
+
+.. note::
+
+   APIs in this section are considered **provisional**: the
+   signature and semantics of :func:`tractor.open_actor_cluster`
+   may shift as higher-level supervision machinery lands. We
+   encourage you to try it and provide feedback — the
+   `matrix channel`_ is the place to say hi, and `#22`_ tracks the
+   broader supervisor-strategy roadmap.
+
+.. seealso::
+
+   - :doc:`/guide/parallelism` — worker pools built "by hand" with
+     plain actor nurseries (and why that's easy peasy),
+   - :doc:`/guide/cancellation` — the teardown machinery a cluster
+     inherits for free.
+
+.. _matrix channel: https://matrix.to/#/!tractor:matrix.org
+.. _#22: https://github.com/goodboy/tractor/issues/22

docs/guide/context.rst

@@ -0,0 +1,344 @@
+The ``Context``: a cross-actor task pair
+=========================================
+
+If you've written any trio_ you already know the contract: every
+task lives in a nursery, errors always propagate, cancellation is
+scoped, and nothing leaks. ``tractor`` extends that exact contract
+*across processes* — the same guarantees from the seminal
+`blog post`_, just with the nursery split across two memory
+domains. The primitive that does it is :class:`tractor.Context`: a
+**linked pair of tasks**, one in each of two actors, supervised as
+a single `structured concurrency`_ (SC) scope over IPC.
+
+.. d2:: diagrams/context_handshake.d2
+   :caption: The SC-transitive supervision protocol, msg by msg.
+   :alt: sequence diagram of the context handshake msg flow
+
+Pretty much everything else is (or is slated to be) built on this
+one primitive: ``ActorNursery.run_in_actor()`` is a convenience
+for "spawn, open a context, await the result, tear down"; plain
+``Portal.run()`` RPC is planned to be re-implemented on top of it;
+the multi-process debugger's tree-wide REPL lock rides one. Grok
+this page and the rest of the library reads as convenience
+wrappers B)
+
+The endpoint contract
+---------------------
+
+A context endpoint is an async function decorated with
+:func:`tractor.context` which declares **a param annotated**
+``tractor.Context`` — any param name you like, the annotation is
+what's required:
+
+.. code:: python
+
+    @tractor.context
+    async def trainer(
+        ctx: tractor.Context,
+        model: str,
+    ) -> str:
+        await ctx.started('ready')
+        return f'trained {model}'
+
+.. margin:: Who am I talking to?
+
+   Inside any context task
+   :func:`tractor.current_ipc_ctx` returns the
+   ``Context`` bound to the current task; handy
+   in helpers that don't take ``ctx`` explicitly.
+
+The parent (aka "opener") side invokes it through a
+:class:`tractor.Portal` using ``Portal.open_context()``, passing
+any extra kwargs which are shipped over the wire as the remote
+task's arguments. Since the target fn is referenced by module
+path, that module must be listed in the peer actor's
+``enable_modules`` allowlist — RPC capability is always opt-in.
+
+The decorator also accepts a ``pld_spec``: a type (union) which
+every payload in the dialog is validated against, upgrading your
+msgs to a typed contract enforced via :exc:`tractor.MsgTypeError`.
+Validation strictness follows the "`cheap or nasty`_"
+`(un)protocol`_ pattern: the one-shot ``Started`` payload gets the
+nasty treatment (stringently round-trip checked before it's even
+sent) while high-rate stream payloads stay cheap (checked only
+receiver side).
+
+The handshake, on the wire
+--------------------------
+
+Every context runs one instance of ``tractor``'s "SC-transitive
+supervision protocol": a tiny fixed grammar of msgspec_-typed msgs
+encapsulating *all* RPC dialogs between actors. *Transitive*
+because each IPC link obeys the same rules a local nursery does —
+starts are acked, completion is awaited, errors and cancels always
+relay — so chaining links across a process tree composes into one
+tree-wide SC scope.
+
+The figure up top shows a full dialog; in order:
+
+``Start``
+    sent by ``Portal.open_context()``: "schedule a task running
+    this function with these kwargs".
+
+``StartAck``
+    the peer runtime confirms the task is scheduled and that the
+    endpoint really is a context-style fn.
+
+``Started``
+    emitted when the child task calls
+    :meth:`tractor.Context.started`; carries the first payload
+    and unblocks the parent's entry of ``open_context()``.
+
+``Yield``
+    one per :meth:`tractor.MsgStream.send`, flowing in *either*
+    direction while a stream is open.
+
+``Stop``
+    graceful end-of-stream: the far side's ``async for``
+    terminates cleanly.
+
+``Return``
+    the child fn returned; its value becomes the context's final
+    result. If the child raised instead, an ``Error`` msg takes
+    this slot carrying the boxed traceback.
+
+``ctx.started()``: just like ``task_status.started()``
+*******************************************************
+
+The startup phase is a deliberate clone of
+:meth:`trio.Nursery.start` semantics: the child decides when it's
+"up", optionally handing back a first value, and the parent stays
+blocked until that moment:
+
+.. code:: python
+
+    # trio, in-process
+    first = await nursery.start(child_fn)
+
+    # tractor, cross-process
+    async with portal.open_context(child_fn) as (ctx, first):
+        ...
+
+The ``as (ctx, first)`` tuple is exactly that pair: the
+:class:`tractor.Context` handle plus whatever value the child
+passed to ``await ctx.started(value)``. And readiness is not
+optional — for instance opening a stream before ``.started()``
+has been called raises a ``RuntimeError``; handshake first, then
+dialog.
+
+Bidirectional streaming over a context
+--------------------------------------
+
+The canonical ping-pong (design history: `#53`_, `#223`_) — a
+full-duplex msg stream between a parent and its spawned peer:
+
+.. literalinclude:: ../../examples/rpc_bidir_streaming.py
+   :caption: examples/rpc_bidir_streaming.py
+   :language: python
+
+What's going on?
+
+- ``start_actor()`` spawns the daemon-style subactor
+  ``'rpc_server'`` with this very module in its allowlist.
+
+- ``portal.open_context(simple_rpc, data=10)`` fires the
+  ``Start`` msg then blocks until the child task calls
+  ``await ctx.started(data + 1)`` — hence ``sent == 11``.
+
+- both tasks enter ``ctx.open_stream()``: a stream dialog is only
+  fully open once *each* side has entered its block.
+
+- the parent seeds the first ``'ping'``; each side then echoes
+  the other, one ``Yield`` msg per ``stream.send()``.
+
+- after the 9th pong the parent ``break``\ s (10 pings sent in
+  total) and exits its stream block, which sends ``Stop``; the
+  child's ``async for`` completes gracefully and its ``else``
+  clause asserts all 10 pings arrived.
+
+- the 10th in-transit pong? Discarded by the implicit drain at
+  ``open_context()`` exit, which runs the dialog down to the
+  child's ``Return`` (here ``None``).
+
+- daemon actors live until told otherwise:
+  ``portal.cancel_actor()`` reaps the subactor explicitly.
+
+Results: the ``Return`` leg
+---------------------------
+
+Every context resolves to a final outcome. Wait on it explicitly
+from the parent side:
+
+.. code:: python
+
+    async with portal.open_context(ep) as (ctx, first):
+        ...
+        result = await ctx.wait_for_result()
+
+or just exit the block — ``__aexit__`` implicitly drains the msg
+flow until the ``Return`` (or ``Error``) arrives, discarding any
+in-transit ``Yield``\ s on the way. Either way the rule of
+`causality`_ holds exactly as in a local nursery: **the opener
+never unblocks before the remote task is done**.
+
+For post-hoc inspection (think supervision/restart logic) the ctx
+also exposes ``Context.outcome``, ``.maybe_error`` and
+``.has_outcome`` — where a "result" might well be the error the
+dialog ended with.
+
+Cancellation semantics
+----------------------
+
+The part you actually came for; read it twice B)
+
+A context's two tasks are **cancel-scope-linked across the IPC
+boundary**: whatever ends one side — error, cancellation, plain
+old return — is relayed such that the other side ends
+equivalently. No silent half-open dialogs, no orphaned remote
+tasks, ever.
+
+``ctx.cancel()`` cancels the *remote* task
+*******************************************
+
+:meth:`tractor.Context.cancel` requests cancellation of the
+**remote** task only:
+
+.. code:: python
+
+    async with portal.open_context(ep) as (ctx, first):
+        await accomplish_things(ctx)
+        await ctx.cancel()  # remote task, NOT me
+
+A :class:`tractor.Context` is **not** a :class:`trio.CancelScope`:
+the call doesn't (and can't) cancel your local task. It sends the
+cancel request and waits a bounded ``timeout`` for the peer
+runtime's ``CancelAck``, then your code proceeds to the block exit
+as normal.
+
+Compare scopes here: ``Portal.cancel_actor()`` is the big hammer
+which cancels the peer's **entire runtime** (and thus process);
+``ctx.cancel()`` is the per-dialog scalpel.
+
+``ContextCancelled`` and the absorption rule
+*********************************************
+
+When a context task gets cancelled *by request* the requestee's
+runtime reports back with a :exc:`tractor.ContextCancelled`
+("ctxc") whose ``.canceller`` field holds the uid of the actor
+which asked. That one field decides what you observe:
+
+**you requested it**
+    i.e. ``ctxc.canceller == tractor.current_actor().uid``: the
+    ctxc is **absorbed** at ``open_context()`` exit — nothing
+    raises in your block. You asked for a graceful stop and got
+    it; if you care, ``await ctx.wait_for_result()`` hands the
+    ctxc back as a plain *value* for inspection.
+
+**anyone else requested it**
+    the peer cancelling itself, or some third actor cancelling it
+    from the side: the ctxc **is raised** in your block. From
+    your scope's perspective a task you depend on was killed out
+    from under you and SC demands you hear about it — exactly
+    like a sibling crash in a `nursery`_.
+
+In code:
+
+.. code:: python
+
+    try:
+        async with portal.open_context(ep) as (ctx, first):
+            ...
+    except tractor.ContextCancelled as ctxc:
+        # can only be a peer- or third-party cancel;
+        # self-requested cancels are absorbed at exit.
+        assert ctxc.canceller != tractor.current_actor().uid
+
+This self- vs cross-cancel split is what makes explicit teardown
+*composable*: a supervisor cancels its dialogs without try/except
+noise, while unexpected cancellation anywhere in the tree still
+propagates loudly like any other failure.
+
+.. warning::
+
+   Once ``ctx.cancel()`` has been called the dialog is done: a
+   subsequent ``ctx.open_stream()`` raises ``RuntimeError``.
+
+For introspection the ctx exposes trio-flavored status props:
+``.cancel_called`` (this side requested), ``.cancel_acked`` (peer
+confirmed), ``.cancelled_caught`` and ``.canceller`` —
+deliberately mirroring :class:`trio.CancelScope` naming.
+
+Errors propagate, both ways
+---------------------------
+
+A crash on either end tears down the pair, SC style:
+
+- **child raises**: the exception ships back as an ``Error`` msg
+  and re-raises in the parent block boxed as a
+  :exc:`tractor.RemoteActorError`; the original class rides along
+  as ``.boxed_type`` with ``.src_uid`` naming the crashed actor.
+
+- **parent raises** (or is cancelled) inside the block: an
+  equivalent error/cancel is relayed to the child task so it can
+  never outlive the dialog.
+
+.. code:: python
+
+    try:
+        async with portal.open_context(ep) as (ctx, first):
+            ...
+    except tractor.RemoteActorError as rae:
+        if rae.boxed_type is ValueError:
+            ...  # remote ValueError, type preserved
+
+Errors that hop through intermediary actors on their way up the
+tree ("inceptions" XD) keep the full relay trail in
+``.relay_uid`` / ``.relay_path``. Payloads violating your declared
+``pld_spec`` surface as the IPC analog of a ``TypeError``:
+:exc:`tractor.MsgTypeError`.
+
+Overruns and backpressure
+-------------------------
+
+Stream msgs land in a bounded per-context buffer on the receiver
+side. A sender that outpaces a non-consuming receiver *overruns*
+it and the runtime raises ``StreamOverrun`` (from
+``tractor._exceptions``; also a :exc:`trio.TooSlowError`) instead
+of buffering without bound — SC discipline applies to memory too.
+
+Your knobs:
+
+- ``msg_buffer_size`` on ``ctx.open_stream()`` sizes the buffer.
+
+- ``allow_overruns=True`` (on ``Portal.open_context()`` and/or
+  ``ctx.open_stream()``) opts in to absorbing overflow instead of
+  erroring — reasonable for bursty telemetry-ish feeds, just know
+  you're trading the error for extra buffering.
+
+One context, one stream
+-----------------------
+
+A ``MsgStream`` is strictly **one-shot use**: once it closes —
+gracefully or not, from either side — it can never be re-opened
+on the same ctx. Want another round with the same peer? Open a
+fresh context; they're cheap. The full close-vs-cancel teardown
+story lives in :doc:`/guide/streaming`.
+
+.. rubric:: Where to next?
+
+:doc:`/guide/streaming` covers the rest of the msg-moving story:
+the legacy one-way API, multi-actor pipelines and in-actor
+broadcast fan-out. For exhaustive API detail see
+:class:`tractor.Context`, :class:`tractor.MsgStream` and
+:exc:`tractor.ContextCancelled`.
+
+.. _trio: https://github.com/python-trio/trio
+.. _structured concurrency: https://en.wikipedia.org/wiki/Structured_concurrency
+.. _blog post: https://vorpus.org/blog/notes-on-structured-concurrency-or-go-statement-considered-harmful/
+.. _nursery: https://trio.readthedocs.io/en/latest/reference-core.html#nurseries-and-spawning
+.. _causality: https://vorpus.org/blog/some-thoughts-on-asynchronous-api-design-in-a-post-asyncawait-world/#c-c-c-c-causality-breaker
+.. _cheap or nasty: https://zguide.zeromq.org/docs/chapter7/#The-Cheap-or-Nasty-Pattern
+.. _(un)protocol: https://zguide.zeromq.org/docs/chapter7/#Unprotocols
+.. _msgspec: https://jcristharif.com/msgspec/
+.. _#53: https://github.com/goodboy/tractor/issues/53
+.. _#223: https://github.com/goodboy/tractor/issues/223

docs/guide/debugging.rst

@@ -0,0 +1,545 @@
+.. _debugging:
+
+================================
+"Native" multi-process debugging
+================================
+
+``tractor`` ships the thing every ``multiprocessing`` user has
+wished for and quietly assumed was impossible: a multi-process
+debugger that *just works*.
+
+Drop ``await tractor.pause()`` — or, with `greenback`_ installed,
+a plain builtin ``breakpoint()`` — anywhere in any actor: the
+root, a child, a grandchild, a sync helper function, even an
+``asyncio`` task inside an "infected" actor. A full-featured
+`pdbp`_ REPL opens *in that process*, with syntax-highlighted
+source listings, tab completion and sticky mode, attached to your
+one terminal.
+
+Under the hood every REPL entry acquires a tree-global tty mutex
+via an IPC request to the root actor, so prompts from concurrent
+pauses and crashes never interleave. ``ctrl-c`` is shielded while
+any REPL is live, so a stray ``SIGINT`` can't vaporize the tree
+out from under you. And in debug mode any uncaught error drops
+you into a crash REPL *first in the failing child*, then again at
+each parent as the boxed :class:`~tractor.RemoteActorError` climbs
+the supervision tree.
+
+No remote-pdb sockets, no ``set_trace()`` port juggling, no
+``ptrace`` attach dance: the debugger semantics you already know,
+transparently extended across an entire process tree. Because
+``tractor`` is a `structured concurrency`_ (SC) runtime, the
+debugger composes with supervision instead of fighting it — quit
+a REPL and errors keep propagating exactly like `trio`_ taught
+you, ending in clean, zombie-free teardown.
+
+We're pretty sure it's the (first ever?) "native" debugging UX
+for multi-process Python B)
+
+Enabling debug mode
+-------------------
+
+Pass ``debug_mode=True`` to your runtime entrypoint, either
+:func:`tractor.open_nursery` (which forwards it to the implicitly
+opened root actor) or :func:`tractor.open_root_actor` directly:
+
+.. code:: python
+
+    async with tractor.open_nursery(
+        debug_mode=True,    # arm the whole actor tree
+    ) as an:
+        ...
+
+This arms the debug machinery *tree-wide*:
+
+- crash handling is enabled in every actor: uncaught errors enter
+  a REPL before they propagate,
+- the internal tty-lock module is auto-exposed over RPC to every
+  subactor (this is what makes the one-terminal handoff work),
+- console logging is bumped to include ``PDB``-level status msgs
+  so you can see REPL acquire/release events as they happen.
+
+You can instead flip it on for just one child, letting its
+siblings crash-and-burn the normal way:
+
+.. code:: python
+
+    portal = await an.start_actor(
+        'sketchy_worker',
+        debug_mode=True,    # OR-ed with the tree-wide flag
+    )
+
+See ``examples/debugging/per_actor_debug.py`` for a runnable
+proof of the selective style.
+
+.. note::
+
+   Debug mode requires the child-side runtime to be
+   ``trio``-native so that the tty-lock IPC dialog works; it's
+   currently supported on the ``'trio'`` (default) and
+   ``'main_thread_forkserver'`` spawn backends and raises
+   ``RuntimeError`` for any other ``start_method``.
+
+Your first pause point
+----------------------
+
+:func:`tractor.pause` is the SC-aware, multi-process spelling of
+the stdlib's ``breakpoint()``. In the root actor it looks almost
+boring:
+
+.. literalinclude:: ../../examples/debugging/root_actor_breakpoint.py
+   :caption: examples/debugging/root_actor_breakpoint.py
+   :language: python
+
+Run it and you get a ``(Pdb+)`` prompt parked on the ``pause()``
+line; type ``c`` (continue) and the program finishes normally.
+
+The exact same call works from *any* subactor, no matter how deep
+in the tree:
+
+.. literalinclude:: ../../examples/debugging/subactor_breakpoint.py
+   :caption: examples/debugging/subactor_breakpoint.py
+   :language: python
+
+Each loop iteration the child actor requests the terminal from
+the root over IPC, REPLs you, then releases it on ``c``. Pause
+points are re-entrant-safe: repeat calls from the same task are
+no-op'd and other local tasks queue politely for the REPL.
+
+When you get bored, type ``q`` (quit): the resulting
+``bdb.BdbQuit`` is boxed and shipped to the parent like any other
+remote error XD — causality is preserved even for your debugging
+mistakes.
+
+Crash REPLs: errors climb the tree
+----------------------------------
+
+Pause points are only half the story. With debug mode armed, any
+*uncaught* error anywhere in the tree triggers what we call crash
+handling mode:
+
+.. literalinclude:: ../../examples/debugging/subactor_error.py
+   :caption: examples/debugging/subactor_error.py
+   :language: python
+
+What happens when the child hits that (very intentional)
+``NameError``:
+
+1. a REPL opens **in the crashed child first** — you inspect the
+   raising frame, its locals, the works, right inside the failed
+   process,
+2. when you quit, the error is boxed into a
+   :class:`~tractor.RemoteActorError` and relayed to the parent,
+3. the parent (here the root) gets *its own* crash REPL with the
+   rendered remote traceback,
+4. quit again and the nursery tears the tree down — errors keep
+   propagating per SC rules, no zombies left behind.
+
+You debug the failure at every hop of the supervision tree, which
+for multi-hop trees means you can chase an error from the leaf
+that raised it all the way up to the root that supervises it.
+
+Need to skip REPL entry for certain exceptions? Pass a predicate
+via ``open_root_actor(debug_filter=...)``; by default
+cancellation-only exception (groups) don't engage the REPL.
+
+One terminal, many actors
+-------------------------
+
+So how do N processes share one tty without garbling it? The root
+actor owns stdio for the whole tree and guards it with a FIFO
+mutex; every subactor REPL entry is an IPC lock request to the
+root. Exactly one actor-task in the entire tree can own the
+terminal at a time, so prompts never interleave — ever.
+
+.. d2:: diagrams/debug_lock.d2
+   :caption: Every REPL entry serializes through the root actor's
+       tty lock; ``continue``-ing one REPL hands the terminal to
+       the next waiter, FIFO style.
+   :alt: sequence diagram of two subactors serializing pdb REPL
+       access through the root actor's tty lock
+
+The runtime's teardown paths cooperate too: a cancelling parent
+always waits for any live REPL to release before reaping
+children, so the debugger never gets yanked out from under you
+mid-keystroke.
+
+.. margin:: Watch the tree live
+
+   Run any of these examples with a process-tree watcher in a
+   second terminal and watch actors come and go::
+
+       watch -n 0.1 "pstree -a $$"
+
+Here's the showpiece: one daemon child re-entering
+``tractor.pause()`` forever inside a stream, while its sibling
+repeatedly raises a ``NameError``:
+
+.. literalinclude:: ../../examples/debugging/multi_daemon_subactors.py
+   :caption: examples/debugging/multi_daemon_subactors.py
+   :language: python
+
+What you'll actually see
+************************
+
+Running it looks *roughly* like this (uids, tracebacks and source
+listings elided; REPL order can vary with who wins the lock
+race)::
+
+    $ python examples/debugging/multi_daemon_subactors.py
+
+    Opening a pdb REPL in paused actor: ('bp_forever', '<uuid>')
+    <highlighted source around the `await tractor.pause()` line>
+    (Pdb+) c
+
+    Opening a pdb REPL in crashed actor: ('name_error', '<uuid>')
+    <live traceback: NameError: name 'doggypants' is not defined>
+    (Pdb+) q
+
+    Opening a pdb REPL in crashed actor: ('root', '<uuid>')
+    <boxed RemoteActorError traceback relayed from 'name_error'>
+    (Pdb+) q
+
+Two (then three) processes, one terminal, zero confusion:
+``c``-ing out of the paused daemon's REPL releases the tty lock,
+which immediately hands the prompt to the crashed sibling; quit
+that and the error propagates as a fully-rendered
+:class:`~tractor.RemoteActorError` to the parent where one final
+crash REPL catches it before clean, zombie-free teardown.
+
+For maximum drama run
+``multi_nested_subactors_error_up_through_nurseries.py`` (under
+``examples/debugging/``) which pulls the same trick across a
+*three-deep* process tree — the tty lock keeps every prompt
+orderly the whole way up.
+
+Post-mortem, on demand
+----------------------
+
+Crash handling is automatic, but you can also enter a REPL on
+a live exception *manually* with :func:`tractor.post_mortem` —
+the actor-aware equivalent of ``pdb.post_mortem()`` — from inside
+any ``except`` block in any actor (kwargs: ``tb=`` for an
+explicit traceback, plus ``shield=`` and ``hide_tb=``):
+
+.. literalinclude:: ../../examples/debugging/pm_in_subactor.py
+   :caption: examples/debugging/pm_in_subactor.py
+   :language: python
+
+This example demos three REPL entries from one error:
+
+- the child's manual ``post_mortem()`` inside its ``except``,
+- the runtime's automatic crash handler in the same child once
+  the error re-raises out of the RPC task,
+- a manual ``post_mortem()`` in the parent on the received
+  :class:`~tractor.RemoteActorError`, whose ``.boxed_type``
+  faithfully reports the original ``NameError``.
+
+Pausing from sync code
+----------------------
+
+No ``await``? No problem. :func:`tractor.pause_from_sync` brings
+the same tree-aware REPL to plain synchronous functions — handy
+when the suspect code is three helpers deep and decidedly not
+async.
+
+It's powered by `greenback`_, which is optional, so you need to:
+
+1. install it (it ships in ``tractor``'s ``sync_pause``
+   dependency group),
+2. enable it at runtime entry:
+
+.. code:: python
+
+    async with tractor.open_nursery(
+        debug_mode=True,
+        maybe_enable_greenback=True,
+    ) as an:
+        ...
+
+With that armed, sync code can pause from three different caller
+environments: the main ``trio`` thread, ``trio.to_thread`` bg
+threads, and (see the next section) ``asyncio`` tasks in infected
+actors. The greenback "portal" hops back into the ``trio`` loop
+to do the lock/REPL dance on your behalf:
+
+.. literalinclude:: ../../examples/debugging/sync_bp.py
+   :caption: examples/debugging/sync_bp.py (the sync fn, excerpt)
+   :language: python
+   :pyobject: sync_pause
+
+.. literalinclude:: ../../examples/debugging/sync_bp.py
+   :caption: examples/debugging/sync_bp.py (called in a subactor,
+       excerpt)
+   :language: python
+   :pyobject: start_n_sync_pause
+
+The full script also exercises the hairier root-actor bg-thread
+cases (and documents their remaining sharp edges) if you want the
+deep lore.
+
+The builtin ``breakpoint()`` override
+*************************************
+
+When debug mode boots with greenback available, ``tractor`` wires
+Python's `PEP 553`_ hook so the *builtin* ``breakpoint()`` becomes
+the actor-aware sync pause, by exporting::
+
+    PYTHONBREAKPOINT=tractor.devx.debug._sync_pause_from_builtin
+
+That means third-party and legacy code containing bare
+``breakpoint()`` calls debugs correctly inside your actor tree
+with zero edits (the override even forwards kwargs like
+``hide_tb`` to the underlying pause machinery, as shown in the
+excerpt above).
+
+.. warning::
+
+   Without greenback (or with ``maybe_enable_greenback=False``,
+   the default), ``debug_mode=True`` instead *blocks* the builtin
+   ``breakpoint()``: ``sys.breakpointhook`` is swapped for a
+   raiser and ``PYTHONBREAKPOINT=0`` is set. A naive
+   ``breakpoint()`` from some random process would clobber the
+   shared tty, so we'd rather hand you a loud ``RuntimeError``
+   with install instructions.
+
+Both the hook and the env var are restored to their prior values
+on runtime exit — see
+``examples/debugging/restore_builtin_breakpoint.py`` for the
+proof.
+
+Breakpoints inside ``asyncio`` tasks
+------------------------------------
+
+Yes, even "infected ``asyncio``" actors get the goods. Spawn a
+child with ``infect_asyncio=True`` (``trio`` runs as a guest on
+the ``asyncio`` loop inside it) and, with debug mode + greenback
+armed, every ``asyncio`` task started via ``tractor.to_asyncio``
+is automatically granted a greenback portal — so a plain builtin
+``breakpoint()`` (or ``tractor.pause_from_sync()``) inside an
+``asyncio.Task`` joins the same single-terminal, tree-locked REPL
+flow:
+
+.. literalinclude:: ../../examples/debugging/asyncio_bp.py
+   :caption: examples/debugging/asyncio_bp.py
+   :language: python
+
+Note the interleave: a ``breakpoint()`` on the ``asyncio`` side,
+``tractor.pause()`` on the ``trio`` side of the same actor, and
+another pause up in the root — all serialized through the one tty
+lock with no cross-actor (or cross-event-loop!) clobbering.
+
+One catch: ``asyncio`` tasks spawned *out-of-band* — i.e. not via
+``tractor.to_asyncio``, typically by some third-party aio lib —
+have no portal bestowed, so a sync pause from one raises a loud
+``RuntimeError`` telling you to ``greenback.ensure_portal()``
+first. See :ref:`the caveats <debugging-caveats>` below.
+
+Teardown debugging: the shielded pause
+--------------------------------------
+
+`Cancellation`_ is ``trio``'s bread and butter, which raises an
+awkward question: how do you REPL inside an *already-cancelled*
+scope, say while debugging some teardown sequence? A bare
+``pause()`` would itself be cancelled at its next checkpoint.
+
+The answer is ``await tractor.pause(shield=True)``, which wraps
+the lock acquisition and REPL session in a shielded cancel scope
+(``post_mortem(shield=True)`` works the same way):
+
+.. literalinclude:: ../../examples/debugging/shielded_pause.py
+   :caption: examples/debugging/shielded_pause.py
+   :language: python
+
+If you forget, ``tractor`` has your back: an unshielded
+``pause()`` from a cancelled scope fails fast with a hint
+suggesting ``await tractor.pause(shield=True)`` instead of
+silently never REPL-ing.
+
+Go ahead, mash ctrl-c
+---------------------
+
+While any REPL is live the runtime installs a custom ``SIGINT``
+handler tree-wide so that a reflexive ``ctrl-c`` (or five) can't
+nuke your debug session:
+
+- the actor that owns the REPL ignores the interrupt and simply
+  re-flushes the prompt — keep mashing, it's fine,
+- the root actor ignores ``SIGINT`` while a still-IPC-connected
+  child holds the tty lock, so the supervisor won't tear down the
+  tree out from under the debugger,
+- if the lock state has gone *stale* — the locking child died or
+  its IPC channel dropped — the root cancels the stale lock scope
+  and restores ``trio``'s default handler, so ``ctrl-c`` works
+  again exactly when it should.
+
+The handler is uninstalled and ``trio``'s own ``SIGINT``
+semantics restored every time a REPL releases (on ``continue`` /
+``quit``).
+
+Live task-tree dumps
+--------------------
+
+Sometimes there's no error to catch — the tree is just *hung* and
+you want to know where. For that ``tractor`` integrates
+`stackscope`_: send a signal, get a full ``trio`` task-tree dump
+from every actor in the tree.
+
+Enable it any of three ways:
+
+- ``open_root_actor(enable_stack_on_sig=True)`` (or via
+  ``open_nursery()`` which forwards it),
+- set ``TRACTOR_ENABLE_STACKSCOPE=1`` in the env — it's inherited
+  through the process tree so every (sub)actor arms the handler
+  at boot,
+- call ``tractor.devx.enable_stack_on_sig()`` directly.
+
+It's intentionally *not* gated on ``debug_mode`` so you can leave
+it armed in plain runs. Then, when the hang strikes, signal the
+tree with ``SIGUSR1``.
+
+.. tip::
+
+   No need to hunt down pids — pattern-match the original cmdline
+   with ``pkill``::
+
+       $ pkill --signal SIGUSR1 -f "python example_script.py"
+
+Each actor dumps its entire ``trio`` task tree (full nursery
+recursion via ``stackscope.extract()``) to its tty *and* tees it
+to ``/tmp/tractor-stackscope-<pid>.log`` — so the trace survives
+even under captured-stdio harnesses — then relays the signal on
+to its children, parent-before-child, until the whole tree has
+reported in.
+
+Try it yourself with the demo script, which deliberately hangs a
+subactor in a shielded sleep:
+
+.. literalinclude:: ../../examples/debugging/shield_hang_in_sub.py
+   :caption: examples/debugging/shield_hang_in_sub.py
+   :language: python
+
+(That ``trio.CancelScope(shield=True)`` hang also shows off the
+zombie reaper: ``ctrl-c`` the root and the un-cancellable child
+still gets hard-reaped — if you can create a zombie it **is a
+bug**.)
+
+Crash handling for sync and CLI code
+------------------------------------
+
+All of the above rides on the actor runtime, but crashes don't
+politely wait for ``trio.run()``. For plain sync code — think
+``typer``/``click`` CLI endpoints, config parsing, anything
+pre-runtime — there's a sync context manager that wraps the same
+``pdbp`` post-mortem UX:
+
+.. code:: python
+
+    from tractor.devx import open_crash_handler
+
+    def main():    # any sync code, no runtime required
+        with open_crash_handler() as boxed:
+            run_my_cli_thing()
+
+By default any ``BaseException`` (minus an ``ignore`` set
+defaulting to ``KeyboardInterrupt`` and ``trio.Cancelled``)
+enters the REPL then re-raises on exit; pass
+``raise_on_exit=False`` to suppress instead and introspect the
+``boxed.value`` afterward. The ``catch``/``ignore`` sets and a
+``repl_fixture`` are all tweakable.
+
+For the classic ``--pdb`` CLI-flag pattern use the conditional
+variant:
+
+.. code:: python
+
+    from tractor.devx import maybe_open_crash_handler
+
+    @app.command()    # a `typer` (or `click`) endpoint
+    def cmd(pdb: bool = False):
+        with maybe_open_crash_handler(pdb=pdb):
+            ...
+
+REPL niceties and hooks
+-----------------------
+
+Every REPL in this guide is a `pdbp`_ instance (the maintained
+fork-and-fix of `pdb++`_) pre-configured by ``tractor``:
+
+- pygments syntax highlighting in listings and tracebacks,
+- tab completion — including an automatic fixup for
+  libedit-compiled CPythons (e.g. ``uv``-distributed pythons),
+- sticky mode available via the ``sticky`` command (off by
+  default),
+- no long-line truncation (terminal resizes behave),
+- the ``(Pdb+)`` prompt, ``ll``, hidden-frames support and the
+  rest of the ``pdb++`` goodies you may already know.
+
+Internal runtime frames are traceback-hidden so the REPL lands
+exactly on *your* ``pause()``-call or crash frame, never on
+``tractor`` guts.
+
+Finally, if your app owns the terminal (TUIs, fullscreen
+dashboards) pass ``repl_fixture=<your ctx mngr>`` to ``pause()``,
+``post_mortem()`` or ``open_crash_handler()``: it's entered just
+before the REPL engages (return ``False`` to skip entry entirely)
+and exited on release — perfect for suspending and restoring your
+screen around a debug session.
+
+.. _debugging-caveats:
+
+Caveats and platform notes
+--------------------------
+
+An honest list of the current rough edges:
+
+- **Windows**: the debugger has no CI coverage on windows at all
+  (the entire test module is skipped there); manual testing has
+  shown it *can* work, but you're in uncharted territory —
+  reports welcome!
+- **macOS**: supported but with rough edges: special-cased prompt
+  re-flushing for ``bash``-on-darwin, a few tooling tests skipped
+  on CI, and the AF_UNIX ~104-char socket-path limit forces some
+  examples (like the stackscope demo above) to fall back from
+  ``'uds'`` to ``'tcp'`` transport. Wonder if all of it'll work
+  on OS X? So do we.
+- **CPython 3.14**: ``greenback`` (via ``greenlet``) doesn't
+  support 3.14 yet, so ``pause_from_sync()`` and the builtin
+  ``breakpoint()`` override are effectively 3.13-only for now.
+  The async APIs — ``pause()`` and ``post_mortem()`` — need no
+  greenback and work everywhere.
+- **out-of-band** ``asyncio`` **tasks**: sync pauses from aio
+  tasks *not* spawned via ``tractor.to_asyncio`` raise a
+  ``RuntimeError`` (no greenback portal was bestowed); run
+  ``await greenback.ensure_portal()`` inside such a task first.
+- **nested-tree ctrl-c edges**: ``SIGINT`` relay through
+  intermediary parents that aren't themselves in debug mode still
+  has known rough edges — see `#320`_.
+- **captured stdio**: ``pytest``-style output capture can hang a
+  ``pause()``; use a real terminal (or a pty à la ``pexpect``,
+  which is how ``tractor``'s own suite drives every one of these
+  examples).
+
+Where to next?
+--------------
+
+.. seealso::
+
+   - :doc:`/guide/context` — the SC-linked cross-actor task API
+     that all the crash-propagation semantics above ride on.
+   - :func:`tractor.pause`, :func:`tractor.post_mortem` and
+     :func:`tractor.pause_from_sync` in the API reference.
+   - ``examples/debugging/`` — 20-odd runnable scripts, nearly
+     every one exercised by the test suite through a real pty.
+
+.. _structured concurrency:
+   https://en.wikipedia.org/wiki/Structured_concurrency
+.. _trio: https://github.com/python-trio/trio
+.. _cancellation: https://trio.readthedocs.io/en/latest/
+   reference-core.html#cancellation-and-timeouts
+.. _pdbp: https://github.com/mdmintz/pdbp
+.. _pdb++: https://github.com/pdbpp/pdbpp
+.. _greenback: https://github.com/oremanj/greenback
+.. _stackscope: https://github.com/oremanj/stackscope
+.. _PEP 553: https://peps.python.org/pep-0553/
+.. _#320: https://github.com/goodboy/tractor/issues/320

docs/guide/discovery.rst

@@ -0,0 +1,255 @@
+Actor discovery
+===============
+
+So you've spawned a tree of trio-"actors"; now their tasks need to
+*find* each other to start a dialog. ``tractor`` ships a (self
+admittedly) **very naive** discovery system which is nonetheless
+mighty handy for wiring up service-style apps: a built-in
+*registrar* actor plus a small set of lookup APIs that deliver
+a live, connected ``Portal`` to whichever peer you're after.
+
+.. d2:: diagrams/actor_tree.d2
+   :margin:
+   :caption: The root actor doubles as the *registrar* by
+       default; every spawned actor registers itself with it.
+   :alt: actor tree with root acting as registrar
+
+Because ``tractor`` is built on structured concurrency (SC), the
+discovery layer is *not* some external etcd/consul-shaped service
+you have to babysit; it's just another actor — normally the root
+of your tree — doing a bit of bookkeeping as part of the runtime.
+
+Every actor phones home
+-----------------------
+
+On runtime boot **every** actor self-registers with the registrar:
+it submits its unique ``(name, uuid)`` identity pair (aka its
+``uid``) mapped to the list of transport addresses its IPC server
+is bound to. On graceful teardown it likewise *un*-registers, so
+the registry tracks the live tree as it grows and shrinks.
+
+.. note::
+   Actor names are **not** enforced unique — the registry is keyed
+   by the full ``(name, uuid)`` pair. Name-based lookups simply
+   resolve to the *last* registered match, so if you boot five
+   actors all named ``'bob'``, you get the freshest ``'bob'`` B)
+
+First boot: who's the registrar?
+--------------------------------
+
+By default the **root actor** *is* the registrar; subactors
+inherit the tree's ``registry_addrs`` at spawn time so the whole
+clan shares one registry with zero config on your part.
+
+The bootstrap rule inside ``open_root_actor()`` is delightfully
+simple:
+
+- on boot, ping every socket addr in ``registry_addrs``; when none
+  are passed the per-transport defaults are used: for TCP the
+  loopback ``('127.0.0.1', 1616)``, for UDS a
+  ``registry@1616.sock`` file,
+
+- if a registrar answers, you boot as a plain (non-registrar) root
+  actor and register with the *existing* registry; your own IPC
+  server binds random same-transport addrs instead,
+
+- if **nothing answers, congratulations: you just became the
+  registrar**. Your transport server binds the registry addrs
+  themselves and you start serving lookups for everyone else.
+
+Pass ``ensure_registry=True`` when your program *requires* being
+the one-and-only registrar; boot then fails loudly with a
+``RuntimeError`` if some other process already bound the registry
+socket(s).
+
+Looking up actors
+-----------------
+
+All lookup APIs are async context managers, so the SC rule you
+already know from the rest of ``tractor`` holds here too: any
+delivered portal (and its underlying IPC channel) is scoped to
+your ``async with`` block — no dangling connections.
+
+``find_actor()``
+****************
+
+The workhorse: ask the registrar for ``name`` and connect a portal
+to the match, or get ``None`` back when nobody's home:
+
+.. code:: python
+
+    async with tractor.find_actor('data_feed') as portal:
+        if portal is None:
+            ...  # not registered anywhere; maybe spawn it?
+        else:
+            await portal.run(do_stuff)
+
+Knobs worth knowing:
+
+- ``registry_addrs=[...]``: query specific (possibly multiple,
+  possibly remote) registrars instead of your tree's default,
+
+- ``only_first=False``: deliver a ``list[Portal]`` of *all*
+  matches found across the queried registrars instead of just the
+  first,
+
+- ``raise_on_none=True``: raise a ``RuntimeError`` instead of
+  yielding ``None`` when no match is found — for when absence is
+  a hard error in your app.
+
+``wait_for_actor()``
+********************
+
+Blocks until *someone* registers under ``name``, then yields a
+portal to that registree. Perfect for "wait for my sibling service
+to come up" sequencing:
+
+.. code:: python
+
+    async with tractor.wait_for_actor('service') as portal:
+        await portal.run(some_fn)
+
+``query_actor()``
+*****************
+
+A lookup *without* connecting to the target: yields an
+``(addr, reg_portal)`` pair where ``addr`` is the peer's preferred
+transport address, or ``None`` when nothing is registered under
+that name. Use it for liveness peeks or to log where a service
+lives without actually dialing it up.
+
+``get_registry()``
+******************
+
+Yields a portal straight to the registrar actor itself — or a
+``LocalPortal`` shim when the calling actor *is* the registrar
+(no IPC required to talk to yourself, hopefully).
+
+Fast paths and address preference
+---------------------------------
+
+Before doing any RPC to the registrar, every lookup first scans
+the calling actor's *already-connected peers*: if you have a live
+channel to an actor named ``name`` you get a portal over it
+immediately, no registrar round-trip at all.
+
+When a registry entry holds *multiple* addresses (a multihomed
+actor) the "best" one is chosen by locality:
+
+1. UDS — same-host guaranteed, lowest overhead,
+
+2. local TCP — loopback or any of this host's own interface
+   addrs,
+
+3. remote TCP — the only option when actually distributed.
+
+Within a tier the most recently registered addr wins. Stale
+entries (an addr that no longer accepts connections) are detected
+on use and deleted from the registrar's table on your behalf.
+
+Demo: register and find a service
+---------------------------------
+
+The simplest possible spin: start a subactor, ask the registrar
+where it lives, and wait on its registration:
+
+.. literalinclude:: ../../examples/service_discovery.py
+   :caption: examples/service_discovery.py
+   :language: python
+
+The daemon-service pattern
+--------------------------
+
+The classic deployment shape: a long-lived daemon actor serves
+RPC, later-running code discovers it by name, calls in, and
+gracefully cancels it when the job is done:
+
+.. literalinclude:: ../../examples/service_daemon_discovery.py
+   :caption: examples/service_daemon_discovery.py
+   :language: python
+
+Note the teardown ordering — *graceful cancel* of the daemon via
+its portal is part of the pattern; under SC a "service" is still
+somebody's child and somebody is responsible for reaping it.
+
+Joining an existing tree from outside
+-------------------------------------
+
+Discovery isn't limited to a single program: any standalone script
+can join a running tree by booting its *own* root actor pointed at
+the existing registrar:
+
+.. code:: python
+
+    import trio
+    import tractor
+
+    async def main():
+        async with (
+            # contact the live tree's registrar
+            tractor.open_root_actor(
+                registry_addrs=[('127.0.0.1', 1616)],
+            ),
+            tractor.find_actor('data_feed') as portal,
+        ):
+            ...  # RPC away like you were born here
+
+    trio.run(main)
+
+Per the bootstrap rules above, if the registrar at those addrs is
+*not* reachable this process simply becomes its own (registrar)
+root — so the same code works standalone and as a tree-joiner.
+
+"Arbiter"? A legacy naming note
+-------------------------------
+
+In older releases (and many an old blog post or issue thread) the
+registrar actor was called the *arbiter*, with matching APIs like
+``get_arbiter()`` and an ``arbiter_addr`` argument. All of that
+terminology is retired: it's *registrar*/*registry* everywhere now
+(``registry_addrs``, ``get_registry()``, ...) and the
+``tractor.Arbiter`` export survives only as a back-compat alias of
+``tractor.Registrar``. If you see "arbiter" somewhere, mentally
+substitute "registrar" and you're up to date.
+
+.. note::
+   Multihoming nerds: ``tractor.discovery`` also ships
+   libp2p-style *multiaddr* helpers — ``mk_maddr()`` and
+   ``parse_maddr()`` — for describing transport endpoints as
+   structured strings.
+
+Very naive, very honest
+-----------------------
+
+To be clear, this is a **very naive** discovery system: one
+process-tree-local registrar holding a dict, no replication, no
+re-election when it dies, no cross-host propagation. That's
+intentional (for now); it covers the "wire up my services on this
+host" case without dragging in a consensus protocol.
+
+On the roadmap (issue `#216`_ tracks a chunk of it):
+
+- registrar high(er)-availability: staying up past tree teardown
+  and re-election,
+
+- a `gossip protocol`_ for decentralized cross-host discovery (the
+  zguide's `discovery`_ chapter is the spiritual reference),
+
+- `modern protocol`_ (rendezvous) style meet-up points.
+
+If any of that scratches your itch, the issue tracker would love
+to hear from you.
+
+.. seealso::
+   - :doc:`/guide/testing` — watching live actor trees (and their
+     registrar) while the test suite or your app runs.
+   - API refs: :func:`tractor.find_actor`,
+     :func:`tractor.wait_for_actor`,
+     :func:`tractor.query_actor`,
+     :func:`tractor.get_registry`,
+     :class:`tractor.Registrar`.
+
+.. _gossip protocol: https://en.wikipedia.org/wiki/Gossip_protocol
+.. _modern protocol: https://en.wikipedia.org/wiki/Rendezvous_protocol
+.. _discovery: https://zguide.zeromq.org/docs/chapter8/#Discovery
+.. _#216: https://github.com/goodboy/tractor/issues/216

docs/guide/index.rst

@@ -0,0 +1,52 @@
+Guides
+======
+Task-focused walkthroughs of every major ``tractor``
+subsystem, each built around real, *test-suite
+verified* example scripts from the repo's
+``examples/`` dir (we never copy-paste code into
+docs; what you read is what CI runs).
+
+Roughly in "first date to long term relationship"
+order,
+
+- :doc:`spawning` — actor nurseries, daemons +
+  one-shot workers, process lifetimes.
+- :doc:`rpc` — portals: calling into another
+  process like it's a local ``await``.
+- :doc:`context` — the cross-actor task-pair
+  primitive at the heart of modern ``tractor``.
+- :doc:`streaming` — one-way and bidirectional
+  msg streams between actors.
+- :doc:`cancellation` — supervision, error
+  boxing + propagation, teardown discipline.
+- :doc:`debugging` — the multi-process native
+  REPL debugger; our flagship DX feature B)
+- :doc:`discovery` — the registrar, finding
+  actors by name, service patterns.
+- :doc:`clustering` — quick flat process
+  clusters via one ``async with``.
+- :doc:`parallelism` — worker pools without
+  pools; a ``concurrent.futures`` re-think.
+- :doc:`asyncio` — "infected asyncio" mode:
+  SC-supervise ``asyncio`` tasks from ``trio``.
+- :doc:`msging` — typed IPC payloads, the wire
+  msg-spec and custom codecs.
+- :doc:`testing` — running + monitoring the
+  test suite (and testing your own actor apps).
+
+.. toctree::
+   :hidden:
+   :maxdepth: 1
+
+   spawning
+   rpc
+   context
+   streaming
+   cancellation
+   debugging
+   discovery
+   clustering
+   parallelism
+   asyncio
+   msging
+   testing

docs/guide/msging.rst

@@ -0,0 +1,260 @@
+Typed messaging
+===============
+Every value that crosses an actor boundary rides inside a typed
+msg. ``tractor`` ships a small, fixed family of msg types, the
+"SC-transitive supervision protocol", which encapsulates *all*
+RPC dialogs in the tree such that `structured concurrency`_ (SC)
+semantics -- parent-child task linkage, error propagation,
+graceful cancellation -- hold across every process hop. On top of
+that
+protocol you can layer **your own** payload type contracts,
+per-endpoint, and have them enforced at runtime by the codec.
+
+.. note::
+
+   Older posts and readmes claim ``tractor`` "uses
+   ``msgpack``(-python)" on the wire. The wire *encoding* is still
+   msgpack, but since ``0.1.0a5`` all codec work is done by
+   msgspec_ against a strictly-typed, tagged-union msg-spec;
+   neither ``msgpack-python`` nor ``u-msgpack`` are involved.
+
+The wire format
+---------------
+Each protocol msg is a :class:`msgspec.Struct` subtype declared
+with ``tag=True, tag_field='msg_type'``, so the full set decodes
+as a `tagged union`__ with zero dispatch code of our own. The
+payload-carrying msgs all inherit from ``PayloadMsg`` which boxes:
+
+__ https://jcristharif.com/msgspec/structs.html#tagged-unions
+
+- ``.cid`` -- the "context id" identifying which dialog (i.e.
+  which ``Context``) the msg belongs to,
+- ``.pld`` -- the *payload*, aka your app's actual data.
+
+Decoding is deliberately two-layered:
+
+- the **transport codec** decodes only the protocol *envelope*,
+  intentionally leaving ``.pld`` as raw bytes
+  (:class:`msgspec.Raw`),
+- a **per-context payload-receiver** (the internal ``PldRx``) then
+  decodes each ``.pld`` against *that* dialog's user-defined type
+  spec.
+
+This split is what lets every ``Context`` carry its own msg-spec
+without reconfiguring the shared transport, keeps the runtime's
+own traffic immune to your app's spec choices, and makes any
+validation failure attributable to exactly one dialog (and thus
+one task pair) instead of nuking the whole channel.
+
+The protocol family
+-------------------
+The entire msg-spec is ten types, all importable from
+``tractor.msg`` (defined in ``tractor.msg.types``):
+
+.. list-table::
+   :header-rows: 1
+   :widths: 18 82
+
+   * - msg type
+     - role
+   * - ``Aid``
+     - actor-identity handshake; the first thing two peers
+       exchange on connect (name, uuid, pid).
+   * - ``SpawnSpec``
+     - parent -> child runtime config sent right after ``Aid``:
+       enabled modules, registry/bind addrs, runtime vars.
+   * - ``Start``
+     - request to remotely schedule an RPC task: target
+       namespace + func name, kwargs and the caller's uid.
+   * - ``StartAck``
+     - the callee's ack declaring the endpoint's "functype":
+       ``asyncfunc``, ``asyncgen`` or ``context``.
+   * - ``Started``
+     - the first value passed to ``ctx.started()``; completes
+       the context handshake.
+   * - ``Yield``
+     - one streamed value per ``MsgStream.send()`` call.
+   * - ``Stop``
+     - graceful stream termination; the IPC rendition of
+       ``StopAsyncIteration``.
+   * - ``Return``
+     - the final return value of the remote task fn.
+   * - ``CancelAck``
+     - ``bool`` result of a runtime cancel-request; always
+       decodable so graceful cancellation can never be broken
+       by a custom msg-spec.
+   * - ``Error``
+     - a boxed remote exception (src uid, relay path, tb str,
+       ..) relayed for local re-raise as
+       :class:`tractor.RemoteActorError`.
+
+Squint and you'll see an SC task scope serialized onto the wire:
+every dialog opens with ``Start``/``StartAck`` (plus ``Started``
+for ``@tractor.context`` endpoints), optionally streams
+``Yield``-s until a ``Stop``, and **always** terminates with
+exactly one of ``Return``, ``Error`` or ``CancelAck``. That 1:1
+mapping of msg sequence onto a cross-process task pair is why we
+call the protocol *SC-transitive*: supervision semantics survive
+every hop of the tree. In `(un)protocol`_ terms it's our "SC
+dialog un-protocol".
+
+For introspection the union alias ``tractor.msg.MsgType``, the
+list ``__msg_types__`` and the spec alias ``__msg_spec__`` are
+all exported.
+
+Payload typing with ``pld_spec``
+--------------------------------
+By default ``.pld`` may be any msgspec-supported type, i.e. the
+spec is ``Any``. To constrain a single endpoint's dialog, pass
+a type (union) to the decorator:
+``@tractor.context(pld_spec=MyStruct|None)``. The spec then
+applies to all payload-carrying msgs of that dialog --
+``Started``, ``Yield`` and ``Return`` -- on both sides of the
+IPC. Pro tip: keep ``None`` in your union since most endpoints
+implicitly ``return None`` and a bare ``ctx.started()`` ships
+``None`` too.
+
+.. literalinclude:: ../../examples/typed_payloads.py
+   :caption: examples/typed_payloads.py
+   :language: python
+
+What's going on?
+
+- the payload schema is just a :class:`msgspec.Struct` subtype;
+  anything msgspec can tag and decode works, including unions
+  of structs, builtins and containers.
+- decorating with ``@tractor.context(pld_spec=...)`` attaches the
+  spec to the endpoint; both peers' payload-receivers now decode
+  this dialog's payloads against it. No spec sharing files, no
+  IDL compiler, the contract *is* the Python type.
+- the happy path looks identical to untyped code: the child calls
+  ``await ctx.started(<conforming value>)``, streams or returns
+  more conforming values, and the parent receives fully decoded
+  struct instances (not dicts!) on its side.
+- the sad path is the point: shipping a value *outside* the spec
+  raises :class:`tractor.MsgTypeError`, which the example catches
+  to show off the failure mode; see the anatomy section below for
+  exactly where it gets raised.
+
+Where validation happens: cheap-or-nasty
+----------------------------------------
+A naive impl would validate every payload on both send *and*
+receive, doubling your codec bill exactly where throughput
+matters most. Instead ``tractor`` follows the 0mq lords'
+"`cheap or nasty`_" pattern: be **nasty** (strict, eager,
+expensive) on the rare control msgs and **cheap** (lazy, fast) on
+the high-rate stream path.
+
+- ``Started`` is the *only* payload that gets the full nasty
+  treatment: ``ctx.started(value)`` stringently
+  **roundtrip-checks** the encoded msg against the dialog's spec
+  *before* sending, so a non-conforming first value raises
+  :class:`tractor.MsgTypeError` immediately in the child and
+  never even hits the wire. (You can opt out per-call with
+  ``ctx.started(..., validate_pld_spec=False)`` if you measure
+  a real cost.)
+- ``Yield`` payloads are **never** checked inside
+  ``MsgStream.send()``; they're validated receiver-side on each
+  ``MsgStream.receive()``. A violation raises a ``MsgTypeError``
+  in the receiver *and* relays an ``Error`` msg back so the
+  offending sender gets one raised too.
+- the remaining control msgs (``Start``, ``Return``) are likewise
+  validated such that violations raise in the **sending** actor,
+  pointing the traceback at the code that actually goofed.
+
+Anatomy of a ``MsgTypeError``
+-----------------------------
+:class:`tractor.MsgTypeError` is the IPC equivalent of a builtin
+``TypeError``: a ``RemoteActorError`` subtype raised whenever
+a msg fails to decode against the active spec. The useful bits:
+
+- ``.bad_msg`` -- the offending msg instance (reconstructed from
+  its wire form when necessary) so you can inspect the actual
+  ``.pld`` that broke the contract.
+- ``.expected_msg_type`` -- the protocol msg type the bad msg was
+  (supposed to be) decoded as, e.g. ``Started[Point]``.
+- plus the standard ``RemoteActorError`` goodies: ``.boxed_type``,
+  ``.src_uid``, ``.ipc_msg`` and the fancy ``.pformat()`` tb-box
+  rendering.
+
+Practical reading guide: a *sender-side* MTE (``Started``,
+``Return``) points straight at your offending ``await
+ctx.started()`` or ``return`` statement, while a *receiver-side*
+MTE (``Yield``) surfaces from the consumer's ``receive()`` call
+with the relay copy delivered back to the producer. Either way
+the failure is scoped to that one dialog; sibling contexts on the
+same channel keep right on trucking.
+
+Custom wire types: ``mk_codec()`` and friends
+---------------------------------------------
+msgspec covers a wide set of `builtin types`__ natively; for
+anything else you teach the codec via extension hooks. The
+easiest path is per-endpoint: ``@tractor.context()`` accepts
+``enc_hook``/``dec_hook`` params right alongside ``pld_spec``.
+For full control build and apply a codec yourself; encode-side:
+
+__ https://jcristharif.com/msgspec/supported-types.html
+
+.. code:: python
+
+    from tractor.msg import mk_codec, apply_codec
+
+    codec = mk_codec(
+        enc_hook=nsp_to_str,        # your-type -> wire-type
+        ext_types=[NamespacePath],
+    )
+    with apply_codec(codec):        # ContextVar-scoped override
+        ...  # msgs sent by this task now encode NSPs
+
+and decode-side, scoped to an open context (note the import from
+``tractor.msg._ops``, not yet re-exported):
+
+.. code:: python
+
+    from tractor.msg._ops import limit_plds
+
+    with limit_plds(
+        NamespacePath,
+        dec_hook=str_to_nsp,        # wire-type -> your-type
+        ext_types=[NamespacePath],
+    ):
+        ...  # this dialog's payloads decode as NSPs
+
+``apply_codec()`` is ``ContextVar``-scoped: it overrides the
+codec for the current task (and only that task), not the whole
+process. For complete working flows, including hook pairing rules
+and roundtrip cases, see ``tests/msg/test_ext_types_msgspec.py``
+and ``tests/msg/test_pldrx_limiting.py``.
+
+The runtime dogfoods this pattern with
+:class:`tractor.msg.NamespacePath`: a ``str``-subtype shaped like
+``'module.path:obj_name'`` used for every RPC target reference.
+It ships over the wire as a plain string yet ``.load_ref()``-s
+back to the actual object in the receiving actor's memory domain;
+a minimal "pointer type" for shared-nothing systems.
+
+Toward capability-based msging
+------------------------------
+The ``pld_spec`` + codec-hook layer is the foundation for the
+long-game: **capability-based msging** where each dialog's
+type contract doubles as a capability grant, negotiated as part
+of the protocol itself. That work is tracked in `#196`_ (with the
+original typed-proto epic in `#36`_); if strongly-typed
+distributed systems get you going, we'd love your input.
+
+Where to next?
+--------------
+.. seealso::
+
+   - :doc:`/guide/context` for the dialog API these msgs
+     implement: ``started()``, streams and results.
+   - :doc:`/guide/asyncio` for shuttling (typed) payloads into
+     ``asyncio``-land via an infected subactor.
+   - the msgspec_ docs for everything your payload types can be.
+
+.. _structured concurrency: https://en.wikipedia.org/wiki/Structured_concurrency
+.. _msgspec: https://jcristharif.com/msgspec/
+.. _cheap or nasty: https://zguide.zeromq.org/docs/chapter7/#The-Cheap-or-Nasty-Pattern
+.. _(un)protocol: https://zguide.zeromq.org/docs/chapter7/#Unprotocols
+.. _#196: https://github.com/goodboy/tractor/issues/196
+.. _#36: https://github.com/goodboy/tractor/issues/36

docs/guide/parallelism.rst

@@ -0,0 +1,176 @@
+Parallelism and worker pools
+============================
+
+The initial ask is almost always the same: *"how do i make a worker
+pool?"* — i.e. the thing :mod:`multiprocessing` and
+:class:`concurrent.futures.ProcessPoolExecutor` get reached for
+once the GIL becomes the enemy.
+
+Here's the structured concurrency (SC) answer: ``tractor`` is built
+to handle any SC process tree you can imagine; a "worker pool"
+pattern is a trivial special case. So instead of shipping a pool
+*class* with knobs bolted on, you compose one from the same two
+ingredients used everywhere else in ``tractor``: an actor nursery
+and some IPC.
+
+The stdlib baseline
+-------------------
+
+For a fair comparison, start from the canonical
+:class:`~concurrent.futures.ProcessPoolExecutor` primes example
+straight out of the Python docs,
+
+.. literalinclude:: ../../examples/parallelism/concurrent_futures_primes.py
+   :caption: examples/parallelism/concurrent_futures_primes.py
+   :language: python
+
+Synchronous code, a hidden thread + IPC machine under the hood, and
+an API surface (executors, futures, ``.map()``) invented to paper
+over the fact that the pool isn't part of your program's task tree.
+Keep an eye on three things for the rewrite: how work is submitted,
+how results come back, and what happens when a worker dies.
+
+The ``tractor`` way
+-------------------
+
+Now the same workload as a ``tractor`` program,
+
+.. literalinclude:: ../../examples/parallelism/concurrent_actors_primes.py
+   :caption: examples/parallelism/concurrent_actors_primes.py
+   :language: python
+
+What's different (and what isn't),
+
+- ``worker_pool()`` is ~30 lines of *your* code: an actor nursery
+  spawning ``workers`` subactors — each a full process running its
+  own ``trio`` task tree — kept alive and ready for work until the
+  block exits; ``enable_modules=[__name__]`` is the capability
+  allowlist letting them run this module's functions,
+- jobs are "submitted" by just... calling the function:
+  ``portal.run(is_prime, n=value)`` runs ``is_prime()`` in a
+  worker and hands back its result like any local ``await``,
+- results stream back through a plain
+  :func:`trio.open_memory_channel` *as they complete* — no futures
+  and no polling,
+- teardown is one ``await tn.cancel()``
+  (:meth:`tractor.ActorNursery.cancel`), and any worker crash
+  triggers the one-cancels-all machinery from
+  :doc:`/guide/cancellation` — a dead worker can never strand the
+  pool.
+
+This uses no extra threads, fancy semaphores or futures; all we
+need is ``tractor``'s IPC! The full scorecard,
+
+.. list-table::
+   :header-rows: 1
+   :widths: 50 50
+
+   * - ``concurrent.futures``
+     - ``tractor``
+   * - ``ProcessPoolExecutor()``
+     - ``worker_pool()`` — yours, ~30 lines
+   * - ``executor.map(is_prime, PRIMES)``
+     - ``actor_map(is_prime, PRIMES)`` async-gen
+   * - ``Future`` + internal result queue
+     - :func:`trio.open_memory_channel`
+   * - results in input order
+     - results as they complete
+   * - worker crash -> ``BrokenProcessPool``
+     - boxed :class:`tractor.RemoteActorError`
+   * - pool teardown on ``with`` exit
+     - one-cancels-all nursery teardown
+
+.. margin:: How many workers?
+
+   Same calculus as any process pool: about core-count for
+   CPU-bound work (the default sizing in
+   :doc:`/guide/clustering`); more only if workers block on I/O —
+   though at that point you likely want plain ``trio`` tasks, not
+   processes.
+
+And because the pool is just SC code, every variation — bounded
+submission, per-worker state, streaming partial results (see
+:doc:`/guide/streaming`), nested pools — is a local edit to your
+pool, not a feature request against an executor class B)
+
+An *async* pool, though?
+************************
+
+Yep: RPC targets must be async functions — the runtime rejects a
+plain ``def`` with ``TypeError: ... must be an async function!``.
+That's not zealotry, it's cancel-responsiveness: each worker is a
+full ``trio`` runtime whose msg loop is what hears graceful cancel
+requests, and a hot loop that never yields can't be (politely)
+interrupted.
+
+Two practical consequences,
+
+- CPU-bound loops should checkpoint once in a while; note how
+  ``burn_cpu()`` in the next example sprinkles ``await
+  trio.sleep()`` calls so the worker stays responsive while still
+  pegging a core,
+- if some sync call blocks a worker anyway you're still covered:
+  an unresponsive actor just rides the graceful-then-hard teardown
+  ladder from :doc:`/guide/cancellation` instead of acking its
+  cancel — slower, but never a zombie.
+
+Run a func in a process
+-----------------------
+
+Even a pool can be overkill; "run this one async func in a
+subprocess and give me the result" is a one-liner via
+:meth:`tractor.ActorNursery.run_in_actor`,
+
+.. literalinclude:: ../../examples/parallelism/single_func.py
+   :caption: examples/parallelism/single_func.py
+   :language: python
+
+``run_in_actor()`` is a *convenience wrapper* — spawn an actor, run
+exactly one task in it, reap on result — not the core spawning
+model (that's :meth:`tractor.ActorNursery.start_actor` plus
+:meth:`tractor.Portal.open_context`; see :doc:`/guide/context`).
+But for this fire-and-collect shape it's exactly the right amount
+of typing.
+
+As the module docstring suggests, run it under a process-tree
+monitor to watch the child appear and get reaped,
+
+.. code:: bash
+
+    $TERM -e watch -n 0.1  "pstree -a $$" \
+        & python examples/parallelism/single_func.py \
+        && kill $!
+
+You'll see a core get burned in both parent and child — real
+parallelism, no GIL sharing, since these are processes (i.e.
+*non-shared-memory threads*).
+
+When all you have is sync code
+------------------------------
+
+Honesty corner: if your workload is purely *synchronous* functions
+and you've zero need for IPC dialogs, streaming, daemons or
+supervision trees — i.e. you really do just want
+"``ProcessPoolExecutor`` but ``trio``-native" — the smaller,
+focused `trio-parallel`_ project may serve you better. ``tractor``
+happily covers the use case (as above) but brings a whole runtime
+along for the ride. (And when blocking I/O — not the GIL — is the
+actual problem, plain in-process :func:`trio.to_thread.run_sync`
+may be all you ever needed.)
+
+And to *see* that runtime's process-management story — a per-core
+fleet self-destructing with zero zombies left behind — go run
+``examples/parallelism/we_are_processes.py``, walked through in
+the :doc:`/start/quickstart`.
+
+.. seealso::
+
+   - :doc:`/guide/clustering` — the one-liner flat-cluster
+     convenience (``open_actor_cluster()``) for when even a
+     hand-rolled pool is too much typing,
+   - :doc:`/guide/cancellation` — why pool teardown is bulletproof
+     (graceful-then-hard escalation, no zombies),
+   - :doc:`/guide/context` — the core per-task API your pool
+     workers can graduate to.
+
+.. _trio-parallel: https://github.com/richardsheridan/trio-parallel

docs/guide/rpc.rst

@@ -0,0 +1,177 @@
+RPC: calling into other actors
+==============================
+Every spawn call from :doc:`/guide/spawning` hands you back
+a :class:`~tractor.Portal`: a live handle for calling into
+another actor's **memory domain**. The name is borrowed from
+``trio``'s portal concept — an object you use to submit work
+*into* a separate concurrency domain — except here that domain
+is a whole other process.
+
+.. d2:: diagrams/runtime_stack.d2
+   :margin:
+   :caption: The layers a ``portal.run()`` request rides through.
+   :alt: app, tractor runtime, IPC channel and OS process layers
+
+There are **no proxy objects** and no special calling
+conventions: you pass a plain function reference plus keyword
+args, and Python's normal ``await``-able semantics apply. The
+function just happens to *run somewhere else*; from the calling
+task it looks as though it was called locally. And since this is
+all structured concurrency (SC) under the hood, the remote task
+runs inside the callee's supervised task tree while its result
+— or its failure, as a boxed
+:exc:`~tractor.RemoteActorError` — always comes back to *you*.
+
+``Portal.run()``: pass the function, not a string
+-------------------------------------------------
+:meth:`~tractor.Portal.run` schedules an async function as
+a **new task** in the remote actor and waits on its result:
+
+.. code:: python
+
+    async with tractor.open_nursery() as an:
+        portal = await an.start_actor(
+            'service',
+            enable_modules=[__name__],
+        )
+        answer = await portal.run(movie_theatre_question)
+
+The rules of engagement:
+
+- the target must be an **async function** and its defining
+  module must be in the callee's ``enable_modules`` allowlist,
+  else an :exc:`~tractor.ModuleNotExposed` error is relayed
+  back (see :doc:`/guide/spawning` for the capability-allowlist
+  story).
+- arguments are passed **by keyword only**; they ride the IPC
+  layer as msgspec_-encoded msgs, so keep them serializable.
+- every call schedules a *fresh* task remotely — call it twice
+  and the callee runs two tasks, each supervised in its own
+  right.
+- remote exceptions re-raise locally as
+  :exc:`~tractor.RemoteActorError` with the original type
+  preserved via ``.boxed_type``.
+
+.. note::
+
+   Passing dotted-path *strings* to ``run()`` is an ancient,
+   deprecated form; always pass the function reference. If you
+   really need name-based addressing use ``run_from_ns()``
+   below.
+
+Namespaced daemons: ``run_from_ns()``
+-------------------------------------
+Sometimes the calling process can't (or shouldn't) import the
+target function — think a long-running rpc-daemon serving
+modules your client never loads. For that,
+:meth:`~tractor.Portal.run_from_ns` takes the explicit
+namespace path:
+
+.. code:: python
+
+    await portal.run_from_ns('mypkg.service', 'ping')
+
+This is literally how ``.run()`` works underneath: the pair is
+encoded as a ``'mod.path:func'`` style msg and resolved against
+the callee's enabled modules.
+
+One special namespace exists: ``'self'`` resolves to the remote
+:class:`~tractor.Actor` instance, i.e. the runtime itself. It's
+how internal machinery (cancel requests, registry ops) travels;
+don't build your app on it.
+
+One-shot results: ``wait_for_result()``
+---------------------------------------
+A portal returned from
+:meth:`~tractor.ActorNursery.run_in_actor` has exactly one
+"main" task running remotely; that task's ``return`` value is
+delivered as the portal's *final result*:
+
+.. code:: python
+
+    portal = await an.run_in_actor(fib, n=10)
+    final = await portal.wait_for_result()
+
+Semantics worth knowing:
+
+- it blocks until the remote task returns, re-raising any
+  remote error in the usual boxed form.
+- once resolved it's idempotent: later calls return the same
+  cached value.
+- a *daemon* portal (from ``start_actor()``) has no main task,
+  so there's no final result to wait for: you'll get a warning
+  plus a ``NoResult`` sentinel. Results of individual daemon
+  calls come straight back from each ``await portal.run()``.
+
+Pure RPC daemons: ``run_daemon()``
+----------------------------------
+When a process's *only* job is to sit at the root of its own
+tree and serve RPC, skip the boilerplate with
+:func:`tractor.run_daemon`:
+
+.. code:: python
+
+    import tractor
+
+    tractor.run_daemon(
+        ['mypkg.service'],
+        name='service',
+    )
+
+It's a blocking convenience (it calls ``trio.run()`` for you):
+boot a root actor with the given modules enabled for RPC, then
+sleep until cancelled. Pair it with the discovery system —
+:func:`tractor.find_actor` / :func:`tractor.wait_for_actor`
+from a *separate* program — and you've got a tiny service
+architecture with zero framework ceremony; see
+``examples/service_daemon_discovery.py`` for the full pattern.
+
+Fan-out: RPC through nested trees
+---------------------------------
+Portals compose. An RPC task is just a ``trio`` task, so it can
+open its own :class:`~tractor.ActorNursery` and portal into
+*its* children — one inbound call fanning out into a whole
+sub-tree of work. The mid-tier function from the nested-tree
+example:
+
+.. literalinclude:: ../../examples/nested_actor_tree.py
+   :caption: examples/nested_actor_tree.py (supervisor fan-out)
+   :language: python
+   :pyobject: fan_out_squares
+
+The root portals into the ``supervisor`` actor; the
+supervisor's RPC task spawns the leaf workers, portals into
+each, and returns the combined result back up. Failures at any
+depth relay hop-by-hop as boxed errors, and cancelling the root
+call tears down the entire sub-tree — SC, transitively.
+
+When to graduate to ``Context``
+-------------------------------
+``portal.run()`` is great for one-shot, request-response calls.
+Reach for :meth:`~tractor.Portal.open_context` with an
+``@tractor.context`` endpoint as soon as you want:
+
+- a long-lived dialog with state held on both sides,
+- bidirectional streaming via ``ctx.open_stream()``,
+- typed payload contracts (``pld_spec``) enforced at the msg
+  layer,
+- or *task-scoped* cancellation: ``Context.cancel()`` cancels
+  just the linked remote task, whereas
+  :meth:`~tractor.Portal.cancel_actor` nukes the **entire**
+  remote runtime and its process.
+
+In fact the source plans for ``Portal.run()`` itself to be
+rebuilt on top of ``open_context()`` — contexts *are* the core
+inter-actor protocol. Take the full tour in
+:doc:`/guide/context`.
+
+.. seealso::
+
+   - :doc:`/guide/spawning` — where portals come from and how
+     their actors are supervised.
+   - :doc:`/guide/context` — the structured cross-actor task
+     API: handshake, streaming, typed payloads.
+   - :doc:`/guide/cancellation` — what happens to in-flight RPC
+     when trees get torn down.
+
+.. _msgspec: https://jcristharif.com/msgspec/

docs/guide/spawning.rst

@@ -0,0 +1,299 @@
+Spawning actors
+===============
+If you know trio_ you know the drill: you don't get to launch
+a task off into the void, you open a nursery_, the nursery owns
+the task, and the block can't exit until every child is done.
+That discipline is `structured concurrency`_ (SC) — see the
+seminal `blog post`_ if you haven't yet — and it's the whole
+religion around here.
+
+``tractor`` applies that exact discipline to **processes**: an
+:class:`~tractor.ActorNursery` is a *process nursery*. Every
+"task" it starts is a fresh Python process running its own
+``trio.run()``-scheduled task tree; we call each one a
+``trio``-"*actor*". Parents must wait on (and clean up after)
+their children, transitively, all the way down the tree.
+
+.. d2:: diagrams/actor_tree.d2
+   :caption: A process tree of ``trio``-task-trees.
+   :alt: a nested actor tree where every parent supervises its children
+
+Though a "process nursery" differs in complexity (and slightly
+in semantics) from a single-threaded task nursery, most of the
+interface is the same. The main difference is that each spawned
+child contains a full, *parallel-executing* ``trio`` task tree.
+The following super powers ensue:
+
+- tasks started in a child actor are completely independent of
+  tasks started in the current process; they execute in
+  **parallel** and are scheduled by their own actor's ``trio``
+  run loop.
+- tasks scheduled in a remote process still maintain an SC
+  protocol *across memory boundaries* using a so called
+  "SC dialogue protocol" which keeps task-hierarchy lifetimes
+  linked across the IPC layer.
+- a remote task can fail and have that failure relayed back to
+  the caller task (living in some other actor) as a serialized
+  :exc:`~tractor.RemoteActorError`; no spawned process or RPC
+  task can ever just go off on its own.
+
+Opening a (process) nursery
+---------------------------
+:func:`tractor.open_nursery` is the entrypoint:
+
+.. code:: python
+
+    async def main():
+        async with tractor.open_nursery() as an:
+            ...  # spawn some actors B)
+
+    trio.run(main)
+
+Notice there's no runtime-boot ceremony: if no actor runtime is
+up yet (i.e. you're in a plain old Python process),
+``open_nursery()`` *implicitly* enters
+:func:`tractor.open_root_actor` for you, making this process the
+**root actor** of a new tree. Any extra keyword args you pass
+are proxied straight through to ``open_root_actor()``, so the
+runtime config lives wherever you open your first nursery:
+
+.. code:: python
+
+    async with tractor.open_nursery(
+        loglevel='info',
+        debug_mode=True,  # crash-to-REPL for the whole tree
+    ) as an:
+        ...
+
+If you want the runtime up *without* spawning anything (or you
+prefer the config to be loudly explicit) enter
+``open_root_actor()`` yourself first; the nursery will detect
+the running runtime and skip the implicit boot. Either way,
+nesting a second root inside an existing tree is an error.
+
+Inside a *subactor* the same call just works: any actor may open
+nurseries of its own, which is how you get arbitrarily deep
+trees (more on that below).
+
+``start_actor()``: daemons that live until cancelled
+----------------------------------------------------
+:meth:`~tractor.ActorNursery.start_actor` is **the** core
+spawning primitive. It starts a *daemon* actor: a process with
+no designated "main task" besides the runtime itself. It boots,
+registers with its parent, and then sits there serving RPC
+requests until somebody cancels it. You get back a
+:class:`~tractor.Portal` for doing exactly that kind of
+somebody-ing:
+
+.. literalinclude:: ../../examples/actor_spawning_and_causality_with_daemon.py
+   :caption: examples/actor_spawning_and_causality_with_daemon.py
+   :language: python
+
+What's going on here?
+
+- ``start_actor('frank', enable_modules=[__name__])`` forks off
+  a new process, boots a ``tractor`` runtime inside it, and
+  allows it to serve functions from the current module (see the
+  allowlist section below).
+- each ``await portal.run(...)`` schedules a *new* task in
+  frank's task tree and waits on its result — the full RPC story
+  lives in :doc:`/guide/rpc`.
+- frank has no main task to complete, so without the final
+  ``await portal.cancel_actor()`` the nursery block would wait
+  on him **forever**. Daemon lifetimes are *yours* to end; that
+  explicitness is the point.
+
+``run_in_actor()``: quick one-shot parallelism
+----------------------------------------------
+:meth:`~tractor.ActorNursery.run_in_actor` is the convenience
+wrapper: spawn an actor, run exactly one async function in it,
+then reap the process as soon as the result arrives.
+
+.. code:: python
+
+    async with tractor.open_nursery() as an:
+        portal = await an.run_in_actor(burn_cpu)
+        # burn rubber in the parent too...
+        await burn_cpu()
+        total = await portal.wait_for_result()
+
+A few details worth knowing:
+
+- the actor is named after the function unless you pass
+  ``name='something_cuter'``.
+- the function's module is auto-added to the child's
+  ``enable_modules`` allowlist.
+- extra ``**kwargs`` are forwarded to the function itself.
+- the child is *auto-cancelled* once its "main" result lands;
+  at nursery exit these run-once children are always reaped
+  first (causality_ is paramount!).
+
+.. note::
+
+   ``run_in_actor()`` is a convenience, **not** the core model.
+   The source literally marks it for an eventual rebuild as
+   a thin "hilevel" wrapper on top of
+   :meth:`~tractor.Portal.open_context` (the modern inter-actor
+   task API). Teach your fingers to use it for quick
+   fire-and-collect parallelism — think a per-function
+   trio-parallel_ style one-shot — and reach for
+   ``start_actor()`` + ``open_context()`` for anything
+   long-lived, stateful or streaming
+   (:doc:`/guide/context`).
+
+Actor lifetimes and teardown order
+----------------------------------
+So we have two lifetime flavors:
+
+- **run-once** (``run_in_actor()``): lives exactly as long as
+  its single task; reaped the moment its result (or error)
+  arrives.
+- **daemon** (``start_actor()``): lives until *someone* cancels
+  it — an explicit ``await portal.cancel_actor()``, a bulk
+  ``await an.cancel()``, or the one-cancels-all strategy kicking
+  in on error.
+
+On a clean exit of the nursery block the teardown order is:
+
+1. the nursery waits on every run-once actor's final result;
+   any errors from these are raised immediately so your code
+   (acting as supervisor) gets first crack at handling them.
+2. then it waits on daemon actors — **indefinitely**. If you
+   spawned a daemon, you own its lifetime.
+
+When a child *is* cancelled, teardown is graceful-first per SC
+discipline: the runtime sends an IPC cancel request and gives
+the child a bounded window to ack; only when a child is too
+slow does the nursery escalate to an OS-level hard kill of the
+process. There is no path where a child is silently left
+running:
+
+    ``tractor`` tries to protect you from zombies, no matter
+    what. If you can create zombie child processes (without
+    using a system signal) it **is a bug**.
+
+Per-process cleanup hooks
+*************************
+Need something torn down when an actor's runtime exits, no
+matter how it exits? Every actor carries
+a process-global :class:`contextlib.ExitStack` at
+``Actor.lifetime_stack`` which is closed at the very end of
+runtime teardown:
+
+.. code:: python
+
+    db = await connect_db()
+    tractor.current_actor().lifetime_stack.callback(db.close)
+
+(A so-far under-advertised api — expect it to get more love.)
+
+When things blow up: one-cancels-all
+------------------------------------
+The default (and currently only) supervision strategy is the
+same one ``trio`` nurseries use: **one-cancels-all**. If your
+nursery-block body errors, every child actor is cancelled. If
+a child errors, the failure is relayed to the nursery as a
+boxed :exc:`~tractor.RemoteActorError` (original type preserved
+via ``.boxed_type``), all *other* children are cancelled, and
+the error(s) re-raise locally — exactly like ``trio``, just
+process-wide. Erlang-style alternative strategies are a long
+standing roadmap item.
+
+The full story — how cancel requests relay across the tree, who
+``.canceller`` was, debugging mid-teardown — lives in
+:doc:`/guide/cancellation`.
+
+The module allowlist: ``enable_modules``
+----------------------------------------
+A subactor will only serve functions from modules its parent
+*explicitly* enabled at spawn time:
+
+.. code:: python
+
+    portal = await an.start_actor(
+        'service',
+        enable_modules=['mypkg.service'],  # or [__name__]
+    )
+
+At child boot the runtime imports each listed module so inbound
+RPC requests can resolve function references against it. Ask
+a peer to run something from any *other* module and you get an
+:exc:`~tractor.ModuleNotExposed` error relayed back — the child
+never even looks the function up.
+
+Think of it as the first, deliberately coarse layer of
+capability-style permissioning: if you don't hand an actor
+a module, no peer can invoke anything inside it. (Finer-grained
+capability-based messaging protocols are on the roadmap.)
+
+The ``enable_modules=[__name__]`` idiom — "let the child run
+functions from the *current* module" — is what you'll use in
+most scripts; bigger apps tend to pass dedicated service-module
+paths instead.
+
+Per-child knobs
+---------------
+Both spawn methods accept per-child config so one weird child
+doesn't have to drag the whole tree along:
+
+- ``loglevel='cancel'`` — crank console logging for just this
+  subactor (the ``TRACTOR_LOGLEVEL`` env var overrides whatever
+  the *root* was passed, handy for test runs).
+- ``debug_mode=True`` — arm the crash-handling REPL machinery
+  for just this child instead of tree-wide, i.e. the selective
+  flavor of ``open_nursery(debug_mode=True)``; see
+  :doc:`/guide/debugging` for the multi-process debugger tour.
+- ``infect_asyncio=True`` — run the child with ``trio`` as an
+  ``asyncio`` guest, aka "infected asyncio" mode.
+- ``enable_transports=['uds']`` — pick the IPC transport this
+  child should listen on (default ``'tcp'``).
+
+Trees all the way down
+----------------------
+Since any actor can open an ``ActorNursery``, supervision trees
+compose to arbitrary depth: a subactor can be a supervisor of
+*its own* subactors, with every level holding the same SC
+guarantees — error relay up, cancellation down, no orphans.
+
+.. literalinclude:: ../../examples/nested_actor_tree.py
+   :caption: examples/nested_actor_tree.py
+   :language: python
+
+Here the root spawns a ``supervisor`` actor whose RPC task opens
+its *own* nursery and spawns the leaf workers; one call from the
+root fans out through the middle layer and the aggregate comes
+back up. Teardown ripples in reverse: the leaves are reaped when
+the supervisor's nursery exits, the supervisor when the root
+cancels it.
+
+Watching your tree grow
+-----------------------
+Actors are real processes, so your favorite system tools just
+work. The house incantation runs any example beside a live
+process-tree monitor::
+
+    $TERM -e watch -n 0.1 "pstree -a $$" \
+        & python examples/nested_actor_tree.py \
+        && kill $!
+
+Every subactor also sets its OS process title to a stable
+``_subactor[<name>@<uuid-prefix>]`` marker, so ``htop``,
+``ps`` and friends show *which actor is which* at a glance::
+
+    pgrep -af '_subactor\['
+
+.. seealso::
+
+   - :doc:`/guide/rpc` — actually invoking functions through
+     all these portals you've been collecting.
+   - :doc:`/guide/context` — the structured, streaming-capable
+     inter-actor task API.
+   - :doc:`/guide/cancellation` — cross-actor cancellation and
+     error propagation semantics in depth.
+
+.. _trio: https://github.com/python-trio/trio
+.. _nursery: https://trio.readthedocs.io/en/latest/reference-core.html#nurseries-and-spawning
+.. _structured concurrency: https://en.wikipedia.org/wiki/Structured_concurrency
+.. _blog post: https://vorpus.org/blog/notes-on-structured-concurrency-or-go-statement-considered-harmful/
+.. _causality: https://vorpus.org/blog/some-thoughts-on-asynchronous-api-design-in-a-post-asyncawait-world/#c-c-c-c-causality-breaker
+.. _trio-parallel: https://github.com/richardsheridan/trio-parallel

docs/guide/streaming.rst

@@ -0,0 +1,244 @@
+Cross-process streaming
+=======================
+
+Spawning processes is the boring half of ``tractor``: the **real
+cool stuff** is the native support for cross-process *streaming*.
+Yes, you saw it here first — 2-way msg streams with reliable,
+transitive setup/teardown semantics, wired straight into the
+runtime's `structured concurrency`_ (SC) supervision machinery so
+that *how* a stream ends is part of the protocol.
+
+No broker, no topic exchange, no IDL compiler. The IPC layer is a
+deliberately "`cheap or nasty`_" `(un)protocol`_: a tiny set of
+msgspec_-typed msgs over a transport (TCP or UDS today) with
+payload typing opt-in per dialog — handshake msgs get the *nasty*
+treatment (strict validation) while high-rate stream payloads
+stay *cheap* (receiver-side checks only). See
+:doc:`/guide/context` for the typed ``pld_spec`` contract bits.
+
+Two ways to stream
+------------------
+
+.. margin:: It's a ``trio.abc.Channel``
+
+   :class:`tractor.MsgStream` implements
+   :class:`trio.abc.Channel` — ``send()``,
+   ``receive()``, async-iteration, ``aclose()`` —
+   so trio-generic channel code drives an IPC
+   stream unchanged.
+
+- **Bidirectional, context-based**: open a
+  :class:`tractor.Context` to a peer task then enter
+  ``ctx.open_stream()`` for a full-duplex
+  :class:`tractor.MsgStream`. This is the modern core API, taught
+  end-to-end in :doc:`/guide/context`; we won't re-teach it here.
+
+- **One-way, portal-based**: point
+  :meth:`tractor.Portal.open_stream_from` at a plain async
+  generator fn in the peer actor. Legacy, but perfectly fine for
+  simple produce/consume pipelines — and it powers the classic
+  examples below.
+
+Rule of thumb: if the consumer ever needs to *talk back* — acks,
+control msgs, a final result — use a context. If it's a pure
+pipeline stage, either works and the one-way form is less typing.
+
+One-way streaming from an async generator
+-----------------------------------------
+
+The OG api. Write an async generator in the target actor's
+module; iterate its yields from the spawning side:
+
+.. literalinclude:: ../../examples/asynchronous_generators.py
+   :caption: examples/asynchronous_generators.py
+   :language: python
+
+Each ``yield`` crosses the process boundary as one msg and feeds
+the parent's ``async for``. When the consumer ``break``\ s out
+and exits the ``open_stream_from()`` block the far-end generator
+task is cancelled for you: the producer's lifetime is *coupled to
+the consumer's scope* so a one-way stream can never leak a remote
+task.
+
+Any extra kwargs (``stream_data, seed=100`` style) are forwarded
+to the remote generator's call, and a non-async-gen target is
+rejected up front with a ``TypeError``.
+
+.. note::
+
+   No decorator required — any plain async-gen fn works. You may
+   still meet ``@tractor.stream`` in the wild; it's the legacy
+   marker for one-way endpoints and sticks around only for
+   compat (heads up: the param name ``ctx`` is reserved for
+   ``@context`` endpoints nowadays, so legacy fns should call
+   theirs ``stream``). New code wanting anything fancier than a
+   one-way pipe should use :func:`tractor.context` +
+   ``ctx.open_stream()``.
+
+.. warning::
+
+   One-way means one way: there's no sending *to* the generator
+   side and no graceful consumer-to-producer stop msg — the
+   teardown above is cancel-based. Needing upstream control flow
+   is the sign you've outgrown this API.
+
+A full-fledged streaming service
+--------------------------------
+
+Now let's get fancy: compose one-way streams through a nested
+actor tree and you've got yourself a fan-in pipeline.
+
+.. d2:: diagrams/streaming_pipeline.d2
+   :caption: Four actors, three streams, one deduped feed.
+   :alt: two streamer actors fan in to an aggregator then root
+
+.. literalinclude:: ../../examples/full_fledged_streaming_service.py
+   :caption: examples/full_fledged_streaming_service.py
+   :language: python
+
+What's going on?
+
+- the root actor spawns ``'aggregator'`` which opens its *own*
+  actor nursery and spawns ``'streamer_1'`` + ``'streamer_2'``: 4
+  processes total, supervision nested two levels deep with zero
+  special casing.
+
+- ``aggregate()`` opens a one-way stream from each streamer and
+  fans both into a single :func:`trio.open_memory_channel` via
+  one local trio task per portal — in-actor fan-in riding trio's
+  built-in backpressure end-to-end.
+
+- duplicates get dropped via a ``set`` and the deduped sequence
+  is *re-yielded* upward: ``aggregate()`` is itself an async gen
+  being consumed over IPC by the root. Streams compose.
+
+- when the seed runs out the streamer gens finish, the memory
+  channel drains closed, the aggregator's gen returns and the
+  root's ``async for`` ends; ``await an.cancel()`` then reaps the
+  subtree. Every exit is awaited — if you can produce a zombie
+  process from this, it **is a bug**.
+
+Watch the tree breathe while it runs, using the README's
+signature process-monitor incantation::
+
+    $TERM -e watch -n 0.1  "pstree -a $$" \
+        & python examples/full_fledged_streaming_service.py \
+        && kill $!
+
+No extra threads, no fancy semaphores, no futures; all we need is
+``tractor``'s IPC.
+
+Two streams, one portal
+-----------------------
+
+Every ``open_stream_from()`` call starts its *own* remote task —
+even through the same portal — so two local consumer tasks can
+independently stream the same generator fn concurrently, both
+dialogs multiplexed over the single underlying IPC channel:
+
+.. literalinclude:: ../../examples/multiple_streams_one_portal.py
+   :caption: examples/multiple_streams_one_portal.py
+   :language: python
+
+The add-else-remove trick on the shared ``consumed`` list is the
+proof: each value arrives in *both* streams, getting appended by
+whichever task sees it first and removed by the other, so the
+list always ends up empty. Two streams, same data, zero
+interference.
+
+This works because every dialog is keyed by its own context id
+(``Context.cid``) — any number of concurrent streams, contexts
+and one-shot RPCs share a single underlying
+:class:`tractor.Channel` per peer pair.
+
+Fan-out inside an actor: ``MsgStream.subscribe()``
+--------------------------------------------------
+
+The inverse pattern: *one* IPC stream feeding *many* local tasks.
+Instead of paying for N redundant cross-process streams, call
+:meth:`tractor.MsgStream.subscribe` to get a
+``BroadcastReceiver`` — a tokio-style broadcast channel from
+``tractor.trionics`` — which copies every received value to each
+subscribed task:
+
+.. literalinclude:: ../../examples/streaming_broadcast_fanout.py
+   :caption: examples/streaming_broadcast_fanout.py
+   :language: python
+
+Each task entering ``stream.subscribe()`` receives its own copy
+of everything sent from that point on. The underlying stream
+keeps pace with the *fastest* subscriber; a task falling more
+than the buffered window behind has its next receive raise
+``tractor.trionics.Lagged`` to say it lost data.
+
+The broadcast handle stays duplex btw: it proxies ``send()``
+through to the underlying stream, so each subscriber task can
+keep talking upstream while consuming its fan-out copy.
+
+.. warning::
+
+   ``.subscribe()`` is **idempotent and non-reversible**: the
+   first call permanently swaps the stream's receive machinery
+   over to the internally allocated broadcaster. There's no
+   un-subscribing back to the raw stream, so make sure you're ok
+   with the (theoretical) overhead before opting in.
+
+Consuming: ``async for`` and friends
+------------------------------------
+
+``async for msg in stream:`` is just sugar over repeated
+``await stream.receive()``. The receive-side surface:
+
+- ``receive()`` — next msg, or raises :exc:`trio.EndOfChannel`
+  on a graceful far-end close (``async for`` translates that
+  into a clean loop exit for you).
+
+- ``receive_nowait()`` — opportunistic, non-blocking drain.
+
+- ``closed`` — property flagging an already-ended stream.
+
+Send-side it's just ``await stream.send(data)`` — one ``Yield``
+msg per call carrying any msgspec_-encodable payload (or
+whatever your ``pld_spec`` permits, see :doc:`/guide/context`).
+
+End-of-stream: close vs. cancel
+-------------------------------
+
+How a stream ends is part of the protocol; the runtime keeps the
+polite case and the violent case distinct:
+
+- **graceful close**: the far side exits its stream block, its
+  async gen returns, or it calls ``await stream.aclose()``. A
+  ``Stop`` msg is sent so your ``async for`` simply ends
+  (``StopAsyncIteration``, via :exc:`trio.EndOfChannel` under the
+  hood). A normal, non-error ending — the dialog's result phase
+  proceeds as usual.
+
+- **cancel or error**: no ``Stop`` is sent. Instead the
+  cancel/error itself is relayed so the far end *knows* the
+  dialog did not end on purpose and raises accordingly — a
+  :exc:`tractor.ContextCancelled`, a boxed
+  :exc:`tractor.RemoteActorError`, etc. See the cancellation
+  section of :doc:`/guide/context` for exactly who raises what.
+
+Tying it together: every ``MsgStream`` is **one-shot use**. Both
+endings are final — once closed a stream can't be re-opened and
+the supported "retry" is opening a fresh :class:`tractor.Context`
+(they're cheap).
+
+.. seealso::
+
+   - :doc:`/guide/context` — the full ``Context`` lifecycle: the
+     handshake, results, cancellation semantics and the
+     overrun/backpressure knobs.
+
+   - :class:`tractor.MsgStream` and
+     :meth:`tractor.Portal.open_stream_from` API docs.
+
+   - The zguide chapters our wire philosophy is named after:
+     "`cheap or nasty`_" and `(un)protocol`_\ s.
+
+.. _structured concurrency: https://en.wikipedia.org/wiki/Structured_concurrency
+.. _cheap or nasty: https://zguide.zeromq.org/docs/chapter7/#The-Cheap-or-Nasty-Pattern
+.. _(un)protocol: https://zguide.zeromq.org/docs/chapter7/#Unprotocols
+.. _msgspec: https://jcristharif.com/msgspec/

docs/guide/testing.rst

@@ -0,0 +1,256 @@
+Testing tips
+============
+
+``tractor``'s test suite is a different kind of beast than your
+average single-proc pytest run: nearly every test spawns a real
+**process tree**, hammers on cancellation under structured
+concurrency (SC), and tears the whole thing down again — hundreds
+of times per session. This page collects the tips, knobs and
+one-liners that make hacking on (and with) the suite pleasant.
+
+Running the suite
+-----------------
+
+This is a uv_-managed project, so after cloning it's just::
+
+    uv sync --dev
+    uv run pytest tests/
+
+Expect a *lot* of process churn; the suite is effectively a
+rolling chaos exercise for the runtime.
+
+The classic fix-iterate loop when something breaks::
+
+    # stop at the first failure
+    uv run pytest tests/ -x
+
+    # then iterate on just the failures til green
+    uv run pytest --lf -x
+
+``--lf`` (last-failed) re-runs only what failed previously, so
+combined with ``-x`` you get a tight one-test-at-a-time repair
+loop.
+
+Suite-specific flags
+********************
+
+The repo auto-loads the bundled ``tractor._testing.pytest`` plugin
+(via ``addopts`` in ``pyproject.toml``) which adds a few extra
+flags:
+
+- ``--spawn-backend <key>``: pick the process spawn backend for
+  the session (default ``'trio'``); same keys as the
+  ``start_method`` runtime argument,
+
+- ``--tpt-proto <key> [...]``: which IPC transport(s) opting-in
+  suites should run against, eg. ``--tpt-proto uds``,
+
+- ``--tpdb`` / ``--debug-mode``: flip on the ``debug_mode``
+  fixture so debugger-aware tests boot their trees with the
+  crash-REPL enabled,
+
+- ``--enable-stackscope``: install the ``SIGUSR1`` task-tree dump
+  handler in pytest *and* every spawned subactor — much lighter
+  than a full debug-mode run when you only need stack visibility
+  during a hang hunt,
+
+- ``--ll <level>`` / ``--tl <level-or-spec>``: console loglevels;
+  ``--tl`` targets the ``tractor``-as-runtime logger and accepts
+  a per-subsystem spec like ``'devx:runtime,trionics:cancel'``.
+
+Watch the tree grow
+-------------------
+
+The single most useful trick while the suite (or any ``tractor``
+app) runs: keep a live ``pstree`` view going in a side terminal::
+
+    watch -n 0.1 "pstree -a $(pgrep -f pytest)"
+
+You'll see actor processes pop in and out of existence as each
+test builds and reaps its tree. Launch it *after* pytest is up
+(the pid is substituted once, at ``watch`` startup).
+
+Every subactor also sets its OS process title (via
+``setproctitle``) to ``_subactor[<name>@<uuid-prefix>]`` so the
+tree view shows *which actor is which* at a glance — and targeted
+greps stay easy::
+
+    pgrep -af '_subactor\['
+
+For a single example script, the repo's signature incantation
+spawns the watcher alongside your program and cleans it up after::
+
+    $TERM -e watch -n 0.1 "pstree -a $$" \
+        & python examples/parallelism/single_func.py \
+        && kill $!
+
+Env-var knobs
+-------------
+
+Two env-vars override their corresponding runtime arguments
+*globally* — no application (or test) code changes required:
+
+``TRACTOR_SPAWN_METHOD``
+    Wins over any caller-passed ``start_method`` so you can drive
+    the whole suite (or any app) under a different spawn backend::
+
+        TRACTOR_SPAWN_METHOD=mp_spawn uv run pytest tests/ -x
+
+``TRACTOR_LOGLEVEL``
+    Wins over any caller-passed ``loglevel``; crank (or silence)
+    runtime console verbosity wholesale::
+
+        TRACTOR_LOGLEVEL=cancel uv run pytest tests/ -x -s
+
+``TRACTOR_ENABLE_STACKSCOPE``
+    Force-install the ``SIGUSR1`` task-tree dump handler in every
+    actor, debug-mode or not; then
+    ``pkill --signal SIGUSR1 -f <part-of-cmd>`` dumps every
+    actor's live ``trio`` task tree.
+
+Debug mode vs. pytest capture
+-----------------------------
+
+The tree-wide crash-to-REPL experience (``debug_mode=True`` plus
+``await tractor.pause()``) requires a **real tty**, and pytest's
+default output capturing swallows exactly that. When you want to
+interact with the REPL from inside a test run, disable capture::
+
+    uv run pytest tests/test_foo.py -x -s
+
+(``-s`` is shorthand for ``--capture=no``.)
+
+Tests should request the ``debug_mode`` fixture (driven by the
+``--tpdb`` flag) rather than hard-coding it, so that normal CI
+runs stay non-interactive.
+
+For *automated* REPL interaction — asserting on prompt output,
+sending debugger commands — you can't just turn capture off;
+instead do what ``tests/devx/`` does: drive a child Python program
+through pexpect_ on a real pseudo-tty and pattern-match the
+``(Pdb+)`` prompts. See ``tests/devx/test_debugger.py`` for many
+worked patterns.
+
+Examples *are* tests
+--------------------
+
+Every script under ``examples/`` is run as a subprocess by
+``tests/test_docs_examples.py``; since these docs
+``literalinclude`` those same scripts, the code you read here is
+CI-verified on every push and can never silently rot B)
+
+Conventions when adding a new example:
+
+- make it a standalone runnable script with the usual guard::
+
+      if __name__ == '__main__':
+          trio.run(main)
+
+- it must exit cleanly (returncode ``0``) within the per-example
+  timeout (~16s locally, with headroom auto-added in CI and under
+  cpu-freq scaling) — keep sleeps short,
+
+- any stderr line containing ``Error`` fails the test, so silence
+  or assert-around expected error output,
+
+- don't crank ``tractor`` logging inside an example: subprocess
+  pipe **backpressure can deadlock** the run (ask us how we
+  know..),
+
+- filenames starting with ``_`` are skipped (the WIP convention),
+  as are the special subdirs (``debugging/``, ``integration/``,
+  ``advanced_faults/``, ``trio/``) which are driven by their own
+  dedicated suites instead.
+
+Drop your script in, run the example suite, profit::
+
+    uv run pytest tests/test_docs_examples.py -x
+
+Zombie cleanup
+--------------
+
+First, the contract: ``tractor`` **always** reaps its children —
+if you can create a zombie process (without resorting to
+untrappable signals) it **is a bug**, please report it!
+
+That said, while hacking on the *runtime itself* you can
+definitely wedge things — a ``SIGKILL``-ed pytest, a half-broken
+spawn backend — and strand subactor procs plus their shm segments
+and UDS socket files. The repo ships a dedicated cleanup tool::
+
+    uv run scripts/tractor-reap --shm --uds
+
+It's SC-polite even as a reaper: matched processes get ``SIGINT``
+first with a bounded grace window — so actor runtimes can run
+their ``trio`` teardown paths — escalating to ``SIGKILL`` only as
+a last resort. The ``--shm`` sweep unlinks ``/dev/shm/`` segments
+that no live process has open (it leans on psutil_, already in
+your dev venv, to check live mappings and fds) and ``--uds``
+clears socket files whose binder pid is dead.
+
+Testing your own ``tractor`` app
+--------------------------------
+
+The same plugin the suite uses ships in the package, so your
+project can load it too::
+
+    [tool.pytest.ini_options]
+    addopts = ['-p tractor._testing.pytest']
+
+That buys you the CLI flags above plus a set of fixtures —
+``loglevel``, ``debug_mode``, ``reg_addr`` (a session-unique
+registrar address so concurrent runs and other live ``tractor``
+apps on the host can't cross-talk) — and the ``@tractor_test``
+decorator:
+
+.. code:: python
+
+    import tractor
+    from tractor._testing import tractor_test
+
+    @tractor_test
+    async def test_my_service(
+        reg_addr: tuple,
+        loglevel: str,
+    ):
+        # already inside a root actor's trio task!
+        async with tractor.open_nursery() as an:
+            ...
+
+The decorator boots a root actor around your (async) test fn,
+wires any of the special fixtures you declare (``reg_addr``,
+``loglevel``, ``start_method``, ``debug_mode``) into
+``open_root_actor()``, and runs the body as the root-most task
+under a wall-clock ``trio.fail_after()`` guard.
+
+General advice that has served this suite well:
+
+- bound waits with ``trio.fail_after()`` *inside* tests; global
+  pytest timeout plugins interact badly with multi-process
+  ``trio`` teardown,
+
+- use the ``reg_addr`` fixture (or otherwise randomize your
+  registry addrs) so leftover registrars from prior runs can't
+  contaminate lookups,
+
+- assert on **structured outcomes** — eg.
+  ``RemoteActorError.boxed_type`` or
+  ``ContextCancelled.canceller`` — not on log text.
+
+.. note::
+   ``tractor._testing`` is still an underscore-internal namespace:
+   shipped and handy, but its API may shift between alpha
+   releases.
+
+(This page exists thanks to the ask in `#126`_.)
+
+.. seealso::
+   - :doc:`/guide/discovery` — how registrar wiring (the thing
+     ``reg_addr`` randomizes) works in the runtime proper.
+   - :doc:`/project/dev-tips` — contributor-oriented extras:
+     releases, log-system tracing, tree-monitoring recipes.
+
+.. _uv: https://docs.astral.sh/uv/
+.. _pexpect: https://pexpect.readthedocs.io/en/stable/
+.. _psutil: https://psutil.readthedocs.io/en/latest/
+.. _#126: https://github.com/goodboy/tractor/issues/126

docs/index.rst

@@ -1,612 +1,151 @@
-.. tractor documentation master file, created by
+tractor
-   sphinx-quickstart on Sun Feb  9 22:26:51 2020.
+=======
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
 
-``tractor``
+.. raw:: html
-===========
+   :file: _static/tractor_hero.html
 
-A `structured concurrent`_, async-native "`actor model`_" built on trio_ and multiprocessing_.
+``tractor`` provides parallelism via ``trio``
+*"actors"*:
+
+- independent Python **processes** each running a
+  ``trio`` task tree,
+- all composed into a *distributed supervision tree*
+  with end-to-end SC_,
+- spawning, cancellation, error propagation and
+  teardown that work **across processes** (and hosts)
+  exactly the way they work across tasks.
+
+Sixty seconds of why
+--------------------
+.. margin:: tl;dr
+
+   It's **just** ``trio``, but with nurseries that
+   spawn *processes* and streams that cross them. If
+   you can read a ``trio`` program you can read a
+   ``tractor`` one — that's the whole pitch.
+
+Spawn one actor per core, open a ``Context`` into
+each — the child ``started()``-handshakes its name
+and pid back — then crash the root on purpose and
+watch the runtime contain the blast: errors
+propagate, *every* child is reaped, zero zombies —
+guaranteed (it's a bug otherwise).
+
+.. literalinclude:: ../examples/parallelism/we_are_processes.py
+   :caption: examples/parallelism/we_are_processes.py
+   :language: python
+
+Like every snippet in these docs this file lives in
+the repo's ``examples/`` dir and runs under CI — docs
+code that can't rot.
+
+Dig in
+------
+.. grid:: 1 2 2 3
+   :gutter: 3
+
+   .. grid-item-card:: Get started
+      :link: start/index
+      :link-type: doc
+
+      Install + your first actor tree in ~20 lines;
+      causality, daemons and the trynamic scene.
+
+   .. grid-item-card:: The big ideas
+      :link: explain/sc-distributed
+      :link-type: doc
+
+      SC across processes, distilled — then the
+      runtime architecture under it.
+
+   .. grid-item-card:: Debug like a local
+      :link: guide/debugging
+      :link-type: doc
+
+      ``await tractor.pause()`` anywhere in the
+      tree: one terminal, every process, zero
+      socket-juggling.
+
+   .. grid-item-card:: Streaming + contexts
+      :link: guide/context
+      :link-type: doc
+
+      Bidirectional, cancellation-safe msg streams
+      between any two actors.
+
+   .. grid-item-card:: Guides
+      :link: guide/index
+      :link-type: doc
+
+      RPC, supervision, clustering, "infected
+      asyncio", typed msging + more.
+
+   .. grid-item-card:: API reference
+      :link: api/index
+      :link-type: doc
+
+      The curated public surface; everything
+      importable from ``tractor``.
+
+Features
+--------
+- **It's just a** ``trio`` **API** — same nursery
+  discipline, same cancellation semantics, one level
+  up the process tree.
+- *Infinitely nestable* process trees: sub-actors can
+  spawn sub-actors, supervision stays transitive.
+- A "native UX" **multi-process debugger REPL**:
+  built on pdbp_ with tree-wide tty locking (see
+  :doc:`guide/debugging`).
+- Built-in, cancellation-safe **bidirectional
+  streaming** via a `cheap or nasty`_ `(un)protocol`_.
+- **Typed IPC**: `msgspec`_-backed wire msgs with
+  optional per-dialog payload specs
+  (:doc:`guide/msging`).
+- Swappable process-spawn backends + modular IPC
+  transports (TCP today, UDS on same-host, more
+  planned).
+- Optionally distributed_: the same APIs work over
+  multiple hosts as on multiple cores.
+- "**Infected** ``asyncio``" mode: SC-supervise
+  ``asyncio`` tasks from ``trio``
+  (:doc:`guide/asyncio`).
+- ``trio`` extension goodies via ``tractor.trionics``
+  (acm gathering, single-resource caching, broadcast
+  channels).
+
+Where do i start!?
+------------------
+The first step to grok ``tractor`` is to get an
+intermediate knowledge of ``trio`` and **structured
+concurrency** B)
+
+Some great places to start are,
+
+- the seminal `blog post`_,
+- obviously the `trio docs`_,
+- wikipedia's nascent SC_ page,
+- the fancy diagrams @ libdill-docs_,
+
+then come back and hit :doc:`start/quickstart`.
 
 .. toctree::
-   :maxdepth: 1
+   :hidden:
-   :caption: Contents:
+   :maxdepth: 2
+
+   Get started <start/index>
+   Big ideas <explain/index>
+   Guides <guide/index>
+   API <api/index>
+   Project <project/index>
 
-.. _actor model: https://en.wikipedia.org/wiki/Actor_model
 .. _trio: https://github.com/python-trio/trio
-.. _multiprocessing: https://en.wikipedia.org/wiki/Multiprocessing
+.. _SC: https://en.wikipedia.org/wiki/Structured_concurrency
-.. _trionic: https://trio.readthedocs.io/en/latest/design.html#high-level-design-principles
-.. _async sandwich: https://trio.readthedocs.io/en/latest/tutorial.html#async-sandwich
-.. _structured concurrent: https://trio.discourse.group/t/concise-definition-of-structured-concurrency/228
-
-
-``tractor`` is an attempt to bring trionic_ `structured concurrency`_ to
-distributed multi-core Python; it aims to be the Python multi-processing
-framework *you always wanted*.
-
-``tractor`` lets you spawn ``trio`` *"actors"*: processes which each run
-a ``trio`` scheduled task tree (also known as an `async sandwich`_).
-*Actors* communicate by exchanging asynchronous messages_ and avoid
-sharing any state. This model allows for highly distributed software
-architecture which works just as well on multiple cores as it does over
-many hosts.
-
-The first step to grok ``tractor`` is to get the basics of ``trio`` down.
-A great place to start is the `trio docs`_ and this `blog post`_.
-
-.. _messages: https://en.wikipedia.org/wiki/Message_passing
-.. _trio docs: https://trio.readthedocs.io/en/latest/
 .. _blog post: https://vorpus.org/blog/notes-on-structured-concurrency-or-go-statement-considered-harmful/
-.. _structured concurrency: https://vorpus.org/blog/notes-on-structured-concurrency-or-go-statement-considered-harmful/
+.. _trio docs: https://trio.readthedocs.io/en/latest/
-
+.. _libdill-docs: https://sustrik.github.io/libdill/structured-concurrency.html
-
+.. _pdbp: https://github.com/mdmintz/pdbp
-Install
+.. _msgspec: https://jcristharif.com/msgspec/
--------
+.. _cheap or nasty: https://zguide.zeromq.org/docs/chapter7/#The-Cheap-or-Nasty-Pattern
-No PyPi release yet!
+.. _(un)protocol: https://zguide.zeromq.org/docs/chapter7/#Unprotocols
-
+.. _distributed: https://en.wikipedia.org/wiki/Distributed_computing
-::
-
-    pip install git+git://github.com/goodboy/tractor.git
-
-
-Feel like saying hi?
---------------------
-This project is very much coupled to the ongoing development of
-``trio`` (i.e. ``tractor`` gets all its ideas from that brilliant
-community). If you want to help, have suggestions or just want to
-say hi, please feel free to ping me on the `trio gitter channel`_!
-
-.. _trio gitter channel: https://gitter.im/python-trio/general
-
-
-
-Philosophy
-----------
-Our tenets non-comprehensively include:
-
-- strict adherence to the `concept-in-progress`_ of *structured concurrency*
-- no spawning of processes *willy-nilly*; causality_ is paramount!
-- (remote) errors `always propagate`_ back to the parent supervisor
-- verbatim support for ``trio``'s cancellation_ system
-- `shared nothing architecture`_
-- no use of *proxy* objects or shared references between processes
-- an immersive debugging experience
-- anti-fragility through `chaos engineering`_
-
-``tractor`` is an actor-model-*like* system in the sense that it adheres
-to the `3 axioms`_ but does not (yet) fulfil all "unrequirements_" in
-practise. It is an experiment in applying `structured concurrency`_
-constraints on a parallel processing system where multiple Python
-processes exist over many hosts but no process can outlive its parent.
-In `erlang` parlance, it is an architecture where every process has
-a mandatory supervisor enforced by the type system. The API design is
-almost exclusively inspired by trio_'s concepts and primitives (though
-we often lag a little). As a distributed computing system `tractor`
-attempts to place sophistication at the correct layer such that
-concurrency primitives are powerful yet simple, making it easy to build
-complex systems (you can build a "worker pool" architecture but it's
-definitely not required). There is first class support for inter-actor
-streaming using `async generators`_ and ongoing work toward a functional
-reactive style for IPC.
-
-.. warning:: ``tractor`` is in alpha-alpha and is expected to change rapidly!
-    Expect nothing to be set in stone. Your ideas about where it should go
-    are greatly appreciated!
-
-.. _concept-in-progress: https://trio.discourse.group/t/structured-concurrency-kickoff/55
-.. _3 axioms: https://en.wikipedia.org/wiki/Actor_model#Fundamental_concepts
-.. _unrequirements: https://en.wikipedia.org/wiki/Actor_model#Direct_communication_and_asynchrony
-.. _async generators: https://www.python.org/dev/peps/pep-0525/
-.. _always propagate: https://trio.readthedocs.io/en/latest/design.html#exceptions-always-propagate
-.. _causality: https://vorpus.org/blog/some-thoughts-on-asynchronous-api-design-in-a-post-asyncawait-world/#c-c-c-c-causality-breaker
-.. _shared nothing architecture: https://en.wikipedia.org/wiki/Shared-nothing_architecture
-.. _cancellation: https://trio.readthedocs.io/en/latest/reference-core.html#cancellation-and-timeouts
-.. _channels: https://en.wikipedia.org/wiki/Channel_(programming)
-.. _chaos engineering: http://principlesofchaos.org/
-
-
-Examples
---------
-Note, if you are on Windows please be sure to see the :ref:`gotchas
-<windowsgotchas>` section before trying these.
-
-
-A trynamic first scene
-**********************
-Let's direct a couple *actors* and have them run their lines for
-the hip new film we're shooting:
-
-.. literalinclude:: ../examples/a_trynamic_first_scene.py
-
-We spawn two *actors*, *donny* and *gretchen*.
-Each actor starts up and executes their *main task* defined by an
-async function, ``say_hello()``.  The function instructs each actor
-to find their partner and say hello by calling their partner's
-``hi()`` function using something called a *portal*. Each actor
-receives a response and relays that back to the parent actor (in
-this case our "director" executing ``main()``).
-
-
-Actor spawning and causality
-****************************
-``tractor`` tries to take ``trio``'s concept of causal task lifetimes
-to multi-process land. Accordingly, ``tractor``'s *actor nursery* behaves
-similar to ``trio``'s nursery_. That is, ``tractor.open_nursery()``
-opens an ``ActorNursery`` which **must** wait on spawned *actors* to complete
-(or error) in the same causal_ way ``trio`` waits on spawned subtasks.
-This includes errors from any one actor causing all other actors
-spawned by the same nursery to be cancelled_.
-
-To spawn an actor and run a function in it, open a *nursery block*
-and use the ``run_in_actor()`` method:
-
-.. literalinclude:: ../examples/actor_spawning_and_causality.py
-
-What's going on?
-
-- an initial *actor* is started with ``trio.run()`` and told to execute
-  its main task_: ``main()``
-
-- inside ``main()`` an actor is *spawned* using an ``ActorNusery`` and is told
-  to run a single function: ``cellar_door()``
-
-- a ``portal`` instance (we'll get to what it is shortly)
-  returned from ``nursery.run_in_actor()`` is used to communicate with
-  the newly spawned *sub-actor*
-
-- the second actor, *some_linguist*, in a new *process* running a new ``trio`` task_
-  then executes ``cellar_door()`` and returns its result over a *channel* back
-  to the parent actor
-
-- the parent actor retrieves the subactor's *final result* using ``portal.result()``
-  much like you'd expect from a future_.
-
-This ``run_in_actor()`` API should look very familiar to users of
-``asyncio``'s `run_in_executor()`_ which uses a ``concurrent.futures`` Executor_.
-
-Since you might also want to spawn long running *worker* or *daemon*
-actors, each actor's *lifetime* can be determined based on the spawn
-method:
-
-- if the actor is spawned using ``run_in_actor()`` it terminates when
-  its *main* task completes (i.e. when the (async) function submitted
-  to it *returns*). The ``with tractor.open_nursery()`` exits only once
-  all actors' main function/task complete (just like the nursery_ in ``trio``)
-
-- actors can be spawned to *live forever* using the ``start_actor()``
-  method and act like an RPC daemon that runs indefinitely (the
-  ``with tractor.open_nursery()`` won't exit) until cancelled_
-
-Here is a similar example using the latter method:
-
-.. literalinclude:: ../examples/actor_spawning_and_causality_with_daemon.py
-
-The ``enable_modules`` `kwarg` above is a list of module path
-strings that will be loaded and made accessible for execution in the
-remote actor through a call to ``Portal.run()``. For now this is
-a simple mechanism to restrict the functionality of the remote
-(and possibly daemonized) actor and uses Python's module system to
-limit the allowed remote function namespace(s).
-
-``tractor`` is opinionated about the underlying threading model used for
-each *actor*. Since Python has a GIL and an actor model by definition
-shares no state between actors, it fits naturally to use a multiprocessing_
-``Process``. This allows ``tractor`` programs to leverage not only multi-core
-hardware but also distribute over many hardware hosts (each *actor* can talk
-to all others with ease over standard network protocols).
-
-.. _task: https://trio.readthedocs.io/en/latest/reference-core.html#tasks-let-you-do-multiple-things-at-once
-.. _nursery: https://trio.readthedocs.io/en/latest/reference-core.html#nurseries-and-spawning
-.. _causal: https://vorpus.org/blog/some-thoughts-on-asynchronous-api-design-in-a-post-asyncawait-world/#causality
-.. _cancelled: https://trio.readthedocs.io/en/latest/reference-core.html#child-tasks-and-cancellation
-.. _run_in_executor(): https://docs.python.org/3/library/asyncio-eventloop.html#asyncio.loop.run_in_executor
-.. _Executor: https://docs.python.org/3/library/concurrent.futures.html#concurrent.futures.Executor
-
-
-Cancellation
-************
-``tractor`` supports ``trio``'s cancellation_ system verbatim.
-Cancelling a nursery block cancels all actors spawned by it.
-Eventually ``tractor`` plans to support different `supervision strategies`_ like ``erlang``.
-
-.. _supervision strategies: http://erlang.org/doc/man/supervisor.html#sup_flags
-
-
-Remote error propagation
-************************
-Any task invoked in a remote actor should ship any error(s) back to the calling
-actor where it is raised and expected to be dealt with. This way remote actors
-are never cancelled unless explicitly asked or there's a bug in ``tractor`` itself.
-
-.. literalinclude:: ../examples/remote_error_propagation.py
-
-
-You'll notice the nursery cancellation conducts a *one-cancels-all*
-supervisory strategy `exactly like trio`_. The plan is to add more
-`erlang strategies`_ in the near future by allowing nurseries to accept
-a ``Supervisor`` type.
-
-.. _exactly like trio: https://trio.readthedocs.io/en/latest/reference-core.html#cancellation-semantics
-.. _erlang strategies: http://learnyousomeerlang.com/supervisors
-
-
-IPC using *portals*
-*******************
-``tractor`` introduces the concept of a *portal* which is an API
-borrowed_ from ``trio``. A portal may seem similar to the idea of
-a RPC future_ except a *portal* allows invoking remote *async* functions and
-generators and intermittently blocking to receive responses. This allows
-for fully async-native IPC between actors.
-
-When you invoke another actor's routines using a *portal* it looks as though
-it was called locally in the current actor. So when you see a call to
-``await portal.run()`` what you get back is what you'd expect
-to if you'd called the function directly in-process. This approach avoids
-the need to add any special RPC *proxy* objects to the library by instead just
-relying on the built-in (async) function calling semantics and protocols of Python.
-
-Depending on the function type ``Portal.run()`` tries to
-correctly interface exactly like a local version of the remote
-built-in Python *function type*. Currently async functions, generators,
-and regular functions are supported. Inspiration for this API comes
-`remote function execution`_ but without the client code being
-concerned about the underlying channels_ system or shipping code
-over the network.
-
-This *portal* approach turns out to be paricularly exciting with the
-introduction of `asynchronous generators`_ in Python 3.6! It means that
-actors can compose nicely in a data streaming pipeline.
-
-.. _exactly like trio: https://trio.readthedocs.io/en/latest/reference-core.html#cancellation-semantics
-
-Streaming
-*********
-By now you've figured out that ``tractor`` lets you spawn process based
-*actors* that can invoke cross-process (async) functions and all with
-structured concurrency built in. But the **real cool stuff** is the
-native support for cross-process *streaming*.
-
-
-Asynchronous generators
-+++++++++++++++++++++++
-The default streaming function is simply an async generator definition.
-Every value *yielded* from the generator is delivered to the calling
-portal exactly like if you had invoked the function in-process meaning
-you can ``async for`` to receive each value on the calling side.
-
-As an example here's a parent actor that streams for 1 second from a
-spawned subactor:
-
-.. literalinclude:: ../examples/asynchronous_generators.py
-
-By default async generator functions are treated as inter-actor
-*streams* when invoked via a portal (how else could you really interface
-with them anyway) so no special syntax to denote the streaming *service*
-is necessary.
-
-
-Channels and Contexts
-+++++++++++++++++++++
-If you aren't fond of having to write an async generator to stream data
-between actors (or need something more flexible) you can instead use
-a ``Context``. A context wraps an actor-local spawned task and
-a ``Channel`` so that tasks executing across multiple processes can
-stream data to one another using a low level, request oriented API.
-
-A ``Channel`` wraps an underlying *transport* and *interchange* format
-to enable *inter-actor-communication*. In its present state ``tractor``
-uses TCP and msgpack_.
-
-As an example if you wanted to create a streaming server without writing
-an async generator that *yields* values you instead define a decorated
-async function:
-
-.. code:: python
-
-   @tractor.stream
-   async def streamer(ctx: tractor.Context, rate: int = 2) -> None:
-      """A simple web response streaming server.
-      """
-      while True:
-         val = await web_request('http://data.feed.com')
-
-         # this is the same as ``yield`` in the async gen case
-         await ctx.send_yield(val)
-
-         await trio.sleep(1 / rate)
-
-
-You must decorate the function with ``@tractor.stream`` and declare
-a ``ctx`` argument as the first in your function signature and then
-``tractor`` will treat the async function like an async generator - as
-a stream from the calling/client side.
-
-This turns out to be handy particularly if you have multiple tasks
-pushing responses concurrently:
-
-.. code:: python
-
-   async def streamer(
-      ctx: tractor.Context,
-      rate: int = 2
-   ) -> None:
-      """A simple web response streaming server.
-      """
-      while True:
-         val = await web_request(url)
-
-         # this is the same as ``yield`` in the async gen case
-         await ctx.send_yield(val)
-
-         await trio.sleep(1 / rate)
-
-
-   @tractor.stream
-   async def stream_multiple_sources(
-      ctx: tractor.Context,
-      sources: List[str]
-   ) -> None:
-      async with trio.open_nursery() as n:
-         for url in sources:
-            n.start_soon(streamer, ctx, url)
-
-
-The context notion comes from the context_ in nanomsg_.
-
-.. _context: https://nanomsg.github.io/nng/man/tip/nng_ctx.5
-.. _msgpack: https://en.wikipedia.org/wiki/MessagePack
-
-
-
-A full fledged streaming service
-++++++++++++++++++++++++++++++++
-Alright, let's get fancy.
-
-Say you wanted to spawn two actors which each pull data feeds from
-two different sources (and wanted this work spread across 2 cpus).
-You also want to aggregate these feeds, do some processing on them and then
-deliver the final result stream to a client (or in this case parent) actor
-and print the results to your screen:
-
-.. literalinclude:: ../examples/full_fledged_streaming_service.py
-
-Here there's four actors running in separate processes (using all the
-cores on you machine). Two are streaming by *yielding* values from the
-``stream_data()`` async generator, one is aggregating values from
-those two in ``aggregate()`` (also an async generator) and shipping the
-single stream of unique values up the parent actor (the ``'MainProcess'``
-as ``multiprocessing`` calls it) which is running ``main()``. 
-
-.. _future: https://en.wikipedia.org/wiki/Futures_and_promises
-.. _borrowed:
-    https://trio.readthedocs.io/en/latest/reference-core.html#getting-back-into-the-trio-thread-from-another-thread
-.. _asynchronous generators: https://www.python.org/dev/peps/pep-0525/
-.. _remote function execution: https://codespeak.net/execnet/example/test_info.html#remote-exec-a-function-avoiding-inlined-source-part-i
-
-
-Actor local (aka *process global*) variables
-********************************************
-Although ``tractor`` uses a *shared-nothing* architecture between
-processes you can of course share state between tasks running *within*
-an actor (since a `trio.run()` runtime is single threaded). ``trio``
-tasks spawned via multiple RPC calls to an actor can modify
-*process-global-state* defined using Python module attributes:
-
-.. code:: python
-
-
-        # a per process cache
-        _actor_cache: dict[str, bool] = {}
-
-
-        def ping_endpoints(endpoints: List[str]):
-            """Start a polling process which runs completely separate
-            from our root actor/process.
-
-            """
-
-            # This runs in a new process so no changes # will propagate
-            # back to the parent actor
-            while True:
-
-                for ep in endpoints:
-                    status = await check_endpoint_is_up(ep)
-                    _actor_cache[ep] = status
-
-                await trio.sleep(0.5)
-
-
-        async def get_alive_endpoints():
-
-            nonlocal _actor_cache
-
-            return {key for key, value in _actor_cache.items() if value}
-
-
-        async def main():
-
-            async with tractor.open_nursery() as n:
-
-                portal = await n.run_in_actor(ping_endpoints)
-
-                # print the alive endpoints after 3 seconds
-                await trio.sleep(3)
-
-                # this is submitted to be run in our "ping_endpoints" actor
-                print(await portal.run(get_alive_endpoints))
-
-
-You can pass any kind of (`msgpack`) serializable data between actors using
-function call semantics but building out a state sharing system per-actor
-is totally up to you.
-
-
-Service Discovery
-*****************
-Though it will be built out much more in the near future, ``tractor``
-currently keeps track of actors by ``(name: str, id: str)`` using a
-special actor called the *arbiter*. Currently the *arbiter* must exist
-on a host (or it will be created if one can't be found) and keeps a
-simple ``dict`` of actor names to sockets for discovery by other actors.
-Obviously this can be made more sophisticated (help me with it!) but for
-now it does the trick.
-
-To find the arbiter from the current actor use the ``get_arbiter()`` function and to
-find an actor's socket address by name use the ``find_actor()`` function:
-
-.. literalinclude:: ../examples/service_discovery.py
-
-The ``name`` value you should pass to ``find_actor()`` is the one you passed as the
-*first* argument to either ``trio.run()`` or ``ActorNursery.start_actor()``.
-
-
-Running actors standalone
-*************************
-You don't have to spawn any actors using ``open_nursery()`` if you just
-want to run a single actor that connects to an existing cluster.
-All the comms and arbiter registration stuff still works. This can
-somtimes turn out being handy when debugging mult-process apps when you
-need to hop into a debugger. You just need to pass the existing
-*arbiter*'s socket address you'd like to connect to:
-
-.. code:: python
-
-    import trio
-    import tractor
-
-    async def main():
-
-        async with tractor.open_root_actor(
-            arbiter_addr=('192.168.0.10', 1616)
-        ):
-            await trio.sleep_forever()
-
-    trio.run(main)
-
-
-Choosing a process spawning backend
-***********************************
-``tractor`` is architected to support multiple actor (sub-process)
-spawning backends. Specific defaults are chosen based on your system
-but you can also explicitly select a backend of choice at startup
-via a ``start_method`` kwarg to ``tractor.open_nursery()``.
-
-Currently the options available are:
-
-- ``trio``: a ``trio``-native spawner which is an async wrapper around ``subprocess``
-- ``spawn``: one of the stdlib's ``multiprocessing`` `start methods`_
-- ``forkserver``: a faster ``multiprocessing`` variant that is Unix only
-
-.. _start methods: https://docs.python.org/3.8/library/multiprocessing.html#contexts-and-start-methods
-
-
-``trio``
-++++++++
-The ``trio`` backend offers a lightweight async wrapper around ``subprocess`` from the standard library and takes advantage of the ``trio.`` `open_process`_ API.
-
-.. _open_process: https://trio.readthedocs.io/en/stable/reference-io.html#spawning-subprocesses
-
-
-``multiprocessing``
-+++++++++++++++++++
-There is support for the stdlib's ``multiprocessing`` `start methods`_.
-Note that on Windows *spawn* it the only supported method and on \*nix
-systems *forkserver* is the best method for speed but has the caveat
-that it will break easily (hangs due to broken pipes) if spawning actors
-using nested nurseries.
-
-In general, the ``multiprocessing`` backend **has not proven reliable**
-for handling errors from actors more then 2 nurseries *deep* (see `#89`_).
-If you for some reason need this consider sticking with alternative
-backends.
-
-.. _#89: https://github.com/goodboy/tractor/issues/89
-
-.. _windowsgotchas:
-
-Windows "gotchas"
-^^^^^^^^^^^^^^^^^
-On Windows (which requires the use of the stdlib's `multiprocessing`
-package) there are some gotchas. Namely, the need for calling
-`freeze_support()`_ inside the ``__main__`` context.  Additionally you
-may need place you `tractor` program entry point in a seperate
-`__main__.py` module in your package in order to avoid an error like the
-following ::
-
-    Traceback (most recent call last):
-      File "C:\ProgramData\Miniconda3\envs\tractor19030601\lib\site-packages\tractor\_actor.py", line 234, in _get_rpc_func
-        return getattr(self._mods[ns], funcname)
-    KeyError: '__mp_main__'
-
-
-To avoid this, the following is the **only code** that should be in your
-main python module of the program:
-
-.. code:: python
-
-    # application/__main__.py
-    import trio
-    import tractor
-    import multiprocessing
-    from . import tractor_app
-
-    if __name__ == '__main__':
-        multiprocessing.freeze_support()
-        trio.run(tractor_app.main)
-
-And execute as::
-
-    python -m application
-
-
-As an example we use the following code to test all documented examples
-in the test suite on windows:
-
-.. literalinclude:: ../examples/__main__.py
-
-See `#61`_ and `#79`_ for further details.
-
-.. _freeze_support(): https://docs.python.org/3/library/multiprocessing.html#multiprocessing.freeze_support
-.. _#61: https://github.com/goodboy/tractor/pull/61#issuecomment-470053512
-.. _#79: https://github.com/goodboy/tractor/pull/79
-
-
-Enabling logging
-****************
-Considering how complicated distributed software can become it helps to know
-what exactly it's doing (even at the lowest levels). Luckily ``tractor`` has
-tons of logging throughout the core. ``tractor`` isn't opinionated on
-how you use this information and users are expected to consume log messages in
-whichever way is appropriate for the system at hand. That being said, when hacking
-on ``tractor`` there is a prettified console formatter which you can enable to
-see what the heck is going on. Just put the following somewhere in your code:
-
-.. code:: python
-
-    from tractor.log import get_console_log
-    log = get_console_log('trace')
-
-
-What the future holds
----------------------
-Stuff I'd like to see ``tractor`` do real soon:
-
-- TLS_, duh.
-- erlang-like supervisors_
-- native support for `nanomsg`_ as a channel transport
-- native `gossip protocol`_ support for service discovery and arbiter election
-- a distributed log ledger for tracking cluster behaviour
-- a slick multi-process aware debugger much like in celery_
-  but with better `pdb++`_ support
-- an extensive `chaos engineering`_ test suite
-- support for reactive programming primitives and native support for asyncitertools_ like libs
-- introduction of a `capability-based security`_ model
-
-.. _TLS: https://trio.readthedocs.io/en/latest/reference-io.html#ssl-tls-support
-.. _supervisors: https://github.com/goodboy/tractor/issues/22
-.. _nanomsg: https://nanomsg.github.io/nng/index.html
-.. _gossip protocol: https://en.wikipedia.org/wiki/Gossip_protocol
-.. _celery: http://docs.celeryproject.org/en/latest/userguide/debugging.html
-.. _asyncitertools: https://github.com/vodik/asyncitertools
-.. _pdb++: https://github.com/antocuni/pdb
-.. _capability-based security: https://en.wikipedia.org/wiki/Capability-based_security

docs/project/changelog.rst

@@ -0,0 +1 @@
+.. include:: ../../NEWS.rst

docs/project/dev-tips.rst

@@ -0,0 +1,208 @@
+Hot tips for ``tractor`` hackers
+================================
+
+This is a (perpetually WIP) guide for newcomers to the project,
+mostly to do with dev, testing, CI and release gotchas, reminders
+and best practises.
+
+``tractor`` is a fairly novel project compared to most since it is
+effectively a new way of doing distributed computing in Python and
+is much closer to working with an "application level runtime"
+(like erlang OTP or scala's akka project) than it is a traditional
+Python library. As such, having an arsenal of tools and recipes
+for figuring out the right way to debug problems when they do
+arise is somewhat of a necessity.
+
+Making a release
+----------------
+
+Nothing fancy: the traditional PyPA flow on the hatchling_ build
+backend, with uv_ doing the driving and towncrier_ generating the
+changelog.
+
+1. collect news fragments: user-facing changes should land with a
+   small ``.rst`` snippet under ``nooz/`` (see ``nooz/HOWTO.rst``;
+   fragment types are ``feature``, ``bugfix``, ``doc`` and
+   ``trivial``),
+
+2. render them into ``NEWS.rst``::
+
+       uvx towncrier build --version <version>
+
+3. build and upload (testpypi first if you're being careful)::
+
+       uv build
+       uvx twine upload -r testpypi dist/*
+       uvx twine upload dist/*
+
+How you organize built artifacts under ``dist/`` locally (per
+release sub-dirs and such) is entirely up to you.
+
+Keep in mind that PyPi releases tend to lag the ``main`` branch
+since we develop in the open — ``main`` is usually the thing to
+run when you want the latest.
+
+Debugging and monitoring actor trees
+------------------------------------
+
+Your "what is my tree doing right now?" toolbox, in escalation
+order:
+
+**Live process-tree view** — keep a ``watch``-ed ``pstree``
+running in a side terminal; actor procs are recognizable by their
+``_subactor[<name>@<uuid-prefix>]`` process titles. The exact
+one-liners (plus the ``pgrep`` marker recipes) live in
+:doc:`/guide/testing`.
+
+**SIGUSR1 task-tree dumps** — boot any tree with
+``enable_stack_on_sig=True`` (or export
+``TRACTOR_ENABLE_STACKSCOPE=1``) and every actor installs a
+stackscope_ signal handler. Then from any shell::
+
+    # dump every actor's live trio task tree:
+    pkill --signal SIGUSR1 -f <part-of-your-cmd>
+
+    # or for a single process:
+    kill -SIGUSR1 $(pgrep -f <part-of-your-cmd>)
+
+Each dump is also tee'd (append-mode) to
+``/tmp/tractor-stackscope-<pid>.log`` so you still get output
+under pytest capture or in CI. This works *without* debug-mode
+being enabled — it's the lightest-weight hang-investigation tool
+in the box.
+
+**The built-in multi-process debugger** — ``debug_mode=True``
+plus :func:`tractor.pause` and friends: the heavyweight champ for
+interactive, REPL-driven inspection of a whole tree (including
+crash handling). Remember pytest capture interplay — see
+:doc:`/guide/testing`.
+
+**Post-mortem zombie sweeps** — ``scripts/tractor-reap`` for the
+(should-be-rare!) cases where hacking on the runtime itself wedges
+a tree: a SIGINT-first, structured concurrency (SC) polite
+escalation, plus ``--shm`` and ``--uds`` leaked-resource sweeps.
+
+Using the log system to trace ``trio`` task flow
+------------------------------------------------
+
+The logging system is oriented around the **stack "layers" of the
+runtime**, letting you trace logical abstraction layers in the
+code — errors, cancellation, IPC and streaming, the low level
+transport and wire protocols — independently of one another.
+
+Concretely, ``tractor.log.get_logger()`` returns a
+``StackLevelAdapter`` sporting extra level-methods beyond the
+stdlib set, including:
+
+- ``.cancel()`` — cancellation-machinery flow,
+
+- ``.runtime()`` — actor-runtime lifecycle chatter,
+
+- ``.devx()`` — debugger/devx tooling internals,
+
+- ``.transport()`` — wire-level msging events.
+
+To get console output at any level from your own code::
+
+    from tractor.log import get_console_log
+    get_console_log('cancel')
+
+or, runtime-wide without touching code, just export
+``TRACTOR_LOGLEVEL=cancel`` (the env-var wins over caller-passed
+levels; great for test runs).
+
+When you want only *one subsystem* cranked, the suite's ``--tl``
+flag (and ``tractor.log.apply_logspec()``) accept a per-sublogger
+spec::
+
+    uv run pytest tests/... --tl 'devx:runtime,trionics:cancel'
+
+Every record's header includes the emitting actor and task names,
+so cross-process flows can be stitched back together by eyeball
+(or grep).
+
+Building these docs
+-------------------
+The site you're reading is sphinx_ + the pydata-sphinx-theme_,
+with diagrams authored in d2_ (via our local ``.. d2::``
+directive) and *every* code block ``literalinclude``-d straight
+from ``examples/`` — so what you read is what CI runs, and it
+can't rot.
+
+The one-liner, from any dev shell::
+
+    uv run --group docs make -C docs html
+
+then open ``docs/_build/html/index.html``.
+
+**Nix users**: the d2_ diagram renderer is deliberately kept
+*out* of the default dev-shell so casual envs stay lean; it
+lives in an opt-in ``docs`` shell::
+
+    # enter the docs shell (puts `d2`, `uv` + python on PATH)
+    nix develop .#docs
+
+    # ...then build (diagrams re-render from docs/diagrams/*.d2)
+    uv run --group docs make -C docs html
+
+or as a one-shot without staying in the shell::
+
+    nix develop .#docs -c uv run --group docs make -C docs html
+
+**Live-reload** while editing — rebuild + browser refresh on
+every save::
+
+    nix develop .#docs -c uv run --with sphinx-autobuild \
+        --group docs sphinx-autobuild docs docs/_build/html
+    # then open http://127.0.0.1:8000
+
+**Share on your LAN**: bind the server to all interfaces
+(``--host 0.0.0.0``) instead of localhost, then hand a peer on
+your subnet ``http://<your-lan-ip>:8000``::
+
+    nix develop .#docs -c uv run --with sphinx-autobuild \
+        --group docs sphinx-autobuild docs docs/_build/html \
+        --host 0.0.0.0 --port 8000
+
+or statically serve an already-built tree (no rebuild-on-save)::
+
+    python -m http.server -d docs/_build/html --bind 0.0.0.0 8000
+
+``hostname -I`` prints the IP to share; note it's an
+unauthenticated server bound to every interface, so keep it to a
+trusted LAN.
+
+How the diagrams resolve,
+
+- ``.d2`` sources live in ``docs/diagrams/``; their rendered
+  SVGs are git-committed under ``docs/_diagrams/`` as a fallback,
+- with a ``d2`` binary on ``PATH`` (the ``docs`` shell, or set
+  ``D2_BIN='nix run nixpkgs#d2 --'``) any stale SVG re-renders at
+  build time,
+- with NO binary the committed SVGs are served as-is, so CI and
+  casual builds need no ``d2`` at all,
+- a ``.d2`` that *fails to compile* is a hard build error under
+  ``sphinx-build -W`` (the last-good committed SVG is left
+  untouched).
+
+The build is currently **warning-free**; keep it that way — the
+``-W`` flag turns any sphinx warning into a hard failure::
+
+    uv run --group docs sphinx-build -b html -W docs docs/_build/html
+
+A terser command cheat-sheet also lives at
+``notes_to_self/howtodocs.md``.
+
+.. seealso::
+   - :doc:`/guide/testing` — running the suite, watching trees
+     live, examples-as-tests conventions and the zombie-reaper.
+   - :doc:`/guide/discovery` — the registrar mechanics you'll
+     bump into when running multiple trees on one host.
+
+.. _hatchling: https://hatch.pypa.io/latest/
+.. _uv: https://docs.astral.sh/uv/
+.. _towncrier: https://towncrier.readthedocs.io/en/stable/
+.. _stackscope: https://github.com/oremanj/stackscope
+.. _sphinx: https://www.sphinx-doc.org/
+.. _pydata-sphinx-theme: https://pydata-sphinx-theme.readthedocs.io/
+.. _d2: https://d2lang.com

docs/project/index.rst

@@ -0,0 +1,60 @@
+Project
+=======
+Everything meta: where the project's been (the
+:doc:`changelog`), where it's going (the roadmap below),
+how to hack on it (:doc:`dev-tips` and
+:doc:`/guide/testing`) and where to find the humans.
+
+.. toctree::
+   :maxdepth: 1
+
+   changelog
+   dev-tips
+
+What the future holds
+---------------------
+Help us push toward the future of distributed Python!
+Planned (or dreamed of) work non-comprehensively
+includes,
+
+- Erlang-style supervisors via composed context
+  managers (see `#22`_),
+- typed capability-based (dialog) protocols, ie.
+  evolving our `msg-spec`_ system into per-dialog
+  contracts (see `#196`_ with draft work in `#311`_),
+- a higher level "service manager" API for daemon
+  lifetime mgmt over actor trees (in the works on an
+  experimental branch as ``tractor.hilevel``),
+- richer `discovery`_ via gossip and/or
+  `rendezvous protocol`_ approaches (today's registrar
+  is intentionally naive),
+- more IPC transports: the current ``tcp`` | ``uds``
+  pair wants friends (QUIC, shm-ring-buffers, RUDP,
+  wireguard tunnels),
+- an extensive `chaos engineering`_ test suite,
+- a respawn-from-REPL system for crashed (sub-)actors.
+
+Feel like saying hi?
+--------------------
+This project is very much coupled to the ongoing
+development of ``trio`` (i.e. ``tractor`` gets most of
+its ideas from that brilliant community). If you want
+to help, have suggestions or just want to say hi,
+please feel free to reach us in our `matrix channel`_.
+If matrix seems too hip, we're also mostly all in the
+`trio gitter channel`_!
+
+Contributions of all kinds welcome: docs, examples,
+bug reports, new transports, supervisor strategies,
+philosophical debates about what an "actor model"
+really is B)
+
+.. _#22: https://github.com/goodboy/tractor/issues/22
+.. _#196: https://github.com/goodboy/tractor/issues/196
+.. _#311: https://github.com/goodboy/tractor/pull/311
+.. _msg-spec: https://jcristharif.com/msgspec/
+.. _discovery: https://zguide.zeromq.org/docs/chapter8/#Discovery
+.. _rendezvous protocol: https://en.wikipedia.org/wiki/Rendezvous_protocol
+.. _chaos engineering: https://principlesofchaos.org/
+.. _matrix channel: https://matrix.to/#/!tractor:matrix.org
+.. _trio gitter channel: https://gitter.im/python-trio/general

docs/start/index.rst

@@ -0,0 +1,36 @@
+Getting started
+===============
+Welcome aboard B)
+
+Real talk before any code: the first step to grok ``tractor`` is
+to get an intermediate knowledge of ``trio`` and **structured
+concurrency** (SC). ``tractor`` **is just** ``trio`` - but with
+nurseries for process management and cancel-able streaming IPC -
+so every rule you already know about task lifetimes, cancellation
+and error propagation keeps holding, just now across process (and
+host!) boundaries. Some great places to start are,
+
+- the seminal `blog post`_,
+- obviously the `trio docs`_,
+- wikipedia's nascent SC_ page,
+- the fancy diagrams @ libdill-docs_.
+
+Once you've taken in (some of) the canon, get installed and go
+spawn your first actor tree:
+
+.. toctree::
+   :maxdepth: 1
+
+   install
+   quickstart
+
+.. seealso::
+
+   Already installed and itching? Jump straight to
+   :doc:`/start/quickstart`; once you're through the on-ramp the
+   :doc:`guide pages </guide/index>` take each subsystem deeper.
+
+.. _blog post: https://vorpus.org/blog/notes-on-structured-concurrency-or-go-statement-considered-harmful/
+.. _trio docs: https://trio.readthedocs.io/en/latest/
+.. _SC: https://en.wikipedia.org/wiki/Structured_concurrency
+.. _libdill-docs: https://sustrik.github.io/libdill/structured-concurrency.html

docs/start/install.rst

@@ -0,0 +1,75 @@
+Install
+=======
+``tractor`` is still in an *alpha-near-beta-stage* for many of
+its subsystems, however we are very close to having a stable
+lowlevel runtime and API. Expect the occasional rough edge (and
+feel free to report it!).
+
+Supported platforms
+-------------------
+- **python**: ``>=3.13,<3.15`` - yes, we ride near the front of
+  the release train; 3.14 additionally unlocks the experimental
+  PEP-734 sub-interpreter spawn backend,
+- **linux**: the primary development and CI platform,
+- **macos**: officially supported,
+- **windows**: currently *untested* - we disabled CI-testing on
+  windows a while back and haven't had the cycles to revive it.
+  It mostly worked historically; if you're a windows person we'd
+  love a hand getting it back in the test matrix.
+
+With ``uv`` (preferred)
+-----------------------
+We use the very hip uv_ for project mgmt and recommend you do
+too. Add ``tractor`` to your project::
+
+    uv add tractor
+
+or, since the git ``main`` branch is often much further ahead
+than any latest release (see the PyPi note below), track ``main``
+directly::
+
+    uv add "tractor @ git+https://github.com/goodboy/tractor.git"
+
+From PyPi
+---------
+We ofc also offer "releases" on PyPi_::
+
+    pip install tractor
+
+Just note that **YMMV** since ``main`` is usually well ahead of
+the latest published alpha; when in doubt go with a git install
+as per above (or hack from source as per below).
+
+From source
+-----------
+To run the bundled examples in-tree, or to start hacking on the
+code base, clone and sync a dev env::
+
+    git clone https://github.com/goodboy/tractor.git
+    cd tractor
+    uv sync --dev
+    uv run python examples/rpc_bidir_streaming.py
+
+Consider activating a virtual/project-env before starting to hack
+on the code base::
+
+    # you could use plain ol' venvs
+    # https://docs.astral.sh/uv/pip/environments/
+    uv venv tractor_py313 --python 3.13
+
+    # but @goodboy prefers the more explicit (and shell agnostic)
+    # https://docs.astral.sh/uv/configuration/environment/#uv_project_environment
+    UV_PROJECT_ENVIRONMENT="tractor_py313"
+
+    # hint hint, enter @goodboy's fave shell B)
+    uv run --dev xonsh
+
+.. seealso::
+
+   All set? Go boot a process tree in :doc:`/start/quickstart`.
+   And if the install fights you, swing by the `matrix channel`_
+   and we'll sort it out.
+
+.. _uv: https://docs.astral.sh/uv/
+.. _PyPi: https://pypi.org/project/tractor/
+.. _matrix channel: https://matrix.to/#/!tractor:matrix.org

docs/start/quickstart.rst

@@ -0,0 +1,279 @@
+Quickstart
+==========
+Time to spawn something B)
+
+If you take one thing from this page make it this: ``tractor``
+**is just** ``trio`` - but with nurseries for process management
+and cancel-able streaming IPC. Every "*actor*" you'll meet below
+is a plain Python **process** running its own ``trio.run()``
+scheduled task tree, linked back to its parent through an IPC
+protocol which keeps the whole tree `structured concurrency`_
+(SC) compliant end-to-end. If you know your nursery_ semantics
+you already know most of ``tractor``; we just stretch them across
+the process boundary.
+
+.. d2:: diagrams/actor_tree.d2
+   :alt: a supervision tree of actor processes
+   :margin:
+   :caption: every arrow is a parent which **must wait** on its kids
+
+Your first actor tree
+---------------------
+``trio`` takes the hard-line position that a parent task **must
+wait** on the children it spawns; causality_ is paramount! So
+does ``tractor``, one abstraction layer up:
+``tractor.open_nursery()`` yields an ``ActorNursery`` which
+**must** wait on its spawned *subactors* to complete (or error)
+before the ``async with`` block exits, in the same causal_ way a
+``trio`` nursery waits on its subtasks. That includes any one
+child's crash cancelling all of its siblings: *one-cancels-all*
+supervision, `exactly like trio`_.
+
+Enough preamble, spawn a process:
+
+.. literalinclude:: ../../examples/actor_spawning_and_causality.py
+   :caption: examples/actor_spawning_and_causality.py
+   :language: python
+
+Run it::
+
+    $ python examples/actor_spawning_and_causality.py
+    Dang that's beautiful
+
+What's going on here?
+
+- ``trio.run(main)`` starts the **root actor**; the ``tractor``
+  runtime boots *implicitly* inside ``tractor.open_nursery()``
+  whenever it isn't already up. No special entrypoint, no
+  framework takeover - it's just a ``trio`` app,
+- inside ``main()`` a *subactor* is spawned via
+  ``ActorNursery.run_in_actor()`` and told to run exactly one
+  function: ``cellar_door()``,
+- you get back a ``Portal``: your handle for invoking tasks in
+  the new process's (separate!) memory domain. We lean on it
+  much harder in the next section,
+- the subactor, *some_linguist*, boots a fresh ``trio.run()`` in
+  a **new process** and executes ``cellar_door()`` as its *main
+  task* (note the child proving it is *not* the root with
+  ``tractor.is_root_process()``), then ships the return value
+  back over IPC,
+- the parent grabs that *final result* with
+  ``await portal.wait_for_result()``, much like you'd expect
+  from a "future" - except causality is preserved: the nursery
+  block only exits once the child is *done*, dead, and reaped.
+
+.. margin:: Just need a worker pool?
+
+   If all you want is to throw *sync* functions at your cores,
+   also check out trio-parallel_. ``tractor`` is aimed at
+   structured, (possibly) distributed *trees* of cooperating
+   ``trio`` programs; a worker pool is a trivial special case.
+
+.. note::
+
+   ``run_in_actor()`` is the *convenience* wrapper: one-shot
+   spawn-run-reap semantics for when a subactor's entire job is
+   a single function call. The core primitives are
+   ``ActorNursery.start_actor()`` (next up) paired with
+   ``Portal.open_context()`` for full, SC-linked cross-actor
+   dialogs - see :doc:`/guide/context`.
+
+Daemon actors and RPC
+---------------------
+A ``run_in_actor()``-spawned actor terminates when its main task
+returns. But often you want long-lived *daemon* actors instead:
+spawned once, then serving (allowlisted) RPC requests until told
+otherwise. That's ``start_actor()``:
+
+.. literalinclude:: ../../examples/actor_spawning_and_causality_with_daemon.py
+   :caption: examples/actor_spawning_and_causality_with_daemon.py
+   :language: python
+
+Two lifetime rules to internalize:
+
+- a ``run_in_actor()`` actor lives exactly as long as its main
+  task; the nursery waits for that function (and thus the
+  process) to complete before unblocking,
+- a ``start_actor()`` actor *lives forever* - an RPC daemon the
+  nursery will happily wait on **indefinitely** - until some
+  task explicitly cancels it via ``Portal.cancel_actor()`` (as
+  above), or its parent nursery is cancelled wholesale.
+
+.. tip::
+
+   Want your *entire program* to just be a long-lived RPC
+   daemon? ``tractor.run_daemon()`` is the blocking shorthand:
+   it ``trio.run()``\s a root actor which serves requests until
+   cancelled.
+
+The ``enable_modules=[__name__]`` kwarg is the other thing to
+notice: it lists the module paths the subactor will load and
+*expose* for remote invocation.
+``await portal.run(movie_theatre_question)`` works because this
+very module is in that allowlist (and note we call it twice; the
+daemon happily serves repeat requests). Ask for a function from
+any module *not* enabled and you're denied with a
+``ModuleNotExposed`` error: a simple, capability-style
+restriction mechanism built on Python's own module system.
+
+We are *processes*
+------------------
+Why processes (and not, say, threads)? Python has a GIL and an
+`actor model`_ by definition shares **nothing** between its
+concurrent units, so real OS processes are the natural fit: you
+get all your cores locally, and since actors only ever talk via
+IPC, the exact same code distributes over multiple hosts without
+modification.
+
+Of course, the moment you hear "process trees" you should be
+asking: *what about zombies?* Watch ``tractor`` eat one for
+breakfast - run this while monitoring your process tree::
+
+    $TERM -e watch -n 0.1  "pstree -a $$" \
+        & python examples/parallelism/we_are_processes.py \
+        && kill $!
+
+.. literalinclude:: ../../examples/parallelism/we_are_processes.py
+   :caption: examples/parallelism/we_are_processes.py
+   :language: python
+
+.. margin:: Who's who in ``pstree``?
+
+   Every subactor (best-effort, via the optional
+   ``setproctitle`` dep) re-titles its OS process like
+   ``_subactor[worker_0@<pid>]``, so ``pstree``/``htop``/
+   ``pgrep -f`` can tell your actors apart at a glance.
+
+You'll see something like (one subactor per core - 24 on this box,
+trimmed here)::
+
+    $ python examples/parallelism/we_are_processes.py
+    This tree will self-destruct in 2s..
+
+    Started ep-task in subactor,
+    0::'worker_0'@218140
+
+    Started ep-task in subactor,
+    2::'worker_2'@218134
+
+    Started ep-task in subactor,
+    1::'worker_1'@218137
+
+    Started ep-task in subactor,
+    3::'worker_3'@218132
+
+    Zombies Contained
+
+(The ``Started ep-task`` lines land in whatever order the OS
+schedules them; they're separate *processes*, racing, and that's
+the point.)
+
+One subactor is spawned per core - concurrently, from background
+``trio`` tasks, so each child's cold ``import tractor`` overlaps
+instead of stacking. Each runs a ``@tractor.context``
+``endpoint()`` that ``ctx.started()``-hands its name and pid back
+through ``Portal.open_context()`` (those ``Started ep-task``
+lines), then parks in ``trio.sleep_forever()``. Then the root
+*crashes on purpose* and the ``ActorNursery`` responds with hard
+``trio`` discipline: every child is cancelled, every process is
+reaped, the error propagates to ``trio.run()``, and your terminal
+prints ``Zombies Contained``. No orphans, no ``kill -9``
+archaeology in ``htop`` afterwards.
+
+.. note::
+
+   **The zombie-safety guarantee**: ``tractor`` tries to protect
+   you from zombies, *no matter what*. If you can create zombie
+   child processes (without using a system signal) it **is a
+   bug** - please report it so we can hunt it down.
+
+A trynamic first scene
+----------------------
+So far the root actor has done all the talking, but subactors
+can just as well discover and call *each other*. Let's direct a
+couple actors and have them run their lines for the hip new film
+we're shooting:
+
+.. literalinclude:: ../../examples/a_trynamic_first_scene.py
+   :caption: examples/a_trynamic_first_scene.py
+   :language: python
+
+The script of the scene (runtime ``INFO`` log lines trimmed)::
+
+    $ python examples/a_trynamic_first_scene.py
+    Alright... Action!
+    Hi my name is gretchen
+    Hi my name is donny
+    CUTTTT CUUTT CUT!!! Donny!! You're supposed to say...
+
+The new tricks in play:
+
+- two subactors, *donny* and *gretchen*, are each told to run
+  ``say_hello()`` targeting the *other* by name,
+- ``tractor.wait_for_actor()`` blocks until the named peer has
+  registered with the tree's *registrar* (every actor announces
+  itself at boot), then yields a ``Portal`` connected
+  **directly** to that peer,
+- each actor invokes its partner's ``hi()`` over that portal:
+  actor-to-actor RPC with the root merely *directing* - and both
+  final lines flow back to ``main()`` via
+  ``await portal.wait_for_result()``,
+- ``tractor.log.get_console_log("INFO")`` cranks up runtime
+  logging so you can watch the spawn/register/cancel machinery
+  narrate itself; remove it for a quiet set.
+
+Cross-actor calls look just like (async) function calls; there
+are no proxy objects and no shared references, only messages B)
+
+Crash handling, native feeling
+------------------------------
+One last teaser before the guide proper. Flip exactly one
+switch:
+
+.. code:: python
+
+    async with tractor.open_nursery(
+        debug_mode=True,
+    ) as an:
+        ...
+
+and any crash, in *any* actor at *any* depth of the tree, drops
+your terminal into a multi-process-safe pdbp_ REPL at the
+offending frame, with the rest of the tree held back from
+clobbering the tty. ``await tractor.pause()`` likewise gives you
+a breakpoint that *just works* inside subprocesses. We think it
+might be the first native multi-process debugging UX for Python;
+get the full tour in :doc:`/guide/debugging`.
+
+Where to next?
+--------------
+You can now boot a runtime, spawn one-shot and daemon actors,
+make cross-process RPC calls, and contain zombies: that's the
+on-ramp done. The guide takes each subsystem deeper,
+
+- :doc:`/explain/sc-distributed` - the structured concurrency
+  worldview and how ``tractor`` extends it across processes,
+- :doc:`/guide/spawning` - everything ``ActorNursery``: spawn
+  kwargs, lifetimes and supervision semantics,
+- :doc:`/guide/rpc` - the ``Portal`` in depth: calling into
+  another actor's memory domain,
+- :doc:`/guide/context` - the core API: ``@tractor.context``
+  endpoints, the ``ctx.started()`` handshake, and SC-linked
+  cross-actor task pairs,
+- :doc:`/guide/streaming` - bidirectional ``MsgStream`` dialogs
+  and fan-out broadcasting,
+- :doc:`/guide/debugging` - the multi-process REPL, crash
+  handling mode, and ``tractor.pause()``,
+- :doc:`/guide/asyncio` - "infected ``asyncio``" mode: SC
+  supervision wrapped around ``asyncio`` tasks,
+- :doc:`/guide/discovery` - registries, service daemons, and
+  finding actors from anywhere in (or out of) the tree.
+
+.. _structured concurrency: https://en.wikipedia.org/wiki/Structured_concurrency
+.. _nursery: https://trio.readthedocs.io/en/latest/reference-core.html#nurseries-and-spawning
+.. _causality: https://vorpus.org/blog/some-thoughts-on-asynchronous-api-design-in-a-post-asyncawait-world/#c-c-c-c-causality-breaker
+.. _causal: https://vorpus.org/blog/some-thoughts-on-asynchronous-api-design-in-a-post-asyncawait-world/#causality
+.. _exactly like trio: https://trio.readthedocs.io/en/latest/reference-core.html#cancellation-semantics
+.. _actor model: https://en.wikipedia.org/wiki/Actor_model
+.. _trio-parallel: https://github.com/richardsheridan/trio-parallel
+.. _pdbp: https://github.com/mdmintz/pdbp

examples/a_trynamic_first_scene.py

@@ -35,8 +35,8 @@ async def main():
             name='gretchen',
             other_actor='donny',
         )
-        print(await gretchen.result())
+        print(await gretchen.wait_for_result())
-        print(await donny.result())
+        print(await donny.wait_for_result())
         print("CUTTTT CUUTT CUT!!! Donny!! You're supposed to say...")
 
 

examples/actor_spawning_and_causality.py

@@ -20,7 +20,7 @@ async def main():
     # The ``async with`` will unblock here since the 'some_linguist'
     # actor has completed its main task ``cellar_door``.
 
-    print(await portal.result())
+    print(await portal.wait_for_result())
 
 
 if __name__ == '__main__':

examples/debugging/shielded_pause.py

@@ -78,7 +78,7 @@ async def main():
         portal: tractor.Portal = await n.run_in_actor(
             cancelled_before_pause,
         )
-        await portal.result()
+        await portal.wait_for_result()
 
         # ensure the same works in the root actor!
         await pm_on_cancelled()

examples/debugging/subactor_breakpoint.py

@@ -22,7 +22,7 @@ async def main():
         portal = await n.run_in_actor(
             breakpoint_forever,
         )
-        await portal.result()
+        await portal.wait_for_result()
 
 
 if __name__ == '__main__':

examples/debugging/subactor_error.py

@@ -18,10 +18,10 @@ async def main():
         p: tractor.Portal = await an.run_in_actor(name_error)
 
         # with this style, should raise on this line
-        await p.result()
+        await p.wait_for_result()
 
         # with this alt style should raise at `open_nusery()`
-        # return await p.result()
+        # return await p.wait_for_result()
 
 
 if __name__ == '__main__':

examples/nested_actor_tree.py

@@ -0,0 +1,105 @@
+'''
+Demonstrate a (3-level) nested actor tree where one RPC from
+the root fans out through a mid-tier 'supervisor' actor to
+2 'leaf' worker actors and an aggregate result is relayed
+back up.
+
+The process tree should look approximately like:
+
+python examples/nested_actor_tree.py
+`-python -m tractor._child --uid ('supervisor', '7c9b1039 ..)
+  |-python -m tractor._child --uid ('leaf_1', '92d62f50 ..)
+  `-python -m tractor._child --uid ('leaf_2', 'de91fdf5 ..)
+
+Teardown runs inside-out: the supervisor cancels its leaves
+first, then the root cancels the supervisor; watch the
+prints to see the ordering.
+
+'''
+import trio
+import tractor
+
+
+async def compute_square(x: int) -> int:
+    '''
+    Tiny "work unit" run inside a leaf actor.
+
+    '''
+    name: str = tractor.current_actor().name
+    print(f'{name}: squaring {x}')
+    return x * x
+
+
+@tractor.context
+async def fan_out_squares(
+    ctx: tractor.Context,
+    vals: list[int],
+) -> list[int]:
+    '''
+    Spawn a (nested) pair of leaf actors, fan the input vals
+    out across them round-robin style, then return the
+    aggregated squares to our parent.
+
+    '''
+    async with tractor.open_nursery() as an:
+        portals: list[tractor.Portal] = []
+        for i in (1, 2):
+            portals.append(
+                await an.start_actor(
+                    f'leaf_{i}',
+                    enable_modules=[__name__],
+                )
+            )
+        # unblock the parent's `.open_context()` entry and
+        # report which leaves came up.
+        await ctx.started(
+            [p.chan.aid.name for p in portals]
+        )
+        squares: dict[int, int] = {}
+
+        async def run_in_leaf(
+            portal: tractor.Portal,
+            x: int,
+        ) -> None:
+            squares[x] = await portal.run(
+                compute_square,
+                x=x,
+            )
+
+        # fan out one sub-RPC per input val, concurrently.
+        async with trio.open_nursery() as tn:
+            for i, x in enumerate(vals):
+                tn.start_soon(
+                    run_in_leaf,
+                    portals[i % len(portals)],
+                    x,
+                )
+        # graceful inside-out teardown: leaves go first!
+        for portal in portals:
+            leaf_name: str = portal.chan.aid.name
+            print(f'supervisor: cancelling {leaf_name}')
+            await portal.cancel_actor()
+    return [squares[x] for x in vals]
+
+
+async def main() -> None:
+    async with tractor.open_nursery() as an:
+        portal = await an.start_actor(
+            'supervisor',
+            enable_modules=[__name__],
+        )
+        async with portal.open_context(
+            fan_out_squares,
+            vals=[1, 2, 3, 4],
+        ) as (ctx, leaf_names):
+            print(f'root: supervisor spawned {leaf_names}')
+            squares: list[int] = await ctx.wait_for_result()
+            assert squares == [1, 4, 9, 16]
+            print(f'root: aggregate result {squares}')
+        print('root: cancelling supervisor')
+        await portal.cancel_actor()
+    print('root: tree torn down, what zombies?')
+
+
+if __name__ == '__main__':
+    trio.run(main)

examples/parallelism/concurrent_futures_primes.py

@@ -1,7 +1,19 @@
+'''
+The pure-stdlib `concurrent.futures.ProcessPoolExecutor`
+primes demo (from the std docs) verbatim; the baseline twin
+of `concurrent_actors_primes.py`.
+
+The `async def main()` + `trio.run()` shim at the bottom only
+exists so the docs-example test runner can exercise this
+script; the executor code itself is untouched stdlib fare.
+
+'''
 import time
 import concurrent.futures
 import math
 
+import trio
+
 PRIMES = [
     112272535095293,
     112582705942171,
@@ -26,7 +38,7 @@ def is_prime(n):
     return True
 
 
-def main():
+def check_primes():
     with concurrent.futures.ProcessPoolExecutor() as executor:
         start = time.time()
 
@@ -36,8 +48,14 @@ def main():
         print(f'processing took {time.time() - start} seconds')
 
 
+async def main() -> None:
+    # thin shim: the pool blocks this (sole) trio task
+    # which is just fine for a one-shot baseline script.
+    check_primes()
+
+
 if __name__ == '__main__':
 
     start = time.time()
-    main()
+    trio.run(main)
     print(f'script took {time.time() - start} seconds')

examples/parallelism/single_func.py

@@ -33,7 +33,7 @@ async def main():
         await burn_cpu()
 
         # wait on result from target function
-        pid = await portal.result()
+        pid = await portal.wait_for_result()
 
     # end of nursery block
     print(f"Collected subproc {pid}")

examples/parallelism/we_are_processes.py

@@ -1,11 +1,11 @@
-"""
+'''
 Run with a process monitor from a terminal using::
 
     $TERM -e watch -n 0.1  "pstree -a $$" \
         & python examples/parallelism/we_are_processes.py \
         && kill $!
 
-"""
+'''
 from multiprocessing import cpu_count
 import os
 
@@ -13,26 +13,70 @@ import tractor
 import trio
 
 
-async def target():
+@tractor.context
-    print(
+async def endpoint(
-        f"Yo, i'm '{tractor.current_actor().name}' "
+    ctx: tractor.Context,
-        f"running in pid {os.getpid()}"
+):
-    )
+    actor_name: str = tractor.current_actor().name
-
+    pid: int = os.getpid()
+    await ctx.started((actor_name, pid))
     await trio.sleep_forever()
 
 
+async def spawn_and_open_ep(
+    an: tractor.ActorNursery,
+    i: int,
+) -> None:
+    '''
+    Spawn a subactor, start a remote `endpoint()`-task in it.
+
+    '''
+    ptl: tractor.Portal = await an.start_actor(
+        name=f'worker_{i}',
+        enable_modules=[__name__],
+    )
+    ctx: tractor.Context
+    async with ptl.open_context(endpoint) as (
+        ctx,
+        (sub_name, sub_pid),
+    ):
+        print(
+            f'Started ep-task in subactor,\n'
+            f'{i}::{sub_name!r}@{sub_pid}\n'
+        )
+        await ctx.wait_for_result()
+
+
 async def main():
+    '''
+    Spawn a subactor-per-CPU then self-destruct the cluster.
 
-    async with tractor.open_nursery() as n:
+    '''
-
+    tn: trio.Nursery
+    an: tractor.ActorNursery
+    async with (
+        tractor.open_nursery(
+            # XXX coming soon!
+            # https://github.com/goodboy/tractor/pull/463
+            # start_method='main_thread_forkserver',
+        ) as an,
+        # spawn subs concurrently (in bg `trio.Task`s) so each
+        # actor's cold `import tractor` (~0.4s, see #470) overlaps
+        # instead of stacking; once forkserver (#463) lands, spawn
+        # is cheap enough to just loop sequentially.
+        trio.open_nursery() as tn,
+    ):
         for i in range(cpu_count()):
-            await n.run_in_actor(target, name=f'worker_{i}')
+            tn.start_soon(
-
+                spawn_and_open_ep,
-        print('This process tree will self-destruct in 1 sec...')
+                an,
-        await trio.sleep(1)
+                i,
-
+            )
-        # you could have done this yourself
+        destruct_in: int = 2
+        print(
+            f'This tree will self-destruct in {destruct_in}s..\n'
+        )
+        await trio.sleep(destruct_in)
         raise Exception('Self Destructed')
 
 

examples/service_daemon_discovery.py

@@ -0,0 +1,68 @@
+'''
+Demonstrate the "service daemon" pattern: a named,
+long-lived actor spawned via `ActorNursery.start_actor()`
+which any other task can locate through the registrar using
+`tractor.find_actor()` / `tractor.wait_for_actor()` - no
+spawn-portal required - and RPC into directly.
+
+Teardown is explicit and graceful via `portal.cancel_actor()`
+once the clients are done.
+
+'''
+import trio
+import tractor
+
+_quotes: dict[str, float] = {
+    'btcusdt': 66_000.5,
+    'ethusdt': 3_500.25,
+}
+
+
+async def get_quote(sym: str) -> float:
+    '''
+    Look up the "current" quote for a symbol.
+
+    '''
+    name: str = tractor.current_actor().name
+    print(f'{name}: serving quote for {sym!r}')
+    return _quotes[sym]
+
+
+async def client_task() -> None:
+    '''
+    Locate the quote service by name and RPC it; note no
+    spawn-nursery/portal reference is ever passed in here!
+
+    '''
+    # a lookup miss yields `None` (not an error).
+    async with tractor.find_actor('no_such_svc') as portal:
+        assert portal is None
+        print('client: "no_such_svc" is not registered')
+    # block until the service shows up in the registry,
+    # then call into it through the delivered portal.
+    async with tractor.wait_for_actor('quote_svc') as portal:
+        quote: float = await portal.run(
+            get_quote,
+            sym='btcusdt',
+        )
+        print(f'client: got btcusdt quote {quote}')
+
+
+async def main() -> None:
+    async with tractor.open_nursery() as an:
+        portal = await an.start_actor(
+            'quote_svc',
+            enable_modules=[__name__],
+        )
+        # run the client in a separate task which discovers
+        # the daemon purely by its registered name.
+        async with trio.open_nursery() as tn:
+            tn.start_soon(client_task)
+        # explicit graceful teardown of the daemon.
+        print('root: cancelling quote_svc')
+        await portal.cancel_actor()
+    print('root: service shut down cleanly')
+
+
+if __name__ == '__main__':
+    trio.run(main)

examples/streaming_broadcast_fanout.py

@@ -0,0 +1,84 @@
+'''
+Demonstrate fanning out ONE inter-actor `MsgStream` to N
+local (parent-side) trio tasks using `MsgStream.subscribe()`:
+each subscriber gets its own `BroadcastReceiver` copy of
+every msg from the single underlying IPC stream.
+
+The child waits for a 'go' msg so that all subscribers are
+guaranteed-attached before the first tick is sent; when the
+child's stream closes each subscriber's `async for` ends
+cleanly.
+
+'''
+import trio
+import tractor
+
+
+@tractor.context
+async def tick_stream(
+    ctx: tractor.Context,
+    count: int,
+) -> None:
+    '''
+    Send `count` "ticks" once the parent says go.
+
+    '''
+    await ctx.started(count)
+    async with ctx.open_stream() as stream:
+        # wait for the go-signal ensuring every parent-side
+        # subscriber is attached before any tick is sent.
+        assert await stream.receive() == 'go'
+        for i in range(count):
+            await stream.send(i)
+        # falling out gracefully closes our stream side;
+        # all parent-side subscribers see end-of-channel.
+
+
+async def consume(
+    name: str,
+    stream: tractor.MsgStream,
+    task_status: trio.TaskStatus = trio.TASK_STATUS_IGNORED,
+) -> None:
+    '''
+    Consume a private broadcast-copy of the IPC stream.
+
+    '''
+    async with stream.subscribe() as bcaster:
+        task_status.started()
+        ticks: list[int] = []
+        async for tick in bcaster:
+            print(f'{name}: rx {tick}')
+            ticks.append(tick)
+        # EVERY subscriber gets its own full copy B)
+        print(f'{name}: stream ended, got {ticks}')
+
+
+async def main() -> None:
+    async with tractor.open_nursery() as an:
+        portal = await an.start_actor(
+            'ticker',
+            enable_modules=[__name__],
+        )
+        async with (
+            portal.open_context(
+                tick_stream,
+                count=5,
+            ) as (ctx, first),
+            ctx.open_stream() as stream,
+        ):
+            assert first == 5
+            async with trio.open_nursery() as tn:
+                # use `.start()` so each consumer is known
+                # to be subscribed before the ticks flow.
+                for i in range(3):
+                    await tn.start(
+                        consume,
+                        f'sub_{i}',
+                        stream,
+                    )
+                await stream.send('go')
+        await portal.cancel_actor()
+
+
+if __name__ == '__main__':
+    trio.run(main)

examples/typed_payloads.py

@@ -0,0 +1,85 @@
+'''
+Demonstrate "typed messaging": applying a `msgspec.Struct`
+payload-type-spec to an IPC context via
+`@tractor.context(pld_spec=...)`.
+
+The child's `ctx.started()` value is stringently (round-trip)
+validated against the spec *on the send side*, so a mistyped
+payload raises a `tractor.MsgTypeError` before it ever hits
+the wire; stream payloads are checked on `receive()` and
+decode natively to the struct type.
+
+'''
+from msgspec import Struct
+
+import trio
+import tractor
+
+
+class Point(Struct):
+    '''
+    A simple 2D-coordinate msg-payload type.
+
+    '''
+    x: int
+    y: int
+
+
+@tractor.context(pld_spec=Point|None)
+async def point_doubler(
+    ctx: tractor.Context,
+) -> None:
+    '''
+    Stream back each received `Point` with doubled fields.
+
+    '''
+    # deliberately send a non-`Point` as our started-value;
+    # the send-side pld-spec validation catches it locally
+    # BEFORE anything is shipped over IPC.
+    try:
+        await ctx.started('this is no Point..')
+    except tractor.MsgTypeError:
+        print(
+            'child: just as planned, a `str` payload failed '
+            'the `Point|None` pld-spec B)'
+        )
+    # now do it right; the parent receives this as the 2nd
+    # element of its `.open_context()` entry tuple.
+    await ctx.started(Point(x=0, y=0))
+    async with ctx.open_stream() as stream:
+        async for pt in stream:
+            # natively decoded to our struct type!
+            assert type(pt) is Point
+            await stream.send(
+                Point(
+                    x=pt.x * 2,
+                    y=pt.y * 2,
+                )
+            )
+
+
+async def main() -> None:
+    async with tractor.open_nursery() as an:
+        portal = await an.start_actor(
+            'point_doubler',
+            enable_modules=[__name__],
+        )
+        async with (
+            portal.open_context(
+                point_doubler,
+            ) as (ctx, first),
+            ctx.open_stream() as stream,
+        ):
+            # the (validated) started-value from the child
+            assert first == Point(x=0, y=0)
+            for i in range(3):
+                await stream.send(Point(x=i, y=i))
+                doubled: Point = await stream.receive()
+                assert doubled == Point(x=i * 2, y=i * 2)
+                print(f'parent: rx {doubled}')
+        # explicitly teardown the daemon-actor
+        await portal.cancel_actor()
+
+
+if __name__ == '__main__':
+    trio.run(main)

examples/uds_transport_actor_tree.py

@@ -0,0 +1,58 @@
+'''
+Demonstrate an actor tree which talks over unix-domain-socket
+(UDS) transport instead of the default TCP: pass
+`enable_transports=['uds']` when opening the root and every
+subactor inherits the preference.
+
+Every channel address is a filesystem socket path (no TCP port
+in sight!) and, as a kernel-provided bonus, the peer's pid is
+exchanged for free via `SO_PEERCRED`.
+
+'''
+import os
+
+import trio
+import tractor
+
+
+async def report_addr() -> str:
+    '''
+    Return this actor's own accept (bind) addr + pid.
+
+    '''
+    actor = tractor.current_actor()
+    addr: tuple = actor.accept_addr
+    pid: int = os.getpid()
+    return f'{actor.name}@{addr} pid={pid}'
+
+
+async def main() -> None:
+    async with tractor.open_nursery(
+        enable_transports=['uds'],
+    ) as an:
+        portal = await an.start_actor(
+            'uds_child',
+            enable_modules=[__name__],
+        )
+        # the channel's remote addr is a `UDSAddress`: a
+        # filesystem socket path, NOT a (host, port) pair!
+        raddr = portal.chan.raddr
+        assert raddr.proto_key == 'uds'
+        # NOTE, `.sockpath` is the *shared listener* socket file
+        # (named for the root registrar) this channel rode in
+        # on, NOT a per-child path; the child-specific identity
+        # we get for free is the kernel-reported peer pid (via
+        # `SO_PEERCRED`).
+        print(
+            f'portal chan tpt proto: {raddr.proto_key!r}\n'
+            f'listener sock file: {raddr.sockpath}\n'
+            f'kernel-reported peer pid: {raddr.maybe_pid}\n'
+        )
+        # ask the child for its OWN distinct bind addr: another
+        # socket-file path under the runtime dir.
+        print(f'child says: {await portal.run(report_addr)}')
+        await portal.cancel_actor()
+
+
+if __name__ == '__main__':
+    trio.run(main)

flake.nix

@@ -25,43 +25,63 @@
           cpython = "python313";
           venv_dir = "py313";
           pypkgs = pkgs."${cpython}Packages";
+
+          # shared base toolchain for every dev-shell variant;
+          # extra-tooling shells (eg. `docs`, below) extend it
+          # so heavy/niche deps stay OUT of the `default` shell.
+          basePkgs = [
+            # XXX, ensure sh completions activate!
+            pkgs.bashInteractive
+            pkgs.bash-completion
+
+            # XXX, on nix(os), use pkgs version to avoid
+            # build/sys-sh-integration issues
+            pkgs.ruff
+
+            pkgs.uv
+            pkgs.${cpython}# ?TODO^ how to set from `cpython` above?
+          ];
+
+          baseHook = ''
+            # unmask to debug **this** dev-shell-hook
+            # set -e
+
+            # link-in c++ stdlib for various AOT-ext-pkgs (numpy, etc.)
+            LD_LIBRARY_PATH="${pkgs.stdenv.cc.cc.lib}/lib:$LD_LIBRARY_PATH"
+
+            export LD_LIBRARY_PATH
+
+            # RUNTIME-SETTINGS
+            # ------ uv ------
+            # - always use the ./py313/ venv-subdir
+            # - sync env with all extras
+            export UV_PROJECT_ENVIRONMENT=${venv_dir}
+            uv sync --dev --all-extras
+
+            # ------ TIPS ------
+            # NOTE, to launch the py-venv installed `xonsh` (like @goodboy)
+            # run the `nix develop` cmd with,
+            # >> nix develop -c uv run xonsh
+          '';
         in
         {
           default = pkgs.mkShell {
+            packages = basePkgs;
+            shellHook = baseHook;
+          };
 
-            packages = [
+          # OPT-IN docs shell: `default` + the `d2` diagram
-              # XXX, ensure sh completions activate!
+          # renderer, kept OUT of `default` so casual dev shells
-              pkgs.bashInteractive
+          # don't pull it in. Enter with,
-              pkgs.bash-completion
+          #   >> nix develop .#docs
-
+          # then build (the `.. d2::` directive auto-detects the
-              # XXX, on nix(os), use pkgs version to avoid
+          # `d2` bin now on PATH; see `docs/_ext/d2diagrams.py`),
-              # build/sys-sh-integration issues
+          #   >> uv run --group docs make -C docs html
-              pkgs.ruff
+          docs = pkgs.mkShell {
-
+            packages = basePkgs ++ [ pkgs.d2 ];
-              pkgs.uv
+            shellHook = baseHook + ''
-              pkgs.${cpython}# ?TODO^ how to set from `cpython` above?
+              echo "[docs] d2 $(d2 --version) on PATH \
-            ];
+              — build via: uv run --group docs make -C docs html"
-
-            shellHook = ''
-              # unmask to debug **this** dev-shell-hook
-              # set -e
-
-              # link-in c++ stdlib for various AOT-ext-pkgs (numpy, etc.)
-              LD_LIBRARY_PATH="${pkgs.stdenv.cc.cc.lib}/lib:$LD_LIBRARY_PATH"
-
-              export LD_LIBRARY_PATH
-
-              # RUNTIME-SETTINGS
-              # ------ uv ------
-              # - always use the ./py313/ venv-subdir
-              # - sync env with all extras
-              export UV_PROJECT_ENVIRONMENT=${venv_dir}
-              uv sync --dev --all-extras
-
-              # ------ TIPS ------
-              # NOTE, to launch the py-venv installed `xonsh` (like @goodboy)
-              # run the `nix develop` cmd with,
-              # >> nix develop -c uv run xonsh
             '';
           };
         }

notes_to_self/howtodocs.md

@@ -0,0 +1,164 @@
+# How to build + view the docs
+
+The site is `sphinx` + `pydata-sphinx-theme`, with diagrams in
+[`d2`](https://d2lang.com) (our local `.. d2::` directive) and
+*every* code block `literalinclude`-d straight from `examples/`
+(never copy-pasted — what you read is what CI runs).
+
+## TL;DR
+
+```
+uv run --group docs make -C docs html
+firefox docs/_build/html/index.html
+```
+
+## Nix users
+
+`d2` (the diagram renderer) is deliberately kept **out** of the
+default dev-shell so casual envs stay lean; it lives in an opt-in
+`docs` shell:
+
+```
+# enter the docs shell (puts `d2`, `uv` + python on PATH)
+nix develop .#docs
+
+# ...then build (diagrams re-render from docs/diagrams/*.d2)
+uv run --group docs make -C docs html
+```
+
+one-shot, without staying in the shell:
+
+```
+nix develop .#docs -c uv run --group docs make -C docs html
+```
+
+## Live-reload while editing
+
+Rebuilds + refreshes the browser on every save:
+
+```
+nix develop .#docs -c uv run --with sphinx-autobuild \
+    --group docs sphinx-autobuild docs docs/_build/html \
+    --watch examples
+# then open http://127.0.0.1:8000
+```
+
+The `--watch examples` is what makes edits to ``literalinclude``-d
+example scripts live-reload too: those files live *outside* `docs/`,
+so autobuild won't notice them changing without it.
+
+## Share it on your LAN
+
+To let someone on your subnet view the docs, bind the server to
+all interfaces (`--host 0.0.0.0`) instead of just localhost, then
+hand them `http://<your-lan-ip>:8000`.
+
+Live-reload, LAN-visible:
+
+```
+nix develop .#docs -c uv run --with sphinx-autobuild --group docs \
+    sphinx-autobuild docs docs/_build/html --host 0.0.0.0 --port 8000 \
+    --watch examples
+```
+
+Or just statically serve an already-built `docs/_build/html` (no
+rebuild-on-save):
+
+```
+python -m http.server -d docs/_build/html --bind 0.0.0.0 8000
+```
+
+Find the IP to give them (first one is usually your LAN iface):
+
+```
+hostname -I
+```
+
+> Heads-up: this is an unauthenticated static server bound to
+> every interface — fine on a trusted LAN, but don't leave it
+> running on an untrusted/public network.
+
+## Diagrams (`d2`)
+
+- `.d2` sources live in `docs/diagrams/`; their rendered SVGs are
+  git-committed under `docs/_diagrams/` as a fallback.
+- with a `d2` binary on `PATH` (the `.#docs` shell, or set
+  `D2_BIN='nix run nixpkgs#d2 --'`) any stale SVG re-renders at
+  build time.
+- with NO binary, the committed SVGs are served as-is, so CI and
+  casual builds need no `d2` at all.
+- a `.d2` that *fails to compile* is a hard build error under
+  `sphinx-build -W` (the last-good committed SVG is left intact).
+
+## Tweaking the logo
+
+The logo is plain SVG — colours are just editable text, so change
+them, save, and autobuild repaints the live page. Three contexts
+use it, coloured three different ways (an `<img>`-embedded svg
+can't read the page's CSS, so only the *inlined* hero can follow
+the live light/dark toggle):
+
+| context | file(s) | how it's coloured |
+|---|---|---|
+| **landing hero** | `docs/_static/tractor_logo_hero.html` (inlined into `index.rst`) + the `svg.hero-logo` rule in `docs/_static/css/custom.css` | linework is `fill: currentColor`, so it takes whatever `color:` the CSS sets — currently `var(--pst-color-text-base)` (the theme text colour). **← recolour on a whim by editing that one `color:` line.** |
+| **navbar** | `docs/_static/tractor_logo_nav_light.svg` + `…_nav_dark.svg`, wired via `html_theme_options["logo"]` in `docs/conf.py` | baked fills — near-black lines on light, near-white on dark; pydata swaps them by theme |
+| **README** | `docs/_static/tractor_logo_wire.svg` | one baked neutral-grey (GitHub/PyPI can't read the theme), with inline fills so it survives GitHub's svg sanitiser |
+
+The shape's "faces" are `fill: none` everywhere, so the page
+background shows through — that's the wireframe look. The original
+filled `tractor_logo_side.svg` is kept as the source to recolour
+from (and as the favicon).
+
+## svgtool: recolor + preview svgs
+
+`notes_to_self/svgtool.py` is a tiny helper for iterating on the
+logo (or any svg). It renders through headless firefox, so masks,
+`currentColor` and theme CSS look exactly like the built site.
+
+```
+# list the distinct colours in an svg
+python notes_to_self/svgtool.py colors docs/_static/tractor_logo_side.svg
+
+# write a recoloured copy (literal token swaps)
+python notes_to_self/svgtool.py recolor in.svg out.svg \
+    '#0A0A0A=currentColor' '#FCFCFB=none'
+
+# render an svg alone on a bg colour (reveals transparency)
+python notes_to_self/svgtool.py preview out.svg /tmp/p.png --bg '#ff00ff'
+
+# screenshot a BUILT page, forcing light/dark (see below)
+python notes_to_self/svgtool.py page docs/_build/html/index.html \
+    /tmp/dark.png --theme dark
+```
+
+### Why `page --theme dark`? (verifying dark mode headlessly)
+
+The non-obvious bit, for the sphinx-rusty:
+
+- pydata-sphinx-theme decides light-vs-dark **in the browser** at
+  page load, from a value saved in `localStorage` (or your OS
+  setting if you've never clicked the toggle).
+- a fresh headless screenshot starts with an *empty* `localStorage`,
+  so it always renders the default (light) — you could never grab
+  the dark variant.
+- `--theme dark` sidesteps that: it writes a throwaway copy of the
+  built HTML with a one-line injected `<script>` that pre-sets
+  `localStorage` (+ the `data-theme` attribute) to `dark`, then
+  screenshots that copy. pydata reads "dark" → renders dark.
+  (`--theme light` forces the other way.)
+
+So the loop for any theme-adaptive tweak is: build → `svgtool page
+<built-html> out.png --theme dark` → look. That's how the
+wireframe logo got checked in both modes without clicking a thing.
+
+## Keep it warning-free
+
+The build is currently 0-warning — keep it that way. `-W` turns
+any sphinx warning into a failure:
+
+```
+uv run --group docs sphinx-build -b html -W docs docs/_build/html
+```
+
+> The rendered version of this note lives in the contributor
+> guide: `docs/project/dev-tips.rst` → "Building these docs".

notes_to_self/svgtool.py

@@ -0,0 +1,224 @@
+#!/usr/bin/env python3
+'''
+svgtool — tiny SVG recolor + preview helper for fast logo
+tweaking. Rendering goes through headless firefox so CSS
+(masks, `prefers-color-scheme`, webfonts) is honored exactly
+like the real docs.
+
+Subcommands
+-----------
+  colors  SVG
+      list the distinct fill/stroke/stop colors in an svg.
+
+  recolor SVG OUT  old=new [old=new ...]
+      literal-replace color tokens, write OUT (great for
+      swapping `.stN{fill:#aaa}` style values or hex codes).
+
+  preview SVG OUT.png [--bg C] [--w N] [--scheme light|dark]
+      render an svg alone on a bg colour (default white, or
+      #1a1a1a under --scheme dark) to eyeball transparency +
+      shape. --scheme forces `prefers-color-scheme`.
+
+  page    URL_or_path OUT.png [--w N --h N] [--scheme light|dark]
+      screenshot a *built* html page (e.g. docs/_build/html/
+      index.html). --scheme dark|light forces the page's
+      color-scheme so a pydata `data-theme=auto` site renders
+      its dark/light variant — the way to verify theme-adaptive
+      logos without clicking the toggle.
+
+Examples
+--------
+  svgtool.py colors docs/_static/tractor_logo_side.svg
+  svgtool.py recolor in.svg out.svg '#FCFCFB=none' '#0A0A0A=#fff'
+  svgtool.py preview out.svg /tmp/p.png --bg '#ff00ff' --w 600
+  svgtool.py page docs/_build/html/index.html /tmp/dark.png \
+      --w 1300 --h 900 --scheme dark
+'''
+from __future__ import annotations
+
+import argparse
+from pathlib import Path
+import re
+import subprocess as sp
+import tempfile
+
+FF: str = 'firefox'
+_color_re = re.compile(
+    r'(?:fill|stroke|stop-color)\s*[:=]\s*"?'
+    r'(#[0-9a-fA-F]{3,8}|none|transparent|currentColor)'
+)
+
+
+def _colors(text: str) -> list[str]:
+    return sorted(set(_color_re.findall(text)))
+
+
+def _profile(scheme: str|None) -> str:
+    '''
+    Spin up a throwaway firefox profile, optionally forcing
+    `prefers-color-scheme` via the content-override pref
+    (0 = dark, 1 = light).
+
+    '''
+    d: str = tempfile.mkdtemp(prefix='svgtool-ff-')
+    if scheme:
+        val: int = {'dark': 0, 'light': 1}[scheme]
+        Path(d, 'user.js').write_text(
+            f'user_pref('
+            f'"layout.css.prefers-color-scheme.content-override",'
+            f' {val});\n'
+        )
+    return d
+
+
+def _shot(
+    url: str,
+    out: str,
+    w: int,
+    h: int,
+    scheme: str|None,
+) -> None:
+    prof: str = _profile(scheme)
+    sp.run(
+        [
+            FF, '--headless', '--no-remote',
+            '-profile', prof,
+            '--screenshot', str(out),
+            f'--window-size={w},{h}',
+            url,
+        ],
+        stdout=sp.DEVNULL,
+        stderr=sp.DEVNULL,
+        timeout=90,
+    )
+    print(out)
+
+
+def cmd_colors(a: argparse.Namespace) -> None:
+    print('\n'.join(_colors(Path(a.svg).read_text())))
+
+
+def cmd_recolor(a: argparse.Namespace) -> None:
+    text: str = Path(a.svg).read_text()
+    for pair in a.pairs:
+        old, new = pair.split('=', 1)
+        if old not in text:
+            print(f'  ! {old!r} not found (skipped)')
+            continue
+        text = text.replace(old, new)
+    Path(a.out).write_text(text)
+    print(f'wrote {a.out}')
+
+
+def cmd_preview(a: argparse.Namespace) -> None:
+    bg: str = a.bg or (
+        '#1a1a1a' if a.scheme == 'dark' else '#ffffff'
+    )
+    src: str = Path(a.svg).resolve().as_uri()
+    html = Path(tempfile.mktemp(suffix='.html'))
+    html.write_text(
+        f'<!doctype html><html><body '
+        f'style="margin:0;background:{bg}">'
+        f'<img src="{src}" '
+        f'style="width:{a.w}px;display:block"></body></html>'
+    )
+    _shot(
+        html.resolve().as_uri(),
+        a.out,
+        a.w + 40,
+        int(a.w * 0.9),
+        a.scheme,
+    )
+
+
+# early script that pins a pydata-sphinx-theme page to a given
+# mode/theme (beats the localStorage/auto default) so headless
+# shots can verify theme-adaptive content without the toggle.
+_force_theme = (
+    '<script>try{{'
+    'localStorage.setItem("mode","{t}");'
+    'localStorage.setItem("theme","{t}");'
+    'document.documentElement.setAttribute("data-theme","{t}");'
+    'document.documentElement.setAttribute("data-mode","{t}");'
+    '}}catch(e){{}}</script>'
+)
+
+
+def cmd_page(a: argparse.Namespace) -> None:
+    src = Path(a.url)
+    if a.theme and src.exists():
+        # inject the force-theme script into a sibling temp copy
+        # (same dir → relative _static/ asset paths still resolve).
+        html: str = src.read_text()
+        inj: str = _force_theme.format(t=a.theme)
+        html = re.sub(
+            r'(<head[^>]*>)',
+            r'\1' + inj,
+            html,
+            count=1,
+        )
+        tmp = src.with_name(f'._svgtool_{a.theme}.html')
+        tmp.write_text(html)
+        try:
+            _shot(tmp.resolve().as_uri(), a.out, a.w, a.h, None)
+        finally:
+            tmp.unlink(missing_ok=True)
+        return
+    url: str = (
+        a.url
+        if '://' in a.url
+        else src.resolve().as_uri()
+    )
+    _shot(url, a.out, a.w, a.h, a.scheme)
+
+
+def main() -> None:
+    p = argparse.ArgumentParser(prog='svgtool.py')
+    sub = p.add_subparsers(required=True)
+
+    c = sub.add_parser('colors')
+    c.add_argument('svg')
+    c.set_defaults(fn=cmd_colors)
+
+    r = sub.add_parser('recolor')
+    r.add_argument('svg')
+    r.add_argument('out')
+    r.add_argument('pairs', nargs='+')
+    r.set_defaults(fn=cmd_recolor)
+
+    v = sub.add_parser('preview')
+    v.add_argument('svg')
+    v.add_argument('out')
+    v.add_argument('--bg', default=None)
+    v.add_argument('--w', type=int, default=600)
+    v.add_argument(
+        '--scheme',
+        choices=['light', 'dark'],
+        default=None,
+    )
+    v.set_defaults(fn=cmd_preview)
+
+    g = sub.add_parser('page')
+    g.add_argument('url')
+    g.add_argument('out')
+    g.add_argument('--w', type=int, default=1300)
+    g.add_argument('--h', type=int, default=900)
+    g.add_argument(
+        '--scheme',
+        choices=['light', 'dark'],
+        default=None,
+    )
+    g.add_argument(
+        '--theme',
+        choices=['light', 'dark'],
+        default=None,
+        help='force a pydata data-theme (toggle-accurate)',
+    )
+    g.set_defaults(fn=cmd_page)
+
+    a = p.parse_args()
+    a.fn(a)
+
+
+if __name__ == '__main__':
+    main()

pyproject.toml

@@ -118,12 +118,19 @@ eventfd = [
 subints = [
   "msgspec>=0.21.0",
 ]
-# TODO, add these with sane versions; were originally in
+# docs generation; build locally via,
-# `requirements-docs.txt`..
+#   uv run --group docs make -C docs html
-# docs = [
+# diagrams re-render when a `d2` bin is found, see
-#   "sphinx>="
+# `docs/_ext/d2diagrams.py` (eg. via `nix run
-#   "sphinx_book_theme>="
+# nixpkgs#d2` and the `D2_BIN` env var).
-# ]
+docs = [
+  "sphinx>=9.1,<10",
+  "pydata-sphinx-theme>=0.18,<0.19",
+  "sphinx-design>=0.7,<0.8",
+  "sphinx-copybutton>=0.5.2,<0.6",
+  "sphinxext-opengraph>=0.13,<0.14",
+  "sphinx-togglebutton>=0.4.5,<0.5",
+]
 # ------ dependency-groups ------
 
 [tool.uv.dependency-groups]