kyb v0.3.1

kyb v0.3.1 for aarch64-apple-darwin (Apple Silicon), Docker (linux/amd64, linux/arm64) and crates.io. Intel macOS is not supported.

A patch release with one addition: a full export of the base.

Export: every key of the base as of one commit

Search ranks and caps its answer at 100, so it cannot answer "everything in the base", and before this release no route listed all knowledge or any retracted knowledge.

GET /export?at=<rev>&after=<key>&limit=N returns JSON lines:

• a snapshot line: the commit, total, and counts per kind and state;
• one entry line per key, in key order, with state: active (its file is in that commit's tree), archived (an incident or task closed out of it) or retracted (knowledge taken out). A removed key reads as it was just before its removal and carries the removing commit;
• an end line with next_after and complete.

Pages that pass the same at=<sha> read one commit, so writes made between pages change nothing; a commit outside HEAD's history is refused. Earlier versions are not part of the export; kyb history <key> lists them. The route needs the read role, like /search.

kyb export [--at <sha>] [--out FILE] [--page N] pages through one snapshot and checks every page before asking for the next (same snapshot, keys after the cursor and in order, a cursor that advances), then the whole result (no key twice, the announced counts and total, a last page that says complete). It exits 1 with the problems otherwise. The command is gated on the server's new export capability, so an older server is refused rather than asked.

Install

brew install alex09x/apps/kyb          # Apple Silicon
cargo install knowyourbusiness --locked  # kyb-server only
docker pull ghcr.io/alex09x/kyb:v0.3.1