Merge commit '8a86f2ab6d'

shared/examples/nav-golden-hierarchy/bundle/a/b/doc-b.md

@@ -0,0 +1,6 @@
+---
+type: reference
+title: "Doc B"
+---
+
+Level-2 concept reached depth-first, deepest in the traversal.

shared/examples/nav-golden-hierarchy/bundle/a/b/index.md

@@ -0,0 +1,8 @@
+---
+type: index
+okf_version: 0.1
+title: "Subsection B index"
+---
+
+- [Doc B](doc-b.md)
+- [Back to A](/a/index.md)

shared/examples/nav-golden-hierarchy/bundle/a/doc-a.md

@@ -0,0 +1,6 @@
+---
+type: methodology
+title: "Doc A"
+---
+
+Level-1 concept reached depth-first after Overview.

shared/examples/nav-golden-hierarchy/bundle/a/index.md

@@ -0,0 +1,10 @@
+---
+type: index
+okf_version: 0.1
+title: "Section A index"
+---
+
+- [Doc A](doc-a.md)
+- [Nested verdict](verdict-nested.md)
+- [Subsection B](b/index.md)
+- [Overview again](/overview.md)

shared/examples/nav-golden-hierarchy/bundle/a/verdict-nested.md

@@ -0,0 +1,8 @@
+---
+type: verdict
+title: "Nested verdict — must be excluded"
+decision: approved
+description: "A verdict file at a nested level. A conformant navigator reaches it (dedup marks it seen) but MUST exclude it from the read-context — recursively, not only at the root. This is the leakage surface a graph-based exclusion would miss."
+---
+
+This body MUST NOT appear in the read-context.

shared/examples/nav-golden-hierarchy/bundle/c/orphan.md

@@ -0,0 +1,6 @@
+---
+type: project
+title: "Orphan — unreachable"
+---
+
+Directory `c/` has no `index.md`, and nothing links to this file. A link-following navigator never reaches it; a directory-walking one wrongly would. It MUST be absent from the read-context, and its parent directory's missing `index.md` MUST NOT be an error (that rule binds the bundle root alone).

shared/examples/nav-golden-hierarchy/bundle/index.md

@@ -0,0 +1,10 @@
+---
+type: index
+okf_version: 0.1
+title: "Nav-golden — hierarchical navigation case"
+---
+
+Nav-golden hierarchical case. This bundle exercises depth-first traversal, both link forms (root-relative and relative), recursive verdict exclusion, resolved-path de-duplication, cycle termination, and the root-only binding of the missing-index rule.
+
+- [Overview](overview.md)
+- [Section A](/a/index.md)

shared/examples/nav-golden-hierarchy/bundle/overview.md

@@ -0,0 +1,6 @@
+---
+type: project
+title: "Overview"
+---
+
+Root-level concept reached by a relative link.