v0.65.0-beta.2
Pre-releaseDelta since previous beta (v0.65.0-beta.1) — 1 new changeset.
Patch Changes
-
OKF provenance timestamps are now read as ISO 8601 datetimes carrying an explicit UTC offset, which is what OKF v0.2 §5 asks for. This changes the
okflint plugin in both directions, and one of the two is a tightening.- Documents that already follow OKF v0.2 stop warning.
stale_after,usage_window.from,usage_window.to, and eachsources[]entry'slast_modifiedplus its own window bounds previously accepted only a bareYYYY-MM-DDcalendar date, so a conformant value such as2026-09-23T00:00:00Zwas reported as afrontmatter-provenancewarning. It no longer is. - Documents still written with date-only values start warning. A value such as
stale_after: 2026-09-23now reports onefrontmatter-provenancewarning, because the format now asks for an explicit offset. The remedy is to write it:stale_after: 2026-09-23T00:00:00Z. A datetime carrying no offset (2026-09-23T00:00:00) is rejected for the same reason, and the warning now names the shape to write rather than only the schema keyword.
Why now. OKF revised §5 in place on 2026-08-21, adding "Every timestamp-valued key in OKF is an ISO 8601 datetime with an explicit UTC offset" and migrating every example in the spec, without bumping the version. Both revisions are labeled v0.2 and a document written to either declares
okf_version: "0.2", so the declared version does not tell you which reading a document was authored against. The plugin now records the upstream commit its reading is pinned to.Other v0.2 checkers have not caught up yet.
okf-conformancestill warns on astale_afterthat is not a bareYYYY-MM-DD, which is the pre-revision wording of §5.5, so the two tools currently disagree about the same document. OpenKnowledge follows the current spec text and the format's own reference bundles, which now writestale_after: 2026-12-31T00:00:00Z.Log files are unaffected. OKF §9 governs the date's form in a
log.mdentry heading, not these frontmatter keys, andlog-shapeis unchanged:## 2026-06-30and## 2026-06-30: Shipped v2both stay conformant.The
okfplugin ships disabled by default, so this reaches only projects that turned it on, and it emits advisory warnings rather than blocking anything. - Documents that already follow OKF v0.2 stop warning.
Downloads
| Platform | Architecture | Download |
|---|---|---|
| macOS | Apple Silicon | OpenKnowledge-arm64.dmg |
| Windows | x64 | OpenKnowledge-Setup-x64.exe |
| Windows | arm64 | OpenKnowledge-Setup-arm64.exe |
| Debian / Ubuntu | x64 | OpenKnowledge-amd64.deb |
| Debian / Ubuntu | arm64 | OpenKnowledge-arm64.deb |
| Fedora / RHEL | x64 | OpenKnowledge-x86_64.rpm |
| Fedora / RHEL | arm64 | OpenKnowledge-aarch64.rpm |