docs: consolidate design documentation and standardize crate English

2026-10-12 14:58:00 +09:00
parent a633a53274
commit 4efb0ace1f
404 changed files with 4556 additions and 11654 deletions
@@ -0,0 +1,10 @@
+# flow
+
+`flow` compiles DCDL state graphs into typed definitions and evaluates transitions against pinned definitions and verification results. Callers own Workspace source persistence, Worker Session writes, and internal verifier execution. This crate implements neither role-specific work loops nor state-entry side effects.
+
+## Main entry points
+
+- [`compile_flow_source`](src/definition.rs): Source evaluation and graph validation.
+- [`FlowSelector`](src/selector.rs) / [`ResolvedFlowSource`](src/selector.rs): Explicit source identity and immutable snapshots.
+- [`FlowRuntimeState`](src/coordinator.rs): Instances, transition attempts, and ordered events.
+- [`builtin_flow_source`](src/builtin.rs): Read-only catalog of embedded sources.