Documentation

Status: works today (v0.98.0). Generated from the live nova serve FastAPI route table (src/novafabric/serve/app.py).

A contributor's map of the codebase: what the subsystems are, where they live, and which invariants you must not break. For the conceptual model — what…

An assurance case is a machine-checkable argument — in the GSN/SACM/CAE tradition — that a system meets a goal, where every claim ultimately rests on se…

Every number here is reproducible with a command on this page. If you cannot re-run it, treat it as marketing, not measurement — including these.

Both nova and novafabric refer to the same binary. NovaFabric is a self-hosted, Apache-2.0 command-line toolkit that captures, replays, diffs, and audit…

An honest comparison, including where NovaFabric loses. If a tool below is a better fit for what you are doing, use it — a wrong recommendation costs yo…

This page is the conceptual reference for NovaFabric. It explains the nouns you will meet everywhere else in the docs and on the nova command line — wha…

Status: Experimental. Read this entire page before relying on the dashboard for anything that matters. Per: ADR-0027, Non-goals First shipped: v0.7

<!-- GENERATED FILE — do not edit by hand. Regenerate with: uv run python scripts/gendecisionsindex.py -->

This guide is for contributors working inside the NovaFabric tree — not end users. It documents how to build, test, and extend the code that produces No…

nova drift is NovaFabric's offline drift-detection surface (ADR-0147 — see nova drift --help): it computes distribution-shift statistics over samples dr…

Using NovaFabric to make a computational result reproducible, reviewable, and citable — and an honest account of what it does not solve.

NovaFabric turns any command — a training script, an AI agent, a notebook cell runner — into a Run Capsule: a structured, secret-redacted, self-containe…

Status: Works today (NovaSeal v0.1+, ADR-0041)

Status: Works today (ADR-0041, NovaSeal v0.1+)

Status: Works today (ADR-0041, NovaSeal v0.12.15+)

This guide is for HPC system administrators and platform engineers who deploy NovaFabric on shared infrastructure — from a single workstation to a multi…

NovaFabric is a CLI-first toolkit, but every capability the nova command exposes is also reachable as a typed Python API. This reference documents the p…

Follow these steps to cut a NovaFabric release.

This directory holds NovaFabric's public requests for comment — the deliberative record for non-trivial changes.

Status: Experimental (SPKG, ADR-0111)

Every published NovaFabric performance number lives here, and every number carries exactly one honesty status:

What NovaFabric implements, how to verify each claim yourself, and — kept deliberately prominent — what is not claimed.

This page is the single source of truth for which NovaFabric versions receive fixes, for how long, and what an upgrade promises. SECURITY.md links here;…

Four read-only commands that turn a capsule's trust evidence into something a human can read at a glance: the Merkle proof tree, the trust-attestation r…

Plain-English guides for engineers at every level. Read in any order.

This guide is the working reference for the shipped nova command surface: what each command does, how to invoke it, and when to reach for it. It picks u…

This is a focused guide to one of NovaFabric's more intricate pieces. Read it if you run many captures on one node (a fleet, an HPC job array, a CI farm…

- nova capture writes capsules to local disk - nova serve reads them into Postgres on a single server - The lineage graph lives in that Postgres instance

By the end of this tour you will have exercised all five NovaFabric primitives — Asset Registry, Run Capsule, Replay, Lineage, and Evidence Bundle — and…

- Why every LLM call is really an HTTP request, and where NovaFabric sits in that exchange. - The difference between the requests and aiohttp libraries,…

How NovaFabric captures a multi-agent system depends entirely on whether the agents share one Python process or run as separate processes.

Both tools capture LLM traces. This document explains where they overlap, where they differ, and which questions each one is designed to answer.

~20 minutes. By the end you will have a signed, portable artifact that a sceptical third party can verify on their own machine — with no access to your…

- The one problem NovaFabric exists to solve: AI and agent runs are non-reproducible and leave no durable evidence. - The five primitives — Asset Regist…

NovaFabric's capture surface ships with hooks for a small set of SDKs and protocols (OpenAI, Anthropic, MCP, plus the wire-level layer over httpx and re…

How to install and operate NovaFabric with no internet connectivity — classified networks, HPC enclaves, regulated environments. Labels follow the docs…

How to back up and restore a NovaFabric deployment. The first half documents procedures that work today with standard tools; the second half covers the…

This guide walks through migrating a local-mode NovaFabric installation (SQLite + filesystem) to a cluster-scale deployment (Postgres + Object Capsule S…

Status: works today (gate + thresholds shipped with ADR-0199). Per: ADR-0199 — the dashboard's scale contract (bounded queries, keyset cursors, watermar…

Status: experimental (ADR-0247, first slice). Placement enforcement over the object capsule store; the cryptographic proof layer (jurisdiction site seal…

This guide covers NovaFabric's optional application-layer envelope encryption for capsule payloads in the object capsule store (ADR-0185).

Symptom → diagnosis → action, for the operator on call for a NovaFabric deployment (nova server API, nova serve dashboard, or a local install). Labels f…

This guide covers monitoring NovaFabric's own HTTP apps — the nova server REST API and the nova serve dashboard backend — with the self-observability su…

This guide covers protecting a shared nova server deployment from noisy clients: in-process API rate limiting and warn-then-reject storage quotas (ADR-0…

This guide is for the administrator of a shared, multi-user NovaFabric deployment — the nova server REST API (/v0), not the single-operator nova serve d…

This guide covers five deployment scenarios for NovaFabric v0.7. Each scenario is labelled with its current implementation status per the docs honesty r…

How to size storage, memory, and CPU for a NovaFabric deployment — from a single laptop to a shared Postgres server. Everything below is labelled per th…

How to upgrade a NovaFabric deployment from one version to the next — local SQLite installs and Postgres server mode — and what is honestly supported wh…

The migration kit (nova lineage-store migrate) rebuilds a lineage graph in a target SQLite lineage store. Two sources are supported:

Status: open — 0 of 5 cohort-1 slots filled, 0 of 3 independent sign-offs on the v1.0 spec. If you run real AI or HPC workloads and want a say in a form…

How merge rights are earned, what they commit you to, and how to step back. This page is deliberately explicit: an unwritten path to maintainership is a…

Status: Adopted 2026-05-07 · Applies to: every non-trivial change to NovaFabric

Status: Draft | Active | Accepted | Rejected | Withdrawn | Superseded Authors: @github-handle, @github-handle Reviewers: @github-handle (maintainer), @g…

Status: Accepted 2026-08-06 — option C, implemented in migration v004 and ADR-0226. Authors: @MSKazemi (filed from the #23 investigation) Reviewers: @MS…