Document the realism content engine, the orchestrator service collapse,
and every public surface change from the migration on dev.
Page-level changes:
- Realism.md (new) — operator walkthrough of the realism library:
ContentClass taxonomy, persona pools (topology vs global), diurnal
gating, edit-in-place, LLM enrichment with circuit breaker, and 3%
canary cultivation. Configuration table and CLI surface.
- Module-Reference-Core.md — new "decnet/realism/" section covering
taxonomy / planner / naming / bodies / personas / LLM backend /
prompts. Notes the env-var rename.
- Module-Reference-Workers.md — new "Orchestrator" section covering
the unified worker, action-kind weights, drivers (ActivityDriver
ABC, plant_file/read_file contract, _run_edit), and the email
delivery surface that stayed put (events / threads / scheduler).
- Service-Bus.md — fix orchestrator topic table: emailgen producer
attribution is gone (orchestrator owns email now), system.emailgen.*
topics removed.
- CLI-Reference.md — new "decnet orchestrate" and "decnet realism
import-personas" sections plus DECNET_REALISM_* / DECNET_CANARY_*
rows in the env summary.
- Environment-Variables.md — new "Realism content engine" and
"Canary worker" sections; starter .env.local entries appended.
- Systemd-Setup.md — bundled decnet-orchestrator.service template
with the realism env block; explicit note that decnet-emailgen
is gone post-migration.
- Design-Overview.md — Orchestrator + Canary rows added to the
microservice table; Realism cross-link in the Related Pages list.
- Roadmap-and-Known-Debt.md — moved orchestrator-fake-files and
emailgen-twin-worker entries to "Recently closed" with a pointer
to the migration history.
- Home.md, _Sidebar.md — Realism added to the user-docs nav.
docs: document swarm/agent/updater APIs and add PKI-and-mTLS reference
- Module-Reference-Workers: new sections for decnet/swarm/, decnet/agent/,
and decnet/updater/ covering exported symbols, FastAPI routes, uvicorn
launcher flags, and the executor seams the test suite monkeypatches.
- PKI-and-mTLS: standalone developer page covering CA generation, leaf
issuance, SSLContext wiring (client + server), the VERIFY_X509_STRICT
workaround for Python 3.13, the RFC 5425 log pipeline's reuse of the
same CA, and the currently-unenforced CN/role-separation gap.
- Sidebar: link the new PKI page from the Developer docs section.
