docs: record proposed fork gather semantics

This commit is contained in:
lda
2026-09-03 22:42:50 +07:00 Verified
parent 327a7b24b0
commit d9559bfbd2
4 changed files with 174 additions and 7 deletions
+27 -6
View File
@@ -260,6 +260,33 @@ state, records trace, and persists runs predictably even when individual
capabilities call nondeterministic tools, APIs, Python code, or LLMs.
_Avoid_: Deterministic external tools, deterministic LLM output
**Fork**:
An explicit workflow control step that creates several concurrent branch
activations. A fork is distinct from an ordinary outcome, which selects exactly
one continuation.
_Avoid_: Multiple matching edges, implicit broadcast, async handler call
**Gather**:
An explicit workflow control step that waits for compatible activation tokens
at every declared local input slot, merges their lineage-local state according
to reducers and gather policy, and emits one continuation. Several alternative
edges may satisfy one slot.
_Avoid_: Pass-through join marker, arbitrary graph convergence, reference to one
originating fork
**Activation Token**:
A runtime value identifying one control-flow arrival, its workflow scope,
lineage worldview, activation context, and merge provenance. Compatible tokens
can rendezvous at a gather without mixing loop iterations, subgraph
invocations, or repeated fork activations.
_Avoid_: Static edge, node output payload, scheduler position
**Gather Slot**:
A named local rendezvous requirement on a gather. A gather requires all of its
slots, while any one compatible incoming edge assigned to a slot can satisfy
that slot.
_Avoid_: Fork branch reference, positional input, executable edge predicate
**Planner Efficiency**:
The degree to which the platform reduces LLM trial-and-error when creating or
running workflows. Typed schemas, source catalogs, validation errors, dry
@@ -443,12 +470,6 @@ Persisted deployments and server-side execution make scheduling plausible, but
scheduling itself is not implemented yet.
_Avoid_: Claiming production background scheduling exists today
**Fork/Gather Workflow Control**:
Future workflow control for parallel branches and explicit gather/join behavior.
The current product should not claim general fork/gather orchestration yet.
_Avoid_: Treating current foreach or serial graph execution as full parallel
workflow orchestration
**Scheduler Foundation**:
The runtime model that selects runnable frames and advances workflow execution without assuming there is only one active cursor.
_Avoid_: Foreach feature, concurrent foreach implementation