Changelog

v0.6.4 (2026-07-01)

Oi.Dispatch.Config now owns data type and drafts construction: build_drafting/2 and assemble_run_opts/2 moved from Oi.execute/2 into Config, reducing the entry module to delegation-only.
Options new internal-only, called exclusively through Config.
Worker calls Oi.Dispatch.Config.assemble_run_opts/2 instead of reaching into Options directly.

resolve_data/2 now validates input format explicitly. Returns {:error, :invalid_data_format} for unrecognised shapes instead of silently producing empty maps. build_drafting_inputs/2 propagates the error tuple.
orchid_stratum/1 → orchid_stratum/2 — accepts %Oi.Dispatch.Config{} as second argument. Same for orchid_intervention_and_stratum. Callers in tests updated.
unwrap_tuple/1 now handles list input — resolves list param map ↔ tuple data mismatch.
flatten_data/1 detects format per-entry instead of requiring homogeneous maps.
Intervention value format documented: {type, value} where type is an atom (:override, :offset, or a custom module). Plain values default to :override. Tuple payloads should use %Orchid.Param{} to preserve type info.
Oi.Step docs translated from Chinese to English.

Oi.Flowgraph.many_step/1 — batch-add steps that share no options. Expands to a block of step/1 calls.

graph do
  many_step [LoadPosts, LoadPages, LoadImages]
  step Markdown, as: :md, opts: [...]
  ...
end

orchid_symbiont is now an optional dependency. Session auto-detects whether OrchidSymbiont.Runtime is available at runtime and omits the child spec when the dep is not installed. Oi.Step raises a clear error at compile time if symbiont?: true is used without the dep.
step macro: removed compile-time function_exported? validation (unreliable across files during macro expansion). Validation is deferred to add_step/3 at runtime. For compile-time enforcement, add Code.ensure_compiled!(Module) at module level in your graph file.

step macro: unquote(module) → unquote(resolved) so that add_step/3 receives the expanded module atom instead of the alias AST, fixing graphs that were silently producing zero nodes.
many_step expansion: fully-qualified Oi.Flowgraph.step/1 calls to guarantee resolution regardless of import context.
Avoid compile-time warnings about undefined OrchidStratum.* modules when orchid_stratum is not installed (optional dep).

Oi.Flowgraph DSL macros — graph/1, step/2, ~>/2 for declarative graph building. Supports both node.port dot-notation and {node, port} tuple form. step validates at compile time that the module implements __node_spec__/0.
Oi.Adapters.orchid_symbiont/1 — opt-in adapter that prepends OrchidSymbiont.Hooks.Injector at runtime when orchid_symbiont is available.

Oi.Result.fetch/2 and reify/2 now return {:error, :not_found} instead of bare :error — consistent with the rest of the codebase.
Oi.Dispatch.Drafting.fetch/2 — same {:error, :not_found} change.
merge_results/2 in Oi.Dispatch.Orchestrator no longer silently drops nil values from step outputs.
Oi.Compile.Bundle.compile_graph/2 now sorts bundles deterministically by cluster name.
Oi.Runtime.Session.Instances supervisor strategy changed from one_for_all to one_for_one — Task.Supervisor and OrchidSymbiont.Runtime no longer cascade-kill each other.

OrchidSymbiont.Hooks.Injector into the hooks stack. Use Oi.Adapters.orchid_symbiont/1 in the :orchid_adapters chain instead.
unwrap_interventions/1 in Options — replaced by wrap_interventions_for_orchid/1 that does a single wrap instead of unwrap-then-rewrap.

Intervention data no longer goes through an unnecessary wrap → unwrap → wrap cycle — raw values are stored in Drafting and wrapped once in assemble_run_opts/3.

Unified :data option — replaces separate :inputs/:interventions with a single data: map. Ports are auto-split by topology: no incoming edge → memory, has incoming edge → intervention. Legacy :inputs / :interventions options deprecated. Now two formats supported:
```
# Nested (recommended)
Oi.execute(compiled, data: %{step1: %{in: "foo"}, step2: %{result: {:override, "bar"}}})

# Tuple keys
Oi.execute(compiled, data: %{{:step1, :in} => "foo"})
```
Splits unified data into memory/intervention maps based on graph topology (edge presence).
Compiled struct now carries edges: MapSet.t(Edge.t()) for downstream port resolution.
Intervention type wrappers ({:override, v}, {:offset, v}, {:custom, v}) preserved as-is through the pipeline.

Oi.Executor.TaskSup: Keyword.fetch! → Keyword.fetch (via-tuple pattern match was always failing, causing all TaskSup-backed sessions to crash).

Renamed :plugins option to :orchid_adapters, simplified to function-only form. Module-based adapter dispatch removed — use Orchid hooks for step-level concerns.
Moved :interventions from Config to Drafting. Config is now purely immutable dispatch configuration; Drafting holds per-dispatch mutable state.
:interventions keys now accept both {:port, node, port} tuples (auto-converted via PortRef.to_orchid_key/1) and raw orchid_key strings.
merge_results/2 simplified — dead %Orchid.Param{} branch removed.

:hooks lifecycle callbacks from Config. Oi intentionally defers step-level concerns to Orchid's hook system via :orchid_opts.
resolve_from_intervention/2 in Worker. Intervention injection now happens at Drafting construction time, not per-bundle.

Intervention priority: interventions now override drafting memory (were previously ignored when a drafting key already existed).

Oi.compile/1 (taking Workspace) replaced by Oi.compile/2 (taking graph, cluster)
Oi.dispatch/2 replaced by Oi.execute/2 (taking Compiled.t())
Oi.Workspace struct removed
Oi.Compiler.RecipeBundle renamed to Oi.Compile.Bundle
Oi.Workspace.Planning renamed to Oi.Compile.Planning
Oi.Configurator renamed to Oi.Dispatch.Config
Oi.Dispatcher renamed to Oi.Dispatch.Orchestrator
Oi.Drafting renamed to Oi.Dispatch.Drafting
Oi.Worker renamed to Oi.Dispatch.Worker
Oi.Session / Oi.Registry moved to Oi.Runtime.*

Oi.Compiled struct — static compilation product (bundles + plan)
Oi.Result struct — execution result with memory and reify/2
:inputs option for Oi.execute/2 — external inputs seeded into drafting memory
Oi.run/2 convenience — compiles + executes in one call
Worker.resolve_dependencies returns explicit {:error, {:missing_input, key}}

RecipeBundle.interventions field removed — interventions moved to Dispatch.Config
Compiler.bind/2 removed — Worker filters interventions from config at runtime
Drafting.memory unified to store Orchid.Param.t() throughout (no payload extraction)
Planning.build no longer called twice (compile once, reuse plan in execute)
Drafting nil filtering commented out (pending review)