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>
8.9 KiB
8.9 KiB
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, asclaims scorecounts 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.searchmatches a page's title, description and text; a word in the title counts twice and rarer words weigh more.sources reread ROOT --out ROOT2reads a folder again as the same collection, andsources watch ROOT --into DIRreports 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;--judgedleaves out pairs judged different before.kmerge controlsdraws 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 andfile:///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-wikiruns 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 needspypdf==6.14.2. python3 -m okfwiki.readers locate, the reader the file-type gate measures: 128 of 128 in its working set.sources folderrecords each document's language (lang, Norwegian or English, from its common words), and the HTML view states it on every page instead of alwaysen.gates/calibration.passed.json, the record of the reader's green calibration runs (models and sha256 only), andreader collect --gate-passedwithout 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.jsontakessourcesbesidepages: 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.mdis a release note by name..txtsources are built like.md. - Page ids spell out letters outside ASCII (
Årlig kontrollisaarlig-kontroll, notrlig-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 namerelease-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 packblock_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 Ccloses 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 applyleaves 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.