v0.8.0

New Features

• KB navigation commands — okfkb 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 propagation — okfkb 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

• KB Commands Reference
• Setting up OKFKB
• OKFKB Design Choices
• HW Debugging Workflow Tutorial