VSAVM

The VM core and retrieval interaction

This page is a theory note. It expands the topic in short chapters and defines terminology without duplicating the formal specification documents.

The diagram has a transparent background and is intended to be read together with the caption and the sections below.

Related wiki pages: VM, event stream, VSA, bounded closure, consistency contract, macro-program.

Related specs: DS001, DS002.

Overview

The VM is the system's semantic core. It stores facts, rules, contexts, and traces and executes programs to construct state. Retrieval exists to reduce search cost by proposing candidates, but it does not decide what is true. The VM presents a conversational interface that mirrors large language models while operating on fundamentally different principles: explicit programs within a virtual machine rather than latent numerical states distributed across parameters.

VM state and memory model

The virtual machine maintains its complete operational state through four interconnected memory structures:

Instruction set architecture

A small, typed instruction set reduces absurd combinations and branching blow-ups. The key instruction categories are:

Execution modes

The VM operates in two primary modes:

State transitions are deterministic, enabling both forward execution and backward analysis for explanation generation.

Macro-instruction system

The macro-instruction system bridges primitive symbolic operations and complex reasoning patterns:

How retrieval interacts

VSA provides similarity-driven shortlists of schemas and macro programs. These shortlists are inputs to search and compilation, not outputs of truth. Every retrieved candidate must be validated by execution and closure to preserve the correctness contract under noise and paraphrase variation. Hypervectors enable rapid approximate nearest neighbor search; the VM then validates through precise symbolic matching.

Unified event stream representation

All input modalities converge into a canonical event stream with three essential components per event:

Reversibility is fundamental: every event must be expandable back to its constituents for source tracing and verification.

Engineering benefits

The explicit VM core makes it possible to unit test rules, regression test closure behavior, and audit decisions. Retrieval can be swapped or improved without changing semantics, because semantics are enforced by the VM and contract rather than by similarity ranking. Memory management uses reference counting, garbage collection, and caching with locality optimization for related facts and rules.

vm-core diagram
A compact VM core remains the authority; retrieval accelerates candidate selection without changing semantics. The four memory structures maintain complete operational state.

References

Symbolic execution (Wikipedia) Vector symbolic architecture (Wikipedia) Execution trace (Wikipedia) Virtual machine (Wikipedia)