Skip to content

Releases: gsemet/okf-schema

v0.8.3

Choose a tag to compare

@gsemet gsemet released this 09 Jul 22:23
fix: bad rtd docs

Signed-off-by: Gaetan Semet <gaetan@xeberon.net>

v0.8.2

Choose a tag to compare

@gsemet gsemet released this 09 Jul 22:20
fix: apply readthedocs lfs fix

Signed-off-by: Gaetan Semet <gaetan@xeberon.net>

v0.8.1

Choose a tag to compare

@gsemet gsemet released this 09 Jul 22:16

Minor rebuild for documentation

v0.8.0

Choose a tag to compare

@gsemet gsemet released this 09 Jul 22:08

New Features

  • KB navigation commandsokfkb now exposes the knowledge base as active navigation tools:
    • okfkb search TEXT — ranked keyword/fuzzy search across titles, tags, context, and body
    • okfkb get ID — exact fetch of a single node by id or path
    • okfkb read TIER — read an entire stable tier at once (e.g., concepts, principles)
    • okfkb query EXPR — structured selection with a filter DSL and graph traversal
  • Filter DSL queries — select nodes with expressions like type:finding confidence:>=high tag:pll status:active; confidence is ordinal so range comparisons work
  • Arrow-traversal queries — walk the KB graph with -> (links), <- (backlinks), and ^ (promotions), e.g., finding[tag=pll] -> concept -> principle
  • Superseded-link propagationokfkb update now automatically rewrites body links that point to superseded documents toward their replacements, and reports any deferred items
  • New okfkb-gardening Copilot skill — batch KB maintenance skill that detects broken links, propagates superseded redirects, runs coherence checks, and surfaces obsolete findings

Enhancements

  • Agents can now pull the right granularity from a KB instead of loading whole tier folders
  • okf-schema skill documentation updated to describe the new navigation commands

Examples

  • Find high-confidence active PLL findings:
    okfkb query "type:finding confidence:>=high tag:pll status:active"
  • Walk from findings up to concepts and principles:
    okfkb query "finding[tag=pll,confidence=high] -> concept -> principle"
  • Read only resolved concepts, then list principles:
    okfkb read concepts --status resolved
    okfkb read principles --format titles
  • Search then drill into one exact node:
    okfkb search "pll lock time" --tier findings
    okfkb get findings/2026.07.03-14.20-pll-temp-drift.md

Documentation

v0.7.1

Choose a tag to compare

@gsemet gsemet released this 06 Jul 12:17
docs: fix more typos

Signed-off-by: Gaetan Semet <gaetan@xeberon.net>

v0.7.0

Choose a tag to compare

@gsemet gsemet released this 06 Jul 11:49

new command: validate-md

rework documentation

v0.6.0

Choose a tag to compare

@gsemet gsemet released this 04 Jul 22:00

okfkb : opinionated knowledge base

v0.5.0

Choose a tag to compare

@gsemet gsemet released this 02 Jul 16:00

links and backlinks appears in frontmatters

v0.4.1

Choose a tag to compare

@gsemet gsemet released this 02 Jul 12:47

Refine documentation

v0.4.0

Choose a tag to compare

@gsemet gsemet released this 02 Jul 09:54

Add support for $ref in schema