Expand description
VibeScript (vibe-0.1) — a language for humans and machines.
Vibe is the scripting language (the JS replacement). Poet is the human creative environment and CLI that hosts Vibe; other hosts may too.
Copyright © 2026 Timothy Charles Holborn. All rights reserved. No JIT. No raw Quin overlay literals.
Re-exports§
pub use dag::ControlUnit;pub use dag::DagEdge;pub use dag::DagError;pub use dag::DagNode;pub use dag::DagPipeline;pub use dag::ExecutionState;pub use dag::JudgeClaim;pub use dag::JudgeFrame;pub use dag::NodeEffect;pub use dag::NodeStatus;pub use dag::RouterStrategy;pub use dag::MAX_DAG_EDGES;pub use dag::MAX_DAG_NODES;pub use dag::MAX_JUDGE_CLAIMS;pub use dag::MAX_NODE_IO;pub use deontic_interrupt::AgentSandbox;pub use deontic_interrupt::DeonticInterrupt;pub use deontic_interrupt::InterruptType;pub use deontic_interrupt::LeaseError;pub use deontic_interrupt::Phase;pub use deontic_interrupt::PhaseLeaser;pub use deontic_interrupt::MAX_CAPS_PER_PHASE;pub use deontic_interrupt::MAX_PHASES;pub use deontic_interrupt::MAX_SANDBOX_AGENTS;pub use topology_decl::parse_geometry_blocks;pub use topology_decl::parse_geometry_or_topology;pub use topology_decl::BoundaryDecl;pub use topology_decl::GeometryDecl;pub use topology_decl::HarbouredGraphDecl;pub use topology_decl::TopologyInvokeDescriptor;pub use projectional::apply_edit;pub use projectional::apply_edits;pub use projectional::make_binary;pub use projectional::make_call;pub use projectional::make_field;pub use projectional::make_float;pub use projectional::make_ident;pub use projectional::make_int;pub use projectional::make_law;pub use projectional::make_material;pub use projectional::make_member;pub use projectional::make_string;pub use projectional::project_program;pub use projectional::Edit;pub use projectional::ProjectOptions;pub use reactive_cell::ReactiveCell;pub use reactive_cell::ReactiveCellError;pub use reactive_cell::ReactiveCellGraph;pub use reflection::ReflectionConfig;pub use reflection::ReflectionEngine;pub use reflection::ReflectionLoop;pub use reflection::ReflectionResult;pub use reflection::StageResult;
Modules§
- animation
- VibeScript Zero-Heap Animation System.
- ast_
merge - 3-Way AST Structural Merge for VibeScript.
- bytecode
vibe-bc-0.1bytecode compiler, VM, and binary codec.- capability_
schema - Machine schema exports for all bound host call ids (T51).
- catalog
- Catalog of host
Family.methodinvoke ids. - conditioning
- Vibe-facing conditioning profile DTO and graph projection (P1B). No invented Host invoke IDs. Neutral statements only.
- cosmic
- Omniversal Coordinate System (OCS) — cosmic coordinate types.
- crypto
- Cryptographic operations — hashing, AEAD, KDF, signing (T-crypto).
- dag
- A6 — Multi-Agent DAGs & Autonomous Control Units.
- decompiler
- Bi-directional Poetic Decompiler for VibeScript (Zero-Heap friendly).
- deontic_
interrupt - A8 — Hardware Deontic F(φ) Interrupts & Phase Leasing.
- extension_
registry - VibeScript 0.03 Extension Registry, Cold Preparation, Zero-Heap Hot Dispatch,
and Deterministic Domain Provider Adapters (
VS03-06,VS03-07,VS03-08). - frame_
morphism - Frame morphisms — Galilean now, Lorentz later (W5).
- hid
- Inbound event record ABI for HID/sensors (T41).
- law_
package - Law packages as signed content (T72, W10).
- locale
- Keyword locale tables — multi-lingual keyword views (T37).
- metamodel
- VibeScript metamodel registry and semantic projection (Prompt Precision P1A).
- module_
system - Module system —
import <iri> as namewith a module graph (T63). - observer
- Observer context, heraldic lexicon, multi-scale sheaves, civic time, and agent characteristics (W7, W9, W14, W15, T59).
- physics
- Physics & Creator Physics module (Fields, Materials, Interaction Laws, Continuant WorldLines, and Frame Morphisms).
- presentation
- Presentation morphism as a sheaf (T69).
- pretty
- Pretty printer for field/material/law declarations (W16).
- projectional
- Projectional authoring — structure is the source of truth, text is a view (W1).
- quantity
- Quantity dimension algebra and unit conversions (T73).
- reactive_
cell - reflection
- A3 — Dynamic Reflection & Self-Healing Loop.
- replay_
clock - Deterministic replay clock — the only WASM clock (W12, T71).
- session
- Bounded in-memory checked source sessions for the pinned 0.1 interpreter. This is not durable project recovery, live definition replacement, or a job API.
- sheaf
- Sheaves, stalks, simplex, and topological tears (T47–T50).
- stdlib_
v2 - VibeScript v0.02 (
vibe-0.2) Standard Library — Directory-Backed Library (AGENTS.md§0-B). - task_
scheduler - Bounded local deferred tasks. Execution is synchronous on the admitted AST engine.
- tick_
policy - Tick policy under load — drop / coalesce / tear (T68).
- topology_
decl - Declarative VibeScript
geometryandtopologycomplex parser and capability lowerer. - translate
- Bidirectional keyword translation via canonical AST (T38, T39).
- trivia
- CST trivia — comments, whitespace, and exact token text (T36).
- vocab
- Vocab chunks: bounded N3/Turtle slices with a content hash (P17.1).
- web_
runtime - VibeScript v0.02 Web Server, CBOR-LD & Zero-JavaScript UI/Form Runtime
(
web.*,cbor_ld.*,ui.*,form.*,input.*,selection.*,validate.*,layout.*).
Structs§
- Alias
Row - Alias row for migrate /
suggested_fix(shape doc). - Bind
Decl - Two-way binding:
bind left <-> right using Clamp[0, 1] resolve latest; - Block
- Budget
- CapSpec
- Cell
Decl - A reactive cell declaration (e.g.
cell score := math.clamp(raw, 0, 100);). - Check
Result - Color
Lit - Packed sRGB + alpha from a
#rgb/#rrggbb/#rrggbbaaliteral. - Conservation
Result - A conservation law check result (T34).
- Const
Decl - Diagnose
Report - Result of
diagnose. - Diagnostic
- Disclosure
Boundary - Four-bit disclosure boundary (T56). Each bit is independent.
- Duration
- An exact duration: secs + nanos. No float subtraction (T2).
- Engine
- Enum
Decl - A user-defined enum declaration (T9).
- Enum
Value - A user-defined enum value (T9). Carries the enum name, variant name, and optional payload values. Unit variants have an empty payload.
- Enum
Variant - A variant of a user-defined enum (T9).
- Env
- Expr
- Field
Decl - A field declaration (T28).
- Field
Ref - An opaque handle to a sampled field (T5). Scripts do not see the grid.
- Frame
- A reference frame: origin + basis vectors (T4).
- Function
Decl - Hook
Decl - Import
Decl - Instant
- A point in time with a known scale, exact secs+nanos, and an optional cryptographic seal (T1).
- LawDecl
- A law declaration (T30).
- Lexicon
Pin - Recorded
lexicon: "packId@SemVer"pin. - Local
Host - In-process host: graph/pulse/time in memory, catalog kernels for Animation/etc.
- Locale
Decl - Match
Arm - Material
Decl - A material declaration (T29).
- Material
Ref - An opaque handle to a material signature (T5).
- Mixture
- A mixture of chemical species with composition data (T33).
- Module
Decl - Named
Arg - Pack
Manifest - Minimal pack-manifest field read (fixture / example JSON; no serde).
- Param
- Policy
- A named policy with a query pattern and a violation message.
- Policy
Violation - A policy violation found by the AST query engine.
- Pose
- A pose: position + orientation within a frame (T4).
- Prefix
Decl - Present
Decl present lamp { color: glow, pose: spin }— a presentation sheaf surface.- Program
- Quantity
- A physical quantity: a value with a required unit IRI (T3).
- QuinRef
- An opaque 48-byte handle to a Super-Quin / NQuin (T7).
- Span
- Species
Ref - An opaque handle to a chemical species (T33).
- Transform
- A transform: translation + rotation + scale (T4).
- Type
Expr - World
Line - A worldline: a continuant through Instant × Pose (T6).
Enums§
- Acceleration
Tier - Acceleration the host will actually use this pass (P16.1). Default is scalar. SIMD/GPU must be measured, not advertised.
- Arg
- ArmBody
- BinOp
- Bind
Resolve - Causal
Relation - A causal relation between two events in spacetime (T35).
- Conservation
Quantity - The conserved quantity being checked (T34).
- Decode
Error - Diag
Code - Effect
Class - Expr
Kind - Field
Representation - Field representation describes storage/computation (T28).
- Field
Support - Field support describes spatial distribution (T28).
- Host
Environment - Where the host is running (P16.1).
- Identifier
Policy Error - The result of validating a Unicode identifier.
- Item
- Lexicon
Framing - Pack framing — living senses must not be Thing-washed as artifact.
- Literal
- Miscibility
- Miscibility between mixtures (T33).
- Mixture
Phase - Phase of a mixture (T33).
- Modal
Kind - The first-class logic modalities supported in VibeScript.
- Pattern
- Query
Pattern - An S-expression query pattern that matches against AST nodes.
- Stmt
- Time
Scale - Time scale for an
Value::Instant. - UnOp
- Value
Constants§
- CELL_
BATCH_ NATIVE - Native ready-cluster ceiling (P16.2).
- CELL_
BATCH_ WASM - WASM sequential chunk (P16.3).
- DEFAULT_
CONTEXT_ IRI - DIAGNOSTIC_
SCHEMA_ JSON - EBNF
- EXAMPLE_
PIN - Example pin matching
docs/manuals/standards/lexicon-pack-manifest-example.json. - GBNF
- HELD_
OPEN_ PACK - Soft why-text for missing / unknown pack. Never “broken”.
- HOST_
VERSION - Current host ABI stamp (
Host::host_version).vibe-host-0.1is the incorporation outcome, not anALL_BOUNDfreeze. - LANGUAGE_
VERSION - LEXICON_
MANIFEST_ ID - Live bind id (already in
ALL_BOUND). Catalog-honest; not a new Host method. - MAX_
DIAGNOSTICS - Collect up to 8 diagnostics instead of stopping at the first (audit §7.12).
- MAX_
IDENT_ LEN - Maximum identifier length.
- SENTINEL_
BYTES - 42 MB Prolog Sentinel ceiling (AGENTS.md).
- SOURCE_
SCHEMA_ JSON - TAG_
CBOR_ LD_ COMPRESSED - TAG_
CBOR_ LD_ UNCOMPRESSED - TAG_
VIBE_ AST - TAG_
VIBE_ DISCLOSURE_ DENIED - TAG_
VIBE_ DURATION - TAG_
VIBE_ INSTANT - TAG_
VIBE_ IRI - TAG_
VIBE_ QUANTITY - TAG_
VIBE_ QUIN_ REF
Traits§
- Host
- Host supplied by Qualia / tests.
Functions§
- add_
f64_ slices - Elementwise
out[i] = a[i] + b[i]. AVX-512 when present; else scalar. - alias_
migrate_ report - Held report whose
suggested_fixis alias-row JSON (migrate / upgrade). - alias_
rows_ suggested_ fix - Encode alias rows as
suggested_fixJSON array. - apply_
upgrade_ map - Applies upgrade-map.
- builtin_
policies - The built-in policy set: mandatory-take, forbidden-call, tick-no-external.
- call_
cbor_ ld - Dispatches
cbor_ld.*built-in calls for VibeScript (vibe-0.1). - cell_
batch_ cap - Cell batch capacity.
- check_
cell - Checks cell.
- check_
custom_ policies - Run a custom set of policy queries against a program.
- check_
policies - Run all built-in policies against a program. Returns a list of violations. If empty, the program passes all policies.
- check_
program - Checks program.
- check_
program_ all - Checks program-all.
- check_
program_ with_ vocab - After a successful check, fail closed on prefixed names missing from a loaded vocab chunk.
- compress_
iri - Compresses an IRI or property term into either a compact static table ID (
1..=1023) or a deterministic 60-bit FNV-1a token with bit 59 set (DYNAMIC_TERM_BIT). - could_
be_ unicode_ ident_ start - Check if a byte sequence could be the start of a Unicode identifier (i.e., a multi-byte UTF-8 sequence starting with a non-ASCII byte that is XID_Continue).
- decode
- Decodes CBOR.
- decode_
value_ cbor_ ld - Decodes compressed (
0x0501) or uncompressed (0x0500) CBOR-LD bytes into(context_iri, Value). - derive_
provider_ namespace - Derives
(normalized_host, effective_tld, namespace_iri)from a provider domain, URL, or TLD. - detect_
available_ tier - What the CPU/adapter could run. Not what this eval pass is using.
- diagnose
- Parse and type/effect-check. Cells start with
=. Does not evaluate. When a contradiction/conflict is detected, attaches evidential annotations (μ = 1.0, λ = 0.0). - diagnose_
lexicon_ pin - Pin-aware diagnose hook for Neo (no disk).
- dispatch_
hook - Dispatch a hook event on a checked program.
- encode
- Encodes CBOR.
- encode_
value_ cbor_ ld - Encodes a runtime
Valueinto deterministic compressed W3C CBOR-LD (0xD9 0x0501). - eval_
cell - Parse, check, and evaluate a Pure cell (
= expr). - eval_
function - Evaluate a named function from a checked program.
Import aliases from the program are populated into
envbefore evaluation. - expand_
term - Expands a compressed term ID back to a static IRI/term or a deterministic
did:q42:term:<hex>topological identifier for dynamic 60-bit tokens. - function_
has_ budget - Check if a function has a budget.
- gpu_
missing - GPU missing → stay on bytecode / scalar CPU.
- hook_
has_ budget - Check if a hook has a budget.
- ingest_
json_ with_ provider_ ns - Parses raw JSON, uplifts all bare property keys into the provider’s domain/TLD namespace
(
https://{host}/ns#{key}), and encodes the uplifted structure into compressed CBOR-LD (0x0501). - is_
bidi_ control - Check if a character is a BiDi control character.
- is_
xid_ continue - Check if a character is XID_Continue (valid in identifiers).
- is_
xid_ start - Check if a character is XID_Start (valid as first character).
We use XID_Continue for both (like Rust), which allows
_as a start character. - living_
rewritten_ as_ artifact truewhen living content was rewritten as an artifact.- llm_
missing - Local model missing → diagnostic. Consented remote is not implied.
- load_
program - Parse and check a module. Does not run hooks.
- missing_
pack_ report - Expected DiagnoseReport when
lexicon_manifestis missing / unknown. - parse_
alias_ rows_ json - Round-trip alias rows out of a
suggested_fixJSON array (or mixed text). - parse_
cell - Parses cell.
- parse_
lexicon_ pin_ from_ source - Scan comment/header
lexicon: "packId@SemVer"andconst lexicon = "…". - parse_
pack_ manifest_ json - Parses pack-manifest-json.
- parse_
program - Parses program.
- parse_
query - Parse an S-expression query string into a
QueryPattern. - populate_
import_ aliases - Populate
env.aliasesfrom a program’s import declarations. Eachimport "vibe:0.1/graph" as g;mapsg->graph. Also supports Vibe 0.03 extension namespace IRIs and short aliases (mech,gpu,infer,qgraph,modality). - run_
policies - Run a set of policies against a program and return all violations.
- validate_
identifier - Validate a Unicode identifier against the full security policy.