diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
index b908b557..02960c4e 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -16,6 +16,13 @@
         "dotnet-script"
       ],
       "rollForward": false
+    },
+    "docfx": {
+      "version": "2.78.5",
+      "commands": [
+        "docfx"
+      ],
+      "rollForward": false
     }
   }
 }
\ No newline at end of file
diff --git a/.vscode/flowthru.code-snippets b/.vscode/flowthru.code-snippets
index 1354eadf..59afcb87 100644
--- a/.vscode/flowthru.code-snippets
+++ b/.vscode/flowthru.code-snippets
@@ -10,16 +10,16 @@
 		"scope": "csharp",
 		"prefix": "_pipeline",
 		"body": [
-			"using Flowthru.Pipelines;",
+			"using Flowthru.Flows;",
 			"using $1",
 			"",
 			"public static class ${RELATIVE_FILEPATH/.*?(\\w+).cs$/$1/}",
 			"{",
 			"  public static Pipeline Create(Catalog catalog)",
 			"  {",
-			"    return PipelineBuilder.CreatePipeline(pipeline =>",
+			"    return FlowBuilder.CreateFlow(pipeline =>",
 			"    {",
-			"      pipeline.AddNode(",
+			"      pipeline.AddStep(",
 			"        label: \"$2\",",
 			"        description: \"\"\"",
 			"          $3",
@@ -34,7 +34,7 @@
 		],
 		"description": "Creates a basic Flowthru pipeline structure."
 	},
-	"FlowthruNode": {
+	"FlowthruStep": {
 		"scope": "csharp",
 		"prefix": "_node",
 		"body": [
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 4f84f98b..d4293e5b 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -74,8 +74,8 @@ Flowthru handles these through an **effect type** called `FlowIO<T>`. If you're
 The key runtime guarantees:
 
 - **All I/O is lazy and explicit.** Side effects cannot be accidentally dropped or silently ignored.
-- **Errors are captured, never swallowed.** Node failures propagate to structured pipeline results. Silent `catch {}` blocks are a bug.
-- **Nodes are isolated.** A failing node halts execution and reports which node failed and why — partial silent failures are not possible.
+- **Errors are captured, never swallowed.** Step failures propagate to structured pipeline results. Silent `catch {}` blocks are a bug.
+- **Steps are isolated.** A failing node halts execution and reports which node failed and why — partial silent failures are not possible.
 
 ## Decision Rules for Contributors
 
diff --git a/Directory.Build.props b/Directory.Build.props
index ae821490..b57dec72 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -16,6 +16,11 @@
     <RestorePackagesWithLockFile>false</RestorePackagesWithLockFile>
   </PropertyGroup>
   
+  <!-- Generate XML documentation for src/ projects (consumed by DocFX) -->
+  <PropertyGroup Condition="$(MSBuildProjectDirectory.Contains('src'))">
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+  </PropertyGroup>
+
   <!-- Centralized NuGet package configuration for all src/ projects -->
   <PropertyGroup Condition="$(MSBuildProjectDirectory.Contains('src'))">
     <Version>0.1.33</Version>
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
index 9d82936b..5c144be5 100644
--- a/docs/CONTRIBUTING.md
+++ b/docs/CONTRIBUTING.md
@@ -27,7 +27,7 @@ Consider these examples:
 - **"How do I start writing my first pipeline?"** → This is someone learning. They need a tutorial.
 - **"How can I read data from a database instead of local files?"** → This is someone working with a specific need. They need a guide.
 - **"Why does Flowthru use so many types?"** → This is someone studying the framework's design. They need an explanation.
-- **"What parameters does `CatalogEntry` accept?"** → This is someone looking up technical details. They need reference documentation.
+- **"What parameters does `Item` accept?"** → This is someone looking up technical details. They need reference documentation.
 
 The same topic can yield different documentation depending on the question:
 
@@ -156,7 +156,7 @@ Let's say you want to document "catalog entries." Start by listing questions:
 - "How do I create my first catalog entry?" → Tutorial
 - "How do I configure a catalog entry for Parquet files?" → Guide
 - "Why are catalog entries properties rather than string keys?" → Explanation
-- "What methods are available on `ICatalogEntry<T>`?" → Reference
+- "What methods are available on `IItem<T>`?" → Reference
 
 Each question becomes a separate piece of documentation in its appropriate category. Together, they serve users at every stage of their journey with catalog entries.
 
diff --git a/docs/explanation/advanced/storage-composition.md b/docs/explanation/advanced/storage-composition.md
index 0979521a..be92b825 100644
--- a/docs/explanation/advanced/storage-composition.md
+++ b/docs/explanation/advanced/storage-composition.md
@@ -140,11 +140,11 @@ public class EFCoreStorageAdapter<T> : IStorageAdapter<IEnumerable<T>>
 
 ## Catalog-Level Constraint Narrowing
 
-After adapter creation, pipeline authors can further constrain catalog entries using `CatalogEntry<T>.Constrain()`:
+After adapter creation, pipeline authors can further constrain catalog entries using `Item<T>.Constrain()`:
 
 ```csharp
-public ICatalogEntry<IEnumerable<Company>> Companies => GetOrCreateEntry(() =>
-    CatalogEntries.Enumerable.Csv<Company>("companies", "data/companies.csv")
+public IItem<IEnumerable<Company>> Companies => GetOrCreateEntry(() =>
+    ItemFactory.Enumerable.Csv<Company>("companies", "data/companies.csv")
         .Constrain(traits => traits with { CanWrite = false })
 );
 ```
@@ -201,7 +201,7 @@ The trait system solves all three:
 
 - **Composable**: Eight independent boolean flags
 - **Queryable**: `adapter.Traits.CanWrite` checked before operation
-- **Fail-fast**: `CatalogEntry.Constrain()` validates at initialization
+- **Fail-fast**: `Item.Constrain()` validates at initialization
 
 The old interfaces remain as `[Obsolete]` for backward compatibility but have no effect on pipeline behavior.
 
@@ -211,9 +211,9 @@ The storage architecture is implemented in:
 
 - `src/core/Flowthru/Data/Capabilities/StorageTraits.cs` — the trait record
 - `src/core/Flowthru/Data/Storage/ComposedStorageAdapter.cs` — trait merging logic
-- `src/core/Flowthru/Data/CatalogEntry.cs` — `Constrain()` with ratchet validation
+- `src/core/Flowthru/Data/Item.cs` — `Constrain()` with ratchet validation
 - `src/core/Flowthru/Data/Storage/Medium/` — medium implementations with traits
 - `src/core/Flowthru/Data/Storage/Format/` — format serializers with traits
 
-Catalog entry factories (`CatalogEntries.Enumerable.Csv<T>(...)`) construct composed adapters with sensible defaults. Extension authors creating custom adapters should declare traits that accurately reflect their capabilities.
+Catalog entry factories (`ItemFactory.Enumerable.Csv<T>(...)`) construct composed adapters with sensible defaults. Extension authors creating custom adapters should declare traits that accurately reflect their capabilities.
 
diff --git a/docs/explanation/anatomy-of-a-pipeline.md b/docs/explanation/anatomy-of-a-pipeline.md
index ce07a87b..2f197142 100644
--- a/docs/explanation/anatomy-of-a-pipeline.md
+++ b/docs/explanation/anatomy-of-a-pipeline.md
@@ -75,9 +75,9 @@ In this example:
 // Data/_01_Raw/Catalog.Raw.cs
 public partial class Catalog
 {
-  public ICatalogEntry<IEnumerable<IrisRawSchema>> IrisRaw =>
+  public IItem<IEnumerable<IrisRawSchema>> IrisRaw =>
     GetOrCreateEntry(() =>
-      CatalogEntries.Enumerable.Csv<IrisRawSchema>(
+      ItemFactory.Enumerable.Csv<IrisRawSchema>(
         label: "IrisRaw",
         filePath: $"{_basePath}/_01_Raw/Datasets/iris.csv"
       )
@@ -95,9 +95,9 @@ In this example:
 // Data/_04_Feature/Catalog.Feature.cs
 public partial class Catalog
 {
-  public ICatalogEntry<IEnumerable<IrisFeatureSchema>> IrisFeatures =>
+  public IItem<IEnumerable<IrisFeatureSchema>> IrisFeatures =>
     GetOrCreateEntry(() =>
-      CatalogEntries.Enumerable.Parquet<IrisFeatureSchema>(
+      ItemFactory.Enumerable.Parquet<IrisFeatureSchema>(
         label: "IrisFeatures",
         filePath: $"{_basePath}/_04_Feature/Datasets/iris_features.parquet"
       )
@@ -169,13 +169,13 @@ Pipelines are made up of **nodes** — transformation functions that are built t
 
 1. When writing a node, you don't need to worry about how it's connecting to other nodes — you just need to make sure it inputs the schema, and outputs  the schema
 
-### Nodes
+### Steps
 
-Nodes are simply functions. Easy! The **only** purpose of a node is to take in data that has one schema, and convert it to data that has another schema.
+Steps are simply functions. Easy! The **only** purpose of a node is to take in data that has one schema, and convert it to data that has another schema.
 
 ```csharp
-// Pipelines/DataEngineering/Nodes/SplitAndEncodeNode.cs
-public static class SplitAndEncodeNode
+// Pipelines/DataEngineering/Steps/SplitAndEncodeStep.cs
+public static class SplitAndEncodeStep
 {
   public static Func<
     IEnumerable<IrisRawSchema>, // Input Schema
@@ -194,8 +194,8 @@ public static class SplitAndEncodeNode
 
 Key points:
 
-- Nodes are a *contract*: that data for the node will **always** come in as the input schemas, and **always** come out as the output schemas.
-- Nodes can have any number of inputs, and any number of outputs — as long as they're defined in the input and output schemas, you're not limited to just one-in, one-out.
+- Steps are a *contract*: that data for the node will **always** come in as the input schemas, and **always** come out as the output schemas.
+- Steps can have any number of inputs, and any number of outputs — as long as they're defined in the input and output schemas, you're not limited to just one-in, one-out.
 
 
 ### Pipelines
@@ -214,11 +214,11 @@ public static class DataEngineeringPipeline
 {
   public static Pipeline Create(Catalog catalog, Params parameters)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "SplitAndEncode", // Unique label for this node in the pipeline
-        transform: SplitAndEncodeNode.Create(),
+        transform: SplitAndEncodeStep.Create(),
         input: catalog.IrisRaw,
         output: catalog.IrisFeatures
       );
@@ -229,7 +229,7 @@ public static class DataEngineeringPipeline
 
 Key points:
 
-- **Nodes are never directly connected to each other**: Nodes always take in Catalog entries, and output Catalog entries — *never* directly to each other.
+- **Steps are never directly connected to each other**: Steps always take in Catalog entries, and output Catalog entries — *never* directly to each other.
 - **Order doesn't matter.** A node in the pipeline is **only** ever concerned about its input data and output data. Flowthru handles the order when you run the pipeline: as long as the data is available, or generated by another node, your pipeline will run.
 
 ## Entry Point
@@ -241,7 +241,7 @@ private static void ConfigureServices(IServiceCollection services, string basePa
 {
     services.AddFlowthru(flowthru =>
     {
-        flowthru.UseCatalog(_ => new Catalog(basePath: "Data")));
+        flowthru.RegisterCatalog(_ => new Catalog(basePath: "Data")));
 
         flowthru.RegisterPipeline<Catalog>(
             label: "DataEngineering",
@@ -256,4 +256,4 @@ private static void ConfigureServices(IServiceCollection services, string basePa
 }
 ```
 
-And that's it! This finishes the pipeline anatomy. At this point, you have Catalog entries, connected with Nodes in your Pipelines — everything you need to find new and creative ways to organize, analyze, and report on your data!
+And that's it! This finishes the pipeline anatomy. At this point, you have Catalog entries, connected with Steps in your Pipelines — everything you need to find new and creative ways to organize, analyze, and report on your data!
diff --git a/docs/guides/advanced/container-deployment.md b/docs/guides/advanced/container-deployment.md
index 730615e5..0dcf9c75 100644
--- a/docs/guides/advanced/container-deployment.md
+++ b/docs/guides/advanced/container-deployment.md
@@ -13,7 +13,7 @@ Deploy a Flowthru pipeline as a standalone container image for execution in envi
 A containerized pipeline replaces `FlowthruCli` with a minimal `Program.cs` that owns its own DI container. The key difference: no CLI argument parsing, no filesystem-based configuration.
 
 ```csharp
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using Flowthru.Services;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Logging;
@@ -26,7 +26,7 @@ services.AddLogging(logging =>
 services.AddFlowthru(flowthru =>
 {
     flowthru
-        .UseCatalog<MyCatalog>()
+        .RegisterCatalog<MyCatalog>()
         .RegisterPipeline<MyCatalog>("Ingest", catalog => IngestPipeline.Create(catalog))
         .RegisterPipeline<MyCatalog>("Transform", catalog => TransformPipeline.Create(catalog));
 
@@ -50,19 +50,19 @@ return result.Success ? 0 : 1;
 
 // --- helpers ---
 
-static PipelineSliceStrategy BuildSliceStrategy()
+static FlowSliceStrategy BuildSliceStrategy()
 {
     static HashSet<string>? ParseCsv(string? value) =>
         string.IsNullOrWhiteSpace(value) ? null : new(value.Split(',', StringSplitOptions.RemoveEmptyEntries));
 
-    return new PipelineSliceStrategy
+    return new FlowSliceStrategy
     {
         Pipelines  = ParseCsv(Environment.GetEnvironmentVariable("FLOWTHRU_PIPELINES")),
-        FromNodes  = ParseCsv(Environment.GetEnvironmentVariable("FLOWTHRU_FROM_NODES")),
-        ToNodes    = ParseCsv(Environment.GetEnvironmentVariable("FLOWTHRU_TO_NODES")),
+        FromSteps  = ParseCsv(Environment.GetEnvironmentVariable("FLOWTHRU_FROM_NODES")),
+        ToSteps    = ParseCsv(Environment.GetEnvironmentVariable("FLOWTHRU_TO_NODES")),
         FromData   = ParseCsv(Environment.GetEnvironmentVariable("FLOWTHRU_FROM_DATA")),
         ToData     = ParseCsv(Environment.GetEnvironmentVariable("FLOWTHRU_TO_DATA")),
-        OnlyNodes  = ParseCsv(Environment.GetEnvironmentVariable("FLOWTHRU_ONLY_NODES")),
+        OnlySteps  = ParseCsv(Environment.GetEnvironmentVariable("FLOWTHRU_ONLY_NODES")),
     };
 }
 ```
@@ -87,7 +87,7 @@ services.AddFlowthru(flowthru =>
 {
     // No UseConfiguration() call — the IConfiguration above is already registered
     flowthru
-        .UseCatalog<MyCatalog>()
+        .RegisterCatalog<MyCatalog>()
         .RegisterPipeline<MyCatalog>("Ingest", catalog => IngestPipeline.Create(catalog));
 });
 ```
@@ -152,7 +152,7 @@ docker run \
 
 ## Inspecting Results
 
-`ExecutePipelineAsync` returns a `PipelineResult` — a structured value object with `Success`, `ExecutionTime`, per-node `NodeResults` (including individual timing, I/O counts, and exceptions), and an optional top-level `Exception`. Serialize it to structured output for your runtime's observability:
+`ExecutePipelineAsync` returns a `FlowResult` — a structured value object with `Success`, `ExecutionTime`, per-node `StepResults` (including individual timing, I/O counts, and exceptions), and an optional top-level `Exception`. Serialize it to structured output for your runtime's observability:
 
 ```csharp
 var result = await flowthru.ExecutePipelineAsync(options, cancellationToken: cts.Token);
@@ -163,9 +163,9 @@ if (!result.Success)
         result.ExecutionTime.TotalSeconds,
         result.Exception?.Message);
 
-    foreach (var (name, node) in result.NodeResults.Where(n => !n.Value.Success))
+    foreach (var (name, node) in result.StepResults.Where(n => !n.Value.Success))
     {
-        logger.LogError("  Node {Node} failed: {Error}", name, node.Exception?.Message);
+        logger.LogError("  Step {Step} failed: {Error}", name, node.Exception?.Message);
     }
 }
 ```
diff --git a/docs/guides/advanced/metadata-providers.md b/docs/guides/advanced/metadata-providers.md
index 817a0cd7..67896dbe 100644
--- a/docs/guides/advanced/metadata-providers.md
+++ b/docs/guides/advanced/metadata-providers.md
@@ -40,8 +40,8 @@ public class DashboardMetadataProvider : IMetadataProvider
     {
         var payload = new
         {
-            PipelineName = dag.PipelineName,
-            NodeCount = dag.Nodes.Count,
+            FlowName = dag.FlowName,
+            StepCount = dag.Steps.Count,
             EdgeCount = dag.Edges.Count,
             Timestamp = DateTime.UtcNow
         };
@@ -85,14 +85,14 @@ using Flowthru.Meta.Providers;
 
 services.AddFlowthru(flowthru =>
 {
-    flowthru.UseCatalog(_ => new MyCatalog());
-    flowthru.UsePipelines(_ => myPipelines);
+    flowthru.RegisterCatalog(_ => new MyCatalog());
+    flowthru.RegisterPipelines(_ => myPipelines);
     
     flowthru.ConfigureMetadata(meta =>
     {
         meta.AddProvider<JsonMetadataProvider, JsonMetadataProviderBuilder>(json => json
             .WithOutputDirectory("metadata")
-            .WithFilenameTemplate("dag-{PipelineName}-{Timestamp}")
+            .WithFilenameTemplate("dag-{FlowName}-{Timestamp}")
             .WithTimestamp("yyyyMMdd-HHmmss")
             .UseCompactFormat());
             
@@ -143,9 +143,9 @@ var singlePipelineDag = service.GetDagMetadata(pipelineName: "DataEngineering");
 
 // Get DAG with slicing applied
 var slicedDag = service.GetDagMetadata(
-    sliceStrategy: new PipelineSliceStrategy
+    sliceStrategy: new FlowSliceStrategy
     {
-        ToNodes = new HashSet<string> { "TransformNode" }
+        ToSteps = new HashSet<string> { "TransformStep" }
     }
 );
 ```
@@ -159,7 +159,7 @@ Useful for tooling, tests, or debugging pipeline structure before execution.
 ```csharp
 meta.AddProvider<JsonMetadataProvider, JsonMetadataProviderBuilder>(json => json
     .WithOutputDirectory("metadata")
-    .WithFilenameTemplate("dag-{PipelineName}-{Timestamp}")
+    .WithFilenameTemplate("dag-{FlowName}-{Timestamp}")
     .WithTimestamp("yyyyMMdd-HHmmss")
     .UseCompactFormat());
 ```
@@ -170,6 +170,6 @@ meta.AddProvider<JsonMetadataProvider, JsonMetadataProviderBuilder>(json => json
 meta.AddProvider<MermaidMetadataProvider, MermaidMetadataProviderBuilder>(mermaid => mermaid
     .WithOutputDirectory("metadata")
     .WithDirection(MermaidFlowchartDirection.LeftToRight)
-    .WithActiveNodeColor("#90EE90")
+    .WithActiveStepColor("#90EE90")
     .WithActiveDataColor("#ADD8E6"));
 ```
diff --git a/docs/guides/advanced/service-integration.md b/docs/guides/advanced/service-integration.md
index 9162654d..757e5826 100644
--- a/docs/guides/advanced/service-integration.md
+++ b/docs/guides/advanced/service-integration.md
@@ -18,7 +18,7 @@ var builder = WebApplication.CreateBuilder(args);
 builder.Services.AddFlowthru(flowthru =>
 {
     flowthru
-        .UseCatalog<WarehouseCatalog>()
+        .RegisterCatalog<WarehouseCatalog>()
         .RegisterPipeline<WarehouseCatalog>("Ingest", c => IngestPipeline.Create(c))
         .RegisterPipeline<WarehouseCatalog>("Transform", c => TransformPipeline.Create(c))
         .UseStorageStrategy<DatabaseStorageStrategy>();
@@ -42,7 +42,7 @@ var myParams = builder.Configuration
 builder.Services.AddFlowthru(flowthru =>
 {
     flowthru
-        .UseCatalog<WarehouseCatalog>()
+        .RegisterCatalog<WarehouseCatalog>()
         .RegisterPipeline<WarehouseCatalog, TransformParams>(
             "Transform",
             (catalog, p) => TransformPipeline.Create(catalog, p),
@@ -57,7 +57,7 @@ builder.Services.AddFlowthru(flowthru =>
 {
     flowthru
         .UseConfiguration(opts => opts.BasePath = "/app/pipeline-config")
-        .UseCatalog<WarehouseCatalog>()
+        .RegisterCatalog<WarehouseCatalog>()
         .RegisterPipelineWithConfiguration<WarehouseCatalog, TransformParams>(
             "Transform",
             (catalog, p) => TransformPipeline.Create(catalog, p),
@@ -79,7 +79,7 @@ app.MapPost("/pipelines/run", async (
 {
     var options = new ExecutionOptions
     {
-        SliceStrategy = new PipelineSliceStrategy
+        SliceStrategy = new FlowSliceStrategy
         {
             Pipelines = request.Pipelines is { Count: > 0 }
                 ? request.Pipelines.ToHashSet()
@@ -115,25 +115,25 @@ public record PipelineRunRequest
     public List<string>? Pipelines { get; init; }
     public List<string>? ToData { get; init; }
     public List<string>? FromData { get; init; }
-    public List<string>? OnlyNodes { get; init; }
+    public List<string>? OnlySteps { get; init; }
 }
 ```
 
-`PipelineSliceStrategy` properties are `IReadOnlySet<string>?` — convert from lists at the boundary.
+`FlowSliceStrategy` properties are `IReadOnlySet<string>?` — convert from lists at the boundary.
 
 ## Handling Results
 
-`PipelineResult` carries structured execution data. Map it to your application's response model rather than returning it directly:
+`FlowResult` carries structured execution data. Map it to your application's response model rather than returning it directly:
 
 ```csharp
-static PipelineRunResponse MapToResponse(PipelineResult result)
+static PipelineRunResponse MapToResponse(FlowResult result)
 {
     return new PipelineRunResponse
     {
         Success = result.Success,
         DurationMs = result.ExecutionTime.TotalMilliseconds,
-        NodesExecuted = result.NodeResults.Count,
-        NodeSummaries = result.NodeResults.Select(kvp => new NodeSummary
+        StepsExecuted = result.StepResults.Count,
+        StepSummaries = result.StepResults.Select(kvp => new StepSummary
         {
             Name = kvp.Key,
             Success = kvp.Value.Success,
@@ -168,8 +168,8 @@ public class PipelineBackgroundService : BackgroundService
         if (result.Success)
         {
             _logger.LogInformation(
-                "Pipeline completed: {NodeCount} nodes in {Duration}s",
-                result.NodeResults.Count,
+                "Pipeline completed: {StepCount} nodes in {Duration}s",
+                result.StepResults.Count,
                 result.ExecutionTime.TotalSeconds);
         }
         else
diff --git a/docs/guides/constraining-catalog-entries.md b/docs/guides/constraining-catalog-entries.md
index 4e08eec3..427749a8 100644
--- a/docs/guides/constraining-catalog-entries.md
+++ b/docs/guides/constraining-catalog-entries.md
@@ -22,8 +22,8 @@ Call `.Constrain()` on any catalog entry to narrow its capabilities:
 ```csharp
 public class DataCatalog : DataCatalogBase
 {
-    public ICatalogEntry<IEnumerable<Company>> Companies => GetOrCreateEntry(() =>
-        CatalogEntries.Enumerable.Csv<Company>("companies", "data/companies.csv")
+    public IItem<IEnumerable<Company>> Companies => GetOrCreateEntry(() =>
+        ItemFactory.Enumerable.Csv<Company>("companies", "data/companies.csv")
             .Constrain(traits => traits with { CanWrite = false })
     );
 }
@@ -39,20 +39,20 @@ Mark external data sources as read-only to prevent accidental modifications:
 
 ```csharp
 // API endpoint that only supports GET requests
-public ICatalogEntry<WeatherData> WeatherFeed => GetOrCreateEntry(() =>
-    CatalogEntries.Single.Http<WeatherData>("weather", "https://api.weather.com/current")
+public IItem<WeatherData> WeatherFeed => GetOrCreateEntry(() =>
+    ItemFactory.Single.Http<WeatherData>("weather", "https://api.weather.com/current")
         .Constrain(traits => traits with { CanWrite = false })
 );
 
 // Production database view used for reporting
-public ICatalogEntry<IEnumerable<SalesRecord>> ProductionSales => GetOrCreateEntry(() =>
-    CatalogEntries.Enumerable.EFCore<SalesRecord>("sales", dbContext)
+public IItem<IEnumerable<SalesRecord>> ProductionSales => GetOrCreateEntry(() =>
+    ItemFactory.Enumerable.EFCore<SalesRecord>("sales", dbContext)
         .Constrain(traits => traits with { CanWrite = false })
 );
 
 // Archived historical data that must not change
-public ICatalogEntry<IEnumerable<Transaction>> HistoricalTransactions => GetOrCreateEntry(() =>
-    CatalogEntries.Enumerable.Parquet<Transaction>("archive", "data/2024/transactions.parquet")
+public IItem<IEnumerable<Transaction>> HistoricalTransactions => GetOrCreateEntry(() =>
+    ItemFactory.Enumerable.Parquet<Transaction>("archive", "data/2024/transactions.parquet")
         .Constrain(traits => traits with { CanWrite = false })
 );
 ```
@@ -62,8 +62,8 @@ public ICatalogEntry<IEnumerable<Transaction>> HistoricalTransactions => GetOrCr
 Mark catalog entries that require network connectivity to prevent offline execution attempts:
 
 ```csharp
-public ICatalogEntry<IEnumerable<User>> RemoteUsers => GetOrCreateEntry(() =>
-    CatalogEntries.Enumerable.Http<User>("users", "https://internal.api/users")
+public IItem<IEnumerable<User>> RemoteUsers => GetOrCreateEntry(() =>
+    ItemFactory.Enumerable.Http<User>("users", "https://internal.api/users")
         .Constrain(traits => traits with 
         { 
             RequiresNetwork = true,
@@ -77,8 +77,8 @@ public ICatalogEntry<IEnumerable<User>> RemoteUsers => GetOrCreateEntry(() =>
 Mark in-memory or cache-based entries as non-persistent:
 
 ```csharp
-public ICatalogEntry<ProcessedData> Cache => GetOrCreateEntry(() =>
-    CatalogEntries.Single.Memory<ProcessedData>("cache")
+public IItem<ProcessedData> Cache => GetOrCreateEntry(() =>
+    ItemFactory.Single.Memory<ProcessedData>("cache")
     // Memory adapter already sets IsPersistent = false
 );
 ```
@@ -89,7 +89,7 @@ If you try to use a constrained entry incorrectly, the pipeline fails during con
 
 ```csharp
 // ❌ This fails at pipeline.Build() — before any data is processed
-pipeline.AddNode(
+pipeline.AddStep(
     name: "WriteToReadOnly",
     transform: node,
     input: catalog.InputData,
@@ -125,8 +125,8 @@ Attempts to relax constraints throw `InvalidOperationException` with a detailed
 Apply multiple constraints in a single call:
 
 ```csharp
-public ICatalogEntry<IEnumerable<AuditLog>> AuditLogs => GetOrCreateEntry(() =>
-    CatalogEntries.Enumerable.Csv<AuditLog>("audit", "logs/audit.csv")
+public IItem<IEnumerable<AuditLog>> AuditLogs => GetOrCreateEntry(() =>
+    ItemFactory.Enumerable.Csv<AuditLog>("audit", "logs/audit.csv")
         .Constrain(traits => traits with 
         { 
             CanWrite = false,
@@ -139,8 +139,8 @@ public ICatalogEntry<IEnumerable<AuditLog>> AuditLogs => GetOrCreateEntry(() =>
 Or chain multiple constraints for readability:
 
 ```csharp
-public ICatalogEntry<IEnumerable<Customer>> Customers => GetOrCreateEntry(() =>
-    CatalogEntries.Enumerable.Csv<Customer>("customers", "data/customers.csv")
+public IItem<IEnumerable<Customer>> Customers => GetOrCreateEntry(() =>
+    ItemFactory.Enumerable.Csv<Customer>("customers", "data/customers.csv")
         .Constrain(traits => traits with { CanWrite = false })
         .Constrain(traits => traits with { RequiresNetwork = false })
 );
@@ -170,13 +170,13 @@ Default values represent **filesystem-file** semantics — the common case for l
 Prevent pipelines from modifying reference data used across multiple projects:
 
 ```csharp
-public ICatalogEntry<IEnumerable<Country>> Countries => GetOrCreateEntry(() =>
-    CatalogEntries.Enumerable.Csv<Country>("countries", "reference/countries.csv")
+public IItem<IEnumerable<Country>> Countries => GetOrCreateEntry(() =>
+    ItemFactory.Enumerable.Csv<Country>("countries", "reference/countries.csv")
         .Constrain(traits => traits with { CanWrite = false })
 );
 
-public ICatalogEntry<IEnumerable<Currency>> Currencies => GetOrCreateEntry(() =>
-    CatalogEntries.Enumerable.Json<Currency>("currencies", "reference/currencies.json")
+public IItem<IEnumerable<Currency>> Currencies => GetOrCreateEntry(() =>
+    ItemFactory.Enumerable.Json<Currency>("currencies", "reference/currencies.json")
         .Constrain(traits => traits with { CanWrite = false })
 );
 ```
@@ -186,9 +186,9 @@ public ICatalogEntry<IEnumerable<Currency>> Currencies => GetOrCreateEntry(() =>
 Use configuration to apply different constraints in different environments:
 
 ```csharp
-public ICatalogEntry<IEnumerable<Order>> Orders => GetOrCreateEntry(() =>
+public IItem<IEnumerable<Order>> Orders => GetOrCreateEntry(() =>
 {
-    var entry = CatalogEntries.Enumerable.EFCore<Order>("orders", dbContext, readOnly: false);
+    var entry = ItemFactory.Enumerable.EFCore<Order>("orders", dbContext, readOnly: false);
     
     // In production, make orders read-only for reporting pipelines
     if (_environment.IsProduction)
@@ -206,13 +206,13 @@ In multi-stage pipelines where early stages produce data for later stages, preve
 
 ```csharp
 // Stage 1: Data ingestion (writes allowed)
-public ICatalogEntry<IEnumerable<RawData>> RawData => GetOrCreateEntry(() =>
-    CatalogEntries.Enumerable.Csv<RawData>("raw", "data/raw.csv")
+public IItem<IEnumerable<RawData>> RawData => GetOrCreateEntry(() =>
+    ItemFactory.Enumerable.Csv<RawData>("raw", "data/raw.csv")
 );
 
 // Stage 2: Used as read-only input to transformations
-public ICatalogEntry<IEnumerable<RawData>> RawDataReadOnly => GetOrCreateEntry(() =>
-    CatalogEntries.Enumerable.Csv<RawData>("raw_readonly", "data/raw.csv")
+public IItem<IEnumerable<RawData>> RawDataReadOnly => GetOrCreateEntry(() =>
+    ItemFactory.Enumerable.Csv<RawData>("raw_readonly", "data/raw.csv")
         .Constrain(traits => traits with { CanWrite = false })
 );
 ```
diff --git a/docs/guides/misc/AGENTS.md b/docs/guides/misc/AGENTS.md
index 40a61b43..9b205757 100644
--- a/docs/guides/misc/AGENTS.md
+++ b/docs/guides/misc/AGENTS.md
@@ -26,9 +26,9 @@ Data/                               # Everything related to data definitions
 └── _08_Reporting/                  # Descriptive and summary outputs for business consumption
 
 Pipelines/                          # All pipelines
-└── <PipelineName>/
-    ├── <PipelineName>Pipeline.cs   # Nodes wired to input/output catalog entries
-    └── Nodes/
+└── <FlowName>/
+    ├── <FlowName>Pipeline.cs   # Steps wired to input/output catalog entries
+    └── Steps/
         └── *.cs                    # Individual transformation nodes
 ```
 
@@ -49,7 +49,7 @@ Follow these steps in order:
 2. **Plan intermediate schemas.** Identify what data shapes are needed between each transformation step.
 3. **Write schemas.** Create schema classes for input, output, and all intermediary data in the appropriate `Data/<Layer>/Schemas/` directories.
 4. **Create catalog entries.** Add catalog entries for each schema in the corresponding `Catalog.<Layer>.cs` file. Each entry declares its schema type and storage strategy.
-5. **Write nodes.** Implement the transformation logic in `Pipelines/<PipelineName>/Nodes/`. Each node declares typed inputs and outputs matching the schemas from step 3.
-6. **Wire the pipeline.** Connect nodes to their catalog entries in `Pipelines/<PipelineName>/<PipelineName>Pipeline.cs`.
+5. **Write nodes.** Implement the transformation logic in `Pipelines/<FlowName>/Steps/`. Each node declares typed inputs and outputs matching the schemas from step 3.
+6. **Wire the pipeline.** Connect nodes to their catalog entries in `Pipelines/<FlowName>/<FlowName>Pipeline.cs`.
 7. **Register the pipeline.** Add the pipeline to `Program.cs` so the CLI runner can discover it.
 8. **Run and confirm.** Execute the pipeline with `dotnet run` and verify the output.
diff --git a/docs/guides/slicing-pipelines.md b/docs/guides/slicing-pipelines.md
index 3eaddb45..6e8648d2 100644
--- a/docs/guides/slicing-pipelines.md
+++ b/docs/guides/slicing-pipelines.md
@@ -100,11 +100,11 @@ using Flowthru.Services.Models;
 
 var options = new ExecutionOptions
 {
-    SliceStrategy = new PipelineSliceStrategy
+    SliceStrategy = new FlowSliceStrategy
     {
         Pipelines = new HashSet<string> { "DataScience" },
-        FromNodes = new HashSet<string> { "PreprocessCompanies", "PreprocessShuttles" },
-        ToNodes = new HashSet<string> { "CreateModelInput" }
+        FromSteps = new HashSet<string> { "PreprocessCompanies", "PreprocessShuttles" },
+        ToSteps = new HashSet<string> { "CreateModelInput" }
     }
 };
 
@@ -114,14 +114,14 @@ var result = await service.ExecutePipelineAsync(options, exportMetadata: true, m
 ### All Strategy Properties
 
 ```csharp
-var strategy = new PipelineSliceStrategy
+var strategy = new FlowSliceStrategy
 {
     Pipelines = new HashSet<string> { "DataScience", "Reporting" },  // filter by pipeline name
-    FromNodes = new HashSet<string> { "NodeA", "NodeB" },            // + upstream
-    ToNodes = new HashSet<string> { "NodeC" },                       // + downstream
+    FromSteps = new HashSet<string> { "StepA", "StepB" },            // + upstream
+    ToSteps = new HashSet<string> { "StepC" },                       // + downstream
     FromData = new HashSet<string> { "model_input" },                // consumers + downstream
     ToData = new HashSet<string> { "raw_data" },                     // producers + upstream
-    OnlyNodes = new HashSet<string> { "NodeD", "NodeE" }             // explicit allowlist
+    OnlySteps = new HashSet<string> { "StepD", "StepE" }             // explicit allowlist
 };
 ```
 
@@ -135,12 +135,12 @@ var options = new ExecutionOptions(); // No slicing, all pipelines execute
 
 Slicing guarantees runnability — the result is always a valid sub-DAG:
 
-1. **Pipelines** filters nodes by pipeline name prefix (e.g., "DataScience.NodeName")
-2. **FromNodes** includes all upstream dependencies (transitive closure)
-3. **ToNodes** includes all downstream dependents (transitive closure)
+1. **Pipelines** filters nodes by pipeline name prefix (e.g., "DataScience.StepName")
+2. **FromSteps** includes all upstream dependencies (transitive closure)
+3. **ToSteps** includes all downstream dependents (transitive closure)
 4. **FromData** resolves to consumer nodes, then includes downstream (transitive closure)
 5. **ToData** resolves to producer nodes, then includes upstream (transitive closure)
-6. **OnlyNodes** automatically includes required dependencies
+6. **OnlySteps** automatically includes required dependencies
 7. Multiple strategies intersect — each narrows the result set
 
 **Slicing is additive only.** There is no `--except` flag because subtractive operations break the runnability guarantee.
@@ -169,7 +169,7 @@ Available pipelines: DataScience, DataProcessing, Reporting
 ```
 
 ```
-✗ FromNodes references non-existent node: 'InvalidNode'
+✗ FromSteps references non-existent node: 'InvalidStep'
 Available nodes: PreprocessCompanies, PreprocessShuttles, ...
 ```
 
diff --git a/docs/guides/using-efcore-catalog-entries.md b/docs/guides/using-efcore-catalog-entries.md
index 38e2e31d..34b33790 100644
--- a/docs/guides/using-efcore-catalog-entries.md
+++ b/docs/guides/using-efcore-catalog-entries.md
@@ -8,7 +8,7 @@ This guide is for teams who already have a working Flowthru pipeline backed by f
 dotnet add package Flowthru.Extensions.EFCore
 ```
 
-This package provides `EFCoreCatalogEntries`, the primary namespace for creating EFCore-backed catalog entries.
+This package provides `EFCoreItemFactory`, the primary namespace for creating EFCore-backed catalog entries.
 
 ## What your schemas need
 
@@ -87,7 +87,7 @@ Wire the factory from your DI container:
 
 ```csharp
 // Program.cs
-flowthru.UseCatalog(sp => new Catalog(
+flowthru.RegisterCatalog(sp => new Catalog(
     basePath: Path.Combine(basePath, "Data"),
     contextFactory: sp.GetRequiredService<IDbContextFactory<AppDbContext>>()
 ));
@@ -103,9 +103,9 @@ using Flowthru.Extensions.EFCore.Data;
 
 public partial class Catalog
 {
-    public ICatalogEntry<IEnumerable<PreprocessedCompany>> PreprocessedCompanies =>
+    public IItem<IEnumerable<PreprocessedCompany>> PreprocessedCompanies =>
         GetOrCreateEntry(() =>
-            EFCoreCatalogEntries.Enumerable.EFCore<PreprocessedCompany, AppDbContext>(
+            EFCoreItemFactory.Enumerable.EFCore<PreprocessedCompany, AppDbContext>(
                 label: "PreprocessedCompanies",
                 contextFactory: _contextFactory
             )
@@ -123,9 +123,9 @@ For tables that store exactly one row — a trained model, a configuration recor
 // Data/_06_Models/Catalog.Models.cs
 public partial class Catalog
 {
-    public ICatalogEntry<TrainedModel> Regressor =>
+    public IItem<TrainedModel> Regressor =>
         GetOrCreateEntry(() =>
-            EFCoreCatalogEntries.Single.EFCore<TrainedModel, AppDbContext>(
+            EFCoreItemFactory.Single.EFCore<TrainedModel, AppDbContext>(
                 label: "Regressor",
                 contextFactory: _contextFactory
             )
@@ -141,21 +141,21 @@ The `queryCustomizer` parameter receives the raw `IQueryable<T>` before the adap
 
 ```csharp
 // Order for deterministic output
-EFCoreCatalogEntries.Enumerable.EFCore<Shuttle, AppDbContext>(
+EFCoreItemFactory.Enumerable.EFCore<Shuttle, AppDbContext>(
     label: "Shuttles",
     contextFactory: _contextFactory,
     queryCustomizer: q => q.OrderBy(s => s.Id)
 )
 
 // Load with a navigation property
-EFCoreCatalogEntries.Enumerable.EFCore<Person, AppDbContext>(
+EFCoreItemFactory.Enumerable.EFCore<Person, AppDbContext>(
     label: "Persons",
     contextFactory: _contextFactory,
     queryCustomizer: q => q.Include(p => p.Address).AsNoTracking()
 )
 
 // Filter to a subset
-EFCoreCatalogEntries.Enumerable.EFCore<Record, AppDbContext>(
+EFCoreItemFactory.Enumerable.EFCore<Record, AppDbContext>(
     label: "ActiveRecords",
     contextFactory: _contextFactory,
     queryCustomizer: q => q.Where(r => r.IsActive)
@@ -170,7 +170,7 @@ The default save strategy is `RemoveRange` + `AddRange` (full replace semantics,
 
 ```csharp
 // Upsert instead of replace
-EFCoreCatalogEntries.Enumerable.EFCore<Company, AppDbContext>(
+EFCoreItemFactory.Enumerable.EFCore<Company, AppDbContext>(
     label: "Companies",
     contextFactory: _contextFactory,
     saveFunc: async (ctx, data, ct) =>
@@ -206,7 +206,7 @@ internal static class MyProjectSaveFuncs
 }
 
 // In your catalog entry:
-EFCoreCatalogEntries.Enumerable.EFCore<Company, AppDbContext>(
+EFCoreItemFactory.Enumerable.EFCore<Company, AppDbContext>(
     label: "Companies",
     contextFactory: _contextFactory,
     saveFunc: MyProjectSaveFuncs.ReplaceCompanies
@@ -228,7 +228,7 @@ saveFunc: async (ctx, data, ct) =>
 Use `.Constrain()` to mark source or reference tables as read-only. Flowthru will fail at pipeline build time — before any data moves — if a node attempts to write to this entry:
 
 ```csharp
-EFCoreCatalogEntries.Enumerable.EFCore<SourceRecord, SourceDbContext>(
+EFCoreItemFactory.Enumerable.EFCore<SourceRecord, SourceDbContext>(
     label: "SourceRecords",
     contextFactory: _sourceFactory)
 .Constrain(traits => traits with { CanWrite = false })
@@ -241,7 +241,7 @@ See [Constraining Catalog Entries](constraining-catalog-entries.md) for the full
 By default, an empty table fails pre-flight validation. The adapter expects each catalog entry to have data before the pipeline runs. For tables that are legitimately empty on first run — audit logs, optional output tables, or incremental pipelines — set `allowEmptyData: true`:
 
 ```csharp
-EFCoreCatalogEntries.Enumerable.EFCore<AuditEvent, AppDbContext>(
+EFCoreItemFactory.Enumerable.EFCore<AuditEvent, AppDbContext>(
     label: "AuditEvents",
     contextFactory: _contextFactory,
     allowEmptyData: true
diff --git a/docs/project.json b/docs/project.json
new file mode 100644
index 00000000..292c1716
--- /dev/null
+++ b/docs/project.json
@@ -0,0 +1,19 @@
+{
+  "name": "docs",
+  "$schema": "../node_modules/nx/schemas/project-schema.json",
+  "projectType": "library",
+  "sourceRoot": "./docs",
+  "targets": {
+    "build:reference": {
+      "//": "Generates markdown API reference from C# docstrings into docs/reference/src/",
+      "executor": "nx:run-commands",
+      "dependsOn": [ "flowthru:restore" ],
+      "options": {
+        "commands": [
+          "./scripts/docfx-metadata.sh --projects src"
+        ],
+        "parallel": false
+      }
+    }
+  }
+}
diff --git a/docs/reference/.gitkeep b/docs/reference/.gitkeep
deleted file mode 100644
index e69de29b..00000000
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.FlowthruSchemaAttribute.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.FlowthruSchemaAttribute.md
new file mode 100644
index 00000000..cc8cbee1
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.FlowthruSchemaAttribute.md
@@ -0,0 +1,71 @@
+# <a id="Flowthru_Abstractions_FlowthruSchemaAttribute"></a> Class FlowthruSchemaAttribute
+
+Namespace: [Flowthru.Abstractions](Flowthru.Abstractions.md)  
+Assembly: Flowthru.Core.dll  
+
+Marks a schema type for automatic interface generation. The source generator
+will analyze the type's properties and emit the appropriate marker interfaces:
+<ul><li><xref href="Flowthru.Abstractions.IFlatSchema" data-throw-if-not-resolved="false"></xref> or <xref href="Flowthru.Abstractions.INestedSchema" data-throw-if-not-resolved="false"></xref> based on property types</li><li><xref href="Flowthru.Abstractions.ITextSerializable" data-throw-if-not-resolved="false"></xref> for flat schemas (CSV/TSV compatible)</li><li><xref href="Flowthru.Abstractions.IBinarySerializable" data-throw-if-not-resolved="false"></xref> for flat schemas (Parquet compatible)</li><li><xref href="Flowthru.Abstractions.IStructuredSerializable" data-throw-if-not-resolved="false"></xref> for all schemas (JSON/XML compatible)</li></ul>
+
+```csharp
+[AttributeUsage(AttributeTargets.Class|AttributeTargets.Struct, Inherited = false, AllowMultiple = false)]
+public sealed class FlowthruSchemaAttribute : Attribute
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[Attribute](https://learn.microsoft.com/dotnet/api/system.attribute) ← 
+[FlowthruSchemaAttribute](Flowthru.Abstractions.FlowthruSchemaAttribute.md)
+
+#### Inherited Members
+
+[Attribute.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.attribute.equals), 
+[Attribute.GetCustomAttribute\(Assembly, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-assembly\-system\-type\)), 
+[Attribute.GetCustomAttribute\(Assembly, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-assembly\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttribute\(MemberInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-memberinfo\-system\-type\)), 
+[Attribute.GetCustomAttribute\(MemberInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-memberinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttribute\(Module, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-module\-system\-type\)), 
+[Attribute.GetCustomAttribute\(Module, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-module\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttribute\(ParameterInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-parameterinfo\-system\-type\)), 
+[Attribute.GetCustomAttribute\(ParameterInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-parameterinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Assembly\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\)), 
+[Attribute.GetCustomAttributes\(Assembly, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Assembly, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\-system\-type\)), 
+[Attribute.GetCustomAttributes\(Assembly, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(MemberInfo\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\)), 
+[Attribute.GetCustomAttributes\(MemberInfo, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(MemberInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\-system\-type\)), 
+[Attribute.GetCustomAttributes\(MemberInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Module\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\)), 
+[Attribute.GetCustomAttributes\(Module, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Module, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\-system\-type\)), 
+[Attribute.GetCustomAttributes\(Module, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\-system\-type\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.attribute.gethashcode), 
+[Attribute.IsDefaultAttribute\(\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefaultattribute), 
+[Attribute.IsDefined\(Assembly, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-assembly\-system\-type\)), 
+[Attribute.IsDefined\(Assembly, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-assembly\-system\-type\-system\-boolean\)), 
+[Attribute.IsDefined\(MemberInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-memberinfo\-system\-type\)), 
+[Attribute.IsDefined\(MemberInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-memberinfo\-system\-type\-system\-boolean\)), 
+[Attribute.IsDefined\(Module, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-module\-system\-type\)), 
+[Attribute.IsDefined\(Module, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-module\-system\-type\-system\-boolean\)), 
+[Attribute.IsDefined\(ParameterInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-parameterinfo\-system\-type\)), 
+[Attribute.IsDefined\(ParameterInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-parameterinfo\-system\-type\-system\-boolean\)), 
+[Attribute.Match\(object?\)](https://learn.microsoft.com/dotnet/api/system.attribute.match), 
+[Attribute.TypeId](https://learn.microsoft.com/dotnet/api/system.attribute.typeid), 
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+The annotated type must be declared as <code>partial</code>. The generator inspects
+public instance properties to determine structural classification.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.IBinarySerializable.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.IBinarySerializable.md
new file mode 100644
index 00000000..45d87f08
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.IBinarySerializable.md
@@ -0,0 +1,68 @@
+# <a id="Flowthru_Abstractions_IBinarySerializable"></a> Interface IBinarySerializable
+
+Namespace: [Flowthru.Abstractions](Flowthru.Abstractions.md)  
+Assembly: Flowthru.Core.dll  
+
+Marker interface for schema types that can be serialized to columnar binary formats (Parquet, Avro).
+
+```csharp
+public interface IBinarySerializable
+```
+
+## Examples
+
+<pre><code class="lang-csharp">// ✅ Flat schema with binary serialization - optimal
+public sealed record FeatureRow(
+    DateTime Timestamp,
+    double Feature1,
+    double Feature2,
+    int Label
+) : IFlatSchema, IBinarySerializable, ITextSerializable;
+
+// ✅ Multiple format support for flexibility
+public sealed record CompanySchema(
+    int Id,
+    string Name,
+    float Rating
+) : IFlatSchema, ITextSerializable, IBinarySerializable, IStructuredSerializable;
+
+// ⚠️ Nested schema - binary serialization less optimal
+public sealed record OrderWithItemFactory(
+    string OrderId,
+    List&lt;LineItem&gt; ItemFactory  // Nested column in Parquet
+) : INestedSchema, IBinarySerializable, IStructuredSerializable;</code></pre>
+
+## Remarks
+
+<p>
+<strong>Purpose:</strong> Indicates a schema is compatible with efficient, columnar binary
+formats designed for analytical workloads.
+</p>
+<p>
+<strong>Compatible Formats:</strong>
+</p>
+<ul><li>Parquet (Apache Parquet - columnar storage)</li><li>Avro (Apache Avro - row-based but schema-aware)</li><li>ORC (Optimized Row Columnar - Hive format)</li><li>Arrow (Apache Arrow - in-memory columnar format)</li></ul>
+<p>
+<strong>Requirements:</strong>
+</p>
+<p>
+Most binary formats work best with flat schemas, though formats like Parquet
+support nested columns:
+</p>
+<ul><li><strong>Flat schemas (<xref href="Flowthru.Abstractions.IFlatSchema" data-throw-if-not-resolved="false"></xref>):</strong> Optimal - full columnar compression</li><li><strong>Nested schemas (<xref href="Flowthru.Abstractions.INestedSchema" data-throw-if-not-resolved="false"></xref>):</strong> Supported but may lose some benefits</li></ul>
+<p>
+<strong>Design Rationale:</strong>
+</p>
+<p>
+Binary serialization offers significant advantages:
+</p>
+<ul><li><strong>Performance:</strong> Orders of magnitude faster read/write than CSV</li><li><strong>Compression:</strong> Columnar formats achieve excellent compression ratios</li><li><strong>Type Preservation:</strong> Native storage of numeric types (no string conversion)</li><li><strong>Predicate Pushdown:</strong> Read only required columns/rows</li><li><strong>Schema Evolution:</strong> Built-in schema versioning support</li></ul>
+<p>
+<strong>When to Use:</strong>
+</p>
+<ul><li>Large datasets (&gt;10MB)</li><li>Analytical queries (aggregations, filters)</li><li>Data lake storage</li><li>Machine learning feature stores</li><li>Long-term data archival</li></ul>
+<p>
+<strong>Trade-offs:</strong>
+</p>
+<ul><li>❌ Not human-readable (use JSON for debugging)</li><li>❌ Requires specialized libraries (not plain text editors)</li><li>✅ Superior performance for large-scale data</li><li>✅ Industry standard for big data ecosystems</li></ul>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.IFlatSchema.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.IFlatSchema.md
new file mode 100644
index 00000000..e57eacc0
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.IFlatSchema.md
@@ -0,0 +1,62 @@
+# <a id="Flowthru_Abstractions_IFlatSchema"></a> Interface IFlatSchema
+
+Namespace: [Flowthru.Abstractions](Flowthru.Abstractions.md)  
+Assembly: Flowthru.Core.dll  
+
+Marker interface for schema types with flat (non-nested) structure.
+
+```csharp
+public interface IFlatSchema
+```
+
+## Examples
+
+<pre><code class="lang-csharp">// ✅ Flat schema with multiple serialization capabilities
+public sealed record CompanySchema(
+    int Id,
+    string Name,
+    float Rating,
+    bool IsActive
+) : IFlatSchema, ITextSerializable, IBinarySerializable;
+
+// ❌ Not flat - contains collection
+public sealed record OrderSchema(
+    string OrderId,
+    List&lt;LineItem&gt; ItemFactory  // Collection = nested!
+) : INestedSchema, IStructuredSerializable;</code></pre>
+
+## Remarks
+
+<p>
+<strong>Purpose:</strong> Indicates a schema contains only primitive properties,
+with no collections or nested objects.
+</p>
+<p>
+<strong>Flat Structure Requirements:</strong>
+</p>
+<ul><li>All properties are primitives (int, long, double, decimal, bool, string, DateTime, etc.)</li><li>Nullable primitives (int?, double?, bool?, etc.) are allowed</li><li>Enums and nullable enums are allowed</li><li>Value types that serialize to single values (Guid, TimeSpan, etc.) are allowed</li></ul>
+<p>
+<strong>Not Flat (Use INestedSchema instead):</strong>
+</p>
+<ul><li>Collections: List&lt;T&gt;, Array, IEnumerable&lt;T&gt;, etc.</li><li>Nested objects: Custom class/record properties</li><li>Dictionaries or complex structures</li></ul>
+<p>
+<strong>Design Rationale:</strong>
+</p>
+<p>
+Separating structural properties (flat vs nested) from serialization capabilities
+(text/structured/binary) enables:
+- Explicit schema documentation
+- Compile-time format validation
+- Format serializers can enforce appropriate constraints
+- Clear intent about data structure complexity
+</p>
+<p>
+<strong>Relationship with Serialization Markers:</strong>
+</p>
+<p>
+A flat schema should also implement one or more serialization capability markers:
+- <xref href="Flowthru.Abstractions.ITextSerializable" data-throw-if-not-resolved="false"></xref> - Can serialize to CSV/TSV
+- <xref href="Flowthru.Abstractions.IStructuredSerializable" data-throw-if-not-resolved="false"></xref> - Can serialize to JSON/XML
+- <xref href="Flowthru.Abstractions.IBinarySerializable" data-throw-if-not-resolved="false"></xref> - Can serialize to Parquet/Avro
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.IFlatSerializable.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.IFlatSerializable.md
new file mode 100644
index 00000000..0ea58d3c
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.IFlatSerializable.md
@@ -0,0 +1,70 @@
+# <a id="Flowthru_Abstractions_IFlatSerializable"></a> Interface IFlatSerializable
+
+Namespace: [Flowthru.Abstractions](Flowthru.Abstractions.md)  
+Assembly: Flowthru.Core.dll  
+
+Marker interface for schema types that contain only flat, primitive data.
+
+```csharp
+public interface IFlatSerializable
+```
+
+## Examples
+
+<pre><code class="lang-csharp">// ✅ Flat schema - CSV compatible
+public record CompanySchema : IFlatSerializable
+{
+    public string Id { get; init; } = null!;
+    public string Name { get; init; } = null!;
+    public decimal Rating { get; init; }
+    public int FoundedYear { get; init; }
+    public bool IataApproved { get; init; }
+}
+
+// ✅ Compiles successfully - flat schema with flat storage
+catalog.Companies = CreateCsvDataset&lt;CompanySchema&gt;("companies", "companies.csv");
+
+// ❌ Nested schema - requires JSON or Parquet
+public record CrossValidationResults : INestedSerializable
+{
+    public List&lt;FoldMetric&gt; FoldMetrics { get; init; } = new();
+    public double MeanR2Score { get; init; }
+}
+
+// ❌ Compile error: CrossValidationResults does not implement IFlatSerializable
+catalog.Results = CreateCsvDataset&lt;CrossValidationResults&gt;("results", "results.csv");
+
+// ✅ Correct: Use JSON for nested data
+catalog.Results = CreateJsonObject&lt;CrossValidationResults&gt;("results", "results.json");</code></pre>
+
+## Remarks
+
+<p>
+<strong>Purpose:</strong> Enables compile-time validation that flat file formats
+(CSV, TSV, etc.) receive compatible schema types.
+</p>
+<p>
+<strong>What qualifies as "flat"?</strong>
+</p>
+<p>
+A schema is considered flat if all properties are:
+</p>
+<ul><li>Primitive types (int, long, double, decimal, bool, string, DateTime, DateTimeOffset, etc.)</li><li>Nullable primitives (int?, double?, bool?, etc.)</li><li>Enums (and nullable enums)</li><li>Value types that serialize to single values (Guid, TimeSpan, etc.)</li></ul>
+<p>
+A schema is NOT flat if it contains:
+</p>
+<ul><li>Collections (List&lt;T&gt;, Array, IEnumerable&lt;T&gt;, etc.)</li><li>Nested objects (custom class/record properties)</li><li>Dictionaries or other complex structures</li></ul>
+<p>
+<strong>Compatible Storage Formats:</strong>
+</p>
+<ul><li>CSV files (CsvCatalogDataset&lt;T&gt;)</li><li>Excel files (ExcelCatalogDataset&lt;T&gt;)</li><li>JSON files (JsonCatalogDataset&lt;T&gt; - also supports nested)</li><li>Parquet files (ParquetCatalogDataset&lt;T&gt; - also supports nested)</li><li>Database tables (flat row structure)</li></ul>
+<p>
+<strong>Design Rationale:</strong>
+</p>
+<p>
+This marker interface follows Flowthru's philosophy of "fail at compile-time, not runtime."
+By requiring flat-only storage formats to constrain their generic type parameter with
+<code>where T : IFlatSerializable</code>, we catch schema-format mismatches during compilation
+rather than discovering silent data loss or runtime serialization errors during execution.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.INestedSchema.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.INestedSchema.md
new file mode 100644
index 00000000..7375820c
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.INestedSchema.md
@@ -0,0 +1,66 @@
+# <a id="Flowthru_Abstractions_INestedSchema"></a> Interface INestedSchema
+
+Namespace: [Flowthru.Abstractions](Flowthru.Abstractions.md)  
+Assembly: Flowthru.Core.dll  
+
+Marker interface for schema types with nested structure (collections or nested objects).
+
+```csharp
+public interface INestedSchema
+```
+
+## Examples
+
+<pre><code class="lang-csharp">// ✅ Nested schema with collection
+public sealed record CrossValidationResults(
+    List&lt;FoldMetric&gt; FoldMetrics,  // Nested collection
+    double MeanR2Score,
+    int NumFolds
+) : INestedSchema, IStructuredSerializable;
+
+// ✅ Nested schema with nested object
+public sealed record CustomerOrder(
+    string OrderId,
+    CustomerInfo Customer,  // Nested object
+    DateTime OrderDate
+) : INestedSchema, IStructuredSerializable;
+
+// Individual nested type can be flat
+public sealed record FoldMetric(
+    int FoldNumber,
+    double R2Score
+) : IFlatSchema, ITextSerializable;</code></pre>
+
+## Remarks
+
+<p>
+<strong>Purpose:</strong> Indicates a schema contains hierarchical data requiring
+storage formats that support nested structures.
+</p>
+<p>
+<strong>Nested Structure Characteristics:</strong>
+</p>
+<ul><li>Collections: List&lt;T&gt;, Array, IEnumerable&lt;T&gt;, ICollection&lt;T&gt;, etc.</li><li>Nested objects: Properties that are custom classes or records</li><li>Dictionaries: Dictionary&lt;TKey, TValue&gt;, IDictionary, etc.</li><li>Complex hierarchical structures</li></ul>
+<p>
+<strong>Compatible Storage Formats:</strong>
+</p>
+<ul><li>JSON files (preserves hierarchy)</li><li>Parquet files (supports nested columns)</li><li>XML files (hierarchical by nature)</li><li>Document databases (MongoDB, etc.)</li></ul>
+<p>
+<strong>Incompatible Storage Formats:</strong>
+</p>
+<ul><li>❌ CSV files - cannot represent nested structures</li><li>❌ Excel files - limited nesting support, loses structure</li><li>❌ Flat relational tables - requires denormalization</li></ul>
+<p>
+<strong>Design Rationale:</strong>
+</p>
+<p>
+This marker interface serves multiple purposes:
+</p>
+<ol><li><strong>Self-Documentation:</strong> Clearly signals schema complexity</li><li><strong>Intent Declaration:</strong> Distinguishes "happens to be flat" from "designed to be flat"</li><li><strong>Migration Safety:</strong> Identifies schemas that cannot use flat formats</li><li><strong>Future Validation:</strong> Enables build-time checks via analyzers</li></ol>
+<p>
+<strong>Relationship with IFlatSchema:</strong>
+</p>
+<p>
+These interfaces are mutually exclusive. A schema should implement exactly one:
+</p>
+<ul><li><xref href="Flowthru.Abstractions.IFlatSchema" data-throw-if-not-resolved="false"></xref> - All primitive properties</li><li><xref href="Flowthru.Abstractions.INestedSchema" data-throw-if-not-resolved="false"></xref> - Contains collections or nested objects</li></ul>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.INestedSerializable.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.INestedSerializable.md
new file mode 100644
index 00000000..779d3d4c
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.INestedSerializable.md
@@ -0,0 +1,78 @@
+# <a id="Flowthru_Abstractions_INestedSerializable"></a> Interface INestedSerializable
+
+Namespace: [Flowthru.Abstractions](Flowthru.Abstractions.md)  
+Assembly: Flowthru.Core.dll  
+
+Marker interface for schema types that contain nested structures or collections.
+
+```csharp
+public interface INestedSerializable
+```
+
+## Examples
+
+<pre><code class="lang-csharp">// ✅ Nested schema - requires hierarchical storage
+public record CrossValidationResults : INestedSerializable
+{
+    // Collection of nested objects
+    public List&lt;FoldMetric&gt; FoldMetrics { get; init; } = new();
+
+    // Flat properties are fine in nested schemas
+    public double MeanR2Score { get; init; }
+    public double StdDevR2Score { get; init; }
+    public int NumFolds { get; init; }
+}
+
+public record FoldMetric : IFlatSerializable  // Individual fold is flat
+{
+    public int FoldNumber { get; init; }
+    public double R2Score { get; init; }
+    public double MeanAbsoluteError { get; init; }
+}
+
+// ✅ Correct: Use JSON for nested data
+catalog.CrossValidationResults = CreateJsonObject&lt;CrossValidationResults&gt;(
+    "cross_validation_results",
+    "model_output/cross_validation_results.json");
+
+// ❌ Compile error if attempted with CSV (prevented by IFlatSerializable constraint)
+// catalog.CrossValidationResults = CreateCsvDataset&lt;CrossValidationResults&gt;(...);</code></pre>
+
+## Remarks
+
+<p>
+<strong>Purpose:</strong> Documents that a schema contains hierarchical data and
+requires storage formats that support nested structures (JSON, Parquet, XML, etc.).
+</p>
+<p>
+<strong>What qualifies as "nested"?</strong>
+</p>
+<p>
+A schema is considered nested if it contains one or more of:
+</p>
+<ul><li>Collections (List&lt;T&gt;, Array, IEnumerable&lt;T&gt;, ICollection&lt;T&gt;, etc.)</li><li>Nested objects (properties that are custom classes or records)</li><li>Dictionaries (Dictionary&lt;TKey, TValue&gt;, IDictionary, etc.)</li><li>Complex hierarchical structures</li></ul>
+<p>
+<strong>Compatible Storage Formats:</strong>
+</p>
+<ul><li>JSON files (JsonCatalogDataset&lt;T&gt;, JsonCatalogObject&lt;T&gt;)</li><li>Parquet files (ParquetCatalogDataset&lt;T&gt; - supports nested columns)</li><li>XML files (if implemented)</li><li>Document databases (MongoDB, etc.)</li></ul>
+<p>
+<strong>Incompatible Storage Formats:</strong>
+</p>
+<ul><li>❌ CSV files - cannot represent nested structures</li><li>❌ Excel files - limited nesting support, loses structure</li><li>❌ Relational database tables - requires denormalization or separate tables</li></ul>
+<p>
+<strong>Design Rationale:</strong>
+</p>
+<p>
+While this interface is not enforced by generic constraints (since nested-compatible
+formats like JSON can also handle flat data), it serves important documentation and
+validation purposes:
+</p>
+<ol><li><strong>Self-Documentation:</strong> Clearly signals schema complexity to developers</li><li><strong>Future Analyzer Support:</strong> Enables build-time validation via Roslyn analyzers</li><li><strong>Intent Declaration:</strong> Distinguishes "happens to be flat" from "designed to be flat"</li><li><strong>Migration Safety:</strong> Helps identify schemas that cannot be migrated to flat formats</li></ol>
+<p>
+<strong>Relationship with IFlatSerializable:</strong>
+</p>
+<p>
+These interfaces are mutually exclusive. A schema should implement exactly one:
+</p>
+<ul><li><xref href="Flowthru.Abstractions.IFlatSerializable" data-throw-if-not-resolved="false"></xref> - All primitive properties, CSV-compatible</li><li><xref href="Flowthru.Abstractions.INestedSerializable" data-throw-if-not-resolved="false"></xref> - Contains collections or nested objects</li></ul>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.IScalar.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.IScalar.md
new file mode 100644
index 00000000..cd7e7808
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.IScalar.md
@@ -0,0 +1,67 @@
+# <a id="Flowthru_Abstractions_IScalar"></a> Interface IScalar
+
+Namespace: [Flowthru.Abstractions](Flowthru.Abstractions.md)  
+Assembly: Flowthru.Core.dll  
+
+Marker interface for types that serialize to a single primitive value —
+i.e., they produce <code>"key": value</code> in JSON, not <code>"key": {...}</code> or <code>"key": [...]</code>.
+
+```csharp
+public interface IScalar
+```
+
+## Examples
+
+<pre><code class="lang-csharp">// ✅ Single-value wrapper — safe to implement IScalar
+public readonly record struct CustomerId(string Value) : IScalar;
+
+// ✅ Schema using the NewType is classified as flat
+[FlowthruSchema]
+public partial record OrderSchema
+{
+    public required CustomerId Id { get; init; }
+    public required string Name { get; init; }
+}
+
+// ❌ Multi-property struct — NOT a scalar, do not implement IScalar
+public readonly record struct Address(string Street, string City) /* : IScalar — wrong */;</code></pre>
+
+## Remarks
+
+<p>
+<strong>Purpose:</strong> Enables user-defined NewTypes and value-object wrappers to participate
+in flat schema classification. Without this interface, the source generator cannot distinguish
+a <code>CustomerId</code> wrapping a <code>string</code> from a nested object requiring <code>{...}</code>
+serialization.
+</p>
+<p>
+<strong>The JSON Test:</strong>
+</p>
+<p>
+The definitive question when implementing this interface is: does your type serialize to a
+single JSON value? A type is a flat scalar if and only if it produces one of:
+</p>
+<ul><li><code>"key": 42</code> — numeric</li><li><code>"key": "abc"</code> — string</li><li><code>"key": true</code> — boolean</li><li><code>"key": null</code> — null</li></ul>
+<p>
+If your type requires <code>"key": { "inner": ... }</code> or <code>"key": [...]</code>, it is NOT a
+scalar and implementing this interface would misrepresent its structure, causing silent data
+loss or serialization failures in flat formats like CSV.
+</p>
+<p>
+<strong>Typical Use Cases:</strong>
+</p>
+<ul><li>NewType / value-object wrappers: <code>record CustomerId(string Value) : IScalar</code></li><li>Strong-typed identifiers backed by a primitive: <code>record OrderRef(Guid Id) : IScalar</code></li><li>Domain primitives that round-trip through a single string or numeric field</li></ul>
+<p>
+<strong>What this is NOT for:</strong>
+</p>
+<ul><li>Types with multiple public properties — those are nested objects</li><li>Collections or dictionaries</li><li>BCL types like <code>Guid</code>, <code>DateTime</code>, <code>TimeSpan</code> — those are recognized
+automatically by the source generator as known flat scalars</li></ul>
+<p>
+<strong>Relationship with <xref href="Flowthru.Abstractions.IFlatSchema" data-throw-if-not-resolved="false"></xref>:</strong>
+</p>
+<p>
+<xref href="Flowthru.Abstractions.IFlatSchema" data-throw-if-not-resolved="false"></xref> marks a <em>row type</em> — a schema whose properties are all
+scalars. <xref href="Flowthru.Abstractions.IScalar" data-throw-if-not-resolved="false"></xref> marks a <em>property type</em> — a single value that can
+appear as a column in a flat row. Nesting a flat row inside another row is still nesting.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.IStructuredSerializable.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.IStructuredSerializable.md
new file mode 100644
index 00000000..5024d787
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.IStructuredSerializable.md
@@ -0,0 +1,66 @@
+# <a id="Flowthru_Abstractions_IStructuredSerializable"></a> Interface IStructuredSerializable
+
+Namespace: [Flowthru.Abstractions](Flowthru.Abstractions.md)  
+Assembly: Flowthru.Core.dll  
+
+Marker interface for schema types that can be serialized to structured formats (JSON, XML).
+
+```csharp
+public interface IStructuredSerializable
+```
+
+## Examples
+
+<pre><code class="lang-csharp">// ✅ Nested schema - structured serialization required
+public sealed record CrossValidationResults(
+    List&lt;FoldMetric&gt; FoldMetrics,
+    double MeanScore
+) : INestedSchema, IStructuredSerializable;
+
+// ✅ Flat schema - structured serialization optional
+public sealed record ModelMetrics(
+    double Accuracy,
+    double Precision,
+    double Recall
+) : IFlatSchema, IStructuredSerializable, ITextSerializable;
+
+// ✅ Configuration object
+public sealed record TrainingConfig(
+    int Epochs,
+    double LearningRate,
+    Dictionary&lt;string, object&gt; Hyperparameters
+) : INestedSchema, IStructuredSerializable;</code></pre>
+
+## Remarks
+
+<p>
+<strong>Purpose:</strong> Indicates a schema is compatible with structured, hierarchical
+formats that can represent nested objects and collections.
+</p>
+<p>
+<strong>Compatible Formats:</strong>
+</p>
+<ul><li>JSON (JavaScript Object Notation)</li><li>XML (Extensible Markup Language)</li><li>YAML (YAML Ain't Markup Language)</li><li>TOML (Tom's Obvious Minimal Language)</li></ul>
+<p>
+<strong>Flexibility:</strong>
+</p>
+<p>
+Unlike <xref href="Flowthru.Abstractions.ITextSerializable" data-throw-if-not-resolved="false"></xref> which requires flat schemas, structured formats
+can handle both:
+</p>
+<ul><li><xref href="Flowthru.Abstractions.IFlatSchema" data-throw-if-not-resolved="false"></xref> - Simple, flat data structures</li><li><xref href="Flowthru.Abstractions.INestedSchema" data-throw-if-not-resolved="false"></xref> - Complex, hierarchical data structures</li></ul>
+<p>
+<strong>Design Rationale:</strong>
+</p>
+<p>
+Structured serialization is the most flexible format capability:
+- Can represent any schema structure (flat or nested)
+- Human-readable and widely supported
+- Preserves type information and hierarchy
+- Suitable for configuration, results, and complex data
+</p>
+<p>
+<strong>Typical Usage Patterns:</strong>
+</p>
+<ul><li><strong>Nested schemas:</strong> Must use structured serialization (JSON/XML only option)</li><li><strong>Flat schemas:</strong> Can use structured serialization when human-readability matters</li><li><strong>Configuration objects:</strong> Often use JSON for flexibility</li><li><strong>Model metadata:</strong> JSON captures complex metrics and parameters</li></ul>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.ITextSerializable.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.ITextSerializable.md
new file mode 100644
index 00000000..add434c6
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.ITextSerializable.md
@@ -0,0 +1,67 @@
+# <a id="Flowthru_Abstractions_ITextSerializable"></a> Interface ITextSerializable
+
+Namespace: [Flowthru.Abstractions](Flowthru.Abstractions.md)  
+Assembly: Flowthru.Core.dll  
+
+Marker interface for schema types that can be serialized to text-based formats (CSV, TSV).
+
+```csharp
+public interface ITextSerializable
+```
+
+## Examples
+
+<pre><code class="lang-csharp">// ✅ Flat schema with text serialization
+public sealed record CompanySchema(
+    int Id,
+    string Name,
+    float Rating
+) : IFlatSchema, ITextSerializable;
+
+// ✅ Flat schema with multiple serialization capabilities
+public sealed record DataRow(
+    DateTime Timestamp,
+    double Value,
+    string Category
+) : IFlatSchema, ITextSerializable, IBinarySerializable;
+
+// ❌ Cannot be text serialized - nested structure
+public sealed record NestedData(
+    string Id,
+    List&lt;string&gt; Tags  // Collection!
+) : INestedSchema, IStructuredSerializable;  // Not ITextSerializable</code></pre>
+
+## Remarks
+
+<p>
+<strong>Purpose:</strong> Indicates a schema is compatible with text-based, flat file
+formats that represent data in rows and columns.
+</p>
+<p>
+<strong>Compatible Formats:</strong>
+</p>
+<ul><li>CSV (Comma-Separated Values)</li><li>TSV (Tab-Separated Values)</li><li>Other delimited text formats</li></ul>
+<p>
+<strong>Requirements:</strong>
+</p>
+<p>
+Schemas implementing this interface must:
+</p>
+<ul><li>Also implement <xref href="Flowthru.Abstractions.IFlatSchema" data-throw-if-not-resolved="false"></xref> (no nested structures)</li><li>Have properties that can be converted to/from string representation</li><li>Support single-value serialization per field</li></ul>
+<p>
+<strong>Design Rationale:</strong>
+</p>
+<p>
+Separating serialization capability from structure allows:
+- Compile-time enforcement: <code>CsvFormatSerializer&lt;T&gt; where T : IFlatSchema, ITextSerializable</code>
+- Multiple serialization targets: A flat schema can be both text and binary serializable
+- Clear documentation of supported formats
+</p>
+<p>
+<strong>Typical Usage:</strong>
+</p>
+<p>
+Most flat schemas should implement both <xref href="Flowthru.Abstractions.ITextSerializable" data-throw-if-not-resolved="false"></xref> and
+<xref href="Flowthru.Abstractions.IBinarySerializable" data-throw-if-not-resolved="false"></xref> to support maximum format flexibility.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.SerializedEnumAttribute.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.SerializedEnumAttribute.md
new file mode 100644
index 00000000..5cdb99dc
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.SerializedEnumAttribute.md
@@ -0,0 +1,171 @@
+# <a id="Flowthru_Abstractions_SerializedEnumAttribute"></a> Class SerializedEnumAttribute
+
+Namespace: [Flowthru.Abstractions](Flowthru.Abstractions.md)  
+Assembly: Flowthru.Core.dll  
+
+Specifies the serialized string value for an enum member when written to or read from storage.
+
+```csharp
+[AttributeUsage(AttributeTargets.Field, AllowMultiple = false, Inherited = false)]
+public sealed class SerializedEnumAttribute : Attribute
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[Attribute](https://learn.microsoft.com/dotnet/api/system.attribute) ← 
+[SerializedEnumAttribute](Flowthru.Abstractions.SerializedEnumAttribute.md)
+
+#### Inherited Members
+
+[Attribute.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.attribute.equals), 
+[Attribute.GetCustomAttribute\(Assembly, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-assembly\-system\-type\)), 
+[Attribute.GetCustomAttribute\(Assembly, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-assembly\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttribute\(MemberInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-memberinfo\-system\-type\)), 
+[Attribute.GetCustomAttribute\(MemberInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-memberinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttribute\(Module, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-module\-system\-type\)), 
+[Attribute.GetCustomAttribute\(Module, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-module\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttribute\(ParameterInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-parameterinfo\-system\-type\)), 
+[Attribute.GetCustomAttribute\(ParameterInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-parameterinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Assembly\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\)), 
+[Attribute.GetCustomAttributes\(Assembly, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Assembly, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\-system\-type\)), 
+[Attribute.GetCustomAttributes\(Assembly, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(MemberInfo\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\)), 
+[Attribute.GetCustomAttributes\(MemberInfo, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(MemberInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\-system\-type\)), 
+[Attribute.GetCustomAttributes\(MemberInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Module\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\)), 
+[Attribute.GetCustomAttributes\(Module, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Module, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\-system\-type\)), 
+[Attribute.GetCustomAttributes\(Module, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\-system\-type\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.attribute.gethashcode), 
+[Attribute.IsDefaultAttribute\(\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefaultattribute), 
+[Attribute.IsDefined\(Assembly, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-assembly\-system\-type\)), 
+[Attribute.IsDefined\(Assembly, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-assembly\-system\-type\-system\-boolean\)), 
+[Attribute.IsDefined\(MemberInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-memberinfo\-system\-type\)), 
+[Attribute.IsDefined\(MemberInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-memberinfo\-system\-type\-system\-boolean\)), 
+[Attribute.IsDefined\(Module, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-module\-system\-type\)), 
+[Attribute.IsDefined\(Module, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-module\-system\-type\-system\-boolean\)), 
+[Attribute.IsDefined\(ParameterInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-parameterinfo\-system\-type\)), 
+[Attribute.IsDefined\(ParameterInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-parameterinfo\-system\-type\-system\-boolean\)), 
+[Attribute.Match\(object?\)](https://learn.microsoft.com/dotnet/api/system.attribute.match), 
+[Attribute.TypeId](https://learn.microsoft.com/dotnet/api/system.attribute.typeid), 
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Examples
+
+<pre><code class="lang-csharp">// Example: Magic: The Gathering color enum
+public enum MtgColor
+{
+    [SerializedEnum("W")]
+    White,
+
+    [SerializedEnum("U")]
+    Blue,
+
+    [SerializedEnum("B")]
+    Black,
+
+    [SerializedEnum("R")]
+    Red,
+
+    [SerializedEnum("G")]
+    Green
+}
+
+// Example: Rarity enum with lowercase convention
+public enum Rarity
+{
+    [SerializedEnum("common")]
+    Common,
+
+    [SerializedEnum("uncommon")]
+    Uncommon,
+
+    [SerializedEnum("rare")]
+    Rare,
+
+    [SerializedEnum("mythic")]
+    Mythic
+}
+
+// Usage in schema - no additional configuration needed
+public record Card(
+    string Name,
+    MtgColor Color,  // Automatically serializes using [SerializedEnum] mappings
+    Rarity Rarity    // Works across all formats (JSON, CSV, Excel, Parquet)
+) : IFlatSchema, ITextSerializable;</code></pre>
+
+## Remarks
+
+<p>
+<strong>Purpose:</strong> Provides explicit string mappings for enum values across all storage formats.
+</p>
+<p>
+<strong>Format Agnostic:</strong> Works uniformly across CSV, Excel, JSON, Parquet, and future formats.
+The underlying serialization mechanism is abstracted away.
+</p>
+<p>
+<strong>Required for All Enum Members:</strong> Every enum member must have this attribute when used
+in schemas that will be serialized. This ensures explicit, documented mappings and prevents
+accidental mismatches between C# names and external data formats.
+</p>
+<p>
+<strong>Validation:</strong> The Flowthru pipeline validates at build time that all enum members
+used in schemas have this attribute applied.
+</p>
+<p>
+<strong>Common Use Cases:</strong>
+</p>
+<ul><li>Abbreviated values: <code>[SerializedEnum("W")] White</code></li><li>Lowercase conventions: <code>[SerializedEnum("common")] Common</code></li><li>Snake case: <code>[SerializedEnum("double_faced_token")] DoubleFacedToken</code></li><li>Legacy formats: <code>[SerializedEnum("STATUS_ACTIVE")] Active</code></li></ul>
+
+## Constructors
+
+### <a id="Flowthru_Abstractions_SerializedEnumAttribute__ctor_System_String_"></a> SerializedEnumAttribute\(string\)
+
+Initializes a new instance of the <xref href="Flowthru.Abstractions.SerializedEnumAttribute" data-throw-if-not-resolved="false"></xref> class.
+
+```csharp
+public SerializedEnumAttribute(string value)
+```
+
+#### Parameters
+
+`value` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+The string value to use when serializing this enum member.
+
+#### Exceptions
+
+ [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception)
+
+Thrown when <code class="paramref">value</code> is null.
+
+ [ArgumentException](https://learn.microsoft.com/dotnet/api/system.argumentexception)
+
+Thrown when <code class="paramref">value</code> is empty or whitespace.
+
+## Properties
+
+### <a id="Flowthru_Abstractions_SerializedEnumAttribute_Value"></a> Value
+
+Gets the serialized string value for this enum member.
+
+```csharp
+public string Value { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.SerializedLabelAttribute.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.SerializedLabelAttribute.md
new file mode 100644
index 00000000..383b534e
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.SerializedLabelAttribute.md
@@ -0,0 +1,143 @@
+# <a id="Flowthru_Abstractions_SerializedLabelAttribute"></a> Class SerializedLabelAttribute
+
+Namespace: [Flowthru.Abstractions](Flowthru.Abstractions.md)  
+Assembly: Flowthru.Core.dll  
+
+Specifies the external field name for a property when serialized to/from storage.
+
+```csharp
+[AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = true)]
+public sealed class SerializedLabelAttribute : Attribute
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[Attribute](https://learn.microsoft.com/dotnet/api/system.attribute) ← 
+[SerializedLabelAttribute](Flowthru.Abstractions.SerializedLabelAttribute.md)
+
+#### Inherited Members
+
+[Attribute.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.attribute.equals), 
+[Attribute.GetCustomAttribute\(Assembly, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-assembly\-system\-type\)), 
+[Attribute.GetCustomAttribute\(Assembly, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-assembly\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttribute\(MemberInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-memberinfo\-system\-type\)), 
+[Attribute.GetCustomAttribute\(MemberInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-memberinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttribute\(Module, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-module\-system\-type\)), 
+[Attribute.GetCustomAttribute\(Module, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-module\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttribute\(ParameterInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-parameterinfo\-system\-type\)), 
+[Attribute.GetCustomAttribute\(ParameterInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-parameterinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Assembly\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\)), 
+[Attribute.GetCustomAttributes\(Assembly, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Assembly, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\-system\-type\)), 
+[Attribute.GetCustomAttributes\(Assembly, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(MemberInfo\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\)), 
+[Attribute.GetCustomAttributes\(MemberInfo, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(MemberInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\-system\-type\)), 
+[Attribute.GetCustomAttributes\(MemberInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Module\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\)), 
+[Attribute.GetCustomAttributes\(Module, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Module, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\-system\-type\)), 
+[Attribute.GetCustomAttributes\(Module, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\-system\-type\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.attribute.gethashcode), 
+[Attribute.IsDefaultAttribute\(\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefaultattribute), 
+[Attribute.IsDefined\(Assembly, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-assembly\-system\-type\)), 
+[Attribute.IsDefined\(Assembly, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-assembly\-system\-type\-system\-boolean\)), 
+[Attribute.IsDefined\(MemberInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-memberinfo\-system\-type\)), 
+[Attribute.IsDefined\(MemberInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-memberinfo\-system\-type\-system\-boolean\)), 
+[Attribute.IsDefined\(Module, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-module\-system\-type\)), 
+[Attribute.IsDefined\(Module, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-module\-system\-type\-system\-boolean\)), 
+[Attribute.IsDefined\(ParameterInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-parameterinfo\-system\-type\)), 
+[Attribute.IsDefined\(ParameterInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-parameterinfo\-system\-type\-system\-boolean\)), 
+[Attribute.Match\(object?\)](https://learn.microsoft.com/dotnet/api/system.attribute.match), 
+[Attribute.TypeId](https://learn.microsoft.com/dotnet/api/system.attribute.typeid), 
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Examples
+
+<pre><code class="lang-csharp">// Tier 1: No annotation - property name matches external field name
+public record SimpleSchema(
+    int Id,           // Looks for "Id" in external data
+    string Name       // Looks for "Name" in external data
+) : IFlatSchema, ITextSerializable;
+
+// Tier 2: Explicit annotation - handle naming mismatches
+public record ShuttleSchema(
+    string Id,                                    // Looks for "Id"
+    [SerializedLabel("shuttle_location")]         // Looks for "shuttle_location"
+    string ShuttleLocation,
+
+    [SerializedLabel("d_check_complete")]         // Looks for "d_check_complete"
+    bool DCheckComplete,
+
+    [SerializedLabel("company id")]               // Handles space-separated names
+    int CompanyId
+) : IFlatSchema, ITextSerializable;</code></pre>
+
+## Remarks
+
+<p>
+<strong>Purpose:</strong> Bridges C# property names with external data field names across all storage formats.
+</p>
+<p>
+<strong>Format Agnostic:</strong> Works uniformly across CSV, Excel, JSON, Parquet, and future formats.
+The serialization mechanism (CsvHelper, ExcelDataReader, System.Text.Json, etc.) is abstracted away.
+</p>
+<p>
+<strong>Opt-in Override:</strong> If not present, the property name is used as-is.
+Use this attribute when the external field name differs from the C# property name.
+</p>
+<p>
+<strong>Common Use Cases:</strong>
+</p>
+<ul><li>snake_case data sources: <code>[SerializedLabel("company_id")] int CompanyId</code></li><li>kebab-case data sources: <code>[SerializedLabel("company-id")] int CompanyId</code></li><li>Space-separated names: <code>[SerializedLabel("Company ID")] int CompanyId</code></li><li>Legacy column names: <code>[SerializedLabel("CMPNY_ID")] int CompanyId</code></li></ul>
+
+## Constructors
+
+### <a id="Flowthru_Abstractions_SerializedLabelAttribute__ctor_System_String_"></a> SerializedLabelAttribute\(string\)
+
+Initializes a new instance of the <xref href="Flowthru.Abstractions.SerializedLabelAttribute" data-throw-if-not-resolved="false"></xref> class.
+
+```csharp
+public SerializedLabelAttribute(string label)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+The external field name in the serialized data
+
+#### Exceptions
+
+ [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception)
+
+Thrown when label is null
+
+ [ArgumentException](https://learn.microsoft.com/dotnet/api/system.argumentexception)
+
+Thrown when label is empty or whitespace
+
+## Properties
+
+### <a id="Flowthru_Abstractions_SerializedLabelAttribute_Label"></a> Label
+
+Gets the external field name for serialization.
+
+```csharp
+public string Label { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.md
new file mode 100644
index 00000000..92f38f24
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Abstractions.md
@@ -0,0 +1,53 @@
+# <a id="Flowthru_Abstractions"></a> Namespace Flowthru.Abstractions
+
+### Classes
+
+ [FlowthruSchemaAttribute](Flowthru.Abstractions.FlowthruSchemaAttribute.md)
+
+Marks a schema type for automatic interface generation. The source generator
+will analyze the type's properties and emit the appropriate marker interfaces:
+<ul><li><xref href="Flowthru.Abstractions.IFlatSchema" data-throw-if-not-resolved="false"></xref> or <xref href="Flowthru.Abstractions.INestedSchema" data-throw-if-not-resolved="false"></xref> based on property types</li><li><xref href="Flowthru.Abstractions.ITextSerializable" data-throw-if-not-resolved="false"></xref> for flat schemas (CSV/TSV compatible)</li><li><xref href="Flowthru.Abstractions.IBinarySerializable" data-throw-if-not-resolved="false"></xref> for flat schemas (Parquet compatible)</li><li><xref href="Flowthru.Abstractions.IStructuredSerializable" data-throw-if-not-resolved="false"></xref> for all schemas (JSON/XML compatible)</li></ul>
+
+ [SerializedEnumAttribute](Flowthru.Abstractions.SerializedEnumAttribute.md)
+
+Specifies the serialized string value for an enum member when written to or read from storage.
+
+ [SerializedLabelAttribute](Flowthru.Abstractions.SerializedLabelAttribute.md)
+
+Specifies the external field name for a property when serialized to/from storage.
+
+### Interfaces
+
+ [IBinarySerializable](Flowthru.Abstractions.IBinarySerializable.md)
+
+Marker interface for schema types that can be serialized to columnar binary formats (Parquet, Avro).
+
+ [IFlatSchema](Flowthru.Abstractions.IFlatSchema.md)
+
+Marker interface for schema types with flat (non-nested) structure.
+
+ [IFlatSerializable](Flowthru.Abstractions.IFlatSerializable.md)
+
+Marker interface for schema types that contain only flat, primitive data.
+
+ [INestedSchema](Flowthru.Abstractions.INestedSchema.md)
+
+Marker interface for schema types with nested structure (collections or nested objects).
+
+ [INestedSerializable](Flowthru.Abstractions.INestedSerializable.md)
+
+Marker interface for schema types that contain nested structures or collections.
+
+ [IScalar](Flowthru.Abstractions.IScalar.md)
+
+Marker interface for types that serialize to a single primitive value —
+i.e., they produce <code>"key": value</code> in JSON, not <code>"key": {...}</code> or <code>"key": [...]</code>.
+
+ [IStructuredSerializable](Flowthru.Abstractions.IStructuredSerializable.md)
+
+Marker interface for schema types that can be serialized to structured formats (JSON, XML).
+
+ [ITextSerializable](Flowthru.Abstractions.ITextSerializable.md)
+
+Marker interface for schema types that can be serialized to text-based formats (CSV, TSV).
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Cli.FlowthruCli.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Cli.FlowthruCli.md
new file mode 100644
index 00000000..2b200f12
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Cli.FlowthruCli.md
@@ -0,0 +1,130 @@
+# <a id="Flowthru_Cli_FlowthruCli"></a> Class FlowthruCli
+
+Namespace: [Flowthru.Cli](Flowthru.Cli.md)  
+Assembly: Flowthru.Core.dll  
+
+Command-line interface wrapper for IFlowthruService.
+
+```csharp
+public sealed class FlowthruCli
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowthruCli](Flowthru.Cli.FlowthruCli.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+FlowthruCli provides a thin CLI layer over the core IFlowthruService.
+It handles:
+- Command-line argument parsing
+- Help/version display
+- Result formatting
+- Exit code generation
+</p>
+<p>
+The CLI delegates all business logic to IFlowthruService, making the
+service layer testable and reusable in non-CLI scenarios.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Cli_FlowthruCli__ctor_Flowthru_Services_IFlowthruService_Microsoft_Extensions_Logging_ILogger_Flowthru_Cli_FlowthruCli__System_IO_TextWriter_"></a> FlowthruCli\(IFlowthruService, ILogger<FlowthruCli\>, TextWriter?\)
+
+Initializes a new CLI instance.
+
+```csharp
+public FlowthruCli(IFlowthruService service, ILogger<FlowthruCli> logger, TextWriter? output = null)
+```
+
+#### Parameters
+
+`service` [IFlowthruService](Flowthru.Services.IFlowthruService.md)
+
+Flowthru service
+
+`logger` [ILogger](https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger\-1)<[FlowthruCli](Flowthru.Cli.FlowthruCli.md)\>
+
+Logger instance
+
+`output` [TextWriter](https://learn.microsoft.com/dotnet/api/system.io.textwriter)?
+
+Output writer (defaults to Console.Out)
+
+## Methods
+
+### <a id="Flowthru_Cli_FlowthruCli_RunAsync_System_String___System_Threading_CancellationToken_"></a> RunAsync\(string\[\], CancellationToken\)
+
+Runs the CLI with the specified arguments.
+
+```csharp
+public Task<int> RunAsync(string[] args, CancellationToken cancellationToken = default)
+```
+
+#### Parameters
+
+`args` [string](https://learn.microsoft.com/dotnet/api/system.string)\[\]
+
+Command-line arguments
+
+`cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+Cancellation token
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<[int](https://learn.microsoft.com/dotnet/api/system.int32)\>
+
+Exit code (0 for success, non-zero for errors)
+
+### <a id="Flowthru_Cli_FlowthruCli_RunStandaloneAsync_System_String___System_Action_Microsoft_Extensions_DependencyInjection_IServiceCollection__System_Threading_CancellationToken_"></a> RunStandaloneAsync\(string\[\], Action<IServiceCollection\>, CancellationToken\)
+
+Creates and runs a standalone Flowthru CLI application with automatic service provider lifecycle management.
+
+```csharp
+public static Task<int> RunStandaloneAsync(string[] args, Action<IServiceCollection> configure, CancellationToken cancellationToken = default)
+```
+
+#### Parameters
+
+`args` [string](https://learn.microsoft.com/dotnet/api/system.string)\[\]
+
+Command-line arguments
+
+`configure` [Action](https://learn.microsoft.com/dotnet/api/system.action\-1)<[IServiceCollection](https://learn.microsoft.com/dotnet/api/microsoft.extensions.dependencyinjection.iservicecollection)\>
+
+Configuration callback to register pipelines and services
+
+`cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+Cancellation token
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<[int](https://learn.microsoft.com/dotnet/api/system.int32)\>
+
+Exit code (0 for success, non-zero for errors)
+
+#### Remarks
+
+<p>
+This is the recommended entry point for standalone console applications using Flowthru.
+It manages the ServiceProvider lifecycle automatically, ensuring proper disposal of
+logging providers and other resources so the process exits cleanly after pipeline completion.
+</p>
+<p>
+For applications that integrate Flowthru into an existing DI container (e.g., ASP.NET Core),
+use the standard constructor and let the host application manage the ServiceProvider lifecycle.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Cli.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Cli.md
new file mode 100644
index 00000000..cda960d0
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Cli.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Cli"></a> Namespace Flowthru.Cli
+
+### Classes
+
+ [FlowthruCli](Flowthru.Cli.FlowthruCli.md)
+
+Command-line interface wrapper for IFlowthruService.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.CatalogOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.CatalogOptions.md
new file mode 100644
index 00000000..2070ff44
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.CatalogOptions.md
@@ -0,0 +1,88 @@
+# <a id="Flowthru_Configuration_CatalogOptions"></a> Class CatalogOptions
+
+Namespace: [Flowthru.Configuration](Flowthru.Configuration.md)  
+Assembly: Flowthru.Core.dll  
+
+Configuration options for data catalog construction.
+
+```csharp
+public class CatalogOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[CatalogOptions](Flowthru.Configuration.CatalogOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Properties
+
+### <a id="Flowthru_Configuration_CatalogOptions_BasePath"></a> BasePath
+
+Base path for dataset files (common constructor parameter).
+
+```csharp
+public string? BasePath { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Configuration_CatalogOptions_ConnectionString"></a> ConnectionString
+
+Connection string for database catalogs (common constructor parameter).
+
+```csharp
+public string? ConnectionString { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Configuration_CatalogOptions_ConstructorArgs"></a> ConstructorArgs
+
+Constructor arguments for the catalog (mapped to constructor parameters by name).
+
+```csharp
+public Dictionary<string, object> ConstructorArgs { get; set; }
+```
+
+#### Property Value
+
+ [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [object](https://learn.microsoft.com/dotnet/api/system.object)\>
+
+### <a id="Flowthru_Configuration_CatalogOptions_Environment"></a> Environment
+
+Environment-specific catalog configuration (e.g., local vs. remote).
+
+```csharp
+public string? Environment { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Configuration_CatalogOptions_Type"></a> Type
+
+The fully-qualified type name of the catalog class (e.g., "MyApp.Data.MyCatalog").
+
+```csharp
+public string? Type { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.ConfigurationExtensions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.ConfigurationExtensions.md
new file mode 100644
index 00000000..ed6be21f
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.ConfigurationExtensions.md
@@ -0,0 +1,100 @@
+# <a id="Flowthru_Configuration_ConfigurationExtensions"></a> Class ConfigurationExtensions
+
+Namespace: [Flowthru.Configuration](Flowthru.Configuration.md)  
+Assembly: Flowthru.Core.dll  
+
+Extension methods for configuration-related operations.
+
+```csharp
+public static class ConfigurationExtensions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ConfigurationExtensions](Flowthru.Configuration.ConfigurationExtensions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Flowthru_Configuration_ConfigurationExtensions_GetValidated__1_Microsoft_Extensions_Configuration_IConfiguration_System_String_"></a> GetValidated<T\>\(IConfiguration, string\)
+
+Binds a configuration section to a strongly-typed object and validates it.
+
+```csharp
+public static T GetValidated<T>(this IConfiguration configuration, string sectionPath) where T : new()
+```
+
+#### Parameters
+
+`configuration` [IConfiguration](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.iconfiguration)
+
+The configuration instance
+
+`sectionPath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+The configuration section path (e.g., "DataScience:ModelParams")
+
+#### Returns
+
+ T
+
+The bound and validated object
+
+#### Type Parameters
+
+`T` 
+
+The type to bind to
+
+#### Exceptions
+
+ [ValidationException](https://learn.microsoft.com/dotnet/api/system.componentmodel.dataannotations.validationexception)
+
+Thrown if DataAnnotations validation fails
+
+### <a id="Flowthru_Configuration_ConfigurationExtensions_GetValidatedOrDefault__1_Microsoft_Extensions_Configuration_IConfiguration_System_String_"></a> GetValidatedOrDefault<T\>\(IConfiguration, string\)
+
+Attempts to bind and validate a configuration section, returning null if not found.
+
+```csharp
+public static T? GetValidatedOrDefault<T>(this IConfiguration configuration, string sectionPath) where T : class, new()
+```
+
+#### Parameters
+
+`configuration` [IConfiguration](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.iconfiguration)
+
+The configuration instance
+
+`sectionPath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+The configuration section path
+
+#### Returns
+
+ T?
+
+The bound and validated object, or null if section doesn't exist
+
+#### Type Parameters
+
+`T` 
+
+The type to bind to
+
+#### Exceptions
+
+ [ValidationException](https://learn.microsoft.com/dotnet/api/system.componentmodel.dataannotations.validationexception)
+
+Thrown if DataAnnotations validation fails
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.FlowOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.FlowOptions.md
new file mode 100644
index 00000000..20739fa7
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.FlowOptions.md
@@ -0,0 +1,90 @@
+# <a id="Flowthru_Configuration_FlowOptions"></a> Class FlowOptions
+
+Namespace: [Flowthru.Configuration](Flowthru.Configuration.md)  
+Assembly: Flowthru.Core.dll  
+
+Configuration options for a single flow.
+
+```csharp
+public class FlowOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowOptions](Flowthru.Configuration.FlowOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Properties
+
+### <a id="Flowthru_Configuration_FlowOptions_Description"></a> Description
+
+Human-readable description of the Flow.
+
+```csharp
+public string? Description { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Configuration_FlowOptions_FactoryMethod"></a> FactoryMethod
+
+The name of the static factory method (default: "Create").
+
+```csharp
+public string FactoryMethod { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Configuration_FlowOptions_Parameters"></a> Parameters
+
+Flow-specific parameters (nested configuration section).
+The structure must match the Flow's parameter type.
+
+```csharp
+public Dictionary<string, object>? Parameters { get; set; }
+```
+
+#### Property Value
+
+ [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [object](https://learn.microsoft.com/dotnet/api/system.object)\>?
+
+### <a id="Flowthru_Configuration_FlowOptions_Type"></a> Type
+
+The fully-qualified type name of the flow factory class.
+Must have a static Create method that accepts (catalog, parameters?).
+
+```csharp
+public string? Type { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Configuration_FlowOptions_Validation"></a> Validation
+
+Validation configuration for this flow.
+
+```csharp
+public FlowValidationOptions? Validation { get; set; }
+```
+
+#### Property Value
+
+ [FlowValidationOptions](Flowthru.Configuration.FlowValidationOptions.md)?
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.FlowValidationOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.FlowValidationOptions.md
new file mode 100644
index 00000000..d69c5704
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.FlowValidationOptions.md
@@ -0,0 +1,53 @@
+# <a id="Flowthru_Configuration_FlowValidationOptions"></a> Class FlowValidationOptions
+
+Namespace: [Flowthru.Configuration](Flowthru.Configuration.md)  
+Assembly: Flowthru.Core.dll  
+
+Configuration options for flow validation behavior.
+
+```csharp
+public class FlowValidationOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowValidationOptions](Flowthru.Configuration.FlowValidationOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Properties
+
+### <a id="Flowthru_Configuration_FlowValidationOptions_DefaultInspectionLevel"></a> DefaultInspectionLevel
+
+Default inspection level for all Layer 0 inputs.
+
+```csharp
+public string? DefaultInspectionLevel { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Configuration_FlowValidationOptions_InspectionLevels"></a> InspectionLevels
+
+Per-catalog-entry inspection level overrides.
+Key: catalog entry key, Value: inspection level (None, Shallow, Deep).
+
+```csharp
+public Dictionary<string, string> InspectionLevels { get; set; }
+```
+
+#### Property Value
+
+ [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.FlowthruConfigurationOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.FlowthruConfigurationOptions.md
new file mode 100644
index 00000000..a42213ef
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.FlowthruConfigurationOptions.md
@@ -0,0 +1,231 @@
+# <a id="Flowthru_Configuration_FlowthruConfigurationOptions"></a> Class FlowthruConfigurationOptions
+
+Namespace: [Flowthru.Configuration](Flowthru.Configuration.md)  
+Assembly: Flowthru.Core.dll  
+
+Options for configuring how Flowthru loads configuration files.
+
+```csharp
+public class FlowthruConfigurationOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowthruConfigurationOptions](Flowthru.Configuration.FlowthruConfigurationOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+Flowthru uses Microsoft.Extensions.Configuration with layered configuration files.
+By default, configuration is loaded in the following order (later files override earlier):
+</p>
+<ol><li><code>appsettings.json</code> - Base configuration (required)</li><li><code>appsettings.{Environment}.json</code> - Environment-specific overrides (optional)</li><li><code>appsettings.Local.json</code> - Local/user-specific overrides (optional, gitignored)</li></ol>
+<p>
+Both JSON and YAML formats are supported. YAML files follow the same pattern:
+<code>appsettings.yml</code>, <code>appsettings.{Environment}.yml</code>, <code>appsettings.Local.yml</code>
+</p>
+
+## Properties
+
+### <a id="Flowthru_Configuration_FlowthruConfigurationOptions_ConfigurationFileName"></a> ConfigurationFileName
+
+The base filename for configuration files (without extension).
+
+```csharp
+public string ConfigurationFileName { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Defaults to "appsettings". Change this to use a different naming convention
+(e.g., "parameters" to match Kedro's convention).
+
+### <a id="Flowthru_Configuration_FlowthruConfigurationOptions_ConfigurationPath"></a> ConfigurationPath
+
+The base path where configuration files are located.
+
+```csharp
+public string ConfigurationPath { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Defaults to the current directory. Can be set to "conf" for Kedro-style projects
+or any other directory containing configuration files.
+
+### <a id="Flowthru_Configuration_FlowthruConfigurationOptions_EnableYamlSupport"></a> EnableYamlSupport
+
+Whether to support YAML configuration files in addition to JSON.
+
+```csharp
+public bool EnableYamlSupport { get; set; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+When enabled, Flowthru will load both .json and .yml/.yaml files.
+Requires NetEscapades.Configuration.Yaml package.
+Defaults to true for Kedro compatibility.
+
+### <a id="Flowthru_Configuration_FlowthruConfigurationOptions_Environment"></a> Environment
+
+The environment name used to load environment-specific configuration files.
+
+```csharp
+public string? Environment { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Remarks
+
+<p>
+If not explicitly set, Flowthru will attempt to resolve the environment in this order:
+</p>
+<ol><li>Value passed to <code>WithEnvironment()</code></li><li>Environment variable specified by <xref href="Flowthru.Configuration.FlowthruConfigurationOptions.EnvironmentVariable" data-throw-if-not-resolved="false"></xref></li><li><code>DOTNET_ENVIRONMENT</code> environment variable</li><li><code>ASPNETCORE_ENVIRONMENT</code> environment variable</li><li>"Production" (default)</li></ol>
+
+### <a id="Flowthru_Configuration_FlowthruConfigurationOptions_EnvironmentVariable"></a> EnvironmentVariable
+
+The name of the environment variable to check for environment name.
+
+```csharp
+public string? EnvironmentVariable { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Remarks
+
+Defaults to "FLOWTHRU_ENV". Set to null to disable environment variable resolution.
+Standard .NET environment variables (DOTNET_ENVIRONMENT, ASPNETCORE_ENVIRONMENT)
+are always checked as fallbacks.
+
+## Methods
+
+### <a id="Flowthru_Configuration_FlowthruConfigurationOptions_WithConfigurationFileName_System_String_"></a> WithConfigurationFileName\(string\)
+
+Sets the base filename for configuration files (without extension).
+
+```csharp
+public FlowthruConfigurationOptions WithConfigurationFileName(string fileName)
+```
+
+#### Parameters
+
+`fileName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+The base filename (e.g., "parameters", "config")
+
+#### Returns
+
+ [FlowthruConfigurationOptions](Flowthru.Configuration.FlowthruConfigurationOptions.md)
+
+This options instance for fluent chaining
+
+### <a id="Flowthru_Configuration_FlowthruConfigurationOptions_WithConfigurationPath_System_String_"></a> WithConfigurationPath\(string\)
+
+Sets the base path where configuration files are located.
+
+```csharp
+public FlowthruConfigurationOptions WithConfigurationPath(string path)
+```
+
+#### Parameters
+
+`path` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+The configuration directory path
+
+#### Returns
+
+ [FlowthruConfigurationOptions](Flowthru.Configuration.FlowthruConfigurationOptions.md)
+
+This options instance for fluent chaining
+
+### <a id="Flowthru_Configuration_FlowthruConfigurationOptions_WithEnvironment_System_String_"></a> WithEnvironment\(string\)
+
+Sets the environment name explicitly.
+
+```csharp
+public FlowthruConfigurationOptions WithEnvironment(string environment)
+```
+
+#### Parameters
+
+`environment` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+The environment name (e.g., "Development", "Production")
+
+#### Returns
+
+ [FlowthruConfigurationOptions](Flowthru.Configuration.FlowthruConfigurationOptions.md)
+
+This options instance for fluent chaining
+
+### <a id="Flowthru_Configuration_FlowthruConfigurationOptions_WithEnvironmentVariable_System_String_"></a> WithEnvironmentVariable\(string?\)
+
+Sets the environment variable name to check for environment resolution.
+
+```csharp
+public FlowthruConfigurationOptions WithEnvironmentVariable(string? variableName)
+```
+
+#### Parameters
+
+`variableName` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+The environment variable name
+
+#### Returns
+
+ [FlowthruConfigurationOptions](Flowthru.Configuration.FlowthruConfigurationOptions.md)
+
+This options instance for fluent chaining
+
+### <a id="Flowthru_Configuration_FlowthruConfigurationOptions_WithYamlSupport_System_Boolean_"></a> WithYamlSupport\(bool\)
+
+Enables or disables YAML configuration file support.
+
+```csharp
+public FlowthruConfigurationOptions WithYamlSupport(bool enabled = true)
+```
+
+#### Parameters
+
+`enabled` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+Whether to enable YAML support
+
+#### Returns
+
+ [FlowthruConfigurationOptions](Flowthru.Configuration.FlowthruConfigurationOptions.md)
+
+This options instance for fluent chaining
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.FlowthruOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.FlowthruOptions.md
new file mode 100644
index 00000000..94e0a292
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.FlowthruOptions.md
@@ -0,0 +1,95 @@
+# <a id="Flowthru_Configuration_FlowthruOptions"></a> Class FlowthruOptions
+
+Namespace: [Flowthru.Configuration](Flowthru.Configuration.md)  
+Assembly: Flowthru.Core.dll  
+
+Root configuration options for Flowthru applications.
+
+```csharp
+public class FlowthruOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowthruOptions](Flowthru.Configuration.FlowthruOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+This class represents the top-level "Flowthru" section in configuration files.
+All Flowthru-specific configuration should be nested under this section.
+
+## Fields
+
+### <a id="Flowthru_Configuration_FlowthruOptions_SectionName"></a> SectionName
+
+Configuration section name in appsettings.json.
+
+```csharp
+public const string SectionName = "Flowthru"
+```
+
+#### Field Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+## Properties
+
+### <a id="Flowthru_Configuration_FlowthruOptions_Catalog"></a> Catalog
+
+Data catalog configuration.
+
+```csharp
+public CatalogOptions Catalog { get; set; }
+```
+
+#### Property Value
+
+ [CatalogOptions](Flowthru.Configuration.CatalogOptions.md)
+
+### <a id="Flowthru_Configuration_FlowthruOptions_Flows"></a> Flows
+
+Flow registration and configuration.
+
+```csharp
+public Dictionary<string, FlowOptions> Flows { get; set; }
+```
+
+#### Property Value
+
+ [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [FlowOptions](Flowthru.Configuration.FlowOptions.md)\>
+
+### <a id="Flowthru_Configuration_FlowthruOptions_Logging"></a> Logging
+
+Logging configuration (extends standard .NET logging configuration).
+
+```csharp
+public LoggingOptions? Logging { get; set; }
+```
+
+#### Property Value
+
+ [LoggingOptions](Flowthru.Configuration.LoggingOptions.md)?
+
+### <a id="Flowthru_Configuration_FlowthruOptions_Metadata"></a> Metadata
+
+Metadata collection and export configuration.
+
+```csharp
+public MetadataOptions Metadata { get; set; }
+```
+
+#### Property Value
+
+ [MetadataOptions](Flowthru.Configuration.MetadataOptions.md)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.ICatalogFactory.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.ICatalogFactory.md
new file mode 100644
index 00000000..f8d7085b
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.ICatalogFactory.md
@@ -0,0 +1,43 @@
+# <a id="Flowthru_Configuration_ICatalogFactory"></a> Interface ICatalogFactory
+
+Namespace: [Flowthru.Configuration](Flowthru.Configuration.md)  
+Assembly: Flowthru.Core.dll  
+
+Factory interface for creating data catalog instances from configuration.
+
+```csharp
+public interface ICatalogFactory
+```
+
+## Remarks
+
+Implement this interface to enable configuration-based catalog construction.
+The factory receives the full configuration and can use it to construct
+environment-specific catalogs (e.g., local files in dev, remote DB in prod).
+
+## Methods
+
+### <a id="Flowthru_Configuration_ICatalogFactory_CreateCatalog_Flowthru_Configuration_CatalogOptions_System_IServiceProvider_"></a> CreateCatalog\(CatalogOptions, IServiceProvider\)
+
+Creates a catalog instance based on configuration.
+
+```csharp
+CatalogAbstract CreateCatalog(CatalogOptions options, IServiceProvider serviceProvider)
+```
+
+#### Parameters
+
+`options` [CatalogOptions](Flowthru.Configuration.CatalogOptions.md)
+
+Catalog configuration options
+
+`serviceProvider` [IServiceProvider](https://learn.microsoft.com/dotnet/api/system.iserviceprovider)
+
+Service provider for dependency injection
+
+#### Returns
+
+ [CatalogAbstract](Flowthru.Data.CatalogAbstract.md)
+
+The configured catalog instance
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.JsonMetadataOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.JsonMetadataOptions.md
new file mode 100644
index 00000000..410b24c8
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.JsonMetadataOptions.md
@@ -0,0 +1,52 @@
+# <a id="Flowthru_Configuration_JsonMetadataOptions"></a> Class JsonMetadataOptions
+
+Namespace: [Flowthru.Configuration](Flowthru.Configuration.md)  
+Assembly: Flowthru.Core.dll  
+
+Configuration options for JSON metadata export.
+
+```csharp
+public class JsonMetadataOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[JsonMetadataOptions](Flowthru.Configuration.JsonMetadataOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Properties
+
+### <a id="Flowthru_Configuration_JsonMetadataOptions_IncludeTypeInfo"></a> IncludeTypeInfo
+
+Whether to include full type information in the export.
+
+```csharp
+public bool IncludeTypeInfo { get; set; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Configuration_JsonMetadataOptions_UseCompactFormat"></a> UseCompactFormat
+
+Whether to use compact (minified) JSON format.
+
+```csharp
+public bool UseCompactFormat { get; set; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.LoggingOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.LoggingOptions.md
new file mode 100644
index 00000000..8cc85225
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.LoggingOptions.md
@@ -0,0 +1,64 @@
+# <a id="Flowthru_Configuration_LoggingOptions"></a> Class LoggingOptions
+
+Namespace: [Flowthru.Configuration](Flowthru.Configuration.md)  
+Assembly: Flowthru.Core.dll  
+
+Logging configuration options (extends standard .NET logging).
+
+```csharp
+public class LoggingOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[LoggingOptions](Flowthru.Configuration.LoggingOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Properties
+
+### <a id="Flowthru_Configuration_LoggingOptions_EnableConsole"></a> EnableConsole
+
+Whether console logging is enabled.
+
+```csharp
+public bool EnableConsole { get; set; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Configuration_LoggingOptions_LogLevel"></a> LogLevel
+
+Per-category log level overrides.
+
+```csharp
+public Dictionary<string, string> LogLevel { get; set; }
+```
+
+#### Property Value
+
+ [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+### <a id="Flowthru_Configuration_LoggingOptions_MinimumLevel"></a> MinimumLevel
+
+Minimum log level (Trace, Debug, Information, Warning, Error, Critical).
+
+```csharp
+public string MinimumLevel { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.MermaidMetadataOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.MermaidMetadataOptions.md
new file mode 100644
index 00000000..9cd9b6e8
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.MermaidMetadataOptions.md
@@ -0,0 +1,98 @@
+# <a id="Flowthru_Configuration_MermaidMetadataOptions"></a> Class MermaidMetadataOptions
+
+Namespace: [Flowthru.Configuration](Flowthru.Configuration.md)  
+Assembly: Flowthru.Core.dll  
+
+Configuration options for Mermaid diagram export.
+
+```csharp
+public class MermaidMetadataOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[MermaidMetadataOptions](Flowthru.Configuration.MermaidMetadataOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Properties
+
+### <a id="Flowthru_Configuration_MermaidMetadataOptions_ActiveDataColor"></a> ActiveDataColor
+
+Hex color code for active (sliced) catalog entries.
+
+```csharp
+public string ActiveDataColor { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Color applied to data catalog entries produced by sliced nodes.
+Default: #2E7D32 (Material Design green-800).
+
+### <a id="Flowthru_Configuration_MermaidMetadataOptions_ActiveStepColor"></a> ActiveStepColor
+
+Hex color code for active (sliced) nodes.
+
+```csharp
+public string ActiveStepColor { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Color applied to nodes that are in the execution slice.
+Default: #2E7D32 (Material Design green-800).
+
+### <a id="Flowthru_Configuration_MermaidMetadataOptions_Direction"></a> Direction
+
+Flowchart direction (TopToBottom, LeftToRight, etc.).
+
+```csharp
+public string Direction { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Configuration_MermaidMetadataOptions_ShowDatasetDetails"></a> ShowDatasetDetails
+
+Whether to include dataset details in nodes.
+
+```csharp
+public bool ShowDatasetDetails { get; set; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Configuration_MermaidMetadataOptions_ShowParameters"></a> ShowParameters
+
+Whether to include parameter information in nodes.
+
+```csharp
+public bool ShowParameters { get; set; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.MetadataOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.MetadataOptions.md
new file mode 100644
index 00000000..1769439b
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.MetadataOptions.md
@@ -0,0 +1,130 @@
+# <a id="Flowthru_Configuration_MetadataOptions"></a> Class MetadataOptions
+
+Namespace: [Flowthru.Configuration](Flowthru.Configuration.md)  
+Assembly: Flowthru.Core.dll  
+
+Configuration options for metadata collection and export.
+
+```csharp
+public class MetadataOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[MetadataOptions](Flowthru.Configuration.MetadataOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Properties
+
+### <a id="Flowthru_Configuration_MetadataOptions_Enabled"></a> Enabled
+
+Whether metadata collection is enabled.
+
+```csharp
+public bool Enabled { get; set; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Configuration_MetadataOptions_FilenameTemplate"></a> FilenameTemplate
+
+Filename template for metadata exports.
+
+```csharp
+public string FilenameTemplate { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+<p>
+Supports dynamic tokens that are replaced during export:
+</p>
+<ul><li><code>{FlowName}</code> - Sanitized flow name</li><li><code>{Timestamp}</code> - Formatted timestamp (empty if disabled in Timestamp.IncludeTimestamp)</li><li><code>{SliceType}</code> - "FromNodes", "Tags", "Mixed", or empty if unsliced</li><li><code>{FromNodes}</code> - Comma-separated list of from-nodes</li><li><code>{ToNodes}</code> - Comma-separated list of to-nodes</li><li><code>{FromInputs}</code> - Comma-separated list of from-inputs</li><li><code>{OnlyNodes}</code> - Comma-separated list of only-nodes</li><li><code>{Tags}</code> - Comma-separated list of tags</li></ul>
+<p>
+Empty tokens are automatically collapsed to prevent double-separators.
+File extensions are added by individual providers (.json, .md, etc.).
+</p>
+<p>
+<strong>Default:</strong> <code>"dag-{FlowName}-{Timestamp}-{SliceType}"</code>
+</p>
+<p>
+<strong>Examples:</strong>
+</p>
+<ul><li>Unsliced: <code>dag-DataProcessing-20260304-153045.json</code></li><li>Sliced: <code>dag-DataProcessing-20260304-153045-FromNodes.json</code></li></ul>
+
+### <a id="Flowthru_Configuration_MetadataOptions_Json"></a> Json
+
+Configuration specific to the JSON metadata provider.
+
+```csharp
+public JsonMetadataOptions? Json { get; set; }
+```
+
+#### Property Value
+
+ [JsonMetadataOptions](Flowthru.Configuration.JsonMetadataOptions.md)?
+
+### <a id="Flowthru_Configuration_MetadataOptions_Mermaid"></a> Mermaid
+
+Configuration specific to the Mermaid metadata provider.
+
+```csharp
+public MermaidMetadataOptions? Mermaid { get; set; }
+```
+
+#### Property Value
+
+ [MermaidMetadataOptions](Flowthru.Configuration.MermaidMetadataOptions.md)?
+
+### <a id="Flowthru_Configuration_MetadataOptions_OutputDirectory"></a> OutputDirectory
+
+Directory where metadata files will be written.
+
+```csharp
+public string OutputDirectory { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Configuration_MetadataOptions_Providers"></a> Providers
+
+List of metadata providers to enable (e.g., "Json", "Mermaid", "Csv").
+
+```csharp
+public List<string> Providers { get; set; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+### <a id="Flowthru_Configuration_MetadataOptions_Timestamp"></a> Timestamp
+
+Configuration for timestamp generation in metadata filenames.
+
+```csharp
+public TimestampConfiguration Timestamp { get; set; }
+```
+
+#### Property Value
+
+ [TimestampConfiguration](Flowthru.Configuration.TimestampConfiguration.md)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.PipelineOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.PipelineOptions.md
new file mode 100644
index 00000000..b04d7da1
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.PipelineOptions.md
@@ -0,0 +1,90 @@
+# <a id="Flowthru_Configuration_PipelineOptions"></a> Class PipelineOptions
+
+Namespace: [Flowthru.Configuration](Flowthru.Configuration.md)  
+Assembly: Flowthru.Core.dll  
+
+Configuration options for a single pipeline.
+
+```csharp
+public class PipelineOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PipelineOptions](Flowthru.Configuration.PipelineOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Properties
+
+### <a id="Flowthru_Configuration_PipelineOptions_Description"></a> Description
+
+Human-readable description of the pipeline.
+
+```csharp
+public string? Description { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Configuration_PipelineOptions_FactoryMethod"></a> FactoryMethod
+
+The name of the static factory method (default: "Create").
+
+```csharp
+public string FactoryMethod { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Configuration_PipelineOptions_Parameters"></a> Parameters
+
+Pipeline-specific parameters (nested configuration section).
+The structure must match the pipeline's parameter type.
+
+```csharp
+public Dictionary<string, object>? Parameters { get; set; }
+```
+
+#### Property Value
+
+ [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [object](https://learn.microsoft.com/dotnet/api/system.object)\>?
+
+### <a id="Flowthru_Configuration_PipelineOptions_Type"></a> Type
+
+The fully-qualified type name of the pipeline factory class.
+Must have a static Create method that accepts (catalog, parameters?).
+
+```csharp
+public string? Type { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Configuration_PipelineOptions_Validation"></a> Validation
+
+Validation configuration for this pipeline.
+
+```csharp
+public PipelineValidationOptions? Validation { get; set; }
+```
+
+#### Property Value
+
+ [PipelineValidationOptions](Flowthru.Configuration.PipelineValidationOptions.md)?
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.PipelineValidationOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.PipelineValidationOptions.md
new file mode 100644
index 00000000..cd4c4980
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.PipelineValidationOptions.md
@@ -0,0 +1,53 @@
+# <a id="Flowthru_Configuration_PipelineValidationOptions"></a> Class PipelineValidationOptions
+
+Namespace: [Flowthru.Configuration](Flowthru.Configuration.md)  
+Assembly: Flowthru.Core.dll  
+
+Configuration options for pipeline validation behavior.
+
+```csharp
+public class PipelineValidationOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PipelineValidationOptions](Flowthru.Configuration.PipelineValidationOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Properties
+
+### <a id="Flowthru_Configuration_PipelineValidationOptions_DefaultInspectionLevel"></a> DefaultInspectionLevel
+
+Default inspection level for all Layer 0 inputs.
+
+```csharp
+public string? DefaultInspectionLevel { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Configuration_PipelineValidationOptions_InspectionLevels"></a> InspectionLevels
+
+Per-catalog-entry inspection level overrides.
+Key: catalog entry key, Value: inspection level (None, Shallow, Deep).
+
+```csharp
+public Dictionary<string, string> InspectionLevels { get; set; }
+```
+
+#### Property Value
+
+ [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.TimestampConfiguration.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.TimestampConfiguration.md
new file mode 100644
index 00000000..27d406e4
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.TimestampConfiguration.md
@@ -0,0 +1,64 @@
+# <a id="Flowthru_Configuration_TimestampConfiguration"></a> Class TimestampConfiguration
+
+Namespace: [Flowthru.Configuration](Flowthru.Configuration.md)  
+Assembly: Flowthru.Core.dll  
+
+Configuration for timestamp generation in metadata filenames.
+
+```csharp
+public class TimestampConfiguration
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[TimestampConfiguration](Flowthru.Configuration.TimestampConfiguration.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Properties
+
+### <a id="Flowthru_Configuration_TimestampConfiguration_Format"></a> Format
+
+Timestamp format string (see .NET DateTime formatting).
+
+```csharp
+public string Format { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Configuration_TimestampConfiguration_IncludeTimestamp"></a> IncludeTimestamp
+
+Whether to include a timestamp in the filename.
+
+```csharp
+public bool IncludeTimestamp { get; set; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Configuration_TimestampConfiguration_TimeZone"></a> TimeZone
+
+Time zone for the timestamp (e.g., "UTC", "Local").
+
+```csharp
+public string TimeZone { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.md
new file mode 100644
index 00000000..b8cd4260
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Configuration.md
@@ -0,0 +1,54 @@
+# <a id="Flowthru_Configuration"></a> Namespace Flowthru.Configuration
+
+### Classes
+
+ [CatalogOptions](Flowthru.Configuration.CatalogOptions.md)
+
+Configuration options for data catalog construction.
+
+ [ConfigurationExtensions](Flowthru.Configuration.ConfigurationExtensions.md)
+
+Extension methods for configuration-related operations.
+
+ [FlowOptions](Flowthru.Configuration.FlowOptions.md)
+
+Configuration options for a single flow.
+
+ [FlowValidationOptions](Flowthru.Configuration.FlowValidationOptions.md)
+
+Configuration options for flow validation behavior.
+
+ [FlowthruConfigurationOptions](Flowthru.Configuration.FlowthruConfigurationOptions.md)
+
+Options for configuring how Flowthru loads configuration files.
+
+ [FlowthruOptions](Flowthru.Configuration.FlowthruOptions.md)
+
+Root configuration options for Flowthru applications.
+
+ [JsonMetadataOptions](Flowthru.Configuration.JsonMetadataOptions.md)
+
+Configuration options for JSON metadata export.
+
+ [LoggingOptions](Flowthru.Configuration.LoggingOptions.md)
+
+Logging configuration options (extends standard .NET logging).
+
+ [MermaidMetadataOptions](Flowthru.Configuration.MermaidMetadataOptions.md)
+
+Configuration options for Mermaid diagram export.
+
+ [MetadataOptions](Flowthru.Configuration.MetadataOptions.md)
+
+Configuration options for metadata collection and export.
+
+ [TimestampConfiguration](Flowthru.Configuration.TimestampConfiguration.md)
+
+Configuration for timestamp generation in metadata filenames.
+
+### Interfaces
+
+ [ICatalogFactory](Flowthru.Configuration.ICatalogFactory.md)
+
+Factory interface for creating data catalog instances from configuration.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Capabilities.StorageTraits.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Capabilities.StorageTraits.md
new file mode 100644
index 00000000..39753a89
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Capabilities.StorageTraits.md
@@ -0,0 +1,224 @@
+# <a id="Flowthru_Data_Capabilities_StorageTraits"></a> Class StorageTraits
+
+Namespace: [Flowthru.Data.Capabilities](Flowthru.Data.Capabilities.md)  
+Assembly: Flowthru.Core.dll  
+
+Describes the structural constraints and capabilities of a storage implementation.
+Defaults represent filesystem-file baseline behavior.
+
+```csharp
+public record StorageTraits : IEquatable<StorageTraits>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+#### Implements
+
+[IEquatable<StorageTraits\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Design Philosophy:</strong>
+</p>
+<p>
+A filesystem file is the median storage mechanism — the "zero" from which we measure deviations.
+A <strong>constraint</strong> narrows from this baseline (e.g., read-only, non-persistent, non-inspectable).
+A <strong>capability</strong> widens beyond it (e.g., streamable, appendable, transactional).
+</p>
+<p>
+<strong>Constraint Examples:</strong>
+</p>
+<ul><li><strong>Read-only sources:</strong> HTTP GET endpoints, Excel files, database views — set <code>CanWrite = false</code></li><li><strong>Write-only sinks:</strong> Logging endpoints, append-only audit tables — set <code>CanRead = false</code></li><li><strong>Non-inspectable:</strong> Remote sources that can't be sampled cheaply — set <code>CanInspect = false</code></li><li><strong>Non-persistent:</strong> In-memory caches, temporary buffers — set <code>IsPersistent = false</code></li><li><strong>Network-dependent:</strong> Remote databases, S3, HTTP — set <code>RequiresNetwork = true</code></li></ul>
+<p>
+<strong>Capability Examples:</strong>
+</p>
+<ul><li><strong>Streamable:</strong> CSV files, database queries, Parquet — set <code>CanStream = true</code></li><li><strong>Appendable:</strong> Log files, Spark SaveMode.Append, append-only tables — set <code>CanAppend = true</code></li><li><strong>Transactional:</strong> Database writes, ACID-compliant stores — set <code>IsTransactional = true</code></li></ul>
+<p>
+<strong>Two-Level Constraint Model:</strong>
+</p>
+<p>
+Traits are declared at two levels:
+</p>
+<ul><li><strong>Adapter level:</strong> The adapter author declares what the storage medium intrinsically supports.
+These are structural truths (e.g., an HTTP GET endpoint cannot write).</li><li><strong>Catalog level:</strong> The pipeline author can further constrain an adapter using <code>Item.Constrain()</code>.
+Constraints can only tighten, never loosen (one-way ratchet).</li></ul>
+<p>
+<strong>Usage in Adapters:</strong>
+</p>
+<pre><code class="lang-csharp">public sealed class EFCoreStorageAdapter&lt;T&gt; : IStorageAdapter&lt;IEnumerable&lt;T&gt;&gt;
+{
+    public StorageTraits Traits { get; }
+
+    public EFCoreStorageAdapter(DbContext context, bool readOnly = false)
+    {
+        Traits = new StorageTraits
+        {
+            CanWrite = !readOnly,
+            RequiresNetwork = true,
+            IsTransactional = true,
+            CanStream = true,
+        };
+    }
+}</code></pre>
+<p>
+<strong>Usage in Catalogs:</strong>
+</p>
+<pre><code class="lang-csharp">public IItem&lt;IEnumerable&lt;Company&gt;&gt; ReferenceData =&gt;
+    GetOrCreateEntry(() =&gt; Items.Enumerable.Csv&lt;Company&gt;(
+        "ref_data", $"{_basePath}/reference.csv")
+        .Constrain(t =&gt; t with { CanWrite = false }));</code></pre>
+
+## Properties
+
+### <a id="Flowthru_Data_Capabilities_StorageTraits_CanAppend"></a> CanAppend
+
+Can data be appended without replacing existing data?
+
+```csharp
+public bool CanAppend { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+Default: <code>false</code> (filesystem file writes typically overwrite).
+Set to <code>true</code> for append-only logs, Spark SaveMode.Append, incremental tables.
+
+### <a id="Flowthru_Data_Capabilities_StorageTraits_CanInspect"></a> CanInspect
+
+Can the source be inspected for pre-flight validation?
+
+```csharp
+public bool CanInspect { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+Default: <code>true</code> (filesystem files can be sampled).
+Set to <code>false</code> for sources that are expensive to validate (remote HTTP, distributed Spark).
+
+### <a id="Flowthru_Data_Capabilities_StorageTraits_CanRead"></a> CanRead
+
+Can data be read from this source?
+
+```csharp
+public bool CanRead { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+Default: <code>true</code> (filesystem files are readable).
+Set to <code>false</code> for write-only sinks (logging endpoints, audit tables).
+
+### <a id="Flowthru_Data_Capabilities_StorageTraits_CanStream"></a> CanStream
+
+Can data be lazily streamed without full materialization?
+
+```csharp
+public bool CanStream { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+Default: <code>false</code> (filesystem file I/O typically buffers).
+Set to <code>true</code> for CSV streaming, database cursors, Parquet row groups.
+Enables memory-efficient processing of large datasets.
+
+### <a id="Flowthru_Data_Capabilities_StorageTraits_CanWrite"></a> CanWrite
+
+Can data be written to this source?
+
+```csharp
+public bool CanWrite { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+Default: <code>true</code> (filesystem files are writable).
+Set to <code>false</code> for read-only sources (HTTP GET, Excel files, database views).
+
+### <a id="Flowthru_Data_Capabilities_StorageTraits_IsPersistent"></a> IsPersistent
+
+Does data survive across pipeline runs?
+
+```csharp
+public bool IsPersistent { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+Default: <code>true</code> (filesystem files persist).
+Set to <code>false</code> for in-memory caches, temporary buffers, or transient state.
+
+### <a id="Flowthru_Data_Capabilities_StorageTraits_IsTransactional"></a> IsTransactional
+
+Are writes atomic (all-or-nothing)?
+
+```csharp
+public bool IsTransactional { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+Default: <code>false</code> (filesystem file writes are not ACID).
+Set to <code>true</code> for database transactions, ACID-compliant stores.
+
+### <a id="Flowthru_Data_Capabilities_StorageTraits_RequiresNetwork"></a> RequiresNetwork
+
+Does this storage require network access?
+
+```csharp
+public bool RequiresNetwork { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+Default: <code>false</code> (filesystem files are local).
+Set to <code>true</code> for remote databases, S3, HTTP endpoints.
+Used for pre-flight validation in offline/CI environments.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Capabilities.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Capabilities.md
new file mode 100644
index 00000000..be13d989
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Capabilities.md
@@ -0,0 +1,9 @@
+# <a id="Flowthru_Data_Capabilities"></a> Namespace Flowthru.Data.Capabilities
+
+### Classes
+
+ [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+Describes the structural constraints and capabilities of a storage implementation.
+Defaults represent filesystem-file baseline behavior.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.CatalogAbstract.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.CatalogAbstract.md
new file mode 100644
index 00000000..94b36f3d
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.CatalogAbstract.md
@@ -0,0 +1,262 @@
+# <a id="Flowthru_Data_CatalogAbstract"></a> Class CatalogAbstract
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Core.dll  
+
+Base class for strongly-typed catalog implementations with automatic property caching.
+
+```csharp
+public abstract class CatalogAbstract
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[CatalogAbstract](Flowthru.Data.CatalogAbstract.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Problem Solved:</strong>
+Expression-bodied properties (<code>Property =&gt; new Item()</code>) create new instances on each access,
+breaking DAG dependency resolution which relies on object identity.
+</p>
+<p>
+<strong>Solution:</strong>
+Uses reflection to:
+1. Discover all IItem properties on derived classes
+2. Create backing fields to cache instances
+3. Intercept property getters to return cached instances
+</p>
+<p>
+<strong>Usage Pattern:</strong>
+<pre><code class="lang-csharp">public class MyCatalog : DataCatalogBase
+{
+    public MyCatalog(string basePath = "Data") : base()
+    {
+        BasePath = basePath;
+        InitializeCatalogProperties();
+    }
+
+    protected string BasePath { get; }
+
+    // Declare once - automatically cached!
+    public IItem&lt;IEnumerable&lt;MyData&gt;&gt; MyData =&gt;
+        CreateItem(() =&gt; new CsvCatalogItem&lt;MyData&gt;("my_data", $"{BasePath}/data.csv"));
+}</code></pre>
+</p>
+<p>
+<strong>Key Benefits:</strong>
+- Declare catalog items ONCE (no redundant constructor code)
+- Automatic instance caching (object identity preserved)
+- Type-safe (compile-time checks)
+- Zero runtime overhead after first access (cached delegates)
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_CatalogAbstract__ctor_System_String_"></a> CatalogAbstract\(string?\)
+
+```csharp
+protected CatalogAbstract(string? catalogLabel = null)
+```
+
+#### Parameters
+
+`catalogLabel` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+Optional display label for this catalog instance. When omitted, defaults to the
+concrete class name via <code>GetType().Name</code>.
+
+## Properties
+
+### <a id="Flowthru_Data_CatalogAbstract_CatalogLabel"></a> CatalogLabel
+
+The display label used to identify this catalog instance in flow metadata.
+Defaults to the concrete class name when not specified.
+
+```csharp
+public string CatalogLabel { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Pass an explicit label when constructing multiple instances of the same catalog type
+in a single flow (e.g., per-partition or per-shard catalogs) so their items
+receive distinct qualified identifiers in the DAG: <code>CatalogLabel.ItemLabel</code>.
+
+### <a id="Flowthru_Data_CatalogAbstract_Services"></a> Services
+
+Optional service provider for dependency injection into catalog items.
+
+```csharp
+public IServiceProvider? Services { get; set; }
+```
+
+#### Property Value
+
+ [IServiceProvider](https://learn.microsoft.com/dotnet/api/system.iserviceprovider)?
+
+#### Remarks
+
+Set by the service layer before flow execution to enable catalog
+items to resolve services (e.g., database connections, HTTP clients).
+
+## Methods
+
+### <a id="Flowthru_Data_CatalogAbstract_ClearCache"></a> ClearCache\(\)
+
+Clears the property cache. Use with caution!
+
+```csharp
+protected void ClearCache()
+```
+
+#### Remarks
+
+<p>
+<strong>Warning:</strong> Clearing the cache after flow construction will break
+DAG dependencies since new instances will be created on next access.
+</p>
+<p>
+<strong>Use Case:</strong> Primarily for testing scenarios where you need to reset
+catalog state between test runs.
+</p>
+
+### <a id="Flowthru_Data_CatalogAbstract_CreateItem__1_System_Func_Flowthru_Data_IItem___0___System_String_"></a> CreateItem<T\>\(Func<IItem<T\>\>, string\)
+
+Gets or creates a unified catalog item, caching it for subsequent accesses.
+
+```csharp
+protected IItem<T> CreateItem<T>(Func<IItem<T>> factory, string propertyName = "")
+```
+
+#### Parameters
+
+`factory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-1)<[IItem](Flowthru.Data.IItem\-1.md)<T\>\>
+
+Factory function to create the item on first access
+
+`propertyName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Auto-populated by compiler with calling property name
+
+#### Returns
+
+ [IItem](Flowthru.Data.IItem\-1.md)<T\>
+
+Cached catalog item instance
+
+#### Type Parameters
+
+`T` 
+
+The data type stored in this catalog item.
+For singletons: Use T directly (e.g., LinearRegressionModel)
+For collections: Use IEnumerable&lt;T&gt; (e.g., IEnumerable&lt;FeatureRow&gt;)
+
+#### Remarks
+
+<p>
+<strong>Unified API (v0.5.0):</strong> This single method replaces GetOrCreateObject
+and GetOrCreateDataset. Cardinality is determined by the type parameter T.
+</p>
+<p>
+<strong>Usage Examples:</strong>
+<pre><code class="lang-csharp">// Singleton object
+public IItem&lt;LinearRegressionModel&gt; Model =&gt;
+    GetOrCreateItem(() =&gt; Items.Single.Memory&lt;LinearRegressionModel&gt;("model"));
+
+// Collection
+public IItem&lt;IEnumerable&lt;FeatureRow&gt;&gt; Features =&gt;
+    GetOrCreateItem(() =&gt; Items.Enumerable.Csv&lt;FeatureRow&gt;("features", "data.csv"));</code></pre>
+</p>
+
+### <a id="Flowthru_Data_CatalogAbstract_CreateItem__1_System_Func_System_IServiceProvider_Flowthru_Data_IItem___0___System_String_"></a> CreateItem<T\>\(Func<IServiceProvider?, IItem<T\>\>, string\)
+
+Gets or creates a unified catalog item with service provider access.
+
+```csharp
+protected IItem<T> CreateItem<T>(Func<IServiceProvider?, IItem<T>> factory, string propertyName = "")
+```
+
+#### Parameters
+
+`factory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IServiceProvider](https://learn.microsoft.com/dotnet/api/system.iserviceprovider)?, [IItem](Flowthru.Data.IItem\-1.md)<T\>\>
+
+Factory function that receives service provider
+
+`propertyName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Auto-populated by compiler with calling property name
+
+#### Returns
+
+ [IItem](Flowthru.Data.IItem\-1.md)<T\>
+
+Cached catalog item instance
+
+#### Type Parameters
+
+`T` 
+
+The data type (singleton or collection)
+
+### <a id="Flowthru_Data_CatalogAbstract_GetAllItems"></a> GetAllItems\(\)
+
+Gets all cached catalog items.
+
+```csharp
+protected IEnumerable<IItem> GetAllItems()
+```
+
+#### Returns
+
+ [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<[IItem](Flowthru.Data.IItem.md)\>
+
+Enumerable of all initialized catalog items
+
+#### Remarks
+
+Useful for diagnostic purposes or when you need to iterate over all items
+(e.g., for validation, cleanup, or reporting).
+
+### <a id="Flowthru_Data_CatalogAbstract_InitializeCatalogProperties"></a> InitializeCatalogProperties\(\)
+
+Initializes all catalog item properties by invoking their getters once.
+
+```csharp
+protected void InitializeCatalogProperties()
+```
+
+#### Remarks
+
+<p>
+<strong>Purpose:</strong> Eager initialization ensures all items are cached
+before flow construction begins, preventing any potential race conditions
+or unexpected lazy initialization behavior.
+</p>
+<p>
+<strong>When to Call:</strong> At the end of the derived catalog's constructor,
+after all configuration properties (like BasePath) are set.
+</p>
+<p>
+<strong>How It Works:</strong>
+Uses reflection to find all public instance properties that return IItem,
+then invokes each getter once to populate the cache.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.CatalogEntries.Single.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.CatalogEntries.Single.md
new file mode 100644
index 00000000..427eb252
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.CatalogEntries.Single.md
@@ -0,0 +1,228 @@
+# <a id="Flowthru_Data_Items_Single"></a> Class Items.Single
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Core.dll  
+
+Factory methods for single (non-collection) values.
+
+```csharp
+public static class Items.Single
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[Items.Single](Flowthru.Data.Items.Single.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+These methods create catalog entries for single objects rather than collections.
+</p>
+<p>
+<strong>Use Cases:</strong>
+</p>
+<ul><li>Model files (ML models, configuration objects)</li><li>Metrics and evaluation results (single JSON objects)</li><li>Text reports (Markdown, plain text)</li><li>Binary files (images, PDFs)</li><li>Side-effect-only nodes (null/void semantics)</li></ul>
+
+## Methods
+
+### <a id="Flowthru_Data_Items_Single_Binary_System_String_System_String_"></a> Binary\(string, string\)
+
+Creates a binary file catalog entry.
+
+```csharp
+public static Item<byte[]> Binary(string label, string filePath)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to binary file (.png, .jpg, .pdf, etc.)
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<[byte](https://learn.microsoft.com/dotnet/api/system.byte)\[\]\>
+
+Catalog entry for binary file with byte array content
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Images (PNG, JPG), PDFs, any binary data
+</p>
+<p>
+<strong>Implementation:</strong> Reads entire file as byte array.
+</p>
+<p>
+<strong>Storage Traits:</strong> All traits use filesystem baseline defaults
+</p>
+
+### <a id="Flowthru_Data_Items_Single_Json__1_System_String_System_String_"></a> Json<T\>\(string, string\)
+
+Creates a JSON file catalog entry for a single object (non-collection).
+
+```csharp
+public static Item<T> Json<T>(string label, string filePath) where T : IStructuredSerializable
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to JSON file
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<T\>
+
+Catalog entry for singleton JSON object
+
+#### Type Parameters
+
+`T` 
+
+Object type (must be structured-serializable)
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Model files, configuration objects, metrics, single records
+</p>
+<p>
+<strong>Serialization:</strong> Single JSON object (not wrapped in array)
+</p>
+<p>
+<strong>Implementation:</strong> Uses SingletonJsonStorageAdapter which bypasses
+format/container composition for direct object serialization.
+</p>
+
+### <a id="Flowthru_Data_Items_Single_Memory__1_System_String_"></a> Memory<T\>\(string\)
+
+Creates a memory catalog entry for a single object (non-collection).
+
+```csharp
+public static Item<T> Memory<T>(string label)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<T\>
+
+Catalog entry for in-memory singleton
+
+#### Type Parameters
+
+`T` 
+
+Object type
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Models, charts, computed metrics that stay in memory
+</p>
+<p>
+<strong>Examples:</strong>
+</p>
+<ul><li>ML models (LinearRegressionModel)</li><li>Charts (GenericChart from Plotly.NET)</li><li>Metrics objects (ModelMetrics, CrossValidationResults)</li><li>Any singleton data that doesn't need persistence</li></ul>
+
+### <a id="Flowthru_Data_Items_Single_Null__1_System_String_"></a> Null<T\>\(string\)
+
+Creates a null catalog entry for side-effect-only nodes.
+
+```csharp
+public static Item<T> Null<T>(string label)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<T\>
+
+Catalog entry for void/no-data semantics
+
+#### Type Parameters
+
+`T` 
+
+The data type (typically NoData)
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Steps that perform side effects (logging, visualization) without producing meaningful data
+</p>
+<p>
+<strong>Implementation:</strong> Uses NullStorageAdapter which performs no I/O operations.
+</p>
+<p>
+<strong>Storage Traits:</strong>
+</p>
+<ul><li>CanWrite: false (Save is a no-op)</li><li>CanRead: false (Load throws NotSupportedException)</li></ul>
+
+### <a id="Flowthru_Data_Items_Single_Text_System_String_System_String_"></a> Text\(string, string\)
+
+Creates a plain text file catalog entry.
+
+```csharp
+public static Item<string> Text(string label, string filePath)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to text file (.txt, .md, etc.)
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+Catalog entry for text file with string content
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Markdown reports, plain text logs, configuration files
+</p>
+<p>
+<strong>Implementation:</strong> Reads entire file as single string.
+</p>
+<p>
+<strong>Storage Traits:</strong> All traits use filesystem baseline defaults
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.CatalogEntries.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.CatalogEntries.md
new file mode 100644
index 00000000..a8cd5d7c
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.CatalogEntries.md
@@ -0,0 +1,136 @@
+# <a id="Flowthru_Data_Items"></a> Class Items
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Core.dll  
+
+Static factory methods for creating catalog entries with common configurations.
+
+```csharp
+public static class Items
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[Items](Flowthru.Data.Items.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Examples
+
+<pre><code class="lang-csharp">// Tier 1: No annotations - property names match external field names
+public record SimpleSchema(
+    int Id,           // Looks for "Id" in CSV/Excel/JSON
+    string Name       // Looks for "Name" in CSV/Excel/JSON
+) : IFlatSchema, ITextSerializable;
+
+var simple = Items.Enumerable.Csv&lt;SimpleSchema&gt;("data", "data.csv");
+
+// Tier 2: Explicit annotations - handle naming mismatches
+public record ShuttleSchema(
+    [SerializedLabel("id")]
+    string Id,
+
+    [SerializedLabel("shuttle_location")]        // snake_case in file
+    string ShuttleLocation,
+
+    [SerializedLabel("d_check_complete")]        // snake_case in file
+    bool DCheckComplete,
+
+    [SerializedLabel("Company ID")]              // space-separated in file
+    int CompanyId
+) : IFlatSchema, ITextSerializable;
+
+var shuttles = Items.Enumerable.Excel&lt;ShuttleSchema&gt;(
+    "shuttles",
+    "data/shuttles.xlsx",
+    "Sheet1"
+);
+
+// Same schema works across all formats
+var csv = Items.Enumerable.Csv&lt;ShuttleSchema&gt;("shuttles", "data/shuttles.csv");
+var json = Items.Enumerable.Json&lt;ShuttleSchema&gt;("shuttles", "data/shuttles.json");</code></pre>
+
+## Remarks
+
+<p>
+<strong>Design Pattern:</strong> Static factory methods that compose storage adapters
+from medium + format + container layers.
+</p>
+<p>
+<strong>Discoverability:</strong> All factory methods are in one place with IntelliSense support.
+</p>
+<p>
+<strong>Type Safety:</strong> Generic constraints enforce schema compatibility at compile-time.
+</p>
+<p>
+<strong>Field Name Mapping with SerializedLabel:</strong>
+</p>
+<p>
+Use the SerializedLabelAttribute to map C# property names to external field names
+when they differ. This works uniformly across CSV, Excel, JSON, and most formats.
+</p>
+
+## Properties
+
+### <a id="Flowthru_Data_Items_Enumerable"></a> Enumerable
+
+Factory methods for <xref href="System.Collections.Generic.IEnumerable%601" data-throw-if-not-resolved="false"></xref> catalog entries.
+
+```csharp
+public static EnumerableItems Enumerable { get; }
+```
+
+#### Property Value
+
+ [EnumerableItems](Flowthru.Data.EnumerableItems.md)
+
+## Methods
+
+### <a id="Flowthru_Data_Items_Null__1_System_String_"></a> Null<T\>\(string\)
+
+Creates a null catalog entry for side-effect-only nodes.
+
+```csharp
+public static Item<T> Null<T>(string label)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<T\>
+
+Catalog entry for void/no-data semantics
+
+#### Type Parameters
+
+`T` 
+
+The data type (typically NoData)
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Steps that perform side effects (logging, visualization) without producing meaningful data
+</p>
+<p>
+<strong>Implementation:</strong> Uses NullStorageAdapter which performs no I/O operations.
+</p>
+<p>
+<strong>Storage Traits:</strong>
+</p>
+<ul><li>CanWrite: false (Save is a no-op)</li><li>CanRead: false (Load throws NotSupportedException)</li></ul>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.CatalogEntry-1.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.CatalogEntry-1.md
new file mode 100644
index 00000000..4c3309d5
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.CatalogEntry-1.md
@@ -0,0 +1,347 @@
+# <a id="Flowthru_Data_Item_1"></a> Class Item<T\>
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Core.dll  
+
+Standard catalog entry implementation that delegates to a storage adapter.
+
+```csharp
+public sealed class Item<T> : IItem<T>, IItem
+```
+
+#### Type Parameters
+
+`T` 
+
+The data type (container with rows)
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[Item<T\>](Flowthru.Data.Item\-1.md)
+
+#### Implements
+
+[IItem<T\>](Flowthru.Data.IItem\-1.md), 
+[IItem](Flowthru.Data.IItem.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Delegation Pattern:</strong>
+</p>
+<p>
+This class is a thin wrapper that delegates all operations to an <xref href="Flowthru.Data.Storage.IStorageAdapter%601" data-throw-if-not-resolved="false"></xref>.
+The storage adapter handles the actual I/O logic, while this class provides:
+- IItem interface implementation
+- Identity for DAG dependency resolution (via Key)
+- Type erasure for pipeline heterogeneous collections
+</p>
+<p>
+<strong>Construction:</strong>
+</p>
+<p>
+Typically created via static factory methods in <xref href="Flowthru.Data.Items" data-throw-if-not-resolved="false"></xref>:
+</p>
+<pre><code class="lang-csharp">var entry = Items.Csv&lt;CompanySchema&gt;("companies", "data.csv");
+// Returns: IItem&lt;IEnumerable&lt;CompanySchema&gt;&gt;</code></pre>
+<p>
+<strong>Composition vs Inheritance:</strong>
+</p>
+<p>
+Previous design: Inheritance hierarchy (CsvItem, JsonItem, etc.)
+New design: Single class + composed storage adapter
+</p>
+<p>
+Benefits:
+- No class explosion for format × container combinations
+- Custom storage via IStorageAdapter implementation
+- Clear separation of concerns
+</p>
+<p>
+<strong>Capability Forwarding:</strong>
+</p>
+<p>
+The underlying storage adapter provides inspection methods, which this catalog
+entry automatically forwards. All storage adapters are required to implement inspection.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_Item_1__ctor_System_String_Flowthru_Data_Storage_IStorageAdapter__0__"></a> Item\(string, IStorageAdapter<T\>\)
+
+Creates a new catalog entry with the specified key and storage adapter.
+
+```csharp
+public Item(string label, IStorageAdapter<T> storage)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this catalog entry
+
+`storage` [IStorageAdapter](Flowthru.Data.Storage.IStorageAdapter\-1.md)<T\>
+
+Storage adapter that handles I/O operations
+
+## Properties
+
+### <a id="Flowthru_Data_Item_1_DataType"></a> DataType
+
+The runtime type of data stored in this catalog entry.
+For singletons: Returns typeof(T).
+For collections: Returns typeof(IEnumerable&lt;T&gt;).
+
+```csharp
+public Type DataType { get; }
+```
+
+#### Property Value
+
+ [Type](https://learn.microsoft.com/dotnet/api/system.type)
+
+### <a id="Flowthru_Data_Item_1_Label"></a> Label
+
+Unique label identifying this catalog entry within the data catalog.
+
+```csharp
+public string Label { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Data_Item_1_OwningCatalogLabel"></a> OwningCatalogLabel
+
+The label of the <xref href="Flowthru.Data.DataCatalogBase" data-throw-if-not-resolved="false"></xref>-derived class that created
+this entry. Set automatically by <code>GetOrCreateEntry</code>; null for entries created outside
+a catalog or by custom <xref href="Flowthru.Data.IItem" data-throw-if-not-resolved="false"></xref> implementations.
+
+```csharp
+public string? OwningCatalogLabel { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Remarks
+
+Used by the metadata layer to produce fully-qualified entry identifiers in the form
+<code>CatalogLabel.EntryLabel</code>. First-write-wins: cross-catalog shared entries retain
+the label of the catalog that originally created them.
+
+### <a id="Flowthru_Data_Item_1_PreferredInspectionLevel"></a> PreferredInspectionLevel
+
+Gets the preferred inspection level for this catalog entry.
+
+```csharp
+public InspectionLevel? PreferredInspectionLevel { get; }
+```
+
+#### Property Value
+
+ [InspectionLevel](Flowthru.Data.Validation.InspectionLevel.md)?
+
+### <a id="Flowthru_Data_Item_1_Traits"></a> Traits
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+## Methods
+
+### <a id="Flowthru_Data_Item_1_Constrain_System_Func_Flowthru_Data_Capabilities_StorageTraits_Flowthru_Data_Capabilities_StorageTraits__"></a> Constrain\(Func<StorageTraits, StorageTraits\>\)
+
+```csharp
+public Item<T> Constrain(Func<StorageTraits, StorageTraits> constraintFn)
+```
+
+#### Parameters
+
+`constraintFn` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md), [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)\>
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<T\>
+
+### <a id="Flowthru_Data_Item_1_Exists"></a> Exists\(\)
+
+Checks if data exists at this catalog entry location.
+Returns an effect that can fail.
+
+```csharp
+public FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+### <a id="Flowthru_Data_Item_1_GetCountAsync"></a> GetCountAsync\(\)
+
+Gets the count of items in this catalog entry.
+For collections (IEnumerable&lt;T&gt;), returns the enumerable count.
+For singletons, returns 1 if exists, 0 otherwise.
+
+```csharp
+public FlowIO<int> GetCountAsync()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[int](https://learn.microsoft.com/dotnet/api/system.int32)\>
+
+### <a id="Flowthru_Data_Item_1_InspectDeep"></a> InspectDeep\(\)
+
+Performs deep validation of this catalog entry.
+
+```csharp
+public FlowIO<ValidationResult> InspectDeep()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+Forwards the call directly to the underlying storage adapter.
+All storage adapters must implement inspection.
+
+### <a id="Flowthru_Data_Item_1_InspectShallow_System_Int32_"></a> InspectShallow\(int\)
+
+Performs shallow validation of this catalog entry.
+
+```csharp
+public FlowIO<ValidationResult> InspectShallow(int sampleSize = 100)
+```
+
+#### Parameters
+
+`sampleSize` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of rows/records to sample for validation
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+Forwards the call directly to the underlying storage adapter.
+All storage adapters must implement inspection.
+
+### <a id="Flowthru_Data_Item_1_Load"></a> Load\(\)
+
+Load data as an effect (can fail, is async, can be cancelled).
+Returns T directly, which may itself be an IEnumerable or Seq.
+
+```csharp
+public FlowIO<T> Load()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<T\>
+
+### <a id="Flowthru_Data_Item_1_LoadUntyped"></a> LoadUntyped\(\)
+
+Loads data from the catalog entry as an untyped object.
+Returns an effect that can fail.
+The returned type matches the DataType property.
+
+```csharp
+public FlowIO<object> LoadUntyped()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[object](https://learn.microsoft.com/dotnet/api/system.object)\>
+
+### <a id="Flowthru_Data_Item_1_Save__0_"></a> Save\(T\)
+
+Save data as an effect.
+Accepts T directly, which may itself be an IEnumerable or Seq.
+
+```csharp
+public FlowIO<FlowUnit> Save(T data)
+```
+
+#### Parameters
+
+`data` T
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
+### <a id="Flowthru_Data_Item_1_SaveUntyped_System_Object_"></a> SaveUntyped\(object\)
+
+Saves untyped data to the catalog entry.
+Returns an effect that can fail.
+The data type must be compatible with the DataType property.
+
+```csharp
+public FlowIO<FlowUnit> SaveUntyped(object data)
+```
+
+#### Parameters
+
+`data` [object](https://learn.microsoft.com/dotnet/api/system.object)
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
+### <a id="Flowthru_Data_Item_1_WithInspectionLevel_Flowthru_Data_Validation_InspectionLevel_"></a> WithInspectionLevel\(InspectionLevel\)
+
+Sets the preferred inspection level for this catalog entry.
+
+```csharp
+public Item<T> WithInspectionLevel(InspectionLevel level)
+```
+
+#### Parameters
+
+`level` [InspectionLevel](Flowthru.Data.Validation.InspectionLevel.md)
+
+The inspection level to use
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<T\>
+
+This catalog entry for method chaining
+
+#### Remarks
+
+<p>
+Used to configure how this entry should be validated before pipeline execution.
+</p>
+<p>
+Example:
+</p>
+<pre><code class="lang-csharp">var entry = Items.Csv&lt;Company&gt;("companies", "data.csv")
+    .WithInspectionLevel(InspectionLevel.Deep);</code></pre>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.DataCatalogBase.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.DataCatalogBase.md
new file mode 100644
index 00000000..5b2f24d9
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.DataCatalogBase.md
@@ -0,0 +1,262 @@
+# <a id="Flowthru_Data_DataCatalogBase"></a> Class DataCatalogBase
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Core.dll  
+
+Base class for strongly-typed catalog implementations with automatic property caching.
+
+```csharp
+public abstract class DataCatalogBase
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[DataCatalogBase](Flowthru.Data.DataCatalogBase.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Problem Solved:</strong>
+Expression-bodied properties (<code>Property =&gt; new Entry()</code>) create new instances on each access,
+breaking DAG dependency resolution which relies on object identity.
+</p>
+<p>
+<strong>Solution:</strong>
+Uses reflection to:
+1. Discover all IItem properties on derived classes
+2. Create backing fields to cache instances
+3. Intercept property getters to return cached instances
+</p>
+<p>
+<strong>Usage Pattern:</strong>
+<pre><code class="lang-csharp">public class MyCatalog : DataCatalogBase
+{
+    public MyCatalog(string basePath = "Data") : base()
+    {
+        BasePath = basePath;
+        InitializeCatalogProperties();
+    }
+
+    protected string BasePath { get; }
+
+    // Declare once - automatically cached!
+    public IItem&lt;IEnumerable&lt;MyData&gt;&gt; MyData =&gt;
+        GetOrCreateEntry(() =&gt; new CsvItem&lt;MyData&gt;("my_data", $"{BasePath}/data.csv"));
+}</code></pre>
+</p>
+<p>
+<strong>Key Benefits:</strong>
+- Declare catalog entries ONCE (no redundant constructor code)
+- Automatic instance caching (object identity preserved)
+- Type-safe (compile-time checks)
+- Zero runtime overhead after first access (cached delegates)
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_DataCatalogBase__ctor_System_String_"></a> DataCatalogBase\(string?\)
+
+```csharp
+protected DataCatalogBase(string? catalogLabel = null)
+```
+
+#### Parameters
+
+`catalogLabel` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+Optional display label for this catalog instance. When omitted, defaults to the
+concrete class name via <code>GetType().Name</code>.
+
+## Properties
+
+### <a id="Flowthru_Data_DataCatalogBase_CatalogLabel"></a> CatalogLabel
+
+The display label used to identify this catalog instance in pipeline metadata.
+Defaults to the concrete class name when not specified.
+
+```csharp
+public string CatalogLabel { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Pass an explicit label when constructing multiple instances of the same catalog type
+in a single pipeline (e.g., per-partition or per-shard catalogs) so their entries
+receive distinct qualified identifiers in the DAG: <code>CatalogLabel.EntryLabel</code>.
+
+### <a id="Flowthru_Data_DataCatalogBase_Services"></a> Services
+
+Optional service provider for dependency injection into catalog entries.
+
+```csharp
+public IServiceProvider? Services { get; set; }
+```
+
+#### Property Value
+
+ [IServiceProvider](https://learn.microsoft.com/dotnet/api/system.iserviceprovider)?
+
+#### Remarks
+
+Set by the service layer before pipeline execution to enable catalog
+entries to resolve services (e.g., database connections, HTTP clients).
+
+## Methods
+
+### <a id="Flowthru_Data_DataCatalogBase_ClearCache"></a> ClearCache\(\)
+
+Clears the property cache. Use with caution!
+
+```csharp
+protected void ClearCache()
+```
+
+#### Remarks
+
+<p>
+<strong>Warning:</strong> Clearing the cache after pipeline construction will break
+DAG dependencies since new instances will be created on next access.
+</p>
+<p>
+<strong>Use Case:</strong> Primarily for testing scenarios where you need to reset
+catalog state between test runs.
+</p>
+
+### <a id="Flowthru_Data_DataCatalogBase_GetAllEntries"></a> GetAllEntries\(\)
+
+Gets all cached catalog entries.
+
+```csharp
+protected IEnumerable<IItem> GetAllEntries()
+```
+
+#### Returns
+
+ [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<[IItem](Flowthru.Data.IItem.md)\>
+
+Enumerable of all initialized catalog entries
+
+#### Remarks
+
+Useful for diagnostic purposes or when you need to iterate over all entries
+(e.g., for validation, cleanup, or reporting).
+
+### <a id="Flowthru_Data_DataCatalogBase_GetOrCreateEntry__1_System_Func_Flowthru_Data_IItem___0___System_String_"></a> GetOrCreateEntry<T\>\(Func<IItem<T\>\>, string\)
+
+Gets or creates a unified catalog entry, caching it for subsequent accesses.
+
+```csharp
+protected IItem<T> GetOrCreateEntry<T>(Func<IItem<T>> factory, string propertyName = "")
+```
+
+#### Parameters
+
+`factory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-1)<[IItem](Flowthru.Data.IItem\-1.md)<T\>\>
+
+Factory function to create the entry on first access
+
+`propertyName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Auto-populated by compiler with calling property name
+
+#### Returns
+
+ [IItem](Flowthru.Data.IItem\-1.md)<T\>
+
+Cached catalog entry instance
+
+#### Type Parameters
+
+`T` 
+
+The data type stored in this catalog entry.
+For singletons: Use T directly (e.g., LinearRegressionModel)
+For collections: Use IEnumerable&lt;T&gt; (e.g., IEnumerable&lt;FeatureRow&gt;)
+
+#### Remarks
+
+<p>
+<strong>Unified API (v0.5.0):</strong> This single method replaces GetOrCreateObject
+and GetOrCreateDataset. Cardinality is determined by the type parameter T.
+</p>
+<p>
+<strong>Usage Examples:</strong>
+<pre><code class="lang-csharp">// Singleton object
+public IItem&lt;LinearRegressionModel&gt; Model =&gt;
+    GetOrCreateEntry(() =&gt; Items.Single.Memory&lt;LinearRegressionModel&gt;("model"));
+
+// Collection
+public IItem&lt;IEnumerable&lt;FeatureRow&gt;&gt; Features =&gt;
+    GetOrCreateEntry(() =&gt; Items.Enumerable.Csv&lt;FeatureRow&gt;("features", "data.csv"));</code></pre>
+</p>
+
+### <a id="Flowthru_Data_DataCatalogBase_GetOrCreateEntry__1_System_Func_System_IServiceProvider_Flowthru_Data_IItem___0___System_String_"></a> GetOrCreateEntry<T\>\(Func<IServiceProvider?, IItem<T\>\>, string\)
+
+Gets or creates a unified catalog entry with service provider access.
+
+```csharp
+protected IItem<T> GetOrCreateEntry<T>(Func<IServiceProvider?, IItem<T>> factory, string propertyName = "")
+```
+
+#### Parameters
+
+`factory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IServiceProvider](https://learn.microsoft.com/dotnet/api/system.iserviceprovider)?, [IItem](Flowthru.Data.IItem\-1.md)<T\>\>
+
+Factory function that receives service provider
+
+`propertyName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Auto-populated by compiler with calling property name
+
+#### Returns
+
+ [IItem](Flowthru.Data.IItem\-1.md)<T\>
+
+Cached catalog entry instance
+
+#### Type Parameters
+
+`T` 
+
+The data type (singleton or collection)
+
+### <a id="Flowthru_Data_DataCatalogBase_InitializeCatalogProperties"></a> InitializeCatalogProperties\(\)
+
+Initializes all catalog entry properties by invoking their getters once.
+
+```csharp
+protected void InitializeCatalogProperties()
+```
+
+#### Remarks
+
+<p>
+<strong>Purpose:</strong> Eager initialization ensures all entries are cached
+before pipeline construction begins, preventing any potential race conditions
+or unexpected lazy initialization behavior.
+</p>
+<p>
+<strong>When to Call:</strong> At the end of the derived catalog's constructor,
+after all configuration properties (like BasePath) are set.
+</p>
+<p>
+<strong>How It Works:</strong>
+Uses reflection to find all public instance properties that return IItem,
+then invokes each getter once to populate the cache.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.EnumerableCatalogEntries.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.EnumerableCatalogEntries.md
new file mode 100644
index 00000000..8515785f
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.EnumerableCatalogEntries.md
@@ -0,0 +1,126 @@
+# <a id="Flowthru_Data_EnumerableItems"></a> Class EnumerableItems
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Core.dll  
+
+Extension point for <xref href="Flowthru.Data.Items.Enumerable" data-throw-if-not-resolved="false"></xref> factory methods.
+
+```csharp
+public sealed class EnumerableItems
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[EnumerableItems](Flowthru.Data.EnumerableItems.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+IEnumerable&lt;T&gt; is the standard .NET collection interface.
+</p>
+<p>
+<strong>Characteristics:</strong>
+</p>
+<ul><li><strong>Lazy evaluation:</strong> LINQ queries deferred until enumeration</li><li><strong>Re-enumerable:</strong> Can cause side effects (multiple DB hits, file reads)</li><li><strong>Mutable:</strong> Underlying collection can be modified</li><li><strong>Standard .NET:</strong> Works with all .NET libraries</li></ul>
+<p>
+<strong>Use Cases:</strong>
+</p>
+<ul><li>Standard data processing pipelines (90% of cases)</li><li>Interop with .NET libraries expecting IEnumerable</li><li>LINQ query composition</li><li>Large datasets where you'll enumerate only once</li></ul>
+<p>
+Format-specific factory methods (CSV, Parquet, Excel) are provided as extension
+methods by their respective packages. Add extension methods to this type to
+register new formats.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_EnumerableItems_Json__1_System_String_System_String_"></a> Json<TRow\>\(string, string\)
+
+Creates a JSON file catalog entry with IEnumerable container for collections.
+
+```csharp
+public Item<IEnumerable<TRow>> Json<TRow>(string label, string filePath) where TRow : notnull, IStructuredSerializable
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to JSON file
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<TRow\>\>
+
+Catalog entry with file + JSON + IEnumerable composition
+
+#### Type Parameters
+
+`TRow` 
+
+Row schema type (must be structured-serializable)
+
+#### Remarks
+
+<p>
+<strong>Requirements:</strong>
+</p>
+<ul><li>TRow must implement IStructuredSerializable</li><li>TRow supports both flat and nested schemas</li></ul>
+<p>
+<strong>Supports:</strong>
+</p>
+<ul><li>Traditional schemas with parameterless constructors</li><li>Modern schemas with required properties (C# 11+)</li><li>Positional records with primary constructors</li></ul>
+<p>
+<strong>Serialization:</strong> JSON array format for collections
+</p>
+
+### <a id="Flowthru_Data_EnumerableItems_Memory__1_System_String_"></a> Memory<TRow\>\(string\)
+
+Creates an in-memory transient catalog entry with IEnumerable container.
+
+```csharp
+public Item<IEnumerable<TRow>> Memory<TRow>(string label)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<TRow\>\>
+
+Catalog entry with memory storage (no serialization)
+
+#### Type Parameters
+
+`TRow` 
+
+Row schema type
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Intermediate pipeline data that doesn't need persistence
+</p>
+<p>
+<strong>Storage Traits:</strong>
+</p>
+<ul><li>IsPersistent: false (data lost when process ends)</li></ul>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.EnumerableItems.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.EnumerableItems.md
new file mode 100644
index 00000000..89c2bb04
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.EnumerableItems.md
@@ -0,0 +1,126 @@
+# <a id="Flowthru_Data_EnumerableItems"></a> Class EnumerableItems
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Core.dll  
+
+Extension point for <xref href="Flowthru.Data.Items.Enumerable" data-throw-if-not-resolved="false"></xref> factory methods.
+
+```csharp
+public sealed class EnumerableItems
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[EnumerableItems](Flowthru.Data.EnumerableItems.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+IEnumerable&lt;T&gt; is the standard .NET collection interface.
+</p>
+<p>
+<strong>Characteristics:</strong>
+</p>
+<ul><li><strong>Lazy evaluation:</strong> LINQ queries deferred until enumeration</li><li><strong>Re-enumerable:</strong> Can cause side effects (multiple DB hits, file reads)</li><li><strong>Mutable:</strong> Underlying collection can be modified</li><li><strong>Standard .NET:</strong> Works with all .NET libraries</li></ul>
+<p>
+<strong>Use Cases:</strong>
+</p>
+<ul><li>Standard data processing flows (90% of cases)</li><li>Interop with .NET libraries expecting IEnumerable</li><li>LINQ query composition</li><li>Large datasets where you'll enumerate only once</li></ul>
+<p>
+Format-specific factory methods (CSV, Parquet, Excel) are provided as extension
+methods by their respective packages. Add extension methods to this type to
+register new formats.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_EnumerableItems_Json__1_System_String_System_String_"></a> Json<TRow\>\(string, string\)
+
+Creates a JSON file catalog item with IEnumerable container for collections.
+
+```csharp
+public Item<IEnumerable<TRow>> Json<TRow>(string label, string filePath) where TRow : notnull, IStructuredSerializable
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to JSON file
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<TRow\>\>
+
+Catalog item with file + JSON + IEnumerable composition
+
+#### Type Parameters
+
+`TRow` 
+
+Row schema type (must be structured-serializable)
+
+#### Remarks
+
+<p>
+<strong>Requirements:</strong>
+</p>
+<ul><li>TRow must implement IStructuredSerializable</li><li>TRow supports both flat and nested schemas</li></ul>
+<p>
+<strong>Supports:</strong>
+</p>
+<ul><li>Traditional schemas with parameterless constructors</li><li>Modern schemas with required properties (C# 11+)</li><li>Positional records with primary constructors</li></ul>
+<p>
+<strong>Serialization:</strong> JSON array format for collections
+</p>
+
+### <a id="Flowthru_Data_EnumerableItems_Memory__1_System_String_"></a> Memory<TRow\>\(string\)
+
+Creates an in-memory transient catalog item with IEnumerable container.
+
+```csharp
+public Item<IEnumerable<TRow>> Memory<TRow>(string label)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<TRow\>\>
+
+Catalog item with memory storage (no serialization)
+
+#### Type Parameters
+
+`TRow` 
+
+Row schema type
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Intermediate flow data that doesn't need persistence
+</p>
+<p>
+<strong>Storage Traits:</strong>
+</p>
+<ul><li>IsPersistent: false (data lost when process ends)</li></ul>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.ICatalogEntry-1.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.ICatalogEntry-1.md
new file mode 100644
index 00000000..f7d70362
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.ICatalogEntry-1.md
@@ -0,0 +1,74 @@
+# <a id="Flowthru_Data_IItem_1"></a> Interface IItem<T\>
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Core.dll  
+
+Unified catalog entry with cardinality encoded in the type parameter.
+
+```csharp
+public interface IItem<T> : IItem
+```
+
+#### Type Parameters
+
+`T` 
+
+The data type stored in this catalog entry.
+Cardinality is determined by T itself:
+- For singletons: Use T directly (e.g., LinearRegressionModel, ModelMetrics)
+- For collections: Use IEnumerable&lt;T&gt; (e.g., IEnumerable&lt;FeatureRow&gt;)
+
+#### Implements
+
+[IItem](Flowthru.Data.IItem.md)
+
+## Remarks
+
+<p>
+<strong>Unified Design:</strong> This single interface replaces the previous dual-interface
+system (ICatalogObject/ICatalogDataset). Cardinality is now purely a type-level concern.
+</p>
+<p>
+<strong>Type Alignment:</strong> Step TInput/TOutput types should directly match catalog entry
+T types, eliminating the need for wrapping/unwrapping ceremony.
+</p>
+<p>
+<strong>Effect Types:</strong> All operations return FlowIO&lt;T&gt; - an effect that represents
+an async computation that can fail. This provides:
+- Explicit error handling
+- Cancellation support
+- Functional composition
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_IItem_1_Load"></a> Load\(\)
+
+Load data as an effect (can fail, is async, can be cancelled).
+Returns T directly, which may itself be an IEnumerable or Seq.
+
+```csharp
+FlowIO<T> Load()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<T\>
+
+### <a id="Flowthru_Data_IItem_1_Save__0_"></a> Save\(T\)
+
+Save data as an effect.
+Accepts T directly, which may itself be an IEnumerable or Seq.
+
+```csharp
+FlowIO<FlowUnit> Save(T data)
+```
+
+#### Parameters
+
+`data` T
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.ICatalogEntry.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.ICatalogEntry.md
new file mode 100644
index 00000000..14d0a9fa
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.ICatalogEntry.md
@@ -0,0 +1,172 @@
+# <a id="Flowthru_Data_IItem"></a> Interface IItem
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Core.dll  
+
+Non-generic base interface for catalog entries.
+Provides untyped operations for internal use by the pipeline executor and mapping layer.
+
+```csharp
+public interface IItem
+```
+
+## Remarks
+
+This interface enables the pipeline to work with catalog entries
+without knowing their specific type parameter at compile-time.
+
+## Properties
+
+### <a id="Flowthru_Data_IItem_DataType"></a> DataType
+
+The runtime type of data stored in this catalog entry.
+For singletons: Returns typeof(T).
+For collections: Returns typeof(IEnumerable&lt;T&gt;).
+
+```csharp
+Type DataType { get; }
+```
+
+#### Property Value
+
+ [Type](https://learn.microsoft.com/dotnet/api/system.type)
+
+### <a id="Flowthru_Data_IItem_Label"></a> Label
+
+Unique label identifying this catalog entry within the data catalog.
+
+```csharp
+string Label { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Data_IItem_OwningCatalogLabel"></a> OwningCatalogLabel
+
+The label of the <xref href="Flowthru.Data.DataCatalogBase" data-throw-if-not-resolved="false"></xref>-derived class that created
+this entry. Set automatically by <code>GetOrCreateEntry</code>; null for entries created outside
+a catalog or by custom <xref href="Flowthru.Data.IItem" data-throw-if-not-resolved="false"></xref> implementations.
+
+```csharp
+string? OwningCatalogLabel { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Remarks
+
+Used by the metadata layer to produce fully-qualified entry identifiers in the form
+<code>CatalogLabel.EntryLabel</code>. First-write-wins: cross-catalog shared entries retain
+the label of the catalog that originally created them.
+
+### <a id="Flowthru_Data_IItem_PreferredInspectionLevel"></a> PreferredInspectionLevel
+
+Gets the preferred inspection level for this catalog entry.
+
+```csharp
+InspectionLevel? PreferredInspectionLevel { get; }
+```
+
+#### Property Value
+
+ [InspectionLevel](Flowthru.Data.Validation.InspectionLevel.md)?
+
+## Methods
+
+### <a id="Flowthru_Data_IItem_Exists"></a> Exists\(\)
+
+Checks if data exists at this catalog entry location.
+Returns an effect that can fail.
+
+```csharp
+FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+### <a id="Flowthru_Data_IItem_GetCountAsync"></a> GetCountAsync\(\)
+
+Gets the count of items in this catalog entry.
+For collections (IEnumerable&lt;T&gt;), returns the enumerable count.
+For singletons, returns 1 if exists, 0 otherwise.
+
+```csharp
+FlowIO<int> GetCountAsync()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[int](https://learn.microsoft.com/dotnet/api/system.int32)\>
+
+### <a id="Flowthru_Data_IItem_InspectDeep"></a> InspectDeep\(\)
+
+Performs deep validation of this catalog entry.
+
+```csharp
+FlowIO<ValidationResult> InspectDeep()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+### <a id="Flowthru_Data_IItem_InspectShallow_System_Int32_"></a> InspectShallow\(int\)
+
+Performs shallow validation of this catalog entry.
+
+```csharp
+FlowIO<ValidationResult> InspectShallow(int sampleSize = 100)
+```
+
+#### Parameters
+
+`sampleSize` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of rows/records to sample for validation
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+### <a id="Flowthru_Data_IItem_LoadUntyped"></a> LoadUntyped\(\)
+
+Loads data from the catalog entry as an untyped object.
+Returns an effect that can fail.
+The returned type matches the DataType property.
+
+```csharp
+FlowIO<object> LoadUntyped()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[object](https://learn.microsoft.com/dotnet/api/system.object)\>
+
+### <a id="Flowthru_Data_IItem_SaveUntyped_System_Object_"></a> SaveUntyped\(object\)
+
+Saves untyped data to the catalog entry.
+Returns an effect that can fail.
+The data type must be compatible with the DataType property.
+
+```csharp
+FlowIO<FlowUnit> SaveUntyped(object data)
+```
+
+#### Parameters
+
+`data` [object](https://learn.microsoft.com/dotnet/api/system.object)
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.IItem-1.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.IItem-1.md
new file mode 100644
index 00000000..7a760396
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.IItem-1.md
@@ -0,0 +1,74 @@
+# <a id="Flowthru_Data_IItem_1"></a> Interface IItem<T\>
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Core.dll  
+
+Unified catalog item with cardinality encoded in the type parameter.
+
+```csharp
+public interface IItem<T> : IItem
+```
+
+#### Type Parameters
+
+`T` 
+
+The data type stored in this catalog item.
+Cardinality is determined by T itself:
+- For singletons: Use T directly (e.g., LinearRegressionModel, ModelMetrics)
+- For collections: Use IEnumerable&lt;T&gt; (e.g., IEnumerable&lt;FeatureRow&gt;)
+
+#### Implements
+
+[IItem](Flowthru.Data.IItem.md)
+
+## Remarks
+
+<p>
+<strong>Unified Design:</strong> This single interface replaces the previous dual-interface
+system (ICatalogObject/ICatalogDataset). Cardinality is now purely a type-level concern.
+</p>
+<p>
+<strong>Type Alignment:</strong> Step TInput/TOutput types should directly match catalog item
+T types, eliminating the need for wrapping/unwrapping ceremony.
+</p>
+<p>
+<strong>Effect Types:</strong> All operations return FlowIO&lt;T&gt; - an effect that represents
+an async computation that can fail. This provides:
+- Explicit error handling
+- Cancellation support
+- Functional composition
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_IItem_1_Load"></a> Load\(\)
+
+Load data as an effect (can fail, is async, can be cancelled).
+Returns T directly, which may itself be an IEnumerable or Seq.
+
+```csharp
+FlowIO<T> Load()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<T\>
+
+### <a id="Flowthru_Data_IItem_1_Save__0_"></a> Save\(T\)
+
+Save data as an effect.
+Accepts T directly, which may itself be an IEnumerable or Seq.
+
+```csharp
+FlowIO<FlowUnit> Save(T data)
+```
+
+#### Parameters
+
+`data` T
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.IItem.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.IItem.md
new file mode 100644
index 00000000..7fda960d
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.IItem.md
@@ -0,0 +1,172 @@
+# <a id="Flowthru_Data_IItem"></a> Interface IItem
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Core.dll  
+
+Non-generic base interface for catalog items.
+Provides untyped operations for internal use by the flow executor and mapping layer.
+
+```csharp
+public interface IItem
+```
+
+## Remarks
+
+This interface enables the flow to work with catalog items
+without knowing their specific type parameter at compile-time.
+
+## Properties
+
+### <a id="Flowthru_Data_IItem_DataType"></a> DataType
+
+The runtime type of data stored in this catalog item.
+For singletons: Returns typeof(T).
+For collections: Returns typeof(IEnumerable&lt;T&gt;).
+
+```csharp
+Type DataType { get; }
+```
+
+#### Property Value
+
+ [Type](https://learn.microsoft.com/dotnet/api/system.type)
+
+### <a id="Flowthru_Data_IItem_Label"></a> Label
+
+Unique label identifying this catalog item within the data catalog.
+
+```csharp
+string Label { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Data_IItem_OwningCatalogLabel"></a> OwningCatalogLabel
+
+The label of the <xref href="Flowthru.Data.CatalogAbstract" data-throw-if-not-resolved="false"></xref>-derived class that created
+this item. Set automatically by <code>GetOrCreateItem</code>; null for items created outside
+a catalog or by custom <xref href="Flowthru.Data.IItem" data-throw-if-not-resolved="false"></xref> implementations.
+
+```csharp
+string? OwningCatalogLabel { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Remarks
+
+Used by the metadata layer to produce fully-qualified item identifiers in the form
+<code>CatalogLabel.ItemLabel</code>. First-write-wins: cross-catalog shared items retain
+the label of the catalog that originally created them.
+
+### <a id="Flowthru_Data_IItem_PreferredInspectionLevel"></a> PreferredInspectionLevel
+
+Gets the preferred inspection level for this catalog item.
+
+```csharp
+InspectionLevel? PreferredInspectionLevel { get; }
+```
+
+#### Property Value
+
+ [InspectionLevel](Flowthru.Data.Validation.InspectionLevel.md)?
+
+## Methods
+
+### <a id="Flowthru_Data_IItem_Exists"></a> Exists\(\)
+
+Checks if data exists at this catalog item location.
+Returns an effect that can fail.
+
+```csharp
+FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+### <a id="Flowthru_Data_IItem_GetCountAsync"></a> GetCountAsync\(\)
+
+Gets the count of items in this catalog item.
+For collections (IEnumerable&lt;T&gt;), returns the enumerable count.
+For singletons, returns 1 if exists, 0 otherwise.
+
+```csharp
+FlowIO<int> GetCountAsync()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[int](https://learn.microsoft.com/dotnet/api/system.int32)\>
+
+### <a id="Flowthru_Data_IItem_InspectDeep"></a> InspectDeep\(\)
+
+Performs deep validation of this catalog item.
+
+```csharp
+FlowIO<ValidationResult> InspectDeep()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+### <a id="Flowthru_Data_IItem_InspectShallow_System_Int32_"></a> InspectShallow\(int\)
+
+Performs shallow validation of this catalog item.
+
+```csharp
+FlowIO<ValidationResult> InspectShallow(int sampleSize = 100)
+```
+
+#### Parameters
+
+`sampleSize` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of rows/records to sample for validation
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+### <a id="Flowthru_Data_IItem_LoadUntyped"></a> LoadUntyped\(\)
+
+Loads data from the catalog item as an untyped object.
+Returns an effect that can fail.
+The returned type matches the DataType property.
+
+```csharp
+FlowIO<object> LoadUntyped()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[object](https://learn.microsoft.com/dotnet/api/system.object)\>
+
+### <a id="Flowthru_Data_IItem_SaveUntyped_System_Object_"></a> SaveUntyped\(object\)
+
+Saves untyped data to the catalog item.
+Returns an effect that can fail.
+The data type must be compatible with the DataType property.
+
+```csharp
+FlowIO<FlowUnit> SaveUntyped(object data)
+```
+
+#### Parameters
+
+`data` [object](https://learn.microsoft.com/dotnet/api/system.object)
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Item-1.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Item-1.md
new file mode 100644
index 00000000..9d419781
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Item-1.md
@@ -0,0 +1,347 @@
+# <a id="Flowthru_Data_Item_1"></a> Class Item<T\>
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Core.dll  
+
+Standard catalog item implementation that delegates to a storage adapter.
+
+```csharp
+public sealed class Item<T> : IItem<T>, IItem
+```
+
+#### Type Parameters
+
+`T` 
+
+The data type (container with rows)
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[Item<T\>](Flowthru.Data.Item\-1.md)
+
+#### Implements
+
+[IItem<T\>](Flowthru.Data.IItem\-1.md), 
+[IItem](Flowthru.Data.IItem.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Delegation Pattern:</strong>
+</p>
+<p>
+This class is a thin wrapper that delegates all operations to an <xref href="Flowthru.Data.Storage.IStorageAdapter%601" data-throw-if-not-resolved="false"></xref>.
+The storage adapter handles the actual I/O logic, while this class provides:
+- ICatalogItem interface implementation
+- Identity for DAG dependency resolution (via Key)
+- Type erasure for Flow heterogeneous collections
+</p>
+<p>
+<strong>Construction:</strong>
+</p>
+<p>
+Typically created via static factory methods in <xref href="Flowthru.Data.Items" data-throw-if-not-resolved="false"></xref>:
+</p>
+<pre><code class="lang-csharp">var item = CatalogItems.Csv&lt;CompanySchema&gt;("companies", "data.csv");
+// Returns: ICatalogItem&lt;IEnumerable&lt;CompanySchema&gt;&gt;</code></pre>
+<p>
+<strong>Composition vs Inheritance:</strong>
+</p>
+<p>
+Previous design: Inheritance hierarchy (CsvCatalogItem, JsonCatalogItem, etc.)
+New design: Single class + composed storage adapter
+</p>
+<p>
+Benefits:
+- No class explosion for format × container combinations
+- Custom storage via IStorageAdapter implementation
+- Clear separation of concerns
+</p>
+<p>
+<strong>Capability Forwarding:</strong>
+</p>
+<p>
+The underlying storage adapter provides inspection methods, which this catalog
+item automatically forwards. All storage adapters are required to implement inspection.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_Item_1__ctor_System_String_Flowthru_Data_Storage_IStorageAdapter__0__"></a> Item\(string, IStorageAdapter<T\>\)
+
+Creates a new catalog item with the specified key and storage adapter.
+
+```csharp
+public Item(string label, IStorageAdapter<T> storage)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this catalog item
+
+`storage` [IStorageAdapter](Flowthru.Data.Storage.IStorageAdapter\-1.md)<T\>
+
+Storage adapter that handles I/O operations
+
+## Properties
+
+### <a id="Flowthru_Data_Item_1_DataType"></a> DataType
+
+The runtime type of data stored in this catalog item.
+For singletons: Returns typeof(T).
+For collections: Returns typeof(IEnumerable&lt;T&gt;).
+
+```csharp
+public Type DataType { get; }
+```
+
+#### Property Value
+
+ [Type](https://learn.microsoft.com/dotnet/api/system.type)
+
+### <a id="Flowthru_Data_Item_1_Label"></a> Label
+
+Unique label identifying this catalog item within the data catalog.
+
+```csharp
+public string Label { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Data_Item_1_OwningCatalogLabel"></a> OwningCatalogLabel
+
+The label of the <xref href="Flowthru.Data.CatalogAbstract" data-throw-if-not-resolved="false"></xref>-derived class that created
+this item. Set automatically by <code>GetOrCreateItem</code>; null for items created outside
+a catalog or by custom <xref href="Flowthru.Data.IItem" data-throw-if-not-resolved="false"></xref> implementations.
+
+```csharp
+public string? OwningCatalogLabel { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Remarks
+
+Used by the metadata layer to produce fully-qualified item identifiers in the form
+<code>CatalogLabel.ItemLabel</code>. First-write-wins: cross-catalog shared items retain
+the label of the catalog that originally created them.
+
+### <a id="Flowthru_Data_Item_1_PreferredInspectionLevel"></a> PreferredInspectionLevel
+
+Gets the preferred inspection level for this catalog item.
+
+```csharp
+public InspectionLevel? PreferredInspectionLevel { get; }
+```
+
+#### Property Value
+
+ [InspectionLevel](Flowthru.Data.Validation.InspectionLevel.md)?
+
+### <a id="Flowthru_Data_Item_1_Traits"></a> Traits
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+## Methods
+
+### <a id="Flowthru_Data_Item_1_Constrain_System_Func_Flowthru_Data_Capabilities_StorageTraits_Flowthru_Data_Capabilities_StorageTraits__"></a> Constrain\(Func<StorageTraits, StorageTraits\>\)
+
+```csharp
+public Item<T> Constrain(Func<StorageTraits, StorageTraits> constraintFn)
+```
+
+#### Parameters
+
+`constraintFn` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md), [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)\>
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<T\>
+
+### <a id="Flowthru_Data_Item_1_Exists"></a> Exists\(\)
+
+Checks if data exists at this catalog item location.
+Returns an effect that can fail.
+
+```csharp
+public FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+### <a id="Flowthru_Data_Item_1_GetCountAsync"></a> GetCountAsync\(\)
+
+Gets the count of items in this catalog item.
+For collections (IEnumerable&lt;T&gt;), returns the enumerable count.
+For singletons, returns 1 if exists, 0 otherwise.
+
+```csharp
+public FlowIO<int> GetCountAsync()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[int](https://learn.microsoft.com/dotnet/api/system.int32)\>
+
+### <a id="Flowthru_Data_Item_1_InspectDeep"></a> InspectDeep\(\)
+
+Performs deep validation of this catalog item.
+
+```csharp
+public FlowIO<ValidationResult> InspectDeep()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+Forwards the call directly to the underlying storage adapter.
+All storage adapters must implement inspection.
+
+### <a id="Flowthru_Data_Item_1_InspectShallow_System_Int32_"></a> InspectShallow\(int\)
+
+Performs shallow validation of this catalog item.
+
+```csharp
+public FlowIO<ValidationResult> InspectShallow(int sampleSize = 100)
+```
+
+#### Parameters
+
+`sampleSize` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of rows/records to sample for validation
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+Forwards the call directly to the underlying storage adapter.
+All storage adapters must implement inspection.
+
+### <a id="Flowthru_Data_Item_1_Load"></a> Load\(\)
+
+Load data as an effect (can fail, is async, can be cancelled).
+Returns T directly, which may itself be an IEnumerable or Seq.
+
+```csharp
+public FlowIO<T> Load()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<T\>
+
+### <a id="Flowthru_Data_Item_1_LoadUntyped"></a> LoadUntyped\(\)
+
+Loads data from the catalog item as an untyped object.
+Returns an effect that can fail.
+The returned type matches the DataType property.
+
+```csharp
+public FlowIO<object> LoadUntyped()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[object](https://learn.microsoft.com/dotnet/api/system.object)\>
+
+### <a id="Flowthru_Data_Item_1_Save__0_"></a> Save\(T\)
+
+Save data as an effect.
+Accepts T directly, which may itself be an IEnumerable or Seq.
+
+```csharp
+public FlowIO<FlowUnit> Save(T data)
+```
+
+#### Parameters
+
+`data` T
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
+### <a id="Flowthru_Data_Item_1_SaveUntyped_System_Object_"></a> SaveUntyped\(object\)
+
+Saves untyped data to the catalog item.
+Returns an effect that can fail.
+The data type must be compatible with the DataType property.
+
+```csharp
+public FlowIO<FlowUnit> SaveUntyped(object data)
+```
+
+#### Parameters
+
+`data` [object](https://learn.microsoft.com/dotnet/api/system.object)
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
+### <a id="Flowthru_Data_Item_1_WithInspectionLevel_Flowthru_Data_Validation_InspectionLevel_"></a> WithInspectionLevel\(InspectionLevel\)
+
+Sets the preferred inspection level for this catalog item.
+
+```csharp
+public Item<T> WithInspectionLevel(InspectionLevel level)
+```
+
+#### Parameters
+
+`level` [InspectionLevel](Flowthru.Data.Validation.InspectionLevel.md)
+
+The inspection level to use
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<T\>
+
+This catalog item for method chaining
+
+#### Remarks
+
+<p>
+Used to configure how this item should be validated before flow execution.
+</p>
+<p>
+Example:
+</p>
+<pre><code class="lang-csharp">var item = CatalogItems.Csv&lt;Company&gt;("companies", "data.csv")
+    .WithInspectionLevel(InspectionLevel.Deep);</code></pre>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Items.Single.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Items.Single.md
new file mode 100644
index 00000000..62522fb5
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Items.Single.md
@@ -0,0 +1,228 @@
+# <a id="Flowthru_Data_Items_Single"></a> Class Items.Single
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Core.dll  
+
+Factory methods for single (non-collection) values.
+
+```csharp
+public static class Items.Single
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[Items.Single](Flowthru.Data.Items.Single.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+These methods create catalog items for single objects rather than collections.
+</p>
+<p>
+<strong>Use Cases:</strong>
+</p>
+<ul><li>Model files (ML models, configuration objects)</li><li>Metrics and evaluation results (single JSON objects)</li><li>Text reports (Markdown, plain text)</li><li>Binary files (images, PDFs)</li><li>Side-effect-only steps (null/void semantics)</li></ul>
+
+## Methods
+
+### <a id="Flowthru_Data_Items_Single_Binary_System_String_System_String_"></a> Binary\(string, string\)
+
+Creates a binary file catalog item.
+
+```csharp
+public static Item<byte[]> Binary(string label, string filePath)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to binary file (.png, .jpg, .pdf, etc.)
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<[byte](https://learn.microsoft.com/dotnet/api/system.byte)\[\]\>
+
+Catalog item for binary file with byte array content
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Images (PNG, JPG), PDFs, any binary data
+</p>
+<p>
+<strong>Implementation:</strong> Reads entire file as byte array.
+</p>
+<p>
+<strong>Storage Traits:</strong> All traits use filesystem baseline defaults
+</p>
+
+### <a id="Flowthru_Data_Items_Single_Json__1_System_String_System_String_"></a> Json<T\>\(string, string\)
+
+Creates a JSON file catalog item for a single object (non-collection).
+
+```csharp
+public static Item<T> Json<T>(string label, string filePath) where T : IStructuredSerializable
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to JSON file
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<T\>
+
+Catalog item for singleton JSON object
+
+#### Type Parameters
+
+`T` 
+
+Object type (must be structured-serializable)
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Model files, configuration objects, metrics, single records
+</p>
+<p>
+<strong>Serialization:</strong> Single JSON object (not wrapped in array)
+</p>
+<p>
+<strong>Implementation:</strong> Uses SingletonJsonStorageAdapter which bypasses
+format/container composition for direct object serialization.
+</p>
+
+### <a id="Flowthru_Data_Items_Single_Memory__1_System_String_"></a> Memory<T\>\(string\)
+
+Creates a memory catalog item for a single object (non-collection).
+
+```csharp
+public static Item<T> Memory<T>(string label)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<T\>
+
+Catalog item for in-memory singleton
+
+#### Type Parameters
+
+`T` 
+
+Object type
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Models, charts, computed metrics that stay in memory
+</p>
+<p>
+<strong>Examples:</strong>
+</p>
+<ul><li>ML models (LinearRegressionModel)</li><li>Charts (GenericChart from Plotly.NET)</li><li>Metrics objects (ModelMetrics, CrossValidationResults)</li><li>Any singleton data that doesn't need persistence</li></ul>
+
+### <a id="Flowthru_Data_Items_Single_Null__1_System_String_"></a> Null<T\>\(string\)
+
+Creates a null catalog item for side-effect-only steps.
+
+```csharp
+public static Item<T> Null<T>(string label)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<T\>
+
+Catalog item for void/no-data semantics
+
+#### Type Parameters
+
+`T` 
+
+The data type (typically NoData)
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Steps that perform side effects (logging, visualization) without producing meaningful data
+</p>
+<p>
+<strong>Implementation:</strong> Uses NullStorageAdapter which performs no I/O operations.
+</p>
+<p>
+<strong>Storage Traits:</strong>
+</p>
+<ul><li>CanWrite: false (Save is a no-op)</li><li>CanRead: false (Load throws NotSupportedException)</li></ul>
+
+### <a id="Flowthru_Data_Items_Single_Text_System_String_System_String_"></a> Text\(string, string\)
+
+Creates a plain text file catalog item .
+
+```csharp
+public static Item<string> Text(string label, string filePath)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to text file (.txt, .md, etc.)
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+Catalog item for text file with string content
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Markdown reports, plain text logs, configuration files
+</p>
+<p>
+<strong>Implementation:</strong> Reads entire file as single string.
+</p>
+<p>
+<strong>Storage Traits:</strong> All traits use filesystem baseline defaults
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Items.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Items.md
new file mode 100644
index 00000000..97a82415
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Items.md
@@ -0,0 +1,136 @@
+# <a id="Flowthru_Data_Items"></a> Class Items
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Core.dll  
+
+Static factory methods for creating catalog entries with common configurations.
+
+```csharp
+public static class Items
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[Items](Flowthru.Data.Items.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Examples
+
+<pre><code class="lang-csharp">// Tier 1: No annotations - property names match external field names
+public record SimpleSchema(
+    int Id,           // Looks for "Id" in CSV/Excel/JSON
+    string Name       // Looks for "Name" in CSV/Excel/JSON
+) : IFlatSchema, ITextSerializable;
+
+var simple = Items.Enumerable.Csv&lt;SimpleSchema&gt;("data", "data.csv");
+
+// Tier 2: Explicit annotations - handle naming mismatches
+public record ShuttleSchema(
+    [SerializedLabel("id")]
+    string Id,
+
+    [SerializedLabel("shuttle_location")]        // snake_case in file
+    string ShuttleLocation,
+
+    [SerializedLabel("d_check_complete")]        // snake_case in file
+    bool DCheckComplete,
+
+    [SerializedLabel("Company ID")]              // space-separated in file
+    int CompanyId
+) : IFlatSchema, ITextSerializable;
+
+var shuttles = Items.Enumerable.Excel&lt;ShuttleSchema&gt;(
+    "shuttles",
+    "data/shuttles.xlsx",
+    "Sheet1"
+);
+
+// Same schema works across all formats
+var csv = Items.Enumerable.Csv&lt;ShuttleSchema&gt;("shuttles", "data/shuttles.csv");
+var json = Items.Enumerable.Json&lt;ShuttleSchema&gt;("shuttles", "data/shuttles.json");</code></pre>
+
+## Remarks
+
+<p>
+<strong>Design Pattern:</strong> Static factory methods that compose storage adapters
+from medium + format + container layers.
+</p>
+<p>
+<strong>Discoverability:</strong> All factory methods are in one place with IntelliSense support.
+</p>
+<p>
+<strong>Type Safety:</strong> Generic constraints enforce schema compatibility at compile-time.
+</p>
+<p>
+<strong>Field Name Mapping with SerializedLabel:</strong>
+</p>
+<p>
+Use the SerializedLabelAttribute to map C# property names to external field names
+when they differ. This works uniformly across CSV, Excel, JSON, and most formats.
+</p>
+
+## Properties
+
+### <a id="Flowthru_Data_Items_Enumerable"></a> Enumerable
+
+Factory methods for <xref href="System.Collections.Generic.IEnumerable%601" data-throw-if-not-resolved="false"></xref> catalog entries.
+
+```csharp
+public static EnumerableItems Enumerable { get; }
+```
+
+#### Property Value
+
+ [EnumerableItems](Flowthru.Data.EnumerableItems.md)
+
+## Methods
+
+### <a id="Flowthru_Data_Items_Null__1_System_String_"></a> Null<T\>\(string\)
+
+Creates a null catalog entry for side-effect-only nodes.
+
+```csharp
+public static Item<T> Null<T>(string label)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+#### Returns
+
+ [Item](Flowthru.Data.Item\-1.md)<T\>
+
+Catalog entry for void/no-data semantics
+
+#### Type Parameters
+
+`T` 
+
+The data type (typically NoData)
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Nodes that perform side effects (logging, visualization) without producing meaningful data
+</p>
+<p>
+<strong>Implementation:</strong> Uses NullStorageAdapter which performs no I/O operations.
+</p>
+<p>
+<strong>Storage Traits:</strong>
+</p>
+<ul><li>CanWrite: false (Save is a no-op)</li><li>CanRead: false (Load throws NotSupportedException)</li></ul>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.BinaryFileStorageAdapter.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.BinaryFileStorageAdapter.md
new file mode 100644
index 00000000..5ea4982a
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.BinaryFileStorageAdapter.md
@@ -0,0 +1,239 @@
+# <a id="Flowthru_Data_Storage_BinaryFileStorageAdapter"></a> Class BinaryFileStorageAdapter
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Core.dll  
+
+Storage adapter for binary files with byte array content.
+
+```csharp
+public sealed class BinaryFileStorageAdapter : IStorageAdapter<byte[]>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[BinaryFileStorageAdapter](Flowthru.Data.Storage.BinaryFileStorageAdapter.md)
+
+#### Implements
+
+[IStorageAdapter<byte\[\]\>](Flowthru.Data.Storage.IStorageAdapter\-1.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Use Cases:</strong> Images (PNG, JPG), PDFs, serialized binary data
+</p>
+<p>
+<strong>Storage Traits:</strong> All traits use filesystem baseline defaults
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_BinaryFileStorageAdapter__ctor_System_String_"></a> BinaryFileStorageAdapter\(string\)
+
+```csharp
+public BinaryFileStorageAdapter(string filePath)
+```
+
+#### Parameters
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_BinaryFileStorageAdapter_Traits"></a> Traits
+
+Structural constraints and capabilities of this storage implementation.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+#### Remarks
+
+<p>
+Adapter authors must declare what their storage can and cannot do.
+These are intrinsic properties of the storage medium, not runtime state.
+</p>
+<p>
+Pipeline validation uses these traits to fail fast when a pipeline attempts
+invalid operations (e.g., writing to a read-only source).
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_BinaryFileStorageAdapter_Exists"></a> Exists\(\)
+
+Checks if data exists at this storage location.
+
+```csharp
+public FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+Effect that produces true if data exists, false otherwise
+
+#### Remarks
+
+<p>
+Delegates to the underlying medium's Exists check.
+Used to determine if a catalog entry is a seed (Layer 0 input).
+</p>
+
+### <a id="Flowthru_Data_Storage_BinaryFileStorageAdapter_InspectDeep"></a> InspectDeep\(\)
+
+Performs deep validation by examining the entire dataset.
+
+```csharp
+public FlowIO<ValidationResult> InspectDeep()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that all data is available, accessible, and valid.
+</p>
+<p>
+<strong>Additional Checks Beyond Shallow:</strong>
+</p>
+<ul><li>Validate ALL rows can be deserialized (not just sample)</li><li>Check data quality constraints across entire dataset</li><li>Detect corruption or inconsistencies throughout data</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Read and validate entire file</li><li>Memory adapters: Validate all stored data</li><li>Database adapters: Full table scan with validation</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Potentially expensive - only use when data integrity is critical.
+</p>
+
+### <a id="Flowthru_Data_Storage_BinaryFileStorageAdapter_InspectShallow_System_Int32_"></a> InspectShallow\(int\)
+
+Performs shallow validation by checking data availability and sampling a subset of data.
+
+```csharp
+public FlowIO<ValidationResult> InspectShallow(int sampleSize)
+```
+
+#### Parameters
+
+`sampleSize` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of rows/records to sample for validation
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that data is available and accessible.
+</p>
+<p>
+<strong>Typical Checks:</strong>
+</p>
+<ul><li>Data source exists (file, table, etc.)</li><li>Data source is accessible (permissions, connectivity)</li><li>Sample rows can be read and deserialized successfully</li><li>Schema matches expected structure</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Check file exists, read and validate sample rows</li><li>Memory adapters: Check if data has been initialized</li><li>Database adapters: Check table exists, query sample rows</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Should be fast (~10-100ms) - suitable for pre-flight validation.
+</p>
+
+### <a id="Flowthru_Data_Storage_BinaryFileStorageAdapter_Load"></a> Load\(\)
+
+Loads data from storage.
+
+```csharp
+public FlowIO<byte[]> Load()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[byte](https://learn.microsoft.com/dotnet/api/system.byte)\[\]\>
+
+Effect that produces data on success
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. medium.ReadStream()           → Stream
+2. format.DeserializeRows()      → IAsyncEnumerable&lt;TRow&gt;
+3. container.FromRows()          → TContainer</code></pre>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Errors from any layer are propagated:
+- Medium errors (file not found, access denied)
+- Format errors (parse failures, schema mismatches)
+- Container errors (memory allocation, type conversion)
+</p>
+
+### <a id="Flowthru_Data_Storage_BinaryFileStorageAdapter_Save_System_Byte___"></a> Save\(byte\[\]\)
+
+Saves data to storage.
+
+```csharp
+public FlowIO<FlowUnit> Save(byte[] data)
+```
+
+#### Parameters
+
+`data` [byte](https://learn.microsoft.com/dotnet/api/system.byte)\[\]
+
+The data to save
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
+Effect that completes on successful save
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. container.ToRows()            → IAsyncEnumerable&lt;TRow&gt;
+2. format.SerializeRows()        → Stream
+3. medium.WriteStream()          → FlowUnit</code></pre>
+<p>
+<strong>Atomicity:</strong>
+</p>
+<p>
+Implementations should strive for atomic saves to avoid partial writes on failure.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.ComposedStorageAdapter-2.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.ComposedStorageAdapter-2.md
new file mode 100644
index 00000000..74c45c72
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.ComposedStorageAdapter-2.md
@@ -0,0 +1,304 @@
+# <a id="Flowthru_Data_Storage_ComposedStorageAdapter_2"></a> Class ComposedStorageAdapter<TContainer, TRow\>
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Core.dll  
+
+Composed storage adapter that delegates to medium, format, and container layers.
+
+```csharp
+public sealed class ComposedStorageAdapter<TContainer, TRow> : IStorageAdapter<TContainer> where TRow : notnull
+```
+
+#### Type Parameters
+
+`TContainer` 
+
+The in-memory container type (IEnumerable, IDataView, Seq)
+
+`TRow` 
+
+The row schema type
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ComposedStorageAdapter<TContainer, TRow\>](Flowthru.Data.Storage.ComposedStorageAdapter\-2.md)
+
+#### Implements
+
+[IStorageAdapter<TContainer\>](Flowthru.Data.Storage.IStorageAdapter\-1.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Examples
+
+<pre><code class="lang-csharp">// CSV file with IEnumerable container
+var csvEnum = new ComposedStorageAdapter&lt;IEnumerable&lt;Company&gt;, Company&gt;(
+    medium: new FileStorageMedium("data.csv"),
+    format: new CsvFormatSerializer&lt;Company&gt;(),
+    container: new EnumerableContainerAdapter&lt;Company&gt;()
+);
+
+// Same CSV file with IDataView container
+var csvDataView = new ComposedStorageAdapter&lt;IDataView, Company&gt;(
+    medium: new FileStorageMedium("data.csv"),
+    format: new CsvFormatSerializer&lt;Company&gt;(),
+    container: new DataViewContainerAdapter&lt;Company&gt;(mlContext)
+);
+
+// JSON in memory with IEnumerable container
+var jsonEnumerable = new ComposedStorageAdapter&lt;IEnumerable&lt;Order&gt;, Order&gt;(
+    medium: new MemoryStorageMedium(),
+    format: new JsonFormatSerializer&lt;Order&gt;(),
+    container: new EnumerableContainerAdapter&lt;Order&gt;()
+);</code></pre>
+
+## Remarks
+
+<p>
+<strong>Composition Pattern:</strong>
+</p>
+<p>
+This class composes three independent concerns:
+</p>
+<pre><code class="lang-csharp">Medium (WHERE)    → Format (HOW)         → Container (WHAT)
+File/Memory/Net   → CSV/JSON/Parquet     → IEnumerable/IDataView/Seq</code></pre>
+<p>
+<strong>Multiplicative Flexibility:</strong>
+</p>
+<p>
+With M mediums, F formats, and C containers, you get M × F × C combinations
+with only M + F + C implementations.
+</p>
+<p>
+Example: 3 mediums × 4 formats × 3 containers = 36 combinations with 10 implementations.
+</p>
+<p>
+<strong>Capability Implementation:</strong>
+</p>
+<p>
+This adapter can optionally implement capability interfaces based on the
+underlying medium and format capabilities. Capabilities are implemented
+as explicit interface implementations to avoid polluting the base interface.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_ComposedStorageAdapter_2__ctor_Flowthru_Data_Storage_IStorageMedium_Flowthru_Data_Storage_IFormatSerializer__1__Flowthru_Data_Storage_IContainerAdapter__0__1__"></a> ComposedStorageAdapter\(IStorageMedium, IFormatSerializer<TRow\>, IContainerAdapter<TContainer, TRow\>\)
+
+Creates a new composed storage adapter.
+
+```csharp
+public ComposedStorageAdapter(IStorageMedium medium, IFormatSerializer<TRow> format, IContainerAdapter<TContainer, TRow> container)
+```
+
+#### Parameters
+
+`medium` [IStorageMedium](Flowthru.Data.Storage.IStorageMedium.md)
+
+The storage medium (file, memory, etc.)
+
+`format` [IFormatSerializer](Flowthru.Data.Storage.IFormatSerializer\-1.md)<TRow\>
+
+The format serializer (CSV, JSON, etc.)
+
+`container` [IContainerAdapter](Flowthru.Data.Storage.IContainerAdapter\-2.md)<TContainer, TRow\>
+
+The container adapter (IEnumerable, IDataView, etc.)
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_ComposedStorageAdapter_2_Traits"></a> Traits
+
+Structural constraints and capabilities of this storage implementation.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+#### Remarks
+
+<p>
+Adapter authors must declare what their storage can and cannot do.
+These are intrinsic properties of the storage medium, not runtime state.
+</p>
+<p>
+Pipeline validation uses these traits to fail fast when a pipeline attempts
+invalid operations (e.g., writing to a read-only source).
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_ComposedStorageAdapter_2_Exists"></a> Exists\(\)
+
+Checks if data exists at this storage location.
+
+```csharp
+public FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+Effect that produces true if data exists, false otherwise
+
+#### Remarks
+
+<p>
+Delegates to the underlying medium's Exists check.
+Used to determine if a catalog entry is a seed (Layer 0 input).
+</p>
+
+### <a id="Flowthru_Data_Storage_ComposedStorageAdapter_2_InspectDeep"></a> InspectDeep\(\)
+
+Performs deep validation by examining the entire dataset.
+
+```csharp
+public FlowIO<ValidationResult> InspectDeep()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that all data is available, accessible, and valid.
+</p>
+<p>
+<strong>Additional Checks Beyond Shallow:</strong>
+</p>
+<ul><li>Validate ALL rows can be deserialized (not just sample)</li><li>Check data quality constraints across entire dataset</li><li>Detect corruption or inconsistencies throughout data</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Read and validate entire file</li><li>Memory adapters: Validate all stored data</li><li>Database adapters: Full table scan with validation</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Potentially expensive - only use when data integrity is critical.
+</p>
+
+### <a id="Flowthru_Data_Storage_ComposedStorageAdapter_2_InspectShallow_System_Int32_"></a> InspectShallow\(int\)
+
+Performs shallow validation by checking data availability and sampling a subset of data.
+
+```csharp
+public FlowIO<ValidationResult> InspectShallow(int sampleSize)
+```
+
+#### Parameters
+
+`sampleSize` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of rows/records to sample for validation
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that data is available and accessible.
+</p>
+<p>
+<strong>Typical Checks:</strong>
+</p>
+<ul><li>Data source exists (file, table, etc.)</li><li>Data source is accessible (permissions, connectivity)</li><li>Sample rows can be read and deserialized successfully</li><li>Schema matches expected structure</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Check file exists, read and validate sample rows</li><li>Memory adapters: Check if data has been initialized</li><li>Database adapters: Check table exists, query sample rows</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Should be fast (~10-100ms) - suitable for pre-flight validation.
+</p>
+
+### <a id="Flowthru_Data_Storage_ComposedStorageAdapter_2_Load"></a> Load\(\)
+
+Loads data from storage.
+
+```csharp
+public FlowIO<TContainer> Load()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<TContainer\>
+
+Effect that produces data on success
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. medium.ReadStream()           → Stream
+2. format.DeserializeRows()      → IAsyncEnumerable&lt;TRow&gt;
+3. container.FromRows()          → TContainer</code></pre>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Errors from any layer are propagated:
+- Medium errors (file not found, access denied)
+- Format errors (parse failures, schema mismatches)
+- Container errors (memory allocation, type conversion)
+</p>
+
+### <a id="Flowthru_Data_Storage_ComposedStorageAdapter_2_Save__0_"></a> Save\(TContainer\)
+
+Saves data to storage.
+
+```csharp
+public FlowIO<FlowUnit> Save(TContainer data)
+```
+
+#### Parameters
+
+`data` TContainer
+
+The data to save
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
+Effect that completes on successful save
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. container.ToRows()            → IAsyncEnumerable&lt;TRow&gt;
+2. format.SerializeRows()        → Stream
+3. medium.WriteStream()          → FlowUnit</code></pre>
+<p>
+<strong>Atomicity:</strong>
+</p>
+<p>
+Implementations should strive for atomic saves to avoid partial writes on failure.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Container.EnumerableContainerAdapter-1.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Container.EnumerableContainerAdapter-1.md
new file mode 100644
index 00000000..f8cb82b9
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Container.EnumerableContainerAdapter-1.md
@@ -0,0 +1,143 @@
+# <a id="Flowthru_Data_Storage_Container_EnumerableContainerAdapter_1"></a> Class EnumerableContainerAdapter<T\>
+
+Namespace: [Flowthru.Data.Storage.Container](Flowthru.Data.Storage.Container.md)  
+Assembly: Flowthru.Core.dll  
+
+Container adapter for IEnumerable&lt;T&gt; - standard .NET collection type.
+
+```csharp
+public sealed class EnumerableContainerAdapter<T> : IContainerAdapter<IEnumerable<T>, T>
+```
+
+#### Type Parameters
+
+`T` 
+
+The element type
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[EnumerableContainerAdapter<T\>](Flowthru.Data.Storage.Container.EnumerableContainerAdapter\-1.md)
+
+#### Implements
+
+[IContainerAdapter<IEnumerable<T\>, T\>](Flowthru.Data.Storage.IContainerAdapter\-2.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Examples
+
+<pre><code class="lang-csharp">var adapter = new EnumerableContainerAdapter&lt;CompanySchema&gt;();
+
+// From rows (materializes to List)
+var companies = await adapter.FromRows(rowStream);
+
+// Multiple enumeration - safe
+var count = companies.Count();
+var firstFive = companies.Take(5).ToList();
+
+// Back to rows
+var rowsAgain = adapter.ToRows(companies);</code></pre>
+
+## Remarks
+
+<p>
+<strong>Characteristics:</strong>
+</p>
+<ul><li><strong>Eager materialization:</strong> Loads all rows into memory (List)</li><li><strong>Standard .NET:</strong> Works with all .NET LINQ operations</li><li><strong>Multiple enumeration:</strong> Safe - data is cached in memory</li><li><strong>Memory bound:</strong> Not suitable for very large datasets</li></ul>
+<p>
+<strong>Use Cases:</strong>
+</p>
+<ul><li>Small to medium datasets (&lt;100K rows)</li><li>When multiple enumerations are needed</li><li>Standard .NET pipelines without functional dependencies</li><li>Testing and prototyping</li></ul>
+<p>
+<strong>Alternatives:</strong>
+</p>
+<ul><li><strong>Large datasets:</strong> Use DataViewContainerAdapter&lt;T&gt; for ML.NET IDataView</li><li><strong>Lazy evaluation:</strong> Use SeqContainerAdapter&lt;T&gt; for LanguageExt Seq</li></ul>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_Container_EnumerableContainerAdapter_1__ctor"></a> EnumerableContainerAdapter\(\)
+
+Creates a new enumerable container adapter.
+
+```csharp
+public EnumerableContainerAdapter()
+```
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_Container_EnumerableContainerAdapter_1_FromRows_System_Collections_Generic_IAsyncEnumerable__0__"></a> FromRows\(IAsyncEnumerable<T\>\)
+
+Materializes an async stream of rows into an in-memory container.
+
+```csharp
+public Task<IEnumerable<T>> FromRows(IAsyncEnumerable<T> rows)
+```
+
+#### Parameters
+
+`rows` [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<T\>
+
+Async stream of rows from format deserialization
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>\>
+
+Task producing the populated container
+
+#### Remarks
+
+<p>
+<strong>Materialization Strategy:</strong>
+</p>
+<p>
+Different containers have different materialization approaches:
+</p>
+<ul><li><strong>IEnumerable:</strong> Eager - load all rows into List</li><li><strong>Seq:</strong> Lazy - wrap async enumerable</li><li><strong>IDataView:</strong> Columnar - convert to columnar format</li></ul>
+<p>
+<strong>Memory Considerations:</strong>
+</p>
+<p>
+Be aware that eager containers (IEnumerable) will load all data into memory.
+For large datasets, prefer streaming containers (Seq, IDataView with lazy loading).
+</p>
+
+### <a id="Flowthru_Data_Storage_Container_EnumerableContainerAdapter_1_ToRows_System_Collections_Generic_IEnumerable__0__"></a> ToRows\(IEnumerable<T\>\)
+
+Converts an in-memory container back to an async stream of rows.
+
+```csharp
+public IAsyncEnumerable<T> ToRows(IEnumerable<T> container)
+```
+
+#### Parameters
+
+`container` [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>
+
+The container to stream from
+
+#### Returns
+
+ [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<T\>
+
+Async enumerable of rows for format serialization
+
+#### Remarks
+
+<p>
+<strong>Streaming Strategy:</strong>
+</p>
+<p>
+Rows should be yielded lazily if the container supports it:
+</p>
+<ul><li><strong>IEnumerable:</strong> Enumerate and yield</li><li><strong>Seq:</strong> Already lazy - expose as async enumerable</li><li><strong>IDataView:</strong> Enumerate rows from columnar format</li></ul>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Container.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Container.md
new file mode 100644
index 00000000..2501a501
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Container.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Data_Storage_Container"></a> Namespace Flowthru.Data.Storage.Container
+
+### Classes
+
+ [EnumerableContainerAdapter<T\>](Flowthru.Data.Storage.Container.EnumerableContainerAdapter\-1.md)
+
+Container adapter for IEnumerable&lt;T&gt; - standard .NET collection type.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Format.JsonFormatSerializer-1.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Format.JsonFormatSerializer-1.md
new file mode 100644
index 00000000..b4ff515f
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Format.JsonFormatSerializer-1.md
@@ -0,0 +1,331 @@
+# <a id="Flowthru_Data_Storage_Format_JsonFormatSerializer_1"></a> Class JsonFormatSerializer<TRow\>
+
+Namespace: [Flowthru.Data.Storage.Format](Flowthru.Data.Storage.Format.md)  
+Assembly: Flowthru.Core.dll  
+
+Format serializer for JSON (JavaScript Object Notation) files.
+
+```csharp
+public sealed class JsonFormatSerializer<TRow> : IFormatSerializer<TRow> where TRow : notnull, IStructuredSerializable
+```
+
+#### Type Parameters
+
+`TRow` 
+
+The row schema type
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[JsonFormatSerializer<TRow\>](Flowthru.Data.Storage.Format.JsonFormatSerializer\-1.md)
+
+#### Implements
+
+[IFormatSerializer<TRow\>](Flowthru.Data.Storage.IFormatSerializer\-1.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Examples
+
+<pre><code class="lang-csharp">// Flat schema
+public record MetricsSchema(
+    double Accuracy,
+    double Precision,
+    double Recall
+) : IFlatSchema, IStructuredSerializable;
+
+// Nested schema
+public record ResultsSchema(
+    List&lt;MetricsSchema&gt; FoldMetrics,
+    double MeanAccuracy
+) : INestedSchema, IStructuredSerializable;
+
+var serializer = new JsonFormatSerializer&lt;ResultsSchema&gt;();
+
+// Serialize
+var results = new[] {
+    new ResultsSchema(new List&lt;MetricsSchema&gt; { /* ... */ }, 0.95)
+};
+
+using var writeStream = File.Create("results.json");
+await serializer.SerializeRows(writeStream, results.ToAsyncEnumerable());</code></pre>
+
+## Remarks
+
+<p>
+<strong>Type Constraints:</strong>
+</p>
+<p>
+TRow must implement <xref href="Flowthru.Abstractions.IStructuredSerializable" data-throw-if-not-resolved="false"></xref>, which supports both:
+</p>
+<ul><li><xref href="Flowthru.Abstractions.IFlatSchema" data-throw-if-not-resolved="false"></xref> - Simple flat structures</li><li><xref href="Flowthru.Abstractions.INestedSchema" data-throw-if-not-resolved="false"></xref> - Complex nested structures</li></ul>
+<p>
+JSON is flexible and can handle any schema structure, making it suitable for:
+- Configuration objects
+- Model metadata and metrics
+- Nested result structures
+- Human-readable data files
+</p>
+<p>
+<strong>Configuration:</strong>
+</p>
+<p>
+Uses System.Text.Json with default configuration:
+- WriteIndented = true (pretty printing)
+- PropertyNamingPolicy = CamelCase
+- DefaultIgnoreCondition = WhenWritingNull
+</p>
+<p>
+Custom JsonSerializerOptions can be provided via constructor.
+</p>
+<p>
+<strong>Streaming Behavior:</strong>
+</p>
+<p>
+JSON serialization streams rows as a JSON array:
+</p>
+<pre><code class="lang-csharp">[
+  { "id": 1, "name": "Item 1" },
+  { "id": 2, "name": "Item 2" }
+]</code></pre>
+<p>
+Both deserialization and serialization are streaming, yielding/consuming
+rows lazily for memory efficiency.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_Format_JsonFormatSerializer_1__ctor"></a> JsonFormatSerializer\(\)
+
+Creates a new JSON format serializer with default configuration.
+
+```csharp
+public JsonFormatSerializer()
+```
+
+#### Remarks
+
+<p>
+<strong>Property Naming:</strong> No default naming policy is applied.
+Use <xref href="Flowthru.Abstractions.SerializedLabelAttribute" data-throw-if-not-resolved="false"></xref> to specify property names explicitly.
+If no SerializedLabel is present, the C# property name is used as-is.
+</p>
+
+### <a id="Flowthru_Data_Storage_Format_JsonFormatSerializer_1__ctor_System_Text_Json_JsonSerializerOptions_"></a> JsonFormatSerializer\(JsonSerializerOptions\)
+
+Creates a new JSON format serializer with custom options.
+
+```csharp
+public JsonFormatSerializer(JsonSerializerOptions options)
+```
+
+#### Parameters
+
+`options` [JsonSerializerOptions](https://learn.microsoft.com/dotnet/api/system.text.json.jsonserializeroptions)
+
+JSON serialization options
+
+#### Exceptions
+
+ [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception)
+
+Thrown if options is null
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_Format_JsonFormatSerializer_1_Options"></a> Options
+
+Gets the JSON serialization options for this serializer.
+
+```csharp
+public JsonSerializerOptions Options { get; }
+```
+
+#### Property Value
+
+ [JsonSerializerOptions](https://learn.microsoft.com/dotnet/api/system.text.json.jsonserializeroptions)
+
+### <a id="Flowthru_Data_Storage_Format_JsonFormatSerializer_1_Traits"></a> Traits
+
+Structural capabilities of this format serializer.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+#### Remarks
+
+<p>
+Format traits focus on HOW data is serialized and whether it supports streaming.
+For composed adapters, these traits are merged with medium and container traits.
+</p>
+<p>
+Most formats should declare <code>CanStream = true</code> if they can deserialize row-by-row
+without buffering the entire stream (e.g., CSV, JSONL). Formats that require full
+parsing before yielding rows (e.g., JSON arrays) should set <code>CanStream = false</code>.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_Format_JsonFormatSerializer_1_DeserializeRows_System_IO_Stream_"></a> DeserializeRows\(Stream\)
+
+Deserializes a stream of bytes into a stream of rows.
+
+```csharp
+public IAsyncEnumerable<TRow> DeserializeRows(Stream stream)
+```
+
+#### Parameters
+
+`stream` [Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)
+
+The stream containing serialized data
+
+#### Returns
+
+ [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<TRow\>
+
+Async enumerable of deserialized rows
+
+#### Remarks
+
+<p>
+<strong>Streaming Behavior:</strong>
+</p>
+<p>
+Rows should be yielded as they are deserialized (lazy evaluation).
+This allows processing large datasets without loading everything into memory.
+</p>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Deserialization errors should throw exceptions:
+- Format exceptions (malformed CSV, invalid JSON)
+- Schema mismatches (missing columns, type conversion failures)
+- I/O errors during stream reading
+</p>
+<p>
+The caller should handle these exceptions appropriately.
+</p>
+
+### <a id="Flowthru_Data_Storage_Format_JsonFormatSerializer_1_GetPropertyMappingConfiguration"></a> GetPropertyMappingConfiguration\(\)
+
+Configures how this serializer handles property-to-field name mapping for the schema.
+
+```csharp
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+```
+
+#### Returns
+
+ [PropertyMappingConfiguration](Flowthru.Data.Storage.PropertyMappingConfiguration.md)
+
+Property mapping configuration describing the mapping strategy
+
+#### Examples
+
+<pre><code class="lang-csharp">// CSV serializer using SerializedLabel
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+    =&gt; PropertyMappingConfiguration.FromSerializedLabel&lt;TRow&gt;();
+
+// ML.NET serializer using native attributes
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+    =&gt; PropertyMappingConfiguration.FromNativeAttributes("LoadColumnAttribute");
+
+// Parquet with library-controlled mapping
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+    =&gt; PropertyMappingConfiguration.LibraryControlled();</code></pre>
+
+#### Remarks
+
+<p>
+<strong>Contractual Obligation:</strong> Every format serializer MUST implement this method
+to explicitly declare how it handles property name mapping.
+</p>
+<p>
+<strong>Implementation Strategies:</strong>
+</p>
+<ul><li>
+<strong>SerializedLabel Support:</strong> Use <xref href="Flowthru.Data.Storage.Format.PropertyMappingHelper" data-throw-if-not-resolved="false"></xref>
+to respect [SerializedLabel] attributes. Return <xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.FromSerializedLabel%60%601" data-throw-if-not-resolved="false"></xref>.
+</li><li>
+<strong>Native Attribute Mapping:</strong> Use format-specific attributes (e.g., ML.NET's [LoadColumn]).
+Return <xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.FromNativeAttributes(System.String)" data-throw-if-not-resolved="false"></xref> with the attribute type name.
+</li><li>
+<strong>Library-Controlled:</strong> When the underlying library handles mapping internally
+(e.g., Parquet.NET with no programmatic API). Return PropertyMappingConfiguration.LibraryControlled().
+</li><li>
+<strong>Adapter Pattern:</strong> Bridge between SerializedLabel and native attributes.
+Return <xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.FromAdapter%60%601" data-throw-if-not-resolved="false"></xref>.
+</li></ul>
+<p>
+<strong>Design Intent:</strong> This contract makes property mapping an explicit, discoverable
+capability rather than an implicit behavior, enabling:
+</p>
+<ul><li>Runtime introspection of mapping capabilities</li><li>Better error messages when schemas don't match storage</li><li>Documentation generation for serializer capabilities</li><li>Testing framework validation of mapping correctness</li></ul>
+
+### <a id="Flowthru_Data_Storage_Format_JsonFormatSerializer_1_SerializeRows_System_IO_Stream_System_Collections_Generic_IAsyncEnumerable__0__"></a> SerializeRows\(Stream, IAsyncEnumerable<TRow\>\)
+
+Serializes a stream of rows into a stream of bytes.
+
+```csharp
+public Task SerializeRows(Stream stream, IAsyncEnumerable<TRow> rows)
+```
+
+#### Parameters
+
+`stream` [Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)
+
+The stream to write serialized data to
+
+`rows` [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<TRow\>
+
+The rows to serialize
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
+
+Task that completes when serialization finishes
+
+#### Remarks
+
+<p>
+<strong>Streaming Behavior:</strong>
+</p>
+<p>
+Rows should be written as they are enumerated (lazy evaluation).
+This allows handling large datasets efficiently.
+</p>
+<p>
+<strong>Format-Specific Headers:</strong>
+</p>
+<p>
+Implementations should handle format-specific initialization:
+- CSV: Write header row with column names
+- JSON: Write opening bracket for array
+- Parquet: Write schema metadata
+</p>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Serialization errors should throw exceptions:
+- Type conversion failures
+- I/O errors during stream writing
+- Invalid data values for format constraints
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Format.PropertyMappingHelper.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Format.PropertyMappingHelper.md
new file mode 100644
index 00000000..4e17c4b8
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Format.PropertyMappingHelper.md
@@ -0,0 +1,122 @@
+# <a id="Flowthru_Data_Storage_Format_PropertyMappingHelper"></a> Class PropertyMappingHelper
+
+Namespace: [Flowthru.Data.Storage.Format](Flowthru.Data.Storage.Format.md)  
+Assembly: Flowthru.Core.dll  
+
+Helper for mapping external field names to C# property names using SerializedLabel attribute.
+
+```csharp
+public static class PropertyMappingHelper
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PropertyMappingHelper](Flowthru.Data.Storage.Format.PropertyMappingHelper.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Purpose:</strong> Centralized property mapping logic used by all format serializers.
+</p>
+<p>
+<strong>Mapping Strategy:</strong>
+</p>
+<ol><li>Check for [SerializedLabel] attribute - if present, use that label</li><li>Fall back to property name if no attribute</li><li>Use case-insensitive comparison for lookups</li></ol>
+<p>
+<strong>Extensibility:</strong> New format serializers should use this helper to ensure
+consistent behavior across all storage mechanisms.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_Format_PropertyMappingHelper_BuildPropertyMap__1"></a> BuildPropertyMap<T\>\(\)
+
+Builds a mapping from external field names to PropertyInfo objects.
+
+```csharp
+public static Dictionary<string, PropertyInfo> BuildPropertyMap<T>()
+```
+
+#### Returns
+
+ [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [PropertyInfo](https://learn.microsoft.com/dotnet/api/system.reflection.propertyinfo)\>
+
+Dictionary mapping external field names (case-insensitive) to PropertyInfo
+
+#### Type Parameters
+
+`T` 
+
+The schema type
+
+#### Examples
+
+<pre><code class="lang-csharp">// Build property map for a schema
+var propertyMap = PropertyMappingHelper.BuildPropertyMap&lt;ShuttleSchema&gt;();
+
+// Look up property by external field name
+if (propertyMap.TryGetValue("shuttle_location", out var property))
+{
+    // Maps to ShuttleLocation property
+    var value = reader.GetValue("shuttle_location");
+    property.SetValue(instance, value);
+}</code></pre>
+
+#### Remarks
+
+<p>
+The returned dictionary uses case-insensitive string comparison, allowing flexible
+matching of external field names regardless of casing.
+</p>
+<p>
+<strong>Lookup Priority:</strong>
+</p>
+<ol><li>[SerializedLabel("field_name")] - explicit attribute takes precedence</li><li>Property.Name - fallback if no attribute present</li></ol>
+
+### <a id="Flowthru_Data_Storage_Format_PropertyMappingHelper_GetFieldName_System_Reflection_PropertyInfo_"></a> GetFieldName\(PropertyInfo\)
+
+Gets the external field name for a property.
+
+```csharp
+public static string GetFieldName(PropertyInfo property)
+```
+
+#### Parameters
+
+`property` [PropertyInfo](https://learn.microsoft.com/dotnet/api/system.reflection.propertyinfo)
+
+The property to get the field name for
+
+#### Returns
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+The external field name (from SerializedLabel or property name)
+
+#### Examples
+
+<pre><code class="lang-csharp">var properties = typeof(ShuttleSchema).GetProperties();
+foreach (var property in properties)
+{
+    var fieldName = PropertyMappingHelper.GetFieldName(property);
+    writer.WriteField(fieldName, property.GetValue(instance));
+}</code></pre>
+
+#### Remarks
+
+<p>
+This method is useful for serialization scenarios where you need to write
+property values to external storage with the correct field names.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Format.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Format.md
new file mode 100644
index 00000000..8fa95b1a
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Format.md
@@ -0,0 +1,12 @@
+# <a id="Flowthru_Data_Storage_Format"></a> Namespace Flowthru.Data.Storage.Format
+
+### Classes
+
+ [JsonFormatSerializer<TRow\>](Flowthru.Data.Storage.Format.JsonFormatSerializer\-1.md)
+
+Format serializer for JSON (JavaScript Object Notation) files.
+
+ [PropertyMappingHelper](Flowthru.Data.Storage.Format.PropertyMappingHelper.md)
+
+Helper for mapping external field names to C# property names using SerializedLabel attribute.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.IContainerAdapter-2.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.IContainerAdapter-2.md
new file mode 100644
index 00000000..3d8be172
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.IContainerAdapter-2.md
@@ -0,0 +1,136 @@
+# <a id="Flowthru_Data_Storage_IContainerAdapter_2"></a> Interface IContainerAdapter<TContainer, TRow\>
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Core.dll  
+
+Interface for container adaptation - converts between streaming rows and in-memory containers.
+
+```csharp
+public interface IContainerAdapter<TContainer, TRow>
+```
+
+#### Type Parameters
+
+`TContainer` 
+
+The in-memory container type (IEnumerable, IDataView, Seq, etc.)
+
+`TRow` 
+
+The row type (schema)
+
+## Examples
+
+<pre><code class="lang-csharp">// IEnumerable container adapter
+var enumerableAdapter = new EnumerableContainerAdapter&lt;CompanySchema&gt;();
+var companies = await enumerableAdapter.FromRows(rowStream);
+// Type: IEnumerable&lt;CompanySchema&gt;
+
+// IDataView container adapter
+var dataViewAdapter = new DataViewContainerAdapter&lt;CompanySchema&gt;(mlContext);
+var dataView = await dataViewAdapter.FromRows(rowStream);
+// Type: IDataView (ML.NET)</code></pre>
+
+## Remarks
+
+<p>
+<strong>Responsibility:</strong> Abstract WHAT in-memory representation to use for data.
+</p>
+<p>
+<strong>Separation of Concerns:</strong>
+</p>
+<p>
+The container adapter is isolated from:
+- Storage location (file vs memory) - handled by <xref href="Flowthru.Data.Storage.IStorageMedium" data-throw-if-not-resolved="false"></xref>
+- Serialization format (CSV vs JSON) - handled by <xref href="Flowthru.Data.Storage.IFormatSerializer%601" data-throw-if-not-resolved="false"></xref>
+</p>
+<p>
+<strong>Bridge Pattern:</strong>
+</p>
+<p>
+This adapter bridges between:
+- <strong>Streaming rows</strong> (<xref href="System.Collections.Generic.IAsyncEnumerable%601" data-throw-if-not-resolved="false"></xref>) - format layer
+- <strong>In-memory container</strong> (IEnumerable, IDataView) - application layer
+</p>
+<p>
+<strong>Container Type Examples:</strong>
+</p>
+<ul><li><strong>IEnumerable&lt;TRow&gt;</strong> - Standard .NET collections</li><li><strong>IDataView</strong> - ML.NET's columnar data representation</li><li><strong>DataFrame</strong> - Pandas-style dataframe (future)</li><li><strong>IObservable&lt;TRow&gt;</strong> - Reactive streams (future)</li></ul>
+<p>
+<strong>Design Pattern:</strong>
+</p>
+<p>
+This is the top layer in the composition pattern:
+</p>
+<pre><code class="lang-csharp">Medium (bytes) → Format (rows) → Container (in-memory)
+Stream         → IAsyncEnumerable&lt;TRow&gt; → IEnumerable&lt;TRow&gt; / IDataView</code></pre>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_IContainerAdapter_2_FromRows_System_Collections_Generic_IAsyncEnumerable__1__"></a> FromRows\(IAsyncEnumerable<TRow\>\)
+
+Materializes an async stream of rows into an in-memory container.
+
+```csharp
+Task<TContainer> FromRows(IAsyncEnumerable<TRow> rows)
+```
+
+#### Parameters
+
+`rows` [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<TRow\>
+
+Async stream of rows from format deserialization
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TContainer\>
+
+Task producing the populated container
+
+#### Remarks
+
+<p>
+<strong>Materialization Strategy:</strong>
+</p>
+<p>
+Different containers have different materialization approaches:
+</p>
+<ul><li><strong>IEnumerable:</strong> Eager - load all rows into List</li><li><strong>Seq:</strong> Lazy - wrap async enumerable</li><li><strong>IDataView:</strong> Columnar - convert to columnar format</li></ul>
+<p>
+<strong>Memory Considerations:</strong>
+</p>
+<p>
+Be aware that eager containers (IEnumerable) will load all data into memory.
+For large datasets, prefer streaming containers (Seq, IDataView with lazy loading).
+</p>
+
+### <a id="Flowthru_Data_Storage_IContainerAdapter_2_ToRows__0_"></a> ToRows\(TContainer\)
+
+Converts an in-memory container back to an async stream of rows.
+
+```csharp
+IAsyncEnumerable<TRow> ToRows(TContainer container)
+```
+
+#### Parameters
+
+`container` TContainer
+
+The container to stream from
+
+#### Returns
+
+ [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<TRow\>
+
+Async enumerable of rows for format serialization
+
+#### Remarks
+
+<p>
+<strong>Streaming Strategy:</strong>
+</p>
+<p>
+Rows should be yielded lazily if the container supports it:
+</p>
+<ul><li><strong>IEnumerable:</strong> Enumerate and yield</li><li><strong>Seq:</strong> Already lazy - expose as async enumerable</li><li><strong>IDataView:</strong> Enumerate rows from columnar format</li></ul>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.IFormatSerializer-1.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.IFormatSerializer-1.md
new file mode 100644
index 00000000..2ebbffca
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.IFormatSerializer-1.md
@@ -0,0 +1,260 @@
+# <a id="Flowthru_Data_Storage_IFormatSerializer_1"></a> Interface IFormatSerializer<TRow\>
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Core.dll  
+
+Interface for format serialization - handles row-based serialization/deserialization.
+
+```csharp
+public interface IFormatSerializer<TRow> where TRow : notnull
+```
+
+#### Type Parameters
+
+`TRow` 
+
+The row type (schema) to serialize
+
+## Examples
+
+<pre><code class="lang-csharp">// CSV serializer with flat schema constraint
+var csvSerializer = new CsvFormatSerializer&lt;CompanySchema&gt;();
+
+// Deserialize from stream to rows
+await foreach (var row in csvSerializer.DeserializeRows(stream))
+{
+    Console.WriteLine($"Company: {row.Name}");
+}
+
+// Serialize rows to stream
+await csvSerializer.SerializeRows(stream, rows);</code></pre>
+
+## Remarks
+
+<p>
+<strong>Responsibility:</strong> Abstract HOW data is serialized (CSV, JSON, Parquet, etc.).
+</p>
+<p>
+<strong>Separation of Concerns:</strong>
+</p>
+<p>
+The format serializer is isolated from:
+- Storage location (file vs memory) - handled by <xref href="Flowthru.Data.Storage.IStorageMedium" data-throw-if-not-resolved="false"></xref>
+- Container type (IEnumerable vs IDataView) - handled by <xref href="Flowthru.Data.Storage.IContainerAdapter%602" data-throw-if-not-resolved="false"></xref>
+</p>
+<p>
+<strong>Streaming Design:</strong>
+</p>
+<p>
+Uses <xref href="System.Collections.Generic.IAsyncEnumerable%601" data-throw-if-not-resolved="false"></xref> for row streaming to:
+- Support large datasets without loading everything into memory
+- Enable backpressure and cancellation
+- Allow format-agnostic streaming pipelines
+</p>
+<p>
+<strong>Type Constraints:</strong>
+</p>
+<p>
+The <code>notnull</code> constraint ensures all format serializers support modern C# patterns:
+</p>
+<ul><li><strong>Traditional schemas:</strong> Classes/records with parameterless constructors</li><li><strong>Required members:</strong> C# 11+ schemas with <code>required</code> properties</li><li><strong>Positional records:</strong> Records with primary constructors</li></ul>
+<p>
+This constraint explicitly prohibits the <code>new()</code> constraint, which is incompatible
+with required members and positional records. Format serializers must use
+<xref href="Flowthru.Data.Storage.SchemaActivator" data-throw-if-not-resolved="false"></xref> or equivalent techniques to instantiate schemas.
+</p>
+<p>
+Format serializers may add additional constraints for format-specific requirements:
+</p>
+<pre><code class="lang-csharp">public class CsvFormatSerializer&lt;T&gt; : IFormatSerializer&lt;T&gt;
+    where T : notnull, IFlatSchema, ITextSerializable
+{
+    // Compile-time enforcement: notnull + flat + text serializable
+}</code></pre>
+<p>
+<strong>Design Pattern:</strong>
+</p>
+<p>
+This is the middle layer in the composition pattern:
+</p>
+<pre><code class="lang-csharp">Medium (bytes) → Format (rows) → Container (in-memory)
+Stream         → IAsyncEnumerable&lt;TRow&gt; → IEnumerable&lt;TRow&gt;</code></pre>
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_IFormatSerializer_1_Traits"></a> Traits
+
+Structural capabilities of this format serializer.
+
+```csharp
+StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+#### Remarks
+
+<p>
+Format traits focus on HOW data is serialized and whether it supports streaming.
+For composed adapters, these traits are merged with medium and container traits.
+</p>
+<p>
+Most formats should declare <code>CanStream = true</code> if they can deserialize row-by-row
+without buffering the entire stream (e.g., CSV, JSONL). Formats that require full
+parsing before yielding rows (e.g., JSON arrays) should set <code>CanStream = false</code>.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_IFormatSerializer_1_DeserializeRows_System_IO_Stream_"></a> DeserializeRows\(Stream\)
+
+Deserializes a stream of bytes into a stream of rows.
+
+```csharp
+IAsyncEnumerable<TRow> DeserializeRows(Stream stream)
+```
+
+#### Parameters
+
+`stream` [Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)
+
+The stream containing serialized data
+
+#### Returns
+
+ [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<TRow\>
+
+Async enumerable of deserialized rows
+
+#### Remarks
+
+<p>
+<strong>Streaming Behavior:</strong>
+</p>
+<p>
+Rows should be yielded as they are deserialized (lazy evaluation).
+This allows processing large datasets without loading everything into memory.
+</p>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Deserialization errors should throw exceptions:
+- Format exceptions (malformed CSV, invalid JSON)
+- Schema mismatches (missing columns, type conversion failures)
+- I/O errors during stream reading
+</p>
+<p>
+The caller should handle these exceptions appropriately.
+</p>
+
+### <a id="Flowthru_Data_Storage_IFormatSerializer_1_GetPropertyMappingConfiguration"></a> GetPropertyMappingConfiguration\(\)
+
+Configures how this serializer handles property-to-field name mapping for the schema.
+
+```csharp
+PropertyMappingConfiguration GetPropertyMappingConfiguration()
+```
+
+#### Returns
+
+ [PropertyMappingConfiguration](Flowthru.Data.Storage.PropertyMappingConfiguration.md)
+
+Property mapping configuration describing the mapping strategy
+
+#### Examples
+
+<pre><code class="lang-csharp">// CSV serializer using SerializedLabel
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+    =&gt; PropertyMappingConfiguration.FromSerializedLabel&lt;TRow&gt;();
+
+// ML.NET serializer using native attributes
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+    =&gt; PropertyMappingConfiguration.FromNativeAttributes("LoadColumnAttribute");
+
+// Parquet with library-controlled mapping
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+    =&gt; PropertyMappingConfiguration.LibraryControlled();</code></pre>
+
+#### Remarks
+
+<p>
+<strong>Contractual Obligation:</strong> Every format serializer MUST implement this method
+to explicitly declare how it handles property name mapping.
+</p>
+<p>
+<strong>Implementation Strategies:</strong>
+</p>
+<ul><li>
+<strong>SerializedLabel Support:</strong> Use <xref href="Flowthru.Data.Storage.Format.PropertyMappingHelper" data-throw-if-not-resolved="false"></xref>
+to respect [SerializedLabel] attributes. Return <xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.FromSerializedLabel%60%601" data-throw-if-not-resolved="false"></xref>.
+</li><li>
+<strong>Native Attribute Mapping:</strong> Use format-specific attributes (e.g., ML.NET's [LoadColumn]).
+Return <xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.FromNativeAttributes(System.String)" data-throw-if-not-resolved="false"></xref> with the attribute type name.
+</li><li>
+<strong>Library-Controlled:</strong> When the underlying library handles mapping internally
+(e.g., Parquet.NET with no programmatic API). Return PropertyMappingConfiguration.LibraryControlled().
+</li><li>
+<strong>Adapter Pattern:</strong> Bridge between SerializedLabel and native attributes.
+Return <xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.FromAdapter%60%601" data-throw-if-not-resolved="false"></xref>.
+</li></ul>
+<p>
+<strong>Design Intent:</strong> This contract makes property mapping an explicit, discoverable
+capability rather than an implicit behavior, enabling:
+</p>
+<ul><li>Runtime introspection of mapping capabilities</li><li>Better error messages when schemas don't match storage</li><li>Documentation generation for serializer capabilities</li><li>Testing framework validation of mapping correctness</li></ul>
+
+### <a id="Flowthru_Data_Storage_IFormatSerializer_1_SerializeRows_System_IO_Stream_System_Collections_Generic_IAsyncEnumerable__0__"></a> SerializeRows\(Stream, IAsyncEnumerable<TRow\>\)
+
+Serializes a stream of rows into a stream of bytes.
+
+```csharp
+Task SerializeRows(Stream stream, IAsyncEnumerable<TRow> rows)
+```
+
+#### Parameters
+
+`stream` [Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)
+
+The stream to write serialized data to
+
+`rows` [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<TRow\>
+
+The rows to serialize
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
+
+Task that completes when serialization finishes
+
+#### Remarks
+
+<p>
+<strong>Streaming Behavior:</strong>
+</p>
+<p>
+Rows should be written as they are enumerated (lazy evaluation).
+This allows handling large datasets efficiently.
+</p>
+<p>
+<strong>Format-Specific Headers:</strong>
+</p>
+<p>
+Implementations should handle format-specific initialization:
+- CSV: Write header row with column names
+- JSON: Write opening bracket for array
+- Parquet: Write schema metadata
+</p>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Serialization errors should throw exceptions:
+- Type conversion failures
+- I/O errors during stream writing
+- Invalid data values for format constraints
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.IStorageAdapter-1.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.IStorageAdapter-1.md
new file mode 100644
index 00000000..8053b57e
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.IStorageAdapter-1.md
@@ -0,0 +1,265 @@
+# <a id="Flowthru_Data_Storage_IStorageAdapter_1"></a> Interface IStorageAdapter<T\>
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Core.dll  
+
+Interface for high-level storage operations - abstracts Load/Save with any storage implementation.
+
+```csharp
+public interface IStorageAdapter<T>
+```
+
+#### Type Parameters
+
+`T` 
+
+The data type (container with rows)
+
+## Examples
+
+<pre><code class="lang-csharp">// Composed storage adapter
+var storage = new ComposedStorageAdapter&lt;IEnumerable&lt;CompanySchema&gt;, CompanySchema&gt;(
+    medium: new FileStorageMedium("data.csv"),
+    format: new CsvFormatSerializer&lt;CompanySchema&gt;(),
+    container: new EnumerableContainerAdapter&lt;CompanySchema&gt;()
+);
+
+var loadResult = await storage.Load().Run();
+loadResult.Match(
+    Succ: data =&gt; Console.WriteLine($"Loaded {data.Count()} rows"),
+    Fail: err =&gt; Console.WriteLine($"Load failed: {err}")
+);
+
+var saveResult = await storage.Save(companies).Run();</code></pre>
+
+## Remarks
+
+<p>
+<strong>Responsibility:</strong> Provide simple Load/Save API regardless of underlying storage strategy.
+</p>
+<p>
+<strong>Abstraction Layer:</strong>
+</p>
+<p>
+This interface hides the complexity of:
+- Medium selection (file vs memory)
+- Format serialization (CSV vs JSON vs Parquet)
+- Container adaptation (IEnumerable vs IDataView)
+</p>
+<p>
+<strong>Implementation Strategies:</strong>
+</p>
+<ul><li><strong>Composed:</strong> <xref href="Flowthru.Data.Storage.ComposedStorageAdapter%602" data-throw-if-not-resolved="false"></xref> - composition of medium + format + container</li><li><strong>Custom:</strong> User-defined implementations (database, API, etc.)</li></ul>
+<p>
+<strong>Effect Types:</strong>
+</p>
+<p>
+All operations return <xref href="Flowthru.Effects.FlowIO%601" data-throw-if-not-resolved="false"></xref> effects to represent:
+- I/O operations that can fail
+- Async execution
+- Cancellation support
+- Functional composition
+</p>
+<p>
+<strong>Usage in Catalog Entries:</strong>
+</p>
+<p>
+<xref href="Flowthru.Data.IItem%601" data-throw-if-not-resolved="false"></xref> delegates to this interface:
+</p>
+<pre><code class="lang-csharp">public class Item&lt;T&gt; : IItem&lt;T&gt;
+{
+    private readonly IStorageAdapter&lt;T&gt; _storage;
+
+    public FlowIO&lt;T&gt; Load() =&gt; _storage.Load();
+    public FlowIO&lt;FlowUnit&gt; Save(T data) =&gt; _storage.Save(data);
+}</code></pre>
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_IStorageAdapter_1_Traits"></a> Traits
+
+Structural constraints and capabilities of this storage implementation.
+
+```csharp
+StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+#### Remarks
+
+<p>
+Adapter authors must declare what their storage can and cannot do.
+These are intrinsic properties of the storage medium, not runtime state.
+</p>
+<p>
+Pipeline validation uses these traits to fail fast when a pipeline attempts
+invalid operations (e.g., writing to a read-only source).
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_IStorageAdapter_1_Exists"></a> Exists\(\)
+
+Checks if data exists at this storage location.
+
+```csharp
+FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+Effect that produces true if data exists, false otherwise
+
+#### Remarks
+
+<p>
+Delegates to the underlying medium's Exists check.
+Used to determine if a catalog entry is a seed (Layer 0 input).
+</p>
+
+### <a id="Flowthru_Data_Storage_IStorageAdapter_1_InspectDeep"></a> InspectDeep\(\)
+
+Performs deep validation by examining the entire dataset.
+
+```csharp
+FlowIO<ValidationResult> InspectDeep()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that all data is available, accessible, and valid.
+</p>
+<p>
+<strong>Additional Checks Beyond Shallow:</strong>
+</p>
+<ul><li>Validate ALL rows can be deserialized (not just sample)</li><li>Check data quality constraints across entire dataset</li><li>Detect corruption or inconsistencies throughout data</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Read and validate entire file</li><li>Memory adapters: Validate all stored data</li><li>Database adapters: Full table scan with validation</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Potentially expensive - only use when data integrity is critical.
+</p>
+
+### <a id="Flowthru_Data_Storage_IStorageAdapter_1_InspectShallow_System_Int32_"></a> InspectShallow\(int\)
+
+Performs shallow validation by checking data availability and sampling a subset of data.
+
+```csharp
+FlowIO<ValidationResult> InspectShallow(int sampleSize)
+```
+
+#### Parameters
+
+`sampleSize` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of rows/records to sample for validation
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that data is available and accessible.
+</p>
+<p>
+<strong>Typical Checks:</strong>
+</p>
+<ul><li>Data source exists (file, table, etc.)</li><li>Data source is accessible (permissions, connectivity)</li><li>Sample rows can be read and deserialized successfully</li><li>Schema matches expected structure</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Check file exists, read and validate sample rows</li><li>Memory adapters: Check if data has been initialized</li><li>Database adapters: Check table exists, query sample rows</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Should be fast (~10-100ms) - suitable for pre-flight validation.
+</p>
+
+### <a id="Flowthru_Data_Storage_IStorageAdapter_1_Load"></a> Load\(\)
+
+Loads data from storage.
+
+```csharp
+FlowIO<T> Load()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<T\>
+
+Effect that produces data on success
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. medium.ReadStream()           → Stream
+2. format.DeserializeRows()      → IAsyncEnumerable&lt;TRow&gt;
+3. container.FromRows()          → TContainer</code></pre>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Errors from any layer are propagated:
+- Medium errors (file not found, access denied)
+- Format errors (parse failures, schema mismatches)
+- Container errors (memory allocation, type conversion)
+</p>
+
+### <a id="Flowthru_Data_Storage_IStorageAdapter_1_Save__0_"></a> Save\(T\)
+
+Saves data to storage.
+
+```csharp
+FlowIO<FlowUnit> Save(T data)
+```
+
+#### Parameters
+
+`data` T
+
+The data to save
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
+Effect that completes on successful save
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. container.ToRows()            → IAsyncEnumerable&lt;TRow&gt;
+2. format.SerializeRows()        → Stream
+3. medium.WriteStream()          → FlowUnit</code></pre>
+<p>
+<strong>Atomicity:</strong>
+</p>
+<p>
+Implementations should strive for atomic saves to avoid partial writes on failure.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.IStorageMedium.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.IStorageMedium.md
new file mode 100644
index 00000000..ea5724fc
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.IStorageMedium.md
@@ -0,0 +1,158 @@
+# <a id="Flowthru_Data_Storage_IStorageMedium"></a> Interface IStorageMedium
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Core.dll  
+
+Interface for storage medium - handles raw byte stream I/O.
+
+```csharp
+public interface IStorageMedium
+```
+
+## Examples
+
+<pre><code class="lang-csharp">// File storage medium
+var fileMedium = new FileStorageMedium("data/file.csv");
+var readResult = await fileMedium.ReadStream().Run();
+
+// Memory storage medium
+var memoryMedium = new MemoryStorageMedium();
+var writeResult = await memoryMedium.WriteStream(stream).Run();</code></pre>
+
+## Remarks
+
+<p>
+<strong>Responsibility:</strong> Abstract WHERE data is stored (file system, memory, network, database).
+</p>
+<p>
+<strong>Separation of Concerns:</strong>
+</p>
+<p>
+The storage medium layer is isolated from:
+- Format serialization (CSV, JSON, Parquet) - handled by <xref href="Flowthru.Data.Storage.IFormatSerializer%601" data-throw-if-not-resolved="false"></xref>
+- Container representation (IEnumerable, IDataView) - handled by <xref href="Flowthru.Data.Storage.IContainerAdapter%602" data-throw-if-not-resolved="false"></xref>
+</p>
+<p>
+<strong>Design Pattern:</strong>
+</p>
+<p>
+This is the lowest layer in the composition pattern:
+</p>
+<pre><code class="lang-csharp">Medium (bytes) → Format (rows) → Container (in-memory)
+File/Memory    → CSV/JSON      → IEnumerable/IDataView</code></pre>
+<p>
+<strong>Effect Types:</strong>
+</p>
+<p>
+All operations return IO&lt;A&gt; effects to represent:
+- I/O operations that can fail
+- Async execution
+- Cancellation support
+- Functional composition
+</p>
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_IStorageMedium_Traits"></a> Traits
+
+Structural constraints and capabilities of this storage medium.
+
+```csharp
+StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+#### Remarks
+
+Medium traits focus on WHERE data is stored and the access patterns it supports.
+For composed adapters, these traits are merged with format and container traits.
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_IStorageMedium_Exists"></a> Exists\(\)
+
+Checks if data exists at this storage location.
+
+```csharp
+FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+Effect that produces true if data exists, false otherwise
+
+#### Remarks
+
+<p>
+This is used to determine if a catalog entry is a "seed" (Layer 0 input)
+or if it's produced by a node in the pipeline.
+</p>
+
+### <a id="Flowthru_Data_Storage_IStorageMedium_ReadStream"></a> ReadStream\(\)
+
+Reads raw bytes from storage as a stream.
+
+```csharp
+FlowIO<Stream> ReadStream()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)\>
+
+Effect that produces a readable stream on success
+
+#### Remarks
+
+<p>
+The returned stream should be positioned at the beginning and ready to read.
+The caller is responsible for disposing the stream.
+</p>
+<p>
+<strong>Error Conditions:</strong>
+</p>
+<ul><li>Storage location does not exist</li><li>Access denied (permissions)</li><li>Network failure (for remote storage)</li><li>I/O error</li></ul>
+
+### <a id="Flowthru_Data_Storage_IStorageMedium_WriteStream_System_IO_Stream_"></a> WriteStream\(Stream\)
+
+Writes raw bytes to storage from a stream.
+
+```csharp
+FlowIO<FlowUnit> WriteStream(Stream stream)
+```
+
+#### Parameters
+
+`stream` [Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)
+
+Stream containing data to write
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
+Effect that completes on successful write
+
+#### Remarks
+
+<p>
+The stream will be read from its current position to the end.
+The implementation should handle creating parent directories if needed.
+</p>
+<p>
+<strong>Atomicity:</strong>
+</p>
+<p>
+Implementations should strive for atomic writes (write to temp, then rename)
+to avoid partial writes on failure.
+</p>
+<p>
+<strong>Error Conditions:</strong>
+</p>
+<ul><li>Insufficient disk space</li><li>Access denied (permissions)</li><li>Network failure (for remote storage)</li><li>I/O error</li></ul>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Medium.FileStorageMedium.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Medium.FileStorageMedium.md
new file mode 100644
index 00000000..11baf204
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Medium.FileStorageMedium.md
@@ -0,0 +1,207 @@
+# <a id="Flowthru_Data_Storage_Medium_FileStorageMedium"></a> Class FileStorageMedium
+
+Namespace: [Flowthru.Data.Storage.Medium](Flowthru.Data.Storage.Medium.md)  
+Assembly: Flowthru.Core.dll  
+
+Storage medium for file-based I/O operations.
+
+```csharp
+public sealed class FileStorageMedium : IStorageMedium
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FileStorageMedium](Flowthru.Data.Storage.Medium.FileStorageMedium.md)
+
+#### Implements
+
+[IStorageMedium](Flowthru.Data.Storage.IStorageMedium.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Examples
+
+<pre><code class="lang-csharp">var medium = new FileStorageMedium("data/companies.csv");
+
+// Check if file exists
+var exists = await medium.Exists().Run();
+
+// Read from file
+var readResult = await medium.ReadStream().Run();
+readResult.Match(
+    Succ: stream =&gt; { /* process stream */ },
+    Fail: error =&gt; Console.WriteLine($"Read failed: {error}")
+);
+
+// Write to file
+using var writeStream = new MemoryStream(data);
+var writeResult = await medium.WriteStream(writeStream).Run();</code></pre>
+
+## Remarks
+
+<p>
+<strong>Responsibility:</strong> Handle reading and writing raw byte streams to/from files.
+</p>
+<p>
+<strong>Features:</strong>
+</p>
+<ul><li>Automatic directory creation for parent paths</li><li>Atomic writes via temp file + rename</li><li>Support for both absolute and relative paths</li><li>All storage traits use filesystem baseline defaults</li></ul>
+<p>
+<strong>Thread Safety:</strong>
+</p>
+<p>
+This class is thread-safe for reads but writes should be coordinated externally
+if multiple threads write to the same file.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_Medium_FileStorageMedium__ctor_System_String_"></a> FileStorageMedium\(string\)
+
+Creates a new file storage medium.
+
+```csharp
+public FileStorageMedium(string filePath)
+```
+
+#### Parameters
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to the file (absolute or relative)
+
+#### Exceptions
+
+ [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception)
+
+Thrown if filePath is null
+
+ [ArgumentException](https://learn.microsoft.com/dotnet/api/system.argumentexception)
+
+Thrown if filePath is empty or whitespace
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_Medium_FileStorageMedium_FilePath"></a> FilePath
+
+Gets the file path for this storage medium.
+
+```csharp
+public string FilePath { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Data_Storage_Medium_FileStorageMedium_Traits"></a> Traits
+
+Structural constraints and capabilities of this storage medium.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+#### Remarks
+
+Medium traits focus on WHERE data is stored and the access patterns it supports.
+For composed adapters, these traits are merged with format and container traits.
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_Medium_FileStorageMedium_Exists"></a> Exists\(\)
+
+Checks if data exists at this storage location.
+
+```csharp
+public FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+Effect that produces true if data exists, false otherwise
+
+#### Remarks
+
+<p>
+This is used to determine if a catalog entry is a "seed" (Layer 0 input)
+or if it's produced by a node in the pipeline.
+</p>
+
+### <a id="Flowthru_Data_Storage_Medium_FileStorageMedium_ReadStream"></a> ReadStream\(\)
+
+Reads raw bytes from storage as a stream.
+
+```csharp
+public FlowIO<Stream> ReadStream()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)\>
+
+Effect that produces a readable stream on success
+
+#### Remarks
+
+<p>
+The returned stream should be positioned at the beginning and ready to read.
+The caller is responsible for disposing the stream.
+</p>
+<p>
+<strong>Error Conditions:</strong>
+</p>
+<ul><li>Storage location does not exist</li><li>Access denied (permissions)</li><li>Network failure (for remote storage)</li><li>I/O error</li></ul>
+
+### <a id="Flowthru_Data_Storage_Medium_FileStorageMedium_WriteStream_System_IO_Stream_"></a> WriteStream\(Stream\)
+
+Writes raw bytes to storage from a stream.
+
+```csharp
+public FlowIO<FlowUnit> WriteStream(Stream stream)
+```
+
+#### Parameters
+
+`stream` [Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)
+
+Stream containing data to write
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
+Effect that completes on successful write
+
+#### Remarks
+
+<p>
+The stream will be read from its current position to the end.
+The implementation should handle creating parent directories if needed.
+</p>
+<p>
+<strong>Atomicity:</strong>
+</p>
+<p>
+Implementations should strive for atomic writes (write to temp, then rename)
+to avoid partial writes on failure.
+</p>
+<p>
+<strong>Error Conditions:</strong>
+</p>
+<ul><li>Insufficient disk space</li><li>Access denied (permissions)</li><li>Network failure (for remote storage)</li><li>I/O error</li></ul>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Medium.MemoryStorageMedium.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Medium.MemoryStorageMedium.md
new file mode 100644
index 00000000..c4056b05
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Medium.MemoryStorageMedium.md
@@ -0,0 +1,225 @@
+# <a id="Flowthru_Data_Storage_Medium_MemoryStorageMedium"></a> Class MemoryStorageMedium
+
+Namespace: [Flowthru.Data.Storage.Medium](Flowthru.Data.Storage.Medium.md)  
+Assembly: Flowthru.Core.dll  
+
+Storage medium for in-memory byte storage.
+
+```csharp
+public sealed class MemoryStorageMedium : IStorageMedium
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[MemoryStorageMedium](Flowthru.Data.Storage.Medium.MemoryStorageMedium.md)
+
+#### Implements
+
+[IStorageMedium](Flowthru.Data.Storage.IStorageMedium.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Examples
+
+<pre><code class="lang-csharp">var medium = new MemoryStorageMedium();
+
+// Write some data
+using var writeStream = new MemoryStream(Encoding.UTF8.GetBytes("Hello, World!"));
+await medium.WriteStream(writeStream).Run();
+
+// Read it back
+var readResult = await medium.ReadStream().Run();
+readResult.Match(
+    Succ: stream =&gt;
+    {
+        using var reader = new StreamReader(stream);
+        var content = reader.ReadToEnd();
+        Console.WriteLine(content); // "Hello, World!"
+    },
+    Fail: error =&gt; Console.WriteLine($"Read failed: {error}")
+);</code></pre>
+
+## Remarks
+
+<p>
+<strong>Responsibility:</strong> Store data in memory without any file I/O.
+</p>
+<p>
+<strong>Use Cases:</strong>
+</p>
+<ul><li>Testing without file system dependencies</li><li>Transient pipeline intermediates that don't need persistence</li><li>Fast prototyping and experimentation</li><li>In-memory caching of computed results</li></ul>
+<p>
+<strong>Characteristics:</strong>
+</p>
+<ul><li>IsPersistent: false - data lost when process exits</li><li>Very fast - no I/O overhead</li><li>Memory-bound - not suitable for large datasets</li></ul>
+<p>
+<strong>Thread Safety:</strong>
+</p>
+<p>
+This class uses locking to ensure thread-safe access to the internal buffer.
+Multiple threads can safely read/write concurrently.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_Medium_MemoryStorageMedium__ctor"></a> MemoryStorageMedium\(\)
+
+Creates a new memory storage medium with no initial data.
+
+```csharp
+public MemoryStorageMedium()
+```
+
+### <a id="Flowthru_Data_Storage_Medium_MemoryStorageMedium__ctor_System_Byte___"></a> MemoryStorageMedium\(byte\[\]\)
+
+Creates a new memory storage medium with initial data.
+
+```csharp
+public MemoryStorageMedium(byte[] initialData)
+```
+
+#### Parameters
+
+`initialData` [byte](https://learn.microsoft.com/dotnet/api/system.byte)\[\]
+
+Initial byte buffer
+
+#### Exceptions
+
+ [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception)
+
+Thrown if initialData is null
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_Medium_MemoryStorageMedium_BufferSize"></a> BufferSize
+
+Gets the current buffer size in bytes, or null if no data is stored.
+
+```csharp
+public int? BufferSize { get; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)?
+
+### <a id="Flowthru_Data_Storage_Medium_MemoryStorageMedium_Traits"></a> Traits
+
+Structural constraints and capabilities of this storage medium.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+#### Remarks
+
+Medium traits focus on WHERE data is stored and the access patterns it supports.
+For composed adapters, these traits are merged with format and container traits.
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_Medium_MemoryStorageMedium_Clear"></a> Clear\(\)
+
+Clears the internal buffer, freeing memory.
+
+```csharp
+public void Clear()
+```
+
+### <a id="Flowthru_Data_Storage_Medium_MemoryStorageMedium_Exists"></a> Exists\(\)
+
+Checks if data exists at this storage location.
+
+```csharp
+public FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+Effect that produces true if data exists, false otherwise
+
+#### Remarks
+
+<p>
+This is used to determine if a catalog entry is a "seed" (Layer 0 input)
+or if it's produced by a node in the pipeline.
+</p>
+
+### <a id="Flowthru_Data_Storage_Medium_MemoryStorageMedium_ReadStream"></a> ReadStream\(\)
+
+Reads raw bytes from storage as a stream.
+
+```csharp
+public FlowIO<Stream> ReadStream()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)\>
+
+Effect that produces a readable stream on success
+
+#### Remarks
+
+<p>
+The returned stream should be positioned at the beginning and ready to read.
+The caller is responsible for disposing the stream.
+</p>
+<p>
+<strong>Error Conditions:</strong>
+</p>
+<ul><li>Storage location does not exist</li><li>Access denied (permissions)</li><li>Network failure (for remote storage)</li><li>I/O error</li></ul>
+
+### <a id="Flowthru_Data_Storage_Medium_MemoryStorageMedium_WriteStream_System_IO_Stream_"></a> WriteStream\(Stream\)
+
+Writes raw bytes to storage from a stream.
+
+```csharp
+public FlowIO<FlowUnit> WriteStream(Stream stream)
+```
+
+#### Parameters
+
+`stream` [Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)
+
+Stream containing data to write
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
+Effect that completes on successful write
+
+#### Remarks
+
+<p>
+The stream will be read from its current position to the end.
+The implementation should handle creating parent directories if needed.
+</p>
+<p>
+<strong>Atomicity:</strong>
+</p>
+<p>
+Implementations should strive for atomic writes (write to temp, then rename)
+to avoid partial writes on failure.
+</p>
+<p>
+<strong>Error Conditions:</strong>
+</p>
+<ul><li>Insufficient disk space</li><li>Access denied (permissions)</li><li>Network failure (for remote storage)</li><li>I/O error</li></ul>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Medium.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Medium.md
new file mode 100644
index 00000000..720547bb
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Medium.md
@@ -0,0 +1,12 @@
+# <a id="Flowthru_Data_Storage_Medium"></a> Namespace Flowthru.Data.Storage.Medium
+
+### Classes
+
+ [FileStorageMedium](Flowthru.Data.Storage.Medium.FileStorageMedium.md)
+
+Storage medium for file-based I/O operations.
+
+ [MemoryStorageMedium](Flowthru.Data.Storage.Medium.MemoryStorageMedium.md)
+
+Storage medium for in-memory byte storage.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.MemoryStorageAdapter-1.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.MemoryStorageAdapter-1.md
new file mode 100644
index 00000000..507e9600
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.MemoryStorageAdapter-1.md
@@ -0,0 +1,280 @@
+# <a id="Flowthru_Data_Storage_MemoryStorageAdapter_1"></a> Class MemoryStorageAdapter<T\>
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Core.dll  
+
+Direct memory storage adapter that bypasses serialization.
+
+```csharp
+public sealed class MemoryStorageAdapter<T> : IStorageAdapter<T>
+```
+
+#### Type Parameters
+
+`T` 
+
+The data type to store in memory
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[MemoryStorageAdapter<T\>](Flowthru.Data.Storage.MemoryStorageAdapter\-1.md)
+
+#### Implements
+
+[IStorageAdapter<T\>](Flowthru.Data.Storage.IStorageAdapter\-1.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Examples
+
+<pre><code class="lang-csharp">// Singleton usage
+var modelStorage = new MemoryStorageAdapter&lt;LinearRegressionModel&gt;();
+var modelEntry = new Item&lt;LinearRegressionModel&gt;("model", modelStorage);
+
+// Collection usage
+var dataStorage = new MemoryStorageAdapter&lt;IEnumerable&lt;FeatureRow&gt;&gt;();
+var dataEntry = new Item&lt;IEnumerable&lt;FeatureRow&gt;&gt;("features", dataStorage);</code></pre>
+
+## Remarks
+
+<p>
+<strong>Design Rationale:</strong> Memory storage doesn't need byte serialization
+since objects stay in-process. This adapter provides direct Load/Save without
+medium/format/container composition.
+</p>
+<p>
+<strong>Use Cases:</strong>
+</p>
+<ul><li>Intermediate pipeline data that doesn't need persistence</li><li>Test data that doesn't require file I/O</li><li>Temporary results between pipeline stages</li><li>ML models, metrics, charts, or any ephemeral data</li></ul>
+<p>
+<strong>Thread Safety:</strong> Thread-safe for concurrent Load/Save operations
+</p>
+<p>
+<strong>Lifetime:</strong> Data persists only for the lifetime of this instance
+</p>
+<p>
+<strong>Storage Traits:</strong>
+</p>
+<ul><li>IsPersistent: false (data lost when process exits)</li><li>All other traits use filesystem baseline defaults</li></ul>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_MemoryStorageAdapter_1__ctor"></a> MemoryStorageAdapter\(\)
+
+Creates a new in-memory storage adapter.
+
+```csharp
+public MemoryStorageAdapter()
+```
+
+### <a id="Flowthru_Data_Storage_MemoryStorageAdapter_1__ctor__0_"></a> MemoryStorageAdapter\(T\)
+
+Creates a new in-memory storage adapter with initial data.
+
+```csharp
+public MemoryStorageAdapter(T initialData)
+```
+
+#### Parameters
+
+`initialData` T
+
+Initial data to store
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_MemoryStorageAdapter_1_Traits"></a> Traits
+
+Structural constraints and capabilities of this storage implementation.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+#### Remarks
+
+<p>
+Adapter authors must declare what their storage can and cannot do.
+These are intrinsic properties of the storage medium, not runtime state.
+</p>
+<p>
+Pipeline validation uses these traits to fail fast when a pipeline attempts
+invalid operations (e.g., writing to a read-only source).
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_MemoryStorageAdapter_1_Exists"></a> Exists\(\)
+
+Checks if data exists at this storage location.
+
+```csharp
+public FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+Effect that produces true if data exists, false otherwise
+
+#### Remarks
+
+<p>
+Delegates to the underlying medium's Exists check.
+Used to determine if a catalog entry is a seed (Layer 0 input).
+</p>
+
+### <a id="Flowthru_Data_Storage_MemoryStorageAdapter_1_InspectDeep"></a> InspectDeep\(\)
+
+Performs deep validation by examining the entire dataset.
+
+```csharp
+public FlowIO<ValidationResult> InspectDeep()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that all data is available, accessible, and valid.
+</p>
+<p>
+<strong>Additional Checks Beyond Shallow:</strong>
+</p>
+<ul><li>Validate ALL rows can be deserialized (not just sample)</li><li>Check data quality constraints across entire dataset</li><li>Detect corruption or inconsistencies throughout data</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Read and validate entire file</li><li>Memory adapters: Validate all stored data</li><li>Database adapters: Full table scan with validation</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Potentially expensive - only use when data integrity is critical.
+</p>
+
+### <a id="Flowthru_Data_Storage_MemoryStorageAdapter_1_InspectShallow_System_Int32_"></a> InspectShallow\(int\)
+
+Performs shallow validation by checking data availability and sampling a subset of data.
+
+```csharp
+public FlowIO<ValidationResult> InspectShallow(int sampleSize)
+```
+
+#### Parameters
+
+`sampleSize` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of rows/records to sample for validation
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that data is available and accessible.
+</p>
+<p>
+<strong>Typical Checks:</strong>
+</p>
+<ul><li>Data source exists (file, table, etc.)</li><li>Data source is accessible (permissions, connectivity)</li><li>Sample rows can be read and deserialized successfully</li><li>Schema matches expected structure</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Check file exists, read and validate sample rows</li><li>Memory adapters: Check if data has been initialized</li><li>Database adapters: Check table exists, query sample rows</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Should be fast (~10-100ms) - suitable for pre-flight validation.
+</p>
+
+### <a id="Flowthru_Data_Storage_MemoryStorageAdapter_1_Load"></a> Load\(\)
+
+Loads data from storage.
+
+```csharp
+public FlowIO<T> Load()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<T\>
+
+Effect that produces data on success
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. medium.ReadStream()           → Stream
+2. format.DeserializeRows()      → IAsyncEnumerable&lt;TRow&gt;
+3. container.FromRows()          → TContainer</code></pre>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Errors from any layer are propagated:
+- Medium errors (file not found, access denied)
+- Format errors (parse failures, schema mismatches)
+- Container errors (memory allocation, type conversion)
+</p>
+
+### <a id="Flowthru_Data_Storage_MemoryStorageAdapter_1_Save__0_"></a> Save\(T\)
+
+Saves data to storage.
+
+```csharp
+public FlowIO<FlowUnit> Save(T data)
+```
+
+#### Parameters
+
+`data` T
+
+The data to save
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
+Effect that completes on successful save
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. container.ToRows()            → IAsyncEnumerable&lt;TRow&gt;
+2. format.SerializeRows()        → Stream
+3. medium.WriteStream()          → FlowUnit</code></pre>
+<p>
+<strong>Atomicity:</strong>
+</p>
+<p>
+Implementations should strive for atomic saves to avoid partial writes on failure.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.NullStorageAdapter-1.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.NullStorageAdapter-1.md
new file mode 100644
index 00000000..e1277d87
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.NullStorageAdapter-1.md
@@ -0,0 +1,235 @@
+# <a id="Flowthru_Data_Storage_NullStorageAdapter_1"></a> Class NullStorageAdapter<T\>
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Core.dll  
+
+Null storage adapter for side-effect-only nodes that produce no meaningful data.
+
+```csharp
+public sealed class NullStorageAdapter<T> : IStorageAdapter<T>
+```
+
+#### Type Parameters
+
+`T` 
+
+The data type (typically NoData)
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[NullStorageAdapter<T\>](Flowthru.Data.Storage.NullStorageAdapter\-1.md)
+
+#### Implements
+
+[IStorageAdapter<T\>](Flowthru.Data.Storage.IStorageAdapter\-1.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Use Case:</strong> Nodes that perform side effects (logging, visualization, alerts)
+but don't produce data that downstream nodes need.
+</p>
+<p>
+<strong>Storage Traits:</strong>
+</p>
+<ul><li>CanWrite: false (Save is a no-op)</li><li>CanRead: false (Load throws NotSupportedException)</li></ul>
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_NullStorageAdapter_1_Traits"></a> Traits
+
+Structural constraints and capabilities of this storage implementation.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+#### Remarks
+
+<p>
+Adapter authors must declare what their storage can and cannot do.
+These are intrinsic properties of the storage medium, not runtime state.
+</p>
+<p>
+Pipeline validation uses these traits to fail fast when a pipeline attempts
+invalid operations (e.g., writing to a read-only source).
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_NullStorageAdapter_1_Exists"></a> Exists\(\)
+
+Checks if data exists at this storage location.
+
+```csharp
+public FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+Effect that produces true if data exists, false otherwise
+
+#### Remarks
+
+<p>
+Delegates to the underlying medium's Exists check.
+Used to determine if a catalog entry is a seed (Layer 0 input).
+</p>
+
+### <a id="Flowthru_Data_Storage_NullStorageAdapter_1_InspectDeep"></a> InspectDeep\(\)
+
+Performs deep validation by examining the entire dataset.
+
+```csharp
+public FlowIO<ValidationResult> InspectDeep()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that all data is available, accessible, and valid.
+</p>
+<p>
+<strong>Additional Checks Beyond Shallow:</strong>
+</p>
+<ul><li>Validate ALL rows can be deserialized (not just sample)</li><li>Check data quality constraints across entire dataset</li><li>Detect corruption or inconsistencies throughout data</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Read and validate entire file</li><li>Memory adapters: Validate all stored data</li><li>Database adapters: Full table scan with validation</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Potentially expensive - only use when data integrity is critical.
+</p>
+
+### <a id="Flowthru_Data_Storage_NullStorageAdapter_1_InspectShallow_System_Int32_"></a> InspectShallow\(int\)
+
+Performs shallow validation by checking data availability and sampling a subset of data.
+
+```csharp
+public FlowIO<ValidationResult> InspectShallow(int sampleSize)
+```
+
+#### Parameters
+
+`sampleSize` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of rows/records to sample for validation
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that data is available and accessible.
+</p>
+<p>
+<strong>Typical Checks:</strong>
+</p>
+<ul><li>Data source exists (file, table, etc.)</li><li>Data source is accessible (permissions, connectivity)</li><li>Sample rows can be read and deserialized successfully</li><li>Schema matches expected structure</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Check file exists, read and validate sample rows</li><li>Memory adapters: Check if data has been initialized</li><li>Database adapters: Check table exists, query sample rows</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Should be fast (~10-100ms) - suitable for pre-flight validation.
+</p>
+
+### <a id="Flowthru_Data_Storage_NullStorageAdapter_1_Load"></a> Load\(\)
+
+Loads data from storage.
+
+```csharp
+public FlowIO<T> Load()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<T\>
+
+Effect that produces data on success
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. medium.ReadStream()           → Stream
+2. format.DeserializeRows()      → IAsyncEnumerable&lt;TRow&gt;
+3. container.FromRows()          → TContainer</code></pre>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Errors from any layer are propagated:
+- Medium errors (file not found, access denied)
+- Format errors (parse failures, schema mismatches)
+- Container errors (memory allocation, type conversion)
+</p>
+
+### <a id="Flowthru_Data_Storage_NullStorageAdapter_1_Save__0_"></a> Save\(T\)
+
+Saves data to storage.
+
+```csharp
+public FlowIO<FlowUnit> Save(T data)
+```
+
+#### Parameters
+
+`data` T
+
+The data to save
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
+Effect that completes on successful save
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. container.ToRows()            → IAsyncEnumerable&lt;TRow&gt;
+2. format.SerializeRows()        → Stream
+3. medium.WriteStream()          → FlowUnit</code></pre>
+<p>
+<strong>Atomicity:</strong>
+</p>
+<p>
+Implementations should strive for atomic saves to avoid partial writes on failure.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.PropertyMappingConfiguration.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.PropertyMappingConfiguration.md
new file mode 100644
index 00000000..b2159c5c
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.PropertyMappingConfiguration.md
@@ -0,0 +1,181 @@
+# <a id="Flowthru_Data_Storage_PropertyMappingConfiguration"></a> Class PropertyMappingConfiguration
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Core.dll  
+
+Describes how a format serializer handles property-to-field name mapping.
+
+```csharp
+public sealed class PropertyMappingConfiguration
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PropertyMappingConfiguration](Flowthru.Data.Storage.PropertyMappingConfiguration.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Purpose:</strong> Makes property mapping strategy explicit and discoverable for each serializer.
+</p>
+<p>
+<strong>Strategy Types:</strong>
+</p>
+<ul><li>SerializedLabel - Respects [SerializedLabel] attributes</li><li>NativeAttributes - Uses format-specific attributes (e.g., [LoadColumn])</li><li><xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.LibraryControlled(System.String)" data-throw-if-not-resolved="false"></xref> - Underlying library controls mapping</li><li>Adapter - Bridges SerializedLabel with native attributes</li></ul>
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_PropertyMappingConfiguration_Description"></a> Description
+
+Optional description of the mapping behavior.
+
+```csharp
+public string? Description { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Data_Storage_PropertyMappingConfiguration_MetadataType"></a> MetadataType
+
+For NativeAttributes strategy: the name of the attribute type(s) used.
+For Adapter strategy: the adapter type.
+
+```csharp
+public Type? MetadataType { get; }
+```
+
+#### Property Value
+
+ [Type](https://learn.microsoft.com/dotnet/api/system.type)?
+
+### <a id="Flowthru_Data_Storage_PropertyMappingConfiguration_Strategy"></a> Strategy
+
+The strategy used for property mapping.
+
+```csharp
+public PropertyMappingStrategy Strategy { get; }
+```
+
+#### Property Value
+
+ [PropertyMappingStrategy](Flowthru.Data.Storage.PropertyMappingStrategy.md)
+
+### <a id="Flowthru_Data_Storage_PropertyMappingConfiguration_SupportsSerializedLabel"></a> SupportsSerializedLabel
+
+Checks if the serializer supports SerializedLabel attributes (directly or via adapter).
+
+```csharp
+public bool SupportsSerializedLabel { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_PropertyMappingConfiguration_FromAdapter__1"></a> FromAdapter<TAdapter\>\(\)
+
+Serializer uses an adapter to bridge SerializedLabel with native attributes.
+
+```csharp
+public static PropertyMappingConfiguration FromAdapter<TAdapter>()
+```
+
+#### Returns
+
+ [PropertyMappingConfiguration](Flowthru.Data.Storage.PropertyMappingConfiguration.md)
+
+Configuration for adapter-based mapping
+
+#### Type Parameters
+
+`TAdapter` 
+
+The adapter type that performs the bridging
+
+### <a id="Flowthru_Data_Storage_PropertyMappingConfiguration_FromNativeAttributes_System_String_"></a> FromNativeAttributes\(string\)
+
+Serializer uses format-specific attributes (e.g., ML.NET's [LoadColumn], [ColumnName]).
+
+```csharp
+public static PropertyMappingConfiguration FromNativeAttributes(string attributeDescription)
+```
+
+#### Parameters
+
+`attributeDescription` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Description of native attributes used
+
+#### Returns
+
+ [PropertyMappingConfiguration](Flowthru.Data.Storage.PropertyMappingConfiguration.md)
+
+Configuration for native attribute mapping
+
+### <a id="Flowthru_Data_Storage_PropertyMappingConfiguration_FromSerializedLabel__1"></a> FromSerializedLabel<TRow\>\(\)
+
+Serializer uses SerializedLabel attributes via PropertyMappingHelper.
+
+```csharp
+public static PropertyMappingConfiguration FromSerializedLabel<TRow>()
+```
+
+#### Returns
+
+ [PropertyMappingConfiguration](Flowthru.Data.Storage.PropertyMappingConfiguration.md)
+
+Configuration for SerializedLabel-based mapping
+
+#### Type Parameters
+
+`TRow` 
+
+The schema type
+
+### <a id="Flowthru_Data_Storage_PropertyMappingConfiguration_LibraryControlled_System_String_"></a> LibraryControlled\(string?\)
+
+Underlying library controls mapping with no programmatic API.
+Property names must match storage field names exactly.
+
+```csharp
+public static PropertyMappingConfiguration LibraryControlled(string? limitation = null)
+```
+
+#### Parameters
+
+`limitation` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+Optional description of the limitation
+
+#### Returns
+
+ [PropertyMappingConfiguration](Flowthru.Data.Storage.PropertyMappingConfiguration.md)
+
+Configuration for library-controlled mapping
+
+### <a id="Flowthru_Data_Storage_PropertyMappingConfiguration_ToString"></a> ToString\(\)
+
+Gets a human-readable description of the mapping strategy.
+
+```csharp
+public override string ToString()
+```
+
+#### Returns
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.PropertyMappingStrategy.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.PropertyMappingStrategy.md
new file mode 100644
index 00000000..b2f04f0f
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.PropertyMappingStrategy.md
@@ -0,0 +1,37 @@
+# <a id="Flowthru_Data_Storage_PropertyMappingStrategy"></a> Enum PropertyMappingStrategy
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Core.dll  
+
+Property mapping strategy used by a format serializer.
+
+```csharp
+public enum PropertyMappingStrategy
+```
+
+## Fields
+
+`Adapter = 3` 
+
+Serializer uses an adapter to translate SerializedLabel to native attributes.
+
+
+
+`LibraryControlled = 2` 
+
+Underlying library controls mapping with no programmatic access.
+
+
+
+`NativeAttributes = 1` 
+
+Serializer uses format-specific attributes (e.g., ML.NET [LoadColumn], CsvHelper [Name]).
+
+
+
+`SerializedLabel = 0` 
+
+Serializer respects [SerializedLabel] attributes using PropertyMappingHelper.
+
+
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.SchemaActivator.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.SchemaActivator.md
new file mode 100644
index 00000000..b62c4266
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.SchemaActivator.md
@@ -0,0 +1,114 @@
+# <a id="Flowthru_Data_Storage_SchemaActivator"></a> Class SchemaActivator
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Core.dll  
+
+Factory for creating schema instances, supporting both traditional parameterless constructors
+and modern C# features like required members and positional records.
+
+```csharp
+public static class SchemaActivator
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[SchemaActivator](Flowthru.Data.Storage.SchemaActivator.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Examples
+
+<pre><code class="lang-csharp">// Traditional schema - uses fast path
+public record OldSchema(int Id, string Name) : IFlatSchema;
+var old = SchemaActivator.CreateInstance&lt;OldSchema&gt;();
+
+// Modern schema with required members - uses slow path
+public record NewSchema : IFlatSchema
+{
+  public required Guid Id { get; init; }
+  public required string Name { get; init; }
+}
+var modern = SchemaActivator.CreateInstance&lt;NewSchema&gt;();</code></pre>
+
+## Remarks
+
+<p>
+<strong>Design Philosophy:</strong>
+</p>
+<p>
+With Flowthru's strong node contracts, schemas with required members are guaranteed to contain
+valid data because:
+</p>
+<ul><li><strong>Layer 0 (Seeds):</strong> Validation phase checks required fields exist before execution</li><li><strong>Layers 1+ (Node outputs):</strong> C# compiler enforces required members when nodes construct output</li></ul>
+<p>
+This activator's role is to enable deserialization by creating instances that will be populated
+via property reflection. No validation is performed here - that happens at the pipeline boundaries.
+</p>
+<p>
+<strong>Instantiation Strategy:</strong>
+</p>
+<ul><li><strong>Fast Path:</strong> Parameterless constructor (uses compiled expression tree)</li><li><strong>Slow Path:</strong> No parameterless constructor (uses FormatterServices.GetUninitializedObject)</li></ul>
+<p>
+<strong>Performance:</strong>
+</p>
+<p>
+The fast path (parameterless constructor) is ~10x faster than Activator.CreateInstance.
+The slow path (uninitialized object) is ~2x slower than Activator.CreateInstance but enables
+required members and positional records.
+</p>
+<p>
+Both paths cache metadata to minimize reflection overhead on subsequent calls.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_SchemaActivator_CreateInstance__1"></a> CreateInstance<T\>\(\)
+
+Creates an instance of the specified type, automatically selecting the optimal
+instantiation strategy.
+
+```csharp
+public static T CreateInstance<T>() where T : notnull
+```
+
+#### Returns
+
+ T
+
+A new instance of type T with uninitialized properties
+
+#### Type Parameters
+
+`T` 
+
+The type to instantiate
+
+#### Remarks
+
+<p>
+The returned instance will have:
+- Reference type properties: null
+- Value type properties: default values (0, false, etc.)
+- Required members: uninitialized (will be set via reflection after this call)
+</p>
+<p>
+This is safe because:
+- Layer 0: Validation ensures required fields exist in data
+- Layers 1+: Data came from valid node output
+</p>
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if the type cannot be instantiated (e.g., abstract class, interface)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.SingletonJsonStorageAdapter-1.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.SingletonJsonStorageAdapter-1.md
new file mode 100644
index 00000000..824cf1fe
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.SingletonJsonStorageAdapter-1.md
@@ -0,0 +1,313 @@
+# <a id="Flowthru_Data_Storage_SingletonJsonStorageAdapter_1"></a> Class SingletonJsonStorageAdapter<T\>
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Core.dll  
+
+Direct JSON file storage for singleton objects (not collections).
+
+```csharp
+public sealed class SingletonJsonStorageAdapter<T> : IStorageAdapter<T> where T : IStructuredSerializable
+```
+
+#### Type Parameters
+
+`T` 
+
+The object type to serialize
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[SingletonJsonStorageAdapter<T\>](Flowthru.Data.Storage.SingletonJsonStorageAdapter\-1.md)
+
+#### Implements
+
+[IStorageAdapter<T\>](Flowthru.Data.Storage.IStorageAdapter\-1.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Examples
+
+<pre><code class="lang-csharp">var storage = new SingletonJsonStorageAdapter&lt;LinearRegressionModel&gt;("model.json");
+var entry = new Item&lt;LinearRegressionModel&gt;("model", storage);
+
+// Save
+await entry.Save(model).RunAsync();
+
+// Load
+var loadedModel = await entry.Load().RunAsync();</code></pre>
+
+## Remarks
+
+<p>
+<strong>Design Rationale:</strong> Singleton objects don't need the full
+medium/format/container composition since they don't stream rows. This adapter
+provides direct JSON serialization for single objects.
+</p>
+<p>
+<strong>Use Cases:</strong>
+</p>
+<ul><li>ML models (LinearRegressionModel)</li><li>Metrics objects (ModelMetrics, CrossValidationResults)</li><li>Configuration files</li><li>Any single object (not a collection)</li></ul>
+<p>
+<strong>Serialization Format:</strong> JSON object (not wrapped in array)
+</p>
+<p>
+<strong>Storage Traits:</strong> All traits use filesystem baseline defaults
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_SingletonJsonStorageAdapter_1__ctor_System_String_"></a> SingletonJsonStorageAdapter\(string\)
+
+Creates a new singleton JSON storage adapter with default options.
+Uses JsonFormatSerializer's default options to ensure consistent behavior,
+including SerializedLabel attribute support.
+
+```csharp
+public SingletonJsonStorageAdapter(string filePath)
+```
+
+#### Parameters
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to JSON file
+
+### <a id="Flowthru_Data_Storage_SingletonJsonStorageAdapter_1__ctor_System_String_System_Text_Json_JsonSerializerOptions_"></a> SingletonJsonStorageAdapter\(string, JsonSerializerOptions\)
+
+Creates a new singleton JSON storage adapter with custom options.
+
+```csharp
+public SingletonJsonStorageAdapter(string filePath, JsonSerializerOptions options)
+```
+
+#### Parameters
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to JSON file
+
+`options` [JsonSerializerOptions](https://learn.microsoft.com/dotnet/api/system.text.json.jsonserializeroptions)
+
+JSON serialization options
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_SingletonJsonStorageAdapter_1_FilePath"></a> FilePath
+
+Gets the file path used by this adapter.
+
+```csharp
+public string FilePath { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Data_Storage_SingletonJsonStorageAdapter_1_Options"></a> Options
+
+Gets the JSON serialization options.
+
+```csharp
+public JsonSerializerOptions Options { get; }
+```
+
+#### Property Value
+
+ [JsonSerializerOptions](https://learn.microsoft.com/dotnet/api/system.text.json.jsonserializeroptions)
+
+### <a id="Flowthru_Data_Storage_SingletonJsonStorageAdapter_1_Traits"></a> Traits
+
+Structural constraints and capabilities of this storage implementation.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+#### Remarks
+
+<p>
+Adapter authors must declare what their storage can and cannot do.
+These are intrinsic properties of the storage medium, not runtime state.
+</p>
+<p>
+Pipeline validation uses these traits to fail fast when a pipeline attempts
+invalid operations (e.g., writing to a read-only source).
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_SingletonJsonStorageAdapter_1_Exists"></a> Exists\(\)
+
+Checks if data exists at this storage location.
+
+```csharp
+public FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+Effect that produces true if data exists, false otherwise
+
+#### Remarks
+
+<p>
+Delegates to the underlying medium's Exists check.
+Used to determine if a catalog entry is a seed (Layer 0 input).
+</p>
+
+### <a id="Flowthru_Data_Storage_SingletonJsonStorageAdapter_1_InspectDeep"></a> InspectDeep\(\)
+
+Performs deep validation by examining the entire dataset.
+
+```csharp
+public FlowIO<ValidationResult> InspectDeep()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that all data is available, accessible, and valid.
+</p>
+<p>
+<strong>Additional Checks Beyond Shallow:</strong>
+</p>
+<ul><li>Validate ALL rows can be deserialized (not just sample)</li><li>Check data quality constraints across entire dataset</li><li>Detect corruption or inconsistencies throughout data</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Read and validate entire file</li><li>Memory adapters: Validate all stored data</li><li>Database adapters: Full table scan with validation</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Potentially expensive - only use when data integrity is critical.
+</p>
+
+### <a id="Flowthru_Data_Storage_SingletonJsonStorageAdapter_1_InspectShallow_System_Int32_"></a> InspectShallow\(int\)
+
+Performs shallow validation by checking data availability and sampling a subset of data.
+
+```csharp
+public FlowIO<ValidationResult> InspectShallow(int sampleSize)
+```
+
+#### Parameters
+
+`sampleSize` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of rows/records to sample for validation
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that data is available and accessible.
+</p>
+<p>
+<strong>Typical Checks:</strong>
+</p>
+<ul><li>Data source exists (file, table, etc.)</li><li>Data source is accessible (permissions, connectivity)</li><li>Sample rows can be read and deserialized successfully</li><li>Schema matches expected structure</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Check file exists, read and validate sample rows</li><li>Memory adapters: Check if data has been initialized</li><li>Database adapters: Check table exists, query sample rows</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Should be fast (~10-100ms) - suitable for pre-flight validation.
+</p>
+
+### <a id="Flowthru_Data_Storage_SingletonJsonStorageAdapter_1_Load"></a> Load\(\)
+
+Loads data from storage.
+
+```csharp
+public FlowIO<T> Load()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<T\>
+
+Effect that produces data on success
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. medium.ReadStream()           → Stream
+2. format.DeserializeRows()      → IAsyncEnumerable&lt;TRow&gt;
+3. container.FromRows()          → TContainer</code></pre>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Errors from any layer are propagated:
+- Medium errors (file not found, access denied)
+- Format errors (parse failures, schema mismatches)
+- Container errors (memory allocation, type conversion)
+</p>
+
+### <a id="Flowthru_Data_Storage_SingletonJsonStorageAdapter_1_Save__0_"></a> Save\(T\)
+
+Saves data to storage.
+
+```csharp
+public FlowIO<FlowUnit> Save(T data)
+```
+
+#### Parameters
+
+`data` T
+
+The data to save
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
+Effect that completes on successful save
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. container.ToRows()            → IAsyncEnumerable&lt;TRow&gt;
+2. format.SerializeRows()        → Stream
+3. medium.WriteStream()          → FlowUnit</code></pre>
+<p>
+<strong>Atomicity:</strong>
+</p>
+<p>
+Implementations should strive for atomic saves to avoid partial writes on failure.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Strategies.DatabaseStorageEntryFactory.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Strategies.DatabaseStorageEntryFactory.md
new file mode 100644
index 00000000..e77ad455
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Strategies.DatabaseStorageEntryFactory.md
@@ -0,0 +1,190 @@
+# <a id="Flowthru_Data_Storage_Strategies_DatabaseStorageEntryFactory"></a> Class DatabaseStorageEntryFactory
+
+Namespace: [Flowthru.Data.Storage.Strategies](Flowthru.Data.Storage.Strategies.md)  
+Assembly: Flowthru.Core.dll  
+
+Database-backed storage strategy for production environments.
+
+```csharp
+public sealed class DatabaseStorageEntryFactory : IStorageEntryFactory
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[DatabaseStorageEntryFactory](Flowthru.Data.Storage.Strategies.DatabaseStorageEntryFactory.md)
+
+#### Implements
+
+[IStorageEntryFactory](Flowthru.Data.Storage.Strategies.IStorageEntryFactory.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>⚠️ STUB IMPLEMENTATION - Phase 2</strong>
+</p>
+<p>
+This is a placeholder for future database support. Currently throws
+NotImplementedException for all operations.
+</p>
+<p>
+<strong>Planned Features:</strong>
+</p>
+<ul><li>SQL Server, PostgreSQL, SQLite support</li><li>Connection pooling and retry logic</li><li>Schema migration support</li><li>Transaction coordination with pipelines</li></ul>
+<p>
+<strong>Proposed Usage:</strong>
+</p>
+<pre><code class="lang-csharp">services.AddFlowthru(flowthru =&gt;
+{
+    flowthru.RegisterCatalog&lt;MyCatalog&gt;();
+
+    if (env.IsProduction())
+    {
+        flowthru.UseStorageStrategy&lt;DatabaseStorageEntryFactory&gt;();
+    }
+});</code></pre>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_Strategies_DatabaseStorageEntryFactory__ctor_Microsoft_Extensions_Configuration_IConfiguration_"></a> DatabaseStorageEntryFactory\(IConfiguration\)
+
+Initializes a new database storage factory.
+
+```csharp
+public DatabaseStorageEntryFactory(IConfiguration configuration)
+```
+
+#### Parameters
+
+`configuration` [IConfiguration](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.iconfiguration)
+
+Configuration containing connection string
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if database connection string is not configured
+
+### <a id="Flowthru_Data_Storage_Strategies_DatabaseStorageEntryFactory__ctor_System_String_System_String_"></a> DatabaseStorageEntryFactory\(string, string\)
+
+Initializes a new database storage factory with explicit settings.
+
+```csharp
+public DatabaseStorageEntryFactory(string connectionString, string schema = "dbo")
+```
+
+#### Parameters
+
+`connectionString` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Database connection string
+
+`schema` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Default schema for tables
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_Strategies_DatabaseStorageEntryFactory_CreateEnumerable__1_System_String_Flowthru_Data_Storage_Strategies_StorageOptions_"></a> CreateEnumerable<T\>\(string, StorageOptions?\)
+
+Creates a catalog entry for an enumerable dataset.
+
+```csharp
+public IItem<IEnumerable<T>> CreateEnumerable<T>(string label, StorageOptions? options = null) where T : notnull, IFlatSchema, ITextSerializable
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Catalog label for the entry
+
+`options` [StorageOptions](Flowthru.Data.Storage.Strategies.StorageOptions.md)?
+
+Optional storage options
+
+#### Returns
+
+ [IItem](Flowthru.Data.IItem\-1.md)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>\>
+
+Configured catalog entry
+
+#### Type Parameters
+
+`T` 
+
+Schema type (must implement IFlatSchema and ITextSerializable)
+
+#### Remarks
+
+<p>
+Type constraints ensure compatibility with CSV and Parquet serialization.
+Memory storage also works since it has no serialization requirements.
+</p>
+<p>
+If options.Path is null, the label is used to derive a default path
+(e.g., "Companies" → "Companies.csv" or "dbo.Companies").
+</p>
+
+#### Exceptions
+
+ [NotImplementedException](https://learn.microsoft.com/dotnet/api/system.notimplementedexception)
+
+Phase 2 stub - database support not yet implemented
+
+### <a id="Flowthru_Data_Storage_Strategies_DatabaseStorageEntryFactory_CreateSingle__1_System_String_Flowthru_Data_Storage_Strategies_StorageOptions_"></a> CreateSingle<T\>\(string, StorageOptions?\)
+
+Creates a catalog entry for a singleton object.
+
+```csharp
+public IItem<T> CreateSingle<T>(string label, StorageOptions? options = null) where T : IStructuredSerializable
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Catalog label for the entry
+
+`options` [StorageOptions](Flowthru.Data.Storage.Strategies.StorageOptions.md)?
+
+Optional storage options
+
+#### Returns
+
+ [IItem](Flowthru.Data.IItem\-1.md)<T\>
+
+Configured catalog entry
+
+#### Type Parameters
+
+`T` 
+
+Object type (must implement IStructuredSerializable)
+
+#### Remarks
+
+<p>
+Type constraint ensures compatibility with JSON serialization.
+Memory storage also works since it has no serialization requirements.
+</p>
+<p>
+Typically uses structured formats (JSON, MessagePack) for singletons.
+</p>
+
+#### Exceptions
+
+ [NotImplementedException](https://learn.microsoft.com/dotnet/api/system.notimplementedexception)
+
+Phase 2 stub - database support not yet implemented
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Strategies.IStorageEntryFactory.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Strategies.IStorageEntryFactory.md
new file mode 100644
index 00000000..e0fdb794
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Strategies.IStorageEntryFactory.md
@@ -0,0 +1,118 @@
+# <a id="Flowthru_Data_Storage_Strategies_IStorageEntryFactory"></a> Interface IStorageEntryFactory
+
+Namespace: [Flowthru.Data.Storage.Strategies](Flowthru.Data.Storage.Strategies.md)  
+Assembly: Flowthru.Core.dll  
+
+Factory for creating catalog entries with environment-specific storage.
+
+```csharp
+public interface IStorageEntryFactory
+```
+
+## Remarks
+
+<p>
+The strategy pattern enables the same catalog to use different storage
+backends based on the environment:
+</p>
+<ul><li><strong>Development:</strong> CSV files for easy inspection and version control</li><li><strong>Production:</strong> Database tables for scalability and transactions</li><li><strong>Testing:</strong> In-memory storage for fast, isolated tests</li></ul>
+<p>
+<strong>Usage Pattern:</strong>
+</p>
+<pre><code class="lang-csharp">public class MyCatalog : DataCatalogBase
+{
+    private readonly IStorageEntryFactory _storage;
+
+    public MyCatalog(IStorageEntryFactory storage)
+    {
+        _storage = storage;
+        InitializeCatalogProperties();
+    }
+
+    public IItem&lt;IEnumerable&lt;Company&gt;&gt; Companies =&gt;
+        GetOrCreateEntry(() =&gt; _storage.CreateEnumerable&lt;Company&gt;("Companies"));
+}</code></pre>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_Strategies_IStorageEntryFactory_CreateEnumerable__1_System_String_Flowthru_Data_Storage_Strategies_StorageOptions_"></a> CreateEnumerable<T\>\(string, StorageOptions?\)
+
+Creates a catalog entry for an enumerable dataset.
+
+```csharp
+IItem<IEnumerable<T>> CreateEnumerable<T>(string label, StorageOptions? options = null) where T : notnull, IFlatSchema, ITextSerializable
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Catalog label for the entry
+
+`options` [StorageOptions](Flowthru.Data.Storage.Strategies.StorageOptions.md)?
+
+Optional storage options
+
+#### Returns
+
+ [IItem](Flowthru.Data.IItem\-1.md)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>\>
+
+Configured catalog entry
+
+#### Type Parameters
+
+`T` 
+
+Schema type (must implement IFlatSchema and ITextSerializable)
+
+#### Remarks
+
+<p>
+Type constraints ensure compatibility with CSV and Parquet serialization.
+Memory storage also works since it has no serialization requirements.
+</p>
+<p>
+If options.Path is null, the label is used to derive a default path
+(e.g., "Companies" → "Companies.csv" or "dbo.Companies").
+</p>
+
+### <a id="Flowthru_Data_Storage_Strategies_IStorageEntryFactory_CreateSingle__1_System_String_Flowthru_Data_Storage_Strategies_StorageOptions_"></a> CreateSingle<T\>\(string, StorageOptions?\)
+
+Creates a catalog entry for a singleton object.
+
+```csharp
+IItem<T> CreateSingle<T>(string label, StorageOptions? options = null) where T : IStructuredSerializable
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Catalog label for the entry
+
+`options` [StorageOptions](Flowthru.Data.Storage.Strategies.StorageOptions.md)?
+
+Optional storage options
+
+#### Returns
+
+ [IItem](Flowthru.Data.IItem\-1.md)<T\>
+
+Configured catalog entry
+
+#### Type Parameters
+
+`T` 
+
+Object type (must implement IStructuredSerializable)
+
+#### Remarks
+
+<p>
+Type constraint ensures compatibility with JSON serialization.
+Memory storage also works since it has no serialization requirements.
+</p>
+<p>
+Typically uses structured formats (JSON, MessagePack) for singletons.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Strategies.MemoryStorageEntryFactory.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Strategies.MemoryStorageEntryFactory.md
new file mode 100644
index 00000000..4c209690
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Strategies.MemoryStorageEntryFactory.md
@@ -0,0 +1,132 @@
+# <a id="Flowthru_Data_Storage_Strategies_MemoryStorageEntryFactory"></a> Class MemoryStorageEntryFactory
+
+Namespace: [Flowthru.Data.Storage.Strategies](Flowthru.Data.Storage.Strategies.md)  
+Assembly: Flowthru.Core.dll  
+
+In-memory storage strategy for unit tests.
+
+```csharp
+public sealed class MemoryStorageEntryFactory : IStorageEntryFactory
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[MemoryStorageEntryFactory](Flowthru.Data.Storage.Strategies.MemoryStorageEntryFactory.md)
+
+#### Implements
+
+[IStorageEntryFactory](Flowthru.Data.Storage.Strategies.IStorageEntryFactory.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+Stores all data in memory for:
+</p>
+<ul><li>Fast test execution (no I/O)</li><li>Test isolation (no shared state between tests)</li><li>Simple setup (no files or databases)</li></ul>
+<p>
+<strong>Usage in Tests:</strong>
+</p>
+<pre><code class="lang-csharp">[Test]
+public async Task MyTest()
+{
+    var storage = new MemoryStorageEntryFactory();
+    var catalog = new MyCatalog(storage);
+
+    // All data stays in memory - no files created
+    await catalog.Companies.Save(companies).Run();
+    var result = await catalog.Companies.Load().Run();
+}</code></pre>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_Strategies_MemoryStorageEntryFactory_CreateEnumerable__1_System_String_Flowthru_Data_Storage_Strategies_StorageOptions_"></a> CreateEnumerable<T\>\(string, StorageOptions?\)
+
+Creates a catalog entry for an enumerable dataset.
+
+```csharp
+public IItem<IEnumerable<T>> CreateEnumerable<T>(string label, StorageOptions? options = null) where T : notnull, IFlatSchema, ITextSerializable
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Catalog label for the entry
+
+`options` [StorageOptions](Flowthru.Data.Storage.Strategies.StorageOptions.md)?
+
+Optional storage options
+
+#### Returns
+
+ [IItem](Flowthru.Data.IItem\-1.md)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>\>
+
+Configured catalog entry
+
+#### Type Parameters
+
+`T` 
+
+Schema type (must implement IFlatSchema and ITextSerializable)
+
+#### Remarks
+
+<p>
+Type constraints ensure compatibility with CSV and Parquet serialization.
+Memory storage also works since it has no serialization requirements.
+</p>
+<p>
+If options.Path is null, the label is used to derive a default path
+(e.g., "Companies" → "Companies.csv" or "dbo.Companies").
+</p>
+
+### <a id="Flowthru_Data_Storage_Strategies_MemoryStorageEntryFactory_CreateSingle__1_System_String_Flowthru_Data_Storage_Strategies_StorageOptions_"></a> CreateSingle<T\>\(string, StorageOptions?\)
+
+Creates a catalog entry for a singleton object.
+
+```csharp
+public IItem<T> CreateSingle<T>(string label, StorageOptions? options = null) where T : IStructuredSerializable
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Catalog label for the entry
+
+`options` [StorageOptions](Flowthru.Data.Storage.Strategies.StorageOptions.md)?
+
+Optional storage options
+
+#### Returns
+
+ [IItem](Flowthru.Data.IItem\-1.md)<T\>
+
+Configured catalog entry
+
+#### Type Parameters
+
+`T` 
+
+Object type (must implement IStructuredSerializable)
+
+#### Remarks
+
+<p>
+Type constraint ensures compatibility with JSON serialization.
+Memory storage also works since it has no serialization requirements.
+</p>
+<p>
+Typically uses structured formats (JSON, MessagePack) for singletons.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Strategies.StorageOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Strategies.StorageOptions.md
new file mode 100644
index 00000000..e5213011
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Strategies.StorageOptions.md
@@ -0,0 +1,92 @@
+# <a id="Flowthru_Data_Storage_Strategies_StorageOptions"></a> Class StorageOptions
+
+Namespace: [Flowthru.Data.Storage.Strategies](Flowthru.Data.Storage.Strategies.md)  
+Assembly: Flowthru.Core.dll  
+
+Options for configuring storage entry creation.
+
+```csharp
+public sealed record StorageOptions : IEquatable<StorageOptions>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[StorageOptions](Flowthru.Data.Storage.Strategies.StorageOptions.md)
+
+#### Implements
+
+[IEquatable<StorageOptions\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Provides flexibility for strategy-specific configuration without
+requiring changes to the factory interface.
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_Strategies_StorageOptions_Metadata"></a> Metadata
+
+Additional strategy-specific metadata.
+
+```csharp
+public Dictionary<string, object>? Metadata { get; init; }
+```
+
+#### Property Value
+
+ [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [object](https://learn.microsoft.com/dotnet/api/system.object)\>?
+
+#### Remarks
+
+Examples:
+- Excel: {"SheetName": "Data"}
+- Database: {"Schema": "analytics", "Timeout": 30}
+- Parquet: {"CompressionCodec": "SNAPPY"}
+
+### <a id="Flowthru_Data_Storage_Strategies_StorageOptions_Path"></a> Path
+
+Relative path or identifier for the storage location.
+
+```csharp
+public string? Path { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Remarks
+
+Interpretation depends on the strategy:
+- CSV: File path relative to base directory (e.g., "_01_Raw/data.csv")
+- Database: Table name or qualified identifier (e.g., "dbo.Companies")
+- Memory: Ignored (memory storage has no path)
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_Strategies_StorageOptions_WithPath_System_String_"></a> WithPath\(string\)
+
+Creates storage options with a path.
+
+```csharp
+public static StorageOptions WithPath(string path)
+```
+
+#### Parameters
+
+`path` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Returns
+
+ [StorageOptions](Flowthru.Data.Storage.Strategies.StorageOptions.md)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Strategies.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Strategies.md
new file mode 100644
index 00000000..f312ae89
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.Strategies.md
@@ -0,0 +1,22 @@
+# <a id="Flowthru_Data_Storage_Strategies"></a> Namespace Flowthru.Data.Storage.Strategies
+
+### Classes
+
+ [DatabaseStorageEntryFactory](Flowthru.Data.Storage.Strategies.DatabaseStorageEntryFactory.md)
+
+Database-backed storage strategy for production environments.
+
+ [MemoryStorageEntryFactory](Flowthru.Data.Storage.Strategies.MemoryStorageEntryFactory.md)
+
+In-memory storage strategy for unit tests.
+
+ [StorageOptions](Flowthru.Data.Storage.Strategies.StorageOptions.md)
+
+Options for configuring storage entry creation.
+
+### Interfaces
+
+ [IStorageEntryFactory](Flowthru.Data.Storage.Strategies.IStorageEntryFactory.md)
+
+Factory for creating catalog entries with environment-specific storage.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.TextFileStorageAdapter.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.TextFileStorageAdapter.md
new file mode 100644
index 00000000..b977427f
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.TextFileStorageAdapter.md
@@ -0,0 +1,239 @@
+# <a id="Flowthru_Data_Storage_TextFileStorageAdapter"></a> Class TextFileStorageAdapter
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Core.dll  
+
+Storage adapter for plain text files with string content.
+
+```csharp
+public sealed class TextFileStorageAdapter : IStorageAdapter<string>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[TextFileStorageAdapter](Flowthru.Data.Storage.TextFileStorageAdapter.md)
+
+#### Implements
+
+[IStorageAdapter<string\>](Flowthru.Data.Storage.IStorageAdapter\-1.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Use Cases:</strong> Markdown reports, configuration files, plain text logs
+</p>
+<p>
+<strong>Storage Traits:</strong> All traits use filesystem baseline defaults
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_TextFileStorageAdapter__ctor_System_String_"></a> TextFileStorageAdapter\(string\)
+
+```csharp
+public TextFileStorageAdapter(string filePath)
+```
+
+#### Parameters
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_TextFileStorageAdapter_Traits"></a> Traits
+
+Structural constraints and capabilities of this storage implementation.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ [StorageTraits](Flowthru.Data.Capabilities.StorageTraits.md)
+
+#### Remarks
+
+<p>
+Adapter authors must declare what their storage can and cannot do.
+These are intrinsic properties of the storage medium, not runtime state.
+</p>
+<p>
+Pipeline validation uses these traits to fail fast when a pipeline attempts
+invalid operations (e.g., writing to a read-only source).
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_TextFileStorageAdapter_Exists"></a> Exists\(\)
+
+Checks if data exists at this storage location.
+
+```csharp
+public FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+Effect that produces true if data exists, false otherwise
+
+#### Remarks
+
+<p>
+Delegates to the underlying medium's Exists check.
+Used to determine if a catalog entry is a seed (Layer 0 input).
+</p>
+
+### <a id="Flowthru_Data_Storage_TextFileStorageAdapter_InspectDeep"></a> InspectDeep\(\)
+
+Performs deep validation by examining the entire dataset.
+
+```csharp
+public FlowIO<ValidationResult> InspectDeep()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that all data is available, accessible, and valid.
+</p>
+<p>
+<strong>Additional Checks Beyond Shallow:</strong>
+</p>
+<ul><li>Validate ALL rows can be deserialized (not just sample)</li><li>Check data quality constraints across entire dataset</li><li>Detect corruption or inconsistencies throughout data</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Read and validate entire file</li><li>Memory adapters: Validate all stored data</li><li>Database adapters: Full table scan with validation</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Potentially expensive - only use when data integrity is critical.
+</p>
+
+### <a id="Flowthru_Data_Storage_TextFileStorageAdapter_InspectShallow_System_Int32_"></a> InspectShallow\(int\)
+
+Performs shallow validation by checking data availability and sampling a subset of data.
+
+```csharp
+public FlowIO<ValidationResult> InspectShallow(int sampleSize)
+```
+
+#### Parameters
+
+`sampleSize` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of rows/records to sample for validation
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that data is available and accessible.
+</p>
+<p>
+<strong>Typical Checks:</strong>
+</p>
+<ul><li>Data source exists (file, table, etc.)</li><li>Data source is accessible (permissions, connectivity)</li><li>Sample rows can be read and deserialized successfully</li><li>Schema matches expected structure</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Check file exists, read and validate sample rows</li><li>Memory adapters: Check if data has been initialized</li><li>Database adapters: Check table exists, query sample rows</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Should be fast (~10-100ms) - suitable for pre-flight validation.
+</p>
+
+### <a id="Flowthru_Data_Storage_TextFileStorageAdapter_Load"></a> Load\(\)
+
+Loads data from storage.
+
+```csharp
+public FlowIO<string> Load()
+```
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+Effect that produces data on success
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. medium.ReadStream()           → Stream
+2. format.DeserializeRows()      → IAsyncEnumerable&lt;TRow&gt;
+3. container.FromRows()          → TContainer</code></pre>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Errors from any layer are propagated:
+- Medium errors (file not found, access denied)
+- Format errors (parse failures, schema mismatches)
+- Container errors (memory allocation, type conversion)
+</p>
+
+### <a id="Flowthru_Data_Storage_TextFileStorageAdapter_Save_System_String_"></a> Save\(string\)
+
+Saves data to storage.
+
+```csharp
+public FlowIO<FlowUnit> Save(string data)
+```
+
+#### Parameters
+
+`data` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+The data to save
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[FlowUnit](Flowthru.Effects.FlowUnit.md)\>
+
+Effect that completes on successful save
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. container.ToRows()            → IAsyncEnumerable&lt;TRow&gt;
+2. format.SerializeRows()        → Stream
+3. medium.WriteStream()          → FlowUnit</code></pre>
+<p>
+<strong>Atomicity:</strong>
+</p>
+<p>
+Implementations should strive for atomic saves to avoid partial writes on failure.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.md
new file mode 100644
index 00000000..91631031
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Storage.md
@@ -0,0 +1,71 @@
+# <a id="Flowthru_Data_Storage"></a> Namespace Flowthru.Data.Storage
+
+### Namespaces
+
+ [Flowthru.Data.Storage.Container](Flowthru.Data.Storage.Container.md)
+
+ [Flowthru.Data.Storage.Format](Flowthru.Data.Storage.Format.md)
+
+ [Flowthru.Data.Storage.Medium](Flowthru.Data.Storage.Medium.md)
+
+ [Flowthru.Data.Storage.Strategies](Flowthru.Data.Storage.Strategies.md)
+
+### Classes
+
+ [BinaryFileStorageAdapter](Flowthru.Data.Storage.BinaryFileStorageAdapter.md)
+
+Storage adapter for binary files with byte array content.
+
+ [ComposedStorageAdapter<TContainer, TRow\>](Flowthru.Data.Storage.ComposedStorageAdapter\-2.md)
+
+Composed storage adapter that delegates to medium, format, and container layers.
+
+ [MemoryStorageAdapter<T\>](Flowthru.Data.Storage.MemoryStorageAdapter\-1.md)
+
+Direct memory storage adapter that bypasses serialization.
+
+ [NullStorageAdapter<T\>](Flowthru.Data.Storage.NullStorageAdapter\-1.md)
+
+Null storage adapter for side-effect-only nodes that produce no meaningful data.
+
+ [PropertyMappingConfiguration](Flowthru.Data.Storage.PropertyMappingConfiguration.md)
+
+Describes how a format serializer handles property-to-field name mapping.
+
+ [SchemaActivator](Flowthru.Data.Storage.SchemaActivator.md)
+
+Factory for creating schema instances, supporting both traditional parameterless constructors
+and modern C# features like required members and positional records.
+
+ [SingletonJsonStorageAdapter<T\>](Flowthru.Data.Storage.SingletonJsonStorageAdapter\-1.md)
+
+Direct JSON file storage for singleton objects (not collections).
+
+ [TextFileStorageAdapter](Flowthru.Data.Storage.TextFileStorageAdapter.md)
+
+Storage adapter for plain text files with string content.
+
+### Interfaces
+
+ [IContainerAdapter<TContainer, TRow\>](Flowthru.Data.Storage.IContainerAdapter\-2.md)
+
+Interface for container adaptation - converts between streaming rows and in-memory containers.
+
+ [IFormatSerializer<TRow\>](Flowthru.Data.Storage.IFormatSerializer\-1.md)
+
+Interface for format serialization - handles row-based serialization/deserialization.
+
+ [IStorageAdapter<T\>](Flowthru.Data.Storage.IStorageAdapter\-1.md)
+
+Interface for high-level storage operations - abstracts Load/Save with any storage implementation.
+
+ [IStorageMedium](Flowthru.Data.Storage.IStorageMedium.md)
+
+Interface for storage medium - handles raw byte stream I/O.
+
+### Enums
+
+ [PropertyMappingStrategy](Flowthru.Data.Storage.PropertyMappingStrategy.md)
+
+Property mapping strategy used by a format serializer.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.InspectionLevel.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.InspectionLevel.md
new file mode 100644
index 00000000..b7104f61
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.InspectionLevel.md
@@ -0,0 +1,80 @@
+# <a id="Flowthru_Data_Validation_InspectionLevel"></a> Enum InspectionLevel
+
+Namespace: [Flowthru.Data.Validation](Flowthru.Data.Validation.md)  
+Assembly: Flowthru.Core.dll  
+
+Defines the level of inspection to perform on catalog entries before pipeline execution.
+
+```csharp
+public enum InspectionLevel
+```
+
+## Fields
+
+`Deep = 2` 
+
+Perform deep inspection: all checks from Shallow plus validation of ALL rows.
+
+<p>
+<strong>What Deep Inspection Adds:</strong>
+</p>
+<ul><li>All checks from Shallow inspection</li><li>Validates EVERY row deserializes successfully</li><li>Checks for data quality issues throughout entire dataset</li></ul>
+<p>
+Performance: Potentially significant overhead (seconds to minutes for large datasets)
+</p>
+<p>
+<strong>Use Cases:</strong>
+</p>
+<ul><li>Critical production deployments</li><li>After external data updates</li><li>CI/CD regression testing</li><li>When data corruption is suspected</li></ul>
+<p>
+<strong>Must be explicitly opted-in by the pipeline creator.</strong>
+</p>
+
+`None = 0` 
+
+Skip inspection entirely.
+
+Use when:
+- Data source is trusted and validated externally
+- Validation overhead is prohibitive for large datasets
+- You're explicitly opting out of safety checks
+
+`Shallow = 1` 
+
+Perform shallow inspection: existence, format, headers, and sample rows.
+
+<p>
+<strong>What Shallow Inspection Checks:</strong>
+</p>
+<ul><li>File/resource exists</li><li>Format is valid (parseable as CSV/Excel/Parquet/etc.)</li><li>Headers match expected schema (column names, property mappings)</li><li>First N rows (default: 100) deserialize successfully</li><li>Data types are compatible with schema</li></ul>
+<p>
+Performance: Minimal overhead (~10-100ms for typical files)
+</p>
+<p>
+<strong>This is the default for all Layer 0 inputs.</strong>
+</p>
+
+## Remarks
+
+<p>
+Inspection levels are used to validate external data sources (Layer 0 inputs) before
+the pipeline begins execution, following the "fail-fast" principle.
+</p>
+<p>
+<strong>Default Behavior:</strong>
+- External inputs (Layer 0): Shallow inspection (all storage adapters support inspection)
+- Intermediate outputs (Layer 1+): Always None (not inspected, they're created by the pipeline)
+</p>
+<p>
+<strong>When to Use Each Level:</strong>
+</p>
+<ul><li><span class="term">None</span>
+Skip validation entirely. Use for trusted data sources or when validation overhead is prohibitive.
+</li><li><span class="term">Shallow</span>
+Validate existence, format, headers, and a sample of rows. Fast and catches most common issues.
+<strong>This is the default for Layer 0 inputs.</strong>
+</li><li><span class="term">Deep</span>
+Validate all rows in the dataset. Thorough but expensive. Use for critical data or after
+external updates. Must be explicitly opted-in.
+</li></ul>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.ValidationError.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.ValidationError.md
new file mode 100644
index 00000000..6e1d8e5a
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.ValidationError.md
@@ -0,0 +1,132 @@
+# <a id="Flowthru_Data_Validation_ValidationError"></a> Class ValidationError
+
+Namespace: [Flowthru.Data.Validation](Flowthru.Data.Validation.md)  
+Assembly: Flowthru.Core.dll  
+
+Represents a single validation error discovered during catalog entry inspection.
+
+```csharp
+public class ValidationError
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ValidationError](Flowthru.Data.Validation.ValidationError.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+ValidationError provides structured information about what went wrong during
+inspection, making it easier to diagnose and fix data issues.
+
+## Constructors
+
+### <a id="Flowthru_Data_Validation_ValidationError__ctor_System_String_Flowthru_Data_Validation_ValidationErrorType_System_String_System_String_"></a> ValidationError\(string, ValidationErrorType, string, string?\)
+
+Creates a new validation error.
+
+```csharp
+public ValidationError(string catalogKey, ValidationErrorType errorType, string message, string? details = null)
+```
+
+#### Parameters
+
+`catalogKey` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+The catalog entry key where the error occurred
+
+`errorType` [ValidationErrorType](Flowthru.Data.Validation.ValidationErrorType.md)
+
+The category of error
+
+`message` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Human-readable description of the error
+
+`details` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+Optional additional context (file path, row number, column name, etc.)
+
+## Properties
+
+### <a id="Flowthru_Data_Validation_ValidationError_CatalogKey"></a> CatalogKey
+
+The catalog entry key where the error occurred.
+
+```csharp
+public string CatalogKey { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Data_Validation_ValidationError_Details"></a> Details
+
+Optional additional context about the error.
+
+```csharp
+public string? Details { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Remarks
+
+May contain:
+- File path
+- Row number
+- Column name
+- Expected vs actual values
+- Stack trace (for exceptions)
+
+### <a id="Flowthru_Data_Validation_ValidationError_ErrorType"></a> ErrorType
+
+The category of error that occurred.
+
+```csharp
+public ValidationErrorType ErrorType { get; }
+```
+
+#### Property Value
+
+ [ValidationErrorType](Flowthru.Data.Validation.ValidationErrorType.md)
+
+### <a id="Flowthru_Data_Validation_ValidationError_Message"></a> Message
+
+Human-readable description of the error.
+
+```csharp
+public string Message { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+## Methods
+
+### <a id="Flowthru_Data_Validation_ValidationError_ToString"></a> ToString\(\)
+
+Returns a formatted string representation of the error.
+
+```csharp
+public override string ToString()
+```
+
+#### Returns
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.ValidationErrorType.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.ValidationErrorType.md
new file mode 100644
index 00000000..acf4346a
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.ValidationErrorType.md
@@ -0,0 +1,55 @@
+# <a id="Flowthru_Data_Validation_ValidationErrorType"></a> Enum ValidationErrorType
+
+Namespace: [Flowthru.Data.Validation](Flowthru.Data.Validation.md)  
+Assembly: Flowthru.Core.dll  
+
+Categories of validation errors that can occur during catalog entry inspection.
+
+```csharp
+public enum ValidationErrorType
+```
+
+## Fields
+
+`DeserializationError = 4` 
+
+A row failed to deserialize (missing required field, invalid value, etc.).
+
+
+
+`EmptyDataset = 5` 
+
+The data source is empty when data was expected.
+
+
+
+`InspectionFailure = 6` 
+
+An unexpected exception occurred during inspection.
+
+
+
+`InvalidFormat = 1` 
+
+The data format is invalid or corrupted (malformed CSV, corrupt Parquet, etc.).
+
+
+
+`NotFound = 0` 
+
+The data source does not exist (file not found, URL unreachable, etc.).
+
+
+
+`SchemaMismatch = 2` 
+
+Headers or column names don't match the expected schema.
+
+
+
+`TypeMismatch = 3` 
+
+Data types in the source don't match the expected types.
+
+
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.ValidationException.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.ValidationException.md
new file mode 100644
index 00000000..378837cc
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.ValidationException.md
@@ -0,0 +1,78 @@
+# <a id="Flowthru_Data_Validation_ValidationException"></a> Class ValidationException
+
+Namespace: [Flowthru.Data.Validation](Flowthru.Data.Validation.md)  
+Assembly: Flowthru.Core.dll  
+
+Exception thrown when catalog entry validation fails.
+
+```csharp
+public class ValidationException : Exception, ISerializable
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[Exception](https://learn.microsoft.com/dotnet/api/system.exception) ← 
+[ValidationException](Flowthru.Data.Validation.ValidationException.md)
+
+#### Implements
+
+[ISerializable](https://learn.microsoft.com/dotnet/api/system.runtime.serialization.iserializable)
+
+#### Inherited Members
+
+[Exception.GetBaseException\(\)](https://learn.microsoft.com/dotnet/api/system.exception.getbaseexception), 
+[Exception.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.exception.gettype), 
+[Exception.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.exception.tostring), 
+[Exception.Data](https://learn.microsoft.com/dotnet/api/system.exception.data), 
+[Exception.HelpLink](https://learn.microsoft.com/dotnet/api/system.exception.helplink), 
+[Exception.HResult](https://learn.microsoft.com/dotnet/api/system.exception.hresult), 
+[Exception.InnerException](https://learn.microsoft.com/dotnet/api/system.exception.innerexception), 
+[Exception.Message](https://learn.microsoft.com/dotnet/api/system.exception.message), 
+[Exception.Source](https://learn.microsoft.com/dotnet/api/system.exception.source), 
+[Exception.StackTrace](https://learn.microsoft.com/dotnet/api/system.exception.stacktrace), 
+[Exception.TargetSite](https://learn.microsoft.com/dotnet/api/system.exception.targetsite), 
+[Exception.SerializeObjectState](https://learn.microsoft.com/dotnet/api/system.exception.serializeobjectstate), 
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+This exception is thrown by <xref href="Flowthru.Data.Validation.ValidationResult.ThrowIfInvalid" data-throw-if-not-resolved="false"></xref> to halt
+pipeline execution when external data validation fails.
+
+## Constructors
+
+### <a id="Flowthru_Data_Validation_ValidationException__ctor_Flowthru_Data_Validation_ValidationResult_"></a> ValidationException\(ValidationResult\)
+
+Creates a new validation exception.
+
+```csharp
+public ValidationException(ValidationResult validationResult)
+```
+
+#### Parameters
+
+`validationResult` [ValidationResult](Flowthru.Data.Validation.ValidationResult.md)
+
+The validation result containing errors
+
+## Properties
+
+### <a id="Flowthru_Data_Validation_ValidationException_ValidationResult"></a> ValidationResult
+
+The validation result containing all errors.
+
+```csharp
+public ValidationResult ValidationResult { get; }
+```
+
+#### Property Value
+
+ [ValidationResult](Flowthru.Data.Validation.ValidationResult.md)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.ValidationResult.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.ValidationResult.md
new file mode 100644
index 00000000..c0afe962
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.ValidationResult.md
@@ -0,0 +1,200 @@
+# <a id="Flowthru_Data_Validation_ValidationResult"></a> Class ValidationResult
+
+Namespace: [Flowthru.Data.Validation](Flowthru.Data.Validation.md)  
+Assembly: Flowthru.Core.dll  
+
+Represents the result of inspecting one or more catalog entries.
+
+```csharp
+public class ValidationResult
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+ValidationResult provides a structured way to collect and report validation errors
+discovered during catalog entry inspection. It supports both single-entry and
+multi-entry validation scenarios.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_Validation_ValidationResult__ctor"></a> ValidationResult\(\)
+
+Creates a successful validation result with no errors.
+
+```csharp
+public ValidationResult()
+```
+
+### <a id="Flowthru_Data_Validation_ValidationResult__ctor_System_Collections_Generic_IEnumerable_Flowthru_Data_Validation_ValidationError__"></a> ValidationResult\(IEnumerable<ValidationError\>\)
+
+Creates a validation result with the specified errors.
+
+```csharp
+public ValidationResult(IEnumerable<ValidationError> errors)
+```
+
+#### Parameters
+
+`errors` [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<[ValidationError](Flowthru.Data.Validation.ValidationError.md)\>
+
+Collection of validation errors
+
+## Properties
+
+### <a id="Flowthru_Data_Validation_ValidationResult_ErrorCount"></a> ErrorCount
+
+Number of validation errors found.
+
+```csharp
+public int ErrorCount { get; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+### <a id="Flowthru_Data_Validation_ValidationResult_Errors"></a> Errors
+
+Read-only collection of all validation errors.
+
+```csharp
+public IReadOnlyList<ValidationError> Errors { get; }
+```
+
+#### Property Value
+
+ [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[ValidationError](Flowthru.Data.Validation.ValidationError.md)\>
+
+### <a id="Flowthru_Data_Validation_ValidationResult_HasErrors"></a> HasErrors
+
+True if one or more validation errors were found.
+
+```csharp
+public bool HasErrors { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Data_Validation_ValidationResult_IsValid"></a> IsValid
+
+True if no validation errors were found.
+
+```csharp
+public bool IsValid { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+## Methods
+
+### <a id="Flowthru_Data_Validation_ValidationResult_Failure_System_String_Flowthru_Data_Validation_ValidationErrorType_System_String_System_String_"></a> Failure\(string, ValidationErrorType, string, string?\)
+
+Creates a failed validation result with a single error.
+
+```csharp
+public static ValidationResult Failure(string catalogKey, ValidationErrorType errorType, string message, string? details = null)
+```
+
+#### Parameters
+
+`catalogKey` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+The catalog entry key where the error occurred
+
+`errorType` [ValidationErrorType](Flowthru.Data.Validation.ValidationErrorType.md)
+
+The category of error
+
+`message` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Human-readable description of the error
+
+`details` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+Optional additional context
+
+#### Returns
+
+ [ValidationResult](Flowthru.Data.Validation.ValidationResult.md)
+
+### <a id="Flowthru_Data_Validation_ValidationResult_FromException_System_String_System_Exception_"></a> FromException\(string, Exception\)
+
+Creates a failed validation result from an exception.
+
+```csharp
+public static ValidationResult FromException(string catalogKey, Exception exception)
+```
+
+#### Parameters
+
+`catalogKey` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+The catalog entry key where the error occurred
+
+`exception` [Exception](https://learn.microsoft.com/dotnet/api/system.exception)
+
+The exception that occurred during inspection
+
+#### Returns
+
+ [ValidationResult](Flowthru.Data.Validation.ValidationResult.md)
+
+### <a id="Flowthru_Data_Validation_ValidationResult_Success"></a> Success\(\)
+
+Creates a successful validation result.
+
+```csharp
+public static ValidationResult Success()
+```
+
+#### Returns
+
+ [ValidationResult](Flowthru.Data.Validation.ValidationResult.md)
+
+### <a id="Flowthru_Data_Validation_ValidationResult_ThrowIfInvalid"></a> ThrowIfInvalid\(\)
+
+Throws a ValidationException if this result has errors.
+
+```csharp
+public void ThrowIfInvalid()
+```
+
+#### Exceptions
+
+ [ValidationException](Flowthru.Data.Validation.ValidationException.md)
+
+Thrown if validation failed
+
+### <a id="Flowthru_Data_Validation_ValidationResult_ToString"></a> ToString\(\)
+
+Returns a formatted string representation of all errors.
+
+```csharp
+public override string ToString()
+```
+
+#### Returns
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.md
new file mode 100644
index 00000000..bb688bd6
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.Validation.md
@@ -0,0 +1,26 @@
+# <a id="Flowthru_Data_Validation"></a> Namespace Flowthru.Data.Validation
+
+### Classes
+
+ [ValidationError](Flowthru.Data.Validation.ValidationError.md)
+
+Represents a single validation error discovered during catalog entry inspection.
+
+ [ValidationException](Flowthru.Data.Validation.ValidationException.md)
+
+Exception thrown when catalog entry validation fails.
+
+ [ValidationResult](Flowthru.Data.Validation.ValidationResult.md)
+
+Represents the result of inspecting one or more catalog entries.
+
+### Enums
+
+ [InspectionLevel](Flowthru.Data.Validation.InspectionLevel.md)
+
+Defines the level of inspection to perform on catalog entries before pipeline execution.
+
+ [ValidationErrorType](Flowthru.Data.Validation.ValidationErrorType.md)
+
+Categories of validation errors that can occur during catalog entry inspection.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Data.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.md
new file mode 100644
index 00000000..4f6882af
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Data.md
@@ -0,0 +1,43 @@
+# <a id="Flowthru_Data"></a> Namespace Flowthru.Data
+
+### Namespaces
+
+ [Flowthru.Data.Capabilities](Flowthru.Data.Capabilities.md)
+
+ [Flowthru.Data.Storage](Flowthru.Data.Storage.md)
+
+ [Flowthru.Data.Validation](Flowthru.Data.Validation.md)
+
+### Classes
+
+ [CatalogAbstract](Flowthru.Data.CatalogAbstract.md)
+
+Base class for strongly-typed catalog implementations with automatic property caching.
+
+ [EnumerableItems](Flowthru.Data.EnumerableItems.md)
+
+Extension point for <xref href="Flowthru.Data.Items.Enumerable" data-throw-if-not-resolved="false"></xref> factory methods.
+
+ [Item<T\>](Flowthru.Data.Item\-1.md)
+
+Standard catalog item implementation that delegates to a storage adapter.
+
+ [Items](Flowthru.Data.Items.md)
+
+Static factory methods for creating catalog entries with common configurations.
+
+ [Items.Single](Flowthru.Data.Items.Single.md)
+
+Factory methods for single (non-collection) values.
+
+### Interfaces
+
+ [IItem<T\>](Flowthru.Data.IItem\-1.md)
+
+Unified catalog item with cardinality encoded in the type parameter.
+
+ [IItem](Flowthru.Data.IItem.md)
+
+Non-generic base interface for catalog items.
+Provides untyped operations for internal use by the flow executor and mapping layer.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Effects.FlowIO-1.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Effects.FlowIO-1.md
new file mode 100644
index 00000000..917ee9c9
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Effects.FlowIO-1.md
@@ -0,0 +1,338 @@
+# <a id="Flowthru_Effects_FlowIO_1"></a> Struct FlowIO<A\>
+
+Namespace: [Flowthru.Effects](Flowthru.Effects.md)  
+Assembly: Flowthru.Core.dll  
+
+Represents a cancellable asynchronous effect that produces a value of type <code class="typeparamref">A</code>.
+
+```csharp
+public readonly struct FlowIO<A>
+```
+
+#### Type Parameters
+
+`A` 
+
+The type of value produced by this effect.
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<xref href="Flowthru.Effects.FlowIO%601" data-throw-if-not-resolved="false"></xref> is a lightweight effect monad for representing I/O operations.
+It provides:
+</p>
+<ul><li>Lazy evaluation - effects don't run until <xref href="Flowthru.Effects.FlowIO%601.Run(System.Threading.CancellationToken)" data-throw-if-not-resolved="false"></xref> is called</li><li>Cancellation support - all effects accept a <xref href="System.Threading.CancellationToken" data-throw-if-not-resolved="false"></xref></li><li>Functor/Monad operations - <xref href="Flowthru.Effects.FlowIO%601.Map%60%601(System.Func%7b%600%2c%60%600%7d)" data-throw-if-not-resolved="false"></xref>, <xref href="Flowthru.Effects.FlowIO%601.Bind%60%601(System.Func%7b%600%2cFlowthru.Effects.FlowIO%7b%60%600%7d%7d)" data-throw-if-not-resolved="false"></xref></li><li>LINQ comprehension syntax - via <xref href="Flowthru.Effects.FlowIO%601.Select%60%601(System.Func%7b%600%2c%60%600%7d)" data-throw-if-not-resolved="false"></xref> and <xref href="Flowthru.Effects.FlowIO%601.SelectMany%60%602(System.Func%7b%600%2cFlowthru.Effects.FlowIO%7b%60%600%7d%7d%2cSystem.Func%7b%600%2c%60%600%2c%60%601%7d)" data-throw-if-not-resolved="false"></xref></li></ul>
+<p>
+<strong>Example - Basic usage:</strong>
+</p>
+<pre><code class="lang-csharp">FlowIO&lt;string&gt; ReadFile(string path) =&gt;
+    FlowIO.LiftAsync(ct =&gt; File.ReadAllTextAsync(path, ct));
+
+FlowIO&lt;int&gt; GetWordCount(string path) =&gt;
+    from content in ReadFile(path)
+    select content.Split(' ').Length;
+
+int count = await GetWordCount("data.txt").Run();</code></pre>
+<p>
+<strong>Example - Error handling:</strong>
+</p>
+<pre><code class="lang-csharp">FlowIO&lt;Data&gt; LoadData() =&gt;
+    FlowIO.LiftAsync(async ct =&gt; {
+        if (!File.Exists("data.json"))
+            throw new FileNotFoundException("Data file missing");
+        return await JsonSerializer.DeserializeAsync&lt;Data&gt;(...);
+    });
+
+try {
+    var data = await LoadData().Run();
+}
+catch (FileNotFoundException ex) {
+    // Handle error
+}</code></pre>
+
+## Methods
+
+### <a id="Flowthru_Effects_FlowIO_1_Bind__1_System_Func__0_Flowthru_Effects_FlowIO___0___"></a> Bind<B\>\(Func<A, FlowIO<B\>\>\)
+
+Binds this effect to a function that produces another effect.
+
+```csharp
+public FlowIO<B> Bind<B>(Func<A, FlowIO<B>> f)
+```
+
+#### Parameters
+
+`f` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<A, [FlowIO](Flowthru.Effects.FlowIO\-1.md)<B\>\>
+
+The function that takes this effect's result and produces a new effect.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<B\>
+
+A new effect representing the sequential composition of both effects.
+
+#### Type Parameters
+
+`B` 
+
+The result type of the produced effect.
+
+#### Remarks
+
+This is the monad's <code>bind</code> (or <code>&gt;&gt;=</code>) operation. It enables sequential
+composition of effects, forming a computational pipeline.
+
+### <a id="Flowthru_Effects_FlowIO_1_Catch_System_Func_System_Exception_Flowthru_Effects_FlowIO__0___"></a> Catch\(Func<Exception, FlowIO<A\>\>\)
+
+Catches exceptions thrown during effect execution and recovers with an alternative effect.
+
+```csharp
+public FlowIO<A> Catch(Func<Exception, FlowIO<A>> handler)
+```
+
+#### Parameters
+
+`handler` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[Exception](https://learn.microsoft.com/dotnet/api/system.exception), [FlowIO](Flowthru.Effects.FlowIO\-1.md)<A\>\>
+
+Function that receives the exception and produces a recovery effect.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<A\>
+
+A new effect that recovers from failures using <code class="paramref">handler</code>.
+
+### <a id="Flowthru_Effects_FlowIO_1_Catch__1_System_Func___0_Flowthru_Effects_FlowIO__0___"></a> Catch<TException\>\(Func<TException, FlowIO<A\>\>\)
+
+Catches exceptions of a specific type during effect execution.
+
+```csharp
+public FlowIO<A> Catch<TException>(Func<TException, FlowIO<A>> handler) where TException : Exception
+```
+
+#### Parameters
+
+`handler` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TException, [FlowIO](Flowthru.Effects.FlowIO\-1.md)<A\>\>
+
+Function that receives the exception and produces a recovery effect.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<A\>
+
+A new effect that recovers from specific exceptions.
+
+#### Type Parameters
+
+`TException` 
+
+The type of exception to catch.
+
+### <a id="Flowthru_Effects_FlowIO_1_IfFail__0_"></a> IfFail\(A\)
+
+Returns a default value if this effect fails.
+
+```csharp
+public FlowIO<A> IfFail(A defaultValue)
+```
+
+#### Parameters
+
+`defaultValue` A
+
+The value to return on failure.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<A\>
+
+A new effect that never fails, using <code class="paramref">defaultValue</code> on error.
+
+### <a id="Flowthru_Effects_FlowIO_1_IfFail_Flowthru_Effects_FlowIO__0__"></a> IfFail\(FlowIO<A\>\)
+
+Returns an alternative effect if this effect fails.
+
+```csharp
+public FlowIO<A> IfFail(FlowIO<A> alternative)
+```
+
+#### Parameters
+
+`alternative` [FlowIO](Flowthru.Effects.FlowIO\-1.md)<A\>
+
+The effect to run on failure.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<A\>
+
+A new effect that falls back to <code class="paramref">alternative</code> on error.
+
+### <a id="Flowthru_Effects_FlowIO_1_Map__1_System_Func__0___0__"></a> Map<B\>\(Func<A, B\>\)
+
+Maps the result of this effect using the specified function.
+
+```csharp
+public FlowIO<B> Map<B>(Func<A, B> f)
+```
+
+#### Parameters
+
+`f` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<A, B\>
+
+The function to apply to the effect's result.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<B\>
+
+A new effect that applies <code class="paramref">f</code> to this effect's result.
+
+#### Type Parameters
+
+`B` 
+
+The result type after mapping.
+
+#### Remarks
+
+This is the functor's <code>fmap</code> operation. It transforms the value inside the effect
+without changing the effect structure.
+
+### <a id="Flowthru_Effects_FlowIO_1_MapAsync__1_System_Func__0_System_Threading_Tasks_Task___0___"></a> MapAsync<B\>\(Func<A, Task<B\>\>\)
+
+Maps the result of this effect using an async function.
+
+```csharp
+public FlowIO<B> MapAsync<B>(Func<A, Task<B>> f)
+```
+
+#### Parameters
+
+`f` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<A, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<B\>\>
+
+The async function to apply to the effect's result.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<B\>
+
+A new effect that applies <code class="paramref">f</code> to this effect's result.
+
+#### Type Parameters
+
+`B` 
+
+The result type after mapping.
+
+### <a id="Flowthru_Effects_FlowIO_1_Run_System_Threading_CancellationToken_"></a> Run\(CancellationToken\)
+
+Executes this effect and returns the result.
+
+```csharp
+public ValueTask<A> Run(CancellationToken token = default)
+```
+
+#### Parameters
+
+`token` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+Optional cancellation token to cancel the effect.
+
+#### Returns
+
+ [ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask\-1)<A\>
+
+A <xref href="System.Threading.Tasks.ValueTask%601" data-throw-if-not-resolved="false"></xref> representing the asynchronous operation.
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if the effect is uninitialized.
+
+### <a id="Flowthru_Effects_FlowIO_1_Select__1_System_Func__0___0__"></a> Select<B\>\(Func<A, B\>\)
+
+Transforms this effect using the specified function (alias for <xref href="Flowthru.Effects.FlowIO%601.Map%60%601(System.Func%7b%600%2c%60%600%7d)" data-throw-if-not-resolved="false"></xref>).
+Enables LINQ <code>select</code> syntax.
+
+```csharp
+public FlowIO<B> Select<B>(Func<A, B> selector)
+```
+
+#### Parameters
+
+`selector` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<A, B\>
+
+The function to apply to the effect's result.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<B\>
+
+A new effect with the transformed result.
+
+#### Type Parameters
+
+`B` 
+
+The result type after transformation.
+
+#### Remarks
+
+<strong>Example:</strong>
+<pre><code class="lang-csharp">var result = from x in GetValue()
+             select x * 2;</code></pre>
+
+### <a id="Flowthru_Effects_FlowIO_1_SelectMany__2_System_Func__0_Flowthru_Effects_FlowIO___0___System_Func__0___0___1__"></a> SelectMany<B, C\>\(Func<A, FlowIO<B\>\>, Func<A, B, C\>\)
+
+Projects this effect through a function that produces another effect, then combines
+both results using a projection function. Enables LINQ <code>from...from...select</code> syntax.
+
+```csharp
+public FlowIO<C> SelectMany<B, C>(Func<A, FlowIO<B>> bind, Func<A, B, C> project)
+```
+
+#### Parameters
+
+`bind` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<A, [FlowIO](Flowthru.Effects.FlowIO\-1.md)<B\>\>
+
+The function that produces the next effect based on this effect's result.
+
+`project` [Func](https://learn.microsoft.com/dotnet/api/system.func\-3)<A, B, C\>
+
+The function that combines both results into the final result.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<C\>
+
+A new effect representing the composition.
+
+#### Type Parameters
+
+`B` 
+
+The intermediate result type.
+
+`C` 
+
+The final result type.
+
+#### Remarks
+
+<strong>Example:</strong>
+<pre><code class="lang-csharp">var result = from x in GetFirstValue()
+             from y in GetSecondValue(x)
+             select x + y;</code></pre>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Effects.FlowIO.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Effects.FlowIO.md
new file mode 100644
index 00000000..783065ed
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Effects.FlowIO.md
@@ -0,0 +1,243 @@
+# <a id="Flowthru_Effects_FlowIO"></a> Class FlowIO
+
+Namespace: [Flowthru.Effects](Flowthru.Effects.md)  
+Assembly: Flowthru.Core.dll  
+
+Provides factory methods and combinators for creating <xref href="Flowthru.Effects.FlowIO%601" data-throw-if-not-resolved="false"></xref> effects.
+
+```csharp
+public static class FlowIO
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowIO](Flowthru.Effects.FlowIO.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Flowthru_Effects_FlowIO_Fail__1_System_Exception_"></a> Fail<A\>\(Exception\)
+
+Creates an effect that immediately fails with the given exception.
+
+```csharp
+public static FlowIO<A> Fail<A>(Exception error)
+```
+
+#### Parameters
+
+`error` [Exception](https://learn.microsoft.com/dotnet/api/system.exception)
+
+The exception to throw.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<A\>
+
+An effect that fails with <code class="paramref">error</code>.
+
+#### Type Parameters
+
+`A` 
+
+The expected result type.
+
+### <a id="Flowthru_Effects_FlowIO_Fail__1_System_String_"></a> Fail<A\>\(string\)
+
+Creates an effect that immediately fails with an exception containing the given message.
+
+```csharp
+public static FlowIO<A> Fail<A>(string message)
+```
+
+#### Parameters
+
+`message` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+The error message.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<A\>
+
+An effect that fails with an exception containing <code class="paramref">message</code>.
+
+#### Type Parameters
+
+`A` 
+
+The expected result type.
+
+### <a id="Flowthru_Effects_FlowIO_Lift__1_System_Func___0__"></a> Lift<A\>\(Func<A\>\)
+
+Lifts a synchronous function into an effect.
+
+```csharp
+public static FlowIO<A> Lift<A>(Func<A> f)
+```
+
+#### Parameters
+
+`f` [Func](https://learn.microsoft.com/dotnet/api/system.func\-1)<A\>
+
+The function to lift.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<A\>
+
+An effect that executes <code class="paramref">f</code>.
+
+#### Type Parameters
+
+`A` 
+
+The return type.
+
+#### Remarks
+
+The function is still executed lazily - only when <xref href="Flowthru.Effects.FlowIO%601.Run(System.Threading.CancellationToken)" data-throw-if-not-resolved="false"></xref> is called.
+
+### <a id="Flowthru_Effects_FlowIO_LiftAsync__1_System_Func_System_Threading_CancellationToken_System_Threading_Tasks_ValueTask___0___"></a> LiftAsync<A\>\(Func<CancellationToken, ValueTask<A\>\>\)
+
+Lifts a cancellation-aware <xref href="System.Threading.Tasks.ValueTask%601" data-throw-if-not-resolved="false"></xref>-returning function into an effect.
+
+```csharp
+public static FlowIO<A> LiftAsync<A>(Func<CancellationToken, ValueTask<A>> f)
+```
+
+#### Parameters
+
+`f` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken), [ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask\-1)<A\>\>
+
+The function that accepts a cancellation token and returns a <xref href="System.Threading.Tasks.ValueTask%601" data-throw-if-not-resolved="false"></xref>.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<A\>
+
+An effect that executes <code class="paramref">f</code>.
+
+#### Type Parameters
+
+`A` 
+
+The return type.
+
+#### Remarks
+
+<p>
+All async I/O operations should observe the cancellation token to support graceful shutdown.
+If your operation is truly synchronous, use <xref href="Flowthru.Effects.FlowIO.Lift%60%601(System.Func%7b%60%600%7d)" data-throw-if-not-resolved="false"></xref> instead.
+</p>
+<p>
+For Task-based APIs, convert using <code>.AsTask()</code>: <code>LiftAsync(async ct =&gt; await SomeTaskAsync(ct).AsTask())</code>
+or rely on implicit conversion from Task to ValueTask.
+</p>
+
+### <a id="Flowthru_Effects_FlowIO_Pure__1___0_"></a> Pure<A\>\(A\)
+
+Creates an effect that immediately returns the given value.
+
+```csharp
+public static FlowIO<A> Pure<A>(A value)
+```
+
+#### Parameters
+
+`value` A
+
+The value to return.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<A\>
+
+An effect that produces <code class="paramref">value</code>.
+
+#### Type Parameters
+
+`A` 
+
+The type of value.
+
+#### Remarks
+
+This is the monad's <code>return</code> or <code>pure</code> operation.
+
+### <a id="Flowthru_Effects_FlowIO_Sequence__1_System_Collections_Generic_IEnumerable_Flowthru_Effects_FlowIO___0___"></a> Sequence<A\>\(IEnumerable<FlowIO<A\>\>\)
+
+Sequences a collection of effects, running them all and collecting the results.
+
+```csharp
+public static FlowIO<IEnumerable<A>> Sequence<A>(IEnumerable<FlowIO<A>> effects)
+```
+
+#### Parameters
+
+`effects` [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<[FlowIO](Flowthru.Effects.FlowIO\-1.md)<A\>\>
+
+The collection of effects to sequence.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<A\>\>
+
+An effect that produces an enumerable of all results.
+
+#### Type Parameters
+
+`A` 
+
+The result type of each effect.
+
+#### Remarks
+
+Effects are executed sequentially in the order they appear in the collection.
+If any effect fails, the entire sequence fails.
+
+### <a id="Flowthru_Effects_FlowIO_Traverse__2_System_Collections_Generic_IEnumerable___0__System_Func___0_Flowthru_Effects_FlowIO___1___"></a> Traverse<A, B\>\(IEnumerable<A\>, Func<A, FlowIO<B\>\>\)
+
+Traverses a collection, applying an effect-producing function to each element
+and collecting the results.
+
+```csharp
+public static FlowIO<IEnumerable<B>> Traverse<A, B>(IEnumerable<A> source, Func<A, FlowIO<B>> f)
+```
+
+#### Parameters
+
+`source` [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<A\>
+
+The collection to traverse.
+
+`f` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<A, [FlowIO](Flowthru.Effects.FlowIO\-1.md)<B\>\>
+
+The function that produces an effect for each element.
+
+#### Returns
+
+ [FlowIO](Flowthru.Effects.FlowIO\-1.md)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<B\>\>
+
+An effect that produces an enumerable of results.
+
+#### Type Parameters
+
+`A` 
+
+The source element type.
+
+`B` 
+
+The result type.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Effects.FlowUnit.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Effects.FlowUnit.md
new file mode 100644
index 00000000..5777d3df
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Effects.FlowUnit.md
@@ -0,0 +1,292 @@
+# <a id="Flowthru_Effects_FlowUnit"></a> Struct FlowUnit
+
+Namespace: [Flowthru.Effects](Flowthru.Effects.md)  
+Assembly: Flowthru.Core.dll  
+
+Represents a void-like value for effect operations with no meaningful return value.
+Similar to <code>Unit</code> in functional programming or <code>void</code> in imperative programming,
+but usable as a type parameter.
+
+```csharp
+public readonly struct FlowUnit : IEquatable<FlowUnit>, IComparable<FlowUnit>
+```
+
+#### Implements
+
+[IEquatable<FlowUnit\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1), 
+[IComparable<FlowUnit\>](https://learn.microsoft.com/dotnet/api/system.icomparable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+Use <xref href="Flowthru.Effects.FlowUnit" data-throw-if-not-resolved="false"></xref> when an effect produces side effects but no meaningful result.
+For example, <code>FlowIO&lt;FlowUnit&gt;</code> represents an I/O operation that doesn't return data.
+</p>
+<p>
+<strong>Example:</strong>
+</p>
+<pre><code class="lang-csharp">FlowIO&lt;FlowUnit&gt; WriteLog(string message) =&gt;
+    FlowIO.LiftAsync(async ct =&gt; {
+        await File.WriteAllTextAsync("log.txt", message, ct);
+        return FlowFlowUnit.Default;
+    });</code></pre>
+
+## Fields
+
+### <a id="Flowthru_Effects_FlowUnit_Default"></a> Default
+
+The single instance of <xref href="Flowthru.Effects.FlowUnit" data-throw-if-not-resolved="false"></xref>.
+
+```csharp
+public static readonly FlowUnit Default
+```
+
+#### Field Value
+
+ [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+## Methods
+
+### <a id="Flowthru_Effects_FlowUnit_CompareTo_Flowthru_Effects_FlowUnit_"></a> CompareTo\(FlowUnit\)
+
+Compares the current instance with another <xref href="Flowthru.Effects.FlowUnit" data-throw-if-not-resolved="false"></xref>.
+
+```csharp
+public int CompareTo(FlowUnit other)
+```
+
+#### Parameters
+
+`other` [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+The <xref href="Flowthru.Effects.FlowUnit" data-throw-if-not-resolved="false"></xref> to compare.
+
+#### Returns
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Always 0, as all FlowUnit instances are equal.
+
+### <a id="Flowthru_Effects_FlowUnit_Equals_Flowthru_Effects_FlowUnit_"></a> Equals\(FlowUnit\)
+
+Determines whether the specified <xref href="Flowthru.Effects.FlowUnit" data-throw-if-not-resolved="false"></xref> is equal to the current instance.
+
+```csharp
+public bool Equals(FlowUnit other)
+```
+
+#### Parameters
+
+`other` [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+The <xref href="Flowthru.Effects.FlowUnit" data-throw-if-not-resolved="false"></xref> to compare.
+
+#### Returns
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+Always <code>true</code>, as all FlowUnit instances are equal.
+
+### <a id="Flowthru_Effects_FlowUnit_Equals_System_Object_"></a> Equals\(object?\)
+
+Determines whether the specified object is equal to the current instance.
+
+```csharp
+public override bool Equals(object? obj)
+```
+
+#### Parameters
+
+`obj` [object](https://learn.microsoft.com/dotnet/api/system.object)?
+
+The object to compare.
+
+#### Returns
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+<code>true</code> if <code class="paramref">obj</code> is a <xref href="Flowthru.Effects.FlowUnit" data-throw-if-not-resolved="false"></xref>; otherwise, <code>false</code>.
+
+### <a id="Flowthru_Effects_FlowUnit_GetHashCode"></a> GetHashCode\(\)
+
+Returns the hash code for this instance.
+
+```csharp
+public override int GetHashCode()
+```
+
+#### Returns
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Always returns 0, as all FlowUnit instances are equal.
+
+### <a id="Flowthru_Effects_FlowUnit_ToString"></a> ToString\(\)
+
+Returns a string representation of this instance.
+
+```csharp
+public override string ToString()
+```
+
+#### Returns
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Always returns "unit".
+
+## Operators
+
+### <a id="Flowthru_Effects_FlowUnit_op_Equality_Flowthru_Effects_FlowUnit_Flowthru_Effects_FlowUnit_"></a> operator ==\(FlowUnit, FlowUnit\)
+
+Determines whether two <xref href="Flowthru.Effects.FlowUnit" data-throw-if-not-resolved="false"></xref> instances are equal.
+
+```csharp
+public static bool operator ==(FlowUnit left, FlowUnit right)
+```
+
+#### Parameters
+
+`left` [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+The first instance to compare.
+
+`right` [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+The second instance to compare.
+
+#### Returns
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+Always <code>true</code>.
+
+### <a id="Flowthru_Effects_FlowUnit_op_GreaterThan_Flowthru_Effects_FlowUnit_Flowthru_Effects_FlowUnit_"></a> operator \>\(FlowUnit, FlowUnit\)
+
+Compares two <xref href="Flowthru.Effects.FlowUnit" data-throw-if-not-resolved="false"></xref> instances.
+
+```csharp
+public static bool operator >(FlowUnit left, FlowUnit right)
+```
+
+#### Parameters
+
+`left` [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+The first instance to compare.
+
+`right` [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+The second instance to compare.
+
+#### Returns
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+Always <code>false</code>.
+
+### <a id="Flowthru_Effects_FlowUnit_op_GreaterThanOrEqual_Flowthru_Effects_FlowUnit_Flowthru_Effects_FlowUnit_"></a> operator \>=\(FlowUnit, FlowUnit\)
+
+Compares two <xref href="Flowthru.Effects.FlowUnit" data-throw-if-not-resolved="false"></xref> instances.
+
+```csharp
+public static bool operator >=(FlowUnit left, FlowUnit right)
+```
+
+#### Parameters
+
+`left` [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+The first instance to compare.
+
+`right` [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+The second instance to compare.
+
+#### Returns
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+Always <code>true</code>.
+
+### <a id="Flowthru_Effects_FlowUnit_op_Inequality_Flowthru_Effects_FlowUnit_Flowthru_Effects_FlowUnit_"></a> operator \!=\(FlowUnit, FlowUnit\)
+
+Determines whether two <xref href="Flowthru.Effects.FlowUnit" data-throw-if-not-resolved="false"></xref> instances are not equal.
+
+```csharp
+public static bool operator !=(FlowUnit left, FlowUnit right)
+```
+
+#### Parameters
+
+`left` [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+The first instance to compare.
+
+`right` [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+The second instance to compare.
+
+#### Returns
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+Always <code>false</code>.
+
+### <a id="Flowthru_Effects_FlowUnit_op_LessThan_Flowthru_Effects_FlowUnit_Flowthru_Effects_FlowUnit_"></a> operator <\(FlowUnit, FlowUnit\)
+
+Compares two <xref href="Flowthru.Effects.FlowUnit" data-throw-if-not-resolved="false"></xref> instances.
+
+```csharp
+public static bool operator <(FlowUnit left, FlowUnit right)
+```
+
+#### Parameters
+
+`left` [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+The first instance to compare.
+
+`right` [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+The second instance to compare.
+
+#### Returns
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+Always <code>false</code>.
+
+### <a id="Flowthru_Effects_FlowUnit_op_LessThanOrEqual_Flowthru_Effects_FlowUnit_Flowthru_Effects_FlowUnit_"></a> operator <=\(FlowUnit, FlowUnit\)
+
+Compares two <xref href="Flowthru.Effects.FlowUnit" data-throw-if-not-resolved="false"></xref> instances.
+
+```csharp
+public static bool operator <=(FlowUnit left, FlowUnit right)
+```
+
+#### Parameters
+
+`left` [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+The first instance to compare.
+
+`right` [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+The second instance to compare.
+
+#### Returns
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+Always <code>true</code>.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Effects.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Effects.md
new file mode 100644
index 00000000..455a5630
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Effects.md
@@ -0,0 +1,20 @@
+# <a id="Flowthru_Effects"></a> Namespace Flowthru.Effects
+
+### Classes
+
+ [FlowIO](Flowthru.Effects.FlowIO.md)
+
+Provides factory methods and combinators for creating <xref href="Flowthru.Effects.FlowIO%601" data-throw-if-not-resolved="false"></xref> effects.
+
+### Structs
+
+ [FlowIO<A\>](Flowthru.Effects.FlowIO\-1.md)
+
+Represents a cancellable asynchronous effect that produces a value of type <code class="typeparamref">A</code>.
+
+ [FlowUnit](Flowthru.Effects.FlowUnit.md)
+
+Represents a void-like value for effect operations with no meaningful return value.
+Similar to <code>Unit</code> in functional programming or <code>void</code> in imperative programming,
+but usable as a type parameter.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.DryRunOption.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.DryRunOption.md
new file mode 100644
index 00000000..db999e61
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.DryRunOption.md
@@ -0,0 +1,89 @@
+# <a id="Flowthru_Flows_DryRunOption"></a> Struct DryRunOption
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Represents a dry-run configuration. Can be assigned from a <xref href="System.Boolean" data-throw-if-not-resolved="false"></xref>
+or a <xref href="Flowthru.Flows.ValidationDepth" data-throw-if-not-resolved="false"></xref> value.
+
+```csharp
+public readonly struct DryRunOption
+```
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Assigning <code>true</code> enables a full dry run (all pre-flight checks, no execution).
+Assigning <code>false</code> disables dry-run mode entirely.
+Assigning a <xref href="Flowthru.Flows.ValidationDepth" data-throw-if-not-resolved="false"></xref> enables dry-run at the specified depth.
+
+## Properties
+
+### <a id="Flowthru_Flows_DryRunOption_Depth"></a> Depth
+
+The validation depth applied when dry-run is enabled.
+
+```csharp
+public ValidationDepth Depth { get; }
+```
+
+#### Property Value
+
+ [ValidationDepth](Flowthru.Flows.ValidationDepth.md)
+
+### <a id="Flowthru_Flows_DryRunOption_Enabled"></a> Enabled
+
+Whether dry-run mode is enabled.
+
+```csharp
+public bool Enabled { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+## Operators
+
+### <a id="Flowthru_Flows_DryRunOption_op_Implicit_System_Boolean__Flowthru_Flows_DryRunOption"></a> implicit operator DryRunOption\(bool\)
+
+Implicitly converts a <xref href="System.Boolean" data-throw-if-not-resolved="false"></xref> to a <xref href="Flowthru.Flows.DryRunOption" data-throw-if-not-resolved="false"></xref>.
+<code>true</code> enables full dry-run; <code>false</code> disables it.
+
+```csharp
+public static implicit operator DryRunOption(bool value)
+```
+
+#### Parameters
+
+`value` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Returns
+
+ [DryRunOption](Flowthru.Flows.DryRunOption.md)
+
+### <a id="Flowthru_Flows_DryRunOption_op_Implicit_Flowthru_Flows_ValidationDepth__Flowthru_Flows_DryRunOption"></a> implicit operator DryRunOption\(ValidationDepth\)
+
+Implicitly converts a <xref href="Flowthru.Flows.ValidationDepth" data-throw-if-not-resolved="false"></xref> to a <xref href="Flowthru.Flows.DryRunOption" data-throw-if-not-resolved="false"></xref>,
+enabling dry-run at the specified depth.
+
+```csharp
+public static implicit operator DryRunOption(ValidationDepth depth)
+```
+
+#### Parameters
+
+`depth` [ValidationDepth](Flowthru.Flows.ValidationDepth.md)
+
+#### Returns
+
+ [DryRunOption](Flowthru.Flows.DryRunOption.md)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.ExecutionOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.ExecutionOptions.md
new file mode 100644
index 00000000..af95fbf9
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.ExecutionOptions.md
@@ -0,0 +1,120 @@
+# <a id="Flowthru_Flows_ExecutionOptions"></a> Class ExecutionOptions
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Configuration options for pipeline execution.
+
+```csharp
+public class ExecutionOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ExecutionOptions](Flowthru.Flows.ExecutionOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Controls how pipelines are executed and how results are presented.
+
+## Properties
+
+### <a id="Flowthru_Flows_ExecutionOptions_DryRun"></a> DryRun
+
+Whether to perform a dry run, and at what validation depth.
+
+```csharp
+public DryRunOption DryRun { get; set; }
+```
+
+#### Property Value
+
+ [DryRunOption](Flowthru.Flows.DryRunOption.md)
+
+#### Remarks
+
+Assign <code>true</code> to perform all pre-flight operations (structure validation,
+validation hooks, and external data source inspection) without executing nodes.
+Assign a <xref href="Flowthru.Flows.ValidationDepth" data-throw-if-not-resolved="false"></xref> value to control how deeply the pre-flight
+checks run — for example, <xref href="Flowthru.Flows.ValidationDepth.StructureOnly" data-throw-if-not-resolved="false"></xref> validates
+the pipeline graph and runs extension hooks without probing any data sources.
+Assign <code>false</code> (default) to run normally without a dry-run stop.
+
+### <a id="Flowthru_Flows_ExecutionOptions_EnableParallelExecution"></a> EnableParallelExecution
+
+Whether to enable parallel execution of nodes within the same layer.
+
+```csharp
+public bool EnableParallelExecution { get; set; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+Phase 2 feature - currently not implemented.
+When true, nodes in the same execution layer run concurrently.
+
+### <a id="Flowthru_Flows_ExecutionOptions_ResultFormatter"></a> ResultFormatter
+
+The result formatter to use for displaying execution results.
+
+```csharp
+public IFlowResultFormatter? ResultFormatter { get; set; }
+```
+
+#### Property Value
+
+ [IFlowResultFormatter](Flowthru.Results.IFlowResultFormatter.md)?
+
+#### Remarks
+
+Defaults to ConsoleResultFormatter if not specified.
+
+### <a id="Flowthru_Flows_ExecutionOptions_SliceStrategy"></a> SliceStrategy
+
+Optional slicing strategy to apply when executing pipelines.
+
+```csharp
+public FlowSliceStrategy? SliceStrategy { get; set; }
+```
+
+#### Property Value
+
+ [FlowSliceStrategy](Flowthru.Flows.FlowSliceStrategy.md)?
+
+#### Remarks
+
+When provided, only nodes matching the slice strategy will be executed.
+Used when slicing flags are provided without a specific pipeline name.
+
+### <a id="Flowthru_Flows_ExecutionOptions_StopOnFirstError"></a> StopOnFirstError
+
+Whether to stop execution on the first node failure.
+
+```csharp
+public bool StopOnFirstError { get; set; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+When true (default), pipeline execution stops immediately when a node fails.
+When false, execution continues to independent nodes (Phase 2 feature).
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.Flow.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.Flow.md
new file mode 100644
index 00000000..04e8ad4c
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.Flow.md
@@ -0,0 +1,418 @@
+# <a id="Flowthru_Flows_Flow"></a> Class Flow
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Represents a complete data flow with steps, dependencies, and execution order.
+
+```csharp
+public class Flow
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[Flow](Flowthru.Flows.Flow.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+A flow is a directed acyclic graph (DAG) of transformation steps.
+Each step reads data from catalog entries, performs transformations,
+and writes results back to catalog entries.
+</p>
+<p>
+<strong>Execution Model:</strong>
+</p>
+<ul><li>Steps are organized into layers via topological sort</li><li>Steps in layer 0 have no dependencies (read external data only)</li><li>Steps in layer N depend only on steps in layers 0..N-1</li><li>Sequential execution: Execute all steps in layer order</li><li>Parallel execution (Phase 2): Execute steps within same layer concurrently</li></ul>
+<p>
+<strong>Single Producer Rule:</strong> Each catalog entry can be written by at most
+one step. This ensures deterministic execution order and prevents race conditions.
+</p>
+
+## Properties
+
+### <a id="Flowthru_Flows_Flow_Description"></a> Description
+
+Optional description of what this flow does.
+
+```csharp
+public string? Description { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Flows_Flow_IsBuilt"></a> IsBuilt
+
+Indicates whether the flow has been built (dependencies analyzed and layers assigned).
+
+```csharp
+public bool IsBuilt { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Flows_Flow_Logger"></a> Logger
+
+Optional logger for flow execution.
+
+```csharp
+public ILogger? Logger { get; set; }
+```
+
+#### Property Value
+
+ [ILogger](https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger)?
+
+### <a id="Flowthru_Flows_Flow_Name"></a> Name
+
+Flow name for identification and logging.
+
+```csharp
+public string? Name { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Remarks
+
+Set by FlowRegistry during flow registration.
+
+### <a id="Flowthru_Flows_Flow_ServiceProvider"></a> ServiceProvider
+
+Optional service provider for dependency injection into steps.
+
+```csharp
+public IServiceProvider? ServiceProvider { get; set; }
+```
+
+#### Property Value
+
+ [IServiceProvider](https://learn.microsoft.com/dotnet/api/system.iserviceprovider)?
+
+#### Remarks
+
+Set by the service layer before flow execution to enable steps
+to resolve services (e.g., database connections, external APIs).
+
+### <a id="Flowthru_Flows_Flow_Steps"></a> Steps
+
+All steps in this flow, in the order they were added.
+
+```csharp
+public IReadOnlyList<FlowStep> Steps { get; }
+```
+
+#### Property Value
+
+ [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[FlowStep](Flowthru.Flows.FlowStep.md)\>
+
+#### Remarks
+
+Exposed as public to enable validation hooks (Phase 4) to inspect steps.
+The collection is read-only - steps can only be added via FlowBuilder.
+
+### <a id="Flowthru_Flows_Flow_ValidationHooks"></a> ValidationHooks
+
+Validation hooks that run during pre-flight checks.
+
+```csharp
+public List<IFlowValidationHook> ValidationHooks { get; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[IFlowValidationHook](Flowthru.Flows.Validation.IFlowValidationHook.md)\>
+
+#### Remarks
+
+<p>
+Extensions can register hooks to validate their own step types during pre-flight.
+Hooks are invoked after DAG analysis but before external input inspection.
+</p>
+<p>
+<strong>Hook execution order:</strong>
+</p>
+<ol><li>Flow.Build() - DAG construction and layer assignment</li><li>ValidationHooks.ValidateAsync() - Extension-specific validation</li><li>Flow.ValidateExternalInputsAsync() - External input inspection</li></ol>
+<p>
+<strong>Example (Python extension):</strong>
+</p>
+<pre><code class="lang-csharp">flow.ValidationHooks.Add(new PythonStepValidator(executor, runtime));</code></pre>
+
+### <a id="Flowthru_Flows_Flow_ValidationOptions"></a> ValidationOptions
+
+Validation options for this flow.
+
+```csharp
+public ValidationOptions ValidationOptions { get; }
+```
+
+#### Property Value
+
+ [ValidationOptions](Flowthru.Flows.Validation.ValidationOptions.md)
+
+#### Remarks
+
+Configures how external data sources (Layer 0 inputs) are validated
+before flow execution begins.
+
+## Methods
+
+### <a id="Flowthru_Flows_Flow_Build_Flowthru_Flows_FlowSliceStrategy_"></a> Build\(FlowSliceStrategy?\)
+
+Builds the flow by analyzing dependencies and assigning execution layers.
+Must be called before executing the flow.
+
+```csharp
+public void Build(FlowSliceStrategy? sliceStrategy = null)
+```
+
+#### Parameters
+
+`sliceStrategy` [FlowSliceStrategy](Flowthru.Flows.FlowSliceStrategy.md)?
+
+Optional slicing strategy to filter steps before execution
+
+#### Remarks
+
+<p>
+<strong>Slicing:</strong> If a slicing strategy is provided, only steps matching
+the strategy will be included in the execution. The slice always forms a valid
+sub-DAG with all required dependencies.
+</p>
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if:
+- Multiple steps write to the same catalog entry (single producer rule)
+- Circular dependency is detected
+- Slice strategy references non-existent steps or catalog entries
+
+### <a id="Flowthru_Flows_Flow_ExecuteAsync_System_Threading_CancellationToken_"></a> ExecuteAsync\(CancellationToken\)
+
+Executes the flow sequentially, layer by layer.
+
+```csharp
+public Task ExecuteAsync(CancellationToken cancellationToken)
+```
+
+#### Parameters
+
+`cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+Cancellation token to signal graceful shutdown
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
+
+Task representing the flow execution
+
+#### Remarks
+
+<p>
+This method executes flow in topological order:
+1. Execute all flow in layer 0 sequentially
+2. Execute all flow in layer 1 sequentially
+3. Continue until all layers are complete
+</p>
+<p>
+<strong>Note:</strong> This method throws exceptions on failure. For result-based
+execution with error handling, use RunAsync() instead.
+</p>
+<p>
+In Phase 2, this will be replaced with a parallel executor that can run
+steps within the same layer concurrently.
+</p>
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if flow has not been built
+
+### <a id="Flowthru_Flows_Flow_ExportDag"></a> ExportDag\(\)
+
+Exports DAG metadata for this Flow.
+
+```csharp
+public DagMetadata ExportDag()
+```
+
+#### Returns
+
+ [DagMetadata](Flowthru.Meta.Models.DagMetadata.md)
+
+Complete DAG metadata including steps, catalog entries, and edges
+
+#### Remarks
+
+<p>
+This method extracts structural metadata from the built flow , creating
+a complete representation of the DAG (Directed Acyclic Graph) that can be
+serialized to JSON for visualization in Flowthru.Viz.
+</p>
+<p>
+<strong>Prerequisites:</strong> Flow must be built before calling this method.
+Call Build() first if IsBuilt is false.
+</p>
+<p>
+<strong>Usage:</strong>
+</p>
+<pre><code class="lang-csharp">var flow = DataProcessingFlow.Create(catalog);
+flow.Build();
+
+var dag = flow.ExportDag();
+var json = dag.ToJson();
+File.WriteAllText("dag.json", json);</code></pre>
+<p>
+This method is non-destructive and idempotent - it can be called multiple
+times without affecting the flow state.
+</p>
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if flow has not been built
+
+### <a id="Flowthru_Flows_Flow_Merge_System_Collections_Generic_Dictionary_System_String_Flowthru_Flows_Flow__"></a> Merge\(Dictionary<string, Flow\>\)
+
+Merges multiple flows into a single flow by combining all their steps.
+
+```csharp
+public static Flow Merge(Dictionary<string, Flow> flows)
+```
+
+#### Parameters
+
+`flows` [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [Flow](Flowthru.Flows.Flow.md)\>
+
+Dictionary of flow names to flow instances
+
+#### Returns
+
+ [Flow](Flowthru.Flows.Flow.md)
+
+A new flow containing all steps from all input flows
+
+#### Remarks
+
+<p>
+This method creates a new flow by combining all steps from the input flows.
+Step names are prefixed with their source flow name (e.g., "data_processing.PreprocessCompanies")
+to ensure uniqueness and maintain traceability in logs.
+</p>
+<p>
+The existing DependencyAnalyzer will automatically resolve cross-flow dependencies
+based on catalog entries. The single producer rule is enforced - if multiple flows
+attempt to write to the same catalog entry, Build() will throw an InvalidOperationException.
+</p>
+
+### <a id="Flowthru_Flows_Flow_RunAsync_System_Threading_CancellationToken_"></a> RunAsync\(CancellationToken\)
+
+/// Builds and executes the flow, returning comprehensive execution results.
+
+```csharp
+public Task<FlowResult> RunAsync(CancellationToken cancellationToken)
+```
+
+#### Parameters
+
+`cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+Cancellation token to signal graceful shutdown
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<[FlowResult](Flowthru.Flows.FlowResult.md)\>
+
+FlowResult containing execution status, timing, and flow results
+
+#### Remarks
+
+<p>
+This is the primary high-level API for executing flows. It automatically
+calls Build() if the flow hasn't been built yet, then executes and tracks results.
+</p>
+
+### <a id="Flowthru_Flows_Flow_ValidateExternalInputsAsync_System_Threading_CancellationToken_"></a> ValidateExternalInputsAsync\(CancellationToken\)
+
+Validates all external inputs before flow execution.
+
+```csharp
+public Task<ValidationResult> ValidateExternalInputsAsync(CancellationToken cancellationToken = default)
+```
+
+#### Parameters
+
+`cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+Cancellation token for validation I/O operations
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+ValidationResult containing any errors found
+
+#### Remarks
+
+<p>
+This method inspects catalog entries that are consumed by the flow but not
+produced by any step in the execution set. These are pre-existing external data
+sources (files, databases, APIs) that must exist and be valid before the flow
+can execute.
+</p>
+<p>
+<strong>Slicing Support:</strong> In sliced flows, catalog entries that were
+produced by steps outside the slice are correctly identified as external inputs
+and validated. This prevents runtime failures from missing intermediate data.
+</p>
+<p>
+<strong>Inspection Levels:</strong>
+</p>
+<ul><li><strong>None:</strong> Skip inspection entirely</li><li><strong>Shallow:</strong> Validate file exists, check headers/schema, deserialize sample rows</li><li><strong>Deep:</strong> Validate all rows in the dataset (expensive!)</li></ul>
+<p>
+<strong>Default Behavior:</strong>
+</p>
+<ul><li>If explicitly configured via WithValidation() → use that level</li><li>If entry has PreferredInspectionLevel set → use that level</li><li>Otherwise → Shallow (all storage adapters support inspection)</li></ul>
+<p>
+<strong>Important:</strong> Only external inputs are inspected. Intermediate flow
+outputs produced within the execution set are never inspected, as they don't exist yet.
+</p>
+<p>
+<strong>Usage:</strong>
+</p>
+<pre><code class="lang-csharp">flow.Build();
+var validationResult = await flow.ValidateExternalInputsAsync();
+if (!validationResult.IsValid) {
+  // Handle validation errors before execution
+  validationResult.ThrowIfInvalid();
+}
+await flow.RunAsync();</code></pre>
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if flow has not been built
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.FlowBuilder.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.FlowBuilder.md
new file mode 100644
index 00000000..b41007ee
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.FlowBuilder.md
@@ -0,0 +1,9683 @@
+# <a id="Flowthru_Flows_FlowBuilder"></a> Class FlowBuilder
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Fluent builder for constructing type-safe flows with function-based steps.
+
+```csharp
+public class FlowBuilder
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Function-Based Design (v0.5.0):</strong>
+Steps are pure transformation functions with compile-time type safety.
+Both synchronous and asynchronous functions are supported:
+- Sync: Func&lt;TInput, TOutput&gt;
+- Async: Func&lt;TInput, Task&lt;TOutput&gt;&gt;
+- Multi-input: Func&lt;(TIn1, TIn2, ...), TOutput&gt; or Task&lt;TOutput&gt;
+- Multi-output: Func&lt;TInput, (TOut1, TOut2, ...)&gt; or Task&lt;(TOut1, TOut2, ...)&gt;
+</p>
+<p>
+Use synchronous functions for pure data transformations. Use asynchronous functions
+only when your step performs I/O operations (external APIs, databases, etc.).
+</p>
+<p>
+The compiler infers all types from function signatures and validates catalog entry
+types at flow construction time, catching type mismatches before execution.
+</p>
+<p>
+<strong>Usage Patterns:</strong>
+</p>
+<pre><code class="lang-csharp">var flow = FlowBuilder.CreateFlow(builder =&gt;
+{
+    // Simple synchronous step
+    builder.AddStep(
+        name: "Preprocess",
+        transform: PreprocessStep.Create(),
+        input: catalog.RawData,
+        output: catalog.ProcessedData
+    );
+
+    // Multi-input step: tuple → single output
+    builder.AddStep(
+        name: "TrainModel",
+        transform: TrainModelStep.Create(),
+        input: (catalog.XTrain, catalog.YTrain),
+        output: catalog.Model
+    );
+
+    // Multi-output step: single input → tuple
+    builder.AddStep(
+        name: "SplitData",
+        transform: SplitDataStep.Create(),
+        input: catalog.Data,
+        output: (catalog.XTrain, catalog.XTest, catalog.YTrain, catalog.YTest)
+    );
+
+    // Asynchronous step (only when needed for I/O)
+    builder.AddStep(
+        name: "FetchExternalData",
+        transform: ExternalDataStep.Create(),
+        input: catalog.Config,
+        output: catalog.ExternalData
+    );
+});
+
+flow.Build();
+await flow.ExecuteAsync();</code></pre>
+
+## Methods
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__2_System_String_System_Func___0_System_Threading_Tasks_Task___1___Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__System_String_"></a> AddStep<TInput, TOutput\>\(string, Func<TInput, Task<TOutput\>\>, IItem<TInput\>, IItem<TOutput\>, string\)
+
+Adds a step with single input and single output (asynchronous transformation).
+All types are inferred from the transformation function signature.
+
+```csharp
+public FlowBuilder AddStep<TInput, TOutput>(string label, Func<TInput, Task<TOutput>> transform, IItem<TInput> input, IItem<TOutput> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TInput, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOutput\>\>
+
+Asynchronous transformation function from input to output
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TInput\>
+
+Catalog entry providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOutput\>
+
+Catalog entry to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description for this step
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TInput` 
+
+Input type (inferred from transform)
+
+`TOutput` 
+
+Output type (inferred from transform)
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__2_System_String_System_Func___0_System_Threading_CancellationToken_System_Threading_Tasks_Task___1___Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__System_String_"></a> AddStep<TInput, TOutput\>\(string, Func<TInput, CancellationToken, Task<TOutput\>\>, IItem<TInput\>, IItem<TOutput\>, string\)
+
+Adds a step with single input and single output (asynchronous transformation with cancellation support).
+All types are inferred from the transformation function signature.
+
+```csharp
+public FlowBuilder AddStep<TInput, TOutput>(string label, Func<TInput, CancellationToken, Task<TOutput>> transform, IItem<TInput> input, IItem<TOutput> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-3)<TInput, [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOutput\>\>
+
+Asynchronous transformation function from input to output with cancellation token
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TInput\>
+
+Catalog entry providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOutput\>
+
+Catalog entry to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description for this step
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TInput` 
+
+Input type (inferred from transform)
+
+`TOutput` 
+
+Output type (inferred from transform)
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__2_System_String_System_Func___0___1__Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__System_String_"></a> AddStep<TInput, TOutput\>\(string, Func<TInput, TOutput\>, IItem<TInput\>, IItem<TOutput\>, string\)
+
+Adds a step with single input and single output (synchronous transformation).
+All types are inferred from the transformation function signature.
+
+```csharp
+public FlowBuilder AddStep<TInput, TOutput>(string label, Func<TInput, TOutput> transform, IItem<TInput> input, IItem<TOutput> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TInput, TOutput\>
+
+Synchronous transformation function from input to output
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TInput\>
+
+Catalog entry providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOutput\>
+
+Catalog entry to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description for this step
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TInput` 
+
+Input type (inferred from transform)
+
+`TOutput` 
+
+Output type (inferred from transform)
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__2_System_String_System_Collections_Generic_IReadOnlyList_Flowthru_Data_IItem___0___Flowthru_Data_IItem___1__System_Func_System_Collections_Generic_IReadOnlyList___0____1__System_String_"></a> AddStep<TIn, TOut\>\(string, IReadOnlyList<IItem<TIn\>\>, IItem<TOut\>, Func<IReadOnlyList<TIn\>, TOut\>, string\)
+
+Adds a homogeneous fan-in step: N catalog entries of the same element type collapse
+into a single step whose transform receives all N loaded collections as a typed list.
+
+```csharp
+public FlowBuilder AddStep<TIn, TOut>(string label, IReadOnlyList<IItem<TIn>> inputs, IItem<TOut> output, Func<IReadOnlyList<TIn>, TOut> step, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`inputs` [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[IItem](Flowthru.Data.IItem\-1.md)<TIn\>\>
+
+Variable-length list of same-typed input entries
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut\>
+
+Catalog entry to store the merged result
+
+`step` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<TIn\>, TOut\>
+
+Transform function receiving all N loaded values as a typed read-only list
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional human-readable description
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn` 
+
+Element type of each input catalog entry
+
+`TOut` 
+
+Output type produced by the transform
+
+#### Remarks
+
+Use this when the number of inputs is not known at compile time — for example,
+aggregating per-partition catalogs constructed in a loop. The function receives
+<code>IReadOnlyList&lt;TIn&gt;</code> where each element corresponds to one input entry
+in declaration order. An empty inputs list is allowed but produces an empty list argument.
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__3_System_String_System_Func___0_System_Threading_Tasks_Task_System_ValueTuple___1___2____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_String_"></a> AddStep<TIn1, TOut1, TOut2\>\(string, Func<TIn1, Task<\(TOut1, TOut2\)\>\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 1 input and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2>(string label, Func<TIn1, Task<(TOut1, TOut2)>> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__3_System_String_System_Func___0_System_ValueTuple___1___2___Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_String_"></a> AddStep<TIn1, TOut1, TOut2\>\(string, Func<TIn1, \(TOut1, TOut2\)\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 1 input and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2>(string label, Func<TIn1, (TOut1, TOut2)> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__4_System_String_System_Func___0_System_Threading_Tasks_Task_System_ValueTuple___1___2___3____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3\>\(string, Func<TIn1, Task<\(TOut1, TOut2, TOut3\)\>\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 1 input and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3>(string label, Func<TIn1, Task<(TOut1, TOut2, TOut3)>> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__4_System_String_System_Func___0_System_ValueTuple___1___2___3___Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3\>\(string, Func<TIn1, \(TOut1, TOut2, TOut3\)\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 1 input and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3>(string label, Func<TIn1, (TOut1, TOut2, TOut3)> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__5_System_String_System_Func___0_System_Threading_Tasks_Task_System_ValueTuple___1___2___3___4____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4\>\(string, Func<TIn1, Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 1 input and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4>(string label, Func<TIn1, Task<(TOut1, TOut2, TOut3, TOut4)>> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__5_System_String_System_Func___0_System_ValueTuple___1___2___3___4___Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4\>\(string, Func<TIn1, \(TOut1, TOut2, TOut3, TOut4\)\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 1 input and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4>(string label, Func<TIn1, (TOut1, TOut2, TOut3, TOut4)> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__6_System_String_System_Func___0_System_Threading_Tasks_Task_System_ValueTuple___1___2___3___4___5____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<TIn1, Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 1 input and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<TIn1, Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__6_System_String_System_Func___0_System_ValueTuple___1___2___3___4___5___Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 1 input and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<TIn1, (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__7_System_String_System_Func___0_System_Threading_Tasks_Task_System_ValueTuple___1___2___3___4___5___6____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<TIn1, Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 1 input and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<TIn1, Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__7_System_String_System_Func___0_System_ValueTuple___1___2___3___4___5___6___Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 1 input and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<TIn1, (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__8_System_String_System_Func___0_System_Threading_Tasks_Task_System_ValueTuple___1___2___3___4___5___6___7____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<TIn1, Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 1 input and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<TIn1, Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__8_System_String_System_Func___0_System_ValueTuple___1___2___3___4___5___6___7___Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 1 input and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<TIn1, (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func___0_System_Threading_Tasks_Task_System_ValueTuple___1___2___3___4___5___6___7_System_ValueTuple___8_____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__System_ValueTuple_Flowthru_Data_IItem___8____System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<TIn1, Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 1 input and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<TIn1, Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func___0_System_ValueTuple___1___2___3___4___5___6___7_System_ValueTuple___8____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__System_ValueTuple_Flowthru_Data_IItem___8____System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 1 input and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<TIn1, (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__3_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task___2___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___Flowthru_Data_IItem___2__System_String_"></a> AddStep<TIn1, TIn2, TOut1\>\(string, Func<\(TIn1, TIn2\), Task<TOut1\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), IItem<TOut1\>, string\)
+
+Adds a step with 2 inputs and 1 output (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1>(string label, Func<(TIn1, TIn2), Task<TOut1>> transform, (IItem<TIn1>, IItem<TIn2>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOut1\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__3_System_String_System_Func_System_ValueTuple___0___1____2__System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___Flowthru_Data_IItem___2__System_String_"></a> AddStep<TIn1, TIn2, TOut1\>\(string, Func<\(TIn1, TIn2\), TOut1\>, \(IItem<TIn1\>, IItem<TIn2\>\), IItem<TOut1\>, string\)
+
+Adds a step with 2 inputs and 1 output (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1>(string label, Func<(TIn1, TIn2), TOut1> transform, (IItem<TIn1>, IItem<TIn2>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), TOut1\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__4_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task_System_ValueTuple___2___3____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2\), Task<\(TOut1, TOut2\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 2 inputs and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2>(string label, Func<(TIn1, TIn2), Task<(TOut1, TOut2)>> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__4_System_String_System_Func_System_ValueTuple___0___1__System_ValueTuple___2___3___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2\), \(TOut1, TOut2\)\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 2 inputs and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2>(string label, Func<(TIn1, TIn2), (TOut1, TOut2)> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__5_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task_System_ValueTuple___2___3___4____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2\), Task<\(TOut1, TOut2, TOut3\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 2 inputs and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2), Task<(TOut1, TOut2, TOut3)>> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__5_System_String_System_Func_System_ValueTuple___0___1__System_ValueTuple___2___3___4___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3\)\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 2 inputs and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2), (TOut1, TOut2, TOut3)> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task_System_ValueTuple___2___3___4___5____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2\), Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 2 inputs and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2), Task<(TOut1, TOut2, TOut3, TOut4)>> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1__System_ValueTuple___2___3___4___5___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4\)\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 2 inputs and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2), (TOut1, TOut2, TOut3, TOut4)> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task_System_ValueTuple___2___3___4___5___6____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 2 inputs and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2), Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1__System_ValueTuple___2___3___4___5___6___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 2 inputs and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2), (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task_System_ValueTuple___2___3___4___5___6___7____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 2 inputs and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1__System_ValueTuple___2___3___4___5___6___7___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 2 inputs and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task_System_ValueTuple___2___3___4___5___6___7___8____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 2 inputs and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1__System_ValueTuple___2___3___4___5___6___7___8___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 2 inputs and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task_System_ValueTuple___2___3___4___5___6___7___8_System_ValueTuple___9_____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__System_ValueTuple_Flowthru_Data_IItem___9____System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 2 inputs and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1__System_ValueTuple___2___3___4___5___6___7___8_System_ValueTuple___9____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__System_ValueTuple_Flowthru_Data_IItem___9____System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 2 inputs and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__4_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task___3___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___Flowthru_Data_IItem___3__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<TOut1\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), IItem<TOut1\>, string\)
+
+Adds a step with 3 inputs and 1 output (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1>(string label, Func<(TIn1, TIn2, TIn3), Task<TOut1>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOut1\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__4_System_String_System_Func_System_ValueTuple___0___1___2____3__System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___Flowthru_Data_IItem___3__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3\), TOut1\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), IItem<TOut1\>, string\)
+
+Adds a step with 3 inputs and 1 output (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1>(string label, Func<(TIn1, TIn2, TIn3), TOut1> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), TOut1\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__5_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task_System_ValueTuple___3___4____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<\(TOut1, TOut2\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 3 inputs and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3), Task<(TOut1, TOut2)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__5_System_String_System_Func_System_ValueTuple___0___1___2__System_ValueTuple___3___4___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 3 inputs and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3), (TOut1, TOut2)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task_System_ValueTuple___3___4___5____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<\(TOut1, TOut2, TOut3\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 3 inputs and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3), Task<(TOut1, TOut2, TOut3)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1___2__System_ValueTuple___3___4___5___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 3 inputs and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3), (TOut1, TOut2, TOut3)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task_System_ValueTuple___3___4___5___6____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 3 inputs and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3), Task<(TOut1, TOut2, TOut3, TOut4)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2__System_ValueTuple___3___4___5___6___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 3 inputs and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3), (TOut1, TOut2, TOut3, TOut4)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task_System_ValueTuple___3___4___5___6___7____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 3 inputs and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3), Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2__System_ValueTuple___3___4___5___6___7___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 3 inputs and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3), (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task_System_ValueTuple___3___4___5___6___7___8____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 3 inputs and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2__System_ValueTuple___3___4___5___6___7___8___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 3 inputs and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task_System_ValueTuple___3___4___5___6___7___8___9____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 3 inputs and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2__System_ValueTuple___3___4___5___6___7___8___9___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 3 inputs and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task_System_ValueTuple___3___4___5___6___7___8___9_System_ValueTuple___10_____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__System_ValueTuple_Flowthru_Data_IItem___10____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 3 inputs and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2__System_ValueTuple___3___4___5___6___7___8___9_System_ValueTuple___10____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__System_ValueTuple_Flowthru_Data_IItem___10____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 3 inputs and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__5_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task___4___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___Flowthru_Data_IItem___4__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<TOut1\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), IItem<TOut1\>, string\)
+
+Adds a step with 4 inputs and 1 output (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<TOut1>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOut1\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__5_System_String_System_Func_System_ValueTuple___0___1___2___3____4__System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___Flowthru_Data_IItem___4__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), TOut1\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), IItem<TOut1\>, string\)
+
+Adds a step with 4 inputs and 1 output (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4), TOut1> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), TOut1\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task_System_ValueTuple___4___5____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<\(TOut1, TOut2\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 4 inputs and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<(TOut1, TOut2)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1___2___3__System_ValueTuple___4___5___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 4 inputs and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4), (TOut1, TOut2)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task_System_ValueTuple___4___5___6____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<\(TOut1, TOut2, TOut3\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 4 inputs and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<(TOut1, TOut2, TOut3)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2___3__System_ValueTuple___4___5___6___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 4 inputs and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4), (TOut1, TOut2, TOut3)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task_System_ValueTuple___4___5___6___7____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 4 inputs and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<(TOut1, TOut2, TOut3, TOut4)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3__System_ValueTuple___4___5___6___7___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 4 inputs and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4), (TOut1, TOut2, TOut3, TOut4)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task_System_ValueTuple___4___5___6___7___8____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 4 inputs and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3__System_ValueTuple___4___5___6___7___8___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 4 inputs and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4), (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task_System_ValueTuple___4___5___6___7___8___9____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 4 inputs and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3__System_ValueTuple___4___5___6___7___8___9___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 4 inputs and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task_System_ValueTuple___4___5___6___7___8___9___10____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 4 inputs and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3__System_ValueTuple___4___5___6___7___8___9___10___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 4 inputs and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task_System_ValueTuple___4___5___6___7___8___9___10_System_ValueTuple___11_____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__System_ValueTuple_Flowthru_Data_IItem___11____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 4 inputs and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3__System_ValueTuple___4___5___6___7___8___9___10_System_ValueTuple___11____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__System_ValueTuple_Flowthru_Data_IItem___11____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 4 inputs and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task___5___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___Flowthru_Data_IItem___5__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<TOut1\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), IItem<TOut1\>, string\)
+
+Adds a step with 5 inputs and 1 output (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<TOut1>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOut1\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1___2___3___4____5__System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___Flowthru_Data_IItem___5__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), TOut1\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), IItem<TOut1\>, string\)
+
+Adds a step with 5 inputs and 1 output (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), TOut1> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), TOut1\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task_System_ValueTuple___5___6____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<\(TOut1, TOut2\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 5 inputs and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<(TOut1, TOut2)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_ValueTuple___5___6___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 5 inputs and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), (TOut1, TOut2)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task_System_ValueTuple___5___6___7____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<\(TOut1, TOut2, TOut3\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 5 inputs and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<(TOut1, TOut2, TOut3)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_ValueTuple___5___6___7___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 5 inputs and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), (TOut1, TOut2, TOut3)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task_System_ValueTuple___5___6___7___8____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 5 inputs and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<(TOut1, TOut2, TOut3, TOut4)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_ValueTuple___5___6___7___8___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 5 inputs and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), (TOut1, TOut2, TOut3, TOut4)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task_System_ValueTuple___5___6___7___8___9____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 5 inputs and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_ValueTuple___5___6___7___8___9___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 5 inputs and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task_System_ValueTuple___5___6___7___8___9___10____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 5 inputs and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_ValueTuple___5___6___7___8___9___10___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 5 inputs and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task_System_ValueTuple___5___6___7___8___9___10___11____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 5 inputs and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_ValueTuple___5___6___7___8___9___10___11___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 5 inputs and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task_System_ValueTuple___5___6___7___8___9___10___11_System_ValueTuple___12_____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__System_ValueTuple_Flowthru_Data_IItem___12____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 5 inputs and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_ValueTuple___5___6___7___8___9___10___11_System_ValueTuple___12____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__System_ValueTuple_Flowthru_Data_IItem___12____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 5 inputs and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task___6___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___Flowthru_Data_IItem___6__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<TOut1\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), IItem<TOut1\>, string\)
+
+Adds a step with 6 inputs and 1 output (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<TOut1>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOut1\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5____6__System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___Flowthru_Data_IItem___6__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), TOut1\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), IItem<TOut1\>, string\)
+
+Adds a step with 6 inputs and 1 output (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), TOut1> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), TOut1\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task_System_ValueTuple___6___7____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<\(TOut1, TOut2\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 6 inputs and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<(TOut1, TOut2)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_ValueTuple___6___7___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 6 inputs and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), (TOut1, TOut2)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task_System_ValueTuple___6___7___8____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<\(TOut1, TOut2, TOut3\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 6 inputs and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<(TOut1, TOut2, TOut3)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_ValueTuple___6___7___8___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 6 inputs and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), (TOut1, TOut2, TOut3)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task_System_ValueTuple___6___7___8___9____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 6 inputs and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<(TOut1, TOut2, TOut3, TOut4)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_ValueTuple___6___7___8___9___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 6 inputs and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), (TOut1, TOut2, TOut3, TOut4)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task_System_ValueTuple___6___7___8___9___10____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 6 inputs and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_ValueTuple___6___7___8___9___10___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 6 inputs and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task_System_ValueTuple___6___7___8___9___10___11____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 6 inputs and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_ValueTuple___6___7___8___9___10___11___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 6 inputs and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task_System_ValueTuple___6___7___8___9___10___11___12____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 6 inputs and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_ValueTuple___6___7___8___9___10___11___12___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 6 inputs and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__14_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task_System_ValueTuple___6___7___8___9___10___11___12_System_ValueTuple___13_____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__System_ValueTuple_Flowthru_Data_IItem___13____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 6 inputs and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__14_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_ValueTuple___6___7___8___9___10___11___12_System_ValueTuple___13____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__System_ValueTuple_Flowthru_Data_IItem___13____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 6 inputs and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task___7___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Data_IItem___7__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<TOut1\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), IItem<TOut1\>, string\)
+
+Adds a step with 7 inputs and 1 output (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<TOut1>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOut1\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6____7__System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Data_IItem___7__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), TOut1\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), IItem<TOut1\>, string\)
+
+Adds a step with 7 inputs and 1 output (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), TOut1> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), TOut1\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task_System_ValueTuple___7___8____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<\(TOut1, TOut2\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 7 inputs and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<(TOut1, TOut2)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_ValueTuple___7___8___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 7 inputs and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), (TOut1, TOut2)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task_System_ValueTuple___7___8___9____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<\(TOut1, TOut2, TOut3\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 7 inputs and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<(TOut1, TOut2, TOut3)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_ValueTuple___7___8___9___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 7 inputs and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), (TOut1, TOut2, TOut3)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task_System_ValueTuple___7___8___9___10____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 7 inputs and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<(TOut1, TOut2, TOut3, TOut4)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_ValueTuple___7___8___9___10___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 7 inputs and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), (TOut1, TOut2, TOut3, TOut4)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task_System_ValueTuple___7___8___9___10___11____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 7 inputs and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_ValueTuple___7___8___9___10___11___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 7 inputs and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task_System_ValueTuple___7___8___9___10___11___12____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 7 inputs and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_ValueTuple___7___8___9___10___11___12___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 7 inputs and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__14_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task_System_ValueTuple___7___8___9___10___11___12___13____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 7 inputs and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__14_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_ValueTuple___7___8___9___10___11___12___13___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 7 inputs and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__15_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task_System_ValueTuple___7___8___9___10___11___12___13_System_ValueTuple___14_____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__System_ValueTuple_Flowthru_Data_IItem___14____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 7 inputs and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__15_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_ValueTuple___7___8___9___10___11___12___13_System_ValueTuple___14____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__System_ValueTuple_Flowthru_Data_IItem___14____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 7 inputs and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task___8___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____Flowthru_Data_IItem___8__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<TOut1\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), IItem<TOut1\>, string\)
+
+Adds a step with 8 inputs and 1 output (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<TOut1>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOut1\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7_____8__System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____Flowthru_Data_IItem___8__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), TOut1\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), IItem<TOut1\>, string\)
+
+Adds a step with 8 inputs and 1 output (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), TOut1> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), TOut1\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task_System_ValueTuple___8___9____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<\(TOut1, TOut2\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 8 inputs and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<(TOut1, TOut2)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_ValueTuple___8___9___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a step with 8 inputs and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), (TOut1, TOut2)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task_System_ValueTuple___8___9___10____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<\(TOut1, TOut2, TOut3\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 8 inputs and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<(TOut1, TOut2, TOut3)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_ValueTuple___8___9___10___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a step with 8 inputs and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), (TOut1, TOut2, TOut3)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task_System_ValueTuple___8___9___10___11____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 8 inputs and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<(TOut1, TOut2, TOut3, TOut4)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_ValueTuple___8___9___10___11___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a step with 8 inputs and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), (TOut1, TOut2, TOut3, TOut4)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task_System_ValueTuple___8___9___10___11___12____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 8 inputs and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_ValueTuple___8___9___10___11___12___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a step with 8 inputs and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__14_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task_System_ValueTuple___8___9___10___11___12___13____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 8 inputs and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__14_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_ValueTuple___8___9___10___11___12___13___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a step with 8 inputs and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__15_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task_System_ValueTuple___8___9___10___11___12___13___14____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__Flowthru_Data_IItem___14___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 8 inputs and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__15_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_ValueTuple___8___9___10___11___12___13___14___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__Flowthru_Data_IItem___14___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a step with 8 inputs and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__16_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task_System_ValueTuple___8___9___10___11___12___13___14_System_ValueTuple___15_____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__Flowthru_Data_IItem___14__System_ValueTuple_Flowthru_Data_IItem___15____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 8 inputs and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_AddStep__16_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_ValueTuple___8___9___10___11___12___13___14_System_ValueTuple___15____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__Flowthru_Data_IItem___14__System_ValueTuple_Flowthru_Data_IItem___15____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a step with 8 inputs and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the step's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Flows_FlowBuilder_CreateFlow_System_Action_Flowthru_Flows_FlowBuilder__"></a> CreateFlow\(Action<FlowBuilder\>\)
+
+Creates and configures a new flow using the builder pattern.
+
+```csharp
+public static Flow CreateFlow(Action<FlowBuilder> configure)
+```
+
+#### Parameters
+
+`configure` [Action](https://learn.microsoft.com/dotnet/api/system.action\-1)<[FlowBuilder](Flowthru.Flows.FlowBuilder.md)\>
+
+Action to configure the flow by adding steps
+
+#### Returns
+
+ [Flow](Flowthru.Flows.Flow.md)
+
+Configured but not yet built flow
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.FlowResult.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.FlowResult.md
new file mode 100644
index 00000000..323eac40
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.FlowResult.md
@@ -0,0 +1,214 @@
+# <a id="Flowthru_Flows_FlowResult"></a> Class FlowResult
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Represents the result of a flow execution.
+
+```csharp
+public class FlowResult
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowResult](Flowthru.Flows.FlowResult.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+This class provides comprehensive execution information including success status,
+timing, individual step results, and error details.
+</p>
+<p>
+<strong>Usage Pattern:</strong>
+</p>
+<pre><code class="lang-csharp">var result = await flow.RunAsync();
+
+if (result.Success)
+{
+    Console.WriteLine($"Flow completed in {result.ExecutionTime.TotalSeconds:F2}s");
+    foreach (var stepResult in result.StepResults.Values)
+    {
+        Console.WriteLine($"  {stepResult.StepName}: {stepResult.ExecutionTime.TotalSeconds:F2}s");
+    }
+}
+else
+{
+    Console.WriteLine($"Flow failed: {result.Exception?.Message}");
+}</code></pre>
+
+## Properties
+
+### <a id="Flowthru_Flows_FlowResult_Exception"></a> Exception
+
+Exception that caused flow failure, if any.
+
+```csharp
+public Exception? Exception { get; init; }
+```
+
+#### Property Value
+
+ [Exception](https://learn.microsoft.com/dotnet/api/system.exception)?
+
+#### Remarks
+
+Null if Success is true. Contains the first exception that caused
+flow execution to halt if Success is false.
+
+### <a id="Flowthru_Flows_FlowResult_ExecutionTime"></a> ExecutionTime
+
+Total execution time for the entire flow.
+
+```csharp
+public TimeSpan ExecutionTime { get; init; }
+```
+
+#### Property Value
+
+ [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
+
+### <a id="Flowthru_Flows_FlowResult_FlowName"></a> FlowName
+
+The name of the flow that was executed.
+
+```csharp
+public string? FlowName { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Flows_FlowResult_IsDryRun"></a> IsDryRun
+
+Indicates whether this was a dry run (pre-flight checks only).
+
+```csharp
+public bool IsDryRun { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Flows_FlowResult_StepResults"></a> StepResults
+
+Results for individual steps, keyed by step name.
+
+```csharp
+public Dictionary<string, StepResult> StepResults { get; init; }
+```
+
+#### Property Value
+
+ [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [StepResult](Flowthru.Flows.StepResult.md)\>
+
+#### Remarks
+
+Dictionary keys are the step names as specified in the flow definition.
+Values contain execution details for each step.
+
+### <a id="Flowthru_Flows_FlowResult_Success"></a> Success
+
+Indicates whether the flow executed successfully.
+
+```csharp
+public bool Success { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+## Methods
+
+### <a id="Flowthru_Flows_FlowResult_CreateDryRunSuccess_System_TimeSpan_System_Int32_System_Int32_System_Int32_System_String_"></a> CreateDryRunSuccess\(TimeSpan, int, int, int, string?\)
+
+Creates a successful dry run result.
+
+```csharp
+public static FlowResult CreateDryRunSuccess(TimeSpan preFlightDuration, int stepCount, int layerCount, int validatedInputCount, string? flowName = null)
+```
+
+#### Parameters
+
+`preFlightDuration` [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
+
+Time spent on pre-flight checks
+
+`stepCount` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Total number of steps in the flow
+
+`layerCount` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of execution layers
+
+`validatedInputCount` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of external inputs validated
+
+`flowName` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+Name of the flow
+
+#### Returns
+
+ [FlowResult](Flowthru.Flows.FlowResult.md)
+
+A successful dry run result
+
+### <a id="Flowthru_Flows_FlowResult_CreateFailure_System_TimeSpan_System_Exception_System_Collections_Generic_Dictionary_System_String_Flowthru_Flows_StepResult__System_String_"></a> CreateFailure\(TimeSpan, Exception, Dictionary<string, StepResult\>?, string?\)
+
+Creates a failed flow result.
+
+```csharp
+public static FlowResult CreateFailure(TimeSpan executionTime, Exception exception, Dictionary<string, StepResult>? stepResults = null, string? flowName = null)
+```
+
+#### Parameters
+
+`executionTime` [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
+
+`exception` [Exception](https://learn.microsoft.com/dotnet/api/system.exception)
+
+`stepResults` [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [StepResult](Flowthru.Flows.StepResult.md)\>?
+
+`flowName` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Returns
+
+ [FlowResult](Flowthru.Flows.FlowResult.md)
+
+### <a id="Flowthru_Flows_FlowResult_CreateSuccess_System_TimeSpan_System_Collections_Generic_Dictionary_System_String_Flowthru_Flows_StepResult__System_String_"></a> CreateSuccess\(TimeSpan, Dictionary<string, StepResult\>, string?\)
+
+Creates a successful flow result.
+
+```csharp
+public static FlowResult CreateSuccess(TimeSpan executionTime, Dictionary<string, StepResult> stepResults, string? flowName = null)
+```
+
+#### Parameters
+
+`executionTime` [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
+
+`stepResults` [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [StepResult](Flowthru.Flows.StepResult.md)\>
+
+`flowName` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Returns
+
+ [FlowResult](Flowthru.Flows.FlowResult.md)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.FlowSliceStrategy.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.FlowSliceStrategy.md
new file mode 100644
index 00000000..b6e05cfb
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.FlowSliceStrategy.md
@@ -0,0 +1,183 @@
+# <a id="Flowthru_Flows_FlowSliceStrategy"></a> Class FlowSliceStrategy
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Defines a strategy for slicing a flow to execute a subset of nodes.
+
+```csharp
+public sealed class FlowSliceStrategy
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowSliceStrategy](Flowthru.Flows.FlowSliceStrategy.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+flow slicing allows executing only specific portions of a DAG while maintaining
+execution validity. All slicing operations preserve the runnability guarantee:
+the resulting sub-DAG must be executable without missing dependencies.
+</p>
+<p>
+<strong>Slicing Strategies:</strong>
+</p>
+<ul><li><strong>flows:</strong> Filter to nodes from specific named flows (in merged DAGs)</li><li><strong>FromNodes:</strong> Include specified nodes and all downstream dependents</li><li><strong>ToNodes:</strong> Include specified nodes and all upstream dependencies (run "up to" these nodes)</li><li><strong>FromData:</strong> Include nodes consuming specified catalog entries and all downstream dependents</li><li><strong>ToData:</strong> Include nodes producing specified catalog entries and all upstream dependencies</li><li><strong>OnlyNodes:</strong> Explicit allowlist of nodes plus minimal required dependencies</li></ul>
+<p>
+<strong>Composition:</strong> Multiple strategies compose via intersection (additive filtering).
+For example, <code>--from-nodes A --to-data B</code> produces nodes in the downstream dependency
+tree of A that are also required to produce data B.
+</p>
+<p>
+<strong>Runnability Guarantee:</strong> Slicing operations are additive only. Subtractive
+operations (<code>--from-nodes A --except B</code>) would break the runnability guarantee and
+are not supported.
+</p>
+
+## Properties
+
+### <a id="Flowthru_Flows_FlowSliceStrategy_Flows"></a> Flows
+
+Filter to nodes from these named flows (applies to merged flows).
+
+```csharp
+public IReadOnlySet<string>? Flows { get; init; }
+```
+
+#### Property Value
+
+ [IReadOnlySet](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlyset\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>?
+
+#### Remarks
+
+In merged flows, nodes are prefixed with their flow name (e.g., "DataScience.TrainModel").
+This filter includes only nodes from the specified flows.
+flow names are case-insensitive.
+
+### <a id="Flowthru_Flows_FlowSliceStrategy_FromData"></a> FromData
+
+Start from nodes that consume these catalog entry labels, including all downstream dependents.
+
+```csharp
+public IReadOnlySet<string>? FromData { get; init; }
+```
+
+#### Property Value
+
+ [IReadOnlySet](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlyset\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>?
+
+#### Remarks
+
+Finds all nodes that read the specified catalog entries, then expands downstream.
+Useful for impact analysis - "what breaks if I change this data?"
+
+TODO: Remove this, as it is now sufficient to reference both steps and data entries as nodes.
+
+### <a id="Flowthru_Flows_FlowSliceStrategy_FromNodes"></a> FromNodes
+
+Start from these nodes, including all downstream dependents.
+
+```csharp
+public IReadOnlySet<string>? FromNodes { get; init; }
+```
+
+#### Property Value
+
+ [IReadOnlySet](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlyset\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>?
+
+#### Remarks
+
+Expands to include all nodes that depend on these nodes (transitively).
+Useful for impact analysis - "what breaks if I change this node?"
+
+### <a id="Flowthru_Flows_FlowSliceStrategy_IsSliced"></a> IsSliced
+
+Whether any slicing is configured.
+
+```csharp
+public bool IsSliced { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Flows_FlowSliceStrategy_OnlyNodes"></a> OnlyNodes
+
+Explicit allowlist of node names (dependencies auto-included).
+
+```csharp
+public IReadOnlySet<string>? OnlyNodes { get; init; }
+```
+
+#### Property Value
+
+ [IReadOnlySet](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlyset\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>?
+
+#### Remarks
+
+Specifies exactly which nodes to execute, then automatically includes any
+required dependencies to maintain DAG validity.
+
+### <a id="Flowthru_Flows_FlowSliceStrategy_ToData"></a> ToData
+
+End at nodes that produce these catalog entry labels, including all upstream dependencies.
+
+```csharp
+public IReadOnlySet<string>? ToData { get; init; }
+```
+
+#### Property Value
+
+ [IReadOnlySet](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlyset\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>?
+
+#### Remarks
+
+Finds the nodes that write the specified catalog entries, then expands upstream.
+Useful for targeted execution - "run everything needed to produce this data".
+
+TODO: Remove this, as it is now sufficient to reference both steps and data entries as nodes.
+
+### <a id="Flowthru_Flows_FlowSliceStrategy_ToNodes"></a> ToNodes
+
+End at these nodes, including all upstream dependencies needed to produce them.
+
+```csharp
+public IReadOnlySet<string>? ToNodes { get; init; }
+```
+
+#### Property Value
+
+ [IReadOnlySet](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlyset\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>?
+
+#### Remarks
+
+Expands to include all transitive dependencies needed to run these nodes.
+Equivalent to "run everything up to and including these nodes".
+Useful for testing specific outputs without running the entire flow.
+
+## Methods
+
+### <a id="Flowthru_Flows_FlowSliceStrategy_All"></a> All\(\)
+
+No filtering - execute entire flow.
+
+```csharp
+public static FlowSliceStrategy All()
+```
+
+#### Returns
+
+ [FlowSliceStrategy](Flowthru.Flows.FlowSliceStrategy.md)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.FlowStep.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.FlowStep.md
new file mode 100644
index 00000000..4af126b8
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.FlowStep.md
@@ -0,0 +1,219 @@
+# <a id="Flowthru_Flows_FlowStep"></a> Class FlowStep
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Represents a step within a flow, wrapping the transformation function with metadata
+about its inputs, outputs, and dependencies.
+
+```csharp
+public class FlowStep
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowStep](Flowthru.Flows.FlowStep.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+FlowStep serves as the internal representation of a step during flow
+construction and execution. It tracks:
+- The transformation function (Func&lt;TInput, Task&lt;TOutput&gt;&gt;)
+- Input catalog entries (what data it reads)
+- Output catalog entries (what data it writes)
+- Dependencies (other steps that must run first)
+</p>
+<p>
+<strong>Single Producer Rule:</strong> Each catalog entry can be written by at most
+one step in a flow. This constraint ensures deterministic dependency resolution
+and enables simple DAG construction via topological sort.
+</p>
+<p>
+Made public to enable validation hooks to inspect step properties.
+This is necessary for extensions (e.g., Python) to validate their own step types.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Flows_FlowStep__ctor_System_String_System_String_System_Delegate_System_Collections_Generic_IReadOnlyList_Flowthru_Data_IItem__System_Collections_Generic_IReadOnlyList_Flowthru_Data_IItem__"></a> FlowStep\(string, string?, Delegate, IReadOnlyList<IItem\>, IReadOnlyList<IItem\>\)
+
+Creates a new flow step with a transformation function.
+
+```csharp
+public FlowStep(string label, string? description, Delegate step, IReadOnlyList<IItem> inputs, IReadOnlyList<IItem> outputs)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+Optional description of this step
+
+`step` [Delegate](https://learn.microsoft.com/dotnet/api/system.delegate)
+
+The transformation function (Func&lt;TInput, Task&lt;TOutput&gt;&gt;)
+
+`inputs` [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[IItem](Flowthru.Data.IItem.md)\>
+
+Catalog entries this step reads
+
+`outputs` [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[IItem](Flowthru.Data.IItem.md)\>
+
+Catalog entries this step writes
+
+## Properties
+
+### <a id="Flowthru_Flows_FlowStep_Dependencies"></a> Dependencies
+
+Other flow steps that must execute before this step.
+Populated during dependency analysis by checking which steps produce our inputs.
+
+```csharp
+public List<FlowStep> Dependencies { get; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[FlowStep](Flowthru.Flows.FlowStep.md)\>
+
+#### Remarks
+
+This forms the edges of the execution DAG:
+- If step A produces output X, and step B consumes input X, then B depends on A.
+- Topological sort uses these dependencies to determine execution order.
+
+### <a id="Flowthru_Flows_FlowStep_Description"></a> Description
+
+String description of the step's purpose.
+
+```csharp
+public string Description { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Flows_FlowStep_Inputs"></a> Inputs
+
+Catalog entries that this step reads as input.
+These may be produced by other steps (dependencies) or be external prerequisites.
+
+```csharp
+public IReadOnlyList<IItem> Inputs { get; }
+```
+
+#### Property Value
+
+ [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[IItem](Flowthru.Data.IItem.md)\>
+
+### <a id="Flowthru_Flows_FlowStep_Label"></a> Label
+
+Unique identifier for this step within the flow.
+Typically the step type name or user-provided name.
+
+```csharp
+public string Label { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Flows_FlowStep_Layer"></a> Layer
+
+Execution layer determined by topological sort.
+Steps in layer 0 have no dependencies. Steps in layer N depend on steps in layers 0..N-1.
+
+```csharp
+public int Layer { get; set; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+### <a id="Flowthru_Flows_FlowStep_Outputs"></a> Outputs
+
+Catalog entries that this step writes as output.
+Per the single producer rule, each entry here must be unique across all steps.
+
+```csharp
+public IReadOnlyList<IItem> Outputs { get; }
+```
+
+#### Property Value
+
+ [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[IItem](Flowthru.Data.IItem.md)\>
+
+### <a id="Flowthru_Flows_FlowStep_TransformFunction"></a> TransformFunction
+
+The transformation function that performs the step's work.
+Type-erased to Delegate since we need to store different function signatures together.
+
+```csharp
+public Delegate TransformFunction { get; }
+```
+
+#### Property Value
+
+ [Delegate](https://learn.microsoft.com/dotnet/api/system.delegate)
+
+#### Remarks
+
+<p>
+At execution time, this delegate will be invoked via DynamicInvoke with the
+appropriate input parameter(s). The function signature can be either synchronous
+or asynchronous:
+- Sync single: Func&lt;TInput, TOutput&gt;
+- Async single: Func&lt;TInput, Task&lt;TOutput&gt;&gt;
+- Sync multi-input: Func&lt;(TIn1, TIn2, ...), TOutput&gt;
+- Async multi-input: Func&lt;(TIn1, TIn2, ...), Task&lt;TOutput&gt;&gt;
+- Sync multi-output: Func&lt;TInput, (TOut1, TOut2, ...)&gt;
+- Async multi-output: Func&lt;TInput, Task&lt;(TOut1, TOut2, ...)&gt;&gt;
+</p>
+<p>
+<strong>Optional Cancellation Support:</strong> Steps can opt-in to cancellation awareness
+by accepting a CancellationToken as the last parameter:
+- Func&lt;TInput, CancellationToken, Task&lt;TOutput&gt;&gt;
+- Func&lt;(TIn1, TIn2), CancellationToken, Task&lt;TOutput&gt;&gt;
+</p>
+<p>
+When a Step accepts a CancellationToken, the flow will pass the runtime token during
+execution, allowing the step to cancel long-running operations cooperatively. Steps that
+do not accept a CancellationToken will only be cancelled between step executions.
+</p>
+<p>
+The execution engine detects whether the result is a Task and awaits it if needed.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Flows_FlowStep_ToString"></a> ToString\(\)
+
+Returns a string representation for debugging.
+
+```csharp
+public override string ToString()
+```
+
+#### Returns
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.StepResult.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.StepResult.md
new file mode 100644
index 00000000..b5fbab03
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.StepResult.md
@@ -0,0 +1,161 @@
+# <a id="Flowthru_Flows_StepResult"></a> Class StepResult
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Represents the execution result of a single flow step.
+
+```csharp
+public class StepResult
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[StepResult](Flowthru.Flows.StepResult.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Properties
+
+### <a id="Flowthru_Flows_StepResult_Exception"></a> Exception
+
+Exception that occurred during step execution, if any.
+
+```csharp
+public Exception? Exception { get; init; }
+```
+
+#### Property Value
+
+ [Exception](https://learn.microsoft.com/dotnet/api/system.exception)?
+
+#### Remarks
+
+Null if Success is true. Contains the exception that caused
+the step to fail if Success is false.
+
+### <a id="Flowthru_Flows_StepResult_ExecutionTime"></a> ExecutionTime
+
+Execution time for this specific step.
+
+```csharp
+public TimeSpan ExecutionTime { get; init; }
+```
+
+#### Property Value
+
+ [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
+
+### <a id="Flowthru_Flows_StepResult_InputCount"></a> InputCount
+
+Number of input items processed by this step.
+
+```csharp
+public int InputCount { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Remarks
+
+For multi-input steps, this represents the total count across
+all input catalog entries.
+
+### <a id="Flowthru_Flows_StepResult_OutputCount"></a> OutputCount
+
+Number of output items produced by this step.
+
+```csharp
+public int OutputCount { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Remarks
+
+For multi-output steps, this represents the total count across
+all output catalog entries.
+
+### <a id="Flowthru_Flows_StepResult_StepName"></a> StepName
+
+The name of the step that was executed.
+
+```csharp
+public required string StepName { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Flows_StepResult_Success"></a> Success
+
+Indicates whether the step executed successfully.
+
+```csharp
+public bool Success { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+## Methods
+
+### <a id="Flowthru_Flows_StepResult_CreateFailure_System_String_System_TimeSpan_System_Exception_System_Int32_"></a> CreateFailure\(string, TimeSpan, Exception, int\)
+
+Creates a failed step result.
+
+```csharp
+public static StepResult CreateFailure(string stepName, TimeSpan executionTime, Exception exception, int inputCount = 0)
+```
+
+#### Parameters
+
+`stepName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+`executionTime` [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
+
+`exception` [Exception](https://learn.microsoft.com/dotnet/api/system.exception)
+
+`inputCount` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Returns
+
+ [StepResult](Flowthru.Flows.StepResult.md)
+
+### <a id="Flowthru_Flows_StepResult_CreateSuccess_System_String_System_TimeSpan_System_Int32_System_Int32_"></a> CreateSuccess\(string, TimeSpan, int, int\)
+
+Creates a successful step result.
+
+```csharp
+public static StepResult CreateSuccess(string stepName, TimeSpan executionTime, int inputCount, int outputCount)
+```
+
+#### Parameters
+
+`stepName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+`executionTime` [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
+
+`inputCount` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+`outputCount` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Returns
+
+ [StepResult](Flowthru.Flows.StepResult.md)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.Validation.IFlowValidationHook.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.Validation.IFlowValidationHook.md
new file mode 100644
index 00000000..82f1b933
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.Validation.IFlowValidationHook.md
@@ -0,0 +1,86 @@
+# <a id="Flowthru_Flows_Validation_IFlowValidationHook"></a> Interface IFlowValidationHook
+
+Namespace: [Flowthru.Flows.Validation](Flowthru.Flows.Validation.md)  
+Assembly: Flowthru.Core.dll  
+
+Validation hook that runs during flow pre-flight checks.
+
+```csharp
+public interface IFlowValidationHook
+```
+
+## Remarks
+
+<p>
+Validation hooks provide an extensibility point for extensions to contribute
+their own validation logic during the pre-flight phase. Hooks are invoked after
+DAG analysis but before external input inspection, allowing extensions to
+validate their own step types.
+</p>
+<p>
+<strong>Example use cases:</strong>
+<ul><li>Python extension validates @step decorators match C# types</li><li>Custom extensions validate step-specific configuration</li><li>Third-party plugins validate external dependencies</li></ul>
+</p>
+<p>
+<strong>Hook execution order:</strong>
+</p>
+<ol><li>Flow.Build() - DAG construction and layer assignment</li><li>ValidationHooks.ValidateAsync() - Extension-specific validation</li><li>Flow.ValidateExternalInputsAsync() - External input inspection</li></ol>
+<p>
+<strong>Error handling:</strong>
+Hooks should return ValidationResult with errors, never throw exceptions.
+Multiple hooks may run, and all errors are aggregated into a single result.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Flows_Validation_IFlowValidationHook_ValidateAsync_Flowthru_Flows_Flow_System_Threading_CancellationToken_"></a> ValidateAsync\(Flow, CancellationToken\)
+
+Validates flow steps during pre-flight checks.
+
+```csharp
+Task<ValidationResult> ValidateAsync(Flow flow, CancellationToken cancellationToken)
+```
+
+#### Parameters
+
+`flow` [Flow](Flowthru.Flows.Flow.md)
+
+The flow being validated
+
+`cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+Cancellation token for async operations
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Validation result containing any errors found
+
+#### Remarks
+
+<p>
+Implementations should:
+<ul><li>Never throw exceptions (return errors in ValidationResult)</li><li>Be idempotent (safe to call multiple times)</li><li>Be reasonably fast (executed during pre-flight, blocks flow start)</li><li>Only validate steps they understand (ignore other step types)</li></ul>
+</p>
+<p>
+<strong>Example implementation (Python extension):</strong>
+</p>
+<pre><code class="lang-csharp">public async Task&lt;ValidationResult&gt; ValidateAsync(
+  Flow flow,
+  CancellationToken cancellationToken)
+{
+  var result = ValidationResult.Success();
+
+  foreach (var step in flow.Steps)
+  {
+    if (IsPythonStep(step))
+    {
+      var stepResult = await ValidatePythonStep(step, cancellationToken);
+      result.Merge(stepResult);
+    }
+  }
+
+  return result;
+}</code></pre>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.Validation.ValidationOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.Validation.ValidationOptions.md
new file mode 100644
index 00000000..4bd73c73
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.Validation.ValidationOptions.md
@@ -0,0 +1,106 @@
+# <a id="Flowthru_Flows_Validation_ValidationOptions"></a> Class ValidationOptions
+
+Namespace: [Flowthru.Flows.Validation](Flowthru.Flows.Validation.md)  
+Assembly: Flowthru.Core.dll  
+
+Configuration for pipeline validation behavior.
+
+```csharp
+public class ValidationOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ValidationOptions](Flowthru.Flows.Validation.ValidationOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+ValidationOptions provides pipeline-level overrides for validation configuration.
+The primary mechanism for validation configuration is catalog-level via the
+<xref href="Flowthru.Data.IItem.PreferredInspectionLevel" data-throw-if-not-resolved="false"></xref> property and the fluent
+<code>.WithInspectionLevel()</code> API.
+</p>
+<p>
+<strong>Default Behavior (if not configured):</strong>
+</p>
+<ul><li>Catalog entry has PreferredInspectionLevel set → use that level</li><li>Layer 0 inputs → Shallow inspection (all storage adapters support inspection)</li><li>All intermediate outputs (Layer 1+) → None (never inspected)</li></ul>
+<p>
+<strong>Catalog-Level Configuration (Recommended):</strong>
+</p>
+<pre><code class="lang-csharp">public ICatalogDataset&lt;Company&gt; Companies =&gt;
+  GetOrCreateDataset(() =&gt; new CsvCatalogDataset&lt;Company&gt;("companies", "data/companies.csv")
+    .WithInspectionLevel(InspectionLevel.Deep));</code></pre>
+<p>
+<strong>Pipeline-Level Override (Advanced):</strong>
+</p>
+<pre><code class="lang-csharp">builder
+  .RegisterPipeline&lt;MyCatalog&gt;("data_processing", MyPipeline.Create)
+  .WithValidation(validation =&gt; {
+    // Override catalog-level setting for this specific pipeline
+    validation.Inspect(catalog.Companies, InspectionLevel.Shallow); // Temporarily use shallow
+  });</code></pre>
+<p>
+<strong>Design Rationale:</strong>
+</p>
+<p>
+Validation configuration is primarily a property of the data source itself, not the pipeline
+consuming it. Critical external datasets should always be deeply validated, regardless of
+which pipeline uses them. Pipeline-level overrides exist for rare cases where different
+validation is needed temporarily (e.g., performance testing, debugging).
+</p>
+
+## Methods
+
+### <a id="Flowthru_Flows_Validation_ValidationOptions_Default"></a> Default\(\)
+
+Creates a new ValidationOptions instance with default settings.
+
+```csharp
+public static ValidationOptions Default()
+```
+
+#### Returns
+
+ [ValidationOptions](Flowthru.Flows.Validation.ValidationOptions.md)
+
+### <a id="Flowthru_Flows_Validation_ValidationOptions_Inspect_Flowthru_Data_IItem_Flowthru_Data_Validation_InspectionLevel_"></a> Inspect\(IItem, InspectionLevel\)
+
+Specifies the inspection level for a specific catalog entry.
+
+```csharp
+public ValidationOptions Inspect(IItem catalogEntry, InspectionLevel level)
+```
+
+#### Parameters
+
+`catalogEntry` [IItem](Flowthru.Data.IItem.md)
+
+The catalog entry to configure
+
+`level` [InspectionLevel](Flowthru.Data.Validation.InspectionLevel.md)
+
+The inspection level to use for this entry
+
+#### Returns
+
+ [ValidationOptions](Flowthru.Flows.Validation.ValidationOptions.md)
+
+This ValidationOptions instance for fluent chaining
+
+#### Remarks
+
+This configuration only applies to Layer 0 inputs (external data).
+Intermediate outputs are never inspected regardless of this setting.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.Validation.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.Validation.md
new file mode 100644
index 00000000..ccd36dc4
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.Validation.md
@@ -0,0 +1,14 @@
+# <a id="Flowthru_Flows_Validation"></a> Namespace Flowthru.Flows.Validation
+
+### Classes
+
+ [ValidationOptions](Flowthru.Flows.Validation.ValidationOptions.md)
+
+Configuration for pipeline validation behavior.
+
+### Interfaces
+
+ [IFlowValidationHook](Flowthru.Flows.Validation.IFlowValidationHook.md)
+
+Validation hook that runs during flow pre-flight checks.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.ValidationDepth.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.ValidationDepth.md
new file mode 100644
index 00000000..f327331f
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.ValidationDepth.md
@@ -0,0 +1,27 @@
+# <a id="Flowthru_Flows_ValidationDepth"></a> Enum ValidationDepth
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Controls how deeply a dry run validates the pipeline before stopping.
+
+```csharp
+public enum ValidationDepth
+```
+
+## Fields
+
+`Full = 1` 
+
+Structure validation plus external data presence checks (default dry-run behaviour).
+
+
+
+`StructureOnly = 0` 
+
+Validates graph structure only: no cycles, all node type contracts satisfied,
+all catalog entry dependencies wired, and all validation hooks run.
+No data source access.
+
+
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.md
new file mode 100644
index 00000000..64e76941
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Flows.md
@@ -0,0 +1,50 @@
+# <a id="Flowthru_Flows"></a> Namespace Flowthru.Flows
+
+### Namespaces
+
+ [Flowthru.Flows.Validation](Flowthru.Flows.Validation.md)
+
+### Classes
+
+ [ExecutionOptions](Flowthru.Flows.ExecutionOptions.md)
+
+Configuration options for pipeline execution.
+
+ [Flow](Flowthru.Flows.Flow.md)
+
+Represents a complete data flow with steps, dependencies, and execution order.
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+Fluent builder for constructing type-safe flows with function-based steps.
+
+ [FlowResult](Flowthru.Flows.FlowResult.md)
+
+Represents the result of a flow execution.
+
+ [FlowSliceStrategy](Flowthru.Flows.FlowSliceStrategy.md)
+
+Defines a strategy for slicing a flow to execute a subset of nodes.
+
+ [FlowStep](Flowthru.Flows.FlowStep.md)
+
+Represents a step within a flow, wrapping the transformation function with metadata
+about its inputs, outputs, and dependencies.
+
+ [StepResult](Flowthru.Flows.StepResult.md)
+
+Represents the execution result of a single flow step.
+
+### Structs
+
+ [DryRunOption](Flowthru.Flows.DryRunOption.md)
+
+Represents a dry-run configuration. Can be assigned from a <xref href="System.Boolean" data-throw-if-not-resolved="false"></xref>
+or a <xref href="Flowthru.Flows.ValidationDepth" data-throw-if-not-resolved="false"></xref> value.
+
+### Enums
+
+ [ValidationDepth](Flowthru.Flows.ValidationDepth.md)
+
+Controls how deeply a dry run validates the pipeline before stopping.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.FlowthruMetadataBuilder.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.FlowthruMetadataBuilder.md
new file mode 100644
index 00000000..7eca12e9
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.FlowthruMetadataBuilder.md
@@ -0,0 +1,123 @@
+# <a id="Flowthru_Meta_FlowthruMetadataBuilder"></a> Class FlowthruMetadataBuilder
+
+Namespace: [Flowthru.Meta](Flowthru.Meta.md)  
+Assembly: Flowthru.Core.dll  
+
+Fluent builder for configuring metadata providers and export settings.
+
+```csharp
+public class FlowthruMetadataBuilder
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowthruMetadataBuilder](Flowthru.Meta.FlowthruMetadataBuilder.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+Use this builder to register metadata providers with custom configuration.
+Providers are executed in registration order during metadata export.
+</p>
+<p>
+<strong>Example usage:</strong>
+</p>
+<pre><code class="lang-csharp">builder.ConfigureMetadata(meta =&gt; meta
+    .AddProvider&lt;JsonMetadataProvider, JsonMetadataProviderBuilder&gt;(json =&gt; json
+        .WithOutputDirectory("metadata")
+        .WithTimestamp("yyyy-MM-dd_HH-mm-ss")
+        .UseCompactFormat())
+    .AddProvider&lt;MermaidMetadataProvider, MermaidMetadataProviderBuilder&gt;(mermaid =&gt; mermaid
+        .WithOutputDirectory("metadata")
+        .WithDirection(MermaidMetadataProvider.MermaidFlowchartDirection.LeftToRight))
+);</code></pre>
+
+## Methods
+
+### <a id="Flowthru_Meta_FlowthruMetadataBuilder_AddProvider__2_System_Action___1__"></a> AddProvider<TProvider, TBuilder\>\(Action<TBuilder\>?\)
+
+Adds a metadata provider with optional configuration.
+
+```csharp
+public FlowthruMetadataBuilder AddProvider<TProvider, TBuilder>(Action<TBuilder>? configure = null) where TProvider : IMetadataProvider where TBuilder : new()
+```
+
+#### Parameters
+
+`configure` [Action](https://learn.microsoft.com/dotnet/api/system.action\-1)<TBuilder\>?
+
+Optional configuration action for the provider's builder
+
+#### Returns
+
+ [FlowthruMetadataBuilder](Flowthru.Meta.FlowthruMetadataBuilder.md)
+
+This builder for fluent chaining
+
+#### Type Parameters
+
+`TProvider` 
+
+The metadata provider type (must implement <xref href="Flowthru.Meta.Providers.IMetadataProvider" data-throw-if-not-resolved="false"></xref> and have <xref href="Flowthru.Meta.MetadataProviderBuilderAttribute" data-throw-if-not-resolved="false"></xref>)
+
+`TBuilder` 
+
+The builder type for the provider
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown when provider type lacks <xref href="Flowthru.Meta.MetadataProviderBuilderAttribute" data-throw-if-not-resolved="false"></xref> or builder type mismatch
+
+### <a id="Flowthru_Meta_FlowthruMetadataBuilder_AddProvider_Flowthru_Meta_Providers_IMetadataProvider_"></a> AddProvider\(IMetadataProvider\)
+
+Adds a custom metadata provider instance directly.
+
+```csharp
+public FlowthruMetadataBuilder AddProvider(IMetadataProvider provider)
+```
+
+#### Parameters
+
+`provider` [IMetadataProvider](Flowthru.Meta.Providers.IMetadataProvider.md)
+
+The metadata provider to register
+
+#### Returns
+
+ [FlowthruMetadataBuilder](Flowthru.Meta.FlowthruMetadataBuilder.md)
+
+This builder for fluent chaining
+
+### <a id="Flowthru_Meta_FlowthruMetadataBuilder_WithAutoExport_System_Boolean_"></a> WithAutoExport\(bool\)
+
+Enables or disables automatic metadata export during pipeline execution.
+
+```csharp
+public FlowthruMetadataBuilder WithAutoExport(bool enabled = true)
+```
+
+#### Parameters
+
+`enabled` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+True to auto-export (default), false to require manual export
+
+#### Returns
+
+ [FlowthruMetadataBuilder](Flowthru.Meta.FlowthruMetadataBuilder.md)
+
+This builder for fluent chaining
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.FlowthruMetadataConfiguration.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.FlowthruMetadataConfiguration.md
new file mode 100644
index 00000000..a7f87888
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.FlowthruMetadataConfiguration.md
@@ -0,0 +1,181 @@
+# <a id="Flowthru_Meta_FlowthruMetadataConfiguration"></a> Class FlowthruMetadataConfiguration
+
+Namespace: [Flowthru.Meta](Flowthru.Meta.md)  
+Assembly: Flowthru.Core.dll  
+
+Configuration for Flowthru metadata collection and export.
+
+```csharp
+public class FlowthruMetadataConfiguration
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowthruMetadataConfiguration](Flowthru.Meta.FlowthruMetadataConfiguration.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+This configuration controls whether and how pipeline metadata is collected
+and persisted. Metadata includes DAG structure (nodes, catalog entries, edges)
+that can be consumed by Flowthru.Viz for visualization.
+</p>
+<p>
+<strong>Usage:</strong>
+</p>
+<pre><code class="lang-csharp">builder.IncludeMetadata(metadata =&gt; {
+    metadata
+        .WithOutputDirectory("Data/Metadata")
+        .EnableAutoExport();
+});</code></pre>
+
+## Properties
+
+### <a id="Flowthru_Meta_FlowthruMetadataConfiguration_AutoExportDag"></a> AutoExportDag
+
+Whether to automatically export DAG metadata after Pipeline.Build().
+
+```csharp
+public bool AutoExportDag { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+Default: true
+When enabled, DAG JSON files are automatically created after each pipeline build.
+
+### <a id="Flowthru_Meta_FlowthruMetadataConfiguration_ExportMermaid"></a> ExportMermaid
+
+Whether to export Mermaid diagram files (.md) alongside JSON files.
+
+```csharp
+public bool ExportMermaid { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+Default: true
+When enabled, a Markdown file with an embedded Mermaid diagram is created
+alongside each JSON file for immediate visualization.
+
+### <a id="Flowthru_Meta_FlowthruMetadataConfiguration_OutputDirectory"></a> OutputDirectory
+
+Directory where metadata JSON files will be written.
+
+```csharp
+public string OutputDirectory { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Default: "Data/Metadata"
+
+## Methods
+
+### <a id="Flowthru_Meta_FlowthruMetadataConfiguration_DisableAutoExport"></a> DisableAutoExport\(\)
+
+Disables automatic DAG export.
+
+```csharp
+public FlowthruMetadataConfiguration DisableAutoExport()
+```
+
+#### Returns
+
+ [FlowthruMetadataConfiguration](Flowthru.Meta.FlowthruMetadataConfiguration.md)
+
+This configuration for fluent chaining
+
+#### Remarks
+
+Use this when you want manual control over metadata export via Pipeline.ExportDag().
+
+### <a id="Flowthru_Meta_FlowthruMetadataConfiguration_DisableMermaid"></a> DisableMermaid\(\)
+
+Disables Mermaid diagram export.
+
+```csharp
+public FlowthruMetadataConfiguration DisableMermaid()
+```
+
+#### Returns
+
+ [FlowthruMetadataConfiguration](Flowthru.Meta.FlowthruMetadataConfiguration.md)
+
+This configuration for fluent chaining
+
+#### Remarks
+
+Use this when you only want JSON output without Mermaid diagrams.
+
+### <a id="Flowthru_Meta_FlowthruMetadataConfiguration_EnableAutoExport"></a> EnableAutoExport\(\)
+
+Enables automatic DAG export after pipeline builds.
+
+```csharp
+public FlowthruMetadataConfiguration EnableAutoExport()
+```
+
+#### Returns
+
+ [FlowthruMetadataConfiguration](Flowthru.Meta.FlowthruMetadataConfiguration.md)
+
+This configuration for fluent chaining
+
+### <a id="Flowthru_Meta_FlowthruMetadataConfiguration_EnableMermaid"></a> EnableMermaid\(\)
+
+Enables Mermaid diagram export.
+
+```csharp
+public FlowthruMetadataConfiguration EnableMermaid()
+```
+
+#### Returns
+
+ [FlowthruMetadataConfiguration](Flowthru.Meta.FlowthruMetadataConfiguration.md)
+
+This configuration for fluent chaining
+
+### <a id="Flowthru_Meta_FlowthruMetadataConfiguration_WithOutputDirectory_System_String_"></a> WithOutputDirectory\(string\)
+
+Sets the output directory for metadata files.
+
+```csharp
+public FlowthruMetadataConfiguration WithOutputDirectory(string directory)
+```
+
+#### Parameters
+
+`directory` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Directory path (absolute or relative to working directory)
+
+#### Returns
+
+ [FlowthruMetadataConfiguration](Flowthru.Meta.FlowthruMetadataConfiguration.md)
+
+This configuration for fluent chaining
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.JsonMetadataProviderBuilder.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.JsonMetadataProviderBuilder.md
new file mode 100644
index 00000000..7257764e
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.JsonMetadataProviderBuilder.md
@@ -0,0 +1,150 @@
+# <a id="Flowthru_Meta_JsonMetadataProviderBuilder"></a> Class JsonMetadataProviderBuilder
+
+Namespace: [Flowthru.Meta](Flowthru.Meta.md)  
+Assembly: Flowthru.Core.dll  
+
+Builder for configuring JSON metadata provider options.
+
+```csharp
+public class JsonMetadataProviderBuilder
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[JsonMetadataProviderBuilder](Flowthru.Meta.JsonMetadataProviderBuilder.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Flowthru_Meta_JsonMetadataProviderBuilder_Build"></a> Build\(\)
+
+Builds the JSON metadata provider with the configured options.
+
+```csharp
+public JsonMetadataProvider Build()
+```
+
+#### Returns
+
+ [JsonMetadataProvider](Flowthru.Meta.Providers.JsonMetadataProvider.md)
+
+A configured <xref href="Flowthru.Meta.Providers.JsonMetadataProvider" data-throw-if-not-resolved="false"></xref> instance
+
+### <a id="Flowthru_Meta_JsonMetadataProviderBuilder_UseCompactFormat"></a> UseCompactFormat\(\)
+
+Enables compact JSON format (no indentation).
+
+```csharp
+public JsonMetadataProviderBuilder UseCompactFormat()
+```
+
+#### Returns
+
+ [JsonMetadataProviderBuilder](Flowthru.Meta.JsonMetadataProviderBuilder.md)
+
+This builder for fluent chaining
+
+### <a id="Flowthru_Meta_JsonMetadataProviderBuilder_UseIndentedFormat"></a> UseIndentedFormat\(\)
+
+Enables indented JSON format (default).
+
+```csharp
+public JsonMetadataProviderBuilder UseIndentedFormat()
+```
+
+#### Returns
+
+ [JsonMetadataProviderBuilder](Flowthru.Meta.JsonMetadataProviderBuilder.md)
+
+This builder for fluent chaining
+
+### <a id="Flowthru_Meta_JsonMetadataProviderBuilder_WithFilenameTemplate_System_String_"></a> WithFilenameTemplate\(string\)
+
+Sets the filename template for metadata files.
+
+```csharp
+public JsonMetadataProviderBuilder WithFilenameTemplate(string template)
+```
+
+#### Parameters
+
+`template` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Template with placeholders: {FlowName}, {Timestamp}, {SliceType}
+
+#### Returns
+
+ [JsonMetadataProviderBuilder](Flowthru.Meta.JsonMetadataProviderBuilder.md)
+
+This builder for fluent chaining
+
+### <a id="Flowthru_Meta_JsonMetadataProviderBuilder_WithLogger_Microsoft_Extensions_Logging_ILogger_"></a> WithLogger\(ILogger\)
+
+Sets a custom logger for this provider.
+
+```csharp
+public JsonMetadataProviderBuilder WithLogger(ILogger logger)
+```
+
+#### Parameters
+
+`logger` [ILogger](https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger)
+
+Logger instance
+
+#### Returns
+
+ [JsonMetadataProviderBuilder](Flowthru.Meta.JsonMetadataProviderBuilder.md)
+
+This builder for fluent chaining
+
+### <a id="Flowthru_Meta_JsonMetadataProviderBuilder_WithOutputDirectory_System_String_"></a> WithOutputDirectory\(string\)
+
+Sets the output directory for metadata files.
+
+```csharp
+public JsonMetadataProviderBuilder WithOutputDirectory(string directory)
+```
+
+#### Parameters
+
+`directory` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Directory path (relative or absolute)
+
+#### Returns
+
+ [JsonMetadataProviderBuilder](Flowthru.Meta.JsonMetadataProviderBuilder.md)
+
+This builder for fluent chaining
+
+### <a id="Flowthru_Meta_JsonMetadataProviderBuilder_WithTimestamp_System_String_"></a> WithTimestamp\(string?\)
+
+Sets the timestamp format for filename generation.
+
+```csharp
+public JsonMetadataProviderBuilder WithTimestamp(string? format = null)
+```
+
+#### Parameters
+
+`format` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+Timestamp format string (e.g., "yyyy-MM-dd_HH-mm-ss")
+
+#### Returns
+
+ [JsonMetadataProviderBuilder](Flowthru.Meta.JsonMetadataProviderBuilder.md)
+
+This builder for fluent chaining
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.MermaidMetadataExtensions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.MermaidMetadataExtensions.md
new file mode 100644
index 00000000..cea43a55
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.MermaidMetadataExtensions.md
@@ -0,0 +1,96 @@
+# <a id="Flowthru_Meta_MermaidMetadataExtensions"></a> Class MermaidMetadataExtensions
+
+Namespace: [Flowthru.Meta](Flowthru.Meta.md)  
+Assembly: Flowthru.Core.dll  
+
+Extension methods for generating Mermaid diagram representations of DAG metadata.
+
+```csharp
+public static class MermaidMetadataExtensions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[MermaidMetadataExtensions](Flowthru.Meta.MermaidMetadataExtensions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+Mermaid diagrams provide immediate visualization in Markdown-compatible tools
+(GitHub, VS Code, etc.) without requiring a separate web application.
+</p>
+<p>
+The generated diagram uses Mermaid flowchart syntax with:
+- Steps as rectangles with rounded corners
+- Catalog items as cylindrical database shapes
+- Flow subgraphs grouping nodes by their origin flow
+- External data (no producer) shown with special styling
+- Produced data (has producer) inside their producer's flow subgraph
+</p>
+
+## Methods
+
+### <a id="Flowthru_Meta_MermaidMetadataExtensions_ToMermaidDiagram_Flowthru_Meta_Models_DagMetadata_System_String_System_String_System_String_"></a> ToMermaidDiagram\(DagMetadata, string, string, string\)
+
+Generates a Mermaid flowchart representation of the DAG, wrapped in a code fence.
+
+```csharp
+public static string ToMermaidDiagram(this DagMetadata dag, string direction = "TB", string activeStepColor = "#2E7D32", string activeItemColor = "#2E7D32")
+```
+
+#### Parameters
+
+`dag` [DagMetadata](Flowthru.Meta.Models.DagMetadata.md)
+
+The DAG metadata to visualize
+
+`direction` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Flow direction code (TB, LR, BT, RL). Defaults to TB (Top to Bottom).
+
+`activeStepColor` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Hex color for active (sliced) steps. Defaults to #2E7D32.
+
+`activeItemColor` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Hex color for active (sliced) catalog items. Defaults to #2E7D32.
+
+#### Returns
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Complete Markdown document with Mermaid code fence
+
+#### Remarks
+
+<p>
+The output is a valid Markdown document that can be saved as a .md file
+and rendered by any Mermaid-compatible viewer.
+</p>
+<p>
+<strong>Example output:</strong>
+</p>
+<pre><code class="lang-csharp">```mermaid
+flowchart TB
+    RawCompanies[("Raw Companies")]
+
+    subgraph DataProcessing["DataProcessing"]
+        PreprocessCompanies["Preprocess Companies"]
+        CleanedCompanies[("Cleaned Companies")]
+        RawCompanies --&gt; PreprocessCompanies
+        PreprocessCompanies --&gt; CleanedCompanies
+    end
+```</code></pre>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.MermaidMetadataProviderBuilder.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.MermaidMetadataProviderBuilder.md
new file mode 100644
index 00000000..5d278d27
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.MermaidMetadataProviderBuilder.md
@@ -0,0 +1,182 @@
+# <a id="Flowthru_Meta_MermaidMetadataProviderBuilder"></a> Class MermaidMetadataProviderBuilder
+
+Namespace: [Flowthru.Meta](Flowthru.Meta.md)  
+Assembly: Flowthru.Core.dll  
+
+Builder for configuring Mermaid diagram provider options.
+
+```csharp
+public class MermaidMetadataProviderBuilder
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[MermaidMetadataProviderBuilder](Flowthru.Meta.MermaidMetadataProviderBuilder.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Flowthru_Meta_MermaidMetadataProviderBuilder_Build"></a> Build\(\)
+
+Builds the Mermaid metadata provider with the configured options.
+
+```csharp
+public MermaidMetadataProvider Build()
+```
+
+#### Returns
+
+ [MermaidMetadataProvider](Flowthru.Meta.Providers.MermaidMetadataProvider.md)
+
+A configured <xref href="Flowthru.Meta.Providers.MermaidMetadataProvider" data-throw-if-not-resolved="false"></xref> instance
+
+### <a id="Flowthru_Meta_MermaidMetadataProviderBuilder_WithActiveDataColor_System_String_"></a> WithActiveDataColor\(string\)
+
+Sets the color for active (sliced) catalog entries.
+
+```csharp
+public MermaidMetadataProviderBuilder WithActiveDataColor(string color)
+```
+
+#### Parameters
+
+`color` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Hex color code (e.g., "#2E7D32")
+
+#### Returns
+
+ [MermaidMetadataProviderBuilder](Flowthru.Meta.MermaidMetadataProviderBuilder.md)
+
+This builder for fluent chaining
+
+### <a id="Flowthru_Meta_MermaidMetadataProviderBuilder_WithActiveStepColor_System_String_"></a> WithActiveStepColor\(string\)
+
+Sets the color for active (sliced) nodes.
+
+```csharp
+public MermaidMetadataProviderBuilder WithActiveStepColor(string color)
+```
+
+#### Parameters
+
+`color` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Hex color code (e.g., "#2E7D32")
+
+#### Returns
+
+ [MermaidMetadataProviderBuilder](Flowthru.Meta.MermaidMetadataProviderBuilder.md)
+
+This builder for fluent chaining
+
+### <a id="Flowthru_Meta_MermaidMetadataProviderBuilder_WithDirection_Flowthru_Meta_Providers_MermaidMetadataProvider_MermaidFlowchartDirection_"></a> WithDirection\(MermaidFlowchartDirection\)
+
+Sets the flowchart direction.
+
+```csharp
+public MermaidMetadataProviderBuilder WithDirection(MermaidMetadataProvider.MermaidFlowchartDirection direction)
+```
+
+#### Parameters
+
+`direction` [MermaidMetadataProvider](Flowthru.Meta.Providers.MermaidMetadataProvider.md).[MermaidFlowchartDirection](Flowthru.Meta.Providers.MermaidMetadataProvider.MermaidFlowchartDirection.md)
+
+Direction for the flowchart (TB, LR, BT, RL)
+
+#### Returns
+
+ [MermaidMetadataProviderBuilder](Flowthru.Meta.MermaidMetadataProviderBuilder.md)
+
+This builder for fluent chaining
+
+### <a id="Flowthru_Meta_MermaidMetadataProviderBuilder_WithFilenameTemplate_System_String_"></a> WithFilenameTemplate\(string\)
+
+Sets the filename template for metadata files.
+
+```csharp
+public MermaidMetadataProviderBuilder WithFilenameTemplate(string template)
+```
+
+#### Parameters
+
+`template` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Template with placeholders: {FlowName}, {Timestamp}, {SliceType}
+
+#### Returns
+
+ [MermaidMetadataProviderBuilder](Flowthru.Meta.MermaidMetadataProviderBuilder.md)
+
+This builder for fluent chaining
+
+### <a id="Flowthru_Meta_MermaidMetadataProviderBuilder_WithLogger_Microsoft_Extensions_Logging_ILogger_"></a> WithLogger\(ILogger\)
+
+Sets a custom logger for this provider.
+
+```csharp
+public MermaidMetadataProviderBuilder WithLogger(ILogger logger)
+```
+
+#### Parameters
+
+`logger` [ILogger](https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger)
+
+Logger instance
+
+#### Returns
+
+ [MermaidMetadataProviderBuilder](Flowthru.Meta.MermaidMetadataProviderBuilder.md)
+
+This builder for fluent chaining
+
+### <a id="Flowthru_Meta_MermaidMetadataProviderBuilder_WithOutputDirectory_System_String_"></a> WithOutputDirectory\(string\)
+
+Sets the output directory for metadata files.
+
+```csharp
+public MermaidMetadataProviderBuilder WithOutputDirectory(string directory)
+```
+
+#### Parameters
+
+`directory` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Directory path (relative or absolute)
+
+#### Returns
+
+ [MermaidMetadataProviderBuilder](Flowthru.Meta.MermaidMetadataProviderBuilder.md)
+
+This builder for fluent chaining
+
+### <a id="Flowthru_Meta_MermaidMetadataProviderBuilder_WithTimestamp_System_String_"></a> WithTimestamp\(string?\)
+
+Sets the timestamp format for filename generation.
+
+```csharp
+public MermaidMetadataProviderBuilder WithTimestamp(string? format = null)
+```
+
+#### Parameters
+
+`format` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+Timestamp format string (e.g., "yyyy-MM-dd_HH-mm-ss")
+
+#### Returns
+
+ [MermaidMetadataProviderBuilder](Flowthru.Meta.MermaidMetadataProviderBuilder.md)
+
+This builder for fluent chaining
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.MetadataJsonExtensions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.MetadataJsonExtensions.md
new file mode 100644
index 00000000..0a82239d
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.MetadataJsonExtensions.md
@@ -0,0 +1,109 @@
+# <a id="Flowthru_Meta_MetadataJsonExtensions"></a> Class MetadataJsonExtensions
+
+Namespace: [Flowthru.Meta](Flowthru.Meta.md)  
+Assembly: Flowthru.Core.dll  
+
+Extension methods for serializing metadata to JSON.
+
+```csharp
+public static class MetadataJsonExtensions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[MetadataJsonExtensions](Flowthru.Meta.MetadataJsonExtensions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Flowthru_Meta_MetadataJsonExtensions_FromJson_System_String_"></a> FromJson\(string\)
+
+Deserializes DagMetadata from JSON string.
+
+```csharp
+public static DagMetadata FromJson(string json)
+```
+
+#### Parameters
+
+`json` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+JSON string to deserialize
+
+#### Returns
+
+ [DagMetadata](Flowthru.Meta.Models.DagMetadata.md)
+
+Deserialized DagMetadata object
+
+#### Exceptions
+
+ [JsonException](https://learn.microsoft.com/dotnet/api/system.text.json.jsonexception)
+
+Thrown if JSON is invalid or doesn't match schema
+
+### <a id="Flowthru_Meta_MetadataJsonExtensions_ToCompactJson_Flowthru_Meta_Models_DagMetadata_"></a> ToCompactJson\(DagMetadata\)
+
+Serializes DagMetadata to compact JSON string (no indentation).
+
+```csharp
+public static string ToCompactJson(this DagMetadata metadata)
+```
+
+#### Parameters
+
+`metadata` [DagMetadata](Flowthru.Meta.Models.DagMetadata.md)
+
+The DAG metadata to serialize
+
+#### Returns
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Compact JSON string representation
+
+#### Remarks
+
+Use this for minimizing file size when human readability is not a concern,
+such as API responses or embedded metadata.
+
+### <a id="Flowthru_Meta_MetadataJsonExtensions_ToJson_Flowthru_Meta_Models_DagMetadata_"></a> ToJson\(DagMetadata\)
+
+Serializes DagMetadata to pretty-printed JSON string.
+
+```csharp
+public static string ToJson(this DagMetadata metadata)
+```
+
+#### Parameters
+
+`metadata` [DagMetadata](Flowthru.Meta.Models.DagMetadata.md)
+
+The DAG metadata to serialize
+
+#### Returns
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+JSON string representation
+
+#### Remarks
+
+<p>
+Output format uses:
+</p>
+<ul><li>camelCase property names (pipelineName, not FlowName)</li><li>Indented formatting for readability</li><li>Null properties omitted</li><li>Enums serialized as strings</li></ul>
+<p>
+This format is optimized for Flowthru.Viz consumption and human readability.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.MetadataProviderBuilderAttribute.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.MetadataProviderBuilderAttribute.md
new file mode 100644
index 00000000..364837c4
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.MetadataProviderBuilderAttribute.md
@@ -0,0 +1,113 @@
+# <a id="Flowthru_Meta_MetadataProviderBuilderAttribute"></a> Class MetadataProviderBuilderAttribute
+
+Namespace: [Flowthru.Meta](Flowthru.Meta.md)  
+Assembly: Flowthru.Core.dll  
+
+Specifies the builder type for a metadata provider.
+
+```csharp
+[AttributeUsage(AttributeTargets.Class, Inherited = false, AllowMultiple = false)]
+public sealed class MetadataProviderBuilderAttribute : Attribute
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[Attribute](https://learn.microsoft.com/dotnet/api/system.attribute) ← 
+[MetadataProviderBuilderAttribute](Flowthru.Meta.MetadataProviderBuilderAttribute.md)
+
+#### Inherited Members
+
+[Attribute.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.attribute.equals), 
+[Attribute.GetCustomAttribute\(Assembly, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-assembly\-system\-type\)), 
+[Attribute.GetCustomAttribute\(Assembly, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-assembly\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttribute\(MemberInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-memberinfo\-system\-type\)), 
+[Attribute.GetCustomAttribute\(MemberInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-memberinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttribute\(Module, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-module\-system\-type\)), 
+[Attribute.GetCustomAttribute\(Module, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-module\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttribute\(ParameterInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-parameterinfo\-system\-type\)), 
+[Attribute.GetCustomAttribute\(ParameterInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattribute\#system\-attribute\-getcustomattribute\(system\-reflection\-parameterinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Assembly\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\)), 
+[Attribute.GetCustomAttributes\(Assembly, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Assembly, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\-system\-type\)), 
+[Attribute.GetCustomAttributes\(Assembly, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-assembly\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(MemberInfo\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\)), 
+[Attribute.GetCustomAttributes\(MemberInfo, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(MemberInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\-system\-type\)), 
+[Attribute.GetCustomAttributes\(MemberInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-memberinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Module\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\)), 
+[Attribute.GetCustomAttributes\(Module, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(Module, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\-system\-type\)), 
+[Attribute.GetCustomAttributes\(Module, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-module\-system\-type\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\-system\-boolean\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\-system\-type\)), 
+[Attribute.GetCustomAttributes\(ParameterInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.getcustomattributes\#system\-attribute\-getcustomattributes\(system\-reflection\-parameterinfo\-system\-type\-system\-boolean\)), 
+[Attribute.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.attribute.gethashcode), 
+[Attribute.IsDefaultAttribute\(\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefaultattribute), 
+[Attribute.IsDefined\(Assembly, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-assembly\-system\-type\)), 
+[Attribute.IsDefined\(Assembly, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-assembly\-system\-type\-system\-boolean\)), 
+[Attribute.IsDefined\(MemberInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-memberinfo\-system\-type\)), 
+[Attribute.IsDefined\(MemberInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-memberinfo\-system\-type\-system\-boolean\)), 
+[Attribute.IsDefined\(Module, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-module\-system\-type\)), 
+[Attribute.IsDefined\(Module, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-module\-system\-type\-system\-boolean\)), 
+[Attribute.IsDefined\(ParameterInfo, Type\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-parameterinfo\-system\-type\)), 
+[Attribute.IsDefined\(ParameterInfo, Type, bool\)](https://learn.microsoft.com/dotnet/api/system.attribute.isdefined\#system\-attribute\-isdefined\(system\-reflection\-parameterinfo\-system\-type\-system\-boolean\)), 
+[Attribute.Match\(object?\)](https://learn.microsoft.com/dotnet/api/system.attribute.match), 
+[Attribute.TypeId](https://learn.microsoft.com/dotnet/api/system.attribute.typeid), 
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+This attribute enables type-safe provider registration via the generic
+FlowthruMetadataBuilder.AddProvider&lt;TProvider&gt;(Action&lt;object&gt;?) method.
+</p>
+<p>
+The builder type must:
+</p>
+<ul><li>Have a public parameterless constructor</li><li>Expose a public <code>Build()</code> method returning <xref href="Flowthru.Meta.Providers.IMetadataProvider" data-throw-if-not-resolved="false"></xref></li></ul>
+<p>
+<strong>Example:</strong>
+</p>
+<pre><code class="lang-csharp">[MetadataProviderBuilder(typeof(JsonMetadataProviderBuilder))]
+public class JsonMetadataProvider : IMetadataProvider
+{
+  // ...
+}</code></pre>
+
+## Constructors
+
+### <a id="Flowthru_Meta_MetadataProviderBuilderAttribute__ctor_System_Type_"></a> MetadataProviderBuilderAttribute\(Type\)
+
+Initializes a new instance of the <xref href="Flowthru.Meta.MetadataProviderBuilderAttribute" data-throw-if-not-resolved="false"></xref> class.
+
+```csharp
+public MetadataProviderBuilderAttribute(Type builderType)
+```
+
+#### Parameters
+
+`builderType` [Type](https://learn.microsoft.com/dotnet/api/system.type)
+
+The type of the provider's builder class
+
+## Properties
+
+### <a id="Flowthru_Meta_MetadataProviderBuilderAttribute_BuilderType"></a> BuilderType
+
+Gets the builder type for this metadata provider.
+
+```csharp
+public Type BuilderType { get; }
+```
+
+#### Property Value
+
+ [Type](https://learn.microsoft.com/dotnet/api/system.type)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.CatalogEntryMetadata.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.CatalogEntryMetadata.md
new file mode 100644
index 00000000..7f228408
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.CatalogEntryMetadata.md
@@ -0,0 +1,160 @@
+# <a id="Flowthru_Meta_Models_ItemMetadata"></a> Class ItemMetadata
+
+Namespace: [Flowthru.Meta.Models](Flowthru.Meta.Models.md)  
+Assembly: Flowthru.Core.dll  
+
+Metadata describing a single catalog entry (dataset) in the pipeline.
+
+```csharp
+public class ItemMetadata
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ItemMetadata](Flowthru.Meta.Models.ItemMetadata.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Catalog entries represent data sources and sinks. They can be external files,
+intermediate pipeline outputs, or final results. Each entry is uniquely identified
+by its key.
+
+## Properties
+
+### <a id="Flowthru_Meta_Models_ItemMetadata_Consumers"></a> Consumers
+
+List of node IDs that consume (read from) this catalog entry.
+
+```csharp
+[JsonPropertyName("consumers")]
+public List<string> Consumers { get; init; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+#### Remarks
+
+Empty for pipeline outputs that aren't consumed by other nodes.
+Example: ["CreateModelInputTable", "ValidateData"]
+
+### <a id="Flowthru_Meta_Models_ItemMetadata_DataType"></a> DataType
+
+The C# type name of data stored in this catalog entry.
+
+```csharp
+[JsonPropertyName("dataType")]
+public required string DataType { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Simple type name without namespace.
+Example: "Company", "Shuttle", "ModelInput"
+
+### <a id="Flowthru_Meta_Models_ItemMetadata_Fields"></a> Fields
+
+Additional metadata fields specific to the catalog entry type.
+
+```csharp
+[JsonPropertyName("fields")]
+public Dictionary<string, object> Fields { get; init; }
+```
+
+#### Property Value
+
+ [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [object](https://learn.microsoft.com/dotnet/api/system.object)\>
+
+#### Remarks
+
+<p>Examples of fields:</p>
+<ul><li><code>filepath</code>: Path to file for file-based datasets</li><li><code>catalogType</code>: Type of catalog dataset (CsvCatalogDataset, ParquetCatalogDataset, etc.)</li><li><code>isReadOnly</code>: Whether the dataset is read-only</li><li><code>inspectionLevel</code>: Validation inspection level (None, Shallow, Deep)</li></ul>
+
+### <a id="Flowthru_Meta_Models_ItemMetadata_Key"></a> Key
+
+Unique key identifying this catalog entry.
+
+```csharp
+[JsonPropertyName("key")]
+public required string Key { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Corresponds to the catalog property name or explicitly set key.
+Example: "Companies", "CleanedCompanies", "ModelInputTable"
+
+### <a id="Flowthru_Meta_Models_ItemMetadata_Label"></a> Label
+
+Human-readable display label for this catalog entry.
+
+```csharp
+[JsonPropertyName("label")]
+public required string Label { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+May be formatted for better display in Flowthru.Viz.
+Example: "Companies", "Cleaned Companies", "Model Input Table"
+
+### <a id="Flowthru_Meta_Models_ItemMetadata_Producer"></a> Producer
+
+Node ID that produces (writes to) this catalog entry.
+
+```csharp
+[JsonPropertyName("producer")]
+public string? Producer { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Remarks
+
+Null for external inputs (Layer 0 inputs that exist before pipeline execution).
+Example: "PreprocessCompanies"
+
+### <a id="Flowthru_Meta_Models_ItemMetadata_Schema"></a> Schema
+
+Schema information inferred from the data type.
+
+```csharp
+[JsonPropertyName("schema")]
+public SchemaMetadata? Schema { get; init; }
+```
+
+#### Property Value
+
+ [SchemaMetadata](Flowthru.Meta.Models.SchemaMetadata.md)?
+
+#### Remarks
+
+Null for simple types or when schema inference fails.
+Contains property names, types, and nullability for complex types.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.DagMetadata.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.DagMetadata.md
new file mode 100644
index 00000000..eacd572d
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.DagMetadata.md
@@ -0,0 +1,172 @@
+# <a id="Flowthru_Meta_Models_DagMetadata"></a> Class DagMetadata
+
+Namespace: [Flowthru.Meta.Models](Flowthru.Meta.Models.md)  
+Assembly: Flowthru.Core.dll  
+
+Root metadata model representing a complete FlowthruService DAG (Directed Acyclic Graph).
+
+```csharp
+public class DagMetadata
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[DagMetadata](Flowthru.Meta.Models.DagMetadata.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+#### Extension Methods
+
+[MetadataJsonExtensions.ToCompactJson\(DagMetadata\)](Flowthru.Meta.MetadataJsonExtensions.md\#Flowthru\_Meta\_MetadataJsonExtensions\_ToCompactJson\_Flowthru\_Meta\_Models\_DagMetadata\_), 
+[MetadataJsonExtensions.ToJson\(DagMetadata\)](Flowthru.Meta.MetadataJsonExtensions.md\#Flowthru\_Meta\_MetadataJsonExtensions\_ToJson\_Flowthru\_Meta\_Models\_DagMetadata\_), 
+[MermaidMetadataExtensions.ToMermaidDiagram\(DagMetadata, string, string, string\)](Flowthru.Meta.MermaidMetadataExtensions.md\#Flowthru\_Meta\_MermaidMetadataExtensions\_ToMermaidDiagram\_Flowthru\_Meta\_Models\_DagMetadata\_System\_String\_System\_String\_System\_String\_)
+
+## Remarks
+
+This model captures the structure of a built flow, including all steps,
+catalog items, and their relationships. It serves as the backbone for
+Flowthru.Viz visualization.
+
+## Properties
+
+### <a id="Flowthru_Meta_Models_DagMetadata_AppliedSlice"></a> AppliedSlice
+
+Slice criteria applied to generate this DAG, if any.
+
+```csharp
+[JsonPropertyName("appliedSlice")]
+[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+public DagSliceMetadata? AppliedSlice { get; init; }
+```
+
+#### Property Value
+
+ [DagSliceMetadata](Flowthru.Meta.Models.DagSliceMetadata.md)?
+
+#### Remarks
+
+Present when the DAG represents a sliced subset of the full Flow.
+Null when the DAG represents the complete, unsliced flow.
+Used for reproducibility, debugging, and filename generation.
+
+### <a id="Flowthru_Meta_Models_DagMetadata_CatalogItems"></a> CatalogItems
+
+All catalog items involved in the flow.
+
+```csharp
+[JsonPropertyName("catalogItems")]
+public List<ItemMetadata> CatalogItems { get; init; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[ItemMetadata](Flowthru.Meta.Models.ItemMetadata.md)\>
+
+### <a id="Flowthru_Meta_Models_DagMetadata_Edges"></a> Edges
+
+All edges representing data flow in the DAG.
+
+```csharp
+[JsonPropertyName("edges")]
+public List<EdgeMetadata> Edges { get; init; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[EdgeMetadata](Flowthru.Meta.Models.EdgeMetadata.md)\>
+
+#### Remarks
+
+Edges connect catalog items to steps and steps to catalog items,
+forming the complete graph.
+
+### <a id="Flowthru_Meta_Models_DagMetadata_FlowName"></a> FlowName
+
+Name of the flow this DAG represents.
+
+```csharp
+[JsonPropertyName("flowName")]
+public required string FlowName { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Meta_Models_DagMetadata_GeneratedAt"></a> GeneratedAt
+
+Timestamp when this metadata was generated.
+
+```csharp
+[JsonPropertyName("generatedAt")]
+public DateTime GeneratedAt { get; init; }
+```
+
+#### Property Value
+
+ [DateTime](https://learn.microsoft.com/dotnet/api/system.datetime)
+
+### <a id="Flowthru_Meta_Models_DagMetadata_SlicedCatalogItemIds"></a> SlicedCatalogItemIds
+
+Catalog item IDsthat are produced by steps in the active execution slice.
+
+```csharp
+[JsonPropertyName("slicedCatalogItemIds")]
+[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+public HashSet<string>? SlicedCatalogItemIds { get; init; }
+```
+
+#### Property Value
+
+ [HashSet](https://learn.microsoft.com/dotnet/api/system.collections.generic.hashset\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>?
+
+#### Remarks
+
+When a slice is applied, this contains the keys of catalog items (data) that
+will be written during execution. Derived from the outputs of sliced steps.
+Null when no slice was applied (all data may be updated).
+Enables visualization tools to highlight both steps and the data they produce.
+
+### <a id="Flowthru_Meta_Models_DagMetadata_SlicedStepIds"></a> SlicedStepIds
+
+Step IDs that are in the active execution slice, if a slice was applied.
+
+```csharp
+[JsonPropertyName("slicedStepIds")]
+[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+public HashSet<string>? SlicedStepIds { get; init; }
+```
+
+#### Property Value
+
+ [HashSet](https://learn.microsoft.com/dotnet/api/system.collections.generic.hashset\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>?
+
+#### Remarks
+
+When a slice is applied, this contains the IDs of steps that will actually execute.
+The Steps collection contains the full DAG, while this set identifies the subset.
+Null when no slice was applied (all steps execute).
+Enables visualization tools to highlight execution paths while showing full context.
+
+### <a id="Flowthru_Meta_Models_DagMetadata_Steps"></a> Steps
+
+All steps in the flow with their metadata.
+
+```csharp
+[JsonPropertyName("steps")]
+public List<StepMetadata> Steps { get; init; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[StepMetadata](Flowthru.Meta.Models.StepMetadata.md)\>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.DagSliceMetadata.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.DagSliceMetadata.md
new file mode 100644
index 00000000..579cf6ad
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.DagSliceMetadata.md
@@ -0,0 +1,118 @@
+# <a id="Flowthru_Meta_Models_DagSliceMetadata"></a> Class DagSliceMetadata
+
+Namespace: [Flowthru.Meta.Models](Flowthru.Meta.Models.md)  
+Assembly: Flowthru.Core.dll  
+
+Metadata describing how a pipeline was sliced during execution.
+
+```csharp
+public class DagSliceMetadata
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[DagSliceMetadata](Flowthru.Meta.Models.DagSliceMetadata.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Captures the criteria used to select a subset of nodes from the full pipeline DAG.
+This information is essential for:
+<ul><li>Reproducibility - rerun the exact same slice</li><li>Debugging - understand what was included/excluded when failures occur</li><li>Auditing - track which pipeline subsets were executed in production</li><li>Visualization - indicate sliced vs. full DAG in metadata exports</li></ul>
+
+## Properties
+
+### <a id="Flowthru_Meta_Models_DagSliceMetadata_FromData"></a> FromData
+
+Catalog entry labels whose consumers are included (expanded downstream).
+
+```csharp
+[JsonPropertyName("fromData")]
+[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+public string[]? FromData { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)\[\]?
+
+### <a id="Flowthru_Meta_Models_DagSliceMetadata_FromNodes"></a> FromNodes
+
+Node names from which the slice expanded downstream (dependents included).
+
+```csharp
+[JsonPropertyName("fromNodes")]
+[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+public string[]? FromNodes { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)\[\]?
+
+### <a id="Flowthru_Meta_Models_DagSliceMetadata_OnlyNodes"></a> OnlyNodes
+
+Explicit allowlist of node names (with dependencies auto-included).
+
+```csharp
+[JsonPropertyName("onlyNodes")]
+[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+public string[]? OnlyNodes { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)\[\]?
+
+### <a id="Flowthru_Meta_Models_DagSliceMetadata_Pipelines"></a> Pipelines
+
+Pipeline names to include in the merged DAG.
+
+```csharp
+[JsonPropertyName("pipelines")]
+[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+public string[]? Pipelines { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)\[\]?
+
+### <a id="Flowthru_Meta_Models_DagSliceMetadata_ToData"></a> ToData
+
+Catalog entry labels whose producers are included (expanded upstream).
+
+```csharp
+[JsonPropertyName("toData")]
+[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+public string[]? ToData { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)\[\]?
+
+### <a id="Flowthru_Meta_Models_DagSliceMetadata_ToNodes"></a> ToNodes
+
+Node names to which the slice expanded upstream (dependencies included).
+
+```csharp
+[JsonPropertyName("toNodes")]
+[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+public string[]? ToNodes { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)\[\]?
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.EdgeMetadata.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.EdgeMetadata.md
new file mode 100644
index 00000000..b12f1eac
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.EdgeMetadata.md
@@ -0,0 +1,94 @@
+# <a id="Flowthru_Meta_Models_EdgeMetadata"></a> Class EdgeMetadata
+
+Namespace: [Flowthru.Meta.Models](Flowthru.Meta.Models.md)  
+Assembly: Flowthru.Core.dll  
+
+Metadata describing an edge in the pipeline DAG.
+
+```csharp
+public class EdgeMetadata
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[EdgeMetadata](Flowthru.Meta.Models.EdgeMetadata.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+Edges represent data flow between catalog entries and nodes. The DAG contains
+two types of edges:
+</p>
+<ul><li><strong>Catalog → Node:</strong> A node reads from a catalog entry</li><li><strong>Node → Catalog:</strong> A node writes to a catalog entry</li></ul>
+<p>
+Together, these edges form the complete data flow:
+<code>Item → Node → Item → Node → ...</code>
+</p>
+
+## Properties
+
+### <a id="Flowthru_Meta_Models_EdgeMetadata_DataType"></a> DataType
+
+C# type name of data flowing through this edge.
+
+```csharp
+[JsonPropertyName("dataType")]
+public required string DataType { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Simple type name without namespace.
+Example: "Company", "Shuttle", "ModelInput"
+
+### <a id="Flowthru_Meta_Models_EdgeMetadata_Source"></a> Source
+
+Source identifier (either a catalog entry key or node ID).
+
+```csharp
+[JsonPropertyName("source")]
+public required string Source { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+For Catalog → Node edges, this is a catalog entry key.
+For Node → Catalog edges, this is a node ID.
+
+### <a id="Flowthru_Meta_Models_EdgeMetadata_Target"></a> Target
+
+Target identifier (either a node ID or catalog entry key).
+
+```csharp
+[JsonPropertyName("target")]
+public required string Target { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+For Catalog → Node edges, this is a node ID.
+For Node → Catalog edges, this is a catalog entry key.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.ItemMetadata.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.ItemMetadata.md
new file mode 100644
index 00000000..d9141f16
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.ItemMetadata.md
@@ -0,0 +1,160 @@
+# <a id="Flowthru_Meta_Models_ItemMetadata"></a> Class ItemMetadata
+
+Namespace: [Flowthru.Meta.Models](Flowthru.Meta.Models.md)  
+Assembly: Flowthru.Core.dll  
+
+Metadata describing a single catalog item (dataset, json object, API response, whatever) in the flow.
+
+```csharp
+public class ItemMetadata
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ItemMetadata](Flowthru.Meta.Models.ItemMetadata.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Catalog items represent data sources and sinks. They can be external files,
+intermediate flow outputs, or final results. Each item is uniquely identified
+by its key.
+
+## Properties
+
+### <a id="Flowthru_Meta_Models_ItemMetadata_Consumers"></a> Consumers
+
+List of step IDs that consume (read from) this catalog item.
+
+```csharp
+[JsonPropertyName("consumers")]
+public List<string> Consumers { get; init; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+#### Remarks
+
+Empty for item outputs that aren't consumed by other steps.
+Example: ["CreateModelInputTable", "ValidateData"]
+
+### <a id="Flowthru_Meta_Models_ItemMetadata_DataType"></a> DataType
+
+The C# type name of data stored in this catalog item.
+
+```csharp
+[JsonPropertyName("dataType")]
+public required string DataType { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Simple type name without namespace.
+Example: "Company", "Shuttle", "ModelInput"
+
+### <a id="Flowthru_Meta_Models_ItemMetadata_Fields"></a> Fields
+
+Additional metadata fields specific to the catalog item type.
+
+```csharp
+[JsonPropertyName("fields")]
+public Dictionary<string, object> Fields { get; init; }
+```
+
+#### Property Value
+
+ [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [object](https://learn.microsoft.com/dotnet/api/system.object)\>
+
+#### Remarks
+
+<p>Examples of fields:</p>
+<ul><li><code>filepath</code>: Path to file for file-based datasets</li><li><code>catalogType</code>: Type of catalog dataset (CsvCatalogDataset, ParquetCatalogDataset, etc.)</li><li><code>isReadOnly</code>: Whether the dataset is read-only</li><li><code>inspectionLevel</code>: Validation inspection level (None, Shallow, Deep)</li></ul>
+
+### <a id="Flowthru_Meta_Models_ItemMetadata_Key"></a> Key
+
+Unique key identifying this catalog item.
+
+```csharp
+[JsonPropertyName("key")]
+public required string Key { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Corresponds to the catalog property name or explicitly set key.
+Example: "Companies", "CleanedCompanies", "ModelInputTable"
+
+### <a id="Flowthru_Meta_Models_ItemMetadata_Label"></a> Label
+
+Human-readable display label for this catalog item.
+
+```csharp
+[JsonPropertyName("label")]
+public required string Label { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+May be formatted for better display in Flowthru.Viz.
+Example: "Companies", "Cleaned Companies", "Model Input Table"
+
+### <a id="Flowthru_Meta_Models_ItemMetadata_Producer"></a> Producer
+
+Step ID that produces (writes to) this catalog item.
+
+```csharp
+[JsonPropertyName("producer")]
+public string? Producer { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Remarks
+
+Null for external inputs (Layer 0 inputs that exist before flow execution).
+Example: "PreprocessCompanies"
+
+### <a id="Flowthru_Meta_Models_ItemMetadata_Schema"></a> Schema
+
+Schema information inferred from the data type.
+
+```csharp
+[JsonPropertyName("schema")]
+public SchemaMetadata? Schema { get; init; }
+```
+
+#### Property Value
+
+ [SchemaMetadata](Flowthru.Meta.Models.SchemaMetadata.md)?
+
+#### Remarks
+
+Null for simple types or when schema inference fails.
+Contains property names, types, and nullability for complex types.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.NodeMetadata.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.NodeMetadata.md
new file mode 100644
index 00000000..15982aad
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.NodeMetadata.md
@@ -0,0 +1,160 @@
+# <a id="Flowthru_Meta_Models_NodeMetadata"></a> Class NodeMetadata
+
+Namespace: [Flowthru.Meta.Models](Flowthru.Meta.Models.md)  
+Assembly: Flowthru.Core.dll  
+
+Metadata describing a single node in the pipeline DAG.
+
+```csharp
+public class NodeMetadata
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[NodeMetadata](Flowthru.Meta.Models.NodeMetadata.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Nodes are the processing units in a pipeline. Each node reads from one or more
+catalog entries (inputs), performs a transformation, and writes to one or more
+catalog entries (outputs).
+
+## Properties
+
+### <a id="Flowthru_Meta_Models_NodeMetadata_Id"></a> Id
+
+Unique identifier for this node within the pipeline.
+
+```csharp
+[JsonPropertyName("id")]
+public required string Id { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Typically the node name as defined when adding it to the pipeline.
+Example: "PreprocessCompanies", "TrainModel"
+
+### <a id="Flowthru_Meta_Models_NodeMetadata_Inputs"></a> Inputs
+
+List of catalog entry keys this node reads from.
+
+```csharp
+[JsonPropertyName("inputs")]
+public List<string> Inputs { get; init; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+#### Remarks
+
+For multi-input nodes using CatalogMap, this contains all mapped entries.
+Example: ["Companies", "Shuttles", "Reviews"]
+
+### <a id="Flowthru_Meta_Models_NodeMetadata_Label"></a> Label
+
+Human-readable display label for this node.
+
+```csharp
+[JsonPropertyName("label")]
+public required string Label { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+May be formatted for better display in Flowthru.Viz.
+Example: "Preprocess Companies", "Train Model"
+
+### <a id="Flowthru_Meta_Models_NodeMetadata_Layer"></a> Layer
+
+Execution layer assigned by the dependency analyzer.
+
+```csharp
+[JsonPropertyName("layer")]
+public int Layer { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Remarks
+
+Layer 0 nodes have no dependencies (read external data only).
+Layer N nodes depend only on nodes in layers 0..N-1.
+
+### <a id="Flowthru_Meta_Models_NodeMetadata_NodeType"></a> NodeType
+
+The C# class type name implementing this node.
+
+```csharp
+[JsonPropertyName("nodeType")]
+public required string NodeType { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Simple type name without namespace or generic parameters.
+Example: "PreprocessCompaniesNode", "TrainModelNode"
+
+### <a id="Flowthru_Meta_Models_NodeMetadata_Outputs"></a> Outputs
+
+List of catalog entry keys this node writes to.
+
+```csharp
+[JsonPropertyName("outputs")]
+public List<string> Outputs { get; init; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+#### Remarks
+
+For multi-output nodes using CatalogMap, this contains all mapped entries.
+Example: ["XTrain", "XTest", "YTrain", "YTest"]
+
+### <a id="Flowthru_Meta_Models_NodeMetadata_FlowName"></a> FlowName
+
+Name of the parent pipeline this node belongs to.
+
+```csharp
+[JsonPropertyName("pipelineName")]
+public required string FlowName { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Important for merged pipelines where nodes from multiple pipelines
+are combined into a single DAG.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.SchemaField.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.SchemaField.md
new file mode 100644
index 00000000..b3d2d426
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.SchemaField.md
@@ -0,0 +1,80 @@
+# <a id="Flowthru_Meta_Models_SchemaField"></a> Class SchemaField
+
+Namespace: [Flowthru.Meta.Models](Flowthru.Meta.Models.md)  
+Assembly: Flowthru.Core.dll  
+
+A single field (property) in a schema.
+
+```csharp
+public class SchemaField
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[SchemaField](Flowthru.Meta.Models.SchemaField.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Properties
+
+### <a id="Flowthru_Meta_Models_SchemaField_IsNullable"></a> IsNullable
+
+Whether the property can be null.
+
+```csharp
+[JsonPropertyName("isNullable")]
+public bool IsNullable { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+Determined by nullable reference types (string?) or nullable value types (int?).
+
+### <a id="Flowthru_Meta_Models_SchemaField_Name"></a> Name
+
+Name of the property.
+
+```csharp
+[JsonPropertyName("name")]
+public required string Name { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Example: "Id", "Name", "IataApproved"
+
+### <a id="Flowthru_Meta_Models_SchemaField_Type"></a> Type
+
+C# type name of the property.
+
+```csharp
+[JsonPropertyName("type")]
+public required string Type { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Simple type name without namespace.
+Example: "string", "int", "DateTime", "double"
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.SchemaMetadata.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.SchemaMetadata.md
new file mode 100644
index 00000000..4c32b9b1
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.SchemaMetadata.md
@@ -0,0 +1,47 @@
+# <a id="Flowthru_Meta_Models_SchemaMetadata"></a> Class SchemaMetadata
+
+Namespace: [Flowthru.Meta.Models](Flowthru.Meta.Models.md)  
+Assembly: Flowthru.Core.dll  
+
+Schema information for a data type.
+
+```csharp
+public class SchemaMetadata
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[SchemaMetadata](Flowthru.Meta.Models.SchemaMetadata.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Extracted from C# type definitions using reflection. Describes the structure
+of data flowing through catalog entries, enabling Flowthru.Viz to display
+data schemas and validate type compatibility.
+
+## Properties
+
+### <a id="Flowthru_Meta_Models_SchemaMetadata_Fields"></a> Fields
+
+List of fields (properties) in the schema.
+
+```csharp
+[JsonPropertyName("fields")]
+public List<SchemaField> Fields { get; init; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[SchemaField](Flowthru.Meta.Models.SchemaField.md)\>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.StepMetadata.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.StepMetadata.md
new file mode 100644
index 00000000..fc2d2087
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.StepMetadata.md
@@ -0,0 +1,160 @@
+# <a id="Flowthru_Meta_Models_StepMetadata"></a> Class StepMetadata
+
+Namespace: [Flowthru.Meta.Models](Flowthru.Meta.Models.md)  
+Assembly: Flowthru.Core.dll  
+
+Metadata describing a single step in the flow DAG.
+
+```csharp
+public class StepMetadata
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[StepMetadata](Flowthru.Meta.Models.StepMetadata.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Steps are the processing units in a flow. Each step reads from one or more
+catalog entries (inputs), performs a transformation, and writes to one or more
+catalog entries (outputs).
+
+## Properties
+
+### <a id="Flowthru_Meta_Models_StepMetadata_FlowName"></a> FlowName
+
+Name of the parent flow this step belongs to.
+
+```csharp
+[JsonPropertyName("flowName")]
+public required string FlowName { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Important for merged flows where steps from multiple flows
+are combined into a single DAG.
+
+### <a id="Flowthru_Meta_Models_StepMetadata_Id"></a> Id
+
+Unique identifier for this step within the flow.
+
+```csharp
+[JsonPropertyName("id")]
+public required string Id { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Typically the step name as defined when adding it to the flow.
+Example: "PreprocessCompanies", "TrainModel"
+
+### <a id="Flowthru_Meta_Models_StepMetadata_Inputs"></a> Inputs
+
+List of catalog entry keys this step reads from.
+
+```csharp
+[JsonPropertyName("inputs")]
+public List<string> Inputs { get; init; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+#### Remarks
+
+For multi-input steps using CatalogMap, this contains all mapped entries.
+Example: ["Companies", "Shuttles", "Reviews"]
+
+### <a id="Flowthru_Meta_Models_StepMetadata_Label"></a> Label
+
+Human-readable display label for this step.
+
+```csharp
+[JsonPropertyName("label")]
+public required string Label { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+May be formatted for better display in Flowthru.Viz.
+Example: "Preprocess Companies", "Train Model"
+
+### <a id="Flowthru_Meta_Models_StepMetadata_Layer"></a> Layer
+
+Execution layer assigned by the dependency analyzer.
+
+```csharp
+[JsonPropertyName("layer")]
+public int Layer { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Remarks
+
+Layer 0 steps have no dependencies (read external data only).
+Layer N steps depend only on steps in layers 0..N-1.
+
+### <a id="Flowthru_Meta_Models_StepMetadata_Outputs"></a> Outputs
+
+List of catalog entry keys this step writes to.
+
+```csharp
+[JsonPropertyName("outputs")]
+public List<string> Outputs { get; init; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+#### Remarks
+
+For multi-output steps using CatalogMap, this contains all mapped entries.
+Example: ["XTrain", "XTest", "YTrain", "YTest"]
+
+### <a id="Flowthru_Meta_Models_StepMetadata_StepType"></a> StepType
+
+The C# class type name implementing this step.
+
+```csharp
+[JsonPropertyName("stepType")]
+public required string StepType { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Simple type name without namespace or generic parameters.
+Example: "PreprocessCompaniesStep", "TrainModelStep"
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.md
new file mode 100644
index 00000000..3a3badf0
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Models.md
@@ -0,0 +1,32 @@
+# <a id="Flowthru_Meta_Models"></a> Namespace Flowthru.Meta.Models
+
+### Classes
+
+ [DagMetadata](Flowthru.Meta.Models.DagMetadata.md)
+
+Root metadata model representing a complete FlowthruService DAG (Directed Acyclic Graph).
+
+ [DagSliceMetadata](Flowthru.Meta.Models.DagSliceMetadata.md)
+
+Metadata describing how a pipeline was sliced during execution.
+
+ [EdgeMetadata](Flowthru.Meta.Models.EdgeMetadata.md)
+
+Metadata describing an edge in the pipeline DAG.
+
+ [ItemMetadata](Flowthru.Meta.Models.ItemMetadata.md)
+
+Metadata describing a single catalog item (dataset, json object, API response, whatever) in the flow.
+
+ [SchemaField](Flowthru.Meta.Models.SchemaField.md)
+
+A single field (property) in a schema.
+
+ [SchemaMetadata](Flowthru.Meta.Models.SchemaMetadata.md)
+
+Schema information for a data type.
+
+ [StepMetadata](Flowthru.Meta.Models.StepMetadata.md)
+
+Metadata describing a single step in the flow DAG.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Providers.IMetadataProvider.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Providers.IMetadataProvider.md
new file mode 100644
index 00000000..9c09f3c4
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Providers.IMetadataProvider.md
@@ -0,0 +1,79 @@
+# <a id="Flowthru_Meta_Providers_IMetadataProvider"></a> Interface IMetadataProvider
+
+Namespace: [Flowthru.Meta.Providers](Flowthru.Meta.Providers.md)  
+Assembly: Flowthru.Core.dll  
+
+Interface for metadata consumers.
+
+```csharp
+public interface IMetadataProvider
+```
+
+## Remarks
+
+<p>
+Metadata providers receive DAG metadata after pipeline builds and can
+process it in any way: write files, send to APIs, store in memory, etc.
+</p>
+<p>
+<strong>Built-in Providers:</strong>
+</p>
+<ul><li><xref href="Flowthru.Meta.Providers.JsonMetadataProvider" data-throw-if-not-resolved="false"></xref> - Exports JSON files</li><li><xref href="Flowthru.Meta.Providers.MermaidMetadataProvider" data-throw-if-not-resolved="false"></xref> - Exports Mermaid diagrams</li></ul>
+<p>
+<strong>Custom Provider Example:</strong>
+</p>
+<pre><code class="lang-csharp">public class DashboardMetadataProvider : IMetadataProvider
+{
+  private readonly IDashboardClient _client;
+
+  public DashboardMetadataProvider(IDashboardClient client)
+  {
+    _client = client;
+  }
+
+  public string Name =&gt; "Dashboard";
+
+  public void Consume(DagMetadata dag)
+  {
+    _client.SendVisualization(dag);
+  }
+}</code></pre>
+
+## Properties
+
+### <a id="Flowthru_Meta_Providers_IMetadataProvider_Name"></a> Name
+
+Gets the unique name of this provider.
+
+```csharp
+string Name { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+## Methods
+
+### <a id="Flowthru_Meta_Providers_IMetadataProvider_Consume_Flowthru_Meta_Models_DagMetadata_"></a> Consume\(DagMetadata\)
+
+Consumes DAG metadata.
+
+```csharp
+void Consume(DagMetadata dag)
+```
+
+#### Parameters
+
+`dag` [DagMetadata](Flowthru.Meta.Models.DagMetadata.md)
+
+The DAG metadata to consume
+
+#### Remarks
+
+This method is called after pipeline builds. Providers can process
+the metadata in any way: write files, send to APIs, store in memory, etc.
+
+Implementations should handle their own error recovery - exceptions thrown
+from this method will be logged but will not fail the pipeline execution.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Providers.JsonMetadataProvider.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Providers.JsonMetadataProvider.md
new file mode 100644
index 00000000..af07616e
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Providers.JsonMetadataProvider.md
@@ -0,0 +1,107 @@
+# <a id="Flowthru_Meta_Providers_JsonMetadataProvider"></a> Class JsonMetadataProvider
+
+Namespace: [Flowthru.Meta.Providers](Flowthru.Meta.Providers.md)  
+Assembly: Flowthru.Core.dll  
+
+Exports DAG metadata as JSON files.
+
+```csharp
+[MetadataProviderBuilder(typeof(JsonMetadataProviderBuilder))]
+public class JsonMetadataProvider : IMetadataProvider
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[JsonMetadataProvider](Flowthru.Meta.Providers.JsonMetadataProvider.md)
+
+#### Implements
+
+[IMetadataProvider](Flowthru.Meta.Providers.IMetadataProvider.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+This provider creates timestamped JSON files containing the complete DAG structure
+(nodes, catalog entries, edges, schema information) for consumption by Flowthru.Viz
+or other visualization tools.
+
+## Constructors
+
+### <a id="Flowthru_Meta_Providers_JsonMetadataProvider__ctor_System_String_System_String_Flowthru_Meta_TimestampConfiguration_System_Boolean_Microsoft_Extensions_Logging_ILogger_"></a> JsonMetadataProvider\(string, string, TimestampConfiguration, bool, ILogger?\)
+
+Initializes a new JSON metadata provider.
+
+```csharp
+public JsonMetadataProvider(string outputDirectory, string filenameTemplate, TimestampConfiguration timestampConfig, bool useCompactFormat = false, ILogger? logger = null)
+```
+
+#### Parameters
+
+`outputDirectory` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Directory to write JSON files to
+
+`filenameTemplate` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Template for generating output filenames
+
+`timestampConfig` [TimestampConfiguration](Flowthru.Meta.TimestampConfiguration.md)
+
+Configuration for timestamp handling in filenames
+
+`useCompactFormat` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+Whether to use compact (minified) JSON format
+
+`logger` [ILogger](https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger)?
+
+Optional logger for diagnostic messages
+
+## Properties
+
+### <a id="Flowthru_Meta_Providers_JsonMetadataProvider_Name"></a> Name
+
+Gets the unique name of this provider.
+
+```csharp
+public string Name { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+## Methods
+
+### <a id="Flowthru_Meta_Providers_JsonMetadataProvider_Consume_Flowthru_Meta_Models_DagMetadata_"></a> Consume\(DagMetadata\)
+
+Consumes DAG metadata.
+
+```csharp
+public void Consume(DagMetadata dag)
+```
+
+#### Parameters
+
+`dag` [DagMetadata](Flowthru.Meta.Models.DagMetadata.md)
+
+The DAG metadata to consume
+
+#### Remarks
+
+This method is called after pipeline builds. Providers can process
+the metadata in any way: write files, send to APIs, store in memory, etc.
+
+Implementations should handle their own error recovery - exceptions thrown
+from this method will be logged but will not fail the pipeline execution.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Providers.MermaidMetadataProvider.MermaidFlowchartDirection.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Providers.MermaidMetadataProvider.MermaidFlowchartDirection.md
new file mode 100644
index 00000000..1d11d685
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Providers.MermaidMetadataProvider.MermaidFlowchartDirection.md
@@ -0,0 +1,37 @@
+# <a id="Flowthru_Meta_Providers_MermaidMetadataProvider_MermaidFlowchartDirection"></a> Enum MermaidMetadataProvider.MermaidFlowchartDirection
+
+Namespace: [Flowthru.Meta.Providers](Flowthru.Meta.Providers.md)  
+Assembly: Flowthru.Core.dll  
+
+Flow direction for Mermaid flowcharts.
+
+```csharp
+public enum MermaidMetadataProvider.MermaidFlowchartDirection
+```
+
+## Fields
+
+`BottomToTop = 2` 
+
+Bottom to Top
+
+
+
+`LeftToRight = 1` 
+
+Left to Right
+
+
+
+`RightToLeft = 3` 
+
+Right to Left
+
+
+
+`TopToBottom = 0` 
+
+Top to Bottom (default)
+
+
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Providers.MermaidMetadataProvider.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Providers.MermaidMetadataProvider.md
new file mode 100644
index 00000000..9cac2ee7
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Providers.MermaidMetadataProvider.md
@@ -0,0 +1,114 @@
+# <a id="Flowthru_Meta_Providers_MermaidMetadataProvider"></a> Class MermaidMetadataProvider
+
+Namespace: [Flowthru.Meta.Providers](Flowthru.Meta.Providers.md)  
+Assembly: Flowthru.Core.dll  
+
+Exports DAG metadata as Mermaid flowchart diagrams.
+
+```csharp
+[MetadataProviderBuilder(typeof(MermaidMetadataProviderBuilder))]
+public class MermaidMetadataProvider : IMetadataProvider
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[MermaidMetadataProvider](Flowthru.Meta.Providers.MermaidMetadataProvider.md)
+
+#### Implements
+
+[IMetadataProvider](Flowthru.Meta.Providers.IMetadataProvider.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+This provider creates Markdown files containing Mermaid flowchart diagrams
+for immediate visualization in GitHub, VS Code, and other Mermaid-compatible viewers.
+
+## Constructors
+
+### <a id="Flowthru_Meta_Providers_MermaidMetadataProvider__ctor_System_String_System_String_Flowthru_Meta_TimestampConfiguration_Flowthru_Meta_Providers_MermaidMetadataProvider_MermaidFlowchartDirection_System_String_System_String_Microsoft_Extensions_Logging_ILogger_"></a> MermaidMetadataProvider\(string, string, TimestampConfiguration, MermaidFlowchartDirection, string, string, ILogger?\)
+
+Initializes a new Mermaid metadata provider.
+
+```csharp
+public MermaidMetadataProvider(string outputDirectory, string filenameTemplate, TimestampConfiguration timestampConfig, MermaidMetadataProvider.MermaidFlowchartDirection direction = MermaidFlowchartDirection.TopToBottom, string activeNodeColor = "#2E7D32", string activeDataColor = "#2E7D32", ILogger? logger = null)
+```
+
+#### Parameters
+
+`outputDirectory` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Directory to write Mermaid files to
+
+`filenameTemplate` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Template for generating output filenames
+
+`timestampConfig` [TimestampConfiguration](Flowthru.Meta.TimestampConfiguration.md)
+
+Configuration for timestamp handling in filenames
+
+`direction` [MermaidMetadataProvider](Flowthru.Meta.Providers.MermaidMetadataProvider.md).[MermaidFlowchartDirection](Flowthru.Meta.Providers.MermaidMetadataProvider.MermaidFlowchartDirection.md)
+
+Flow direction for the diagram
+
+`activeNodeColor` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Hex color for active (sliced) nodes
+
+`activeDataColor` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Hex color for active (sliced) catalog entries
+
+`logger` [ILogger](https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger)?
+
+Optional logger for diagnostic messages
+
+## Properties
+
+### <a id="Flowthru_Meta_Providers_MermaidMetadataProvider_Name"></a> Name
+
+Gets the unique name of this provider.
+
+```csharp
+public string Name { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+## Methods
+
+### <a id="Flowthru_Meta_Providers_MermaidMetadataProvider_Consume_Flowthru_Meta_Models_DagMetadata_"></a> Consume\(DagMetadata\)
+
+Consumes DAG metadata.
+
+```csharp
+public void Consume(DagMetadata dag)
+```
+
+#### Parameters
+
+`dag` [DagMetadata](Flowthru.Meta.Models.DagMetadata.md)
+
+The DAG metadata to consume
+
+#### Remarks
+
+This method is called after pipeline builds. Providers can process
+the metadata in any way: write files, send to APIs, store in memory, etc.
+
+Implementations should handle their own error recovery - exceptions thrown
+from this method will be logged but will not fail the pipeline execution.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Providers.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Providers.md
new file mode 100644
index 00000000..958ddda7
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.Providers.md
@@ -0,0 +1,24 @@
+# <a id="Flowthru_Meta_Providers"></a> Namespace Flowthru.Meta.Providers
+
+### Classes
+
+ [JsonMetadataProvider](Flowthru.Meta.Providers.JsonMetadataProvider.md)
+
+Exports DAG metadata as JSON files.
+
+ [MermaidMetadataProvider](Flowthru.Meta.Providers.MermaidMetadataProvider.md)
+
+Exports DAG metadata as Mermaid flowchart diagrams.
+
+### Interfaces
+
+ [IMetadataProvider](Flowthru.Meta.Providers.IMetadataProvider.md)
+
+Interface for metadata consumers.
+
+### Enums
+
+ [MermaidMetadataProvider.MermaidFlowchartDirection](Flowthru.Meta.Providers.MermaidMetadataProvider.MermaidFlowchartDirection.md)
+
+Flow direction for Mermaid flowcharts.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.TimestampConfiguration.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.TimestampConfiguration.md
new file mode 100644
index 00000000..e46b4c8e
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.TimestampConfiguration.md
@@ -0,0 +1,82 @@
+# <a id="Flowthru_Meta_TimestampConfiguration"></a> Class TimestampConfiguration
+
+Namespace: [Flowthru.Meta](Flowthru.Meta.md)  
+Assembly: Flowthru.Core.dll  
+
+Configuration for timestamp handling in metadata file exports.
+
+```csharp
+public class TimestampConfiguration
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[TimestampConfiguration](Flowthru.Meta.TimestampConfiguration.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+Controls whether and how timestamps are included in metadata filenames.
+This configuration applies to all metadata providers (JSON, Mermaid, etc.)
+to ensure consistent filename generation.
+</p>
+<p>
+<strong>Default behavior:</strong> Timestamps are included with format "yyyyMMdd-HHmmss"
+</p>
+<p>
+<strong>Example filenames:</strong>
+</p>
+<ul><li>With timestamp: <code>dag-DataProcessing-20251024-143052.json</code></li><li>Without timestamp: <code>dag-DataProcessing.json</code></li></ul>
+<p>
+<strong>Warning:</strong> When timestamps are disabled, subsequent exports will overwrite
+previous files with the same pipeline name.
+</p>
+
+## Properties
+
+### <a id="Flowthru_Meta_TimestampConfiguration_Format"></a> Format
+
+Gets or sets the timestamp format string.
+
+```csharp
+public string Format { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+Default: "yyyyMMdd-HHmmss" (e.g., "20251024-143052")
+Must be a valid DateTime format string compatible with DateTime.ToString().
+Only used when IncludeTimestamp is true.
+
+### <a id="Flowthru_Meta_TimestampConfiguration_IncludeTimestamp"></a> IncludeTimestamp
+
+Gets or sets whether to include timestamps in metadata filenames.
+
+```csharp
+public bool IncludeTimestamp { get; set; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+Default: true
+When false, files will be named without timestamps and will overwrite on each export.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.md
new file mode 100644
index 00000000..33c9bb1a
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Meta.md
@@ -0,0 +1,42 @@
+# <a id="Flowthru_Meta"></a> Namespace Flowthru.Meta
+
+### Namespaces
+
+ [Flowthru.Meta.Models](Flowthru.Meta.Models.md)
+
+ [Flowthru.Meta.Providers](Flowthru.Meta.Providers.md)
+
+### Classes
+
+ [FlowthruMetadataBuilder](Flowthru.Meta.FlowthruMetadataBuilder.md)
+
+Fluent builder for configuring metadata providers and export settings.
+
+ [FlowthruMetadataConfiguration](Flowthru.Meta.FlowthruMetadataConfiguration.md)
+
+Configuration for Flowthru metadata collection and export.
+
+ [JsonMetadataProviderBuilder](Flowthru.Meta.JsonMetadataProviderBuilder.md)
+
+Builder for configuring JSON metadata provider options.
+
+ [MermaidMetadataExtensions](Flowthru.Meta.MermaidMetadataExtensions.md)
+
+Extension methods for generating Mermaid diagram representations of DAG metadata.
+
+ [MermaidMetadataProviderBuilder](Flowthru.Meta.MermaidMetadataProviderBuilder.md)
+
+Builder for configuring Mermaid diagram provider options.
+
+ [MetadataJsonExtensions](Flowthru.Meta.MetadataJsonExtensions.md)
+
+Extension methods for serializing metadata to JSON.
+
+ [MetadataProviderBuilderAttribute](Flowthru.Meta.MetadataProviderBuilderAttribute.md)
+
+Specifies the builder type for a metadata provider.
+
+ [TimestampConfiguration](Flowthru.Meta.TimestampConfiguration.md)
+
+Configuration for timestamp handling in metadata file exports.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.Factory.NodeFactory.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.Factory.NodeFactory.md
new file mode 100644
index 00000000..d6cb369e
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.Factory.NodeFactory.md
@@ -0,0 +1,74 @@
+# <a id="Flowthru_Nodes_Factory_NodeFactory"></a> Class NodeFactory
+
+Namespace: [Flowthru.Steps.Factory](Flowthru.Steps.Factory.md)  
+Assembly: Flowthru.Core.dll  
+
+Factory for creating node instances using TypeActivator.
+
+```csharp
+public static class NodeFactory
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[NodeFactory](Flowthru.Steps.Factory.NodeFactory.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Design Pattern:</strong> Factory Pattern - provides a centralized location for
+node instantiation logic.
+</p>
+<p>
+This is a thin wrapper around TypeActivator, providing a domain-specific API for
+creating nodes. Could be extended in the future with:
+- Node validation logic
+- Pre/post-creation hooks
+- Node decoration/wrapping
+</p>
+
+## Methods
+
+### <a id="Flowthru_Nodes_Factory_NodeFactory_Create__1"></a> Create<TNode\>\(\)
+
+Creates a new instance of the specified node type.
+
+```csharp
+public static TNode Create<TNode>() where TNode : new()
+```
+
+#### Returns
+
+ TNode
+
+A new node instance
+
+#### Type Parameters
+
+`TNode` 
+
+The node type to instantiate
+
+#### Remarks
+
+<p>
+<strong>Requirements:</strong>
+- TNode must inherit from NodeBase&lt;TInput, TOutput&gt;
+- TNode must have a parameterless constructor
+</p>
+<p>
+These requirements are enforced at compile-time via generic constraints in
+FlowBuilder.AddStep methods.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.Factory.TypeActivator.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.Factory.TypeActivator.md
new file mode 100644
index 00000000..a3aa03b5
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.Factory.TypeActivator.md
@@ -0,0 +1,114 @@
+# <a id="Flowthru_Nodes_Factory_TypeActivator"></a> Class TypeActivator
+
+Namespace: [Flowthru.Steps.Factory](Flowthru.Steps.Factory.md)  
+Assembly: Flowthru.Core.dll  
+
+Factory for creating instances of types using compiled expression trees for performance.
+
+```csharp
+public static class TypeActivator
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[TypeActivator](Flowthru.Steps.Factory.TypeActivator.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Design Pattern:</strong> Factory Pattern with caching - creates instances of types
+using reflection on first call, then caches compiled expression trees for subsequent calls.
+</p>
+<p>
+<strong>Performance:</strong>
+- First call uses Expression.Compile() which has overhead
+- Subsequent calls use cached delegate which is nearly as fast as `new T()`
+- Significantly faster than Activator.CreateInstance&lt;T&gt;() for repeated calls
+</p>
+<p>
+<strong>Inspiration:</strong> ChainSharp uses similar pattern for node instantiation.
+</p>
+<p>
+<strong>Thread Safety:</strong> This class is thread-safe. Multiple threads can safely
+call Create&lt;T&gt;() concurrently.
+</p>
+
+## Properties
+
+### <a id="Flowthru_Nodes_Factory_TypeActivator_CacheCount"></a> CacheCount
+
+Gets the number of cached factory functions.
+
+```csharp
+public static int CacheCount { get; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+## Methods
+
+### <a id="Flowthru_Nodes_Factory_TypeActivator_ClearCache"></a> ClearCache\(\)
+
+Clears the factory cache.
+
+```csharp
+public static void ClearCache()
+```
+
+#### Remarks
+
+Useful for testing or memory management in long-running applications
+that dynamically load/unload types.
+
+### <a id="Flowthru_Nodes_Factory_TypeActivator_Create__1"></a> Create<T\>\(\)
+
+Creates an instance of type <code class="typeparamref">T</code> using a cached factory.
+
+```csharp
+public static T Create<T>() where T : new()
+```
+
+#### Returns
+
+ T
+
+A new instance of type T
+
+#### Type Parameters
+
+`T` 
+
+The type to instantiate (must have parameterless constructor)
+
+#### Remarks
+
+<p>
+<strong>Compile-Time Safety:</strong> The `new()` constraint ensures that T has a
+parameterless constructor. This is enforced at compile-time by the C# compiler.
+</p>
+<p>
+<strong>Caching Strategy:</strong>
+- First call: Compiles an expression tree and caches the resulting delegate
+- Subsequent calls: Reuses the cached delegate
+- One cache entry per type T
+</p>
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if type T does not have a parameterless constructor
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.Factory.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.Factory.md
new file mode 100644
index 00000000..1474665c
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.Factory.md
@@ -0,0 +1,12 @@
+# <a id="Flowthru_Nodes_Factory"></a> Namespace Flowthru.Steps.Factory
+
+### Classes
+
+ [NodeFactory](Flowthru.Steps.Factory.NodeFactory.md)
+
+Factory for creating node instances using TypeActivator.
+
+ [TypeActivator](Flowthru.Steps.Factory.TypeActivator.md)
+
+Factory for creating instances of types using compiled expression trees for performance.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.NoData.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.NoData.md
new file mode 100644
index 00000000..750098f2
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.NoData.md
@@ -0,0 +1,182 @@
+# <a id="Flowthru_Nodes_NoData"></a> Class NoData
+
+Namespace: [Flowthru.Steps](Flowthru.Steps.md)  
+Assembly: Flowthru.Core.dll  
+
+Marker type representing "no meaningful data" for nodes with side-effects or data generation.
+Used as input/output type in NodeBase when a node doesn't consume or produce meaningful data.
+
+```csharp
+public sealed class NoData
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[NoData](Flowthru.Steps.NoData.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Design Rationale:</strong> NoData provides a type-safe way to represent nodes that:
+- Generate data without inputs (e.g., synthetic data generation, seeding)
+- Perform side-effects without outputs (e.g., validation, logging, diagnostics)
+</p>
+<p>
+This pattern is inspired by functional programming's "Unit" type but uses more intuitive
+naming for .NET developers unfamiliar with functional terminology.
+</p>
+<p>
+<strong>Usage Examples:</strong>
+</p>
+<pre><code class="lang-csharp">// Node with no inputs (data generation)
+public class GenerateDataNode : NodeBase&lt;NoData, OutputSchema&gt;
+{
+    protected override Task&lt;IEnumerable&lt;OutputSchema&gt;&gt; Transform(IEnumerable&lt;NoData&gt; input)
+    {
+        // Generate data from scratch...
+        return Task.FromResult(generatedData);
+    }
+}
+
+// Node with no outputs (side-effects only)
+public class ValidateNode : NodeBase&lt;InputSchema, NoData&gt;
+{
+    protected override Task&lt;IEnumerable&lt;NoData&gt;&gt; Transform(IEnumerable&lt;InputSchema&gt; input)
+    {
+        // Perform validation, logging, etc...
+        return Task.FromResult(Enumerable.Repeat(NoData.Value, 1));
+    }
+}</code></pre>
+<p>
+<strong>Pipeline Registration:</strong> Use NoData type directly - it automatically converts
+to a unique NullCatalogDataset instance:
+</p>
+<pre><code class="lang-csharp">// Simple syntax with automatic unique key generation
+pipeline.AddStep&lt;ValidationNode&gt;(
+    input: catalog.InputData,
+    output: NoData.Output  // or just: NoData.Discard
+);
+
+pipeline.AddStep&lt;GenerateDataNode&gt;(
+    input: NoData.Input,  // or just: NoData.None
+    output: catalog.GeneratedData
+);</code></pre>
+
+## Fields
+
+### <a id="Flowthru_Nodes_NoData_Value"></a> Value
+
+Singleton instance of NoData.
+Use this value when returning NoData from node transformations.
+
+```csharp
+public static readonly NoData Value
+```
+
+#### Field Value
+
+ [NoData](Flowthru.Steps.NoData.md)
+
+## Properties
+
+### <a id="Flowthru_Nodes_NoData_Discard"></a> Discard
+
+Creates a unique null catalog entry for use as a node output (side-effect-only nodes).
+Semantic alias for Output - use whichever reads better in context.
+
+```csharp
+public static IItem<NoData> Discard { get; }
+```
+
+#### Property Value
+
+ [IItem](Flowthru.Data.IItem\-1.md)<[NoData](Flowthru.Steps.NoData.md)\>
+
+### <a id="Flowthru_Nodes_NoData_Input"></a> Input
+
+Creates a unique null catalog entry for use as a node input (no-input nodes).
+Each call generates a new instance with a unique key to avoid DAG conflicts.
+
+```csharp
+public static IItem<NoData> Input { get; }
+```
+
+#### Property Value
+
+ [IItem](Flowthru.Data.IItem\-1.md)<[NoData](Flowthru.Steps.NoData.md)\>
+
+#### Remarks
+
+Alias for readability in pipeline declarations where nodes don't consume external inputs.
+
+### <a id="Flowthru_Nodes_NoData_None"></a> None
+
+Creates a unique null catalog entry for use as a node input (no-input nodes).
+Semantic alias for Input - use whichever reads better in context.
+
+```csharp
+public static IItem<NoData> None { get; }
+```
+
+#### Property Value
+
+ [IItem](Flowthru.Data.IItem\-1.md)<[NoData](Flowthru.Steps.NoData.md)\>
+
+### <a id="Flowthru_Nodes_NoData_Output"></a> Output
+
+Creates a unique null catalog entry for use as a node output (side-effect-only nodes).
+Each call generates a new instance with a unique key to avoid DAG conflicts.
+
+```csharp
+public static IItem<NoData> Output { get; }
+```
+
+#### Property Value
+
+ [IItem](Flowthru.Data.IItem\-1.md)<[NoData](Flowthru.Steps.NoData.md)\>
+
+#### Remarks
+
+Alias for readability in pipeline declarations where nodes produce no meaningful output.
+
+## Methods
+
+### <a id="Flowthru_Nodes_NoData_Result"></a> Result\(\)
+
+Returns the standard NoData result for side-effect-only nodes.
+Use this at the end of Transform() methods that return NoData.
+
+```csharp
+public static Task<IEnumerable<NoData>> Result()
+```
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<[NoData](Flowthru.Steps.NoData.md)\>\>
+
+Singleton collection containing NoData.Value
+
+#### Remarks
+
+<p>
+This helper eliminates the verbose <code>Task.FromResult(Enumerable.Repeat(NoData.Value, 1))</code>
+boilerplate. Simply return <code>NoData.Result()</code>.
+</p>
+<example>
+<pre><code class="lang-csharp">// Instead of:
+return Task.FromResult(Enumerable.Repeat(NoData.Value, 1));
+
+// Use:
+return NoData.Result();</code></pre>
+</example>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.NoParams.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.NoParams.md
new file mode 100644
index 00000000..0c65f916
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.NoParams.md
@@ -0,0 +1,49 @@
+# <a id="Flowthru_Nodes_NoParams"></a> Class NoParams
+
+Namespace: [Flowthru.Steps](Flowthru.Steps.md)  
+Assembly: Flowthru.Core.dll  
+
+Marker type for nodes that don't require parameters.
+Used as the default TParameters type in NodeBase&lt;TInput, TOutput, TParameters&gt;.
+
+```csharp
+public sealed class NoParams
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[NoParams](Flowthru.Steps.NoParams.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+This is a simple empty class that serves as a shorthand for users and the library
+when no parameters are needed for a node. Nodes that don't need configuration can
+omit the third type parameter by using the two-parameter NodeBase&lt;TInput, TOutput&gt;
+convenience base class.
+</p>
+<p>
+<strong>Usage Examples:</strong>
+</p>
+<pre><code class="lang-csharp">// Explicit NoParams (rarely needed)
+public class MyNode : NodeBase&lt;Input, Output, NoParams&gt; { }
+
+// Recommended: Use two-parameter base class
+public class MyNode : NodeBase&lt;Input, Output&gt; { }
+
+// With parameters
+public class ConfigurableNode : NodeBase&lt;Input, Output, MyParameters&gt;
+{
+    // Parameters property is automatically available
+}</code></pre>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.md
new file mode 100644
index 00000000..78f123b1
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Nodes.md
@@ -0,0 +1,18 @@
+# <a id="Flowthru_Nodes"></a> Namespace Flowthru.Steps
+
+### Namespaces
+
+ [Flowthru.Steps.Factory](Flowthru.Steps.Factory.md)
+
+### Classes
+
+ [NoData](Flowthru.Steps.NoData.md)
+
+Marker type representing "no meaningful data" for nodes with side-effects or data generation.
+Used as input/output type in NodeBase when a node doesn't consume or produce meaningful data.
+
+ [NoParams](Flowthru.Steps.NoParams.md)
+
+Marker type for nodes that don't require parameters.
+Used as the default TParameters type in NodeBase&lt;TInput, TOutput, TParameters&gt;.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.DryRunOption.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.DryRunOption.md
new file mode 100644
index 00000000..49f4e9a6
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.DryRunOption.md
@@ -0,0 +1,89 @@
+# <a id="Flowthru_Pipelines_DryRunOption"></a> Struct DryRunOption
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Represents a dry-run configuration. Can be assigned from a <xref href="System.Boolean" data-throw-if-not-resolved="false"></xref>
+or a <xref href="Flowthru.Flows.ValidationDepth" data-throw-if-not-resolved="false"></xref> value.
+
+```csharp
+public readonly struct DryRunOption
+```
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Assigning <code>true</code> enables a full dry run (all pre-flight checks, no execution).
+Assigning <code>false</code> disables dry-run mode entirely.
+Assigning a <xref href="Flowthru.Flows.ValidationDepth" data-throw-if-not-resolved="false"></xref> enables dry-run at the specified depth.
+
+## Properties
+
+### <a id="Flowthru_Pipelines_DryRunOption_Depth"></a> Depth
+
+The validation depth applied when dry-run is enabled.
+
+```csharp
+public ValidationDepth Depth { get; }
+```
+
+#### Property Value
+
+ [ValidationDepth](Flowthru.Flows.ValidationDepth.md)
+
+### <a id="Flowthru_Pipelines_DryRunOption_Enabled"></a> Enabled
+
+Whether dry-run mode is enabled.
+
+```csharp
+public bool Enabled { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+## Operators
+
+### <a id="Flowthru_Pipelines_DryRunOption_op_Implicit_System_Boolean__Flowthru_Pipelines_DryRunOption"></a> implicit operator DryRunOption\(bool\)
+
+Implicitly converts a <xref href="System.Boolean" data-throw-if-not-resolved="false"></xref> to a <xref href="Flowthru.Flows.DryRunOption" data-throw-if-not-resolved="false"></xref>.
+<code>true</code> enables full dry-run; <code>false</code> disables it.
+
+```csharp
+public static implicit operator DryRunOption(bool value)
+```
+
+#### Parameters
+
+`value` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Returns
+
+ [DryRunOption](Flowthru.Flows.DryRunOption.md)
+
+### <a id="Flowthru_Pipelines_DryRunOption_op_Implicit_Flowthru_Pipelines_ValidationDepth__Flowthru_Pipelines_DryRunOption"></a> implicit operator DryRunOption\(ValidationDepth\)
+
+Implicitly converts a <xref href="Flowthru.Flows.ValidationDepth" data-throw-if-not-resolved="false"></xref> to a <xref href="Flowthru.Flows.DryRunOption" data-throw-if-not-resolved="false"></xref>,
+enabling dry-run at the specified depth.
+
+```csharp
+public static implicit operator DryRunOption(ValidationDepth depth)
+```
+
+#### Parameters
+
+`depth` [ValidationDepth](Flowthru.Flows.ValidationDepth.md)
+
+#### Returns
+
+ [DryRunOption](Flowthru.Flows.DryRunOption.md)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.ExecutionOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.ExecutionOptions.md
new file mode 100644
index 00000000..51ad8ce8
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.ExecutionOptions.md
@@ -0,0 +1,120 @@
+# <a id="Flowthru_Pipelines_ExecutionOptions"></a> Class ExecutionOptions
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Configuration options for pipeline execution.
+
+```csharp
+public class ExecutionOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ExecutionOptions](Flowthru.Flows.ExecutionOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Controls how pipelines are executed and how results are presented.
+
+## Properties
+
+### <a id="Flowthru_Pipelines_ExecutionOptions_DryRun"></a> DryRun
+
+Whether to perform a dry run, and at what validation depth.
+
+```csharp
+public DryRunOption DryRun { get; set; }
+```
+
+#### Property Value
+
+ [DryRunOption](Flowthru.Flows.DryRunOption.md)
+
+#### Remarks
+
+Assign <code>true</code> to perform all pre-flight operations (structure validation,
+validation hooks, and external data source inspection) without executing nodes.
+Assign a <xref href="Flowthru.Flows.ValidationDepth" data-throw-if-not-resolved="false"></xref> value to control how deeply the pre-flight
+checks run — for example, <xref href="Flowthru.Flows.ValidationDepth.StructureOnly" data-throw-if-not-resolved="false"></xref> validates
+the pipeline graph and runs extension hooks without probing any data sources.
+Assign <code>false</code> (default) to run normally without a dry-run stop.
+
+### <a id="Flowthru_Pipelines_ExecutionOptions_EnableParallelExecution"></a> EnableParallelExecution
+
+Whether to enable parallel execution of nodes within the same layer.
+
+```csharp
+public bool EnableParallelExecution { get; set; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+Phase 2 feature - currently not implemented.
+When true, nodes in the same execution layer run concurrently.
+
+### <a id="Flowthru_Pipelines_ExecutionOptions_ResultFormatter"></a> ResultFormatter
+
+The result formatter to use for displaying execution results.
+
+```csharp
+public IFlowResultFormatter? ResultFormatter { get; set; }
+```
+
+#### Property Value
+
+ [IFlowResultFormatter](Flowthru.Results.IFlowResultFormatter.md)?
+
+#### Remarks
+
+Defaults to ConsoleResultFormatter if not specified.
+
+### <a id="Flowthru_Pipelines_ExecutionOptions_SliceStrategy"></a> SliceStrategy
+
+Optional slicing strategy to apply when executing pipelines.
+
+```csharp
+public FlowSliceStrategy? SliceStrategy { get; set; }
+```
+
+#### Property Value
+
+ [FlowSliceStrategy](Flowthru.Flows.FlowSliceStrategy.md)?
+
+#### Remarks
+
+When provided, only nodes matching the slice strategy will be executed.
+Used when slicing flags are provided without a specific pipeline name.
+
+### <a id="Flowthru_Pipelines_ExecutionOptions_StopOnFirstError"></a> StopOnFirstError
+
+Whether to stop execution on the first node failure.
+
+```csharp
+public bool StopOnFirstError { get; set; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+When true (default), pipeline execution stops immediately when a node fails.
+When false, execution continues to independent nodes (Phase 2 feature).
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.NodeResult.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.NodeResult.md
new file mode 100644
index 00000000..cf5f79fb
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.NodeResult.md
@@ -0,0 +1,161 @@
+# <a id="Flowthru_Pipelines_NodeResult"></a> Class NodeResult
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Represents the execution result of a single pipeline node.
+
+```csharp
+public class NodeResult
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[NodeResult](Flowthru.Flows.NodeResult.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Properties
+
+### <a id="Flowthru_Pipelines_NodeResult_Exception"></a> Exception
+
+Exception that occurred during node execution, if any.
+
+```csharp
+public Exception? Exception { get; init; }
+```
+
+#### Property Value
+
+ [Exception](https://learn.microsoft.com/dotnet/api/system.exception)?
+
+#### Remarks
+
+Null if Success is true. Contains the exception that caused
+the node to fail if Success is false.
+
+### <a id="Flowthru_Pipelines_NodeResult_ExecutionTime"></a> ExecutionTime
+
+Execution time for this specific node.
+
+```csharp
+public TimeSpan ExecutionTime { get; init; }
+```
+
+#### Property Value
+
+ [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
+
+### <a id="Flowthru_Pipelines_NodeResult_InputCount"></a> InputCount
+
+Number of input items processed by this node.
+
+```csharp
+public int InputCount { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Remarks
+
+For multi-input nodes, this represents the total count across
+all input catalog entries.
+
+### <a id="Flowthru_Pipelines_NodeResult_NodeName"></a> NodeName
+
+The name of the node that was executed.
+
+```csharp
+public required string NodeName { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Pipelines_NodeResult_OutputCount"></a> OutputCount
+
+Number of output items produced by this node.
+
+```csharp
+public int OutputCount { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Remarks
+
+For multi-output nodes, this represents the total count across
+all output catalog entries.
+
+### <a id="Flowthru_Pipelines_NodeResult_Success"></a> Success
+
+Indicates whether the node executed successfully.
+
+```csharp
+public bool Success { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+## Methods
+
+### <a id="Flowthru_Pipelines_NodeResult_CreateFailure_System_String_System_TimeSpan_System_Exception_System_Int32_"></a> CreateFailure\(string, TimeSpan, Exception, int\)
+
+Creates a failed node result.
+
+```csharp
+public static NodeResult CreateFailure(string nodeName, TimeSpan executionTime, Exception exception, int inputCount = 0)
+```
+
+#### Parameters
+
+`nodeName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+`executionTime` [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
+
+`exception` [Exception](https://learn.microsoft.com/dotnet/api/system.exception)
+
+`inputCount` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Returns
+
+ [NodeResult](Flowthru.Flows.NodeResult.md)
+
+### <a id="Flowthru_Pipelines_NodeResult_CreateSuccess_System_String_System_TimeSpan_System_Int32_System_Int32_"></a> CreateSuccess\(string, TimeSpan, int, int\)
+
+Creates a successful node result.
+
+```csharp
+public static NodeResult CreateSuccess(string nodeName, TimeSpan executionTime, int inputCount, int outputCount)
+```
+
+#### Parameters
+
+`nodeName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+`executionTime` [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
+
+`inputCount` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+`outputCount` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Returns
+
+ [NodeResult](Flowthru.Flows.NodeResult.md)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.Pipeline.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.Pipeline.md
new file mode 100644
index 00000000..21c60194
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.Pipeline.md
@@ -0,0 +1,418 @@
+# <a id="Flowthru_Pipelines_Pipeline"></a> Class Pipeline
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Represents a complete data pipeline with nodes, dependencies, and execution order.
+
+```csharp
+public class Pipeline
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[Pipeline](Flowthru.Flows.Pipeline.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+A pipeline is a directed acyclic graph (DAG) of transformation nodes.
+Each node reads data from catalog entries, performs transformations,
+and writes results back to catalog entries.
+</p>
+<p>
+<strong>Execution Model:</strong>
+</p>
+<ul><li>Nodes are organized into layers via topological sort</li><li>Nodes in layer 0 have no dependencies (read external data only)</li><li>Nodes in layer N depend only on nodes in layers 0..N-1</li><li>Sequential execution: Execute all nodes in layer order</li><li>Parallel execution (Phase 2): Execute nodes within same layer concurrently</li></ul>
+<p>
+<strong>Single Producer Rule:</strong> Each catalog entry can be written by at most
+one node. This ensures deterministic execution order and prevents race conditions.
+</p>
+
+## Properties
+
+### <a id="Flowthru_Pipelines_Pipeline_Description"></a> Description
+
+Optional description of what this pipeline does.
+
+```csharp
+public string? Description { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Pipelines_Pipeline_IsBuilt"></a> IsBuilt
+
+Indicates whether the pipeline has been built (dependencies analyzed and layers assigned).
+
+```csharp
+public bool IsBuilt { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Pipelines_Pipeline_Logger"></a> Logger
+
+Optional logger for pipeline execution.
+
+```csharp
+public ILogger? Logger { get; set; }
+```
+
+#### Property Value
+
+ [ILogger](https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger)?
+
+### <a id="Flowthru_Pipelines_Pipeline_Name"></a> Name
+
+Pipeline name for identification and logging.
+
+```csharp
+public string? Name { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Remarks
+
+Set by PipelineRegistry during pipeline registration.
+
+### <a id="Flowthru_Pipelines_Pipeline_Nodes"></a> Nodes
+
+All nodes in this pipeline, in the order they were added.
+
+```csharp
+public IReadOnlyList<PipelineNode> Nodes { get; }
+```
+
+#### Property Value
+
+ [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[PipelineNode](Flowthru.Flows.PipelineNode.md)\>
+
+#### Remarks
+
+Exposed as public to enable validation hooks (Phase 4) to inspect nodes.
+The collection is read-only - nodes can only be added via FlowBuilder.
+
+### <a id="Flowthru_Pipelines_Pipeline_ServiceProvider"></a> ServiceProvider
+
+Optional service provider for dependency injection into nodes.
+
+```csharp
+public IServiceProvider? ServiceProvider { get; set; }
+```
+
+#### Property Value
+
+ [IServiceProvider](https://learn.microsoft.com/dotnet/api/system.iserviceprovider)?
+
+#### Remarks
+
+Set by the service layer before pipeline execution to enable nodes
+to resolve services (e.g., database connections, external APIs).
+
+### <a id="Flowthru_Pipelines_Pipeline_ValidationHooks"></a> ValidationHooks
+
+Validation hooks that run during pre-flight checks.
+
+```csharp
+public List<IPipelineValidationHook> ValidationHooks { get; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[IPipelineValidationHook](Flowthru.Flows.Validation.IPipelineValidationHook.md)\>
+
+#### Remarks
+
+<p>
+Extensions can register hooks to validate their own node types during pre-flight.
+Hooks are invoked after DAG analysis but before external input inspection.
+</p>
+<p>
+<strong>Hook execution order:</strong>
+</p>
+<ol><li>Pipeline.Build() - DAG construction and layer assignment</li><li>ValidationHooks.ValidateAsync() - Extension-specific validation</li><li>Pipeline.ValidateExternalInputsAsync() - External input inspection</li></ol>
+<p>
+<strong>Example (Python extension):</strong>
+</p>
+<pre><code class="lang-csharp">pipeline.ValidationHooks.Add(new PythonNodeValidator(executor, runtime));</code></pre>
+
+### <a id="Flowthru_Pipelines_Pipeline_ValidationOptions"></a> ValidationOptions
+
+Validation options for this pipeline.
+
+```csharp
+public ValidationOptions ValidationOptions { get; }
+```
+
+#### Property Value
+
+ [ValidationOptions](Flowthru.Flows.Validation.ValidationOptions.md)
+
+#### Remarks
+
+Configures how external data sources (Layer 0 inputs) are validated
+before pipeline execution begins.
+
+## Methods
+
+### <a id="Flowthru_Pipelines_Pipeline_Build_Flowthru_Pipelines_FlowSliceStrategy_"></a> Build\(FlowSliceStrategy?\)
+
+Builds the pipeline by analyzing dependencies and assigning execution layers.
+Must be called before executing the pipeline.
+
+```csharp
+public void Build(FlowSliceStrategy? sliceStrategy = null)
+```
+
+#### Parameters
+
+`sliceStrategy` [FlowSliceStrategy](Flowthru.Flows.FlowSliceStrategy.md)?
+
+Optional slicing strategy to filter nodes before execution
+
+#### Remarks
+
+<p>
+<strong>Slicing:</strong> If a slicing strategy is provided, only nodes matching
+the strategy will be included in the execution. The slice always forms a valid
+sub-DAG with all required dependencies.
+</p>
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if:
+- Multiple nodes write to the same catalog entry (single producer rule)
+- Circular dependency is detected
+- Slice strategy references non-existent nodes or catalog entries
+
+### <a id="Flowthru_Pipelines_Pipeline_ExecuteAsync_System_Threading_CancellationToken_"></a> ExecuteAsync\(CancellationToken\)
+
+Executes the pipeline sequentially, layer by layer.
+
+```csharp
+public Task ExecuteAsync(CancellationToken cancellationToken)
+```
+
+#### Parameters
+
+`cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+Cancellation token to signal graceful shutdown
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
+
+Task representing the pipeline execution
+
+#### Remarks
+
+<p>
+This method executes nodes in topological order:
+1. Execute all nodes in layer 0 sequentially
+2. Execute all nodes in layer 1 sequentially
+3. Continue until all layers are complete
+</p>
+<p>
+<strong>Note:</strong> This method throws exceptions on failure. For result-based
+execution with error handling, use RunAsync() instead.
+</p>
+<p>
+In Phase 2, this will be replaced with a parallel executor that can run
+nodes within the same layer concurrently.
+</p>
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if pipeline has not been built
+
+### <a id="Flowthru_Pipelines_Pipeline_ExportDag"></a> ExportDag\(\)
+
+Exports DAG metadata for this pipeline.
+
+```csharp
+public DagMetadata ExportDag()
+```
+
+#### Returns
+
+ [DagMetadata](Flowthru.Meta.Models.DagMetadata.md)
+
+Complete DAG metadata including nodes, catalog entries, and edges
+
+#### Remarks
+
+<p>
+This method extracts structural metadata from the built pipeline, creating
+a complete representation of the DAG (Directed Acyclic Graph) that can be
+serialized to JSON for visualization in Flowthru.Viz.
+</p>
+<p>
+<strong>Prerequisites:</strong> Pipeline must be built before calling this method.
+Call Build() first if IsBuilt is false.
+</p>
+<p>
+<strong>Usage:</strong>
+</p>
+<pre><code class="lang-csharp">var pipeline = DataProcessingPipeline.Create(catalog);
+pipeline.Build();
+
+var dag = pipeline.ExportDag();
+var json = dag.ToJson();
+File.WriteAllText("dag.json", json);</code></pre>
+<p>
+This method is non-destructive and idempotent - it can be called multiple
+times without affecting the pipeline state.
+</p>
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if pipeline has not been built
+
+### <a id="Flowthru_Pipelines_Pipeline_Merge_System_Collections_Generic_Dictionary_System_String_Flowthru_Pipelines_Pipeline__"></a> Merge\(Dictionary<string, Pipeline\>\)
+
+Merges multiple pipelines into a single pipeline by combining all their nodes.
+
+```csharp
+public static Pipeline Merge(Dictionary<string, Pipeline> pipelines)
+```
+
+#### Parameters
+
+`pipelines` [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [Pipeline](Flowthru.Flows.Pipeline.md)\>
+
+Dictionary of pipeline names to pipeline instances
+
+#### Returns
+
+ [Pipeline](Flowthru.Flows.Pipeline.md)
+
+A new pipeline containing all nodes from all input pipelines
+
+#### Remarks
+
+<p>
+This method creates a new pipeline by combining all nodes from the input pipelines.
+Node names are prefixed with their source pipeline name (e.g., "data_processing.PreprocessCompanies")
+to ensure uniqueness and maintain traceability in logs.
+</p>
+<p>
+The existing DependencyAnalyzer will automatically resolve cross-pipeline dependencies
+based on catalog entries. The single producer rule is enforced - if multiple pipelines
+attempt to write to the same catalog entry, Build() will throw an InvalidOperationException.
+</p>
+
+### <a id="Flowthru_Pipelines_Pipeline_RunAsync_System_Threading_CancellationToken_"></a> RunAsync\(CancellationToken\)
+
+/// Builds and executes the pipeline, returning comprehensive execution results.
+
+```csharp
+public Task<FlowResult> RunAsync(CancellationToken cancellationToken)
+```
+
+#### Parameters
+
+`cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+Cancellation token to signal graceful shutdown
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<[FlowResult](Flowthru.Flows.FlowResult.md)\>
+
+FlowResult containing execution status, timing, and node results
+
+#### Remarks
+
+<p>
+This is the primary high-level API for executing pipelines. It automatically
+calls Build() if the pipeline hasn't been built yet, then executes and tracks results.
+</p>
+
+### <a id="Flowthru_Pipelines_Pipeline_ValidateExternalInputsAsync_System_Threading_CancellationToken_"></a> ValidateExternalInputsAsync\(CancellationToken\)
+
+Validates all external inputs before pipeline execution.
+
+```csharp
+public Task<ValidationResult> ValidateExternalInputsAsync(CancellationToken cancellationToken = default)
+```
+
+#### Parameters
+
+`cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+Cancellation token for validation I/O operations
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+ValidationResult containing any errors found
+
+#### Remarks
+
+<p>
+This method inspects catalog entries that are consumed by the pipeline but not
+produced by any node in the execution set. These are pre-existing external data
+sources (files, databases, APIs) that must exist and be valid before the pipeline
+can execute.
+</p>
+<p>
+<strong>Slicing Support:</strong> In sliced pipelines, catalog entries that were
+produced by nodes outside the slice are correctly identified as external inputs
+and validated. This prevents runtime failures from missing intermediate data.
+</p>
+<p>
+<strong>Inspection Levels:</strong>
+</p>
+<ul><li><strong>None:</strong> Skip inspection entirely</li><li><strong>Shallow:</strong> Validate file exists, check headers/schema, deserialize sample rows</li><li><strong>Deep:</strong> Validate all rows in the dataset (expensive!)</li></ul>
+<p>
+<strong>Default Behavior:</strong>
+</p>
+<ul><li>If explicitly configured via WithValidation() → use that level</li><li>If entry has PreferredInspectionLevel set → use that level</li><li>Otherwise → Shallow (all storage adapters support inspection)</li></ul>
+<p>
+<strong>Important:</strong> Only external inputs are inspected. Intermediate pipeline
+outputs produced within the execution set are never inspected, as they don't exist yet.
+</p>
+<p>
+<strong>Usage:</strong>
+</p>
+<pre><code class="lang-csharp">pipeline.Build();
+var validationResult = await pipeline.ValidateExternalInputsAsync();
+if (!validationResult.IsValid) {
+  // Handle validation errors before execution
+  validationResult.ThrowIfInvalid();
+}
+await pipeline.RunAsync();</code></pre>
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if pipeline has not been built
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.PipelineBuilder.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.PipelineBuilder.md
new file mode 100644
index 00000000..c8b7a13d
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.PipelineBuilder.md
@@ -0,0 +1,9677 @@
+# <a id="Flowthru_Pipelines_FlowBuilder"></a> Class FlowBuilder
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Fluent builder for constructing type-safe data pipelines with function-based nodes.
+
+```csharp
+public class FlowBuilder
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Function-Based Design (v0.5.0):</strong>
+Nodes are pure transformation functions with compile-time type safety.
+Both synchronous and asynchronous functions are supported:
+- Sync: Func&lt;TInput, TOutput&gt;
+- Async: Func&lt;TInput, Task&lt;TOutput&gt;&gt;
+- Multi-input: Func&lt;(TIn1, TIn2, ...), TOutput&gt; or Task&lt;TOutput&gt;
+- Multi-output: Func&lt;TInput, (TOut1, TOut2, ...)&gt; or Task&lt;(TOut1, TOut2, ...)&gt;
+</p>
+<p>
+Use synchronous functions for pure data transformations. Use asynchronous functions
+only when your node performs I/O operations (external APIs, databases, etc.).
+</p>
+<p>
+The compiler infers all types from function signatures and validates catalog entry
+types at pipeline construction time, catching type mismatches before execution.
+</p>
+<p>
+<strong>Usage Patterns:</strong>
+</p>
+<pre><code class="lang-csharp">var pipeline = FlowBuilder.CreateFlow(builder =&gt;
+{
+    // Simple synchronous node
+    builder.AddStep(
+        name: "Preprocess",
+        transform: PreprocessNode.Create(),
+        input: catalog.RawData,
+        output: catalog.ProcessedData
+    );
+
+    // Multi-input node: tuple → single output
+    builder.AddStep(
+        name: "TrainModel",
+        transform: TrainModelNode.Create(),
+        input: (catalog.XTrain, catalog.YTrain),
+        output: catalog.Model
+    );
+
+    // Multi-output node: single input → tuple
+    builder.AddStep(
+        name: "SplitData",
+        transform: SplitDataNode.Create(),
+        input: catalog.Data,
+        output: (catalog.XTrain, catalog.XTest, catalog.YTrain, catalog.YTest)
+    );
+
+    // Asynchronous node (only when needed for I/O)
+    builder.AddStep(
+        name: "FetchExternalData",
+        transform: ExternalDataNode.Create(),
+        input: catalog.Config,
+        output: catalog.ExternalData
+    );
+});
+
+pipeline.Build();
+await pipeline.ExecuteAsync();</code></pre>
+
+## Methods
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__2_System_String_System_Func___0_System_Threading_Tasks_Task___1___Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__System_String_"></a> AddStep<TInput, TOutput\>\(string, Func<TInput, Task<TOutput\>\>, IItem<TInput\>, IItem<TOutput\>, string\)
+
+Adds a node with single input and single output (asynchronous transformation).
+All types are inferred from the transformation function signature.
+
+```csharp
+public FlowBuilder AddStep<TInput, TOutput>(string label, Func<TInput, Task<TOutput>> transform, IItem<TInput> input, IItem<TOutput> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TInput, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOutput\>\>
+
+Asynchronous transformation function from input to output
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TInput\>
+
+Catalog entry providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOutput\>
+
+Catalog entry to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TInput` 
+
+Input type (inferred from transform)
+
+`TOutput` 
+
+Output type (inferred from transform)
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__2_System_String_System_Func___0_System_Threading_CancellationToken_System_Threading_Tasks_Task___1___Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__System_String_"></a> AddStep<TInput, TOutput\>\(string, Func<TInput, CancellationToken, Task<TOutput\>\>, IItem<TInput\>, IItem<TOutput\>, string\)
+
+Adds a node with single input and single output (asynchronous transformation with cancellation support).
+All types are inferred from the transformation function signature.
+
+```csharp
+public FlowBuilder AddStep<TInput, TOutput>(string label, Func<TInput, CancellationToken, Task<TOutput>> transform, IItem<TInput> input, IItem<TOutput> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-3)<TInput, [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOutput\>\>
+
+Asynchronous transformation function from input to output with cancellation token
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TInput\>
+
+Catalog entry providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOutput\>
+
+Catalog entry to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TInput` 
+
+Input type (inferred from transform)
+
+`TOutput` 
+
+Output type (inferred from transform)
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__2_System_String_System_Func___0___1__Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__System_String_"></a> AddStep<TInput, TOutput\>\(string, Func<TInput, TOutput\>, IItem<TInput\>, IItem<TOutput\>, string\)
+
+Adds a node with single input and single output (synchronous transformation).
+All types are inferred from the transformation function signature.
+
+```csharp
+public FlowBuilder AddStep<TInput, TOutput>(string label, Func<TInput, TOutput> transform, IItem<TInput> input, IItem<TOutput> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TInput, TOutput\>
+
+Synchronous transformation function from input to output
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TInput\>
+
+Catalog entry providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOutput\>
+
+Catalog entry to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TInput` 
+
+Input type (inferred from transform)
+
+`TOutput` 
+
+Output type (inferred from transform)
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__2_System_String_System_Collections_Generic_IReadOnlyList_Flowthru_Data_IItem___0___Flowthru_Data_IItem___1__System_Func_System_Collections_Generic_IReadOnlyList___0____1__System_String_"></a> AddStep<TIn, TOut\>\(string, IReadOnlyList<IItem<TIn\>\>, IItem<TOut\>, Func<IReadOnlyList<TIn\>, TOut\>, string\)
+
+Adds a homogeneous fan-in node: N catalog entries of the same element type collapse
+into a single node whose transform receives all N loaded collections as a typed list.
+
+```csharp
+public FlowBuilder AddStep<TIn, TOut>(string label, IReadOnlyList<IItem<TIn>> inputs, IItem<TOut> output, Func<IReadOnlyList<TIn>, TOut> node, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`inputs` [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[IItem](Flowthru.Data.IItem\-1.md)<TIn\>\>
+
+Variable-length list of same-typed input entries
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut\>
+
+Catalog entry to store the merged result
+
+`node` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<TIn\>, TOut\>
+
+Transform function receiving all N loaded values as a typed read-only list
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional human-readable description
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn` 
+
+Element type of each input catalog entry
+
+`TOut` 
+
+Output type produced by the transform
+
+#### Remarks
+
+Use this when the number of inputs is not known at compile time — for example,
+aggregating per-partition catalogs constructed in a loop. The function receives
+<code>IReadOnlyList&lt;TIn&gt;</code> where each element corresponds to one input entry
+in declaration order. An empty inputs list is allowed but produces an empty list argument.
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__3_System_String_System_Func___0_System_Threading_Tasks_Task_System_ValueTuple___1___2____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_String_"></a> AddStep<TIn1, TOut1, TOut2\>\(string, Func<TIn1, Task<\(TOut1, TOut2\)\>\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 1 input and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2>(string label, Func<TIn1, Task<(TOut1, TOut2)>> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__3_System_String_System_Func___0_System_ValueTuple___1___2___Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_String_"></a> AddStep<TIn1, TOut1, TOut2\>\(string, Func<TIn1, \(TOut1, TOut2\)\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 1 input and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2>(string label, Func<TIn1, (TOut1, TOut2)> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__4_System_String_System_Func___0_System_Threading_Tasks_Task_System_ValueTuple___1___2___3____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3\>\(string, Func<TIn1, Task<\(TOut1, TOut2, TOut3\)\>\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 1 input and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3>(string label, Func<TIn1, Task<(TOut1, TOut2, TOut3)>> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__4_System_String_System_Func___0_System_ValueTuple___1___2___3___Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3\>\(string, Func<TIn1, \(TOut1, TOut2, TOut3\)\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 1 input and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3>(string label, Func<TIn1, (TOut1, TOut2, TOut3)> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__5_System_String_System_Func___0_System_Threading_Tasks_Task_System_ValueTuple___1___2___3___4____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4\>\(string, Func<TIn1, Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 1 input and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4>(string label, Func<TIn1, Task<(TOut1, TOut2, TOut3, TOut4)>> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__5_System_String_System_Func___0_System_ValueTuple___1___2___3___4___Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4\>\(string, Func<TIn1, \(TOut1, TOut2, TOut3, TOut4\)\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 1 input and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4>(string label, Func<TIn1, (TOut1, TOut2, TOut3, TOut4)> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__6_System_String_System_Func___0_System_Threading_Tasks_Task_System_ValueTuple___1___2___3___4___5____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<TIn1, Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 1 input and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<TIn1, Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__6_System_String_System_Func___0_System_ValueTuple___1___2___3___4___5___Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 1 input and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<TIn1, (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__7_System_String_System_Func___0_System_Threading_Tasks_Task_System_ValueTuple___1___2___3___4___5___6____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<TIn1, Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 1 input and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<TIn1, Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__7_System_String_System_Func___0_System_ValueTuple___1___2___3___4___5___6___Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 1 input and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<TIn1, (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__8_System_String_System_Func___0_System_Threading_Tasks_Task_System_ValueTuple___1___2___3___4___5___6___7____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<TIn1, Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 1 input and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<TIn1, Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__8_System_String_System_Func___0_System_ValueTuple___1___2___3___4___5___6___7___Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 1 input and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<TIn1, (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func___0_System_Threading_Tasks_Task_System_ValueTuple___1___2___3___4___5___6___7_System_ValueTuple___8_____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__System_ValueTuple_Flowthru_Data_IItem___8____System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<TIn1, Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 1 input and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<TIn1, Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func___0_System_ValueTuple___1___2___3___4___5___6___7_System_ValueTuple___8____Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__System_ValueTuple_Flowthru_Data_IItem___8____System_String_"></a> AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 1 input and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<TIn1, (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TIn1, \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` [IItem](Flowthru.Data.IItem\-1.md)<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__3_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task___2___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___Flowthru_Data_IItem___2__System_String_"></a> AddStep<TIn1, TIn2, TOut1\>\(string, Func<\(TIn1, TIn2\), Task<TOut1\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), IItem<TOut1\>, string\)
+
+Adds a node with 2 inputs and 1 output (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1>(string label, Func<(TIn1, TIn2), Task<TOut1>> transform, (IItem<TIn1>, IItem<TIn2>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOut1\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__3_System_String_System_Func_System_ValueTuple___0___1____2__System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___Flowthru_Data_IItem___2__System_String_"></a> AddStep<TIn1, TIn2, TOut1\>\(string, Func<\(TIn1, TIn2\), TOut1\>, \(IItem<TIn1\>, IItem<TIn2\>\), IItem<TOut1\>, string\)
+
+Adds a node with 2 inputs and 1 output (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1>(string label, Func<(TIn1, TIn2), TOut1> transform, (IItem<TIn1>, IItem<TIn2>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), TOut1\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__4_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task_System_ValueTuple___2___3____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2\), Task<\(TOut1, TOut2\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 2 inputs and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2>(string label, Func<(TIn1, TIn2), Task<(TOut1, TOut2)>> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__4_System_String_System_Func_System_ValueTuple___0___1__System_ValueTuple___2___3___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2\), \(TOut1, TOut2\)\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 2 inputs and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2>(string label, Func<(TIn1, TIn2), (TOut1, TOut2)> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__5_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task_System_ValueTuple___2___3___4____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2\), Task<\(TOut1, TOut2, TOut3\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 2 inputs and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2), Task<(TOut1, TOut2, TOut3)>> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__5_System_String_System_Func_System_ValueTuple___0___1__System_ValueTuple___2___3___4___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3\)\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 2 inputs and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2), (TOut1, TOut2, TOut3)> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task_System_ValueTuple___2___3___4___5____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2\), Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 2 inputs and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2), Task<(TOut1, TOut2, TOut3, TOut4)>> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1__System_ValueTuple___2___3___4___5___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4\)\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 2 inputs and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2), (TOut1, TOut2, TOut3, TOut4)> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task_System_ValueTuple___2___3___4___5___6____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 2 inputs and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2), Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1__System_ValueTuple___2___3___4___5___6___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 2 inputs and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2), (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task_System_ValueTuple___2___3___4___5___6___7____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 2 inputs and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1__System_ValueTuple___2___3___4___5___6___7___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 2 inputs and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task_System_ValueTuple___2___3___4___5___6___7___8____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 2 inputs and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1__System_ValueTuple___2___3___4___5___6___7___8___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 2 inputs and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1__System_Threading_Tasks_Task_System_ValueTuple___2___3___4___5___6___7___8_System_ValueTuple___9_____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__System_ValueTuple_Flowthru_Data_IItem___9____System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 2 inputs and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1__System_ValueTuple___2___3___4___5___6___7___8_System_ValueTuple___9____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__System_ValueTuple_Flowthru_Data_IItem___9____System_String_"></a> AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 2 inputs and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__4_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task___3___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___Flowthru_Data_IItem___3__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<TOut1\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), IItem<TOut1\>, string\)
+
+Adds a node with 3 inputs and 1 output (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1>(string label, Func<(TIn1, TIn2, TIn3), Task<TOut1>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOut1\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__4_System_String_System_Func_System_ValueTuple___0___1___2____3__System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___Flowthru_Data_IItem___3__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3\), TOut1\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), IItem<TOut1\>, string\)
+
+Adds a node with 3 inputs and 1 output (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1>(string label, Func<(TIn1, TIn2, TIn3), TOut1> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), TOut1\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__5_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task_System_ValueTuple___3___4____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<\(TOut1, TOut2\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 3 inputs and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3), Task<(TOut1, TOut2)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__5_System_String_System_Func_System_ValueTuple___0___1___2__System_ValueTuple___3___4___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 3 inputs and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3), (TOut1, TOut2)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task_System_ValueTuple___3___4___5____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<\(TOut1, TOut2, TOut3\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 3 inputs and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3), Task<(TOut1, TOut2, TOut3)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1___2__System_ValueTuple___3___4___5___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 3 inputs and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3), (TOut1, TOut2, TOut3)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task_System_ValueTuple___3___4___5___6____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 3 inputs and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3), Task<(TOut1, TOut2, TOut3, TOut4)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2__System_ValueTuple___3___4___5___6___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 3 inputs and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3), (TOut1, TOut2, TOut3, TOut4)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task_System_ValueTuple___3___4___5___6___7____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 3 inputs and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3), Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2__System_ValueTuple___3___4___5___6___7___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 3 inputs and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3), (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task_System_ValueTuple___3___4___5___6___7___8____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 3 inputs and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2__System_ValueTuple___3___4___5___6___7___8___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 3 inputs and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task_System_ValueTuple___3___4___5___6___7___8___9____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 3 inputs and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2__System_ValueTuple___3___4___5___6___7___8___9___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 3 inputs and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2__System_Threading_Tasks_Task_System_ValueTuple___3___4___5___6___7___8___9_System_ValueTuple___10_____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__System_ValueTuple_Flowthru_Data_IItem___10____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 3 inputs and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2__System_ValueTuple___3___4___5___6___7___8___9_System_ValueTuple___10____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__System_ValueTuple_Flowthru_Data_IItem___10____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 3 inputs and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__5_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task___4___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___Flowthru_Data_IItem___4__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<TOut1\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), IItem<TOut1\>, string\)
+
+Adds a node with 4 inputs and 1 output (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<TOut1>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOut1\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__5_System_String_System_Func_System_ValueTuple___0___1___2___3____4__System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___Flowthru_Data_IItem___4__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), TOut1\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), IItem<TOut1\>, string\)
+
+Adds a node with 4 inputs and 1 output (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4), TOut1> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), TOut1\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task_System_ValueTuple___4___5____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<\(TOut1, TOut2\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 4 inputs and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<(TOut1, TOut2)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1___2___3__System_ValueTuple___4___5___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 4 inputs and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4), (TOut1, TOut2)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task_System_ValueTuple___4___5___6____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<\(TOut1, TOut2, TOut3\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 4 inputs and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<(TOut1, TOut2, TOut3)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2___3__System_ValueTuple___4___5___6___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 4 inputs and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4), (TOut1, TOut2, TOut3)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task_System_ValueTuple___4___5___6___7____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 4 inputs and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<(TOut1, TOut2, TOut3, TOut4)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3__System_ValueTuple___4___5___6___7___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 4 inputs and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4), (TOut1, TOut2, TOut3, TOut4)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task_System_ValueTuple___4___5___6___7___8____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 4 inputs and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3__System_ValueTuple___4___5___6___7___8___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 4 inputs and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4), (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task_System_ValueTuple___4___5___6___7___8___9____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 4 inputs and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3__System_ValueTuple___4___5___6___7___8___9___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 4 inputs and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task_System_ValueTuple___4___5___6___7___8___9___10____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 4 inputs and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3__System_ValueTuple___4___5___6___7___8___9___10___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 4 inputs and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3__System_Threading_Tasks_Task_System_ValueTuple___4___5___6___7___8___9___10_System_ValueTuple___11_____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__System_ValueTuple_Flowthru_Data_IItem___11____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 4 inputs and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3__System_ValueTuple___4___5___6___7___8___9___10_System_ValueTuple___11____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__System_ValueTuple_Flowthru_Data_IItem___11____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 4 inputs and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task___5___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___Flowthru_Data_IItem___5__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<TOut1\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), IItem<TOut1\>, string\)
+
+Adds a node with 5 inputs and 1 output (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<TOut1>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOut1\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__6_System_String_System_Func_System_ValueTuple___0___1___2___3___4____5__System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___Flowthru_Data_IItem___5__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), TOut1\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), IItem<TOut1\>, string\)
+
+Adds a node with 5 inputs and 1 output (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), TOut1> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), TOut1\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task_System_ValueTuple___5___6____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<\(TOut1, TOut2\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 5 inputs and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<(TOut1, TOut2)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_ValueTuple___5___6___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 5 inputs and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), (TOut1, TOut2)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task_System_ValueTuple___5___6___7____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<\(TOut1, TOut2, TOut3\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 5 inputs and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<(TOut1, TOut2, TOut3)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_ValueTuple___5___6___7___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 5 inputs and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), (TOut1, TOut2, TOut3)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task_System_ValueTuple___5___6___7___8____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 5 inputs and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<(TOut1, TOut2, TOut3, TOut4)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_ValueTuple___5___6___7___8___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 5 inputs and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), (TOut1, TOut2, TOut3, TOut4)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task_System_ValueTuple___5___6___7___8___9____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 5 inputs and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_ValueTuple___5___6___7___8___9___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 5 inputs and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task_System_ValueTuple___5___6___7___8___9___10____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 5 inputs and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_ValueTuple___5___6___7___8___9___10___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 5 inputs and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task_System_ValueTuple___5___6___7___8___9___10___11____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 5 inputs and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_ValueTuple___5___6___7___8___9___10___11___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 5 inputs and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_Threading_Tasks_Task_System_ValueTuple___5___6___7___8___9___10___11_System_ValueTuple___12_____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__System_ValueTuple_Flowthru_Data_IItem___12____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 5 inputs and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4__System_ValueTuple___5___6___7___8___9___10___11_System_ValueTuple___12____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__System_ValueTuple_Flowthru_Data_IItem___12____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 5 inputs and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task___6___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___Flowthru_Data_IItem___6__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<TOut1\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), IItem<TOut1\>, string\)
+
+Adds a node with 6 inputs and 1 output (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<TOut1>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOut1\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__7_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5____6__System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___Flowthru_Data_IItem___6__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), TOut1\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), IItem<TOut1\>, string\)
+
+Adds a node with 6 inputs and 1 output (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), TOut1> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), TOut1\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task_System_ValueTuple___6___7____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<\(TOut1, TOut2\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 6 inputs and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<(TOut1, TOut2)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_ValueTuple___6___7___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 6 inputs and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), (TOut1, TOut2)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task_System_ValueTuple___6___7___8____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<\(TOut1, TOut2, TOut3\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 6 inputs and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<(TOut1, TOut2, TOut3)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_ValueTuple___6___7___8___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 6 inputs and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), (TOut1, TOut2, TOut3)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task_System_ValueTuple___6___7___8___9____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 6 inputs and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<(TOut1, TOut2, TOut3, TOut4)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_ValueTuple___6___7___8___9___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 6 inputs and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), (TOut1, TOut2, TOut3, TOut4)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task_System_ValueTuple___6___7___8___9___10____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 6 inputs and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_ValueTuple___6___7___8___9___10___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 6 inputs and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task_System_ValueTuple___6___7___8___9___10___11____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 6 inputs and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_ValueTuple___6___7___8___9___10___11___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 6 inputs and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task_System_ValueTuple___6___7___8___9___10___11___12____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 6 inputs and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_ValueTuple___6___7___8___9___10___11___12___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 6 inputs and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__14_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_Threading_Tasks_Task_System_ValueTuple___6___7___8___9___10___11___12_System_ValueTuple___13_____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__System_ValueTuple_Flowthru_Data_IItem___13____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 6 inputs and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__14_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5__System_ValueTuple___6___7___8___9___10___11___12_System_ValueTuple___13____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__System_ValueTuple_Flowthru_Data_IItem___13____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 6 inputs and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task___7___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Data_IItem___7__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<TOut1\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), IItem<TOut1\>, string\)
+
+Adds a node with 7 inputs and 1 output (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<TOut1>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOut1\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__8_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6____7__System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Data_IItem___7__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), TOut1\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), IItem<TOut1\>, string\)
+
+Adds a node with 7 inputs and 1 output (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), TOut1> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), TOut1\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task_System_ValueTuple___7___8____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<\(TOut1, TOut2\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 7 inputs and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<(TOut1, TOut2)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_ValueTuple___7___8___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 7 inputs and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), (TOut1, TOut2)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task_System_ValueTuple___7___8___9____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<\(TOut1, TOut2, TOut3\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 7 inputs and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<(TOut1, TOut2, TOut3)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_ValueTuple___7___8___9___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 7 inputs and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), (TOut1, TOut2, TOut3)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task_System_ValueTuple___7___8___9___10____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 7 inputs and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<(TOut1, TOut2, TOut3, TOut4)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_ValueTuple___7___8___9___10___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 7 inputs and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), (TOut1, TOut2, TOut3, TOut4)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task_System_ValueTuple___7___8___9___10___11____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 7 inputs and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_ValueTuple___7___8___9___10___11___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 7 inputs and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task_System_ValueTuple___7___8___9___10___11___12____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 7 inputs and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_ValueTuple___7___8___9___10___11___12___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 7 inputs and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__14_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task_System_ValueTuple___7___8___9___10___11___12___13____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 7 inputs and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__14_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_ValueTuple___7___8___9___10___11___12___13___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 7 inputs and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__15_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_Threading_Tasks_Task_System_ValueTuple___7___8___9___10___11___12___13_System_ValueTuple___14_____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__System_ValueTuple_Flowthru_Data_IItem___14____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 7 inputs and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__15_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6__System_ValueTuple___7___8___9___10___11___12___13_System_ValueTuple___14____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__System_ValueTuple_Flowthru_Data_IItem___14____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 7 inputs and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task___8___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____Flowthru_Data_IItem___8__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<TOut1\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), IItem<TOut1\>, string\)
+
+Adds a node with 8 inputs and 1 output (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<TOut1>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<TOut1\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__9_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7_____8__System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____Flowthru_Data_IItem___8__System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), TOut1\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), IItem<TOut1\>, string\)
+
+Adds a node with 8 inputs and 1 output (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), TOut1> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, IItem<TOut1> output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), TOut1\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` [IItem](Flowthru.Data.IItem\-1.md)<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task_System_ValueTuple___8___9____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<\(TOut1, TOut2\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 8 inputs and 2 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<(TOut1, TOut2)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__10_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_ValueTuple___8___9___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>\), string\)
+
+Adds a node with 8 inputs and 2 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), (TOut1, TOut2)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task_System_ValueTuple___8___9___10____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<\(TOut1, TOut2, TOut3\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 8 inputs and 3 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<(TOut1, TOut2, TOut3)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__11_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_ValueTuple___8___9___10___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), string\)
+
+Adds a node with 8 inputs and 3 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), (TOut1, TOut2, TOut3)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task_System_ValueTuple___8___9___10___11____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<\(TOut1, TOut2, TOut3, TOut4\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 8 inputs and 4 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<(TOut1, TOut2, TOut3, TOut4)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__12_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_ValueTuple___8___9___10___11___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), string\)
+
+Adds a node with 8 inputs and 4 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), (TOut1, TOut2, TOut3, TOut4)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task_System_ValueTuple___8___9___10___11___12____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 8 inputs and 5 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<(TOut1, TOut2, TOut3, TOut4, TOut5)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__13_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_ValueTuple___8___9___10___11___12___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), string\)
+
+Adds a node with 8 inputs and 5 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), (TOut1, TOut2, TOut3, TOut4, TOut5)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__14_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task_System_ValueTuple___8___9___10___11___12___13____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 8 inputs and 6 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__14_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_ValueTuple___8___9___10___11___12___13___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), string\)
+
+Adds a node with 8 inputs and 6 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__15_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task_System_ValueTuple___8___9___10___11___12___13___14____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__Flowthru_Data_IItem___14___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 8 inputs and 7 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__15_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_ValueTuple___8___9___10___11___12___13___14___System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__Flowthru_Data_IItem___14___System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), string\)
+
+Adds a node with 8 inputs and 7 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__16_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_Threading_Tasks_Task_System_ValueTuple___8___9___10___11___12___13___14_System_ValueTuple___15_____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__Flowthru_Data_IItem___14__System_ValueTuple_Flowthru_Data_IItem___15____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), Task<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 8 inputs and 8 outputs (asynchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), Task<(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)>> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<\(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>\>
+
+Asynchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_AddStep__16_System_String_System_Func_System_ValueTuple___0___1___2___3___4___5___6_System_ValueTuple___7___System_ValueTuple___8___9___10___11___12___13___14_System_ValueTuple___15____System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__Flowthru_Data_IItem___14__System_ValueTuple_Flowthru_Data_IItem___15____System_String_"></a> AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(string, Func<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), string\)
+
+Adds a node with 8 inputs and 8 outputs (synchronous transformation).
+
+```csharp
+public FlowBuilder AddStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(string label, Func<(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8), (TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8)> transform, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, string description = "")
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`transform` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<\(TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8\), \(TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\)\>
+
+Synchronous transformation function
+
+`input` \([IItem](Flowthru.Data.IItem\-1.md)<TIn1\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn2\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn3\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn4\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn5\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn6\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn7\>, [IItem](Flowthru.Data.IItem\-1.md)<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \([IItem](Flowthru.Data.IItem\-1.md)<TOut1\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut2\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut3\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut4\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut5\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut6\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut7\>, [IItem](Flowthru.Data.IItem\-1.md)<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional description of the node's purpose
+
+#### Returns
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Pipelines_FlowBuilder_CreateFlow_System_Action_Flowthru_Pipelines_FlowBuilder__"></a> CreateFlow\(Action<FlowBuilder\>\)
+
+Creates and configures a new pipeline using the builder pattern.
+
+```csharp
+public static Pipeline CreateFlow(Action<FlowBuilder> configure)
+```
+
+#### Parameters
+
+`configure` [Action](https://learn.microsoft.com/dotnet/api/system.action\-1)<[FlowBuilder](Flowthru.Flows.FlowBuilder.md)\>
+
+Action to configure the pipeline by adding nodes
+
+#### Returns
+
+ [Pipeline](Flowthru.Flows.Pipeline.md)
+
+Configured but not yet built pipeline
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.PipelineNode.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.PipelineNode.md
new file mode 100644
index 00000000..30c419fd
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.PipelineNode.md
@@ -0,0 +1,223 @@
+# <a id="Flowthru_Pipelines_PipelineNode"></a> Class PipelineNode
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Represents a node within a pipeline, wrapping the transformation function with metadata
+about its inputs, outputs, and dependencies.
+
+```csharp
+public class PipelineNode
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PipelineNode](Flowthru.Flows.PipelineNode.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+PipelineNode serves as the internal representation of a node during pipeline
+construction and execution. It tracks:
+- The transformation function (Func&lt;TInput, Task&lt;TOutput&gt;&gt;)
+- Input catalog entries (what data it reads)
+- Output catalog entries (what data it writes)
+- Dependencies (other nodes that must run first)
+</p>
+<p>
+<strong>Single Producer Rule:</strong> Each catalog entry can be written by at most
+one node in a pipeline. This constraint ensures deterministic dependency resolution
+and enables simple DAG construction via topological sort.
+</p>
+<p>
+<strong>Function-Based Architecture (v0.5.0):</strong> Nodes are now pure transformation
+functions instead of class instances. This enables compile-time type safety through
+generic type inference at the pipeline construction site.
+</p>
+<p>
+<strong>Visibility (Phase 4):</strong>
+Made public to enable validation hooks to inspect node properties.
+This is necessary for extensions (e.g., Python) to validate their own node types.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Pipelines_PipelineNode__ctor_System_String_System_String_System_Delegate_System_Collections_Generic_IReadOnlyList_Flowthru_Data_IItem__System_Collections_Generic_IReadOnlyList_Flowthru_Data_IItem__"></a> PipelineNode\(string, string?, Delegate, IReadOnlyList<IItem\>, IReadOnlyList<IItem\>\)
+
+Creates a new pipeline node with a transformation function.
+
+```csharp
+public PipelineNode(string label, string? description, Delegate node, IReadOnlyList<IItem> inputs, IReadOnlyList<IItem> outputs)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+`node` [Delegate](https://learn.microsoft.com/dotnet/api/system.delegate)
+
+The transformation function (Func&lt;TInput, Task&lt;TOutput&gt;&gt;)
+
+`inputs` [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[IItem](Flowthru.Data.IItem.md)\>
+
+Catalog entries this node reads
+
+`outputs` [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[IItem](Flowthru.Data.IItem.md)\>
+
+Catalog entries this node writes
+
+## Properties
+
+### <a id="Flowthru_Pipelines_PipelineNode_Dependencies"></a> Dependencies
+
+Other pipeline nodes that must execute before this node.
+Populated during dependency analysis by checking which nodes produce our inputs.
+
+```csharp
+public List<PipelineNode> Dependencies { get; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[PipelineNode](Flowthru.Flows.PipelineNode.md)\>
+
+#### Remarks
+
+This forms the edges of the execution DAG:
+- If node A produces output X, and node B consumes input X, then B depends on A.
+- Topological sort uses these dependencies to determine execution order.
+
+### <a id="Flowthru_Pipelines_PipelineNode_Description"></a> Description
+
+String description of the node's purpose.
+
+```csharp
+public string Description { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Pipelines_PipelineNode_Inputs"></a> Inputs
+
+Catalog entries that this node reads as input.
+These may be produced by other nodes (dependencies) or be external prerequisites.
+
+```csharp
+public IReadOnlyList<IItem> Inputs { get; }
+```
+
+#### Property Value
+
+ [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[IItem](Flowthru.Data.IItem.md)\>
+
+### <a id="Flowthru_Pipelines_PipelineNode_Label"></a> Label
+
+Unique identifier for this node within the pipeline.
+Typically the node type name or user-provided name.
+
+```csharp
+public string Label { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Pipelines_PipelineNode_Layer"></a> Layer
+
+Execution layer determined by topological sort.
+Nodes in layer 0 have no dependencies. Nodes in layer N depend on nodes in layers 0..N-1.
+
+```csharp
+public int Layer { get; set; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+### <a id="Flowthru_Pipelines_PipelineNode_Outputs"></a> Outputs
+
+Catalog entries that this node writes as output.
+Per the single producer rule, each entry here must be unique across all nodes.
+
+```csharp
+public IReadOnlyList<IItem> Outputs { get; }
+```
+
+#### Property Value
+
+ [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[IItem](Flowthru.Data.IItem.md)\>
+
+### <a id="Flowthru_Pipelines_PipelineNode_TransformFunction"></a> TransformFunction
+
+The transformation function that performs the node's work.
+Type-erased to Delegate since we need to store different function signatures together.
+
+```csharp
+public Delegate TransformFunction { get; }
+```
+
+#### Property Value
+
+ [Delegate](https://learn.microsoft.com/dotnet/api/system.delegate)
+
+#### Remarks
+
+<p>
+At execution time, this delegate will be invoked via DynamicInvoke with the
+appropriate input parameter(s). The function signature can be either synchronous
+or asynchronous:
+- Sync single: Func&lt;TInput, TOutput&gt;
+- Async single: Func&lt;TInput, Task&lt;TOutput&gt;&gt;
+- Sync multi-input: Func&lt;(TIn1, TIn2, ...), TOutput&gt;
+- Async multi-input: Func&lt;(TIn1, TIn2, ...), Task&lt;TOutput&gt;&gt;
+- Sync multi-output: Func&lt;TInput, (TOut1, TOut2, ...)&gt;
+- Async multi-output: Func&lt;TInput, Task&lt;(TOut1, TOut2, ...)&gt;&gt;
+</p>
+<p>
+<strong>Optional Cancellation Support:</strong> Nodes can opt-in to cancellation awareness
+by accepting a CancellationToken as the last parameter:
+- Func&lt;TInput, CancellationToken, Task&lt;TOutput&gt;&gt;
+- Func&lt;(TIn1, TIn2), CancellationToken, Task&lt;TOutput&gt;&gt;
+</p>
+<p>
+When a node accepts a CancellationToken, the pipeline will pass the runtime token during
+execution, allowing the node to cancel long-running operations cooperatively. Nodes that
+do not accept a CancellationToken will only be cancelled between node executions.
+</p>
+<p>
+The execution engine detects whether the result is a Task and awaits it if needed.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Pipelines_PipelineNode_ToString"></a> ToString\(\)
+
+Returns a string representation for debugging.
+
+```csharp
+public override string ToString()
+```
+
+#### Returns
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.PipelineResult.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.PipelineResult.md
new file mode 100644
index 00000000..aa107d5e
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.PipelineResult.md
@@ -0,0 +1,214 @@
+# <a id="Flowthru_Pipelines_FlowResult"></a> Class FlowResult
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Represents the result of a pipeline execution.
+
+```csharp
+public class FlowResult
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowResult](Flowthru.Flows.FlowResult.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+This class provides comprehensive execution information including success status,
+timing, individual node results, and error details.
+</p>
+<p>
+<strong>Usage Pattern:</strong>
+</p>
+<pre><code class="lang-csharp">var result = await pipeline.RunAsync();
+
+if (result.Success)
+{
+    Console.WriteLine($"Pipeline completed in {result.ExecutionTime.TotalSeconds:F2}s");
+    foreach (var nodeResult in result.StepResults.Values)
+    {
+        Console.WriteLine($"  {nodeResult.NodeName}: {nodeResult.ExecutionTime.TotalSeconds:F2}s");
+    }
+}
+else
+{
+    Console.WriteLine($"Pipeline failed: {result.Exception?.Message}");
+}</code></pre>
+
+## Properties
+
+### <a id="Flowthru_Pipelines_FlowResult_Exception"></a> Exception
+
+Exception that caused pipeline failure, if any.
+
+```csharp
+public Exception? Exception { get; init; }
+```
+
+#### Property Value
+
+ [Exception](https://learn.microsoft.com/dotnet/api/system.exception)?
+
+#### Remarks
+
+Null if Success is true. Contains the first exception that caused
+pipeline execution to halt if Success is false.
+
+### <a id="Flowthru_Pipelines_FlowResult_ExecutionTime"></a> ExecutionTime
+
+Total execution time for the entire pipeline.
+
+```csharp
+public TimeSpan ExecutionTime { get; init; }
+```
+
+#### Property Value
+
+ [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
+
+### <a id="Flowthru_Pipelines_FlowResult_IsDryRun"></a> IsDryRun
+
+Indicates whether this was a dry run (pre-flight checks only).
+
+```csharp
+public bool IsDryRun { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Pipelines_FlowResult_StepResults"></a> StepResults
+
+Results for individual nodes, keyed by node name.
+
+```csharp
+public Dictionary<string, NodeResult> StepResults { get; init; }
+```
+
+#### Property Value
+
+ [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [NodeResult](Flowthru.Flows.NodeResult.md)\>
+
+#### Remarks
+
+Dictionary keys are the node names as specified in the pipeline definition.
+Values contain execution details for each node.
+
+### <a id="Flowthru_Pipelines_FlowResult_FlowName"></a> FlowName
+
+The name of the pipeline that was executed.
+
+```csharp
+public string? FlowName { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Pipelines_FlowResult_Success"></a> Success
+
+Indicates whether the pipeline executed successfully.
+
+```csharp
+public bool Success { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+## Methods
+
+### <a id="Flowthru_Pipelines_FlowResult_CreateDryRunSuccess_System_TimeSpan_System_Int32_System_Int32_System_Int32_System_String_"></a> CreateDryRunSuccess\(TimeSpan, int, int, int, string?\)
+
+Creates a successful dry run result.
+
+```csharp
+public static FlowResult CreateDryRunSuccess(TimeSpan preFlightDuration, int nodeCount, int layerCount, int validatedInputCount, string? pipelineName = null)
+```
+
+#### Parameters
+
+`preFlightDuration` [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
+
+Time spent on pre-flight checks
+
+`nodeCount` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Total number of nodes in the pipeline
+
+`layerCount` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of execution layers
+
+`validatedInputCount` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of external inputs validated
+
+`pipelineName` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+Name of the pipeline
+
+#### Returns
+
+ [FlowResult](Flowthru.Flows.FlowResult.md)
+
+A successful dry run result
+
+### <a id="Flowthru_Pipelines_FlowResult_CreateFailure_System_TimeSpan_System_Exception_System_Collections_Generic_Dictionary_System_String_Flowthru_Pipelines_NodeResult__System_String_"></a> CreateFailure\(TimeSpan, Exception, Dictionary<string, NodeResult\>?, string?\)
+
+Creates a failed pipeline result.
+
+```csharp
+public static FlowResult CreateFailure(TimeSpan executionTime, Exception exception, Dictionary<string, NodeResult>? nodeResults = null, string? pipelineName = null)
+```
+
+#### Parameters
+
+`executionTime` [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
+
+`exception` [Exception](https://learn.microsoft.com/dotnet/api/system.exception)
+
+`nodeResults` [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [NodeResult](Flowthru.Flows.NodeResult.md)\>?
+
+`pipelineName` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Returns
+
+ [FlowResult](Flowthru.Flows.FlowResult.md)
+
+### <a id="Flowthru_Pipelines_FlowResult_CreateSuccess_System_TimeSpan_System_Collections_Generic_Dictionary_System_String_Flowthru_Pipelines_NodeResult__System_String_"></a> CreateSuccess\(TimeSpan, Dictionary<string, NodeResult\>, string?\)
+
+Creates a successful pipeline result.
+
+```csharp
+public static FlowResult CreateSuccess(TimeSpan executionTime, Dictionary<string, NodeResult> nodeResults, string? pipelineName = null)
+```
+
+#### Parameters
+
+`executionTime` [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
+
+`nodeResults` [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [NodeResult](Flowthru.Flows.NodeResult.md)\>
+
+`pipelineName` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Returns
+
+ [FlowResult](Flowthru.Flows.FlowResult.md)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.PipelineSliceStrategy.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.PipelineSliceStrategy.md
new file mode 100644
index 00000000..d3bf1fa0
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.PipelineSliceStrategy.md
@@ -0,0 +1,179 @@
+# <a id="Flowthru_Pipelines_FlowSliceStrategy"></a> Class FlowSliceStrategy
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Defines a strategy for slicing a pipeline to execute a subset of nodes.
+
+```csharp
+public sealed class FlowSliceStrategy
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowSliceStrategy](Flowthru.Flows.FlowSliceStrategy.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+Pipeline slicing allows executing only specific portions of a DAG while maintaining
+execution validity. All slicing operations preserve the runnability guarantee:
+the resulting sub-DAG must be executable without missing dependencies.
+</p>
+<p>
+<strong>Slicing Strategies:</strong>
+</p>
+<ul><li><strong>Pipelines:</strong> Filter to nodes from specific named pipelines (in merged DAGs)</li><li><strong>FromNodes:</strong> Include specified nodes and all downstream dependents</li><li><strong>ToNodes:</strong> Include specified nodes and all upstream dependencies (run "up to" these nodes)</li><li><strong>FromData:</strong> Include nodes consuming specified catalog entries and all downstream dependents</li><li><strong>ToData:</strong> Include nodes producing specified catalog entries and all upstream dependencies</li><li><strong>OnlyNodes:</strong> Explicit allowlist of nodes plus minimal required dependencies</li></ul>
+<p>
+<strong>Composition:</strong> Multiple strategies compose via intersection (additive filtering).
+For example, <code>--from-nodes A --to-data B</code> produces nodes in the downstream dependency
+tree of A that are also required to produce data B.
+</p>
+<p>
+<strong>Runnability Guarantee:</strong> Slicing operations are additive only. Subtractive
+operations (<code>--from-nodes A --except B</code>) would break the runnability guarantee and
+are not supported.
+</p>
+
+## Properties
+
+### <a id="Flowthru_Pipelines_FlowSliceStrategy_FromData"></a> FromData
+
+Start from nodes that consume these catalog entry labels, including all downstream dependents.
+
+```csharp
+public IReadOnlySet<string>? FromData { get; init; }
+```
+
+#### Property Value
+
+ [IReadOnlySet](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlyset\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>?
+
+#### Remarks
+
+Finds all nodes that read the specified catalog entries, then expands downstream.
+Useful for impact analysis - "what breaks if I change this data?"
+
+### <a id="Flowthru_Pipelines_FlowSliceStrategy_FromNodes"></a> FromNodes
+
+Start from these nodes, including all downstream dependents.
+
+```csharp
+public IReadOnlySet<string>? FromNodes { get; init; }
+```
+
+#### Property Value
+
+ [IReadOnlySet](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlyset\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>?
+
+#### Remarks
+
+Expands to include all nodes that depend on these nodes (transitively).
+Useful for impact analysis - "what breaks if I change this node?"
+
+### <a id="Flowthru_Pipelines_FlowSliceStrategy_IsSliced"></a> IsSliced
+
+Whether any slicing is configured.
+
+```csharp
+public bool IsSliced { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Pipelines_FlowSliceStrategy_OnlyNodes"></a> OnlyNodes
+
+Explicit allowlist of node names (dependencies auto-included).
+
+```csharp
+public IReadOnlySet<string>? OnlyNodes { get; init; }
+```
+
+#### Property Value
+
+ [IReadOnlySet](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlyset\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>?
+
+#### Remarks
+
+Specifies exactly which nodes to execute, then automatically includes any
+required dependencies to maintain DAG validity.
+
+### <a id="Flowthru_Pipelines_FlowSliceStrategy_Pipelines"></a> Pipelines
+
+Filter to nodes from these named pipelines (applies to merged pipelines).
+
+```csharp
+public IReadOnlySet<string>? Pipelines { get; init; }
+```
+
+#### Property Value
+
+ [IReadOnlySet](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlyset\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>?
+
+#### Remarks
+
+In merged pipelines, nodes are prefixed with their pipeline name (e.g., "DataScience.TrainModel").
+This filter includes only nodes from the specified pipelines.
+Pipeline names are case-insensitive.
+
+### <a id="Flowthru_Pipelines_FlowSliceStrategy_ToData"></a> ToData
+
+End at nodes that produce these catalog entry labels, including all upstream dependencies.
+
+```csharp
+public IReadOnlySet<string>? ToData { get; init; }
+```
+
+#### Property Value
+
+ [IReadOnlySet](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlyset\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>?
+
+#### Remarks
+
+Finds the nodes that write the specified catalog entries, then expands upstream.
+Useful for targeted execution - "run everything needed to produce this data".
+
+### <a id="Flowthru_Pipelines_FlowSliceStrategy_ToNodes"></a> ToNodes
+
+End at these nodes, including all upstream dependencies needed to produce them.
+
+```csharp
+public IReadOnlySet<string>? ToNodes { get; init; }
+```
+
+#### Property Value
+
+ [IReadOnlySet](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlyset\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>?
+
+#### Remarks
+
+Expands to include all transitive dependencies needed to run these nodes.
+Equivalent to "run everything up to and including these nodes".
+Useful for testing specific outputs without running the entire pipeline.
+
+## Methods
+
+### <a id="Flowthru_Pipelines_FlowSliceStrategy_All"></a> All\(\)
+
+No filtering - execute entire pipeline.
+
+```csharp
+public static FlowSliceStrategy All()
+```
+
+#### Returns
+
+ [FlowSliceStrategy](Flowthru.Flows.FlowSliceStrategy.md)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.Validation.IPipelineValidationHook.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.Validation.IPipelineValidationHook.md
new file mode 100644
index 00000000..ec1b114d
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.Validation.IPipelineValidationHook.md
@@ -0,0 +1,86 @@
+# <a id="Flowthru_Pipelines_Validation_IPipelineValidationHook"></a> Interface IPipelineValidationHook
+
+Namespace: [Flowthru.Flows.Validation](Flowthru.Flows.Validation.md)  
+Assembly: Flowthru.Core.dll  
+
+Validation hook that runs during pipeline pre-flight checks.
+
+```csharp
+public interface IPipelineValidationHook
+```
+
+## Remarks
+
+<p>
+Validation hooks provide an extensibility point for extensions to contribute
+their own validation logic during the pre-flight phase. Hooks are invoked after
+DAG analysis but before external input inspection, allowing extensions to
+validate their own node types.
+</p>
+<p>
+<strong>Example use cases:</strong>
+<ul><li>Python extension validates @node decorators match C# types</li><li>Custom extensions validate node-specific configuration</li><li>Third-party plugins validate external dependencies</li></ul>
+</p>
+<p>
+<strong>Hook execution order:</strong>
+</p>
+<ol><li>Pipeline.Build() - DAG construction and layer assignment</li><li>ValidationHooks.ValidateAsync() - Extension-specific validation</li><li>Pipeline.ValidateExternalInputsAsync() - External input inspection</li></ol>
+<p>
+<strong>Error handling:</strong>
+Hooks should return ValidationResult with errors, never throw exceptions.
+Multiple hooks may run, and all errors are aggregated into a single result.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Pipelines_Validation_IPipelineValidationHook_ValidateAsync_Flowthru_Pipelines_Pipeline_System_Threading_CancellationToken_"></a> ValidateAsync\(Pipeline, CancellationToken\)
+
+Validates pipeline nodes during pre-flight checks.
+
+```csharp
+Task<ValidationResult> ValidateAsync(Pipeline pipeline, CancellationToken cancellationToken)
+```
+
+#### Parameters
+
+`pipeline` [Pipeline](Flowthru.Flows.Pipeline.md)
+
+The pipeline being validated
+
+`cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+Cancellation token for async operations
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Validation result containing any errors found
+
+#### Remarks
+
+<p>
+Implementations should:
+<ul><li>Never throw exceptions (return errors in ValidationResult)</li><li>Be idempotent (safe to call multiple times)</li><li>Be reasonably fast (executed during pre-flight, blocks pipeline start)</li><li>Only validate nodes they understand (ignore other node types)</li></ul>
+</p>
+<p>
+<strong>Example implementation (Python extension):</strong>
+</p>
+<pre><code class="lang-csharp">public async Task&lt;ValidationResult&gt; ValidateAsync(
+  Pipeline pipeline,
+  CancellationToken cancellationToken)
+{
+  var result = ValidationResult.Success();
+
+  foreach (var node in pipeline.Nodes)
+  {
+    if (IsPythonNode(node))
+    {
+      var nodeResult = await ValidatePythonNode(node, cancellationToken);
+      result.Merge(nodeResult);
+    }
+  }
+
+  return result;
+}</code></pre>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.Validation.ValidationOptions.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.Validation.ValidationOptions.md
new file mode 100644
index 00000000..8f42ef0c
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.Validation.ValidationOptions.md
@@ -0,0 +1,106 @@
+# <a id="Flowthru_Pipelines_Validation_ValidationOptions"></a> Class ValidationOptions
+
+Namespace: [Flowthru.Flows.Validation](Flowthru.Flows.Validation.md)  
+Assembly: Flowthru.Core.dll  
+
+Configuration for pipeline validation behavior.
+
+```csharp
+public class ValidationOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ValidationOptions](Flowthru.Flows.Validation.ValidationOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+ValidationOptions provides pipeline-level overrides for validation configuration.
+The primary mechanism for validation configuration is catalog-level via the
+<xref href="Flowthru.Data.IItem.PreferredInspectionLevel" data-throw-if-not-resolved="false"></xref> property and the fluent
+<code>.WithInspectionLevel()</code> API.
+</p>
+<p>
+<strong>Default Behavior (if not configured):</strong>
+</p>
+<ul><li>Catalog entry has PreferredInspectionLevel set → use that level</li><li>Layer 0 inputs → Shallow inspection (all storage adapters support inspection)</li><li>All intermediate outputs (Layer 1+) → None (never inspected)</li></ul>
+<p>
+<strong>Catalog-Level Configuration (Recommended):</strong>
+</p>
+<pre><code class="lang-csharp">public ICatalogDataset&lt;Company&gt; Companies =&gt;
+  GetOrCreateDataset(() =&gt; new CsvCatalogDataset&lt;Company&gt;("companies", "data/companies.csv")
+    .WithInspectionLevel(InspectionLevel.Deep));</code></pre>
+<p>
+<strong>Pipeline-Level Override (Advanced):</strong>
+</p>
+<pre><code class="lang-csharp">builder
+  .RegisterPipeline&lt;MyCatalog&gt;("data_processing", MyPipeline.Create)
+  .WithValidation(validation =&gt; {
+    // Override catalog-level setting for this specific pipeline
+    validation.Inspect(catalog.Companies, InspectionLevel.Shallow); // Temporarily use shallow
+  });</code></pre>
+<p>
+<strong>Design Rationale:</strong>
+</p>
+<p>
+Validation configuration is primarily a property of the data source itself, not the pipeline
+consuming it. Critical external datasets should always be deeply validated, regardless of
+which pipeline uses them. Pipeline-level overrides exist for rare cases where different
+validation is needed temporarily (e.g., performance testing, debugging).
+</p>
+
+## Methods
+
+### <a id="Flowthru_Pipelines_Validation_ValidationOptions_Default"></a> Default\(\)
+
+Creates a new ValidationOptions instance with default settings.
+
+```csharp
+public static ValidationOptions Default()
+```
+
+#### Returns
+
+ [ValidationOptions](Flowthru.Flows.Validation.ValidationOptions.md)
+
+### <a id="Flowthru_Pipelines_Validation_ValidationOptions_Inspect_Flowthru_Data_IItem_Flowthru_Data_Validation_InspectionLevel_"></a> Inspect\(IItem, InspectionLevel\)
+
+Specifies the inspection level for a specific catalog entry.
+
+```csharp
+public ValidationOptions Inspect(IItem catalogEntry, InspectionLevel level)
+```
+
+#### Parameters
+
+`catalogEntry` [IItem](Flowthru.Data.IItem.md)
+
+The catalog entry to configure
+
+`level` [InspectionLevel](Flowthru.Data.Validation.InspectionLevel.md)
+
+The inspection level to use for this entry
+
+#### Returns
+
+ [ValidationOptions](Flowthru.Flows.Validation.ValidationOptions.md)
+
+This ValidationOptions instance for fluent chaining
+
+#### Remarks
+
+This configuration only applies to Layer 0 inputs (external data).
+Intermediate outputs are never inspected regardless of this setting.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.Validation.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.Validation.md
new file mode 100644
index 00000000..e05e83d2
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.Validation.md
@@ -0,0 +1,14 @@
+# <a id="Flowthru_Pipelines_Validation"></a> Namespace Flowthru.Flows.Validation
+
+### Classes
+
+ [ValidationOptions](Flowthru.Flows.Validation.ValidationOptions.md)
+
+Configuration for pipeline validation behavior.
+
+### Interfaces
+
+ [IPipelineValidationHook](Flowthru.Flows.Validation.IPipelineValidationHook.md)
+
+Validation hook that runs during pipeline pre-flight checks.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.ValidationDepth.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.ValidationDepth.md
new file mode 100644
index 00000000..d00acbf5
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.ValidationDepth.md
@@ -0,0 +1,27 @@
+# <a id="Flowthru_Pipelines_ValidationDepth"></a> Enum ValidationDepth
+
+Namespace: [Flowthru.Flows](Flowthru.Flows.md)  
+Assembly: Flowthru.Core.dll  
+
+Controls how deeply a dry run validates the pipeline before stopping.
+
+```csharp
+public enum ValidationDepth
+```
+
+## Fields
+
+`Full = 1` 
+
+Structure validation plus external data presence checks (default dry-run behaviour).
+
+
+
+`StructureOnly = 0` 
+
+Validates graph structure only: no cycles, all node type contracts satisfied,
+all catalog entry dependencies wired, and all validation hooks run.
+No data source access.
+
+
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.md
new file mode 100644
index 00000000..e7df9cdc
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Pipelines.md
@@ -0,0 +1,50 @@
+# <a id="Flowthru_Pipelines"></a> Namespace Flowthru.Flows
+
+### Namespaces
+
+ [Flowthru.Flows.Validation](Flowthru.Flows.Validation.md)
+
+### Classes
+
+ [ExecutionOptions](Flowthru.Flows.ExecutionOptions.md)
+
+Configuration options for pipeline execution.
+
+ [NodeResult](Flowthru.Flows.NodeResult.md)
+
+Represents the execution result of a single pipeline node.
+
+ [Pipeline](Flowthru.Flows.Pipeline.md)
+
+Represents a complete data pipeline with nodes, dependencies, and execution order.
+
+ [FlowBuilder](Flowthru.Flows.FlowBuilder.md)
+
+Fluent builder for constructing type-safe data pipelines with function-based nodes.
+
+ [PipelineNode](Flowthru.Flows.PipelineNode.md)
+
+Represents a node within a pipeline, wrapping the transformation function with metadata
+about its inputs, outputs, and dependencies.
+
+ [FlowResult](Flowthru.Flows.FlowResult.md)
+
+Represents the result of a pipeline execution.
+
+ [FlowSliceStrategy](Flowthru.Flows.FlowSliceStrategy.md)
+
+Defines a strategy for slicing a pipeline to execute a subset of nodes.
+
+### Structs
+
+ [DryRunOption](Flowthru.Flows.DryRunOption.md)
+
+Represents a dry-run configuration. Can be assigned from a <xref href="System.Boolean" data-throw-if-not-resolved="false"></xref>
+or a <xref href="Flowthru.Flows.ValidationDepth" data-throw-if-not-resolved="false"></xref> value.
+
+### Enums
+
+ [ValidationDepth](Flowthru.Flows.ValidationDepth.md)
+
+Controls how deeply a dry run validates the pipeline before stopping.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Registry.IFlowRegistrar-1.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Registry.IFlowRegistrar-1.md
new file mode 100644
index 00000000..9a2dad17
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Registry.IFlowRegistrar-1.md
@@ -0,0 +1,151 @@
+# <a id="Flowthru_Registry_IFlowRegistrar_1"></a> Interface IFlowRegistrar<TCatalog\>
+
+Namespace: [Flowthru.Registry](Flowthru.Registry.md)  
+Assembly: Flowthru.Core.dll  
+
+Fluent interface for registering flows in a type-safe manner.
+
+```csharp
+public interface IFlowRegistrar<TCatalog> where TCatalog : CatalogAbstract
+```
+
+#### Type Parameters
+
+`TCatalog` 
+
+The catalog type that flows will use
+
+## Remarks
+
+<p>
+This interface provides compile-time type safety by tying flow factories
+to a specific catalog type. The registrar validates that all registered
+flows accept the correct catalog type.
+</p>
+<p>
+<strong>Usage:</strong>
+<pre><code class="lang-csharp">protected override void RegisterFlows(IFlowRegistrar&lt;MyCatalog&gt; registrar)
+{
+    // Flow without parameters
+    registrar.Register("processing", ProcessingFlow.Create);
+
+    // Flow with parameters
+    registrar.Register("training", TrainFlow.Create, new TrainOptions());
+
+    // Add metadata
+    registrar.WithDescription("processing", "Cleans and transforms raw data");
+}</code></pre>
+</p>
+
+## Methods
+
+### <a id="Flowthru_Registry_IFlowRegistrar_1_Register_System_String_System_Func__0_Flowthru_Flows_Flow__"></a> Register\(string, Func<TCatalog, Flow\>\)
+
+Registers a flow with a parameterless factory function.
+
+```csharp
+IFlowRegistrar<TCatalog> Register(string name, Func<TCatalog, Flow> flowFactory)
+```
+
+#### Parameters
+
+`name` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique flow name
+
+`flowFactory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TCatalog, [Flow](Flowthru.Flows.Flow.md)\>
+
+Factory function that creates the flow from catalog
+
+#### Returns
+
+ [IFlowRegistrar](Flowthru.Registry.IFlowRegistrar\-1.md)<TCatalog\>
+
+This registrar for method chaining
+
+#### Remarks
+
+Use this overload when the flow doesn't require parameters.
+
+### <a id="Flowthru_Registry_IFlowRegistrar_1_Register__1_System_String_System_Func__0___0_Flowthru_Flows_Flow____0_"></a> Register<TParams\>\(string, Func<TCatalog, TParams, Flow\>, TParams\)
+
+Registers a flow with a parameterized factory function.
+
+```csharp
+IFlowRegistrar<TCatalog> Register<TParams>(string name, Func<TCatalog, TParams, Flow> flowFactory, TParams parameters)
+```
+
+#### Parameters
+
+`name` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique flow name
+
+`flowFactory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-3)<TCatalog, TParams, [Flow](Flowthru.Flows.Flow.md)\>
+
+Factory function that creates the flow from catalog and parameters
+
+`parameters` TParams
+
+Parameter instance to pass to the flow
+
+#### Returns
+
+ [IFlowRegistrar](Flowthru.Registry.IFlowRegistrar\-1.md)<TCatalog\>
+
+This registrar for method chaining
+
+#### Type Parameters
+
+`TParams` 
+
+The type of parameters the flow requires
+
+#### Remarks
+
+<p>
+Use this overload when the flow requires configuration parameters.
+Parameters are strongly typed and checked at compile time.
+</p>
+<p>
+The factory signature must match: <code>Func&lt;TCatalog, TParams, Flow&gt;</code>
+</p>
+
+### <a id="Flowthru_Registry_IFlowRegistrar_1_WithDescription_System_String_"></a> WithDescription\(string\)
+
+Adds a description to the most recently registered flow.
+
+```csharp
+IFlowRegistrar<TCatalog> WithDescription(string description)
+```
+
+#### Parameters
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Human-readable description of what the flow does
+
+#### Returns
+
+ [IFlowRegistrar](Flowthru.Registry.IFlowRegistrar\-1.md)<TCatalog\>
+
+This registrar for method chaining
+
+#### Remarks
+
+Use this overload when fluently chaining after Register().
+
+### <a id="Flowthru_Registry_IFlowRegistrar_1_WithValidation_System_Action_Flowthru_Flows_Validation_ValidationOptions__"></a> WithValidation\(Action<ValidationOptions\>\)
+
+```csharp
+IFlowRegistrar<TCatalog> WithValidation(Action<ValidationOptions> configure)
+```
+
+#### Parameters
+
+`configure` [Action](https://learn.microsoft.com/dotnet/api/system.action\-1)<[ValidationOptions](Flowthru.Flows.Validation.ValidationOptions.md)\>
+
+#### Returns
+
+ [IFlowRegistrar](Flowthru.Registry.IFlowRegistrar\-1.md)<TCatalog\>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Registry.IPipelineRegistrar-1.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Registry.IPipelineRegistrar-1.md
new file mode 100644
index 00000000..05f962ad
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Registry.IPipelineRegistrar-1.md
@@ -0,0 +1,172 @@
+# <a id="Flowthru_Registry_IFlowRegistrar_1"></a> Interface IFlowRegistrar<TCatalog\>
+
+Namespace: [Flowthru.Registry](Flowthru.Registry.md)  
+Assembly: Flowthru.Core.dll  
+
+Fluent interface for registering pipelines in a type-safe manner.
+
+```csharp
+public interface IFlowRegistrar<TCatalog> where TCatalog : DataCatalogBase
+```
+
+#### Type Parameters
+
+`TCatalog` 
+
+The catalog type that pipelines will use
+
+## Remarks
+
+<p>
+This interface provides compile-time type safety by tying pipeline factories
+to a specific catalog type. The registrar validates that all registered
+pipelines accept the correct catalog type.
+</p>
+<p>
+<strong>Usage:</strong>
+<pre><code class="lang-csharp">protected override void RegisterPipelines(IFlowRegistrar&lt;MyCatalog&gt; registrar)
+{
+    // Pipeline without parameters
+    registrar.Register("processing", ProcessingPipeline.Create);
+
+    // Pipeline with parameters
+    registrar.Register("training", TrainPipeline.Create, new TrainOptions());
+
+    // Add metadata
+    registrar.WithDescription("processing", "Cleans and transforms raw data");
+}</code></pre>
+</p>
+
+## Methods
+
+### <a id="Flowthru_Registry_IFlowRegistrar_1_Register_System_String_System_Func__0_Flowthru_Pipelines_Pipeline__"></a> Register\(string, Func<TCatalog, Pipeline\>\)
+
+Registers a pipeline with a parameterless factory function.
+
+```csharp
+IFlowRegistrar<TCatalog> Register(string name, Func<TCatalog, Pipeline> pipelineFactory)
+```
+
+#### Parameters
+
+`name` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique pipeline name
+
+`pipelineFactory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TCatalog, [Pipeline](Flowthru.Flows.Pipeline.md)\>
+
+Factory function that creates the pipeline from catalog
+
+#### Returns
+
+ [IFlowRegistrar](Flowthru.Registry.IFlowRegistrar\-1.md)<TCatalog\>
+
+This registrar for method chaining
+
+#### Remarks
+
+Use this overload when the pipeline doesn't require parameters.
+
+### <a id="Flowthru_Registry_IFlowRegistrar_1_Register__1_System_String_System_Func__0___0_Flowthru_Pipelines_Pipeline____0_"></a> Register<TParams\>\(string, Func<TCatalog, TParams, Pipeline\>, TParams\)
+
+Registers a pipeline with a parameterized factory function.
+
+```csharp
+IFlowRegistrar<TCatalog> Register<TParams>(string name, Func<TCatalog, TParams, Pipeline> pipelineFactory, TParams parameters)
+```
+
+#### Parameters
+
+`name` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique pipeline name
+
+`pipelineFactory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-3)<TCatalog, TParams, [Pipeline](Flowthru.Flows.Pipeline.md)\>
+
+Factory function that creates the pipeline from catalog and parameters
+
+`parameters` TParams
+
+Parameter instance to pass to the pipeline
+
+#### Returns
+
+ [IFlowRegistrar](Flowthru.Registry.IFlowRegistrar\-1.md)<TCatalog\>
+
+This registrar for method chaining
+
+#### Type Parameters
+
+`TParams` 
+
+The type of parameters the pipeline requires
+
+#### Remarks
+
+<p>
+Use this overload when the pipeline requires configuration parameters.
+Parameters are strongly typed and checked at compile time.
+</p>
+<p>
+The factory signature must match: <code>Func&lt;TCatalog, TParams, Pipeline&gt;</code>
+</p>
+
+### <a id="Flowthru_Registry_IFlowRegistrar_1_WithDescription_System_String_"></a> WithDescription\(string\)
+
+Adds a description to the most recently registered pipeline.
+
+```csharp
+IFlowRegistrar<TCatalog> WithDescription(string description)
+```
+
+#### Parameters
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Human-readable description of what the pipeline does
+
+#### Returns
+
+ [IFlowRegistrar](Flowthru.Registry.IFlowRegistrar\-1.md)<TCatalog\>
+
+This registrar for method chaining
+
+#### Remarks
+
+Use this overload when fluently chaining after Register().
+
+### <a id="Flowthru_Registry_IFlowRegistrar_1_WithValidation_System_Action_Flowthru_Pipelines_Validation_ValidationOptions__"></a> WithValidation\(Action<ValidationOptions\>\)
+
+Configures validation options for the most recently registered pipeline.
+
+```csharp
+IFlowRegistrar<TCatalog> WithValidation(Action<ValidationOptions> configure)
+```
+
+#### Parameters
+
+`configure` [Action](https://learn.microsoft.com/dotnet/api/system.action\-1)<[ValidationOptions](Flowthru.Flows.Validation.ValidationOptions.md)\>
+
+Action to configure validation behavior
+
+#### Returns
+
+ [IFlowRegistrar](Flowthru.Registry.IFlowRegistrar\-1.md)<TCatalog\>
+
+This registrar for method chaining
+
+#### Remarks
+
+<p>
+Use this to opt into deep inspection for critical external data sources
+or to explicitly disable inspection for specific inputs.
+</p>
+<p>
+<strong>Example:</strong>
+</p>
+<pre><code class="lang-csharp">registrar.Register("data_processing", ProcessingPipeline.Create)
+  .WithValidation(validation =&gt; {
+    validation.Inspect(catalog.Companies, InspectionLevel.Deep);
+    validation.Inspect(catalog.Shuttles, InspectionLevel.Deep);
+  });</code></pre>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Registry.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Registry.md
new file mode 100644
index 00000000..fc10c535
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Registry.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Registry"></a> Namespace Flowthru.Registry
+
+### Interfaces
+
+ [IFlowRegistrar<TCatalog\>](Flowthru.Registry.IFlowRegistrar\-1.md)
+
+Fluent interface for registering flows in a type-safe manner.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Results.ConsoleResultFormatter.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Results.ConsoleResultFormatter.md
new file mode 100644
index 00000000..50bfdd17
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Results.ConsoleResultFormatter.md
@@ -0,0 +1,55 @@
+# <a id="Flowthru_Results_ConsoleResultFormatter"></a> Class ConsoleResultFormatter
+
+Namespace: [Flowthru.Results](Flowthru.Results.md)  
+Assembly: Flowthru.Core.dll  
+
+Formats pipeline results as human-readable console output.
+
+```csharp
+public class ConsoleResultFormatter : IFlowResultFormatter
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ConsoleResultFormatter](Flowthru.Results.ConsoleResultFormatter.md)
+
+#### Implements
+
+[IFlowResultFormatter](Flowthru.Results.IFlowResultFormatter.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+This is the default formatter used by the CLI.
+Produces colorful, detailed output suitable for interactive terminal sessions.
+
+## Methods
+
+### <a id="Flowthru_Results_ConsoleResultFormatter_Format_Flowthru_Flows_FlowResult_Microsoft_Extensions_Logging_ILogger_"></a> Format\(FlowResult, ILogger\)
+
+Formats and outputs the flow result.
+
+```csharp
+public void Format(FlowResult result, ILogger logger)
+```
+
+#### Parameters
+
+`result` [FlowResult](Flowthru.Flows.FlowResult.md)
+
+The flow execution result
+
+`logger` [ILogger](https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger)
+
+The logger to write output to
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Results.IFlowResultFormatter.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Results.IFlowResultFormatter.md
new file mode 100644
index 00000000..182763f3
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Results.IFlowResultFormatter.md
@@ -0,0 +1,45 @@
+# <a id="Flowthru_Results_IFlowResultFormatter"></a> Interface IFlowResultFormatter
+
+Namespace: [Flowthru.Results](Flowthru.Results.md)  
+Assembly: Flowthru.Core.dll  
+
+Interface for formatting flow execution results.
+
+```csharp
+public interface IFlowResultFormatter
+```
+
+## Remarks
+
+<p>
+Result formatters transform a FlowResult into human-readable or
+machine-readable output via logging.
+</p>
+<p>
+Built-in formatters:
+- <xref href="Flowthru.Results.ConsoleResultFormatter" data-throw-if-not-resolved="false"></xref> - Human-readable console output (default)
+</p>
+<p>
+Future formatters: JSON, Markdown, compact CI/CD format.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Results_IFlowResultFormatter_Format_Flowthru_Flows_FlowResult_Microsoft_Extensions_Logging_ILogger_"></a> Format\(FlowResult, ILogger\)
+
+Formats and outputs the flow result.
+
+```csharp
+void Format(FlowResult result, ILogger logger)
+```
+
+#### Parameters
+
+`result` [FlowResult](Flowthru.Flows.FlowResult.md)
+
+The flow execution result
+
+`logger` [ILogger](https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger)
+
+The logger to write output to
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Results.IPipelineResultFormatter.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Results.IPipelineResultFormatter.md
new file mode 100644
index 00000000..a635a6bf
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Results.IPipelineResultFormatter.md
@@ -0,0 +1,45 @@
+# <a id="Flowthru_Results_IFlowResultFormatter"></a> Interface IFlowResultFormatter
+
+Namespace: [Flowthru.Results](Flowthru.Results.md)  
+Assembly: Flowthru.Core.dll  
+
+Interface for formatting pipeline execution results.
+
+```csharp
+public interface IFlowResultFormatter
+```
+
+## Remarks
+
+<p>
+Result formatters transform a FlowResult into human-readable or
+machine-readable output via logging.
+</p>
+<p>
+Built-in formatters:
+- <xref href="Flowthru.Results.ConsoleResultFormatter" data-throw-if-not-resolved="false"></xref> - Human-readable console output (default)
+</p>
+<p>
+Future formatters: JSON, Markdown, compact CI/CD format.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Results_IFlowResultFormatter_Format_Flowthru_Pipelines_FlowResult_Microsoft_Extensions_Logging_ILogger_"></a> Format\(FlowResult, ILogger\)
+
+Formats and outputs the pipeline result.
+
+```csharp
+void Format(FlowResult result, ILogger logger)
+```
+
+#### Parameters
+
+`result` [FlowResult](Flowthru.Flows.FlowResult.md)
+
+The pipeline execution result
+
+`logger` [ILogger](https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger)
+
+The logger to write output to
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Results.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Results.md
new file mode 100644
index 00000000..d3723701
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Results.md
@@ -0,0 +1,14 @@
+# <a id="Flowthru_Results"></a> Namespace Flowthru.Results
+
+### Classes
+
+ [ConsoleResultFormatter](Flowthru.Results.ConsoleResultFormatter.md)
+
+Formats pipeline results as human-readable console output.
+
+### Interfaces
+
+ [IFlowResultFormatter](Flowthru.Results.IFlowResultFormatter.md)
+
+Interface for formatting flow execution results.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Services.FlowthruServiceBuilder.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Services.FlowthruServiceBuilder.md
new file mode 100644
index 00000000..035fa431
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Services.FlowthruServiceBuilder.md
@@ -0,0 +1,385 @@
+# <a id="Flowthru_Services_FlowthruServiceBuilder"></a> Class FlowthruServiceBuilder
+
+Namespace: [Flowthru.Services](Flowthru.Services.md)  
+Assembly: Flowthru.Core.dll  
+
+Fluent builder for configuring Flowthru service registration.
+
+```csharp
+public sealed class FlowthruServiceBuilder
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+This builder configures the service layer without CLI coupling.
+Use it to register catalogs, flows, and optional features.
+</p>
+<p>
+<strong>Basic Usage:</strong>
+<pre><code class="lang-csharp">services.AddFlowthru(flowthru =&gt;
+{
+    flowthru.RegisterCatalog(_ =&gt; new MyCatalog(dataPath));
+    flowthru.RegisterFlow("my_flow", MyFlow.Create);
+});</code></pre>
+</p>
+
+## Methods
+
+### <a id="Flowthru_Services_FlowthruServiceBuilder_ConfigureMetadata_System_Action_Flowthru_Meta_FlowthruMetadataBuilder__"></a> ConfigureMetadata\(Action<FlowthruMetadataBuilder\>\)
+
+Configures metadata export.
+
+```csharp
+public FlowthruServiceBuilder ConfigureMetadata(Action<FlowthruMetadataBuilder> configure)
+```
+
+#### Parameters
+
+`configure` [Action](https://learn.microsoft.com/dotnet/api/system.action\-1)<[FlowthruMetadataBuilder](Flowthru.Meta.FlowthruMetadataBuilder.md)\>
+
+Action to configure the metadata builder
+
+#### Returns
+
+ [FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)
+
+This builder for method chaining
+
+#### Remarks
+
+<p>
+Metadata export is optional. If not configured, flows will execute
+without generating DAG diagrams or metadata files.
+</p>
+<p>
+<strong>Example:</strong>
+<pre><code class="lang-csharp">flowthru.ConfigureMetadata(meta =&gt;
+{
+    meta.WithOutputDirectory("metadata")
+        .AddProvider&lt;JsonMetadataProvider, JsonMetadataProviderBuilder&gt;()
+        .AddProvider&lt;MermaidMetadataProvider, MermaidMetadataProviderBuilder&gt;();
+});</code></pre>
+</p>
+
+### <a id="Flowthru_Services_FlowthruServiceBuilder_RegisterCatalog__1"></a> RegisterCatalog<TCatalog\>\(\)
+
+Registers a catalog type with constructor injection.
+
+```csharp
+public FlowthruServiceBuilder RegisterCatalog<TCatalog>() where TCatalog : CatalogAbstract
+```
+
+#### Returns
+
+ [FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TCatalog` 
+
+The catalog type
+
+#### Remarks
+
+The catalog will be resolved from the DI container, allowing constructor
+parameter injection (e.g., IConfiguration, IOptions).
+
+### <a id="Flowthru_Services_FlowthruServiceBuilder_RegisterCatalog_Flowthru_Data_CatalogAbstract_"></a> RegisterCatalog\(CatalogAbstract\)
+
+Registers a catalog instance directly.
+
+```csharp
+public FlowthruServiceBuilder RegisterCatalog(CatalogAbstract catalog)
+```
+
+#### Parameters
+
+`catalog` [CatalogAbstract](Flowthru.Data.CatalogAbstract.md)
+
+The catalog instance
+
+#### Returns
+
+ [FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)
+
+This builder for method chaining
+
+#### Remarks
+
+Use this when the catalog doesn't require dependency injection.
+
+### <a id="Flowthru_Services_FlowthruServiceBuilder_RegisterCatalog__1_System_Func_System_IServiceProvider___0__"></a> RegisterCatalog<TCatalog\>\(Func<IServiceProvider, TCatalog\>\)
+
+Registers a catalog factory that receives the service provider.
+
+```csharp
+public FlowthruServiceBuilder RegisterCatalog<TCatalog>(Func<IServiceProvider, TCatalog> catalogFactory) where TCatalog : CatalogAbstract
+```
+
+#### Parameters
+
+`catalogFactory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IServiceProvider](https://learn.microsoft.com/dotnet/api/system.iserviceprovider), TCatalog\>
+
+Factory function to create the catalog
+
+#### Returns
+
+ [FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TCatalog` 
+
+The concrete catalog type
+
+#### Remarks
+
+Use this when the catalog needs to resolve services during construction,
+or when construction requires parameters unavailable at the call site.
+
+### <a id="Flowthru_Services_FlowthruServiceBuilder_RegisterCatalogs_System_Collections_Generic_IEnumerable_Flowthru_Data_CatalogAbstract__"></a> RegisterCatalogs\(IEnumerable<CatalogAbstract\>\)
+
+Registers a collection of pre-built catalog instances produced by iterative or dynamic
+construction — the fan-out pattern where N identical-shaped catalogs differ only by
+their construction parameters (e.g., one catalog per US state).
+
+```csharp
+public FlowthruServiceBuilder RegisterCatalogs(IEnumerable<CatalogAbstract> catalogs)
+```
+
+#### Parameters
+
+`catalogs` [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<[CatalogAbstract](Flowthru.Data.CatalogAbstract.md)\>
+
+The catalog instances to register
+
+#### Returns
+
+ [FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)
+
+This builder for method chaining
+
+#### Remarks
+
+All registered catalogs will receive DI service injection and appear in
+<xref href="Flowthru.Services.IFlowthruService.Catalogs" data-throw-if-not-resolved="false"></xref>. Use with <xref href="Flowthru.Services.FlowthruServiceBuilder.RegisterFlows(System.Func%7bSystem.IServiceProvider%2cSystem.Collections.Generic.Dictionary%7bSystem.String%2cFlowthru.Flows.Flow%7d%7d)" data-throw-if-not-resolved="false"></xref> to
+wire per-catalog flows in a loop.
+
+### <a id="Flowthru_Services_FlowthruServiceBuilder_RegisterCatalogs_System_Func_System_IServiceProvider_System_Collections_Generic_IEnumerable_Flowthru_Data_CatalogAbstract___"></a> RegisterCatalogs\(Func<IServiceProvider, IEnumerable<CatalogAbstract\>\>\)
+
+Registers catalogs produced by a factory that receives the service provider —
+useful when catalog construction itself requires DI resolution.
+
+```csharp
+public FlowthruServiceBuilder RegisterCatalogs(Func<IServiceProvider, IEnumerable<CatalogAbstract>> catalogsFactory)
+```
+
+#### Parameters
+
+`catalogsFactory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IServiceProvider](https://learn.microsoft.com/dotnet/api/system.iserviceprovider), [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<[CatalogAbstract](Flowthru.Data.CatalogAbstract.md)\>\>
+
+Factory that returns the catalog collection
+
+#### Returns
+
+ [FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)
+
+This builder for method chaining
+
+### <a id="Flowthru_Services_FlowthruServiceBuilder_RegisterFlow_System_String_System_Delegate_System_String_"></a> RegisterFlow\(string, Delegate, string?\)
+
+Registers a flow by inspecting the delegate's parameter types at runtime.
+Parameters that extend <xref href="Flowthru.Data.CatalogAbstract" data-throw-if-not-resolved="false"></xref> are resolved from DI as catalogs.
+All other parameters are resolved from DI as services.
+
+```csharp
+public FlowthruServiceBuilder RegisterFlow(string label, Delegate flow, string? configurationSection = null)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique flow name
+
+`flow` [Delegate](https://learn.microsoft.com/dotnet/api/system.delegate)
+
+A method group or delegate whose parameters are catalogs, services, or config objects
+
+`configurationSection` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+Optional configuration section path. When provided, the last non-catalog, non-service parameter
+is bound from configuration instead of DI.
+
+#### Returns
+
+ [FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)
+
+This builder for method chaining
+
+### <a id="Flowthru_Services_FlowthruServiceBuilder_RegisterFlows_System_Func_System_IServiceProvider_System_Collections_Generic_Dictionary_System_String_Flowthru_Flows_Flow___"></a> RegisterFlows\(Func<IServiceProvider, Dictionary<string, Flow\>\>\)
+
+Escape-hatch for registering flows via a full-access service provider factory.
+
+```csharp
+public FlowthruServiceBuilder RegisterFlows(Func<IServiceProvider, Dictionary<string, Flow>> flowFactory)
+```
+
+#### Parameters
+
+`flowFactory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IServiceProvider](https://learn.microsoft.com/dotnet/api/system.iserviceprovider), [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [Flow](Flowthru.Flows.Flow.md)\>\>
+
+Factory function that receives the service provider and returns the flow dictionary
+
+#### Returns
+
+ [FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)
+
+This builder for method chaining
+
+#### Remarks
+
+Prefer <xref href="Flowthru.Services.FlowthruServiceBuilder.RegisterFlow(System.String%2cSystem.Delegate%2cSystem.String)" data-throw-if-not-resolved="false"></xref> for standard flow registration.
+Use this only when you need full service provider access during flow construction.
+
+### <a id="Flowthru_Services_FlowthruServiceBuilder_UseConfiguration_System_Action_Flowthru_Configuration_FlowthruConfigurationOptions__"></a> UseConfiguration\(Action<FlowthruConfigurationOptions\>?\)
+
+Enables configuration loading from JSON and YAML files.
+
+```csharp
+public FlowthruServiceBuilder UseConfiguration(Action<FlowthruConfigurationOptions>? configure = null)
+```
+
+#### Parameters
+
+`configure` [Action](https://learn.microsoft.com/dotnet/api/system.action\-1)<[FlowthruConfigurationOptions](Flowthru.Configuration.FlowthruConfigurationOptions.md)\>?
+
+Optional action to configure how configuration files are loaded
+
+#### Returns
+
+ [FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)
+
+This builder for method chaining
+
+#### Remarks
+
+By default, configuration is loaded from appsettings.json and environment-specific overrides.
+
+### <a id="Flowthru_Services_FlowthruServiceBuilder_UseStorageStrategy__1"></a> UseStorageStrategy<TStrategy\>\(\)
+
+Registers a storage entry factory (for environment-specific entries).
+
+```csharp
+public FlowthruServiceBuilder UseStorageStrategy<TStrategy>() where TStrategy : class, IStorageEntryFactory
+```
+
+#### Returns
+
+ [FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TStrategy` 
+
+The storage strategy type
+
+#### Remarks
+
+<p>
+Storage strategies enable environment-specific catalog entries:
+</p>
+<pre><code class="lang-csharp">if (env.IsDevelopment())
+{
+    flowthru.UseStorageStrategy&lt;CsvStorageEntryFactory&gt;();
+}
+else if (env.IsProduction())
+{
+    flowthru.UseStorageStrategy&lt;DatabaseStorageEntryFactory&gt;();
+}
+else if (env.IsTest())
+{
+    flowthru.UseStorageStrategy&lt;MemoryStorageEntryFactory&gt;();
+}</code></pre>
+
+### <a id="Flowthru_Services_FlowthruServiceBuilder_UseStorageStrategy_Flowthru_Data_Storage_Strategies_IStorageEntryFactory_"></a> UseStorageStrategy\(IStorageEntryFactory\)
+
+Registers a storage entry factory instance.
+
+```csharp
+public FlowthruServiceBuilder UseStorageStrategy(IStorageEntryFactory strategy)
+```
+
+#### Parameters
+
+`strategy` [IStorageEntryFactory](Flowthru.Data.Storage.Strategies.IStorageEntryFactory.md)
+
+The storage strategy instance
+
+#### Returns
+
+ [FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)
+
+This builder for method chaining
+
+### <a id="Flowthru_Services_FlowthruServiceBuilder_UseStorageStrategy_System_Func_System_IServiceProvider_Flowthru_Data_Storage_Strategies_IStorageEntryFactory__"></a> UseStorageStrategy\(Func<IServiceProvider, IStorageEntryFactory\>\)
+
+Registers a storage entry factory using a factory function.
+
+```csharp
+public FlowthruServiceBuilder UseStorageStrategy(Func<IServiceProvider, IStorageEntryFactory> strategyFactory)
+```
+
+#### Parameters
+
+`strategyFactory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IServiceProvider](https://learn.microsoft.com/dotnet/api/system.iserviceprovider), [IStorageEntryFactory](Flowthru.Data.Storage.Strategies.IStorageEntryFactory.md)\>
+
+Factory function to create the strategy
+
+#### Returns
+
+ [FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)
+
+This builder for method chaining
+
+### <a id="Flowthru_Services_FlowthruServiceBuilder_WithDescription_System_String_"></a> WithDescription\(string\)
+
+Adds a description to the most recently registered flow.
+
+```csharp
+public FlowthruServiceBuilder WithDescription(string description)
+```
+
+#### Parameters
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Human-readable description of what the flow does
+
+#### Returns
+
+ [FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)
+
+This builder for method chaining
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Services.IFlowthruService.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Services.IFlowthruService.md
new file mode 100644
index 00000000..ce32182a
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Services.IFlowthruService.md
@@ -0,0 +1,248 @@
+# <a id="Flowthru_Services_IFlowthruService"></a> Interface IFlowthruService
+
+Namespace: [Flowthru.Services](Flowthru.Services.md)  
+Assembly: Flowthru.Core.dll  
+
+Core service for executing Flowthru flows programmatically.
+
+```csharp
+public interface IFlowthruService
+```
+
+## Remarks
+
+<p>
+This service is DI-injectable and CLI-agnostic, enabling use in:
+- Console applications (via shallow CLI wrapper)
+- ASP.NET Core applications (controller/background service injection)
+- Azure Functions (function injection)
+- Unit tests (with mocked dependencies)
+</p>
+<p>
+<strong>Usage Example:</strong>
+<pre><code class="lang-csharp">public class DataProcessingService
+{
+    private readonly IFlowthruService _flowthru;
+
+    public DataProcessingService(IFlowthruService flowthru)
+    {
+        _flowthru = flowthru;
+    }
+
+    public async Task ProcessData()
+    {
+        // Execute with optional slicing
+        var options = new ExecutionOptions
+        {
+            DryRun = false,
+            SliceStrategy = new FlowSliceStrategy
+            {
+                Flows = new HashSet&lt;string&gt; { "data_processing" }
+            }
+        };
+
+        var result = await _flowthru.ExecuteFlowAsync(options);
+
+        if (result.Success)
+        {
+            Console.WriteLine($"Processed {result.StepResults.Count} flow");
+        }
+    }
+}</code></pre>
+</p>
+
+## Properties
+
+### <a id="Flowthru_Services_IFlowthruService_Catalogs"></a> Catalogs
+
+Gets all registered catalog instances.
+
+```csharp
+IReadOnlyList<CatalogAbstract> Catalogs { get; }
+```
+
+#### Property Value
+
+ [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[CatalogAbstract](Flowthru.Data.CatalogAbstract.md)\>
+
+### <a id="Flowthru_Services_IFlowthruService_FlowNames"></a> FlowNames
+
+Gets the names of all registered flows.
+
+```csharp
+IReadOnlyCollection<string> FlowNames { get; }
+```
+
+#### Property Value
+
+ [IReadOnlyCollection](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlycollection\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+## Methods
+
+### <a id="Flowthru_Services_IFlowthruService_ExecuteFlowAsync_Flowthru_Flows_ExecutionOptions_System_Boolean_System_String_System_Threading_CancellationToken_"></a> ExecuteFlowAsync\(ExecutionOptions?, bool, string?, CancellationToken\)
+
+Executes all registered flows, optionally sliced by criteria.
+
+```csharp
+Task<FlowResult> ExecuteFlowAsync(ExecutionOptions? options = null, bool exportMetadata = true, string? metadataOutputDirectory = null, CancellationToken cancellationToken = default)
+```
+
+#### Parameters
+
+`options` [ExecutionOptions](Flowthru.Flows.ExecutionOptions.md)?
+
+Execution options with optional slice strategy
+
+`exportMetadata` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+Whether to export DAG metadata
+
+`metadataOutputDirectory` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+Override for metadata output directory
+
+`cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+Cancellation token
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<[FlowResult](Flowthru.Flows.FlowResult.md)\>
+
+Execution result with timing, step results, and status
+
+#### Remarks
+
+This method always merges all registered flows into a single DAG,
+then applies optional slicing criteria from the execution options.
+This enables cross-flow queries (e.g., --to-data across all flows).
+To execute only specific flows, use SliceStrategy.Flows.
+
+The method performs:
+1. Flow merging into unified DAG
+2. Service injection
+3. DAG building and slice application
+4. Metadata export (if requested)
+5. External input validation
+6. Flow execution (unless dry run)
+7. Result formatting
+
+### <a id="Flowthru_Services_IFlowthruService_GetDagMetadata_System_String_Flowthru_Flows_FlowSliceStrategy_"></a> GetDagMetadata\(string?, FlowSliceStrategy?\)
+
+Gets the full DAG metadata for flow introspection.
+
+```csharp
+DagMetadata GetDagMetadata(string? flowName = null, FlowSliceStrategy? sliceStrategy = null)
+```
+
+#### Parameters
+
+`flowName` [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+Optional flow name to inspect a single flow.
+When null, all registered flows are merged into a unified DAG.
+
+`sliceStrategy` [FlowSliceStrategy](Flowthru.Flows.FlowSliceStrategy.md)?
+
+Optional slice strategy to filter the DAG (e.g., from-node).
+When provided, the returned metadata includes slice overlay information
+(SlicedNodeIds and SlicedItemKeys) identifying which nodes
+and data are in the active execution subset.
+
+#### Returns
+
+ [DagMetadata](Flowthru.Meta.Models.DagMetadata.md)
+
+Full DAG metadata including steps, catalog entries, edges, schemas,
+and producer-consumer relationships.
+
+#### Remarks
+
+This method does not execute the flow. It returns structural metadata
+useful for visualization, impact analysis, data lineage, and debugging.
+
+Examples:
+<pre><code class="lang-csharp">// Inspect all flow merged
+var dag = flowthru.GetDagMetadata();
+
+// Inspect a single flow
+var dag = flowthru.GetDagMetadata("DataProcessing");
+
+// Inspect downstream of a specific flow node
+var dag = flowthru.GetDagMetadata(sliceStrategy: new FlowSliceStrategy
+{
+    FromNodes = new HashSet&lt;string&gt; { "PreprocessCompanies" }
+});</code></pre>
+
+#### Exceptions
+
+ [KeyNotFoundException](https://learn.microsoft.com/dotnet/api/system.collections.generic.keynotfoundexception)
+
+Thrown if <code class="paramref">flowName</code> is specified but not found.
+
+### <a id="Flowthru_Services_IFlowthruService_GetFlowMetadata_System_String_"></a> GetFlowMetadata\(string\)
+
+Gets metadata about a Flow's structure.
+
+```csharp
+FlowMetadata GetFlowMetadata(string flowName)
+```
+
+#### Parameters
+
+`flowName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Flow name
+
+#### Returns
+
+ [FlowMetadata](Flowthru.Services.Models.FlowMetadata.md)
+
+Flow metadata
+
+#### Remarks
+
+Returns structural information without executing the flow.
+The flow must be built for accurate layer and input information.
+
+#### Exceptions
+
+ [KeyNotFoundException](https://learn.microsoft.com/dotnet/api/system.collections.generic.keynotfoundexception)
+
+Thrown if flow name not found
+
+### <a id="Flowthru_Services_IFlowthruService_ValidateFlowAsync_System_String_System_Threading_CancellationToken_"></a> ValidateFlowAsync\(string, CancellationToken\)
+
+Validates all external inputs (Layer 0) for a flow.
+
+```csharp
+Task<ValidationResult> ValidateFlowAsync(string flowName, CancellationToken cancellationToken = default)
+```
+
+#### Parameters
+
+`flowName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Flow name
+
+`cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+Cancellation token
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<[ValidationResult](Flowthru.Data.Validation.ValidationResult.md)\>
+
+Validation result
+
+#### Remarks
+
+Checks accessibility of external data sources without executing the flow.
+Useful for pre-flight validation in CI/CD or scheduled jobs.
+
+#### Exceptions
+
+ [KeyNotFoundException](https://learn.microsoft.com/dotnet/api/system.collections.generic.keynotfoundexception)
+
+Thrown if flow name not found
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Services.Models.FlowMetadata.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Services.Models.FlowMetadata.md
new file mode 100644
index 00000000..eafe80fb
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Services.Models.FlowMetadata.md
@@ -0,0 +1,108 @@
+# <a id="Flowthru_Services_Models_FlowMetadata"></a> Class FlowMetadata
+
+Namespace: [Flowthru.Services.Models](Flowthru.Services.Models.md)  
+Assembly: Flowthru.Core.dll  
+
+Metadata about a flow's structure and configuration.
+
+```csharp
+public sealed record FlowMetadata : IEquatable<FlowMetadata>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowMetadata](Flowthru.Services.Models.FlowMetadata.md)
+
+#### Implements
+
+[IEquatable<FlowMetadata\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Provides read-only information about a flow without executing it.
+Useful for discovery, validation, and UI generation.
+
+## Properties
+
+### <a id="Flowthru_Services_Models_FlowMetadata_Description"></a> Description
+
+Optional description of the flow's purpose.
+
+```csharp
+public string? Description { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Services_Models_FlowMetadata_ExternalInputs"></a> ExternalInputs
+
+Labels of external data sources (Layer 0 inputs).
+
+```csharp
+public required IReadOnlyList<string> ExternalInputs { get; init; }
+```
+
+#### Property Value
+
+ [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+### <a id="Flowthru_Services_Models_FlowMetadata_IsBuilt"></a> IsBuilt
+
+Whether the flow has been built (DAG analyzed).
+
+```csharp
+public required bool IsBuilt { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Services_Models_FlowMetadata_LayerCount"></a> LayerCount
+
+Number of execution layers in the flow's DAG.
+
+```csharp
+public required int LayerCount { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+### <a id="Flowthru_Services_Models_FlowMetadata_Name"></a> Name
+
+The flow's registered name.
+
+```csharp
+public required string Name { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Services_Models_FlowMetadata_StepCount"></a> StepCount
+
+Total number of steps in the flow.
+
+```csharp
+public required int StepCount { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Services.Models.PipelineExecutionRequest.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Services.Models.PipelineExecutionRequest.md
new file mode 100644
index 00000000..6e8284f1
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Services.Models.PipelineExecutionRequest.md
@@ -0,0 +1,109 @@
+# <a id="Flowthru_Services_Models_PipelineExecutionRequest"></a> Class PipelineExecutionRequest
+
+Namespace: [Flowthru.Services.Models](Flowthru.Services.Models.md)  
+Assembly: Flowthru.Core.dll  
+
+Request model for pipeline execution.
+
+```csharp
+public record PipelineExecutionRequest : IEquatable<PipelineExecutionRequest>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PipelineExecutionRequest](Flowthru.Services.Models.PipelineExecutionRequest.md)
+
+#### Implements
+
+[IEquatable<PipelineExecutionRequest\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Encapsulates all configuration needed to execute a pipeline programmatically,
+separate from CLI argument parsing.
+
+## Properties
+
+### <a id="Flowthru_Services_Models_PipelineExecutionRequest_ExportMetadata"></a> ExportMetadata
+
+Whether to export DAG metadata.
+
+```csharp
+public bool ExportMetadata { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+#### Remarks
+
+Defaults to true. Only applies if a metadata builder is configured.
+
+### <a id="Flowthru_Services_Models_PipelineExecutionRequest_MetadataOutputDirectory"></a> MetadataOutputDirectory
+
+Output directory for metadata (if null, uses default from metadata builder).
+
+```csharp
+public string? MetadataOutputDirectory { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Services_Models_PipelineExecutionRequest_Options"></a> Options
+
+Execution options (dry run, parallel execution, etc.).
+
+```csharp
+public ExecutionOptions? Options { get; init; }
+```
+
+#### Property Value
+
+ [ExecutionOptions](Flowthru.Flows.ExecutionOptions.md)?
+
+#### Remarks
+
+If null, uses default execution options.
+
+### <a id="Flowthru_Services_Models_PipelineExecutionRequest_FlowName"></a> FlowName
+
+Name of the pipeline to execute.
+
+```csharp
+public required string FlowName { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Services_Models_PipelineExecutionRequest_SliceStrategy"></a> SliceStrategy
+
+Optional slicing strategy to execute a subset of the pipeline.
+
+```csharp
+public FlowSliceStrategy? SliceStrategy { get; init; }
+```
+
+#### Property Value
+
+ [FlowSliceStrategy](Flowthru.Flows.FlowSliceStrategy.md)?
+
+#### Remarks
+
+If null or IsSliced=false, the entire pipeline executes.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Services.Models.PipelineMetadata.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Services.Models.PipelineMetadata.md
new file mode 100644
index 00000000..e608e10e
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Services.Models.PipelineMetadata.md
@@ -0,0 +1,108 @@
+# <a id="Flowthru_Services_Models_PipelineMetadata"></a> Class PipelineMetadata
+
+Namespace: [Flowthru.Services.Models](Flowthru.Services.Models.md)  
+Assembly: Flowthru.Core.dll  
+
+Metadata about a pipeline's structure and configuration.
+
+```csharp
+public sealed record PipelineMetadata : IEquatable<PipelineMetadata>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PipelineMetadata](Flowthru.Services.Models.PipelineMetadata.md)
+
+#### Implements
+
+[IEquatable<PipelineMetadata\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Provides read-only information about a pipeline without executing it.
+Useful for discovery, validation, and UI generation.
+
+## Properties
+
+### <a id="Flowthru_Services_Models_PipelineMetadata_Description"></a> Description
+
+Optional description of the pipeline's purpose.
+
+```csharp
+public string? Description { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Services_Models_PipelineMetadata_ExternalInputs"></a> ExternalInputs
+
+Labels of external data sources (Layer 0 inputs).
+
+```csharp
+public required IReadOnlyList<string> ExternalInputs { get; init; }
+```
+
+#### Property Value
+
+ [IReadOnlyList](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+### <a id="Flowthru_Services_Models_PipelineMetadata_IsBuilt"></a> IsBuilt
+
+Whether the pipeline has been built (DAG analyzed).
+
+```csharp
+public required bool IsBuilt { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Services_Models_PipelineMetadata_LayerCount"></a> LayerCount
+
+Number of execution layers in the pipeline's DAG.
+
+```csharp
+public required int LayerCount { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+### <a id="Flowthru_Services_Models_PipelineMetadata_Name"></a> Name
+
+The pipeline's registered name.
+
+```csharp
+public required string Name { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Services_Models_PipelineMetadata_NodeCount"></a> NodeCount
+
+Total number of nodes in the pipeline.
+
+```csharp
+public required int NodeCount { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Services.Models.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Services.Models.md
new file mode 100644
index 00000000..34276b54
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Services.Models.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Services_Models"></a> Namespace Flowthru.Services.Models
+
+### Classes
+
+ [FlowMetadata](Flowthru.Services.Models.FlowMetadata.md)
+
+Metadata about a flow's structure and configuration.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Services.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Services.md
new file mode 100644
index 00000000..7fb5f6d2
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Services.md
@@ -0,0 +1,18 @@
+# <a id="Flowthru_Services"></a> Namespace Flowthru.Services
+
+### Namespaces
+
+ [Flowthru.Services.Models](Flowthru.Services.Models.md)
+
+### Classes
+
+ [FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)
+
+Fluent builder for configuring Flowthru service registration.
+
+### Interfaces
+
+ [IFlowthruService](Flowthru.Services.IFlowthruService.md)
+
+Core service for executing Flowthru flows programmatically.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.Factory.StepFactory.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.Factory.StepFactory.md
new file mode 100644
index 00000000..d14f71ba
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.Factory.StepFactory.md
@@ -0,0 +1,74 @@
+# <a id="Flowthru_Steps_Factory_StepFactory"></a> Class StepFactory
+
+Namespace: [Flowthru.Steps.Factory](Flowthru.Steps.Factory.md)  
+Assembly: Flowthru.Core.dll  
+
+Factory for creating step instances using TypeActivator.
+
+```csharp
+public static class StepFactory
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[StepFactory](Flowthru.Steps.Factory.StepFactory.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Design Pattern:</strong> Factory Pattern - provides a centralized location for
+step instantiation logic.
+</p>
+<p>
+This is a thin wrapper around TypeActivator, providing a domain-specific API for
+creating steps. Could be extended in the future with:
+- Step validation logic
+- Pre/post-creation hooks
+- Step decoration/wrapping
+</p>
+
+## Methods
+
+### <a id="Flowthru_Steps_Factory_StepFactory_Create__1"></a> Create<TStep\>\(\)
+
+Creates a new instance of the specified step type.
+
+```csharp
+public static TStep Create<TStep>() where TStep : new()
+```
+
+#### Returns
+
+ TStep
+
+A new step instance
+
+#### Type Parameters
+
+`TStep` 
+
+The step type to instantiate
+
+#### Remarks
+
+<p>
+<strong>Requirements:</strong>
+- TStep must inherit from StepBase&lt;TInput, TOutput&gt;
+- TStep must have a parameterless constructor
+</p>
+<p>
+These requirements are enforced at compile-time via generic constraints in
+FlowBuilder.AddStep methods.
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.Factory.TypeActivator.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.Factory.TypeActivator.md
new file mode 100644
index 00000000..29f73898
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.Factory.TypeActivator.md
@@ -0,0 +1,114 @@
+# <a id="Flowthru_Steps_Factory_TypeActivator"></a> Class TypeActivator
+
+Namespace: [Flowthru.Steps.Factory](Flowthru.Steps.Factory.md)  
+Assembly: Flowthru.Core.dll  
+
+Factory for creating instances of types using compiled expression trees for performance.
+
+```csharp
+public static class TypeActivator
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[TypeActivator](Flowthru.Steps.Factory.TypeActivator.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Design Pattern:</strong> Factory Pattern with caching - creates instances of types
+using reflection on first call, then caches compiled expression trees for subsequent calls.
+</p>
+<p>
+<strong>Performance:</strong>
+- First call uses Expression.Compile() which has overhead
+- Subsequent calls use cached delegate which is nearly as fast as `new T()`
+- Significantly faster than Activator.CreateInstance&lt;T&gt;() for repeated calls
+</p>
+<p>
+<strong>Inspiration:</strong> ChainSharp uses similar pattern for node instantiation.
+</p>
+<p>
+<strong>Thread Safety:</strong> This class is thread-safe. Multiple threads can safely
+call Create&lt;T&gt;() concurrently.
+</p>
+
+## Properties
+
+### <a id="Flowthru_Steps_Factory_TypeActivator_CacheCount"></a> CacheCount
+
+Gets the number of cached factory functions.
+
+```csharp
+public static int CacheCount { get; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+## Methods
+
+### <a id="Flowthru_Steps_Factory_TypeActivator_ClearCache"></a> ClearCache\(\)
+
+Clears the factory cache.
+
+```csharp
+public static void ClearCache()
+```
+
+#### Remarks
+
+Useful for testing or memory management in long-running applications
+that dynamically load/unload types.
+
+### <a id="Flowthru_Steps_Factory_TypeActivator_Create__1"></a> Create<T\>\(\)
+
+Creates an instance of type <code class="typeparamref">T</code> using a cached factory.
+
+```csharp
+public static T Create<T>() where T : new()
+```
+
+#### Returns
+
+ T
+
+A new instance of type T
+
+#### Type Parameters
+
+`T` 
+
+The type to instantiate (must have parameterless constructor)
+
+#### Remarks
+
+<p>
+<strong>Compile-Time Safety:</strong> The `new()` constraint ensures that T has a
+parameterless constructor. This is enforced at compile-time by the C# compiler.
+</p>
+<p>
+<strong>Caching Strategy:</strong>
+- First call: Compiles an expression tree and caches the resulting delegate
+- Subsequent calls: Reuses the cached delegate
+- One cache entry per type T
+</p>
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if type T does not have a parameterless constructor
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.Factory.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.Factory.md
new file mode 100644
index 00000000..0ebab3e3
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.Factory.md
@@ -0,0 +1,12 @@
+# <a id="Flowthru_Steps_Factory"></a> Namespace Flowthru.Steps.Factory
+
+### Classes
+
+ [StepFactory](Flowthru.Steps.Factory.StepFactory.md)
+
+Factory for creating step instances using TypeActivator.
+
+ [TypeActivator](Flowthru.Steps.Factory.TypeActivator.md)
+
+Factory for creating instances of types using compiled expression trees for performance.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.NoData.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.NoData.md
new file mode 100644
index 00000000..3236968f
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.NoData.md
@@ -0,0 +1,182 @@
+# <a id="Flowthru_Steps_NoData"></a> Class NoData
+
+Namespace: [Flowthru.Steps](Flowthru.Steps.md)  
+Assembly: Flowthru.Core.dll  
+
+Marker type representing "no meaningful data" for nodes with side-effects or data generation.
+Used as input/output type in NodeBase when a node doesn't consume or produce meaningful data.
+
+```csharp
+public sealed class NoData
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[NoData](Flowthru.Steps.NoData.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Design Rationale:</strong> NoData provides a type-safe way to represent nodes that:
+- Generate data without inputs (e.g., synthetic data generation, seeding)
+- Perform side-effects without outputs (e.g., validation, logging, diagnostics)
+</p>
+<p>
+This pattern is inspired by functional programming's "Unit" type but uses more intuitive
+naming for .NET developers unfamiliar with functional terminology.
+</p>
+<p>
+<strong>Usage Examples:</strong>
+</p>
+<pre><code class="lang-csharp">// Node with no inputs (data generation)
+public class GenerateDataNode : NodeBase&lt;NoData, OutputSchema&gt;
+{
+    protected override Task&lt;IEnumerable&lt;OutputSchema&gt;&gt; Transform(IEnumerable&lt;NoData&gt; input)
+    {
+        // Generate data from scratch...
+        return Task.FromResult(generatedData);
+    }
+}
+
+// Node with no outputs (side-effects only)
+public class ValidateNode : NodeBase&lt;InputSchema, NoData&gt;
+{
+    protected override Task&lt;IEnumerable&lt;NoData&gt;&gt; Transform(IEnumerable&lt;InputSchema&gt; input)
+    {
+        // Perform validation, logging, etc...
+        return Task.FromResult(Enumerable.Repeat(NoData.Value, 1));
+    }
+}</code></pre>
+<p>
+<strong>Pipeline Registration:</strong> Use NoData type directly - it automatically converts
+to a unique NullCatalogDataset instance:
+</p>
+<pre><code class="lang-csharp">// Simple syntax with automatic unique key generation
+pipeline.AddStep&lt;ValidationNode&gt;(
+    input: catalog.InputData,
+    output: NoData.Output  // or just: NoData.Discard
+);
+
+pipeline.AddStep&lt;GenerateDataNode&gt;(
+    input: NoData.Input,  // or just: NoData.None
+    output: catalog.GeneratedData
+);</code></pre>
+
+## Fields
+
+### <a id="Flowthru_Steps_NoData_Value"></a> Value
+
+Singleton instance of NoData.
+Use this value when returning NoData from node transformations.
+
+```csharp
+public static readonly NoData Value
+```
+
+#### Field Value
+
+ [NoData](Flowthru.Steps.NoData.md)
+
+## Properties
+
+### <a id="Flowthru_Steps_NoData_Discard"></a> Discard
+
+Creates a unique null catalog entry for use as a node output (side-effect-only nodes).
+Semantic alias for Output - use whichever reads better in context.
+
+```csharp
+public static IItem<NoData> Discard { get; }
+```
+
+#### Property Value
+
+ [IItem](Flowthru.Data.IItem\-1.md)<[NoData](Flowthru.Steps.NoData.md)\>
+
+### <a id="Flowthru_Steps_NoData_Input"></a> Input
+
+Creates a unique null catalog entry for use as a node input (no-input nodes).
+Each call generates a new instance with a unique key to avoid DAG conflicts.
+
+```csharp
+public static IItem<NoData> Input { get; }
+```
+
+#### Property Value
+
+ [IItem](Flowthru.Data.IItem\-1.md)<[NoData](Flowthru.Steps.NoData.md)\>
+
+#### Remarks
+
+Alias for readability in pipeline declarations where nodes don't consume external inputs.
+
+### <a id="Flowthru_Steps_NoData_None"></a> None
+
+Creates a unique null catalog entry for use as a node input (no-input nodes).
+Semantic alias for Input - use whichever reads better in context.
+
+```csharp
+public static IItem<NoData> None { get; }
+```
+
+#### Property Value
+
+ [IItem](Flowthru.Data.IItem\-1.md)<[NoData](Flowthru.Steps.NoData.md)\>
+
+### <a id="Flowthru_Steps_NoData_Output"></a> Output
+
+Creates a unique null catalog entry for use as a node output (side-effect-only nodes).
+Each call generates a new instance with a unique key to avoid DAG conflicts.
+
+```csharp
+public static IItem<NoData> Output { get; }
+```
+
+#### Property Value
+
+ [IItem](Flowthru.Data.IItem\-1.md)<[NoData](Flowthru.Steps.NoData.md)\>
+
+#### Remarks
+
+Alias for readability in pipeline declarations where nodes produce no meaningful output.
+
+## Methods
+
+### <a id="Flowthru_Steps_NoData_Result"></a> Result\(\)
+
+Returns the standard NoData result for side-effect-only nodes.
+Use this at the end of Transform() methods that return NoData.
+
+```csharp
+public static Task<IEnumerable<NoData>> Result()
+```
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<[NoData](Flowthru.Steps.NoData.md)\>\>
+
+Singleton collection containing NoData.Value
+
+#### Remarks
+
+<p>
+This helper eliminates the verbose <code>Task.FromResult(Enumerable.Repeat(NoData.Value, 1))</code>
+boilerplate. Simply return <code>NoData.Result()</code>.
+</p>
+<example>
+<pre><code class="lang-csharp">// Instead of:
+return Task.FromResult(Enumerable.Repeat(NoData.Value, 1));
+
+// Use:
+return NoData.Result();</code></pre>
+</example>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.NoParams.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.NoParams.md
new file mode 100644
index 00000000..d8335245
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.NoParams.md
@@ -0,0 +1,49 @@
+# <a id="Flowthru_Steps_NoParams"></a> Class NoParams
+
+Namespace: [Flowthru.Steps](Flowthru.Steps.md)  
+Assembly: Flowthru.Core.dll  
+
+Marker type for nodes that don't require parameters.
+Used as the default TParameters type in NodeBase&lt;TInput, TOutput, TParameters&gt;.
+
+```csharp
+public sealed class NoParams
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[NoParams](Flowthru.Steps.NoParams.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+This is a simple empty class that serves as a shorthand for users and the library
+when no parameters are needed for a node. Nodes that don't need configuration can
+omit the third type parameter by using the two-parameter NodeBase&lt;TInput, TOutput&gt;
+convenience base class.
+</p>
+<p>
+<strong>Usage Examples:</strong>
+</p>
+<pre><code class="lang-csharp">// Explicit NoParams (rarely needed)
+public class MyNode : NodeBase&lt;Input, Output, NoParams&gt; { }
+
+// Recommended: Use two-parameter base class
+public class MyNode : NodeBase&lt;Input, Output&gt; { }
+
+// With parameters
+public class ConfigurableNode : NodeBase&lt;Input, Output, MyParameters&gt;
+{
+    // Parameters property is automatically available
+}</code></pre>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.md b/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.md
new file mode 100644
index 00000000..55745091
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Flowthru.Steps.md
@@ -0,0 +1,18 @@
+# <a id="Flowthru_Steps"></a> Namespace Flowthru.Steps
+
+### Namespaces
+
+ [Flowthru.Steps.Factory](Flowthru.Steps.Factory.md)
+
+### Classes
+
+ [NoData](Flowthru.Steps.NoData.md)
+
+Marker type representing "no meaningful data" for nodes with side-effects or data generation.
+Used as input/output type in NodeBase when a node doesn't consume or produce meaningful data.
+
+ [NoParams](Flowthru.Steps.NoParams.md)
+
+Marker type for nodes that don't require parameters.
+Used as the default TParameters type in NodeBase&lt;TInput, TOutput, TParameters&gt;.
+
diff --git a/docs/reference/src/core/Flowthru.Core/Microsoft.Extensions.DependencyInjection.FlowthruServiceCollectionExtensions.md b/docs/reference/src/core/Flowthru.Core/Microsoft.Extensions.DependencyInjection.FlowthruServiceCollectionExtensions.md
new file mode 100644
index 00000000..d46a63ca
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Microsoft.Extensions.DependencyInjection.FlowthruServiceCollectionExtensions.md
@@ -0,0 +1,94 @@
+# <a id="Microsoft_Extensions_DependencyInjection_FlowthruServiceCollectionExtensions"></a> Class FlowthruServiceCollectionExtensions
+
+Namespace: [Microsoft.Extensions.DependencyInjection](Microsoft.Extensions.DependencyInjection.md)  
+Assembly: Flowthru.Core.dll  
+
+Extension methods for registering Flowthru services with the DI container.
+
+```csharp
+public static class FlowthruServiceCollectionExtensions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowthruServiceCollectionExtensions](Microsoft.Extensions.DependencyInjection.FlowthruServiceCollectionExtensions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Microsoft_Extensions_DependencyInjection_FlowthruServiceCollectionExtensions_AddFlowthru_Microsoft_Extensions_DependencyInjection_IServiceCollection_System_Action_Flowthru_Services_FlowthruServiceBuilder__"></a> AddFlowthru\(IServiceCollection, Action<FlowthruServiceBuilder\>\)
+
+Registers Flowthru service with the DI container.
+
+```csharp
+public static IServiceCollection AddFlowthru(this IServiceCollection services, Action<FlowthruServiceBuilder> configure)
+```
+
+#### Parameters
+
+`services` [IServiceCollection](https://learn.microsoft.com/dotnet/api/microsoft.extensions.dependencyinjection.iservicecollection)
+
+The service collection
+
+`configure` [Action](https://learn.microsoft.com/dotnet/api/system.action\-1)<[FlowthruServiceBuilder](Flowthru.Services.FlowthruServiceBuilder.md)\>
+
+Action to configure the Flowthru service
+
+#### Returns
+
+ [IServiceCollection](https://learn.microsoft.com/dotnet/api/microsoft.extensions.dependencyinjection.iservicecollection)
+
+The service collection for method chaining
+
+#### Remarks
+
+<p>
+This extension method provides a clean API for registering Flowthru
+in any .NET application with dependency injection.
+</p>
+<p>
+<strong>Example Usage:</strong>
+<pre><code class="lang-csharp">// In Program.cs or Startup.cs
+services.AddFlowthru(flowthru =&gt;
+{
+    flowthru.RegisterCatalog&lt;MyCatalog&gt;();
+    flowthru.RegisterPipelines(catalog =&gt; new Dictionary&lt;string, Pipeline&gt;
+    {
+        ["my_pipeline"] = MyPipeline.Create((MyCatalog)catalog)
+    });
+    flowthru.ConfigureMetadata(meta =&gt;
+    {
+        meta.WithOutputDirectory("metadata")
+            .AddProvider&lt;MermaidMetadataProvider, MermaidMetadataProviderBuilder&gt;();
+    });
+});
+
+// Then inject IFlowthruService anywhere
+public class MyController
+{
+    private readonly IFlowthruService _flowthru;
+
+    public MyController(IFlowthruService flowthru)
+    {
+        _flowthru = flowthru;
+    }
+
+    public async Task&lt;IActionResult&gt; RunPipeline(string name)
+    {
+        var request = new PipelineExecutionRequest { FlowName = name };
+        var result = await _flowthru.ExecutePipelineAsync(request);
+        return Ok(result);
+    }
+}</code></pre>
+</p>
+
diff --git a/docs/reference/src/core/Flowthru.Core/Microsoft.Extensions.DependencyInjection.md b/docs/reference/src/core/Flowthru.Core/Microsoft.Extensions.DependencyInjection.md
new file mode 100644
index 00000000..ec963843
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/Microsoft.Extensions.DependencyInjection.md
@@ -0,0 +1,8 @@
+# <a id="Microsoft_Extensions_DependencyInjection"></a> Namespace Microsoft.Extensions.DependencyInjection
+
+### Classes
+
+ [FlowthruServiceCollectionExtensions](Microsoft.Extensions.DependencyInjection.FlowthruServiceCollectionExtensions.md)
+
+Extension methods for registering Flowthru services with the DI container.
+
diff --git a/docs/reference/src/core/Flowthru.Core/toc.yml b/docs/reference/src/core/Flowthru.Core/toc.yml
new file mode 100644
index 00000000..d18e7360
--- /dev/null
+++ b/docs/reference/src/core/Flowthru.Core/toc.yml
@@ -0,0 +1,318 @@
+### YamlMime:TableOfContent
+- name: Flowthru.Abstractions
+  href: Flowthru.Abstractions.md
+  items:
+  - name: Classes
+  - name: FlowthruSchemaAttribute
+    href: Flowthru.Abstractions.FlowthruSchemaAttribute.md
+  - name: SerializedEnumAttribute
+    href: Flowthru.Abstractions.SerializedEnumAttribute.md
+  - name: SerializedLabelAttribute
+    href: Flowthru.Abstractions.SerializedLabelAttribute.md
+  - name: Interfaces
+  - name: IBinarySerializable
+    href: Flowthru.Abstractions.IBinarySerializable.md
+  - name: IFlatSchema
+    href: Flowthru.Abstractions.IFlatSchema.md
+  - name: IFlatSerializable
+    href: Flowthru.Abstractions.IFlatSerializable.md
+  - name: INestedSchema
+    href: Flowthru.Abstractions.INestedSchema.md
+  - name: INestedSerializable
+    href: Flowthru.Abstractions.INestedSerializable.md
+  - name: IScalar
+    href: Flowthru.Abstractions.IScalar.md
+  - name: IStructuredSerializable
+    href: Flowthru.Abstractions.IStructuredSerializable.md
+  - name: ITextSerializable
+    href: Flowthru.Abstractions.ITextSerializable.md
+- name: Flowthru.Cli
+  href: Flowthru.Cli.md
+  items:
+  - name: Classes
+  - name: FlowthruCli
+    href: Flowthru.Cli.FlowthruCli.md
+- name: Flowthru.Configuration
+  href: Flowthru.Configuration.md
+  items:
+  - name: Classes
+  - name: CatalogOptions
+    href: Flowthru.Configuration.CatalogOptions.md
+  - name: ConfigurationExtensions
+    href: Flowthru.Configuration.ConfigurationExtensions.md
+  - name: FlowOptions
+    href: Flowthru.Configuration.FlowOptions.md
+  - name: FlowValidationOptions
+    href: Flowthru.Configuration.FlowValidationOptions.md
+  - name: FlowthruConfigurationOptions
+    href: Flowthru.Configuration.FlowthruConfigurationOptions.md
+  - name: FlowthruOptions
+    href: Flowthru.Configuration.FlowthruOptions.md
+  - name: JsonMetadataOptions
+    href: Flowthru.Configuration.JsonMetadataOptions.md
+  - name: LoggingOptions
+    href: Flowthru.Configuration.LoggingOptions.md
+  - name: MermaidMetadataOptions
+    href: Flowthru.Configuration.MermaidMetadataOptions.md
+  - name: MetadataOptions
+    href: Flowthru.Configuration.MetadataOptions.md
+  - name: TimestampConfiguration
+    href: Flowthru.Configuration.TimestampConfiguration.md
+  - name: Interfaces
+  - name: ICatalogFactory
+    href: Flowthru.Configuration.ICatalogFactory.md
+- name: Flowthru.Data
+  href: Flowthru.Data.md
+  items:
+  - name: Classes
+  - name: CatalogAbstract
+    href: Flowthru.Data.CatalogAbstract.md
+  - name: EnumerableItems
+    href: Flowthru.Data.EnumerableItems.md
+  - name: Item<T>
+    href: Flowthru.Data.Item-1.md
+  - name: Items
+    href: Flowthru.Data.Items.md
+  - name: Items.Single
+    href: Flowthru.Data.Items.Single.md
+  - name: Interfaces
+  - name: IItem
+    href: Flowthru.Data.IItem.md
+  - name: IItem<T>
+    href: Flowthru.Data.IItem-1.md
+- name: Flowthru.Data.Capabilities
+  href: Flowthru.Data.Capabilities.md
+  items:
+  - name: Classes
+  - name: StorageTraits
+    href: Flowthru.Data.Capabilities.StorageTraits.md
+- name: Flowthru.Data.Storage
+  href: Flowthru.Data.Storage.md
+  items:
+  - name: Classes
+  - name: BinaryFileStorageAdapter
+    href: Flowthru.Data.Storage.BinaryFileStorageAdapter.md
+  - name: ComposedStorageAdapter<TContainer, TRow>
+    href: Flowthru.Data.Storage.ComposedStorageAdapter-2.md
+  - name: MemoryStorageAdapter<T>
+    href: Flowthru.Data.Storage.MemoryStorageAdapter-1.md
+  - name: NullStorageAdapter<T>
+    href: Flowthru.Data.Storage.NullStorageAdapter-1.md
+  - name: PropertyMappingConfiguration
+    href: Flowthru.Data.Storage.PropertyMappingConfiguration.md
+  - name: SchemaActivator
+    href: Flowthru.Data.Storage.SchemaActivator.md
+  - name: SingletonJsonStorageAdapter<T>
+    href: Flowthru.Data.Storage.SingletonJsonStorageAdapter-1.md
+  - name: TextFileStorageAdapter
+    href: Flowthru.Data.Storage.TextFileStorageAdapter.md
+  - name: Interfaces
+  - name: IContainerAdapter<TContainer, TRow>
+    href: Flowthru.Data.Storage.IContainerAdapter-2.md
+  - name: IFormatSerializer<TRow>
+    href: Flowthru.Data.Storage.IFormatSerializer-1.md
+  - name: IStorageAdapter<T>
+    href: Flowthru.Data.Storage.IStorageAdapter-1.md
+  - name: IStorageMedium
+    href: Flowthru.Data.Storage.IStorageMedium.md
+  - name: Enums
+  - name: PropertyMappingStrategy
+    href: Flowthru.Data.Storage.PropertyMappingStrategy.md
+- name: Flowthru.Data.Storage.Container
+  href: Flowthru.Data.Storage.Container.md
+  items:
+  - name: Classes
+  - name: EnumerableContainerAdapter<T>
+    href: Flowthru.Data.Storage.Container.EnumerableContainerAdapter-1.md
+- name: Flowthru.Data.Storage.Format
+  href: Flowthru.Data.Storage.Format.md
+  items:
+  - name: Classes
+  - name: JsonFormatSerializer<TRow>
+    href: Flowthru.Data.Storage.Format.JsonFormatSerializer-1.md
+  - name: PropertyMappingHelper
+    href: Flowthru.Data.Storage.Format.PropertyMappingHelper.md
+- name: Flowthru.Data.Storage.Medium
+  href: Flowthru.Data.Storage.Medium.md
+  items:
+  - name: Classes
+  - name: FileStorageMedium
+    href: Flowthru.Data.Storage.Medium.FileStorageMedium.md
+  - name: MemoryStorageMedium
+    href: Flowthru.Data.Storage.Medium.MemoryStorageMedium.md
+- name: Flowthru.Data.Storage.Strategies
+  href: Flowthru.Data.Storage.Strategies.md
+  items:
+  - name: Classes
+  - name: DatabaseStorageEntryFactory
+    href: Flowthru.Data.Storage.Strategies.DatabaseStorageEntryFactory.md
+  - name: MemoryStorageEntryFactory
+    href: Flowthru.Data.Storage.Strategies.MemoryStorageEntryFactory.md
+  - name: StorageOptions
+    href: Flowthru.Data.Storage.Strategies.StorageOptions.md
+  - name: Interfaces
+  - name: IStorageEntryFactory
+    href: Flowthru.Data.Storage.Strategies.IStorageEntryFactory.md
+- name: Flowthru.Data.Validation
+  href: Flowthru.Data.Validation.md
+  items:
+  - name: Classes
+  - name: ValidationError
+    href: Flowthru.Data.Validation.ValidationError.md
+  - name: ValidationException
+    href: Flowthru.Data.Validation.ValidationException.md
+  - name: ValidationResult
+    href: Flowthru.Data.Validation.ValidationResult.md
+  - name: Enums
+  - name: InspectionLevel
+    href: Flowthru.Data.Validation.InspectionLevel.md
+  - name: ValidationErrorType
+    href: Flowthru.Data.Validation.ValidationErrorType.md
+- name: Flowthru.Effects
+  href: Flowthru.Effects.md
+  items:
+  - name: Classes
+  - name: FlowIO
+    href: Flowthru.Effects.FlowIO.md
+  - name: Structs
+  - name: FlowIO<A>
+    href: Flowthru.Effects.FlowIO-1.md
+  - name: FlowUnit
+    href: Flowthru.Effects.FlowUnit.md
+- name: Flowthru.Flows
+  href: Flowthru.Flows.md
+  items:
+  - name: Classes
+  - name: ExecutionOptions
+    href: Flowthru.Flows.ExecutionOptions.md
+  - name: Flow
+    href: Flowthru.Flows.Flow.md
+  - name: FlowBuilder
+    href: Flowthru.Flows.FlowBuilder.md
+  - name: FlowResult
+    href: Flowthru.Flows.FlowResult.md
+  - name: FlowSliceStrategy
+    href: Flowthru.Flows.FlowSliceStrategy.md
+  - name: FlowStep
+    href: Flowthru.Flows.FlowStep.md
+  - name: StepResult
+    href: Flowthru.Flows.StepResult.md
+  - name: Structs
+  - name: DryRunOption
+    href: Flowthru.Flows.DryRunOption.md
+  - name: Enums
+  - name: ValidationDepth
+    href: Flowthru.Flows.ValidationDepth.md
+- name: Flowthru.Flows.Validation
+  href: Flowthru.Flows.Validation.md
+  items:
+  - name: Classes
+  - name: ValidationOptions
+    href: Flowthru.Flows.Validation.ValidationOptions.md
+  - name: Interfaces
+  - name: IFlowValidationHook
+    href: Flowthru.Flows.Validation.IFlowValidationHook.md
+- name: Flowthru.Meta
+  href: Flowthru.Meta.md
+  items:
+  - name: Classes
+  - name: FlowthruMetadataBuilder
+    href: Flowthru.Meta.FlowthruMetadataBuilder.md
+  - name: FlowthruMetadataConfiguration
+    href: Flowthru.Meta.FlowthruMetadataConfiguration.md
+  - name: JsonMetadataProviderBuilder
+    href: Flowthru.Meta.JsonMetadataProviderBuilder.md
+  - name: MermaidMetadataExtensions
+    href: Flowthru.Meta.MermaidMetadataExtensions.md
+  - name: MermaidMetadataProviderBuilder
+    href: Flowthru.Meta.MermaidMetadataProviderBuilder.md
+  - name: MetadataJsonExtensions
+    href: Flowthru.Meta.MetadataJsonExtensions.md
+  - name: MetadataProviderBuilderAttribute
+    href: Flowthru.Meta.MetadataProviderBuilderAttribute.md
+  - name: TimestampConfiguration
+    href: Flowthru.Meta.TimestampConfiguration.md
+- name: Flowthru.Meta.Models
+  href: Flowthru.Meta.Models.md
+  items:
+  - name: Classes
+  - name: DagMetadata
+    href: Flowthru.Meta.Models.DagMetadata.md
+  - name: DagSliceMetadata
+    href: Flowthru.Meta.Models.DagSliceMetadata.md
+  - name: EdgeMetadata
+    href: Flowthru.Meta.Models.EdgeMetadata.md
+  - name: ItemMetadata
+    href: Flowthru.Meta.Models.ItemMetadata.md
+  - name: SchemaField
+    href: Flowthru.Meta.Models.SchemaField.md
+  - name: SchemaMetadata
+    href: Flowthru.Meta.Models.SchemaMetadata.md
+  - name: StepMetadata
+    href: Flowthru.Meta.Models.StepMetadata.md
+- name: Flowthru.Meta.Providers
+  href: Flowthru.Meta.Providers.md
+  items:
+  - name: Classes
+  - name: JsonMetadataProvider
+    href: Flowthru.Meta.Providers.JsonMetadataProvider.md
+  - name: MermaidMetadataProvider
+    href: Flowthru.Meta.Providers.MermaidMetadataProvider.md
+  - name: Interfaces
+  - name: IMetadataProvider
+    href: Flowthru.Meta.Providers.IMetadataProvider.md
+  - name: Enums
+  - name: MermaidMetadataProvider.MermaidFlowchartDirection
+    href: Flowthru.Meta.Providers.MermaidMetadataProvider.MermaidFlowchartDirection.md
+- name: Flowthru.Registry
+  href: Flowthru.Registry.md
+  items:
+  - name: Interfaces
+  - name: IFlowRegistrar<TCatalog>
+    href: Flowthru.Registry.IFlowRegistrar-1.md
+- name: Flowthru.Results
+  href: Flowthru.Results.md
+  items:
+  - name: Classes
+  - name: ConsoleResultFormatter
+    href: Flowthru.Results.ConsoleResultFormatter.md
+  - name: Interfaces
+  - name: IFlowResultFormatter
+    href: Flowthru.Results.IFlowResultFormatter.md
+- name: Flowthru.Services
+  href: Flowthru.Services.md
+  items:
+  - name: Classes
+  - name: FlowthruServiceBuilder
+    href: Flowthru.Services.FlowthruServiceBuilder.md
+  - name: Interfaces
+  - name: IFlowthruService
+    href: Flowthru.Services.IFlowthruService.md
+- name: Flowthru.Services.Models
+  href: Flowthru.Services.Models.md
+  items:
+  - name: Classes
+  - name: FlowMetadata
+    href: Flowthru.Services.Models.FlowMetadata.md
+- name: Flowthru.Steps
+  href: Flowthru.Steps.md
+  items:
+  - name: Classes
+  - name: NoData
+    href: Flowthru.Steps.NoData.md
+  - name: NoParams
+    href: Flowthru.Steps.NoParams.md
+- name: Flowthru.Steps.Factory
+  href: Flowthru.Steps.Factory.md
+  items:
+  - name: Classes
+  - name: StepFactory
+    href: Flowthru.Steps.Factory.StepFactory.md
+  - name: TypeActivator
+    href: Flowthru.Steps.Factory.TypeActivator.md
+- name: Microsoft.Extensions.DependencyInjection
+  href: Microsoft.Extensions.DependencyInjection.md
+  items:
+  - name: Classes
+  - name: FlowthruServiceCollectionExtensions
+    href: Microsoft.Extensions.DependencyInjection.FlowthruServiceCollectionExtensions.md
diff --git a/docs/reference/src/core/Flowthru/toc.yml b/docs/reference/src/core/Flowthru/toc.yml
new file mode 100644
index 00000000..20c32afa
--- /dev/null
+++ b/docs/reference/src/core/Flowthru/toc.yml
@@ -0,0 +1,2 @@
+### YamlMime:TableOfContent
+[]
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.CsvCatalogEntryExtensions.md b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.CsvCatalogEntryExtensions.md
new file mode 100644
index 00000000..de53868b
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.CsvCatalogEntryExtensions.md
@@ -0,0 +1,114 @@
+# <a id="Flowthru_Data_CsvItemExtensions"></a> Class CsvItemExtensions
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Extensions.Csv.dll  
+
+Extension methods that add CSV support to <xref href="Flowthru.Data.Items.Enumerable" data-throw-if-not-resolved="false"></xref>.
+
+```csharp
+public static class CsvItemExtensions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[CsvItemExtensions](Flowthru.Data.CsvItemExtensions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Flowthru_Data_CsvItemExtensions_Csv__1_Flowthru_Data_EnumerableItems_System_String_System_String_"></a> Csv<TRow\>\(EnumerableItems, string, string\)
+
+Creates a CSV file catalog entry with IEnumerable container.
+
+```csharp
+public static Item<IEnumerable<TRow>> Csv<TRow>(this EnumerableItems _, string label, string filePath) where TRow : notnull, IFlatSchema, ITextSerializable
+```
+
+#### Parameters
+
+`_` EnumerableItems
+
+The enumerable catalog entries factory (from <xref href="Flowthru.Data.Items.Enumerable" data-throw-if-not-resolved="false"></xref>)
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to CSV file
+
+#### Returns
+
+ Item<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<TRow\>\>
+
+Catalog entry with file + CSV + IEnumerable composition
+
+#### Type Parameters
+
+`TRow` 
+
+Row schema type (must be flat and text-serializable)
+
+#### Remarks
+
+<p>
+<strong>Requirements:</strong>
+</p>
+<ul><li>TRow must implement IFlatSchema (no nested objects)</li><li>TRow must implement ITextSerializable</li></ul>
+<p>
+<strong>Storage Traits:</strong>
+</p>
+<ul><li>CanStream: true (CSV supports row-by-row streaming)</li><li>All other traits use filesystem baseline defaults</li></ul>
+
+### <a id="Flowthru_Data_CsvItemExtensions_CsvDirectory__1_Flowthru_Data_EnumerableItems_System_String_System_String_"></a> CsvDirectory<TRow\>\(EnumerableItems, string, string\)
+
+Creates a catalog entry that reads all CSV files in a directory and
+concatenates them into a single <xref href="System.Collections.Generic.IEnumerable%601" data-throw-if-not-resolved="false"></xref>.
+
+```csharp
+public static Item<IEnumerable<TRow>> CsvDirectory<TRow>(this EnumerableItems _, string label, string directoryPath) where TRow : notnull, IFlatSchema, ITextSerializable
+```
+
+#### Parameters
+
+`_` EnumerableItems
+
+The enumerable catalog entries factory (from <xref href="Flowthru.Data.Items.Enumerable" data-throw-if-not-resolved="false"></xref>)
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`directoryPath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to the directory containing the CSV files
+
+#### Returns
+
+ Item<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<TRow\>\>
+
+Read-only catalog entry that concatenates every <code>*.csv</code> in the directory
+
+#### Type Parameters
+
+`TRow` 
+
+Row schema type (must be flat and text-serializable)
+
+#### Remarks
+
+Files are read in lexicographic order. All files must share the same schema.
+This entry is <strong>read-only</strong> — attempting to save will fail with
+<xref href="System.NotSupportedException" data-throw-if-not-resolved="false"></xref>.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.DirectoryCsvStorageAdapter-1.md b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.DirectoryCsvStorageAdapter-1.md
new file mode 100644
index 00000000..4ed7535f
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.DirectoryCsvStorageAdapter-1.md
@@ -0,0 +1,263 @@
+# <a id="Flowthru_Data_Storage_DirectoryCsvStorageAdapter_1"></a> Class DirectoryCsvStorageAdapter<TRow\>
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Extensions.Csv.dll  
+
+Storage adapter that reads all CSV files in a directory and concatenates
+them into a single <xref href="System.Collections.Generic.IEnumerable%601" data-throw-if-not-resolved="false"></xref>.
+
+```csharp
+public sealed class DirectoryCsvStorageAdapter<TRow> : IStorageAdapter<IEnumerable<TRow>> where TRow : notnull, IFlatSchema, ITextSerializable
+```
+
+#### Type Parameters
+
+`TRow` 
+
+Row schema type (must be flat and text-serializable)
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[DirectoryCsvStorageAdapter<TRow\>](Flowthru.Data.Storage.DirectoryCsvStorageAdapter\-1.md)
+
+#### Implements
+
+IStorageAdapter<IEnumerable<TRow\>\>
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+This adapter is <strong>read-only</strong>. It enumerates every <code>*.csv</code> file in the
+given directory in lexicographic order, deserialises each with a shared
+<xref href="Flowthru.Data.Storage.Format.CsvFormatSerializer%601" data-throw-if-not-resolved="false"></xref>, and returns all rows concatenated.
+</p>
+<p>
+All files must share the same schema (identical column headers). Files from
+mixed schemas will cause deserialization errors at load time.
+</p>
+<p>
+Typical use case: a raw ingest layer where data is delivered as one file per
+day, one file per region, etc.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_DirectoryCsvStorageAdapter_1__ctor_System_String_"></a> DirectoryCsvStorageAdapter\(string\)
+
+Creates a new directory CSV adapter.
+
+```csharp
+public DirectoryCsvStorageAdapter(string directoryPath)
+```
+
+#### Parameters
+
+`directoryPath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to the directory containing CSV files.
+
+#### Exceptions
+
+ [ArgumentException](https://learn.microsoft.com/dotnet/api/system.argumentexception)
+
+Thrown if <code class="paramref">directoryPath</code> is null or whitespace.
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_DirectoryCsvStorageAdapter_1_Traits"></a> Traits
+
+Structural constraints and capabilities of this storage implementation.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ StorageTraits
+
+#### Remarks
+
+<p>
+Adapter authors must declare what their storage can and cannot do.
+These are intrinsic properties of the storage medium, not runtime state.
+</p>
+<p>
+Pipeline validation uses these traits to fail fast when a pipeline attempts
+invalid operations (e.g., writing to a read-only source).
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_DirectoryCsvStorageAdapter_1_Exists"></a> Exists\(\)
+
+Checks if data exists at this storage location.
+
+```csharp
+public FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ FlowIO<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+Effect that produces true if data exists, false otherwise
+
+#### Remarks
+
+<p>
+Delegates to the underlying medium's Exists check.
+Used to determine if a catalog entry is a seed (Layer 0 input).
+</p>
+
+### <a id="Flowthru_Data_Storage_DirectoryCsvStorageAdapter_1_InspectDeep"></a> InspectDeep\(\)
+
+Performs deep validation by examining the entire dataset.
+
+```csharp
+public FlowIO<ValidationResult> InspectDeep()
+```
+
+#### Returns
+
+ FlowIO<ValidationResult\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that all data is available, accessible, and valid.
+</p>
+<p>
+<strong>Additional Checks Beyond Shallow:</strong>
+</p>
+<ul><li>Validate ALL rows can be deserialized (not just sample)</li><li>Check data quality constraints across entire dataset</li><li>Detect corruption or inconsistencies throughout data</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Read and validate entire file</li><li>Memory adapters: Validate all stored data</li><li>Database adapters: Full table scan with validation</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Potentially expensive - only use when data integrity is critical.
+</p>
+
+### <a id="Flowthru_Data_Storage_DirectoryCsvStorageAdapter_1_InspectShallow_System_Int32_"></a> InspectShallow\(int\)
+
+Performs shallow validation by checking data availability and sampling a subset of data.
+
+```csharp
+public FlowIO<ValidationResult> InspectShallow(int sampleSize)
+```
+
+#### Parameters
+
+`sampleSize` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of rows/records to sample for validation
+
+#### Returns
+
+ FlowIO<ValidationResult\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that data is available and accessible.
+</p>
+<p>
+<strong>Typical Checks:</strong>
+</p>
+<ul><li>Data source exists (file, table, etc.)</li><li>Data source is accessible (permissions, connectivity)</li><li>Sample rows can be read and deserialized successfully</li><li>Schema matches expected structure</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Check file exists, read and validate sample rows</li><li>Memory adapters: Check if data has been initialized</li><li>Database adapters: Check table exists, query sample rows</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Should be fast (~10-100ms) - suitable for pre-flight validation.
+</p>
+
+### <a id="Flowthru_Data_Storage_DirectoryCsvStorageAdapter_1_Load"></a> Load\(\)
+
+Loads data from storage.
+
+```csharp
+public FlowIO<IEnumerable<TRow>> Load()
+```
+
+#### Returns
+
+ FlowIO<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<TRow\>\>
+
+Effect that produces data on success
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. medium.ReadStream()           → Stream
+2. format.DeserializeRows()      → IAsyncEnumerable&lt;TRow&gt;
+3. container.FromRows()          → TContainer</code></pre>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Errors from any layer are propagated:
+- Medium errors (file not found, access denied)
+- Format errors (parse failures, schema mismatches)
+- Container errors (memory allocation, type conversion)
+</p>
+
+### <a id="Flowthru_Data_Storage_DirectoryCsvStorageAdapter_1_Save_System_Collections_Generic_IEnumerable__0__"></a> Save\(IEnumerable<TRow\>\)
+
+Saves data to storage.
+
+```csharp
+public FlowIO<FlowUnit> Save(IEnumerable<TRow> data)
+```
+
+#### Parameters
+
+`data` [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<TRow\>
+
+The data to save
+
+#### Returns
+
+ FlowIO<FlowUnit\>
+
+Effect that completes on successful save
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. container.ToRows()            → IAsyncEnumerable&lt;TRow&gt;
+2. format.SerializeRows()        → Stream
+3. medium.WriteStream()          → FlowUnit</code></pre>
+<p>
+<strong>Atomicity:</strong>
+</p>
+<p>
+Implementations should strive for atomic saves to avoid partial writes on failure.
+</p>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.Format.CsvFormatSerializer-1.md b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.Format.CsvFormatSerializer-1.md
new file mode 100644
index 00000000..dfb17aa2
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.Format.CsvFormatSerializer-1.md
@@ -0,0 +1,320 @@
+# <a id="Flowthru_Data_Storage_Format_CsvFormatSerializer_1"></a> Class CsvFormatSerializer<TRow\>
+
+Namespace: [Flowthru.Data.Storage.Format](Flowthru.Data.Storage.Format.md)  
+Assembly: Flowthru.Extensions.Csv.dll  
+
+Format serializer for CSV (Comma-Separated Values) files.
+
+```csharp
+public sealed class CsvFormatSerializer<TRow> : IFormatSerializer<TRow> where TRow : notnull, IFlatSchema, ITextSerializable
+```
+
+#### Type Parameters
+
+`TRow` 
+
+The row schema type
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[CsvFormatSerializer<TRow\>](Flowthru.Data.Storage.Format.CsvFormatSerializer\-1.md)
+
+#### Implements
+
+IFormatSerializer<TRow\>
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Examples
+
+<pre><code class="lang-csharp">public record CompanySchema(
+    int Id,
+    string Name,
+    float Rating
+) : IFlatSchema, ITextSerializable;
+
+var serializer = new CsvFormatSerializer&lt;CompanySchema&gt;();
+
+// Deserialize
+using var readStream = File.OpenRead("companies.csv");
+await foreach (var row in serializer.DeserializeRows(readStream))
+{
+    Console.WriteLine($"Company: {row.Name}, Rating: {row.Rating}");
+}
+
+// Serialize
+var companies = new[] {
+    new CompanySchema(1, "Acme Corp", 4.5f),
+    new CompanySchema(2, "Tech Inc", 4.8f)
+};
+
+using var writeStream = File.Create("output.csv");
+await serializer.SerializeRows(writeStream, companies.ToAsyncEnumerable());</code></pre>
+
+## Remarks
+
+<p>
+<strong>Type Constraints:</strong>
+</p>
+<p>
+TRow must implement both:
+</p>
+<ul><li><xref href="Flowthru.Abstractions.IFlatSchema" data-throw-if-not-resolved="false"></xref> - No nested structures (primitives only)</li><li><xref href="Flowthru.Abstractions.ITextSerializable" data-throw-if-not-resolved="false"></xref> - Can be serialized to text</li></ul>
+<p>
+These constraints are enforced at compile-time, preventing invalid usage:
+</p>
+<pre><code class="lang-csharp">// ✅ Compiles - flat schema with text serialization
+var csv = new CsvFormatSerializer&lt;CompanySchema&gt;();
+
+// ❌ Compile error - nested schema not allowed
+var csv = new CsvFormatSerializer&lt;OrderWithItems&gt;(); // OrderWithItems : INestedSchema</code></pre>
+<p>
+<strong>Configuration:</strong>
+</p>
+<p>
+Uses CsvHelper library with default configuration:
+- HasHeaderRecord = true
+- InvariantCulture
+- Comma delimiter
+</p>
+<p>
+Custom configuration can be provided via constructor.
+</p>
+<p>
+<strong>Streaming Behavior:</strong>
+</p>
+<p>
+Both deserialization and serialization use streaming:
+- Rows are yielded/consumed lazily
+- Low memory footprint for large files
+- Backpressure support via IAsyncEnumerable
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_Format_CsvFormatSerializer_1__ctor"></a> CsvFormatSerializer\(\)
+
+Creates a new CSV format serializer with default configuration.
+
+```csharp
+public CsvFormatSerializer()
+```
+
+### <a id="Flowthru_Data_Storage_Format_CsvFormatSerializer_1__ctor_CsvHelper_Configuration_CsvConfiguration_"></a> CsvFormatSerializer\(CsvConfiguration\)
+
+Creates a new CSV format serializer with custom configuration.
+
+```csharp
+public CsvFormatSerializer(CsvConfiguration configuration)
+```
+
+#### Parameters
+
+`configuration` CsvConfiguration
+
+CsvHelper configuration
+
+#### Exceptions
+
+ [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception)
+
+Thrown if configuration is null
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_Format_CsvFormatSerializer_1_Configuration"></a> Configuration
+
+Gets the CSV configuration for this serializer.
+
+```csharp
+public CsvConfiguration Configuration { get; }
+```
+
+#### Property Value
+
+ CsvConfiguration
+
+### <a id="Flowthru_Data_Storage_Format_CsvFormatSerializer_1_Traits"></a> Traits
+
+Structural capabilities of this format serializer.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ StorageTraits
+
+#### Remarks
+
+<p>
+Format traits focus on HOW data is serialized and whether it supports streaming.
+For composed adapters, these traits are merged with medium and container traits.
+</p>
+<p>
+Most formats should declare <code>CanStream = true</code> if they can deserialize row-by-row
+without buffering the entire stream (e.g., CSV, JSONL). Formats that require full
+parsing before yielding rows (e.g., JSON arrays) should set <code>CanStream = false</code>.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_Format_CsvFormatSerializer_1_DeserializeRows_System_IO_Stream_"></a> DeserializeRows\(Stream\)
+
+Deserializes a stream of bytes into a stream of rows.
+
+```csharp
+public IAsyncEnumerable<TRow> DeserializeRows(Stream stream)
+```
+
+#### Parameters
+
+`stream` [Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)
+
+The stream containing serialized data
+
+#### Returns
+
+ [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<TRow\>
+
+Async enumerable of deserialized rows
+
+#### Remarks
+
+<p>
+<strong>Streaming Behavior:</strong>
+</p>
+<p>
+Rows should be yielded as they are deserialized (lazy evaluation).
+This allows processing large datasets without loading everything into memory.
+</p>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Deserialization errors should throw exceptions:
+- Format exceptions (malformed CSV, invalid JSON)
+- Schema mismatches (missing columns, type conversion failures)
+- I/O errors during stream reading
+</p>
+<p>
+The caller should handle these exceptions appropriately.
+</p>
+
+### <a id="Flowthru_Data_Storage_Format_CsvFormatSerializer_1_GetPropertyMappingConfiguration"></a> GetPropertyMappingConfiguration\(\)
+
+Configures how this serializer handles property-to-field name mapping for the schema.
+
+```csharp
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+```
+
+#### Returns
+
+ PropertyMappingConfiguration
+
+Property mapping configuration describing the mapping strategy
+
+#### Examples
+
+<pre><code class="lang-csharp">// CSV serializer using SerializedLabel
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+    =&gt; PropertyMappingConfiguration.FromSerializedLabel&lt;TRow&gt;();
+
+// ML.NET serializer using native attributes
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+    =&gt; PropertyMappingConfiguration.FromNativeAttributes("LoadColumnAttribute");
+
+// Parquet with library-controlled mapping
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+    =&gt; PropertyMappingConfiguration.LibraryControlled();</code></pre>
+
+#### Remarks
+
+<p>
+<strong>Contractual Obligation:</strong> Every format serializer MUST implement this method
+to explicitly declare how it handles property name mapping.
+</p>
+<p>
+<strong>Implementation Strategies:</strong>
+</p>
+<ul><li>
+<strong>SerializedLabel Support:</strong> Use <xref href="Flowthru.Data.Storage.Format.PropertyMappingHelper" data-throw-if-not-resolved="false"></xref>
+to respect [SerializedLabel] attributes. Return <xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.FromSerializedLabel%60%601" data-throw-if-not-resolved="false"></xref>.
+</li><li>
+<strong>Native Attribute Mapping:</strong> Use format-specific attributes (e.g., ML.NET's [LoadColumn]).
+Return <xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.FromNativeAttributes(System.String)" data-throw-if-not-resolved="false"></xref> with the attribute type name.
+</li><li>
+<strong>Library-Controlled:</strong> When the underlying library handles mapping internally
+(e.g., Parquet.NET with no programmatic API). Return PropertyMappingConfiguration.LibraryControlled().
+</li><li>
+<strong>Adapter Pattern:</strong> Bridge between SerializedLabel and native attributes.
+Return <xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.FromAdapter%60%601" data-throw-if-not-resolved="false"></xref>.
+</li></ul>
+<p>
+<strong>Design Intent:</strong> This contract makes property mapping an explicit, discoverable
+capability rather than an implicit behavior, enabling:
+</p>
+<ul><li>Runtime introspection of mapping capabilities</li><li>Better error messages when schemas don't match storage</li><li>Documentation generation for serializer capabilities</li><li>Testing framework validation of mapping correctness</li></ul>
+
+### <a id="Flowthru_Data_Storage_Format_CsvFormatSerializer_1_SerializeRows_System_IO_Stream_System_Collections_Generic_IAsyncEnumerable__0__"></a> SerializeRows\(Stream, IAsyncEnumerable<TRow\>\)
+
+Serializes a stream of rows into a stream of bytes.
+
+```csharp
+public Task SerializeRows(Stream stream, IAsyncEnumerable<TRow> rows)
+```
+
+#### Parameters
+
+`stream` [Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)
+
+The stream to write serialized data to
+
+`rows` [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<TRow\>
+
+The rows to serialize
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
+
+Task that completes when serialization finishes
+
+#### Remarks
+
+<p>
+<strong>Streaming Behavior:</strong>
+</p>
+<p>
+Rows should be written as they are enumerated (lazy evaluation).
+This allows handling large datasets efficiently.
+</p>
+<p>
+<strong>Format-Specific Headers:</strong>
+</p>
+<p>
+Implementations should handle format-specific initialization:
+- CSV: Write header row with column names
+- JSON: Write opening bracket for array
+- Parquet: Write schema metadata
+</p>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Serialization errors should throw exceptions:
+- Type conversion failures
+- I/O errors during stream writing
+- Invalid data values for format constraints
+</p>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.Format.md b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.Format.md
new file mode 100644
index 00000000..dc4c870a
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.Format.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Data_Storage_Format"></a> Namespace Flowthru.Data.Storage.Format
+
+### Classes
+
+ [CsvFormatSerializer<TRow\>](Flowthru.Data.Storage.Format.CsvFormatSerializer\-1.md)
+
+Format serializer for CSV (Comma-Separated Values) files.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.Strategies.CsvStorageEntryFactory.md b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.Strategies.CsvStorageEntryFactory.md
new file mode 100644
index 00000000..55677218
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.Strategies.CsvStorageEntryFactory.md
@@ -0,0 +1,160 @@
+# <a id="Flowthru_Data_Storage_Strategies_CsvStorageEntryFactory"></a> Class CsvStorageEntryFactory
+
+Namespace: [Flowthru.Data.Storage.Strategies](Flowthru.Data.Storage.Strategies.md)  
+Assembly: Flowthru.Extensions.Csv.dll  
+
+CSV file-based storage strategy for local development.
+
+```csharp
+public sealed class CsvStorageEntryFactory : IStorageEntryFactory
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[CsvStorageEntryFactory](Flowthru.Data.Storage.Strategies.CsvStorageEntryFactory.md)
+
+#### Implements
+
+IStorageEntryFactory
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+Uses CSV files for data storage, enabling:
+</p>
+<ul><li>Easy inspection with text editors or spreadsheet tools</li><li>Version control-friendly (human-readable diffs)</li><li>No external dependencies (no database required)</li></ul>
+<p>
+<strong>Path Resolution:</strong>
+</p>
+<pre><code class="lang-csharp">// With explicit path
+factory.CreateEnumerable&lt;Company&gt;("Companies",
+    StorageOptions.WithPath("_01_Raw/data.csv"))
+// → {BasePath}/_01_Raw/data.csv
+
+// With default path (label-based)
+factory.CreateEnumerable&lt;Company&gt;("Companies")
+// → {BasePath}/Companies.csv</code></pre>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_Strategies_CsvStorageEntryFactory__ctor_Microsoft_Extensions_Configuration_IConfiguration_"></a> CsvStorageEntryFactory\(IConfiguration\)
+
+Initializes a new CSV storage factory.
+
+```csharp
+public CsvStorageEntryFactory(IConfiguration configuration)
+```
+
+#### Parameters
+
+`configuration` [IConfiguration](https://learn.microsoft.com/dotnet/api/microsoft.extensions.configuration.iconfiguration)
+
+Configuration containing optional DataPath setting
+
+### <a id="Flowthru_Data_Storage_Strategies_CsvStorageEntryFactory__ctor_System_String_"></a> CsvStorageEntryFactory\(string\)
+
+Initializes a new CSV storage factory with explicit base path.
+
+```csharp
+public CsvStorageEntryFactory(string basePath)
+```
+
+#### Parameters
+
+`basePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Base directory for all CSV files
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_Strategies_CsvStorageEntryFactory_CreateEnumerable__1_System_String_Flowthru_Data_Storage_Strategies_StorageOptions_"></a> CreateEnumerable<T\>\(string, StorageOptions?\)
+
+Creates a catalog entry for an enumerable dataset.
+
+```csharp
+public IItem<IEnumerable<T>> CreateEnumerable<T>(string label, StorageOptions? options = null) where T : notnull, IFlatSchema, ITextSerializable
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Catalog label for the entry
+
+`options` StorageOptions?
+
+Optional storage options
+
+#### Returns
+
+ IItem<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>\>
+
+Configured catalog entry
+
+#### Type Parameters
+
+`T` 
+
+Schema type (must implement IFlatSchema and ITextSerializable)
+
+#### Remarks
+
+<p>
+Type constraints ensure compatibility with CSV and Parquet serialization.
+Memory storage also works since it has no serialization requirements.
+</p>
+<p>
+If options.Path is null, the label is used to derive a default path
+(e.g., "Companies" → "Companies.csv" or "dbo.Companies").
+</p>
+
+### <a id="Flowthru_Data_Storage_Strategies_CsvStorageEntryFactory_CreateSingle__1_System_String_Flowthru_Data_Storage_Strategies_StorageOptions_"></a> CreateSingle<T\>\(string, StorageOptions?\)
+
+Creates a catalog entry for a singleton object.
+
+```csharp
+public IItem<T> CreateSingle<T>(string label, StorageOptions? options = null) where T : IStructuredSerializable
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Catalog label for the entry
+
+`options` StorageOptions?
+
+Optional storage options
+
+#### Returns
+
+ IItem<T\>
+
+Configured catalog entry
+
+#### Type Parameters
+
+`T` 
+
+Object type (must implement IStructuredSerializable)
+
+#### Remarks
+
+<p>
+Type constraint ensures compatibility with JSON serialization.
+Memory storage also works since it has no serialization requirements.
+</p>
+<p>
+Typically uses structured formats (JSON, MessagePack) for singletons.
+</p>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.Strategies.md b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.Strategies.md
new file mode 100644
index 00000000..b00cd4ee
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.Strategies.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Data_Storage_Strategies"></a> Namespace Flowthru.Data.Storage.Strategies
+
+### Classes
+
+ [CsvStorageEntryFactory](Flowthru.Data.Storage.Strategies.CsvStorageEntryFactory.md)
+
+CSV file-based storage strategy for local development.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.md b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.md
new file mode 100644
index 00000000..269f0a6f
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.Storage.md
@@ -0,0 +1,15 @@
+# <a id="Flowthru_Data_Storage"></a> Namespace Flowthru.Data.Storage
+
+### Namespaces
+
+ [Flowthru.Data.Storage.Format](Flowthru.Data.Storage.Format.md)
+
+ [Flowthru.Data.Storage.Strategies](Flowthru.Data.Storage.Strategies.md)
+
+### Classes
+
+ [DirectoryCsvStorageAdapter<TRow\>](Flowthru.Data.Storage.DirectoryCsvStorageAdapter\-1.md)
+
+Storage adapter that reads all CSV files in a directory and concatenates
+them into a single <xref href="System.Collections.Generic.IEnumerable%601" data-throw-if-not-resolved="false"></xref>.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.md b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.md
new file mode 100644
index 00000000..9ee4827b
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Csv/Flowthru.Data.md
@@ -0,0 +1,12 @@
+# <a id="Flowthru_Data"></a> Namespace Flowthru.Data
+
+### Namespaces
+
+ [Flowthru.Data.Storage](Flowthru.Data.Storage.md)
+
+### Classes
+
+ [CsvItemExtensions](Flowthru.Data.CsvItemExtensions.md)
+
+Extension methods that add CSV support to <xref href="Flowthru.Data.Items.Enumerable" data-throw-if-not-resolved="false"></xref>.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Csv/toc.yml b/docs/reference/src/extensions/Flowthru.Extensions.Csv/toc.yml
new file mode 100644
index 00000000..a2d55e2e
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Csv/toc.yml
@@ -0,0 +1,25 @@
+### YamlMime:TableOfContent
+- name: Flowthru.Data
+  href: Flowthru.Data.md
+  items:
+    - name: Classes
+    - name: CsvItemExtensions
+      href: Flowthru.Data.CsvItemExtensions.md
+- name: Flowthru.Data.Storage
+  href: Flowthru.Data.Storage.md
+  items:
+    - name: Classes
+    - name: DirectoryCsvStorageAdapter<TRow>
+      href: Flowthru.Data.Storage.DirectoryCsvStorageAdapter-1.md
+- name: Flowthru.Data.Storage.Format
+  href: Flowthru.Data.Storage.Format.md
+  items:
+    - name: Classes
+    - name: CsvFormatSerializer<TRow>
+      href: Flowthru.Data.Storage.Format.CsvFormatSerializer-1.md
+- name: Flowthru.Data.Storage.Strategies
+  href: Flowthru.Data.Storage.Strategies.md
+  items:
+    - name: Classes
+    - name: CsvStorageEntryFactory
+      href: Flowthru.Data.Storage.Strategies.CsvStorageEntryFactory.md
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Data.Storage.EFCoreSingleStorageAdapter-1.md b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Data.Storage.EFCoreSingleStorageAdapter-1.md
new file mode 100644
index 00000000..222b90c6
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Data.Storage.EFCoreSingleStorageAdapter-1.md
@@ -0,0 +1,315 @@
+# <a id="Flowthru_Data_Storage_EFCoreSingleStorageAdapter_1"></a> Class EFCoreSingleStorageAdapter<T\>
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Extensions.EFCore.dll  
+
+Storage adapter for single Entity Framework Core entities.
+Stores exactly one row in a database table.
+
+```csharp
+public sealed class EFCoreSingleStorageAdapter<T> : IStorageAdapter<T> where T : class
+```
+
+#### Type Parameters
+
+`T` 
+
+Entity type (must be a class type configured as EF entity)
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[EFCoreSingleStorageAdapter<T\>](Flowthru.Data.Storage.EFCoreSingleStorageAdapter\-1.md)
+
+#### Implements
+
+IStorageAdapter<T\>
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Save Semantics:</strong> Replace - removes all existing rows and inserts the new entity.
+Ensures table contains exactly one row after save.
+</p>
+<p>
+<strong>Load Semantics:</strong> Returns the single row from the table.
+Throws if table contains zero or more than one row.
+</p>
+<p>
+<strong>Exists Semantics:</strong> Returns true if table has exactly one row.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_EFCoreSingleStorageAdapter_1__ctor_Microsoft_EntityFrameworkCore_DbContext_System_Boolean_System_Boolean_System_Func_System_Linq_IQueryable__0__System_Linq_IQueryable__0___System_Func_Microsoft_EntityFrameworkCore_DbContext__0_System_Threading_CancellationToken_System_Threading_Tasks_Task__"></a> EFCoreSingleStorageAdapter\(DbContext, bool, bool, Func<IQueryable<T\>, IQueryable<T\>\>?, Func<DbContext, T, CancellationToken, Task\>?\)
+
+Creates an adapter with an injected DbContext instance.
+
+```csharp
+public EFCoreSingleStorageAdapter(DbContext context, bool ownsContext, bool allowEmptyData = false, Func<IQueryable<T>, IQueryable<T>>? queryCustomizer = null, Func<DbContext, T, CancellationToken, Task>? saveFunc = null)
+```
+
+#### Parameters
+
+`context` [DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext)
+
+DbContext to use for operations
+
+`ownsContext` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+If true, adapter disposes context after operations
+
+`allowEmptyData` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+`queryCustomizer` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>, [IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>\>?
+
+`saveFunc` [Func](https://learn.microsoft.com/dotnet/api/system.func\-4)<[DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext), T, [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)\>?
+
+#### Remarks
+
+To create a read-only catalog entry, use <code>.Constrain(traits =&gt; traits with { CanWrite = false })</code>
+on the catalog entry after construction.
+
+### <a id="Flowthru_Data_Storage_EFCoreSingleStorageAdapter_1__ctor_System_Func_Microsoft_EntityFrameworkCore_DbContext__System_Boolean_System_Func_System_Linq_IQueryable__0__System_Linq_IQueryable__0___System_Func_Microsoft_EntityFrameworkCore_DbContext__0_System_Threading_CancellationToken_System_Threading_Tasks_Task__"></a> EFCoreSingleStorageAdapter\(Func<DbContext\>, bool, Func<IQueryable<T\>, IQueryable<T\>\>?, Func<DbContext, T, CancellationToken, Task\>?\)
+
+Creates an adapter with a DbContext factory.
+
+```csharp
+public EFCoreSingleStorageAdapter(Func<DbContext> contextFactory, bool allowEmptyData = false, Func<IQueryable<T>, IQueryable<T>>? queryCustomizer = null, Func<DbContext, T, CancellationToken, Task>? saveFunc = null)
+```
+
+#### Parameters
+
+`contextFactory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-1)<[DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext)\>
+
+Factory to create DbContext instances
+
+`allowEmptyData` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+`queryCustomizer` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>, [IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>\>?
+
+`saveFunc` [Func](https://learn.microsoft.com/dotnet/api/system.func\-4)<[DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext), T, [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)\>?
+
+#### Remarks
+
+To create a read-only catalog entry, use <code>.Constrain(traits =&gt; traits with { CanWrite = false })</code>
+on the catalog entry after construction.
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_EFCoreSingleStorageAdapter_1_Traits"></a> Traits
+
+Structural constraints and capabilities of this storage implementation.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ StorageTraits
+
+#### Remarks
+
+<p>
+Adapter authors must declare what their storage can and cannot do.
+These are intrinsic properties of the storage medium, not runtime state.
+</p>
+<p>
+Pipeline validation uses these traits to fail fast when a pipeline attempts
+invalid operations (e.g., writing to a read-only source).
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_EFCoreSingleStorageAdapter_1_DefaultSave_Microsoft_EntityFrameworkCore_DbContext__0_System_Threading_CancellationToken_"></a> DefaultSave\(DbContext, T, CancellationToken\)
+
+Gets a DbContext from either the injected instance or factory.
+
+```csharp
+public static Task DefaultSave(DbContext context, T data, CancellationToken ct)
+```
+
+#### Parameters
+
+`context` [DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext)
+
+`data` T
+
+`ct` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
+
+### <a id="Flowthru_Data_Storage_EFCoreSingleStorageAdapter_1_Exists"></a> Exists\(\)
+
+Checks if data exists at this storage location.
+
+```csharp
+public FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ FlowIO<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+Effect that produces true if data exists, false otherwise
+
+#### Remarks
+
+<p>
+Delegates to the underlying medium's Exists check.
+Used to determine if a catalog entry is a seed (Layer 0 input).
+</p>
+
+### <a id="Flowthru_Data_Storage_EFCoreSingleStorageAdapter_1_InspectDeep"></a> InspectDeep\(\)
+
+Performs deep validation by examining the entire dataset.
+
+```csharp
+public FlowIO<ValidationResult> InspectDeep()
+```
+
+#### Returns
+
+ FlowIO<ValidationResult\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that all data is available, accessible, and valid.
+</p>
+<p>
+<strong>Additional Checks Beyond Shallow:</strong>
+</p>
+<ul><li>Validate ALL rows can be deserialized (not just sample)</li><li>Check data quality constraints across entire dataset</li><li>Detect corruption or inconsistencies throughout data</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Read and validate entire file</li><li>Memory adapters: Validate all stored data</li><li>Database adapters: Full table scan with validation</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Potentially expensive - only use when data integrity is critical.
+</p>
+
+### <a id="Flowthru_Data_Storage_EFCoreSingleStorageAdapter_1_InspectShallow_System_Int32_"></a> InspectShallow\(int\)
+
+Performs shallow validation by checking data availability and sampling a subset of data.
+
+```csharp
+public FlowIO<ValidationResult> InspectShallow(int sampleSize)
+```
+
+#### Parameters
+
+`sampleSize` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of rows/records to sample for validation
+
+#### Returns
+
+ FlowIO<ValidationResult\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that data is available and accessible.
+</p>
+<p>
+<strong>Typical Checks:</strong>
+</p>
+<ul><li>Data source exists (file, table, etc.)</li><li>Data source is accessible (permissions, connectivity)</li><li>Sample rows can be read and deserialized successfully</li><li>Schema matches expected structure</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Check file exists, read and validate sample rows</li><li>Memory adapters: Check if data has been initialized</li><li>Database adapters: Check table exists, query sample rows</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Should be fast (~10-100ms) - suitable for pre-flight validation.
+</p>
+
+### <a id="Flowthru_Data_Storage_EFCoreSingleStorageAdapter_1_Load"></a> Load\(\)
+
+Loads data from storage.
+
+```csharp
+public FlowIO<T> Load()
+```
+
+#### Returns
+
+ FlowIO<T\>
+
+Effect that produces data on success
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. medium.ReadStream()           → Stream
+2. format.DeserializeRows()      → IAsyncEnumerable&lt;TRow&gt;
+3. container.FromRows()          → TContainer</code></pre>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Errors from any layer are propagated:
+- Medium errors (file not found, access denied)
+- Format errors (parse failures, schema mismatches)
+- Container errors (memory allocation, type conversion)
+</p>
+
+### <a id="Flowthru_Data_Storage_EFCoreSingleStorageAdapter_1_Save__0_"></a> Save\(T\)
+
+Saves data to storage.
+
+```csharp
+public FlowIO<FlowUnit> Save(T data)
+```
+
+#### Parameters
+
+`data` T
+
+The data to save
+
+#### Returns
+
+ FlowIO<FlowUnit\>
+
+Effect that completes on successful save
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. container.ToRows()            → IAsyncEnumerable&lt;TRow&gt;
+2. format.SerializeRows()        → Stream
+3. medium.WriteStream()          → FlowUnit</code></pre>
+<p>
+<strong>Atomicity:</strong>
+</p>
+<p>
+Implementations should strive for atomic saves to avoid partial writes on failure.
+</p>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Data.Storage.EFCoreStorageAdapter-1.md b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Data.Storage.EFCoreStorageAdapter-1.md
new file mode 100644
index 00000000..6aa28fd8
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Data.Storage.EFCoreStorageAdapter-1.md
@@ -0,0 +1,298 @@
+# <a id="Flowthru_Data_Storage_EFCoreStorageAdapter_1"></a> Class EFCoreStorageAdapter<T\>
+
+Namespace: [Flowthru.Data.Storage](Flowthru.Data.Storage.md)  
+Assembly: Flowthru.Extensions.EFCore.dll  
+
+```csharp
+public sealed class EFCoreStorageAdapter<T> : IStorageAdapter<IEnumerable<T>> where T : class
+```
+
+#### Type Parameters
+
+`T` 
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[EFCoreStorageAdapter<T\>](Flowthru.Data.Storage.EFCoreStorageAdapter\-1.md)
+
+#### Implements
+
+IStorageAdapter<IEnumerable<T\>\>
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_EFCoreStorageAdapter_1__ctor_Microsoft_EntityFrameworkCore_DbContext_System_Boolean_System_Func_System_Linq_IQueryable__0__System_Linq_IQueryable__0___System_Func_Microsoft_EntityFrameworkCore_DbContext_System_Collections_Generic_IEnumerable__0__System_Threading_CancellationToken_System_Threading_Tasks_Task__"></a> EFCoreStorageAdapter\(DbContext, bool, Func<IQueryable<T\>, IQueryable<T\>\>?, Func<DbContext, IEnumerable<T\>, CancellationToken, Task\>?\)
+
+Creates an adapter with an injected DbContext.
+
+```csharp
+public EFCoreStorageAdapter(DbContext context, bool allowEmptyData = false, Func<IQueryable<T>, IQueryable<T>>? queryCustomizer = null, Func<DbContext, IEnumerable<T>, CancellationToken, Task>? saveFunc = null)
+```
+
+#### Parameters
+
+`context` [DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext)
+
+DbContext instance (caller owns lifecycle)
+
+`allowEmptyData` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+If true, empty tables are considered valid during validation
+
+`queryCustomizer` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>, [IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>\>?
+
+`saveFunc` [Func](https://learn.microsoft.com/dotnet/api/system.func\-4)<[DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext), [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>, [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)\>?
+
+#### Remarks
+
+To create a read-only catalog entry, use <code>.Constrain(traits =&gt; traits with { CanWrite = false })</code>
+on the catalog entry after construction.
+
+### <a id="Flowthru_Data_Storage_EFCoreStorageAdapter_1__ctor_System_Func_Microsoft_EntityFrameworkCore_DbContext__System_Boolean_System_Func_System_Linq_IQueryable__0__System_Linq_IQueryable__0___System_Func_Microsoft_EntityFrameworkCore_DbContext_System_Collections_Generic_IEnumerable__0__System_Threading_CancellationToken_System_Threading_Tasks_Task__"></a> EFCoreStorageAdapter\(Func<DbContext\>, bool, Func<IQueryable<T\>, IQueryable<T\>\>?, Func<DbContext, IEnumerable<T\>, CancellationToken, Task\>?\)
+
+Creates an adapter with a DbContext factory.
+
+```csharp
+public EFCoreStorageAdapter(Func<DbContext> contextFactory, bool allowEmptyData = false, Func<IQueryable<T>, IQueryable<T>>? queryCustomizer = null, Func<DbContext, IEnumerable<T>, CancellationToken, Task>? saveFunc = null)
+```
+
+#### Parameters
+
+`contextFactory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-1)<[DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext)\>
+
+Factory function to create DbContext instances
+
+`allowEmptyData` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+If true, empty tables are considered valid during validation
+
+`queryCustomizer` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>, [IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>\>?
+
+`saveFunc` [Func](https://learn.microsoft.com/dotnet/api/system.func\-4)<[DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext), [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>, [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)\>?
+
+#### Remarks
+
+To create a read-only catalog entry, use <code>.Constrain(traits =&gt; traits with { CanWrite = false })</code>
+on the catalog entry after construction.
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_EFCoreStorageAdapter_1_Traits"></a> Traits
+
+Structural constraints and capabilities of this storage implementation.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ StorageTraits
+
+#### Remarks
+
+<p>
+Adapter authors must declare what their storage can and cannot do.
+These are intrinsic properties of the storage medium, not runtime state.
+</p>
+<p>
+Pipeline validation uses these traits to fail fast when a pipeline attempts
+invalid operations (e.g., writing to a read-only source).
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_EFCoreStorageAdapter_1_DefaultSave_Microsoft_EntityFrameworkCore_DbContext_System_Collections_Generic_IEnumerable__0__System_Threading_CancellationToken_"></a> DefaultSave\(DbContext, IEnumerable<T\>, CancellationToken\)
+
+Default save strategy: replaces all rows with the new data.
+Reference this explicitly when composing with a custom save delegate
+(e.g., "use default load but custom save").
+
+```csharp
+public static Task DefaultSave(DbContext context, IEnumerable<T> data, CancellationToken ct)
+```
+
+#### Parameters
+
+`context` [DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext)
+
+`data` [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>
+
+`ct` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
+
+### <a id="Flowthru_Data_Storage_EFCoreStorageAdapter_1_Exists"></a> Exists\(\)
+
+Checks if data exists at this storage location.
+
+```csharp
+public FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ FlowIO<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+Effect that produces true if data exists, false otherwise
+
+#### Remarks
+
+<p>
+Delegates to the underlying medium's Exists check.
+Used to determine if a catalog entry is a seed (Layer 0 input).
+</p>
+
+### <a id="Flowthru_Data_Storage_EFCoreStorageAdapter_1_InspectDeep"></a> InspectDeep\(\)
+
+Performs deep validation by examining the entire dataset.
+
+```csharp
+public FlowIO<ValidationResult> InspectDeep()
+```
+
+#### Returns
+
+ FlowIO<ValidationResult\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that all data is available, accessible, and valid.
+</p>
+<p>
+<strong>Additional Checks Beyond Shallow:</strong>
+</p>
+<ul><li>Validate ALL rows can be deserialized (not just sample)</li><li>Check data quality constraints across entire dataset</li><li>Detect corruption or inconsistencies throughout data</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Read and validate entire file</li><li>Memory adapters: Validate all stored data</li><li>Database adapters: Full table scan with validation</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Potentially expensive - only use when data integrity is critical.
+</p>
+
+### <a id="Flowthru_Data_Storage_EFCoreStorageAdapter_1_InspectShallow_System_Int32_"></a> InspectShallow\(int\)
+
+Performs shallow validation by checking data availability and sampling a subset of data.
+
+```csharp
+public FlowIO<ValidationResult> InspectShallow(int sampleSize)
+```
+
+#### Parameters
+
+`sampleSize` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of rows/records to sample for validation
+
+#### Returns
+
+ FlowIO<ValidationResult\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that data is available and accessible.
+</p>
+<p>
+<strong>Typical Checks:</strong>
+</p>
+<ul><li>Data source exists (file, table, etc.)</li><li>Data source is accessible (permissions, connectivity)</li><li>Sample rows can be read and deserialized successfully</li><li>Schema matches expected structure</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Check file exists, read and validate sample rows</li><li>Memory adapters: Check if data has been initialized</li><li>Database adapters: Check table exists, query sample rows</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Should be fast (~10-100ms) - suitable for pre-flight validation.
+</p>
+
+### <a id="Flowthru_Data_Storage_EFCoreStorageAdapter_1_Load"></a> Load\(\)
+
+Loads data from storage.
+
+```csharp
+public FlowIO<IEnumerable<T>> Load()
+```
+
+#### Returns
+
+ FlowIO<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>\>
+
+Effect that produces data on success
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. medium.ReadStream()           → Stream
+2. format.DeserializeRows()      → IAsyncEnumerable&lt;TRow&gt;
+3. container.FromRows()          → TContainer</code></pre>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Errors from any layer are propagated:
+- Medium errors (file not found, access denied)
+- Format errors (parse failures, schema mismatches)
+- Container errors (memory allocation, type conversion)
+</p>
+
+### <a id="Flowthru_Data_Storage_EFCoreStorageAdapter_1_Save_System_Collections_Generic_IEnumerable__0__"></a> Save\(IEnumerable<T\>\)
+
+Saves data to storage.
+
+```csharp
+public FlowIO<FlowUnit> Save(IEnumerable<T> data)
+```
+
+#### Parameters
+
+`data` [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>
+
+The data to save
+
+#### Returns
+
+ FlowIO<FlowUnit\>
+
+Effect that completes on successful save
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. container.ToRows()            → IAsyncEnumerable&lt;TRow&gt;
+2. format.SerializeRows()        → Stream
+3. medium.WriteStream()          → FlowUnit</code></pre>
+<p>
+<strong>Atomicity:</strong>
+</p>
+<p>
+Implementations should strive for atomic saves to avoid partial writes on failure.
+</p>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Data.Storage.md b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Data.Storage.md
new file mode 100644
index 00000000..5f263a5d
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Data.Storage.md
@@ -0,0 +1,11 @@
+# <a id="Flowthru_Data_Storage"></a> Namespace Flowthru.Data.Storage
+
+### Classes
+
+ [EFCoreSingleStorageAdapter<T\>](Flowthru.Data.Storage.EFCoreSingleStorageAdapter\-1.md)
+
+Storage adapter for single Entity Framework Core entities.
+Stores exactly one row in a database table.
+
+ [EFCoreStorageAdapter<T\>](Flowthru.Data.Storage.EFCoreStorageAdapter\-1.md)
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Data.EFCoreCatalogEntries.Enumerable.md b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Data.EFCoreCatalogEntries.Enumerable.md
new file mode 100644
index 00000000..4407c94c
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Data.EFCoreCatalogEntries.Enumerable.md
@@ -0,0 +1,264 @@
+# <a id="Flowthru_Extensions_EFCore_Data_EFCoreItems_Enumerable"></a> Class EFCoreItems.Enumerable
+
+Namespace: [Flowthru.Extensions.EFCore.Data](Flowthru.Extensions.EFCore.Data.md)  
+Assembly: Flowthru.Extensions.EFCore.dll  
+
+```csharp
+public static class EFCoreItems.Enumerable
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[EFCoreItems.Enumerable](Flowthru.Extensions.EFCore.Data.EFCoreItems.Enumerable.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Flowthru_Extensions_EFCore_Data_EFCoreItems_Enumerable_EFCore__1_System_String_Microsoft_EntityFrameworkCore_DbContext_System_Boolean_System_Func_System_Linq_IQueryable___0__System_Linq_IQueryable___0___System_Func_Microsoft_EntityFrameworkCore_DbContext_System_Collections_Generic_IEnumerable___0__System_Threading_CancellationToken_System_Threading_Tasks_Task__"></a> EFCore<T\>\(string, DbContext, bool, Func<IQueryable<T\>, IQueryable<T\>\>?, Func<DbContext, IEnumerable<T\>, CancellationToken, Task\>?\)
+
+Creates an Entity Framework Core catalog entry for database-backed collections.
+
+```csharp
+public static Item<IEnumerable<T>> EFCore<T>(string label, DbContext context, bool allowEmptyData = false, Func<IQueryable<T>, IQueryable<T>>? queryCustomizer = null, Func<DbContext, IEnumerable<T>, CancellationToken, Task>? saveFunc = null) where T : class
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`context` [DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext)
+
+DbContext instance (caller owns lifecycle)
+
+`allowEmptyData` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+If true, empty tables pass validation (default: false)
+
+`queryCustomizer` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>, [IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>\>?
+
+`saveFunc` [Func](https://learn.microsoft.com/dotnet/api/system.func\-4)<[DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext), [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>, [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)\>?
+
+#### Returns
+
+ Item<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>\>
+
+Catalog entry for EFCore database storage
+
+#### Type Parameters
+
+`T` 
+
+Entity type (must be a class configured in DbContext)
+
+#### Examples
+
+<pre><code class="lang-csharp">// In catalog
+public static partial class DataCatalog
+{
+  public static IItem&lt;IEnumerable&lt;Company&gt;&gt; Companies(DbContext db) =&gt;
+    Items.Enumerable.EFCore&lt;Company&gt;("companies", db);
+}
+
+// In pipeline
+var pipeline = new FlowBuilder("CompanyPipeline")
+  .AddStep("load_companies", catalog =&gt; new LoadCompaniesNode(
+    outputs: catalog.Companies(db)
+  ))
+  .Build();</code></pre>
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Read/write entities from relational databases using EF Core
+</p>
+<p>
+<strong>DbContext Lifecycle:</strong> Caller provides DbContext and manages its lifecycle.
+Use this overload when DbContext comes from DI container or is shared across operations.
+</p>
+<p>
+<strong>Read-Only Entries:</strong>
+To create a read-only catalog entry, apply a constraint:
+<code>.Constrain(traits =&gt; traits with { CanWrite = false })</code>
+</p>
+<p>
+<strong>Empty Data Validation:</strong>
+By default (allowEmptyData: false), empty tables fail pre-flight validation.
+Set allowEmptyData: true for tables that may legitimately be empty.
+</p>
+
+### <a id="Flowthru_Extensions_EFCore_Data_EFCoreItems_Enumerable_EFCore__1_System_String_System_Func_Microsoft_EntityFrameworkCore_DbContext__System_Boolean_System_Func_System_Linq_IQueryable___0__System_Linq_IQueryable___0___System_Func_Microsoft_EntityFrameworkCore_DbContext_System_Collections_Generic_IEnumerable___0__System_Threading_CancellationToken_System_Threading_Tasks_Task__"></a> EFCore<T\>\(string, Func<DbContext\>, bool, Func<IQueryable<T\>, IQueryable<T\>\>?, Func<DbContext, IEnumerable<T\>, CancellationToken, Task\>?\)
+
+Creates an Entity Framework Core catalog entry with a DbContext factory.
+
+```csharp
+public static Item<IEnumerable<T>> EFCore<T>(string label, Func<DbContext> contextFactory, bool allowEmptyData = false, Func<IQueryable<T>, IQueryable<T>>? queryCustomizer = null, Func<DbContext, IEnumerable<T>, CancellationToken, Task>? saveFunc = null) where T : class
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`contextFactory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-1)<[DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext)\>
+
+Factory function to create DbContext instances per operation
+
+`allowEmptyData` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+If true, empty tables pass validation (default: false)
+
+`queryCustomizer` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>, [IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>\>?
+
+`saveFunc` [Func](https://learn.microsoft.com/dotnet/api/system.func\-4)<[DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext), [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>, [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)\>?
+
+#### Returns
+
+ Item<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>\>
+
+Catalog entry for EFCore database storage
+
+#### Type Parameters
+
+`T` 
+
+Entity type (must be a class configured in DbContext)
+
+#### Examples
+
+<pre><code class="lang-csharp">// In catalog
+public static partial class DataCatalog
+{
+  private static AppDbContext CreateDbContext() =&gt;
+    new AppDbContext(new DbContextOptionsBuilder&lt;AppDbContext&gt;()
+      .UseSqlServer(connectionString)
+      .Options);
+
+  public static IItem&lt;IEnumerable&lt;Company&gt;&gt; Companies() =&gt;
+    Items.Enumerable.EFCore&lt;Company&gt;("companies", CreateDbContext);
+}</code></pre>
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> When DbContext should be created fresh for each Load/Save operation
+</p>
+<p>
+<strong>DbContext Lifecycle:</strong> Adapter creates DbContext via factory and disposes it
+after each operation. Use this overload for scoped DbContext patterns.
+</p>
+<p>
+<strong>Read-Only Entries:</strong>
+To create a read-only catalog entry, apply a constraint:
+<code>.Constrain(traits =&gt; traits with { CanWrite = false })</code>
+</p>
+
+### <a id="Flowthru_Extensions_EFCore_Data_EFCoreItems_Enumerable_EFCore__2_System_String_System_Func___1__System_Boolean_System_Func_System_Linq_IQueryable___0__System_Linq_IQueryable___0___System_Func___1_System_Collections_Generic_IEnumerable___0__System_Threading_CancellationToken_System_Threading_Tasks_Task__"></a> EFCore<T, TContext\>\(string, Func<TContext\>, bool, Func<IQueryable<T\>, IQueryable<T\>\>?, Func<TContext, IEnumerable<T\>, CancellationToken, Task\>?\)
+
+Creates an EFCore catalog entry with a typed DbContext factory.
+The concrete <code class="typeparamref">TContext</code> flows through to the save delegate,
+eliminating any downcast inside the delegate body.
+
+```csharp
+public static Item<IEnumerable<T>> EFCore<T, TContext>(string label, Func<TContext> contextFactory, bool allowEmptyData = false, Func<IQueryable<T>, IQueryable<T>>? queryCustomizer = null, Func<TContext, IEnumerable<T>, CancellationToken, Task>? saveFunc = null) where T : class where TContext : DbContext
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`contextFactory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-1)<TContext\>
+
+Typed factory; called per Load/Save operation
+
+`allowEmptyData` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+If true, empty tables pass validation (default: false)
+
+`queryCustomizer` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>, [IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>\>?
+
+Optional query transformation applied before materialization (e.g. Include, Where, OrderBy)
+
+`saveFunc` [Func](https://learn.microsoft.com/dotnet/api/system.func\-4)<TContext, [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>, [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)\>?
+
+Optional save delegate receiving the concrete <code class="typeparamref">TContext</code>.
+    Defaults to RemoveRange + AddRange when null.
+
+#### Returns
+
+ Item<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>\>
+
+Catalog entry for EFCore database storage
+
+#### Type Parameters
+
+`T` 
+
+Entity type
+
+`TContext` 
+
+Concrete DbContext type
+
+### <a id="Flowthru_Extensions_EFCore_Data_EFCoreItems_Enumerable_EFCore__2_System_String_Microsoft_EntityFrameworkCore_IDbContextFactory___1__System_Boolean_System_Func_System_Linq_IQueryable___0__System_Linq_IQueryable___0___System_Func___1_System_Collections_Generic_IEnumerable___0__System_Threading_CancellationToken_System_Threading_Tasks_Task__"></a> EFCore<T, TContext\>\(string, IDbContextFactory<TContext\>, bool, Func<IQueryable<T\>, IQueryable<T\>\>?, Func<TContext, IEnumerable<T\>, CancellationToken, Task\>?\)
+
+Creates an EFCore catalog entry using <xref href="Microsoft.EntityFrameworkCore.IDbContextFactory%601" data-throw-if-not-resolved="false"></xref> —
+the idiomatic EFCore pattern for per-operation context isolation and concurrent node safety.
+
+```csharp
+public static Item<IEnumerable<T>> EFCore<T, TContext>(string label, IDbContextFactory<TContext> contextFactory, bool allowEmptyData = false, Func<IQueryable<T>, IQueryable<T>>? queryCustomizer = null, Func<TContext, IEnumerable<T>, CancellationToken, Task>? saveFunc = null) where T : class where TContext : DbContext
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`contextFactory` [IDbContextFactory](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.idbcontextfactory\-1)<TContext\>
+
+EFCore context factory; a fresh context is created per Load/Save operation
+
+`allowEmptyData` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+If true, empty tables pass validation (default: false)
+
+`queryCustomizer` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>, [IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>\>?
+
+Optional query transformation applied before materialization
+
+`saveFunc` [Func](https://learn.microsoft.com/dotnet/api/system.func\-4)<TContext, [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>, [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)\>?
+
+Optional save delegate receiving the concrete <code class="typeparamref">TContext</code>.
+    Defaults to RemoveRange + AddRange when null.
+
+#### Returns
+
+ Item<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>\>
+
+Catalog entry for EFCore database storage
+
+#### Type Parameters
+
+`T` 
+
+Entity type
+
+`TContext` 
+
+Concrete DbContext type
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Data.EFCoreCatalogEntries.Single.md b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Data.EFCoreCatalogEntries.Single.md
new file mode 100644
index 00000000..8f936d33
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Data.EFCoreCatalogEntries.Single.md
@@ -0,0 +1,252 @@
+# <a id="Flowthru_Extensions_EFCore_Data_EFCoreItems_Single"></a> Class EFCoreItems.Single
+
+Namespace: [Flowthru.Extensions.EFCore.Data](Flowthru.Extensions.EFCore.Data.md)  
+Assembly: Flowthru.Extensions.EFCore.dll  
+
+```csharp
+public static class EFCoreItems.Single
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[EFCoreItems.Single](Flowthru.Extensions.EFCore.Data.EFCoreItems.Single.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Flowthru_Extensions_EFCore_Data_EFCoreItems_Single_EFCore__1_System_String_Microsoft_EntityFrameworkCore_DbContext_System_Boolean_System_Func_System_Linq_IQueryable___0__System_Linq_IQueryable___0___System_Func_Microsoft_EntityFrameworkCore_DbContext___0_System_Threading_CancellationToken_System_Threading_Tasks_Task__"></a> EFCore<T\>\(string, DbContext, bool, Func<IQueryable<T\>, IQueryable<T\>\>?, Func<DbContext, T, CancellationToken, Task\>?\)
+
+Creates an Entity Framework Core catalog entry for single database-backed entities.
+
+```csharp
+public static Item<T> EFCore<T>(string label, DbContext context, bool allowEmptyData = false, Func<IQueryable<T>, IQueryable<T>>? queryCustomizer = null, Func<DbContext, T, CancellationToken, Task>? saveFunc = null) where T : class
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`context` [DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext)
+
+DbContext instance (caller owns lifecycle)
+
+`allowEmptyData` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+`queryCustomizer` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>, [IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>\>?
+
+`saveFunc` [Func](https://learn.microsoft.com/dotnet/api/system.func\-4)<[DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext), T, [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)\>?
+
+#### Returns
+
+ Item<T\>
+
+Catalog entry for EFCore single entity storage
+
+#### Type Parameters
+
+`T` 
+
+Entity type (must be a class configured in DbContext)
+
+#### Examples
+
+<pre><code class="lang-csharp">// In catalog
+public IItem&lt;ModelMetrics&gt; Metrics(DbContext db) =&gt;
+  Items.Single.EFCore&lt;ModelMetrics&gt;("metrics", db);
+
+// In pipeline
+var pipeline = new FlowBuilder("MetricsPipeline")
+  .AddStep("save_metrics", catalog =&gt; new SaveMetricsNode(
+    outputs: catalog.Metrics(db)
+  ))
+  .Build();</code></pre>
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Store single entities (models, metrics, configs) in database
+</p>
+<p>
+<strong>Implementation:</strong> Stores entity in a table, expects exactly one row on Load.
+Save replaces the single row (clear table, insert new row).
+</p>
+<p>
+<strong>DbContext Lifecycle:</strong> Caller provides DbContext and manages its lifecycle.
+Use this overload when DbContext comes from DI container or is shared across operations.
+</p>
+<p>
+<strong>Read-Only Entries:</strong>
+To create a read-only catalog entry, apply a constraint:
+<code>.Constrain(traits =&gt; traits with { CanWrite = false })</code>
+</p>
+
+### <a id="Flowthru_Extensions_EFCore_Data_EFCoreItems_Single_EFCore__1_System_String_System_Func_Microsoft_EntityFrameworkCore_DbContext__System_Boolean_System_Func_System_Linq_IQueryable___0__System_Linq_IQueryable___0___System_Func_Microsoft_EntityFrameworkCore_DbContext___0_System_Threading_CancellationToken_System_Threading_Tasks_Task__"></a> EFCore<T\>\(string, Func<DbContext\>, bool, Func<IQueryable<T\>, IQueryable<T\>\>?, Func<DbContext, T, CancellationToken, Task\>?\)
+
+Creates an Entity Framework Core catalog entry for single database-backed entities using a factory.
+
+```csharp
+public static Item<T> EFCore<T>(string label, Func<DbContext> contextFactory, bool allowEmptyData = false, Func<IQueryable<T>, IQueryable<T>>? queryCustomizer = null, Func<DbContext, T, CancellationToken, Task>? saveFunc = null) where T : class
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`contextFactory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-1)<[DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext)\>
+
+Factory that creates DbContext instances (adapter owns lifecycle)
+
+`allowEmptyData` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+`queryCustomizer` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>, [IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>\>?
+
+`saveFunc` [Func](https://learn.microsoft.com/dotnet/api/system.func\-4)<[DbContext](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.dbcontext), T, [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)\>?
+
+#### Returns
+
+ Item<T\>
+
+Catalog entry for EFCore single entity storage
+
+#### Type Parameters
+
+`T` 
+
+Entity type (must be a class configured in DbContext)
+
+#### Examples
+
+<pre><code class="lang-csharp">// In catalog with factory
+private readonly IServiceProvider _serviceProvider;
+
+public IItem&lt;ModelMetrics&gt; Metrics =&gt;
+  Items.Single.EFCore&lt;ModelMetrics&gt;(
+    "metrics",
+    () =&gt; _serviceProvider.GetRequiredService&lt;MyDbContext&gt;()
+  );</code></pre>
+
+#### Remarks
+
+<p>
+<strong>Use Case:</strong> Store single entities when you want adapter to manage DbContext lifecycle
+</p>
+<p>
+<strong>DbContext Lifecycle:</strong> Adapter creates and disposes DbContext per operation.
+Use this overload when operations should be isolated or when DbContext is expensive to keep alive.
+</p>
+<p>
+<strong>Read-Only Entries:</strong>
+To create a read-only catalog entry, apply a constraint:
+<code>.Constrain(traits =&gt; traits with { CanWrite = false })</code>
+</p>
+
+### <a id="Flowthru_Extensions_EFCore_Data_EFCoreItems_Single_EFCore__2_System_String_System_Func___1__System_Boolean_System_Func_System_Linq_IQueryable___0__System_Linq_IQueryable___0___System_Func___1___0_System_Threading_CancellationToken_System_Threading_Tasks_Task__"></a> EFCore<T, TContext\>\(string, Func<TContext\>, bool, Func<IQueryable<T\>, IQueryable<T\>\>?, Func<TContext, T, CancellationToken, Task\>?\)
+
+Creates a single-entity EFCore catalog entry with a typed DbContext factory.
+The concrete <code class="typeparamref">TContext</code> flows through to the save delegate,
+eliminating any downcast inside the delegate body.
+
+```csharp
+public static Item<T> EFCore<T, TContext>(string label, Func<TContext> contextFactory, bool allowEmptyData = false, Func<IQueryable<T>, IQueryable<T>>? queryCustomizer = null, Func<TContext, T, CancellationToken, Task>? saveFunc = null) where T : class where TContext : DbContext
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`contextFactory` [Func](https://learn.microsoft.com/dotnet/api/system.func\-1)<TContext\>
+
+Typed factory; called per Load/Save operation
+
+`allowEmptyData` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+If true, an empty table passes validation (default: false)
+
+`queryCustomizer` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>, [IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>\>?
+
+Optional query transformation applied before SingleAsync
+
+`saveFunc` [Func](https://learn.microsoft.com/dotnet/api/system.func\-4)<TContext, T, [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)\>?
+
+Optional save delegate receiving the concrete <code class="typeparamref">TContext</code>.
+    Defaults to clear-and-insert when null.
+
+#### Returns
+
+ Item<T\>
+
+Catalog entry for EFCore single entity storage
+
+#### Type Parameters
+
+`T` 
+
+Entity type
+
+`TContext` 
+
+Concrete DbContext type
+
+### <a id="Flowthru_Extensions_EFCore_Data_EFCoreItems_Single_EFCore__2_System_String_Microsoft_EntityFrameworkCore_IDbContextFactory___1__System_Boolean_System_Func_System_Linq_IQueryable___0__System_Linq_IQueryable___0___System_Func___1___0_System_Threading_CancellationToken_System_Threading_Tasks_Task__"></a> EFCore<T, TContext\>\(string, IDbContextFactory<TContext\>, bool, Func<IQueryable<T\>, IQueryable<T\>\>?, Func<TContext, T, CancellationToken, Task\>?\)
+
+Creates a single-entity EFCore catalog entry using <xref href="Microsoft.EntityFrameworkCore.IDbContextFactory%601" data-throw-if-not-resolved="false"></xref>.
+
+```csharp
+public static Item<T> EFCore<T, TContext>(string label, IDbContextFactory<TContext> contextFactory, bool allowEmptyData = false, Func<IQueryable<T>, IQueryable<T>>? queryCustomizer = null, Func<TContext, T, CancellationToken, Task>? saveFunc = null) where T : class where TContext : DbContext
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`contextFactory` [IDbContextFactory](https://learn.microsoft.com/dotnet/api/microsoft.entityframeworkcore.idbcontextfactory\-1)<TContext\>
+
+EFCore context factory; a fresh context is created per Load/Save operation
+
+`allowEmptyData` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+If true, an empty table passes validation (default: false)
+
+`queryCustomizer` [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<[IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>, [IQueryable](https://learn.microsoft.com/dotnet/api/system.linq.iqueryable\-1)<T\>\>?
+
+Optional query transformation applied before SingleAsync
+
+`saveFunc` [Func](https://learn.microsoft.com/dotnet/api/system.func\-4)<TContext, T, [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken), [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)\>?
+
+Optional save delegate receiving the concrete <code class="typeparamref">TContext</code>.
+    Defaults to clear-and-insert when null.
+
+#### Returns
+
+ Item<T\>
+
+Catalog entry for EFCore single entity storage
+
+#### Type Parameters
+
+`T` 
+
+Entity type
+
+`TContext` 
+
+Concrete DbContext type
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Data.EFCoreCatalogEntries.md b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Data.EFCoreCatalogEntries.md
new file mode 100644
index 00000000..0190dc48
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Data.EFCoreCatalogEntries.md
@@ -0,0 +1,24 @@
+# <a id="Flowthru_Extensions_EFCore_Data_EFCoreItems"></a> Class EFCoreItems
+
+Namespace: [Flowthru.Extensions.EFCore.Data](Flowthru.Extensions.EFCore.Data.md)  
+Assembly: Flowthru.Extensions.EFCore.dll  
+
+```csharp
+public static class EFCoreItems
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[EFCoreItems](Flowthru.Extensions.EFCore.Data.EFCoreItems.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Data.md b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Data.md
new file mode 100644
index 00000000..e16e5a3c
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Data.md
@@ -0,0 +1,10 @@
+# <a id="Flowthru_Extensions_EFCore_Data"></a> Namespace Flowthru.Extensions.EFCore.Data
+
+### Classes
+
+ [EFCoreItems](Flowthru.Extensions.EFCore.Data.EFCoreItems.md)
+
+ [EFCoreItems.Enumerable](Flowthru.Extensions.EFCore.Data.EFCoreItems.Enumerable.md)
+
+ [EFCoreItems.Single](Flowthru.Extensions.EFCore.Data.EFCoreItems.Single.md)
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Tests.CompilationTest.md b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Tests.CompilationTest.md
new file mode 100644
index 00000000..5fac47d1
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Tests.CompilationTest.md
@@ -0,0 +1,52 @@
+# <a id="Flowthru_Extensions_EFCore_Tests_CompilationTest"></a> Class CompilationTest
+
+Namespace: [Flowthru.Extensions.EFCore.Tests](Flowthru.Extensions.EFCore.Tests.md)  
+Assembly: Flowthru.Extensions.EFCore.dll  
+
+Minimal compilation test to verify extension pattern works.
+
+```csharp
+public class CompilationTest
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[CompilationTest](Flowthru.Extensions.EFCore.Tests.CompilationTest.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Flowthru_Extensions_EFCore_Tests_CompilationTest_DbContextFactoryOverloadsWork"></a> DbContextFactoryOverloadsWork\(\)
+
+```csharp
+public void DbContextFactoryOverloadsWork()
+```
+
+### <a id="Flowthru_Extensions_EFCore_Tests_CompilationTest_PartialClassExtensionWorks"></a> PartialClassExtensionWorks\(\)
+
+```csharp
+public void PartialClassExtensionWorks()
+```
+
+### <a id="Flowthru_Extensions_EFCore_Tests_CompilationTest_SingleTypedContextOverloadsWork"></a> SingleTypedContextOverloadsWork\(\)
+
+```csharp
+public void SingleTypedContextOverloadsWork()
+```
+
+### <a id="Flowthru_Extensions_EFCore_Tests_CompilationTest_TypedContextFactoryOverloadsWork"></a> TypedContextFactoryOverloadsWork\(\)
+
+```csharp
+public void TypedContextFactoryOverloadsWork()
+```
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Tests.md b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Tests.md
new file mode 100644
index 00000000..d6273dc9
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/Flowthru.Extensions.EFCore.Tests.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Extensions_EFCore_Tests"></a> Namespace Flowthru.Extensions.EFCore.Tests
+
+### Classes
+
+ [CompilationTest](Flowthru.Extensions.EFCore.Tests.CompilationTest.md)
+
+Minimal compilation test to verify extension pattern works.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.EFCore/toc.yml b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/toc.yml
new file mode 100644
index 00000000..82336d47
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.EFCore/toc.yml
@@ -0,0 +1,25 @@
+### YamlMime:TableOfContent
+- name: Flowthru.Data.Storage
+  href: Flowthru.Data.Storage.md
+  items:
+    - name: Classes
+    - name: EFCoreSingleStorageAdapter<T>
+      href: Flowthru.Data.Storage.EFCoreSingleStorageAdapter-1.md
+    - name: EFCoreStorageAdapter<T>
+      href: Flowthru.Data.Storage.EFCoreStorageAdapter-1.md
+- name: Flowthru.Extensions.EFCore.Data
+  href: Flowthru.Extensions.EFCore.Data.md
+  items:
+    - name: Classes
+    - name: EFCoreItems
+      href: Flowthru.Extensions.EFCore.Data.EFCoreItems.md
+    - name: EFCoreItems.Enumerable
+      href: Flowthru.Extensions.EFCore.Data.EFCoreItems.Enumerable.md
+    - name: EFCoreItems.Single
+      href: Flowthru.Extensions.EFCore.Data.EFCoreItems.Single.md
+- name: Flowthru.Extensions.EFCore.Tests
+  href: Flowthru.Extensions.EFCore.Tests.md
+  items:
+    - name: Classes
+    - name: CompilationTest
+      href: Flowthru.Extensions.EFCore.Tests.CompilationTest.md
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Excel/Flowthru.Data.ExcelCatalogEntryExtensions.md b/docs/reference/src/extensions/Flowthru.Extensions.Excel/Flowthru.Data.ExcelCatalogEntryExtensions.md
new file mode 100644
index 00000000..91616a06
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Excel/Flowthru.Data.ExcelCatalogEntryExtensions.md
@@ -0,0 +1,81 @@
+# <a id="Flowthru_Data_ExcelItemExtensions"></a> Class ExcelItemExtensions
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Extensions.Excel.dll  
+
+Extension methods that add Excel support to <xref href="Flowthru.Data.Items.Enumerable" data-throw-if-not-resolved="false"></xref>.
+
+```csharp
+public static class ExcelItemExtensions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ExcelItemExtensions](Flowthru.Data.ExcelItemExtensions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Flowthru_Data_ExcelItemExtensions_Excel__1_Flowthru_Data_EnumerableItems_System_String_System_String_System_String_"></a> Excel<TRow\>\(EnumerableItems, string, string, string\)
+
+Creates a read-only Excel file catalog entry with IEnumerable container.
+
+```csharp
+public static Item<IEnumerable<TRow>> Excel<TRow>(this EnumerableItems _, string label, string filePath, string sheetName) where TRow : notnull, IFlatSchema, ITextSerializable
+```
+
+#### Parameters
+
+`_` EnumerableItems
+
+The enumerable catalog entries factory (from <xref href="Flowthru.Data.Items.Enumerable" data-throw-if-not-resolved="false"></xref>)
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to Excel file (.xlsx)
+
+`sheetName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Name of the sheet to read
+
+#### Returns
+
+ Item<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<TRow\>\>
+
+Catalog entry with read-only Excel support
+
+#### Type Parameters
+
+`TRow` 
+
+Row schema type (must be flat and text-serializable)
+
+#### Remarks
+
+<p>
+<strong>Requirements:</strong>
+</p>
+<ul><li>TRow must implement IFlatSchema (Excel is tabular)</li><li>TRow must implement ITextSerializable</li></ul>
+<p>
+<strong>Limitations:</strong> Read-only support via ExcelDataReader.
+Writing Excel files is not supported.
+</p>
+<p>
+<strong>Storage Traits:</strong>
+</p>
+<ul><li>CanWrite: false (Excel adapter is read-only via ExcelDataReader)</li></ul>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Excel/Flowthru.Data.Storage.Format.ExcelFormatSerializer-1.md b/docs/reference/src/extensions/Flowthru.Extensions.Excel/Flowthru.Data.Storage.Format.ExcelFormatSerializer-1.md
new file mode 100644
index 00000000..4d44fb9c
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Excel/Flowthru.Data.Storage.Format.ExcelFormatSerializer-1.md
@@ -0,0 +1,235 @@
+# <a id="Flowthru_Data_Storage_Format_ExcelFormatSerializer_1"></a> Class ExcelFormatSerializer<TRow\>
+
+Namespace: [Flowthru.Data.Storage.Format](Flowthru.Data.Storage.Format.md)  
+Assembly: Flowthru.Extensions.Excel.dll  
+
+Serializes flat schemas to/from Excel (.xlsx) files using ExcelDataReader.
+
+```csharp
+public sealed class ExcelFormatSerializer<TRow> : IFormatSerializer<TRow> where TRow : notnull, IFlatSchema, ITextSerializable
+```
+
+#### Type Parameters
+
+`TRow` 
+
+Row type (must be flat and text-serializable)
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ExcelFormatSerializer<TRow\>](Flowthru.Data.Storage.Format.ExcelFormatSerializer\-1.md)
+
+#### Implements
+
+IFormatSerializer<TRow\>
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Read-Only:</strong> ExcelDataReader only supports reading Excel files.
+Calling SerializeRows will throw NotSupportedException.
+</p>
+<p>
+<strong>Sheet Selection:</strong> Reads from specified sheet name.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_Format_ExcelFormatSerializer_1__ctor_System_String_"></a> ExcelFormatSerializer\(string\)
+
+```csharp
+public ExcelFormatSerializer(string sheetName)
+```
+
+#### Parameters
+
+`sheetName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_Format_ExcelFormatSerializer_1_Traits"></a> Traits
+
+Structural capabilities of this format serializer.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ StorageTraits
+
+#### Remarks
+
+<p>
+Format traits focus on HOW data is serialized and whether it supports streaming.
+For composed adapters, these traits are merged with medium and container traits.
+</p>
+<p>
+Most formats should declare <code>CanStream = true</code> if they can deserialize row-by-row
+without buffering the entire stream (e.g., CSV, JSONL). Formats that require full
+parsing before yielding rows (e.g., JSON arrays) should set <code>CanStream = false</code>.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_Format_ExcelFormatSerializer_1_DeserializeRows_System_IO_Stream_"></a> DeserializeRows\(Stream\)
+
+Deserializes a stream of bytes into a stream of rows.
+
+```csharp
+public IAsyncEnumerable<TRow> DeserializeRows(Stream stream)
+```
+
+#### Parameters
+
+`stream` [Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)
+
+The stream containing serialized data
+
+#### Returns
+
+ [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<TRow\>
+
+Async enumerable of deserialized rows
+
+#### Remarks
+
+<p>
+<strong>Streaming Behavior:</strong>
+</p>
+<p>
+Rows should be yielded as they are deserialized (lazy evaluation).
+This allows processing large datasets without loading everything into memory.
+</p>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Deserialization errors should throw exceptions:
+- Format exceptions (malformed CSV, invalid JSON)
+- Schema mismatches (missing columns, type conversion failures)
+- I/O errors during stream reading
+</p>
+<p>
+The caller should handle these exceptions appropriately.
+</p>
+
+### <a id="Flowthru_Data_Storage_Format_ExcelFormatSerializer_1_GetPropertyMappingConfiguration"></a> GetPropertyMappingConfiguration\(\)
+
+Configures how this serializer handles property-to-field name mapping for the schema.
+
+```csharp
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+```
+
+#### Returns
+
+ PropertyMappingConfiguration
+
+Property mapping configuration describing the mapping strategy
+
+#### Examples
+
+<pre><code class="lang-csharp">// CSV serializer using SerializedLabel
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+    =&gt; PropertyMappingConfiguration.FromSerializedLabel&lt;TRow&gt;();
+
+// ML.NET serializer using native attributes
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+    =&gt; PropertyMappingConfiguration.FromNativeAttributes("LoadColumnAttribute");
+
+// Parquet with library-controlled mapping
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+    =&gt; PropertyMappingConfiguration.LibraryControlled();</code></pre>
+
+#### Remarks
+
+<p>
+<strong>Contractual Obligation:</strong> Every format serializer MUST implement this method
+to explicitly declare how it handles property name mapping.
+</p>
+<p>
+<strong>Implementation Strategies:</strong>
+</p>
+<ul><li>
+<strong>SerializedLabel Support:</strong> Use <xref href="Flowthru.Data.Storage.Format.PropertyMappingHelper" data-throw-if-not-resolved="false"></xref>
+to respect [SerializedLabel] attributes. Return <xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.FromSerializedLabel%60%601" data-throw-if-not-resolved="false"></xref>.
+</li><li>
+<strong>Native Attribute Mapping:</strong> Use format-specific attributes (e.g., ML.NET's [LoadColumn]).
+Return <xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.FromNativeAttributes(System.String)" data-throw-if-not-resolved="false"></xref> with the attribute type name.
+</li><li>
+<strong>Library-Controlled:</strong> When the underlying library handles mapping internally
+(e.g., Parquet.NET with no programmatic API). Return PropertyMappingConfiguration.LibraryControlled().
+</li><li>
+<strong>Adapter Pattern:</strong> Bridge between SerializedLabel and native attributes.
+Return <xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.FromAdapter%60%601" data-throw-if-not-resolved="false"></xref>.
+</li></ul>
+<p>
+<strong>Design Intent:</strong> This contract makes property mapping an explicit, discoverable
+capability rather than an implicit behavior, enabling:
+</p>
+<ul><li>Runtime introspection of mapping capabilities</li><li>Better error messages when schemas don't match storage</li><li>Documentation generation for serializer capabilities</li><li>Testing framework validation of mapping correctness</li></ul>
+
+### <a id="Flowthru_Data_Storage_Format_ExcelFormatSerializer_1_SerializeRows_System_IO_Stream_System_Collections_Generic_IAsyncEnumerable__0__"></a> SerializeRows\(Stream, IAsyncEnumerable<TRow\>\)
+
+Serializes a stream of rows into a stream of bytes.
+
+```csharp
+public Task SerializeRows(Stream stream, IAsyncEnumerable<TRow> rows)
+```
+
+#### Parameters
+
+`stream` [Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)
+
+The stream to write serialized data to
+
+`rows` [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<TRow\>
+
+The rows to serialize
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
+
+Task that completes when serialization finishes
+
+#### Remarks
+
+<p>
+<strong>Streaming Behavior:</strong>
+</p>
+<p>
+Rows should be written as they are enumerated (lazy evaluation).
+This allows handling large datasets efficiently.
+</p>
+<p>
+<strong>Format-Specific Headers:</strong>
+</p>
+<p>
+Implementations should handle format-specific initialization:
+- CSV: Write header row with column names
+- JSON: Write opening bracket for array
+- Parquet: Write schema metadata
+</p>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Serialization errors should throw exceptions:
+- Type conversion failures
+- I/O errors during stream writing
+- Invalid data values for format constraints
+</p>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Excel/Flowthru.Data.Storage.Format.md b/docs/reference/src/extensions/Flowthru.Extensions.Excel/Flowthru.Data.Storage.Format.md
new file mode 100644
index 00000000..370126dd
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Excel/Flowthru.Data.Storage.Format.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Data_Storage_Format"></a> Namespace Flowthru.Data.Storage.Format
+
+### Classes
+
+ [ExcelFormatSerializer<TRow\>](Flowthru.Data.Storage.Format.ExcelFormatSerializer\-1.md)
+
+Serializes flat schemas to/from Excel (.xlsx) files using ExcelDataReader.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Excel/Flowthru.Data.md b/docs/reference/src/extensions/Flowthru.Extensions.Excel/Flowthru.Data.md
new file mode 100644
index 00000000..7591d031
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Excel/Flowthru.Data.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Data"></a> Namespace Flowthru.Data
+
+### Classes
+
+ [ExcelItemExtensions](Flowthru.Data.ExcelItemExtensions.md)
+
+Extension methods that add Excel support to <xref href="Flowthru.Data.Items.Enumerable" data-throw-if-not-resolved="false"></xref>.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Excel/toc.yml b/docs/reference/src/extensions/Flowthru.Extensions.Excel/toc.yml
new file mode 100644
index 00000000..d0cf467a
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Excel/toc.yml
@@ -0,0 +1,13 @@
+### YamlMime:TableOfContent
+- name: Flowthru.Data
+  href: Flowthru.Data.md
+  items:
+    - name: Classes
+    - name: ExcelItemExtensions
+      href: Flowthru.Data.ExcelItemExtensions.md
+- name: Flowthru.Data.Storage.Format
+  href: Flowthru.Data.Storage.Format.md
+  items:
+    - name: Classes
+    - name: ExcelFormatSerializer<TRow>
+      href: Flowthru.Data.Storage.Format.ExcelFormatSerializer-1.md
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.CatalogEntriesMLNet.md b/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.CatalogEntriesMLNet.md
new file mode 100644
index 00000000..c720c1aa
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.CatalogEntriesMLNet.md
@@ -0,0 +1,81 @@
+# <a id="Flowthru_Extensions_MLNet_ItemsMLNet"></a> Class ItemsMLNet
+
+Namespace: [Flowthru.Extensions.MLNet](Flowthru.Extensions.MLNet.md)  
+Assembly: Flowthru.Extensions.MLNet.dll  
+
+Factory methods for creating ML.NET-related catalog entries.
+
+```csharp
+public static class ItemsMLNet
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ItemsMLNet](Flowthru.Extensions.MLNet.ItemsMLNet.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Discovery Pattern:</strong> Import this class alongside <xref href="Flowthru.Data.Items" data-throw-if-not-resolved="false"></xref>
+for ML.NET-specific catalog entry factory methods.
+</p>
+<p>
+<strong>Use Cases:</strong>
+</p>
+<ul><li>Loading pre-trained ONNX models for inference</li><li>Working with ML.NET IDataView data structures</li></ul>
+<p>
+<strong>Usage:</strong>
+</p>
+<pre><code class="lang-csharp">using Flowthru.Data;
+using Flowthru.Extensions.MLNet;
+
+// Core entries
+var csvEntry = Items.Enumerable.Csv&lt;MySchema&gt;("data", "data.csv");
+
+// MLNet entries
+var modelEntry = ItemsMLNet.OnnxModel("model", "model.onnx");</code></pre>
+
+## Methods
+
+### <a id="Flowthru_Extensions_MLNet_ItemsMLNet_OnnxModel_System_String_System_String_"></a> OnnxModel\(string, string\)
+
+Creates a catalog entry for an ONNX model file.
+
+```csharp
+public static IItem<byte[]> OnnxModel(string label, string filePath)
+```
+
+#### Parameters
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Human-readable label for the catalog entry
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to the .onnx model file
+
+#### Returns
+
+ IItem<[byte](https://learn.microsoft.com/dotnet/api/system.byte)\[\]\>
+
+A catalog entry wrapping an ONNX model storage adapter
+
+#### Examples
+
+<pre><code class="lang-csharp">var entry = ItemsMLNet.OnnxModel(
+    label: "BertModel",
+    filePath: "models/bert-base.onnx"
+);</code></pre>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.Container.DataViewContainerAdapter-1.md b/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.Container.DataViewContainerAdapter-1.md
new file mode 100644
index 00000000..d6179c00
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.Container.DataViewContainerAdapter-1.md
@@ -0,0 +1,186 @@
+# <a id="Flowthru_Extensions_MLNet_Container_DataViewContainerAdapter_1"></a> Class DataViewContainerAdapter<T\>
+
+Namespace: [Flowthru.Extensions.MLNet.Container](Flowthru.Extensions.MLNet.Container.md)  
+Assembly: Flowthru.Extensions.MLNet.dll  
+
+Container adapter for ML.NET IDataView - columnar data representation.
+
+```csharp
+public sealed class DataViewContainerAdapter<T> : IContainerAdapter<IDataView, T> where T : class, new()
+```
+
+#### Type Parameters
+
+`T` 
+
+The row schema type
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[DataViewContainerAdapter<T\>](Flowthru.Extensions.MLNet.Container.DataViewContainerAdapter\-1.md)
+
+#### Implements
+
+IContainerAdapter<IDataView, T\>
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Examples
+
+<pre><code class="lang-csharp">public record FeatureRow(
+    float Feature1,
+    float Feature2,
+    int Label
+) : IFlatSchema, ITextSerializable;
+
+var mlContext = new MLContext();
+var adapter = new DataViewContainerAdapter&lt;FeatureRow&gt;(mlContext);
+
+// From rows to IDataView
+var dataView = await adapter.FromRows(rowStream);
+
+// Use with ML.NET
+var pipeline = mlContext.Transforms
+    .NormalizeMinMax("Feature1")
+    .Append(mlContext.Transforms.NormalizeMinMax("Feature2"));
+
+var model = pipeline.Fit(dataView);
+var transformedData = model.Transform(dataView);
+
+// Back to rows
+var transformedRows = adapter.ToRows(transformedData);</code></pre>
+
+## Remarks
+
+<p>
+<strong>NEW CAPABILITY:</strong> This adapter enables native ML.NET integration with Flowthru!
+</p>
+<p>
+<strong>Characteristics:</strong>
+</p>
+<ul><li><strong>Columnar storage:</strong> Optimized for ML.NET operations</li><li><strong>Lazy evaluation:</strong> Data loaded on-demand during iteration</li><li><strong>Type safety:</strong> Strongly-typed row schema</li><li><strong>ML.NET native:</strong> Direct integration with ML.NET pipelines</li></ul>
+<p>
+<strong>Use Cases:</strong>
+</p>
+<ul><li>Machine learning pipelines using ML.NET</li><li>Data transformations (normalization, encoding, etc.)</li><li>Feature engineering workflows</li><li>Model training and evaluation</li></ul>
+<p>
+<strong>Integration with ML.Next:</strong>
+</p>
+<p>
+This adapter bridges Flowthru catalogs with ML.Next's type-safe wrappers,
+enabling end-to-end compile-time safety for ML pipelines.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Extensions_MLNet_Container_DataViewContainerAdapter_1__ctor_Microsoft_ML_MLContext_"></a> DataViewContainerAdapter\(MLContext\)
+
+Creates a new IDataView container adapter.
+
+```csharp
+public DataViewContainerAdapter(MLContext mlContext)
+```
+
+#### Parameters
+
+`mlContext` [MLContext](https://learn.microsoft.com/dotnet/api/microsoft.ml.mlcontext)
+
+The ML.NET context for data operations
+
+#### Exceptions
+
+ [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception)
+
+Thrown if mlContext is null
+
+## Properties
+
+### <a id="Flowthru_Extensions_MLNet_Container_DataViewContainerAdapter_1_MLContext"></a> MLContext
+
+Gets the ML.NET context used by this adapter.
+
+```csharp
+public MLContext MLContext { get; }
+```
+
+#### Property Value
+
+ [MLContext](https://learn.microsoft.com/dotnet/api/microsoft.ml.mlcontext)
+
+## Methods
+
+### <a id="Flowthru_Extensions_MLNet_Container_DataViewContainerAdapter_1_FromRows_System_Collections_Generic_IAsyncEnumerable__0__"></a> FromRows\(IAsyncEnumerable<T\>\)
+
+Materializes an async stream of rows into an in-memory container.
+
+```csharp
+public Task<IDataView> FromRows(IAsyncEnumerable<T> rows)
+```
+
+#### Parameters
+
+`rows` [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<T\>
+
+Async stream of rows from format deserialization
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<[IDataView](https://learn.microsoft.com/dotnet/api/microsoft.ml.idataview)\>
+
+Task producing the populated container
+
+#### Remarks
+
+<p>
+<strong>Materialization Strategy:</strong>
+</p>
+<p>
+Different containers have different materialization approaches:
+</p>
+<ul><li><strong>IEnumerable:</strong> Eager - load all rows into List</li><li><strong>Seq:</strong> Lazy - wrap async enumerable</li><li><strong>IDataView:</strong> Columnar - convert to columnar format</li></ul>
+<p>
+<strong>Memory Considerations:</strong>
+</p>
+<p>
+Be aware that eager containers (IEnumerable) will load all data into memory.
+For large datasets, prefer streaming containers (Seq, IDataView with lazy loading).
+</p>
+
+### <a id="Flowthru_Extensions_MLNet_Container_DataViewContainerAdapter_1_ToRows_Microsoft_ML_IDataView_"></a> ToRows\(IDataView\)
+
+Converts an in-memory container back to an async stream of rows.
+
+```csharp
+public IAsyncEnumerable<T> ToRows(IDataView container)
+```
+
+#### Parameters
+
+`container` [IDataView](https://learn.microsoft.com/dotnet/api/microsoft.ml.idataview)
+
+The container to stream from
+
+#### Returns
+
+ [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<T\>
+
+Async enumerable of rows for format serialization
+
+#### Remarks
+
+<p>
+<strong>Streaming Strategy:</strong>
+</p>
+<p>
+Rows should be yielded lazily if the container supports it:
+</p>
+<ul><li><strong>IEnumerable:</strong> Enumerate and yield</li><li><strong>Seq:</strong> Already lazy - expose as async enumerable</li><li><strong>IDataView:</strong> Enumerate rows from columnar format</li></ul>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.Container.md b/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.Container.md
new file mode 100644
index 00000000..9d8586f4
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.Container.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Extensions_MLNet_Container"></a> Namespace Flowthru.Extensions.MLNet.Container
+
+### Classes
+
+ [DataViewContainerAdapter<T\>](Flowthru.Extensions.MLNet.Container.DataViewContainerAdapter\-1.md)
+
+Container adapter for ML.NET IDataView - columnar data representation.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.Storage.OnnxModelStorageAdapter.md b/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.Storage.OnnxModelStorageAdapter.md
new file mode 100644
index 00000000..c0eec92b
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.Storage.OnnxModelStorageAdapter.md
@@ -0,0 +1,269 @@
+# <a id="Flowthru_Extensions_MLNet_Storage_OnnxModelStorageAdapter"></a> Class OnnxModelStorageAdapter
+
+Namespace: [Flowthru.Extensions.MLNet.Storage](Flowthru.Extensions.MLNet.Storage.md)  
+Assembly: Flowthru.Extensions.MLNet.dll  
+
+Storage adapter for ONNX model files.
+
+```csharp
+public sealed class OnnxModelStorageAdapter : IStorageAdapter<byte[]>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[OnnxModelStorageAdapter](Flowthru.Extensions.MLNet.Storage.OnnxModelStorageAdapter.md)
+
+#### Implements
+
+IStorageAdapter<byte\[\]\>
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Examples
+
+<pre><code class="lang-csharp">var adapter = new OnnxModelStorageAdapter("models/bert-base.onnx");
+var validation = await adapter.ShallowInspect().RunAsync();
+
+if (!validation.IsValid)
+{
+    Console.WriteLine($"ONNX model validation failed: {validation.ErrorMessage}");
+}</code></pre>
+
+## Remarks
+
+<p>
+<strong>Use Case:</strong> Pre-trained ONNX models for ML.NET inference
+</p>
+<p>
+<strong>Validation:</strong> Implements inspection for early pipeline validation
+</p>
+<p>
+<strong>Storage Traits:</strong>
+</p>
+<ul><li>CanWrite: false (ONNX models are read-only seed data)</li><li>Inspection: validates file before pipeline execution</li></ul>
+
+## Constructors
+
+### <a id="Flowthru_Extensions_MLNet_Storage_OnnxModelStorageAdapter__ctor_System_String_"></a> OnnxModelStorageAdapter\(string\)
+
+Creates a new ONNX model storage adapter.
+
+```csharp
+public OnnxModelStorageAdapter(string filePath)
+```
+
+#### Parameters
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to .onnx model file
+
+## Properties
+
+### <a id="Flowthru_Extensions_MLNet_Storage_OnnxModelStorageAdapter_FilePath"></a> FilePath
+
+Gets the file path to the ONNX model.
+
+```csharp
+public string FilePath { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Extensions_MLNet_Storage_OnnxModelStorageAdapter_Traits"></a> Traits
+
+Structural constraints and capabilities of this storage implementation.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ StorageTraits
+
+#### Remarks
+
+<p>
+Adapter authors must declare what their storage can and cannot do.
+These are intrinsic properties of the storage medium, not runtime state.
+</p>
+<p>
+Pipeline validation uses these traits to fail fast when a pipeline attempts
+invalid operations (e.g., writing to a read-only source).
+</p>
+
+## Methods
+
+### <a id="Flowthru_Extensions_MLNet_Storage_OnnxModelStorageAdapter_Exists"></a> Exists\(\)
+
+Checks if data exists at this storage location.
+
+```csharp
+public FlowIO<bool> Exists()
+```
+
+#### Returns
+
+ FlowIO<[bool](https://learn.microsoft.com/dotnet/api/system.boolean)\>
+
+Effect that produces true if data exists, false otherwise
+
+#### Remarks
+
+<p>
+Delegates to the underlying medium's Exists check.
+Used to determine if a catalog entry is a seed (Layer 0 input).
+</p>
+
+### <a id="Flowthru_Extensions_MLNet_Storage_OnnxModelStorageAdapter_InspectDeep"></a> InspectDeep\(\)
+
+Performs deep validation by examining the entire dataset.
+
+```csharp
+public FlowIO<ValidationResult> InspectDeep()
+```
+
+#### Returns
+
+ FlowIO<ValidationResult\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that all data is available, accessible, and valid.
+</p>
+<p>
+<strong>Additional Checks Beyond Shallow:</strong>
+</p>
+<ul><li>Validate ALL rows can be deserialized (not just sample)</li><li>Check data quality constraints across entire dataset</li><li>Detect corruption or inconsistencies throughout data</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Read and validate entire file</li><li>Memory adapters: Validate all stored data</li><li>Database adapters: Full table scan with validation</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Potentially expensive - only use when data integrity is critical.
+</p>
+
+### <a id="Flowthru_Extensions_MLNet_Storage_OnnxModelStorageAdapter_InspectShallow_System_Int32_"></a> InspectShallow\(int\)
+
+Performs shallow validation by checking data availability and sampling a subset of data.
+
+```csharp
+public FlowIO<ValidationResult> InspectShallow(int sampleSize)
+```
+
+#### Parameters
+
+`sampleSize` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of rows/records to sample for validation
+
+#### Returns
+
+ FlowIO<ValidationResult\>
+
+Effect producing validation result
+
+#### Remarks
+
+<p>
+<strong>Semantic Intent:</strong> Validate that data is available and accessible.
+</p>
+<p>
+<strong>Typical Checks:</strong>
+</p>
+<ul><li>Data source exists (file, table, etc.)</li><li>Data source is accessible (permissions, connectivity)</li><li>Sample rows can be read and deserialized successfully</li><li>Schema matches expected structure</li></ul>
+<p>
+<strong>Implementation Guidelines:</strong>
+</p>
+<ul><li>File adapters: Check file exists, read and validate sample rows</li><li>Memory adapters: Check if data has been initialized</li><li>Database adapters: Check table exists, query sample rows</li><li>Null adapters: Always return success (no data required)</li></ul>
+<p>
+<strong>Performance:</strong> Should be fast (~10-100ms) - suitable for pre-flight validation.
+</p>
+
+### <a id="Flowthru_Extensions_MLNet_Storage_OnnxModelStorageAdapter_Load"></a> Load\(\)
+
+Loads data from storage.
+
+```csharp
+public FlowIO<byte[]> Load()
+```
+
+#### Returns
+
+ FlowIO<[byte](https://learn.microsoft.com/dotnet/api/system.byte)\[\]\>
+
+Effect that produces data on success
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. medium.ReadStream()           → Stream
+2. format.DeserializeRows()      → IAsyncEnumerable&lt;TRow&gt;
+3. container.FromRows()          → TContainer</code></pre>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Errors from any layer are propagated:
+- Medium errors (file not found, access denied)
+- Format errors (parse failures, schema mismatches)
+- Container errors (memory allocation, type conversion)
+</p>
+
+### <a id="Flowthru_Extensions_MLNet_Storage_OnnxModelStorageAdapter_Save_System_Byte___"></a> Save\(byte\[\]\)
+
+Saves data to storage.
+
+```csharp
+public FlowIO<FlowUnit> Save(byte[] data)
+```
+
+#### Parameters
+
+`data` [byte](https://learn.microsoft.com/dotnet/api/system.byte)\[\]
+
+The data to save
+
+#### Returns
+
+ FlowIO<FlowUnit\>
+
+Effect that completes on successful save
+
+#### Remarks
+
+<p>
+<strong>Execution Flow:</strong>
+</p>
+<p>
+For composed adapters, this orchestrates:
+</p>
+<pre><code class="lang-csharp">1. container.ToRows()            → IAsyncEnumerable&lt;TRow&gt;
+2. format.SerializeRows()        → Stream
+3. medium.WriteStream()          → FlowUnit</code></pre>
+<p>
+<strong>Atomicity:</strong>
+</p>
+<p>
+Implementations should strive for atomic saves to avoid partial writes on failure.
+</p>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.Storage.md b/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.Storage.md
new file mode 100644
index 00000000..714f88a3
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.Storage.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Extensions_MLNet_Storage"></a> Namespace Flowthru.Extensions.MLNet.Storage
+
+### Classes
+
+ [OnnxModelStorageAdapter](Flowthru.Extensions.MLNet.Storage.OnnxModelStorageAdapter.md)
+
+Storage adapter for ONNX model files.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.md b/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.md
new file mode 100644
index 00000000..3e8689ea
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.MLNet/Flowthru.Extensions.MLNet.md
@@ -0,0 +1,14 @@
+# <a id="Flowthru_Extensions_MLNet"></a> Namespace Flowthru.Extensions.MLNet
+
+### Namespaces
+
+ [Flowthru.Extensions.MLNet.Container](Flowthru.Extensions.MLNet.Container.md)
+
+ [Flowthru.Extensions.MLNet.Storage](Flowthru.Extensions.MLNet.Storage.md)
+
+### Classes
+
+ [ItemsMLNet](Flowthru.Extensions.MLNet.ItemsMLNet.md)
+
+Factory methods for creating ML.NET-related catalog entries.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.MLNet/toc.yml b/docs/reference/src/extensions/Flowthru.Extensions.MLNet/toc.yml
new file mode 100644
index 00000000..01a9389e
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.MLNet/toc.yml
@@ -0,0 +1,19 @@
+### YamlMime:TableOfContent
+- name: Flowthru.Extensions.MLNet
+  href: Flowthru.Extensions.MLNet.md
+  items:
+    - name: Classes
+    - name: ItemsMLNet
+      href: Flowthru.Extensions.MLNet.ItemsMLNet.md
+- name: Flowthru.Extensions.MLNet.Container
+  href: Flowthru.Extensions.MLNet.Container.md
+  items:
+    - name: Classes
+    - name: DataViewContainerAdapter<T>
+      href: Flowthru.Extensions.MLNet.Container.DataViewContainerAdapter-1.md
+- name: Flowthru.Extensions.MLNet.Storage
+  href: Flowthru.Extensions.MLNet.Storage.md
+  items:
+    - name: Classes
+    - name: OnnxModelStorageAdapter
+      href: Flowthru.Extensions.MLNet.Storage.OnnxModelStorageAdapter.md
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Parquet/Flowthru.Data.ParquetCatalogEntryExtensions.md b/docs/reference/src/extensions/Flowthru.Extensions.Parquet/Flowthru.Data.ParquetCatalogEntryExtensions.md
new file mode 100644
index 00000000..12870d08
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Parquet/Flowthru.Data.ParquetCatalogEntryExtensions.md
@@ -0,0 +1,72 @@
+# <a id="Flowthru_Data_ParquetItemExtensions"></a> Class ParquetItemExtensions
+
+Namespace: [Flowthru.Data](Flowthru.Data.md)  
+Assembly: Flowthru.Extensions.Parquet.dll  
+
+Extension methods that add Parquet support to <xref href="Flowthru.Data.Items.Enumerable" data-throw-if-not-resolved="false"></xref>.
+
+```csharp
+public static class ParquetItemExtensions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ParquetItemExtensions](Flowthru.Data.ParquetItemExtensions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Flowthru_Data_ParquetItemExtensions_Parquet__1_Flowthru_Data_EnumerableItems_System_String_System_String_"></a> Parquet<TRow\>\(EnumerableItems, string, string\)
+
+Creates a Parquet file catalog entry with IEnumerable container.
+
+```csharp
+public static Item<IEnumerable<TRow>> Parquet<TRow>(this EnumerableItems _, string label, string filePath) where TRow : notnull, IFlatSchema, IBinarySerializable
+```
+
+#### Parameters
+
+`_` EnumerableItems
+
+The enumerable catalog entries factory (from <xref href="Flowthru.Data.Items.Enumerable" data-throw-if-not-resolved="false"></xref>)
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique catalog label for DAG resolution
+
+`filePath` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Path to Parquet file
+
+#### Returns
+
+ Item<[IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<TRow\>\>
+
+Catalog entry with file + Parquet + IEnumerable composition
+
+#### Type Parameters
+
+`TRow` 
+
+Row schema type (must be flat and binary-serializable)
+
+#### Remarks
+
+<p>
+<strong>Requirements:</strong>
+</p>
+<ul><li>TRow must implement IFlatSchema (Parquet is columnar)</li><li>TRow must implement IBinarySerializable</li></ul>
+<p>
+<strong>Performance:</strong> Optimized for large datasets with columnar storage.
+</p>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Parquet/Flowthru.Data.Storage.Format.ParquetFormatSerializer-1.md b/docs/reference/src/extensions/Flowthru.Extensions.Parquet/Flowthru.Data.Storage.Format.ParquetFormatSerializer-1.md
new file mode 100644
index 00000000..55c24f84
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Parquet/Flowthru.Data.Storage.Format.ParquetFormatSerializer-1.md
@@ -0,0 +1,240 @@
+# <a id="Flowthru_Data_Storage_Format_ParquetFormatSerializer_1"></a> Class ParquetFormatSerializer<TRow\>
+
+Namespace: [Flowthru.Data.Storage.Format](Flowthru.Data.Storage.Format.md)  
+Assembly: Flowthru.Extensions.Parquet.dll  
+
+Format serializer for Parquet (columnar storage) files using adapter pattern.
+
+```csharp
+public sealed class ParquetFormatSerializer<TRow> : IFormatSerializer<TRow> where TRow : notnull, IFlatSchema, IBinarySerializable
+```
+
+#### Type Parameters
+
+`TRow` 
+
+The Flowthru schema type
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ParquetFormatSerializer<TRow\>](Flowthru.Data.Storage.Format.ParquetFormatSerializer\-1.md)
+
+#### Implements
+
+IFormatSerializer<TRow\>
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Architecture:</strong>
+</p>
+<p>
+Converts between Flowthru schemas (with required members) and Parquet-compatible DTOs:
+</p>
+<pre><code class="lang-csharp">Serialize:   TRow (required members) → DTO (parameterless ctor) → Parquet
+Deserialize: Parquet → DTO (parameterless ctor) → TRow (required members)</code></pre>
+<p>
+<strong>Features:</strong>
+</p>
+<ul><li>SerializedLabel - Respects [SerializedLabel] attributes for property name mapping</li><li>Null Safety - Enforces non-nullable contracts during deserialization</li><li>Value Type Nullability - DTOs use nullable value types to match Parquet schema conventions</li><li>Enum Support - Automatically converts between Parquet's integer storage and enum types</li></ul>
+<p>
+<strong>Current Limitations:</strong>
+</p>
+<ul><li>SerializedEnum attributes are not used - enums stored/retrieved by underlying integer value</li></ul>
+
+## Constructors
+
+### <a id="Flowthru_Data_Storage_Format_ParquetFormatSerializer_1__ctor"></a> ParquetFormatSerializer\(\)
+
+```csharp
+public ParquetFormatSerializer()
+```
+
+## Properties
+
+### <a id="Flowthru_Data_Storage_Format_ParquetFormatSerializer_1_Traits"></a> Traits
+
+Structural capabilities of this format serializer.
+
+```csharp
+public StorageTraits Traits { get; }
+```
+
+#### Property Value
+
+ StorageTraits
+
+#### Remarks
+
+<p>
+Format traits focus on HOW data is serialized and whether it supports streaming.
+For composed adapters, these traits are merged with medium and container traits.
+</p>
+<p>
+Most formats should declare <code>CanStream = true</code> if they can deserialize row-by-row
+without buffering the entire stream (e.g., CSV, JSONL). Formats that require full
+parsing before yielding rows (e.g., JSON arrays) should set <code>CanStream = false</code>.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Data_Storage_Format_ParquetFormatSerializer_1_DeserializeRows_System_IO_Stream_"></a> DeserializeRows\(Stream\)
+
+Deserializes a stream of bytes into a stream of rows.
+
+```csharp
+public IAsyncEnumerable<TRow> DeserializeRows(Stream stream)
+```
+
+#### Parameters
+
+`stream` [Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)
+
+The stream containing serialized data
+
+#### Returns
+
+ [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<TRow\>
+
+Async enumerable of deserialized rows
+
+#### Remarks
+
+<p>
+<strong>Streaming Behavior:</strong>
+</p>
+<p>
+Rows should be yielded as they are deserialized (lazy evaluation).
+This allows processing large datasets without loading everything into memory.
+</p>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Deserialization errors should throw exceptions:
+- Format exceptions (malformed CSV, invalid JSON)
+- Schema mismatches (missing columns, type conversion failures)
+- I/O errors during stream reading
+</p>
+<p>
+The caller should handle these exceptions appropriately.
+</p>
+
+### <a id="Flowthru_Data_Storage_Format_ParquetFormatSerializer_1_GetPropertyMappingConfiguration"></a> GetPropertyMappingConfiguration\(\)
+
+Configures how this serializer handles property-to-field name mapping for the schema.
+
+```csharp
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+```
+
+#### Returns
+
+ PropertyMappingConfiguration
+
+Property mapping configuration describing the mapping strategy
+
+#### Examples
+
+<pre><code class="lang-csharp">// CSV serializer using SerializedLabel
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+    =&gt; PropertyMappingConfiguration.FromSerializedLabel&lt;TRow&gt;();
+
+// ML.NET serializer using native attributes
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+    =&gt; PropertyMappingConfiguration.FromNativeAttributes("LoadColumnAttribute");
+
+// Parquet with library-controlled mapping
+public PropertyMappingConfiguration GetPropertyMappingConfiguration()
+    =&gt; PropertyMappingConfiguration.LibraryControlled();</code></pre>
+
+#### Remarks
+
+<p>
+<strong>Contractual Obligation:</strong> Every format serializer MUST implement this method
+to explicitly declare how it handles property name mapping.
+</p>
+<p>
+<strong>Implementation Strategies:</strong>
+</p>
+<ul><li>
+<strong>SerializedLabel Support:</strong> Use <xref href="Flowthru.Data.Storage.Format.PropertyMappingHelper" data-throw-if-not-resolved="false"></xref>
+to respect [SerializedLabel] attributes. Return <xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.FromSerializedLabel%60%601" data-throw-if-not-resolved="false"></xref>.
+</li><li>
+<strong>Native Attribute Mapping:</strong> Use format-specific attributes (e.g., ML.NET's [LoadColumn]).
+Return <xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.FromNativeAttributes(System.String)" data-throw-if-not-resolved="false"></xref> with the attribute type name.
+</li><li>
+<strong>Library-Controlled:</strong> When the underlying library handles mapping internally
+(e.g., Parquet.NET with no programmatic API). Return PropertyMappingConfiguration.LibraryControlled().
+</li><li>
+<strong>Adapter Pattern:</strong> Bridge between SerializedLabel and native attributes.
+Return <xref href="Flowthru.Data.Storage.PropertyMappingConfiguration.FromAdapter%60%601" data-throw-if-not-resolved="false"></xref>.
+</li></ul>
+<p>
+<strong>Design Intent:</strong> This contract makes property mapping an explicit, discoverable
+capability rather than an implicit behavior, enabling:
+</p>
+<ul><li>Runtime introspection of mapping capabilities</li><li>Better error messages when schemas don't match storage</li><li>Documentation generation for serializer capabilities</li><li>Testing framework validation of mapping correctness</li></ul>
+
+### <a id="Flowthru_Data_Storage_Format_ParquetFormatSerializer_1_SerializeRows_System_IO_Stream_System_Collections_Generic_IAsyncEnumerable__0__"></a> SerializeRows\(Stream, IAsyncEnumerable<TRow\>\)
+
+Serializes a stream of rows into a stream of bytes.
+
+```csharp
+public Task SerializeRows(Stream stream, IAsyncEnumerable<TRow> rows)
+```
+
+#### Parameters
+
+`stream` [Stream](https://learn.microsoft.com/dotnet/api/system.io.stream)
+
+The stream to write serialized data to
+
+`rows` [IAsyncEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.iasyncenumerable\-1)<TRow\>
+
+The rows to serialize
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
+
+Task that completes when serialization finishes
+
+#### Remarks
+
+<p>
+<strong>Streaming Behavior:</strong>
+</p>
+<p>
+Rows should be written as they are enumerated (lazy evaluation).
+This allows handling large datasets efficiently.
+</p>
+<p>
+<strong>Format-Specific Headers:</strong>
+</p>
+<p>
+Implementations should handle format-specific initialization:
+- CSV: Write header row with column names
+- JSON: Write opening bracket for array
+- Parquet: Write schema metadata
+</p>
+<p>
+<strong>Error Handling:</strong>
+</p>
+<p>
+Serialization errors should throw exceptions:
+- Type conversion failures
+- I/O errors during stream writing
+- Invalid data values for format constraints
+</p>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Parquet/Flowthru.Data.Storage.Format.md b/docs/reference/src/extensions/Flowthru.Extensions.Parquet/Flowthru.Data.Storage.Format.md
new file mode 100644
index 00000000..51f0052a
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Parquet/Flowthru.Data.Storage.Format.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Data_Storage_Format"></a> Namespace Flowthru.Data.Storage.Format
+
+### Classes
+
+ [ParquetFormatSerializer<TRow\>](Flowthru.Data.Storage.Format.ParquetFormatSerializer\-1.md)
+
+Format serializer for Parquet (columnar storage) files using adapter pattern.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Parquet/Flowthru.Data.md b/docs/reference/src/extensions/Flowthru.Extensions.Parquet/Flowthru.Data.md
new file mode 100644
index 00000000..a06fc12a
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Parquet/Flowthru.Data.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Data"></a> Namespace Flowthru.Data
+
+### Classes
+
+ [ParquetItemExtensions](Flowthru.Data.ParquetItemExtensions.md)
+
+Extension methods that add Parquet support to <xref href="Flowthru.Data.Items.Enumerable" data-throw-if-not-resolved="false"></xref>.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Parquet/toc.yml b/docs/reference/src/extensions/Flowthru.Extensions.Parquet/toc.yml
new file mode 100644
index 00000000..1d1a585e
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Parquet/toc.yml
@@ -0,0 +1,13 @@
+### YamlMime:TableOfContent
+- name: Flowthru.Data
+  href: Flowthru.Data.md
+  items:
+    - name: Classes
+    - name: ParquetItemExtensions
+      href: Flowthru.Data.ParquetItemExtensions.md
+- name: Flowthru.Data.Storage.Format
+  href: Flowthru.Data.Storage.Format.md
+  items:
+    - name: Classes
+    - name: ParquetFormatSerializer<TRow>
+      href: Flowthru.Data.Storage.Format.ParquetFormatSerializer-1.md
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Build.PythonSchemaExportTask.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Build.PythonSchemaExportTask.md
new file mode 100644
index 00000000..4ff5ba42
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Build.PythonSchemaExportTask.md
@@ -0,0 +1,100 @@
+# <a id="Flowthru_Extensions_Python_Build_PythonSchemaExportTask"></a> Class PythonSchemaExportTask
+
+Namespace: [Flowthru.Extensions.Python.Build](Flowthru.Extensions.Python.Build.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+MSBuild task that exports C# schema metadata to Python schema files.
+
+```csharp
+public class PythonSchemaExportTask : Task, ITask
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[Task](https://learn.microsoft.com/dotnet/api/microsoft.build.utilities.task) ← 
+[PythonSchemaExportTask](Flowthru.Extensions.Python.Build.PythonSchemaExportTask.md)
+
+#### Implements
+
+[ITask](https://learn.microsoft.com/dotnet/api/microsoft.build.framework.itask)
+
+#### Inherited Members
+
+[Task.Execute\(\)](https://learn.microsoft.com/dotnet/api/microsoft.build.utilities.task.execute), 
+[Task.BuildEngine](https://learn.microsoft.com/dotnet/api/microsoft.build.utilities.task.buildengine), 
+[Task.BuildEngine2](https://learn.microsoft.com/dotnet/api/microsoft.build.utilities.task.buildengine2), 
+[Task.BuildEngine3](https://learn.microsoft.com/dotnet/api/microsoft.build.utilities.task.buildengine3), 
+[Task.BuildEngine4](https://learn.microsoft.com/dotnet/api/microsoft.build.utilities.task.buildengine4), 
+[Task.BuildEngine5](https://learn.microsoft.com/dotnet/api/microsoft.build.utilities.task.buildengine5), 
+[Task.BuildEngine6](https://learn.microsoft.com/dotnet/api/microsoft.build.utilities.task.buildengine6), 
+[Task.BuildEngine7](https://learn.microsoft.com/dotnet/api/microsoft.build.utilities.task.buildengine7), 
+[Task.BuildEngine8](https://learn.microsoft.com/dotnet/api/microsoft.build.utilities.task.buildengine8), 
+[Task.BuildEngine9](https://learn.microsoft.com/dotnet/api/microsoft.build.utilities.task.buildengine9), 
+[Task.HostObject](https://learn.microsoft.com/dotnet/api/microsoft.build.utilities.task.hostobject), 
+[Task.Log](https://learn.microsoft.com/dotnet/api/microsoft.build.utilities.task.log), 
+[Task.TaskResources](https://learn.microsoft.com/dotnet/api/microsoft.build.utilities.task.taskresources), 
+[Task.HelpKeywordPrefix](https://learn.microsoft.com/dotnet/api/microsoft.build.utilities.task.helpkeywordprefix), 
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Phase 5 implementation:</strong>
+Reads the SchemaManifest generated by SchemaInterfaceGenerator and emits
+corresponding Python dataclass files to _generated/flowthru_schemas/.
+</p>
+<p>
+<strong>Invoked from:</strong> Flowthru.Extensions.Python.targets AfterBuild
+</p>
+
+## Properties
+
+### <a id="Flowthru_Extensions_Python_Build_PythonSchemaExportTask_AssemblyPath"></a> AssemblyPath
+
+Path to the compiled assembly containing the schema manifest.
+
+```csharp
+[Required]
+public string AssemblyPath { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Extensions_Python_Build_PythonSchemaExportTask_OutputDirectory"></a> OutputDirectory
+
+Directory where Python schema files will be generated.
+
+```csharp
+[Required]
+public string OutputDirectory { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Build_PythonSchemaExportTask_Execute"></a> Execute\(\)
+
+Must be implemented by derived class.
+
+```csharp
+public override bool Execute()
+```
+
+#### Returns
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+true, if successful
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Build.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Build.md
new file mode 100644
index 00000000..ba8792f4
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Build.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Extensions_Python_Build"></a> Namespace Flowthru.Extensions.Python.Build
+
+### Classes
+
+ [PythonSchemaExportTask](Flowthru.Extensions.Python.Build.PythonSchemaExportTask.md)
+
+MSBuild task that exports C# schema metadata to Python schema files.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Execution.IPythonExecutor.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Execution.IPythonExecutor.md
new file mode 100644
index 00000000..e16b9b2a
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Execution.IPythonExecutor.md
@@ -0,0 +1,103 @@
+# <a id="Flowthru_Extensions_Python_Execution_IPythonExecutor"></a> Interface IPythonExecutor
+
+Namespace: [Flowthru.Extensions.Python.Execution](Flowthru.Extensions.Python.Execution.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+Abstraction for executing Python code.
+
+```csharp
+public interface IPythonExecutor
+```
+
+## Remarks
+
+<p>
+Decouples the execution strategy from Python step wiring.
+Two implementations ship out of the box:
+<ul><li><xref href="Flowthru.Extensions.Python.Execution.PythonNetExecutor" data-throw-if-not-resolved="false"></xref> — in-process via Python.NET (opt-in)</li><li><xref href="Flowthru.Extensions.Python.Execution.SubprocessPythonExecutor" data-throw-if-not-resolved="false"></xref> — isolated child process per service (default)</li></ul>
+</p>
+<p>
+<strong>Isolation contract:</strong>
+Two FlowthruServices using <xref href="Flowthru.Extensions.Python.Execution.SubprocessPythonExecutor" data-throw-if-not-resolved="false"></xref> do not share Python state.
+Each executor spawns its own Python worker process with its own venv, <code>sys.path</code>,
+<code>sys.modules</code>, and GIL — complete isolation at the cost of IPC marshalling overhead.
+</p>
+<p>
+All implementations must handle:
+<ul><li>Module import and caching</li><li>Function resolution and invocation</li><li>Argument marshalling (C# ↔ Python) — scalar, tabular (Arrow IPC), and raw bytes</li><li>Error propagation (Python exceptions → <xref href="System.InvalidOperationException" data-throw-if-not-resolved="false"></xref>)</li></ul>
+</p>
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Execution_IPythonExecutor_Invoke__2_System_String_System_String___0_"></a> Invoke<TInput, TOutput\>\(string, string, TInput\)
+
+Invokes a Python function, marshalling input and output to/from C# types.
+
+```csharp
+TOutput Invoke<TInput, TOutput>(string moduleName, string functionName, TInput input)
+```
+
+#### Parameters
+
+`moduleName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted module name (e.g., <code>"Flows.DataScience.train_model"</code>).
+Must be resolvable via the executor's configured <code>sys.path</code>.
+
+`functionName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module.
+
+`input` TInput
+
+Typed input value.
+
+#### Returns
+
+ TOutput
+
+Typed output value returned by the Python function.
+
+#### Type Parameters
+
+`TInput` 
+
+C# input type. May be a scalar, <code>IEnumerable&lt;TSchema&gt;</code> (tabular),
+<code>byte[]</code> (raw bytes), or a <code>ValueTuple</code> of any of those (multi-input).
+
+`TOutput` 
+
+C# output type. Same range as <code class="typeparamref">TInput</code>.
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if the module cannot be imported, the function cannot be resolved,
+or marshalling fails.
+
+### <a id="Flowthru_Extensions_Python_Execution_IPythonExecutor_ValidateStep_System_String_System_String_"></a> ValidateStep\(string, string\)
+
+Validates that a Python step exists and satisfies Flowthru's <code>@step</code> contract.
+
+```csharp
+void ValidateStep(string moduleName, string functionName)
+```
+
+#### Parameters
+
+`moduleName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name.
+
+`functionName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module.
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if the module is not importable, the function is missing, or the
+<code>@step</code> decorator is absent.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Execution.PythonNetExecutor.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Execution.PythonNetExecutor.md
new file mode 100644
index 00000000..7acc36d8
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Execution.PythonNetExecutor.md
@@ -0,0 +1,134 @@
+# <a id="Flowthru_Extensions_Python_Execution_PythonNetExecutor"></a> Class PythonNetExecutor
+
+Namespace: [Flowthru.Extensions.Python.Execution](Flowthru.Extensions.Python.Execution.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+In-process Python executor using Python.NET.
+
+```csharp
+public sealed class PythonNetExecutor : IPythonExecutor
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PythonNetExecutor](Flowthru.Extensions.Python.Execution.PythonNetExecutor.md)
+
+#### Implements
+
+[IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+Executes Python functions within the same process via Python.NET's embedded runtime.
+All marshalling (scalar, tabular Arrow IPC, bytes, multi-I/O tuples) is handled
+internally — callers interact only with strongly-typed C# values.
+</p>
+<p>
+<strong>Isolation caveat:</strong>
+<code>PythonEngine</code> is process-global. Multiple <code>PythonNetExecutor</code> instances share
+the same interpreter, <code>sys.modules</code>, and GIL. Use <xref href="Flowthru.Extensions.Python.Execution.SubprocessPythonExecutor" data-throw-if-not-resolved="false"></xref>
+when true per-service isolation is required.
+</p>
+<p>
+Thread-safety: GIL acquisition serialises all Python execution.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Extensions_Python_Execution_PythonNetExecutor__ctor_Flowthru_Extensions_Python_Runtime_PythonRuntime_Microsoft_Extensions_Logging_ILogger_Flowthru_Extensions_Python_Execution_PythonNetExecutor__"></a> PythonNetExecutor\(PythonRuntime, ILogger<PythonNetExecutor\>\)
+
+```csharp
+public PythonNetExecutor(PythonRuntime runtime, ILogger<PythonNetExecutor> logger)
+```
+
+#### Parameters
+
+`runtime` [PythonRuntime](Flowthru.Extensions.Python.Runtime.PythonRuntime.md)
+
+`logger` [ILogger](https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger\-1)<[PythonNetExecutor](Flowthru.Extensions.Python.Execution.PythonNetExecutor.md)\>
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Execution_PythonNetExecutor_Invoke__2_System_String_System_String___0_"></a> Invoke<TInput, TOutput\>\(string, string, TInput\)
+
+Invokes a Python function, marshalling input and output to/from C# types.
+
+```csharp
+public TOutput Invoke<TInput, TOutput>(string moduleName, string functionName, TInput input)
+```
+
+#### Parameters
+
+`moduleName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted module name (e.g., <code>"Flows.DataScience.train_model"</code>).
+Must be resolvable via the executor's configured <code>sys.path</code>.
+
+`functionName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module.
+
+`input` TInput
+
+Typed input value.
+
+#### Returns
+
+ TOutput
+
+Typed output value returned by the Python function.
+
+#### Type Parameters
+
+`TInput` 
+
+C# input type. May be a scalar, <code>IEnumerable&lt;TSchema&gt;</code> (tabular),
+<code>byte[]</code> (raw bytes), or a <code>ValueTuple</code> of any of those (multi-input).
+
+`TOutput` 
+
+C# output type. Same range as <code class="typeparamref">TInput</code>.
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if the module cannot be imported, the function cannot be resolved,
+or marshalling fails.
+
+### <a id="Flowthru_Extensions_Python_Execution_PythonNetExecutor_ValidateStep_System_String_System_String_"></a> ValidateStep\(string, string\)
+
+Validates that a Python step exists and satisfies Flowthru's <code>@step</code> contract.
+
+```csharp
+public void ValidateStep(string moduleName, string functionName)
+```
+
+#### Parameters
+
+`moduleName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name.
+
+`functionName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module.
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if the module is not importable, the function is missing, or the
+<code>@step</code> decorator is absent.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Execution.SubprocessPythonExecutor.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Execution.SubprocessPythonExecutor.md
new file mode 100644
index 00000000..73fd5dd8
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Execution.SubprocessPythonExecutor.md
@@ -0,0 +1,143 @@
+# <a id="Flowthru_Extensions_Python_Execution_SubprocessPythonExecutor"></a> Class SubprocessPythonExecutor
+
+Namespace: [Flowthru.Extensions.Python.Execution](Flowthru.Extensions.Python.Execution.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+Subprocess Python executor — spawns an isolated Python worker process per instance.
+
+```csharp
+public sealed class SubprocessPythonExecutor : IPythonExecutor, IDisposable
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[SubprocessPythonExecutor](Flowthru.Extensions.Python.Execution.SubprocessPythonExecutor.md)
+
+#### Implements
+
+[IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md), 
+[IDisposable](https://learn.microsoft.com/dotnet/api/system.idisposable)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+Each <code>SubprocessPythonExecutor</code> owns one child Python process. Isolation is at the
+OS process boundary: separate interpreter, <code>sys.modules</code>, venv, and memory space.
+No Python.NET, no GIL management on the C# side.
+</p>
+<p>
+<strong>Protocol:</strong> newline-delimited JSON over stdin/stdout.
+Tabular data is exchanged as base64-encoded Apache Arrow IPC buffers.
+Dtype coercion specs are serialized from <xref href="Flowthru.Extensions.Python.Marshalling.ArrowSchemaMapper.BuildDtypeSpecDictionary%60%601" data-throw-if-not-resolved="false"></xref>.
+</p>
+<p>
+The worker script (<code>flowthru_worker.py</code>) must be present in
+<xref href="System.AppContext.BaseDirectory" data-throw-if-not-resolved="false"></xref>.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Extensions_Python_Execution_SubprocessPythonExecutor__ctor_Flowthru_Extensions_Python_Runtime_PythonRuntimeOptions_Microsoft_Extensions_Logging_ILogger_Flowthru_Extensions_Python_Execution_SubprocessPythonExecutor__"></a> SubprocessPythonExecutor\(PythonRuntimeOptions, ILogger<SubprocessPythonExecutor\>\)
+
+```csharp
+public SubprocessPythonExecutor(PythonRuntimeOptions options, ILogger<SubprocessPythonExecutor> logger)
+```
+
+#### Parameters
+
+`options` [PythonRuntimeOptions](Flowthru.Extensions.Python.Runtime.PythonRuntimeOptions.md)
+
+`logger` [ILogger](https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger\-1)<[SubprocessPythonExecutor](Flowthru.Extensions.Python.Execution.SubprocessPythonExecutor.md)\>
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Execution_SubprocessPythonExecutor_Dispose"></a> Dispose\(\)
+
+Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
+
+```csharp
+public void Dispose()
+```
+
+### <a id="Flowthru_Extensions_Python_Execution_SubprocessPythonExecutor_Invoke__2_System_String_System_String___0_"></a> Invoke<TInput, TOutput\>\(string, string, TInput\)
+
+Invokes a Python function, marshalling input and output to/from C# types.
+
+```csharp
+public TOutput Invoke<TInput, TOutput>(string moduleName, string functionName, TInput input)
+```
+
+#### Parameters
+
+`moduleName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted module name (e.g., <code>"Flows.DataScience.train_model"</code>).
+Must be resolvable via the executor's configured <code>sys.path</code>.
+
+`functionName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module.
+
+`input` TInput
+
+Typed input value.
+
+#### Returns
+
+ TOutput
+
+Typed output value returned by the Python function.
+
+#### Type Parameters
+
+`TInput` 
+
+C# input type. May be a scalar, <code>IEnumerable&lt;TSchema&gt;</code> (tabular),
+<code>byte[]</code> (raw bytes), or a <code>ValueTuple</code> of any of those (multi-input).
+
+`TOutput` 
+
+C# output type. Same range as <code class="typeparamref">TInput</code>.
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if the module cannot be imported, the function cannot be resolved,
+or marshalling fails.
+
+### <a id="Flowthru_Extensions_Python_Execution_SubprocessPythonExecutor_ValidateStep_System_String_System_String_"></a> ValidateStep\(string, string\)
+
+Validates that a Python step exists and satisfies Flowthru's <code>@step</code> contract.
+
+```csharp
+public void ValidateStep(string moduleName, string functionName)
+```
+
+#### Parameters
+
+`moduleName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name.
+
+`functionName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module.
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if the module is not importable, the function is missing, or the
+<code>@step</code> decorator is absent.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Execution.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Execution.md
new file mode 100644
index 00000000..37635f40
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Execution.md
@@ -0,0 +1,18 @@
+# <a id="Flowthru_Extensions_Python_Execution"></a> Namespace Flowthru.Extensions.Python.Execution
+
+### Classes
+
+ [PythonNetExecutor](Flowthru.Extensions.Python.Execution.PythonNetExecutor.md)
+
+In-process Python executor using Python.NET.
+
+ [SubprocessPythonExecutor](Flowthru.Extensions.Python.Execution.SubprocessPythonExecutor.md)
+
+Subprocess Python executor — spawns an isolated Python worker process per instance.
+
+### Interfaces
+
+ [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Abstraction for executing Python code.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Marshalling.ArrowMarshaller.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Marshalling.ArrowMarshaller.md
new file mode 100644
index 00000000..0d1fef2c
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Marshalling.ArrowMarshaller.md
@@ -0,0 +1,185 @@
+# <a id="Flowthru_Extensions_Python_Marshalling_ArrowMarshaller"></a> Class ArrowMarshaller
+
+Namespace: [Flowthru.Extensions.Python.Marshalling](Flowthru.Extensions.Python.Marshalling.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+Marshals tabular data between C# IEnumerable&lt;T&gt; and Apache Arrow RecordBatch.
+
+```csharp
+public static class ArrowMarshaller
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ArrowMarshaller](Flowthru.Extensions.Python.Marshalling.ArrowMarshaller.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Purpose:</strong> Bidirectional conversion for DataFrame interchange between
+C# and Python via Arrow IPC (Inter-Process Communication) format.
+</p>
+<p>
+<strong>C# → Arrow Flow:</strong>
+</p>
+<pre><code class="lang-csharp">IEnumerable&lt;T&gt; → RecordBatch → IPC buffer → Python pyarrow.Table → pd.DataFrame</code></pre>
+<p>
+<strong>Arrow → C# Flow:</strong>
+</p>
+<pre><code class="lang-csharp">pd.DataFrame → pyarrow.Table → IPC buffer → RecordBatch → IEnumerable&lt;T&gt;</code></pre>
+<p>
+<strong>Performance:</strong> Uses columnar processing (column-by-column, not row-by-row)
+for efficient Arrow array construction.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Marshalling_ArrowMarshaller_FromIpcBuffer_System_Byte___"></a> FromIpcBuffer\(byte\[\]\)
+
+Deserializes an Arrow IPC buffer (from Python) to a RecordBatch.
+
+```csharp
+public static RecordBatch FromIpcBuffer(byte[] buffer)
+```
+
+#### Parameters
+
+`buffer` [byte](https://learn.microsoft.com/dotnet/api/system.byte)\[\]
+
+Byte array containing Arrow IPC stream
+
+#### Returns
+
+ RecordBatch
+
+Arrow RecordBatch
+
+#### Exceptions
+
+ [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception)
+
+Thrown when buffer is null
+
+ [InvalidDataException](https://learn.microsoft.com/dotnet/api/system.io.invaliddataexception)
+
+Thrown when buffer is not a valid Arrow IPC stream.
+
+### <a id="Flowthru_Extensions_Python_Marshalling_ArrowMarshaller_FromRecordBatch__1_Apache_Arrow_RecordBatch_"></a> FromRecordBatch<T\>\(RecordBatch\)
+
+Converts an Arrow RecordBatch to an IEnumerable of C# objects.
+
+```csharp
+public static IEnumerable<T> FromRecordBatch<T>(RecordBatch batch) where T : notnull
+```
+
+#### Parameters
+
+`batch` RecordBatch
+
+The Arrow RecordBatch to convert
+
+#### Returns
+
+ [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>
+
+IEnumerable of C# objects
+
+#### Type Parameters
+
+`T` 
+
+The C# schema type
+
+#### Remarks
+
+Uses SchemaActivator for instantiation to support required members.
+Data is converted row-by-row (column values → object properties).
+
+#### Exceptions
+
+ [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception)
+
+Thrown when batch is null
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown when schema mismatch or type conversion fails.
+
+### <a id="Flowthru_Extensions_Python_Marshalling_ArrowMarshaller_ToIpcBuffer_Apache_Arrow_RecordBatch_"></a> ToIpcBuffer\(RecordBatch\)
+
+Serializes an Arrow RecordBatch to an IPC buffer for Python.NET transfer.
+
+```csharp
+public static byte[] ToIpcBuffer(RecordBatch batch)
+```
+
+#### Parameters
+
+`batch` RecordBatch
+
+The RecordBatch to serialize
+
+#### Returns
+
+ [byte](https://learn.microsoft.com/dotnet/api/system.byte)\[\]
+
+Byte array containing Arrow IPC stream
+
+#### Exceptions
+
+ [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception)
+
+Thrown when batch is null
+
+### <a id="Flowthru_Extensions_Python_Marshalling_ArrowMarshaller_ToRecordBatch__1_System_Collections_Generic_IEnumerable___0__"></a> ToRecordBatch<T\>\(IEnumerable<T\>\)
+
+Converts an IEnumerable of C# objects to an Arrow RecordBatch.
+
+```csharp
+public static RecordBatch ToRecordBatch<T>(IEnumerable<T> rows) where T : notnull
+```
+
+#### Parameters
+
+`rows` [IEnumerable](https://learn.microsoft.com/dotnet/api/system.collections.generic.ienumerable\-1)<T\>
+
+The rows to convert
+
+#### Returns
+
+ RecordBatch
+
+Arrow RecordBatch containing the data
+
+#### Type Parameters
+
+`T` 
+
+The C# schema type
+
+#### Remarks
+
+Data is processed column-wise for efficiency. All rows are materialized into memory
+to build the RecordBatch.
+
+#### Exceptions
+
+ [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception)
+
+Thrown when rows is null
+
+ [NotSupportedException](https://learn.microsoft.com/dotnet/api/system.notsupportedexception)
+
+Thrown when a property type cannot be marshalled to Arrow.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Marshalling.ArrowSchemaMapper.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Marshalling.ArrowSchemaMapper.md
new file mode 100644
index 00000000..b3757bdb
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Marshalling.ArrowSchemaMapper.md
@@ -0,0 +1,151 @@
+# <a id="Flowthru_Extensions_Python_Marshalling_ArrowSchemaMapper"></a> Class ArrowSchemaMapper
+
+Namespace: [Flowthru.Extensions.Python.Marshalling](Flowthru.Extensions.Python.Marshalling.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+Maps C# schema types to Apache Arrow schemas for tabular data interchange.
+
+```csharp
+public static class ArrowSchemaMapper
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ArrowSchemaMapper](Flowthru.Extensions.Python.Marshalling.ArrowSchemaMapper.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Purpose:</strong> Generates Arrow schemas from C# types annotated with [FlowthruSchema],
+preserving field names (via [SerializedLabel]) and nullability for correct DataFrame marshalling.
+</p>
+<p>
+<strong>Type Mapping (C# → Arrow):</strong>
+</p>
+<ul><li>int, int? → Int32Type</li><li>long, long? → Int64Type</li><li>float, float? → FloatType</li><li>double, double? → DoubleType</li><li>bool, bool? → BooleanType</li><li>string → StringType (always nullable in Arrow)</li><li>DateTime, DateTime? → TimestampType (microsecond, UTC)</li><li>DateTimeOffset, DateTimeOffset? → TimestampType (microsecond, UTC)</li><li>TimeSpan, TimeSpan? → DurationType (microsecond)</li><li>Guid, Guid? → StringType (serialized as string)</li><li>byte[] → BinaryType</li></ul>
+<p>
+<strong>Field Naming:</strong> Uses PropertyMappingHelper to respect [SerializedLabel] attributes,
+ensuring consistency with CSV/Parquet/JSON serializers.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Marshalling_ArrowSchemaMapper_BuildArrowSchema__1"></a> BuildArrowSchema<T\>\(\)
+
+Generates an Apache Arrow schema from a C# schema type.
+
+```csharp
+public static Schema BuildArrowSchema<T>() where T : notnull
+```
+
+#### Returns
+
+ Schema
+
+Arrow schema with fields matching the C# type's properties
+
+#### Type Parameters
+
+`T` 
+
+The C# schema type to map
+
+#### Remarks
+
+The schema includes all public instance properties, with field names determined by
+[SerializedLabel] attributes or property names. Nullability is preserved from the C# type.
+
+#### Exceptions
+
+ [NotSupportedException](https://learn.microsoft.com/dotnet/api/system.notsupportedexception)
+
+Thrown when a property type cannot be mapped to Arrow.
+
+### <a id="Flowthru_Extensions_Python_Marshalling_ArrowSchemaMapper_BuildArrowSchema_System_Type_"></a> BuildArrowSchema\(Type\)
+
+Generates an Apache Arrow schema from a C# type.
+
+```csharp
+public static Schema BuildArrowSchema(Type type)
+```
+
+#### Parameters
+
+`type` [Type](https://learn.microsoft.com/dotnet/api/system.type)
+
+The C# type to map
+
+#### Returns
+
+ Schema
+
+Arrow schema with fields matching the type's properties
+
+#### Exceptions
+
+ [NotSupportedException](https://learn.microsoft.com/dotnet/api/system.notsupportedexception)
+
+Thrown when a property type cannot be mapped to Arrow.
+
+### <a id="Flowthru_Extensions_Python_Marshalling_ArrowSchemaMapper_BuildDtypeSpec__1"></a> BuildDtypeSpec<T\>\(\)
+
+Builds a Python dictionary (PyDict) mapping column names to pandas dtype strings.
+
+```csharp
+public static object BuildDtypeSpec<T>() where T : notnull
+```
+
+#### Returns
+
+ [object](https://learn.microsoft.com/dotnet/api/system.object)
+
+PyDict with dtype specifications for df_to_ipc
+
+#### Type Parameters
+
+`T` 
+
+The C# schema type
+
+#### Remarks
+
+Maps Arrow types to pandas dtype strings:
+- Int32Type → 'int32'
+- Int64Type → 'int64'
+- FloatType → 'float32'
+- DoubleType → 'float64'
+- BooleanType → 'bool'
+- StringType → 'object'
+
+### <a id="Flowthru_Extensions_Python_Marshalling_ArrowSchemaMapper_BuildDtypeSpecDictionary__1"></a> BuildDtypeSpecDictionary<T\>\(\)
+
+Builds a C# dictionary mapping column names to pandas dtype strings,
+suitable for JSON serialization in subprocess protocol messages.
+
+```csharp
+public static Dictionary<string, string> BuildDtypeSpecDictionary<T>() where T : notnull
+```
+
+#### Returns
+
+ [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+Dictionary with dtype specifications for the subprocess worker's df_to_ipc
+
+#### Type Parameters
+
+`T` 
+
+The C# schema type
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Marshalling.ScalarMarshaller.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Marshalling.ScalarMarshaller.md
new file mode 100644
index 00000000..f8e4ef4e
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Marshalling.ScalarMarshaller.md
@@ -0,0 +1,113 @@
+# <a id="Flowthru_Extensions_Python_Marshalling_ScalarMarshaller"></a> Class ScalarMarshaller
+
+Namespace: [Flowthru.Extensions.Python.Marshalling](Flowthru.Extensions.Python.Marshalling.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+Handles bidirectional conversion between C# scalar values and Python objects.
+
+```csharp
+public static class ScalarMarshaller
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ScalarMarshaller](Flowthru.Extensions.Python.Marshalling.ScalarMarshaller.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+Supports:
+<ul><li>Primitives: int, long, double, float, string, bool</li><li>Nullable primitives: int?, double?, etc.</li><li>Simple records and classes via property iteration</li></ul>
+</p>
+<p>
+<strong>Supported since Phase 5:</strong>
+<ul><li>Arrays: T[] (converted to/from Python lists)</li><li>Nested records (via recursive marshalling)</li></ul>
+</p>
+<p>
+<strong>Not supported:</strong>
+<ul><li>Generic collections: IEnumerable&lt;T&gt;, List&lt;T&gt; (use arrays or tabular I/O)</li><li>Arrow/DataFrame interchange (use tabular I/O path)</li></ul>
+</p>
+<p>
+<strong>Thread-safety:</strong> All methods are thread-safe.
+Caller is responsible for GIL acquisition.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Marshalling_ScalarMarshaller_FromPython__1_Python_Runtime_PyObject_"></a> FromPython<T\>\(PyObject\)
+
+Converts a Python object to a C# value of type T.
+
+```csharp
+public static T FromPython<T>(PyObject pyObject)
+```
+
+#### Parameters
+
+`pyObject` PyObject
+
+Python object to convert.
+
+#### Returns
+
+ T
+
+C# value of type T.
+
+#### Type Parameters
+
+`T` 
+
+Target C# type.
+
+#### Remarks
+
+Must be called within a GIL-acquired context.
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown when conversion fails or the type is not supported.
+
+### <a id="Flowthru_Extensions_Python_Marshalling_ScalarMarshaller_ToPython_System_Object_"></a> ToPython\(object?\)
+
+Converts a C# value to a Python object.
+
+```csharp
+public static PyObject ToPython(object? value)
+```
+
+#### Parameters
+
+`value` [object](https://learn.microsoft.com/dotnet/api/system.object)?
+
+C# value to convert. May be null.
+
+#### Returns
+
+ PyObject
+
+Python object representation of the value.
+
+#### Remarks
+
+Must be called within a GIL-acquired context.
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown when the value type is not supported for marshalling.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Marshalling.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Marshalling.md
new file mode 100644
index 00000000..ff59ad27
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Marshalling.md
@@ -0,0 +1,16 @@
+# <a id="Flowthru_Extensions_Python_Marshalling"></a> Namespace Flowthru.Extensions.Python.Marshalling
+
+### Classes
+
+ [ArrowMarshaller](Flowthru.Extensions.Python.Marshalling.ArrowMarshaller.md)
+
+Marshals tabular data between C# IEnumerable&lt;T&gt; and Apache Arrow RecordBatch.
+
+ [ArrowSchemaMapper](Flowthru.Extensions.Python.Marshalling.ArrowSchemaMapper.md)
+
+Maps C# schema types to Apache Arrow schemas for tabular data interchange.
+
+ [ScalarMarshaller](Flowthru.Extensions.Python.Marshalling.ScalarMarshaller.md)
+
+Handles bidirectional conversion between C# scalar values and Python objects.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Nodes.PythonNodeFactory.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Nodes.PythonNodeFactory.md
new file mode 100644
index 00000000..8a7ef5ad
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Nodes.PythonNodeFactory.md
@@ -0,0 +1,5582 @@
+# <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory"></a> Class PythonNodeFactory
+
+Namespace: [](.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+Extension methods for adding Python nodes to pipelines.
+
+```csharp
+public static class PythonNodeFactory
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PythonNodeFactory](.PythonNodeFactory.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Phases 2-5 implementation:</strong>
+Hand-written 1×1 AddPythonStep(Phase 2-4).
+Source-generated N×M overloads for multi-I/O support (Phase 5).
+</p>
+<p>
+<strong>Usage:</strong>
+</p>
+<pre><code class="lang-csharp">public static Pipeline Create(
+    Catalog catalog,
+    IPythonExecutor executor,
+    PythonRuntime runtime)
+{
+    return FlowBuilder.CreateFlow(pipeline =&gt;
+    {
+        pipeline.AddPythonStep(
+            label: "Transform",
+            module: "my_nodes.transform",
+            function: "process",
+            input: catalog.RawData,
+            output: catalog.ProcessedData,
+            executor: executor,
+            runtime: runtime
+        );
+    });
+}</code></pre>
+<p>
+<strong>Future phases:</strong>
+<ul><li>Phase 6: Async support</li></ul>
+</p>
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__2_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TInput, TOutput\>\(FlowBuilder, string, string, string, IItem<TInput\>, IItem<TOutput\>, IPythonExecutor, string\)
+
+Adds a Python node with single input and single output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TInput, TOutput>(this FlowBuilder builder, string label, string module, string function, IItem<TInput> input, IItem<TOutput> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance.
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node.
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model").
+Must be resolvable via sys.path.
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module.
+
+`input` IItem<TInput\>
+
+Catalog entry providing input data.
+
+`output` IItem<TOutput\>
+
+Catalog entry to store output data.
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function.
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description.
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining.
+
+#### Type Parameters
+
+`TInput` 
+
+Input type (must match catalog entry type).
+
+`TOutput` 
+
+Output type (must match catalog entry type).
+
+#### Remarks
+
+<p>
+<strong>Compile-time type safety:</strong>
+Generic type parameters are inferred from catalog entries.
+Mismatched types produce compiler errors.
+</p>
+<p>
+<strong>Registration-time validation (Phase 4):</strong>
+<ul><li>Module is importable (exists, no syntax errors)</li><li>Function exists in module</li><li>@node decorator is present</li></ul>
+</p>
+<p>
+<strong>Pre-flight validation (Phase 4):</strong>
+<ul><li>Decorator schemas match C# generic types</li><li>Function signature arity is correct</li><li>Dry-run with 0-row data validates output structure</li></ul>
+</p>
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__3_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TOut1, TOut2\>\(FlowBuilder, string, string, string, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python node with 1 input and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` IItem<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__4_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python node with 1 input and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` IItem<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__5_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python node with 1 input and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` IItem<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__6_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python node with 1 input and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` IItem<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__7_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python node with 1 input and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` IItem<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__8_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python node with 1 input and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` IItem<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__9_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__System_ValueTuple_Flowthru_Data_IItem___8____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python node with 1 input and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` IItem<TIn1\>
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__3_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___Flowthru_Data_IItem___2__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), IItem<TOut1\>, IPythonExecutor, string\)
+
+Adds a Python node with 2 inputs and 1 output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, IItem<TOut1> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` IItem<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__4_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1, TOut2\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python node with 2 inputs and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__5_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python node with 2 inputs and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__6_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python node with 2 inputs and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__7_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python node with 2 inputs and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__8_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python node with 2 inputs and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__9_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python node with 2 inputs and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__10_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__System_ValueTuple_Flowthru_Data_IItem___9____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python node with 2 inputs and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__4_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___Flowthru_Data_IItem___3__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), IItem<TOut1\>, IPythonExecutor, string\)
+
+Adds a Python node with 3 inputs and 1 output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, IItem<TOut1> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` IItem<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__5_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python node with 3 inputs and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__6_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python node with 3 inputs and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__7_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python node with 3 inputs and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__8_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python node with 3 inputs and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__9_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python node with 3 inputs and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__10_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python node with 3 inputs and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__11_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__System_ValueTuple_Flowthru_Data_IItem___10____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python node with 3 inputs and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__5_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___Flowthru_Data_IItem___4__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), IItem<TOut1\>, IPythonExecutor, string\)
+
+Adds a Python node with 4 inputs and 1 output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, IItem<TOut1> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` IItem<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__6_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python node with 4 inputs and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__7_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python node with 4 inputs and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__8_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python node with 4 inputs and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__9_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python node with 4 inputs and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__10_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python node with 4 inputs and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__11_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python node with 4 inputs and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__12_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__System_ValueTuple_Flowthru_Data_IItem___11____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python node with 4 inputs and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__6_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___Flowthru_Data_IItem___5__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), IItem<TOut1\>, IPythonExecutor, string\)
+
+Adds a Python node with 5 inputs and 1 output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, IItem<TOut1> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` IItem<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__7_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python node with 5 inputs and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__8_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python node with 5 inputs and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__9_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python node with 5 inputs and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__10_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python node with 5 inputs and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__11_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python node with 5 inputs and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__12_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python node with 5 inputs and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__13_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__System_ValueTuple_Flowthru_Data_IItem___12____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python node with 5 inputs and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__7_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___Flowthru_Data_IItem___6__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), IItem<TOut1\>, IPythonExecutor, string\)
+
+Adds a Python node with 6 inputs and 1 output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, IItem<TOut1> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` IItem<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__8_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python node with 6 inputs and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__9_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python node with 6 inputs and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__10_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python node with 6 inputs and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__11_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python node with 6 inputs and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__12_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python node with 6 inputs and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__13_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python node with 6 inputs and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__14_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__System_ValueTuple_Flowthru_Data_IItem___13____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python node with 6 inputs and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__8_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Data_IItem___7__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), IItem<TOut1\>, IPythonExecutor, string\)
+
+Adds a Python node with 7 inputs and 1 output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, IItem<TOut1> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` IItem<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__9_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python node with 7 inputs and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__10_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python node with 7 inputs and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__11_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python node with 7 inputs and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__12_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python node with 7 inputs and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__13_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python node with 7 inputs and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__14_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python node with 7 inputs and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__15_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__System_ValueTuple_Flowthru_Data_IItem___14____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python node with 7 inputs and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__9_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____Flowthru_Data_IItem___8__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), IItem<TOut1\>, IPythonExecutor, string\)
+
+Adds a Python node with 8 inputs and 1 output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, IItem<TOut1> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` IItem<TOut1\>
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__10_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python node with 8 inputs and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__11_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python node with 8 inputs and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__12_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python node with 8 inputs and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__13_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python node with 8 inputs and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__14_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python node with 8 inputs and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__15_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__Flowthru_Data_IItem___14___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python node with 8 inputs and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonNodeFactory_AddPythonStep__16_Flowthru_Pipelines_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__Flowthru_Data_IItem___14__System_ValueTuple_Flowthru_Data_IItem___15____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python node with 8 inputs and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Pipeline builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this node
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Pipelines.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog entry or tuple of catalog entries providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog entry or tuple of catalog entries to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional node description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Nodes.PythonNodeWrapper-2.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Nodes.PythonNodeWrapper-2.md
new file mode 100644
index 00000000..e3d43faf
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Nodes.PythonNodeWrapper-2.md
@@ -0,0 +1,68 @@
+# <a id="Flowthru_Extensions_Python_Nodes_PythonStepWrapper_2"></a> Class PythonStepWrapper<TInput, TOutput\>
+
+Namespace: [](.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+Thin wrapper that binds an <xref href="Flowthru.Extensions.Python.Execution.IPythonExecutor" data-throw-if-not-resolved="false"></xref> to a specific module/function pair,
+exposing it as a typed <code>Func&lt;TInput, TOutput&gt;</code> for use with the pipeline builder.
+
+```csharp
+public sealed class PythonStepWrapper<TInput, TOutput>
+```
+
+#### Type Parameters
+
+`TInput` 
+
+`TOutput` 
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PythonStepWrapper<TInput, TOutput\>](.PythonStepWrapper\-2.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+All marshalling (scalar, tabular, bytes, multi-I/O tuples) is delegated to the executor.
+
+## Constructors
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonStepWrapper_2__ctor_Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_System_String_"></a> PythonStepWrapper\(IPythonExecutor, string, string\)
+
+```csharp
+public PythonStepWrapper(IPythonExecutor executor, string moduleName, string functionName)
+```
+
+#### Parameters
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+`moduleName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+`functionName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Nodes_PythonStepWrapper_2_GetTransform"></a> GetTransform\(\)
+
+Gets the transformation function that invokes the Python node.
+
+```csharp
+public Func<TInput, TOutput> GetTransform()
+```
+
+#### Returns
+
+ [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TInput, TOutput\>
+
+A function that takes <code class="typeparamref">TInput</code> and returns <code class="typeparamref">TOutput</code>.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Nodes.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Nodes.md
new file mode 100644
index 00000000..4461083f
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Nodes.md
@@ -0,0 +1,13 @@
+# <a id="Flowthru_Extensions_Python_Nodes"></a> Namespace 
+
+### Classes
+
+ [PythonNodeFactory](.PythonNodeFactory.md)
+
+Extension methods for adding Python nodes to pipelines.
+
+ [PythonStepWrapper<TInput, TOutput\>](.PythonStepWrapper\-2.md)
+
+Thin wrapper that binds an <xref href="Flowthru.Extensions.Python.Execution.IPythonExecutor" data-throw-if-not-resolved="false"></xref> to a specific module/function pair,
+exposing it as a typed <code>Func&lt;TInput, TOutput&gt;</code> for use with the pipeline builder.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Runtime.PythonExecutionMode.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Runtime.PythonExecutionMode.md
new file mode 100644
index 00000000..1aa41f15
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Runtime.PythonExecutionMode.md
@@ -0,0 +1,29 @@
+# <a id="Flowthru_Extensions_Python_Runtime_PythonExecutionMode"></a> Enum PythonExecutionMode
+
+Namespace: [Flowthru.Extensions.Python.Runtime](Flowthru.Extensions.Python.Runtime.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+Controls how Python step execution is isolated between FlowthruService instances.
+
+```csharp
+public enum PythonExecutionMode
+```
+
+## Fields
+
+`InProcess = 0` 
+
+Executes Python steps in the same process via Python.NET.
+Fast (no IPC overhead), but all services share one Python interpreter,
+<code>sys.modules</code>, and GIL. Use when co-hosted flows are known to be compatible.
+
+
+
+`Subprocess = 1` 
+
+Executes Python steps in an isolated child process per FlowthruService.
+Each service gets its own Python interpreter, venv, <code>sys.path</code>, and module cache.
+Default for multi-service scenarios.
+
+
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Runtime.PythonRuntime.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Runtime.PythonRuntime.md
new file mode 100644
index 00000000..03c9f4cb
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Runtime.PythonRuntime.md
@@ -0,0 +1,141 @@
+# <a id="Flowthru_Extensions_Python_Runtime_PythonRuntime"></a> Class PythonRuntime
+
+Namespace: [Flowthru.Extensions.Python.Runtime](Flowthru.Extensions.Python.Runtime.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+Manages the Python runtime lifecycle and GIL context.
+
+```csharp
+public sealed class PythonRuntime : IDisposable
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PythonRuntime](Flowthru.Extensions.Python.Runtime.PythonRuntime.md)
+
+#### Implements
+
+[IDisposable](https://learn.microsoft.com/dotnet/api/system.idisposable)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+Wraps Python.NET's <xref href="Python.Runtime.PythonEngine" data-throw-if-not-resolved="false"></xref> initialization and shutdown.
+Registered as a singleton in DI — only one Python runtime per application.
+</p>
+<p>
+Thread-safety: Python.NET manages GIL acquisition internally.
+Use <xref href="Flowthru.Extensions.Python.Runtime.PythonRuntime.AcquireGil" data-throw-if-not-resolved="false"></xref> to ensure thread-safe access to Python objects.
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Extensions_Python_Runtime_PythonRuntime__ctor_Flowthru_Extensions_Python_Runtime_PythonRuntimeOptions_Microsoft_Extensions_Logging_ILogger_Flowthru_Extensions_Python_Runtime_PythonRuntime__"></a> PythonRuntime\(PythonRuntimeOptions, ILogger<PythonRuntime\>\)
+
+Initializes a new instance of <xref href="Flowthru.Extensions.Python.Runtime.PythonRuntime" data-throw-if-not-resolved="false"></xref>.
+
+```csharp
+public PythonRuntime(PythonRuntimeOptions options, ILogger<PythonRuntime> logger)
+```
+
+#### Parameters
+
+`options` [PythonRuntimeOptions](Flowthru.Extensions.Python.Runtime.PythonRuntimeOptions.md)
+
+`logger` [ILogger](https://learn.microsoft.com/dotnet/api/microsoft.extensions.logging.ilogger\-1)<[PythonRuntime](Flowthru.Extensions.Python.Runtime.PythonRuntime.md)\>
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Runtime_PythonRuntime_AcquireGil"></a> AcquireGil\(\)
+
+Acquires the Python GIL (Global Interpreter Lock).
+
+```csharp
+public IDisposable AcquireGil()
+```
+
+#### Returns
+
+ [IDisposable](https://learn.microsoft.com/dotnet/api/system.idisposable)
+
+A disposable GIL token. Dispose to release the GIL.
+
+#### Remarks
+
+<p>
+Use this to bracket any Python.NET interop code:
+<pre><code class="lang-csharp">using (runtime.AcquireGil())
+{
+    dynamic module = Py.Import("my_module");
+    var result = module.my_function(42);
+}</code></pre>
+</p>
+<p>
+Python.NET's GIL management is thread-safe — multiple threads can acquire/release
+the GIL, but only one thread executes Python code at a time.
+</p>
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if <xref href="Flowthru.Extensions.Python.Runtime.PythonRuntime.Initialize" data-throw-if-not-resolved="false"></xref> has not been called.
+
+### <a id="Flowthru_Extensions_Python_Runtime_PythonRuntime_Dispose"></a> Dispose\(\)
+
+Disposes the Python runtime wrapper.
+
+```csharp
+public void Dispose()
+```
+
+#### Remarks
+
+<p>
+Does not call <code>PythonEngine.Shutdown()</code> — Python.NET initializes globally once per process,
+and explicit shutdown during process teardown is redundant. The OS reclaims all resources on exit.
+</p>
+<p>
+Additionally, <code>PythonEngine.Shutdown()</code> attempts to serialize runtime state using
+<code>BinaryFormatter</code>, which has been removed in .NET 10+ (see https://aka.ms/binaryformatter).
+Since the serialized state is never restored, shutdown is both unnecessary and incompatible.
+</p>
+<p>
+After disposal, <xref href="Flowthru.Extensions.Python.Runtime.PythonRuntime.AcquireGil" data-throw-if-not-resolved="false"></xref> will throw <xref href="System.ObjectDisposedException" data-throw-if-not-resolved="false"></xref>.
+</p>
+
+### <a id="Flowthru_Extensions_Python_Runtime_PythonRuntime_Initialize"></a> Initialize\(\)
+
+Initializes the Python runtime if not already initialized.
+
+```csharp
+public void Initialize()
+```
+
+#### Remarks
+
+<p>
+Idempotent — safe to call multiple times.
+Applies configuration from <xref href="Flowthru.Extensions.Python.Runtime.PythonRuntimeOptions" data-throw-if-not-resolved="false"></xref> on first call.
+</p>
+<p>
+Sets:
+<ul><li><code>PYTHONNET_PYDLL</code> from resolved DLL path</li><li><code>PYTHONHOME</code> from resolved venv path (if applicable)</li><li><code>sys.path</code> from resolved module search paths</li></ul>
+</p>
+
+#### Exceptions
+
+ [InvalidOperationException](https://learn.microsoft.com/dotnet/api/system.invalidoperationexception)
+
+Thrown if Python runtime cannot be initialized (missing DLL, ABI mismatch, etc.).
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Runtime.PythonRuntimeOptions.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Runtime.PythonRuntimeOptions.md
new file mode 100644
index 00000000..d8ade1cb
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Runtime.PythonRuntimeOptions.md
@@ -0,0 +1,241 @@
+# <a id="Flowthru_Extensions_Python_Runtime_PythonRuntimeOptions"></a> Class PythonRuntimeOptions
+
+Namespace: [Flowthru.Extensions.Python.Runtime](Flowthru.Extensions.Python.Runtime.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+Configuration options for the Python runtime.
+
+```csharp
+public sealed class PythonRuntimeOptions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PythonRuntimeOptions](Flowthru.Extensions.Python.Runtime.PythonRuntimeOptions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+Follows the .NET Options pattern for environment-specific configuration.
+Resolution order mirrors <xref href="Flowthru.Configuration.FlowthruConfigurationOptions" data-throw-if-not-resolved="false"></xref>.
+</p>
+<p>
+<strong>Developer workflow:</strong>
+Run <code>uv sync</code> in your project directory during development to create <code>.venv/</code>.
+During build, <code>pyproject.toml</code>, <code>uv.lock</code>, and <code>.python-version</code> are copied
+to the output directory. On first run, the application automatically executes <code>uv sync --frozen</code>
+in the output directory to materialize <code>.venv/</code> in-place.
+</p>
+<p>
+<strong>Auto-detection hierarchy:</strong>
+<ol><li>Explicit value set via <code>UsePython(opts =&gt; opts.PythonDll = "...")</code></li><li>Environment variable (<code>PYTHONNET_PYDLL</code> for containers/CI)</li><li>Explicit <code>VenvPath</code> override</li><li>Auto-initialization via <code>uv sync --frozen</code> in output directory</li><li>Fallback to <code>VIRTUAL_ENV</code> if set (compatibility with <code>uv run</code>)</li></ol>
+</p>
+
+## Properties
+
+### <a id="Flowthru_Extensions_Python_Runtime_PythonRuntimeOptions_ExecutionMode"></a> ExecutionMode
+
+Controls whether Python steps run in the same process or an isolated child process.
+Defaults to <xref href="Flowthru.Extensions.Python.Runtime.PythonExecutionMode.Subprocess" data-throw-if-not-resolved="false"></xref> for per-service isolation.
+Set to <xref href="Flowthru.Extensions.Python.Runtime.PythonExecutionMode.InProcess" data-throw-if-not-resolved="false"></xref> to opt in to shared-interpreter mode.
+
+```csharp
+public PythonExecutionMode ExecutionMode { get; set; }
+```
+
+#### Property Value
+
+ [PythonExecutionMode](Flowthru.Extensions.Python.Runtime.PythonExecutionMode.md)
+
+### <a id="Flowthru_Extensions_Python_Runtime_PythonRuntimeOptions_ModuleSearchPaths"></a> ModuleSearchPaths
+
+Directories to add to Python's <code>sys.path</code> for module resolution.
+
+```csharp
+public List<string> ModuleSearchPaths { get; set; }
+```
+
+#### Property Value
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+#### Remarks
+
+<p>
+If empty, resolved in order:
+<ol><li><code>FLOWTHRU_PYTHON_PATH</code> environment variable (colon/semicolon-separated)</li><li>Project root (directory containing <code>.csproj</code>)</li></ol>
+</p>
+<p>
+Python steps at <code>Flows/DataScience/Steps/train_model.py</code> are referenced as
+<code>"Flows.DataScience.Steps.train_model"</code> when the project root is in <code>sys.path</code>.
+</p>
+
+### <a id="Flowthru_Extensions_Python_Runtime_PythonRuntimeOptions_PythonDll"></a> PythonDll
+
+Path to the Python shared library (e.g., libpython3.12.so, python312.dll).
+
+```csharp
+public string? PythonDll { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Remarks
+
+<p>
+If not set, resolved in order:
+<ol><li><code>PYTHONNET_PYDLL</code> environment variable (explicit override)</li><li>Explicit <code>VenvPath</code> override</li><li>Auto-materialized <code>.venv/</code> via <code>uv sync --frozen</code> in output directory</li><li><code>VIRTUAL_ENV</code> environment variable (compatibility with <code>uv run</code>)</li></ol>
+</p>
+<p>
+Container deployments typically set <code>PYTHONNET_PYDLL</code> to point to system Python.
+Local development and deployables use <code>uv sync</code> to create <code>.venv/</code> in-place.
+</p>
+
+### <a id="Flowthru_Extensions_Python_Runtime_PythonRuntimeOptions_UvPath"></a> UvPath
+
+Path to the <code>uv</code> executable for virtual environment initialization.
+
+```csharp
+public string UvPath { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+<p>
+Defaults to <code>"uv"</code> (PATH lookup).
+Set this to an absolute path for non-standard installations.
+</p>
+<p>
+Used by auto-initialization when <code>pyproject.toml</code> and <code>uv.lock</code> exist in
+the output directory. To disable auto-initialization entirely, set <code>VenvPath</code>
+explicitly or set <code>PYTHONNET_PYDLL</code> to point to system Python.
+</p>
+
+### <a id="Flowthru_Extensions_Python_Runtime_PythonRuntimeOptions_VenvPath"></a> VenvPath
+
+Path to the Python virtual environment (e.g., <code>.venv/</code>).
+
+```csharp
+public string? VenvPath { get; set; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Remarks
+
+<p>
+If not set, resolved in order:
+<ol><li>Auto-materialized via <code>uv sync --frozen</code> in output directory</li><li><code>VIRTUAL_ENV</code> environment variable</li><li>None (uses system Python packages)</li></ol>
+</p>
+<p>
+Setting this property explicitly skips <code>uv sync</code> auto-initialization.
+Useful for pre-built containers or custom venv management.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Runtime_PythonRuntimeOptions_GetResolvedModuleSearchPaths"></a> GetResolvedModuleSearchPaths\(\)
+
+Gets the resolved Python module search paths.
+
+```csharp
+public List<string> GetResolvedModuleSearchPaths()
+```
+
+#### Returns
+
+ [List](https://learn.microsoft.com/dotnet/api/system.collections.generic.list\-1)<[string](https://learn.microsoft.com/dotnet/api/system.string)\>
+
+#### Remarks
+
+Returns configured module search paths, or the executing assembly's base directory if none specified.
+Python automatically includes site-packages from <code>VIRTUAL_ENV</code> when set.
+
+### <a id="Flowthru_Extensions_Python_Runtime_PythonRuntimeOptions_GetResolvedPythonDll"></a> GetResolvedPythonDll\(\)
+
+Gets the resolved Python DLL path using the auto-detection hierarchy.
+
+```csharp
+public string GetResolvedPythonDll()
+```
+
+#### Returns
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+<p>
+Flowthru uses <code>uv</code> to manage Python environments. <code>pyproject.toml</code>, <code>uv.lock</code>,
+and <code>.python-version</code> are copied to the output directory during build. On first run,
+the runtime executes <code>uv sync --frozen</code> to materialize <code>.venv/</code> in-place.
+</p>
+<p>
+Attempts resolution in order: explicit value → <code>PYTHONNET_PYDLL</code> → explicit <code>VenvPath</code> →
+<code>uv sync</code> auto-init → <code>VIRTUAL_ENV</code>.
+Throws <xref href="System.InvalidOperationException" data-throw-if-not-resolved="false"></xref> if no Python runtime is found.
+</p>
+
+### <a id="Flowthru_Extensions_Python_Runtime_PythonRuntimeOptions_GetResolvedPythonExe"></a> GetResolvedPythonExe\(\)
+
+Gets the Python executable path for subprocess execution.
+
+```csharp
+public string GetResolvedPythonExe()
+```
+
+#### Returns
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Remarks
+
+<p>
+Resolves in the same order as <xref href="Flowthru.Extensions.Python.Runtime.PythonRuntimeOptions.GetResolvedPythonDll" data-throw-if-not-resolved="false"></xref> but returns the interpreter
+binary rather than the shared library. Used by <code>SubprocessPythonExecutor</code> to spawn
+the worker process.
+</p>
+<p>
+Falls back to <code>python3</code> (Unix) or <code>python</code> (Windows) on PATH if no venv is found.
+</p>
+
+### <a id="Flowthru_Extensions_Python_Runtime_PythonRuntimeOptions_GetResolvedVenvPath"></a> GetResolvedVenvPath\(\)
+
+Gets the resolved virtual environment path.
+
+```csharp
+public string? GetResolvedVenvPath()
+```
+
+#### Returns
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+#### Remarks
+
+<p>
+Checks in order:
+<ol><li>Explicit <code>VenvPath</code> property</li><li>Auto-materialized <code>.venv/</code> via <code>uv sync</code> in output directory</li><li><code>VIRTUAL_ENV</code> environment variable</li></ol>
+</p>
+<p>
+Returns <code>null</code> if no virtual environment is configured.
+</p>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Runtime.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Runtime.md
new file mode 100644
index 00000000..06dad053
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Runtime.md
@@ -0,0 +1,18 @@
+# <a id="Flowthru_Extensions_Python_Runtime"></a> Namespace Flowthru.Extensions.Python.Runtime
+
+### Classes
+
+ [PythonRuntime](Flowthru.Extensions.Python.Runtime.PythonRuntime.md)
+
+Manages the Python runtime lifecycle and GIL context.
+
+ [PythonRuntimeOptions](Flowthru.Extensions.Python.Runtime.PythonRuntimeOptions.md)
+
+Configuration options for the Python runtime.
+
+### Enums
+
+ [PythonExecutionMode](Flowthru.Extensions.Python.Runtime.PythonExecutionMode.md)
+
+Controls how Python step execution is isolated between FlowthruService instances.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Services.FlowthruServiceBuilderExtensions.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Services.FlowthruServiceBuilderExtensions.md
new file mode 100644
index 00000000..4fbe0926
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Services.FlowthruServiceBuilderExtensions.md
@@ -0,0 +1,123 @@
+# <a id="Flowthru_Extensions_Python_Services_FlowthruServiceBuilderExtensions"></a> Class FlowthruServiceBuilderExtensions
+
+Namespace: [Flowthru.Extensions.Python.Services](Flowthru.Extensions.Python.Services.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+Extension methods for integrating Python support with <xref href="Flowthru.Services.FlowthruServiceBuilder" data-throw-if-not-resolved="false"></xref>.
+
+```csharp
+public static class FlowthruServiceBuilderExtensions
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[FlowthruServiceBuilderExtensions](Flowthru.Extensions.Python.Services.FlowthruServiceBuilderExtensions.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Services_FlowthruServiceBuilderExtensions_UsePython_Flowthru_Services_FlowthruServiceBuilder_"></a> UsePython\(FlowthruServiceBuilder\)
+
+Registers Python runtime and executor with default configuration.
+
+```csharp
+public static FlowthruServiceBuilder UsePython(this FlowthruServiceBuilder builder)
+```
+
+#### Parameters
+
+`builder` FlowthruServiceBuilder
+
+The Flowthru service builder
+
+#### Returns
+
+ FlowthruServiceBuilder
+
+The builder for method chaining
+
+#### Remarks
+
+<p>
+Uses auto-detection for all configuration:
+<ul><li>Python DLL: <code>PYTHONNET_PYDLL</code> → <code>.venv/</code> → system Python</li><li>Virtual environment: <code>FLOWTHRU_PYTHON_VENV</code> → <code>.venv/</code> → none</li><li>Module search paths: <code>FLOWTHRU_PYTHON_PATH</code> → project root</li></ul>
+</p>
+<p>
+<strong>Example (auto-detection):</strong>
+<pre><code class="lang-csharp">services.AddFlowthru(flowthru =&gt;
+{
+    flowthru
+        .RegisterCatalog&lt;MyCatalog&gt;()
+        .UsePython();  // Auto-detects .venv/, project root, etc.
+});</code></pre>
+</p>
+
+### <a id="Flowthru_Extensions_Python_Services_FlowthruServiceBuilderExtensions_UsePython_Flowthru_Services_FlowthruServiceBuilder_System_Action_Flowthru_Extensions_Python_Runtime_PythonRuntimeOptions__"></a> UsePython\(FlowthruServiceBuilder, Action<PythonRuntimeOptions\>\)
+
+Registers Python runtime and executor with custom configuration.
+
+```csharp
+public static FlowthruServiceBuilder UsePython(this FlowthruServiceBuilder builder, Action<PythonRuntimeOptions> configure)
+```
+
+#### Parameters
+
+`builder` FlowthruServiceBuilder
+
+The Flowthru service builder
+
+`configure` [Action](https://learn.microsoft.com/dotnet/api/system.action\-1)<[PythonRuntimeOptions](Flowthru.Extensions.Python.Runtime.PythonRuntimeOptions.md)\>
+
+Action to configure Python runtime options
+
+#### Returns
+
+ FlowthruServiceBuilder
+
+The builder for method chaining
+
+#### Remarks
+
+<p>
+Explicit configuration overrides auto-detection.
+Use this for:
+<ul><li>Container deployments with non-standard Python paths</li><li>Custom module search paths</li><li>Multiple Python versions (explicit DLL path)</li></ul>
+</p>
+<p>
+<strong>Example (explicit configuration):</strong>
+<pre><code class="lang-csharp">services.AddFlowthru(flowthru =&gt;
+{
+    flowthru
+        .RegisterCatalog&lt;MyCatalog&gt;()
+        .UsePython(python =&gt;
+        {
+            python.PythonDll = "/usr/lib/x86_64-linux-gnu/libpython3.12.so";
+            python.ModuleSearchPaths.Add("Flows");
+            python.ModuleSearchPaths.Add("SharedSteps");
+        });
+});</code></pre>
+</p>
+<p>
+<strong>Example (environment-variable driven, for containers):</strong>
+<pre><code class="lang-csharp">services.AddFlowthru(flowthru =&gt;
+{
+    flowthru
+        .RegisterCatalog&lt;MyCatalog&gt;()
+        .UsePython(python =&gt;
+        {
+            // Reads PYTHONNET_PYDLL, FLOWTHRU_PYTHON_VENV, FLOWTHRU_PYTHON_PATH
+            // Auto-detection still active for unset properties
+        });
+});</code></pre>
+</p>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Services.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Services.md
new file mode 100644
index 00000000..0c1ba0c3
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Services.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Extensions_Python_Services"></a> Namespace Flowthru.Extensions.Python.Services
+
+### Classes
+
+ [FlowthruServiceBuilderExtensions](Flowthru.Extensions.Python.Services.FlowthruServiceBuilderExtensions.md)
+
+Extension methods for integrating Python support with <xref href="Flowthru.Services.FlowthruServiceBuilder" data-throw-if-not-resolved="false"></xref>.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Steps.PythonStepFactory.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Steps.PythonStepFactory.md
new file mode 100644
index 00000000..aff78c93
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Steps.PythonStepFactory.md
@@ -0,0 +1,5582 @@
+# <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory"></a> Class PythonStepFactory
+
+Namespace: [Flowthru.Extensions.Python.Steps](Flowthru.Extensions.Python.Steps.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+Extension methods for adding Python steps to flows.
+
+```csharp
+public static class PythonStepFactory
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PythonStepFactory](Flowthru.Extensions.Python.Steps.PythonStepFactory.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Phases 2-5 implementation:</strong>
+Hand-written 1×1 AddPythonStep(Phase 2-4).
+Source-generated N×M overloads for multi-I/O support (Phase 5).
+</p>
+<p>
+<strong>Usage:</strong>
+</p>
+<pre><code class="lang-csharp">public static Flow Create(
+    Catalog catalog,
+    IPythonExecutor executor,
+    PythonRuntime runtime)
+{
+    return FlowBuilder.CreateFlow(flow =&gt;
+    {
+        flow.AddPythonStep(
+            label: "Transform",
+            module: "my_steps.transform",
+            function: "process",
+            input: catalog.RawData,
+            output: catalog.ProcessedData,
+            executor: executor,
+            runtime: runtime
+        );
+    });
+}</code></pre>
+<p>
+<strong>Future phases:</strong>
+<ul><li>Phase 6: Async support</li></ul>
+</p>
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__2_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TInput, TOutput\>\(FlowBuilder, string, string, string, IItem<TInput\>, IItem<TOutput\>, IPythonExecutor, string\)
+
+Adds a Python step with single input and single output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TInput, TOutput>(this FlowBuilder builder, string label, string module, string function, IItem<TInput> input, IItem<TOutput> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance.
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step.
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model").
+Must be resolvable via sys.path.
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module.
+
+`input` IItem<TInput\>
+
+Catalog item providing input data.
+
+`output` IItem<TOutput\>
+
+Catalog item to store output data.
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function.
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description.
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining.
+
+#### Type Parameters
+
+`TInput` 
+
+Input type (must match catalog item type).
+
+`TOutput` 
+
+Output type (must match catalog item type).
+
+#### Remarks
+
+<p>
+<strong>Compile-time type safety:</strong>
+Generic type parameters are inferred from catalog items.
+Mismatched types produce compiler errors.
+</p>
+<p>
+<strong>Registration-time validation (Phase 4):</strong>
+<ul><li>Module is importable (exists, no syntax errors)</li><li>Function exists in module</li><li>@step decorator is present</li></ul>
+</p>
+<p>
+<strong>Pre-flight validation (Phase 4):</strong>
+<ul><li>Decorator schemas match C# generic types</li><li>Function signature arity is correct</li><li>Dry-run with 0-row data validates output structure</li></ul>
+</p>
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__3_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TOut1, TOut2\>\(FlowBuilder, string, string, string, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python step with 1 input and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` IItem<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__4_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python step with 1 input and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` IItem<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__5_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python step with 1 input and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` IItem<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__6_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python step with 1 input and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` IItem<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__7_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python step with 1 input and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` IItem<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__8_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python step with 1 input and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` IItem<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__9_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_Flowthru_Data_IItem___0__System_ValueTuple_Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__System_ValueTuple_Flowthru_Data_IItem___8____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, IItem<TIn1\>, \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python step with 1 input and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, IItem<TIn1> input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` IItem<TIn1\>
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__3_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___Flowthru_Data_IItem___2__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), IItem<TOut1\>, IPythonExecutor, string\)
+
+Adds a Python step with 2 inputs and 1 output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, IItem<TOut1> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` IItem<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__4_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1, TOut2\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python step with 2 inputs and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__5_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python step with 2 inputs and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__6_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python step with 2 inputs and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__7_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python step with 2 inputs and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__8_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python step with 2 inputs and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__9_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python step with 2 inputs and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__10_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1___System_ValueTuple_Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__System_ValueTuple_Flowthru_Data_IItem___9____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python step with 2 inputs and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__4_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___Flowthru_Data_IItem___3__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), IItem<TOut1\>, IPythonExecutor, string\)
+
+Adds a Python step with 3 inputs and 1 output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, IItem<TOut1> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` IItem<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__5_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python step with 3 inputs and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__6_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python step with 3 inputs and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__7_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python step with 3 inputs and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__8_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python step with 3 inputs and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__9_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python step with 3 inputs and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__10_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python step with 3 inputs and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__11_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2___System_ValueTuple_Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__System_ValueTuple_Flowthru_Data_IItem___10____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python step with 3 inputs and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__5_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___Flowthru_Data_IItem___4__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), IItem<TOut1\>, IPythonExecutor, string\)
+
+Adds a Python step with 4 inputs and 1 output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, IItem<TOut1> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` IItem<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__6_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python step with 4 inputs and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__7_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python step with 4 inputs and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__8_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python step with 4 inputs and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__9_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python step with 4 inputs and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__10_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python step with 4 inputs and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__11_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python step with 4 inputs and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__12_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3___System_ValueTuple_Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__System_ValueTuple_Flowthru_Data_IItem___11____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python step with 4 inputs and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__6_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___Flowthru_Data_IItem___5__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), IItem<TOut1\>, IPythonExecutor, string\)
+
+Adds a Python step with 5 inputs and 1 output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, IItem<TOut1> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` IItem<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__7_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python step with 5 inputs and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__8_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python step with 5 inputs and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__9_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python step with 5 inputs and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__10_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python step with 5 inputs and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__11_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python step with 5 inputs and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__12_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python step with 5 inputs and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__13_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4___System_ValueTuple_Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__System_ValueTuple_Flowthru_Data_IItem___12____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python step with 5 inputs and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__7_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___Flowthru_Data_IItem___6__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), IItem<TOut1\>, IPythonExecutor, string\)
+
+Adds a Python step with 6 inputs and 1 output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, IItem<TOut1> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` IItem<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__8_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python step with 6 inputs and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__9_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python step with 6 inputs and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__10_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python step with 6 inputs and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__11_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python step with 6 inputs and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__12_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python step with 6 inputs and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__13_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python step with 6 inputs and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__14_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5___System_ValueTuple_Flowthru_Data_IItem___6__Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__System_ValueTuple_Flowthru_Data_IItem___13____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python step with 6 inputs and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__8_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___Flowthru_Data_IItem___7__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), IItem<TOut1\>, IPythonExecutor, string\)
+
+Adds a Python step with 7 inputs and 1 output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, IItem<TOut1> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` IItem<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__9_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python step with 7 inputs and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__10_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python step with 7 inputs and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__11_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python step with 7 inputs and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__12_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python step with 7 inputs and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__13_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python step with 7 inputs and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__14_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python step with 7 inputs and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__15_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6___System_ValueTuple_Flowthru_Data_IItem___7__Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__System_ValueTuple_Flowthru_Data_IItem___14____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python step with 7 inputs and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__9_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____Flowthru_Data_IItem___8__Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), IItem<TOut1\>, IPythonExecutor, string\)
+
+Adds a Python step with 8 inputs and 1 output.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, IItem<TOut1> output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` IItem<TOut1\>
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__10_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>\), IPythonExecutor, string\)
+
+Adds a Python step with 8 inputs and 2 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__11_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\), IPythonExecutor, string\)
+
+Adds a Python step with 8 inputs and 3 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__12_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\), IPythonExecutor, string\)
+
+Adds a Python step with 8 inputs and 4 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__13_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\), IPythonExecutor, string\)
+
+Adds a Python step with 8 inputs and 5 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__14_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\), IPythonExecutor, string\)
+
+Adds a Python step with 8 inputs and 6 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__15_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__Flowthru_Data_IItem___14___Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\), IPythonExecutor, string\)
+
+Adds a Python step with 8 inputs and 7 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepFactory_AddPythonStep__16_Flowthru_Flows_FlowBuilder_System_String_System_String_System_String_System_ValueTuple_Flowthru_Data_IItem___0__Flowthru_Data_IItem___1__Flowthru_Data_IItem___2__Flowthru_Data_IItem___3__Flowthru_Data_IItem___4__Flowthru_Data_IItem___5__Flowthru_Data_IItem___6__System_ValueTuple_Flowthru_Data_IItem___7____System_ValueTuple_Flowthru_Data_IItem___8__Flowthru_Data_IItem___9__Flowthru_Data_IItem___10__Flowthru_Data_IItem___11__Flowthru_Data_IItem___12__Flowthru_Data_IItem___13__Flowthru_Data_IItem___14__System_ValueTuple_Flowthru_Data_IItem___15____Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_"></a> AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8\>\(FlowBuilder, string, string, string, \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\), \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\), IPythonExecutor, string\)
+
+Adds a Python step with 8 inputs and 8 outputs.
+
+```csharp
+public static FlowBuilder AddPythonStep<TIn1, TIn2, TIn3, TIn4, TIn5, TIn6, TIn7, TIn8, TOut1, TOut2, TOut3, TOut4, TOut5, TOut6, TOut7, TOut8>(this FlowBuilder builder, string label, string module, string function, (IItem<TIn1>, IItem<TIn2>, IItem<TIn3>, IItem<TIn4>, IItem<TIn5>, IItem<TIn6>, IItem<TIn7>, IItem<TIn8>) input, (IItem<TOut1>, IItem<TOut2>, IItem<TOut3>, IItem<TOut4>, IItem<TOut5>, IItem<TOut6>, IItem<TOut7>, IItem<TOut8>) output, IPythonExecutor executor, string description = "")
+```
+
+#### Parameters
+
+`builder` FlowBuilder
+
+Flow builder instance
+
+`label` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Unique identifier for this step
+
+`module` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Dotted Python module name (e.g., "Flows.DataScience.train_model")
+
+`function` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Python function name within the module
+
+`input` \(IItem<TIn1\>, IItem<TIn2\>, IItem<TIn3\>, IItem<TIn4\>, IItem<TIn5\>, IItem<TIn6\>, IItem<TIn7\>, IItem<TIn8\>\)
+
+Catalog item or tuple of catalog items providing input data
+
+`output` \(IItem<TOut1\>, IItem<TOut2\>, IItem<TOut3\>, IItem<TOut4\>, IItem<TOut5\>, IItem<TOut6\>, IItem<TOut7\>, IItem<TOut8\>\)
+
+Catalog item or tuple of catalog items to store output data
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for invoking the function
+
+`description` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Optional step description
+
+#### Returns
+
+ FlowBuilder
+
+This builder for method chaining
+
+#### Type Parameters
+
+`TIn1` 
+
+Input type 1
+
+`TIn2` 
+
+Input type 2
+
+`TIn3` 
+
+Input type 3
+
+`TIn4` 
+
+Input type 4
+
+`TIn5` 
+
+Input type 5
+
+`TIn6` 
+
+Input type 6
+
+`TIn7` 
+
+Input type 7
+
+`TIn8` 
+
+Input type 8
+
+`TOut1` 
+
+Output type 1
+
+`TOut2` 
+
+Output type 2
+
+`TOut3` 
+
+Output type 3
+
+`TOut4` 
+
+Output type 4
+
+`TOut5` 
+
+Output type 5
+
+`TOut6` 
+
+Output type 6
+
+`TOut7` 
+
+Output type 7
+
+`TOut8` 
+
+Output type 8
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Steps.PythonStepWrapper-2.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Steps.PythonStepWrapper-2.md
new file mode 100644
index 00000000..f501f137
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Steps.PythonStepWrapper-2.md
@@ -0,0 +1,74 @@
+# <a id="Flowthru_Extensions_Python_Steps_PythonStepWrapper_2"></a> Class PythonStepWrapper<TInput, TOutput\>
+
+Namespace: [Flowthru.Extensions.Python.Steps](Flowthru.Extensions.Python.Steps.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+Thin wrapper that binds an <xref href="Flowthru.Extensions.Python.Execution.IPythonExecutor" data-throw-if-not-resolved="false"></xref> to a specific module/function pair,
+exposing it as a typed <code>Func&lt;TInput, TOutput&gt;</code> for use with the flow builder.
+
+```csharp
+public sealed class PythonStepWrapper<TInput, TOutput>
+```
+
+#### Type Parameters
+
+`TInput` 
+
+`TOutput` 
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PythonStepWrapper<TInput, TOutput\>](Flowthru.Extensions.Python.Steps.PythonStepWrapper\-2.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+All marshalling (scalar, tabular, bytes, multi-I/O tuples) is delegated to the executor.
+
+## Constructors
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepWrapper_2__ctor_Flowthru_Extensions_Python_Execution_IPythonExecutor_System_String_System_String_"></a> PythonStepWrapper\(IPythonExecutor, string, string\)
+
+Initializes the wrapper with the executor and step information.
+
+```csharp
+public PythonStepWrapper(IPythonExecutor executor, string moduleName, string functionName)
+```
+
+#### Parameters
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+`moduleName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+`functionName` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+#### Exceptions
+
+ [ArgumentNullException](https://learn.microsoft.com/dotnet/api/system.argumentnullexception)
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Steps_PythonStepWrapper_2_GetTransform"></a> GetTransform\(\)
+
+Gets the transformation function that invokes the Python step.
+
+```csharp
+public Func<TInput, TOutput> GetTransform()
+```
+
+#### Returns
+
+ [Func](https://learn.microsoft.com/dotnet/api/system.func\-2)<TInput, TOutput\>
+
+A function that takes <code class="typeparamref">TInput</code> and returns <code class="typeparamref">TOutput</code>.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Steps.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Steps.md
new file mode 100644
index 00000000..f64d2b03
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Steps.md
@@ -0,0 +1,13 @@
+# <a id="Flowthru_Extensions_Python_Steps"></a> Namespace Flowthru.Extensions.Python.Steps
+
+### Classes
+
+ [PythonStepFactory](Flowthru.Extensions.Python.Steps.PythonStepFactory.md)
+
+Extension methods for adding Python steps to flows.
+
+ [PythonStepWrapper<TInput, TOutput\>](Flowthru.Extensions.Python.Steps.PythonStepWrapper\-2.md)
+
+Thin wrapper that binds an <xref href="Flowthru.Extensions.Python.Execution.IPythonExecutor" data-throw-if-not-resolved="false"></xref> to a specific module/function pair,
+exposing it as a typed <code>Func&lt;TInput, TOutput&gt;</code> for use with the flow builder.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Validation.PythonNodeValidator.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Validation.PythonNodeValidator.md
new file mode 100644
index 00000000..e5dab47e
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Validation.PythonNodeValidator.md
@@ -0,0 +1,120 @@
+# <a id="Flowthru_Extensions_Python_Validation_PythonNodeValidator"></a> Class PythonNodeValidator
+
+Namespace: [Flowthru.Extensions.Python.Validation](Flowthru.Extensions.Python.Validation.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+Validation hook for Python nodes.
+
+```csharp
+public class PythonNodeValidator : IPipelineValidationHook
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PythonNodeValidator](Flowthru.Extensions.Python.Validation.PythonNodeValidator.md)
+
+#### Implements
+
+IPipelineValidationHook
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Phase 4 pre-flight validation:</strong>
+Validates Python nodes during pipeline pre-flight to catch schema mismatches,
+incorrect function signatures, and structural errors before execution.
+</p>
+<p>
+<strong>Checks performed:</strong>
+<ul><li>@node decorator schemas match C# generic type parameters</li><li>Function signature arity is correct for input count</li><li>Dry-run with 0-row data validates output structure</li></ul>
+</p>
+<p>
+<strong>Integration:</strong>
+Register this hook via Pipeline.ValidationHooks during pipeline setup.
+The hook is automatically invoked during Pipeline.ValidateExternalInputsAsync().
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Extensions_Python_Validation_PythonNodeValidator__ctor_Flowthru_Extensions_Python_Execution_IPythonExecutor_Flowthru_Extensions_Python_Runtime_PythonRuntime_"></a> PythonNodeValidator\(IPythonExecutor, PythonRuntime\)
+
+Initializes a new instance of <xref href="Flowthru.Extensions.Python.Validation.PythonNodeValidator" data-throw-if-not-resolved="false"></xref>.
+
+```csharp
+public PythonNodeValidator(IPythonExecutor executor, PythonRuntime runtime)
+```
+
+#### Parameters
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for function inspection
+
+`runtime` [PythonRuntime](Flowthru.Extensions.Python.Runtime.PythonRuntime.md)
+
+Python runtime for GIL management
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Validation_PythonNodeValidator_ValidateAsync_Flowthru_Pipelines_Pipeline_System_Threading_CancellationToken_"></a> ValidateAsync\(Pipeline, CancellationToken\)
+
+Validates pipeline nodes during pre-flight checks.
+
+```csharp
+public Task<ValidationResult> ValidateAsync(Pipeline pipeline, CancellationToken cancellationToken)
+```
+
+#### Parameters
+
+`pipeline` Pipeline
+
+The pipeline being validated
+
+`cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+Cancellation token for async operations
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<ValidationResult\>
+
+Validation result containing any errors found
+
+#### Remarks
+
+<p>
+Implementations should:
+<ul><li>Never throw exceptions (return errors in ValidationResult)</li><li>Be idempotent (safe to call multiple times)</li><li>Be reasonably fast (executed during pre-flight, blocks pipeline start)</li><li>Only validate nodes they understand (ignore other node types)</li></ul>
+</p>
+<p>
+<strong>Example implementation (Python extension):</strong>
+</p>
+<pre><code class="lang-csharp">public async Task&lt;ValidationResult&gt; ValidateAsync(
+  Pipeline pipeline,
+  CancellationToken cancellationToken)
+{
+  var result = ValidationResult.Success();
+
+  foreach (var node in pipeline.Nodes)
+  {
+    if (IsPythonNode(node))
+    {
+      var nodeResult = await ValidatePythonNode(node, cancellationToken);
+      result.Merge(nodeResult);
+    }
+  }
+
+  return result;
+}</code></pre>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Validation.PythonStepValidator.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Validation.PythonStepValidator.md
new file mode 100644
index 00000000..58d80f28
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Validation.PythonStepValidator.md
@@ -0,0 +1,120 @@
+# <a id="Flowthru_Extensions_Python_Validation_PythonStepValidator"></a> Class PythonStepValidator
+
+Namespace: [Flowthru.Extensions.Python.Validation](Flowthru.Extensions.Python.Validation.md)  
+Assembly: Flowthru.Extensions.Python.dll  
+
+Validation hook for Python steps.
+
+```csharp
+public class PythonStepValidator : IFlowValidationHook
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[PythonStepValidator](Flowthru.Extensions.Python.Validation.PythonStepValidator.md)
+
+#### Implements
+
+IFlowValidationHook
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<strong>Phase 4 pre-flight validation:</strong>
+Validates Python steps during flow pre-flight to catch schema mismatches,
+incorrect function signatures, and structural errors before execution.
+</p>
+<p>
+<strong>Checks performed:</strong>
+<ul><li>@step decorator schemas match C# generic type parameters</li><li>Function signature arity is correct for input count</li><li>Dry-run with 0-row data validates output structure</li></ul>
+</p>
+<p>
+<strong>Integration:</strong>
+Register this hook via Flow.ValidationHooks during flow setup.
+The hook is automatically invoked during Flow.ValidateExternalInputsAsync().
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Extensions_Python_Validation_PythonStepValidator__ctor_Flowthru_Extensions_Python_Execution_IPythonExecutor_Flowthru_Extensions_Python_Runtime_PythonRuntime_"></a> PythonStepValidator\(IPythonExecutor, PythonRuntime\)
+
+Initializes a new instance of <xref href="Flowthru.Extensions.Python.Validation.PythonStepValidator" data-throw-if-not-resolved="false"></xref>.
+
+```csharp
+public PythonStepValidator(IPythonExecutor executor, PythonRuntime runtime)
+```
+
+#### Parameters
+
+`executor` [IPythonExecutor](Flowthru.Extensions.Python.Execution.IPythonExecutor.md)
+
+Python executor for function inspection
+
+`runtime` [PythonRuntime](Flowthru.Extensions.Python.Runtime.PythonRuntime.md)
+
+Python runtime for GIL management
+
+## Methods
+
+### <a id="Flowthru_Extensions_Python_Validation_PythonStepValidator_ValidateAsync_Flowthru_Flows_Flow_System_Threading_CancellationToken_"></a> ValidateAsync\(Flow, CancellationToken\)
+
+Validates flow steps during pre-flight checks.
+
+```csharp
+public Task<ValidationResult> ValidateAsync(Flow flow, CancellationToken cancellationToken)
+```
+
+#### Parameters
+
+`flow` Flow
+
+The flow being validated
+
+`cancellationToken` [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken)
+
+Cancellation token for async operations
+
+#### Returns
+
+ [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task\-1)<ValidationResult\>
+
+Validation result containing any errors found
+
+#### Remarks
+
+<p>
+Implementations should:
+<ul><li>Never throw exceptions (return errors in ValidationResult)</li><li>Be idempotent (safe to call multiple times)</li><li>Be reasonably fast (executed during pre-flight, blocks flow start)</li><li>Only validate steps they understand (ignore other step types)</li></ul>
+</p>
+<p>
+<strong>Example implementation (Python extension):</strong>
+</p>
+<pre><code class="lang-csharp">public async Task&lt;ValidationResult&gt; ValidateAsync(
+  Flow flow,
+  CancellationToken cancellationToken)
+{
+  var result = ValidationResult.Success();
+
+  foreach (var step in flow.Steps)
+  {
+    if (IsPythonStep(step))
+    {
+      var stepResult = await ValidatePythonStep(step, cancellationToken);
+      result.Merge(stepResult);
+    }
+  }
+
+  return result;
+}</code></pre>
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Validation.md b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Validation.md
new file mode 100644
index 00000000..8546bf8e
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.Validation.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Extensions_Python_Validation"></a> Namespace Flowthru.Extensions.Python.Validation
+
+### Classes
+
+ [PythonStepValidator](Flowthru.Extensions.Python.Validation.PythonStepValidator.md)
+
+Validation hook for Python steps.
+
diff --git a/docs/reference/src/extensions/Flowthru.Extensions.Python/toc.yml b/docs/reference/src/extensions/Flowthru.Extensions.Python/toc.yml
new file mode 100644
index 00000000..0b956f36
--- /dev/null
+++ b/docs/reference/src/extensions/Flowthru.Extensions.Python/toc.yml
@@ -0,0 +1,59 @@
+### YamlMime:TableOfContent
+- name: Flowthru.Extensions.Python.Build
+  href: Flowthru.Extensions.Python.Build.md
+  items:
+  - name: Classes
+  - name: PythonSchemaExportTask
+    href: Flowthru.Extensions.Python.Build.PythonSchemaExportTask.md
+- name: Flowthru.Extensions.Python.Execution
+  href: Flowthru.Extensions.Python.Execution.md
+  items:
+  - name: Classes
+  - name: PythonNetExecutor
+    href: Flowthru.Extensions.Python.Execution.PythonNetExecutor.md
+  - name: SubprocessPythonExecutor
+    href: Flowthru.Extensions.Python.Execution.SubprocessPythonExecutor.md
+  - name: Interfaces
+  - name: IPythonExecutor
+    href: Flowthru.Extensions.Python.Execution.IPythonExecutor.md
+- name: Flowthru.Extensions.Python.Marshalling
+  href: Flowthru.Extensions.Python.Marshalling.md
+  items:
+  - name: Classes
+  - name: ArrowMarshaller
+    href: Flowthru.Extensions.Python.Marshalling.ArrowMarshaller.md
+  - name: ArrowSchemaMapper
+    href: Flowthru.Extensions.Python.Marshalling.ArrowSchemaMapper.md
+  - name: ScalarMarshaller
+    href: Flowthru.Extensions.Python.Marshalling.ScalarMarshaller.md
+- name: Flowthru.Extensions.Python.Runtime
+  href: Flowthru.Extensions.Python.Runtime.md
+  items:
+  - name: Classes
+  - name: PythonRuntime
+    href: Flowthru.Extensions.Python.Runtime.PythonRuntime.md
+  - name: PythonRuntimeOptions
+    href: Flowthru.Extensions.Python.Runtime.PythonRuntimeOptions.md
+  - name: Enums
+  - name: PythonExecutionMode
+    href: Flowthru.Extensions.Python.Runtime.PythonExecutionMode.md
+- name: Flowthru.Extensions.Python.Services
+  href: Flowthru.Extensions.Python.Services.md
+  items:
+  - name: Classes
+  - name: FlowthruServiceBuilderExtensions
+    href: Flowthru.Extensions.Python.Services.FlowthruServiceBuilderExtensions.md
+- name: Flowthru.Extensions.Python.Steps
+  href: Flowthru.Extensions.Python.Steps.md
+  items:
+  - name: Classes
+  - name: PythonStepFactory
+    href: Flowthru.Extensions.Python.Steps.PythonStepFactory.md
+  - name: PythonStepWrapper<TInput, TOutput>
+    href: Flowthru.Extensions.Python.Steps.PythonStepWrapper-2.md
+- name: Flowthru.Extensions.Python.Validation
+  href: Flowthru.Extensions.Python.Validation.md
+  items:
+  - name: Classes
+  - name: PythonStepValidator
+    href: Flowthru.Extensions.Python.Validation.PythonStepValidator.md
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.CurveFitting.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.CurveFitting.md
new file mode 100644
index 00000000..b29384a0
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.CurveFitting.md
@@ -0,0 +1,71 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_CurveFitting"></a> Class CurveFitting
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core](Flowthru.Misc.ML.UMAP.Core.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Helper for computing UMAP curve fitting parameters.
+
+```csharp
+public static class CurveFitting
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[CurveFitting](Flowthru.Misc.ML.UMAP.Core.CurveFitting.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+UMAP uses a smooth curve to approximate the attractive force between points:
+</p>
+<pre><code class="lang-csharp">weight(dist) = 1 / (1 + a * dist^(2b))</code></pre>
+<p>
+Parameters <code>a</code> and <code>b</code> are fit to match an exponential decay curve
+based on the <code>spread</code> and <code>min_dist</code> hyperparameters:
+</p>
+<ul><li>For dist &lt; min_dist: weight = 1.0 (fully connected)</li><li>For dist ≥ min_dist: weight = exp(-(dist - min_dist) / spread)</li></ul>
+<p>
+Python UMAP reference: <code>find_ab_params()</code> in <code>umap_.py</code> (lines 1393-1408)
+</p>
+<p>
+This implementation uses the Levenberg-Marquardt algorithm to match Python's
+scipy.optimize.curve_fit behavior, ensuring identical parameter values.
+</p>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_CurveFitting_FindABParams_System_Single_System_Single_"></a> FindABParams\(float, float\)
+
+Computes curve parameters a and b from spread and min_dist using curve fitting.
+
+```csharp
+public static (float a, float b) FindABParams(float spread, float minDist)
+```
+
+#### Parameters
+
+`spread` [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+Effective scale of embedded points.
+
+`minDist` [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+Minimum distance between embedded points.
+
+#### Returns
+
+ \([float](https://learn.microsoft.com/dotnet/api/system.single) [a](https://learn.microsoft.com/dotnet/api/system.valuetuple\-system.single,system.single\-.a), [float](https://learn.microsoft.com/dotnet/api/system.single) [b](https://learn.microsoft.com/dotnet/api/system.valuetuple\-system.single,system.single\-.b)\)
+
+Tuple of (a, b) parameters.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.DataShape.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.DataShape.md
new file mode 100644
index 00000000..70f15d30
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.DataShape.md
@@ -0,0 +1,180 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_DataShape"></a> Class DataShape
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core](Flowthru.Misc.ML.UMAP.Core.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Describes the shape and characteristics of input data.
+Used by strategy factories to select appropriate default strategies.
+
+```csharp
+public sealed record DataShape : IEquatable<DataShape>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[DataShape](Flowthru.Misc.ML.UMAP.Core.DataShape.md)
+
+#### Implements
+
+[IEquatable<DataShape\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Analyzing data shape allows the UMAP pipeline to automatically choose
+optimal strategies. For example:
+- Small datasets (&lt; 4096 samples) can use exact k-NN
+- Large datasets benefit from approximate nearest neighbor search
+- Sparse data requires specialized algorithms
+- High-dimensional data may benefit from PCA initialization
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_DataShape_EstimatedMemoryBytes"></a> EstimatedMemoryBytes
+
+Approximate memory footprint in bytes.
+
+```csharp
+public long EstimatedMemoryBytes { get; init; }
+```
+
+#### Property Value
+
+ [long](https://learn.microsoft.com/dotnet/api/system.int64)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_DataShape_Features"></a> Features
+
+Number of features (columns) in the dataset.
+
+```csharp
+public required int Features { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_DataShape_IsHighDimensional"></a> IsHighDimensional
+
+Whether the dataset is high-dimensional (typically &gt; 100 features).
+High-dimensional data may benefit from dimensionality reduction in initialization.
+
+```csharp
+public bool IsHighDimensional { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_DataShape_IsLargeDataset"></a> IsLargeDataset
+
+Whether the dataset is considered "large" (typically ≥ 4096 samples).
+Large datasets should use approximate algorithms.
+
+```csharp
+public bool IsLargeDataset { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_DataShape_IsSmallDataset"></a> IsSmallDataset
+
+Whether the dataset is considered "small" (typically &lt; 4096 samples).
+Small datasets can use exact algorithms.
+
+```csharp
+public bool IsSmallDataset { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_DataShape_IsSparse"></a> IsSparse
+
+Whether the data is stored in a sparse format.
+
+```csharp
+public required bool IsSparse { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_DataShape_IsVeryHighDimensional"></a> IsVeryHighDimensional
+
+Whether the dataset is very high-dimensional (typically &gt; 1000 features).
+Very high-dimensional data may require PCA pre-processing.
+
+```csharp
+public bool IsVeryHighDimensional { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_DataShape_RecommendedEpochs"></a> RecommendedEpochs
+
+Recommended number of training epochs based on dataset size.
+Follows Python UMAP heuristics: 500 for small datasets, 200 for large.
+
+```csharp
+public int RecommendedEpochs { get; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_DataShape_RecommendedNeighbors"></a> RecommendedNeighbors
+
+Recommended number of nearest neighbors based on dataset size.
+Follows Python UMAP heuristics: typically 15, but adjusted for very small datasets.
+
+```csharp
+public int RecommendedNeighbors { get; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_DataShape_Samples"></a> Samples
+
+Number of samples (rows) in the dataset.
+
+```csharp
+public required int Samples { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_DataShape_SparsityRatio"></a> SparsityRatio
+
+Sparsity ratio (proportion of zero elements) if applicable.
+Only meaningful when <xref href="Flowthru.Misc.ML.UMAP.Core.DataShape.IsSparse" data-throw-if-not-resolved="false"></xref> is true.
+
+```csharp
+public float? SparsityRatio { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)?
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Markers.IMetric.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Markers.IMetric.md
new file mode 100644
index 00000000..2d2f86a1
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Markers.IMetric.md
@@ -0,0 +1,110 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_Markers_IMetric"></a> Interface IMetric
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core.Markers](Flowthru.Misc.ML.UMAP.Core.Markers.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Base interface for distance metrics used in UMAP.
+Provides the fundamental distance computation between points in high-dimensional space.
+
+```csharp
+public interface IMetric
+```
+
+## Remarks
+
+<p>
+Metrics define how distances are measured in the input space during k-NN search
+and graph construction. Different metrics capture different notions of similarity.
+</p>
+<p>
+Common implementations: Euclidean (L2), Manhattan (L1), Cosine (angular).
+</p>
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Markers_IMetric_DisconnectionDistance"></a> DisconnectionDistance
+
+Maximum meaningful distance for bounded metrics, or null for unbounded metrics.
+Used to handle disconnected components in the k-NN graph.
+
+```csharp
+float? DisconnectionDistance { get; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)?
+
+#### Remarks
+
+<p>
+Examples:
+- Euclidean: null (unbounded)
+- Cosine: 2.0 (ranges from 0 to 2)
+- Jaccard: 1.0 (ranges from 0 to 1)
+</p>
+<p>
+When set, distances at or beyond this value indicate maximally dissimilar points
+that should be treated as disconnected in the manifold approximation.
+</p>
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Markers_IMetric_Name"></a> Name
+
+Human-readable name of the metric (e.g., "euclidean", "cosine").
+Used for logging and serialization.
+
+```csharp
+string Name { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Markers_IMetric_SupportsAngularProjection"></a> SupportsAngularProjection
+
+Whether this metric benefits from angular (cosine-based) random projection forests.
+Angular metrics (cosine, correlation) use different RP tree splits than Euclidean metrics.
+
+```csharp
+bool SupportsAngularProjection { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Markers_IMetric_Distance_System_ReadOnlySpan_System_Single__System_ReadOnlySpan_System_Single__"></a> Distance\(ReadOnlySpan<float\>, ReadOnlySpan<float\>\)
+
+Compute the distance between two points.
+
+```csharp
+float Distance(ReadOnlySpan<float> x, ReadOnlySpan<float> y)
+```
+
+#### Parameters
+
+`x` [ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+First point
+
+`y` [ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Second point
+
+#### Returns
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+Distance value (non-negative)
+
+#### Remarks
+
+Must satisfy metric properties:
+- Non-negativity: Distance(x, y) ≥ 0
+- Identity: Distance(x, x) = 0
+- Symmetry: Distance(x, y) = Distance(y, x)
+- Triangle inequality: Distance(x, z) ≤ Distance(x, y) + Distance(y, z)
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Markers.IOutputMetric.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Markers.IOutputMetric.md
new file mode 100644
index 00000000..73e7e28c
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Markers.IOutputMetric.md
@@ -0,0 +1,71 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_Markers_IOutputMetric"></a> Interface IOutputMetric
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core.Markers](Flowthru.Misc.ML.UMAP.Core.Markers.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Output space metric that provides distance gradients for layout optimization.
+Required for embedding into non-Euclidean spaces (spherical, hyperbolic, toroidal, etc.).
+
+```csharp
+public interface IOutputMetric : IMetric
+```
+
+#### Implements
+
+[IMetric](Flowthru.Misc.ML.UMAP.Core.Markers.IMetric.md)
+
+## Remarks
+
+<p>
+During layout optimization (SGD phase), UMAP needs both the distance and its gradient
+to update point positions. Standard Euclidean SGD has a specialized, highly optimized
+implementation. For other output spaces, the generic SGD implementation requires gradients.
+</p>
+<p>
+Examples of non-Euclidean output spaces:
+- Spherical (haversine distance): Embeddings constrained to sphere surface
+- Hyperbolic (Poincaré/hyperboloid): For hierarchical data
+- Toroidal (wrap-around): For periodic data
+</p>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Markers_IOutputMetric_DistanceWithGradient_System_ReadOnlySpan_System_Single__System_ReadOnlySpan_System_Single__System_Single__System_Span_System_Single__"></a> DistanceWithGradient\(ReadOnlySpan<float\>, ReadOnlySpan<float\>, out float, Span<float\>\)
+
+Compute distance and its gradient with respect to the first argument.
+Used during stochastic gradient descent to optimize the embedding layout.
+
+```csharp
+void DistanceWithGradient(ReadOnlySpan<float> x, ReadOnlySpan<float> y, out float distance, Span<float> gradient)
+```
+
+#### Parameters
+
+`x` [ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+First point (the point being optimized)
+
+`y` [ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Second point (reference/anchor point)
+
+`distance` [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+Output: distance between x and y
+
+`gradient` [Span](https://learn.microsoft.com/dotnet/api/system.span\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Output: gradient of distance with respect to x (∂distance/∂x).
+Must be pre-allocated by caller with length equal to dimensionality.
+
+#### Remarks
+
+<p>
+The gradient represents the direction and magnitude of steepest increase in distance
+when moving x. During SGD, we use this to either attract or repel points.
+</p>
+<p>
+For Euclidean distance d = ||x - y||:
+- ∇d/∂x = (x - y) / ||x - y||
+</p>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Markers.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Markers.md
new file mode 100644
index 00000000..41013615
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Markers.md
@@ -0,0 +1,14 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_Markers"></a> Namespace Flowthru.Misc.ML.UMAP.Core.Markers
+
+### Interfaces
+
+ [IMetric](Flowthru.Misc.ML.UMAP.Core.Markers.IMetric.md)
+
+Base interface for distance metrics used in UMAP.
+Provides the fundamental distance computation between points in high-dimensional space.
+
+ [IOutputMetric](Flowthru.Misc.ML.UMAP.Core.Markers.IOutputMetric.md)
+
+Output space metric that provides distance gradients for layout optimization.
+Required for embedding into non-Euclidean spaces (spherical, hyperbolic, toroidal, etc.).
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapFitResult.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapFitResult.md
new file mode 100644
index 00000000..32a4531b
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapFitResult.md
@@ -0,0 +1,141 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_UmapFitResult"></a> Class UmapFitResult
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core](Flowthru.Misc.ML.UMAP.Core.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Result of the complete UMAP FitTransform operation.
+Contains the final embedding and all intermediate results.
+
+```csharp
+public sealed record UmapFitResult : IEquatable<UmapFitResult>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[UmapFitResult](Flowthru.Misc.ML.UMAP.Core.UmapFitResult.md)
+
+#### Implements
+
+[IEquatable<UmapFitResult\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Constructors
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFitResult__ctor_MathNet_Numerics_LinearAlgebra_Matrix_System_Single__Flowthru_Misc_ML_UMAP_Core_UmapGraphResult_Flowthru_Misc_ML_UMAP_Strategies_LayoutInit_LayoutInitResult_Flowthru_Misc_ML_UMAP_Strategies_SamplingSchedule_SamplingScheduleResult_Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_LayoutOptimizationResult_Flowthru_Misc_ML_UMAP_Core_UmapRuntimeReport_"></a> UmapFitResult\(Matrix<float\>, UmapGraphResult, LayoutInitResult, SamplingScheduleResult, LayoutOptimizationResult, UmapRuntimeReport\)
+
+Result of the complete UMAP FitTransform operation.
+Contains the final embedding and all intermediate results.
+
+```csharp
+public UmapFitResult(Matrix<float> Embedding, UmapGraphResult GraphResult, LayoutInitResult LayoutInitResult, SamplingScheduleResult SamplingScheduleResult, LayoutOptimizationResult OptimizationResult, UmapRuntimeReport RuntimeReport)
+```
+
+#### Parameters
+
+`Embedding` Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Final optimized low-dimensional embedding. Shape: (n_samples, n_components)
+
+`GraphResult` [UmapGraphResult](Flowthru.Misc.ML.UMAP.Core.UmapGraphResult.md)
+
+Intermediate result from graph construction (Phases 1-4).
+
+`LayoutInitResult` [LayoutInitResult](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.LayoutInitResult.md)
+
+Intermediate result from layout initialization (Phase 5).
+
+`SamplingScheduleResult` [SamplingScheduleResult](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.SamplingScheduleResult.md)
+
+Intermediate result from sampling schedule computation (Phase 6).
+
+`OptimizationResult` [LayoutOptimizationResult](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.LayoutOptimizationResult.md)
+
+Result from layout optimization (Phase 7).
+
+`RuntimeReport` [UmapRuntimeReport](Flowthru.Misc.ML.UMAP.Core.UmapRuntimeReport.md)
+
+Performance timing metrics for each UMAP phase.
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFitResult_Embedding"></a> Embedding
+
+Final optimized low-dimensional embedding. Shape: (n_samples, n_components)
+
+```csharp
+public Matrix<float> Embedding { get; init; }
+```
+
+#### Property Value
+
+ Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFitResult_GraphResult"></a> GraphResult
+
+Intermediate result from graph construction (Phases 1-4).
+
+```csharp
+public UmapGraphResult GraphResult { get; init; }
+```
+
+#### Property Value
+
+ [UmapGraphResult](Flowthru.Misc.ML.UMAP.Core.UmapGraphResult.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFitResult_LayoutInitResult"></a> LayoutInitResult
+
+Intermediate result from layout initialization (Phase 5).
+
+```csharp
+public LayoutInitResult LayoutInitResult { get; init; }
+```
+
+#### Property Value
+
+ [LayoutInitResult](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.LayoutInitResult.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFitResult_OptimizationResult"></a> OptimizationResult
+
+Result from layout optimization (Phase 7).
+
+```csharp
+public LayoutOptimizationResult OptimizationResult { get; init; }
+```
+
+#### Property Value
+
+ [LayoutOptimizationResult](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.LayoutOptimizationResult.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFitResult_RuntimeReport"></a> RuntimeReport
+
+Performance timing metrics for each UMAP phase.
+
+```csharp
+public UmapRuntimeReport RuntimeReport { get; init; }
+```
+
+#### Property Value
+
+ [UmapRuntimeReport](Flowthru.Misc.ML.UMAP.Core.UmapRuntimeReport.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFitResult_SamplingScheduleResult"></a> SamplingScheduleResult
+
+Intermediate result from sampling schedule computation (Phase 6).
+
+```csharp
+public SamplingScheduleResult SamplingScheduleResult { get; init; }
+```
+
+#### Property Value
+
+ [SamplingScheduleResult](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.SamplingScheduleResult.md)
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md
new file mode 100644
index 00000000..8e98313c
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md
@@ -0,0 +1,220 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder"></a> Class UmapFlowBuilder
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core](Flowthru.Misc.ML.UMAP.Core.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+```csharp
+public sealed class UmapFlowBuilder
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_FitTransform_System_Single_____"></a> FitTransform\(float\[\]\[\]\)
+
+Fits UMAP and transforms data in one step.
+Auto-selects strategies based on data characteristics if not explicitly set.
+
+```csharp
+public float[][] FitTransform(float[][] data)
+```
+
+#### Parameters
+
+`data` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]\[\]
+
+Input data as jagged array (n_samples, n_features)
+
+#### Returns
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]\[\]
+
+Low-dimensional embedding (n_samples, n_components)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_FitTransform_MathNet_Numerics_LinearAlgebra_Matrix_System_Single__"></a> FitTransform\(Matrix<float\>\)
+
+Fits UMAP and transforms data in one step.
+Auto-selects strategies based on data characteristics if not explicitly set.
+
+```csharp
+public Matrix<float> FitTransform(Matrix<float> data)
+```
+
+#### Parameters
+
+`data` Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Input data matrix (n_samples, n_features)
+
+#### Returns
+
+ Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Low-dimensional embedding (n_samples, n_components)
+
+#### Remarks
+
+TODO: Consider deprecating this overload. Matrix&lt;float&gt; adds virtual call overhead
+and intermediate allocations compared to float[][]. Only kept for compatibility with
+SpectralInit which uses Math.Net for eigenvalue decomposition.
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_FitTransformWithReport_MathNet_Numerics_LinearAlgebra_Matrix_System_Single__"></a> FitTransformWithReport\(Matrix<float\>\)
+
+Fits UMAP and transforms data in one step, returning full result including runtime report.
+Auto-selects strategies based on data characteristics if not explicitly set.
+
+```csharp
+public UmapFitResult FitTransformWithReport(Matrix<float> data)
+```
+
+#### Parameters
+
+`data` Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Input data matrix (n_samples, n_features)
+
+#### Returns
+
+ [UmapFitResult](Flowthru.Misc.ML.UMAP.Core.UmapFitResult.md)
+
+Complete UMAP result including embedding and runtime metrics
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithGraphRefinement_Flowthru_Misc_ML_UMAP_Strategies_GraphRefinement_IGraphRefinementStrategy_"></a> WithGraphRefinement\(IGraphRefinementStrategy\)
+
+```csharp
+public UmapFlowBuilder WithGraphRefinement(IGraphRefinementStrategy strategy)
+```
+
+#### Parameters
+
+`strategy` [IGraphRefinementStrategy](Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.IGraphRefinementStrategy.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithInputMetric_Flowthru_Misc_ML_UMAP_Core_Markers_IMetric_"></a> WithInputMetric\(IMetric\)
+
+```csharp
+public UmapFlowBuilder WithInputMetric(IMetric metric)
+```
+
+#### Parameters
+
+`metric` [IMetric](Flowthru.Misc.ML.UMAP.Core.Markers.IMetric.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithLayoutInit_Flowthru_Misc_ML_UMAP_Strategies_LayoutInit_ILayoutInitStrategy_"></a> WithLayoutInit\(ILayoutInitStrategy\)
+
+```csharp
+public UmapFlowBuilder WithLayoutInit(ILayoutInitStrategy strategy)
+```
+
+#### Parameters
+
+`strategy` [ILayoutInitStrategy](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.ILayoutInitStrategy.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithLayoutOptimization_Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_ILayoutOptimizationStrategy_"></a> WithLayoutOptimization\(ILayoutOptimizationStrategy\)
+
+```csharp
+public UmapFlowBuilder WithLayoutOptimization(ILayoutOptimizationStrategy strategy)
+```
+
+#### Parameters
+
+`strategy` [ILayoutOptimizationStrategy](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.ILayoutOptimizationStrategy.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithLocalMetric_Flowthru_Misc_ML_UMAP_Strategies_LocalMetric_ILocalMetricStrategy_"></a> WithLocalMetric\(ILocalMetricStrategy\)
+
+```csharp
+public UmapFlowBuilder WithLocalMetric(ILocalMetricStrategy strategy)
+```
+
+#### Parameters
+
+`strategy` [ILocalMetricStrategy](Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.ILocalMetricStrategy.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithMembershipStrength_Flowthru_Misc_ML_UMAP_Strategies_MembershipStrength_IMembershipStrengthStrategy_"></a> WithMembershipStrength\(IMembershipStrengthStrategy\)
+
+```csharp
+public UmapFlowBuilder WithMembershipStrength(IMembershipStrengthStrategy strategy)
+```
+
+#### Parameters
+
+`strategy` [IMembershipStrengthStrategy](Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.IMembershipStrengthStrategy.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithNeighborSearch_Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_INeighborSearchStrategy_"></a> WithNeighborSearch\(INeighborSearchStrategy\)
+
+```csharp
+public UmapFlowBuilder WithNeighborSearch(INeighborSearchStrategy strategy)
+```
+
+#### Parameters
+
+`strategy` [INeighborSearchStrategy](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.INeighborSearchStrategy.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithOutputMetric_Flowthru_Misc_ML_UMAP_Core_Markers_IOutputMetric_"></a> WithOutputMetric\(IOutputMetric\)
+
+```csharp
+public UmapFlowBuilder WithOutputMetric(IOutputMetric metric)
+```
+
+#### Parameters
+
+`metric` [IOutputMetric](Flowthru.Misc.ML.UMAP.Core.Markers.IOutputMetric.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithSamplingSchedule_Flowthru_Misc_ML_UMAP_Strategies_SamplingSchedule_ISamplingScheduleStrategy_"></a> WithSamplingSchedule\(ISamplingScheduleStrategy\)
+
+```csharp
+public UmapFlowBuilder WithSamplingSchedule(ISamplingScheduleStrategy strategy)
+```
+
+#### Parameters
+
+`strategy` [ISamplingScheduleStrategy](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.ISamplingScheduleStrategy.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapGraphResult.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapGraphResult.md
new file mode 100644
index 00000000..fcd9b7af
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapGraphResult.md
@@ -0,0 +1,139 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_UmapGraphResult"></a> Class UmapGraphResult
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core](Flowthru.Misc.ML.UMAP.Core.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Result of computing the UMAP graph (phases 1-3).
+
+```csharp
+public sealed record UmapGraphResult : IEquatable<UmapGraphResult>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[UmapGraphResult](Flowthru.Misc.ML.UMAP.Core.UmapGraphResult.md)
+
+#### Implements
+
+[IEquatable<UmapGraphResult\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Constructors
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapGraphResult__ctor_MathNet_Numerics_LinearAlgebra_Single_SparseMatrix_System_Int32_____System_Single_____System_Single___System_Single___System_Object_"></a> UmapGraphResult\(SparseMatrix, int\[\]\[\], float\[\]\[\], float\[\], float\[\], object?\)
+
+Result of computing the UMAP graph (phases 1-3).
+
+```csharp
+public UmapGraphResult(SparseMatrix Graph, int[][] KnnIndices, float[][] KnnDistances, float[] Sigmas, float[] Rhos, object? SearchIndex)
+```
+
+#### Parameters
+
+`Graph` SparseMatrix
+
+Fuzzy simplicial set as a sparse symmetric matrix.
+
+`KnnIndices` [int](https://learn.microsoft.com/dotnet/api/system.int32)\[\]\[\]
+
+K-nearest neighbor indices for each point.
+
+`KnnDistances` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]\[\]
+
+K-nearest neighbor distances for each point.
+
+`Sigmas` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+Bandwidth parameters from local metric computation.
+
+`Rhos` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+Local connectivity distances from local metric computation.
+
+`SearchIndex` [object](https://learn.microsoft.com/dotnet/api/system.object)?
+
+Optional search index for transform operations.
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapGraphResult_Graph"></a> Graph
+
+Fuzzy simplicial set as a sparse symmetric matrix.
+
+```csharp
+public SparseMatrix Graph { get; init; }
+```
+
+#### Property Value
+
+ SparseMatrix
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapGraphResult_KnnDistances"></a> KnnDistances
+
+K-nearest neighbor distances for each point.
+
+```csharp
+public float[][] KnnDistances { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]\[\]
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapGraphResult_KnnIndices"></a> KnnIndices
+
+K-nearest neighbor indices for each point.
+
+```csharp
+public int[][] KnnIndices { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)\[\]\[\]
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapGraphResult_Rhos"></a> Rhos
+
+Local connectivity distances from local metric computation.
+
+```csharp
+public float[] Rhos { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapGraphResult_SearchIndex"></a> SearchIndex
+
+Optional search index for transform operations.
+
+```csharp
+public object? SearchIndex { get; init; }
+```
+
+#### Property Value
+
+ [object](https://learn.microsoft.com/dotnet/api/system.object)?
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapGraphResult_Sigmas"></a> Sigmas
+
+Bandwidth parameters from local metric computation.
+
+```csharp
+public float[] Sigmas { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapParameters.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapParameters.md
new file mode 100644
index 00000000..dbaad0a8
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapParameters.md
@@ -0,0 +1,341 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters"></a> Class UmapParameters
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core](Flowthru.Misc.ML.UMAP.Core.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Core parameters for UMAP algorithm configuration.
+These parameters control the mathematical behavior of the algorithm across all strategies.
+
+```csharp
+public sealed record UmapParameters : IEquatable<UmapParameters>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[UmapParameters](Flowthru.Misc.ML.UMAP.Core.UmapParameters.md)
+
+#### Implements
+
+[IEquatable<UmapParameters\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+This record contains the fundamental UMAP hyperparameters that affect the global
+structure of the embedding. Strategy-specific parameters are configured on individual
+strategy instances.
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_A"></a> A
+
+Curve fitting parameter 'a' for the low-dimensional fuzzy simplicial set.
+If null, automatically computed from <xref href="Flowthru.Misc.ML.UMAP.Core.UmapParameters.Spread" data-throw-if-not-resolved="false"></xref> and <xref href="Flowthru.Misc.ML.UMAP.Core.UmapParameters.MinDist" data-throw-if-not-resolved="false"></xref>.
+
+```csharp
+public float? A { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)?
+
+#### Remarks
+
+Default: null (auto-compute). Manual setting is for advanced use only.
+This parameter controls the attractive force curve in the embedding space.
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_B"></a> B
+
+Curve fitting parameter 'b' for the low-dimensional fuzzy simplicial set.
+If null, automatically computed from <xref href="Flowthru.Misc.ML.UMAP.Core.UmapParameters.Spread" data-throw-if-not-resolved="false"></xref> and <xref href="Flowthru.Misc.ML.UMAP.Core.UmapParameters.MinDist" data-throw-if-not-resolved="false"></xref>.
+
+```csharp
+public float? B { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)?
+
+#### Remarks
+
+Default: null (auto-compute). Manual setting is for advanced use only.
+This parameter controls the attractive force curve in the embedding space.
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_LearningRate"></a> LearningRate
+
+Initial learning rate for stochastic gradient descent.
+
+```csharp
+public float LearningRate { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+#### Remarks
+
+Default: 1.0. Range: (0, ∞). Typical values: 0.5-2.0.
+Learning rate decays linearly to 0 over training epochs.
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_LocalConnectivity"></a> LocalConnectivity
+
+Local connectivity required at the manifold level.
+Number of nearest neighbors assumed to be connected locally.
+
+```csharp
+public float LocalConnectivity { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+#### Remarks
+
+Default: 1.0. Range: [1, numberOfNeighbors]. Typical values: 1.0-5.0.
+Higher values increase local connectivity, making the manifold more connected.
+Should not exceed the local intrinsic dimension of the manifold.
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_MinDist"></a> MinDist
+
+Effective minimum distance between embedded points.
+Controls how tightly points are packed in clusters.
+
+```csharp
+public float MinDist { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+#### Remarks
+
+Default: 0.1. Range: [0, spread]. Typical values: 0.0-0.5.
+- 0.0: Dense, tightly packed clusters
+- 0.1: Balanced (default)
+- 0.3-0.5: More spread out, emphasizes separation
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_NegativeSampleRate"></a> NegativeSampleRate
+
+Number of negative samples per positive sample during optimization.
+
+```csharp
+public int NegativeSampleRate { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Remarks
+
+Default: 5. Range: [1, ∞). Typical values: 5-20.
+Higher values = stronger repulsive force but slower training.
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_NumberOfComponents"></a> NumberOfComponents
+
+Dimensionality of the target embedding space.
+
+```csharp
+public int NumberOfComponents { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Remarks
+
+Default: 2 (for visualization). Range: [1, ∞). Typical values: 2-100.
+- 2D: Visualization and exploratory analysis
+- 3D: Interactive 3D visualization
+- Higher: Feature extraction, downstream ML tasks
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_NumberOfEpochs"></a> NumberOfEpochs
+
+Number of optimization epochs (training iterations).
+If null, automatically determined based on dataset size.
+
+```csharp
+public int? NumberOfEpochs { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)?
+
+#### Remarks
+
+Default: null (auto). If set, range: [0, ∞). Auto values: 500 (small data), 200 (large data).
+More epochs = better convergence but longer training time.
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_NumberOfNeighbors"></a> NumberOfNeighbors
+
+Number of nearest neighbors to consider for manifold approximation.
+Larger values result in more global structure, smaller values preserve local details.
+
+```csharp
+public int NumberOfNeighbors { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Remarks
+
+Default: 15. Range: [2, ∞). Typical values: 5-50.
+- Small values (5-10): Emphasize local structure, fine details
+- Medium values (15-30): Balanced local and global structure
+- Large values (50+): Emphasize global structure, may lose fine details
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_ProgressReporter"></a> ProgressReporter
+
+Optional progress reporter for programmatic progress tracking.
+
+```csharp
+public IProgress<UmapProgress>? ProgressReporter { get; init; }
+```
+
+#### Property Value
+
+ [IProgress](https://learn.microsoft.com/dotnet/api/system.iprogress\-1)<[UmapProgress](Flowthru.Misc.ML.UMAP.Core.UmapProgress.md)\>?
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_RandomSeed"></a> RandomSeed
+
+Random seed for reproducible results.
+If null, uses non-deterministic randomization.
+
+```csharp
+public int? RandomSeed { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)?
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_RepulsionStrength"></a> RepulsionStrength
+
+Weight applied to negative samples in optimization.
+Controls repulsive force between non-neighboring points.
+
+```csharp
+public float RepulsionStrength { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+#### Remarks
+
+Default: 1.0. Range: [0, ∞). Typical values: 0.5-2.0.
+- Lower values: Less repulsion, denser embedding
+- Higher values: More repulsion, more spread out
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_SetOpMixRatio"></a> SetOpMixRatio
+
+Interpolation between fuzzy union and intersection for combining local simplicial sets.
+
+```csharp
+public float SetOpMixRatio { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+#### Remarks
+
+Default: 1.0 (pure fuzzy union). Range: [0, 1].
+- 1.0: Pure fuzzy union (standard UMAP)
+- 0.0: Pure fuzzy intersection (more conservative connectivity)
+- 0.5: Balanced between union and intersection
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_Spread"></a> Spread
+
+Effective scale of embedded points.
+Works with <xref href="Flowthru.Misc.ML.UMAP.Core.UmapParameters.MinDist" data-throw-if-not-resolved="false"></xref> to control clustering vs. dispersion.
+
+```csharp
+public float Spread { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+#### Remarks
+
+Default: 1.0. Range: (0, ∞). Typical values: 0.5-2.0.
+Controls the overall scale at which embedded points spread out.
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_Verbosity"></a> Verbosity
+
+Verbosity level for progress reporting.
+
+```csharp
+public int Verbosity { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Remarks
+
+0 = Silent, 1 = Basic progress, 2 = Detailed progress
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_GetA"></a> GetA\(\)
+
+Gets the curve parameter 'a', computing it from spread and min_dist if not explicitly set.
+
+```csharp
+public float GetA()
+```
+
+#### Returns
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_GetB"></a> GetB\(\)
+
+Gets the curve parameter 'b', computing it from spread and min_dist if not explicitly set.
+
+```csharp
+public float GetB()
+```
+
+#### Returns
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapParameters_Validate"></a> Validate\(\)
+
+Validates the parameters and throws if any are invalid.
+
+```csharp
+public void Validate()
+```
+
+#### Exceptions
+
+ [ArgumentException](https://learn.microsoft.com/dotnet/api/system.argumentexception)
+
+Thrown when parameters are out of valid ranges.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapPipeline.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapPipeline.md
new file mode 100644
index 00000000..e21e76b3
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapPipeline.md
@@ -0,0 +1,70 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_UmapPipeline"></a> Class UmapPipeline
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core](Flowthru.Misc.ML.UMAP.Core.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Fluent builder for UMAP pipelines with automatic strategy selection.
+
+```csharp
+public static class UmapPipeline
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[UmapPipeline](Flowthru.Misc.ML.UMAP.Core.UmapPipeline.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.MemberwiseClone\(\)](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+This provides a low skill floor (simple defaults) with a high skill ceiling (full customization).
+Strategies are resolved lazily at FitTransform() time based on data characteristics.
+</p>
+<p>
+<b>Usage patterns:</b>
+</p>
+<pre><code class="lang-csharp">// Beginner: Full auto-configuration (Euclidean metric)
+var result = UmapPipeline.Create().FitTransform(data);
+
+// Intermediate: Custom metric
+var result = UmapPipeline.Create()
+  .WithInputMetric(CosineMetric.Instance)
+  .FitTransform(data);
+
+// Advanced: Custom strategies for testing/benchmarking
+var result = UmapPipeline.Create()
+  .WithNeighborSearch(new NNDescentSearch { MaxIterations = 50 })
+  .FitTransform(data);</code></pre>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapPipeline_Create_Flowthru_Misc_ML_UMAP_Core_UmapParameters_"></a> Create\(UmapParameters?\)
+
+Creates a new UMAP pipeline with default settings.
+Euclidean metric is used by default, and strategies will be auto-selected based on data shape.
+
+```csharp
+public static UmapFlowBuilder Create(UmapParameters? parameters = null)
+```
+
+#### Parameters
+
+`parameters` [UmapParameters](Flowthru.Misc.ML.UMAP.Core.UmapParameters.md)?
+
+UMAP hyperparameters (n_neighbors, min_dist, etc.).
+If null, uses defaults appropriate for the data.
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapPipelineBuilder.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapPipelineBuilder.md
new file mode 100644
index 00000000..7addc9a5
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapPipelineBuilder.md
@@ -0,0 +1,220 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder"></a> Class UmapFlowBuilder
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core](Flowthru.Misc.ML.UMAP.Core.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+```csharp
+public sealed class UmapFlowBuilder
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_FitTransform_System_Single_____"></a> FitTransform\(float\[\]\[\]\)
+
+Fits UMAP and transforms data in one step.
+Auto-selects strategies based on data characteristics if not explicitly set.
+
+```csharp
+public float[][] FitTransform(float[][] data)
+```
+
+#### Parameters
+
+`data` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]\[\]
+
+Input data as jagged array (n_samples, n_features)
+
+#### Returns
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]\[\]
+
+Low-dimensional embedding (n_samples, n_components)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_FitTransform_MathNet_Numerics_LinearAlgebra_Matrix_System_Single__"></a> FitTransform\(Matrix<float\>\)
+
+Fits UMAP and transforms data in one step.
+Auto-selects strategies based on data characteristics if not explicitly set.
+
+```csharp
+public Matrix<float> FitTransform(Matrix<float> data)
+```
+
+#### Parameters
+
+`data` Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Input data matrix (n_samples, n_features)
+
+#### Returns
+
+ Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Low-dimensional embedding (n_samples, n_components)
+
+#### Remarks
+
+TODO: Consider deprecating this overload. Matrix&lt;float&gt; adds virtual call overhead
+and intermediate allocations compared to float[][]. Only kept for compatibility with
+SpectralInit which uses Math.Net for eigenvalue decomposition.
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_FitTransformWithReport_MathNet_Numerics_LinearAlgebra_Matrix_System_Single__"></a> FitTransformWithReport\(Matrix<float\>\)
+
+Fits UMAP and transforms data in one step, returning full result including runtime report.
+Auto-selects strategies based on data characteristics if not explicitly set.
+
+```csharp
+public UmapFitResult FitTransformWithReport(Matrix<float> data)
+```
+
+#### Parameters
+
+`data` Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Input data matrix (n_samples, n_features)
+
+#### Returns
+
+ [UmapFitResult](Flowthru.Misc.ML.UMAP.Core.UmapFitResult.md)
+
+Complete UMAP result including embedding and runtime metrics
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithGraphRefinement_Flowthru_Misc_ML_UMAP_Strategies_GraphRefinement_IGraphRefinementStrategy_"></a> WithGraphRefinement\(IGraphRefinementStrategy\)
+
+```csharp
+public UmapFlowBuilder WithGraphRefinement(IGraphRefinementStrategy strategy)
+```
+
+#### Parameters
+
+`strategy` [IGraphRefinementStrategy](Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.IGraphRefinementStrategy.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithInputMetric_Flowthru_Misc_ML_UMAP_Core_Markers_IMetric_"></a> WithInputMetric\(IMetric\)
+
+```csharp
+public UmapFlowBuilder WithInputMetric(IMetric metric)
+```
+
+#### Parameters
+
+`metric` [IMetric](Flowthru.Misc.ML.UMAP.Core.Markers.IMetric.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithLayoutInit_Flowthru_Misc_ML_UMAP_Strategies_LayoutInit_ILayoutInitStrategy_"></a> WithLayoutInit\(ILayoutInitStrategy\)
+
+```csharp
+public UmapFlowBuilder WithLayoutInit(ILayoutInitStrategy strategy)
+```
+
+#### Parameters
+
+`strategy` [ILayoutInitStrategy](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.ILayoutInitStrategy.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithLayoutOptimization_Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_ILayoutOptimizationStrategy_"></a> WithLayoutOptimization\(ILayoutOptimizationStrategy\)
+
+```csharp
+public UmapFlowBuilder WithLayoutOptimization(ILayoutOptimizationStrategy strategy)
+```
+
+#### Parameters
+
+`strategy` [ILayoutOptimizationStrategy](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.ILayoutOptimizationStrategy.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithLocalMetric_Flowthru_Misc_ML_UMAP_Strategies_LocalMetric_ILocalMetricStrategy_"></a> WithLocalMetric\(ILocalMetricStrategy\)
+
+```csharp
+public UmapFlowBuilder WithLocalMetric(ILocalMetricStrategy strategy)
+```
+
+#### Parameters
+
+`strategy` [ILocalMetricStrategy](Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.ILocalMetricStrategy.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithMembershipStrength_Flowthru_Misc_ML_UMAP_Strategies_MembershipStrength_IMembershipStrengthStrategy_"></a> WithMembershipStrength\(IMembershipStrengthStrategy\)
+
+```csharp
+public UmapFlowBuilder WithMembershipStrength(IMembershipStrengthStrategy strategy)
+```
+
+#### Parameters
+
+`strategy` [IMembershipStrengthStrategy](Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.IMembershipStrengthStrategy.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithNeighborSearch_Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_INeighborSearchStrategy_"></a> WithNeighborSearch\(INeighborSearchStrategy\)
+
+```csharp
+public UmapFlowBuilder WithNeighborSearch(INeighborSearchStrategy strategy)
+```
+
+#### Parameters
+
+`strategy` [INeighborSearchStrategy](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.INeighborSearchStrategy.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithOutputMetric_Flowthru_Misc_ML_UMAP_Core_Markers_IOutputMetric_"></a> WithOutputMetric\(IOutputMetric\)
+
+```csharp
+public UmapFlowBuilder WithOutputMetric(IOutputMetric metric)
+```
+
+#### Parameters
+
+`metric` [IOutputMetric](Flowthru.Misc.ML.UMAP.Core.Markers.IOutputMetric.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapFlowBuilder_WithSamplingSchedule_Flowthru_Misc_ML_UMAP_Strategies_SamplingSchedule_ISamplingScheduleStrategy_"></a> WithSamplingSchedule\(ISamplingScheduleStrategy\)
+
+```csharp
+public UmapFlowBuilder WithSamplingSchedule(ISamplingScheduleStrategy strategy)
+```
+
+#### Parameters
+
+`strategy` [ISamplingScheduleStrategy](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.ISamplingScheduleStrategy.md)
+
+#### Returns
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapProgress.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapProgress.md
new file mode 100644
index 00000000..d152f2ff
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapProgress.md
@@ -0,0 +1,91 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_UmapProgress"></a> Class UmapProgress
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core](Flowthru.Misc.ML.UMAP.Core.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Progress information reported during UMAP execution.
+
+```csharp
+public sealed record UmapProgress : IEquatable<UmapProgress>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[UmapProgress](Flowthru.Misc.ML.UMAP.Core.UmapProgress.md)
+
+#### Implements
+
+[IEquatable<UmapProgress\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapProgress_CurrentEpoch"></a> CurrentEpoch
+
+Current epoch number, if applicable (during optimization).
+
+```csharp
+public int? CurrentEpoch { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)?
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapProgress_Details"></a> Details
+
+Optional detailed status message.
+
+```csharp
+public string? Details { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)?
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapProgress_Progress"></a> Progress
+
+Progress within the current stage as a fraction [0.0, 1.0].
+
+```csharp
+public required float Progress { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapProgress_Stage"></a> Stage
+
+Name of the current pipeline stage (e.g., "K-NN", "Graph Construction", "Optimization").
+
+```csharp
+public required string Stage { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapProgress_TotalEpochs"></a> TotalEpochs
+
+Total number of epochs, if applicable (during optimization).
+
+```csharp
+public int? TotalEpochs { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)?
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapRuntimeReport.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapRuntimeReport.md
new file mode 100644
index 00000000..de36a588
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.UmapRuntimeReport.md
@@ -0,0 +1,76 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_UmapRuntimeReport"></a> Class UmapRuntimeReport
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core](Flowthru.Misc.ML.UMAP.Core.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Runtime performance report for UMAP execution.
+
+```csharp
+public sealed record UmapRuntimeReport : IEquatable<UmapRuntimeReport>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[UmapRuntimeReport](Flowthru.Misc.ML.UMAP.Core.UmapRuntimeReport.md)
+
+#### Implements
+
+[IEquatable<UmapRuntimeReport\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Generic schema capturing timing metrics for each UMAP algorithmic phase.
+Does not include Flowthru serialization markers to keep it framework-agnostic.
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapRuntimeReport_Timings"></a> Timings
+
+Timing measurements for each UMAP phase.
+Key is the stage name, value is elapsed time in milliseconds.
+
+```csharp
+public Dictionary<string, int> Timings { get; init; }
+```
+
+#### Property Value
+
+ [Dictionary](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary\-2)<[string](https://learn.microsoft.com/dotnet/api/system.string), [int](https://learn.microsoft.com/dotnet/api/system.int32)\>
+
+#### Remarks
+
+Expected stages:
+- "NeighborSearch" - Phase 1: k-NN graph construction
+- "LocalMetric" - Phase 2: Local metric parameter computation
+- "GraphConstruction" - Phase 3: Fuzzy simplicial set construction
+- "GraphRefinement" - Phase 4: Graph refinement (optional)
+- "LayoutInit" - Phase 5: Low-dimensional layout initialization
+- "SamplingSchedule" - Phase 6: Edge sampling schedule computation
+- "LayoutOptimization" - Phase 7: Stochastic gradient descent optimization
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_UmapRuntimeReport_TotalTimeMs"></a> TotalTimeMs
+
+Total elapsed time for the complete FitTransform operation, in milliseconds.
+
+```csharp
+public int TotalTimeMs { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Remarks
+
+Sum of all individual phase timings. Useful for quick performance assessment.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Utils.CosineMetric.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Utils.CosineMetric.md
new file mode 100644
index 00000000..461ef9a9
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Utils.CosineMetric.md
@@ -0,0 +1,124 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_Utils_CosineMetric"></a> Class CosineMetric
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core.Utils](Flowthru.Misc.ML.UMAP.Core.Utils.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Cosine distance metric (angular distance).
+
+```csharp
+public sealed class CosineMetric : IMetric
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[CosineMetric](Flowthru.Misc.ML.UMAP.Core.Utils.CosineMetric.md)
+
+#### Implements
+
+[IMetric](Flowthru.Misc.ML.UMAP.Core.Markers.IMetric.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Cosine distance measures the angle between vectors:
+d(x, y) = 1 - (x·y) / (||x|| ||y||)
+
+Range: [0, 2] where 0 = identical direction, 1 = orthogonal, 2 = opposite direction.
+Ignores magnitude, only considers direction.
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_CosineMetric_DisconnectionDistance"></a> DisconnectionDistance
+
+Maximum meaningful distance for bounded metrics, or null for unbounded metrics.
+Used to handle disconnected components in the k-NN graph.
+
+```csharp
+public float? DisconnectionDistance { get; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)?
+
+#### Remarks
+
+<p>
+Examples:
+- Euclidean: null (unbounded)
+- Cosine: 2.0 (ranges from 0 to 2)
+- Jaccard: 1.0 (ranges from 0 to 1)
+</p>
+<p>
+When set, distances at or beyond this value indicate maximally dissimilar points
+that should be treated as disconnected in the manifold approximation.
+</p>
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_CosineMetric_Instance"></a> Instance
+
+Singleton instance of Cosine metric.
+Use this to avoid allocations.
+
+```csharp
+public static CosineMetric Instance { get; }
+```
+
+#### Property Value
+
+ [CosineMetric](Flowthru.Misc.ML.UMAP.Core.Utils.CosineMetric.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_CosineMetric_Name"></a> Name
+
+Human-readable name of the metric (e.g., "euclidean", "cosine").
+Used for logging and serialization.
+
+```csharp
+public string Name { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_CosineMetric_SupportsAngularProjection"></a> SupportsAngularProjection
+
+Whether this metric benefits from angular (cosine-based) random projection forests.
+Angular metrics (cosine, correlation) use different RP tree splits than Euclidean metrics.
+
+```csharp
+public bool SupportsAngularProjection { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_CosineMetric_Distance_System_ReadOnlySpan_System_Single__System_ReadOnlySpan_System_Single__"></a> Distance\(ReadOnlySpan<float\>, ReadOnlySpan<float\>\)
+
+Compute cosine distance: 1 - (dot product / product of norms).
+
+```csharp
+public float Distance(ReadOnlySpan<float> x, ReadOnlySpan<float> y)
+```
+
+#### Parameters
+
+`x` [ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+`y` [ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+#### Returns
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Utils.CustomMetric.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Utils.CustomMetric.md
new file mode 100644
index 00000000..8113125d
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Utils.CustomMetric.md
@@ -0,0 +1,150 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_Utils_CustomMetric"></a> Class CustomMetric
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core.Utils](Flowthru.Misc.ML.UMAP.Core.Utils.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Custom metric wrapper for user-defined distance functions.
+
+```csharp
+public sealed class CustomMetric : IMetric
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[CustomMetric](Flowthru.Misc.ML.UMAP.Core.Utils.CustomMetric.md)
+
+#### Implements
+
+[IMetric](Flowthru.Misc.ML.UMAP.Core.Markers.IMetric.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Allows users to provide arbitrary distance functions while maintaining
+the IMetric interface contract. Useful for experimentation and custom metrics.
+
+## Constructors
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_CustomMetric__ctor_System_String_System_Func_System_ReadOnlySpan_System_Single__System_ReadOnlySpan_System_Single__System_Single__System_Nullable_System_Single__System_Boolean_"></a> CustomMetric\(string, Func<ReadOnlySpan<float\>, ReadOnlySpan<float\>, float\>, float?, bool\)
+
+Creates a custom metric from a distance function.
+
+```csharp
+public CustomMetric(string name, Func<ReadOnlySpan<float>, ReadOnlySpan<float>, float> distanceFunc, float? disconnectionDistance = null, bool supportsAngularProjection = false)
+```
+
+#### Parameters
+
+`name` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Human-readable name for the metric
+
+`distanceFunc` [Func](https://learn.microsoft.com/dotnet/api/system.func\-3)<[ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>, [ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>, [float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Function computing distance between two points
+
+`disconnectionDistance` [float](https://learn.microsoft.com/dotnet/api/system.single)?
+
+Optional maximum distance for bounded metrics
+
+`supportsAngularProjection` [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+Whether angular RP forests benefit this metric
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_CustomMetric_DisconnectionDistance"></a> DisconnectionDistance
+
+Maximum meaningful distance for bounded metrics, or null for unbounded metrics.
+Used to handle disconnected components in the k-NN graph.
+
+```csharp
+public float? DisconnectionDistance { get; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)?
+
+#### Remarks
+
+<p>
+Examples:
+- Euclidean: null (unbounded)
+- Cosine: 2.0 (ranges from 0 to 2)
+- Jaccard: 1.0 (ranges from 0 to 1)
+</p>
+<p>
+When set, distances at or beyond this value indicate maximally dissimilar points
+that should be treated as disconnected in the manifold approximation.
+</p>
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_CustomMetric_Name"></a> Name
+
+Human-readable name of the metric (e.g., "euclidean", "cosine").
+Used for logging and serialization.
+
+```csharp
+public string Name { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_CustomMetric_SupportsAngularProjection"></a> SupportsAngularProjection
+
+Whether this metric benefits from angular (cosine-based) random projection forests.
+Angular metrics (cosine, correlation) use different RP tree splits than Euclidean metrics.
+
+```csharp
+public bool SupportsAngularProjection { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_CustomMetric_Distance_System_ReadOnlySpan_System_Single__System_ReadOnlySpan_System_Single__"></a> Distance\(ReadOnlySpan<float\>, ReadOnlySpan<float\>\)
+
+Compute the distance between two points.
+
+```csharp
+public float Distance(ReadOnlySpan<float> x, ReadOnlySpan<float> y)
+```
+
+#### Parameters
+
+`x` [ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+First point
+
+`y` [ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Second point
+
+#### Returns
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+Distance value (non-negative)
+
+#### Remarks
+
+Must satisfy metric properties:
+- Non-negativity: Distance(x, y) ≥ 0
+- Identity: Distance(x, x) = 0
+- Symmetry: Distance(x, y) = Distance(y, x)
+- Triangle inequality: Distance(x, z) ≤ Distance(x, y) + Distance(y, z)
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Utils.EuclideanMetric.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Utils.EuclideanMetric.md
new file mode 100644
index 00000000..eb651979
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Utils.EuclideanMetric.md
@@ -0,0 +1,142 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_Utils_EuclideanMetric"></a> Class EuclideanMetric
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core.Utils](Flowthru.Misc.ML.UMAP.Core.Utils.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Euclidean (L2) distance metric with gradient support.
+
+```csharp
+public sealed class EuclideanMetric : IOutputMetric, IMetric
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[EuclideanMetric](Flowthru.Misc.ML.UMAP.Core.Utils.EuclideanMetric.md)
+
+#### Implements
+
+[IOutputMetric](Flowthru.Misc.ML.UMAP.Core.Markers.IOutputMetric.md), 
+[IMetric](Flowthru.Misc.ML.UMAP.Core.Markers.IMetric.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Euclidean distance is the straight-line distance in n-dimensional space:
+d(x, y) = sqrt(sum((x[i] - y[i])^2))
+
+This is the most common metric and has specialized optimizations in layout optimization.
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_EuclideanMetric_DisconnectionDistance"></a> DisconnectionDistance
+
+Maximum meaningful distance for bounded metrics, or null for unbounded metrics.
+Used to handle disconnected components in the k-NN graph.
+
+```csharp
+public float? DisconnectionDistance { get; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)?
+
+#### Remarks
+
+<p>
+Examples:
+- Euclidean: null (unbounded)
+- Cosine: 2.0 (ranges from 0 to 2)
+- Jaccard: 1.0 (ranges from 0 to 1)
+</p>
+<p>
+When set, distances at or beyond this value indicate maximally dissimilar points
+that should be treated as disconnected in the manifold approximation.
+</p>
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_EuclideanMetric_Instance"></a> Instance
+
+Singleton instance of Euclidean metric.
+Use this to avoid allocations.
+
+```csharp
+public static EuclideanMetric Instance { get; }
+```
+
+#### Property Value
+
+ [EuclideanMetric](Flowthru.Misc.ML.UMAP.Core.Utils.EuclideanMetric.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_EuclideanMetric_Name"></a> Name
+
+Human-readable name of the metric (e.g., "euclidean", "cosine").
+Used for logging and serialization.
+
+```csharp
+public string Name { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_EuclideanMetric_SupportsAngularProjection"></a> SupportsAngularProjection
+
+Whether this metric benefits from angular (cosine-based) random projection forests.
+Angular metrics (cosine, correlation) use different RP tree splits than Euclidean metrics.
+
+```csharp
+public bool SupportsAngularProjection { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_EuclideanMetric_Distance_System_ReadOnlySpan_System_Single__System_ReadOnlySpan_System_Single__"></a> Distance\(ReadOnlySpan<float\>, ReadOnlySpan<float\>\)
+
+Compute Euclidean distance: sqrt(sum of squared differences).
+
+```csharp
+public float Distance(ReadOnlySpan<float> x, ReadOnlySpan<float> y)
+```
+
+#### Parameters
+
+`x` [ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+`y` [ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+#### Returns
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_EuclideanMetric_DistanceWithGradient_System_ReadOnlySpan_System_Single__System_ReadOnlySpan_System_Single__System_Single__System_Span_System_Single__"></a> DistanceWithGradient\(ReadOnlySpan<float\>, ReadOnlySpan<float\>, out float, Span<float\>\)
+
+Compute Euclidean distance and its gradient: ∇d/∂x = (x - y) / ||x - y||
+
+```csharp
+public void DistanceWithGradient(ReadOnlySpan<float> x, ReadOnlySpan<float> y, out float distance, Span<float> gradient)
+```
+
+#### Parameters
+
+`x` [ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+`y` [ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+`distance` [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+`gradient` [Span](https://learn.microsoft.com/dotnet/api/system.span\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Utils.ManhattanMetric.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Utils.ManhattanMetric.md
new file mode 100644
index 00000000..26b68a7f
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Utils.ManhattanMetric.md
@@ -0,0 +1,123 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_Utils_ManhattanMetric"></a> Class ManhattanMetric
+
+Namespace: [Flowthru.Misc.ML.UMAP.Core.Utils](Flowthru.Misc.ML.UMAP.Core.Utils.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Manhattan (L1) distance metric.
+
+```csharp
+public sealed class ManhattanMetric : IMetric
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ManhattanMetric](Flowthru.Misc.ML.UMAP.Core.Utils.ManhattanMetric.md)
+
+#### Implements
+
+[IMetric](Flowthru.Misc.ML.UMAP.Core.Markers.IMetric.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+Manhattan distance is the sum of absolute differences:
+d(x, y) = sum(|x[i] - y[i]|)
+
+Also known as taxicab or city block distance.
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_ManhattanMetric_DisconnectionDistance"></a> DisconnectionDistance
+
+Maximum meaningful distance for bounded metrics, or null for unbounded metrics.
+Used to handle disconnected components in the k-NN graph.
+
+```csharp
+public float? DisconnectionDistance { get; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)?
+
+#### Remarks
+
+<p>
+Examples:
+- Euclidean: null (unbounded)
+- Cosine: 2.0 (ranges from 0 to 2)
+- Jaccard: 1.0 (ranges from 0 to 1)
+</p>
+<p>
+When set, distances at or beyond this value indicate maximally dissimilar points
+that should be treated as disconnected in the manifold approximation.
+</p>
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_ManhattanMetric_Instance"></a> Instance
+
+Singleton instance of Manhattan metric.
+Use this to avoid allocations.
+
+```csharp
+public static ManhattanMetric Instance { get; }
+```
+
+#### Property Value
+
+ [ManhattanMetric](Flowthru.Misc.ML.UMAP.Core.Utils.ManhattanMetric.md)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_ManhattanMetric_Name"></a> Name
+
+Human-readable name of the metric (e.g., "euclidean", "cosine").
+Used for logging and serialization.
+
+```csharp
+public string Name { get; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_ManhattanMetric_SupportsAngularProjection"></a> SupportsAngularProjection
+
+Whether this metric benefits from angular (cosine-based) random projection forests.
+Angular metrics (cosine, correlation) use different RP tree splits than Euclidean metrics.
+
+```csharp
+public bool SupportsAngularProjection { get; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Core_Utils_ManhattanMetric_Distance_System_ReadOnlySpan_System_Single__System_ReadOnlySpan_System_Single__"></a> Distance\(ReadOnlySpan<float\>, ReadOnlySpan<float\>\)
+
+Compute Manhattan distance: sum of absolute differences.
+
+```csharp
+public float Distance(ReadOnlySpan<float> x, ReadOnlySpan<float> y)
+```
+
+#### Parameters
+
+`x` [ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+`y` [ReadOnlySpan](https://learn.microsoft.com/dotnet/api/system.readonlyspan\-1)<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+#### Returns
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Utils.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Utils.md
new file mode 100644
index 00000000..d642538f
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.Utils.md
@@ -0,0 +1,20 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core_Utils"></a> Namespace Flowthru.Misc.ML.UMAP.Core.Utils
+
+### Classes
+
+ [CosineMetric](Flowthru.Misc.ML.UMAP.Core.Utils.CosineMetric.md)
+
+Cosine distance metric (angular distance).
+
+ [CustomMetric](Flowthru.Misc.ML.UMAP.Core.Utils.CustomMetric.md)
+
+Custom metric wrapper for user-defined distance functions.
+
+ [EuclideanMetric](Flowthru.Misc.ML.UMAP.Core.Utils.EuclideanMetric.md)
+
+Euclidean (L2) distance metric with gradient support.
+
+ [ManhattanMetric](Flowthru.Misc.ML.UMAP.Core.Utils.ManhattanMetric.md)
+
+Manhattan (L1) distance metric.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.md
new file mode 100644
index 00000000..31506551
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Core.md
@@ -0,0 +1,47 @@
+# <a id="Flowthru_Misc_ML_UMAP_Core"></a> Namespace Flowthru.Misc.ML.UMAP.Core
+
+### Namespaces
+
+ [Flowthru.Misc.ML.UMAP.Core.Markers](Flowthru.Misc.ML.UMAP.Core.Markers.md)
+
+ [Flowthru.Misc.ML.UMAP.Core.Utils](Flowthru.Misc.ML.UMAP.Core.Utils.md)
+
+### Classes
+
+ [CurveFitting](Flowthru.Misc.ML.UMAP.Core.CurveFitting.md)
+
+Helper for computing UMAP curve fitting parameters.
+
+ [DataShape](Flowthru.Misc.ML.UMAP.Core.DataShape.md)
+
+Describes the shape and characteristics of input data.
+Used by strategy factories to select appropriate default strategies.
+
+ [UmapFitResult](Flowthru.Misc.ML.UMAP.Core.UmapFitResult.md)
+
+Result of the complete UMAP FitTransform operation.
+Contains the final embedding and all intermediate results.
+
+ [UmapFlowBuilder](Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md)
+
+ [UmapGraphResult](Flowthru.Misc.ML.UMAP.Core.UmapGraphResult.md)
+
+Result of computing the UMAP graph (phases 1-3).
+
+ [UmapParameters](Flowthru.Misc.ML.UMAP.Core.UmapParameters.md)
+
+Core parameters for UMAP algorithm configuration.
+These parameters control the mathematical behavior of the algorithm across all strategies.
+
+ [UmapPipeline](Flowthru.Misc.ML.UMAP.Core.UmapPipeline.md)
+
+Fluent builder for UMAP pipelines with automatic strategy selection.
+
+ [UmapProgress](Flowthru.Misc.ML.UMAP.Core.UmapProgress.md)
+
+Progress information reported during UMAP execution.
+
+ [UmapRuntimeReport](Flowthru.Misc.ML.UMAP.Core.UmapRuntimeReport.md)
+
+Runtime performance report for UMAP execution.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.GraphRefinementResult.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.GraphRefinementResult.md
new file mode 100644
index 00000000..6a1feafa
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.GraphRefinementResult.md
@@ -0,0 +1,97 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_GraphRefinement_GraphRefinementResult"></a> Class GraphRefinementResult
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement](Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Result of graph refinement operation.
+
+```csharp
+public sealed record GraphRefinementResult : IEquatable<GraphRefinementResult>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[GraphRefinementResult](Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.GraphRefinementResult.md)
+
+#### Implements
+
+[IEquatable<GraphRefinementResult\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Constructors
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_GraphRefinement_GraphRefinementResult__ctor_MathNet_Numerics_LinearAlgebra_Single_SparseMatrix_System_Int32_System_Single_"></a> GraphRefinementResult\(SparseMatrix, int, float\)
+
+Result of graph refinement operation.
+
+```csharp
+public GraphRefinementResult(SparseMatrix RefinedGraph, int EdgesRemoved, float MinEdgeWeight)
+```
+
+#### Parameters
+
+`RefinedGraph` SparseMatrix
+
+The refined sparse graph with weak edges removed.
+Shape: (n_samples, n_samples)
+
+`EdgesRemoved` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of edges removed during refinement.
+Useful for diagnostics and logging.
+
+`MinEdgeWeight` [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+The minimum edge weight threshold that was applied.
+Edges below this value were removed.
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_GraphRefinement_GraphRefinementResult_EdgesRemoved"></a> EdgesRemoved
+
+Number of edges removed during refinement.
+Useful for diagnostics and logging.
+
+```csharp
+public int EdgesRemoved { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_GraphRefinement_GraphRefinementResult_MinEdgeWeight"></a> MinEdgeWeight
+
+The minimum edge weight threshold that was applied.
+Edges below this value were removed.
+
+```csharp
+public float MinEdgeWeight { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_GraphRefinement_GraphRefinementResult_RefinedGraph"></a> RefinedGraph
+
+The refined sparse graph with weak edges removed.
+Shape: (n_samples, n_samples)
+
+```csharp
+public SparseMatrix RefinedGraph { get; init; }
+```
+
+#### Property Value
+
+ SparseMatrix
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.IGraphRefinementStrategy.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.IGraphRefinementStrategy.md
new file mode 100644
index 00000000..f787006e
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.IGraphRefinementStrategy.md
@@ -0,0 +1,72 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_GraphRefinement_IGraphRefinementStrategy"></a> Interface IGraphRefinementStrategy
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement](Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Strategy interface for refining the fuzzy simplicial set graph before layout optimization.
+This is the fourth phase of the UMAP algorithm.
+
+```csharp
+public interface IGraphRefinementStrategy
+```
+
+## Remarks
+
+<p>
+The graph refinement phase prepares the fuzzy simplicial set for layout optimization by:
+</p>
+<ul><li>Pruning weak edges that would have minimal impact on optimization</li><li>Reducing memory footprint and computational cost</li><li>Improving numerical stability by removing near-zero weights</li></ul>
+<p>
+<b>Standard approach (adaptive thresholding):</b>
+</p>
+<p>
+Edges with weight below <code>max_weight / n_epochs</code> are removed, as they would be
+sampled less than once during optimization. This balances graph sparsity with fidelity.
+</p>
+<p>
+Python UMAP reference: Lines 1063-1076 in <code>simplicial_set_embedding()</code> function
+</p>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_GraphRefinement_IGraphRefinementStrategy_RefineGraph_MathNet_Numerics_LinearAlgebra_Single_SparseMatrix_System_Int32_"></a> RefineGraph\(SparseMatrix, int\)
+
+Refines the fuzzy simplicial set by pruning weak edges and normalizing edge weights.
+
+```csharp
+GraphRefinementResult RefineGraph(SparseMatrix graph, int nEpochs)
+```
+
+#### Parameters
+
+`graph` SparseMatrix
+
+Input fuzzy simplicial set as a sparse symmetric matrix.
+Shape: (n_samples, n_samples)
+This matrix may be modified in-place for efficiency.
+
+`nEpochs` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of optimization epochs planned for layout optimization.
+Used to determine the minimum edge weight threshold - edges sampled less than
+once during optimization can be safely removed.
+Must be positive.
+
+#### Returns
+
+ [GraphRefinementResult](Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.GraphRefinementResult.md)
+
+A refined sparse graph with weak edges removed and remaining edges normalized.
+May return the same instance as input if modified in-place.
+
+#### Remarks
+
+<p>
+<b>Implementation requirements:</b>
+</p>
+<ol><li>Determine edge weight threshold based on n_epochs</li><li>Remove edges below threshold</li><li>Eliminate zero entries from sparse matrix</li><li>Preserve matrix symmetry</li><li>Thread-safe for concurrent refinement operations</li></ol>
+<p>
+<b>Performance considerations:</b>
+</p>
+<ul><li>In-place modification is preferred to reduce memory allocation</li><li>Sparse matrix operations should preserve CSR/CSC format efficiency</li></ul>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations.AdaptiveThresholding.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations.AdaptiveThresholding.md
new file mode 100644
index 00000000..41d6996b
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations.AdaptiveThresholding.md
@@ -0,0 +1,82 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_GraphRefinement_Implementations_AdaptiveThresholding"></a> Class AdaptiveThresholding
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations](Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Standard UMAP graph refinement using adaptive threshold based on optimization epochs.
+
+```csharp
+public sealed class AdaptiveThresholding : IGraphRefinementStrategy
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[AdaptiveThresholding](Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations.AdaptiveThresholding.md)
+
+#### Implements
+
+[IGraphRefinementStrategy](Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.IGraphRefinementStrategy.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+This implementation follows the standard UMAP algorithm's approach to graph refinement:
+edges with weight below <code>max_weight / n_epochs</code> are removed, as they would be
+sampled less than once during the optimization process.
+</p>
+<p>
+<b>Rationale:</b> During stochastic gradient descent, edges are sampled proportionally
+to their weights. An edge with weight <code>w</code> in a graph with maximum weight <code>w_max</code>
+will be sampled approximately <code>(w / w_max) × n_epochs</code> times. Edges sampled less
+than once have negligible impact on the final embedding.
+</p>
+<p>
+<b>Implementation:</b> Uses direct CSR (Compressed Sparse Row) storage manipulation for
+O(nnz) performance. Single-pass filter through non-zero entries only, avoiding O(n²) iteration.
+</p>
+<p>
+<b>Time complexity:</b> O(nnz) where nnz is the number of non-zero entries in the graph
+</p>
+<p>
+<b>Space complexity:</b> O(nnz) - creates new storage arrays during filtering
+</p>
+<p>
+Python UMAP reference: Lines 1063-1076 in <code>simplicial_set_embedding()</code>
+</p>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_GraphRefinement_Implementations_AdaptiveThresholding_RefineGraph_MathNet_Numerics_LinearAlgebra_Single_SparseMatrix_System_Int32_"></a> RefineGraph\(SparseMatrix, int\)
+
+Refines the graph by removing edges below an adaptive threshold using CSR direct access.
+
+```csharp
+public GraphRefinementResult RefineGraph(SparseMatrix graph, int nEpochs)
+```
+
+#### Parameters
+
+`graph` SparseMatrix
+
+Fuzzy simplicial set to refine (modified in-place).
+
+`nEpochs` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of optimization epochs planned.
+
+#### Returns
+
+ [GraphRefinementResult](Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.GraphRefinementResult.md)
+
+Refinement result with statistics.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations.md
new file mode 100644
index 00000000..ed6354de
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations.md
@@ -0,0 +1,8 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_GraphRefinement_Implementations"></a> Namespace Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations
+
+### Classes
+
+ [AdaptiveThresholding](Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations.AdaptiveThresholding.md)
+
+Standard UMAP graph refinement using adaptive threshold based on optimization epochs.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.md
new file mode 100644
index 00000000..a038b053
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.md
@@ -0,0 +1,19 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_GraphRefinement"></a> Namespace Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement
+
+### Namespaces
+
+ [Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations](Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations.md)
+
+### Classes
+
+ [GraphRefinementResult](Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.GraphRefinementResult.md)
+
+Result of graph refinement operation.
+
+### Interfaces
+
+ [IGraphRefinementStrategy](Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.IGraphRefinementStrategy.md)
+
+Strategy interface for refining the fuzzy simplicial set graph before layout optimization.
+This is the fourth phase of the UMAP algorithm.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.ILayoutInitStrategy.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.ILayoutInitStrategy.md
new file mode 100644
index 00000000..67322acd
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.ILayoutInitStrategy.md
@@ -0,0 +1,85 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutInit_ILayoutInitStrategy"></a> Interface ILayoutInitStrategy
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.LayoutInit](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Strategy interface for initializing the low-dimensional embedding before optimization.
+This is the fifth phase of the UMAP algorithm.
+
+```csharp
+public interface ILayoutInitStrategy
+```
+
+## Remarks
+
+<p>
+The layout initialization phase creates an initial low-dimensional embedding that serves
+as the starting point for stochastic gradient descent optimization. The quality of this
+initialization significantly impacts:
+</p>
+<ul><li><b>Convergence speed</b>: Better initializations require fewer optimization epochs</li><li><b>Final quality</b>: Good initializations help avoid poor local minima</li><li><b>Reproducibility</b>: Deterministic initializations enable consistent results</li></ul>
+<p>
+<b>Common initialization strategies:</b>
+</p>
+<ul><li><b>Spectral</b>: Eigendecomposition of graph Laplacian (high quality, O(n²) time, recommended for datasets &lt; 10k samples)</li><li><b>PCA</b>: Principal component analysis of original data (medium quality, O(n×d) time)</li><li><b>Random</b>: Uniform random positions (low quality, O(n) time, fastest option)</li><li><b>Precomputed</b>: User-provided initialization (quality varies)</li></ul>
+<p>
+All initializations are normalized to the range [-10, 10] with small random noise
+to prevent degenerate configurations and improve numerical stability.
+</p>
+<p>
+Python UMAP reference: Lines 1078-1148 in <code>simplicial_set_embedding()</code> function
+</p>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutInit_ILayoutInitStrategy_InitializeLayout_MathNet_Numerics_LinearAlgebra_Matrix_System_Single__MathNet_Numerics_LinearAlgebra_Single_SparseMatrix_System_Int32_System_Random_"></a> InitializeLayout\(Matrix<float\>?, SparseMatrix, int, Random\)
+
+Initializes the low-dimensional embedding layout.
+
+```csharp
+LayoutInitResult InitializeLayout(Matrix<float>? data, SparseMatrix graph, int nComponents, Random random)
+```
+
+#### Parameters
+
+`data` Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>?
+
+Original high-dimensional data matrix.
+Shape: (n_samples, n_features)
+May be null for precomputed distance-based initialization.
+
+`graph` SparseMatrix
+
+Refined fuzzy simplicial set graph after pruning.
+Shape: (n_samples, n_samples)
+Used by spectral and graph-based initialization methods.
+
+`nComponents` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Target dimensionality of the embedding.
+Typically 2 or 3 for visualization, or higher for downstream tasks.
+Must be at least 1 and less than n_samples.
+
+`random` [Random](https://learn.microsoft.com/dotnet/api/system.random)
+
+Random number generator for reproducible randomization.
+Used for noise injection and random initialization.
+
+#### Returns
+
+ [LayoutInitResult](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.LayoutInitResult.md)
+
+Initial embedding matrix with coordinates normalized to [-10, 10] range.
+Shape: (n_samples, n_components)
+
+#### Remarks
+
+<p>
+<b>Implementation requirements:</b>
+</p>
+<ol><li>Generate or compute initial coordinates</li><li>Add small random noise to avoid degeneracies</li><li>Normalize to [-10, 10] range for numerical stability</li><li>Ensure output is C-contiguous (row-major) for optimization</li><li>Handle disconnected graph components gracefully</li></ol>
+<p>
+<b>Performance considerations:</b>
+</p>
+<ul><li>Spectral methods require eigenvalue decomposition: O(n²) to O(n³)</li><li>PCA methods require SVD: O(min(n,d) × n × d)</li><li>Random methods are O(n × k) where k is n_components</li></ul>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.RandomInit.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.RandomInit.md
new file mode 100644
index 00000000..57d9392e
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.RandomInit.md
@@ -0,0 +1,84 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutInit_Implementations_RandomInit"></a> Class RandomInit
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Random uniform initialization for fast prototyping and debugging.
+
+```csharp
+public sealed class RandomInit : ILayoutInitStrategy
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[RandomInit](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.RandomInit.md)
+
+#### Implements
+
+[ILayoutInitStrategy](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.ILayoutInitStrategy.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+This strategy initializes embedding coordinates uniformly at random in the range [-10, 10].
+While this provides the fastest initialization, it typically requires more optimization
+epochs to converge compared to spectral or PCA initialization.
+</p>
+<p>
+<b>Use cases:</b>
+</p>
+<ul><li>Quick prototyping and experimentation</li><li>Debugging optimization algorithms</li><li>When data/graph are unavailable for smarter initialization</li><li>Fallback when spectral initialization fails (disconnected graph)</li></ul>
+<p>
+<b>Time complexity:</b> O(n × k) where n = n_samples, k = n_components
+</p>
+<p>
+<b>Space complexity:</b> O(n × k)
+</p>
+<p>
+Python UMAP reference: Lines 1078-1081 in <code>simplicial_set_embedding()</code>
+</p>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutInit_Implementations_RandomInit_InitializeLayout_MathNet_Numerics_LinearAlgebra_Matrix_System_Single__MathNet_Numerics_LinearAlgebra_Single_SparseMatrix_System_Int32_System_Random_"></a> InitializeLayout\(Matrix<float\>?, SparseMatrix, int, Random\)
+
+Initializes embedding with uniform random coordinates.
+
+```csharp
+public LayoutInitResult InitializeLayout(Matrix<float>? data, SparseMatrix graph, int nComponents, Random random)
+```
+
+#### Parameters
+
+`data` Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>?
+
+Original data (unused for random initialization).
+
+`graph` SparseMatrix
+
+Graph (unused for random initialization).
+
+`nComponents` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Target embedding dimensionality.
+
+`random` [Random](https://learn.microsoft.com/dotnet/api/system.random)
+
+Random number generator for coordinate sampling.
+
+#### Returns
+
+ [LayoutInitResult](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.LayoutInitResult.md)
+
+Random embedding normalized to [-10, 10] range.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.SpectralInit.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.SpectralInit.md
new file mode 100644
index 00000000..ceed57ae
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.SpectralInit.md
@@ -0,0 +1,83 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutInit_Implementations_SpectralInit"></a> Class SpectralInit
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Spectral initialization via eigendecomposition of the graph Laplacian.
+Produces a high-quality initialization for connected graphs on small-to-medium datasets.
+
+```csharp
+public sealed class SpectralInit : ILayoutInitStrategy
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[SpectralInit](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.SpectralInit.md)
+
+#### Implements
+
+[ILayoutInitStrategy](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.ILayoutInitStrategy.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutInit_Implementations_SpectralInit_InitializeLayout_MathNet_Numerics_LinearAlgebra_Matrix_System_Single__MathNet_Numerics_LinearAlgebra_Single_SparseMatrix_System_Int32_System_Random_"></a> InitializeLayout\(Matrix<float\>?, SparseMatrix, int, Random\)
+
+Initializes the low-dimensional embedding layout.
+
+```csharp
+public LayoutInitResult InitializeLayout(Matrix<float>? data, SparseMatrix graph, int nComponents, Random random)
+```
+
+#### Parameters
+
+`data` Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>?
+
+Original high-dimensional data matrix.
+Shape: (n_samples, n_features)
+May be null for precomputed distance-based initialization.
+
+`graph` SparseMatrix
+
+Refined fuzzy simplicial set graph after pruning.
+Shape: (n_samples, n_samples)
+Used by spectral and graph-based initialization methods.
+
+`nComponents` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Target dimensionality of the embedding.
+Typically 2 or 3 for visualization, or higher for downstream tasks.
+Must be at least 1 and less than n_samples.
+
+`random` [Random](https://learn.microsoft.com/dotnet/api/system.random)
+
+Random number generator for reproducible randomization.
+Used for noise injection and random initialization.
+
+#### Returns
+
+ [LayoutInitResult](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.LayoutInitResult.md)
+
+Initial embedding matrix with coordinates normalized to [-10, 10] range.
+Shape: (n_samples, n_components)
+
+#### Remarks
+
+<p>
+<b>Implementation requirements:</b>
+</p>
+<ol><li>Generate or compute initial coordinates</li><li>Add small random noise to avoid degeneracies</li><li>Normalize to [-10, 10] range for numerical stability</li><li>Ensure output is C-contiguous (row-major) for optimization</li><li>Handle disconnected graph components gracefully</li></ol>
+<p>
+<b>Performance considerations:</b>
+</p>
+<ul><li>Spectral methods require eigenvalue decomposition: O(n²) to O(n³)</li><li>PCA methods require SVD: O(min(n,d) × n × d)</li><li>Random methods are O(n × k) where k is n_components</li></ul>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.md
new file mode 100644
index 00000000..e5c43f97
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.md
@@ -0,0 +1,13 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutInit_Implementations"></a> Namespace Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations
+
+### Classes
+
+ [RandomInit](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.RandomInit.md)
+
+Random uniform initialization for fast prototyping and debugging.
+
+ [SpectralInit](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.SpectralInit.md)
+
+Spectral initialization via eigendecomposition of the graph Laplacian.
+Produces a high-quality initialization for connected graphs on small-to-medium datasets.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.LayoutInitResult.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.LayoutInitResult.md
new file mode 100644
index 00000000..92ae5499
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.LayoutInitResult.md
@@ -0,0 +1,81 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutInit_LayoutInitResult"></a> Class LayoutInitResult
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.LayoutInit](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Result of layout initialization.
+
+```csharp
+public sealed record LayoutInitResult : IEquatable<LayoutInitResult>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[LayoutInitResult](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.LayoutInitResult.md)
+
+#### Implements
+
+[IEquatable<LayoutInitResult\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Constructors
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutInit_LayoutInitResult__ctor_MathNet_Numerics_LinearAlgebra_Matrix_System_Single__System_String_"></a> LayoutInitResult\(Matrix<float\>, string\)
+
+Result of layout initialization.
+
+```csharp
+public LayoutInitResult(Matrix<float> Embedding, string InitializationMethod)
+```
+
+#### Parameters
+
+`Embedding` Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Initial low-dimensional embedding coordinates.
+Shape: (n_samples, n_components)
+Values are normalized to approximately [-10, 10] range.
+
+`InitializationMethod` [string](https://learn.microsoft.com/dotnet/api/system.string)
+
+Human-readable description of the initialization method used.
+Useful for logging and debugging.
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutInit_LayoutInitResult_Embedding"></a> Embedding
+
+Initial low-dimensional embedding coordinates.
+Shape: (n_samples, n_components)
+Values are normalized to approximately [-10, 10] range.
+
+```csharp
+public Matrix<float> Embedding { get; init; }
+```
+
+#### Property Value
+
+ Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutInit_LayoutInitResult_InitializationMethod"></a> InitializationMethod
+
+Human-readable description of the initialization method used.
+Useful for logging and debugging.
+
+```csharp
+public string InitializationMethod { get; init; }
+```
+
+#### Property Value
+
+ [string](https://learn.microsoft.com/dotnet/api/system.string)
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.md
new file mode 100644
index 00000000..6ef87b31
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.md
@@ -0,0 +1,19 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutInit"></a> Namespace Flowthru.Misc.ML.UMAP.Strategies.LayoutInit
+
+### Namespaces
+
+ [Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.md)
+
+### Classes
+
+ [LayoutInitResult](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.LayoutInitResult.md)
+
+Result of layout initialization.
+
+### Interfaces
+
+ [ILayoutInitStrategy](Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.ILayoutInitStrategy.md)
+
+Strategy interface for initializing the low-dimensional embedding before optimization.
+This is the fifth phase of the UMAP algorithm.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.GraphEdge.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.GraphEdge.md
new file mode 100644
index 00000000..673edf2f
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.GraphEdge.md
@@ -0,0 +1,86 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_GraphEdge"></a> Struct GraphEdge
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Represents an edge in the fuzzy simplicial set graph.
+
+```csharp
+public readonly record struct GraphEdge : IEquatable<GraphEdge>
+```
+
+#### Implements
+
+[IEquatable<GraphEdge\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Constructors
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_GraphEdge__ctor_System_Int32_System_Int32_System_Single_"></a> GraphEdge\(int, int, float\)
+
+Represents an edge in the fuzzy simplicial set graph.
+
+```csharp
+public GraphEdge(int Head, int Tail, float Weight)
+```
+
+#### Parameters
+
+`Head` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Index of the head vertex (source).
+
+`Tail` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Index of the tail vertex (target).
+
+`Weight` [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+Membership strength of this edge.
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_GraphEdge_Head"></a> Head
+
+Index of the head vertex (source).
+
+```csharp
+public int Head { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_GraphEdge_Tail"></a> Tail
+
+Index of the tail vertex (target).
+
+```csharp
+public int Tail { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_GraphEdge_Weight"></a> Weight
+
+Membership strength of this edge.
+
+```csharp
+public float Weight { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.ILayoutOptimizationStrategy.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.ILayoutOptimizationStrategy.md
new file mode 100644
index 00000000..a401d9b8
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.ILayoutOptimizationStrategy.md
@@ -0,0 +1,82 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_ILayoutOptimizationStrategy"></a> Interface ILayoutOptimizationStrategy
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Strategy interface for optimizing low-dimensional embeddings via stochastic gradient descent.
+This is the seventh phase of the UMAP algorithm.
+
+```csharp
+public interface ILayoutOptimizationStrategy
+```
+
+## Remarks
+
+<p>
+The layout optimization phase refines the initial embedding by minimizing the fuzzy set
+cross entropy between the high-dimensional and low-dimensional fuzzy simplicial sets.
+This is done through stochastic gradient descent with two types of forces:
+</p>
+<ul><li><b>Attractive forces</b>: Pull connected points closer based on graph edge weights</li><li><b>Repulsive forces</b>: Push non-connected points apart via negative sampling</li></ul>
+<p>
+The force curves are parameterized by <code>a</code> and <code>b</code>, which are derived from
+the <code>min_dist</code> and <code>spread</code> hyperparameters via curve fitting.
+</p>
+<p>
+Python UMAP reference: <code>optimize_layout_euclidean()</code> in <code>layouts.py</code> (lines 238-441)
+</p>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_ILayoutOptimizationStrategy_Optimize_MathNet_Numerics_LinearAlgebra_Matrix_System_Single__Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_GraphEdge___System_Single___System_Int32_Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_OptimizationParameters_System_Random_"></a> Optimize\(Matrix<float\>, GraphEdge\[\], float\[\], int, OptimizationParameters, Random\)
+
+Optimizes the embedding layout using stochastic gradient descent.
+
+```csharp
+LayoutOptimizationResult Optimize(Matrix<float> initialEmbedding, GraphEdge[] graphEdges, float[] samplingSchedule, int nEpochs, OptimizationParameters parameters, Random random)
+```
+
+#### Parameters
+
+`initialEmbedding` Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Initial embedding from layout initialization strategy.
+Shape: (n_samples, n_components)
+This matrix will be modified in-place during optimization.
+
+`graphEdges` [GraphEdge](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.GraphEdge.md)\[\]
+
+Edges in the fuzzy simplicial set to optimize.
+Contains (head_index, tail_index, weight) tuples.
+
+`samplingSchedule` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+Sampling schedule that determines how often each edge is sampled.
+Array length matches number of edges.
+
+`nEpochs` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of optimization epochs to run.
+Must match the value used to compute the sampling schedule.
+
+`parameters` [OptimizationParameters](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.OptimizationParameters.md)
+
+Optimization parameters including learning rate, repulsion strength, etc.
+
+`random` [Random](https://learn.microsoft.com/dotnet/api/system.random)
+
+Random number generator for negative sampling and reproducibility.
+
+#### Returns
+
+ [LayoutOptimizationResult](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.LayoutOptimizationResult.md)
+
+The optimized embedding (same matrix as initialEmbedding, modified in-place).
+
+#### Remarks
+
+<p>
+<b>Implementation requirements:</b>
+</p>
+<ol><li>Initialize epoch-tracking arrays for sampling schedule</li><li>For each epoch:</li><li>Report progress if verbosity enabled</li></ol>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.EuclideanSGD.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.EuclideanSGD.md
new file mode 100644
index 00000000..ff1fd57a
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.EuclideanSGD.md
@@ -0,0 +1,102 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_Implementations_EuclideanSGD"></a> Class EuclideanSGD
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Standard Euclidean distance SGD optimizer for UMAP layout optimization.
+
+```csharp
+public sealed class EuclideanSGD : ILayoutOptimizationStrategy
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[EuclideanSGD](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.EuclideanSGD.md)
+
+#### Implements
+
+[ILayoutOptimizationStrategy](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.ILayoutOptimizationStrategy.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<b>⚠️ NOTE:</b> This is the reference implementation retained for testing and historical purposes.
+For production use, prefer <xref href="Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.EuclideanSGDOptimized" data-throw-if-not-resolved="false"></xref> which provides 1.5-2x speedup
+through direct array access and early stopping while maintaining identical embedding quality.
+</p>
+<p>
+This implementation follows the Python UMAP reference for Euclidean output spaces.
+It uses stochastic gradient descent with:
+</p>
+<ul><li>Attractive forces based on graph edge weights and a/b curve parameters</li><li>Repulsive forces from negative sampling of non-neighbors</li><li>Linear learning rate decay</li></ul>
+<p>
+<b>Time complexity:</b> O(E × n_epochs + N × k × n_epochs) where E = edges, N = vertices, k = negative samples
+</p>
+<p>
+Python UMAP reference: <code>optimize_layout_euclidean()</code> in <code>layouts.py</code> (lines 238-441)
+</p>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_Implementations_EuclideanSGD_Optimize_MathNet_Numerics_LinearAlgebra_Matrix_System_Single__Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_GraphEdge___System_Single___System_Int32_Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_OptimizationParameters_System_Random_"></a> Optimize\(Matrix<float\>, GraphEdge\[\], float\[\], int, OptimizationParameters, Random\)
+
+Optimizes the embedding layout using stochastic gradient descent.
+
+```csharp
+public LayoutOptimizationResult Optimize(Matrix<float> initialEmbedding, GraphEdge[] graphEdges, float[] samplingSchedule, int nEpochs, OptimizationParameters parameters, Random random)
+```
+
+#### Parameters
+
+`initialEmbedding` Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Initial embedding from layout initialization strategy.
+Shape: (n_samples, n_components)
+This matrix will be modified in-place during optimization.
+
+`graphEdges` [GraphEdge](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.GraphEdge.md)\[\]
+
+Edges in the fuzzy simplicial set to optimize.
+Contains (head_index, tail_index, weight) tuples.
+
+`samplingSchedule` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+Sampling schedule that determines how often each edge is sampled.
+Array length matches number of edges.
+
+`nEpochs` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of optimization epochs to run.
+Must match the value used to compute the sampling schedule.
+
+`parameters` [OptimizationParameters](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.OptimizationParameters.md)
+
+Optimization parameters including learning rate, repulsion strength, etc.
+
+`random` [Random](https://learn.microsoft.com/dotnet/api/system.random)
+
+Random number generator for negative sampling and reproducibility.
+
+#### Returns
+
+ [LayoutOptimizationResult](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.LayoutOptimizationResult.md)
+
+The optimized embedding (same matrix as initialEmbedding, modified in-place).
+
+#### Remarks
+
+<p>
+<b>Implementation requirements:</b>
+</p>
+<ol><li>Initialize epoch-tracking arrays for sampling schedule</li><li>For each epoch:</li><li>Report progress if verbosity enabled</li></ol>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.EuclideanSGDOptimized.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.EuclideanSGDOptimized.md
new file mode 100644
index 00000000..f13a9901
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.EuclideanSGDOptimized.md
@@ -0,0 +1,123 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_Implementations_EuclideanSGDOptimized"></a> Class EuclideanSGDOptimized
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Optimized Euclidean distance SGD optimizer for UMAP layout optimization (default implementation).
+
+```csharp
+public sealed class EuclideanSGDOptimized : ILayoutOptimizationStrategy
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[EuclideanSGDOptimized](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.EuclideanSGDOptimized.md)
+
+#### Implements
+
+[ILayoutOptimizationStrategy](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.ILayoutOptimizationStrategy.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+<b>✓ This is the default layout optimization strategy as of November 2025.</b>
+Provides strict performance improvements over <xref href="Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.EuclideanSGD" data-throw-if-not-resolved="false"></xref> with identical embedding quality.
+</p>
+<p>
+This implementation optimizes the standard UMAP SGD algorithm with:
+</p>
+<ul><li><b>Direct array access</b>: Uses <xref href="MathNet.Numerics.LinearAlgebra.Storage.DenseColumnMajorMatrixStorage%601.Data" data-throw-if-not-resolved="false"></xref> for vectorized operations</li><li><b>Cache-friendly memory access</b>: Exploits column-major layout for better locality</li><li><b>Early stopping</b>: Monitors convergence and terminates when vertex movement stabilizes</li><li><b>Reduced overhead</b>: Eliminates repeated matrix indexing overhead</li></ul>
+<p>
+<b>Validated performance improvements (Fashion MNIST 70k samples):</b>
+</p>
+<ul><li>Layout Optimization: 62.4s → ~42s (~33% faster)</li><li>Total UMAP Runtime: 121.7s → ~101s (~17% faster overall)</li><li>Embedding Quality: Identical (validated via neighborhood preservation)</li></ul>
+<p>
+<b>Usage:</b> Automatically selected by <code>UmapPipeline.Create()</code>. To use the reference
+implementation for testing, explicitly call <code>.WithLayoutOptimization(new EuclideanSGD())</code>.
+</p>
+<p>
+Python UMAP reference: <code>optimize_layout_euclidean()</code> in <code>layouts.py</code> (lines 238-441)
+</p>
+
+## Constructors
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_Implementations_EuclideanSGDOptimized__ctor_System_Single_"></a> EuclideanSGDOptimized\(float\)
+
+Initializes a new instance of the optimized SGD optimizer.
+
+```csharp
+public EuclideanSGDOptimized(float convergenceThreshold = 0.001)
+```
+
+#### Parameters
+
+`convergenceThreshold` [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+Average vertex movement threshold for early stopping.
+Default is 0.001 (0.1% of coordinate space).
+Set to 0 to disable early stopping.
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_Implementations_EuclideanSGDOptimized_Optimize_MathNet_Numerics_LinearAlgebra_Matrix_System_Single__Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_GraphEdge___System_Single___System_Int32_Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_OptimizationParameters_System_Random_"></a> Optimize\(Matrix<float\>, GraphEdge\[\], float\[\], int, OptimizationParameters, Random\)
+
+Optimizes the embedding layout using stochastic gradient descent.
+
+```csharp
+public LayoutOptimizationResult Optimize(Matrix<float> initialEmbedding, GraphEdge[] graphEdges, float[] samplingSchedule, int nEpochs, OptimizationParameters parameters, Random random)
+```
+
+#### Parameters
+
+`initialEmbedding` Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+Initial embedding from layout initialization strategy.
+Shape: (n_samples, n_components)
+This matrix will be modified in-place during optimization.
+
+`graphEdges` [GraphEdge](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.GraphEdge.md)\[\]
+
+Edges in the fuzzy simplicial set to optimize.
+Contains (head_index, tail_index, weight) tuples.
+
+`samplingSchedule` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+Sampling schedule that determines how often each edge is sampled.
+Array length matches number of edges.
+
+`nEpochs` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of optimization epochs to run.
+Must match the value used to compute the sampling schedule.
+
+`parameters` [OptimizationParameters](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.OptimizationParameters.md)
+
+Optimization parameters including learning rate, repulsion strength, etc.
+
+`random` [Random](https://learn.microsoft.com/dotnet/api/system.random)
+
+Random number generator for negative sampling and reproducibility.
+
+#### Returns
+
+ [LayoutOptimizationResult](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.LayoutOptimizationResult.md)
+
+The optimized embedding (same matrix as initialEmbedding, modified in-place).
+
+#### Remarks
+
+<p>
+<b>Implementation requirements:</b>
+</p>
+<ol><li>Initialize epoch-tracking arrays for sampling schedule</li><li>For each epoch:</li><li>Report progress if verbosity enabled</li></ol>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.md
new file mode 100644
index 00000000..b03abe19
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.md
@@ -0,0 +1,12 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_Implementations"></a> Namespace Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations
+
+### Classes
+
+ [EuclideanSGD](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.EuclideanSGD.md)
+
+Standard Euclidean distance SGD optimizer for UMAP layout optimization.
+
+ [EuclideanSGDOptimized](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.EuclideanSGDOptimized.md)
+
+Optimized Euclidean distance SGD optimizer for UMAP layout optimization (default implementation).
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.LayoutOptimizationResult.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.LayoutOptimizationResult.md
new file mode 100644
index 00000000..01318ae3
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.LayoutOptimizationResult.md
@@ -0,0 +1,105 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_LayoutOptimizationResult"></a> Class LayoutOptimizationResult
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Result of layout optimization.
+
+```csharp
+public sealed record LayoutOptimizationResult : IEquatable<LayoutOptimizationResult>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[LayoutOptimizationResult](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.LayoutOptimizationResult.md)
+
+#### Implements
+
+[IEquatable<LayoutOptimizationResult\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Constructors
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_LayoutOptimizationResult__ctor_MathNet_Numerics_LinearAlgebra_Matrix_System_Single__System_Nullable_System_Single__"></a> LayoutOptimizationResult\(Matrix<float\>, float?\)
+
+Result of layout optimization.
+
+```csharp
+public LayoutOptimizationResult(Matrix<float> OptimizedEmbedding, float? FinalLoss)
+```
+
+#### Parameters
+
+`OptimizedEmbedding` Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
+The final optimized embedding.
+Shape: (n_samples, n_components)
+
+`FinalLoss` [float](https://learn.microsoft.com/dotnet/api/system.single)?
+
+Final cross-entropy loss (if computed).
+Null if loss tracking is disabled.
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_LayoutOptimizationResult_ActualEpochs"></a> ActualEpochs
+
+Actual number of epochs completed before termination.
+May be less than requested epochs if early stopping was triggered.
+
+```csharp
+public int? ActualEpochs { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)?
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_LayoutOptimizationResult_EarlyStoppingSaved"></a> EarlyStoppingSaved
+
+Number of epochs saved by early stopping.
+Zero if optimization ran to completion or early stopping was disabled.
+
+```csharp
+public int? EarlyStoppingSaved { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)?
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_LayoutOptimizationResult_FinalLoss"></a> FinalLoss
+
+Final cross-entropy loss (if computed).
+Null if loss tracking is disabled.
+
+```csharp
+public float? FinalLoss { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)?
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_LayoutOptimizationResult_OptimizedEmbedding"></a> OptimizedEmbedding
+
+The final optimized embedding.
+Shape: (n_samples, n_components)
+
+```csharp
+public Matrix<float> OptimizedEmbedding { get; init; }
+```
+
+#### Property Value
+
+ Matrix<[float](https://learn.microsoft.com/dotnet/api/system.single)\>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.OptimizationParameters.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.OptimizationParameters.md
new file mode 100644
index 00000000..76c5bc82
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.OptimizationParameters.md
@@ -0,0 +1,115 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_OptimizationParameters"></a> Class OptimizationParameters
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Parameters for layout optimization.
+
+```csharp
+public sealed record OptimizationParameters : IEquatable<OptimizationParameters>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[OptimizationParameters](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.OptimizationParameters.md)
+
+#### Implements
+
+[IEquatable<OptimizationParameters\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_OptimizationParameters_A"></a> A
+
+Curve parameter 'a' for attractive force.
+
+```csharp
+public required float A { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_OptimizationParameters_B"></a> B
+
+Curve parameter 'b' for attractive force.
+
+```csharp
+public required float B { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_OptimizationParameters_Gamma"></a> Gamma
+
+Weight applied to negative (repulsive) samples.
+
+```csharp
+public required float Gamma { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_OptimizationParameters_InitialAlpha"></a> InitialAlpha
+
+Initial learning rate (decays linearly to 0).
+
+```csharp
+public required float InitialAlpha { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_OptimizationParameters_NegativeSampleRate"></a> NegativeSampleRate
+
+Number of negative samples per positive sample.
+
+```csharp
+public required int NegativeSampleRate { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_OptimizationParameters_ProgressReporter"></a> ProgressReporter
+
+Progress reporter for programmatic tracking.
+
+```csharp
+public IProgress<UmapProgress>? ProgressReporter { get; init; }
+```
+
+#### Property Value
+
+ [IProgress](https://learn.microsoft.com/dotnet/api/system.iprogress\-1)<[UmapProgress](Flowthru.Misc.ML.UMAP.Core.UmapProgress.md)\>?
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization_OptimizationParameters_Verbosity"></a> Verbosity
+
+Verbosity level for progress reporting.
+
+```csharp
+public int Verbosity { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.md
new file mode 100644
index 00000000..2564dfa7
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.md
@@ -0,0 +1,29 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LayoutOptimization"></a> Namespace Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization
+
+### Namespaces
+
+ [Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.md)
+
+### Classes
+
+ [LayoutOptimizationResult](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.LayoutOptimizationResult.md)
+
+Result of layout optimization.
+
+ [OptimizationParameters](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.OptimizationParameters.md)
+
+Parameters for layout optimization.
+
+### Structs
+
+ [GraphEdge](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.GraphEdge.md)
+
+Represents an edge in the fuzzy simplicial set graph.
+
+### Interfaces
+
+ [ILayoutOptimizationStrategy](Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.ILayoutOptimizationStrategy.md)
+
+Strategy interface for optimizing low-dimensional embeddings via stochastic gradient descent.
+This is the seventh phase of the UMAP algorithm.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.ILocalMetricStrategy.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.ILocalMetricStrategy.md
new file mode 100644
index 00000000..67d6db57
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.ILocalMetricStrategy.md
@@ -0,0 +1,82 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LocalMetric_ILocalMetricStrategy"></a> Interface ILocalMetricStrategy
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.LocalMetric](Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Strategy interface for computing smooth approximations of local distances.
+This is the second phase of the UMAP algorithm.
+
+```csharp
+public interface ILocalMetricStrategy
+```
+
+## Remarks
+
+<p>
+The local metric phase computes bandwidth parameters (σᵢ and ρᵢ) for each point that
+normalize the local neighborhood structure. This handles varying local densities in the data:
+</p>
+<ul><li><b>σᵢ (sigma)</b>: Bandwidth of the exponential kernel for point i</li><li><b>ρᵢ (rho)</b>: Distance to the nearest connected neighbor for point i</li></ul>
+<p>
+These parameters ensure that each point has roughly the same "effective" number of neighbors
+regardless of the local density, which is crucial for constructing a consistent fuzzy
+simplicial set representation of the manifold.
+</p>
+<p>
+<b>Mathematical goal:</b> Find σᵢ such that the fuzzy cardinality of the neighborhood equals k:
+</p>
+<pre><code class="lang-csharp">Σⱼ exp(-(dᵢⱼ - ρᵢ) / σᵢ) = log₂(k)</code></pre>
+<p>
+Python UMAP reference: <code>smooth_knn_dist()</code> function in <code>umap_.py</code> (lines ~143-250)
+</p>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LocalMetric_ILocalMetricStrategy_ComputeLocalMetrics_System_Single_____System_Single_System_Single_System_Single_"></a> ComputeLocalMetrics\(float\[\]\[\], float, float, float\)
+
+Computes smooth local metric parameters (bandwidths and local connectivity distances).
+
+```csharp
+LocalMetricResult ComputeLocalMetrics(float[][] knnDistances, float k, float localConnectivity = 1, float bandwidth = 1)
+```
+
+#### Parameters
+
+`knnDistances` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]\[\]
+
+Distance to k-nearest neighbors for each point.
+Array shape: (n_samples, n_neighbors)
+Each row should be sorted in ascending order.
+
+`k` [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+Target number of effective neighbors (typically the same as n_neighbors).
+Used to calibrate the bandwidth parameter.
+
+`localConnectivity` [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+Number of nearest neighbors that should be assumed to be connected at a local level.
+Typically 1.0, meaning the nearest neighbor is always assumed connected (distance weight = 1.0).
+Higher values (e.g., 2.0-5.0) increase local connectivity.
+Range: [1.0, k]
+
+`bandwidth` [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+Target bandwidth multiplier for the exponential kernel.
+Default: 1.0. Affects the target cardinality (target = log₂(k) × bandwidth).
+
+#### Returns
+
+ [LocalMetricResult](Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.LocalMetricResult.md)
+
+A result containing:
+- <b>Sigmas</b>: Bandwidth parameter for each point (length n_samples)
+- <b>Rhos</b>: Distance to nearest connected neighbor for each point (length n_samples)
+
+#### Remarks
+
+<p>
+<b>Implementation requirements:</b>
+</p>
+<ol><li>Handle the case where points have fewer than k non-zero distances</li><li>Apply minimum distance scaling to prevent numerical instability</li><li>Ensure rho ≤ distance to k-th neighbor for all points</li><li>Thread-safe for parallel processing of points</li></ol>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations.BinarySearchSmoothing.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations.BinarySearchSmoothing.md
new file mode 100644
index 00000000..cb925337
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations.BinarySearchSmoothing.md
@@ -0,0 +1,115 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LocalMetric_Implementations_BinarySearchSmoothing"></a> Class BinarySearchSmoothing
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations](Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Binary search-based local metric smoothing.
+Computes bandwidth parameters using iterative binary search to match target cardinality.
+
+```csharp
+public sealed class BinarySearchSmoothing : ILocalMetricStrategy
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[BinarySearchSmoothing](Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations.BinarySearchSmoothing.md)
+
+#### Implements
+
+[ILocalMetricStrategy](Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.ILocalMetricStrategy.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+This is the standard UMAP approach for computing local metric parameters. For each point,
+it uses binary search to find the bandwidth σ that makes the fuzzy cardinality of its
+neighborhood equal to the target value (log₂(k)).
+</p>
+<p>
+<b>Algorithm:</b>
+</p>
+<ol><li>Compute ρᵢ (distance to nearest connected neighbor) based on local connectivity</li><li>Use binary search to find σᵢ such that Σⱼ exp(-(dᵢⱼ - ρᵢ)/σᵢ) ≈ log₂(k)</li><li>Apply minimum distance scaling to prevent numerical instability</li></ol>
+<p>
+<b>Characteristics:</b>
+</p>
+<ul><li><b>Time complexity</b>: O(n × k × log(max_iter)) ≈ O(n × k)</li><li><b>Space complexity</b>: O(n) for output</li><li><b>Convergence</b>: Typically within 10-20 iterations per point</li><li><b>Thread-safe</b>: Yes (each point computed independently)</li></ul>
+<p>
+Python reference: <code>smooth_knn_dist()</code> function in <code>umap_.py</code> (lines ~143-250).
+This is a direct port of the numba-jitted Python implementation.
+</p>
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LocalMetric_Implementations_BinarySearchSmoothing_MaxIterations"></a> MaxIterations
+
+Maximum number of binary search iterations per point.
+Typically converges much faster, but this provides a safety limit.
+
+```csharp
+public int MaxIterations { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LocalMetric_Implementations_BinarySearchSmoothing_ComputeLocalMetrics_System_Single_____System_Single_System_Single_System_Single_"></a> ComputeLocalMetrics\(float\[\]\[\], float, float, float\)
+
+Computes smooth local metric parameters (bandwidths and local connectivity distances).
+
+```csharp
+public LocalMetricResult ComputeLocalMetrics(float[][] knnDistances, float k, float localConnectivity = 1, float bandwidth = 1)
+```
+
+#### Parameters
+
+`knnDistances` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]\[\]
+
+Distance to k-nearest neighbors for each point.
+Array shape: (n_samples, n_neighbors)
+Each row should be sorted in ascending order.
+
+`k` [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+Target number of effective neighbors (typically the same as n_neighbors).
+Used to calibrate the bandwidth parameter.
+
+`localConnectivity` [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+Number of nearest neighbors that should be assumed to be connected at a local level.
+Typically 1.0, meaning the nearest neighbor is always assumed connected (distance weight = 1.0).
+Higher values (e.g., 2.0-5.0) increase local connectivity.
+Range: [1.0, k]
+
+`bandwidth` [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+Target bandwidth multiplier for the exponential kernel.
+Default: 1.0. Affects the target cardinality (target = log₂(k) × bandwidth).
+
+#### Returns
+
+ [LocalMetricResult](Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.LocalMetricResult.md)
+
+A result containing:
+- <b>Sigmas</b>: Bandwidth parameter for each point (length n_samples)
+- <b>Rhos</b>: Distance to nearest connected neighbor for each point (length n_samples)
+
+#### Remarks
+
+<p>
+<b>Implementation requirements:</b>
+</p>
+<ol><li>Handle the case where points have fewer than k non-zero distances</li><li>Apply minimum distance scaling to prevent numerical instability</li><li>Ensure rho ≤ distance to k-th neighbor for all points</li><li>Thread-safe for parallel processing of points</li></ol>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations.md
new file mode 100644
index 00000000..119bae9d
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations.md
@@ -0,0 +1,9 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LocalMetric_Implementations"></a> Namespace Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations
+
+### Classes
+
+ [BinarySearchSmoothing](Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations.BinarySearchSmoothing.md)
+
+Binary search-based local metric smoothing.
+Computes bandwidth parameters using iterative binary search to match target cardinality.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.LocalMetricResult.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.LocalMetricResult.md
new file mode 100644
index 00000000..4bc5bc10
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.LocalMetricResult.md
@@ -0,0 +1,79 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LocalMetric_LocalMetricResult"></a> Class LocalMetricResult
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.LocalMetric](Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Result of local metric computation.
+
+```csharp
+public sealed record LocalMetricResult : IEquatable<LocalMetricResult>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[LocalMetricResult](Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.LocalMetricResult.md)
+
+#### Implements
+
+[IEquatable<LocalMetricResult\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Constructors
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LocalMetric_LocalMetricResult__ctor_System_Single___System_Single___"></a> LocalMetricResult\(float\[\], float\[\]\)
+
+Result of local metric computation.
+
+```csharp
+public LocalMetricResult(float[] Sigmas, float[] Rhos)
+```
+
+#### Parameters
+
+`Sigmas` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+Bandwidth parameters for exponential kernel.
+Array shape: (n_samples,)
+
+`Rhos` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+Distance to nearest connected neighbor.
+Array shape: (n_samples,)
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LocalMetric_LocalMetricResult_Rhos"></a> Rhos
+
+Distance to nearest connected neighbor.
+Array shape: (n_samples,)
+
+```csharp
+public float[] Rhos { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_LocalMetric_LocalMetricResult_Sigmas"></a> Sigmas
+
+Bandwidth parameters for exponential kernel.
+Array shape: (n_samples,)
+
+```csharp
+public float[] Sigmas { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.md
new file mode 100644
index 00000000..b6e19eac
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.md
@@ -0,0 +1,19 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_LocalMetric"></a> Namespace Flowthru.Misc.ML.UMAP.Strategies.LocalMetric
+
+### Namespaces
+
+ [Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations](Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations.md)
+
+### Classes
+
+ [LocalMetricResult](Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.LocalMetricResult.md)
+
+Result of local metric computation.
+
+### Interfaces
+
+ [ILocalMetricStrategy](Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.ILocalMetricStrategy.md)
+
+Strategy interface for computing smooth approximations of local distances.
+This is the second phase of the UMAP algorithm.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.IMembershipStrengthStrategy.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.IMembershipStrengthStrategy.md
new file mode 100644
index 00000000..92ba2801
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.IMembershipStrengthStrategy.md
@@ -0,0 +1,89 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_MembershipStrength_IMembershipStrengthStrategy"></a> Interface IMembershipStrengthStrategy
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength](Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Strategy interface for computing fuzzy simplicial set membership strengths.
+This is the third phase of the UMAP algorithm.
+
+```csharp
+public interface IMembershipStrengthStrategy
+```
+
+## Remarks
+
+<p>
+The membership strength phase converts k-NN distances into membership probabilities
+for the fuzzy simplicial set. Each edge (i,j) gets a membership strength μᵢⱼ ∈ [0,1]
+that represents how strongly point j belongs to the fuzzy neighborhood of point i.
+</p>
+<p>
+<b>Standard approach (exponential kernel):</b>
+</p>
+<pre><code class="lang-csharp">μᵢⱼ = exp(-(max(0, dᵢⱼ - ρᵢ)) / σᵢ)</code></pre>
+<p>
+where dᵢⱼ is the distance, ρᵢ is the local connectivity distance, and σᵢ is the bandwidth.
+</p>
+<p>
+After computing directed membership strengths, fuzzy set operations (union/intersection)
+combine them into a symmetric global graph structure.
+</p>
+<p>
+Python UMAP reference: <code>compute_membership_strengths()</code> and <code>fuzzy_simplicial_set()</code>
+functions in <code>umap_.py</code> (lines ~260-450)
+</p>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_MembershipStrength_IMembershipStrengthStrategy_ComputeMembershipStrengths_System_Int32_____System_Single_____System_Single___System_Single___System_Single_"></a> ComputeMembershipStrengths\(int\[\]\[\], float\[\]\[\], float\[\], float\[\], float\)
+
+Computes membership strengths for the fuzzy simplicial set.
+
+```csharp
+SparseMatrix ComputeMembershipStrengths(int[][] knnIndices, float[][] knnDistances, float[] sigmas, float[] rhos, float setOpMixRatio = 1)
+```
+
+#### Parameters
+
+`knnIndices` [int](https://learn.microsoft.com/dotnet/api/system.int32)\[\]\[\]
+
+Indices of k-nearest neighbors for each point.
+Array shape: (n_samples, n_neighbors)
+
+`knnDistances` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]\[\]
+
+Distances to k-nearest neighbors for each point.
+Array shape: (n_samples, n_neighbors)
+
+`sigmas` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+Bandwidth parameters from local metric computation.
+Array shape: (n_samples,)
+
+`rhos` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+Local connectivity distances from local metric computation.
+Array shape: (n_samples,)
+
+`setOpMixRatio` [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+Interpolation between fuzzy union (1.0) and intersection (0.0).
+Controls how local fuzzy sets are combined into global structure.
+Range: [0.0, 1.0]
+
+#### Returns
+
+ SparseMatrix
+
+A sparse matrix representing the fuzzy simplicial set.
+Shape: (n_samples, n_samples)
+Matrix[i,j] represents the membership strength of the edge from i to j.
+After set operations, the matrix should be symmetric.
+
+#### Remarks
+
+<p>
+<b>Implementation requirements:</b>
+</p>
+<ol><li>Compute directed membership strengths μᵢⱼ for each edge</li><li>Apply fuzzy set operation: μ = α(μᵢⱼ + μⱼᵢ - μᵢⱼμⱼᵢ) + (1-α)μᵢⱼμⱼᵢ</li><li>Eliminate zero entries from sparse matrix</li><li>Ensure matrix is symmetric after set operations</li></ol>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations.ExponentialKernel.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations.ExponentialKernel.md
new file mode 100644
index 00000000..4538b5af
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations.ExponentialKernel.md
@@ -0,0 +1,112 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_MembershipStrength_Implementations_ExponentialKernel"></a> Class ExponentialKernel
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations](Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Exponential kernel-based membership strength computation.
+Uses the standard UMAP exponential kernel to convert distances into probabilities.
+
+```csharp
+public sealed class ExponentialKernel : IMembershipStrengthStrategy
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ExponentialKernel](Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations.ExponentialKernel.md)
+
+#### Implements
+
+[IMembershipStrengthStrategy](Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.IMembershipStrengthStrategy.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+This is the standard UMAP approach for computing fuzzy set membership strengths.
+It applies an exponential kernel centered at the local connectivity distance (ρᵢ)
+with bandwidth σᵢ:
+</p>
+<pre><code class="lang-csharp">μᵢⱼ = {
+  1.0                           if dᵢⱼ ≤ ρᵢ or σᵢ = 0
+  exp(-(dᵢⱼ - ρᵢ) / σᵢ)        otherwise
+}</code></pre>
+<p>
+After computing directed strengths, the algorithm applies fuzzy set operations to
+symmetrize the graph. The set operation interpolates between fuzzy union and intersection:
+</p>
+<pre><code class="lang-csharp">μ = α(μ_forward + μ_reverse - μ_forward × μ_reverse) + (1-α)(μ_forward × μ_reverse)</code></pre>
+<p>
+where α is the set operation mix ratio (typically 1.0 for pure fuzzy union).
+</p>
+<p>
+<b>Characteristics:</b>
+</p>
+<ul><li><b>Time complexity</b>: O(n × k) for computing strengths</li><li><b>Space complexity</b>: O(n × k) sparse matrix</li><li><b>Graph density</b>: Approximately k edges per node</li><li><b>Thread-safe</b>: Yes for reading, exclusive write access needed</li></ul>
+<p>
+Python reference: <code>compute_membership_strengths()</code> in <code>umap_.py</code> (lines ~260-330)
+and fuzzy set operations in <code>fuzzy_simplicial_set()</code> (lines ~450-470).
+</p>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_MembershipStrength_Implementations_ExponentialKernel_ComputeMembershipStrengths_System_Int32_____System_Single_____System_Single___System_Single___System_Single_"></a> ComputeMembershipStrengths\(int\[\]\[\], float\[\]\[\], float\[\], float\[\], float\)
+
+Computes membership strengths for the fuzzy simplicial set.
+
+```csharp
+public SparseMatrix ComputeMembershipStrengths(int[][] knnIndices, float[][] knnDistances, float[] sigmas, float[] rhos, float setOpMixRatio = 1)
+```
+
+#### Parameters
+
+`knnIndices` [int](https://learn.microsoft.com/dotnet/api/system.int32)\[\]\[\]
+
+Indices of k-nearest neighbors for each point.
+Array shape: (n_samples, n_neighbors)
+
+`knnDistances` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]\[\]
+
+Distances to k-nearest neighbors for each point.
+Array shape: (n_samples, n_neighbors)
+
+`sigmas` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+Bandwidth parameters from local metric computation.
+Array shape: (n_samples,)
+
+`rhos` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+Local connectivity distances from local metric computation.
+Array shape: (n_samples,)
+
+`setOpMixRatio` [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+Interpolation between fuzzy union (1.0) and intersection (0.0).
+Controls how local fuzzy sets are combined into global structure.
+Range: [0.0, 1.0]
+
+#### Returns
+
+ SparseMatrix
+
+A sparse matrix representing the fuzzy simplicial set.
+Shape: (n_samples, n_samples)
+Matrix[i,j] represents the membership strength of the edge from i to j.
+After set operations, the matrix should be symmetric.
+
+#### Remarks
+
+<p>
+<b>Implementation requirements:</b>
+</p>
+<ol><li>Compute directed membership strengths μᵢⱼ for each edge</li><li>Apply fuzzy set operation: μ = α(μᵢⱼ + μⱼᵢ - μᵢⱼμⱼᵢ) + (1-α)μᵢⱼμⱼᵢ</li><li>Eliminate zero entries from sparse matrix</li><li>Ensure matrix is symmetric after set operations</li></ol>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations.md
new file mode 100644
index 00000000..cf182811
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations.md
@@ -0,0 +1,9 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_MembershipStrength_Implementations"></a> Namespace Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations
+
+### Classes
+
+ [ExponentialKernel](Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations.ExponentialKernel.md)
+
+Exponential kernel-based membership strength computation.
+Uses the standard UMAP exponential kernel to convert distances into probabilities.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.md
new file mode 100644
index 00000000..bab9a33a
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.md
@@ -0,0 +1,13 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_MembershipStrength"></a> Namespace Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength
+
+### Namespaces
+
+ [Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations](Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations.md)
+
+### Interfaces
+
+ [IMembershipStrengthStrategy](Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.IMembershipStrengthStrategy.md)
+
+Strategy interface for computing fuzzy simplicial set membership strengths.
+This is the third phase of the UMAP algorithm.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.INeighborSearchStrategy.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.INeighborSearchStrategy.md
new file mode 100644
index 00000000..8759798b
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.INeighborSearchStrategy.md
@@ -0,0 +1,73 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_INeighborSearchStrategy"></a> Interface INeighborSearchStrategy
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Strategy interface for computing k-nearest neighbors in high-dimensional space.
+This is the first phase of the UMAP algorithm.
+
+```csharp
+public interface INeighborSearchStrategy
+```
+
+## Remarks
+
+<p>
+The neighbor search phase computes the k-nearest neighbors for each point in the dataset.
+Different strategies provide different trade-offs between accuracy, speed, and memory usage:
+</p>
+<ul><li><b>Exact methods</b> (e.g., brute force): O(n²) time, 100% accurate, recommended for datasets &lt; 4096 samples</li><li><b>Tree methods</b> (e.g., KD-tree): O(n log n) time, exact or approximate, suitable for medium datasets with low-to-medium dimensions</li><li><b>Approximate methods</b> (e.g., NN-Descent): O(n^1.14) time, ~99% accurate, recommended for datasets ≥ 4096 samples</li><li><b>Precomputed</b>: O(1) time, user provides k-NN graph, suitable when neighbors are already known</li></ul>
+<p>
+Python UMAP reference: <code>nearest_neighbors()</code> function in <code>umap_.py</code> (lines ~260-300)
+</p>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_INeighborSearchStrategy_Search_System_Single_____System_Int32_Flowthru_Misc_ML_UMAP_Core_Markers_IMetric_System_Random_"></a> Search\(float\[\]\[\], int, IMetric, Random\)
+
+Computes k-nearest neighbors for all points in the dataset.
+
+```csharp
+NeighborSearchResult Search(float[][] data, int nNeighbors, IMetric metric, Random random)
+```
+
+#### Parameters
+
+`data` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]\[\]
+
+Input data as jagged array where each row represents a data point (n_samples × n_features).
+data[i] is a float array of length n_features containing the feature values for sample i.
+All rows must have the same length.
+
+`nNeighbors` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of nearest neighbors to find for each point.
+Must be at least 2 and at most n_samples - 1.
+
+`metric` [IMetric](Flowthru.Misc.ML.UMAP.Core.Markers.IMetric.md)
+
+Distance metric for computing pairwise distances between points.
+
+`random` [Random](https://learn.microsoft.com/dotnet/api/system.random)
+
+Random number generator for any randomized algorithms (e.g., approximate search).
+Ensures reproducibility when a seed is provided.
+
+#### Returns
+
+ [NeighborSearchResult](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.NeighborSearchResult.md)
+
+A result containing:
+- <b>Indices</b>: n_samples × n_neighbors array where Indices[i][j] is the index of the j-th nearest neighbor of point i
+- <b>Distances</b>: n_samples × n_neighbors array where Distances[i][j] is the distance to that neighbor
+- <b>SearchIndex</b>: Optional search index structure for future queries (e.g., for transform), or null if not applicable
+
+Note: Indices[i][0] should always be i (each point is its own nearest neighbor with distance 0).
+
+#### Remarks
+
+<p>
+<b>Implementation requirements:</b>
+</p>
+<ol><li>Results must be sorted by distance (ascending) for each point</li><li>First neighbor of each point should typically be itself (distance 0)</li><li>For precomputed distances with disconnected components, use index -1 and distance ∞</li><li>Thread-safe if marked as such in implementation</li></ol>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.BruteForceSearch.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.BruteForceSearch.md
new file mode 100644
index 00000000..4d6b291b
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.BruteForceSearch.md
@@ -0,0 +1,101 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_Implementations_BruteForceSearch"></a> Class BruteForceSearch
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Brute-force exact k-nearest neighbor search.
+Computes all pairwise distances - O(n²) time complexity.
+
+```csharp
+public sealed class BruteForceSearch : INeighborSearchStrategy
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[BruteForceSearch](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.BruteForceSearch.md)
+
+#### Implements
+
+[INeighborSearchStrategy](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.INeighborSearchStrategy.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+This implementation computes the exact k-nearest neighbors by calculating all pairwise
+distances and selecting the k smallest for each point. While this is computationally
+expensive for large datasets, it guarantees 100% accuracy and is the fastest approach
+for small datasets (typically &lt; 4096 samples).
+</p>
+<p>
+<b>Characteristics:</b>
+</p>
+<ul><li><b>Time complexity</b>: O(n² × d) where n=samples, d=dimensions</li><li><b>Space complexity</b>: O(n × k) for output</li><li><b>Accuracy</b>: 100% (exact)</li><li><b>Recommended for</b>: Small datasets (&lt; 4096 samples)</li><li><b>Thread-safe</b>: Yes (read-only operations)</li></ul>
+<p>
+This is the reference implementation matching Python UMAP's behavior for small datasets
+or when <code>metric='precomputed'</code> is not used.
+</p>
+<p>
+Python reference: The brute-force path in <code>nearest_neighbors()</code> when exact k-NN
+is computed via <code>pairwise_distances()</code> (Python UMAP lines ~2950-3000).
+</p>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_Implementations_BruteForceSearch_Search_System_Single_____System_Int32_Flowthru_Misc_ML_UMAP_Core_Markers_IMetric_System_Random_"></a> Search\(float\[\]\[\], int, IMetric, Random\)
+
+Computes k-nearest neighbors for all points in the dataset.
+
+```csharp
+public NeighborSearchResult Search(float[][] data, int nNeighbors, IMetric metric, Random random)
+```
+
+#### Parameters
+
+`data` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]\[\]
+
+Input data as jagged array where each row represents a data point (n_samples × n_features).
+data[i] is a float array of length n_features containing the feature values for sample i.
+All rows must have the same length.
+
+`nNeighbors` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of nearest neighbors to find for each point.
+Must be at least 2 and at most n_samples - 1.
+
+`metric` [IMetric](Flowthru.Misc.ML.UMAP.Core.Markers.IMetric.md)
+
+Distance metric for computing pairwise distances between points.
+
+`random` [Random](https://learn.microsoft.com/dotnet/api/system.random)
+
+Random number generator for any randomized algorithms (e.g., approximate search).
+Ensures reproducibility when a seed is provided.
+
+#### Returns
+
+ [NeighborSearchResult](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.NeighborSearchResult.md)
+
+A result containing:
+- <b>Indices</b>: n_samples × n_neighbors array where Indices[i][j] is the index of the j-th nearest neighbor of point i
+- <b>Distances</b>: n_samples × n_neighbors array where Distances[i][j] is the distance to that neighbor
+- <b>SearchIndex</b>: Optional search index structure for future queries (e.g., for transform), or null if not applicable
+
+Note: Indices[i][0] should always be i (each point is its own nearest neighbor with distance 0).
+
+#### Remarks
+
+<p>
+<b>Implementation requirements:</b>
+</p>
+<ol><li>Results must be sorted by distance (ascending) for each point</li><li>First neighbor of each point should typically be itself (distance 0)</li><li>For precomputed distances with disconnected components, use index -1 and distance ∞</li><li>Thread-safe if marked as such in implementation</li></ol>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.NNDescentSearch.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.NNDescentSearch.md
new file mode 100644
index 00000000..9dbcb3b2
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.NNDescentSearch.md
@@ -0,0 +1,216 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_Implementations_NNDescentSearch"></a> Class NNDescentSearch
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+NN-Descent approximate k-nearest neighbor search.
+Achieves ~99% accuracy with O(n^1.14) time complexity for large datasets.
+
+```csharp
+public sealed class NNDescentSearch : INeighborSearchStrategy
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[NNDescentSearch](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.NNDescentSearch.md)
+
+#### Implements
+
+[INeighborSearchStrategy](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.INeighborSearchStrategy.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+NN-Descent is an iterative algorithm that efficiently constructs approximate k-nearest neighbor
+graphs through a local join operation. It achieves sub-quadratic time complexity while maintaining
+high accuracy (typically 99%+ recall).
+</p>
+<p>
+<b>Algorithm overview:</b>
+</p>
+<ol><li>Initialize with random projection trees (RP-trees) for quality starting neighbors</li><li>Fill remaining slots with random neighbors</li><li>Iteratively refine via local join: compare candidate neighbor pairs</li><li>Converge when update rate falls below threshold</li></ol>
+<p>
+<b>Performance characteristics:</b>
+</p>
+<ul><li><b>Time complexity</b>: O(n^1.14 × d) empirically, vs O(n² × d) for brute-force</li><li><b>Space complexity</b>: O(n × k + trees × n / leaf_size)</li><li><b>Accuracy</b>: ~99% (approximate, configurable via parameters)</li><li><b>Recommended for</b>: Large datasets (≥ 4096 samples)</li><li><b>Thread-safe</b>: No (constructs new index per call)</li></ul>
+<p>
+Based on: Dong, Moses, and Li. "Efficient K-Nearest Neighbor Graph Construction for Generic
+Similarity Measures" (WWW 2011). Implementation follows PyNNDescent reference.
+</p>
+<p>
+Python reference: <code>nn_descent()</code> function in <code>pynndescent_.py</code> and supporting functions
+in <code>utils.py</code> and <code>rp_trees.py</code> from the PyNNDescent library.
+</p>
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_Implementations_NNDescentSearch_DeltaThreshold"></a> DeltaThreshold
+
+Convergence threshold as fraction of total edges.
+Algorithm stops when updates per iteration drop below: delta × k × n.
+Typical value: 0.001 (0.1% of edges changing).
+
+```csharp
+public float DeltaThreshold { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_Implementations_NNDescentSearch_LeafSize"></a> LeafSize
+
+Leaf size for random projection trees.
+Smaller leaves increase tree depth and initialization quality.
+Typical range: 10-20.
+
+```csharp
+public int LeafSize { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_Implementations_NNDescentSearch_LowMemory"></a> LowMemory
+
+If true, uses block-based processing to reduce memory usage at cost of ~2x speed.
+If false, maintains in-memory set for faster duplicate checking.
+
+```csharp
+public bool LowMemory { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_Implementations_NNDescentSearch_MaxCandidates"></a> MaxCandidates
+
+Maximum number of candidate neighbors to consider per point per iteration.
+If 0 (default), auto-configures as: min(60, k).
+Higher values improve accuracy but increase iteration cost.
+
+```csharp
+public int MaxCandidates { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Remarks
+
+Controls the breadth of the local join search. Typical values: 30-60.
+Each iteration costs O(n × max_candidates² × d).
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_Implementations_NNDescentSearch_MaxIterations"></a> MaxIterations
+
+Maximum number of NN-descent iterations.
+If 0 (default), auto-configures as: max(5, round(log2(n))).
+More iterations improve accuracy but increase runtime.
+
+```csharp
+public int MaxIterations { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Remarks
+
+Algorithm typically converges in 5-10 iterations via delta threshold.
+Early stopping prevents unnecessary work.
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_Implementations_NNDescentSearch_NumTrees"></a> NumTrees
+
+Number of random projection trees to build for initialization.
+If 0 (default), auto-configures as: min(32, 5 + round(n^0.25)).
+More trees improve initialization quality but increase build time.
+
+```csharp
+public int NumTrees { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Remarks
+
+Python UMAP typically uses 5-32 trees depending on dataset size.
+Each tree costs O(n log n × d) to build.
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_Implementations_NNDescentSearch_Verbose"></a> Verbose
+
+If true, prints progress information to console during search.
+
+```csharp
+public bool Verbose { get; init; }
+```
+
+#### Property Value
+
+ [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_Implementations_NNDescentSearch_Search_System_Single_____System_Int32_Flowthru_Misc_ML_UMAP_Core_Markers_IMetric_System_Random_"></a> Search\(float\[\]\[\], int, IMetric, Random\)
+
+Computes k-nearest neighbors for all points in the dataset.
+
+```csharp
+public NeighborSearchResult Search(float[][] data, int nNeighbors, IMetric metric, Random random)
+```
+
+#### Parameters
+
+`data` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]\[\]
+
+Input data as jagged array where each row represents a data point (n_samples × n_features).
+data[i] is a float array of length n_features containing the feature values for sample i.
+All rows must have the same length.
+
+`nNeighbors` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Number of nearest neighbors to find for each point.
+Must be at least 2 and at most n_samples - 1.
+
+`metric` [IMetric](Flowthru.Misc.ML.UMAP.Core.Markers.IMetric.md)
+
+Distance metric for computing pairwise distances between points.
+
+`random` [Random](https://learn.microsoft.com/dotnet/api/system.random)
+
+Random number generator for any randomized algorithms (e.g., approximate search).
+Ensures reproducibility when a seed is provided.
+
+#### Returns
+
+ [NeighborSearchResult](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.NeighborSearchResult.md)
+
+A result containing:
+- <b>Indices</b>: n_samples × n_neighbors array where Indices[i][j] is the index of the j-th nearest neighbor of point i
+- <b>Distances</b>: n_samples × n_neighbors array where Distances[i][j] is the distance to that neighbor
+- <b>SearchIndex</b>: Optional search index structure for future queries (e.g., for transform), or null if not applicable
+
+Note: Indices[i][0] should always be i (each point is its own nearest neighbor with distance 0).
+
+#### Remarks
+
+<p>
+<b>Implementation requirements:</b>
+</p>
+<ol><li>Results must be sorted by distance (ascending) for each point</li><li>First neighbor of each point should typically be itself (distance 0)</li><li>For precomputed distances with disconnected components, use index -1 and distance ∞</li><li>Thread-safe if marked as such in implementation</li></ol>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.md
new file mode 100644
index 00000000..7408f2cd
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.md
@@ -0,0 +1,14 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_Implementations"></a> Namespace Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations
+
+### Classes
+
+ [BruteForceSearch](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.BruteForceSearch.md)
+
+Brute-force exact k-nearest neighbor search.
+Computes all pairwise distances - O(n²) time complexity.
+
+ [NNDescentSearch](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.NNDescentSearch.md)
+
+NN-Descent approximate k-nearest neighbor search.
+Achieves ~99% accuracy with O(n^1.14) time complexity for large datasets.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.NeighborSearchResult.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.NeighborSearchResult.md
new file mode 100644
index 00000000..afdf614d
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.NeighborSearchResult.md
@@ -0,0 +1,97 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_NeighborSearchResult"></a> Class NeighborSearchResult
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Result of a nearest neighbor search operation.
+
+```csharp
+public sealed record NeighborSearchResult : IEquatable<NeighborSearchResult>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[NeighborSearchResult](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.NeighborSearchResult.md)
+
+#### Implements
+
+[IEquatable<NeighborSearchResult\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Constructors
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_NeighborSearchResult__ctor_System_Int32_____System_Single_____System_Object_"></a> NeighborSearchResult\(int\[\]\[\], float\[\]\[\], object?\)
+
+Result of a nearest neighbor search operation.
+
+```csharp
+public NeighborSearchResult(int[][] Indices, float[][] Distances, object? SearchIndex)
+```
+
+#### Parameters
+
+`Indices` [int](https://learn.microsoft.com/dotnet/api/system.int32)\[\]\[\]
+
+Indices of k-nearest neighbors for each point.
+Array shape: (n_samples, n_neighbors)
+
+`Distances` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]\[\]
+
+Distances to k-nearest neighbors for each point.
+Array shape: (n_samples, n_neighbors)
+
+`SearchIndex` [object](https://learn.microsoft.com/dotnet/api/system.object)?
+
+Optional search index for future queries (used in transform operations).
+May be null if the strategy doesn't support indexing.
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_NeighborSearchResult_Distances"></a> Distances
+
+Distances to k-nearest neighbors for each point.
+Array shape: (n_samples, n_neighbors)
+
+```csharp
+public float[][] Distances { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]\[\]
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_NeighborSearchResult_Indices"></a> Indices
+
+Indices of k-nearest neighbors for each point.
+Array shape: (n_samples, n_neighbors)
+
+```csharp
+public int[][] Indices { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)\[\]\[\]
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch_NeighborSearchResult_SearchIndex"></a> SearchIndex
+
+Optional search index for future queries (used in transform operations).
+May be null if the strategy doesn't support indexing.
+
+```csharp
+public object? SearchIndex { get; init; }
+```
+
+#### Property Value
+
+ [object](https://learn.microsoft.com/dotnet/api/system.object)?
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.md
new file mode 100644
index 00000000..a19d7fe7
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.md
@@ -0,0 +1,19 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_NeighborSearch"></a> Namespace Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch
+
+### Namespaces
+
+ [Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.md)
+
+### Classes
+
+ [NeighborSearchResult](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.NeighborSearchResult.md)
+
+Result of a nearest neighbor search operation.
+
+### Interfaces
+
+ [INeighborSearchStrategy](Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.INeighborSearchStrategy.md)
+
+Strategy interface for computing k-nearest neighbors in high-dimensional space.
+This is the first phase of the UMAP algorithm.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.ISamplingScheduleStrategy.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.ISamplingScheduleStrategy.md
new file mode 100644
index 00000000..f0bf09d8
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.ISamplingScheduleStrategy.md
@@ -0,0 +1,76 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_SamplingSchedule_ISamplingScheduleStrategy"></a> Interface ISamplingScheduleStrategy
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Strategy interface for computing edge sampling schedules during layout optimization.
+This is the sixth phase of the UMAP algorithm.
+
+```csharp
+public interface ISamplingScheduleStrategy
+```
+
+## Remarks
+
+<p>
+The sampling schedule determines how frequently each edge in the fuzzy simplicial set
+should be sampled during stochastic gradient descent. Edges with higher membership
+strength (weight) are sampled more frequently.
+</p>
+<p>
+<b>Standard approach (proportional sampling):</b>
+</p>
+<p>
+Each edge is sampled proportionally to its weight. The number of epochs between samples
+for an edge with weight <code>w</code> is:
+</p>
+<pre><code class="lang-csharp">epochs_per_sample[i] = n_epochs / (n_epochs * weight[i] / max_weight)
+                     = max_weight / weight[i]</code></pre>
+<p>
+This ensures that stronger edges (higher membership) are sampled more often, while
+weaker edges may not be sampled at all if their expected sample count is less than 1.
+</p>
+<p>
+Python UMAP reference: <code>make_epochs_per_sample()</code> function in <code>umap_.py</code> (lines 906-927)
+</p>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_SamplingSchedule_ISamplingScheduleStrategy_ComputeSchedule_System_Single___System_Int32_"></a> ComputeSchedule\(float\[\], int\)
+
+Computes the sampling schedule for edges during SGD optimization.
+
+```csharp
+SamplingScheduleResult ComputeSchedule(float[] edgeWeights, int nEpochs)
+```
+
+#### Parameters
+
+`edgeWeights` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+Array of edge weights from the fuzzy simplicial set.
+These are the membership strengths after fuzzy set operations.
+Length: number of edges in the graph
+
+`nEpochs` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Total number of optimization epochs to run.
+Must be positive.
+
+#### Returns
+
+ [SamplingScheduleResult](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.SamplingScheduleResult.md)
+
+Array of epochs-per-sample for each edge.
+Value of <code>epochs_per_sample[i]</code> means edge <code>i</code> should be sampled
+every <code>epochs_per_sample[i]</code> epochs (on average).
+Edges with weight too small to be sampled are marked with -1.
+Length: same as edgeWeights
+
+#### Remarks
+
+<p>
+<b>Implementation requirements:</b>
+</p>
+<ol><li>Find maximum weight across all edges</li><li>Compute expected number of samples per edge: n_epochs * (weight / max_weight)</li><li>Invert to get epochs per sample: n_epochs / expected_samples</li><li>Mark edges with expected_samples ≤ 0 as -1 (never sampled)</li></ol>
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations.ProportionalSampling.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations.ProportionalSampling.md
new file mode 100644
index 00000000..5c1f1cc0
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations.ProportionalSampling.md
@@ -0,0 +1,68 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_SamplingSchedule_Implementations_ProportionalSampling"></a> Class ProportionalSampling
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Proportional sampling schedule where edges are sampled proportionally to their weights.
+This is the standard UMAP sampling strategy.
+
+```csharp
+public sealed class ProportionalSampling : ISamplingScheduleStrategy
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[ProportionalSampling](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations.ProportionalSampling.md)
+
+#### Implements
+
+[ISamplingScheduleStrategy](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.ISamplingScheduleStrategy.md)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Remarks
+
+<p>
+This implementation follows the Python UMAP reference implementation exactly.
+Each edge is sampled with frequency proportional to its membership strength,
+ensuring that stronger connections in the fuzzy simplicial set receive more
+optimization attention.
+</p>
+<p>
+<b>Time complexity:</b> O(E) where E is the number of edges
+</p>
+<p>
+<b>Space complexity:</b> O(E) for the output array
+</p>
+<p>
+Python UMAP reference: <code>make_epochs_per_sample()</code> in <code>umap_.py</code> (lines 906-927)
+</p>
+
+## Methods
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_SamplingSchedule_Implementations_ProportionalSampling_ComputeSchedule_System_Single___System_Int32_"></a> ComputeSchedule\(float\[\], int\)
+
+Computes proportional sampling schedule for edges.
+
+```csharp
+public SamplingScheduleResult ComputeSchedule(float[] edgeWeights, int nEpochs)
+```
+
+#### Parameters
+
+`edgeWeights` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+`nEpochs` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+#### Returns
+
+ [SamplingScheduleResult](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.SamplingScheduleResult.md)
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations.md
new file mode 100644
index 00000000..57f6c5a1
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations.md
@@ -0,0 +1,9 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_SamplingSchedule_Implementations"></a> Namespace Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations
+
+### Classes
+
+ [ProportionalSampling](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations.ProportionalSampling.md)
+
+Proportional sampling schedule where edges are sampled proportionally to their weights.
+This is the standard UMAP sampling strategy.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.SamplingScheduleResult.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.SamplingScheduleResult.md
new file mode 100644
index 00000000..aa00ab03
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.SamplingScheduleResult.md
@@ -0,0 +1,81 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_SamplingSchedule_SamplingScheduleResult"></a> Class SamplingScheduleResult
+
+Namespace: [Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.md)  
+Assembly: Flowthru.Misc.ML.dll  
+
+Result of sampling schedule computation.
+
+```csharp
+public sealed record SamplingScheduleResult : IEquatable<SamplingScheduleResult>
+```
+
+#### Inheritance
+
+[object](https://learn.microsoft.com/dotnet/api/system.object) ← 
+[SamplingScheduleResult](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.SamplingScheduleResult.md)
+
+#### Implements
+
+[IEquatable<SamplingScheduleResult\>](https://learn.microsoft.com/dotnet/api/system.iequatable\-1)
+
+#### Inherited Members
+
+[object.Equals\(object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\)), 
+[object.Equals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.equals\#system\-object\-equals\(system\-object\-system\-object\)), 
+[object.GetHashCode\(\)](https://learn.microsoft.com/dotnet/api/system.object.gethashcode), 
+[object.GetType\(\)](https://learn.microsoft.com/dotnet/api/system.object.gettype), 
+[object.ReferenceEquals\(object?, object?\)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals), 
+[object.ToString\(\)](https://learn.microsoft.com/dotnet/api/system.object.tostring)
+
+## Constructors
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_SamplingSchedule_SamplingScheduleResult__ctor_System_Single___System_Int32_"></a> SamplingScheduleResult\(float\[\], int\)
+
+Result of sampling schedule computation.
+
+```csharp
+public SamplingScheduleResult(float[] EpochsPerSample, int TotalExpectedSamples)
+```
+
+#### Parameters
+
+`EpochsPerSample` [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+Number of epochs between samples for each edge.
+Array length matches the number of edges in the graph.
+Value of -1 indicates the edge should never be sampled.
+
+`TotalExpectedSamples` [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+Total number of edge samples expected across all epochs.
+Useful for progress estimation.
+
+## Properties
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_SamplingSchedule_SamplingScheduleResult_EpochsPerSample"></a> EpochsPerSample
+
+Number of epochs between samples for each edge.
+Array length matches the number of edges in the graph.
+Value of -1 indicates the edge should never be sampled.
+
+```csharp
+public float[] EpochsPerSample { get; init; }
+```
+
+#### Property Value
+
+ [float](https://learn.microsoft.com/dotnet/api/system.single)\[\]
+
+### <a id="Flowthru_Misc_ML_UMAP_Strategies_SamplingSchedule_SamplingScheduleResult_TotalExpectedSamples"></a> TotalExpectedSamples
+
+Total number of edge samples expected across all epochs.
+Useful for progress estimation.
+
+```csharp
+public int TotalExpectedSamples { get; init; }
+```
+
+#### Property Value
+
+ [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.md b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.md
new file mode 100644
index 00000000..bd192814
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.md
@@ -0,0 +1,19 @@
+# <a id="Flowthru_Misc_ML_UMAP_Strategies_SamplingSchedule"></a> Namespace Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule
+
+### Namespaces
+
+ [Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations.md)
+
+### Classes
+
+ [SamplingScheduleResult](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.SamplingScheduleResult.md)
+
+Result of sampling schedule computation.
+
+### Interfaces
+
+ [ISamplingScheduleStrategy](Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.ISamplingScheduleStrategy.md)
+
+Strategy interface for computing edge sampling schedules during layout optimization.
+This is the sixth phase of the UMAP algorithm.
+
diff --git a/docs/reference/src/misc/Flowthru.Misc.ML/toc.yml b/docs/reference/src/misc/Flowthru.Misc.ML/toc.yml
new file mode 100644
index 00000000..94d6bf67
--- /dev/null
+++ b/docs/reference/src/misc/Flowthru.Misc.ML/toc.yml
@@ -0,0 +1,156 @@
+### YamlMime:TableOfContent
+- name: Flowthru.Misc.ML.UMAP.Core
+  href: Flowthru.Misc.ML.UMAP.Core.md
+  items:
+  - name: Classes
+  - name: CurveFitting
+    href: Flowthru.Misc.ML.UMAP.Core.CurveFitting.md
+  - name: DataShape
+    href: Flowthru.Misc.ML.UMAP.Core.DataShape.md
+  - name: UmapFitResult
+    href: Flowthru.Misc.ML.UMAP.Core.UmapFitResult.md
+  - name: UmapFlowBuilder
+    href: Flowthru.Misc.ML.UMAP.Core.UmapFlowBuilder.md
+  - name: UmapGraphResult
+    href: Flowthru.Misc.ML.UMAP.Core.UmapGraphResult.md
+  - name: UmapParameters
+    href: Flowthru.Misc.ML.UMAP.Core.UmapParameters.md
+  - name: UmapPipeline
+    href: Flowthru.Misc.ML.UMAP.Core.UmapPipeline.md
+  - name: UmapProgress
+    href: Flowthru.Misc.ML.UMAP.Core.UmapProgress.md
+  - name: UmapRuntimeReport
+    href: Flowthru.Misc.ML.UMAP.Core.UmapRuntimeReport.md
+- name: Flowthru.Misc.ML.UMAP.Core.Markers
+  href: Flowthru.Misc.ML.UMAP.Core.Markers.md
+  items:
+  - name: Interfaces
+  - name: IMetric
+    href: Flowthru.Misc.ML.UMAP.Core.Markers.IMetric.md
+  - name: IOutputMetric
+    href: Flowthru.Misc.ML.UMAP.Core.Markers.IOutputMetric.md
+- name: Flowthru.Misc.ML.UMAP.Core.Utils
+  href: Flowthru.Misc.ML.UMAP.Core.Utils.md
+  items:
+  - name: Classes
+  - name: CosineMetric
+    href: Flowthru.Misc.ML.UMAP.Core.Utils.CosineMetric.md
+  - name: CustomMetric
+    href: Flowthru.Misc.ML.UMAP.Core.Utils.CustomMetric.md
+  - name: EuclideanMetric
+    href: Flowthru.Misc.ML.UMAP.Core.Utils.EuclideanMetric.md
+  - name: ManhattanMetric
+    href: Flowthru.Misc.ML.UMAP.Core.Utils.ManhattanMetric.md
+- name: Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement
+  href: Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.md
+  items:
+  - name: Classes
+  - name: GraphRefinementResult
+    href: Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.GraphRefinementResult.md
+  - name: Interfaces
+  - name: IGraphRefinementStrategy
+    href: Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.IGraphRefinementStrategy.md
+- name: Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations
+  href: Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations.md
+  items:
+  - name: Classes
+  - name: AdaptiveThresholding
+    href: Flowthru.Misc.ML.UMAP.Strategies.GraphRefinement.Implementations.AdaptiveThresholding.md
+- name: Flowthru.Misc.ML.UMAP.Strategies.LayoutInit
+  href: Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.md
+  items:
+  - name: Classes
+  - name: LayoutInitResult
+    href: Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.LayoutInitResult.md
+  - name: Interfaces
+  - name: ILayoutInitStrategy
+    href: Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.ILayoutInitStrategy.md
+- name: Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations
+  href: Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.md
+  items:
+  - name: Classes
+  - name: RandomInit
+    href: Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.RandomInit.md
+  - name: SpectralInit
+    href: Flowthru.Misc.ML.UMAP.Strategies.LayoutInit.Implementations.SpectralInit.md
+- name: Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization
+  href: Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.md
+  items:
+  - name: Classes
+  - name: LayoutOptimizationResult
+    href: Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.LayoutOptimizationResult.md
+  - name: OptimizationParameters
+    href: Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.OptimizationParameters.md
+  - name: Structs
+  - name: GraphEdge
+    href: Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.GraphEdge.md
+  - name: Interfaces
+  - name: ILayoutOptimizationStrategy
+    href: Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.ILayoutOptimizationStrategy.md
+- name: Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations
+  href: Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.md
+  items:
+  - name: Classes
+  - name: EuclideanSGD
+    href: Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.EuclideanSGD.md
+  - name: EuclideanSGDOptimized
+    href: Flowthru.Misc.ML.UMAP.Strategies.LayoutOptimization.Implementations.EuclideanSGDOptimized.md
+- name: Flowthru.Misc.ML.UMAP.Strategies.LocalMetric
+  href: Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.md
+  items:
+  - name: Classes
+  - name: LocalMetricResult
+    href: Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.LocalMetricResult.md
+  - name: Interfaces
+  - name: ILocalMetricStrategy
+    href: Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.ILocalMetricStrategy.md
+- name: Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations
+  href: Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations.md
+  items:
+  - name: Classes
+  - name: BinarySearchSmoothing
+    href: Flowthru.Misc.ML.UMAP.Strategies.LocalMetric.Implementations.BinarySearchSmoothing.md
+- name: Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength
+  href: Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.md
+  items:
+  - name: Interfaces
+  - name: IMembershipStrengthStrategy
+    href: Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.IMembershipStrengthStrategy.md
+- name: Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations
+  href: Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations.md
+  items:
+  - name: Classes
+  - name: ExponentialKernel
+    href: Flowthru.Misc.ML.UMAP.Strategies.MembershipStrength.Implementations.ExponentialKernel.md
+- name: Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch
+  href: Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.md
+  items:
+  - name: Classes
+  - name: NeighborSearchResult
+    href: Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.NeighborSearchResult.md
+  - name: Interfaces
+  - name: INeighborSearchStrategy
+    href: Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.INeighborSearchStrategy.md
+- name: Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations
+  href: Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.md
+  items:
+  - name: Classes
+  - name: BruteForceSearch
+    href: Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.BruteForceSearch.md
+  - name: NNDescentSearch
+    href: Flowthru.Misc.ML.UMAP.Strategies.NeighborSearch.Implementations.NNDescentSearch.md
+- name: Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule
+  href: Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.md
+  items:
+  - name: Classes
+  - name: SamplingScheduleResult
+    href: Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.SamplingScheduleResult.md
+  - name: Interfaces
+  - name: ISamplingScheduleStrategy
+    href: Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.ISamplingScheduleStrategy.md
+- name: Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations
+  href: Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations.md
+  items:
+  - name: Classes
+  - name: ProportionalSampling
+    href: Flowthru.Misc.ML.UMAP.Strategies.SamplingSchedule.Implementations.ProportionalSampling.md
diff --git a/docs/tutorials/spaceflights/02-set-up-data.md b/docs/tutorials/spaceflights/02-set-up-data.md
index 4631fd85..cdfe93d3 100644
--- a/docs/tutorials/spaceflights/02-set-up-data.md
+++ b/docs/tutorials/spaceflights/02-set-up-data.md
@@ -157,10 +157,10 @@ public partial class Catalog
 {
   /// ...
 
-  public ICatalogEntry<IEnumerable<__SCHEMA__>> __NAME__ =>
+  public IItem<IEnumerable<__SCHEMA__>> __NAME__ =>
     GetOrCreateEntry(
       () =>
-        CatalogEntries.Enumerable.__FORMAT__<__SCHEMA__>(
+        Items.Enumerable.__FORMAT__<__SCHEMA__>(
           label: "__NAME__",
           path: "__PATH__"
         )
@@ -187,10 +187,10 @@ For our CompanySchema then:
 Our entry for Companies, then, will look like:
 
 ```cs
-  public ICatalogEntry<IEnumerable<CompanySchema>> Companies =>
+  public IItem<IEnumerable<CompanySchema>> Companies =>
     GetOrCreateEntry(
       () =>
-        CatalogEntries.Enumerable.Csv<CompanySchema>(
+        Items.Enumerable.Csv<CompanySchema>(
           label: "Companies",
           path: $"{basePath}/Data/_01_Raw/Datasets/companies.csv"
         )
@@ -210,28 +210,28 @@ public partial class Catalog
 
   // Minimal "Names" Entry — keep it for now, to keep the project building.
 
-  public ICatalogEntry<IEnumerable<CompanySchema>> Companies =>
+  public IItem<IEnumerable<CompanySchema>> Companies =>
     GetOrCreateEntry(
       () =>
-        CatalogEntries.Enumerable.Csv<CompanySchema>(
+        Items.Enumerable.Csv<CompanySchema>(
           label: "Companies",
           filePath: $"{_basePath}/_01_Raw/Datasets/companies.csv"
         )
     );
 
-  public ICatalogEntry<IEnumerable<ReviewSchema>> Reviews =>
+  public IItem<IEnumerable<ReviewSchema>> Reviews =>
     GetOrCreateEntry(
       () =>
-        CatalogEntries.Enumerable.Csv<ReviewSchema>(
+        Items.Enumerable.Csv<ReviewSchema>(
           label: "Reviews",
           filePath: $"{_basePath}/_01_Raw/Datasets/reviews.csv"
         )
     );
 
-  public ICatalogEntry<IEnumerable<ShuttleSchema>> Shuttles =>
+  public IItem<IEnumerable<ShuttleSchema>> Shuttles =>
     GetOrCreateEntry(
       () =>
-        CatalogEntries.Enumerable.Excel<ShuttleSchema>(
+        Items.Enumerable.Excel<ShuttleSchema>(
           label: "Shuttles",
           filePath: $"{_basePath}/_01_Raw/Datasets/shuttles.xlsx",
           sheetName: "Sheet1"
diff --git a/examples/advanced/KedroSpaceflights.Custom/Data/Catalog.cs b/examples/advanced/KedroSpaceflights.Custom/Data/Catalog.cs
index 4df30de8..d9ced3fe 100644
--- a/examples/advanced/KedroSpaceflights.Custom/Data/Catalog.cs
+++ b/examples/advanced/KedroSpaceflights.Custom/Data/Catalog.cs
@@ -19,7 +19,7 @@ namespace KedroSpaceflights.Custom.Data;
 /// <item>_99_Reference: Reference data for validation</item>
 /// </list>
 /// </remarks>
-public partial class Catalog : DataCatalogBase
+public partial class Catalog : CatalogAbstract
 {
   private readonly string _basePath;
 
diff --git a/examples/advanced/KedroSpaceflights.Custom/Data/_01_Raw/Catalog.Raw.cs b/examples/advanced/KedroSpaceflights.Custom/Data/_01_Raw/Catalog.Raw.cs
index 3df69275..bc086d7d 100644
--- a/examples/advanced/KedroSpaceflights.Custom/Data/_01_Raw/Catalog.Raw.cs
+++ b/examples/advanced/KedroSpaceflights.Custom/Data/_01_Raw/Catalog.Raw.cs
@@ -14,10 +14,10 @@ public partial class Catalog
   /// This is a critical Layer 0 input from an external source, configured for deep inspection
   /// to ensure data quality before pipeline execution.
   /// </remarks>
-  public ICatalogEntry<IEnumerable<CompanyRawSchema>> Companies =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<CompanyRawSchema>> Companies =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<CompanyRawSchema>(
+        ItemFactory.Enumerable.Csv<CompanyRawSchema>(
           label: "RawCompanies",
           filePath: $"{_basePath}/_01_Raw/Datasets/companies.csv"
         )
@@ -31,10 +31,10 @@ public partial class Catalog
   /// This is a critical Layer 0 input from an external source, configured for deep inspection
   /// to ensure data quality before pipeline execution.
   /// </remarks>
-  public ICatalogEntry<IEnumerable<ReviewRawSchema>> Reviews =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ReviewRawSchema>> Reviews =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<ReviewRawSchema>(
+        ItemFactory.Enumerable.Csv<ReviewRawSchema>(
           label: "RawReviews",
           filePath: $"{_basePath}/_01_Raw/Datasets/reviews.csv"
         )
@@ -50,10 +50,10 @@ public partial class Catalog
   /// This is a critical Layer 0 input from an external source, configured for deep inspection
   /// to ensure data quality before pipeline execution.
   /// </remarks>
-  public ICatalogEntry<IEnumerable<ShuttleRawSchema>> Shuttles =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ShuttleRawSchema>> Shuttles =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Excel<ShuttleRawSchema>(
+        ItemFactory.Enumerable.Excel<ShuttleRawSchema>(
           label: "RawShuttles",
           filePath: $"{_basePath}/_01_Raw/Datasets/shuttles.xlsx",
           sheetName: "Sheet1"
@@ -69,10 +69,10 @@ public partial class Catalog
   /// used for validation purposes in the DataDiagnostics pipeline.
   /// Uses KedroModelInputSchema to match the external Kedro CSV format.
   /// </remarks>
-  public ICatalogEntry<IEnumerable<KedroModelInputSchema>> KedroModelInputTable =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<KedroModelInputSchema>> KedroModelInputTable =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<KedroModelInputSchema>(
+        ItemFactory.Enumerable.Csv<KedroModelInputSchema>(
           label: "KedroModelInputTable",
           filePath: $"{_basePath}/_01_Raw/Datasets/kedro_model_input_table.csv"
         )
diff --git a/examples/advanced/KedroSpaceflights.Custom/Data/_02_Intermediate/Catalog.Intermediate.cs b/examples/advanced/KedroSpaceflights.Custom/Data/_02_Intermediate/Catalog.Intermediate.cs
index 72402a3a..e94dd20d 100644
--- a/examples/advanced/KedroSpaceflights.Custom/Data/_02_Intermediate/Catalog.Intermediate.cs
+++ b/examples/advanced/KedroSpaceflights.Custom/Data/_02_Intermediate/Catalog.Intermediate.cs
@@ -9,10 +9,10 @@ public partial class Catalog
   /// Preprocessed company data in Parquet format.
   /// Cleaned and validated company records.
   /// </summary>
-  public ICatalogEntry<IEnumerable<CompanySchema>> CleanedCompanies =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<CompanySchema>> CleanedCompanies =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<CompanySchema>(
+        ItemFactory.Enumerable.Parquet<CompanySchema>(
           label: "CleanedCompanies",
           filePath: $"{_basePath}/_02_Intermediate/Datasets/cleaned_companies.parquet"
         )
@@ -22,10 +22,10 @@ public partial class Catalog
   /// Preprocessed shuttle data in Parquet format.
   /// Cleaned and validated shuttle records.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ShuttleSchema>> CleanedShuttles =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ShuttleSchema>> CleanedShuttles =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<ShuttleSchema>(
+        ItemFactory.Enumerable.Parquet<ShuttleSchema>(
           label: "CleanedShuttles",
           filePath: $"{_basePath}/_02_Intermediate/Datasets/cleaned_shuttles.parquet"
         )
@@ -35,10 +35,10 @@ public partial class Catalog
   /// Preprocessed review data in Parquet format.
   /// Cleaned and validated review records with parsed numeric scores.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ReviewSchema>> CleanedReviews =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ReviewSchema>> CleanedReviews =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<ReviewSchema>(
+        ItemFactory.Enumerable.Parquet<ReviewSchema>(
           label: "CleanedReviews",
           filePath: $"{_basePath}/_02_Intermediate/Datasets/cleaned_reviews.parquet"
         )
@@ -47,10 +47,10 @@ public partial class Catalog
   /// <summary>
   /// Preprocessed companies exported as CSV (for debugging).
   /// </summary>
-  public ICatalogEntry<IEnumerable<CompanySchema>> CleanedCompaniesCsv =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<CompanySchema>> CleanedCompaniesCsv =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<CompanySchema>(
+        ItemFactory.Enumerable.Csv<CompanySchema>(
           label: "CleanedCompaniesCsv",
           filePath: $"{_basePath}/_02_Intermediate/Datasets/cleaned_companies.csv"
         )
@@ -59,10 +59,10 @@ public partial class Catalog
   /// <summary>
   /// Preprocessed shuttles exported as CSV (for debugging).
   /// </summary>
-  public ICatalogEntry<IEnumerable<ShuttleSchema>> CleanedShuttlesCsv =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ShuttleSchema>> CleanedShuttlesCsv =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<ShuttleSchema>(
+        ItemFactory.Enumerable.Csv<ShuttleSchema>(
           label: "CleanedShuttlesCsv",
           filePath: $"{_basePath}/_02_Intermediate/Datasets/cleaned_shuttles.csv"
         )
diff --git a/examples/advanced/KedroSpaceflights.Custom/Data/_03_Primary/Catalog.Primary.cs b/examples/advanced/KedroSpaceflights.Custom/Data/_03_Primary/Catalog.Primary.cs
index 87beb44b..9408ab32 100644
--- a/examples/advanced/KedroSpaceflights.Custom/Data/_03_Primary/Catalog.Primary.cs
+++ b/examples/advanced/KedroSpaceflights.Custom/Data/_03_Primary/Catalog.Primary.cs
@@ -10,10 +10,10 @@ public partial class Catalog
   /// Model input table in Parquet format.
   /// Joined dataset ready for ML training.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ModelInputSchema>> ModelInputTable =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ModelInputSchema>> ModelInputTable =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<ModelInputSchema>(
+        ItemFactory.Enumerable.Parquet<ModelInputSchema>(
           label: "ModelInputTable",
           filePath: $"{_basePath}/_03_Primary/Datasets/model_input_table.parquet"
         )
@@ -22,10 +22,10 @@ public partial class Catalog
   /// <summary>
   /// Model input table exported as minified JSON (compact, production-ready format).
   /// </summary>
-  public ICatalogEntry<IEnumerable<ModelInputSchema>> ModelInputTableJsonMinified =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ModelInputSchema>> ModelInputTableJsonMinified =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Json<ModelInputSchema>(
+        ItemFactory.Enumerable.Json<ModelInputSchema>(
           label: "ModelInputTableJsonMinified",
           filePath: $"{_basePath}/_03_Primary/Datasets/model_input_table.min.json"
         )
@@ -34,10 +34,10 @@ public partial class Catalog
   /// <summary>
   /// Model input table exported as CSV (for debugging).
   /// </summary>
-  public ICatalogEntry<IEnumerable<ModelInputSchema>> ModelInputTableCsv =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ModelInputSchema>> ModelInputTableCsv =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<ModelInputSchema>(
+        ItemFactory.Enumerable.Csv<ModelInputSchema>(
           label: "ModelInputTableCsv",
           filePath: $"{_basePath}/_03_Primary/Datasets/model_input_table.csv"
         )
@@ -48,18 +48,18 @@ public partial class Catalog
   /// Feature vectors for model training.
   /// Stored in memory as it's only used within the DataScience pipeline.
   /// </summary>
-  public ICatalogEntry<IEnumerable<FeatureRow>> XTrain =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<FeatureRow>(label: "XTrain"));
+  public IItem<IEnumerable<FeatureRow>> XTrain =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<FeatureRow>(label: "XTrain"));
 
   /// <summary>
   /// Testing features (X_test).
   /// Feature vectors for model evaluation.
   /// Stored as Parquet to enable cross-pipeline usage (DataEvaluation depends on this).
   /// </summary>
-  public ICatalogEntry<IEnumerable<FeatureRow>> XTest =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<FeatureRow>> XTest =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<FeatureRow>(
+        ItemFactory.Enumerable.Parquet<FeatureRow>(
           label: "XTest",
           filePath: $"{_basePath}/_03_Primary/Datasets/x_test.parquet"
         )
@@ -70,18 +70,18 @@ public partial class Catalog
   /// Target prices for model training.
   /// Stored in memory as it's only used within the DataScience pipeline.
   /// </summary>
-  public ICatalogEntry<IEnumerable<TargetValue>> YTrain =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TargetValue>(label: "YTrain"));
+  public IItem<IEnumerable<TargetValue>> YTrain =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TargetValue>(label: "YTrain"));
 
   /// <summary>
   /// Testing targets (y_test).
   /// Target prices for model evaluation.
   /// Stored as Parquet to enable cross-pipeline usage (DataEvaluation depends on this).
   /// </summary>
-  public ICatalogEntry<IEnumerable<TargetValue>> YTest =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<TargetValue>> YTest =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<TargetValue>(
+        ItemFactory.Enumerable.Parquet<TargetValue>(
           label: "YTest",
           filePath: $"{_basePath}/_03_Primary/Datasets/y_test.parquet"
         )
diff --git a/examples/advanced/KedroSpaceflights.Custom/Data/_04_Models/Catalog.Models.cs b/examples/advanced/KedroSpaceflights.Custom/Data/_04_Models/Catalog.Models.cs
index 9cd6df7f..4ef5dac6 100644
--- a/examples/advanced/KedroSpaceflights.Custom/Data/_04_Models/Catalog.Models.cs
+++ b/examples/advanced/KedroSpaceflights.Custom/Data/_04_Models/Catalog.Models.cs
@@ -10,10 +10,10 @@ public partial class Catalog
   /// Contains intercept and coefficients for price prediction.
   /// Stored as JSON to enable cross-pipeline usage (DataEvaluation depends on this).
   /// </summary>
-  public ICatalogEntry<LinearRegressionModel> Regressor =>
-    GetOrCreateEntry(
+  public IItem<LinearRegressionModel> Regressor =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<LinearRegressionModel>(
+        ItemFactory.Single.Json<LinearRegressionModel>(
           label: "Regressor",
           filePath: $"{_basePath}/_04_Models/Datasets/regressor.json"
         )
diff --git a/examples/advanced/KedroSpaceflights.Custom/Data/_05_ModelOutput/Catalog.ModelOutput.cs b/examples/advanced/KedroSpaceflights.Custom/Data/_05_ModelOutput/Catalog.ModelOutput.cs
index bcb7d0af..f828df88 100644
--- a/examples/advanced/KedroSpaceflights.Custom/Data/_05_ModelOutput/Catalog.ModelOutput.cs
+++ b/examples/advanced/KedroSpaceflights.Custom/Data/_05_ModelOutput/Catalog.ModelOutput.cs
@@ -10,10 +10,10 @@ public partial class Catalog
   /// Contains R², MAE, RMSE, etc.
   /// Stored as a singleton object (pipeline produces single metrics object).
   /// </summary>
-  public ICatalogEntry<ModelMetrics> ModelMetrics =>
-    GetOrCreateEntry(
+  public IItem<ModelMetrics> ModelMetrics =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<ModelMetrics>(
+        ItemFactory.Single.Json<ModelMetrics>(
           label: "ModelMetrics",
           filePath: $"{_basePath}/_05_ModelOutput/Datasets/model_metrics.json"
         )
@@ -23,10 +23,10 @@ public partial class Catalog
   /// Model predictions with actual and predicted values.
   /// Used for evaluation and visualization.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ModelPredictions>> ModelPredictions =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ModelPredictions>> ModelPredictions =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<ModelPredictions>(
+        ItemFactory.Enumerable.Csv<ModelPredictions>(
           label: "ModelPredictions",
           filePath: $"{_basePath}/_05_ModelOutput/Datasets/model_predictions.csv"
         )
diff --git a/examples/advanced/KedroSpaceflights.Custom/Data/_06_Reporting/Catalog.Reporting.cs b/examples/advanced/KedroSpaceflights.Custom/Data/_06_Reporting/Catalog.Reporting.cs
index e4af2e4f..a6e539b8 100644
--- a/examples/advanced/KedroSpaceflights.Custom/Data/_06_Reporting/Catalog.Reporting.cs
+++ b/examples/advanced/KedroSpaceflights.Custom/Data/_06_Reporting/Catalog.Reporting.cs
@@ -11,10 +11,10 @@ public partial class Catalog
   /// Contains metrics for each fold, mean, std dev, and comparison to Kedro.
   /// Stored as JSON to preserve nested List&lt;FoldMetric&gt; structure.
   /// </summary>
-  public ICatalogEntry<CrossValidationResults> CrossValidationResults =>
-    GetOrCreateEntry(
+  public IItem<CrossValidationResults> CrossValidationResults =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<CrossValidationResults>(
+        ItemFactory.Single.Json<CrossValidationResults>(
           label: "CrossValidationResults",
           filePath: $"{_basePath}/_06_Reporting/Datasets/cross_validation_results.json"
         )
@@ -24,10 +24,10 @@ public partial class Catalog
   /// Cross-validation summary report in Markdown format.
   /// Human-readable report summarizing model performance and validation results.
   /// </summary>
-  public ICatalogEntry<string> CrossValidationReport =>
-    GetOrCreateEntry(
+  public IItem<string> CrossValidationReport =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Text(
+        ItemFactory.Single.Text(
           label: "CrossValidationReport",
           filePath: $"{_basePath}/_06_Reporting/Datasets/cross_validation_report.md"
         )
@@ -37,9 +37,9 @@ public partial class Catalog
   /// Shuttle passenger capacity bar chart (in-memory GenericChart).
   /// Intermediate chart object stored in memory for downstream export to multiple formats.
   /// </summary>
-  public ICatalogEntry<GenericChart> ShuttlePassengerCapacityChart =>
-    GetOrCreateEntry(
-      () => CatalogEntries.Single.Memory<GenericChart>(label: "ShuttlePassengerCapacityChart")
+  public IItem<GenericChart> ShuttlePassengerCapacityChart =>
+    CreateItem(
+      () => ItemFactory.Single.Memory<GenericChart>(label: "ShuttlePassengerCapacityChart")
     );
 
   /// <summary>
@@ -52,10 +52,10 @@ public partial class Catalog
   /// figure specification with data traces and layout configuration. Can be rendered in browsers
   /// using plotly.js or converted to static images using Plotly.NET.ImageExport.
   /// </remarks>
-  public ICatalogEntry<string> ShuttlePassengerCapacityPlot =>
-    GetOrCreateEntry(
+  public IItem<string> ShuttlePassengerCapacityPlot =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Text(
+        ItemFactory.Single.Text(
           label: "ShuttlePassengerCapacityPlot",
           filePath: $"{_basePath}/_06_Reporting/Datasets/shuttle_passenger_capacity_plot.json"
         )
@@ -65,10 +65,8 @@ public partial class Catalog
   /// Confusion matrix heatmap (in-memory GenericChart).
   /// Intermediate chart object stored in memory for downstream export to multiple formats.
   /// </summary>
-  public ICatalogEntry<GenericChart> ConfusionMatrixChart =>
-    GetOrCreateEntry(
-      () => CatalogEntries.Single.Memory<GenericChart>(label: "ConfusionMatrixChart")
-    );
+  public IItem<GenericChart> ConfusionMatrixChart =>
+    CreateItem(() => ItemFactory.Single.Memory<GenericChart>(label: "ConfusionMatrixChart"));
 
   /// <summary>
   /// Confusion matrix heatmap visualization (Plotly JSON).
@@ -80,10 +78,10 @@ public partial class Catalog
   /// The heatmap displays a 2x2 confusion matrix with color-coded cells showing classification
   /// performance. JSON format allows browser-based rendering and potential conversion to PNG.
   /// </remarks>
-  public ICatalogEntry<string> ConfusionMatrixPlot =>
-    GetOrCreateEntry(
+  public IItem<string> ConfusionMatrixPlot =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Text(
+        ItemFactory.Single.Text(
           label: "ConfusionMatrixPlot",
           filePath: $"{_basePath}/_06_Reporting/Datasets/confusion_matrix_plot.json"
         )
@@ -95,13 +93,13 @@ public partial class Catalog
   /// Stored as binary PNG file.
   /// </summary>
   /// <remarks>
-  /// Uses CatalogEntries.Binary factory method to store actual PNG binary data with proper file format.
+  /// Uses ItemFactory.Binary factory method to store actual PNG binary data with proper file format.
   /// The PNG file can be opened directly in image viewers or embedded in reports.
   /// </remarks>
-  public ICatalogEntry<byte[]> ShuttlePassengerCapacityPlotPng =>
-    GetOrCreateEntry(
+  public IItem<byte[]> ShuttlePassengerCapacityPlotPng =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "ShuttlePassengerCapacityPlotPng",
           filePath: $"{_basePath}/_06_Reporting/Datasets/shuttle_passenger_capacity_plot.png"
         )
@@ -113,13 +111,13 @@ public partial class Catalog
   /// Stored as binary PNG file.
   /// </summary>
   /// <remarks>
-  /// Uses CatalogEntries.Binary factory method to store actual PNG binary data with proper file format.
+  /// Uses ItemFactory.Binary factory method to store actual PNG binary data with proper file format.
   /// The PNG file can be opened directly in image viewers or embedded in reports.
   /// </remarks>
-  public ICatalogEntry<byte[]> ConfusionMatrixPlotPng =>
-    GetOrCreateEntry(
+  public IItem<byte[]> ConfusionMatrixPlotPng =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "ConfusionMatrixPlotPng",
           filePath: $"{_basePath}/_06_Reporting/Datasets/confusion_matrix_plot.png"
         )
@@ -130,10 +128,8 @@ public partial class Catalog
   /// Intermediate chart object showing R² distribution analysis with scatter plot,
   /// normal curve, mean line, and Kedro reference line.
   /// </summary>
-  public ICatalogEntry<GenericChart> CrossValidationChart =>
-    GetOrCreateEntry(
-      () => CatalogEntries.Single.Memory<GenericChart>(label: "CrossValidationChart")
-    );
+  public IItem<GenericChart> CrossValidationChart =>
+    CreateItem(() => ItemFactory.Single.Memory<GenericChart>(label: "CrossValidationChart"));
 
   /// <summary>
   /// Cross-validation visualization (Plotly JSON).
@@ -146,10 +142,10 @@ public partial class Catalog
   /// <remarks>
   /// Stored as Plotly JSON specification for interactive visualization.
   /// </remarks>
-  public ICatalogEntry<string> CrossValidationPlot =>
-    GetOrCreateEntry(
+  public IItem<string> CrossValidationPlot =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Text(
+        ItemFactory.Single.Text(
           label: "CrossValidationPlot",
           filePath: $"{_basePath}/_06_Reporting/Datasets/cross_validation_plot.json"
         )
@@ -161,13 +157,13 @@ public partial class Catalog
   /// Stored as binary PNG file.
   /// </summary>
   /// <remarks>
-  /// Uses CatalogEntries.Binary factory method to store actual PNG binary data with proper file format.
+  /// Uses ItemFactory.Binary factory method to store actual PNG binary data with proper file format.
   /// The PNG file can be opened directly in image viewers or embedded in reports.
   /// </remarks>
-  public ICatalogEntry<byte[]> CrossValidationPlotPng =>
-    GetOrCreateEntry(
+  public IItem<byte[]> CrossValidationPlotPng =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "CrossValidationPlotPng",
           filePath: $"{_basePath}/_06_Reporting/Datasets/cross_validation_plot.png"
         )
@@ -178,10 +174,8 @@ public partial class Catalog
   /// Intermediate chart object showing actual vs predicted values with color-coded dots
   /// (yellow for over-estimates, red for under-estimates) and a 1:1 identity reference line.
   /// </summary>
-  public ICatalogEntry<GenericChart> PredictionScatterChart =>
-    GetOrCreateEntry(
-      () => CatalogEntries.Single.Memory<GenericChart>(label: "PredictionScatterChart")
-    );
+  public IItem<GenericChart> PredictionScatterChart =>
+    CreateItem(() => ItemFactory.Single.Memory<GenericChart>(label: "PredictionScatterChart"));
 
   /// <summary>
   /// Prediction scatter plot visualization (Plotly JSON).
@@ -194,10 +188,10 @@ public partial class Catalog
   /// <remarks>
   /// Stored as Plotly JSON specification for interactive visualization.
   /// </remarks>
-  public ICatalogEntry<string> PredictionScatterPlot =>
-    GetOrCreateEntry(
+  public IItem<string> PredictionScatterPlot =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Text(
+        ItemFactory.Single.Text(
           label: "PredictionScatterPlot",
           filePath: $"{_basePath}/_06_Reporting/Datasets/prediction_scatter_plot.json"
         )
@@ -209,13 +203,13 @@ public partial class Catalog
   /// Stored as binary PNG file at 600x600 resolution.
   /// </summary>
   /// <remarks>
-  /// Uses CatalogEntries.Binary factory method to store actual PNG binary data with proper file format.
+  /// Uses ItemFactory.Binary factory method to store actual PNG binary data with proper file format.
   /// The PNG file can be opened directly in image viewers or embedded in reports.
   /// </remarks>
-  public ICatalogEntry<byte[]> PredictionScatterPlotPng =>
-    GetOrCreateEntry(
+  public IItem<byte[]> PredictionScatterPlotPng =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "PredictionScatterPlotPng",
           filePath: $"{_basePath}/_06_Reporting/Datasets/prediction_scatter_plot.png"
         )
diff --git a/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataDiagnostics/DataDiagnosticsPipeline.cs b/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataDiagnostics/DataDiagnosticsPipeline.cs
index f41445bd..45e4e062 100644
--- a/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataDiagnostics/DataDiagnosticsPipeline.cs
+++ b/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataDiagnostics/DataDiagnosticsPipeline.cs
@@ -1,5 +1,5 @@
-using Flowthru.Nodes;
-using Flowthru.Pipelines;
+using Flowthru.Flows;
+using Flowthru.Steps;
 using KedroSpaceflights.Custom.Data;
 using KedroSpaceflights.Custom.Data._02_Intermediate.Schemas;
 using KedroSpaceflights.Custom.Data._03_Primary.Schemas;
@@ -31,12 +31,12 @@ namespace KedroSpaceflights.Custom.Pipelines.DataDiagnostics;
 /// </summary>
 public static class DataDiagnosticsPipeline
 {
-  public static Pipeline Create(Catalog catalog)
+  public static Flow Create(Catalog catalog)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
       // Node 1: Validate model input table against Kedro reference output (demonstrates NoData output pattern)
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ValidateModelInputTableAgainstKedroSource",
         transform: ValidateAgainstKedroNode.Create(),
         input: (catalog.ModelInputTable, catalog.KedroModelInputTable),
@@ -44,7 +44,7 @@ public static Pipeline Create(Catalog catalog)
       );
 
       // Node 2: Export cleaned companies to CSV for manual inspection
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ExportCompaniesToDiagnosticCsv",
         transform: PassthroughInputToOutputNode<CompanySchema>.Create(),
         input: catalog.CleanedCompanies,
@@ -52,7 +52,7 @@ public static Pipeline Create(Catalog catalog)
       );
 
       // Node 3: Export cleaned shuttles to CSV for manual inspection
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ExportShuttlesToDiagnosticCsv",
         transform: PassthroughInputToOutputNode<ShuttleSchema>.Create(),
         input: catalog.CleanedShuttles,
@@ -60,7 +60,7 @@ public static Pipeline Create(Catalog catalog)
       );
 
       // Node 4: Export model input table to CSV for manual inspection
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ExportModelInputTableToDiagnosticCsv",
         transform: PassthroughInputToOutputNode<ModelInputSchema>.Create(),
         input: catalog.ModelInputTable,
@@ -68,7 +68,7 @@ public static Pipeline Create(Catalog catalog)
       );
 
       // Node 5: Export model input table to minified JSON for production/compact storage
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ExportModelInputTableToMinifiedJson",
         transform: PassthroughInputToOutputNode<ModelInputSchema>.Create(),
         input: catalog.ModelInputTable,
diff --git a/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataDiagnostics/Nodes/ValidateAgainstKedroNode.cs b/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataDiagnostics/Nodes/ValidateAgainstKedroNode.cs
index d0f7db30..a3813ca4 100644
--- a/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataDiagnostics/Nodes/ValidateAgainstKedroNode.cs
+++ b/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataDiagnostics/Nodes/ValidateAgainstKedroNode.cs
@@ -1,5 +1,5 @@
 using System.Reflection;
-using Flowthru.Nodes;
+using Flowthru.Steps;
 using KedroSpaceflights.Custom.Data._01_Raw.Schemas;
 using KedroSpaceflights.Custom.Data._03_Primary.Schemas;
 
diff --git a/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataEvaluation/DataEvaluationPipeline.cs b/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataEvaluation/DataEvaluationPipeline.cs
index d3f6becb..bbe5c5b4 100644
--- a/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataEvaluation/DataEvaluationPipeline.cs
+++ b/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataEvaluation/DataEvaluationPipeline.cs
@@ -1,5 +1,5 @@
-using Flowthru.Nodes;
-using Flowthru.Pipelines;
+using Flowthru.Flows;
+using Flowthru.Steps;
 using KedroSpaceflights.Custom.Data;
 using KedroSpaceflights.Custom.Data._03_Primary.Schemas;
 using KedroSpaceflights.Custom.Data._04_Models.Schemas;
@@ -43,12 +43,12 @@ public class Params
     public CrossValidateModelNode.Params CrossValidationParams { get; init; } = new();
   }
 
-  public static Pipeline Create(Catalog catalog, Params parameters)
+  public static Flow Create(Catalog catalog, Params parameters)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
       // Node 1: Evaluate OLS model (multi-input → multi-output)
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "EvaluateOLSModel",
         transform: EvaluateModelNode.Create(),
         input: (catalog.Regressor, catalog.XTest, catalog.YTest),
@@ -56,7 +56,7 @@ public static Pipeline Create(Catalog catalog, Params parameters)
       );
 
       // Node 2: Cross-validation for R² distribution analysis and comparison to Kedro
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "PerformCrossValidatedOLSRegressionTest",
         transform: CrossValidateModelNode.Create(parameters.CrossValidationParams),
         input: catalog.ModelInputTable,
diff --git a/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataProcessing/DataProcessingPipeline.cs b/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataProcessing/DataProcessingPipeline.cs
index 14962d15..46359e38 100644
--- a/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataProcessing/DataProcessingPipeline.cs
+++ b/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataProcessing/DataProcessingPipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using KedroSpaceflights.Custom.Data;
 using KedroSpaceflights.Custom.Pipelines.DataProcessing.Nodes;
 
@@ -27,12 +27,12 @@ namespace KedroSpaceflights.Custom.Pipelines.DataProcessing;
 /// </summary>
 public static class DataProcessingPipeline
 {
-  public static Pipeline Create(Catalog catalog)
+  public static Flow Create(Catalog catalog)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
       // Node 1: Preprocess companies (simple: single input → single output)
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "PreprocessCompanies",
         transform: PreprocessCompaniesNode.Create(),
         input: catalog.Companies,
@@ -40,7 +40,7 @@ public static Pipeline Create(Catalog catalog)
       );
 
       // Node 2: Preprocess shuttles (simple: single input → single output)
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "PreprocessShuttles",
         transform: PreprocessShuttlesNode.Create(),
         input: catalog.Shuttles,
@@ -50,7 +50,7 @@ public static Pipeline Create(Catalog catalog)
       // Node 3: Preprocess reviews (simple: single input → single output)
       // Note: Minor refactor compared to Kedro - we preprocess reviews separately
       // rather than handling raw reviews in create_model_input_table
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "PreprocessReviews",
         transform: PreprocessReviewsNode.Create(),
         input: catalog.Reviews,
@@ -58,7 +58,7 @@ public static Pipeline Create(Catalog catalog)
       );
 
       // Node 4: Create model input table (multi-input: 3 inputs → single output)
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "CreateModelInputTable",
         transform: CreateModelInputTableNode.Create(),
         input: (catalog.CleanedShuttles, catalog.CleanedCompanies, catalog.CleanedReviews),
diff --git a/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataScience/DataSciencePipeline.cs b/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataScience/DataSciencePipeline.cs
index e6b06614..054e3929 100644
--- a/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataScience/DataSciencePipeline.cs
+++ b/examples/advanced/KedroSpaceflights.Custom/Pipelines/DataScience/DataSciencePipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using KedroSpaceflights.Custom.Data;
 using KedroSpaceflights.Custom.Data._03_Primary.Schemas;
 using KedroSpaceflights.Custom.Pipelines.DataEvaluation.Nodes;
@@ -44,12 +44,12 @@ public record Params
     public CreateTestTrainSplitNode.TestTrainSplitParams ModelParams { get; init; } = new();
   }
 
-  public static Pipeline Create(Catalog catalog, Params parameters)
+  public static Flow Create(Catalog catalog, Params parameters)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
       // Node 1: Split data into train/test sets (single input → multi-output)
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "CreateTestTrainSplitDatasets",
         transform: CreateTestTrainSplitNode.Create(parameters: parameters.ModelParams),
         input: catalog.ModelInputTable,
@@ -57,7 +57,7 @@ public static Pipeline Create(Catalog catalog, Params parameters)
       );
 
       // Node 2: Train OLS regression model (multi-input → single output)
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "TrainOLSModel",
         transform: TrainModelNode.Create(),
         input: (catalog.XTrain, catalog.YTrain),
diff --git a/examples/advanced/KedroSpaceflights.Custom/Pipelines/Reporting/Nodes/PlotlyImageExportNode.cs b/examples/advanced/KedroSpaceflights.Custom/Pipelines/Reporting/Nodes/PlotlyImageExportNode.cs
index 21292fca..63e92379 100644
--- a/examples/advanced/KedroSpaceflights.Custom/Pipelines/Reporting/Nodes/PlotlyImageExportNode.cs
+++ b/examples/advanced/KedroSpaceflights.Custom/Pipelines/Reporting/Nodes/PlotlyImageExportNode.cs
@@ -11,13 +11,13 @@ namespace KedroSpaceflights.Custom.Pipelines.Reporting.Nodes;
 /// <para>
 /// This node handles the PNG export concern separately from chart generation,
 /// enabling a clean separation of visualization logic from output format concerns.
-/// The PNG binary data can be stored in a BinaryFileCatalogEntry&lt;byte[]&gt;.
+/// The PNG binary data can be stored in a BinaryFileItem&lt;byte[]&gt;.
 /// </para>
 /// <para>
 /// <strong>Input:</strong> GenericChart object from memory catalog
 /// </para>
 /// <para>
-/// <strong>Output:</strong> PNG binary data as byte[] (can be stored in BinaryFileCatalogEntry&lt;byte[]&gt;)
+/// <strong>Output:</strong> PNG binary data as byte[] (can be stored in BinaryFileItem&lt;byte[]&gt;)
 /// </para>
 /// <para>
 /// <strong>Reusability:</strong> This node can be used for any Plotly chart type
diff --git a/examples/advanced/KedroSpaceflights.Custom/Pipelines/Reporting/ReportingPipeline.cs b/examples/advanced/KedroSpaceflights.Custom/Pipelines/Reporting/ReportingPipeline.cs
index c8ffeb4d..50b762cc 100644
--- a/examples/advanced/KedroSpaceflights.Custom/Pipelines/Reporting/ReportingPipeline.cs
+++ b/examples/advanced/KedroSpaceflights.Custom/Pipelines/Reporting/ReportingPipeline.cs
@@ -1,5 +1,5 @@
-using Flowthru.Nodes;
-using Flowthru.Pipelines;
+using Flowthru.Flows;
+using Flowthru.Steps;
 using KedroSpaceflights.Custom.Data;
 using KedroSpaceflights.Custom.Pipelines.Reporting.Nodes;
 
@@ -42,14 +42,14 @@ namespace KedroSpaceflights.Custom.Pipelines.Reporting;
 /// </remarks>
 public static class ReportingPipeline
 {
-  public static Pipeline Create(Catalog catalog)
+  public static Flow Create(Catalog catalog)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
       // ===== Shuttle Passenger Capacity Visualization =====
 
       // Step 1: Generate chart from processed shuttle data
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "GeneratePassengerCapacityChart",
         transform: ComparePassengerCapacityNode.Create(),
         input: catalog.CleanedShuttles,
@@ -57,7 +57,7 @@ public static Pipeline Create(Catalog catalog)
       );
 
       // Step 2: Export chart to JSON for interactive visualization
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ExportPassengerCapacityJson",
         transform: PlotlyJsonExportNode.Create(),
         input: catalog.ShuttlePassengerCapacityChart,
@@ -66,7 +66,7 @@ public static Pipeline Create(Catalog catalog)
 
       // Removed to cut down Chromium dependency for test runs.
       // // Step 3: Export chart to base64-encoded PNG for static reports
-      // pipeline.AddNode(
+      // pipeline.AddStep(
       //   label: "ExportPassengerCapacityPng",
       //   transform: PlotlyImageExportNode.Create(),
       //   input: catalog.ShuttlePassengerCapacityChart,
@@ -76,7 +76,7 @@ public static Pipeline Create(Catalog catalog)
       // ===== Confusion Matrix Visualization =====
 
       // Step 1: Generate confusion matrix heatmap from company data
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "GenerateConfusionMatrixChart",
         transform: CreateConfusionMatrixNode.Create(),
         input: catalog.CleanedCompanies,
@@ -84,7 +84,7 @@ public static Pipeline Create(Catalog catalog)
       );
 
       // Step 2: Export chart to JSON for interactive visualization
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ExportConfusionMatrixJson",
         transform: PlotlyJsonExportNode.Create(),
         input: catalog.ConfusionMatrixChart,
@@ -93,7 +93,7 @@ public static Pipeline Create(Catalog catalog)
 
       // Removed to cut down Chromium dependency for test runs.
       // // Step 3: Export chart to base64-encoded PNG for static reports
-      // pipeline.AddNode(
+      // pipeline.AddStep(
       //   label: "ExportConfusionMatrixPng",
       //   transform: PlotlyImageExportNode.Create(),
       //   input: catalog.ConfusionMatrixChart,
@@ -103,7 +103,7 @@ public static Pipeline Create(Catalog catalog)
       // ===== Cross-Validation Results Visualization =====
 
       // Step 1: Generate comprehensive cross-validation chart
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "GenerateCrossValidationChart",
         transform: VisualizeCrossValidationNode.Create(),
         input: catalog.CrossValidationResults,
@@ -111,7 +111,7 @@ public static Pipeline Create(Catalog catalog)
       );
 
       // Step 2: Export chart to JSON for interactive visualization
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ExportCrossValidationJson",
         transform: PlotlyJsonExportNode.Create(),
         input: catalog.CrossValidationChart,
@@ -120,7 +120,7 @@ public static Pipeline Create(Catalog catalog)
 
       // Removed to cut down Chromium dependency for test runs.
       // Step 3: Export chart to base64-encoded PNG for static reports
-      // pipeline.AddNode(
+      // pipeline.AddStep(
       //   label: "ExportCrossValidationPng",
       //   transform: PlotlyImageExportNode.Create(),
       //   input: catalog.CrossValidationChart,
@@ -128,7 +128,7 @@ public static Pipeline Create(Catalog catalog)
       // );
 
       // Node 6: Generate human-readable Markdown report from cross-validation results
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "GenerateCrossValidationReport",
         transform: GenerateCrossValidationReportNode.Create(),
         input: catalog.CrossValidationResults,
@@ -138,7 +138,7 @@ public static Pipeline Create(Catalog catalog)
       // ===== Prediction Scatter Plot Visualization =====
 
       // Step 1: Generate scatter plot from model metrics and predictions
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "GeneratePredictionScatterChart",
         transform: GeneratePredictionScatterNode.Create(),
         input: (catalog.ModelMetrics, catalog.ModelPredictions),
@@ -146,7 +146,7 @@ public static Pipeline Create(Catalog catalog)
       );
 
       // Step 2: Export chart to JSON for interactive visualization
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ExportPredictionScatterJson",
         transform: PlotlyJsonExportNode.Create(),
         input: catalog.PredictionScatterChart,
@@ -155,7 +155,7 @@ public static Pipeline Create(Catalog catalog)
 
       // Removed to cut down Chromium dependency for test runs.
       // // Step 3: Export chart to PNG for static reports
-      // pipeline.AddNode(
+      // pipeline.AddStep(
       //   label: "ExportPredictionScatterPng",
       //   transform: PlotlyImageExportNode.Create(),
       //   input: catalog.PredictionScatterChart,
diff --git a/examples/advanced/KedroSpaceflights.Custom/Program.cs b/examples/advanced/KedroSpaceflights.Custom/Program.cs
index 2a38f76d..a7862b8e 100644
--- a/examples/advanced/KedroSpaceflights.Custom/Program.cs
+++ b/examples/advanced/KedroSpaceflights.Custom/Program.cs
@@ -53,7 +53,7 @@ private static void ConfigureServices(IServiceCollection services, string basePa
       // Enable configuration loading from appsettings.json files
       // This loads: appsettings.json (base) -> appsettings.{Environment}.json -> appsettings.Local.json
       flowthru.UseConfiguration(opts => opts.ConfigurationPath = basePath);
-      flowthru.UseCatalog(_ => new Catalog(Path.Combine(basePath, "Data")));
+      flowthru.RegisterCatalog(_ => new Catalog(Path.Combine(basePath, "Data")));
       flowthru.ConfigureMetadata(meta =>
       {
         var metadataPath = Path.Combine(basePath, "Metadata");
@@ -66,33 +66,33 @@ private static void ConfigureServices(IServiceCollection services, string basePa
       });
 
       flowthru
-        .RegisterPipeline(label: "DataProcessing", pipeline: DataProcessingPipeline.Create)
+        .RegisterFlow(label: "DataProcessing", flow: DataProcessingPipeline.Create)
         .WithDescription("Preprocesses raw data and creates model input table");
 
       flowthru
-        .RegisterPipeline(
+        .RegisterFlow(
           label: "DataScience",
-          pipeline: DataSciencePipeline.Create,
+          flow: DataSciencePipeline.Create,
           configurationSection: "Flowthru:Pipelines:DataScience"
         )
         .WithDescription("Trains ML model");
 
       flowthru
-        .RegisterPipeline(label: "DataDiagnostics", pipeline: DataDiagnosticsPipeline.Create)
+        .RegisterFlow(label: "DataDiagnostics", flow: DataDiagnosticsPipeline.Create)
         .WithDescription(
           "Validates pipeline outputs against Kedro reference and exports diagnostic data"
         );
 
       flowthru
-        .RegisterPipeline(
+        .RegisterFlow(
           label: "DataEvaluation",
-          pipeline: DataEvaluationPipeline.Create,
+          flow: DataEvaluationPipeline.Create,
           configurationSection: "Flowthru:Pipelines:DataEvaluation"
         )
         .WithDescription("Evaluates ML model performance and cross-validation");
 
       flowthru
-        .RegisterPipeline(label: "Reporting", pipeline: ReportingPipeline.Create)
+        .RegisterFlow(label: "Reporting", flow: ReportingPipeline.Create)
         .WithDescription("Generates reports and visualizations");
     });
 
diff --git a/examples/advanced/RetailDataMultipipeline/Data/CoreCatalog.cs b/examples/advanced/RetailDataMultipipeline/Data/CoreCatalog.cs
index e3799ffc..65c70e9b 100644
--- a/examples/advanced/RetailDataMultipipeline/Data/CoreCatalog.cs
+++ b/examples/advanced/RetailDataMultipipeline/Data/CoreCatalog.cs
@@ -2,7 +2,7 @@
 
 namespace RetailDataMultipipeline.Data;
 
-public partial class CoreCatalog : DataCatalogBase
+public partial class CoreCatalog : CatalogAbstract
 {
   private readonly string _basePath;
 
diff --git a/examples/advanced/RetailDataMultipipeline/Data/_01_Raw/CoreCatalog.Raw.cs b/examples/advanced/RetailDataMultipipeline/Data/_01_Raw/CoreCatalog.Raw.cs
index 45db49e6..2a8078d6 100644
--- a/examples/advanced/RetailDataMultipipeline/Data/_01_Raw/CoreCatalog.Raw.cs
+++ b/examples/advanced/RetailDataMultipipeline/Data/_01_Raw/CoreCatalog.Raw.cs
@@ -9,10 +9,10 @@ public partial class CoreCatalog
   /// All daily retail transaction CSV files from the by-day directory, read as a
   /// single concatenated sequence. Read-only — immutable raw source data.
   /// </summary>
-  public ICatalogEntry<IEnumerable<RetailTransactionSchema>> RetailTransactionsRaw =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<RetailTransactionSchema>> RetailTransactionsRaw =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.CsvDirectory<RetailTransactionSchema>(
+        ItemFactory.Enumerable.CsvDirectory<RetailTransactionSchema>(
           label: "RetailTransactionsRaw",
           directoryPath: $"{_basePath}/_01_Raw/Datasets"
         )
@@ -21,10 +21,10 @@ public partial class CoreCatalog
   /// <summary>
   /// Country-to-currency mapping. Maintained independently of the OFX feed.
   /// </summary>
-  public ICatalogEntry<IEnumerable<CountryCurrencySchema>> CountryCurrencies =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<CountryCurrencySchema>> CountryCurrencies =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Json<CountryCurrencySchema>(
+        ItemFactory.Enumerable.Json<CountryCurrencySchema>(
           label: "CountryCurrencies",
           filePath: $"{_basePath}/_01_Raw/Datasets/country_currencies.json"
         )
@@ -33,10 +33,10 @@ public partial class CoreCatalog
   /// <summary>
   /// Stubbed OFX XXX/GBP/1000 responses — one per source currency.
   /// </summary>
-  public ICatalogEntry<IEnumerable<OfxRateResponseSchema>> OfxRates =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<OfxRateResponseSchema>> OfxRates =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Json<OfxRateResponseSchema>(
+        ItemFactory.Enumerable.Json<OfxRateResponseSchema>(
           label: "OfxRates",
           filePath: $"{_basePath}/_01_Raw/Datasets/ofx_rates.json"
         )
diff --git a/examples/advanced/RetailDataMultipipeline/Data/_02_Intermediate/CoreCatalog.Intermediate.cs b/examples/advanced/RetailDataMultipipeline/Data/_02_Intermediate/CoreCatalog.Intermediate.cs
index 73c98b85..ddae918b 100644
--- a/examples/advanced/RetailDataMultipipeline/Data/_02_Intermediate/CoreCatalog.Intermediate.cs
+++ b/examples/advanced/RetailDataMultipipeline/Data/_02_Intermediate/CoreCatalog.Intermediate.cs
@@ -9,10 +9,10 @@ public partial class CoreCatalog
   /// All retail transactions consolidated from the daily CSV files into a single
   /// Parquet dataset with fully-typed columns. This is the canonical "full history" view.
   /// </summary>
-  public ICatalogEntry<IEnumerable<RetailTransactionIntermediateSchema>> AllRetailTransactions =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<RetailTransactionIntermediateSchema>> AllRetailTransactions =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<RetailTransactionIntermediateSchema>(
+        ItemFactory.Enumerable.Parquet<RetailTransactionIntermediateSchema>(
           label: "AllRetailTransactions",
           filePath: $"{_basePath}/_02_Intermediate/Datasets/all_retail_transactions.parquet"
         )
diff --git a/examples/advanced/RetailDataMultipipeline/Data/_03_Primary/CoreCatalog.Primary.cs b/examples/advanced/RetailDataMultipipeline/Data/_03_Primary/CoreCatalog.Primary.cs
index a05a95b8..d3f23ca3 100644
--- a/examples/advanced/RetailDataMultipipeline/Data/_03_Primary/CoreCatalog.Primary.cs
+++ b/examples/advanced/RetailDataMultipipeline/Data/_03_Primary/CoreCatalog.Primary.cs
@@ -12,10 +12,10 @@ public partial class CoreCatalog
   /// All per-country weekly DTU shards concatenated into a single Parquet dataset.
   /// Produced by the Consolidation pipeline as the fan-in of all shard outputs.
   /// </summary>
-  public ICatalogEntry<IEnumerable<WeeklyDtuSchema>> AllCountriesWeeklyDtu =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<WeeklyDtuSchema>> AllCountriesWeeklyDtu =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<WeeklyDtuSchema>(
+        ItemFactory.Enumerable.Parquet<WeeklyDtuSchema>(
           label: "AllCountriesWeeklyDtu",
           filePath: $"{_basePath}/_03_Primary/Datasets/all_countries_weekly_dtu.parquet"
         )
diff --git a/examples/advanced/RetailDataMultipipeline/Data/_03_Primary/CountryShardCatalog.cs b/examples/advanced/RetailDataMultipipeline/Data/_03_Primary/CountryShardCatalog.cs
index 79bc2658..2d6199b0 100644
--- a/examples/advanced/RetailDataMultipipeline/Data/_03_Primary/CountryShardCatalog.cs
+++ b/examples/advanced/RetailDataMultipipeline/Data/_03_Primary/CountryShardCatalog.cs
@@ -11,7 +11,7 @@ namespace RetailDataMultipipeline.Data;
 /// receive distinct qualified identifiers in the DAG metadata:
 /// e.g., <c>UnitedKingdomShardCatalog.WeeklyDtu</c>.
 /// </remarks>
-public class CountryShardCatalog : DataCatalogBase
+public class CountryShardCatalog : CatalogAbstract
 {
   private readonly string _basePath;
 
@@ -28,10 +28,10 @@ public CountryShardCatalog(string country, string basePath)
   /// <summary>
   /// Per-country weekly DTU Parquet shard, currency-converted to GBP.
   /// </summary>
-  public ICatalogEntry<IEnumerable<WeeklyDtuSchema>> WeeklyDtu =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<WeeklyDtuSchema>> WeeklyDtu =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<WeeklyDtuSchema>(
+        ItemFactory.Enumerable.Parquet<WeeklyDtuSchema>(
           label: $"WeeklyDtu_{Slugify(Country)}",
           filePath: $"{_basePath}/_03_Primary/Datasets/weekly_dtu_{Slugify(Country)}.parquet"
         )
diff --git a/examples/advanced/RetailDataMultipipeline/Data/_08_Reporting/CoreCatalog.Reporting.cs b/examples/advanced/RetailDataMultipipeline/Data/_08_Reporting/CoreCatalog.Reporting.cs
index 98a2b063..c41459b5 100644
--- a/examples/advanced/RetailDataMultipipeline/Data/_08_Reporting/CoreCatalog.Reporting.cs
+++ b/examples/advanced/RetailDataMultipipeline/Data/_08_Reporting/CoreCatalog.Reporting.cs
@@ -5,40 +5,40 @@ namespace RetailDataMultipipeline.Data;
 
 public partial class CoreCatalog
 {
-  public ICatalogEntry<IEnumerable<CountryTransactionSummarySchema>> CountryTransactionSummary =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<CountryTransactionSummarySchema>> CountryTransactionSummary =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<CountryTransactionSummarySchema>(
+        ItemFactory.Enumerable.Csv<CountryTransactionSummarySchema>(
           label: "CountryTransactionSummary",
           filePath: $"{_basePath}/_08_Reporting/Datasets/country_transaction_summary.csv"
         )
     );
 
   /// <summary>Daily GBP revenue per country — line chart (PNG).</summary>
-  public ICatalogEntry<byte[]> DollarsChart =>
-    GetOrCreateEntry(
+  public IItem<byte[]> DollarsChart =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "DollarsChart",
           filePath: $"{_basePath}/_08_Reporting/Charts/dollars_chart.png"
         )
     );
 
   /// <summary>Daily transaction count per country — line chart (PNG).</summary>
-  public ICatalogEntry<byte[]> TransactionsChart =>
-    GetOrCreateEntry(
+  public IItem<byte[]> TransactionsChart =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "TransactionsChart",
           filePath: $"{_basePath}/_08_Reporting/Charts/transactions_chart.png"
         )
     );
 
   /// <summary>Daily unique customers per country — line chart (PNG).</summary>
-  public ICatalogEntry<byte[]> UsersChart =>
-    GetOrCreateEntry(
+  public IItem<byte[]> UsersChart =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "UsersChart",
           filePath: $"{_basePath}/_08_Reporting/Charts/users_chart.png"
         )
diff --git a/examples/advanced/RetailDataMultipipeline/Pipelines/Analysis/AnalysisPipeline.cs b/examples/advanced/RetailDataMultipipeline/Pipelines/Analysis/AnalysisPipeline.cs
index 3bd912b1..0c45e7a4 100644
--- a/examples/advanced/RetailDataMultipipeline/Pipelines/Analysis/AnalysisPipeline.cs
+++ b/examples/advanced/RetailDataMultipipeline/Pipelines/Analysis/AnalysisPipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using RetailDataMultipipeline.Data;
 using RetailDataMultipipeline.Pipelines.Analysis.Nodes;
 
@@ -6,15 +6,15 @@ namespace RetailDataMultipipeline.Pipelines.Analysis;
 
 /// <summary>
 /// Computes weekly DTU metrics for a single country shard.
-/// Instantiated once per <see cref="CountryShardCatalog"/> via <c>UsePipelines</c> in Program.cs.
+/// Instantiated once per <see cref="CountryShardCatalog"/> via <c>RegisterPipelines</c> in Program.cs.
 /// </summary>
 public static class AnalysisPipeline
 {
-  public static Pipeline Create(CoreCatalog core, CountryShardCatalog shard)
+  public static Flow Create(CoreCatalog core, CountryShardCatalog shard)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ComputeWeeklyDtu",
         description: $"Converts currency and aggregates weekly DTU metrics for {shard.Country}.",
         transform: ComputeWeeklyDtuNode.Create(shard.Country),
diff --git a/examples/advanced/RetailDataMultipipeline/Pipelines/Consolidation/ConsolidationPipeline.cs b/examples/advanced/RetailDataMultipipeline/Pipelines/Consolidation/ConsolidationPipeline.cs
index 1d8ea983..c69e6a06 100644
--- a/examples/advanced/RetailDataMultipipeline/Pipelines/Consolidation/ConsolidationPipeline.cs
+++ b/examples/advanced/RetailDataMultipipeline/Pipelines/Consolidation/ConsolidationPipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using RetailDataMultipipeline.Data;
 
 namespace RetailDataMultipipeline.Pipelines.Consolidation;
@@ -14,16 +14,16 @@ namespace RetailDataMultipipeline.Pipelines.Consolidation;
 /// </remarks>
 public static class ConsolidationPipeline
 {
-  public static Pipeline Create(CoreCatalog core, List<CountryShardCatalog> shards)
+  public static Flow Create(CoreCatalog core, List<CountryShardCatalog> shards)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ConsolidateShards",
         description: "Concatenates all per-country weekly DTU shards into a single Parquet dataset.",
         inputs: shards.Select(s => s.WeeklyDtu).ToList(),
         output: core.AllCountriesWeeklyDtu,
-        node: batches => batches.SelectMany(b => b)
+        step: batches => batches.SelectMany(b => b)
       );
     });
   }
diff --git a/examples/advanced/RetailDataMultipipeline/Pipelines/DataIngestion/DataIngestionPipeline.cs b/examples/advanced/RetailDataMultipipeline/Pipelines/DataIngestion/DataIngestionPipeline.cs
index 883c036f..9d1ac78a 100644
--- a/examples/advanced/RetailDataMultipipeline/Pipelines/DataIngestion/DataIngestionPipeline.cs
+++ b/examples/advanced/RetailDataMultipipeline/Pipelines/DataIngestion/DataIngestionPipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using RetailDataMultipipeline.Data;
 using RetailDataMultipipeline.Pipelines.DataIngestion.Nodes;
 
@@ -10,11 +10,11 @@ namespace RetailDataMultipipeline.Pipelines.DataIngestion;
 /// </summary>
 public static class DataIngestionPipeline
 {
-  public static Pipeline Create(CoreCatalog catalog)
+  public static Flow Create(CoreCatalog catalog)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ConsolidateDailyFiles",
         description: "Reads all daily CSV files from the raw directory and writes a unified Parquet dataset.",
         transform: ConsolidateDailyFilesNode.Create(),
diff --git a/examples/advanced/RetailDataMultipipeline/Pipelines/Graphing/GraphingPipeline.cs b/examples/advanced/RetailDataMultipipeline/Pipelines/Graphing/GraphingPipeline.cs
index d9151a73..1f61ba76 100644
--- a/examples/advanced/RetailDataMultipipeline/Pipelines/Graphing/GraphingPipeline.cs
+++ b/examples/advanced/RetailDataMultipipeline/Pipelines/Graphing/GraphingPipeline.cs
@@ -1,6 +1,6 @@
 using Flowthru.Extensions.Python.Execution;
-using Flowthru.Extensions.Python.Nodes;
-using Flowthru.Pipelines;
+using Flowthru.Extensions.Python.Steps;
+using Flowthru.Flows;
 using RetailDataMultipipeline.Data;
 
 namespace RetailDataMultipipeline.Pipelines.Graphing;
@@ -12,11 +12,11 @@ namespace RetailDataMultipipeline.Pipelines.Graphing;
 /// </summary>
 public static class GraphingPipeline
 {
-  public static Pipeline Create(CoreCatalog catalog, IPythonExecutor executor)
+  public static Flow Create(CoreCatalog catalog, IPythonExecutor executor)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddPythonNode(
+      pipeline.AddPythonStep(
         label: "PlotDollarsChart",
         description: "Line chart of weekly GBP revenue per country (Plotly PNG).",
         module: "Pipelines.Graphing.Nodes.plot_dtu_charts",
@@ -26,7 +26,7 @@ public static Pipeline Create(CoreCatalog catalog, IPythonExecutor executor)
         executor: executor
       );
 
-      pipeline.AddPythonNode(
+      pipeline.AddPythonStep(
         label: "PlotTransactionsChart",
         description: "Line chart of weekly transaction count per country (Plotly PNG).",
         module: "Pipelines.Graphing.Nodes.plot_dtu_charts",
@@ -36,7 +36,7 @@ public static Pipeline Create(CoreCatalog catalog, IPythonExecutor executor)
         executor: executor
       );
 
-      pipeline.AddPythonNode(
+      pipeline.AddPythonStep(
         label: "PlotUsersChart",
         description: "Line chart of weekly unique customers per country (Plotly PNG).",
         module: "Pipelines.Graphing.Nodes.plot_dtu_charts",
diff --git a/examples/advanced/RetailDataMultipipeline/Pipelines/Graphing/Nodes/__init__.py b/examples/advanced/RetailDataMultipipeline/Pipelines/Graphing/Nodes/__init__.py
index cbc9bd1c..8339fb8e 100644
--- a/examples/advanced/RetailDataMultipipeline/Pipelines/Graphing/Nodes/__init__.py
+++ b/examples/advanced/RetailDataMultipipeline/Pipelines/Graphing/Nodes/__init__.py
@@ -1 +1 @@
-"""Graphing pipeline nodes."""
+"""Graphing pipeline steps."""
diff --git a/examples/advanced/RetailDataMultipipeline/Pipelines/Graphing/Nodes/plot_dtu_charts.py b/examples/advanced/RetailDataMultipipeline/Pipelines/Graphing/Nodes/plot_dtu_charts.py
index 306fb497..a024c45e 100644
--- a/examples/advanced/RetailDataMultipipeline/Pipelines/Graphing/Nodes/plot_dtu_charts.py
+++ b/examples/advanced/RetailDataMultipipeline/Pipelines/Graphing/Nodes/plot_dtu_charts.py
@@ -1,6 +1,6 @@
-"""Daily DTU chart generation nodes.
+"""Daily DTU chart generation steps.
 
-Each node reads the consolidated all-countries daily DTU dataset and produces a
+Each step reads the consolidated all-countries daily DTU dataset and produces a
 PNG line chart (one trace per country) for a single metric.
 """
 
@@ -10,12 +10,12 @@
 import pandas as pd
 import plotly.express as px
 import plotly.io as pio
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
 
-@node(inputs=["WeeklyDtuSchema"], outputs="DollarsChart")
+@step(inputs=["WeeklyDtuSchema"], outputs="DollarsChart")
 def plot_dollars_chart(daily_dtu: pd.DataFrame) -> bytes:
     """Line chart of weekly GBP revenue per country.
 
@@ -45,7 +45,7 @@ def plot_dollars_chart(daily_dtu: pd.DataFrame) -> bytes:
     return pio.to_image(fig, format="png")
 
 
-@node(inputs=["WeeklyDtuSchema"], outputs="TransactionsChart")
+@step(inputs=["WeeklyDtuSchema"], outputs="TransactionsChart")
 def plot_transactions_chart(daily_dtu: pd.DataFrame) -> bytes:
     """Line chart of weekly transaction count per country.
 
@@ -74,7 +74,7 @@ def plot_transactions_chart(daily_dtu: pd.DataFrame) -> bytes:
     return pio.to_image(fig, format="png")
 
 
-@node(inputs=["WeeklyDtuSchema"], outputs="UsersChart")
+@step(inputs=["WeeklyDtuSchema"], outputs="UsersChart")
 def plot_users_chart(daily_dtu: pd.DataFrame) -> bytes:
     """Line chart of weekly unique customer count per country.
 
diff --git a/examples/advanced/RetailDataMultipipeline/Pipelines/Reporting/ReportingPipeline.cs b/examples/advanced/RetailDataMultipipeline/Pipelines/Reporting/ReportingPipeline.cs
index bcce5b48..20b83e4c 100644
--- a/examples/advanced/RetailDataMultipipeline/Pipelines/Reporting/ReportingPipeline.cs
+++ b/examples/advanced/RetailDataMultipipeline/Pipelines/Reporting/ReportingPipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using RetailDataMultipipeline.Data;
 using RetailDataMultipipeline.Pipelines.Reporting.Nodes;
 
@@ -9,11 +9,11 @@ namespace RetailDataMultipipeline.Pipelines.Reporting;
 /// </summary>
 public static class ReportingPipeline
 {
-  public static Pipeline Create(CoreCatalog catalog)
+  public static Flow Create(CoreCatalog catalog)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "SummarizeByCountry",
         description: "Counts debit and credit line items per country across the full transaction history.",
         transform: SummarizeByCountryNode.Create(),
diff --git a/examples/advanced/RetailDataMultipipeline/Program.cs b/examples/advanced/RetailDataMultipipeline/Program.cs
index 4e873228..f58c2f1a 100644
--- a/examples/advanced/RetailDataMultipipeline/Program.cs
+++ b/examples/advanced/RetailDataMultipipeline/Program.cs
@@ -21,27 +21,44 @@ public class Program
   public static Task<int> Main(string[] args) =>
     FlowthruCli.RunStandaloneAsync(
       args,
-      services => ConfigureServices(services, Directory.GetCurrentDirectory())
+      services =>
+        ConfigureServices(
+          services,
+          Directory.GetCurrentDirectory(),
+          AppDomain.CurrentDomain.BaseDirectory
+        )
     );
 
-  public static IServiceProvider ConfigureServices(string? basePath = null)
+  public static IServiceProvider ConfigureServices(
+    string? basePath = null,
+    string? outputPath = null
+  )
   {
     var services = new ServiceCollection();
-    ConfigureServices(services, basePath ?? Directory.GetCurrentDirectory());
+    ConfigureServices(
+      services,
+      basePath ?? Directory.GetCurrentDirectory(),
+      outputPath ?? AppDomain.CurrentDomain.BaseDirectory
+    );
     return services.BuildServiceProvider();
   }
 
-  private static void ConfigureServices(IServiceCollection services, string basePath)
+  private static void ConfigureServices(
+    IServiceCollection services,
+    string basePath,
+    string outputPath
+  )
   {
     services.AddFlowthru(flowthru =>
     {
       flowthru.UseConfiguration(opts => opts.ConfigurationPath = basePath);
 
-      // Configure Python runtime — makes Pipelines/ importable and exposes the @node decorator
+      // Configure Python runtime — makes Pipelines/ importable and exposes the @step decorator
       flowthru.UsePython(python =>
       {
         python.ModuleSearchPaths.Add(basePath);
-        python.ModuleSearchPaths.Add(AppDomain.CurrentDomain.BaseDirectory);
+        python.ModuleSearchPaths.Add(outputPath);
+        python.VenvPath = outputPath;
       });
 
       var dataPath = Path.Combine(basePath, "Data");
@@ -57,24 +74,24 @@ private static void ConfigureServices(IServiceCollection services, string basePa
 
       // Core catalog: raw inputs → intermediate → reporting
       var coreCatalog = new CoreCatalog(dataPath);
-      flowthru.UseCatalog(coreCatalog);
+      flowthru.RegisterCatalog(coreCatalog);
 
       // Shard catalogs: one per country, labelled {Country}ShardCatalog
       var shardCatalogs = countries.Select(c => new CountryShardCatalog(c, dataPath)).ToList();
-      flowthru.UseCatalogs(shardCatalogs);
+      flowthru.RegisterCatalogs(shardCatalogs);
 
       // Static pipelines resolved via DI
-      flowthru.RegisterPipeline(
+      flowthru.RegisterFlow(
         "DataIngestion",
         (CoreCatalog cat) => DataIngestionPipeline.Create(cat)
       );
-      flowthru.RegisterPipeline("Reporting", (CoreCatalog cat) => ReportingPipeline.Create(cat));
-      flowthru.RegisterPipeline("Graphing", GraphingPipeline.Create);
+      flowthru.RegisterFlow("Reporting", (CoreCatalog cat) => ReportingPipeline.Create(cat));
+      flowthru.RegisterFlow("Graphing", GraphingPipeline.Create);
 
       // Dynamic per-country analysis pipelines + fan-in consolidation
-      flowthru.UsePipelines(_ =>
+      flowthru.RegisterFlows(_ =>
       {
-        var pipelines = new Dictionary<string, Flowthru.Pipelines.Pipeline>();
+        var pipelines = new Dictionary<string, Flowthru.Flows.Flow>();
         foreach (var shard in shardCatalogs)
         {
           pipelines[$"Analysis_{shard.Country.Replace(' ', '_')}"] = AnalysisPipeline.Create(
diff --git a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/DataProcessingCatalog.cs b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/DataProcessingCatalog.cs
index bf65151c..323b260c 100644
--- a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/DataProcessingCatalog.cs
+++ b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/DataProcessingCatalog.cs
@@ -6,7 +6,7 @@ namespace SpaceflightsDistributed.DataProcessing.Data;
 /// Data catalog for the DataProcessing pipeline library.
 /// Owns all raw, intermediate, and primary data layers for the Spaceflights domain.
 /// </summary>
-public partial class DataProcessingCatalog : DataCatalogBase
+public partial class DataProcessingCatalog : CatalogAbstract
 {
   private readonly string _basePath;
 
diff --git a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/_01_Raw/Catalog.Raw.cs b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/_01_Raw/Catalog.Raw.cs
index 141932b6..9defbde2 100644
--- a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/_01_Raw/Catalog.Raw.cs
+++ b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/_01_Raw/Catalog.Raw.cs
@@ -5,28 +5,28 @@ namespace SpaceflightsDistributed.DataProcessing.Data;
 
 public partial class DataProcessingCatalog
 {
-  public ICatalogEntry<IEnumerable<CompanySchema>> Companies =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<CompanySchema>> Companies =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<CompanySchema>(
+        ItemFactory.Enumerable.Csv<CompanySchema>(
           label: "Companies",
           filePath: $"{_basePath}/_01_Raw/Datasets/companies.csv"
         )
     );
 
-  public ICatalogEntry<IEnumerable<ReviewSchema>> Reviews =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ReviewSchema>> Reviews =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<ReviewSchema>(
+        ItemFactory.Enumerable.Csv<ReviewSchema>(
           label: "Reviews",
           filePath: $"{_basePath}/_01_Raw/Datasets/reviews.csv"
         )
     );
 
-  public ICatalogEntry<IEnumerable<ShuttleSchema>> Shuttles =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ShuttleSchema>> Shuttles =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Excel<ShuttleSchema>(
+        ItemFactory.Enumerable.Excel<ShuttleSchema>(
           label: "Shuttles",
           filePath: $"{_basePath}/_01_Raw/Datasets/shuttles.xlsx",
           sheetName: "Sheet1"
diff --git a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/_02_Intermediate/Catalog.Intermediate.cs b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/_02_Intermediate/Catalog.Intermediate.cs
index a12407d8..8c71198e 100644
--- a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/_02_Intermediate/Catalog.Intermediate.cs
+++ b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/_02_Intermediate/Catalog.Intermediate.cs
@@ -5,19 +5,19 @@ namespace SpaceflightsDistributed.DataProcessing.Data;
 
 public partial class DataProcessingCatalog
 {
-  public ICatalogEntry<IEnumerable<PreprocessedCompanySchema>> PreprocessedCompanies =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<PreprocessedCompanySchema>> PreprocessedCompanies =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<PreprocessedCompanySchema>(
+        ItemFactory.Enumerable.Parquet<PreprocessedCompanySchema>(
           label: "PreprocessedCompanies",
           filePath: $"{_basePath}/_02_Intermediate/Datasets/preprocessed_companies.parquet"
         )
     );
 
-  public ICatalogEntry<IEnumerable<PreprocessedShuttleSchema>> PreprocessedShuttles =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<PreprocessedShuttleSchema>> PreprocessedShuttles =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<PreprocessedShuttleSchema>(
+        ItemFactory.Enumerable.Parquet<PreprocessedShuttleSchema>(
           label: "PreprocessedShuttles",
           filePath: $"{_basePath}/_02_Intermediate/Datasets/preprocessed_shuttles.parquet"
         )
diff --git a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/_03_Primary/Catalog.Primary.cs b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/_03_Primary/Catalog.Primary.cs
index f453f4d2..d50fb9a0 100644
--- a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/_03_Primary/Catalog.Primary.cs
+++ b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Data/_03_Primary/Catalog.Primary.cs
@@ -5,10 +5,10 @@ namespace SpaceflightsDistributed.DataProcessing.Data;
 
 public partial class DataProcessingCatalog
 {
-  public ICatalogEntry<IEnumerable<ModelInputTableSchema>> ModelInputTable =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ModelInputTableSchema>> ModelInputTable =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<ModelInputTableSchema>(
+        ItemFactory.Enumerable.Parquet<ModelInputTableSchema>(
           label: "ModelInputTable",
           filePath: $"{_basePath}/_03_Primary/Datasets/model_input_table.parquet"
         )
diff --git a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Pipelines/DataProcessing/DataProcessingPipeline.cs b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Pipelines/DataProcessing/DataProcessingPipeline.cs
index 7b0a9635..4e62df27 100644
--- a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Pipelines/DataProcessing/DataProcessingPipeline.cs
+++ b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataProcessing/Pipelines/DataProcessing/DataProcessingPipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using SpaceflightsDistributed.DataProcessing.Data;
 using SpaceflightsDistributed.DataProcessing.Pipelines.DataProcessing.Nodes;
 
@@ -10,11 +10,11 @@ namespace SpaceflightsDistributed.DataProcessing.Pipelines.DataProcessing;
 /// </summary>
 public static class DataProcessingPipeline
 {
-  public static Pipeline Create(DataProcessingCatalog catalog)
+  public static Flow Create(DataProcessingCatalog catalog)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "PreprocessCompanies",
         description: "Cleans and preprocesses raw company data.",
         transform: PreprocessCompaniesNode.Create(),
@@ -22,7 +22,7 @@ public static Pipeline Create(DataProcessingCatalog catalog)
         output: catalog.PreprocessedCompanies
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "PreprocessShuttles",
         description: "Cleans and preprocesses raw shuttle data.",
         transform: PreprocessShuttlesNode.Create(),
@@ -30,7 +30,7 @@ public static Pipeline Create(DataProcessingCatalog catalog)
         output: catalog.PreprocessedShuttles
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "CreateModelInputTable",
         description: "Joins preprocessed shuttle and company data with review scores.",
         transform: CreateModelInputTableNode.Create(),
diff --git a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/DataScienceCatalog.cs b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/DataScienceCatalog.cs
index 39fdc11a..6c9f2c9e 100644
--- a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/DataScienceCatalog.cs
+++ b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/DataScienceCatalog.cs
@@ -6,7 +6,7 @@ namespace SpaceflightsDistributed.DataScience.Data;
 /// Data catalog for the DataScience pipeline library.
 /// Owns the model input splits, trained model, and model output layers.
 /// </summary>
-public partial class DataScienceCatalog : DataCatalogBase
+public partial class DataScienceCatalog : CatalogAbstract
 {
   private readonly string _basePath;
 
diff --git a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/_05_ModelInput/Catalog.ModelInput.cs b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/_05_ModelInput/Catalog.ModelInput.cs
index b6db90f2..853eb78a 100644
--- a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/_05_ModelInput/Catalog.ModelInput.cs
+++ b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/_05_ModelInput/Catalog.ModelInput.cs
@@ -6,10 +6,10 @@ namespace SpaceflightsDistributed.DataScience.Data;
 public partial class DataScienceCatalog
 {
   /// <summary>Training split stored in memory — transient between pipeline runs.</summary>
-  public ICatalogEntry<IEnumerable<TrainingData>> TrainSplit =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TrainingData>(label: "XTrain"));
+  public IItem<IEnumerable<TrainingData>> TrainSplit =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TrainingData>(label: "XTrain"));
 
   /// <summary>Test split stored in memory — transient between pipeline runs.</summary>
-  public ICatalogEntry<IEnumerable<TestData>> TestSplit =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "XTest"));
+  public IItem<IEnumerable<TestData>> TestSplit =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "XTest"));
 }
diff --git a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/_06_Models/Catalog.Models.cs b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/_06_Models/Catalog.Models.cs
index 15115df9..e7d9f85e 100644
--- a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/_06_Models/Catalog.Models.cs
+++ b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/_06_Models/Catalog.Models.cs
@@ -5,10 +5,10 @@ namespace SpaceflightsDistributed.DataScience.Data;
 
 public partial class DataScienceCatalog
 {
-  public ICatalogEntry<LinearRegressionModel> Regressor =>
-    GetOrCreateEntry(
+  public IItem<LinearRegressionModel> Regressor =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<LinearRegressionModel>(
+        ItemFactory.Single.Json<LinearRegressionModel>(
           label: "Regressor",
           filePath: $"{_basePath}/_06_Models/Datasets/regressor.json"
         )
diff --git a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/_07_ModelOutput/Catalog.ModelOutput.cs b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/_07_ModelOutput/Catalog.ModelOutput.cs
index d0bc39b7..67d9b01e 100644
--- a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/_07_ModelOutput/Catalog.ModelOutput.cs
+++ b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Data/_07_ModelOutput/Catalog.ModelOutput.cs
@@ -5,19 +5,19 @@ namespace SpaceflightsDistributed.DataScience.Data;
 
 public partial class DataScienceCatalog
 {
-  public ICatalogEntry<ModelMetrics> ModelMetrics =>
-    GetOrCreateEntry(
+  public IItem<ModelMetrics> ModelMetrics =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<ModelMetrics>(
+        ItemFactory.Single.Json<ModelMetrics>(
           label: "ModelMetrics",
           filePath: $"{_basePath}/_07_ModelOutput/Datasets/model_metrics.json"
         )
     );
 
-  public ICatalogEntry<IEnumerable<ModelPredictions>> ModelPredictions =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ModelPredictions>> ModelPredictions =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Json<ModelPredictions>(
+        ItemFactory.Enumerable.Json<ModelPredictions>(
           label: "ModelPredictions",
           filePath: $"{_basePath}/_07_ModelOutput/Datasets/model_predictions.json"
         )
diff --git a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Pipelines/DataScience/DataSciencePipeline.cs b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Pipelines/DataScience/DataSciencePipeline.cs
index 91362453..ef49a521 100644
--- a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Pipelines/DataScience/DataSciencePipeline.cs
+++ b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.DataScience/Pipelines/DataScience/DataSciencePipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using SpaceflightsDistributed.DataProcessing.Data;
 using SpaceflightsDistributed.DataScience.Data;
 using SpaceflightsDistributed.DataScience.Pipelines.DataScience.Nodes;
@@ -29,11 +29,11 @@ public record Params
   /// <param name="dp">The data processing catalog supplying the model input table.</param>
   /// <param name="ds">The data science catalog receiving splits, model, and metrics.</param>
   /// <param name="parameters">Configuration parameters for the pipeline.</param>
-  public static Pipeline Create(DataProcessingCatalog dp, DataScienceCatalog ds, Params parameters)
+  public static Flow Create(DataProcessingCatalog dp, DataScienceCatalog ds, Params parameters)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "SplitData",
         description: "Splits the model input table into training and test sets.",
         transform: SplitDataNode.Create(parameters.ModelOptions),
@@ -41,7 +41,7 @@ public static Pipeline Create(DataProcessingCatalog dp, DataScienceCatalog ds, P
         output: (ds.TrainSplit, ds.TestSplit)
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "TrainModel",
         description: "Trains a regression model to predict shuttle prices.",
         transform: TrainModelNode.Create(),
@@ -49,7 +49,7 @@ public static Pipeline Create(DataProcessingCatalog dp, DataScienceCatalog ds, P
         output: ds.Regressor
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "EvaluateModel",
         description: "Evaluates the trained model on the test set and computes metrics.",
         transform: EvaluateModelNode.Create(),
diff --git a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.Reporting/Data/ReportingCatalog.cs b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.Reporting/Data/ReportingCatalog.cs
index d743a0bb..20a652c2 100644
--- a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.Reporting/Data/ReportingCatalog.cs
+++ b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.Reporting/Data/ReportingCatalog.cs
@@ -6,7 +6,7 @@ namespace SpaceflightsDistributed.Reporting.Data;
 /// Data catalog for the Reporting pipeline library.
 /// Owns reporting outputs — capacity reports and visualization charts.
 /// </summary>
-public partial class ReportingCatalog : DataCatalogBase
+public partial class ReportingCatalog : CatalogAbstract
 {
   private readonly string _basePath;
 
diff --git a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.Reporting/Data/_08_Reporting/Catalog.Reporting.cs b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.Reporting/Data/_08_Reporting/Catalog.Reporting.cs
index 75097d88..6eba1724 100644
--- a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.Reporting/Data/_08_Reporting/Catalog.Reporting.cs
+++ b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.Reporting/Data/_08_Reporting/Catalog.Reporting.cs
@@ -9,22 +9,20 @@ namespace SpaceflightsDistributed.Reporting.Data;
 /// </summary>
 public partial class ReportingCatalog
 {
-  public ICatalogEntry<IEnumerable<ShuttleCapacityReport>> ShuttleCapacityReport =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ShuttleCapacityReport>> ShuttleCapacityReport =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Json<ShuttleCapacityReport>(
+        ItemFactory.Enumerable.Json<ShuttleCapacityReport>(
           label: "ShuttleCapacityReport",
           filePath: $"{_basePath}/_08_Reporting/Datasets/shuttle_capacity_report.json"
         )
     );
 
-  public ICatalogEntry<GenericChart> ShuttlePassengerCapacityChart =>
-    GetOrCreateEntry(
-      () => CatalogEntries.Single.Memory<GenericChart>(label: "ShuttlePassengerCapacityChart")
+  public IItem<GenericChart> ShuttlePassengerCapacityChart =>
+    CreateItem(
+      () => ItemFactory.Single.Memory<GenericChart>(label: "ShuttlePassengerCapacityChart")
     );
 
-  public ICatalogEntry<GenericChart> ConfusionMatrixChart =>
-    GetOrCreateEntry(
-      () => CatalogEntries.Single.Memory<GenericChart>(label: "ConfusionMatrixChart")
-    );
+  public IItem<GenericChart> ConfusionMatrixChart =>
+    CreateItem(() => ItemFactory.Single.Memory<GenericChart>(label: "ConfusionMatrixChart"));
 }
diff --git a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.Reporting/Pipelines/Reporting/ReportingPipeline.cs b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.Reporting/Pipelines/Reporting/ReportingPipeline.cs
index 62362757..a4691246 100644
--- a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.Reporting/Pipelines/Reporting/ReportingPipeline.cs
+++ b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed.Reporting/Pipelines/Reporting/ReportingPipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using SpaceflightsDistributed.DataProcessing.Data;
 using SpaceflightsDistributed.DataScience.Data;
 using SpaceflightsDistributed.Reporting.Data;
@@ -26,16 +26,16 @@ public record Params
   /// <param name="ds">The data science catalog supplying model predictions.</param>
   /// <param name="r">The reporting catalog receiving all report and chart outputs.</param>
   /// <param name="parameters">Configuration for the pipeline.</param>
-  public static Pipeline Create(
+  public static Flow Create(
     DataProcessingCatalog dp,
     DataScienceCatalog ds,
     ReportingCatalog r,
     Params parameters
   )
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ComparePassengerCapacity",
         description: "Aggregates average shuttle passenger capacity grouped by shuttle type.",
         transform: ComparePassengerCapacityNode.Create(),
@@ -43,7 +43,7 @@ Params parameters
         output: r.ShuttleCapacityReport
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "GeneratePassengerCapacityChart",
         description: "Generates a bar chart of passenger capacity rankings by shuttle type.",
         transform: GeneratePassengerCapacityChartNode.Create(),
@@ -51,7 +51,7 @@ Params parameters
         output: r.ShuttlePassengerCapacityChart
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "GenerateConfusionMatrixChart",
         description: "Generates a confusion matrix heatmap from model price predictions.",
         transform: CreateConfusionMatrixNode.Create(parameters.ConfusionMatrixOptions),
diff --git a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed/Program.cs b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed/Program.cs
index 792fcced..f732461d 100644
--- a/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed/Program.cs
+++ b/examples/advanced/SpaceflightsDistributed/SpaceflightsDistributed/Program.cs
@@ -55,28 +55,28 @@ private static void ConfigureServices(IServiceCollection services, string basePa
       // ─── Catalog Registration ──────────────────────────────────────────────
       // Each library owns its own catalog.
 
-      flowthru.UseCatalog(_ => new DataProcessingCatalog(dataPath));
-      flowthru.UseCatalog(_ => new DataScienceCatalog(dataPath));
-      flowthru.UseCatalog(_ => new ReportingCatalog(dataPath));
+      flowthru.RegisterCatalog(_ => new DataProcessingCatalog(dataPath));
+      flowthru.RegisterCatalog(_ => new DataScienceCatalog(dataPath));
+      flowthru.RegisterCatalog(_ => new ReportingCatalog(dataPath));
 
       // ─── Pipeline Registration ─────────────────────────────────────────────
 
       flowthru
-        .RegisterPipeline(label: "DataProcessing", pipeline: DataProcessingPipeline.Create)
+        .RegisterFlow(label: "DataProcessing", flow: DataProcessingPipeline.Create)
         .WithDescription("Preprocesses companies and shuttles data into a model input table");
 
       flowthru
-        .RegisterPipeline(
+        .RegisterFlow(
           label: "DataScience",
-          pipeline: DataSciencePipeline.Create,
+          flow: DataSciencePipeline.Create,
           configurationSection: "Flowthru:Pipelines:DataScience"
         )
         .WithDescription("Trains linear regression model for shuttle price prediction");
 
       flowthru
-        .RegisterPipeline(
+        .RegisterFlow(
           label: "Reporting",
-          pipeline: ReportingPipeline.Create,
+          flow: ReportingPipeline.Create,
           configurationSection: "Flowthru:Pipelines:Reporting"
         )
         .WithDescription(
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Data/Catalog.cs b/examples/advanced/SpaceflightsPythonEFCore/Data/Catalog.cs
index ddeac484..d4975176 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Data/Catalog.cs
+++ b/examples/advanced/SpaceflightsPythonEFCore/Data/Catalog.cs
@@ -7,7 +7,7 @@ namespace SpaceflightsPythonEFCore.Data;
 /// Data catalog for the SpaceflightsPythonEFCore pipeline.
 /// Combines EFCore storage (DataProcessing and ModelPredictions) with Python-consumed file and memory entries.
 /// </summary>
-public partial class Catalog : DataCatalogBase
+public partial class Catalog : CatalogAbstract
 {
   private readonly string _basePath;
   private readonly IDbContextFactory<SpaceflightsDbContext> _contextFactory;
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Data/_01_Raw/Catalog.Raw.cs b/examples/advanced/SpaceflightsPythonEFCore/Data/_01_Raw/Catalog.Raw.cs
index 98882977..a9c0533c 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Data/_01_Raw/Catalog.Raw.cs
+++ b/examples/advanced/SpaceflightsPythonEFCore/Data/_01_Raw/Catalog.Raw.cs
@@ -5,28 +5,28 @@ namespace SpaceflightsPythonEFCore.Data;
 
 public partial class Catalog
 {
-  public ICatalogEntry<IEnumerable<CompanySchema>> Companies =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<CompanySchema>> Companies =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<CompanySchema>(
+        ItemFactory.Enumerable.Csv<CompanySchema>(
           label: "Companies",
           filePath: $"{_basePath}/_01_Raw/Datasets/companies.csv"
         )
     );
 
-  public ICatalogEntry<IEnumerable<ReviewSchema>> Reviews =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ReviewSchema>> Reviews =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<ReviewSchema>(
+        ItemFactory.Enumerable.Csv<ReviewSchema>(
           label: "Reviews",
           filePath: $"{_basePath}/_01_Raw/Datasets/reviews.csv"
         )
     );
 
-  public ICatalogEntry<IEnumerable<ShuttleSchema>> Shuttles =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ShuttleSchema>> Shuttles =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Excel<ShuttleSchema>(
+        ItemFactory.Enumerable.Excel<ShuttleSchema>(
           label: "Shuttles",
           filePath: $"{_basePath}/_01_Raw/Datasets/shuttles.xlsx",
           sheetName: "Sheet1"
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Data/_02_Intermediate/Catalog.Intermediate.cs b/examples/advanced/SpaceflightsPythonEFCore/Data/_02_Intermediate/Catalog.Intermediate.cs
index 81335acc..3192d964 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Data/_02_Intermediate/Catalog.Intermediate.cs
+++ b/examples/advanced/SpaceflightsPythonEFCore/Data/_02_Intermediate/Catalog.Intermediate.cs
@@ -11,10 +11,10 @@ namespace SpaceflightsPythonEFCore.Data;
 /// </summary>
 public partial class Catalog
 {
-  public ICatalogEntry<IEnumerable<PreprocessedCompanySchema>> PreprocessedCompanies =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<PreprocessedCompanySchema>> PreprocessedCompanies =>
+    CreateItem(
       () =>
-        EFCoreCatalogEntries
+        EFCoreItemFactory
           .Enumerable.EFCore<PreprocessedCompanySchema, SpaceflightsDbContext>(
             label: "PreprocessedCompanies",
             contextFactory: _contextFactory
@@ -22,10 +22,10 @@ public partial class Catalog
           .WithInspectionLevel(InspectionLevel.Shallow)
     );
 
-  public ICatalogEntry<IEnumerable<PreprocessedShuttleSchema>> PreprocessedShuttles =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<PreprocessedShuttleSchema>> PreprocessedShuttles =>
+    CreateItem(
       () =>
-        EFCoreCatalogEntries
+        EFCoreItemFactory
           .Enumerable.EFCore<PreprocessedShuttleSchema, SpaceflightsDbContext>(
             label: "PreprocessedShuttles",
             contextFactory: _contextFactory
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Data/_03_Primary/Catalog.Primary.cs b/examples/advanced/SpaceflightsPythonEFCore/Data/_03_Primary/Catalog.Primary.cs
index aa159b62..3dbb5914 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Data/_03_Primary/Catalog.Primary.cs
+++ b/examples/advanced/SpaceflightsPythonEFCore/Data/_03_Primary/Catalog.Primary.cs
@@ -11,10 +11,10 @@ namespace SpaceflightsPythonEFCore.Data;
 /// </summary>
 public partial class Catalog
 {
-  public ICatalogEntry<IEnumerable<ModelInputTableSchema>> ModelInputTable =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ModelInputTableSchema>> ModelInputTable =>
+    CreateItem(
       () =>
-        EFCoreCatalogEntries.Enumerable.EFCore<ModelInputTableSchema, SpaceflightsDbContext>(
+        EFCoreItemFactory.Enumerable.EFCore<ModelInputTableSchema, SpaceflightsDbContext>(
           label: "ModelInputTable",
           contextFactory: _contextFactory,
           queryCustomizer: q => q.OrderBy(r => r.ShuttleId)
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Data/_05_ModelInput/Catalog.ModelInput.cs b/examples/advanced/SpaceflightsPythonEFCore/Data/_05_ModelInput/Catalog.ModelInput.cs
index 5d92372d..ea5b6e28 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Data/_05_ModelInput/Catalog.ModelInput.cs
+++ b/examples/advanced/SpaceflightsPythonEFCore/Data/_05_ModelInput/Catalog.ModelInput.cs
@@ -9,15 +9,15 @@ namespace SpaceflightsPythonEFCore.Data;
 /// </summary>
 public partial class Catalog
 {
-  public ICatalogEntry<IEnumerable<XValues>> XTest =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<XValues>(label: "XTest"));
+  public IItem<IEnumerable<XValues>> XTest =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<XValues>(label: "XTest"));
 
-  public ICatalogEntry<IEnumerable<XValues>> XTrain =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<XValues>(label: "XTrain"));
+  public IItem<IEnumerable<XValues>> XTrain =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<XValues>(label: "XTrain"));
 
-  public ICatalogEntry<IEnumerable<YValues>> YTest =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<YValues>(label: "YTest"));
+  public IItem<IEnumerable<YValues>> YTest =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<YValues>(label: "YTest"));
 
-  public ICatalogEntry<IEnumerable<YValues>> YTrain =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<YValues>(label: "YTrain"));
+  public IItem<IEnumerable<YValues>> YTrain =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<YValues>(label: "YTrain"));
 }
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Data/_06_Models/Catalog.Models.cs b/examples/advanced/SpaceflightsPythonEFCore/Data/_06_Models/Catalog.Models.cs
index b2eade27..6b190be7 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Data/_06_Models/Catalog.Models.cs
+++ b/examples/advanced/SpaceflightsPythonEFCore/Data/_06_Models/Catalog.Models.cs
@@ -9,10 +9,10 @@ namespace SpaceflightsPythonEFCore.Data;
 /// </summary>
 public partial class Catalog
 {
-  public ICatalogEntry<LinearRegressionModel> Regressor =>
-    GetOrCreateEntry(
+  public IItem<LinearRegressionModel> Regressor =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<LinearRegressionModel>(
+        ItemFactory.Single.Json<LinearRegressionModel>(
           label: "Regressor",
           filePath: $"{_basePath}/_06_Models/Datasets/regressor.json"
         )
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Data/_07_ModelOutput/Catalog.ModelOutput.cs b/examples/advanced/SpaceflightsPythonEFCore/Data/_07_ModelOutput/Catalog.ModelOutput.cs
index 8755763c..6e3af1ff 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Data/_07_ModelOutput/Catalog.ModelOutput.cs
+++ b/examples/advanced/SpaceflightsPythonEFCore/Data/_07_ModelOutput/Catalog.ModelOutput.cs
@@ -15,19 +15,19 @@ namespace SpaceflightsPythonEFCore.Data;
 /// </summary>
 public partial class Catalog
 {
-  public ICatalogEntry<ModelMetrics> ModelMetrics =>
-    GetOrCreateEntry(
+  public IItem<ModelMetrics> ModelMetrics =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<ModelMetrics>(
+        ItemFactory.Single.Json<ModelMetrics>(
           label: "ModelMetrics",
           filePath: $"{_basePath}/_07_ModelOutput/Datasets/model_metrics.json"
         )
     );
 
-  public ICatalogEntry<IEnumerable<ModelPredictions>> ModelPredictions =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ModelPredictions>> ModelPredictions =>
+    CreateItem(
       () =>
-        EFCoreCatalogEntries.Enumerable.EFCore<ModelPredictions, SpaceflightsDbContext>(
+        EFCoreItemFactory.Enumerable.EFCore<ModelPredictions, SpaceflightsDbContext>(
           label: "ModelPredictions",
           contextFactory: _contextFactory,
           saveFunc: BulkSavePredictions
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Data/_08_Reporting/Catalog.Reporting.cs b/examples/advanced/SpaceflightsPythonEFCore/Data/_08_Reporting/Catalog.Reporting.cs
index e6a2b722..cb4aee35 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Data/_08_Reporting/Catalog.Reporting.cs
+++ b/examples/advanced/SpaceflightsPythonEFCore/Data/_08_Reporting/Catalog.Reporting.cs
@@ -7,28 +7,28 @@ namespace SpaceflightsPythonEFCore.Data;
 /// </summary>
 public partial class Catalog
 {
-  public ICatalogEntry<string> CapacityPlotExpress =>
-    GetOrCreateEntry(
+  public IItem<string> CapacityPlotExpress =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Text(
+        ItemFactory.Single.Text(
           label: "CapacityPlotExpress",
           filePath: $"{_basePath}/_08_Reporting/Datasets/shuttle_passenger_capacity_plot_exp.json"
         )
     );
 
-  public ICatalogEntry<string> CapacityPlotGraphObj =>
-    GetOrCreateEntry(
+  public IItem<string> CapacityPlotGraphObj =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Text(
+        ItemFactory.Single.Text(
           label: "CapacityPlotGraphObj",
           filePath: $"{_basePath}/_08_Reporting/Datasets/shuttle_passenger_capacity_plot_go.json"
         )
     );
 
-  public ICatalogEntry<byte[]> ConfusionMatrix =>
-    GetOrCreateEntry(
+  public IItem<byte[]> ConfusionMatrix =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "ConfusionMatrix",
           filePath: $"{_basePath}/_08_Reporting/Images/confusion_matrix.png"
         )
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataProcessing/DataProcessingPipeline.cs b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataProcessing/DataProcessingPipeline.cs
index 19ea9f0d..7962cbeb 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataProcessing/DataProcessingPipeline.cs
+++ b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataProcessing/DataProcessingPipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using SpaceflightsPythonEFCore.Data;
 using SpaceflightsPythonEFCore.Pipelines.DataProcessing.Nodes;
 
@@ -10,11 +10,11 @@ namespace SpaceflightsPythonEFCore.Pipelines.DataProcessing;
 /// </summary>
 public static class DataProcessingPipeline
 {
-  public static Pipeline Create(Catalog catalog)
+  public static Flow Create(Catalog catalog)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "PreprocessCompanies",
         description: "Parse and validate raw company data (C#). Stores result in EFCore.",
         transform: PreprocessCompaniesNode.Create(),
@@ -22,7 +22,7 @@ public static Pipeline Create(Catalog catalog)
         output: catalog.PreprocessedCompanies
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "PreprocessShuttles",
         description: "Parse and validate raw shuttle data (C#). Stores result in EFCore.",
         transform: PreprocessShuttlesNode.Create(),
@@ -30,7 +30,7 @@ public static Pipeline Create(Catalog catalog)
         output: catalog.PreprocessedShuttles
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "CreateModelInputTable",
         description: "Join preprocessed shuttles, companies, and reviews into a model input table (C#). Stores result in EFCore for Python consumption.",
         transform: CreateModelInputTableNode.Create(),
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/DataSciencePipeline.cs b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/DataSciencePipeline.cs
index cca1370f..9258f6bc 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/DataSciencePipeline.cs
+++ b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/DataSciencePipeline.cs
@@ -1,6 +1,6 @@
 using Flowthru.Extensions.Python.Execution;
-using Flowthru.Extensions.Python.Nodes;
-using Flowthru.Pipelines;
+using Flowthru.Extensions.Python.Steps;
+using Flowthru.Flows;
 using SpaceflightsPythonEFCore.Data;
 using SpaceflightsPythonEFCore.Data._03_Primary.Schemas;
 using SpaceflightsPythonEFCore.Data._05_ModelInput.Schemas;
@@ -17,11 +17,11 @@ namespace SpaceflightsPythonEFCore.Pipelines.DataScience;
 /// </summary>
 public static class DataSciencePipeline
 {
-  public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
+  public static Flow Create(Catalog catalog, IPythonExecutor executor)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddPythonNode<
+      pipeline.AddPythonStep<
         IEnumerable<ModelInputTableSchema>,
         IEnumerable<XValues>,
         IEnumerable<XValues>,
@@ -37,7 +37,7 @@ public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
         executor: executor
       );
 
-      pipeline.AddPythonNode(
+      pipeline.AddPythonStep(
         label: "TrainModel",
         description: "Train linear regression model on train split (Python).",
         module: "Pipelines.DataScience.Nodes.train_model",
@@ -47,7 +47,7 @@ public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
         executor: executor
       );
 
-      pipeline.AddPythonNode<
+      pipeline.AddPythonStep<
         LinearRegressionModel,
         IEnumerable<XValues>,
         IEnumerable<YValues>,
@@ -62,7 +62,7 @@ public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
         executor: executor
       );
 
-      pipeline.AddPythonNode<
+      pipeline.AddPythonStep<
         LinearRegressionModel,
         IEnumerable<XValues>,
         IEnumerable<YValues>,
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/evaluate_model.py b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/evaluate_model.py
index 5d028495..6b077318 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/evaluate_model.py
+++ b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/evaluate_model.py
@@ -1,14 +1,14 @@
-"""Model evaluation node."""
+"""Model evaluation step."""
 import logging
 import numpy as np
 import pandas as pd
 from sklearn.metrics import max_error, mean_absolute_error, r2_score
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
 
-@node(inputs=["LinearRegressionModel", "XValues", "YValues"], outputs="ModelMetrics")
+@step(inputs=["LinearRegressionModel", "XValues", "YValues"], outputs="ModelMetrics")
 def evaluate_model(regressor_params: dict, X_test: pd.DataFrame, y_test: pd.DataFrame) -> dict:
     """Calculates and logs the coefficient of determination.
 
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/generate_predictions.py b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/generate_predictions.py
index b546f316..65a13a08 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/generate_predictions.py
+++ b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/generate_predictions.py
@@ -1,13 +1,13 @@
-"""Model prediction generation node."""
+"""Model prediction generation step."""
 import logging
 import numpy as np
 import pandas as pd
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
 
-@node(inputs=["LinearRegressionModel", "XValues", "YValues"], outputs="ModelPredictions")
+@step(inputs=["LinearRegressionModel", "XValues", "YValues"], outputs="ModelPredictions")
 def generate_predictions(regressor_params: dict, X_test: pd.DataFrame, y_test: pd.DataFrame) -> pd.DataFrame:
     """Generate predictions from the trained model for visualization.
     
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/split_data.py b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/split_data.py
index b19e8beb..14fcd976 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/split_data.py
+++ b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/split_data.py
@@ -1,8 +1,8 @@
-"""Data splitting node for train/test split."""
+"""Data splitting step for train/test split."""
 import logging
 import pandas as pd
 from sklearn.model_selection import train_test_split
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
@@ -21,7 +21,7 @@
 ]
 
 
-@node(
+@step(
     inputs=["ModelInputTableSchema"],
     outputs=["XValues", "XValues", "YValues", "YValues"],
 )
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/train_model.py b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/train_model.py
index d54564d3..0053a160 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/train_model.py
+++ b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/DataScience/Nodes/train_model.py
@@ -1,13 +1,13 @@
-"""Model training node using scikit-learn."""
+"""Model training step using scikit-learn."""
 import logging
 import pandas as pd
 from sklearn.linear_model import LinearRegression
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
 
-@node(inputs=["XValues", "YValues"], outputs="LinearRegressionModel")
+@step(inputs=["XValues", "YValues"], outputs="LinearRegressionModel")
 def train_model(X_train: pd.DataFrame, y_train: pd.DataFrame) -> dict:
     """Trains the linear regression model.
 
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/Nodes/__init__.py b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/Nodes/__init__.py
index 2e932c2f..40fc227d 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/Nodes/__init__.py
+++ b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/Nodes/__init__.py
@@ -1 +1 @@
-"""Reporting pipeline nodes."""
+"""Reporting pipeline steps."""
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/Nodes/compare_passenger_capacity.py b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/Nodes/compare_passenger_capacity.py
index 6006f909..2506a851 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/Nodes/compare_passenger_capacity.py
+++ b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/Nodes/compare_passenger_capacity.py
@@ -1,15 +1,15 @@
-"""Passenger capacity comparison visualization nodes."""
+"""Passenger capacity comparison visualization steps."""
 import logging
 import pandas as pd
 import plotly.express as px
 import plotly.graph_objs as go
 import plotly.io as pio
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
 
-@node(inputs=["PreprocessedShuttleSchema"], outputs="CapacityPlotExpress")
+@step(inputs=["PreprocessedShuttleSchema"], outputs="CapacityPlotExpress")
 def compare_passenger_capacity_exp(preprocessed_shuttles: pd.DataFrame) -> str:
     """Create passenger capacity comparison using plotly.express.
     
@@ -48,7 +48,7 @@ def compare_passenger_capacity_exp(preprocessed_shuttles: pd.DataFrame) -> str:
     return pio.to_json(fig, pretty=True)
 
 
-@node(inputs=["PreprocessedShuttleSchema"], outputs="CapacityPlotGraphObj")
+@step(inputs=["PreprocessedShuttleSchema"], outputs="CapacityPlotGraphObj")
 def compare_passenger_capacity_go(preprocessed_shuttles: pd.DataFrame) -> str:
     """Create passenger capacity comparison using plotly.graph_objects.
     
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/Nodes/create_confusion_matrix.py b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/Nodes/create_confusion_matrix.py
index 210fbabb..54d94823 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/Nodes/create_confusion_matrix.py
+++ b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/Nodes/create_confusion_matrix.py
@@ -1,4 +1,4 @@
-"""Confusion matrix visualization node."""
+"""Confusion matrix visualization step."""
 import io
 import logging
 import matplotlib
@@ -6,12 +6,12 @@
 import numpy as np
 import pandas as pd
 import seaborn as sn
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
 
-@node(inputs=["ModelPredictions"], outputs="ConfusionMatrix")
+@step(inputs=["ModelPredictions"], outputs="ConfusionMatrix")
 def create_confusion_matrix(predictions: pd.DataFrame) -> bytes:
     """Create a confusion matrix from regression predictions binned into categories.
     
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/ReportingPipeline.cs b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/ReportingPipeline.cs
index 590b590f..04f716a6 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/ReportingPipeline.cs
+++ b/examples/advanced/SpaceflightsPythonEFCore/Pipelines/Reporting/ReportingPipeline.cs
@@ -1,6 +1,6 @@
 using Flowthru.Extensions.Python.Execution;
-using Flowthru.Extensions.Python.Nodes;
-using Flowthru.Pipelines;
+using Flowthru.Extensions.Python.Steps;
+using Flowthru.Flows;
 using SpaceflightsPythonEFCore.Data;
 using SpaceflightsPythonEFCore.Data._02_Intermediate.Schemas;
 using SpaceflightsPythonEFCore.Data._07_ModelOutput.Schemas;
@@ -14,11 +14,11 @@ namespace SpaceflightsPythonEFCore.Pipelines.Reporting;
 /// </summary>
 public static class ReportingPipeline
 {
-  public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
+  public static Flow Create(Catalog catalog, IPythonExecutor executor)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddPythonNode(
+      pipeline.AddPythonStep(
         label: "ComparePassengerCapacityExpress",
         description: "Shuttle capacity bar chart via plotly.express (Python). Reads PreprocessedShuttles from EFCore.",
         module: "Pipelines.Reporting.Nodes.compare_passenger_capacity",
@@ -28,7 +28,7 @@ public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
         executor: executor
       );
 
-      pipeline.AddPythonNode(
+      pipeline.AddPythonStep(
         label: "ComparePassengerCapacityGraphObj",
         description: "Shuttle capacity bar chart via plotly.graph_objects (Python). Reads PreprocessedShuttles from EFCore.",
         module: "Pipelines.Reporting.Nodes.compare_passenger_capacity",
@@ -38,7 +38,7 @@ public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
         executor: executor
       );
 
-      pipeline.AddPythonNode(
+      pipeline.AddPythonStep(
         label: "CreateConfusionMatrix",
         description: "Confusion matrix heatmap from model predictions (Python). Reads ModelPredictions from EFCore.",
         module: "Pipelines.Reporting.Nodes.create_confusion_matrix",
diff --git a/examples/advanced/SpaceflightsPythonEFCore/Program.cs b/examples/advanced/SpaceflightsPythonEFCore/Program.cs
index 08dcab27..cb262541 100644
--- a/examples/advanced/SpaceflightsPythonEFCore/Program.cs
+++ b/examples/advanced/SpaceflightsPythonEFCore/Program.cs
@@ -43,17 +43,33 @@ public class Program
   public static Task<int> Main(string[] args) =>
     FlowthruCli.RunStandaloneAsync(
       args,
-      services => ConfigureServices(services, Directory.GetCurrentDirectory())
+      services =>
+        ConfigureServices(
+          services,
+          Directory.GetCurrentDirectory(),
+          AppDomain.CurrentDomain.BaseDirectory
+        )
     );
 
-  public static IServiceProvider ConfigureServices(string? basePath = null)
+  public static IServiceProvider ConfigureServices(
+    string? basePath = null,
+    string? outputPath = null
+  )
   {
     var services = new ServiceCollection();
-    ConfigureServices(services, basePath ?? Directory.GetCurrentDirectory());
+    ConfigureServices(
+      services,
+      basePath ?? Directory.GetCurrentDirectory(),
+      outputPath ?? AppDomain.CurrentDomain.BaseDirectory
+    );
     return services.BuildServiceProvider();
   }
 
-  private static void ConfigureServices(IServiceCollection services, string basePath)
+  private static void ConfigureServices(
+    IServiceCollection services,
+    string basePath,
+    string outputPath
+  )
   {
     services.AddLogging(logging =>
     {
@@ -70,7 +86,7 @@ private static void ConfigureServices(IServiceCollection services, string basePa
     services.AddFlowthru(flowthru =>
     {
       flowthru.UseConfiguration(opts => opts.ConfigurationPath = basePath);
-      flowthru.UseCatalog(sp => new Catalog(
+      flowthru.RegisterCatalog(sp => new Catalog(
         basePath: Path.Combine(basePath, "Data"),
         contextFactory: sp.GetRequiredService<IDbContextFactory<SpaceflightsDbContext>>()
       ));
@@ -91,7 +107,8 @@ private static void ConfigureServices(IServiceCollection services, string basePa
       flowthru.UsePython(python =>
       {
         python.ModuleSearchPaths.Add(basePath);
-        python.ModuleSearchPaths.Add(AppDomain.CurrentDomain.BaseDirectory);
+        python.ModuleSearchPaths.Add(outputPath);
+        python.VenvPath = outputPath;
       });
 
       // Resolve the Python executor before pipeline registration (Phase 6 workaround).
@@ -101,15 +118,15 @@ private static void ConfigureServices(IServiceCollection services, string basePa
         tempProvider.GetRequiredService<Flowthru.Extensions.Python.Execution.IPythonExecutor>();
 
       flowthru
-        .RegisterPipeline(label: "DataProcessing", pipeline: DataProcessingPipeline.Create)
+        .RegisterFlow(label: "DataProcessing", flow: DataProcessingPipeline.Create)
         .WithDescription("Preprocesses companies and shuttles (C#), stores in EFCore");
 
       flowthru
-        .RegisterPipeline(label: "DataScience", pipeline: DataSciencePipeline.Create)
+        .RegisterFlow(label: "DataScience", flow: DataSciencePipeline.Create)
         .WithDescription("Trains and evaluates regression model (Python); reads/writes EFCore");
 
       flowthru
-        .RegisterPipeline(label: "Reporting", pipeline: ReportingPipeline.Create)
+        .RegisterFlow(label: "Reporting", flow: ReportingPipeline.Create)
         .WithDescription(
           "Generates visualizations (Python); reads PreprocessedShuttles and ModelPredictions from EFCore"
         );
diff --git a/examples/archived/UmapReferenceComparisons/Data/Catalog.cs b/examples/archived/UmapReferenceComparisons/Data/Catalog.cs
index e77fa724..0e075386 100644
--- a/examples/archived/UmapReferenceComparisons/Data/Catalog.cs
+++ b/examples/archived/UmapReferenceComparisons/Data/Catalog.cs
@@ -9,7 +9,7 @@ namespace UmapReferenceComparisons.Data;
 /// Manages reference data from Python UMAP implementation and comparison results.
 /// The catalog is split across partial classes organized by data layer.
 /// </remarks>
-public partial class Catalog : DataCatalogBase
+public partial class Catalog : CatalogAbstract
 {
   private readonly string _basePath;
 
diff --git a/examples/archived/UmapReferenceComparisons/Data/_01_Raw/Catalog.Inputs.cs b/examples/archived/UmapReferenceComparisons/Data/_01_Raw/Catalog.Inputs.cs
index 7be6af86..16982c5c 100644
--- a/examples/archived/UmapReferenceComparisons/Data/_01_Raw/Catalog.Inputs.cs
+++ b/examples/archived/UmapReferenceComparisons/Data/_01_Raw/Catalog.Inputs.cs
@@ -9,56 +9,56 @@ public partial class Catalog
   // Inputs - feature/label files moved from Reference into Inputs/<dataset>
   // ============================================================================
 
-  public ICatalogEntry<IEnumerable<IrisInputRow>> IrisInput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<IrisInputRow>> IrisInput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<IrisInputRow>(
+        ItemFactory.Enumerable.Parquet<IrisInputRow>(
           label: "IrisInput",
           filePath: $"{_basePath}/_01_Raw/Datasets/Inputs/iris/input.parquet"
         )
     );
 
-  public ICatalogEntry<IEnumerable<DigitsInputRow>> DigitsInput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<DigitsInputRow>> DigitsInput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<DigitsInputRow>(
+        ItemFactory.Enumerable.Parquet<DigitsInputRow>(
           label: "DigitsInput",
           filePath: $"{_basePath}/_01_Raw/Datasets/Inputs/digits/input.parquet"
         )
     );
 
-  public ICatalogEntry<IEnumerable<MnistInputRow>> MnistInput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<MnistInputRow>> MnistInput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<MnistInputRow>(
+        ItemFactory.Enumerable.Parquet<MnistInputRow>(
           label: "MnistInput",
           filePath: $"{_basePath}/_01_Raw/Datasets/Inputs/mnist/input.parquet"
         )
     );
 
-  public ICatalogEntry<IEnumerable<MnistInputRow>> FashionMnistInput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<MnistInputRow>> FashionMnistInput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<MnistInputRow>(
+        ItemFactory.Enumerable.Parquet<MnistInputRow>(
           label: "FashionMnistInput",
           filePath: $"{_basePath}/_01_Raw/Datasets/Inputs/fashion-mnist/input.parquet"
         )
     );
 
   // MNIST-transform train/test inputs
-  public ICatalogEntry<IEnumerable<MnistInputRow>> MnistTransformTrainInput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<MnistInputRow>> MnistTransformTrainInput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<MnistInputRow>(
+        ItemFactory.Enumerable.Parquet<MnistInputRow>(
           label: "MnistTransformTrainInput",
           filePath: $"{_basePath}/_01_Raw/Datasets/Inputs/mnist-transform/train_input.parquet"
         )
     );
 
-  public ICatalogEntry<IEnumerable<MnistInputRow>> MnistTransformTestInput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<MnistInputRow>> MnistTransformTestInput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<MnistInputRow>(
+        ItemFactory.Enumerable.Parquet<MnistInputRow>(
           label: "MnistTransformTestInput",
           filePath: $"{_basePath}/_01_Raw/Datasets/Inputs/mnist-transform/test_input.parquet"
         )
diff --git a/examples/archived/UmapReferenceComparisons/Data/_01_Raw/Catalog.Reference.cs b/examples/archived/UmapReferenceComparisons/Data/_01_Raw/Catalog.Reference.cs
index a1dfc1dc..d11fd141 100644
--- a/examples/archived/UmapReferenceComparisons/Data/_01_Raw/Catalog.Reference.cs
+++ b/examples/archived/UmapReferenceComparisons/Data/_01_Raw/Catalog.Reference.cs
@@ -9,56 +9,56 @@ public partial class Catalog
   // Reference - Python-produced outputs and any reference-only artifacts
   // ============================================================================
 
-  public ICatalogEntry<IEnumerable<UmapOutputRow>> IrisPythonOutput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<UmapOutputRow>> IrisPythonOutput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<UmapOutputRow>(
+        ItemFactory.Enumerable.Parquet<UmapOutputRow>(
           label: "IrisPythonOutput",
           filePath: $"{_basePath}/_01_Raw/Datasets/Reference/iris/output.parquet"
         )
     );
 
-  public ICatalogEntry<IEnumerable<UmapOutputRow>> DigitsPythonOutput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<UmapOutputRow>> DigitsPythonOutput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<UmapOutputRow>(
+        ItemFactory.Enumerable.Parquet<UmapOutputRow>(
           label: "DigitsPythonOutput",
           filePath: $"{_basePath}/_01_Raw/Datasets/Reference/digits/output.parquet"
         )
     );
 
-  public ICatalogEntry<IEnumerable<UmapOutputRow>> MnistPythonOutput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<UmapOutputRow>> MnistPythonOutput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<UmapOutputRow>(
+        ItemFactory.Enumerable.Parquet<UmapOutputRow>(
           label: "MnistPythonOutput",
           filePath: $"{_basePath}/_01_Raw/Datasets/Reference/mnist/output.parquet"
         )
     );
 
-  public ICatalogEntry<IEnumerable<UmapOutputRow>> FashionMnistPythonOutput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<UmapOutputRow>> FashionMnistPythonOutput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<UmapOutputRow>(
+        ItemFactory.Enumerable.Parquet<UmapOutputRow>(
           label: "FashionMnistPythonOutput",
           filePath: $"{_basePath}/_01_Raw/Datasets/Reference/fashion-mnist/output.parquet"
         )
     );
 
   // MNIST-transform reference outputs (train/test)
-  public ICatalogEntry<IEnumerable<UmapOutputRow>> MnistTransformTrainOutput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<UmapOutputRow>> MnistTransformTrainOutput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<UmapOutputRow>(
+        ItemFactory.Enumerable.Parquet<UmapOutputRow>(
           label: "MnistTransformTrainOutput",
           filePath: $"{_basePath}/_01_Raw/Datasets/Reference/mnist-transform/train_output.parquet"
         )
     );
 
-  public ICatalogEntry<IEnumerable<UmapOutputRow>> MnistTransformTestOutput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<UmapOutputRow>> MnistTransformTestOutput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<UmapOutputRow>(
+        ItemFactory.Enumerable.Parquet<UmapOutputRow>(
           label: "MnistTransformTestOutput",
           filePath: $"{_basePath}/_01_Raw/Datasets/Reference/mnist-transform/test_output.parquet"
         )
diff --git a/examples/archived/UmapReferenceComparisons/Data/_02_Intermediate/Catalog.Intermediate.cs b/examples/archived/UmapReferenceComparisons/Data/_02_Intermediate/Catalog.Intermediate.cs
index 419eea65..40a9c33b 100644
--- a/examples/archived/UmapReferenceComparisons/Data/_02_Intermediate/Catalog.Intermediate.cs
+++ b/examples/archived/UmapReferenceComparisons/Data/_02_Intermediate/Catalog.Intermediate.cs
@@ -12,26 +12,24 @@ public partial class Catalog
   /// <summary>
   /// Iris dataset in universal UMAP input format (in-memory).
   /// </summary>
-  public ICatalogEntry<IEnumerable<UmapInput>> IrisUmapInput =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<UmapInput>(label: "IrisUmapInput"));
+  public IItem<IEnumerable<UmapInput>> IrisUmapInput =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<UmapInput>(label: "IrisUmapInput"));
 
   /// <summary>
   /// Digits dataset in universal UMAP input format (in-memory).
   /// </summary>
-  public ICatalogEntry<IEnumerable<UmapInput>> DigitsUmapInput =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<UmapInput>(label: "DigitsUmapInput"));
+  public IItem<IEnumerable<UmapInput>> DigitsUmapInput =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<UmapInput>(label: "DigitsUmapInput"));
 
   /// <summary>
   /// MNIST dataset in universal UMAP input format (in-memory).
   /// </summary>
-  public ICatalogEntry<IEnumerable<UmapInput>> MnistUmapInput =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<UmapInput>(label: "MnistUmapInput"));
+  public IItem<IEnumerable<UmapInput>> MnistUmapInput =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<UmapInput>(label: "MnistUmapInput"));
 
   /// <summary>
   /// Fashion-MNIST dataset in universal UMAP input format (in-memory).
   /// </summary>
-  public ICatalogEntry<IEnumerable<UmapInput>> FashionMnistUmapInput =>
-    GetOrCreateEntry(
-      () => CatalogEntries.Enumerable.Memory<UmapInput>(label: "FashionMnistUmapInput")
-    );
+  public IItem<IEnumerable<UmapInput>> FashionMnistUmapInput =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<UmapInput>(label: "FashionMnistUmapInput"));
 }
diff --git a/examples/archived/UmapReferenceComparisons/Data/_02_ModelOutputs/Catalog.ModelOutputs.cs b/examples/archived/UmapReferenceComparisons/Data/_02_ModelOutputs/Catalog.ModelOutputs.cs
index 3db4662d..2e430fde 100644
--- a/examples/archived/UmapReferenceComparisons/Data/_02_ModelOutputs/Catalog.ModelOutputs.cs
+++ b/examples/archived/UmapReferenceComparisons/Data/_02_ModelOutputs/Catalog.ModelOutputs.cs
@@ -9,55 +9,55 @@ public partial class Catalog
   // Model Outputs - C# UMAP embeddings generated by pipeline nodes
   // ============================================================================
 
-  public ICatalogEntry<IEnumerable<UmapOutputRow>> IrisCSharpOutput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<UmapOutputRow>> IrisCSharpOutput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<UmapOutputRow>(
+        ItemFactory.Enumerable.Parquet<UmapOutputRow>(
           label: "IrisCSharpOutput",
           filePath: $"{_basePath}/_02_ModelOutputs/Datasets/iris_csharp_output.parquet"
         )
     );
 
-  public ICatalogEntry<IEnumerable<UmapOutputRow>> DigitsCSharpOutput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<UmapOutputRow>> DigitsCSharpOutput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<UmapOutputRow>(
+        ItemFactory.Enumerable.Parquet<UmapOutputRow>(
           label: "DigitsCSharpOutput",
           filePath: $"{_basePath}/_02_ModelOutputs/Datasets/digits_csharp_output.parquet"
         )
     );
 
-  public ICatalogEntry<IEnumerable<UmapOutputRow>> MnistCSharpOutput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<UmapOutputRow>> MnistCSharpOutput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<UmapOutputRow>(
+        ItemFactory.Enumerable.Parquet<UmapOutputRow>(
           label: "MnistCSharpOutput",
           filePath: $"{_basePath}/_02_ModelOutputs/Datasets/mnist_csharp_output.parquet"
         )
     );
 
-  public ICatalogEntry<IEnumerable<UmapOutputRow>> FashionMnistCSharpOutput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<UmapOutputRow>> FashionMnistCSharpOutput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<UmapOutputRow>(
+        ItemFactory.Enumerable.Parquet<UmapOutputRow>(
           label: "FashionMnistCSharpOutput",
           filePath: $"{_basePath}/_02_ModelOutputs/Datasets/fashion_mnist_csharp_output.parquet"
         )
     );
 
-  public ICatalogEntry<IEnumerable<UmapOutputRow>> MnistTransformTrainCSharpOutput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<UmapOutputRow>> MnistTransformTrainCSharpOutput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<UmapOutputRow>(
+        ItemFactory.Enumerable.Parquet<UmapOutputRow>(
           label: "MnistTransformTrainCSharpOutput",
           filePath: $"{_basePath}/_02_ModelOutputs/Datasets/mnist_transform_train_csharp_output.parquet"
         )
     );
 
-  public ICatalogEntry<IEnumerable<UmapOutputRow>> MnistTransformTestCSharpOutput =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<UmapOutputRow>> MnistTransformTestCSharpOutput =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<UmapOutputRow>(
+        ItemFactory.Enumerable.Parquet<UmapOutputRow>(
           label: "MnistTransformTestCSharpOutput",
           filePath: $"{_basePath}/_02_ModelOutputs/Datasets/mnist_transform_test_csharp_output.parquet"
         )
diff --git a/examples/archived/UmapReferenceComparisons/Data/_03_Reports/Catalog.Reports.cs b/examples/archived/UmapReferenceComparisons/Data/_03_Reports/Catalog.Reports.cs
index 38452826..973ea48a 100644
--- a/examples/archived/UmapReferenceComparisons/Data/_03_Reports/Catalog.Reports.cs
+++ b/examples/archived/UmapReferenceComparisons/Data/_03_Reports/Catalog.Reports.cs
@@ -11,113 +11,109 @@ public partial class Catalog
   // Reports - Comparison results and analysis outputs
   // ============================================================================
 
-  public ICatalogEntry<ComparisonResult> IrisComparison =>
-    GetOrCreateEntry(
+  public IItem<ComparisonResult> IrisComparison =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<ComparisonResult>(
+        ItemFactory.Single.Json<ComparisonResult>(
           label: "IrisComparison",
           filePath: $"{_basePath}/_03_Reports/Datasets/iris_comparison.json"
         )
     );
 
-  public ICatalogEntry<string> IrisRuntimeReport =>
-    GetOrCreateEntry(
+  public IItem<string> IrisRuntimeReport =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Text(
+        ItemFactory.Single.Text(
           label: "IrisRuntimeReport",
           filePath: $"{_basePath}/_03_Reports/Datasets/iris_runtime_report.txt"
         )
     );
 
-  public ICatalogEntry<GenericChart> IrisVisualization =>
-    GetOrCreateEntry(() => CatalogEntries.Single.Memory<GenericChart>(label: "IrisVisualization"));
+  public IItem<GenericChart> IrisVisualization =>
+    CreateItem(() => ItemFactory.Single.Memory<GenericChart>(label: "IrisVisualization"));
 
-  public ICatalogEntry<byte[]> IrisVisualizationPng =>
-    GetOrCreateEntry(
+  public IItem<byte[]> IrisVisualizationPng =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "IrisVisualizationPng",
           filePath: $"{_basePath}/_03_Reports/Datasets/iris_comparison.png"
         )
     );
 
-  public ICatalogEntry<ComparisonResult> DigitsComparison =>
-    GetOrCreateEntry(
+  public IItem<ComparisonResult> DigitsComparison =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<ComparisonResult>(
+        ItemFactory.Single.Json<ComparisonResult>(
           label: "DigitsComparison",
           filePath: $"{_basePath}/_03_Reports/Datasets/digits_comparison.json"
         )
     );
 
-  public ICatalogEntry<string> DigitsRuntimeReport =>
-    GetOrCreateEntry(
+  public IItem<string> DigitsRuntimeReport =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Text(
+        ItemFactory.Single.Text(
           label: "DigitsRuntimeReport",
           filePath: $"{_basePath}/_03_Reports/Datasets/digits_runtime_report.txt"
         )
     );
 
-  public ICatalogEntry<GenericChart> DigitsVisualization =>
-    GetOrCreateEntry(
-      () => CatalogEntries.Single.Memory<GenericChart>(label: "DigitsVisualization")
-    );
+  public IItem<GenericChart> DigitsVisualization =>
+    CreateItem(() => ItemFactory.Single.Memory<GenericChart>(label: "DigitsVisualization"));
 
-  public ICatalogEntry<byte[]> DigitsVisualizationPng =>
-    GetOrCreateEntry(
+  public IItem<byte[]> DigitsVisualizationPng =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "DigitsVisualizationPng",
           filePath: $"{_basePath}/_03_Reports/Datasets/digits_comparison.png"
         )
     );
 
-  public ICatalogEntry<ComparisonResult> MnistComparison =>
-    GetOrCreateEntry(
+  public IItem<ComparisonResult> MnistComparison =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<ComparisonResult>(
+        ItemFactory.Single.Json<ComparisonResult>(
           label: "MnistComparison",
           filePath: $"{_basePath}/_03_Reports/Datasets/mnist_comparison.json"
         )
     );
 
-  public ICatalogEntry<ComparisonResult> FashionMnistComparison =>
-    GetOrCreateEntry(
+  public IItem<ComparisonResult> FashionMnistComparison =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<ComparisonResult>(
+        ItemFactory.Single.Json<ComparisonResult>(
           label: "FashionMnistComparison",
           filePath: $"{_basePath}/_03_Reports/Datasets/fashion_mnist_comparison.json"
         )
     );
 
-  public ICatalogEntry<string> FashionMnistRuntimeReport =>
-    GetOrCreateEntry(
+  public IItem<string> FashionMnistRuntimeReport =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Text(
+        ItemFactory.Single.Text(
           label: "FashionMnistRuntimeReport",
           filePath: $"{_basePath}/_03_Reports/Datasets/fashion_mnist_runtime_report.txt"
         )
     );
 
-  public ICatalogEntry<ComparisonResult> MnistTransformComparison =>
-    GetOrCreateEntry(
+  public IItem<ComparisonResult> MnistTransformComparison =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<ComparisonResult>(
+        ItemFactory.Single.Json<ComparisonResult>(
           label: "MnistTransformComparison",
           filePath: $"{_basePath}/_03_Reports/Datasets/mnist_transform_comparison.json"
         )
     );
 
-  public ICatalogEntry<GenericChart> FashionMnistVisualization =>
-    GetOrCreateEntry(
-      () => CatalogEntries.Single.Memory<GenericChart>(label: "FashionMnistVisualization")
-    );
+  public IItem<GenericChart> FashionMnistVisualization =>
+    CreateItem(() => ItemFactory.Single.Memory<GenericChart>(label: "FashionMnistVisualization"));
 
-  public ICatalogEntry<byte[]> FashionMnistVisualizationPng =>
-    GetOrCreateEntry(
+  public IItem<byte[]> FashionMnistVisualizationPng =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "FashionMnistVisualizationPng",
           filePath: $"{_basePath}/_03_Reports/Datasets/fashion_mnist_comparison.png"
         )
diff --git a/examples/archived/UmapReferenceComparisons/Helpers/Nodes/PlotlyImageExportNode.cs b/examples/archived/UmapReferenceComparisons/Helpers/Nodes/PlotlyImageExportNode.cs
index 8934f469..464a9f9f 100644
--- a/examples/archived/UmapReferenceComparisons/Helpers/Nodes/PlotlyImageExportNode.cs
+++ b/examples/archived/UmapReferenceComparisons/Helpers/Nodes/PlotlyImageExportNode.cs
@@ -11,13 +11,13 @@ namespace UmapReferenceComparisons.Helpers.Nodes;
 /// <para>
 /// This node handles the PNG export concern separately from chart generation,
 /// enabling a clean separation of visualization logic from output format concerns.
-/// The PNG binary data can be stored in a BinaryFileCatalogEntry&lt;byte[]&gt;.
+/// The PNG binary data can be stored in a BinaryFileItem&lt;byte[]&gt;.
 /// </para>
 /// <para>
 /// <strong>Input:</strong> GenericChart object from memory catalog
 /// </para>
 /// <para>
-/// <strong>Output:</strong> PNG binary data as byte[] (can be stored in BinaryFileCatalogEntry&lt;byte[]&gt;)
+/// <strong>Output:</strong> PNG binary data as byte[] (can be stored in BinaryFileItem&lt;byte[]&gt;)
 /// </para>
 /// <para>
 /// <strong>Reusability:</strong> This node can be used for any Plotly chart type
diff --git a/examples/archived/UmapReferenceComparisons/Pipelines/DigitsComparison/DigitsComparisonPipeline.cs b/examples/archived/UmapReferenceComparisons/Pipelines/DigitsComparison/DigitsComparisonPipeline.cs
index 9850216d..4d1f3ed7 100644
--- a/examples/archived/UmapReferenceComparisons/Pipelines/DigitsComparison/DigitsComparisonPipeline.cs
+++ b/examples/archived/UmapReferenceComparisons/Pipelines/DigitsComparison/DigitsComparisonPipeline.cs
@@ -1,6 +1,6 @@
+using Flowthru.Flows;
 using Flowthru.Misc.ML.UMAP;
 using Flowthru.Misc.ML.UMAP.Core;
-using Flowthru.Pipelines;
 using UmapReferenceComparisons.Data;
 using UmapReferenceComparisons.Helpers.Nodes;
 using UmapReferenceComparisons.Pipelines.DigitsComparison.Nodes;
@@ -26,7 +26,7 @@ namespace UmapReferenceComparisons.Pipelines.DigitsComparison;
 /// </remarks>
 public static class DigitsComparisonPipeline
 {
-  public static Pipeline Create(Catalog catalog)
+  public static Flow Create(Catalog catalog)
   {
     var umapParameters = new UmapParameters
     {
@@ -40,9 +40,9 @@ public static Pipeline Create(Catalog catalog)
       Verbosity = 2,
     };
 
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ConvertDigitsToUmapInput",
         description: """
           Converts Digits-specific schema to universal UmapInput format.
@@ -53,7 +53,7 @@ Extracts all 64 pixel values (8x8 image) into a float array.
         output: catalog.DigitsUmapInput
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "TransformDigitsWithCSharpUmap",
         description: """
           Applies C# UMAP to Digits input features using the same parameters
@@ -72,7 +72,7 @@ Outputs both the embedding and runtime performance metrics.
         output: (catalog.DigitsCSharpOutput, catalog.DigitsRuntimeReport)
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "CompareDigitsOutputs",
         description: """
           Compares C# UMAP output against Python reference output using neighborhood preservation validation.
@@ -101,7 +101,7 @@ Outputs both the embedding and runtime performance metrics.
         output: catalog.DigitsComparison
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "VisualizeComparison",
         description: """
           Creates a side-by-side scatter plot comparing Python and C# UMAP embeddings.
@@ -124,7 +124,7 @@ Points are colored by digit class (0-9).
       );
 
       // NOTE: Commented out due to performance issues with Plotly.NET
-      // pipeline.AddNode(
+      // pipeline.AddStep(
       //   label: "ExportVisualizationToPng",
       //   description: """
       //     Exports the side-by-side comparison chart to a PNG file.
diff --git a/examples/archived/UmapReferenceComparisons/Pipelines/FashionComparison/FashionComparisonPipeline.cs b/examples/archived/UmapReferenceComparisons/Pipelines/FashionComparison/FashionComparisonPipeline.cs
index 647b98d8..dc01cf5c 100644
--- a/examples/archived/UmapReferenceComparisons/Pipelines/FashionComparison/FashionComparisonPipeline.cs
+++ b/examples/archived/UmapReferenceComparisons/Pipelines/FashionComparison/FashionComparisonPipeline.cs
@@ -1,6 +1,6 @@
+using Flowthru.Flows;
 using Flowthru.Misc.ML.UMAP;
 using Flowthru.Misc.ML.UMAP.Core;
-using Flowthru.Pipelines;
 using UmapReferenceComparisons.Data;
 using UmapReferenceComparisons.Helpers.Nodes;
 using UmapReferenceComparisons.Pipelines.FashionComparison.Nodes;
@@ -25,7 +25,7 @@ namespace UmapReferenceComparisons.Pipelines.FashionComparison;
 /// </remarks>
 public static class FashionComparisonPipeline
 {
-  public static Pipeline Create(Catalog catalog)
+  public static Flow Create(Catalog catalog)
   {
     var umapParameters = new UmapParameters
     {
@@ -38,9 +38,9 @@ public static Pipeline Create(Catalog catalog)
       Verbosity = 2,
     };
 
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ConvertFashionMnistToUmapInput",
         description: "Converts Fashion-MNIST schema to universal UmapInput format (float[784] features, class label)",
         transform: ConvertFashionMnistToUmapInputNode.Create(),
@@ -48,7 +48,7 @@ public static Pipeline Create(Catalog catalog)
         output: catalog.FashionMnistUmapInput
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "TransformFashionMnistWithCSharpUmap",
         description: "Applies C# UMAP to Fashion-MNIST input features using Python reference parameters. Outputs both the embedding and runtime performance metrics.",
         transform: TransformWithUmapNode.Create(
@@ -64,7 +64,7 @@ public static Pipeline Create(Catalog catalog)
 
       // This node requires a brute force KNN, and is too slow to test currently.
 
-      // pipeline.AddNode(
+      // pipeline.AddStep(
       //   label: "CompareFashionMnistOutputs",
       //   description: "Compares C# UMAP output against Python reference output using neighborhood preservation validation.",
       //   transform: CompareUmapImplementationsNode.Create(
@@ -86,7 +86,7 @@ public static Pipeline Create(Catalog catalog)
       //   output: catalog.FashionMnistComparison
       // );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "VisualizeFashionMnistComparison",
         description: "Creates a side-by-side scatter plot comparing Python and C# UMAP embeddings. Points colored by class.",
         transform: VisualizeUmapComparisonNode.Create(
@@ -105,7 +105,7 @@ public static Pipeline Create(Catalog catalog)
       );
 
       // NOTE: Commented out due to performance issues with Plotly.NET
-      // pipeline.AddNode(
+      // pipeline.AddStep(
       //   label: "ExportFashionMnistVisualizationToPng",
       //   description: "Exports the side-by-side comparison chart to a PNG file.",
       //   transform: PlotlyImageExportNode.Create(),
diff --git a/examples/archived/UmapReferenceComparisons/Pipelines/IrisComparison/IrisComparisonPipeline.cs b/examples/archived/UmapReferenceComparisons/Pipelines/IrisComparison/IrisComparisonPipeline.cs
index e090adb8..36999be0 100644
--- a/examples/archived/UmapReferenceComparisons/Pipelines/IrisComparison/IrisComparisonPipeline.cs
+++ b/examples/archived/UmapReferenceComparisons/Pipelines/IrisComparison/IrisComparisonPipeline.cs
@@ -1,6 +1,6 @@
+using Flowthru.Flows;
 using Flowthru.Misc.ML.UMAP;
 using Flowthru.Misc.ML.UMAP.Core;
-using Flowthru.Pipelines;
 using UmapReferenceComparisons.Data;
 using UmapReferenceComparisons.Data._01_Raw.Schemas;
 using UmapReferenceComparisons.Helpers.Nodes;
@@ -23,7 +23,7 @@ namespace UmapReferenceComparisons.Pipelines.IrisComparison;
 /// </remarks>
 public static class IrisComparisonPipeline
 {
-  public static Pipeline Create(Catalog catalog)
+  public static Flow Create(Catalog catalog)
   {
     var umapParameters = new UmapParameters
     {
@@ -36,9 +36,9 @@ public static Pipeline Create(Catalog catalog)
       Verbosity = 2,
     };
 
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ConvertIrisToUmapInput",
         description: """
           Converts Iris-specific schema to universal UmapInput format.
@@ -49,7 +49,7 @@ Extracts the 4 Iris features (sepal/petal length/width) into a float array.
         output: catalog.IrisUmapInput
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "TransformIrisWithCSharpUmap",
         description: """
           Applies C# UMAP to Iris input features using the same parameters
@@ -75,7 +75,7 @@ Outputs both the embedding and runtime performance metrics.
         output: (catalog.IrisCSharpOutput, catalog.IrisRuntimeReport)
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "CompareIrisOutputs",
         description: """
           Compares C# UMAP output against Python reference output using neighborhood preservation validation.
@@ -102,7 +102,7 @@ Outputs both the embedding and runtime performance metrics.
         output: catalog.IrisComparison
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "VisualizeComparison",
         description: """
           Creates a side-by-side scatter plot comparing Python and C# UMAP embeddings.
@@ -132,7 +132,7 @@ Points are colored by iris species (setosa, versicolor, virginica).
       );
 
       // NOTE: Commented out due to performance issues with Plotly.NET
-      // pipeline.AddNode(
+      // pipeline.AddStep(
       //   label: "ExportVisualizationToPng",
       //   description: """
       //     Exports the side-by-side comparison chart to a PNG file.
diff --git a/examples/archived/UmapReferenceComparisons/Program.cs b/examples/archived/UmapReferenceComparisons/Program.cs
index 00df9569..e76375de 100644
--- a/examples/archived/UmapReferenceComparisons/Program.cs
+++ b/examples/archived/UmapReferenceComparisons/Program.cs
@@ -47,20 +47,17 @@ private static void ConfigureServices(IServiceCollection services, string basePa
     {
       // Load configuration
       flowthru.UseConfiguration(opts => opts.ConfigurationPath = basePath);
-      flowthru.UseCatalog(_ => new Catalog(Path.Combine(basePath, "Data")));
+      flowthru.RegisterCatalog(_ => new Catalog(Path.Combine(basePath, "Data")));
 
       // Register comparison pipelines
       flowthru
-        .RegisterPipeline(label: "IrisComparisonPipeline", pipeline: IrisComparisonPipeline.Create)
+        .RegisterFlow(label: "IrisComparisonPipeline", flow: IrisComparisonPipeline.Create)
         .WithDescription(
           "Compare C# UMAP against Python reference for Iris dataset (150 samples, 4 features)"
         );
 
       flowthru
-        .RegisterPipeline(
-          label: "DigitsComparisonPipeline",
-          pipeline: DigitsComparisonPipeline.Create
-        )
+        .RegisterFlow(label: "DigitsComparisonPipeline", flow: DigitsComparisonPipeline.Create)
         .WithDescription(
           "Compare C# UMAP against Python reference for Digits dataset (1,797 samples, 64 features, 8x8 images)"
         );
diff --git a/examples/item-templates/README.md b/examples/item-templates/README.md
index c85ff879..eec77644 100644
--- a/examples/item-templates/README.md
+++ b/examples/item-templates/README.md
@@ -46,7 +46,7 @@ DataProcessing/
 
 **Before (generated):**
 ```csharp
-pipeline.AddNode(
+pipeline.AddStep(
   label: "DataProcessingDummy",
   description: "Placeholder node - replace with actual transformation logic.",
   transform: DataProcessingDummyNode.Create(),
@@ -57,7 +57,7 @@ pipeline.AddNode(
 
 **After (with real schemas):**
 ```csharp
-pipeline.AddNode(
+pipeline.AddStep(
   label: "PreprocessCompanies",
   description: "Clean and validate company data.",
   transform: PreprocessCompaniesNode.Create(),
diff --git a/examples/item-templates/pipeline/.template.config/template.json b/examples/item-templates/pipeline/.template.config/template.json
index 16b69c3b..3003f7a0 100644
--- a/examples/item-templates/pipeline/.template.config/template.json
+++ b/examples/item-templates/pipeline/.template.config/template.json
@@ -13,7 +13,7 @@
     "language": "C#",
     "type": "item"
   },
-  "sourceName": "PipelineName",
+  "sourceName": "FlowName",
   "symbols": {
     "ProjectName": {
       "type": "parameter",
@@ -44,10 +44,10 @@
   ],
   "primaryOutputs": [
     {
-      "path": "PipelineName/PipelineNamePipeline.cs"
+      "path": "FlowName/FlowNamePipeline.cs"
     },
     {
-      "path": "PipelineName/Nodes/PipelineNameDummyNode.cs"
+      "path": "FlowName/Nodes/FlowNameDummyNode.cs"
     }
   ],
   "postActions": [
@@ -58,7 +58,7 @@
           "text": "1. If ProjectName was not specified, replace 'ProjectName' with your actual project namespace in the generated files."
         },
         {
-          "text": "2. Register the pipeline in Program.cs: flowthru.RegisterPipeline<YourPipelineNamePipeline>();"
+          "text": "2. Register the pipeline in Program.cs: flowthru.RegisterPipeline<YourFlowNamePipeline>();"
         },
         {
           "text": "3. Replace the dummy node with actual transformation logic and update input/output catalog entries."
diff --git a/examples/item-templates/pipeline/PipelineName/Nodes/PipelineNameDummyNode.cs b/examples/item-templates/pipeline/PipelineName/Nodes/PipelineNameDummyNode.cs
index b293bec5..87c4eebe 100644
--- a/examples/item-templates/pipeline/PipelineName/Nodes/PipelineNameDummyNode.cs
+++ b/examples/item-templates/pipeline/PipelineName/Nodes/PipelineNameDummyNode.cs
@@ -1,11 +1,11 @@
 using Flowthru.Abstractions;
 
-namespace ProjectName.Pipelines.PipelineName.Nodes;
+namespace ProjectName.Pipelines.FlowName.Nodes;
 
 /// <summary>
-/// Dummy node for PipelineName pipeline - replace with actual transformation logic.
+/// Dummy node for FlowName pipeline - replace with actual transformation logic.
 /// </summary>
-public static class PipelineNameDummyNode
+public static class FlowNameDummyNode
 {
   /// <summary>
   /// Creates a dummy transformation function. Replace this with your actual processing logic.
diff --git a/examples/item-templates/pipeline/PipelineName/PipelineNamePipeline.cs b/examples/item-templates/pipeline/PipelineName/PipelineNamePipeline.cs
index bab0a5bd..211131e5 100644
--- a/examples/item-templates/pipeline/PipelineName/PipelineNamePipeline.cs
+++ b/examples/item-templates/pipeline/PipelineName/PipelineNamePipeline.cs
@@ -1,30 +1,30 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using ProjectName.Data;
-using ProjectName.Pipelines.PipelineName.Nodes;
+using ProjectName.Pipelines.FlowName.Nodes;
 
-namespace ProjectName.Pipelines.PipelineName;
+namespace ProjectName.Pipelines.FlowName;
 
 /// <summary>
-/// Pipeline for PipelineName operations.
+/// Pipeline for FlowName operations.
 /// </summary>
-public static class PipelineNamePipeline
+public static class FlowNamePipeline
 {
   /// <summary>
-  /// Creates the PipelineName pipeline.
+  /// Creates the FlowName pipeline.
   /// </summary>
   /// <param name="catalog">The data catalog containing input and output entries.</param>
   /// <returns>
-  /// A configured pipeline for PipelineName processing.
+  /// A configured pipeline for FlowName processing.
   /// </returns>
   public static Pipeline Create(Catalog catalog)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
       // Start with a dummy node - replace with your actu
-      pipeline.AddNode(
-        label: "PipelineNameDummy",
+      pipeline.AddStep(
+        label: "FlowNameDummy",
         description: "Placeholder",
-        transform: PipelineNameDummyNode.Create(),
+        transform: FlowNameDummyNode.Create(),
         input: catalog.NoData,
         output: catalog.NoData
       );
diff --git a/examples/starter/KedroIris/.template.config/template.json b/examples/starter/KedroIris/.template.config/template.json
index 641d6e91..dbfa060b 100644
--- a/examples/starter/KedroIris/.template.config/template.json
+++ b/examples/starter/KedroIris/.template.config/template.json
@@ -21,7 +21,7 @@
     "FlowthruVersion": {
       "type": "parameter",
       "dataType": "string",
-      "defaultValue": "0.1.32",
+      "defaultValue": "0.1.33",
       "replaces": "FlowthruVersion",
       "description": "Flowthru package version (auto-injected at pack time)"
     }
diff --git a/examples/starter/KedroIris/Data/Catalog.cs b/examples/starter/KedroIris/Data/Catalog.cs
index ea120fef..f45cb340 100644
--- a/examples/starter/KedroIris/Data/Catalog.cs
+++ b/examples/starter/KedroIris/Data/Catalog.cs
@@ -5,7 +5,7 @@ namespace KedroIris.Data;
 /// <summary>
 /// Data catalog for the Iris classification pipeline, providing access to datasets across all data layers.
 /// </summary>
-public partial class Catalog : DataCatalogBase
+public partial class Catalog : CatalogAbstract
 {
   private readonly string _basePath;
 
diff --git a/examples/starter/KedroIris/Data/_01_Raw/Catalog.Raw.cs b/examples/starter/KedroIris/Data/_01_Raw/Catalog.Raw.cs
index 3c79d486..8e7b7f1a 100644
--- a/examples/starter/KedroIris/Data/_01_Raw/Catalog.Raw.cs
+++ b/examples/starter/KedroIris/Data/_01_Raw/Catalog.Raw.cs
@@ -11,10 +11,10 @@ public partial class Catalog
   /// <summary>
   /// Raw iris dataset with measurements and species labels.
   /// </summary>
-  public ICatalogEntry<IEnumerable<IrisRawSchema>> IrisRaw =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<IrisRawSchema>> IrisRaw =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<IrisRawSchema>(
+        ItemFactory.Enumerable.Csv<IrisRawSchema>(
           label: "IrisRaw",
           filePath: $"{_basePath}/_01_Raw/Datasets/iris.csv"
         )
diff --git a/examples/starter/KedroIris/Data/_04_Feature/Catalog.Feature.cs b/examples/starter/KedroIris/Data/_04_Feature/Catalog.Feature.cs
index 0373ccc0..83767e99 100644
--- a/examples/starter/KedroIris/Data/_04_Feature/Catalog.Feature.cs
+++ b/examples/starter/KedroIris/Data/_04_Feature/Catalog.Feature.cs
@@ -12,10 +12,10 @@ public partial class Catalog
   /// Iris data with one-hot encoded species classifications.
   /// Created by the DataEngineering pipeline after splitting and encoding.
   /// </summary>
-  public ICatalogEntry<IEnumerable<IrisFeatureSchema>> IrisFeatures =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<IrisFeatureSchema>> IrisFeatures =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<IrisFeatureSchema>(
+        ItemFactory.Enumerable.Csv<IrisFeatureSchema>(
           label: "IrisFeatures",
           filePath: $"{_basePath}/_04_Feature/Datasets/iris_features.csv"
         )
diff --git a/examples/starter/KedroIris/Data/_05_ModelInput/Catalog.ModelInput.cs b/examples/starter/KedroIris/Data/_05_ModelInput/Catalog.ModelInput.cs
index c74788bc..f09c124a 100644
--- a/examples/starter/KedroIris/Data/_05_ModelInput/Catalog.ModelInput.cs
+++ b/examples/starter/KedroIris/Data/_05_ModelInput/Catalog.ModelInput.cs
@@ -12,10 +12,10 @@ public partial class Catalog
   /// <summary>
   /// Training feature vectors (X).
   /// </summary>
-  public ICatalogEntry<IEnumerable<FeatureVectorSchema>> TrainX =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<FeatureVectorSchema>> TrainX =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<FeatureVectorSchema>(
+        ItemFactory.Enumerable.Csv<FeatureVectorSchema>(
           label: "TrainX",
           filePath: $"{_basePath}/_05_ModelInput/Datasets/train_x.csv"
         )
@@ -24,10 +24,10 @@ public partial class Catalog
   /// <summary>
   /// Training target labels (Y).
   /// </summary>
-  public ICatalogEntry<IEnumerable<TargetLabelSchema>> TrainY =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<TargetLabelSchema>> TrainY =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<TargetLabelSchema>(
+        ItemFactory.Enumerable.Csv<TargetLabelSchema>(
           label: "TrainY",
           filePath: $"{_basePath}/_05_ModelInput/Datasets/train_y.csv"
         )
@@ -36,10 +36,10 @@ public partial class Catalog
   /// <summary>
   /// Test feature vectors (X).
   /// </summary>
-  public ICatalogEntry<IEnumerable<FeatureVectorSchema>> TestX =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<FeatureVectorSchema>> TestX =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<FeatureVectorSchema>(
+        ItemFactory.Enumerable.Csv<FeatureVectorSchema>(
           label: "TestX",
           filePath: $"{_basePath}/_05_ModelInput/Datasets/test_x.csv"
         )
@@ -48,10 +48,10 @@ public partial class Catalog
   /// <summary>
   /// Test target labels (Y).
   /// </summary>
-  public ICatalogEntry<IEnumerable<TargetLabelSchema>> TestY =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<TargetLabelSchema>> TestY =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<TargetLabelSchema>(
+        ItemFactory.Enumerable.Csv<TargetLabelSchema>(
           label: "TestY",
           filePath: $"{_basePath}/_05_ModelInput/Datasets/test_y.csv"
         )
diff --git a/examples/starter/KedroIris/Data/_06_Models/Catalog.Models.cs b/examples/starter/KedroIris/Data/_06_Models/Catalog.Models.cs
index d75c448b..c3e29c95 100644
--- a/examples/starter/KedroIris/Data/_06_Models/Catalog.Models.cs
+++ b/examples/starter/KedroIris/Data/_06_Models/Catalog.Models.cs
@@ -12,10 +12,10 @@ public partial class Catalog
   /// Trained multi-class logistic regression model.
   /// Contains weight matrix for all three species classifiers.
   /// </summary>
-  public ICatalogEntry<ModelWeightsSchema> IrisModel =>
-    GetOrCreateEntry(
+  public IItem<ModelWeightsSchema> IrisModel =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<ModelWeightsSchema>(
+        ItemFactory.Single.Json<ModelWeightsSchema>(
           label: "IrisModel",
           filePath: $"{_basePath}/_06_Models/Datasets/iris_model.json"
         )
diff --git a/examples/starter/KedroIris/Data/_07_ModelOutput/Catalog.ModelOutput.cs b/examples/starter/KedroIris/Data/_07_ModelOutput/Catalog.ModelOutput.cs
index b35f02d6..b4aa1100 100644
--- a/examples/starter/KedroIris/Data/_07_ModelOutput/Catalog.ModelOutput.cs
+++ b/examples/starter/KedroIris/Data/_07_ModelOutput/Catalog.ModelOutput.cs
@@ -11,10 +11,10 @@ public partial class Catalog
   /// <summary>
   /// Predictions from the trained model on the test set.
   /// </summary>
-  public ICatalogEntry<IEnumerable<PredictionSchema>> Predictions =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<PredictionSchema>> Predictions =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<PredictionSchema>(
+        ItemFactory.Enumerable.Csv<PredictionSchema>(
           label: "Predictions",
           filePath: $"{_basePath}/_07_ModelOutput/Datasets/predictions.csv"
         )
diff --git a/examples/starter/KedroIris/Data/_08_Reporting/Catalog.Reporting.cs b/examples/starter/KedroIris/Data/_08_Reporting/Catalog.Reporting.cs
index 9bfbb8f5..52540367 100644
--- a/examples/starter/KedroIris/Data/_08_Reporting/Catalog.Reporting.cs
+++ b/examples/starter/KedroIris/Data/_08_Reporting/Catalog.Reporting.cs
@@ -11,10 +11,10 @@ public partial class Catalog
   /// <summary>
   /// Model evaluation metrics including accuracy and confusion statistics.
   /// </summary>
-  public ICatalogEntry<MetricsSchema> Metrics =>
-    GetOrCreateEntry(
+  public IItem<MetricsSchema> Metrics =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<MetricsSchema>(
+        ItemFactory.Single.Json<MetricsSchema>(
           label: "Metrics",
           filePath: $"{_basePath}/_08_Reporting/Datasets/metrics.json"
         )
diff --git a/examples/starter/KedroIris/Pipelines/DataEngineering/DataEngineeringPipeline.cs b/examples/starter/KedroIris/Pipelines/DataEngineering/DataEngineeringPipeline.cs
index a3b56e00..7ff3f2af 100644
--- a/examples/starter/KedroIris/Pipelines/DataEngineering/DataEngineeringPipeline.cs
+++ b/examples/starter/KedroIris/Pipelines/DataEngineering/DataEngineeringPipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using KedroIris.Data;
 using KedroIris.Pipelines.DataEngineering.Nodes;
 
@@ -26,11 +26,11 @@ public record Params
   /// <param name="catalog">The data catalog containing input and output entries.</param>
   /// <param name="parameters">Configuration parameters for the pipeline.</param>
   /// <returns>A configured pipeline that produces training and test splits with one-hot encoding.</returns>
-  public static Pipeline Create(Catalog catalog, Params parameters)
+  public static Flow Create(Catalog catalog, Params parameters)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "SplitAndEncode",
         description: """
           Splits the Iris dataset into training and test sets.
diff --git a/examples/starter/KedroIris/Pipelines/DataScience/DataSciencePipeline.cs b/examples/starter/KedroIris/Pipelines/DataScience/DataSciencePipeline.cs
index 1001eea5..3ff5112a 100644
--- a/examples/starter/KedroIris/Pipelines/DataScience/DataSciencePipeline.cs
+++ b/examples/starter/KedroIris/Pipelines/DataScience/DataSciencePipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using KedroIris.Data;
 using KedroIris.Pipelines.DataScience.Nodes;
 
@@ -31,11 +31,11 @@ public record Params
   /// <param name="catalog">The data catalog containing input and output entries.</param>
   /// <param name="parameters">Configuration parameters for the pipeline.</param>
   /// <returns>A configured pipeline that produces a trained model, predictions, and metrics.</returns>
-  public static Pipeline Create(Catalog catalog, Params parameters)
+  public static Flow Create(Catalog catalog, Params parameters)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "TrainModel",
         description: "Trains a multi-class logistic regression model using gradient descent.",
         transform: TrainModelNode.Create(parameters.NumTrainIter, parameters.LearningRate),
@@ -43,7 +43,7 @@ public static Pipeline Create(Catalog catalog, Params parameters)
         output: catalog.IrisModel
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "Predict",
         description: "Predicts species classifications for the test set using the trained model.",
         transform: PredictNode.Create(),
@@ -51,7 +51,7 @@ public static Pipeline Create(Catalog catalog, Params parameters)
         output: catalog.Predictions
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "Evaluate",
         description: "Evaluates prediction accuracy and saves metrics to the reporting layer.",
         transform: EvaluateModelNode.Create(),
diff --git a/examples/starter/KedroIris/Program.cs b/examples/starter/KedroIris/Program.cs
index dea194d3..c1870339 100644
--- a/examples/starter/KedroIris/Program.cs
+++ b/examples/starter/KedroIris/Program.cs
@@ -44,7 +44,7 @@ private static void ConfigureServices(IServiceCollection services, string basePa
     services.AddFlowthru(flowthru =>
     {
       flowthru.UseConfiguration(opts => opts.ConfigurationPath = basePath);
-      flowthru.UseCatalog(_ => new Catalog(Path.Combine(basePath, "Data")));
+      flowthru.RegisterCatalog(_ => new Catalog(Path.Combine(basePath, "Data")));
 
       // Output pipeline metadata
       flowthru.ConfigureMetadata(meta =>
@@ -60,18 +60,18 @@ private static void ConfigureServices(IServiceCollection services, string basePa
 
       // Register data engineering pipeline with configuration parameters
       flowthru
-        .RegisterPipeline(
+        .RegisterFlow(
           label: "DataEngineering",
-          pipeline: DataEngineeringPipeline.Create,
+          flow: DataEngineeringPipeline.Create,
           configurationSection: "Flowthru:Pipelines:DataEngineering"
         )
         .WithDescription("Splits iris data into training and test sets with one-hot encoding");
 
       // Register data science pipeline with configuration parameters
       flowthru
-        .RegisterPipeline(
+        .RegisterFlow(
           label: "DataScience",
-          pipeline: DataSciencePipeline.Create,
+          flow: DataSciencePipeline.Create,
           configurationSection: "Flowthru:Pipelines:DataScience"
         )
         .WithDescription("Trains multi-class logistic regression model for iris classification");
diff --git a/examples/starter/KedroIrisPython/.template.config/template.json b/examples/starter/KedroIrisPython/.template.config/template.json
index 1bcaf9c8..6af0c61e 100644
--- a/examples/starter/KedroIrisPython/.template.config/template.json
+++ b/examples/starter/KedroIrisPython/.template.config/template.json
@@ -22,7 +22,7 @@
     "FlowthruVersion": {
       "type": "parameter",
       "dataType": "string",
-      "defaultValue": "0.1.32",
+      "defaultValue": "0.1.33",
       "replaces": "FlowthruVersion",
       "description": "Flowthru package version (auto-injected at pack time)"
     }
diff --git a/examples/starter/KedroIrisPython/Data/Catalog.cs b/examples/starter/KedroIrisPython/Data/Catalog.cs
index 4562bfda..eaa5016a 100644
--- a/examples/starter/KedroIrisPython/Data/Catalog.cs
+++ b/examples/starter/KedroIrisPython/Data/Catalog.cs
@@ -5,7 +5,7 @@ namespace KedroIrisPython.Data;
 /// <summary>
 /// Data catalog for the Iris pipeline, providing access to datasets across all data layers.
 /// </summary>
-public partial class Catalog : DataCatalogBase
+public partial class Catalog : CatalogAbstract
 {
   private readonly string _basePath;
 
diff --git a/examples/starter/KedroIrisPython/Data/_01_Raw/Catalog.Raw.cs b/examples/starter/KedroIrisPython/Data/_01_Raw/Catalog.Raw.cs
index c8f260fd..061c3406 100644
--- a/examples/starter/KedroIrisPython/Data/_01_Raw/Catalog.Raw.cs
+++ b/examples/starter/KedroIrisPython/Data/_01_Raw/Catalog.Raw.cs
@@ -11,10 +11,10 @@ public partial class Catalog
   /// <summary>
   /// Raw iris dataset with measurements and species labels.
   /// </summary>
-  public ICatalogEntry<IEnumerable<IrisRawSchema>> IrisRaw =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<IrisRawSchema>> IrisRaw =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<IrisRawSchema>(
+        ItemFactory.Enumerable.Csv<IrisRawSchema>(
           label: "IrisRaw",
           filePath: $"{_basePath}/_01_Raw/Datasets/iris.csv"
         )
diff --git a/examples/starter/KedroIrisPython/Data/_05_ModelInput/Catalog.ModelInput.cs b/examples/starter/KedroIrisPython/Data/_05_ModelInput/Catalog.ModelInput.cs
index bce9beb7..801ad069 100644
--- a/examples/starter/KedroIrisPython/Data/_05_ModelInput/Catalog.ModelInput.cs
+++ b/examples/starter/KedroIrisPython/Data/_05_ModelInput/Catalog.ModelInput.cs
@@ -12,10 +12,10 @@ public partial class Catalog
   /// <summary>
   /// Training feature vectors (X).
   /// </summary>
-  public ICatalogEntry<IEnumerable<FeatureVectorSchema>> TrainX =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<FeatureVectorSchema>> TrainX =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<FeatureVectorSchema>(
+        ItemFactory.Enumerable.Parquet<FeatureVectorSchema>(
           label: "TrainX",
           filePath: $"{_basePath}/_05_ModelInput/Datasets/train_x.parquet"
         )
@@ -24,10 +24,10 @@ public partial class Catalog
   /// <summary>
   /// Training target labels (Y) with one-hot encoding.
   /// </summary>
-  public ICatalogEntry<IEnumerable<TargetLabelSchema>> TrainY =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<TargetLabelSchema>> TrainY =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<TargetLabelSchema>(
+        ItemFactory.Enumerable.Parquet<TargetLabelSchema>(
           label: "TrainY",
           filePath: $"{_basePath}/_05_ModelInput/Datasets/train_y.parquet"
         )
@@ -36,10 +36,10 @@ public partial class Catalog
   /// <summary>
   /// Test feature vectors (X).
   /// </summary>
-  public ICatalogEntry<IEnumerable<FeatureVectorSchema>> TestX =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<FeatureVectorSchema>> TestX =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<FeatureVectorSchema>(
+        ItemFactory.Enumerable.Parquet<FeatureVectorSchema>(
           label: "TestX",
           filePath: $"{_basePath}/_05_ModelInput/Datasets/test_x.parquet"
         )
@@ -48,10 +48,10 @@ public partial class Catalog
   /// <summary>
   /// Test target labels (Y) with one-hot encoding.
   /// </summary>
-  public ICatalogEntry<IEnumerable<TargetLabelSchema>> TestY =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<TargetLabelSchema>> TestY =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<TargetLabelSchema>(
+        ItemFactory.Enumerable.Parquet<TargetLabelSchema>(
           label: "TestY",
           filePath: $"{_basePath}/_05_ModelInput/Datasets/test_y.parquet"
         )
diff --git a/examples/starter/KedroIrisPython/Data/_06_Models/Catalog.Models.cs b/examples/starter/KedroIrisPython/Data/_06_Models/Catalog.Models.cs
index 9f04986c..43e953c5 100644
--- a/examples/starter/KedroIrisPython/Data/_06_Models/Catalog.Models.cs
+++ b/examples/starter/KedroIrisPython/Data/_06_Models/Catalog.Models.cs
@@ -11,10 +11,10 @@ public partial class Catalog
   /// Trained logistic regression model weights.
   /// Stored as a pickled binary file (Python pickle format).
   /// </summary>
-  public ICatalogEntry<byte[]> ModelWeights =>
-    GetOrCreateEntry(
+  public IItem<byte[]> ModelWeights =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "ModelWeights",
           filePath: $"{_basePath}/_06_Models/Datasets/model.pkl"
         )
diff --git a/examples/starter/KedroIrisPython/Data/_07_ModelOutput/Catalog.ModelOutput.cs b/examples/starter/KedroIrisPython/Data/_07_ModelOutput/Catalog.ModelOutput.cs
index 80aacbb5..f237cab3 100644
--- a/examples/starter/KedroIrisPython/Data/_07_ModelOutput/Catalog.ModelOutput.cs
+++ b/examples/starter/KedroIrisPython/Data/_07_ModelOutput/Catalog.ModelOutput.cs
@@ -11,10 +11,10 @@ public partial class Catalog
   /// <summary>
   /// Predicted class indices for test data.
   /// </summary>
-  public ICatalogEntry<IEnumerable<PredictionSchema>> Predictions =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<PredictionSchema>> Predictions =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<PredictionSchema>(
+        ItemFactory.Enumerable.Parquet<PredictionSchema>(
           label: "Predictions",
           filePath: $"{_basePath}/_07_ModelOutput/Datasets/predictions.parquet"
         )
diff --git a/examples/starter/KedroIrisPython/Data/_08_Reporting/Catalog.Reporting.cs b/examples/starter/KedroIrisPython/Data/_08_Reporting/Catalog.Reporting.cs
index f58b77ab..7f9462c5 100644
--- a/examples/starter/KedroIrisPython/Data/_08_Reporting/Catalog.Reporting.cs
+++ b/examples/starter/KedroIrisPython/Data/_08_Reporting/Catalog.Reporting.cs
@@ -11,10 +11,10 @@ public partial class Catalog
   /// <summary>
   /// Model accuracy report with detailed metrics.
   /// </summary>
-  public ICatalogEntry<AccuracyReportSchema> AccuracyReport =>
-    GetOrCreateEntry(
+  public IItem<AccuracyReportSchema> AccuracyReport =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<AccuracyReportSchema>(
+        ItemFactory.Single.Json<AccuracyReportSchema>(
           label: "AccuracyReport",
           filePath: $"{_basePath}/_08_Reporting/Datasets/accuracy_report.json"
         )
diff --git a/examples/starter/KedroIrisPython/Pipelines/DataEngineering/DataEngineeringPipeline.cs b/examples/starter/KedroIrisPython/Pipelines/DataEngineering/DataEngineeringPipeline.cs
index 7430a1cf..870c8ee9 100644
--- a/examples/starter/KedroIrisPython/Pipelines/DataEngineering/DataEngineeringPipeline.cs
+++ b/examples/starter/KedroIrisPython/Pipelines/DataEngineering/DataEngineeringPipeline.cs
@@ -1,6 +1,6 @@
 using Flowthru.Extensions.Python.Execution;
-using Flowthru.Extensions.Python.Nodes;
-using Flowthru.Pipelines;
+using Flowthru.Extensions.Python.Steps;
+using Flowthru.Flows;
 using KedroIrisPython.Data;
 using KedroIrisPython.Data._01_Raw.Schemas;
 using KedroIrisPython.Data._05_ModelInput.Schemas;
@@ -15,11 +15,11 @@ public static class DataEngineeringPipeline
   /// <summary>
   /// Creates the data engineering pipeline.
   /// </summary>
-  public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
+  public static Flow Create(Catalog catalog, IPythonExecutor executor)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddPythonNode<
+      pipeline.AddPythonStep<
         IEnumerable<IrisRawSchema>,
         IEnumerable<FeatureVectorSchema>,
         IEnumerable<TargetLabelSchema>,
diff --git a/examples/starter/KedroIrisPython/Pipelines/DataEngineering/Nodes/__init__.py b/examples/starter/KedroIrisPython/Pipelines/DataEngineering/Nodes/__init__.py
index dbceda6e..d888d2ed 100644
--- a/examples/starter/KedroIrisPython/Pipelines/DataEngineering/Nodes/__init__.py
+++ b/examples/starter/KedroIrisPython/Pipelines/DataEngineering/Nodes/__init__.py
@@ -1 +1 @@
-"""Data engineering nodes package."""
+"""Data engineering steps package."""
diff --git a/examples/starter/KedroIrisPython/Pipelines/DataEngineering/Nodes/split_data.py b/examples/starter/KedroIrisPython/Pipelines/DataEngineering/Nodes/split_data.py
index 718a379d..a412bad8 100644
--- a/examples/starter/KedroIrisPython/Pipelines/DataEngineering/Nodes/split_data.py
+++ b/examples/starter/KedroIrisPython/Pipelines/DataEngineering/Nodes/split_data.py
@@ -1,9 +1,9 @@
-"""Data engineering node for splitting iris data into train/test sets."""
+"""Data engineering step for splitting iris data into train/test sets."""
 import pandas as pd
-from flowthru import node
+from flowthru import step
 
 
-@node(
+@step(
     inputs=["IrisRawSchema"],
     outputs=["FeatureVectorSchema", "TargetLabelSchema", "FeatureVectorSchema", "TargetLabelSchema"]
 )
diff --git a/examples/starter/KedroIrisPython/Pipelines/DataScience/DataSciencePipeline.cs b/examples/starter/KedroIrisPython/Pipelines/DataScience/DataSciencePipeline.cs
index 5acd965d..03ec411d 100644
--- a/examples/starter/KedroIrisPython/Pipelines/DataScience/DataSciencePipeline.cs
+++ b/examples/starter/KedroIrisPython/Pipelines/DataScience/DataSciencePipeline.cs
@@ -1,6 +1,6 @@
 using Flowthru.Extensions.Python.Execution;
-using Flowthru.Extensions.Python.Nodes;
-using Flowthru.Pipelines;
+using Flowthru.Extensions.Python.Steps;
+using Flowthru.Flows;
 using KedroIrisPython.Data;
 using KedroIrisPython.Data._05_ModelInput.Schemas;
 using KedroIrisPython.Data._07_ModelOutput.Schemas;
@@ -16,12 +16,12 @@ public static class DataSciencePipeline
   /// <summary>
   /// Creates the data science pipeline.
   /// </summary>
-  public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
+  public static Flow Create(Catalog catalog, IPythonExecutor executor)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
       // Train model using training data
-      pipeline.AddPythonNode<
+      pipeline.AddPythonStep<
         IEnumerable<FeatureVectorSchema>,
         IEnumerable<TargetLabelSchema>,
         byte[]
@@ -36,7 +36,7 @@ public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
       );
 
       // Generate predictions using trained model
-      pipeline.AddPythonNode<
+      pipeline.AddPythonStep<
         byte[],
         IEnumerable<FeatureVectorSchema>,
         IEnumerable<PredictionSchema>
@@ -51,7 +51,7 @@ public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
       );
 
       // Report accuracy metrics
-      pipeline.AddPythonNode<
+      pipeline.AddPythonStep<
         IEnumerable<PredictionSchema>,
         IEnumerable<TargetLabelSchema>,
         AccuracyReportSchema
diff --git a/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/__init__.py b/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/__init__.py
index 8c07d257..dc37d2bc 100644
--- a/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/__init__.py
+++ b/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/__init__.py
@@ -1 +1 @@
-"""Data science nodes package."""
+"""Data science steps package."""
diff --git a/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/predict.py b/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/predict.py
index 3fb242a1..71b5f6ae 100644
--- a/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/predict.py
+++ b/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/predict.py
@@ -3,7 +3,7 @@
 import pickle
 import numpy as np
 import pandas as pd
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
@@ -13,7 +13,7 @@ def _sigmoid(z):
     return 1 / (1 + np.exp(-z))
 
 
-@node(inputs=["bytes", "FeatureVectorSchema"], outputs=["PredictionSchema"])
+@step(inputs=["bytes", "FeatureVectorSchema"], outputs=["PredictionSchema"])
 def predict(model_bytes: bytes, test_x: pd.DataFrame) -> pd.DataFrame:
     """Node for making predictions given a pre-trained model and a test set.
     
diff --git a/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/report_accuracy.py b/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/report_accuracy.py
index 523b1d62..37c3f931 100644
--- a/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/report_accuracy.py
+++ b/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/report_accuracy.py
@@ -2,12 +2,12 @@
 import logging
 import numpy as np
 import pandas as pd
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
 
-@node(inputs=["PredictionSchema", "TargetLabelSchema"], outputs="AccuracyReportSchema")
+@step(inputs=["PredictionSchema", "TargetLabelSchema"], outputs="AccuracyReportSchema")
 def report_accuracy(predictions: pd.DataFrame, test_y: pd.DataFrame) -> dict:
     """Node for reporting the accuracy of the predictions.
     
diff --git a/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/train_model.py b/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/train_model.py
index a4190b99..b50086ab 100644
--- a/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/train_model.py
+++ b/examples/starter/KedroIrisPython/Pipelines/DataScience/Nodes/train_model.py
@@ -3,7 +3,7 @@
 import pickle
 import numpy as np
 import pandas as pd
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
@@ -13,7 +13,7 @@ def _sigmoid(z):
     return 1 / (1 + np.exp(-z))
 
 
-@node(inputs=["FeatureVectorSchema", "TargetLabelSchema"], outputs=["bytes"])
+@step(inputs=["FeatureVectorSchema", "TargetLabelSchema"], outputs=["bytes"])
 def train_model(train_x: pd.DataFrame, train_y: pd.DataFrame) -> bytes:
     """Node for training a simple multi-class logistic regression model.
     
diff --git a/examples/starter/KedroIrisPython/Program.cs b/examples/starter/KedroIrisPython/Program.cs
index 27906085..4e513624 100644
--- a/examples/starter/KedroIrisPython/Program.cs
+++ b/examples/starter/KedroIrisPython/Program.cs
@@ -39,24 +39,40 @@ public class Program
   public static Task<int> Main(string[] args) =>
     FlowthruCli.RunStandaloneAsync(
       args,
-      services => ConfigureServices(services, Directory.GetCurrentDirectory())
+      services =>
+        ConfigureServices(
+          services,
+          Directory.GetCurrentDirectory(),
+          AppDomain.CurrentDomain.BaseDirectory
+        )
     );
 
   /// <summary>
   /// Configures services for the application. Used by test infrastructure.
   /// </summary>
   /// <param name="basePath">Optional base path for data files (defaults to current directory)</param>
-  public static IServiceProvider ConfigureServices(string? basePath = null)
+  public static IServiceProvider ConfigureServices(
+    string? basePath = null,
+    string? outputPath = null
+  )
   {
     var services = new ServiceCollection();
-    ConfigureServices(services, basePath ?? Directory.GetCurrentDirectory());
+    ConfigureServices(
+      services,
+      basePath ?? Directory.GetCurrentDirectory(),
+      outputPath ?? AppDomain.CurrentDomain.BaseDirectory
+    );
     return services.BuildServiceProvider();
   }
 
   /// <summary>
   /// Shared service configuration logic.
   /// </summary>
-  private static void ConfigureServices(IServiceCollection services, string basePath)
+  private static void ConfigureServices(
+    IServiceCollection services,
+    string basePath,
+    string outputPath
+  )
   {
     // Add logging first (required by PythonRuntime)
     services.AddLogging(logging =>
@@ -68,7 +84,7 @@ private static void ConfigureServices(IServiceCollection services, string basePa
     services.AddFlowthru(flowthru =>
     {
       flowthru.UseConfiguration(opts => opts.ConfigurationPath = basePath);
-      flowthru.UseCatalog(_ => new Catalog(Path.Combine(basePath, "Data")));
+      flowthru.RegisterCatalog(_ => new Catalog(Path.Combine(basePath, "Data")));
 
       flowthru.ConfigureMetadata(meta =>
       {
@@ -84,14 +100,12 @@ private static void ConfigureServices(IServiceCollection services, string basePa
       // Configure Python runtime
       flowthru.UsePython(python =>
       {
-        // Add project root to sys.path (for importing from Pipelines/)
+        // Project root: makes Pipelines/ importable as a Python module tree
         python.ModuleSearchPaths.Add(basePath);
-
-        // Add output directory for flowthru Python package (contains @node decorator)
-        var outputDir = AppDomain.CurrentDomain.BaseDirectory;
-        python.ModuleSearchPaths.Add(outputDir);
-
-        // Note: PythonRuntime auto-discovers .venv in AppContext.BaseDirectory via uv sync
+        // Output directory: contains the flowthru package (@step decorator)
+        python.ModuleSearchPaths.Add(outputPath);
+        // Use this example's own output directory for venv isolation
+        python.VenvPath = outputPath;
       });
 
       // Phase 6 workaround: Resolve Python dependencies for pipeline registration
@@ -103,11 +117,11 @@ private static void ConfigureServices(IServiceCollection services, string basePa
 
       // Register pipelines with resolved executor
       flowthru
-        .RegisterPipeline(label: "DataEngineering", pipeline: DataEngineeringPipeline.Create)
+        .RegisterFlow(label: "DataEngineering", flow: DataEngineeringPipeline.Create)
         .WithDescription("Splits iris data into training and test sets using Python");
 
       flowthru
-        .RegisterPipeline(label: "DataScience", pipeline: DataSciencePipeline.Create)
+        .RegisterFlow(label: "DataScience", flow: DataSciencePipeline.Create)
         .WithDescription(
           "Trains multi-class logistic regression model and evaluates predictions using Python"
         );
diff --git a/examples/starter/KedroSpaceflights/.template.config/template.json b/examples/starter/KedroSpaceflights/.template.config/template.json
index eff73a10..003db0f2 100644
--- a/examples/starter/KedroSpaceflights/.template.config/template.json
+++ b/examples/starter/KedroSpaceflights/.template.config/template.json
@@ -21,7 +21,7 @@
     "FlowthruVersion": {
       "type": "parameter",
       "dataType": "string",
-      "defaultValue": "0.1.32",
+      "defaultValue": "0.1.33",
       "replaces": "FlowthruVersion",
       "description": "Flowthru package version (auto-injected at pack time)"
     }
diff --git a/examples/starter/KedroSpaceflights/Data/Catalog.cs b/examples/starter/KedroSpaceflights/Data/Catalog.cs
index 1356793a..9b00214f 100644
--- a/examples/starter/KedroSpaceflights/Data/Catalog.cs
+++ b/examples/starter/KedroSpaceflights/Data/Catalog.cs
@@ -5,7 +5,7 @@ namespace KedroSpaceflights.Data;
 /// <summary>
 /// Data catalog for the Spaceflights pipeline, providing access to datasets across all data layers.
 /// </summary>
-public partial class Catalog : DataCatalogBase
+public partial class Catalog : CatalogAbstract
 {
   private readonly string _basePath;
 
diff --git a/examples/starter/KedroSpaceflights/Data/_01_Raw/Catalog.Raw.cs b/examples/starter/KedroSpaceflights/Data/_01_Raw/Catalog.Raw.cs
index 94e016e7..fb468f7c 100644
--- a/examples/starter/KedroSpaceflights/Data/_01_Raw/Catalog.Raw.cs
+++ b/examples/starter/KedroSpaceflights/Data/_01_Raw/Catalog.Raw.cs
@@ -8,10 +8,10 @@ public partial class Catalog
   /// <summary>
   /// Raw company data imported from external sources.
   /// </summary>
-  public ICatalogEntry<IEnumerable<CompanySchema>> Companies =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<CompanySchema>> Companies =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<CompanySchema>(
+        ItemFactory.Enumerable.Csv<CompanySchema>(
           label: "Companies",
           filePath: $"{_basePath}/_01_Raw/Datasets/companies.csv"
         )
@@ -20,10 +20,10 @@ public partial class Catalog
   /// <summary>
   /// Raw review data imported from external sources.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ReviewSchema>> Reviews =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ReviewSchema>> Reviews =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<ReviewSchema>(
+        ItemFactory.Enumerable.Csv<ReviewSchema>(
           label: "Reviews",
           filePath: $"{_basePath}/_01_Raw/Datasets/reviews.csv"
         )
@@ -32,10 +32,10 @@ public partial class Catalog
   /// <summary>
   /// Raw shuttle data imported from external sources.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ShuttleSchema>> Shuttles =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ShuttleSchema>> Shuttles =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Excel<ShuttleSchema>(
+        ItemFactory.Enumerable.Excel<ShuttleSchema>(
           label: "Shuttles",
           filePath: $"{_basePath}/_01_Raw/Datasets/shuttles.xlsx",
           sheetName: "Sheet1"
diff --git a/examples/starter/KedroSpaceflights/Data/_02_Intermediate/Catalog.Intermediate.cs b/examples/starter/KedroSpaceflights/Data/_02_Intermediate/Catalog.Intermediate.cs
index 7064d9fb..93ba0711 100644
--- a/examples/starter/KedroSpaceflights/Data/_02_Intermediate/Catalog.Intermediate.cs
+++ b/examples/starter/KedroSpaceflights/Data/_02_Intermediate/Catalog.Intermediate.cs
@@ -8,10 +8,10 @@ public partial class Catalog
   /// <summary>
   /// Preprocessed company data with validated and strongly-typed fields.
   /// </summary>
-  public ICatalogEntry<IEnumerable<PreprocessedCompanySchema>> PreprocessedCompanies =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<PreprocessedCompanySchema>> PreprocessedCompanies =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<PreprocessedCompanySchema>(
+        ItemFactory.Enumerable.Parquet<PreprocessedCompanySchema>(
           label: "PreprocessedCompanies",
           filePath: $"{_basePath}/_02_Intermediate/Datasets/preprocessed_companies.parquet"
         )
@@ -20,10 +20,10 @@ public partial class Catalog
   /// <summary>
   /// Preprocessed shuttle data with validated and strongly-typed fields.
   /// </summary>
-  public ICatalogEntry<IEnumerable<PreprocessedShuttleSchema>> PreprocessedShuttles =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<PreprocessedShuttleSchema>> PreprocessedShuttles =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<PreprocessedShuttleSchema>(
+        ItemFactory.Enumerable.Parquet<PreprocessedShuttleSchema>(
           label: "PreprocessedShuttles",
           filePath: $"{_basePath}/_02_Intermediate/Datasets/preprocessed_shuttles.parquet"
         )
diff --git a/examples/starter/KedroSpaceflights/Data/_03_Primary/Catalog.Primary.cs b/examples/starter/KedroSpaceflights/Data/_03_Primary/Catalog.Primary.cs
index 122a44e1..172d2a44 100644
--- a/examples/starter/KedroSpaceflights/Data/_03_Primary/Catalog.Primary.cs
+++ b/examples/starter/KedroSpaceflights/Data/_03_Primary/Catalog.Primary.cs
@@ -12,10 +12,10 @@ public partial class Catalog
   /// <summary>
   /// Unified model input table combining shuttle, company, and review data.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ModelInputTableSchema>> ModelInputTable =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ModelInputTableSchema>> ModelInputTable =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<ModelInputTableSchema>(
+        ItemFactory.Enumerable.Parquet<ModelInputTableSchema>(
           label: "ModelInputTable",
           filePath: $"{_basePath}/_03_Primary/Datasets/model_input_table.parquet"
         )
diff --git a/examples/starter/KedroSpaceflights/Data/_04_Feature/Catalog.Feature.cs b/examples/starter/KedroSpaceflights/Data/_04_Feature/Catalog.Feature.cs
index bb95039b..40f27b9d 100644
--- a/examples/starter/KedroSpaceflights/Data/_04_Feature/Catalog.Feature.cs
+++ b/examples/starter/KedroSpaceflights/Data/_04_Feature/Catalog.Feature.cs
@@ -10,10 +10,10 @@ public partial class Catalog
 {
   // TODO: Add feature datasets here as they are created
   // Example:
-  // public ICatalogEntry<IEnumerable<FeatureSchema>> Features =>
-  //   GetOrCreateEntry(
+  // public IItem<IEnumerable<FeatureSchema>> Features =>
+  //   CreateEntry(
   //     () =>
-  //       CatalogEntries.Enumerable.Csv<FeatureSchema>(
+  //       ItemFactory.Enumerable.Csv<FeatureSchema>(
   //         label: "Features",
   //         filePath: $"{_basePath}/_04_Feature/Datasets/features.csv"
   //       )
diff --git a/examples/starter/KedroSpaceflights/Data/_05_ModelInput/Catalog.ModelInput.cs b/examples/starter/KedroSpaceflights/Data/_05_ModelInput/Catalog.ModelInput.cs
index 63891ea9..def5433a 100644
--- a/examples/starter/KedroSpaceflights/Data/_05_ModelInput/Catalog.ModelInput.cs
+++ b/examples/starter/KedroSpaceflights/Data/_05_ModelInput/Catalog.ModelInput.cs
@@ -12,12 +12,12 @@ public partial class Catalog
   /// <summary>
   /// Training dataset split from the model input table. Transient (memory only).
   /// </summary>
-  public ICatalogEntry<IEnumerable<TrainingData>> TrainSplit =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TrainingData>(label: "XTrain"));
+  public IItem<IEnumerable<TrainingData>> TrainSplit =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TrainingData>(label: "XTrain"));
 
   /// <summary>
   /// Test dataset split from the model input table. Transient (memory only).
   /// </summary>
-  public ICatalogEntry<IEnumerable<TestData>> TestSplit =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "XTest"));
+  public IItem<IEnumerable<TestData>> TestSplit =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "XTest"));
 }
diff --git a/examples/starter/KedroSpaceflights/Data/_06_Models/Catalog.Models.cs b/examples/starter/KedroSpaceflights/Data/_06_Models/Catalog.Models.cs
index 76109c39..a87a1402 100644
--- a/examples/starter/KedroSpaceflights/Data/_06_Models/Catalog.Models.cs
+++ b/examples/starter/KedroSpaceflights/Data/_06_Models/Catalog.Models.cs
@@ -12,10 +12,10 @@ public partial class Catalog
   /// <summary>
   /// Trained linear regression model with coefficients and feature names.
   /// </summary>
-  public ICatalogEntry<LinearRegressionModel> Regressor =>
-    GetOrCreateEntry(
+  public IItem<LinearRegressionModel> Regressor =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<LinearRegressionModel>(
+        ItemFactory.Single.Json<LinearRegressionModel>(
           label: "Regressor",
           filePath: $"{_basePath}/_06_Models/Datasets/regressor.json"
         )
diff --git a/examples/starter/KedroSpaceflights/Data/_07_ModelOutput/Catalog.ModelOutput.cs b/examples/starter/KedroSpaceflights/Data/_07_ModelOutput/Catalog.ModelOutput.cs
index 64116ff8..f9108334 100644
--- a/examples/starter/KedroSpaceflights/Data/_07_ModelOutput/Catalog.ModelOutput.cs
+++ b/examples/starter/KedroSpaceflights/Data/_07_ModelOutput/Catalog.ModelOutput.cs
@@ -12,10 +12,10 @@ public partial class Catalog
   /// <summary>
   /// Evaluation metrics for the trained regression model.
   /// </summary>
-  public ICatalogEntry<ModelMetrics> ModelMetrics =>
-    GetOrCreateEntry(
+  public IItem<ModelMetrics> ModelMetrics =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<ModelMetrics>(
+        ItemFactory.Single.Json<ModelMetrics>(
           label: "ModelMetrics",
           filePath: $"{_basePath}/_07_ModelOutput/Datasets/model_metrics.json"
         )
@@ -25,10 +25,10 @@ public partial class Catalog
   /// Model predictions containing actual and predicted values from the test set.
   /// Used for generating confusion matrices and prediction accuracy visualizations.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ModelPredictions>> ModelPredictions =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ModelPredictions>> ModelPredictions =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Json<ModelPredictions>(
+        ItemFactory.Enumerable.Json<ModelPredictions>(
           label: "ModelPredictions",
           filePath: $"{_basePath}/_07_ModelOutput/Datasets/model_predictions.json"
         )
diff --git a/examples/starter/KedroSpaceflights/Data/_08_Reporting/Catalog.Reporting.cs b/examples/starter/KedroSpaceflights/Data/_08_Reporting/Catalog.Reporting.cs
index c8d6bfa3..a28af713 100644
--- a/examples/starter/KedroSpaceflights/Data/_08_Reporting/Catalog.Reporting.cs
+++ b/examples/starter/KedroSpaceflights/Data/_08_Reporting/Catalog.Reporting.cs
@@ -13,10 +13,10 @@ public partial class Catalog
   /// <summary>
   /// Passenger capacity analysis report grouped by shuttle type.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ShuttleCapacityReport>> ShuttleCapacityReport =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ShuttleCapacityReport>> ShuttleCapacityReport =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Json<ShuttleCapacityReport>(
+        ItemFactory.Enumerable.Json<ShuttleCapacityReport>(
           label: "ShuttleCapacityReport",
           filePath: $"{_basePath}/_08_Reporting/Datasets/shuttle_capacity_report.json"
         )
@@ -26,9 +26,9 @@ public partial class Catalog
   /// Shuttle passenger capacity bar chart (in-memory GenericChart).
   /// Intermediate chart object stored in memory for downstream export to PNG.
   /// </summary>
-  public ICatalogEntry<GenericChart> ShuttlePassengerCapacityChart =>
-    GetOrCreateEntry(
-      () => CatalogEntries.Single.Memory<GenericChart>(label: "ShuttlePassengerCapacityChart")
+  public IItem<GenericChart> ShuttlePassengerCapacityChart =>
+    CreateItem(
+      () => ItemFactory.Single.Memory<GenericChart>(label: "ShuttlePassengerCapacityChart")
     );
 
   /// <summary>
@@ -36,10 +36,10 @@ public partial class Catalog
   /// Static image representation of the passenger capacity visualization.
   /// Stored as binary PNG file.
   /// </summary>
-  public ICatalogEntry<byte[]> ShuttlePassengerCapacityPlotPng =>
-    GetOrCreateEntry(
+  public IItem<byte[]> ShuttlePassengerCapacityPlotPng =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "ShuttlePassengerCapacityPlotPng",
           filePath: $"{_basePath}/_08_Reporting/Images/shuttle_passenger_capacity_plot.png"
         )
@@ -49,20 +49,18 @@ public partial class Catalog
   /// Confusion matrix heatmap (in-memory GenericChart).
   /// Intermediate chart object stored in memory for downstream export to PNG.
   /// </summary>
-  public ICatalogEntry<GenericChart> ConfusionMatrixChart =>
-    GetOrCreateEntry(
-      () => CatalogEntries.Single.Memory<GenericChart>(label: "ConfusionMatrixChart")
-    );
+  public IItem<GenericChart> ConfusionMatrixChart =>
+    CreateItem(() => ItemFactory.Single.Memory<GenericChart>(label: "ConfusionMatrixChart"));
 
   /// <summary>
   /// Confusion matrix heatmap (PNG image).
   /// Static image representation of the confusion matrix visualization.
   /// Stored as binary PNG file.
   /// </summary>
-  public ICatalogEntry<byte[]> ConfusionMatrixPlotPng =>
-    GetOrCreateEntry(
+  public IItem<byte[]> ConfusionMatrixPlotPng =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "ConfusionMatrixPlotPng",
           filePath: $"{_basePath}/_08_Reporting/Images/confusion_matrix_plot.png"
         )
diff --git a/examples/starter/KedroSpaceflights/Pipelines/DataProcessing/DataProcessingPipeline.cs b/examples/starter/KedroSpaceflights/Pipelines/DataProcessing/DataProcessingPipeline.cs
index 08ebe9cc..c0672578 100644
--- a/examples/starter/KedroSpaceflights/Pipelines/DataProcessing/DataProcessingPipeline.cs
+++ b/examples/starter/KedroSpaceflights/Pipelines/DataProcessing/DataProcessingPipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using KedroSpaceflights.Data;
 using KedroSpaceflights.Pipelines.DataProcessing.Nodes;
 
@@ -15,11 +15,11 @@ public static class DataProcessingPipeline
   /// </summary>
   /// <param name="catalog">The data catalog containing input and output entries.</param>
   /// <returns>A configured pipeline that produces a model input table from raw data sources.</returns>
-  public static Pipeline Create(Catalog catalog)
+  public static Flow Create(Catalog catalog)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "PreprocessCompanies",
         description: "Cleans and preprocesses raw company data.",
         transform: PreprocessCompaniesNode.Create(),
@@ -27,7 +27,7 @@ public static Pipeline Create(Catalog catalog)
         output: catalog.PreprocessedCompanies
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "PreprocessShuttles",
         description: "Cleans and preprocesses raw shuttle data.",
         transform: PreprocessShuttlesNode.Create(),
@@ -35,7 +35,7 @@ public static Pipeline Create(Catalog catalog)
         output: catalog.PreprocessedShuttles
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "CreateModelInputTable",
         description: """
           Joins preprocessed shuttle and company data with review scores to create a
diff --git a/examples/starter/KedroSpaceflights/Pipelines/DataScience/DataSciencePipeline.cs b/examples/starter/KedroSpaceflights/Pipelines/DataScience/DataSciencePipeline.cs
index 464efd36..6561fe94 100644
--- a/examples/starter/KedroSpaceflights/Pipelines/DataScience/DataSciencePipeline.cs
+++ b/examples/starter/KedroSpaceflights/Pipelines/DataScience/DataSciencePipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using KedroSpaceflights.Data;
 
 namespace KedroSpaceflights.Pipelines.DataScience;
@@ -25,11 +25,11 @@ public record Params
   /// <param name="catalog">The data catalog containing input and output entries.</param>
   /// <param name="parameters">Configuration parameters for the pipeline.</param>
   /// <returns>A configured pipeline that produces a trained model and evaluation metrics.</returns>
-  public static Pipeline Create(Catalog catalog, Params parameters)
+  public static Flow Create(Catalog catalog, Params parameters)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "SplitData",
         description: "Splits model input data into training and test sets.",
         transform: Nodes.SplitDataNode.Create(parameters.ModelOptions),
@@ -37,7 +37,7 @@ public static Pipeline Create(Catalog catalog, Params parameters)
         output: (catalog.TrainSplit, catalog.TestSplit)
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "TrainModel",
         description: "Trains a regression model to predict shuttle prices.",
         transform: Nodes.TrainModelNode.Create(),
@@ -45,7 +45,7 @@ public static Pipeline Create(Catalog catalog, Params parameters)
         output: catalog.Regressor
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "EvaluateModel",
         description: "Evaluates the trained model on the test set and computes metrics and predictions.",
         transform: Nodes.EvaluateModelNode.Create(),
diff --git a/examples/starter/KedroSpaceflights/Pipelines/Reporting/Nodes/PlotlyImageExportNode.cs b/examples/starter/KedroSpaceflights/Pipelines/Reporting/Nodes/PlotlyImageExportNode.cs
index 2323e12c..dff5efcd 100644
--- a/examples/starter/KedroSpaceflights/Pipelines/Reporting/Nodes/PlotlyImageExportNode.cs
+++ b/examples/starter/KedroSpaceflights/Pipelines/Reporting/Nodes/PlotlyImageExportNode.cs
@@ -11,13 +11,13 @@ namespace KedroSpaceflights.Pipelines.Reporting.Nodes;
 /// <para>
 /// This node handles the PNG export concern separately from chart generation,
 /// enabling a clean separation of visualization logic from output format concerns.
-/// The PNG binary data can be stored in a BinaryFileCatalogEntry&lt;byte[]&gt;.
+/// The PNG binary data can be stored in a BinaryFileItem&lt;byte[]&gt;.
 /// </para>
 /// <para>
 /// <strong>Input:</strong> GenericChart object from memory catalog
 /// </para>
 /// <para>
-/// <strong>Output:</strong> PNG binary data as byte[] (can be stored in BinaryFileCatalogEntry&lt;byte[]&gt;)
+/// <strong>Output:</strong> PNG binary data as byte[] (can be stored in BinaryFileItem&lt;byte[]&gt;)
 /// </para>
 /// <para>
 /// <strong>Reusability:</strong> This node can be used for any Plotly chart type
diff --git a/examples/starter/KedroSpaceflights/Pipelines/Reporting/ReportingPipeline.cs b/examples/starter/KedroSpaceflights/Pipelines/Reporting/ReportingPipeline.cs
index 929067fc..b879278f 100644
--- a/examples/starter/KedroSpaceflights/Pipelines/Reporting/ReportingPipeline.cs
+++ b/examples/starter/KedroSpaceflights/Pipelines/Reporting/ReportingPipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using KedroSpaceflights.Data;
 using KedroSpaceflights.Pipelines.Reporting.Nodes;
 
@@ -41,15 +41,15 @@ public record Params
   /// <param name="catalog">The data catalog containing input and output entries.</param>
   /// <param name="parameters">Configuration parameters for the pipeline (optional).</param>
   /// <returns>A configured pipeline that produces visualizations and reports.</returns>
-  public static Pipeline Create(Catalog catalog, Params? parameters = null)
+  public static Flow Create(Catalog catalog, Params? parameters = null)
   {
     var p = parameters ?? new Params();
 
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
       // ===== Shuttle Passenger Capacity Report (JSON) =====
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ComparePassengerCapacity",
         transform: ComparePassengerCapacityNode.Create(),
         input: catalog.PreprocessedShuttles,
@@ -59,7 +59,7 @@ public static Pipeline Create(Catalog catalog, Params? parameters = null)
       // ===== Shuttle Passenger Capacity Visualization =====
 
       // Step 1: Generate chart from preprocessed shuttle data
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "GeneratePassengerCapacityChart",
         transform: GeneratePassengerCapacityChartNode.Create(),
         input: catalog.PreprocessedShuttles,
@@ -68,7 +68,7 @@ public static Pipeline Create(Catalog catalog, Params? parameters = null)
 
       // NOTE: Commented out due to performance issues with Plotly.NET
       // // Step 2: Export chart to PNG for static reports
-      // pipeline.AddNode(
+      // pipeline.AddStep(
       //   label: "ExportPassengerCapacityPng",
       //   transform: PlotlyImageExportNode.Create(),
       //   input: catalog.ShuttlePassengerCapacityChart,
@@ -78,7 +78,7 @@ public static Pipeline Create(Catalog catalog, Params? parameters = null)
       // ===== Confusion Matrix Visualization =====
 
       // Step 1: Generate confusion matrix heatmap from model predictions
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "GenerateConfusionMatrixChart",
         transform: CreateConfusionMatrixNode.Create(p.ConfusionMatrixOptions),
         input: catalog.ModelPredictions,
@@ -87,7 +87,7 @@ public static Pipeline Create(Catalog catalog, Params? parameters = null)
 
       // NOTE: Commented out due to performance issues with Plotly.NET
       // // Step 2: Export chart to PNG for static reports
-      // pipeline.AddNode(
+      // pipeline.AddStep(
       //   label: "ExportConfusionMatrixPng",
       //   transform: PlotlyImageExportNode.Create(),
       //   input: catalog.ConfusionMatrixChart,
diff --git a/examples/starter/KedroSpaceflights/Program.cs b/examples/starter/KedroSpaceflights/Program.cs
index 9b9d7dba..aebd607f 100644
--- a/examples/starter/KedroSpaceflights/Program.cs
+++ b/examples/starter/KedroSpaceflights/Program.cs
@@ -45,7 +45,7 @@ private static void ConfigureServices(IServiceCollection services, string basePa
     services.AddFlowthru(flowthru =>
     {
       flowthru.UseConfiguration(opts => opts.ConfigurationPath = basePath);
-      flowthru.UseCatalog(_ => new Catalog(Path.Combine(basePath, "Data")));
+      flowthru.RegisterCatalog(_ => new Catalog(Path.Combine(basePath, "Data")));
 
       // Output pipeline metadata
       flowthru.ConfigureMetadata(meta =>
@@ -61,23 +61,23 @@ private static void ConfigureServices(IServiceCollection services, string basePa
 
       // Register data processing pipeline
       flowthru
-        .RegisterPipeline(label: "DataProcessing", pipeline: DataProcessingPipeline.Create)
+        .RegisterFlow(label: "DataProcessing", flow: DataProcessingPipeline.Create)
         .WithDescription("Preprocesses companies and shuttles data");
 
       // Register data science pipeline with configuration parameters
       flowthru
-        .RegisterPipeline(
+        .RegisterFlow(
           label: "DataScience",
-          pipeline: DataSciencePipeline.Create,
+          flow: DataSciencePipeline.Create,
           configurationSection: "Flowthru:Pipelines:DataScience"
         )
         .WithDescription("Trains linear regression model for price prediction");
 
       // Register reporting pipeline with configuration parameters
       flowthru
-        .RegisterPipeline(
+        .RegisterFlow(
           label: "Reporting",
-          pipeline: ReportingPipeline.Create,
+          flow: ReportingPipeline.Create,
           configurationSection: "Flowthru:Pipelines:Reporting"
         )
         .WithDescription("Generates passenger capacity reports and visualizations");
diff --git a/examples/starter/KedroSpaceflightsPython/.template.config/template.json b/examples/starter/KedroSpaceflightsPython/.template.config/template.json
index ee904dff..8433f435 100644
--- a/examples/starter/KedroSpaceflightsPython/.template.config/template.json
+++ b/examples/starter/KedroSpaceflightsPython/.template.config/template.json
@@ -22,7 +22,7 @@
     "FlowthruVersion": {
       "type": "parameter",
       "dataType": "string",
-      "defaultValue": "0.1.32",
+      "defaultValue": "0.1.33",
       "replaces": "FlowthruVersion",
       "description": "Flowthru package version (auto-injected at pack time)"
     }
diff --git a/examples/starter/KedroSpaceflightsPython/Data/Catalog.cs b/examples/starter/KedroSpaceflightsPython/Data/Catalog.cs
index 4ddc0bd5..239ff39d 100644
--- a/examples/starter/KedroSpaceflightsPython/Data/Catalog.cs
+++ b/examples/starter/KedroSpaceflightsPython/Data/Catalog.cs
@@ -5,7 +5,7 @@ namespace KedroSpaceflightsPython.Data;
 /// <summary>
 /// Data catalog for the Spaceflights pipeline, providing access to datasets across all data layers.
 /// </summary>
-public partial class Catalog : DataCatalogBase
+public partial class Catalog : CatalogAbstract
 {
   private readonly string _basePath;
 
diff --git a/examples/starter/KedroSpaceflightsPython/Data/_01_Raw/Catalog.Raw.cs b/examples/starter/KedroSpaceflightsPython/Data/_01_Raw/Catalog.Raw.cs
index 602dbf70..4642239b 100644
--- a/examples/starter/KedroSpaceflightsPython/Data/_01_Raw/Catalog.Raw.cs
+++ b/examples/starter/KedroSpaceflightsPython/Data/_01_Raw/Catalog.Raw.cs
@@ -8,10 +8,10 @@ public partial class Catalog
   /// <summary>
   /// Raw company data imported from external sources.
   /// </summary>
-  public ICatalogEntry<IEnumerable<CompanySchema>> Companies =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<CompanySchema>> Companies =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<CompanySchema>(
+        ItemFactory.Enumerable.Csv<CompanySchema>(
           label: "Companies",
           filePath: $"{_basePath}/_01_Raw/Datasets/companies.csv"
         )
@@ -20,10 +20,10 @@ public partial class Catalog
   /// <summary>
   /// Raw review data imported from external sources.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ReviewSchema>> Reviews =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ReviewSchema>> Reviews =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<ReviewSchema>(
+        ItemFactory.Enumerable.Csv<ReviewSchema>(
           label: "Reviews",
           filePath: $"{_basePath}/_01_Raw/Datasets/reviews.csv"
         )
@@ -32,10 +32,10 @@ public partial class Catalog
   /// <summary>
   /// Raw shuttle data imported from external sources.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ShuttleSchema>> Shuttles =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ShuttleSchema>> Shuttles =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Excel<ShuttleSchema>(
+        ItemFactory.Enumerable.Excel<ShuttleSchema>(
           label: "Shuttles",
           filePath: $"{_basePath}/_01_Raw/Datasets/shuttles.xlsx",
           sheetName: "Sheet1"
diff --git a/examples/starter/KedroSpaceflightsPython/Data/_02_Intermediate/Catalog.Intermediate.cs b/examples/starter/KedroSpaceflightsPython/Data/_02_Intermediate/Catalog.Intermediate.cs
index 5ee3e8c8..9e2d4d8c 100644
--- a/examples/starter/KedroSpaceflightsPython/Data/_02_Intermediate/Catalog.Intermediate.cs
+++ b/examples/starter/KedroSpaceflightsPython/Data/_02_Intermediate/Catalog.Intermediate.cs
@@ -8,10 +8,10 @@ public partial class Catalog
   /// <summary>
   /// Preprocessed company data with validated and strongly-typed fields.
   /// </summary>
-  public ICatalogEntry<IEnumerable<PreprocessedCompanySchema>> PreprocessedCompanies =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<PreprocessedCompanySchema>> PreprocessedCompanies =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<PreprocessedCompanySchema>(
+        ItemFactory.Enumerable.Parquet<PreprocessedCompanySchema>(
           label: "PreprocessedCompanies",
           filePath: $"{_basePath}/_02_Intermediate/Datasets/preprocessed_companies.parquet"
         )
@@ -20,10 +20,10 @@ public partial class Catalog
   /// <summary>
   /// Preprocessed shuttle data with validated and strongly-typed fields.
   /// </summary>
-  public ICatalogEntry<IEnumerable<PreprocessedShuttleSchema>> PreprocessedShuttles =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<PreprocessedShuttleSchema>> PreprocessedShuttles =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<PreprocessedShuttleSchema>(
+        ItemFactory.Enumerable.Parquet<PreprocessedShuttleSchema>(
           label: "PreprocessedShuttles",
           filePath: $"{_basePath}/_02_Intermediate/Datasets/preprocessed_shuttles.parquet"
         )
diff --git a/examples/starter/KedroSpaceflightsPython/Data/_03_Primary/Catalog.Primary.cs b/examples/starter/KedroSpaceflightsPython/Data/_03_Primary/Catalog.Primary.cs
index 28fa5400..d2416d70 100644
--- a/examples/starter/KedroSpaceflightsPython/Data/_03_Primary/Catalog.Primary.cs
+++ b/examples/starter/KedroSpaceflightsPython/Data/_03_Primary/Catalog.Primary.cs
@@ -12,10 +12,10 @@ public partial class Catalog
   /// <summary>
   /// Unified model input table combining shuttle, company, and review data.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ModelInputTableSchema>> ModelInputTable =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ModelInputTableSchema>> ModelInputTable =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Parquet<ModelInputTableSchema>(
+        ItemFactory.Enumerable.Parquet<ModelInputTableSchema>(
           label: "ModelInputTable",
           filePath: $"{_basePath}/_03_Primary/Datasets/model_input_table.parquet"
         )
diff --git a/examples/starter/KedroSpaceflightsPython/Data/_04_Feature/Catalog.Feature.cs b/examples/starter/KedroSpaceflightsPython/Data/_04_Feature/Catalog.Feature.cs
index f391ef91..24726250 100644
--- a/examples/starter/KedroSpaceflightsPython/Data/_04_Feature/Catalog.Feature.cs
+++ b/examples/starter/KedroSpaceflightsPython/Data/_04_Feature/Catalog.Feature.cs
@@ -10,10 +10,10 @@ public partial class Catalog
 {
   // TODO: Add feature datasets here as they are created
   // Example:
-  // public ICatalogEntry<IEnumerable<FeatureSchema>> Features =>
-  //   GetOrCreateEntry(
+  // public IItem<IEnumerable<FeatureSchema>> Features =>
+  //   CreateEntry(
   //     () =>
-  //       CatalogEntries.Enumerable.Csv<FeatureSchema>(
+  //       ItemFactory.Enumerable.Csv<FeatureSchema>(
   //         label: "Features",
   //         filePath: $"{_basePath}/_04_Feature/Datasets/features.csv"
   //       )
diff --git a/examples/starter/KedroSpaceflightsPython/Data/_05_ModelInput/Catalog.ModelInput.cs b/examples/starter/KedroSpaceflightsPython/Data/_05_ModelInput/Catalog.ModelInput.cs
index 0811e442..a182c860 100644
--- a/examples/starter/KedroSpaceflightsPython/Data/_05_ModelInput/Catalog.ModelInput.cs
+++ b/examples/starter/KedroSpaceflightsPython/Data/_05_ModelInput/Catalog.ModelInput.cs
@@ -12,24 +12,24 @@ public partial class Catalog
   /// <summary>
   /// Training features split from the model input table. Transient (memory only).
   /// </summary>
-  public ICatalogEntry<IEnumerable<XValues>> XTest =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<XValues>(label: "XTest"));
+  public IItem<IEnumerable<XValues>> XTest =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<XValues>(label: "XTest"));
 
   /// <summary>
   /// Test features split from the model input table. Transient (memory only).
   /// </summary>
-  public ICatalogEntry<IEnumerable<XValues>> XTrain =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<XValues>(label: "XTrain"));
+  public IItem<IEnumerable<XValues>> XTrain =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<XValues>(label: "XTrain"));
 
   /// <summary>
   /// Test targets split from the model input table. Transient (memory only).
   /// </summary>
-  public ICatalogEntry<IEnumerable<YValues>> YTest =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<YValues>(label: "YTest"));
+  public IItem<IEnumerable<YValues>> YTest =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<YValues>(label: "YTest"));
 
   /// <summary>
   /// Training targets split from the model input table. Transient (memory only).
   /// </summary>
-  public ICatalogEntry<IEnumerable<YValues>> YTrain =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<YValues>(label: "YTrain"));
+  public IItem<IEnumerable<YValues>> YTrain =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<YValues>(label: "YTrain"));
 }
diff --git a/examples/starter/KedroSpaceflightsPython/Data/_06_Models/Catalog.Models.cs b/examples/starter/KedroSpaceflightsPython/Data/_06_Models/Catalog.Models.cs
index 0589b54e..90f4a178 100644
--- a/examples/starter/KedroSpaceflightsPython/Data/_06_Models/Catalog.Models.cs
+++ b/examples/starter/KedroSpaceflightsPython/Data/_06_Models/Catalog.Models.cs
@@ -12,10 +12,10 @@ public partial class Catalog
   /// <summary>
   /// Trained linear regression model with coefficients and feature names.
   /// </summary>
-  public ICatalogEntry<LinearRegressionModel> Regressor =>
-    GetOrCreateEntry(
+  public IItem<LinearRegressionModel> Regressor =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<LinearRegressionModel>(
+        ItemFactory.Single.Json<LinearRegressionModel>(
           label: "Regressor",
           filePath: $"{_basePath}/_06_Models/Datasets/regressor.json"
         )
diff --git a/examples/starter/KedroSpaceflightsPython/Data/_07_ModelOutput/Catalog.ModelOutput.cs b/examples/starter/KedroSpaceflightsPython/Data/_07_ModelOutput/Catalog.ModelOutput.cs
index a2b7d4a3..3cf48e11 100644
--- a/examples/starter/KedroSpaceflightsPython/Data/_07_ModelOutput/Catalog.ModelOutput.cs
+++ b/examples/starter/KedroSpaceflightsPython/Data/_07_ModelOutput/Catalog.ModelOutput.cs
@@ -12,10 +12,10 @@ public partial class Catalog
   /// <summary>
   /// Evaluation metrics for the trained regression model.
   /// </summary>
-  public ICatalogEntry<ModelMetrics> ModelMetrics =>
-    GetOrCreateEntry(
+  public IItem<ModelMetrics> ModelMetrics =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Json<ModelMetrics>(
+        ItemFactory.Single.Json<ModelMetrics>(
           label: "ModelMetrics",
           filePath: $"{_basePath}/_07_ModelOutput/Datasets/model_metrics.json"
         )
@@ -25,10 +25,10 @@ public partial class Catalog
   /// Model predictions containing actual and predicted values from the test set.
   /// Used for generating confusion matrices and prediction accuracy visualizations.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ModelPredictions>> ModelPredictions =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ModelPredictions>> ModelPredictions =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Json<ModelPredictions>(
+        ItemFactory.Enumerable.Json<ModelPredictions>(
           label: "ModelPredictions",
           filePath: $"{_basePath}/_07_ModelOutput/Datasets/model_predictions.json"
         )
diff --git a/examples/starter/KedroSpaceflightsPython/Data/_08_Reporting/Catalog.Reporting.cs b/examples/starter/KedroSpaceflightsPython/Data/_08_Reporting/Catalog.Reporting.cs
index a9c34ae2..b9618010 100644
--- a/examples/starter/KedroSpaceflightsPython/Data/_08_Reporting/Catalog.Reporting.cs
+++ b/examples/starter/KedroSpaceflightsPython/Data/_08_Reporting/Catalog.Reporting.cs
@@ -12,10 +12,10 @@ public partial class Catalog
   /// Passenger capacity comparison visualization (plotly.express format).
   /// Stores JSON representation of plotly figure for shuttle capacity by type.
   /// </summary>
-  public ICatalogEntry<string> CapacityPlotExpress =>
-    GetOrCreateEntry(
+  public IItem<string> CapacityPlotExpress =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Text(
+        ItemFactory.Single.Text(
           label: "CapacityPlotExpress",
           filePath: $"{_basePath}/_08_Reporting/Datasets/shuttle_passenger_capacity_plot_exp.json"
         )
@@ -25,10 +25,10 @@ public partial class Catalog
   /// Passenger capacity comparison visualization (plotly.graph_objects format).
   /// Stores JSON representation of plotly figure for shuttle capacity by type.
   /// </summary>
-  public ICatalogEntry<string> CapacityPlotGraphObj =>
-    GetOrCreateEntry(
+  public IItem<string> CapacityPlotGraphObj =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Text(
+        ItemFactory.Single.Text(
           label: "CapacityPlotGraphObj",
           filePath: $"{_basePath}/_08_Reporting/Datasets/shuttle_passenger_capacity_plot_go.json"
         )
@@ -39,10 +39,10 @@ public partial class Catalog
   /// Shows actual vs predicted price categories (Low/Medium/High) as a heatmap.
   /// Stores PNG image as binary data.
   /// </summary>
-  public ICatalogEntry<byte[]> ConfusionMatrix =>
-    GetOrCreateEntry(
+  public IItem<byte[]> ConfusionMatrix =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "ConfusionMatrix",
           filePath: $"{_basePath}/_08_Reporting/Images/confusion_matrix.png"
         )
diff --git a/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/DataProcessingPipeline.cs b/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/DataProcessingPipeline.cs
index ed8e623d..ea599397 100644
--- a/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/DataProcessingPipeline.cs
+++ b/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/DataProcessingPipeline.cs
@@ -1,6 +1,6 @@
 using Flowthru.Extensions.Python.Execution;
-using Flowthru.Extensions.Python.Nodes;
-using Flowthru.Pipelines;
+using Flowthru.Extensions.Python.Steps;
+using Flowthru.Flows;
 using KedroSpaceflightsPython.Data;
 using KedroSpaceflightsPython.Data._01_Raw.Schemas;
 using KedroSpaceflightsPython.Data._02_Intermediate.Schemas;
@@ -16,11 +16,11 @@ public static class DataProcessingPipeline
   /// <summary>
   /// Creates the data processing pipeline.
   /// </summary>
-  public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
+  public static Flow Create(Catalog catalog, IPythonExecutor executor)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddPythonNode(
+      pipeline.AddPythonStep(
         label: "PreprocessCompanies",
         description: "Clean and parse company data (Python)",
         module: "Pipelines.DataProcessing.Nodes.preprocess_companies",
@@ -30,7 +30,7 @@ public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
         executor: executor
       );
 
-      pipeline.AddPythonNode(
+      pipeline.AddPythonStep(
         label: "PreprocessShuttles",
         description: "Clean and parse shuttle data (Python)",
         module: "Pipelines.DataProcessing.Nodes.preprocess_shuttles",
@@ -40,7 +40,7 @@ public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
         executor: executor
       );
 
-      pipeline.AddPythonNode<
+      pipeline.AddPythonStep<
         IEnumerable<PreprocessedShuttleSchema>,
         IEnumerable<PreprocessedCompanySchema>,
         IEnumerable<ReviewSchema>,
diff --git a/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/Nodes/create_model_input_table.py b/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/Nodes/create_model_input_table.py
index f3cbec32..7d9e1fa0 100644
--- a/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/Nodes/create_model_input_table.py
+++ b/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/Nodes/create_model_input_table.py
@@ -1,12 +1,12 @@
-"""Data joining node to create model input table."""
+"""Data joining step to create model input table."""
 import logging
 import pandas as pd
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
 
-@node(
+@step(
     inputs=["ShuttlePreprocessedSchema", "CompanyPreprocessedSchema", "ReviewSchema"],
     outputs=["ModelInputTableSchema"],
 )
diff --git a/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/Nodes/preprocess_companies.py b/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/Nodes/preprocess_companies.py
index 22e07994..ddf84c78 100644
--- a/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/Nodes/preprocess_companies.py
+++ b/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/Nodes/preprocess_companies.py
@@ -1,8 +1,8 @@
-"""Data preprocessing nodes for companies data."""
+"""Data preprocessing steps for companies data."""
 import logging
 import numpy as np
 import pandas as pd
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
@@ -21,7 +21,7 @@ def _parse_percentage(x: pd.Series) -> pd.Series:
     return x
 
 
-@node(inputs=["CompanyRawSchema"], outputs=["CompanyPreprocessedSchema"])
+@step(inputs=["CompanyRawSchema"], outputs=["CompanyPreprocessedSchema"])
 def preprocess_companies(companies: pd.DataFrame) -> pd.DataFrame:
     """Preprocesses the data for companies.
 
diff --git a/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/Nodes/preprocess_shuttles.py b/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/Nodes/preprocess_shuttles.py
index 0dd24610..47c6c1cf 100644
--- a/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/Nodes/preprocess_shuttles.py
+++ b/examples/starter/KedroSpaceflightsPython/Pipelines/DataProcessing/Nodes/preprocess_shuttles.py
@@ -1,8 +1,8 @@
-"""Data preprocessing nodes for shuttle data."""
+"""Data preprocessing steps for shuttle data."""
 import logging
 import numpy as np
 import pandas as pd
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
@@ -19,7 +19,7 @@ def _parse_money(x: pd.Series) -> pd.Series:
     return x
 
 
-@node(inputs=["ShuttleRawSchema"], outputs=["ShuttlePreprocessedSchema"])
+@step(inputs=["ShuttleRawSchema"], outputs=["ShuttlePreprocessedSchema"])
 def preprocess_shuttles(shuttles: pd.DataFrame) -> pd.DataFrame:
     """Preprocesses the data for shuttles.
 
diff --git a/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/DataSciencePipeline.cs b/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/DataSciencePipeline.cs
index bfae8716..b9e70a2e 100644
--- a/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/DataSciencePipeline.cs
+++ b/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/DataSciencePipeline.cs
@@ -1,6 +1,6 @@
 using Flowthru.Extensions.Python.Execution;
-using Flowthru.Extensions.Python.Nodes;
-using Flowthru.Pipelines;
+using Flowthru.Extensions.Python.Steps;
+using Flowthru.Flows;
 using KedroSpaceflightsPython.Data;
 using KedroSpaceflightsPython.Data._03_Primary.Schemas;
 using KedroSpaceflightsPython.Data._05_ModelInput.Schemas;
@@ -17,12 +17,12 @@ public static class DataSciencePipeline
   /// <summary>
   /// Creates the data science pipeline.
   /// </summary>
-  public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
+  public static Flow Create(Catalog catalog, IPythonExecutor executor)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
       // Split data into train/test sets (1×4 output node)
-      pipeline.AddPythonNode<
+      pipeline.AddPythonStep<
         IEnumerable<ModelInputTableSchema>,
         IEnumerable<XValues>,
         IEnumerable<XValues>,
@@ -39,7 +39,7 @@ public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
       );
 
       // Train model (2×1 input node, returns sklearn model object)
-      pipeline.AddPythonNode(
+      pipeline.AddPythonStep(
         label: "TrainModel",
         description: "Train linear regression model (Python 2×1 node)",
         module: "Pipelines.DataScience.Nodes.train_model",
@@ -50,7 +50,7 @@ public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
       );
 
       // Evaluate model (3×1 input node with sklearn model object)
-      pipeline.AddPythonNode<
+      pipeline.AddPythonStep<
         LinearRegressionModel,
         IEnumerable<XValues>,
         IEnumerable<YValues>,
@@ -66,7 +66,7 @@ public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
       );
 
       // Generate predictions for visualization (3×1 input node)
-      pipeline.AddPythonNode<
+      pipeline.AddPythonStep<
         LinearRegressionModel,
         IEnumerable<XValues>,
         IEnumerable<YValues>,
diff --git a/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/evaluate_model.py b/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/evaluate_model.py
index 5d028495..6b077318 100644
--- a/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/evaluate_model.py
+++ b/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/evaluate_model.py
@@ -1,14 +1,14 @@
-"""Model evaluation node."""
+"""Model evaluation step."""
 import logging
 import numpy as np
 import pandas as pd
 from sklearn.metrics import max_error, mean_absolute_error, r2_score
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
 
-@node(inputs=["LinearRegressionModel", "XValues", "YValues"], outputs="ModelMetrics")
+@step(inputs=["LinearRegressionModel", "XValues", "YValues"], outputs="ModelMetrics")
 def evaluate_model(regressor_params: dict, X_test: pd.DataFrame, y_test: pd.DataFrame) -> dict:
     """Calculates and logs the coefficient of determination.
 
diff --git a/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/generate_predictions.py b/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/generate_predictions.py
index b546f316..65a13a08 100644
--- a/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/generate_predictions.py
+++ b/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/generate_predictions.py
@@ -1,13 +1,13 @@
-"""Model prediction generation node."""
+"""Model prediction generation step."""
 import logging
 import numpy as np
 import pandas as pd
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
 
-@node(inputs=["LinearRegressionModel", "XValues", "YValues"], outputs="ModelPredictions")
+@step(inputs=["LinearRegressionModel", "XValues", "YValues"], outputs="ModelPredictions")
 def generate_predictions(regressor_params: dict, X_test: pd.DataFrame, y_test: pd.DataFrame) -> pd.DataFrame:
     """Generate predictions from the trained model for visualization.
     
diff --git a/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/split_data.py b/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/split_data.py
index b19e8beb..14fcd976 100644
--- a/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/split_data.py
+++ b/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/split_data.py
@@ -1,8 +1,8 @@
-"""Data splitting node for train/test split."""
+"""Data splitting step for train/test split."""
 import logging
 import pandas as pd
 from sklearn.model_selection import train_test_split
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
@@ -21,7 +21,7 @@
 ]
 
 
-@node(
+@step(
     inputs=["ModelInputTableSchema"],
     outputs=["XValues", "XValues", "YValues", "YValues"],
 )
diff --git a/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/train_model.py b/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/train_model.py
index d54564d3..0053a160 100644
--- a/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/train_model.py
+++ b/examples/starter/KedroSpaceflightsPython/Pipelines/DataScience/Nodes/train_model.py
@@ -1,13 +1,13 @@
-"""Model training node using scikit-learn."""
+"""Model training step using scikit-learn."""
 import logging
 import pandas as pd
 from sklearn.linear_model import LinearRegression
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
 
-@node(inputs=["XValues", "YValues"], outputs="LinearRegressionModel")
+@step(inputs=["XValues", "YValues"], outputs="LinearRegressionModel")
 def train_model(X_train: pd.DataFrame, y_train: pd.DataFrame) -> dict:
     """Trains the linear regression model.
 
diff --git a/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/Nodes/__init__.py b/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/Nodes/__init__.py
index 2e932c2f..40fc227d 100644
--- a/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/Nodes/__init__.py
+++ b/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/Nodes/__init__.py
@@ -1 +1 @@
-"""Reporting pipeline nodes."""
+"""Reporting pipeline steps."""
diff --git a/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/Nodes/compare_passenger_capacity.py b/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/Nodes/compare_passenger_capacity.py
index 6006f909..2506a851 100644
--- a/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/Nodes/compare_passenger_capacity.py
+++ b/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/Nodes/compare_passenger_capacity.py
@@ -1,15 +1,15 @@
-"""Passenger capacity comparison visualization nodes."""
+"""Passenger capacity comparison visualization steps."""
 import logging
 import pandas as pd
 import plotly.express as px
 import plotly.graph_objs as go
 import plotly.io as pio
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
 
-@node(inputs=["PreprocessedShuttleSchema"], outputs="CapacityPlotExpress")
+@step(inputs=["PreprocessedShuttleSchema"], outputs="CapacityPlotExpress")
 def compare_passenger_capacity_exp(preprocessed_shuttles: pd.DataFrame) -> str:
     """Create passenger capacity comparison using plotly.express.
     
@@ -48,7 +48,7 @@ def compare_passenger_capacity_exp(preprocessed_shuttles: pd.DataFrame) -> str:
     return pio.to_json(fig, pretty=True)
 
 
-@node(inputs=["PreprocessedShuttleSchema"], outputs="CapacityPlotGraphObj")
+@step(inputs=["PreprocessedShuttleSchema"], outputs="CapacityPlotGraphObj")
 def compare_passenger_capacity_go(preprocessed_shuttles: pd.DataFrame) -> str:
     """Create passenger capacity comparison using plotly.graph_objects.
     
diff --git a/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/Nodes/create_confusion_matrix.py b/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/Nodes/create_confusion_matrix.py
index 210fbabb..54d94823 100644
--- a/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/Nodes/create_confusion_matrix.py
+++ b/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/Nodes/create_confusion_matrix.py
@@ -1,4 +1,4 @@
-"""Confusion matrix visualization node."""
+"""Confusion matrix visualization step."""
 import io
 import logging
 import matplotlib
@@ -6,12 +6,12 @@
 import numpy as np
 import pandas as pd
 import seaborn as sn
-from flowthru import node
+from flowthru import step
 
 logger = logging.getLogger(__name__)
 
 
-@node(inputs=["ModelPredictions"], outputs="ConfusionMatrix")
+@step(inputs=["ModelPredictions"], outputs="ConfusionMatrix")
 def create_confusion_matrix(predictions: pd.DataFrame) -> bytes:
     """Create a confusion matrix from regression predictions binned into categories.
     
diff --git a/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/ReportingPipeline.cs b/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/ReportingPipeline.cs
index e44250ef..7983ad30 100644
--- a/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/ReportingPipeline.cs
+++ b/examples/starter/KedroSpaceflightsPython/Pipelines/Reporting/ReportingPipeline.cs
@@ -1,6 +1,6 @@
 using Flowthru.Extensions.Python.Execution;
-using Flowthru.Extensions.Python.Nodes;
-using Flowthru.Pipelines;
+using Flowthru.Extensions.Python.Steps;
+using Flowthru.Flows;
 using KedroSpaceflightsPython.Data;
 using KedroSpaceflightsPython.Data._02_Intermediate.Schemas;
 using KedroSpaceflightsPython.Data._07_ModelOutput.Schemas;
@@ -16,12 +16,12 @@ public static class ReportingPipeline
   /// <summary>
   /// Creates the reporting pipeline.
   /// </summary>
-  public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
+  public static Flow Create(Catalog catalog, IPythonExecutor executor)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
       // Compare passenger capacity using plotly.express
-      pipeline.AddPythonNode(
+      pipeline.AddPythonStep(
         label: "ComparePassengerCapacityExpress",
         description: "Generate passenger capacity bar chart using plotly.express",
         module: "Pipelines.Reporting.Nodes.compare_passenger_capacity",
@@ -32,7 +32,7 @@ public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
       );
 
       // Compare passenger capacity using plotly.graph_objects
-      pipeline.AddPythonNode(
+      pipeline.AddPythonStep(
         label: "ComparePassengerCapacityGraphObj",
         description: "Generate passenger capacity bar chart using plotly.graph_objects",
         module: "Pipelines.Reporting.Nodes.compare_passenger_capacity",
@@ -43,7 +43,7 @@ public static Pipeline Create(Catalog catalog, IPythonExecutor executor)
       );
 
       // Create confusion matrix from model predictions
-      pipeline.AddPythonNode(
+      pipeline.AddPythonStep(
         label: "CreateConfusionMatrix",
         description: "Generate confusion matrix heatmap from model predictions (binned into categories)",
         module: "Pipelines.Reporting.Nodes.create_confusion_matrix",
diff --git a/examples/starter/KedroSpaceflightsPython/Program.cs b/examples/starter/KedroSpaceflightsPython/Program.cs
index e0acbd9a..030e231a 100644
--- a/examples/starter/KedroSpaceflightsPython/Program.cs
+++ b/examples/starter/KedroSpaceflightsPython/Program.cs
@@ -40,24 +40,40 @@ public class Program
   public static Task<int> Main(string[] args) =>
     FlowthruCli.RunStandaloneAsync(
       args,
-      services => ConfigureServices(services, Directory.GetCurrentDirectory())
+      services =>
+        ConfigureServices(
+          services,
+          Directory.GetCurrentDirectory(),
+          AppDomain.CurrentDomain.BaseDirectory
+        )
     );
 
   /// <summary>
   /// Configures services for the application. Used by test infrastructure.
   /// </summary>
   /// <param name="basePath">Optional base path for data files (defaults to current directory)</param>
-  public static IServiceProvider ConfigureServices(string? basePath = null)
+  public static IServiceProvider ConfigureServices(
+    string? basePath = null,
+    string? outputPath = null
+  )
   {
     var services = new ServiceCollection();
-    ConfigureServices(services, basePath ?? Directory.GetCurrentDirectory());
+    ConfigureServices(
+      services,
+      basePath ?? Directory.GetCurrentDirectory(),
+      outputPath ?? AppDomain.CurrentDomain.BaseDirectory
+    );
     return services.BuildServiceProvider();
   }
 
   /// <summary>
   /// Shared service configuration logic.
   /// </summary>
-  private static void ConfigureServices(IServiceCollection services, string basePath)
+  private static void ConfigureServices(
+    IServiceCollection services,
+    string basePath,
+    string outputPath
+  )
   {
     // Add logging first (required by PythonRuntime)
     services.AddLogging(logging =>
@@ -69,7 +85,7 @@ private static void ConfigureServices(IServiceCollection services, string basePa
     services.AddFlowthru(flowthru =>
     {
       flowthru.UseConfiguration(opts => opts.ConfigurationPath = basePath);
-      flowthru.UseCatalog(_ => new Catalog(Path.Combine(basePath, "Data")));
+      flowthru.RegisterCatalog(_ => new Catalog(Path.Combine(basePath, "Data")));
 
       // Output pipeline metadata
       flowthru.ConfigureMetadata(meta =>
@@ -86,15 +102,12 @@ private static void ConfigureServices(IServiceCollection services, string basePa
       // Configure Python runtime
       flowthru.UsePython(python =>
       {
-        // Add project root to sys.path (for importing from Pipelines/)
+        // Project root: makes Pipelines/ importable as a Python module tree
         python.ModuleSearchPaths.Add(basePath);
-
-        // Add output directory for flowthru Python package (contains @node decorator)
-        var outputDir = AppDomain.CurrentDomain.BaseDirectory;
-        python.ModuleSearchPaths.Add(outputDir);
-
-        // Note: PythonRuntime auto-discovers .venv in AppContext.BaseDirectory via uv sync
-        // No need to manually add site-packages path here
+        // Output directory: contains the flowthru package (@step decorator)
+        python.ModuleSearchPaths.Add(outputPath);
+        // Use this example's own output directory for venv isolation
+        python.VenvPath = outputPath;
       });
 
       // Phase 6 workaround: Resolve Python dependencies for pipeline registration
@@ -106,17 +119,17 @@ private static void ConfigureServices(IServiceCollection services, string basePa
 
       // Register pipelines with resolved executor
       flowthru
-        .RegisterPipeline(label: "DataProcessing", pipeline: DataProcessingPipeline.Create)
+        .RegisterFlow(label: "DataProcessing", flow: DataProcessingPipeline.Create)
         .WithDescription("Preprocesses companies, shuttles, and reviews data using Python");
 
       flowthru
-        .RegisterPipeline(label: "DataScience", pipeline: DataSciencePipeline.Create)
+        .RegisterFlow(label: "DataScience", flow: DataSciencePipeline.Create)
         .WithDescription(
           "Trains linear regression model for price prediction using Python/scikit-learn"
         );
 
       flowthru
-        .RegisterPipeline(label: "Reporting", pipeline: ReportingPipeline.Create)
+        .RegisterFlow(label: "Reporting", flow: ReportingPipeline.Create)
         .WithDescription(
           "Generates visualization outputs including passenger capacity plots and confusion matrix"
         );
diff --git a/examples/starter/Minimal/.template.config/template.json b/examples/starter/Minimal/.template.config/template.json
index e5140153..d5b765f5 100644
--- a/examples/starter/Minimal/.template.config/template.json
+++ b/examples/starter/Minimal/.template.config/template.json
@@ -21,7 +21,7 @@
     "FlowthruVersion": {
       "type": "parameter",
       "dataType": "string",
-      "defaultValue": "0.1.32",
+      "defaultValue": "0.1.33",
       "replaces": "FlowthruVersion",
       "description": "Flowthru package version (auto-injected at pack time)"
     }
diff --git a/examples/starter/Minimal/Data/Catalog.cs b/examples/starter/Minimal/Data/Catalog.cs
index 0c13bd5b..5b431f22 100644
--- a/examples/starter/Minimal/Data/Catalog.cs
+++ b/examples/starter/Minimal/Data/Catalog.cs
@@ -5,7 +5,7 @@ namespace Minimal.Data;
 /// <summary>
 /// Data catalog providing access to all datasets in the pipeline.
 /// </summary>
-public partial class Catalog : DataCatalogBase
+public partial class Catalog : CatalogAbstract
 {
   private readonly string _basePath;
 
diff --git a/examples/starter/Minimal/Data/_01_Raw/Catalog.Raw.cs b/examples/starter/Minimal/Data/_01_Raw/Catalog.Raw.cs
index b6b43312..156d1f5b 100644
--- a/examples/starter/Minimal/Data/_01_Raw/Catalog.Raw.cs
+++ b/examples/starter/Minimal/Data/_01_Raw/Catalog.Raw.cs
@@ -8,10 +8,10 @@ public partial class Catalog
   /// <summary>
   /// Raw name data imported from CSV file.
   /// </summary>
-  public ICatalogEntry<IEnumerable<NameSchema>> Names =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<NameSchema>> Names =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<NameSchema>(
+        ItemFactory.Enumerable.Csv<NameSchema>(
           label: "Names",
           filePath: $"{_basePath}/Data/_01_Raw/Datasets/names.csv"
         )
diff --git a/examples/starter/Minimal/Data/_02_Intermediate/Catalog.Intermediate.cs b/examples/starter/Minimal/Data/_02_Intermediate/Catalog.Intermediate.cs
index 758d8d5e..51df9750 100644
--- a/examples/starter/Minimal/Data/_02_Intermediate/Catalog.Intermediate.cs
+++ b/examples/starter/Minimal/Data/_02_Intermediate/Catalog.Intermediate.cs
@@ -8,10 +8,10 @@ public partial class Catalog
   /// <summary>
   /// Greetings with "Hello" prefix.
   /// </summary>
-  public ICatalogEntry<IEnumerable<GreetingSchema>> HelloGreetings =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<GreetingSchema>> HelloGreetings =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<GreetingSchema>(
+        ItemFactory.Enumerable.Csv<GreetingSchema>(
           label: "HelloGreetings",
           filePath: $"{_basePath}/Data/_02_Intermediate/Datasets/hello_greetings.csv"
         )
diff --git a/examples/starter/Minimal/Data/_03_Primary/Catalog.Primary.cs b/examples/starter/Minimal/Data/_03_Primary/Catalog.Primary.cs
index 5873c683..022da9ea 100644
--- a/examples/starter/Minimal/Data/_03_Primary/Catalog.Primary.cs
+++ b/examples/starter/Minimal/Data/_03_Primary/Catalog.Primary.cs
@@ -8,10 +8,10 @@ public partial class Catalog
   /// <summary>
   /// Farewell greetings with "Goodbye" prefix.
   /// </summary>
-  public ICatalogEntry<IEnumerable<GoodbyeSchema>> Goodbyes =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<GoodbyeSchema>> Goodbyes =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<GoodbyeSchema>(
+        ItemFactory.Enumerable.Csv<GoodbyeSchema>(
           label: "Goodbyes",
           filePath: $"{_basePath}/Data/_03_Primary/Datasets/goodbyes.csv"
         )
@@ -20,10 +20,10 @@ public partial class Catalog
   /// <summary>
   /// Farewell greetings with "So long" prefix.
   /// </summary>
-  public ICatalogEntry<IEnumerable<SoLongSchema>> SoLongs =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<SoLongSchema>> SoLongs =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<SoLongSchema>(
+        ItemFactory.Enumerable.Csv<SoLongSchema>(
           label: "SoLongs",
           filePath: $"{_basePath}/Data/_03_Primary/Datasets/solongs.csv"
         )
diff --git a/examples/starter/Minimal/Pipelines/Greetings/GreetingsPipeline.cs b/examples/starter/Minimal/Pipelines/Greetings/GreetingsPipeline.cs
index e655694b..189eac9e 100644
--- a/examples/starter/Minimal/Pipelines/Greetings/GreetingsPipeline.cs
+++ b/examples/starter/Minimal/Pipelines/Greetings/GreetingsPipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using Minimal.Data;
 using Minimal.Pipelines.Greetings.Nodes;
 
@@ -16,12 +16,12 @@ public static class GreetingsPipeline
   /// <returns>
   /// A configured pipeline that transforms names into various greeting formats.
   /// </returns>
-  public static Pipeline Create(Catalog catalog)
+  public static Flow Create(Catalog catalog)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
       // Node 1: Transform names to "Hello, {name}!"
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "CreateHello",
         description: "Transform names into 'Hello' greetings.",
         transform: CreateHelloNode.Create(),
@@ -30,7 +30,7 @@ public static Pipeline Create(Catalog catalog)
       );
 
       // Node 2: Transform "Hello" greetings into "Goodbye" and "So long" variants
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "TransformGreetings",
         description: "Convert 'Hello' greetings into 'Goodbye' and 'So long' variants.",
         transform: TransformGreetingsNode.Create(),
diff --git a/examples/starter/Minimal/Program.cs b/examples/starter/Minimal/Program.cs
index cff12315..546dd473 100644
--- a/examples/starter/Minimal/Program.cs
+++ b/examples/starter/Minimal/Program.cs
@@ -43,7 +43,7 @@ private static void ConfigureServices(IServiceCollection services, string basePa
     services.AddFlowthru(flowthru =>
     {
       flowthru.UseConfiguration(opts => opts.ConfigurationPath = basePath);
-      flowthru.UseCatalog(_ => new Catalog(basePath));
+      flowthru.RegisterCatalog(_ => new Catalog(basePath));
       flowthru.ConfigureMetadata(meta =>
       {
         var metadataPath = Path.Combine(basePath, "Metadata");
@@ -57,7 +57,7 @@ private static void ConfigureServices(IServiceCollection services, string basePa
 
       // Register the greetings pipeline
       flowthru
-        .RegisterPipeline(label: "Greetings", pipeline: GreetingsPipeline.Create)
+        .RegisterFlow(label: "Greetings", flow: GreetingsPipeline.Create)
         .WithDescription(
           "A minimal pipeline demonstrating name transformation into multiple greeting formats"
         );
diff --git a/examples/starter/Minimal/README.md b/examples/starter/Minimal/README.md
index b917a05a..70f04d34 100644
--- a/examples/starter/Minimal/README.md
+++ b/examples/starter/Minimal/README.md
@@ -63,4 +63,4 @@ View generated greetings in:
 - **Catalog entries** connecting schemas to files
 - **Simple node functions** with pure transformations
 - **Multiple outputs** from a single node (1→2)
-- **Pipeline construction** with `PipelineBuilder`
+- **Pipeline construction** with `FlowBuilder`
diff --git a/examples/starter/SpaceflightsEFCore/.template.config/template.json b/examples/starter/SpaceflightsEFCore/.template.config/template.json
index 714403a7..9f82b2ea 100644
--- a/examples/starter/SpaceflightsEFCore/.template.config/template.json
+++ b/examples/starter/SpaceflightsEFCore/.template.config/template.json
@@ -22,7 +22,7 @@
     "FlowthruVersion": {
       "type": "parameter",
       "dataType": "string",
-      "defaultValue": "0.1.32",
+      "defaultValue": "0.1.33",
       "replaces": "FlowthruVersion",
       "description": "Flowthru package version (auto-injected at pack time)"
     }
diff --git a/examples/starter/SpaceflightsEFCore/Data/Catalog.cs b/examples/starter/SpaceflightsEFCore/Data/Catalog.cs
index 971b226b..634a95af 100644
--- a/examples/starter/SpaceflightsEFCore/Data/Catalog.cs
+++ b/examples/starter/SpaceflightsEFCore/Data/Catalog.cs
@@ -7,7 +7,7 @@ namespace SpaceflightsEFCore.Data;
 /// <summary>
 /// Data catalog for the Spaceflights pipeline, providing access to datasets across all data layers.
 /// </summary>
-public partial class Catalog : DataCatalogBase
+public partial class Catalog : CatalogAbstract
 {
   private readonly string _basePath;
   private readonly IDbContextFactory<SpaceflightsDbContext> _contextFactory;
diff --git a/examples/starter/SpaceflightsEFCore/Data/_01_Raw/Catalog.Raw.cs b/examples/starter/SpaceflightsEFCore/Data/_01_Raw/Catalog.Raw.cs
index 59c88542..51c1832b 100644
--- a/examples/starter/SpaceflightsEFCore/Data/_01_Raw/Catalog.Raw.cs
+++ b/examples/starter/SpaceflightsEFCore/Data/_01_Raw/Catalog.Raw.cs
@@ -8,10 +8,10 @@ public partial class Catalog
   /// <summary>
   /// Raw company data imported from external sources.
   /// </summary>
-  public ICatalogEntry<IEnumerable<CompanySchema>> Companies =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<CompanySchema>> Companies =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<CompanySchema>(
+        ItemFactory.Enumerable.Csv<CompanySchema>(
           label: "Companies",
           filePath: $"{_basePath}/_01_Raw/Datasets/companies.csv"
         )
@@ -20,10 +20,10 @@ public partial class Catalog
   /// <summary>
   /// Raw review data imported from external sources.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ReviewSchema>> Reviews =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ReviewSchema>> Reviews =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Csv<ReviewSchema>(
+        ItemFactory.Enumerable.Csv<ReviewSchema>(
           label: "Reviews",
           filePath: $"{_basePath}/_01_Raw/Datasets/reviews.csv"
         )
@@ -32,10 +32,10 @@ public partial class Catalog
   /// <summary>
   /// Raw shuttle data imported from external sources.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ShuttleSchema>> Shuttles =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ShuttleSchema>> Shuttles =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Excel<ShuttleSchema>(
+        ItemFactory.Enumerable.Excel<ShuttleSchema>(
           label: "Shuttles",
           filePath: $"{_basePath}/_01_Raw/Datasets/shuttles.xlsx",
           sheetName: "Sheet1"
diff --git a/examples/starter/SpaceflightsEFCore/Data/_02_Intermediate/Catalog.Intermediate.cs b/examples/starter/SpaceflightsEFCore/Data/_02_Intermediate/Catalog.Intermediate.cs
index 44154adf..5dd4ddbf 100644
--- a/examples/starter/SpaceflightsEFCore/Data/_02_Intermediate/Catalog.Intermediate.cs
+++ b/examples/starter/SpaceflightsEFCore/Data/_02_Intermediate/Catalog.Intermediate.cs
@@ -10,10 +10,10 @@ public partial class Catalog
   /// <summary>
   /// Preprocessed company data with validated and strongly-typed fields.
   /// </summary>
-  public ICatalogEntry<IEnumerable<PreprocessedCompanySchema>> PreprocessedCompanies =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<PreprocessedCompanySchema>> PreprocessedCompanies =>
+    CreateItem(
       () =>
-        EFCoreCatalogEntries
+        EFCoreItemFactory
           .Enumerable.EFCore<PreprocessedCompanySchema, SpaceflightsDbContext>(
             label: "PreprocessedCompanies",
             contextFactory: _contextFactory
@@ -24,10 +24,10 @@ public partial class Catalog
   /// <summary>
   /// Preprocessed shuttle data with validated and strongly-typed fields.
   /// </summary>
-  public ICatalogEntry<IEnumerable<PreprocessedShuttleSchema>> PreprocessedShuttles =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<PreprocessedShuttleSchema>> PreprocessedShuttles =>
+    CreateItem(
       () =>
-        EFCoreCatalogEntries
+        EFCoreItemFactory
           .Enumerable.EFCore<PreprocessedShuttleSchema, SpaceflightsDbContext>(
             label: "PreprocessedShuttles",
             contextFactory: _contextFactory
diff --git a/examples/starter/SpaceflightsEFCore/Data/_03_Primary/Catalog.Primary.cs b/examples/starter/SpaceflightsEFCore/Data/_03_Primary/Catalog.Primary.cs
index 9540dfa0..9cd8c0c2 100644
--- a/examples/starter/SpaceflightsEFCore/Data/_03_Primary/Catalog.Primary.cs
+++ b/examples/starter/SpaceflightsEFCore/Data/_03_Primary/Catalog.Primary.cs
@@ -14,10 +14,10 @@ public partial class Catalog
   /// Master table of features and labels prepared for model training.
   /// Combines preprocessed company and shuttle data into a single feature matrix.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ModelInputTableSchema>> ModelInputTable =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ModelInputTableSchema>> ModelInputTable =>
+    CreateItem(
       () =>
-        EFCoreCatalogEntries.Enumerable.EFCore<ModelInputTableSchema, SpaceflightsDbContext>(
+        EFCoreItemFactory.Enumerable.EFCore<ModelInputTableSchema, SpaceflightsDbContext>(
           label: "ModelInputTable",
           contextFactory: _contextFactory,
           // Demonstrates query customization: order by shuttle ID for deterministic output.
diff --git a/examples/starter/SpaceflightsEFCore/Data/_04_Feature/Catalog.Feature.cs b/examples/starter/SpaceflightsEFCore/Data/_04_Feature/Catalog.Feature.cs
index b61d4f6b..429f460a 100644
--- a/examples/starter/SpaceflightsEFCore/Data/_04_Feature/Catalog.Feature.cs
+++ b/examples/starter/SpaceflightsEFCore/Data/_04_Feature/Catalog.Feature.cs
@@ -10,10 +10,10 @@ public partial class Catalog
 {
   // TODO: Add feature datasets here as they are created
   // Example:
-  // public ICatalogEntry<IEnumerable<FeatureSchema>> Features =>
-  //   GetOrCreateEntry(
+  // public IItem<IEnumerable<FeatureSchema>> Features =>
+  //   CreateEntry(
   //     () =>
-  //       CatalogEntries.Enumerable.Csv<FeatureSchema>(
+  //       ItemFactory.Enumerable.Csv<FeatureSchema>(
   //         label: "Features",
   //         filePath: $"{_basePath}/_04_Feature/Datasets/features.csv"
   //       )
diff --git a/examples/starter/SpaceflightsEFCore/Data/_05_ModelInput/Catalog.ModelInput.cs b/examples/starter/SpaceflightsEFCore/Data/_05_ModelInput/Catalog.ModelInput.cs
index 9515bc0f..84889930 100644
--- a/examples/starter/SpaceflightsEFCore/Data/_05_ModelInput/Catalog.ModelInput.cs
+++ b/examples/starter/SpaceflightsEFCore/Data/_05_ModelInput/Catalog.ModelInput.cs
@@ -13,10 +13,10 @@ public partial class Catalog
   /// <summary>
   /// Training dataset with features and labels.
   /// </summary>
-  public ICatalogEntry<IEnumerable<TrainingData>> TrainSplit =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<TrainingData>> TrainSplit =>
+    CreateItem(
       () =>
-        EFCoreCatalogEntries.Enumerable.EFCore<TrainingData, SpaceflightsDbContext>(
+        EFCoreItemFactory.Enumerable.EFCore<TrainingData, SpaceflightsDbContext>(
           label: "XTrain",
           contextFactory: _contextFactory
         )
@@ -25,10 +25,10 @@ public partial class Catalog
   /// <summary>
   /// Test dataset with features and labels for model evaluation.
   /// </summary>
-  public ICatalogEntry<IEnumerable<TestData>> TestSplit =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<TestData>> TestSplit =>
+    CreateItem(
       () =>
-        EFCoreCatalogEntries.Enumerable.EFCore<TestData, SpaceflightsDbContext>(
+        EFCoreItemFactory.Enumerable.EFCore<TestData, SpaceflightsDbContext>(
           label: "XTest",
           contextFactory: _contextFactory
         )
diff --git a/examples/starter/SpaceflightsEFCore/Data/_06_Models/Catalog.Models.cs b/examples/starter/SpaceflightsEFCore/Data/_06_Models/Catalog.Models.cs
index b7213033..883adbc3 100644
--- a/examples/starter/SpaceflightsEFCore/Data/_06_Models/Catalog.Models.cs
+++ b/examples/starter/SpaceflightsEFCore/Data/_06_Models/Catalog.Models.cs
@@ -13,10 +13,10 @@ public partial class Catalog
   /// <summary>
   /// Trained linear regression model for price prediction.
   /// </summary>
-  public ICatalogEntry<LinearRegressionModel> Regressor =>
-    GetOrCreateEntry(
+  public IItem<LinearRegressionModel> Regressor =>
+    CreateItem(
       () =>
-        EFCoreCatalogEntries.Single.EFCore<LinearRegressionModel, SpaceflightsDbContext>(
+        EFCoreItemFactory.Single.EFCore<LinearRegressionModel, SpaceflightsDbContext>(
           label: "Regressor",
           contextFactory: _contextFactory
         )
diff --git a/examples/starter/SpaceflightsEFCore/Data/_07_ModelOutput/Catalog.ModelOutput.cs b/examples/starter/SpaceflightsEFCore/Data/_07_ModelOutput/Catalog.ModelOutput.cs
index cf84c3a1..c617704a 100644
--- a/examples/starter/SpaceflightsEFCore/Data/_07_ModelOutput/Catalog.ModelOutput.cs
+++ b/examples/starter/SpaceflightsEFCore/Data/_07_ModelOutput/Catalog.ModelOutput.cs
@@ -13,10 +13,10 @@ public partial class Catalog
   /// <summary>
   /// Evaluation metrics for the trained model (R², MAE, etc).
   /// </summary>
-  public ICatalogEntry<ModelMetrics> ModelMetrics =>
-    GetOrCreateEntry(
+  public IItem<ModelMetrics> ModelMetrics =>
+    CreateItem(
       () =>
-        EFCoreCatalogEntries.Single.EFCore<ModelMetrics, SpaceflightsDbContext>(
+        EFCoreItemFactory.Single.EFCore<ModelMetrics, SpaceflightsDbContext>(
           label: "ModelMetrics",
           contextFactory: _contextFactory
         )
@@ -25,10 +25,10 @@ public partial class Catalog
   /// <summary>
   /// Model predictions on the test set with actual vs predicted prices.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ModelPredictions>> ModelPredictions =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ModelPredictions>> ModelPredictions =>
+    CreateItem(
       () =>
-        EFCoreCatalogEntries.Enumerable.EFCore<ModelPredictions, SpaceflightsDbContext>(
+        EFCoreItemFactory.Enumerable.EFCore<ModelPredictions, SpaceflightsDbContext>(
           label: "ModelPredictions",
           contextFactory: _contextFactory
         )
diff --git a/examples/starter/SpaceflightsEFCore/Data/_08_Reporting/Catalog.Reporting.cs b/examples/starter/SpaceflightsEFCore/Data/_08_Reporting/Catalog.Reporting.cs
index 3d62ab25..4c339220 100644
--- a/examples/starter/SpaceflightsEFCore/Data/_08_Reporting/Catalog.Reporting.cs
+++ b/examples/starter/SpaceflightsEFCore/Data/_08_Reporting/Catalog.Reporting.cs
@@ -13,10 +13,10 @@ public partial class Catalog
   /// <summary>
   /// Passenger capacity analysis report grouped by shuttle type.
   /// </summary>
-  public ICatalogEntry<IEnumerable<ShuttleCapacityReport>> ShuttleCapacityReport =>
-    GetOrCreateEntry(
+  public IItem<IEnumerable<ShuttleCapacityReport>> ShuttleCapacityReport =>
+    CreateItem(
       () =>
-        CatalogEntries.Enumerable.Json<ShuttleCapacityReport>(
+        ItemFactory.Enumerable.Json<ShuttleCapacityReport>(
           label: "ShuttleCapacityReport",
           filePath: $"{_basePath}/_08_Reporting/Datasets/shuttle_capacity_report.json"
         )
@@ -26,9 +26,9 @@ public partial class Catalog
   /// Shuttle passenger capacity bar chart (in-memory GenericChart).
   /// Intermediate chart object stored in memory for downstream export to PNG.
   /// </summary>
-  public ICatalogEntry<GenericChart> ShuttlePassengerCapacityChart =>
-    GetOrCreateEntry(
-      () => CatalogEntries.Single.Memory<GenericChart>(label: "ShuttlePassengerCapacityChart")
+  public IItem<GenericChart> ShuttlePassengerCapacityChart =>
+    CreateItem(
+      () => ItemFactory.Single.Memory<GenericChart>(label: "ShuttlePassengerCapacityChart")
     );
 
   /// <summary>
@@ -36,10 +36,10 @@ public partial class Catalog
   /// Static image representation of the passenger capacity visualization.
   /// Stored as binary PNG file.
   /// </summary>
-  public ICatalogEntry<byte[]> ShuttlePassengerCapacityPlotPng =>
-    GetOrCreateEntry(
+  public IItem<byte[]> ShuttlePassengerCapacityPlotPng =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "ShuttlePassengerCapacityPlotPng",
           filePath: $"{_basePath}/_08_Reporting/Images/shuttle_passenger_capacity_plot.png"
         )
@@ -49,20 +49,18 @@ public partial class Catalog
   /// Confusion matrix heatmap (in-memory GenericChart).
   /// Intermediate chart object stored in memory for downstream export to PNG.
   /// </summary>
-  public ICatalogEntry<GenericChart> ConfusionMatrixChart =>
-    GetOrCreateEntry(
-      () => CatalogEntries.Single.Memory<GenericChart>(label: "ConfusionMatrixChart")
-    );
+  public IItem<GenericChart> ConfusionMatrixChart =>
+    CreateItem(() => ItemFactory.Single.Memory<GenericChart>(label: "ConfusionMatrixChart"));
 
   /// <summary>
   /// Confusion matrix heatmap (PNG image).
   /// Static image representation of the confusion matrix visualization.
   /// Stored as binary PNG file.
   /// </summary>
-  public ICatalogEntry<byte[]> ConfusionMatrixPlotPng =>
-    GetOrCreateEntry(
+  public IItem<byte[]> ConfusionMatrixPlotPng =>
+    CreateItem(
       () =>
-        CatalogEntries.Single.Binary(
+        ItemFactory.Single.Binary(
           label: "ConfusionMatrixPlotPng",
           filePath: $"{_basePath}/_08_Reporting/Images/confusion_matrix_plot.png"
         )
diff --git a/examples/starter/SpaceflightsEFCore/Pipelines/DataProcessing/DataProcessingPipeline.cs b/examples/starter/SpaceflightsEFCore/Pipelines/DataProcessing/DataProcessingPipeline.cs
index c7f1a81a..97a4b0c6 100644
--- a/examples/starter/SpaceflightsEFCore/Pipelines/DataProcessing/DataProcessingPipeline.cs
+++ b/examples/starter/SpaceflightsEFCore/Pipelines/DataProcessing/DataProcessingPipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using SpaceflightsEFCore.Data;
 using SpaceflightsEFCore.Pipelines.DataProcessing.Nodes;
 
@@ -15,11 +15,11 @@ public static class DataProcessingPipeline
   /// </summary>
   /// <param name="catalog">The data catalog containing input and output entries.</param>
   /// <returns>A configured pipeline that produces a model input table from raw data sources.</returns>
-  public static Pipeline Create(Catalog catalog)
+  public static Flow Create(Catalog catalog)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "PreprocessCompanies",
         description: "Cleans and preprocesses raw company data.",
         transform: PreprocessCompaniesNode.Create(),
@@ -27,7 +27,7 @@ public static Pipeline Create(Catalog catalog)
         output: catalog.PreprocessedCompanies
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "PreprocessShuttles",
         description: "Cleans and preprocesses raw shuttle data.",
         transform: PreprocessShuttlesNode.Create(),
@@ -35,7 +35,7 @@ public static Pipeline Create(Catalog catalog)
         output: catalog.PreprocessedShuttles
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "CreateModelInputTable",
         description: """
           Joins preprocessed shuttle and company data with review scores to create a
diff --git a/examples/starter/SpaceflightsEFCore/Pipelines/DataScience/DataSciencePipeline.cs b/examples/starter/SpaceflightsEFCore/Pipelines/DataScience/DataSciencePipeline.cs
index 609fcad3..379f4957 100644
--- a/examples/starter/SpaceflightsEFCore/Pipelines/DataScience/DataSciencePipeline.cs
+++ b/examples/starter/SpaceflightsEFCore/Pipelines/DataScience/DataSciencePipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using SpaceflightsEFCore.Data;
 
 namespace SpaceflightsEFCore.Pipelines.DataScience;
@@ -25,11 +25,11 @@ public record Params
   /// <param name="catalog">The data catalog containing input and output entries.</param>
   /// <param name="parameters">Configuration parameters for the pipeline.</param>
   /// <returns>A configured pipeline that produces a trained model and evaluation metrics.</returns>
-  public static Pipeline Create(Catalog catalog, Params parameters)
+  public static Flow Create(Catalog catalog, Params parameters)
   {
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "SplitData",
         description: "Splits model input data into training and test sets.",
         transform: Nodes.SplitDataNode.Create(parameters.ModelOptions),
@@ -37,7 +37,7 @@ public static Pipeline Create(Catalog catalog, Params parameters)
         output: (catalog.TrainSplit, catalog.TestSplit)
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "TrainModel",
         description: "Trains a regression model to predict shuttle prices.",
         transform: Nodes.TrainModelNode.Create(),
@@ -45,7 +45,7 @@ public static Pipeline Create(Catalog catalog, Params parameters)
         output: catalog.Regressor
       );
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "EvaluateModel",
         description: "Evaluates the trained model on the test set and computes metrics and predictions.",
         transform: Nodes.EvaluateModelNode.Create(),
diff --git a/examples/starter/SpaceflightsEFCore/Pipelines/Reporting/Nodes/PlotlyImageExportNode.cs b/examples/starter/SpaceflightsEFCore/Pipelines/Reporting/Nodes/PlotlyImageExportNode.cs
index 3bc36ec3..2099e9cb 100644
--- a/examples/starter/SpaceflightsEFCore/Pipelines/Reporting/Nodes/PlotlyImageExportNode.cs
+++ b/examples/starter/SpaceflightsEFCore/Pipelines/Reporting/Nodes/PlotlyImageExportNode.cs
@@ -11,13 +11,13 @@ namespace SpaceflightsEFCore.Pipelines.Reporting.Nodes;
 /// <para>
 /// This node handles the PNG export concern separately from chart generation,
 /// enabling a clean separation of visualization logic from output format concerns.
-/// The PNG binary data can be stored in a BinaryFileCatalogEntry&lt;byte[]&gt;.
+/// The PNG binary data can be stored in a BinaryFileItem&lt;byte[]&gt;.
 /// </para>
 /// <para>
 /// <strong>Input:</strong> GenericChart object from memory catalog
 /// </para>
 /// <para>
-/// <strong>Output:</strong> PNG binary data as byte[] (can be stored in BinaryFileCatalogEntry&lt;byte[]&gt;)
+/// <strong>Output:</strong> PNG binary data as byte[] (can be stored in BinaryFileItem&lt;byte[]&gt;)
 /// </para>
 /// <para>
 /// <strong>Reusability:</strong> This node can be used for any Plotly chart type
diff --git a/examples/starter/SpaceflightsEFCore/Pipelines/Reporting/ReportingPipeline.cs b/examples/starter/SpaceflightsEFCore/Pipelines/Reporting/ReportingPipeline.cs
index ccb8f591..012d340b 100644
--- a/examples/starter/SpaceflightsEFCore/Pipelines/Reporting/ReportingPipeline.cs
+++ b/examples/starter/SpaceflightsEFCore/Pipelines/Reporting/ReportingPipeline.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using SpaceflightsEFCore.Data;
 using SpaceflightsEFCore.Pipelines.Reporting.Nodes;
 
@@ -41,15 +41,15 @@ public record Params
   /// <param name="catalog">The data catalog containing input and output entries.</param>
   /// <param name="parameters">Configuration parameters for the pipeline (optional).</param>
   /// <returns>A configured pipeline that produces visualizations and reports.</returns>
-  public static Pipeline Create(Catalog catalog, Params? parameters = null)
+  public static Flow Create(Catalog catalog, Params? parameters = null)
   {
     var p = parameters ?? new Params();
 
-    return PipelineBuilder.CreatePipeline(pipeline =>
+    return FlowBuilder.CreateFlow(pipeline =>
     {
       // ===== Shuttle Passenger Capacity Report (JSON) =====
 
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "ComparePassengerCapacity",
         transform: ComparePassengerCapacityNode.Create(),
         input: catalog.PreprocessedShuttles,
@@ -59,7 +59,7 @@ public static Pipeline Create(Catalog catalog, Params? parameters = null)
       // ===== Shuttle Passenger Capacity Visualization =====
 
       // Step 1: Generate chart from preprocessed shuttle data
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "GeneratePassengerCapacityChart",
         transform: GeneratePassengerCapacityChartNode.Create(),
         input: catalog.PreprocessedShuttles,
@@ -68,7 +68,7 @@ public static Pipeline Create(Catalog catalog, Params? parameters = null)
 
       // NOTE: Commented out due to performance issues with Plotly.NET
       // // Step 2: Export chart to PNG for static reports
-      // pipeline.AddNode(
+      // pipeline.AddStep(
       //   label: "ExportPassengerCapacityPng",
       //   transform: PlotlyImageExportNode.Create(),
       //   input: catalog.ShuttlePassengerCapacityChart,
@@ -78,7 +78,7 @@ public static Pipeline Create(Catalog catalog, Params? parameters = null)
       // ===== Confusion Matrix Visualization =====
 
       // Step 1: Generate confusion matrix heatmap from model predictions
-      pipeline.AddNode(
+      pipeline.AddStep(
         label: "GenerateConfusionMatrixChart",
         transform: CreateConfusionMatrixNode.Create(p.ConfusionMatrixOptions),
         input: catalog.ModelPredictions,
@@ -87,7 +87,7 @@ public static Pipeline Create(Catalog catalog, Params? parameters = null)
 
       // NOTE: Commented out due to performance issues with Plotly.NET
       // // Step 2: Export chart to PNG for static reports
-      // pipeline.AddNode(
+      // pipeline.AddStep(
       //   label: "ExportConfusionMatrixPng",
       //   transform: PlotlyImageExportNode.Create(),
       //   input: catalog.ConfusionMatrixChart,
diff --git a/examples/starter/SpaceflightsEFCore/Program.cs b/examples/starter/SpaceflightsEFCore/Program.cs
index f548617b..94adf1b9 100644
--- a/examples/starter/SpaceflightsEFCore/Program.cs
+++ b/examples/starter/SpaceflightsEFCore/Program.cs
@@ -54,30 +54,30 @@ private static void ConfigureServices(IServiceCollection services, string basePa
     services.AddFlowthru(flowthru =>
     {
       flowthru.UseConfiguration(opts => opts.ConfigurationPath = basePath);
-      flowthru.UseCatalog(sp => new Catalog(
+      flowthru.RegisterCatalog(sp => new Catalog(
         basePath: Path.Combine(basePath, "Data"),
         contextFactory: sp.GetRequiredService<IDbContextFactory<SpaceflightsDbContext>>()
       ));
 
       // Register data processing pipeline
       flowthru
-        .RegisterPipeline(label: "DataProcessing", pipeline: DataProcessingPipeline.Create)
+        .RegisterFlow(label: "DataProcessing", flow: DataProcessingPipeline.Create)
         .WithDescription("Preprocesses companies and shuttles data");
 
       // Register data science pipeline with configuration parameters
       flowthru
-        .RegisterPipeline(
+        .RegisterFlow(
           label: "DataScience",
-          pipeline: DataSciencePipeline.Create,
+          flow: DataSciencePipeline.Create,
           configurationSection: "Flowthru:Pipelines:DataScience"
         )
         .WithDescription("Trains linear regression model for price prediction");
 
       // Register reporting pipeline with configuration parameters
       flowthru
-        .RegisterPipeline(
+        .RegisterFlow(
           label: "Reporting",
-          pipeline: ReportingPipeline.Create,
+          flow: ReportingPipeline.Create,
           configurationSection: "Flowthru:Pipelines:Reporting"
         )
         .WithDescription("Generates passenger capacity reports and visualizations");
diff --git a/examples/starter/SpaceflightsEFCore/README.md b/examples/starter/SpaceflightsEFCore/README.md
index bd14b926..c7e7be26 100644
--- a/examples/starter/SpaceflightsEFCore/README.md
+++ b/examples/starter/SpaceflightsEFCore/README.md
@@ -8,7 +8,7 @@ This example demonstrates using `Flowthru.Extensions.EFCore` to read and write d
 - ✅ Database catalog entries as pipeline seeds (Layer 0 inputs)
 - ✅ Injected DbContext lifecycle management
 - ✅ Reading and writing entities via EFCore adapter
-- ✅ Partial class pattern for extending `CatalogEntries` from external package
+- ✅ Partial class pattern for extending `Items` from external package
 
 ## Project Structure
 
@@ -72,12 +72,12 @@ public class AppDbContext : DbContext
 public static partial class DataCatalog
 {
     // Database source (seed)
-    public static ICatalogEntry<IEnumerable<CompanySchema>> SourceCompanies(DbContext db) =>
-        CatalogEntries.Enumerable.EFCore<CompanySchema>("source_companies", db, readOnly: true);
+    public static IItem<IEnumerable<CompanySchema>> SourceCompanies(DbContext db) =>
+        Items.Enumerable.EFCore<CompanySchema>("source_companies", db, readOnly: true);
     
     // Database destination (output)
-    public static ICatalogEntry<IEnumerable<CompanySchema>> ProcessedCompanies(DbContext db) =>
-        CatalogEntries.Enumerable.EFCore<CompanySchema>("processed_companies", db);
+    public static IItem<IEnumerable<CompanySchema>> ProcessedCompanies(DbContext db) =>
+        Items.Enumerable.EFCore<CompanySchema>("processed_companies", db);
 }
 ```
 
@@ -88,12 +88,12 @@ public static partial class DataCatalog
 using var db = new AppDbContext();
 await db.Database.MigrateAsync();
 
-var pipeline = new PipelineBuilder("CompanyETL")
-    .AddNode("extract", catalog => new ExtractCompaniesNode(
+var pipeline = new FlowBuilder("CompanyETL")
+    .AddStep("extract", catalog => new ExtractCompaniesNode(
         inputs: catalog.SourceCompanies(db),
         outputs: catalog.RawCompanies()
     ))
-    .AddNode("transform", catalog => new TransformCompaniesNode(
+    .AddStep("transform", catalog => new TransformCompaniesNode(
         inputs: catalog.RawCompanies(),
         outputs: catalog.ProcessedCompanies(db)
     ))
diff --git a/scripts/docfx-metadata.sh b/scripts/docfx-metadata.sh
new file mode 100755
index 00000000..914d567c
--- /dev/null
+++ b/scripts/docfx-metadata.sh
@@ -0,0 +1,105 @@
+#!/usr/bin/env bash
+# Generates markdown API reference docs into docs/reference/{src,examples}/ mirroring
+# the repo structure. Discovers .csproj files in src/ and/or examples/, writes a
+# temporary per-project docfx config, runs `docfx metadata`, and removes the temp config.
+#
+# Output layout example:
+#   docs/reference/src/core/Flowthru.Core/
+#   docs/reference/src/extensions/Flowthru.Extensions.Csv/
+#
+# Usage: ./scripts/docfx-metadata.sh [--projects src|examples|all]
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+SCOPE="${1:---projects}"
+FILTER="${2:-src}"
+
+# Parse arguments
+if [[ "$SCOPE" == "--projects" ]]; then
+  SCOPE="$FILTER"
+elif [[ "$SCOPE" != "src" && "$SCOPE" != "examples" && "$SCOPE" != "all" ]]; then
+  SCOPE="src"
+fi
+
+# Build find paths based on scope
+FIND_PATHS=()
+case "$SCOPE" in
+  src)      FIND_PATHS=("$REPO_ROOT/src") ;;
+  examples) FIND_PATHS=("$REPO_ROOT/examples") ;;
+  all)      FIND_PATHS=("$REPO_ROOT/src" "$REPO_ROOT/examples") ;;
+esac
+
+# Discover projects, excluding source generators, archived, and template projects
+PROJECTS=()
+while IFS= read -r line; do
+  PROJECTS+=("$line")
+done < <(
+  find "${FIND_PATHS[@]}" \
+    -name '*.csproj' \
+    -not -path '*/archived/*' \
+    -not -path '*/item-templates/*' \
+    -not -path '*/bin/*' \
+    -not -path '*/obj/*' \
+    -not -path '*/dist/*' \
+    -not -name '*SourceGenerators*' \
+    | sort
+)
+
+if [[ ${#PROJECTS[@]} -eq 0 ]]; then
+  echo "No projects found for scope: $SCOPE"
+  exit 0
+fi
+
+echo "Generating API reference docs for ${#PROJECTS[@]} projects (scope: $SCOPE)"
+echo "---"
+
+FAILURES=()
+
+for csproj in "${PROJECTS[@]}"; do
+  project_dir="$(dirname "$csproj")"
+  csproj_name="$(basename "$csproj")"
+  project_name="${csproj_name%.csproj}"
+  relative_dir="${project_dir#"$REPO_ROOT"/}"
+  config_path="$project_dir/.docfx.metadata.json"
+
+  # Output goes to docs/reference/{relative_dir}/, computed as a path relative
+  # to the config file location (which is in the project directory).
+  output_dir="$REPO_ROOT/docs/reference/$relative_dir"
+  # Make dest relative to config file (project_dir)
+  dest_rel="$(python3 -c "import os; print(os.path.relpath('$output_dir', '$project_dir'))")"
+
+  echo "[$project_name] Generating metadata..."
+
+  # Write temporary docfx config in the project directory so .csproj paths resolve naturally.
+  # shouldSkipMarkup: workaround for Markdig crash in DocFX 2.78.5 (ArgumentOutOfRangeException
+  # in XmlComment.cs). HTML tags from XML docs (<p>, <strong>, etc.) pass through as valid
+  # CommonMark inline HTML, which renders correctly on GitHub and VS Code.
+  cat > "$config_path" << EOF
+{
+  "metadata": [{
+    "src": [{ "files": ["$csproj_name"] }],
+    "dest": "$dest_rel",
+    "outputFormat": "markdown",
+    "disableGitFeatures": true,
+    "shouldSkipMarkup": true
+  }]
+}
+EOF
+
+  if dotnet docfx metadata "$config_path" --noRestore 2>&1 | sed 's/^/  /'; then
+    echo "  ✓ docs/reference/$relative_dir/"
+  else
+    echo "  ✗ Failed for $project_name"
+    FAILURES+=("$project_name")
+  fi
+
+  rm -f "$config_path"
+done
+
+echo "---"
+if [[ ${#FAILURES[@]} -gt 0 ]]; then
+  echo "Completed with ${#FAILURES[@]} failure(s): ${FAILURES[*]}"
+  exit 1
+else
+  echo "✓ All ${#PROJECTS[@]} projects processed successfully"
+fi
diff --git a/src/core/Flowthru.Core/Cli/ArgumentParser.cs b/src/core/Flowthru.Core/Cli/ArgumentParser.cs
index b4a5e926..c7654422 100644
--- a/src/core/Flowthru.Core/Cli/ArgumentParser.cs
+++ b/src/core/Flowthru.Core/Cli/ArgumentParser.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using Flowthru.Services.Models;
 
 namespace Flowthru.Cli;
@@ -151,7 +151,7 @@ public static ParsedArguments Parse(string[] args, IEnumerable<string> available
     }
 
     // Build slice strategy if any slicing flags were provided
-    PipelineSliceStrategy? sliceStrategy = null;
+    FlowSliceStrategy? sliceStrategy = null;
     if (
       pipelines != null
       || fromNodes != null
@@ -161,9 +161,9 @@ public static ParsedArguments Parse(string[] args, IEnumerable<string> available
       || onlyNodes != null
     )
     {
-      sliceStrategy = new PipelineSliceStrategy
+      sliceStrategy = new FlowSliceStrategy
       {
-        Pipelines = pipelines,
+        Flows = pipelines,
         FromNodes = fromNodes,
         ToNodes = toNodes,
         FromData = fromData,
diff --git a/src/core/Flowthru.Core/Cli/FlowthruCli.cs b/src/core/Flowthru.Core/Cli/FlowthruCli.cs
index dd05c144..53332fd5 100644
--- a/src/core/Flowthru.Core/Cli/FlowthruCli.cs
+++ b/src/core/Flowthru.Core/Cli/FlowthruCli.cs
@@ -1,5 +1,5 @@
 using System.Reflection;
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using Flowthru.Services;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Logging;
@@ -46,7 +46,8 @@ public FlowthruCli(
     _output = output ?? Console.Out;
   }
 
-  /// <summa standalone Flowthru CLI application with automatic service provider lifecycle management.
+  /// <summary>
+  /// Creates and runs a standalone Flowthru CLI application with automatic service provider lifecycle management.
   /// </summary>
   /// <remarks>
   /// <para>
@@ -107,7 +108,7 @@ public async Task<int> RunAsync(string[] args, CancellationToken cancellationTok
     try
     {
       // Parse arguments
-      var parsed = ArgumentParser.Parse(args, _service.PipelineNames);
+      var parsed = ArgumentParser.Parse(args, _service.FlowNames);
 
       // Handle special commands
       if (parsed.ShowHelp)
@@ -131,7 +132,7 @@ public async Task<int> RunAsync(string[] args, CancellationToken cancellationTok
       }
 
       // Execute unified pipeline (with optional slicing)
-      var result = await _service.ExecutePipelineAsync(
+      var result = await _service.ExecuteFlowAsync(
         parsed.Options,
         parsed.ExportMetadata,
         parsed.MetadataOutputDirectory,
@@ -194,9 +195,9 @@ private void ShowHelp()
     );
     _output.WriteLine();
     _output.WriteLine("Available Pipelines:");
-    foreach (var name in _service.PipelineNames.OrderBy(n => n))
+    foreach (var name in _service.FlowNames.OrderBy(n => n))
     {
-      var metadata = _service.GetPipelineMetadata(name);
+      var metadata = _service.GetFlowMetadata(name);
       _output.WriteLine($"  {name, -20} {metadata.Description ?? "(no description)"}");
     }
   }
@@ -229,20 +230,20 @@ private void ShowVersion()
   /// Formats pipeline execution results.
   /// </summary>
   /// <param name="result">Pipeline execution result</param>
-  private void FormatResult(PipelineResult result)
+  private void FormatResult(FlowResult result)
   {
     _output.WriteLine();
     _output.WriteLine("═══════════════════════════════════════════════════════════");
-    _output.WriteLine($"Pipeline: {result.PipelineName ?? "(merged)"}");
+    _output.WriteLine($"Pipeline: {result.FlowName ?? "(merged)"}");
     _output.WriteLine($"Status: {(result.Success ? "✓ SUCCESS" : "✗ FAILED")}");
     _output.WriteLine($"Duration: {result.ExecutionTime:hh\\:mm\\:ss\\.fff}");
-    _output.WriteLine($"Nodes: {result.NodeResults.Count} executed");
+    _output.WriteLine($"Nodes: {result.StepResults.Count} executed");
 
     if (!result.Success)
     {
       _output.WriteLine();
       _output.WriteLine("Failed Nodes:");
-      foreach (var (label, nodeResult) in result.NodeResults.Where(n => !n.Value.Success))
+      foreach (var (label, nodeResult) in result.StepResults.Where(n => !n.Value.Success))
       {
         _output.WriteLine($"  - {label}: {nodeResult.Exception?.Message ?? "Unknown error"}");
       }
diff --git a/src/core/Flowthru.Core/Configuration/FlowthruOptions.cs b/src/core/Flowthru.Core/Configuration/FlowthruOptions.cs
index be72461d..a2854871 100644
--- a/src/core/Flowthru.Core/Configuration/FlowthruOptions.cs
+++ b/src/core/Flowthru.Core/Configuration/FlowthruOptions.cs
@@ -27,9 +27,9 @@ public class FlowthruOptions
   public CatalogOptions Catalog { get; set; } = new();
 
   /// <summary>
-  /// Pipeline registration and configuration.
+  /// Flow registration and configuration.
   /// </summary>
-  public Dictionary<string, PipelineOptions> Pipelines { get; set; } = new();
+  public Dictionary<string, FlowOptions> Flows { get; set; } = new();
 
   /// <summary>
   /// Logging configuration (extends standard .NET logging configuration).
@@ -65,7 +65,7 @@ public class MetadataOptions
   /// Supports dynamic tokens that are replaced during export:
   /// </para>
   /// <list type="bullet">
-  /// <item><c>{PipelineName}</c> - Sanitized pipeline name</item>
+  /// <item><c>{FlowName}</c> - Sanitized Flow name</item>
   /// <item><c>{Timestamp}</c> - Formatted timestamp (empty if disabled in Timestamp.IncludeTimestamp)</item>
   /// <item><c>{SliceType}</c> - "FromNodes", "Tags", "Mixed", or empty if unsliced</item>
   /// <item><c>{FromNodes}</c> - Comma-separated list of from-nodes</item>
@@ -79,7 +79,7 @@ public class MetadataOptions
   /// File extensions are added by individual providers (.json, .md, etc.).
   /// </para>
   /// <para>
-  /// <strong>Default:</strong> <c>"dag-{PipelineName}-{Timestamp}-{SliceType}"</c>
+  /// <strong>Default:</strong> <c>"dag-{FlowName}-{Timestamp}-{SliceType}"</c>
   /// </para>
   /// <para>
   /// <strong>Examples:</strong>
@@ -89,7 +89,7 @@ public class MetadataOptions
   /// <item>Sliced: <c>dag-DataProcessing-20260304-153045-FromNodes.json</c></item>
   /// </list>
   /// </remarks>
-  public string FilenameTemplate { get; set; } = "dag-{PipelineName}-{Timestamp}-{SliceType}";
+  public string FilenameTemplate { get; set; } = "dag-{FlowName}-{Timestamp}-{SliceType}";
 
   /// <summary>
   /// Configuration for timestamp generation in metadata filenames.
@@ -140,7 +140,7 @@ public class MermaidMetadataOptions
   /// Color applied to nodes that are in the execution slice.
   /// Default: #2E7D32 (Material Design green-800).
   /// </remarks>
-  public string ActiveNodeColor { get; set; } = "#2E7D32";
+  public string ActiveStepColor { get; set; } = "#2E7D32";
 
   /// <summary>
   /// Hex color code for active (sliced) catalog entries.
@@ -194,12 +194,12 @@ public class CatalogOptions
 }
 
 /// <summary>
-/// Configuration options for a single pipeline.
+/// Configuration options for a single flow.
 /// </summary>
-public class PipelineOptions
+public class FlowOptions
 {
   /// <summary>
-  /// The fully-qualified type name of the pipeline factory class.
+  /// The fully-qualified type name of the Flow factory class.
   /// Must have a static Create method that accepts (catalog, parameters?).
   /// </summary>
   public string? Type { get; set; }
@@ -210,26 +210,26 @@ public class PipelineOptions
   public string FactoryMethod { get; set; } = "Create";
 
   /// <summary>
-  /// Human-readable description of the pipeline.
+  /// Human-readable description of the Flow.
   /// </summary>
   public string? Description { get; set; }
 
   /// <summary>
-  /// Pipeline-specific parameters (nested configuration section).
-  /// The structure must match the pipeline's parameter type.
+  /// Flow-specific parameters (nested configuration section).
+  /// The structure must match the Flow's parameter type.
   /// </summary>
   public Dictionary<string, object>? Parameters { get; set; }
 
   /// <summary>
-  /// Validation configuration for this pipeline.
+  /// Validation configuration for this flow.
   /// </summary>
-  public PipelineValidationOptions? Validation { get; set; }
+  public FlowValidationOptions? Validation { get; set; }
 }
 
 /// <summary>
-/// Configuration options for pipeline validation behavior.
+/// Configuration options for Flow validation behavior.
 /// </summary>
-public class PipelineValidationOptions
+public class FlowValidationOptions
 {
   /// <summary>
   /// Default inspection level for all Layer 0 inputs.
diff --git a/src/core/Flowthru.Core/Configuration/ICatalogFactory.cs b/src/core/Flowthru.Core/Configuration/ICatalogFactory.cs
index 8ee901b1..0e23eea4 100644
--- a/src/core/Flowthru.Core/Configuration/ICatalogFactory.cs
+++ b/src/core/Flowthru.Core/Configuration/ICatalogFactory.cs
@@ -18,7 +18,7 @@ public interface ICatalogFactory
   /// <param name="options">Catalog configuration options</param>
   /// <param name="serviceProvider">Service provider for dependency injection</param>
   /// <returns>The configured catalog instance</returns>
-  DataCatalogBase CreateCatalog(CatalogOptions options, IServiceProvider serviceProvider);
+  CatalogAbstract CreateCatalog(CatalogOptions options, IServiceProvider serviceProvider);
 }
 
 /// <summary>
@@ -32,7 +32,7 @@ public interface ICatalogFactory
 /// </remarks>
 internal class ReflectionCatalogFactory : ICatalogFactory
 {
-  public DataCatalogBase CreateCatalog(CatalogOptions options, IServiceProvider serviceProvider)
+  public CatalogAbstract CreateCatalog(CatalogOptions options, IServiceProvider serviceProvider)
   {
     if (string.IsNullOrWhiteSpace(options.Type))
     {
@@ -69,7 +69,7 @@ public DataCatalogBase CreateCatalog(CatalogOptions options, IServiceProvider se
       );
     }
 
-    if (!typeof(DataCatalogBase).IsAssignableFrom(catalogType))
+    if (!typeof(CatalogAbstract).IsAssignableFrom(catalogType))
     {
       throw new InvalidOperationException(
         $"Type '{options.Type}' does not inherit from DataCatalogBase."
@@ -140,7 +140,7 @@ public DataCatalogBase CreateCatalog(CatalogOptions options, IServiceProvider se
 
       if (allMatched)
       {
-        var catalog = (DataCatalogBase)constructor.Invoke(constructorArgs);
+        var catalog = (CatalogAbstract)constructor.Invoke(constructorArgs);
         return catalog;
       }
     }
diff --git a/src/core/Flowthru.Core/Configuration/PipelineDiscoveryService.cs b/src/core/Flowthru.Core/Configuration/PipelineDiscoveryService.cs
index 4796437c..d88e057b 100644
--- a/src/core/Flowthru.Core/Configuration/PipelineDiscoveryService.cs
+++ b/src/core/Flowthru.Core/Configuration/PipelineDiscoveryService.cs
@@ -1,65 +1,65 @@
 using System.Reflection;
 using Flowthru.Data;
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using Microsoft.Extensions.Configuration;
 
 namespace Flowthru.Configuration;
 
 /// <summary>
-/// Discovers and registers pipelines from configuration.
+/// Discovers and registers flows from configuration.
 /// </summary>
-internal class PipelineDiscoveryService
+internal class FlowDiscoveryService
 {
   /// <summary>
-  /// Discovers pipelines from configuration and returns factory functions.
+  /// Discovers flows from configuration and returns factory functions.
   /// </summary>
   /// <param name="configuration">Configuration instance</param>
   /// <param name="catalogType">The catalog type to use</param>
-  /// <returns>Dictionary of pipeline label to factory function</returns>
-  public static Dictionary<string, PipelineFactoryInfo> DiscoverPipelines(
+  /// <returns>Dictionary of Flow label to factory function</returns>
+  public static Dictionary<string, FlowFactoryInfo> DiscoverFlows(
     IConfiguration configuration,
     Type catalogType
   )
   {
     var flowthruConfig = configuration.GetSection(FlowthruOptions.SectionName);
-    var pipelinesSection = flowthruConfig.GetSection("Pipelines");
+    var flowsSection = flowthruConfig.GetSection("Flows");
 
-    if (!pipelinesSection.Exists())
+    if (!flowsSection.Exists())
     {
-      return new Dictionary<string, PipelineFactoryInfo>();
+      return new Dictionary<string, FlowFactoryInfo>();
     }
 
-    var pipelines = new Dictionary<string, PipelineFactoryInfo>();
+    var flows = new Dictionary<string, FlowFactoryInfo>();
 
-    foreach (var pipelineSection in pipelinesSection.GetChildren())
+    foreach (var flowSection in flowsSection.GetChildren())
     {
-      var label = pipelineSection.Key;
-      var options = new PipelineOptions();
-      pipelineSection.Bind(options);
+      var label = flowSection.Key;
+      var options = new FlowOptions();
+      flowSection.Bind(options);
 
       if (string.IsNullOrWhiteSpace(options.Type))
       {
         throw new InvalidOperationException(
-          $"Pipeline '{label}' is missing required 'Type' configuration. "
-            + $"Example: \"Pipelines\": {{ \"{label}\": {{ \"Type\": \"MyApp.Pipelines.MyPipeline\" }} }}"
+          $"Flow '{label}' is missing required 'Type' configuration. "
+            + $"Example: \"Flows\": {{ \"{label}\": {{ \"Type\": \"MyApp.Flows.MyFlow\" }} }}"
         );
       }
 
-      var factoryInfo = CreateFactoryInfo(label, options, catalogType, pipelineSection);
-      pipelines[label] = factoryInfo;
+      var factoryInfo = CreateFactoryInfo(label, options, catalogType, flowSection);
+      flows[label] = factoryInfo;
     }
 
-    return pipelines;
+    return flows;
   }
 
-  private static PipelineFactoryInfo CreateFactoryInfo(
+  private static FlowFactoryInfo CreateFactoryInfo(
     string label,
-    PipelineOptions options,
+    FlowOptions options,
     Type catalogType,
-    IConfigurationSection pipelineSection
+    IConfigurationSection flowSection
   )
   {
-    // Find the pipeline factory type
+    // Find the Flow factory type
     Type? factoryType = null;
 
     // Try Type.GetType first (supports fully qualified names with assembly)
@@ -81,8 +81,8 @@ IConfigurationSection pipelineSection
     if (factoryType == null)
     {
       throw new InvalidOperationException(
-        $"Could not find pipeline type '{options.Type}' for pipeline '{label}'. "
-          + $"Ensure the type name is fully qualified (e.g., 'MyApp.Pipelines.MyPipeline')."
+        $"Could not find flow type '{options.Type}' for flow '{label}'. "
+          + $"Ensure the type name is fully qualified (e.g., 'MyApp.Flows.MyFlow')."
       );
     }
 
@@ -95,9 +95,9 @@ IConfigurationSection pipelineSection
     if (factoryMethod == null)
     {
       throw new InvalidOperationException(
-        $"Could not find static method '{options.FactoryMethod}' on type '{options.Type}' for pipeline '{label}'. "
-          + $"Expected signature: public static Pipeline Create({catalogType.Name} catalog) or "
-          + $"public static Pipeline Create({catalogType.Name} catalog, TParams parameters)"
+        $"Could not find static method '{options.FactoryMethod}' on type '{options.Type}' for Flow '{label}'. "
+          + $"Expected signature: public static Flow Create({catalogType.Name} catalog) or "
+          + $"public static Flow Create({catalogType.Name} catalog, TParams parameters)"
       );
     }
 
@@ -110,33 +110,33 @@ IConfigurationSection pipelineSection
       );
     }
 
-    // Check if this is a parameterless or parameterized pipeline
+    // Check if this is a parameterless or parameterized flow
     Type? parameterType = null;
     object? parameterInstance = null;
 
     if (parameters.Length > 1)
     {
-      // Parameterized pipeline
+      // Parameterized flow
       parameterType = parameters[1].ParameterType;
 
       // Load and validate parameters from configuration
-      var parametersSection = pipelineSection.GetSection("Parameters");
+      var parametersSection = flowSection.GetSection("Parameters");
       if (!parametersSection.Exists() && options.Parameters == null)
       {
         throw new InvalidOperationException(
-          $"Pipeline '{label}' requires parameters of type '{parameterType.Name}', "
+          $"Flow '{label}' requires parameters of type '{parameterType.Name}', "
             + $"but no 'Parameters' section was found in configuration."
         );
       }
 
       parameterInstance = ConfigurationExtensions.GetValidated(
-        pipelineSection,
+        flowSection,
         "Parameters",
         parameterType
       );
     }
 
-    return new PipelineFactoryInfo
+    return new FlowFactoryInfo
     {
       Label = label,
       FactoryType = factoryType,
@@ -150,9 +150,9 @@ IConfigurationSection pipelineSection
 }
 
 /// <summary>
-/// Information about a discovered pipeline factory.
+/// Information about a discovered Flow factory.
 /// </summary>
-internal class PipelineFactoryInfo
+internal class FlowFactoryInfo
 {
   public required string Label { get; init; }
   public required Type FactoryType { get; init; }
@@ -160,25 +160,25 @@ internal class PipelineFactoryInfo
   public Type? ParameterType { get; init; }
   public object? ParameterInstance { get; init; }
   public string? Description { get; init; }
-  public PipelineValidationOptions? ValidationOptions { get; init; }
+  public FlowValidationOptions? ValidationOptions { get; init; }
 
   /// <summary>
-  /// Invokes the factory method to create a pipeline instance.
+  /// Invokes the factory method to create a Flow instance.
   /// </summary>
-  public Pipeline CreatePipeline(DataCatalogBase catalog)
+  public Flow CreateFlow(CatalogAbstract catalog)
   {
     var args =
       ParameterInstance != null
         ? new object[] { catalog, ParameterInstance }
         : new object[] { catalog };
 
-    if (FactoryMethod.Invoke(null, args) is not Pipeline pipeline)
+    if (FactoryMethod.Invoke(null, args) is not Flow flow)
     {
       throw new InvalidOperationException(
-        $"Factory method '{FactoryMethod.Name}' on type '{FactoryType.Name}' returned null or non-Pipeline value."
+        $"Factory method '{FactoryMethod.Name}' on type '{FactoryType.Name}' returned null or non-Flow value."
       );
     }
 
-    return pipeline;
+    return flow;
   }
 }
diff --git a/src/core/Flowthru.Core/Data/Capabilities/StorageTraits.cs b/src/core/Flowthru.Core/Data/Capabilities/StorageTraits.cs
index 98c8d627..a78ca1c3 100644
--- a/src/core/Flowthru.Core/Data/Capabilities/StorageTraits.cs
+++ b/src/core/Flowthru.Core/Data/Capabilities/StorageTraits.cs
@@ -40,7 +40,7 @@ namespace Flowthru.Data.Capabilities;
 /// <list type="bullet">
 /// <item><strong>Adapter level:</strong> The adapter author declares what the storage medium intrinsically supports.
 /// These are structural truths (e.g., an HTTP GET endpoint cannot write).</item>
-/// <item><strong>Catalog level:</strong> The pipeline author can further constrain an adapter using <c>CatalogEntry.Constrain()</c>.
+/// <item><strong>Catalog level:</strong> The pipeline author can further constrain an adapter using <c>Item.Constrain()</c>.
 /// Constraints can only tighten, never loosen (one-way ratchet).</item>
 /// </list>
 /// <para>
@@ -67,8 +67,8 @@ namespace Flowthru.Data.Capabilities;
 /// <strong>Usage in Catalogs:</strong>
 /// </para>
 /// <code>
-/// public ICatalogEntry&lt;IEnumerable&lt;Company&gt;&gt; ReferenceData =&gt;
-///     GetOrCreateEntry(() =&gt; CatalogEntries.Enumerable.Csv&lt;Company&gt;(
+/// public IItem&lt;IEnumerable&lt;Company&gt;&gt; ReferenceData =&gt;
+///     CreateEntry(() =&gt; ItemFactory.Enumerable.Csv&lt;Company&gt;(
 ///         "ref_data", $"{_basePath}/reference.csv")
 ///         .Constrain(t =&gt; t with { CanWrite = false }));
 /// </code>
diff --git a/src/core/Flowthru.Core/Data/CatalogEntries.Single.cs b/src/core/Flowthru.Core/Data/CatalogEntries.Single.cs
index 1ad1af0f..2a2399ee 100644
--- a/src/core/Flowthru.Core/Data/CatalogEntries.Single.cs
+++ b/src/core/Flowthru.Core/Data/CatalogEntries.Single.cs
@@ -3,14 +3,14 @@
 
 namespace Flowthru.Data;
 
-public static partial class CatalogEntries
+public static partial class ItemFactory
 {
   /// <summary>
   /// Factory methods for single (non-collection) values.
   /// </summary>
   /// <remarks>
   /// <para>
-  /// These methods create catalog entries for single objects rather than collections.
+  /// These methods create catalog items for single objects rather than collections.
   /// </para>
   /// <para>
   /// <strong>Use Cases:</strong>
@@ -20,18 +20,18 @@ public static partial class CatalogEntries
   /// <item>Metrics and evaluation results (single JSON objects)</item>
   /// <item>Text reports (Markdown, plain text)</item>
   /// <item>Binary files (images, PDFs)</item>
-  /// <item>Side-effect-only nodes (null/void semantics)</item>
+  /// <item>Side-effect-only steps (null/void semantics)</item>
   /// </list>
   /// </remarks>
   public static partial class Single
   {
     /// <summary>
-    /// Creates a JSON file catalog entry for a single object (non-collection).
+    /// Creates a JSON file catalog item for a single object (non-collection).
     /// </summary>
     /// <typeparam name="T">Object type (must be structured-serializable)</typeparam>
     /// <param name="label">Unique catalog label for DAG resolution</param>
     /// <param name="filePath">Path to JSON file</param>
-    /// <returns>Catalog entry for singleton JSON object</returns>
+    /// <returns>Catalog item for singleton JSON object</returns>
     /// <remarks>
     /// <para>
     /// <strong>Use Case:</strong> Model files, configuration objects, metrics, single records
@@ -44,19 +44,19 @@ public static partial class Single
     /// format/container composition for direct object serialization.
     /// </para>
     /// </remarks>
-    public static CatalogEntry<T> Json<T>(string label, string filePath)
+    public static Item<T> Json<T>(string label, string filePath)
       where T : IStructuredSerializable
     {
       var storage = new SingletonJsonStorageAdapter<T>(filePath);
-      return new CatalogEntry<T>(label, storage);
+      return new Item<T>(label, storage);
     }
 
     /// <summary>
-    /// Creates a memory catalog entry for a single object (non-collection).
+    /// Creates a memory catalog item for a single object (non-collection).
     /// </summary>
     /// <typeparam name="T">Object type</typeparam>
     /// <param name="label">Unique catalog label for DAG resolution</param>
-    /// <returns>Catalog entry for in-memory singleton</returns>
+    /// <returns>Catalog item for in-memory singleton</returns>
     /// <remarks>
     /// <para>
     /// <strong>Use Case:</strong> Models, charts, computed metrics that stay in memory
@@ -71,18 +71,18 @@ public static CatalogEntry<T> Json<T>(string label, string filePath)
     /// <item>Any singleton data that doesn't need persistence</item>
     /// </list>
     /// </remarks>
-    public static CatalogEntry<T> Memory<T>(string label)
+    public static Item<T> Memory<T>(string label)
     {
       var storage = new MemoryStorageAdapter<T>();
-      return new CatalogEntry<T>(label, storage);
+      return new Item<T>(label, storage);
     }
 
     /// <summary>
-    /// Creates a plain text file catalog entry.
+    /// Creates a plain text file catalog item .
     /// </summary>
     /// <param name="label">Unique catalog label for DAG resolution</param>
     /// <param name="filePath">Path to text file (.txt, .md, etc.)</param>
-    /// <returns>Catalog entry for text file with string content</returns>
+    /// <returns>Catalog item for text file with string content</returns>
     /// <remarks>
     /// <para>
     /// <strong>Use Case:</strong> Markdown reports, plain text logs, configuration files
@@ -94,18 +94,18 @@ public static CatalogEntry<T> Memory<T>(string label)
     /// <strong>Storage Traits:</strong> All traits use filesystem baseline defaults
     /// </para>
     /// </remarks>
-    public static CatalogEntry<string> Text(string label, string filePath)
+    public static Item<string> Text(string label, string filePath)
     {
       var storage = new TextFileStorageAdapter(filePath);
-      return new CatalogEntry<string>(label, storage);
+      return new Item<string>(label, storage);
     }
 
     /// <summary>
-    /// Creates a binary file catalog entry.
+    /// Creates a binary file catalog item.
     /// </summary>
     /// <param name="label">Unique catalog label for DAG resolution</param>
     /// <param name="filePath">Path to binary file (.png, .jpg, .pdf, etc.)</param>
-    /// <returns>Catalog entry for binary file with byte array content</returns>
+    /// <returns>Catalog item for binary file with byte array content</returns>
     /// <remarks>
     /// <para>
     /// <strong>Use Case:</strong> Images (PNG, JPG), PDFs, any binary data
@@ -117,21 +117,21 @@ public static CatalogEntry<string> Text(string label, string filePath)
     /// <strong>Storage Traits:</strong> All traits use filesystem baseline defaults
     /// </para>
     /// </remarks>
-    public static CatalogEntry<byte[]> Binary(string label, string filePath)
+    public static Item<byte[]> Binary(string label, string filePath)
     {
       var storage = new BinaryFileStorageAdapter(filePath);
-      return new CatalogEntry<byte[]>(label, storage);
+      return new Item<byte[]>(label, storage);
     }
 
     /// <summary>
-    /// Creates a null catalog entry for side-effect-only nodes.
+    /// Creates a null catalog item for side-effect-only steps.
     /// </summary>
     /// <typeparam name="T">The data type (typically NoData)</typeparam>
     /// <param name="label">Unique catalog label for DAG resolution</param>
-    /// <returns>Catalog entry for void/no-data semantics</returns>
+    /// <returns>Catalog item for void/no-data semantics</returns>
     /// <remarks>
     /// <para>
-    /// <strong>Use Case:</strong> Nodes that perform side effects (logging, visualization) without producing meaningful data
+    /// <strong>Use Case:</strong> Steps that perform side effects (logging, visualization) without producing meaningful data
     /// </para>
     /// <para>
     /// <strong>Implementation:</strong> Uses NullStorageAdapter which performs no I/O operations.
@@ -144,10 +144,10 @@ public static CatalogEntry<byte[]> Binary(string label, string filePath)
     /// <item>CanRead: false (Load throws NotSupportedException)</item>
     /// </list>
     /// </remarks>
-    public static CatalogEntry<T> Null<T>(string label)
+    public static Item<T> Null<T>(string label)
     {
       var storage = new NullStorageAdapter<T>();
-      return new CatalogEntry<T>(label, storage);
+      return new Item<T>(label, storage);
     }
   }
 }
diff --git a/src/core/Flowthru.Core/Data/CatalogEntries.cs b/src/core/Flowthru.Core/Data/CatalogEntries.cs
index 9979e01f..7def9b83 100644
--- a/src/core/Flowthru.Core/Data/CatalogEntries.cs
+++ b/src/core/Flowthru.Core/Data/CatalogEntries.cs
@@ -32,7 +32,7 @@ namespace Flowthru.Data;
 ///     string Name       // Looks for "Name" in CSV/Excel/JSON
 /// ) : IFlatSchema, ITextSerializable;
 ///
-/// var simple = CatalogEntries.Enumerable.Csv&lt;SimpleSchema&gt;("data", "data.csv");
+/// var simple = ItemFactory.Enumerable.Csv&lt;SimpleSchema&gt;("data", "data.csv");
 ///
 /// // Tier 2: Explicit annotations - handle naming mismatches
 /// public record ShuttleSchema(
@@ -49,23 +49,23 @@ namespace Flowthru.Data;
 ///     int CompanyId
 /// ) : IFlatSchema, ITextSerializable;
 ///
-/// var shuttles = CatalogEntries.Enumerable.Excel&lt;ShuttleSchema&gt;(
+/// var shuttles = ItemFactory.Enumerable.Excel&lt;ShuttleSchema&gt;(
 ///     "shuttles",
 ///     "data/shuttles.xlsx",
 ///     "Sheet1"
 /// );
 ///
 /// // Same schema works across all formats
-/// var csv = CatalogEntries.Enumerable.Csv&lt;ShuttleSchema&gt;("shuttles", "data/shuttles.csv");
-/// var json = CatalogEntries.Enumerable.Json&lt;ShuttleSchema&gt;("shuttles", "data/shuttles.json");
+/// var csv = ItemFactory.Enumerable.Csv&lt;ShuttleSchema&gt;("shuttles", "data/shuttles.csv");
+/// var json = ItemFactory.Enumerable.Json&lt;ShuttleSchema&gt;("shuttles", "data/shuttles.json");
 /// </code>
 /// </example>
-public static partial class CatalogEntries
+public static partial class ItemFactory
 {
   /// <summary>
   /// Factory methods for <see cref="IEnumerable{T}"/> catalog entries.
   /// </summary>
-  public static EnumerableCatalogEntries Enumerable { get; } = new EnumerableCatalogEntries();
+  public static EnumerableItemFactory Enumerable { get; } = new EnumerableItemFactory();
 
   /// <summary>
   /// Creates a null catalog entry for side-effect-only nodes.
@@ -75,7 +75,7 @@ public static partial class CatalogEntries
   /// <returns>Catalog entry for void/no-data semantics</returns>
   /// <remarks>
   /// <para>
-  /// <strong>Use Case:</strong> Nodes that perform side effects (logging, visualization) without producing meaningful data
+  /// <strong>Use Case:</strong> Steps that perform side effects (logging, visualization) without producing meaningful data
   /// </para>
   /// <para>
   /// <strong>Implementation:</strong> Uses NullStorageAdapter which performs no I/O operations.
@@ -88,9 +88,9 @@ public static partial class CatalogEntries
   /// <item>CanRead: false (Load throws NotSupportedException)</item>
   /// </list>
   /// </remarks>
-  public static CatalogEntry<T> Null<T>(string label)
+  public static Item<T> Null<T>(string label)
   {
     var storage = new NullStorageAdapter<T>();
-    return new CatalogEntry<T>(label, storage);
+    return new Item<T>(label, storage);
   }
 }
diff --git a/src/core/Flowthru.Core/Data/CatalogEntry.cs b/src/core/Flowthru.Core/Data/CatalogEntry.cs
index 45682049..883ac49b 100644
--- a/src/core/Flowthru.Core/Data/CatalogEntry.cs
+++ b/src/core/Flowthru.Core/Data/CatalogEntry.cs
@@ -6,7 +6,7 @@
 namespace Flowthru.Data;
 
 /// <summary>
-/// Standard catalog entry implementation that delegates to a storage adapter.
+/// Standard catalog item implementation that delegates to a storage adapter.
 /// </summary>
 /// <typeparam name="T">The data type (container with rows)</typeparam>
 /// <remarks>
@@ -16,25 +16,25 @@ namespace Flowthru.Data;
 /// <para>
 /// This class is a thin wrapper that delegates all operations to an <see cref="IStorageAdapter{T}"/>.
 /// The storage adapter handles the actual I/O logic, while this class provides:
-/// - ICatalogEntry interface implementation
+/// - ICatalogItem interface implementation
 /// - Identity for DAG dependency resolution (via Key)
-/// - Type erasure for pipeline heterogeneous collections
+/// - Type erasure for Flow heterogeneous collections
 /// </para>
 /// <para>
 /// <strong>Construction:</strong>
 /// </para>
 /// <para>
-/// Typically created via static factory methods in <see cref="CatalogEntries"/>:
+/// Typically created via static factory methods in <see cref="ItemFactory"/>:
 /// </para>
 /// <code>
-/// var entry = CatalogEntries.Csv&lt;CompanySchema&gt;("companies", "data.csv");
-/// // Returns: ICatalogEntry&lt;IEnumerable&lt;CompanySchema&gt;&gt;
+/// var item = CatalogItemFactory.Csv&lt;CompanySchema&gt;("companies", "data.csv");
+/// // Returns: ICatalogItem&lt;IEnumerable&lt;CompanySchema&gt;&gt;
 /// </code>
 /// <para>
 /// <strong>Composition vs Inheritance:</strong>
 /// </para>
 /// <para>
-/// Previous design: Inheritance hierarchy (CsvCatalogEntry, JsonCatalogEntry, etc.)
+/// Previous design: Inheritance hierarchy (CsvCatalogItem, JsonCatalogItem, etc.)
 /// New design: Single class + composed storage adapter
 /// </para>
 /// <para>
@@ -48,10 +48,10 @@ namespace Flowthru.Data;
 /// </para>
 /// <para>
 /// The underlying storage adapter provides inspection methods, which this catalog
-/// entry automatically forwards. All storage adapters are required to implement inspection.
+/// item automatically forwards. All storage adapters are required to implement inspection.
 /// </para>
 /// </remarks>
-public sealed class CatalogEntry<T> : ICatalogEntry<T>
+public sealed class Item<T> : IItem<T>
 {
   private readonly IStorageAdapter<T> _storage;
   private InspectionLevel? _preferredInspectionLevel;
@@ -59,11 +59,11 @@ public sealed class CatalogEntry<T> : ICatalogEntry<T>
   private string? _owningCatalogLabel;
 
   /// <summary>
-  /// Creates a new catalog entry with the specified key and storage adapter.
+  /// Creates a new catalog item with the specified key and storage adapter.
   /// </summary>
-  /// <param name="label">Unique identifier for this catalog entry</param>
+  /// <param name="label">Unique identifier for this catalog item</param>
   /// <param name="storage">Storage adapter that handles I/O operations</param>
-  public CatalogEntry(string label, IStorageAdapter<T> storage)
+  public Item(string label, IStorageAdapter<T> storage)
   {
     this.Label = label ?? throw new ArgumentNullException(nameof(label));
     _storage = storage ?? throw new ArgumentNullException(nameof(storage));
@@ -85,7 +85,7 @@ public CatalogEntry(string label, IStorageAdapter<T> storage)
   internal void SetOwningCatalog(string label) => _owningCatalogLabel ??= label;
 
   /// <summary>
-  /// Gets the effective storage traits for this catalog entry.
+  /// Gets the effective storage traits for this catalog item.
   /// </summary>
   /// <remarks>
   /// <para>
@@ -93,7 +93,7 @@ public CatalogEntry(string label, IStorageAdapter<T> storage)
   /// applied via <see cref=\"Constrain\"/>.
   /// </para>
   /// <para>
-  /// Used by pipeline validation to enforce read-only constraints, network requirements, etc.
+  /// Used by Flow validation to enforce read-only constraints, network requirements, etc.
   /// </para>
   /// </remarks>
   public StorageTraits Traits => _effectiveTraits ?? _storage.Traits;
@@ -123,7 +123,7 @@ public FlowIO<FlowUnit> SaveUntyped(object data)
     return FlowIO.Fail<FlowUnit>(
       new Exception(
         $"Type mismatch: Cannot save data of type '{data?.GetType().Name ?? "null"}' "
-          + $"to catalog entry '{Label}' expecting type '{typeof(T).Name}'"
+          + $"to catalog item '{Label}' expecting type '{typeof(T).Name}'"
       )
     );
   }
@@ -171,23 +171,23 @@ private static bool IsCollectionType(Type type)
   }
 
   /// <summary>
-  /// Sets the preferred inspection level for this catalog entry.
+  /// Sets the preferred inspection level for this catalog item.
   /// </summary>
   /// <param name="level">The inspection level to use</param>
-  /// <returns>This catalog entry for method chaining</returns>
+  /// <returns>This catalog item for method chaining</returns>
   /// <remarks>
   /// <para>
-  /// Used to configure how this entry should be validated before pipeline execution.
+  /// Used to configure how this item should be validated before Flow execution.
   /// </para>
   /// <para>
   /// Example:
   /// </para>
   /// <code>
-  /// var entry = CatalogEntries.Csv&lt;Company&gt;("companies", "data.csv")
+  /// var item = CatalogItemFactory.Csv&lt;Company&gt;("companies", "data.csv")
   ///     .WithInspectionLevel(InspectionLevel.Deep);
   /// </code>
   /// </remarks>
-  public CatalogEntry<T> WithInspectionLevel(InspectionLevel level)
+  public Item<T> WithInspectionLevel(InspectionLevel level)
   {
     _preferredInspectionLevel = level;
     return this;
@@ -197,7 +197,7 @@ public CatalogEntry<T> WithInspectionLevel(InspectionLevel level)
   /// Applies user-specified constraints to the storage traits.
   /// </summary>
   /// <param name="constraintFn">Function that modifies traits to apply constraints</param>
-  /// <returns>This catalog entry for method chaining</returns>
+  /// <returns>This catalog item for method chaining</returns>
   /// <remarks>
   /// <para>
   /// <strong>One-Way Ratchet:</strong> Constraints can only tighten, never loosen.
@@ -221,8 +221,8 @@ public CatalogEntry<T> WithInspectionLevel(InspectionLevel level)
   /// <strong>Example:</strong>
   /// </para>
   /// <code>
-  /// public ICatalogEntry&lt;IEnumerable&lt;Company&gt;&gt; ReferenceData =>
-  ///     GetOrCreateEntry(() => CatalogEntries.Enumerable.Csv&lt;Company&gt;(
+  /// public ICatalogItem&lt;IEnumerable&lt;Company&gt;&gt; ReferenceData =>
+  ///     CreateItem(() => CatalogItemFactory.Enumerable.Csv&lt;Company&gt;(
   ///         "ref_data", $"{_basePath}/reference.csv")
   ///         .Constrain(t => t with { CanWrite = false }));
   /// </code>
@@ -230,7 +230,7 @@ public CatalogEntry<T> WithInspectionLevel(InspectionLevel level)
   /// <exception cref=\"InvalidOperationException\">
   /// Thrown when attempting to loosen a constraint (grant a capability the adapter doesn't support)
   /// </exception>
-  public CatalogEntry<T> Constrain(Func<StorageTraits, StorageTraits> constraintFn)
+  public Item<T> Constrain(Func<StorageTraits, StorageTraits> constraintFn)
   {
     if (constraintFn == null)
       throw new ArgumentNullException(nameof(constraintFn));
diff --git a/src/core/Flowthru.Core/Data/DataCatalogBase.cs b/src/core/Flowthru.Core/Data/DataCatalogBase.cs
index 7b3b22f0..b2a249b3 100644
--- a/src/core/Flowthru.Core/Data/DataCatalogBase.cs
+++ b/src/core/Flowthru.Core/Data/DataCatalogBase.cs
@@ -10,13 +10,13 @@ namespace Flowthru.Data;
 /// <remarks>
 /// <para>
 /// <strong>Problem Solved:</strong>
-/// Expression-bodied properties (<c>Property => new Entry()</c>) create new instances on each access,
+/// Expression-bodied properties (<c>Property => new Item()</c>) create new instances on each access,
 /// breaking DAG dependency resolution which relies on object identity.
 /// </para>
 /// <para>
 /// <strong>Solution:</strong>
 /// Uses reflection to:
-/// 1. Discover all ICatalogEntry properties on derived classes
+/// 1. Discover all IItem properties on derived classes
 /// 2. Create backing fields to cache instances
 /// 3. Intercept property getters to return cached instances
 /// </para>
@@ -34,35 +34,35 @@ namespace Flowthru.Data;
 ///     protected string BasePath { get; }
 ///
 ///     // Declare once - automatically cached!
-///     public ICatalogEntry&lt;IEnumerable&lt;MyData&gt;&gt; MyData =>
-///         GetOrCreateEntry(() => new CsvCatalogEntry&lt;MyData&gt;("my_data", $"{BasePath}/data.csv"));
+///     public IItem&lt;IEnumerable&lt;MyData&gt;&gt; MyData =>
+///         CreateItem(() => new CsvCatalogItem&lt;MyData&gt;("my_data", $"{BasePath}/data.csv"));
 /// }
 /// </code>
 /// </para>
 /// <para>
 /// <strong>Key Benefits:</strong>
-/// - Declare catalog entries ONCE (no redundant constructor code)
+/// - Declare catalog items ONCE (no redundant constructor code)
 /// - Automatic instance caching (object identity preserved)
 /// - Type-safe (compile-time checks)
 /// - Zero runtime overhead after first access (cached delegates)
 /// </para>
 /// </remarks>
-public abstract class DataCatalogBase
+public abstract class CatalogAbstract
 {
   /// <summary>
   /// Cache of property values to ensure object identity for DAG resolution.
-  /// Key: Property name, Value: Cached ICatalogEntry instance
+  /// Key: Property name, Value: Cached IItem instance
   /// </summary>
-  private readonly ConcurrentDictionary<string, ICatalogEntry> _propertyCache = new();
+  private readonly ConcurrentDictionary<string, IItem> _propertyCache = new();
 
   /// <summary>
-  /// The display label used to identify this catalog instance in pipeline metadata.
+  /// The display label used to identify this catalog instance in Flow metadata.
   /// Defaults to the concrete class name when not specified.
   /// </summary>
   /// <remarks>
   /// Pass an explicit label when constructing multiple instances of the same catalog type
-  /// in a single pipeline (e.g., per-partition or per-shard catalogs) so their entries
-  /// receive distinct qualified identifiers in the DAG: <c>CatalogLabel.EntryLabel</c>.
+  /// in a single Flow (e.g., per-partition or per-shard catalogs) so their items
+  /// receive distinct qualified identifiers in the DAG: <c>CatalogLabel.ItemLabel</c>.
   /// </remarks>
   public string CatalogLabel { get; }
 
@@ -70,85 +70,85 @@ public abstract class DataCatalogBase
   /// Optional display label for this catalog instance. When omitted, defaults to the
   /// concrete class name via <c>GetType().Name</c>.
   /// </param>
-  protected DataCatalogBase(string? catalogLabel = null)
+  protected CatalogAbstract(string? catalogLabel = null)
   {
     CatalogLabel = catalogLabel ?? GetType().Name;
   }
 
   /// <summary>
-  /// Optional service provider for dependency injection into catalog entries.
+  /// Optional service provider for dependency injection into catalog items.
   /// </summary>
   /// <remarks>
-  /// Set by the service layer before pipeline execution to enable catalog
-  /// entries to resolve services (e.g., database connections, HTTP clients).
+  /// Set by the service layer before Flow execution to enable catalog
+  /// items to resolve services (e.g., database connections, HTTP clients).
   /// </remarks>
   public IServiceProvider? Services { get; set; }
 
   /// <summary>
-  /// Gets or creates a unified catalog entry, caching it for subsequent accesses.
+  /// Gets or creates a unified catalog item, caching it for subsequent accesses.
   /// </summary>
   /// <typeparam name="T">
-  /// The data type stored in this catalog entry.
+  /// The data type stored in this catalog item.
   /// For singletons: Use T directly (e.g., LinearRegressionModel)
   /// For collections: Use IEnumerable&lt;T&gt; (e.g., IEnumerable&lt;FeatureRow&gt;)
   /// </typeparam>
-  /// <param name="factory">Factory function to create the entry on first access</param>
+  /// <param name="factory">Factory function to create the item on first access</param>
   /// <param name="propertyName">Auto-populated by compiler with calling property name</param>
-  /// <returns>Cached catalog entry instance</returns>
+  /// <returns>Cached catalog item instance</returns>
   /// <remarks>
   /// <para>
-  /// <strong>Unified API (v0.5.0):</strong> This single method replaces GetOrCreateObject
-  /// and GetOrCreateDataset. Cardinality is determined by the type parameter T.
+  /// <strong>Unified API (v0.5.0):</strong> This single method replaces CreateObject
+  /// and CreateDataset. Cardinality is determined by the type parameter T.
   /// </para>
   /// <para>
   /// <strong>Usage Examples:</strong>
   /// <code>
   /// // Singleton object
-  /// public ICatalogEntry&lt;LinearRegressionModel&gt; Model =>
-  ///     GetOrCreateEntry(() =&gt; CatalogEntries.Single.Memory&lt;LinearRegressionModel&gt;("model"));
+  /// public IItem&lt;LinearRegressionModel&gt; Model =>
+  ///     CreateItem(() =&gt; ItemFactory.Single.Memory&lt;LinearRegressionModel&gt;("model"));
   ///
   /// // Collection
-  /// public ICatalogEntry&lt;IEnumerable&lt;FeatureRow&gt;&gt; Features =&gt;
-  ///     GetOrCreateEntry(() =&gt; CatalogEntries.Enumerable.Csv&lt;FeatureRow&gt;("features", "data.csv"));
+  /// public IItem&lt;IEnumerable&lt;FeatureRow&gt;&gt; Features =&gt;
+  ///     CreateItem(() =&gt; ItemFactory.Enumerable.Csv&lt;FeatureRow&gt;("features", "data.csv"));
   /// </code>
   /// </para>
   /// </remarks>
-  protected ICatalogEntry<T> GetOrCreateEntry<T>(
-    Func<ICatalogEntry<T>> factory,
+  protected IItem<T> CreateItem<T>(
+    Func<IItem<T>> factory,
     [System.Runtime.CompilerServices.CallerMemberName] string propertyName = ""
   )
   {
-    var entry = _propertyCache.GetOrAdd(propertyName, _ => factory());
-    if (entry is CatalogEntry<T> concrete)
+    var item = _propertyCache.GetOrAdd(propertyName, _ => factory());
+    if (item is Item<T> concrete)
       concrete.SetOwningCatalog(CatalogLabel);
-    return (ICatalogEntry<T>)entry;
+    return (IItem<T>)item;
   }
 
   /// <summary>
-  /// Gets or creates a unified catalog entry with service provider access.
+  /// Gets or creates a unified catalog item with service provider access.
   /// </summary>
   /// <typeparam name="T">The data type (singleton or collection)</typeparam>
   /// <param name="factory">Factory function that receives service provider</param>
   /// <param name="propertyName">Auto-populated by compiler with calling property name</param>
-  /// <returns>Cached catalog entry instance</returns>
-  protected ICatalogEntry<T> GetOrCreateEntry<T>(
-    Func<IServiceProvider?, ICatalogEntry<T>> factory,
+  /// <returns>Cached catalog item instance</returns>
+  protected IItem<T> CreateItem<T>(
+    Func<IServiceProvider?, IItem<T>> factory,
     [System.Runtime.CompilerServices.CallerMemberName] string propertyName = ""
   )
   {
-    var entry = _propertyCache.GetOrAdd(propertyName, _ => factory(Services));
-    if (entry is CatalogEntry<T> concrete)
+    var item = _propertyCache.GetOrAdd(propertyName, _ => factory(Services));
+    if (item is Item<T> concrete)
       concrete.SetOwningCatalog(CatalogLabel);
-    return (ICatalogEntry<T>)entry;
+    return (IItem<T>)item;
   }
 
   /// <summary>
-  /// Initializes all catalog entry properties by invoking their getters once.
+  /// Initializes all catalog item properties by invoking their getters once.
   /// </summary>
   /// <remarks>
   /// <para>
-  /// <strong>Purpose:</strong> Eager initialization ensures all entries are cached
-  /// before pipeline construction begins, preventing any potential race conditions
+  /// <strong>Purpose:</strong> Eager initialization ensures all items are cached
+  /// before Flow construction begins, preventing any potential race conditions
   /// or unexpected lazy initialization behavior.
   /// </para>
   /// <para>
@@ -157,7 +157,7 @@ protected ICatalogEntry<T> GetOrCreateEntry<T>(
   /// </para>
   /// <para>
   /// <strong>How It Works:</strong>
-  /// Uses reflection to find all public instance properties that return ICatalogEntry,
+  /// Uses reflection to find all public instance properties that return IItem,
   /// then invokes each getter once to populate the cache.
   /// </para>
   /// </remarks>
@@ -165,7 +165,7 @@ protected void InitializeCatalogProperties()
   {
     var catalogProperties = GetType()
       .GetProperties(BindingFlags.Public | BindingFlags.Instance)
-      .Where(p => typeof(ICatalogEntry).IsAssignableFrom(p.PropertyType));
+      .Where(p => typeof(IItem).IsAssignableFrom(p.PropertyType));
 
     foreach (var property in catalogProperties)
     {
@@ -175,14 +175,14 @@ protected void InitializeCatalogProperties()
   }
 
   /// <summary>
-  /// Gets all cached catalog entries.
+  /// Gets all cached catalog items.
   /// </summary>
-  /// <returns>Enumerable of all initialized catalog entries</returns>
+  /// <returns>Enumerable of all initialized catalog items</returns>
   /// <remarks>
-  /// Useful for diagnostic purposes or when you need to iterate over all entries
+  /// Useful for diagnostic purposes or when you need to iterate over all items
   /// (e.g., for validation, cleanup, or reporting).
   /// </remarks>
-  protected IEnumerable<ICatalogEntry> GetAllEntries()
+  protected IEnumerable<IItem> GetAllItemFactory()
   {
     return _propertyCache.Values;
   }
@@ -192,7 +192,7 @@ protected IEnumerable<ICatalogEntry> GetAllEntries()
   /// </summary>
   /// <remarks>
   /// <para>
-  /// <strong>Warning:</strong> Clearing the cache after pipeline construction will break
+  /// <strong>Warning:</strong> Clearing the cache after Flow construction will break
   /// DAG dependencies since new instances will be created on next access.
   /// </para>
   /// <para>
diff --git a/src/core/Flowthru.Core/Data/EnumerableCatalogEntries.cs b/src/core/Flowthru.Core/Data/EnumerableCatalogEntries.cs
index 71bdc343..1ff292fc 100644
--- a/src/core/Flowthru.Core/Data/EnumerableCatalogEntries.cs
+++ b/src/core/Flowthru.Core/Data/EnumerableCatalogEntries.cs
@@ -7,7 +7,7 @@
 namespace Flowthru.Data;
 
 /// <summary>
-/// Extension point for <see cref="CatalogEntries.Enumerable"/> factory methods.
+/// Extension point for <see cref="ItemFactory.Enumerable"/> factory methods.
 /// </summary>
 /// <remarks>
 /// <para>
@@ -26,7 +26,7 @@ namespace Flowthru.Data;
 /// <strong>Use Cases:</strong>
 /// </para>
 /// <list type="bullet">
-/// <item>Standard data processing pipelines (90% of cases)</item>
+/// <item>Standard data processing flows (90% of cases)</item>
 /// <item>Interop with .NET libraries expecting IEnumerable</item>
 /// <item>LINQ query composition</item>
 /// <item>Large datasets where you'll enumerate only once</item>
@@ -37,17 +37,17 @@ namespace Flowthru.Data;
 /// register new formats.
 /// </para>
 /// </remarks>
-public sealed class EnumerableCatalogEntries
+public sealed class EnumerableItemFactory
 {
-  internal EnumerableCatalogEntries() { }
+  internal EnumerableItemFactory() { }
 
   /// <summary>
-  /// Creates a JSON file catalog entry with IEnumerable container for collections.
+  /// Creates a JSON file catalog item with IEnumerable container for collections.
   /// </summary>
   /// <typeparam name="TRow">Row schema type (must be structured-serializable)</typeparam>
   /// <param name="label">Unique catalog label for DAG resolution</param>
   /// <param name="filePath">Path to JSON file</param>
-  /// <returns>Catalog entry with file + JSON + IEnumerable composition</returns>
+  /// <returns>Catalog item with file + JSON + IEnumerable composition</returns>
   /// <remarks>
   /// <para>
   /// <strong>Requirements:</strong>
@@ -68,7 +68,7 @@ internal EnumerableCatalogEntries() { }
   /// <strong>Serialization:</strong> JSON array format for collections
   /// </para>
   /// </remarks>
-  public CatalogEntry<IEnumerable<TRow>> Json<TRow>(string label, string filePath)
+  public Item<IEnumerable<TRow>> Json<TRow>(string label, string filePath)
     where TRow : notnull, IStructuredSerializable
   {
     var medium = new FileStorageMedium(filePath);
@@ -76,18 +76,18 @@ public CatalogEntry<IEnumerable<TRow>> Json<TRow>(string label, string filePath)
     var container = new EnumerableContainerAdapter<TRow>();
     var storage = new ComposedStorageAdapter<IEnumerable<TRow>, TRow>(medium, format, container);
 
-    return new CatalogEntry<IEnumerable<TRow>>(label, storage);
+    return new Item<IEnumerable<TRow>>(label, storage);
   }
 
   /// <summary>
-  /// Creates an in-memory transient catalog entry with IEnumerable container.
+  /// Creates an in-memory transient catalog item with IEnumerable container.
   /// </summary>
   /// <typeparam name="TRow">Row schema type</typeparam>
   /// <param name="label">Unique catalog label for DAG resolution</param>
-  /// <returns>Catalog entry with memory storage (no serialization)</returns>
+  /// <returns>Catalog item with memory storage (no serialization)</returns>
   /// <remarks>
   /// <para>
-  /// <strong>Use Case:</strong> Intermediate pipeline data that doesn't need persistence
+  /// <strong>Use Case:</strong> Intermediate Flow data that doesn't need persistence
   /// </para>
   /// <para>
   /// <strong>Storage Traits:</strong>
@@ -96,9 +96,9 @@ public CatalogEntry<IEnumerable<TRow>> Json<TRow>(string label, string filePath)
   /// <item>IsPersistent: false (data lost when process ends)</item>
   /// </list>
   /// </remarks>
-  public CatalogEntry<IEnumerable<TRow>> Memory<TRow>(string label)
+  public Item<IEnumerable<TRow>> Memory<TRow>(string label)
   {
     var storage = new MemoryStorageAdapter<IEnumerable<TRow>>();
-    return new CatalogEntry<IEnumerable<TRow>>(label, storage);
+    return new Item<IEnumerable<TRow>>(label, storage);
   }
 }
diff --git a/src/core/Flowthru.Core/Data/ICatalogEntry.cs b/src/core/Flowthru.Core/Data/ICatalogEntry.cs
index d9b93fde..91eacccf 100644
--- a/src/core/Flowthru.Core/Data/ICatalogEntry.cs
+++ b/src/core/Flowthru.Core/Data/ICatalogEntry.cs
@@ -4,90 +4,90 @@
 namespace Flowthru.Data;
 
 /// <summary>
-/// Non-generic base interface for catalog entries.
-/// Provides untyped operations for internal use by the pipeline executor and mapping layer.
+/// Non-generic base interface for catalog items.
+/// Provides untyped operations for internal use by the Flow executor and mapping layer.
 /// </summary>
 /// <remarks>
-/// This interface enables the pipeline to work with catalog entries
+/// This interface enables the Flow to work with catalog items
 /// without knowing their specific type parameter at compile-time.
 /// </remarks>
-public interface ICatalogEntry
+public interface IItem
 {
   /// <summary>
-  /// Unique label identifying this catalog entry within the data catalog.
+  /// Unique label identifying this catalog item within the data catalog.
   /// </summary>
   string Label { get; }
 
   /// <summary>
-  /// The runtime type of data stored in this catalog entry.
+  /// The runtime type of data stored in this catalog item.
   /// For singletons: Returns typeof(T).
   /// For collections: Returns typeof(IEnumerable&lt;T&gt;).
   /// </summary>
   Type DataType { get; }
 
   /// <summary>
-  /// Gets the preferred inspection level for this catalog entry.
+  /// Gets the preferred inspection level for this catalog item.
   /// </summary>
   InspectionLevel? PreferredInspectionLevel { get; }
 
   /// <summary>
-  /// The label of the <see cref="Flowthru.Data.DataCatalogBase"/>-derived class that created
-  /// this entry. Set automatically by <c>GetOrCreateEntry</c>; null for entries created outside
-  /// a catalog or by custom <see cref="ICatalogEntry"/> implementations.
+  /// The label of the <see cref="Flowthru.Data.CatalogAbstract"/>-derived class that created
+  /// this item. Set automatically by <c>CreateItem</c>; null for items created outside
+  /// a catalog or by custom <see cref="IItem"/> implementations.
   /// </summary>
   /// <remarks>
-  /// Used by the metadata layer to produce fully-qualified entry identifiers in the form
-  /// <c>CatalogLabel.EntryLabel</c>. First-write-wins: cross-catalog shared entries retain
+  /// Used by the metadata layer to produce fully-qualified item identifiers in the form
+  /// <c>CatalogLabel.ItemLabel</c>. First-write-wins: cross-catalog shared items retain
   /// the label of the catalog that originally created them.
   /// </remarks>
   string? OwningCatalogLabel => null;
 
   /// <summary>
-  /// Loads data from the catalog entry as an untyped object.
+  /// Loads data from the catalog item as an untyped object.
   /// Returns an effect that can fail.
   /// The returned type matches the DataType property.
   /// </summary>
   FlowIO<object> LoadUntyped();
 
   /// <summary>
-  /// Saves untyped data to the catalog entry.
+  /// Saves untyped data to the catalog item.
   /// Returns an effect that can fail.
   /// The data type must be compatible with the DataType property.
   /// </summary>
   FlowIO<FlowUnit> SaveUntyped(object data);
 
   /// <summary>
-  /// Checks if data exists at this catalog entry location.
+  /// Checks if data exists at this catalog item location.
   /// Returns an effect that can fail.
   /// </summary>
   FlowIO<bool> Exists();
 
   /// <summary>
-  /// Gets the count of items in this catalog entry.
+  /// Gets the count of items in this catalog item.
   /// For collections (IEnumerable&lt;T&gt;), returns the enumerable count.
   /// For singletons, returns 1 if exists, 0 otherwise.
   /// </summary>
   FlowIO<int> GetCountAsync();
 
   /// <summary>
-  /// Performs shallow validation of this catalog entry.
+  /// Performs shallow validation of this catalog item.
   /// </summary>
   /// <param name="sampleSize">Number of rows/records to sample for validation</param>
   /// <returns>Effect producing validation result</returns>
   FlowIO<ValidationResult> InspectShallow(int sampleSize = 100);
 
   /// <summary>
-  /// Performs deep validation of this catalog entry.
+  /// Performs deep validation of this catalog item.
   /// </summary>
   /// <returns>Effect producing validation result</returns>
   FlowIO<ValidationResult> InspectDeep();
 }
 
 /// <summary>
-/// Unified catalog entry with cardinality encoded in the type parameter.
+/// Unified catalog item with cardinality encoded in the type parameter.
 /// </summary>
 /// <typeparam name="T">
-/// The data type stored in this catalog entry.
+/// The data type stored in this catalog item.
 /// Cardinality is determined by T itself:
 /// - For singletons: Use T directly (e.g., LinearRegressionModel, ModelMetrics)
 /// - For collections: Use IEnumerable&lt;T&gt; (e.g., IEnumerable&lt;FeatureRow&gt;)
@@ -98,7 +98,7 @@ public interface ICatalogEntry
 /// system (ICatalogObject/ICatalogDataset). Cardinality is now purely a type-level concern.
 /// </para>
 /// <para>
-/// <strong>Type Alignment:</strong> Node TInput/TOutput types should directly match catalog entry
+/// <strong>Type Alignment:</strong> Step TInput/TOutput types should directly match catalog item
 /// T types, eliminating the need for wrapping/unwrapping ceremony.
 /// </para>
 /// <para>
@@ -109,7 +109,7 @@ public interface ICatalogEntry
 /// - Functional composition
 /// </para>
 /// </remarks>
-public interface ICatalogEntry<T> : ICatalogEntry
+public interface IItem<T> : IItem
 {
   /// <summary>
   /// Load data as an effect (can fail, is async, can be cancelled).
diff --git a/src/core/Flowthru.Core/Data/Storage/Format/JsonFormatSerializer.cs b/src/core/Flowthru.Core/Data/Storage/Format/JsonFormatSerializer.cs
index a5e41fdc..44a17798 100644
--- a/src/core/Flowthru.Core/Data/Storage/Format/JsonFormatSerializer.cs
+++ b/src/core/Flowthru.Core/Data/Storage/Format/JsonFormatSerializer.cs
@@ -411,7 +411,7 @@ internal sealed class SerializedEnumJsonConverter<TEnum> : JsonConverter<TEnum>
 
   public SerializedEnumJsonConverter()
   {
-    _metadata = Serialization.EnumMetadataRegistry.GetOrCreate<TEnum>();
+    _metadata = Serialization.EnumMetadataRegistry.Create<TEnum>();
   }
 
   public override TEnum Read(
diff --git a/src/core/Flowthru.Core/Data/Storage/IStorageAdapter.cs b/src/core/Flowthru.Core/Data/Storage/IStorageAdapter.cs
index 897e3d90..0acd29e0 100644
--- a/src/core/Flowthru.Core/Data/Storage/IStorageAdapter.cs
+++ b/src/core/Flowthru.Core/Data/Storage/IStorageAdapter.cs
@@ -41,10 +41,10 @@ namespace Flowthru.Data.Storage;
 /// <strong>Usage in Catalog Entries:</strong>
 /// </para>
 /// <para>
-/// <see cref="ICatalogEntry{T}"/> delegates to this interface:
+/// <see cref="IItem{T}"/> delegates to this interface:
 /// </para>
 /// <code>
-/// public class CatalogEntry&lt;T&gt; : ICatalogEntry&lt;T&gt;
+/// public class Item&lt;T&gt; : IItem&lt;T&gt;
 /// {
 ///     private readonly IStorageAdapter&lt;T&gt; _storage;
 ///
diff --git a/src/core/Flowthru.Core/Data/Storage/IStorageMedium.cs b/src/core/Flowthru.Core/Data/Storage/IStorageMedium.cs
index 2b50e3e6..c353d3e6 100644
--- a/src/core/Flowthru.Core/Data/Storage/IStorageMedium.cs
+++ b/src/core/Flowthru.Core/Data/Storage/IStorageMedium.cs
@@ -118,7 +118,7 @@ public interface IStorageMedium
   /// <remarks>
   /// <para>
   /// This is used to determine if a catalog entry is a "seed" (Layer 0 input)
-  /// or if it's produced by a node in the pipeline.
+  /// or if it's produced by a step in the pipeline.
   /// </para>
   /// </remarks>
   FlowIO<bool> Exists();
diff --git a/src/core/Flowthru.Core/Data/Storage/MemoryStorageAdapter.cs b/src/core/Flowthru.Core/Data/Storage/MemoryStorageAdapter.cs
index 901920b7..be5c2515 100644
--- a/src/core/Flowthru.Core/Data/Storage/MemoryStorageAdapter.cs
+++ b/src/core/Flowthru.Core/Data/Storage/MemoryStorageAdapter.cs
@@ -40,11 +40,11 @@ namespace Flowthru.Data.Storage;
 /// <code>
 /// // Singleton usage
 /// var modelStorage = new MemoryStorageAdapter&lt;LinearRegressionModel&gt;();
-/// var modelEntry = new CatalogEntry&lt;LinearRegressionModel&gt;("model", modelStorage);
+/// var modelEntry = new Item&lt;LinearRegressionModel&gt;("model", modelStorage);
 ///
 /// // Collection usage
 /// var dataStorage = new MemoryStorageAdapter&lt;IEnumerable&lt;FeatureRow&gt;&gt;();
-/// var dataEntry = new CatalogEntry&lt;IEnumerable&lt;FeatureRow&gt;&gt;("features", dataStorage);
+/// var dataEntry = new Item&lt;IEnumerable&lt;FeatureRow&gt;&gt;("features", dataStorage);
 /// </code>
 /// </example>
 public sealed class MemoryStorageAdapter<T> : IStorageAdapter<T>
diff --git a/src/core/Flowthru.Core/Data/Storage/NullStorageAdapter.cs b/src/core/Flowthru.Core/Data/Storage/NullStorageAdapter.cs
index 3a2c4085..2a011b2c 100644
--- a/src/core/Flowthru.Core/Data/Storage/NullStorageAdapter.cs
+++ b/src/core/Flowthru.Core/Data/Storage/NullStorageAdapter.cs
@@ -9,7 +9,7 @@ namespace Flowthru.Data.Storage;
 /// <typeparam name="T">The data type (typically NoData)</typeparam>
 /// <remarks>
 /// <para>
-/// <strong>Use Case:</strong> Nodes that perform side effects (logging, visualization, alerts)
+/// <strong>Use Case:</strong> Steps that perform side effects (logging, visualization, alerts)
 /// but don't produce data that downstream nodes need.
 /// </para>
 /// <para>
diff --git a/src/core/Flowthru.Core/Data/Storage/SchemaActivator.cs b/src/core/Flowthru.Core/Data/Storage/SchemaActivator.cs
index eb105c45..c61ff7e6 100644
--- a/src/core/Flowthru.Core/Data/Storage/SchemaActivator.cs
+++ b/src/core/Flowthru.Core/Data/Storage/SchemaActivator.cs
@@ -13,16 +13,16 @@ namespace Flowthru.Data.Storage;
 /// <strong>Design Philosophy:</strong>
 /// </para>
 /// <para>
-/// With Flowthru's strong node contracts, schemas with required members are guaranteed to contain
+/// With Flowthru's strong step contracts, schemas with required members are guaranteed to contain
 /// valid data because:
 /// </para>
 /// <list type="bullet">
 /// <item><strong>Layer 0 (Seeds):</strong> Validation phase checks required fields exist before execution</item>
-/// <item><strong>Layers 1+ (Node outputs):</strong> C# compiler enforces required members when nodes construct output</item>
+/// <item><strong>Layers 1+ (Step outputs):</strong> C# compiler enforces required members when steps construct output</item>
 /// </list>
 /// <para>
 /// This activator's role is to enable deserialization by creating instances that will be populated
-/// via property reflection. No validation is performed here - that happens at the pipeline boundaries.
+/// via property reflection. No validation is performed here - that happens at the Flow boundaries.
 /// </para>
 /// <para>
 /// <strong>Instantiation Strategy:</strong>
@@ -82,7 +82,7 @@ public static class SchemaActivator
   /// <para>
   /// This is safe because:
   /// - Layer 0: Validation ensures required fields exist in data
-  /// - Layers 1+: Data came from valid node output
+  /// - Layers 1+: Data came from valid step output
   /// </para>
   /// </remarks>
   public static T CreateInstance<T>()
@@ -171,7 +171,7 @@ private static Func<T> CompileFactory<T>(Type type)
   /// This is safe in Flowthru because properties will be populated immediately
   /// via reflection from deserialized data, which is guaranteed to contain all
   /// required fields (via validation phase for Layer 0, or compiler enforcement
-  /// for node outputs).
+  /// for step outputs).
   /// </para>
   /// </remarks>
   private static T CreateUninitializedObject<T>()
diff --git a/src/core/Flowthru.Core/Data/Storage/SingletonJsonStorageAdapter.cs b/src/core/Flowthru.Core/Data/Storage/SingletonJsonStorageAdapter.cs
index 1f6b5aa4..c0cea28b 100644
--- a/src/core/Flowthru.Core/Data/Storage/SingletonJsonStorageAdapter.cs
+++ b/src/core/Flowthru.Core/Data/Storage/SingletonJsonStorageAdapter.cs
@@ -34,7 +34,7 @@ namespace Flowthru.Data.Storage;
 /// <example>
 /// <code>
 /// var storage = new SingletonJsonStorageAdapter&lt;LinearRegressionModel&gt;("model.json");
-/// var entry = new CatalogEntry&lt;LinearRegressionModel&gt;("model", storage);
+/// var entry = new Item&lt;LinearRegressionModel&gt;("model", storage);
 ///
 /// // Save
 /// await entry.Save(model).RunAsync();
diff --git a/src/core/Flowthru.Core/Data/Storage/Strategies/DatabaseStorageEntryFactory.cs b/src/core/Flowthru.Core/Data/Storage/Strategies/DatabaseStorageEntryFactory.cs
index 4627a00b..bfe21ce9 100644
--- a/src/core/Flowthru.Core/Data/Storage/Strategies/DatabaseStorageEntryFactory.cs
+++ b/src/core/Flowthru.Core/Data/Storage/Strategies/DatabaseStorageEntryFactory.cs
@@ -29,7 +29,7 @@ namespace Flowthru.Data.Storage.Strategies;
 /// <code>
 /// services.AddFlowthru(flowthru =>
 /// {
-///     flowthru.UseCatalog&lt;MyCatalog&gt;();
+///     flowthru.RegisterCatalog&lt;MyCatalog&gt;();
 ///
 ///     if (env.IsProduction())
 ///     {
@@ -76,10 +76,7 @@ public DatabaseStorageEntryFactory(string connectionString, string schema = "dbo
   /// <exception cref="NotImplementedException">
   /// Phase 2 stub - database support not yet implemented
   /// </exception>
-  public ICatalogEntry<IEnumerable<T>> CreateEnumerable<T>(
-    string label,
-    StorageOptions? options = null
-  )
+  public IItem<IEnumerable<T>> CreateEnumerable<T>(string label, StorageOptions? options = null)
     where T : notnull, IFlatSchema, ITextSerializable
   {
     throw new NotImplementedException(
@@ -93,7 +90,7 @@ public ICatalogEntry<IEnumerable<T>> CreateEnumerable<T>(
     // var medium = new DatabaseStorageMedium(_connectionString, tableName);
     // var format = new SqlFormatSerializer<T>();
     // var container = new EnumerableContainerAdapter<T>();
-    // return new CatalogEntry<IEnumerable<T>>(
+    // return new Item<IEnumerable<T>>(
     //     label,
     //     new ComposedStorageAdapter<IEnumerable<T>, T>(medium, format, container)
     // );
@@ -103,7 +100,7 @@ public ICatalogEntry<IEnumerable<T>> CreateEnumerable<T>(
   /// <exception cref="NotImplementedException">
   /// Phase 2 stub - database support not yet implemented
   /// </exception>
-  public ICatalogEntry<T> CreateSingle<T>(string label, StorageOptions? options = null)
+  public IItem<T> CreateSingle<T>(string label, StorageOptions? options = null)
     where T : IStructuredSerializable
   {
     throw new NotImplementedException(
diff --git a/src/core/Flowthru.Core/Data/Storage/Strategies/IStorageEntryFactory.cs b/src/core/Flowthru.Core/Data/Storage/Strategies/IStorageEntryFactory.cs
index e1472556..32c71724 100644
--- a/src/core/Flowthru.Core/Data/Storage/Strategies/IStorageEntryFactory.cs
+++ b/src/core/Flowthru.Core/Data/Storage/Strategies/IStorageEntryFactory.cs
@@ -29,8 +29,8 @@ namespace Flowthru.Data.Storage.Strategies;
 ///         InitializeCatalogProperties();
 ///     }
 ///
-///     public ICatalogEntry&lt;IEnumerable&lt;Company&gt;&gt; Companies =>
-///         GetOrCreateEntry(() => _storage.CreateEnumerable&lt;Company&gt;("Companies"));
+///     public IItem&lt;IEnumerable&lt;Company&gt;&gt; Companies =>
+///         CreateEntry(() => _storage.CreateEnumerable&lt;Company&gt;("Companies"));
 /// }
 /// </code>
 /// </remarks>
@@ -53,7 +53,7 @@ public interface IStorageEntryFactory
   /// (e.g., "Companies" → "Companies.csv" or "dbo.Companies").
   /// </para>
   /// </remarks>
-  ICatalogEntry<IEnumerable<T>> CreateEnumerable<T>(string label, StorageOptions? options = null)
+  IItem<IEnumerable<T>> CreateEnumerable<T>(string label, StorageOptions? options = null)
     where T : notnull, IFlatSchema, ITextSerializable;
 
   /// <summary>
@@ -72,6 +72,6 @@ ICatalogEntry<IEnumerable<T>> CreateEnumerable<T>(string label, StorageOptions?
   /// Typically uses structured formats (JSON, MessagePack) for singletons.
   /// </para>
   /// </remarks>
-  ICatalogEntry<T> CreateSingle<T>(string label, StorageOptions? options = null)
+  IItem<T> CreateSingle<T>(string label, StorageOptions? options = null)
     where T : IStructuredSerializable;
 }
diff --git a/src/core/Flowthru.Core/Data/Storage/Strategies/MemoryStorageEntryFactory.cs b/src/core/Flowthru.Core/Data/Storage/Strategies/MemoryStorageEntryFactory.cs
index 4b5bb0f2..768e8953 100644
--- a/src/core/Flowthru.Core/Data/Storage/Strategies/MemoryStorageEntryFactory.cs
+++ b/src/core/Flowthru.Core/Data/Storage/Strategies/MemoryStorageEntryFactory.cs
@@ -33,19 +33,16 @@ namespace Flowthru.Data.Storage.Strategies;
 public sealed class MemoryStorageEntryFactory : IStorageEntryFactory
 {
   /// <inheritdoc />
-  public ICatalogEntry<IEnumerable<T>> CreateEnumerable<T>(
-    string label,
-    StorageOptions? options = null
-  )
+  public IItem<IEnumerable<T>> CreateEnumerable<T>(string label, StorageOptions? options = null)
     where T : notnull, IFlatSchema, ITextSerializable
   {
-    return CatalogEntries.Enumerable.Memory<T>(label);
+    return ItemFactory.Enumerable.Memory<T>(label);
   }
 
   /// <inheritdoc />
-  public ICatalogEntry<T> CreateSingle<T>(string label, StorageOptions? options = null)
+  public IItem<T> CreateSingle<T>(string label, StorageOptions? options = null)
     where T : IStructuredSerializable
   {
-    return CatalogEntries.Single.Memory<T>(label);
+    return ItemFactory.Single.Memory<T>(label);
   }
 }
diff --git a/src/core/Flowthru.Core/Pipelines/DependencyAnalyzer.cs b/src/core/Flowthru.Core/Flows/DependencyAnalyzer.cs
similarity index 76%
rename from src/core/Flowthru.Core/Pipelines/DependencyAnalyzer.cs
rename to src/core/Flowthru.Core/Flows/DependencyAnalyzer.cs
index 46cc0b19..5cc34427 100644
--- a/src/core/Flowthru.Core/Pipelines/DependencyAnalyzer.cs
+++ b/src/core/Flowthru.Core/Flows/DependencyAnalyzer.cs
@@ -1,6 +1,6 @@
 using Flowthru.Data;
 
-namespace Flowthru.Pipelines;
+namespace Flowthru.Flows;
 
 /// <summary>
 /// Analyzes pipeline node dependencies and performs topological sort to determine execution order.
@@ -18,8 +18,8 @@ namespace Flowthru.Pipelines;
 /// </list>
 /// <para>
 /// <strong>Layer Assignment:</strong>
-/// - Layer 0: Nodes with no dependencies (read only external data)
-/// - Layer N: Nodes whose dependencies are all in layers 0..N-1
+/// - Layer 0: Steps with no dependencies (read only external data)
+/// - Layer N: Steps whose dependencies are all in layers 0..N-1
 /// </para>
 /// <para>
 /// <strong>Pipeline Slicing:</strong>
@@ -43,7 +43,7 @@ internal static class DependencyAnalyzer
   /// This method combines BuildDependencyGraph and AssignLayers for convenience.
   /// For sliced pipelines, call these methods separately to recalculate layers post-slice.
   /// </remarks>
-  public static void AnalyzeAndAssignLayers(List<PipelineNode> nodes)
+  public static void AnalyzeAndAssignLayers(List<FlowStep> nodes)
   {
     BuildDependencyGraph(nodes);
     AssignLayers(nodes);
@@ -60,7 +60,7 @@ public static void AnalyzeAndAssignLayers(List<PipelineNode> nodes)
   /// This phase must occur before slicing, as the slicing logic traverses node dependencies
   /// to determine which nodes to include. Layer assignment should happen separately after slicing.
   /// </remarks>
-  public static void BuildDependencyGraph(List<PipelineNode> nodes)
+  public static void BuildDependencyGraph(List<FlowStep> nodes)
   {
     // Step 1: Build producer map (catalog entry → node that produces it)
     var producerMap = BuildProducerMap(nodes);
@@ -77,9 +77,9 @@ public static void BuildDependencyGraph(List<PipelineNode> nodes)
   /// <exception cref="InvalidOperationException">
   /// Thrown if multiple nodes write to the same catalog entry
   /// </exception>
-  private static Dictionary<string, PipelineNode> BuildProducerMap(List<PipelineNode> nodes)
+  private static Dictionary<string, FlowStep> BuildProducerMap(List<FlowStep> nodes)
   {
-    var producerMap = new Dictionary<string, PipelineNode>(StringComparer.OrdinalIgnoreCase);
+    var producerMap = new Dictionary<string, FlowStep>(StringComparer.OrdinalIgnoreCase);
 
     foreach (var node in nodes)
     {
@@ -107,8 +107,8 @@ private static Dictionary<string, PipelineNode> BuildProducerMap(List<PipelineNo
   /// <param name="nodes">All nodes in the pipeline</param>
   /// <param name="producerMap">Map of catalog entry labels to their producer nodes</param>
   private static void ResolveDependencies(
-    List<PipelineNode> nodes,
-    Dictionary<string, PipelineNode> producerMap
+    List<FlowStep> nodes,
+    Dictionary<string, FlowStep> producerMap
   )
   {
     foreach (var node in nodes)
@@ -132,22 +132,22 @@ Dictionary<string, PipelineNode> producerMap
   /// <summary>
   /// Assigns execution layers to nodes via topological sort.
   /// </summary>
-  /// <param name="nodes">Nodes to assign layers to (full pipeline or sliced subset)</param>
+  /// <param name="nodes">Steps to assign layers to (full pipeline or sliced subset)</param>
   /// <exception cref="InvalidOperationException">Thrown if a circular dependency is detected</exception>
   /// <remarks>
   /// This method should be called after slicing to ensure Layer 0 correctly identifies
   /// nodes with no dependencies in the execution context.
   /// </remarks>
-  public static void AssignLayers(List<PipelineNode> nodes)
+  public static void AssignLayers(List<FlowStep> nodes)
   {
     // Track which nodes have been assigned layers
-    var assigned = new HashSet<PipelineNode>();
+    var assigned = new HashSet<FlowStep>();
     var currentLayer = 0;
 
     // Keep assigning layers until all nodes are processed
     while (assigned.Count < nodes.Count)
     {
-      var nodesInCurrentLayer = new List<PipelineNode>();
+      var nodesInCurrentLayer = new List<FlowStep>();
 
       // Find nodes whose dependencies are all already assigned
       foreach (var node in nodes)
@@ -170,10 +170,10 @@ public static void AssignLayers(List<PipelineNode> nodes)
       // If no nodes were assigned this iteration, we have a cycle
       if (nodesInCurrentLayer.Count == 0)
       {
-        var unassignedNodes = nodes.Where(n => !assigned.Contains(n)).Select(n => n.Label);
+        var unassignedSteps = nodes.Where(n => !assigned.Contains(n)).Select(n => n.Label);
         throw new InvalidOperationException(
           $"Circular dependency detected in pipeline. "
-            + $"Unassigned nodes: {string.Join(", ", unassignedNodes)}"
+            + $"Unassigned nodes: {string.Join(", ", unassignedSteps)}"
         );
       }
 
@@ -191,8 +191,8 @@ public static void AssignLayers(List<PipelineNode> nodes)
   /// Groups nodes by their assigned execution layer.
   /// </summary>
   /// <param name="nodes">All nodes in the pipeline (must have layers assigned)</param>
-  /// <returns>Nodes grouped by layer, ordered by layer number</returns>
-  public static IEnumerable<List<PipelineNode>> GroupByLayer(List<PipelineNode> nodes)
+  /// <returns>Steps grouped by layer, ordered by layer number</returns>
+  public static IEnumerable<List<FlowStep>> GroupByLayer(List<FlowStep> nodes)
   {
     return nodes.GroupBy(n => n.Layer).OrderBy(g => g.Key).Select(g => g.ToList());
   }
@@ -200,7 +200,7 @@ public static IEnumerable<List<PipelineNode>> GroupByLayer(List<PipelineNode> no
   /// <summary>
   /// Slices a pipeline to include only nodes matching the specified strategy.
   /// </summary>
-  /// <param name="allNodes">All nodes in the pipeline</param>
+  /// <param name="allSteps">All nodes in the pipeline</param>
   /// <param name="strategy">The slicing strategy to apply</param>
   /// <returns>Filtered list of nodes forming a valid sub-DAG</returns>
   /// <exception cref="InvalidOperationException">
@@ -221,31 +221,28 @@ public static IEnumerable<List<PipelineNode>> GroupByLayer(List<PipelineNode> no
   /// sub-DAG that can execute without missing dependencies.
   /// </para>
   /// </remarks>
-  public static List<PipelineNode> SliceNodes(
-    List<PipelineNode> allNodes,
-    PipelineSliceStrategy strategy
-  )
+  public static List<FlowStep> SliceSteps(List<FlowStep> allSteps, FlowSliceStrategy strategy)
   {
     if (!strategy.IsSliced)
     {
-      return allNodes;
+      return allSteps;
     }
 
     // Dependencies are already resolved by Pipeline.Build() before slicing
     // No need to call BuildProducerMap/ResolveDependencies here
 
-    var nodesByLabel = allNodes.ToDictionary(n => n.Label, StringComparer.OrdinalIgnoreCase);
-    var selectedNodes = new HashSet<PipelineNode>(allNodes);
+    var nodesByLabel = allSteps.ToDictionary(n => n.Label, StringComparer.OrdinalIgnoreCase);
+    var selectedSteps = new HashSet<FlowStep>(allSteps);
 
     // Step 1: Apply pipeline filter (if specified, for merged pipelines)
-    if (strategy.Pipelines is { Count: > 0 })
+    if (strategy.Flows is { Count: > 0 })
     {
-      var pipelineFilter = new HashSet<PipelineNode>();
+      var pipelineFilter = new HashSet<FlowStep>();
 
-      foreach (var pipelineName in strategy.Pipelines)
+      foreach (var pipelineName in strategy.Flows)
       {
-        // Find nodes that belong to this pipeline (prefix match: "PipelineName.NodeName")
-        var pipelineNodes = allNodes.Where(n =>
+        // Find nodes that belong to this pipeline (prefix match: "FlowName.StepName")
+        var pipelineSteps = allSteps.Where(n =>
         {
           var dotIndex = n.Label.IndexOf('.');
           if (dotIndex <= 0)
@@ -253,27 +250,27 @@ PipelineSliceStrategy strategy
             return false; // Not a merged pipeline node
           }
 
-          var nodePipelineName = n.Label.Substring(0, dotIndex);
-          return nodePipelineName.Equals(pipelineName, StringComparison.OrdinalIgnoreCase);
+          var nodeFlowName = n.Label.Substring(0, dotIndex);
+          return nodeFlowName.Equals(pipelineName, StringComparison.OrdinalIgnoreCase);
         });
 
-        pipelineFilter.UnionWith(pipelineNodes);
+        pipelineFilter.UnionWith(pipelineSteps);
       }
 
       if (pipelineFilter.Count == 0)
       {
         throw new InvalidOperationException(
-          $"Pipelines filter did not match any nodes. Specified: {string.Join(", ", strategy.Pipelines)}"
+          $"Pipelines filter did not match any nodes. Specified: {string.Join(", ", strategy.Flows)}"
         );
       }
 
-      selectedNodes.IntersectWith(pipelineFilter);
+      selectedSteps.IntersectWith(pipelineFilter);
     }
 
     // Step 2: Apply OnlyNodes filter (explicit allowlist + dependencies)
     if (strategy.OnlyNodes is { Count: > 0 })
     {
-      var explicitNodes = new HashSet<PipelineNode>();
+      var explicitSteps = new HashSet<FlowStep>();
       foreach (var nodeName in strategy.OnlyNodes)
       {
         if (!nodesByLabel.TryGetValue(nodeName, out var node))
@@ -282,33 +279,33 @@ PipelineSliceStrategy strategy
             $"OnlyNodes references non-existent node: '{nodeName}'"
           );
         }
-        explicitNodes.Add(node);
+        explicitSteps.Add(node);
       }
 
       // Include all upstream dependencies to maintain runnability
-      var withDependencies = ExpandUpstream(explicitNodes);
-      selectedNodes.IntersectWith(withDependencies);
+      var withDependencies = ExpandUpstream(explicitSteps);
+      selectedSteps.IntersectWith(withDependencies);
     }
 
     // Step 3: Apply FromData (find consumers, expand downstream)
-    var fromNodesExpanded = new HashSet<PipelineNode>();
+    var fromStepsExpanded = new HashSet<FlowStep>();
     if (strategy.FromData is { Count: > 0 })
     {
       // Find nodes that consume any of the specified catalog entries
       foreach (var dataLabel in strategy.FromData)
       {
-        var consumingNodes = allNodes.Where(n =>
+        var consumingSteps = allSteps.Where(n =>
           n.Inputs.Any(entry => entry.Label.Equals(dataLabel, StringComparison.OrdinalIgnoreCase))
         );
 
-        if (!consumingNodes.Any())
+        if (!consumingSteps.Any())
         {
           throw new InvalidOperationException(
             $"FromData references catalog entry '{dataLabel}' which is not consumed by any node"
           );
         }
 
-        fromNodesExpanded.UnionWith(consumingNodes);
+        fromStepsExpanded.UnionWith(consumingSteps);
       }
     }
 
@@ -323,35 +320,35 @@ PipelineSliceStrategy strategy
             $"FromNodes references non-existent node: '{nodeName}'"
           );
         }
-        fromNodesExpanded.Add(node);
+        fromStepsExpanded.Add(node);
       }
     }
 
-    if (fromNodesExpanded.Count > 0)
+    if (fromStepsExpanded.Count > 0)
     {
-      var withDownstream = ExpandDownstream(fromNodesExpanded, allNodes);
-      selectedNodes.IntersectWith(withDownstream);
+      var withDownstream = ExpandDownstream(fromStepsExpanded, allSteps);
+      selectedSteps.IntersectWith(withDownstream);
     }
 
     // Step 5: Apply ToData (find producers, expand upstream)
-    var toNodesExpanded = new HashSet<PipelineNode>();
+    var toStepsExpanded = new HashSet<FlowStep>();
     if (strategy.ToData is { Count: > 0 })
     {
       // Find nodes that produce any of the specified catalog entries
       foreach (var dataLabel in strategy.ToData)
       {
-        var producingNode = allNodes.FirstOrDefault(n =>
+        var producingStep = allSteps.FirstOrDefault(n =>
           n.Outputs.Any(entry => entry.Label.Equals(dataLabel, StringComparison.OrdinalIgnoreCase))
         );
 
-        if (producingNode == null)
+        if (producingStep == null)
         {
           throw new InvalidOperationException(
             $"ToData references catalog entry '{dataLabel}' which is not produced by any node"
           );
         }
 
-        toNodesExpanded.Add(producingNode);
+        toStepsExpanded.Add(producingStep);
       }
     }
 
@@ -366,21 +363,21 @@ PipelineSliceStrategy strategy
             $"ToNodes references non-existent node: '{nodeName}'"
           );
         }
-        toNodesExpanded.Add(node);
+        toStepsExpanded.Add(node);
       }
     }
 
-    if (toNodesExpanded.Count > 0)
+    if (toStepsExpanded.Count > 0)
     {
-      var withUpstream = ExpandUpstream(toNodesExpanded);
-      selectedNodes.IntersectWith(withUpstream);
+      var withUpstream = ExpandUpstream(toStepsExpanded);
+      selectedSteps.IntersectWith(withUpstream);
     }
 
-    var slicedList = selectedNodes.ToList();
+    var slicedList = selectedSteps.ToList();
 
     // Filter each node's dependencies to only include nodes in the sliced set
     // Dependencies pointing outside the slice become external inputs in the sliced context
-    var slicedSet = new HashSet<PipelineNode>(slicedList);
+    var slicedSet = new HashSet<FlowStep>(slicedList);
     foreach (var node in slicedList)
     {
       node.Dependencies.RemoveAll(dep => !slicedSet.Contains(dep));
@@ -392,10 +389,10 @@ PipelineSliceStrategy strategy
   /// <summary>
   /// Expands a set of nodes to include all upstream dependencies (transitive closure).
   /// </summary>
-  private static HashSet<PipelineNode> ExpandUpstream(HashSet<PipelineNode> nodes)
+  private static HashSet<FlowStep> ExpandUpstream(HashSet<FlowStep> nodes)
   {
-    var result = new HashSet<PipelineNode>();
-    var toVisit = new Queue<PipelineNode>(nodes);
+    var result = new HashSet<FlowStep>();
+    var toVisit = new Queue<FlowStep>(nodes);
 
     while (toVisit.Count > 0)
     {
@@ -415,15 +412,15 @@ private static HashSet<PipelineNode> ExpandUpstream(HashSet<PipelineNode> nodes)
   /// <summary>
   /// Expands a set of nodes to include all downstream dependents (transitive closure).
   /// </summary>
-  private static HashSet<PipelineNode> ExpandDownstream(
-    HashSet<PipelineNode> nodes,
-    List<PipelineNode> allNodes
+  private static HashSet<FlowStep> ExpandDownstream(
+    HashSet<FlowStep> nodes,
+    List<FlowStep> allSteps
   )
   {
-    var result = new HashSet<PipelineNode>(nodes);
-    var dependencyMap = BuildDependencyMap(allNodes);
+    var result = new HashSet<FlowStep>(nodes);
+    var dependencyMap = BuildDependencyMap(allSteps);
 
-    var toVisit = new Queue<PipelineNode>(nodes);
+    var toVisit = new Queue<FlowStep>(nodes);
     while (toVisit.Count > 0)
     {
       var current = toVisit.Dequeue();
@@ -445,19 +442,17 @@ List<PipelineNode> allNodes
   /// <summary>
   /// Builds a reverse dependency map (node → nodes that depend on it).
   /// </summary>
-  private static Dictionary<PipelineNode, List<PipelineNode>> BuildDependencyMap(
-    List<PipelineNode> allNodes
-  )
+  private static Dictionary<FlowStep, List<FlowStep>> BuildDependencyMap(List<FlowStep> allSteps)
   {
-    var map = new Dictionary<PipelineNode, List<PipelineNode>>();
+    var map = new Dictionary<FlowStep, List<FlowStep>>();
 
-    foreach (var node in allNodes)
+    foreach (var node in allSteps)
     {
       foreach (var dependency in node.Dependencies)
       {
         if (!map.ContainsKey(dependency))
         {
-          map[dependency] = new List<PipelineNode>();
+          map[dependency] = new List<FlowStep>();
         }
         map[dependency].Add(node);
       }
diff --git a/src/core/Flowthru.Core/Pipelines/DryRunOption.cs b/src/core/Flowthru.Core/Flows/DryRunOption.cs
similarity index 97%
rename from src/core/Flowthru.Core/Pipelines/DryRunOption.cs
rename to src/core/Flowthru.Core/Flows/DryRunOption.cs
index 8851eb43..f9a83ad7 100644
--- a/src/core/Flowthru.Core/Pipelines/DryRunOption.cs
+++ b/src/core/Flowthru.Core/Flows/DryRunOption.cs
@@ -1,4 +1,4 @@
-namespace Flowthru.Pipelines;
+namespace Flowthru.Flows;
 
 /// <summary>
 /// Represents a dry-run configuration. Can be assigned from a <see cref="bool"/>
diff --git a/src/core/Flowthru.Core/Pipelines/ExecutionOptions.cs b/src/core/Flowthru.Core/Flows/ExecutionOptions.cs
similarity index 91%
rename from src/core/Flowthru.Core/Pipelines/ExecutionOptions.cs
rename to src/core/Flowthru.Core/Flows/ExecutionOptions.cs
index 8cc29aee..c5640453 100644
--- a/src/core/Flowthru.Core/Pipelines/ExecutionOptions.cs
+++ b/src/core/Flowthru.Core/Flows/ExecutionOptions.cs
@@ -1,6 +1,6 @@
 using Flowthru.Results;
 
-namespace Flowthru.Pipelines;
+namespace Flowthru.Flows;
 
 /// <summary>
 /// Configuration options for pipeline execution.
@@ -47,7 +47,7 @@ public class ExecutionOptions
   /// <remarks>
   /// Defaults to ConsoleResultFormatter if not specified.
   /// </remarks>
-  public IPipelineResultFormatter? ResultFormatter { get; set; }
+  public IFlowResultFormatter? ResultFormatter { get; set; }
 
   /// <summary>
   /// Optional slicing strategy to apply when executing pipelines.
@@ -56,13 +56,13 @@ public class ExecutionOptions
   /// When provided, only nodes matching the slice strategy will be executed.
   /// Used when slicing flags are provided without a specific pipeline name.
   /// </remarks>
-  public PipelineSliceStrategy? SliceStrategy { get; set; }
+  public FlowSliceStrategy? SliceStrategy { get; set; }
 
   /// <summary>
   /// Gets the configured formatter or creates a default one.
   /// </summary>
   /// <returns>The result formatter to use</returns>
-  internal IPipelineResultFormatter GetFormatter()
+  internal IFlowResultFormatter GetFormatter()
   {
     return ResultFormatter ?? new ConsoleResultFormatter();
   }
diff --git a/src/core/Flowthru.Core/Pipelines/Pipeline.cs b/src/core/Flowthru.Core/Flows/Pipeline.cs
similarity index 62%
rename from src/core/Flowthru.Core/Pipelines/Pipeline.cs
rename to src/core/Flowthru.Core/Flows/Pipeline.cs
index 34613ae5..b6009fa9 100644
--- a/src/core/Flowthru.Core/Pipelines/Pipeline.cs
+++ b/src/core/Flowthru.Core/Flows/Pipeline.cs
@@ -5,104 +5,104 @@
 using Flowthru.Meta.Models;
 using Microsoft.Extensions.Logging;
 
-namespace Flowthru.Pipelines;
+namespace Flowthru.Flows;
 
 /// <summary>
-/// Represents a complete data pipeline with nodes, dependencies, and execution order.
+/// Represents a complete data Flow with steps, dependencies, and execution order.
 /// </summary>
 /// <remarks>
 /// <para>
-/// A pipeline is a directed acyclic graph (DAG) of transformation nodes.
-/// Each node reads data from catalog entries, performs transformations,
+/// A Flow is a directed acyclic graph (DAG) of transformation steps.
+/// Each step reads data from catalog entries, performs transformations,
 /// and writes results back to catalog entries.
 /// </para>
 /// <para>
 /// <strong>Execution Model:</strong>
 /// </para>
 /// <list type="bullet">
-/// <item>Nodes are organized into layers via topological sort</item>
-/// <item>Nodes in layer 0 have no dependencies (read external data only)</item>
-/// <item>Nodes in layer N depend only on nodes in layers 0..N-1</item>
-/// <item>Sequential execution: Execute all nodes in layer order</item>
-/// <item>Parallel execution (Phase 2): Execute nodes within same layer concurrently</item>
+/// <item>Steps are organized into layers via topological sort</item>
+/// <item>Steps in layer 0 have no dependencies (read external data only)</item>
+/// <item>Steps in layer N depend only on steps in layers 0..N-1</item>
+/// <item>Sequential execution: Execute all steps in layer order</item>
+/// <item>Parallel execution (Phase 2): Execute steps within same layer concurrently</item>
 /// </list>
 /// <para>
 /// <strong>Single Producer Rule:</strong> Each catalog entry can be written by at most
-/// one node. This ensures deterministic execution order and prevents race conditions.
+/// one step. This ensures deterministic execution order and prevents race conditions.
 /// </para>
 /// </remarks>
-public class Pipeline
+public class Flow
 {
   /// <summary>
-  /// All nodes in this pipeline, in the order they were added.
+  /// All steps in this flow, in the order they were added.
   /// </summary>
   /// <remarks>
-  /// Exposed as public to enable validation hooks (Phase 4) to inspect nodes.
-  /// The collection is read-only - nodes can only be added via PipelineBuilder.
+  /// Exposed as public to enable validation hooks (Phase 4) to inspect steps.
+  /// The collection is read-only - steps can only be added via FlowBuilder.
   /// </remarks>
-  public IReadOnlyList<PipelineNode> Nodes => _nodes.AsReadOnly();
+  public IReadOnlyList<FlowStep> Steps => _steps.AsReadOnly();
 
   /// <summary>
-  /// Internal accessor for the mutable node list. Used by pipeline internals.
+  /// Internal accessor for the mutable step list. Used by Flow internals.
   /// </summary>
-  internal List<PipelineNode> NodesList => _nodes;
+  internal List<FlowStep> StepsList => _steps;
 
-  private readonly List<PipelineNode> _nodes = new();
+  private readonly List<FlowStep> _steps = new();
 
   /// <summary>
-  /// Subset of nodes to execute after slicing is applied.
-  /// Null if no slicing was applied (execute all nodes).
+  /// Subset of steps to execute after slicing is applied.
+  /// Null if no slicing was applied (execute all steps).
   /// </summary>
-  private List<PipelineNode>? _slicedNodes;
+  private List<FlowStep>? _slicedSteps;
 
   /// <summary>
-  /// Nodes grouped by execution layer.
+  /// Steps grouped by execution layer.
   /// Populated after Build() is called.
   /// </summary>
-  internal IReadOnlyList<List<PipelineNode>>? ExecutionLayers { get; private set; }
+  internal IReadOnlyList<List<FlowStep>>? ExecutionLayers { get; private set; }
 
   /// <summary>
   /// The slice strategy applied during the most recent Build() call, if any.
   /// </summary>
   /// <remarks>
   /// Cached to enable metadata export to include slice criteria.
-  /// Null if pipeline was built without slicing.
+  /// Null if Flow was built without slicing.
   /// </remarks>
-  internal PipelineSliceStrategy? AppliedSlice { get; private set; }
+  internal FlowSliceStrategy? AppliedSlice { get; private set; }
 
   /// <summary>
-  /// Optional logger for pipeline execution.
+  /// Optional logger for Flow execution.
   /// </summary>
   public ILogger? Logger { get; set; }
 
   /// <summary>
-  /// Optional service provider for dependency injection into nodes.
+  /// Optional service provider for dependency injection into steps.
   /// </summary>
   /// <remarks>
-  /// Set by the service layer before pipeline execution to enable nodes
+  /// Set by the service layer before Flow execution to enable steps
   /// to resolve services (e.g., database connections, external APIs).
   /// </remarks>
   public IServiceProvider? ServiceProvider { get; set; }
 
   /// <summary>
-  /// Pipeline name for identification and logging.
+  /// Flow name for identification and logging.
   /// </summary>
   /// <remarks>
-  /// Set by PipelineRegistry during pipeline registration.
+  /// Set by FlowRegistry during Flow registration.
   /// </remarks>
   public string? Name { get; internal set; }
 
   /// <summary>
-  /// Optional description of what this pipeline does.
+  /// Optional description of what this Flow does.
   /// </summary>
   public string? Description { get; internal set; }
 
   /// <summary>
-  /// Validation options for this pipeline.
+  /// Validation options for this flow.
   /// </summary>
   /// <remarks>
   /// Configures how external data sources (Layer 0 inputs) are validated
-  /// before pipeline execution begins.
+  /// before Flow execution begins.
   /// </remarks>
   public Validation.ValidationOptions ValidationOptions { get; internal set; } =
     Validation.ValidationOptions.Default();
@@ -112,208 +112,208 @@ public class Pipeline
   /// </summary>
   /// <remarks>
   /// <para>
-  /// Extensions can register hooks to validate their own node types during pre-flight.
+  /// Extensions can register hooks to validate their own step types during pre-flight.
   /// Hooks are invoked after DAG analysis but before external input inspection.
   /// </para>
   /// <para>
   /// <strong>Hook execution order:</strong>
   /// </para>
   /// <list type="number">
-  /// <item>Pipeline.Build() - DAG construction and layer assignment</item>
+  /// <item>Flow.Build() - DAG construction and layer assignment</item>
   /// <item>ValidationHooks.ValidateAsync() - Extension-specific validation</item>
-  /// <item>Pipeline.ValidateExternalInputsAsync() - External input inspection</item>
+  /// <item>Flow.ValidateExternalInputsAsync() - External input inspection</item>
   /// </list>
   /// <para>
   /// <strong>Example (Python extension):</strong>
   /// </para>
   /// <code>
-  /// pipeline.ValidationHooks.Add(new PythonNodeValidator(executor, runtime));
+  /// flow.ValidationHooks.Add(new PythonStepValidator(executor, runtime));
   /// </code>
   /// </remarks>
-  public List<Validation.IPipelineValidationHook> ValidationHooks { get; } = new();
+  public List<Validation.IFlowValidationHook> ValidationHooks { get; } = new();
 
   /// <summary>
-  /// Indicates whether the pipeline has been built (dependencies analyzed and layers assigned).
+  /// Indicates whether the Flow has been built (dependencies analyzed and layers assigned).
   /// </summary>
   public bool IsBuilt => ExecutionLayers != null;
 
   /// <summary>
-  /// Gets the sliced subset of nodes (if slicing was applied), otherwise null.
+  /// Gets the sliced subset of steps (if slicing was applied), otherwise null.
   /// </summary>
   /// <remarks>
-  /// Used by metadata export to ensure only nodes that will execute are included in the DAG.
+  /// Used by metadata export to ensure only steps that will execute are included in the DAG.
   /// </remarks>
-  internal List<PipelineNode>? GetSlicedNodes() => _slicedNodes;
+  internal List<FlowStep>? GetSlicedSteps() => _slicedSteps;
 
   /// <summary>
-  /// Adds a node to the pipeline.
+  /// Adds a step to the flow.
   /// </summary>
-  /// <param name="node">The pipeline node to add</param>
-  /// <exception cref="InvalidOperationException">Thrown if pipeline has already been built</exception>
-  internal void AddNode(PipelineNode node)
+  /// <param name="step">The Flow step to add</param>
+  /// <exception cref="InvalidOperationException">Thrown if Flow has already been built</exception>
+  internal void AddStep(FlowStep step)
   {
     if (IsBuilt)
     {
       throw new InvalidOperationException(
-        "Cannot add nodes to a pipeline that has already been built. "
-          + "Create a new pipeline or use PipelineBuilder."
+        "Cannot add steps to a flow that has already been built. "
+          + "Create a new flow or use FlowBuilder."
       );
     }
 
-    _nodes.Add(node);
+    _steps.Add(step);
   }
 
   /// <summary>
-  /// Merges multiple pipelines into a single pipeline by combining all their nodes.
+  /// Merges multiple flows into a single Flow by combining all their steps.
   /// </summary>
-  /// <param name="pipelines">Dictionary of pipeline names to pipeline instances</param>
-  /// <returns>A new pipeline containing all nodes from all input pipelines</returns>
+  /// <param name="flows">Dictionary of flow names to Flow instances</param>
+  /// <returns>A new Flow containing all steps from all input flows</returns>
   /// <remarks>
   /// <para>
-  /// This method creates a new pipeline by combining all nodes from the input pipelines.
-  /// Node names are prefixed with their source pipeline name (e.g., "data_processing.PreprocessCompanies")
+  /// This method creates a new Flow by combining all steps from the input flows.
+  /// Step names are prefixed with their source Flow name (e.g., "data_processing.PreprocessCompanies")
   /// to ensure uniqueness and maintain traceability in logs.
   /// </para>
   /// <para>
-  /// The existing DependencyAnalyzer will automatically resolve cross-pipeline dependencies
-  /// based on catalog entries. The single producer rule is enforced - if multiple pipelines
+  /// The existing DependencyAnalyzer will automatically resolve cross-flow dependencies
+  /// based on catalog entries. The single producer rule is enforced - if multiple flows
   /// attempt to write to the same catalog entry, Build() will throw an InvalidOperationException.
   /// </para>
   /// </remarks>
-  public static Pipeline Merge(Dictionary<string, Pipeline> pipelines)
+  public static Flow Merge(Dictionary<string, Flow> flows)
   {
-    var mergedPipeline = new Pipeline
+    var mergedFlows = new Flow
     {
-      Name = "Pipelines",
-      Description = $"Combined execution of: {string.Join(", ", pipelines.Keys)}",
+      Name = "Flows",
+      Description = $"Combined execution of: {string.Join(", ", flows.Keys)}",
     };
 
-    // Combine all nodes from all pipelines, prefixing node names with pipeline name
-    foreach (var (pipelineName, pipeline) in pipelines)
+    // Combine all steps from all flows, prefixing step names with Flow name
+    foreach (var (flowName, flow) in flows)
     {
-      foreach (var node in pipeline.Nodes)
+      foreach (var step in flow.Steps)
       {
-        // Create a new node with prefixed name
-        var prefixedNode = new PipelineNode(
-          label: $"{pipelineName}.{node.Label}",
-          description: node.Description,
-          node: node.TransformFunction,
-          inputs: node.Inputs,
-          outputs: node.Outputs
+        // Create a new step with prefixed name
+        var prefixedStep = new FlowStep(
+          label: $"{flowName}.{step.Label}",
+          description: step.Description,
+          step: step.TransformFunction,
+          inputs: step.Inputs,
+          outputs: step.Outputs
         );
 
-        mergedPipeline.AddNode(prefixedNode);
+        mergedFlows.AddStep(prefixedStep);
       }
     }
 
-    return mergedPipeline;
+    return mergedFlows;
   }
 
   /// <summary>
-  /// Builds the pipeline by analyzing dependencies and assigning execution layers.
-  /// Must be called before executing the pipeline.
+  /// Builds the Flow by analyzing dependencies and assigning execution layers.
+  /// Must be called before executing the flow.
   /// </summary>
-  /// <param name="sliceStrategy">Optional slicing strategy to filter nodes before execution</param>
+  /// <param name="sliceStrategy">Optional slicing strategy to filter steps before execution</param>
   /// <exception cref="InvalidOperationException">
   /// Thrown if:
-  /// - Multiple nodes write to the same catalog entry (single producer rule)
+  /// - Multiple steps write to the same catalog entry (single producer rule)
   /// - Circular dependency is detected
-  /// - Slice strategy references non-existent nodes or catalog entries
+  /// - Slice strategy references non-existent steps or catalog entries
   /// </exception>
   /// <remarks>
   /// <para>
-  /// <strong>Slicing:</strong> If a slicing strategy is provided, only nodes matching
+  /// <strong>Slicing:</strong> If a slicing strategy is provided, only steps matching
   /// the strategy will be included in the execution. The slice always forms a valid
   /// sub-DAG with all required dependencies.
   /// </para>
   /// </remarks>
-  public void Build(PipelineSliceStrategy? sliceStrategy = null)
+  public void Build(FlowSliceStrategy? sliceStrategy = null)
   {
     if (IsBuilt)
     {
-      Logger?.LogWarning("Pipeline.Build() called on already-built pipeline. Rebuilding...");
+      Logger?.LogWarning("Flow.Build() called on already-built flow. Rebuilding...");
     }
 
-    Logger?.LogInformation("Building pipeline with {NodeCount} nodes", _nodes.Count);
+    Logger?.LogInformation("Building flow with {StepCount} steps", _steps.Count);
 
     // Cache the slice strategy for metadata export
     AppliedSlice = sliceStrategy?.IsSliced == true ? sliceStrategy : null;
 
-    // Step 1: Build dependency graph on the FULL node set
+    // Step 1: Build dependency graph on the FULL step set
     // This must happen before slicing, as slicing logic traverses dependencies
-    DependencyAnalyzer.BuildDependencyGraph(_nodes);
+    DependencyAnalyzer.BuildDependencyGraph(_steps);
 
     // Step 2: Apply slicing if requested
     if (sliceStrategy?.IsSliced == true)
     {
-      Logger?.LogInformation("Applying pipeline slice strategy");
-      _slicedNodes = DependencyAnalyzer.SliceNodes(_nodes, sliceStrategy);
+      Logger?.LogInformation("Applying flow slice strategy");
+      _slicedSteps = DependencyAnalyzer.SliceSteps(_steps, sliceStrategy);
       Logger?.LogInformation(
-        "Slice reduced pipeline from {OriginalCount} to {SlicedCount} nodes",
-        _nodes.Count,
-        _slicedNodes.Count
+        "Slice reduced flow from {OriginalCount} to {SlicedCount} steps",
+        _steps.Count,
+        _slicedSteps.Count
       );
     }
     else
     {
-      _slicedNodes = null; // No slicing - execute all nodes
+      _slicedSteps = null; // No slicing - execute all steps
     }
 
-    // Step 3: Assign execution layers to the final node set (sliced or full)
+    // Step 3: Assign execution layers to the final step set (sliced or full)
     // This ensures Layer 0 correctly identifies external inputs in the execution context
-    var nodesToExecute = _slicedNodes ?? _nodes;
-    DependencyAnalyzer.AssignLayers(nodesToExecute);
+    var stepsToExecute = _slicedSteps ?? _steps;
+    DependencyAnalyzer.AssignLayers(stepsToExecute);
 
-    // Step 4: Group nodes by layer for execution
-    ExecutionLayers = DependencyAnalyzer.GroupByLayer(nodesToExecute).ToList();
+    // Step 4: Group steps by layer for execution
+    ExecutionLayers = DependencyAnalyzer.GroupByLayer(stepsToExecute).ToList();
 
     Logger?.LogInformation(
-      "Pipeline built successfully. Execution will proceed in {LayerCount} layers",
+      "Flow built successfully. Execution will proceed in {LayerCount} layers",
       ExecutionLayers.Count
     );
 
     // Log layer details
     for (int i = 0; i < ExecutionLayers.Count; i++)
     {
-      var layerNodes = ExecutionLayers[i];
+      var layerSteps = ExecutionLayers[i];
       Logger?.LogDebug(
-        "Layer {LayerIndex}: {NodeCount} nodes ({NodeNames})",
+        "Layer {LayerIndex}: {StepCount} steps ({StepNames})",
         i,
-        layerNodes.Count,
-        string.Join(", ", layerNodes.Select(n => n.Label))
+        layerSteps.Count,
+        string.Join(", ", layerSteps.Select(n => n.Label))
       );
     }
   }
 
   /// <summary>
-  /// Exports DAG metadata for this pipeline.
+  /// Exports DAG metadata for this Flow.
   /// </summary>
-  /// <returns>Complete DAG metadata including nodes, catalog entries, and edges</returns>
-  /// <exception cref="InvalidOperationException">Thrown if pipeline has not been built</exception>
+  /// <returns>Complete DAG metadata including steps, catalog entries, and edges</returns>
+  /// <exception cref="InvalidOperationException">Thrown if Flow has not been built</exception>
   /// <remarks>
   /// <para>
-  /// This method extracts structural metadata from the built pipeline, creating
+  /// This method extracts structural metadata from the built Flow , creating
   /// a complete representation of the DAG (Directed Acyclic Graph) that can be
   /// serialized to JSON for visualization in Flowthru.Viz.
   /// </para>
   /// <para>
-  /// <strong>Prerequisites:</strong> Pipeline must be built before calling this method.
+  /// <strong>Prerequisites:</strong> Flow must be built before calling this method.
   /// Call Build() first if IsBuilt is false.
   /// </para>
   /// <para>
   /// <strong>Usage:</strong>
   /// </para>
   /// <code>
-  /// var pipeline = DataProcessingPipeline.Create(catalog);
-  /// pipeline.Build();
+  /// var Flow = DataProcessingFlow.Create(catalog);
+  /// flow.Build();
   ///
-  /// var dag = pipeline.ExportDag();
+  /// var dag = flow.ExportDag();
   /// var json = dag.ToJson();
   /// File.WriteAllText("dag.json", json);
   /// </code>
   /// <para>
   /// This method is non-destructive and idempotent - it can be called multiple
-  /// times without affecting the pipeline state.
+  /// times without affecting the Flow state.
   /// </para>
   /// </remarks>
   public DagMetadata ExportDag()
@@ -321,34 +321,31 @@ public DagMetadata ExportDag()
     if (!IsBuilt)
     {
       throw new InvalidOperationException(
-        "Cannot export DAG metadata from an unbuilt pipeline. Call Build() first."
+        "Cannot export DAG metadata from an unbuilt flow. Call Build() first."
       );
     }
 
-    Logger?.LogDebug(
-      "Exporting DAG metadata for pipeline '{PipelineName}'",
-      Name ?? "UnnamedPipeline"
-    );
+    Logger?.LogDebug("Exporting DAG metadata for flow '{FlowName}'", Name ?? "UnnamedFlow");
 
     return DagBuilder.Build(this);
   }
 
   /// <summary>
-  /// Validates all external inputs before pipeline execution.
+  /// Validates all external inputs before Flow execution.
   /// </summary>
   /// <param name="cancellationToken">Cancellation token for validation I/O operations</param>
   /// <returns>ValidationResult containing any errors found</returns>
-  /// <exception cref="InvalidOperationException">Thrown if pipeline has not been built</exception>
+  /// <exception cref="InvalidOperationException">Thrown if Flow has not been built</exception>
   /// <remarks>
   /// <para>
-  /// This method inspects catalog entries that are consumed by the pipeline but not
-  /// produced by any node in the execution set. These are pre-existing external data
-  /// sources (files, databases, APIs) that must exist and be valid before the pipeline
+  /// This method inspects catalog entries that are consumed by the Flow but not
+  /// produced by any step in the execution set. These are pre-existing external data
+  /// sources (files, databases, APIs) that must exist and be valid before the flow
   /// can execute.
   /// </para>
   /// <para>
-  /// <strong>Slicing Support:</strong> In sliced pipelines, catalog entries that were
-  /// produced by nodes outside the slice are correctly identified as external inputs
+  /// <strong>Slicing Support:</strong> In sliced flows, catalog entries that were
+  /// produced by steps outside the slice are correctly identified as external inputs
   /// and validated. This prevents runtime failures from missing intermediate data.
   /// </para>
   /// <para>
@@ -368,20 +365,20 @@ public DagMetadata ExportDag()
   /// <item>Otherwise → Shallow (all storage adapters support inspection)</item>
   /// </list>
   /// <para>
-  /// <strong>Important:</strong> Only external inputs are inspected. Intermediate pipeline
+  /// <strong>Important:</strong> Only external inputs are inspected. Intermediate flow
   /// outputs produced within the execution set are never inspected, as they don't exist yet.
   /// </para>
   /// <para>
   /// <strong>Usage:</strong>
   /// </para>
   /// <code>
-  /// pipeline.Build();
-  /// var validationResult = await pipeline.ValidateExternalInputsAsync();
+  /// flow.Build();
+  /// var validationResult = await flow.ValidateExternalInputsAsync();
   /// if (!validationResult.IsValid) {
   ///   // Handle validation errors before execution
   ///   validationResult.ThrowIfInvalid();
   /// }
-  /// await pipeline.RunAsync();
+  /// await flow.RunAsync();
   /// </code>
   /// </remarks>
   public async Task<Data.Validation.ValidationResult> ValidateExternalInputsAsync(
@@ -391,20 +388,20 @@ public DagMetadata ExportDag()
     if (!IsBuilt)
     {
       throw new InvalidOperationException(
-        "Pipeline must be built before validation. Call Build() first."
+        "Flow must be built before validation. Call Build() first."
       );
     }
 
     var result = Data.Validation.ValidationResult.Success();
 
-    // No nodes? No validation needed
+    // No steps? No validation needed
     if (ExecutionLayers!.Count == 0)
     {
-      Logger?.LogInformation("No nodes in pipeline, nothing to validate");
+      Logger?.LogInformation("No steps in flow, nothing to validate");
       return result;
     }
 
-    // Phase 4: Invoke validation hooks (e.g., Python node validation)
+    // Phase 4: Invoke validation hooks (e.g., Python step validation)
     if (ValidationHooks.Count > 0)
     {
       Logger?.LogInformation("Running {HookCount} validation hook(s)", ValidationHooks.Count);
@@ -447,17 +444,17 @@ public DagMetadata ExportDag()
       }
     }
 
-    // Build a set of catalog entries produced by nodes in the execution set
-    var nodesToExecute = ExecutionLayers.SelectMany(layer => layer).ToList();
+    // Build a set of catalog entries produced by stepsin the execution set
+    var stepsToExecute = ExecutionLayers.SelectMany(layer => layer).ToList();
     var producedEntries = new HashSet<string>(
-      nodesToExecute.SelectMany(node => node.Outputs.Select(entry => entry.Label)),
+      stepsToExecute.SelectMany(step => step.Outputs.Select(entry => entry.Label)),
       StringComparer.OrdinalIgnoreCase
     );
 
-    // Find all catalog entries consumed by nodes that are NOT produced by any node
-    // These are external inputs in the execution context (including sliced pipelines)
-    var externalInputs = nodesToExecute
-      .SelectMany(node => node.Inputs)
+    // Find all catalog entries consumed by steps that are NOT produced by any steps
+    // These are external inputs in the execution context (including sliced flows)
+    var externalInputs = stepsToExecute
+      .SelectMany(step => step.Inputs)
       .Where(entry => !producedEntries.Contains(entry.Label))
       .DistinctBy(entry => entry.Label)
       .ToList();
@@ -553,53 +550,53 @@ public DagMetadata ExportDag()
   }
 
   /// <summary>
-  /// /// Builds and executes the pipeline, returning comprehensive execution results.
+  /// /// Builds and executes the flow, returning comprehensive execution results.
   /// </summary>
   /// <param name="cancellationToken">Cancellation token to signal graceful shutdown</param>
-  /// <returns>PipelineResult containing execution status, timing, and node results</returns>
+  /// <returns>FlowResult containing execution status, timing, and Flow results</returns>
   /// <remarks>
   /// <para>
-  /// This is the primary high-level API for executing pipelines. It automatically
-  /// calls Build() if the pipeline hasn't been built yet, then executes and tracks results.
+  /// This is the primary high-level API for executing flows. It automatically
+  /// calls Build() if the Flow hasn't been built yet, then executes and tracks results.
   /// </para>
   /// </remarks>
-  public async Task<PipelineResult> RunAsync(CancellationToken cancellationToken)
+  public async Task<FlowResult> RunAsync(CancellationToken cancellationToken)
   {
     var stopwatch = Stopwatch.StartNew();
-    var nodeResults = new Dictionary<string, NodeResult>();
+    var stepResults = new Dictionary<string, StepResult>();
 
     try
     {
-      // Ensure pipeline is built
+      // Ensure Flow is built
       if (!IsBuilt)
       {
-        Logger?.LogInformation("Building pipeline before execution");
+        Logger?.LogInformation("Building flow before execution");
         Build();
       }
 
-      Logger?.LogInformation("Starting pipeline execution via RunAsync()");
+      Logger?.LogInformation("Starting flow execution via RunAsync()");
 
       // Execute all layers
       foreach (var layer in ExecutionLayers!)
       {
-        Logger?.LogInformation("Executing layer with {NodeCount} nodes", layer.Count);
+        Logger?.LogInformation("Executing layer with {StepCount} steps", layer.Count);
 
-        foreach (var pipelineNode in layer)
+        foreach (var flowStep in layer)
         {
-          // Check for cancellation before starting each node
+          // Check for cancellation before starting each step
           cancellationToken.ThrowIfCancellationRequested();
 
-          var nodeResult = await ExecuteNodeWithTrackingAsync(pipelineNode, cancellationToken);
-          nodeResults[pipelineNode.Label] = nodeResult;
+          var stepResult = await ExecuteStepWithTrackingAsync(flowStep, cancellationToken);
+          stepResults[flowStep.Label] = stepResult;
 
-          // If node failed, stop execution
-          if (!nodeResult.Success)
+          // If step failed, stop execution
+          if (!stepResult.Success)
           {
             stopwatch.Stop();
-            return PipelineResult.CreateFailure(
+            return FlowResult.CreateFailure(
               stopwatch.Elapsed,
-              nodeResult.Exception!,
-              nodeResults,
+              stepResult.Exception!,
+              stepResults,
               Name
             );
           }
@@ -608,11 +605,11 @@ public async Task<PipelineResult> RunAsync(CancellationToken cancellationToken)
 
       stopwatch.Stop();
       Logger?.LogInformation(
-        "Pipeline execution completed successfully in {ElapsedMs}ms",
+        "Flow execution completed successfully in {ElapsedMs}ms",
         stopwatch.ElapsedMilliseconds
       );
 
-      return PipelineResult.CreateSuccess(stopwatch.Elapsed, nodeResults, Name);
+      return FlowResult.CreateSuccess(stopwatch.Elapsed, stepResults, Name);
     }
     catch (OperationCanceledException)
     {
@@ -624,22 +621,22 @@ public async Task<PipelineResult> RunAsync(CancellationToken cancellationToken)
     catch (Exception ex)
     {
       stopwatch.Stop();
-      Logger?.LogError(ex, "Pipeline execution failed: {ErrorMessage}", ex.Message);
-      return PipelineResult.CreateFailure(stopwatch.Elapsed, ex, nodeResults, Name);
+      Logger?.LogError(ex, "Flow execution failed: {ErrorMessage}", ex.Message);
+      return FlowResult.CreateFailure(stopwatch.Elapsed, ex, stepResults, Name);
     }
   }
 
   /// <summary>
-  /// Executes the pipeline sequentially, layer by layer.
+  /// Executes the Flow sequentially, layer by layer.
   /// </summary>
   /// <param name="cancellationToken">Cancellation token to signal graceful shutdown</param>
-  /// <returns>Task representing the pipeline execution</returns>
-  /// <exception cref="InvalidOperationException">Thrown if pipeline has not been built</exception>
+  /// <returns>Task representing the Flow execution</returns>
+  /// <exception cref="InvalidOperationException">Thrown if Flow has not been built</exception>
   /// <remarks>
   /// <para>
-  /// This method executes nodes in topological order:
-  /// 1. Execute all nodes in layer 0 sequentially
-  /// 2. Execute all nodes in layer 1 sequentially
+  /// This method executes Flow in topological order:
+  /// 1. Execute all Flow in layer 0 sequentially
+  /// 2. Execute all Flow in layer 1 sequentially
   /// 3. Continue until all layers are complete
   /// </para>
   /// <para>
@@ -648,7 +645,7 @@ public async Task<PipelineResult> RunAsync(CancellationToken cancellationToken)
   /// </para>
   /// <para>
   /// In Phase 2, this will be replaced with a parallel executor that can run
-  /// nodes within the same layer concurrently.
+  /// steps within the same layer concurrently.
   /// </para>
   /// </remarks>
   public async Task ExecuteAsync(CancellationToken cancellationToken)
@@ -656,50 +653,50 @@ public async Task ExecuteAsync(CancellationToken cancellationToken)
     if (!IsBuilt)
     {
       throw new InvalidOperationException(
-        "Pipeline must be built before execution. Call Build() first."
+        "Flow must be built before execution. Call Build() first."
       );
     }
 
-    Logger?.LogInformation("Starting pipeline execution");
+    Logger?.LogInformation("Starting flow execution");
 
     try
     {
       foreach (var layer in ExecutionLayers!)
       {
-        Logger?.LogInformation("Executing layer with {NodeCount} nodes", layer.Count);
+        Logger?.LogInformation("Executing layer with {StepCount} steps", layer.Count);
 
-        foreach (var pipelineNode in layer)
+        foreach (var flowStep in layer)
         {
-          // Check for cancellation before starting each node
+          // Check for cancellation before starting each step
           cancellationToken.ThrowIfCancellationRequested();
 
-          await ExecuteNodeAsync(pipelineNode, cancellationToken);
+          await ExecuteStepAsync(flowStep, cancellationToken);
         }
       }
 
-      Logger?.LogInformation("Pipeline execution completed successfully");
+      Logger?.LogInformation("Flow execution completed successfully");
     }
     catch (Exception ex)
     {
-      Logger?.LogError(ex, "Pipeline execution failed: {ErrorMessage}", ex.Message);
+      Logger?.LogError(ex, "Flow execution failed: {ErrorMessage}", ex.Message);
       throw;
     }
   }
 
   /// <summary>
-  /// Determines whether a node's transformation function accepts a CancellationToken parameter.
+  /// Determines whether a step's transformation function accepts a CancellationToken parameter.
   /// </summary>
   /// <param name="transformFunc">The transformation function delegate</param>
   /// <returns>True if the function accepts a CancellationToken as its last parameter</returns>
   /// <remarks>
-  /// Supports optional cancellation awareness in node functions. Nodes can opt-in to cancellation
+  /// Supports optional cancellation awareness in step functions. Steps can opt-in to cancellation
   /// by accepting a CancellationToken as the last parameter:
   /// <list type="bullet">
   /// <item>Func&lt;TIn, CancellationToken, Task&lt;TOut&gt;&gt; - single input with cancellation</item>
   /// <item>Func&lt;(TIn1, TIn2), CancellationToken, Task&lt;TOut&gt;&gt; - multi-input with cancellation</item>
   /// </list>
   /// </remarks>
-  private static bool NodeAcceptsCancellationToken(Delegate transformFunc)
+  private static bool StepAcceptsCancellationToken(Delegate transformFunc)
   {
     var invokeMethod = transformFunc.GetType().GetMethod("Invoke");
     var parameters = invokeMethod!.GetParameters();
@@ -709,13 +706,13 @@ private static bool NodeAcceptsCancellationToken(Delegate transformFunc)
   }
 
   /// <summary>
-  /// Executes a single node with execution tracking and returns detailed results.
+  /// Executes a single step with execution tracking and returns detailed results.
   /// </summary>
-  /// <param name="pipelineNode">The node to execute</param>
+  /// <param name="flowStep">The step to execute</param>
   /// <param name="cancellationToken">Cancellation token for I/O operations</param>
-  /// <returns>NodeResult with execution details</returns>
-  private async Task<NodeResult> ExecuteNodeWithTrackingAsync(
-    PipelineNode pipelineNode,
+  /// <returns>StepResult with execution details</returns>
+  private async Task<StepResult> ExecuteStepWithTrackingAsync(
+    FlowStep flowStep,
     CancellationToken cancellationToken
   )
   {
@@ -724,35 +721,35 @@ CancellationToken cancellationToken
     try
     {
       // Get input counts for diagnostics (before loading data)
-      var inputCountAffs = pipelineNode.Inputs.Select(entry => entry.GetCountAsync());
+      var inputCountAffs = flowStep.Inputs.Select(entry => entry.GetCountAsync());
       var inputCountTasks = inputCountAffs.Select(aff => aff.Run(cancellationToken).AsTask());
       var inputCountResults = await Task.WhenAll(inputCountTasks);
       var inputCounts = inputCountResults;
       var totalInputCount = inputCounts.Sum();
 
       Logger?.LogInformation(
-        "Executing node: {NodeName} (inputs: {InputCount} observations from {EntryCount} entries)",
-        pipelineNode.Label,
+        "Executing step: {StepName} (inputs: {InputCount} observations from {EntryCount} entries)",
+        flowStep.Label,
         totalInputCount,
-        pipelineNode.Inputs.Count
+        flowStep.Inputs.Count
       );
 
       // Load inputs from catalog entries
       // LoadUntyped() returns T directly (singleton or collection), no wrapping needed
-      var inputAffs = pipelineNode.Inputs.Select(entry => entry.LoadUntyped());
+      var inputAffs = flowStep.Inputs.Select(entry => entry.LoadUntyped());
       var inputLoadTasks = inputAffs.Select(aff => aff.Run(cancellationToken).AsTask());
       var inputResults = await Task.WhenAll(inputLoadTasks);
       var inputs = inputResults;
 
       // Prepare input parameter for function invocation
-      // For single-input nodes: pass data directly (T)
-      // For multi-input nodes: construct tuple (T1, T2, ...) or pass as object[] for fan-in
+      // For single-input steps: pass data directly (T)
+      // For multi-input steps: construct tuple (T1, T2, ...) or pass as object[] for fan-in
       object inputParameter;
-      if (pipelineNode.Inputs.Count == 1)
+      if (flowStep.Inputs.Count == 1)
       {
         // Single input: pass data directly, unless this is a fan-in wrapper (Func<object[], TOut>)
-        // in which case the node still expects an object[] even with a single entry.
-        var singleFuncType = pipelineNode.TransformFunction.GetType();
+        // in which case the step still expects an object[] even with a single entry.
+        var singleFuncType = flowStep.TransformFunction.GetType();
         var singleParams = singleFuncType.GetMethod("Invoke")!.GetParameters();
         if (singleParams.Length == 1 && singleParams[0].ParameterType == typeof(object[]))
           inputParameter = (object)inputs; // fan-in wrapper with single shard
@@ -761,16 +758,16 @@ CancellationToken cancellationToken
       }
       else
       {
-        // Multi-input: construct tuple from loaded values, or pass as object[] for fan-in nodes.
+        // Multi-input: construct tuple from loaded values, or pass as object[] for fan-in steps.
         // Use the function's actual parameter type to ensure correct tuple signature.
-        var funcType = pipelineNode.TransformFunction.GetType();
+        var funcType = flowStep.TransformFunction.GetType();
         var invokeMethod = funcType.GetMethod("Invoke");
         var parameters = invokeMethod!.GetParameters();
 
         if (parameters.Length != 1)
         {
           throw new InvalidOperationException(
-            $"Transform function for node {pipelineNode.Label} should have exactly 1 parameter (tuple), but has {parameters.Length}"
+            $"Transform function for step {flowStep.Label} should have exactly 1 parameter (tuple), but has {parameters.Length}"
           );
         }
 
@@ -778,7 +775,7 @@ CancellationToken cancellationToken
 
         if (paramType == typeof(object[]))
         {
-          // Fan-in node: the PipelineBuilder wraps Func<IReadOnlyList<TIn>, TOut> into
+          // Fan-in step: the FlowBuilder wraps Func<IReadOnlyList<TIn>, TOut> into
           // Func<object[], TOut>. Pass the loaded array as a single boxed object so
           // DynamicInvoke receives new object[]{ inputs } — no array-spreading occurs.
           inputParameter = (object)inputs;
@@ -799,7 +796,7 @@ CancellationToken cancellationToken
           catch (Exception ex)
           {
             throw new InvalidOperationException(
-              $"Failed to create {inputs.Length}-tuple for node {pipelineNode.Label}. "
+              $"Failed to create {inputs.Length}-tuple for step {flowStep.Label}. "
                 + $"Expected tuple type: {tupleType.FullName}, Input types: [{string.Join(", ", inputs.Select(v => v?.GetType().Name ?? "null"))}]",
               ex
             );
@@ -808,10 +805,10 @@ CancellationToken cancellationToken
       }
 
       // Invoke transformation function directly via DynamicInvoke
-      // Pass cancellation token if the node signature accepts it
-      var transformFunc = pipelineNode.TransformFunction;
+      // Pass cancellation token if the step signature accepts it
+      var transformFunc = flowStep.TransformFunction;
       object? result;
-      if (NodeAcceptsCancellationToken(transformFunc))
+      if (StepAcceptsCancellationToken(transformFunc))
       {
         result = transformFunc.DynamicInvoke(inputParameter, cancellationToken);
       }
@@ -821,13 +818,13 @@ CancellationToken cancellationToken
       }
       File.AppendAllText(
         "/tmp/flowthru_diag.log",
-        $"[{DateTime.Now:HH:mm:ss.fff}] Pipeline: Transform invoked, result type={result?.GetType().Name ?? "null"}\n"
+        $"[{DateTime.Now:HH:mm:ss.fff}] Flow: Transform invoked, result type={result?.GetType().Name ?? "null"}\n"
       );
 
       if (result == null)
       {
         throw new InvalidOperationException(
-          $"Transform function for node {pipelineNode.Label} returned null"
+          $"Transform function for step {flowStep.Label} returned null"
         );
       }
 
@@ -847,12 +844,12 @@ CancellationToken cancellationToken
 
       // Save outputs to catalog entries
       // SaveUntyped() accepts T directly (singleton or collection), no unwrapping needed
-      if (output != null && pipelineNode.Outputs.Count > 0)
+      if (output != null && flowStep.Outputs.Count > 0)
       {
-        if (pipelineNode.Outputs.Count == 1)
+        if (flowStep.Outputs.Count == 1)
         {
           // Single output: save directly
-          var catalogEntry = pipelineNode.Outputs[0];
+          var catalogEntry = flowStep.Outputs[0];
           await catalogEntry.SaveUntyped(output).Run(cancellationToken);
         }
         else
@@ -862,23 +859,23 @@ CancellationToken cancellationToken
           if (!tupleType.IsGenericType || !tupleType.FullName!.StartsWith("System.ValueTuple"))
           {
             throw new InvalidOperationException(
-              $"Multi-output node '{pipelineNode.Label}' must return tuple, got: {tupleType.Name}"
+              $"Multi-output step '{flowStep.Label}' must return tuple, got: {tupleType.Name}"
             );
           }
 
           // Get tuple fields (Item1, Item2, ...)
           var tupleFields = tupleType.GetFields();
-          if (tupleFields.Length != pipelineNode.Outputs.Count)
+          if (tupleFields.Length != flowStep.Outputs.Count)
           {
             throw new InvalidOperationException(
-              $"Multi-output node '{pipelineNode.Label}': Tuple arity ({tupleFields.Length}) doesn't match output count ({pipelineNode.Outputs.Count})"
+              $"Multi-output step '{flowStep.Label}': Tuple arity ({tupleFields.Length}) doesn't match output count ({flowStep.Outputs.Count})"
             );
           }
 
           // Save each output directly from tuple field
-          for (int i = 0; i < pipelineNode.Outputs.Count; i++)
+          for (int i = 0; i < flowStep.Outputs.Count; i++)
           {
-            var catalogEntry = pipelineNode.Outputs[i];
+            var catalogEntry = flowStep.Outputs[i];
             var field = tupleFields[i];
             var outputData = field.GetValue(output);
 
@@ -890,22 +887,22 @@ CancellationToken cancellationToken
       stopwatch.Stop();
 
       // Get output counts for diagnostics (after saving data)
-      var outputCountAffs = pipelineNode.Outputs.Select(entry => entry.GetCountAsync());
+      var outputCountAffs = flowStep.Outputs.Select(entry => entry.GetCountAsync());
       var outputCountTasks = outputCountAffs.Select(aff => aff.Run(cancellationToken).AsTask());
       var outputCountResults = await Task.WhenAll(outputCountTasks);
       var outputCounts = outputCountResults;
       var totalOutputCount = outputCounts.Sum();
 
       Logger?.LogInformation(
-        "Node {NodeName} completed: {InputCount} observations in → {OutputCount} observations out ({ElapsedMs}ms)",
-        pipelineNode.Label,
+        "Step {StepName} completed: {InputCount} observations in → {OutputCount} observations out ({ElapsedMs}ms)",
+        flowStep.Label,
         totalInputCount,
         totalOutputCount,
         stopwatch.ElapsedMilliseconds
       );
 
-      return NodeResult.CreateSuccess(
-        pipelineNode.Label,
+      return StepResult.CreateSuccess(
+        flowStep.Label,
         stopwatch.Elapsed,
         totalInputCount,
         totalOutputCount
@@ -924,43 +921,35 @@ CancellationToken cancellationToken
     catch (Exception ex)
     {
       stopwatch.Stop();
-      Logger?.LogError(
-        ex,
-        "Node {NodeName} failed: {ErrorMessage}",
-        pipelineNode.Label,
-        ex.Message
-      );
-      return NodeResult.CreateFailure(pipelineNode.Label, stopwatch.Elapsed, ex);
+      Logger?.LogError(ex, "Step {StepName} failed: {ErrorMessage}", flowStep.Label, ex.Message);
+      return StepResult.CreateFailure(flowStep.Label, stopwatch.Elapsed, ex);
     }
   }
 
   /// <summary>
-  /// Executes a single node by loading its inputs, invoking the transformation,
+  /// Executes a single step by loading its inputs, invoking the transformation,
   /// and saving its outputs.
   /// </summary>
-  /// <param name="pipelineNode">The node to execute</param>
+  /// <param name="flowStep">The step to execute</param>
   /// <param name="cancellationToken">Cancellation token for I/O operations</param>
-  private async Task ExecuteNodeAsync(
-    PipelineNode pipelineNode,
-    CancellationToken cancellationToken
-  )
+  private async Task ExecuteStepAsync(FlowStep flowStep, CancellationToken cancellationToken)
   {
-    Logger?.LogInformation("Executing node: {NodeName}", pipelineNode.Label);
+    Logger?.LogInformation("Executing step: {StepName}", flowStep.Label);
 
     try
     {
       // Load inputs from catalog entries
-      var inputAffs = pipelineNode.Inputs.Select(entry => entry.LoadUntyped());
+      var inputAffs = flowStep.Inputs.Select(entry => entry.LoadUntyped());
       var inputLoadTasks = inputAffs.Select(aff => aff.Run(cancellationToken).AsTask());
       var inputResults = await Task.WhenAll(inputLoadTasks);
       var inputs = inputResults;
 
       // Prepare input parameter
       object inputParameter;
-      if (pipelineNode.Inputs.Count == 1)
+      if (flowStep.Inputs.Count == 1)
       {
         // Single input, unless this is a fan-in wrapper (Func<object[], TOut>)
-        var singleFuncType = pipelineNode.TransformFunction.GetType();
+        var singleFuncType = flowStep.TransformFunction.GetType();
         var singleParams = singleFuncType.GetMethod("Invoke")!.GetParameters();
         if (singleParams.Length == 1 && singleParams[0].ParameterType == typeof(object[]))
           inputParameter = (object)inputs;
@@ -970,14 +959,14 @@ CancellationToken cancellationToken
       else
       {
         // Use the function's actual parameter type to ensure correct tuple signature
-        var funcType = pipelineNode.TransformFunction.GetType();
+        var funcType = flowStep.TransformFunction.GetType();
         var invokeMethod = funcType.GetMethod("Invoke");
         var parameters = invokeMethod!.GetParameters();
         var paramType = parameters[0].ParameterType;
 
         if (paramType == typeof(object[]))
         {
-          // Fan-in node: pass the loaded array as a single boxed object.
+          // Fan-in step: pass the loaded array as a single boxed object.
           inputParameter = (object)inputs;
         }
         else
@@ -986,16 +975,16 @@ CancellationToken cancellationToken
           inputParameter =
             Activator.CreateInstance(tupleType, inputs)
             ?? throw new InvalidOperationException(
-              $"Failed to create tuple for node {pipelineNode.Label}"
+              $"Failed to create tuple for step {flowStep.Label}"
             );
         }
       }
 
       // Invoke transformation function
-      // Pass cancellation token if the node signature accepts it
-      var transformFunc = pipelineNode.TransformFunction;
+      // Pass cancellation token if the step signature accepts it
+      var transformFunc = flowStep.TransformFunction;
       Task? resultTask;
-      if (NodeAcceptsCancellationToken(transformFunc))
+      if (StepAcceptsCancellationToken(transformFunc))
       {
         resultTask = (Task?)transformFunc.DynamicInvoke(inputParameter, cancellationToken);
       }
@@ -1007,7 +996,7 @@ CancellationToken cancellationToken
       if (resultTask == null)
       {
         throw new InvalidOperationException(
-          $"Transform function for {pipelineNode.Label} returned null"
+          $"Transform function for {flowStep.Label} returned null"
         );
       }
 
@@ -1015,31 +1004,26 @@ CancellationToken cancellationToken
       var output = GetTaskResult(resultTask);
 
       // Save outputs
-      if (output != null && pipelineNode.Outputs.Count > 0)
+      if (output != null && flowStep.Outputs.Count > 0)
       {
-        if (pipelineNode.Outputs.Count == 1)
+        if (flowStep.Outputs.Count == 1)
         {
-          await pipelineNode.Outputs[0].SaveUntyped(output).Run(cancellationToken);
+          await flowStep.Outputs[0].SaveUntyped(output).Run(cancellationToken);
         }
         else
         {
           var tupleFields = output.GetType().GetFields();
-          for (int i = 0; i < pipelineNode.Outputs.Count; i++)
+          for (int i = 0; i < flowStep.Outputs.Count; i++)
           {
             var outputData = tupleFields[i].GetValue(output);
-            await pipelineNode.Outputs[i].SaveUntyped(outputData!).Run(cancellationToken);
+            await flowStep.Outputs[i].SaveUntyped(outputData!).Run(cancellationToken);
           }
         }
       }
     }
     catch (Exception ex)
     {
-      Logger?.LogError(
-        ex,
-        "Node {NodeName} failed: {ErrorMessage}",
-        pipelineNode.Label,
-        ex.Message
-      );
+      Logger?.LogError(ex, "Step {StepName} failed: {ErrorMessage}", flowStep.Label, ex.Message);
       throw;
     }
   }
diff --git a/src/core/Flowthru.Core/Pipelines/PipelineBuilder.cs b/src/core/Flowthru.Core/Flows/PipelineBuilder.cs
similarity index 60%
rename from src/core/Flowthru.Core/Pipelines/PipelineBuilder.cs
rename to src/core/Flowthru.Core/Flows/PipelineBuilder.cs
index 86e9fa5d..362a5a07 100644
--- a/src/core/Flowthru.Core/Pipelines/PipelineBuilder.cs
+++ b/src/core/Flowthru.Core/Flows/PipelineBuilder.cs
@@ -1,15 +1,15 @@
 using Flowthru.Data;
-using Flowthru.Nodes;
+using Flowthru.Steps;
 
-namespace Flowthru.Pipelines;
+namespace Flowthru.Flows;
 
 /// <summary>
-/// Fluent builder for constructing type-safe data pipelines with function-based nodes.
+/// Fluent builder for constructing type-safe flows with function-based steps.
 /// </summary>
 /// <remarks>
 /// <para>
 /// <strong>Function-Based Design (v0.5.0):</strong>
-/// Nodes are pure transformation functions with compile-time type safety.
+/// Steps are pure transformation functions with compile-time type safety.
 /// Both synchronous and asynchronous functions are supported:
 /// - Sync: Func&lt;TInput, TOutput&gt;
 /// - Async: Func&lt;TInput, Task&lt;TOutput&gt;&gt;
@@ -18,187 +18,190 @@ namespace Flowthru.Pipelines;
 /// </para>
 /// <para>
 /// Use synchronous functions for pure data transformations. Use asynchronous functions
-/// only when your node performs I/O operations (external APIs, databases, etc.).
+/// only when your step performs I/O operations (external APIs, databases, etc.).
 /// </para>
 /// <para>
 /// The compiler infers all types from function signatures and validates catalog entry
-/// types at pipeline construction time, catching type mismatches before execution.
+/// types at Flow construction time, catching type mismatches before execution.
 /// </para>
 /// <para>
 /// <strong>Usage Patterns:</strong>
 /// </para>
 /// <code>
-/// var pipeline = PipelineBuilder.CreatePipeline(builder =>
+/// var Flow = FlowBuilder.CreateFlow(builder =>
 /// {
-///     // Simple synchronous node
-///     builder.AddNode(
+///     // Simple synchronous step
+///     builder.AddStep(
 ///         name: "Preprocess",
-///         transform: PreprocessNode.Create(),
+///         transform: PreprocessStep.Create(),
 ///         input: catalog.RawData,
 ///         output: catalog.ProcessedData
 ///     );
 ///
-///     // Multi-input node: tuple → single output
-///     builder.AddNode(
+///     // Multi-input step: tuple → single output
+///     builder.AddStep(
 ///         name: "TrainModel",
-///         transform: TrainModelNode.Create(),
+///         transform: TrainModelStep.Create(),
 ///         input: (catalog.XTrain, catalog.YTrain),
 ///         output: catalog.Model
 ///     );
 ///
-///     // Multi-output node: single input → tuple
-///     builder.AddNode(
+///     // Multi-output step: single input → tuple
+///     builder.AddStep(
 ///         name: "SplitData",
-///         transform: SplitDataNode.Create(),
+///         transform: SplitDataStep.Create(),
 ///         input: catalog.Data,
 ///         output: (catalog.XTrain, catalog.XTest, catalog.YTrain, catalog.YTest)
 ///     );
 ///
-///     // Asynchronous node (only when needed for I/O)
-///     builder.AddNode(
+///     // Asynchronous step (only when needed for I/O)
+///     builder.AddStep(
 ///         name: "FetchExternalData",
-///         transform: ExternalDataNode.Create(),
+///         transform: ExternalDataStep.Create(),
 ///         input: catalog.Config,
 ///         output: catalog.ExternalData
 ///     );
 /// });
 ///
-/// pipeline.Build();
-/// await pipeline.ExecuteAsync();
+/// flow.Build();
+/// await flow.ExecuteAsync();
 /// </code>
 /// </remarks>
-public partial class PipelineBuilder
+public partial class FlowBuilder
 {
   /// <summary>
-  /// Maximum number of inputs supported by generated AddNode overloads.
+  /// Maximum number of inputs supported by generated AddStep overloads.
   /// </summary>
   internal const int MaxInputs = 8;
 
   /// <summary>
-  /// Maximum number of outputs supported by generated AddNode overloads.
+  /// Maximum number of outputs supported by generated AddStep overloads.
   /// </summary>
   internal const int MaxOutputs = 8;
 
-  private readonly Pipeline _pipeline = new();
+  private readonly Flow _flow = new();
 
   /// <summary>
-  /// Creates and configures a new pipeline using the builder pattern.
+  /// Creates and configures a new Flow using the builder pattern.
   /// </summary>
-  /// <param name="configure">Action to configure the pipeline by adding nodes</param>
-  /// <returns>Configured but not yet built pipeline</returns>
-  public static Pipeline CreatePipeline(Action<PipelineBuilder> configure)
+  /// <param name="configure">Action to configure the Flow by adding steps</param>
+  /// <returns>Configured but not yet built flow</returns>
+  public static Flow CreateFlow(Action<FlowBuilder> configure)
   {
-    var builder = new PipelineBuilder();
+    var builder = new FlowBuilder();
     configure(builder);
-    return builder._pipeline;
+    return builder._flow;
   }
 
   /// <summary>
-  /// Adds a node with single input and single output (asynchronous transformation).
+  /// Adds a step with single input and single output (asynchronous transformation).
   /// All types are inferred from the transformation function signature.
   /// </summary>
   /// <typeparam name="TInput">Input type (inferred from transform)</typeparam>
   /// <typeparam name="TOutput">Output type (inferred from transform)</typeparam>
-  /// <param name="label">Unique identifier for this node</param>
+  /// <param name="label">Unique identifier for this step</param>
   /// <param name="transform">Asynchronous transformation function from input to output</param>
   /// <param name="input">Catalog entry providing input data</param>
   /// <param name="output">Catalog entry to store output data</param>
+  /// <param name="description">Optional description for this step</param>
   /// <returns>This builder for method chaining</returns>
-  public PipelineBuilder AddNode<TInput, TOutput>(
+  public FlowBuilder AddStep<TInput, TOutput>(
     string label,
     Func<TInput, Task<TOutput>> transform,
-    ICatalogEntry<TInput> input,
-    ICatalogEntry<TOutput> output,
+    IItem<TInput> input,
+    IItem<TOutput> output,
     string description = ""
   )
   {
-    var pipelineNode = new PipelineNode(
+    var flowStep = new FlowStep(
       label: label,
       description: description,
-      node: transform,
-      inputs: new List<ICatalogEntry> { input },
-      outputs: new List<ICatalogEntry> { output }
+      step: transform,
+      inputs: new List<IItem> { input },
+      outputs: new List<IItem> { output }
     );
 
-    _pipeline.AddNode(pipelineNode);
+    _flow.AddStep(flowStep);
     return this;
   }
 
   /// <summary>
-  /// Adds a node with single input and single output (asynchronous transformation with cancellation support).
+  /// Adds a step with single input and single output (asynchronous transformation with cancellation support).
   /// All types are inferred from the transformation function signature.
   /// </summary>
   /// <typeparam name="TInput">Input type (inferred from transform)</typeparam>
   /// <typeparam name="TOutput">Output type (inferred from transform)</typeparam>
-  /// <param name="label">Unique identifier for this node</param>
+  /// <param name="label">Unique identifier for this step</param>
   /// <param name="transform">Asynchronous transformation function from input to output with cancellation token</param>
   /// <param name="input">Catalog entry providing input data</param>
   /// <param name="output">Catalog entry to store output data</param>
+  /// <param name="description">Optional description for this step</param>
   /// <returns>This builder for method chaining</returns>
-  public PipelineBuilder AddNode<TInput, TOutput>(
+  public FlowBuilder AddStep<TInput, TOutput>(
     string label,
     Func<TInput, CancellationToken, Task<TOutput>> transform,
-    ICatalogEntry<TInput> input,
-    ICatalogEntry<TOutput> output,
+    IItem<TInput> input,
+    IItem<TOutput> output,
     string description = ""
   )
   {
-    var pipelineNode = new PipelineNode(
+    var flowStep = new FlowStep(
       label: label,
       description: description,
-      node: transform,
-      inputs: new List<ICatalogEntry> { input },
-      outputs: new List<ICatalogEntry> { output }
+      step: transform,
+      inputs: new List<IItem> { input },
+      outputs: new List<IItem> { output }
     );
 
-    _pipeline.AddNode(pipelineNode);
+    _flow.AddStep(flowStep);
     return this;
   }
 
   /// <summary>
-  /// Adds a node with single input and single output (synchronous transformation).
+  /// Adds a step with single input and single output (synchronous transformation).
   /// All types are inferred from the transformation function signature.
   /// </summary>
   /// <typeparam name="TInput">Input type (inferred from transform)</typeparam>
   /// <typeparam name="TOutput">Output type (inferred from transform)</typeparam>
-  /// <param name="label">Unique identifier for this node</param>
+  /// <param name="label">Unique identifier for this step</param>
   /// <param name="transform">Synchronous transformation function from input to output</param>
   /// <param name="input">Catalog entry providing input data</param>
   /// <param name="output">Catalog entry to store output data</param>
+  /// <param name="description">Optional description for this step</param>
   /// <returns>This builder for method chaining</returns>
-  public PipelineBuilder AddNode<TInput, TOutput>(
+  public FlowBuilder AddStep<TInput, TOutput>(
     string label,
     Func<TInput, TOutput> transform,
-    ICatalogEntry<TInput> input,
-    ICatalogEntry<TOutput> output,
+    IItem<TInput> input,
+    IItem<TOutput> output,
     string description = ""
   )
   {
-    var pipelineNode = new PipelineNode(
+    var flowStep = new FlowStep(
       label: label,
       description: description,
-      node: transform,
-      inputs: new List<ICatalogEntry> { input },
-      outputs: new List<ICatalogEntry> { output }
+      step: transform,
+      inputs: new List<IItem> { input },
+      outputs: new List<IItem> { output }
     );
 
-    _pipeline.AddNode(pipelineNode);
+    _flow.AddStep(flowStep);
     return this;
   }
 
   // Additional overloads (2-8 inputs, 1-8 outputs) are auto-generated via source generator.
-  // See: Flowthru.SourceGenerators/PipelineBuilderGenerator.cs
+  // See: Flowthru.SourceGenerators/FlowBuilderGenerator.cs
 
   /// <summary>
-  /// Adds a homogeneous fan-in node: N catalog entries of the same element type collapse
-  /// into a single node whose transform receives all N loaded collections as a typed list.
+  /// Adds a homogeneous fan-in step: N catalog entries of the same element type collapse
+  /// into a single step whose transform receives all N loaded collections as a typed list.
   /// </summary>
   /// <typeparam name="TIn">Element type of each input catalog entry</typeparam>
   /// <typeparam name="TOut">Output type produced by the transform</typeparam>
-  /// <param name="label">Unique identifier for this node</param>
+  /// <param name="label">Unique identifier for this step</param>
   /// <param name="inputs">Variable-length list of same-typed input entries</param>
   /// <param name="output">Catalog entry to store the merged result</param>
-  /// <param name="node">Transform function receiving all N loaded values as a typed read-only list</param>
+  /// <param name="step">Transform function receiving all N loaded values as a typed read-only list</param>
   /// <param name="description">Optional human-readable description</param>
   /// <returns>This builder for method chaining</returns>
   /// <remarks>
@@ -207,11 +210,11 @@ public PipelineBuilder AddNode<TInput, TOutput>(
   /// <c>IReadOnlyList&lt;TIn&gt;</c> where each element corresponds to one input entry
   /// in declaration order. An empty inputs list is allowed but produces an empty list argument.
   /// </remarks>
-  public PipelineBuilder AddNode<TIn, TOut>(
+  public FlowBuilder AddStep<TIn, TOut>(
     string label,
-    IReadOnlyList<ICatalogEntry<TIn>> inputs,
-    ICatalogEntry<TOut> output,
-    Func<IReadOnlyList<TIn>, TOut> node,
+    IReadOnlyList<IItem<TIn>> inputs,
+    IItem<TOut> output,
+    Func<IReadOnlyList<TIn>, TOut> step,
     string description = ""
   )
   {
@@ -219,26 +222,26 @@ public PipelineBuilder AddNode<TIn, TOut>(
       throw new ArgumentNullException(nameof(inputs));
     if (output == null)
       throw new ArgumentNullException(nameof(output));
-    if (node == null)
-      throw new ArgumentNullException(nameof(node));
+    if (step == null)
+      throw new ArgumentNullException(nameof(step));
 
-    var capturedNode = node;
+    var capturedStep = step;
     // Wrap into Func<object[], TOut>. The executor uses the parameter type as a signal:
     // when it is object[], it passes the loaded inputs array directly rather than building
     // a ValueTuple. inputParameter is declared as object in the executor so DynamicInvoke
     // receives new object[]{ inputParameter } — no array-spreading occurs.
-    Func<object[], TOut> wrappedNode = rawInputs =>
-      capturedNode(rawInputs.Cast<TIn>().ToList().AsReadOnly());
+    Func<object[], TOut> wrappedStep = rawInputs =>
+      capturedStep(rawInputs.Cast<TIn>().ToList().AsReadOnly());
 
-    var pipelineNode = new PipelineNode(
+    var flowStep = new FlowStep(
       label: label,
       description: description,
-      node: wrappedNode,
-      inputs: inputs.Cast<ICatalogEntry>().ToList(),
-      outputs: new List<ICatalogEntry> { output }
+      step: wrappedStep,
+      inputs: inputs.Cast<IItem>().ToList(),
+      outputs: new List<IItem> { output }
     );
 
-    _pipeline.AddNode(pipelineNode);
+    _flow.AddStep(flowStep);
     return this;
   }
 }
diff --git a/src/core/Flowthru.Core/Pipelines/PipelineNode.cs b/src/core/Flowthru.Core/Flows/PipelineNode.cs
similarity index 53%
rename from src/core/Flowthru.Core/Pipelines/PipelineNode.cs
rename to src/core/Flowthru.Core/Flows/PipelineNode.cs
index 0ea15556..25c55eaa 100644
--- a/src/core/Flowthru.Core/Pipelines/PipelineNode.cs
+++ b/src/core/Flowthru.Core/Flows/PipelineNode.cs
@@ -1,52 +1,46 @@
 using Flowthru.Data;
-using Flowthru.Nodes;
+using Flowthru.Steps;
 
-namespace Flowthru.Pipelines;
+namespace Flowthru.Flows;
 
 /// <summary>
-/// Represents a node within a pipeline, wrapping the transformation function with metadata
+/// Represents a step within a flow, wrapping the transformation function with metadata
 /// about its inputs, outputs, and dependencies.
 /// </summary>
 /// <remarks>
 /// <para>
-/// PipelineNode serves as the internal representation of a node during pipeline
+/// FlowStep serves as the internal representation of a step during flow
 /// construction and execution. It tracks:
 /// - The transformation function (Func&lt;TInput, Task&lt;TOutput&gt;&gt;)
 /// - Input catalog entries (what data it reads)
 /// - Output catalog entries (what data it writes)
-/// - Dependencies (other nodes that must run first)
+/// - Dependencies (other steps that must run first)
 /// </para>
 /// <para>
 /// <strong>Single Producer Rule:</strong> Each catalog entry can be written by at most
-/// one node in a pipeline. This constraint ensures deterministic dependency resolution
+/// one step in a flow. This constraint ensures deterministic dependency resolution
 /// and enables simple DAG construction via topological sort.
 /// </para>
 /// <para>
-/// <strong>Function-Based Architecture (v0.5.0):</strong> Nodes are now pure transformation
-/// functions instead of class instances. This enables compile-time type safety through
-/// generic type inference at the pipeline construction site.
-/// </para>
-/// <para>
-/// <strong>Visibility (Phase 4):</strong>
-/// Made public to enable validation hooks to inspect node properties.
-/// This is necessary for extensions (e.g., Python) to validate their own node types.
+/// Made public to enable validation hooks to inspect step properties.
+/// This is necessary for extensions (e.g., Python) to validate their own step types.
 /// </para>
 /// </remarks>
-public class PipelineNode
+public class FlowStep
 {
   /// <summary>
-  /// Unique identifier for this node within the pipeline.
-  /// Typically the node type name or user-provided name.
+  /// Unique identifier for this step within the flow.
+  /// Typically the step type name or user-provided name.
   /// </summary>
   public string Label { get; }
 
   /// <summary>
-  /// String description of the node's purpose.
+  /// String description of the step's purpose.
   /// </summary>
   public string Description { get; }
 
   /// <summary>
-  /// The transformation function that performs the node's work.
+  /// The transformation function that performs the step's work.
   /// Type-erased to Delegate since we need to store different function signatures together.
   /// </summary>
   /// <remarks>
@@ -62,15 +56,15 @@ public class PipelineNode
   /// - Async multi-output: Func&lt;TInput, Task&lt;(TOut1, TOut2, ...)&gt;&gt;
   /// </para>
   /// <para>
-  /// <strong>Optional Cancellation Support:</strong> Nodes can opt-in to cancellation awareness
+  /// <strong>Optional Cancellation Support:</strong> Steps can opt-in to cancellation awareness
   /// by accepting a CancellationToken as the last parameter:
   /// - Func&lt;TInput, CancellationToken, Task&lt;TOutput&gt;&gt;
   /// - Func&lt;(TIn1, TIn2), CancellationToken, Task&lt;TOutput&gt;&gt;
   /// </para>
   /// <para>
-  /// When a node accepts a CancellationToken, the pipeline will pass the runtime token during
-  /// execution, allowing the node to cancel long-running operations cooperatively. Nodes that
-  /// do not accept a CancellationToken will only be cancelled between node executions.
+  /// When a Step accepts a CancellationToken, the Flow will pass the runtime token during
+  /// execution, allowing the step to cancel long-running operations cooperatively. Steps that
+  /// do not accept a CancellationToken will only be cancelled between step executions.
   /// </para>
   /// <para>
   /// The execution engine detects whether the result is a Task and awaits it if needed.
@@ -79,52 +73,53 @@ public class PipelineNode
   public Delegate TransformFunction { get; }
 
   /// <summary>
-  /// Catalog entries that this node reads as input.
-  /// These may be produced by other nodes (dependencies) or be external prerequisites.
+  /// Catalog entries that this step reads as input.
+  /// These may be produced by other steps (dependencies) or be external prerequisites.
   /// </summary>
-  public IReadOnlyList<ICatalogEntry> Inputs { get; }
+  public IReadOnlyList<IItem> Inputs { get; }
 
   /// <summary>
-  /// Catalog entries that this node writes as output.
-  /// Per the single producer rule, each entry here must be unique across all nodes.
+  /// Catalog entries that this step writes as output.
+  /// Per the single producer rule, each entry here must be unique across all steps.
   /// </summary>
-  public IReadOnlyList<ICatalogEntry> Outputs { get; }
+  public IReadOnlyList<IItem> Outputs { get; }
 
   /// <summary>
-  /// Other pipeline nodes that must execute before this node.
-  /// Populated during dependency analysis by checking which nodes produce our inputs.
+  /// Other Flow steps that must execute before this step.
+  /// Populated during dependency analysis by checking which steps produce our inputs.
   /// </summary>
   /// <remarks>
   /// This forms the edges of the execution DAG:
-  /// - If node A produces output X, and node B consumes input X, then B depends on A.
+  /// - If step A produces output X, and step B consumes input X, then B depends on A.
   /// - Topological sort uses these dependencies to determine execution order.
   /// </remarks>
-  public List<PipelineNode> Dependencies { get; } = new();
+  public List<FlowStep> Dependencies { get; } = new();
 
   /// <summary>
   /// Execution layer determined by topological sort.
-  /// Nodes in layer 0 have no dependencies. Nodes in layer N depend on nodes in layers 0..N-1.
+  /// Steps in layer 0 have no dependencies. Steps in layer N depend on steps in layers 0..N-1.
   /// </summary>
   public int Layer { get; set; } = -1; // -1 indicates not yet assigned
 
   /// <summary>
-  /// Creates a new pipeline node with a transformation function.
+  /// Creates a new Flow step with a transformation function.
   /// </summary>
-  /// <param name="label">Unique identifier for this node</param>
-  /// <param name="node">The transformation function (Func&lt;TInput, Task&lt;TOutput&gt;&gt;)</param>
-  /// <param name="inputs">Catalog entries this node reads</param>
-  /// <param name="outputs">Catalog entries this node writes</param>
-  public PipelineNode(
+  /// <param name="label">Unique identifier for this step</param>
+  /// <param name="description">Optional description of this step</param>
+  /// <param name="step">The transformation function (Func&lt;TInput, Task&lt;TOutput&gt;&gt;)</param>
+  /// <param name="inputs">Catalog entries this step reads</param>
+  /// <param name="outputs">Catalog entries this step writes</param>
+  public FlowStep(
     string label,
     string? description,
-    Delegate node,
-    IReadOnlyList<ICatalogEntry> inputs,
-    IReadOnlyList<ICatalogEntry> outputs
+    Delegate step,
+    IReadOnlyList<IItem> inputs,
+    IReadOnlyList<IItem> outputs
   )
   {
     Label = label;
     Description = description ?? string.Empty;
-    TransformFunction = node;
+    TransformFunction = step;
     Inputs = inputs;
     Outputs = outputs;
   }
@@ -133,5 +128,5 @@ IReadOnlyList<ICatalogEntry> outputs
   /// Returns a string representation for debugging.
   /// </summary>
   public override string ToString() =>
-    $"PipelineNode({Label}, Layer={Layer}, Inputs={Inputs.Count}, Outputs={Outputs.Count}, Dependencies={Dependencies.Count})";
+    $"FlowStep({Label}, Layer={Layer}, Inputs={Inputs.Count}, Outputs={Outputs.Count}, Dependencies={Dependencies.Count})";
 }
diff --git a/src/core/Flowthru.Core/Pipelines/PipelineResult.cs b/src/core/Flowthru.Core/Flows/PipelineResult.cs
similarity index 51%
rename from src/core/Flowthru.Core/Pipelines/PipelineResult.cs
rename to src/core/Flowthru.Core/Flows/PipelineResult.cs
index ca5c0e22..eb516268 100644
--- a/src/core/Flowthru.Core/Pipelines/PipelineResult.cs
+++ b/src/core/Flowthru.Core/Flows/PipelineResult.cs
@@ -1,42 +1,42 @@
-namespace Flowthru.Pipelines;
+namespace Flowthru.Flows;
 
 /// <summary>
-/// Represents the result of a pipeline execution.
+/// Represents the result of a Flow execution.
 /// </summary>
 /// <remarks>
 /// <para>
 /// This class provides comprehensive execution information including success status,
-/// timing, individual node results, and error details.
+/// timing, individual step results, and error details.
 /// </para>
 /// <para>
 /// <strong>Usage Pattern:</strong>
 /// </para>
 /// <code>
-/// var result = await pipeline.RunAsync();
+/// var result = await flow.RunAsync();
 ///
 /// if (result.Success)
 /// {
-///     Console.WriteLine($"Pipeline completed in {result.ExecutionTime.TotalSeconds:F2}s");
-///     foreach (var nodeResult in result.NodeResults.Values)
+///     Console.WriteLine($"Flow completed in {result.ExecutionTime.TotalSeconds:F2}s");
+///     foreach (var stepResult in result.StepResults.Values)
 ///     {
-///         Console.WriteLine($"  {nodeResult.NodeName}: {nodeResult.ExecutionTime.TotalSeconds:F2}s");
+///         Console.WriteLine($"  {stepResult.StepName}: {stepResult.ExecutionTime.TotalSeconds:F2}s");
 ///     }
 /// }
 /// else
 /// {
-///     Console.WriteLine($"Pipeline failed: {result.Exception?.Message}");
+///     Console.WriteLine($"Flow failed: {result.Exception?.Message}");
 /// }
 /// </code>
 /// </remarks>
-public class PipelineResult
+public class FlowResult
 {
   /// <summary>
-  /// The name of the pipeline that was executed.
+  /// The name of the Flow that was executed.
   /// </summary>
-  public string? PipelineName { get; init; }
+  public string? FlowName { get; init; }
 
   /// <summary>
-  /// Indicates whether the pipeline executed successfully.
+  /// Indicates whether the Flow executed successfully.
   /// </summary>
   public bool Success { get; init; }
 
@@ -46,65 +46,65 @@ public class PipelineResult
   public bool IsDryRun { get; init; }
 
   /// <summary>
-  /// Total execution time for the entire pipeline.
+  /// Total execution time for the entire flow.
   /// </summary>
   public TimeSpan ExecutionTime { get; init; }
 
   /// <summary>
-  /// Results for individual nodes, keyed by node name.
+  /// Results for individual steps, keyed by step name.
   /// </summary>
   /// <remarks>
-  /// Dictionary keys are the node names as specified in the pipeline definition.
-  /// Values contain execution details for each node.
+  /// Dictionary keys are the step names as specified in the Flow definition.
+  /// Values contain execution details for each step.
   /// </remarks>
-  public Dictionary<string, NodeResult> NodeResults { get; init; } = new();
+  public Dictionary<string, StepResult> StepResults { get; init; } = new();
 
   /// <summary>
-  /// Exception that caused pipeline failure, if any.
+  /// Exception that caused Flow failure, if any.
   /// </summary>
   /// <remarks>
   /// Null if Success is true. Contains the first exception that caused
-  /// pipeline execution to halt if Success is false.
+  /// Flow execution to halt if Success is false.
   /// </remarks>
   public Exception? Exception { get; init; }
 
   /// <summary>
-  /// Creates a successful pipeline result.
+  /// Creates a successful Flow result.
   /// </summary>
-  public static PipelineResult CreateSuccess(
+  public static FlowResult CreateSuccess(
     TimeSpan executionTime,
-    Dictionary<string, NodeResult> nodeResults,
-    string? pipelineName = null
+    Dictionary<string, StepResult> stepResults,
+    string? flowName = null
   )
   {
-    return new PipelineResult
+    return new FlowResult
     {
       Success = true,
       IsDryRun = false,
       ExecutionTime = executionTime,
-      NodeResults = nodeResults,
-      PipelineName = pipelineName,
+      StepResults = stepResults,
+      FlowName = flowName,
     };
   }
 
   /// <summary>
-  /// Creates a failed pipeline result.
+  /// Creates a failed Flow result.
   /// </summary>
-  public static PipelineResult CreateFailure(
+  public static FlowResult CreateFailure(
     TimeSpan executionTime,
     Exception exception,
-    Dictionary<string, NodeResult>? nodeResults = null,
-    string? pipelineName = null
+    Dictionary<string, StepResult>? stepResults = null,
+    string? flowName = null
   )
   {
-    return new PipelineResult
+    return new FlowResult
     {
       Success = false,
       IsDryRun = false,
       ExecutionTime = executionTime,
       Exception = exception,
-      NodeResults = nodeResults ?? new(),
-      PipelineName = pipelineName,
+      StepResults = stepResults ?? new(),
+      FlowName = flowName,
     };
   }
 
@@ -112,90 +112,90 @@ public static PipelineResult CreateFailure(
   /// Creates a successful dry run result.
   /// </summary>
   /// <param name="preFlightDuration">Time spent on pre-flight checks</param>
-  /// <param name="nodeCount">Total number of nodes in the pipeline</param>
+  /// <param name="stepCount">Total number of steps in the flow</param>
   /// <param name="layerCount">Number of execution layers</param>
   /// <param name="validatedInputCount">Number of external inputs validated</param>
-  /// <param name="pipelineName">Name of the pipeline</param>
+  /// <param name="flowName">Name of the flow</param>
   /// <returns>A successful dry run result</returns>
-  public static PipelineResult CreateDryRunSuccess(
+  public static FlowResult CreateDryRunSuccess(
     TimeSpan preFlightDuration,
-    int nodeCount,
+    int stepCount,
     int layerCount,
     int validatedInputCount,
-    string? pipelineName = null
+    string? flowName = null
   )
   {
-    return new PipelineResult
+    return new FlowResult
     {
       Success = true,
       IsDryRun = true,
       ExecutionTime = preFlightDuration,
-      NodeResults = new Dictionary<string, NodeResult>(),
-      PipelineName = pipelineName,
+      StepResults = new Dictionary<string, StepResult>(),
+      FlowName = flowName,
     };
   }
 }
 
 /// <summary>
-/// Represents the execution result of a single pipeline node.
+/// Represents the execution result of a single Flow step.
 /// </summary>
-public class NodeResult
+public class StepResult
 {
   /// <summary>
-  /// The name of the node that was executed.
+  /// The name of the step that was executed.
   /// </summary>
-  public required string NodeName { get; init; }
+  public required string StepName { get; init; }
 
   /// <summary>
-  /// Indicates whether the node executed successfully.
+  /// Indicates whether the step executed successfully.
   /// </summary>
   public bool Success { get; init; }
 
   /// <summary>
-  /// Execution time for this specific node.
+  /// Execution time for this specific step.
   /// </summary>
   public TimeSpan ExecutionTime { get; init; }
 
   /// <summary>
-  /// Exception that occurred during node execution, if any.
+  /// Exception that occurred during step execution, if any.
   /// </summary>
   /// <remarks>
   /// Null if Success is true. Contains the exception that caused
-  /// the node to fail if Success is false.
+  /// the step to fail if Success is false.
   /// </remarks>
   public Exception? Exception { get; init; }
 
   /// <summary>
-  /// Number of input items processed by this node.
+  /// Number of input items processed by this step.
   /// </summary>
   /// <remarks>
-  /// For multi-input nodes, this represents the total count across
+  /// For multi-input steps, this represents the total count across
   /// all input catalog entries.
   /// </remarks>
   public int InputCount { get; init; }
 
   /// <summary>
-  /// Number of output items produced by this node.
+  /// Number of output items produced by this step.
   /// </summary>
   /// <remarks>
-  /// For multi-output nodes, this represents the total count across
+  /// For multi-output steps, this represents the total count across
   /// all output catalog entries.
   /// </remarks>
   public int OutputCount { get; init; }
 
   /// <summary>
-  /// Creates a successful node result.
+  /// Creates a successful step result.
   /// </summary>
-  public static NodeResult CreateSuccess(
-    string nodeName,
+  public static StepResult CreateSuccess(
+    string stepName,
     TimeSpan executionTime,
     int inputCount,
     int outputCount
   )
   {
-    return new NodeResult
+    return new StepResult
     {
-      NodeName = nodeName,
+      StepName = stepName,
       Success = true,
       ExecutionTime = executionTime,
       InputCount = inputCount,
@@ -204,18 +204,18 @@ int outputCount
   }
 
   /// <summary>
-  /// Creates a failed node result.
+  /// Creates a failed step result.
   /// </summary>
-  public static NodeResult CreateFailure(
-    string nodeName,
+  public static StepResult CreateFailure(
+    string stepName,
     TimeSpan executionTime,
     Exception exception,
     int inputCount = 0
   )
   {
-    return new NodeResult
+    return new StepResult
     {
-      NodeName = nodeName,
+      StepName = stepName,
       Success = false,
       ExecutionTime = executionTime,
       Exception = exception,
diff --git a/src/core/Flowthru.Core/Pipelines/PipelineSliceStrategy.cs b/src/core/Flowthru.Core/Flows/PipelineSliceStrategy.cs
similarity index 78%
rename from src/core/Flowthru.Core/Pipelines/PipelineSliceStrategy.cs
rename to src/core/Flowthru.Core/Flows/PipelineSliceStrategy.cs
index 9392ad6b..8a743417 100644
--- a/src/core/Flowthru.Core/Pipelines/PipelineSliceStrategy.cs
+++ b/src/core/Flowthru.Core/Flows/PipelineSliceStrategy.cs
@@ -1,11 +1,11 @@
-namespace Flowthru.Pipelines;
+namespace Flowthru.Flows;
 
 /// <summary>
-/// Defines a strategy for slicing a pipeline to execute a subset of nodes.
+/// Defines a strategy for slicing a Flow to execute a subset of nodes.
 /// </summary>
 /// <remarks>
 /// <para>
-/// Pipeline slicing allows executing only specific portions of a DAG while maintaining
+/// Flow slicing allows executing only specific portions of a DAG while maintaining
 /// execution validity. All slicing operations preserve the runnability guarantee:
 /// the resulting sub-DAG must be executable without missing dependencies.
 /// </para>
@@ -13,7 +13,7 @@ namespace Flowthru.Pipelines;
 /// <strong>Slicing Strategies:</strong>
 /// </para>
 /// <list type="bullet">
-/// <item><strong>Pipelines:</strong> Filter to nodes from specific named pipelines (in merged DAGs)</item>
+/// <item><strong>flows:</strong> Filter to nodes from specific named flows (in merged DAGs)</item>
 /// <item><strong>FromNodes:</strong> Include specified nodes and all downstream dependents</item>
 /// <item><strong>ToNodes:</strong> Include specified nodes and all upstream dependencies (run "up to" these nodes)</item>
 /// <item><strong>FromData:</strong> Include nodes consuming specified catalog entries and all downstream dependents</item>
@@ -31,17 +31,17 @@ namespace Flowthru.Pipelines;
 /// are not supported.
 /// </para>
 /// </remarks>
-public sealed class PipelineSliceStrategy
+public sealed class FlowSliceStrategy
 {
   /// <summary>
-  /// Filter to nodes from these named pipelines (applies to merged pipelines).
+  /// Filter to nodes from these named flows (applies to merged flows).
   /// </summary>
   /// <remarks>
-  /// In merged pipelines, nodes are prefixed with their pipeline name (e.g., "DataScience.TrainModel").
-  /// This filter includes only nodes from the specified pipelines.
-  /// Pipeline names are case-insensitive.
+  /// In merged flows, nodes are prefixed with their Flow name (e.g., "DataScience.TrainModel").
+  /// This filter includes only nodes from the specified flows.
+  /// Flow names are case-insensitive.
   /// </remarks>
-  public IReadOnlySet<string>? Pipelines { get; init; }
+  public IReadOnlySet<string>? Flows { get; init; }
 
   /// <summary>
   /// Start from these nodes, including all downstream dependents.
@@ -58,7 +58,7 @@ public sealed class PipelineSliceStrategy
   /// <remarks>
   /// Expands to include all transitive dependencies needed to run these nodes.
   /// Equivalent to "run everything up to and including these nodes".
-  /// Useful for testing specific outputs without running the entire pipeline.
+  /// Useful for testing specific outputs without running the entire flow.
   /// </remarks>
   public IReadOnlySet<string>? ToNodes { get; init; }
 
@@ -68,6 +68,8 @@ public sealed class PipelineSliceStrategy
   /// <remarks>
   /// Finds all nodes that read the specified catalog entries, then expands downstream.
   /// Useful for impact analysis - "what breaks if I change this data?"
+  ///
+  /// TODO: Remove this, as it is now sufficient to reference both steps and data entries as nodes.
   /// </remarks>
   public IReadOnlySet<string>? FromData { get; init; }
 
@@ -77,6 +79,8 @@ public sealed class PipelineSliceStrategy
   /// <remarks>
   /// Finds the nodes that write the specified catalog entries, then expands upstream.
   /// Useful for targeted execution - "run everything needed to produce this data".
+  ///
+  /// TODO: Remove this, as it is now sufficient to reference both steps and data entries as nodes.
   /// </remarks>
   public IReadOnlySet<string>? ToData { get; init; }
 
@@ -93,7 +97,7 @@ public sealed class PipelineSliceStrategy
   /// Whether any slicing is configured.
   /// </summary>
   public bool IsSliced =>
-    Pipelines != null
+    Flows != null
     || FromNodes != null
     || ToNodes != null
     || FromData != null
@@ -101,7 +105,7 @@ public sealed class PipelineSliceStrategy
     || OnlyNodes != null;
 
   /// <summary>
-  /// No filtering - execute entire pipeline.
+  /// No filtering - execute entire flow.
   /// </summary>
-  public static PipelineSliceStrategy All() => new();
+  public static FlowSliceStrategy All() => new();
 }
diff --git a/src/core/Flowthru.Core/Pipelines/Validation/IPipelineValidationHook.cs b/src/core/Flowthru.Core/Flows/Validation/IPipelineValidationHook.cs
similarity index 65%
rename from src/core/Flowthru.Core/Pipelines/Validation/IPipelineValidationHook.cs
rename to src/core/Flowthru.Core/Flows/Validation/IPipelineValidationHook.cs
index 9b276134..deb93363 100644
--- a/src/core/Flowthru.Core/Pipelines/Validation/IPipelineValidationHook.cs
+++ b/src/core/Flowthru.Core/Flows/Validation/IPipelineValidationHook.cs
@@ -1,22 +1,22 @@
 using Flowthru.Data.Validation;
 
-namespace Flowthru.Pipelines.Validation;
+namespace Flowthru.Flows.Validation;
 
 /// <summary>
-/// Validation hook that runs during pipeline pre-flight checks.
+/// Validation hook that runs during Flow pre-flight checks.
 /// </summary>
 /// <remarks>
 /// <para>
 /// Validation hooks provide an extensibility point for extensions to contribute
 /// their own validation logic during the pre-flight phase. Hooks are invoked after
 /// DAG analysis but before external input inspection, allowing extensions to
-/// validate their own node types.
+/// validate their own step types.
 /// </para>
 /// <para>
 /// <strong>Example use cases:</strong>
 /// <list type="bullet">
-/// <item>Python extension validates @node decorators match C# types</item>
-/// <item>Custom extensions validate node-specific configuration</item>
+/// <item>Python extension validates @step decorators match C# types</item>
+/// <item>Custom extensions validate step-specific configuration</item>
 /// <item>Third-party plugins validate external dependencies</item>
 /// </list>
 /// </para>
@@ -24,9 +24,9 @@ namespace Flowthru.Pipelines.Validation;
 /// <strong>Hook execution order:</strong>
 /// </para>
 /// <list type="number">
-/// <item>Pipeline.Build() - DAG construction and layer assignment</item>
+/// <item>Flow.Build() - DAG construction and layer assignment</item>
 /// <item>ValidationHooks.ValidateAsync() - Extension-specific validation</item>
-/// <item>Pipeline.ValidateExternalInputsAsync() - External input inspection</item>
+/// <item>Flow.ValidateExternalInputsAsync() - External input inspection</item>
 /// </list>
 /// <para>
 /// <strong>Error handling:</strong>
@@ -34,12 +34,12 @@ namespace Flowthru.Pipelines.Validation;
 /// Multiple hooks may run, and all errors are aggregated into a single result.
 /// </para>
 /// </remarks>
-public interface IPipelineValidationHook
+public interface IFlowValidationHook
 {
   /// <summary>
-  /// Validates pipeline nodes during pre-flight checks.
+  /// Validates Flow steps during pre-flight checks.
   /// </summary>
-  /// <param name="pipeline">The pipeline being validated</param>
+  /// <param name="flow">The Flow being validated</param>
   /// <param name="cancellationToken">Cancellation token for async operations</param>
   /// <returns>Validation result containing any errors found</returns>
   /// <remarks>
@@ -48,8 +48,8 @@ public interface IPipelineValidationHook
   /// <list type="bullet">
   /// <item>Never throw exceptions (return errors in ValidationResult)</item>
   /// <item>Be idempotent (safe to call multiple times)</item>
-  /// <item>Be reasonably fast (executed during pre-flight, blocks pipeline start)</item>
-  /// <item>Only validate nodes they understand (ignore other node types)</item>
+  /// <item>Be reasonably fast (executed during pre-flight, blocks Flow start)</item>
+  /// <item>Only validate steps they understand (ignore other step types)</item>
   /// </list>
   /// </para>
   /// <para>
@@ -57,17 +57,17 @@ public interface IPipelineValidationHook
   /// </para>
   /// <code>
   /// public async Task&lt;ValidationResult&gt; ValidateAsync(
-  ///   Pipeline pipeline,
+  ///   Flow flow,
   ///   CancellationToken cancellationToken)
   /// {
   ///   var result = ValidationResult.Success();
   ///
-  ///   foreach (var node in pipeline.Nodes)
+  ///   foreach (var step in flow.Steps)
   ///   {
-  ///     if (IsPythonNode(node))
+  ///     if (IsPythonStep(step))
   ///     {
-  ///       var nodeResult = await ValidatePythonNode(node, cancellationToken);
-  ///       result.Merge(nodeResult);
+  ///       var stepResult = await ValidatePythonStep(step, cancellationToken);
+  ///       result.Merge(stepResult);
   ///     }
   ///   }
   ///
@@ -75,5 +75,5 @@ public interface IPipelineValidationHook
   /// }
   /// </code>
   /// </remarks>
-  Task<ValidationResult> ValidateAsync(Pipeline pipeline, CancellationToken cancellationToken);
+  Task<ValidationResult> ValidateAsync(Flow flow, CancellationToken cancellationToken);
 }
diff --git a/src/core/Flowthru.Core/Pipelines/Validation/ValidationOptions.cs b/src/core/Flowthru.Core/Flows/Validation/ValidationOptions.cs
similarity index 93%
rename from src/core/Flowthru.Core/Pipelines/Validation/ValidationOptions.cs
rename to src/core/Flowthru.Core/Flows/Validation/ValidationOptions.cs
index 3d343551..0f483e03 100644
--- a/src/core/Flowthru.Core/Pipelines/Validation/ValidationOptions.cs
+++ b/src/core/Flowthru.Core/Flows/Validation/ValidationOptions.cs
@@ -1,7 +1,7 @@
 using Flowthru.Data;
 using Flowthru.Data.Validation;
 
-namespace Flowthru.Pipelines.Validation;
+namespace Flowthru.Flows.Validation;
 
 /// <summary>
 /// Configuration for pipeline validation behavior.
@@ -10,7 +10,7 @@ namespace Flowthru.Pipelines.Validation;
 /// <para>
 /// ValidationOptions provides pipeline-level overrides for validation configuration.
 /// The primary mechanism for validation configuration is catalog-level via the
-/// <see cref="ICatalogEntry.PreferredInspectionLevel"/> property and the fluent
+/// <see cref="IItem.PreferredInspectionLevel"/> property and the fluent
 /// <c>.WithInspectionLevel()</c> API.
 /// </para>
 /// <para>
@@ -26,7 +26,7 @@ namespace Flowthru.Pipelines.Validation;
 /// </para>
 /// <code>
 /// public ICatalogDataset&lt;Company&gt; Companies =>
-///   GetOrCreateDataset(() => new CsvCatalogDataset&lt;Company&gt;("companies", "data/companies.csv")
+///   CreateDataset(() => new CsvCatalogDataset&lt;Company&gt;("companies", "data/companies.csv")
 ///     .WithInspectionLevel(InspectionLevel.Deep));
 /// </code>
 /// <para>
@@ -64,7 +64,7 @@ public class ValidationOptions
   /// This configuration only applies to Layer 0 inputs (external data).
   /// Intermediate outputs are never inspected regardless of this setting.
   /// </remarks>
-  public ValidationOptions Inspect(ICatalogEntry catalogEntry, InspectionLevel level)
+  public ValidationOptions Inspect(IItem catalogEntry, InspectionLevel level)
   {
     if (catalogEntry == null)
     {
@@ -112,7 +112,7 @@ public ValidationOptions Inspect(ICatalogEntry catalogEntry, InspectionLevel lev
   /// (e.g., skipping validation in performance tests, or enabling deep validation during debugging).
   /// </para>
   /// </remarks>
-  internal InspectionLevel GetEffectiveInspectionLevel(ICatalogEntry catalogEntry)
+  internal InspectionLevel GetEffectiveInspectionLevel(IItem catalogEntry)
   {
     if (catalogEntry == null)
     {
diff --git a/src/core/Flowthru.Core/Pipelines/ValidationDepth.cs b/src/core/Flowthru.Core/Flows/ValidationDepth.cs
similarity index 94%
rename from src/core/Flowthru.Core/Pipelines/ValidationDepth.cs
rename to src/core/Flowthru.Core/Flows/ValidationDepth.cs
index 8bea7440..24d1af46 100644
--- a/src/core/Flowthru.Core/Pipelines/ValidationDepth.cs
+++ b/src/core/Flowthru.Core/Flows/ValidationDepth.cs
@@ -1,4 +1,4 @@
-namespace Flowthru.Pipelines;
+namespace Flowthru.Flows;
 
 /// <summary>
 /// Controls how deeply a dry run validates the pipeline before stopping.
diff --git a/src/core/Flowthru.Core/Meta/Builders/DagBuilder.cs b/src/core/Flowthru.Core/Meta/Builders/DagBuilder.cs
index bded1a66..1e0c7f91 100644
--- a/src/core/Flowthru.Core/Meta/Builders/DagBuilder.cs
+++ b/src/core/Flowthru.Core/Meta/Builders/DagBuilder.cs
@@ -1,6 +1,6 @@
 using Flowthru.Data;
+using Flowthru.Flows;
 using Flowthru.Meta.Models;
-using Flowthru.Pipelines;
 
 namespace Flowthru.Meta.Builders;
 
@@ -26,7 +26,7 @@ internal static class DagBuilder
   /// <param name="pipeline">The pipeline to extract metadata from (must be built)</param>
   /// <returns>Complete DAG metadata including nodes, catalog entries, and edges</returns>
   /// <exception cref="InvalidOperationException">Thrown if pipeline is not built</exception>
-  public static DagMetadata Build(Pipeline pipeline)
+  public static DagMetadata Build(Flow pipeline)
   {
     if (!pipeline.IsBuilt)
     {
@@ -36,21 +36,21 @@ public static DagMetadata Build(Pipeline pipeline)
     }
 
     // Always build from the full DAG to provide complete context
-    var allNodes = pipeline.NodesList;
-    var slicedNodes = pipeline.GetSlicedNodes();
+    var allSteps = pipeline.StepsList;
+    var slicedSteps = pipeline.GetSlicedSteps();
 
     var dag = new DagMetadata
     {
-      PipelineName = pipeline.Name ?? "UnnamedPipeline",
+      FlowName = pipeline.Name ?? "UnnamedPipeline",
       GeneratedAt = DateTime.UtcNow,
       AppliedSlice =
         pipeline.AppliedSlice != null ? DagSliceMetadata.FromStrategy(pipeline.AppliedSlice) : null,
-      SlicedNodeIds = slicedNodes != null ? slicedNodes.Select(n => n.Label).ToHashSet() : null,
-      SlicedCatalogEntryKeys =
-        slicedNodes != null
-          ? slicedNodes
+      SlicedStepIds = slicedSteps != null ? slicedSteps.Select(n => n.Label).ToHashSet() : null,
+      SlicedCatalogItemIds =
+        slicedSteps != null
+          ? slicedSteps
             .SelectMany(n => n.Outputs)
-            .SelectMany(ExpandCatalogEntry)
+            .SelectMany(ExpandCatalogItem)
             .Where(e => !e.Label.StartsWith("_nodata", StringComparison.OrdinalIgnoreCase))
             .Select(e => GetQualifiedLabel(e))
             .ToHashSet()
@@ -58,214 +58,211 @@ public static DagMetadata Build(Pipeline pipeline)
     };
 
     // Step 1: Extract all catalog entries from full DAG
-    var allCatalogEntries = ExtractCatalogEntries(allNodes);
+    var allCatalogItems = ExtractCatalogItems(allSteps);
 
     // Step 2: Build node metadata with layer information
-    dag.Nodes.AddRange(BuildNodeMetadata(allNodes));
+    dag.Steps.AddRange(BuildStepMetadata(allSteps));
 
     // Step 3: Build catalog entry metadata with producer-consumer relationships
-    dag.CatalogEntries.AddRange(BuildCatalogEntryMetadata(allCatalogEntries, dag.Nodes));
+    dag.CatalogItems.AddRange(BuildCatalogItemMetadata(allCatalogItems, dag.Steps));
 
     // Step 4: Generate edges representing data flow
-    dag.Edges.AddRange(BuildEdges(dag.Nodes, allCatalogEntries));
+    dag.Edges.AddRange(BuildEdges(dag.Steps, allCatalogItems));
 
     return dag;
   }
 
   /// <summary>
-  /// Extracts all unique catalog entries from the pipeline nodes.
+  /// Extracts all unique catalog items from the Flow steps.
   /// </summary>
   /// <remarks>
-  /// Handles both simple catalog entries and CatalogMap entries by expanding
-  /// maps into their constituent catalog entries.
+  /// Handles both simple catalog items and CatalogMap items by expanding
+  /// maps into their constituent parts.
   /// </remarks>
-  private static Dictionary<string, ICatalogEntry> ExtractCatalogEntries(List<PipelineNode> nodes)
+  private static Dictionary<string, IItem> ExtractCatalogItems(List<FlowStep> steps)
   {
-    var catalogEntries = new Dictionary<string, ICatalogEntry>();
+    var catalogItems = new Dictionary<string, IItem>();
 
-    foreach (var node in nodes)
+    foreach (var step in steps)
     {
       // Process inputs
-      foreach (var input in node.Inputs)
+      foreach (var input in step.Inputs)
       {
-        AddCatalogEntry(catalogEntries, input);
+        AddCatalogItem(catalogItems, input);
       }
 
       // Process outputs
-      foreach (var output in node.Outputs)
+      foreach (var output in step.Outputs)
       {
-        AddCatalogEntry(catalogEntries, output);
+        AddCatalogItem(catalogItems, output);
       }
     }
 
-    return catalogEntries;
+    return catalogItems;
   }
 
   /// <summary>
-  /// Adds a catalog entry to the dictionary, expanding CatalogMaps if necessary.
+  /// Adds a catalog item to the dictionary, expanding CatalogMaps if necessary.
   /// </summary>
-  private static void AddCatalogEntry(
-    Dictionary<string, ICatalogEntry> catalogEntries,
-    ICatalogEntry entry
-  )
+  private static void AddCatalogItem(Dictionary<string, IItem> catalogItems, IItem item)
   {
-    // Skip _nodata entries (placeholder entries that don't represent actual data)
-    if (entry.Label.StartsWith("_nodata", StringComparison.OrdinalIgnoreCase))
+    // Skip _nodata items (placeholder items that don't represent actual data)
+    if (item.Label.StartsWith("_nodata", StringComparison.OrdinalIgnoreCase))
     {
       return;
     }
 
-    // Check if this is a CatalogMap (which needs to be expanded into individual entries)
-    var entryType = entry.GetType();
-    if (entryType.IsGenericType && entryType.GetGenericTypeDefinition().Name == "CatalogMap`1")
+    // Check if this is a CatalogMap (which needs to be expanded into individual items)
+    var itemType = item.GetType();
+    if (itemType.IsGenericType && itemType.GetGenericTypeDefinition().Name == "CatalogMap`1")
     {
-      // Use reflection to get the mapped entries from CatalogMap
-      var getMappedEntriesMethod = entryType.GetMethod(
-        "GetMappedEntries",
+      // Use reflection to get the mapped items from CatalogMap
+      var getMappedItemsMethod = itemType.GetMethod(
+        "GetMappedItems",
         System.Reflection.BindingFlags.Instance | System.Reflection.BindingFlags.NonPublic
       );
 
-      if (getMappedEntriesMethod?.Invoke(entry, null) is IEnumerable<ICatalogEntry> mappedEntries)
+      if (getMappedItemsMethod?.Invoke(item, null) is IEnumerable<IItem> mappedItems)
       {
-        foreach (var mappedEntry in mappedEntries)
+        foreach (var mappedItem in mappedItems)
         {
-          // Skip _nodata entries in mapped entries too
-          if (!mappedEntry.Label.StartsWith("_nodata", StringComparison.OrdinalIgnoreCase))
+          // Skip _nodata in mapped items too
+          if (!mappedItem.Label.StartsWith("_nodata", StringComparison.OrdinalIgnoreCase))
           {
-            catalogEntries.TryAdd(GetQualifiedLabel(mappedEntry), mappedEntry);
+            catalogItems.TryAdd(GetQualifiedLabel(mappedItem), mappedItem);
           }
         }
       }
     }
     else
     {
-      // Simple catalog entry
-      catalogEntries.TryAdd(GetQualifiedLabel(entry), entry);
+      // Simple catalog item
+      catalogItems.TryAdd(GetQualifiedLabel(item), item);
     }
   }
 
   /// <summary>
-  /// Builds metadata for all nodes in the pipeline.
+  /// Builds metadata for all steps in the flow.
   /// </summary>
-  private static List<NodeMetadata> BuildNodeMetadata(List<PipelineNode> nodes)
+  private static List<StepMetadata> BuildStepMetadata(List<FlowStep> steps)
   {
-    var nodeMetadataList = new List<NodeMetadata>();
+    var stepMetadataList = new List<StepMetadata>();
 
-    foreach (var pipelineNode in nodes)
+    foreach (var flowStep in steps)
     {
-      // Use node name directly (no longer extracting from instance type)
-      var nodeTypeName = pipelineNode.Label;
+      // Use step name directly (no longer extracting from instance type)
+      var stepLabel = flowStep.Label;
 
       // Get input catalog keys (expanding CatalogMaps, filtering _nodata)
-      var inputKeys = pipelineNode
-        .Inputs.SelectMany(ExpandCatalogEntry)
+      var inputKeys = flowStep
+        .Inputs.SelectMany(ExpandCatalogItem)
         .Where(e => !e.Label.StartsWith("_nodata", StringComparison.OrdinalIgnoreCase))
         .Select(e => GetQualifiedLabel(e))
         .ToList();
 
       // Get output catalog keys (expanding CatalogMaps, filtering _nodata)
-      var outputKeys = pipelineNode
-        .Outputs.SelectMany(ExpandCatalogEntry)
+      var outputKeys = flowStep
+        .Outputs.SelectMany(ExpandCatalogItem)
         .Where(e => !e.Label.StartsWith("_nodata", StringComparison.OrdinalIgnoreCase))
         .Select(e => GetQualifiedLabel(e))
         .ToList();
 
-      // Extract original pipeline name from node name if merged
-      // Merged nodes have format: "PipelineName.NodeName"
-      var originalPipelineName = ExtractOriginalPipelineName(pipelineNode.Label);
+      // Extract original flow name from Flow label if merged
+      // Merged nodes have format: "FlowName.StepName"
+      var originalFlowName = ExtractOriginalFlowName(flowStep.Label);
 
-      nodeMetadataList.Add(
-        new NodeMetadata
+      stepMetadataList.Add(
+        new StepMetadata
         {
-          Id = pipelineNode.Label,
-          Label = pipelineNode.Label,
-          NodeType = nodeTypeName,
-          Layer = pipelineNode.Layer,
-          PipelineName = originalPipelineName ?? "UnnamedPipeline",
+          Id = flowStep.Label,
+          Label = flowStep.Label,
+          StepType = stepLabel,
+          Layer = flowStep.Layer,
+          FlowName = originalFlowName ?? "UnnamedFlow",
           Inputs = inputKeys,
           Outputs = outputKeys,
         }
       );
     }
 
-    return nodeMetadataList;
+    return stepMetadataList;
   }
 
   /// <summary>
-  /// Extracts the original pipeline name from a node name in a merged pipeline.
+  /// Extracts the original Flow name from a step name in a merged pipeline.
   /// </summary>
-  /// <param name="nodeName">The node name (may be prefixed with pipeline name)</param>
-  /// <returns>The original pipeline name if detected, otherwise null</returns>
+  /// <param name="stepName">The step name (may be prefixed with Flow name)</param>
+  /// <returns>The original Flow name if detected, otherwise null</returns>
   /// <remarks>
-  /// In merged pipelines, node names are prefixed with their original pipeline name
+  /// In merged flows, step names are prefixed with their original subflow name
   /// (e.g., "DataProcessing.PreprocessCompanies"). This method extracts that prefix.
-  /// For non-merged pipelines, returns null.
+  /// For non-merged flows, returns null.
   /// </remarks>
-  private static string? ExtractOriginalPipelineName(string nodeName)
+  private static string? ExtractOriginalFlowName(string stepName)
   {
-    // Check if node name contains a dot (indicating it's from a merged pipeline)
-    var dotIndex = nodeName.IndexOf('.');
+    // Check if step name contains a dot (indicating it's from a merged flow)
+    var dotIndex = stepName.IndexOf('.');
     if (dotIndex > 0)
     {
-      // Extract the prefix before the first dot as the original pipeline name
-      return nodeName.Substring(0, dotIndex);
+      // Extract the prefix before the first dot as the original Flow name
+      return stepName.Substring(0, dotIndex);
     }
 
-    // No prefix found - use the current pipeline name
-    return "UnnamedPipeline";
+    // No prefix found - use the current Flow name
+    return "UnnamedFlow";
   }
 
   /// <summary>
-  /// Expands a catalog entry, returning multiple entries if it's a CatalogMap.
+  /// Expands a catalog item, returning multiple items if it's a CatalogMap.
   /// </summary>
-  private static IEnumerable<ICatalogEntry> ExpandCatalogEntry(ICatalogEntry entry)
+  private static IEnumerable<IItem> ExpandCatalogItem(IItem item)
   {
-    var entryType = entry.GetType();
-    if (entryType.IsGenericType && entryType.GetGenericTypeDefinition().Name == "CatalogMap`1")
+    var itemType = item.GetType();
+    if (itemType.IsGenericType && itemType.GetGenericTypeDefinition().Name == "CatalogMap`1")
     {
-      var getMappedEntriesMethod = entryType.GetMethod(
-        "GetMappedEntries",
+      var getMappedItemsMethod = itemType.GetMethod(
+        "GetMappedItems",
         System.Reflection.BindingFlags.Instance | System.Reflection.BindingFlags.NonPublic
       );
 
-      if (getMappedEntriesMethod?.Invoke(entry, null) is IEnumerable<ICatalogEntry> mappedEntries)
+      if (getMappedItemsMethod?.Invoke(item, null) is IEnumerable<IItem> mappedItems)
       {
-        return mappedEntries;
+        return mappedItems;
       }
     }
 
-    return new[] { entry };
+    return new[] { item };
   }
 
   /// <summary>
-  /// Builds metadata for all catalog entries with producer-consumer relationships.
+  /// Builds metadata for all catalog items with producer-consumer relationships.
   /// </summary>
-  private static List<CatalogEntryMetadata> BuildCatalogEntryMetadata(
-    Dictionary<string, ICatalogEntry> catalogEntries,
-    List<NodeMetadata> nodes
+  private static List<ItemMetadata> BuildCatalogItemMetadata(
+    Dictionary<string, IItem> catalogItems,
+    List<StepMetadata> steps
   )
   {
-    var entries = new List<CatalogEntryMetadata>();
+    var entries = new List<ItemMetadata>();
 
-    foreach (var (key, entry) in catalogEntries)
+    foreach (var (key, entry) in catalogItems)
     {
       // Find producer (node that outputs this catalog entry)
-      var producer = nodes.FirstOrDefault(n => n.Outputs.Contains(key));
+      var producer = steps.FirstOrDefault(n => n.Outputs.Contains(key));
 
       // Find consumers (nodes that input this catalog entry)
-      var consumers = nodes.Where(n => n.Inputs.Contains(key)).Select(n => n.Id).ToList();
+      var consumers = steps.Where(n => n.Inputs.Contains(key)).Select(n => n.Id).ToList();
 
       // Extract simple type name from DataType
       var dataTypeName = GetSimpleTypeName(entry.DataType);
 
       // Build fields dictionary with additional metadata
-      var fields = BuildCatalogEntryFields(entry);
+      var fields = BuildCatalogItemFields(entry);
 
       // Generate schema (will be implemented in SchemaInference)
       var schema = SchemaInference.InferSchema(entry.DataType);
 
       entries.Add(
-        new CatalogEntryMetadata
+        new ItemMetadata
         {
           Key = key,
           Label = key,
@@ -288,10 +285,10 @@ List<NodeMetadata> nodes
   /// Extracts metadata like filepath, catalog type, read-only status, etc.
   /// using reflection to check for well-known properties.
   /// </remarks>
-  private static Dictionary<string, object> BuildCatalogEntryFields(ICatalogEntry entry)
+  private static Dictionary<string, object> BuildCatalogItemFields(IItem item)
   {
     var fields = new Dictionary<string, object>();
-    var entryType = entry.GetType();
+    var entryType = item.GetType();
 
     // Add catalog type name
     fields["catalogType"] = GetSimpleTypeName(entryType);
@@ -300,7 +297,7 @@ private static Dictionary<string, object> BuildCatalogEntryFields(ICatalogEntry
     var filePathProperty = entryType.GetProperty("FilePath");
     if (filePathProperty != null)
     {
-      var filePath = filePathProperty.GetValue(entry);
+      var filePath = filePathProperty.GetValue(item);
       if (filePath != null)
       {
         fields["filepath"] = filePath;
@@ -308,7 +305,7 @@ private static Dictionary<string, object> BuildCatalogEntryFields(ICatalogEntry
     }
 
     // Check if read-only using StorageTraits
-    var adapter = entry.GetType().GetProperty("Adapter")?.GetValue(entry);
+    var adapter = item.GetType().GetProperty("Adapter")?.GetValue(item);
     if (adapter != null)
     {
       var traitsProperty = adapter.GetType().GetProperty("Traits");
@@ -323,35 +320,35 @@ private static Dictionary<string, object> BuildCatalogEntryFields(ICatalogEntry
     }
 
     // Get inspection level if configured
-    if (entry.PreferredInspectionLevel.HasValue)
+    if (item.PreferredInspectionLevel.HasValue)
     {
-      fields["inspectionLevel"] = entry.PreferredInspectionLevel.Value.ToString();
+      fields["inspectionLevel"] = item.PreferredInspectionLevel.Value.ToString();
     }
 
     return fields;
   }
 
   /// <summary>
-  /// Builds edges representing data flow in the DAG.
+  /// Builds edges representing data Flow in the DAG.
   /// </summary>
   /// <remarks>
   /// Creates two types of edges:
-  /// 1. Catalog Entry → Node (node reads from catalog)
-  /// 2. Node → Catalog Entry (node writes to catalog)
+  /// 1. Catalog Item → Step (node reads from catalog)
+  /// 2. Step → Catalog Item (node writes to catalog)
   /// </remarks>
   private static List<EdgeMetadata> BuildEdges(
-    List<NodeMetadata> nodes,
-    Dictionary<string, ICatalogEntry> catalogEntries
+    List<StepMetadata> steps,
+    Dictionary<string, IItem> catalogItems
   )
   {
     var edges = new List<EdgeMetadata>();
 
-    foreach (var node in nodes)
+    foreach (var step in steps)
     {
-      // Create edges for inputs (Catalog → Node)
-      foreach (var inputKey in node.Inputs)
+      // Create edges for inputs (Catalog Item → Step)
+      foreach (var inputKey in step.Inputs)
       {
-        if (catalogEntries.TryGetValue(inputKey, out var catalogEntry))
+        if (catalogItems.TryGetValue(inputKey, out var catalogEntry))
         {
           var dataTypeName = GetSimpleTypeName(catalogEntry.DataType);
 
@@ -359,24 +356,24 @@ Dictionary<string, ICatalogEntry> catalogEntries
             new EdgeMetadata
             {
               Source = inputKey,
-              Target = node.Id,
+              Target = step.Id,
               DataType = dataTypeName,
             }
           );
         }
       }
 
-      // Create edges for outputs (Node → Catalog)
-      foreach (var outputKey in node.Outputs)
+      // Create edges for outputs (Step → Catalog)
+      foreach (var outputKey in step.Outputs)
       {
-        if (catalogEntries.TryGetValue(outputKey, out var catalogEntry))
+        if (catalogItems.TryGetValue(outputKey, out var catalogEntry))
         {
           var dataTypeName = GetSimpleTypeName(catalogEntry.DataType);
 
           edges.Add(
             new EdgeMetadata
             {
-              Source = node.Id,
+              Source = step.Id,
               Target = outputKey,
               DataType = dataTypeName,
             }
@@ -412,11 +409,11 @@ private static string GetSimpleTypeName(Type type)
   }
 
   /// <summary>
-  /// Returns the fully-qualified metadata label for a catalog entry.
-  /// When the entry was created via <c>DataCatalogBase.GetOrCreateEntry</c> the catalog's
-  /// <c>CatalogLabel</c> is prepended: <c>"CatalogName.EntryLabel"</c>.
-  /// Falls back to <c>entry.Label</c> for entries created outside a catalog.
+  /// Returns the fully-qualified metadata label for a catalog item.
+  /// When the item was created via <c>DataCatalogBase.CreateItem</c> the catalog's
+  /// <c>CatalogLabel</c> is prepended: <c>"CatalogName.ItemLabel"</c>.
+  /// Falls back to <c>item.Label</c> for items created outside a catalog.
   /// </summary>
-  private static string GetQualifiedLabel(ICatalogEntry entry) =>
-    entry.OwningCatalogLabel is { } catalog ? $"{catalog}.{entry.Label}" : entry.Label;
+  private static string GetQualifiedLabel(IItem item) =>
+    item.OwningCatalogLabel is { } catalog ? $"{catalog}.{item.Label}" : item.Label;
 }
diff --git a/src/core/Flowthru.Core/Meta/FilenameTemplateParser.cs b/src/core/Flowthru.Core/Meta/FilenameTemplateParser.cs
index 18428bcf..c4d77d0b 100644
--- a/src/core/Flowthru.Core/Meta/FilenameTemplateParser.cs
+++ b/src/core/Flowthru.Core/Meta/FilenameTemplateParser.cs
@@ -12,7 +12,7 @@ namespace Flowthru.Meta;
 /// Supports tokens for pipeline metadata and slice criteria:
 /// </para>
 /// <list type="bullet">
-/// <item><c>{PipelineName}</c> - Sanitized pipeline name</item>
+/// <item><c>{FlowName}</c> - Sanitized pipeline name</item>
 /// <item><c>{Timestamp}</c> - Formatted timestamp (empty if disabled)</item>
 /// <item><c>{SliceType}</c> - Slice descriptor: "FromNodes", "Tags", "Mixed", or empty</item>
 /// <item><c>{Pipelines}</c> - Comma-separated list of pipelines</item>
@@ -32,7 +32,7 @@ namespace Flowthru.Meta;
 /// <strong>Example:</strong>
 /// </para>
 /// <code>
-/// Template: "dag-{PipelineName}-{Timestamp}-{SliceType}"
+/// Template: "dag-{FlowName}-{Timestamp}-{SliceType}"
 /// Unsliced: "dag-DataProcessing-20260304-153045"
 /// Sliced:   "dag-DataProcessing-20260304-153045-FromNodes"
 /// </code>
@@ -57,7 +57,7 @@ public static string Render(DagMetadata dag, string template, string? timestamp)
         var token = match.Groups[1].Value;
         return token switch
         {
-          "PipelineName" => SanitizeFilename(dag.PipelineName),
+          "FlowName" => SanitizeFilename(dag.FlowName),
           "Timestamp" => timestamp ?? string.Empty,
           "SliceType" => dag.AppliedSlice?.GetSliceTypeDescriptor() ?? string.Empty,
           "Pipelines" => FormatList(dag.AppliedSlice?.Pipelines),
diff --git a/src/core/Flowthru.Core/Meta/JsonMetadataProviderBuilder.cs b/src/core/Flowthru.Core/Meta/JsonMetadataProviderBuilder.cs
index 86723c3b..aba82114 100644
--- a/src/core/Flowthru.Core/Meta/JsonMetadataProviderBuilder.cs
+++ b/src/core/Flowthru.Core/Meta/JsonMetadataProviderBuilder.cs
@@ -9,7 +9,7 @@ namespace Flowthru.Meta;
 public class JsonMetadataProviderBuilder
 {
   private string _outputDirectory = "metadata";
-  private string _filenameTemplate = "dag-{PipelineName}-{Timestamp}-{SliceType}";
+  private string _filenameTemplate = "dag-{FlowName}-{Timestamp}-{SliceType}";
   private TimestampConfiguration _timestampConfig = new();
   private bool _useCompactFormat = false;
   private ILogger? _logger;
@@ -28,7 +28,7 @@ public JsonMetadataProviderBuilder WithOutputDirectory(string directory)
   /// <summary>
   /// Sets the filename template for metadata files.
   /// </summary>
-  /// <param name="template">Template with placeholders: {PipelineName}, {Timestamp}, {SliceType}</param>
+  /// <param name="template">Template with placeholders: {FlowName}, {Timestamp}, {SliceType}</param>
   /// <returns>This builder for fluent chaining</returns>
   public JsonMetadataProviderBuilder WithFilenameTemplate(string template)
   {
diff --git a/src/core/Flowthru.Core/Meta/MermaidMetadataExtensions.cs b/src/core/Flowthru.Core/Meta/MermaidMetadataExtensions.cs
index 14481674..19fe0a6b 100644
--- a/src/core/Flowthru.Core/Meta/MermaidMetadataExtensions.cs
+++ b/src/core/Flowthru.Core/Meta/MermaidMetadataExtensions.cs
@@ -13,11 +13,11 @@ namespace Flowthru.Meta;
 /// </para>
 /// <para>
 /// The generated diagram uses Mermaid flowchart syntax with:
-/// - Nodes as rectangles with rounded corners
-/// - Catalog entries as cylindrical database shapes
-/// - Pipeline subgraphs grouping nodes by their origin pipeline
+/// - Steps as rectangles with rounded corners
+/// - Catalog items as cylindrical database shapes
+/// - Flow subgraphs grouping nodes by their origin flow
 /// - External data (no producer) shown with special styling
-/// - Produced data (has producer) inside their producer's pipeline subgraph
+/// - Produced data (has producer) inside their producer's Flow subgraph
 /// </para>
 /// </remarks>
 public static class MermaidMetadataExtensions
@@ -27,8 +27,8 @@ public static class MermaidMetadataExtensions
   /// </summary>
   /// <param name="dag">The DAG metadata to visualize</param>
   /// <param name="direction">Flow direction code (TB, LR, BT, RL). Defaults to TB (Top to Bottom).</param>
-  /// <param name="activeNodeColor">Hex color for active (sliced) nodes. Defaults to #2E7D32.</param>
-  /// <param name="activeDataColor">Hex color for active (sliced) catalog entries. Defaults to #2E7D32.</param>
+  /// <param name="activeStepColor">Hex color for active (sliced) steps. Defaults to #2E7D32.</param>
+  /// <param name="activeItemColor">Hex color for active (sliced) catalog items. Defaults to #2E7D32.</param>
   /// <returns>Complete Markdown document with Mermaid code fence</returns>
   /// <remarks>
   /// <para>
@@ -55,8 +55,8 @@ public static class MermaidMetadataExtensions
   public static string ToMermaidDiagram(
     this DagMetadata dag,
     string direction = "TB",
-    string activeNodeColor = "#2E7D32",
-    string activeDataColor = "#2E7D32"
+    string activeStepColor = "#2E7D32",
+    string activeItemColor = "#2E7D32"
   )
   {
     var sb = new StringBuilder();
@@ -66,98 +66,96 @@ public static string ToMermaidDiagram(
     sb.AppendLine($"flowchart {direction}");
     sb.AppendLine();
 
-    // Classify catalog entries into external and produced
-    var externalEntries = dag.CatalogEntries.Where(e => string.IsNullOrEmpty(e.Producer)).ToList();
+    // Classify catalog items into external and produced
+    var externalItems = dag.CatalogItems.Where(e => string.IsNullOrEmpty(e.Producer)).ToList();
 
-    var producedEntries = dag.CatalogEntries.Where(e => !string.IsNullOrEmpty(e.Producer)).ToList();
+    var producedItems = dag.CatalogItems.Where(e => !string.IsNullOrEmpty(e.Producer)).ToList();
 
     // Define all external data inputs first (cylindrical database shape)
-    if (externalEntries.Any())
+    if (externalItems.Any())
     {
       sb.AppendLine("    %% External Data Inputs");
-      foreach (var entry in externalEntries)
+      foreach (var item in externalItems)
       {
-        sb.AppendLine($"    {SanitizeId(entry.Key)}[(\"{EscapeLabel(entry.Label)}\")]");
+        sb.AppendLine($"    {SanitizeId(item.Key)}[(\"{EscapeLabel(item.Label)}\")]");
       }
       sb.AppendLine();
     }
 
-    // Group nodes by pipeline
-    var pipelineGroups = dag.Nodes.GroupBy(n => n.PipelineName).OrderBy(g => g.Key);
+    // Group steps by flow
+    var flowGroups = dag.Steps.GroupBy(n => n.FlowName).OrderBy(g => g.Key);
 
-    foreach (var pipelineGroup in pipelineGroups)
+    foreach (var flowGroup in flowGroups)
     {
-      var pipelineName = pipelineGroup.Key;
-      var pipelineNodes = pipelineGroup.OrderBy(n => n.Layer).ThenBy(n => n.Id).ToList();
+      var flowName = flowGroup.Key;
+      var flowSteps = flowGroup.OrderBy(n => n.Layer).ThenBy(n => n.Id).ToList();
 
-      sb.AppendLine($"    subgraph {SanitizeId(pipelineName)}[\"{EscapeLabel(pipelineName)}\"]");
+      sb.AppendLine($"    subgraph {SanitizeId(flowName)}[\"{EscapeLabel(flowName)}\"]");
 
-      // Find produced catalog entries that belong to this pipeline
-      var pipelineCatalogEntries = producedEntries
-        .Where(e => pipelineNodes.Any(n => n.Id == e.Producer))
-        .ToList();
+      // Find produced catalog items that belong to this flow
+      var flowItems = producedItems.Where(e => flowSteps.Any(n => n.Id == e.Producer)).ToList();
 
-      // Define nodes (rectangles) with styling for sliced nodes
-      foreach (var node in pipelineNodes)
+      // Define steps (rectangles) with styling for steps in the slice
+      foreach (var step in flowSteps)
       {
-        var nodeId = SanitizeId(node.Id);
-        var nodeLabel = EscapeLabel(node.Label);
+        var stepId = SanitizeId(step.Id);
+        var stepLabel = EscapeLabel(step.Label);
 
-        // Apply color fill to nodes in the execution slice
-        if (dag.SlicedNodeIds != null && dag.SlicedNodeIds.Contains(node.Id))
+        // Apply color fill to steps in the execution slice
+        if (dag.SlicedStepIds != null && dag.SlicedStepIds.Contains(step.Id))
         {
-          sb.AppendLine($"        {nodeId}[\"{nodeLabel}\"]");
-          sb.AppendLine($"        style {nodeId} fill:{activeNodeColor}");
+          sb.AppendLine($"        {stepId}[\"{stepLabel}\"]");
+          sb.AppendLine($"        style {stepId} fill:{activeStepColor}");
         }
         else
         {
-          sb.AppendLine($"        {nodeId}[\"{nodeLabel}\"]");
+          sb.AppendLine($"        {stepId}[\"{stepLabel}\"]");
         }
       }
 
-      // Define catalog entries produced by this pipeline (cylindrical database shape)
-      foreach (var entry in pipelineCatalogEntries)
+      // Define catalog items produced by this Flow (cylindrical database shape)
+      foreach (var item in flowItems)
       {
-        var entryId = SanitizeId(entry.Key);
-        var entryLabel = EscapeLabel(entry.Label);
+        var itemId = SanitizeId(item.Key);
+        var itemLabel = EscapeLabel(item.Label);
 
-        sb.AppendLine($"        {entryId}[(\"{entryLabel}\")]");
+        sb.AppendLine($"        {itemId}[(\"{itemLabel}\")]");
 
-        // Apply color fill to catalog entries in the execution slice
-        if (dag.SlicedCatalogEntryKeys != null && dag.SlicedCatalogEntryKeys.Contains(entry.Key))
+        // Apply color fill to catalog items in the execution slice
+        if (dag.SlicedCatalogItemIds != null && dag.SlicedCatalogItemIds.Contains(item.Key))
         {
-          sb.AppendLine($"        style {entryId} fill:{activeDataColor}");
+          sb.AppendLine($"        style {itemId} fill:{activeItemColor}");
         }
       }
 
       sb.AppendLine();
 
-      // Generate edges for this pipeline
-      foreach (var node in pipelineNodes)
+      // Generate edges for this flow
+      foreach (var step in flowSteps)
       {
-        // Input edges - only include if the input is produced by this pipeline (not external!)
-        foreach (var input in node.Inputs)
+        // Input edges - only include if the input is produced by this Flow (not external!)
+        foreach (var input in step.Inputs)
         {
-          var inputEntry = dag.CatalogEntries.FirstOrDefault(e => e.Key == input);
-          if (inputEntry != null)
+          var inputItem = dag.CatalogItems.FirstOrDefault(e => e.Key == input);
+          if (inputItem != null)
           {
-            var isProducedByThisPipeline = pipelineCatalogEntries.Any(e => e.Key == input);
+            var isProducedByThisFlow = flowItems.Any(e => e.Key == input);
 
-            // Only include edges from data produced within this pipeline
-            if (isProducedByThisPipeline)
+            // Only include edges from data produced within this flow
+            if (isProducedByThisFlow)
             {
-              sb.AppendLine($"        {SanitizeId(input)} --> {SanitizeId(node.Id)}");
+              sb.AppendLine($"        {SanitizeId(input)} --> {SanitizeId(step.Id)}");
             }
           }
         }
 
-        // Output edges - node to its produced catalog entries
-        foreach (var output in node.Outputs)
+        // Output edges - step to its produced catalog items
+        foreach (var output in step.Outputs)
         {
-          var catalogEntry = pipelineCatalogEntries.FirstOrDefault(e => e.Key == output);
-          if (catalogEntry != null)
+          var catalogItem = flowItems.FirstOrDefault(e => e.Key == output);
+          if (catalogItem != null)
           {
-            sb.AppendLine($"        {SanitizeId(node.Id)} --> {SanitizeId(output)}");
+            sb.AppendLine($"        {SanitizeId(step.Id)} --> {SanitizeId(output)}");
           }
         }
       }
@@ -166,47 +164,47 @@ public static string ToMermaidDiagram(
       sb.AppendLine();
     }
 
-    // Generate external data to node edges (outside subgraphs)
-    sb.AppendLine("    %% External Data to Pipeline Edges");
-    foreach (var entry in externalEntries)
+    // Generate external data to step edges (outside subgraphs)
+    sb.AppendLine("    %% External Data to Flow Edges");
+    foreach (var item in externalItems)
     {
-      foreach (var consumer in entry.Consumers)
+      foreach (var consumer in item.Consumers)
       {
-        var consumerNode = dag.Nodes.FirstOrDefault(n => n.Id == consumer);
-        if (consumerNode != null)
+        var consumerStep = dag.Steps.FirstOrDefault(n => n.Id == consumer);
+        if (consumerStep != null)
         {
-          sb.AppendLine($"    {SanitizeId(entry.Key)} --> {SanitizeId(consumer)}");
+          sb.AppendLine($"    {SanitizeId(item.Key)} --> {SanitizeId(consumer)}");
         }
       }
     }
     sb.AppendLine();
 
-    // Generate cross-pipeline edges (catalog entries that connect different pipelines)
-    var crossPipelineEdges = new List<(string source, string target)>();
+    // Generate cross-flow edges (catalog items that connect different flows)
+    var crossFlowEdges = new List<(string source, string target)>();
 
-    foreach (var entry in producedEntries)
+    foreach (var item in producedItems)
     {
-      var producerNode = dag.Nodes.FirstOrDefault(n => n.Id == entry.Producer);
-      if (producerNode == null)
+      var producerStep = dag.Steps.FirstOrDefault(n => n.Id == item.Producer);
+      if (producerStep == null)
       {
         continue;
       }
 
-      foreach (var consumer in entry.Consumers)
+      foreach (var consumer in item.Consumers)
       {
-        var consumerNode = dag.Nodes.FirstOrDefault(n => n.Id == consumer);
-        if (consumerNode != null && consumerNode.PipelineName != producerNode.PipelineName)
+        var consumerStep = dag.Steps.FirstOrDefault(n => n.Id == consumer);
+        if (consumerStep != null && consumerStep.FlowName != producerStep.FlowName)
         {
-          // This catalog entry connects two different pipelines
-          crossPipelineEdges.Add((entry.Key, consumer));
+          // This catalog item connects two different flows
+          crossFlowEdges.Add((item.Key, consumer));
         }
       }
     }
 
-    if (crossPipelineEdges.Any())
+    if (crossFlowEdges.Any())
     {
-      sb.AppendLine("    %% Cross-Pipeline Data Flow");
-      foreach (var (source, target) in crossPipelineEdges.Distinct())
+      sb.AppendLine("    %% Cross-Flow Data Flow");
+      foreach (var (source, target) in crossFlowEdges.Distinct())
       {
         sb.AppendLine($"    {SanitizeId(source)} -.-> {SanitizeId(target)}");
       }
diff --git a/src/core/Flowthru.Core/Meta/MermaidMetadataProviderBuilder.cs b/src/core/Flowthru.Core/Meta/MermaidMetadataProviderBuilder.cs
index 26549f9b..85f47c93 100644
--- a/src/core/Flowthru.Core/Meta/MermaidMetadataProviderBuilder.cs
+++ b/src/core/Flowthru.Core/Meta/MermaidMetadataProviderBuilder.cs
@@ -9,12 +9,12 @@ namespace Flowthru.Meta;
 public class MermaidMetadataProviderBuilder
 {
   private string _outputDirectory = "metadata";
-  private string _filenameTemplate = "dag-{PipelineName}-{Timestamp}-{SliceType}";
+  private string _filenameTemplate = "dag-{FlowName}-{Timestamp}-{SliceType}";
   private TimestampConfiguration _timestampConfig = new();
   private MermaidMetadataProvider.MermaidFlowchartDirection _direction = MermaidMetadataProvider
     .MermaidFlowchartDirection
     .TopToBottom;
-  private string _activeNodeColor = "#2E7D32";
+  private string _activeStepColor = "#2E7D32";
   private string _activeDataColor = "#2E7D32";
   private ILogger? _logger;
 
@@ -32,7 +32,7 @@ public MermaidMetadataProviderBuilder WithOutputDirectory(string directory)
   /// <summary>
   /// Sets the filename template for metadata files.
   /// </summary>
-  /// <param name="template">Template with placeholders: {PipelineName}, {Timestamp}, {SliceType}</param>
+  /// <param name="template">Template with placeholders: {FlowName}, {Timestamp}, {SliceType}</param>
   /// <returns>This builder for fluent chaining</returns>
   public MermaidMetadataProviderBuilder WithFilenameTemplate(string template)
   {
@@ -69,9 +69,9 @@ MermaidMetadataProvider.MermaidFlowchartDirection direction
   /// </summary>
   /// <param name="color">Hex color code (e.g., "#2E7D32")</param>
   /// <returns>This builder for fluent chaining</returns>
-  public MermaidMetadataProviderBuilder WithActiveNodeColor(string color)
+  public MermaidMetadataProviderBuilder WithActiveStepColor(string color)
   {
-    _activeNodeColor = color ?? throw new ArgumentNullException(nameof(color));
+    _activeStepColor = color ?? throw new ArgumentNullException(nameof(color));
     return this;
   }
 
@@ -108,7 +108,7 @@ public MermaidMetadataProvider Build()
       _filenameTemplate,
       _timestampConfig,
       _direction,
-      _activeNodeColor,
+      _activeStepColor,
       _activeDataColor,
       _logger
     );
diff --git a/src/core/Flowthru.Core/Meta/MetadataJsonExtensions.cs b/src/core/Flowthru.Core/Meta/MetadataJsonExtensions.cs
index 5b98a28e..814f4dbb 100644
--- a/src/core/Flowthru.Core/Meta/MetadataJsonExtensions.cs
+++ b/src/core/Flowthru.Core/Meta/MetadataJsonExtensions.cs
@@ -33,7 +33,7 @@ public static class MetadataJsonExtensions
   /// Output format uses:
   /// </para>
   /// <list type="bullet">
-  /// <item>camelCase property names (pipelineName, not PipelineName)</item>
+  /// <item>camelCase property names (pipelineName, not FlowName)</item>
   /// <item>Indented formatting for readability</item>
   /// <item>Null properties omitted</item>
   /// <item>Enums serialized as strings</item>
diff --git a/src/core/Flowthru.Core/Meta/Models/CatalogEntryMetadata.cs b/src/core/Flowthru.Core/Meta/Models/CatalogEntryMetadata.cs
index 2a461ab6..2aeb3c8e 100644
--- a/src/core/Flowthru.Core/Meta/Models/CatalogEntryMetadata.cs
+++ b/src/core/Flowthru.Core/Meta/Models/CatalogEntryMetadata.cs
@@ -3,17 +3,17 @@
 namespace Flowthru.Meta.Models;
 
 /// <summary>
-/// Metadata describing a single catalog entry (dataset) in the pipeline.
+/// Metadata describing a single catalog item (dataset, json object, API response, whatever) in the flow.
 /// </summary>
 /// <remarks>
-/// Catalog entries represent data sources and sinks. They can be external files,
-/// intermediate pipeline outputs, or final results. Each entry is uniquely identified
+/// Catalog items represent data sources and sinks. They can be external files,
+/// intermediate Flow outputs, or final results. Each item is uniquely identified
 /// by its key.
 /// </remarks>
-public class CatalogEntryMetadata
+public class ItemMetadata
 {
   /// <summary>
-  /// Unique key identifying this catalog entry.
+  /// Unique key identifying this catalog item.
   /// </summary>
   /// <remarks>
   /// Corresponds to the catalog property name or explicitly set key.
@@ -23,7 +23,7 @@ public class CatalogEntryMetadata
   public required string Key { get; init; }
 
   /// <summary>
-  /// Human-readable display label for this catalog entry.
+  /// Human-readable display label for this catalog item.
   /// </summary>
   /// <remarks>
   /// May be formatted for better display in Flowthru.Viz.
@@ -33,7 +33,7 @@ public class CatalogEntryMetadata
   public required string Label { get; init; }
 
   /// <summary>
-  /// The C# type name of data stored in this catalog entry.
+  /// The C# type name of data stored in this catalog item.
   /// </summary>
   /// <remarks>
   /// Simple type name without namespace.
@@ -53,7 +53,7 @@ public class CatalogEntryMetadata
   public SchemaMetadata? Schema { get; init; }
 
   /// <summary>
-  /// Additional metadata fields specific to the catalog entry type.
+  /// Additional metadata fields specific to the catalog item type.
   /// </summary>
   /// <remarks>
   /// <para>Examples of fields:</para>
@@ -68,20 +68,20 @@ public class CatalogEntryMetadata
   public Dictionary<string, object> Fields { get; init; } = new();
 
   /// <summary>
-  /// Node ID that produces (writes to) this catalog entry.
+  /// Step ID that produces (writes to) this catalog item.
   /// </summary>
   /// <remarks>
-  /// Null for external inputs (Layer 0 inputs that exist before pipeline execution).
+  /// Null for external inputs (Layer 0 inputs that exist before Flow execution).
   /// Example: "PreprocessCompanies"
   /// </remarks>
   [JsonPropertyName("producer")]
   public string? Producer { get; init; }
 
   /// <summary>
-  /// List of node IDs that consume (read from) this catalog entry.
+  /// List of step IDs that consume (read from) this catalog item.
   /// </summary>
   /// <remarks>
-  /// Empty for pipeline outputs that aren't consumed by other nodes.
+  /// Empty for item outputs that aren't consumed by other steps.
   /// Example: ["CreateModelInputTable", "ValidateData"]
   /// </remarks>
   [JsonPropertyName("consumers")]
diff --git a/src/core/Flowthru.Core/Meta/Models/DagMetadata.cs b/src/core/Flowthru.Core/Meta/Models/DagMetadata.cs
index f04d779f..816e5d8b 100644
--- a/src/core/Flowthru.Core/Meta/Models/DagMetadata.cs
+++ b/src/core/Flowthru.Core/Meta/Models/DagMetadata.cs
@@ -3,20 +3,20 @@
 namespace Flowthru.Meta.Models;
 
 /// <summary>
-/// Root metadata model representing a complete pipeline DAG (Directed Acyclic Graph).
+/// Root metadata model representing a complete FlowthruService DAG (Directed Acyclic Graph).
 /// </summary>
 /// <remarks>
-/// This model captures the structure of a built pipeline, including all nodes,
-/// catalog entries, and their relationships. It serves as the backbone for
+/// This model captures the structure of a built flow, including all steps,
+/// catalog items, and their relationships. It serves as the backbone for
 /// Flowthru.Viz visualization.
 /// </remarks>
 public class DagMetadata
 {
   /// <summary>
-  /// Name of the pipeline this DAG represents.
+  /// Name of the Flow this DAG represents.
   /// </summary>
-  [JsonPropertyName("pipelineName")]
-  public required string PipelineName { get; init; }
+  [JsonPropertyName("flowName")]
+  public required string FlowName { get; init; }
 
   /// <summary>
   /// Timestamp when this metadata was generated.
@@ -25,23 +25,23 @@ public class DagMetadata
   public DateTime GeneratedAt { get; init; } = DateTime.UtcNow;
 
   /// <summary>
-  /// All nodes in the pipeline with their metadata.
+  /// All steps in the Flow with their metadata.
   /// </summary>
-  [JsonPropertyName("nodes")]
-  public List<NodeMetadata> Nodes { get; init; } = new();
+  [JsonPropertyName("steps")]
+  public List<StepMetadata> Steps { get; init; } = new();
 
   /// <summary>
-  /// All catalog entries (datasets) involved in the pipeline.
+  /// All catalog items involved in the flow.
   /// </summary>
-  [JsonPropertyName("catalogEntries")]
-  public List<CatalogEntryMetadata> CatalogEntries { get; init; } = new();
+  [JsonPropertyName("catalogItems")]
+  public List<ItemMetadata> CatalogItems { get; init; } = new();
 
   /// <summary>
-  /// All edges representing data flow in the DAG.
+  /// All edges representing data Flow in the DAG.
   /// </summary>
   /// <remarks>
-  /// Edges connect catalog entries to nodes and nodes to catalog entries,
-  /// forming the complete data flow graph.
+  /// Edges connect catalog items to steps and steps to catalog items,
+  /// forming the complete graph.
   /// </remarks>
   [JsonPropertyName("edges")]
   public List<EdgeMetadata> Edges { get; init; } = new();
@@ -50,8 +50,8 @@ public class DagMetadata
   /// Slice criteria applied to generate this DAG, if any.
   /// </summary>
   /// <remarks>
-  /// Present when the DAG represents a sliced subset of the full pipeline.
-  /// Null when the DAG represents the complete, unsliced pipeline.
+  /// Present when the DAG represents a sliced subset of the full Flow.
+  /// Null when the DAG represents the complete, unsliced flow.
   /// Used for reproducibility, debugging, and filename generation.
   /// </remarks>
   [JsonPropertyName("appliedSlice")]
@@ -59,28 +59,28 @@ public class DagMetadata
   public DagSliceMetadata? AppliedSlice { get; init; }
 
   /// <summary>
-  /// Node IDs that are in the active execution slice, if a slice was applied.
+  /// Step IDs that are in the active execution slice, if a slice was applied.
   /// </summary>
   /// <remarks>
-  /// When a slice is applied, this contains the IDs of nodes that will actually execute.
-  /// The Nodes collection contains the full DAG, while this set identifies the subset.
-  /// Null when no slice was applied (all nodes execute).
+  /// When a slice is applied, this contains the IDs of steps that will actually execute.
+  /// The Steps collection contains the full DAG, while this set identifies the subset.
+  /// Null when no slice was applied (all steps execute).
   /// Enables visualization tools to highlight execution paths while showing full context.
   /// </remarks>
-  [JsonPropertyName("slicedNodeIds")]
+  [JsonPropertyName("slicedStepIds")]
   [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
-  public HashSet<string>? SlicedNodeIds { get; init; }
+  public HashSet<string>? SlicedStepIds { get; init; }
 
   /// <summary>
-  /// Catalog entry keys that are produced by nodes in the active execution slice.
+  /// Catalog item IDsthat are produced by steps in the active execution slice.
   /// </summary>
   /// <remarks>
-  /// When a slice is applied, this contains the keys of catalog entries (data) that
-  /// will be written during execution. Derived from the outputs of sliced nodes.
+  /// When a slice is applied, this contains the keys of catalog items (data) that
+  /// will be written during execution. Derived from the outputs of sliced steps.
   /// Null when no slice was applied (all data may be updated).
-  /// Enables visualization tools to highlight both nodes and the data they produce.
+  /// Enables visualization tools to highlight both steps and the data they produce.
   /// </remarks>
-  [JsonPropertyName("slicedCatalogEntryKeys")]
+  [JsonPropertyName("slicedCatalogItemIds")]
   [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
-  public HashSet<string>? SlicedCatalogEntryKeys { get; init; }
+  public HashSet<string>? SlicedCatalogItemIds { get; init; }
 }
diff --git a/src/core/Flowthru.Core/Meta/Models/DagSliceMetadata.cs b/src/core/Flowthru.Core/Meta/Models/DagSliceMetadata.cs
index 488d865b..4f6ca096 100644
--- a/src/core/Flowthru.Core/Meta/Models/DagSliceMetadata.cs
+++ b/src/core/Flowthru.Core/Meta/Models/DagSliceMetadata.cs
@@ -1,5 +1,5 @@
 using System.Text.Json.Serialization;
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 
 namespace Flowthru.Meta.Models;
 
@@ -61,9 +61,9 @@ public class DagSliceMetadata
   public string[]? OnlyNodes { get; init; }
 
   /// <summary>
-  /// Creates a <see cref="DagSliceMetadata"/> from a <see cref="PipelineSliceStrategy"/>.
+  /// Creates a <see cref="DagSliceMetadata"/> from a <see cref="FlowSliceStrategy"/>.
   /// </summary>
-  internal static DagSliceMetadata? FromStrategy(PipelineSliceStrategy? strategy)
+  internal static DagSliceMetadata? FromStrategy(FlowSliceStrategy? strategy)
   {
     if (strategy == null)
     {
@@ -72,7 +72,7 @@ public class DagSliceMetadata
 
     return new DagSliceMetadata
     {
-      Pipelines = strategy.Pipelines?.ToArray(),
+      Pipelines = strategy.Flows?.ToArray(),
       FromNodes = strategy.FromNodes?.ToArray(),
       ToNodes = strategy.ToNodes?.ToArray(),
       FromData = strategy.FromData?.ToArray(),
diff --git a/src/core/Flowthru.Core/Meta/Models/EdgeMetadata.cs b/src/core/Flowthru.Core/Meta/Models/EdgeMetadata.cs
index 6bffb075..d4a0a780 100644
--- a/src/core/Flowthru.Core/Meta/Models/EdgeMetadata.cs
+++ b/src/core/Flowthru.Core/Meta/Models/EdgeMetadata.cs
@@ -7,16 +7,16 @@ namespace Flowthru.Meta.Models;
 /// </summary>
 /// <remarks>
 /// <para>
-/// Edges represent data flow between catalog entries and nodes. The DAG contains
+/// Edges represent data Flow between catalog entries and nodes. The DAG contains
 /// two types of edges:
 /// </para>
 /// <list type="bullet">
-/// <item><strong>Catalog → Node:</strong> A node reads from a catalog entry</item>
-/// <item><strong>Node → Catalog:</strong> A node writes to a catalog entry</item>
+/// <item><strong>Catalog → Step:</strong> A node reads from a catalog entry</item>
+/// <item><strong>Step → Catalog:</strong> A node writes to a catalog entry</item>
 /// </list>
 /// <para>
 /// Together, these edges form the complete data flow:
-/// <c>CatalogEntry → Node → CatalogEntry → Node → ...</c>
+/// <c>Item → Step → Item → Step → ...</c>
 /// </para>
 /// </remarks>
 public class EdgeMetadata
@@ -25,8 +25,8 @@ public class EdgeMetadata
   /// Source identifier (either a catalog entry key or node ID).
   /// </summary>
   /// <remarks>
-  /// For Catalog → Node edges, this is a catalog entry key.
-  /// For Node → Catalog edges, this is a node ID.
+  /// For Catalog → Step edges, this is a catalog entry key.
+  /// For Step → Catalog edges, this is a node ID.
   /// </remarks>
   [JsonPropertyName("source")]
   public required string Source { get; init; }
@@ -35,8 +35,8 @@ public class EdgeMetadata
   /// Target identifier (either a node ID or catalog entry key).
   /// </summary>
   /// <remarks>
-  /// For Catalog → Node edges, this is a node ID.
-  /// For Node → Catalog edges, this is a catalog entry key.
+  /// For Catalog → Step edges, this is a node ID.
+  /// For Step → Catalog edges, this is a catalog entry key.
   /// </remarks>
   [JsonPropertyName("target")]
   public required string Target { get; init; }
diff --git a/src/core/Flowthru.Core/Meta/Models/NodeMetadata.cs b/src/core/Flowthru.Core/Meta/Models/NodeMetadata.cs
index 495d938e..4c857456 100644
--- a/src/core/Flowthru.Core/Meta/Models/NodeMetadata.cs
+++ b/src/core/Flowthru.Core/Meta/Models/NodeMetadata.cs
@@ -3,27 +3,27 @@
 namespace Flowthru.Meta.Models;
 
 /// <summary>
-/// Metadata describing a single node in the pipeline DAG.
+/// Metadata describing a single step in the Flow DAG.
 /// </summary>
 /// <remarks>
-/// Nodes are the processing units in a pipeline. Each node reads from one or more
+/// Steps are the processing units in a flow. Each step reads from one or more
 /// catalog entries (inputs), performs a transformation, and writes to one or more
 /// catalog entries (outputs).
 /// </remarks>
-public class NodeMetadata
+public class StepMetadata
 {
   /// <summary>
-  /// Unique identifier for this node within the pipeline.
+  /// Unique identifier for this step within the flow.
   /// </summary>
   /// <remarks>
-  /// Typically the node name as defined when adding it to the pipeline.
+  /// Typically the step name as defined when adding it to the flow.
   /// Example: "PreprocessCompanies", "TrainModel"
   /// </remarks>
   [JsonPropertyName("id")]
   public required string Id { get; init; }
 
   /// <summary>
-  /// Human-readable display label for this node.
+  /// Human-readable display label for this step.
   /// </summary>
   /// <remarks>
   /// May be formatted for better display in Flowthru.Viz.
@@ -33,50 +33,50 @@ public class NodeMetadata
   public required string Label { get; init; }
 
   /// <summary>
-  /// The C# class type name implementing this node.
+  /// The C# class type name implementing this step.
   /// </summary>
   /// <remarks>
   /// Simple type name without namespace or generic parameters.
-  /// Example: "PreprocessCompaniesNode", "TrainModelNode"
+  /// Example: "PreprocessCompaniesStep", "TrainModelStep"
   /// </remarks>
-  [JsonPropertyName("nodeType")]
-  public required string NodeType { get; init; }
+  [JsonPropertyName("stepType")]
+  public required string StepType { get; init; }
 
   /// <summary>
   /// Execution layer assigned by the dependency analyzer.
   /// </summary>
   /// <remarks>
-  /// Layer 0 nodes have no dependencies (read external data only).
-  /// Layer N nodes depend only on nodes in layers 0..N-1.
+  /// Layer 0 steps have no dependencies (read external data only).
+  /// Layer N steps depend only on steps in layers 0..N-1.
   /// </remarks>
   [JsonPropertyName("layer")]
   public int Layer { get; init; }
 
   /// <summary>
-  /// Name of the parent pipeline this node belongs to.
+  /// Name of the parent Flow this step belongs to.
   /// </summary>
   /// <remarks>
-  /// Important for merged pipelines where nodes from multiple pipelines
+  /// Important for merged flows where steps from multiple flows
   /// are combined into a single DAG.
   /// </remarks>
-  [JsonPropertyName("pipelineName")]
-  public required string PipelineName { get; init; }
+  [JsonPropertyName("flowName")]
+  public required string FlowName { get; init; }
 
   /// <summary>
-  /// List of catalog entry keys this node reads from.
+  /// List of catalog entry keys this step reads from.
   /// </summary>
   /// <remarks>
-  /// For multi-input nodes using CatalogMap, this contains all mapped entries.
+  /// For multi-input steps using CatalogMap, this contains all mapped entries.
   /// Example: ["Companies", "Shuttles", "Reviews"]
   /// </remarks>
   [JsonPropertyName("inputs")]
   public List<string> Inputs { get; init; } = new();
 
   /// <summary>
-  /// List of catalog entry keys this node writes to.
+  /// List of catalog entry keys this step writes to.
   /// </summary>
   /// <remarks>
-  /// For multi-output nodes using CatalogMap, this contains all mapped entries.
+  /// For multi-output steps using CatalogMap, this contains all mapped entries.
   /// Example: ["XTrain", "XTest", "YTrain", "YTest"]
   /// </remarks>
   [JsonPropertyName("outputs")]
diff --git a/src/core/Flowthru.Core/Meta/Providers/JsonMetadataProvider.cs b/src/core/Flowthru.Core/Meta/Providers/JsonMetadataProvider.cs
index 1a2b7854..cb35d6cb 100644
--- a/src/core/Flowthru.Core/Meta/Providers/JsonMetadataProvider.cs
+++ b/src/core/Flowthru.Core/Meta/Providers/JsonMetadataProvider.cs
@@ -80,9 +80,9 @@ public void Consume(DagMetadata dag)
         File.Move(tempPath, filePath);
 
         _logger?.LogInformation(
-          "Successfully exported JSON metadata ({Nodes} nodes, {Entries} catalog entries, {Edges} edges)",
-          dag.Nodes.Count,
-          dag.CatalogEntries.Count,
+          "Successfully exported JSON metadata ({Steps} nodes, {Entries} catalog entries, {Edges} edges)",
+          dag.Steps.Count,
+          dag.CatalogItems.Count,
           dag.Edges.Count
         );
       }
diff --git a/src/core/Flowthru.Core/Meta/Providers/MermaidMetadataProvider.cs b/src/core/Flowthru.Core/Meta/Providers/MermaidMetadataProvider.cs
index 2e4994f7..ab29434c 100644
--- a/src/core/Flowthru.Core/Meta/Providers/MermaidMetadataProvider.cs
+++ b/src/core/Flowthru.Core/Meta/Providers/MermaidMetadataProvider.cs
@@ -14,7 +14,7 @@ namespace Flowthru.Meta.Providers;
 public class MermaidMetadataProvider : IMetadataProvider
 {
   private readonly MermaidFlowchartDirection _direction;
-  private readonly string _activeNodeColor;
+  private readonly string _activeStepColor;
   private readonly string _activeDataColor;
   private readonly string _outputDirectory;
   private readonly string _filenameTemplate;
@@ -46,7 +46,7 @@ public enum MermaidFlowchartDirection
   /// <param name="filenameTemplate">Template for generating output filenames</param>
   /// <param name="timestampConfig">Configuration for timestamp handling in filenames</param>
   /// <param name="direction">Flow direction for the diagram</param>
-  /// <param name="activeNodeColor">Hex color for active (sliced) nodes</param>
+  /// <param name="activeStepColor">Hex color for active (sliced) nodes</param>
   /// <param name="activeDataColor">Hex color for active (sliced) catalog entries</param>
   /// <param name="logger">Optional logger for diagnostic messages</param>
   public MermaidMetadataProvider(
@@ -54,7 +54,7 @@ public MermaidMetadataProvider(
     string filenameTemplate,
     TimestampConfiguration timestampConfig,
     MermaidFlowchartDirection direction = MermaidFlowchartDirection.TopToBottom,
-    string activeNodeColor = "#2E7D32",
+    string activeStepColor = "#2E7D32",
     string activeDataColor = "#2E7D32",
     ILogger? logger = null
   )
@@ -64,7 +64,7 @@ public MermaidMetadataProvider(
       filenameTemplate ?? throw new ArgumentNullException(nameof(filenameTemplate));
     _timestampConfig = timestampConfig ?? throw new ArgumentNullException(nameof(timestampConfig));
     _direction = direction;
-    _activeNodeColor = activeNodeColor;
+    _activeStepColor = activeStepColor;
     _activeDataColor = activeDataColor;
     _logger = logger;
   }
@@ -90,7 +90,7 @@ public void Consume(DagMetadata dag)
       // Generate Mermaid diagram with configured direction and colors
       var mermaid = dag.ToMermaidDiagram(
         GetDirectionCode(_direction),
-        _activeNodeColor,
+        _activeStepColor,
         _activeDataColor
       );
 
@@ -137,7 +137,7 @@ public void Consume(DagMetadata dag)
   }
 
   /// <summary>
-  /// Converts flow direction enum to Mermaid direction code.
+  /// Converts Flow direction enum to Mermaid direction code.
   /// </summary>
   private static string GetDirectionCode(MermaidFlowchartDirection direction)
   {
diff --git a/src/core/Flowthru.Core/Nodes/Factory/NodeFactory.cs b/src/core/Flowthru.Core/Nodes/Factory/NodeFactory.cs
deleted file mode 100644
index 8f447934..00000000
--- a/src/core/Flowthru.Core/Nodes/Factory/NodeFactory.cs
+++ /dev/null
@@ -1,42 +0,0 @@
-namespace Flowthru.Nodes.Factory;
-
-/// <summary>
-/// Factory for creating node instances using TypeActivator.
-/// </summary>
-/// <remarks>
-/// <para>
-/// <strong>Design Pattern:</strong> Factory Pattern - provides a centralized location for
-/// node instantiation logic.
-/// </para>
-/// <para>
-/// This is a thin wrapper around TypeActivator, providing a domain-specific API for
-/// creating nodes. Could be extended in the future with:
-/// - Node validation logic
-/// - Pre/post-creation hooks
-/// - Node decoration/wrapping
-/// </para>
-/// </remarks>
-public static class NodeFactory
-{
-  /// <summary>
-  /// Creates a new instance of the specified node type.
-  /// </summary>
-  /// <typeparam name="TNode">The node type to instantiate</typeparam>
-  /// <returns>A new node instance</returns>
-  /// <remarks>
-  /// <para>
-  /// <strong>Requirements:</strong>
-  /// - TNode must inherit from NodeBase&lt;TInput, TOutput&gt;
-  /// - TNode must have a parameterless constructor
-  /// </para>
-  /// <para>
-  /// These requirements are enforced at compile-time via generic constraints in
-  /// PipelineBuilder.AddNode methods.
-  /// </para>
-  /// </remarks>
-  public static TNode Create<TNode>()
-    where TNode : new()
-  {
-    return TypeActivator.Create<TNode>();
-  }
-}
diff --git a/src/core/Flowthru.Core/Registry/IPipelineRegistrar.cs b/src/core/Flowthru.Core/Registry/IPipelineRegistrar.cs
index 4aca3702..432e16e8 100644
--- a/src/core/Flowthru.Core/Registry/IPipelineRegistrar.cs
+++ b/src/core/Flowthru.Core/Registry/IPipelineRegistrar.cs
@@ -1,28 +1,28 @@
 using Flowthru.Data;
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 
 namespace Flowthru.Registry;
 
 /// <summary>
-/// Fluent interface for registering pipelines in a type-safe manner.
+/// Fluent interface for registering flows in a type-safe manner.
 /// </summary>
-/// <typeparam name="TCatalog">The catalog type that pipelines will use</typeparam>
+/// <typeparam name="TCatalog">The catalog type that flows will use</typeparam>
 /// <remarks>
 /// <para>
-/// This interface provides compile-time type safety by tying pipeline factories
+/// This interface provides compile-time type safety by tying Flow factories
 /// to a specific catalog type. The registrar validates that all registered
-/// pipelines accept the correct catalog type.
+/// flows accept the correct catalog type.
 /// </para>
 /// <para>
 /// <strong>Usage:</strong>
 /// <code>
-/// protected override void RegisterPipelines(IPipelineRegistrar&lt;MyCatalog&gt; registrar)
+/// protected override void RegisterFlows(IFlowRegistrar&lt;MyCatalog&gt; registrar)
 /// {
-///     // Pipeline without parameters
-///     registrar.Register("processing", ProcessingPipeline.Create);
+///     // Flow without parameters
+///     registrar.Register("processing", ProcessingFlow.Create);
 ///
-///     // Pipeline with parameters
-///     registrar.Register("training", TrainPipeline.Create, new TrainOptions());
+///     // Flow with parameters
+///     registrar.Register("training", TrainFlow.Create, new TrainOptions());
 ///
 ///     // Add metadata
 ///     registrar.WithDescription("processing", "Cleans and transforms raw data");
@@ -30,55 +30,55 @@ namespace Flowthru.Registry;
 /// </code>
 /// </para>
 /// </remarks>
-public interface IPipelineRegistrar<TCatalog>
-  where TCatalog : DataCatalogBase
+public interface IFlowRegistrar<TCatalog>
+  where TCatalog : CatalogAbstract
 {
   /// <summary>
-  /// Registers a pipeline with a parameterless factory function.
+  /// Registers a Flow with a parameterless factory function.
   /// </summary>
-  /// <param name="name">Unique pipeline name</param>
-  /// <param name="pipelineFactory">Factory function that creates the pipeline from catalog</param>
+  /// <param name="name">Unique Flow name</param>
+  /// <param name="flowFactory">Factory function that creates the Flow from catalog</param>
   /// <returns>This registrar for method chaining</returns>
   /// <remarks>
-  /// Use this overload when the pipeline doesn't require parameters.
+  /// Use this overload when the Flow doesn't require parameters.
   /// </remarks>
-  IPipelineRegistrar<TCatalog> Register(string name, Func<TCatalog, Pipeline> pipelineFactory);
+  IFlowRegistrar<TCatalog> Register(string name, Func<TCatalog, Flow> flowFactory);
 
   /// <summary>
-  /// Registers a pipeline with a parameterized factory function.
+  /// Registers a Flow with a parameterized factory function.
   /// </summary>
-  /// <typeparam name="TParams">The type of parameters the pipeline requires</typeparam>
-  /// <param name="name">Unique pipeline name</param>
-  /// <param name="pipelineFactory">Factory function that creates the pipeline from catalog and parameters</param>
-  /// <param name="parameters">Parameter instance to pass to the pipeline</param>
+  /// <typeparam name="TParams">The type of parameters the Flow requires</typeparam>
+  /// <param name="name">Unique Flow name</param>
+  /// <param name="flowFactory">Factory function that creates the Flow from catalog and parameters</param>
+  /// <param name="parameters">Parameter instance to pass to the flow</param>
   /// <returns>This registrar for method chaining</returns>
   /// <remarks>
   /// <para>
-  /// Use this overload when the pipeline requires configuration parameters.
+  /// Use this overload when the Flow requires configuration parameters.
   /// Parameters are strongly typed and checked at compile time.
   /// </para>
   /// <para>
-  /// The factory signature must match: <c>Func&lt;TCatalog, TParams, Pipeline&gt;</c>
+  /// The factory signature must match: <c>Func&lt;TCatalog, TParams, Flow&gt;</c>
   /// </para>
   /// </remarks>
-  IPipelineRegistrar<TCatalog> Register<TParams>(
+  IFlowRegistrar<TCatalog> Register<TParams>(
     string name,
-    Func<TCatalog, TParams, Pipeline> pipelineFactory,
+    Func<TCatalog, TParams, Flow> flowFactory,
     TParams parameters
   );
 
   /// <summary>
-  /// Adds a description to the most recently registered pipeline.
+  /// Adds a description to the most recently registered flow.
   /// </summary>
-  /// <param name="description">Human-readable description of what the pipeline does</param>
+  /// <param name="description">Human-readable description of what the Flow does</param>
   /// <returns>This registrar for method chaining</returns>
   /// <remarks>
   /// Use this overload when fluently chaining after Register().
   /// </remarks>
-  IPipelineRegistrar<TCatalog> WithDescription(string description);
+  IFlowRegistrar<TCatalog> WithDescription(string description);
 
   /// <summary>
-  /// Configures validation options for the most recently registered pipeline.
+  /// Configures validation options for the most recently registered flow.
   /// </summary>
   /// <param name="configure">Action to configure validation behavior</param>
   /// <returns>This registrar for method chaining</returns>
@@ -91,14 +91,17 @@ TParams parameters
   /// <strong>Example:</strong>
   /// </para>
   /// <code>
-  /// registrar.Register("data_processing", ProcessingPipeline.Create)
+  /// registrar.Register("data_processing", ProcessingFlow.Create)
+  ///   .WithValidation(validation => {
+  ///     validation.Inspect(catalog.Companies, InspectionLevel.Deep);
+  /// </para>
+  /// <code>
+  /// registrar.Register("data_processing", ProcessingFlow.Create)
   ///   .WithValidation(validation => {
   ///     validation.Inspect(catalog.Companies, InspectionLevel.Deep);
   ///     validation.Inspect(catalog.Shuttles, InspectionLevel.Deep);
   ///   });
   /// </code>
   /// </remarks>
-  IPipelineRegistrar<TCatalog> WithValidation(
-    Action<Pipelines.Validation.ValidationOptions> configure
-  );
+  IFlowRegistrar<TCatalog> WithValidation(Action<Flows.Validation.ValidationOptions> configure);
 }
diff --git a/src/core/Flowthru.Core/Registry/PipelineMetadata.cs b/src/core/Flowthru.Core/Registry/PipelineMetadata.cs
index 84513b30..74a6da78 100644
--- a/src/core/Flowthru.Core/Registry/PipelineMetadata.cs
+++ b/src/core/Flowthru.Core/Registry/PipelineMetadata.cs
@@ -1,28 +1,28 @@
-using Flowthru.Pipelines.Validation;
+using Flowthru.Flows.Validation;
 
 namespace Flowthru.Registry;
 
 /// <summary>
-/// Metadata describing a registered pipeline.
+/// Metadata describing a registered flow.
 /// </summary>
 /// <remarks>
-/// Used internally by the pipeline registry to store pipeline information
-/// beyond just the pipeline instance itself.
+/// Used internally by the flow registry to store Flow information
+/// beyond just the Flow instance itself.
 /// </remarks>
-internal class PipelineMetadata
+internal class FlowRegistration
 {
   /// <summary>
-  /// Pipeline name (unique identifier).
+  /// Flow name (unique identifier).
   /// </summary>
   public required string Name { get; init; }
 
   /// <summary>
-  /// Optional human-readable description of what the pipeline does.
+  /// Optional human-readable description of what the Flow does.
   /// </summary>
   public string? Description { get; set; }
 
   /// <summary>
-  /// Validation configuration for this pipeline.
+  /// Validation configuration for this flow.
   /// </summary>
   public ValidationOptions ValidationOptions { get; set; } = ValidationOptions.Default();
 }
diff --git a/src/core/Flowthru.Core/Registry/PipelineRegistrar.cs b/src/core/Flowthru.Core/Registry/PipelineRegistrar.cs
index bc201a29..52a79af3 100644
--- a/src/core/Flowthru.Core/Registry/PipelineRegistrar.cs
+++ b/src/core/Flowthru.Core/Registry/PipelineRegistrar.cs
@@ -1,151 +1,143 @@
 using Flowthru.Data;
-using Flowthru.Pipelines;
+using Flowthru.Flows;
+using Flowthru.Flows.Validation;
 
 namespace Flowthru.Registry;
 
 /// <summary>
-/// Implementation of IPipelineRegistrar that builds a dictionary of pipelines.
+/// Implementation of IFlowRegistrar that builds a dictionary of flows.
 /// </summary>
-/// <typeparam name="TCatalog">The catalog type that pipelines will use</typeparam>
-internal class PipelineRegistrar<TCatalog> : IPipelineRegistrar<TCatalog>
-  where TCatalog : DataCatalogBase
+/// <typeparam name="TCatalog">The catalog type that flows will use</typeparam>
+internal class FlowRegistrar<TCatalog> : IFlowRegistrar<TCatalog>
+  where TCatalog : CatalogAbstract
 {
   private readonly TCatalog _catalog;
-  private readonly Dictionary<string, Func<Pipeline>> _factories = new();
-  private readonly Dictionary<string, PipelineMetadata> _metadata = new();
-  private string? _lastRegisteredPipeline;
+  private readonly Dictionary<string, Func<Flow>> _factories = new();
+  private readonly Dictionary<string, FlowRegistration> _metadata = new();
+  private string? _lastRegisteredFlow;
 
   /// <summary>
-  /// Initializes a new instance of PipelineRegistrar.
+  /// Initializes a new instance of FlowRegistrar.
   /// </summary>
-  /// <param name="catalog">The catalog instance to pass to pipeline factories</param>
-  internal PipelineRegistrar(TCatalog catalog)
+  /// <param name="catalog">The catalog instance to pass to Flow factories</param>
+  internal FlowRegistrar(TCatalog catalog)
   {
     _catalog = catalog;
   }
 
   /// <inheritdoc />
-  public IPipelineRegistrar<TCatalog> Register(
-    string name,
-    Func<TCatalog, Pipeline> pipelineFactory
-  )
+  public IFlowRegistrar<TCatalog> Register(string name, Func<TCatalog, Flow> flowFactory)
   {
     if (string.IsNullOrWhiteSpace(name))
     {
-      throw new ArgumentException("Pipeline name cannot be null or empty", nameof(name));
+      throw new ArgumentException("Flow name cannot be null or empty", nameof(name));
     }
 
     if (_factories.ContainsKey(name))
     {
-      throw new InvalidOperationException($"Pipeline '{name}' is already registered");
+      throw new InvalidOperationException($"Flow '{name}' is already registered");
     }
 
     // Wrap factory to capture catalog
-    _factories[name] = () => pipelineFactory(_catalog);
+    _factories[name] = () => flowFactory(_catalog);
 
     // Initialize metadata
-    _metadata[name] = new PipelineMetadata { Name = name };
-    _lastRegisteredPipeline = name;
+    _metadata[name] = new FlowRegistration { Name = name };
+    _lastRegisteredFlow = name;
 
     return this;
   }
 
   /// <inheritdoc />
-  public IPipelineRegistrar<TCatalog> Register<TParams>(
+  public IFlowRegistrar<TCatalog> Register<TParams>(
     string name,
-    Func<TCatalog, TParams, Pipeline> pipelineFactory,
+    Func<TCatalog, TParams, Flow> flowFactory,
     TParams parameters
   )
   {
     if (string.IsNullOrWhiteSpace(name))
     {
-      throw new ArgumentException("Pipeline name cannot be null or empty", nameof(name));
+      throw new ArgumentException("Flow name cannot be null or empty", nameof(name));
     }
 
     if (_factories.ContainsKey(name))
     {
-      throw new InvalidOperationException($"Pipeline '{name}' is already registered");
+      throw new InvalidOperationException($"Flow '{name}' is already registered");
     }
 
     // Wrap factory to capture catalog and parameters
-    _factories[name] = () => pipelineFactory(_catalog, parameters);
+    _factories[name] = () => flowFactory(_catalog, parameters);
 
     // Initialize metadata
-    _metadata[name] = new PipelineMetadata { Name = name };
-    _lastRegisteredPipeline = name;
+    _metadata[name] = new FlowRegistration { Name = name };
+    _lastRegisteredFlow = name;
 
     return this;
   }
 
   /// <inheritdoc />
-  public IPipelineRegistrar<TCatalog> WithDescription(string description)
+  public IFlowRegistrar<TCatalog> WithDescription(string description)
   {
-    if (_lastRegisteredPipeline == null)
+    if (_lastRegisteredFlow == null)
     {
       throw new InvalidOperationException(
-        "No pipeline has been registered yet. Call Register() first."
+        "No flow has been registered yet. Call Register() first."
       );
     }
 
-    if (!_metadata.ContainsKey(_lastRegisteredPipeline))
+    if (!_metadata.ContainsKey(_lastRegisteredFlow))
     {
-      throw new InvalidOperationException(
-        $"Pipeline '{_lastRegisteredPipeline}' has not been registered"
-      );
+      throw new InvalidOperationException($"Flow '{_lastRegisteredFlow}' has not been registered");
     }
 
-    _metadata[_lastRegisteredPipeline].Description = description;
+    _metadata[_lastRegisteredFlow].Description = description;
     return this;
   }
 
   /// <inheritdoc />
-  public IPipelineRegistrar<TCatalog> WithValidation(
-    Action<Pipelines.Validation.ValidationOptions> configure
-  )
+  public IFlowRegistrar<TCatalog> WithValidation(Action<ValidationOptions> configure)
   {
-    if (_lastRegisteredPipeline == null)
+    if (_lastRegisteredFlow == null)
     {
       throw new InvalidOperationException(
-        "No pipeline has been registered yet. Call Register() first."
+        "No Flow has been registered yet. Call Register() first."
       );
     }
 
-    if (!_metadata.ContainsKey(_lastRegisteredPipeline))
+    if (!_metadata.ContainsKey(_lastRegisteredFlow))
     {
-      throw new InvalidOperationException(
-        $"Pipeline '{_lastRegisteredPipeline}' has not been registered"
-      );
+      throw new InvalidOperationException($"Flow '{_lastRegisteredFlow}' has not been registered");
     }
 
-    configure(_metadata[_lastRegisteredPipeline].ValidationOptions);
+    configure(_metadata[_lastRegisteredFlow].ValidationOptions);
     return this;
   }
 
   /// <summary>
-  /// Builds and returns all registered pipelines with their metadata applied.
+  /// Builds and returns all registered flows with their metadata applied.
   /// </summary>
-  /// <returns>Dictionary of pipeline names to pipeline instances</returns>
-  internal Dictionary<string, Pipeline> Build()
+  /// <returns>Dictionary of flow names to Flow instances</returns>
+  internal Dictionary<string, Flow> Build()
   {
-    var pipelines = new Dictionary<string, Pipeline>();
+    var flows = new Dictionary<string, Flow>();
 
     foreach (var (name, factory) in _factories)
     {
-      // Invoke factory to create pipeline
-      var pipeline = factory();
+      // Invoke factory to create flow
+      var flow = factory();
 
       // Apply metadata
-      pipeline.Name = name;
+      flow.Name = name;
 
       if (_metadata.TryGetValue(name, out var metadata))
       {
-        pipeline.Description = metadata.Description;
-        pipeline.ValidationOptions = metadata.ValidationOptions;
+        flow.Description = metadata.Description;
+        flow.ValidationOptions = metadata.ValidationOptions;
       }
 
-      pipelines[name] = pipeline;
+      flows[name] = flow;
     }
 
-    return pipelines;
+    return flows;
   }
 }
diff --git a/src/core/Flowthru.Core/Results/ConsoleResultFormatter.cs b/src/core/Flowthru.Core/Results/ConsoleResultFormatter.cs
index 9aa8fc96..f5a7059e 100644
--- a/src/core/Flowthru.Core/Results/ConsoleResultFormatter.cs
+++ b/src/core/Flowthru.Core/Results/ConsoleResultFormatter.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using Microsoft.Extensions.Logging;
 
 namespace Flowthru.Results;
@@ -10,10 +10,10 @@ namespace Flowthru.Results;
 /// This is the default formatter used by the CLI.
 /// Produces colorful, detailed output suitable for interactive terminal sessions.
 /// </remarks>
-public class ConsoleResultFormatter : IPipelineResultFormatter
+public class ConsoleResultFormatter : IFlowResultFormatter
 {
   /// <inheritdoc />
-  public void Format(PipelineResult result, ILogger logger)
+  public void Format(FlowResult result, ILogger logger)
   {
     if (result.Success)
     {
@@ -25,26 +25,26 @@ public void Format(PipelineResult result, ILogger logger)
     }
   }
 
-  private void FormatSuccess(PipelineResult result, ILogger logger)
+  private void FormatSuccess(FlowResult result, ILogger logger)
   {
     logger.LogInformation("================================================================");
-    logger.LogInformation("Pipeline: {PipelineName}", result.PipelineName ?? "Unknown");
+    logger.LogInformation("Pipeline: {FlowName}", result.FlowName ?? "Unknown");
     logger.LogInformation("Status: ✓ SUCCESS");
     logger.LogInformation("Duration: {Duration:F2}s", result.ExecutionTime.TotalSeconds);
     logger.LogInformation("================================================================");
     logger.LogInformation("");
 
-    if (result.NodeResults.Count > 0)
+    if (result.StepResults.Count > 0)
     {
-      logger.LogInformation("Nodes Executed ({Count}):", result.NodeResults.Count);
+      logger.LogInformation("Steps Executed ({Count}):", result.StepResults.Count);
 
-      foreach (var (nodeName, nodeResult) in result.NodeResults)
+      foreach (var (nodeName, nodeResult) in result.StepResults)
       {
         if (nodeResult.Success)
         {
           logger.LogInformation(
-            "  ✓ {NodeName,-40} {Duration,6:F2}s   ({InputCount,6} → {OutputCount,6} records)",
-            nodeResult.NodeName,
+            "  ✓ {StepName,-40} {Duration,6:F2}s   ({InputCount,6} → {OutputCount,6} records)",
+            nodeResult.StepName,
             nodeResult.ExecutionTime.TotalSeconds,
             nodeResult.InputCount,
             nodeResult.OutputCount
@@ -54,8 +54,8 @@ private void FormatSuccess(PipelineResult result, ILogger logger)
         {
           // This shouldn't happen in a successful pipeline, but handle it anyway
           logger.LogWarning(
-            "  ✗ {NodeName,-40} {Duration,6:F2}s   FAILED",
-            nodeResult.NodeName,
+            "  ✗ {StepName,-40} {Duration,6:F2}s   FAILED",
+            nodeResult.StepName,
             nodeResult.ExecutionTime.TotalSeconds
           );
         }
@@ -67,27 +67,27 @@ private void FormatSuccess(PipelineResult result, ILogger logger)
     logger.LogInformation("================================================================");
   }
 
-  private void FormatFailure(PipelineResult result, ILogger logger)
+  private void FormatFailure(FlowResult result, ILogger logger)
   {
     logger.LogError("================================================================");
-    logger.LogError("Pipeline: {PipelineName}", result.PipelineName ?? "Unknown");
+    logger.LogError("Pipeline: {FlowName}", result.FlowName ?? "Unknown");
     logger.LogError("Status: ✗ FAILED");
     logger.LogError("Duration: {Duration:F2}s", result.ExecutionTime.TotalSeconds);
     logger.LogError("================================================================");
     logger.LogError("");
 
     // Show which nodes succeeded before failure
-    var succeededNodes = result.NodeResults.Values.Where(n => n.Success).ToList();
-    var failedNode = result.NodeResults.Values.FirstOrDefault(n => !n.Success);
+    var succeededSteps = result.StepResults.Values.Where(n => n.Success).ToList();
+    var failedStep = result.StepResults.Values.FirstOrDefault(n => !n.Success);
 
-    if (succeededNodes.Any())
+    if (succeededSteps.Any())
     {
-      logger.LogInformation("Nodes Completed Before Failure ({Count}):", succeededNodes.Count);
-      foreach (var nodeResult in succeededNodes)
+      logger.LogInformation("Steps Completed Before Failure ({Count}):", succeededSteps.Count);
+      foreach (var nodeResult in succeededSteps)
       {
         logger.LogInformation(
-          "  ✓ {NodeName,-40} {Duration,6:F2}s",
-          nodeResult.NodeName,
+          "  ✓ {StepName,-40} {Duration,6:F2}s",
+          nodeResult.StepName,
           nodeResult.ExecutionTime.TotalSeconds
         );
       }
@@ -95,19 +95,19 @@ private void FormatFailure(PipelineResult result, ILogger logger)
     }
 
     // Show failed node
-    if (failedNode != null)
+    if (failedStep != null)
     {
-      logger.LogError("Failed Node:");
-      logger.LogError("  ✗ {NodeName}", failedNode.NodeName);
-      logger.LogError("  Duration: {Duration:F2}s", failedNode.ExecutionTime.TotalSeconds);
+      logger.LogError("Failed Step:");
+      logger.LogError("  ✗ {StepName}", failedStep.StepName);
+      logger.LogError("  Duration: {Duration:F2}s", failedStep.ExecutionTime.TotalSeconds);
 
-      if (failedNode.Exception != null)
+      if (failedStep.Exception != null)
       {
-        logger.LogError("  Error: {ErrorMessage}", failedNode.Exception.Message);
+        logger.LogError("  Error: {ErrorMessage}", failedStep.Exception.Message);
         logger.LogError("  Stack Trace:");
 
         // Format stack trace with indentation
-        var stackLines = failedNode.Exception.StackTrace?.Split('\n') ?? Array.Empty<string>();
+        var stackLines = failedStep.Exception.StackTrace?.Split('\n') ?? Array.Empty<string>();
         foreach (var line in stackLines.Take(10)) // Limit to first 10 lines
         {
           logger.LogError("    {StackLine}", line.TrimEnd());
diff --git a/src/core/Flowthru.Core/Results/IPipelineResultFormatter.cs b/src/core/Flowthru.Core/Results/IPipelineResultFormatter.cs
index 387273a5..f829eba4 100644
--- a/src/core/Flowthru.Core/Results/IPipelineResultFormatter.cs
+++ b/src/core/Flowthru.Core/Results/IPipelineResultFormatter.cs
@@ -1,14 +1,14 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using Microsoft.Extensions.Logging;
 
 namespace Flowthru.Results;
 
 /// <summary>
-/// Interface for formatting pipeline execution results.
+/// Interface for formatting Flow execution results.
 /// </summary>
 /// <remarks>
 /// <para>
-/// Result formatters transform a PipelineResult into human-readable or
+/// Result formatters transform a FlowResult into human-readable or
 /// machine-readable output via logging.
 /// </para>
 /// <para>
@@ -19,12 +19,12 @@ namespace Flowthru.Results;
 /// Future formatters: JSON, Markdown, compact CI/CD format.
 /// </para>
 /// </remarks>
-public interface IPipelineResultFormatter
+public interface IFlowResultFormatter
 {
   /// <summary>
-  /// Formats and outputs the pipeline result.
+  /// Formats and outputs the Flow result.
   /// </summary>
-  /// <param name="result">The pipeline execution result</param>
+  /// <param name="result">The Flow execution result</param>
   /// <param name="logger">The logger to write output to</param>
-  void Format(PipelineResult result, ILogger logger);
+  void Format(FlowResult result, ILogger logger);
 }
diff --git a/src/core/Flowthru.Core/Serialization/EnumMetadataRegistry.cs b/src/core/Flowthru.Core/Serialization/EnumMetadataRegistry.cs
index 44395fb5..8f6395a9 100644
--- a/src/core/Flowthru.Core/Serialization/EnumMetadataRegistry.cs
+++ b/src/core/Flowthru.Core/Serialization/EnumMetadataRegistry.cs
@@ -37,7 +37,7 @@ internal static class EnumMetadataRegistry
   /// This method is thread-safe. If multiple threads request metadata for the same enum type
   /// simultaneously, the metadata will be computed only once.
   /// </remarks>
-  public static EnumMetadataCache<TEnum> GetOrCreate<TEnum>()
+  public static EnumMetadataCache<TEnum> Create<TEnum>()
     where TEnum : struct, Enum
   {
     Type enumType = typeof(TEnum);
diff --git a/src/core/Flowthru.Core/Serialization/EnumSerializationHelper.cs b/src/core/Flowthru.Core/Serialization/EnumSerializationHelper.cs
index ecad64d8..f1505d91 100644
--- a/src/core/Flowthru.Core/Serialization/EnumSerializationHelper.cs
+++ b/src/core/Flowthru.Core/Serialization/EnumSerializationHelper.cs
@@ -30,9 +30,9 @@ public static object ParseEnumFromString(Type enumType, string value)
       throw new ArgumentException($"Type '{enumType.Name}' is not an enum type.", nameof(enumType));
     }
 
-    // Use reflection to call EnumMetadataRegistry.GetOrCreate<TEnum>()
+    // Use reflection to call EnumMetadataRegistry.Create<TEnum>()
     var getOrCreateMethod = typeof(EnumMetadataRegistry)
-      .GetMethod(nameof(EnumMetadataRegistry.GetOrCreate))!
+      .GetMethod(nameof(EnumMetadataRegistry.Create))!
       .MakeGenericMethod(enumType);
 
     var metadata = getOrCreateMethod.Invoke(null, null)!;
@@ -68,9 +68,9 @@ public static string FormatEnumToString(Type enumType, object value)
       throw new ArgumentException($"Type '{enumType.Name}' is not an enum type.", nameof(enumType));
     }
 
-    // Use reflection to call EnumMetadataRegistry.GetOrCreate<TEnum>()
+    // Use reflection to call EnumMetadataRegistry.Create<TEnum>()
     var getOrCreateMethod = typeof(EnumMetadataRegistry)
-      .GetMethod(nameof(EnumMetadataRegistry.GetOrCreate))!
+      .GetMethod(nameof(EnumMetadataRegistry.Create))!
       .MakeGenericMethod(enumType);
 
     var metadata = getOrCreateMethod.Invoke(null, null)!;
diff --git a/src/core/Flowthru.Core/Services/FlowthruService.cs b/src/core/Flowthru.Core/Services/FlowthruService.cs
index 0f9c3b77..a6e4fe88 100644
--- a/src/core/Flowthru.Core/Services/FlowthruService.cs
+++ b/src/core/Flowthru.Core/Services/FlowthruService.cs
@@ -1,9 +1,10 @@
 using System.Diagnostics;
 using Flowthru.Data;
 using Flowthru.Data.Validation;
+using Flowthru.Flows;
+using Flowthru.Flows.Validation;
 using Flowthru.Meta;
 using Flowthru.Meta.Models;
-using Flowthru.Pipelines;
 using Flowthru.Services.Models;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Logging;
@@ -15,13 +16,13 @@ namespace Flowthru.Services;
 /// </summary>
 /// <remarks>
 /// This service wraps pipeline execution logic in a CLI-agnostic interface.
-/// It delegates to existing <see cref="Pipeline"/> execution methods while
+/// It delegates to existing <see cref="Flow"/> execution methods while
 /// providing a cleaner API for programmatic use.
 /// </remarks>
 internal sealed class FlowthruService : IFlowthruService
 {
-  private readonly IReadOnlyList<DataCatalogBase> _catalogs;
-  private readonly Dictionary<string, Pipeline> _pipelines;
+  private readonly IReadOnlyList<CatalogAbstract> _catalogs;
+  private readonly Dictionary<string, Flow> _pipelines;
   private readonly IServiceProvider _services;
   private readonly ILogger<FlowthruService> _logger;
   private readonly FlowthruMetadataBuilder? _metadataBuilder;
@@ -30,8 +31,8 @@ internal sealed class FlowthruService : IFlowthruService
   /// Initializes a new instance of FlowthruService.
   /// </summary>
   public FlowthruService(
-    IReadOnlyList<DataCatalogBase> catalogs,
-    Dictionary<string, Pipeline> pipelines,
+    IReadOnlyList<CatalogAbstract> catalogs,
+    Dictionary<string, Flow> pipelines,
     IServiceProvider services,
     ILogger<FlowthruService> logger,
     FlowthruMetadataBuilder? metadataBuilder = null
@@ -50,9 +51,7 @@ public FlowthruService(
     }
 
     // Resolve validation hooks from DI (Phase 4: extensions can register hooks)
-    var validationHooks = _services
-      .GetServices<Pipelines.Validation.IPipelineValidationHook>()
-      .ToList();
+    var validationHooks = _services.GetServices<IFlowValidationHook>().ToList();
 
     // Inject services into each pipeline and build
     foreach (var pipeline in _pipelines.Values)
@@ -60,7 +59,7 @@ public FlowthruService(
       pipeline.Logger = _logger;
       pipeline.ServiceProvider = _services;
 
-      // Register validation hooks (e.g., PythonNodeValidator from Python extension)
+      // Register validation hooks (e.g., PythonStepValidator from Python extension)
       foreach (var hook in validationHooks)
       {
         pipeline.ValidationHooks.Add(hook);
@@ -71,13 +70,13 @@ public FlowthruService(
   }
 
   /// <inheritdoc />
-  public IReadOnlyCollection<string> PipelineNames => _pipelines.Keys;
+  public IReadOnlyCollection<string> FlowNames => _pipelines.Keys;
 
   /// <inheritdoc />
-  public IReadOnlyList<DataCatalogBase> Catalogs => _catalogs;
+  public IReadOnlyList<CatalogAbstract> Catalogs => _catalogs;
 
   /// <inheritdoc />
-  public async Task<PipelineResult> ExecutePipelineAsync(
+  public async Task<FlowResult> ExecuteFlowAsync(
     ExecutionOptions? options = null,
     bool exportMetadata = true,
     string? metadataOutputDirectory = null,
@@ -87,10 +86,10 @@ public async Task<PipelineResult> ExecutePipelineAsync(
     var totalStopwatch = Stopwatch.StartNew();
 
     _logger.LogInformation("Merging all pipelines into unified DAG.");
-    _logger.LogInformation("Available pipelines: {Pipelines}", string.Join(", ", PipelineNames));
+    _logger.LogInformation("Available pipelines: {Pipelines}", string.Join(", ", FlowNames));
 
     // Merge all pipelines into a single DAG
-    var mergedPipeline = Pipeline.Merge(_pipelines);
+    var mergedPipeline = Flow.Merge(_pipelines);
 
     // Inject services and logger
     mergedPipeline.Logger = _logger;
@@ -112,8 +111,8 @@ public async Task<PipelineResult> ExecutePipelineAsync(
     _logger.LogInformation("→ Building pipeline and analyzing dependencies...");
     mergedPipeline.Build(options.SliceStrategy);
     _logger.LogInformation(
-      "  ✓ {NodeCount} nodes organized into {LayerCount} execution layers",
-      mergedPipeline.Nodes.Count,
+      "  ✓ {StepCount} nodes organized into {LayerCount} execution layers",
+      mergedPipeline.Steps.Count,
       mergedPipeline.ExecutionLayers!.Count
     );
 
@@ -136,8 +135,8 @@ public async Task<PipelineResult> ExecutePipelineAsync(
         validationResult.ThrowIfInvalid();
       }
 
-      var layer0Nodes = mergedPipeline.ExecutionLayers![0];
-      validatedInputCount = layer0Nodes.SelectMany(node => node.Inputs).Distinct().Count();
+      var layer0Steps = mergedPipeline.ExecutionLayers![0];
+      validatedInputCount = layer0Steps.SelectMany(node => node.Inputs).Distinct().Count();
       _logger.LogInformation("  ✓ {Count} external data sources validated", validatedInputCount);
     }
 
@@ -173,8 +172,8 @@ public async Task<PipelineResult> ExecutePipelineAsync(
       _logger.LogInformation("════════════════════════════════════════");
       _logger.LogInformation("");
       _logger.LogInformation(
-        "Nodes: {Count} nodes across {Layers} layers",
-        mergedPipeline.Nodes.Count,
+        "Steps: {Count} nodes across {Layers} layers",
+        mergedPipeline.Steps.Count,
         mergedPipeline.ExecutionLayers!.Count
       );
       _logger.LogInformation("External Inputs: {Count} validated", validatedInputCount);
@@ -184,9 +183,9 @@ public async Task<PipelineResult> ExecutePipelineAsync(
       _logger.LogInformation("");
 
       totalStopwatch.Stop();
-      return PipelineResult.CreateDryRunSuccess(
+      return FlowResult.CreateDryRunSuccess(
         totalStopwatch.Elapsed,
-        mergedPipeline.Nodes.Count,
+        mergedPipeline.Steps.Count,
         mergedPipeline.ExecutionLayers!.Count,
         validatedInputCount,
         "Pipeline"
@@ -213,12 +212,12 @@ public async Task<PipelineResult> ExecutePipelineAsync(
   }
 
   /// <inheritdoc />
-  public PipelineMetadata GetPipelineMetadata(string pipelineName)
+  public FlowMetadata GetFlowMetadata(string pipelineName)
   {
     if (!_pipelines.TryGetValue(pipelineName, out var pipeline))
     {
       throw new KeyNotFoundException(
-        $"Pipeline '{pipelineName}' not found. " + $"Available: {string.Join(", ", PipelineNames)}"
+        $"Pipeline '{pipelineName}' not found. " + $"Available: {string.Join(", ", FlowNames)}"
       );
     }
 
@@ -229,11 +228,11 @@ public PipelineMetadata GetPipelineMetadata(string pipelineName)
         .Distinct()
         .ToList() ?? new List<string>();
 
-    return new PipelineMetadata
+    return new FlowMetadata
     {
       Name = pipeline.Name ?? pipelineName,
       Description = pipeline.Description,
-      NodeCount = pipeline.Nodes.Count,
+      StepCount = pipeline.Steps.Count,
       LayerCount = pipeline.ExecutionLayers?.Count ?? 0,
       ExternalInputs = externalInputs,
       IsBuilt = pipeline.IsBuilt,
@@ -243,22 +242,21 @@ public PipelineMetadata GetPipelineMetadata(string pipelineName)
   /// <inheritdoc />
   public DagMetadata GetDagMetadata(
     string? pipelineName = null,
-    PipelineSliceStrategy? sliceStrategy = null
+    FlowSliceStrategy? sliceStrategy = null
   )
   {
-    Dictionary<string, Pipeline> toMerge;
+    Dictionary<string, Flow> toMerge;
 
     if (pipelineName is not null)
     {
       if (!_pipelines.TryGetValue(pipelineName, out var namedPipeline))
       {
         throw new KeyNotFoundException(
-          $"Pipeline '{pipelineName}' not found. "
-            + $"Available: {string.Join(", ", PipelineNames)}"
+          $"Pipeline '{pipelineName}' not found. " + $"Available: {string.Join(", ", FlowNames)}"
         );
       }
 
-      toMerge = new Dictionary<string, Pipeline> { [pipelineName] = namedPipeline };
+      toMerge = new Dictionary<string, Flow> { [pipelineName] = namedPipeline };
     }
     else
     {
@@ -267,7 +265,7 @@ public DagMetadata GetDagMetadata(
 
     // Always merge to produce a fresh pipeline instance — avoids mutating
     // the registered pipelines' Build/Slice state as a side effect.
-    var pipeline = Pipeline.Merge(toMerge);
+    var pipeline = Flow.Merge(toMerge);
     pipeline.Logger = _logger;
     pipeline.ServiceProvider = _services;
     pipeline.Build(sliceStrategy);
@@ -276,7 +274,7 @@ public DagMetadata GetDagMetadata(
   }
 
   /// <inheritdoc />
-  public async Task<ValidationResult> ValidatePipelineAsync(
+  public async Task<ValidationResult> ValidateFlowAsync(
     string pipelineName,
     CancellationToken cancellationToken = default
   )
@@ -284,7 +282,7 @@ public async Task<ValidationResult> ValidatePipelineAsync(
     if (!_pipelines.TryGetValue(pipelineName, out var pipeline))
     {
       throw new KeyNotFoundException(
-        $"Pipeline '{pipelineName}' not found. " + $"Available: {string.Join(", ", PipelineNames)}"
+        $"Pipeline '{pipelineName}' not found. " + $"Available: {string.Join(", ", FlowNames)}"
       );
     }
 
@@ -292,7 +290,7 @@ public async Task<ValidationResult> ValidatePipelineAsync(
   }
 
   private async Task ExportPipelineMetadataAsync(
-    Pipeline pipeline,
+    Flow pipeline,
     string pipelineName,
     string? outputDirectory
   )
diff --git a/src/core/Flowthru.Core/Services/FlowthruServiceBuilder.cs b/src/core/Flowthru.Core/Services/FlowthruServiceBuilder.cs
index f2beada8..dba212d0 100644
--- a/src/core/Flowthru.Core/Services/FlowthruServiceBuilder.cs
+++ b/src/core/Flowthru.Core/Services/FlowthruServiceBuilder.cs
@@ -1,6 +1,7 @@
 using Flowthru.Configuration;
 using Flowthru.Data;
 using Flowthru.Data.Storage.Strategies;
+using Flowthru.Flows;
 using Flowthru.Meta;
 using Flowthru.Meta.Providers;
 using Microsoft.Extensions.Configuration;
@@ -15,15 +16,15 @@ namespace Flowthru.Services;
 /// <remarks>
 /// <para>
 /// This builder configures the service layer without CLI coupling.
-/// Use it to register catalogs, pipelines, and optional features.
+/// Use it to register catalogs, flows, and optional features.
 /// </para>
 /// <para>
 /// <strong>Basic Usage:</strong>
 /// <code>
 /// services.AddFlowthru(flowthru =>
 /// {
-///     flowthru.UseCatalog(_ => new MyCatalog(dataPath));
-///     flowthru.RegisterPipeline("my_pipeline", MyPipeline.Create);
+///     flowthru.RegisterCatalog(_ => new MyCatalog(dataPath));
+///     flowthru.RegisterFlow("my_flow", MyFlow.Create);
 /// });
 /// </code>
 /// </para>
@@ -33,11 +34,11 @@ public sealed class FlowthruServiceBuilder
   private readonly IServiceCollection _services;
   private readonly List<Type> _registeredCatalogTypes = new();
   private readonly List<
-    Func<IServiceProvider, IEnumerable<DataCatalogBase>>
+    Func<IServiceProvider, IEnumerable<CatalogAbstract>>
   > _dynamicCatalogFactories = new();
-  private readonly List<PipelineRegistrationEntry> _registrations = new();
-  private Func<IServiceProvider, Dictionary<string, Pipelines.Pipeline>>? _pipelineFactory;
-  private PipelineRegistrationEntry? _lastRegistration;
+  private readonly List<FlowRegistrationEntry> _registrations = new();
+  private Func<IServiceProvider, Dictionary<string, Flow>>? _flowFactory;
+  private FlowRegistrationEntry? _lastRegistration;
   private IConfiguration? _configuration;
 
   internal FlowthruServiceBuilder(IServiceCollection services)
@@ -46,19 +47,16 @@ internal FlowthruServiceBuilder(IServiceCollection services)
   }
 
   /// <summary>
-  /// Internal entry type that carries a pipeline factory and its associated metadata.
-  /// Replaces the PipelineRegistrar indirection for cleaner multi-catalog support.
+  /// Internal entry type that carries a Flow factory and its associated metadata.
+  /// Replaces the FlowRegistrar indirection for cleaner multi-catalog support.
   /// </summary>
-  internal sealed class PipelineRegistrationEntry
+  internal sealed class FlowRegistrationEntry
   {
     public string Label { get; }
-    public Func<IServiceProvider, Pipelines.Pipeline> Factory { get; }
+    public Func<IServiceProvider, Flow> Factory { get; }
     public string Description { get; set; } = "";
 
-    internal PipelineRegistrationEntry(
-      string label,
-      Func<IServiceProvider, Pipelines.Pipeline> factory
-    )
+    internal FlowRegistrationEntry(string label, Func<IServiceProvider, Flow> factory)
     {
       Label = label;
       Factory = factory;
@@ -74,8 +72,8 @@ internal PipelineRegistrationEntry(
   /// The catalog will be resolved from the DI container, allowing constructor
   /// parameter injection (e.g., IConfiguration, IOptions).
   /// </remarks>
-  public FlowthruServiceBuilder UseCatalog<TCatalog>()
-    where TCatalog : DataCatalogBase
+  public FlowthruServiceBuilder RegisterCatalog<TCatalog>()
+    where TCatalog : CatalogAbstract
   {
     _services.AddSingleton<TCatalog>();
     _registeredCatalogTypes.Add(typeof(TCatalog));
@@ -90,7 +88,7 @@ public FlowthruServiceBuilder UseCatalog<TCatalog>()
   /// <remarks>
   /// Use this when the catalog doesn't require dependency injection.
   /// </remarks>
-  public FlowthruServiceBuilder UseCatalog(DataCatalogBase catalog)
+  public FlowthruServiceBuilder RegisterCatalog(CatalogAbstract catalog)
   {
     if (catalog == null)
     {
@@ -112,10 +110,10 @@ public FlowthruServiceBuilder UseCatalog(DataCatalogBase catalog)
   /// Use this when the catalog needs to resolve services during construction,
   /// or when construction requires parameters unavailable at the call site.
   /// </remarks>
-  public FlowthruServiceBuilder UseCatalog<TCatalog>(
+  public FlowthruServiceBuilder RegisterCatalog<TCatalog>(
     Func<IServiceProvider, TCatalog> catalogFactory
   )
-    where TCatalog : DataCatalogBase
+    where TCatalog : CatalogAbstract
   {
     if (catalogFactory == null)
     {
@@ -136,10 +134,10 @@ Func<IServiceProvider, TCatalog> catalogFactory
   /// <returns>This builder for method chaining</returns>
   /// <remarks>
   /// All registered catalogs will receive DI service injection and appear in
-  /// <see cref="IFlowthruService.Catalogs"/>. Use with <see cref="UsePipelines"/> to
-  /// wire per-catalog pipelines in a loop.
+  /// <see cref="IFlowthruService.Catalogs"/>. Use with <see cref="RegisterFlows"/> to
+  /// wire per-catalog flows in a loop.
   /// </remarks>
-  public FlowthruServiceBuilder UseCatalogs(IEnumerable<DataCatalogBase> catalogs)
+  public FlowthruServiceBuilder RegisterCatalogs(IEnumerable<CatalogAbstract> catalogs)
   {
     if (catalogs == null)
       throw new ArgumentNullException(nameof(catalogs));
@@ -155,8 +153,8 @@ public FlowthruServiceBuilder UseCatalogs(IEnumerable<DataCatalogBase> catalogs)
   /// </summary>
   /// <param name="catalogsFactory">Factory that returns the catalog collection</param>
   /// <returns>This builder for method chaining</returns>
-  public FlowthruServiceBuilder UseCatalogs(
-    Func<IServiceProvider, IEnumerable<DataCatalogBase>> catalogsFactory
+  public FlowthruServiceBuilder RegisterCatalogs(
+    Func<IServiceProvider, IEnumerable<CatalogAbstract>> catalogsFactory
   )
   {
     if (catalogsFactory == null)
@@ -167,64 +165,64 @@ Func<IServiceProvider, IEnumerable<DataCatalogBase>> catalogsFactory
   }
 
   /// <summary>
-  /// Escape-hatch for registering pipelines via a full-access service provider factory.
+  /// Escape-hatch for registering flows via a full-access service provider factory.
   /// </summary>
-  /// <param name="pipelineFactory">Factory function that receives the service provider and returns the pipeline dictionary</param>
+  /// <param name="flowFactory">Factory function that receives the service provider and returns the Flow dictionary</param>
   /// <returns>This builder for method chaining</returns>
   /// <remarks>
-  /// Prefer <see cref="RegisterPipeline(string, Delegate, string?)"/> for standard pipeline registration.
-  /// Use this only when you need full service provider access during pipeline construction.
+  /// Prefer <see cref="RegisterFlow(string, Delegate, string?)"/> for standard Flow registration.
+  /// Use this only when you need full service provider access during Flow construction.
   /// </remarks>
-  public FlowthruServiceBuilder UsePipelines(
-    Func<IServiceProvider, Dictionary<string, Pipelines.Pipeline>> pipelineFactory
+  public FlowthruServiceBuilder RegisterFlows(
+    Func<IServiceProvider, Dictionary<string, Flow>> flowFactory
   )
   {
-    if (pipelineFactory == null)
+    if (flowFactory == null)
     {
-      throw new ArgumentNullException(nameof(pipelineFactory));
+      throw new ArgumentNullException(nameof(flowFactory));
     }
 
-    _pipelineFactory = pipelineFactory;
+    _flowFactory = flowFactory;
 
     return this;
   }
 
   /// <summary>
-  /// Registers a pipeline by inspecting the delegate's parameter types at runtime.
-  /// Parameters that extend <see cref="DataCatalogBase"/> are resolved from DI as catalogs.
+  /// Registers a Flow by inspecting the delegate's parameter types at runtime.
+  /// Parameters that extend <see cref="CatalogAbstract"/> are resolved from DI as catalogs.
   /// All other parameters are resolved from DI as services.
   /// </summary>
-  /// <param name="label">Unique pipeline name</param>
-  /// <param name="pipeline">A method group or delegate whose parameters are catalogs, services, or config objects</param>
+  /// <param name="label">Unique Flow name</param>
+  /// <param name="flow">A method group or delegate whose parameters are catalogs, services, or config objects</param>
   /// <param name="configurationSection">
   /// Optional configuration section path. When provided, the last non-catalog, non-service parameter
   /// is bound from configuration instead of DI.
   /// </param>
   /// <returns>This builder for method chaining</returns>
-  public FlowthruServiceBuilder RegisterPipeline(
+  public FlowthruServiceBuilder RegisterFlow(
     string label,
-    Delegate pipeline,
+    Delegate flow,
     string? configurationSection = null
   )
   {
     if (string.IsNullOrWhiteSpace(label))
-      throw new ArgumentException("Pipeline label cannot be null or empty.", nameof(label));
-    if (pipeline == null)
-      throw new ArgumentNullException(nameof(pipeline));
+      throw new ArgumentException("Flow label cannot be null or empty.", nameof(label));
+    if (flow == null)
+      throw new ArgumentNullException(nameof(flow));
 
-    var method = pipeline.Method;
+    var method = flow.Method;
     var parameters = method.GetParameters();
 
     // Validate return type
-    if (method.ReturnType != typeof(Pipelines.Pipeline))
+    if (method.ReturnType != typeof(Flow))
     {
       throw new ArgumentException(
-        $"Pipeline delegate must return Pipeline, but '{method.Name}' returns {method.ReturnType.Name}.",
-        nameof(pipeline)
+        $"Flow delegate must return Flow, but '{method.Name}' returns {method.ReturnType.Name}.",
+        nameof(flow)
       );
     }
 
-    // Build the resolver: for each parameter, determine how to resolve it at pipeline-build time
+    // Build the resolver: for each parameter, determine how to resolve it at flow-build time
     var resolvers = new Func<IServiceProvider, object?>[parameters.Length];
     for (int i = 0; i < parameters.Length; i++)
     {
@@ -232,7 +230,7 @@ public FlowthruServiceBuilder RegisterPipeline(
 
       if (
         configurationSection != null
-        && !typeof(DataCatalogBase).IsAssignableFrom(paramType)
+        && !typeof(CatalogAbstract).IsAssignableFrom(paramType)
         && !paramType.IsInterface
       )
       {
@@ -240,7 +238,7 @@ public FlowthruServiceBuilder RegisterPipeline(
         if (_configuration == null)
         {
           throw new InvalidOperationException(
-            $"Pipeline '{label}' specifies a configuration section but UseConfiguration() has not been called."
+            $"Flow '{label}' specifies a configuration section but UseConfiguration() has not been called."
           );
         }
 
@@ -257,15 +255,15 @@ public FlowthruServiceBuilder RegisterPipeline(
       }
     }
 
-    var capturedDelegate = pipeline;
-    var entry = new PipelineRegistrationEntry(
+    var capturedDelegate = flow;
+    var entry = new FlowRegistrationEntry(
       label,
       sp =>
       {
         var args = new object?[resolvers.Length];
         for (int i = 0; i < resolvers.Length; i++)
           args[i] = resolvers[i](sp);
-        return (Pipelines.Pipeline)capturedDelegate.DynamicInvoke(args)!;
+        return (Flow)capturedDelegate.DynamicInvoke(args)!;
       }
     );
     _registrations.Add(entry);
@@ -274,16 +272,16 @@ public FlowthruServiceBuilder RegisterPipeline(
   }
 
   /// <summary>
-  /// Adds a description to the most recently registered pipeline.
+  /// Adds a description to the most recently registered flow.
   /// </summary>
-  /// <param name="description">Human-readable description of what the pipeline does</param>
+  /// <param name="description">Human-readable description of what the Flow does</param>
   /// <returns>This builder for method chaining</returns>
   public FlowthruServiceBuilder WithDescription(string description)
   {
     if (_lastRegistration == null)
     {
       throw new InvalidOperationException(
-        "WithDescription() can only be used after RegisterPipeline()."
+        "WithDescription() can only be used after RegisterFlow()."
       );
     }
 
@@ -448,7 +446,7 @@ Func<IServiceProvider, IStorageEntryFactory> strategyFactory
   /// <returns>This builder for method chaining</returns>
   /// <remarks>
   /// <para>
-  /// Metadata export is optional. If not configured, pipelines will execute
+  /// Metadata export is optional. If not configured, flows will execute
   /// without generating DAG diagrams or metadata files.
   /// </para>
   /// <para>
@@ -556,10 +554,10 @@ private static void ApplyMetadataOptions(FlowthruMetadataBuilder builder, Metada
                 };
                 mermaid.WithDirection(direction);
 
-                // Apply color configuration for active nodes and data
-                if (!string.IsNullOrEmpty(options.Mermaid.ActiveNodeColor))
+                // Apply color configuration for active steps and data
+                if (!string.IsNullOrEmpty(options.Mermaid.ActiveStepColor))
                 {
-                  mermaid.WithActiveNodeColor(options.Mermaid.ActiveNodeColor);
+                  mermaid.WithActiveStepColor(options.Mermaid.ActiveStepColor);
                 }
                 if (!string.IsNullOrEmpty(options.Mermaid.ActiveDataColor))
                 {
@@ -604,53 +602,53 @@ private static void ApplyFileConfiguration<TBuilder>(TBuilder builder, MetadataO
 
   /// <summary>
   /// Internal method called by AddFlowthru to register the catalog collection and
-  /// pipeline dictionary into the DI container. Must be called after all UseCatalog
-  /// and RegisterPipeline calls have been made.
+  /// Flow dictionary into the DI container. Must be called after all RegisterCatalog
+  /// and RegisterFlow calls have been made.
   /// </summary>
-  internal void RegisterPipelineDictionary()
+  internal void RegisterFlowDictionary()
   {
     // Always register the catalog collection so FlowthruService can inject all catalogs.
-    // Merges both type-registered catalogs (UseCatalog) and dynamically constructed
-    // catalog collections (UseCatalogs).
+    // Merges both type-registered catalogs (RegisterCatalog) and dynamically constructed
+    // catalog collections (RegisterCatalogs).
     var catalogTypes = _registeredCatalogTypes.ToList();
     var dynamicFactories = _dynamicCatalogFactories.ToList();
-    _services.AddSingleton<IReadOnlyList<DataCatalogBase>>(sp =>
+    _services.AddSingleton<IReadOnlyList<CatalogAbstract>>(sp =>
     {
-      var typedCatalogs = catalogTypes.Select(t => (DataCatalogBase)sp.GetRequiredService(t));
+      var typedCatalogs = catalogTypes.Select(t => (CatalogAbstract)sp.GetRequiredService(t));
       var dynamicCatalogs = dynamicFactories.SelectMany(f => f(sp));
       return typedCatalogs.Concat(dynamicCatalogs).ToList().AsReadOnly();
     });
 
     var snapshot = _registrations.ToList();
-    var factory = _pipelineFactory;
+    var factory = _flowFactory;
 
     if (snapshot.Count == 0 && factory == null)
     {
       throw new InvalidOperationException(
-        "No pipelines were registered. Call RegisterPipeline() or UsePipelines() before building the service."
+        "No flows were registered. Call RegisterFlow() or RegisterFlows() before building the service."
       );
     }
 
-    _services.AddSingleton<Dictionary<string, Pipelines.Pipeline>>(sp =>
+    _services.AddSingleton<Dictionary<string, Flow>>(sp =>
     {
-      var result = new Dictionary<string, Pipelines.Pipeline>();
+      var result = new Dictionary<string, Flow>();
 
-      // Source 1: UsePipelines factory (registered first so inline registrations can override)
+      // Source 1: RegisterFlows factory (registered first so inline registrations can override)
       if (factory != null)
       {
-        foreach (var (key, pipeline) in factory(sp))
+        foreach (var (key, flow) in factory(sp))
         {
-          result[key] = pipeline;
+          result[key] = flow;
         }
       }
 
-      // Source 2: RegisterPipeline calls (wins on key collision)
+      // Source 2: RegisterFlow calls (wins on key collision)
       foreach (var reg in snapshot)
       {
-        var pipeline = reg.Factory(sp);
-        pipeline.Name = reg.Label;
-        pipeline.Description = reg.Description;
-        result[reg.Label] = pipeline;
+        var flow = reg.Factory(sp);
+        flow.Name = reg.Label;
+        flow.Description = reg.Description;
+        result[reg.Label] = flow;
       }
 
       return result;
diff --git a/src/core/Flowthru.Core/Services/FlowthruServiceCollectionExtensions.cs b/src/core/Flowthru.Core/Services/FlowthruServiceCollectionExtensions.cs
index adefc0d0..a048871e 100644
--- a/src/core/Flowthru.Core/Services/FlowthruServiceCollectionExtensions.cs
+++ b/src/core/Flowthru.Core/Services/FlowthruServiceCollectionExtensions.cs
@@ -24,8 +24,8 @@ public static class FlowthruServiceCollectionExtensions
   /// // In Program.cs or Startup.cs
   /// services.AddFlowthru(flowthru =>
   /// {
-  ///     flowthru.UseCatalog&lt;MyCatalog&gt;();
-  ///     flowthru.UsePipelines(catalog => new Dictionary&lt;string, Pipeline&gt;
+  ///     flowthru.RegisterCatalog&lt;MyCatalog&gt;();
+  ///     flowthru.RegisterPipelines(catalog => new Dictionary&lt;string, Pipeline&gt;
   ///     {
   ///         ["my_pipeline"] = MyPipeline.Create((MyCatalog)catalog)
   ///     });
@@ -48,7 +48,7 @@ public static class FlowthruServiceCollectionExtensions
   ///
   ///     public async Task&lt;IActionResult&gt; RunPipeline(string name)
   ///     {
-  ///         var request = new PipelineExecutionRequest { PipelineName = name };
+  ///         var request = new PipelineExecutionRequest { FlowName = name };
   ///         var result = await _flowthru.ExecutePipelineAsync(request);
   ///         return Ok(result);
   ///     }
@@ -76,7 +76,7 @@ Action<FlowthruServiceBuilder> configure
     configure(builder);
 
     // Register pipeline dictionary factory if inline registrations exist
-    builder.RegisterPipelineDictionary();
+    builder.RegisterFlowDictionary();
 
     // Register core service
     services.AddSingleton<IFlowthruService, FlowthruService>();
diff --git a/src/core/Flowthru.Core/Services/IFlowthruService.cs b/src/core/Flowthru.Core/Services/IFlowthruService.cs
index ce8ee930..8cb81969 100644
--- a/src/core/Flowthru.Core/Services/IFlowthruService.cs
+++ b/src/core/Flowthru.Core/Services/IFlowthruService.cs
@@ -1,13 +1,13 @@
 using Flowthru.Data;
 using Flowthru.Data.Validation;
+using Flowthru.Flows;
 using Flowthru.Meta.Models;
-using Flowthru.Pipelines;
 using Flowthru.Services.Models;
 
 namespace Flowthru.Services;
 
 /// <summary>
-/// Core service for executing Flowthru pipelines programmatically.
+/// Core service for executing Flowthru flows programmatically.
 /// </summary>
 /// <remarks>
 /// <para>
@@ -35,17 +35,17 @@ namespace Flowthru.Services;
 ///         var options = new ExecutionOptions
 ///         {
 ///             DryRun = false,
-///             SliceStrategy = new PipelineSliceStrategy
+///             SliceStrategy = new FlowSliceStrategy
 ///             {
-///                 Pipelines = new HashSet&lt;string&gt; { "data_processing" }
+///                 Flows = new HashSet&lt;string&gt; { "data_processing" }
 ///             }
 ///         };
 ///
-///         var result = await _flowthru.ExecutePipelineAsync(options);
+///         var result = await _flowthru.ExecuteFlowAsync(options);
 ///
 ///         if (result.Success)
 ///         {
-///             Console.WriteLine($"Processed {result.NodeResults.Count} nodes");
+///             Console.WriteLine($"Processed {result.StepResults.Count} flow");
 ///         }
 ///     }
 /// }
@@ -55,39 +55,39 @@ namespace Flowthru.Services;
 public interface IFlowthruService
 {
   /// <summary>
-  /// Gets the names of all registered pipelines.
+  /// Gets the names of all registered flows.
   /// </summary>
-  IReadOnlyCollection<string> PipelineNames { get; }
+  IReadOnlyCollection<string> FlowNames { get; }
 
   /// <summary>
   /// Gets all registered catalog instances.
   /// </summary>
-  IReadOnlyList<DataCatalogBase> Catalogs { get; }
+  IReadOnlyList<CatalogAbstract> Catalogs { get; }
 
   /// <summary>
-  /// Executes all registered pipelines, optionally sliced by criteria.
+  /// Executes all registered flows, optionally sliced by criteria.
   /// </summary>
   /// <param name="options">Execution options with optional slice strategy</param>
   /// <param name="exportMetadata">Whether to export DAG metadata</param>
   /// <param name="metadataOutputDirectory">Override for metadata output directory</param>
   /// <param name="cancellationToken">Cancellation token</param>
-  /// <returns>Execution result with timing, node results, and status</returns>
+  /// <returns>Execution result with timing, step results, and status</returns>
   /// <remarks>
-  /// This method always merges all registered pipelines into a single DAG,
+  /// This method always merges all registered flows into a single DAG,
   /// then applies optional slicing criteria from the execution options.
-  /// This enables cross-pipeline queries (e.g., --to-data across all pipelines).
-  /// To execute only specific pipelines, use SliceStrategy.Pipelines.
+  /// This enables cross-flow queries (e.g., --to-data across all flows).
+  /// To execute only specific flows, use SliceStrategy.Flows.
   ///
   /// The method performs:
-  /// 1. Pipeline merging into unified DAG
+  /// 1. Flow merging into unified DAG
   /// 2. Service injection
   /// 3. DAG building and slice application
   /// 4. Metadata export (if requested)
   /// 5. External input validation
-  /// 6. Pipeline execution (unless dry run)
+  /// 6. Flow execution (unless dry run)
   /// 7. Result formatting
   /// </remarks>
-  Task<PipelineResult> ExecutePipelineAsync(
+  Task<FlowResult> ExecuteFlowAsync(
     ExecutionOptions? options = null,
     bool exportMetadata = true,
     string? metadataOutputDirectory = null,
@@ -95,74 +95,71 @@ Task<PipelineResult> ExecutePipelineAsync(
   );
 
   /// <summary>
-  /// Gets metadata about a pipeline's structure.
+  /// Gets metadata about a Flow's structure.
   /// </summary>
-  /// <param name="pipelineName">Pipeline name</param>
-  /// <returns>Pipeline metadata</returns>
-  /// <exception cref="KeyNotFoundException">Thrown if pipeline name not found</exception>
+  /// <param name="flowName">Flow name</param>
+  /// <returns>Flow metadata</returns>
+  /// <exception cref="KeyNotFoundException">Thrown if Flow name not found</exception>
   /// <remarks>
-  /// Returns structural information without executing the pipeline.
-  /// The pipeline must be built for accurate layer and input information.
+  /// Returns structural information without executing the flow.
+  /// The Flow must be built for accurate layer and input information.
   /// </remarks>
-  PipelineMetadata GetPipelineMetadata(string pipelineName);
+  FlowMetadata GetFlowMetadata(string flowName);
 
   /// <summary>
-  /// Gets the full DAG metadata for pipeline introspection.
+  /// Gets the full DAG metadata for Flow introspection.
   /// </summary>
-  /// <param name="pipelineName">
-  /// Optional pipeline name to inspect a single pipeline.
-  /// When null, all registered pipelines are merged into a unified DAG.
+  /// <param name="flowName">
+  /// Optional Flow name to inspect a single flow.
+  /// When null, all registered flows are merged into a unified DAG.
   /// </param>
   /// <param name="sliceStrategy">
-  /// Optional slice strategy to filter the DAG (e.g., from-node, to-data).
+  /// Optional slice strategy to filter the DAG (e.g., from-node).
   /// When provided, the returned metadata includes slice overlay information
-  /// (SlicedNodeIds and SlicedCatalogEntryKeys) identifying which nodes
+  /// (SlicedStepIds and SlicedItemKeys) identifying which nodes
   /// and data are in the active execution subset.
   /// </param>
   /// <returns>
-  /// Full DAG metadata including nodes, catalog entries, edges, schemas,
+  /// Full DAG metadata including steps, catalog entries, edges, schemas,
   /// and producer-consumer relationships.
   /// </returns>
   /// <exception cref="KeyNotFoundException">
-  /// Thrown if <paramref name="pipelineName"/> is specified but not found.
+  /// Thrown if <paramref name="flowName"/> is specified but not found.
   /// </exception>
   /// <remarks>
-  /// This method does not execute the pipeline. It returns structural metadata
+  /// This method does not execute the flow. It returns structural metadata
   /// useful for visualization, impact analysis, data lineage, and debugging.
   ///
   /// Examples:
   /// <code>
-  /// // Inspect all pipelines merged
+  /// // Inspect all Flow merged
   /// var dag = flowthru.GetDagMetadata();
   ///
-  /// // Inspect a single pipeline
+  /// // Inspect a single flow
   /// var dag = flowthru.GetDagMetadata("DataProcessing");
   ///
-  /// // Inspect downstream of a specific node
-  /// var dag = flowthru.GetDagMetadata(sliceStrategy: new PipelineSliceStrategy
+  /// // Inspect downstream of a specific Flow node
+  /// var dag = flowthru.GetDagMetadata(sliceStrategy: new FlowSliceStrategy
   /// {
-  ///     FromNodes = new HashSet&lt;string&gt; { "PreprocessCompanies" }
+  ///     FromSteps = new HashSet&lt;string&gt; { "PreprocessCompanies" }
   /// });
   /// </code>
   /// </remarks>
-  DagMetadata GetDagMetadata(
-    string? pipelineName = null,
-    PipelineSliceStrategy? sliceStrategy = null
-  );
+  DagMetadata GetDagMetadata(string? flowName = null, FlowSliceStrategy? sliceStrategy = null);
 
   /// <summary>
-  /// Validates all external inputs (Layer 0) for a pipeline.
+  /// Validates all external inputs (Layer 0) for a flow.
   /// </summary>
-  /// <param name="pipelineName">Pipeline name</param>
+  /// <param name="flowName">Flow name</param>
   /// <param name="cancellationToken">Cancellation token</param>
   /// <returns>Validation result</returns>
-  /// <exception cref="KeyNotFoundException">Thrown if pipeline name not found</exception>
+  /// <exception cref="KeyNotFoundException">Thrown if Flow name not found</exception>
   /// <remarks>
-  /// Checks accessibility of external data sources without executing the pipeline.
+  /// Checks accessibility of external data sources without executing the flow.
   /// Useful for pre-flight validation in CI/CD or scheduled jobs.
   /// </remarks>
-  Task<ValidationResult> ValidatePipelineAsync(
-    string pipelineName,
+  Task<ValidationResult> ValidateFlowAsync(
+    string flowName,
     CancellationToken cancellationToken = default
   );
 }
diff --git a/src/core/Flowthru.Core/Services/Models/PipelineExecutionRequest.cs b/src/core/Flowthru.Core/Services/Models/PipelineExecutionRequest.cs
deleted file mode 100644
index fd61dc51..00000000
--- a/src/core/Flowthru.Core/Services/Models/PipelineExecutionRequest.cs
+++ /dev/null
@@ -1,47 +0,0 @@
-using Flowthru.Pipelines;
-
-namespace Flowthru.Services.Models;
-
-/// <summary>
-/// Request model for pipeline execution.
-/// </summary>
-/// <remarks>
-/// Encapsulates all configuration needed to execute a pipeline programmatically,
-/// separate from CLI argument parsing.
-/// </remarks>
-public record PipelineExecutionRequest
-{
-  /// <summary>
-  /// Name of the pipeline to execute.
-  /// </summary>
-  public required string PipelineName { get; init; }
-
-  /// <summary>
-  /// Execution options (dry run, parallel execution, etc.).
-  /// </summary>
-  /// <remarks>
-  /// If null, uses default execution options.
-  /// </remarks>
-  public ExecutionOptions? Options { get; init; }
-
-  /// <summary>
-  /// Optional slicing strategy to execute a subset of the pipeline.
-  /// </summary>
-  /// <remarks>
-  /// If null or IsSliced=false, the entire pipeline executes.
-  /// </remarks>
-  public PipelineSliceStrategy? SliceStrategy { get; init; }
-
-  /// <summary>
-  /// Whether to export DAG metadata.
-  /// </summary>
-  /// <remarks>
-  /// Defaults to true. Only applies if a metadata builder is configured.
-  /// </remarks>
-  public bool ExportMetadata { get; init; } = true;
-
-  /// <summary>
-  /// Output directory for metadata (if null, uses default from metadata builder).
-  /// </summary>
-  public string? MetadataOutputDirectory { get; init; }
-}
diff --git a/src/core/Flowthru.Core/Services/Models/PipelineMetadata.cs b/src/core/Flowthru.Core/Services/Models/PipelineMetadata.cs
index 5c1980e8..dee4620c 100644
--- a/src/core/Flowthru.Core/Services/Models/PipelineMetadata.cs
+++ b/src/core/Flowthru.Core/Services/Models/PipelineMetadata.cs
@@ -1,31 +1,31 @@
 namespace Flowthru.Services.Models;
 
 /// <summary>
-/// Metadata about a pipeline's structure and configuration.
+/// Metadata about a flow's structure and configuration.
 /// </summary>
 /// <remarks>
-/// Provides read-only information about a pipeline without executing it.
+/// Provides read-only information about a Flow without executing it.
 /// Useful for discovery, validation, and UI generation.
 /// </remarks>
-public sealed record PipelineMetadata
+public sealed record FlowMetadata
 {
   /// <summary>
-  /// The pipeline's registered name.
+  /// The flow's registered name.
   /// </summary>
   public required string Name { get; init; }
 
   /// <summary>
-  /// Optional description of the pipeline's purpose.
+  /// Optional description of the flow's purpose.
   /// </summary>
   public string? Description { get; init; }
 
   /// <summary>
-  /// Total number of nodes in the pipeline.
+  /// Total number of steps in the flow.
   /// </summary>
-  public required int NodeCount { get; init; }
+  public required int StepCount { get; init; }
 
   /// <summary>
-  /// Number of execution layers in the pipeline's DAG.
+  /// Number of execution layers in the flow's DAG.
   /// </summary>
   public required int LayerCount { get; init; }
 
@@ -35,7 +35,7 @@ public sealed record PipelineMetadata
   public required IReadOnlyList<string> ExternalInputs { get; init; }
 
   /// <summary>
-  /// Whether the pipeline has been built (DAG analyzed).
+  /// Whether the Flow has been built (DAG analyzed).
   /// </summary>
   public required bool IsBuilt { get; init; }
 }
diff --git a/src/core/Flowthru.Core/Steps/Factory/NodeFactory.cs b/src/core/Flowthru.Core/Steps/Factory/NodeFactory.cs
new file mode 100644
index 00000000..6807fa11
--- /dev/null
+++ b/src/core/Flowthru.Core/Steps/Factory/NodeFactory.cs
@@ -0,0 +1,42 @@
+namespace Flowthru.Steps.Factory;
+
+/// <summary>
+/// Factory for creating step instances using TypeActivator.
+/// </summary>
+/// <remarks>
+/// <para>
+/// <strong>Design Pattern:</strong> Factory Pattern - provides a centralized location for
+/// step instantiation logic.
+/// </para>
+/// <para>
+/// This is a thin wrapper around TypeActivator, providing a domain-specific API for
+/// creating steps. Could be extended in the future with:
+/// - Step validation logic
+/// - Pre/post-creation hooks
+/// - Step decoration/wrapping
+/// </para>
+/// </remarks>
+public static class StepFactory
+{
+  /// <summary>
+  /// Creates a new instance of the specified step type.
+  /// </summary>
+  /// <typeparam name="TStep">The step type to instantiate</typeparam>
+  /// <returns>A new step instance</returns>
+  /// <remarks>
+  /// <para>
+  /// <strong>Requirements:</strong>
+  /// - TStep must inherit from StepBase&lt;TInput, TOutput&gt;
+  /// - TStep must have a parameterless constructor
+  /// </para>
+  /// <para>
+  /// These requirements are enforced at compile-time via generic constraints in
+  /// FlowBuilder.AddStep methods.
+  /// </para>
+  /// </remarks>
+  public static TStep Create<TStep>()
+    where TStep : new()
+  {
+    return TypeActivator.Create<TStep>();
+  }
+}
diff --git a/src/core/Flowthru.Core/Nodes/Factory/TypeActivator.cs b/src/core/Flowthru.Core/Steps/Factory/TypeActivator.cs
similarity index 98%
rename from src/core/Flowthru.Core/Nodes/Factory/TypeActivator.cs
rename to src/core/Flowthru.Core/Steps/Factory/TypeActivator.cs
index a65759d9..e9a9f372 100644
--- a/src/core/Flowthru.Core/Nodes/Factory/TypeActivator.cs
+++ b/src/core/Flowthru.Core/Steps/Factory/TypeActivator.cs
@@ -1,7 +1,7 @@
 using System.Collections.Concurrent;
 using System.Linq.Expressions;
 
-namespace Flowthru.Nodes.Factory;
+namespace Flowthru.Steps.Factory;
 
 /// <summary>
 /// Factory for creating instances of types using compiled expression trees for performance.
@@ -18,7 +18,7 @@ namespace Flowthru.Nodes.Factory;
 /// - Significantly faster than Activator.CreateInstance&lt;T&gt;() for repeated calls
 /// </para>
 /// <para>
-/// <strong>Inspiration:</strong> ChainSharp uses similar pattern for node instantiation.
+/// <strong>Inspiration:</strong> ChainSharp uses similar pattern for step instantiation.
 /// </para>
 /// <para>
 /// <strong>Thread Safety:</strong> This class is thread-safe. Multiple threads can safely
diff --git a/src/core/Flowthru.Core/Nodes/NoData.cs b/src/core/Flowthru.Core/Steps/NoData.cs
similarity index 73%
rename from src/core/Flowthru.Core/Nodes/NoData.cs
rename to src/core/Flowthru.Core/Steps/NoData.cs
index be04a88e..f8f67b2d 100644
--- a/src/core/Flowthru.Core/Nodes/NoData.cs
+++ b/src/core/Flowthru.Core/Steps/NoData.cs
@@ -1,8 +1,8 @@
-namespace Flowthru.Nodes;
+namespace Flowthru.Steps;
 
 /// <summary>
 /// Marker type representing "no meaningful data" for nodes with side-effects or data generation.
-/// Used as input/output type in NodeBase when a node doesn't consume or produce meaningful data.
+/// Used as input/output type in StepBase when a step doesn't consume or produce meaningful data.
 /// </summary>
 /// <remarks>
 /// <para>
@@ -18,8 +18,8 @@ namespace Flowthru.Nodes;
 /// <strong>Usage Examples:</strong>
 /// </para>
 /// <code>
-/// // Node with no inputs (data generation)
-/// public class GenerateDataNode : NodeBase&lt;NoData, OutputSchema&gt;
+/// // Step with no inputs (data generation)
+/// public class GenerateDataStep : StepBase&lt;NoData, OutputSchema&gt;
 /// {
 ///     protected override Task&lt;IEnumerable&lt;OutputSchema&gt;&gt; Transform(IEnumerable&lt;NoData&gt; input)
 ///     {
@@ -28,8 +28,8 @@ namespace Flowthru.Nodes;
 ///     }
 /// }
 ///
-/// // Node with no outputs (side-effects only)
-/// public class ValidateNode : NodeBase&lt;InputSchema, NoData&gt;
+/// // Step with no outputs (side-effects only)
+/// public class ValidateStep : StepBase&lt;InputSchema, NoData&gt;
 /// {
 ///     protected override Task&lt;IEnumerable&lt;NoData&gt;&gt; Transform(IEnumerable&lt;InputSchema&gt; input)
 ///     {
@@ -44,12 +44,12 @@ namespace Flowthru.Nodes;
 /// </para>
 /// <code>
 /// // Simple syntax with automatic unique key generation
-/// pipeline.AddNode&lt;ValidationNode&gt;(
+/// pipeline.AddStep&lt;ValidationStep&gt;(
 ///     input: catalog.InputData,
 ///     output: NoData.Output  // or just: NoData.Discard
 /// );
 ///
-/// pipeline.AddNode&lt;GenerateDataNode&gt;(
+/// pipeline.AddStep&lt;GenerateDataStep&gt;(
 ///     input: NoData.Input,  // or just: NoData.None
 ///     output: catalog.GeneratedData
 /// );
@@ -61,49 +61,43 @@ public sealed class NoData
 
   /// <summary>
   /// Singleton instance of NoData.
-  /// Use this value when returning NoData from node transformations.
+  /// Use this value when returning NoData from step transformations.
   /// </summary>
   public static readonly NoData Value = new();
 
   /// <summary>
-  /// Creates a unique null catalog entry for use as a node input (no-input nodes).
+  /// Creates a unique null catalog entry for use as a step input (no-input nodes).
   /// Each call generates a new instance with a unique key to avoid DAG conflicts.
   /// </summary>
   /// <remarks>
   /// Alias for readability in pipeline declarations where nodes don't consume external inputs.
   /// </remarks>
-  public static Data.ICatalogEntry<NoData> Input =>
-    Data.CatalogEntries.Null<NoData>(
-      $"_nodata_input_{Interlocked.Increment(ref _uniqueIdCounter)}"
-    );
+  public static Data.IItem<NoData> Input =>
+    Data.ItemFactory.Null<NoData>($"_nodata_input_{Interlocked.Increment(ref _uniqueIdCounter)}");
 
   /// <summary>
-  /// Creates a unique null catalog entry for use as a node output (side-effect-only nodes).
+  /// Creates a unique null catalog entry for use as a step output (side-effect-only nodes).
   /// Each call generates a new instance with a unique key to avoid DAG conflicts.
   /// </summary>
   /// <remarks>
   /// Alias for readability in pipeline declarations where nodes produce no meaningful output.
   /// </remarks>
-  public static Data.ICatalogEntry<NoData> Output =>
-    Data.CatalogEntries.Null<NoData>(
-      $"_nodata_output_{Interlocked.Increment(ref _uniqueIdCounter)}"
-    );
+  public static Data.IItem<NoData> Output =>
+    Data.ItemFactory.Null<NoData>($"_nodata_output_{Interlocked.Increment(ref _uniqueIdCounter)}");
 
   /// <summary>
-  /// Creates a unique null catalog entry for use as a node output (side-effect-only nodes).
+  /// Creates a unique null catalog entry for use as a step output (side-effect-only nodes).
   /// Semantic alias for Output - use whichever reads better in context.
   /// </summary>
-  public static Data.ICatalogEntry<NoData> Discard =>
-    Data.CatalogEntries.Null<NoData>(
-      $"_nodata_discard_{Interlocked.Increment(ref _uniqueIdCounter)}"
-    );
+  public static Data.IItem<NoData> Discard =>
+    Data.ItemFactory.Null<NoData>($"_nodata_discard_{Interlocked.Increment(ref _uniqueIdCounter)}");
 
   /// <summary>
-  /// Creates a unique null catalog entry for use as a node input (no-input nodes).
+  /// Creates a unique null catalog entry for use as a step input (no-input nodes).
   /// Semantic alias for Input - use whichever reads better in context.
   /// </summary>
-  public static Data.ICatalogEntry<NoData> None =>
-    Data.CatalogEntries.Null<NoData>($"_nodata_none_{Interlocked.Increment(ref _uniqueIdCounter)}");
+  public static Data.IItem<NoData> None =>
+    Data.ItemFactory.Null<NoData>($"_nodata_none_{Interlocked.Increment(ref _uniqueIdCounter)}");
 
   /// <summary>
   /// Returns the standard NoData result for side-effect-only nodes.
diff --git a/src/core/Flowthru.Core/Nodes/NoParams.cs b/src/core/Flowthru.Core/Steps/NoParams.cs
similarity index 61%
rename from src/core/Flowthru.Core/Nodes/NoParams.cs
rename to src/core/Flowthru.Core/Steps/NoParams.cs
index f367ec25..13a0cddf 100644
--- a/src/core/Flowthru.Core/Nodes/NoParams.cs
+++ b/src/core/Flowthru.Core/Steps/NoParams.cs
@@ -1,14 +1,14 @@
-namespace Flowthru.Nodes;
+namespace Flowthru.Steps;
 
 /// <summary>
 /// Marker type for nodes that don't require parameters.
-/// Used as the default TParameters type in NodeBase&lt;TInput, TOutput, TParameters&gt;.
+/// Used as the default TParameters type in StepBase&lt;TInput, TOutput, TParameters&gt;.
 /// </summary>
 /// <remarks>
 /// <para>
 /// This is a simple empty class that serves as a shorthand for users and the library
-/// when no parameters are needed for a node. Nodes that don't need configuration can
-/// omit the third type parameter by using the two-parameter NodeBase&lt;TInput, TOutput&gt;
+/// when no parameters are needed for a node. Steps that don't need configuration can
+/// omit the third type parameter by using the two-parameter StepBase&lt;TInput, TOutput&gt;
 /// convenience base class.
 /// </para>
 /// <para>
@@ -16,13 +16,13 @@ namespace Flowthru.Nodes;
 /// </para>
 /// <code>
 /// // Explicit NoParams (rarely needed)
-/// public class MyNode : NodeBase&lt;Input, Output, NoParams&gt; { }
+/// public class MyStep : StepBase&lt;Input, Output, NoParams&gt; { }
 ///
 /// // Recommended: Use two-parameter base class
-/// public class MyNode : NodeBase&lt;Input, Output&gt; { }
+/// public class MyStep : StepBase&lt;Input, Output&gt; { }
 ///
 /// // With parameters
-/// public class ConfigurableNode : NodeBase&lt;Input, Output, MyParameters&gt;
+/// public class ConfigurableStep : StepBase&lt;Input, Output, MyParameters&gt;
 /// {
 ///     // Parameters property is automatically available
 /// }
diff --git a/src/core/Flowthru.SourceGenerators/AnalyzerReleases.Unshipped.md b/src/core/Flowthru.SourceGenerators/AnalyzerReleases.Unshipped.md
index 80204708..7fbb586c 100644
--- a/src/core/Flowthru.SourceGenerators/AnalyzerReleases.Unshipped.md
+++ b/src/core/Flowthru.SourceGenerators/AnalyzerReleases.Unshipped.md
@@ -7,7 +7,7 @@
 | ------- | --------------------- | -------- | --------------------------------------------------------------------------- |
 | FT1001  | Flowthru.Schema       | Error    | FlowthruSchema type must be partial                                         |
 | FT1002  | Flowthru.Schema       | Warning  | Conflicting manual schema interface                                         |
-| FT2001  | Flowthru.Registration | Error    | Pipeline requires catalog not registered via UseCatalog                     |
+| FT2001  | Flowthru.Registration | Error    | Pipeline requires catalog not registered via RegisterCatalog                |
 | FT2002  | Flowthru.Registration | Warning  | Catalog registered but not referenced by any pipeline                       |
 | FT2003  | Flowthru.Registration | Warning  | Concrete pipeline parameter resolved from DI; consider configurationSection |
 | FT2004  | Flowthru.Registration | Error    | configurationSection specified but UseConfiguration() not called            |
diff --git a/src/core/Flowthru.SourceGenerators/FlowthruRegistrationAnalyzer.cs b/src/core/Flowthru.SourceGenerators/FlowthruRegistrationAnalyzer.cs
index f35ebfbb..3e9426f9 100644
--- a/src/core/Flowthru.SourceGenerators/FlowthruRegistrationAnalyzer.cs
+++ b/src/core/Flowthru.SourceGenerators/FlowthruRegistrationAnalyzer.cs
@@ -7,74 +7,105 @@
 namespace Flowthru.SourceGenerators;
 
 /// <summary>
-/// Roslyn analyzer that cross-references UseCatalog and RegisterPipeline calls
+/// Roslyn analyzer that cross-references RegisterCatalog and RegisterFlow calls
 /// within an AddFlowthru configuration block.
 ///
 /// Emits compile-time diagnostics when:
-///   FT1001 — A pipeline delegate parameter extends DataCatalogBase but no
-///            matching UseCatalog registration was found.
-///   FT1002 — A UseCatalog registration is never referenced by any pipeline.
+///   FT1001 — A Flow delegate parameter extends DataCatalogBase but no
+///            matching RegisterCatalog registration was found.
+///   FT1002 — A RegisterCatalog registration is never referenced by any flow.
 /// </summary>
 [DiagnosticAnalyzer(LanguageNames.CSharp)]
 public class FlowthruRegistrationAnalyzer : DiagnosticAnalyzer
 {
+  /// <summary>
+  /// No catalog registered for a Flow parameter that extends DataCatalogBase.
+  /// </summary>
   public const string MissingCatalogId = "FT2001";
+
+  /// <summary>
+  /// A catalog was registered via RegisterCatalog but is not referenced by any flow.
+  /// </summary>
   public const string UnusedCatalogId = "FT2002";
+
+  /// <summary>
+  /// A Flow has a concrete-class parameter that is not a catalog and is not covered by
+  /// configurationSection, meaning it will be resolved from DI. This may be intentional,
+  /// but if the parameter is a configuration POCO, the user should pass configurationSection
+  /// to RegisterFlow to bind it from appsettings instead.
+  /// </summary>
   public const string UnboundConcreteParamId = "FT2003";
+
+  /// <summary>
+  /// A Flow registration specifies a configurationSection but UseConfiguration() was never called
+  /// on the builder. The Flow will throw at pre-flight time when it attempts to resolve the
+  /// configurationSection.
+  /// </summary>
   public const string MissingUseConfigurationId = "FT2004";
 
-  private static readonly DiagnosticDescriptor MissingCatalogRule =
+  private static readonly DiagnosticDescriptor _missingCatalogRule =
     new(
       MissingCatalogId,
       "Missing catalog registration",
-      "Pipeline '{0}' requires catalog '{1}' but no matching UseCatalog registration was found",
+      "Flow '{0}' requires catalog '{1}' but no matching RegisterCatalog registration was found",
       "Flowthru.Registration",
       DiagnosticSeverity.Error,
       isEnabledByDefault: true,
-      description: "Every DataCatalogBase-derived parameter in a RegisterPipeline delegate must have a corresponding UseCatalog registration."
+      description: "Every DataCatalogBase-derived parameter in a RegisterFlow delegate must have a corresponding RegisterCatalog registration."
     );
 
-  private static readonly DiagnosticDescriptor UnusedCatalogRule =
+  private static readonly DiagnosticDescriptor _unusedCatalogRule =
     new(
       UnusedCatalogId,
       "Unused catalog registration",
-      "Catalog '{0}' is registered via UseCatalog but is not referenced by any pipeline",
+      "Catalog '{0}' is registered via RegisterCatalog but is not referenced by any flow",
       "Flowthru.Registration",
       DiagnosticSeverity.Warning,
       isEnabledByDefault: true,
-      description: "A catalog was registered but no pipeline references it. This may indicate dead configuration."
+      description: "A catalog was registered but no flow references it. This may indicate dead configuration."
     );
 
-  private static readonly DiagnosticDescriptor UnboundConcreteParamRule =
+  private static readonly DiagnosticDescriptor _unboundConcreteParamRule =
     new(
       UnboundConcreteParamId,
       "Unbound concrete parameter",
-      "Pipeline '{0}' has parameter '{1}' of type '{2}' that will be resolved from DI. If it is a configuration object, pass configurationSection to RegisterPipeline.",
+      "Flow '{0}' has parameter '{1}' of type '{2}' that will be resolved from DI. If it is a configuration object, pass configurationSection to RegisterFlow.",
       "Flowthru.Registration",
       DiagnosticSeverity.Warning,
       isEnabledByDefault: true,
-      description: "A concrete-class pipeline parameter that is not a catalog will be resolved from DI at pipeline-build time. If it is a configuration POCO, pass configurationSection to RegisterPipeline to bind it from appsettings instead."
+      description: "A concrete-class flow parameter that is not a catalog will be resolved from DI at flow-build time. If it is a configuration POCO, pass configurationSection to RegisterFlow to bind it from appsettings instead."
     );
 
-  private static readonly DiagnosticDescriptor MissingUseConfigurationRule =
+  private static readonly DiagnosticDescriptor _missingUseConfigurationRule =
     new(
       MissingUseConfigurationId,
       "Missing UseConfiguration call",
-      "Pipeline '{0}' specifies configurationSection '{1}' but UseConfiguration() has not been called",
+      "Flow '{0}' specifies configurationSection '{1}' but UseConfiguration() has not been called",
       "Flowthru.Registration",
       DiagnosticSeverity.Error,
       isEnabledByDefault: true,
-      description: "A RegisterPipeline call references a configurationSection, but UseConfiguration() was never called on the builder. The pipeline will throw at pre-flight time."
+      description: "A RegisterFlow call references a configurationSection, but UseConfiguration() was never called on the builder. The flow will throw at pre-flight time."
     );
 
+  /// <summary>
+  /// Supported diagnostics for this analyzer. Each descriptor corresponds to a specific
+  /// registration issue.
+  /// </summary>
   public override ImmutableArray<DiagnosticDescriptor> SupportedDiagnostics =>
     ImmutableArray.Create(
-      MissingCatalogRule,
-      UnusedCatalogRule,
-      UnboundConcreteParamRule,
-      MissingUseConfigurationRule
+      _missingCatalogRule,
+      _unusedCatalogRule,
+      _unboundConcreteParamRule,
+      _missingUseConfigurationRule
     );
 
+  /// <summary>
+  /// Initializes the analyzer by registering an operation block action that analyzes
+  /// the body of the lambda passed to AddFlowthru. We look for RegisterCatalog and
+  /// RegisterFlow calls, extract their relevant information, and cross-reference them to
+  /// emit diagnostics for any inconsistencies.
+  /// </summary>
+  /// <param name="context"></param>
   public override void Initialize(AnalysisContext context)
   {
     context.ConfigureGeneratedCodeAnalysis(GeneratedCodeAnalysisFlags.None);
@@ -85,24 +116,30 @@ public override void Initialize(AnalysisContext context)
   private static void AnalyzeOperationBlock(OperationBlockAnalysisContext context)
   {
     // We look for invocations of AddFlowthru that pass a lambda configuring the builder.
-    // Within that lambda, we collect UseCatalog and RegisterPipeline calls.
+    // Within that lambda, we collect RegisterCatalog and RegisterFlow calls.
 
     var dataCatalogBaseType = context.Compilation.GetTypeByMetadataName(
       "Flowthru.Data.DataCatalogBase"
     );
     if (dataCatalogBaseType == null)
+    {
       return;
+    }
 
     foreach (var block in context.OperationBlocks)
     {
       foreach (var operation in block.DescendantsAndSelf())
       {
         if (operation is not IInvocationOperation invocation)
+        {
           continue;
+        }
 
         // Match: services.AddFlowthru(flowthru => { ... })
         if (invocation.TargetMethod.Name != "AddFlowthru")
+        {
           continue;
+        }
 
         // Find the lambda argument
         var lambdaArg = invocation
@@ -113,7 +150,9 @@ private static void AnalyzeOperationBlock(OperationBlockAnalysisContext context)
           .FirstOrDefault();
 
         if (lambdaArg?.Body == null)
+        {
           continue;
+        }
 
         AnalyzeFlowthruBlock(context, lambdaArg.Body, dataCatalogBaseType);
       }
@@ -126,13 +165,13 @@ private static void AnalyzeFlowthruBlock(
     INamedTypeSymbol dataCatalogBaseType
   )
   {
-    // Collect registered catalog types from UseCatalog calls
+    // Collect registered catalog types from RegisterCatalog calls
     var registeredCatalogs = new System.Collections.Generic.Dictionary<
       string,
       IInvocationOperation
     >();
-    // Collect pipeline registrations with their required catalogs and any ambiguous concrete params
-    var pipelineRegistrations = new System.Collections.Generic.List<(
+    // Collect Flow registrations with their required catalogs and any ambiguous concrete params
+    var flowRegistrations = new System.Collections.Generic.List<(
       string Label,
       IInvocationOperation Invocation,
       System.Collections.Generic.List<ITypeSymbol> RequiredCatalogs,
@@ -146,14 +185,16 @@ INamedTypeSymbol dataCatalogBaseType
     foreach (var descendant in body.DescendantsAndSelf())
     {
       if (descendant is not IInvocationOperation call)
+      {
         continue;
+      }
 
       var methodName = call.TargetMethod.Name;
 
-      // ── UseCatalog ──
-      if (methodName == "UseCatalog")
+      // ── RegisterCatalog ──
+      if (methodName == "RegisterCatalog")
       {
-        var catalogType = ResolveCatalogTypeFromUseCatalog(call, dataCatalogBaseType);
+        var catalogType = ResolveCatalogTypeFromRegisterCatalog(call, dataCatalogBaseType);
         if (catalogType != null)
         {
           var key = catalogType.ToDisplayString(SymbolDisplayFormat.FullyQualifiedFormat);
@@ -161,23 +202,23 @@ INamedTypeSymbol dataCatalogBaseType
         }
       }
 
-      // ── RegisterPipeline ──
-      if (methodName == "RegisterPipeline")
+      // ── RegisterFlow ──
+      if (methodName == "RegisterFlow")
       {
-        var (label, requiredCatalogs, ambiguousConcreteParams) = ResolvePipelineRequirements(
+        var (label, requiredCatalogs, ambiguousConcreteParams) = ResolveFlowRequirements(
           call,
           dataCatalogBaseType
         );
         if (label != null)
         {
-          pipelineRegistrations.Add((label, call, requiredCatalogs, ambiguousConcreteParams));
+          flowRegistrations.Add((label, call, requiredCatalogs, ambiguousConcreteParams));
         }
       }
     }
 
-    // Cross-reference: FT2001 — pipeline requires catalog not registered
+    // Cross-reference: FT2001 — Flow requires catalog not registered
     var allReferencedCatalogs = new System.Collections.Generic.HashSet<string>();
-    foreach (var (label, invocation, requiredCatalogs, _) in pipelineRegistrations)
+    foreach (var (label, invocation, requiredCatalogs, _) in flowRegistrations)
     {
       foreach (var required in requiredCatalogs)
       {
@@ -187,7 +228,7 @@ INamedTypeSymbol dataCatalogBaseType
         if (!registeredCatalogs.ContainsKey(key))
         {
           var diagnostic = Diagnostic.Create(
-            MissingCatalogRule,
+            _missingCatalogRule,
             invocation.Syntax.GetLocation(),
             label,
             required.ToDisplayString(SymbolDisplayFormat.MinimallyQualifiedFormat)
@@ -210,7 +251,7 @@ INamedTypeSymbol dataCatalogBaseType
             : "unknown";
 
         var diagnostic = Diagnostic.Create(
-          UnusedCatalogRule,
+          _unusedCatalogRule,
           kvp.Value.Syntax.GetLocation(),
           catalogName
         );
@@ -219,12 +260,12 @@ INamedTypeSymbol dataCatalogBaseType
     }
 
     // FT2003 — concrete non-catalog parameter not bound from configuration
-    foreach (var (label, invocation, _, ambiguousConcreteParams) in pipelineRegistrations)
+    foreach (var (label, invocation, _, ambiguousConcreteParams) in flowRegistrations)
     {
       foreach (var (paramType, paramName) in ambiguousConcreteParams)
       {
         var diagnostic = Diagnostic.Create(
-          UnboundConcreteParamRule,
+          _unboundConcreteParamRule,
           invocation.Syntax.GetLocation(),
           label,
           paramName,
@@ -237,7 +278,7 @@ INamedTypeSymbol dataCatalogBaseType
     // FT2004 — configurationSection supplied but UseConfiguration never called
     if (!hasUseConfiguration)
     {
-      foreach (var (label, invocation, _, _) in pipelineRegistrations)
+      foreach (var (label, invocation, _, _) in flowRegistrations)
       {
         string? sectionValue = null;
         foreach (var arg in invocation.Arguments)
@@ -256,7 +297,7 @@ INamedTypeSymbol dataCatalogBaseType
         if (sectionValue != null)
         {
           var diagnostic = Diagnostic.Create(
-            MissingUseConfigurationRule,
+            _missingUseConfigurationRule,
             invocation.Syntax.GetLocation(),
             label,
             sectionValue
@@ -268,25 +309,27 @@ INamedTypeSymbol dataCatalogBaseType
   }
 
   /// <summary>
-  /// Extracts the catalog type from a UseCatalog call.
-  /// Handles: UseCatalog&lt;T&gt;(), UseCatalog(instance), UseCatalog&lt;T&gt;(factory).
+  /// Extracts the catalog type from a RegisterCatalog call.
+  /// Handles: RegisterCatalog&lt;T&gt;(), RegisterCatalog(instance), RegisterCatalog&lt;T&gt;(factory).
   /// </summary>
-  private static ITypeSymbol? ResolveCatalogTypeFromUseCatalog(
+  private static ITypeSymbol? ResolveCatalogTypeFromRegisterCatalog(
     IInvocationOperation call,
     INamedTypeSymbol dataCatalogBaseType
   )
   {
     var method = call.TargetMethod;
 
-    // Generic: UseCatalog<TCatalog>() or UseCatalog<TCatalog>(factory)
+    // Generic: RegisterCatalog<TCatalog>() or RegisterCatalog<TCatalog>(factory)
     if (method.TypeArguments.Length == 1)
     {
       var typeArg = method.TypeArguments[0];
       if (InheritsFrom(typeArg, dataCatalogBaseType))
+      {
         return typeArg;
+      }
     }
 
-    // Non-generic: UseCatalog(catalogInstance) — infer from argument type.
+    // Non-generic: RegisterCatalog(catalogInstance) — infer from argument type.
     // Strip through implicit conversions: passing UpstreamCatalog to a DataCatalogBase
     // parameter wraps the expression in IConversionOperation; the concrete type lives
     // on the innermost operand, not on the outer conversion.
@@ -294,26 +337,33 @@ INamedTypeSymbol dataCatalogBaseType
     {
       IOperation argValue = call.Arguments[0].Value;
       while (argValue is IConversionOperation conv && conv.IsImplicit)
+      {
         argValue = conv.Operand;
+      }
+
       var argType = argValue.Type;
       if (argType != null && InheritsFrom(argType, dataCatalogBaseType))
+      {
         return argType;
+      }
     }
 
-    // Infer from lambda return type: UseCatalog(_ => new MyCatalog(...))
+    // Infer from lambda return type: RegisterCatalog(_ => new MyCatalog(...))
     if (method.TypeArguments.Length == 1)
+    {
       return method.TypeArguments[0];
+    }
 
     return null;
   }
 
   /// <summary>
-  /// Extracts the pipeline label, required catalog types, and unbound concrete parameters
-  /// from a RegisterPipeline call.
+  /// Extracts the Flow label, required catalog types, and unbound concrete parameters
+  /// from a RegisterFlow call.
   /// <para>
   /// Parameters are classified the same way the runtime resolver does:
   /// <list type="bullet">
-  /// <item>Extends <c>DataCatalogBase</c> → required catalog (FT2001 if missing UseCatalog)</item>
+  /// <item>Extends <c>DataCatalogBase</c> → required catalog (FT2001 if missing RegisterCatalog)</item>
   /// <item>Interface → DI-resolved service (no warning — extension territory)</item>
   /// <item>Concrete class, not covered by configurationSection → ambiguous (FT2003)</item>
   /// </list>
@@ -323,7 +373,7 @@ private static (
     string? Label,
     System.Collections.Generic.List<ITypeSymbol> RequiredCatalogs,
     System.Collections.Generic.List<(ITypeSymbol Type, string ParamName)> AmbiguousConcreteParams
-  ) ResolvePipelineRequirements(IInvocationOperation call, INamedTypeSymbol dataCatalogBaseType)
+  ) ResolveFlowRequirements(IInvocationOperation call, INamedTypeSymbol dataCatalogBaseType)
   {
     string? label = null;
     var requiredCatalogs = new System.Collections.Generic.List<ITypeSymbol>();
@@ -359,42 +409,49 @@ string ParamName
       }
     }
 
-    // Resolve pipeline parameters via delegate signature or method group.
-    System.Collections.Generic.IEnumerable<IParameterSymbol>? pipelineParams = null;
+    // Resolve Flow parameters via delegate signature or method group.
+    System.Collections.Generic.IEnumerable<IParameterSymbol>? flowParams = null;
     foreach (var arg in call.Arguments)
     {
-      if (arg.Parameter?.Name != "pipeline")
+      if (arg.Parameter?.Name != "flow")
+      {
         continue;
+      }
 
       // Path 1: lambda / typed Func — read from the delegate's Invoke method
       var delegateType = ResolveMethodSignatureFromArgument(arg.Value);
       if (delegateType?.DelegateInvokeMethod != null)
       {
-        pipelineParams = delegateType.DelegateInvokeMethod.Parameters;
+        flowParams = delegateType.DelegateInvokeMethod.Parameters;
         break;
       }
 
       // Path 2: method group — unwrap any conversion wrapper and read Method.Parameters
       IOperation value = arg.Value;
       while (value is IConversionOperation conv)
+      {
         value = conv.Operand;
+      }
+
       if (value is IMethodReferenceOperation methodRef)
-        pipelineParams = methodRef.Method.Parameters;
+      {
+        flowParams = methodRef.Method.Parameters;
+      }
 
       break;
     }
 
-    if (pipelineParams != null)
+    if (flowParams != null)
     {
       // The runtime consumes configurationSection on the first concrete non-catalog
       // non-interface param it encounters (left to right). Track that slot.
       bool configSectionConsumed = false;
 
-      foreach (var param in pipelineParams)
+      foreach (var param in flowParams)
       {
         if (InheritsFrom(param.Type, dataCatalogBaseType))
         {
-          // Catalog — must be registered via UseCatalog.
+          // Catalog — must be registered via RegisterCatalog.
           requiredCatalogs.Add(param.Type);
         }
         else if (param.Type.TypeKind == TypeKind.Interface)
@@ -425,7 +482,9 @@ string ParamName
   {
     // Unwrap conversions (method group → Delegate)
     while (value is IConversionOperation conversion)
+    {
       value = conversion.Operand;
+    }
 
     if (value is IDelegateCreationOperation delegateCreation)
     {
@@ -438,13 +497,18 @@ string ParamName
   private static bool InheritsFrom(ITypeSymbol? type, INamedTypeSymbol baseType)
   {
     if (type == null)
+    {
       return false;
+    }
 
     var current = type.BaseType;
     while (current != null)
     {
       if (SymbolEqualityComparer.Default.Equals(current, baseType))
+      {
         return true;
+      }
+
       current = current.BaseType;
     }
     return false;
diff --git a/src/core/Flowthru.SourceGenerators/PipelineBuilderGenerator.cs b/src/core/Flowthru.SourceGenerators/PipelineBuilderGenerator.cs
index 7ebc4c5f..f3a1e9ce 100644
--- a/src/core/Flowthru.SourceGenerators/PipelineBuilderGenerator.cs
+++ b/src/core/Flowthru.SourceGenerators/PipelineBuilderGenerator.cs
@@ -7,10 +7,10 @@
 namespace Flowthru.SourceGenerators;
 
 /// <summary>
-/// Generates AddNode overloads for PipelineBuilder supporting up to 8 inputs and 8 outputs.
+/// Generates AddStep overloads for FlowBuilder supporting up to 8 inputs and 8 outputs.
 /// </summary>
 [Generator]
-public class PipelineBuilderGenerator : IIncrementalGenerator
+public class FlowBuilderGenerator : IIncrementalGenerator
 {
   private const int MaxInputs = 8;
   private const int MaxOutputs = 8;
@@ -27,12 +27,12 @@ public void Initialize(IncrementalGeneratorInitializationContext context)
         if (name != "Flowthru.Core")
           return;
 
-        GenerateAddNodeOverloads(ctx);
+        GenerateAddStepOverloads(ctx);
       }
     );
   }
 
-  private static void GenerateAddNodeOverloads(SourceProductionContext context)
+  private static void GenerateAddStepOverloads(SourceProductionContext context)
   {
     var sb = new StringBuilder();
 
@@ -43,11 +43,11 @@ private static void GenerateAddNodeOverloads(SourceProductionContext context)
       #nullable enable
 
       using Flowthru.Data;
-      using Flowthru.Nodes;
+      using Flowthru.Steps;
 
-      namespace Flowthru.Pipelines;
+      namespace Flowthru.Flows;
 
-      public partial class PipelineBuilder
+      public partial class FlowBuilder
       {
       """
     );
@@ -64,22 +64,19 @@ public partial class PipelineBuilder
         }
 
         // Generate both async and sync versions
-        GenerateAddNodeOverload(sb, inputs, outputs, isAsync: true);
+        GenerateAddStepOverload(sb, inputs, outputs, isAsync: true);
         sb.AppendLine();
-        GenerateAddNodeOverload(sb, inputs, outputs, isAsync: false);
+        GenerateAddStepOverload(sb, inputs, outputs, isAsync: false);
         sb.AppendLine();
       }
     }
 
     sb.AppendLine("}");
 
-    context.AddSource(
-      "PipelineBuilder.Generated.cs",
-      SourceText.From(sb.ToString(), Encoding.UTF8)
-    );
+    context.AddSource("FlowBuilder.Generated.cs", SourceText.From(sb.ToString(), Encoding.UTF8));
   }
 
-  private static void GenerateAddNodeOverload(
+  private static void GenerateAddStepOverload(
     StringBuilder sb,
     int inputCount,
     int outputCount,
@@ -97,7 +94,7 @@ bool isAsync
 
     sb.AppendLine(
       $$"""
-        public PipelineBuilder AddNode<{{typeParams}}>(
+        public FlowBuilder AddStep<{{typeParams}}>(
           string label,
           {{funcSignature}} transform,
           {{inputParam}} input,
@@ -120,15 +117,15 @@ bool isAsync
 
     sb.AppendLine(
       $$"""
-          var pipelineNode = new PipelineNode(
+          var flowStep = new FlowStep(
             label: label,
             description: description,
-            node: transform,
-            inputs: new List<ICatalogEntry> { {{inputsList}} },
-            outputs: new List<ICatalogEntry> { {{outputsList}} }
+            step: transform,
+            inputs: new List<IItem> { {{inputsList}} },
+            outputs: new List<IItem> { {{outputsList}} }
           );
 
-          _pipeline.AddNode(pipelineNode);
+          _flow.AddStep(flowStep);
           return this;
         }
       """
@@ -146,7 +143,7 @@ bool isAsync
     sb.AppendLine(
       $"""
         /// <summary>
-        /// Adds a node with {inputCount} input{(
+        /// Adds a step with {inputCount} input{(
         inputCount == 1 ? "" : "s"
       )} and {outputCount} output{(outputCount == 1 ? "" : "s")}{asyncDesc}.
         /// </summary>
@@ -169,11 +166,11 @@ bool isAsync
       : "Synchronous transformation function";
     sb.AppendLine(
       $"""
-        /// <param name="label">Unique identifier for this node</param>
+        /// <param name="label">Unique identifier for this step</param>
         /// <param name="transform">{transformDesc}</param>
-        /// <param name="input">Catalog entry or tuple of catalog entries providing input data</param>
-        /// <param name="output">Catalog entry or tuple of catalog entries to store output data</param>
-        /// <param name="description">Optional description of the node's purpose</param>
+        /// <param name="input">Catalog item or tuple of catalog items providing input data</param>
+        /// <param name="output">Catalog item or tuple of catalog items to store output data</param>
+        /// <param name="description">Optional description of the step's purpose</param>
         /// <returns>This builder for method chaining</returns>
       """
     );
@@ -214,13 +211,10 @@ private static string GenerateInputParameter(int inputCount)
   {
     if (inputCount == 1)
     {
-      return "ICatalogEntry<TIn1>";
+      return "IItem<TIn1>";
     }
 
-    var types = string.Join(
-      ", ",
-      Enumerable.Range(1, inputCount).Select(i => $"ICatalogEntry<TIn{i}>")
-    );
+    var types = string.Join(", ", Enumerable.Range(1, inputCount).Select(i => $"IItem<TIn{i}>"));
     return $"({types})";
   }
 
@@ -228,13 +222,10 @@ private static string GenerateOutputParameter(int outputCount)
   {
     if (outputCount == 1)
     {
-      return "ICatalogEntry<TOut1>";
+      return "IItem<TOut1>";
     }
 
-    var types = string.Join(
-      ", ",
-      Enumerable.Range(1, outputCount).Select(i => $"ICatalogEntry<TOut{i}>")
-    );
+    var types = string.Join(", ", Enumerable.Range(1, outputCount).Select(i => $"IItem<TOut{i}>"));
     return $"({types})";
   }
 
diff --git a/src/extensions/Flowthru.Extensions.Csv/CsvCatalogEntryExtensions.cs b/src/extensions/Flowthru.Extensions.Csv/CsvCatalogEntryExtensions.cs
index 7daa144c..05e76ad5 100644
--- a/src/extensions/Flowthru.Extensions.Csv/CsvCatalogEntryExtensions.cs
+++ b/src/extensions/Flowthru.Extensions.Csv/CsvCatalogEntryExtensions.cs
@@ -7,15 +7,15 @@
 namespace Flowthru.Data;
 
 /// <summary>
-/// Extension methods that add CSV support to <see cref="CatalogEntries.Enumerable"/>.
+/// Extension methods that add CSV support to <see cref="ItemFactory.Enumerable"/>.
 /// </summary>
-public static class CsvCatalogEntryExtensions
+public static class CsvItemExtensions
 {
   /// <summary>
   /// Creates a CSV file catalog entry with IEnumerable container.
   /// </summary>
   /// <typeparam name="TRow">Row schema type (must be flat and text-serializable)</typeparam>
-  /// <param name="_">The enumerable catalog entries factory (from <see cref="CatalogEntries.Enumerable"/>)</param>
+  /// <param name="_">The enumerable catalog entries factory (from <see cref="ItemFactory.Enumerable"/>)</param>
   /// <param name="label">Unique catalog label for DAG resolution</param>
   /// <param name="filePath">Path to CSV file</param>
   /// <returns>Catalog entry with file + CSV + IEnumerable composition</returns>
@@ -35,8 +35,8 @@ public static class CsvCatalogEntryExtensions
   /// <item>All other traits use filesystem baseline defaults</item>
   /// </list>
   /// </remarks>
-  public static CatalogEntry<IEnumerable<TRow>> Csv<TRow>(
-    this EnumerableCatalogEntries _,
+  public static Item<IEnumerable<TRow>> Csv<TRow>(
+    this EnumerableItemFactory _,
     string label,
     string filePath
   )
@@ -47,7 +47,7 @@ string filePath
     var container = new EnumerableContainerAdapter<TRow>();
     var storage = new ComposedStorageAdapter<IEnumerable<TRow>, TRow>(medium, format, container);
 
-    return new CatalogEntry<IEnumerable<TRow>>(label, storage);
+    return new Item<IEnumerable<TRow>>(label, storage);
   }
 
   /// <summary>
@@ -55,7 +55,7 @@ string filePath
   /// concatenates them into a single <see cref="IEnumerable{TRow}"/>.
   /// </summary>
   /// <typeparam name="TRow">Row schema type (must be flat and text-serializable)</typeparam>
-  /// <param name="_">The enumerable catalog entries factory (from <see cref="CatalogEntries.Enumerable"/>)</param>
+  /// <param name="_">The enumerable catalog entries factory (from <see cref="ItemFactory.Enumerable"/>)</param>
   /// <param name="label">Unique catalog label for DAG resolution</param>
   /// <param name="directoryPath">Path to the directory containing the CSV files</param>
   /// <returns>Read-only catalog entry that concatenates every <c>*.csv</c> in the directory</returns>
@@ -64,16 +64,13 @@ string filePath
   /// This entry is <strong>read-only</strong> — attempting to save will fail with
   /// <see cref="NotSupportedException"/>.
   /// </remarks>
-  public static CatalogEntry<IEnumerable<TRow>> CsvDirectory<TRow>(
-    this EnumerableCatalogEntries _,
+  public static Item<IEnumerable<TRow>> CsvDirectory<TRow>(
+    this EnumerableItemFactory _,
     string label,
     string directoryPath
   )
     where TRow : notnull, IFlatSchema, ITextSerializable
   {
-    return new CatalogEntry<IEnumerable<TRow>>(
-      label,
-      new DirectoryCsvStorageAdapter<TRow>(directoryPath)
-    );
+    return new Item<IEnumerable<TRow>>(label, new DirectoryCsvStorageAdapter<TRow>(directoryPath));
   }
 }
diff --git a/src/extensions/Flowthru.Extensions.Csv/Data/Storage/Format/CsvFormatSerializer.cs b/src/extensions/Flowthru.Extensions.Csv/Data/Storage/Format/CsvFormatSerializer.cs
index 01216968..dffa576a 100644
--- a/src/extensions/Flowthru.Extensions.Csv/Data/Storage/Format/CsvFormatSerializer.cs
+++ b/src/extensions/Flowthru.Extensions.Csv/Data/Storage/Format/CsvFormatSerializer.cs
@@ -221,7 +221,7 @@ internal sealed class SerializedEnumCsvConverter<TEnum>
 
   public SerializedEnumCsvConverter()
   {
-    _metadata = Serialization.EnumMetadataRegistry.GetOrCreate<TEnum>();
+    _metadata = Serialization.EnumMetadataRegistry.Create<TEnum>();
   }
 
   public override object? ConvertFromString(
diff --git a/src/extensions/Flowthru.Extensions.Csv/Data/Storage/Strategies/CsvStorageEntryFactory.cs b/src/extensions/Flowthru.Extensions.Csv/Data/Storage/Strategies/CsvStorageEntryFactory.cs
index 3195aa4d..800b9e5b 100644
--- a/src/extensions/Flowthru.Extensions.Csv/Data/Storage/Strategies/CsvStorageEntryFactory.cs
+++ b/src/extensions/Flowthru.Extensions.Csv/Data/Storage/Strategies/CsvStorageEntryFactory.cs
@@ -52,22 +52,19 @@ public CsvStorageEntryFactory(string basePath)
   }
 
   /// <inheritdoc />
-  public ICatalogEntry<IEnumerable<T>> CreateEnumerable<T>(
-    string label,
-    StorageOptions? options = null
-  )
+  public IItem<IEnumerable<T>> CreateEnumerable<T>(string label, StorageOptions? options = null)
     where T : notnull, IFlatSchema, ITextSerializable
   {
     var path = ResolvePath(label, options, ".csv");
-    return CatalogEntries.Enumerable.Csv<T>(label, path);
+    return ItemFactory.Enumerable.Csv<T>(label, path);
   }
 
   /// <inheritdoc />
-  public ICatalogEntry<T> CreateSingle<T>(string label, StorageOptions? options = null)
+  public IItem<T> CreateSingle<T>(string label, StorageOptions? options = null)
     where T : IStructuredSerializable
   {
     var path = ResolvePath(label, options, ".json");
-    return CatalogEntries.Single.Json<T>(label, path);
+    return ItemFactory.Single.Json<T>(label, path);
   }
 
   private string ResolvePath(string label, StorageOptions? options, string defaultExtension)
diff --git a/src/extensions/Flowthru.Extensions.EFCore/Data/CatalogEntries.Enumerable.cs b/src/extensions/Flowthru.Extensions.EFCore/Data/CatalogEntries.Enumerable.cs
index 8c6c5cf5..982b8427 100644
--- a/src/extensions/Flowthru.Extensions.EFCore/Data/CatalogEntries.Enumerable.cs
+++ b/src/extensions/Flowthru.Extensions.EFCore/Data/CatalogEntries.Enumerable.cs
@@ -5,7 +5,7 @@
 
 namespace Flowthru.Extensions.EFCore.Data;
 
-public static partial class EFCoreCatalogEntries
+public static partial class EFCoreItemFactory
 {
   public static partial class Enumerable
   {
@@ -41,19 +41,19 @@ public static partial class Enumerable
     /// // In catalog
     /// public static partial class DataCatalog
     /// {
-    ///   public static ICatalogEntry&lt;IEnumerable&lt;Company&gt;&gt; Companies(DbContext db) =>
-    ///     CatalogEntries.Enumerable.EFCore&lt;Company&gt;("companies", db);
+    ///   public static IItem&lt;IEnumerable&lt;Company&gt;&gt; Companies(DbContext db) =>
+    ///     ItemFactory.Enumerable.EFCore&lt;Company&gt;("companies", db);
     /// }
     ///
     /// // In pipeline
-    /// var pipeline = new PipelineBuilder("CompanyPipeline")
-    ///   .AddNode("load_companies", catalog => new LoadCompaniesNode(
+    /// var pipeline = new FlowBuilder("CompanyPipeline")
+    ///   .AddStep("load_companies", catalog => new LoadCompaniesStep(
     ///     outputs: catalog.Companies(db)
     ///   ))
     ///   .Build();
     /// </code>
     /// </example>
-    public static CatalogEntry<IEnumerable<T>> EFCore<T>(
+    public static Item<IEnumerable<T>> EFCore<T>(
       string label,
       DbContext context,
       bool allowEmptyData = false,
@@ -63,7 +63,7 @@ public static CatalogEntry<IEnumerable<T>> EFCore<T>(
       where T : class
     {
       var storage = new EFCoreStorageAdapter<T>(context, allowEmptyData, queryCustomizer, saveFunc);
-      return new CatalogEntry<IEnumerable<T>>(label, storage);
+      return new Item<IEnumerable<T>>(label, storage);
     }
 
     /// <summary>
@@ -98,12 +98,12 @@ public static CatalogEntry<IEnumerable<T>> EFCore<T>(
     ///       .UseSqlServer(connectionString)
     ///       .Options);
     ///
-    ///   public static ICatalogEntry&lt;IEnumerable&lt;Company&gt;&gt; Companies() =>
-    ///     CatalogEntries.Enumerable.EFCore&lt;Company&gt;("companies", CreateDbContext);
+    ///   public static IItem&lt;IEnumerable&lt;Company&gt;&gt; Companies() =>
+    ///     ItemFactory.Enumerable.EFCore&lt;Company&gt;("companies", CreateDbContext);
     /// }
     /// </code>
     /// </example>
-    public static CatalogEntry<IEnumerable<T>> EFCore<T>(
+    public static Item<IEnumerable<T>> EFCore<T>(
       string label,
       Func<DbContext> contextFactory,
       bool allowEmptyData = false,
@@ -118,7 +118,7 @@ public static CatalogEntry<IEnumerable<T>> EFCore<T>(
         queryCustomizer,
         saveFunc
       );
-      return new CatalogEntry<IEnumerable<T>>(label, storage);
+      return new Item<IEnumerable<T>>(label, storage);
     }
 
     /// <summary>
@@ -135,7 +135,7 @@ public static CatalogEntry<IEnumerable<T>> EFCore<T>(
     /// <param name="saveFunc">Optional save delegate receiving the concrete <typeparamref name="TContext"/>.
     /// Defaults to RemoveRange + AddRange when null.</param>
     /// <returns>Catalog entry for EFCore database storage</returns>
-    public static CatalogEntry<IEnumerable<T>> EFCore<T, TContext>(
+    public static Item<IEnumerable<T>> EFCore<T, TContext>(
       string label,
       Func<TContext> contextFactory,
       bool allowEmptyData = false,
@@ -154,12 +154,12 @@ public static CatalogEntry<IEnumerable<T>> EFCore<T, TContext>(
         queryCustomizer,
         baseSaveFunc
       );
-      return new CatalogEntry<IEnumerable<T>>(label, storage);
+      return new Item<IEnumerable<T>>(label, storage);
     }
 
     /// <summary>
     /// Creates an EFCore catalog entry using <see cref="IDbContextFactory{TContext}"/> —
-    /// the idiomatic EFCore pattern for per-operation context isolation and concurrent node safety.
+    /// the idiomatic EFCore pattern for per-operation context isolation and concurrent step safety.
     /// </summary>
     /// <typeparam name="T">Entity type</typeparam>
     /// <typeparam name="TContext">Concrete DbContext type</typeparam>
@@ -170,7 +170,7 @@ public static CatalogEntry<IEnumerable<T>> EFCore<T, TContext>(
     /// <param name="saveFunc">Optional save delegate receiving the concrete <typeparamref name="TContext"/>.
     /// Defaults to RemoveRange + AddRange when null.</param>
     /// <returns>Catalog entry for EFCore database storage</returns>
-    public static CatalogEntry<IEnumerable<T>> EFCore<T, TContext>(
+    public static Item<IEnumerable<T>> EFCore<T, TContext>(
       string label,
       IDbContextFactory<TContext> contextFactory,
       bool allowEmptyData = false,
@@ -189,7 +189,7 @@ public static CatalogEntry<IEnumerable<T>> EFCore<T, TContext>(
         queryCustomizer,
         baseSaveFunc
       );
-      return new CatalogEntry<IEnumerable<T>>(label, storage);
+      return new Item<IEnumerable<T>>(label, storage);
     }
   }
 }
diff --git a/src/extensions/Flowthru.Extensions.EFCore/Data/CatalogEntries.Single.cs b/src/extensions/Flowthru.Extensions.EFCore/Data/CatalogEntries.Single.cs
index cb19eddd..fafac12c 100644
--- a/src/extensions/Flowthru.Extensions.EFCore/Data/CatalogEntries.Single.cs
+++ b/src/extensions/Flowthru.Extensions.EFCore/Data/CatalogEntries.Single.cs
@@ -5,7 +5,7 @@
 
 namespace Flowthru.Extensions.EFCore.Data;
 
-public static partial class EFCoreCatalogEntries
+public static partial class EFCoreItemFactory
 {
   public static partial class Single
   {
@@ -37,18 +37,18 @@ public static partial class Single
     /// <example>
     /// <code>
     /// // In catalog
-    /// public ICatalogEntry&lt;ModelMetrics&gt; Metrics(DbContext db) =>
-    ///   CatalogEntries.Single.EFCore&lt;ModelMetrics&gt;("metrics", db);
+    /// public IItem&lt;ModelMetrics&gt; Metrics(DbContext db) =>
+    ///   ItemFactory.Single.EFCore&lt;ModelMetrics&gt;("metrics", db);
     ///
     /// // In pipeline
-    /// var pipeline = new PipelineBuilder("MetricsPipeline")
-    ///   .AddNode("save_metrics", catalog => new SaveMetricsNode(
+    /// var pipeline = new FlowBuilder("MetricsPipeline")
+    ///   .AddStep("save_metrics", catalog => new SaveMetricsStep(
     ///     outputs: catalog.Metrics(db)
     ///   ))
     ///   .Build();
     /// </code>
     /// </example>
-    public static CatalogEntry<T> EFCore<T>(
+    public static Item<T> EFCore<T>(
       string label,
       DbContext context,
       bool allowEmptyData = false,
@@ -64,7 +64,7 @@ public static CatalogEntry<T> EFCore<T>(
         queryCustomizer,
         saveFunc
       );
-      return new CatalogEntry<T>(label, adapter);
+      return new Item<T>(label, adapter);
     }
 
     /// <summary>
@@ -93,14 +93,14 @@ public static CatalogEntry<T> EFCore<T>(
     /// // In catalog with factory
     /// private readonly IServiceProvider _serviceProvider;
     ///
-    /// public ICatalogEntry&lt;ModelMetrics&gt; Metrics =>
-    ///   CatalogEntries.Single.EFCore&lt;ModelMetrics&gt;(
+    /// public IItem&lt;ModelMetrics&gt; Metrics =>
+    ///   ItemFactory.Single.EFCore&lt;ModelMetrics&gt;(
     ///     "metrics",
     ///     () => _serviceProvider.GetRequiredService&lt;MyDbContext&gt;()
     ///   );
     /// </code>
     /// </example>
-    public static CatalogEntry<T> EFCore<T>(
+    public static Item<T> EFCore<T>(
       string label,
       Func<DbContext> contextFactory,
       bool allowEmptyData = false,
@@ -115,7 +115,7 @@ public static CatalogEntry<T> EFCore<T>(
         queryCustomizer,
         saveFunc
       );
-      return new CatalogEntry<T>(label, adapter);
+      return new Item<T>(label, adapter);
     }
 
     /// <summary>
@@ -132,7 +132,7 @@ public static CatalogEntry<T> EFCore<T>(
     /// <param name="saveFunc">Optional save delegate receiving the concrete <typeparamref name="TContext"/>.
     /// Defaults to clear-and-insert when null.</param>
     /// <returns>Catalog entry for EFCore single entity storage</returns>
-    public static CatalogEntry<T> EFCore<T, TContext>(
+    public static Item<T> EFCore<T, TContext>(
       string label,
       Func<TContext> contextFactory,
       bool allowEmptyData = false,
@@ -151,7 +151,7 @@ public static CatalogEntry<T> EFCore<T, TContext>(
         queryCustomizer,
         baseSaveFunc
       );
-      return new CatalogEntry<T>(label, adapter);
+      return new Item<T>(label, adapter);
     }
 
     /// <summary>
@@ -166,7 +166,7 @@ public static CatalogEntry<T> EFCore<T, TContext>(
     /// <param name="saveFunc">Optional save delegate receiving the concrete <typeparamref name="TContext"/>.
     /// Defaults to clear-and-insert when null.</param>
     /// <returns>Catalog entry for EFCore single entity storage</returns>
-    public static CatalogEntry<T> EFCore<T, TContext>(
+    public static Item<T> EFCore<T, TContext>(
       string label,
       IDbContextFactory<TContext> contextFactory,
       bool allowEmptyData = false,
@@ -185,7 +185,7 @@ public static CatalogEntry<T> EFCore<T, TContext>(
         queryCustomizer,
         baseSaveFunc
       );
-      return new CatalogEntry<T>(label, adapter);
+      return new Item<T>(label, adapter);
     }
   }
 }
diff --git a/src/extensions/Flowthru.Extensions.EFCore/Data/Storage/EFCoreSingleStorageAdapter.cs b/src/extensions/Flowthru.Extensions.EFCore/Data/Storage/EFCoreSingleStorageAdapter.cs
index 0fd28e14..fa72c71d 100644
--- a/src/extensions/Flowthru.Extensions.EFCore/Data/Storage/EFCoreSingleStorageAdapter.cs
+++ b/src/extensions/Flowthru.Extensions.EFCore/Data/Storage/EFCoreSingleStorageAdapter.cs
@@ -309,7 +309,7 @@ private DbContext GetContext()
   /// <summary>
   /// Validates that the entity type T is properly configured in the DbContext.
   /// Forces EF Core model building to catch configuration errors during catalog initialization
-  /// (pre-flight phase) rather than at runtime during node execution.
+  /// (pre-flight phase) rather than at runtime during step execution.
   /// </summary>
   /// <param name="context">DbContext to validate against</param>
   /// <exception cref="InvalidOperationException">
diff --git a/src/extensions/Flowthru.Extensions.EFCore/Data/Storage/EFCoreStorageAdapter.cs b/src/extensions/Flowthru.Extensions.EFCore/Data/Storage/EFCoreStorageAdapter.cs
index 0849d90a..e8cf839c 100644
--- a/src/extensions/Flowthru.Extensions.EFCore/Data/Storage/EFCoreStorageAdapter.cs
+++ b/src/extensions/Flowthru.Extensions.EFCore/Data/Storage/EFCoreStorageAdapter.cs
@@ -68,14 +68,14 @@ namespace Flowthru.Data.Storage;
 /// <code>
 /// // Injected DbContext (from DI container)
 /// var adapter = new EFCoreStorageAdapter&lt;Company&gt;(dbContext);
-/// var entry = new CatalogEntry&lt;IEnumerable&lt;Company&gt;&gt;("companies", adapter);
+/// var entry = new Item&lt;IEnumerable&lt;Company&gt;&gt;("companies", adapter);
 ///
 /// // Factory-based DbContext (created per operation)
 /// var adapter = new EFCoreStorageAdapter&lt;Company&gt;(() => new AppDbContext(options));
-/// var entry = new CatalogEntry&lt;IEnumerable&lt;Company&gt;&gt;("companies", adapter);
+/// var entry = new Item&lt;IEnumerable&lt;Company&gt;&gt;("companies", adapter);
 ///
 /// // Read-only mode (apply constraint at catalog level)
-/// var entry = new CatalogEntry&lt;IEnumerable&lt;Company&gt;&gt;("companies", adapter)
+/// var entry = new Item&lt;IEnumerable&lt;Company&gt;&gt;("companies", adapter)
 ///   .Constrain(traits => traits with { CanWrite = false });
 ///
 /// // Allow empty tables during validation
@@ -164,7 +164,7 @@ public EFCoreStorageAdapter(
   /// <summary>
   /// Validates that the entity type T is properly configured in the DbContext.
   /// Forces EF Core model building to catch configuration errors during catalog initialization
-  /// (pre-flight phase) rather than at runtime during node execution.
+  /// (pre-flight phase) rather than at runtime during step execution.
   /// </summary>
   /// <param name="context">DbContext to validate against</param>
   /// <exception cref="InvalidOperationException">
diff --git a/src/extensions/Flowthru.Extensions.EFCore/README.md b/src/extensions/Flowthru.Extensions.EFCore/README.md
index 33b524fc..ba94821e 100644
--- a/src/extensions/Flowthru.Extensions.EFCore/README.md
+++ b/src/extensions/Flowthru.Extensions.EFCore/README.md
@@ -45,9 +45,9 @@ public partial class Catalog : DataCatalogBase
         InitializeCatalogProperties();
     }
 
-    public ICatalogEntry<IEnumerable<Company>> Companies =>
+    public IItem<IEnumerable<Company>> Companies =>
         GetOrCreateEntry(() =>
-            EFCoreCatalogEntries.Enumerable.EFCore<Company, AppDbContext>(
+            EFCoreItems.Enumerable.EFCore<Company, AppDbContext>(
                 label: "Companies",
                 contextFactory: _contextFactory
             )
@@ -79,13 +79,13 @@ Use `EFCore<T, TContext>` to preserve the concrete context type all the way to s
 
 ```csharp
 // IDbContextFactory<TContext> overload — recommended for concurrent pipelines
-EFCoreCatalogEntries.Enumerable.EFCore<Company, AppDbContext>(
+EFCoreItems.Enumerable.EFCore<Company, AppDbContext>(
     label: "Companies",
     contextFactory: dbContextFactory   // IDbContextFactory<AppDbContext>
 )
 
 // Func<TContext> overload — useful when constructing contexts manually
-EFCoreCatalogEntries.Enumerable.EFCore<Company, AppDbContext>(
+EFCoreItems.Enumerable.EFCore<Company, AppDbContext>(
     label: "Companies",
     contextFactory: () => new AppDbContext(options)
 )
@@ -96,13 +96,13 @@ EFCoreCatalogEntries.Enumerable.EFCore<Company, AppDbContext>(
 The `queryCustomizer` parameter shapes the query before execution. Use it for navigation property includes, filtering, or ordering:
 
 ```csharp
-EFCoreCatalogEntries.Enumerable.EFCore<Person, AppDbContext>(
+EFCoreItems.Enumerable.EFCore<Person, AppDbContext>(
     label: "Persons",
     contextFactory: _contextFactory,
     queryCustomizer: q => q.Include(p => p.Address).AsNoTracking()
 )
 
-EFCoreCatalogEntries.Enumerable.EFCore<Shuttle, AppDbContext>(
+EFCoreItems.Enumerable.EFCore<Shuttle, AppDbContext>(
     label: "Shuttles",
     contextFactory: _contextFactory,
     queryCustomizer: q => q.OrderBy(s => s.Id)
@@ -114,7 +114,7 @@ EFCoreCatalogEntries.Enumerable.EFCore<Shuttle, AppDbContext>(
 Override the default `RemoveRange + AddRange` write strategy via `saveFunc`. The typed context is passed directly — no cast needed:
 
 ```csharp
-EFCoreCatalogEntries.Enumerable.EFCore<Company, AppDbContext>(
+EFCoreItems.Enumerable.EFCore<Company, AppDbContext>(
     label: "Companies",
     contextFactory: _contextFactory,
     saveFunc: async (ctx, data, ct) =>
@@ -142,7 +142,7 @@ saveFunc: async (ctx, data, ct) =>
 For tables that store exactly one row (trained models, configuration records, aggregated metrics):
 
 ```csharp
-EFCoreCatalogEntries.Single.EFCore<ModelMetrics, AppDbContext>(
+EFCoreItems.Single.EFCore<ModelMetrics, AppDbContext>(
     label: "ModelMetrics",
     contextFactory: _contextFactory
 )
@@ -155,7 +155,7 @@ The adapter validates "exactly one row" during pre-flight. Use `allowEmptyData:
 Use `.Constrain()` to prevent writes. The pipeline fails at build time — not at runtime — if a node attempts to write to a constrained entry:
 
 ```csharp
-EFCoreCatalogEntries.Enumerable.EFCore<SourceRecord, SourceDbContext>(
+EFCoreItems.Enumerable.EFCore<SourceRecord, SourceDbContext>(
     label: "SourceData",
     contextFactory: _sourceFactory)
 .Constrain(traits => traits with { CanWrite = false })
@@ -166,7 +166,7 @@ EFCoreCatalogEntries.Enumerable.EFCore<SourceRecord, SourceDbContext>(
 By default, an empty table fails pre-flight validation. Set `allowEmptyData: true` for tables that are legitimately empty on first run:
 
 ```csharp
-EFCoreCatalogEntries.Enumerable.EFCore<AuditEvent, AppDbContext>(
+EFCoreItems.Enumerable.EFCore<AuditEvent, AppDbContext>(
     label: "AuditEvents",
     contextFactory: _contextFactory,
     allowEmptyData: true
@@ -227,9 +227,9 @@ await db.Database.MigrateAsync();
 await pipeline.ExecuteAsync();
 
 // Option 2: Migration node in pipeline
-var pipeline = new PipelineBuilder("Setup")
-    .AddNode("migrate", catalog => new MigrationNode(db))
-    .AddNode("load_data", catalog => new LoadNode(...))
+var pipeline = new FlowBuilder("Setup")
+    .AddStep("migrate", catalog => new MigrationNode(db))
+    .AddStep("load_data", catalog => new LoadNode(...))
     .Build();
 ```
 
diff --git a/src/extensions/Flowthru.Extensions.EFCore/Tests/CompilationTest.cs b/src/extensions/Flowthru.Extensions.EFCore/Tests/CompilationTest.cs
index 6a1d9000..d91bf456 100644
--- a/src/extensions/Flowthru.Extensions.EFCore/Tests/CompilationTest.cs
+++ b/src/extensions/Flowthru.Extensions.EFCore/Tests/CompilationTest.cs
@@ -15,10 +15,10 @@ public void PartialClassExtensionWorks()
     DbContext? context = null;
 
     // Extension method from Flowthru.Extensions.EFCore
-    var entry = EFCoreCatalogEntries.Enumerable.EFCore<TestEntity>("test", context!);
+    var entry = EFCoreItemFactory.Enumerable.EFCore<TestEntity>("test", context!);
 
     // Verify it returns the correct type
-    var _ = entry as ICatalogEntry<IEnumerable<TestEntity>>;
+    var _ = entry as IItem<IEnumerable<TestEntity>>;
   }
 
   public void TypedContextFactoryOverloadsWork()
@@ -26,21 +26,21 @@ public void TypedContextFactoryOverloadsWork()
     Func<TestDbContext> typedFactory = () => null!;
 
     // Func<TContext> overload — no cast of DbContext in save delegate
-    var entryTypedFactory = EFCoreCatalogEntries.Enumerable.EFCore<TestEntity, TestDbContext>(
+    var entryTypedFactory = EFCoreItemFactory.Enumerable.EFCore<TestEntity, TestDbContext>(
       "test",
       typedFactory
     );
-    var _ = entryTypedFactory as ICatalogEntry<IEnumerable<TestEntity>>;
+    var _ = entryTypedFactory as IItem<IEnumerable<TestEntity>>;
 
     // Func<TContext> with typed save delegate — TContext flows to delegate, no cast needed
-    var entryWithSaveFunc = EFCoreCatalogEntries.Enumerable.EFCore<TestEntity, TestDbContext>(
+    var entryWithSaveFunc = EFCoreItemFactory.Enumerable.EFCore<TestEntity, TestDbContext>(
       "test",
       typedFactory,
       saveFunc: (db, data, ct) => Task.CompletedTask
     );
 
     // Func<TContext> with query customizer
-    var entryWithCustomizer = EFCoreCatalogEntries.Enumerable.EFCore<TestEntity, TestDbContext>(
+    var entryWithCustomizer = EFCoreItemFactory.Enumerable.EFCore<TestEntity, TestDbContext>(
       "test",
       typedFactory,
       queryCustomizer: q => q.Where(e => e.Id > 0)
@@ -52,14 +52,14 @@ public void DbContextFactoryOverloadsWork()
     IDbContextFactory<TestDbContext> factory = new TestDbContextFactory();
 
     // IDbContextFactory<TContext> overload — idiomatic EFCore concurrency pattern
-    var entryFactory = EFCoreCatalogEntries.Enumerable.EFCore<TestEntity, TestDbContext>(
+    var entryFactory = EFCoreItemFactory.Enumerable.EFCore<TestEntity, TestDbContext>(
       "test",
       factory
     );
-    var _ = entryFactory as ICatalogEntry<IEnumerable<TestEntity>>;
+    var _ = entryFactory as IItem<IEnumerable<TestEntity>>;
 
     // IDbContextFactory<TContext> with typed save delegate
-    var entryWithSaveFunc = EFCoreCatalogEntries.Enumerable.EFCore<TestEntity, TestDbContext>(
+    var entryWithSaveFunc = EFCoreItemFactory.Enumerable.EFCore<TestEntity, TestDbContext>(
       "test",
       factory,
       saveFunc: (db, data, ct) => Task.CompletedTask
@@ -72,18 +72,15 @@ public void SingleTypedContextOverloadsWork()
     IDbContextFactory<TestDbContext> factory = new TestDbContextFactory();
 
     // Single Func<TContext> with typed save delegate
-    var entryTyped = EFCoreCatalogEntries.Single.EFCore<TestEntity, TestDbContext>(
+    var entryTyped = EFCoreItemFactory.Single.EFCore<TestEntity, TestDbContext>(
       "test",
       typedFactory,
       saveFunc: (db, data, ct) => Task.CompletedTask
     );
-    var _ = entryTyped as ICatalogEntry<TestEntity>;
+    var _ = entryTyped as IItem<TestEntity>;
 
     // Single IDbContextFactory<TContext>
-    var entryFactory = EFCoreCatalogEntries.Single.EFCore<TestEntity, TestDbContext>(
-      "test",
-      factory
-    );
+    var entryFactory = EFCoreItemFactory.Single.EFCore<TestEntity, TestDbContext>("test", factory);
   }
 
   private class TestEntity
diff --git a/src/extensions/Flowthru.Extensions.Excel/ExcelCatalogEntryExtensions.cs b/src/extensions/Flowthru.Extensions.Excel/ExcelCatalogEntryExtensions.cs
index 44e0241a..01547118 100644
--- a/src/extensions/Flowthru.Extensions.Excel/ExcelCatalogEntryExtensions.cs
+++ b/src/extensions/Flowthru.Extensions.Excel/ExcelCatalogEntryExtensions.cs
@@ -7,15 +7,15 @@
 namespace Flowthru.Data;
 
 /// <summary>
-/// Extension methods that add Excel support to <see cref="CatalogEntries.Enumerable"/>.
+/// Extension methods that add Excel support to <see cref="ItemFactory.Enumerable"/>.
 /// </summary>
-public static class ExcelCatalogEntryExtensions
+public static class ExcelItemExtensions
 {
   /// <summary>
   /// Creates a read-only Excel file catalog entry with IEnumerable container.
   /// </summary>
   /// <typeparam name="TRow">Row schema type (must be flat and text-serializable)</typeparam>
-  /// <param name="_">The enumerable catalog entries factory (from <see cref="CatalogEntries.Enumerable"/>)</param>
+  /// <param name="_">The enumerable catalog entries factory (from <see cref="ItemFactory.Enumerable"/>)</param>
   /// <param name="label">Unique catalog label for DAG resolution</param>
   /// <param name="filePath">Path to Excel file (.xlsx)</param>
   /// <param name="sheetName">Name of the sheet to read</param>
@@ -39,8 +39,8 @@ public static class ExcelCatalogEntryExtensions
   /// <item>CanWrite: false (Excel adapter is read-only via ExcelDataReader)</item>
   /// </list>
   /// </remarks>
-  public static CatalogEntry<IEnumerable<TRow>> Excel<TRow>(
-    this EnumerableCatalogEntries _,
+  public static Item<IEnumerable<TRow>> Excel<TRow>(
+    this EnumerableItemFactory _,
     string label,
     string filePath,
     string sheetName
@@ -52,6 +52,6 @@ string sheetName
     var container = new EnumerableContainerAdapter<TRow>();
     var storage = new ComposedStorageAdapter<IEnumerable<TRow>, TRow>(medium, format, container);
 
-    return new CatalogEntry<IEnumerable<TRow>>(label, storage);
+    return new Item<IEnumerable<TRow>>(label, storage);
   }
 }
diff --git a/src/extensions/Flowthru.Extensions.MLNet/CatalogEntries.MLNet.cs b/src/extensions/Flowthru.Extensions.MLNet/CatalogEntries.MLNet.cs
index 7a95a216..239e73b0 100644
--- a/src/extensions/Flowthru.Extensions.MLNet/CatalogEntries.MLNet.cs
+++ b/src/extensions/Flowthru.Extensions.MLNet/CatalogEntries.MLNet.cs
@@ -8,7 +8,7 @@ namespace Flowthru.Extensions.MLNet;
 /// </summary>
 /// <remarks>
 /// <para>
-/// <strong>Discovery Pattern:</strong> Import this class alongside <see cref="CatalogEntries"/>
+/// <strong>Discovery Pattern:</strong> Import this class alongside <see cref="ItemFactory"/>
 /// for ML.NET-specific catalog entry factory methods.
 /// </para>
 /// <para>
@@ -24,15 +24,15 @@ namespace Flowthru.Extensions.MLNet;
 /// <code>
 /// using Flowthru.Data;
 /// using Flowthru.Extensions.MLNet;
-/// 
+///
 /// // Core entries
-/// var csvEntry = CatalogEntries.Enumerable.Csv&lt;MySchema&gt;("data", "data.csv");
-/// 
+/// var csvEntry = ItemFactory.Enumerable.Csv&lt;MySchema&gt;("data", "data.csv");
+///
 /// // MLNet entries
-/// var modelEntry = CatalogEntriesMLNet.OnnxModel("model", "model.onnx");
+/// var modelEntry = ItemFactoryMLNet.OnnxModel("model", "model.onnx");
 /// </code>
 /// </remarks>
-public static class CatalogEntriesMLNet
+public static class ItemFactoryMLNet
 {
   /// <summary>
   /// Creates a catalog entry for an ONNX model file.
@@ -42,14 +42,14 @@ public static class CatalogEntriesMLNet
   /// <returns>A catalog entry wrapping an ONNX model storage adapter</returns>
   /// <example>
   /// <code>
-  /// var entry = CatalogEntriesMLNet.OnnxModel(
+  /// var entry = ItemFactoryMLNet.OnnxModel(
   ///     label: "BertModel",
   ///     filePath: "models/bert-base.onnx"
   /// );
   /// </code>
   /// </example>
-  public static ICatalogEntry<byte[]> OnnxModel(string label, string filePath)
+  public static IItem<byte[]> OnnxModel(string label, string filePath)
   {
-    return new CatalogEntry<byte[]>(label, new OnnxModelStorageAdapter(filePath));
+    return new Item<byte[]>(label, new OnnxModelStorageAdapter(filePath));
   }
 }
diff --git a/src/extensions/Flowthru.Extensions.Parquet/ParquetCatalogEntryExtensions.cs b/src/extensions/Flowthru.Extensions.Parquet/ParquetCatalogEntryExtensions.cs
index b977dd4b..42391f7a 100644
--- a/src/extensions/Flowthru.Extensions.Parquet/ParquetCatalogEntryExtensions.cs
+++ b/src/extensions/Flowthru.Extensions.Parquet/ParquetCatalogEntryExtensions.cs
@@ -7,15 +7,15 @@
 namespace Flowthru.Data;
 
 /// <summary>
-/// Extension methods that add Parquet support to <see cref="CatalogEntries.Enumerable"/>.
+/// Extension methods that add Parquet support to <see cref="ItemFactory.Enumerable"/>.
 /// </summary>
-public static class ParquetCatalogEntryExtensions
+public static class ParquetItemExtensions
 {
   /// <summary>
   /// Creates a Parquet file catalog entry with IEnumerable container.
   /// </summary>
   /// <typeparam name="TRow">Row schema type (must be flat and binary-serializable)</typeparam>
-  /// <param name="_">The enumerable catalog entries factory (from <see cref="CatalogEntries.Enumerable"/>)</param>
+  /// <param name="_">The enumerable catalog entries factory (from <see cref="ItemFactory.Enumerable"/>)</param>
   /// <param name="label">Unique catalog label for DAG resolution</param>
   /// <param name="filePath">Path to Parquet file</param>
   /// <returns>Catalog entry with file + Parquet + IEnumerable composition</returns>
@@ -31,8 +31,8 @@ public static class ParquetCatalogEntryExtensions
   /// <strong>Performance:</strong> Optimized for large datasets with columnar storage.
   /// </para>
   /// </remarks>
-  public static CatalogEntry<IEnumerable<TRow>> Parquet<TRow>(
-    this EnumerableCatalogEntries _,
+  public static Item<IEnumerable<TRow>> Parquet<TRow>(
+    this EnumerableItemFactory _,
     string label,
     string filePath
   )
@@ -43,6 +43,6 @@ string filePath
     var container = new EnumerableContainerAdapter<TRow>();
     var storage = new ComposedStorageAdapter<IEnumerable<TRow>, TRow>(medium, format, container);
 
-    return new CatalogEntry<IEnumerable<TRow>>(label, storage);
+    return new Item<IEnumerable<TRow>>(label, storage);
   }
 }
diff --git a/src/extensions/Flowthru.Extensions.Python.SourceGenerators/PythonNodeFactoryGenerator.cs b/src/extensions/Flowthru.Extensions.Python.SourceGenerators/PythonNodeFactoryGenerator.cs
index 8421a2da..35109a5d 100644
--- a/src/extensions/Flowthru.Extensions.Python.SourceGenerators/PythonNodeFactoryGenerator.cs
+++ b/src/extensions/Flowthru.Extensions.Python.SourceGenerators/PythonNodeFactoryGenerator.cs
@@ -9,29 +9,34 @@
 namespace Flowthru.Extensions.Python.SourceGenerators;
 
 /// <summary>
-/// Generates strongly-typed factory methods from Python @node decorators.
+/// Generates strongly-typed factory methods from Python @step decorators.
 /// </summary>
 /// <remarks>
 /// <para>
-/// Discovers Python files with @node decorators at build time and generates
+/// Discovers Python files with @step decorators at build time and generates
 /// factory methods that return Func&lt;(inputs), (outputs)&gt; delegates for use
-/// with the standard AddNode pipeline builder interface.
+/// with the standard AddStep Flow builder interface.
 /// </para>
 /// <para>
-/// This moves Python node registration from runtime (stringly-typed module/function names)
+/// This moves Python step registration from runtime (stringly-typed module/function names)
 /// to build-time (strongly-typed factory methods with tuple signatures).
 /// </para>
 /// </remarks>
 [Generator]
-public class PythonNodeFactoryGenerator : IIncrementalGenerator
+public class PythonStepFactoryGenerator : IIncrementalGenerator
 {
+  /// <summary>
+  /// Initializes the source generator by registering a Flow that discovers Python steps
+  /// and generates factory methods for them.
+  /// </summary>
+  /// <param name="context">The incremental generator initialization context</param>
   public void Initialize(IncrementalGeneratorInitializationContext context)
   {
     // For debugging: always generate a diagnostic file to confirm generator is running
     context.RegisterPostInitializationOutput(ctx =>
     {
       ctx.AddSource(
-        "_PythonNodeFactoryGenerator.Diagnostic.g.cs",
+        "_PythonStepFactoryGenerator.Diagnostic.g.cs",
         SourceText.From("// Generator is running", Encoding.UTF8)
       );
     });
@@ -39,8 +44,8 @@ public void Initialize(IncrementalGeneratorInitializationContext context)
     // Find all Python files marked as AdditionalFiles
     var pythonFiles = context.AdditionalTextsProvider.Where(file => file.Path.EndsWith(".py"));
 
-    // Parse each Python file to extract @node decorators
-    var nodeDeclarations = pythonFiles
+    // Parse each Python file to extract @step decorators
+    var stepDeclarations = pythonFiles
       .Select(
         (file, ct) =>
         {
@@ -48,43 +53,43 @@ public void Initialize(IncrementalGeneratorInitializationContext context)
           if (content == null)
             return null;
 
-          return ParsePythonNode(file.Path, content);
+          return ParsePythonStep(file.Path, content);
         }
       )
-      .Where(node => node != null)
+      .Where(step => step != null)
       .Collect();
 
-    // Generate factory class from all discovered nodes
+    // Generate factory class from all discovered steps
     context.RegisterSourceOutput(
-      nodeDeclarations,
-      (ctx, nodes) =>
+      stepDeclarations,
+      (ctx, steps) =>
       {
-        if (nodes.Length == 0)
+        if (steps.Length == 0)
         {
-          // Add diagnostic output showing we got no nodes
+          // Add diagnostic output showing we got no steps
           ctx.AddSource(
-            "_PythonNodeFactoryGenerator.NoNodes.g.cs",
-            SourceText.From("// No Python nodes discovered", Encoding.UTF8)
+            "_PythonStepFactoryGenerator.NoSteps.g.cs",
+            SourceText.From("// No Python steps discovered", Encoding.UTF8)
           );
           return;
         }
 
-        var validNodes = nodes.Where(n => n != null).Select(n => n!).ToList();
-        if (validNodes.Count == 0)
+        var validSteps = steps.Where(n => n != null).Select(n => n!).ToList();
+        if (validSteps.Count == 0)
           return;
 
-        var source = GeneratePythonNodeFactories(validNodes);
-        ctx.AddSource("PythonNodes.g.cs", SourceText.From(source, Encoding.UTF8));
+        var source = GeneratePythonStepFactories(validSteps);
+        ctx.AddSource("PythonSteps.g.cs", SourceText.From(source, Encoding.UTF8));
       }
     );
   }
 
-  private static PythonNodeInfo? ParsePythonNode(string filePath, string content)
+  private static PythonStepInfo? ParsePythonStep(string filePath, string content)
   {
-    // Regex to match @node decorator with inputs/outputs
-    // Handles: @node(inputs=["Schema1", "Schema2"], outputs=["Schema3"])
+    // Regex to match @step decorator with inputs/outputs
+    // Handles: @step(inputs=["Schema1", "Schema2"], outputs=["Schema3"])
     var decoratorPattern =
-      @"@node\s*\(\s*inputs\s*=\s*\[([^\]]*)\]\s*,\s*outputs\s*=\s*(\[[^\]]*\]|None)\s*\)";
+      @"@step\s*\(\s*inputs\s*=\s*\[([^\]]*)\]\s*,\s*outputs\s*=\s*(\[[^\]]*\]|None)\s*\)";
     var functionPattern = @"def\s+(\w+)\s*\(";
 
     var decoratorMatch = Regex.Match(content, decoratorPattern);
@@ -107,10 +112,10 @@ public void Initialize(IncrementalGeneratorInitializationContext context)
     var outputs = outputsRaw == "None" ? new List<string>() : ParseSchemaList(outputsRaw);
 
     // Derive module path from file path
-    // e.g., Pipelines/DataScience/Nodes/split_data.py → Pipelines.DataScience.Nodes.split_data
+    // e.g., Flows/DataScience/Steps/split_data.py → Flows.DataScience.Steps.split_data
     var modulePath = DeriveModulePath(filePath);
 
-    return new PythonNodeInfo(
+    return new PythonStepInfo(
       functionName: functionName,
       modulePath: modulePath,
       inputs: inputs,
@@ -143,14 +148,14 @@ private static List<string> ParseSchemaList(string raw)
   private static string DeriveModulePath(string filePath)
   {
     // Extract the relative path from the project and convert to Python module notation
-    // Look for common markers like "Pipelines" or "Nodes"
+    // Look for common markers like "Flows" or "Steps"
     var parts = filePath.Replace('\\', '/').Split('/');
     var relevantParts = new List<string>();
     var startCapturing = false;
 
     foreach (var part in parts)
     {
-      if (part == "Pipelines" || startCapturing)
+      if (part == "Flows" || startCapturing)
       {
         startCapturing = true;
         if (part.EndsWith(".py"))
@@ -167,7 +172,7 @@ private static string DeriveModulePath(string filePath)
     return string.Join(".", relevantParts);
   }
 
-  private static string GeneratePythonNodeFactories(List<PythonNodeInfo> nodes)
+  private static string GeneratePythonStepFactories(List<PythonStepInfo> steps)
   {
     var sb = new StringBuilder();
 
@@ -177,19 +182,19 @@ private static string GeneratePythonNodeFactories(List<PythonNodeInfo> nodes)
     sb.AppendLine("using System;");
     sb.AppendLine("using System.Collections.Generic;");
     sb.AppendLine("using Flowthru.Extensions.Python.Execution;");
-    sb.AppendLine("using Flowthru.Extensions.Python.Nodes;");
+    sb.AppendLine("using Flowthru.Extensions.Python.Steps;");
     sb.AppendLine();
     sb.AppendLine("namespace Flowthru.Extensions.Python.Generated;");
     sb.AppendLine();
     sb.AppendLine("/// <summary>");
-    sb.AppendLine("/// Strongly-typed factory methods for Python nodes discovered at build time.");
+    sb.AppendLine("/// Strongly-typed factory methods for Python steps discovered at build time.");
     sb.AppendLine("/// </summary>");
-    sb.AppendLine("public static class PythonNodes");
+    sb.AppendLine("public static class PythonSteps");
     sb.AppendLine("{");
 
-    foreach (var node in nodes)
+    foreach (var step in steps)
     {
-      GenerateFactoryMethod(sb, node);
+      GenerateFactoryMethod(sb, step);
       sb.AppendLine();
     }
 
@@ -198,11 +203,11 @@ private static string GeneratePythonNodeFactories(List<PythonNodeInfo> nodes)
     return sb.ToString();
   }
 
-  private static void GenerateFactoryMethod(StringBuilder sb, PythonNodeInfo node)
+  private static void GenerateFactoryMethod(StringBuilder sb, PythonStepInfo step)
   {
     // Generate type parameters
-    var inputTypes = node.Inputs.Select(MapSchemaToType).ToList();
-    var outputTypes = node.Outputs.Select(MapSchemaToType).ToList();
+    var inputTypes = step.Inputs.Select(MapSchemaToType).ToList();
+    var outputTypes = step.Outputs.Select(MapSchemaToType).ToList();
 
     // Determine input/output tuple structures
     var inputTupleType = inputTypes.Count switch
@@ -221,27 +226,27 @@ private static void GenerateFactoryMethod(StringBuilder sb, PythonNodeInfo node)
 
     // Generate XML documentation
     sb.AppendLine($"  /// <summary>");
-    sb.AppendLine($"  /// Creates a Python node for {node.FunctionName}.");
+    sb.AppendLine($"  /// Creates a Python step for {step.FunctionName}.");
     sb.AppendLine($"  /// </summary>");
     sb.AppendLine($"  /// <param name=\"executor\">Python executor instance.</param>");
     sb.AppendLine($"  /// <returns>");
     sb.AppendLine(
-      $"  /// A function that invokes the Python node with the specified inputs and outputs."
+      $"  /// A function that invokes the Python step with the specified inputs and outputs."
     );
     sb.AppendLine($"  /// </returns>");
 
     // Generate method signature
-    var methodName = ToPascalCase(node.FunctionName);
+    var methodName = ToPascalCase(step.FunctionName);
     sb.AppendLine($"  public static Func<{inputTupleType}, {outputTupleType}> {methodName}(");
     sb.AppendLine($"    IPythonExecutor executor");
     sb.AppendLine($"  )");
     sb.AppendLine("  {");
 
     // Create wrapper
-    sb.AppendLine($"    var wrapper = new PythonNodeWrapper<{inputTupleType}, {outputTupleType}>(");
+    sb.AppendLine($"    var wrapper = new PythonStepWrapper<{inputTupleType}, {outputTupleType}>(");
     sb.AppendLine($"      executor,");
-    sb.AppendLine($"      module: \"{node.ModulePath}\",");
-    sb.AppendLine($"      function: \"{node.FunctionName}\"");
+    sb.AppendLine($"      module: \"{step.ModulePath}\",");
+    sb.AppendLine($"      function: \"{step.FunctionName}\"");
     sb.AppendLine($"    );");
     sb.AppendLine();
     sb.AppendLine($"    return wrapper.GetTransform();");
@@ -272,16 +277,16 @@ private static string ToPascalCase(string snakeCase)
 }
 
 /// <summary>
-/// Information about a Python node parsed from source.
+/// Information about a Python step parsed from source.
 /// </summary>
-internal class PythonNodeInfo
+internal class PythonStepInfo
 {
   public string FunctionName { get; }
   public string ModulePath { get; }
   public List<string> Inputs { get; }
   public List<string> Outputs { get; }
 
-  public PythonNodeInfo(
+  public PythonStepInfo(
     string functionName,
     string modulePath,
     List<string> inputs,
diff --git a/src/extensions/Flowthru.Extensions.Python.SourceGenerators/PythonNodeGenerator.cs b/src/extensions/Flowthru.Extensions.Python.SourceGenerators/PythonNodeGenerator.cs
index 121da7b4..f1fe26ac 100644
--- a/src/extensions/Flowthru.Extensions.Python.SourceGenerators/PythonNodeGenerator.cs
+++ b/src/extensions/Flowthru.Extensions.Python.SourceGenerators/PythonNodeGenerator.cs
@@ -7,20 +7,20 @@
 namespace Flowthru.Extensions.Python.SourceGenerators;
 
 /// <summary>
-/// Generates AddPythonNode overloads for PipelineBuilder supporting up to 8 inputs and 8 outputs.
+/// Generates AddPythonStep overloads for FlowBuilder supporting up to 8 inputs and 8 outputs.
 /// </summary>
 /// <remarks>
 /// <para>
 /// <strong>Phase 5 implementation:</strong>
-/// Mirrors PipelineBuilderGenerator's combinatorial approach but for Python nodes.
-/// Each overload accepts executor and runtime parameters and delegates to PythonNodeWrapper.
+/// Mirrors FlowBuilderGenerator's combinatorial approach but for Python steps.
+/// Each overload accepts executor and runtime parameters and delegates to PythonStepWrapper.
 /// </para>
 /// <para>
 /// Sync-only in Phase 5 — async support deferred to Phase 6.
 /// </para>
 /// </remarks>
 [Generator]
-public class PythonNodeGenerator : IIncrementalGenerator
+public class PythonStepGenerator : IIncrementalGenerator
 {
   private const int MaxInputs = 8;
   private const int MaxOutputs = 8;
@@ -28,11 +28,11 @@ public class PythonNodeGenerator : IIncrementalGenerator
   public void Initialize(IncrementalGeneratorInitializationContext context)
   {
     // Run for any project that references Flowthru.Extensions.Python
-    // (unlike PipelineBuilderGenerator which only runs for the core Flowthru assembly)
-    context.RegisterPostInitializationOutput(ctx => GenerateAddPythonNode(ctx));
+    // (unlike FlowBuilderGenerator which only runs for the core Flowthru assembly)
+    context.RegisterPostInitializationOutput(ctx => GenerateAddPythonStep(ctx));
   }
 
-  private static void GenerateAddPythonNode(IncrementalGeneratorPostInitializationContext context)
+  private static void GenerateAddPythonStep(IncrementalGeneratorPostInitializationContext context)
   {
     var sb = new StringBuilder();
 
@@ -44,13 +44,13 @@ private static void GenerateAddPythonNode(IncrementalGeneratorPostInitialization
 
       using Flowthru.Data;
       using Flowthru.Extensions.Python.Execution;
-      using Flowthru.Extensions.Python.Nodes;
+      using Flowthru.Extensions.Python.Steps;
       using Flowthru.Extensions.Python.Runtime;
-      using Flowthru.Pipelines;
+      using Flowthru.Flows;
 
-      namespace Flowthru.Extensions.Python.Nodes;
+      namespace Flowthru.Extensions.Python.Steps;
 
-      public static partial class PythonNodeFactory
+      public static partial class PythonStepFactory
       {
       """
     );
@@ -67,7 +67,7 @@ public static partial class PythonNodeFactory
         }
 
         // Generate sync version only (Phase 5)
-        GenerateAddPythonNode(sb, inputs, outputs);
+        GenerateAddPythonStep(sb, inputs, outputs);
         sb.AppendLine();
       }
     }
@@ -75,12 +75,12 @@ public static partial class PythonNodeFactory
     sb.AppendLine("}");
 
     context.AddSource(
-      "PythonNodeFactory.Generated.cs",
+      "PythonStepFactory.Generated.cs",
       SourceText.From(sb.ToString(), Encoding.UTF8)
     );
   }
 
-  private static void GenerateAddPythonNode(StringBuilder sb, int inputCount, int outputCount)
+  private static void GenerateAddPythonStep(StringBuilder sb, int inputCount, int outputCount)
   {
     // Generate XML documentation
     GenerateXmlDoc(sb, inputCount, outputCount);
@@ -96,8 +96,8 @@ private static void GenerateAddPythonNode(StringBuilder sb, int inputCount, int
 
     sb.AppendLine(
       $$"""
-        public static PipelineBuilder AddPythonNode<{{typeParams}}>(
-          this PipelineBuilder builder,
+        public static FlowBuilder AddPythonStep<{{typeParams}}>(
+          this FlowBuilder builder,
           string label,
           string module,
           string function,
@@ -116,7 +116,7 @@ private static void GenerateAddPythonNode(StringBuilder sb, int inputCount, int
     // Generate output deconstruction if needed
     GenerateOutputDeconstruction(sb, outputCount);
 
-    // Generate inputs and outputs lists for AddNode
+    // Generate inputs and outputs lists for AddStep
     var inputsList = GenerateInputsList(inputCount);
     var outputsList = GenerateOutputsList(outputCount);
 
@@ -154,11 +154,11 @@ private static void GenerateAddPythonNode(StringBuilder sb, int inputCount, int
     // Create wrapper with tuple types
     sb.AppendLine(
       $$"""
-          var wrapper = new PythonNodeWrapper<{{inputTupleType}}, {{outputTupleType}}>(executor, module, function);
-          executor.ValidateNode(module, function);
+          var wrapper = new PythonStepWrapper<{{inputTupleType}}, {{outputTupleType}}>(executor, module, function);
+          executor.ValidateStep(module, function);
 
-          // Delegate to existing AddNode infrastructure
-          return builder.AddNode(
+          // Delegate to existing AddStep infrastructure
+          return builder.AddStep(
             label: label,
             transform: wrapper.GetTransform(),
             input: input,
@@ -175,7 +175,7 @@ private static void GenerateXmlDoc(StringBuilder sb, int inputCount, int outputC
     sb.AppendLine(
       $"""
         /// <summary>
-        /// Adds a Python node with {inputCount} input{(
+        /// Adds a Python step with {inputCount} input{(
         inputCount == 1 ? "" : "s"
       )} and {outputCount} output{(outputCount == 1 ? "" : "s")}.
         /// </summary>
@@ -195,14 +195,14 @@ private static void GenerateXmlDoc(StringBuilder sb, int inputCount, int outputC
     // Parameter documentation
     sb.AppendLine(
       """
-        /// <param name="builder">Pipeline builder instance</param>
-        /// <param name="label">Unique identifier for this node</param>
-        /// <param name="module">Dotted Python module name (e.g., "Pipelines.DataScience.train_model")</param>
+        /// <param name="builder">Flow builder instance</param>
+        /// <param name="label">Unique identifier for this step</param>
+        /// <param name="module">Dotted Python module name (e.g., "Flows.DataScience.train_model")</param>
         /// <param name="function">Python function name within the module</param>
-        /// <param name="input">Catalog entry or tuple of catalog entries providing input data</param>
-        /// <param name="output">Catalog entry or tuple of catalog entries to store output data</param>
+        /// <param name="input">Catalog item or tuple of catalog items providing input data</param>
+        /// <param name="output">Catalog item or tuple of catalog items to store output data</param>
         /// <param name="executor">Python executor for invoking the function</param>
-        /// <param name="description">Optional node description</param>
+        /// <param name="description">Optional step description</param>
         /// <returns>This builder for method chaining</returns>
       """
     );
@@ -228,13 +228,10 @@ private static string GenerateInputParameter(int inputCount)
   {
     if (inputCount == 1)
     {
-      return "ICatalogEntry<TIn1>";
+      return "IItem<TIn1>";
     }
 
-    var types = string.Join(
-      ", ",
-      Enumerable.Range(1, inputCount).Select(i => $"ICatalogEntry<TIn{i}>")
-    );
+    var types = string.Join(", ", Enumerable.Range(1, inputCount).Select(i => $"IItem<TIn{i}>"));
     return $"({types})";
   }
 
@@ -242,13 +239,10 @@ private static string GenerateOutputParameter(int outputCount)
   {
     if (outputCount == 1)
     {
-      return "ICatalogEntry<TOut1>";
+      return "IItem<TOut1>";
     }
 
-    var types = string.Join(
-      ", ",
-      Enumerable.Range(1, outputCount).Select(i => $"ICatalogEntry<TOut{i}>")
-    );
+    var types = string.Join(", ", Enumerable.Range(1, outputCount).Select(i => $"IItem<TOut{i}>"));
     return $"({types})";
   }
 
diff --git a/src/extensions/Flowthru.Extensions.Python/Execution/IPythonExecutor.cs b/src/extensions/Flowthru.Extensions.Python/Execution/IPythonExecutor.cs
index 83724f59..2ca34e2f 100644
--- a/src/extensions/Flowthru.Extensions.Python/Execution/IPythonExecutor.cs
+++ b/src/extensions/Flowthru.Extensions.Python/Execution/IPythonExecutor.cs
@@ -5,7 +5,7 @@ namespace Flowthru.Extensions.Python.Execution;
 /// </summary>
 /// <remarks>
 /// <para>
-/// Decouples the execution strategy from Python node wiring.
+/// Decouples the execution strategy from Python step wiring.
 /// Two implementations ship out of the box:
 /// <list type="bullet">
 /// <item><see cref="PythonNetExecutor"/> — in-process via Python.NET (opt-in)</item>
@@ -41,7 +41,7 @@ public interface IPythonExecutor
   /// C# output type. Same range as <typeparamref name="TInput"/>.
   /// </typeparam>
   /// <param name="moduleName">
-  /// Dotted module name (e.g., <c>"Pipelines.DataScience.train_model"</c>).
+  /// Dotted module name (e.g., <c>"Flows.DataScience.train_model"</c>).
   /// Must be resolvable via the executor's configured <c>sys.path</c>.
   /// </param>
   /// <param name="functionName">Python function name within the module.</param>
@@ -54,13 +54,13 @@ public interface IPythonExecutor
   TOutput Invoke<TInput, TOutput>(string moduleName, string functionName, TInput input);
 
   /// <summary>
-  /// Validates that a Python node exists and satisfies Flowthru's <c>@node</c> contract.
+  /// Validates that a Python step exists and satisfies Flowthru's <c>@step</c> contract.
   /// </summary>
   /// <param name="moduleName">Dotted Python module name.</param>
   /// <param name="functionName">Python function name within the module.</param>
   /// <exception cref="InvalidOperationException">
   /// Thrown if the module is not importable, the function is missing, or the
-  /// <c>@node</c> decorator is absent.
+  /// <c>@step</c> decorator is absent.
   /// </exception>
-  void ValidateNode(string moduleName, string functionName);
+  void ValidateStep(string moduleName, string functionName);
 }
diff --git a/src/extensions/Flowthru.Extensions.Python/Execution/PythonNetExecutor.cs b/src/extensions/Flowthru.Extensions.Python/Execution/PythonNetExecutor.cs
index c1e836d0..bf632ed8 100644
--- a/src/extensions/Flowthru.Extensions.Python/Execution/PythonNetExecutor.cs
+++ b/src/extensions/Flowthru.Extensions.Python/Execution/PythonNetExecutor.cs
@@ -97,10 +97,10 @@ public TOutput Invoke<TInput, TOutput>(string moduleName, string functionName, T
   }
 
   /// <inheritdoc />
-  public void ValidateNode(string moduleName, string functionName)
+  public void ValidateStep(string moduleName, string functionName)
   {
     _runtime.Initialize();
-    PythonNodeRegistrationValidator.ValidateRegistration(_runtime, moduleName, functionName);
+    PythonStepRegistrationValidator.ValidateRegistration(_runtime, moduleName, functionName);
   }
 
   // ── Scalar path ──────────────────────────────────────────────────────────────────────
diff --git a/src/extensions/Flowthru.Extensions.Python/Execution/SubprocessPythonExecutor.cs b/src/extensions/Flowthru.Extensions.Python/Execution/SubprocessPythonExecutor.cs
index 3c439564..bc855a67 100644
--- a/src/extensions/Flowthru.Extensions.Python/Execution/SubprocessPythonExecutor.cs
+++ b/src/extensions/Flowthru.Extensions.Python/Execution/SubprocessPythonExecutor.cs
@@ -94,7 +94,7 @@ public TOutput Invoke<TInput, TOutput>(string moduleName, string functionName, T
   }
 
   /// <inheritdoc />
-  public void ValidateNode(string moduleName, string functionName)
+  public void ValidateStep(string moduleName, string functionName)
   {
     EnsureStarted();
 
@@ -111,7 +111,7 @@ public void ValidateNode(string moduleName, string functionName)
     {
       var msg = resp["message"]?.GetValue<string>() ?? "Unknown error";
       throw new InvalidOperationException(
-        $"Python node validation failed for {moduleName}.{functionName}: {msg}"
+        $"Python step validation failed for {moduleName}.{functionName}: {msg}"
       );
     }
   }
diff --git a/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.csproj b/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.csproj
index e2fecd1e..8fa9e6b6 100644
--- a/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.csproj
+++ b/src/extensions/Flowthru.Extensions.Python/Flowthru.Extensions.Python.csproj
@@ -55,15 +55,15 @@
              Pack="true"
              PackagePath="build\" />
     
-    <!-- Include flowthru Python package (Phase 4: @node decorator) -->
+    <!-- Include flowthru Python package -->
     <Content Include="build\flowthru\__init__.py" 
              CopyToOutputDirectory="PreserveNewest" 
              Link="flowthru\__init__.py"
              Pack="true" 
              PackagePath="build\flowthru\" />
-    <Content Include="build\flowthru\node.py" 
+    <Content Include="build\flowthru\step.py" 
              CopyToOutputDirectory="PreserveNewest" 
-             Link="flowthru\node.py"
+             Link="flowthru\step.py"
              Pack="true" 
              PackagePath="build\flowthru\" />
   </ItemGroup>
diff --git a/src/extensions/Flowthru.Extensions.Python/README.md b/src/extensions/Flowthru.Extensions.Python/README.md
index adc5e01a..0d1bfa96 100644
--- a/src/extensions/Flowthru.Extensions.Python/README.md
+++ b/src/extensions/Flowthru.Extensions.Python/README.md
@@ -19,13 +19,13 @@ dotnet add package Flowthru.Extensions.Python
 services.AddFlowthru(flowthru =>
 {
     flowthru
-        .UseCatalog<MyCatalog>()
+        .RegisterCatalog<MyCatalog>()
         .UsePython(python =>
         {
             python.VenvPath = ".venv";
             python.ModuleSearchPaths.Add("Pipelines");
         })
-        .UsePipelines(catalog => new Dictionary<string, Pipeline>
+        .RegisterPipelines(catalog => new Dictionary<string, Pipeline>
         {
             ["my_pipeline"] = MyPipeline.Create(catalog)
         });
diff --git a/src/extensions/Flowthru.Extensions.Python/Runtime/PythonRuntimeOptions.cs b/src/extensions/Flowthru.Extensions.Python/Runtime/PythonRuntimeOptions.cs
index 685160a7..fcb78021 100644
--- a/src/extensions/Flowthru.Extensions.Python/Runtime/PythonRuntimeOptions.cs
+++ b/src/extensions/Flowthru.Extensions.Python/Runtime/PythonRuntimeOptions.cs
@@ -1,19 +1,21 @@
+using System.Collections.Concurrent;
+
 namespace Flowthru.Extensions.Python.Runtime;
 
 /// <summary>
-/// Controls how Python node execution is isolated between FlowthruService instances.
+/// Controls how Python step execution is isolated between FlowthruService instances.
 /// </summary>
 public enum PythonExecutionMode
 {
   /// <summary>
-  /// Executes Python nodes in the same process via Python.NET.
+  /// Executes Python steps in the same process via Python.NET.
   /// Fast (no IPC overhead), but all services share one Python interpreter,
-  /// <c>sys.modules</c>, and GIL. Use when co-hosted pipelines are known to be compatible.
+  /// <c>sys.modules</c>, and GIL. Use when co-hosted flows are known to be compatible.
   /// </summary>
   InProcess,
 
   /// <summary>
-  /// Executes Python nodes in an isolated child process per FlowthruService.
+  /// Executes Python steps in an isolated child process per FlowthruService.
   /// Each service gets its own Python interpreter, venv, <c>sys.path</c>, and module cache.
   /// Default for multi-service scenarios.
   /// </summary>
@@ -104,7 +106,7 @@ public sealed class PythonRuntimeOptions
   public string UvPath { get; set; } = "uv";
 
   /// <summary>
-  /// Controls whether Python nodes run in the same process or an isolated child process.
+  /// Controls whether Python steps run in the same process or an isolated child process.
   /// Defaults to <see cref="PythonExecutionMode.Subprocess"/> for per-service isolation.
   /// Set to <see cref="PythonExecutionMode.InProcess"/> to opt in to shared-interpreter mode.
   /// </summary>
@@ -122,8 +124,8 @@ public sealed class PythonRuntimeOptions
   /// </list>
   /// </para>
   /// <para>
-  /// Python nodes at <c>Pipelines/DataScience/Nodes/train_model.py</c> are referenced as
-  /// <c>"Pipelines.DataScience.Nodes.train_model"</c> when the project root is in <c>sys.path</c>.
+  /// Python steps at <c>Flows/DataScience/Steps/train_model.py</c> are referenced as
+  /// <c>"Flows.DataScience.Steps.train_model"</c> when the project root is in <c>sys.path</c>.
   /// </para>
   /// </remarks>
   public List<string> ModuleSearchPaths { get; set; } = new();
@@ -267,12 +269,20 @@ public string GetResolvedPythonDll()
   /// </remarks>
   public string GetResolvedPythonExe()
   {
-    // 1. Explicit VenvPath
+    // 1. Explicit VenvPath — try as existing .venv, then as project dir for uv sync
     if (!string.IsNullOrWhiteSpace(VenvPath))
     {
       var exe = FindPythonExeInVenv(VenvPath);
       if (exe != null)
         return exe;
+
+      var uvVenvPath = EnsureVenvViaUv(VenvPath);
+      if (uvVenvPath != null)
+      {
+        exe = FindPythonExeInVenv(uvVenvPath);
+        if (exe != null)
+          return exe;
+      }
     }
 
     // 2. Auto-init .venv via uv sync in output directory (same trigger as GetResolvedPythonDll)
@@ -424,6 +434,10 @@ public List<string> GetResolvedModuleSearchPaths()
   /// Returns the <c>.venv/</c> path if successful, or <c>null</c> if files are missing or sync fails.
   /// </para>
   /// </remarks>
+  // One semaphore per directory prevents concurrent uv sync calls from racing on the same .venv.
+  private static readonly ConcurrentDictionary<string, SemaphoreSlim> _uvSyncLocks =
+    new(StringComparer.OrdinalIgnoreCase);
+
   private string? EnsureVenvViaUv(string directory)
   {
     var pyprojectPath = Path.Combine(directory, "pyproject.toml");
@@ -437,59 +451,81 @@ public List<string> GetResolvedModuleSearchPaths()
       return null; // Not a uv-managed project
     }
 
-    // If .venv exists but lacks pyvenv.cfg, it's corrupt — delete and recreate
-    if (Directory.Exists(venvPath))
+    // Fast path: venv already exists and is valid — no lock needed.
+    if (File.Exists(pyvenvCfg))
     {
-      try
-      {
-        Directory.Delete(venvPath, recursive: true);
-      }
-      catch
-      {
-        // Deletion failed (permissions, locked files, etc.) — let uv sync handle it
-      }
+      return venvPath;
     }
 
-    // Run uv sync to materialize .venv
+    // Slow path: venv is missing or corrupt. One caller creates it; others wait and reuse.
+    var semaphore = _uvSyncLocks.GetOrAdd(directory, _ => new SemaphoreSlim(1, 1));
+    semaphore.Wait();
     try
     {
-      var startInfo = new System.Diagnostics.ProcessStartInfo
+      // Re-check under the lock — another thread may have created it while we were waiting.
+      if (File.Exists(pyvenvCfg))
       {
-        FileName = UvPath,
-        Arguments = "sync --frozen --python-preference only-managed",
-        WorkingDirectory = directory,
-        UseShellExecute = false,
-        RedirectStandardOutput = true,
-        RedirectStandardError = true,
-        CreateNoWindow = true,
-      };
-
-      using var process = System.Diagnostics.Process.Start(startInfo);
-      if (process == null)
-      {
-        return null; // Failed to start process
+        return venvPath;
       }
 
-      process.WaitForExit();
-
-      // Check if .venv was created successfully
-      if (process.ExitCode == 0 && File.Exists(pyvenvCfg))
+      // If .venv exists but lacks pyvenv.cfg, it's corrupt — delete and recreate
+      if (Directory.Exists(venvPath))
       {
-        return venvPath;
+        try
+        {
+          Directory.Delete(venvPath, recursive: true);
+        }
+        catch
+        {
+          // Deletion failed (permissions, locked files, etc.) — let uv sync handle it
+        }
       }
 
-      // Sync failed — log stderr if available for diagnostics
-      var stderr = process.StandardError.ReadToEnd();
-      if (!string.IsNullOrWhiteSpace(stderr))
+      // Run uv sync to materialize .venv
+      try
+      {
+        var startInfo = new System.Diagnostics.ProcessStartInfo
+        {
+          FileName = UvPath,
+          Arguments = "sync --frozen --python-preference only-managed",
+          WorkingDirectory = directory,
+          UseShellExecute = false,
+          RedirectStandardOutput = true,
+          RedirectStandardError = true,
+          CreateNoWindow = true,
+        };
+
+        using var process = System.Diagnostics.Process.Start(startInfo);
+        if (process == null)
+        {
+          return null; // Failed to start process
+        }
+
+        process.WaitForExit();
+
+        // Check if .venv was created successfully
+        if (process.ExitCode == 0 && File.Exists(pyvenvCfg))
+        {
+          return venvPath;
+        }
+
+        // Sync failed — log stderr if available for diagnostics
+        var stderr = process.StandardError.ReadToEnd();
+        if (!string.IsNullOrWhiteSpace(stderr))
+        {
+          Console.Error.WriteLine($"uv sync failed: {stderr}");
+        }
+        return null;
+      }
+      catch
       {
-        Console.Error.WriteLine($"uv sync failed: {stderr}");
+        // uv not found, permission denied, etc. — fall through to other resolution methods
+        return null;
       }
-      return null;
     }
-    catch
+    finally
     {
-      // uv not found, permission denied, etc. — fall through to other resolution methods
-      return null;
+      semaphore.Release();
     }
   }
 }
diff --git a/src/extensions/Flowthru.Extensions.Python/Services/FlowthruServiceBuilderExtensions.cs b/src/extensions/Flowthru.Extensions.Python/Services/FlowthruServiceBuilderExtensions.cs
index dd8ff5c2..4eabd207 100644
--- a/src/extensions/Flowthru.Extensions.Python/Services/FlowthruServiceBuilderExtensions.cs
+++ b/src/extensions/Flowthru.Extensions.Python/Services/FlowthruServiceBuilderExtensions.cs
@@ -31,7 +31,7 @@ public static class FlowthruServiceBuilderExtensions
   /// services.AddFlowthru(flowthru =>
   /// {
   ///     flowthru
-  ///         .UseCatalog&lt;MyCatalog&gt;()
+  ///         .RegisterCatalog&lt;MyCatalog&gt;()
   ///         .UsePython();  // Auto-detects .venv/, project root, etc.
   /// });
   /// </code>
@@ -64,12 +64,12 @@ public static FlowthruServiceBuilder UsePython(this FlowthruServiceBuilder build
   /// services.AddFlowthru(flowthru =>
   /// {
   ///     flowthru
-  ///         .UseCatalog&lt;MyCatalog&gt;()
+  ///         .RegisterCatalog&lt;MyCatalog&gt;()
   ///         .UsePython(python =>
   ///         {
   ///             python.PythonDll = "/usr/lib/x86_64-linux-gnu/libpython3.12.so";
-  ///             python.ModuleSearchPaths.Add("Pipelines");
-  ///             python.ModuleSearchPaths.Add("SharedNodes");
+  ///             python.ModuleSearchPaths.Add("Flows");
+  ///             python.ModuleSearchPaths.Add("SharedSteps");
   ///         });
   /// });
   /// </code>
@@ -80,7 +80,7 @@ public static FlowthruServiceBuilder UsePython(this FlowthruServiceBuilder build
   /// services.AddFlowthru(flowthru =>
   /// {
   ///     flowthru
-  ///         .UseCatalog&lt;MyCatalog&gt;()
+  ///         .RegisterCatalog&lt;MyCatalog&gt;()
   ///         .UsePython(python =>
   ///         {
   ///             // Reads PYTHONNET_PYDLL, FLOWTHRU_PYTHON_VENV, FLOWTHRU_PYTHON_PATH
@@ -124,7 +124,7 @@ Action<PythonRuntimeOptions> configure
       // Register pre-flight decorator + dry-run dtype validation (in-process only)
       builder
         .Services()
-        .AddSingleton<Flowthru.Pipelines.Validation.IPipelineValidationHook, PythonNodeValidator>();
+        .AddSingleton<Flowthru.Flows.Validation.IFlowValidationHook, PythonStepValidator>();
     }
     else
     {
diff --git a/src/extensions/Flowthru.Extensions.Python/Nodes/PythonNodeFactory.cs b/src/extensions/Flowthru.Extensions.Python/Steps/PythonNodeFactory.cs
similarity index 69%
rename from src/extensions/Flowthru.Extensions.Python/Nodes/PythonNodeFactory.cs
rename to src/extensions/Flowthru.Extensions.Python/Steps/PythonNodeFactory.cs
index 47e170f9..cf741e81 100644
--- a/src/extensions/Flowthru.Extensions.Python/Nodes/PythonNodeFactory.cs
+++ b/src/extensions/Flowthru.Extensions.Python/Steps/PythonNodeFactory.cs
@@ -2,33 +2,33 @@
 using Flowthru.Extensions.Python.Execution;
 using Flowthru.Extensions.Python.Runtime;
 using Flowthru.Extensions.Python.Validation;
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 
-namespace Flowthru.Extensions.Python.Nodes;
+namespace Flowthru.Extensions.Python.Steps;
 
 /// <summary>
-/// Extension methods for adding Python nodes to pipelines.
+/// Extension methods for adding Python steps to flows.
 /// </summary>
 /// <remarks>
 /// <para>
 /// <strong>Phases 2-5 implementation:</strong>
-/// Hand-written 1×1 AddPythonNode(Phase 2-4).
+/// Hand-written 1×1 AddPythonStep(Phase 2-4).
 /// Source-generated N×M overloads for multi-I/O support (Phase 5).
 /// </para>
 /// <para>
 /// <strong>Usage:</strong>
 /// </para>
 /// <code>
-/// public static Pipeline Create(
+/// public static Flow Create(
 ///     Catalog catalog,
 ///     IPythonExecutor executor,
 ///     PythonRuntime runtime)
 /// {
-///     return PipelineBuilder.CreatePipeline(pipeline =>
+///     return FlowBuilder.CreateFlow(flow =>
 ///     {
-///         pipeline.AddPythonNode(
+///         flow.AddPythonStep(
 ///             label: "Transform",
-///             module: "my_nodes.transform",
+///             module: "my_steps.transform",
 ///             function: "process",
 ///             input: catalog.RawData,
 ///             output: catalog.ProcessedData,
@@ -45,30 +45,30 @@ namespace Flowthru.Extensions.Python.Nodes;
 /// </list>
 /// </para>
 /// </remarks>
-public static partial class PythonNodeFactory
+public static partial class PythonStepFactory
 {
   /// <summary>
-  /// Adds a Python node with single input and single output.
+  /// Adds a Python step with single input and single output.
   /// </summary>
-  /// <typeparam name="TInput">Input type (must match catalog entry type).</typeparam>
-  /// <typeparam name="TOutput">Output type (must match catalog entry type).</typeparam>
-  /// <param name="builder">Pipeline builder instance.</param>
-  /// <param name="label">Unique identifier for this node.</param>
+  /// <typeparam name="TInput">Input type (must match catalog item type).</typeparam>
+  /// <typeparam name="TOutput">Output type (must match catalog item type).</typeparam>
+  /// <param name="builder">Flow builder instance.</param>
+  /// <param name="label">Unique identifier for this step.</param>
   /// <param name="module">
-  /// Dotted Python module name (e.g., "Pipelines.DataScience.train_model").
+  /// Dotted Python module name (e.g., "Flows.DataScience.train_model").
   /// Must be resolvable via sys.path.
   /// </param>
   /// <param name="function">Python function name within the module.</param>
-  /// <param name="input">Catalog entry providing input data.</param>
-  /// <param name="output">Catalog entry to store output data.</param>
+  /// <param name="input">Catalog item providing input data.</param>
+  /// <param name="output">Catalog item to store output data.</param>
   /// <param name="executor">Python executor for invoking the function.</param>
   /// <param name="runtime">Python runtime for GIL management.</param>
-  /// <param name="description">Optional node description.</param>
+  /// <param name="description">Optional step description.</param>
   /// <returns>This builder for method chaining.</returns>
   /// <remarks>
   /// <para>
   /// <strong>Compile-time type safety:</strong>
-  /// Generic type parameters are inferred from catalog entries.
+  /// Generic type parameters are inferred from catalog items.
   /// Mismatched types produce compiler errors.
   /// </para>
   /// <para>
@@ -76,7 +76,7 @@ public static partial class PythonNodeFactory
   /// <list type="bullet">
   /// <item>Module is importable (exists, no syntax errors)</item>
   /// <item>Function exists in module</item>
-  /// <item>@node decorator is present</item>
+  /// <item>@step decorator is present</item>
   /// </list>
   /// </para>
   /// <para>
@@ -88,13 +88,13 @@ public static partial class PythonNodeFactory
   /// </list>
   /// </para>
   /// </remarks>
-  public static PipelineBuilder AddPythonNode<TInput, TOutput>(
-    this PipelineBuilder builder,
+  public static FlowBuilder AddPythonStep<TInput, TOutput>(
+    this FlowBuilder builder,
     string label,
     string module,
     string function,
-    ICatalogEntry<TInput> input,
-    ICatalogEntry<TOutput> output,
+    IItem<TInput> input,
+    IItem<TOutput> output,
     IPythonExecutor executor,
     string description = ""
   )
@@ -135,14 +135,14 @@ public static PipelineBuilder AddPythonNode<TInput, TOutput>(
     }
 
     // Phase 4: Registration-time validation via executor
-    executor.ValidateNode(module, function);
+    executor.ValidateStep(module, function);
 
-    var wrapper = new PythonNodeWrapper<TInput, TOutput>(executor, module, function);
+    var wrapper = new PythonStepWrapper<TInput, TOutput>(executor, module, function);
 
-    // Delegate to the existing AddNode infrastructure
+    // Delegate to the existing AddStep infrastructure
     // This ensures DAG scheduling, dependency analysis, and all other
-    // pipeline mechanics work identically for Python and C# nodes
-    return builder.AddNode(
+    // Flow mechanics work identically for Python and C# steps
+    return builder.AddStep(
       label: label,
       transform: wrapper.GetTransform(),
       input: input,
diff --git a/src/extensions/Flowthru.Extensions.Python/Nodes/PythonNodeWrapper.cs b/src/extensions/Flowthru.Extensions.Python/Steps/PythonNodeWrapper.cs
similarity index 65%
rename from src/extensions/Flowthru.Extensions.Python/Nodes/PythonNodeWrapper.cs
rename to src/extensions/Flowthru.Extensions.Python/Steps/PythonNodeWrapper.cs
index d98e24cb..0f6a68ea 100644
--- a/src/extensions/Flowthru.Extensions.Python/Nodes/PythonNodeWrapper.cs
+++ b/src/extensions/Flowthru.Extensions.Python/Steps/PythonNodeWrapper.cs
@@ -1,30 +1,37 @@
 using Flowthru.Extensions.Python.Execution;
 
-namespace Flowthru.Extensions.Python.Nodes;
+namespace Flowthru.Extensions.Python.Steps;
 
 /// <summary>
 /// Thin wrapper that binds an <see cref="IPythonExecutor"/> to a specific module/function pair,
-/// exposing it as a typed <c>Func&lt;TInput, TOutput&gt;</c> for use with the pipeline builder.
+/// exposing it as a typed <c>Func&lt;TInput, TOutput&gt;</c> for use with the Flow builder.
 /// </summary>
 /// <remarks>
 /// All marshalling (scalar, tabular, bytes, multi-I/O tuples) is delegated to the executor.
 /// </remarks>
-public sealed class PythonNodeWrapper<TInput, TOutput>
+public sealed class PythonStepWrapper<TInput, TOutput>
 {
   private readonly IPythonExecutor _executor;
   private readonly string _moduleName;
   private readonly string _functionName;
 
-  public PythonNodeWrapper(IPythonExecutor executor, string moduleName, string functionName)
+  /// <summary>
+  /// Initializes the wrapper with the executor and step information.
+  /// </summary>
+  /// <param name="executor"></param>
+  /// <param name="moduleName"></param>
+  /// <param name="functionName"></param>
+  /// <exception cref="ArgumentNullException"></exception>
+  public PythonStepWrapper(IPythonExecutor executor, string moduleName, string functionName)
   {
     _executor = executor ?? throw new ArgumentNullException(nameof(executor));
     _moduleName = moduleName ?? throw new ArgumentNullException(nameof(moduleName));
     _functionName = functionName ?? throw new ArgumentNullException(nameof(functionName));
-    _executor.ValidateNode(_moduleName, _functionName);
+    _executor.ValidateStep(_moduleName, _functionName);
   }
 
   /// <summary>
-  /// Gets the transformation function that invokes the Python node.
+  /// Gets the transformation function that invokes the Python step.
   /// </summary>
   /// <returns>
   /// A function that takes <typeparamref name="TInput"/> and returns <typeparamref name="TOutput"/>.
diff --git a/src/extensions/Flowthru.Extensions.Python/Validation/PythonNodeRegistrationValidator.cs b/src/extensions/Flowthru.Extensions.Python/Validation/PythonNodeRegistrationValidator.cs
index 25243643..d8598c74 100644
--- a/src/extensions/Flowthru.Extensions.Python/Validation/PythonNodeRegistrationValidator.cs
+++ b/src/extensions/Flowthru.Extensions.Python/Validation/PythonNodeRegistrationValidator.cs
@@ -5,20 +5,20 @@
 namespace Flowthru.Extensions.Python.Validation;
 
 /// <summary>
-/// Performs basic validation checks during Python node registration.
+/// Performs basic validation checks during Python step registration.
 /// </summary>
 /// <remarks>
 /// <para>
 /// <strong>Phase 4 registration-time validation:</strong>
-/// Validates that the Python module, function, and @node decorator exist before
-/// creating the node wrapper. This provides fast feedback during pipeline definition.
+/// Validates that the Python module, function, and @step decorator exist before
+/// creating the step wrapper. This provides fast feedback during Flow definition.
 /// </para>
 /// <para>
 /// <strong>Checks performed:</strong>
 /// <list type="bullet">
 /// <item>Module is importable (exists, no syntax errors)</item>
 /// <item>Function exists in module</item>
-/// <item>Function has @node decorator with metadata</item>
+/// <item>Function has @step decorator with metadata</item>
 /// </list>
 /// </para>
 /// <para>
@@ -30,14 +30,14 @@ namespace Flowthru.Extensions.Python.Validation;
 /// </list>
 /// </para>
 /// </remarks>
-internal static class PythonNodeRegistrationValidator
+internal static class PythonStepRegistrationValidator
 {
   /// <summary>
-  /// Validates that a Python node can be registered.
+  /// Validates that a Python step can be registered.
   /// </summary>
   /// <param name="executor">Python executor for module/function inspection</param>
   /// <param name="runtime">Python runtime for GIL management</param>
-  /// <param name="moduleName">Python module name (e.g., "pipelines.nodes.transform")</param>
+  /// <param name="moduleName">Python module name (e.g., "flows.steps.transform")</param>
   /// <param name="functionName">Python function name (e.g., "encode_species")</param>
   /// <exception cref="InvalidOperationException">
   /// Thrown if module, function, or decorator is missing or invalid
@@ -62,7 +62,7 @@ string functionName
       catch (PythonException ex)
       {
         throw new InvalidOperationException(
-          $"Python node registration failed: Module '{moduleName}' not found in sys.path\n\n"
+          $"Python step registration failed: Module '{moduleName}' not found in sys.path\n\n"
             + $"Error: {ex.Message}\n\n"
             + "Check:\n"
             + "  - Module name spelling\n"
@@ -90,7 +90,7 @@ string functionName
           }
 
           throw new InvalidOperationException(
-            $"Python node registration failed: Function '{functionName}' not found in module '{moduleName}'\n\n"
+            $"Python step registration failed: Function '{functionName}' not found in module '{moduleName}'\n\n"
               + $"Available functions: {string.Join(", ", availableFunctions)}\n\n"
               + "Check:\n"
               + "  - Function name spelling\n"
@@ -101,20 +101,20 @@ string functionName
 
       PyObject function = module.GetAttr(functionName);
 
-      // Check 3: @node decorator is present
+      // Check 3: @step decorator is present
       if (!function.HasAttr("__flowthru_inputs__") || !function.HasAttr("__flowthru_outputs__"))
       {
         throw new InvalidOperationException(
-          $"Python node registration failed: Function '{functionName}' in module '{moduleName}' "
-            + "is missing required @node decorator.\n\n"
+          $"Python step registration failed: Function '{functionName}' in module '{moduleName}' "
+            + "is missing required @step decorator.\n\n"
             + "Add decorator to declare schema contract:\n\n"
-            + "  from flowthru import node\n"
+            + "  from flowthru import step\n"
             + "  from flowthru_schemas import InputSchema, OutputSchema\n"
             + "  \n"
-            + $"  @node(inputs=[InputSchema], outputs=[OutputSchema])\n"
+            + $"  @step(inputs=[InputSchema], outputs=[OutputSchema])\n"
             + $"  def {functionName}(...):\n"
             + "      ...\n\n"
-            + "The @node decorator is required for all Python nodes in Flowthru pipelines."
+            + "The @step decorator is required for all Python steps in Flows."
         );
       }
 
diff --git a/src/extensions/Flowthru.Extensions.Python/Validation/PythonNodeValidator.cs b/src/extensions/Flowthru.Extensions.Python/Validation/PythonNodeValidator.cs
index db1fc770..fbc0d973 100644
--- a/src/extensions/Flowthru.Extensions.Python/Validation/PythonNodeValidator.cs
+++ b/src/extensions/Flowthru.Extensions.Python/Validation/PythonNodeValidator.cs
@@ -3,86 +3,83 @@
 using Flowthru.Data.Validation;
 using Flowthru.Extensions.Python.Execution;
 using Flowthru.Extensions.Python.Marshalling;
-using Flowthru.Extensions.Python.Nodes;
 using Flowthru.Extensions.Python.Runtime;
-using Flowthru.Pipelines;
-using Flowthru.Pipelines.Validation;
+using Flowthru.Extensions.Python.Steps;
+using Flowthru.Flows;
+using Flowthru.Flows.Validation;
 using Python.Runtime;
 
 namespace Flowthru.Extensions.Python.Validation;
 
 /// <summary>
-/// Validation hook for Python nodes.
+/// Validation hook for Python steps.
 /// </summary>
 /// <remarks>
 /// <para>
 /// <strong>Phase 4 pre-flight validation:</strong>
-/// Validates Python nodes during pipeline pre-flight to catch schema mismatches,
+/// Validates Python steps during Flow pre-flight to catch schema mismatches,
 /// incorrect function signatures, and structural errors before execution.
 /// </para>
 /// <para>
 /// <strong>Checks performed:</strong>
 /// <list type="bullet">
-/// <item>@node decorator schemas match C# generic type parameters</item>
+/// <item>@step decorator schemas match C# generic type parameters</item>
 /// <item>Function signature arity is correct for input count</item>
 /// <item>Dry-run with 0-row data validates output structure</item>
 /// </list>
 /// </para>
 /// <para>
 /// <strong>Integration:</strong>
-/// Register this hook via Pipeline.ValidationHooks during pipeline setup.
-/// The hook is automatically invoked during Pipeline.ValidateExternalInputsAsync().
+/// Register this hook via Flow.ValidationHooks during Flow setup.
+/// The hook is automatically invoked during Flow.ValidateExternalInputsAsync().
 /// </para>
 /// </remarks>
-public class PythonNodeValidator : IPipelineValidationHook
+public class PythonStepValidator : IFlowValidationHook
 {
   private readonly IPythonExecutor _executor;
   private readonly PythonRuntime _runtime;
 
   /// <summary>
-  /// Initializes a new instance of <see cref="PythonNodeValidator"/>.
+  /// Initializes a new instance of <see cref="PythonStepValidator"/>.
   /// </summary>
   /// <param name="executor">Python executor for function inspection</param>
   /// <param name="runtime">Python runtime for GIL management</param>
-  public PythonNodeValidator(IPythonExecutor executor, PythonRuntime runtime)
+  public PythonStepValidator(IPythonExecutor executor, PythonRuntime runtime)
   {
     _executor = executor ?? throw new ArgumentNullException(nameof(executor));
     _runtime = runtime ?? throw new ArgumentNullException(nameof(runtime));
   }
 
   /// <inheritdoc />
-  public async Task<ValidationResult> ValidateAsync(
-    Pipeline pipeline,
-    CancellationToken cancellationToken
-  )
+  public async Task<ValidationResult> ValidateAsync(Flow flow, CancellationToken cancellationToken)
   {
     var errors = new List<ValidationError>();
 
-    foreach (var node in pipeline.Nodes)
+    foreach (var step in flow.Steps)
     {
-      // Check if this is a Python node by examining the transform function
-      if (!IsPythonNode(node, out var pythonNodeInfo))
+      // Check if this is a Python step by examining the transform function
+      if (!IsPythonStep(step, out var pythonStepInfo))
       {
-        continue; // Skip non-Python nodes
+        continue; // Skip non-Python steps
       }
 
       // Validate decorator and schema compatibility
-      var nodeResult = await ValidatePythonNode(pythonNodeInfo!, cancellationToken);
-      errors.AddRange(nodeResult.Errors);
+      var stepResult = await ValidatePythonStep(pythonStepInfo!, cancellationToken);
+      errors.AddRange(stepResult.Errors);
     }
 
     return new ValidationResult(errors);
   }
 
   /// <summary>
-  /// Checks if a pipeline node is a Python node.
+  /// Checks if a Flow step is a Python step.
   /// </summary>
-  private bool IsPythonNode(Flowthru.Pipelines.PipelineNode node, out PythonNodeInfo? info)
+  private bool IsPythonStep(FlowStep step, out PythonStepInfo? info)
   {
     info = null;
 
-    // Python nodes use PythonNodeWrapper<TInput, TOutput> as the transform target
-    var transform = node.TransformFunction;
+    // Python steps use PythonStepWrapper<TInput, TOutput> as the transform target
+    var transform = step.TransformFunction;
     if (transform.Target == null)
     {
       return false;
@@ -90,14 +87,14 @@ private bool IsPythonNode(Flowthru.Pipelines.PipelineNode node, out PythonNodeIn
 
     var targetType = transform.Target.GetType();
 
-    // Check if target is PythonNodeWrapper<,>
+    // Check if target is PythonStepWrapper<,>
     if (!targetType.IsGenericType)
     {
       return false;
     }
 
     var genericTypeDef = targetType.GetGenericTypeDefinition();
-    if (genericTypeDef != typeof(PythonNodeWrapper<,>))
+    if (genericTypeDef != typeof(PythonStepWrapper<,>))
     {
       return false;
     }
@@ -132,9 +129,9 @@ private bool IsPythonNode(Flowthru.Pipelines.PipelineNode node, out PythonNodeIn
       return false;
     }
 
-    info = new PythonNodeInfo
+    info = new PythonStepInfo
     {
-      Label = node.Label,
+      Label = step.Label,
       ModuleName = moduleName,
       FunctionName = functionName,
       InputType = genericArgs[0],
@@ -145,10 +142,10 @@ private bool IsPythonNode(Flowthru.Pipelines.PipelineNode node, out PythonNodeIn
   }
 
   /// <summary>
-  /// Validates a single Python node.
+  /// Validates a single Python step.
   /// </summary>
-  private async Task<ValidationResult> ValidatePythonNode(
-    PythonNodeInfo nodeInfo,
+  private async Task<ValidationResult> ValidatePythonStep(
+    PythonStepInfo stepInfo,
     CancellationToken cancellationToken
   )
   {
@@ -164,15 +161,15 @@ CancellationToken cancellationToken
       {
         using (Py.GIL())
         {
-          module = Py.Import(nodeInfo.ModuleName);
-          function = module.GetAttr(nodeInfo.FunctionName);
+          module = Py.Import(stepInfo.ModuleName);
+          function = module.GetAttr(stepInfo.FunctionName);
         }
       }
       catch (PythonException ex)
       {
         errors.Add(
           new ValidationError(
-            nodeInfo.Label,
+            stepInfo.Label,
             ValidationErrorType.InvalidFormat,
             $"Failed to import Python function: {ex.Message}",
             ex.ToString()
@@ -182,7 +179,7 @@ CancellationToken cancellationToken
       }
 
       // Check decorator metadata
-      var decoratorResult = ValidateDecorator(nodeInfo, function);
+      var decoratorResult = ValidateDecorator(stepInfo, function);
       errors.AddRange(decoratorResult.Errors);
 
       if (!decoratorResult.IsValid)
@@ -191,9 +188,9 @@ CancellationToken cancellationToken
       }
 
       // Dry-run dtype validation for tabular outputs
-      if (IsEnumerableSchema(nodeInfo.OutputType))
+      if (IsEnumerableSchema(stepInfo.OutputType))
       {
-        var dryRunResult = ValidateDryRunDtypes(nodeInfo, function);
+        var dryRunResult = ValidateDryRunDtypes(stepInfo, function);
         errors.AddRange(dryRunResult.Errors);
       }
     }
@@ -210,7 +207,7 @@ CancellationToken cancellationToken
   /// passes it through the Python function, and checks if the output dtypes
   /// can be safely coerced to the C# schema types.
   /// </remarks>
-  private ValidationResult ValidateDryRunDtypes(PythonNodeInfo nodeInfo, PyObject function)
+  private ValidationResult ValidateDryRunDtypes(PythonStepInfo stepInfo, PyObject function)
   {
     var errors = new List<ValidationError>();
 
@@ -218,7 +215,7 @@ private ValidationResult ValidateDryRunDtypes(PythonNodeInfo nodeInfo, PyObject
     {
       using (Py.GIL())
       {
-        var schemaType = nodeInfo.OutputType.GetGenericArguments()[0];
+        var schemaType = stepInfo.OutputType.GetGenericArguments()[0];
 
         // Build expected dtype spec from C# schema
         var buildDtypeSpecMethod = typeof(ArrowSchemaMapper)
@@ -248,14 +245,14 @@ private ValidationResult ValidateDryRunDtypes(PythonNodeInfo nodeInfo, PyObject
         );
 
         // Note: A full dry-run would require creating 0-row input DataFrames for all inputs,
-        // invoking the function, and checking output dtypes. This is complex for multi-input nodes
+        // invoking the function, and checking output dtypes. This is complex for multi-input step
         // and may have side effects (imports, setup code).
         //
         // Instead, we rely on:
-        // 1. Registration-time validation (@node decorator exists)
+        // 1. Registration-time validation (@step decorator exists)
         // 2. Runtime automatic coercion in _flowthru_arrow.py (df_to_ipc with dtype_spec)
         //
-        // If a Python node returns incompatible dtypes, the runtime coercion will raise
+        // If a Python step returns incompatible dtypes, the runtime coercion will raise
         // detailed TypeError/OverflowError with fix guidance.
         //
         // Pre-flight dry-run validation would be added here as a Phase 5 enhancement.
@@ -265,7 +262,7 @@ private ValidationResult ValidateDryRunDtypes(PythonNodeInfo nodeInfo, PyObject
     {
       errors.Add(
         new ValidationError(
-          nodeInfo.Label,
+          stepInfo.Label,
           ValidationErrorType.InspectionFailure,
           $"Dry-run dtype validation failed: {ex.Message}",
           "This is a framework error, not a user error. Report this issue."
@@ -291,9 +288,9 @@ private static bool IsEnumerableSchema(Type type)
   }
 
   /// <summary>
-  /// Validates that the @node decorator metadata matches C# type parameters.
+  /// Validates that the @step decorator metadata matches C# type parameters.
   /// </summary>
-  private ValidationResult ValidateDecorator(PythonNodeInfo nodeInfo, PyObject function)
+  private ValidationResult ValidateDecorator(PythonStepInfo stepInfo, PyObject function)
   {
     var errors = new List<ValidationError>();
 
@@ -302,9 +299,9 @@ private ValidationResult ValidateDecorator(PythonNodeInfo nodeInfo, PyObject fun
     {
       errors.Add(
         new ValidationError(
-          nodeInfo.Label,
+          stepInfo.Label,
           ValidationErrorType.SchemaMismatch,
-          $"Function '{nodeInfo.FunctionName}' is missing @node decorator metadata",
+          $"Function '{stepInfo.FunctionName}' is missing @step decorator metadata",
           "This should have been caught during registration-time validation"
         )
       );
@@ -340,15 +337,15 @@ private ValidationResult ValidateDecorator(PythonNodeInfo nodeInfo, PyObject fun
     }
 
     // Extract C# schema names from type parameters (Phase 5: supports tuples)
-    var csharpInputSchemas = ExtractSchemaNames(nodeInfo.InputType);
-    var csharpOutputSchemas = ExtractSchemaNames(nodeInfo.OutputType);
+    var csharpInputSchemas = ExtractSchemaNames(stepInfo.InputType);
+    var csharpOutputSchemas = ExtractSchemaNames(stepInfo.OutputType);
 
     // Validate input schema count
     if (decoratorInputs.Count != csharpInputSchemas.Count)
     {
       errors.Add(
         new ValidationError(
-          nodeInfo.Label,
+          stepInfo.Label,
           ValidationErrorType.SchemaMismatch,
           $"Input schema count mismatch: C# expects {csharpInputSchemas.Count} input(s), decorator declares {decoratorInputs.Count}",
           $"C# inputs: [{string.Join(", ", csharpInputSchemas)}]\nDecorator inputs: [{string.Join(", ", decoratorInputs)}]"
@@ -361,7 +358,7 @@ private ValidationResult ValidateDecorator(PythonNodeInfo nodeInfo, PyObject fun
     {
       errors.Add(
         new ValidationError(
-          nodeInfo.Label,
+          stepInfo.Label,
           ValidationErrorType.SchemaMismatch,
           $"Output schema count mismatch: C# expects {csharpOutputSchemas.Count} output(s), decorator declares {decoratorOutputs.Count}",
           $"C# outputs: [{string.Join(", ", csharpOutputSchemas)}]\nDecorator outputs: [{string.Join(", ", decoratorOutputs)}]"
@@ -376,10 +373,10 @@ private ValidationResult ValidateDecorator(PythonNodeInfo nodeInfo, PyObject fun
       {
         errors.Add(
           new ValidationError(
-            nodeInfo.Label,
+            stepInfo.Label,
             ValidationErrorType.SchemaMismatch,
             $"Input schema mismatch at position {i + 1}:\n  C# registration declares:  {csharpInputSchemas[i]}\n  Python decorator declares: {decoratorInputs[i]}",
-            "The @node decorator must match the C# generic type parameters"
+            "The @step decorator must match the C# generic type parameters"
           )
         );
       }
@@ -392,17 +389,17 @@ private ValidationResult ValidateDecorator(PythonNodeInfo nodeInfo, PyObject fun
       {
         errors.Add(
           new ValidationError(
-            nodeInfo.Label,
+            stepInfo.Label,
             ValidationErrorType.SchemaMismatch,
             $"Output schema mismatch at position {i + 1}:\n  C# registration declares:  {csharpOutputSchemas[i]}\n  Python decorator declares: {decoratorOutputs[i]}",
-            "The @node decorator must match the C# generic type parameters"
+            "The @step decorator must match the C# generic type parameters"
           )
         );
       }
     }
 
     // Phase 5: Validate function arity using inspect.signature
-    var arityResult = ValidateFunctionArity(nodeInfo, function, csharpInputSchemas.Count);
+    var arityResult = ValidateFunctionArity(stepInfo, function, csharpInputSchemas.Count);
     errors.AddRange(arityResult.Errors);
 
     return new ValidationResult(errors);
@@ -412,7 +409,7 @@ private ValidationResult ValidateDecorator(PythonNodeInfo nodeInfo, PyObject fun
   /// Validates that the Python function's parameter count matches expected input count (Phase 5).
   /// </summary>
   private ValidationResult ValidateFunctionArity(
-    PythonNodeInfo nodeInfo,
+    PythonStepInfo stepInfo,
     PyObject function,
     int expectedParamCount
   )
@@ -433,9 +430,9 @@ int expectedParamCount
         {
           errors.Add(
             new ValidationError(
-              nodeInfo.Label,
+              stepInfo.Label,
               ValidationErrorType.SchemaMismatch,
-              $"Function parameter count mismatch: Python function '{nodeInfo.FunctionName}' has {actualParamCount} parameter(s), but C# registration expects {expectedParamCount} input(s)",
+              $"Function parameter count mismatch: Python function '{stepInfo.FunctionName}' has {actualParamCount} parameter(s), but C# registration expects {expectedParamCount} input(s)",
               $"Update the Python function signature to accept {expectedParamCount} parameter(s)"
             )
           );
@@ -446,7 +443,7 @@ int expectedParamCount
     {
       errors.Add(
         new ValidationError(
-          nodeInfo.Label,
+          stepInfo.Label,
           ValidationErrorType.InvalidFormat,
           $"Failed to inspect function signature: {ex.Message}",
           "Ensure the Python function is properly defined"
@@ -520,9 +517,9 @@ private bool IsValueTuple(Type type)
   }
 
   /// <summary>
-  /// Information about a Python node extracted from the pipeline.
+  /// Information about a Python step extracted from the flow.
   /// </summary>
-  private class PythonNodeInfo
+  private class PythonStepInfo
   {
     public required string Label { get; init; }
     public required string ModuleName { get; init; }
diff --git a/src/extensions/Flowthru.Extensions.Python/build/Flowthru.Extensions.Python.targets b/src/extensions/Flowthru.Extensions.Python/build/Flowthru.Extensions.Python.targets
index d44f3120..163994a0 100644
--- a/src/extensions/Flowthru.Extensions.Python/build/Flowthru.Extensions.Python.targets
+++ b/src/extensions/Flowthru.Extensions.Python/build/Flowthru.Extensions.Python.targets
@@ -68,7 +68,7 @@
           PackagePath="build"
           Visible="false" />
 
-    <!-- flowthru Python package (__init__.py, node.py) -->
+    <!-- flowthru Python package (__init__.py, step.py) -->
     <None Include="$(MSBuildThisFileDirectory)flowthru\__init__.py"
           CopyToOutputDirectory="PreserveNewest"
           PackageCopyToOutput="true"
@@ -76,13 +76,13 @@
           PackagePath="build\flowthru"
           Visible="false"
           Link="flowthru\__init__.py" />
-    <None Include="$(MSBuildThisFileDirectory)flowthru\node.py"
+    <None Include="$(MSBuildThisFileDirectory)flowthru\step.py"
           CopyToOutputDirectory="PreserveNewest"
           PackageCopyToOutput="true"
           Pack="true"
           PackagePath="build\flowthru"
           Visible="false"
-          Link="flowthru\node.py" />
+          Link="flowthru\step.py" />
   </ItemGroup>
 
   <!--
diff --git a/src/extensions/Flowthru.Extensions.Python/build/PythonSchemaExportTask.cs b/src/extensions/Flowthru.Extensions.Python/build/PythonSchemaExportTask.cs
index 7b439936..e332d0ca 100644
--- a/src/extensions/Flowthru.Extensions.Python/build/PythonSchemaExportTask.cs
+++ b/src/extensions/Flowthru.Extensions.Python/build/PythonSchemaExportTask.cs
@@ -205,7 +205,7 @@ private void GenerateInitFile(string outputDirectory, Array schemas, Type schema
     sb.AppendLine();
     sb.AppendLine("\"\"\"");
     sb.AppendLine("Generated Python schemas from C# [FlowthruSchema] types.");
-    sb.AppendLine("Import these types in your Python nodes for IDE support.");
+    sb.AppendLine("Import these types in your Python steps for IDE support.");
     sb.AppendLine("\"\"\"");
     sb.AppendLine();
 
diff --git a/src/extensions/Flowthru.Extensions.Python/build/_flowthru_arrow.py b/src/extensions/Flowthru.Extensions.Python/build/_flowthru_arrow.py
index 5a85e911..9eea84e2 100644
--- a/src/extensions/Flowthru.Extensions.Python/build/_flowthru_arrow.py
+++ b/src/extensions/Flowthru.Extensions.Python/build/_flowthru_arrow.py
@@ -2,12 +2,12 @@
 Flowthru Arrow IPC bridge for DataFrame marshalling.
 
 This module handles the boundary between C# Arrow RecordBatch (as IPC buffers)
-and pandas DataFrames for Python nodes.
+and pandas DataFrames for Python steps.
 
 **Purpose:**
 Provides bidirectional conversion between:
 - C# Arrow IPC buffers (from ArrowMarshaller.ToIpcBuffer)
-- pandas DataFrames (for Python node functions)
+- pandas DataFrames (for Python step functions)
 
 **Type Safety:**
 The C# side controls the schema (column names, types, nullability).
@@ -98,7 +98,7 @@ def df_to_ipc(df, dtype_spec=None) -> bytes:
 
     Example:
         >>> # Called by ArrowMarshaller internally
-        >>> result_df = my_node_function(input_df)
+        >>> result_df = my_step_function(input_df)
         >>> dtype_spec = {'id': 'int32', 'score': 'float64'}
         >>> ipc_buffer = df_to_ipc(result_df, dtype_spec)
         >>> # C# receives buffer via Python.NET
@@ -266,7 +266,7 @@ def _coerce_to_int32(df, col, current_dtype):
             if len(non_null_values) > 0 and not (non_null_values == non_null_values.astype('int64')).all():
                 raise TypeError(
                     f"Column '{col}' contains fractional values, cannot convert to int32. "
-                    f"Use 'float' or 'double' in C# schema, or round values in Python node."
+                    f"Use 'float' or 'double' in C# schema, or round values in Python step."
                 )
         
         # Use nullable Int32 if there are nulls, otherwise regular int32
@@ -277,7 +277,7 @@ def _coerce_to_int32(df, col, current_dtype):
     else:
         raise TypeError(
             f"Cannot coerce column '{col}' with dtype {current_dtype} to int32. "
-            f"Convert to numeric type in Python node first."
+            f"Convert to numeric type in Python step first."
         )
 
 
diff --git a/src/extensions/Flowthru.Extensions.Python/build/flowthru/__init__.py b/src/extensions/Flowthru.Extensions.Python/build/flowthru/__init__.py
index 551b727e..c1de53d8 100644
--- a/src/extensions/Flowthru.Extensions.Python/build/flowthru/__init__.py
+++ b/src/extensions/Flowthru.Extensions.Python/build/flowthru/__init__.py
@@ -1,10 +1,10 @@
 """
 Flowthru Python extension package.
 
-Provides decorators and utilities for writing Python nodes in Flowthru pipelines.
+Provides decorators and utilities for writing Python steps in Flowthru pipelines.
 """
 
-from .node import node
+from .step import step
 
-__all__ = ["node"]
+__all__ = ["step"]
 __version__ = "0.1.0"
diff --git a/src/extensions/Flowthru.Extensions.Python/build/flowthru/node.py b/src/extensions/Flowthru.Extensions.Python/build/flowthru/step.py
similarity index 80%
rename from src/extensions/Flowthru.Extensions.Python/build/flowthru/node.py
rename to src/extensions/Flowthru.Extensions.Python/build/flowthru/step.py
index a1856ea4..0335d7fb 100644
--- a/src/extensions/Flowthru.Extensions.Python/build/flowthru/node.py
+++ b/src/extensions/Flowthru.Extensions.Python/build/flowthru/step.py
@@ -1,28 +1,28 @@
 """
-@node decorator for declaring Python node contracts.
+@step decorator for declaring Python step contracts.
 
-The @node decorator attaches metadata to Python functions that Flowthru's
+The @step decorator attaches metadata to Python functions that Flowthru's
 pre-flight validator reads to ensure schema compatibility between Python
 functions and C# pipeline registrations.
 """
 
 
-def node(inputs=None, outputs=None):
+def step(inputs=None, outputs=None):
     """
-    Declares the input and output schemas for a Python node function.
+    Declares the input and output schemas for a Python step function.
 
     This decorator attaches metadata (__flowthru_inputs__, __flowthru_outputs__)
     that Flowthru's pre-flight validator reads via Python.NET. The validator
     compares this metadata against the C# generic type parameters used during
-    node registration to catch schema mismatches before pipeline execution.
+    step registration to catch schema mismatches before pipeline execution.
 
     Args:
         inputs: Single schema type or list of schema types for inputs.
-                For single-input nodes: inputs=SchemaType or inputs=[SchemaType]
-                For multi-input nodes: inputs=[Schema1, Schema2, ...]
+                For single-input steps: inputs=SchemaType or inputs=[SchemaType]
+                For multi-input steps: inputs=[Schema1, Schema2, ...]
         outputs: Single schema type or list of schema types for outputs.
-                 For single-output nodes: outputs=SchemaType or outputs=[SchemaType]
-                 For multi-output nodes: outputs=[Schema1, Schema2, ...]
+                 For single-output steps: outputs=SchemaType or outputs=[SchemaType]
+                 For multi-output steps: outputs=[Schema1, Schema2, ...]
 
     Returns:
         Decorated function with __flowthru_inputs__ and __flowthru_outputs__ attributes.
@@ -30,26 +30,26 @@ def node(inputs=None, outputs=None):
     Example:
         Single input, single output (tabular):
 
-            from flowthru import node
+            from flowthru import step
             from flowthru_schemas import IrisRawSchema, IrisFeatureSchema
 
-            @node(inputs=[IrisRawSchema], outputs=[IrisFeatureSchema])
+            @step(inputs=[IrisRawSchema], outputs=[IrisFeatureSchema])
             def transform(df):
                 return df.assign(species_encoded=df['species'].map({...}))
 
         Single input, single output (scalar):
 
-            from flowthru import node
+            from flowthru import step
             from flowthru_schemas import ModelConfig, ModelMetrics
 
-            @node(inputs=[ModelConfig], outputs=[ModelMetrics])
+            @step(inputs=[ModelConfig], outputs=[ModelMetrics])
             def train_model(config):
                 accuracy = config['LearningRate'] * config['Iterations'] / 100.0
                 return {'Accuracy': accuracy, 'Loss': 1.0 - accuracy}
 
         Multi-input, multi-output (Phase 5):
 
-            @node(
+            @step(
                 inputs=[TrainDataSchema, TestDataSchema],
                 outputs=[FeaturesSchema, LabelsSchema]
             )
@@ -59,7 +59,7 @@ def split_features(train_df, test_df):
                 return features, labels
 
     Notes:
-        - The decorator is required for all Python nodes in Flowthru pipelines.
+        - The decorator is required for all Python steps in Flowthru pipelines.
         - Schema types should be imported from the generated flowthru_schemas package
           (available in Phase 5), or referenced by name as strings.
         - For Phase 4, pass schema type objects or class references directly.
diff --git a/src/extensions/Flowthru.Extensions.Python/build/flowthru_worker.py b/src/extensions/Flowthru.Extensions.Python/build/flowthru_worker.py
index 9b3e5737..5d0d43a1 100644
--- a/src/extensions/Flowthru.Extensions.Python/build/flowthru_worker.py
+++ b/src/extensions/Flowthru.Extensions.Python/build/flowthru_worker.py
@@ -199,7 +199,7 @@ def main() -> None:
     try:
         _flowthru_arrow = importlib.import_module("_flowthru_arrow")
     except ImportError:
-        pass  # tabular nodes will raise at invocation time with a clear message
+        pass  # tabular steps will raise at invocation time with a clear message
 
     sys.stdout.write(
         json.dumps({
diff --git a/src/misc/Flowthru.Misc.ML/UMAP/Core/UmapPipeline.cs b/src/misc/Flowthru.Misc.ML/UMAP/Core/UmapPipeline.cs
index 0d035237..20fed780 100644
--- a/src/misc/Flowthru.Misc.ML/UMAP/Core/UmapPipeline.cs
+++ b/src/misc/Flowthru.Misc.ML/UMAP/Core/UmapPipeline.cs
@@ -55,9 +55,9 @@ public static class UmapPipeline
   /// UMAP hyperparameters (n_neighbors, min_dist, etc.).
   /// If null, uses defaults appropriate for the data.
   /// </param>
-  public static UmapPipelineBuilder Create(UmapParameters? parameters = null)
+  public static UmapFlowBuilder Create(UmapParameters? parameters = null)
   {
-    return new UmapPipelineBuilder(parameters ?? new UmapParameters());
+    return new UmapFlowBuilder(parameters ?? new UmapParameters());
   }
 }
 
diff --git a/src/misc/Flowthru.Misc.ML/UMAP/Core/UmapPipelineBuilder.cs b/src/misc/Flowthru.Misc.ML/UMAP/Core/UmapPipelineBuilder.cs
index 567c9c96..f675f892 100644
--- a/src/misc/Flowthru.Misc.ML/UMAP/Core/UmapPipelineBuilder.cs
+++ b/src/misc/Flowthru.Misc.ML/UMAP/Core/UmapPipelineBuilder.cs
@@ -11,7 +11,7 @@
 
 namespace Flowthru.Misc.ML.UMAP.Core;
 
-public sealed class UmapPipelineBuilder
+public sealed class UmapFlowBuilder
 {
   private readonly UmapParameters _parameters;
   private IMetric _inputMetric = EuclideanMetric.Instance;
@@ -24,61 +24,61 @@ public sealed class UmapPipelineBuilder
   private ISamplingScheduleStrategy? _samplingSchedule;
   private ILayoutOptimizationStrategy? _layoutOptimization;
 
-  internal UmapPipelineBuilder(UmapParameters parameters)
+  internal UmapFlowBuilder(UmapParameters parameters)
   {
     _parameters = parameters;
     _parameters.Validate();
   }
 
-  public UmapPipelineBuilder WithInputMetric(IMetric metric)
+  public UmapFlowBuilder WithInputMetric(IMetric metric)
   {
     _inputMetric = metric ?? throw new ArgumentNullException(nameof(metric));
     return this;
   }
 
-  public UmapPipelineBuilder WithOutputMetric(IOutputMetric metric)
+  public UmapFlowBuilder WithOutputMetric(IOutputMetric metric)
   {
     _outputMetric = metric;
     return this;
   }
 
-  public UmapPipelineBuilder WithNeighborSearch(INeighborSearchStrategy strategy)
+  public UmapFlowBuilder WithNeighborSearch(INeighborSearchStrategy strategy)
   {
     _neighborSearch = strategy;
     return this;
   }
 
-  public UmapPipelineBuilder WithLocalMetric(ILocalMetricStrategy strategy)
+  public UmapFlowBuilder WithLocalMetric(ILocalMetricStrategy strategy)
   {
     _localMetric = strategy;
     return this;
   }
 
-  public UmapPipelineBuilder WithMembershipStrength(IMembershipStrengthStrategy strategy)
+  public UmapFlowBuilder WithMembershipStrength(IMembershipStrengthStrategy strategy)
   {
     _membershipStrength = strategy;
     return this;
   }
 
-  public UmapPipelineBuilder WithGraphRefinement(IGraphRefinementStrategy strategy)
+  public UmapFlowBuilder WithGraphRefinement(IGraphRefinementStrategy strategy)
   {
     _graphRefinement = strategy;
     return this;
   }
 
-  public UmapPipelineBuilder WithLayoutInit(ILayoutInitStrategy strategy)
+  public UmapFlowBuilder WithLayoutInit(ILayoutInitStrategy strategy)
   {
     _layoutInit = strategy;
     return this;
   }
 
-  public UmapPipelineBuilder WithSamplingSchedule(ISamplingScheduleStrategy strategy)
+  public UmapFlowBuilder WithSamplingSchedule(ISamplingScheduleStrategy strategy)
   {
     _samplingSchedule = strategy;
     return this;
   }
 
-  public UmapPipelineBuilder WithLayoutOptimization(ILayoutOptimizationStrategy strategy)
+  public UmapFlowBuilder WithLayoutOptimization(ILayoutOptimizationStrategy strategy)
   {
     _layoutOptimization = strategy;
     return this;
diff --git a/tests/Flowthru.Extensions.EFCore.Tests/EFCoreSingleStorageAdapterTests.cs b/tests/Flowthru.Extensions.EFCore.Tests/EFCoreSingleStorageAdapterTests.cs
index 63300994..0dacdc76 100644
--- a/tests/Flowthru.Extensions.EFCore.Tests/EFCoreSingleStorageAdapterTests.cs
+++ b/tests/Flowthru.Extensions.EFCore.Tests/EFCoreSingleStorageAdapterTests.cs
@@ -32,7 +32,7 @@ public async Task DefaultRoundTrip_SaveAndLoad_ReturnsSingleEntity()
   {
     var testEntity = new TestEntity { Id = 1, Name = "Alice" };
 
-    var entry = EFCoreCatalogEntries.Single.EFCore<TestEntity>(
+    var entry = EFCoreItemFactory.Single.EFCore<TestEntity>(
       "test",
       () => new TestDbContext(_options)
     );
@@ -47,7 +47,7 @@ public async Task DefaultRoundTrip_SaveAndLoad_ReturnsSingleEntity()
   [Test]
   public async Task AllowEmptyData_False_FailsInspectionOnEmptyTable()
   {
-    var entry = EFCoreCatalogEntries.Single.EFCore<TestEntity>(
+    var entry = EFCoreItemFactory.Single.EFCore<TestEntity>(
       "test",
       () => new TestDbContext(_options),
       allowEmptyData: false
@@ -61,7 +61,7 @@ public async Task AllowEmptyData_False_FailsInspectionOnEmptyTable()
   [Test]
   public async Task AllowEmptyData_True_PassesInspectionOnEmptyTable()
   {
-    var entry = EFCoreCatalogEntries.Single.EFCore<TestEntity>(
+    var entry = EFCoreItemFactory.Single.EFCore<TestEntity>(
       "test",
       () => new TestDbContext(_options),
       allowEmptyData: true
diff --git a/tests/Flowthru.Extensions.EFCore.Tests/EFCoreStorageAdapterTests.cs b/tests/Flowthru.Extensions.EFCore.Tests/EFCoreStorageAdapterTests.cs
index 01244e7e..e14e5ff6 100644
--- a/tests/Flowthru.Extensions.EFCore.Tests/EFCoreStorageAdapterTests.cs
+++ b/tests/Flowthru.Extensions.EFCore.Tests/EFCoreStorageAdapterTests.cs
@@ -37,7 +37,7 @@ public async Task DefaultRoundTrip_SaveAndLoad_ReturnsEntities()
       new TestEntity { Id = 2, Name = "Bob" },
     };
 
-    var entry = EFCoreCatalogEntries.Enumerable.EFCore<TestEntity>(
+    var entry = EFCoreItemFactory.Enumerable.EFCore<TestEntity>(
       "test",
       () => new TestDbContext(_options)
     );
@@ -58,13 +58,13 @@ public async Task QueryCustomizer_FiltersResults()
       new TestEntity { Id = 2, Name = "Bob" },
     };
 
-    var saveEntry = EFCoreCatalogEntries.Enumerable.EFCore<TestEntity>(
+    var saveEntry = EFCoreItemFactory.Enumerable.EFCore<TestEntity>(
       "save",
       () => new TestDbContext(_options)
     );
     await saveEntry.Save(testData).Run();
 
-    var filteredEntry = EFCoreCatalogEntries.Enumerable.EFCore<TestEntity>(
+    var filteredEntry = EFCoreItemFactory.Enumerable.EFCore<TestEntity>(
       "filtered",
       () => new TestDbContext(_options),
       queryCustomizer: q => q.Where(e => e.Id == 2)
@@ -84,7 +84,7 @@ public async Task CustomSaveDelegate_IsCalled()
     };
     bool saveCalled = false;
 
-    var entry = EFCoreCatalogEntries.Enumerable.EFCore<TestEntity, TestDbContext>(
+    var entry = EFCoreItemFactory.Enumerable.EFCore<TestEntity, TestDbContext>(
       "test",
       () => new TestDbContext(_options),
       saveFunc: async (ctx, data, ct) =>
@@ -108,7 +108,7 @@ public async Task TypedSaveDelegate_ReceivesTypedContext()
     };
     Type? receivedContextType = null;
 
-    var entry = EFCoreCatalogEntries.Enumerable.EFCore<TestEntity, TestDbContext>(
+    var entry = EFCoreItemFactory.Enumerable.EFCore<TestEntity, TestDbContext>(
       "test",
       () => new TestDbContext(_options),
       saveFunc: async (ctx, data, ct) =>
@@ -131,7 +131,7 @@ public async Task TypedContextFactory_RoundTrip()
       new TestEntity { Id = 1, Name = "Alice" },
     };
 
-    var entry = EFCoreCatalogEntries.Enumerable.EFCore<TestEntity, TestDbContext>(
+    var entry = EFCoreItemFactory.Enumerable.EFCore<TestEntity, TestDbContext>(
       "test",
       () => new TestDbContext(_options)
     );
@@ -152,7 +152,7 @@ public async Task IDbContextFactory_RoundTrip()
     };
     var factory = new TestDbContextFactory(_options);
 
-    var entry = EFCoreCatalogEntries.Enumerable.EFCore<TestEntity, TestDbContext>("test", factory);
+    var entry = EFCoreItemFactory.Enumerable.EFCore<TestEntity, TestDbContext>("test", factory);
 
     await entry.Save(testData).Run();
     var loaded = (await entry.Load().Run()).ToList();
diff --git a/tests/Flowthru.Extensions.Python.Tests/Compilation/PythonNodeTypeSafetyTests.cs b/tests/Flowthru.Extensions.Python.Tests/Compilation/PythonNodeTypeSafetyTests.cs
index 9a806623..9e36c410 100644
--- a/tests/Flowthru.Extensions.Python.Tests/Compilation/PythonNodeTypeSafetyTests.cs
+++ b/tests/Flowthru.Extensions.Python.Tests/Compilation/PythonNodeTypeSafetyTests.cs
@@ -1,5 +1,5 @@
 using Flowthru.Extensions.Python.Execution;
-using Flowthru.Extensions.Python.Nodes;
+using Flowthru.Extensions.Python.Steps;
 using Flowthru.Extensions.Python.Tests.Schemas;
 using Flowthru.Tests.Common;
 using Microsoft.CodeAnalysis;
@@ -11,10 +11,10 @@ namespace Flowthru.Extensions.Python.Tests.Compilation;
 /// Compilation tests verifying that Python node wiring is type-safe at compile-time.
 /// </summary>
 /// <remarks>
-/// These tests verify that the catalog entry types passed to AddPythonNode are
+/// These tests verify that the catalog entry types passed to AddPythonStep are
 /// self-consistent and correctly inferred by the compiler.
 ///
-/// Note: Schema contract violations between C# generic types and Python @node
+/// Note: Schema contract violations between C# generic types and Python @step
 /// decorator declarations are caught at pre-flight, not compile-time — see
 /// <see cref="Flowthru.Extensions.Python.Tests.Validation.PythonNodeValidationTests"/>.
 /// </remarks>
@@ -24,28 +24,28 @@ namespace Flowthru.Extensions.Python.Tests.Compilation;
 public class PythonNodeTypeSafetyTests
 {
   [Test]
-  public void AddPythonNode_WithMatchingTypes_CompilesSuccessfully()
+  public void AddPythonStep_WithMatchingTypes_CompilesSuccessfully()
   {
     // Arrange: Code with correct type matching
     var code =
       @"
             using Flowthru.Data;
-            using Flowthru.Extensions.Python.Nodes;
+            using Flowthru.Extensions.Python.Steps;
             using Flowthru.Extensions.Python.Execution;
             using Flowthru.Extensions.Python.Tests.Schemas;
-            using Flowthru.Pipelines;
+            using Flowthru.Flows;
             
             public class TestProgram
             {
                 public void TestMethod(
                     IPythonExecutor executor)
                 {
-                    var config = CatalogEntries.Single.Memory<ModelConfigSchema>(label: ""config"");
-                    var result = CatalogEntries.Single.Memory<ModelResultSchema>(label: ""result"");
+                    var config = ItemFactory.Single.Memory<ModelConfigSchema>(label: ""config"");
+                    var result = ItemFactory.Single.Memory<ModelResultSchema>(label: ""result"");
                     
-                    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+                    var pipeline = FlowBuilder.CreateFlow(builder =>
                     {
-                        builder.AddPythonNode(
+                        builder.AddPythonStep(
                             label: ""Test"",
                             module: ""test"",
                             function: ""test"",
@@ -79,30 +79,30 @@ public void TestMethod(
   }
 
   [Test]
-  public void AddPythonNode_WithInferredMatchingTypes_CompilesSuccessfully()
+  public void AddPythonStep_WithInferredMatchingTypes_CompilesSuccessfully()
   {
     // Arrange: Code that relies on type inference (no explicit generic params)
     // Type mismatch should still be caught
     var code =
       @"
             using Flowthru.Data;
-            using Flowthru.Extensions.Python.Nodes;
+            using Flowthru.Extensions.Python.Steps;
             using Flowthru.Extensions.Python.Execution;
             using Flowthru.Extensions.Python.Tests.Schemas;
-            using Flowthru.Pipelines;
+            using Flowthru.Flows;
             
             public class TestProgram
             {
                 public void TestMethod(
                     IPythonExecutor executor)
                 {
-                    var config = CatalogEntries.Single.Memory<ModelConfigSchema>(label: ""config"");
-                    var wrongOutput = CatalogEntries.Single.Memory<ModelConfigSchema>(label: ""wrong_output"");
+                    var config = ItemFactory.Single.Memory<ModelConfigSchema>(label: ""config"");
+                    var wrongOutput = ItemFactory.Single.Memory<ModelConfigSchema>(label: ""wrong_output"");
                     
-                    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+                    var pipeline = FlowBuilder.CreateFlow(builder =>
                     {
                         // Relying on type inference, but types still don't match
-                        builder.AddPythonNode(
+                        builder.AddPythonStep(
                             label: ""Test"",
                             module: ""test"",
                             function: ""test"",
diff --git a/tests/Flowthru.Extensions.Python.Tests/Integration/PythonNodeIntegrationTests.cs b/tests/Flowthru.Extensions.Python.Tests/Integration/PythonNodeIntegrationTests.cs
index cad3145a..6cd2ac4c 100644
--- a/tests/Flowthru.Extensions.Python.Tests/Integration/PythonNodeIntegrationTests.cs
+++ b/tests/Flowthru.Extensions.Python.Tests/Integration/PythonNodeIntegrationTests.cs
@@ -1,6 +1,6 @@
 using Flowthru.Extensions.Python.Execution;
-using Flowthru.Extensions.Python.Nodes;
 using Flowthru.Extensions.Python.Runtime;
+using Flowthru.Extensions.Python.Steps;
 using Flowthru.Extensions.Python.Tests.Schemas;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Logging;
@@ -9,12 +9,12 @@ namespace Flowthru.Extensions.Python.Tests.Integration;
 
 /// <summary>
 /// Integration tests for Python node wrappers.
-/// Tests the complete Phase 2 implementation: scalar marshalling and PythonNodeWrapper.
+/// Tests the complete Phase 2 implementation: scalar marshalling and PythonStepWrapper.
 /// </summary>
 [TestFixture]
 [Category("Python")]
 [Category("Integration")]
-public class PythonNodeWrapperIntegrationTests
+public class PythonStepWrapperIntegrationTests
 {
   private IServiceProvider _serviceProvider = null!;
   private IPythonExecutor _executor = null!;
@@ -53,10 +53,10 @@ public void TearDown()
   }
 
   [Test]
-  public void PythonNodeWrapper_TrainModel_ExecutesSuccessfully()
+  public void PythonStepWrapper_TrainModel_ExecutesSuccessfully()
   {
     // Arrange
-    var wrapper = new PythonNodeWrapper<ModelConfigSchema, ModelResultSchema>(
+    var wrapper = new PythonStepWrapper<ModelConfigSchema, ModelResultSchema>(
       _executor,
       "scalar_nodes",
       "train_model"
@@ -87,10 +87,10 @@ public void PythonNodeWrapper_TrainModel_ExecutesSuccessfully()
   }
 
   [Test]
-  public void PythonNodeWrapper_Identity_PreservesData()
+  public void PythonStepWrapper_Identity_PreservesData()
   {
     // Arrange
-    var wrapper = new PythonNodeWrapper<ModelConfigSchema, ModelConfigSchema>(
+    var wrapper = new PythonStepWrapper<ModelConfigSchema, ModelConfigSchema>(
       _executor,
       "scalar_nodes",
       "identity"
@@ -115,10 +115,10 @@ public void PythonNodeWrapper_Identity_PreservesData()
   }
 
   [Test]
-  public void PythonNodeWrapper_DoubleIterations_ModifiesCorrectly()
+  public void PythonStepWrapper_DoubleIterations_ModifiesCorrectly()
   {
     // Arrange
-    var wrapper = new PythonNodeWrapper<ModelConfigSchema, ModelConfigSchema>(
+    var wrapper = new PythonStepWrapper<ModelConfigSchema, ModelConfigSchema>(
       _executor,
       "scalar_nodes",
       "double_iterations"
@@ -143,16 +143,16 @@ public void PythonNodeWrapper_DoubleIterations_ModifiesCorrectly()
   }
 
   [Test]
-  public void PythonNodeWrapper_CanBeChained_WorksAsFunc()
+  public void PythonStepWrapper_CanBeChained_WorksAsFunc()
   {
     // Arrange: Create two wrappers and chain them
-    var doubleWrapper = new PythonNodeWrapper<ModelConfigSchema, ModelConfigSchema>(
+    var doubleWrapper = new PythonStepWrapper<ModelConfigSchema, ModelConfigSchema>(
       _executor,
       "scalar_nodes",
       "double_iterations"
     );
 
-    var trainWrapper = new PythonNodeWrapper<ModelConfigSchema, ModelResultSchema>(
+    var trainWrapper = new PythonStepWrapper<ModelConfigSchema, ModelResultSchema>(
       _executor,
       "scalar_nodes",
       "train_model"
@@ -184,10 +184,10 @@ public void PythonNodeWrapper_CanBeChained_WorksAsFunc()
   }
 
   [Test]
-  public void PythonNodeWrapper_DictWithSerializedLabel_MapsCorrectly()
+  public void PythonStepWrapper_DictWithSerializedLabel_MapsCorrectly()
   {
     // Arrange - Test dict → singleton with SerializedLabel attributes
-    var wrapper = new PythonNodeWrapper<(int, int), MetricsReportSchema>(
+    var wrapper = new PythonStepWrapper<(int, int), MetricsReportSchema>(
       _executor,
       "scalar_nodes",
       "calculate_metrics"
@@ -213,10 +213,10 @@ public void PythonNodeWrapper_DictWithSerializedLabel_MapsCorrectly()
   }
 
   [Test]
-  public void PythonNodeWrapper_DictWithSerializedLabel_PartialMatch()
+  public void PythonStepWrapper_DictWithSerializedLabel_PartialMatch()
   {
     // Arrange - Test with non-100% accuracy
-    var wrapper = new PythonNodeWrapper<(int, int), MetricsReportSchema>(
+    var wrapper = new PythonStepWrapper<(int, int), MetricsReportSchema>(
       _executor,
       "scalar_nodes",
       "calculate_metrics"
diff --git a/tests/Flowthru.Extensions.Python.Tests/Integration/TabularNodeTests.cs b/tests/Flowthru.Extensions.Python.Tests/Integration/TabularNodeTests.cs
index f1254244..9db6c11e 100644
--- a/tests/Flowthru.Extensions.Python.Tests/Integration/TabularNodeTests.cs
+++ b/tests/Flowthru.Extensions.Python.Tests/Integration/TabularNodeTests.cs
@@ -1,6 +1,6 @@
 using Flowthru.Extensions.Python.Execution;
-using Flowthru.Extensions.Python.Nodes;
 using Flowthru.Extensions.Python.Runtime;
+using Flowthru.Extensions.Python.Steps;
 using Flowthru.Extensions.Python.Tests.Schemas;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Logging;
@@ -78,7 +78,7 @@ public void PythonNode_Passthrough_RoundTripsDataIntact()
       },
     };
 
-    var wrapper = new PythonNodeWrapper<IEnumerable<SimpleRowSchema>, IEnumerable<SimpleRowSchema>>(
+    var wrapper = new PythonStepWrapper<IEnumerable<SimpleRowSchema>, IEnumerable<SimpleRowSchema>>(
       _executor,
       "_Fixtures.tabular_nodes",
       "passthrough"
@@ -137,7 +137,7 @@ public void PythonNode_FilterRows_AppliesTransformation()
       },
     };
 
-    var wrapper = new PythonNodeWrapper<IEnumerable<SimpleRowSchema>, IEnumerable<SimpleRowSchema>>(
+    var wrapper = new PythonStepWrapper<IEnumerable<SimpleRowSchema>, IEnumerable<SimpleRowSchema>>(
       _executor,
       "_Fixtures.tabular_nodes",
       "filter_rows"
@@ -162,7 +162,7 @@ public void PythonNode_EmptyInput_ReturnsEmptyOutput()
     // Arrange
     var inputData = Array.Empty<SimpleRowSchema>();
 
-    var wrapper = new PythonNodeWrapper<IEnumerable<SimpleRowSchema>, IEnumerable<SimpleRowSchema>>(
+    var wrapper = new PythonStepWrapper<IEnumerable<SimpleRowSchema>, IEnumerable<SimpleRowSchema>>(
       _executor,
       "_Fixtures.tabular_nodes",
       "passthrough"
@@ -198,7 +198,7 @@ public void PythonNode_ExtendedTypes_PreservesAllTypes()
       },
     };
 
-    var wrapper = new PythonNodeWrapper<
+    var wrapper = new PythonStepWrapper<
       IEnumerable<ExtendedTypesSchema>,
       IEnumerable<ExtendedTypesSchema>
     >(_executor, "_Fixtures.tabular_nodes", "passthrough");
@@ -233,7 +233,7 @@ public void PythonNode_NullableFields_PreservesNulls()
       },
     };
 
-    var wrapper = new PythonNodeWrapper<
+    var wrapper = new PythonStepWrapper<
       IEnumerable<ExtendedTypesSchema>,
       IEnumerable<ExtendedTypesSchema>
     >(_executor, "_Fixtures.tabular_nodes", "passthrough");
@@ -263,7 +263,7 @@ public void PythonNode_LargeDataset_HandlesEfficiently()
       })
       .ToArray();
 
-    var wrapper = new PythonNodeWrapper<IEnumerable<SimpleRowSchema>, IEnumerable<SimpleRowSchema>>(
+    var wrapper = new PythonStepWrapper<IEnumerable<SimpleRowSchema>, IEnumerable<SimpleRowSchema>>(
       _executor,
       "_Fixtures.tabular_nodes",
       "passthrough"
@@ -294,7 +294,7 @@ public void PythonNode_SerializedLabelRespected_FieldNamesCorrect()
       },
     };
 
-    var wrapper = new PythonNodeWrapper<IEnumerable<SimpleRowSchema>, IEnumerable<SimpleRowSchema>>(
+    var wrapper = new PythonStepWrapper<IEnumerable<SimpleRowSchema>, IEnumerable<SimpleRowSchema>>(
       _executor,
       "_Fixtures.tabular_nodes",
       "passthrough"
diff --git a/tests/Flowthru.Extensions.Python.Tests/Surface/ServiceBuilderIntegrationTests.cs b/tests/Flowthru.Extensions.Python.Tests/Surface/ServiceBuilderIntegrationTests.cs
index 07d329b9..20301d65 100644
--- a/tests/Flowthru.Extensions.Python.Tests/Surface/ServiceBuilderIntegrationTests.cs
+++ b/tests/Flowthru.Extensions.Python.Tests/Surface/ServiceBuilderIntegrationTests.cs
@@ -1,5 +1,6 @@
 using Flowthru.Extensions.Python.Execution;
 using Flowthru.Extensions.Python.Services;
+using Flowthru.Flows;
 using Flowthru.Services;
 using Microsoft.Extensions.DependencyInjection;
 
@@ -24,8 +25,8 @@ public void UsePython_WithDefaultConfiguration_RegistersServices()
     // Act
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog(new TestCatalog());
-      flowthru.UsePipelines(_ => new Dictionary<string, Pipelines.Pipeline>());
+      flowthru.RegisterCatalog(new TestCatalog());
+      flowthru.RegisterFlows(_ => new Dictionary<string, Flow>());
       flowthru.UsePython();
     });
 
@@ -47,8 +48,8 @@ public void UsePython_WithCustomConfiguration_AppliesOptions()
     // Act
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog(new TestCatalog());
-      flowthru.UsePipelines(_ => new Dictionary<string, Pipelines.Pipeline>());
+      flowthru.RegisterCatalog(new TestCatalog());
+      flowthru.RegisterFlows(_ => new Dictionary<string, Flow>());
       flowthru.UsePython(python =>
       {
         python.ModuleSearchPaths.Add("/custom/path");
@@ -64,5 +65,5 @@ public void UsePython_WithCustomConfiguration_AppliesOptions()
   }
 
   // Minimal test catalog for integration tests
-  private class TestCatalog : Data.DataCatalogBase { }
+  private class TestCatalog : Data.CatalogAbstract { }
 }
diff --git a/tests/Flowthru.Extensions.Python.Tests/Validation/PythonNodeValidationTests.cs b/tests/Flowthru.Extensions.Python.Tests/Validation/PythonNodeValidationTests.cs
index 10301cbe..b24f5d58 100644
--- a/tests/Flowthru.Extensions.Python.Tests/Validation/PythonNodeValidationTests.cs
+++ b/tests/Flowthru.Extensions.Python.Tests/Validation/PythonNodeValidationTests.cs
@@ -1,10 +1,10 @@
 using Flowthru.Data.Validation;
 using Flowthru.Extensions.Python.Execution;
-using Flowthru.Extensions.Python.Nodes;
 using Flowthru.Extensions.Python.Runtime;
+using Flowthru.Extensions.Python.Steps;
 using Flowthru.Extensions.Python.Tests.Schemas;
 using Flowthru.Extensions.Python.Validation;
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using Flowthru.Services;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Logging;
@@ -26,7 +26,7 @@ public class PythonNodeValidationTests
   private PythonRuntime _runtime = null!;
 #pragma warning restore NUnit1032
 
-  private PythonNodeValidator _validator = null!;
+  private PythonStepValidator _validator = null!;
 
   [SetUp]
   public void SetUp()
@@ -46,7 +46,7 @@ public void SetUp()
     _executor = _serviceProvider.GetRequiredService<IPythonExecutor>();
     _runtime = _serviceProvider.GetRequiredService<PythonRuntime>();
 
-    _validator = new PythonNodeValidator(_executor, _runtime);
+    _validator = new PythonStepValidator(_executor, _runtime);
   }
 
   [TearDown]
@@ -69,7 +69,7 @@ public void ValidateRegistration_MissingModule_ThrowsException()
     // Arrange & Act & Assert
     var ex = Assert.Throws<InvalidOperationException>(
       () =>
-        new PythonNodeWrapper<ModelConfigSchema, ModelResultSchema>(
+        new PythonStepWrapper<ModelConfigSchema, ModelResultSchema>(
           _executor,
           "_Fixtures.nonexistent_module",
           "some_function"
@@ -85,7 +85,7 @@ public void ValidateRegistration_MissingFunction_ThrowsException()
     // Arrange & Act & Assert
     var ex = Assert.Throws<InvalidOperationException>(
       () =>
-        new PythonNodeWrapper<ModelConfigSchema, ModelResultSchema>(
+        new PythonStepWrapper<ModelConfigSchema, ModelResultSchema>(
           _executor,
           "_Fixtures.validation_test_nodes",
           "nonexistent_function"
@@ -101,24 +101,24 @@ public void ValidateRegistration_MissingDecorator_ThrowsException()
     // Arrange & Act & Assert
     var ex = Assert.Throws<InvalidOperationException>(
       () =>
-        new PythonNodeWrapper<ModelConfigSchema, ModelConfigSchema>(
+        new PythonStepWrapper<ModelConfigSchema, ModelConfigSchema>(
           _executor,
           "_Fixtures.validation_test_nodes",
-          "missing_decorator_node"
+          "missing_decorator_step"
         )
     );
 
-    Assert.That(ex.Message, Does.Contain("missing required @node decorator"));
+    Assert.That(ex.Message, Does.Contain("missing required @step decorator"));
   }
 
   [Test]
   public void ValidateRegistration_ValidNode_Succeeds()
   {
     // Arrange & Act
-    var wrapper = new PythonNodeWrapper<ModelConfigSchema, ModelResultSchema>(
+    var wrapper = new PythonStepWrapper<ModelConfigSchema, ModelResultSchema>(
       _executor,
       "_Fixtures.validation_test_nodes",
-      "valid_node"
+      "valid_step"
     );
 
     // Assert
@@ -254,7 +254,7 @@ public async Task ValidateAsync_ZeroOutputs_ReportsError()
   public async Task ValidateAsync_ValidNode_NoErrors()
   {
     // Arrange
-    var pipeline = CreateTestPipeline("_Fixtures.validation_test_nodes", "valid_node");
+    var pipeline = CreateTestPipeline("_Fixtures.validation_test_nodes", "valid_step");
 
     // Act
     var result = await _validator.ValidateAsync(pipeline, CancellationToken.None);
@@ -268,7 +268,7 @@ public async Task ValidateAsync_ValidNode_NoErrors()
   public async Task ValidateAsync_NonPythonNode_Skipped()
   {
     // Arrange - empty pipeline with no Python nodes
-    var pipeline = new Pipeline();
+    var pipeline = new Flow();
 
     // Act
     var result = await _validator.ValidateAsync(pipeline, CancellationToken.None);
@@ -284,35 +284,35 @@ public async Task ValidateAsync_NonPythonNode_Skipped()
   /// <summary>
   /// Creates a minimal test pipeline with a single Python node.
   /// </summary>
-  private Pipeline CreateTestPipeline(string moduleName, string functionName)
+  private Flow CreateTestPipeline(string moduleName, string functionName)
   {
-    var pipeline = new Pipeline();
+    var pipeline = new Flow();
 
     // Create Python node wrapper
-    var wrapper = new PythonNodeWrapper<ModelConfigSchema, ModelResultSchema>(
+    var wrapper = new PythonStepWrapper<ModelConfigSchema, ModelResultSchema>(
       _executor,
       moduleName,
       functionName
     );
 
     // Create a PipelineNode using the public constructor
-    var pipelineNode = new Flowthru.Pipelines.PipelineNode(
+    var pipelineNode = new Flowthru.Flows.FlowStep(
       label: "python_node",
       description: $"Test Python node: {moduleName}.{functionName}",
-      node: wrapper.GetTransform(),
-      inputs: Array.Empty<Data.ICatalogEntry>(),
-      outputs: Array.Empty<Data.ICatalogEntry>()
+      step: wrapper.GetTransform(),
+      inputs: Array.Empty<Data.IItem>(),
+      outputs: Array.Empty<Data.IItem>()
     );
 
-    // Use reflection to access internal AddNode method for testing
-    var addNodeMethod = typeof(Pipeline).GetMethod(
-      "AddNode",
+    // Use reflection to access internal AddStep method for testing
+    var addNodeMethod = typeof(Flow).GetMethod(
+      "AddStep",
       System.Reflection.BindingFlags.NonPublic | System.Reflection.BindingFlags.Instance
     );
 
     if (addNodeMethod == null)
     {
-      throw new InvalidOperationException("Could not find Pipeline.AddNode method via reflection");
+      throw new InvalidOperationException("Could not find Pipeline.AddStep method via reflection");
     }
 
     addNodeMethod.Invoke(pipeline, new object[] { pipelineNode });
diff --git a/tests/Flowthru.Extensions.Python.Tests/_Fixtures/scalar_nodes.py b/tests/Flowthru.Extensions.Python.Tests/_Fixtures/scalar_nodes.py
index a08a02ff..56a6d321 100644
--- a/tests/Flowthru.Extensions.Python.Tests/_Fixtures/scalar_nodes.py
+++ b/tests/Flowthru.Extensions.Python.Tests/_Fixtures/scalar_nodes.py
@@ -1,14 +1,14 @@
 """
-Test module for Phase 2 scalar Python node integration.
+Test module for Phase 2 scalar Python step integration.
 
 This module simulates a simple model training function that takes
 a configuration object and returns a result object.
 """
 
-from flowthru import node
+from flowthru import step
 
 
-@node(inputs=["ModelConfigSchema"], outputs=["ModelResultSchema"])
+@step(inputs=["ModelConfigSchema"], outputs=["ModelResultSchema"])
 def train_model(config):
     """
     Simulates model training by computing accuracy based on config parameters.
@@ -37,7 +37,7 @@ def train_model(config):
     }
 
 
-@node(inputs=["ModelConfigSchema"], outputs=["ModelConfigSchema"])
+@step(inputs=["ModelConfigSchema"], outputs=["ModelConfigSchema"])
 def identity(value):
     """
     Identity function for testing simple pass-through.
@@ -51,7 +51,7 @@ def identity(value):
     return value
 
 
-@node(inputs=["ModelConfigSchema"], outputs=["ModelConfigSchema"])
+@step(inputs=["ModelConfigSchema"], outputs=["ModelConfigSchema"])
 def double_iterations(config):
     """
     Doubles the iteration count in a config.
@@ -67,12 +67,12 @@ def double_iterations(config):
     return result
 
 
-@node(inputs=["int", "int"], outputs=["MetricsReportSchema"])
+@step(inputs=["int", "int"], outputs=["MetricsReportSchema"])
 def calculate_metrics(correct, total):
     """
     Calculates metrics and returns a dictionary with snake_case keys.
 
-    This simulates a Python node returning a dictionary to a single-object
+    This simulates a Python step returning a dictionary to a single-object
     catalog entry with SerializedLabel attributes.
 
     Args:
diff --git a/tests/Flowthru.Extensions.Python.Tests/_Fixtures/tabular_nodes.py b/tests/Flowthru.Extensions.Python.Tests/_Fixtures/tabular_nodes.py
index 572dcb7e..24d66e41 100644
--- a/tests/Flowthru.Extensions.Python.Tests/_Fixtures/tabular_nodes.py
+++ b/tests/Flowthru.Extensions.Python.Tests/_Fixtures/tabular_nodes.py
@@ -1,14 +1,14 @@
 """
-Test fixtures for Phase 3 tabular (DataFrame) Python node integration.
+Test fixtures for Phase 3 tabular (DataFrame) Python step integration.
 
 This module provides test functions that receive and return pandas DataFrames,
 demonstrating Arrow marshalling for tabular data.
 """
 
-from flowthru import node
+from flowthru import step
 
 
-@node(inputs=["SimpleRowSchema"], outputs=["SimpleRowSchema"])
+@step(inputs=["SimpleRowSchema"], outputs=["SimpleRowSchema"])
 def passthrough(df):
     """
     Identity function for round-trip testing.
@@ -22,7 +22,7 @@ def passthrough(df):
     return df
 
 
-@node(inputs=["SimpleRowSchema"], outputs=["SimpleRowSchema"])
+@step(inputs=["SimpleRowSchema"], outputs=["SimpleRowSchema"])
 def transform_simple(df):
     """
     Transform function that adds a computed column and filters rows.
@@ -36,7 +36,7 @@ def transform_simple(df):
     return df.assign(computed=lambda d: d["value"] * 2).query("value > 0")
 
 
-@node(inputs=["SimpleRowSchema"], outputs=["SimpleRowSchema"])
+@step(inputs=["SimpleRowSchema"], outputs=["SimpleRowSchema"])
 def filter_rows(df):
     """
     Filter DataFrame to only rows where value > 50.
@@ -50,7 +50,7 @@ def filter_rows(df):
     return df[df["value"] > 50].reset_index(drop=True)
 
 
-@node(inputs=["SimpleRowSchema"], outputs=["SimpleRowSchema"])
+@step(inputs=["SimpleRowSchema"], outputs=["SimpleRowSchema"])
 def rename_columns(df):
     """
     Rename columns in DataFrame (for schema validation testing).
@@ -64,7 +64,7 @@ def rename_columns(df):
     return df.rename(columns={"name": "label"})
 
 
-@node(inputs=["SimpleRowSchema"], outputs=["SimpleRowSchema"])
+@step(inputs=["SimpleRowSchema"], outputs=["SimpleRowSchema"])
 def add_computed_column(df):
     """
     Add a computed column based on existing data.
@@ -78,7 +78,7 @@ def add_computed_column(df):
     return df.assign(double_value=lambda d: d["value"] * 2)
 
 
-@node(inputs=["SimpleRowSchema"], outputs=["SimpleRowSchema"])
+@step(inputs=["SimpleRowSchema"], outputs=["SimpleRowSchema"])
 def aggregate_data(df):
     """
     Aggregate DataFrame by computing summary statistics.
diff --git a/tests/Flowthru.Extensions.Python.Tests/_Fixtures/validation_test_nodes.py b/tests/Flowthru.Extensions.Python.Tests/_Fixtures/validation_test_nodes.py
index 1e4a61f8..113ba184 100644
--- a/tests/Flowthru.Extensions.Python.Tests/_Fixtures/validation_test_nodes.py
+++ b/tests/Flowthru.Extensions.Python.Tests/_Fixtures/validation_test_nodes.py
@@ -1,18 +1,18 @@
 """
 Test fixtures for Phase 4 validation testing.
 
-This module contains deliberately malformed nodes to test validation error detection.
+This module contains deliberately malformed steps to test validation error detection.
 """
 
-from flowthru import node
+from flowthru import step
 
 
-# ─── Valid nodes for baseline testing ───────────────────────────────────
+# ─── Valid steps for baseline testing ───────────────────────────────────
 
 
-@node(inputs=["ModelConfigSchema"], outputs=["ModelResultSchema"])
-def valid_node(config):
-    """A properly decorated node for baseline testing."""
+@step(inputs=["ModelConfigSchema"], outputs=["ModelResultSchema"])
+def valid_step(config):
+    """A properly decorated step for baseline testing."""
     return {
         "Accuracy": 0.95,
         "Loss": 0.05,
@@ -24,15 +24,15 @@ def valid_node(config):
 # ─── Missing decorator (caught at registration time) ────────────────────
 
 
-def missing_decorator_node(config):
-    """Node without @node decorator - should fail registration-time validation."""
+def missing_decorator_step(config):
+    """Node without @step decorator - should fail registration-time validation."""
     return config
 
 
 # ─── Schema mismatch scenarios (caught at pre-flight) ───────────────────
 
 
-@node(inputs=["WrongInputSchema"], outputs=["ModelResultSchema"])
+@step(inputs=["WrongInputSchema"], outputs=["ModelResultSchema"])
 def wrong_input_schema(config):
     """Decorator declares wrong input schema."""
     return {
@@ -43,7 +43,7 @@ def wrong_input_schema(config):
     }
 
 
-@node(inputs=["ModelConfigSchema"], outputs=["WrongOutputSchema"])
+@step(inputs=["ModelConfigSchema"], outputs=["WrongOutputSchema"])
 def wrong_output_schema(config):
     """Decorator declares wrong output schema."""
     return {
@@ -54,7 +54,7 @@ def wrong_output_schema(config):
     }
 
 
-@node(
+@step(
     inputs=["ModelConfigSchema", "ExtraInputSchema"],
     outputs=["ModelResultSchema"]
 )
@@ -68,7 +68,7 @@ def too_many_inputs(config):
     }
 
 
-@node(
+@step(
     inputs=["ModelConfigSchema"],
     outputs=["ModelResultSchema", "ExtraOutputSchema"],
 )
@@ -82,7 +82,7 @@ def too_many_outputs(config):
     }
 
 
-@node(inputs=[], outputs=["ModelResultSchema"])
+@step(inputs=[], outputs=["ModelResultSchema"])
 def zero_inputs(config):
     """Decorator declares no input schemas."""
     return {
@@ -93,7 +93,7 @@ def zero_inputs(config):
     }
 
 
-@node(inputs=["ModelConfigSchema"], outputs=[])
+@step(inputs=["ModelConfigSchema"], outputs=[])
 def zero_outputs(config):
     """Decorator declares no output schemas."""
     return {
diff --git a/tests/Flowthru.Tests.Common/CompilationTestHelper.cs b/tests/Flowthru.Tests.Common/CompilationTestHelper.cs
index a4dfc7f5..8cade3a3 100644
--- a/tests/Flowthru.Tests.Common/CompilationTestHelper.cs
+++ b/tests/Flowthru.Tests.Common/CompilationTestHelper.cs
@@ -47,7 +47,7 @@ params Type[] additionalAssemblies
     {
       // Add Flowthru assembly reference
       references.Add(
-        MetadataReference.CreateFromFile(typeof(Data.DataCatalogBase).Assembly.Location)
+        MetadataReference.CreateFromFile(typeof(Data.CatalogAbstract).Assembly.Location)
       );
 
       // Add LanguageExt for Flowthru dependencies
diff --git a/tests/Flowthru.Tests.Common/GeneratorTestHelper.cs b/tests/Flowthru.Tests.Common/GeneratorTestHelper.cs
index 1c693fc4..0e53b7a0 100644
--- a/tests/Flowthru.Tests.Common/GeneratorTestHelper.cs
+++ b/tests/Flowthru.Tests.Common/GeneratorTestHelper.cs
@@ -35,7 +35,7 @@ public static GeneratorTestResult RunSchemaGenerator(string source)
 
     // Flowthru assembly — so the marker interfaces resolve
     references.Add(
-      MetadataReference.CreateFromFile(typeof(Data.DataCatalogBase).Assembly.Location)
+      MetadataReference.CreateFromFile(typeof(Data.CatalogAbstract).Assembly.Location)
     );
 
     var compilation = CSharpCompilation.Create(
diff --git a/tests/Flowthru.Tests.Examples/_Infrastructure/ExampleTestRunner.cs b/tests/Flowthru.Tests.Examples/_Infrastructure/ExampleTestRunner.cs
index a1d00760..6dcd7e62 100644
--- a/tests/Flowthru.Tests.Examples/_Infrastructure/ExampleTestRunner.cs
+++ b/tests/Flowthru.Tests.Examples/_Infrastructure/ExampleTestRunner.cs
@@ -48,7 +48,7 @@ public async Task RunAsync()
       var flowthruService = services.GetRequiredService<IFlowthruService>();
 
       using var cts = new CancellationTokenSource();
-      var executionTask = flowthruService.ExecutePipelineAsync(cancellationToken: cts.Token);
+      var executionTask = flowthruService.ExecuteFlowAsync(cancellationToken: cts.Token);
       var timeoutTask = Task.Delay(_timeout, CancellationToken.None);
 
       var completedTask = await Task.WhenAny(executionTask, timeoutTask);
@@ -90,9 +90,13 @@ public async Task RunAsync()
     finally
     {
       if (services is IAsyncDisposable asyncDisposable)
+      {
         await asyncDisposable.DisposeAsync();
+      }
       else if (services is IDisposable disposable)
+      {
         disposable.Dispose();
+      }
     }
   }
 
@@ -115,9 +119,15 @@ private IServiceProvider BuildServiceProvider()
     {
       0 => null,
       1 when parameters[0].ParameterType == typeof(string) => [_example.ProjectPath],
+      2
+        when parameters[0].ParameterType == typeof(string)
+          && parameters[1].ParameterType == typeof(string) => (object?[])
+        [_example.ProjectPath, _example.OutputPath],
       _ => throw new InvalidOperationException(
         $"ConfigureServices on {_example.EntryPointType.FullName} has an unexpected signature. "
-          + "Expected: IServiceProvider ConfigureServices() or IServiceProvider ConfigureServices(string? basePath)"
+          + "Expected: IServiceProvider ConfigureServices() or "
+          + "IServiceProvider ConfigureServices(string? basePath) or "
+          + "IServiceProvider ConfigureServices(string? basePath, string? outputPath)"
       ),
     };
 
diff --git a/tests/Flowthru.Tests.Templates/TemplateIntegrationTests.cs b/tests/Flowthru.Tests.Templates/TemplateIntegrationTests.cs
index 6daf8507..c45a215f 100644
--- a/tests/Flowthru.Tests.Templates/TemplateIntegrationTests.cs
+++ b/tests/Flowthru.Tests.Templates/TemplateIntegrationTests.cs
@@ -42,9 +42,9 @@ public static void InstallTemplate()
       );
     }
 
-    TestContext.WriteLine($"Installing template from: {_templateInstallPath}");
+    TestContext.Out.WriteLine($"Installing template from: {_templateInstallPath}");
     TemplateInstaller.Install(_templateInstallPath);
-    TestContext.WriteLine("Template installed successfully");
+    TestContext.Out.WriteLine("Template installed successfully");
   }
 
   /// <summary>
@@ -55,9 +55,9 @@ public static void UninstallTemplate()
   {
     if (_templateInstallPath != null)
     {
-      TestContext.WriteLine("Uninstalling template...");
+      TestContext.Out.WriteLine("Uninstalling template...");
       TemplateInstaller.Uninstall(_templateInstallPath);
-      TestContext.WriteLine("Template uninstalled");
+      TestContext.Out.WriteLine("Template uninstalled");
     }
 
     // Clean up test output directory
@@ -67,7 +67,7 @@ public static void UninstallTemplate()
       try
       {
         Directory.Delete(testOutputPath, recursive: true);
-        TestContext.WriteLine($"Cleaned up test output directory: {testOutputPath}");
+        TestContext.Out.WriteLine($"Cleaned up test output directory: {testOutputPath}");
       }
       catch
       {
@@ -86,7 +86,7 @@ public async Task StarterTemplate_GeneratesAndValidatesSuccessfully(TemplateProj
     var runner = new TemplateTestRunner(template);
 
     // Act
-    TestContext.WriteLine($"Testing: {template}");
+    TestContext.Out.WriteLine($"Testing: {template}");
     var result = await runner.GenerateAndRunAsync();
 
     // Assert
@@ -100,35 +100,35 @@ public async Task StarterTemplate_GeneratesAndValidatesSuccessfully(TemplateProj
   /// </summary>
   private static void LogResult(TemplateTestResult result)
   {
-    TestContext.WriteLine($"Duration: {result.Duration.TotalSeconds:F2}s");
-    TestContext.WriteLine($"Exit Code: {result.ExitCode}");
+    TestContext.Out.WriteLine($"Duration: {result.Duration.TotalSeconds:F2}s");
+    TestContext.Out.WriteLine($"Exit Code: {result.ExitCode}");
 
     if (!string.IsNullOrEmpty(result.DiagnosticMessage))
     {
-      TestContext.WriteLine($"Diagnostic: {result.DiagnosticMessage}");
+      TestContext.Out.WriteLine($"Diagnostic: {result.DiagnosticMessage}");
     }
 
     if (result.Exception != null)
     {
-      TestContext.WriteLine("--- Exception Details ---");
-      TestContext.WriteLine($"Type: {result.Exception.GetType().FullName}");
-      TestContext.WriteLine($"Message: {result.Exception.Message}");
-      TestContext.WriteLine($"StackTrace:\n{result.Exception.StackTrace}");
-      TestContext.WriteLine("--- End Exception Details ---");
+      TestContext.Out.WriteLine("--- Exception Details ---");
+      TestContext.Out.WriteLine($"Type: {result.Exception.GetType().FullName}");
+      TestContext.Out.WriteLine($"Message: {result.Exception.Message}");
+      TestContext.Out.WriteLine($"StackTrace:\n{result.Exception.StackTrace}");
+      TestContext.Out.WriteLine("--- End Exception Details ---");
     }
 
     if (!string.IsNullOrEmpty(result.StandardOutput))
     {
-      TestContext.WriteLine("--- Standard Output ---");
-      TestContext.WriteLine(result.StandardOutput);
-      TestContext.WriteLine("--- End Standard Output ---");
+      TestContext.Out.WriteLine("--- Standard Output ---");
+      TestContext.Out.WriteLine(result.StandardOutput);
+      TestContext.Out.WriteLine("--- End Standard Output ---");
     }
 
     if (!string.IsNullOrEmpty(result.StandardError))
     {
-      TestContext.WriteLine("--- Standard Error ---");
-      TestContext.WriteLine(result.StandardError);
-      TestContext.WriteLine("--- End Standard Error ---");
+      TestContext.Out.WriteLine("--- Standard Error ---");
+      TestContext.Out.WriteLine(result.StandardError);
+      TestContext.Out.WriteLine("--- End Standard Error ---");
     }
   }
 }
diff --git a/tests/Flowthru.Tests.Templates/_Infrastructure/TemplateDiscovery.cs b/tests/Flowthru.Tests.Templates/_Infrastructure/TemplateDiscovery.cs
index 05dc8508..6388d443 100644
--- a/tests/Flowthru.Tests.Templates/_Infrastructure/TemplateDiscovery.cs
+++ b/tests/Flowthru.Tests.Templates/_Infrastructure/TemplateDiscovery.cs
@@ -55,7 +55,7 @@ public static IEnumerable<TemplateProject> DiscoverTemplates()
         StarterName = shortName,
         ProjectName = projectName,
         GeneratedPath = Path.Combine(testOutputPath, projectName),
-        PipelineName = null,
+        FlowName = null,
       };
     }
 
diff --git a/tests/Flowthru.Tests.Templates/_Infrastructure/TemplateProject.cs b/tests/Flowthru.Tests.Templates/_Infrastructure/TemplateProject.cs
index 621251a8..46e8f47d 100644
--- a/tests/Flowthru.Tests.Templates/_Infrastructure/TemplateProject.cs
+++ b/tests/Flowthru.Tests.Templates/_Infrastructure/TemplateProject.cs
@@ -24,11 +24,10 @@ public sealed record TemplateProject
   /// Gets the pipeline name to execute for testing.
   /// If null, only validates template generation and compilation.
   /// </summary>
-  public string? PipelineName { get; init; }
+  public string? FlowName { get; init; }
 
   /// <summary>
   /// Returns a string representation for test display.
   /// </summary>
-  public override string ToString() =>
-    PipelineName != null ? $"{StarterName}/{PipelineName}" : StarterName;
+  public override string ToString() => FlowName != null ? $"{StarterName}/{FlowName}" : StarterName;
 }
diff --git a/tests/Flowthru.Tests.Templates/_Infrastructure/TemplateTestRunner.cs b/tests/Flowthru.Tests.Templates/_Infrastructure/TemplateTestRunner.cs
index bb729b5b..4ce80456 100644
--- a/tests/Flowthru.Tests.Templates/_Infrastructure/TemplateTestRunner.cs
+++ b/tests/Flowthru.Tests.Templates/_Infrastructure/TemplateTestRunner.cs
@@ -187,10 +187,10 @@ public async Task<TemplateTestResult> GenerateAndRunAsync()
         );
       }
 
-      // Step 4: Run pipeline (or all pipelines if PipelineName is null) in dry-run mode
+      // Step 4: Run pipeline (or all pipelines if FlowName is null) in dry-run mode
       var runCommand =
-        _project.PipelineName != null
-          ? $"run --no-build -- {_project.PipelineName} --dry-run"
+        _project.FlowName != null
+          ? $"run --no-build -- {_project.FlowName} --dry-run"
           : "run --no-build -- --dry-run";
 
       var runResult = await RunProcessAsync(
diff --git a/tests/Flowthru.Tests/01_Compilation/TypeSafety/SchemaInterfaceGeneratorTests.cs b/tests/Flowthru.Tests/01_Compilation/TypeSafety/SchemaInterfaceGeneratorTests.cs
index 1f7aa708..e7c1b89e 100644
--- a/tests/Flowthru.Tests/01_Compilation/TypeSafety/SchemaInterfaceGeneratorTests.cs
+++ b/tests/Flowthru.Tests/01_Compilation/TypeSafety/SchemaInterfaceGeneratorTests.cs
@@ -385,7 +385,7 @@ public partial record ManuallyAnnotated : IFlatSchema, ITextSerializable
   }
 
   // ─────────────────────────────────────────────────────────────
-  // Integration: generated schema works with CatalogEntries
+  // Integration: generated schema works with Items
   // ─────────────────────────────────────────────────────────────
 
   [Test]
diff --git a/tests/Flowthru.Tests/02_Validation/GraphConstruction/CircularDependencyTests.cs b/tests/Flowthru.Tests/02_Validation/GraphConstruction/CircularDependencyTests.cs
index 170e234a..a096f4b2 100644
--- a/tests/Flowthru.Tests/02_Validation/GraphConstruction/CircularDependencyTests.cs
+++ b/tests/Flowthru.Tests/02_Validation/GraphConstruction/CircularDependencyTests.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using Flowthru.Tests.Fixtures.TestCatalogs;
 using Flowthru.Tests.Fixtures.TestNodes;
 
@@ -26,21 +26,21 @@ public void Build_WhenSimpleCircle_ThrowsInvalidOperationException()
     // ===========
     // Arrange: Create a circular dependency A → B → C → A
     // ===========
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeA",
         transform: PassthroughNode.Create(),
         input: _catalog.Input,
         output: _catalog.StepOne
       );
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeB",
         transform: PassthroughNode.Create(),
         input: _catalog.StepOne,
         output: _catalog.StepTwo
       );
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeC",
         transform: PassthroughNode.Create(),
         input: _catalog.StepTwo,
@@ -67,9 +67,9 @@ public void Build_WhenSelfLoop_IsAllowed()
     // ===========
     // Note: Self-loops are currently allowed in the implementation
     // as they can represent update-in-place operations
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "SelfLoop",
         transform: PassthroughNode.Create(),
         input: _catalog.Input,
@@ -90,15 +90,15 @@ public void Build_WhenTwoNodeCircle_ThrowsInvalidOperationException()
     // ===========
     // Arrange: A → B → A
     // ===========
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeA",
         transform: PassthroughNode.Create(),
         input: _catalog.Input,
         output: _catalog.StepOne
       );
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeB",
         transform: PassthroughNode.Create(),
         input: _catalog.StepOne,
@@ -118,21 +118,21 @@ public void Build_WhenNoCycle_SucceedsWithoutError()
     // ===========
     // Arrange: Linear pipeline A → B → C
     // ===========
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeA",
         transform: PassthroughNode.Create(),
         input: _catalog.Input,
         output: _catalog.StepOne
       );
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeB",
         transform: PassthroughNode.Create(),
         input: _catalog.StepOne,
         output: _catalog.StepTwo
       );
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeC",
         transform: PassthroughNode.Create(),
         input: _catalog.StepTwo,
diff --git a/tests/Flowthru.Tests/02_Validation/GraphConstruction/MultipleWritersTests.cs b/tests/Flowthru.Tests/02_Validation/GraphConstruction/MultipleWritersTests.cs
index e4813211..a4b46666 100644
--- a/tests/Flowthru.Tests/02_Validation/GraphConstruction/MultipleWritersTests.cs
+++ b/tests/Flowthru.Tests/02_Validation/GraphConstruction/MultipleWritersTests.cs
@@ -1,4 +1,4 @@
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using Flowthru.Tests.Fixtures.TestCatalogs;
 using Flowthru.Tests.Fixtures.TestNodes;
 
@@ -26,15 +26,15 @@ public void Build_WhenTwoNodesWriteSameOutput_ThrowsInvalidOperationException()
     // ===========
     // Arrange: Two nodes both write to StepOne
     // ===========
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeA",
         transform: PassthroughNode.Create(),
         input: _catalog.Input,
         output: _catalog.StepOne
       );
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeB",
         transform: PassthroughNode.Create(),
         input: _catalog.Input,
@@ -59,21 +59,21 @@ public void Build_WhenThreeNodesWriteSameOutput_ThrowsInvalidOperationException(
     // ===========
     // Arrange: Three nodes all write to Output
     // ===========
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeA",
         transform: PassthroughNode.Create(),
         input: _catalog.Input,
         output: _catalog.Output
       );
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeB",
         transform: PassthroughNode.Create(),
         input: _catalog.StepOne,
         output: _catalog.Output
       );
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeC",
         transform: PassthroughNode.Create(),
         input: _catalog.StepTwo,
@@ -93,21 +93,21 @@ public void Build_WhenEachNodeWritesDifferentOutput_SucceedsWithoutError()
     // ===========
     // Arrange: Each node writes to a unique output
     // ===========
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeA",
         transform: PassthroughNode.Create(),
         input: _catalog.Input,
         output: _catalog.StepOne
       );
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeB",
         transform: PassthroughNode.Create(),
         input: _catalog.Input,
         output: _catalog.StepTwo
       );
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeC",
         transform: PassthroughNode.Create(),
         input: _catalog.Input,
@@ -128,21 +128,21 @@ public void Build_WhenNodeReadsWhatAnotherWrites_SucceedsWithoutError()
     // ===========
     // Arrange: Linear pipeline where each node reads from previous node's output
     // ===========
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeA",
         transform: PassthroughNode.Create(),
         input: _catalog.Input,
         output: _catalog.StepOne
       );
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeB",
         transform: PassthroughNode.Create(),
         input: _catalog.StepOne,
         output: _catalog.StepTwo
       );
-      builder.AddNode(
+      builder.AddStep(
         label: "NodeC",
         transform: PassthroughNode.Create(),
         input: _catalog.StepTwo,
diff --git a/tests/Flowthru.Tests/03_Execution/CancellationTests.cs b/tests/Flowthru.Tests/03_Execution/CancellationTests.cs
index 5b5eef68..d74bfe1e 100644
--- a/tests/Flowthru.Tests/03_Execution/CancellationTests.cs
+++ b/tests/Flowthru.Tests/03_Execution/CancellationTests.cs
@@ -4,7 +4,7 @@
 using Flowthru.Data;
 using Flowthru.Data.Storage;
 using Flowthru.Effects;
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using Flowthru.Tests.Fixtures.TestCatalogs;
 using Flowthru.Tests.Fixtures.TestNodes;
 
@@ -36,9 +36,9 @@ public async Task RunAsync_WithAlreadyCancelledToken_ThrowsOperationCanceledExce
     };
     await catalog.Input.Save(testData).Run();
 
-    Pipeline pipeline = PipelineBuilder.CreatePipeline(builder =>
+    Flow pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Passthrough",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -78,9 +78,9 @@ public async Task RunAsync_WithValidToken_CompletesSuccessfully()
     };
     await catalog.Input.Save(testData).Run();
 
-    Pipeline pipeline = PipelineBuilder.CreatePipeline(builder =>
+    Flow pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Increment",
         transform: IncrementNode.Create(),
         input: catalog.Input,
@@ -125,10 +125,10 @@ public async Task RunAsync_CancelledBetweenNodes_ThrowsOperationCanceledExceptio
     };
     await catalog.Input.Save(testData).Run();
 
-    Pipeline pipeline = PipelineBuilder.CreatePipeline(builder =>
+    Flow pipeline = FlowBuilder.CreateFlow(builder =>
     {
       // First node: quick passthrough
-      builder.AddNode(
+      builder.AddStep(
         label: "FirstNode",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -136,7 +136,7 @@ public async Task RunAsync_CancelledBetweenNodes_ThrowsOperationCanceledExceptio
       );
 
       // Second node: delayed
-      builder.AddNode(
+      builder.AddStep(
         label: "SecondNode",
         transform: DelayedNode.Create(TimeSpan.FromSeconds(10)),
         input: catalog.StepOne,
@@ -183,10 +183,10 @@ public async Task RunAsync_CancelledDuringNodeExecution_ThrowsOperationCanceledE
     };
     await catalog.Input.Save(testData).Run();
 
-    Pipeline pipeline = PipelineBuilder.CreatePipeline(builder =>
+    Flow pipeline = FlowBuilder.CreateFlow(builder =>
     {
       // Node with long delay
-      builder.AddNode(
+      builder.AddStep(
         label: "LongRunningNode",
         transform: DelayedNode.Create(TimeSpan.FromSeconds(10)),
         input: catalog.Input,
@@ -225,8 +225,8 @@ public async Task RunAsync_CancelledDuringIOLoad_ThrowsOperationCanceledExceptio
     var fastAdapter = new MemoryStorageAdapter<IEnumerable<TestData>>();
     var catalog = new TestCatalog();
 
-    catalog.SlowData = new CatalogEntry<IEnumerable<TestData>>("SlowData", slowAdapter);
-    catalog.FastData = new CatalogEntry<IEnumerable<TestData>>("FastData", fastAdapter);
+    catalog.SlowData = new Item<IEnumerable<TestData>>("SlowData", slowAdapter);
+    catalog.FastData = new Item<IEnumerable<TestData>>("FastData", fastAdapter);
 
     var testData = new[]
     {
@@ -241,9 +241,9 @@ public async Task RunAsync_CancelledDuringIOLoad_ThrowsOperationCanceledExceptio
     // Seed the slow adapter with data
     slowAdapter.SetData(testData);
 
-    Pipeline pipeline = PipelineBuilder.CreatePipeline(builder =>
+    Flow pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "LoadFromSlowStorage",
         transform: PassthroughNode.Create(),
         input: catalog.SlowData,
@@ -281,8 +281,8 @@ public async Task RunAsync_CancelledDuringIOSave_ThrowsOperationCanceledExceptio
     var fastAdapter = new MemoryStorageAdapter<IEnumerable<TestData>>();
     var catalog = new TestCatalog();
 
-    catalog.FastData = new CatalogEntry<IEnumerable<TestData>>("FastData", fastAdapter);
-    catalog.SlowData = new CatalogEntry<IEnumerable<TestData>>("SlowData", slowAdapter);
+    catalog.FastData = new Item<IEnumerable<TestData>>("FastData", fastAdapter);
+    catalog.SlowData = new Item<IEnumerable<TestData>>("SlowData", slowAdapter);
 
     var testData = new[]
     {
@@ -295,9 +295,9 @@ public async Task RunAsync_CancelledDuringIOSave_ThrowsOperationCanceledExceptio
     };
     await catalog.FastData.Save(testData).Run();
 
-    Pipeline pipeline = PipelineBuilder.CreatePipeline(builder =>
+    Flow pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "SaveToSlowStorage",
         transform: PassthroughNode.Create(),
         input: catalog.FastData,
@@ -328,10 +328,10 @@ public async Task RunAsync_CancelledDuringIOSave_ThrowsOperationCanceledExceptio
   /// <summary>
   /// Custom test catalog with additional properties for slow storage adapters.
   /// </summary>
-  private class TestCatalog : DataCatalogBase
+  private class TestCatalog : CatalogAbstract
   {
-    public CatalogEntry<IEnumerable<TestData>> SlowData { get; set; } = null!;
-    public CatalogEntry<IEnumerable<TestData>> FastData { get; set; } = null!;
+    public Item<IEnumerable<TestData>> SlowData { get; set; } = null!;
+    public Item<IEnumerable<TestData>> FastData { get; set; } = null!;
   }
 
   /// <summary>
diff --git a/tests/Flowthru.Tests/03_Execution/NodeExecution/FanInNodeTests.cs b/tests/Flowthru.Tests/03_Execution/NodeExecution/FanInNodeTests.cs
index 2e57b283..b2052ede 100644
--- a/tests/Flowthru.Tests/03_Execution/NodeExecution/FanInNodeTests.cs
+++ b/tests/Flowthru.Tests/03_Execution/NodeExecution/FanInNodeTests.cs
@@ -1,5 +1,5 @@
 using Flowthru.Data;
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using Flowthru.Tests.Fixtures.TestCatalogs;
 
 namespace Flowthru.Tests.Execution.NodeExecution;
@@ -18,7 +18,7 @@ public class FanInNodeTests
   // ─────────────────────────────────────────────────────────────────────────
 
   [Test]
-  public async Task AddNode_FanIn_ReceivesAllInputCollections()
+  public async Task AddStep_FanIn_ReceivesAllInputCollections()
   {
     // Arrange — three shards, each with one row of data
     var shardA = new ShardCatalog("A");
@@ -63,19 +63,19 @@ await shardC
       )
       .Run();
 
-    var inputs = new List<ICatalogEntry<IEnumerable<TestData>>>
+    var inputs = new List<IItem<IEnumerable<TestData>>>
     {
       shardA.ShardData,
       shardB.ShardData,
       shardC.ShardData,
     };
 
-    var pipeline = PipelineBuilder.CreatePipeline(b =>
-      b.AddNode(
+    var pipeline = FlowBuilder.CreateFlow(b =>
+      b.AddStep(
         label: "Append",
         inputs: inputs,
         output: master.AllData,
-        node: batches => batches.SelectMany(x => x)
+        step: batches => batches.SelectMany(x => x)
       )
     );
 
@@ -91,7 +91,7 @@ await shardC
   }
 
   [Test]
-  public async Task AddNode_FanIn_SingleInput_BehavesLikeRegularNode()
+  public async Task AddStep_FanIn_SingleInput_BehavesLikeRegularNode()
   {
     // Edge case: fan-in with exactly one input should still work correctly.
     var shard = new ShardCatalog("only");
@@ -108,12 +108,12 @@ public async Task AddNode_FanIn_SingleInput_BehavesLikeRegularNode()
     };
     await shard.ShardData.Save(testData).Run();
 
-    var pipeline = PipelineBuilder.CreatePipeline(b =>
-      b.AddNode(
+    var pipeline = FlowBuilder.CreateFlow(b =>
+      b.AddStep(
         label: "PassthroughFanIn",
         inputs: [shard.ShardData],
         output: master.AllData,
-        node: batches => batches.SelectMany(x => x)
+        step: batches => batches.SelectMany(x => x)
       )
     );
 
@@ -126,7 +126,7 @@ public async Task AddNode_FanIn_SingleInput_BehavesLikeRegularNode()
   }
 
   [Test]
-  public async Task AddNode_FanIn_DagResolvesEdges_WhenUpstreamPipelineProducesShards()
+  public async Task AddStep_FanIn_DagResolvesEdges_WhenUpstreamPipelineProducesShards()
   {
     // Arrange — one upstream pipeline writes to two shards; fan-in pipeline merges them.
     var shardA = new ShardCatalog("dag_a");
@@ -154,15 +154,15 @@ await source
       .Run();
 
     // Pipeline 1: distribute input across the two shards
-    var distributor = PipelineBuilder.CreatePipeline(b =>
+    var distributor = FlowBuilder.CreateFlow(b =>
     {
-      b.AddNode(
+      b.AddStep(
         label: "ToShardA",
         transform: (IEnumerable<TestData> data) => data.Where(x => x.Id == 10),
         input: source.Input,
         output: shardA.ShardData
       );
-      b.AddNode(
+      b.AddStep(
         label: "ToShardB",
         transform: (IEnumerable<TestData> data) => data.Where(x => x.Id == 20),
         input: source.Input,
@@ -171,17 +171,17 @@ await source
     });
 
     // Pipeline 2: merge both shards into master
-    var merger = PipelineBuilder.CreatePipeline(b =>
-      b.AddNode(
+    var merger = FlowBuilder.CreateFlow(b =>
+      b.AddStep(
         label: "Merge",
         inputs: [shardA.ShardData, shardB.ShardData],
         output: master.AllData,
-        node: batches => batches.SelectMany(x => x)
+        step: batches => batches.SelectMany(x => x)
       )
     );
 
-    var merged = Pipeline.Merge(
-      new Dictionary<string, Pipeline> { ["distributor"] = distributor, ["merger"] = merger }
+    var merged = Flow.Merge(
+      new Dictionary<string, Flow> { ["distributor"] = distributor, ["merger"] = merger }
     );
     merged.Build();
 
diff --git a/tests/Flowthru.Tests/03_Execution/NodeExecution/SingleInputOutputTests.cs b/tests/Flowthru.Tests/03_Execution/NodeExecution/SingleInputOutputTests.cs
index a0d8005a..6acddbc6 100644
--- a/tests/Flowthru.Tests/03_Execution/NodeExecution/SingleInputOutputTests.cs
+++ b/tests/Flowthru.Tests/03_Execution/NodeExecution/SingleInputOutputTests.cs
@@ -1,5 +1,5 @@
 using System.Linq;
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using Flowthru.Tests.Fixtures.TestCatalogs;
 using Flowthru.Tests.Fixtures.TestNodes;
 
@@ -31,9 +31,9 @@ public async Task Execute_WithPassthroughNode_PreservesData()
     };
     await catalog.Input.Save(testData).Run();
 
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Passthrough",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -77,9 +77,9 @@ public async Task Execute_WithIncrementNode_IncrementsId()
     };
     await catalog.Input.Save(testData).Run();
 
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Increment",
         transform: IncrementNode.Create(),
         input: catalog.Input,
@@ -123,9 +123,9 @@ public async Task Execute_WithDoubleValueNode_DoublesValue()
     };
     await catalog.Input.Save(testData).Run();
 
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "DoubleValue",
         transform: DoubleValueNode.Create(),
         input: catalog.Input,
@@ -166,9 +166,9 @@ public async Task Execute_WithFailingNode_ThrowsExpectedException()
     };
     await catalog.Input.Save(testData).Run();
 
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Failing",
         transform: FailingNode.Create(),
         input: catalog.Input,
diff --git a/tests/Flowthru.Tests/04_Services/FlowthruServiceTests.cs b/tests/Flowthru.Tests/04_Services/FlowthruServiceTests.cs
index 88d19649..5222987c 100644
--- a/tests/Flowthru.Tests/04_Services/FlowthruServiceTests.cs
+++ b/tests/Flowthru.Tests/04_Services/FlowthruServiceTests.cs
@@ -1,7 +1,7 @@
 using Flowthru.Data;
 using Flowthru.Data.Validation;
+using Flowthru.Flows;
 using Flowthru.Meta.Models;
-using Flowthru.Pipelines;
 using Flowthru.Services;
 using Flowthru.Services.Models;
 using Flowthru.Tests.Common;
@@ -45,7 +45,7 @@ public void TearDown()
 
   private IFlowthruService CreateService(
     SimpleThreeNodeCatalog catalog,
-    Dictionary<string, Pipeline> pipelines
+    Dictionary<string, Flow> pipelines
   )
   {
     // Use the public AddFlowthru extension method to create the service
@@ -53,8 +53,8 @@ Dictionary<string, Pipeline> pipelines
     services.AddLogging();
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog(catalog);
-      flowthru.UsePipelines(sp => pipelines);
+      flowthru.RegisterCatalog(catalog);
+      flowthru.RegisterFlows(sp => pipelines);
     });
 
     var serviceProvider = services.BuildServiceProvider();
@@ -65,16 +65,16 @@ Dictionary<string, Pipeline> pipelines
   public void Constructor_WithNullCatalog_ThrowsArgumentNullException()
   {
     // Arrange
-    DataCatalogBase nullCatalog = null!;
+    CatalogAbstract nullCatalog = null!;
 
-    // Act & Assert — UseCatalog(null) must throw immediately, not silently register null
+    // Act & Assert — RegisterCatalog(null) must throw immediately, not silently register null
     var services = new Microsoft.Extensions.DependencyInjection.ServiceCollection();
 
     Assert.Throws<ArgumentNullException>(() =>
     {
       services.AddFlowthru(flowthru =>
       {
-        flowthru.UseCatalog(nullCatalog);
+        flowthru.RegisterCatalog(nullCatalog);
       });
     });
   }
@@ -93,7 +93,7 @@ public void Constructor_WithNullPipelines_ThrowsArgumentNullException()
     {
       services.AddFlowthru(flowthru =>
       {
-        flowthru.UseCatalog(catalog);
+        flowthru.RegisterCatalog(catalog);
         // Don't register pipelines
       });
 
@@ -117,13 +117,13 @@ public void Constructor_WithNullLogger_ThrowsArgumentNullException()
   }
 
   [Test]
-  public void PipelineNames_ReturnsRegisteredPipelines()
+  public void FlowNames_ReturnsRegisteredPipelines()
   {
     // Arrange
     var catalog = new SimpleThreeNodeCatalog();
-    var pipeline1 = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline1 = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Node1",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -131,9 +131,9 @@ public void PipelineNames_ReturnsRegisteredPipelines()
       );
     });
 
-    var pipeline2 = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline2 = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Node2",
         transform: PassthroughNode.Create(),
         input: catalog.StepOne,
@@ -141,7 +141,7 @@ public void PipelineNames_ReturnsRegisteredPipelines()
       );
     });
 
-    var pipelines = new Dictionary<string, Pipeline>
+    var pipelines = new Dictionary<string, Flow>
     {
       ["pipeline1"] = pipeline1,
       ["pipeline2"] = pipeline2,
@@ -150,7 +150,7 @@ public void PipelineNames_ReturnsRegisteredPipelines()
     var service = CreateService(catalog, pipelines);
 
     // Act
-    var names = service.PipelineNames;
+    var names = service.FlowNames;
 
     // Assert
     Assert.That(names, Has.Count.EqualTo(2));
@@ -163,7 +163,7 @@ public void Catalog_ReturnsCatalogInstance()
   {
     // Arrange
     var catalog = new SimpleThreeNodeCatalog();
-    var pipelines = new Dictionary<string, Pipeline>();
+    var pipelines = new Dictionary<string, Flow>();
 
     var service = CreateService(catalog, pipelines);
 
@@ -191,9 +191,9 @@ public async Task ExecutePipelineAsync_WithValidPipeline_ExecutesSuccessfully()
     };
     await catalog.Input.Save(testData).Run();
 
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Process",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -202,17 +202,17 @@ public async Task ExecutePipelineAsync_WithValidPipeline_ExecutesSuccessfully()
     });
 
     pipeline.Name = "test_pipeline";
-    var pipelines = new Dictionary<string, Pipeline> { ["test_pipeline"] = pipeline };
+    var pipelines = new Dictionary<string, Flow> { ["test_pipeline"] = pipeline };
 
     var service = CreateService(catalog, pipelines);
 
     // Act
-    var result = await service.ExecutePipelineAsync(options: null, exportMetadata: false);
+    var result = await service.ExecuteFlowAsync(options: null, exportMetadata: false);
 
     // Assert
     Assert.That(result.Success, Is.True);
     Assert.That(result.IsDryRun, Is.False);
-    Assert.That(result.NodeResults, Has.Count.EqualTo(1));
+    Assert.That(result.StepResults, Has.Count.EqualTo(1));
   }
 
   [Test]
@@ -231,9 +231,9 @@ public async Task ExecutePipelineAsync_WithDryRun_DoesNotExecuteNodes()
     };
     await catalog.Input.Save(testData).Run();
 
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Process",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -241,12 +241,12 @@ public async Task ExecutePipelineAsync_WithDryRun_DoesNotExecuteNodes()
       );
     });
 
-    var pipelines = new Dictionary<string, Pipeline> { ["test_pipeline"] = pipeline };
+    var pipelines = new Dictionary<string, Flow> { ["test_pipeline"] = pipeline };
 
     var service = CreateService(catalog, pipelines);
 
     // Act
-    var result = await service.ExecutePipelineAsync(
+    var result = await service.ExecuteFlowAsync(
       options: new ExecutionOptions { DryRun = true },
       exportMetadata: false
     );
@@ -254,7 +254,7 @@ public async Task ExecutePipelineAsync_WithDryRun_DoesNotExecuteNodes()
     // Assert
     Assert.That(result.Success, Is.True);
     Assert.That(result.IsDryRun, Is.True);
-    Assert.That(result.NodeResults, Is.Empty);
+    Assert.That(result.StepResults, Is.Empty);
 
     // Verify output was not written
     var outputExists = await catalog.Output.Exists().Run();
@@ -267,9 +267,9 @@ public async Task ExecutePipelineAsync_WithStructureOnlyDryRun_SucceedsWithoutDa
     // Arrange — no data seeded; StructureOnly must not probe any data source
     var catalog = new SimpleThreeNodeCatalog();
 
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Process",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -277,11 +277,11 @@ public async Task ExecutePipelineAsync_WithStructureOnlyDryRun_SucceedsWithoutDa
       );
     });
 
-    var pipelines = new Dictionary<string, Pipeline> { ["test_pipeline"] = pipeline };
+    var pipelines = new Dictionary<string, Flow> { ["test_pipeline"] = pipeline };
     var service = CreateService(catalog, pipelines);
 
     // Act
-    var result = await service.ExecutePipelineAsync(
+    var result = await service.ExecuteFlowAsync(
       options: new ExecutionOptions { DryRun = ValidationDepth.StructureOnly },
       exportMetadata: false
     );
@@ -289,7 +289,7 @@ public async Task ExecutePipelineAsync_WithStructureOnlyDryRun_SucceedsWithoutDa
     // Assert
     Assert.That(result.Success, Is.True);
     Assert.That(result.IsDryRun, Is.True);
-    Assert.That(result.NodeResults, Is.Empty);
+    Assert.That(result.StepResults, Is.Empty);
   }
 
   [Test]
@@ -298,9 +298,9 @@ public async Task ExecutePipelineAsync_WithFullDryRun_FailsWithoutData()
     // Arrange — no data seeded; Full depth must surface the missing external input
     var catalog = new SimpleThreeNodeCatalog();
 
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Process",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -308,13 +308,13 @@ public async Task ExecutePipelineAsync_WithFullDryRun_FailsWithoutData()
       );
     });
 
-    var pipelines = new Dictionary<string, Pipeline> { ["test_pipeline"] = pipeline };
+    var pipelines = new Dictionary<string, Flow> { ["test_pipeline"] = pipeline };
     var service = CreateService(catalog, pipelines);
 
     // Act & Assert — Full validation probes external inputs and must fail when absent
     Assert.ThrowsAsync<ValidationException>(
       async () =>
-        await service.ExecutePipelineAsync(
+        await service.ExecuteFlowAsync(
           options: new ExecutionOptions { DryRun = true },
           exportMetadata: false
         )
@@ -337,9 +337,9 @@ public async Task ExecutePipelineAsync_MergesAndExecutesPipelines()
     };
     await catalog.Input.Save(testData).Run();
 
-    var pipeline1 = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline1 = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Node1",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -347,9 +347,9 @@ public async Task ExecutePipelineAsync_MergesAndExecutesPipelines()
       );
     });
 
-    var pipeline2 = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline2 = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Node2",
         transform: PassthroughNode.Create(),
         input: catalog.StepOne,
@@ -357,7 +357,7 @@ public async Task ExecutePipelineAsync_MergesAndExecutesPipelines()
       );
     });
 
-    var pipelines = new Dictionary<string, Pipeline>
+    var pipelines = new Dictionary<string, Flow>
     {
       ["pipeline1"] = pipeline1,
       ["pipeline2"] = pipeline2,
@@ -366,11 +366,11 @@ public async Task ExecutePipelineAsync_MergesAndExecutesPipelines()
     var service = CreateService(catalog, pipelines);
 
     // Act
-    var result = await service.ExecutePipelineAsync();
+    var result = await service.ExecuteFlowAsync();
 
     // Assert
     Assert.That(result.Success, Is.True);
-    Assert.That(result.NodeResults, Has.Count.EqualTo(2));
+    Assert.That(result.StepResults, Has.Count.EqualTo(2));
   }
 
   [Test]
@@ -378,9 +378,9 @@ public void GetPipelineMetadata_WithValidPipeline_ReturnsMetadata()
   {
     // Arrange
     var catalog = new SimpleThreeNodeCatalog();
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Process",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -393,17 +393,17 @@ public void GetPipelineMetadata_WithValidPipeline_ReturnsMetadata()
     pipeline.Description = "Test pipeline description";
 
     pipeline.Build();
-    var pipelines = new Dictionary<string, Pipeline> { ["test_pipeline"] = pipeline };
+    var pipelines = new Dictionary<string, Flow> { ["test_pipeline"] = pipeline };
 
     var service = CreateService(catalog, pipelines);
 
     // Act
-    var metadata = service.GetPipelineMetadata("test_pipeline");
+    var metadata = service.GetFlowMetadata("test_pipeline");
 
     // Assert
     Assert.That(metadata.Name, Is.EqualTo("test_pipeline"));
     Assert.That(metadata.Description, Is.EqualTo("Test pipeline description"));
-    Assert.That(metadata.NodeCount, Is.EqualTo(1));
+    Assert.That(metadata.StepCount, Is.EqualTo(1));
     Assert.That(metadata.LayerCount, Is.EqualTo(1)); // Single layer: node with no dependencies
     Assert.That(metadata.IsBuilt, Is.True);
   }
@@ -413,13 +413,13 @@ public void GetPipelineMetadata_WithNonExistentPipeline_ThrowsKeyNotFoundExcepti
   {
     // Arrange
     var catalog = new SimpleThreeNodeCatalog();
-    var pipelines = new Dictionary<string, Pipeline>();
+    var pipelines = new Dictionary<string, Flow>();
 
     var service = CreateService(catalog, pipelines);
 
     // Act & Assert
     var exception = Assert.Throws<KeyNotFoundException>(
-      () => service.GetPipelineMetadata("NonExistent")
+      () => service.GetFlowMetadata("NonExistent")
     );
 
     Assert.That(exception.Message, Does.Contain("NonExistent"));
@@ -441,9 +441,9 @@ public async Task ValidatePipelineAsync_WithValidInputs_ReturnsSuccess()
     };
     await catalog.Input.Save(testData).Run();
 
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Process",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -451,12 +451,12 @@ public async Task ValidatePipelineAsync_WithValidInputs_ReturnsSuccess()
       );
     });
 
-    var pipelines = new Dictionary<string, Pipeline> { ["test_pipeline"] = pipeline };
+    var pipelines = new Dictionary<string, Flow> { ["test_pipeline"] = pipeline };
 
     var service = CreateService(catalog, pipelines);
 
     // Act
-    var validationResult = await service.ValidatePipelineAsync("test_pipeline");
+    var validationResult = await service.ValidateFlowAsync("test_pipeline");
 
     // Assert
     Assert.That(validationResult.IsValid, Is.True);
@@ -470,9 +470,9 @@ public async Task ValidatePipelineAsync_WithMissingInputs_ReturnsFailure()
     var catalog = new SimpleThreeNodeCatalog();
     // Note: Not saving any data to Input
 
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Process",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -483,12 +483,12 @@ public async Task ValidatePipelineAsync_WithMissingInputs_ReturnsFailure()
     // Configure validation to check for Shallow inspection (existence check)
     pipeline.ValidationOptions.Inspect(catalog.Input, Data.Validation.InspectionLevel.Shallow);
 
-    var pipelines = new Dictionary<string, Pipeline> { ["test_pipeline"] = pipeline };
+    var pipelines = new Dictionary<string, Flow> { ["test_pipeline"] = pipeline };
 
     var service = CreateService(catalog, pipelines);
 
     // Act
-    var validationResult = await service.ValidatePipelineAsync("test_pipeline");
+    var validationResult = await service.ValidateFlowAsync("test_pipeline");
 
     // Assert
     Assert.That(validationResult.IsValid, Is.False);
@@ -501,26 +501,26 @@ public void ValidatePipelineAsync_WithNonExistentPipeline_ThrowsKeyNotFoundExcep
   {
     // Arrange
     var catalog = new SimpleThreeNodeCatalog();
-    var pipelines = new Dictionary<string, Pipeline>();
+    var pipelines = new Dictionary<string, Flow>();
 
     var service = CreateService(catalog, pipelines);
 
     // Act & Assert
     var exception = Assert.ThrowsAsync<KeyNotFoundException>(
-      async () => await service.ValidatePipelineAsync("NonExistent")
+      async () => await service.ValidateFlowAsync("NonExistent")
     );
 
     Assert.That(exception.Message, Does.Contain("NonExistent"));
   }
 
   [Test]
-  public void GetDagMetadata_WithNoPipelineName_ReturnsMergedDag()
+  public void GetDagMetadata_WithNoFlowName_ReturnsMergedDag()
   {
     // Arrange
     var catalog = new SimpleThreeNodeCatalog();
-    var pipeline1 = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline1 = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Node1",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -528,9 +528,9 @@ public void GetDagMetadata_WithNoPipelineName_ReturnsMergedDag()
       );
     });
 
-    var pipeline2 = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline2 = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Node2",
         transform: PassthroughNode.Create(),
         input: catalog.StepOne,
@@ -538,7 +538,7 @@ public void GetDagMetadata_WithNoPipelineName_ReturnsMergedDag()
       );
     });
 
-    var pipelines = new Dictionary<string, Pipeline>
+    var pipelines = new Dictionary<string, Flow>
     {
       ["pipeline1"] = pipeline1,
       ["pipeline2"] = pipeline2,
@@ -551,21 +551,21 @@ public void GetDagMetadata_WithNoPipelineName_ReturnsMergedDag()
 
     // Assert
     Assert.That(dag, Is.Not.Null);
-    Assert.That(dag.Nodes, Has.Count.EqualTo(2));
+    Assert.That(dag.Steps, Has.Count.EqualTo(2));
     Assert.That(dag.Edges, Is.Not.Empty);
-    Assert.That(dag.CatalogEntries, Is.Not.Empty);
+    Assert.That(dag.CatalogItems, Is.Not.Empty);
     Assert.That(dag.AppliedSlice, Is.Null);
-    Assert.That(dag.SlicedNodeIds, Is.Null);
+    Assert.That(dag.SlicedStepIds, Is.Null);
   }
 
   [Test]
-  public void GetDagMetadata_WithPipelineName_ReturnsSinglePipelineDag()
+  public void GetDagMetadata_WithFlowName_ReturnsSinglePipelineDag()
   {
     // Arrange
     var catalog = new SimpleThreeNodeCatalog();
-    var pipeline1 = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline1 = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Node1",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -573,9 +573,9 @@ public void GetDagMetadata_WithPipelineName_ReturnsSinglePipelineDag()
       );
     });
 
-    var pipeline2 = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline2 = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Node2",
         transform: PassthroughNode.Create(),
         input: catalog.StepOne,
@@ -583,7 +583,7 @@ public void GetDagMetadata_WithPipelineName_ReturnsSinglePipelineDag()
       );
     });
 
-    var pipelines = new Dictionary<string, Pipeline>
+    var pipelines = new Dictionary<string, Flow>
     {
       ["pipeline1"] = pipeline1,
       ["pipeline2"] = pipeline2,
@@ -596,7 +596,7 @@ public void GetDagMetadata_WithPipelineName_ReturnsSinglePipelineDag()
 
     // Assert
     Assert.That(dag, Is.Not.Null);
-    Assert.That(dag.Nodes, Has.Count.EqualTo(1));
+    Assert.That(dag.Steps, Has.Count.EqualTo(1));
   }
 
   [Test]
@@ -604,15 +604,15 @@ public void GetDagMetadata_WithSliceStrategy_IncludesSliceOverlay()
   {
     // Arrange
     var catalog = new SimpleThreeNodeCatalog();
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Node1",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
         output: catalog.StepOne
       );
-      builder.AddNode(
+      builder.AddStep(
         label: "Node2",
         transform: PassthroughNode.Create(),
         input: catalog.StepOne,
@@ -620,18 +620,18 @@ public void GetDagMetadata_WithSliceStrategy_IncludesSliceOverlay()
       );
     });
 
-    var pipelines = new Dictionary<string, Pipeline> { ["test"] = pipeline };
+    var pipelines = new Dictionary<string, Flow> { ["test"] = pipeline };
 
     var service = CreateService(catalog, pipelines);
 
     // Act — slice to just Node1 (merged names are prefixed with pipeline name)
     var dag = service.GetDagMetadata(
-      sliceStrategy: new PipelineSliceStrategy { ToNodes = new HashSet<string> { "test.Node1" } }
+      sliceStrategy: new FlowSliceStrategy { ToNodes = new HashSet<string> { "test.Node1" } }
     );
 
     // Assert
     Assert.That(dag, Is.Not.Null);
-    Assert.That(dag.SlicedNodeIds, Is.Not.Null);
+    Assert.That(dag.SlicedStepIds, Is.Not.Null);
     Assert.That(dag.AppliedSlice, Is.Not.Null);
   }
 
@@ -640,7 +640,7 @@ public void GetDagMetadata_WithNonExistentPipeline_ThrowsKeyNotFoundException()
   {
     // Arrange
     var catalog = new SimpleThreeNodeCatalog();
-    var pipelines = new Dictionary<string, Pipeline>();
+    var pipelines = new Dictionary<string, Flow>();
 
     var service = CreateService(catalog, pipelines);
 
@@ -657,9 +657,9 @@ public void GetDagMetadata_NodesHaveInputsAndOutputs()
   {
     // Arrange
     var catalog = new SimpleThreeNodeCatalog();
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Process",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -667,7 +667,7 @@ public void GetDagMetadata_NodesHaveInputsAndOutputs()
       );
     });
 
-    var pipelines = new Dictionary<string, Pipeline> { ["test"] = pipeline };
+    var pipelines = new Dictionary<string, Flow> { ["test"] = pipeline };
 
     var service = CreateService(catalog, pipelines);
 
@@ -675,20 +675,20 @@ public void GetDagMetadata_NodesHaveInputsAndOutputs()
     var dag = service.GetDagMetadata("test");
 
     // Assert
-    var node = dag.Nodes.Single();
+    var node = dag.Steps.Single();
     Assert.That(node.Inputs, Is.Not.Empty);
     Assert.That(node.Outputs, Is.Not.Empty);
     Assert.That(node.Layer, Is.GreaterThanOrEqualTo(0));
   }
 
   [Test]
-  public void GetDagMetadata_CatalogEntriesHaveProducerConsumerInfo()
+  public void GetDagMetadata_ItemsHaveProducerConsumerInfo()
   {
     // Arrange
     var catalog = new SimpleThreeNodeCatalog();
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Process",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -696,7 +696,7 @@ public void GetDagMetadata_CatalogEntriesHaveProducerConsumerInfo()
       );
     });
 
-    var pipelines = new Dictionary<string, Pipeline> { ["test"] = pipeline };
+    var pipelines = new Dictionary<string, Flow> { ["test"] = pipeline };
 
     var service = CreateService(catalog, pipelines);
 
@@ -704,12 +704,12 @@ public void GetDagMetadata_CatalogEntriesHaveProducerConsumerInfo()
     var dag = service.GetDagMetadata("test");
 
     // Assert — the output catalog entry should have "Process" as its producer
-    var outputEntry = dag.CatalogEntries.FirstOrDefault(e => e.Producer is not null);
+    var outputEntry = dag.CatalogItems.FirstOrDefault(e => e.Producer is not null);
     Assert.That(outputEntry, Is.Not.Null);
     Assert.That(outputEntry!.Producer, Is.Not.Null.And.Not.Empty);
 
     // The input catalog entry should have "Process" as a consumer
-    var inputEntry = dag.CatalogEntries.FirstOrDefault(e => e.Consumers.Count > 0);
+    var inputEntry = dag.CatalogItems.FirstOrDefault(e => e.Consumers.Count > 0);
     Assert.That(inputEntry, Is.Not.Null);
     Assert.That(inputEntry!.Consumers, Is.Not.Empty);
   }
@@ -730,9 +730,9 @@ public async Task ExecutePipelineAsync_WithMetadataProvider_CapturesMetadata()
     };
     await catalog.Input.Save(testData).Run();
 
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Process",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -741,7 +741,7 @@ public async Task ExecutePipelineAsync_WithMetadataProvider_CapturesMetadata()
     });
 
     pipeline.Name = "test_pipeline";
-    var pipelines = new Dictionary<string, Pipeline> { ["test_pipeline"] = pipeline };
+    var pipelines = new Dictionary<string, Flow> { ["test_pipeline"] = pipeline };
 
     var capturingProvider = new CapturingMetadataProvider();
 
@@ -750,8 +750,8 @@ public async Task ExecutePipelineAsync_WithMetadataProvider_CapturesMetadata()
     services.AddLogging();
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog(catalog);
-      flowthru.UsePipelines(_ => pipelines);
+      flowthru.RegisterCatalog(catalog);
+      flowthru.RegisterFlows(_ => pipelines);
       flowthru.ConfigureMetadata(metadata =>
       {
         metadata.AddProvider(capturingProvider);
@@ -762,13 +762,13 @@ public async Task ExecutePipelineAsync_WithMetadataProvider_CapturesMetadata()
     var service = serviceProvider.GetRequiredService<IFlowthruService>();
 
     // Act - run with exportMetadata: true
-    var result = await service.ExecutePipelineAsync(options: null, exportMetadata: true);
+    var result = await service.ExecuteFlowAsync(options: null, exportMetadata: true);
 
     // Assert
     Assert.That(result.Success, Is.True);
     Assert.That(capturingProvider.CapturedDag, Is.Not.Null, "Provider should capture DAG metadata");
-    Assert.That(capturingProvider.CapturedDag.Nodes, Has.Count.EqualTo(1));
-    Assert.That(capturingProvider.CapturedDag.CatalogEntries, Is.Not.Empty);
+    Assert.That(capturingProvider.CapturedDag.Steps, Has.Count.EqualTo(1));
+    Assert.That(capturingProvider.CapturedDag.CatalogItems, Is.Not.Empty);
   }
 
   [Test]
@@ -787,9 +787,9 @@ public async Task ExecutePipelineAsync_WithoutMetadataExport_DoesNotCallProvider
     };
     await catalog.Input.Save(testData).Run();
 
-    var pipeline = PipelineBuilder.CreatePipeline(builder =>
+    var pipeline = FlowBuilder.CreateFlow(builder =>
     {
-      builder.AddNode(
+      builder.AddStep(
         label: "Process",
         transform: PassthroughNode.Create(),
         input: catalog.Input,
@@ -798,7 +798,7 @@ public async Task ExecutePipelineAsync_WithoutMetadataExport_DoesNotCallProvider
     });
 
     pipeline.Name = "test_pipeline";
-    var pipelines = new Dictionary<string, Pipeline> { ["test_pipeline"] = pipeline };
+    var pipelines = new Dictionary<string, Flow> { ["test_pipeline"] = pipeline };
 
     var capturingProvider = new CapturingMetadataProvider();
 
@@ -807,8 +807,8 @@ public async Task ExecutePipelineAsync_WithoutMetadataExport_DoesNotCallProvider
     services.AddLogging();
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog(catalog);
-      flowthru.UsePipelines(_ => pipelines);
+      flowthru.RegisterCatalog(catalog);
+      flowthru.RegisterFlows(_ => pipelines);
       flowthru.ConfigureMetadata(metadata =>
       {
         metadata.AddProvider(capturingProvider);
@@ -819,7 +819,7 @@ public async Task ExecutePipelineAsync_WithoutMetadataExport_DoesNotCallProvider
     var service = serviceProvider.GetRequiredService<IFlowthruService>();
 
     // Act - run with exportMetadata: false (default)
-    var result = await service.ExecutePipelineAsync(options: null, exportMetadata: false);
+    var result = await service.ExecuteFlowAsync(options: null, exportMetadata: false);
 
     // Assert
     Assert.That(result.Success, Is.True);
diff --git a/tests/Flowthru.Tests/04_Services/MultiCatalogRegistrationTests.cs b/tests/Flowthru.Tests/04_Services/MultiCatalogRegistrationTests.cs
index bf25fa9d..8ae7b748 100644
--- a/tests/Flowthru.Tests/04_Services/MultiCatalogRegistrationTests.cs
+++ b/tests/Flowthru.Tests/04_Services/MultiCatalogRegistrationTests.cs
@@ -1,5 +1,5 @@
 using Flowthru.Data;
-using Flowthru.Pipelines;
+using Flowthru.Flows;
 using Flowthru.Services;
 using Flowthru.Tests.Fixtures.TestCatalogs;
 using Flowthru.Tests.Fixtures.TestNodes;
@@ -21,7 +21,7 @@ public class MultiCatalogRegistrationTests
   // ─────────────────────────────────────────────────────────────────────────
 
   [Test]
-  public void UseCatalog_MultipleCatalogs_AllResolvableByConcreteType()
+  public void RegisterCatalog_MultipleCatalogs_AllResolvableByConcreteType()
   {
     // Arrange
     var services = new ServiceCollection();
@@ -30,13 +30,13 @@ public void UseCatalog_MultipleCatalogs_AllResolvableByConcreteType()
     // Act
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog<UpstreamCatalog>();
-      flowthru.UseCatalog<DownstreamCatalog>();
-      flowthru.RegisterPipeline(
+      flowthru.RegisterCatalog<UpstreamCatalog>();
+      flowthru.RegisterCatalog<DownstreamCatalog>();
+      flowthru.RegisterFlow(
         "Upstream",
         (UpstreamCatalog up) =>
-          PipelineBuilder.CreatePipeline(b =>
-            b.AddNode("U1", PassthroughNode.Create(), up.UpstreamInput, up.UpstreamOutput)
+          FlowBuilder.CreateFlow(b =>
+            b.AddStep("U1", PassthroughNode.Create(), up.UpstreamInput, up.UpstreamOutput)
           )
       );
     });
@@ -60,13 +60,13 @@ public void IFlowthruService_Catalogs_ContainsAllRegisteredCatalogs()
 
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog<UpstreamCatalog>();
-      flowthru.UseCatalog<DownstreamCatalog>();
-      flowthru.RegisterPipeline(
+      flowthru.RegisterCatalog<UpstreamCatalog>();
+      flowthru.RegisterCatalog<DownstreamCatalog>();
+      flowthru.RegisterFlow(
         "Upstream",
         (UpstreamCatalog up) =>
-          PipelineBuilder.CreatePipeline(b =>
-            b.AddNode("U1", PassthroughNode.Create(), up.UpstreamInput, up.UpstreamOutput)
+          FlowBuilder.CreateFlow(b =>
+            b.AddStep("U1", PassthroughNode.Create(), up.UpstreamInput, up.UpstreamOutput)
           )
       );
     });
@@ -95,24 +95,24 @@ public void RegisterPipeline_TwoCatalogs_PipelineIsRegistered()
 
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog<UpstreamCatalog>();
-      flowthru.UseCatalog<DownstreamCatalog>();
+      flowthru.RegisterCatalog<UpstreamCatalog>();
+      flowthru.RegisterCatalog<DownstreamCatalog>();
 
       // Single-catalog upstream pipeline
-      flowthru.RegisterPipeline(
+      flowthru.RegisterFlow(
         "Upstream",
         (UpstreamCatalog up) =>
-          PipelineBuilder.CreatePipeline(b =>
-            b.AddNode("Process", PassthroughNode.Create(), up.UpstreamInput, up.UpstreamOutput)
+          FlowBuilder.CreateFlow(b =>
+            b.AddStep("Process", PassthroughNode.Create(), up.UpstreamInput, up.UpstreamOutput)
           )
       );
 
       // 2-catalog bridge pipeline: reads from upstream, writes to downstream
-      flowthru.RegisterPipeline(
+      flowthru.RegisterFlow(
         "Bridge",
         (UpstreamCatalog up, DownstreamCatalog down) =>
-          PipelineBuilder.CreatePipeline(b =>
-            b.AddNode("Bridge", PassthroughNode.Create(), up.UpstreamOutput, down.DownstreamOutput)
+          FlowBuilder.CreateFlow(b =>
+            b.AddStep("Bridge", PassthroughNode.Create(), up.UpstreamOutput, down.DownstreamOutput)
           )
       );
     });
@@ -121,15 +121,15 @@ public void RegisterPipeline_TwoCatalogs_PipelineIsRegistered()
     var service = sp.GetRequiredService<IFlowthruService>();
 
     // Assert
-    Assert.That(service.PipelineNames, Does.Contain("Upstream"));
-    Assert.That(service.PipelineNames, Does.Contain("Bridge"));
+    Assert.That(service.FlowNames, Does.Contain("Upstream"));
+    Assert.That(service.FlowNames, Does.Contain("Bridge"));
   }
 
   [Test]
   public async Task RegisterPipeline_TwoCatalogs_DagResolvesCrossCatalogEdge()
   {
     // Arrange — the Bridge pipeline reads up.UpstreamOutput, which is written by the
-    // Upstream pipeline. When merged, the DAG must see a single ICatalogEntry instance
+    // Upstream pipeline. When merged, the DAG must see a single IItem instance
     // (object identity) and schedule Bridge after Upstream.
     var upstream = new UpstreamCatalog();
     var downstream = new DownstreamCatalog();
@@ -150,22 +150,22 @@ public async Task RegisterPipeline_TwoCatalogs_DagResolvesCrossCatalogEdge()
 
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog(upstream);
-      flowthru.UseCatalog(downstream);
+      flowthru.RegisterCatalog(upstream);
+      flowthru.RegisterCatalog(downstream);
 
-      flowthru.RegisterPipeline(
+      flowthru.RegisterFlow(
         "Upstream",
         (UpstreamCatalog up) =>
-          PipelineBuilder.CreatePipeline(b =>
-            b.AddNode("Process", PassthroughNode.Create(), up.UpstreamInput, up.UpstreamOutput)
+          FlowBuilder.CreateFlow(b =>
+            b.AddStep("Process", PassthroughNode.Create(), up.UpstreamInput, up.UpstreamOutput)
           )
       );
 
-      flowthru.RegisterPipeline(
+      flowthru.RegisterFlow(
         "Bridge",
         (UpstreamCatalog up, DownstreamCatalog down) =>
-          PipelineBuilder.CreatePipeline(b =>
-            b.AddNode("Bridge", PassthroughNode.Create(), up.UpstreamOutput, down.DownstreamOutput)
+          FlowBuilder.CreateFlow(b =>
+            b.AddStep("Bridge", PassthroughNode.Create(), up.UpstreamOutput, down.DownstreamOutput)
           )
       );
     });
@@ -174,11 +174,11 @@ public async Task RegisterPipeline_TwoCatalogs_DagResolvesCrossCatalogEdge()
     var service = sp.GetRequiredService<IFlowthruService>();
 
     // Act
-    var result = await service.ExecutePipelineAsync(exportMetadata: false);
+    var result = await service.ExecuteFlowAsync(exportMetadata: false);
 
     // Assert — both pipelines executed and data flowed through
     Assert.That(result.Success, Is.True);
-    Assert.That(result.NodeResults, Has.Count.EqualTo(2));
+    Assert.That(result.StepResults, Has.Count.EqualTo(2));
 
     var output = await downstream.DownstreamOutput.Load().Run();
     Assert.That(output, Is.Not.Null);
@@ -214,33 +214,33 @@ public async Task RegisterPipeline_ThreeCatalogs_DagResolvesFullChain()
 
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog(upstream);
-      flowthru.UseCatalog(downstream);
-      flowthru.UseCatalog(third);
+      flowthru.RegisterCatalog(upstream);
+      flowthru.RegisterCatalog(downstream);
+      flowthru.RegisterCatalog(third);
 
-      flowthru.RegisterPipeline(
+      flowthru.RegisterFlow(
         "Upstream",
         (UpstreamCatalog up) =>
-          PipelineBuilder.CreatePipeline(b =>
-            b.AddNode("Process", PassthroughNode.Create(), up.UpstreamInput, up.UpstreamOutput)
+          FlowBuilder.CreateFlow(b =>
+            b.AddStep("Process", PassthroughNode.Create(), up.UpstreamInput, up.UpstreamOutput)
           )
       );
 
-      flowthru.RegisterPipeline(
+      flowthru.RegisterFlow(
         "Bridge",
         (UpstreamCatalog up, DownstreamCatalog down) =>
-          PipelineBuilder.CreatePipeline(b =>
-            b.AddNode("Bridge", PassthroughNode.Create(), up.UpstreamOutput, down.DownstreamOutput)
+          FlowBuilder.CreateFlow(b =>
+            b.AddStep("Bridge", PassthroughNode.Create(), up.UpstreamOutput, down.DownstreamOutput)
           )
       );
 
       // 3-catalog pipeline reads from both upstream and downstream, writes to third
-      flowthru.RegisterPipeline(
+      flowthru.RegisterFlow(
         "Merge",
         (UpstreamCatalog up, DownstreamCatalog down, ThirdCatalog t) =>
-          PipelineBuilder.CreatePipeline(b =>
+          FlowBuilder.CreateFlow(b =>
             // Use downstream output (which depends on upstream) as the final step input
-            b.AddNode("Merge", PassthroughNode.Create(), down.DownstreamOutput, t.FinalOutput)
+            b.AddStep("Merge", PassthroughNode.Create(), down.DownstreamOutput, t.FinalOutput)
           )
       );
     });
@@ -249,11 +249,11 @@ public async Task RegisterPipeline_ThreeCatalogs_DagResolvesFullChain()
     var service = sp.GetRequiredService<IFlowthruService>();
 
     // Act
-    var result = await service.ExecutePipelineAsync(exportMetadata: false);
+    var result = await service.ExecuteFlowAsync(exportMetadata: false);
 
     // Assert — all three pipelines executed in dependency order
     Assert.That(result.Success, Is.True);
-    Assert.That(result.NodeResults, Has.Count.EqualTo(3));
+    Assert.That(result.StepResults, Has.Count.EqualTo(3));
 
     var finalOutput = await third.FinalOutput.Load().Run();
     Assert.That(finalOutput!.First().Name, Is.EqualTo("three-catalog"));
@@ -272,15 +272,15 @@ public void RegisterPipeline_TwoCatalogs_WithDescription_SetsDescription()
 
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog<UpstreamCatalog>();
-      flowthru.UseCatalog<DownstreamCatalog>();
+      flowthru.RegisterCatalog<UpstreamCatalog>();
+      flowthru.RegisterCatalog<DownstreamCatalog>();
 
       flowthru
-        .RegisterPipeline(
+        .RegisterFlow(
           "Bridge",
           (UpstreamCatalog up, DownstreamCatalog down) =>
-            PipelineBuilder.CreatePipeline(b =>
-              b.AddNode("B", PassthroughNode.Create(), up.UpstreamOutput, down.DownstreamOutput)
+            FlowBuilder.CreateFlow(b =>
+              b.AddStep("B", PassthroughNode.Create(), up.UpstreamOutput, down.DownstreamOutput)
             )
         )
         .WithDescription("Bridges upstream to downstream domain");
@@ -288,7 +288,7 @@ public void RegisterPipeline_TwoCatalogs_WithDescription_SetsDescription()
 
     var sp = services.BuildServiceProvider();
     var service = sp.GetRequiredService<IFlowthruService>();
-    var meta = service.GetPipelineMetadata("Bridge");
+    var meta = service.GetFlowMetadata("Bridge");
 
     // Assert
     Assert.That(meta.Description, Is.EqualTo("Bridges upstream to downstream domain"));
@@ -308,34 +308,34 @@ public void RegisterPipeline_TwoCatalogs_SharedEntryPreservesObjectIdentity()
     var upstream = new UpstreamCatalog();
     var downstream = new DownstreamCatalog();
 
-    Pipeline? upstreamPipeline = null;
-    Pipeline? bridgePipeline = null;
+    Flow? upstreamPipeline = null;
+    Flow? bridgePipeline = null;
 
     var services = new ServiceCollection();
     services.AddLogging();
 
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog(upstream);
-      flowthru.UseCatalog(downstream);
+      flowthru.RegisterCatalog(upstream);
+      flowthru.RegisterCatalog(downstream);
 
-      flowthru.RegisterPipeline(
+      flowthru.RegisterFlow(
         "Upstream",
         (UpstreamCatalog up) =>
         {
-          upstreamPipeline = PipelineBuilder.CreatePipeline(b =>
-            b.AddNode("P", PassthroughNode.Create(), up.UpstreamInput, up.UpstreamOutput)
+          upstreamPipeline = FlowBuilder.CreateFlow(b =>
+            b.AddStep("P", PassthroughNode.Create(), up.UpstreamInput, up.UpstreamOutput)
           );
           return upstreamPipeline;
         }
       );
 
-      flowthru.RegisterPipeline(
+      flowthru.RegisterFlow(
         "Bridge",
         (UpstreamCatalog up, DownstreamCatalog down) =>
         {
-          bridgePipeline = PipelineBuilder.CreatePipeline(b =>
-            b.AddNode("B", PassthroughNode.Create(), up.UpstreamOutput, down.DownstreamOutput)
+          bridgePipeline = FlowBuilder.CreateFlow(b =>
+            b.AddStep("B", PassthroughNode.Create(), up.UpstreamOutput, down.DownstreamOutput)
           );
           return bridgePipeline;
         }
@@ -347,8 +347,8 @@ public void RegisterPipeline_TwoCatalogs_SharedEntryPreservesObjectIdentity()
     _ = sp.GetRequiredService<IFlowthruService>();
 
     // Assert — UpstreamOutput entry is the same instance in both pipelines
-    var upstreamOutputInProducer = upstreamPipeline!.Nodes.First(n => n.Label == "P").Outputs[0];
-    var upstreamOutputInConsumer = bridgePipeline!.Nodes.First(n => n.Label == "B").Inputs[0];
+    var upstreamOutputInProducer = upstreamPipeline!.Steps.First(n => n.Label == "P").Outputs[0];
+    var upstreamOutputInConsumer = bridgePipeline!.Steps.First(n => n.Label == "B").Inputs[0];
 
     Assert.That(
       upstreamOutputInProducer,
@@ -358,14 +358,14 @@ public void RegisterPipeline_TwoCatalogs_SharedEntryPreservesObjectIdentity()
   }
 
   // ─────────────────────────────────────────────────────────────────────────
-  // UseCatalogs — dynamic/iterative catalog registration
+  // RegisterCatalogs — dynamic/iterative catalog registration
   // ─────────────────────────────────────────────────────────────────────────
 
   [Test]
-  public void UseCatalogs_InstanceOverload_AllCatalogsVisibleToService()
+  public void RegisterCatalogs_InstanceOverload_AllCatalogsVisibleToService()
   {
     // Arrange — simulate the fan-out pattern: N catalogs built in a loop,
-    // registered via UseCatalogs rather than individual UseCatalog calls.
+    // registered via RegisterCatalogs rather than individual RegisterCatalog calls.
     var shards = new[] { new ShardCatalog("X"), new ShardCatalog("Y"), new ShardCatalog("Z") };
 
     var services = new ServiceCollection();
@@ -373,12 +373,12 @@ public void UseCatalogs_InstanceOverload_AllCatalogsVisibleToService()
 
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalogs(shards);
+      flowthru.RegisterCatalogs(shards);
 
-      flowthru.UsePipelines(_ => new Dictionary<string, Pipeline>
+      flowthru.RegisterFlows(_ => new Dictionary<string, Flow>
       {
         // Minimal pipeline so AddFlowthru has something to inject
-        ["noop"] = PipelineBuilder.CreatePipeline(_ => { }),
+        ["noop"] = FlowBuilder.CreateFlow(_ => { }),
       });
     });
 
@@ -395,9 +395,9 @@ public void UseCatalogs_InstanceOverload_AllCatalogsVisibleToService()
   }
 
   [Test]
-  public void UseCatalogs_MixedWithUseCatalog_AllCatalogsVisibleToService()
+  public void RegisterCatalogs_MixedWithRegisterCatalog_AllCatalogsVisibleToService()
   {
-    // Arrange — one static catalog registered via UseCatalog, N via UseCatalogs.
+    // Arrange — one static catalog registered via RegisterCatalog, N via RegisterCatalogs.
     var staticCatalog = new UpstreamCatalog();
     var shards = new[] { new ShardCatalog("P"), new ShardCatalog("Q") };
 
@@ -406,12 +406,12 @@ public void UseCatalogs_MixedWithUseCatalog_AllCatalogsVisibleToService()
 
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog(staticCatalog);
-      flowthru.UseCatalogs(shards);
+      flowthru.RegisterCatalog(staticCatalog);
+      flowthru.RegisterCatalogs(shards);
 
-      flowthru.UsePipelines(_ => new Dictionary<string, Pipeline>
+      flowthru.RegisterFlows(_ => new Dictionary<string, Flow>
       {
-        ["noop"] = PipelineBuilder.CreatePipeline(_ => { }),
+        ["noop"] = FlowBuilder.CreateFlow(_ => { }),
       });
     });
 
@@ -423,17 +423,17 @@ public void UseCatalogs_MixedWithUseCatalog_AllCatalogsVisibleToService()
     Assert.That(
       service.Catalogs.OfType<UpstreamCatalog>().Count(),
       Is.EqualTo(1),
-      "Static UseCatalog entry should be present"
+      "Static RegisterCatalog entry should be present"
     );
     Assert.That(
       service.Catalogs.OfType<ShardCatalog>().Count(),
       Is.EqualTo(2),
-      "Dynamic UseCatalogs entries should be present"
+      "Dynamic RegisterCatalogs entries should be present"
     );
   }
 
   [Test]
-  public void UseCatalogs_FactoryOverload_AllCatalogsVisibleToService()
+  public void RegisterCatalogs_FactoryOverload_AllCatalogsVisibleToService()
   {
     // Arrange — catalogs produced by a factory that receives the service provider.
     var services = new ServiceCollection();
@@ -441,13 +441,13 @@ public void UseCatalogs_FactoryOverload_AllCatalogsVisibleToService()
 
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalogs(_ =>
-        new DataCatalogBase[] { new ShardCatalog("factory_1"), new ShardCatalog("factory_2") }
+      flowthru.RegisterCatalogs(_ =>
+        new CatalogAbstract[] { new ShardCatalog("factory_1"), new ShardCatalog("factory_2") }
       );
 
-      flowthru.UsePipelines(_ => new Dictionary<string, Pipeline>
+      flowthru.RegisterFlows(_ => new Dictionary<string, Flow>
       {
-        ["noop"] = PipelineBuilder.CreatePipeline(_ => { }),
+        ["noop"] = FlowBuilder.CreateFlow(_ => { }),
       });
     });
 
diff --git a/tests/Flowthru.Tests/04_Services/ServiceCollectionExtensionsTests.cs b/tests/Flowthru.Tests/04_Services/ServiceCollectionExtensionsTests.cs
index 3238835e..42228e6e 100644
--- a/tests/Flowthru.Tests/04_Services/ServiceCollectionExtensionsTests.cs
+++ b/tests/Flowthru.Tests/04_Services/ServiceCollectionExtensionsTests.cs
@@ -1,7 +1,7 @@
 using Flowthru.Data;
+using Flowthru.Flows;
 using Flowthru.Meta;
 using Flowthru.Meta.Providers;
-using Flowthru.Pipelines;
 using Flowthru.Services;
 using Flowthru.Tests.Fixtures.TestCatalogs;
 using Flowthru.Tests.Fixtures.TestNodes;
@@ -27,8 +27,8 @@ public void AddFlowthru_RegistersService()
     // Act
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog(new SimpleThreeNodeCatalog());
-      flowthru.UsePipelines(sp => new Dictionary<string, Pipeline>());
+      flowthru.RegisterCatalog(new SimpleThreeNodeCatalog());
+      flowthru.RegisterFlows(sp => new Dictionary<string, Flow>());
     });
 
     var serviceProvider = services.BuildServiceProvider();
@@ -48,8 +48,8 @@ public void AddFlowthru_RegistersCatalog()
     // Act
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog(catalog);
-      flowthru.UsePipelines(sp => new Dictionary<string, Pipeline>());
+      flowthru.RegisterCatalog(catalog);
+      flowthru.RegisterFlows(sp => new Dictionary<string, Flow>());
     });
 
     var serviceProvider = services.BuildServiceProvider();
@@ -69,8 +69,8 @@ public void AddFlowthru_WithCatalogType_ResolvesCatalog()
     // Act
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog<SimpleThreeNodeCatalog>();
-      flowthru.UsePipelines(sp => new Dictionary<string, Pipeline>());
+      flowthru.RegisterCatalog<SimpleThreeNodeCatalog>();
+      flowthru.RegisterFlows(sp => new Dictionary<string, Flow>());
     });
 
     var serviceProvider = services.BuildServiceProvider();
@@ -90,8 +90,8 @@ public void AddFlowthru_WithCatalogFactory_CreatesCatalog()
     // Act
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog<SimpleThreeNodeCatalog>(sp => new SimpleThreeNodeCatalog());
-      flowthru.UsePipelines(sp => new Dictionary<string, Pipeline>());
+      flowthru.RegisterCatalog<SimpleThreeNodeCatalog>(sp => new SimpleThreeNodeCatalog());
+      flowthru.RegisterFlows(sp => new Dictionary<string, Flow>());
     });
 
     var serviceProvider = services.BuildServiceProvider();
@@ -113,13 +113,13 @@ public void AddFlowthru_RegistersPipelines()
     services.AddFlowthru(flowthru =>
     {
       var catalog = new SimpleThreeNodeCatalog();
-      flowthru.UseCatalog(catalog);
-      flowthru.RegisterPipeline(
+      flowthru.RegisterCatalog(catalog);
+      flowthru.RegisterFlow(
         "test",
         (SimpleThreeNodeCatalog cat) =>
-          PipelineBuilder.CreatePipeline(builder =>
+          FlowBuilder.CreateFlow(builder =>
           {
-            builder.AddNode(
+            builder.AddStep(
               label: "Node",
               transform: PassthroughNode.Create(),
               input: cat.Input,
@@ -133,8 +133,8 @@ public void AddFlowthru_RegistersPipelines()
     var service = serviceProvider.GetRequiredService<IFlowthruService>();
 
     // Assert
-    Assert.That(service.PipelineNames, Has.Count.EqualTo(1));
-    Assert.That(service.PipelineNames, Does.Contain("test"));
+    Assert.That(service.FlowNames, Has.Count.EqualTo(1));
+    Assert.That(service.FlowNames, Does.Contain("test"));
   }
 
   [Test]
@@ -166,8 +166,8 @@ public void AddFlowthru_WithMetadata_ConfiguresMetadataBuilder()
     // Act
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog(new SimpleThreeNodeCatalog());
-      flowthru.UsePipelines(sp => new Dictionary<string, Pipeline>());
+      flowthru.RegisterCatalog(new SimpleThreeNodeCatalog());
+      flowthru.RegisterFlows(sp => new Dictionary<string, Flow>());
       flowthru.ConfigureMetadata(meta =>
       {
         meta.AddProvider<JsonMetadataProvider, JsonMetadataProviderBuilder>(json =>
@@ -194,8 +194,8 @@ public void AddFlowthru_ServiceIsSingleton()
 
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog(new SimpleThreeNodeCatalog());
-      flowthru.UsePipelines(sp => new Dictionary<string, Pipeline>());
+      flowthru.RegisterCatalog(new SimpleThreeNodeCatalog());
+      flowthru.RegisterFlows(sp => new Dictionary<string, Flow>());
     });
 
     var serviceProvider = services.BuildServiceProvider();
@@ -209,7 +209,7 @@ public void AddFlowthru_ServiceIsSingleton()
   }
 
   [Test]
-  public void AddFlowthru_RegisterPipelineAndUsePipelines_MergesAll()
+  public void AddFlowthru_RegisterPipelineAndRegisterPipelines_MergesAll()
   {
     // Arrange — one inline registration and one factory-based registration
     var services = new ServiceCollection();
@@ -219,14 +219,14 @@ public void AddFlowthru_RegisterPipelineAndUsePipelines_MergesAll()
 
     services.AddFlowthru(flowthru =>
     {
-      flowthru.UseCatalog(catalog);
+      flowthru.RegisterCatalog(catalog);
 
-      flowthru.RegisterPipeline(
+      flowthru.RegisterFlow(
         "inline",
         (SimpleThreeNodeCatalog cat) =>
-          PipelineBuilder.CreatePipeline(builder =>
+          FlowBuilder.CreateFlow(builder =>
           {
-            builder.AddNode(
+            builder.AddStep(
               label: "Node",
               transform: PassthroughNode.Create(),
               input: cat.Input,
@@ -235,11 +235,11 @@ public void AddFlowthru_RegisterPipelineAndUsePipelines_MergesAll()
           })
       );
 
-      flowthru.UsePipelines(_ => new Dictionary<string, Pipeline>
+      flowthru.RegisterFlows(_ => new Dictionary<string, Flow>
       {
-        ["dynamic"] = PipelineBuilder.CreatePipeline(builder =>
+        ["dynamic"] = FlowBuilder.CreateFlow(builder =>
         {
-          builder.AddNode(
+          builder.AddStep(
             label: "Node",
             transform: PassthroughNode.Create(),
             input: catalog.Input,
@@ -253,8 +253,8 @@ public void AddFlowthru_RegisterPipelineAndUsePipelines_MergesAll()
     var service = serviceProvider.GetRequiredService<IFlowthruService>();
 
     // Assert — both pipelines are present
-    Assert.That(service.PipelineNames, Has.Count.EqualTo(2));
-    Assert.That(service.PipelineNames, Does.Contain("inline"));
-    Assert.That(service.PipelineNames, Does.Contain("dynamic"));
+    Assert.That(service.FlowNames, Has.Count.EqualTo(2));
+    Assert.That(service.FlowNames, Does.Contain("inline"));
+    Assert.That(service.FlowNames, Does.Contain("dynamic"));
   }
 }
diff --git a/tests/Flowthru.Tests/04_Services/StorageStrategies/StorageStrategyIntegrationTests.cs b/tests/Flowthru.Tests/04_Services/StorageStrategies/StorageStrategyIntegrationTests.cs
index 6d945540..59972238 100644
--- a/tests/Flowthru.Tests/04_Services/StorageStrategies/StorageStrategyIntegrationTests.cs
+++ b/tests/Flowthru.Tests/04_Services/StorageStrategies/StorageStrategyIntegrationTests.cs
@@ -13,7 +13,7 @@ namespace Flowthru.Tests.Services.StorageStrategies;
 public class StorageStrategyIntegrationTests
 {
   // Example catalog using IStorageEntryFactory injection
-  private class TestCatalog : DataCatalogBase
+  private class TestCatalog : CatalogAbstract
   {
     private readonly IStorageEntryFactory _storage;
 
@@ -23,8 +23,8 @@ public TestCatalog(IStorageEntryFactory storage)
       InitializeCatalogProperties();
     }
 
-    public ICatalogEntry<IEnumerable<RequiredMembersSchema>> TestData =>
-      GetOrCreateEntry(() => _storage.CreateEnumerable<RequiredMembersSchema>("TestData"));
+    public IItem<IEnumerable<RequiredMembersSchema>> TestData =>
+      CreateItem(() => _storage.CreateEnumerable<RequiredMembersSchema>("TestData"));
   }
 
   [Test]
@@ -105,8 +105,8 @@ public void FlowthruServiceBuilder_UseStorageStrategy_RegistersFactory()
     services.AddFlowthru(builder =>
     {
       builder.UseStorageStrategy<MemoryStorageEntryFactory>();
-      builder.UseCatalog<TestCatalog>();
-      builder.UsePipelines(_ => []);
+      builder.RegisterCatalog<TestCatalog>();
+      builder.RegisterFlows(_ => []);
     });
 
     var provider = services.BuildServiceProvider();
@@ -135,8 +135,8 @@ public void FlowthruServiceBuilder_UseStorageStrategyWithConfiguration_ReadsSett
     services.AddFlowthru(builder =>
     {
       builder.UseStorageStrategy<CsvStorageEntryFactory>();
-      builder.UseCatalog<TestCatalog>();
-      builder.UsePipelines(_ => []);
+      builder.RegisterCatalog<TestCatalog>();
+      builder.RegisterFlows(_ => []);
     });
 
     var provider = services.BuildServiceProvider();
diff --git a/tests/Flowthru.Tests/_Fixtures/TestCatalogs/TestCatalogs.cs b/tests/Flowthru.Tests/_Fixtures/TestCatalogs/TestCatalogs.cs
index 49f2c1a4..1e496395 100644
--- a/tests/Flowthru.Tests/_Fixtures/TestCatalogs/TestCatalogs.cs
+++ b/tests/Flowthru.Tests/_Fixtures/TestCatalogs/TestCatalogs.cs
@@ -5,30 +5,30 @@ namespace Flowthru.Tests.Fixtures.TestCatalogs;
 /// <summary>
 /// Simple test catalog with three sequential processing steps.
 /// </summary>
-public class SimpleThreeNodeCatalog : DataCatalogBase
+public class SimpleThreeNodeCatalog : CatalogAbstract
 {
   public SimpleThreeNodeCatalog()
   {
     InitializeCatalogProperties();
   }
 
-  public ICatalogEntry<IEnumerable<TestData>> Input =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "input"));
+  public IItem<IEnumerable<TestData>> Input =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "input"));
 
-  public ICatalogEntry<IEnumerable<TestData>> StepOne =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "step_one"));
+  public IItem<IEnumerable<TestData>> StepOne =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "step_one"));
 
-  public ICatalogEntry<IEnumerable<TestData>> StepTwo =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "step_two"));
+  public IItem<IEnumerable<TestData>> StepTwo =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "step_two"));
 
-  public ICatalogEntry<IEnumerable<TestData>> Output =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "output"));
+  public IItem<IEnumerable<TestData>> Output =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "output"));
 }
 
 /// <summary>
 /// Empty catalog for testing edge cases.
 /// </summary>
-public class EmptyCatalog : DataCatalogBase
+public class EmptyCatalog : CatalogAbstract
 {
   public EmptyCatalog()
   {
@@ -39,7 +39,7 @@ public EmptyCatalog()
 /// <summary>
 /// Complex catalog with multiple layers for testing DAG construction.
 /// </summary>
-public class ComplexMultiLayerCatalog : DataCatalogBase
+public class ComplexMultiLayerCatalog : CatalogAbstract
 {
   public ComplexMultiLayerCatalog()
   {
@@ -47,29 +47,29 @@ public ComplexMultiLayerCatalog()
   }
 
   // Layer 0 inputs
-  public ICatalogEntry<IEnumerable<TestData>> InputA =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "input_a"));
+  public IItem<IEnumerable<TestData>> InputA =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "input_a"));
 
-  public ICatalogEntry<IEnumerable<TestData>> InputB =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "input_b"));
+  public IItem<IEnumerable<TestData>> InputB =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "input_b"));
 
-  public ICatalogEntry<IEnumerable<TestData>> InputC =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "input_c"));
+  public IItem<IEnumerable<TestData>> InputC =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "input_c"));
 
   // Layer 1 intermediates
-  public ICatalogEntry<IEnumerable<TestData>> ProcessedA =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "processed_a"));
+  public IItem<IEnumerable<TestData>> ProcessedA =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "processed_a"));
 
-  public ICatalogEntry<IEnumerable<TestData>> ProcessedB =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "processed_b"));
+  public IItem<IEnumerable<TestData>> ProcessedB =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "processed_b"));
 
   // Layer 2 merged
-  public ICatalogEntry<IEnumerable<TestData>> Merged =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "merged"));
+  public IItem<IEnumerable<TestData>> Merged =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "merged"));
 
   // Layer 3 final
-  public ICatalogEntry<IEnumerable<TestData>> Final =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "final"));
+  public IItem<IEnumerable<TestData>> Final =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "final"));
 }
 
 /// <summary>
@@ -86,54 +86,54 @@ public record TestData
 /// Upstream catalog for multi-catalog pipeline tests.
 /// Owns the raw input entry and an output entry that a downstream catalog bridges.
 /// </summary>
-public class UpstreamCatalog : DataCatalogBase
+public class UpstreamCatalog : CatalogAbstract
 {
   public UpstreamCatalog()
   {
     InitializeCatalogProperties();
   }
 
-  public ICatalogEntry<IEnumerable<TestData>> UpstreamInput =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "upstream_input"));
+  public IItem<IEnumerable<TestData>> UpstreamInput =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "upstream_input"));
 
-  public ICatalogEntry<IEnumerable<TestData>> UpstreamOutput =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "upstream_output"));
+  public IItem<IEnumerable<TestData>> UpstreamOutput =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "upstream_output"));
 }
 
 /// <summary>
 /// Downstream catalog for multi-catalog pipeline tests.
 /// Owns its own output; bridges to UpstreamCatalog.UpstreamOutput are wired via the pipeline.
 /// </summary>
-public class DownstreamCatalog : DataCatalogBase
+public class DownstreamCatalog : CatalogAbstract
 {
   public DownstreamCatalog()
   {
     InitializeCatalogProperties();
   }
 
-  public ICatalogEntry<IEnumerable<TestData>> DownstreamOutput =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "downstream_output"));
+  public IItem<IEnumerable<TestData>> DownstreamOutput =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "downstream_output"));
 }
 
 /// <summary>
 /// Third catalog for 3-arity pipeline tests.
 /// </summary>
-public class ThirdCatalog : DataCatalogBase
+public class ThirdCatalog : CatalogAbstract
 {
   public ThirdCatalog()
   {
     InitializeCatalogProperties();
   }
 
-  public ICatalogEntry<IEnumerable<TestData>> FinalOutput =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "final_output"));
+  public IItem<IEnumerable<TestData>> FinalOutput =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "final_output"));
 }
 
 /// <summary>
-/// Per-shard catalog for fan-in and UseCatalogs tests.
+/// Per-shard catalog for fan-in and RegisterCatalogs tests.
 /// Each instance is keyed by a unique shard label, giving every entry a distinct identity.
 /// </summary>
-public class ShardCatalog : DataCatalogBase
+public class ShardCatalog : CatalogAbstract
 {
   private readonly string _shardKey;
 
@@ -143,22 +143,20 @@ public ShardCatalog(string shardKey)
     InitializeCatalogProperties();
   }
 
-  public ICatalogEntry<IEnumerable<TestData>> ShardData =>
-    GetOrCreateEntry(
-      () => CatalogEntries.Enumerable.Memory<TestData>(label: $"shard_data_{_shardKey}")
-    );
+  public IItem<IEnumerable<TestData>> ShardData =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: $"shard_data_{_shardKey}"));
 }
 
 /// <summary>
 /// Master catalog that aggregates data from multiple ShardCatalogs.
 /// </summary>
-public class MasterCatalog : DataCatalogBase
+public class MasterCatalog : CatalogAbstract
 {
   public MasterCatalog()
   {
     InitializeCatalogProperties();
   }
 
-  public ICatalogEntry<IEnumerable<TestData>> AllData =>
-    GetOrCreateEntry(() => CatalogEntries.Enumerable.Memory<TestData>(label: "all_data"));
+  public IItem<IEnumerable<TestData>> AllData =>
+    CreateItem(() => ItemFactory.Enumerable.Memory<TestData>(label: "all_data"));
 }