First public release, published as one snapshot. What changed between versions is in CHANGELOG.md. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
121 lines
8.9 KiB
Markdown
121 lines
8.9 KiB
Markdown
# Changelog
|
|
|
|
## [Unreleased]
|
|
|
|
## [1.1.1] - 2026-11-14
|
|
|
|
The repair list is written from a reading by a command, the reader can take fewer claims per call, and the repository
|
|
is ready for its first public release.
|
|
|
|
### Added
|
|
- `krepair list`: the repair list from a reading's verdicts. It lists every claim read that does not have exactly one
|
|
verdict, supported, as `claims score` counts it; given the ids of a sample, it lists only the claims of the sample.
|
|
Before, no command wrote the list the repair task reads.
|
|
- `claims calls --size N`: at most N claims per reader call (1 to 10, default 10). A claim read among six to ten
|
|
neighbours from its page was judged more mildly than the same claim read nearly alone: 12 of 269 accepted claims
|
|
turned in the sample of 14.11.
|
|
- MIT licence (`LICENSE`).
|
|
|
|
### Changed
|
|
- The skill assembles a repair into a copy of the collection, from one answers file. Assembled into an empty folder,
|
|
every page got a new generated time and the diff reported 379 pages without a repair; and one fix builds the whole
|
|
collection to measure itself (2.5 minutes on 555 pages), so 178 answer files one at a time would take hours.
|
|
- README rewritten for the first public release.
|
|
|
|
## [1.1] - 2026-11-14
|
|
|
|
A folder of mixed PDF and Office files is built into a collection with the same code as the documentation, both
|
|
collections are looked up through one read-only server, and the reader measures a changed build on a random sample.
|
|
|
|
### Added
|
|
- `okf-wiki serve --bundle NAME WIKI [SOURCES] ...`: a read-only MCP server over stdio for lookups across built
|
|
collections, with four tools (`collections`, `search`, `page`, `source`). It calls no model and writes nothing.
|
|
`search` matches a page's title, description and text; a word in the title counts twice and rarer words weigh more.
|
|
- `sources reread ROOT --out ROOT2` reads a folder again as the same collection, and `sources watch ROOT --into DIR`
|
|
reports each new, changed or gone document by its original path with the pages built on it, once.
|
|
- `kmerge propose`: candidate pairs of concepts built twice under two names, found from the page titles; `--judged`
|
|
leaves out pairs judged different before. `kmerge controls` draws the control pairs a build has, so a small folder
|
|
no longer stops the step.
|
|
- A second calibration set for the reader, from Norwegian and English folder documents. A reading counts only when
|
|
the reader's model has a green run on both sets.
|
|
- `claims sample --of-all`: 300 random claims among every claim, with nothing added, for the reading after a changed
|
|
build.
|
|
- The upstream watch follows the announced new home of the Open Knowledge Format.
|
|
- `sources folder`: a folder of Markdown and text documents becomes a frozen copy with one command and no hand-written
|
|
description. Subfolders, capitals and non-ASCII names get a safe name and keep their original path and `file:///`
|
|
URL; Windows line breaks, Windows-1252/Latin-1 and a byte order mark are written as plain UTF-8 and recorded; every
|
|
file skipped is named with its reason.
|
|
- The repository is a Claude Code plugin: the skill and the helpers reach a session started in any folder, and
|
|
`bin/okf-wiki` runs the tools from there.
|
|
- PDF, Word, Excel and PowerPoint in `sources folder`, read with their exact place: page, paragraph, sheet and cell,
|
|
slide and notes. Every footnote names the place, the auditor checks it against the frozen copy, and the HTML view
|
|
opens the original file, a PDF at its page. Hidden Office content is left out and reported. Office files need
|
|
nothing installed; PDF needs `pypdf==6.14.2`.
|
|
- `python3 -m okfwiki.readers locate`, the reader the file-type gate measures: 128 of 128 in its working set.
|
|
- `sources folder` records each document's language (`lang`, Norwegian or English, from its common words), and the HTML
|
|
view states it on every page instead of always `en`.
|
|
- `gates/calibration.passed.json`, the record of the reader's green calibration runs (models and sha256 only), and
|
|
`reader collect --gate-passed` without a file reads it, so a fresh clone can read without the calibration set.
|
|
- `x-aliases`: a concept's other names stand on its page, end its index line as ` (also: A; B)`, are shown in the
|
|
HTML view and are searched by the lookup server as its title is. The standard has no field for another name.
|
|
- `kmerge apply --operator FILE`: verdicts a person set in place of the judge's, listed in the report.
|
|
- The operator's list `WORK/homeless-approved.json` takes `sources` beside `pages`: a document with no readable
|
|
content, so no page cites it and it has no main page, that he approves is reported by run-after and the guard
|
|
instead of stopping the build. The auditor still reports it, and it never gets a forced fragment or main page.
|
|
|
|
### Changed
|
|
- Pages judged one concept merge into the page with the shortest name, so the merged page carries the concept's short
|
|
name; before, the main page won, and 48 of 118 merged pages of collection 1 carried a longer name than a page
|
|
that went into them. The merged page keeps its own description.
|
|
- A page with a sentence that also stands on the page it merges into is merged all the same: the sentence is cut
|
|
from the page that moves, so it stands once, and the report lists it. Before, such a page was left out.
|
|
- Any file name is a page; only `release-vX.Y.Z.md` is a release note by name. `.txt` sources are built like `.md`.
|
|
- Page ids spell out letters outside ASCII (`Årlig kontroll` is `aarlig-kontroll`, not `rlig-kontroll`).
|
|
- A footnote on a page built from a folder names the original file (`Årlig plan.md, line 3`), not its safe name.
|
|
- A spreadsheet row is one line, each cell after its column letter, and a run of rows one block of about 4,000
|
|
characters that starts with the run's first row; the footnote names the cell the quote covers.
|
|
- A period after a common abbreviation (`f.eks.`, `kl.`, `bl.a.`, `e.g.`, `vs.`, `Dr.`) or an initial (`Steven L.
|
|
Rickman`) no longer ends a sentence.
|
|
- A folder's document named like a release note (`Release-v2.1.0.md`) gets the safe name `release-v2.1.0-doc.md`,
|
|
so it is built as a document with a main topic, not as a release note.
|
|
- The stop line prices the next pack by the characters of its blocks, not their number: every block records `chars`,
|
|
every pack `block_chars`. A PDF or spreadsheet block of a real folder holds about ten times the characters of a
|
|
docs block, and the cost per character stays near (6.9 tokens on collection 1, 5.8 and 8.5 on two folder trials),
|
|
so a pack of PDFs was priced about three times too low. A pack log without characters keeps the rule by blocks.
|
|
- `kpack --max-chars C` closes a new pack before the source that would take it over C characters of blocks (no cap
|
|
unless given), and run-before names a source larger than the largest measured to hold in one compiler run (a PDF of
|
|
387 767 characters: 342 of 345 fragments accepted, auditor 0 findings).
|
|
|
|
### Fixed
|
|
- A link placed after an abbreviation (`U.S. [primary aluminum production](...)`) no longer splits its sentence in
|
|
two, which made the auditor report a cited sentence as uncited and stopped a folder build.
|
|
- `kmerge apply` leaves out a page whose sentence collides with one on the page kept and lists it, instead of
|
|
refusing the whole merge.
|
|
- The coverage floor of a document fetched again is scaled by the blocks that can carry a claim, so a page that
|
|
splits its headings into more blocks is not stopped for citing too little.
|
|
|
|
### Known limitations
|
|
- The reader on 300 random claims of each collection found 17 not supported (5.67 %) in the documentation collection
|
|
of 3,162 pages and 24 (8.00 %) in the folder collection of 555 pages. The aim is under 3 %; it is not reached.
|
|
- `docs/known-limitations.md`.
|
|
|
|
## [1.0] - 2026-11-07
|
|
|
|
First version. It builds one collection, the Claude Code documentation and its release notes, into a wiki in
|
|
Google's Open Knowledge Format.
|
|
|
|
### Added
|
|
- K, the fragment compiler: code splits sources into blocks, the user's own Claude Code session writes short quoted
|
|
fragments per pack of five sources through the skill (`skills/okf-wiki/SKILL.md`), and code assembles the pages.
|
|
- The hard check at writing: every sentence has a footnote to a source that exists and a quote that stands verbatim
|
|
in it, with a provenance mark (`x-provenance`: documented, inferred or merged).
|
|
- Links made by the model from meaning (`okfwiki.klink`), checked and placed by code; a main page for every
|
|
single-topic source and a home for every other page.
|
|
- The auditor (`okfwiki.audit`): quotes at their locator, SPEC § 11 conformance, links, orphans and index coverage;
|
|
the static HTML view (`okfwiki.view`).
|
|
- The independent reader (`agents/okf-wiki-reader.md`) with its calibration gate, and claim repair at the fragment
|
|
(`okfwiki.krepair`, `agents/okf-wiki-repairer.md`).
|
|
- The change warning: sources that are new, changed or gone are reported and the pages built on them are marked.
|
|
|
|
### Known limitations
|
|
- `docs/known-limitations.md`.
|