Vinxi Kernel · System Map

Component mind map — what's built, what's next, how it plays together

The kernel is a hexagon: a small core of verbs and a commit path, ringed by 14 ports that adapters plug into. Everything above the core is a client of a running kernel; everything below is a swappable implementation. Grounded in crates/ as it stands today.

Built · on or near main
Kernel core (the hexagon)
Yet to build / in flight
Request & control flow
01Clients everything is a client of a running kernel
Clientstalk to the kernel through one seam — never to the core directly
vinxi-cli
Agent-first grammar · fixed verbs × discovered nouns · playbooks (QuickJS)
Apps / OS Shell
Launcher · surfaces · registry-driven  (type:"code" surfaces)
vinxi-worker
Job dispatch · JobHandler registry · consumes the queue
External callers
Scripts · AI agents · anything over HTTP
▼
02Transport plane one method per syscall — the A→B seam
KernelClientthe transport seam · CLI & apps depend only on this trait
LocalKernelClient
In-process — the kernel embedded directly
HttpKernelClient
Over the wire — governed HTTP seam
vinxi-kernel-server
HTTP · 16 syscalls (syscall_route!) · /sys/describe · serve · doctor
gRPC + HTTP gateway
Generic-wire-now / typed-later · protocol convergence
Seam of the moment. KernelClient is where the language/protocol-convergence work lands — swap transports, add the typed wire, expose /sys/describe — without the core noticing.
▼
03Three verbs vinxi-kernel-verbs · vinxi-query-ir
Protocol surfaceevery syscall is one of three verbs, carrying an Op
QUERY
Reads · resolved through the query IR
ACT
Governed writes · human/machine authority · undo = compensating Act
ASSERT
System / machine writes · series & alarms
Ops
create_entity · assert_link · install_document · assert_entity_state · assert_series · read_series · raise_alarm · transition_ticket · confirm_root_cause …
▼
04Kernel core the hexagon — small, deterministic, port-only
vinxi-kernel-corethe only thing that touches ports · convergent by construction
commit path
commit() ReplayDecision authorize() / OperationContext deterministic statement_ids (uuid-v5) ADR-0013 convergent replay
vinxi-kernel-verbsverb + Op definitions
vinxi-query-irquery intermediate representation
vinxi-device-runtimedriver-facing runtime
▼
0514 kernel ports the hexagonal contract · crates/ports/*
Portsthe core's entire vocabulary for the outside world — grouped by concern
Truth & World
StatementLogPortappend-only truth
WorldProjectionPortworld read
EntityGraphPortlinks / traverse
EntityQueryPortquery IR
Ontology & Series
OntologyPortschema / types
AssertStorePorttime series
BlobStorePortblobs
Device
DeviceRegistryPortdevices
SecretStorePortsecrets
State & Jobs
ResourceRegistryPortresources
ActionStorePortgoverned Acts
JobRequestPortjob requests
JobQueuePortworker queue
MaterializationRunPortmaterialize
Loopback. JobQueuePort is what vinxi-worker pulls from — the one arrow that runs back up to a client, closing the async loop.
▼
06Adapters one implementation of every port · crates/adapters/*
Adaptersswappable backends · verified by the same port-conformance suite
MemoryAdapter
In-memory · tests & dev · fastest pathall 14 ports
PostgresAdapter
Durable · local pg on :5433 / :5439all 14 ports
FsBlobStoreAdapter
Filesystem blob storageBlobStorePort
DuckDB spatial / carried Bun
One-binary north star · extension-free schema
07Cross-cutting crates
foundation/
vinxi-error · vinxi-ids · vinxi-value · vinxi-observability
registries/
device · ontology · resource
planes/
vinxi-plane-truth · vinxi-plane-world
services/
vinxi-binding · vinxi-client · vinxi-kernel-server · vinxi-worker
testkit/
vinxi-testkit — port-conformance run vs memory and postgres + fault-injecting decorators
08Yet to build / in flight
protocol
Language & protocol convergence
Vocab polish (*_syscall→*_op) · /sys/describe · gRPC + HTTP gateway
install
Kernel install-package Op (WS-2)
Unified manifest · realm projection via realmsFromOntology()
install
Surface-vocab reconciliation (WS-4)
Retire divergent realm.json fixture → ontology projection
os
OS Shell / App layer — Slice B
Registry-driven surfaces · entitlements · getSessionCapabilities
auth
Auth Slice 2 — kernel actor plane
system.* realm · actor envelope · ADR-0014
platform
One-binary platform
Carried Bun runtime · DuckDB spatial · extension-free schema
storage
LTAP log-sourced storage
Branch economics · promotion → µs queries (PR #43)
product
NOC map console — Milestone B
Surface Phase 3 · fault/ticket console
ai
AI layer
@vinxi/durable · @vinxi/agent-host
ontology
Value-type layer / index-hints (Track B)
+ link retraction → auto-resolve tickets & stale verdicts