open/llm-ingestion-okf
1
0
Fork 0
Code Issues Releases 1 Activity

chore(release): 0.8.5

Browse source 
Version to 0.8.5 in pyproject.toml, __init__.py and uv.lock; CHANGELOG's
[Unreleased] becomes [0.8.5] — 2026-09-12, carrying K3-23's instrument,
K3-25's default and K3-24's block-sources fix byte-identically, with the
two `### Changed` headings merged into one and one post written here: what
`okf.parse_frontmatter` now returns for a block `sources:` is a READING
projection PyYAML reads back on 0 of 4 605 measured block files.

No behaviour change in src/ beyond the version string. The guard pin stays
at v1.4.0 and the dependency floor stays at >=1.2,<2.0.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-09-12 19:38:46 +02:00
commit 64661c7198
6 changed files with 59 additions and 33 deletions
Download patch file Download diff file Expand all files Collapse all files

36
README.md
View file

@ -9,7 +9,7 @@ call anywhere in the run path.
Python 3.10+ and [uv](https://docs.astral.sh/uv/). One line:
```sh
uv tool install "llm-ingestion-okf[extract] @ git+https://git.fromaitochitta.com/open/llm-ingestion-okf.git@v0.8.4"
uv tool install "llm-ingestion-okf[extract] @ git+https://git.fromaitochitta.com/open/llm-ingestion-okf.git@v0.8.5"
```
## Use it
@ -59,11 +59,11 @@ Neither this package nor the guard it depends on is on a package index yet, so
both install by direct reference. With uv, one command resolves both:
```sh
uv pip install "llm-ingestion-okf @ git+https://git.fromaitochitta.com/open/llm-ingestion-okf.git@v0.8.4"
uv pip install "llm-ingestion-okf @ git+https://git.fromaitochitta.com/open/llm-ingestion-okf.git@v0.8.5"
```
uv resolves the guard on its own, because it reads the `[tool.uv.sources]`
entry in the `pyproject.toml` **of the tag it is installing**, and `v0.8.4`
entry in the `pyproject.toml` **of the tag it is installing**, and `v0.8.5`
points that entry at `llm-ingestion-guard` `v1.4.0`. Use `uv tool install`
instead of `uv pip install` when you want the `okf` command on `PATH` without an
active virtualenv — that is the form the first screen shows.
@ -74,10 +74,10 @@ With plain pip, the transitive git dependency does not resolve on its own —
```sh
pip install "llm-ingestion-guard @ git+https://git.fromaitochitta.com/open/llm-ingestion-pipeline-security.git@v1.4.0"
pip install "llm-ingestion-okf @ git+https://git.fromaitochitta.com/open/llm-ingestion-okf.git@v0.8.4"
pip install "llm-ingestion-okf @ git+https://git.fromaitochitta.com/open/llm-ingestion-okf.git@v0.8.5"
```
The guard tag is paired to the okf tag, not to this branch. `v0.8.4` declares
The guard tag is paired to the okf tag, not to this branch. `v0.8.5` declares
`llm-ingestion-guard>=1.2,<2.0`, which `v1.4.0` satisfies; the pairing above is
read off that tag's own `[tool.uv.sources]`, not off this branch. Reading a pin
off `main` and installing it against an older okf tag is the one combination
@ -88,7 +88,18 @@ that fails.
These are not install lines. They record what each earlier tag was, so a reader
who meets one in an older document knows what they are looking at.
- `v0.8.4` — the current tag: frontmatter this library writes is YAML a YAML
- `v0.8.5` — the current tag: a block `sources:` sequence is decoded by all
three of this library's flat frontmatter readers, where they returned the
key with an empty value. `okf.parse_frontmatter` is public API, so this
changes what an outside caller reads: it returns a flow string where it
returned an empty one. That string is a READING projection — PyYAML reads
it back on 0 of the 4 605 block files measured, because the `?` opening a
query string in the source URL ends the flow scalar — and the emitter still
writes flow, so no bundle bytes move. `okf consume` also stops scoring the
door's own `Enclosing section:` link line, which is now the default reading;
the excerpt still carries the line, so what moves is order and never an
excerpt's bytes. No new functionality; `okf check` has seventeen rules.
- `v0.8.4` — frontmatter this library writes is YAML a YAML
reader reads back the same (a block scalar it would misread is written
double-quoted; a flow leaf with no form both readers accept is refused), and
`okf consume` resolves a concept's `parent:` pointer into the excerpt
@ -586,7 +597,7 @@ not need this repository — the first line installs the command, the second
builds the bundle and writes a skill beside it, the third asks.
```sh
uv tool install "llm-ingestion-okf[extract] @ git+https://git.fromaitochitta.com/open/llm-ingestion-okf.git@v0.8.4"
uv tool install "llm-ingestion-okf[extract] @ git+https://git.fromaitochitta.com/open/llm-ingestion-okf.git@v0.8.5"
okf project ~/my-documents
claude
```
@ -936,17 +947,18 @@ From a checkout, the test suite runs with:
.venv/bin/python -m pytest
```
The suite is the verification surface for everything above: **1783 tests
collected, 1782 passed and 1 skipped**, run on 2026-09-11 with the `[extract]`
The suite is the verification surface for everything above: **1827 tests
collected, 1826 passed and 1 skipped**, run on 2026-09-12 with the `[extract]`
extra installed. Both numbers are given because they are two measurements: the
figure published before the `v0.8.2` release was the PASSED count, and `pytest
--collect-only -q` reported one more.
(The figure stood at 596 until 2026-09-09 — measured 2026-08-21 and never
updated as the suite grew — at 1515 until the `v0.8.0` release, at 1575
through it, at 1582 through the `v0.8.1` release, at 1602 through the
`v0.8.2` release, at 1658 after K3-19, and at 1667 after K3-20 and through
the `v0.8.3` release; the figure above is the `v0.8.4` release's, after K3-22
and K3-21: a count is a measurement with a date on it.)
`v0.8.2` release, at 1658 after K3-19, at 1667 after K3-20 and through
the `v0.8.3` release, and at 1783 through the `v0.8.4` release, after K3-22
and K3-21; the figure above is the `v0.8.5` release's, after K3-23, K3-24 and
K3-25: a count is a measurement with a date on it.)
Without the extra the same suite skips the tests covering the parser path;
that split was last counted on 2026-08-21 as 589 passed and 7 skipped and has
**not** been re-measured since. The tests holding the fail-fast rejection for