feat(okr): okf_version emitteres i rot-indeksens frontmatter

This commit is contained in:
Kjell Tore Guttormsen 2026-08-02 21:15:50 +02:00
commit 1da9dd878d
4 changed files with 144 additions and 12 deletions

View file

@ -75,14 +75,33 @@ in their frontmatter. These files passed a deterministic conformance gate but
**no human review** — they are the least-trusted tier of the bundle (see
ranking and the security envelope below).
Each level has an **`index.md`** with **no frontmatter**, formatted as a heading
plus one bullet per concept file:
Each level has an **`index.md`** formatted as a heading plus one bullet per
concept file. Sub-level indexes carry **no frontmatter**:
```
# Heading
* [title](relative.md) - description
```
A **root** index additionally carries the two bundle markers, deliberately on
different surfaces: `okf_version` (the upstream OKF version) in frontmatter, and
`okf_layout` (this plugin's own layout revision) in the body:
```
---
okf_version: 0.1
---
# Heading
okf_layout: kb-layout-2026-06
* [title](relative.md) - description
```
These markers are metadata about the bundle, not retrievable content — skip them
when ranking.
The `index.md` is the curated table of contents for its level — use it to
navigate and to break ranking ties (below).