Open Commons ObservatoryEnglish·Русский

tad

text as data, rendered

✓ Why it exists✓ What it must reach○ How each step is delivered and proven✓ What is happening now

Why it exists

A spreadsheet is easy to change and impossible to review. Alter one cell, and afterwards nobody can see what was changed, by whom, or why.

What it must reach

Working
2/2The formats and pages
0/1Gathers data by itself
Perfection
5/5tad in Rust
0/1Standard gatherers
0/1A rhizcut in every repository
Ongoing perfection
0/1The heart of oco-eco
Readinesslevel 6 of 9

2 / 6 milestones done

How each step is delivered and proven

The formats and pagesdone
Writes every table in its one canonical formtool*.json

tad canon rewrites each table's file - compact JSON lines, declared field order, empty as null, rows in their order - only when the data checks out.

A change reads as one line in a pull request.

Checks every row and every rule across tables against the declarationcheck*.json

tad check reads tables.toml and data/: types, required fields, allowed values, patterns, ranges, keys, then unique ids, references, citations and mirrored relations across tables.

Nothing wrong reaches a commit: a bad row is named with its table and line.

Renders the data as documents, in Markdown and reStructuredTexttool

tad render writes one page per table and an index, finding shapes in the data (relations, sources, grids, an about page) and reading any declared presentation.

The documents are always what the data says; CI requires them fresh.

Adds or changes one row, and keeps it only if every rule still holdstool*.json

tad set TABLE --key ID --set field=value: typed by the declaration, dated if the table says so, then the whole repository checked; if anything breaks the file is put back and the problems named.

Nobody hand-edits a table, and a change that breaks a rule never lands.

Answers SQL over the declared tables, through DuckDBtool*.json, DuckDB

tad sql reads the declared tables into DuckDB (tad engine installs its pinned binary, fingerprint checked), runs the statement, and brings the tables back through tad's canonical form and checks - the third way into the same data, beside files and text.

SQL with joins is the reason tad exists (why-tad-exists); lab-agent's journal will be queried this way.

The guard and the one fixed formcheck

Every edit is loaded, checked against the schema and its rules, and written back one way only; anything else fails.

A one-row change must be a one-line difference, or nobody can review it.

Editing by querytool

Data is changed through one runner with queries, never by hand in the files.

An edit by hand skips every rule.

Gathers data by itselfnot started

Nothing delivers this step yet.

tad in Rustdone

Reached - but what delivers it has not been written down.

Standard gatherersnot started

Nothing delivers this step yet.

A rhizcut in every repositorynot started
Keeps every repository on tad's latest releasetoolupdate-pins.sh, consumers, the lab's timer

Each repository installs its pinned release with bin/install-tad.sh after checking the checksum; the lab's weekly timer runs bin/update-pins.sh, which moves each pin, re-renders, records a glimpse and lands through that repository's CI.

Called, not copied: no copy drifts, and a new release reaches everyone checked.

Releases tad by itselftoolrelease-please, package conveyor

release-please keeps a release pull request from the commits; land merges it; the package conveyor builds x86_64 and aarch64 binaries, deb and rpm, with checksums and signed provenance, in the same run.

No version is bumped by hand, and every release can be verified.

The heart of oco-econot started

Nothing delivers this step yet.

What is happening now

Made by work

71 commits in the last 90 days latest release tad-v0.7.0 · 2026-11-17

✓ gather✓ release✓ rust

2026-08-21: 0 commits2026-08-22: 0 commits2026-08-23: 0 commits2026-08-24: 0 commits2026-08-25: 0 commits2026-08-26: 0 commits2026-08-27: 0 commits2026-08-28: 0 commits2026-08-29: 0 commits2026-08-30: 0 commits2026-08-31: 0 commits2026-09-01: 0 commits2026-09-02: 0 commits2026-09-03: 0 commits2026-09-04: 0 commits2026-09-05: 0 commits2026-09-06: 0 commits2026-09-07: 0 commits2026-09-08: 0 commits2026-09-09: 0 commits2026-09-10: 0 commits2026-09-11: 0 commits2026-09-12: 0 commits2026-09-13: 0 commits2026-09-14: 0 commits2026-09-15: 0 commits2026-09-16: 0 commits2026-09-17: 0 commits2026-09-18: 0 commits2026-09-19: 0 commits2026-09-20: 0 commits2026-09-21: 0 commits2026-09-22: 12 commits2026-09-23: 1 commits2026-09-24: 0 commits2026-09-25: 0 commits2026-09-26: 0 commits2026-09-27: 0 commits2026-09-28: 0 commits2026-09-29: 0 commits2026-09-30: 0 commits2026-10-01: 0 commits2026-10-02: 0 commits2026-10-03: 0 commits2026-10-04: 0 commits2026-10-05: 0 commits2026-10-06: 0 commits2026-10-07: 0 commits2026-10-08: 0 commits2026-10-09: 0 commits2026-10-10: 0 commits2026-10-11: 0 commits2026-10-12: 0 commits2026-10-13: 0 commits2026-10-14: 0 commits2026-10-15: 0 commits2026-10-16: 0 commits2026-10-17: 0 commits2026-10-18: 0 commits2026-10-19: 0 commits2026-10-20: 0 commits2026-10-21: 0 commits2026-10-22: 0 commits2026-10-23: 0 commits2026-10-24: 0 commits2026-10-25: 0 commits2026-10-26: 0 commits2026-10-27: 0 commits2026-10-28: 0 commits2026-10-29: 0 commits2026-10-30: 0 commits2026-10-31: 0 commits2026-11-01: 0 commits2026-11-02: 0 commits2026-11-03: 1 commits2026-11-04: 2 commits2026-11-05: 0 commits2026-11-06: 0 commits2026-11-07: 0 commits2026-11-08: 0 commits2026-11-09: 0 commits2026-11-10: 7 commits2026-11-11: 31 commits2026-11-12: 9 commits2026-11-13: 0 commits2026-11-14: 0 commits2026-11-15: 0 commits2026-11-16: 3 commits2026-11-17: 5 commits2026-11-18: 0 commits