# Nexus Ecosystem Analysis: NexusToolKit + NexusOS Integration Strategy

**Date:** December 26, 2025  
**Authors:** Markus Maiwald (Systems Architect), Leo AI (Lead Developer), Voxis Forge (AI)

## Project Vision
Nexus OS is the operating system of Libertaria's future: Military-grade security and modularity. Fast boot. No bloat. Hardened kernel. Zero GNUs given. A system designed to mean something.

The default Desktop uses KDE with systemd and is immutable and offers the nip package manager with Nippels (Nip Cells) as preferred packages and Nexters (Nexus Containers) as docker replacement.
The Pro Desktop is using Niri & Hyprland WM with only nip package manager.
The cloud enabled Servers are containerd / podman first and are especially suited for Kubernetes and IOT like deployments.
The rumk Hypervisor enables workloads suited for military and space exploration as well as science & simulations.

## Core Architecture
- **Language**: Nim (primary), Janus in the future
- **Package Manager**: `nip` CLI/TUI tool with `.npk` format
- **Filesystem**: GoboLinux-style `/Programs/App/Version/` hierarchy
- **Memory Management**: Nim's GC ARC for deterministic performance
- **Concurrency**: Hybrid async/spawn model for maximum throughput

---

## Architecture Decision (Non-Negotiable)

> **Rumk belongs in `nexus`, not `nip`.**

- **`nip`** = Package manager (grafting packages from Nix/PKGSRC/Pacman)
- **`nexus`** = System compiler/build toolkit (building systems and profiles like Rumk)

Container-agnostic pledge/unveil enforcement goes beyond Linux GPL limitations.

---

## Project Analysis

### NexusToolKit
- **Scope:** Universal package manager (nip), system compiler (nexus), UTCP protocol
- **Status:** nip MVP achieved, nexus ~50%
- **Key:** NIP grafting, nexus builds, NexusCell containerization

### NexusOS
- **Scope:** Five variants (Tiny, Micro, Core, Fleet, Unikernel)
- **Status:** Pre-alpha, Rumk hypervisor prototype Q1 2026
- **Key:** Rumk, ProvChain, BEB upgrades

---

## SSS Licensing Strategy: The Three-Layer Model

| Layer | License | Components |
|-------|---------|------------|
| **Core** | EUPL-1.2 + SSS | Rumk, nip, nexus, nexus-boot |
| **Extensions** | Apache 2.0 | NPKs, recipes, drivers, contrib |
| **Community** | CC0 | Docs, examples, configs |

### Why This Works
- **EUPL-1.2**: EU-governed copyleft, compatible with GPL, patent protection
- **SSS**: Foundation stewardship, trademark protection, commercial membership path
- **Apache 2.0**: Replaces MIT (more patent protection), permissive for extensions
- **CC0**: Maximum freedom for docs

### Commercial Path
| Tier | Fee | Benefits |
|------|-----|----------|
| Bronze | €500/yr | Closed-source NPKs |
| Silver | €2,000/yr | + Priority support |
| Gold | €10,000/yr | + Foundation seat |

**Verdict:** No MIT. Clean layers. European foundation-friendly.

---

## Nip Package Manager MVP Status

✅ **Completed:**
- Git LFS support (auto-detect, auto-pull after shallow clone)
- Configurable recipe repos via `NIP_RECIPE_REPO` env var
- Bootstrap CLI for package manager tools (nix, pkgsrc, gentoo)

✅ **Kept for Nexus:**
- `recipes/rumk/minimal-rumk.kdl`
- `recipes/rumk/scripts/build.sh` and `verify.sh`

❌ **Removed from Nip:**
- Rumk bootstrap (architectural alignment—belongs in nexus)

---

## Next Steps for Nexus

1. Port Rumk bootstrap to `nexus build rumk`
2. Integrate with profile system: `nexus build --profile=micro`
3. Use existing `recipes/rumk/` files

---

## Roadmap

| Quarter | Milestone |
|---------|-----------|
| Q1 2026 | Rumk v0.1, nexus-boot v1, Unikernel Prototype |
| Q2 2026 | Rumk v1.0, Nexus Micro ISO |
| Q3 2026 | Nexus Core (KDE/Hyprland workstation) |

**Success metric:** March 1, 2026 — live demo on VisionFive 2

---

*Last Updated: December 26, 2025*