chore: YAML-Schemas in Dateiköpfe, tibi-types auf 4c55f82

- yaml-language-server-Schema direkt in jeder api-YAML statt
  .vscode/yaml.schemas-Mapping (exakter pro Datei, kein Glob-Rätsel)
- erweiterte meta.agent-Doku in den Collections
- tibi-types-Submodul auf 4c55f82 (meta.agent- + meta.query-Schemas)

api/collections/navigation.yml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=../../tibi-types/schemas/config/collection.schema.json
 ########################################################################
 # Navigation collection — header and footer navigation entries
 ########################################################################
@@ -51,12 +52,12 @@ meta:
       label: { de: "Einstellungen", en: "Settings" }
   agent:
     purpose: "Header/footer trees per language, rendered by App.svelte from elements."
-    instructions: "Singletons: type header/footer x language de/en (unique type+language). elements: {name, page->content.id} internal, {name, external:true, externalUrl} external, optional hash without #. Always request lookup elements.page:content; href = localizedPath(_lookup.page.path) + hash."
+    instructions: "Singletons: type header/footer x language de/en (unique type+language). elements: {name, page->content.id} internal, {name, external:true, externalUrl} external, optional hash without #. Always request lookup elements.page:content; href = localizedPath(_lookup.page.path) + hash. GOTCHA 2026-10-05: filter_public.js forces active:true on anonymous reads although this schema declares no active field – without stored active:true the header/footer query returns count 0 publicly (PAT reads still succeed). Always store active:true on every navigation doc."
     fieldHints:
       type: "header or footer"
       language: "de or en"
     examples: [{ language: "de", type: "header", elements: [{ name: "Start", page: "<content.id>" }] }]
-    hints: ["page holds content.id, resolve via _lookup.page.path", "never hardcode /de prefix in DB"]
+    hints: ["page holds content.id, resolve via _lookup.page.path", "never hardcode /de prefix in DB", "missing active:true => public nav empty + SSR count 0 (verified incident 2026-10-05)"]
 
 hooks:
   get: