%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["test_comment_map_for_makefile\n_parses_comments_and_resets_buffers"] --> B["_comment_map_for_makefile(path)"]
    B --> C["Parse lines: accumulate\n# comments into buffer"]
    C --> D{"Line type?"}
    D -->|"comment (#)"| E["Append to comment_buffer"]
    D -->|"blank line"| F["Reset comment_buffer"]
    D -->|"target (NAME:)"| G["Store buffer as\ncomment_map[target];\nreset buffer"]
    D -->|"other (recipe/var)"| F

    H["test_discover_make_targets\n_finds_target_at_line_one"] --> I["discover_make_targets()"]
    J["test_discover_make_targets\n_skips_targets_missing_from_makefile"] --> I
    K["test_discover_make_targets\n_applies_comment_and_metadata"] --> I

    I --> L["MAKEFILE_PATH.is_file()?"]
    L -->|No| M["return []"]
    L -->|Yes| N["_comment_map_for_makefile()"]
    N --> O["Iterate _TARGETS_TO_INDEX"]
    O --> P{"Target in\nMakefile text?"}
    P -->|No| Q["skip"]
    P -->|Yes| R["Lookup _TARGET_METADATA\nfor tags/requirements"]
    R --> S["Build TestCatalogItem\nwith comment as description"]
    S --> T["Append to items list"]