# geezy9/fastpipe architecture

> Architecture diagram of the GitHub repository geezy9/fastpipe, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/geezy9/fastpipe
- Repository: https://github.com/geezy9/fastpipe
- Video tour (about a minute): https://gitdiagram.com/geezy9/fastpipe/video

## Overview

FastPipe is a typed-object .NET shell: users enter commands in a REPL or as a one-shot command, the shell tokenizes and splits pipelines, dispatches commands, and presents their results. Built-ins span core shell operations, filesystem and primitive operations, collection transforms, and serialization/deserialization; process-based plugins extend command execution. The graph reflects sampled source and README capabilities; links to unsampled command implementations are limited to registration or documented capability evidence.

Main entry points: [`UserFacingConsole.cs`](https://github.com/geezy9/fastpipe/blob/master/UserFacingConsole.cs) (Shell console), [`Extensions/BuiltInCommands.cs`](https://github.com/geezy9/fastpipe/blob/master/Extensions/BuiltInCommands.cs) (Core commands), [`Extensions/Dispatcher.cs`](https://github.com/geezy9/fastpipe/blob/master/Extensions/Dispatcher.cs) (Command dispatcher), [`Program.cs`](https://github.com/geezy9/fastpipe/blob/master/Program.cs) (Application entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Shell workflow"]
  node_program["Application entry<br/>[Program.cs]"]
  node_console["Shell console"]
  node_dispatcher["Command dispatcher<br/>[Dispatcher.cs]"]
  node_renderer["Console renderer<br/>[ConsoleRenderer.cs]"]
end

subgraph group_commands["Command capabilities"]
  node_builtin["Core commands<br/>[BuiltInCommands.cs]"]
  node_filesystem["Filesystem commands"]
  node_primitive["Primitive commands"]
  node_collections["Collection commands"]
  node_serialize["Serialization"]
  node_deserialize["Deserialization"]
  node_structured["Structured data access"]
end

subgraph group_plugins["Plugin execution"]
  node_plugins["Plugin loader<br/>[PluginLoader.cs]"]
  node_process["Process command runner"]
  node_executable(("External executable"))
end

subgraph group_runtime["Typed runtime"]
  node_commandcontext["Command context<br/>[CommandContext.cs]"]
  node_interface["Command interface<br/>[IShellCmd.cs]"]
  node_baseobj["Typed objects<br/>[BaseObject.cs]"]
  node_pool["Object pool<br/>[Runtime.cs]"]
  node_pipenode["Pipeline node model<br/>[PipeNode.cs]"]
  node_source["Source model<br/>[Source.cs]"]
end

node_user(("Shell user"))

node_user -->|"starts shell"| node_program
node_program -->|"starts console"| node_console
node_console -->|"dispatches commands"| node_dispatcher
node_program -->|"uses rendering"| node_renderer
node_console -.->|"renders results"| node_renderer
node_builtin -->|"registers commands"| node_dispatcher
node_console -->|"initializes commands"| node_builtin
node_builtin -->|"registers commands"| node_collections
node_builtin -->|"registers commands"| node_serialize
node_builtin -->|"registers commands"| node_deserialize
node_dispatcher -->|"dispatches through"| node_interface
node_dispatcher -->|"falls back to"| node_process
node_console -->|"loads plugins"| node_plugins
node_plugins -->|"registers commands"| node_dispatcher
node_plugins -->|"executes plugins"| node_process
node_process -->|"starts process"| node_executable
node_interface -->|"accepts context"| node_commandcontext
node_commandcontext -->|"releases objects"| node_pool
node_pool -->|"rents and returns"| node_baseobj
node_collections -->|"reads members"| node_structured
node_serialize -->|"enumerates members"| node_structured
node_pipenode -->|"references source"| node_source

click node_program "https://github.com/geezy9/fastpipe/blob/master/Program.cs"
click node_console "https://github.com/geezy9/fastpipe/blob/master/UserFacingConsole.cs"
click node_dispatcher "https://github.com/geezy9/fastpipe/blob/master/Extensions/Dispatcher.cs"
click node_renderer "https://github.com/geezy9/fastpipe/blob/master/ConsoleRenderer.cs"
click node_builtin "https://github.com/geezy9/fastpipe/blob/master/Extensions/BuiltInCommands.cs"
click node_filesystem "https://github.com/geezy9/fastpipe/blob/master/Extensions/FileSystemCommands.cs"
click node_primitive "https://github.com/geezy9/fastpipe/blob/master/Extensions/PrimitiveCommands.cs"
click node_collections "https://github.com/geezy9/fastpipe/blob/master/Extensions/Collections/CollectionCommands.cs"
click node_serialize "https://github.com/geezy9/fastpipe/blob/master/Extensions/Serializers/SerializerCommands.cs"
click node_deserialize "https://github.com/geezy9/fastpipe/blob/master/Extensions/Deserializers/DeserializerCommands.cs"
click node_structured "https://github.com/geezy9/fastpipe/blob/master/Extensions/StructuredDataAccess.cs"
click node_plugins "https://github.com/geezy9/fastpipe/blob/master/Extensions/PluginLoader.cs"
click node_process "https://github.com/geezy9/fastpipe/blob/master/Extensions/ExternalProcessCommandRunner.cs"
click node_commandcontext "https://github.com/geezy9/fastpipe/blob/master/Extensions/CommandContext.cs"
click node_interface "https://github.com/geezy9/fastpipe/blob/master/Interfaces/IShellCmd.cs"
click node_baseobj "https://github.com/geezy9/fastpipe/blob/master/Models/BaseObject.cs"
click node_pool "https://github.com/geezy9/fastpipe/blob/master/Runtime.cs"
click node_pipenode "https://github.com/geezy9/fastpipe/blob/master/Models/PipeNode.cs"
click node_source "https://github.com/geezy9/fastpipe/blob/master/Models/Source.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_program,node_console,node_dispatcher,node_renderer,node_user toneBlue
class node_builtin,node_filesystem,node_primitive,node_collections,node_serialize,node_deserialize,node_structured toneAmber
class node_plugins,node_process,node_executable toneMint
class node_commandcontext,node_interface,node_baseobj,node_pool,node_pipenode,node_source toneRose
```

## Components

### Shell workflow

- [Application entry](https://github.com/geezy9/fastpipe/blob/master/Program.cs): `Program.cs`
- [Shell console](https://github.com/geezy9/fastpipe/blob/master/UserFacingConsole.cs): `UserFacingConsole.cs`
- [Command dispatcher](https://github.com/geezy9/fastpipe/blob/master/Extensions/Dispatcher.cs): `Extensions/Dispatcher.cs`
- [Console renderer](https://github.com/geezy9/fastpipe/blob/master/ConsoleRenderer.cs): `ConsoleRenderer.cs`

### Command capabilities

- [Core commands](https://github.com/geezy9/fastpipe/blob/master/Extensions/BuiltInCommands.cs): `Extensions/BuiltInCommands.cs`
- [Filesystem commands](https://github.com/geezy9/fastpipe/blob/master/Extensions/FileSystemCommands.cs): `Extensions/FileSystemCommands.cs`
- [Primitive commands](https://github.com/geezy9/fastpipe/blob/master/Extensions/PrimitiveCommands.cs): `Extensions/PrimitiveCommands.cs`
- [Collection commands](https://github.com/geezy9/fastpipe/blob/master/Extensions/Collections/CollectionCommands.cs): `Extensions/Collections/CollectionCommands.cs`
- [Serialization](https://github.com/geezy9/fastpipe/blob/master/Extensions/Serializers/SerializerCommands.cs): `Extensions/Serializers/SerializerCommands.cs`
- [Deserialization](https://github.com/geezy9/fastpipe/blob/master/Extensions/Deserializers/DeserializerCommands.cs): `Extensions/Deserializers/DeserializerCommands.cs`
- [Structured data access](https://github.com/geezy9/fastpipe/blob/master/Extensions/StructuredDataAccess.cs): `Extensions/StructuredDataAccess.cs`

### Plugin execution

- [Plugin loader](https://github.com/geezy9/fastpipe/blob/master/Extensions/PluginLoader.cs): `Extensions/PluginLoader.cs`
- [Process command runner](https://github.com/geezy9/fastpipe/blob/master/Extensions/ExternalProcessCommandRunner.cs): `Extensions/ExternalProcessCommandRunner.cs`
- **External executable**

### Typed runtime

- [Command context](https://github.com/geezy9/fastpipe/blob/master/Extensions/CommandContext.cs): `Extensions/CommandContext.cs`
- [Command interface](https://github.com/geezy9/fastpipe/blob/master/Interfaces/IShellCmd.cs): `Interfaces/IShellCmd.cs`
- [Typed objects](https://github.com/geezy9/fastpipe/blob/master/Models/BaseObject.cs): `Models/BaseObject.cs`
- [Object pool](https://github.com/geezy9/fastpipe/blob/master/Runtime.cs): `Runtime.cs`
- [Pipeline node model](https://github.com/geezy9/fastpipe/blob/master/Models/PipeNode.cs): `Models/PipeNode.cs`
- [Source model](https://github.com/geezy9/fastpipe/blob/master/Models/Source.cs): `Models/Source.cs`

### Other components

- **Shell user**

## Connections

- Shell user → Application entry: starts shell (evidence: `README.md`)
- Application entry → Shell console: starts console (evidence: `Program.cs`)
- Shell console → Command dispatcher: dispatches commands (evidence: `UserFacingConsole.cs`)
- Application entry → Console renderer: uses rendering (evidence: `Program.cs`)
- Shell console → Console renderer: renders results
- Core commands → Command dispatcher: registers commands (evidence: `Extensions/BuiltInCommands.cs`)
- Shell console → Core commands: initializes commands (evidence: `UserFacingConsole.cs`)
- Core commands → Collection commands: registers commands (evidence: `Extensions/BuiltInCommands.cs`)
- Core commands → Serialization: registers commands (evidence: `Extensions/BuiltInCommands.cs`)
- Core commands → Deserialization: registers commands (evidence: `Extensions/BuiltInCommands.cs`)
- Command dispatcher → Command interface: dispatches through (evidence: `Extensions/Dispatcher.cs`)
- Command dispatcher → Process command runner: falls back to (evidence: `Extensions/Dispatcher.cs`)
- Shell console → Plugin loader: loads plugins (evidence: `UserFacingConsole.cs`)
- Plugin loader → Command dispatcher: registers commands (evidence: `Extensions/PluginLoader.cs`)
- Plugin loader → Process command runner: executes plugins (evidence: `Extensions/PluginLoader.cs`)
- Process command runner → External executable: starts process (evidence: `Extensions/ExternalProcessCommandRunner.cs`)
- Command interface → Command context: accepts context (evidence: `Interfaces/IShellCmd.cs`)
- Command context → Object pool: releases objects (evidence: `Extensions/CommandContext.cs`)
- Object pool → Typed objects: rents and returns (evidence: `Runtime.cs`)
- Collection commands → Structured data access: reads members (evidence: `Extensions/Collections/CollectionCommands.cs`)
- Serialization → Structured data access: enumerates members (evidence: `Extensions/Serializers/SerializerCommands.cs`)
- Pipeline node model → Source model: references source (evidence: `Models/PipeNode.cs`)
