just-dna-format

The declarative schema + integrity contract for just-dna annotation modules: both the authored input DSL and the compiled manifest.json. Dependency-light (Pydantic + cryptography, for Ed25519 signature verification) so it can be shared as the single source of truth by:

• just-dna-compiler — the reference transform (spec → parquet artifact + manifest);
• just-dna-pipelines — emits manifest.json when it compiles a module;
• just-dna-marketplace — indexes, serves, and verifies those manifests;
• just-dna-agents — authoring support (renders reference.authoring_reference()).

Keeping the contract in one small package prevents the sides from drifting.

What's here

Usage

from just_dna_format.manifest import ModuleManifest, read_manifest
from just_dna_format.integrity import build_artifact, verify_manifest

# Compiler side: hash outputs and record the digest.
artifact = build_artifact(output_dir, ["weights.parquet", "annotations.parquet", "studies.parquet"])

# Downloader side: verify before installing (raises IntegrityError on any mismatch).
verify_manifest(module_dir, read_manifest(module_dir / "manifest.json"))

All hashes are SHA-256, lowercase hex, prefixed sha256:. The artifact.digest is a Merkle-style root over the canonical file listing — verifying it verifies the whole set and is the version's immutable content identity.

Develop

uv sync
uv run pytest -vvv