Notation for Objects, Values & Agents · draft 0.1

One data model. Every representation.

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: 5

Block layout and comments, for people editing configuration. Text syntax, §4

For LLMs and agents

Read a projection. Write a conditional patch.

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.

  1. 1 The agent asks

    @get services[id=api].{replicas,port}
  2. 2 The tool answers with a revision

    @revision sha256:91cf16db…
    @scope services[id=api]
    replicas: 5
    port: 3000
  3. 3 The agent writes one line

    @patch sha256:91cf16db
    @scope services[id=api]
    replicas: 5 -> 8

Compact 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

Templates that work on values, not text

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 parses
NOVA: templating values
@template
@param containers: list<Container>

spec:
  containers: $containers

Overlays need no new mechanism: an overlay is a patch applied to a rendered base. Templates and overlays, spec §9

Tools that exist today

  • nvf

    The command line: format, convert, validate, query, patch, diff, render and lint.

    fmt · convert · get · patch · diff · render · lint · stats
  • nvf-lsp

    Language server: diagnostics with workspace schemas, hover, outline, completion, formatting.

  • VS Code

    Highlighting for documents, schemas and patches, plus the language server client.

  • tree-sitter

    One grammar for Helix, Neovim, Zed and other tree-sitter editors.

Ecosystem

The Rust reference implementation ships today. Other languages will follow the same conformance suite.

  • Rust· available
  • JVM· planned
  • npm· planned
  • Go· planned
  • Zig· planned
  • Python· planned