1 The agent asks
@get services[id=api].{replicas,port}Notation for Objects, Values & Agents · draft 0.1
NOVA is a typed data format with human text for people, compact tables for LLMs, canonical binary for services, and conditional patches for agents. All of them decode to the same value.
cargo install novafile-cli @schema infrastructure@1.0.0 # optional: the schema this follows
environment: production
deployed_at: 2026-11-17T16:00:00Z # a string, until a schema resolves it
ratio: 22/7 # an exact rational
services:
- id: auth
port: 8080
replicas: 3
- id: api
port: 3000
replicas: 5services[2]{id,port,replicas}:
auth,8080,3
api,3000,5@schema infrastructure@1.0.0
@root Infrastructure
type Port = u16 @range(1..65535)
record Service:
id: string @key @id(1)
port: Port @id(3)
replicas: u16 @range(0..100) @id(4)
enum Status:
active
draining
failed(string)nvf get infrastructure.nova 'services[id=api].{replicas,port}' @revision sha256:91cf16db2f4a403ed7a586e82fc2618093f7c1d87fc0183e54ea1c9b936bd65b
@scope services[id=api]
replicas: 5
port: 3000@patch sha256:91cf16db
@scope services[id=api]
replicas: 5 -> 8@template
@param env: string
@param services: list<string>
@param metrics: bool = false
@let defaults = {enabled: true, replicas: 2}
services:
@for name in $services:
- ...$defaults
id: $name
image: "ghcr.io/example/${name}:v2"
@if $metrics and $env == production:
- id: metricsBlock layout and comments, for people editing configuration. Text syntax, §4
Each page shows your format next to NOVA, what changes, how to convert, and when to stay where you are.
no stays a string. Indentation is exactly two spaces, never a guess. nindent, always terminates. replicas: 5 -> 8. @id is the field number, and the .proto is generated. For LLMs and agents
Agents see only the fields they ask for and change only what they scope. The base revision and the expected old value catch concurrent edits.
@get services[id=api].{replicas,port}@revision sha256:91cf16db…
@scope services[id=api]
replicas: 5
port: 3000@patch sha256:91cf16db
@scope services[id=api]
replicas: 5 -> 8Compact tables cut repeated keys from LLM context. nvf stats shows bytes and
estimated tokens per representation for your own data. The agent model, spec §8
Helm generates indentation-sensitive YAML with string functions. A NOVA template renders to a plain value before anything else sees it, so indentation and quoting cannot go wrong.
Helm: templating text spec:
containers:
{{- toYaml .Values.containers | nindent 4 }}
# get the 4 wrong and the YAML still parsesNOVA: templating values @template
@param containers: list<Container>
spec:
containers: $containersOverlays need no new mechanism: an overlay is a patch applied to a rendered base. Templates and overlays, spec §9
The command line: format, convert, validate, query, patch, diff, render and lint.
fmt · convert · get · patch · diff · render · lint · statsLanguage server: diagnostics with workspace schemas, hover, outline, completion, formatting.
Highlighting for documents, schemas and patches, plus the language server client.
One grammar for Helix, Neovim, Zed and other tree-sitter editors.
The Rust reference implementation ships today. Other languages will follow the same conformance suite.