cocosearch-add-grammar

To add a custom grammar handler, create a new file at src/cocosearch/handlers/grammars/ that specifies PATH_PATTERNS, implements _has_content_markers and _extract_grammar_metadata, and extends YamlGrammarBase for common parsing logic.

CocoSearch autodiscovery automatically registers new grammar handlers when they follow the standard base conventions and are placed in the correct handlers directory, ensuring reliable discovery without manual registry entries.

Yes, custom grammar extensions support hierarchical metadata blocks like job, step, or service by leveraging YamlGrammarBase and defining SEPARATOR_SPEC for safe, deterministic parsing of structured YAML content.

The best way to test custom grammar handlers is to run the standard grammar tests after creating your handler, which verifies content validation, metadata extraction, and ensures no conflicts with existing PATH_PATTERNS or registry entries.

No, you do not need to manually update the registry if your grammar handler follows the standard autodiscovery conventions, as the system ensures proper registry updates for reliable discovery and usage automatically.