Repository navigation
Releases: btwld/okf
Releases · btwld/okf
Release list
okf 0.5.0
- Adopt OKF revision
62432a0: every timestamp is an ISO 8601 datetime with a UTC offset. A date-only or offset-less value raises the non-blockingokf/timestamp-without-offsetadvisory naming the exact field, andOkfSpecValidation.isConformantis unchanged, so a bundle that validates today still validates.okf validate --strictis the exception: it escalates advisories to failures, so it starts failing on date-only timestamps it used to accept. Runokf format --migrate-timestampson those bundles, or drop--strictuntil you have. - Compare staleness as an instant rather than a local calendar day.
stale_afterwas read as a calendar date and compared in the caller's local zone; it is now an instant, stale whennow >= stale_after. East of UTC a concept goes stale later than before — two hours in Berlin, twelve in Auckland — and west of UTC it can now become stale on the previous local day. Callers in UTC see no change. - Add
okf format --migrate-timestamps, which rewrites date-only values toT00:00:00Zand reports every change. It is opt-in, idempotent, writes nothing under--check, and leaves offset-less datetimes alone rather than guessing a zone for them. Migrating a date-onlyverified.atcan raise a concept'strust_tierfromunverifiedtohuman-reviewed, because the verification now carries a usable time; that change is visible inokf graph. - Reject impossible timestamps through one strict parser.
2026-02-30previously rolled over into March 2 and was accepted; it is now rejected everywhere. Date values still read as midnight UTC forstale_after,usage_windowandlast_modified, where a date has always been valid.generated.atandverified[].athave always required a time, so a date-only value there carries no instant and does not count as a verification.
See the full changelog for changes in earlier releases.
okf 0.4.2
- No changes to the package. This release completes the deployment pipeline: the macOS job now holds the
contents: writepermission its uploads need, so 0.4.1's macOS archives and Homebrew formula, which were published by hand, are produced by CI again.
See the full changelog for changes in earlier releases.
okf 0.4.1
- Use Ack schemas for graph-query parsing and generated, typed MCP arguments. Each input schema owns runtime constraints and the advertised JSON Schema. Partial updates retain omitted fields, and OKF Spec findings and tolerant metadata behavior remain unchanged. Concept IDs stay encoded as strings, and invalid IDs and graph-query fields are reported with their specific paths and validation reasons.
- Generate equality, hashing,
copyWith, diagnostic strings, and JSON adapters for index entries, log entries, and legacy citation values with Ack. Use the generated copies when normalizing writable index and log entries, and verify all generated model parts in CI. Const constructors, tolerant parsing, Markdown output, and optional v0.1 citation compatibility are preserved; concept IDs, diagnostics, and documents retain their existing validated constructors and custom formatting. - Consolidate internal rule metadata, execution context, and YAML value helpers while preserving the public package exports. Remove redundant construction wrappers and use normal constructors where direct initialization suffices. Align IO, MCP, and rule tests with their source modules and consolidate the index/log contract suites without changing their assertions.
- Classify local graph targets containing raw or percent-encoded C1 control characters as invalid, matching bundle-path validation, instead of unresolved.
- Raise the minimum supported Dart SDK from 3.4 to 3.9 for Ack 1.2.
See the full changelog for changes in earlier releases.
v0.3.0
Immutable
release. Only release title and notes can be modified.
What's Changed
- ci: publish to pub.dev via OIDC on release tags by @kauandotnet in #34
- fix!: keep mcp tool results under client token caps by @chrishiguto in #36
- ci: automate release pull requests by @kauandotnet in #37
Full Changelog: v0.2.0...v0.3.0
v0.2.0
Immutable
release. Only release title and notes can be modified.
What's Changed
- docs: add architecture decision records from review by @chrishiguto in #17
- feat: add engine contract types by @chrishiguto in #20
- feat: namespace base finding IDs by @chrishiguto in #21
- feat: add composable graph query filters by @chrishiguto in #23
- ci: gate repositories on released okf binaries by @chrishiguto in #24
- feat: own the index and log entry format in one model by @chrishiguto in #25
- ci: pin workflow actions to current immutable commits by @dependabot[bot] in #31
- feat: add the single bundle write path by @chrishiguto in #27
- feat: add the okf mcp read tool surface by @chrishiguto in #26
- feat: add the concept write verbs to okf mcp by @chrishiguto in #28
- feat: add the link and lifecycle write verbs to okf mcp by @chrishiguto in #29
- fix: resolve real reference filenames in links and source targets by @chrishiguto in #32
New Contributors
- @chrishiguto made their first contribution in #17
- @dependabot[bot] made their first contribution in #31
Full Changelog: v0.1.2...v0.2.0