Explanation

How ajq works and why it’s designed this way.

Design notes for ajq’s execution model, reproducibility guarantees, and architecture.


Split execution

The core idea behind ajq — keep jq deterministic, call a model only for fuzzy operators.

The determinism contract

What ajq’s byte-reproducibility guarantees, and what it deliberately doesn’t.

The three-phase executor

Harvest, resolve, execute — and why deduplication comes for free.

Architecture

The components of ajq and how data flows between them.

Project status

The capabilities that ship today, and how they fit together.

Iterative-harvest prototype evaluation

Reproducible evidence and the no-go decision for the non-default iterative-harvest prototype.


Last modified July 9, 2026: Initial public import (5dc1342)