The Human & Machine
Semantic Scripting Language
Capability-bounded semantic cells and modules that type-check, enforce compile-time identifier firewall rules, compile once to deterministic bytecode, and execute repeatedly on the same handle across WASM, desktop, and 10D continuum targets.
Live In-Browser WASM Verification
Interactive verification jobs executed directly by the shipped vibe-wasm runtime in this browser tab:
checked cell, CompiledCell.compile, and run() ×2 on a retained bytecode handle.
Checked cell
Type-check a cell and verify capability leases before execution.
CompiledCell.compile
Compile source once into a reusable bytecode cell handle.
CompiledCell.run
Run ×2 on the retained handle without re-parsing source.
Why VibeScript? A Semantic & Capability-Bounded Execution Layer
VibeScript is engineered for applications where data meaning, ontological provenance, capability authority, and deterministic replay are core architectural requirements rather than afterthoughts bolted onto untyped objects.
VibeScript (spanning the vibe-0.1 workshop/cell dialect and vibe-0.03 continuum/quantum kernel bindings) is the native scripting layer of QualiaDB and the Poet creative environment.
It is a statically checked, capability-bounded language engineered with zero heap allocations in Tier-1 hot paths,
first-class RDF 1.2 and SPARQL semantics, verifiable deontic/epistemic modalities, and a compile-time identifier firewall (IDF-04).
Across the 105 capability families, 1,121 bound Family.method host operations
(Cosmic.*, LinearAlgebra.*, Quantum.*, GraphDatabase.*, BotanicalAnatomy.*, …)
bind explicitly through using Family; declarations and the four-operation vibe-host-0.1 ABI.
Autonomous agents and IDE tools self-repair directly from structured vibe::diagnose(src) JSON diagnostics.
Reactive Cell Graphs
Pure, high-frequency formulas driving desktop UI manifolds and QApps.
Cells form dependency DAGs with bounded evaluation, compile-once handle reuse (CompiledCell), and strict cycle detection. The hot evaluator executes without heap allocations.
Signed Agent Modules
Cryptographically signed programs that query and mutate 48-byte NQuin knowledge graphs.
Every external capability (graph query, network pulse, sensor feed) requires an explicit using lease grant and execution route, allowing the host to deny or diagnose unavailable authority with E300.
Deontic & Event Hooks
Deterministic lifecycle handlers such as on pulse:message(...) and on tick().
Obligations, permissions, and prohibitions evaluate directly against the QualiaDB deontic logic engine; host effects remain explicit rather than silently mocked in standalone browser targets.
Omni-Scale Coordinate System (OCS) & Cosmic Primitives (OCS-10–OCS-13)
VibeScript natively embeds the Omni-Scale Coordinate System (OCS) across crates/vibe/src/cosmic/, bridging sub-atomic Planck scales (L-2) to cosmological horizons (L12, $z > 10$) without floating-point catastrophic cancellation. Programs lease using Cosmic; to invoke 27 dedicated cosmic bytecode opcodes (0xA0–0xBA) alongside NQuin cosmic pose opcodes (0x50–0x55):
27 Cosmic Opcodes (0xA0–0xBA) & NQuin Poses
Bytecode dispatch covers WGS84 geodetic transforms, IAU astrometry, Lorentz boosts, Schwarzschild/Kerr metric tensors, and FLRW comoving integration (`0xA0`–`0xBA`), paired with NQuin predicate opcodes OP_COSMIC_POSE (0x50), OP_REALM_TRANSIT (0x51), OP_OBSERVER_FIBER (0x53), OP_MICRO_POSE (0x54), and OP_ELEMENT_COLLAPSE (0x55).
USRI & 16-Byte CB-USRI Grounding (MSB=0)
Every spatial frame grounds to a Universal Spatial Reference Identifier (urn:omni:v1:L3:sol:earth:wgs84:...) or a 16-byte compact binary CB-USRI (`CompactBinaryUsri`). In 48-byte NQuin records, cosmic context tokens set MSB=0 with a 56-bit FNV-1a realm hash in bits [0..55] of context.
Relativistic Lorentz Boosts (apply_lorentz_boost_into)
OCS-10 implements exact proper orthochronous Lorentz transformations $\Lambda \in \mathrm{SO}^+(1,3)$ via apply_lorentz_boost_into, computing $\gamma = (1 - \beta^2)^{-1/2}$, preserving the Minkowski spacetime interval $s^2 = -(ct)^2 + x^2 + y^2 + z^2$, and failing closed on superluminal velocities ($|\boldsymbol{\beta}| \ge 1$).
IAU 2006/2000B ICRS → ITRS Astrometry
OCS-11 couples Bowring's closed-form WGS84 ↔ ECEF ↔ ENU geodetic solver with IAU 2006/2000B precession-nutation and Earth Rotation Angle (ERA) matrices to rotate inertial barycentric sky coordinates (ICRS) into terrestrial ITRS frames at micro-arcsecond precision.
Flat $\Lambda\text{CDM}$ Gauss–Kronrod $G_7/K_{15}$ Comoving Distance
OCS-12 integrates comoving radial distance $\chi(z) = \frac{c}{H_0}\int_0^z \frac{\mathrm{d}z'}{E(z')}$ ($H_0 = 67.4\text{ km/s/Mpc}$, $\Omega_{m,0} = 0.315$) using 15-point Gauss–Kronrod $G_7/K_{15}$ quadrature under ExactnessProfile::CertifiedBand, plus comoving intercept solver intercept_vector_comoving with horizon guard BeyondCosmologicalHorizon.
10D Observer Frustum Projection (OCS-13)
OCS-13 combines camera-relative FloatingOrigin translation (splitting $10^{26}\text{ m}$ coordinates into anchor + local f32 delta) with 10D observer fiber frustum projection, streaming relativistic aberration and redshift-corrected slices directly into the WebGPU volumetric renderer.
using Cosmic; // OCS-10..13: ICRS -> ITRS astrometry, Lorentz boost, and flat LCDM G7/K15 comoving distance effect fn deep_space_telemetry() -> Record { let ecef = Cosmic.geodetic_to_ecef({ lat_deg: -37.8136, lon_deg: 144.9631, alt_m: 31.0 }); let boosted = Cosmic.apply_lorentz_boost({ ct_m: 0.0, x_m: ecef.x_m, y_m: ecef.y_m, z_m: ecef.z_m, beta_x: 0.12, beta_y: 0.0, beta_z: 0.0 }); let comoving = Cosmic.comoving_distance_mpc({ redshift_z: 1.45 }); return { ecef: ecef, boosted: boosted, comoving: comoving }; }
Compile-Time Identifier Fabric Firewall (IDF-04 — Rules F5-A through F5-F)
In accordance with the Qualia Decentralized Network Fabric (QDNF) ontological boundary (handle ≠ human),
vibe::check::fabric_guard executes a mandatory static analysis pass over every VibeScript AST before bytecode emission.
Any attempt to compute surveillance/entity-fusion scores (person_score, identity_confidence, same_person), execute cross-plane Who joins, or cast an instrument handle, credential, location coordinate, or biometric sample into a living NaturalAgent is rejected at compile time with diagnostic E100 and a structured FabricSuggestedFix payload:
| Rule ID | Prohibited Pattern (Compile-Time Rejected) | vibe::check::fabric_guard Enforcement & Suggested Fix |
|---|---|---|
F5-A |
did_as_whoCasting a cryptographic Did directly to NaturalAgent or assigning a DID to a who / natural_agent field |
A did:* identifier is a rotatable cryptographic Instrument, never the human being. Fix kind: natural_agent_with_instrument_binding (bind via living-SHACL delegation lease). |
F5-B |
vc_verified_as_truthTreating a VerifiableCredential signature check as ontological graph truth (as Truth) without epistemic provenance |
A valid cryptographic signature proves only who signed a claim, not that the claim is true. Fix kind: claim_opinion_evidence (wrap in ClaimOpinion on the artifact-OWL plane). |
F5-C |
qrc_or_observer_as_person_join_keyUsing a spatial QrcCoordinate, USRI, or ObserverFrame as a primary key for person identity joins |
Where an observation occurs is not who a person is. Cross-plane spatial-to-Who joins are forbidden. Fix kind: spatiotemporal_handle_join (SpatiotemporalHandle). |
F5-D |
biometric_instance_as_whoCasting a BiometricInstance (template/hash) to NaturalAgent or using it as a global person identifier |
Biometric captures are revocable sensor measurements requiring scoped consent, not permanent personhood keys. Fix kind: biometric_family_with_consent (living-SHACL). |
F5-E |
natural_agent_as_owl_thingTyping a living NaturalAgent as an immutable owl:Thing / OwlThing artifact |
Living humans belong to the context-gated, revocable living-SHACL plane, never static open-world artifact-OWL inference. Fix kind: living_shacl_natural_agent. |
F5-F |
ai_agent_or_same_as_person_collapseCollapsing an AiAgent / MachineDeviceId into NaturalAgent, invoking owl:sameAs on persons, or calling person_score / identity_confidence / same_person |
Autonomous instruments must link to a sponsoring human guardian via explicit liability edges; probabilistic entity-resolution anti-features are banned. Fix kind: instrument_with_sponsor_natural_agent. |
VibeScript vibe-0.03 Physics, Quantum & Etalon Continuum Bindings
Alongside the vibe-0.1 UI and reactive cell surface, the vibe-0.03 kernel dialect binds deterministic quantum chemistry, 10D binary containers, and the 64 Hz etalon-sim multi-physics engine directly into the 42 MiB Sentinel arena:
Quantum Statevector & Hamiltonian Circuits (Quantum.*)
Constructs variational quantum eigensolver (VQE) ansätze, Trotterized Hamiltonian time-evolution circuits, and Hartree-Fock / DFT electronic structure integrals (`STO-3G`, `def2-SVP`, RHF/UHF DIIS convergence to $10^{-8}\text{ E}_{\text{h}}$). Final statevector amplitudes map deterministically to `did:q42` topological `NQuin` pointers via the `qualia-q-forge` QGroup scheduler.
10D Containers (Container10D, M64, EMF64)
Mounts zero-copy Container10D (.10d) archives containing procedural geometry (PROC1), ontological graph slices (EONT1), material response profiles (MRP1), and PGA skeletons (SKL1). Streams 64-byte aligned 10D manifold records (M64) and 4D electromagnetic field volumetric tensors (EMF64) directly to GPU compute queues.
etalon-sim Multi-Physics Integration
Couples VibeScript `on tick()` hooks to the deterministic 64 Hz (`15.625 ms`) `etalon-sim` solver: hybrid 3D Signed Distance Field (SDF) + Exact B-Rep XPBD constraints, Rank-2 Cauchy stress tensor fracture cleavage, Projective Geometric Algebra ($\mathbf{Cl}(3,0,1)$) motor skinning, and Holosonic 3D wavefield synthesis.
using Quantum, SceneGraph10D, Physics; // vibe-0.03: Couple VQE Hamiltonian circuit with M64 / EMF64 10D container & etalon-sim effect fn step_quantum_continuum(mol_did: Iri) -> Record { let vqe = Quantum.vqe_hamiltonian_step({ basis: "STO-3G", ansatz_depth: 4, convergence_hartree: 0.00000001 }); let mount = SceneGraph10D.LivingContainerMount({ container_kind: "Container10D", manifold_record: "M64", field_tensor: "EMF64", target: mol_did }); return { ground_energy_eh: vqe.energy_eh, quin_ptr: vqe.statevector_quin, mount: mount }; }
Where Vibe Fits Beside Other Runtimes
Vibe is not a universal replacement for JavaScript, Python, Lua, or embedded Rust interpreters. Its advantage appears when a program requires a typed semantic graph, declared capability authority, compile-time anti-surveillance guarantees, Q42 portability, or an auditable execution boundary.
| Dimension | VibeScript (vibe-0.1 / 0.03) | JavaScript / Node.js | Python (CPython) | Lua / LuaJIT | Rhai / WASM Lite |
|---|---|---|---|---|---|
| Security & Sandboxing | Capability-Bounded + IDF-04 Compile-time leases & fabric firewall; no ambient I/O |
Host-Defined Web and Node hosts expose different permission and sandbox models |
Open Ambient Full OS/filesystem reach; monkey-patchable |
Manual Sandbox Requires table-stripping; easily bypassed |
Engine Bounded Host bindings, but lacks deontic norm leases |
| Hot-Path Allocation | Tier-1 Zero Heap Fixed stack buffers & 42MB Sentinel arena |
Managed Heap Excellent general-purpose tooling; GC-managed heap allocation |
Heavy Heap Reference counting + cyclic GC pauses |
Incremental GC Lightweight, but non-zero heap allocation |
Heap Allocations Extensive Box/Vec/String usage |
| Graph & RDF Native | Native RDF 1.2 & SPARQL 48-byte Super-Quins, <<( s p o )>>, graph? |
Libraries available Flexible RDF tooling, with graph semantics chosen by the application |
rdflib / networkx Heap-allocated Python object graphs |
None No native semantic data structures |
None Generic map/arrays only |
| Determinism & Audit | ADR 0003 ExactnessProfile Exact 256-bit CRT, CertifiedBand, and DeterministicBounded replay |
Application-defined Determinism is achievable, but scheduling and host APIs vary |
Application-defined Clock, I/O, and native extension choices remain external |
Partially Deterministic Hash table order nondeterminism |
Varies Depends on host engine configuration |
| Modal & Deontic Logic | Built-In Modalitiesobligate, permit, knows, always |
Libraries / services Can integrate solvers, but has no language-level modality surface |
None External SAT/Z3 solver bindings only |
None No formal verification support |
None Basic conditional control flow only |
| AI / LLM Generation | GBNF & EBNF Constrained Strict grammar decode + JSON diagnose self-repair |
Grammar Ambiguous Susceptible to runtime syntax & type hallucinations |
Indentation Fragile Whitespace errors frequently break generation |
Small Grammar Clean syntax, but runtime fails silently |
Medium Custom syntax not paired with structured diagnostic repair |
| Physical & Cosmic Types | First-Class Quantities & OCS400ms, oklch(...), USRI, 27 cosmic opcodes |
Raw Numbers No built-in unit dimension algebra |
Pint / astropy External runtime library dependencies |
Raw Doubles No unit or color space abstractions |
Primitive Types Requires custom Rust type registration |
| Runtime Footprint | Target-dependent WASM Compact standalone WASM cells or full native-bridge daemon |
30 MB – 100 MB+ V8 engine binary footprint |
20 MB – 50 MB CPython standard library footprint |
~300 KB Minimal C runtime |
~1 MB – 3 MB Rust interpreter bundle |
VibeScript 0.1 Feature Highlights
Workshop Dialect
Human-friendly syntax using Animation; with clean method calls like Animation.orbit_spin(t). Unleased method paths fail closed at check-time.
Two-Way Data Binding
Native bind slider <-> volume using Clamp[0.0, 1.0] resolve latest; keeps reactive states synchronised across UI widgets.
Temporal Tweens & Springs
First-class interpolation with 0.0 ~ 10.0 over 400ms ease linear and dynamic physics dampening via spring(stiffness, damping).
Pure Non-Capturing Lambdas
Lightweight |x| expr pipelines for transformation like [1, 2, 3].map(|x| x * 2).filter(|x| x > 2) with zero closure escape overhead.
Ontological Vocab Chunks
Load domain ontologies (SNOMED, QUDT) as tree-shaken .n3 dependency chunks. Canonical IRIs are preserved with zero string table bloat.
Presentation Sheaves
Colour and pose are first-class values: oklch(0.72, 0.12, 230.0) plus Animation.orbit_spin, returned from main as a record the host can present.
Multi-Lingual Identifiers
Support for Chinese (locale zh;), Cyrillic, and Arabic identifiers. Golden CBOR-AST hashing guarantees identical execution across all locales.
Deontic Norm Enforcement
First-class obligate, permit, and forbid operators evaluate against the verified deontic engine, securing autonomous agent actions.
Stack Bytecode VM
VBC1 stack-based bytecode compiler and VM with 41 core opcodes + 27 cosmic opcodes for instant zero-copy serialization and deterministic sandboxed execution.
Diagnose JSON
Agent loop is vibe::diagnose(src) → error_code, byte span, suggested_fix. Codes E001–E800. Invalid source is never executed.
Cosmic & LinearAlgebra Hosts
Live catalog ids such as Cosmic.geodetic_to_ecef and LinearAlgebra.matmul sit on the same four-op host ABI (vibe-host-0.1). Browser LocalHost runs Cosmic kernels in-process; daemon-backed families fail closed with E300.
Canonical VibeScript Demos
Explore real VibeScript programs demonstrating reactive graphics, two-way bindings, clinical vocab, and Cosmic geodesy:
1. 3D Manifold Animation & Presentation Sheaf
using Animation, HID; // Reactive cells stepping on live temporal ticks effect cell t := time.now(); cell pose := Animation.orbit_spin(1.0); cell glow := oklch(0.72, 0.12, 230.0); // Declarative visual surface present block present lamp { color: glow pose: pose }
2. Two-Way UI Data Binding with Clamp & Resolve
let mut volume = 0.2; let mut slider = 0.2; // Two-way reactive bind with bounding clamp bind slider <-> volume using Clamp[0.0, 1.0] resolve latest; fn main() -> f64 { // Temporal tween easing return 0.0 ~ 10.0 over 400ms ease linear; }
3. Clinical Knowledge Graph & Tree-Shaken SNOMED Vocab
prefix snomed: <http://snomed.info/id/>; using GraphDatabase; // Tree-shaken vocabulary query resolved against bounded clinic chunk pure fn get_diagnosis() -> Iri { return snomed:386661006; // Fever (finding) } fn main() -> Iri { return get_diagnosis(); }
4. Cosmic geodesy (North Spring WGS84)
using Cosmic; effect fn main() -> Record { return Cosmic.geodetic_to_ecef({ lat_deg: -37.8, lon_deg: 144.9, alt_m: 0.0 }); }
0.0.41 EcoPunk 26.5 km Biological Continuum & 10D Scene Graph Capabilities (vibe-0.1)
Extending the 0.0.40 production baseline into release 0.0.41, VibeScript expands its capability surface with 18 first-class capabilities designed for the EcoPunk 26.5 km Biological Continuum and 10D Scene Graph. Every capability compiles directly into compact, relocatable VBC1 (.qbc) bytecode and invokes verified native kernels inside qualia-core-db::ecopunk_world and qualia-core-db::scene_graph_10d. Hot-path evaluations remain strictly zero-heap and bounded by the 42 MiB Prolog Sentinel ceiling. Read the full architectural breakdown in the v0.0.41 Architecture & Progress Roadmap.
BotanicalAnatomy (5 Capabilities)
Mechanistic vegetation biophysics, sapwood hydraulics, and subterranean nutrient trading:
BotanicalAnatomy.LSystemCanopy: Procedural generative branching grammar computing internode growth, apical dominance, bifurcation angles, and foliage mass under photosynthetic shading.BotanicalAnatomy.XylemHydraulicFlow: Hagen-Poiseuille pipe model computing sapwood pressure differentials, cavitation vulnerability curves, and VPD-driven transpiration loss.BotanicalAnatomy.MycorrhizalCarbonTrade: Subterranean fungal network trading soil N/P for plant photosynthetic carbon, establishing mutualistic nutrient flux equilibria.BotanicalAnatomy.PhotosyntheticField: Farquhar-von Caemmerer-Berry (FvCB) C3/C4 assimilation kinetics coupled with Ball-Berry stomatal conductance and RuBisCO carboxylation.BotanicalAnatomy.RootSoilReinforcement: Wu-Waldron root tensile strength model computing shear modulus enhancement, tensile pull-out resistance, and slope stability.
ZoologicalAnatomy (5 Capabilities)
Skeletal kinematics, Hill-type biomechanics, and limit-cycle locomotion controllers:
ZoologicalAnatomy.ArticulatedSkeleton: Projective Geometric Algebra ($\mathbf{Cl}(3,0,1)$) motor bone hierarchy calculating zero-heap forward kinematics and inverse chains.ZoologicalAnatomy.HillMuscleFiber: Three-element Hill model (CE, SEE, PEE) computing active force-length-velocity relations, elastic recoil, and tendon strain energy.ZoologicalAnatomy.CardiopulmonaryMetabolism: Dynamic allometric simulator computing stroke volume, heart rate, VO2 oxygen uptake, ATP yield, and lactic clearance.ZoologicalAnatomy.SensoryReceptiveField: Transducer mapping visual cone/rod distributions, cochlear frequency filters, and spatial mechanoreceptive receptive fields.ZoologicalAnatomy.LocomotionGait: Energy-optimal limit cycle gait scheduler coordinating limb duty factors, ground reaction forces, and gait phase transitions (walk ↔ trot ↔ gallop).
BiologicalOntology (3 Capabilities)
Phylogenetic classification, ecosystem trophic webs, and allostatic drives:
BiologicalOntology.TaxonomicLineage: Cladistic phylogenetic tree resolver linking NCBI Taxonomy and Wikidata IRIs with morphological trait inheritance.BiologicalOntology.TrophicCascade: Lotka-Volterra multi-species biomass dynamics modeling prey-predator cycles, carrying capacities, and keystone species cascades.BiologicalOntology.HomeostaticDrive: Allostatic regulatory drive system computing thirst, caloric need, thermoregulation, and circadian sleep debt potentials.
WorldContinuum (3 Capabilities)
Hydrological surface flows, microclimatic boundaries, and soil pedogenesis:
WorldContinuum.WatershedHydrology: 2D Shallow Water Equations (SWE) solving catchment runoff, infiltration, sediment transport, and river channel routing.WorldContinuum.MicroclimateCanopy: Atmospheric boundary layer model computing beneath-canopy temperature gradients, Beer-Lambert radiation attenuation, and humidity.WorldContinuum.SoilBiogeochemistry: Multi-pool Century soil organic matter model simulating microbial decomposition, humification, carbon sequestration, and mineralization.
SceneGraph10D (2 Capabilities)
High-dimensional spatio-temporal tensor streaming and living container mountings:
SceneGraph10D.TensorFieldStream: Zero-heap streaming pipeline feeding 10D spacetime tensors into GPU compute shaders for real-time field evaluation.SceneGraph10D.LivingContainerMount: Dynamic container mount manager binding compiled procedural.10dliving container chunks (PROC1,EONT1,MRP1,SKL1) into spatial partitions.
Canonical Vibe-0.1 Continuum Program
using BotanicalAnatomy, WorldContinuum, SceneGraph10D; // Step EcoPunk biological continuum within 64 Hz deterministic loop effect fn simulate_canopy_step(tree_did: Iri, vpd: f64) -> Record { // 1. Hagen-Poiseuille sapwood xylem flow & stomatal transpiration let xylem = BotanicalAnatomy.XylemHydraulicFlow({ sapwood_area_m2: 0.045, vpd_kpa: vpd, soil_water_potential_mpa: -0.42 }); // 2. Query 26.5 km catchment watershed hydrology for root recharge let hydro = WorldContinuum.WatershedHydrology({ easting_m: 32450.0, northing_m: 68120.0, dt_s: 0.015625 // 64 Hz timestep }); // 3. Stream updated 10D tensor field directly to GPU volumetric shader let stream_ack = SceneGraph10D.TensorFieldStream({ entity: tree_did, flux_rate: xylem.flux_kg_per_h }); return { xylem: xylem, hydro: hydro, streamed: stream_ack }; }
VibeScript Ecosystem & Developer Tooling
The VibeScript developer ecosystem is distributed across standalone tooling crates and extensions. Tooling validates a selected execution profile before a native-only call reaches a browser-only target: