Module card_header 

Header-agnostic card header parsing.

Canonical-store cards carry identity metadata in one of two header forms: the legacy single-line bracket header emitted by the v1 writer ([project: … | agent: … | date: … | frame_kind: …]) and the card schema v2 YAML frontmatter block (---\nproject: …\n---). Every in-repo reader goes through this module so neither form leaks bespoke parsing into consumers. The .meta.json sidecar stays authoritative — readers call store::load_sidecar first and fall back to parse_card_header.

Structs

CardHeader

Card identity fields recovered from a chunk header (either form).

Enums

HeaderForm

Functions

card_body

Body of a card after its header (either form), with leading newlines trimmed. Text without a recognizable card header is returned unchanged.

header_form

is_bracket_header_line

Single-line guard for the legacy bracket header. Line-stream filters (search previews, evidence excerpts, noise detection) use this so the bracket prefix has exactly one reader-side home.

parse_card_header

Parse the card header at the start of text, accepting both the bracket and the YAML-frontmatter form. Returns None when text carries no recognizable card header.