Agentic Hub Docs

Nexus (Containers)

πŸ—ΊοΈ Nexus β€” Container System

The tree structure that gives every piece of content a "where does this belong?"

🎯 Purpose

Nexus is the container layer β€” a tree of areas, each with a compass (direction/purpose). When content arrives at the system, Nexus answers the question: "Where does this belong?"

Why Nexus is Phase 0: Without containers, content has no homes. The ingest system can't route. The distill workflow can't determine where outputs go. Everything else depends on Nexus existing.

🌳 Tree Structure

Vision: "Free Adrian" β€” reclaim time, health, presence through automation β”œβ”€β”€ 🏠 Life β”‚ β”œβ”€β”€ Health (yoga, emotional, physical) β”‚ β”œβ”€β”€ Family (baby planning, relationship) β”‚ β”œβ”€β”€ Property (investments, automation) β”‚ └── Personal (self-development, blog, expression) β”œβ”€β”€ πŸ’Ό Work (Mipos) β”‚ β”œβ”€β”€ Operations (team, hiring, SOPs) β”‚ β”œβ”€β”€ Sales (BD, pricing, Sunmi partnership) β”‚ β”œβ”€β”€ Tech (MIBOS, FinFlow, e-invoice) β”‚ └── Strategy (automation, scaling, exit plan) β”œβ”€β”€ πŸ’» Dev β”‚ β”œβ”€β”€ MIBOS (core platform) β”‚ β”œβ”€β”€ Tools (ATS, CLI constellation) β”‚ └── R&D (AI integration, research) └── πŸ€– Agentic (Hub) β”œβ”€β”€ Portal (UI, API, D1, reports) β”œβ”€β”€ CLI (Bifrost, tools, jobs) β”œβ”€β”€ Workflows (Clara, task, log, learn) β”œβ”€β”€ Knowledge (KB, memory, rules) └── Smart Todo / Thought Stream

πŸ“Š D1 Schema Design

nexus_nodes table

idTEXT PRIMARY KEY
parent_idTEXT
nameTEXT NOT NULL
levelINTEGER (L1=workspace, L2=area, L3=sub-area)
compassTEXT β€” direction/purpose for this area
descriptionTEXT β€” what this node covers
workspaceTEXT β€” Life/Work/Dev/Agentic
sort_orderINTEGER
created_at / updated_atTEXT (ISO)

projects table

idTEXT PRIMARY KEY
nameTEXT NOT NULL
nexus_node_idTEXT β€” FK to nexus_nodes
compassTEXT
statusTEXT (active/paused/archived)
areaTEXT (free-text for backward compat)
created_at / updated_atTEXT (ISO)

πŸ”— How Nexus Enables the Pipeline

Pipeline Stage

How Nexus Helps

/distill (routing)

Agent queries: "which nexus node?" to determine where to file outputs

Clara ingest

Match Smart Todo projects against nexus nodes for routing

Smart Todo (project list)

Clara syncs nexus nodes β†’ Smart Todo settings as project list

Vision chain

Task β†’ Project β†’ Nexus β†’ Vision β€” full purpose tracing

πŸ—οΈ API Endpoints (Planned)

Endpoint

Methods

Purpose

/api/nexus

GET/POST/PATCH/DELETE

Nexus node CRUD, tree retrieval

/api/projects

GET/POST/PATCH/DELETE

Project CRUD, linked to nexus nodes

πŸ“‹ Implementation Plan

Step

What

Status

D1 migration

Create nexus_nodes + projects tables

NOT DONE

API

/api/nexus + /api/projects

NOT DONE

Data fill

L1-L3 nodes with compass

NOT DONE

UI

Tree view + compass tooltip

NOT DONE

CLI

portal nexus list/getNOT DONE

Full spec: 260318 Nexus D1 and Projects/README.md