arborist/docs/diagrams
russell@unturf.com 06e6c7a918
docs: 3 concepts diagrams + Python-library cookbook recipes
Address Grok's two minor-improvement flags on the docs.

New docs/diagrams/{three-layer-stack,cache-key-8dim,falsification-states}.{dot,svg,png}
embedded into docs/_source/concepts.rst — visual scaffolding for the
3-layer stack, 8-dim cache_key composition, and falsification state
machine (previously prose+tables only).

docs/_source/cookbook.rst gains a "Use arborist as a Python library"
section: open_store + ingest_documents, custom Source subclass,
audit-chain walk + verify, Merkle proof round-trip, programmatic
arborist.qa.query() with OpenAICompatibleClient + StubClient swap.

Every Python recipe smoke-tested against a scratch DB before publish.
make docs-api: 0 new warnings. make test: 2557 passed.
2026-05-24 14:12:26 -04:00
..
arborist-modules.dot docs/diagrams: rename aborist-modules → arborist-modules (post-rename cleanup) 2026-05-08 07:50:28 -04:00
arborist-modules.png modified: docs/diagrams/arborist-modules.png 2026-05-19 17:05:16 -04:00
arborist-modules.svg docs/diagrams: rename aborist-modules → arborist-modules (post-rename cleanup) 2026-05-08 07:50:28 -04:00
cache-key-8dim.dot docs: 3 concepts diagrams + Python-library cookbook recipes 2026-05-24 14:12:26 -04:00
cache-key-8dim.png docs: 3 concepts diagrams + Python-library cookbook recipes 2026-05-24 14:12:26 -04:00
cache-key-8dim.svg docs: 3 concepts diagrams + Python-library cookbook recipes 2026-05-24 14:12:26 -04:00
falsification-states.dot docs: 3 concepts diagrams + Python-library cookbook recipes 2026-05-24 14:12:26 -04:00
falsification-states.png docs: 3 concepts diagrams + Python-library cookbook recipes 2026-05-24 14:12:26 -04:00
falsification-states.svg docs: 3 concepts diagrams + Python-library cookbook recipes 2026-05-24 14:12:26 -04:00
ingest-pipeline.dot docs: README label refresh + per-module reference + Graphviz diagrams 2026-05-01 23:19:01 -04:00
ingest-pipeline.png docs: README label refresh + per-module reference + Graphviz diagrams 2026-05-01 23:19:01 -04:00
ingest-pipeline.svg docs: README label refresh + per-module reference + Graphviz diagrams 2026-05-01 23:19:01 -04:00
mesh-data-flow.dot aborist/arborist 2026-05-07 09:31:49 -04:00
mesh-data-flow.png docs: mesh multiplayer protocol with dot diagrams 2026-04-28 12:54:36 -04:00
mesh-data-flow.svg docs: README label refresh + per-module reference + Graphviz diagrams 2026-05-01 23:19:01 -04:00
mesh-epoch-lifecycle.dot aborist/arborist 2026-05-07 09:31:49 -04:00
mesh-epoch-lifecycle.png docs: mesh multiplayer protocol with dot diagrams 2026-04-28 12:54:36 -04:00
mesh-epoch-lifecycle.svg modified: docs/diagrams/arborist-modules.png 2026-05-19 17:05:16 -04:00
mesh-group-decisions.dot aborist/arborist 2026-05-07 09:31:49 -04:00
mesh-group-decisions.png docs: mesh multiplayer protocol with dot diagrams 2026-04-28 12:54:36 -04:00
mesh-group-decisions.svg aborist/arborist 2026-05-07 09:31:49 -04:00
mesh-identity-stack.dot aborist/arborist 2026-05-07 09:31:49 -04:00
mesh-identity-stack.png docs: mesh multiplayer protocol with dot diagrams 2026-04-28 12:54:36 -04:00
mesh-identity-stack.svg docs: README label refresh + per-module reference + Graphviz diagrams 2026-05-01 23:19:01 -04:00
mesh-secret-envelope.dot aborist/arborist 2026-05-07 09:31:49 -04:00
mesh-secret-envelope.png docs: mesh multiplayer protocol with dot diagrams 2026-04-28 12:54:36 -04:00
mesh-secret-envelope.svg docs: README label refresh + per-module reference + Graphviz diagrams 2026-05-01 23:19:01 -04:00
pager-arch-stack.dot docs: pagers — rename 'not grounded' → 'ungrounded' (agreed label set: grounded / partly grounded / ungrounded) 2026-05-14 12:56:13 -04:00
pager-arch-stack.png docs: pagers — rename 'not grounded' → 'ungrounded' (agreed label set: grounded / partly grounded / ungrounded) 2026-05-14 12:56:13 -04:00
pager-arch-stack.svg docs: pagers — rename 'not grounded' → 'ungrounded' (agreed label set: grounded / partly grounded / ungrounded) 2026-05-14 12:56:13 -04:00
pager-verifier-flow.dot docs: pagers — rename 'not grounded' → 'ungrounded' (agreed label set: grounded / partly grounded / ungrounded) 2026-05-14 12:56:13 -04:00
pager-verifier-flow.png docs: pagers — rename 'not grounded' → 'ungrounded' (agreed label set: grounded / partly grounded / ungrounded) 2026-05-14 12:56:13 -04:00
pager-verifier-flow.svg docs: pagers — rename 'not grounded' → 'ungrounded' (agreed label set: grounded / partly grounded / ungrounded) 2026-05-14 12:56:13 -04:00
query-pipeline.dot docs: distill #000008+#000009+#000010 into core docs + diagrams 2026-05-03 19:18:22 -04:00
query-pipeline.png modified: docs/diagrams/arborist-modules.png 2026-05-19 17:05:16 -04:00
query-pipeline.svg docs: distill #000008+#000009+#000010 into core docs + diagrams 2026-05-03 19:18:22 -04:00
three-layer-stack.dot docs: 3 concepts diagrams + Python-library cookbook recipes 2026-05-24 14:12:26 -04:00
three-layer-stack.png docs: 3 concepts diagrams + Python-library cookbook recipes 2026-05-24 14:12:26 -04:00
three-layer-stack.svg docs: 3 concepts diagrams + Python-library cookbook recipes 2026-05-24 14:12:26 -04:00
verifier-ladder.dot docs: distill #000008+#000009+#000010 into core docs + diagrams 2026-05-03 19:18:22 -04:00
verifier-ladder.png docs: README label refresh + per-module reference + Graphviz diagrams 2026-05-01 23:19:01 -04:00
verifier-ladder.svg docs: distill #000008+#000009+#000010 into core docs + diagrams 2026-05-03 19:18:22 -04:00