mindscript-runtime is the deterministic C++ execution engine for MindScript programs.
It consumes canonical protocol envelopes defined in mindseye-protocol and executes them under strict
budget, policy, and audit constraints.
This repository is execution, not definition.
MindScript is the language. This runtime is the machine that executes it.
The runtime is responsible for:
- Deterministic execution of MindScript programs
- Enforcing time and cost budgets
- Applying policy and trust constraints
- Producing auditable outcomes
- Emitting protocol-compliant results back into the Fabric
The runtime does not invent meaning. It executes meaning already defined elsewhere.
- C++ execution engine
- Budget enforcement logic
- Policy hooks
- Deterministic op dispatch
- Protocol encode / decode adapters
- Audit and outcome emission
- Protocol schemas
(those live inmindseye-protocol) - Google Workspace adapters
(those live in Google-specific executor repos) - Cloud gateways
- UI logic
- Business rules
- LLM orchestration logic
If it defines what something means, it does not belong here.
──────────────────────────┐ │ mindseye-protocol (law) │ └────────────┬─────────────┘ │ ┌────────────▼─────────────┐ │ mindscript-runtime │ ← THIS REPO │ (deterministic engine) │ └────────────┬─────────────┘ │ ┌────────────▼─────────────┐ │ executors / gateways │ │ (Google, Cloud, etc.) │ └──────────────────────────┘
The runtime depends on the protocol. Nothing depends on the runtime for definitions.
This repository must include mindseye-protocol as a submodule:
external/
└─ mindseye-protocol/
Add it with:
git submodule add https://github.com/PEACEBINFLOW/mindseye-protocol external/mindseye-protocol
git submodule update --init --recursive