Ananke.Organics
0.8.9
dotnet add package Ananke.Organics --version 0.8.9
NuGet\Install-Package Ananke.Organics -Version 0.8.9
<PackageReference Include="Ananke.Organics" Version="0.8.9" />
<PackageVersion Include="Ananke.Organics" Version="0.8.9" />
<PackageReference Include="Ananke.Organics" />
paket add Ananke.Organics --version 0.8.9
#r "nuget: Ananke.Organics, 0.8.9"
#:package Ananke.Organics@0.8.9
#addin nuget:?package=Ananke.Organics&version=0.8.9
#tool nuget:?package=Ananke.Organics&version=0.8.9
Ananke.Organics
Organic kernel architecture for Ananke - self-organizing workflow ecosystems with cell division, heartbeat sensing, triage routing, domain-affine memory, and evolutionary division policies.
What Is This?
Workflows are cells in a living kernel. They grow organically as they accumulate tools and knowledge, and when they grow too complex, they divide - the parent dies and two specialized peers emerge. The kernel is the organism; cells are mortal.
Glossary — biology metaphor to code
The docs (and this README) keep the biology metaphor because it's the clearest way to talk
about the design. The code mostly doesn't use that vocabulary directly — an early rename
swapped Cell* for Workflow* and Colony* for Mesh*/Host* almost everywhere. This is the
map, so "colony" and "cell" in prose are never a dead end when you go looking for the type:
| Metaphor | Means, in code | Type(s) |
|---|---|---|
| Colony | The organism as a whole — the process that hosts and coordinates cells | OrganicHost |
| Cell | An individual running unit, mortal, dies on division | a Workflow<TState> run, managed via IWorkflowHost |
| Cell division | A cell splitting into two specialized children; the parent dies | IWorkflowDivider |
| Cell replication | Cloning a cell for horizontal scaling (parent survives) | IWorkflowReplicator |
| Colony-wide signal / mesh | Aggregated per-cell health/capability data across the colony | IMeshAggregator, MeshSignal |
| Nervous system / heartbeat | Live capability sensing from running cells | ICapabilityMap |
| Lineage | Which cells were split from which parents | ILineageStore |
| Apoptosis / cell death | A cell stopping (crash, prune, or graceful stop) | IWorkflowHost.StopAsync, IHealingPolicy |
Older ADRs (pre-rename) use ICellDivider, ICellReplicator, IColonyAggregator, and nnke colony * — that vocabulary is gone from the tree; the full mapping lives in the banner of
20260418-adr-arch-010-organics-incomplete-tier3-analysis.md.
One exception: Topology/ColonyGraphBuilder and ColonyReportExporter (below) kept "Colony" in
their names.
Key Concepts
| Concept | Type | Description |
|---|---|---|
| Kernel | IWorkflowHost | Manages cell lifecycle (spawn, kill, list) |
| Nervous System | ICapabilityMap | Aggregates heartbeat signals into a live capability map |
| Triage Router | IRequestRouter | Routes requests to the right cell |
| Complexity Snapshot | ComplexitySnapshot | Structural surface-tension metrics, consumed directly by IDivisionPolicy implementations (no separate monitor interface) |
| Division Policy | IDivisionPolicy | Decides when and how to divide (ThresholdDivisionPolicy, ExperienceDrivenDivisionPolicy) |
| Approval Gate | IDivisionApprovalGate | Governance checkpoint between policy and divider — approve, deny, or escalate a division before it executes |
| Outcome Tracker | IDivisionOutcomeTracker | Records whether a division paid off, closing the learning loop back into policy |
| Cell Divider | IWorkflowDivider | Executes the actual division |
| Cell Replicator | IWorkflowReplicator | Clones a cell for scaling (original lives) |
| Domain Affinity | DomainAffinityMemory | Biases memory recall toward a cell's domain |
Package Structure
Ananke.Organics/ Kernel/ - IWorkflowHost, InProcessWorkflowHost, lifecycle events, IWorkflowReplicator Sensing/ - WorkflowSignal, ICapabilityMap, IRequestRouter Division/ - ComplexitySnapshot, IDivisionPolicy (Threshold/ExperienceDriven), IWorkflowDivider, DomainAffinityMemory, IDivisionOutcomeTracker, FailureClassifier Approval/ - IDivisionApprovalGate (Auto/Budget/Callback/Llm), governs whether a division proceeds Review/ - IWorkReviewGate (Auto/Callback/Llm/Quorum), human-in-the-loop review of in-flight work Healing/ - IHealingPolicy, ThresholdHealingPolicy, HealthSnapshot Topology/ - ColonyGraphBuilder, GodNodeDetector, ColonyReportExporter
Topology — Colony graph and reporting
The Topology/ slice projects the live mesh state into an IKnowledgeGraph
(from Ananke.Abstractions.Graph) so that structural patterns become queryable
and reportable without changing any operational component.
| Type | Description |
|---|---|
ColonyGraphBuilder |
Reads ICapabilityMap, ILineageStore, and optional RoutingAffinityTracker; writes cell/domain/tool nodes and relationship edges |
GodNodeDetector |
Returns top-k cells by degree centrality that exceed a configurable threshold |
ColonyReportExporter |
Writes colony.json (machine-readable snapshot) and COLONY_REPORT.md (operator summary) |
See Topology/README.md for node/edge vocabulary and usage examples.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Ananke.Design (>= 0.8.9)
- Ananke.Learning (>= 0.8.9)
NuGet packages (4)
Showing the top 4 NuGet packages that depend on Ananke.Organics:
| Package | Downloads |
|---|---|
|
Ananke.AspNetCore
ASP.NET Core integration helpers for Ananke — SSE streaming, ChatSessionEvent-to-SSE bridging, and state-machine endpoint utilities. |
|
|
Ananke.Platforms.Slack
Slack adapter for Ananke — bridges Slack Bot events (Socket Mode and Events API) to Ananke agent workflows via IMessagePlatformAdapter. Provides services.AddAnankeSlack() for DI registration. |
|
|
Ananke.Federation
Federation hub for Ananke — deploy, monitor, and supervise agentic workflows across cloud platforms (Vertex AI, Claude Managed Agents) with organic mesh coordination. |
|
|
Ananke.Roles
Role catalog, manifest generation, and studio host wiring for persona-driven Ananke applications. |
GitHub repositories
This package is not used by any popular GitHub repositories.