# digitaldesignerjazz/solnet architecture

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

- Interactive diagram: https://gitdiagram.com/digitaldesignerjazz/solnet
- Repository: https://github.com/digitaldesignerjazz/solnet

## Overview

SolNet is an asynchronous mesh-networking and swarm-coordination library, with a small demo CLI. Its principal workflow is to start a node, join a Yggdrasil mesh, establish a Hyperspace tunnel, and coordinate swarm activity; NovaSwarm separately models tasks, agents, roles, and coordination feedback. The excerpts show the node’s networking calls and the swarm coordinator’s internal responsibilities. Yggdrasil, Hyperspace, and agent implementations were not fully shown, and the README contains no capability detail, so uncertain integrations and link-health behavior are not expanded.

Main entry points: [`src/solnet/nova_swarm/coordinator.py`](https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/nova_swarm/coordinator.py) (Swarm coordinator), [`src/solnet/nova_swarm/types.py`](https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/nova_swarm/types.py) (Shared swarm types), [`src/solnet/core.py`](https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/core.py) (SolNet node), [`src/solnet/nova_swarm/communication.py`](https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/nova_swarm/communication.py) (Swarm communication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry point"]
  node_cli["Demo CLI<br/>[cli.py]"]
end

subgraph group_network["Mesh networking"]
  node_node["SolNet node<br/>[core.py]"]
  node_ygg["Yggdrasil client<br/>[yggdrasil.py]"]
  node_tunnel["Hyperspace tunnel<br/>[hyperspace.py]"]
end

subgraph group_swarm["Swarm coordination"]
  node_coordinator["Swarm coordinator<br/>[coordinator.py]"]
  node_agent["Swarm agent<br/>[agent.py]"]
  node_communication["Swarm communication<br/>[communication.py]"]
end

subgraph group_models["Swarm models"]
  node_roles["Agent roles<br/>[roles.py]"]
  node_task["Task model<br/>[task.py]"]
  node_types["Shared swarm types<br/>[types.py]"]
end

node_user(("CLI user"))

node_user -->|"runs"| node_cli
node_cli -->|"starts demo"| node_node
node_node -->|"queries mesh"| node_ygg
node_node -->|"creates tunnel"| node_tunnel
node_coordinator -->|"assigns tasks"| node_agent
node_coordinator -->|"applies feedback"| node_agent
node_coordinator -->|"creates and updates"| node_task
node_coordinator -->|"imports roles"| node_roles
node_coordinator -->|"uses status"| node_types
node_roles -->|"uses role types"| node_types
node_task -->|"uses task status"| node_types
node_communication -->|"sends and receives"| node_tunnel
node_communication -->|"uses messages"| node_types

click node_cli "https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/cli.py"
click node_node "https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/core.py"
click node_ygg "https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/yggdrasil.py"
click node_tunnel "https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/hyperspace.py"
click node_coordinator "https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/nova_swarm/coordinator.py"
click node_agent "https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/nova_swarm/agent.py"
click node_communication "https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/nova_swarm/communication.py"
click node_roles "https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/nova_swarm/roles.py"
click node_task "https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/nova_swarm/task.py"
click node_types "https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/nova_swarm/types.py"

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_cli,node_user toneBlue
class node_node,node_ygg,node_tunnel toneAmber
class node_coordinator,node_agent,node_communication toneMint
class node_roles,node_task,node_types toneRose
```

## Components

### Entry point

- [Demo CLI](https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/cli.py): `src/solnet/cli.py`

### Mesh networking

- [SolNet node](https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/core.py): `src/solnet/core.py`
- [Yggdrasil client](https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/yggdrasil.py): `src/solnet/yggdrasil.py`
- [Hyperspace tunnel](https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/hyperspace.py): `src/solnet/hyperspace.py`

### Swarm coordination

- [Swarm coordinator](https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/nova_swarm/coordinator.py): `src/solnet/nova_swarm/coordinator.py`
- [Swarm agent](https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/nova_swarm/agent.py): `src/solnet/nova_swarm/agent.py`
- [Swarm communication](https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/nova_swarm/communication.py): `src/solnet/nova_swarm/communication.py`

### Swarm models

- [Agent roles](https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/nova_swarm/roles.py): `src/solnet/nova_swarm/roles.py`
- [Task model](https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/nova_swarm/task.py): `src/solnet/nova_swarm/task.py`
- [Shared swarm types](https://github.com/digitaldesignerjazz/solnet/blob/main/src/solnet/nova_swarm/types.py): `src/solnet/nova_swarm/types.py`

### Other components

- **CLI user**

## Connections

- CLI user → Demo CLI: runs (evidence: `src/solnet/cli.py`)
- Demo CLI → SolNet node: starts demo (evidence: `src/solnet/cli.py`)
- SolNet node → Yggdrasil client: queries mesh (evidence: `src/solnet/core.py`)
- SolNet node → Hyperspace tunnel: creates tunnel (evidence: `src/solnet/core.py`)
- Swarm coordinator → Swarm agent: assigns tasks (evidence: `src/solnet/nova_swarm/coordinator.py`)
- Swarm coordinator → Swarm agent: applies feedback (evidence: `src/solnet/nova_swarm/coordinator.py`)
- Swarm coordinator → Task model: creates and updates (evidence: `src/solnet/nova_swarm/coordinator.py`)
- Swarm coordinator → Agent roles: imports roles (evidence: `src/solnet/nova_swarm/coordinator.py`)
- Swarm coordinator → Shared swarm types: uses status (evidence: `src/solnet/nova_swarm/coordinator.py`)
- Agent roles → Shared swarm types: uses role types (evidence: `src/solnet/nova_swarm/roles.py`)
- Task model → Shared swarm types: uses task status (evidence: `src/solnet/nova_swarm/task.py`)
- Swarm communication → Hyperspace tunnel: sends and receives (evidence: `src/solnet/nova_swarm/communication.py`)
- Swarm communication → Shared swarm types: uses messages (evidence: `src/solnet/nova_swarm/communication.py`)
