kxmeta-author

Items go missing from meta.json when aimeta annotations lack mandatory @kind and @name markers. You must enforce these required markers and address common qdoc traps that cause silent drops, then trigger a successful recompile to surface the items.

To write correct aimeta annotations for kdbx, apply mandatory @kind and @name markers on every annotated item. Use chained @col modifiers correctly to define columns, and avoid common qdoc traps that prevent the compiler from publishing tables and functions reliably.

Common qdoc traps include omitting mandatory @kind or @name markers, and misusing chained @col modifiers. These mistakes cause the compiler to silently drop annotated items instead of publishing them to meta.json, requiring diagnostics and a recompile to fix.

Yes, @kind and @name are mandatory markers required on every aimeta annotation. Without both markers, the compiler fails to surface the annotated tables and functions in meta.json, resulting in silent drops during the build process.

Chained @col modifiers guide the definition of table columns within aimeta annotations. Correct usage ensures the compiler properly processes and publishes the table structure to meta.json, while misuse leads to common qdoc traps and missing items.

The best way to diagnose missing aimeta items is to check for missing mandatory @kind and @name markers, verify chained @col modifiers, and identify common qdoc traps. Apply fixes and trigger a recompile loop to ensure items successfully surface in meta.json.