OKF v0.2.4 — Go interoperability and knowledge toolkit

Changes

• Align OKF 0.2 validation with the pinned upstream specification: wrapped log.md list items, introductory root-index text, and unknown root frontmatter fields no longer produce false base errors. The foreign 30-file interoperability corpus now reports 0 errors and 16 documented warnings, down from 312 errors and 18 warnings before the fixes.
• Add an explicit instant-0b87c52 temporal profile for offset-bearing datetimes while retaining the existing date-3fcbb9f profile as the default. Add a transactional preview/apply path for revision upgrades; legacy dates are not silently converted into invented instants.
• Add Go-native bundle initialization, a repository knowledge bundle, MCP search and neighbor queries, an offline HTML viewer, history backfill, upkeep checks, migration input preparation, and a validator GitHub Action.
• Add reproducible Go toolkit benchmarks and agent-evaluation harnesses. Saved model experiments are descriptive: the primary CLI-projection pilot scored 3/4 in both arms, and the checker pilot does not isolate a checker effect. See the committed reports for raw rows and limitations.

The OKF document format remains okf_version: "0.2"; the repository/Go module release number and temporal profile are separate contracts. Existing date-profile behavior remains the default. The HTML viewer was manually checked on small and 1,000-concept exports, including filters, deep links, Cyrillic text, code blocks, missing metadata, and responsiveness.

Verification and traceability

• Work items: implementation plan and tasks 004–015.
• Reviewable diff and independent acceptance reviews: PR #7.
• Main commit: 67ba35c; annotated tag: v0.2.4.
• CI on main: full Go tests, race detector, vet, module integrity, Linux/Darwin/Windows/Android checks and seven GitHub Action scenarios. Tag-push CI verifies the tagged commit is reachable from main and reruns the quality matrix; the remote tag is an annotated Git tag.
• No required follow-up is known for this release. The model-evaluation reports explicitly limit claims about answer quality and checker effects.

Install the CLI with go install github.com/skosovsky/okf/cmd/okf@v0.2.4. A clean module-proxy installation returned cli_version: v0.2.4 and default OKF document spec 0.2 from okf version --json.